~oif-team/ubuntu/natty/qt4-x11/xi2.1

<td width="1">  </td><td class="postheader" valign="center"><a href="index.html">Home</a> · <a href="classes.html">All Classes</a> · <a href="mainclasses.html">Main Classes</a> · <a href="annotated.html">Annotated</a> · <a href="groups.html">Grouped Classes</a> · <a href="functions.html">Functions</a></td>

<td align="right" valign="top" width="230"><img src="images/trolltech-logo.png" align="right" width="203" height="32" border="0" /></td></tr></table><h1 align="center">Q3Painter Class Reference</h1>

Q3Painter is the compat version of <a href="qpainter.html">QPainter</a>. <a href="#details">More...</a>

<pre>#include <Q3Painter></pre>This class is part of the Qt 3 support library. It is provided to keep old source code working. We strongly advise against using it in new code. See the <a href="porting4.html">Porting Guide</a> for more information.

Part of the <a href="qt3support.html">Qt3Support</a> module.

Inherits <a href="qpainter.html">QPainter</a>.

<ul>

<li><a href="q3painter-members.html">List of all members, including inherited members</a></li>

</ul>

<h3>Public Functions</h3>

<ul>

<li><div class="fn"/><a href="q3painter.html#Q3Painter">Q3Painter</a> ()</li>

<li><div class="fn"/><a href="q3painter.html#Q3Painter-2">Q3Painter</a> ( QPaintDevice * pdev )</li>

<li><div class="fn"/>void <a href="q3painter.html#drawArc">drawArc</a> ( const QRect & r, int a, int alen )</li>

<li><div class="fn"/>void <a href="q3painter.html#drawArc-2">drawArc</a> ( int x, int y, int w, int h, int startAngle, int spanAngle )</li>

<li><div class="fn"/>void <a href="q3painter.html#drawChord">drawChord</a> ( const QRect & r, int a, int alen )</li>

<li><div class="fn"/>void <a href="q3painter.html#drawChord-2">drawChord</a> ( int x, int y, int w, int h, int startAngle, int spanAngle )</li>

<li><div class="fn"/>void <a href="q3painter.html#drawEllipse">drawEllipse</a> ( const QRect & r )</li>

<li><div class="fn"/>void <a href="q3painter.html#drawEllipse-2">drawEllipse</a> ( int x, int y, int width, int height )</li>

<li><div class="fn"/>void <a href="q3painter.html#drawPie">drawPie</a> ( const QRect & r, int a, int alen )</li>

<li><div class="fn"/>void <a href="q3painter.html#drawPie-2">drawPie</a> ( int x, int y, int w, int h, int startAngle, int spanAngle )</li>

<li><div class="fn"/>void <a href="q3painter.html#drawRect">drawRect</a> ( const QRect & r )</li>

<li><div class="fn"/>void <a href="q3painter.html#drawRect-2">drawRect</a> ( int x, int y, int w, int h )</li>

<li><div class="fn"/>void <a href="q3painter.html#drawRoundRect">drawRoundRect</a> ( const QRect & r, int xrnd = 25, int yrnd = 25 )</li>

<li><div class="fn"/>void <a href="q3painter.html#drawRoundRect-2">drawRoundRect</a> ( int x, int y, int w, int h, int xrnd = 25, int yrnd = 25 )</li>

</ul>

<ul>

<li><div class="fn"/>162 public functions inherited from <a href="qpainter.html#public-functions">QPainter</a></li>

</ul>

<hr />

<h2>Detailed Description</h2>

Q3Painter is the compat version of <a href="qpainter.html">QPainter</a>.

Prior to Qt 4, <a href="qpainter.html">QPainter</a> specialized the pen drawing for rectangle based functions (in particular: drawRect, drawEllipse, drawRoundRect, drawArc, drawChord and drawPie). When stroking a rectangle of width 10, the pen would draw a rectangle of width 10. Drawing a polygon defined by the corner points of the same rectangle the stroke would have a width of 11.

The reason for this is best explained using the picture below:

<center><img src="images/q3painter_rationale.png" /></center>As we can see, stroking the rectangle so it gets a width of 10, means the pen is drawn on a rectangle on width 9. The polygon, however follows a consistent model.

In Qt 4, all rectangle based functions have changed to follow the polygon approach, which means that the rectangle defines the size of the fill, and the pen follows the edges of the shape. For pen widths of 0 and 1 this means that the stroke will be inside the shape on the left and the top and outside on the bottom and right.

The reason for the change in Qt 4 is so that we provide consistency for all drawing functions even with complex transformations.

<hr />

<h2>Member Function Documentation</h2>

