Sophie

Sophie

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

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" />
<!-- qmediaplayercontrol.cpp -->
  <title>Qt Mobility 1.2: QMediaPlayerControl 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>QMediaPlayerControl</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-functions">Public Functions</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#protected-functions">Protected Functions</a></li>
<li class="level1"><a href="#macros">Macros</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QMediaPlayerControl Class Reference</h1>
<!-- $$$QMediaPlayerControl-brief -->
<p>The QMediaPlayerControl class provides access to the media playing functionality of a <a href="qmediaservice.html">QMediaService</a>. <a href="#details">More...</a></p>
<!-- @@@QMediaPlayerControl -->
<pre class="cpp"> <span class="preprocessor">#include &lt;QMediaPlayerControl&gt;</span></pre><p><b>Inherits: </b><a href="qmediacontrol.html">QMediaControl</a>.</p>
<p>This class was introduced in Qt Mobility 1.0.</p>
<ul>
<li><a href="qmediaplayercontrol-members.html">List of all members, including inherited members</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="qmediaplayercontrol.html#dtor.QMediaPlayerControl">~QMediaPlayerControl</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QMediaTimeRange </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#availablePlaybackRanges">availablePlaybackRanges</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual int </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#bufferStatus">bufferStatus</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual qint64 </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#duration">duration</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#isAudioAvailable">isAudioAvailable</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#isMuted">isMuted</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#isSeekable">isSeekable</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#isVideoAvailable">isVideoAvailable</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QMediaContent </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#media">media</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QMediaPlayer::MediaStatus </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#mediaStatus">mediaStatus</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual const QIODevice * </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#mediaStream">mediaStream</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#pause">pause</a></b> () = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#play">play</a></b> () = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual qreal </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#playbackRate">playbackRate</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual qint64 </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#position">position</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#setMedia">setMedia</a></b> ( const QMediaContent &amp; <i>media</i>, QIODevice * <i>stream</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#setMuted">setMuted</a></b> ( bool <i>mute</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#setPlaybackRate">setPlaybackRate</a></b> ( qreal <i>rate</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#setPosition">setPosition</a></b> ( qint64 <i>position</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#setVolume">setVolume</a></b> ( int <i>volume</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QMediaPlayer::State </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#state">state</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#stop">stop</a></b> () = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual int </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#volume">volume</a></b> () const = 0</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>
</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="qmediaplayercontrol.html#audioAvailableChanged">audioAvailableChanged</a></b> ( bool <i>audio</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#availablePlaybackRangesChanged">availablePlaybackRangesChanged</a></b> ( const QMediaTimeRange &amp; <i>ranges</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#bufferStatusChanged">bufferStatusChanged</a></b> ( int <i>progress</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#durationChanged">durationChanged</a></b> ( qint64 <i>duration</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#error">error</a></b> ( int <i>error</i>, const QString &amp; <i>errorString</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#mediaChanged">mediaChanged</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="qmediaplayercontrol.html#mediaStatusChanged">mediaStatusChanged</a></b> ( QMediaPlayer::MediaStatus <i>status</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#mutedChanged">mutedChanged</a></b> ( bool <i>mute</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#playbackRateChanged">playbackRateChanged</a></b> ( qreal <i>rate</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#positionChanged">positionChanged</a></b> ( qint64 <i>position</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#seekableChanged">seekableChanged</a></b> ( bool <i>seekable</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#stateChanged">stateChanged</a></b> ( QMediaPlayer::State <i>state</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#videoAvailableChanged">videoAvailableChanged</a></b> ( bool <i>video</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#volumeChanged">volumeChanged</a></b> ( int <i>volume</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>
<a name="protected-functions"></a>
<h2>Protected Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#QMediaPlayerControl">QMediaPlayerControl</a></b> ( QObject * <i>parent</i> = 0 )</td></tr>
</table>
<ul>
<li class="fn">7 protected functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-functions">QObject</a></li>
</ul>
<a name="macros"></a>
<h2>Macros</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qmediaplayercontrol.html#QMediaPlayerControl_iid">QMediaPlayerControl_iid</a></b></td></tr>
</table>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">1 property inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#properties">QObject</a></li>
<li class="fn">1 public slot inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-slots">QObject</a></li>
<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">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>
<!-- $$$QMediaPlayerControl-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QMediaPlayerControl class provides access to the media playing functionality of a <a href="qmediaservice.html">QMediaService</a>.</p>
<p>If a <a href="qmediaservice.html">QMediaService</a> can play media is will implement QMediaPlayerControl. This control provides a means to set the <a href="qmediaplayercontrol.html#setMedia">media</a> to play, <a href="qmediaplayercontrol.html#play">start</a>, <a href="qmediaplayercontrol.html#pause">pause</a> and <a href="qmediaplayercontrol.html#stop">stop</a> playback, <a href="qmediaplayercontrol.html#setPosition">seek</a>, and control the <a href="qmediaplayercontrol.html#setVolume">volume</a>. It also provides feedback on the <a href="qmediaplayercontrol.html#duration">duration</a> of the media, the current <a href="qmediaplayercontrol.html#position">position</a>, and <a href="qmediaplayercontrol.html#bufferStatus">buffering</a> progress.</p>
<p>The functionality provided by this control is exposed to application code through the <a href="qmediaplayer.html">QMediaPlayer</a> class.</p>
<p>The interface name of QMediaPlayerControl is <tt>com.nokia.Qt.QMediaPlayerControl/1.0</tt> as defined in <a href="qmediaplayercontrol.html#QMediaPlayerControl_iid">QMediaPlayerControl_iid</a>.</p>
</div>
<p><b>See also </b><a href="qmediaservice.html#requestControl">QMediaService::requestControl</a>() and <a href="qmediaplayer.html">QMediaPlayer</a>.</p>
<!-- @@@QMediaPlayerControl -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QMediaPlayerControl[overload1]$$$QMediaPlayerControlQObject* -->
<h3 class="fn"><a name="QMediaPlayerControl"></a>QMediaPlayerControl::<span class="name">QMediaPlayerControl</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> = 0 )<tt> [protected]</tt></h3>
<p>Constructs a new media player control with the given <i>parent</i>.</p>
<!-- @@@QMediaPlayerControl -->
<!-- $$$~QMediaPlayerControl[overload1]$$$~QMediaPlayerControl -->
<h3 class="fn"><a name="dtor.QMediaPlayerControl"></a>QMediaPlayerControl::<span class="name">~QMediaPlayerControl</span> ()</h3>
<p>Destroys a media player control.</p>
<!-- @@@~QMediaPlayerControl -->
<!-- $$$audioAvailableChanged[overload1]$$$audioAvailableChangedbool -->
<h3 class="fn"><a name="audioAvailableChanged"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">audioAvailableChanged</span> ( <span class="type">bool</span> <i>audio</i> )<tt> [signal]</tt></h3>
<p>Signals that there has been a change in the availability of <i>audio</i> output.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#isAudioAvailable">isAudioAvailable</a>().</p>
<!-- @@@audioAvailableChanged -->
<!-- $$$availablePlaybackRanges[overload1]$$$availablePlaybackRanges -->
<h3 class="fn"><a name="availablePlaybackRanges"></a><span class="type"><a href="qmediatimerange.html">QMediaTimeRange</a></span> QMediaPlayerControl::<span class="name">availablePlaybackRanges</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns a range of times in milliseconds that can be played back.</p>
<p>Usually for local files this is a continuous interval equal to [0..<a href="qmediaplayercontrol.html#duration">duration</a>()] or an empty time range if seeking is not supported, but for network sources it refers to the buffered parts of the media.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@availablePlaybackRanges -->
<!-- $$$availablePlaybackRangesChanged[overload1]$$$availablePlaybackRangesChangedconstQMediaTimeRange& -->
<h3 class="fn"><a name="availablePlaybackRangesChanged"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">availablePlaybackRangesChanged</span> ( const <span class="type"><a href="qmediatimerange.html">QMediaTimeRange</a></span> &amp; <i>ranges</i> )<tt> [signal]</tt></h3>
<p>Signals that the available media playback <i>ranges</i> have changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#availablePlaybackRanges">QMediaPlayerControl::availablePlaybackRanges</a>().</p>
<!-- @@@availablePlaybackRangesChanged -->
<!-- $$$bufferStatus[overload1]$$$bufferStatus -->
<h3 class="fn"><a name="bufferStatus"></a><span class="type">int</span> QMediaPlayerControl::<span class="name">bufferStatus</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the buffering progress of the current media. Progress is measured in the percentage of the buffer filled.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@bufferStatus -->
<!-- $$$bufferStatusChanged[overload1]$$$bufferStatusChangedint -->
<h3 class="fn"><a name="bufferStatusChanged"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">bufferStatusChanged</span> ( <span class="type">int</span> <i>progress</i> )<tt> [signal]</tt></h3>
<p>Signals that buffering <i>progress</i> has changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#bufferStatus">bufferStatus</a>().</p>
<!-- @@@bufferStatusChanged -->
<!-- $$$duration[overload1]$$$duration -->
<h3 class="fn"><a name="duration"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#qint64-typedef">qint64</a></span> QMediaPlayerControl::<span class="name">duration</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the duration of the current media in milliseconds.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@duration -->
<!-- $$$durationChanged[overload1]$$$durationChangedqint64 -->
<h3 class="fn"><a name="durationChanged"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">durationChanged</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#qint64-typedef">qint64</a></span> <i>duration</i> )<tt> [signal]</tt></h3>
<p>Signals that the <i>duration</i> of the current media has changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#duration">duration</a>().</p>
<!-- @@@durationChanged -->
<!-- $$$error[overload1]$$$errorintconstQString& -->
<h3 class="fn"><a name="error"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">error</span> ( <span class="type">int</span> <i>error</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>errorString</i> )<tt> [signal]</tt></h3>
<p>Signals that an <i>error</i> has occurred. The <i>errorString</i> provides a more detailed explanation.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@error -->
<!-- $$$isAudioAvailable[overload1]$$$isAudioAvailable -->
<h3 class="fn"><a name="isAudioAvailable"></a><span class="type">bool</span> QMediaPlayerControl::<span class="name">isAudioAvailable</span> () const<tt> [pure virtual]</tt></h3>
<p>Identifies if there is audio output available for the current media.</p>
<p>Returns true if audio output is available and false otherwise.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@isAudioAvailable -->
<!-- $$$isMuted[overload1]$$$isMuted -->
<h3 class="fn"><a name="isMuted"></a><span class="type">bool</span> QMediaPlayerControl::<span class="name">isMuted</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the mute state of a player control.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@isMuted -->
<!-- $$$isSeekable[overload1]$$$isSeekable -->
<h3 class="fn"><a name="isSeekable"></a><span class="type">bool</span> QMediaPlayerControl::<span class="name">isSeekable</span> () const<tt> [pure virtual]</tt></h3>
<p>Identifies if the current media is seekable.</p>
<p>Returns true if it possible to seek within the current media, and false otherwise.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@isSeekable -->
<!-- $$$isVideoAvailable[overload1]$$$isVideoAvailable -->
<h3 class="fn"><a name="isVideoAvailable"></a><span class="type">bool</span> QMediaPlayerControl::<span class="name">isVideoAvailable</span> () const<tt> [pure virtual]</tt></h3>
<p>Identifies if there is video output available for the current media.</p>
<p>Returns true if video output is available and false otherwise.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@isVideoAvailable -->
<!-- $$$media[overload1]$$$media -->
<h3 class="fn"><a name="media"></a><span class="type"><a href="qmediacontent.html">QMediaContent</a></span> QMediaPlayerControl::<span class="name">media</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the current media source.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#setMedia">setMedia</a>().</p>
<!-- @@@media -->
<!-- $$$mediaChanged[overload1]$$$mediaChangedconstQMediaContent& -->
<h3 class="fn"><a name="mediaChanged"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">mediaChanged</span> ( const <span class="type"><a href="qmediacontent.html">QMediaContent</a></span> &amp; <i>content</i> )<tt> [signal]</tt></h3>
<p>Signals that the current media <i>content</i> has changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@mediaChanged -->
<!-- $$$mediaStatus[overload1]$$$mediaStatus -->
<h3 class="fn"><a name="mediaStatus"></a><span class="type"><a href="qmediaplayer.html#MediaStatus-enum">QMediaPlayer::MediaStatus</a></span> QMediaPlayerControl::<span class="name">mediaStatus</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the status of the current media.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@mediaStatus -->
<!-- $$$mediaStatusChanged[overload1]$$$mediaStatusChangedQMediaPlayer::MediaStatus -->
<h3 class="fn"><a name="mediaStatusChanged"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">mediaStatusChanged</span> ( <span class="type"><a href="qmediaplayer.html#MediaStatus-enum">QMediaPlayer::MediaStatus</a></span> <i>status</i> )<tt> [signal]</tt></h3>
<p>Signals that the <i>status</i> of the current media has changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#mediaStatus">mediaStatus</a>().</p>
<!-- @@@mediaStatusChanged -->
<!-- $$$mediaStream[overload1]$$$mediaStream -->
<h3 class="fn"><a name="mediaStream"></a>const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qiodevice.html">QIODevice</a></span> * QMediaPlayerControl::<span class="name">mediaStream</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the current media stream. This is only a valid if a stream was passed to <a href="qmediaplayercontrol.html#setMedia">setMedia</a>().</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#setMedia">setMedia</a>().</p>
<!-- @@@mediaStream -->
<!-- $$$mutedChanged[overload1]$$$mutedChangedbool -->
<h3 class="fn"><a name="mutedChanged"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">mutedChanged</span> ( <span class="type">bool</span> <i>mute</i> )<tt> [signal]</tt></h3>
<p>Signals a change in the <i>mute</i> status of a player control.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#isMuted">isMuted</a>().</p>
<!-- @@@mutedChanged -->
<!-- $$$pause[overload1]$$$pause -->
<h3 class="fn"><a name="pause"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">pause</span> ()<tt> [pure virtual]</tt></h3>
<p>Pauses playback of the current media.</p>
<p>If sucessful the player control will immediately enter the <a href="qmediaplayer.html#State-enum">paused</a> state.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#state">state</a>(), <a href="qmediaplayercontrol.html#play">play</a>(), and <a href="qmediaplayercontrol.html#stop">stop</a>().</p>
<!-- @@@pause -->
<!-- $$$play[overload1]$$$play -->
<h3 class="fn"><a name="play"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">play</span> ()<tt> [pure virtual]</tt></h3>
<p>Starts playback of the current media.</p>
<p>If successful the player control will immediately enter the <a href="qmediaplayer.html#State-enum">playing</a> state.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#state">state</a>().</p>
<!-- @@@play -->
<!-- $$$playbackRate[overload1]$$$playbackRate -->
<h3 class="fn"><a name="playbackRate"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#qreal-typedef">qreal</a></span> QMediaPlayerControl::<span class="name">playbackRate</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the rate of playback.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#setPlaybackRate">setPlaybackRate</a>().</p>
<!-- @@@playbackRate -->
<!-- $$$playbackRateChanged[overload1]$$$playbackRateChangedqreal -->
<h3 class="fn"><a name="playbackRateChanged"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">playbackRateChanged</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#qreal-typedef">qreal</a></span> <i>rate</i> )<tt> [signal]</tt></h3>
<p>Signal emitted when playback rate changes to <i>rate</i>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@playbackRateChanged -->
<!-- $$$position[overload1]$$$position -->
<h3 class="fn"><a name="position"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#qint64-typedef">qint64</a></span> QMediaPlayerControl::<span class="name">position</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the current playback position in milliseconds.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#setPosition">setPosition</a>().</p>
<!-- @@@position -->
<!-- $$$positionChanged[overload1]$$$positionChangedqint64 -->
<h3 class="fn"><a name="positionChanged"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">positionChanged</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#qint64-typedef">qint64</a></span> <i>position</i> )<tt> [signal]</tt></h3>
<p>Signals the playback <i>position</i> has changed.</p>
<p>This is only emitted in when there has been a discontinous change in the playback postion, such as a seek or the position being reset.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#position">position</a>().</p>
<!-- @@@positionChanged -->
<!-- $$$seekableChanged[overload1]$$$seekableChangedbool -->
<h3 class="fn"><a name="seekableChanged"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">seekableChanged</span> ( <span class="type">bool</span> <i>seekable</i> )<tt> [signal]</tt></h3>
<p>Signals that the <i>seekable</i> state of a player control has changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#isSeekable">isSeekable</a>().</p>
<!-- @@@seekableChanged -->
<!-- $$$setMedia[overload1]$$$setMediaconstQMediaContent&QIODevice* -->
<h3 class="fn"><a name="setMedia"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">setMedia</span> ( const <span class="type"><a href="qmediacontent.html">QMediaContent</a></span> &amp; <i>media</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qiodevice.html">QIODevice</a></span> * <i>stream</i> )<tt> [pure virtual]</tt></h3>
<p>Sets the current <i>media</i> source. If a <i>stream</i> is supplied; data will be read from that instead of attempting to resolve the media source. The media source may still be used to supply media information such as mime type.</p>
<p>Setting the media to a null <a href="qmediacontent.html">QMediaContent</a> will cause the control to discard all information relating to the current media source and to cease all I/O operations related to that media.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#media">media</a>().</p>
<!-- @@@setMedia -->
<!-- $$$setMuted[overload1]$$$setMutedbool -->
<h3 class="fn"><a name="setMuted"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">setMuted</span> ( <span class="type">bool</span> <i>mute</i> )<tt> [pure virtual]</tt></h3>
<p>Sets the <i>mute</i> state of a player control.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#isMuted">isMuted</a>().</p>
<!-- @@@setMuted -->
<!-- $$$setPlaybackRate[overload1]$$$setPlaybackRateqreal -->
<h3 class="fn"><a name="setPlaybackRate"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">setPlaybackRate</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#qreal-typedef">qreal</a></span> <i>rate</i> )<tt> [pure virtual]</tt></h3>
<p>Sets the <i>rate</i> of playback.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#playbackRate">playbackRate</a>().</p>
<!-- @@@setPlaybackRate -->
<!-- $$$setPosition[overload1]$$$setPositionqint64 -->
<h3 class="fn"><a name="setPosition"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">setPosition</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#qint64-typedef">qint64</a></span> <i>position</i> )<tt> [pure virtual]</tt></h3>
<p>Sets the playback <i>position</i> of the current media. This will initiate a seek and it may take some time for playback to reach the position set.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#position">position</a>().</p>
<!-- @@@setPosition -->
<!-- $$$setVolume[overload1]$$$setVolumeint -->
<h3 class="fn"><a name="setVolume"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">setVolume</span> ( <span class="type">int</span> <i>volume</i> )<tt> [pure virtual]</tt></h3>
<p>Sets the audio <i>volume</i> of a player control.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#volume">volume</a>().</p>
<!-- @@@setVolume -->
<!-- $$$state[overload1]$$$state -->
<h3 class="fn"><a name="state"></a><span class="type"><a href="qmediaplayer.html#State-enum">QMediaPlayer::State</a></span> QMediaPlayerControl::<span class="name">state</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the state of a player control.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@state -->
<!-- $$$stateChanged[overload1]$$$stateChangedQMediaPlayer::State -->
<h3 class="fn"><a name="stateChanged"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">stateChanged</span> ( <span class="type"><a href="qmediaplayer.html#State-enum">QMediaPlayer::State</a></span> <i>state</i> )<tt> [signal]</tt></h3>
<p>Signals that the <i>state</i> of a player control has changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#state">state</a>().</p>
<!-- @@@stateChanged -->
<!-- $$$stop[overload1]$$$stop -->
<h3 class="fn"><a name="stop"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">stop</span> ()<tt> [pure virtual]</tt></h3>
<p>Stops playback of the current media.</p>
<p>If successful the player control will immediately enter the <a href="qmediaplayer.html#State-enum">stopped</a> state.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@stop -->
<!-- $$$videoAvailableChanged[overload1]$$$videoAvailableChangedbool -->
<h3 class="fn"><a name="videoAvailableChanged"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">videoAvailableChanged</span> ( <span class="type">bool</span> <i>video</i> )<tt> [signal]</tt></h3>
<p>Signals that there has been a change in the availability of <i>video</i> output.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#isVideoAvailable">isVideoAvailable</a>().</p>
<!-- @@@videoAvailableChanged -->
<!-- $$$volume[overload1]$$$volume -->
<h3 class="fn"><a name="volume"></a><span class="type">int</span> QMediaPlayerControl::<span class="name">volume</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the audio volume of a player control.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#setVolume">setVolume</a>().</p>
<!-- @@@volume -->
<!-- $$$volumeChanged[overload1]$$$volumeChangedint -->
<h3 class="fn"><a name="volumeChanged"></a><span class="type">void</span> QMediaPlayerControl::<span class="name">volumeChanged</span> ( <span class="type">int</span> <i>volume</i> )<tt> [signal]</tt></h3>
<p>Signals the audio <i>volume</i> of a player control has changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmediaplayercontrol.html#volume">volume</a>().</p>
<!-- @@@volumeChanged -->
</div>
<div class="macros">
<h2>Macro Documentation</h2>
<!-- $$$QMediaPlayerControl_iid[overload1]$$$QMediaPlayerControl_iid -->
<h3 class="fn"><a name="QMediaPlayerControl_iid"></a><span class="name">QMediaPlayerControl_iid</span></h3>
<p><tt>com.nokia.Qt.QMediaPlayerControl/1.0</tt></p>
<p>Defines the interface name of the <a href="qmediaplayercontrol.html">QMediaPlayerControl</a> class.</p>
<!-- @@@QMediaPlayerControl_iid -->
</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>