diff options
Diffstat (limited to 'doc/html/layout.html')
| -rw-r--r-- | doc/html/layout.html | 38 |
1 files changed, 19 insertions, 19 deletions
diff --git a/doc/html/layout.html b/doc/html/layout.html index 8dc1039c1..7ba159960 100644 --- a/doc/html/layout.html +++ b/doc/html/layout.html @@ -59,17 +59,17 @@ layouts and which generates the C++ layout code for you. <p> <h2> Layout Widgets </h2> <a name="1"></a><p> The easiest way to give your widgets a good layout is to use the -layout widgets: <a href="ntqhbox.html">TQHBox</a>, <a href="ntqvbox.html">TQVBox</a> and <a href="tqgrid.html">TQGrid</a>. A layout widget +layout widgets: <a href="tqhbox.html">TQHBox</a>, <a href="tqvbox.html">TQVBox</a> and <a href="tqgrid.html">TQGrid</a>. A layout widget automatically lays out its child widgets in the order they are constructed. To create more complex layouts, you can nest layout widgets inside each other. (Note that <a href="tqwidget.html">TQWidget</a> does not have a layout by default, you must add one if you want to lay out widgets inside a <a href="tqwidget.html">TQWidget</a>.) <p> <ul> -<li> A <a href="ntqhbox.html">TQHBox</a> lays out its child widgets in a horizontal row, left to right. -<p> <center><img src="qhbox-m.png" alt="Horizontal box with five child widgets"></center> -<p> <li> A <a href="ntqvbox.html">TQVBox</a> lays out its child widgets in a vertical column, top to bottom. -<p> <center><img src="qvbox-m.png" alt="Vertical box with five child widgets"></center> +<li> A <a href="tqhbox.html">TQHBox</a> lays out its child widgets in a horizontal row, left to right. +<p> <center><img src="tqhbox-m.png" alt="Horizontal box with five child widgets"></center> +<p> <li> A <a href="tqvbox.html">TQVBox</a> lays out its child widgets in a vertical column, top to bottom. +<p> <center><img src="tqvbox-m.png" alt="Vertical box with five child widgets"></center> <p> <li> A <a href="tqgrid.html">TQGrid</a> lays out its child widgets in a two dimensional grid. You can specify how many columns the grid has, and it is populated left to right, beginning a new row when the previous row is full. The grid is @@ -120,15 +120,15 @@ are laid out in a layout the widgets are given a share of space in accordance with their <a href="tqwidget.html#sizePolicy">TQWidget::sizePolicy</a>() or their minimum size hint whichever is the greater. Stretch factors are used to change how much space widgets are given in proportion to one another. -<p> If we have three widgets laid out using a <a href="ntqhbox.html">TQHBox</a> with no stretch +<p> If we have three widgets laid out using a <a href="tqhbox.html">TQHBox</a> with no stretch factors set we will get a layout like this: <p> <center><img src="layout1.png" alt="3 widgets in a row"></center> <p> If we apply stretch factors to each widget, they will be laid out in proportion (but never less than their minimum size hint), e.g. <p> <center><img src="layout2.png" alt="3 stretch factored widgets in a row"></center> -<p> <h2> <a href="ntqlayout.html">TQLayout</a> subclassing +<p> <h2> <a href="tqlayout.html">TQLayout</a> subclassing </h2> -<a name="3"></a><p> If you need more control over the layout, use a <a href="ntqlayout.html">TQLayout</a> subclass. The layout classes included in TQt are <a href="tqgridlayout.html">TQGridLayout</a> and <a href="qboxlayout.html">TQBoxLayout</a>. (<a href="qhboxlayout.html">TQHBoxLayout</a> and <a href="qvboxlayout.html">TQVBoxLayout</a> are trivial subclasses of <a href="qboxlayout.html">TQBoxLayout</a>, +<a name="3"></a><p> If you need more control over the layout, use a <a href="tqlayout.html">TQLayout</a> subclass. The layout classes included in TQt are <a href="tqgridlayout.html">TQGridLayout</a> and <a href="tqboxlayout.html">TQBoxLayout</a>. (<a href="tqhboxlayout.html">TQHBoxLayout</a> and <a href="tqvboxlayout.html">TQVBoxLayout</a> are trivial subclasses of <a href="tqboxlayout.html">TQBoxLayout</a>, that are simpler to use and make the code easier to read.) <p> When you use a layout, you must insert each child both into its parent widget (done in the constructor) and into its layout (typically done @@ -169,14 +169,14 @@ a parameter in the constructor. <a href="tqlabel.html">TQLabel</a> *label = new <a href="tqlabel.html">TQLabel</a>( "Write once, compile everywhere.", main ); // a layout on a widget - <a href="qvboxlayout.html">TQVBoxLayout</a> *vbox = new <a href="qvboxlayout.html">TQVBoxLayout</a>( main ); - vbox-><a href="qboxlayout.html#addWidget">addWidget</a>( label ); - vbox-><a href="qboxlayout.html#addWidget">addWidget</a>( field ); + <a href="tqvboxlayout.html">TQVBoxLayout</a> *vbox = new <a href="tqvboxlayout.html">TQVBoxLayout</a>( main ); + vbox-><a href="tqboxlayout.html#addWidget">addWidget</a>( label ); + vbox-><a href="tqboxlayout.html#addWidget">addWidget</a>( field ); // a layout inside a layout - <a href="qhboxlayout.html">TQHBoxLayout</a> *buttons = new <a href="qhboxlayout.html">TQHBoxLayout</a>( vbox ); - buttons-><a href="qboxlayout.html#addWidget">addWidget</a>( ok ); - buttons-><a href="qboxlayout.html#addWidget">addWidget</a>( cancel ); + <a href="tqhboxlayout.html">TQHBoxLayout</a> *buttons = new <a href="tqhboxlayout.html">TQHBoxLayout</a>( vbox ); + buttons-><a href="tqboxlayout.html#addWidget">addWidget</a>( ok ); + buttons-><a href="tqboxlayout.html#addWidget">addWidget</a>( cancel ); </pre> If you are not satisfied with the default placement, you can create @@ -186,15 +186,15 @@ into. <p> <h2> Custom Layouts </h2> <a name="4"></a><p> If the built-in layout classes are not sufficient, you can define your -own. You must make a subclass of <a href="ntqlayout.html">TQLayout</a> that handles resizing and -size calculations, as well as a subclass of <a href="qglayoutiterator.html">TQGLayoutIterator</a> to +own. You must make a subclass of <a href="tqlayout.html">TQLayout</a> that handles resizing and +size calculations, as well as a subclass of <a href="tqglayoutiterator.html">TQGLayoutIterator</a> to iterate over your layout class. <p> See the <a href="customlayout.html">Custom Layout</a> page for an in-depth description. <p> <h2> Custom Widgets In Layouts </h2> <a name="5"></a><p> When you make your own widget class, you should also communicate its -layout properties. If the widget has a <a href="ntqlayout.html">TQLayout</a>, this is already taken +layout properties. If the widget has a <a href="tqlayout.html">TQLayout</a>, this is already taken care of. If the widget does not have any child widgets, or uses manual layout, you should reimplement the following <a href="tqwidget.html">TQWidget</a> member functions: <p> <ul> @@ -211,8 +211,8 @@ Multiple calls to updateGeometry() will only cause one recalculation. <a href="tqwidget.html#sizePolicy">sizePolicy</a>(), and reimplement <a href="tqwidget.html#heightForWidth">TQWidget::heightForWidth</a>(). <p> Even if you implement heightForWidth(), it is still necessary to provide a good sizeHint(). The sizeHint() provides the preferred width -of the widget, and it is used by <a href="ntqlayout.html">TQLayout</a> subclasses that do not -support heightForWidth() (both <a href="tqgridlayout.html">TQGridLayout</a> and <a href="qboxlayout.html">TQBoxLayout</a> support it). +of the widget, and it is used by <a href="tqlayout.html">TQLayout</a> subclasses that do not +support heightForWidth() (both <a href="tqgridlayout.html">TQGridLayout</a> and <a href="tqboxlayout.html">TQBoxLayout</a> support it). <p> For further guidance when implementing these functions, see their implementations in existing TQt classes that have similar layout requirements to your new widget. |