qpainter.html

QT软件的详细说明

<li><div class=fn>void <a href="#drawEllipse"><b>drawEllipse</b></a> ( int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h )</div></li>
<li><div class=fn>void <a href="#drawEllipse-2"><b>drawEllipse</b></a> ( const&nbsp;QRect&nbsp;&amp;&nbsp;r )</div></li>
<li><div class=fn>void <a href="#drawArc"><b>drawArc</b></a> ( int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h, int&nbsp;a, int&nbsp;alen )</div></li>
<li><div class=fn>void <a href="#drawArc-2"><b>drawArc</b></a> ( const&nbsp;QRect&nbsp;&amp;&nbsp;r, int&nbsp;a, int&nbsp;alen )</div></li>
<li><div class=fn>void <a href="#drawPie"><b>drawPie</b></a> ( int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h, int&nbsp;a, int&nbsp;alen )</div></li>
<li><div class=fn>void <a href="#drawPie-2"><b>drawPie</b></a> ( const&nbsp;QRect&nbsp;&amp;&nbsp;r, int&nbsp;a, int&nbsp;alen )</div></li>
<li><div class=fn>void <a href="#drawChord"><b>drawChord</b></a> ( int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h, int&nbsp;a, int&nbsp;alen )</div></li>
<li><div class=fn>void <a href="#drawChord-2"><b>drawChord</b></a> ( const&nbsp;QRect&nbsp;&amp;&nbsp;r, int&nbsp;a, int&nbsp;alen )</div></li>
<li><div class=fn>void <a href="#drawLineSegments"><b>drawLineSegments</b></a> ( const&nbsp;QPointArray&nbsp;&amp;&nbsp;a, int&nbsp;index = 0, int&nbsp;nlines = -1 )</div></li>
<li><div class=fn>void <a href="#drawPolyline"><b>drawPolyline</b></a> ( const&nbsp;QPointArray&nbsp;&amp;&nbsp;a, int&nbsp;index = 0, int&nbsp;npoints = -1 )</div></li>
<li><div class=fn>void <a href="#drawPolygon"><b>drawPolygon</b></a> ( const&nbsp;QPointArray&nbsp;&amp;&nbsp;a, bool&nbsp;winding = FALSE, int&nbsp;index = 0, int&nbsp;npoints = -1 )</div></li>
<li><div class=fn>void <a href="#drawConvexPolygon"><b>drawConvexPolygon</b></a> ( const&nbsp;QPointArray&nbsp;&amp;&nbsp;pa, int&nbsp;index = 0, int&nbsp;npoints = -1 )</div></li>
<li><div class=fn>void <a href="#drawCubicBezier"><b>drawCubicBezier</b></a> ( const&nbsp;QPointArray&nbsp;&amp;&nbsp;a, int&nbsp;index = 0 )</div></li>
<li><div class=fn>void <a href="#drawPixmap"><b>drawPixmap</b></a> ( int&nbsp;x, int&nbsp;y, const&nbsp;QPixmap&nbsp;&amp;&nbsp;pixmap, int&nbsp;sx = 0, int&nbsp;sy = 0, int&nbsp;sw = -1, int&nbsp;sh = -1 )</div></li>
<li><div class=fn>void <a href="#drawPixmap-2"><b>drawPixmap</b></a> ( const&nbsp;QPoint&nbsp;&amp;&nbsp;p, const&nbsp;QPixmap&nbsp;&amp;&nbsp;pm, const&nbsp;QRect&nbsp;&amp;&nbsp;sr )</div></li>
<li><div class=fn>void <a href="#drawPixmap-3"><b>drawPixmap</b></a> ( const&nbsp;QPoint&nbsp;&amp;&nbsp;p, const&nbsp;QPixmap&nbsp;&amp;&nbsp;pm )</div></li>
<li><div class=fn>void <a href="#drawPixmap-4"><b>drawPixmap</b></a> ( const&nbsp;QRect&nbsp;&amp;&nbsp;r, const&nbsp;QPixmap&nbsp;&amp;&nbsp;pm )</div></li>
<li><div class=fn>void <a href="#drawImage"><b>drawImage</b></a> ( int&nbsp;x, int&nbsp;y, const&nbsp;QImage&nbsp;&amp;&nbsp;image, int&nbsp;sx = 0, int&nbsp;sy = 0, int&nbsp;sw = -1, int&nbsp;sh = -1, int&nbsp;conversionFlags = 0 )</div></li>
<li><div class=fn>void <a href="#drawImage-2"><b>drawImage</b></a> ( const QPoint &amp;, const QImage &amp;, const&nbsp;QRect&nbsp;&amp;&nbsp;sr, int&nbsp;conversionFlags = 0 )</div></li>
<li><div class=fn>void <a href="#drawImage-3"><b>drawImage</b></a> ( const&nbsp;QPoint&nbsp;&amp;&nbsp;p, const&nbsp;QImage&nbsp;&amp;&nbsp;i, int&nbsp;conversion_flags = 0 )</div></li>
<li><div class=fn>void <a href="#drawImage-4"><b>drawImage</b></a> ( const&nbsp;QRect&nbsp;&amp;&nbsp;r, const&nbsp;QImage&nbsp;&amp;&nbsp;i )</div></li>
<li><div class=fn>void <a href="#drawTiledPixmap"><b>drawTiledPixmap</b></a> ( int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h, const&nbsp;QPixmap&nbsp;&amp;&nbsp;pixmap, int&nbsp;sx = 0, int&nbsp;sy = 0 )</div></li>
<li><div class=fn>void <a href="#drawTiledPixmap-2"><b>drawTiledPixmap</b></a> ( const&nbsp;QRect&nbsp;&amp;&nbsp;r, const&nbsp;QPixmap&nbsp;&amp;&nbsp;pm, const&nbsp;QPoint&nbsp;&amp;&nbsp;sp )</div></li>
<li><div class=fn>void <a href="#drawTiledPixmap-3"><b>drawTiledPixmap</b></a> ( const&nbsp;QRect&nbsp;&amp;&nbsp;r, const&nbsp;QPixmap&nbsp;&amp;&nbsp;pm )</div></li>
<li><div class=fn>void drawPicture ( const&nbsp;QPicture&nbsp;&amp;&nbsp;pic ) &nbsp;<em>(obsolete)</em></div></li>
<li><div class=fn>void <a href="#drawPicture"><b>drawPicture</b></a> ( int&nbsp;x, int&nbsp;y, const&nbsp;QPicture&nbsp;&amp;&nbsp;pic )</div></li>
<li><div class=fn>void <a href="#drawPicture-3"><b>drawPicture</b></a> ( const&nbsp;QPoint&nbsp;&amp;&nbsp;p, const&nbsp;QPicture&nbsp;&amp;&nbsp;pic )</div></li>
<li><div class=fn>void <a href="#fillRect"><b>fillRect</b></a> ( int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h, const&nbsp;QBrush&nbsp;&amp;&nbsp;brush )</div></li>
<li><div class=fn>void <a href="#fillRect-2"><b>fillRect</b></a> ( const&nbsp;QRect&nbsp;&amp;&nbsp;r, const&nbsp;QBrush&nbsp;&amp;&nbsp;brush )</div></li>
<li><div class=fn>void <a href="#eraseRect"><b>eraseRect</b></a> ( int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h )</div></li>
<li><div class=fn>void <a href="#eraseRect-2"><b>eraseRect</b></a> ( const&nbsp;QRect&nbsp;&amp;&nbsp;r )</div></li>
<li><div class=fn>enum <a href="#TextDirection-enum"><b>TextDirection</b></a> { Auto, RTL, LTR }</div></li>
<li><div class=fn>void <a href="#drawText-2"><b>drawText</b></a> ( int&nbsp;x, int&nbsp;y, const QString &amp;, int&nbsp;len = -1, TextDirection&nbsp;dir = Auto )</div></li>
<li><div class=fn>void <a href="#drawText-3"><b>drawText</b></a> ( const QPoint &amp;, const QString &amp;, int&nbsp;len = -1, TextDirection&nbsp;dir = Auto )</div></li>
<li><div class=fn>void <a href="#drawText-4"><b>drawText</b></a> ( int&nbsp;x, int&nbsp;y, const QString &amp;, int&nbsp;pos, int&nbsp;len, TextDirection&nbsp;dir = Auto )</div></li>
<li><div class=fn>void <a href="#drawText"><b>drawText</b></a> ( const&nbsp;QPoint&nbsp;&amp;&nbsp;p, const QString &amp;, int&nbsp;pos, int&nbsp;len, TextDirection&nbsp;dir = Auto )</div></li>
<li><div class=fn>void <a href="#drawText-5"><b>drawText</b></a> ( int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h, int&nbsp;flags, const QString &amp;, int&nbsp;len = -1, QRect&nbsp;*&nbsp;br = 0, QTextParag&nbsp;**&nbsp;internal = 0 )</div></li>
<li><div class=fn>void <a href="#drawText-6"><b>drawText</b></a> ( const&nbsp;QRect&nbsp;&amp;&nbsp;r, int&nbsp;tf, const&nbsp;QString&nbsp;&amp;&nbsp;str, int&nbsp;len = -1, QRect&nbsp;*&nbsp;brect = 0, QTextParag&nbsp;**&nbsp;internal = 0 )</div></li>
<li><div class=fn>QRect <a href="#boundingRect"><b>boundingRect</b></a> ( int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h, int&nbsp;flags, const QString &amp;, int&nbsp;len = -1, QTextParag&nbsp;**&nbsp;intern = 0 )</div></li>
<li><div class=fn>QRect <a href="#boundingRect-2"><b>boundingRect</b></a> ( const&nbsp;QRect&nbsp;&amp;&nbsp;r, int&nbsp;flags, const&nbsp;QString&nbsp;&amp;&nbsp;str, int&nbsp;len = -1, QTextParag&nbsp;**&nbsp;internal = 0 )</div></li>
<li><div class=fn>int <a href="#tabStops"><b>tabStops</b></a> () const</div></li>
<li><div class=fn>void <a href="#setTabStops"><b>setTabStops</b></a> ( int&nbsp;ts )</div></li>
<li><div class=fn>int * <a href="#tabArray"><b>tabArray</b></a> () const</div></li>
<li><div class=fn>void <a href="#setTabArray"><b>setTabArray</b></a> ( int&nbsp;*&nbsp;ta )</div></li>
<li><div class=fn>HDC <a href="#handle"><b>handle</b></a> () const</div></li>
</ul>
<h2>静态公有成员</h2>
<ul>
<li><div class=fn>void <a href="#redirect"><b>redirect</b></a> ( QPaintDevice&nbsp;*&nbsp;pdev, QPaintDevice&nbsp;*&nbsp;replacement )</div></li>
</ul>
<h2>相关函数</h2>
<ul>
<li><div class=fn>void <a href="#qDrawShadeLine"><b>qDrawShadeLine</b></a> ( QPainter&nbsp;*&nbsp;p, int&nbsp;x1, int&nbsp;y1, int&nbsp;x2, int&nbsp;y2, const&nbsp;QColorGroup&nbsp;&amp;&nbsp;g, bool&nbsp;sunken, int&nbsp;lineWidth, int&nbsp;midLineWidth )</div></li>
<li><div class=fn>void <a href="#qDrawShadeRect"><b>qDrawShadeRect</b></a> ( QPainter&nbsp;*&nbsp;p, int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h, const&nbsp;QColorGroup&nbsp;&amp;&nbsp;g, bool&nbsp;sunken, int&nbsp;lineWidth, int&nbsp;midLineWidth, const&nbsp;QBrush&nbsp;*&nbsp;fill )</div></li>
<li><div class=fn>void <a href="#qDrawShadePanel"><b>qDrawShadePanel</b></a> ( QPainter&nbsp;*&nbsp;p, int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h, const&nbsp;QColorGroup&nbsp;&amp;&nbsp;g, bool&nbsp;sunken, int&nbsp;lineWidth, const&nbsp;QBrush&nbsp;*&nbsp;fill )</div></li>
<li><div class=fn>void <a href="#qDrawWinButton"><b>qDrawWinButton</b></a> ( QPainter&nbsp;*&nbsp;p, int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h, const&nbsp;QColorGroup&nbsp;&amp;&nbsp;g, bool&nbsp;sunken, const&nbsp;QBrush&nbsp;*&nbsp;fill )</div></li>
<li><div class=fn>void <a href="#qDrawWinPanel"><b>qDrawWinPanel</b></a> ( QPainter&nbsp;*&nbsp;p, int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h, const&nbsp;QColorGroup&nbsp;&amp;&nbsp;g, bool&nbsp;sunken, const&nbsp;QBrush&nbsp;*&nbsp;fill )</div></li>
<li><div class=fn>void <a href="#qDrawPlainRect"><b>qDrawPlainRect</b></a> ( QPainter&nbsp;*&nbsp;p, int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h, const&nbsp;QColor&nbsp;&amp;&nbsp;c, int&nbsp;lineWidth, const&nbsp;QBrush&nbsp;*&nbsp;fill )</div></li>
</ul>
<hr><a name="details"></a><h2>详细描述</h2>


