Sophie

Sophie

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

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" />
<!-- qradiotuner.cpp -->
  <title>Qt Mobility 1.2: QRadioTuner 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>QRadioTuner</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">QRadioTuner Class Reference</h1>
<!-- $$$QRadioTuner-brief -->
<p>The QRadioTuner class provides an interface to the systems analog radio device. <a href="#details">More...</a></p>
<!-- @@@QRadioTuner -->
<pre class="cpp"> <span class="preprocessor">#include &lt;QRadioTuner&gt;</span></pre><p><b>Inherits: </b><a href="qmediaobject.html">QMediaObject</a>.</p>
<p>This class was introduced in Qt Mobility 1.0.</p>
<ul>
<li><a href="qradiotuner-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="qradiotuner.html#Band-enum">Band</a></b> { AM, FM, SW, LW, FM2 }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#Error-enum">Error</a></b> { NoError, ResourceError, OpenError, OutOfRangeError }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#State-enum">State</a></b> { ActiveState, StoppedState }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#StereoMode-enum">StereoMode</a></b> { Auto, ForceStereo, ForceMono }</td></tr>
</table>
<a name="properties"></a>
<h2>Properties</h2>
<table class="propsummary">
<tr><td class="topAlign"><ul>
<li class="fn"><b><a href="qradiotuner.html#band-prop">band</a></b> : Band</li>
<li class="fn"><b><a href="qradiotuner.html#frequency-prop">frequency</a></b> : int</li>
<li class="fn"><b><a href="qradiotuner.html#muted-prop">muted</a></b> : bool</li>
<li class="fn"><b><a href="qradiotuner.html#searching-prop">searching</a></b> : const bool</li>
<li class="fn"><b><a href="qradiotuner.html#signalStrength-prop">signalStrength</a></b> : const int</li>
</ul></td><td class="topAlign"><ul>
<li class="fn"><b><a href="qradiotuner.html#state-prop">state</a></b> : const State</li>
<li class="fn"><b><a href="qradiotuner.html#stereo-prop">stereo</a></b> : const bool</li>
<li class="fn"><b><a href="qradiotuner.html#stereoMode-prop">stereoMode</a></b> : StereoMode</li>
<li class="fn"><b><a href="qradiotuner.html#volume-prop">volume</a></b> : int</li>
</ul>
</td></tr>
</table>
<ul>
<li class="fn">1 property inherited from <a href="qmediaobject.html#properties">QMediaObject</a></li>
<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="qradiotuner.html#QRadioTuner">QRadioTuner</a></b> ( QObject * <i>parent</i> = 0, QMediaServiceProvider * <i>provider</i> = QMediaServiceProvider::defaultServiceProvider() )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#dtor.QRadioTuner">~QRadioTuner</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Band </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#band-prop">band</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Error </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#error">error</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#errorString">errorString</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#frequency-prop">frequency</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QPair&lt;int, int&gt; </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#frequencyRange">frequencyRange</a></b> ( Band <i>band</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#frequencyStep">frequencyStep</a></b> ( Band <i>band</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#isBandSupported">isBandSupported</a></b> ( Band <i>band</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#muted-prop">isMuted</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#searching-prop">isSearching</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#stereo-prop">isStereo</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#stereoMode-prop">setStereoMode</a></b> ( QRadioTuner::StereoMode <i>mode</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#signalStrength-prop">signalStrength</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> State </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#state-prop">state</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> StereoMode </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#stereoMode-prop">stereoMode</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#volume-prop">volume</a></b> () const</td></tr>
</table>
<a name="reimplemented-public-functions"></a>
<h2>Reimplemented Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual QtMultimediaKit::AvailabilityError </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#availabilityError">availabilityError</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#isAvailable">isAvailable</a></b> () const</td></tr>
</table>
<ul>
<li class="fn">12 public functions inherited from <a href="qmediaobject.html#public-functions">QMediaObject</a></li>
<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="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="qradiotuner.html#cancelSearch">cancelSearch</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#searchBackward">searchBackward</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#searchForward">searchForward</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#band-prop">setBand</a></b> ( Band <i>band</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#frequency-prop">setFrequency</a></b> ( int <i>frequency</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#muted-prop">setMuted</a></b> ( bool <i>muted</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#volume-prop">setVolume</a></b> ( int <i>volume</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#start">start</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#stop">stop</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="qradiotuner.html#bandChanged">bandChanged</a></b> ( QRadioTuner::Band <i>band</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#error-2">error</a></b> ( QRadioTuner::Error <i>error</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#frequencyChanged">frequencyChanged</a></b> ( int <i>frequency</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#mutedChanged">mutedChanged</a></b> ( bool <i>muted</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#searchingChanged">searchingChanged</a></b> ( bool <i>searching</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#signalStrengthChanged">signalStrengthChanged</a></b> ( int <i>strength</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#stateChanged">stateChanged</a></b> ( QRadioTuner::State <i>state</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#stereoStatusChanged">stereoStatusChanged</a></b> ( bool <i>stereo</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qradiotuner.html#volumeChanged">volumeChanged</a></b> ( int <i>volume</i> )</td></tr>
</table>
<ul>
<li class="fn">4 signals inherited from <a href="qmediaobject.html#signals">QMediaObject</a></li>
<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">2 protected functions inherited from <a href="qmediaobject.html#protected-functions">QMediaObject</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">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>
<!-- $$$QRadioTuner-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QRadioTuner class provides an interface to the systems analog radio device.</p>
<p>You can control the systems analog radio device using this interface, for example:</p>
<pre class="cpp"> radio <span class="operator">=</span> <span class="keyword">new</span> <span class="type">QRadioTuner</span>;
 connect(radio<span class="operator">,</span> SIGNAL(frequencyChanged(<span class="type">int</span>))<span class="operator">,</span> <span class="keyword">this</span><span class="operator">,</span> SLOT(freqChanged(<span class="type">int</span>)));
 <span class="keyword">if</span> (radio<span class="operator">-</span><span class="operator">&gt;</span>isBandSupported(<span class="type">QRadioTuner</span><span class="operator">::</span>FM)) {
     radio<span class="operator">-</span><span class="operator">&gt;</span>setBand(<span class="type">QRadioTuner</span><span class="operator">::</span>FM);
     radio<span class="operator">-</span><span class="operator">&gt;</span>setFrequency(yourRadioStationFrequency);
     radio<span class="operator">-</span><span class="operator">&gt;</span>setVolume(<span class="number">100</span>);
     radio<span class="operator">-</span><span class="operator">&gt;</span>start();
 }</pre>
