QPaintDevice Class

成员函数文档

[noexcept protected] QPaintDevice::QPaintDevice()

创建一个绘图设备。此构造函数只能由 QPaintDevice 的子类调用。

[virtual noexcept] QPaintDevice::~QPaintDevice()

销毁绘制设备并释放窗口系统资源。

int QPaintDevice::colorCount() const

返回绘图设备可用的不同颜色数量。如果可用颜色数量过多，以至于无法用 int 数据类型表示，则返回 INT_MAX。

int QPaintDevice::depth() const

返回绘图设备的位深度（位平面数量）。

qreal QPaintDevice::devicePixelRatio() const

返回设备的设备像素比。

常见值为：1 表示普通 DPI 显示屏，2 表示高 DPI “视网膜”显示屏。

qreal QPaintDevice::devicePixelRatioF() const

返回该设备的设备像素比，结果为浮点数。

[static, since 6.8] int QPaintDevice::encodeMetricF(QPaintDevice::PaintDeviceMetric metric, double value)

返回针对度量标准metric 编码的value 。实现metric() 的子类应使用此函数进行编码

该函数在 Qt 6.8 中引入。

int QPaintDevice::height() const

返回绘图设备在默认坐标系单位下的高度（例如，对于 `QPixmap ` 和 `QWidget`，结果为像素）。

另请参阅 heightMM()。

int QPaintDevice::heightMM() const

返回绘图设备的高度（单位为毫米）。由于平台的限制，可能无法使用此函数来确定小部件在屏幕上的实际物理尺寸。

另请参阅 height()。

int QPaintDevice::logicalDpiX() const

返回设备的水平分辨率（单位为每英寸点数），该值用于计算字体大小。对于 X11，该值通常与通过 `widthMM()` 计算出的值相同。

请注意，如果 logicalDpiX() 的返回值不等于physicalDpiX() 的计算结果，则相应的QPaintEngine 必须处理分辨率映射。

另请参阅 logicalDpiY() 和physicalDpiX()。

int QPaintDevice::logicalDpiY() const

返回设备的垂直分辨率（单位为每英寸点数），该值用于计算字体大小。对于 X11，该值通常与通过 `heightMM()` 计算出的结果一致。

请注意，如果 logicalDpiY() 的返回值不等于physicalDpiY() 的计算结果，则相应的QPaintEngine 必须处理分辨率映射。

另请参阅 logicalDpiX() 和physicalDpiY()。

[virtual protected] int QPaintDevice::metric(QPaintDevice::PaintDeviceMetric metric) const

返回给定绘制设备metric 的度量信息。

另请参阅 PaintDeviceMetric 。

[pure virtual] QPaintEngine *QPaintDevice::paintEngine() const

返回一个指向用于在设备上绘制的绘图引擎的指针。

bool QPaintDevice::paintingActive() const

如果当前正在对该设备进行绘制（即有人已调用QPainter::begin()，但尚未为该设备调用QPainter::end()），则返回true ；否则返回false 。

另请参阅 QPainter::isActive()。

int QPaintDevice::physicalDpiX() const

返回设备的水平分辨率（单位为每英寸点数）。例如，在打印时，该分辨率指的是打印机的物理分辨率。而逻辑DPI则指的是实际绘图引擎所使用的分辨率。

请注意，如果 physicalDpiX() 与logicalDpiX() 的值不一致，则相应的QPaintEngine 必须处理分辨率映射。

另请参阅 physicalDpiY() 和logicalDpiX()。

int QPaintDevice::physicalDpiY() const

返回设备的水平分辨率（单位为每英寸点数）。例如，在打印时，该分辨率指的是打印机的物理分辨率。而逻辑DPI则指的是实际绘图引擎所使用的分辨率。

请注意，如果 physicalDpiY() 与logicalDpiY() 不相等，则相应的QPaintEngine 必须处理分辨率映射。

另请参阅 physicalDpiX() 和logicalDpiY()。

int QPaintDevice::width() const

返回绘图设备的宽度，单位为默认坐标系的单位（例如，对于QPixmap 和QWidget ，单位为像素）。

另请参阅 widthMM()。

int QPaintDevice::widthMM() const

返回绘制设备的宽度（单位为毫米）。由于平台的限制，可能无法使用此函数来确定小部件在屏幕上的实际物理尺寸。

另请参阅 width()。