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/tutorial1-06.html

189 lines
8.5 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/doc/tutorial.doc:580 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>TQt Tutorial - Chapter 6: Building Blocks Galore!</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 6: Building Blocks Galore!</h1>
<p> <center><img src="t6.png" alt="Screenshot of tutorial six"></center>
<p> This example shows how to encapsulate two widgets into a new component and
how easy it is to use many widgets. For the first time, we use a custom
widget as a child widget.
<p> <a name="main"></a>
<pre>/****************************************************************
**
** TQt tutorial 6
**
****************************************************************/
#include &lt;<a href="qapplication-h.html">ntqapplication.h</a>&gt;
#include &lt;<a href="qpushbutton-h.html">ntqpushbutton.h</a>&gt;
#include &lt;<a href="qslider-h.html">ntqslider.h</a>&gt;
#include &lt;<a href="qlcdnumber-h.html">ntqlcdnumber.h</a>&gt;
#include &lt;<a href="qfont-h.html">ntqfont.h</a>&gt;
#include &lt;<a href="qvbox-h.html">ntqvbox.h</a>&gt;
#include &lt;<a href="qgrid-h.html">ntqgrid.h</a>&gt;
class LCDRange : public <a href="ntqvbox.html">TQVBox</a>
{
public:
LCDRange( <a href="ntqwidget.html">TQWidget</a> *parent=0, const char *name=0 );
};
<a name="f554"></a>LCDRange::LCDRange( <a href="ntqwidget.html">TQWidget</a> *parent, const char *name )
: <a href="ntqvbox.html">TQVBox</a>( parent, name )
{
<a href="ntqlcdnumber.html">TQLCDNumber</a> *lcd = new <a href="ntqlcdnumber.html">TQLCDNumber</a>( 2, this, "lcd" );
<a href="ntqslider.html">TQSlider</a> * slider = new <a href="ntqslider.html">TQSlider</a>( Horizontal, this, "slider" );
slider-&gt;<a href="ntqrangecontrol.html#setRange">setRange</a>( 0, 99 );
slider-&gt;<a href="ntqslider.html#setValue">setValue</a>( 0 );
<a href="ntqobject.html#connect">connect</a>( slider, TQ_SIGNAL(<a href="ntqslider.html#valueChanged">valueChanged</a>(int)), lcd, TQ_SLOT(<a href="ntqlcdnumber.html#display">display</a>(int)) );
}
class MyWidget : public <a href="ntqvbox.html">TQVBox</a>
{
public:
MyWidget( <a href="ntqwidget.html">TQWidget</a> *parent=0, const char *name=0 );
};
<a name="f555"></a>MyWidget::MyWidget( <a href="ntqwidget.html">TQWidget</a> *parent, const char *name )
: <a href="ntqvbox.html">TQVBox</a>( parent, name )
{
<a href="ntqpushbutton.html">TQPushButton</a> *quit = new <a href="ntqpushbutton.html">TQPushButton</a>( "Quit", this, "quit" );
quit-&gt;<a href="ntqwidget.html#setFont">setFont</a>( TQFont( "Times", 18, TQFont::Bold ) );
<a href="ntqobject.html#connect">connect</a>( quit, TQ_SIGNAL(<a href="ntqbutton.html#clicked">clicked</a>()), tqApp, TQ_SLOT(<a href="ntqapplication.html#quit">quit</a>()) );
<a href="ntqgrid.html">TQGrid</a> *grid = new <a href="ntqgrid.html">TQGrid</a>( 4, this );
for( int r = 0 ; r &lt; 4 ; r++ )
for( int c = 0 ; c &lt; 4 ; c++ )
(void)new LCDRange( grid );
}
int main( int argc, char **argv )
{
<a href="ntqapplication.html">TQApplication</a> a( argc, argv );
MyWidget w;
a.<a href="ntqapplication.html#setMainWidget">setMainWidget</a>( &amp;w );
w.<a href="ntqwidget.html#show">show</a>();
return a.<a href="ntqapplication.html#exec">exec</a>();
}
</pre>
<p> <h2> Line-by-line Walkthrough
</h2>
<a name="1"></a><p> <pre> class LCDRange : public <a href="ntqvbox.html">TQVBox</a>
{
public:
LCDRange( <a href="ntqwidget.html">TQWidget</a> *parent=0, const char *name=0 );
};
</pre>
<p> The LCDRange widget is a widget without any API. It just has a
constructor. This sort of widget is not very useful, so we'll add some API later.
<p> <pre> LCDRange::LCDRange( <a href="ntqwidget.html">TQWidget</a> *parent, const char *name )
: <a href="ntqvbox.html">TQVBox</a>( parent, name )
{
<a href="ntqlcdnumber.html">TQLCDNumber</a> *lcd = new <a href="ntqlcdnumber.html">TQLCDNumber</a>( 2, this, "lcd" );
<a href="ntqslider.html">TQSlider</a> * slider = new <a href="ntqslider.html">TQSlider</a>( Horizontal, this, "slider" );
<a name="x2325"></a> slider-&gt;<a href="ntqrangecontrol.html#setRange">setRange</a>( 0, 99 );
<a name="x2326"></a> slider-&gt;<a href="ntqslider.html#setValue">setValue</a>( 0 );
<a name="x2327"></a><a name="x2324"></a> <a href="ntqobject.html#connect">connect</a>( slider, TQ_SIGNAL(<a href="ntqslider.html#valueChanged">valueChanged</a>(int)), lcd, TQ_SLOT(<a href="ntqlcdnumber.html#display">display</a>(int)) );
}
</pre>
<p> This is lifted straight from the
<a href="tutorial1-05.html#constructor">MyWidget constructor</a> in Chapter 5.
The only differences are that the button is left out and the class
is renamed.
<p> <pre> class MyWidget : public <a href="ntqvbox.html">TQVBox</a>
{
public:
MyWidget( <a href="ntqwidget.html">TQWidget</a> *parent=0, const char *name=0 );
};
</pre>
<p> MyWidget, too, contains no API except a constructor.
<p> <pre> MyWidget::MyWidget( <a href="ntqwidget.html">TQWidget</a> *parent, const char *name )
: <a href="ntqvbox.html">TQVBox</a>( parent, name )
{
<a href="ntqpushbutton.html">TQPushButton</a> *quit = new <a href="ntqpushbutton.html">TQPushButton</a>( "Quit", this, "quit" );
<a name="x2328"></a> quit-&gt;<a href="ntqwidget.html#setFont">setFont</a>( TQFont( "Times", 18, TQFont::Bold ) );
<a name="x2321"></a> <a href="ntqobject.html#connect">connect</a>( quit, TQ_SIGNAL(<a href="ntqbutton.html#clicked">clicked</a>()), tqApp, TQ_SLOT(<a href="ntqapplication.html#quit">quit</a>()) );
</pre>
<p> The push button that used to be in what is now LCDRange has been
separated so that we can have one "Quit" button and many LCDRange
objects.
<p> <pre> <a href="ntqgrid.html">TQGrid</a> *grid = new <a href="ntqgrid.html">TQGrid</a>( 4, this );
</pre>
<p> We create a <a href="ntqgrid.html">TQGrid</a> object with four columns. The TQGRid widget
automatically arranges its children in rows and columns; you can
specify the number of rows or of columns, and TQGrid will discover its
new children and fit them into the grid.
<p> <pre> for( int r = 0 ; r &lt; 4 ; r++ )
for( int c = 0 ; c &lt; 4 ; c++ )
(void)new LCDRange( grid );
</pre>
<p> Four columns, four rows.
<p> We create 4*4 LCDRanges, all of which are children of the grid object.
The TQGrid widget will arrange them.
<p> <pre> }
</pre>
<p> That's all.
<p> <h2> Behavior
</h2>
<a name="2"></a><p> This program shows how easy it is to use many widgets at a time. Each
one behaves like the slider and LCD number in the previous
chapter. Again, the difference lies in the implementation.
<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> Initialize each slider with a different/random value on startup.
<p> The source contains three occurrences of "4". What happens if you
change the one in the <a href="ntqgrid.html">TQGrid</a> constructor call? What about the other
two? Why is this?
<p> You're now ready for <a href="tutorial1-07.html">Chapter 7.</a>
<p> [<a href="tutorial1-05.html">Previous tutorial</a>]
[<a href="tutorial1-07.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>