Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 25 additions & 11 deletions WindowsForms-toc.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,16 +9,30 @@
<li>
<a href="/windowsforms/System-Requirements">System Requirements</a>
</li>
<li>
<a href="/windowsforms/skills">Skills</a>
</li>
<li>AI Coding Assistant
<ul>
<li><a href="/windowsforms/ai-coding-assistant/overview">Overview</a></li>
<li><a href="/windowsforms/ai-coding-assistant/mcp-server">MCP Server</a></li>
<li><a href="/windowsforms/ai-coding-assistant/prompt-library">Prompt Library</a></li>
</ul>
</li>
<li>
AI and Smart Tooling
<ul>
<li>
MCP Server
<ul>
<li>
AI Coding Assistant
<ul>
<li><a href="/windowsforms/ai-coding-assistant/overview">Overview</a></li>
<li><a href="/windowsforms/ai-coding-assistant/mcp-server">MCP Server</a></li>
<li><a href="/windowsforms/ai-coding-assistant/prompt-library">Prompt Library</a></li>
</ul>
</li>
</ul>
</li>
<li>
Skills
<ul>
<li><a href="/windowsforms/skills/component-skills">Component Skills</a></li>
</ul>
</li>
</ul>
</li>
<li>Installation<ul>
<li>Web Installer
<ul>
Expand Down Expand Up @@ -6144,7 +6158,7 @@
<li>2026 Volume 1 - v33.*
<ul>
<li> Weekly Nuget Release
<ul>
<ul><li><a href="/windowsforms/release-notes/v33.2.7">v33.2.7</a></li>
<li><a href="/windowsforms/release-notes/v33.2.6">v33.2.6</a></li>
<li><a href="/windowsforms/release-notes/v33.2.5">v33.2.5</a></li>
<li><a href="/windowsforms/release-notes/v33.2.4">v33.2.4</a></li>
Expand Down
91 changes: 91 additions & 0 deletions WindowsForms/Release-notes/v33.2.7.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
---
title: Essential Studio® for Windows Forms Release Notes - v33.2.7
description: Learn here about the controls in the Essential Studio® for Windows Forms Weekly Nuget Release - Release Notes - v33.2.7
platform: windowsforms
documentation: ug
---

# Essential Studio® for Windows Forms - v33.2.7 Release Notes

{% include release-info.html date="May 19, 2026" version="v33.2.7" passed="9755" failed="0" %}

{% directory path: _includes/release-notes/v33.2.7 %}

{% include {{file.url}} %}

{% enddirectory %}

## Test Results

