IWMPControls：：currentMarker 屬性

  • 發行項

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

currentMarker屬性會取得或設定目前的標記編號。

Syntax

public System.Int32 currentMarker {get; set;}


Public Property currentMarker As System.Int32

屬性值

System.Int32，這是標記編號。

備註

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

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

在使用 AxWindowsMediaPlayer.URL 或 AxWindowsMediaPlayer.currentMedia) 設定目前媒體 (專案之前， currentMarker 會傳回零。

範例

下列範例會使用 currentMarker 從對應至已填入標記識別項的清單方塊 SelectedIndex 屬性的標記開始視訊播放。 AxWMPLib.AxWindowsMediaPlayer物件是由名為 player 的變數表示。

// Fill the list box with the marker identifiers of the current media item.
markers.Items.Add("Begining");
markers.Items.Add("Sunrise");
markers.Items.Add("Car chase");
markers.Items.Add("Happy ending");

// Set the currentMarker to the marker selected from the list box.
private void markers_OnSelectedIndexChanged(object sender, System.EventArgs e)
{
    int selectedMarker = ((System.Windows.Forms.ListBox)sender).SelectedIndex;

    player.Ctlcontrols.currentMarker = selectedMarker;
}


' Fill the list box with the marker identifiers of the current media item.
markers.Items.Add("Begining")
markers.Items.Add("Sunrise")
markers.Items.Add("Car chase")
markers.Items.Add("Happy ending")

' Set the currentMarker to the marker selected from the list box.
Public Sub markers_SelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles markers.SelectedIndexChanged

    Dim lb As System.Windows.Forms.ListBox = sender
    Dim selectedMarker As Integer = lb.SelectedIndex

    player.Ctlcontrols.currentMarker = selectedMarker

End Sub

規格需求

需求 值
版本
 Windows 媒體播放機 9 系列或更新版本
命名空間
 WMPLib
組件
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

另請參閱

AxWindowsMediaPlayer.currentMedia (VB 和 C#)

AxWindowsMediaPlayer.URL (VB 和 C#)

IWMPControls 介面 (VB 和 C#)

IWMPMedia.markerCount (VB 和 C#)