Skip to main content

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.

See Also