Sur cette page

QStyleOptionGraphicsItem Class

La classe `QStyleOptionGraphicsItem` sert à définir les paramètres nécessaires au tracé d'un ` QGraphicsItem`. En savoir plus...

En-tête : #include <QStyleOptionGraphicsItem>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Hérite de : QStyleOption

Types publics

enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

Fonctions publiques

QStyleOptionGraphicsItem()
QStyleOptionGraphicsItem(const QStyleOptionGraphicsItem &other)
QStyleOptionGraphicsItem &operator=(const QStyleOptionGraphicsItem &)

Variables publiques

QRectF exposedRect

Membres publics statiques

qreal levelOfDetailFromTransform(const QTransform &worldTransform)

Description détaillée

Pour des raisons de performances, il y a peu de fonctions membres et l'accès aux variables membres est direct (c'est-à-dire à l'aide des opérateurs . ou -> ). Cela rend les structures simples à utiliser et souligne le fait qu'il s'agit simplement de paramètres utilisés par les fonctions de style.

Voir également QStyleOption et QGraphicsItem::paint().

Documentation sur les types de membres

enum QStyleOptionGraphicsItem::StyleOptionType

Cette énumération sert à stocker des informations sur le type de l'option de style et est définie pour chaque sous-classe de ` QStyleOption `.

ConstanteValeurDescription
QStyleOptionGraphicsItem::TypeSO_GraphicsItemLe type de l'option de style fournie (SO_GraphicsItem pour cette classe).

Ce type est utilisé en interne par ` QStyleOption`, ses sous-classes et la méthode ` qstyleoption_cast()` pour déterminer le type de l’option de style. En général, vous n’avez pas à vous en soucier, sauf si vous souhaitez créer votre propre sous-classe de ` QStyleOption ` et vos propres styles.

Voir également StyleOptionVersion.

enum QStyleOptionGraphicsItem::StyleOptionVersion

Cette énumération sert à contenir des informations sur la version de l'option de style et est définie pour chaque sous-classe de ` QStyleOption `.

ConstanteValeurDescription
QStyleOptionGraphicsItem::Version11

Cette version est utilisée par les sous-classes de ` QStyleOption ` pour implémenter des extensions sans rompre la compatibilité. Si vous utilisez ` qstyleoption_cast()`, vous n’avez généralement pas besoin de la vérifier.

Voir aussi StyleOptionType.

Documentation sur les fonctions membres

QStyleOptionGraphicsItem::QStyleOptionGraphicsItem()

Crée un objet `QStyleOptionGraphicsItem`.

QStyleOptionGraphicsItem::QStyleOptionGraphicsItem(const QStyleOptionGraphicsItem &other)

Crée une copie de other.

[static] qreal QStyleOptionGraphicsItem::levelOfDetailFromTransform(const QTransform &worldTransform)

Renvoie le niveau de détail issu de l'worldTransform.

Sa valeur correspond à la valeur maximale de la hauteur et de la largeur d’un rectangle Unity, mise en correspondance à l’aide de l’ worldTransform du peintre utilisé pour dessiner l’élément. Par défaut, si aucune transformation n’est appliquée, sa valeur est égale à 1. En cas de zoom arrière de 1:2, le niveau de détail sera de 0,5, et en cas de zoom avant de 2:1, sa valeur sera égale à 2.

Voir également QGraphicsScene::minimumRenderSize().

[noexcept default] QStyleOptionGraphicsItem &QStyleOptionGraphicsItem::operator=(const QStyleOptionGraphicsItem &)

Attribue par copie la variable ` other ` à cette instance de ` QStyleOptionGraphicsItem `.

Documentation sur les variables membres

QRectF QStyleOptionGraphicsItem::exposedRect

Cette variable contient le rectangle visible, exprimé en coordonnées de l'objet

Utilisez ce rectangle pour accélérer le tracé de l'élément lorsque seules certaines parties de celui-ci sont visibles. Si l'élément est entièrement visible, ce rectangle sera identique à celui renvoyé par la fonction ` QGraphicsItem::boundingRect()`.

Ce membre n’est initialisé que pour les éléments dont l’indicateur « QGraphicsItem::ItemUsesExtendedStyleOption » est activé.

© 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.