BaseListBoxControl.HighlightedItemStyle Property
Gets or sets the paint mode for the selected and hot-tracked items.
Namespace: DevExpress.XtraEditors
Assembly: DevExpress.XtraEditors.v24.1.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
[DefaultValue(HighlightStyle.Default)]
[DXCategory("Appearance")]
public virtual HighlightStyle HighlightedItemStyle { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| HighlightStyle | Default | A HighlightStyle value that specifies the paint mode for the selected and hot-tracked items. |
Available values:
| Name | Description |
|---|---|
| Default | The same as the Skinned option. |
| Standard | Selected and hot-tracked items are not skinned and painted using the default system color. In a BaseListBoxControl control’s descendants, if item hot-tracking is enabled, selected and hot-tracked items are always in sync, and setting the BaseListBoxControl.HotTrackSelectMode property to SelectItemOnClick is not in effect. |
| Skinned | Selected and hot-tracked items are painted skinned if a skinning painting scheme is applied. Otherwise, items are not skinned. |
Remarks
If item hot-tracking is disabled, the HighlightedItemStyle property only affects the paint mode of the selected items. The property can be set to one of the following values:
- Default/Skinned - Enables item skinning. This mode is only in effect if the List Box control is painted using a skinning paint scheme (see BaseControl.LookAndFeel).
- Standard - Items are not skinned.
If item hot-tracking is enabled with the BaseListBoxControl.HotTrackItems property, the HighlightedItemStyle property affects two aspects:
- paint mode for the selected and hot-tracked items.
- automatic selection of a hot-tracked item.
If the HighlightedItemStyle property is set to Default or Skinned, the selected and hot-tracked items are painted using dedicated skin elements from the current skin.
In this paint mode, an item can be automatically selected or not on hot-tracking, dependent on the BaseListBoxControl.HotTrackSelectMode property value.
If the HighlightedItemStyle property is set to Standard, the selected and hot-tracked items are not skinned and are always in sync. After an item has been hot-tracked, it’s automatically selected and painted using the default system color. For more information, see the BaseListBoxControl.HotTrackSelectMode property.