IWMPControls::currentMarker 属性

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

currentMarker 属性获取或设置当前标记编号。

语法

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#)