Skip to content

Commit 7c83457

Browse files
Merge pull request #135 from Syncfusion-Content/development
DOCINFRA-2341_merged_using_automation
2 parents 75304e3 + ab888fd commit 7c83457

21 files changed

+126
-67
lines changed
28.8 KB
Loading
24.5 KB
Loading
24.4 KB
Loading
60.4 KB
Loading
75 KB
Loading
72.8 KB
Loading

Extension/WindowsForms-Extension/Syncfusion-Item-Templates-for-Windows-Forms.md

Lines changed: 23 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -7,79 +7,51 @@ control: Syncfusion Extensions
77
documentation: ug
88
---
99

10-
# Item Template Extension
10+
# Add Syncfusion Components to the WinForms Application
1111

12-
The Syncfusion Item Templates extensions provides support to add a predefined form for the Windows Forms applications.
12+
Syncfusion supports Visual Studio Item Templates to add Syncfusion WinForms Components to a WinForms application with Syncfusion WinForms references.
1313

1414
I> The Syncfusion Windows Forms item templates are available from v13.1.0.21.
1515

16-
## Using Syncfusion Item Template Gallery
16+
The following steps will guide you to add the Syncfusion WinForms Components to your Visual Studio WinForms application.
1717

18-
Follow the given steps to add the Syncfusion item in Visual Studio.
18+
> Check whether the **WinForms Extensions - Syncfusion** are installed or not in Visual Studio Extension Manager by going to **Extensions -> Manage Extensions -> Installed** for Visual Studio 2019 or later and Visual Studio 2017 or lower by going to **Tools -> Extensions and Updates -> Installed**. If this extension is not installed, please install the extension by following the steps from the [download and installation](https://help.syncfusion.com/windowsforms/visual-studio-integration/download-and-installation) help topic.
1919
20-
> Before use the Syncfusion WinForms Item Template, check whether the **WinForms Extensions - Syncfusion** installed or not in Visual Studio Extension Manager by clicking on the Tools -> Extensions and Updates -> Installed for Visual Studio 2017 or lower and for Visual Studio 2019 by clicking on the Extensions -> Manage Extensions -> Installed.If this extension not installed, please install the extension by follow the steps from the [download and installation](https://help.syncfusion.com/windowsforms/visual-studio-integration/vs2019-extensions/download-and-installation/) help topic.
20+
## Add Components using Syncfusion Item Template
2121

22-
1. Open a new or existing **WinForms** application.
23-
2. Right-click the WinForms Project from the Solution Explorer. Select the Add Syncfusion Item New Item… option.
22+
1. Open a new or existing WinForms application.
2423

25-
![Syncfusion Item Template add-in](Item-Template-images\Syncfusion-Item-Template-Gallery-1.png)
24+
**Option 1:**
2625

27-
3. Now, the Syncfusion Item Template Gallery window will be open.
26+
2. From the **Solution Explorer, right-click** on the WinForms application. Choose **Add Syncfusion Item...**.
2827

29-
![Syncfusion Item Template wizard](Item-Template-images\Syncfusion-Item-Template-Gallery-2.png)
30-
31-
4. Select the required assembly location, version, and Form from the Syncfusion Item Template Gallery.
28+
![Choose Add Syncfusion Item option from right click project](Item-Template-images/Add-syncfusion-item.png)
3229

33-
![Select the Form from the Syncfusion Item Template Wizard](Item-Template-images\Syncfusion-Item-Template-Gallery-3.png)
30+
**Option 2:**
3431

35-
**Assembly From:** Choose an assembly reference option such as GAC location, Essential Studio installed location, or NuGet packages, to specify where from the required Syncfusion assemblies are added to the project.
32+
3. Click **Extensions > Essential Studio for WinForms > Add Syncfusion Item…** in Visual Studio.
3633

37-
![Select the required assembly location from the Syncfusion Item Template Wizard](Item-Template-images\Syncfusion-Item-Template-Gallery-5.png)
34+
![Choose Add Syncfusion Item option from menu](Item-Template-images/Add-item.png)
3835

39-
N> Installed location and GAC option will be available only when the Syncfusion Essential WinForms setup has been installed. You can use NuGet option without installing the Syncfusion Essential Windows Forms setup. If you add the Syncfusion item files in .NET Core Windows Forms application, GAC option will not be listed in the Assembly From option.
4036

41-
**Version:** Choose the Essential Studio version to add the corresponding version assemblies to the project.
37+
4. The Syncfusion WinForms Item Template wizard will be launched as follows.
4238

43-
![Select the required ES version from the Syncfusion Item Template Wizard](Item-Template-images\Syncfusion-Item-Template-Gallery-4.png)
39+
![Syncfusion WinForms Item template Components](Item-Template-images/Add-syncfusion-ui.png)
4440

45-
N> Version option will be available only when you install the Syncfusion Essential Windows Forms setup and choose the assembly location as Installed Location or GAC.
41+
5. Select the WinForms Components from the Component list within your WinForms Item Template. The features associated with the selected Component will be presented. From here, choose the specific features that are essential for your project.
4642

47-
**Template Gallery:** This part contains a set of Syncfusion Item Templates, and you can choose the Item Templates as required. When the Add button is clicked, the selected item template is added to the project.
43+
6. Choose an assembly reference option such as GAC location, Essential Studio installed location, or NuGet packages to specify where the required Syncfusion assemblies are added to the project.
4844

49-
![Selected Item Template](Item-Template-images\Syncfusion-Item-Template-Gallery-6.png)
45+
N> If the Syncfusion Essential WindowsForm build is installed, the Installed location and GAC options will be enabled. Without installing the Syncfusion Essential WindowsForm setup, use the NuGet option. The GAC option will not be available when using the Syncfusion WinForms Components in a .NET Core application. The Version drop-down lists the installed WinForms versions.
5046

51-
5. Then, Syncfusion licensing registration required message box will be shown, if you installed the trial setup or NuGet packages since Syncfusion introduced the licensing system from 2018 Volume 2 (v16.2.0.41) Essential Studio release. Navigate to the [help topic](https://help.syncfusion.com/common/essential-studio/licensing/license-key#how-to-generate-syncfusion-license-key), which is shown in the licensing message box to generate and register the Syncfusion license key to your project. Refer to this [blog](https://blog.syncfusion.com/post/Whats-New-in-2018-Volume-2-Licensing-Changes-in-the-1620x-Version-of-Essential-Studio.aspx) post for understanding the licensing changes introduced in Essential Studio.
47+
7. Click **Add**, and a pop-up will appear providing information about adding Component **files** and **NuGet/Assemblies** details.
5248

53-
![Syncfusion license registration required information dialog in Syncfusion Item Template](Item-Template-images\Syncfusion-Item-Template-Gallery-7.png)
49+
![Syncfusion WinForms Item template details](Item-Template-images/Add-syncfusion-item-3.png)
5450

55-
## Using Visual Studio Add new Item
51+
8. Click **OK** to incorporate the chosen Components into the WinForms application, along with the necessary Syncfusion assemblies.
5652

57-
Syncfusion Project Template can also be added from the Visual Studio Item Template.
53+
![Syncfusion WinForms Item template Gallery](Item-Template-images/Add-syncfusion-item-details.png)
5854

59-
1. To create a Syncfusion WinForms item template, follow either one of the options below:
60-
61-
**Option 1**
62-
Click **Syncfusion Menu** and choose **Essential Studio for WinForms > Add Office2010Form...** or any other Form in **Visual Studio**.
55+
9. Then, Syncfusion licensing registration required message box will be shown if you installed the trial setup or NuGet packages since Syncfusion introduced the licensing system from 2018 Volume 2 (v16.2.0.41) Essential Studio release. Navigate to the [help topic](https://help.syncfusion.com/common/essential-studio/ licensing/license-key#how-to-generate-syncfusion-license-key), which is shown in the licensing message box to generate and register the Syncfusion license key to your project. Refer to this [blog](https://blog.syncfusion.com/post/Whats-New-in-2018-Volume-2-Licensing-Changes-in-the-1620x-Version-of-Essential-Studio.aspx) post for understanding the licensing changes introduced in Essential Studio.
6356

64-
![Syncfusion Project Template can be also add from the Visual Studio Item Template via Syncfusion Menu](Item-Template-images\Syncfusion_Menu_ItemTemplate.png)
65-
66-
N> From Visual Studio 2019, Syncfusion menu is available under Extensions in Visual Studio menu.
67-
68-
**Option 2**
69-
Right-click the Windows Forms Project, select **Add > New Item**, and then navigate to **Visual C# Items or VB Items > Syncfusion > Windows**. Refer to the following screenshot for more information.
70-
71-
![Syncfusion Project Template can be also add from the Visual Studio Item Template](Item-Template-images\Syncfusion-Add-New-Item-1.png)
72-
73-
2. The Syncfusion Item Templates are available under the Syncfusion tab. It is available for both C# Items and VB Items.
74-
75-
![Select required Item Template from Visual Studio Item Template Wizard](Item-Template-images\Syncfusion-Add-New-Item-2.png)
76-
77-
3. Now the selected template is added to the project along with Syncfusion references.
78-
79-
![Selected Syncfusion Item Template added to the project with Forms](Item-Template-images\Syncfusion-Add-New-Item-3.png)
80-
81-
![Selected Syncfusion Item Template required reference assemblies](Item-Template-images\Syncfusion-Add-New-Item-4.png)
82-
83-
4. Then, Syncfusion licensing registration required message box will be shown, if you installed the trial setup or NuGet packages since Syncfusion introduced the licensing system from 2018 Volume 2 (v16.2.0.41) Essential Studio release. Navigate to the [help topic](https://help.syncfusion.com/common/essential-studio/licensing/license-key#how-to-generate-syncfusion-license-key), which is shown in the licensing message box to generate and register the Syncfusion license key to your project. Refer to this [blog](https://blog.syncfusion.com/post/Whats-New-in-2018-Volume-2-Licensing-Changes-in-the-1620x-Version-of-Essential-Studio.aspx) post for understanding the licensing changes introduced in Essential Studio.
84-
85-
![Syncfusion license registration required information dialog in Windows Forms project](Item-Template-images\Syncfusion-Item-Template-Gallery-7.png)
57+
![Syncfusion WinForms Item template Gallery](Item-Template-images/Syncfusion-Item-Template-Gallery-7.png)

Extension/WindowsForms-Extension/Syncfusion-Project-Templates-for-Windows-Forms.md

Lines changed: 9 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -7,32 +7,33 @@ control: Syncfusion Extensions
77
documentation: ug
88
---
99

10-
1110
# Create WinForms application
1211

1312
Syncfusion provides the Visual Studio Project Template for the Syncfusion WinForms platform to create the Syncfusion WinForms Application by adding the required Syncfusion assemblies and forms.
1413

1514
I> The Syncfusion Windows Forms templates are available from v14.3.0.49.
1615

16+
>WinForms Project Template works seamlessly with Visual Studio 2015 or lower. For the Visual Studio 2017 or later versions, it is recommended to use a [WinForms Template Studio](https://help.syncfusion.com/windowsforms/visual-studio-integration/template-studio).
17+
1718
Use the following steps to create the Syncfusion Windows Forms project through the Visual Studio Project Template.
1819

19-
> Before use the Syncfusion WinForms Project Template, check whether the **WinForms Extensions - Syncfusion** installed or not in Visual Studio Extension Manager by clicking on the Tools -> Extensions and Updates -> Installed for Visual Studio 2017 or lower and for Visual Studio 2019 by clicking on the Extensions -> Manage Extensions -> Installed.If this extension not installed, please install the extension by follow the steps from the [download and installation](https://help.syncfusion.com/windowsforms/visual-studio-integration/vs2019-extensions/download-and-installation/) help topic.
20+
> Check whether the **WinForms Extensions - Syncfusion** are installed or not in Visual Studio 2015 or lower by going to **Tools -> Extensions and Updates -> Installed**. If this extension not installed, please install the extension by follow the steps from the [download and installation](https://help.syncfusion.com/windowsforms/visual-studio-integration/download-and-installation) help topic.
2021
2122
1. To create a Syncfusion Windows Forms project, follow either one of the options below:
2223

2324
**Option 1:**
2425
Click **Extensions >Syncfusion Menu** and choose **Essential Studio for WinForms > Create New Syncfusion Project…** in **Visual Studio**.
2526

26-
![Choose Syncfusion Windows Forms Application via Syncfusion menu](Project-Template-images\Syncfusion_Menu_ProjectTemplate.png)
27+
![Choose Syncfusion Windows Forms Application via Syncfusion menu](Project-Template-images\Syncfusion-menu.png)
2728

28-
N> In Visual Studio 2017 or lower, you can see the Syncfusion menu directly in the Visual Studio menu.
29+
N> In Visual Studio 2015 or lower, you can see the Syncfusion menu directly in the Visual Studio menu.
2930

3031
**Option 2:**
3132
Choose **File -> New -> Project**. Opens a new dialog to create a new project. You can obtain the templates provided by Syncfusion for WinForms by filtering the project type with Syncfusion or by using the Syncfusion keyword in the search option
3233

3334
![Choose Syncfusion Windows Forms Application from Visual Studio new project dialog](Project-Template-images\Syncfusion-Project-Template-Gallery2019-1.png)
3435

35-
In Visual Studio 2017 or lower, Select File > New > Project and navigate to Syncfusion > Windows > Syncfusion Windows Forms Application in Visual Studio.
36+
In Visual Studio 2015 or lower, Select File > New > Project and navigate to Syncfusion > Windows > Syncfusion Windows Forms Application in Visual Studio.
3637

3738
![Choose Syncfusion Windows Forms Application from Visual Studio new project dialog](Project-Template-images\Syncfusion-Project-Template-Gallery-1.png)
3839

@@ -44,35 +45,27 @@ Use the following steps to create the Syncfusion Windows Forms project through t
4445

4546
![Syncfusion Windows Forms project configuration wizard](Project-Template-images\Syncfusion-Project-Template-Gallery2019-2.png)
4647

47-
> .NET 6.0 version is available from v19.4.0.38 and support from Visual Studio 2022.
48-
49-
> .NET 7.0 version is available from v20.4.0.38 and support from Visual Studio 2022.
50-
51-
> .NET 8.0 version is available from v23.2.4 and support from Visual Studio 2022.
52-
53-
In Visual Studio 2017 or lower, Syncfusion Windows Forms Application project configuration wizard.
48+
In Visual Studio 2015 or lower, Syncfusion Windows Forms Application project configuration wizard.
5449

5550
![Syncfusion Windows Forms project configuration wizard](Project-Template-images\Syncfusion-Project-Template-Gallery-2.png)
5651

5752
**Project Configurations**
5853

5954
**Project Type:** Select the project type, either .NET Framework or .NET Core.
6055

61-
N> Project type selection option will be available only from Visual Studio 2019 and later in Syncfusion Windows Forms Project template configuration. The .NET 6.0, .NET 7.0, and .NET 8.0 option will be listed in project type only when the .NET 6.0, .NET 7.0, and .NET 8.0 setup has been installed.
62-
6356
**Language:** Select the language, either CSharp or VB.
6457

6558
**Reference From:** Choose the assembly location such as NuGet, GAC Location, or Essential Studio installed location, from where the assembly is added to the project.
6659

67-
N> Installed location and GAC option will be available only when the Syncfusion Essential Windows Forms setup has been installed. You can use NuGet option without installing the Syncfusion Essential Windows Forms setup. Also, the GAC option will not be available when you choose .NET 6.0, .NET 7.0, and .NET 8.0 from project type option in Visual Studio 2022.
60+
N> Installed location and GAC option will be available only when the Syncfusion Essential Windows Forms setup has been installed. You can use NuGet option without installing the Syncfusion Essential Windows Forms setup.
6861

6962
**Installed ES Build Version:** Choose the build version to add the corresponding version assemblies to the project.
7063

7164
N> Installed ES build version option will be available only when you install the Syncfusion Essential Windows Forms setup and choose the assembly location as Installed Location or GAC.
7265

7366
**Select Window:** Choose the window as required for application.
7467

75-
4. After the Project Configuration Wizard is done, the Syncfusion WinForms project is created with required references and forms.
68+
4. After choosing above project configuration options in the Project Configuration Wizard, click the create button then Syncfusion WinForms project is created with the necessary XAML files and required Syncfusion WinForms assemblies/NuGet packages.
7669

7770
![Syncfusion Windows Forms project created with required references](Project-Template-images\Syncfusion-Project-Template-Gallery-6.png)
7871

12.3 KB
Loading
29.2 KB
Loading

0 commit comments

Comments
 (0)