QPaintDevice 类

成员函数文档

[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

返回设备像素比作为浮点数。

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()。

[虚保护] int QPaintDevice::metric(QPaintDevice::PaintDeviceMetric metric) const

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

另请参阅PaintDeviceMetric。

[纯虚] QPaintEngine *QPaintDevice::paintEngine() const

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

bool QPaintDevice::paintingActive() const

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

另请参阅QPainter::isActive。

int QPaintDevice::physicalDpiX() const

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

请注意，如果physicalDpiX()不等于logicalDpiX()，相应的QPaintEngine必须处理分辨率映射。

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

int QPaintDevice::physicalDpiY() const

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

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

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

int QPaintDevice::width() const

返回绘制设备的宽度，以默认坐标系单位（例如，QPixmap和QWidget的像素）计算。

另请参阅widthMM()。

int QPaintDevice::widthMM() const

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

另请参阅 宽度。