QUntypedBindable Class
QUntypedBindable est une interface uniforme couvrant les propriétés liables telles que QProperty\<T\> et QObjectBindableProperty, quel que soit leur type T. En savoir plus...
| En-tête : | #include <QUntypedBindable> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
| Depuis : | Qt 6.0 |
| Hérité par : |
Fonctions publiques
| QUntypedBindable() | |
| QUntypedBindable(Property *property) | |
| QPropertyNotifier | addNotifier(Functor f) |
| QUntypedPropertyBinding | binding() const |
| bool | hasBinding() const |
(since 6.1) bool | isReadOnly() const |
| bool | isValid() const |
| QUntypedPropertyBinding | makeBinding(const QPropertyBindingSourceLocation &location = QT_PROPERTY_DEFAULT_BINDING_LOCATION) const |
(since 6.2) QMetaType | metaType() const |
| QPropertyChangeHandler<Functor> | onValueChanged(Functor f) const |
| bool | setBinding(const QUntypedPropertyBinding &binding) |
| QPropertyChangeHandler<Functor> | subscribe(Functor f) const |
(since 6.1) QUntypedPropertyBinding | takeBinding() |
Description détaillée
QUntypedBindable est une interface générique à effacement de type complet permettant d’encapsuler des propriétés liables. Vous pouvez l’utiliser pour interagir avec des propriétés sans connaître leur type ni vous soucier de leur nature (par exemple, QProperty ou QObjectBindableProperty). Dans la plupart des cas d'utilisation, il est préférable d'utiliser QBindable<T> (qui est générique par rapport à l'implémentation de la propriété mais dont le type est fixe).
Documentation des fonctions membres
[constexpr noexcept default] QUntypedBindable::QUntypedBindable()
Construit par défaut un objet de type `QUntypedBindable`. Il se trouve dans un état non valide.
Voir également isValid().
template <typename Property> QUntypedBindable::QUntypedBindable(Property *property)
Crée un objet `QUntypedBindable` à partir de la propriété ` property`. Si `Property` est de type `const`, l'objet `QUntypedBindable` sera en lecture seule. Si ` property ` est nul, l'objet `QUntypedBindable` sera invalide.
Voir également isValid() et isReadOnly().
template <typename Functor> QPropertyNotifier QUntypedBindable::addNotifier(Functor f)
Installe ` f ` en tant que gestionnaire de modifications. Chaque fois que la propriété sous-jacente change, ` f ` sera appelée, tant que l’objet ` QPropertyNotifier ` renvoyé et la propriété restent actifs.
Cette méthode est dans certains cas plus facile à utiliser que onValueChanged(), car l'objet renvoyé n'est pas un modèle. Il peut donc être stocké plus facilement, par exemple en tant que membre d'une classe.
Voir également onValueChanged() et subscribe().
QUntypedPropertyBinding QUntypedBindable::binding() const
Renvoie la liaison de la propriété sous-jacente si elle existe, ou sinon un objet ` QUntypedPropertyBinding ` instancié par défaut.
Voir également ` setBinding()` et ` hasBinding()`.
bool QUntypedBindable::hasBinding() const
Renvoie « true » si la propriété sous-jacente est liée à une valeur.
[since 6.1] bool QUntypedBindable::isReadOnly() const
Renvoie « true » si l'QUntypedBindable est en lecture seule.
Cette fonction a été introduite dans Qt 6.1.
bool QUntypedBindable::isValid() const
Renvoie « true » si l'QUntypedBindable est valide. Les méthodes appelées sur une QUntypedBindable non valide n'ont généralement aucun effet, sauf indication contraire.
QUntypedPropertyBinding QUntypedBindable::makeBinding(const QPropertyBindingSourceLocation &location = QT_PROPERTY_DEFAULT_BINDING_LOCATION) const
Crée un binding renvoyant la valeur des propriétés sous-jacentes, à partir d'une source spécifiée location.
[since 6.2] QMetaType QUntypedBindable::metaType() const
Renvoie le métatype de la propriété à partir de laquelle l'QUntypedBindable a été créé. Si le bindable n'est pas valide, un métatype non valide sera renvoyé.
Cette fonction a été introduite dans Qt 6.2.
Voir également ` isValid()` et ` QUntypedPropertyBinding::valueMetaType()`.
template <typename Functor> QPropertyChangeHandler<Functor> QUntypedBindable::onValueChanged(Functor f) const
Installe f en tant que gestionnaire de modifications. Chaque fois que la propriété sous-jacente change, f sera appelé, à condition que l'QPropertyChangeHandler renvoyé et la propriété restent actifs. À chaque changement de valeur, le gestionnaire est soit appelé immédiatement, soit différé, selon le contexte.
Voir également QProperty::onValueChanged() et subscribe().
bool QUntypedBindable::setBinding(const QUntypedPropertyBinding &binding)
Définit la liaison de la propriété sous-jacente sur binding. Cela n'a aucun effet si l'QUntypedBindable est en lecture seule, nulle ou si le type de binding ne correspond pas au type de la propriété sous-jacente.
Renvoie ` true ` lorsque la liaison a été définie avec succès.
Voir également binding() et QUntypedPropertyBinding::valueMetaType().
template <typename Functor> QPropertyChangeHandler<Functor> QUntypedBindable::subscribe(Functor f) const
Se comporte comme un appel à ` f ` suivi de ` onValueChanged(f)`,
Voir également onValueChanged().
[since 6.1] QUntypedPropertyBinding QUntypedBindable::takeBinding()
Supprime le lien actuellement défini pour la propriété et renvoie celle-ci. Renvoie un objet ` QUntypedPropertyBinding ` construit par défaut si aucun lien n'est défini.
Cette fonction a été introduite dans Qt 6.1.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. 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.