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
說明主題代碼訊息。 0 表示將會使用應用程式的預設說明內容。nIDPrompt
用來參考字串在字串資料表內是唯一的識別碼。
傳回值
如果沒有可用的記憶體不足，無法顯示訊息方塊 ； 零 否則，會傳回下列值之一：
IDABORT 已選取 [中止] 按鈕。
IDCANCEL 選取 [取消] 按鈕。
IDIGNORE 已選取 [忽略] 按鈕。
IDNO 選取 [否] 按鈕。
IDOK 選取 [確定] 按鈕。
IDRETRY 選取 [重試] 按鈕。
IDYES 已選取 [是] 按鈕。
如果訊息方塊有一個 [取消] 按鈕， IDCANCEL 會傳回值，如果按下 ESC 鍵，或選取 [取消] 按鈕。 如果 [訊息] 方塊中沒有 [取消] 按鈕，按 ESC 鍵任何作用。
函式 AfxFormatString1 和 AfxFormatString2 可以用來顯示在訊息方塊文字的格式設定。
備註
這樣的第一個表單的多載函式會顯示文字字串所指lpszText在訊息方塊，並使用nIDHelp來描述說明內容。 說明內容用來跳至相關聯的 [說明] 主題，當使用者按下說明按鍵 (通常是 F1)。
函式的第二個表單使用的字串資源識別碼為nIDPrompt在訊息方塊中顯示的訊息。 關聯的說明網頁找到的值透過nIDHelp。 如果預設值的nIDHelp用 (– 1) 的字串資源識別碼， 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