Sur cette page

QGraphicsEllipseItem Class

La classe `QGraphicsEllipseItem` fournit un élément de type ellipse que vous pouvez ajouter à un ` QGraphicsScene`. En savoir plus...

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

Types publics

enum { Type }

Fonctions publiques

QGraphicsEllipseItem(QGraphicsItem *parent = nullptr)
QGraphicsEllipseItem(const QRectF &rect, QGraphicsItem *parent = nullptr)
QGraphicsEllipseItem(qreal x, qreal y, qreal width, qreal height, QGraphicsItem *parent = nullptr)
virtual ~QGraphicsEllipseItem()
QRectF rect() const
void setRect(const QRectF &rect)
void setRect(qreal x, qreal y, qreal width, qreal height)
void setSpanAngle(int angle)
void setStartAngle(int angle)
int spanAngle() const
int startAngle() const

Fonctions publiques réimplémentées

virtual QRectF boundingRect() const override
virtual bool contains(const QPointF &point) const override
virtual bool isObscuredBy(const QGraphicsItem *item) const override
virtual QPainterPath opaqueArea() const override
virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override
virtual QPainterPath shape() const override
virtual int type() const override

Description détaillée

QGraphicsEllipseItem représente une ellipse avec un remplissage et un contour ; vous pouvez également l'utiliser pour des segments d'ellipse (voir startAngle(), spanAngle()).

Forme d'ellipse complèteForme elliptique avec un angle de départ et un angle d'étendue

Pour définir l’ellipse de l’élément, transmettez un objet ` QRectF ` au constructeur de `QGraphicsEllipseItem`, ou appelez la fonction ` setRect()`. La fonction ` rect()` renvoie la géométrie actuelle de l’ellipse.

QGraphicsEllipseItem utilise le rectangle et la largeur de stylo pour fournir une implémentation raisonnable des méthodes boundingRect(), shape() et contains(). La fonction paint() dessine l'ellipse à l'aide du stylo et du pinceau associés à l'élément, que vous pouvez définir en appelant les méthodes setPen() et setBrush().

Voir également QGraphicsPathItem, QGraphicsRectItem, QGraphicsPolygonItem, QGraphicsTextItem, QGraphicsLineItem, QGraphicsPixmapItem et Graphics View Framework.

Documentation sur les types de membres

[anonymous] enum

Valeur renvoyée par la fonction virtuelle ` type()`.

ConstanteValeurDescription
QGraphicsEllipseItem::Type4Un élément graphique de type ellipse

Documentation des fonctions membres

[explicit] QGraphicsEllipseItem::QGraphicsEllipseItem(QGraphicsItem *parent = nullptr)

Crée un objet `QGraphicsEllipseItem`. L'objet ` parent ` est transmis au constructeur de ` QAbstractGraphicsShapeItem`.

Voir aussi QGraphicsScene::addItem().

[explicit] QGraphicsEllipseItem::QGraphicsEllipseItem(const QRectF &rect, QGraphicsItem *parent = nullptr)

Crée un objet `QGraphicsEllipseItem` en utilisant ` rect ` comme rectangle par défaut. ` parent ` est transmis au constructeur de ` QAbstractGraphicsShapeItem`.

Voir aussi QGraphicsScene::addItem().

[explicit] QGraphicsEllipseItem::QGraphicsEllipseItem(qreal x, qreal y, qreal width, qreal height, QGraphicsItem *parent = nullptr)

Crée un objet `QGraphicsEllipseItem` en utilisant le rectangle défini par (x, y) ainsi que les paramètres ` width ` et ` height` fournis comme rectangle par défaut. ` parent ` est transmis au constructeur de ` QAbstractGraphicsShapeItem`.

Voir également QGraphicsScene::addItem().

[virtual noexcept] QGraphicsEllipseItem::~QGraphicsEllipseItem()

Supprime l'QGraphicsEllipseItem.

[override virtual] QRectF QGraphicsEllipseItem::boundingRect() const

Réimplémente : QGraphicsItem::boundingRect() const.

[override virtual] bool QGraphicsEllipseItem::contains(const QPointF &point) const

Réimplémente : QGraphicsItem::contains(const QPointF &point) const.

[override virtual] bool QGraphicsEllipseItem::isObscuredBy(const QGraphicsItem *item) const

Réimplémente : QAbstractGraphicsShapeItem::isObscuredBy(const QGraphicsItem *item) const.

[override virtual] QPainterPath QGraphicsEllipseItem::opaqueArea() const

Réimplémente : QAbstractGraphicsShapeItem::opaqueArea() const.

[override virtual] void QGraphicsEllipseItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)

Réimplémente : QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).

QRectF QGraphicsEllipseItem::rect() const

Renvoie la géométrie elliptique de l'élément sous la forme d'un objet de type ` QRectF`.

Voir également setRect() et QPainter::drawEllipse().

void QGraphicsEllipseItem::setRect(const QRectF &rect)

Définit la géométrie elliptique de l'élément sur rect. Le bord gauche du rectangle définit le bord gauche de l'ellipse, et le bord supérieur du rectangle décrit le haut de l'ellipse. La hauteur et la largeur du rectangle correspondent respectivement à la hauteur et à la largeur de l'ellipse.

Voir également rect() et QPainter::drawEllipse().

void QGraphicsEllipseItem::setRect(qreal x, qreal y, qreal width, qreal height)

Définit le rectangle de l'élément sur celui défini par (x, y) et les valeurs fournies width et height.

Cette fonction pratique équivaut à l'appel de setRect(QRectF(x, y, width, height))

Voir également rect().

void QGraphicsEllipseItem::setSpanAngle(int angle)

Définit l'angle d'ouverture d'un segment d'ellipse à la valeur angle, exprimée en seizièmes de degré. Cet angle est utilisé conjointement avec la fonction startAngle() pour représenter un segment d'ellipse (une part de cercle). Par défaut, l'angle d'ouverture est de 5760 (360 × 16, soit une ellipse complète).

Voir également spanAngle(), setStartAngle() et QPainter::drawPie().

void QGraphicsEllipseItem::setStartAngle(int angle)

Définit l'angle de départ d'un segment d'ellipse à la valeur « angle », exprimée en seizièmes de degré. Cet angle est utilisé conjointement avec la fonction « spanAngle() » pour représenter un segment d'ellipse (une part de cercle). Par défaut, l'angle de départ est égal à 0.

Voir également startAngle(), setSpanAngle() et QPainter::drawPie().

[override virtual] QPainterPath QGraphicsEllipseItem::shape() const

Réimplémente : QGraphicsItem::shape() const.

int QGraphicsEllipseItem::spanAngle() const

Renvoie l'angle d'ouverture d'un segment d'ellipse exprimé en seizièmes de degré. Cet angle est utilisé conjointement avec la fonction startAngle() pour représenter un segment d'ellipse (une part de cercle). Par défaut, cette fonction renvoie 5760 (360 × 16, soit une ellipse complète).

Voir également setSpanAngle() et startAngle().

int QGraphicsEllipseItem::startAngle() const

Renvoie l'angle de départ d'un segment d'ellipse en seizièmes de degré. Cet angle est utilisé conjointement avec la fonction spanAngle() pour représenter un segment d'ellipse (un secteur circulaire). Par défaut, l'angle de départ est égal à 0.

Voir également setStartAngle() et spanAngle().

[override virtual] int QGraphicsEllipseItem::type() const

Réimplémente : QGraphicsItem::type() const.

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