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

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

構文

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