The requested page is not available for the requested platform. You are viewing the content for .NET Framework 4.5.2+ platform.
.NET Framework 4.5.2+
.NET Framework 4.5.2+
.NET Standard 2.0+
The page you are viewing does not exist in the .NET Standard 2.0+ platform documentation. This link will take you to the parent topic of the current section.
.NET Core 3.0+

WinApplication.UseLightStyle Property

Enables the Light Style in a WinForms application.

Namespace: DevExpress.ExpressApp.Win

Assembly: DevExpress.ExpressApp.Win.v19.2.dll

Declaration

[Browsable(false)]
public bool UseLightStyle { get; set; }
<Browsable(False)>
Public Property UseLightStyle As Boolean
[Browsable(false)]
public bool UseLightStyle { get; set; }
<Browsable(False)>
Public Property UseLightStyle As Boolean

Property Value

Type Description
Boolean

true, if the Light Style is enabled for a WinForms application; otherwise, false.

Property Value

Type Description
Boolean

true, if the Light Style is enabled for a WinForms application; otherwise, false.

Remarks

The UseLightStyle property is bound to DockingViewStyle.

UseLightStyle value WindowsFormsSettings.DockingViewStyle value
true DockingViewStyle.Light
false DockingViewStyle.Default

The Solution Wizard enables the Light Style for all new XAF WinForms applications.

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:

UseLightStyle_ListView

The UseLightStyle property affects which built-in Controller XAF uses: the ChooseSkinController or the ConfigureSkinController.

UseLightStyle value Built-in Controller
true ConfigureSkinController
false ChooseSkinController

The ConfigureSkinController provides new WinForms skin and palette runtime skin selectors for Bar UI and Ribbon UI.

WinForms UI Skin selector Palette selector
Bar UI SkinDropDownButtonItem BarButtonItem with a Dropdown Gallery
Ribbon UI SkinDropDownButtonItem SkinPaletteRibbonGalleryBarItem

Bar UI

WinForms-BarUI-LightStyle-SkinPaletteSelector

Ribbon UI

WinForms-RibbonUI-SkinPaletteSelector

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.

See Also