qt3/doc/html/designer-manual-13.html

<!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-mdialogs.leaf:3 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Reference: Dialogs</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-12.html">Prev: Reference: Toolbar Buttons</a>] [<a href="designer-manual.html">Home</a>] [<a href="designer-manual-14.html">Next: Reference: Wizards</a>]</p>
<h2 align="center">Reference: Dialogs</h2>
<a name="reference-dialogs"></a><h3><a name="1"></a>Introduction</h3>
<p>This chapter describes and explains every <em>Qt Designer</em> dialog.</p>
<h3><a name="2"></a>The Menu Dialogs</h3>
<h4><a name="2-1"></a>Qt Designer New/Open Dialog</h4>
<p align="center"><img align="middle" src="mw-startdesign.png" width="584" height="446">
</p>
<blockquote><p align="center"><em>Qt Designer New/Open</em></p></blockquote>
<p>Start up <em>Qt Designer</em> to invoke the <em>Qt Designer New/Open</em> dialog. This dialog contains three tabs to use depending on what you want to do once you start up <em>Qt Designer</em>.</p>
<h5><a name="2-1-1"></a>The New File/Project Tab</h5>
<p>This tab is the default when you start up <em>Qt Designer</em>. Choose to start a new project or to create a file by selecting the appropriate icon from the window. For more information about the different file types available, see the <a href="designer-manual-13.html#3">The File Dialogs</a> section.</p>
<p>Click the "Don't show this dialog in the future" checkbox to hide the dialog the next time you start up <em>Qt Designer</em>.</p>
<h5><a name="2-1-2"></a>The Open File/Project Tab</h5>
<p align="center"><img align="middle" src="rd-startdesigntab2.png" width="584" height="446">
</p>
<blockquote><p align="center"><em>Open File/Project</em></p></blockquote>
<p>Click this tab to open an already existing file or project. The tab shows the current directory and default file type. To choose a different directory, click the 'Look In' combobox. Choose a file and the name will appear in the 'File Name' combobox. To choose a different file type, click the 'File Type' combobox. Click the 'Create New Folder' toolbar button to create a new directory. Click the 'List View' toolbar button to view folders and files in a list with only the names showing. Click the 'Details' toolbar button to view the folders and file names along with their size, type, date, and attributes. Click the Size, Type, Date, or Attributes column headers to sort the folders or files.</p>
<p>Click <b>OK</b> to open the selected file. Click <b>Cancel</b> to leave the dialog without opening a new file.</p>
<h5><a name="2-1-3"></a>The Recently Opened Tab</h5>
<p>This tab displays all of the recently opened files or projects in a window. Select a file or project and then click <b>OK</b> to open it.</p>
<h3><a name="3"></a>The File Dialogs</h3>
<p align="center"><img align="middle" src="mw-newfile.png" width="565" height="330">
</p>
<blockquote><p align="center"><em>New File</em></p></blockquote>
<a name="dialog-file-new"></a><h4><a name="3-1"></a>New File Dialog</h4>
<p>Click <b>File|New</b> (or press <b>Ctrl+N</b>) to invoke the <em>New File</em> dialog. This dialog offers four kinds of files to choose from: C++ Project, Forms, Source files, and Main files.</p>
<p>The 'Insert Into' drop-down combobox lists the open projects, defaulting to the current project. New files are added to the project displayed in this combobox. To add a new file to a different project, choose the project you want to use in the 'Insert Into' combobox.</p>
<p>The 'Dialog' file type is highlighted by default when the <em>New File</em> dialog pops up. Click on the file type you want to use and click <b>OK</b> to create it. Click <b>Cancel</b> to leave the dialog without creating a new file. Note that if you select C++ Project, the 'Insert Into' combobox will be disabled, since it is not possible to insert a new C++ Project into an existing project.</p>
<h5><a name="3-1-1"></a>C++ Project Files</h5>
<p>Click <b>C++ Project</b> to start a new project. This option invokes the <a href="designer-manual-13.html#5-4">Project Settings Dialog</a>. C++ projects are saved as <tt>.pro</tt> files, which include the information <em>Qt Designer</em> needs to manage projects. When you add a form to your project in <em>Qt Designer</em>, it is automatically added to the FORMS section of the project file. The <tt>.pro</tt> file contains the list of forms (<tt>.ui</tt> files) used in the project. <em>Qt Designer</em> reads and writes <tt>.ui</tt> files, e.g. form.ui. The uic (user interface compiler) creates both a header file, e.g. form.h, and an implementation file, e.g. form.cpp, from the <tt>.ui</tt> file.</p>
<h5><a name="3-1-2"></a>Dialog Forms</h5>
<p>Click <b>Dialog</b> to create a plain dialog form. Typically, this type of form is used to present the user with configuration options, or to present related sets of choices, for example, printer setting dialogs and find and replace dialogs.</p>
<h5><a name="3-1-3"></a>Wizard Forms</h5>
<p>Click <b>Wizard</b> to create a wizard form. A wizard is a special type of input dialog that consists of a sequence of dialog pages. A wizard's purpose is to assist a user by automating a task by walking the user through the process step by step. Wizards are useful for complex or infrequently occurring tasks that people may find difficult to learn or do. Initially the wizard form consists of a single dialog page. Use the right click context menu to add additional pages and to change page titles.</p>
<h5><a name="3-1-4"></a>Widget Forms</h5>
<p>Click <b>Widget</b> to create a form whose superclass is QWidget rather than QDialog.</p>
<h5><a name="3-1-5"></a>Main Window Form</h5>
<p>Click <b>Main Window</b> to invoke the <a href="designer-manual-14.html#2">Main Window Wizard</a>. This wizard is used to create actions, menu options and toolbars through which the user can invoke actions. This form is used to create typical main-window style applications.</p>
<h5><a name="3-1-6"></a>Configuration Dialog Form</h5>
<p>Click <b>Configuration Dialog</b> creates a form with a listbox on the left, and a tabwidget filling the body of the form, along with Help, OK and Cancel buttons.</p>
<h5><a name="3-1-7"></a>Dialog with Buttons (Bottom) Form</h5>
<p>The <b>Dialog with Buttons (Bottom)</b> form is a template with default buttons at the bottom of the form.</p>
<h5><a name="3-1-8"></a>Dialog with Buttons Form (Right)</h5>
<p>The <b>Dialog with Buttons (Right)</b> form is a template with default buttons at the right of the form.</p>
<h5><a name="3-1-9"></a>Tab Dialog Form</h5>
<p>The <b>Tab Dialog</b> form has a tab widget as its central widget, along with Help, OK and Cancel buttons along the bottom.</p>
<h5><a name="3-1-10"></a>C++ Source File</h5>
<p>Click <b>C++ Source File</b> to create a new empty C++ file. The file will automatically be added to the project when it is saved.</p>
<h5><a name="3-1-11"></a>C++ Header File</h5>
<p>Click <b>C++ Header File</b> to create a new empty C++ header file. The file will automatically be added to the project when it is saved.</p>
<h5><a name="3-1-12"></a>C++ Main File</h5>
<p>Click <b>C++ Main File</b> to invoke the <a href="designer-manual-13.html#3-1-12-1">Configure Main-File Dialog</a> which will create a basic <tt>main.cpp</tt> file automatically. C++ Main file is not an option if you do not have a project open. In addition, this file type is not avalable in the <em>Qt Designer New/Open</em> dialog because you cannot create a main.cpp file without creating a project.</p>
<a name="dialog-configure-main-file"></a><h6><a name="3-1-12-1"></a>Configure Main-File Dialog</h6>
<p align="center"><img align="middle" src="rd-configmf.png" width="316" height="309">
</p>
<blockquote><p align="center"><em>Configure Main-File</em></p></blockquote>
<p>Click <b>File|New|C++ Main-File</b> to invoke the <em>Configure Main-File</em> dialog. Use this dialog to configure the main file and its forms.</p>
<p>To change the default file name, type it in the 'Filename' line edit. Choose the form to use as the application's main form from the line edit by clicking it.</p>
<p>Click <b>OK</b> to accept the configurations and <em>Qt Designer</em> will create a default <tt>main.cpp</tt> file. Click <b>Cancel</b> to leave the dialog.</p>
<p>Note for database programmers: If you create a <tt>main.cpp</tt> file using <em>Qt Designer</em>, this file will <em>not</em> include the <tt>createConnections()</tt> function. We do not include this function because it needs the username and password for the database connection, and you may prefer to handle these differently from our simple example function. As a result, applications that preview correctly in <em>Qt Designer</em> will not run unless you implement your own database connections function.</p>
<a name="dialog-file-open"></a><h4><a name="3-2"></a>File Open Dialog</h4>
<p align="center"><img align="middle" src="rd-open.png" width="550" height="344">
</p>
<blockquote><p align="center"><em>File Open</em></p></blockquote>
<p>Click <b>File|Open</b> (or press<b>Ctrl+O</b>) to invoke the <em>Open</em> dialog. Use this dialog to open existing files.</p>
<p>The <em>Open</em> dialog shows the current directory and default file type. To choose a different directory, click the 'Look In' combobox. Choose a file and the name will appear in the 'File Name' combobox. To choose a different file type, click the 'File Type' combobox. Click the 'Create New Folder' toolbar button to create a new directory. Click the 'List View' toolbar button to view folders and files in a list with only the names showing. Click the 'Details' toolbar button to view the folders and file names along with their size, type, date, and attributes. Click the Size, Type, Date, or Attributes column headers to sort the folders or files.</p>
<p>Click <b>Open</b> to open the selected file. Click <b>Cancel</b> to leave the dialog without opening a new file.</p>
<p>Note: For Windows, the System File Dialogs are used.</p>
<a name="dialog-file-save-as"></a><h4><a name="3-3"></a>Save As Dialog</h4>
<p align="center"><img align="middle" src="rd-saveas.png" width="455" height="325">
</p>
<blockquote><p align="center"><em>Save As Dialog</em></p></blockquote>
<p>Click <b>File|Save As</b> to invoke the <em>Save As</em> dialog. Use this dialog to save files to a directory.</p>
<p>The <em>Save As</em> dialog shows the current directory and default file type. To choose a different directory, click the 'Look In' combobox. Choose a file and the name will appear in the 'File Name' combobox. To choose a different file type, click the 'File Type'combobox. Click the 'Create New Folder' toolbar button to create a new directory. Click the 'List View' toolbar button to view folders and files in a list with only the names showing. Click the 'Details' toolbar button to view the folders and file names along with their size, type, date, and attributes. Click the Size, Type, Date, or Attributes column headers to sort the folders or files.</p>
<p>Click <b>Save</b> to save the selected file. Click <b>Cancel</b> to leave the dialog without saving the file.</p>
<p>Note: For Windows, the System File Dialogs are used.</p>
<a name="dialog-save-form-as"></a><h4><a name="3-4"></a>Save Form As Dialog</h4>
<p align="center"><img align="middle" src="rd-saveformas.png" width="496" height="319">
</p>
<blockquote><p align="center"><em>Save Form As</em></p></blockquote>
<p>Click <b>File|Save As</b> to invoke the <em>Save Form As</em> when saving a form.</p>
<p>The <em>Save Form As</em> dialog shows the current directory and the default file type. To choose a different directory, click the 'Look In' combobox. Choose a file and the name will appear in the 'File Name' combobox. To choose a different file type, click the 'File Type'combobox. Click the 'Create New Folder' toolbar button to create a new directory. Click the 'List View' toolbar button to view folders and files in a list with only the names showing. Click the 'Details' toolbar button to view the folders and file names along with their size, type, date, and attributes. Click the Size, Type, Date, or Attributes column headers to sort the folders or files.</p>
<p>Click <b>Save</b> to save the selected form. Click <b>Cancel</b> to leave the dialog without saving the form.</p>
<a name="dialog-file-create-template"></a><h4><a name="3-5"></a>Create Template Dialog</h4>
<p align="center"><img align="middle" src="rd-template.png" width="355" height="274">
</p>
<blockquote><p align="center"><em>Create Template Dialog</em></p></blockquote>
<p>Click <b>File|Create Template</b> to invoke the <em>Create Template</em> dialog. Use this dialog to create templates.</p>
<p>The 'Template Name' line edit defaults to 'New Template'. To change the name to a different name, type it in the line edit. Click the 'Baseclass for Template' scroll bar to choose a base class for the template.</p>
<p>Click <b>Create</b> to create the template. Click <b>Cancel</b> to leave the dialog without creating a template.</p>
<p>If you create a template it will appear in the <a href="designer-manual-13.html#3-1">New File Dialog</a>. Templates are useful when you have to produce a large number of similar forms, or where you want to 'brand' your forms.</p>
<h3><a name="4"></a>The Edit Dialogs</h3>
<a name="dialog-edit-slots"></a><h4><a name="4-1"></a>Edit Functions Dialog</h4>
<p align="center"><img align="middle" src="qs-editfunc.png" width="608" height="397">
</p>
<blockquote><p align="center"><em>Edit Functions</em></p></blockquote>
<p>Click <b>Edit|Slots</b> to invoke the <em>Edit Functions</em> dialog. Use this dialog to edit or create slots and functions which are used in conjunction with signals to provide communication between objects.</p>
<p>When this dialog is invoked, all existing slots and functions are shown in the listview. The column headers Function, Return Type, Specifier, Access, Type, and In Use provide details about each function that is listed. Click on any of the column headers to sort the functions. To create a new function, click the <b>New Function</b> button. The new function has a default name that you should replace by typing the new name in the 'Function' line edit. The 'Return Type' is also a default that can be changed by typing in the line edit. To change the 'Specifier' or 'Access', click the combobox and choose the required specifier or access. To change the type of a function (function or slot), click the Type combobox. To remove a function, click the function you want to delete, and then click the <b>Delete Function</b> button.</p>
<p>Click <b>OK</b> to save all changes made to the functions. Click <b>Cancel</b> to leave the dialog without making any changes to the functions.</p>
<a name="dialog-view-connections"></a><h4><a name="4-2"></a>View and Edit Connections Dialog</h4>
<p align="center"><img align="middle" src="qs-editconn1.png" width="608" height="391">
</p>
<blockquote><p align="center"><em>View and Edit Connections</em></p></blockquote>
<p>Click <b>Edit|Connections</b> to invoke the <em>View and Edit Connections</em> dialog. This dialog is also accessed by right-clicking any of the widgets. Use this dialog to view and edit signal and slot connections.</p>
<p>When this dialog is invoked, all existing connections are shown in the listbox. The column headers Sender, Signal, Receiver, and Slot provide details about each connection. Click the column headers to sort the connections. To add a new connection, click the <b>New</b> button. To specify the Sender, Signal, Receiver, and Slot of the connection, click the appropriate fields in the connection and select from the combobox. To delete connections, select the connection(s) and then click the <b>Delete</b> button. To edit custom slots for the current form, choose the form as the Receiver in the currently selected connection and then click the <b>Edit Slots</b> button. This will invoke the <em>Edit Functions</em> dialog.</p>
<p>Click <b>OK</b> to save all changes made to the connections. Click <b>Cancel</b> to leave the dialog without making any changes to the connections.</p>
<a name="dialog-edit-form-settings"></a><h4><a name="4-3"></a>Form Settings Dialog</h4>
<p align="center"><img align="middle" src="rd-formset.png" width="605" height="484">
</p>
<blockquote><p align="center"><em>Form Settings</em></p></blockquote>
<p>Click <b>Edit|Form Settings</b> to invoke the <em>Form Settings</em> dialog. Use this dialog to save the form's settings, pixmap, and layout properties.</p>
<h5><a name="4-3-1"></a>Settings</h5>
<p>In the Settings section, you can change or add the name of the class that will be created by typing in the 'Class Name' line edit. Note that the default name is the form name, but it can be changed. You can also enter text to the 'Comment' and 'Author' line edits or leave them blank, since they are not required.</p>
<h5><a name="4-3-2"></a>Pixmaps</h5>
<p>The default (for projects) is 'Project Imagefile'. This is the recommended option. Images are handled automatically, with <em>Qt Designer</em> storing the images in a subdirectory, and <tt>uic</tt> producing code that contains the images and the necessary supporting code. Each image is stored just once, no matter how many forms it is used in.</p>
<p>If you do not want <em>Qt Designer</em> to handle the images, (or are not using a project) choose either 'Save Inline' or 'Use Function'. 'Save Inline' saves the pixmaps in the <tt>.ui</tt> files. The disadvantage of this approach is that it stores images in the forms in which they're used, meaning that images cannot be shared across forms. Click 'Use Function' to use your own icon-loader function for loading pixmaps. Type the function's name (with no signature) in the 'Use Function' line edit. This function will be used in the generated code for loading pixmaps. Your function will be called with the text you put in the pixmap property (e.g. the image name) whenever an image is required.</p>
<h5><a name="4-3-3"></a>Layouts</h5>
<p>Click the 'Default Margin' spinbox or the 'Default Spacing' spinbox to change the default layout settings of the current form.</p>
<p>To use the functions in the generated code to dynamically retrieve values for the layout's default margin and spacing, check the Use Functions chechbox. In the Margin and Spacing line edits, specify the function names (no signatures or parantheses) which should be used to retrieve the margin and spacing.</p>
<p>Click <b>OK</b> to accept changes to the form settings. Click <b>Cancel</b> to leave the dialog without making any changes.</p>
<a name="dialog-edit-preferences"></a><h4><a name="4-4"></a>Preferences Dialog</h4>
<p>Click <b>Edit|Preferences</b> to invoke the <em>Preferences</em> dialog. This dialog has a tab for 'General' preferences. If you have the C++ Editor plugin, the dialog will also have a tab for the C++ Editor.</p>
<h5><a name="4-4-1"></a>General Tab</h5>
<p align="center"><img align="middle" src="qd-preferences-dlg.png" width="708" height="617">
</p>
<blockquote><p align="center"><em>Preferences- General Tab</em></p></blockquote>
<p>The 'General' tab has sections for Background, Grid, General, File Saving, and Plugin Paths.</p>
<p>The Background section defaults to 'Pixmap'. To change the default, click the <b>Select a Pixmap</b> button next to the 'Pixmap' radio button to invoke the <em>Choose a Pixmap... Dialog</em>. Click the 'Color' radio button to change the background to a color instead of a pixmap. Click the <b>Choose a Color</b> button located to the right of the 'Color' radio button to invoke the <em>Select Color Dialog</em>.</p>
<p>The 'Grid' section has options for customizing the grid on the form. The 'Show Grid' checkbox located above the 'Grid' section is checked by default. Developers using <em>Qt Designer</em> almost always use Qt's layouts to design their forms and rarely make any use of the grid. The grid is provided for the rare occasions when a form is created using widgets with fixed sizes and positions. When 'Show Grid' is checked, you can customize the grid's appearance. When it is unchecked, the 'Grid' section is disabled. The 'Snap to Grid' checkbox is also checked by default. When it is checked, widgets are placed on a dot (snap to the grid) using the X|Y resolution. When it is unchecked, the 'Grid-X' and 'Grid-Y' spin boxes are disabled. Click the 'Grid X' and 'Grid Y' spinboxes to customize the grid settings for all forms.</p>
<p>The 'General' section of the General tab has four checkboxes. Check the 'Restore last workspace on startup' checkbox to save the size and positions of the windows and toolbars of <em>Qt Designer</em>. The next time you start up <em>Qt Designer</em>, the windows and toolbars are restored to their last positions. Check the 'Show Splash Screen on startup' checkbox to display the <em>Qt Designer</em> splash screen when you start up the application. Check the 'Disable Database Auto-Edit in Preview' checkbox to disable the ability to update or delete data in the database to which you are connected when working with database widgets. Check the 'Show Toolbutton Label's to have textual labels appear beneath <em>Qt Designer</em>'s toolbar buttons.</p>
<p>If you want <em>Qt Designer</em> to automatically save files check 'Enable Auto Save', and set a time interval.</p>
<p><em>Qt Designer</em> loads the plugins found in its plugin paths. If you want to add your own custom plugin paths, simply enter them (one per line) in the plugin paths multi-line editor.</p>
<h5><a name="4-4-2"></a>C++ Editor Tab</h5>
<p align="center"><img align="middle" src="rd-prefedit1.png" width="480" height="488">
</p>
<blockquote><p align="center"><em>Preferences- C++ Editor Tab</em></p></blockquote>
<p>The C++ Editor tab provides options for customizing the editor. The 'Syntax Highlighting' section lets you change the way the syntax is viewed in the editor. Click the 'Element' listbox and choose an element. Click the 'Family' listbox to change the font style for that element. Click the 'Size' spinbox to choose a font size. You can change the font to Bold, Italic, or Underline by clicking the corresponding checkbox. Note, that all the fonts used derive from the 'Standard' element, so if you want to change the font used for everything, change the 'Standard' element. Click the <b>Color</b> button to invoke the <em>Select Color Dialog</em>. As you make changes to each element, you can view the changes in the 'Preview' line edit.</p>
<p>The 'Options' section has the Wordwrap, Completion, and Parentheses Matching checkboxes checked by default. Click the checkboxes to de-select them.</p>
<p>Click <b>OK</b> to accept changes to <em>Preferences</em> dialog. Click <b>Cancel</b> to leave the dialog without making any changes.</p>
<h3><a name="5"></a>The Project Dialogs</h3>
<a name="dialog-add"></a><h4><a name="5-1"></a>Add Dialog</h4>
<p align="center"><img align="middle" src="rd-add.png" width="550" height="344">
</p>
<blockquote><p align="center"><em>Add Dialog</em></p></blockquote>
<p>Click <b>Project|Add File</b> to invoke the <em>Add</em> dialog. Use this dialog to add files to the current project.</p>
<p>The <em>Add</em> dialog defaults the directory and file type. To choose a different directory, click the 'Look In' combobox. Choose a file and the name will appear in the 'File Name' combobox. To choose a different file type, click the 'File Type' combobox. Click the 'Create New Folder' toolbar button to create a new directory. Click the 'List View' toolbar button to view folders and files in a list with only the names showing. Click the 'Details' toolbar button to view the folders and file names along with their size, type, date, and attributes. Click the Size, Type, Date, or Attributes column headers to sort the folders or files.</p>
<p>Click <b>Open</b> to open the selected file. Click <b>Cancel</b> to leave the dialog without opening a file.</p>
<a name="dialog-image-collection"></a><h4><a name="5-2"></a>Manage Image Collection Dialog</h4>
<p align="center"><img align="middle" src="rd-image.png" width="464" height="286">
</p>
<blockquote><p align="center"><em>Manage Image Collection</em></p></blockquote>
<p>Click <b>Project|Image Collection</b> to invoke the <em>Manage Image Collection Dialog</em>. Use this dialog to view the project's images, add new images, or delete images.</p>
<p>To add an image, click the <b>Add</b> button to invoke the <em>Choose Images... Dialog</em>.</p>
<p>The Choose Images dialog shows the current the directory and the default file type. To choose a different directory, click the 'Look In' combobox. Choose a file and the name will appear in the 'File Name' combobox. To choose a different file type, click the 'File Type'combobox. As you choose different files, you can preview the images in the window located on the right side of the dialog. Click the 'Create New Folder' toolbar button to create a new directory. Click the 'List View' toolbar button to view folders and files in a list with only the names showing. Click the 'Details' toolbar button to view the folders and file names along with their size, type, date, and attributes. Click the Size, Type, Date, or Attributes column headers to sort the folders or files. Click <b>Open</b> to open the selected file. Click <b>Cancel</b> to leave the dialog without opening a file.</p>
<p>To delete an image from from the iconview, click the image and then click the <b>Delete</b> button.</p>
<p>Changes made to the image collection are applied immediately. Click the <b>Close</b> button to leave the dialog.</p>
<a name="dialog-edit-database-connections"></a><h4><a name="5-3"></a>Edit Database Connections Dialog</h4>
<p align="center"><img align="middle" src="rd-dbconn.png" width="520" height="352">
</p>
<blockquote><p align="center"><em>Edit Database Connections</em></p></blockquote>
<p>Click <b>Project|Database Connections</b> to invoke the <em>Edit Database Connections Dialog</em>. Use this dialog to connect your project to a database or to edit the current connections.</p>
<p>Click <b>New Connection</b> to create a new database connection. For applications that use a single database it will probably be most convenient to use the default connection name of '(default)'. If you use more than one database then each one must be given a unique name. A driver must be chosen from the Driver combo box. The database name may be available in the Database Name combo box or may have to be typed in. The database name, username, password and hostname should be provided by your database system administrator. When the Connection information has been completed click Connect. If the connection is made the connection name will appear in the list box on the left hand side of the dialog.</p>
<p>To remove a connection, click the connection in the listbox and then click the <b>Delete Connection</b> button.</p>
<p>Click <b>Close</b> to leave the <em>Database Connections</em> dialog.</p>
<a name="dialog-project-settings"></a><h4><a name="5-4"></a>Project Settings Dialog</h4>
<p>Click <b>Project|Project Settings</b> to invoke the <em>Project Settings Dialog</em>. Use this dialog to make changes to the project settings.</p>
<h5><a name="5-4-1"></a>Settings Tab</h5>
<p align="center"><img align="middle" src="rd-projset.png" width="383" height="273">
</p>
<blockquote><p align="center"><em>Project Settings- Settings Tab</em></p></blockquote>
<p>The 'Settings' tab shows information about the project. The Project File line edit defaults the project name. To change the name, type the new name in the line edit or click the <b>(ellipsis)</b> button located next to Project File to invoke the <em>Save As Dialog</em>. The 'Language' combobox is disabled. To change the name in the 'Database File' line edit type the new name in the line edit or click the <b>(ellipsis)</b> button to invoke the <em>Save As Dialog</em>.</p>
<h5><a name="5-4-2"></a>C++ Tab</h5>
<p align="center"><img align="middle" src="rd-projset2.png" width="383" height="273">
</p>
<blockquote><p align="center"><em>Project Settings- C++ Tab</em></p></blockquote>
<p>Click the C++ Tab to change the <tt>qmake</tt> options. See the <a href="qmake-manual.html">qmake documentation</a> for details on what these options mean. Click the 'Template' combobox and choose application or library to create makefiles for building applications or libraries. Click the 'Config' combobox to select the project configuration and compiler options for all platforms, or specific platforms. Type the Config value in the line edit. Note: Unix defaults to a shared library. If you want a shared library in Windows, type 'dll' at the end of the default config command and make sure you select lib from the Template combobox. Click the 'Libs' combobox to select a platform. Type the libraries in the line edit. Click the 'Defines' combobox and select a platform. 'Defines' values are added as compiler pre-processor macros. Type the 'Defines' values in the line edit. Click the 'Includepath' combobox to select a platform. Includepath specifies the directories that should be searched for include files when compiling the project. Type the 'Includepath' values in the line edit.</p>
<p>Cick <b>OK</b> to accept changes to the project settings. Click <b>Cancel</b> to exit the dialog without making any changes to the project settings.</p>
<h3><a name="6"></a>The Search Dialogs</h3>
<a name="dialog-find-text"></a><h4><a name="6-1"></a>Find Text Dialog</h4>
<p align="center"><img align="middle" src="rd-find.png" width="293" height="219">
</p>
<blockquote><p align="center"><em>Find Text</em></p></blockquote>
<p>Click <b>Search|Find</b> (or press <b>Ctrl+F</b>) to invoke the <a href="designer-manual-13.html#6-1">Find Text Dialog</a>. Use this dialog to find specific text in a project file.</p>
<p>To find the text you want in a file, type the text in the 'Find' combobox. You can make the search more specific by checking any or all of the checkboxes in the 'Options' section. Click the 'Whole words only' checkbox to narrow the search to whole words. Click 'Case Sensitive' to search for text that is identical to the text typed in the combobox. Click 'Start at Beginning' to start the search from the beginning of the file. The 'Direction' section offers the 'Forward' radio button and the 'Backward' radio button to specify the direction to perform the search in the file. Click the <b>Find</b> button to start the search. When the text is found, it is highlighted in the file. Continue clicking <b>Find</b> to search for subsequent occurrences of the search text.</p>
<p>Click the <b>Close</b> button to leave the dialog.</p>
<a name="dialog-replace-text"></a><h4><a name="6-2"></a>Replace Text Dialog</h4>
<p align="center"><img align="middle" src="rd-replace.png" width="294" height="248">
</p>
<blockquote><p align="center"><em>Replace Text</em></p></blockquote>
<p>Click <b>Search|Replace</b> (or press <b>Ctrl+R</b>) to invoke the <em>Replace Text Dialog</em>. Use this dialog to replace text in a project file.</p>
<p>To replace text, type the text you would like to replace in the 'Find' combobox. Type the new text in the 'Replace' combobox. You can make the search more specific by checking any or all of the checkboxes in the 'Options' section. Click the 'Whole words only' checkbox to narrow the search to whole words. Click 'Case Sensitive' to search for text that identical to the text you typed in the combobox. Click 'Start at Beginning' to start the search from the beginning of the file. The 'Direction' section offers the 'Forward' radio button and the 'Backward' radio button to specify the direction to perform the search in the file.</p>
<p>Click the <b>Replace</b> button to search and replace the text. When the text is found, it is highlighted in the file. Continue clicking <b>Replace</b> button to search and replace each occurrence of the text in the file. Click <b>Replace All</b> button to replace all occurences of the search text in the file at once.</p>
<p>Click the <b>Close</b> button to leave the dialog.</p>
<a name="dialog-go-to-line"></a><h4><a name="6-3"></a>Goto Line Dialog</h4>
<p align="center"><img align="middle" src="rd-goto.png" width="251" height="111">
</p>
<blockquote><p align="center"><em>Goto Line</em></p></blockquote>
<p>Click <b>Search|Goto line</b> (or press <b>Alt+G</b>) to invoke the <em>Goto Line Dialog</em>. Use this dialog to go to a specific line in the file.</p>
<p>To choose a line number, type the number in the 'Line' spinbox, or click the up and down arrows in the spinbox. Click the <b>Goto</b> button. The cursor is placed at the beginning of the line in the file.</p>
<p>Click the <b>Close</b> button to leave the dialog.</p>
<h3><a name="7"></a>The Tools Dialog</h3>
<a name="dialog-edit-custom-widgets"></a><h4><a name="7-1"></a>Edit Custom Widgets Dialog</h4>
<p>The <em>Edit Custom Widgets</em> dialog is invoked by clicking <b>Tools|Custom|Edit Custom Widgets</b>. Use this dialog to create custom widgets.</p>
<p>Custom widgets are created in code. They may contain a combination of existing widgets but with additional functionality, slots and signals, or they may be written from scratch, or a mixture of both. A custom widget is often a specialization (subclass) of another widget or a combination of widgets working together or a blend of both these approaches. If you simply want a collection of widgets in a particular configuration it is easiest to create them, select them as a group, and copy and paste them as required within <em>Qt Designer</em>. Custom widgets are generally created when you need to add new functionality to existing widgets or groups of widgets. To add create a new widget, click the <b>New Widget</b> button. You will find more information about adding new widgets in the 'Definitions Section'. To load a file which contains descriptions of custom widgets, click the <b>Load Descriptions</b> button. Clicking this button invokes the <em>Open Dialog</em>. To save the descriptions of the listed custom widgets, click the <b>Save Descriptions</b> button, which invokes the <em>Save As Dialog</em>. To delete a widget, click the widget in the listbox and then click the <b>Delete Widget</b> button.</p>
<p>Click <b>Close</b> to leave the Edit Custom Widgets dialog.</p>
<h5><a name="7-1-1"></a>The Definition Tab</h5>
<p align="center"><img align="middle" src="rd-cwidgdef.png" width="720" height="412">
</p>
<blockquote><p align="center"><em>Edit Custom Widgets- Definition Tab</em></p></blockquote>
<p>To create a custom widget, click <b>New Widget</b>. Click the Definition tab if you are not already there. You should change the 'Class' name from 'MyCustomWidget' to a unique name by typing in the line edit. Type in the 'Headerfile' line edit to change the name or type the name of a header file you want to use. To search for a saved header file in a directory, click the <b>(ellipsis)</b> button to the right of the Headerfile line edit to invoke the <em>Open Dialog</em>. Click the 'Select Access' combobox to choose how the file will be included. Global include files will be included using angle brackets (&lt;&gt;). Local files will be included using quotation marks. If you have a pixmap that you want to use to identify your widget on the toolbar, click the <b>(ellipsis)</b> button to the right of the 'Pixmap' label. This invokes the <em>Choose a Pixmap Dialog</em>. Click the 'Size Hint' spin boxes to select the recommended size for the widget. If you do not want to have a recommended size, enter -1/-1 in the spinboxes. Click the 'Size Policy' comboboxes to select the vertical size properties of the widget. Click the 'Container Widget' checkbox if the custom widget you are creating should be able to contain other widgets (children).</p>
<h5><a name="7-1-2"></a>The Signals Tab</h5>
<p align="center"><img align="middle" src="rd-cwidgsig.png" width="720" height="412">
</p>
<blockquote><p align="center"><em>Edit Custom Widgets- Signals Tab</em></p></blockquote>
<p>Click the Signals tab to view a list of all the signals the selected custom widget can emit. To add a new signal, click the <b>New Signal</b> button. Click the 'Signal' line edit and provide an argument for the signal and give the signal a unique name. To delete a signal from the listbox, click the signal to choose it and then click the <b>Delete Signal</b> button.</p>
<h5><a name="7-1-3"></a>The Slots Tab</h5>
<p align="center"><img align="middle" src="rd-cwidgslot.png" width="720" height="412">
</p>
<blockquote><p align="center"><em>Edit Custom Widgets- Slots Tab</em></p></blockquote>
<p>Click the Slots tab to view a list of all the slots for the selected custom widget. Click the 'Slot' or 'Access' cloumn headers to sort the slots in the listbox. To add a slot, click the <b>New Slot</b> button. Click the 'Slot' line edit and provide an argument for the slot and give the slot a unique name. Click the 'Access' combobox to choose between public or protected access for your widget. To delete a slot from the listbox, click the slot and then click <b>Delete Slot</b>.</p>
<h5><a name="7-1-4"></a>The Properties Tab</h5>
<p align="center"><img align="middle" src="rd-cwidgprop.png" width="720" height="412">
</p>
<blockquote><p align="center"><em>Edit Custom Widgets- Properties Tab</em></p></blockquote>
<p>Click the Properties tab to view the list of properties for the selected widget. Click the 'Property' or 'Type' column headers to sort the properties in the listbox. To add a property, click the <b>New Property</b> button. Click the 'Property Name' line edit if you want to change the default name of the property. Note that properties must be implemented in the class using the property system of Qt. To choose a property type, click the 'Type' combobox. To delete a property from the listbox, click the property and then click the <b>Delete Property</b> button.</p>
<p>Click <b>Close</b> to leave the <em>Edit Custom Widgets</em> dialog.</p>
<a name="dialog-configure-toolbox"></a><h4><a name="7-2"></a>Configure Toolbox Dialog</h4>
<p align="center"><img align="middle" src="rd-configtb.png" width="411" height="438">
</p>
<blockquote><p align="center"><em>Configure Toolbox</em></p></blockquote>
<p>Click <b>Tools|Configure Toolbox</b> to invoke the <em>Configure Toolbox Dialog</em>. This dialog is used to view a list of available tools and a list of the tools in the Common Widgets category in the toolbox. To add widgets to the Common Widgets category, click a widget from the Available Widgets list and then click the <b>Add</b>. The selected widget now appears in the Common Widgets category. To remove a widget from the Common Widgets list, click a widget, then click <b>Remove</b>. To move a widget up or down in the Common Widgets list, click the up or down arrows.</p>
<p>Click <b>OK</b> to accept the configurations to the toolbox. Click <b>Cancel</b> to leave the dialog.</p>
<h3><a name="8"></a>The Help Dialogs</h3>
<a name="dialog-qt-designer"></a><h4><a name="8-1"></a>About Qt Designer Dialog</h4>
<p>Click <b>Help|About</b> to invoke the <em>About Qt Designer Dialog</em>. This dialog provides information about <em>Qt Designer</em> such as the version, the licensing terms, conditions, and disclaimers.</p>
<p>Click the 'x' located at the top right corner of the dialog to close the dialog.</p>
<a name="dialog-qt-designer"></a><h4><a name="8-2"></a>About Qt Dialog</h4>
<p>Click <b>Help|About Qt</b> to invoke the <em>About Qt Dialog</em>. This dialog provides information about Qt.</p>
<p>Click the 'x' located at the title of the dialog to close the dialog.</p>
<h3><a name="9"></a>The Widget Dialogs</h3>
<h4><a name="9-1"></a>Edit Text Dialog</h4>
<p align="center"><img align="middle" src="rd-edittext1.png" width="606" height="333">
</p>
<blockquote><p align="center"><em>Edit Text</em></p></blockquote>
<p>The <em>Edit Text</em> dialog is invoked by right-clicking the following widgets: TextEdit, TextLabel, and PixmapLabel and selecting <b>Edit Text</b>.</p>
<p>Use this dialog to apply HTML formatting to your text using the format toolbars and menus.</p>
<p>Click <b>OK</b> to accept the text and formatting. Click <b>Cancel</b> to leave the dialog without saving any text or formatting.</p>
<h4><a name="9-2"></a>Edit Text Dialog</h4>
<p align="center"><img align="middle" src="rd-edittext2.png" width="606" height="333">
</p>
<blockquote><p align="center"><em>Edit Text</em></p></blockquote>
<p>The <em>Edit Text</em> dialog is invoked by right-clicking the following widgets: PushButton, RadioButton, CheckBox, and ToolButton and selecting <b>Edit Text</b>.</p>
<p>Use this dialog to change the widget's text.</p>
<p>Click <b>OK</b> to accept changes to the text. Click <b>Cancel</b> to leave the dialog without making changes to the text.</p>
<a name="dialog-text"></a><h4><a name="9-3"></a>Text Dialog</h4>
<p align="center"><img align="middle" src="rd-text.png" width="408" height="117">
</p>
<blockquote><p align="center"><em>Text Dialog</em></p></blockquote>
<p>The <em>Text</em> dialog is invoked by right-clicking the LineEdit widget.</p>
<p>Used this dialog to change the line edit's text.</p>
<p>Click <b>OK</b> to accept changes to the text. Click <b>Cancel</b> to leave the dialog without making changes to the text.</p>
<a name="dialog-title"></a><h4><a name="9-4"></a>Title Dialog</h4>
<p align="center"><img align="middle" src="rd-title.png" width="408" height="117">
</p>
<blockquote><p align="center"><em>Title Dialog</em></p></blockquote>
<p>The <em>Title</em> dialog is invoked by right-clicking the following widgets: ButtonGroup and GroupBox and selecting <b>Edit Title</b>.</p>
<p>Use this dialog to change the title of a selected widget by typing the new title in the line edit.</p>
<p>Click <b>OK</b> to accept changes to the title. Click <b>Cancel</b> to leave the dialog without making changes to the title.</p>
<a name="dialog-dialog-page-title"></a><h4><a name="9-5"></a>Page Title Dialog</h4>
<p align="center"><img align="middle" src="rd-pagetitle.png" width="408" height="117">
</p>
<blockquote><p align="center"><em>Page Title Dialog</em></p></blockquote>
<p>The <em>Page Title</em> dialog is invoked by right clicking the TabWidget and selecting <b>Edit Page Title</b>.</p>
<p>Use this dialog to change the title of each tab in the Tab widget.</p>
<p>Click <b>OK</b> to accept new page titles. Click <b>Cancel</b> to leave the dialog without making any changes.</p>
<a name="dialog-choose-an-image"></a><h4><a name="9-6"></a>Choose an Image Dialog</h4>
<p align="center"><img align="middle" src="rd-chooseanimage.png" width="464" height="286">
</p>
<blockquote><p align="center"><em>Choose an Image</em></p></blockquote>
<p>The <em>Choose an Image</em> dialog is used to choose an image to use for a widget.</p>
<p>To choose an image from the listbox, click the image and then click <b>OK</b>. To add an image, click the <b>Add</b> button to invoke the <em>Choose Images... Dialog</em>. To delete an image, click the image in the listbox and then click the <b>Delete</b> button.</p>
<p>Click <b>Cancel</b> to leave the dialog without making any changes to images.</p>
<a name="dialog-edit-listbox"></a><h4><a name="9-7"></a>Edit Listbox Dialog</h4>
<p align="center"><img align="middle" src="rd-edlistbox.png" width="490" height="255">
</p>
<blockquote><p align="center"><em>Edit Listbox</em></p></blockquote>
<p>The <em>Edit Listbox</em> dialog is invoked by right-clicking the Listbox widget and selecting <b>Edit</b>.</p>
<p>Use this dialog to add items to the list box and to change the item's properties.</p>
<p>To add an item to the listbox, click the <b>New Item</b>. If you want to change the default name of the item, click the 'Text' line edit in the 'Item Properties' section and type a new name for the item. Click the <b>Select a Pixmap</b> to invoke the <em>Choose an Image Dialog</em>. Click a pixmap and then click the <b>Delete Pixmap</b> button to delete the selected pixmap. To delete an item from the listbox, click the item and then click the <b>Delete</b> button. To move an item up or down in the listbox, click the <b>Move Up</b> or <b>Move Down</b> buttons. Click <b>Apply</b> to accept the changes.</p>
<p>Click <b>Apply</b> to accept changes to the listbox widget. Click <b>OK</b> to leave the dialog once the changes have been accepted. Click <b>Cancel</b> to leave the dialog without saving any changes.</p>
<a name="dialog-edit-listview"></a><h4><a name="9-8"></a>Edit Listview</h4>
<p>The <em>Edit Listview</em> dialog is invoked by right-clicking the listview widget and selecting <b>Edit</b>.</p>
<p>Use this dialog to add items to the listview. The <em>Edit</em> Listview dialog has two tabs, one for items and one for columns.</p>
<h5><a name="9-8-1"></a>The Items Tab</h5>
<p align="center"><img align="middle" src="rd-edlistview.png" width="575" height="424">
</p>
<blockquote><p align="center"><em>Edit Listview- Items Tab</em></p></blockquote>
<p>The dialog defaults to the Items tab. Use this tab to add, change, or remove items in the listview. To add a new item, click the <b>New Item</b> button. The new item is shown at the top of the listbox. To add sub-items to an existing item, click the item and then click the <b>New Subitem</b> button. Click the 'Column' spinbox to choose a column for which the item text or pixmap will be placed. Click the 'Text' line edit to type text for a column, or to change the name of an item or subitem. Click a pixmap and then click the <b>Delete Pixmap</b> button to delete the selected pixmap. To delete an item from the listbox, click the item and then click the <b>Delete</b> button. To move an item up or down within the hierarchy level, click the <b>Move Up</b> or <b>Move Down</b> buttons. To move an item up or down one level, click the <b>Move Left</b> or <b>Move Right</b> buttons.</p>
<h5><a name="9-8-2"></a>The Columns Tab</h5>
<p align="center"><img align="middle" src="rd-edlistview2.png" width="575" height="424">
</p>
<blockquote><p align="center"><em>Edit Listview- Columns Tab</em></p></blockquote>
<p>Click this tab to change the column configuration of the listview. To add a column, click the <b>New Column</b> button. The new column is shown at the top of the listbox. To change the column name, click a column in the listbox and then click the 'Text' line edit and type a new name. To add a pixmap, click the <b>(ellipsis)</b> button, which invokes the <em>Choose an Image Dialog</em>. To remove a pixmap, click the <b>Delete Pixmap</b> button. Click the 'Clickable' checkbox if you want the columns to respond to mouse clicks. Click the 'Resizeable' checkbox if you want to be able to change the column's width. To remove a column, click the column in the listbox and then click the <b>Delete Column</b> button. To move a column up or down in the listbox, click the <b>Move Up</b> or the <b>Move Down</b> buttons.</p>
<p>Click <b>Apply</b> to accept changes to the listview widget. Click <b>OK</b> to leave the dialog once the changes have been accepted. Click <b>Cancel</b> to leave the dialog without saving any changes.</p>
<a name="dialog-edit-iconview"></a><h4><a name="9-9"></a>Edit Iconview Dialog</h4>
<p align="center"><img align="middle" src="rd-ediconview.png" width="575" height="347">
</p>
<blockquote><p align="center"><em>Edit Iconview</em></p></blockquote>
<p>The <em>Edit Iconview</em> dialog is invoked by right-clicking the iconview widget and selecting <b>Edit</b>.</p>
<p>Use the dialog to add, change, or remove items from the iconview. To add an item to the iconview, click the <b>New Item</b> button. To change the name of the item, click the 'Text' line edit and type a new name. To add a pixmap, click the <b>(ellipsis)</b> button, which invokes the <em>Choose an Image Dialog</em>. To remove a pixmap, click the <b>Delete Pixmap</b> button. To delete an item from the iconview, click the item and then click the <b>Delete Item</b> button.</p>
<p>Click <b>Apply</b> to accept changes to the iconview widget. Click <b>OK</b> to leave the dialog once the changes have been accepted. Click <b>Cancel</b> to leave the dialog without saving any changes.</p>
<a name="dialog-edit-table"></a><h4><a name="9-10"></a>Edit Table Dialog</h4>
<p>The <em>Edit Table</em> dialog is invoked by right-clicking the following widgets: Table and DataTable and selecting 'Edit'.</p>
<p>Use the dialog to add, change, or remove columns or rows from the table.</p>
<h5><a name="9-10-1"></a>The Column Tab</h5>
<p align="center"><img align="middle" src="rd-edtablecol.png" width="492" height="432">
</p>
<blockquote><p align="center"><em>Edit Table- Columns Tab</em></p></blockquote>
<p>To add a column to the table, click the <b>New Column</b> button. To delete a column from the table, click the column you want to delete from the table, or click the column number in the 'Columns' listbox and then click the <b>Delete Column</b> button. To change a column name, click the 'Label' line edit and type the new text. To add a pixmap, click the <b>(ellipsis)</b> button, which invokes the <em>Choose an Image Dialog</em>. To remove a pixmap from the current column of the selected item, click the <b>Delete Pixmap</b> button. To move a column in the listbox, click the <b>Move Up</b> or <b>Move Down</b> buttons.</p>
<h5><a name="9-10-2"></a>The Rows Tab</h5>
<p align="center"><img align="middle" src="rd-edtablerow.png" width="492" height="432">
</p>
<blockquote><p align="center"><em>Edit Table- Rows Tab</em></p></blockquote>
<p>To add a row to the table, click the <b>New Row</b> button. To delete a row from the table, click the row you want to delete from the table, or click the row number in the 'Rows' listbox and then click the <b>Delete Column</b> button. To change a row's name, click the row, or the row number, and then click the 'Label' line edit and type the new text. To add a pixmap, click the <b>(ellipsis)</b> button, which invokes the <em>Choose an Image Dialog</em>. To remove a pixmap from the current row of the selected item, click the <b>Delete Pixmap</b> button. To move a row in the listbox, click the <b>Move Up</b> or <b>Move Down</b> buttons.</p>
<p>Click <b>Apply</b> to accept changes to the table widget. Click <b>OK</b> to leave the dialog once the changes have been accepted. Click <b>Cancel</b> to leave the dialog without saving any changes.</p>
<h3><a name="10"></a>The Property Editor Dialogs</h3>
<a name="dialog-choose-a-pixmap"></a><h4><a name="10-1"></a>Choose a Pixmap Dialog</h4>
<p align="center"><img align="middle" src="rd-chooseapixmap.png" width="496" height="319">
</p>
<blockquote><p align="center"><em>Choose a Pixmap</em></p></blockquote>
<p>The <em>Choose a Pixmap</em> dialog is invoked by clicking the button next to the paletteBackgroundPixmap or the pixmap property in the property editor. It is also invoked by right-clicking the following widgets: PushButton, RadioButton, CheckBox, and ToolButton. In addition, this dialog can also be invoked by right-clicking the following widgets: Table, DataTable, ListBox, ComboBox, ListView, and IconView, and selecting <b>Edit</b> and then choosing the "Select a Pixmap" button.</p>
<p>Use this dialog to select a pixmap to use in the current project.</p>
<p>The <em>Choose a Pixmap</em> dialog shows the current directory and the default file type. To choose a different directory, click the 'Look In' combobox. Choose a file and the name will appear in the 'File Name' combobox. To choose a different file type, click the 'File Type'combobox. Click the 'Create New Folder' toolbar button to create a new directory. Click the 'List View' toolbar button to view folders and files in a list with only the names showing. Click the 'Details' toolbar button to view the folders and file names along with their size, type, date, and attributes. Click the Size, Type, Date, or Attributes column headers to sort the folders or files. View a sample of the pixmap file you select in the preview box located on the right side of the dialog.</p>
<p>Click <b>OK</b> to accept the pixmap file. Click <b>Cancel</b> to leave the dialog without choosing a pixmap file.</p>
<a name="dialog-select-color"></a><h4><a name="10-2"></a>Select Color Dialog</h4>
<p align="center"><img align="middle" src="rd-selcolor.png" width="490" height="397">
</p>
<blockquote><p align="center"><em>Select Color</em></p></blockquote>
<p>The <em>Select Color</em> dialog is invoked by clicking the button next to the paletteForegroundColor and the paletteBackgroundColor properties in the property editor.</p>
<p>Use this dialog to select color preferences or to create color palettes.</p>
<p>Choose a color from the 'Basic Colors' section and a sample of the color will appear in the small preview box at the bottom of the dialog. To the right of the color sample, you will see line edits that have information about the location of the color in the color spectrum. In addition, the crosshairs in the larger color spectrum window show the location of the color. You can also create a palette of custom colors. There are two ways to do add custom colors. Click a color on the color spectrum window. When the color appears in the small box below the window, click the color and drag it to one of the blank boxes in the 'Custom Color' section of the dialog. You can also click and drag colors from the 'Basic Colors' section. Another way to add colors is to click the <b>Add to Custom Colors</b> when you have chosen a color.</p>
<p>Click <b>OK</b> to accept changes to the <em>Select Color</em> dialog. Click <b>Cancel</b> to exit the dialog without selecting a color or adding custom colors.</p>
<a name="dialog-edit-palette"></a><h4><a name="10-3"></a>Edit Palette Dialog</h4>
<p align="center"><img align="middle" src="rd-edpalette.png" width="457" height="469">
</p>
<blockquote><p align="center"><em>Edit Palette</em></p></blockquote>
<p>The <em>Edit Palette</em> dialog is invoked by clicking the button next to the palette property in the property editor.</p>
<p>Use this dialog to change the palette of the current widget or form. You can use a generated palette, or select colors for each color group and each color role. The palette can be tested with different widget layouts in the preview section.</p>
<p>The 'Build Palette' section contains three buttons to help you build the palette. Click the <b>3-D Effects</b> button to invoke the <em>Select Color Dialog</em>. Click the <b>Background</b> to invoke the <em>Select Color Dialog</em>. Click the <b>Tune Palette</b> button to invoke the <em>Tune Palette Dialog</em>. Click the 'Select Palette' combobox in the 'Preview' section to choose a palette to preview.</p>
<p>Click <b>OK</b> to accept the changes to the palette. Click <b>Cancel</b> to leave the dialog without making changes to the palette.</p>
<a name="dialog-tune-palette"></a><h4><a name="10-4"></a>Tune Palette Dialog</h4>
<p align="center"><img align="middle" src="rd-tunepalette.png" width="359" height="378">
</p>
<blockquote><p align="center"><em>Tune Palette</em></p></blockquote>
<p>The <em>Tune Palette</em> dialog is used to choose options for a widget's palette.</p>
<p>Click the 'Select Palette' combobox to choose options for active, inactive, or disabled palettes. If you choose 'Active Palette', the dialog presents three categories used for designing the palette. The categories are the Auto, Central Color Roles, and 3-D Shadow Effects. If you choose 'Inactive Palette' or 'Disabled Palette', all categories are disabled except 'Auto'. Click the 'Auto' section checkboxes to build the inactive or disabled palettes from the active palette. For an active palette, click the 'Central color roles' combobox to select a color role for the palette. Click the <b>Choose Pixmap</b> button to invoke the <em>Choose a Pixmap Dialog</em>. Click the <b>Select Color</b> button to invoke the <em>Select Color Dialog</em>. Check the 'Build from button color' checkbox in the '3-D shadow effects' section to allow 3-D effects colors to be calculated from the button color. Uncheck the checkbox to enable the 'Choose 3-D effect color role' combobox. Click the combobox to select a color role for the 3-D effects. Click the <b>Select Color</b> button to invoke the <em>Select Color Dialog</em>.</p>
<p>Click <b>OK</b> to accept changes to the palette. Click <b>Cancel</b> to leave the dialog without making changes to the palette.</p>
<a name="dialog-select-font"></a><h4><a name="10-5"></a>Select Font Dialog</h4>
<p align="center"><img align="middle" src="rd-selfont.png" width="508" height="386">
</p>
<blockquote><p align="center"><em>Select Font</em></p></blockquote>
<p>The <em>Select Font</em> dialog is invoked by clicking the button next to the font property in the property editor.</p>
<p>Use this dialog to make changes to the font size and style.</p>
<p>Click the 'Font' listbox to choose a font type. The current selected type appears in the line edit above the 'Font' listbox. Click the 'Font Style' listbox to choose a style for the font. The choices available in the listbox are limited to the type of font you choose. Not all fonts have all styles available. The selected style appears in the line edit above the 'Font Style' listbox. Click the 'Size' listbox to choose a size for the font. The current selected size appears in the line edit above the 'Size' line edit. Click the checkboxes in the 'Effects' section to create a 'Strikeout' or 'Underline' effect for the selected font. Click the 'Script' and choose a style of writing. View your font selections and styles in the 'Sample' listbox.</p>
<p>Click <b>OK</b> to accept changes to the font. Click <b>Cancel</b> to leave the dialog without making any changes to the font.</p>
<h3><a name="11"></a>The Message Boxes</h3>
<a name="dialog-save-project-settings"></a><h4><a name="11-1"></a>Save Project Settings Dialog</h4>
<p align="center"><img align="middle" src="rd-saveprojset.png" width="294" height="125">
</p>
<blockquote><p align="center"><em>Save Project Settings</em></p></blockquote>
<p>The <em>Save Project Settings</em> message box is invoked by clicking <b>File|Close</b> or <b>File|Exit</b> for an open project with unsaved changes. The dialog displays the text 'Save changes to your project.pro'?. Click <b>Yes</b> to save the changes. If the project has any forms with unsaved changes, the <em>Save Form As</em> dialog is invoked when you click <b>Yes</b>. Click <b>No</b> to close the project without saving any changes. Click <b>Cancel</b> to leave the dialog without closing the project and without making any changes.</p>
<a name="dialog-save-form"></a><h4><a name="11-2"></a>Save Form Dialog</h4>
<p align="center"><img align="middle" src="rd-saveform.png" width="294" height="125">
</p>
<blockquote><p align="center"><em>Save Form</em></p></blockquote>
<p>The <em>Save Form</em> message is invoked in several ways. One way is to click <b>File|Close</b> for a form that has never been saved, or has been saved previously but has had changes made to it. The dialog is also invoked by clicking <b>File|Exit</b> for a form that has never been saved, or has been saved previously but has had changes made to it. The dialog displays 'Save Changes to the Form?'. Click <b>Yes</b> to save the form. If the form has not been previously saved, the <em>Save Form As Dialog</em> is invoked. Click <b>No</b> to close the form without saving any changes or without saving the form if it has not been saved previously. Click <b>Cancel</b> to leave the dialog without closing or exiting the form and without saving the form.</p>
<h3><a name="12"></a>The Object Explorer Dialogs</h3>
<p>Some dialogs are invoked by clicking the options available in the Object Explorer window.</p>
<a name="dialog-edit-forward-declarations"></a><h4><a name="12-1"></a>Edit Forward Declarations Dialog</h4>
<p align="center"><img align="middle" src="mw-editforw.png" width="339" height="327">
</p>
<blockquote><p align="center"><em>Edit Forward Declarations</em></p></blockquote>
<p>From the Source tab in the <a href="designer-manual-15.html#3">Object Explorer Window</a>, right click the 'Forward Declarations' folder and select 'Edit' from the context menu to invoke the <em>Edit Forward Declarations</em> dialog. Use this dialog to add, edit, or remove declarations in the source code.</p>
<p>To add a new declaration, click the <b>Add</b> button. A line edit will appear for you to type the declaration. Press <b>Enter</b> after you have typed the declaration. To delete a declaration from the listbox, click the declaration and then click <b>Remove</b>. To rename an existing declaration, click the declaration and then click <b>Rename</b>. The cursor will appear in the line edit, allowing you to change the name.</p>
<p>Click <b>Close</b> to leave the <em>Edit Forward Declarations</em> dialog.</p>
<a name="dialog-edit-includes-in-declaration"></a><h4><a name="12-2"></a>Edit Includes (in Declaration) Dialog</h4>
<p align="center"><img align="middle" src="rd-editincdec.png" width="339" height="327">
</p>
<blockquote><p align="center"><em>Edit Includes (in Declaration)</em></p></blockquote>
<p>From the Source tab in the <a href="designer-manual-15.html#3">Object Explorer Window</a>, right click the 'Includes (in Declaration)' folder and select 'Edit' from the context menu to invoke the <em>Edit Includes (in Declarations)</em> dialog. Use this dialog to add, edit, or remove includes in the source code.</p>
<p>To add a new include, click the <b>Add</b> button. A line edit will appear for you to type the include. Press <b>Enter</b> after you have typed the include. To delete an include from the listbox, click the include and then click <b>Remove</b>. To rename an existing include, click the include and then click <b>Rename</b>. The cursor will appear in the line edit, allowing you to change the name.</p>
<p>Click <b>Close</b> to leave the <em>Edit Include (in Declaration)</em> dialog.</p>
<a name="dialog-edit-includes-in-implementation"></a><h4><a name="12-3"></a>Edit Includes (in Implementation) Dialog</h4>
<p align="center"><img align="middle" src="mw-editincimp.png" width="339" height="327">
</p>
<blockquote><p align="center"><em>Edit Includes (in Implementation)</em></p></blockquote>
<p>From the Source tab in the <a href="designer-manual-15.html#3">Object Explorer Window</a>, right click the 'Includes (in Implementation)' folder and select 'Edit' from the context menu to invoke the <em>Edit Includes (in Implementation)</em> dialog. Use this dialog to add, edit, or remove includes in the source code.</p>
<p>To add a new include, click the <b>Add</b> button. A line edit will appear for you to type the include. Press <b>Enter</b> after you have typed the include. To delete an include from the listbox, click the include and then click <b>Remove</b>. To rename an existing include, click the include and then click <b>Rename</b>. The cursor will appear in the line edit, allowing you to change the name.</p>
<p>Click <b>Close</b> to leave the <em>Edit Include (in Implementation)</em> dialog.</p>
<a name="dialog-edit-class-variables"></a><h4><a name="12-4"></a>Edit Class Variables Dialog</h4>
<p align="center"><img align="middle" src="mw-editvar.png" width="324" height="346">
</p>
<blockquote><p align="center"><em>Edit Class Variables</em></p></blockquote>
<p>From the Source tab in the <a href="designer-manual-15.html#3">Object Explorer Window</a>, right click the 'Class Variables' folder and select 'Edit' from the context menu to invoke the <em>Edit Class Variables</em> dialog. Use this dialog to add, edit, or remove class variables in the source code.</p>
<p>To add a new variable, click the <b>Add</b> button. A line edit will appear for you to type the variable. Press enter after you have typed the variable. To delete an include from the listbox, click the variable and then click <b>Remove</b>. To rename an existing variable, click the variable and then click <b>Rename</b>. The cursor will appear in the line edit, allowing you to change the name.</p>
<p>Click <b>Close</b> to leave the <em>Edit Class Variables</em> dialog.</p>
<!-- eof -->
<p align="right">[<a href="designer-manual-12.html">Prev: Reference: Toolbar Buttons</a>] [<a href="designer-manual.html">Home</a>] [<a href="designer-manual-14.html">Next: Reference: Wizards</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>