IsReadOnlyItem 方法

IsReadOnlyItem 方法會傳回值,指出是否可以編輯媒體專案的指定屬性。

語法

bRetVal = Media.isReadOnlyItem(
  attribute
)

參數

屬性 [在]

表示要測試之屬性名稱的 字串。 如需 Windows Media Player 所支援之屬性的詳細資訊,請參閱 Windows Media Player 屬性參考

傳回值

這個方法會傳回 布林值

備註

如果屬性是唯讀的,則無法使用 setItemInfo 方法來設定它。 請注意,使用不同版本的 Windows Media Player 時,這個方法可能會針對特定屬性傳回不同的值。

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

Windows Media Player 10 行動裝置版:這個屬性一律會傳回 true

範例

下列 JScript 範例會使用 媒體isReadOnlyItem ,以目前媒體專案的相關資訊填入名為 RWTEXT 的 HTML TEXTAREA 元素。 程式碼會輸出目前媒體專案的每個屬性,以及指出屬性為唯讀還是讀取/寫入的文字。 使用 ID = "Player" 建立 player 物件。

// Store the current media item object.
var cm = Player.currentMedia;

// Create a variable to hold each attribute name.
var atName;

// Loop through the attribute list.
for(var i = 0; i < cm.attributeCount; i++){

   // Get the attribute name.
   atName = cm.getAttributeName(i);

   // Test whether the attribute is read-only.
   var test = ((cm.isReadOnlyItem(atName))?"Read-Only":"Read/Write");

// Print the attribute information to the text area.
   rwText.value += atName + " is " + test;
   rwText.value += "\n";
}

規格需求

需求
版本
Windows Media Player 7.0 版或更新版本。
DLL
Wmp.dll

另請參閱

媒體物件

SetItemInfo

設定. mediaAccessRights

設定. requestMediaAccessRights