MediaPlaybackAudioTrackList Class

Reference

Definition

Namespace:: Windows.Media.Playback

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Represents a read-only list of AudioTrack objects, of which a single track can be selected at one time.

public ref class MediaPlaybackAudioTrackList sealed : IIterable<AudioTrack ^>, IVectorView<AudioTrack ^>, ISingleSelectMediaTrackList

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MediaPlaybackAudioTrackList final : IIterable<AudioTrack>, IVectorView<AudioTrack>, ISingleSelectMediaTrackList

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MediaPlaybackAudioTrackList : IEnumerable<AudioTrack>, IReadOnlyList<AudioTrack>, ISingleSelectMediaTrackList

Public NotInheritable Class MediaPlaybackAudioTrackList
Implements IEnumerable(Of AudioTrack), IReadOnlyList(Of AudioTrack), ISingleSelectMediaTrackList

Inheritance: Object Platform::Object IInspectable MediaPlaybackAudioTrackList

Attributes: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implements: IIterable<T> IEnumerable<T> IIterable<AudioTrack> IEnumerable<AudioTrack> IVectorView<AudioTrack> IReadOnlyList<AudioTrack> ISingleSelectMediaTrackList

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

Get an instance of this class by accessing the AudioTracks property of a MediaPlaybackItem. To be notified when the list of tracks changes, handle the AudioTracksChanged event.

This class provides access to the list of AudioTrack objects that are associated with a MediaPlaybackItem. When the media item is opened by a component and the ItemOpened event is raised, you can select one of the audio tracks in the track list for playback.

Note that this class does not represent a playlist of audio tracks that are played sequentially. To play a sequential list of tracks, use MediaPlaybackList.

For how-to guidance for working with the audio tracks of a media item, see Media items, playlists, and tracks.

Properties

SelectedIndex	Gets or sets the index of the currently selected audio track in the list.
Size	Gets the number of audio tracks in the list.

Methods

First()	Returns an iterator that iterates over the items in the collection.
GetAt(UInt32)	Returns the audio track at the specified index.
GetMany(UInt32, AudioTrack[])	Retrieves the audio tracks that start at the specified index in the list.
IndexOf(AudioTrack, UInt32)	Retrieves the index of a specified audio track in the list.

Events

SelectedIndexChanged

Occurs when the index of the currently selected audio track changes.

Applies to