WM_INITDIALOG meddelande

Skickas till dialogrutan omedelbart innan en dialogruta visas. Dialogruteprocedurer använder vanligtvis det här meddelandet för att initiera kontroller och utföra andra initieringsuppgifter som påverkar dialogrutans utseende.

#define WM_INITDIALOG                   0x0110

Parameterar

wParam

Ett handtag till kontrollen för att få standardtangentbordets fokus. Systemet tilldelar endast standardtangentbordets fokus om dialogruteproceduren returnerar TRUE.

lParam

Ytterligare initieringsdata. Dessa data skickas till systemet som parametern lParam i ett anrop till funktionen CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam eller DialogBoxParam som används för att skapa dialogrutan. För egenskapsblad är den här parametern en pekare till PROPSHEETPAGE-strukturen som används för att skapa sidan. Den här parametern är noll om någon annan dialogruteskapandefunktion används.

Returvärde

Dialogruteproceduren ska returnera TRUE för att dirigera systemet för att ställa in tangentbordets fokus på den kontroll som anges av wParam. Annars bör den returnera FALSE för att förhindra att systemet ställer in standardtangentbordets fokus.

Dialogrutans procedur ska returnera värdet direkt. Det DWL_MSGRESULT värde som anges av funktionen SetWindowLong ignoreras.

Anmärkningar

Kontrollen för att ta emot standardtangentbordets fokus är alltid den första kontrollen i dialogrutan som är synlig, inte inaktiverad och som har WS_TABSTOP formatmall. När dialogruteproceduren returnerar TRUE kontrollerar systemet kontrollen för att säkerställa att proceduren inte har inaktiverat den. Om det har inaktiverats ställer systemet in tangentbordets fokus på nästa kontroll som är synlig, inte inaktiverad och har WS_TABSTOP.

Ett program kan bara returnera FALSE om det har ställt in tangentbordsfokus på en av kontrollerna i dialogrutan.

Kravspecifikation

Krav	Värde
Lägsta klient som stöds	Windows 2000 Professional [endast skrivbordsappar]
Lägsta server som stöds	Windows 2000 Server [endast skrivbordsappar]
Header	Winuser.h (inkludera Windows.h)

Se även

Referens

CreateDialogIndirectParam

SkapaDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

Konceptuell

Dialogrutor

Andra resurser

PROPSHEETPAGE