\chapter Reference: Dialogs \section1 Introduction This chapter describes and explains every \QSAD dialog. \section1 The Menu Dialogs \section2 Qt Designer New/File Dialog Click \Menu{File/New/File} to invoke the \Dialog{Name of File} dialog. Use this dialog to name the source code file that you want to include in your project. \section1 The Edit Dialogs \section2 Form Settings Dialog \img rd-formset.png \caption Form Settings Click \Menu{Edit|Form Settings} to invoke the \Dialog{Form Settings} dialog. Use this dialog to save the form's settings, pixmap, and layout properties. \section3 Settings 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. \section3 Pixmaps The default (for projects) is 'Project Imagefile'. This is the recommended option. Images are handled automatically, with \QD storing the images in a subdirectory, and \Cmd uic 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. If you do not want \QD to handle the images, (or are not using a project) choose either 'Save Inline' or 'Use Function'. 'Save Inline' saves the pixmaps in the \File .ui 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. \section3 Layouts Click the 'Default Margin' spinbox or the 'Default Spacing' spinbox to change the default layout settings of the current form. 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. \section2 Preferences Dialog Click \Menu{Edit|Preferences} to invoke the \Dialog Preferences 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. \section3 General Tab \img rd-prefgen1.png \caption Preferences- General Tab The 'General' tab has sections for Background, Grid, General, and Toolbars. The Background section defaults to 'Pixmap'. To change the default, click the \Button {Select a Pixmap} button next to the 'Pixmap' radio button to invoke the \Dialog{Choose a Pixmap... Dialog}. Click the 'Color' radio button to change the background to a color instead of a pixmap. Click the \Button {Choose a Color} button located to the right of the 'Color' radio button to invoke the \Dialog{Select Color Dialog}. 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 \QD. The next time you start up \QD, the windows and toolbars are restored to their last positions. Click the 'Show Splash Screen on startup' checkbox to display the \QD 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 \QD 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 \Button {(ellipsis)} button located to the right of the line edit. This invokes the \Dialog{Find Directory Dialog}. 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 \QD 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. The 'Toolbars' section has a 'Show Text Labels' checkbox. Click the checkbox to display the text labels for each icon shown in the \QD toolbar. \section3 Qt Script Editor Tab \img \caption The Qt Script 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 \Button{Change Color} button to invoke the \Dialog{Select Color Dialog}. As you make changes to each element, you can view the changes in the 'Preview' line edit. The 'Options' section has the Wordwrap, Completion, and Parentheses Matching checkboxes checked by default. Click the checkboxes to de-select them. The Indentation section enables you to set the code intentation on the Qt Script Editor. Select your preferences by clicking the spinboxes for Tab Size and Indent Size. Check the Keep Tabs checkbox so that tabs are used for indentation otherwise, spaces will be used. Check Auto Indent to enable automatic indentation. \section1 The Project Dialogs \section2 Manage Image Collection Dialog \img rd-image.png \caption Manage Image Collection Click \Menu{Project|Image Collection} to invoke the \Dialog{Manage Image Collection Dialog}. Use this dialog to view the project's images, add new images, or delete images. To add an image, click the \Button Add button to invoke the \Dialog{Choose Images... Dialog}. 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 \Button Open to open the selected file. Click \CANCEL to leave the dialog without opening a file. To delete an image from from the iconview, click the image and then click the \Button Delete button. Changes made to the image collection are applied immediately. Click the \Button Close button to leave the dialog. \section2 Project Settings Dialog Click \Menu {Project|Project Settings} to invoke the \Dialog{Project Settings Dialog}. Use this dialog to make changes to the project settings. \section3 Qt Script Tab The Qt Script tab enables you to choose a global Qt Script function to invoke when choosing \Menu {Qt Script|Run}. \section1 The Search Dialogs \target dialog-find-text \section2 Find Text Dialog \img rd-find.png \caption Find Text Click \Menu{Search|Find} (or press \Key Ctrl+F) to invoke the \l{Find Text Dialog}. Use this dialog to find specific text in a project file. 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 \Button Find button to start the search. When the text is found, it is highlighted in the file. Continue clicking \Button Find to search for subsequent occurrences of the search text. Click the \Button Close button to leave the dialog. \target dialog-replace-text \section2 Replace Text Dialog \img rd-replace.png \caption Replace Text Click \Menu{Search|Replace} (or press \Key {Ctrl+R}) to invoke the \Dialog{Replace Text Dialog}. Use this dialog to replace text in a project file. 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. Click the \Button Replace button to search and replace the text. When the text is found, it is highlighted in the file. Continue clicking \Button Replace button to search and replace each occurrence of the text in the file. Click \Button {Replace All} button to replace all occurences of the search text in the file at once. Click the \Button Close button to leave the dialog. \target dialog-go-to-line \section2 Goto Line Dialog \img rd-goto.png \caption Goto Line Click \Menu{Search|Goto line} (or press \Key {Alt+G}) to invoke the \Dialog{Goto Line Dialog}. Use this dialog to go to a specific line in the file. To choose a line number, type the number in the 'Line' spinbox, or click the up and down arrows in the spinbox. Click the \Button Goto button. The cursor is placed at the beginning of the line in the file. Click the \Button Close button to leave the dialog. \section1 The Tools Dialog \img rd-configtb.png \caption Configure Toolbox Click \Menu{Tools|Configure Toolbox} to invoke the \Dialog{Configure Toolbox Dialog}. 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 \Button Add. The selected widget now appears in the Common Widgets category. To remove a widget from the Common Widgets list, click a widget, then click \Button Remove. To move a widget up or down in the Common Widgets list, click the up or down arrows. Click \OK to accept the configurations to the toolbox. Click \CANCEL to leave the dialog. \section1 The Help Dialogs \target dialog-qt-designer \section2 About Qt Designer Dialog Click \Menu{Help|About} to invoke the \Dialog{About Qt Designer Dialog}. This dialog provides information about \QD such as the version, the licensing terms, conditions, and disclaimers. Click the 'x' located at the top right corner of the dialog to close the dialog. \target dialog-qt-designer \section2 About Qt Dialog Click \Menu{Help|About Qt} to invoke the \Dialog{About Qt Dialog}. This dialog provides information about Qt. Click the 'x' located at the title of the dialog to close the dialog.