/usr/share/qt5/doc/qtnfc/qnearfieldsharemanager.html is in qtconnectivity5-doc-html 5.5.1-2build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qnearfieldsharemanager.cpp -->
<title>QNearFieldShareManager Class | Qt NFC 5.5</title>
<link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<ul>
<li>Qt 5.5</li>
<li><a href="qtnfc-index.html">Qt NFC</a></li>
<li><a href="qtnfc-module.html">C++ Classes</a></li>
<li>QNearFieldShareManager</li>
<li id="buildversion">Qt 5.5.1 Reference Documentation</li>
</ul>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<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="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#static-public-members">Static Public Members</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">QNearFieldShareManager Class</h1>
<!-- $$$QNearFieldShareManager-brief -->
<p>The <a href="qnearfieldsharemanager.html">QNearFieldShareManager</a> class manages all interactions related to sharing files and data over NFC. <a href="#details">More...</a></p>
<!-- @@@QNearFieldShareManager -->
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> Header:</td><td class="memItemRight bottomAlign"> <span class="preprocessor">#include <QNearFieldShareManager></span>
</td></tr><tr><td class="memItemLeft rightAlign topAlign"> qmake:</td><td class="memItemRight bottomAlign"> QT += nfc</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Since:</td><td class="memItemRight bottomAlign"> Qt 5.3</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Inherits:</td><td class="memItemRight bottomAlign"> <a href="../qtcore/qobject.html">QObject</a></td></tr></table></div><ul>
<li><a href="qnearfieldsharemanager-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2 id="public-types">Public Types</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#ShareError-enum">ShareError</a></b> { NoError, UnknownError, InvalidShareContentError, ShareCanceledError, ..., SharePermissionDeniedError }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#ShareMode-enum">ShareMode</a></b> { NoShare, NdefShare, FileShare }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> flags </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#ShareMode-enum">ShareModes</a></b></td></tr>
</table></div>
<a name="public-functions"></a>
<h2 id="public-functions">Public Functions</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#QNearFieldShareManager">QNearFieldShareManager</a></b>(QObject *<i> parent</i> = 0)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#dtor.QNearFieldShareManager">~QNearFieldShareManager</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#setShareModes">setShareModes</a></b>(ShareModes<i> mode</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QNearFieldShareManager::ShareError </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#shareError">shareError</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QNearFieldShareManager::ShareModes </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#shareModes">shareModes</a></b>() const</td></tr>
</table></div>
<ul>
<li class="fn">31 public functions inherited from <a href="../qtcore/qobject.html#public-functions">QObject</a></li>
</ul>
<a name="signals"></a>
<h2 id="signals">Signals</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#error">error</a></b>(QNearFieldShareManager::ShareError<i> error</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#shareModesChanged">shareModesChanged</a></b>(QNearFieldShareManager::ShareModes<i> modes</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#targetDetected">targetDetected</a></b>(QNearFieldShareTarget *<i> shareTarget</i>)</td></tr>
</table></div>
<ul>
<li class="fn">2 signals inherited from <a href="../qtcore/qobject.html#signals">QObject</a></li>
</ul>
<a name="static-public-members"></a>
<h2 id="static-public-members">Static Public Members</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> QNearFieldShareManager::ShareModes </td><td class="memItemRight bottomAlign"><b><a href="qnearfieldsharemanager.html#supportedShareModes">supportedShareModes</a></b>()</td></tr>
</table></div>
<ul>
<li class="fn">10 static public members inherited from <a href="../qtcore/qobject.html#static-public-members">QObject</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">1 property inherited from <a href="../qtcore/qobject.html#properties">QObject</a></li>
<li class="fn">1 public slot inherited from <a href="../qtcore/qobject.html#public-slots">QObject</a></li>
<li class="fn">1 public variable inherited from <a href="../qtcore/qobject.html#public-variables">QObject</a></li>
<li class="fn">9 protected functions inherited from <a href="../qtcore/qobject.html#protected-functions">QObject</a></li>
<li class="fn">2 protected variables inherited from <a href="../qtcore/qobject.html#protected-variables">QObject</a></li>
</ul>
<a name="details"></a>
<!-- $$$QNearFieldShareManager-description -->
<div class="descr">
<h2 id="details">Detailed Description</h2>
<p>The <a href="qnearfieldsharemanager.html">QNearFieldShareManager</a> class manages all interactions related to sharing files and data over NFC.</p>
<p>Applications can share NDEF data or file content using NFC technology by tapping two NFC-enabled devices together. The <a href="qnearfieldsharemanager.html">QNearFieldShareManager</a> provides a high level entry point to access this functionality.</p>
<p>The class allows both NDEF data and/or files to be shared between two devices by calling the <a href="qnearfieldsharemanager.html#setShareModes">setShareModes</a>() method. This method specifies either an NDEF Data and/or a File transfer. The <a href="qnearfieldsharemanager.html#targetDetected">targetDetected</a>() signal is emitted each time a share target is detected. A <a href="qnearfieldsharetarget.html">QNearFieldShareTarget</a> pointer is passed with the signal, which can be used to share either an NDEF message or one or more files.</p>
<p>The process of sharing files via NFC involves other underlying communication transports such as Bluetooth or Wi-Fi Direct. It is implementation specific how and what type of transports are used to perform file transfer. The overall time taken to transfer content depends on the maximum speed of the transport used. Note that the process of sharing NDEF message/data does not require the use of other transports outside NFC.</p>
<p>If an error occurs, <a href="qnearfieldsharemanager.html#shareError">shareError</a>() returns the error type.</p>
<p>Platforms that do not support both NDEF data and file content sharing modes can return the supported subset in the <a href="qnearfieldsharemanager.html#supportedShareModes">supportedShareModes</a>() method. Applications that call <a href="qnearfieldsharemanager.html#setShareModes">setShareModes</a>() with an unsupported mode will receive an error signal with a <a href="qnearfieldsharemanager.html#ShareError-enum">UnsupportedShareModeError</a>.</p>
<p>Since sharing data over NFC is effectively a data pipe between two processes (one on the sender and one of the receiver), the application developer should only create a single instance of <a href="qnearfieldsharemanager.html">QNearFieldShareManager</a> per application. This avoids the possibility that different parts of the same application attempt to all consume data transferred over NFC.</p>
</div>
<!-- @@@QNearFieldShareManager -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$ShareError$$$NoError$$$UnknownError$$$InvalidShareContentError$$$ShareCanceledError$$$ShareInterruptedError$$$ShareRejectedError$$$UnsupportedShareModeError$$$ShareAlreadyInProgressError$$$SharePermissionDeniedError -->
<h3 class="fn" id="ShareError-enum"><a name="ShareError-enum"></a>enum QNearFieldShareManager::<span class="name">ShareError</span></h3>
<p>This enum specifies the share error type.</p>
<div class="table"><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"><code>QNearFieldShareManager::NoError</code></td><td class="topAlign"><code>0</code></td><td class="topAlign">No error.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::UnknownError</code></td><td class="topAlign"><code>1</code></td><td class="topAlign">Unknown or internal error occurred.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::InvalidShareContentError</code></td><td class="topAlign"><code>2</code></td><td class="topAlign">Invalid content was provided for sharing.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::ShareCanceledError</code></td><td class="topAlign"><code>3</code></td><td class="topAlign">Data or file sharing is canceled on the local or remote device.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::ShareInterruptedError</code></td><td class="topAlign"><code>4</code></td><td class="topAlign">Data or file sharing is interrupted due to an I/O error.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::ShareRejectedError</code></td><td class="topAlign"><code>5</code></td><td class="topAlign">Data or file sharing is rejected by the remote device.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::UnsupportedShareModeError</code></td><td class="topAlign"><code>6</code></td><td class="topAlign">Data or file sharing is not supported by the share target.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::ShareAlreadyInProgressError</code></td><td class="topAlign"><code>7</code></td><td class="topAlign">Data or file sharing is already in progress.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::SharePermissionDeniedError</code></td><td class="topAlign"><code>8</code></td><td class="topAlign">File sharing is denied due to insufficient permission.</td></tr>
</table></div>
<!-- @@@ShareError -->
<!-- $$$ShareMode$$$NoShare$$$NdefShare$$$FileShare -->
<h3 class="flags" id="ShareMode-enum"><a name="ShareMode-enum"></a>enum QNearFieldShareManager::<span class="name">ShareMode</span><br/>flags QNearFieldShareManager::<span class="name">ShareModes</span></h3>
<p>This enum specifies the content type to be shared.</p>
<div class="table"><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"><code>QNearFieldShareManager::NoShare</code></td><td class="topAlign"><code>0x00</code></td><td class="topAlign">No content is currently set to be shared.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::NdefShare</code></td><td class="topAlign"><code>0x01</code></td><td class="topAlign">Share NDEF message with target.</td></tr>
<tr><td class="topAlign"><code>QNearFieldShareManager::FileShare</code></td><td class="topAlign"><code>0x02</code></td><td class="topAlign">Share file with target.</td></tr>
</table></div>
<p>The ShareModes type is a typedef for <a href="../qtcore/qflags.html">QFlags</a><ShareMode>. It stores an OR combination of ShareMode values.</p>
<!-- @@@ShareMode -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QNearFieldShareManager[overload1]$$$QNearFieldShareManagerQObject* -->
<h3 class="fn" id="QNearFieldShareManager"><a name="QNearFieldShareManager"></a>QNearFieldShareManager::<span class="name">QNearFieldShareManager</span>(<span class="type"><a href="../qtcore/qobject.html#QObject">QObject</a></span> *<i> parent</i> = 0)</h3>
<p>Constructs a new near field share manager with <i>parent</i>.</p>
<!-- @@@QNearFieldShareManager -->
<!-- $$$~QNearFieldShareManager[overload1]$$$~QNearFieldShareManager -->
<h3 class="fn" id="dtor.QNearFieldShareManager"><a name="dtor.QNearFieldShareManager"></a>QNearFieldShareManager::<span class="name">~QNearFieldShareManager</span>()</h3>
<p>Destroys the near field share manager.</p>
<!-- @@@~QNearFieldShareManager -->
<!-- $$$error[overload1]$$$errorQNearFieldShareManager::ShareError -->
<h3 class="fn" id="error"><a name="error"></a><code>[signal] </code><span class="type">void</span> QNearFieldShareManager::<span class="name">error</span>(<span class="type"><a href="qnearfieldsharemanager.html#ShareError-enum">QNearFieldShareManager::ShareError</a></span><i> error</i>)</h3>
<p>This signal is emitted whenever an <i>error</i> occurs related to a share request.</p>
<!-- @@@error -->
<!-- $$$setShareModes[overload1]$$$setShareModesShareModes -->
<h3 class="fn" id="setShareModes"><a name="setShareModes"></a><span class="type">void</span> QNearFieldShareManager::<span class="name">setShareModes</span>(<span class="type"><a href="qnearfieldsharemanager.html#ShareMode-enum">ShareModes</a></span><i> mode</i>)</h3>
<p>Initializes the NFC share <i>mode</i> to detect a <a href="qnearfieldsharetarget.html">QNearFieldShareTarget</a> for data and/or file sharing. Calls to this method will overwrite previous share modes.</p>
<p>A <a href="qnearfieldsharemanager.html#shareModesChanged">shareModesChanged</a>() signal will be emitted when share modes are different from previous modes. A <a href="qnearfieldsharemanager.html#targetDetected">targetDetected</a>() signal will be emitted if a share target is detected.</p>
<p><b>See also </b><a href="qnearfieldsharemanager.html#shareModes">shareModes</a>().</p>
<!-- @@@setShareModes -->
<!-- $$$shareError[overload1]$$$shareError -->
<h3 class="fn" id="shareError"><a name="shareError"></a><span class="type"><a href="qnearfieldsharemanager.html#ShareError-enum">QNearFieldShareManager::ShareError</a></span> QNearFieldShareManager::<span class="name">shareError</span>() const</h3>
<p>Returns the error code of the error that occurred.</p>
<!-- @@@shareError -->
<!-- $$$shareModes[overload1]$$$shareModes -->
<h3 class="fn" id="shareModes"><a name="shareModes"></a><span class="type"><a href="qnearfieldsharemanager.html#ShareMode-enum">QNearFieldShareManager::ShareModes</a></span> QNearFieldShareManager::<span class="name">shareModes</span>() const</h3>
<p>Returns which shared modes are set.</p>
<p><b>See also </b><a href="qnearfieldsharemanager.html#setShareModes">setShareModes</a>().</p>
<!-- @@@shareModes -->
<!-- $$$shareModesChanged[overload1]$$$shareModesChangedQNearFieldShareManager::ShareModes -->
<h3 class="fn" id="shareModesChanged"><a name="shareModesChanged"></a><code>[signal] </code><span class="type">void</span> QNearFieldShareManager::<span class="name">shareModesChanged</span>(<span class="type"><a href="qnearfieldsharemanager.html#ShareMode-enum">QNearFieldShareManager::ShareModes</a></span><i> modes</i>)</h3>
<p>This signal is emitted whenever the share <i>modes</i> are changed.</p>
<!-- @@@shareModesChanged -->
<!-- $$$supportedShareModes[overload1]$$$supportedShareModes -->
<h3 class="fn" id="supportedShareModes"><a name="supportedShareModes"></a><code>[static] </code><span class="type"><a href="qnearfieldsharemanager.html#ShareMode-enum">QNearFieldShareManager::ShareModes</a></span> QNearFieldShareManager::<span class="name">supportedShareModes</span>()</h3>
<p>Returns the shared modes supported by NFC.</p>
<!-- @@@supportedShareModes -->
<!-- $$$targetDetected[overload1]$$$targetDetectedQNearFieldShareTarget* -->
<h3 class="fn" id="targetDetected"><a name="targetDetected"></a><code>[signal] </code><span class="type">void</span> QNearFieldShareManager::<span class="name">targetDetected</span>(<span class="type"><a href="qnearfieldsharetarget.html">QNearFieldShareTarget</a></span> *<i> shareTarget</i>)</h3>
<p>This signal is emitted whenever a <i>shareTarget</i> is detected. The <i>shareTarget</i> instance is owned by <a href="qnearfieldsharemanager.html">QNearFieldShareManager</a> and must not be deleted by the application.</p>
<!-- @@@targetDetected -->
</div>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.<br> The documentation provided herein is licensed 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.<br> Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. </p>
</div>
</body>
</html>
|