AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones de Windows / Funciones de cuadros de diálogo
  • Características del cuadro de diálogo
  • Salto de línea en el cuadro de diálogo
  • Mostrar el último mensaje de error
  • Miscelánea
  • Aplicación en segundo plano: Caso específico a partir de Android 10
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Muestra un mensaje de error personalizado en una ventana de error del sistema para una cantidad de tiempo set. Después del tiempo de espera, la ventana del sistema se cierra automáticamente.
Observaciones:
  • Esta ventana de advertencia bloquea la aplicación hasta que haya transcurrido el límite de tiempo. Para continuar ejecutando la aplicación, el usuario debe hacer clic en "OK".
    WINDEVAndroid Para no bloquear la aplicación, utilice la función ErrorWithTimeoutAsynchronous.
  • WINDEV WINDEV permite aplicar la plantilla del proyecto al cuadro de diálogo. Para obtener más información, consulte Personalizar cuadros de diálogo.
Ejemplo
// Display "An error was detected" in an error window
// This error window will be automatically closed after 10 seconds.
ErrorWithTimeout(1000, "An error was detected")
// Display the last error in an error window
// This error window will be automatically closed after 5 seconds.
ErrorWithTimeout(500)
Sintaxis

Mostrar un mensaje de error personalizado Ocultar los detalles

ErrorWithTimeout(<Timeout> , <Text> [, <Line 2> [... [, <Line n>]]])
<Timeout>: Entero o Duración
Tiempo (expresado en centésimas de segundo) antes de que la ventana de error se cierre automáticamente. Este parámetro puede ser:
  • un número entero que corresponde al número de centésimas de segundo,
  • una variable de tipo Duration,
  • la duración en un formato legible (por ejemplo, 1 s o 10 ms).
<Text>: Cadena de caracteres
Texto a mostrar.
<Line 2>: Cadena de caracteres opcional
Texto que aparece en la segunda línea.
<Line n>: Cadena de caracteres opcional
Texto que aparece en la enésima línea.

Mostrar el mensaje de error de la última función WLanguage utilizada Ocultar los detalles

ErrorWithTimeout(<Timeout before closing>)
<Timeout before closing>: Entero o Duración
Tiempo (expresado en centésimas de segundo) antes de que la ventana de error se cierre automáticamente. Este parámetro puede ser:
  • un número entero que corresponde al número de centésimas de segundo,
  • una variable de tipo Duration,
  • la duración en un formato legible (por ejemplo, 1 s o 10 ms).
Observaciones

Características del cuadro de diálogo

  • El título del cuadro de diálogo es el título de la ventana actual. Para modificar este título, utilice NextTitle.
  • El mensaje está alineado a la izquierda.
  • El texto del botón depende del idioma de ejecución de Windows.
  • El número máximo de caracteres está limitado a 4096. Si se pasa una cadena más grande como parámetro, se truncará.
  • El ícono que se muestra (cruz blanca) no se puede modificar.
Para personalizar este cuadro de diálogo (y todos los cuadros de diálogo del sistema en la aplicación), seleccione la opción "Personalizar ventanas del sistema (Info, YesNo, Confirm, Dialog)" en la pestaña "Estilo" de la descripción del proyecto. Para obtener más información, consulte Personalizar cuadros de diálogo.

Salto de línea en el cuadro de diálogo

La cadena predefinida CR (Carriage Return) se puede utilizar para pasar a la línea siguiente. Por ejemplo:
ErrorWithTimeout(500, "An error was detected while entering the address." + CR + ...
"Please modify the customer details.")
equivale a:
ErrorWithTimeout(500, "An error has been detected when entering the address." , ...
"Please modify the customer details.")
También se puede usar la sintaxis de las cadenas multilínea. Por ejemplo:
ErrorWithTimeout(500,
[
An Error was detected WHILE entering the address.
 
Please modify the customer details.
])

Mostrar el último mensaje de error

Llamar a ErrorWithTimeout especificando solo el tiempo de espera (syntax2), muestra el mensaje de error de la última función WLanguage que provocó un error.
En este caso, el siguiente código:
ErrorWithTimeout(500)
equivale a:
ErrorWithTimeout(500, ErrorInfo())
Atención: La función ErrorWithTimeout debe utilizarse inmediatamente después de llamar a la función que falló. De hecho, llamar a una función WLanguage puede reinicializar y modificar el informe de la función ErrorWithTimeout.

Miscelánea

  • Los timers (función TimerSys) no se detienen al llamar a esta función.
  • Los eventos de Windows no se detienen al llamar a esta función.
  • El texto de los botones se muestra en el idioma utilizado por Windows en el equipo actual.
  • Equivalencia: La función ErrorWithTimeout es equivalente a la función Error utilizada con la función DelayBeforeClosing.
    El siguiente código:
    ErrorWithTimeout(1000, "An error was detected")
    equivale a:
    DelayBeforeClosing(1000)
    Error("An error occurred")
Android

Aplicación en segundo plano: Caso específico a partir de Android 10

A partir de Android 10, no se puede abrir una ventana si la aplicación está en segundo plano.
La función ErrorWithTimeout puede abrir una ventana. Si se utiliza esta función cuando la aplicación está en segundo plano, se producirá un error fatal.
Consejos:
  • Para saber si la aplicación está en segundo plano, utilice la función InBackgroundMode.
  • Si una aplicación necesita interactuar con el usuario cuando está en segundo plano, se puede mostrar una notificación (con el tipo Notification). La aplicación volverá al primer plano cuando se haga clic en la notificación, si la propiedad ActivateApplication se establece en True. También es posible abrir una ventana desde el procedimiento pasado a la propiedad ActionClick.
Para obtener más información, consulte Android 10: Comportamiento de aplicaciones en segundo plano.
Clasificación Lógica de negocio / UI: Código UI
Componente: wd290obj.dll
Versión mínima requerida
  • Versión 18
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 29/02/2024

Señalar un error o enviar una sugerencia | Ayuda local