summaryrefslogtreecommitdiffstats
path: root/doc/html/tutorial1-04.html
blob: 005aa983cb08ad5ef4bd12c3d09918502ac3ba99 (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
170
171
172
173
174
175
176
177
178
179
180
181
182
<!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:378 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>TQt Tutorial - Chapter 4: Let There Be Widgets</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 4: Let There Be Widgets</h1>

 
<p> <center><img src="t4.png" alt="Screenshot of tutorial four"></center> 
<p> This example shows how to create your own widget, describes how to control the
minimum and maximum sizes of a widget, and introduces widget names.
<p> <pre>/****************************************************************
**
** TQt tutorial 4
**
****************************************************************/

#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="qfont-h.html">qfont.h</a>&gt;


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


<a name="f552"></a>MyWidget::MyWidget( <a href="qwidget.html">TQWidget</a> *parent, const char *name )
        : <a href="qwidget.html">TQWidget</a>( parent, name )
{
    <a href="qwidget.html#setMinimumSize">setMinimumSize</a>( 200, 120 );
    <a href="qwidget.html#setMaximumSize">setMaximumSize</a>( 200, 120 );

    <a href="qpushbutton.html">TQPushButton</a> *tquit = new <a href="qpushbutton.html">TQPushButton</a>( "Quit", this, "tquit" );
    tquit-&gt;<a href="qwidget.html#setGeometry">setGeometry</a>( 62, 40, 75, 30 );
    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>()) );
}


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

    MyWidget w;
    w.<a href="qwidget.html#setGeometry">setGeometry</a>( 100, 100, 200, 120 );
    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>    class MyWidget : public <a href="qwidget.html">TQWidget</a>
    {
    public:
        MyWidget( <a href="qwidget.html">TQWidget</a> *parent=0, const char *name=0 );
    };
</pre>
<p> Here we create a new class. Because this class inherits from <a href="qwidget.html">TQWidget</a>,
the new class is a widget and may be a top level window or a child
widget (like the push button in Chapter 3).
<p> This class has only one member, a constructor (in addition to the
members it inherits from TQWidget). The constructor is a standard TQt
widget constructor; you should always include a similar constructor
when you create widgets.
<p> The first argument is its parent widget. To create a top-level window
you specify a null pointer as the parent. As you can see, this widget
defaults to be a top-level window.
<p> The second argument is the widget's name. This is <em>not</em> the text
that appears in the window's title bar or in the button. It is a name
associated with a widget to make it possible to <a href="qobject.html#queryList">look up</a> this widget later, and there is
also a <a href="qobject.html#dumpObjectTree">handy debugging function</a> that will list a complete widget hierarchy.
<p> <pre>    MyWidget::MyWidget( <a href="qwidget.html">TQWidget</a> *parent, const char *name )
            : <a href="qwidget.html">TQWidget</a>( parent, name )
</pre>
<p> The implementation of the constructor starts here. Like most widgets,
it just passes on the <tt>parent</tt> and <tt>name</tt> to the <a href="qwidget.html">TQWidget</a>
constructor.
<p> <pre>    {
        <a href="qwidget.html#setMinimumSize">setMinimumSize</a>( 200, 120 );
        <a href="qwidget.html#setMaximumSize">setMaximumSize</a>( 200, 120 );
</pre>
<p> Because this widget doesn't know how to handle resizing, we fix its size
by setting the minimum and maximum to be equal. In the next chapter
we will show how a widget can respond to resize event from the user.
<p> <pre>        <a href="qpushbutton.html">TQPushButton</a> *tquit = new <a href="qpushbutton.html">TQPushButton</a>( "Quit", this, "tquit" );
    <a name="x2308"></a>    tquit-&gt;<a href="qwidget.html#setGeometry">setGeometry</a>( 62, 40, 75, 30 );
    <a name="x2307"></a>    tquit-&gt;<a href="qwidget.html#setFont">setFont</a>( TQFont( "Times", 18, TQFont::Bold ) );
</pre>
<p> Here we create and set up a child widget of this widget (the new widget's
parent is <tt>this</tt>) which has the widget name "tquit". The widget
name has nothing to do with the button text; it just happens to be
similar in this case.
<p> Note that <tt>tquit</tt> is a local variable in the constructor. MyWidget
does not keep track of it, but TQt does, and will by default delete it
when MyWidget is deleted. This is why MyWidget doesn't need a
destructor. (On the other hand, there is no harm in deleting a child
when you choose to, the child will automatically tell TQt about its
imminent death.)
<p> The setGeometry() call does the same as move() and resize() did in the
previous chapters.
<p> <pre>    <a name="x2306"></a><a name="x2304"></a>    <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>()) );
    }
</pre>
<p> Because the MyWidget class doesn't know about the application object, it
has to connect to TQt's pointer to it, <tt>qApp</tt>.
<p> A widget is a software component and should know as little as possible
about its environment in order to be as general and reusable as
possible.
<p> Knowing the name of the application object would break this principle,
so TQt offers an alias, qApp, for the cases in which a component such as
MyWidget needs to talk to the application object.
<p> <pre>    int main( int argc, char **argv )
    {
        <a href="qapplication.html">TQApplication</a> a( argc, argv );

        MyWidget w;
        w.<a href="qwidget.html#setGeometry">setGeometry</a>( 100, 100, 200, 120 );
    <a name="x2305"></a>    a.<a href="qapplication.html#setMainWidget">setMainWidget</a>( &amp;w );
    <a name="x2309"></a>    w.<a href="qwidget.html#show">show</a>();
    <a name="x2303"></a>    return a.<a href="qapplication.html#exec">exec</a>();
    }
</pre>
<p> Here we instantiate our new child, set it to be the main widget, and
execute the application.
<p> <h2> Behavior
</h2>
<a name="2"></a><p> This program is very similar in behavior to the previous one. The
difference lies in the way we have implemented it. It does behave
slightly differently, however. Just try to resize it to see.
<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 to create another MyWidget object in main(). What happens?
<p> Try to add more buttons or put in widgets other than <a href="qpushbutton.html">TQPushButton</a>.
<p> You're now ready for <a href="tutorial1-05.html">Chapter 5.</a>
<p> [<a href="tutorial1-03.html">Previous tutorial</a>]
[<a href="tutorial1-05.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>