IUserNotification：：SetBalloonInfo 方法 (shobjidl_core.h)

项目
03/02/2024

设置要显示在气球通知中的信息。

语法

HRESULT SetBalloonInfo(
  [in] LPCWSTR pszTitle,
  [in] LPCWSTR pszText,
  [in] DWORD   dwInfoFlags
);

参数

[in] pszTitle

类型： LPCWSTR

指向 Unicode 字符串的指针，该字符串指定通知的标题。

[in] pszText

类型： LPCWSTR

指向 Unicode 字符串的指针，该字符串指定要显示在气球正文中的文本。

[in] dwInfoFlags

类型：DWORD

以下一个或多个值，指示要显示在通知气球中的图标。

NIIF_NONE (0x00000000)

0x00000000。不显示图标。

NIIF_INFO (0x00000001)

0x00000001。显示信息图标。

NIIF_WARNING (0x00000002)

0x00000002。显示警告图标。

NIIF_ERROR (0x00000003)

0x00000003。显示错误图标。

NIIF_USER (0x00000004)

0x00000004。 Windows XP SP2 及更高版本。在通知气球中使用 hIcon 中标识的图标。

NIIF_NOSOUND (0x00000010)

0x00000010。 Windows XP 及更高版本。不要播放关联的声音。此值仅适用于气球通知，不适用于标准用户通知。

NIIF_LARGE_ICON (0x00000010)

0x00000010。 Windows Vista 及更高版本。图标的大版本应用作通知气球中的图标。这对应于尺寸SM_CXICON x SM_CYICON的图标。如果未设置此标志，则使用尺寸XM_CXSMICON x SM_CYSMICON 的图标。

此标志可以与所有股票图标一起使用。
使用 hIcon) (NIIF_USER 较旧的自定义图标的应用程序必须在 NOTIFYICONDATA 结构的 hIcon 成员中指定的托盘图标中提供新的 SM_CXICON x SM_CYICON 版本。这些图标在通知区域中显示时会缩小它们。
使用 hBalloonIcon) 的新自定义图标 (NIIF_USER 必须在提供的图标中提供SM_CXICON x SM_CYICON 版本 (hBalloonIcon) 。

NIIF_RESPECT_QUIET_TIME (0x00000080)

0x00000080。 Windows 7 及更高版本。如果当前用户处于“安静时间”，则不显示通知气球，这是新用户首次登录其帐户后的第一小时。在此期间，不应发送或显示大多数通知。这样，用户就可以习惯于新的计算机系统，而不会受到这些干扰。在操作系统升级或干净安装后，每个用户也会有静默时间。在静默时间使用此标志发送的通知不会排队;它只是被不屑一顾。如果通知在当时仍然有效，则应用程序可以稍后重新发送通知。

由于应用程序无法预测何时可能会遇到静默时间，因此我们建议始终由任何应用程序在所有适当的通知上设置此标志，以便遵守静默时间。

如果当前用户不在安静时间，则此标志不起作用。

NIIF_ICON_MASK (0x0000000F)

0x0000000F。 Windows XP (Shell32.dll 版本 6.0) 及更高版本。保留。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	shobjidl_core.h (包括 Shobjidl.h)

通过