QMetaProperty Class
La clase QMetaProperty proporciona metadatos sobre una propiedad. Más información...
| Encabezado: | #include <QMetaProperty> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
Funciones públicas
(since 6.0) QUntypedBindable | bindable(QObject *object) const |
| QMetaEnum | enumerator() const |
| bool | hasNotifySignal() const |
(since 6.0) bool | isBindable() const |
| bool | isConstant() const |
| bool | isDesignable() const |
| bool | isEnumType() const |
| bool | isFinal() const |
| bool | isFlagType() const |
(since 6.11) bool | isOverride() const |
| bool | isReadable() const |
| bool | isRequired() const |
| bool | isResettable() const |
| bool | isScriptable() const |
| bool | isStored() const |
| bool | isUser() const |
| bool | isValid() const |
(since 6.11) bool | isVirtual() const |
| bool | isWritable() const |
(since 6.0) QMetaType | metaType() const |
| const char * | name() const |
| QMetaMethod | notifySignal() const |
| int | notifySignalIndex() const |
| int | propertyIndex() const |
| QVariant | read(const QObject *object) const |
| QVariant | readOnGadget(const void *gadget) const |
| int | relativePropertyIndex() const |
| bool | reset(QObject *object) const |
| bool | resetOnGadget(void *gadget) const |
| int | revision() const |
(since 6.0) int | typeId() const |
| const char * | typeName() const |
| int | userType() const |
| bool | write(QObject *object, const QVariant &value) const |
(since 6.6) bool | write(QObject *object, QVariant &&v) const |
| bool | writeOnGadget(void *gadget, const QVariant &value) const |
(since 6.6) bool | writeOnGadget(void *gadget, QVariant &&value) const |
Descripción detallada
Los metadatos de las propiedades se obtienen del metaobjeto de un objeto. Para más detalles, véase QMetaObject::property() y QMetaObject::propertyCount().
Metadatos de las propiedades
Una propiedad tiene un name() y un metaType(), así como varios atributos que especifican su comportamiento: isReadable(), isWritable(), isDesignable(), isScriptable(), revision() y isStored().
Si la propiedad es una enumeración, isEnumType() devuelve true; si la propiedad es una enumeración que también es un indicador (es decir, sus valores se pueden combinar mediante el operador OR), tanto isEnumType() como isFlagType() devuelven true. El enumerador para estos tipos está disponible en enumerator().
Los valores de la propiedad se establecen y se recuperan mediante read(), write() y reset(); también se pueden modificar a través de las funciones set y get de QObject. Consulte QObject::setProperty() y QObject::property() para obtener más detalles.
Copia y asignación
Los objetos QMetaProperty se pueden copiar por valor. Sin embargo, cada copia hará referencia a los mismos metadatos de la propiedad subyacente.
Véase también QMetaObject, QMetaEnum, QMetaMethod y el sistema de propiedades de Qt.
Documentación de las funciones miembro
[since 6.0] QUntypedBindable QMetaProperty::bindable(QObject *object) const
Devuelve la interfaz vinculable para la propiedad de un objeto ` object` dado.
Si la propiedad no admite enlaces, la interfaz devuelta no será válida.
Esta función se introdujo en Qt 6.0.
Véase también QObjectBindableProperty, QProperty y isBindable().
QMetaEnum QMetaProperty::enumerator() const
Devuelve el enumerador si el tipo de esta propiedad es un tipo de enumerador; en caso contrario, el valor devuelto es indefinido.
Véase también isEnumType() y isFlagType().
bool QMetaProperty::hasNotifySignal() const
Devuelve « true » si esta propiedad tiene una señal de notificación de cambios correspondiente; en caso contrario, devuelve « false ».
Véase también notifySignal().
[since 6.0] bool QMetaProperty::isBindable() const
Devuelve ` true ` si el ` Q_PROPERTY() ` ofrece funcionalidad de enlace; en caso contrario, devuelve `false`.
Esto implica que se pueden crear enlaces que utilicen esta propiedad como dependencia o instalar objetos QPropertyObserver en esta propiedad. A menos que la propiedad sea de solo lectura, también se puede establecer un enlace en esta propiedad.
Esta función se introdujo en Qt 6.0.
Véase también QProperty, isWritable() y bindable().
bool QMetaProperty::isConstant() const
Devuelve « true » si la propiedad es constante; en caso contrario, devuelve « false ».
Una propiedad es constante si el atributo CONSTANT de Q_PROPERTY() está establecido.
bool QMetaProperty::isDesignable() const
Devuelve ` false ` si el atributo ` DESIGNABLE ` de ` Q_PROPERTY()` es `false`; en caso contrario, devuelve ` true`.
Véase también isScriptable() y isStored().
bool QMetaProperty::isEnumType() const
Devuelve « true » si el tipo de la propiedad es un valor de enumeración; en caso contrario, devuelve « false ».
Véase también enumerator() y isFlagType().
bool QMetaProperty::isFinal() const
Devuelve « true » si la propiedad es final; en caso contrario, devuelve « false ».
Una propiedad es «final» si el atributo « FINAL » de « Q_PROPERTY() » está establecido.
bool QMetaProperty::isFlagType() const
Devuelve ` true ` si el tipo de la propiedad es un valor de enumeración que se utiliza como indicador; en caso contrario, devuelve ` false`.
Los indicadores se pueden combinar utilizando el operador OR. Un tipo de indicador es, implícitamente, también un tipo de enumeración.
Véanse también isEnumType(), enumerator() y QMetaEnum::isFlag().
[since 6.11] bool QMetaProperty::isOverride() const
Devuelve « true » si la propiedad sí se sobrescribe; en caso contrario, devuelve « false ».
Una propiedad se sobrescribe si se establece el atributo OVERRIDE de Q_PROPERTY().
Esta función se introdujo en Qt 6.11.
bool QMetaProperty::isReadable() const
Devuelve « true » si esta propiedad es legible; en caso contrario, devuelve « false ».
Véase también isWritable(), read() y isValid().
bool QMetaProperty::isRequired() const
Devuelve ` true ` si la propiedad es obligatoria; en caso contrario, devuelve ` false`.
Una propiedad es final si se ha establecido el atributo REQUIRED de Q_PROPERTY().
bool QMetaProperty::isResettable() const
Devuelve « true » si esta propiedad se puede restablecer a su valor por defecto; en caso contrario, devuelve « false ».
Véase también reset().
bool QMetaProperty::isScriptable() const
Devuelve ` false ` si el atributo ` SCRIPTABLE ` del objeto ` Q_PROPERTY()` es `false`; en caso contrario, devuelve `true`.
Véase también isDesignable() y isStored().
bool QMetaProperty::isStored() const
Devuelve « true » si la propiedad está almacenada; en caso contrario, devuelve «false».
La función devuelve « false » si el atributo « STORED » del objeto « Q_PROPERTY() » es «false»; en caso contrario, devuelve «true».
Véase también isDesignable() y isScriptable().
bool QMetaProperty::isUser() const
Devuelve « false » si el atributo « USER » del objeto « Q_PROPERTY() » es «false». En caso contrario, devuelve «true», lo que indica que la propiedad está designada como la propiedad « USER », es decir, aquella que el usuario puede editar o que es relevante de alguna otra forma.
Véase también QMetaObject::userProperty(), isDesignable() y isScriptable().
bool QMetaProperty::isValid() const
Devuelve « true » si esta propiedad es válida (legible); en caso contrario, devuelve « false ».
Véase también isReadable().
[since 6.11] bool QMetaProperty::isVirtual() const
Devuelve ` true ` si la propiedad es virtual; en caso contrario, devuelve ` false`.
Una propiedad es virtual si el atributo VIRTUAL de Q_PROPERTY() está establecido.
Esta función se introdujo en Qt 6.11.
bool QMetaProperty::isWritable() const
Devuelve « true » si esta propiedad es modificable; en caso contrario, devuelve «false».
Véase también isReadable() y write().
[since 6.0] QMetaType QMetaProperty::metaType() const
Devuelve el ` QMetaType` de esta propiedad.
Esta función se introdujo en Qt 6.0.
Véase también QMetaType.
const char *QMetaProperty::name() const
Devuelve el nombre de esta propiedad.
Véase también type() y typeName().
QMetaMethod QMetaProperty::notifySignal() const
Devuelve la instancia ` QMetaMethod ` de la señal de notificación de cambios en la propiedad, si se ha especificado alguna; de lo contrario, devuelve un ` QMetaMethod` no válido.
Véase también hasNotifySignal().
int QMetaProperty::notifySignalIndex() const
Devuelve el índice de la señal de notificación de cambios en las propiedades, si se ha especificado alguna; en caso contrario, devuelve -1.
Véase también hasNotifySignal().
int QMetaProperty::propertyIndex() const
Devuelve el índice de esta propiedad.
QVariant QMetaProperty::read(const QObject *object) const
Lee el valor de la propiedad a partir del object indicado. Devuelve el valor si ha podido leerlo; en caso contrario, devuelve una variante no válida.
Véanse también write(), reset() y isReadable().
QVariant QMetaProperty::readOnGadget(const void *gadget) const
Lee el valor de la propiedad a partir del objeto ` gadget` indicado. Devuelve el valor si ha podido leerlo; en caso contrario, devuelve una variante no válida.
Esta función solo debe utilizarse si se trata de una propiedad de un Q_GADGET
int QMetaProperty::relativePropertyIndex() const
Devuelve el índice relativo de esta propiedad dentro del metaobjeto que la contiene.
bool QMetaProperty::reset(QObject *object) const
Restablece la propiedad del objeto ` object ` indicado mediante un método de restablecimiento. Devuelve ` true ` si el restablecimiento se ha realizado correctamente; en caso contrario, devuelve ` false`.
Los métodos de restablecimiento son opcionales; solo algunas propiedades los admiten.
Véase también read() y write().
bool QMetaProperty::resetOnGadget(void *gadget) const
Restablece la propiedad de la instancia de ` gadget ` indicada mediante un método de restablecimiento. Devuelve ` true ` si el restablecimiento se ha realizado correctamente; en caso contrario, devuelve ` false`.
Los métodos de restablecimiento son opcionales; solo unas pocas propiedades los admiten.
Esta función solo debe utilizarse si se trata de una propiedad de un Q_GADGET
int QMetaProperty::revision() const
Devuelve la revisión de la propiedad si se ha especificado una mediante ` Q_REVISION`; en caso contrario, devuelve 0. Desde Qt 6.0, los valores distintos de cero se codifican y pueden descodificarse mediante ` QTypeRevision::fromEncodedVersion()`.
[since 6.0] int QMetaProperty::typeId() const
Devuelve el tipo de almacenamiento de la propiedad. Es lo mismo que metaType().id().
Esta función se introdujo en Qt 6.0.
Véase también QMetaType, typeName() y metaType().
const char *QMetaProperty::typeName() const
Devuelve el nombre del tipo de esta propiedad.
Véase también type() y name().
int QMetaProperty::userType() const
Devuelve el tipo de usuario de esta propiedad. El valor devuelto es uno de los valores registrados en QMetaType.
Esto equivale a metaType().id()
Véase también type(), QMetaType, typeName() y metaType().
bool QMetaProperty::write(QObject *object, const QVariant &value) const
Escribe « value » como valor de la propiedad en la dirección « object » indicada. Devuelve «true» si la escritura se ha realizado correctamente; en caso contrario, devuelve « false ».
Si value no es del mismo tipo que la propiedad, se intenta realizar una conversión. Un QVariant() vacío equivale a una llamada a reset() si esta propiedad es reajustable, o bien a establecer un objeto construido por defecto en caso contrario.
Nota: Esta función realiza internamente una copia de ` value`. Se recomienda utilizar la sobrecarga de valor de salida siempre que sea posible.
Véase también read(), reset() y isWritable().
[since 6.6] bool QMetaProperty::write(QObject *object, QVariant &&v) const
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.6.
bool QMetaProperty::writeOnGadget(void *gadget, const QVariant &value) const
Escribe « value » como valor de la propiedad en la dirección « gadget » indicada. Devuelve «true» si la escritura se ha realizado correctamente; en caso contrario, devuelve « false ».
Esta función solo debe utilizarse si se trata de una propiedad de un Q_GADGET
[since 6.6] bool QMetaProperty::writeOnGadget(void *gadget, QVariant &&value) const
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.6.
© 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.