Windows API一日一練(4)MessageBox函數

 為了顯示提示資訊給使用者，Windows是提供了一個非常方便的API函數MessageBox給使用者使用，使用這個API函數可以顯示簡單的文字資訊出來，提醒或提示使用者進行下一步操作。
函式宣告如下：
WINUSERAPI
int
WINAPI
MessageBoxA(
    __in_opt HWND hWnd,
    __in_opt LPCSTR lpText,
    __in_opt LPCSTR lpCaption,
    __in UINT uType);
WINUSERAPI
int
WINAPI
MessageBoxW(
    __in_opt HWND hWnd,
    __in_opt LPCWSTR lpText,
    __in_opt LPCWSTR lpCaption,
    __in UINT uType);
#ifdef UNICODE
#define MessageBox MessageBoxW
#else
#define MessageBox MessageBoxA
#endif // !UNICODE
從上面可以看出，Windows的API是兩種聲明，一種是使用到ANSI編碼，一種是使用到UNICODE編碼的API函數。通過宏定義把這兩種API名稱統一到MessageBox的聲明。這是一種使用選擇不同API的技術，在今後的編程裡，大多數都需要使用UNICODE編碼了，因為可以適應不同國家的語言顯示，可以國際化編程，特別對於中文支援更加需要UNICODE編程。
下面來解釋一下參數的定義：
hWnd是指向父視窗的控制代碼，如果沒有父視窗，可以把這個參數設定為NULL。
lpText是需要顯示的文字。顯示字串的起始地址。
lpCaption是在視窗上標題顯示。
uType是視窗組合按鈕和顯示表徵圖的類型。後面再詳細說明。
傳回值是一個整數，如果有取消按鈕，並且按下ESC鍵就返回IDCANCEL。如果有其它按鈕，並且按下，就返回相應的值。主要的值如下：
IDABORT 放棄按鈕
IDCANCEL取消按鈕
IDCONTINUE 繼續按鈕
IDIGNORE 忽略按鈕
IDNO 否按鈕
IDOK 確定按鈕
IDRETRY 重試按鈕
IDTRYAGAIN 重試按鈕
IDYES 是按鈕
 
示範例子如下：
 

下載 (71.85 KB)2008-10-8 20:37

上面顯示的代碼是：
#001 //MB_DEFBUTTON4
#002 int CMsgBox::Show_MB_DEFBUTTON4(void)
#003 {
#004 //顯示MB_DEFBUTTON4。
#005 return ::MessageBox(NULL, _T("MB_YESNOCANCEL|MB_DEFBUTTON4|MB_HELP"),
#006         _T("第一個應用程式"), MB_YESNOCANCEL|MB_DEFBUTTON4|MB_HELP|MB_ICONQUESTION);
#007 }
 
uType常用的選擇值如下：
按鈕類型：
MB_ABORTRETRYIGNORE
MB_CANCELTRYCONTINUE
MB_HELP
MB_OK
MB_OKCANCEL
MB_RETRYCANCEL
MB_YESNO
MB_YESNOCANCEL
 
表徵圖類型：
MB_ICONEXCLAMATION
MB_ICONWARNING
MB_ICONINFORMATION
MB_ICONASTERISK
MB_ICONQUESTION
MB_ICONSTOP
MB_ICONERROR
MB_ICONHAND
 
設定預設按鈕值：
MB_DEFBUTTON1
MB_DEFBUTTON2
MB_DEFBUTTON3
MB_DEFBUTTON4
 
修改顯示資訊視窗的屬性：
MB_APPLMODAL
MB_SYSTEMMODAL
MB_TASKMODAL
MB_RIGHT
MB_RTLREADING
MB_SETFOREGROUND
MB_TOPMOST
MB_SERVICE_NOTIFICATION