PLAYLIST 元素

  • 發行項

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

PLAYLIST元素提供一種方式來組織清單中的媒體專案，以便使用下列屬性和方法輕鬆操作。 也提供預先定義的 PLAYLIST 元素，方便使用。 您可以為播放清單指定自訂資料行，方法是將 COLUMN 元素納入為 PLAYLIST 元素的子系。

PLAYLIST元素支援下列屬性。

屬性 描述
allowColumnSorting 指定或擷取值，指出是否允許排序資料行標頭。
allowItemEditing 指定或擷取值，指出播放清單中的專案是否支援就地編輯。
backgroundColor 指定或擷取背景色彩。
backgroundImage 指定或擷取背景影像。
核取方塊可見 指定或擷取值，指出核取方塊是否可見。
columnCount 擷取顯示的資料行數目。
columnOrder 指定或擷取播放清單資料行的順序。
columns 定義 在 PLAYLIST 元素中顯示的資料行。
columnsVisible 指定或擷取值，指出是否顯示資料行。
複製 擷取值，指出 PLAYLIST 元素是否在複製動作中。
disabledItemColor 指定或擷取停用的 CD 追蹤或離線時的線上內容色彩。
dropDownBackgroundImage 指定或擷取顯示在下拉式清單中背景的影像名稱。
dropDownImage 指定或擷取下拉式清單按鈕所使用的影像名稱，該影像會顯示在下拉式清單的右邊緣。
dropDownList 指定或擷取值，指出特定 PLAYLIST 元素實例的下拉式清單中顯示哪些元素。
dropDownToolTip 指定或擷取當使用者將滑鼠停留在 PLAYLIST 元素下拉式功能表上時所顯示的 ToolTip。
dropDownVisible 指定或擷取值，指出 PLAYLIST 元素下拉式選取器是否可見。
editButtonVisible 指定或擷取值，指出 PLAYLIST 元素編輯按鈕是否可見。
foregroundColor 指定或擷取前景色彩。
hueShift 指定或擷取下拉式影像的色調移位量。
itemCount 擷取 PLAYLIST 元素中目前顯示的專案數。
itemErrorColor 指定或擷取反白顯示色彩，指出具有錯誤條件的播放清單專案。
itemMedia 擷取與PLAYLIST元素中指定索引對應的Media物件。
itemPlayingBackgroundColor 指定或擷取目前播放播放清單專案的背景色彩。
itemPlayingColor 指定或擷取反白顯示色彩，指出播放清單中目前播放的專案。
itemPlaylist 擷取 在 PLAYLIST 元素中指定索引處顯示的媒體專案的播放清單。
itemSelectedBackgroundColor 指定或擷取值，指出播放清單中所選項目的背景色彩。
itemSelectedBackgroundFocusLostColor 指定或擷取值，指出播放清單中所選項目的文字色彩。
itemSelectedColor 指定或擷取值，指出播放清單中所選項目的文字色彩。
itemSelectedFocusLostColor 指定或擷取值，指出播放清單失去焦點時，播放清單中所選項目的文字色彩。
leftStatus 指定或擷取 在 PLAYLIST 元素左側和底部顯示的狀態文字。
播放 清單 指定或擷取 PLAYLIST 元素提供介面的 Playlist 物件。
playlistItemsVisible 指定或擷取值，指出播放清單中的專案是否可見。
rightStatus 指定或擷取 在 PLAYLIST 元素右側和底部顯示的狀態文字。
飽和 指定或擷取下拉式影像的飽和度值。
statusColor 指定或擷取 PLAYLIST 元素中狀態列的色彩。
statusTextColor 指定或擷取值，指出狀態文字的色彩。
toolbarVisible 指定或擷取值，指出播放清單工具列是否顯示。

 

PLAYLIST元素支援下列方法。

方法 描述
abortCopy 取消複製作業。
addSelectedToPlaylist 將選取的專案新增至播放清單。
copy 從 CD 開始複製作業。
deleteSelected 從播放清單中刪除選取的專案。
deleteSelectedFromLibrary 從播放清單和文件庫刪除選取的專案。
getNextCheckedItem 在指定的索引之後，擷取播放清單中下一個核取專案的索引。
getNextCheckedItem2 在指定的索引之後，擷取播放清單中下一個核取專案的索引。 適用于巢狀播放清單。
getNextSelectedItem 擷取指定索引之後播放清單中下一個選取專案的索引。
getNextSelectedItem2 擷取指定索引之後播放清單中下一個選取專案的索引。 適用于巢狀播放清單。
moveSelectedDown 將選取的專案向下移動清單中一個位置。
moveSelectedUp 將選取的專案向上移動清單中的一個位置。
setCheckedState 指定已檢查播放清單中的索引項目目。
setCheckedState2 使用 PLAYLIST 元素中的指定索引，設定專案的核取狀態。 適用于巢狀播放清單。
setColumnResizeMode 指定索引資料行本身的大小。
setColumnWidth 指定資料行寬度，並將資料行的大小模式變更為 「wmpcrmFixed」。
setSelectedState 指定已選取播放清單中的索引項目目。
setSelectedState2 使用 PLAYLIST 專案中的指定索引，設定專案的選取狀態。 適用于巢狀播放清單。
sortColumn 排序指定資料行中的資料。

 

PLAYLIST元素支援環境屬性，而且可以實作環境事件處理常式，但另有說明。 如需詳細資訊，請參閱 環境屬性 和環境 事件處理常式。

預先定義的播放清單是預設指定各種通用屬性設定的一般 PLAYLIST 元素。 下列預先定義的播放清單可供使用。

預先定義的播放清單 描述
下拉式清單 沒有可見專案的下拉式 播放清單 。
ITEMSPLAYLIST 沒有顯示專案或資料行標頭的下拉式 播放清單 。

 

面板程式設計參考