komunikat WM_INITDIALOG

Wysłane do procedury okna dialogowego bezpośrednio przed wyświetleniem okna dialogowego. Procedury okna dialogowego zwykle używają tego komunikatu do inicjowania kontrolek i wykonywania innych zadań inicjowania, które mają wpływ na wygląd okna dialogowego.

#define WM_INITDIALOG                   0x0110

Parametry

wParam

Uchwyt do kontrolki w celu odebrania domyślnego fokusu klawiatury. System przypisuje domyślny fokus klawiatury tylko wtedy, gdy procedura okna dialogowego zwraca wartość TRUE.

lParam

Dodatkowe dane inicjowania. Te dane są przekazywane do systemu jako parametr lParam w wywołaniu metody CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam lub DialogBoxParam używanej do tworzenia okna dialogowego. W przypadku arkuszy właściwości ten parametr jest wskaźnikiem do struktury PROPSHEETPAGE użytej do utworzenia strony. Ten parametr jest zerowy, jeśli jest używana inna funkcja tworzenia okna dialogowego.

Wartość zwracana

Procedura okna dialogowego powinna zwrócić wartość TRUE , aby skierować system, aby ustawić fokus klawiatury na kontrolkę określoną przez wParam. W przeciwnym razie należy zwrócić wartość FALSE , aby uniemożliwić systemowi ustawienie domyślnego fokusu klawiatury.

Procedura okna dialogowego powinna zwrócić wartość bezpośrednio. Wartość DWL_MSGRESULT ustawiona przez funkcję SetWindowLong jest ignorowana.

Uwagi

Kontrolka do odbierania domyślnego fokusu klawiatury jest zawsze pierwszą kontrolką w oknie dialogowym, która jest widoczna, a nie wyłączona i ma styl WS_TABSTOP . Gdy procedura okna dialogowego zwraca wartość TRUE, system sprawdza kontrolkę, aby upewnić się, że procedura nie została wyłączona. Jeśli została wyłączona, system ustawia fokus klawiatury na następną kontrolkę, która jest widoczna, a nie wyłączona i ma WS_TABSTOP.

Aplikacja może zwracać wartość FALSE tylko wtedy, gdy ustawiła fokus klawiatury na jedną z kontrolek okna dialogowego.

Requirements

Zobacz także

Referencja

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

Koncepcje

Okien dialogowych

Inne zasoby

PROPSHEETPAGE