QDesignerTaskMenuExtension Class
La clase QDesignerTaskMenuExtension te permite añadir entradas de menú personalizadas al menú de tareas de « Qt Widgets Designer ». Más información...
| Encabezado: | #include <QDesignerTaskMenuExtension> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Designer) target_link_libraries(mytarget PRIVATE Qt6::Designer) |
| qmake: | QT += designer |
Funciones públicas
| QDesignerTaskMenuExtension() | |
| QDesignerTaskMenuExtension(const QDesignerTaskMenuExtension &) | |
| QDesignerTaskMenuExtension(QDesignerTaskMenuExtension &&) | |
| virtual | ~QDesignerTaskMenuExtension() |
| virtual QAction * | preferredEditAction() const |
| virtual QList<QAction *> | taskActions() const = 0 |
| QDesignerTaskMenuExtension & | operator=(QDesignerTaskMenuExtension &&) |
| QDesignerTaskMenuExtension & | operator=(const QDesignerTaskMenuExtension &) |
Descripción detallada
QDesignerTaskMenuExtension proporciona una interfaz para crear extensiones personalizadas del menú de tareas. Se suele utilizar para crear entradas del menú de tareas específicas de un complemento en Qt Widgets Designer.
Qt Widgets Designer Qt Widgets Designer utiliza QDesignerTaskMenuExtension para alimentar su menú de tareas. Cada vez que se solicita un menú de tareas, consulta la extensión del menú de tareas del widget seleccionado.
Qt Widgets Designer." src="images/taskmenuextension-example.webp" title="Captura de pantalla de una acción personalizada «Editar estado...» en el menú contextual de Qt Widgets Designer."/>
Una extensión del menú de tareas es una colección de QActions. Las acciones aparecen como entradas en el menú de tareas cuando se selecciona el complemento con la extensión especificada. La imagen anterior muestra la acción personalizada «Editar estado...», que aparece además de las entradas predeterminadas del menú de tareas de Qt Widgets Designer: Cortar, Copiar, Pegar, etc.
Para crear una extensión personalizada del menú de tareas, tu clase de extensión debe heredar tanto de ` QObject ` como de `QDesignerTaskMenuExtension`. Por ejemplo:
class MyTaskMenuExtension : public QObject,
public QDesignerTaskMenuExtension
{
Q_OBJECT
Q_INTERFACES(QDesignerTaskMenuExtension)
public:
MyTaskMenuExtension(MyCustomWidget *widget, QObject *parent);
QAction *preferredEditAction() const;
QList<QAction *> taskActions() const;
private slots:
void mySlot();
private:
MyCustomWidget *widget;
QAction *myAction;
};Dado que estamos implementando una interfaz, debemos asegurarnos de que el sistema de metaobjetos la reconozca mediante la macro Q_INTERFACES(). Esto permite que Qt Widgets Designer utilice la función qobject_cast() para consultar las interfaces compatibles utilizando únicamente un puntero QObject.
Debes reimplementar la función taskActions() para que devuelva una lista de acciones que se incluirán en el menú de tareas de Qt Widgets Designer. Opcionalmente, puedes reimplementar la función preferredEditAction() para establecer la acción que se invocará al seleccionar tu complemento y pulsar F2. La acción de edición preferida debe ser una de las acciones devueltas por taskActions() y, si no está definida, al pulsar la tecla F2 simplemente se ignorará.
En Qt Widgets Designer, las extensiones no se crean hasta que son necesarias. Una extensión del menú de tareas, por ejemplo, se crea al hacer clic con el botón derecho del ratón sobre un widget en el espacio de trabajo de Qt Widgets Designer. Por ese motivo, también debes crear una fábrica de extensiones, utilizando QExtensionFactory o una subclase, y registrarla mediante extension manager de Qt Widgets Designer.
Cuando se requiere una extensión del menú de tareas, 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 encuentre una capaz de crear una extensión del menú de tareas para el widget seleccionado. A continuación, esta fábrica creará una instancia de la extensión.
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, 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(QDesignerTaskMenuExtension))
return 0;
if (MyCustomWidget *widget = qobject_cast<MyCustomWidget*>(object))
return new MyTaskMenuExtension(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 menú de tareas. Por ejemplo:
QObject *AGeneralExtensionFactory::createExtension(QObject *object,
const QString &iid, QObject *parent) const
{
MyCustomWidget *widget = qobject_cast<MyCustomWidget*>(object);
if (widget && (iid == Q_TYPEID(QDesignerContainerExtension))) {
return new MyContainerExtension(widget, parent);
} else if (widget && (iid == Q_TYPEID(QDesignerTaskMenuExtension))) {
return new MyTaskMenuExtension(widget, parent);
} else {
return 0;
}
}Para ver un ejemplo completo que utiliza la clase `QDesignerTaskMenuExtension`, consulta el ejemplo «Extensión del menú de tareas». El ejemplo muestra cómo crear un complemento de widget personalizado para ` Qt Widgets 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] QDesignerTaskMenuExtension::QDesignerTaskMenuExtension()
Crea por defecto una instancia de ` QDesignerTaskMenuExtension`.
[delete] QDesignerTaskMenuExtension::QDesignerTaskMenuExtension(const QDesignerTaskMenuExtension &)
Crea una instancia de ` QDesignerTaskMenuExtension` mediante copia. Esta función se ha eliminado.
[delete] QDesignerTaskMenuExtension::QDesignerTaskMenuExtension(QDesignerTaskMenuExtension &&)
Crea una instancia de ` QDesignerTaskMenuExtension`. Esta función se ha eliminado.
[virtual noexcept] QDesignerTaskMenuExtension::~QDesignerTaskMenuExtension()
Elimina la extensión del menú de tareas.
[virtual] QAction *QDesignerTaskMenuExtension::preferredEditAction() const
Devuelve la acción que se ejecuta al seleccionar un complemento con la extensión especificada y pulsar F2.
La acción debe ser una de las devueltas por taskActions().
[pure virtual] QList<QAction *> QDesignerTaskMenuExtension::taskActions() const
Devuelve la extensión del menú de tareas como una lista de acciones que se incluirán en el menú de tareas de Qt Widgets Designer cuando se seleccione un complemento con la extensión especificada.
La función debe reimplementarse para añadir acciones a la lista.
[delete] QDesignerTaskMenuExtension &QDesignerTaskMenuExtension::operator=(QDesignerTaskMenuExtension &&)
Asigna mediante «move» other a esta instancia de QDesignerTaskMenuExtension. Esta función se elimina.
[delete] QDesignerTaskMenuExtension &QDesignerTaskMenuExtension::operator=(const QDesignerTaskMenuExtension &)
Asigna por copia other a esta instancia de QDesignerTaskMenuExtension. 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.