1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3
<title>Qwt User's Guide: QwtCompass Class Reference</title>
4
<link href="tabs.css" rel="stylesheet" type="text/css">
5
<link href="doxygen.css" rel="stylesheet" type="text/css">
7
<!-- Generated by Doxygen 1.5.8 -->
8
<div class="navigation" id="top">
11
<li><a href="index.html"><span>Main Page</span></a></li>
12
<li><a href="pages.html"><span>Related Pages</span></a></li>
13
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
14
<li><a href="files.html"><span>Files</span></a></li>
19
<li><a href="annotated.html"><span>Class List</span></a></li>
20
<li><a href="classes.html"><span>Class Index</span></a></li>
21
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
22
<li><a href="functions.html"><span>Class Members</span></a></li>
26
<div class="contents">
27
<h1>QwtCompass Class Reference</h1><!-- doxytag: class="QwtCompass" --><!-- doxytag: inherits="QwtDial" -->A Compass Widget.
28
<a href="#_details">More...</a>
30
<code>#include <<a class="el" href="qwt__compass_8h-source.html">qwt_compass.h</a>></code>
32
<div class="dynheader">
33
Inheritance diagram for QwtCompass:</div>
34
<div class="dynsection">
35
<p><center><img src="class_qwt_compass__inherit__graph.png" border="0" usemap="#_qwt_compass__inherit__map" alt="Inheritance graph"></center>
36
<map name="_qwt_compass__inherit__map">
37
<area shape="rect" href="class_qwt_dial.html" title="QwtDial class provides a rounded range control." alt="" coords="36,157,105,181"><area shape="rect" href="class_qwt_abstract_slider.html" title="An abstract base class for slider widgets." alt="" coords="7,83,135,107"><area shape="rect" href="class_qwt_double_range.html" title="A class which controls a value within an interval." alt="" coords="8,8,133,32"></map>
38
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
41
<a href="class_qwt_compass-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
43
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
44
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_compass.html#05357e2950a3dc534e68e3c21f6c6b94">QwtCompass</a> (QWidget *parent=NULL)</td></tr>
46
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_compass.html#f6cc3b946f3761f7ce53d3a2ec000817">~QwtCompass</a> ()</td></tr>
48
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_compass.html#06456c0c52107bfa8b1d1267fba5b86f">setRose</a> (<a class="el" href="class_qwt_compass_rose.html">QwtCompassRose</a> *rose)</td></tr>
50
<tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="class_qwt_compass_rose.html">QwtCompassRose</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_compass.html#7405a44d947e16f53b11dea4544d7683">rose</a> () const </td></tr>
52
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="class_qwt_compass_rose.html">QwtCompassRose</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_compass.html#99477d676bd866acd1a418615cba423b">rose</a> ()</td></tr>
54
<tr><td class="memItemLeft" nowrap align="right" valign="top">const QMap< double, QString > & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_compass.html#ccc25cd9b9b23769711b7f04f9a4c464">labelMap</a> () const </td></tr>
56
<tr><td class="memItemLeft" nowrap align="right" valign="top">QMap< double, QString > & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_compass.html#39b3cfa870ef0172b49d54fa2559a875">labelMap</a> ()</td></tr>
58
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_compass.html#b0f2460851db3d5b7169fe0991fdb945">setLabelMap</a> (const QMap< double, QString > &map)</td></tr>
60
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
61
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="class_qwt_text.html">QwtText</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_compass.html#091c7ac5792d87e20bfc7efce9eeeb16">scaleLabel</a> (double value) const </td></tr>
63
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_compass.html#f97ae99ae987472ee89deff90c1bf6d4">drawRose</a> (QPainter *, const QPoint &center, int radius, double north, QPalette::ColorGroup) const </td></tr>
65
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_compass.html#375701893fa3c0aeadaf23dd316fe69f">drawScaleContents</a> (QPainter *, const QPoint &center, int radius) const </td></tr>
67
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_compass.html#d4f31e6837ea045834fe67d192a4209d">keyPressEvent</a> (QKeyEvent *)</td></tr>
70
<hr><a name="_details"></a><h2>Detailed Description</h2>
73
<a class="el" href="class_qwt_compass.html" title="A Compass Widget.">QwtCompass</a> is a widget to display and enter directions. It consists of a scale, an optional needle and rose.<p>
75
<img src="dials1.png" alt="dials1.png">
78
<dl class="note" compact><dt><b>Note:</b></dt><dd>The examples/dials example shows how to use <a class="el" href="class_qwt_compass.html" title="A Compass Widget.">QwtCompass</a>. </dd></dl>
79
<hr><h2>Constructor & Destructor Documentation</h2>
80
<a class="anchor" name="05357e2950a3dc534e68e3c21f6c6b94"></a><!-- doxytag: member="QwtCompass::QwtCompass" ref="05357e2950a3dc534e68e3c21f6c6b94" args="(QWidget *parent=NULL)" -->
82
<div class="memproto">
83
<table class="memname">
85
<td class="memname">QwtCompass::QwtCompass </td>
87
<td class="paramtype">QWidget * </td>
88
<td class="paramname"> <em>parent</em> = <code>NULL</code> </td>
89
<td> ) </td>
90
<td><code> [explicit]</code></td>
99
<dl compact><dt><b>Parameters:</b></dt><dd>
100
<table border="0" cellspacing="2" cellpadding="0">
101
<tr><td valign="top"></td><td valign="top"><em>parent</em> </td><td>Parent widget</td></tr>
104
Create a compass widget with a scale, no needle and no rose. The default origin is 270.0 with no valid value. It accepts mouse and keyboard inputs and has no step size. The default mode is QwtDial::RotateNeedle.
107
<a class="anchor" name="f6cc3b946f3761f7ce53d3a2ec000817"></a><!-- doxytag: member="QwtCompass::~QwtCompass" ref="f6cc3b946f3761f7ce53d3a2ec000817" args="()" -->
108
<div class="memitem">
109
<div class="memproto">
110
<table class="memname">
112
<td class="memname">QwtCompass::~QwtCompass </td>
114
<td class="paramname"> </td>
115
<td> ) </td>
116
<td><code> [virtual]</code></td>
128
<hr><h2>Member Function Documentation</h2>
129
<a class="anchor" name="f97ae99ae987472ee89deff90c1bf6d4"></a><!-- doxytag: member="QwtCompass::drawRose" ref="f97ae99ae987472ee89deff90c1bf6d4" args="(QPainter *, const QPoint &center, int radius, double north, QPalette::ColorGroup) const " -->
130
<div class="memitem">
131
<div class="memproto">
132
<table class="memname">
134
<td class="memname">void QwtCompass::drawRose </td>
136
<td class="paramtype">QPainter * </td>
137
<td class="paramname"> <em>painter</em>, </td>
140
<td class="paramkey"></td>
142
<td class="paramtype">const QPoint & </td>
143
<td class="paramname"> <em>center</em>, </td>
146
<td class="paramkey"></td>
148
<td class="paramtype">int </td>
149
<td class="paramname"> <em>radius</em>, </td>
152
<td class="paramkey"></td>
154
<td class="paramtype">double </td>
155
<td class="paramname"> <em>north</em>, </td>
158
<td class="paramkey"></td>
160
<td class="paramtype">QPalette::ColorGroup </td>
161
<td class="paramname"> <em>cg</em></td><td> </td>
166
<td></td><td></td><td> const<code> [protected, virtual]</code></td>
173
Draw the compass rose<p>
174
<dl compact><dt><b>Parameters:</b></dt><dd>
175
<table border="0" cellspacing="2" cellpadding="0">
176
<tr><td valign="top"></td><td valign="top"><em>painter</em> </td><td>Painter </td></tr>
177
<tr><td valign="top"></td><td valign="top"><em>center</em> </td><td>Center of the compass </td></tr>
178
<tr><td valign="top"></td><td valign="top"><em>radius</em> </td><td>of the circle, where to paint the rose </td></tr>
179
<tr><td valign="top"></td><td valign="top"><em>north</em> </td><td>Direction pointing north, in degrees counter clockwise </td></tr>
180
<tr><td valign="top"></td><td valign="top"><em>cg</em> </td><td>Color group </td></tr>
186
<a class="anchor" name="375701893fa3c0aeadaf23dd316fe69f"></a><!-- doxytag: member="QwtCompass::drawScaleContents" ref="375701893fa3c0aeadaf23dd316fe69f" args="(QPainter *, const QPoint &center, int radius) const " -->
187
<div class="memitem">
188
<div class="memproto">
189
<table class="memname">
191
<td class="memname">void QwtCompass::drawScaleContents </td>
193
<td class="paramtype">QPainter * </td>
194
<td class="paramname"> <em>painter</em>, </td>
197
<td class="paramkey"></td>
199
<td class="paramtype">const QPoint & </td>
200
<td class="paramname"> <em>center</em>, </td>
203
<td class="paramkey"></td>
205
<td class="paramtype">int </td>
206
<td class="paramname"> <em>radius</em></td><td> </td>
211
<td></td><td></td><td> const<code> [protected, virtual]</code></td>
218
Draw the contents of the scale<p>
219
<dl compact><dt><b>Parameters:</b></dt><dd>
220
<table border="0" cellspacing="2" cellpadding="0">
221
<tr><td valign="top"></td><td valign="top"><em>painter</em> </td><td>Painter </td></tr>
222
<tr><td valign="top"></td><td valign="top"><em>center</em> </td><td>Center of the content circle </td></tr>
223
<tr><td valign="top"></td><td valign="top"><em>radius</em> </td><td>Radius of the content circle </td></tr>
227
<p>Reimplemented from <a class="el" href="class_qwt_dial.html#25ef28fbf217e510b60f2b01c14a1fc9">QwtDial</a>.</p>
231
<a class="anchor" name="d4f31e6837ea045834fe67d192a4209d"></a><!-- doxytag: member="QwtCompass::keyPressEvent" ref="d4f31e6837ea045834fe67d192a4209d" args="(QKeyEvent *)" -->
232
<div class="memitem">
233
<div class="memproto">
234
<table class="memname">
236
<td class="memname">void QwtCompass::keyPressEvent </td>
238
<td class="paramtype">QKeyEvent * </td>
239
<td class="paramname"> <em>kev</em> </td>
240
<td> ) </td>
241
<td><code> [protected, virtual]</code></td>
248
Handles key events<p>
249
Beside the keys described in <a class="el" href="class_qwt_dial.html#61a2341a76abc20ea5bd72a0485be136">QwtDial::keyPressEvent</a> numbers from 1-9 (without 5) set the direction according to their position on the num pad.<p>
250
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="class_qwt_abstract_slider.html#040fd1fd03592c524314bf4b5539608d">isReadOnly()</a> </dd></dl>
252
<p>Reimplemented from <a class="el" href="class_qwt_dial.html#61a2341a76abc20ea5bd72a0485be136">QwtDial</a>.</p>
256
<a class="anchor" name="39b3cfa870ef0172b49d54fa2559a875"></a><!-- doxytag: member="QwtCompass::labelMap" ref="39b3cfa870ef0172b49d54fa2559a875" args="()" -->
257
<div class="memitem">
258
<div class="memproto">
259
<table class="memname">
261
<td class="memname">QMap< double, QString > & QwtCompass::labelMap </td>
263
<td class="paramname"> </td>
264
<td> ) </td>
272
<dl class="return" compact><dt><b>Returns:</b></dt><dd>map, mapping values to labels </dd></dl>
273
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="class_qwt_compass.html#b0f2460851db3d5b7169fe0991fdb945" title="Set a map, mapping values to labels.">setLabelMap()</a> </dd></dl>
277
<a class="anchor" name="ccc25cd9b9b23769711b7f04f9a4c464"></a><!-- doxytag: member="QwtCompass::labelMap" ref="ccc25cd9b9b23769711b7f04f9a4c464" args="() const " -->
278
<div class="memitem">
279
<div class="memproto">
280
<table class="memname">
282
<td class="memname">const QMap< double, QString > & QwtCompass::labelMap </td>
284
<td class="paramname"> </td>
285
<td> ) </td>
293
<dl class="return" compact><dt><b>Returns:</b></dt><dd>map, mapping values to labels </dd></dl>
294
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="class_qwt_compass.html#b0f2460851db3d5b7169fe0991fdb945" title="Set a map, mapping values to labels.">setLabelMap()</a> </dd></dl>
298
<a class="anchor" name="99477d676bd866acd1a418615cba423b"></a><!-- doxytag: member="QwtCompass::rose" ref="99477d676bd866acd1a418615cba423b" args="()" -->
299
<div class="memitem">
300
<div class="memproto">
301
<table class="memname">
303
<td class="memname"><a class="el" href="class_qwt_compass_rose.html">QwtCompassRose</a> * QwtCompass::rose </td>
305
<td class="paramname"> </td>
306
<td> ) </td>
314
<dl class="return" compact><dt><b>Returns:</b></dt><dd>rose </dd></dl>
315
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="class_qwt_compass.html#06456c0c52107bfa8b1d1267fba5b86f">setRose()</a> </dd></dl>
319
<a class="anchor" name="7405a44d947e16f53b11dea4544d7683"></a><!-- doxytag: member="QwtCompass::rose" ref="7405a44d947e16f53b11dea4544d7683" args="() const " -->
320
<div class="memitem">
321
<div class="memproto">
322
<table class="memname">
324
<td class="memname">const <a class="el" href="class_qwt_compass_rose.html">QwtCompassRose</a> * QwtCompass::rose </td>
326
<td class="paramname"> </td>
327
<td> ) </td>
335
<dl class="return" compact><dt><b>Returns:</b></dt><dd>rose </dd></dl>
336
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="class_qwt_compass.html#06456c0c52107bfa8b1d1267fba5b86f">setRose()</a> </dd></dl>
340
<a class="anchor" name="091c7ac5792d87e20bfc7efce9eeeb16"></a><!-- doxytag: member="QwtCompass::scaleLabel" ref="091c7ac5792d87e20bfc7efce9eeeb16" args="(double value) const " -->
341
<div class="memitem">
342
<div class="memproto">
343
<table class="memname">
345
<td class="memname"><a class="el" href="class_qwt_text.html">QwtText</a> QwtCompass::scaleLabel </td>
347
<td class="paramtype">double </td>
348
<td class="paramname"> <em>value</em> </td>
349
<td> ) </td>
350
<td> const<code> [protected, virtual]</code></td>
357
Map a value to a corresponding label <dl compact><dt><b>Parameters:</b></dt><dd>
358
<table border="0" cellspacing="2" cellpadding="0">
359
<tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>Value that will be mapped </td></tr>
362
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Label, or QString::null</dd></dl>
363
label() looks in a map for a corresponding label for value or return an null text. <dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="class_qwt_compass.html#39b3cfa870ef0172b49d54fa2559a875">labelMap()</a>, <a class="el" href="class_qwt_compass.html#b0f2460851db3d5b7169fe0991fdb945" title="Set a map, mapping values to labels.">setLabelMap()</a> </dd></dl>
365
<p>Reimplemented from <a class="el" href="class_qwt_dial.html#b91f5aa6c54349d735fe22acd4f5a2e1">QwtDial</a>.</p>
369
<a class="anchor" name="b0f2460851db3d5b7169fe0991fdb945"></a><!-- doxytag: member="QwtCompass::setLabelMap" ref="b0f2460851db3d5b7169fe0991fdb945" args="(const QMap< double, QString > &map)" -->
370
<div class="memitem">
371
<div class="memproto">
372
<table class="memname">
374
<td class="memname">void QwtCompass::setLabelMap </td>
376
<td class="paramtype">const QMap< double, QString > & </td>
377
<td class="paramname"> <em>map</em> </td>
378
<td> ) </td>
386
Set a map, mapping values to labels.
388
<dl compact><dt><b>Parameters:</b></dt><dd>
389
<table border="0" cellspacing="2" cellpadding="0">
390
<tr><td valign="top"></td><td valign="top"><em>map</em> </td><td>value to label map</td></tr>
393
The values of the major ticks are found by looking into this map. The default map consists of the labels N, NE, E, SE, S, SW, W, NW.<p>
394
<dl class="warning" compact><dt><b>Warning:</b></dt><dd>The map will have no effect for values that are no major tick values. Major ticks can be changed by QwtScaleDraw::setScale</dd></dl>
395
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="class_qwt_compass.html#39b3cfa870ef0172b49d54fa2559a875">labelMap()</a>, <a class="el" href="class_qwt_dial.html#4e51987ef0800ddbd36a0923535a2cdd" title="Return the scale draw.">scaleDraw()</a>, <a class="el" href="class_qwt_dial.html#ec2d13245d2120c0b4b2d6ae1f52cf4f">setScale()</a> </dd></dl>
399
<a class="anchor" name="06456c0c52107bfa8b1d1267fba5b86f"></a><!-- doxytag: member="QwtCompass::setRose" ref="06456c0c52107bfa8b1d1267fba5b86f" args="(QwtCompassRose *rose)" -->
400
<div class="memitem">
401
<div class="memproto">
402
<table class="memname">
404
<td class="memname">void QwtCompass::setRose </td>
406
<td class="paramtype"><a class="el" href="class_qwt_compass_rose.html">QwtCompassRose</a> * </td>
407
<td class="paramname"> <em>rose</em> </td>
408
<td> ) </td>
416
Set a rose for the compass <dl compact><dt><b>Parameters:</b></dt><dd>
417
<table border="0" cellspacing="2" cellpadding="0">
418
<tr><td valign="top"></td><td valign="top"><em>rose</em> </td><td>Compass rose </td></tr>
421
<dl class="warning" compact><dt><b>Warning:</b></dt><dd>The rose will be deleted, when a different rose is set or in ~QwtCompass </dd></dl>
422
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="class_qwt_compass.html#99477d676bd866acd1a418615cba423b">rose()</a> </dd></dl>
427
<hr size="1"><address style="text-align: right;"><small>Generated on Sun Mar 22 16:41:19 2009 for Qwt User's Guide by
428
<a href="http://www.doxygen.org/index.html">
429
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>