IUserNotification2::SetBalloonInfo メソッド (shobjidl.h)

[アーティクル]
03/02/2024

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

構文

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 Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl.h

こちらもご覧ください

IUserNotification2

SetBalloonInfo