函式功能
函式功能;該函式根據記憶體中對話框模板創建一個模態的對話框。在顯示對話框之前,函式把一個應用程式定義的值作為WM_INITDIALOG訊息的IParam參數傳到對話框過程,應用程式可用此值來初始化對話框控制。
函式原型:int DialogBoxlndirectParam(HINSTANCE hlnstance,LPCDLGTEMPLATE hDialogTemplate, HWND hWndParent,DLGPROC IpDiaIogFunc,LPARAM dwlnitParam);
參數
hlnstance:標識一個模組的事例,該模組創建對話框。
hDialogTemplate:此參數指向含有一個模板的全局記憶體對象的指針。DialogBoxlndirectParam用此模板創建對話框。對話框模板由描述對話框的標題組成,跟隨著標題之後的是描述每一個控制的一個或多個數據塊,模板可以用標準格式或擴展格式。
在標準模板中,標題是由DLGTEMPLATE結構跟隨一個變長數組組成。每個控制的數據是由DLGTEMPLATE結構跟隨一個變長數組組成。
在擴展模板中,標題用DLGTEMPLATEEX格式,且控制定義用DLGITEMPLATEEX格式。
hWndParent:指定擁有對話框的視窗。
IpDirlogFunc:指向對話框過程的指針。有關對話框過程更詳細的信息請參見DialogProc。
dwlnitParam:指定傳遞到WM_INITDIALOG訊息的IParam參數中的對話框的值。
返回值:如果函式調用成功,則返回值為在函式EndDialog的調用中的nResult參數,該EndDialog函式用於中止對話框。如果函式調用失敗,則返回值為C1。若想獲得更多的錯誤信息,請調用GetLastError函式。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:1.0及以上版本;頭檔案:Winuser.h;庫檔案:user32.lib;Unicode:在Windows NT上實現為Unicode和ANSI兩種版本。