DialogBoxIndirectParam

Funcţia DialogBoxIndirectParam creează o casetă de dialog modale 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.

int () DialogBoxIndirectParam HINSTANCE  hInstance, / / ocupa de instanta applicationLPCDLGTEMPLATEhDialogTemplate,  / / identifică şablonul caseta de dialogHWNDhWndParent, / / ocupa proprietarul fereastraDLGPROClpDialogFunc, / / indicatorul pentru a dialog box proceduraLPARAMdwInitParam / / iniţializare valoarea);
 

Parametrii

hInstance

Identifică instanta modulului care creează caseta de dialog.

hDialogTemplate

Cursorul într-un obiect de memorie globală care con?in un şablon care DialogBoxIndirectParam 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 pentru o casetă de dialog, 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 extins pentru o casetă de dialog, antetul utilizează formatul DLGTEMPLATEEX ?i defini?iile control utilizează formatul DLGITEMTEMPLATEEX.

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.

dwInitParam

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 parametrul nResult specificate în apelul la funcţia de EndDialog care a fost utilizat pentru a pune capăt caseta de dialog.

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

Observaţii

Funcţia de DialogBoxIndirectParam utilizează funcţia CreateWindowEx pentru a crea caseta de dialog. DialogBoxIndirectParam 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 (indiferent dacă şablonul specifică stilul WS_VISIBLE), dezactivează fereastra proprietar, şi începe propria bucla de mesaj pentru a prelua şi expediere mesaje pentru caseta de dialog.

Când caseta de dialog procedura apelează funcţia EndDialog , DialogBoxIndirectParam distruge caseta de dialog, se termină bucla mesaj, permite fereastra proprietarul (dacă activat anterior) şi returnează parametrul nResult specificate prin procedura de caseta de dialog atunci când a numit EndDialog.

Î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: 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.

Pentru alte restricţii de dialog, consultaţi CreateDialogIndirectParam.

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, CreateWindowEx, DialogBox, DialogBoxIndirect, DialogBoxParam, DialogProc, DLGITEMTEMPLATE, DLGITEMTEMPLATEEX, DLGTEMPLATE, DLGTEMPLATEEX, EndDialog, MultiByteToWideChar, WM_INITDIALOG, WM_SETFONT

Index