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
271
272
273
274
275
276
277
278
279
280
281
282
|
<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="usage" xml:lang="es">
<info>
<link type="guide" xref="index"/>
<desc>Puede usar <application>Zenity</application> para crear diálogos simples que interactúen gráficamente con el usuario.</desc>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>Daniel Mustieles</mal:name>
<mal:email>daniel.mustieles@gmail.com</mal:email>
<mal:years>2012-2014</mal:years>
</mal:credit>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>Jorge González</mal:name>
<mal:email>jorgegonz@svn.gnome.org</mal:email>
<mal:years>2007-2010</mal:years>
</mal:credit>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>Alejandro Aravena</mal:name>
<mal:email>raidenblast@gmail.com</mal:email>
<mal:years>2005</mal:years>
</mal:credit>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>QA: Francisco Javier F. Serrador</mal:name>
<mal:email>serrador@cvs.gnome.org</mal:email>
<mal:years>2005</mal:years>
</mal:credit>
</info>
<title>Uso</title>
<p>Cuando escriba scripts, puede usar <application>Zenity</application> para crear diálogos simples que interactúen gráficamente con el usuario, como por ejemplo:</p>
<list>
<item>
<p>Puede crear un diálogo para obtener información del usuario. Por ejemplo, puede pedir al usuario seleccionar una fecha de un diálogo del calendario, o seleccionar un archivo de un diálogo de selección de archivo.</p>
</item>
<item>
<p>Usted puede crear un diálogo para proporcionar información al usuario. Por ejemplo, puede usar un diálogo de progreso para indicar el estado actual de una operación, o usar un diálogo de advertencia para alertar al usuario.</p>
</item>
</list>
<p>Cuando el usuario cierra el diálogo, <app>Zenity</app> imprime el texto producido por diálogo a la salida estándar de error.</p>
<note>
<p>Cuando usted escriba comandos de <app>Zenity</app>, asegúrese de poner comillas alrededor de cada argumento.</p>
<p>Por ejemplo, use:</p>
<screen>zenity --calendar --title="Calendario de vacaciones"</screen>
<p>No use:</p>
<screen>zenity --calendar --title=Calendario de vacaciones</screen>
<p>Si no usa comillas, puede que consiga resultados inesperados.</p>
</note>
<section id="zenity-usage-mnemonics">
<title>Combinaciones de teclas</title>
<p>Una combinación de teclas le permite realizar una acción desde el teclado en lugar de utilizar el ratón para elegir un comando de un menú o un diálogo. Cada combinación de teclas se identifica por una letra subrayada en una opción del menú o de un diálogo.</p>
<p>Algunos diálogos de <app>Zenity</app> soportan el uso de combinaciones de teclas. Para especificar el carácter que se utilizará como combinación de teclas, ponga un guión bajo precediendo ese carácter en el texto del diálogo. El siguiente ejemplo muestra cómo especificar la letra «E» como combinación de teclas:</p>
<screen><input>«_Elija un nombre».</input></screen>
</section>
<section id="zenity-usage-exitcodes">
<title>Códigos de salida</title>
<p>Zenity devuelve los siguientes códigos de salida:</p>
<table frame="all" rules="all">
<thead>
<tr>
<td>
<p>Código de salida</p></td>
<td>
<p>Descripción</p></td>
</tr>
</thead>
<tbody>
<tr>
<td>
<p><var>0</var></p>
</td>
<td>
<p>El usuario ha pulsado <gui style="button">Aceptar</gui> o <gui style="button">Cerrar</gui>.</p>
</td>
</tr>
<tr>
<td>
<p><var>1</var></p>
</td>
<td>
<p>El usuario ha presionado <gui style="button">Cancelar</gui>, o ha usado la función de la ventana para cerrar el diálogo.</p>
</td>
</tr>
<tr>
<td>
<p><var>-1</var></p>
</td>
<td>
<p>Ha ocurrido un error inesperado.</p>
</td>
</tr>
<tr>
<td>
<p><var>5</var></p>
</td>
<td>
<p>El diálogo se ha cerrado porque se alcanzó el tiempo de expiración.</p>
</td>
</tr>
</tbody>
</table>
</section>
<!-- ==== General Options ====== -->
<section id="zenity-usage-general-options">
<title>Opciones generales</title>
<p>Todos los diálogos de Zenity soportan las siguientes opciones generales:</p>
<terms>
<item>
<title><cmd>--title</cmd>=<var>título</var></title>
<p>Especifica el título de un diálogo.</p>
</item>
<item>
<title><cmd>--window-icon</cmd>=<var>ruta_al_icono</var></title>
<p>Especifica el icono que se muestra en el marco de la ventana del diálogo. Hay 4 iconos disponibles, proporcionando las palabras claves siguientes - 'info', 'warning', 'question' y 'error'.</p>
</item>
<item>
<title><cmd>--width</cmd>=<var>anchura</var></title>
<p>Especifica el ancho del diálogo.</p>
</item>
<item>
<title><cmd>--height</cmd>=<var>altura</var></title>
<p>Especifica la altura del diálogo.</p>
</item>
<item>
<title><cmd>--timeout</cmd>=<var>tiempo_de_expiración</var></title>
<p>Especifica el tiempo de expiración en segundos después del cual el diálogo se cierra.</p>
</item>
</terms>
</section>
<!-- ==== Miscellaneous Options ====== -->
<section id="zenity-help-options">
<title>Opciones de ayuda</title>
<p>Zenity proporciona las siguientes opciones de ayuda:</p>
<terms>
<item>
<title><cmd>--help</cmd></title>
<p>Muestra un texto de ayuda abreviado.</p>
</item>
<item>
<title><cmd>--help-all</cmd></title>
<p>Muestra un texto de ayuda completo para todos los diálogos.</p>
</item>
<item>
<title><cmd>--help-general</cmd></title>
<p>Muestra el texto de ayuda para los opciones de diálogo generales.</p>
</item>
<item>
<title><cmd>--help-calendar</cmd></title>
<p>Muestra el texto de ayuda para las opciones de diálogo del calendario.</p>
</item>
<item>
<title><cmd>--help-entry</cmd></title>
<p>Muestra el texto de ayuda para las opciones del diálogo de entrada de texto.</p>
</item>
<item>
<title><cmd>--help-error</cmd></title>
<p>Muestra el texto de ayuda para las opciones del diálogo de error.</p>
</item>
<item>
<title><cmd>--help-info</cmd></title>
<p>Muestra el texto de ayuda para las opciones del diálogo de información.</p>
</item>
<item>
<title><cmd>--help-file-selection</cmd></title>
<p>Muestra el texto de ayuda para las opciones del diálogo de selección de archivos.</p>
</item>
<item>
<title><cmd>--help-list</cmd></title>
<p>Muestra el texto de ayuda para las opciones del diálogo de lista.</p>
</item>
<item>
<title><cmd>--help-notification</cmd></title>
<p>Muestra el texto de ayuda para las opciones de iconos de notificación.</p>
</item>
<item>
<title><cmd>--help-progress</cmd></title>
<p>Muestra el texto de ayuda para las opciones del diálogo de progreso.</p>
</item>
<item>
<title><cmd>--help-question</cmd></title>
<p>Muestra el texto de ayuda para las opciones del diálogo de pregunta.</p>
</item>
<item>
<title><cmd>--help-warning</cmd></title>
<p>Muestra el texto de ayuda para las opciones del diálogo de advertencia.</p>
</item>
<item>
<title><cmd>--help-text-info</cmd></title>
<p>Muestra el texto de ayuda para las opciones del diálogo de información.</p>
</item>
<item>
<title><cmd>--help-misc</cmd></title>
<p>Muestra el texto de ayuda para las opciones misceláneas.</p>
</item>
<item>
<title><cmd>--help-gtk</cmd></title>
<p>Muestra la ayuda para las opciones de GTK+.</p>
</item>
</terms>
</section>
<!-- ==== Miscellaneous Options ====== -->
<section id="zenity-miscellaneous-options">
<title>Opciones misceláneas</title>
<p>Zenity también proporciona las siguientes opciones varias:</p>
<terms>
<item>
<title><cmd>--about</cmd></title>
<p>Muestra el diálogo <gui>Acerca de Zenity</gui>, que contiene la información de la versión de Zenity, información del copyright, e información del desarrollador.</p>
</item>
<item>
<title><cmd>--version</cmd></title>
<p>Muestra el número de versión de Zenity.</p>
</item>
</terms>
</section>
<!-- ==== GTK+ Options ====== -->
<section id="zenity-gtk-options">
<title>Opciones de GTK+</title>
<p>Zenity soporta las opciones estándares de GTK+. Para obtener más información acerca de las opciones de GTK+, ejecute el comando <cmd>zenity --help-gtk</cmd>.</p>
</section>
<!-- ==== Environment variables ==== -->
<section id="zenity-environment-variables">
<title>Variables de entorno</title>
<p>Generalmente Zenity detecta la ventana del terminal desde la que se ha lanzado y se mantiene por encima de esa ventana. Este comportamiento se puede desactivar con la variable de entorno <envar>WINDOWID</envar>.</p>
</section>
</page>
|
