QDesignerPropertyEditorInterface Class

Ausführliche Beschreibung

QDesignerPropertyEditorInterface enthält eine Sammlung von Funktionen, die typischerweise dazu dienen, den Eigenschaftseditor nach seinem aktuellen Zustand abzufragen, sowie mehrere Slots, die seinen Zustand manipulieren. Die Schnittstelle stellt außerdem ein Signal bereit: „ propertyChanged()“, das immer dann ausgelöst wird, wenn sich eine Eigenschaft im Eigenschaftseditor ändert. Die Argumente des Signals sind die geänderte Eigenschaft und ihr neuer Wert.

Wenn Sie beispielsweise ein benutzerdefiniertes Widget-Plugin implementieren, können Sie das Signal mit einem benutzerdefinierten Slot verbinden:

        auto *propertyEditor = formEditor->propertyEditor();

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

Dann kann der benutzerdefinierte Slot prüfen, ob der neue Wert innerhalb des gewünschten Bereichs liegt, wenn sich eine bestimmte Eigenschaft eines bestimmten Widgets ändert:

        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)
                {...}
        }

Die Klasse `QDesignerPropertyEditorInterface` ist nicht dafür vorgesehen, direkt instanziiert zu werden. Sie können eine Schnittstelle zum Eigenschaftseditor von „ Qt Widgets “ Designer mithilfe der Funktion ` QDesignerFormEditorInterface::propertyEditor()` abrufen. Ein Zeiger auf das aktuelle ` QDesignerFormEditorInterface `-Objekt von „ Qt Widgets “ Designer (in den obigen Beispielen `formEditor `) wird über den Parameter der Funktion ` QDesignerCustomWidgetInterface::initialize()` bereitgestellt. Bei der Implementierung eines benutzerdefinierten Widget-Plugins müssen Sie eine Unterklasse von ` QDesignerCustomWidgetInterface ` erstellen, um Ihr Plugin für „ Qt Widgets “ Designer verfügbar zu machen.

Die Funktionen, die auf den Eigenschaftseditor zugreifen, sind die Funktion ` core()`, mit der Sie eine Schnittstelle zum Formulareditor abrufen können, die Funktion ` currentPropertyName()`, die den Namen der aktuell im Eigenschaftseditor ausgewählten Eigenschaft zurückgibt, die Funktion ` object()`, die das aktuell im Arbeitsbereich des „ Qt Widgets “-Designers ausgewählte Objekt zurückgibt, sowie die Funktion ` isReadOnly()`, die `true` zurückgibt, wenn der Eigenschaftseditor schreibgeschützt ist (ansonsten `false`).

Die Slots, die den Zustand des Eigenschafteneditors steuern, sind der Slot „ setObject()“, mit dem Sie das aktuell ausgewählte Objekt im Arbeitsbereich des „ Qt Widgets “-Designers ändern können, der Slot „ setPropertyValue()“, der den Wert einer bestimmten Eigenschaft ändert, und der Slot „ setReadOnly()“, der den Schreibschutz des Eigenschafteneditors steuert.