DialogBoxParam

Funkcja DialogBoxParam tworzy modalnego okna dialogowego z okna dialogowego pole szablonu zasobu. Przed wyświetleniem okna dialogowego, funkcja przekazuje wartość zdefiniowanych przez aplikację do procedury pole dialogowe jako parametr fikcyjnymi wiadomości WM_INITDIALOG . Aby zainicjować formantów okna dialogowego aplikacji można użyć tej wartości.

int DialogBoxParam ( Wystąpienie HINSTANCE  wystąpienie hInstance, / / dojście do instancji aplikacjiLPCTSTRlpTemplateName, / / identyfikuje okna dialogowego pole szablonuHWNDhWndParent, / / dojście do okna właścicielaDLGPROClpDialogFunc, / / wskaźnik, aby oknie dialogowym pole proceduryFIKCYJNYMIdwInitParam / / Inicjowanie wartości);
 

Parametry

wystąpienie hInstance

Identyfikuje wystąpienie modułu, dla którego plik wykonywalny zawiera szablon pola, okno dialogowe.

lpTemplateName

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.

dwInitParam

Określa wartość, aby przejść do okna dialogowego w parametrze fikcyjnymi wiadomości WM_INITDIALOG.

Zwraca wartości

Jeśli funkcja, wartość zwracana jest wartość parametru 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

Funkcja DialogBoxParam funkcja funkcji CreateWindowEx utworzyć okna dialogowego. DialogBoxParam 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 , DialogBoxParam 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 lpTemplateName .

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

Index