<h3 class="fn"><a name="Q3Painter"></a>Q3Painter::Q3Painter ()</h3>

Constructs a <a href="q3painter.html">Q3Painter</a>.

<h3 class="fn"><a name="Q3Painter-2"></a>Q3Painter::Q3Painter ( <a href="qpaintdevice.html">QPaintDevice</a> * pdev )</h3>

Constructs a <a href="q3painter.html">Q3Painter</a> that operates on device pdev.

<h3 class="fn"><a name="drawArc"></a>void Q3Painter::drawArc ( const <a href="qrect.html">QRect</a> & r, int a, int alen )</h3>

Draws an arc defined by the rectangle r, the start angle a and the arc length alen.

The angles a and alen are 1/16th of a degree, i.e. a full circle equals 5760 (16*360). Positive values of a and alen mean counter-clockwise while negative values mean the clockwise direction. Zero degrees is at the 3 o'clock position.

Example:

<pre>  QPainter p(myWidget);

p.drawArc(QRect(10,10, 70,100), 100*16, 160*16); // draws a "(" arc</pre>

See also <a href="q3painter.html#drawPie">drawPie</a>() and <a href="q3painter.html#drawChord">drawChord</a>().

<h3 class="fn"><a name="drawArc-2"></a>void Q3Painter::drawArc ( int x, int y, int w, int h, int startAngle, int spanAngle )</h3>

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Draws the arc that fits inside the rectangle (x, y, w, h), with the given startAngle and spanAngle.

<h3 class="fn"><a name="drawChord"></a>void Q3Painter::drawChord ( const <a href="qrect.html">QRect</a> & r, int a, int alen )</h3>

Draws a chord defined by the rectangle r, the start angle a and the arc length alen.

The chord is filled with the current <a href="qpainter.html#brush">brush</a>().

See also <a href="q3painter.html#drawArc">drawArc</a>() and <a href="q3painter.html#drawPie">drawPie</a>().

<h3 class="fn"><a name="drawChord-2"></a>void Q3Painter::drawChord ( int x, int y, int w, int h, int startAngle, int spanAngle )</h3>

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Draws a chord that fits inside the rectangle (x, y, w, h) with the given startAngle and spanAngle.

<h3 class="fn"><a name="drawEllipse"></a>void Q3Painter::drawEllipse ( const <a href="qrect.html">QRect</a> & r )</h3>

Draws the ellipse that fits inside the bounds r using the current pen and brush.

<h3 class="fn"><a name="drawEllipse-2"></a>void Q3Painter::drawEllipse ( int x, int y, int width, int height )</h3>

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Draws an ellipse that fits inside the bounds specified by x, y, width and height using the current pen and brush.

<h3 class="fn"><a name="drawPie"></a>void Q3Painter::drawPie ( const <a href="qrect.html">QRect</a> & r, int a, int alen )</h3>

Draws a pie defined by the rectangle r, the start angle a and the arc length alen.

The pie is filled with the current <a href="qpainter.html#brush">brush</a>().

See also <a href="q3painter.html#drawArc">drawArc</a>() and <a href="q3painter.html#drawChord">drawChord</a>().

<h3 class="fn"><a name="drawPie-2"></a>void Q3Painter::drawPie ( int x, int y, int w, int h, int startAngle, int spanAngle )</h3>

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Draws a pie segment that fits inside the bounds (x, y, w, h) with the given startAngle and spanAngle.

<h3 class="fn"><a name="drawRect"></a>void Q3Painter::drawRect ( const <a href="qrect.html">QRect</a> & r )</h3>

Draws a rectangle that fits inside the rectangle r using the current pen and brush.

<h3 class="fn"><a name="drawRect-2"></a>void Q3Painter::drawRect ( int x, int y, int w, int h )</h3>

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Draws the rectangle that fits inside the bounds specified by x, y, w and h using the current pen and brush.

100

<h3 class="fn"><a name="drawRoundRect"></a>void Q3Painter::drawRoundRect ( const <a href="qrect.html">QRect</a> & r, int xrnd = 25, int yrnd = 25 )</h3>

101

Draws a rounded rect that fits into the bounds r using the current pen and brush. The parameters xrnd and yrnd specifies the roundness in x and y direction.

102

<h3 class="fn"><a name="drawRoundRect-2"></a>void Q3Painter::drawRoundRect ( int x, int y, int w, int h, int xrnd = 25, int yrnd = 25 )</h3>

103

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

104

Draws a rounded rect that fits into the bounds x, y, w and h using the current pen and brush. The parameters xrnd and yrnd specifies the roundness in x and y direction.

105

106

107

108

<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>

109

110

</tr></table></div></address></body>

111

</html>

Older »