Método EndModal

Disponible para los objetos Window (no MDI hijos) y DialogBox.

Prototipo

EndModal Proto hWnd:HWND, lRetValue:LONG

Sintaxis

Invoke EndModal, hWnd, lRetValue

Función

Cierra y destruye una ventana modal.

Parámetros

hWnd

"Handle" de la ventana modal que debe destruirse.

lRetValue

Valor que se devolverá cuando la ventana modal sea destruída.

Valor de retorno

Eax devuelve TRUE si se ha destruido la ventana, o FALSE si no.

OBSERVACIONES: Cuando se crea una ventana modal (vea el método Create), su padre se deshabilita y no tiene ningún control hasta que la ventana modal se destruye. En este punto, se espera un valor de retorno que nos diga si el usuario ha validado o cancelado la información que había dentro de la ventana modal. Este valor (habitualmente IDOK o IDCANCEL) se encuentra en el registro Eax cuando el método Create regresa, y es el valor pasado como segundo argumento (lRetValue) al método EndModal.

IMPORTANTE: Si el "handle" pasado como primer argumento (hWnd) no es válido o no se refiere a una ventana modal, el valor de retorno es FALSE.