Skip to content

Commit e334a76

Browse files
WinForm and WPF UG updated
1 parent ae553b1 commit e334a76

File tree

12 files changed

+120
-30
lines changed

12 files changed

+120
-30
lines changed
40.9 KB
Loading
52.3 KB
Loading
54 KB
Loading
57.4 KB
Loading
48.8 KB
Loading

Extension/WPF-Extension/Template-Studio.md

Lines changed: 62 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
layout: post
33
title: Template Studio | Wpf | Syncfusion
44
description: Syncfusion provides the Visual Studio Project Templates for the Syncfusion WPF platform to create Syncfusion WPF Application by addiing the required assemblies
5-
platform: extension
5+
platform: wpf
66
control: Syncfusion Extensions
77
documentation: ug
88
---
@@ -48,11 +48,17 @@ Create the Syncfusion WPF project using the Visual Studio Project Template by fo
4848

4949
I> Visual Basic Language support is available in WPF Template Studio starting from version 25.1.35.
5050

51-
5. Click **Next** or navigate to the **Project type** tab, then select the desired Syncfusion WPF application type.
51+
5. Click **Next** or navigate to the **Type** tab, then select the desired Syncfusion WPF application type. When selecting the type of template for your application, you have two options:
5252

53-
![Syncfusion WPF project type selection wizard](Template-Studio-Images/WPF-5.png)
53+
![Syncfusion WPF project type selection wizard](Template-Studio-Images/WPF-4.png)
5454

55-
6. Click **Next** or navigate to the **Pages** tab to access a list of available Syncfusion WPF components you can add to the application.
55+
**Predefined template:** Choose this option to select from 5 predefined templates, including Calendar, Contact, Outlook, Docking Manager, Spreadsheet, Tile view, and Word. By choosing one of these templates, you can create your application without needing to follow any further steps.
56+
57+
![Syncfusion WPF Predefined template wizard](Template-Studio-Images/WPFTemplate-6.png)
58+
59+
**Project type:** Choose this option to select from 4 project types, including Navigation Pane, Blank, Menu Bar, and Ribbon .
60+
61+
6. Click **Next** or navigate to the **Pages** tab to access a list of available Syncfusion WPF components you can add to the application.
5662

5763
![Syncfusion WPF pages selection wizard](Template-Studio-Images/WPF-6.png)
5864

@@ -66,28 +72,67 @@ Create the Syncfusion WPF project using the Visual Studio Project Template by fo
6672

6773
8. Click **Next** or navigate the **App Features** tab to select the desired application features.
6874

69-
![Syncfusion WPF app features selection wizard](Template-Studio-Images/WPF-7.png)
75+
![Syncfusion WPF app features selection wizard](Template-Studio-Images/WPF-7.png)
76+
77+
**Project Details Section**
78+
79+
In the **Project Details** section, you can modify configurations and project types. Additionally, you can remove one or more controls from the selected list and remove the chosen application feature.
80+
81+
![Syncfusion WPF project details selection and unselection wizard](Template-Studio-Images/WPF-8.png)
82+
83+
9. Click **Create** to generate the Syncfusion WPF application, which will include the necessary Syncfusion NuGet packages, styles, and rendering code specific to the chosen components. The application is configured with the latest versions of Syncfusion WPF NuGet packages, complete with the appropriate namespaces for seamless integration.
84+
85+
![Syncfusion WPF project created with readme](Template-Studio-Images/WPF-9.png)
86+
87+
10. After creating the project and selecting the desired components, the necessary Syncfusion NuGet packages will be installed automatically. For example, if you add an `DataGrid` control, the corresponding Syncfusion NuGet packages required for that control will be installed.
7088

71-
**Project Details Section**
89+
![NuGetEntry](Template-Studio-Images/NuGetEntry.png)
7290

