\chapter Reference: Menu Options 

\section1 Introduction

\QD provides menu options that invoke actions that are used to
help create applications. Many menu options lead to dialog boxes that
provide specific functionality. The most common menu options also have
corresponding toolbar buttons. This chapter explains each menu option
and its use. For menu options that invoke a dialog box or which have
a corresponding toolbar button, there is a cross-reference to the
detailed explanation that appears in the relevant chapter.

\img qd-filemenu1.png
\caption The File Menu

\section1 The File Menu

This menu is invoked with \Key Alt+F, and provides the following
options:
\list

\i \Menu File|New\BR Click this menu option (or press \Key Ctrl+N) to
create a new project, form or file. This option invokes the
\l{New File Dialog}. 

\i \Menu File|Open\BR Click this menu option (or press \Key Ctrl+O) to
open existing projects, forms or files. The \l{File Open Dialog} is
invoked through which a file name can be selected.

\i \Menu File|Close\BR Click this menu option to close the currently
open project. If the project has unsaved changes, the \l{Save Form
Dialog} appears. 

\i \Menu File|Save\BR Click this menu option (or press \Key Ctrl+S) to
save the project along with its forms and files. For a project that
has forms or files, click 'Save' to save the project before exiting.
For new forms, click 'Save' and the \l{Save Form As Dialog} appears.
For forms that have been saved previously click 'Save'. For new files
or for files that have been changed, click 'Save'. 

\i \Menu {File|Save As}\BR Click this menu option to save and name the
current form or file. This option invokes the \l{Save Form As Dialog}.

\i \Menu {File|Save All}\BR Click this menu option to save every open
file and form in every open project.

\i \Menu {File|Create Template}\BR Click this menu option to create a
form template. This option invokes the \l{Create Template Dialog}
dialog.

\i \Menu {File|Recently Opened Files}\BR Click this menu option to
list the most recently opened files. Click one of the files listed to
open it. Note that we recommend that you open projects rather than
files. You can open a file by clicking the file's name in the
project's \l{File Overview Window}.

\i \Menu {File|Recently Opened Projects}\BR Click this menu option to
list the most recently opened projects. Click one of the projects
listed to open it. 

\i \Menu File|Exit\BR Click this menu option to exit \QD. If any open
files have unsaved changes, the \Dialog {Save Form Dialog} message box
will appear for each of them, before \QD exits. Note that for a
form that has not been saved previously but has had changes made to it
or that has been saved but has had changes made to it, the
\Dialog{Save Form Dialog} is invoked. Click \Button Yes to invoke the
\Dialog{Save Form As} dialog.

\endlist 

See also \l{The File Toolbar Buttons}.

\img qd-editmenu1.png
\caption The Edit Menu

\section1 The Edit Menu

This menu is invoked with \Key Alt+E, and provides the following
options:
\list

\i \Menu Edit|Undo\BR Click this menu option (or press \Key Ctrl+Z) to
undo an action. The name of the last action that was performed appears
after the word 'Undo'.  

\i \Menu Edit|Redo\BR Click this menu option (or press \Key Ctrl+Y) to
redo an action. The name of the last action that was performed appears
after the word 'Redo'. 

\i \Menu Edit|Cut\BR Click this menu option (or press \Key Ctrl+X) to
delete the selected item from the current form or file and copy it to
the clipboard. 

\i \Menu Edit|Copy\BR Click this menu option (or press \Key Ctrl+C) to
copy the selected item from the current form or file to the clipboard.

\i \Menu Edit|Paste\BR Click this menu option (or press \Key Ctrl+V) to
paste the clipboard item (if any) into the current form or file. 

\i \Menu Edit|Delete\BR Click this menu option (or press \Key Del) to
delete the selected item from the current form or file.

\i \Menu {Edit|Select All}\BR Click this menu option (or press \Key
Ctrl+A) to highlight all the widgets on the current form or all the
text in the current file. 

\i \Menu {Edit|Check Accelerators}\BR Click this menu option (or press
\Key Alt+R) to verify that all the accelerators are used only
once. If an accelerator is used more than once, a message box
appears with the statement 'The accelerator 'x' is used 'y' times'.
Click \Button Select to highlight the widgets with the same
accelerator, or click \CANCEL to exit the message box without taking
any action. 

