En esta página

QDesignerPropertyEditorInterface Class

La clase `QDesignerPropertyEditorInterface` permite consultar y modificar el estado actual del editor de propiedades de ` Qt Widgets Designer`. Más información...

Encabezado: #include <QDesignerPropertyEditorInterface>
CMake: find_package(Qt6 REQUIRED COMPONENTS Designer)
target_link_libraries(mytarget PRIVATE Qt6::Designer)
qmake: QT += designer
Heredado de: QWidget

Funciones públicas

QDesignerPropertyEditorInterface(QWidget *parent, Qt::WindowFlags flags = {})
virtual ~QDesignerPropertyEditorInterface() override
virtual QDesignerFormEditorInterface *core() const
virtual QString currentPropertyName() const = 0
virtual bool isReadOnly() const = 0
virtual QObject *object() const = 0

Ranuras públicas

virtual void setObject(QObject *object) = 0
virtual void setPropertyValue(const QString &name, const QVariant &value, bool changed = true) = 0
virtual void setReadOnly(bool readOnly) = 0

Señales

void propertyChanged(const QString &name, const QVariant &value)

Descripción detallada

QDesignerPropertyEditorInterface contiene un conjunto de funciones que se suelen utilizar para consultar el estado actual del editor de propiedades, así como varias ranuras que manipulan dicho estado. La interfaz también proporciona una señal, propertyChanged(), que se emite cada vez que cambia una propiedad en el editor de propiedades. Los argumentos de la señal son la propiedad que ha cambiado y su nuevo valor.

Por ejemplo, al implementar un complemento de widget personalizado, puedes conectar la señal a una ranura personalizada:

        auto *propertyEditor = formEditor->propertyEditor();

        connect(propertyEditor, &QDesignerPropertyEditorInterface::propertyChanged,
                this, &MyClass::checkProperty);

De este modo, la ranura personalizada puede comprobar si el nuevo valor se encuentra dentro del rango deseado cuando cambia una propiedad específica, perteneciente a un widget concreto:

        void checkProperty(const QString &property, const QVariant &value)
        {
            auto *propertyEditor = formEditor->propertyEditor();

            auto *object = propertyeditor->object();
            auto *widget = qobject_cast<MyCustomWidget *>(object);

            if (widget && property == aProperty && value != expectedValue)
                {...}
        }

La clase `QDesignerPropertyEditorInterface` no está pensada para ser instanciada directamente. Se puede obtener una interfaz al editor de propiedades de ` Qt Widgets Designer` mediante la función ` QDesignerFormEditorInterface::propertyEditor()`. El parámetro de la función ` QDesignerCustomWidgetInterface::initialize()` proporciona un puntero al objeto ` QDesignerFormEditorInterface ` actual de ` Qt Widgets Designer` (`formEditor ` en los ejemplos anteriores). Al implementar un complemento de widget personalizado, debe crear una subclase de ` QDesignerCustomWidgetInterface ` para exponer su complemento a ` Qt Widgets Designer`.

Las funciones que acceden al editor de propiedades son la función core(), que se puede utilizar para obtener una interfaz al editor de formularios; la función currentPropertyName(), que devuelve el nombre de la propiedad seleccionada actualmente en el editor de propiedades; la función object(), que devuelve el objeto seleccionado actualmente en el espacio de trabajo de Qt Widgets Designer; y la función isReadOnly(), que devuelve «true» si el editor de propiedades está protegido contra escritura (en caso contrario, «false»).

Las ranuras que manipulan el estado del editor de propiedades son la ranura « setObject()», que se puede utilizar para cambiar el objeto seleccionado actualmente en el espacio de trabajo de Qt Widgets Designer; la ranura « setPropertyValue()», que cambia el valor de una propiedad determinada; y la ranura « setReadOnly()», que controla la protección contra escritura del editor de propiedades.

Véase también QDesignerFormEditorInterface.

Documentación de las funciones de miembro

[explicit] QDesignerPropertyEditorInterface::QDesignerPropertyEditorInterface(QWidget *parent, Qt::WindowFlags flags = {})

Crea una interfaz de editor de propiedades con el ` parent ` proporcionado y la ventana especificada ` flags`.

[override virtual noexcept] QDesignerPropertyEditorInterface::~QDesignerPropertyEditorInterface()

Cierra la interfaz del editor de propiedades.

[virtual] QDesignerFormEditorInterface *QDesignerPropertyEditorInterface::core() const

Devuelve un puntero al objeto « QDesignerFormEditorInterface » actual de « Qt Widgets Designer ».

[pure virtual] QString QDesignerPropertyEditorInterface::currentPropertyName() const

Devuelve el nombre de la propiedad seleccionada actualmente en el editor de propiedades.

Véase también setPropertyValue().

[pure virtual] bool QDesignerPropertyEditorInterface::isReadOnly() const

Devuelve «true» si el editor de propiedades está protegido contra escritura; en caso contrario, devuelve «false».

Véase también ` setReadOnly()`.

[pure virtual] QObject *QDesignerPropertyEditorInterface::object() const

Devuelve el objeto seleccionado actualmente en el espacio de trabajo de Qt Widgets Designer.

Véase también setObject().

[signal] void QDesignerPropertyEditorInterface::propertyChanged(const QString &name, const QVariant &value)

Esta señal se emite cada vez que cambia una propiedad en el editor de propiedades. La propiedad que ha cambiado y su nuevo valor se especifican mediante name y value, respectivamente.

Véase también setPropertyValue().

[pure virtual slot] void QDesignerPropertyEditorInterface::setObject(QObject *object)

Cambia el objeto seleccionado actualmente en el espacio de trabajo de Qt Widgets Designer por object.

Véase también object().

[pure virtual slot] void QDesignerPropertyEditorInterface::setPropertyValue(const QString &name, const QVariant &value, bool changed = true)

Establece el valor de la propiedad especificada por « name » en « value ».

Además, la propiedad se marca como « changed » en el editor de propiedades, es decir, su valor es diferente del valor por defecto.

Véase también currentPropertyName() y propertyChanged().

[pure virtual slot] void QDesignerPropertyEditorInterface::setReadOnly(bool readOnly)

Si readOnly es verdadero, el editor de propiedades pasa a estar protegido contra escritura; en caso contrario, se elimina la protección contra escritura.

Véase también isReadOnly().

© 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.