MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QMediaPlaylistControl Class Reference

The QMediaPlaylistControl class provides access to the playlist functionality of a QMediaService. More...

 #include <QMediaPlaylistControl>

Inherits: QMediaControl.

This class was introduced in Qt Mobility 1.0.

Public Functions

virtual ~QMediaPlaylistControl ()
virtual int currentIndex () const = 0
virtual void next () = 0
virtual int nextIndex ( int step ) const = 0
virtual QMediaPlaylist::PlaybackMode playbackMode () const = 0
virtual QMediaPlaylistProvider * playlistProvider () const = 0
virtual void previous () = 0
virtual int previousIndex ( int step ) const = 0
virtual void setCurrentIndex ( int position ) = 0
virtual void setPlaybackMode ( QMediaPlaylist::PlaybackMode mode ) = 0
virtual bool setPlaylistProvider ( QMediaPlaylistProvider * playlist ) = 0
  • 29 public functions inherited from QObject

Signals

void currentIndexChanged ( int position )
void currentMediaChanged ( const QMediaContent & content )
void playbackModeChanged ( QMediaPlaylist::PlaybackMode mode )
void playlistProviderChanged ()

Protected Functions

QMediaPlaylistControl ( QObject * parent = 0 )
  • 7 protected functions inherited from QObject

Macros

QMediaPlaylistControl_iid

Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public slot inherited from QObject
  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

The QMediaPlaylistControl class provides access to the playlist functionality of a QMediaService.

If a QMediaService contains an internal playlist it will implement QMediaPlaylistControl. This control provides access to the contents of the playlist, as well as the position of the current media, and a means of navigating to the next and previous media.

The functionality provided by the control is exposed to application code through the QMediaPlaylist class.

The interface name of QMediaPlaylistControl is com.nokia.Qt.QMediaPlaylistControl/1.0 as defined in QMediaPlaylistControl_iid.

See also QMediaService::requestControl() and QMediaPlayer.

Member Function Documentation

QMediaPlaylistControl::QMediaPlaylistControl ( QObject * parent = 0 ) [protected]

Create a new playlist control object with the given parent.

QMediaPlaylistControl::~QMediaPlaylistControl () [virtual]

Destroys the playlist control.

int QMediaPlaylistControl::currentIndex () const [pure virtual]

Returns position of the current media source in the playlist.

This function was introduced in Qt Mobility 1.0.

See also setCurrentIndex().

void QMediaPlaylistControl::currentIndexChanged ( int position ) [signal]

Signal emitted when the playlist position is changed.

This function was introduced in Qt Mobility 1.0.

void QMediaPlaylistControl::currentMediaChanged ( const QMediaContent & content ) [signal]

Signal emitted when current media changes to content.

This function was introduced in Qt Mobility 1.0.

void QMediaPlaylistControl::next () [pure virtual]

Moves to the next item in playlist.

This function was introduced in Qt Mobility 1.0.

int QMediaPlaylistControl::nextIndex ( int step ) const [pure virtual]

Returns the index of item, which were current after calling next() step times.

Returned value depends on the size of playlist, current position and playback mode.

This function was introduced in Qt Mobility 1.0.

See also QMediaPlaylist::playbackMode.

QMediaPlaylist::PlaybackMode QMediaPlaylistControl::playbackMode () const [pure virtual]

Returns the playlist navigation mode.

This function was introduced in Qt Mobility 1.0.

See also setPlaybackMode() and QMediaPlaylist::PlaybackMode.

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

Signal emitted when the playback mode is changed.

This function was introduced in Qt Mobility 1.0.

QMediaPlaylistProvider * QMediaPlaylistControl::playlistProvider () const [pure virtual]

Returns the playlist used by this media player.

This function was introduced in Qt Mobility 1.0.

See also setPlaylistProvider().

void QMediaPlaylistControl::playlistProviderChanged () [signal]

Signal emitted when the playlist provider has changed.

This function was introduced in Qt Mobility 1.0.

void QMediaPlaylistControl::previous () [pure virtual]

Returns to the previous item in playlist.

This function was introduced in Qt Mobility 1.0.

int QMediaPlaylistControl::previousIndex ( int step ) const [pure virtual]

Returns the index of item, which were current after calling previous() step times.

This function was introduced in Qt Mobility 1.0.

See also QMediaPlaylist::playbackMode.

void QMediaPlaylistControl::setCurrentIndex ( int position ) [pure virtual]

Jump to the item at the given position.

This function was introduced in Qt Mobility 1.0.

See also currentIndex().

void QMediaPlaylistControl::setPlaybackMode ( QMediaPlaylist::PlaybackMode mode ) [pure virtual]

Sets the playback mode.

This function was introduced in Qt Mobility 1.0.

See also playbackMode() and QMediaPlaylist::PlaybackMode.

bool QMediaPlaylistControl::setPlaylistProvider ( QMediaPlaylistProvider * playlist ) [pure virtual]

Set the playlist of this media player to playlist.

In many cases it is possible just to use the playlist constructed by player, but sometimes replacing the whole playlist allows to avoid copyting of all the items bettween playlists.

Returns true if player can use this passed playlist; otherwise returns false.

This function was introduced in Qt Mobility 1.0.

See also playlistProvider().

Macro Documentation

QMediaPlaylistControl_iid

com.nokia.Qt.QMediaPlaylistControl/1.0

Defines the interface name of the QMediaPlaylistControl class.