\i \Menu Edit|Slots\BR Click this menu option to edit and create
slots. This option invokes the \l{Edit Slots Dialog}.

\i \Menu Edit|Connections\BR Click this menu option to invoke the \l{View
Connections Dialog}. 

\i \Menu {Edit|Form Settings}\BR Click this menu option to invoke the \l{Form
Settings Dialog}.

\i \Menu Edit|Preferences\BR Click this menu option to invoke the
\l{Preferences Dialog}.

\endlist

See also \l{The Edit Toolbar buttons}.

\img qd-projectmenu.png
\caption The Project Menu

\section1 The Project Menu 

This menu is invoked with \Key Alt+O, and provides the following
options:
\list 

\i \Menu {Project|Active Project}\BR Click this menu
option to toggle between projects if there is more than one project
open. You can also toggle between projects using the Active Project
drop-down combobox in the \l{The File Toolbar Buttons}.

\i \Menu{Project|Add File}\BR Click this menu option 
to invoke the \l{Add Dialog}
 
\i \Menu {Project|Project Settings}\BR Click this menu option to invoke
the \l{Project Settings Dialog}.

\i \Menu {Project|Image Collection}\BR Click this menu option to invoke
the \l{Image Collection Dialog}.

\i \Menu {Project|Database Connections}\BR Click this menu option to
invoke the \l{Edit Database Connections Dialog}.

\endlist

See also \l{The File Toolbar Buttons}.

\img qd-searchmenu.png
\caption The Search Menu

\section1 The Search Menu

This menu is invoked with \Key Alt+S, and provides the following
options:
\list

\i \Menu Search|Find\BR Click this menu option (or press \Key Ctrl+F) to
invoke the \l{Find Text Dialog}. 

\i \Menu {Search|Find Incremental}\BR Click this menu option (or press
\Key Alt+I) to place the cursor in the text box located next to the
\Toolbutton Find toolbar button. Type characters into the text box; as
you type, \QD will highlight the first occurrence of the text that it
finds in the file. Press the \Key Enter key to go to the next
occurrence of the text. Press the \Key Esc key once you have found the
word you are looking for to place the cursor in the editor.

\i \Menu Search|Replace\BR Click this menu option (or press \Key Ctrl+R)
to invoke the \l{Replace Text Dialog} to replace specific words or
characters.

\i \Menu{Search|Goto line}\BR Click this menu option (or press \Key
Alt+G) to invoke the \l{Goto Line Dialog} to go to a specific line
in the file.

\endlist

See also \l{The Search Toolbar Buttons}.

\img qd-toolsmenu.png
\caption The Tools Menu

\section1 The Tools Menu

This menu is invoked with \Key Alt+T, and provides the following
options:
\list 

\i \Menu Tools|Pointer\BR Click this menu option (or press \Key F2) to
de-select any selected widget toolbar button. The pointer is also used
to stop inserting new widgets on the form if you double clicked a
widget toolbar button. Press the \Key Esc key to return to the
pointer at any time.

\i \Menu{Tools|Connect Signals and Slots}\BR Click this menu option
(or press \Key F3) to connect signals and slots. Click on a widget and
drag the connection line to the widget (or form) that you want to
connect to. Release the mouse button and the \l{Edit Connections
Dialog} will appear. 

\i \Menu {Tools|Tab Order}\BR Click this menu option (or press \Key
F4) to set the tab order for all the widgets on the form that can
accept keyboard focus. Choose this option 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 \Key Esc to leave tab order mode.
If you want to revert your changes, leave tab order mode, then undo.

\i \Menu {Tools|Buttons|PushButton}\BR Click this menu option and then
click the form to place a PushButton on the form. 

\i \Menu {Tools|Buttons|ToolButton}\BR Click this menu option and then
click the form to place a ToolButton on the form.

\i \Menu {Tools|Buttons|RadioButton}\BR Click this menu option and
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.

\i \Menu {Tools|Buttons|CheckBox}\BR Click this menu option and then
click the form to place a CheckBox on the form.

\i \Menu {Tools|Containers|GroupBox}\BR Click this menu option and
then click the form to place a GroupBox on the form.

\i \Menu {Tools|Containers|ButtonGroup}\BR Click this menu option and
then click the form to place a ButtonGroup on the form.

\i \Menu {Tools|Containers|Frame}\BR Click this menu option and then
click the form to place a Frame on the form.

