Compartir a través de

Método IUserNotification::SetBalloonInfo (shobjidl_core.h)

  • Artículo

Establece la información que se va a mostrar en una notificación de globo.

Sintaxis

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

Parámetros

[in] pszTitle

Tipo: LPCWSTR

Puntero a una cadena Unicode que especifica el título de la notificación.

[in] pszText

Tipo: LPCWSTR

Puntero a una cadena Unicode que especifica el texto que se va a mostrar en el cuerpo del globo.

[in] dwInfoFlags

Tipo: DWORD

Uno o varios de los valores siguientes que indican un icono que se va a mostrar en el globo de notificación.

NIIF_NONE (0x00000000)

0x00000000. No muestre un icono.

NIIF_INFO (0x00000001)

0x00000001. Muestra un icono de información.

NIIF_WARNING (0x00000002)

0x00000002. Muestra un icono de advertencia.

NIIF_ERROR (0x00000003)

0x00000003. Muestra un icono de error.

NIIF_USER (0x00000004)

0x00000004. Windows XP SP2 y versiones posteriores. Use el icono identificado en hIcon en el globo de notificación.

NIIF_NOSOUND (0x00000010)

0x00000010. Windows XP y versiones posteriores. No reproduzca el sonido asociado. Este valor solo se aplica a las notificaciones de globo y no a las notificaciones de usuario estándar.

NIIF_LARGE_ICON (0x00000010)

0x00000010. Windows Vista y versiones posteriores. La versión grande del icono debe usarse como icono en el globo de notificación. Esto corresponde al icono con dimensiones SM_CXICON x SM_CYICON. Si no se establece esta marca, se usa el icono con dimensiones XM_CXSMICON x SM_CYSMICON.

  • Esta marca se puede usar con todos los iconos de stock.
  • Las aplicaciones que usan iconos personalizados más antiguos (NIIF_USER con hIcon) deben proporcionar una nueva versión de SM_CXICON x SM_CYICON en el icono de bandeja especificado en el miembro hIcon de la estructura NOTIFYICONDATA . Estos iconos se reducen verticalmente cuando se muestran en el área de notificación.
  • Los nuevos iconos personalizados (NIIF_USER con hBalloonIcon) deben proporcionar una versión de SM_CXICON x SM_CYICON en el icono proporcionado (hBalloonIcon).

NIIF_RESPECT_QUIET_TIME (0x00000080)

0x00000080. Windows 7 y versiones posteriores. No muestre el globo de notificación si el usuario actual está en "tiempo tranquilo", que es la primera hora después de que un nuevo usuario inicie sesión en su cuenta por primera vez. Durante este tiempo, la mayoría de las notificaciones no se deben enviar ni mostrar. Esto permite que un usuario esté acostumbrado a un nuevo sistema informático sin esas distracciones. El tiempo de silencio también se produce para cada usuario después de una actualización del sistema operativo o una instalación limpia. No se pone en cola una notificación enviada con esta marca durante el tiempo de silencio; simplemente se descarta sin mostrar. La aplicación puede volver a enviar la notificación más adelante si sigue siendo válida en ese momento.

Dado que una aplicación no puede predecir cuándo podría encontrarse con tiempo de silencio, se recomienda establecer siempre esta marca en todas las notificaciones adecuadas por cualquier aplicación que signifique respetar el tiempo de silencio.

Si el usuario actual no está en tiempo silencioso, esta marca no tiene ningún efecto.

NIIF_ICON_MASK (0x0000000F)

0x0000000F. Windows XP (Shell32.dll versión 6.0) y versiones posteriores. Reservado.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)