QUntypedBindable Class
QUntypedBindable est une interface uniforme sur les propriétés liables comme QProperty\<T\> et QObjectBindableProperty de n'importe quel type T. 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 pour envelopper les propriétés liables. Vous pouvez l'utiliser pour interagir avec des propriétés sans connaître leur type ni vous soucier du type de propriété liante qu'elles sont (par exemple QProperty ou QObjectBindableProperty). Pour 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 qui a un type fixe).
Documentation des fonctions membres
[constexpr noexcept] QUntypedBindable::QUntypedBindable()
Default-construit un QUntypedBindable. Il est dans un état invalide.
Voir aussi isValid().
template <typename Property> QUntypedBindable::QUntypedBindable(Property *property)
Construit un QUntypedBindable à partir de la propriété property. Si Property est const, le QUntypedBindable sera en lecture seule. Si property est null, le QUntypedBindable sera invalide.
Voir aussi isValid() et isReadOnly().
template <typename Functor> QPropertyNotifier QUntypedBindable::addNotifier(Functor f)
Installe f comme gestionnaire de changement. Chaque fois que la propriété sous-jacente change, f sera appelé, tant que l'objet retourné QPropertyNotifier et la propriété sont maintenus en vie.
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 s'il y en a une, ou une construction par défaut QUntypedPropertyBinding dans le cas contraire.
Voir aussi setBinding() et hasBinding().
bool QUntypedBindable::hasBinding() const
Renvoie true si la propriété sous-jacente a une liaison.
[since 6.1] bool QUntypedBindable::isReadOnly() const
Retourne true si le site QUntypedBindable est en lecture seule.
Cette fonction a été introduite dans Qt 6.1.
bool QUntypedBindable::isValid() const
Retourne vrai si le site QUntypedBindable est valide. Les méthodes appelées sur un 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 une liaison renvoyant la valeur des propriétés sous-jacentes, en utilisant une source spécifiée location.
[since 6.2] QMetaType QUntypedBindable::metaType() const
Renvoie le métatype de la propriété à partir de laquelle 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 aussi isValid() et QUntypedPropertyBinding::valueMetaType().
template <typename Functor> QPropertyChangeHandler<Functor> QUntypedBindable::onValueChanged(Functor f) const
Installe f comme gestionnaire de changement. Chaque fois que la propriété sous-jacente change, f sera appelé, tant que le QPropertyChangeHandler renvoyé et la propriété sont maintenus en vie. À chaque changement de valeur, le gestionnaire est appelé immédiatement ou de manière différée, en fonction du contexte.
Voir aussi QProperty::onValueChanged() et subscribe().
bool QUntypedBindable::setBinding(const QUntypedPropertyBinding &binding)
Définit la liaison de la propriété sous-jacente à binding. Cela n'a aucun effet si QUntypedBindable est en lecture seule, null ou si le type de binding correspond au type de la propriété sous-jacente.
Retourne true si 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 aussi onValueChanged().
[since 6.1] QUntypedPropertyBinding QUntypedBindable::takeBinding()
Supprime la liaison actuellement définie pour la propriété et la renvoie. Renvoie un QUntypedPropertyBinding construit par défaut si aucune liaison n'est définie.
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.