Windows Forms Theming (SkinManager)

When to Use This Skill

• Apply themes to Syncfusion WinForms controls (Office2007, Office2010, Office2013, Office2016, Office2019, Metro)
• Set up theme assemblies and load them properly
• Apply themes to entire applications, forms, or containers
• Customize theme appearance using ThemeStyle or Style properties
• Apply themes through designer or code-based approaches
• Control whether themes override user customizations

Component Overview

• Multiple predefined themes (Office2007, Office2010, Office2013, Office2016, Office2019, Metro, HighContrast)
• Application-wide theme management
• Form/container-level theme application
• Individual control theme application
• Advanced styling through ThemeStyle/Style properties

Syncfusion.Shared.Base

Documentation and Navigation Guide

Getting Started

• Assembly deployment and theme assembly requirements
• Loading theme assemblies using LoadAssembly method
• Adding SkinManager component through designer
• Adding SkinManager component through code
• Basic theme application to controls and forms
• Applying themes to entire forms and containers

Theme Management

• Complete list of available themes
• VisualTheme property usage
• SetVisualTheme method for programmatic theme setting
• Application-wide theming using ApplicationVisualTheme
• Individual control theming using ThemeName property
• Assembly requirements for specific themes
• Theme application patterns and best practices

Advanced Customization

• ThemeStyle property for theme customization
• Style property for Sf-prefixed controls
• CanOverrideStyle property behavior
• FontHelper customization for application-wide fonts
• Custom styling examples and patterns
• Overriding user customizations with themes

Quick Start Example

Basic Theme Application (Code-Based)

using Syncfusion.Windows.Forms;

namespace MyWinFormsApp
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
            
            // Create SkinManager instance
            SkinManager skinManager1 = new SkinManager(this.components);
            
            // Apply theme to entire form (all Syncfusion controls)
            skinManager1.Controls = this;
            skinManager1.VisualTheme = VisualTheme.Office2016Black;
        }
    }
}

Application-Wide Theme (Program.cs)

using Syncfusion.Windows.Forms;
using Syncfusion.WinForms.Themes;

static class Program
{
    [STAThread]
    static void Main()
    {
        // Load theme assembly (for Office2019, Office2016, HighContrast)
        SkinManager.LoadAssembly(typeof(Office2019Theme).Assembly);
        
        // Set application-wide theme
        SkinManager.ApplicationVisualTheme = "Office2019Colorful";
        
        Application.EnableVisualStyles();
        Application.SetCompatibleTextRenderingDefault(false);
        Application.Run(new Form1());
    }
}

Common Patterns

Pattern 1: Theme Entire Form

// Apply theme to all Syncfusion controls in a form
SkinManager skinManager1 = new SkinManager(this.components);
skinManager1.Controls = this; // 'this' refers to the form
skinManager1.VisualTheme = VisualTheme.Office2016White;

Pattern 2: Theme Individual Control

// Option 1: Using SkinManager
skinManager1.Controls = treeViewAdv1;
skinManager1.VisualTheme = VisualTheme.Office2016Colorful;

// Option 2: Using ThemeName property
this.treeViewAdv1.ThemeName = "Office2019Colorful";

Pattern 3: Loading Required Theme Assemblies

// Office2019 themes
SkinManager.LoadAssembly(typeof(Office2019Theme).Assembly);

// Office2016 themes (for SfDataGrid, SfButton, etc.)
SkinManager.LoadAssembly(typeof(Syncfusion.WinForms.Themes.Office2016Theme).Assembly);

// HighContrast themes
SkinManager.LoadAssembly(typeof(HighContrastTheme).Assembly);

Pattern 4: Customize Theme Appearance

// For Theme Studio themes, customize using ThemeStyle
this.treeViewAdv1.ThemeName = "Office2019Colorful";
this.treeViewAdv1.ThemeStyle.BackColor = System.Drawing.Color.White;
this.treeViewAdv1.ThemeStyle.BorderColor = System.Drawing.Color.SteelBlue;
this.treeViewAdv1.ThemeStyle.TreeNodeAdvStyle.TextColor = System.Drawing.Color.Red;

Key Properties and Methods

SkinManager Properties

Controls

VisualTheme

ApplicationVisualTheme

SkinManager Methods

SetVisualTheme(Control, VisualTheme)

SetVisualTheme(Control, String)

LoadAssembly(Assembly)

Control-Level Properties

ThemeName

ThemeStyle

Style

CanOverrideStyle

Available Themes

Predefined Themes (Built-in)

• Office2007: Blue, Black, Silver, Managed
• Office2010: Blue, Black, Silver, Managed
• Office2013: White, Dark Gray, Black, Colorful
• Metro

Separate Assembly Themes

• Office2016: White, Dark Gray, Black, Colorful (requires

  Syncfusion.Office2016Theme.WinForms.dll

  )
• Office2019: Colorful (requires

  Syncfusion.Office2019Theme.WinForms.dll

  )
• HighContrast: Black (requires

  Syncfusion.HighContrastTheme.WinForms.dll

  )

Common Use Cases

1. Uniform Application Styling: Apply consistent theme across all forms and controls
2. Modern UI Appearance: Use Office2016/2019 themes for contemporary look
3. Dark Mode Support: Implement dark themes (Office2016Black, Office2016DarkGray)
4. Accessibility Compliance: Use HighContrast themes for accessibility
5. Dynamic Theme Switching: Change themes at runtime based on user preferences
6. Per-Form Theming: Apply different themes to different forms in the same application

Important Notes

• Assembly Loading: Always call

  LoadAssembly()

  before applying themes that require separate assemblies
• Application-Wide Theme: Set

  ApplicationVisualTheme

  before main form initialization (in Program.cs)
• Container Theming: Apply theme to form/container instead of individual controls for efficiency
• Override Behavior: Themes respect

  CanOverrideStyle

  property to control customization overrides

Troubleshooting

• Verify theme assembly is loaded using

  LoadAssembly()

• Check that

  Controls

  property is set correctly
• Ensure theme name spelling is exact (case-sensitive)

• Confirm custom theme assembly is referenced in project
• Verify

  LoadAssembly()

  is called before theme application
• Check that theme name matches assembly name exactly

• Verify using Theme Studio-based themes (Office2019Colorful, HighContrastBlack)
• Check

  CanOverrideStyle

  is set to

  false

  if you want to preserve customizations
• Use

  ThemeStyle

  for non-Sf controls,

  Style

  for Sf-prefixed controls