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.
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.
See also setCurrentIndex().
void QMediaPlaylistControl::currentIndexChanged ( int position ) [signal]
Signal emitted when the playlist position is changed.
void QMediaPlaylistControl::currentMediaChanged ( const QMediaContent & content ) [signal]
Signal emitted when current media changes to content.
void QMediaPlaylistControl::next () [pure virtual]
Moves to the next item in playlist.
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.
See also QMediaPlaylist::playbackMode.
QMediaPlaylist::PlaybackMode QMediaPlaylistControl::playbackMode () const [pure virtual]
Returns the playlist navigation mode.
See also setPlaybackMode() and QMediaPlaylist::PlaybackMode.
void QMediaPlaylistControl::playbackModeChanged ( QMediaPlaylist::PlaybackMode mode ) [signal]
Signal emitted when the playback mode is changed.
QMediaPlaylistProvider * QMediaPlaylistControl::playlistProvider () const [pure virtual]
Returns the playlist used by this media player.
See also setPlaylistProvider().
void QMediaPlaylistControl::playlistProviderChanged () [signal]
Signal emitted when the playlist provider has changed.
void QMediaPlaylistControl::previous () [pure virtual]
Returns to the previous item in playlist.
int QMediaPlaylistControl::previousIndex ( int step ) const [pure virtual]
Returns the index of item, which were current after calling previous() step times.
See also QMediaPlaylist::playbackMode.
void QMediaPlaylistControl::setCurrentIndex ( int position ) [pure virtual]
Jump to the item at the given position.
See also currentIndex().
void QMediaPlaylistControl::setPlaybackMode ( QMediaPlaylist::PlaybackMode mode ) [pure virtual]
Sets the playback mode.
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.
See also playlistProvider().