Die Komponente stellt Standard-Dialoge zum Aufruf von Dialog-Boxen zur Verfügung. In diesem Kapitel werden Eigenschaften und Methoden der Klasse Dialog (GTK/GTK3/QT4/QT5) vorgestellt. Beispiele und ein Projekt ergänzen die Beschreibung.
Die Klasse Dialog verfügt über diese Eigenschaften:
Eigenschaft | Datentyp | Beschreibung |
---|---|---|
ShowHidden | Boolean | Gibt den Wert zurück oder legt mit True fest, dass auch versteckte Dateien in der Dialog-Box angezeigt werden sollen. |
Color | Integer | Ermittelt die im Farbauswahl-Dialog gewählte Farbe oder legt die Farbe im Farbauswahl-Dialog als Vorgabe-Farbe fest. |
Filter | String[] | Ermittelt den im Dialog verwendeten Filter (Datei-Extension) oder legt den Filter fest. Filter ist ein String-Array, bei dem jeder Eintrag aus einem Filter und einer Filter-Beschreibung besteht. Ein Filter ist eine Liste von Datei-Extensionen mit Platzhaltern, die durch ein Semikolon getrennt sind. Eine Filterbeschreibung kann eine beliebige Zeichenfolge sein. Ein Filter wird bei der Anzeige automatisch an die Filterbeschreibung angehängt. |
FilterIndex | Integer | Durch Setzen des Arrays-Index kann man die Vorauswahl des Filters verändern , der beim Öffnen des Dialogs angezeigt wird (Vorgabe = 0). Durch Abfrage des Index kann ermittelt werden, welcher Filter ausgewählt wurde. Verfügbar in Gambas-Versionen > 3.16.3 . |
Font | Font | Ermittelt den im Fontauswahl-Dialog gewählten Font oder legt den Font im Fontauswahl-Dialog als Vorgabe-Font fest. |
Path | String | Gibt den ausgewählten Datei-Pfad im Datei-Auswahl-Dialog als String zurück oder legt den Datei-Pfad im Datei-Dialog als Vorgabe-Pfad fest. |
Paths | String[] | Gibt die ausgewählten Datei-Pfade im Datei-Öffnen-Dialog als String-Array zurück. |
Title | String | Ermittelt den im Dialog gewählten (Fenster-)Titel oder legt den Titel für den Dialog fest. |
Tabelle 12.4.2.1.1 : Eigenschaften der Klasse Dialog
Klasse Dialog besitzt die folgenden Methoden. Beachten Sie optionale Argumente.
Tabelle 12.4.2.2.1 : Methoden der Klasse Dialog (gb.qt4)
Um alle Beispiele nachvollziehen zu können, finden Sie im Download-Bereich ein Projekt-Archiv. Da dieses Projekt auf dem im Kapitel → 12.4.1 Klasse Dialog (gb.form.dialog) vorgestellten Projekt basiert und nur auf die Komponente gb.form.dialog verzichtet wurde, werden lediglich die Dialog-Boxen und die Programm-Oberfläche vorgestellt.
12.4.2.4 Dialog.SelectDirectory()
Abbildung 12.4.2.4.1: Verzeichnis-Auswahl-Dialog-Box