WM _ INITDIALOG 訊息

在對話方塊顯示之前,立即傳送至對話方塊程式。 對話方塊程式通常會使用這個訊息來初始化控制項,並執行任何其他會影響對話方塊外觀的初始作業。

#define WM_INITDIALOG                   0x0110

參數

wParam

控制項的控制碼,可接收預設鍵盤焦點。 只有在對話方塊程式傳回 TRUE 時,系統才會指派預設的鍵盤焦點。

lParam

其他初始資料。 這項資料會在用來建立對話方塊的 CreateDialogIndirectParamCreateDialogParamDialogBoxIndirectParamDialogBoxParam函數的呼叫中,當做 lParam 參數傳遞給系統。 針對屬性工作表,此參數是用來建立頁面之 PROPSHEETPAGE 結構的指標。 如果使用任何其他對話方塊建立函式,則此參數為零。

傳回值

對話方塊程式應該會傳回 TRUE ,以指示系統將鍵盤焦點設定為 wParam 所指定的控制項。 否則,它應該會傳回 FALSE ,以防止系統設定預設的鍵盤焦點。

對話方塊程式應該會直接傳回值。 SetWindowLong函數所設定的 DWL _ MSGRESULT 值會被忽略。

備註

接收預設鍵盤焦點的控制項一律是對話方塊中可見、未停用,且具有 WS _ TABSTOP 樣式的第一個控制項。 當對話方塊程式傳回 TRUE 時,系統會檢查控制項,以確定該程式未停用該程式。 如果已停用,系統會將鍵盤焦點設定為可見、未停用,且具有 WS _ TABSTOP 的下一個控制項。

只有當應用程式已將鍵盤焦點設定為對話方塊的其中一個控制項時,才會傳回 FALSE

規格需求

需求
最低支援的用戶端
Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限傳統型應用程式]
標頭
Winuser (包含) 的 Windows。h

另請參閱

參考

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

概念

對話方塊

其他資源

PROPSHEETPAGE