IUserNotification::SetBalloonInfo 方法 (shobjidl_core.h)

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

语法

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)