<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/reggie/tmp/qt-3.1-reggie-23625/qt-x11-free-3.1.1/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"><!--
h3.fn,span.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 Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped 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>
<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 File Dialogs</h3>
<p align="center"><img align="middle" src="qd-filenew2.png" width="565" height="462">
</p>
<blockquote><p align="center"><em>New File Dialog</em></p></blockquote>
<a name="dialog-file-new"></a><h4><a name="2-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="2-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#4-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="2-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="2-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="2-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="2-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="2-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="2-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="2-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="2-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="2-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="2-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="2-1-12"></a>C++ Main File</h5>
<p>Click <b>C++ Main File</b> to invoke the <a href="designer-manual-13.html#8">Configure Main-File Dialog</a> which will create a basic <tt>main.cpp</tt> file automatically.</p>
<p align="center"><img align="middle" src="qd-fileopen.png" width="597" height="367">
</p>
<blockquote><p align="center"><em>File Open Dialog</em></p></blockquote>
<a name="dialog-file-open"></a><h4><a name="2-2"></a>File Open Dialog</h4>
<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>
<p align="center"><img align="middle" src="qd-filesaveasdialog.png" width="597" height="367">
</p>
<blockquote><p align="center"><em>Save As</em></p></blockquote>
<a name="dialog-file-save-as"></a><h4><a name="2-3"></a>Save As</h4>
<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>
<p align="center"><img align="middle" src="qd-createtemplate.png" width="361" height="274">
</p>
<blockquote><p align="center"><em>Create Template</em></p></blockquote>
<a name="dialog-file-create-template"></a><h4><a name="2-4"></a>Create Template Dialog</h4>
<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#2-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="3"></a>The Edit Dialogs</h3>
<p align="center"><img align="middle" src="editfunc.png" width="608" height="399">
</p>
<blockquote><p align="center"><em>Edit Functions</em></p></blockquote>
<a name="dialog-edit-slots"></a><h4><a name="3-1"></a>Edit Functions Dialog</h4>
<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="3-2"></a>View and Edit Connections Dialog</h4>
<p>Click <b>Edit|Connections</b> to invoke the <em>View and Edit Connections</em> dialog. 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>
<p align="center"><img align="middle" src="vieweditconn.png" width="608" height="393">
</p>
<blockquote><p align="center"><em>View and Edit Connections</em></p></blockquote>
<a name="dialog-edit-form-settings"></a><h4><a name="3-3"></a>Form Settings Dialog</h4>
<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="3-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="3-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>
<p align="center"><img align="middle" src="formsettings.png" width="601" height="465">
</p>
<blockquote><p align="center"><em>Form Settings</em></p></blockquote>
<h5><a name="3-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="3-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>
<p align="center"><img align="middle" src="qd-editpreferencesgeneral.png" width="522" height="444">
</p>
<blockquote><p align="center"><em>Preferences- General Tab</em></p></blockquote>
<h5><a name="3-4-1"></a>General Tab</h5>
<p>The 'General' tab has sections for Background, Grid, General, and Toolbars.</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 'General' section of the General tab has three checkboxes that are checked by default. Click 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. Click the 'Show Splash Screen on startup' checkbox to display the <em>Qt Designer</em> splash screen when you start up the application. Click 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. To change the path <em>Qt Designer</em> uses to find it's online documentation, click the 'Documentation Path' line edit and type a new path. It would be unlikely to have to change this path. Another way to change the path is to click the <b>(ellipsis)</b> button located to the right of the line edit. This invokes the <em>Find Directory 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 'Toolbars' section has a 'Show Text Labels' checkbox. Click the checkbox to display the text labels for each icon shown in the <em>Qt Designer</em> toolbar.</p>
<p align="center"><img align="middle" src="qd-editpreferencesc++.png" width="522" height="444">
</p>
<blockquote><p align="center"><em>Preferences- C++ Editor Tab</em></p></blockquote>
<h5><a name="3-4-2"></a>C++ Editor Tab</h5>
<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="4"></a>The Project Dialogs</h3>
<p align="center"><img align="middle" src="qd-projectaddfile.png" width="597" height="367">
</p>
<blockquote><p align="center"><em>Add Dialog</em></p></blockquote>
<a name="dialog-add"></a><h4><a name="4-1"></a>Add Dialog</h4>
<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>
<p align="center"><img align="middle" src="qd-projectimages.png" width="463" height="286">
</p>
<blockquote><p align="center"><em>Manage Image Collection</em></p></blockquote>
<a name="dialog-image-collection"></a><h4><a name="4-2"></a>Image Collection Dialog</h4>
<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>. 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>
<p align="center"><img align="middle" src="qd-projectdbaseconnections.png" width="528" height="374">
</p>
<blockquote><p align="center"><em>Edit Database Connections</em></p></blockquote>
<a name="dialog-edit-database-connections"></a><h4><a name="4-3"></a>Edit Database Connections Dialog</h4>
<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="4-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>
<p align="center"><img align="middle" src="qd-projectsettingsdialog.png" width="459" height="335">
</p>
<blockquote><p align="center"><em>Project Settings- Settings Tab</em></p></blockquote>
<h5><a name="4-4-1"></a>Settings Tab</h5>
<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>
<p align="center"><img align="middle" src="qd-projectsettingsc++tabdialog.png" width="459" height="335">
</p>
<blockquote><p align="center"><em>Project Settings- C++ Tab</em></p></blockquote>
<h5><a name="4-4-2"></a>C++ Tab</h5>
<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="5"></a>The Search Dialogs</h3>
<p align="center"><img align="middle" src="qd-searchfindtextdialog.png" width="303" height="223">
</p>
<blockquote><p align="center"><em>Find Text</em></p></blockquote>
<a name="dialog-find-text"></a><h4><a name="5-1"></a>Find Text Dialog</h4>
<p>Click <b>Search|Find</b> (or press <b>Ctrl+F</b>) to invoke the <a href="designer-manual-13.html#5-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>
<p align="center"><img align="middle" src="qd-searchreplacetext.png" width="303" height="253">
</p>
<blockquote><p align="center"><em>Replace Text</em></p></blockquote>
<a name="dialog-replace-text"></a><h4><a name="5-2"></a>Replace Text Dialog</h4>
<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>
<p align="center"><img align="middle" src="qd-searchgotoline.png" width="251" height="111">
</p>
<blockquote><p align="center"><em>Goto Line</em></p></blockquote>
<a name="dialog-go-to-line"></a><h4><a name="5-3"></a>Goto Line Dialog</h4>
<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="6"></a>The Tools Dialogs</h3>
<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="7"></a>The Help Dialogs</h3>
<a name="dialog-qt-designer"></a><h4><a name="7-1"></a>Qt Designer Dialog</h4>
<p>Click <b>Help|About</b> to invoke the <em>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="7-2"></a>Qt Designer Dialog</h4>
<p>Click <b>Help|About Qt</b> to invoke the <em>Qt Designer 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>
<p align="center"><img align="middle" src="qd-configmainfile.png" width="316" height="309">
</p>
<blockquote><p align="center"><em>Configure Main-File Dialog</em></p></blockquote>
<a name="dialog-configure-main-file"></a><h3><a name="8"></a>Configure Main-File Dialog</h3>
<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>
<p align="center"><img align="middle" src="qd-filesaveprojectsettingsdialog.png" width="461" height="126">
</p>
<blockquote><p align="center"><em>Save Project Settings</em></p></blockquote>
<a name="dialog-save-project-settings"></a><h3><a name="9"></a>Save Project Settings Dialog</h3>
<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>
<p align="center"><img align="middle" src="qd-filesaveformdialog.png" width="346" height="126">
</p>
<blockquote><p align="center"><em>Save Form</em></p></blockquote>
<a name="dialog-save-form"></a><h3><a name="10"></a>Save Form Dialog</h3>
<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>
<p align="center"><img align="middle" src="qd-filesaveformasdialog.png" width="597" height="367">
</p>
<blockquote><p align="center"><em>Save Form As Dialog</em></p></blockquote>
<a name="dialog-save-form-as"></a><h3><a name="11"></a>Save Form As Dialog</h3>
<p>The <em>Save Form As</em> dialog is invoked in three different ways. One way is to click <b>File|Save</b> for a form in a project that has never saved. Another way to invoke the dialog is by clicking <b>File|Close</b> for a form that has not been previously saved and has had changes made to it. The third way to invoke the dialog is by clicking <b>File|Exit</b> for a form that has not been saved previously or that has been saved but has had changes made to it. <b>File|Close</b> and <b>File|Exit</b> invoke the <em>Save Form Dialog</em>. Click <b>Yes</b> to invoke the <em>Save Form As</em> dialog.</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>
<p align="center"><img align="middle" src="qd-finddirectorydialog.png" width="597" height="367">
</p>
<blockquote><p align="center"><em>Find Directory</em></p></blockquote>
<a name="dialog-find-directory"></a><h3><a name="12"></a>Find Directory Dialog</h3>
<p>Invoke this dialog to locate a directory.</p>
<p>The <em>Find Directory</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>OK</b> to accept the directory. Click <b>Cancel</b> to leave the dialog without choosing a directory.</p>
<p align="center"><img align="middle" src="qd-chooseapixmap.png" width="597" height="367">
</p>
<blockquote><p align="center"><em>Choose a Pixmap</em></p></blockquote>
<a name="dialog-choose-a-pixmap"></a><h3><a name="13"></a>Choose a Pixmap Dialog</h3>
<p>Invoke 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-edit-custom-widgets"></a><h3><a name="14"></a>Edit Custom Widgets Dialog</h3>
<p>Invoke this dialog 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>
<p align="center"><img align="middle" src="qd-custwiddeftab.png" width="745" height="412">
</p>
<blockquote><p align="center"><em>Edit Custom Widgets- Definition Tab</em></p></blockquote>
<h4><a name="14-1"></a>The Definition Tab</h4>
<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 (<>). 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>
<p align="center"><img align="middle" src="qd-editcustwidsigtab.png" width="745" height="412">
</p>
<blockquote><p align="center"><em>Edit Custom Widgets- Signals Tab</em></p></blockquote>
<h4><a name="14-2"></a>The Signals Tab</h4>
<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>
<p align="center"><img align="middle" src="qd-custwidslotstab.png" width="745" height="412">
</p>
<blockquote><p align="center"><em>Edit Custom Widgets- Slots Tab</em></p></blockquote>
<h4><a name="14-3"></a>The Slots Tab</h4>
<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>
<p align="center"><img align="middle" src="qd-custwidproptab.png" width="745" height="412">
</p>
<blockquote><p align="center"><em>Edit Custom Widgets- Properties Tab</em></p></blockquote>
<h4><a name="14-4"></a>The Properties Tab</h4>
<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>
<p align="center"><img align="middle" src="qd-chooseimages.png" width="597" height="367">
</p>
<blockquote><p align="center"><em>Choose Images</em></p></blockquote>
<a name="dialog-choose-images"></a><h3><a name="15"></a>Choose Images Dialog</h3>
<p>Invoke the <em>Choose Images</em> dialog to choose images to use in a project.</p>
<p>This 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.</p>
<p>Click <b>Open</b> to open the selected file. Click <b>Cancel</b> to leave the dialog without opening a file.</p>
<p align="center"><img align="middle" src="qd-chooseanimage.png" width="463" height="286">
</p>
<blockquote><p align="center"><em>Choose an Image</em></p></blockquote>
<a name="dialog-choose-an-image"></a><h3><a name="16"></a>Choose an Image Dialog</h3>
<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>
<p align="center"><img align="middle" src="qd-selectcolordialog.png" width="490" height="398">
</p>
<blockquote><p align="center"><em>Select Color</em></p></blockquote>
<a name="dialog-select-color"></a><h3><a name="17"></a>Select Color Dialog</h3>
<p>The <em>Select Color</em> dialog is used 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>
<p align="center"><img align="middle" src="qd-editpalettedialog.png" width="457" height="469">
</p>
<blockquote><p align="center"><em>Edit Palette</em></p></blockquote>
<a name="dialog-edit-palette"></a><h3><a name="18"></a>Edit Palette Dialog</h3>
<p>The <em>Edit Palette</em> dialog is used 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>
<p align="center"><img align="middle" src="qd-tunepalettedialog.png" width="362" height="381">
</p>
<blockquote><p align="center"><em>Tune Palette</em></p></blockquote>
<a name="dialog-tune-palette"></a><h3><a name="19"></a>Tune Palette Dialog</h3>
<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>
<p align="center"><img align="middle" src="qd-selectfontdialog.png" width="508" height="386">
</p>
<blockquote><p align="center"><em>Select Font</em></p></blockquote>
<a name="dialog-select-font"></a><h3><a name="20"></a>Select Font Dialog</h3>
<p>The <em>Select Font</em> dialog is used 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>
<p align="center"><img align="middle" src="qd-textdialog.png" width="429" height="301">
</p>
<blockquote><p align="center"><em>Text Dialog</em></p></blockquote>
<a name="dialog-text"></a><h3><a name="21"></a>Text Dialog</h3>
<p>The <em>Text</em> dialog is used to type text.</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>
<p align="center"><img align="middle" src="qd-title.png" width="408" height="120">
</p>
<blockquote><p align="center"><em>Title Dialog</em></p></blockquote>
<a name="dialog-title"></a><h3><a name="22"></a>Title Dialog</h3>
<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>
<p align="center"><img align="middle" src="qd-pagetitle.png" width="408" height="120">
</p>
<blockquote><p align="center"><em>Page Title Dialog</em></p></blockquote>
<a name="dialog-dialog-page-title"></a><h3><a name="23"></a>Page Title Dialog</h3>
<p>Right click a tab widget on the form and select <b>Edit Page Title</b> to invoke the <em>Page Title</em> dialog. Use this dialog to change the name 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>
<p align="center"><img align="middle" src="qd-editlistbox.png" width="469" height="222">
</p>
<blockquote><p align="center"><em>Edit Listbox</em></p></blockquote>
<a name="dialog-edit-listbox"></a><h3><a name="24"></a>Edit Listbox Dialog</h3>
<p>Right click or double click a Listbox on the form and select 'Edit' to invoke the <em>Edit Listbox</em> dialog. 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><h3><a name="25"></a>Edit Listview</h3>
<p>Right click or double click a listview widget on the form and select 'Edit' to invoke the <em>Edit Listview</em> dialog. 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>
<p align="center"><img align="middle" src="qd-editlistview.png" width="607" height="378">
</p>
<blockquote><p align="center"><em>Edit Listview- Items Tab</em></p></blockquote>
<h4><a name="25-1"></a>The Items Tab</h4>
<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>
<p align="center"><img align="middle" src="qd-editlistviewcolumns.png" width="607" height="378">
</p>
<blockquote><p align="center"><em>Edit Listview- Columns Tab</em></p></blockquote>
<h4><a name="25-2"></a>The Columns Tab</h4>
<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>
<p align="center"><img align="middle" src="qd-editiconview.png" width="575" height="347">
</p>
<blockquote><p align="center"><em>Edit Iconview</em></p></blockquote>
<a name="dialog-edit-iconview"></a><h3><a name="26"></a>Edit Iconview</h3>
<p>Right click or double click an iconview widget on the form and select 'Edit' to invoke the <em>Edit Iconview</em> dialog. 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><h3><a name="27"></a>Edit Table</h3>
<p>Right click or double click a table widget on the form and select 'Edit' to invoke the <em>Edit Table</em> dialog. Use the dialog to add, change, or remove columns or rows from the table.</p>
<p align="center"><img align="middle" src="qd-edittablecolumns.png" width="546" height="395">
</p>
<blockquote><p align="center"><em>Edit Table- Columns Tab</em></p></blockquote>
<h4><a name="27-1"></a>The Column Tab</h4>
<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>
<p align="center"><img align="middle" src="qd-edittablerows.png" width="546" height="395">
</p>
<blockquote><p align="center"><em>Edit Table- Rows Tab</em></p></blockquote>
<h4><a name="27-2"></a>The Rows Tab</h4>
<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>
<p align="center"><img align="middle" src="qd-editforwarddeclarations.png" width="339" height="327">
</p>
<blockquote><p align="center"><em>Edit Forward Declarations</em></p></blockquote>
<a name="dialog-edit-forward-declarations"></a><h3><a name="28"></a>Edit Forward Declarations Dialog</h3>
<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>
<p align="center"><img align="middle" src="qd-editincludesindeclaration.png" width="339" height="327">
</p>
<blockquote><p align="center"><em>Edit Includes (in Declaration)</em></p></blockquote>
<a name="dialog-edit-includes-in-declaration"></a><h3><a name="29"></a>Edit Includes (in Declaration) Dialog</h3>
<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>
<p align="center"><img align="middle" src="qd-editincludesinimplementation.png" width="339" height="327">
</p>
<blockquote><p align="center"><em>Edit Includes (in Implementation)</em></p></blockquote>
<a name="dialog-edit-includes-in-implementation"></a><h3><a name="30"></a>Edit Includes (in Implementation) Dialog</h3>
<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>
<p align="center"><img align="middle" src="qd-editclassvariables.png" width="339" height="327">
</p>
<blockquote><p align="center"><em>Edit Class Variables</em></p></blockquote>
<a name="dialog-edit-class-variables"></a><h3><a name="31"></a>Edit Class Variables Dialog</h3>
<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 © 2002
<a href="http://www.trolltech.com">Trolltech</a><td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt version 3.1.1</div>
</table></div></address></body>
</html>
