MSGBOXPARAMSA 結構 (winuser.h)
包含用來顯示消息框的資訊。 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) |
另請參閱
概念
其他資源
參考
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應