Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

BaseListBoxControl.HighlightedItemStyle Property

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

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.2.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