Método Create
Prototipo
Create Proto lpszWindowName:LPSTR, hWndParent:HWND, lMode:LONG, lParam:LPARAM
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.