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
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
|
<?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" />
<!-- qhelpenginecore.cpp -->
<title>Qt 4.7: QHelpEngineCore Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
</head>
<body class="offline narrow creator">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.nokia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://developer.qt.nokia.com/">DEV</a></li>
<li class="nav-topright-labs"><a href="http://labs.qt.nokia.com/blogs/">LABS</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://doc.qt.nokia.com/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.nokia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.7</a></span></li>
<li class="shortCut-topleft-active"><a href="http://doc.qt.nokia.com">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu sf-js-enabled sf-shadow" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul id="topmenuLook">
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="licensing.html">Licenses and Credits</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul id="topmenuTopic">
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UI's & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="developing-with-qt.html">Cross-platform and Platform-specific</a></li>
<li><a href="platform-specific.html">Platform-specific info</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul id="topmenuexample">
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UI's & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="developing-with-qt.html">Cross-platform and Platform-specific</a></li>
<li class="defaultLink"><a href="platform-specific.html">Platform-specific info</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Bread crumbs goes here -->
<li><a href="modules.html">Modules</a></li> <li><a href="qthelp.html">QtHelp</a></li>
<li>QHelpEngineCore</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<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="#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>
<h1 class="title">QHelpEngineCore Class Reference</h1>
<!-- $$$QHelpEngineCore-brief -->
<p>The QHelpEngineCore class provides the core functionality of the help system. <a href="#details">More...</a></p>
<!-- @@@QHelpEngineCore -->
<pre class="highlightedCode brush: cpp"> #include <QHelpEngineCore></pre><p>Inherits <a href="qobject.html">QObject</a>.</p>
<p>Inherited by <a href="qhelpengine.html">QHelpEngine</a>.</p>
<p>This class was introduced in Qt 4.4.</p>
<ul>
<li><a href="qhelpenginecore-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="properties"></a>
<h2>Properties</h2>
<ul>
<li class="fn"><b><a href="qhelpenginecore.html#autoSaveFilter-prop">autoSaveFilter</a></b> : bool</li>
<li class="fn"><b><a href="qhelpenginecore.html#collectionFile-prop">collectionFile</a></b> : QString</li>
<li class="fn"><b><a href="qhelpenginecore.html#currentFilter-prop">currentFilter</a></b> : QString</li>
</ul>
<ul>
<li class="fn">1 property inherited from <a href="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="qhelpenginecore.html#QHelpEngineCore">QHelpEngineCore</a></b> ( const QString & <i>collectionFile</i>, QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#dtor.QHelpEngineCore">~QHelpEngineCore</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#addCustomFilter">addCustomFilter</a></b> ( const QString & <i>filterName</i>, const QStringList & <i>attributes</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#autoSaveFilter-prop">autoSaveFilter</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#collectionFile-prop">collectionFile</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#copyCollectionFile">copyCollectionFile</a></b> ( const QString & <i>fileName</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#currentFilter-prop">currentFilter</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#customFilters">customFilters</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QVariant </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#customValue">customValue</a></b> ( const QString & <i>key</i>, const QVariant & <i>defaultValue</i> = QVariant() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#documentationFileName">documentationFileName</a></b> ( const QString & <i>namespaceName</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#error">error</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QByteArray </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#fileData">fileData</a></b> ( const QUrl & <i>url</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QUrl> </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#files">files</a></b> ( const QString <i>namespaceName</i>, const QStringList & <i>filterAttributes</i>, const QString & <i>extensionFilter</i> = QString() )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QStringList> </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#filterAttributeSets">filterAttributeSets</a></b> ( const QString & <i>namespaceName</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#filterAttributes">filterAttributes</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#filterAttributes-2">filterAttributes</a></b> ( const QString & <i>filterName</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QUrl </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#findFile">findFile</a></b> ( const QUrl & <i>url</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMap<QString, QUrl> </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#linksForIdentifier">linksForIdentifier</a></b> ( const QString & <i>id</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#registerDocumentation">registerDocumentation</a></b> ( const QString & <i>documentationFileName</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#registeredDocumentations">registeredDocumentations</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#removeCustomFilter">removeCustomFilter</a></b> ( const QString & <i>filterName</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#removeCustomValue">removeCustomValue</a></b> ( const QString & <i>key</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#autoSaveFilter-prop">setAutoSaveFilter</a></b> ( bool <i>save</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#collectionFile-prop">setCollectionFile</a></b> ( const QString & <i>fileName</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#currentFilter-prop">setCurrentFilter</a></b> ( const QString & <i>filterName</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#setCustomValue">setCustomValue</a></b> ( const QString & <i>key</i>, const QVariant & <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#setupData">setupData</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#unregisterDocumentation">unregisterDocumentation</a></b> ( const QString & <i>namespaceName</i> )</td></tr>
</table>
<ul>
<li class="fn">29 public functions inherited from <a href="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="qhelpenginecore.html#currentFilterChanged">currentFilterChanged</a></b> ( const QString & <i>newFilter</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#setupFinished">setupFinished</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#setupStarted">setupStarted</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#warning">warning</a></b> ( const QString & <i>msg</i> )</td></tr>
</table>
<ul>
<li class="fn">1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
</ul>
<a name="static-public-members"></a>
<h2>Static Public Members</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> QVariant </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#metaData">metaData</a></b> ( const QString & <i>documentationFileName</i>, const QString & <i>name</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qhelpenginecore.html#namespaceName">namespaceName</a></b> ( const QString & <i>documentationFileName</i> )</td></tr>
</table>
<ul>
<li class="fn">5 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li>
<li class="fn">7 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
</ul>
<a name="details"></a>
<!-- $$$QHelpEngineCore-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QHelpEngineCore class provides the core functionality of the help system.</p>
<p>Before the help engine can be used, it must be initialized by calling <a href="qhelpenginecore.html#setupData">setupData</a>(). At the beginning of the setup process the signal <a href="qhelpenginecore.html#setupStarted">setupStarted</a>() is emitted. From this point on until the signal <a href="qhelpenginecore.html#setupFinished">setupFinished</a>() is emitted, is the help data in an undefined meaning unusable state.</p>
<p>The core help engine can be used to perform different tasks. By calling <a href="qhelpenginecore.html#linksForIdentifier">linksForIdentifier</a>() the engine returns urls specifying the file locations inside the help system. The actual file data can then be retrived by calling <a href="qhelpenginecore.html#fileData">fileData</a>(). In contrast to all other functions in this class, <a href="qhelpenginecore.html#linksForIdentifier">linksForIdentifier</a>() depends on the currently set custom filter. Depending on the filter, the function may return different hits.</p>
<p>Every help engine can contain any number of custom filters. A custom filter is defined by a name and set of filter attributes and can be added to the help engine by calling <a href="qhelpenginecore.html#addCustomFilter">addCustomFilter</a>(). Analogous, it is removed by calling <a href="qhelpenginecore.html#removeCustomFilter">removeCustomFilter</a>(). <a href="qhelpenginecore.html#customFilters">customFilters</a>() returns all defined filters.</p>
<p>The help engine also offers the possibility to set and read values in a persistant way comparable to ini files or Windows registry entries. For more information see setValue() or value().</p>
<p>This class does not offer any GUI components or functionality for indices or contents. If you need one of those use <a href="qhelpengine.html">QHelpEngine</a> instead.</p>
<p>When creating a custom help viewer the viewer can be configured by writing a custom collection file which could contain various keywords to be used to configure the help engine. These keywords and values and their meaning can be found in the help information for <a href="assistant-custom-help-viewer.html#creating-a-custom-help-collection-file">creating a custom help collection file</a> for Assistant.</p>
</div>
<!-- @@@QHelpEngineCore -->
<div class="prop">
<h2>Property Documentation</h2>
<!-- $$$autoSaveFilter-prop$$$autoSaveFilter$$$setAutoSaveFilterbool -->
<h3 class="fn"><a name="autoSaveFilter-prop"></a>autoSaveFilter : bool</h3>
<p>This property holds whether QHelpEngineCore is in auto save filter mode or not.</p>
<p>If <a href="qhelpenginecore.html">QHelpEngineCore</a> is in auto save filter mode, the current filter is automatically saved when it is changed by the <a href="qhelpenginecore.html#currentFilter-prop">setCurrentFilter</a>() function. The filter is saved persistently in the help collection file.</p>
<p>By default, this mode is on.</p>
<p>This property was introduced in Qt 4.5.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><b>autoSaveFilter</b> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><b>setAutoSaveFilter</b> ( bool <i>save</i> )</td></tr>
</table>
<!-- @@@autoSaveFilter -->
<!-- $$$collectionFile-prop$$$collectionFile$$$setCollectionFileconstQString& -->
<h3 class="fn"><a name="collectionFile-prop"></a>collectionFile : <a href="qstring.html">QString</a></h3>
<p>This property holds the absolute file name of the collection file currently used.</p>
<p>Setting this property leaves the help engine in an invalid state. It is important to invoke <a href="qhelpenginecore.html#setupData">setupData</a>() or any getter function in order to setup the help engine again.</p>
<p>This property was introduced in Qt 4.5.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QString </td><td class="memItemRight bottomAlign"><b>collectionFile</b> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><b>setCollectionFile</b> ( const QString & <i>fileName</i> )</td></tr>
</table>
<!-- @@@collectionFile -->
<!-- $$$currentFilter-prop$$$currentFilter$$$setCurrentFilterconstQString& -->
<h3 class="fn"><a name="currentFilter-prop"></a>currentFilter : <a href="qstring.html">QString</a></h3>
<p>This property holds the name of the custom filter currently applied.</p>
<p>Setting this property will save the new custom filter permanently in the help collection file. To set a custom filter without saving it permanently, disable the auto save filter mode.</p>
<p>This property was introduced in Qt 4.5.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QString </td><td class="memItemRight bottomAlign"><b>currentFilter</b> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><b>setCurrentFilter</b> ( const QString & <i>filterName</i> )</td></tr>
</table>
<p>See also <a href="qhelpenginecore.html#autoSaveFilter-prop">autoSaveFilter</a>().</p>
<!-- @@@currentFilter -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QHelpEngineCore[overload1]$$$QHelpEngineCoreconstQString&QObject* -->
<h3 class="fn"><a name="QHelpEngineCore"></a>QHelpEngineCore::QHelpEngineCore ( const <a href="qstring.html">QString</a> & <i>collectionFile</i>, <a href="qobject.html">QObject</a> * <i>parent</i> = 0 )</h3>
<p>Constructs a new core help engine with a <i>parent</i>. The help engine uses the information stored in the <i>collectionFile</i> to provide help. If the collection file does not exist yet, it'll be created.</p>
<!-- @@@QHelpEngineCore -->
<!-- $$$~QHelpEngineCore[overload1]$$$~QHelpEngineCore -->
<h3 class="fn"><a name="dtor.QHelpEngineCore"></a>QHelpEngineCore::~QHelpEngineCore ()<tt> [virtual]</tt></h3>
<p>Destructs the help engine.</p>
<!-- @@@~QHelpEngineCore -->
<!-- $$$addCustomFilter[overload1]$$$addCustomFilterconstQString&constQStringList& -->
<h3 class="fn"><a name="addCustomFilter"></a>bool QHelpEngineCore::addCustomFilter ( const <a href="qstring.html">QString</a> & <i>filterName</i>, const <a href="qstringlist.html">QStringList</a> & <i>attributes</i> )</h3>
<p>Adds the new custom filter <i>filterName</i>. The filter attributes are specified by <i>attributes</i>. If the filter already exists, its attribute set is replaced. The function returns true if the operation succeeded, otherwise it returns false.</p>
<p>See also <a href="qhelpenginecore.html#customFilters">customFilters</a>() and <a href="qhelpenginecore.html#removeCustomFilter">removeCustomFilter</a>().</p>
<!-- @@@addCustomFilter -->
<!-- $$$copyCollectionFile[overload1]$$$copyCollectionFileconstQString& -->
<h3 class="fn"><a name="copyCollectionFile"></a>bool QHelpEngineCore::copyCollectionFile ( const <a href="qstring.html">QString</a> & <i>fileName</i> )</h3>
<p>Creates the file <i>fileName</i> and copies all contents from the current collection file into the newly created file, and returns true if successful; otherwise returns false.</p>
<p>The copying process makes sure that file references to Qt Collection files (<tt>.qch</tt>) files are updated accordingly.</p>
<!-- @@@copyCollectionFile -->
<!-- $$$currentFilterChanged[overload1]$$$currentFilterChangedconstQString& -->
<h3 class="fn"><a name="currentFilterChanged"></a>void QHelpEngineCore::currentFilterChanged ( const <a href="qstring.html">QString</a> & <i>newFilter</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted when the current filter is changed to <i>newFilter</i>.</p>
<!-- @@@currentFilterChanged -->
<!-- $$$customFilters[overload1]$$$customFilters -->
<h3 class="fn"><a name="customFilters"></a><a href="qstringlist.html">QStringList</a> QHelpEngineCore::customFilters () const</h3>
<p>Returns a list of custom filters.</p>
<p>See also <a href="qhelpenginecore.html#addCustomFilter">addCustomFilter</a>() and <a href="qhelpenginecore.html#removeCustomFilter">removeCustomFilter</a>().</p>
<!-- @@@customFilters -->
<!-- $$$customValue[overload1]$$$customValueconstQString&constQVariant& -->
<h3 class="fn"><a name="customValue"></a><a href="qvariant.html">QVariant</a> QHelpEngineCore::customValue ( const <a href="qstring.html">QString</a> & <i>key</i>, const <a href="qvariant.html">QVariant</a> & <i>defaultValue</i> = QVariant() ) const</h3>
<p>Returns the value assigned to the <i>key</i>. If the requested key does not exist, the specified <i>defaultValue</i> is returned.</p>
<p>See also <a href="qhelpenginecore.html#setCustomValue">setCustomValue</a>() and <a href="qhelpenginecore.html#removeCustomValue">removeCustomValue</a>().</p>
<!-- @@@customValue -->
<!-- $$$documentationFileName[overload1]$$$documentationFileNameconstQString& -->
<h3 class="fn"><a name="documentationFileName"></a><a href="qstring.html">QString</a> QHelpEngineCore::documentationFileName ( const <a href="qstring.html">QString</a> & <i>namespaceName</i> )</h3>
<p>Returns the absolute file name of the Qt compressed help file (.qch) identified by the <i>namespaceName</i>. If there is no Qt compressed help file with the specified namespace registered, an empty string is returned.</p>
<p>See also <a href="qhelpenginecore.html#namespaceName">namespaceName</a>().</p>
<!-- @@@documentationFileName -->
<!-- $$$error[overload1]$$$error -->
<h3 class="fn"><a name="error"></a><a href="qstring.html">QString</a> QHelpEngineCore::error () const</h3>
<p>Returns a description of the last error that occurred.</p>
<!-- @@@error -->
<!-- $$$fileData[overload1]$$$fileDataconstQUrl& -->
<h3 class="fn"><a name="fileData"></a><a href="qbytearray.html">QByteArray</a> QHelpEngineCore::fileData ( const <a href="qurl.html">QUrl</a> & <i>url</i> ) const</h3>
<p>Returns the data of the file specified by <i>url</i>. If the file does not exist, an empty <a href="qbytearray.html">QByteArray</a> is returned.</p>
<p>See also <a href="qhelpenginecore.html#findFile">findFile</a>().</p>
<!-- @@@fileData -->
<!-- $$$files[overload1]$$$filesconstQStringconstQStringList&constQString& -->
<h3 class="fn"><a name="files"></a><a href="qlist.html">QList</a><<a href="qurl.html">QUrl</a>> QHelpEngineCore::files ( const <a href="qstring.html">QString</a> <i>namespaceName</i>, const <a href="qstringlist.html">QStringList</a> & <i>filterAttributes</i>, const <a href="qstring.html">QString</a> & <i>extensionFilter</i> = QString() )</h3>
<p>Returns a list of files contained in the Qt compressed help file <i>namespaceName</i>. The files can be filtered by <i>filterAttributes</i> as well as by their extension <i>extensionFilter</i> (e.g. 'html').</p>
<!-- @@@files -->
<!-- $$$filterAttributeSets[overload1]$$$filterAttributeSetsconstQString& -->
<h3 class="fn"><a name="filterAttributeSets"></a><a href="qlist.html">QList</a><<a href="qstringlist.html">QStringList</a>> QHelpEngineCore::filterAttributeSets ( const <a href="qstring.html">QString</a> & <i>namespaceName</i> ) const</h3>
<p>Returns a list of filter attributes for the different filter sections defined in the Qt compressed help file with the given namespace <i>namespaceName</i>.</p>
<!-- @@@filterAttributeSets -->
<!-- $$$filterAttributes[overload1]$$$filterAttributes -->
<h3 class="fn"><a name="filterAttributes"></a><a href="qstringlist.html">QStringList</a> QHelpEngineCore::filterAttributes () const</h3>
<p>Returns a list of all defined filter attributes.</p>
<!-- @@@filterAttributes -->
<!-- $$$filterAttributes$$$filterAttributesconstQString& -->
<h3 class="fn"><a name="filterAttributes-2"></a><a href="qstringlist.html">QStringList</a> QHelpEngineCore::filterAttributes ( const <a href="qstring.html">QString</a> & <i>filterName</i> ) const</h3>
<p>Returns a list of filter attributes used by the custom filter <i>filterName</i>.</p>
<!-- @@@filterAttributes -->
<!-- $$$findFile[overload1]$$$findFileconstQUrl& -->
<h3 class="fn"><a name="findFile"></a><a href="qurl.html">QUrl</a> QHelpEngineCore::findFile ( const <a href="qurl.html">QUrl</a> & <i>url</i> ) const</h3>
<p>Returns an invalid URL if the file <i>url</i> cannot be found. If the file exists, either the same url is returned or a different url if the file is located in a different namespace which is merged via a common virtual folder.</p>
<!-- @@@findFile -->
<!-- $$$linksForIdentifier[overload1]$$$linksForIdentifierconstQString& -->
<h3 class="fn"><a name="linksForIdentifier"></a><a href="qmap.html">QMap</a><<a href="qstring.html">QString</a>, <a href="qurl.html">QUrl</a>> QHelpEngineCore::linksForIdentifier ( const <a href="qstring.html">QString</a> & <i>id</i> ) const</h3>
<p>Returns a map of hits found for the <i>id</i>. A hit contains the title of the document and the url where the keyword is located. The result depends on the current filter, meaning only the keywords registered for the current filter will be returned.</p>
<!-- @@@linksForIdentifier -->
<!-- $$$metaData[overload1]$$$metaDataconstQString&constQString& -->
<h3 class="fn"><a name="metaData"></a><a href="qvariant.html">QVariant</a> QHelpEngineCore::metaData ( const <a href="qstring.html">QString</a> & <i>documentationFileName</i>, const <a href="qstring.html">QString</a> & <i>name</i> )<tt> [static]</tt></h3>
<p>Returns the meta data for the Qt compressed help file <i>documentationFileName</i>. If there is no data available for <i>name</i>, an invalid QVariant() is returned. The meta data is defined when creating the Qt compressed help file and cannot be modified later. Common meta data includes e.g. the author of the documentation.</p>
<!-- @@@metaData -->
<!-- $$$namespaceName[overload1]$$$namespaceNameconstQString& -->
<h3 class="fn"><a name="namespaceName"></a><a href="qstring.html">QString</a> QHelpEngineCore::namespaceName ( const <a href="qstring.html">QString</a> & <i>documentationFileName</i> )<tt> [static]</tt></h3>
<p>Returns the namespace name defined for the Qt compressed help file (.qch) specified by its <i>documentationFileName</i>. If the file is not valid, an empty string is returned.</p>
<p>See also <a href="qhelpenginecore.html#documentationFileName">documentationFileName</a>().</p>
<!-- @@@namespaceName -->
<!-- $$$registerDocumentation[overload1]$$$registerDocumentationconstQString& -->
<h3 class="fn"><a name="registerDocumentation"></a>bool QHelpEngineCore::registerDocumentation ( const <a href="qstring.html">QString</a> & <i>documentationFileName</i> )</h3>
<p>Registers the Qt compressed help file (.qch) contained in the file <i>documentationFileName</i>. One compressed help file, uniquely identified by its namespace can only be registered once. True is returned if the registration was successful, otherwise false.</p>
<p>See also <a href="qhelpenginecore.html#unregisterDocumentation">unregisterDocumentation</a>() and <a href="qhelpenginecore.html#error">error</a>().</p>
<!-- @@@registerDocumentation -->
<!-- $$$registeredDocumentations[overload1]$$$registeredDocumentations -->
<h3 class="fn"><a name="registeredDocumentations"></a><a href="qstringlist.html">QStringList</a> QHelpEngineCore::registeredDocumentations () const</h3>
<p>Returns a list of all registered Qt compressed help files of the current collection file. The returned names are the namespaces of the registered Qt compressed help files (.qch).</p>
<!-- @@@registeredDocumentations -->
<!-- $$$removeCustomFilter[overload1]$$$removeCustomFilterconstQString& -->
<h3 class="fn"><a name="removeCustomFilter"></a>bool QHelpEngineCore::removeCustomFilter ( const <a href="qstring.html">QString</a> & <i>filterName</i> )</h3>
<p>Returns true if the filter <i>filterName</i> was removed successfully, otherwise false.</p>
<p>See also <a href="qhelpenginecore.html#addCustomFilter">addCustomFilter</a>() and <a href="qhelpenginecore.html#customFilters">customFilters</a>().</p>
<!-- @@@removeCustomFilter -->
<!-- $$$removeCustomValue[overload1]$$$removeCustomValueconstQString& -->
<h3 class="fn"><a name="removeCustomValue"></a>bool QHelpEngineCore::removeCustomValue ( const <a href="qstring.html">QString</a> & <i>key</i> )</h3>
<p>Removes the <i>key</i> from the settings section in the collection file. Returns true if the value was removed successfully, otherwise false.</p>
<p>See also <a href="qhelpenginecore.html#customValue">customValue</a>() and <a href="qhelpenginecore.html#setCustomValue">setCustomValue</a>().</p>
<!-- @@@removeCustomValue -->
<!-- $$$setCustomValue[overload1]$$$setCustomValueconstQString&constQVariant& -->
<h3 class="fn"><a name="setCustomValue"></a>bool QHelpEngineCore::setCustomValue ( const <a href="qstring.html">QString</a> & <i>key</i>, const <a href="qvariant.html">QVariant</a> & <i>value</i> )</h3>
<p>Save the <i>value</i> under the <i>key</i>. If the key already exist, the value will be overwritten. Returns true if the value was saved successfully, otherwise false.</p>
<p>See also <a href="qhelpenginecore.html#customValue">customValue</a>() and <a href="qhelpenginecore.html#removeCustomValue">removeCustomValue</a>().</p>
<!-- @@@setCustomValue -->
<!-- $$$setupData[overload1]$$$setupData -->
<h3 class="fn"><a name="setupData"></a>bool QHelpEngineCore::setupData ()</h3>
<p>Sets up the help engine by processing the information found in the collection file and returns true if successful; otherwise returns false.</p>
<p>By calling the function, the help engine is forced to initialize itself immediately. Most of the times, this function does not have to be called explicitly because getter functions which depend on a correctly set up help engine do that themselves.</p>
<p><b>Note:</b> <tt>qsqlite4.dll</tt> needs to be deployed with the application as the help system uses the sqlite driver when loading help collections.</p>
<!-- @@@setupData -->
<!-- $$$setupFinished[overload1]$$$setupFinished -->
<h3 class="fn"><a name="setupFinished"></a>void QHelpEngineCore::setupFinished ()<tt> [signal]</tt></h3>
<p>This signal is emitted when the setup is complete.</p>
<!-- @@@setupFinished -->
<!-- $$$setupStarted[overload1]$$$setupStarted -->
<h3 class="fn"><a name="setupStarted"></a>void QHelpEngineCore::setupStarted ()<tt> [signal]</tt></h3>
<p>This signal is emitted when setup is started.</p>
<!-- @@@setupStarted -->
<!-- $$$unregisterDocumentation[overload1]$$$unregisterDocumentationconstQString& -->
<h3 class="fn"><a name="unregisterDocumentation"></a>bool QHelpEngineCore::unregisterDocumentation ( const <a href="qstring.html">QString</a> & <i>namespaceName</i> )</h3>
<p>Unregisters the Qt compressed help file (.qch) identified by its <i>namespaceName</i> from the help collection. Returns true on success, otherwise false.</p>
<p>See also <a href="qhelpenginecore.html#registerDocumentation">registerDocumentation</a>() and <a href="qhelpenginecore.html#error">error</a>().</p>
<!-- @@@unregisterDocumentation -->
<!-- $$$warning[overload1]$$$warningconstQString& -->
<h3 class="fn"><a name="warning"></a>void QHelpEngineCore::warning ( const <a href="qstring.html">QString</a> & <i>msg</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted when a non critical error occurs. The warning message is stored in <i>msg</i>.</p>
<!-- @@@warning -->
</div>
<div class="feedback t_button">
[+] Documentation Feedback</div>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2008-2010 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>
<div id="feedbackBox">
<div id="feedcloseX" class="feedclose t_button">X</div>
<form id="feedform" action="http://doc.qt.nokia.com/docFeedbck/feedback.php" method="get">
<p id="noteHead">Thank you for giving your feedback.</p> <p class="note">Make sure it is related to this specific page. For more general bugs and
requests, please use the <a href="http://bugreports.qt.nokia.com/secure/Dashboard.jspa">Qt Bug Tracker</a>.</p>
<p><textarea id="feedbox" name="feedText" rows="5" cols="40"></textarea></p>
<p><input id="feedsubmit" class="feedclose" type="submit" name="feedback" /></p>
</form>
</div>
<div id="blurpage">
</div>
</body>
</html>
|