WM_INITDIALOG訊息

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

#define WM_INITDIALOG                   0x0110

參數

wParam

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

lParam

其他初始化資料。 此資料會在呼叫CreateDialogIndirectParam、CreateDialogParamDialogBoxIndirectParamDialogBoxParam函式時,以lParam參數的形式傳遞給系統。 對於屬性工作表,此參數是用來建立頁面之 PROPSHEETPAGE 結構的指標。 如果使用任何其他對話方塊建立函式,此參數為零。

傳回值

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

對話方塊程式應該會直接傳回值。 會忽略 SetWindowLong函式所設定的DWL_MSGRESULT值。

備註

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

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

規格需求

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

另請參閱

參考

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

概念

對話方塊

其他資源

PROPSHEETPAGE