IUserNotification：：SetBalloonInfo 方法 (shobjidl_core.h)

發行項
03/05/2024

設定要顯示在批注方塊通知中的資訊。

語法

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

參數

[in] pszTitle

類型： LPCWSTR

指定通知標題之 Unicode 字串的指標。

[in] pszText

類型： LPCWSTR

Unicode 字串的指標，指定要顯示在批注方塊主體中的文字。

[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 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的圖示。

此旗標可以搭配所有股票圖示使用。
搭配 hIcon (NIIF_USER) 使用舊版自定義圖示的應用程式，必須在 NOTIFYICONDATA 結構的 hIcon 成員中指定的匣圖示中，提供新的 SM_CXICON x SM_CYICON 版本。這些圖示會在通知區域中顯示時相應減少。
使用 hBalloonIcon) (NIIF_USER 的新自定義圖示必須在提供的圖示 (hBalloonIcon) 中提供SM_CXICON x SM_CYICON 版本。

NIIF_RESPECT_QUIET_TIME (0x00000080)

0x00000080。 Windows 7 和更新版本。如果目前使用者處於「無訊息時間」，則不要顯示通知批注方塊，這是新使用者第一次登入其帳戶之後的第一小時。在此期間，不應該傳送或顯示大部分的通知。這可讓用戶習慣使用新的計算機系統，而不會干擾這些系統。操作系統升級或全新安裝之後，每個使用者也會發生無訊息時間。在無訊息時間以這個旗標傳送的通知不會排入佇列;它只是關閉而未擁有。如果應用程式在該時間仍然有效，應用程式稍後可以重新傳送通知。

由於應用程式無法預測何時可能會遇到無訊息時間，因此我們建議任何表示接受無訊息時間的應用程式一律會在所有適當的通知上設定此旗標。

如果目前的使用者不在無訊息時間，則此旗標沒有任何作用。

NIIF_ICON_MASK (0x0000000F)

0x0000000F。 Windows XP (Shell32.dll 6.0 版 ) 及更新版本。保留的。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包含 Shobjidl.h)