SetItemInfo 方法

SetItemInfo 方法會為目前的媒體專案設定指定之屬性的值。

語法

Media.setItemInfo(
  attribute,
  value
)

參數

屬性 [在]

包含屬性名稱的 字串。 如需 Windows Media Player 所支援之屬性的詳細資訊,請參閱 Windows Media Player屬性參考

[在]

包含新值的 字串

傳回值

這個方法不會傳回值。

備註

AttributeCount 屬性包含指定 媒體 物件可用的屬性數目。 然後,您可以搭配 getAttributeName 方法使用索引編號來判斷可搭配此方法使用的內建屬性名稱。

使用這個方法之前,請使用 isReadOnlyItem 方法來判斷是否可以設定特定屬性。

若要使用此方法,需要有程式庫的完整存取權。 如需詳細資訊,請參閱連結 庫存取

注意

如果您在應用程式中內嵌 Windows Media Player 控制項,您所變更的檔案屬性將不會寫入數位媒體檔案,直到使用者執行 Windows Media Player 為止。 如果您在以 c + + 撰寫的遠端應用程式中使用控制項,則在進行變更之後,將會立即將您變更的檔案屬性寫入數位媒體檔案。 無論是哪一種情況,您的程式碼都可以透過程式庫立即取得變更。

Windows Media Player 10 行動裝置版:這個方法不會實作為。

範例

下列 JScript 範例會使用 媒體setItemInfo ,以變更目前媒體專案的 [內容類型] 屬性值。 名為 GeNtext.c 就會的 HTML 文字輸入元素可讓使用者輸入文字字串,然後用它來變更屬性資訊。 使用 ID = "Player" 建立 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 Media Player 7.0 版或更新版本。
DLL
Wmp.dll

另請參閱

媒體物件

GetItemInfo

IsReadOnlyItem

設定. mediaAccessRights

設定. requestMediaAccessRights