CreateDialogParam

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

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

Parametrii

hInstance

Identifică o instanta modulului ale căror executable dosar conţine şablonul de caseta de dialog.

lpTemplateName

Identifică şablonul de caseta de dialog. Acest parametru este fie cursorul la un şir null-terminated caractere care specifică numele şablonului de caseta de dialog sau o valoare de tip întreg care specifică identificatorul de resursă de şablonul de caseta de dialog. Dacă parametrul specifică un identificator de resurse, cuvântul său high-comandă trebuie să fie zero şi word-low-comandă trebuie să conţină identificatorul. Utilizaţi macrocomanda MAKEINTRESOURCE pentru a crea această valoare.

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 să treacă la procedura de caseta de dialog în parametrul lParam în 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 CreateDialogParam utilizează funcţia CreateWindowEx pentru a crea caseta de dialog. CreateDialogParam apoi trimite un mesaj de WM_INITDIALOG (şi un mesaj WM_SETFONT) dacă şablonul specifică stilul DS_SETFONT la procedura de caseta de dialog. Funcţia afişează caseta de dialog dacă şablonul specifică stilul WS_VISIBLE. În cele din urmă, CreateDialogParam întoarce ghidajul fereastră din caseta de dialog.

După întoarcerea în CreateDialogParam , aplicarea afişează caseta de dialog (dacă nu este deja afişată) utilizând funcţia ShowWindow . Aplicarea distruge caseta de dialog utilizând funcţia DestroyWindow.

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: Nu toate stilurile sunt acceptate în structura DLGTEMPLATE în şablonul de dialog prevăzute de parametrul lpTemplateName .

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, CreateDialogIndirectParam, CreateWindowEx, DestroyWindow, DialogProc, MAKEINTRESOURCE, ShowWindow, WM_INITDIALOG, WM_SETFONT

Index