QDesignerFormWindowCursorInterface Class
Die Klasse QDesignerFormWindowCursorInterface ermöglicht es, die Widgetauswahl eines Formularfensters abzufragen und zu verändern und darüber hinaus die Eigenschaften aller Widgets des Formulars zu verändern. Mehr...
| Kopfzeile: | #include <QDesignerFormWindowCursorInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Designer)target_link_libraries(mytarget PRIVATE Qt6::Designer) |
| qmake: | QT += designer |
Öffentliche Typen
| enum | MoveMode { MoveAnchor, KeepAnchor } |
| enum | MoveOperation { NoMove, Start, End, Next, Prev, …, Down } |
Öffentliche Funktionen
| virtual | ~QDesignerFormWindowCursorInterface() |
| virtual QWidget * | current() const = 0 |
| virtual QDesignerFormWindowInterface * | formWindow() const = 0 |
| virtual bool | hasSelection() const = 0 |
| bool | isWidgetSelected(QWidget *widget) const |
| virtual bool | movePosition(QDesignerFormWindowCursorInterface::MoveOperation operation, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor) = 0 |
| virtual int | position() const = 0 |
| virtual void | resetWidgetProperty(QWidget *widget, const QString &name) = 0 |
| virtual QWidget * | selectedWidget(int index) const = 0 |
| virtual int | selectedWidgetCount() const = 0 |
| virtual void | setPosition(int position, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor) = 0 |
| virtual void | setProperty(const QString &name, const QVariant &value) = 0 |
| virtual void | setWidgetProperty(QWidget *widget, const QString &name, const QVariant &value) = 0 |
| virtual QWidget * | widget(int index) const = 0 |
| virtual int | widgetCount() const = 0 |
Detaillierte Beschreibung
QDesignerFormWindowCursorInterface ist eine Bequemlichkeitsklasse, die eine Schnittstelle zum Textcursor des zugehörigen Formularfensters bereitstellt; sie bietet eine Sammlung von Funktionen, mit denen Sie die Auswahl eines bestimmten Formularfensters abfragen und den Fokus der Auswahl gemäß definierter Modi (MoveMode) und Bewegungen (MoveOperation) ändern können. Sie können die Schnittstelle auch verwenden, um die Widgets des Formulars abzufragen und ihre Eigenschaften zu ändern.
Die Schnittstelle ist nicht dazu gedacht, direkt instanziiert zu werden, sondern den Zugriff auf die Auswahlen und Widgets der aktuellen Formularfenster von Qt Widgets Designer zu ermöglichen. QDesignerFormWindowInterface bietet immer eine zugehörige Cursor-Schnittstelle. Das Formularfenster für ein bestimmtes Widget kann mit den statischen Funktionen QDesignerFormWindowInterface::findFormWindow() abgerufen werden. Ein Beispiel:
auto *formWindow = QDesignerFormWindowInterface::findFormWindow(myWidget); formWindow->cursor()->setProperty(myWidget, myProperty, newValue);
Sie können jedes der aktuellen Formularfenster von Qt Widgets Designer über Qt Widgets Designer's form window manager abrufen.
Sobald Sie die Cursor-Schnittstelle eines Formularfensters haben, können Sie mit der Funktion hasSelection() überprüfen, ob das Formularfenster überhaupt eine Auswahl hat. Sie können das Formularfenster auf seine Gesamtanzahl widgetCount() und selectedWidgetCount() abfragen. Sie können das aktuell ausgewählte Widget (oder die Widgets) mit den Funktionen current() oder selectedWidget() abrufen.
Sie können jedes beliebige Widget des Formularfensters mit der Funktion widget() abrufen und mit der Funktion isWidgetSelected() prüfen, ob ein Widget ausgewählt ist. Sie können die Funktion setProperty() verwenden, um die Eigenschaften des ausgewählten Widgets festzulegen, und die Funktionen setWidgetProperty() oder resetWidgetProperty(), um die Eigenschaften eines beliebigen Widgets zu ändern.
Schließlich können Sie die Auswahl ändern, indem Sie die position() des Textcursors mit den Funktionen setPosition() und movePosition() ändern.
Siehe auch QDesignerFormWindowInterface und QDesignerFormWindowManagerInterface.
Dokumentation der Mitgliedstypen
enum QDesignerFormWindowCursorInterface::MoveMode
Diese Aufzählung beschreibt die verschiedenen Modi, die verwendet werden, wenn sich der Textcursor bewegt.
| Konstante | Wert | Beschreibung |
|---|---|---|
QDesignerFormWindowCursorInterface::MoveAnchor | 0 | Der Anker bewegt sich mit dem Cursor an seine neue Position. |
QDesignerFormWindowCursorInterface::KeepAnchor | 1 | Der Anker bleibt an der alten Position des Cursors. |
enum QDesignerFormWindowCursorInterface::MoveOperation
Diese Aufzählung beschreibt die Arten von Textcursoroperationen, die in einem Formularfenster auftreten können.
| Konstante | Wert | Beschreibung |
|---|---|---|
QDesignerFormWindowCursorInterface::NoMove | 0 | Der Cursor bewegt sich nicht. |
QDesignerFormWindowCursorInterface::Start | 1 | Bewegt den Cursor an den Anfang der Fokuskette. |
QDesignerFormWindowCursorInterface::End | 2 | Bewegt den Cursor an das Ende der Fokuskette. |
QDesignerFormWindowCursorInterface::Next | 3 | Bewegt den Cursor zum nächsten Widget in der Fokuskette. |
QDesignerFormWindowCursorInterface::Prev | 4 | Bewegt den Cursor auf das vorherige Widget in der Fokuskette. |
QDesignerFormWindowCursorInterface::Left | 5 | Der Cursor bewegt sich nach links. |
QDesignerFormWindowCursorInterface::Right | 6 | Der Cursor bewegt sich nach rechts. |
QDesignerFormWindowCursorInterface::Up | 7 | Der Cursor bewegt sich nach oben. |
QDesignerFormWindowCursorInterface::Down | 8 | Der Cursor bewegt sich nach unten. |
Dokumentation der Mitgliedsfunktionen
[virtual constexpr noexcept] QDesignerFormWindowCursorInterface::~QDesignerFormWindowCursorInterface()
Zerstört die Cursorschnittstelle.
[pure virtual] QWidget *QDesignerFormWindowCursorInterface::current() const
Gibt das aktuell ausgewählte Widget im Formularfenster zurück.
Siehe auch selectedWidget().
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowCursorInterface::formWindow() const
Gibt die mit dieser Cursorschnittstelle verbundene Formularfensterschnittstelle zurück.
[pure virtual] bool QDesignerFormWindowCursorInterface::hasSelection() const
Gibt true zurück, wenn das Formularfenster eine Auswahl enthält; andernfalls wird false zurückgegeben.
bool QDesignerFormWindowCursorInterface::isWidgetSelected(QWidget *widget) const
Gibt true zurück, wenn die angegebene widget ausgewählt ist; andernfalls wird false zurückgegeben.
[pure virtual] bool QDesignerFormWindowCursorInterface::movePosition(QDesignerFormWindowCursorInterface::MoveOperation operation, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor)
Führt die angegebene operation mit dem Cursor unter Verwendung der angegebenen mode aus und gibt true zurück, wenn sie erfolgreich abgeschlossen wurde; andernfalls wird false zurückgegeben.
Siehe auch position() und setPosition().
[pure virtual] int QDesignerFormWindowCursorInterface::position() const
Gibt die Position des Cursors zurück.
Siehe auch setPosition() und movePosition().
[pure virtual] void QDesignerFormWindowCursorInterface::resetWidgetProperty(QWidget *widget, const QString &name)
Setzt die Eigenschaft mit der angegebenen name für die angegebene widget auf ihren Standardwert zurück.
Siehe auch setProperty() und setWidgetProperty().
[pure virtual] QWidget *QDesignerFormWindowCursorInterface::selectedWidget(int index) const
Gibt das Widget mit dem angegebenen index in der Liste der ausgewählten Widgets zurück.
Siehe auch current() und widget().
[pure virtual] int QDesignerFormWindowCursorInterface::selectedWidgetCount() const
Gibt die Anzahl der ausgewählten Widgets im Formularfenster zurück.
Siehe auch widgetCount().
[pure virtual] void QDesignerFormWindowCursorInterface::setPosition(int position, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor)
Setzt die Position des Cursors auf die angegebene position, wobei die mode angibt, wie er dorthin bewegt wird.
Siehe auch position() und movePosition().
[pure virtual] void QDesignerFormWindowCursorInterface::setProperty(const QString &name, const QVariant &value)
Setzt die Eigenschaft mit der angegebenen name für das aktuell ausgewählte Widget auf die angegebene value.
Siehe auch setWidgetProperty() und resetWidgetProperty().
[pure virtual] void QDesignerFormWindowCursorInterface::setWidgetProperty(QWidget *widget, const QString &name, const QVariant &value)
Setzt die Eigenschaft mit der angegebenen name für die angegebene widget auf die angegebene value.
Siehe auch resetWidgetProperty() und setProperty().
[pure virtual] QWidget *QDesignerFormWindowCursorInterface::widget(int index) const
Gibt das Widget mit dem angegebenen index in der Liste der Widgets im Formularfenster zurück.
Siehe auch selectedWidget().
[pure virtual] int QDesignerFormWindowCursorInterface::widgetCount() const
Gibt die Anzahl der Widgets im Formularfenster zurück.
Siehe auch selectedWidgetCount().
© 2025 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.
