函式介
紹函式功能:該函式清除一個模態對話框,並使系統中止對對話框的任何處理。
函式原型: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。