Benutzung
Wenn Sie Skripte schreiben, können Sie Zenity zur Erzeugung einfacher Dialoge zur Interaktion mit dem Benutzer verwenden, wie folgende:
- Sie können einen Dialog erzeugen, der die Eingabe von Informationen durch den Benutzer erfordert. Beispielsweise können Sie den Benutzer anweisen, ein Datum aus einem Kalenderdialog oder eine Datei aus einem Dateiauswahldialog zu wählen.
- Sie können einen Dialog erzeugen, um dem Benutzer Informationen zur Verfügung zu stellen. Beispielsweise können Sie einen Fortschrittsanzeige-Dialog erzeugen, um auf den aktuellen Status eines Vorgangs hinzuweisen, oder einen Warndialog, um den Benutzer zu warnen.
Wenn der Benutzer den Dialog schließt, schreibt Zenity den vom Dialog ausgegebenen Text in die Standardausgabe.
Wenn Sie Zenity-Befehle schreiben, stellen Sie bitte sicher, dass Sie jedes Argument stets in Anführungszeichen einschließen.
Benutzen Sie beispielsweise:
zenity --calendar --title="Urlaubsplaner"
zenity --calendar --title=Urlaubsplaner
Wenn Sie keine Anführungszeichen verwenden, könnten Sie unerwartete Ergebnisse erhalten.
- 2.1. Zugriffstasten
- 2.2. Rückgabewerte
- 2.3. Allgemeine Einstellungen
- 2.4. Hilfeoptionen
- 2.5. Verschiedene Optionen
- 2.6. GTK+-Optionen
- 2.7. Umgebungsvariablen
2.1. Zugriffstasten
Eine Zugriffstaste ist eine Taste, die Ihnen die Ausführung einer Aktion mit der Tastatur zur Auswahl eines Befehls aus einem Menü oder einem Dialog erlaubt, anstatt dafür die Maus zu benutzen.
Einige Zenity-Dialoge unterstützen die Verwendung von Zugriffstasten. Um das Zeichen für den Tastaturzugriff festzulegen, setzen Sie einen Unterstrich vor das Zeichen im Dialogtext. Das folgende Beispiel zeigt, wie Sie den Buchstaben »W« als Zugriffstaste festlegen.
"_Wählen Sie einen Namen"
2.2. Rückgabewerte
Zenity erzeugt die folgenden Rückgabewerte:
Rückgabewert | Beschreibung |
---|---|
0 | Der Benutzer hat entweder auf oder auf gedrückt. |
1 | Der Benutzer hat entweder auf gedrückt oder die Fensterfunktionen zum Schließen des Dialogs benutzt. |
-1 | Es ist ein unerwarteter Fehler aufgetreten. |
5 | Der Dialog wurde geschlossen, weil die Wartezeit verstrichen ist. |
2.3. Allgemeine Einstellungen
Alle Zenity-Dialoge unterstützen die folgenden allgemeinen Optionen:
- --title=Titel
-
Damit legen Sie den Titel des Dialogs fest.
- --window-icon=Symbolpfad
-
Damit legen Sie das Symbol fest, das im Fensterrahmen des Dialogs angezeigt wird. Es gibt 4 Standardsymbole, die auch über die Schlüsselwörter »info«, »warning«, »question« und »error« bereitgestellt werden.
- --width=Breite
-
Damit legen Sie die Breite des Dialogs fest.
- --height=Höhe
-
Damit legen Sie die Höhe des Dialogs fest.
- --timeout=timeout
-
Damit legen Sie die Wartezeit in Sekunden bis zum Schließen des Dialogs fest.
2.4. Hilfeoptionen
Zenity stellt die folgenden Hilfeoptionen bereit:
- --help
-
Damit zeigen Sie einen Hilfetext in Kurzform an.
- --help-all
-
Damit zeigen Sie den kompletten Hilfetext für alle Dialoge an.
- --help-general
-
Damit zeigen Sie den Hilfetext für allgemeine Dialogoptionen an.
- --help-calendar
-
Damit zeigen Sie den Hilfetext für Kalenderdialogoptionen an.
- --help-entry
-
Damit zeigen Sie den Hilfetext für Optionen des Texteingabedialogs an.
- --help-error
-
Damit zeigen Sie den Hilfetext für Optionen des Fehlerdialogs an.
- --help-info
-
Damit zeigen Sie den Hilfetext für Informationsdialogoptionen an.
- --help-file-selection
-
Damit zeigen Sie den Hilfetext für Optionen des Dateiauswahldialogs.
- --help-list
-
Damit zeigen Sie den Hilfetext für Optionen des Listendialogs an.
- --help-notification
-
Damit zeigen Sie den Hilfetext für Optionen des Benachrichtigungsymbols an.
- --help-progress
-
Damit zeigen Sie den Hilfetext für Optionen des Fortschrittsanzeige-Dialogs an.
- --help-question
-
Damit zeigen Sie den Hilfetext für Optionen des Fragedialogs an.
- --help-warning
-
Damit zeigen Sie den Hilfetext für die Optionen des Warndialogs an.
- --help-text-info
-
Damit zeigen Sie den Hilfetext für Optionen des Informationsdialogs an.
- --help-misc
-
Damit zeigen Sie den Hilfetext für nicht auf einen bestimmten Dialog bezogene Optionen an.
- --help-gtk
-
Damit zeigen Sie den Hilfetext für die GTK+-Optionen an.
2.5. Verschiedene Optionen
Zenity stellt außerdem die folgenden verschiedenen Optionen zur Verfügung:
- --about
-
Damit zeigen Sie den Info zu Zenity-Dialog an, der Versionsinformationen, Copyright-Informationen und Entwicklerinformationen über Zenity enthält.
- --version
-
Damit zeigen Sie die Versionsnummer von Zenity an.