summaryrefslogtreecommitdiffstats
path: root/doc/html/tutorial1-05.html
blob: 8aabed7083d64daf857138c97f85f7caad26aef5 (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
<!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/doc/tutorial.doc:487 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>TQt Tutorial - Chapter 5: Building Blocks</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>TQt Tutorial - Chapter 5: Building Blocks</h1>

 
<p> <center><img src="t5.png" alt="Screenshot of tutorial five"></center> 
<p> This example shows how to create and connect together several widgets
by using signals and slots, and how to handle resize events.
<p> <pre>/****************************************************************
**
** TQt tutorial 5
**
****************************************************************/

#include &lt;<a href="qapplication-h.html">qapplication.h</a>&gt;
#include &lt;<a href="qpushbutton-h.html">qpushbutton.h</a>&gt;
#include &lt;<a href="qslider-h.html">qslider.h</a>&gt;
#include &lt;<a href="qlcdnumber-h.html">qlcdnumber.h</a>&gt;
#include &lt;<a href="qfont-h.html">qfont.h</a>&gt;

#include &lt;<a href="qvbox-h.html">qvbox.h</a>&gt;

class MyWidget : public <a href="qvbox.html">TQVBox</a>
{
public:
    MyWidget( <a href="qwidget.html">TQWidget</a> *parent=0, const char *name=0 );
};


<a name="f553"></a>MyWidget::MyWidget( <a href="qwidget.html">TQWidget</a> *parent, const char *name )
        : <a href="qvbox.html">TQVBox</a>( parent, name )
{
    <a href="qpushbutton.html">TQPushButton</a> *tquit = new <a href="qpushbutton.html">TQPushButton</a>( "Quit", this, "tquit" );
    tquit-&gt;<a href="qwidget.html#setFont">setFont</a>( TQFont( "Times", 18, TQFont::Bold ) );

    <a href="qobject.html#connect">connect</a>( tquit, SIGNAL(<a href="qbutton.html#clicked">clicked</a>()), qApp, SLOT(<a href="qapplication.html#tquit">tquit</a>()) );

    <a href="qlcdnumber.html">TQLCDNumber</a> *lcd  = new <a href="qlcdnumber.html">TQLCDNumber</a>( 2, this, "lcd" );

    <a href="qslider.html">TQSlider</a> * slider = new <a href="qslider.html">TQSlider</a>( Horizontal, this, "slider" );
    slider-&gt;<a href="qrangecontrol.html#setRange">setRange</a>( 0, 99 );
    slider-&gt;<a href="qslider.html#setValue">setValue</a>( 0 );

    <a href="qobject.html#connect">connect</a>( slider, SIGNAL(<a href="qslider.html#valueChanged">valueChanged</a>(int)), lcd, SLOT(<a href="qlcdnumber.html#display">display</a>(int)) );
}

int main( int argc, char **argv )
{
    <a href="qapplication.html">TQApplication</a> a( argc, argv );

    MyWidget w;
    a.<a href="qapplication.html#setMainWidget">setMainWidget</a>( &amp;w );
    w.<a href="qwidget.html#show">show</a>();
    return a.<a href="qapplication.html#exec">exec</a>();
}
</pre>



<p> <h2> Line-by-line Walkthrough
</h2>
<a name="1"></a><p> <pre>    #include &lt;<a href="qapplication-h.html">qapplication.h</a>&gt;
    #include &lt;<a href="qpushbutton-h.html">qpushbutton.h</a>&gt;
    #include &lt;<a href="qslider-h.html">qslider.h</a>&gt;
    #include &lt;<a href="qlcdnumber-h.html">qlcdnumber.h</a>&gt;
    #include &lt;<a href="qfont-h.html">qfont.h</a>&gt;

    #include &lt;<a href="qvbox-h.html">qvbox.h</a>&gt;
</pre>
<p> Three new include files are shown here. qslider.h and qlcdnumber.h are there
because we use two new widgets, <a href="qslider.html">TQSlider</a> and <a href="qlcdnumber.html">TQLCDNumber</a>. qvbox.h is
here because we use TQt's automatic layout support.
<p> <pre>    class MyWidget : public <a href="qvbox.html">TQVBox</a>
    {
    public:
        MyWidget( <a href="qwidget.html">TQWidget</a> *parent=0, const char *name=0 );
    };
</pre>
<p> <a name="constructor"></a>
<pre>    MyWidget::MyWidget( <a href="qwidget.html">TQWidget</a> *parent, const char *name )
            : <a href="qvbox.html">TQVBox</a>( parent, name )
    {
</pre>
<p> MyWidget is now derived from <a href="qvbox.html">TQVBox</a> instead of <a href="qwidget.html">TQWidget</a>. That way we use
the layout of the TQVBox (which places all of its children vertically
inside itself). Resizes are now handled automatically by the TQVBox and
therefore by MyWidget, too.
<p> <pre>        <a href="qlcdnumber.html">TQLCDNumber</a> *lcd  = new <a href="qlcdnumber.html">TQLCDNumber</a>( 2, this, "lcd" );
</pre>
<p> <tt>lcd</tt> is a TQLCDNumber, a widget that displays numbers in an LCD-like
fashion. This instance is set up to display two digits and to be a child of
<em>this</em>. It is named "lcd".
<p> <pre>        <a href="qslider.html">TQSlider</a> * slider = new <a href="qslider.html">TQSlider</a>( Horizontal, this, "slider" );
    <a name="x2315"></a>    slider-&gt;<a href="qrangecontrol.html#setRange">setRange</a>( 0, 99 );
    <a name="x2316"></a>    slider-&gt;<a href="qslider.html#setValue">setValue</a>( 0 );
</pre>
<p> <a href="qslider.html">TQSlider</a> is a classical slider; the user can use the widget to drag
something to adjust an integer value in a range. Here we create a
horizontal one, set its range to 0-99 (inclusive, see the <a href="qrangecontrol.html#setRange">TQSlider::setRange</a>() documentation) and its initial value to 0.
<p> <pre>    <a name="x2317"></a><a name="x2314"></a>    <a href="qobject.html#connect">connect</a>( slider, SIGNAL(<a href="qslider.html#valueChanged">valueChanged</a>(int)), lcd, SLOT(<a href="qlcdnumber.html#display">display</a>(int)) );
</pre>
<p> Here we use the <a href="signalsandslots.html">signal/slot mechanism</a>
to connect the slider's valueChanged() signal to the LCD number's
display() slot.
<p> Whenever the slider's value changes it broadcasts the new value by
emitting the valueChanged() signal. Because that signal is connected to
the LCD number's display() slot, the slot is called when the signal is
broadcast. Neither of the objects knows about the other. This is
essential in component programming.
<p> Slots are otherwise normal C++ member functions and follow the normal
C++ access rules.
<p> <h2> Behavior
</h2>
<a name="2"></a><p> The LCD number reflects everything you do to the slider, and the
widget handles resizing well. Notice that the LCD number widget
changes in size when the window is resized (because it can), but the
others stay about the same (because otherwise they would look stupid).
<p> (See <a href="tutorial1-01.html#compiling">Compiling</a> for how to create a
makefile and build the application.)
<p> <h2> Exercises
</h2>
<a name="3"></a><p> Try changing the LCD number to add more digits or <a href="qlcdnumber.html#setMode">to change mode.</a> You can even add four push
buttons to set the number base.
<p> You can also change the slider's range.
<p> Perhaps it would have been better to use <a href="qspinbox.html">TQSpinBox</a> than a slider?
<p> Try to make the application tquit when the LCD number overflows.
<p> You're now ready for <a href="tutorial1-06.html">Chapter 6.</a>
<p> [<a href="tutorial1-04.html">Previous tutorial</a>]
[<a href="tutorial1-06.html">Next tutorial</a>]
[<a href="tutorial.html">Main tutorial page</a>]
<p> 
<!-- eof -->
<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>