ListBox 控制項概觀 (Windows Form)

Windows Forms ListBox 控制項會顯示使用者可以從中選取一或多個項目的清單。 如果項目總數超過可顯示的數量，則捲軸會自動新增至 ListBox 控制項。 將 MultiColumn 屬性設定為 true 時，清單方塊會顯示多個資料行中的項目，並會出現水平捲軸。 將 MultiColumn 屬性設定為 false 時，清單方塊會顯示單一資料行中的項目，而垂直捲軸隨即出現。 將 ScrollAlwaysVisible 設定為 true 時，不論項目數量為何，捲軸都會顯示。 SelectionMode 屬性會決定一次可以選取多少個清單項目。

變更 ListBox 控制項的方式

SelectedIndex 屬性會傳回對應於清單方塊中第一個選取項目的整數值。 您可以變更程式碼中的 SelectedIndex 值，以程式設計方式變更選取的項目；清單中的對應項目會以醒目提示的方式出現在 Windows Form。 如果未選取任何項目，則 SelectedIndex 值為 -1。 如果選取清單中的第一個項目，則 SelectedIndex 值為 0。 選取多個項目時，SelectedIndex 值會反映清單中第一個出現的選取項目。 SelectedItem 屬性類似於 SelectedIndex，但會傳回項目本身 (通常是字串值)。 Count 屬性會反映清單中的項目數，而 Count 屬性的值一律大於最大的 SelectedIndex 值，因為 SelectedIndex 是以零為起始。

若要在 ListBox 控制項中新增或刪除項目，請使用 Add、Insert、Clear 或 Remove 方法。 或者，您可以使用設計階段中的 Items 屬性，將項目新增至清單。

另請參閱

• ListBox
• 操作說明：從 Windows Forms 的 ComboBox、ListBox 或 CheckedListBox 控制項加入或移除項目
• 操作說明：排序 Windows Forms 中 ComboBox、ListBox 或 CheckedListBox 控制項的內容
• 操作說明：將 Windows Forms ComboBox 或 ListBox 控制項繫結至資料
• ComboBox 控制項概觀
• CheckedListBox 控制項概觀
• 用來列出選項的 Windows Forms 控制項
• 操作說明：為 Windows Forms 的 ComboBox、ListBox 或 CheckedListBox 控制項建立查閱資料表