Sidebar
k12:k12.4:k12.4.2:start
Table of Contents
12.4.2 Class Dialogue (gb.qt4)
The component provides standard dialogues for calling dialogue boxes. In this chapter, properties and methods of the class Dialog (gb.qt4) are presented. Examples and a project complete the description.
12.4.2.1 Properties
The Dialog (gb.qt4) class has these properties:
| Property | DataType | Description |
|---|---|---|
| ShowHidden | Boolean | Returns the value or sets with True that hidden files should also be shown in the dialogue box. |
| Color | Integer | Determines the colour selected in the colour selection dialogue or sets the colour in the colour selection dialogue as default colour. |
| Filter | String[] | Determines the filter used in the dialogue (file extension) or sets the filter. Filter is a string array where each entry consists of a filter and a filter description. A filter is a list of file extensions with placeholders separated by a semicolon. A filter description can be any string. A filter is automatically appended to the filter description when displayed. |
| Font | Font | Determines the font selected in the font selection dialogue or sets the font in the font selection dialogue as the default font. |
| Path | String | Returns the selected file path in the file selection dialog as string or sets the file path in the file dialog as default path. |
| Paths | String[] | Returns the selected file paths in the file open dialog as a string array. |
| Title | String | Returns the (window) title selected in the dialogue or sets the title for the dialogue. |
Table 12.4.2.1.1 : Properties of the Dialog class (gb.qt4)
12.4.2.2 Methods
Class Dialog (gb.qt4) has the following methods. Note optional arguments.
| Method | Description |
|---|---|
| OpenFile( [ Multi As Boolean ] ) As Boolean | Invokes the file open dialog to retrieve the file name of the file to be opened. If the optional argument 'Multi' has the value False (default), the user can select exactly one file. The return value is the path to the selected file - stored in the path property Dialog.Path. If the optional argument 'Multi' has the value True, the user can select multiple files. The return value is a string array containing the paths to all selected files - stored in the Dialog.Paths property. The method itself returns True if the user has pressed the Cancel button or False if the user has pressed the OK button. |
| SaveFile( ) As Boolean | |
| SelectDirectory( ) As Boolean | Calls the file standard dialogue to read out an existing directory name. The method itself returns True if the user pressed the Cancel button or False if the user pressed the OK button. |
| SelectFont( ) As Boolean | Calls the standard font selection dialogue. The method itself returns True if the user pressed the Cancel button or False if the user pressed the OK button. |
| SelectColor() As Boolean | Calls the standard colour selection dialogue. The method itself returns True if the user pressed the Cancel button or False if the user pressed the OK button. |
Table 12.4.2.2.1 : Methods of the class Dialog (gb.qt4)
12.4.2.3 Examples
In order to be able to reproduce all the examples, you will find a project archive in the download area. Since this project is based on the project presented in chapter → 12.4.1 Class Dialogue (gb.form.dialog) and only the component gb.form.dialog has been omitted, only the dialogue boxes and the program interface are presented.
12.4.2.4 Dialog.SelectDirectory()
Figure 12.4.2.4.1: Directory select dialogue box.
12.4.2.5 Dialog.Openfile(..) - image files
Figure 12.4.2.5.1: File Open dialogue box - 1
12.4.2.6 Dialog.Openfile(..) - text files
Figure 12.4.2.6.1: File Open dialogue box - 2
12.4.2.7 Dialog.SelectFont()
Figure 12.4.2.7.1: Font dialogue box
12.4.2.8 Dialog.SelectColor()
Figure 12.4.2.8.1: Colour dialogue box
12.4.2.9 Dialog.SaveFile()
Figure 12.4.2.9.1: File Save dialogue box.
12.4.2.10 Programme interface
Here you can see the programme interface for the project:
Figure 12.4.2.10.1: Programme interface
Download
k12/k12.4/k12.4.2/start.txt · Last modified: 01.02.2022 (external edit)
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial 3.0 Unported
