IUserNotification::SetBalloonInfo-Methode (shobjidl_core.h)

Artikel
08/26/2023

Legt die Informationen fest, die in einer Sprechblasebenachrichtigung 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 Sprechblase angezeigt werden soll.

[in] dwInfoFlags

Art: DWORD

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

NIIF_NONE (0x00000000)

0x00000000. Kein Symbol anzeigen.

NIIF_INFO (0x00000001)

0x00000001. Anzeigen eines Informationssymbols

NIIF_WARNING (0x00000002)

0x00000002. Zeigt ein Warnsymbol 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 Benachrichtigungssprechblase.

NIIF_NOSOUND (0x00000010)

0x00000010. Windows XP und höher. Geben Sie den zugeordneten Sound nicht wieder. Dieser Wert gilt nur für Sprechblasenbenachrichtigungen 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 Benachrichtigungssprechblase verwendet werden. Dies entspricht dem Symbol mit den Abmessungen SM_CXICON x SM_CYICON. Wenn dieses Flag nicht festgelegt ist, wird das Symbol mit den Abmessungen XM_CXSMICON x SM_CYSMICON verwendet.

Dieses Flag kann mit allen Aktiensymbolen verwendet werden.
Anwendungen, die ältere angepasste Symbole (NIIF_USER mit hIcon) verwenden, müssen eine neue version SM_CXICON x SM_CYICON in dem Im hIcon-Element der NOTIFYICONDATA-Struktur angegebenen Fachsymbol bereitstellen. Diese Symbole werden herunterskaliert, wenn sie im Infobereich 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 Benachrichtigungssprechblase nicht an, wenn sich der aktuelle Benutzer in "Ruhezeit" 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 an ein neues Computersystem ohne diese Ablenkungen zu gewöhnen. Die Ruhezeit tritt auch für jeden Benutzer nach einem Betriebssystemupgrade oder einer sauber Installation auf. Eine Benachrichtigung, die während der Ruhezeit mit diesem Flag gesendet wird, wird nicht in die Warteschlange eingereiht. es wird einfach verworfen, nicht angezeigt. 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 die Ruhezeit auftreten könnte, wird empfohlen, dieses Flag immer für alle geeigneten Benachrichtigungen von einer Anwendung festzulegen, die bedeutet, dass Ruhezeiten 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 XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Freigeben über