CreateDialogIndirectParam

Funcţia CreateDialogIndirectParam creează o casetă de dialog fără mod dintr-un şablon de caseta de dialog în memorie. Înainte de afişarea casetei de dialog, funcţia trece o valoare definită de aplicarea procedurii de caseta de dialog ca parametrul lParam mesaj WM_INITDIALOG . Cererea poate folosi această valoare să iniţializeze controalele casetă de dialog.

(HWND CreateDialogIndirectParam HINSTANCE  hInstance, / / ocupa de instanta applicationLPCDLGTEMPLATElpTemplate, / / indicatorul pentru a dialog box şablonHWNDhWndParent, / / ocupa proprietarul fereastraDLGPROClpDialogFunc, / / indicatorul pentru a dialog box proceduraLPARAMlParamInit / / iniţializare valoarea);
 

Parametrii

hInstance

Identifică instanţa de modulul care va crea caseta de dialog.

lpTemplate

Cursorul într-un obiect de memorie globală care con?in un şablon care CreateDialogIndirectParam utilizează pentru a crea caseta de dialog. Un şablon de caseta de dialog constă dintr-un antet care descrie caseta de dialog, urmat de unul sau mai multe blocuri suplimentare de date care descrie fiecare dintre controalele din caseta de dialog. Şablonul poate utiliza formatul standard sau formatul extins.

Într-un şablon standard, antetul este o structură DLGTEMPLATE urmat de matrice suplimentare de lungime variabilă. Datele pentru fiecare control dintr-o structură DLGITEMTEMPLATE urmat de matrice de lungime variabilă suplimentare.

Într-un şablon de caseta de dialog extins, antetul utilizează formatul DLGTEMPLATEEX ?i defini?iile control utilizează formatul DLGITEMTEMPLATEEX.

După ce CreateDialogIndirectParam se întoarce, puteţi liber şablonul, care este folosit doar pentru a obţine caseta de dialog a început.

hWndParent

Identifică fereastra care deţine caseta de dialog.

lpDialogFunc

Indicatorul la procedura de caseta de dialog. Pentru mai multe informaţii despre procedura caseta de dialog, consultaţi DialogProc.

lParamInit

Specifică valoarea pentru a trece la caseta de dialog în parametrul lParam mesaj WM_INITDIALOG.

Valorile întroarse

Dacă funcţia reuşeşte, valoarea returnată este ghidajul ferestrei pentru a caseta de dialog.

Dacă funcţia nu reuşeşte, valoarea returnată este NULL. Pentru a obţine extins informa?ii eroare, apel GetLastError.

Observaţii

Funcţia de CreateDialogIndirectParam utilizează funcţia CreateWindowEx pentru a crea caseta de dialog. CreateDialogIndirectParam trimite un mesaj WM_INITDIALOG la procedura de caseta de dialog. Dacă şablonul specifică stilul DS_SETFONT, funcţia trimite, de asemenea, un mesaj WM_SETFONT la procedura de caseta de dialog. Funcţia afişează caseta de dialog dacă şablonul specifică stilul WS_VISIBLE. În cele din urmă, CreateDialogIndirectParam se întoarce ghidajul fereastra în caseta de dialog.

După întoarcerea în CreateDialogIndirectParam , utilizaţi funcţia ShowWindow pentru a afişa caseta de dialog (dacă nu este deja vizibil). Pentru a distruge caseta de dialog, utilizaţi funcţia DestroyWindow.

Într-un şablon de caseta de standard dialog, structura DLGTEMPLATE ?i fiecare dintre structurile DLGITEMTEMPLATE trebuie aliniat la limitele DWORD . Crearea de date array care urmează o structură DLGITEMTEMPLATE trebuie, de asemenea, aliniat la o limită de DWORD . Toate alte matrice lungime variabilă în şablonul trebuie trebuie aliniat la limitele WORD.

Într-un şablon de caseta de dialog extins, antetul DLGTEMPLATEEX şi fiecare dintre defini?iile DLGITEMTEMPLATEEX control trebuie aliniat la limitele DWORD . Crearea date matrice, în cazul în care orice, care urmează o structură DLGITEMTEMPLATEEX , de asemenea, trebuie să se alinieze la o limită de DWORD . Toate alte matrice lungime variabilă în şablonul trebuie aliniat la limitele WORD.

Toate şirurile de caractere în şablonul de caseta de dialog, cum ar fi titluri pentru caseta de dialog şi butoane, trebuie să fie siruri de caractere Unicode. Pentru a crea cod care funcţionează atât pe Windows şi Windows NT, funcţia MultiByteToWideChar pentru a genera aceste siruri de caractere Unicode.

Windows 95 şi mai târziu:Sistemul poate suporta un maximum de 255 controale pe şablon caseta de dialog. Pentru a plasa mai mult de 255 de controalele din caseta de dialog, crea controale în WM_INITDIALOG mesaj mîner, mai degrabă decât introducerea-le în şablonul.

Windows CE: Casetele de dialog în afara zonei vizibile a ecranului nu sunt repoziţionate automat.

Dacă utilizatorul apasă ALT + H, în timp ce caseta de dialog are focalizarea intrare, sistemul posturi un mesaj WM_HELP pentru regimul de dialog. Cererea trebuie să răspundă la acest mesaj de afişarea ajutorului contextual pentru caseta de dialog.

Următoarele stiluri nu sunt acceptate pentru membru stil structura DLGTEMPLATE :

• DS_SETFONT: Aveţi posibilitatea să setaţi fontul în interiorul casetelor de dialog.
• DS_3DLOOK
• DS_RECURSE: Nu necesar. Orice casetă de dialog copil automat este considerat a fi o casetă de dialog recursivă.
• DS_CONTROL: Nu este necesară.
• WS_EX_CONTROLPARENT: Toate casetele de dialog automat sunt presupuse a fi părinţi de control.

Pentru a obţine poziţionării implicite, utilizaţi stilul DS_CENTER.

Dacă stilul WS_CHILD nu este specificat, se presupune că stilul WS_POPUP.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în winuser.h.
Import Biblioteca:Utilizarea user32.lib.
Unicode:Pus în aplicare ca Unicode şi ANSI versiuni Windows NT.

A se vedea, de asemenea

Prezentare generală a casete de dialog, funcţii caseta de Dialog, CreateDialog, CreateDialogIndirect, CreateDialogParam, CreateWindowEx, DestroyWindow, DialogProc, DLGITEMTEMPLATE, DLGITEMTEMPLATEEX, DLGTEMPLATE, DLGTEMPLATEEX, , MultiByteToWideChar, ShowWindow, WM_INITDIALOG, WM_SETFONT

Index