<?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" />
<!-- qmediaservice.cpp -->
<title>Qt Mobility 1.2: QMediaService 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>QMediaService</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="#protected-functions">Protected Functions</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QMediaService Class Reference</h1>
<!-- $$$QMediaService-brief -->
<p>The QMediaService class provides a common base class for media service implementations. <a href="#details">More...</a></p>
<!-- @@@QMediaService -->
<pre class="cpp"> <span class="preprocessor">#include <QMediaService></span></pre><p><b>Inherits: </b><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a>.</p>
<p>This class was introduced in Qt Mobility 1.0.</p>
<ul>
<li><a href="qmediaservice-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="qmediaservice.html#dtor.QMediaService">~QMediaService</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmediaservice.html#releaseControl">releaseControl</a></b> ( QMediaControl * <i>control</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QMediaControl * </td><td class="memItemRight bottomAlign"><b><a href="qmediaservice.html#requestControl">requestControl</a></b> ( const char * <i>interface</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> T </td><td class="memItemRight bottomAlign"><b><a href="qmediaservice.html#requestControl-2">requestControl</a></b> ()</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="protected-functions"></a>
<h2>Protected Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qmediaservice.html#QMediaService">QMediaService</a></b> ( QObject * <i>parent</i> )</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>
<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 signal inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#signals">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>
<!-- $$$QMediaService-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QMediaService class provides a common base class for media service implementations.</p>
<p>Media services provide implementations of the functionality promised by media objects, and allow multiple providers to implement a <a href="qmediaobject.html">QMediaObject</a>.</p>
<p>To provide the functionality of a <a href="qmediaobject.html">QMediaObject</a> media services implement <a href="qmediacontrol.html">QMediaControl</a> interfaces. Services typically implement one core media control which provides the core feature of a media object, and some number of additional controls which provide either optional features of the media object, or features of a secondary media object or peripheral object.</p>
<p>A pointer to media service's <a href="qmediacontrol.html">QMediaControl</a> implementation can be obtained by passing the control's interface name to the <a href="qmediaservice.html#requestControl">requestControl</a>() function.</p>
<pre class="cpp"> <span class="type"><a href="qmediaplayercontrol.html">QMediaPlayerControl</a></span> <span class="operator">*</span>control <span class="operator">=</span> qobject_cast<span class="operator"><</span><span class="type"><a href="qmediaplayercontrol.html">QMediaPlayerControl</a></span> <span class="operator">*</span><span class="operator">></span>(
mediaService<span class="operator">-</span><span class="operator">></span>requestControl(<span class="string">"com.nokia.Qt.QMediaPlayerControl/1.0"</span>));</pre>
<p>Media objects can use services loaded dynamically from plug-ins or implemented statically within an applications. Plug-in based services should also implement the <a href="qmediaserviceproviderplugin.html">QMediaServiceProviderPlugin</a> interface. Static services should implement the <a href="qmediaserviceprovider.html">QMediaServiceProvider</a> interface.</p>
</div>
<p><b>See also </b><a href="qmediaobject.html">QMediaObject</a>, <a href="qmediacontrol.html">QMediaControl</a>, <a href="qmediaserviceprovider.html">QMediaServiceProvider</a>, and <a href="qmediaserviceproviderplugin.html">QMediaServiceProviderPlugin</a>.</p>
<!-- @@@QMediaService -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QMediaService[overload1]$$$QMediaServiceQObject* -->
<h3 class="fn"><a name="QMediaService"></a>QMediaService::<span class="name">QMediaService</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> )<tt> [protected]</tt></h3>
<p>Construct a media service with the given <i>parent</i>. This class is meant as a base class for Multimedia services so this constructor is protected.</p>
<!-- @@@QMediaService -->
<!-- $$$~QMediaService[overload1]$$$~QMediaService -->
<h3 class="fn"><a name="dtor.QMediaService"></a>QMediaService::<span class="name">~QMediaService</span> ()</h3>
<p>Destroys a media service.</p>
<!-- @@@~QMediaService -->
<!-- $$$releaseControl[overload1]$$$releaseControlQMediaControl* -->
<h3 class="fn"><a name="releaseControl"></a><span class="type">void</span> QMediaService::<span class="name">releaseControl</span> ( <span class="type"><a href="qmediacontrol.html">QMediaControl</a></span> * <i>control</i> )<tt> [pure virtual]</tt></h3>
<p>Releases a <i>control</i> back to the service.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@releaseControl -->
<!-- $$$requestControl[overload1]$$$requestControlconstchar* -->
<h3 class="fn"><a name="requestControl"></a><span class="type"><a href="qmediacontrol.html">QMediaControl</a></span> * QMediaService::<span class="name">requestControl</span> ( const <span class="type">char</span> * <i>interface</i> )<tt> [pure virtual]</tt></h3>
<p>Returns a pointer to the media control implementing <i>interface</i>.</p>
<p>If the service does not implement the control, or if it is unavailable a null pointer is returned instead.</p>
<p>Controls must be returned to the service when no longer needed using the <a href="qmediaservice.html#releaseControl">releaseControl</a>() function.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@requestControl -->
<!-- $$$requestControl$$$requestControl -->
<h3 class="fn"><a name="requestControl-2"></a><span class="type">T</span> QMediaService::<span class="name">requestControl</span> ()</h3>
<p>Returns a pointer to the media control of type T implemented by a media service.</p>
<p>If the service does not implement the control, or if it is unavailable a null pointer is returned instead.</p>
<p>Controls must be returned to the service when no longer needed using the <a href="qmediaservice.html#releaseControl">releaseControl</a>() function.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@requestControl -->
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</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>
distrib
>
Mageia
>
5
>
i586
>
media
>
core-release
>
by-pkgid
>
50facae208d4a6f280e44a513b104320
>
files
>
1078
