QStylePainter¶

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

Synopsis¶

Functions¶

def begin (pd, w)
def begin (w)
def drawComplexControl (cc, opt)
def drawControl (ce, opt)
def drawItemPixmap (r, flags, pixmap)
def drawItemText (r, flags, pal, enabled, text[, textRole=QPalette.NoRole])
def drawPrimitive (pe, opt)
def style ()

Detailed Description¶

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:
def paintEvent(self, event):


    painter = QPainter(self)


    option = QStyleOptionFocusRect()
    option.initFrom(self)
    option.backgroundColor = palette().color(QPalette.Background)


    style().drawPrimitive(QStyle.PE_FrameFocusRect, option, painter, self)
Example using QStylePainter :
def paintEvent(self, event):
{
    painter = QStylePainter(self)


    option = QStyleOptionFocusRect()
    option.initFrom(self)
    option.backgroundColor = palette().color(QPalette.Background)


    painter.drawPrimitive(QStyle.PE_FrameFocusRect, option)
See also

QStyle QStyleOption

class PySide2.QtWidgets.QStylePainter¶

PySide2.QtWidgets.QStylePainter(pd, w)

PySide2.QtWidgets.QStylePainter(w)

param w:

PySide2.QtWidgets.QWidget

param pd:

PySide2.QtGui.QPaintDevice

Constructs a QStylePainter .

Construct a QStylePainter using pd for its paint device, and attributes from widget .

Construct a QStylePainter using widget widget for its paint device.

PySide2.QtWidgets.QStylePainter.begin(pd, w)¶

Parameters:

pd – PySide2.QtGui.QPaintDevice
w – PySide2.QtWidgets.QWidget

Return type:

bool

This is an overloaded function.

Begin painting operations on paint device pd as if it was widget .

This is automatically called by the constructor that takes a QPaintDevice and a QWidget .

PySide2.QtWidgets.QStylePainter.begin(w)

Parameters:: w – PySide2.QtWidgets.QWidget
Return type:: bool

Begin painting operations on the specified widget . Returns true if the painter is ready to use; otherwise returns false .

This is automatically called by the constructor that takes a QWidget .

PySide2.QtWidgets.QStylePainter.drawComplexControl(cc, opt)¶

Parameters:

cc – ComplexControl
opt – PySide2.QtWidgets.QStyleOptionComplex

Use the widget’s style to draw a complex control cc specified by the QStyleOptionComplex option .

See also

drawComplexControl()

PySide2.QtWidgets.QStylePainter.drawControl(ce, opt)¶

Parameters:

ce – ControlElement
opt – PySide2.QtWidgets.QStyleOption

Use the widget’s style to draw a control element ce specified by QStyleOption option .

See also

drawControl()

PySide2.QtWidgets.QStylePainter.drawItemPixmap(r, flags, pixmap)¶

Parameters:

r – PySide2.QtCore.QRect
flags – int
pixmap – PySide2.QtGui.QPixmap

Draws the pixmap in rectangle rect . The pixmap is aligned according to flags .

See also

drawItemPixmap() Alignment

PySide2.QtWidgets.QStylePainter.drawItemText(r, flags, pal, enabled, text[, textRole=QPalette.NoRole])¶

Parameters:

r – PySide2.QtCore.QRect
flags – int
pal – PySide2.QtGui.QPalette
enabled – bool
text – str
textRole – ColorRole

Draws the text in rectangle rect and palette pal . The text is aligned and wrapped according to flags .

The pen color is specified with textRole . The enabled bool indicates whether or not the item is enabled; when reimplementing this bool should influence how the item is drawn.

See also

drawItemText() Alignment

PySide2.QtWidgets.QStylePainter.drawPrimitive(pe, opt)¶

Parameters: