En esta página

QDesignerMemberSheetExtension Class

La clase `QDesignerMemberSheetExtension` permite manipular las funciones miembro de un widget que se muestran al configurar conexiones utilizando el modo de edición de señales y ranuras de Qt Widgets Designer. Más información...

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

Funciones públicas

QDesignerMemberSheetExtension()
QDesignerMemberSheetExtension(const QDesignerMemberSheetExtension &)
QDesignerMemberSheetExtension(QDesignerMemberSheetExtension &&)
virtual ~QDesignerMemberSheetExtension()
virtual int count() const = 0
virtual QString declaredInClass(int index) const = 0
virtual int indexOf(const QString &name) const = 0
virtual bool inheritedFromWidget(int index) const = 0
virtual bool isSignal(int index) const = 0
virtual bool isSlot(int index) const = 0
virtual bool isVisible(int index) const = 0
virtual QString memberGroup(int index) const = 0
virtual QString memberName(int index) const = 0
virtual QList<QByteArray> parameterNames(int index) const = 0
virtual QList<QByteArray> parameterTypes(int index) const = 0
virtual void setMemberGroup(int index, const QString &group) = 0
virtual void setVisible(int index, bool visible) = 0
virtual QString signature(int index) const = 0
QDesignerMemberSheetExtension &operator=(QDesignerMemberSheetExtension &&)
QDesignerMemberSheetExtension &operator=(const QDesignerMemberSheetExtension &)

Descripción detallada

QDesignerMemberSheetExtension es un conjunto de funciones que se utiliza habitualmente para consultar las funciones miembro de un widget y para manipular la apariencia de dichas funciones en el modo de edición de señales y ranuras de Qt Widgets Designer. Por ejemplo:

QDesignerMemberSheetExtension *memberSheet = nullptr;
QExtensionManager manager = formEditor->extensionManager();

memberSheet = qt_extension<QDesignerMemberSheetExtension*>(manager, widget);
int index = memberSheet->indexOf(setEchoMode);
memberSheet->setVisible(index, false);

delete memberSheet;

Al implementar un complemento de widget personalizado, la función ` QDesignerCustomWidgetInterface::initialize()` proporciona, como parámetro, un puntero al objeto ` QDesignerFormEditorInterface ` actual de Qt Widgets Designer(formEditor en el ejemplo anterior).

La hoja de miembros (y cualquier otra extensión) se puede recuperar consultando el gestor de extensiones de Qt Widgets Designer mediante la función qt_extension(). Cuando se desee liberar la extensión, solo es necesario eliminar el puntero.

Todos los widgets tienen una hoja de miembros predeterminada que se utiliza en el modo de edición de señales y ranuras de Qt Widgets Designer con las funciones de miembro del widget. Sin embargo, QDesignerMemberSheetExtension también proporciona una interfaz para crear extensiones de hojas de miembros personalizadas.

Advertencia: ` Qt Widgets Designer ` utiliza `QDesignerMemberSheetExtension` para facilitar el modo de edición de señales y ranuras. Cada vez que se solicita una conexión entre dos widgets, ` Qt Widgets Designer ` consultará las extensiones de hoja de miembros de los widgets. Si un widget tiene una extensión de hoja de miembros implementada, esta extensión anulará la hoja de miembros predeterminada.

Para crear una extensión de hoja de miembros, tu clase de extensión debe heredar tanto de ` QObject ` como de `QDesignerMemberSheetExtension`. A continuación, dado que estamos implementando una interfaz, debemos asegurarnos de que el sistema de metaobjetos la reconozca mediante la macro ` Q_INTERFACES()`:

class MyMemberSheetExtension : public QObject,
        public QDesignerMemberSheetExtension
{
    Q_OBJECT
    Q_INTERFACES(QDesignerMemberSheetExtension)

public:
    ...
}

Esto permite a ` Qt Widgets Designer ` utilizar ` qobject_cast()` para consultar las interfaces compatibles utilizando únicamente un puntero ` QObject `.

En Qt Widgets Designer, las extensiones no se crean hasta que son necesarias. Por ese motivo, al implementar una extensión de hoja de miembros, también debes crear un QExtensionFactory, es decir, una clase capaz de crear una instancia de tu extensión, y registrarla mediante extension manager de Qt Widgets Designer.

Cuando se requiere la extensión de hoja de miembros de un widget, el método ` extension manager ` de ` Qt Widgets Designer` recorrerá todas sus fábricas registradas llamando a ` QExtensionFactory::createExtension()` para cada una de ellas hasta que se encuentre la primera capaz de crear una extensión de hoja de miembros para ese widget. A continuación, dicha fábrica creará una instancia de la extensión. Si no se encuentra ninguna fábrica de este tipo, ` Qt Widgets Designer ` utilizará la hoja de miembros predeterminada.

Hay cuatro tipos de extensiones disponibles en Qt Widgets Designer: QDesignerContainerExtension, QDesignerMemberSheetExtension, QDesignerPropertySheetExtension y QDesignerTaskMenuExtension. El comportamiento de Qt Widgets Designer es el mismo independientemente de si la extensión solicitada está asociada a un contenedor de varias páginas, una hoja de miembros, una hoja de propiedades o un menú de tareas.

La clase ` QExtensionFactory ` proporciona una fábrica de extensiones estándar y también puede utilizarse como interfaz para fábricas de extensiones personalizadas. Puedes crear una nueva clase ` QExtensionFactory ` y reimplementar la función ` QExtensionFactory::createExtension()`. Por ejemplo:

QObject *ANewExtensionFactory::createExtension(QObject *object,
        const QString &iid, QObject *parent) const
{
    if (iid != Q_TYPEID(QDesignerMemberSheetExtension))
        return 0;

    if (MyCustomWidget *widget = qobject_cast<MyCustomWidget*>
           (object))
        return new MyMemberSheetExtension(widget, parent);

    return 0;
}

