shellMessageBoxW 函数 (shellapi.h)
[ShellMessageBox 可在“要求”部分指定的操作系统中使用。 它在后续版本中可能已更改或不可用。]
ShellMessageBox 是 MessageBox 的特殊实例,提供使用所有者窗口标题作为消息框标题的选项。
语法
int ShellMessageBoxW(
[in] HINSTANCE hAppInst,
[in] HWND hWnd,
[in] LPCWSTR lpcText,
[in] LPCWSTR 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 |