\i \Menu {Tools|Containers|TabWidget}\BR Click this menu option and
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'. 

\i \Menu {Tools|Views|ListBox}\BR Click this menu option and then
click the form to place a ListBox on the form.

\i \Menu {Tools|Views|ListView}\BR Click this menu option and then
click the form to place a ListView on the form.

\i \Menu {Tools|Views|Icon View}\BR Click this menu option and then
click the form to place an IconView on the form.

\i \Menu {Tools|Views|Table}\BR Click this menu option and then click
the form to place a Table on the form.

\i \Menu {Tools|Database|DataTable}\BR Click this menu option and then
click the form to place a DataTable on the form.

\i \Menu {Tools|Database|DataBrowser}\BR Click this menu option and
then click the form to place a DataBrowser on the form.

\i \Menu {Tools|Database|DataView}\BR Click this menu option and then
click the form to place a DataView on the form.

\i \Menu {Tools|Input|LineEdit}\BR Click this menu option and then
click the form to place a LineEdit on the form.

\i \Menu {Tools|Input|SpinBox}\BR Click this menu option and then
click the form to place a SpinBox on the form.

\i \Menu {Tools|Input|DateEdit}\BR Click this menu option and then 
click the form to place a DateEdit on the form.

\i \Menu {Tools|Input|TimeEdit}\BR Click this menu option and then
click the form to place a TimeEdit on the form.

\i \Menu {Tools|Input|DateTimeEdit}\BR Click this menu option and then
click the form to place a DateTimeEdit on the form.

\i \Menu {Tools|Input|TextEdit}\BR Click this menu option and then
click the form to place a TextEdit on the form.

\i \Menu {Tools|Input|ComboBox}\BR Click this menu option and then
click the form to place a ComboBox on the form.

\i \Menu {Tools|Input|Slider}\BR Click this menu option and then click
the form to place a Slider on the form.

\i \Menu {Tools|Input|ScrollBar}\BR Click this menu option and then
click the form to place a Scrollbar on the form.

\i \Menu {Tools|Input|Dial}\BR Click this menu option and then click
the form to place a Dial on the form.

\i \Menu {Tools|Display|TextLabel}\BR Click this menu option  and then
click the form to place a TextLabel on the form.

\i \Menu {Tools|Display|PixmapLabel}\BR Click this menu option and
then click the form to place a PixmapLabel on the form.

\i \Menu {Tools|Display|LCDNumber}\BR Click this menu option and then
click the form to place a LCDNumber on the form.

\i \Menu {Tools|Display|Line}\BR Click this menu option and then 
click the form to place a Line on the form.

\i \Menu {Tools|Display|ProgressBar}\BR Click this menu option and
then click the form to place a ProgressBar on the form.

\i \Menu {Tools|Display|TextBrowser}\BR Click this menu option and
then click the form to place a TextBrowser on the form.

\i \Menu {Tools|Custom|Edit Custom Widgets}\BR Click this menu option
to invoke the \l{Edit Custom Widgets Dialog}. 

\i \Menu {Tools|Custom|<My Custom Widget>}\BR Click this menu option and
then click the form to place the Custom Widget on the form. Note that
this menu option only appears if you have created a widget using
\Menu{Tools|Custom|Edit Custom Widgets}. 

\endlist

See also \l{The Tools Toolbar Buttons}.

\img qd-layoutmenu1.png
\caption The Layout Menu

\section1 The Layout Menu 

This menu is invoked with \Key Alt+L, and provides the following
options:
\list 

\i \Menu {Layout|Adjust Size}\BR Click this menu option (or press \Key
Ctrl+J) to adjust the size of the widget to it's recommended size. 

\i \Menu {Layout|Lay Out Horizontally}\BR Click this menu option (or
press \Key Ctrl+H) to lay out the selected widgets or layouts side by
side. Use \Key Shift+Click to select each widget or layout, and then
choose this menu option 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 \l{Object Explorer Window}.
If only one widget is selected, its child widgets will be laid out
horizontally.

\i \Menu {Layout|Lay Out Vertically}\BR Click this menu option (or press
\Key Ctrl+L) to lay out the selected widgets one above the other. Use
\Key Shift+Click to select each widget or layout, and then choose this
menu option 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 \l{Object Explorer Window}. If only one widget
is selected, its child widgets will be laid out vertically.

