doc/html/designer-manual-12.html


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

<!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/tools/designer/book/chap-toolbuttons.leaf:3 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Reference: Toolbar Buttons</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><p align="right">[<a href="designer-manual-11.html">Prev: Reference: Menu Options</a>] [<a href="designer-manual.html">Home</a>] [<a href="designer-manual-13.html">Next: Reference: Dialogs</a>]</p>
<h2 align="center">Reference: Toolbar Buttons</h2>
<a name="reference-toolbar-buttons"></a><h3><a name="1"></a>Introduction</h3>
<p><em>Qt Designer</em>'s toolbar buttons provide fast access to common functionality. Toolbar buttons are grouped in several toolbars. Toolbars have a handle at the left hand side which can be clicked to minimize the toolbar. Toolbars that have been minimized have their handle appear just under the menu bar; click the handle to restore the toolbar to the last position it occupied. You can drag a toolbar's handle to move the toolbar to a different position in the toolbar area. Toolbars can be dragged out of the toolbar area entirely and made into stand-alone tool dock windows. To hide a tool dock window click its close button. To restore a hidden tool dock window, right click the tool area, then click the name of the tool dock window you wish to restore.</p>
<h3><a name="2"></a>The File Toolbar Buttons</h3>
<p align="center"><img align="middle" src="rtb-file.png" width="213" height="31">
</p>
<blockquote><p align="center"><em>File Toolbuttons</em></p></blockquote>
<ul><li><p><b>New</b><br> Click this toolbar button (or press <b>Ctrl+N</b>) to create a new project, form or file. This option invokes the <a href="designer-manual-13.html#3-1">New File Dialog</a>.</p>
<li><p><b>Open</b><br> Click this toolbar button (or press <b>Ctrl+O</b>) to open existing projects, forms or files. This button invokes the <a href="designer-manual-13.html#3-2">File Open Dialog</a> which is used to select files.</p>
<li><p><b>Save</b><br> Click this toolbar button (or press <b>Ctrl+S</b>) to save the project, forms and files. For a new project that has no forms or files, click 'Save' to save the project before exiting. For new forms, click 'Save' and the <a href="designer-manual-13.html#3-4">Save Form As Dialog</a> appears.</p>
<li><p><b>Active Project</b><br> Click the combobox to view the names of the projects that are currently open and select a project name to toggle between the projects.</p>
</ul><h3><a name="3"></a>The Edit Toolbar Buttons</h3>
<p align="center"><img align="middle" src="rtb-edit.png" width="165" height="29">
</p>
<blockquote><p align="center"><em>Edit Toolbuttons</em></p></blockquote>
<ul><li><p><b>Undo</b><br> Click this toolbar button (or press <b>Ctrl+Z</b>) to undo an action. The name of the last action that was performed appears after the word 'Undo' in this toolbar button's tooltip.</p>
<li><p><b>Redo</b><br> Click this toolbar button (or press <b>Ctrl+Y</b>) to redo an action. The name of the last action that was performed appears after the word 'Redo' in this toolbar button's tooltip.</p>
<li><p><b>Cut</b><br> Click this toolbar button (or press <b>Ctrl+X</b>) to delete the selected item from the current form or file and copy it to the clipboard.</p>
<li><p><b>Copy</b><br> Click this toolbar button (or press <b>Ctrl+C</b>) to copy the selected item from the current form or file to the clipboard.</p>
<li><p><b>Paste</b><br> Click this toolbar button (or press <b>Ctrl+V</b>) to paste the selected item (if any) from the clipboard into the current form or file.</p>
</ul><h3><a name="4"></a>The Search Toolbar Buttons</h3>
<p align="center"><img align="middle" src="rtb-search.png" width="168" height="28">
</p>
<blockquote><p align="center"><em>Search Toolbuttons</em></p></blockquote>
<ul><li><p><b>Find</b><br> Click this toolbar button (or press <b>Ctrl+F</b>) to invoke the <a href="designer-manual-13.html#6-1">Find Text Dialog</a>.</p>
<li><p><b>Find Incremental</b><br> Click this toolbar button (or press <b>Alt+I</b>) to place the cursor in the text box located next to the <b>Find</b> toolbar button. Type characters into the text box; as you type, <em>Qt Designer</em> will highlight the first occurrence of the text that it finds in the file. Press the <b>Enter</b> key to go to the next occurrence of the text. Press the <b>Esc</b> key once you have found the word you are looking for to place the cursor in the editor.</p>
</ul><h3><a name="5"></a>The Tools Toolbar Buttons</h3>
<p>The tools toolbar buttons are available through toolbars (as they have always been prior to Qt 3.1), and also via the new Toolbox. From Qt 3.1, the tools toolbars are hidden and the Toolbox is shown. The Toolbox is divided into groups, with the first group being "Common Widgets" which contains the widgets you're likely to use most often. If you prefer to use the original toolbar setup, you can access the toolbars by clicking <b>Windows|Toolbars</b> and then selecting the toolbars you want to be visible from the context menu.</p>
<p>The Toolbox contains categories describing the type of toolbuttons you can find within each catgory. Click a category name to access the toolbuttons in that category. To use a widget in a category, click the widget to activate it. Click the 'x' in the right hand corner of the Toolbox to close it. To make the Toolbox appear again, click <b>Window|Views|Toolbox</b>.</p>
<p align="center"><img align="middle" src="rtb-toolbox.png" width="171" height="513">
</p>
<blockquote><p align="center"><em>The Toolbox</em></p></blockquote>
<p>If you want to add the same kind of widget several times to a form, for example, several push buttons, <em>double click</em> the widget's toolbar button. After this, each time you click the form a new widget will be added. Click the <b>Pointer</b> toolbar button to leave this mode.</p>
<h4><a name="5-1"></a>Tools</h4>
<p align="center"><img align="middle" src="rtb-tools.png" width="130" height="29">
</p>
<blockquote><p align="center"><em>Tools</em></p></blockquote>
<ul><li><p><b>Pointer</b><br> Click this toolbar button (or press <b>F2</b>) to de-select any selected widget toolbar button. The pointer is also used to stop inserting new widgets if you double clicked a widget toolbar button. Press the <b>Esc</b> key to return to the pointer at any time.</p>
<li><p><b>Connect Signals and Slots</b><br> Click this toolbar button (or press <b>F3</b>) to connect signals and slots. Then click on a widget and drag the connection line to the widget (or the form) that you want to connect to. Release the mouse button and the <a href="designer-manual-13.html#4-2">View and Edit Connections Dialog</a> will appear.</p>
<li><p><b>Tab Order</b><br> Click this toolbar button (or press <b>F4</b>) to set the tab order for all the widgets on the form that can accept keyboard focus. Click this toolbar button and blue circles with numbers on them appear next to the widgets. Click the widget that you want to be first in the tab order, then click the widget that should be next in the tab order, and continue until all the widgets have the tab order numbers you want. If you make a mistake, double click the first widget and start again. Press <b>Esc</b> to leave tab order mode. If you want to revert your changes, leave tab order mode, then undo.</p>
<li><p><b>Set Buddy</b><br> Click this toolbar button (or press <b>F12</b>) to set a buddy to a label. Then click on a label and drag the line to the widget that you want to be the buddy. Release the mouse button and the buddy is set.</p>
</ul><h4><a name="5-2"></a>Buttons</h4>
<p align="center"><img align="middle" src="rtb-tbbuttons.png" width="173" height="306">
</p>
<blockquote><p align="center"><em>Buttons</em></p></blockquote>
<ul><li><p><b>PushButton</b><br> Click this toolbar button, then click the form, to place a Pushbutton on the form.</p>
<li><p><b>ToolButton</b><br> Click this toolbar button, then click the form, to place a Toolbutton on the form.</p>
<li><p><b>RadioButton</b><br> Click this toolbar button, then click the form, to place a Radiobutton on the form. It is recommended that you place RadioButtons inside ButtonGroups so that Qt will automatically ensure that only one RadioButton in the group is active at any one time.</p>
<li><p><b>CheckBox</b><br> Click this toolbar button, then click the form, to place a CheckBox on the form.</p>
</ul><h4><a name="5-3"></a>Containers</h4>
<p align="center"><img align="middle" src="rtb-tbcontain.png" width="170" height="341">
</p>
<blockquote><p align="center"><em>Containers</em></p></blockquote>
<ul><li><p><b>GroupBox</b><br> Click this toolbar button, then click the form, to place a GroupBox on the form.</p>
<li><p><b>ButtonGroup</b><br> Click this toolbar button, then click the form, to place a ButtonGroup on the form.</p>
<li><p><b>Frame</b><br> Click this toolbar button, then click the form, to place a Frame on the form.</p>
<li><p><b>TabWidget</b><br> Click this toolbar button, then click the form, to place a TabWidget on the form. To add or remove tabs, right click the tab widget and choose 'Add Page' or 'Remove Page'.</p>
</ul><h4><a name="5-4"></a>Views</h4>
<p align="center"><img align="middle" src="rtb-tbviews.png" width="172" height="343">
</p>
<blockquote><p align="center"><em>Views</em></p></blockquote>
<ul><li><p><b>ListBox</b><br> Click this toolbar button, then click the form, to place a ListBox on the form.</p>
<li><p><b>ListView</b><br> Click this toolbar button, then click the form, to place a ListView on the form.</p>
<li><p><b>Icon View</b><br> Click this toolbar button, then click the form, to place an IconView on the form.</p>
<li><p><b>Table</b><br> Click this toolbar button, then click the form to place a Table on the form.</p>
</ul><h4><a name="5-5"></a>Database</h4>
<p align="center"><img align="middle" src="rtb-tbdatabase.png" width="170" height="344">
</p>
<blockquote><p align="center"><em>Database Toolbuttons</em></p></blockquote>
<ul><li><p><b>DataTable</b><br> Click this toolbar button, then click the form, to place a DataTable on the form.</p>
<li><p><b>DataBrowser</b><br> Click this toolbar button, then click the form, to place a DataBrowser on the form.</p>
<li><p><b>DataView</b><br> Click this toolbar button, then click the form, to place a DataView on the form.</p>
</ul><h4><a name="5-6"></a>Input</h4>
<p align="center"><img align="middle" src="rtb-tbinput.png" width="172" height="475">
</p>
<blockquote><p align="center"><em>Input Toolbuttons</em></p></blockquote>
<ul><li><p><b>LineEdit</b><br> Click this toolbar button, then click the form, to place a LineEdit on the form.</p>
<li><p><b>SpinBox</b><br> Click this toolbar button, then click the form, to place a SpinBox on the form.</p>
<li><p><b>DateEdit</b><br> Click this toolbar button, then click the form, to place a DateEdit on the form.</p>
<li><p><b>TimeEdit</b><br> Click this toolbar button, then click the form, to place a TimeEdit on the form.</p>
<li><p><b>DateTimeEdit</b><br> Click this toolbar button, then click the form, to place a DateTimeEdit on the form.</p>
<li><p><b>TextEdit</b><br> Click this toolbar button, then click the form, to place a TextEdit on the form.</p>
<li><p><b>ComboBox</b><br> Click this toolbar button, then click the form, to place a ComboBox on the form.</p>
<li><p><b>Slider</b><br> Click this toolbar button, then click the form, to place a Slider on the form.</p>
<li><p><b>ScrollBar</b><br> Click this toolbar button, then click the form, to place a Scrollbar on the form.</p>
<li><p><b>Dial</b><br> Click this toolbar button, then click the form, to place a Dial on the form.</p>
</ul><h4><a name="5-7"></a>Display</h4>
<p align="center"><img align="middle" src="rtb-tbdisplay.png" width="171" height="368">
</p>
<blockquote><p align="center"><em>Display Toolbuttons</em></p></blockquote>
<ul><li><p><b>TextLabel</b><br> Click this toolbar button, then click the form, to place a TextLabel on the form.</p>
<li><p><b>PixmapLabel</b><br> Click this toolbar button, then click the form, to place a PixmapLabel on the form.</p>
<li><p><b>LCDNumber</b><br> Click this toolbar button, then click the form, to place a LCDNumber on the form.</p>
<li><p><b>Line</b><br> Click this toolbar button, then click the form, to place a Line on the form.</p>
<li><p><b>ProgressBar</b><br> Click this toolbar button, then click the form, to place a ProgressBar on the form.</p>
<li><p><b>TextBrowser</b><br> Click this toolbar button, then click the form, to place a TextBrowser on the form.</p>
</ul><h4><a name="5-8"></a>Custom</h4>
<p align="center"><img align="middle" src="rtb-tbcustom.png" width="171" height="229">
</p>
<blockquote><p align="center"><em>Custom Widget Toolbutton</em></p></blockquote>
<ul><li><p><b>My Custom Widget</b><br> Click this toolbar button, then click the form, to place a Custom Widget on the form. Note: this toolbar button only appears if you have created a custom widget using <b>Tools|Custom|Edit Custom Widgets</b>.</p>
</ul><h4><a name="5-9"></a>The Layout Toolbar Buttons</h4>
<p align="center"><img align="middle" src="rtb-layout.png" width="184" height="29">
</p>
<blockquote><p align="center"><em>Layout Toolbuttons</em></p></blockquote>
<ul><li><p><b>Adjust Size</b><br> Click this toolbar button (or press <b>Ctrl+J</b>) to adjust the size of the widget to it's recommended size.</p>
<li><p><b>Lay Out Horizontally</b><br> Click this toolbar button (or press <b>Ctrl+H</b>) to lay out the selected widgets or layouts side by side. Use <b>Shift+Click</b> to select each widget or layout, and then choose this toolbar button to group them horizontally. Note that for complex widgets it is sometimes easiest to select widgets and layouts by clicking them in the Widgets tab of the <a href="designer-manual-15.html#3">Object Explorer Window</a>.</p>
<li><p><b>Lay Out Vertically</b><br> Click this toolbar button (or press <b>Ctrl+L</b>) to lay out the selected widgets one above the other. Use <b>Shift+Click</b> to select each widget or layout, and then choose this toolbar button to group them vertically. Note that for complex widgets it is sometimes easiest to select widgets and layouts by clicking them in the Widgets tab of the <a href="designer-manual-15.html#3">Object Explorer Window</a>.</p>
<li><p><b>Lay out in a Grid</b><br> Click the widgets you want and then click this toolbar button (or press <b>Ctrl+G</b>) to lay out widgets in a grid.</p>
<li><p><b>Lay Out Horizontally (in Splitter)</b><br> Click this toolbar button to lay out the selected groups of widgets or layouts side by side with a splitter between each group. Use <b>Shift+Click</b> to select each widget or layout, and then choose this toolbar button to group them horizontally. Note that for complex widgets it is sometimes easiest to select widgets and layouts by clicking them in the Widgets tab of the <a href="designer-manual-15.html#3">Object Explorer Window</a>.</p>
<li><p><b>Lay Out Vertically (in Splitter)</b><br> Click this toolbar button to lay out the selected groups of widgets or layouts one above the other with a splitter between each group. Use <b>Shift+Click</b> to select each widget or layout, and then choose this toolbar button to group them vertically. Note that for complex widgets it is sometimes easiest to select widgets and layouts by clicking them in the Widgets tab of the <a href="designer-manual-15.html#3">Object Explorer Window</a>.</p>
<li><p><b>Break Layout</b><br> Click this toolbar button (or press <b>Ctrl+B</b>) to break a layout. Click on the layout and select this option; the layout is deleted.</p>
<li><p><b>Add Spacer</b><br> Click this toolbar button to add a spacer to widgets that take up too much space on the form. The spacer consumes extra space in the layout.</p>
</ul><h3><a name="6"></a>The Help Toolbar Button</h3>
<p align="center"><img align="middle" src="qd-helptoolbuttons3.png" width="27" height="40">
</p>
<blockquote><p align="center"><em>Help Toolbutton</em></p></blockquote>
<ul><li><p><b>What's This?</b><br> Click this menu option to invoke a small question mark that is attached to the mouse pointer. Click on a feature which you would like more information about. A message box appears with information about the feature.</p>
</ul><!-- eof -->
<p align="right">[<a href="designer-manual-11.html">Prev: Reference: Menu Options</a>] [<a href="designer-manual.html">Home</a>] [<a href="designer-manual-13.html">Next: Reference: Dialogs</a>]</p>
<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>Qt 3.3.8</div>
</table></div></address></body>
</html>