QDesignerFormWindowCursorInterface Class
La classe `QDesignerFormWindowCursorInterface` vous permet d'interroger et de modifier la sélection des widgets d'une fenêtre de formulaire, ainsi que de modifier les propriétés de tous les widgets de ce formulaire. En savoir plus...
| En-tête : | #include <QDesignerFormWindowCursorInterface> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Designer) target_link_libraries(mytarget PRIVATE Qt6::Designer) |
| qmake : | QT += designer |
Types publics
| enum | MoveMode { MoveAnchor, KeepAnchor } |
| enum | MoveOperation { NoMove, Start, End, Next, Prev, …, Down } |
Fonctions publiques
| 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 &) |
Description détaillée
QDesignerFormWindowCursorInterface est une classe utilitaire qui fournit une interface vers le curseur de texte de la fenêtre de formulaire associée ; elle propose un ensemble de fonctions permettant d’interroger la sélection d’une fenêtre de formulaire donnée et de modifier le focus de cette sélection selon des modes (MoveMode) et des mouvements (MoveOperation) définis. Vous pouvez également utiliser cette interface pour interroger les widgets du formulaire et modifier leurs propriétés.
Cette interface n’est pas destinée à être instanciée directement, mais à fournir un accès aux sélections et aux widgets des fenêtres de formulaire actives dans Qt Widgets Designer. QDesignerFormWindowInterface fournit toujours une interface de curseur associée. La fenêtre de formulaire correspondant à un widget donné peut être récupérée à l’aide des fonctions statiques QDesignerFormWindowInterface::findFormWindow(). Par exemple :
auto *formWindow = QDesignerFormWindowInterface::findFormWindow(myWidget);
formWindow->cursor()->setProperty(myWidget, myProperty, newValue);Vous pouvez récupérer n’importe quelle fenêtre de formulaire active d’ Qt Widgets Designer via la fonction form window manager d’ Qt Widgets Designer.
Une fois que vous disposez de l’interface du curseur d’une fenêtre de formulaire, vous pouvez vérifier si celle-ci contient une sélection à l’aide de la fonction ` hasSelection()`. Vous pouvez interroger la fenêtre de formulaire pour connaître le nombre total de ` widgetCount()` et ` selectedWidgetCount()`. Vous pouvez récupérer le ou les widgets actuellement sélectionnés à l’aide des fonctions ` current()` ou ` selectedWidget()`.
Vous pouvez récupérer n’importe quel widget de la fenêtre de formulaire à l’aide de la fonction widget(), et vérifier si un widget est sélectionné à l’aide de la fonction isWidgetSelected(). Vous pouvez utiliser la fonction setProperty() pour définir les propriétés du widget sélectionné, et les fonctions setWidgetProperty() ou resetWidgetProperty() pour modifier les propriétés d’un widget donné.
Enfin, vous pouvez modifier la sélection en modifiant la position du curseur texte ( position()) à l’aide des fonctions setPosition() et movePosition().
Voir également QDesignerFormWindowInterface et QDesignerFormWindowManagerInterface.
Documentation sur les types de membres
enum QDesignerFormWindowCursorInterface::MoveMode
Cette énumération décrit les différents modes utilisés lors du déplacement du curseur de texte.
| Constante | Valeur | Description |
|---|---|---|
QDesignerFormWindowCursorInterface::MoveAnchor | 0 | L'ancre se déplace avec le curseur vers son nouvel emplacement. |
QDesignerFormWindowCursorInterface::KeepAnchor | 1 | L'ancre reste à l'ancien emplacement du curseur. |
enum QDesignerFormWindowCursorInterface::MoveOperation
Cette énumération décrit les types d'opérations du curseur de texte pouvant se produire dans une fenêtre de formulaire.
| Constante | Valeur | Description |
|---|---|---|
QDesignerFormWindowCursorInterface::NoMove | 0 | Le curseur ne se déplace pas. |
QDesignerFormWindowCursorInterface::Start | 1 | Déplace le curseur au début de la chaîne de focus. |
QDesignerFormWindowCursorInterface::End | 2 | Déplace le curseur à la fin de la chaîne de focus. |
QDesignerFormWindowCursorInterface::Next | 3 | Déplace le curseur vers le widget suivant dans la chaîne de focus. |
QDesignerFormWindowCursorInterface::Prev | 4 | Déplace le curseur vers le widget précédent de la chaîne de focus. |
QDesignerFormWindowCursorInterface::Left | 5 | Le curseur se déplace vers la gauche. |
QDesignerFormWindowCursorInterface::Right | 6 | Le curseur se déplace vers la droite. |
QDesignerFormWindowCursorInterface::Up | 7 | Le curseur se déplace vers le haut. |
QDesignerFormWindowCursorInterface::Down | 8 | Le curseur se déplace vers le bas. |
Documentation des fonctions membres
[constexpr noexcept default] QDesignerFormWindowCursorInterface::QDesignerFormWindowCursorInterface()
Construit par défaut une instance de ` QDesignerFormWindowCursorInterface`.
[delete] QDesignerFormWindowCursorInterface::QDesignerFormWindowCursorInterface(const QDesignerFormWindowCursorInterface &)
Copie et construit une instance de ` QDesignerFormWindowCursorInterface`. Cette fonction est supprimée.
[delete] QDesignerFormWindowCursorInterface::QDesignerFormWindowCursorInterface(QDesignerFormWindowCursorInterface &&)
Crée par « move » une instance de ` QDesignerFormWindowCursorInterface`. Cette fonction est supprimée.
[virtual constexpr noexcept default] QDesignerFormWindowCursorInterface::~QDesignerFormWindowCursorInterface()
Supprime l'interface du curseur.
[pure virtual] QWidget *QDesignerFormWindowCursorInterface::current() const
Renvoie le widget actuellement sélectionné dans la fenêtre du formulaire.
Voir aussi selectedWidget().
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowCursorInterface::formWindow() const
Renvoie l'interface de la fenêtre de formulaire associée à cette interface de curseur.
[pure virtual] bool QDesignerFormWindowCursorInterface::hasSelection() const
Renvoie « true » si la fenêtre du formulaire contient une sélection ; sinon, renvoie « false ».
bool QDesignerFormWindowCursorInterface::isWidgetSelected(QWidget *widget) const
Renvoie « true » si l'widget e spécifiée est sélectionnée ; sinon, renvoie « false ».
[pure virtual] bool QDesignerFormWindowCursorInterface::movePosition(QDesignerFormWindowCursorInterface::MoveOperation operation, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor)
Exécute l'operation indiquée sur le curseur à l'aide de l'mode spécifiée, et renvoie « true » si l'opération s'est déroulée avec succès ; sinon, renvoie « false ».
Voir également ` position()` et ` setPosition()`.
[pure virtual] int QDesignerFormWindowCursorInterface::position() const
Renvoie la position du curseur.
Voir également setPosition() et movePosition().
[pure virtual] void QDesignerFormWindowCursorInterface::resetWidgetProperty(QWidget *widget, const QString &name)
Réinitialise la propriété avec l'name on indiquée pour l'widget spécifiée à sa valeur par défaut.
Voir également setProperty() et setWidgetProperty().
[pure virtual] QWidget *QDesignerFormWindowCursorInterface::selectedWidget(int index) const
Renvoie le widget dont l'index est indiquée dans la liste des widgets sélectionnés.
Voir également current() et widget().
[pure virtual] int QDesignerFormWindowCursorInterface::selectedWidgetCount() const
Renvoie le nombre de widgets sélectionnés dans la fenêtre du formulaire.
Voir également widgetCount().
[pure virtual] void QDesignerFormWindowCursorInterface::setPosition(int position, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor)
Place le curseur à l'position indiquée à l'aide de l'mode, qui permet de préciser la manière dont il doit s'y déplacer.
Voir également position() et movePosition().
[pure virtual] void QDesignerFormWindowCursorInterface::setProperty(const QString &name, const QVariant &value)
Définit la propriété « name » du widget actuellement sélectionné sur la valeur spécifiée « value ».
Voir également setWidgetProperty() et resetWidgetProperty().
[pure virtual] void QDesignerFormWindowCursorInterface::setWidgetProperty(QWidget *widget, const QString &name, const QVariant &value)
Définit la propriété de l'name spécifié pour l'widget spécifié sur la valeur value.
Voir également resetWidgetProperty() et setProperty().
[pure virtual] QWidget *QDesignerFormWindowCursorInterface::widget(int index) const
Renvoie le widget dont l'index est spécifiée dans la liste des widgets de la fenêtre du formulaire.
Voir aussi selectedWidget().
[pure virtual] int QDesignerFormWindowCursorInterface::widgetCount() const
Renvoie le nombre de widgets présents dans la fenêtre du formulaire.
Voir également selectedWidgetCount().
[delete] QDesignerFormWindowCursorInterface &QDesignerFormWindowCursorInterface::operator=(QDesignerFormWindowCursorInterface &&)
La commande « Move » affecte « other » à cette instance de « QDesignerFormWindowCursorInterface ». Cette fonction est supprimée.
[delete] QDesignerFormWindowCursorInterface &QDesignerFormWindowCursorInterface::operator=(const QDesignerFormWindowCursorInterface &)
Copie et attribue « other » à cette instance de « QDesignerFormWindowCursorInterface ». Cette fonction est supprimée.
© 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.
