[]
        
(Showing Draft Content)

Using ComponentOne Templates

ComponentOne WinForms Edition provides predefined project and item templates for creating WinForms applications in Visual Studio.

These templates are installed with WinForms Edition and create ready-to-build projects with the required references, licensing, themes, and sample UI already configured. This reduces manual setup and helps developers focus on application logic.

Templates are available for:

  • .NET Framework

  • .NET

  • C#

  • Visual Basic


Key Benefits

Compared to standard Visual Studio templates, ComponentOne templates automatically:

  • Add required WinForms Edition references and NuGet packages

  • Add a valid Licensing.licx file

  • Configure sample controls and layouts

  • Apply default themes

  • Create runnable starter applications


Supported Platforms and Frameworks

Templates are available for both .NET Framework and .NET applications.

.NET Framework Templates

.NET Templates

  • .NET Framework 4.6.2 and above

  • Visual Studio 2019 or greater

  • C#

  • Visual Basic

  • .NET 6.0 and above

  • Visual Studio 2022 or greater

  • C#

  • Visual Basic


Available Templates

The following project and item templates are available for both C# and Visual Basic.

Project Templates

Template Name

Referenced Assemblies

Description

Windows Forms Docking App (.NET Framework)

C1.Win.Command, C1.Win.Themes

Creates a WinForms application with docking UI using C1CommandDock, C1DockingTab, C1MainMenu, and theme support.

Windows Forms RibbonAndGrid App (.NET Framework)

C1.Win.FlexGrid, C1.Win.Ribbon, C1.Win.Themes

Creates an WinForms application with C1Ribbon, C1FlexGrid, and theme support.

Windows Forms C1Ribbon Application (.NET Framework)

C1.Win.Ribbon

Creates a WinForms application with a main form and child form that use the C1Ribbon control.

Windows Forms Ribbon And Editor App (.NET Framework)

C1.Win.Editor, C1.Win.Ribbon, C1.Win.Themes

Creates a WinForms application with C1Editor and C1Ribbonwith theme support.

Windows Forms Themed App (.NET Framework)

C1.Win.Themes

Creates a themed WinForms application using C1ThemeController

Windows Forms Docking App (.NET)

C1.Win.Command, C1.Win.Themes

Creates a WinForms application with docking UI using C1CommandDock, C1DockingTab, C1MainMenu, and theme support.

Windows Forms RibbonAndGrid App (.NET)

C1.Win.FlexGrid, C1.Win.Ribbon, C1.Win.Themes

Creates a WinForms application with C1Ribbon, C1FlexGrid, and theme support.

Windows Forms Ribbon And Editor App (.NET)

C1.Win.Editor, C1.Win.Ribbon, C1.Win.Themes

Creates a WinForms application with C1Editor and C1Ribbonwith theme support.

Windows Forms Themed App (.NET)

C1.Win.Themes

Creates a themed WinForms application using C1ThemeController

.NET Framework Templates

C#

Visual Basic

C1WinForms - .NET Framework C# project templates

C1WinForms - .NET Framework Visual Basic project templates

.NET

C#

Visual Basic

C1WinForms - .NET C# project templates

C1WinForms - .NET Visual Basic project templates


Item Templates

Template Name

Referenced Assemblies

Description

C1Ribbon Form (Windows Forms .NET Framework)

C1.Win, C1.Win.Ribbon

Adds a ribbon-enabled child form styled for use with a ribbon application

C#

Visual Basic

C1WinForms - .NET C# item templates

C1WinForms - .NET Visual Basic item templates


Installation

Project and item templates are registered automatically after installing WinForms Edition through the ComponentOne Studio installer.

Create a Project from a ComponentOne Template

The following steps demonstrate how to create a WinForms project using ComponentOne templates.

  1. Open Visual Studio.

  2. Select File > New > Project.

  3. In the “Create a new project” dialog, search for C1 or ComponentOne.

  4. Select the required project template.

  5. Select the target framework.

C1WinForms - .NET C# project templates usage

  1. Configure the project name and location.

  2. Select Create.

After project creation, Visual Studio restores required NuGet packages automatically and opens the generated application.


Default Themes

The following table lists the default themes used by each template type.

Template Name

Default .NET Framework Theme

Default .NET Theme

Windows Forms Docking App

VS2013Light

Office2016Green

Windows Forms RibbonAndGrid App

VS2013Light

Office2016Green

Windows Forms C1Ribbon App

No default theme

Not available

Windows Forms Ribbon And Editor App

Office2016Colorful

Office2016Colorful

Windows Forms Themed App

Office2016Colorful

Office2016Green


Template Behavior

For .NET Framework projects, Visual Studio may require an initial build before forms can be opened in the designer because packages must be restored first.

For .NET projects, Visual Studio restores packages automatically during project creation and opens the generated form after restore completes.

Item templates appear under C# Items or Common Items for Visual Basic. When a C1Ribbon Form item is added, Visual Studio adds the required references if they are not already present.

Visual Studio may display a trust warning when adding item templates, depending on local template security settings.

C1WinForms - Project template behavior warning


Limitations

Limitation

Description

.NET Framework designer restore requirement

Forms may require an initial build before opening in the designer

Visual Studio template warnings

Item templates may trigger trust warnings

.NET project preview limitation

Visual Studio does not display preview images for .NET templates