WinApplication.UseLightStyle Property
Enables the Light Style in a WinForms application.
Namespace: DevExpress.ExpressApp.Win
Assembly: DevExpress.ExpressApp.Win.v24.1.dll
NuGet Packages: DevExpress.ExpressApp.Win, DevExpress.ExpressApp.Win.Design
#Declaration
#Property Value
Type | Description |
---|---|
Boolean | true, if the Light Style is enabled for a Win |
#Remarks
The UseLightStyle property is bound to DockingViewStyle.
Use |
Windows |
---|---|
true | Docking |
false | Docking |
The Solution Wizard enables the Light Style for all new XAF WinForms applications. For this purpose, the wizard generates new projects with the FrameworkSettings.DefaultSettingsCompatibilityMode property set to Latest
.
The Light Style uses the following templates:
- LightStyleMainForm - in applications with the Standard UI;
- LightStyleMainRibbonForm - in applications with the Ribbon UI.
The image below demonstrates the difference between a Layout with enabled and disabled Light Style:
The UseLightStyle property affects which built-in Controller XAF uses: the ChooseSkinController or the ConfigureSkinController.
Use |
Built-in Controller |
---|---|
true | Configure |
false | Choose |
The ConfigureSkinController provides new WinForms skin and palette runtime skin selectors for Bar UI and Ribbon UI.
Win |
Skin selector | Palette selector |
---|---|---|
Bar UI | Skin |
Bar |
Ribbon UI | Skin |
Skin |
Bar UI
Ribbon UI
If you want to enable the Light Style for an existing application, refer to the How to migrate a WinForms application to use the Light Style KB article.