MediaElement.Markers Property

Definition

Namespace:

Windows.UI.Xaml.Controls

Gets the collection of timeline markers associated with the currently loaded media file.

public:
 property TimelineMarkerCollection ^ Markers { TimelineMarkerCollection ^ get(); };

TimelineMarkerCollection Markers();

public TimelineMarkerCollection Markers { get; }

var timelineMarkerCollection = mediaElement.markers;

Public ReadOnly Property Markers As TimelineMarkerCollection

Property Value

TimelineMarkerCollection

The collection of timeline markers (represented as TimelineMarker objects) associated with the currently loaded media file. The default is an empty collection.

Examples

The following example creates a MediaElement object and responds to its MarkerReached event. Each time a timeline marker is reached, the example displays the timeline marker's Time, Type, and Text values.

<MediaElement Name="Media" Source="video.mp4" MarkerReached="Media_MarkerReached" />
<TextBlock Name="txOutput" />

private void Media_MarkerReached(object sender, TimelineMarkerRoutedEventArgs e)
{
    txOutput.Text =
        string.Format("{0},{1},{2}", e.Marker.Time, e.Marker.Text, e.Marker.Type);
}

Remarks

A timeline marker is metadata associated with a particular point in a media file. These markers are usually created ahead of time and stored in the media file itself. They are typically used to name different scenes in a video or provide scripting cues. By handling the MediaElement object's MarkerReached event or by accessing the MediaElement object's Markers property, you can use timeline markers to trigger actions or enable users to seek to selected positions in the media file.