| Component Name | Test Cases | Passed | Failed | Remarks |
|----------------|------------|--------|--------|---------|
| AutoComplete | 58 | 58 | 0 | All Passed |
| AutoLabel | 3 | 3 | 0 | All Passed |
| Breadcrumb | 1 | 1 | 0 | All Passed |
| Button | 4 | 4 | 0 | All Passed |
| ButtonAdv | 3 | 3 | 0 | All Passed |
| Calendar | 1 | 1 | 0 | All Passed |
| Carousel | 7 | 7 | 0 | All Passed |
| Chart | 991 | 991 | 0 | All Passed |
| CheckBox | 134 | 134 | 0 | All Passed |
| Color Picker | 28 | 28 | 0 | All Passed |
| Color Picker DropDown | 3 | 3 | 0 | All Passed |
| ComboBox | 70 | 70 | 0 | All Passed |
| ComboBoxAdv | 339 | 339 | 0 | All Passed |
| ComboDropDown | 2 | 2 | 0 | All Passed |
| CommandBarController | 1 | 1 | 0 | All Passed |
| CurrencyEdit | 1 | 1 | 0 | All Passed |
| DataGrid | 938 | 938 | 0 | All Passed |
| DateTimePicker | 104 | 104 | 0 | All Passed |
| DateTimePickerAdv | 44 | 44 | 0 | All Passed |
| Digital Gauge | 7 | 7 | 0 | All Passed |
| Docking Manager | 1969 | 1969 | 0 | All Passed |
| DomainUpDownExt | 3 | 3 | 0 | All Passed |
| DoubleTextBox | 3 | 3 | 0 | All Passed |
| FontListBox | 2 | 2 | 0 | All Passed |
| Form | 23 | 23 | 0 | All Passed |
| Gradient Panel | 4 | 4 | 0 | All Passed |
| GroupView | 2 | 2 | 0 | All Passed |
| HTML Viewer | 53 | 53 | 0 | All Passed |
| Image Streamer | 1 | 1 | 0 | All Passed |
| Linear Gauge | 58 | 58 | 0 | All Passed |
| ListView | 65 | 65 | 0 | All Passed |
| Menu | 3 | 3 | 0 | All Passed |
| MessageBox | 2 | 2 | 0 | All Passed |
| Metro Form | 26 | 26 | 0 | All Passed |
| MonthCalendarAdv | 25 | 25 | 0 | All Passed |
| Multicolumn ComboBox | 8 | 8 | 0 | All Passed |
| Multicolumn TreeView | 103 | 103 | 0 | All Passed |
| Navigation Drawer | 52 | 52 | 0 | All Passed |
| Navigation Pane | 37 | 37 | 0 | All Passed |
| Numeric TextBox | 5 | 5 | 0 | All Passed |
| NumericUpdown | 6 | 6 | 0 | All Passed |
| Office 2007 Form | 61 | 61 | 0 | All Passed |
| PercentTextBox | 2 | 2 | 0 | All Passed |
| Pivot Chart | 124 | 124 | 0 | All Passed |
| Pivot Grid | 216 | 216 | 0 | All Passed |
| Popup | 4 | 4 | 0 | All Passed |
| Progress Bar | 4 | 4 | 0 | All Passed |
| Radial Gauge | 85 | 85 | 0 | All Passed |
| Radial Menu | 2 | 2 | 0 | All Passed |
| Radial Slider | 12 | 12 | 0 | All Passed |
| Range Slider | 7 | 7 | 0 | All Passed |
| Rating Control | 1 | 1 | 0 | All Passed |
| Ribbon | 1492 | 1492 | 0 | All Passed |
| Scroll Frame | 1 | 1 | 0 | All Passed |
| SfDataPager | 95 | 95 | 0 | All Passed |
| Spell Checker | 51 | 51 | 0 | All Passed |
| Splash Screen | 2 | 2 | 0 | All Passed |
| Split Button | 15 | 15 | 0 | All Passed |
| StatusStrip | 18 | 18 | 0 | All Passed |
| SuperToolTip | 1 | 1 | 0 | All Passed |
| Syntax Editor | 534 | 534 | 0 | All Passed |
| Tabbed Form | 25 | 25 | 0 | All Passed |
| TabbedMdiManager | 481 | 481 | 0 | All Passed |
| TabControl | 729 | 729 | 0 | All Passed |
| TextBox | 13 | 13 | 0 | All Passed |
| ToolBar | 5 | 5 | 0 | All Passed |
| TrackBar | 1 | 1 | 0 | All Passed |
| Tree Navigator | 17 | 17 | 0 | All Passed |
| TreeView | 474 | 474 | 0 | All Passed |
| XpTaskbar | 94 | 94 | 0 | All Passed |
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ Before installing Syncfusion<sup style="font-size:70%">&reg;</sup> Windows Forms

## Installation

