共用方式為

ShellMessageBoxA 函式 （shellapi.h）

  • 發行項

[ShellMessageBox 可用於需求一節中指定的作業系統。 後續版本可能會變更或無法使用。

ShellMessageBox 是 messageBox 的特殊實例，提供使用擁有者視窗標題做為消息框標題的選項。

語法

int ShellMessageBoxA(
  [in] HINSTANCE hAppInst,
  [in] HWND      hWnd,
  [in] LPCSTR    lpcText,
  [in] LPCSTR    lpcTitle,
  [in] UINT      fuStyle,
       ...       
);

參數

[in] hAppInst

類型：HINSTANCE

要從中載入名為 pszTitle字串資源的模組句柄。 如果 pszTitle 未命名字符串資源，則會忽略此參數。 如果 pszMsg 或 pszTitle 為資源標識符，則此值必須有效。

[in] hWnd

類型：HWND

要建立之消息框的擁有者視窗句柄。 如果這個變數未 NULL，則會使用擁有者視窗的標題做為消息框的標題。

[in] lpcText

類型：LPCTSTR

Null 終止字串的指標，其中包含要顯示的訊息，或指定要從中擷取訊息的資源識別碼。

[in] lpcTitle

類型：LPCTSTR

Null 終止字串的指標，其中包含要擷取標題的對話框標題或指定要擷取標題的資源標識碼。 如果此參數和 hWnd 都 NULL，則不會顯示標題。 如果此參數指向以MAKEINTRESOURCE 巨集 所形成的可載入資源，則會覆寫 hWnd 作為標題。

[in] fuStyle

類型：UINT

指定對話框的內容和行為。 如需可能的值，請參閱 MessageBox。

...

與 pszMsg 結合的變數自變數清單，以形成消息框中顯示的全文。

傳回值

類型：int

整數值，表示消息框中按下的按鈕。 如需特定值，請參閱 MessageBox。

如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 shellapi.h
連結庫 Shlwapi.lib
DLL Shlwapi.dll

另請參閱

MAKEINTRESOURCE

MessageBox