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 / Controles, páginas y ventanas / Funciones de ventanas
  • Códigos ejecutados en el cierre
  • Cierre según el tipo de ventana
  • Última ventana de proyecto
  • Valor devuelto a la función Abrir
  • Teclas Alt + F4
  • Equivalencia
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
Cierra una ventana WINDEV (y devuelve un valor si es necesario).
Windows Esta función solo está disponible para simplificar la Webificación de proyectos WINDEV. En un sitio WEBDEV, esta función tiene el mismo comportamiento que Diálogo PageCloseDialog o ContextoCerrar, según el caso.
Ejemplo
// Close the "WIN_Edit" window
Close(WIN_Edit)
Reportes y ConsultasWindows
// Close the "WIN_EditUsername" window
// and retrieve several return values
Close(WIN_EditUsername, LastName, FirstName)
Sintaxis
Close([<Window> [, <Returned value> [... [, <Returned value N>]]]])
<Window>: Nombre de la ventana opcional
Nombre de la ventana a cerrar. Si no se especifica este parámetro o si corresponde a una cadena vacía ("""), se cierra la ventana actual.
<Returned value>: Tipo correspondiente al valor devuelto (opcional)
Valor devuelto por la ventana cuando está cerrada.

Usted tiene la capacidad de regresar:
  • tipos simples (cadena de caracteres, booleano, ....).
  • tipos avanzados: estructura, estructura dinámica, clase, tipo avanzado, array, asociativo array, cola, pila, lista.
<Returned value N>: Tipo correspondiente al valor devuelto (opcional)
Reportes y ConsultasWindows Valor N devuelto por la ventana cuando está cerrada (si se devuelven varios valores).

Usted tiene la capacidad de regresar:
  • tipos simples (cadena de caracteres, booleano, ....).
  • tipos avanzados: estructura, estructura dinámica, clase, tipo avanzado, array, asociativo array, cola, pila, lista.
Observaciones

Códigos ejecutados en el cierre

  • Al cerrar una ventana:
    1. La actual Process está permanentemente interrumpida.
    2. Se ejecuta la Event de cierre de la ventana.
  • Si se llama a SetFocusAndReturnToUserInput en el "cierre" de Event, la ventana no se cierra.
  • Si se ejecuta la función Cerrar en un procedimiento llamado con la función Timer, se debe verificar la existencia de la ventana que se va a cerrar con las funciones WinStatus o CurrentWin, de lo contrario todas las ventanas abiertas podrían cerrarse. Por ejemplo:
    // Procedure called by timer
    Window is string
    Window = CurrentWin()
    IF Window <> "Window name" THEN
    Close()
    END

Cierre según el tipo de ventana

  • Si la ventana a cerrar es una ventana padre con ventanas hijas, estas ventanas hijas se cerrarán primero (su código de cierre se ejecuta).
  • Si la ventana para cerrar es una ventana secundaria, la ventana principal se convierte en la ventana actual.. Se ejecuta el código de "ganancia de enfoque" de la ventana principal.

Última ventana de proyecto

Si se cierra la última ventana, se ejecuta la Event de "Cierre" del proyecto antes de finalizar el programa.
Reportes y Consultas

Valor devuelto a la función Abrir

Se puede utilizar la función Cerrar para devolver uno o más valores a la función entablar.
Recordatorio: Un valor también puede ser devuelto por el ReturnedValue Property (<nombre de la ventana>.ReturnedValue) ejecutado antes del Cerrar. En este caso, se puede devolver un valor individual.
Ejemplos:
  • El usuario debe escribir una contraseña en una ventana. Esta contraseña se recupera cuando se cierra esta ventana y se devuelve a entablar:
    MyPassword = Open(WIN_EditPassword)
    IF MyPassword <> "" THEN
    Info("Wrong password")
    END
     
    // -- Click code on "OK" button in the "WIN_EditPassword" window
    // Users enter their password in the EDT_Password control
    // and validates the window.
    Close("", EDT_Password)
  • El usuario debe introducir un nombre de usuario y una contraseña en una ventana. El nombre de usuario y la contraseña se recuperan cuando se cierra la ventana y se devuelve a entablar:
    (MyUsername, MyPassword) = Open(WIN_EditPassword)
    IF MyUsername <> "" OR MyPassword <> "" THEN
    Info("Wrong username or password")
    END
     
    // -- Click code on "OK" button in the "WIN_EditPassword" window
    // Users enter their username and password
    // in the EDT_Password control and validates the window.
    Close("", EDT_Username, EDT_Password)

Teclas Alt + F4

Presionar Alt + F4 puede desencadenar varios comportamientos:
  • Si la ventana contiene un botón de "Abandono", se ejecuta el WLanguage Event associated con el botón de abandono.
  • Si la ventana tiene un botón con Alt + F4 como atajo de teclado, se ejecuta el WLanguage Event associated con este botón.
  • Si la ventana no contiene un botón "abandonar", o un botón con Alt + F4 como atajo de teclado, se ejecuta el Process de cierre de la ventana y se cierra la ventana (excepto si se llama a SetFocusAndReturnToUserInput).
  • Si se abre una ventana desde un programa en lenguaje externo, Alt + F4 devuelve "ESC" en WdKey.

Equivalencia

La siguiente Line de código:
WinStatus(<Window>, NotFound)
equivale a:
Close(<Window>)
Componente: wd290obj.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 15/07/2022

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