<?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" />
<!-- qlandmarkcategoryfetchbyidrequest.cpp -->
<title>Qt Mobility 1.2: QLandmarkCategoryFetchByIdRequest 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="qtlocation.html">QtLocation</a></li>
<li>QLandmarkCategoryFetchByIdRequest</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="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QLandmarkCategoryFetchByIdRequest Class Reference</h1>
<!-- $$$QLandmarkCategoryFetchByIdRequest-brief -->
<p>The QLandmarkCategoryFetchByIdRequest class allows a client to asynchronously request a list of categories by ID from a landmark manager. <a href="#details">More...</a></p>
<!-- @@@QLandmarkCategoryFetchByIdRequest -->
<pre class="cpp"> <span class="preprocessor">#include <QLandmarkCategoryFetchByIdRequest></span></pre><p><b>Inherits: </b><a href="qlandmarkabstractrequest.html">QLandmarkAbstractRequest</a>.</p>
<p>This class was introduced in Qt Mobility 1.1.</p>
<ul>
<li><a href="qlandmarkcategoryfetchbyidrequest-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="qlandmarkcategoryfetchbyidrequest.html#QLandmarkCategoryFetchByIdRequest">QLandmarkCategoryFetchByIdRequest</a></b> ( QLandmarkManager * <i>manager</i>, QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkcategoryfetchbyidrequest.html#dtor.QLandmarkCategoryFetchByIdRequest">~QLandmarkCategoryFetchByIdRequest</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QLandmarkCategory> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkcategoryfetchbyidrequest.html#categories">categories</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QLandmarkCategoryId> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkcategoryfetchbyidrequest.html#categoryIds">categoryIds</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMap<int, QLandmarkManager::Error> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkcategoryfetchbyidrequest.html#errorMap">errorMap</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkcategoryfetchbyidrequest.html#setCategoryId">setCategoryId</a></b> ( const QLandmarkCategoryId & <i>categoryId</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkcategoryfetchbyidrequest.html#setCategoryIds">setCategoryIds</a></b> ( const QList<QLandmarkCategoryId> & <i>categoryIds</i> )</td></tr>
</table>
<ul>
<li class="fn">9 public functions inherited from <a href="qlandmarkabstractrequest.html#public-functions">QLandmarkAbstractRequest</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>
<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">3 public slots inherited from <a href="qlandmarkabstractrequest.html#public-slots">QLandmarkAbstractRequest</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">2 signals inherited from <a href="qlandmarkabstractrequest.html#signals">QLandmarkAbstractRequest</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">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>
<!-- $$$QLandmarkCategoryFetchByIdRequest-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QLandmarkCategoryFetchByIdRequest class allows a client to asynchronously request a list of categories by ID from a landmark manager.</p>
<p>The categories fetched by the manager should have a one-to-one correspondence to the IDs passed into this class. That is, the nth category in the returned list should have an ID which is equal to the nth ID in the list of IDs. Any invalid ID should correspond to an empty <a href="qlandmarkcategory.html">QLandmarkCategory</a>.</p>
<p>For a QLandmarkCategoryFetchByIdRequest, the <a href="qlandmarkabstractrequest.html#resultsAvailable">resultsAvailable</a>() signal will be emitted as resultant categories are found (these are retrievable by calling <a href="qlandmarkcategoryfetchbyidrequest.html#categories">categories</a>()), whenever individual items error out(individual errors may be retrieved by calling <a href="qlandmarkcategoryfetchbyidrequest.html#errorMap">errorMap</a>()), as well as if an overall operation error occurred(which may be retrieved by calling <a href="qlandmarkabstractrequest.html#error">QLandmarkAbstractRequest::error</a>()).</p>
<p>Please see the class documentation for <a href="qlandmarkabstractrequest.html">QLandmarkAbstractRequest</a> for more information about he usage of request classes and ownership semantics.</p>
</div>
<!-- @@@QLandmarkCategoryFetchByIdRequest -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QLandmarkCategoryFetchByIdRequest[overload1]$$$QLandmarkCategoryFetchByIdRequestQLandmarkManager*QObject* -->
<h3 class="fn"><a name="QLandmarkCategoryFetchByIdRequest"></a>QLandmarkCategoryFetchByIdRequest::<span class="name">QLandmarkCategoryFetchByIdRequest</span> ( <span class="type"><a href="qlandmarkmanager.html">QLandmarkManager</a></span> * <i>manager</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> = 0 )</h3>
<p>Creates a new a request object with the given <i>manager</i> and <i>parent</i>.</p>
<!-- @@@QLandmarkCategoryFetchByIdRequest -->
<!-- $$$~QLandmarkCategoryFetchByIdRequest[overload1]$$$~QLandmarkCategoryFetchByIdRequest -->
<h3 class="fn"><a name="dtor.QLandmarkCategoryFetchByIdRequest"></a>QLandmarkCategoryFetchByIdRequest::<span class="name">~QLandmarkCategoryFetchByIdRequest</span> ()</h3>
<p>Destroys the request object.</p>
<!-- @@@~QLandmarkCategoryFetchByIdRequest -->
<!-- $$$categories[overload1]$$$categories -->
<h3 class="fn"><a name="categories"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkcategory.html">QLandmarkCategory</a></span>> QLandmarkCategoryFetchByIdRequest::<span class="name">categories</span> () const</h3>
<p>Returns the list of categories fetched by this request</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@categories -->
<!-- $$$categoryIds[overload1]$$$categoryIds -->
<h3 class="fn"><a name="categoryIds"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span>> QLandmarkCategoryFetchByIdRequest::<span class="name">categoryIds</span> () const</h3>
<p>Returns a list of identifiers of categories which are to be retrieved by this request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkcategoryfetchbyidrequest.html#setCategoryIds">setCategoryIds</a>().</p>
<!-- @@@categoryIds -->
<!-- $$$errorMap[overload1]$$$errorMap -->
<h3 class="fn"><a name="errorMap"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><<span class="type">int</span>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span>> QLandmarkCategoryFetchByIdRequest::<span class="name">errorMap</span> () const</h3>
<p>Returns the mapping of input category id list indices to the errors which occurred.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@errorMap -->
<!-- $$$setCategoryId[overload1]$$$setCategoryIdconstQLandmarkCategoryId& -->
<h3 class="fn"><a name="setCategoryId"></a><span class="type">void</span> QLandmarkCategoryFetchByIdRequest::<span class="name">setCategoryId</span> ( const <span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span> & <i>categoryId</i> )</h3>
<p>Convenience function that sets a single category, specified by <i>categoryId</i>, to be retrieved by this request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@setCategoryId -->
<!-- $$$setCategoryIds[overload1]$$$setCategoryIdsconstQList<QLandmarkCategoryId>& -->
<h3 class="fn"><a name="setCategoryIds"></a><span class="type">void</span> QLandmarkCategoryFetchByIdRequest::<span class="name">setCategoryIds</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span>> & <i>categoryIds</i> )</h3>
<p>Sets this request to retrieve a list of categories identified by <i>categoryIds</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkcategoryfetchbyidrequest.html#categoryIds">categoryIds</a>().</p>
<!-- @@@setCategoryIds -->
</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
>
968
