TcxCustomLookAndFeelController.UseImageSet Property

Specifies the active image draw mode for the skinning engine.

Declaration

property UseImageSet: TdxSkinImageSet read; write; default dxDefaultSkinsUseImageSet;

Property Value

Type	Default	Description
TdxSkinImageSet	dxDefaultSkinsUseImageSet	The active image draw mode.

Remarks

Options include:

Value	Description
imsOriginal	Traditional mode. A skin element is painted with bitmap images and the element’s Image property settings.
imsAlternate	Gradient-enhanced mode. A skin element is painted with simple gradients specified through the element’s AlternateImage~ settings. With the settings, you can specify gradient colors and fill types. In the Skin Editor, the gradient attributes can be accessed, adjusted, or added via the Additional tab of the Element editor pane.
imsDefault	The skinning engine decides which paint mode to use based on the environment. On terminal systems and in low color modes, gradients will be painted provided that gradient settings are specified. Otherwise, skin bitmaps will be used instead.

Gradient alternatives to bitmaps greatly improve painting performance (almost doubling the speed of element drawing) and are especially useful on terminal systems and in low color modes. The following built-in skins have gradient settings assigned:

• Office2016 Colorful and Office 2016 Dark
• Office2013 (White, Dark Gray, and Light Gray)
• Office2010 (Black, Blue, and Silver)
• Office2007 (Black, Blue, Silver, Green, and Pink)
• DevExpressStyle and DevExpressDarkStyle
• Seven and SevenClassic
• Sharp and SharpPlus
• HighContrast
• VS2010
• Caramel

You can use these skins as is or as templates for your new high-performance skins. You can also add gradient settings to your existing skins to get the performance boost when using the gradient-enhanced paint mode.

Note that vector skins use SVG images instead of bitmaps and have predefined gradient settings regardless of the UseImageSet property value. Vector skins include:

• Basic
• TheBezier
• Office2019 (Black, Colorful, Dark Gray, and White)
• WXI and WXICompact

Default Value

The UseImageSet property’s default value is dxDefaultSkinsUseImageSet.