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 で導入) |