EndDialog

EndDialog

EndDialog ,該函數清除一個模態對話框,並使系統中止對對話框的任何處理。

函數介


紹函數功能:該函數清除一個模態對話框,並使系統中止對對話框的任何處理。
函數原型:BOOL EndDialog(HWND hDlg,int nResult);

參數


hDlg:表示要被清除的對話框窗口。NResult:指定從創建對話框函數返回到應用程序的值。
返回值:如果函數調用成功,則返回值為非零值;如果函數調用失敗則返回值為零。若想獲得錯誤信息請調用GetLastError函數。

備註


DialogBox,DialogBoxParam、DialogBoxlndirect和DialogBoxlndirectParam函數創建的對話框一定要用EndDialog函數來清除。應用程序從對話框應用程序內部調用EndDialog函數,該函數不能為其他目的而供使用。對話框應用程序可以在任何時間調用EndDialog函數;甚至在WM_INITDIALOG消息處理過程中。如果應用程序在WM_INTDIALOG消息處理過程中調用該函數,則對話框在顯示和輸入焦點被設置之前對話框被清除。EndDialog函數並不立即清除對話框。而是設置一個標誌,並且允許對話框應用程序把控制權返回系統。系統在試圖從應用程序隊列檢索下一個消息之前檢測標誌。如果已經設置了標誌則系統中止消息循環,清除對話框,且用nResUlt中的值作為從創建對話框的函數中返回的值。

速查


Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:1.0及以上版本;頭文件:winuser.h;庫文件:user32.lib。