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
  • Primera ventana del proyecto
  • Valor devuelto a la función Abrir
  • Valor devuelto al cerrar una ventana secundaria
  • 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).
WEBDEV - Código ServidorWindowsLinux 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 ConsultasWindowsLinuxiPhone/iPadApple WatchCódigo de Usuario (UMC)
// 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.
WINDEVJava Este valor se recupera sólo si la ventana fue abierta por entablar.

Universal Windows 10 AppAndroidiPhone/iPadApple Watch Este valor se recupera sólo si la ventana fue abierta por OpenMobileWindow (o por OpenChild).
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)
WINDEVReportes y ConsultasWindowsLinuxiPhone/iPadApple WatchCódigo de Usuario (UMC) Valor N devuelto por la ventana cuando está cerrada (si se devuelven varios valores).
WINDEV Este valor se recupera sólo si la ventana fue abierta por entablar.

iPhone/iPadApple Watch Este valor se recupera sólo si la ventana fue abierta por OpenMobileWindow (o por OpenChild).
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.
iPhone/iPadApple Watch

Primera ventana del proyecto

Utilizar la función Cerrar en la primera ventana del proyecto equivale al cierre de la aplicación. Esta función sólo debe utilizarse para la depuración, ya que la licencia de este tipo de hardware no permite cerrar la aplicación.
WINDEVReportes y ConsultasJavaCódigo de Usuario (UMC)

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)
Universal Windows 10 AppAndroidiPhone/iPadApple Watch

Valor devuelto al cerrar una ventana secundaria

La función Cerrar permite devolver un valor a la ventana padre que abrió la ventana hija.
Recordatorio: Un valor también puede ser devuelto por el ReturnedValue Property (<nombre de la ventana>.ReturnedValue) ejecutado antes del Cerrar.
El valor devuelto por la ventana hija puede leerse en el Event "Cierre de una ventana hija" de la ventana que la abrió (la que llamó a OpenMobileWindow o OpenChild): simplemente utilice el ReturnedValue Property en la palabra clave MiInfantilVentana.
Por ejemplo:
  • En el código de cierre de la ventana hija, se utiliza Cerrar para devolver un parámetro:
    Close("", MyParameter)
  • El nombre de la ventana hija, así como el valor devuelto, pueden ser recuperados en la Event "Cierre de una ventana hija" de la ventana que llama, utilizando la palabra clave MiInfantilVentana:
    // Close a child window
    NameChildWindow = MyChildWindow.Name
    ValueChildWindow = MyChildWindow.ReturnedValue

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