DialogBox

Makro DialogBox tworzy modalnego okna dialogowego z okna dialogowego pole szablonu zasobu. DialogBox nie zwrócić sterowanie, aż funkcja wywołania zwrotnego określonego kończy modalnego okna dialogowego przez wywołanie funkcji EndDialog . Makro DialogBox używa funkcji DialogBoxParam.

int DialogBox ( Wystąpienie HINSTANCE  wystąpienie hInstance, / / dojście do instancji aplikacjiLPCTSTRlpTemplate, / / identyfikuje okna dialogowego pole szablonu HWNDhWndParent, / / 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 parametr nResult w wywołaniu funkcji EndDialog , używane do zakończenia okno dialogowe.

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

Uwagi

Makro DialogBox używa funkcji funkcji CreateWindowEx , aby utworzyć okna dialogowego. DialogBox 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 (niezależnie od o czy szablonu określa styl WS_VISIBLE), wyłącza okno właściciela i uruchamia własny Pętla wiadomości do pobierania i wysyłania wiadomości w oknie dialogowym.

Gdy procedura pole dialogowe wywołuje funkcję EndDialog , DialogBox niszczy okno dialogowe, kończy się pętla komunikatów, umożliwia okno właściciela (jeśli wcześniej włączony) i zwraca parametr nResult , określony zgodnie z procedurą pole dialogowe po wywołaniu EndDialog.

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, CreateDialog, funkcji CreateWindowEx, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT

Index