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 是资源 ID，则此值必须有效。

[in] hWnd

类型：HWND

要创建的消息框的所有者窗口的句柄。 如果此变量不为 NULL，则所有者窗口的标题将用作消息框的标题。

[in] lpcText

类型： LPCTSTR

指向以 null 结尾的字符串的指针，该字符串包含要显示的消息或指定要从何处检索消息的资源 ID。

[in] lpcTitle

类型： LPCTSTR

指向以 null 结尾的字符串的指针，该字符串包含对话框标题或指定要检索标题的资源 ID。 如果此参数和 hWnd 均为 NULL，则不显示标题。 如果此参数指向使用 MAKEINTRESOURCE 宏形成的可加载资源，它将替代 hWnd 作为标题。

[in] fuStyle

类型： UINT

指定对话框的内容和行为。 有关可能的值，请参阅 MessageBox。

...

一个变量参数列表，它与 pszMsg 组合在一起，形成消息框中显示的全文。

返回值

类型： int

一个整数值，指示在消息框中按下的按钮。 有关特定值，请参阅 MessageBox。

如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。

注解

注意

shellapi.h 标头将 ShellMessageBox 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shellapi.h
Library Shlwapi.lib
DLL Shlwapi.dll

另请参阅

MAKEINTRESOURCE

MessageBox