LISTBOX 元素

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

LISTBOX元素提供讓使用者從清單中選取專案的方式。 您可以使用 ITEM 元素做為 LISTBOX 元素的子系來指定這些專案。 如果您需要只在需要時顯示的清單方塊控制項，請使用 POPUP 元素，這與 LISTBOX 元素相同，但 popUp 屬性的預設值除外，這會指定其顯示行為。

LISTBOX元素支援下列屬性。

屬性	描述
backgroundColor	指定或擷取清單方塊控制項中的背景色彩。
邊境	指定或擷取值，指出清單方塊控制項是否有框線。 只能在設計階段設定。
firstVisibleItem	指定或擷取清單方塊控制項中第一個可見行的索引。
focusItem	指定或擷取包含焦點的行。
fontFace	指定或擷取清單方塊控制項的字型。
fontSize	指定或擷取清單方塊控制項的字型大小。
fontStyle	指定或擷取清單方塊控制項的字型樣式。
foregroundColor	指定或擷取清單方塊控制項中的文字色彩。
itemCount	擷取清單方塊控制項中的專案數。
multiSelect	指定或擷取值，指出使用者是否可以選取多行。 只能在設計階段設定。
彈出	指定值，指出專案是否代表快顯或清單方塊控制項。
readOnly	指定或擷取值，指出使用者是否可以選取文字為唯讀或文字。
selectedItem	指定或擷取清單方塊控制項中所選取專案的索引。
排序	指定或擷取值，指出清單方塊控制項是否依字母順序排序。

 

LISTBOX元素支援下列方法。

方法	描述
appendItem	在清單方塊控制項的結尾插入新的文字。
deleteAll	從清單方塊控制項刪除所有專案。
deleteItem	刪除位於指定索引處的清單方塊控制項專案。
解雇	隱藏 控制項。
findItem	從指定專案索引之後的專案開始搜尋指定的字串。
getItem	擷取具有指定索引的專案文字。
getNextSelectedItem	從具有指定索引的專案之後的專案開始，擷取清單方塊控制項中的下一個選取專案。
insertItem	在清單方塊控制項的指定索引處插入指定的文字。
replaceItem	以指定的文字取代位於指定索引處的文字。
setSelectedState	選取或取消選取具有指定索引的專案。
show	顯示 控制項。

 

注意

此元素需要 windows XP 或更新版本的Windows 媒體播放機。

 

相關主題

POPUP 元素

面板程式設計參考