MSGBOXPARAMSA 結構 (winuser.h)

發行項
03/04/2024

包含用來顯示消息框的資訊。 MessageBoxIndirect 函式會使用此結構。

語法

typedef struct tagMSGBOXPARAMSA {
  UINT           cbSize;
  HWND           hwndOwner;
  HINSTANCE      hInstance;
  LPCSTR         lpszText;
  LPCSTR         lpszCaption;
  DWORD          dwStyle;
  LPCSTR         lpszIcon;
  DWORD_PTR      dwContextHelpId;
  MSGBOXCALLBACK lpfnMsgBoxCallback;
  DWORD          dwLanguageId;
} MSGBOXPARAMSA, *PMSGBOXPARAMSA, *LPMSGBOXPARAMSA;

成員

cbSize

類型： UINT

結構大小，以位元組為單位。

hwndOwner

類型： HWND

擁有者視窗的句柄。這個成員可以是 NULL。

hInstance

類型： HINSTANCE

模組的句柄，其中包含 lpszIcon 成員所識別的圖示資源，以及 由 lpszText 或 lpszCaption 成員識別的字串資源。

lpszText

類型： LPCTSTR

以 Null 結束的字串或字串資源的識別碼，其中包含要顯示的訊息。

lpszCaption

類型： LPCTSTR

包含消息框標題的 Null 終止字串或字串資源的識別碼。如果此成員為 NULL，則會使用預設標題 Error 。

dwStyle

類型： DWORD

對話框的內容和行為。這個成員可以是 MessageBoxEx 函式 uType 參數所描述的旗標組合。

此外，如果您想要消息框顯示 lpszIcon 成員指定的圖示，您可以指定MB_USERICON旗標 (0x00000080L) 。

lpszIcon

類型： LPCTSTR

識別圖示資源。此參數可以是以 Null 結尾的字串或傳遞至 MAKEINTRESOURCE 宏的整數資源識別碼。

若要載入其中一個標準系統定義的圖示，請將 hInstance 成員設定為 NULL ，並將 lpszIcon 設定為 LoadIcon 函式所列的其中一個值。

如果 dwStyle 成員未指定 MB_USERICON 旗標，則會忽略這個成員。

dwContextHelpId

類型： DWORD_PTR

識別說明內容。如果發生說明事件，則會在消息框傳送至擁有者視窗或回呼函式的 HELPINFO 結構中指定此值。

lpfnMsgBoxCallback

類型： MSGBOXCALLBACK

回呼函式的指標，可處理消息框的說明事件。回呼函式的格式如下：

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

如果此成員為 NULL，則消息框會在發生說明事件時，將 WM_HELP 訊息傳送至擁有者視窗。

dwLanguageId

類型： DWORD

顯示預先定義按鈕中包含的文字的語言。這個值必須是 MAKELANGID 宏所傳回的格式。

如需支援的語言標識碼清單，請參閱語言標識碼。請注意，每個當地語系化版本的 Windows 通常只包含一組有限的語言資源。例如，美國版本提供 LANG_ENGLISH、法文版本提供 LANG_FRENCH、德文版本提供 LANG_GERMAN，而日文版本則提供 LANG_JAPANESE。每個版本都提供 LANG_NEUTRAL。這會限制可與 dwLanguageId 參數搭配使用的值集。指定語言識別碼之前，您應該先列舉安裝在系統上的地區設定。

備註

注意

winuser.h 標頭會根據 UNICODE 預處理器常數的定義，將 MSGBOXPARAMS 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	winuser.h (包括 Windows.h)