QGraphicsWidget Class
La classe `QGraphicsWidget` est la classe de base de tous les widgets d'un ` QGraphicsScene`. En savoir plus...
| En-tête : | #include <QGraphicsWidget> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QGraphicsObject et QGraphicsLayoutItem |
| Hérité par : |
Types publics
| enum { Type } |
Propriétés
|
|
Fonctions publiques
| QGraphicsWidget(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags()) | |
| virtual | ~QGraphicsWidget() |
| QList<QAction *> | actions() const |
| void | addAction(QAction *action) |
| void | addActions(const QList<QAction *> &actions) |
| void | adjustSize() |
| bool | autoFillBackground() const |
| Qt::FocusPolicy | focusPolicy() const |
| QGraphicsWidget * | focusWidget() const |
| QFont | font() const |
| void | getWindowFrameMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const |
| int | grabShortcut(const QKeySequence &sequence, Qt::ShortcutContext context = Qt::WindowShortcut) |
| void | insertAction(QAction *before, QAction *action) |
| void | insertActions(QAction *before, const QList<QAction *> &actions) |
| bool | isActiveWindow() const |
| QGraphicsLayout * | layout() const |
| Qt::LayoutDirection | layoutDirection() const |
| virtual void | paintWindowFrame(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) |
| QPalette | palette() const |
| QRectF | rect() const |
| void | releaseShortcut(int id) |
| void | removeAction(QAction *action) |
| void | resize(const QSizeF &size) |
| void | resize(qreal w, qreal h) |
| void | setAttribute(Qt::WidgetAttribute attribute, bool on = true) |
| void | setAutoFillBackground(bool enabled) |
| void | setContentsMargins(QMarginsF margins) |
| void | setContentsMargins(qreal left, qreal top, qreal right, qreal bottom) |
| void | setFocusPolicy(Qt::FocusPolicy policy) |
| void | setFont(const QFont &font) |
| void | setGeometry(qreal x, qreal y, qreal w, qreal h) |
| void | setLayout(QGraphicsLayout *layout) |
| void | setLayoutDirection(Qt::LayoutDirection direction) |
| void | setPalette(const QPalette &palette) |
| void | setShortcutAutoRepeat(int id, bool enabled = true) |
| void | setShortcutEnabled(int id, bool enabled = true) |
| void | setStyle(QStyle *style) |
| void | setWindowFlags(Qt::WindowFlags wFlags) |
| void | setWindowFrameMargins(QMarginsF margins) |
| void | setWindowFrameMargins(qreal left, qreal top, qreal right, qreal bottom) |
| void | setWindowTitle(const QString &title) |
| QSizeF | size() const |
| QStyle * | style() const |
| bool | testAttribute(Qt::WidgetAttribute attribute) const |
| void | unsetLayoutDirection() |
| void | unsetWindowFrameMargins() |
| Qt::WindowFlags | windowFlags() const |
| QRectF | windowFrameGeometry() const |
| QRectF | windowFrameRect() const |
| QString | windowTitle() const |
| Qt::WindowType | windowType() const |
Fonctions publiques réimplémentées
| virtual QRectF | boundingRect() const override |
| virtual void | getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const override |
| virtual void | paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override |
| virtual void | setGeometry(const QRectF &rect) override |
| virtual QPainterPath | shape() const override |
| virtual int | type() const override |
Slots publics
| bool | close() |
Signaux
| void | geometryChanged() |
Membres publics statiques
| void | setTabOrder(QGraphicsWidget *first, QGraphicsWidget *second) |
Fonctions protégées
| virtual void | changeEvent(QEvent *event) |
| virtual void | closeEvent(QCloseEvent *event) |
| virtual bool | focusNextPrevChild(bool next) |
| virtual void | grabKeyboardEvent(QEvent *event) |
| virtual void | grabMouseEvent(QEvent *event) |
| virtual void | hideEvent(QHideEvent *event) |
| virtual void | initStyleOption(QStyleOption *option) const |
| virtual void | moveEvent(QGraphicsSceneMoveEvent *event) |
| virtual void | polishEvent() |
| virtual void | resizeEvent(QGraphicsSceneResizeEvent *event) |
| virtual void | showEvent(QShowEvent *event) |
| virtual void | ungrabKeyboardEvent(QEvent *event) |
| virtual void | ungrabMouseEvent(QEvent *event) |
| virtual bool | windowFrameEvent(QEvent *event) |
| virtual Qt::WindowFrameSection | windowFrameSectionAt(const QPointF &pos) const |
Fonctions protégées réimplémentées
| virtual bool | event(QEvent *event) override |
| virtual void | focusInEvent(QFocusEvent *event) override |
| virtual void | focusOutEvent(QFocusEvent *event) override |
| virtual void | hoverLeaveEvent(QGraphicsSceneHoverEvent *event) override |
| virtual void | hoverMoveEvent(QGraphicsSceneHoverEvent *event) override |
| virtual QVariant | itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value) override |
| virtual bool | sceneEvent(QEvent *event) override |
| virtual QSizeF | sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const override |
| virtual void | updateGeometry() override |
Description détaillée
QGraphicsWidget est un élément de base étendu qui offre des fonctionnalités supplémentaires par rapport à QGraphicsItem. Il est similaire à QWidget à bien des égards :
- Il fournit une méthode ` palette`, une méthode ` font ` et une méthode ` style()`.
- Dispose d’une méthode geometry() définie.
- Prend en charge les mises en page avec setLayout() et layout().
- Prend en charge les raccourcis et les actions via grabShortcut() et insertAction()
Contrairement à QGraphicsItem, QGraphicsWidget n’est pas une classe abstraite ; vous pouvez créer des instances de QGraphicsWidget sans avoir à en créer de sous-classe. Cette approche est utile pour les widgets dont le seul but est d’organiser des widgets enfants dans une disposition.
QGraphicsWidget peut servir de base à votre propre élément personnalisé si vous avez besoin d’une gestion avancée du focus de saisie, par exemple le focus et l’activation via la touche Tab, ou encore de mises en page.
Étant donné que QGraphicsWidget ressemble à QWidget et dispose d’une API similaire, il est plus facile de porter un widget depuis QWidget vers QGraphicsWidget, plutôt que vers QGraphicsItem.
Remarque : les widgets basés surQWidget peuvent être directement intégrés dans un QGraphicsScene à l’aide de QGraphicsProxyWidget.
Les différences notables entre QGraphicsWidget et QWidget sont les suivantes :
| QGraphicsWidget | QWidget |
|---|---|
| Les coordonnées et la géométrie sont définies avec des qreals (de type double ou float, selon la plate-forme). | QWidget utilise une géométrie en entiers (QPoint, QRect). |
| Le widget est déjà visible par défaut ; vous n’avez pas besoin d’appeler ` show()` pour l’afficher. | QWidget est masqué par défaut jusqu’à ce que vous appeliez show(). |
| Un sous-ensemble d'attributs de widget est pris en charge. | Tous les attributs du widget sont pris en charge. |
| Le style d’un élément de niveau supérieur est défini par défaut sur QGraphicsScene::style | Le style par défaut d’un widget de niveau supérieur est QApplication::style |
| Graphics View fournit un framework de glisser-déposer personnalisé, différent de QWidget. | Framework de glisser-déposer standard. |
| Les éléments de widget ne prennent pas en charge la modalité. | Prise en charge complète de la modalité. |
QGraphicsWidget prend en charge un sous-ensemble des attributs de widget de Qt (Qt::WidgetAttribute), comme indiqué dans le tableau ci-dessous. Tous les attributs ne figurant pas dans ce tableau ne sont pas pris en charge ou ne sont pas utilisés.
| Attribut du widget | Utilisation |
|---|---|
| Qt::WA_SetLayoutDirection | Défini par setLayoutDirection(), désactivé par unsetLayoutDirection(). Vous pouvez tester cet attribut pour vérifier si une layoutDirection a été explicitement attribuée au widget. Si l'attribut n'est pas défini, la valeur layoutDirection() est héritée. |
| Qt::WA_RightToLeft | Activé/désactivé par setLayoutDirection(). Hérité du parent/de la scène. S’il est défini, la mise en page du widget classera les widgets disposés horizontalement de droite à gauche. |
| Qt::WA_SetStyle | Définie et désactivée par la méthode ` setStyle()`. Si cet attribut est défini, un style a été explicitement attribué au widget. S’il n’est pas défini, le widget utilisera le style de la scène ou de l’application. |
| Qt::WA_Resized | Définit par setGeometry() et resize(). |
| Qt::WA_SetPalette | Définie par setPalette(). |
| Qt::WA_SetFont | Définie par setFont(). |
| Qt::WA_WindowPropagation | Active la propagation aux widgets de fenêtre. |
Bien que QGraphicsWidget hérite à la fois de QObject et de QGraphicsItem, vous devez utiliser les fonctions fournies par QGraphicsItem, et non QObject, pour gérer les relations entre les éléments parents et enfants. Ces fonctions contrôlent l’ordre d’empilement des éléments ainsi que leur propriété.
Remarque : la fonction QObject::parent() devrait toujours renvoyer nullptr pour les QGraphicsWidgets, mais cette règle n’est pas strictement définie.
Voir également QGraphicsProxyWidget, QGraphicsItem et Widgets et mises en page.
Documentation sur les types de membres
[anonymous] enum
Valeur renvoyée par la fonction virtuelle type().
| Constante | Valeur | Description |
|---|---|---|
QGraphicsWidget::Type | 11 | Un élément de widget graphique |
Documentation sur les propriétés
autoFillBackground : bool
Cette propriété détermine si l'arrière-plan du widget est rempli automatiquement
Si elle est activée, cette propriété force Qt à remplir l'arrière-plan du widget avant d'appeler la méthode ` paint()`. La couleur utilisée est définie par le rôle de couleur « QPalette::Window » issu de l'palette du widget.
De plus, les fenêtres sont toujours remplies avec la couleur « QPalette::Window », sauf si les attributs WA_OpaquePaintEvent ou WA_NoSystemBackground sont définis.
Par défaut, cette propriété est définie sur « false ».
Fonctions d'accès :
| bool | autoFillBackground() const |
| void | setAutoFillBackground(bool enabled) |
Voir également Qt::WA_OpaquePaintEvent et Qt::WA_NoSystemBackground.
focusPolicy : Qt::FocusPolicy
Cette propriété définit la manière dont le widget accepte le focus clavier
La politique de focus est Qt::TabFocus si le widget accepte le focus clavier via la touche Tab, Qt::ClickFocus s'il accepte le focus via un clic, Qt::StrongFocus s'il accepte les deux, et Qt::NoFocus (valeur par défaut) s'il n'accepte aucun focus.
Vous devez activer le focus clavier pour un widget s’il traite des événements clavier. Cela se fait généralement depuis le constructeur du widget. Par exemple, le constructeur QLineEdit appelle setFocusPolicy(Qt::StrongFocus).
Si vous activez une politique de focus (c’est-à-dire autre que Qt::NoFocus), QGraphicsWidget activera automatiquement l’indicateur ItemIsFocusable. Définir Qt::NoFocus sur un widget effacera l’indicateur ItemIsFocusable. Si le widget détient actuellement le focus clavier, il le perdra automatiquement.
Fonctions d’accès :
| Qt::FocusPolicy | focusPolicy() const |
| void | setFocusPolicy(Qt::FocusPolicy policy) |
Voir également focusInEvent(), focusOutEvent(), keyPressEvent(), keyReleaseEvent() et enabled.
font : QFont
Cette propriété définit la police des widgets
Cette propriété fournit la police du widget.
QFont Elle se compose des propriétés de police qui ont été explicitement définies et des propriétés implicitement héritées du widget parent. Par conséquent, la fonction font() peut renvoyer une police différente de celle définie avec setFont(). Ce mécanisme vous permet de définir des entrées individuelles dans une police sans affecter les entrées héritées de celle-ci.
Lorsqu’une police de caractère d’un widget change, celui-ci résout ses entrées par rapport à son widget parent. Si le widget n’a pas de widget parent, il résout ses entrées par rapport à la scène. Le widget s’envoie alors un événement « FontChange » et en informe tous ses descendants afin qu’ils puissent également résoudre leurs polices de caractères.
Par défaut, cette propriété contient la police par défaut de l’application.
Fonctions d’accès :
| QFont | font() const |
| void | setFont(const QFont &font) |
Voir également QApplication::font(), QGraphicsScene::font et QFont::resolve().
geometry : QRectF
Cette propriété contient la géométrie du widget
Définit la géométrie de l'élément sur rect. La position et la taille de l'élément sont modifiées à la suite de l'appel de cette fonction. L'élément est d'abord déplacé, puis redimensionné.
L'appel de cette fonction a pour effet secondaire de déclencher un événement de déplacement et un événement de redimensionnement sur le widget. De plus, si une mise en page est attribuée au widget, celle-ci sera activée.
Fonctions d'accès :
| virtual void | setGeometry(const QRectF &rect) override |
| void | setGeometry(qreal x, qreal y, qreal w, qreal h) |
Signal de notification :
| void | geometryChanged() |
Voir également geometry() et resize().
layout : QGraphicsLayout*
Cette propriété définit la mise en page du widget
Tout gestionnaire de mise en page existant est supprimé avant l'attribution de la nouvelle mise en page. Si layout est nullptr, le widget se retrouve sans mise en page. Les géométries des sous-widgets existants ne sont pas affectées.
QGraphicsWidget prend possession de ` layout`.
Tous les widgets actuellement gérés par layout ou par l’ensemble de ses sous-mises en page sont automatiquement rattachés à cet élément. La mise en page est ensuite invalidée, et les géométries des widgets enfants sont ajustées en fonction des propriétés geometry() et contentsMargins() de cet élément. Les enfants qui ne sont pas explicitement gérés par layout ne sont pas affectés par la mise en page après son attribution à ce widget.
Si aucune mise en page ne gère actuellement ce widget, la fonction layout() renverra la valeur « nullptr ».
Fonctions d’accès :
layoutDirection : Qt::LayoutDirection
Cette propriété définit le sens de mise en page de ce widget.
Cette propriété modifie l'attribut ` Qt::WA_RightToLeft ` de ce widget et de tous ses descendants. Elle définit également l'attribut ` Qt::WA_SetLayoutDirection ` de ce widget.
Le sens de mise en page du widget détermine l’ordre dans lequel le gestionnaire de mise en page dispose horizontalement les sous-widgets de ce widget. La valeur par défaut dépend de la langue et des paramètres régionaux de l’application, et correspond généralement au sens de lecture et d’écriture des mots. Avec ` Qt::LeftToRight`, la mise en page commence à placer les sous-widgets depuis le côté gauche de ce widget vers la droite. ` Qt::RightToLeft ` fait l’inverse : la mise en page placera les widgets en partant du bord droit vers la gauche.
Les sous-widgets héritent de la direction de mise en page de leur parent. Les éléments de widget de niveau supérieur héritent de leur direction de mise en page de QGraphicsScene::layoutDirection. Si vous modifiez la direction de mise en page d’un widget en appelant setLayoutDirection(), le widget s’enverra lui-même un événement « LayoutDirectionChange », puis propagera la nouvelle direction de mise en page à tous ses descendants.
Fonctions d’accès :
| Qt::LayoutDirection | layoutDirection() const |
| void | setLayoutDirection(Qt::LayoutDirection direction) |
| void | unsetLayoutDirection() |
Voir également QWidget::layoutDirection et QApplication::layoutDirection.
maximumSize : QSizeF
Cette propriété définit la taille maximale du widget
Voir également setMaximumSize(), maximumSize(), minimumSize et preferredSize.
minimumSize : QSizeF
Cette propriété définit la taille minimale du widget
Voir également setMinimumSize(), minimumSize(), preferredSize et maximumSize.
palette : QPalette
Cette propriété contient la palette du widget
Cette propriété fournit la palette du widget. La palette fournit des couleurs et des pinceaux pour les groupes de couleurs (par exemple, QPalette::Button) et les états (par exemple, QPalette::Inactive), définissant de manière approximative l'aspect général du widget et de ses enfants.
QPalette Elle se compose de groupes de couleurs qui ont été explicitement définis, et de groupes hérités implicitement du parent du widget. De ce fait, la fonction palette() peut renvoyer une palette différente de celle qui a été définie avec setPalette(). Ce système vous permet de définir des entrées individuelles dans une palette sans affecter les entrées héritées de celle-ci.
Lorsqu’une palette de widget change, celui-ci résout ses entrées par rapport à son widget parent ou, s’il n’en a pas, par rapport à la scène. Il s’envoie alors un événement « PaletteChange » et informe tous ses descendants afin qu’ils puissent également résoudre leurs palettes.
Par défaut, cette propriété contient la palette par défaut de l’application.
Fonctions d’accès :
| QPalette | palette() const |
| void | setPalette(const QPalette &palette) |
Voir également QGuiApplication::palette(), QGraphicsScene::palette et QPalette::resolve().
preferredSize : QSizeF
Cette propriété contient la taille par défaut du widget
Voir également setPreferredSize(), preferredSize(), minimumSize et maximumSize.
size : QSizeF
Cette propriété contient la taille du widget
L'appel à la méthode resize() redimensionne le widget selon un size e délimité par minimumSize() et maximumSize(). Cette propriété n'affecte que la largeur et la hauteur du widget (c'est-à-dire ses bords droit et inférieur) ; la position et le coin supérieur gauche du widget ne sont pas modifiés.
Le redimensionnement d’un widget déclenche immédiatement la réception d’un événement ` GraphicsSceneResize ` contenant les anciennes et nouvelles dimensions du widget. Si une mise en page est attribuée au widget au moment où cet événement se produit, celle-ci sera activée et mettra automatiquement à jour la géométrie de tous les widgets enfants.
Cette propriété n’affecte aucune mise en page du widget parent. Si le widget lui-même est géré par une mise en page parent (par exemple, s’il a un widget parent auquel une mise en page est attribuée), cette mise en page ne s’activera pas.
Par défaut, cette propriété contient une taille avec une largeur et une hauteur égales à zéro.
Fonctions d’accès :
| QSizeF | size() const |
| void | resize(const QSizeF &size) |
| void | resize(qreal w, qreal h) |
Signal de notification :
| void | geometryChanged() |
Voir également setGeometry(), QGraphicsSceneResizeEvent et QGraphicsLayout.
sizePolicy : QSizePolicy
Cette propriété définit la politique de taille du widget
Voir également sizePolicy(), setSizePolicy() et QWidget::sizePolicy().
windowFlags : Qt::WindowFlags
Cette propriété contient les indicateurs de fenêtre du widget
Les indicateurs de fenêtre sont une combinaison d'un type de fenêtre (par exemple, Qt::Dialog) et de plusieurs indicateurs fournissant des informations sur le comportement de la fenêtre. Ce comportement dépend de la plate-forme.
Par défaut, cette propriété ne contient aucun indicateur de fenêtre.
Les fenêtres sont des panneaux. Si vous activez l'indicateur « Qt::Window », l'indicateur « ItemIsPanel » sera automatiquement activé. Si vous désactivez l'indicateur « Qt::Window », l'indicateur « ItemIsPanel » est également désactivé. Notez que l'indicateur « ItemIsPanel » peut être activé indépendamment de l'indicateur « Qt::Window ».
Fonctions d’accès :
| Qt::WindowFlags | windowFlags() const |
| void | setWindowFlags(Qt::WindowFlags wFlags) |
Voir également isWindow() et isPanel().
windowTitle : QString
Cette propriété contient le titre (légende) de la fenêtre.
Cette propriété est uniquement utilisée pour les fenêtres.
Par défaut, si aucun titre n'a été défini, cette propriété contient une chaîne vide.
Fonctions d'accès :
| QString | windowTitle() const |
| void | setWindowTitle(const QString &title) |
Documentation des fonctions membres
QGraphicsWidget::QGraphicsWidget(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags())
Crée une instance de `QGraphicsWidget`. L'argument facultatif ` parent ` est transmis au constructeur de ` QGraphicsItem`. L'argument facultatif ` wFlags ` spécifie les indicateurs de fenêtre du widget (par exemple, si le widget doit être une fenêtre, un outil, une fenêtre contextuelle, etc.).
[virtual noexcept] QGraphicsWidget::~QGraphicsWidget()
Supprime l'instance de ` QGraphicsWidget `.
QList<QAction *> QGraphicsWidget::actions() const
Renvoie la liste (éventuellement vide) des actions de ce widget.
Voir également insertAction(), removeAction(), QWidget::actions(), QAction::associatedWidgets() et QAction::associatedGraphicsWidgets().
void QGraphicsWidget::addAction(QAction *action)
Ajoute l'action « action » à la liste des actions de ce widget.
Tous les QGraphicsWidgets disposent d’une liste d’ QActions, mais celles-ci peuvent être représentées graphiquement de nombreuses façons différentes. L’utilisation par défaut de la liste QAction (telle que renvoyée par actions()) consiste à créer un contexte QMenu.
Un QGraphicsWidget ne doit comporter qu’un seul exemplaire de chaque action ; l’ajout d’une action qu’il possède déjà n’entraînera pas la présence de cette même action deux fois dans le widget.
Voir également removeAction(), insertAction(), actions() et QWidget::addAction().
void QGraphicsWidget::addActions(const QList<QAction *> &actions)
Ajoute les actions actions à la liste des actions de ce widget.
Voir également removeAction(), QMenu, addAction() et QWidget::addActions().
void QGraphicsWidget::adjustSize()
Ajuste la taille du widget en fonction de sa taille préférée effective.
Cette fonction est appelée implicitement lorsque l'élément s'affiche pour la première fois.
Voir également effectiveSizeHint() et Qt::MinimumSize.
[override virtual] QRectF QGraphicsWidget::boundingRect() const
Réimplémente : QGraphicsItem::boundingRect() const.
[virtual protected] void QGraphicsWidget::changeEvent(QEvent *event)
Cet événement peut être réimplémenté pour gérer les changements d'état.
L'état modifié lors de cet événement peut être récupéré via event.
Les événements de modification comprennent : QEvent::ActivationChange, QEvent::EnabledChange, QEvent::FontChange, QEvent::StyleChange, QEvent::PaletteChange, QEvent::ParentChange, QEvent::LayoutDirectionChange et QEvent::ContentsRectChange.
[slot] bool QGraphicsWidget::close()
Appelez cette fonction pour fermer le widget.
Renvoie « true » si le widget a été fermé ; sinon, renvoie « false ». Ce slot envoie d’abord un événement « QCloseEvent » au widget, qui peut accepter ou ignorer cet événement. Si l’événement est ignoré, rien ne se passe. S’il est accepté, il appelle la fonction « hide() » sur le widget.
Si le widget dispose de l’attribut « Qt::WA_DeleteOnClose », il sera supprimé.
[virtual protected] void QGraphicsWidget::closeEvent(QCloseEvent *event)
Ce gestionnaire d'événements, destiné à event, peut être réimplémenté dans une sous-classe afin de recevoir les événements de fermeture du widget. L'implémentation par défaut accepte l'événement.
Voir également close() et QCloseEvent.
[override virtual protected] bool QGraphicsWidget::event(QEvent *event)
Réimplémente : QGraphicsObject::event(QEvent *ev).
Gère l'event. QGraphicsWidget gère les événements suivants :
| Événement | Utilisation |
|---|---|
| Polonais | Transmis au widget quelque temps après son affichage. |
| GraphicsSceneMove | Transmis au widget après que sa position locale a changé. |
| GraphicsSceneResize | Transmis au widget après que sa taille a changé. |
| Show | Transmis au widget avant qu'il ne soit affiché. |
| Hide | Transmis au widget après qu’il a été masqué. |
| Changement de palette | Transmis au widget après le changement de sa palette. |
| FontChange | Transmis au widget après le changement de sa police. |
| EnabledChange | Transmis au widget après la modification de son état d'activation. |
| StyleChange | Envoyé au widget après la modification de son style. |
| LayoutDirectionChange | Transmis au widget après modification de son sens de mise en page. |
| ContentsRectChange | Transmis au widget après modification des marges de son contenu ou de son rectangle de contenu. |
[override virtual protected] void QGraphicsWidget::focusInEvent(QFocusEvent *event)
Réimplémente : QGraphicsItem::focusInEvent(QFocusEvent *event).
[virtual protected] bool QGraphicsWidget::focusNextPrevChild(bool next)
Recherche un nouveau widget auquel attribuer le focus du clavier, selon que l'on utilise la touche Tab ou Maj+Tab, et renvoie ` true ` si elle trouve un nouveau widget ; renvoie ` false ` dans le cas contraire. Si ` next ` est vrai, cette fonction effectue une recherche vers l'avant ; si ` next ` est faux, elle effectue une recherche vers l'arrière.
Il vous arrivera parfois de vouloir réimplémenter cette fonction afin de fournir une gestion spéciale du focus pour votre widget et ses sous-widgets. Par exemple, un navigateur Web pourrait la réimplémenter pour faire avancer ou reculer le lien actuellement actif, et n’appeler l’implémentation de base que lorsqu’il atteint le dernier ou le premier lien de la page.
Les widgets enfants appellent la fonction `focusNextPrevChild()` sur leurs widgets parents, mais seule la fenêtre contenant les widgets enfants décide où rediriger le focus. En réimplémentant cette fonction pour un objet, vous prenez le contrôle du parcours du focus pour tous les widgets enfants.
Voir également ` focusPolicy()`.
[override virtual protected] void QGraphicsWidget::focusOutEvent(QFocusEvent *event)
Réimplémente : QGraphicsItem::focusOutEvent(QFocusEvent *event).
QGraphicsWidget *QGraphicsWidget::focusWidget() const
Si ce widget, l'un de ses enfants ou l'un de ses descendants, a actuellement le focus, cette fonction renvoie un pointeur vers ce widget. Si aucun widget descendant n'a le focus, la valeur « nullptr » est renvoyée.
Voir également QGraphicsItem::focusItem() et QWidget::focusWidget().
[signal] void QGraphicsWidget::geometryChanged()
Ce signal est émis chaque fois que la géométrie est modifiée dans la méthode setGeometry().
[override virtual] void QGraphicsWidget::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const
Réimplémente : ` QGraphicsLayoutItem::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const`.
Récupère les marges de contenu du widget. Les marges sont stockées dans left, top, right et bottom, sous forme de pointeurs vers des qreals. Chaque argument peut être omis en passant nullptr.
Voir également setContentsMargins().
void QGraphicsWidget::getWindowFrameMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const
Récupère les marges du cadre de la fenêtre du widget. Les marges sont stockées dans left, top, right et bottom sous forme de pointeurs vers des qreals. Chaque argument peut être omis en passant nullptr.
Voir également setWindowFrameMargins() et windowFrameRect().
[virtual protected] void QGraphicsWidget::grabKeyboardEvent(QEvent *event)
Ce gestionnaire d'événements, destiné à event, peut être réimplémenté dans une sous-classe afin de recevoir des notifications concernant les événements QEvent::GrabKeyboard.
Voir également grabKeyboard() et grabMouse().
[virtual protected] void QGraphicsWidget::grabMouseEvent(QEvent *event)
Ce gestionnaire d'événements, destiné à event, peut être réimplémenté dans une sous-classe afin de recevoir des notifications concernant les événements QEvent::GrabMouse.
Voir également grabMouse() et grabKeyboard().
int QGraphicsWidget::grabShortcut(const QKeySequence &sequence, Qt::ShortcutContext context = Qt::WindowShortcut)
Ajoute un raccourci au système de raccourcis de Qt qui surveille la touche spécifiée sequence dans l’ context indiquée. Si l’ context est Qt::ApplicationShortcut, le raccourci s’applique à l’ensemble de l’application. Sinon, il est soit local à ce widget ( Qt::WidgetShortcut), soit à la fenêtre elle-même ( Qt::WindowShortcut). Pour les widgets qui ne font pas partie d’une fenêtre (c’est-à-dire les widgets de niveau supérieur et leurs enfants), Qt::WindowShortcut les raccourcis s’appliquent à la scène.
Si la même combinaison de touches sequence a été capturée par plusieurs widgets, lorsqu’un événement de touche sequence se produit, un événement QEvent::Shortcut est envoyé à tous les widgets auxquels il s’applique dans un ordre non déterministe, mais avec le drapeau « ambiguous » défini sur true.
Avertissement : vous ne devriez normalement pas avoir besoin d’utiliser cette fonction ; créez plutôt des « QAction» avec les séquences de touches de raccourci dont vous avez besoin (si vous souhaitez également des options de menu et des boutons de barre d’outils équivalents), ou créez des « QShortcut» si vous n’avez besoin que de séquences de touches. QAction et QShortcut gèrent tous les filtres d’événements à votre place et fournissent des signaux déclenchés lorsque l’utilisateur appuie sur la séquence de touches ; elles sont donc beaucoup plus faciles à utiliser que cette fonction de bas niveau.
Voir également releaseShortcut(), setShortcutEnabled() et QWidget::grabShortcut().
[virtual protected] void QGraphicsWidget::hideEvent(QHideEvent *event)
Ce gestionnaire d'événements, destiné aux événements « Hide », est déclenché après que le widget a été masqué, par exemple lorsque la méthode `setVisible(false)` a été appelée pour le widget ou l'un de ses ancêtres alors que le widget était auparavant affiché.
Vous pouvez réimplémenter ce gestionnaire d’événements pour détecter quand votre widget est masqué. L’appel de ` QEvent::accept()` ou ` QEvent::ignore()` sur ` event ` n’a aucun effet.
Voir également showEvent(), QWidget::hideEvent() et ItemVisibleChange.
[override virtual protected] void QGraphicsWidget::hoverLeaveEvent(QGraphicsSceneHoverEvent *event)
Réimplémente : QGraphicsItem::hoverLeaveEvent(QGraphicsSceneHoverEvent *event).
[override virtual protected] void QGraphicsWidget::hoverMoveEvent(QGraphicsSceneHoverEvent *event)
Réimplémente : QGraphicsItem::hoverMoveEvent(QGraphicsSceneHoverEvent *event).
[virtual protected] void QGraphicsWidget::initStyleOption(QStyleOption *option) const
Remplit un objet d'options de style pour ce widget en fonction de son état actuel, et stocke le résultat dans ` option`. L'implémentation par défaut remplit ` option ` avec les propriétés suivantes.
| Propriété d'option de style | Valeur |
|---|---|
| state & QStyle::State_Enabled | Correspond à QGraphicsItem::isEnabled(). |
| state & QStyle::State_HasFocus | Correspond à QGraphicsItem::hasFocus(). |
| état & QStyle::State_MouseOver | Correspond à QGraphicsItem::isUnderMouse(). |
| direction | Correspond à QGraphicsWidget::layoutDirection(). |
| rect | Correspond à QGraphicsWidget::rect().toRect(). |
| palette | Correspond à QGraphicsWidget::palette(). |
| fontMetrics | Correspond à QFontMetrics(QGraphicsWidget::font()). |
Les sous-classes de ` QGraphicsWidget ` doivent appeler l'implémentation de base, puis vérifier le type de ` option ` à l'aide de ` qstyleoption_cast<>()` ou tester ` QStyleOption::Type ` avant de stocker les options spécifiques au widget.
Par exemple :
void MyGroupBoxWidget::initStyleOption(QStyleOption *option) const
{
QGraphicsWidget::initStyleOption(option);
if (QStyleOptionGroupBox *box = qstyleoption_cast<QStyleOptionGroupBox *>(option)) {
// Add group box specific state.
box->text = tr("My Group Box");
//...
}
}Voir également ` QStyleOption::initFrom()`.
void QGraphicsWidget::insertAction(QAction *before, QAction *action)
Ajoute l'action action à la liste des actions de ce widget, avant l'action before. Elle ajoute l'action à la fin si before est de type nullptr ou si before n'est pas une action valide pour ce widget.
Un « QGraphicsWidget » ne doit comporter qu’un seul exemplaire de chaque action.
Voir également removeAction(), addAction(), QMenu, actions() et QWidget::insertActions().
void QGraphicsWidget::insertActions(QAction *before, const QList<QAction *> &actions)
Ajoute l'action actions à la liste des actions de ce widget, avant l'action before. Elle ajoute l'action à la fin de la liste si before est nullptr ou si before n'est pas une action valide pour ce widget.
Un « QGraphicsWidget » peut comporter au maximum une instance de chaque action.
Voir également removeAction(), QMenu, insertAction() et QWidget::insertActions().
bool QGraphicsWidget::isActiveWindow() const
Renvoie « true » si la fenêtre de ce widget fait partie de la fenêtre active, ou si le widget ne dispose pas de fenêtre mais se trouve dans une scène active (c'est-à-dire une scène qui a actuellement le focus).
La fenêtre active est celle qui contient un widget enfant ayant actuellement le focus, ou celle qui a elle-même le focus.
Voir également QGraphicsScene::activeWindow(), QGraphicsScene::setActiveWindow() et isActive().
[override virtual protected] QVariant QGraphicsWidget::itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value)
Réimplémente : QGraphicsItem::itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value).
QGraphicsWidget utilise l’implémentation de base de cette fonction pour détecter et transmettre les événements liés aux changements d’état de l’élément. C’est pourquoi il est très important que les sous-classes appellent l’implémentation de base.
change spécifie le type de changement, et value correspond à la nouvelle valeur.
Par exemple, ` QGraphicsWidget ` utilise `ItemVisibleChange` pour transmettre les événements ` Show ` et ` Hide `, `ItemPositionHasChanged` pour transmettre les événements ` Move `, et `ItemParentChange` à la fois pour transmettre les événements ` ParentChange ` et pour gérer la chaîne de focus.
QGraphicsWidget active par défaut l'indicateur ItemSendsGeometryChanges afin de suivre les changements de position.
Voir également QGraphicsItem::itemChange().
QGraphicsLayout *QGraphicsWidget::layout() const
Renvoie la mise en page de ce widget, ou ` nullptr ` si aucune mise en page ne gère actuellement ce widget.
Remarque : fonctiongetter pour la propriété layout.
Voir aussi setLayout().
[virtual protected] void QGraphicsWidget::moveEvent(QGraphicsSceneMoveEvent *event)
Ce gestionnaire d'événements, destiné aux événements « GraphicsSceneMove », est déclenché après le déplacement du widget (c'est-à-dire lorsque sa position locale a changé).
Cet événement n'est déclenché que lorsque l'élément est déplacé localement. L'appel de la méthode ` setTransform()` ou le déplacement de l'un des ancêtres de l'élément n'affecte pas la position locale de ce dernier.
Vous pouvez réimplémenter ce gestionnaire d'événements pour détecter quand votre widget a été déplacé. L'appel de ` QEvent::accept()` ou de ` QEvent::ignore()` sur ` event ` n'a aucun effet.
Voir également ItemPositionChange et ItemPositionHasChanged.
[override virtual] void QGraphicsWidget::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)
Réimplémente : QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).
[virtual] void QGraphicsWidget::paintWindowFrame(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)
Cette fonction virtuelle est appelée par ` QGraphicsScene ` pour dessiner le cadre de la fenêtre pour les fenêtres utilisant ` painter`, ` option` et ` widget`, en coordonnées locales. L'implémentation de base utilise le style actuel pour afficher le cadre et la barre de titre.
Vous pouvez réimplémenter cette fonction dans une sous-classe de ` QGraphicsWidget ` afin de fournir un rendu personnalisé du cadre de la fenêtre du widget.
Voir également QGraphicsItem::paint().
[virtual protected] void QGraphicsWidget::polishEvent()
Cet événement est transmis à l'élément par la scène à un moment donné après sa construction, mais avant qu'il ne soit affiché ou accessible d'une autre manière via la scène. Vous pouvez utiliser ce gestionnaire d'événements pour effectuer des initialisations de dernière minute du widget qui nécessitent que l'élément soit entièrement construit.
L'implémentation de base ne fait rien.
QRectF QGraphicsWidget::rect() const
Renvoie le rectangle local de l'élément sous la forme d'un objet ` QRectF`. Cette fonction est équivalente à ` QRectF` (QPointF(), ` size()`).
Voir également setGeometry() et resize().
void QGraphicsWidget::releaseShortcut(int id)
Supprime le raccourci dont l'id est spécifiée du système de raccourcis de Qt. Le widget ne recevra plus d'événements « QEvent::Shortcut » correspondant à la séquence de touches du raccourci (à moins qu'il ne dispose d'autres raccourcis utilisant la même séquence de touches).
Avertissement : vous ne devriez normalement pas avoir besoin d’utiliser cette fonction, car le système de raccourcis de Qt supprime automatiquement les raccourcis lorsque leur widget parent est détruit. Il est préférable d’utiliser ` QAction ` ou ` QShortcut ` pour gérer les raccourcis, car ces fonctions sont plus faciles à utiliser que cette fonction de bas niveau. Notez également qu’il s’agit d’une opération coûteuse en ressources.
Voir également grabShortcut(), setShortcutEnabled() et QWidget::releaseShortcut().
void QGraphicsWidget::removeAction(QAction *action)
Supprime l'action action de la liste des actions de ce widget.
Voir également insertAction(), actions() et QWidget::removeAction().
void QGraphicsWidget::resize(qreal w, qreal h)
Crée une opération de redimensionnement avec l'width (w) et l'height (h) indiqués. Cette fonction pratique équivaut à appeler resize(QSizeF(w, h)).
Remarque : fonctionde définition de la propriété size.
Il s'agit d'une fonction surchargée.
Voir également setGeometry() et setTransform().
[virtual protected] void QGraphicsWidget::resizeEvent(QGraphicsSceneResizeEvent *event)
Ce gestionnaire d'événements, destiné aux événements « GraphicsSceneResize », est déclenché après le redimensionnement du widget (c'est-à-dire lorsque sa taille locale a changé). La variable « event » contient à la fois l'ancienne et la nouvelle taille.
Cet événement n'est déclenché que lorsque le widget est redimensionné localement ; l'appel de la méthode setTransform() sur le widget, l'un de ses ancêtres ou sa vue n'affecte pas la taille locale du widget.
Vous pouvez réimplémenter ce gestionnaire d’événement pour détecter quand votre widget a été redimensionné. L’appel de ` QEvent::accept()` ou ` QEvent::ignore()` sur ` event ` n’a aucun effet.
Voir également ` geometry()` et ` setGeometry()`.
[override virtual protected] bool QGraphicsWidget::sceneEvent(QEvent *event)
Réimplémente : QGraphicsItem::sceneEvent(QEvent *event).
QGraphicsWidgetL'implémentation de `sceneEvent()` transmet simplement ` event ` à ` QGraphicsWidget::event()`. Vous pouvez gérer tous les événements de votre widget dans ` event()` ou dans l'une des fonctions de commodité ; vous ne devriez pas avoir à réimplémenter cette fonction dans une sous-classe de ` QGraphicsWidget`.
Renvoie true si event a été reconnu et traité ; sinon, renvoie false.
Voir également QGraphicsItem::sceneEvent().
void QGraphicsWidget::setAttribute(Qt::WidgetAttribute attribute, bool on = true)
Si la valeur de ` on ` est `true`, cette fonction active ` attribute` ; dans le cas contraire, ` attribute ` est désactivé.
Consultez la documentation de la classe QGraphicsWidget pour obtenir la liste complète des attributs pris en charge et connaître leur utilité.
Voir également testAttribute() et QWidget::setAttribute().
void QGraphicsWidget::setContentsMargins(QMarginsF margins)
Définit les marges de contenu du widget sur margins.
Les marges de contenu sont utilisées par la mise en page attribuée pour définir l’emplacement des sous-widgets et des mises en page. Les marges sont particulièrement utiles pour les widgets qui limitent les sous-widgets à une seule partie de leur propre géométrie. Par exemple, une zone de groupe dotée d’une mise en page placera les sous-widgets à l’intérieur de son cadre, mais sous le titre.
La modification des marges de contenu d’un widget déclenchera toujours un appel à la fonction ` update()`, et toute mise en page associée sera automatiquement activée. Le widget recevra alors un événement ` ContentsRectChange `.
Voir également getContentsMargins() et setGeometry().
void QGraphicsWidget::setContentsMargins(qreal left, qreal top, qreal right, qreal bottom)
Définit les marges du contenu du widget sur left, top, right et bottom.
Il s'agit d'une fonction surchargée.
void QGraphicsWidget::setGeometry(qreal x, qreal y, qreal w, qreal h)
Cette fonction pratique équivaut à appeler `setGeometry(QRectF( x, y, w, h))`.
Remarque : fonctionde définition de la propriété geometry.
Voir également geometry() et resize().
void QGraphicsWidget::setLayout(QGraphicsLayout *layout)
Définit la mise en page de ce widget sur « layout ». Tout gestionnaire de mise en page existant est supprimé avant l'attribution de la nouvelle mise en page. Si « layout » est égal à « nullptr », le widget se retrouve sans mise en page. Les géométries des sous-widgets existants ne sont pas affectées.
Tous les widgets actuellement gérés par layout ou par l’ensemble de ses sous-dispositions sont automatiquement rattachés à cet élément. La disposition est ensuite invalidée, et les géométries des widgets enfants sont ajustées en fonction des propriétés geometry() et contentsMargins() de cet élément. Les enfants qui ne sont pas explicitement gérés par layout ne sont pas affectés par la disposition après son attribution à ce widget.
QGraphicsWidget prend possession de ` layout`.
Remarque : fonctionde définition pour la propriété layout.
Voir également layout(), QGraphicsLinearLayout::addItem() et QGraphicsLayout::invalidate().
void QGraphicsWidget::setShortcutAutoRepeat(int id, bool enabled = true)
Si enabled est défini sur « true », la répétition automatique du raccourci avec l'id on indiquée est activée ; dans le cas contraire, elle est désactivée.
Voir également grabShortcut(), releaseShortcut() et QWidget::setShortcutAutoRepeat().
void QGraphicsWidget::setShortcutEnabled(int id, bool enabled = true)
Si la valeur de « enabled » est « true », le raccourci associé à l'id on indiquée est activé ; dans le cas contraire, il est désactivé.
Avertissement : vous ne devriez normalement pas avoir besoin d’utiliser cette fonction, car le système de raccourcis de Qt active/désactive automatiquement les raccourcis lorsque les widgets deviennent masqués/visibles et gagnent ou perdent le focus. Il est préférable d’utiliser QAction ou QShortcut pour gérer les raccourcis, car elles sont plus faciles à utiliser que cette fonction de bas niveau.
Voir également grabShortcut(), releaseShortcut() et QWidget::setShortcutEnabled().
void QGraphicsWidget::setStyle(QStyle *style)
Définit le style du widget sur « style ». « QGraphicsWidget » ne prend pas possession de « style ».
Si aucun style n’est attribué, ou si style est égal à nullptr, le widget utilisera QGraphicsScene::style() (si cette fonction a été définie). Sinon, le widget utilisera QApplication::style().
Cette fonction définit l'attribut ` Qt::WA_SetStyle ` si ` style ` n'est pas ` nullptr` ; sinon, elle efface cet attribut.
Voir également style().
[static] void QGraphicsWidget::setTabOrder(QGraphicsWidget *first, QGraphicsWidget *second)
Déplace le widget « second » dans l'anneau des widgets de focus, de sorte que le focus clavier passe du widget « first » au widget « second » lorsque l'on appuie sur la touche Tab.
Notez que, l'ordre de tabulation du widget « second » étant modifié, vous devez organiser la chaîne comme suit :
setTabOrder(a, b); // a to b
setTabOrder(b, c); // a to b to c
setTabOrder(c, d); // a to b to c to detnon pas ainsi :
// WRONG
setTabOrder(c, d); // c to d
setTabOrder(a, b); // a to b AND c to d
setTabOrder(b, c); // a to b to c, but not c to dSi first est nullptr, cela indique que second doit être le premier widget à recevoir le focus de saisie lorsque la scène obtient le focus Tab (c’est-à-dire lorsque l’utilisateur appuie sur la touche Tab pour que le focus passe dans la scène). Si second est nullptr, cela indique que first doit être le premier widget à obtenir le focus lorsque la scène obtient le focus BackTab.
Par défaut, l’ordre de tabulation est défini implicitement en fonction de l’ordre de création des widgets.
Voir également « focusPolicy » et « Keyboard Focus in Widgets ».
void QGraphicsWidget::setWindowFrameMargins(QMarginsF margins)
Définit les marges du cadre de la fenêtre du widget sur margins. Les marges par défaut du cadre sont fournies par le style et dépendent des indicateurs de fenêtre actuels.
Si vous souhaitez dessiner votre propre décoration de fenêtre, vous pouvez définir vos propres marges de cadre pour remplacer les marges par défaut.
Voir également unsetWindowFrameMargins(), getWindowFrameMargins() et windowFrameRect().
void QGraphicsWidget::setWindowFrameMargins(qreal left, qreal top, qreal right, qreal bottom)
Définit les marges du cadre de la fenêtre du widget sur left, top, right et bottom.
Il s'agit d'une fonction surchargée.
[override virtual] QPainterPath QGraphicsWidget::shape() const
Réimplémente : QGraphicsItem::shape() const.
[virtual protected] void QGraphicsWidget::showEvent(QShowEvent *event)
Ce gestionnaire d'événements, destiné aux événements « Show », est déclenché avant l'affichage du widget, par exemple lorsque la méthode `setVisible(true)` a été appelée pour le widget ou l'un de ses ancêtres alors que le widget était auparavant masqué.
Vous pouvez réimplémenter ce gestionnaire d’événements pour détecter le moment où votre widget est affiché. L’appel de ` QEvent::accept()` ou ` QEvent::ignore()` sur ` event ` n’a aucun effet.
Voir également hideEvent(), QWidget::showEvent() et ItemVisibleChange.
[override virtual protected] QSizeF QGraphicsWidget::sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const
Réimplémente : QGraphicsLayoutItem::sizeHint(Qt::SizeHint which, const QSizeF &constraint) const.
QStyle *QGraphicsWidget::style() const
Renvoie un pointeur vers le style du widget. Si aucun style n'a été explicitement attribué à ce widget, c'est le style de la scène qui est renvoyé à la place. À son tour, si aucun style n'a été attribué à la scène, cette fonction renvoie QApplication::style().
Voir également setStyle().
bool QGraphicsWidget::testAttribute(Qt::WidgetAttribute attribute) const
Renvoie « true » si l'option « attribute » est activée pour ce widget ; sinon, renvoie « false ».
Voir également setAttribute().
[override virtual] int QGraphicsWidget::type() const
Réimplémente : QGraphicsItem::type() const.
[virtual protected] void QGraphicsWidget::ungrabKeyboardEvent(QEvent *event)
Ce gestionnaire d'événements, destiné à event, peut être réimplémenté dans une sous-classe afin de recevoir des notifications concernant les événements QEvent::UngrabKeyboard.
Voir également ungrabKeyboard() et ungrabMouse().
[virtual protected] void QGraphicsWidget::ungrabMouseEvent(QEvent *event)
Ce gestionnaire d'événements, destiné à event, peut être réimplémenté dans une sous-classe afin de recevoir des notifications concernant les événements QEvent::UngrabMouse.
Voir également ungrabMouse() et ungrabKeyboard().
void QGraphicsWidget::unsetWindowFrameMargins()
Rétablit les marges du cadre de la fenêtre à leur valeur par défaut, telle que définie par le style.
Voir également setWindowFrameMargins(), getWindowFrameMargins() et windowFrameRect().
[override virtual protected] void QGraphicsWidget::updateGeometry()
Réimplémente : QGraphicsLayoutItem::updateGeometry().
Si ce widget est actuellement géré par une mise en page, cette fonction informe la mise en page que les indications de taille du widget ont changé et que la mise en page devra peut-être redimensionner et repositionner le widget en conséquence.
Appelez cette fonction si la méthode ` sizeHint()` du widget a été modifiée.
Voir également QGraphicsLayout::invalidate().
[virtual protected] bool QGraphicsWidget::windowFrameEvent(QEvent *event)
Ce gestionnaire d'événements, destiné à ` event`, reçoit les événements liés au cadre de la fenêtre si ce widget est une fenêtre. Son implémentation de base prend en charge les interactions par défaut avec le cadre de la fenêtre, telles que le déplacement, le redimensionnement, etc.
Vous pouvez réimplémenter ce gestionnaire dans une sous-classe de ` QGraphicsWidget ` afin de fournir votre propre prise en charge personnalisée des interactions avec le cadre de la fenêtre.
Renvoie ` true ` si l'événement ` event ` a été détecté et traité ; sinon, renvoie ` false`.
Voir également event().
QRectF QGraphicsWidget::windowFrameGeometry() const
Renvoie la géométrie du widget dans les coordonnées du parent, y compris le cadre de la fenêtre.
Voir également windowFrameRect(), getWindowFrameMargins() et setWindowFrameMargins().
QRectF QGraphicsWidget::windowFrameRect() const
Renvoie le rectangle local du widget, y compris le cadre de la fenêtre.
Voir également windowFrameGeometry(), getWindowFrameMargins() et setWindowFrameMargins().
[virtual protected] Qt::WindowFrameSection QGraphicsWidget::windowFrameSectionAt(const QPointF &pos) const
Renvoie la section du cadre de fenêtre située à la position pos, ou Qt::NoSection s'il n'y a pas de section du cadre de fenêtre à cette position.
Cette fonction est utilisée dans l'implémentation de base de QGraphicsWidget pour l'interaction avec le cadre de la fenêtre.
Vous pouvez réimplémenter cette fonction si vous souhaitez personnaliser la manière dont une fenêtre peut être déplacée ou redimensionnée de manière interactive. Par exemple, si vous souhaitez autoriser le redimensionnement d’une fenêtre uniquement à partir du coin inférieur droit, vous pouvez réimplémenter cette fonction pour qu’elle renvoie Qt::NoSection pour toutes les sections, à l’exception de Qt::BottomRightSection.
Voir également windowFrameEvent(), paintWindowFrame() et windowFrameGeometry().
Qt::WindowType QGraphicsWidget::windowType() const
Renvoie le type de fenêtre des widgets.
Voir également windowFlags(), isWindow() et isPanel().
© 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.