TcxLookAndFeel.SkinName Property

Specifies the name of the active skin at the level of an individual control.

Declaration

property SkinName: TdxSkinName read; write;

Property Value

Type	Description
TdxSkinName	The active skin’s name.

Remarks

You can use the SkinName property to apply a built-in or custom skin to an individual DevExpress control if the NativeStyle property is set to False.

Tip

We recommend that you use a skin controller component’s SkinName property to enable or disable the native style at the global level to ensure consistent appearance of all DevExpress controls in an application.

To apply a built-in skin to the control, assign the corresponding skin name to the SkinName property.

Custom Skin

To use a custom skin, do the following:

• Launch the Skin Editor to create a new skin.
• Call the dxSkinsUserSkinLoadFromFile, dxSkinsUserSkinLoadFromFileByIndex, dxSkinsUserSkinLoadFromFile, or dxSkinsUserSkinLoadFromStreamByIndex global function to load a skin from a SKINRES file or stream.
• Assign the 'UserSkin' string to the SkinName property at runtime.

Limitations

You can load and apply custom skins only at runtime. At design time, you can apply only built-in skins.

Property Setter Behavior

The SkinName property setter adds the lfvSkinName flag to the AssignedValues property once the change is applied to the control outside a BeginUpdate/EndUpdate block or after an EndUpdate procedure call.

Default Value

The SkinName property’s default value is the cxDefaultLookAndFeelSkinName global constant.