Media.isReadOnlyItem 方法
[与此页面关联的功能(Windows 媒体播放器 SDK)是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能,Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
isReadOnlyItem 方法返回一个值,该值指示是否可以编辑媒体项的指定属性。
语法
bRetVal = Media.isReadOnlyItem(
attribute
)
参数
-
attribute [in]
-
指示要测试的属性的名称的字符串。 有关 Windows 媒体播放器 支持的属性的信息,请参阅Windows 媒体播放器属性参考。
返回值
此方法返回 布尔值。
备注
如果属性是只读的,则不能使用 setItemInfo 方法对其进行设置。 请注意,当与不同版本的 Windows 媒体播放器 一起使用时,此方法可能会为特定属性返回不同的值。
若要使用此方法,需要对库的读取访问权限。 有关详细信息,请参阅 库访问。
Windows 媒体播放器 10 Mobile:此属性始终返回 true。
示例
以下 JScript 示例使用 媒体。isReadOnlyItem 以使用有关当前媒体项的信息填充名为 rwText 的 HTML TEXTAREA 元素。 代码输出当前媒体项的每个属性,以及指示该属性是只读还是读/写的文本。 创建的 Player 对象 ID 为“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 媒体播放器版本 7.0 或更高版本。 |
DLL |
|
另请参阅
反馈
提交和查看相关反馈