Método Create

Sintaxis

Invoke Create, lpszWindowName, hWndParent, lMode, lParam

Función

Crea y muestra un objeto ventana del nombre indicado.

Parámetros

lpszWindowName

Puntero a la dirección efectiva de una cadena acabada en cero con el nombre del objeto ventana. Este parámetro debe ser un nombre que se refiera a cualquiera de los objetos ventana agregados al proyecto en tiempo de diseño (respetando mayúsculas y minúsculas). El nombre de un objeto es el que se indica en su propiedad Name.

hWndParent

"Handle" del padre. Puede ser NULL si la ventana creada no va a tener padre.

lMode

Indica si la ventana creada será modal o no.

lParam

Indica el valor que se pasará al objeto DialogBox en el parámetro lParam del mensaje WM_INITDIALOG (sólo si es un objeto DialogBox).

Valor de retorno

Para ventanas no modales, Eax devuelve el "handle" de la nueva ventana creada, mientras que para ventanas modales devuelve el valor pasado como segundo argumento al método EndModal.

OBSERVACIONES: El parámetro lMode indica si la nueva ventana creada será modal o no. Sólo los objetos DialogBox y Window (que no sean MDI hijos) pueden ser ventanas modales (vea la propiedad MDIChild), por lo tanto, este parámetro se ignora para los objetos MDIWindow y Window (que sean MDI hijos). El valor de lMode debe ser 0 (ecModeless) o 1 (ecModal). Note que cualquier otro valor que no sea 0 significará una ventana modal. Por otra parte, el parámetro lParam sólo es válido para los objetos DialogBox y puede ser NULL si no se necesita. Para cualquier otro objeto que no sea DialogBox, el parámetro lParam es ignorado.

IMPORTANTE: Si indica un objeto ventana cuyo nombre no existe en el proyecto, la ventana no será creada y el valor de retorno será NULL.