MessageBox
顯示模態的對話框
MessageBox指的是顯示一個模態對話框,其中包含一個系統圖標、一組按鈕和一個簡短的特定於應用程序消息,如狀態或錯誤的信息。消息框中返回一個整數值,該值指示用戶單擊了哪個按鈕。
hWnd:
此參數代表消息框擁有的窗口。如果為NULL,則消息框沒有擁有窗口。
lpText:
消息框的內容。如果使用了Unicode庫,則把文本變成:
lpCaption:
消息框的標題。如果使用了Unicode庫,則把文本變成:
uType:
指定一個決定對話框的內容和行為地位標誌集。此參數可以為下列標誌組中標誌的組合。指定下列標誌中的一個來顯示消息框中的按鈕以及圖標。
按鈕:
按鈕參數 | 含義 |
MB_OK | 默認值。有一個確認按鈕在裡面。 |
MB_YESNO | 有是和否在裡面。 |
MB_ABORTRETRYIGNORE | 有Abort(放棄),Retry(重試)和Ignore(跳過) |
MB_YESNOCANCEL | 消息框含有三個按鈕:Yes,No和Cancel |
MB_RETRYCANCEL | 有Retry(重試)和Cancel(取消) |
MB_OKCANCEL | 消息框含有兩個按鈕:OK和Cancel |
附:
圖標:
參數 | 含義 |
MB_ICONEXCLAMATION | 一個驚嘆號出現在消息框 |
MB_ICONWARNING | 一個驚嘆號出現在消息框 |
MB_ICONINFORMATION | 一個圓圈中小寫字母i組成的圖標出現在消息框 |
MB_ICONASTERISK | 一個圓圈中小寫字母i組成的圖標出現在消息框 |
MB_ICONQUESTION | 一個問題標記圖標出現在消息框 |
MB_ICONSTOP | 一個停止消息圖標出現在消息框 |
MB_ICONERROR | 一個停止消息圖標出現在消息框 |
MB_ICONHAND | 一個停止消息圖標出現在消息框 |
形態:
參數 | 含義 |
MB_APPLMODAL | 在hwnd參數標識的窗口中繼續工作以前,用戶一定響應消息框。但是,用戶可以移動到其他線程的窗口且在這些窗口中工作。根據應用程序中窗口的層次結構,用戶則以移動到線程內的其他窗口。所有母消息框的子窗口自動地失效,但是彈出窗口不是這樣。如果既沒有指定MB_SYSTEMMODAL也沒有指定MB_TASKMOOAL,則MB_APPLMODAL為預設的。 |
MB_SYSTEMMODAL | 除了消息框有WB_EX_TOPMOST類型,MB_APPLMODAL和MB_SYSTEMMODAL一樣。用系統模態消息框來改變各種各樣的用戶,主要的損壞錯誤需要立即注意(例如,內存溢出)。如果不是那些與hwnd聯繫的窗口,此標誌對用戶對窗口的相互聯繫沒有影響。 |
MB_TASKMODAL | 如果參數hwnd為NULL的話,那麼除了所有屬於當前線程高層次的窗口失效外,MB_TASKMODALL和MB_APPLMODAL一樣。當調用應用程序或庫沒有一個可以得到的窗口句柄時,使用此標誌。但仍需要阻止輸入到調用線程的其他窗口,而不是擱置其他線程。 |
其他:
標誌 | 含義 |
MB_DEFAULT_DESKTOP_ONLY | 接收輸入的當前桌面一定是一個預設桌面。否則,函數調用失敗。預設桌面是一個在用戶已經紀錄且以後應用程序在此上面運行的桌面。 |
MB_HELP | 把一個Help按鈕增加到消息框。選擇Help按鈕或按F1產生一個Help事件。 |
MB_RIGHT | 文本為右調整 |
MB_RTLREADING | 用在Hebrew和Arabic系統中從右到左的順序顯示消息和大寫文本。 |
MB_SETFOREGROUND | 消息框變為前景窗口。在內部系統為消息個調用SetForegroundWindow函數。 |
MB_TOPMOST | 消息框用WS_EX_TOPMOST窗口類型來創建MB_SERVICE_NOTIFICATION。 |
ID | 選擇了…… |
IDOK(1) | OK |
IDCANCEL(2) | CANCEL |
IDABORT(3) | ABORT |
IDRETRY(4) | RETRY |
IDIGNORE(5) | IGNORE |
IDYES(6) | YES |
IDNO(7) | NO |
通過將 uType 參數設置為相應的標誌值,可以在消息框中系統圖標,具體圖標可參見MSDN網站。
圖標 | 標誌位置 |
MB_ICONHAND, MB_ICONSTOP, 或者 MB_ICONERROR | |
MB_ICONQUESTION | |
MB_ICONEXCLAMATION 或者 MB_ICONWARNING | |
MB_ICONASTERISK 或者 MB_ICONINFORMATION |
添加兩個從右到左標記(RLMs),Unicode 格式字元中用 U+200F表示。在消息框顯示字元串的開頭被由 MessageBox 渲染引擎解釋,以致造成 MessageBox 的閱讀順序,呈現為從右向左 (RTL) 。
當您使用一個系統模式消息框指示時,當系統內存不足時,由 lpText 和 lpCaption 的參數的字元串不應被從資源文件,因為載入資源的嘗試可能會失敗。
如果在一個對話框存在時創建一個消息框,則使用對話框的句柄作為hWnd 參數。hWnd參數不應指定為一個子窗口,就像對話框中的控制項一樣。
第一步:彈出對話框。語句:
對話框彈出
選擇Yes
選擇No
假如創建一個MFC工程,如果工程文檔中有MainFrm.cpp的話,那麼,本函數就被封裝成了:
lpszText:指向一個字元串包含要顯示的消息。
lpszCaption:指向一個字元串包含標題。
nType:指定消息框的內容和行為。
指定函數的結果。
下面的例子可以讓對比兩種函數的用法,兩行代碼的功能都是顯示一個消息框,內容為“示例用法”
::MessageBox(NULL, "示例用法", "demo", MB_OK);
MessageBox("示例用法");//採用了一些C++的語法特性使用消息框用起來更順手
函數原型:
參數說明:
(1)Text:必選項,消息框的正文。
(2)Title:可選項,消息框的標題。
(3)MessageBoxButtons:可選項,消息框的按鈕設置,默認只顯示【確定】按鈕。
OK――確定 OKCancel――確定和取消 AbortRetryIgnore――終止、重試和忽略
YesNoCancel――是、否和取消 YesNo――是和否 RetryCancel――重試和取消
(4)MessageBoxIcon:對話框中顯示的圖標樣式,默認不顯示任何圖標。
Question――問號 Information、Asterisk――i號 Error、Stop、Hand――錯誤號
Warning、Exclamation――!號 None――不顯示任何圖標
(5)MessageBoxDefaultButtons:可選項,對話框中默認選中的按鈕設置。
DefaultButton1――第1個button是默認按鈕
DefaultButton2――第2個button是默認按鈕
DefaultButton3――第3個button是默認按鈕
備註:函數原型中藍色字體部分的參數,可以通過點來獲取其後面跟隨的參數值。