QDesignerFormWindowCursorInterface Class
La classe QDesignerFormWindowCursorInterface vous permet d'interroger et de modifier la sélection des widgets d'une fenêtre de formulaire et de modifier les propriétés de tous les widgets du formulaire. Plus d'informations...
| 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
| 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 |
Description détaillée
QDesignerFormWindowCursorInterface est une classe de commodité qui fournit une interface au curseur de texte de la fenêtre de formulaire associée ; elle fournit une collection de fonctions qui vous permet d'interroger la sélection d'une fenêtre de formulaire donnée et de changer le focus de la sélection selon des modes (MoveMode) et des mouvements (MoveOperation) définis. Vous pouvez également utiliser l'interface pour interroger les widgets du formulaire et modifier leurs propriétés.
L'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 actuelles de Qt Widgets Designer. QDesignerFormWindowInterface fournit toujours une interface de curseur associée. La fenêtre de formulaire d'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 laquelle des fenêtres de formulaire actuelles de Qt Widgets Designer par le biais de Qt Widgets Designer's form window manager.
Une fois que vous avez l'interface du curseur d'une fenêtre de formulaire, vous pouvez vérifier si la fenêtre de formulaire a une sélection à l'aide de la fonction hasSelection(). Vous pouvez interroger la fenêtre de formulaire pour connaître son total widgetCount() et selectedWidgetCount(). Vous pouvez récupérer le (ou les) widget(s) 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 changeant la position du curseur de 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 lorsque le curseur de texte se déplace.
| Constante | Valeur | Description |
|---|---|---|
QDesignerFormWindowCursorInterface::MoveAnchor | 0 | L'ancre se déplace avec le curseur jusqu'à sa nouvelle position. |
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 qui peuvent 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 mise au point. |
QDesignerFormWindowCursorInterface::End | 2 | Déplace le curseur à la fin de la chaîne de mise au point. |
QDesignerFormWindowCursorInterface::Next | 3 | Déplace le curseur vers le widget suivant de la chaîne de mise au point. |
QDesignerFormWindowCursorInterface::Prev | 4 | Déplace le curseur vers le widget précédent de la chaîne de mise au point. |
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
[virtual constexpr noexcept] QDesignerFormWindowCursorInterface::~QDesignerFormWindowCursorInterface()
Détruit 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
Retourne vrai si la fenêtre du formulaire contient une sélection, sinon retourne faux.
bool QDesignerFormWindowCursorInterface::isWidgetSelected(QWidget *widget) const
Renvoie un message vrai si l'adresse widget spécifiée est sélectionnée ; dans le cas contraire, ce message renvoie un message faux.
[pure virtual] bool QDesignerFormWindowCursorInterface::movePosition(QDesignerFormWindowCursorInterface::MoveOperation operation, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor)
Exécute la commande operation sur le curseur en utilisant la commande mode spécifiée, et renvoie vrai si la commande a été exécutée avec succès ; sinon, renvoie faux.
Voir aussi position() et setPosition().
[pure virtual] int QDesignerFormWindowCursorInterface::position() const
Renvoie la position du curseur.
Voir aussi setPosition() et movePosition().
[pure virtual] void QDesignerFormWindowCursorInterface::resetWidgetProperty(QWidget *widget, const QString &name)
Rétablit la valeur par défaut de la propriété dont l'adresse est name pour l'adresse widget.
Voir aussi setProperty() et setWidgetProperty().
[pure virtual] QWidget *QDesignerFormWindowCursorInterface::selectedWidget(int index) const
Renvoie le widget portant le numéro index dans la liste des widgets sélectionnés.
Voir aussi current() et widget().
[pure virtual] int QDesignerFormWindowCursorInterface::selectedWidgetCount() const
Renvoie le nombre de widgets sélectionnés dans la fenêtre du formulaire.
Voir aussi widgetCount().
[pure virtual] void QDesignerFormWindowCursorInterface::setPosition(int position, QDesignerFormWindowCursorInterface::MoveMode mode = MoveAnchor)
Fixe la position du curseur à l'adresse position en utilisant l'adresse mode pour spécifier la manière dont il est déplacé.
Voir aussi position() et movePosition().
[pure virtual] void QDesignerFormWindowCursorInterface::setProperty(const QString &name, const QVariant &value)
Définit la propriété avec l'adresse name donnée pour le widget actuellement sélectionné à l'adresse value spécifiée.
Voir aussi setWidgetProperty() et resetWidgetProperty().
[pure virtual] void QDesignerFormWindowCursorInterface::setWidgetProperty(QWidget *widget, const QString &name, const QVariant &value)
Définit la propriété avec l'adresse name donnée pour l'adresse widget donnée à l'adresse value spécifiée.
Voir aussi resetWidgetProperty() et setProperty().
[pure virtual] QWidget *QDesignerFormWindowCursorInterface::widget(int index) const
Renvoie le widget portant le numéro index 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 dans la fenêtre du formulaire.
Voir aussi selectedWidgetCount().
© 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.
