QDesignerFormWindowCursorInterface Class
Die Klasse „QDesignerFormWindowCursorInterface“ ermöglicht es Ihnen, die Widget-Auswahl eines Formularfensters abzufragen und zu ändern sowie zusätzlich die Eigenschaften aller Widgets des Formulars zu ändern. Mehr...
| Überschrift: | #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
| QDesignerFormWindowCursorInterface() | |
| QDesignerFormWindowCursorInterface(const QDesignerFormWindowCursorInterface &) | |
| QDesignerFormWindowCursorInterface(QDesignerFormWindowCursorInterface &&) | |
| 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 |
| QDesignerFormWindowCursorInterface & | operator=(QDesignerFormWindowCursorInterface &&) |
| QDesignerFormWindowCursorInterface & | operator=(const QDesignerFormWindowCursorInterface &) |
Ausführliche Beschreibung
QDesignerFormWindowCursorInterface ist eine Komfortklasse, die eine Schnittstelle zum Textcursor des zugehörigen Formularfensters bereitstellt; sie bietet eine Reihe von Funktionen, mit denen Sie die Auswahl eines bestimmten Formularfensters abfragen und den Fokus der Auswahl entsprechend definierten Modi (MoveMode) und Bewegungen (MoveOperation) ändern können. Sie können die Schnittstelle auch nutzen, um die Widgets des Formulars abzufragen und deren Eigenschaften zu ändern.
Die Schnittstelle ist nicht dafür vorgesehen, direkt instanziiert zu werden, sondern soll Zugriff auf die Markierungen und Widgets der aktuellen Formularfenster des „ Qt Widgets Designer“ gewähren. „ QDesignerFormWindowInterface “ stellt stets eine zugehörige Cursor-Schnittstelle bereit. Das Formularfenster für ein bestimmtes Widget kann mithilfe der statischen Funktionen „ QDesignerFormWindowInterface::findFormWindow()“ abgerufen werden. Beispiel:
auto *formWindow = QDesignerFormWindowInterface::findFormWindow(myWidget);
formWindow->cursor()->setProperty(myWidget, myProperty, newValue);Sie können jedes der aktuellen Formularfenster des „ Qt Widgets “ Designers über die Funktion „ form window manager “ des „ Qt Widgets “ Designers abrufen.
Sobald Sie über die Cursor-Schnittstelle eines Formularfensters verfügen, können Sie mithilfe der Funktion „ hasSelection()“ prüfen, ob das Formularfenster überhaupt eine Auswahl enthält. Sie können das Formularfenster nach seiner Gesamtanzahl („ widgetCount()“) und der Anzahl der ausgewählten Widgets („ selectedWidgetCount()“) abfragen. Das aktuell ausgewählte Widget (oder die Widgets) können Sie mithilfe der Funktionen „ current()“ oder „ selectedWidget()“ abrufen.
Mit der Funktion „ widget()“ können Sie jedes beliebige Widget des Formularfensters abrufen und mit der Funktion „ isWidgetSelected()“ prüfen, ob ein Widget ausgewählt ist. Mit der Funktion „ setProperty()“ können Sie die Eigenschaften des ausgewählten Widgets festlegen, und mit den Funktionen „ setWidgetProperty()“ oder „ resetWidgetProperty()“ können Sie die Eigenschaften eines beliebigen Widgets ändern.
Schließlich können Sie die Auswahl ändern, indem Sie die Position des Textcursors ( position()) mithilfe der Funktionen ` setPosition()` und ` movePosition()` anpassen.
Siehe auch „ QDesignerFormWindowInterface “ und „ QDesignerFormWindowManagerInterface “.
Dokumentation zu Mitgliedstypen
enum QDesignerFormWindowCursorInterface::MoveMode
Diese Enumeration beschreibt die verschiedenen Modi, die beim Bewegen des Textcursors verwendet werden.
| Konstante | Wert | Beschreibung |
|---|---|---|
QDesignerFormWindowCursorInterface::MoveAnchor | 0 | Der Anker bewegt sich mit dem Cursor an dessen neue Position. |
QDesignerFormWindowCursorInterface::KeepAnchor | 1 | Der Anker verbleibt an der alten Position des Cursors. |
enum QDesignerFormWindowCursorInterface::MoveOperation
Diese Enumeration beschreibt die Arten von Textcursor-Operationen, 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 Fokus-Kette. |
QDesignerFormWindowCursorInterface::End | 2 | Bewegt den Cursor an das Ende der Fokus-Kette. |
QDesignerFormWindowCursorInterface::Next | 3 | Bewegt den Cursor zum nächsten Widget in der Fokus-Kette. |
QDesignerFormWindowCursorInterface::Prev | 4 | Bewegt den Cursor zum vorherigen Widget in der Fokus-Kette. |
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 Member-Funktionen
[constexpr noexcept default] QDesignerFormWindowCursorInterface::QDesignerFormWindowCursorInterface()
Erstellt standardmäßig eine Instanz von ` QDesignerFormWindowCursorInterface`.
[delete] QDesignerFormWindowCursorInterface::QDesignerFormWindowCursorInterface(const QDesignerFormWindowCursorInterface &)
Erstellt eine Instanz von „ QDesignerFormWindowCursorInterface “ durch Kopieren. Diese Funktion wurde gelöscht.
[delete] QDesignerFormWindowCursorInterface::QDesignerFormWindowCursorInterface(QDesignerFormWindowCursorInterface &&)
Erzeugt eine Instanz von „ QDesignerFormWindowCursorInterface “. Diese Funktion wurde gelöscht.
[virtual constexpr noexcept default] QDesignerFormWindowCursorInterface::~QDesignerFormWindowCursorInterface()
Löst die Cursor-Oberfläche auf.
[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 Formularfenster-Schnittstelle zurück, die dieser Cursor-Schnittstelle zugeordnet ist.
[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 das 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 Funktion ` operation ` auf dem Cursor unter Verwendung der angegebenen ` mode` aus und gibt „true“ zurück, wenn der Vorgang erfolgreich abgeschlossen wurde; andernfalls wird „false“ zurückgegeben.
Siehe auch ` position()` und ` setPosition()`.
[pure virtual] int QDesignerFormWindowCursorInterface::position() const
Gibt die Cursorposition zurück.
Siehe auch setPosition() und movePosition().
[pure virtual] void QDesignerFormWindowCursorInterface::resetWidgetProperty(QWidget *widget, const QString &name)
Setzt die Eigenschaft mit dem 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 der 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 Koordinaten position, wobei mit dem Parameter „ mode “ festgelegt wird, wie der Cursor dorthin bewegt wird.
Siehe auch position() und movePosition().
[pure virtual] void QDesignerFormWindowCursorInterface::setProperty(const QString &name, const QVariant &value)
Setzt die Eigenschaft mit dem angegebenen „ name “ für das aktuell ausgewählte Widget auf den angegebenen „ value “.
Siehe auch setWidgetProperty() und resetWidgetProperty().
[pure virtual] void QDesignerFormWindowCursorInterface::setWidgetProperty(QWidget *widget, const QString &name, const QVariant &value)
Setzt die Eigenschaft mit dem angegebenen name für die angegebene widget auf den angegebenen value.
Siehe auch resetWidgetProperty() und setProperty().
[pure virtual] QWidget *QDesignerFormWindowCursorInterface::widget(int index) const
Gibt das Widget mit der 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()`.
[delete] QDesignerFormWindowCursorInterface &QDesignerFormWindowCursorInterface::operator=(QDesignerFormWindowCursorInterface &&)
Weist „ other “ dieser „ QDesignerFormWindowCursorInterface “-Instanz zu. Diese Funktion wird gelöscht.
[delete] QDesignerFormWindowCursorInterface &QDesignerFormWindowCursorInterface::operator=(const QDesignerFormWindowCursorInterface &)
other Weist dieser „ QDesignerFormWindowCursorInterface “-Instanz „ “ durch Kopieren zu. Diese Funktion wird gelöscht.
© 2026 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.
