IShellIconOverlayIdentifier::GetPriority メソッド (shobjidl_core.h)

  • [アーティクル]

アイコン オーバーレイの優先度を指定します。

構文

HRESULT GetPriority(
  [out] int *pPriority
);

パラメーター

[out] pPriority

型: int*

オーバーレイ識別子の優先度を示す値のアドレス。 指定できる値の範囲は 0 から 100 で、優先度は 0 です。

戻り値

型: HRESULT

成功した場合はS_OKを返し、それ以外の場合は COM エラー コードを返します。

解説

1 つのオブジェクトに対して複数のアイコン オーバーレイを使用できる場合は、優先度が最も高いものが選択されます。 シェルには、多くの場合の優先順位を決定する一連の内部規則があります。 GetPriority によって返される値は、シェルの内部規則が適用されない場合に使用されます。 通常は、値を 0 に設定する必要があります。 ただし、優先度の値は、同じオブジェクトのアイコン オーバーレイ アイコンを要求できる 2 つ以上のアイコン オーバーレイ ハンドラーを実装している場合に便利です。 優先度の値を適切に設定することで、要求されたアイコン オーバーレイのどれを表示するかを指定できます。

要件

   
サポートされている最小のクライアント Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shlobj.h を含む)
[DLL] Shell32.dll (バージョン 5.0 以降)

関連項目

IShellIconOverlayIdentifier