LoadIconWithScaleDown 関数 (commctrl.h)

アイコンを読み込みます。 アイコンが標準サイズでない場合、この関数は、小さい画像をスケールアップするのではなく、大きな画像をスケールダウンします。

構文

HRESULT LoadIconWithScaleDown(
  [in]  HINSTANCE hinst,
  [in]  PCWSTR    pszName,
  [in]  int       cx,
  [in]  int       cy,
  [out] HICON     *phico
);

パラメーター

[in] hinst

種類: HINSTANCE

読み込まれるアイコンを含む DLL または実行可能ファイル (.exe) のいずれかのモジュールへのハンドル。 詳細については、「 GetModuleHandle」を参照してください。

定義済みのシステム アイコンまたはスタンドアロン アイコン ファイルを読み込むには、このパラメーターを NULL に設定 します。

[in] pszName

種類: PCWSTR

読み込むアイコンに関する場所情報を含む、null で終わる Unicode バッファーへのポインター。

hinst が NULL 以外の場合、pszName はアイコン リソースを名前または序数で指定します。 この序数は 、MAKEINTRESOURCE マクロを使用してパッケージ化する必要があります。

hinst が NULL の場合、pszName は読み込む定義済みのシステム アイコンの識別子 (IDI_ プレフィックスで始まる) を指定します。

[in] cx

型: int

アイコンの目的の幅 (ピクセル単位)。

[in] cy

型: int

アイコンの目的の高さ (ピクセル単位)。

[out] phico

種類: HICON*

この関数が戻るときに、 には、読み込まれたアイコンのハンドルへのポインターが含まれます。

戻り値

型: HRESULT

成功した場合はS_OKを返し、それ以外の場合は次のようなエラー値を返します。

リターン コード	説明
E_INVALIDARG	pszName が指すバッファーの内容が、予期される解釈のいずれにも適合しません。

注釈

この関数は、最初にアイコン ファイルでまったく同じサイズのアイコンを検索します。 一致するものが見つからない場合は、 cx と cy の両方が標準のアイコン サイズ (16、32、48、または 256 ピクセル) のいずれかと一致しない限り、次に大きいアイコンが選択され、目的のサイズに縮小されます。 たとえば、x サイズが 40 ピクセルのアイコンが callign アプリケーションによって要求された場合、48 ピクセルのアイコンが使用され、40 ピクセルに縮小されます。 これに対し、 LoadImage 関数は 32 ピクセルのアイコンを選択し、最大 40 ピクセルまでスケーリングします。

関数が大きなアイコンを見つけることができない場合、既定では、次に小さいアイコンを見つけて目的のサイズにスケールアップする標準的な動作になります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	commctrl.h
Library	Comctl32.lib
[DLL]	Comctl32.dll