<p>The radio object will emit signals for any changes in state such as: <a href="qradiotuner.html#bandChanged">bandChanged</a>(), <a href="qradiotuner.html#frequencyChanged">frequencyChanged</a>(), <a href="qradiotuner.html#stereoStatusChanged">stereoStatusChanged</a>(), <a href="qradiotuner.html#searchingChanged">searchingChanged</a>(), <a href="qradiotuner.html#signalStrengthChanged">signalStrengthChanged</a>(), <a href="qradiotuner.html#volumeChanged">volumeChanged</a>(), <a href="qradiotuner.html#mutedChanged">mutedChanged</a>().</p>
<p>You can change between the frequency bands using <a href="qradiotuner.html#band-prop">setBand</a>() however it is recommended that you check to make sure the band is available first using <a href="qradiotuner.html#isBandSupported">isBandSupported</a>().</p>
</div>
<!-- @@@QRadioTuner -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$Band$$$AM$$$FM$$$SW$$$LW$$$FM2 -->
<h3 class="fn"><a name="Band-enum"></a>enum QRadioTuner::<span class="name">Band</span></h3>
<p>Enumerates radio frequency bands.</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>QRadioTuner::AM</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">520 to 1610 kHz, 9 or 10kHz channel spacing, extended 1610 to 1710 kHz</td></tr>
<tr><td class="topAlign"><tt>QRadioTuner::FM</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">87.5 to 108.0 MHz, except Japan 76-90 MHz</td></tr>
<tr><td class="topAlign"><tt>QRadioTuner::SW</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">1.711 to 30.0 MHz, divided into 15 bands. 5kHz channel spacing</td></tr>
<tr><td class="topAlign"><tt>QRadioTuner::LW</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">148.5 to 283.5 kHz, 9kHz channel spacing (Europe, Africa, Asia)</td></tr>
<tr><td class="topAlign"><tt>QRadioTuner::FM2</tt></td><td class="topAlign"><tt>4</tt></td><td class="topAlign">range not defined, used when area supports more than one FM range.</td></tr>
</table>
<!-- @@@Band -->
<!-- $$$Error$$$NoError$$$ResourceError$$$OpenError$$$OutOfRangeError -->
<h3 class="fn"><a name="Error-enum"></a>enum QRadioTuner::<span class="name">Error</span></h3>
<p>Enumerates radio tuner error conditions.</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>QRadioTuner::NoError</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">No errors have occurred.</td></tr>
<tr><td class="topAlign"><tt>QRadioTuner::ResourceError</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">There is no radio service available.</td></tr>
<tr><td class="topAlign"><tt>QRadioTuner::OpenError</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">Unable to open radio device.</td></tr>
<tr><td class="topAlign"><tt>QRadioTuner::OutOfRangeError</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">An attempt to set a frequency or band that is not supported by radio device.</td></tr>
</table>
<!-- @@@Error -->
<!-- $$$State$$$ActiveState$$$StoppedState -->
<h3 class="fn"><a name="State-enum"></a>enum QRadioTuner::<span class="name">State</span></h3>
<p>Enumerates radio tuner states.</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>QRadioTuner::ActiveState</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The tuner is started and active.</td></tr>
<tr><td class="topAlign"><tt>QRadioTuner::StoppedState</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The tuner device is stopped.</td></tr>
</table>
<!-- @@@State -->
<!-- $$$StereoMode$$$ForceStereo$$$ForceMono$$$Auto -->
<h3 class="fn"><a name="StereoMode-enum"></a>enum QRadioTuner::<span class="name">StereoMode</span></h3>
<p>Enumerates radio tuner policy for receiving stereo signals.</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>QRadioTuner::Auto</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">Uses the stereo mode matching the station.</td></tr>
<tr><td class="topAlign"><tt>QRadioTuner::ForceStereo</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">Provide stereo mode, converting if required.</td></tr>
<tr><td class="topAlign"><tt>QRadioTuner::ForceMono</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">Provide mono mode, converting if required.</td></tr>
</table>
<!-- @@@StereoMode -->
</div>
<div class="prop">
<h2>Property Documentation</h2>
<!-- $$$band-prop$$$band$$$setBandBand$$$bandChangedQRadioTuner::Band -->
<h3 class="fn"><a name="band-prop"></a><span class="name">band</span> : <span class="type"><a href="qradiotuner.html#Band-enum">Band</a></span></h3>
<p>This property holds the frequency band a radio tuner is tuned to.</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"> Band </td><td class="memItemRight bottomAlign"><span class="name"><b>band</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setBand</b></span> ( Band <i>band</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="qradiotuner.html#bandChanged">bandChanged</a></b></span> ( QRadioTuner::Band <i>band</i> )</td></tr>
</table>
<p><b>See also </b><a href="qradiotuner.html#Band-enum">QRadioTuner::Band</a>.</p>
<!-- @@@band -->
<!-- $$$frequency-prop$$$frequency$$$setFrequencyint$$$frequencyChangedint -->
<h3 class="fn"><a name="frequency-prop"></a><span class="name">frequency</span> : <span class="type">int</span></h3>
<p>This property holds the frequency in Hertz a radio tuner is tuned to.</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>frequency</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setFrequency</b></span> ( int <i>frequency</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="qradiotuner.html#frequencyChanged">frequencyChanged</a></b></span> ( int <i>frequency</i> )</td></tr>
</table>
<!-- @@@frequency -->
<!-- $$$muted-prop$$$isMuted$$$setMutedbool$$$mutedChangedbool -->
<h3 class="fn"><a name="muted-prop"></a><span class="name">muted</span> : <span class="type">bool</span></h3>
<p>This property holds whether a radio tuner's audio output is muted.</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"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isMuted</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setMuted</b></span> ( bool <i>muted</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="qradiotuner.html#mutedChanged">mutedChanged</a></b></span> ( bool <i>muted</i> )</td></tr>
</table>
<!-- @@@muted -->
<!-- $$$searching-prop$$$isSearching$$$searchingChangedbool -->
<h3 class="fn"><a name="searching-prop"></a><span class="name">searching</span> : const <span class="type">bool</span></h3>
<p>This property holds whether a radio tuner is currently scanning for a signal.</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"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isSearching</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="qradiotuner.html#searchingChanged">searchingChanged</a></b></span> ( bool <i>searching</i> )</td></tr>
</table>
<p><b>See also </b><a href="qradiotuner.html#searchForward">searchForward</a>(), <a href="qradiotuner.html#searchBackward">searchBackward</a>(), and <a href="qradiotuner.html#cancelSearch">cancelSearch</a>().</p>
<!-- @@@searching -->
<!-- $$$signalStrength-prop$$$signalStrength$$$signalStrengthChangedint -->
<h3 class="fn"><a name="signalStrength-prop"></a><span class="name">signalStrength</span> : const <span class="type">int</span></h3>
<p>This property holds the strength of the current radio signal as a percentage.</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>signalStrength</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="qradiotuner.html#signalStrengthChanged">signalStrengthChanged</a></b></span> ( int <i>strength</i> )</td></tr>
</table>
<!-- @@@signalStrength -->
<!-- $$$state-prop$$$state$$$stateChangedQRadioTuner::State -->
<h3 class="fn"><a name="state-prop"></a><span class="name">state</span> : const <span class="type"><a href="qradiotuner.html#State-enum">State</a></span></h3>
<p>Return the current radio tuner state.</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"> State </td><td class="memItemRight bottomAlign"><span class="name"><b>state</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="qradiotuner.html#stateChanged">stateChanged</a></b></span> ( QRadioTuner::State <i>state</i> )</td></tr>
</table>
<p><b>See also </b><a href="qradiotuner.html#State-enum">QRadioTuner::State</a>.</p>
<!-- @@@state -->
<!-- $$$stereo-prop$$$isStereo$$$stereoStatusChangedbool -->
<h3 class="fn"><a name="stereo-prop"></a><span class="name">stereo</span> : const <span class="type">bool</span></h3>
<p>This property holds whether a radio tuner is receiving a stereo signal.</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"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isStereo</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="qradiotuner.html#stereoStatusChanged">stereoStatusChanged</a></b></span> ( bool <i>stereo</i> )</td></tr>
</table>
<!-- @@@stereo -->
<!-- $$$stereoMode-prop$$$stereoMode$$$setStereoModeQRadioTuner::StereoMode -->
<h3 class="fn"><a name="stereoMode-prop"></a><span class="name">stereoMode</span> : <span class="type"><a href="qradiotuner.html#StereoMode-enum">StereoMode</a></span></h3>
<p>This property holds the stereo mode of a radio tuner.</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"> StereoMode </td><td class="memItemRight bottomAlign"><span class="name"><b>stereoMode</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setStereoMode</b></span> ( QRadioTuner::StereoMode <i>mode</i> )</td></tr>
</table>
<!-- @@@stereoMode -->
<!-- $$$volume-prop$$$volume$$$setVolumeint$$$volumeChangedint -->
<h3 class="fn"><a name="volume-prop"></a><span class="name">volume</span> : <span class="type">int</span></h3>
<p>This property holds the volume of a radio tuner's audio output as a percentage.</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>volume</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setVolume</b></span> ( int <i>volume</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="qradiotuner.html#volumeChanged">volumeChanged</a></b></span> ( int <i>volume</i> )</td></tr>
</table>
<!-- @@@volume -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QRadioTuner[overload1]$$$QRadioTunerQObject*QMediaServiceProvider* -->
<h3 class="fn"><a name="QRadioTuner"></a>QRadioTuner::<span class="name">QRadioTuner</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> = 0, <span class="type"><a href="qmediaserviceprovider.html">QMediaServiceProvider</a></span> * <i>provider</i> = QMediaServiceProvider::defaultServiceProvider() )</h3>
<p>Constructs a radio tuner based on a media service allocated by a media service <i>provider</i>.</p>
<p>The <i>parent</i> is passed to <a href="qmediaobject.html">QMediaObject</a>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@QRadioTuner -->
<!-- $$$~QRadioTuner[overload1]$$$~QRadioTuner -->
<h3 class="fn"><a name="dtor.QRadioTuner"></a>QRadioTuner::<span class="name">~QRadioTuner</span> ()</h3>
<p>Destroys a radio tuner.</p>
<!-- @@@~QRadioTuner -->
<!-- $$$availabilityError[overload1]$$$availabilityError -->
<h3 class="fn"><a name="availabilityError"></a><span class="type"><a href="qtmultimediakit.html#AvailabilityError-enum">QtMultimediaKit::AvailabilityError</a></span> QRadioTuner::<span class="name">availabilityError</span> () const<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="qmediaobject.html#availabilityError">QMediaObject::availabilityError</a>().</p>
<p>Returns the availability error state.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@availabilityError -->
<!-- $$$bandChanged[overload1]$$$bandChangedQRadioTuner::Band -->
<h3 class="fn"><a name="bandChanged"></a><span class="type">void</span> QRadioTuner::<span class="name">bandChanged</span> ( <span class="type"><a href="qradiotuner.html#Band-enum">QRadioTuner::Band</a></span> <i>band</i> )<tt> [signal]</tt></h3>
<p>Signals a radio tuner's <i>band</i> has changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@bandChanged -->
<!-- $$$cancelSearch[overload1]$$$cancelSearch -->
<h3 class="fn"><a name="cancelSearch"></a><span class="type">void</span> QRadioTuner::<span class="name">cancelSearch</span> ()<tt> [slot]</tt></h3>
<p>Stops scanning for a signal.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qradiotuner.html#searchForward">searchForward</a>(), <a href="qradiotuner.html#searchBackward">searchBackward</a>(), and <a href="qradiotuner.html#searching-prop">searching</a>.</p>
<!-- @@@cancelSearch -->
<!-- $$$error[overload1]$$$error -->
<h3 class="fn"><a name="error"></a><span class="type"><a href="qradiotuner.html#Error-enum">Error</a></span> QRadioTuner::<span class="name">error</span> () const</h3>
<p>Returns the error state of a radio tuner.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qradiotuner.html#errorString">errorString</a>().</p>
<!-- @@@error -->
<!-- $$$error$$$errorQRadioTuner::Error -->
<h3 class="fn"><a name="error-2"></a><span class="type">void</span> QRadioTuner::<span class="name">error</span> ( <span class="type"><a href="qradiotuner.html#Error-enum">QRadioTuner::Error</a></span> <i>error</i> )<tt> [signal]</tt></h3>
<p>Signals that an <i>error</i> occurred.</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> QRadioTuner::<span class="name">errorString</span> () const</h3>
<p>Returns a description of a radio tuner's error state.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qradiotuner.html#error">error</a>().</p>
<!-- @@@errorString -->
<!-- $$$frequencyChanged[overload1]$$$frequencyChangedint -->
<h3 class="fn"><a name="frequencyChanged"></a><span class="type">void</span> QRadioTuner::<span class="name">frequencyChanged</span> ( <span class="type">int</span> <i>frequency</i> )<tt> [signal]</tt></h3>
<p>Signals that the <i>frequency</i> a radio tuner is tuned to has changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@frequencyChanged -->
<!-- $$$frequencyRange[overload1]$$$frequencyRangeBand -->
<h3 class="fn"><a name="frequencyRange"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qpair.html">QPair</a></span>&lt;<span class="type">int</span>, <span class="type">int</span>&gt; QRadioTuner::<span class="name">frequencyRange</span> ( <span class="type"><a href="qradiotuner.html#Band-enum">Band</a></span> <i>band</i> ) const</h3>
<p>Returns a frequency <i>band</i>'s minimum and maximum frequency.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@frequencyRange -->
<!-- $$$frequencyStep[overload1]$$$frequencyStepBand -->
<h3 class="fn"><a name="frequencyStep"></a><span class="type">int</span> QRadioTuner::<span class="name">frequencyStep</span> ( <span class="type"><a href="qradiotuner.html#Band-enum">Band</a></span> <i>band</i> ) const</h3>
<p>Returns the number of Hertz to increment the frequency by when stepping through frequencies within a given <i>band</i>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@frequencyStep -->
<!-- $$$isAvailable[overload1]$$$isAvailable -->
<h3 class="fn"><a name="isAvailable"></a><span class="type">bool</span> QRadioTuner::<span class="name">isAvailable</span> () const<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="qmediaobject.html#isAvailable">QMediaObject::isAvailable</a>().</p>
<p>Returns true if the radio tuner service is ready to use.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@isAvailable -->
<!-- $$$isBandSupported[overload1]$$$isBandSupportedBand -->
<h3 class="fn"><a name="isBandSupported"></a><span class="type">bool</span> QRadioTuner::<span class="name">isBandSupported</span> ( <span class="type"><a href="qradiotuner.html#Band-enum">Band</a></span> <i>band</i> ) const</h3>
<p>Identifies if a frequency <i>band</i> is supported by a radio tuner.</p>
<p>Returns true if the band is supported, and false if it is not.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@isBandSupported -->
<!-- $$$mutedChanged[overload1]$$$mutedChangedbool -->
<h3 class="fn"><a name="mutedChanged"></a><span class="type">void</span> QRadioTuner::<span class="name">mutedChanged</span> ( <span class="type">bool</span> <i>muted</i> )<tt> [signal]</tt></h3>
<p>Signals that the <i>muted</i> state of a radio tuner's audio output has changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@mutedChanged -->
<!-- $$$searchBackward[overload1]$$$searchBackward -->
<h3 class="fn"><a name="searchBackward"></a><span class="type">void</span> QRadioTuner::<span class="name">searchBackward</span> ()<tt> [slot]</tt></h3>
<p>Starts a backwards scan for a signal, starting from the current <a href="qradiotuner.html#frequency-prop">frequency</a>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qradiotuner.html#searchForward">searchForward</a>(), <a href="qradiotuner.html#cancelSearch">cancelSearch</a>(), and <a href="qradiotuner.html#searching-prop">searching</a>.</p>
<!-- @@@searchBackward -->
<!-- $$$searchForward[overload1]$$$searchForward -->
<h3 class="fn"><a name="searchForward"></a><span class="type">void</span> QRadioTuner::<span class="name">searchForward</span> ()<tt> [slot]</tt></h3>
<p>Starts a forward scan for a signal, starting from the current <a href="qradiotuner.html#frequency-prop">frequency</a>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qradiotuner.html#searchBackward">searchBackward</a>(), <a href="qradiotuner.html#cancelSearch">cancelSearch</a>(), and <a href="qradiotuner.html#searching-prop">searching</a>.</p>
<!-- @@@searchForward -->
<!-- $$$searchingChanged[overload1]$$$searchingChangedbool -->
<h3 class="fn"><a name="searchingChanged"></a><span class="type">void</span> QRadioTuner::<span class="name">searchingChanged</span> ( <span class="type">bool</span> <i>searching</i> )<tt> [signal]</tt></h3>
<p>Signals that the <i>searching</i> state of a radio tuner has changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@searchingChanged -->
<!-- $$$signalStrengthChanged[overload1]$$$signalStrengthChangedint -->
<h3 class="fn"><a name="signalStrengthChanged"></a><span class="type">void</span> QRadioTuner::<span class="name">signalStrengthChanged</span> ( <span class="type">int</span> <i>strength</i> )<tt> [signal]</tt></h3>
<p>Signals that the <i>strength</i> of the signal received by a radio tuner has changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@signalStrengthChanged -->
<!-- $$$start[overload1]$$$start -->
<h3 class="fn"><a name="start"></a><span class="type">void</span> QRadioTuner::<span class="name">start</span> ()<tt> [slot]</tt></h3>
<p>Activate the radio device.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@start -->
<!-- $$$stateChanged[overload1]$$$stateChangedQRadioTuner::State -->
<h3 class="fn"><a name="stateChanged"></a><span class="type">void</span> QRadioTuner::<span class="name">stateChanged</span> ( <span class="type"><a href="qradiotuner.html#State-enum">QRadioTuner::State</a></span> <i>state</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted when the state changes to <i>state</i>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@stateChanged -->
<!-- $$$stereoStatusChanged[overload1]$$$stereoStatusChangedbool -->
<h3 class="fn"><a name="stereoStatusChanged"></a><span class="type">void</span> QRadioTuner::<span class="name">stereoStatusChanged</span> ( <span class="type">bool</span> <i>stereo</i> )<tt> [signal]</tt></h3>
<p>Signals that the <i>stereo</i> state of a radio tuner has changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@stereoStatusChanged -->
<!-- $$$stop[overload1]$$$stop -->
<h3 class="fn"><a name="stop"></a><span class="type">void</span> QRadioTuner::<span class="name">stop</span> ()<tt> [slot]</tt></h3>
<p>Deactivate the radio device.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@stop -->
<!-- $$$volumeChanged[overload1]$$$volumeChangedint -->
<h3 class="fn"><a name="volumeChanged"></a><span class="type">void</span> QRadioTuner::<span class="name">volumeChanged</span> ( <span class="type">int</span> <i>volume</i> )<tt> [signal]</tt></h3>
<p>Signals that the <i>volume</i> of a radio tuner's audio output has changed.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@volumeChanged -->
</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>