QPainter类低水平的绘制，例如在窗口部件上。
<p> 绘制工具为做到绝大部分绘制图形用户界面程序的需要提供了高度优化的函数。QPainter可以绘制从简单的直线到像饼图和弦这样的复杂形状。它也可以绘制排列的文本和像素映射。通常，它在一个“自然的”坐标系统中绘制，但是它也可以在视和世界转换中做到这些。
<p> 绘图工具的典型用法是：
<p> <ul>
<li> 构造一个绘图工具。
<li> 设置画笔、画刷等等。
<li> 绘制。
<li> 销毁这个绘图工具。
</ul>
<p> 绝大多数情况下，所有这些是在一个绘制事件中完成的。（实际上，99％的QPainter使用是在<a href="qwidget.html#paintEvent">QWidget::paintEvent</a>()的重新实现中，并且绘制工具已经为这种用法高度优化了。）这里是一个非常简单的实例：
<p> <pre>
    void SimpleExampleWidget::paintEvent()
    {
        QPainter paint( this );
        paint.<a href="#setPen">setPen</a>( Qt::blue );
        paint.<a href="#drawText">drawText</a>( rect(), AlignCenter, "The Text" );
    }
    </pre>
 
<p> 使用方法很简单并且这里有你可以使用的许多设置：
<p> <ul>
<p> <li> <a href="#font">font</a>()是当前设置的字体。如果你设置一个不可用的字体，Qt会找到一个相近的匹配。实际上，font()返回你使用<a href="#setFont">setFont</a>() 所设置的东西并且<a href="#fontInfo">fontInfo</a>()返回你实际使用的字体（这也许是相同的）。
<p> <li> <a href="#brush">brush</a>()是当前设置的画刷，用来填充例如圆的颜色或者调色板。
<p> <li> <a href="#pen">pen</a>()是当前设置的画笔，用来画线或者边缘的颜色或者点画。
<p> <li> <a href="#backgroundMode">backgroundMode</a>()是<tt>Opaque</tt>或者<tt>Transparent</tt>，也就是是不是使用<a href="#backgroundColor">backgroundColor</a>()。
<p> <li>  仅仅当backgroundMode()为Opaque并且pen()是一个点画的时候backgroundColor()才适用，它描述了在点画中背景像素的颜色。
<p> <li> <a href="#rasterOp">rasterOp</a>()是像素绘制和已经存在的像素是如何相互作用的。
<p> <li> <a href="#brushOrigin">brushOrigin</a>()是平铺的画刷的原点，通常是窗口的原点。
<p> <li> <a href="#viewport">viewport</a>()、<a href="#window">window</a>()、<a href="#worldMatrix">worldMatrix</a>()和很多其它的构成了绘制工具的坐标转换系统。关于这个的解释请参考<a href="coordsys.html">坐标系统</a>或者参考下面有关这些函数的非常简要的概述。
<p> <li> clipping()是指绘制工具是否裁剪。（绘制设备也裁剪。）如果绘制工具裁剪，它裁剪到<a href="#clipRegion">clipRegion</a>()。
<p> <li> <a href="#pos">pos</a>()是当前位置，通过<a href="#moveTo">moveTo</a>()设置并且通过<a href="#lineTo">lineTo</a>()使用。
<p> </ul>
<p> 注意这些设置中的一些会镜像到一些绘制设备的设置中，例如<a href="qwidget.html#font">QWidget::font</a>()。<a href="#begin">QPainter::begin</a>()（或者QPainter的构造函数）从绘制设备中复制这些属性。调用，例如<a href="qwidget.html#setFont">QWidget::setFont</a>()直到绘制工具开始在它上面绘制才会生效。
<p> 把所有的这些设置保存到内部栈中，<a href="#restore">restore</a>()把它们弹出来。
<p> QPainter的核心功能是绘制，并且这里有最简单的绘制函数：<a href="#drawPoint">drawPoint</a>()、<a href="#drawPoints">drawPoints</a>()、<a href="#drawLine">drawLine</a>()、<a href="#drawRect">drawRect</a>()、<a href="#drawWinFocusRect">drawWinFocusRect</a>()、<a href="#drawRoundRect">drawRoundRect</a>()、<a href="#drawEllipse">drawEllipse</a>()、<a href="#drawArc">drawArc</a>()、<a href="#drawPie">drawPie</a>()、<a href="#drawChord">drawChord</a>()、<a href="#drawLineSegments">drawLineSegments</a>()、<a href="#drawPolyline">drawPolyline</a>()、<a href="#drawPolygon">drawPolygon</a>()、<a href="#drawConvexPolygon">drawConvexPolygon</a>()和<a href="#drawCubicBezier">drawCubicBezier</a>()。所有这些函数使用整数坐标，它们没有浮点数的版本，因为我们想使绘制尽可能快地进行。
<p> 这里有绘制像素映射/图像的函数，名为<a href="#drawPixmap">drawPixmap</a>()、<a href="#drawImage">drawImage</a>()和<a href="#drawTiledPixmap">drawTiledPixmap</a>()。drawPixmap()和drawImage()产生同样的结果，除了drawPixmap()在屏幕上更快一些并且drawImage()在<a href="qprinter.html">QPrinter</a>和<a href="qpicture.html">QPicture</a>上更快并且有时更好。
<p> 使用<a href="#drawText">drawText</a>()可以完成文本绘制，并且当你需要良好的定位，<a href="#boundingRect">boundingRect</a>()告诉你哪里是给定的drawText()命令将要绘制的。
<p> 这里有一个<a href="#drawPicture">drawPicture</a>()函数，用来使用这个绘制工具绘制整个QPicture的内容。drawPicture()是唯一忽视所有绘制工具设置的函数：QPicture有它自己的设置。
<p> 通常，QPainter在设备自己的坐标系统（通常是像素）上操作，但是QPainter也很好地支持坐标转换。关于更通用的概述和简单实例请参考<a href="coordsys.html">坐标系统</a>。
<p> 最常用到的函数是<a href="#scale">scale</a>()、<a href="#rotate">rotate</a>()、<a href="#translate">translate</a>()和<a href="#shear">shear</a>()，所有这些在<a href="#worldMatrix">worldMatrix</a>()上操作。<a href="#setWorldMatrix">setWorldMatrix</a>()可以替换或者添加到当前设置的worldMatrix()。
<p> <a href="#setViewport">setViewport</a>()设置QPainter操作的矩形。默认是整个设备，这通常就很好了，除了在打印机上。<a href="#setWindow">setWindow</a>()设置坐标系统，它是被映射到<a href="#viewport">viewport</a>()的矩形。在<a href="#window">window</a>()中绘制的东西最终会在viewport()中。窗口的默认就是和视口一样，并且如果你没有使用转换，它们会被优化，赢得一点点速度。
<p> 在所有坐标转换完成之后，QPainter能够把绘制裁剪到一个任意的矩形或者区域。如果QPainter裁剪了，<a href="#hasClipping">hasClipping</a>()为真并且<a href="#clipRegion">clipRegion</a>()返回裁剪区域。你可以使用<a href="#setClipRegion">setClipRegion</a>()或<a href="#setClipRect">setClipRect</a>()来设置它。注意裁剪是很慢的。它是完全依赖系统的，但是单凭经验的方法，你可以假设绘制的速度与裁剪区域中的矩形数量成反比。
<p> 在QPainter的裁剪之后，绘制设备也可以被裁剪。例如，绝大多数窗口部件按子窗口部件的像素裁剪并且绝大多数打印机按接近纸的边缘裁剪。这些另外的裁剪不会受clipRegion()或hasClipping()的返回值影响。
<p> QPainter也包括一些比较少用到的函数，它们在当它们被需要的时候是非常有用的。
<p> <a href="#isActive">isActive</a>()指出绘制工具是否是激活的。<a href="#begin">begin</a>()（和最常用的构造函数）使它激活。<a href="#end">end</a>()（和析构函数）释放它们。如果绘制工具是激活的，<a href="#device">device</a>()返回绘制工具在哪个绘制设备上绘制。
<p> 有时让其它什么在一个不平常的<a href="qpaintdevice.html">QPaintDevice</a>上绘制是人们想要的。QPainter支持一个静态函数来做这些，<a href="#redirect">redirect</a>()。我们建议不要使用它，但是对于一些老手这是完美的。
<p> <a href="#setTabStops">setTabStops</a>()和<a href="#setTabArray">setTabArray</a>()可以改变tab在哪里停止，但是它们极少被用到。
<p> <b>警告：</b>注意QPainter不会试图在底层窗口系统的左边限制周围工作。坐标在+/-4000时，一些平台的行为可能就不正确了。

<p> <p>请参考<a href="qpaintdevice.html">QPaintDevice</a>、<a href="qwidget.html">QWidget</a>、<a href="qpixmap.html">QPixmap</a>、<a href="qprinter.html">QPrinter</a>、<a href="qpicture.html">QPicture</a>、<a href="simple-application.html">应用程序预演</a>、<a href="coordsys.html">坐标系统概述</a>、<a href="graphics.html">图像类</a>和<a href="images.html">图像处理类</a>。

<hr><h2>成员类型文档</h2>
<h3 class=fn><a name="CoordinateMode-enum"></a>QPainter::CoordinateMode</h3>
<ul>
<li><tt>QPainter::CoordDevice</tt>
<li><tt>QPainter::CoordPainter</tt>
</ul><p> <p>请参考<a href="#clipRegion">clipRegion</a>()。

<h3 class=fn><a name="TextDirection-enum"></a>QPainter::TextDirection</h3>

<ul>
<li><tt>QPainter::Auto</tt>
<li><tt>QPainter::RTL</tt> - 从右到左
<li><tt>QPainter::LTR</tt> - 从左到右
</ul><p> <p>请参考<a href="#drawText">drawText</a>()。

<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QPainter"></a>QPainter::QPainter ()
</h3>