QDesignerCustomWidgetInterface Class

Descripción Detallada

QDesignerCustomWidgetInterface proporciona un widget personalizado con una interfaz. La clase contiene un conjunto de funciones que deben ser subclasificadas para devolver información básica sobre el widget, como su nombre de clase y el nombre de su archivo de cabecera. Deben implementarse otras funciones para inicializar el plugin cuando se carga, y para construir instancias del widget personalizado para que lo utilice Qt Widgets Designer.

Cuando implementes un widget personalizado debes subclasificar QDesignerCustomWidgetInterface para exponer tu widget a Qt Widgets Designer. Por ejemplo, esta es la declaracion para el plugin usado en el ejemplo Custom Widget Plugin que permite que un widget de reloj analogico sea usado por Qt Widgets Designer:

class AnalogClockPlugin : public QObject, public QDesignerCustomWidgetInterface
{
    Q_OBJECT
    Q_PLUGIN_METADATA(IID "org.qt-project.Qt.QDesignerCustomWidgetInterface")
    Q_INTERFACES(QDesignerCustomWidgetInterface)
public:
    explicit AnalogClockPlugin(QObject *parent = nullptr);

    bool isContainer() const override;
    bool isInitialized() const override;
    QIcon icon() const override;
    QString domXml() const override;
    QString group() const override;
    QString includeFile() const override;
    QString name() const override;
    QString toolTip() const override;
    QString whatsThis() const override;
    QWidget *createWidget(QWidget *parent) override;
    void initialize(QDesignerFormEditorInterface *core) override;

private:
    bool initialized = false;
};

Observa que la única parte de la definición de la clase que es específica de este widget personalizado en particular es el nombre de la clase. Además, puesto que estamos implementando una interfaz, debemos asegurarnos de que se da a conocer al sistema de metaobjetos mediante la macro Q_INTERFACES(). Esto permite a Qt Widgets Designer utilizar la función qobject_cast() para buscar interfaces compatibles utilizando únicamente un puntero QObject.

Después de que Qt Widgets Designer cargue un plugin de widget personalizado, llama a la función initialize() de la interfaz para permitirle configurar cualquier recurso que pueda necesitar. Esta función se llama con un parámetro QDesignerFormEditorInterface que proporciona al plugin una puerta de acceso a toda la API de Qt Widgets Designer.

Qt Widgets Designer construye instancias del widget personalizado llamando a la función createWidget() del plugin con un widget padre adecuado. Los plugins deben construir y devolver una instancia de un widget personalizado con el widget padre especificado.

Exporte su plugin de widget personalizado a Qt Widgets Designer utilizando la macro Q_PLUGIN_METADATA(). Por ejemplo, si una biblioteca llamada libcustomwidgetplugin.so (en Unix) o libcustomwidget.dll (en Windows) contiene una clase widget llamada MyCustomWidget, podemos exportarla añadiendo la siguiente línea al archivo que contiene la cabecera del plugin:

Q_PLUGIN_METADATA(IID "org.qt-project.Qt.QDesignerCustomWidgetInterface")

Esta macro garantiza que Qt Widgets Designer pueda acceder al widget personalizado y construirlo. Sin esta macro, no hay forma de que Qt Widgets Designer pueda utilizarlo.

Cuando implementas un plugin de widget personalizado, lo construyes como una librería separada. Si quieres incluir varios plugins de widgets personalizados en la misma biblioteca, debes además subclasificar QDesignerCustomWidgetCollectionInterface.

• QVariant::ByteArray
• QVariant::Bool
• QVariant::Color
• QVariant::Cursor
• QVariant::Fecha
• QVariant::DateTime
• QVariant::Double
• QVariante::Int
• QVariant::Punto
• QVariant::Rect
• QVariant::Tamaño
• QVariant::PolíticaTamaño
• QVariant::Cadena
• QVariant::Tiempo
• QVariante::UInt

Para ver un ejemplo completo utilizando la clase QDesignerCustomWidgetInterface, consulta el Ejemplo de Widget Personalizado. El ejemplo muestra cómo crear un plugin de widget personalizado para Qt Widgets Designer.