BaseListBoxControl.HighlightedItemStyle Property

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

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v20.1.dll

Declaration

[DXCategory("Appearance")]
[DefaultValue(HighlightStyle.Default)]
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.

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.

See Also