QGraphicsEllipseItem Class
La clase `QGraphicsEllipseItem` proporciona un elemento elíptico que se puede añadir a un ` QGraphicsScene`. Más información...
| Encabezado: | #include <QGraphicsEllipseItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QAbstractGraphicsShapeItem |
Tipos públicos
| enum { Type } |
Funciones públicas
| 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 |
Funciones públicas reimplementadas
| 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 |
Descripción detallada
QGraphicsEllipseItem representa una elipse con relleno y contorno, y también se puede utilizar para segmentos de elipse (véase startAngle(), spanAngle()).
![]() | ![]() |
Para definir la elipse del elemento, pasa un objeto ` QRectF ` al constructor de `QGraphicsEllipseItem` o llama a ` setRect()`. La función ` rect()` devuelve la geometría actual de la elipse.
QGraphicsEllipseItem utiliza el rectángulo y el grosor del trazo para proporcionar una implementación adecuada de boundingRect(), shape() y contains(). La función paint() dibuja la elipse utilizando el trazo y el pincel asociados al elemento, que se pueden configurar llamando a setPen() y setBrush().
Véase también QGraphicsPathItem, QGraphicsRectItem, QGraphicsPolygonItem, QGraphicsTextItem, QGraphicsLineItem, QGraphicsPixmapItem y Graphics View Framework.
Documentación sobre los tipos de miembro
[anonymous] enum
El valor devuelto por la función virtual ` type()`.
| Constante | Valor | Descripción |
|---|---|---|
QGraphicsEllipseItem::Type | 4 | Un elemento gráfico de elipse |
Documentación de la función miembro
[explicit] QGraphicsEllipseItem::QGraphicsEllipseItem(QGraphicsItem *parent = nullptr)
Crea un objeto `QGraphicsEllipseItem`. Se pasa ` parent ` al constructor de ` QAbstractGraphicsShapeItem`.
Véase también QGraphicsScene::addItem().
[explicit] QGraphicsEllipseItem::QGraphicsEllipseItem(const QRectF &rect, QGraphicsItem *parent = nullptr)
Crea un objeto `QGraphicsEllipseItem` utilizando ` rect ` como rectángulo predeterminado. Se pasa ` parent ` al constructor de ` QAbstractGraphicsShapeItem`.
Véase también QGraphicsScene::addItem().
[explicit] QGraphicsEllipseItem::QGraphicsEllipseItem(qreal x, qreal y, qreal width, qreal height, QGraphicsItem *parent = nullptr)
Crea un objeto `QGraphicsEllipseItem` utilizando el rectángulo definido por (x, y) y los valores proporcionados ` width ` y ` height` como rectángulo predeterminado. Se pasa ` parent ` al constructor de ` QAbstractGraphicsShapeItem`.
Véase también QGraphicsScene::addItem().
[virtual noexcept] QGraphicsEllipseItem::~QGraphicsEllipseItem()
Destruye el « QGraphicsEllipseItem ».
[override virtual] QRectF QGraphicsEllipseItem::boundingRect() const
Reimplementa: QGraphicsItem::boundingRect() const.
[override virtual] bool QGraphicsEllipseItem::contains(const QPointF &point) const
Reimplementa: ` QGraphicsItem::contains` (const QPointF &point) const.
[override virtual] bool QGraphicsEllipseItem::isObscuredBy(const QGraphicsItem *item) const
Reimplementa: ` QAbstractGraphicsShapeItem::isObscuredBy(const QGraphicsItem *item) const`.
[override virtual] QPainterPath QGraphicsEllipseItem::opaqueArea() const
Reimplementa: QAbstractGraphicsShapeItem::opaqueArea() const.
[override virtual] void QGraphicsEllipseItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)
Reimplementa: ` QGraphicsItem::paint` (`QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)`.
QRectF QGraphicsEllipseItem::rect() const
Devuelve la geometría elíptica del elemento como un objeto de tipo « QRectF ».
Véase también setRect() y QPainter::drawEllipse().
void QGraphicsEllipseItem::setRect(const QRectF &rect)
Establece la geometría elíptica del elemento en rect. El borde izquierdo del rectángulo define el borde izquierdo de la elipse, y el borde superior del rectángulo describe la parte superior de la elipse. La altura y la anchura del rectángulo describen la altura y la anchura de la elipse.
Véase también rect() y QPainter::drawEllipse().
void QGraphicsEllipseItem::setRect(qreal x, qreal y, qreal width, qreal height)
Establece el rectángulo del elemento en el rectángulo definido por (x, y) y los valores proporcionados width y height.
Esta función de conveniencia equivale a llamar a setRect(QRectF(x, y, width, height))
Véase también rect().
void QGraphicsEllipseItem::setSpanAngle(int angle)
Establece el ángulo de extensión de un segmento de elipse en angle, expresado en dieciséisavos de grado. Este ángulo se utiliza junto con startAngle() para representar un segmento de elipse (un sector circular). Por defecto, el ángulo de extensión es 5760 (360 × 16, una elipse completa).
Véanse también spanAngle(), setStartAngle() y QPainter::drawPie().
void QGraphicsEllipseItem::setStartAngle(int angle)
Establece el ángulo inicial de un segmento de elipse en angle, que está expresado en dieciseisavos de grado. Este ángulo se utiliza junto con spanAngle() para representar un segmento de elipse (un sector circular). Por defecto, el ángulo inicial es 0.
Véanse también startAngle(), setSpanAngle() y QPainter::drawPie().
[override virtual] QPainterPath QGraphicsEllipseItem::shape() const
Reimplementa: ` QGraphicsItem::shape()` const.
int QGraphicsEllipseItem::spanAngle() const
Devuelve el ángulo de extensión de un segmento de elipse en dieciseisavos de grado. Este ángulo se utiliza junto con startAngle() para representar un segmento de elipse (un sector circular). Por defecto, esta función devuelve 5760 (360 * 16, una elipse completa).
Véanse también setSpanAngle() y startAngle().
int QGraphicsEllipseItem::startAngle() const
Devuelve el ángulo inicial de un segmento de elipse expresado en dieciseisavos de grado. Este ángulo se utiliza junto con la función ` spanAngle()` para representar un segmento de elipse (un sector circular). Por defecto, el ángulo inicial es 0.
Véanse también setStartAngle() y spanAngle().
[override virtual] int QGraphicsEllipseItem::type() const
Reimplementa: ` 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.

