Media.setItemInfo 方法
[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer,而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼,以使用新的 API。]
setItemInfo方法會設定目前媒體專案的指定屬性值。
語法
Media.setItemInfo(
attribute,
value
)
參數
-
屬性 [in]
-
包含屬性名稱的字串。 如需Windows 媒體播放機所支援屬性的相關資訊,請參閱Windows 媒體播放機屬性參考。
-
value [in]
-
包含新值的字串。
傳回值
這個方法不會傳回值。
備註
attributeCount屬性包含給定Media物件可用的屬性數目。 然後,索引編號可以與 getAttributeName 方法搭配使用,以判斷可與此方法搭配使用的內建屬性名稱。
使用此方法之前,請使用 isReadOnlyItem 方法來判斷是否可以設定特定屬性。
若要使用這個方法,需要程式庫的完整存取權。 如需詳細資訊,請參閱 程式庫存取。
注意
如果您在應用程式中內嵌Windows 媒體播放機控制項,除非使用者執行Windows 媒體播放機,否則您變更的檔案屬性將不會寫入數位媒體檔案。 如果您在以 C++ 撰寫的遠端應用程式中使用 控制項,則變更的檔案屬性會在進行變更之後立即寫入數位媒體檔案。 不論是哪一種情況,變更都會透過程式庫立即可供程式碼使用。
Windows 媒體播放機 10 行動裝置版:未實作此方法。
範例
下列 JScript 範例使用 Media。setItemInfo 可變更目前媒體專案的內容類型屬性值。 名為 genText 的 HTML TEXT 輸入元素可讓使用者輸入文字字串,然後用來變更屬性資訊。 Player物件是以 ID = 「Player」 建立。
<!-- Create the button element. -->
<INPUT type = "BUTTON" id = "NEWGEN" name = "NEWGEN" value = "Change Genre"
onClick = "
/* Store the current media item. */
var cm = Player.currentMedia;
/* Get the user input from the text box. */
var atValue = genText.value;
/* Test for read-only status of the attribute. */
if(cm.isReadOnlyItem('Genre') == false){
/* Change the attribute value. */
cm.setItemInfo('Genre' ,atValue);
}
">
規格需求
需求 | 值 |
---|---|
版本 |
Windows 媒體播放機 7.0 版或更新版本。 |
DLL |
|
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應