Метод IUserNotification::SetBalloonInfo (shobjidl_core.h)

Статья
03/05/2024

Задает сведения, отображаемые в всплывающем уведомлении.

Синтаксис

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

Параметры

[in] pszTitle

Тип: LPCWSTR

Указатель на строку Юникода, указывающую заголовок уведомления.

[in] pszText

Тип: LPCWSTR

Указатель на строку Юникода, указывающую текст, отображаемый в тексте выноски.

[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 с пакетом обновления 2 (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.

Этот флаг можно использовать со всеми стандартными значками.
Приложения, использующие старые настраиваемые значки (NIIF_USER с hIcon), должны предоставлять новую версию SM_CXICON x SM_CYICON в значке области, указанном в элементе hIcon структуры NOTIFYICONDATA . Эти значки масштабируются, когда они отображаются в области уведомлений.
Новые настраиваемые значки (NIIF_USER с hBalloonIcon) должны содержать версию 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
Header	shobjidl_core.h (включая Shobjidl.h)

Поделиться через