ListBoxItem

A ListBoxItem represents an individual selectable item within a ListBox control. When you add items to a ListBox collection, WPF automatically wraps each item in a ListBoxItem container.

The ListBoxItem control provides visual and behavioral properties for individual list items, including:

• Selection behavior - Handles how the item responds to user selection.
• Visual states - Manages appearance changes when the item is hovered, selected, or focused.
• Content presentation - Displays the actual data or content for that specific item.

You can customize the appearance and behavior of ListBoxItem containers by styling the ListBoxItem directly or by defining a custom ItemContainerStyle on the parent ListBox.

Styles and templates

You can modify the default ControlTemplate to give the ListBoxItem control a unique appearance. For more information, see What are styles and templates? and How to create a template for a control.

Content property

The ListBoxItem control uses the Content property as its content property. This property determines what displays within each list item and supports various content types including text, images, and complex UI elements.

Parts

The ListBoxItem control doesn't define any named template parts.

Visual states

The following table lists the visual states for the ListBoxItem control.

See also

• ListBox
• ListBoxItem
• ListBox