QStylePainter Class
La clase `QStylePainter` es una clase de utilidad que permite dibujar elementos de tipo ` QStyle ` dentro de un widget. Más información...
| Encabezado: | #include <QStylePainter> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QPainter |
- Lista de todos los miembros, incluidos los heredados
- QStylePainter forma parte de las clases de pintura.
Funciones públicas
| QStylePainter() | |
| QStylePainter(QWidget *widget) | |
| QStylePainter(QPaintDevice *pd, QWidget *widget) | |
| bool | begin(QWidget *widget) |
| bool | begin(QPaintDevice *pd, QWidget *widget) |
| void | drawComplexControl(QStyle::ComplexControl cc, const QStyleOptionComplex &option) |
| void | drawControl(QStyle::ControlElement ce, const QStyleOption &option) |
| void | drawItemPixmap(const QRect &rect, int flags, const QPixmap &pixmap) |
| void | drawItemText(const QRect &rect, int flags, const QPalette &pal, bool enabled, const QString &text, QPalette::ColorRole textRole = QPalette::NoRole) |
| void | drawPrimitive(QStyle::PrimitiveElement pe, const QStyleOption &option) |
| QStyle * | style() const |
Descripción detallada
QStylePainter amplía a QPainter con un conjunto de funciones de alto nivel draw...() implementadas sobre la API de QStyle. La ventaja de utilizar QStylePainter es que las listas de parámetros se acortan considerablemente. Mientras que un objeto ` QStyle ` debe ser capaz de dibujar en cualquier widget utilizando cualquier pintor (ya que la aplicación suele tener un único objeto ` QStyle ` compartido por todos los widgets), un `QStylePainter` se inicializa con un widget, lo que elimina la necesidad de especificar ` QWidget`, ` QPainter` y ` QStyle ` en cada llamada a la función.
Ejemplo de uso directo de « QStyle »:
void MyWidget::paintEvent(QPaintEvent * /* event */)
{
QPainter painter(this);
QStyleOptionFocusRect option;
option.initFrom(this);
option.backgroundColor = palette().color(QPalette::Window);
style()->drawPrimitive(QStyle::PE_FrameFocusRect, &option, &painter, this);
}Ejemplo de uso de QStylePainter:
void MyWidget::paintEvent(QPaintEvent * /* event */)
{
QStylePainter painter(this);
QStyleOptionFocusRect option;
option.initFrom(this);
option.backgroundColor = palette().color(QPalette::Window);
painter.drawPrimitive(QStyle::PE_FrameFocusRect, option);
}Véase también QStyle y QStyleOption.
Documentación de las funciones miembro
QStylePainter::QStylePainter()
Crea un objeto QStylePainter.
[explicit] QStylePainter::QStylePainter(QWidget *widget)
Crea un QStylePainter utilizando el widget widget como dispositivo de pintura.
QStylePainter::QStylePainter(QPaintDevice *pd, QWidget *widget)
Crea un QStylePainter utilizando pd como dispositivo de dibujo y los atributos de widget.
bool QStylePainter::begin(QWidget *widget)
Inicia las operaciones de pintura en el ` widget` especificado. Devuelve ` true ` si el pintor está listo para su uso; en caso contrario, devuelve ` false`.
Esta función es llamada automáticamente por el constructor que toma un QWidget.
bool QStylePainter::begin(QPaintDevice *pd, QWidget *widget)
Inicia las operaciones de dibujo en el dispositivo de pintura pd como si fuera widget.
Esto lo llama automáticamente el constructor que toma un QPaintDevice y un QWidget.
Se trata de una función sobrecargada.
void QStylePainter::drawComplexControl(QStyle::ComplexControl cc, const QStyleOptionComplex &option)
Utiliza el estilo del widget para dibujar un control complejo cc especificado por QStyleOptionComplex option .
Véase también QStyle::drawComplexControl().
void QStylePainter::drawControl(QStyle::ControlElement ce, const QStyleOption &option)
Utiliza el estilo del widget para dibujar un elemento de control ce especificado por QStyleOption option .
Véase también QStyle::drawControl().
void QStylePainter::drawItemPixmap(const QRect &rect, int flags, const QPixmap &pixmap)
Dibuja el mapa de píxeles « pixmap » en el rectángulo « rect ». El mapa de píxeles se alinea según « flags ».
Véase también QStyle::drawItemPixmap() y Qt::Alignment.
void QStylePainter::drawItemText(const QRect &rect, int flags, const QPalette &pal, bool enabled, const QString &text, QPalette::ColorRole textRole = QPalette::NoRole)
Dibuja el texto « text » en el rectángulo « rect » y con la paleta de colores « pal ». El texto se alinea y se ajusta según « flags ».
El color del lápiz se especifica con textRole. El valor booleano enabled indica si el elemento está habilitado o no; al reimplementar esto, dicho valor debería influir en cómo se dibuja el elemento.
Véase también QStyle::drawItemText() y Qt::Alignment.
void QStylePainter::drawPrimitive(QStyle::PrimitiveElement pe, const QStyleOption &option)
Utiliza el estilo del widget para dibujar un elemento primitivo pe especificado por QStyleOption option .
Véase también QStyle::drawPrimitive().
QStyle *QStylePainter::style() const
Devuelve el estilo actual utilizado por QStylePainter.
© 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.