QPaintDevice Class Reference

[QtGui module]

在一个QPaintDevice类是可绘对象的基类。More…

通过继承QGLFramebufferObject，QGLPixelBuffer，QImage，QPicture，QPixmap，QPrinter，QSvgGenerator和QWidget。

Types

• enum PaintDeviceMetric { PdmWidth, PdmHeight, PdmWidthMM, PdmHeightMM, ..., PdmPhysicalDpiY }

Methods

• __init__ (self)
• int colorCount (self)
• int depth (self)
• int height (self)
• int heightMM (self)
• int logicalDpiX (self)
• int logicalDpiY (self)
• int metric (self, PaintDeviceMetric metric)
• int numColors (self)
• QPaintEngine paintEngine (self)
• bool paintingActive (self)
• int physicalDpiX (self)
• int physicalDpiY (self)
• int width (self)
• int widthMM (self)

Detailed Description

在一个QPaintDevice类是可绘对象的基类。

一种涂料设备是一个二维空间的抽象，可以使用被绘制QPainter。其默认的坐标系统的原点位于左上角的位置。 X增加的权利和Y向下增加。该单元是一个像素。

一个QPaintDevice的绘图功能由目前实施QWidget，QImage，QPixmap，QGLPixelBuffer，QPicture和QPrinter子类。

要实现一个新的后台支持，您必须来自一个QPaintDevice和重新实现虚拟paintEngine（ ）函数来告诉QPainter其中绘图引擎应该被用来绘制这个特定的设备上。请注意，您还必须创建一个相应的绘图引擎，能够绘制在设备上，即派生自QPaintEngine并重新实现其虚函数。

Warning:Qt的规定，QApplication对象存在可以创建任何油漆设备之前。油漆设备访问窗口的系统资源，并创建一个应用程序对象之前，这些资源不被初始化。

在一个QPaintDevice类提供了一些函数返回的各种设备指标：该depth（）函数返回它的比特深度（位平面的数量）。该height（ ）函数返回它的高度在默认坐标系统的单位（如像素QPixmap和QWidget），而heightMM（ ）返回设备的高度以毫米为单位。 Similiarily时，width（）和widthMM（ ）函数返回的设备在默认的宽度坐标系单位和以毫米为单位，分别。或者，受保护的metric（）函数可用于通过指定所希望的检索度量信息PaintDeviceMetric作为参数。

该logicalDpiX（）和logicalDpiY（ ）函数返回设备的每英寸的点数的水平和垂直分辨率。该physicalDpiX（）和physicalDpiY（ ）函数也返回该设备以每英寸点数的分辨率，但要注意，如果逻辑和物理分辨率不同，相应的QPaintEngine必须处理的映射。最后，该colorCount（ ）函数返回不同的颜色可供绘制设备的数量。

Type Documentation

QPaintDevice.PaintDeviceMetric

描述了一个绘图设备的各种指标。

See also metric（ ） 。

Method Documentation

QPaintDevice.__init__ (self)

构造一个绘图设备。此构造函数只能从子类调用QPaintDevice。

int QPaintDevice.colorCount (self)

返回不同的颜色可供绘制设备的数量。因为这个值是一个整数，它不会是足以代表在32位显示的颜色的数量，在这种情况下INT_MAX被返回来代替。

int QPaintDevice.depth (self)

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

int QPaintDevice.height (self)

返回绘制设备的默认高度坐标系统的单位（如像素QPixmap和QWidget） 。

See also heightMM（ ） 。

int QPaintDevice.heightMM (self)

返回漆装置以毫米为单位的高度。由于平台的限制，它可能无法使用这个函数来确定屏幕上的一个小部件的实际物理尺寸。

See also height（ ） 。

int QPaintDevice.logicalDpiX (self)

返回以每英寸点数，这是计算的字体大小时使用的设备的水平分辨率。为X11 ，这通常是因为可以从计算同一widthMM（ ） 。

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

See also logicalDpiY（）和physicalDpiX（ ） 。

int QPaintDevice.logicalDpiY (self)

返回以每英寸点数，这是计算的字体大小时使用的设备的垂直分辨率。为X11 ，这通常是因为可以从计算同一heightMM（ ） 。

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

See also logicalDpiX（）和physicalDpiY（ ） 。

int QPaintDevice.metric (self, PaintDeviceMetric metric)

返回度量信息对于给定的涂料设备metric。

See also PaintDeviceMetric。

int QPaintDevice.numColors (self)

此功能已被弃用。

使用colorCount（ ）来代替。

返回不同的颜色可供绘制设备的数量。因为这个值是一个整数，它不会是足以代表在32位显示的颜色的数量，在这种情况下INT_MAX被返回来代替。

QPaintEngine QPaintDevice.paintEngine (self)

[

这种方法是抽象的，应在任何子类中重新实现。

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

bool QPaintDevice.paintingActive (self)

](docs_qpaintengine.html)

如果返回设备当前正在绘制的，即有人叫真QPainter.begin（），但尚未被称为QPainter.end（ ）此设备，否则返回False 。

See also QPainter.isActive（ ） 。

int QPaintDevice.physicalDpiX (self)

返回以每英寸点数设备的水平分辨率。例如，在打印时，这项决议是指物理打印机的分辨率。在另一方面的逻辑DPI ，是指所使用的实际绘图引擎的分辨率。

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

See also physicalDpiY（）和logicalDpiX（ ） 。

int QPaintDevice.physicalDpiY (self)

返回以每英寸点数设备的水平分辨率。例如，在打印时，这项决议是指物理打印机的分辨率。在另一方面的逻辑DPI ，是指所使用的实际绘图引擎的分辨率。

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

See also physicalDpiX（）和logicalDpiY（ ） 。

int QPaintDevice.width (self)

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

See also widthMM（ ） 。

int QPaintDevice.widthMM (self)

返回漆装置以毫米为单位的宽度。由于平台的限制，它可能无法使用这个函数来确定屏幕上的一个小部件的实际物理尺寸。

See also width（ ） 。