You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tqt3/doc/html/qcanvasellipse.html

170 lines
8.4 KiB

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/canvas/qcanvas.cpp:4671 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>TQCanvasEllipse Class</title>
<style type="text/css"><!--
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">Home</font></a>
| <a href="classes.html">
<font color="#004faf">All&nbsp;Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped&nbsp;Classes</font></a>
| <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQCanvasEllipse Class Reference<br><small>[<a href="canvas.html">canvas module</a>]</small></h1>
<p>The TQCanvasEllipse class provides an ellipse or ellipse segment on a TQCanvas.
<a href="#details">More...</a>
<p><tt>#include &lt;<a href="qcanvas-h.html">qcanvas.h</a>&gt;</tt>
<p>Inherits <a href="qcanvaspolygonalitem.html">TQCanvasPolygonalItem</a>.
<p><a href="qcanvasellipse-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li class=fn><a href="#TQCanvasEllipse"><b>TQCanvasEllipse</b></a> ( TQCanvas&nbsp;*&nbsp;canvas )</li>
<li class=fn><a href="#TQCanvasEllipse-2"><b>TQCanvasEllipse</b></a> ( int&nbsp;width, int&nbsp;height, TQCanvas&nbsp;*&nbsp;canvas )</li>
<li class=fn><a href="#TQCanvasEllipse-3"><b>TQCanvasEllipse</b></a> ( int&nbsp;width, int&nbsp;height, int&nbsp;startangle, int&nbsp;angle, TQCanvas&nbsp;*&nbsp;canvas )</li>
<li class=fn><a href="#~TQCanvasEllipse"><b>~TQCanvasEllipse</b></a> ()</li>
<li class=fn>int <a href="#width"><b>width</b></a> () const</li>
<li class=fn>int <a href="#height"><b>height</b></a> () const</li>
<li class=fn>void <a href="#setSize"><b>setSize</b></a> ( int&nbsp;width, int&nbsp;height )</li>
<li class=fn>void <a href="#setAngles"><b>setAngles</b></a> ( int&nbsp;start, int&nbsp;length )</li>
<li class=fn>int <a href="#angleStart"><b>angleStart</b></a> () const</li>
<li class=fn>int <a href="#angleLength"><b>angleLength</b></a> () const</li>
<li class=fn>virtual int <a href="#rtti"><b>rtti</b></a> () const</li>
</ul>
<h2>Protected Members</h2>
<ul>
<li class=fn>virtual void <a href="#drawShape"><b>drawShape</b></a> ( TQPainter&nbsp;&amp;&nbsp;p )</li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
The TQCanvasEllipse class provides an ellipse or ellipse segment on a <a href="qcanvas.html">TQCanvas</a>.
<p>
<p> A canvas item that paints an ellipse or ellipse segment with a <a href="qbrush.html">TQBrush</a>.
The ellipse's height, width, start angle and angle length can be set
at construction time. The size can be changed at runtime with
<a href="#setSize">setSize</a>(), and the angles can be changed (if you're displaying an
ellipse segment rather than a whole ellipse) with <a href="#setAngles">setAngles</a>().
<p> Note that angles are specified in 16ths of a degree.
<p> <a name="anglediagram"></a>
<center><img src="qcanvasellipse.png" alt="Ellipse"></center>
<p> If a start angle and length angle are set then an ellipse segment
will be drawn. The start angle is the angle that goes from zero in a
counter-clockwise direction (shown in green in the diagram). The
length angle is the angle from the start angle in a
counter-clockwise direction (shown in blue in the diagram). The blue
segment is the segment of the ellipse that would be drawn. If no
start angle and length angle are specified the entire ellipse is
drawn.
<p> The ellipse can be drawn on a painter with <a href="#drawShape">drawShape</a>().
<p> Like any other canvas item ellipses can be moved with <a href="qcanvasitem.html#move">move</a>() and
<a href="qcanvasitem.html#moveBy">moveBy</a>(), or by setting coordinates with <a href="qcanvasitem.html#setX">setX</a>(), <a href="qcanvasitem.html#setY">setY</a>() and <a href="qcanvasitem.html#setZ">setZ</a>().
<p> Note: TQCanvasEllipse does not use the pen.
<p>See also <a href="graphics.html">Graphics Classes</a> and <a href="images.html">Image Processing Classes</a>.
<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="TQCanvasEllipse"></a>TQCanvasEllipse::TQCanvasEllipse ( <a href="qcanvas.html">TQCanvas</a>&nbsp;*&nbsp;canvas )
</h3>
Constructs a 32x32 ellipse, centered at (0, 0) on <em>canvas</em>.
<h3 class=fn><a name="TQCanvasEllipse-2"></a>TQCanvasEllipse::TQCanvasEllipse ( int&nbsp;width, int&nbsp;height, <a href="qcanvas.html">TQCanvas</a>&nbsp;*&nbsp;canvas )
</h3>
Constructs a <em>width</em> by <em>height</em> pixel ellipse, centered at
(0, 0) on <em>canvas</em>.
<h3 class=fn><a name="TQCanvasEllipse-3"></a>TQCanvasEllipse::TQCanvasEllipse ( int&nbsp;width, int&nbsp;height, int&nbsp;startangle, int&nbsp;angle, <a href="qcanvas.html">TQCanvas</a>&nbsp;*&nbsp;canvas )
</h3>
Constructs a <em>width</em> by <em>height</em> pixel ellipse, centered at
(0, 0) on <em>canvas</em>. Only a segment of the ellipse is drawn,
starting at angle <em>startangle</em>, and extending for angle <em>angle</em>
(the angle length).
<p> Note that angles are specified in
<small><sup>1</sup>/<sub>16</sub></small>ths of a degree.
<h3 class=fn><a name="~TQCanvasEllipse"></a>TQCanvasEllipse::~TQCanvasEllipse ()
</h3>
Destroys the ellipse.
<h3 class=fn>int <a name="angleLength"></a>TQCanvasEllipse::angleLength () const
</h3>
<p> Returns the length angle (the extent of the ellipse segment) in
16ths of a degree. Initially this will be 360 * 16 (a complete
ellipse).
<p> <p>See also <a href="#setAngles">setAngles</a>() and <a href="#angleStart">angleStart</a>().
<h3 class=fn>int <a name="angleStart"></a>TQCanvasEllipse::angleStart () const
</h3>
<p> Returns the start angle in 16ths of a degree. Initially
this will be 0.
<p> <p>See also <a href="#setAngles">setAngles</a>() and <a href="#angleLength">angleLength</a>().
<h3 class=fn>void <a name="drawShape"></a>TQCanvasEllipse::drawShape ( <a href="qpainter.html">TQPainter</a>&nbsp;&amp;&nbsp;p )<tt> [virtual protected]</tt>
</h3>
Draws the ellipse, centered at <a href="qcanvasitem.html#x">x</a>(), <a href="qcanvasitem.html#y">y</a>() using the painter <em>p</em>.
<p> Note that TQCanvasEllipse does not support an outline (the pen is
always NoPen).
<p>Reimplemented from <a href="qcanvaspolygonalitem.html#drawShape">TQCanvasPolygonalItem</a>.
<h3 class=fn>int <a name="height"></a>TQCanvasEllipse::height () const
</h3>
Returns the height of the ellipse.
<h3 class=fn>int <a name="rtti"></a>TQCanvasEllipse::rtti () const<tt> [virtual]</tt>
</h3>
Returns 6 (TQCanvasItem::Rtti_Ellipse).
<p> <p>See also <a href="qcanvasitem.html#rtti">TQCanvasItem::rtti</a>().
<p>Reimplemented from <a href="qcanvaspolygonalitem.html#rtti">TQCanvasPolygonalItem</a>.
<h3 class=fn>void <a name="setAngles"></a>TQCanvasEllipse::setAngles ( int&nbsp;start, int&nbsp;length )
</h3>
Sets the angles for the ellipse. The start angle is <em>start</em> and
the extent of the segment is <em>length</em> (the angle length) from the
<em>start</em>. The angles are specified in 16ths of a degree. By
default the ellipse will start at 0 and have an angle length of
360 * 16 (a complete ellipse).
<p> <p>See also <a href="#angleStart">angleStart</a>() and <a href="#angleLength">angleLength</a>().
<h3 class=fn>void <a name="setSize"></a>TQCanvasEllipse::setSize ( int&nbsp;width, int&nbsp;height )
</h3>
Sets the <em>width</em> and <em>height</em> of the ellipse.
<h3 class=fn>int <a name="width"></a>TQCanvasEllipse::width () const
</h3>
Returns the width of the ellipse.
<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">TQt toolkit</a>.
Copyright &copy; 1995-2007
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>TQt 3.3.8</div>
</table></div></address></body>
</html>