MSGBOXPARAMSA 結構（winuser.h）

發行項
11/20/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，則會使用預設標題錯誤。

dwStyle

類型：DWORD

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

此外，如果您想要消息框顯示 lpszIcon 成員所指定的圖示，您可以指定 MB_USERICON 旗標（0x00000000080L）。

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 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	winuser.h （包括 Windows.h）