Install [Syncfusion<sup style="font-size:70%">&reg;</sup> Windows Forms components skills](https://github.com/syncfusion/winforms-ui-components-skills.git) using the Skills CLI. Users can also explore available skills from the [marketplace](https://skills.sh/syncfusion/).
Install [Syncfusion<sup style="font-size:70%">&reg;</sup> Windows Forms components skills](https://github.com/syncfusion/winforms-ui-components-skills.git) using the Skills CLI. Users can also explore available skills from the [marketplace](https://www.skills.sh/syncfusion).

### Install all skills

Expand Down Expand Up @@ -127,7 +127,7 @@ Choose your installation scope (project-level or global), then confirm to comple

This registers the Syncfusion<sup style="font-size:70%">&reg;</sup> skill pack so your AI assistant can automatically load it in supported IDEs such as [Code Studio](https://help.syncfusion.com/code-studio/reference/configure-properties/skills), [Visual Studio Code](https://code.visualstudio.com/docs/copilot/customization/agent-skills), and [Cursor](https://cursor.com/docs/skills).

To learn more about the Skills CLI, refer [here](https://skills.sh/docs).
To learn more about the Skills CLI, refer [here](https://www.skills.sh/docs).

## How Syncfusion<sup style="font-size:70%">&reg;</sup> Agent Skills Work

Expand Down Expand Up @@ -217,4 +217,4 @@ Verify that skills are installed in the correct agent directory, restart the IDE
## See also

- [Agent Skills Standards](https://agentskills.io/home)
- [Skills CLI](https://skills.sh/docs)
- [Skills CLI](https://www.skills.sh/docs)
Binary file added WindowsForms/skills/images/UI-Builder-Agent.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
202 changes: 202 additions & 0 deletions WindowsForms/skills/ui-builder-skill.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,202 @@
---
layout: post
title: Syncfusion® WinForms UI Builder Skill for AI Assistants | Syncfusion®
description: Install Syncfusion® Windows Forms UI Builder to generate production-ready Windows Forms controls from natural-language prompts.
control: Skills
platform: windowsforms
documentation: ug
domainurl: ##DomainURL##
---

# Syncfusion® Windows Forms UI Builder Skill for AI Assistants

**Syncfusion® Windows Forms UI Builder** is an AI-powered skill and companion agent that accelerates Windows Forms application development by transforming natural-language UI requirements into production-ready controls using Syncfusion® Windows Forms libraries.

Integrated with your AI-powered IDE, it leverages deep knowledge of **Syncfusion® controls** to deliver accurate and ready-to-use code.
By combining intelligent code generation with best practices, accessibility standards, and design-system consistency, Windows Forms UI Builder helps you rapidly build scalable dashboards and user interfaces without leaving your development workflow.

## Prerequisites

Before installing Windows Forms UI Builder, ensure the following:

- Install [APM (Agent Package Manager)](https://microsoft.github.io/apm/getting-started/installation/#quick-install-recommended)
- Required [.NET SDK](https://dotnet.microsoft.com/en-us/download) version ≥ 6
- Windows Forms application (existing or new); see [Overview](https://help.syncfusion.com/windowsforms/overview)
- A supported AI agent or IDE that integrates with the Skills (VS Code, Cursor, Syncfusion® Code Studio, etc.)
- Active Syncfusion<sup style="font-size:70%">&reg;</sup> license(any of the following):
- [Commercial](https://www.syncfusion.com/sales/unlimitedlicense)
- [Community License](https://www.syncfusion.com/products/communitylicense)
- [Free Trial](https://www.syncfusion.com/account/manage-trials/start-trials)

## Key Benefits

### **AI-Driven UI Generation**
- Converts prompts into complete Windows Forms components—not just snippets
- Automatically selects appropriate Syncfusion® controls and features
- Produces structured, maintainable C# code

### **Control Usage & API Accuracy**
- Uses correct Syncfusion® control APIs and properties
- Injects required feature controls and behaviors (paging, sorting, filtering, etc.)
- Ensures proper assembly references and control initialization
- Avoids unsupported or deprecated patterns for Windows Forms

### **Patterns & Best Practices**
- Recommended control composition and data-binding patterns
- Event handling aligned with Windows Forms standards and designer integration
- Secure and scalable coding patterns with proper resource management
- Designer-friendly code that works in both code-behind and UI designer

### **Accessibility & Design System**
- Follows Windows accessibility guidelines
- Supports keyboard navigation and accessibility standards
- Theme consistency across desktop applications

### **Design-System Integration**
- Supports Syncfusion® Windows Forms themes via SkinManager (Office2007, Office2010, Office2013, Office2016, Office2019, Metro, HighContrast)
- SkinManager integration for consistent theming
- Theme Studio support for customizing Office2019Colorful and HighContrastBlack themes
- Ensures consistent Syncfusion® styling across controls

## Installation

Before installing WinForms UI Builder, ensure that APM (Agent Package Manager) is installed and available in your environment.

### Verify APM Installation

Run the following command to confirm APM is installed:

```bash
apm --version
```

### Install the Syncfusion® Windows Forms UI Builder package using APM

Use the APM CLI to install the WinForms UI Builder skill for your preferred environment:

{% tabs %}
{% highlight bash tabtitle="Copilot" %}

apm install syncfusion/winforms-ui-builder -t copilot

{% endhighlight %}
{% highlight bash tabtitle="Cursor" %}

apm install syncfusion/winforms-ui-builder -t cursor

{% endhighlight %}
{% highlight bash tabtitle="Codex" %}

apm install syncfusion/winforms-ui-builder -t codex

{% endhighlight %}
{% highlight bash tabtitle="Claude" %}

apm install syncfusion/winforms-ui-builder -t claude

{% endhighlight %}
{% endtabs %}

After installation, the following artifacts are added to your project for the GitHub Copilot target:

- `.agent/skills/` – contains the skill files
- `.github/agents/` – contains the agent configuration

Refer to the [documentation](https://microsoft.github.io/apm/reference/cli/targets/#detection-signals) for details about supported deployment targets.

> For Syncfusion® Code Studio, use the Copilot command above to install the WinForms UI Builder.

## How the Syncfusion® Windows Forms UI Builder Skill Works

1. **Intent Analysis** — Parse the user's prompt to identify control types and high-level form layout intent.
2. **Project Detection** — Automatically detects .NET framework (Framework, Core, or .NET 5+) and existing Syncfusion® configurations.
3. **Control Mapping** — Map intent to Syncfusion® Windows Forms controls and required feature controls.
4. **Theming & Design System**
Load required theming guidelines and confirm key design choices:
- Syncfusion® Windows Forms theme (Office2007, Office2010, Office2013, Office2016, Office2019, Metro, HighContrast)
- Core design basics (colors, fonts, control appearance, DPI awareness)
- Light and dark theme variants per theme family
5. **Code Generation** — Produce C# Windows Forms controls, data bindings, event handlers, and styling.
6. **Dependency Management** — Recommend or install required Syncfusion® NuGet packages and .NET dependencies.
7. **Validation** — Run code compatibility and basic security checks, request confirmation for changes.
8. **Code Insertion** — Create Form classes, user controls, or patch existing files following Windows Forms conventions.

Key enforcement points:

- Adds correct SkinManager configuration and theme settings for chosen Syncfusion® themes (loads required theme assemblies)
- Injects only the feature controls and behaviors required by generated controls
- Follows Windows Forms conventions for control naming, initialization, and event handling
- Generates designer-compatible code with proper control hierarchy and parent-child relationships
- Ensures all required Syncfusion® assemblies and theme NuGet packages are referenced and configured
- Avoids unsupported or deprecated API usages for Syncfusion® Windows Forms controls

> The assistant handles most stages automatically and may request confirmation where required.

## Using the AI Assistant

After installing Windows Forms UI Builder with APM, the relevant agent and skill files are added to your project under:

- `.agent/skills/` (skill files)
- `.github/agents/` (Windows Forms UI builder agent configuration, based on the selected target)

To start using the skill:

1. Open your supported IDE.
2. In the chat panel, select the `syncfusion-winforms-ui-builder` agent from the **Agent dropdown**.

![Set Agent](images/UI-Builder-Agent.png)

3. Start prompting the agent with a clear description of your UI requirements.

Examples Prompts:

{% promptcards %}
{% promptcard Authentication %}
Create a login form using the Office2019Colorful theme with a centered TableLayoutPanel containing email and password TextBox controls with validation. Include a "Remember Me" CheckBox, a forgot password LinkLabel, and a primary login Button. Add a secondary "Create Account" button below. Ensure the form is well-organized and follows Windows Forms best practices with proper SkinManager configuration.
{% endpromptcard %}
{% promptcard Admin Dashboard %}
Create a CMS Admin Dashboard UI featuring a collapsible TreeView in a left panel (docked) with navigation items for Dashboard, Content, Users, Analytics, and Settings; a top StatusBar showing the title "CMS Admin Dashboard" and user name; and a main content area with a SplitContainer containing three compact summary panels in a FlowLayoutPanel displaying Total Content, Total Users, and Active Sessions (each showing a label, count value, and percentage change), followed by a "Content Management" section with a DataGrid containing columns for Title, Author, Status, Date, and Actions, and finally two charts displayed side by side—a column chart titled "Content Over Time" and a pie chart titled "Content by Category"—using realistic sample data.
{% endpromptcard %}
{% endpromptcards %}

Generated code follows Windows Forms best practices with proper control layout, event handling, data bindings, strong C# typing, and built-in security measures such as input validation and avoidance of hardcore secrets. The code is fully compatible with Visual Studio designer and Windows Forms conventions.

## Best Practices

Follow these guidelines to get the most out of UI Builder and ensure high-quality production-ready results:

- **Stay consistent** — Maintain consistent file organization, naming conventions (PascalCase for classes, camelCase for variables), and Windows Forms coding standards throughout your project.
- **Use advanced AI models** — For best results, use **Claude Sonnet 4.6 or higher** capability models to produce better code quality and more accurate implementations.
- **Review all content before production** — Validate the logic, security, and compatibility with your existing code and target .NET framework before deployment. Test control functionality within Visual Studio designer and at runtime.
- **Verify Syncfusion® licenses** — Ensure all required Syncfusion® controls have valid licenses before deploying to production.
- **Test across platforms** — Verify DPI awareness, high-resolution display support, and Windows accessibility features.

## Troubleshooting

- **APM installation failure**: Refer to this [documentation](https://microsoft.github.io/apm/getting-started/installation/#troubleshooting)

- **Skills not loading**: Ensure the **.agent/** and **.github/agents/** folders exist in your project and that the skill was installed successfully using APM. Verify that the correct agent is selected from the Agent dropdown in your IDE.

- **Control not rendering**: Retry generation using the specific control skill to resolve the issue, and ensure required Syncfusion® packages and themes are properly configured.

- **Syncfusion license banner appears**: Use the licensing skill to correctly register and validate your Syncfusion® license key in the application.


## FAQ

**Which agents/IDEs are supported?**
Any Skills-compatible agent that reads local skill files (Code Studio, VS Code, Cursor, etc.).

**Are skills loaded automatically?**
Yes. Supported agents automatically load relevant skills based on your query.

**Can I customize the generated styles?**
Yes — the generated Windows Forms controls include clear integration points for style adjustments.

**Does it modify files automatically?**
The skill proposes changes and requires confirmation for insertion; automatic dependency installation may be offered depending on agent permissions.

## See also

- [Agent Skills Standards](https://agentskills.io/home)
- [Agent Package Manager](https://microsoft.github.io/apm/getting-started/quick-start/)