Controls.currentMarker

  • 發行項

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

currentMarker屬性會指定或擷取目前的標記編號。

player.controls.currentMarker

可能的值

此屬性是預設值為零的讀取/寫入 Number (long) 。

備註

設定 currentMarker 會導致從指定的標記開始播放。 嘗試設定 currentMarker之前，請先判斷檔案是否有標記，以及使用 markerCount有多少標記。 如果檔案沒有標記，請將 currentMarker 設定為任何標記，但零會導致錯誤。 將 currentMarker 設定為高於 markerCount 的數位也會導致錯誤。

currentMarker屬性一律會傳回目前或最後一個標記，這表示實際的檔案位置可以是目前標記或下一個標記之前。 標記的編號從 1 開始，因此如果檔案有標記，您可以將 currentMarker 設定為零，將檔案位置變更為零。

直到使用 Player (設定目前的媒體專案為止。URL 或 播放機。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