函式功能
CreateDialog宏從一個對話框模板資源創建一個無模式的對話框,CreateDiaog宏使用CreateDialogParam函式。函式原型:HWND CreateDialog(HINSTANCE hlnstance,LPCTSTR lpTemplate,HWND hWndParent,DLGPROC IpDialogFunc);
參數
hlnstance:標識模組事例,該模組的執行檔含有對話框模板。
pTemplate: 標識對話框模板,此參數或是指向一個以結尾的字元串指針,該字元串指定對話框模板名,或是指定對話框模板的資源標識符的一個整型值。如果此參數指定了一個資源標識符,則它的高位字一定為零,且低位字一定含有標識符,一定用MAKEINTRESOURCE宏來創建此值。
hWndParent: 標識擁有對話框的視窗。
lpDialogFunc: 指向對話框應用程式的指針。有關更多的對話框應用程式的指針,參見DialogProc。
返回值:如果函式調用成功,則返回值為指向對話框的句柄;如果函式調用失敗,則返回值為NULL。若想獲得更多的錯誤信息,可調用GetLastError函式。
備註
CreateDialog函式用CreateWindowEx函式來創建對話框。然後CreateDialog函式把一個WM_INITDIALOG訊息(如果模板指定DS_SETFONT類型,則加上一個WM_SETFONT訊息)傳送到對話框應用程式。如果模板指定WS_VISIBLE風格,則函式顯示對話框,最後CreateDlalog返回指向對話框的視窗句柄。CreateDialog函式返回之後,應用程式通過Showwindow函式顯示對話框(如果還沒有顯示)。應用程式通過利用DestroyWindow函式來清除對話框。Windows 95和以後版本:系統每個對話框模板可以支持最多達 255個控制。如果要把多於255個控制放入對話框中,必須在WM_INITDIALOG訊息處理器中創建控制,而不是把它們放入模板中。Windows CE:IpTempIate參數指向的對話框模板中,DIGTEMPLATE結構並不支持所有類型。
速查:Windows NT:3.1及以上版本:Windows:95及以上版本:Windows CE:1.0及以上版本:頭檔案:Winuser.h;庫檔案:user32.lib; Unicode: Unicode:在 Windows NT上實現為 Unicode和ANSI兩種版本。