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
()
Note
This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE
Detailed Description#
Warning
This section contains snippets that were automatically translated from C++ to Python and may contain errors.
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
.