IUserNotification::SetBalloonInfo メソッド (shobjidl_core.h)

[アーティクル]
08/26/2023

バルーン通知に表示する情報を設定します。

構文

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

パラメーター

[in] pszTitle

種類: LPCWSTR

通知のタイトルを指定する Unicode 文字列へのポインター。

[in] pszText

種類: LPCWSTR

吹き出しの本文に表示するテキストを指定する Unicode 文字列へのポインター。

[in] dwInfoFlags

型: DWORD

通知バルーンに表示するアイコンを示す 1 つ以上の次の値。

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 以降。通知バルーンのアイコンとして、大きなバージョンのアイコンを使用する必要があります。これは、x SM_CYICON SM_CXICON寸法を持つアイコンに対応します。このフラグが設定されていない場合は、x SM_CYSMICON XM_CXSMICONディメンションを持つアイコンが使用されます。

このフラグは、すべてのストックアイコンで使用できます。
以前のカスタマイズされたアイコン (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 以降。現在のユーザーが "静かな時間" にある場合は、通知バルーンを表示しないでください。これは、新しいユーザーが自分のアカウントに初めてログインした後の最初の 1 時間です。この期間中は、ほとんどの通知を送信したり表示したりしないでください。これにより、ユーザーは、これらの気を散らすことなく、新しいコンピューターシステムに慣れできるようになります。また、オペレーティングシステムのアップグレードまたはクリーンインストール後に、各ユーザーに対して静かな時間が発生します。このフラグが付いた通知は、静かな時間の間にキューに入れられます。これは単に表示されていない状態で無視されます。アプリケーションは、その時点でも有効な場合は、後で通知を再送信できます。

アプリケーションでは、いつ静かな時間が発生する可能性があるかを予測できないため、このフラグは、静かな時間を尊重することを意味するすべてのアプリケーションによって、すべての適切な通知に常に設定することをお勧めします。

現在のユーザーが静かな時間でない場合、このフラグは無効です。

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 を含む)

次の方法で共有