\i \Menu {Layout|Lay Out in a Grid}\BR Click this menu option (or press
\Key Ctrl+G) to lay out the selected widgets in a grid. If only one
widget is selected, its child widgets will be laid out in a grid.

\i \Menu {Layout|Lay Out Horizontally (in Splitter)}\BR Click this menu
option to lay out the selected widgets or layouts side by side with a
splitter between each. Use \Key Shift+Click to select each
widget or layout, and then choose this menu option 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
\l{Object Explorer Window}.

\i \Menu {Layout|Lay Out Vertically (in Splitter)}\BR Click this menu
option to lay out the selected widgets or layouts one above the other
with a splitter between each. Use \Key{Shift+Click} to select each
widget or layout, and then choose this menu option 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
\l{Object Explorer Window}.

\i \Menu {Layout|Break Layout}\BR Click this menu option (or press \Key
Ctrl+B) to break a layout. Click on the layout, then select this option;
the layout is deleted. 

\i \Menu {Layout|Add Spacer}\BR Click this menu option to add a vertical
or horizontal spacer to widgets that take up too much space on the
form. The spacer consumes extra space in the layout.

\endlist

See also \l{The Layout Toolbar Buttons}.

\img qd-previewmenu.png
\caption The Preview Menu

\section1 The Preview Menu 

This menu is invoked with \Key Alt+P, and provides the following
options: 
\list 

\i \Menu{Preview|Preview Form}\BR Click this menu option (or press
\Key Ctrl+T) to preview the form within \QD.

\i \Menu{Preview|...in Windows Style}\BR Click this menu option to
preview the form in the Windows style. 

\i \Menu{Preview|...in Motif Style}\BR Click this menu option to preview
the form in the Motif style.

\i \Menu{Preview|...in CDE Style}\BR Click this menu option to preview
the form in the CDE style.

\i \Menu{Preview|...in MotifPlus Style}\BR Click this menu option to
preview the form in the MotifPlus style. 

\i \Menu{Preview|...in Platinum Style}\BR Click this menu option to
preview the form in the Platinum style. 

\i \Menu{Preview|...in SGI Style}\BR Click this menu option to preview the
form in the SGI style.

\endlist

\img qd-windowmenu1.png
\caption The Window Menu

\section1 The Window Menu

This menu is invoked with \Key Alt+W, and provides the following
options:
\list 

\i \Menu{Window|Close}\BR Click this menu option (or press \Key
Ctrl+F4) to close the window that is currently active.

\i \Menu{Window|Close All}\BR Click this menu option to close all the
windows that are currently open.

\i \Menu{Window|Next}\BR Click this menu option (or press \Key
Ctrl+F6) to make the next window active. The order is the order in
which the windows were opened. 

\i \Menu{Window|Previous}\BR Click this menu option (or press \Key
Ctrl+Shift+F6) to make the previous window active. The order is the
order in which the windows were opened. 

\i \Menu{Window|Tile}\BR Click this menu option to arrange all the open
files and forms side by side so that each window is visible. 

\i \Menu{Window|Cascade}\BR Click this menu option to stack all the
open file and forms, one on top of the other, but with an overlap so
that each window's title bar is visible. 

\omit

\i \Menu{Window|Views|Output Window}\BR Click this menu option to invoke
the \l{Output Window}, which displays debugging messages. 

\endomit

\i \Menu{Window|Views|File Overview}\BR Click this menu option to make
the \l{File Overview Window} visible, or to hide it if it is already
visible. If the window is currently visible, a check mark will appear
next to the name in the menu.

\i \Menu{Window|Views|Property Editor/Signal Handlers}\BR Click this
menu option to make the \l{Property Editor/Signal Handlers Window}
visible, or to hide it if it is already visible. If the window is
currently visible, a check mark will appear next to the name in the
menu.

\i \Menu{Window|Views|Object Explorer}\BR Click this menu option to make
the \l{Object Explorer Window} visible, or to hide it if it is already
visible. If the window is currently visible, a check mark
will appear next to the name in the menu.

\i \Menu{Window|Views|Line Up}\BR Click this menu option to eliminate
any extra space between toolbars and line them up next to each other
all at once, rather than moving each individual toolbar into place.

