Muestra una ventana de mensajes.
Sintaxis
MessageBox(Title, Text, [ Type = TYPE_OK ], [ Icon = ICON_NONE ], [ Timeout = 0 ] [ , ShowTimeout = FALSE ])
La sintaxis de la función MessageBox consta de los siguientes elementos:
Parte |
Descripción |
||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Title |
Cadena con un título para la ventana de mensajes. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Cadena. |
||||||||||||||||||||||||||||
Text |
Cadena con un texto para la ventana de mensajes. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Cadena. |
||||||||||||||||||||||||||||
Type |
El tipo de ventana de mensajes. El argumento Type puede tener los siguientes valores:
Se establece el valor predeterminado TYPE_OK si no se especifica el argumento. |
||||||||||||||||||||||||||||
Icon |
Determina el símbolo que aparece junto al texto. El argumento Icon puede tener los siguientes valores:
Se establece el valor predeterminado ICON_NONE si no se especifica el argumento. |
||||||||||||||||||||||||||||
Timeout |
Es la duración máxima de visualización de la ventana de mensajes en segundos. Si ajusta el argumento al valor 0 o lo omite, la ventana de mensajes se muestra durante un tiempo ilimitado. Para los tipos de mensaje de los grupos TYPE_YESNO y TYPE_ABORTRETRYIGNORE no se puede limitar la duración de visualización. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos numéricos. El valor debe ser mayor o igual que 0. Se establece el valor predeterminado 0 si no se especifica el argumento. |
||||||||||||||||||||||||||||
ShowTimeout |
Especifica si el tiempo de visualización restante debe mostrarse en el título de la ventana de mensajes. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Valor booleano. Se establece el valor predeterminado FALSE si no se especifica el argumento. |
Notas
El resultado es un entero que indica el botón pulsado. Si ha especificado el argumento Timeout el valor de retorno BUTTON_TIMEOUT indica que se ha superado la duración máxima de visualización.
Si un argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso.
La función devuelve uno de los siguientes valores:
Constante |
Significado |
|---|---|
BUTTON_TIMEDOUT |
La ventana de mensajes se ha cerrado porque se ha agotado el tiempo de espera. |
BUTTON_OK |
Se ha pulsado el botón Aceptar. |
BUTTON_CANCEL |
Se ha pulsado el botón Cancelar. |
BUTTON_ABORT |
Se ha pulsado el botón Anular. |
BUTTON_RETRY |
Se ha pulsado el botón Repetir. |
BUTTON_IGNORE |
Se ha pulsado el botón Ignorar. |
BUTTON_YES |
Se ha pulsado el botón Sí. |
BUTTON_NO |
Se ha pulsado el botón No. |
Disponibilidad
FlexPro Basic, Professional, Developer Suite
Ejemplos
MessageBox("Note", "A zero crossing could be found.")
Muestra una ventana de mensajes sin símbolo y con un botón Aceptar.
MessageBox("Note", "The curve fit was successful.", TYPE_OK, ICON_INFORMATION, 3.5, True)
Muestra una ventana de mensajes con un símbolo de información y un botón Aceptar. La ventana se muestra durante un máximo de 3,5 segundos. El tiempo de visualización restante se muestra en el título.
MessageBox("Warning", "No zero crossing could be found!", TYPE_OK, ICON_STOP)
Muestra una ventana de mensajes con un símbolo de stop y un botón Aceptar.
If MessageBox("Warnung", "Es wurde ein Nulldurchgang gefunden.\nSoll die Berechnung trotzdem abgebrochen werden?", _
TYPE_YESNO2, ICON_QUESTION) == BUTTON_YES Then
Throw "Berechnung wurde vom Anwender abgebrochen"
End
Muestra una ventana de mensajes con un símbolo de signo de exclamación y los botones Sí y No. Se ha preseleccionado el botón No. Si el usuario pulsa el botón Sí, se lanza una excepción.