BaseListBoxControl.HighlightedItemStyle Property

Gets or sets the paint mode for the selected and hot-tracked items.

Assembly : DevExpress.XtraEditors.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

C#
VB.NET

csharp

[DefaultValue(HighlightStyle.Default)]
[DXCategory("Appearance")]
public virtual HighlightStyle HighlightedItemStyle { get; set; }

<DXCategory("Appearance")>
<DefaultValue(HighlightStyle.Default)>
Public Overridable Property HighlightedItemStyle As HighlightStyle

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.