Home · All Classes · All Functions ·

QMediaPlaylistNavigator Class Reference

The QMediaPlaylistNavigator class provides navigation for a media playlist. More...

    #include <QMediaPlaylistNavigator>

This class is under development and is subject to change.

Inherits QObject.


Properties


Public Functions

QMediaPlaylistNavigator ( QMediaPlaylistProvider * playlist, QObject * parent = 0 )
virtual ~QMediaPlaylistNavigator ()
QMediaContent currentItem () const
int currentPosition () const
QMediaContent itemAt ( int position ) const
QMediaContent nextItem ( int steps = 1 ) const
int nextPosition ( int steps = 1 ) const
QMediaPlaylist::PlaybackMode playbackMode () const
QMediaPlaylistProvider * playlist () const
QMediaContent previousItem ( int steps = 1 ) const
int previousPosition ( int steps = 1 ) const
void setPlaylist ( QMediaPlaylistProvider * playlist )

Public Slots

void jump ( int position )
void next ()
void previous ()
void setPlaybackMode ( QMediaPlaylist::PlaybackMode mode )

Signals

void activated ( const QMediaContent & media )
void currentPositionChanged ( int position )
void playbackModeChanged ( QMediaPlaylist::PlaybackMode mode )
void surroundingItemsChanged ()

Additional Inherited Members


Detailed Description

The QMediaPlaylistNavigator class provides navigation for a media playlist.

See also QMediaPlaylist and QMediaPlaylistProvider.


Property Documentation

currentItem : const QMediaContent

Contains the media at the current position in the playlist.

Access functions:

QMediaContent currentItem () const

See also currentPosition().

currentPosition : int

Contains the position of the current media.

If no media is current, the property contains -1.

Access functions:

int currentPosition () const
void jump ( int position )

Notifier signal:

void currentPositionChanged ( int position )

See also nextPosition() and previousPosition().

playbackMode : QMediaPlaylist::PlaybackMode

Contains the playback mode.

Access functions:

QMediaPlaylist::PlaybackMode playbackMode () const
void setPlaybackMode ( QMediaPlaylist::PlaybackMode mode )

Notifier signal:

void playbackModeChanged ( QMediaPlaylist::PlaybackMode mode )

Member Function Documentation

QMediaPlaylistNavigator::QMediaPlaylistNavigator ( QMediaPlaylistProvider * playlist, QObject * parent = 0 )

Constructs a media playlist navigator for a playlist.

The parent is passed to QObject.

QMediaPlaylistNavigator::~QMediaPlaylistNavigator ()   [virtual]

Destroys a media playlist navigator.

void QMediaPlaylistNavigator::activated ( const QMediaContent & media )   [signal]

Signals that the current media has changed.

void QMediaPlaylistNavigator::currentPositionChanged ( int position )   [signal]

Signals the position of the current media has changed.

QMediaContent QMediaPlaylistNavigator::itemAt ( int position ) const

Returns the media at a position in the playlist.

void QMediaPlaylistNavigator::next ()   [slot]

Advances to the next item in the playlist.

See also previous(), jump(), and playbackMode().

QMediaContent QMediaPlaylistNavigator::nextItem ( int steps = 1 ) const

Returns the media that is steps positions ahead of the current position in the playlist.

See also nextPosition().

int QMediaPlaylistNavigator::nextPosition ( int steps = 1 ) const

Returns a position steps ahead of the current position accounting for the playbackMode().

If the position is beyond the end of the playlist, this value returned is -1.

See also currentPosition(), previousPosition(), and playbackMode().

void QMediaPlaylistNavigator::playbackModeChanged ( QMediaPlaylist::PlaybackMode mode )   [signal]

Signals that the playback mode has changed.

QMediaPlaylistProvider * QMediaPlaylistNavigator::playlist () const

Returns the playlist being navigated.

See also setPlaylist().

void QMediaPlaylistNavigator::previous ()   [slot]

Returns to the previous item in the playlist,

See also next(), jump(), and playbackMode().

QMediaContent QMediaPlaylistNavigator::previousItem ( int steps = 1 ) const

Returns the media that is steps positions behind the current position in the playlist.

See also previousPosition().

int QMediaPlaylistNavigator::previousPosition ( int steps = 1 ) const

Returns a position steps behind the current position accounting for the playbackMode().

If the position is prior to the beginning of the playlist this will return -1.

See also currentPosition(), nextPosition(), and playbackMode().

void QMediaPlaylistNavigator::setPlaylist ( QMediaPlaylistProvider * playlist )

Sets the playlist to navigate.

See also playlist().

void QMediaPlaylistNavigator::surroundingItemsChanged ()   [signal]

Signals that media immediately surrounding the current position has changed.


Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Mobility Project 1.0.0 (Technology Preview)