Metodo IUserNotification2::SetBalloonInfo (shobjidl.h)
Imposta le informazioni da visualizzare in una notifica a palloncini.
Sintassi
HRESULT SetBalloonInfo(
[in] LPCWSTR pszTitle,
[in] LPCWSTR pszText,
[in] DWORD dwInfoFlags
);
Parametri
[in] pszTitle
Tipo: LPCWSTR
Puntatore a una stringa Unicode che specifica il titolo della notifica.
[in] pszText
Tipo: LPCWSTR
Puntatore a una stringa Unicode che specifica il testo da visualizzare nel corpo del palloncino.
[in] dwInfoFlags
Tipo: DWORD
Uno o più dei valori seguenti che indicano un'icona da visualizzare nel palloncino di notifica.
NIIF_NONE (0x00000000)
0x00000000. Non visualizzare un'icona.
NIIF_INFO (0x00000001)
0x00000001. Visualizzare un'icona delle informazioni.
NIIF_WARNING (0x00000002)
0x00000002. Visualizzare un'icona di avviso.
NIIF_ERROR (0x00000003)
0x00000003. Visualizzare un'icona di errore.
NIIF_USER (0x00000004)
0x00000004. Windows XP SP2 e versioni successive. Usare l'icona identificata in hIcon nel palloncino di notifica.
NIIF_NOSOUND (0x00000010)
0x00000010. Windows XP e versioni successive. Non riprodurre il suono associato. Questo valore si applica solo alle notifiche a palloncini e non alle notifiche utente standard.
NIIF_LARGE_ICON (0x00000010)
0x00000010. Windows Vista e versioni successive. La versione grande dell'icona deve essere usata come icona nel palloncino di notifica. Corrisponde all'icona con dimensioni SM_CXICON x SM_CYICON. Se questo flag non è impostato, viene usata l'icona con dimensioni XM_CXSMICON x SM_CYSMICON.
- Questo flag può essere usato con tutte le icone di magazzino.
- Le applicazioni che usano icone personalizzate meno recenti (NIIF_USER con hIcon) devono fornire una nuova versione SM_CXICON x SM_CYICON nell'icona della barra dei dati specificata nel membro hIcon della struttura NOTIFYICONDATA . Queste icone vengono ridimensionate quando vengono visualizzate nell'area di notifica.
- Le nuove icone personalizzate (NIIF_USER con hBalloonIcon) devono fornire una versione SM_CXICON x SM_CYICON nell'icona fornita (hBalloonIcon).
NIIF_RESPECT_QUIET_TIME (0x00000080)
0x00000080. Windows 7 e versioni successive. Non visualizzare il palloncino di notifica se l'utente corrente è in "tempo tranquillo", ovvero la prima ora dopo un nuovo utente accede al suo account per la prima volta. Durante questo periodo, la maggior parte delle notifiche non deve essere inviata o visualizzata. Ciò consente a un utente di diventare abituato a un nuovo sistema computer senza distrazioni. Il tempo di silenzio si verifica anche per ogni utente dopo un aggiornamento del sistema operativo o un'installazione pulita. Una notifica inviata con questo flag durante il tempo di silenzio non viene accodata; è semplicemente ignorato. L'applicazione può inviare nuovamente la notifica in un secondo momento se è ancora valida.
Poiché un'applicazione non può prevedere quando potrebbe riscontrare un tempo di silenzio, è consigliabile impostare sempre questo flag su tutte le notifiche appropriate da qualsiasi applicazione che significa rispettare il tempo di silenzio.
Se l'utente corrente non è in tempo tranquillo, questo flag non ha alcun effetto.
NIIF_ICON_MASK (0x0000000F)
0x0000000F. Windows XP (Shell32.dll versione 6.0) e versioni successive. Riservato.
Valore restituito
Tipo: HRESULT
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | shobjidl.h |