CreateDialog

Makro CreateDialog tworzy okno dialogowe niemodalny z okna dialogowego pole szablonu zasobu. Makro CreateDialog używa funkcji CreateDialogParam.

(HWND CreateDialog Wystąpienie HINSTANCE  wystąpienie hInstance, / / dojście do instancji aplikacjiLPCTSTRlpTemplate, / / identyfikuje nazwa szablonu pole dialogoweHWNDhWndParent, / / dojście do okna właścicielaDLGPROClpDialogFunc / / wskaźnik, aby oknie dialogowym pole procedury);
 

Parametry

wystąpienie hInstance
Identyfikuje wystąpienie modułu, dla którego plik wykonywalny zawiera szablon pola, okno dialogowe.
lpTemplate
Określa szablon pole dialogowe. Ten parametr jest wskaźnik, aby ciąg znaków zakończony zerem, określający nazwę szablonu pole dialogowe lub wartość całkowitą, która określa identyfikator zasobu szablonu pole dialogowe. Jeśli parametr określa identyfikator zasobów, jego słowo wysokich numerach musi być równe zero i jego słowo bity musi zawierać identyfikator. Aby utworzyć tę wartość można użyć makra MAKEINTRESOURCE.
hWndParent
Identyfikuje okno, w którym posiada okno dialogowe.
lpDialogFunc
Wskaźnik do procedury pole dialogowe. Aby uzyskać więcej informacji na temat procedury pole dialogowe zobacz DialogProc.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest dojście do okna dialogowego.

Jeśli funkcja zawiedzie, wartość zwracana jest wartość NULL. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Funkcja CreateDialog funkcja funkcji CreateWindowEx utworzyć okna dialogowego. CreateDialog następnie wysyła wiadomość WM_INITDIALOG (i wiadomość WM_SETFONT ) Jeśli szablon określa styl DS_SETFONT procedurze pole dialogowe. Funkcja wyświetla okno dialogowe, jeśli szablon określa styl WS_VISIBLE. Wreszcie CreateDialog zwraca uchwyt okna dialogowe.

Po CreateDialog , aplikacja wyświetla okna dialogowego (jeśli nie jest już wyświetlana) przy użyciu funkcji ShowWindow . Stosowanie niszczy okno dialogowe za pomocą funkcji DestroyWindow.

Systemu Windows 95 lub nowszym:System może obsługiwać maksymalnie 255 formanty na okno dialogowe pole szablonu. Aby umieścić więcej niż 255 formantów w oknie dialogowym, należy utworzyć formanty obsługi wiadomości WM_INITDIALOG, zamiast wprowadzania ich w szablonie.

Systemu Windows CE: Nie wszystkie style są obsługiwane w strukturze DLGTEMPLATE w szablonie okno dialogowe określone przez parametr lpTemplate .

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Należy użyć user32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Omówienie pola dialogowego, okno dialogowe pole funkcji, CreateDialogIndirect, CreateDialogIndirectParam, CreateDialogParam, funkcji CreateWindowEx, DestroyWindow, DialogBox, DialogProc, ShowWindow, WM_INITDIALOG, WM_SETFONT

Index