O bien, puede utilizar una fábrica existente, ampliando la función ` QExtensionFactory::createExtension()` para que la fábrica también pueda crear una extensión de hoja de miembros. Por ejemplo:

QObject *AGeneralExtensionFactory::createExtension(QObject *object,
        const QString &iid, QObject *parent) const
{
    MyCustomWidget *widget = qobject_cast<MyCustomWidget*>(object);

    if (widget && (iid == Q_TYPEID(QDesignerTaskMenuExtension))) {
        return new MyTaskMenuExtension(widget, parent);

    } else if (widget && (iid == Q_TYPEID(QDesignerMemberSheetExtension))) {
        return new MyMemberSheetExtension(widget, parent);

    } else {
        return 0;
    }
}

Para ver un ejemplo completo que utiliza una clase de extensión, consulta el ejemplo «Extensión del menú de tareas». El ejemplo muestra cómo crear un complemento de widget personalizado para « Qt Designer » y cómo utilizar la clase « QDesignerTaskMenuExtension » para añadir elementos personalizados al menú de tareas de « Qt Widgets Designer».

Véase también QExtensionFactory, QExtensionManager y Creación de extensiones de widgets personalizadas.

Documentación de las funciones de miembro

[constexpr noexcept default] QDesignerMemberSheetExtension::QDesignerMemberSheetExtension()

Crea por defecto una instancia de ` QDesignerMemberSheetExtension`.

[delete] QDesignerMemberSheetExtension::QDesignerMemberSheetExtension(const QDesignerMemberSheetExtension &)

Crea una instancia de ` QDesignerMemberSheetExtension` mediante copia. Esta función se ha eliminado.

[delete] QDesignerMemberSheetExtension::QDesignerMemberSheetExtension(QDesignerMemberSheetExtension &&)

Crea una instancia de ` QDesignerMemberSheetExtension`. Esta función se ha eliminado.

[virtual constexpr noexcept default] QDesignerMemberSheetExtension::~QDesignerMemberSheetExtension()

Elimina la extensión de la hoja de miembros.

[pure virtual] int QDesignerMemberSheetExtension::count() const

Devuelve el número de funciones miembro de la extensión.

[pure virtual] QString QDesignerMemberSheetExtension::declaredInClass(int index) const

Devuelve el nombre de la clase en la que se declara la función miembro con el index dado.

Véase también indexOf().

[pure virtual] int QDesignerMemberSheetExtension::indexOf(const QString &name) const

Devuelve el índice de la función miembro especificada por el name dado.

Véase también memberName().

[pure virtual] bool QDesignerMemberSheetExtension::inheritedFromWidget(int index) const

Devuelve «true» si la función miembro con el « index » indicado se hereda de « QWidget »; en caso contrario, devuelve «false».

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

[pure virtual] bool QDesignerMemberSheetExtension::isSignal(int index) const

Devuelve «true» si la función miembro con el index dado es una señal; en caso contrario, devuelve «false».

Véase también indexOf().

[pure virtual] bool QDesignerMemberSheetExtension::isSlot(int index) const

Devuelve «true» si la función miembro con el index dado es una ranura; en caso contrario, devuelve «false».

Véase también indexOf().

[pure virtual] bool QDesignerMemberSheetExtension::isVisible(int index) const

Devuelve «true» si la función miembro con el « index » indicado es visible en el editor de señales y ranuras de Qt Widgets Designer; en caso contrario, devuelve «false».

Véase también indexOf() y setVisible().

[pure virtual] QString QDesignerMemberSheetExtension::memberGroup(int index) const

Devuelve el nombre del grupo de miembros especificado para la función con el index dado.

Véase también indexOf() y setMemberGroup().

[pure virtual] QString QDesignerMemberSheetExtension::memberName(int index) const

Devuelve el nombre de la función miembro con el index especificado.

Véase también indexOf().

[pure virtual] QList<QByteArray> QDesignerMemberSheetExtension::parameterNames(int index) const

Devuelve los nombres de los parámetros de la función miembro con el index dado, en forma de lista QByteArray.

Véase también ` indexOf()` y ` parameterTypes()`.

[pure virtual] QList<QByteArray> QDesignerMemberSheetExtension::parameterTypes(int index) const

Devuelve los tipos de los parámetros de la función miembro con el index dado, en forma de lista QByteArray.

Véase también ` indexOf()` y ` parameterNames()`.

[pure virtual] void QDesignerMemberSheetExtension::setMemberGroup(int index, const QString &group)

Establece el grupo de miembro de la función miembro con el index dado en group.

Véanse también indexOf() y memberGroup().

[pure virtual] void QDesignerMemberSheetExtension::setVisible(int index, bool visible)

Si « visible » es verdadero, la función miembro con el « index » indicado es visible en el modo de edición de señales y ranuras de « Qt Widgets Designer »; en caso contrario, la función miembro queda oculta.

Véase también ` indexOf()` y ` isVisible()`.

[pure virtual] QString QDesignerMemberSheetExtension::signature(int index) const

Devuelve la firma de la función miembro con el index dado.

Véase también indexOf().

[delete] QDesignerMemberSheetExtension &QDesignerMemberSheetExtension::operator=(QDesignerMemberSheetExtension &&)

Asigna mediante «move» ` other ` a esta instancia de ` QDesignerMemberSheetExtension `. Esta función se elimina.

[delete] QDesignerMemberSheetExtension &QDesignerMemberSheetExtension::operator=(const QDesignerMemberSheetExtension &)

Asigna por copia « other » a esta instancia de « QDesignerMemberSheetExtension ». Esta función se ha eliminado.

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