\i \Menu{Window|Toolbars|File}\BR Click this menu option to make the File
toolbar buttons visible, or to hide them if they are already
visible. If the toolbar buttons are currently visible, a check mark
will appear next to the name in the menu. 

\i \Menu{Window|Toolbars|Edit}\BR Click this menu option to make the Edit
toolbar buttons visible, or to hide them if they are already visible.
If the toolbar buttons are currently visible, a check mark will appear
next to the name in the menu. 

\i \Menu{Window|Toolbars|Search}\BR Click this menu option to make the
Search toolbar buttons visible, or to hide them if they are already
visible. if the toolbar buttons are currently visible, a check mark
will appear next to the name in the menu. 

\i \Menu{Window|Toolbars|Layout}\BR Click this menu option to make the
Layout toolbar buttons visible, or to hide them if they are already
visible. If the toolbar buttons are currently visible, a check mark
will appear next to the name in the menu. 

\i \Menu{Window|Toolbars|Tools}\BR Click this menu option to make the
Tools toolbar buttons visible, or to hide them if they are already
visible. If the toolbar buttons are currently visible, a check mark
will appear next to the name in the menu. 

\i \Menu{Window|Toolbars|Buttons}\BR Click this menu option to make the
Buttons toolbar buttons visible, or to hide them if they are already
visible. If the toolbar buttons are currently visible, a check mark
will appear next to the name in the menu. 

\i \Menu{Window|Toolbars|Containers}\BR Click this menu option to make the
Containers toolbar buttons visible, or to hide them if they are
already visible. If the toolbar buttons are currently visible, a check
mark will appear next to the name in the menu. 

\i \Menu{Window|Toolbars|Views}\BR Click this menu option to make the
Views toolbar buttons visible, or to hide them if they are already
visible. If the toolbar buttons are currently visible, a check mark
will appear next to the name in the menu. 

\i \Menu{Window|Toolbars|Database}\BR Click this menu option to make the
Database toolbar buttons visible, or to hide them if they are already
visible. If the toolbar buttons are currently visible, a check mark
will appear next to the name in the menu. 

\i \Menu{Window|Toolbars|Input}\BR Click this menu option to make the
Input toolbar buttons visible, or to hide them if they are already
visible. If the toolbar buttons are currently visible, a check mark
will appear next to the name in the menu. 

\i \Menu{Window|Toolbars|Display}\BR Click this menu option to make the
Display toolbar buttons visible, or to hide them if they are already
visible. If the toolbar buttons are currently visible, a check mark
will appear next to the name in the menu. 

\i \Menu{Window|Toolbars|Custom}\BR Click this menu option to make the
Custom toolbar buttons visible, or to hide them if they are already
visible. If the toolbar buttons are currently visible, a check mark
will appear next to the name in the menu. 

\i \Menu{Window|Toolbars|Help}\BR Click this menu option to make the Help
toolbar buttons visible, or to hide them if they are already visible.
If the toolbar buttons are currently visible, a check mark will appear
next to the name in the menu. 

\i \Menu{Window|Toolbars|Line Up}\BR Click this menu option to eliminate
extra space between toolbars and line them up next to each other all
at once, rather than moving each individual toolbar into place.

\i \Menu{Window|n}\BR Click one of the numbered menu options that list
the currently open files and forms to switch to the named file or
form.

\endlist

\img qd-helpmenu.png
\caption The Help Menu

\section1 The Help Menu

This menu is invoked with \Key Alt+H, and provides the following
options:
\list 

\i \Menu{Help|Contents}\BR Click this menu option (or press \Key F1)
to invoke the \l{Qt Assistant} application which provides on-line
help. The on-line help is context sensitive, so you can type the item
you want more information about in the line edit and Qt Assistant will
automatically find it if it is available.

\i \Menu{Help|Manual}\BR Click this menu option (or press \Key Ctrl+M) to
invoke the \l{Qt Assistant} application which opens showing this
manual.

\i \Menu{Help|About...}\BR Click this menu option to invoke the About
\QD dialog which gives the version number and some licensing
information.

\i \Menu{Help|About Qt...}\BR Click this menu option to invoke a
dialog which provides information about Qt.

\i \Menu{Help|What's This?}\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 popup box
appears with information about the feature.

\endlist 

See also \l{The Help Toolbar Button}.






























