|
|
              
QMetaProperty Class Reference |
| QMetaEnum | enumerator () const |
| bool | hasNotifySignal () const |
| bool | isConstant () const |
| bool | isDesignable ( const QObject * object = 0 ) const |
| bool | isEnumType () const |
| bool | isFinal () const |
| bool | isFlagType () const |
| bool | isReadable () const |
| bool | isResettable () const |
| bool | isScriptable ( const QObject * object = 0 ) const |
| bool | isStored ( const QObject * object = 0 ) const |
| bool | isUser ( const QObject * object = 0 ) const |
| bool | isValid () const |
| bool | isWritable () const |
| const char * | name () const |
| QMetaMethod | notifySignal () const |
| int | notifySignalIndex () const |
| int | propertyIndex () const |
| QVariant | read ( const QObject * object ) const |
| bool | reset ( QObject * object ) const |
| QVariant::Type | type () const |
| const char * | typeName () const |
| int | userType () const |
| bool | write ( QObject * object, const QVariant & value ) const |
Detailed Description
The QMetaProperty class provides meta-data about a property.
Property meta-data is obtained from an object's meta-object. See QMetaObject::property() and QMetaObject::propertyCount() for details.
Property Meta-Data
A property has a name() and a type(), as well as various attributes that specify its behavior: isReadable(), isWritable(), isDesignable(), isScriptable(), and isStored().
If the property is an enumeration, isEnumType() returns true; if the property is an enumeration that is also a flag (i.e. its values can be combined using the OR operator), isEnumType() and isFlagType() both return true. The enumerator for these types is available from enumerator().
The property's values are set and retrieved with read(), write(), and reset(); they can also be changed through QObject's set and get functions. See QObject::setProperty() and QObject::property() for details.
Copying and Assignment
QMetaProperty objects can be copied by value. However, each copy will refer to the same underlying property meta-data.
See also QMetaObject, QMetaEnum, QMetaMethod, and Qt's Property System.
Member Function Documentation
QMetaEnum QMetaProperty::enumerator () const
Returns the enumerator if this property's type is an enumerator type; otherwise the returned value is undefined.
See also isEnumType() and isFlagType().
bool QMetaProperty::hasNotifySignal () const
Returns true if this property has a corresponding change notify signal; otherwise returns false.
See also notifySignal().
bool QMetaProperty::isConstant () const
Returns true if the property is constant; otherwise returns false.
A property is constant if the Q_PROPERTY()'s CONSTANT attribute is set.
This function was introduced in Qt 4.6.
bool QMetaProperty::isDesignable ( const QObject * object = 0 ) const
Returns true if this property is designable for the given object; otherwise returns false.
If no object is given, the function returns false if the Q_PROPERTY()'s DESIGNABLE attribute is false; otherwise returns true (if the attribute is true or is a function or expression).
See also isScriptable() and isStored().
bool QMetaProperty::isEnumType () const
Returns true if the property's type is an enumeration value; otherwise returns false.
See also enumerator() and isFlagType().
bool QMetaProperty::isFinal () const
Returns true if the property is final; otherwise returns false.
A property is final if the Q_PROPERTY()'s FINAL attribute is set.
This function was introduced in Qt 4.6.
bool QMetaProperty::isFlagType () const
Returns true if the property's type is an enumeration value that is used as a flag; otherwise returns false.
Flags can be combined using the OR operator. A flag type is implicitly also an enum type.
See also isEnumType(), enumerator(), and QMetaEnum::isFlag().
bool QMetaProperty::isReadable () const
Returns true if this property is readable; otherwise returns false.
See also isWritable(), read(), and isValid().
bool QMetaProperty::isResettable () const
Returns true if this property can be reset to a default value; otherwise returns false.
See also reset().
bool QMetaProperty::isScriptable ( const QObject * object = 0 ) const
Returns true if the property is scriptable for the given object; otherwise returns false.
If no object is given, the function returns false if the Q_PROPERTY()'s SCRIPTABLE attribute is false; otherwise returns true (if the attribute is true or is a function or expression).
See also isDesignable() and isStored().
bool QMetaProperty::isStored ( const QObject * object = 0 ) const
Returns true if the property is stored for object; otherwise returns false.
If no object is given, the function returns false if the Q_PROPERTY()'s STORED attribute is false; otherwise returns true (if the attribute is true or is a function or expression).
See also isDesignable() and isScriptable().
bool QMetaProperty::isUser ( const QObject * object = 0 ) const
Returns true if this property is designated as the USER property, i.e., the one that the user can edit for object or that is significant in some other way. Otherwise it returns false. e.g., the text property is the USER editable property of a QLineEdit.
If object is null, the function returns false if the Q_PROPERTY()'s USER attribute is false. Otherwise it returns true.
See also QMetaObject::userProperty(), isDesignable(), and isScriptable().
bool QMetaProperty::isValid () const
Returns true if this property is valid (readable); otherwise returns false.
See also isReadable().
bool QMetaProperty::isWritable () const
Returns true if this property is writable; otherwise returns false.
See also isReadable() and write().
const char * QMetaProperty::name () const
Returns this property's name.
See also type() and typeName().
QMetaMethod QMetaProperty::notifySignal () const
Returns the QMetaMethod instance of the property change notifying signal if one was specified, otherwise returns an invalid QMetaMethod.
This function was introduced in Qt 4.5.
See also hasNotifySignal().
int QMetaProperty::notifySignalIndex () const
Returns the index of the property change notifying signal if one was specified, otherwise returns -1.
This function was introduced in Qt 4.6.
See also hasNotifySignal().
int QMetaProperty::propertyIndex () const
Returns this property's index.
This function was introduced in Qt 4.6.
QVariant QMetaProperty::read ( const QObject * object ) const
Reads the property's value from the given object. Returns the value if it was able to read it; otherwise returns an invalid variant.
See also write(), reset(), and isReadable().
bool QMetaProperty::reset ( QObject * object ) const
Resets the property for the given object with a reset method. Returns true if the reset worked; otherwise returns false.
Reset methods are optional; only a few properties support them.
QVariant::Type QMetaProperty::type () const
Returns this property's type. The return value is one of the values of the QVariant::Type enumeration.
See also userType(), typeName(), and name().
const char * QMetaProperty::typeName () const
Returns the name of this property's type.
int QMetaProperty::userType () const
Returns this property's user type. The return value is one of the values that are registered with QMetaType, or 0 if the type is not registered.
This function was introduced in Qt 4.2.
See also type(), QMetaType, and typeName().
bool QMetaProperty::write ( QObject * object, const QVariant & value ) const
Writes value as the property's value to the given object. Returns true if the write succeeded; otherwise returns false.
See also read(), reset(), and isWritable().
|
|
Best Of
Actualités les plus lues
- Pourquoi les programmeurs sont-ils moins payés que les gestionnaires de programmes ? Manquent-ils de pouvoir de négociation ? 42
- Qt Commercial : Digia organise un webinar gratuit le 27 mars sur la conception d'interfaces utilisateur et d'applications avec le framework 0
- Interfaces mobiles : nouveaux usages, nouvelles ergonomies, par Miratech 0
- Implémentation d'une table de hachage à référence faible avec Qt, un article de Christophe Dumez traduit par Thibaut Cuvelier 4
- PySide devient un add-on Qt et rejoint le Qt Project et le modèle d'open gouvernance 0
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 94
- Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
- Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
- Pourquoi les programmeurs sont-ils moins payés que les gestionnaires de programmes ? Manquent-ils de pouvoir de négociation ? 42
- Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
- Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
- 2017 : un quinquennat pour une nouvelle version du C++ ? Possible, selon Herb Sutter 9
- 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 Labs au hasard
Peek et Poke
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-snapshot | |
| 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