TimelineMarker TimelineMarker TimelineMarker Class

Definition

Represents metadata associated with a specific point in a media file.

public sealed class TimelineMarker : DependencyObject, ITimelineMarkerpublic sealed class TimelineMarker : DependencyObject, ITimelineMarkerPublic NotInheritable Class TimelineMarker Inherits DependencyObject Implements ITimelineMarker
Inheritance
TimelineMarkerTimelineMarkerTimelineMarker
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Inherited Members

Inherited methods

Inherited properties

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.

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);
}

Constructors

TimelineMarker() TimelineMarker() TimelineMarker()

Initializes a new instance of the TimelineMarker class.

public TimelineMarker()public TimelineMarker()Public Sub New()
Attributes

Properties

Text Text Text

Gets or sets the text value of a TimelineMarker.

public string Text { get; set; }public string Text { get; set; }Public ReadWrite Property Text As string
Value
string string string

The text value of the TimelineMarker. The default value is an empty string.

Attributes

TextProperty TextProperty TextProperty

Identifies the Text dependency property.

public static DependencyProperty TextProperty { get; }public static DependencyProperty TextProperty { get; }Public Static ReadOnly Property TextProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the Text dependency property.

Attributes

Time Time Time

Gets or sets the time at which a TimelineMarker is reached.

public TimeSpan Time { get; set; }public TimeSpan Time { get; set; }Public ReadWrite Property Time As TimeSpan
Value
TimeSpan TimeSpan TimeSpan

The time at which the TimelineMarker is reached. The default value is null.

Attributes

TimeProperty TimeProperty TimeProperty

Identifies the Time dependency property.

public static DependencyProperty TimeProperty { get; }public static DependencyProperty TimeProperty { get; }Public Static ReadOnly Property TimeProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the Time dependency property.

Attributes

Type Type Type

Gets or sets the marker type of a TimelineMarker.

public string Type { get; set; }public string Type { get; set; }Public ReadWrite Property Type As string
Value
string string string

A string that describes the type of this TimelineMarker. The default value is an empty string.

Attributes

TypeProperty TypeProperty TypeProperty

Identifies the Type dependency property.

public static DependencyProperty TypeProperty { get; }public static DependencyProperty TypeProperty { get; }Public Static ReadOnly Property TypeProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the Type dependency property.

Attributes