From f5c228ff1de7b63ba75961c755469af5f3c41261 Mon Sep 17 00:00:00 2001 From: Kesavaraman Date: Wed, 14 Aug 2024 09:55:59 +0530 Subject: [PATCH 1/4] UG updated --- Extension/WPF-Extension/Template-Studio.md | 56 +++++++++++----------- 1 file changed, 27 insertions(+), 29 deletions(-) diff --git a/Extension/WPF-Extension/Template-Studio.md b/Extension/WPF-Extension/Template-Studio.md index 6ed2eb62..1fafd6fd 100644 --- a/Extension/WPF-Extension/Template-Studio.md +++ b/Extension/WPF-Extension/Template-Studio.md @@ -53,9 +53,9 @@ Create the Syncfusion WPF project using the Visual Studio Project Template by fo ![Syncfusion WPF project type selection wizard](Template-Studio-Images/WPF-4.png) **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. - - ![Syncfusion WPF Predefined template wizard](Template-Studio-Images/WPFTemplate-6.png) - + + ![Syncfusion WPF Predefined template wizard](Template-Studio-Images/WPFTemplate-6.png) + **Project type:** Choose this option to select from 4 project types, including Navigation Pane, Blank, Menu Bar, and Ribbon . 6. Click **Next** or navigate to the **Pages** tab to access a list of available Syncfusion WPF components you can add to the application. @@ -88,48 +88,46 @@ In the **Project Details** section, you can modify configurations and project ty 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. -10. 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: - - ![ConfigureServices](Template-Studio-Images/DI-Setup.png) +10. 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: + + *I. Application Host:* + - Registers **ApplicationHostService** to manage the app's lifecycle. - I. Application Host: - - Registers `ApplicationHostService` to manage the app's lifecycle. + *II. Specific Services:* + - Registers **PageService** and **NavigationService** for handling page navigation. - II. Specific Services: - - Registers `PageService` and `NavigationService` for handling page navigation. - - III. Views and ViewModels: + *III. Views and ViewModels:* - Registers ShellWindow and ShellViewModel for the main application window. - - Registers `DataGridViewModel` and `DataGridPage` for the added component DataGrid UI. + - Registers **DataGridViewModel** and **DataGridPage** for the added component DataGrid UI. - Registers MainViewModel and MainPage for the main page of the app. - IV. Configuration: - - Binds the app's configuration settings to the `AppConfig` class using the settings from the configuration file. + *IV. Configuration:* + - Binds the app's configuration settings to the **AppConfig** class using the settings from the configuration file. + + ![ConfigureServices](Template-Studio-Images/DI-Setup.png) -11. 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: +11. 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: - I. Initialization: + *I. Initialization:* - The constructor of PageService takes a serviceProvider to access registered services. - II. Registering Pages: - - Configure `();` links the DataGridViewModel to the DataGridPage. - - Configure `();` links the MainViewModel to the MainPage. + *II. Registering Pages:* + - **Configure `()`:** Registers DataGridPage with the service provider. + - **Configure `()`:** Registers MainPage with the service provider. ![PageServices](Template-Studio-Images/PageService.png) -12. 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. +12. 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. ![Resources](Template-Studio-Images/Resources.png) - 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. - - > | .NET Version | Available From Version | Supported from Visual Studio | - > |--------------|------------------------|-----------------------------| - > | .NET 6.0 | v19.4.0.38 | Visual Studio 2022 | - > | .NET 7.0 | v20.4.0.38 | Visual Studio 2022 | - > | .NET 8.0 | v23.2.4 | Visual Studio 2022 | - + + > | .NET Version | Available From Version | Supported from Visual Studio | Listed in "Select a framework version" when SDK is installed | + > |--------------|------------------------|-----------------------------|--------------------------------------------------------------| + > | .NET 6.0 | v19.4.0.38 | Visual Studio 2022 | Yes | + > | .NET 7.0 | v20.4.0.38 | Visual Studio 2022 | Yes | + > | .NET 8.0 | v23.2.4 | Visual Studio 2022 | Yes | 13. 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. From c02263602706c9910445dc45a484b1344e1d851d Mon Sep 17 00:00:00 2001 From: Kesavaraman Date: Wed, 14 Aug 2024 09:56:24 +0530 Subject: [PATCH 2/4] UG updated --- .../WindowsForms-Extension/Template-Studio.md | 36 +++++++++---------- 1 file changed, 17 insertions(+), 19 deletions(-) diff --git a/Extension/WindowsForms-Extension/Template-Studio.md b/Extension/WindowsForms-Extension/Template-Studio.md index 779fdbc3..1827c0c6 100644 --- a/Extension/WindowsForms-Extension/Template-Studio.md +++ b/Extension/WindowsForms-Extension/Template-Studio.md @@ -91,47 +91,45 @@ Create the Syncfusion WinForms project using the Visual Studio Project Template To find out which NuGet packages are needed for other WinForms controls, please refer to this [documentation link](https://help.syncfusion.com/windowsforms/control-dependencies) for detailed information on the required packages for each control. 10. When you create a WinForms project, the following Dependency Injection (DI) setup is added to the **Program.cs** file. This setup registers services, view models, and views with the DI container, ensuring proper functionality and service management within your application. Below **ConfigureServices** method in program.cs file establishes the DI setup in a WinForms project. It manages the application's services, view models, and views. Here's a detailed breakdown: - - ![DI-Setup](Template-Studio-Images/DI-Setup.png) - - I. Application Host: + + *I. Application Host:* - Registers **ApplicationHostService** to manage the app's lifecycle. - II. Specific Services: + *II. Specific Services:* - Registers **PageService** and **NavigationService** for handling page navigation. - III. Views and ViewModels: + *III. Views and ViewModels:* - **ShellWindow:** Registers the main application window. - **DataGridPage:** Registers the added component DataGrid on UI. - **MainPage:** Registers the main page of the application. - IV. Configuration: + *IV. Configuration:* - Binds the app's configuration settings to the **AppConfig** class using the settings from the configuration file. + ![DI-Setup](Template-Studio-Images/DI-Setup.png) + 11. In a WinForms MVVM application, the **PageService.cs** class is responsible for managing navigation and page creation. It registers view models with their corresponding pages, allowing for seamless navigation within the application. Here's a simple explanation: - - ![PageService](Template-Studio-Images/PageService.png) - - I. Initialization: + + *I. Initialization:* - The constructor of PageService takes an IServiceProvider to access the registered services. This allows the service to resolve and instantiate the required view models and views. - II. Registering Pages: + *II. Registering Pages:* - **Configure `()`:** Registers DataGridPage with the service provider. - **Configure `()`:** Registers MainPage with the service provider. + ![PageService](Template-Studio-Images/PageService.png) + 12. Some components require additional resource files, such as pdf and other necessary files, to function correctly. For example, if you add the **PDFViewer** and **Diagram** components to your WinForms project, the respective PDF and ico files will be added to the Resources folder in your project. ![Resources](Template-Studio-Images/Resources.png) - 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. - - > | .NET Version | Available From Version | Supported from Visual Studio | - > |--------------|------------------------|-----------------------------| - > | .NET 6.0 | v19.4.0.38 | Visual Studio 2022 | - > | .NET 7.0 | v20.4.0.38 | Visual Studio 2022 | - > | .NET 8.0 | v23.2.4 | Visual Studio 2022 | + > | .NET Version | Available From Version | Supported from Visual Studio | Listed in "Select a framework version" when SDK is installed | + > |--------------|------------------------|-----------------------------|--------------------------------------------------------------| + > | .NET 6.0 | v19.4.0.38 | Visual Studio 2022 | Yes | + > | .NET 7.0 | v20.4.0.38 | Visual Studio 2022 | Yes | + > | .NET 8.0 | v23.2.4 | Visual Studio 2022 | Yes | 13. If you install the trial setup or NuGet packages from nuget.org, you must register the Syncfusion license key to your application since Syncfusion introduced the licensing system from the 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) to generate and register the Syncfusion license key to your application. 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. From 63481095a4293c15efdf09a3db9c3e53369bc192 Mon Sep 17 00:00:00 2001 From: Kesavaraman Date: Wed, 14 Aug 2024 13:52:49 +0530 Subject: [PATCH 3/4] UG updated --- Extension/WPF-Extension/Template-Studio.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Extension/WPF-Extension/Template-Studio.md b/Extension/WPF-Extension/Template-Studio.md index 1fafd6fd..50838379 100644 --- a/Extension/WPF-Extension/Template-Studio.md +++ b/Extension/WPF-Extension/Template-Studio.md @@ -88,7 +88,7 @@ In the **Project Details** section, you can modify configurations and project ty 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. -10. 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: +10. 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: *I. Application Host:* From 044da8224130962682ccfeea4f1ddbacd634f009 Mon Sep 17 00:00:00 2001 From: Kesavaraman Date: Wed, 14 Aug 2024 14:46:10 +0530 Subject: [PATCH 4/4] UG updated --- Extension/WPF-Extension/Template-Studio.md | 11 ++++++----- Extension/WindowsForms-Extension/Template-Studio.md | 12 ++++++------ 2 files changed, 12 insertions(+), 11 deletions(-) diff --git a/Extension/WPF-Extension/Template-Studio.md b/Extension/WPF-Extension/Template-Studio.md index 50838379..b4a39d26 100644 --- a/Extension/WPF-Extension/Template-Studio.md +++ b/Extension/WPF-Extension/Template-Studio.md @@ -123,11 +123,12 @@ In the **Project Details** section, you can modify configurations and project ty ![Resources](Template-Studio-Images/Resources.png) - > | .NET Version | Available From Version | Supported from Visual Studio | Listed in "Select a framework version" when SDK is installed | - > |--------------|------------------------|-----------------------------|--------------------------------------------------------------| - > | .NET 6.0 | v19.4.0.38 | Visual Studio 2022 | Yes | - > | .NET 7.0 | v20.4.0.38 | Visual Studio 2022 | Yes | - > | .NET 8.0 | v23.2.4 | Visual Studio 2022 | Yes | + > The .NET 6.0, .NET 7.0, and .NET 8.0 options will be available in the Select a framework version dropdown only if the respective .NET SDKs are installed on your system. The table below outlines the .NET versions, the specific product versions from which they are available, and the Visual Studio versions that support them: + > | .NET Version | Available From Version | Supported from Visual Studio | + > |--------------|------------------------|-----------------------------| + > | .NET 6.0 | v19.4.0.38 | Visual Studio 2022 | + > | .NET 7.0 | v20.4.0.38 | Visual Studio 2022 | + > | .NET 8.0 | v23.2.4 | Visual Studio 2022 | 13. 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. diff --git a/Extension/WindowsForms-Extension/Template-Studio.md b/Extension/WindowsForms-Extension/Template-Studio.md index 1827c0c6..8a2306e9 100644 --- a/Extension/WindowsForms-Extension/Template-Studio.md +++ b/Extension/WindowsForms-Extension/Template-Studio.md @@ -124,12 +124,12 @@ Here's a simple explanation: ![Resources](Template-Studio-Images/Resources.png) - - > | .NET Version | Available From Version | Supported from Visual Studio | Listed in "Select a framework version" when SDK is installed | - > |--------------|------------------------|-----------------------------|--------------------------------------------------------------| - > | .NET 6.0 | v19.4.0.38 | Visual Studio 2022 | Yes | - > | .NET 7.0 | v20.4.0.38 | Visual Studio 2022 | Yes | - > | .NET 8.0 | v23.2.4 | Visual Studio 2022 | Yes | + > The .NET 6.0, .NET 7.0, and .NET 8.0 options will be available in the Select a framework version dropdown only if the respective .NET SDKs are installed on your system. The table below outlines the .NET versions, the specific product versions from which they are available, and the Visual Studio versions that support them: + > | .NET Version | Available From Version | Supported from Visual Studio | + > |--------------|------------------------|-----------------------------| + > | .NET 6.0 | v19.4.0.38 | Visual Studio 2022 | + > | .NET 7.0 | v20.4.0.38 | Visual Studio 2022 | + > | .NET 8.0 | v23.2.4 | Visual Studio 2022 | 13. If you install the trial setup or NuGet packages from nuget.org, you must register the Syncfusion license key to your application since Syncfusion introduced the licensing system from the 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) to generate and register the Syncfusion license key to your application. 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.