Метод IUserNotification2::SetBalloonInfo (shobjidl.h)

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

Синтаксис

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 .

Требования

См. также раздел

IUserNotification2

SetBalloonInfo