Availability: Macintosh.
El módulo EasyDialogs contiene diálogos simples de Macintosh.
Todas las rutinas tienen un parámetro opcional id con el
que se puede redefinir el recurso DLOG utilizado para el diálogo, siempre
que los números de elementos correspondan. En el código fuente hay
más detalles.
El módulo EasyDialogs define las siguientes funciones:
- Message (str)
-
Presenta un diálogo modal con el texto de mensaje str, que puede tener
hasta 255 caracteres. El control vuelve cuando el usuario pulsa ``OK''.
- AskString (prompt[, default])
-
Pide al usuario un valor de cadena, en un diálogo modal. prompt
es el mensaje y el argumento opcional default es el valor
inicial de la cadena. Las cadenas pueden tener hasta 255 bytes.
AskString() devuelve la cadena introducida o
None
si el usuario cancela el diálogo.
- AskPassword (prompt[, default])
-
Pide al usuario un valor de cadena, en un diálogo modal. Igual que AskString,
pero con el texto convertido en asteriscos. prompt
es el mensaje y el argumento opcional default es el valor
inicial de la cadena. Las cadenas pueden tener hasta 255 bytes.
AskPassword() devuelve la cadena introducida o
None
si el usuario cancela el diálogo.
- AskYesNoCancel (question[, default])
-
Presenta un diálogo con el texto question y tres botones:
``sí'', ``no'' y ``cancelar''. Devuelve
1
(sí), 0
(no)
y -1
si se cancela. El valor predeterminado devuelto si se pulsa el retorno es
0
. Se puede establecer otro valor con el argumento opcional
default.
- ProgressBar ([title [, maxval[,label]]])
-
Presenta un diálogo de progreso con una barra tipo termómetro. title
es la cadena de texto que se muestra (por omisión ``Trabajando...''), maxval es
el valor al legar al cual se considera completo el progreso (por omisión
100
). label es el texto presentado sobre la propia barra de progreso.
El objeto devuelto tiene dos métodos:
set(value)
, que establece el valor de la barra de progreso y
label(text)
, que establece el texto de la etiqueta. La barra
permanece visible hasta que el objeto devuelto se elimina.
La barra de progreso tiene un botón de ``Cancelar''.
Ver Sobre este documento... para obtener información sobre sugerencias.