A ListBoxItem 代表控制項中 ListBox 可選的單一項目。 當你將項目加入 ListBox 集合時，WPF 會自動將每個項目包裝在 ListBoxItem 容器中。
ListBoxItem 控制項為個別清單項目提供視覺與行為屬性，包括：
- 選擇行為 - 處理項目對使用者選擇的反應。
- 視覺狀態 - 當物品懸停、選取或聚焦時，管理外觀變化。
- 內容呈現 - 顯示該特定項目的實際資料或內容。
你可以直接設定 ListBoxItem 容器的樣式，或者在父 ListBox 上自訂 ItemContainerStyle 來調整 ListBoxItem 容器的外觀與行為。
樣式和模板
你可以修改預設值 ControlTemplate，讓 ListBoxItem 控制項呈現獨特的外觀。 欲了解更多資訊，請參閱 「樣式與範本是什麼？ 」及 「如何建立控制項範本」。
內容屬性
控制項 ListBoxItem 將該 Content 屬性作為其內容屬性。 此屬性決定每個清單項目中顯示的內容，並支援多種內容類型，包括文字、圖片及複雜的使用者介面元素。
組件
控制項 ListBoxItem 沒有定義任何命名的模板部分。
視覺狀態
下表列出 ListBoxItem 控制項的視覺狀態。
| VisualState 名稱 | VisualStateGroup 名稱 | Description |
|---|---|---|
| 正常 | CommonStates | 控制系統處於正常狀態。 |
| 滑鼠移轉 | CommonStates | 滑鼠在控制器上方。 |
| Disabled | CommonStates | 控制裝置被關閉。 |
| Focused | FocusStates | 控制鍵是鍵盤對焦。 |
| 心不在焉 | FocusStates | 這個控制器沒有鍵盤對焦功能。 |
| 已選擇 | 選擇狀態 | 控制點被選中。 |
| 選擇未聚焦 | 選擇狀態 | 控制鍵已選中，但沒有鍵盤對焦。 |
| 未選取 | 選擇狀態 | 控制項未被選擇。 |
| 焦點無效 | 驗證狀態 | 控制項具有驗證錯誤，且具有鍵盤焦點。 |
| 無效未聚焦 | 驗證狀態 | 這個控制器有驗證錯誤，但沒有鍵盤焦點。 |
| 有效 | 驗證狀態 | 控制項有效且無驗證錯誤。 |
