QStylePainter Class

The QStylePainter class is a convenience class for drawing QStyle elements inside a widget. More...

Header: #include <QStylePainter>
qmake: QT += widgets

Public Functions

QStylePainter()
QStylePainter(int *w)
QStylePainter(QPaintDevice *pd, int *w)
bool begin(int *w)
bool begin(QPaintDevice *pd, int *w)
void drawComplexControl(int cc, const int &opt)
void drawControl(int ce, const int &opt)
void drawItemPixmap(const int &r, int flags, const int &pixmap)
void drawItemText(const int &r, int flags, const int &pal, bool enabled, const QString &text, int textRole = ...)
void drawPrimitive(int pe, const int &opt)
int *style() const

Detailed Description

The QStylePainter class is a convenience class for drawing QStyle elements inside a widget.

QStylePainter extends QPainter with a set of high-level draw...() functions implemented on top of QStyle's API. The advantage of using QStylePainter is that the parameter lists get considerably shorter. Whereas a QStyle object must be able to draw on any widget using any painter (because the application normally has one QStyle object shared by all widget), a QStylePainter is initialized with a widget, eliminating the need to specify the QWidget, the QPainter, and the QStyle for every function call.

Example using QStyle directly:

 void MyWidget::paintEvent(QPaintEvent * /* event */)
 {
     QPainter painter(this);

     QStyleOptionFocusRect option;
     option.initFrom(this);
     option.backgroundColor = palette().color(QPalette::Background);

     style()->drawPrimitive(QStyle::PE_FrameFocusRect, &option, &painter, this);
 }

Example using QStylePainter:

 void MyWidget::paintEvent(QPaintEvent * /* event */)
 {
     QStylePainter painter(this);

     QStyleOptionFocusRect option;
     option.initFrom(this);
     option.backgroundColor = palette().color(QPalette::Background);

     painter.drawPrimitive(QStyle::PE_FrameFocusRect, option);
 }

See also QStyle and QStyleOption.

Member Function Documentation

QStylePainter::QStylePainter()

Default constructs an instance of QStylePainter.

QStylePainter::QStylePainter(int *w)

Default constructs an instance of QStylePainter.

QStylePainter::QStylePainter(QPaintDevice *pd, int *w)

Default constructs an instance of QStylePainter.

bool QStylePainter::begin(int *w)

bool QStylePainter::begin(QPaintDevice *pd, int *w)

void QStylePainter::drawComplexControl(int cc, const int &opt)

void QStylePainter::drawControl(int ce, const int &opt)

void QStylePainter::drawItemPixmap(const int &r, int flags, const int &pixmap)

void QStylePainter::drawItemText(const int &r, int flags, const int &pal, bool enabled, const QString &text, int textRole = ...)

void QStylePainter::drawPrimitive(int pe, const int &opt)

int *QStylePainter::style() const