AfxMessageBox
在螢幕上顯示訊息方塊。
int AfxMessageBox(
LPCTSTR lpszText,
UINT nType = MB_OK,
UINT nIDHelp = 0
);
int AFXAPI AfxMessageBox(
UINT nIDPrompt,
UINT nType = MB_OK,
UINT nIDHelp = (UINT
) -1
);
參數
lpszText
指向 CString 物件或者包含要顯示在訊息方塊中之訊息、以 null 結尾的字串。nType
訊息方塊的樣式。 將任何訊息方塊樣式套用至方塊。nIDHelp
訊息的說明內容 ID；0 表示要使用應用程式的預設說明內容。nIDPrompt
唯一 ID，用來參考字串資料表中的字串。
傳回值
如果記憶體不足無法顯示訊息方塊則為零，否則傳回下列其中一個值：
IDABORT：已選取 [中止] 按鈕。
IDCANCEL：已選取 [取消] 按鈕。
IDIGNORE：已選取 [忽略] 按鈕。
IDNO：已選取 [否] 按鈕。
IDOK：已選取 [確定] 按鈕。
IDRETRY：已選取 [重試] 按鈕。
IDYES：已選取 [是] 按鈕。
如果訊息方塊有 [取消] 按鈕，當按下 ESC 按鍵或選取 [取消] 按鈕時，會傳回 IDCANCEL 值。 如果訊息方塊沒有 [取消] 按鈕，按下 ESC 鍵會不有任何作用。
函式 AfxFormatString1 和 AfxFormatString2 非常適用於格式化顯示在訊息方塊中的文字。
備註
這個多載函式的第一種形式會在訊息方塊中顯示 lpszText 所指向的文字字串，並使用 nIDHelp 來描述說明內容。 說明內容是在使用者按下說明鍵 (通常是 F1) 時，用來跳至相關的說明主題。
函式的第二個形式會使用 ID 為 nIDPrompt 的字串資源，在訊息方塊中顯示訊息。 相關聯的說明頁面是透過 nIDHelp的值來找到。 如果使用 nIDHelp 的預設值 (– 1)，字串資源 ID nIDPrompt 會用於說明主題。 如需定義說明主題的詳細資訊，請參閱技術提示 28。
範例
// A simple message box, with only the OK button.
AfxMessageBox(_T("Simple message box."));
// A message box that uses a string from a string table
// with yes and no buttons and the stop icon.
// NOTE: nStringID is an integer that contains a valid id of
// a string in the current resource.
AfxMessageBox(nStringID, MB_YESNO|MB_ICONSTOP);
需求
標題: afxwin.h