              
QHelpEngineCore Class Reference |
| QHelpEngineCore ( const QString & collectionFile, QObject * parent = 0 ) | |
| virtual | ~QHelpEngineCore () |
| bool | addCustomFilter ( const QString & filterName, const QStringList & attributes ) |
| bool | autoSaveFilter () const |
| QString | collectionFile () const |
| bool | copyCollectionFile ( const QString & fileName ) |
| QString | currentFilter () const |
| QStringList | customFilters () const |
| QVariant | customValue ( const QString & key, const QVariant & defaultValue = QVariant() ) const |
| QString | documentationFileName ( const QString & namespaceName ) |
| QString | error () const |
| QByteArray | fileData ( const QUrl & url ) const |
| QList<QUrl> | files ( const QString namespaceName, const QStringList & filterAttributes, const QString & extensionFilter = QString() ) |
| QList<QStringList> | filterAttributeSets ( const QString & namespaceName ) const |
| QStringList | filterAttributes () const |
| QStringList | filterAttributes ( const QString & filterName ) const |
| QUrl | findFile ( const QUrl & url ) const |
| QMap<QString, QUrl> | linksForIdentifier ( const QString & id ) const |
| bool | registerDocumentation ( const QString & documentationFileName ) |
| QStringList | registeredDocumentations () const |
| bool | removeCustomFilter ( const QString & filterName ) |
| bool | removeCustomValue ( const QString & key ) |
| void | setAutoSaveFilter ( bool save ) |
| void | setCollectionFile ( const QString & fileName ) |
| void | setCurrentFilter ( const QString & filterName ) |
| bool | setCustomValue ( const QString & key, const QVariant & value ) |
| bool | setupData () |
| bool | unregisterDocumentation ( const QString & namespaceName ) |
- 29 public functions inherited from QObject
Signals
| void | currentFilterChanged ( const QString & newFilter ) |
| void | setupFinished () |
| void | setupStarted () |
| void | warning ( const QString & msg ) |
- 1 signal inherited from QObject
Static Public Members
| QVariant | metaData ( const QString & documentationFileName, const QString & name ) |
| QString | namespaceName ( const QString & documentationFileName ) |
- 5 static public members inherited from QObject
Additional Inherited Members
Detailed Description
The QHelpEngineCore class provides the core functionality of the help system.
Before the help engine can be used, it must be initialized by calling setupData(). At the beginning of the setup process the signal setupStarted() is emitted. From this point on until the signal setupFinished() is emitted, is the help data in an undefined meaning unusable state.
The core help engine can be used to perform different tasks. By calling linksForIdentifier() the engine returns urls specifying the file locations inside the help system. The actual file data can then be retrived by calling fileData(). In contrast to all other functions in this class, linksForIdentifier() depends on the currently set custom filter. Depending on the filter, the function may return different hits.
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 addCustomFilter(). Analogous, it is removed by calling removeCustomFilter(). customFilters() returns all defined filters.
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().
This class does not offer any GUI components or functionality for indices or contents. If you need one of those use QHelpEngine instead.
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 creating a custom help collection file for Assistant.
Property Documentation
autoSaveFilter : bool
This property holds whether QHelpEngineCore is in auto save filter mode or not.
If QHelpEngineCore is in auto save filter mode, the current filter is automatically saved when it is changed by the setCurrentFilter() function. The filter is saved persistently in the help collection file.
By default, this mode is on.
This property was introduced in Qt 4.5.
Access functions:
| bool | autoSaveFilter () const |
| void | setAutoSaveFilter ( bool save ) |
collectionFile : QString
This property holds the absolute file name of the collection file currently used.
Setting this property leaves the help engine in an invalid state. It is important to invoke setupData() or any getter function in order to setup the help engine again.
This property was introduced in Qt 4.5.
Access functions:
| QString | collectionFile () const |
| void | setCollectionFile ( const QString & fileName ) |
currentFilter : QString
This property holds the name of the custom filter currently applied.
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.
This property was introduced in Qt 4.5.
Access functions:
| QString | currentFilter () const |
| void | setCurrentFilter ( const QString & filterName ) |
See also autoSaveFilter().
Member Function Documentation
QHelpEngineCore::QHelpEngineCore ( const QString & collectionFile, QObject * parent = 0 )
Constructs a new core help engine with a parent. The help engine uses the information stored in the collectionFile to provide help. If the collection file does not exist yet, it'll be created.
QHelpEngineCore::~QHelpEngineCore () [virtual]
Destructs the help engine.
bool QHelpEngineCore::addCustomFilter ( const QString & filterName, const QStringList & attributes )
Adds the new custom filter filterName. The filter attributes are specified by attributes. The function returns false if the filter can not be added, e.g. when the filter already exists.
See also customFilters() and removeCustomFilter().
bool QHelpEngineCore::copyCollectionFile ( const QString & fileName )
Creates the file fileName and copies all contents from the current collection file into the newly created file, and returns true if successful; otherwise returns false.
The copying process makes sure that file references to Qt Collection files (.qch) files are updated accordingly.
void QHelpEngineCore::currentFilterChanged ( const QString & newFilter ) [signal]
This signal is emitted when the current filter is changed to newFilter.
QStringList QHelpEngineCore::customFilters () const
Returns a list of custom filters.
See also addCustomFilter() and removeCustomFilter().
QVariant QHelpEngineCore::customValue ( const QString & key, const QVariant & defaultValue = QVariant() ) const
Returns the value assigned to the key. If the requested key does not exist, the specified defaultValue is returned.
See also setCustomValue() and removeCustomValue().
QString QHelpEngineCore::documentationFileName ( const QString & namespaceName )
Returns the absolute file name of the Qt compressed help file (.qch) identified by the namespaceName. If there is no Qt compressed help file with the specified namespace registered, an empty string is returned.
See also namespaceName().
QString QHelpEngineCore::error () const
Returns a description of the last error that occured.
QByteArray QHelpEngineCore::fileData ( const QUrl & url ) const
Returns the data of the file specified by url. If the file does not exist, an empty QByteArray is returned.
See also findFile().
QList<QUrl> QHelpEngineCore::files ( const QString namespaceName, const QStringList & filterAttributes, const QString & extensionFilter = QString() )
Returns a list of files contained in the Qt compressed help file namespaceName. The files can be filtered by filterAttributes as well as by their extension extensionFilter (e.g. 'html').
QList<QStringList> QHelpEngineCore::filterAttributeSets ( const QString & namespaceName ) const
Returns a list of filter attributes for the different filter sections defined in the Qt compressed help file with the given namespace namespaceName.
QStringList QHelpEngineCore::filterAttributes () const
Returns a list of all defined filter attributes.
QStringList QHelpEngineCore::filterAttributes ( const QString & filterName ) const
Returns a list of filter attributes used by the custom filter filterName.
QUrl QHelpEngineCore::findFile ( const QUrl & url ) const
Returns an invalid URL if the file url 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.
QMap<QString, QUrl> QHelpEngineCore::linksForIdentifier ( const QString & id ) const
Returns a map of hits found for the id. 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.
QVariant QHelpEngineCore::metaData ( const QString & documentationFileName, const QString & name ) [static]
Returns the meta data for the Qt compressed help file documentationFileName. If there is no data available for name, 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.
QString QHelpEngineCore::namespaceName ( const QString & documentationFileName ) [static]
Returns the namespace name defined for the Qt compressed help file (.qch) specified by its documentationFileName. If the file is not valid, an empty string is returned.
See also documentationFileName().
bool QHelpEngineCore::registerDocumentation ( const QString & documentationFileName )
Registers the Qt compressed help file (.qch) contained in the file documentationFileName. One compressed help file, uniquely identified by its namespace can only be registered once. True is returned if the registration was successful, otherwise false.
See also unregisterDocumentation() and error().
QStringList QHelpEngineCore::registeredDocumentations () const
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).
bool QHelpEngineCore::removeCustomFilter ( const QString & filterName )
Returns true if the filter filterName was removed successfully, otherwise false.
See also addCustomFilter() and customFilters().
bool QHelpEngineCore::removeCustomValue ( const QString & key )
Removes the key from the settings section in the collection file. Returns true if the value was removed successfully, otherwise false.
See also customValue() and setCustomValue().
bool QHelpEngineCore::setCustomValue ( const QString & key, const QVariant & value )
Save the value under the key. If the key already exist, the value will be overwritten. Returns true if the value was saved successfully, otherwise false.
See also customValue() and removeCustomValue().
bool QHelpEngineCore::setupData ()
Sets up the help engine by processing the information found in the collection file and returns true if successful; otherwise returns false.
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.
Note: qsqlite4.dll needs to be deployed with the application as the help system uses the sqlite driver when loading help collections.
void QHelpEngineCore::setupFinished () [signal]
This signal is emitted when the setup is complete.
void QHelpEngineCore::setupStarted () [signal]
This signal is emitted when setup is started.
bool QHelpEngineCore::unregisterDocumentation ( const QString & namespaceName )
Unregisters the Qt compressed help file (.qch) identified by its namespaceName from the help collection. Returns true on success, otherwise false.
See also registerDocumentation() and error().
void QHelpEngineCore::warning ( const QString & msg ) [signal]
This signal is emitted when a non critical error occurs. The warning message is stored in msg.
Best Of
Actualités les plus lues
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 12
- Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
- Partage de données explicite et implicite avec Qt, un article de Christophe Dumez traduit par Thibaut Cuvelier 0
- Créer des applications avec un style Metro avec Qt, exemples en QML et C++, un article du blog Digia traduit par Thibaut Cuvelier 0
- Microsoft ouvre aux autres compilateurs C++ AMP, la spécification pour la conception d'applications parallèles C++ utilisant le GPU 22
- Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
- RIM : « 13 % des développeurs ont gagné plus de 100 000 $ sur l'AppWord », Qt et open-source au menu du BlackBerry DevCon Europe 0
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 12
- BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
- Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
- Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
- Linus Torvalds : le "C++ est un langage horrible", en justifiant le choix du C pour le système de gestion de version Git 100
- Comment prendre en compte l'utilisateur dans vos applications ? Pour un développeur, « 90 % des utilisateurs sont des idiots » 229
- Quel est LE livre que tout développeur doit lire absolument ? Celui qui vous a le plus marqué et inspiré 96
- Apple cède et s'engage à payer des droits à Nokia, le conflit des brevets entre les deux firmes s'achève 158
- Nokia porte à nouveau plainte contre Apple pour violation de sept nouveaux brevets 158
- Quel est le code dont vous êtes le plus fier ? Pourquoi l'avez-vous écrit ? Et pourquoi vous a-t-il donné autant de satisfaction ? 83
- Le Draft final de la norme C++ 0X validé 181
Le Qt Developer Network au hasard
La création de colonnes dans une ListView en QML
Communauté
Ressources
- 91 cours et tutoriels Qt
- F.A.Q. Qt : 200 questions et réponses
- 48 Qt Quarterly, 35 Qt Labs et 22 Qt DevNet en français
- 43 outils Qt
- 99 sources Qt
- 26 binaires Qt
- 6 livres Qt et 9 critiques
- La documentation de Qt 4.7 en français : 157 classes, 70 concepts et 24 modules
- 3 certifications Qt
Liens utiles
Contact
- Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).
Qt dans le magazine
| Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. | Qt 4.6 | |
| Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD. | ||
| Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP ! | ||
Copyright © 2000-2012 - www.developpez.com