Mètode Create

Prototip

Create Proto lpszWindowName:LPSTR, hWndParent:HWND, lMode:LONG, lParam:LPARAM

Sintaxi

Invoke Create, lpszWindowName, hWndParent, lMode, lParam

Funció

Crea i mostra un objecte finestra del nom indicat.

Paràmetres

lpszWindowName

Punter a l'adreça efectiva d'una cadena acabada en zero amb el nom de l'objecte finestra. Aquest paràmetre ha de ser un nom que es refereixi a qualsevol dels objectes finestra afegits al projecte en temps de disseny (respectant majúscules i minúscules). El nom d'un objecte és el que s'indica a la seva propietat Name.

hWndParent

"Handle" del pare. Pot ser NULL si la finestra creada no ha de tenir pare.

lMode

Indica si la finestra creada serà modal o no.

lParam

Indica el valor que es passarà a l'objecte DialogBox al paràmetre lParam del missatge WM_INITDIALOG (només si és un objecte DialogBox).

Valor de retorn

Per a finestres no modals, Eax torna el "handle" de la nova finestra creada, mentre que per a finestres modals torna el valor passat com a segon argument al mètode EndModal.

OBSERVACIONS: El paràmetre lMode indica si la nova finestra creada serà modal o no. Només els objectes DialogBox i Window (que no siguin MDI fills) poden ser finestres modals (vegeu la propietat MDIChild), per tant, aquest paràmetre s'ignora per als objectes MDIWindow i Window (que siguin MDI fills). El valor de lMode ha de ser 0 (ecModeless) o 1 (ecModal). Noteu que qualsevol altre valor que no sigui 0 significarà una finestra modal. D'altra banda, el paràmetre lParam només és vàlid per als objectes DialogBox i pot ser NULL si no es necessita. Per a qualsevol altre objecte que no sigui DialogBox, el paràmetre lParam és ignorat.

IMPORTANT: Si indiqueu un objecte finestra el nom del qual no existeix al projecte, la finestra no serà creada i el valor de retorn serà NULL.