MediaCollection.getAttributeStringCollection 方法
[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer,而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼,以使用新的 API。]
getAttributeStringCollection方法會擷取StringCollection物件,代表指定媒體類型內指定屬性的所有值集合。
語法
retVal = MediaCollection.getAttributeStringCollection(
attribute,
mediaType
)
參數
-
屬性 [in]
-
指定屬性的字串。
-
mediaType [in]
-
表示媒體類型的字串。 包含下列其中一個值:「Audio」、「Video」、「Playlist」 或 「Other」。
傳回值
這個方法會傳回 StringCollection 物件。
備註
若要使用此方法,需要程式庫的讀取權限。 如需詳細資訊,請參閱 程式庫存取。
如需Windows 媒體播放機所支援之屬性的相關資訊,請參閱屬性參考一節。
範例
下列 JScript 範例使用 MediaCollection。getAttributeStringCollection 可顯示對應至媒體集合中音訊專案之特定屬性的值清單。 以 ID = 「Attribute」 建立的 HTML SELECT 元素,可讓使用者選取屬性,例如「作者」、「內容類型」或「相簿」。 以 ID = 「AttributeVals」 建立的 HTML TEXTAREA 元素會顯示結果。 Player物件是以 ID = 「Player」 建立。
// Clear the text in the display area.
AttributeVals.value = "";
// Store the mediaCollection object.
var library = Player.mediaCollection;
// Get the string collection for the attribute type the user selects.
var all = library.getAttributeStringCollection(Attribute.value, "Audio");
// Loop through the string collection.
for (i = 0; i < all.count; i++){
// Display the items one line at a time.
AttributeVals.value += all.item(i);
AttributeVals.value += "\n";
}
規格需求
需求 | 值 |
---|---|
版本 |
Windows 媒體播放機 7.0 版或更新版本。 |
DLL |
|
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應