1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
|
<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="usage" xml:lang="de">
<info>
<link type="guide" xref="index"/>
<desc>Wenn Sie Skripte schreiben, können Sie <app>Zenity</app> zur Erzeugung einfacher Dialoge zur Interaktion mit dem Benutzer verwenden.</desc>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>Mario Blättermann</mal:name>
<mal:email>mario.blaettermann@gmail.com</mal:email>
<mal:years>2008-2012</mal:years>
</mal:credit>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>Christian Kirbach</mal:name>
<mal:email>Christian.Kirbach@gmail.com</mal:email>
<mal:years>2012</mal:years>
</mal:credit>
</info>
<title>Benutzung</title>
<p>Wenn Sie Skripte schreiben, können Sie <app>Zenity</app> zur Erzeugung einfacher Dialoge zur Interaktion mit dem Benutzer verwenden, wie folgende:</p>
<list>
<item>
<p>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.</p>
</item>
<item>
<p>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.</p>
</item>
</list>
<p>Wenn der Benutzer den Dialog schließt, schreibt <app>Zenity</app> den vom Dialog ausgegebenen Text in die Standardausgabe.</p>
<note>
<p>Wenn Sie <app>Zenity</app>-Befehle schreiben, stellen Sie bitte sicher, dass Sie jedes Argument stets in Anführungszeichen einschließen.</p>
<p>Benutzen Sie beispielsweise:</p>
<screen>zenity --calendar --title="Urlaubsplaner"</screen>
<p>Benutzen Sie nicht:</p>
<screen>zenity --calendar --title=Urlaubsplaner</screen>
<p>Wenn Sie keine Anführungszeichen verwenden, könnten Sie unerwartete Ergebnisse erhalten.</p>
</note>
<section id="zenity-usage-mnemonics">
<title>Zugriffstasten</title>
<p>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.</p>
<p>Einige <app>Zenity</app>-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:</p>
<screen><input>"_Wählen Sie einen Namen".</input></screen>
</section>
<section id="zenity-usage-exitcodes">
<title>Rückgabewerte</title>
<p>Zenity erzeugt die folgenden Rückgabewerte:</p>
<table frame="all" rules="all">
<thead>
<tr>
<td>
<p>Rückgabewert</p></td>
<td>
<p>Beschreibung</p></td>
</tr>
</thead>
<tbody>
<tr>
<td>
<p><var>0</var></p>
</td>
<td>
<p>Der Benutzer hat entweder <gui style="button">OK</gui> oder <gui style="button">Schließen</gui> angeklickt.</p>
</td>
</tr>
<tr>
<td>
<p><var>1</var></p>
</td>
<td>
<p>Der Benutzer hat entweder <gui style="button">Abbrechen</gui> angeklickt oder die Fensterfunktionen zum Schließen des Dialogs benutzt.</p>
</td>
</tr>
<tr>
<td>
<p><var>-1</var></p>
</td>
<td>
<p>Es ist ein unerwarteter Fehler aufgetreten.</p>
</td>
</tr>
<tr>
<td>
<p><var>5</var></p>
</td>
<td>
<p>Der Dialog wurde geschlossen, weil die Wartezeit verstrichen ist.</p>
</td>
</tr>
</tbody>
</table>
</section>
<!-- ==== General Options ====== -->
<section id="zenity-usage-general-options">
<title>Allgemeine Einstellungen</title>
<p>Alle Zenity-Dialoge unterstützen die folgenden allgemeinen Optionen:</p>
<terms>
<item>
<title><cmd>--title</cmd>=<var>Titel</var></title>
<p>Damit legen Sie den Titel des Dialogs fest.</p>
</item>
<item>
<title><cmd>--window-icon</cmd>=<var>Symbolpfad</var></title>
<p>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.</p>
</item>
<item>
<title><cmd>--width</cmd>=<var>Breite</var></title>
<p>Damit legen Sie die Breite des Dialogs fest.</p>
</item>
<item>
<title><cmd>--height</cmd>=<var>Höhe</var></title>
<p>Damit legen Sie die Höhe des Dialogs fest.</p>
</item>
<item>
<title><cmd>--timeout</cmd>=<var>timeout</var></title>
<p>Damit legen Sie die Wartezeit in Sekunden bis zum Schließen des Dialogs fest.</p>
</item>
</terms>
</section>
<!-- ==== Miscellaneous Options ====== -->
<section id="zenity-help-options">
<title>Hilfeoptionen</title>
<p>Zenity stellt die folgenden Hilfeoptionen bereit:</p>
<terms>
<item>
<title><cmd>--help</cmd></title>
<p>Damit zeigen Sie einen Hilfetext in Kurzform an.</p>
</item>
<item>
<title><cmd>--help-all</cmd></title>
<p>Damit zeigen Sie den kompletten Hilfetext für alle Dialoge an.</p>
</item>
<item>
<title><cmd>--help-general</cmd></title>
<p>Damit zeigen Sie den Hilfetext für allgemeine Dialogoptionen an.</p>
</item>
<item>
<title><cmd>--help-calendar</cmd></title>
<p>Damit zeigen Sie den Hilfetext für Kalenderdialogoptionen an.</p>
</item>
<item>
<title><cmd>--help-entry</cmd></title>
<p>Damit zeigen Sie den Hilfetext für Optionen des Texteingabedialogs an.</p>
</item>
<item>
<title><cmd>--help-error</cmd></title>
<p>Damit zeigen Sie den Hilfetext für Optionen des Fehlerdialogs an.</p>
</item>
<item>
<title><cmd>--help-info</cmd></title>
<p>Damit zeigen Sie den Hilfetext für Informationsdialogoptionen an.</p>
</item>
<item>
<title><cmd>--help-file-selection</cmd></title>
<p>Damit zeigen Sie den Hilfetext für Optionen des Dateiauswahldialogs.</p>
</item>
<item>
<title><cmd>--help-list</cmd></title>
<p>Damit zeigen Sie den Hilfetext für Optionen des Listendialogs an.</p>
</item>
<item>
<title><cmd>--help-notification</cmd></title>
<p>Damit zeigen Sie den Hilfetext für Optionen des Benachrichtigungssymbols an.</p>
</item>
<item>
<title><cmd>--help-progress</cmd></title>
<p>Damit zeigen Sie den Hilfetext für Optionen des Fortschrittsanzeige-Dialogs an.</p>
</item>
<item>
<title><cmd>--help-question</cmd></title>
<p>Damit zeigen Sie den Hilfetext für Optionen des Fragedialogs an.</p>
</item>
<item>
<title><cmd>--help-warning</cmd></title>
<p>Damit zeigen Sie den Hilfetext für die Optionen des Warndialogs an.</p>
</item>
<item>
<title><cmd>--help-text-info</cmd></title>
<p>Damit zeigen Sie den Hilfetext für Optionen des Informationsdialogs an.</p>
</item>
<item>
<title><cmd>--help-misc</cmd></title>
<p>Damit zeigen Sie den Hilfetext für nicht auf einen bestimmten Dialog bezogene Optionen an.</p>
</item>
<item>
<title><cmd>--help-gtk</cmd></title>
<p>Damit zeigen Sie den Hilfetext für die GTK+-Optionen an.</p>
</item>
</terms>
</section>
<!-- ==== Miscellaneous Options ====== -->
<section id="zenity-miscellaneous-options">
<title>Verschiedene Optionen</title>
<p>Zenity stellt außerdem die folgenden weiteren Optionen zur Verfügung:</p>
<terms>
<item>
<title><cmd>--about</cmd></title>
<p>Damit zeigen Sie den <gui>Info zu Zenity</gui>-Dialog an, der Versionsinformationen, Copyright-Informationen und Entwicklerinformationen über Zenity enthält.</p>
</item>
<item>
<title><cmd>--version</cmd></title>
<p>Damit zeigen Sie die Versionsnummer von Zenity an.</p>
</item>
</terms>
</section>
<!-- ==== GTK+ Options ====== -->
<section id="zenity-gtk-options">
<title>GTK+-Optionen</title>
<p>Zenity unterstützt die Standardoptionen von GTK+. Um weitere Informationen über die GTK+-Optionen anzuzeigen, führen Sie den Befehl <cmd>zenity --help-gtk</cmd> aus.</p>
</section>
<!-- ==== Environment variables ==== -->
<section id="zenity-environment-variables">
<title>Umgebungsvariablen</title>
<p>Normalerweise erkennt Zenity das Terminalfenster, aus dem es gestartet wurde und hält sein eigenes Fenster im Vordergrund dieses Fensters. Dieses Verhalten kann deaktiviert werden, wenn Sie das Setzen der Umgebungsvariable <var>WINDOWID</var> deaktivieren.</p>
</section>
</page>
|
