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

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 an empty string.

See Also

TdxSkinController Class

TcxCustomLookAndFeelController.SkinName Property

TcxLookAndFeel Class

TcxLookAndFeel Members

cxLookAndFeels Unit