PySide6.QtWidgets.QStylePainter¶

class QStylePainter¶

QStylePainter 类是一个用于在小部件内绘制 QStyle 元素的便利类。更多…

概要¶

方法¶

• def __init__()

• def begin()

• def drawComplexControl()

• def drawControl()

• def drawItemPixmap()

• def drawItemText()

• def drawPrimitive()

• def style()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

QStylePainter 扩展了 QPainter，提供了一组在 QStyle 的 API 基础上实现的高级 draw...() 函数。使用 QStylePainter 的优势在于参数列表大大缩短。虽然 QStyle 对象必须能够使用任何画家在任何小部件上绘制（因为应用程序通常有一个由所有小部件共享的 QStyle 对象），但 QStylePainter 是用一个小部件初始化的，从而消除了为每个函数调用指定 QWidget、QPainter 和 QStyle 的需要。

直接使用QStyle的示例：

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)

使用 QStylePainter 的示例：

def paintEvent(self, */):
painter = QStylePainter(self)
option = QStyleOptionFocusRect()
option.initFrom(self)
option.backgroundColor = palette().color(QPalette.Background)
painter.drawPrimitive(QStyle.PE_FrameFocusRect, option)

另请参阅

QStyle QStyleOption

__init__()¶

构造一个QStylePainter。

__init__(w)

Parameters:

w – QWidget

使用小部件 widget 作为其绘制设备来构造一个 QStylePainter。

__init__(pd, w)

Parameters:

• pd – QPaintDevice

• w – QWidget

使用pd作为其绘图设备，并从widget中获取属性来构造一个QStylePainter。

begin(w)¶

Parameters:

w – QWidget

Return type:

布尔

开始在指定的widget上进行绘制操作。如果绘制器准备就绪，则返回true；否则返回false。

这是由接受QWidget的构造函数自动调用的。

begin(pd, w)

Parameters:

• pd – QPaintDevice

• w – QWidget

Return type:

布尔

这是一个重载函数。

开始在绘画设备 pd 上进行绘画操作，就像它是 widget 一样。

这是由接受 QPaintDevice 和 QWidget 的构造函数自动调用的。

drawComplexControl(cc, opt)¶

Parameters:

• cc – ComplexControl

• opt – QStyleOptionComplex

使用小部件的样式来绘制由QStyleOptionComplex option指定的复杂控件cc。

另请参阅

drawComplexControl()

drawControl(ce, opt)¶

Parameters:

• ce – ControlElement

• opt – QStyleOption

使用小部件的样式来绘制由QStyleOption option指定的控制元素ce。

另请参阅

drawControl()

drawItemPixmap(r, flags, pixmap)¶

Parameters:

• r – QRect

• flags – int

• pixmap – QPixmap

在矩形 rect 中绘制 pixmap。pixmap 根据 flags 进行对齐。

另请参阅

drawItemPixmap() 对齐方式

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

Parameters:

• r – QRect

• flags – int

• pal – QPalette

• enabled – 布尔值

• 文本 – str

• textRole – ColorRole

在矩形 rect 和调色板 pal 中绘制 text。文本根据 flags 进行对齐和换行。

笔的颜色由textRole指定。enabled布尔值表示该项是否启用；在重新实现时，此布尔值应影响项的绘制方式。

另请参阅

drawItemText() 对齐方式

drawPrimitive(pe, opt)¶

Parameters:

• pe – PrimitiveElement

• opt – QStyleOption

使用小部件的样式绘制由QStyleOption option指定的基本元素pe。

另请参阅

drawPrimitive()

style()¶

Return type:

QStyle

返回当前由QStylePainter使用的样式。