LayoutGroup.AllowGlyphSkinning Property

Gets or sets whether the group or tab’s icon is filled with the control’s foreground color.

Namespace: DevExpress.XtraLayout

Assembly: DevExpress.XtraLayout.v21.2.dll

NuGet Packages: DevExpress.Win.Design, DevExpress.Win.Navigation

Declaration

C#

[Browsable(false)]
[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Behavior")]
[EditorBrowsable(EditorBrowsableState.Never)]
[XtraSerializableProperty]
public DefaultBoolean AllowGlyphSkinning { get; set; }

VB.NET

<Browsable(False)>
<EditorBrowsable(EditorBrowsableState.Never)>
<DefaultValue(DefaultBoolean.Default)>
<DXCategory("Behavior")>
<XtraSerializableProperty>
Public Property AllowGlyphSkinning As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	Default to use the control’s AllowGlyphSkinning option; True to fill the icon with the control’s foreground color; False to display the icon as it is.

Available values:

Name	Description
True	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

Remarks

Use the CaptionImageOptions property to access the following options, which allow you to specify the icon in the layout group or tab’s label:

• SvgImage — specifies a vector image.
• ImageUri — specifies a universal resource identifier of an image in the DX Image Gallery.

• Image — specifies a raster image.

  This property is equivalent to the layout group’s CaptionImage property.

• ImageIndex — specifies an index of an image in the Images collection.

  The ImageIndex option is equivalent to the layout item’s CaptionImageIndex property. The Images collection is equivalent to the layout group’s ImageList property, and the LayoutControl‘s Images or the LayoutView‘s Images property depending on the owner control.

• Location — specifies the alignment of the image relative to the text. This property is not in effect in a tab.

  This property is equivalent to the layout group’s CaptionImageLocation property.

• Padding — specifies the amount of space between the icon and the label’s bounds. This property overrides the tabbed group’s CaptionImagePadding property, which specifies the padding for all tabs in the tabbed group.

  This property is equivalent to the layout group’s CaptionImagePadding property.

• AllowGlyphSkinning — specifies whether the icon is filled with the control’s foreground color. This property overrides the control’s AllowGlyphSkinning option. You can also use a layout item’s AllowGlyphSkinning option to enable this feature for an individual item.

  

  Tip

  We recommend using gray-scale icons from the DX Image Gallery for best visual results.

  This property is equivalent to the layout item’s AllowGlyphSkinning property.

• Visible — specifies whether the icon is visible.

  This property is equivalent to the layout group’s DevExpress.XtraLayout.LayoutGroup.CaptionImageVisible property.