QStylePainter Class

QStylePainter 类是一个方便的类，用于在 widget 中绘制QStyle 元素。更多

Header：	`#include <QStylePainter>`
CMake：	`find_package(Qt6 REQUIRED COMPONENTS Widgets)` `target_link_libraries(mytarget PRIVATE Qt6::Widgets)`
qmake：	`QT += widgets`
继承：	QPainter

所有成员（包括继承成员）的列表
QStylePainter 属于绘画类。

公共函数

	QStylePainter()
	QStylePainter(QWidget *widget)
	QStylePainter(QPaintDevice pd, QWidget widget)
bool	begin(QWidget *widget)
bool	begin(QPaintDevice pd, QWidget widget)
void	drawComplexControl(QStyle::ComplexControl cc, const QStyleOptionComplex &option)
void	drawControl(QStyle::ControlElement ce, const QStyleOption &option)
void	drawItemPixmap(const QRect &rect, int flags, const QPixmap &pixmap)
void	drawItemText(const QRect &rect, int flags, const QPalette &pal, bool enabled, const QString &text, QPalette::ColorRole textRole = QPalette::NoRole)
void	drawPrimitive(QStyle::PrimitiveElement pe, const QStyleOption &option)
QStyle *	style() const

详细说明

QStylePainter 扩展了QPainter ，在QStyle 的 API 基础上实现了一组高级draw...() 函数。使用 QStylePainter 的好处是参数列表大大缩短。QStyle 对象必须能够使用任何绘制器在任何部件上绘制（因为应用程序通常有一个供所有部件共享的QStyle 对象），而 QStylePainter 则是通过部件初始化的，因此无需为每次函数调用指定QWidget 、QPainter 和QStyle 。

直接使用QStyle 的示例：

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);
}

使用 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);
}

另请参阅 QStyle 和QStyleOption 。

成员函数文档

QStylePainter::QStylePainter()

构造一个 QStylePainter。

`[explicit]` QStylePainter::QStylePainter(QWidget **widget*)

使用 widgetwidget 为其绘制设备构建 QStylePainter。

QStylePainter::QStylePainter(QPaintDevice *pd, QWidget **widget*)

使用pd 构建 QStylePainter 的绘制设备，并使用widget 中的属性。

bool QStylePainter::begin(QWidget **widget*)

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

构造函数会自动调用该函数，该函数接收QWidget 。

bool QStylePainter::begin(QPaintDevice *pd, QWidget **widget*)

这是一个重载函数。

开始对油漆设备pd 进行油漆操作，就像widget 一样。

该函数由构造函数自动调用，构造函数包含QPaintDevice 和QWidget 。

void QStylePainter::drawComplexControl(QStyle::ComplexControl cc, const QStyleOptionComplex &option)

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

另请参阅 QStyle::drawComplexControl() 。

void QStylePainter::drawControl(QStyle::ControlElement ce, const QStyleOption &option)

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

另请参阅 QStyle::drawControl() 。

void QStylePainter::drawItemPixmap(const QRect &rect, int flags, const QPixmap &pixmap)

在rect 矩形中绘制pixmap 。像素图按照flags 对齐。

另请参阅 QStyle::drawItemPixmap() 和Qt::Alignment 。

void QStylePainter::drawItemText(const QRect &rect, int flags, const QPalette &pal, bool enabled, const QString &text, QPalette::ColorRole textRole = QPalette::NoRole)

在矩形rect 和调色板pal 中绘制text 。文本按照flags 对齐和包边。

笔的颜色用textRole 指定。enabled bool 表示是否启用项目；重新实现时，该 bool 应影响项目的绘制方式。

另请参阅 QStyle::drawItemText() 和Qt::Alignment 。

void QStylePainter::drawPrimitive(QStyle::PrimitiveElement pe, const QStyleOption &option)

使用 widget 的样式绘制由QStyleOption option 指定的原始元素pe 。

另请参阅 QStyle::drawPrimitive() 。

QStyle *QStylePainter::style() const

返回QStylePainter 当前使用的样式。

© 2025 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.