73-
In the **Project Details** section, you can modify configurations and project types. Additionally, you can remove one or more controls from the selected list and remove the chosen application feature.
91+
To find out which NuGet packages are needed for other WPF controls, please refer to this [documentation link](https://help.syncfusion.com/wpf/control-dependencies) for detailed information on the required NuGet packages for each control.
7492

75-
![Syncfusion WPF project details selection and unselection wizard](Template-Studio-Images/WPF-8.png)
93+
11. When you create a WPF project, the following Dependency Injection (DI) setup is added to the `App.xaml.cs` file. This setup registers services, view models, and views with the DI container, ensuring proper functionality for the selected components and service management within your application. Below, the `ConfigureServices` method in `App.xaml.cs` sets up Dependency Injection (DI) in a WPF project to manage the application's services, view models, and views. Here's a simple breakdown:
7694

77-
9. Click **Create** to initiate the process. This action generates the Syncfusion WPF application. The resulting Syncfusion WPF app has the necessary Syncfusion NuGet packages, styles, and rendering code specific to the chosen Syncfusion component.
95+
![ConfigureServices](Template-Studio-Images/DI-Setup.png)
7896

79-
![Syncfusion WPF project created with readme](Template-Studio-Images/WPF-9.png)
8097

81-
10. The Syncfusion WPF application is configured with the latest versions of Syncfusion WPF NuGet packages, complete with the appropriate namespaces and component render code for seamless integration of Syncfusion components.
98+
I. Application Host:
99+
- Registers `ApplicationHostService` to manage the app's lifecycle.
100+
101+
II. Specific Services:
102+
- Registers `PageService` and `NavigationService` for handling page navigation.
103+
104+
III. Views and ViewModels:
105+
- Registers ShellWindow and ShellViewModel for the main application window.
106+
- Registers `DataGridViewModel` and `DataGridPage` for the added component DataGrid UI.
107+
- Registers MainViewModel and MainPage for the main page of the app.
108+
109+
IV. Configuration:
110+
- Binds the app's configuration settings to the `AppConfig` class using the settings from the configuration file.
111+
112+
12. In a WPF MVVM application, the `PageService.cs` class helps manage navigation and page creation. For instance, it facilitates registering and navigating to pages associated with specific view models. Here's a simple explanation:
113+
114+
I. Initialization:
115+
- The constructor of PageService takes a serviceProvider to access registered services.
116+
117+
II. Registering Pages:
118+
- Configure `<DataGridViewModel, DataGridPage>();` links the DataGridViewModel to the DataGridPage.
119+
- Configure `<MainViewModel, MainPage>();` links the MainViewModel to the MainPage.
120+
121+
![PageServices](Template-Studio-Images/PageService.png)
122+
123+
13. Some components require additional resource files, such as images and other necessary files, to function correctly. For example, if you add the `PDFViewer` and `Carousel` component to your WPF project, the respective images and PDF files will be added to the Images and Assets folder in your project.
82124

83-
N> The .Net 6.0,.Net7.0, and .Net 8.0 option will be listed in Select a framework version when only the .Net 6.0, .Net 7.0, and .Net 8.0 SDK setup has been installed.
125+
![Resources](Template-Studio-Images/Resources.png)
84126

85-
> .NET 6.0 version is available from v19.4.0.38 and it support from Visual Studio 2022.
127+
N> The .Net 6.0, .Net 7.0, and .Net 8.0 option will be listed in Select a framework version when only the .Net 6.0, .Net 7.0, and .Net 8.0 SDK setup has been installed.
86128

87-
> .NET 7.0 version is available from v20.4.0.38 and it support from Visual Studio 2022.
129+
> | .NET Version | Available From Version | Supported from Visual Studio |
130+
> |--------------|------------------------|-----------------------------|
131+
> | .NET 6.0 | v19.4.0.38 | Visual Studio 2022 |
132+
> | .NET 7.0 | v20.4.0.38 | Visual Studio 2022 |
133+
> | .NET 8.0 | v23.2.4 | Visual Studio 2022 |
88134
89-
> .NET 8.0 version is available from v23.2.4 and it support from Visual Studio 2022.
90135

91-
11. 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/overview#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://www.syncfusion.com/blogs/post/whats-new-in-2018-volume-2.aspx) post for understanding the licensing changes introduced in Essential Studio.
136+
14. 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/overview#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://www.syncfusion.com/blogs/post/whats-new-in-2018-volume-2.aspx) post for understanding the licensing changes introduced in Essential Studio.
92137

93-
![Syncfusion license registration required information dialog in Syncfusion WPF project](Template-Studio-Images/Syncfusion-Project-Template-Gallery-9.png)
138+
![Syncfusion license registration required information dialog in Syncfusion WPF project](Template-Studio-Images/Syncfusion-Project-Template-Gallery-9.png)
33.5 KB
Loading
32.6 KB
Loading
49.3 KB
Loading
95.7 KB
Loading

0 commit comments

Comments
 (0)