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, */): 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, */): painter = QStylePainter(self) option = QStyleOptionFocusRect() option.initFrom(self) option.backgroundColor = palette().color(QPalette.Background) painter.drawPrimitive(QStyle.PE_FrameFocusRect, option)See also
- class PySide6.QtWidgets.QStylePainter¶
PySide6.QtWidgets.QStylePainter(pd, w)
PySide6.QtWidgets.QStylePainter(w)
- Parameters
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.
- PySide6.QtWidgets.QStylePainter.begin(pd, w)¶
- Parameters
- 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
.
- PySide6.QtWidgets.QStylePainter.begin(w)
- Parameters
- 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
.
- PySide6.QtWidgets.QStylePainter.drawComplexControl(cc, opt)¶
- Parameters
Use the widget’s style to draw a complex control cc
specified by the QStyleOptionComplex
option
.
See also
- PySide6.QtWidgets.QStylePainter.drawControl(ce, opt)¶
- Parameters
ce –
ControlElement
Use the widget’s style to draw a control element ce
specified by QStyleOption
option
.
See also
- PySide6.QtWidgets.QStylePainter.drawItemPixmap(r, flags, pixmap)¶
- Parameters
flags – int
pixmap –
PySide6.QtGui.QPixmap
Draws the pixmap
in rectangle rect
. The pixmap is aligned according to flags
.
See also
drawItemPixmap()
Alignment
- PySide6.QtWidgets.QStylePainter.drawItemText(r, flags, pal, enabled, text[, textRole=QPalette.NoRole])¶
- Parameters
flags – int
pal –
PySide6.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
- PySide6.QtWidgets.QStylePainter.drawPrimitive(pe, opt)¶
- Parameters
pe –
PrimitiveElement
Use the widget’s style to draw a primitive element pe
specified by QStyleOption
option
.
See also
- PySide6.QtWidgets.QStylePainter.style()¶
- Return type
Return the current style used by the QStylePainter
.
© 2022 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.