QDesignerPropertyEditorInterface Class

Detaillierte Beschreibung

QDesignerPropertyEditorInterface enthält eine Sammlung von Funktionen, die typischerweise verwendet werden, um den Eigenschaftseditor nach seinem aktuellen Zustand abzufragen, sowie mehrere Slots, die seinen Zustand manipulieren. Die Schnittstelle bietet auch ein Signal, propertyChanged(), das immer dann ausgegeben wird, wenn sich eine Eigenschaft im Eigenschaftseditor ändert. Die Argumente des Signals sind die geänderte Eigenschaft und ihr neuer Wert.

Wenn Sie zum Beispiel 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, die zu einem bestimmten Widget gehört, ä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 dazu gedacht, direkt instanziiert zu werden. Sie können eine Schnittstelle zu Qt Widgets Designers Eigenschaftseditor mit der Funktion QDesignerFormEditorInterface::propertyEditor() abrufen. Ein Zeiger auf Qt Widgets Designer's aktuelles QDesignerFormEditorInterface Objekt (formEditor in den obigen Beispielen) wird durch den Parameter der Funktion QDesignerCustomWidgetInterface::initialize() bereitgestellt. Wenn Sie ein benutzerdefiniertes Widget-Plugin implementieren, müssen Sie die Subklasse QDesignerCustomWidgetInterface verwenden, um Ihr Plugin dem Qt Widgets Designer zur Verfügung zu stellen.

Die Funktionen, die auf den Eigenschaftseditor zugreifen, sind die Funktion core(), mit der Sie eine Schnittstelle zum Formular-Editor abrufen können, die Funktion currentPropertyName(), die den Namen der aktuell ausgewählten Eigenschaft im Eigenschaftseditor zurückgibt, die Funktion object(), die das aktuell ausgewählte Objekt im Arbeitsbereich von Qt Widgets Designer zurückgibt, und die Funktion isReadOnly(), die true zurückgibt, wenn der Eigenschaftseditor schreibgeschützt ist (sonst false).

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