Controls.currentMarker

  • 项目

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

currentMarker 属性指定或检索当前标记编号。

player.controls.currentMarker

可能的值

此属性是读/写 Number (长) ，默认值为零。

注解

设置 currentMarker 会导致从指定的标记开始播放。 在尝试设置 currentMarker 之前，请使用 markerCount 确定文件是否具有标记及其包含的标记数。 如果文件没有标记，则将 currentMarker 设置为除零之外的任何内容都会导致错误。 将 currentMarker 设置为大于 markerCount 的数字也会导致错误。

currentMarker 属性始终返回当前或最后一个标记，这意味着实际文件位置可以位于当前标记处或下一个标记之前。 标记从 1 开始编号，因此，如果文件有标记，可以将 currentMarker 设置为零，以将文件位置更改为零。

直到使用 Player 设置当前媒体项 (。URL 或 Player。currentMedia) ， currentMarker 返回零。

示例

下面的 JScript 示例使用 currentMarker 从对应于 HTML SELECT 元素的 selectedIndex 属性的标记开始播放视频。 创建的 Player 对象 ID 为“Player”。

<SELECT ID = "markers"  NAME = "markers"  LANGUAGE = "JScript"

    /* Seek to the marker number that corresponds to the SELECT element
       selectedIndex value when the list selection changes. */
    onChange = "Player.controls.currentMarker = markers.selectedIndex + 1;
">

    /* Fill the SELECT element with the marker identifiers. */
    <OPTION SELECTED>Sunrise
    <OPTION>Car chase 
    <OPTION>Happy ending
</SELECT>

要求

要求 值
版本
 Windows 媒体播放器版本 7.0 或更高版本。
DLL
Wmp.dll

另请参阅

Controls 对象

Media.markerCount

Player.currentMedia

Player.URL