SHGetImageList 関数 (shellapi.h)

  • [アーティクル]

イメージ リストを取得します。

構文

SHSTDAPI SHGetImageList(
  [in]  int    iImageList,
  [in]  REFIID riid,
  [out] void   **ppvObj
);

パラメーター

[in] iImageList

型: int

リストに含まれるイメージの種類。 次のいずれかの値です。

SHIL_LARGE (0x0)

0x0。 画像のサイズは通常 32 x 32 ピクセルです。 ただし、[表示プロパティ] の [外観] タブの [効果] セクションで [大きいアイコンを使用する] オプションが選択されている場合、画像は 48 x 48 ピクセルです。

SHIL_SMALL (0x1)

0x1。 これらのイメージはシェル標準の小さいアイコン サイズ 16 x 16 ですが、サイズはユーザーがカスタマイズできます。

SHIL_EXTRALARGE (0x2)

0x2。 これらのイメージは、シェル標準の特大アイコン サイズです。 これは通常 48 x 48 ですが、サイズはユーザーがカスタマイズできます。

SHIL_SYSSMALL (0x3)

0x3。 これらのイメージは、SM_CXSMICON で呼び出される GetSystemMetrics と 、SM_CYSMICON で呼び出された GetSystemMetricsで指定されたサイズです。

SHIL_JUMBO (0x4)

0x4。 Windows Vista 以降。 画像は通常 256 x 256 ピクセルです。

SHIL_LAST

検証のために有効なフラグ値の最大値。

[in] riid

種類: REFIID

イメージ リスト インターフェイス識別子への参照(通常はIID_IImageList)。

[out] ppvObj

型: void**

このメソッドが戻るとき、 には 、riid で要求されたインターフェイス ポインターが含まれます。 これは通常 、IImageList です。

戻り値

種類: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

ppv パラメーターで返されるなどの IImageList ポインター型は、必要に応じて HIMAGELIST としてキャストできます。たとえば、リスト ビューで使用する場合などです。 逆に、 HIMAGELIST は IImageList へのポインターとしてキャストできます。

Windows Vista の時点で、 SHIL_SMALL、 SHIL_LARGE、 およびSHIL_EXTRALARGE 、プロセスが dpi 対応としてマークされている場合は、1 インチあたりのドット数 (dpi) でスケーリングされます。 これらの型を dpi 対応に設定するには、 SetProcessDPIAware を呼び出します。 SHIL_JUMBO は、dpi 対応の設定に関係なく、256 ピクセルで固定されます。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー shellapi.h
[DLL] Shell32.dll
API セット ext-ms-win-shell-shell32-l1-2-2 (Windows 10 バージョン 10.0.14393 で導入)

こちらもご覧ください

FileIconInit