共用方式為


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 鍵任何作用。

函式 AfxFormatString1AfxFormatString2 可以用來顯示在訊息方塊文字的格式設定。

備註

這樣的第一個表單的多載函式會顯示文字字串所指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

請參閱

參考

CWnd::MessageBox

概念

MFC 巨集和全域變數