QDesignerCustomWidgetInterface Class

Description détaillée

QDesignerCustomWidgetInterface fournit une interface à un widget personnalisé. La classe contient un ensemble de fonctions qui doivent être redéfinies dans les sous-classes pour renvoyer des informations de base sur le widget, telles que le nom de sa classe et le nom de son fichier d'en-tête. D'autres fonctions doivent être implémentées pour initialiser le plugin lors de son chargement et pour créer des instances du widget personnalisé destinées à être utilisées par le Designer d'Qt Widgets.

Lors de l’implémentation d’un widget personnalisé, vous devez créer une sous-classe de QDesignerCustomWidgetInterface afin de rendre votre widget accessible à l’ Qt Widgets Designer. Par exemple, voici la déclaration du plugin utilisé dans l’exemple « Custom Widget Plugin », qui permet d’utiliser un widget personnalisé représentant une horloge analogique dans l’ 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;
};

Notez que la seule partie de la définition de classe spécifique à ce widget personnalisé particulier est le nom de la classe. De plus, puisque nous implémentons une interface, nous devons nous assurer qu’elle est signalée au système de méta-objets à l’aide de la macro ` Q_INTERFACES()`. Cela permet à Qt Widgets Designer d’utiliser la fonction ` qobject_cast()` pour rechercher les interfaces prises en charge en utilisant uniquement un pointeur ` QObject `.

Qt Widgets Une fois qu’ initialize Designer a chargé un plugin de widget personnalisé, il appelle la fonction () de l’interface pour lui permettre de configurer toutes les ressources dont il pourrait avoir besoin. Cette fonction est appelée avec un paramètre QDesignerFormEditorInterface qui fournit au plugin un accès à l’ensemble de l’API d’ Qt Widgets Designer.

Qt Widgets Designer crée des instances du widget personnalisé en appelant la fonction createWidget() du plug-in avec un widget parent approprié. Les plug-ins doivent créer et renvoyer une instance d’un widget personnalisé avec le widget parent spécifié.

Exportation de votre plugin de widget personnalisé vers Qt Widgets Designer à l’aide de la macro Q_PLUGIN_METADATA(). Par exemple, si une bibliothèque nommée libcustomwidgetplugin.so (sous Unix) ou libcustomwidget.dll (sous Windows) contient une classe de widget nommée MyCustomWidget, nous pouvons l’exporter en ajoutant la ligne suivante au fichier contenant l’en-tête du plugin :

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

Cette macro garantit que le concepteur d’ Qt Widgets s peut accéder au widget personnalisé et le créer. Sans cette macro, le concepteur d’ Qt Widgets s ne peut en aucun cas l’utiliser.

Lors de l’implémentation d’un plugin de widget personnalisé, vous le compilez sous la forme d’une bibliothèque distincte. Si vous souhaitez inclure plusieurs plugins de widgets personnalisés dans la même bibliothèque, vous devez en outre créer une sous-classe de ` QDesignerCustomWidgetCollectionInterface`.

• QVariant::ByteArray
• QVariant::Bool
• QVariant::Color
• QVariant::Cursor
• QVariant::Date
• QVariant::DateTime
• QVariant::Double
• QVariant::Int
• QVariant::Point
• QVariant::Rect
• QVariant::Size
• QVariant::SizePolicy
• QVariant::String
• QVariant::Time
• QVariant::UInt

Pour un exemple complet utilisant la classe QDesignerCustomWidgetInterface, consultez l'exemple de widget personnalisé. Cet exemple montre comment créer un plugin de widget personnalisé pour le Designer d'Qt Widgets.