IUserNotification2::SetBalloonInfo-Methode (shobjidl.h)

  • Artikel

Legt die Informationen fest, die in einer Ballonbenachrichtigung angezeigt werden sollen.

Syntax

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

Parameter

[in] pszTitle

Typ: LPCWSTR

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Titel der Benachrichtigung angibt.

[in] pszText

Typ: LPCWSTR

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Text angibt, der im Textkörper der Ballon angezeigt werden soll.

[in] dwInfoFlags

Art: DWORD

Mindestens einer der folgenden Werte, die ein Symbol angeben, das in der Benachrichtigungsblase angezeigt werden soll.

NIIF_NONE (0x00000000)

0x00000000. Zeigen Sie kein Symbol an.

NIIF_INFO (0x00000001)

0x00000001. Zeigt ein Informationssymbol an.

NIIF_WARNING (0x00000002)

0x00000002. Zeigt ein Warnungssymbol an.

NIIF_ERROR (0x00000003)

0x00000003. Zeigt ein Fehlersymbol an.

NIIF_USER (0x00000004)

0x00000004. Windows XP SP2 und höher. Verwenden Sie das in hIcon angegebene Symbol in der Benachrichtigungsblase.

NIIF_NOSOUND (0x00000010)

0x00000010. Windows XP und höher. Geben Sie den zugehörigen Sound nicht wieder. Dieser Wert gilt nur für Ballonbenachrichtigungen und nicht für Standardbenutzerbenachrichtigungen.

NIIF_LARGE_ICON (0x00000010)

0x00000010. Windows Vista und höher. Die große Version des Symbols sollte als Symbol in der Benachrichtigungsblase verwendet werden. Dies entspricht dem Symbol mit Dimensionen SM_CXICON x SM_CYICON. Wenn dieses Flag nicht festgelegt ist, wird das Symbol mit den Dimensionen XM_CXSMICON x SM_CYSMICON verwendet.

  • Dieses Flag kann mit allen Aktiensymbolen verwendet werden.
  • Anwendungen, die ältere benutzerdefinierte Symbole (NIIF_USER mit hIcon) verwenden, müssen eine neue SM_CXICON x SM_CYICON Version im Im hIcon-Element der NOTIFYICONDATA-Struktur angegebenen Taskleistensymbol bereitstellen. Diese Symbole werden herunterskaliert, wenn sie im Benachrichtigungsbereich angezeigt werden.
  • Neue angepasste Symbole (NIIF_USER mit hBalloonIcon) müssen eine SM_CXICON x SM_CYICON Version im angegebenen Symbol (hBalloonIcon) bereitstellen.

NIIF_RESPECT_QUIET_TIME (0x00000080)

0x00000080. Windows 7 und höher. Zeigen Sie die Benachrichtigungsblase nicht an, wenn sich der aktuelle Benutzer in der "ruhigen Zeit" befindet, d. h. die erste Stunde, nachdem sich ein neuer Benutzer zum ersten Mal bei seinem Konto angemeldet hat. Während dieser Zeit sollten die meisten Benachrichtigungen nicht gesendet oder angezeigt werden. Dies ermöglicht es einem Benutzer, sich ohne diese Ablenkungen an ein neues Computersystem zu gewöhnen. Die Ruhezeit tritt auch für jeden Benutzer nach einem Betriebssystemupgrade oder sauber Installation auf. Eine Benachrichtigung, die mit diesem Flag während der Ruhezeit gesendet wird, wird nicht in die Warteschlange gestellt. es wird einfach nicht angezeigt verworfen. Die Anwendung kann die Benachrichtigung später erneut senden, wenn sie zu diesem Zeitpunkt noch gültig ist.

Da eine Anwendung nicht vorhersagen kann, wann es zu einer ruhigen Zeit kommen könnte, empfehlen wir, dieses Flag immer für alle geeigneten Benachrichtigungen von einer Anwendung festzulegen, die bedeutet, dass ruhezeitliche Zeiten berücksichtigt werden.

Wenn sich der aktuelle Benutzer nicht in ruher Zeit befindet, hat dieses Flag keine Auswirkung.

NIIF_ICON_MASK (0x0000000F)

0x0000000F. Windows XP (Shell32.dll Version 6.0) und höher. Reserviert.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl.h

Weitere Informationen

IUserNotification2

SetBalloonInfo