Skip to main content

TdxSkinController.UseImageSet Property

Specifies the paint mode for the skinning engine.

Declaration

property UseImageSet: TdxSkinImageSet read; write; default imsDefault;

Property Value

Type Default
TdxSkinImageSet imsDefault

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 via 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)

The UseImageSet property’s default value is imsDefault.

See Also