summaryrefslogtreecommitdiffstats
path: root/doc/html/qcanvasellipse.html
blob: b809cf5b0f597f5fb11ff50933ffea00dcbd31f7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
<!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>QCanvasEllipse 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>QCanvasEllipse Class Reference<br><small>[<a href="canvas.html">canvas module</a>]</small></h1>

<p>The QCanvasEllipse class provides an ellipse or ellipse segment on a QCanvas.
<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">QCanvasPolygonalItem</a>.
<p><a href="qcanvasellipse-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li class=fn><a href="#QCanvasEllipse"><b>QCanvasEllipse</b></a> ( QCanvas&nbsp;*&nbsp;canvas )</li>
<li class=fn><a href="#QCanvasEllipse-2"><b>QCanvasEllipse</b></a> ( int&nbsp;width, int&nbsp;height, QCanvas&nbsp;*&nbsp;canvas )</li>
<li class=fn><a href="#QCanvasEllipse-3"><b>QCanvasEllipse</b></a> ( int&nbsp;width, int&nbsp;height, int&nbsp;startangle, int&nbsp;angle, QCanvas&nbsp;*&nbsp;canvas )</li>
<li class=fn><a href="#~QCanvasEllipse"><b>~QCanvasEllipse</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> ( QPainter&nbsp;&amp;&nbsp;p )</li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>


The QCanvasEllipse class provides an ellipse or ellipse segment on a <a href="qcanvas.html">QCanvas</a>.

<p> 


<p> A canvas item that paints an ellipse or ellipse segment with a <a href="qbrush.html">QBrush</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: QCanvasEllipse 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="QCanvasEllipse"></a>QCanvasEllipse::QCanvasEllipse ( <a href="qcanvas.html">QCanvas</a>&nbsp;*&nbsp;canvas )
</h3>
Constructs a 32x32 ellipse, centered at (0, 0) on <em>canvas</em>.

<h3 class=fn><a name="QCanvasEllipse-2"></a>QCanvasEllipse::QCanvasEllipse ( int&nbsp;width, int&nbsp;height, <a href="qcanvas.html">QCanvas</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="QCanvasEllipse-3"></a>QCanvasEllipse::QCanvasEllipse ( int&nbsp;width, int&nbsp;height, int&nbsp;startangle, int&nbsp;angle, <a href="qcanvas.html">QCanvas</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="~QCanvasEllipse"></a>QCanvasEllipse::~QCanvasEllipse ()
</h3>
Destroys the ellipse.

<h3 class=fn>int <a name="angleLength"></a>QCanvasEllipse::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>QCanvasEllipse::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>QCanvasEllipse::drawShape ( <a href="qpainter.html">QPainter</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 QCanvasEllipse does not support an outline (the pen is
always NoPen).

<p>Reimplemented from <a href="qcanvaspolygonalitem.html#drawShape">QCanvasPolygonalItem</a>.
<h3 class=fn>int <a name="height"></a>QCanvasEllipse::height () const
</h3>
Returns the height of the ellipse.

<h3 class=fn>int <a name="rtti"></a>QCanvasEllipse::rtti () const<tt> [virtual]</tt>
</h3>
Returns 6 (QCanvasItem::Rtti_Ellipse).
<p> <p>See also <a href="qcanvasitem.html#rtti">QCanvasItem::rtti</a>().

<p>Reimplemented from <a href="qcanvaspolygonalitem.html#rtti">QCanvasPolygonalItem</a>.
<h3 class=fn>void <a name="setAngles"></a>QCanvasEllipse::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>QCanvasEllipse::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>QCanvasEllipse::width () const
</h3>
Returns the width of the ellipse.

<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">Qt 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>Qt 3.3.8</div>
</table></div></address></body>
</html>