Sophie

Sophie

distrib > Mageia > 5 > i586 > media > core-release > by-pkgid > 50facae208d4a6f280e44a513b104320 > files > 1056

qt-mobility-doc-1.2.0-13.mga5.noarch.rpm

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qmediaplaylist.cpp -->
  <title>Qt Mobility 1.2: QMediaPlaylist Class Reference</title>
  <link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
  <div class="content"> 
    <a href="index.html" class="qtref"><span>QtMobility Reference Documentation</span></a>
  </div>
  <div class="breadcrumb toolblock">
    <ul>
      <li class="first"><a href="index.html">Home</a></li>
      <!--  Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li><a href="qtmultimediakit.html">QtMultimediaKit</a></li>
<li>QMediaPlaylist</li>
    </ul>
  </div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-types">Public Types</a></li>
<li class="level1"><a href="#properties">Properties</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#public-slots">Public Slots</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QMediaPlaylist Class Reference</h1>
<!-- $$$QMediaPlaylist-brief -->
<p>The QMediaPlaylist class provides a list of media content to play. <a href="#details">More...</a></p>
<!-- @@@QMediaPlaylist -->
<pre class="cpp"> <span class="preprocessor">#include &lt;QMediaPlaylist&gt;</span></pre><p><b>Inherits: </b><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a> and <a href="qmediabindableinterface.html">QMediaBindableInterface</a>.</p>
<p>This class was introduced in Qt Mobility 1.0.</p>
<ul>
<li><a href="qmediaplaylist-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2>Public Types</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#Error-enum">Error</a></b> { NoError, FormatError, FormatNotSupportedError, NetworkError, AccessDeniedError }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#PlaybackMode-enum">PlaybackMode</a></b> { CurrentItemOnce, CurrentItemInLoop, Sequential, Loop, Random }</td></tr>
</table>
<a name="properties"></a>
<h2>Properties</h2>
<ul>
<li class="fn"><b><a href="qmediaplaylist.html#currentIndex-prop">currentIndex</a></b> : int</li>
<li class="fn"><b><a href="qmediaplaylist.html#currentMedia-prop">currentMedia</a></b> : const QMediaContent</li>
<li class="fn"><b><a href="qmediaplaylist.html#playbackMode-prop">playbackMode</a></b> : QMediaPlaylist::PlaybackMode</li>
</ul>
<ul>
<li class="fn">1 property inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#properties">QObject</a></li>
</ul>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#QMediaPlaylist">QMediaPlaylist</a></b> ( QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#dtor.QMediaPlaylist">~QMediaPlaylist</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#addMedia">addMedia</a></b> ( const QMediaContent &amp; <i>content</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#addMedia-2">addMedia</a></b> ( const QList&lt;QMediaContent&gt; &amp; <i>items</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#clear">clear</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#currentIndex-prop">currentIndex</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMediaContent </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#currentMedia-prop">currentMedia</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Error </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#error">error</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#errorString">errorString</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#insertMedia">insertMedia</a></b> ( int <i>pos</i>, const QMediaContent &amp; <i>content</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#insertMedia-2">insertMedia</a></b> ( int <i>pos</i>, const QList&lt;QMediaContent&gt; &amp; <i>items</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#isEmpty">isEmpty</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#isReadOnly">isReadOnly</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#load">load</a></b> ( const QUrl &amp; <i>location</i>, const char * <i>format</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#load-2">load</a></b> ( QIODevice * <i>device</i>, const char * <i>format</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMediaContent </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#media">media</a></b> ( int <i>index</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#mediaCount">mediaCount</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#nextIndex">nextIndex</a></b> ( int <i>steps</i> = 1 ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> PlaybackMode </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#playbackMode-prop">playbackMode</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#previousIndex">previousIndex</a></b> ( int <i>steps</i> = 1 ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#removeMedia">removeMedia</a></b> ( int <i>pos</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#removeMedia-2">removeMedia</a></b> ( int <i>start</i>, int <i>end</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#save">save</a></b> ( const QUrl &amp; <i>location</i>, const char * <i>format</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#save-2">save</a></b> ( QIODevice * <i>device</i>, const char * <i>format</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#playbackMode-prop">setPlaybackMode</a></b> ( PlaybackMode <i>mode</i> )</td></tr>
</table>
<a name="reimplemented-public-functions"></a>
<h2>Reimplemented Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual QMediaObject * </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#mediaObject">mediaObject</a></b> () const</td></tr>
</table>
<ul>
<li class="fn">29 public functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-functions">QObject</a></li>
<li class="fn">1 public function inherited from <a href="qmediabindableinterface.html#public-functions">QMediaBindableInterface</a></li>
</ul>
<a name="public-slots"></a>
<h2>Public Slots</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#next">next</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#previous">previous</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#currentIndex-prop">setCurrentIndex</a></b> ( int <i>playlistPosition</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#shuffle">shuffle</a></b> ()</td></tr>
</table>
<ul>
<li class="fn">1 public slot inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-slots">QObject</a></li>
</ul>
<a name="signals"></a>
<h2>Signals</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#currentIndexChanged">currentIndexChanged</a></b> ( int <i>position</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#currentMediaChanged">currentMediaChanged</a></b> ( const QMediaContent &amp; <i>content</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#loadFailed">loadFailed</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#loaded">loaded</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#mediaAboutToBeInserted">mediaAboutToBeInserted</a></b> ( int <i>start</i>, int <i>end</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#mediaAboutToBeRemoved">mediaAboutToBeRemoved</a></b> ( int <i>start</i>, int <i>end</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#mediaChanged">mediaChanged</a></b> ( int <i>start</i>, int <i>end</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#mediaInserted">mediaInserted</a></b> ( int <i>start</i>, int <i>end</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#mediaRemoved">mediaRemoved</a></b> ( int <i>start</i>, int <i>end</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplaylist.html#playbackModeChanged">playbackModeChanged</a></b> ( QMediaPlaylist::PlaybackMode <i>mode</i> )</td></tr>
</table>
<ul>
<li class="fn">1 signal inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#signals">QObject</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">1 public variable inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-variables">QObject</a></li>
<li class="fn">4 static public members inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#static-public-members">QObject</a></li>
<li class="fn">7 protected functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-functions">QObject</a></li>
<li class="fn">1 protected function inherited from <a href="qmediabindableinterface.html#protected-functions">QMediaBindableInterface</a></li>
<li class="fn">2 protected variables inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-variables">QObject</a></li>
</ul>
<a name="details"></a>
<!-- $$$QMediaPlaylist-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QMediaPlaylist class provides a list of media content to play.</p>
<p>QMediaPlaylist is intended to be used with other media objects, like <a href="qmediaplayer.html">QMediaPlayer</a> or <a href="qmediaimageviewer.html">QMediaImageViewer</a>.</p>
<p>QMediaPlaylist allows to access the service intrinsic playlist functionality if available, otherwise it provides the the local memory playlist implementation.</p>
<pre class="cpp"> playlist <span class="operator">=</span> <span class="keyword">new</span> <span class="type">QMediaPlaylist</span>;
 playlist<span class="operator">-</span><span class="operator">&gt;</span>addMedia(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qurl.html">QUrl</a></span>(<span class="string">&quot;http://example.com/movie1.mp4&quot;</span>));
 playlist<span class="operator">-</span><span class="operator">&gt;</span>addMedia(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qurl.html">QUrl</a></span>(<span class="string">&quot;http://example.com/movie2.mp4&quot;</span>));
 playlist<span class="operator">-</span><span class="operator">&gt;</span>addMedia(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qurl.html">QUrl</a></span>(<span class="string">&quot;http://example.com/movie3.mp4&quot;</span>));
 playlist<span class="operator">-</span><span class="operator">&gt;</span>setCurrentIndex(<span class="number">1</span>);

 player <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qmediaplayer.html">QMediaPlayer</a></span>;
 player<span class="operator">-</span><span class="operator">&gt;</span>setPlaylist(playlist);

 videoWidget <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qvideowidget.html">QVideoWidget</a></span>;
 player<span class="operator">-</span><span class="operator">&gt;</span>setVideoOutput(videoWidget);
 videoWidget<span class="operator">-</span><span class="operator">&gt;</span>show();

 player<span class="operator">-</span><span class="operator">&gt;</span>play();</pre>
<p>Depending on playlist source implementation, most of the playlist mutating operations can be asynchronous.</p>
</div>
<p><b>See also </b><a href="qmediacontent.html">QMediaContent</a>.</p>
<!-- @@@QMediaPlaylist -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$Error$$$NoError$$$FormatError$$$FormatNotSupportedError$$$NetworkError$$$AccessDeniedError -->
<h3 class="fn"><a name="Error-enum"></a>enum QMediaPlaylist::<span class="name">Error</span></h3>
<p>This enum describes the <a href="qmediaplaylist.html">QMediaPlaylist</a> error codes.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QMediaPlaylist::NoError</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">No errors.</td></tr>
<tr><td class="topAlign"><tt>QMediaPlaylist::FormatError</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">Format error.</td></tr>
<tr><td class="topAlign"><tt>QMediaPlaylist::FormatNotSupportedError</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">Format not supported.</td></tr>
<tr><td class="topAlign"><tt>QMediaPlaylist::NetworkError</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">Network error.</td></tr>
<tr><td class="topAlign"><tt>QMediaPlaylist::AccessDeniedError</tt></td><td class="topAlign"><tt>4</tt></td><td class="topAlign">Access denied error.</td></tr>
</table>
<!-- @@@Error -->
<!-- $$$PlaybackMode$$$CurrentItemOnce$$$CurrentItemInLoop$$$Sequential$$$Loop$$$Random -->
<h3 class="fn"><a name="PlaybackMode-enum"></a>enum QMediaPlaylist::<span class="name">PlaybackMode</span></h3>
<p>The QMediaPlaylist::PlaybackMode describes the order items in playlist are played.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QMediaPlaylist::CurrentItemOnce</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The current item is played only once.</td></tr>
<tr><td class="topAlign"><tt>QMediaPlaylist::CurrentItemInLoop</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The current item is played repeatedly in a loop.</td></tr>
<tr><td class="topAlign"><tt>QMediaPlaylist::Sequential</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">Playback starts from the current and moves through each successive item until the last is reached and then stops. The next item is a null item when the last one is currently playing.</td></tr>
<tr><td class="topAlign"><tt>QMediaPlaylist::Loop</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">Playback restarts at the first item after the last has finished playing.</td></tr>
<tr><td class="topAlign"><tt>QMediaPlaylist::Random</tt></td><td class="topAlign"><tt>4</tt></td><td class="topAlign">Play items in random order.</td></tr>
</table>
<!-- @@@PlaybackMode -->
</div>
<div class="prop">
<h2>Property Documentation</h2>
<!-- $$$currentIndex-prop$$$currentIndex$$$setCurrentIndexint$$$currentIndexChangedint -->
<h3 class="fn"><a name="currentIndex-prop"></a><span class="name">currentIndex</span> : <span class="type">int</span></h3>
<p>This property holds current position.</p>
<p>This property was introduced in Qt Mobility 1.0.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> int </td><td class="memItemRight bottomAlign"><span class="name"><b>currentIndex</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setCurrentIndex</b></span> ( int <i>playlistPosition</i> )</td></tr>
</table>
<p><b>Notifier signal:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qmediaplaylist.html#currentIndexChanged">currentIndexChanged</a></b></span> ( int <i>position</i> )</td></tr>
</table>
<!-- @@@currentIndex -->
<!-- $$$currentMedia-prop$$$currentMedia$$$currentMediaChangedconstQMediaContent& -->
<h3 class="fn"><a name="currentMedia-prop"></a><span class="name">currentMedia</span> : const <span class="type"><a href="qmediacontent.html">QMediaContent</a></span></h3>
<p>This property holds current media content.</p>
<p>This property was introduced in Qt Mobility 1.0.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QMediaContent </td><td class="memItemRight bottomAlign"><span class="name"><b>currentMedia</b></span> () const</td></tr>
</table>
<p><b>Notifier signal:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qmediaplaylist.html#currentMediaChanged">currentMediaChanged</a></b></span> ( const QMediaContent &amp; <i>content</i> )</td></tr>
</table>
<!-- @@@currentMedia -->
<!-- $$$playbackMode-prop$$$playbackMode$$$setPlaybackModePlaybackMode$$$playbackModeChangedQMediaPlaylist::PlaybackMode -->
<h3 class="fn"><a name="playbackMode-prop"></a><span class="name">playbackMode</span> : <span class="type"><a href="qmediaplaylist.html#PlaybackMode-enum">QMediaPlaylist::PlaybackMode</a></span></h3>
<p>This property defines the order, items in playlist are played.</p>
<p>This property was introduced in Qt Mobility 1.0.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> PlaybackMode </td><td class="memItemRight bottomAlign"><span class="name"><b>playbackMode</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setPlaybackMode</b></span> ( PlaybackMode <i>mode</i> )</td></tr>
</table>
<p><b>Notifier signal:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qmediaplaylist.html#playbackModeChanged">playbackModeChanged</a></b></span> ( QMediaPlaylist::PlaybackMode <i>mode</i> )</td></tr>
</table>
<p><b>See also </b><a href="qmediaplaylist.html#PlaybackMode-enum">QMediaPlaylist::PlaybackMode</a>.</p>
<!-- @@@playbackMode -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QMediaPlaylist[overload1]$$$QMediaPlaylistQObject* -->
<h3 class="fn"><a name="QMediaPlaylist"></a>QMediaPlaylist::<span class="name">QMediaPlaylist</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> = 0 )</h3>
<p>Create a new playlist object for with the given <i>parent</i>.</p>
<!-- @@@QMediaPlaylist -->
<!-- $$$~QMediaPlaylist[overload1]$$$~QMediaPlaylist -->
<h3 class="fn"><a name="dtor.QMediaPlaylist"></a>QMediaPlaylist::<span class="name">~QMediaPlaylist</span> ()<tt> [virtual]</tt></h3>
<p>Destroys the playlist.</p>
<!-- @@@~QMediaPlaylist -->
<!-- $$$addMedia[overload1]$$$addMediaconstQMediaContent& -->
<h3 class="fn"><a name="addMedia"></a><span class="type">bool</span> QMediaPlaylist::<span class="name">addMedia</span> ( const <span class="type"><a href="qmediacontent.html">QMediaContent</a></span> &amp; <i>content</i> )</h3>
<p>Append the media <i>content</i> to the playlist.</p>
<p>Returns true if the operation is successful, otherwise return false.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@addMedia -->
<!-- $$$addMedia$$$addMediaconstQList<QMediaContent>& -->
<h3 class="fn"><a name="addMedia-2"></a><span class="type">bool</span> QMediaPlaylist::<span class="name">addMedia</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qmediacontent.html">QMediaContent</a></span>&gt; &amp; <i>items</i> )</h3>
<p>Append multiple media content <i>items</i> to the playlist.</p>
<p>Returns true if the operation is successful, otherwise return false.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@addMedia -->
<!-- $$$clear[overload1]$$$clear -->
<h3 class="fn"><a name="clear"></a><span class="type">bool</span> QMediaPlaylist::<span class="name">clear</span> ()</h3>
<p>Remove all the items from the playlist.</p>
<p>Returns true if the operation is successful, otherwise return false.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@clear -->
<!-- $$$currentIndexChanged[overload1]$$$currentIndexChangedint -->
<h3 class="fn"><a name="currentIndexChanged"></a><span class="type">void</span> QMediaPlaylist::<span class="name">currentIndexChanged</span> ( <span class="type">int</span> <i>position</i> )<tt> [signal]</tt></h3>
<p>Signal emitted when playlist position changed to <i>position</i>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@currentIndexChanged -->
<!-- $$$currentMediaChanged[overload1]$$$currentMediaChangedconstQMediaContent& -->
<h3 class="fn"><a name="currentMediaChanged"></a><span class="type">void</span> QMediaPlaylist::<span class="name">currentMediaChanged</span> ( const <span class="type"><a href="qmediacontent.html">QMediaContent</a></span> &amp; <i>content</i> )<tt> [signal]</tt></h3>
<p>Signal emitted when current media changes to <i>content</i>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@currentMediaChanged -->
<!-- $$$error[overload1]$$$error -->
<h3 class="fn"><a name="error"></a><span class="type"><a href="qmediaplaylist.html#Error-enum">Error</a></span> QMediaPlaylist::<span class="name">error</span> () const</h3>
<p>Returns the last error condition.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@error -->
<!-- $$$errorString[overload1]$$$errorString -->
<h3 class="fn"><a name="errorString"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QMediaPlaylist::<span class="name">errorString</span> () const</h3>
<p>Returns the string describing the last error condition.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@errorString -->
<!-- $$$insertMedia[overload1]$$$insertMediaintconstQMediaContent& -->
<h3 class="fn"><a name="insertMedia"></a><span class="type">bool</span> QMediaPlaylist::<span class="name">insertMedia</span> ( <span class="type">int</span> <i>pos</i>, const <span class="type"><a href="qmediacontent.html">QMediaContent</a></span> &amp; <i>content</i> )</h3>
<p>Insert the media <i>content</i> to the playlist at position <i>pos</i>.</p>
<p>Returns true if the operation is successful, otherwise false.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@insertMedia -->
<!-- $$$insertMedia$$$insertMediaintconstQList<QMediaContent>& -->
<h3 class="fn"><a name="insertMedia-2"></a><span class="type">bool</span> QMediaPlaylist::<span class="name">insertMedia</span> ( <span class="type">int</span> <i>pos</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qmediacontent.html">QMediaContent</a></span>&gt; &amp; <i>items</i> )</h3>
<p>Insert multiple media content <i>items</i> to the playlist at position <i>pos</i>.</p>
<p>Returns true if the operation is successful, otherwise false.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@insertMedia -->
<!-- $$$isEmpty[overload1]$$$isEmpty -->
<h3 class="fn"><a name="isEmpty"></a><span class="type">bool</span> QMediaPlaylist::<span class="name">isEmpty</span> () const</h3>
<p>Returns true if the playlist contains no items; otherwise returns false.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplaylist.html#mediaCount">mediaCount</a>().</p>
<!-- @@@isEmpty -->
<!-- $$$isReadOnly[overload1]$$$isReadOnly -->
<h3 class="fn"><a name="isReadOnly"></a><span class="type">bool</span> QMediaPlaylist::<span class="name">isReadOnly</span> () const</h3>
<p>Returns true if the playlist can be modified; otherwise returns false.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplaylist.html#mediaCount">mediaCount</a>().</p>
<!-- @@@isReadOnly -->
<!-- $$$load[overload1]$$$loadconstQUrl&constchar* -->
<h3 class="fn"><a name="load"></a><span class="type">void</span> QMediaPlaylist::<span class="name">load</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qurl.html">QUrl</a></span> &amp; <i>location</i>, const <span class="type">char</span> * <i>format</i> = 0 )</h3>
<p>Load playlist from <i>location</i>. If <i>format</i> is specified, it is used, otherwise format is guessed from location name and data.</p>
<p>New items are appended to playlist.</p>
<p><a href="qmediaplaylist.html#loaded">QMediaPlaylist::loaded</a>() signal is emitted if playlist was loaded successfully, otherwise the playlist emits <a href="qmediaplaylist.html#loadFailed">loadFailed</a>().</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@load -->
<!-- $$$load$$$loadQIODevice*constchar* -->
<h3 class="fn"><a name="load-2"></a><span class="type">void</span> QMediaPlaylist::<span class="name">load</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qiodevice.html">QIODevice</a></span> * <i>device</i>, const <span class="type">char</span> * <i>format</i> = 0 )</h3>
<p>Load playlist from <a href="http://qt.nokia.com/doc/4.7/qiodevice.html">QIODevice</a> <i>device</i>. If <i>format</i> is specified, it is used, otherwise format is guessed from device data.</p>
<p>New items are appended to playlist.</p>
<p><a href="qmediaplaylist.html#loaded">QMediaPlaylist::loaded</a>() signal is emitted if playlist was loaded successfully, otherwise the playlist emits <a href="qmediaplaylist.html#loadFailed">loadFailed</a>().</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@load -->
<!-- $$$loadFailed[overload1]$$$loadFailed -->
<h3 class="fn"><a name="loadFailed"></a><span class="type">void</span> QMediaPlaylist::<span class="name">loadFailed</span> ()<tt> [signal]</tt></h3>
<p>Signal emitted if failed to load playlist.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@loadFailed -->
<!-- $$$loaded[overload1]$$$loaded -->
<h3 class="fn"><a name="loaded"></a><span class="type">void</span> QMediaPlaylist::<span class="name">loaded</span> ()<tt> [signal]</tt></h3>
<p>Signal emitted when playlist finished loading.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@loaded -->
<!-- $$$media[overload1]$$$mediaint -->
<h3 class="fn"><a name="media"></a><span class="type"><a href="qmediacontent.html">QMediaContent</a></span> QMediaPlaylist::<span class="name">media</span> ( <span class="type">int</span> <i>index</i> ) const</h3>
<p>Returns the media content at <i>index</i> in the playlist.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@media -->
<!-- $$$mediaAboutToBeInserted[overload1]$$$mediaAboutToBeInsertedintint -->
<h3 class="fn"><a name="mediaAboutToBeInserted"></a><span class="type">void</span> QMediaPlaylist::<span class="name">mediaAboutToBeInserted</span> ( <span class="type">int</span> <i>start</i>, <span class="type">int</span> <i>end</i> )<tt> [signal]</tt></h3>
<p>Signal emitted when items are to be inserted at <i>start</i> and ending at <i>end</i>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@mediaAboutToBeInserted -->
<!-- $$$mediaAboutToBeRemoved[overload1]$$$mediaAboutToBeRemovedintint -->
<h3 class="fn"><a name="mediaAboutToBeRemoved"></a><span class="type">void</span> QMediaPlaylist::<span class="name">mediaAboutToBeRemoved</span> ( <span class="type">int</span> <i>start</i>, <span class="type">int</span> <i>end</i> )<tt> [signal]</tt></h3>
<p>Signal emitted when item are to be deleted at <i>start</i> and ending at <i>end</i>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@mediaAboutToBeRemoved -->
<!-- $$$mediaChanged[overload1]$$$mediaChangedintint -->
<h3 class="fn"><a name="mediaChanged"></a><span class="type">void</span> QMediaPlaylist::<span class="name">mediaChanged</span> ( <span class="type">int</span> <i>start</i>, <span class="type">int</span> <i>end</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted after media has been changed in the playlist between <i>start</i> and <i>end</i> positions inclusive.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@mediaChanged -->
<!-- $$$mediaCount[overload1]$$$mediaCount -->
<h3 class="fn"><a name="mediaCount"></a><span class="type">int</span> QMediaPlaylist::<span class="name">mediaCount</span> () const</h3>
<p>Returns the number of items in the playlist.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplaylist.html#isEmpty">isEmpty</a>().</p>
<!-- @@@mediaCount -->
<!-- $$$mediaInserted[overload1]$$$mediaInsertedintint -->
<h3 class="fn"><a name="mediaInserted"></a><span class="type">void</span> QMediaPlaylist::<span class="name">mediaInserted</span> ( <span class="type">int</span> <i>start</i>, <span class="type">int</span> <i>end</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted after media has been inserted into the playlist. The new items are those between <i>start</i> and <i>end</i> inclusive.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@mediaInserted -->
<!-- $$$mediaObject[overload1]$$$mediaObject -->
<h3 class="fn"><a name="mediaObject"></a><span class="type"><a href="qmediaobject.html">QMediaObject</a></span> * QMediaPlaylist::<span class="name">mediaObject</span> () const<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="qmediabindableinterface.html#mediaObject">QMediaBindableInterface::mediaObject</a>().</p>
<p>Returns the <a href="qmediaobject.html">QMediaObject</a> instance that this <a href="qmediaplaylist.html">QMediaPlaylist</a> is bound too, or 0 otherwise.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@mediaObject -->
<!-- $$$mediaRemoved[overload1]$$$mediaRemovedintint -->
<h3 class="fn"><a name="mediaRemoved"></a><span class="type">void</span> QMediaPlaylist::<span class="name">mediaRemoved</span> ( <span class="type">int</span> <i>start</i>, <span class="type">int</span> <i>end</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted after media has been removed from the playlist. The removed items are those between <i>start</i> and <i>end</i> inclusive.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@mediaRemoved -->
<!-- $$$next[overload1]$$$next -->
<h3 class="fn"><a name="next"></a><span class="type">void</span> QMediaPlaylist::<span class="name">next</span> ()<tt> [slot]</tt></h3>
<p>Advance to the next media content in playlist.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@next -->
<!-- $$$nextIndex[overload1]$$$nextIndexint -->
<h3 class="fn"><a name="nextIndex"></a><span class="type">int</span> QMediaPlaylist::<span class="name">nextIndex</span> ( <span class="type">int</span> <i>steps</i> = 1 ) const</h3>
<p>Returns the index of the item, which would be current after calling <a href="qmediaplaylist.html#next">next</a>() <i>steps</i> times.</p>
<p>Returned value depends on the size of playlist, current position and playback mode.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplaylist.html#playbackMode-prop">QMediaPlaylist::playbackMode</a>.</p>
<!-- @@@nextIndex -->
<!-- $$$playbackModeChanged[overload1]$$$playbackModeChangedQMediaPlaylist::PlaybackMode -->
<h3 class="fn"><a name="playbackModeChanged"></a><span class="type">void</span> QMediaPlaylist::<span class="name">playbackModeChanged</span> ( <span class="type"><a href="qmediaplaylist.html#PlaybackMode-enum">QMediaPlaylist::PlaybackMode</a></span> <i>mode</i> )<tt> [signal]</tt></h3>
<p>Signal emitted when playback mode changed to <i>mode</i>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@playbackModeChanged -->
<!-- $$$previous[overload1]$$$previous -->
<h3 class="fn"><a name="previous"></a><span class="type">void</span> QMediaPlaylist::<span class="name">previous</span> ()<tt> [slot]</tt></h3>
<p>Return to the previous media content in playlist.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@previous -->
<!-- $$$previousIndex[overload1]$$$previousIndexint -->
<h3 class="fn"><a name="previousIndex"></a><span class="type">int</span> QMediaPlaylist::<span class="name">previousIndex</span> ( <span class="type">int</span> <i>steps</i> = 1 ) const</h3>
<p>Returns the index of the item, which would be current after calling <a href="qmediaplaylist.html#previous">previous</a>() <i>steps</i> times.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplaylist.html#playbackMode-prop">QMediaPlaylist::playbackMode</a>.</p>
<!-- @@@previousIndex -->
<!-- $$$removeMedia[overload1]$$$removeMediaint -->
<h3 class="fn"><a name="removeMedia"></a><span class="type">bool</span> QMediaPlaylist::<span class="name">removeMedia</span> ( <span class="type">int</span> <i>pos</i> )</h3>
<p>Remove the item from the playlist at position <i>pos</i>.</p>
<p>Returns true if the operation is successful, otherwise return false.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@removeMedia -->
<!-- $$$removeMedia$$$removeMediaintint -->
<h3 class="fn"><a name="removeMedia-2"></a><span class="type">bool</span> QMediaPlaylist::<span class="name">removeMedia</span> ( <span class="type">int</span> <i>start</i>, <span class="type">int</span> <i>end</i> )</h3>
<p>Remove items in the playlist from <i>start</i> to <i>end</i> inclusive.</p>
<p>Returns true if the operation is successful, otherwise return false.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@removeMedia -->
<!-- $$$save[overload1]$$$saveconstQUrl&constchar* -->
<h3 class="fn"><a name="save"></a><span class="type">bool</span> QMediaPlaylist::<span class="name">save</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qurl.html">QUrl</a></span> &amp; <i>location</i>, const <span class="type">char</span> * <i>format</i> = 0 )</h3>
<p>Save playlist to <i>location</i>. If <i>format</i> is specified, it is used, otherwise format is guessed from location name.</p>
<p>Returns true if playlist was saved successfully, otherwise returns false.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@save -->
<!-- $$$save$$$saveQIODevice*constchar* -->
<h3 class="fn"><a name="save-2"></a><span class="type">bool</span> QMediaPlaylist::<span class="name">save</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qiodevice.html">QIODevice</a></span> * <i>device</i>, const <span class="type">char</span> * <i>format</i> )</h3>
<p>Save playlist to <a href="http://qt.nokia.com/doc/4.7/qiodevice.html">QIODevice</a> <i>device</i> using format <i>format</i>.</p>
<p>Returns true if playlist was saved successfully, otherwise returns false.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@save -->
<!-- $$$shuffle[overload1]$$$shuffle -->
<h3 class="fn"><a name="shuffle"></a><span class="type">void</span> QMediaPlaylist::<span class="name">shuffle</span> ()<tt> [slot]</tt></h3>
<p>Shuffle items in the playlist.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@shuffle -->
</div>
  <div class="ft">
    <span></span>
  </div>
</div> 
<div class="footer">
  <p>
     <acronym title="Copyright">&copy;</acronym> 2008-2011 Nokia Corporation and/or its
     subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation 
     in Finland and/or other countries worldwide.</p>
  <p>
     All other trademarks are property of their respective owners. <a title="Privacy Policy"
     href="http://qt.nokia.com/about/privacy-policy">Privacy Policy</a></p>
  <br />
  <p>
    Licensees holding valid Qt Commercial licenses may use this document in accordance with the    Qt Commercial License Agreement provided with the Software or, alternatively, in accordance    with the terms contained in a written agreement between you and Nokia.</p>
  <p>
    Alternatively, this document may be used under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU
    Free Documentation License version 1.3</a>
    as published by the Free Software Foundation.</p>
</div>
</body>
</html>

Perl :: Catalyst :: PostgreSQL :: RPM Valid HTML 4.01 Transitional