プラットフォーム SDK
LoadIcon
>

アプリケーションインスタンスに関連付けられている実行可能（.exe）ファイルから、指定されたアイコンのリソースをロードします。

注意  この関数は、LoadImage 関数に取って代わられました。

HICON LoadIcon(
  HINSTANCE hInstance, // アプリケーションインスタンスのハンドル
  LPCTSTR lpIconName   // リソース名の文字列またはリソース識別子
);

パラメータ

hInstance
モジュールのハンドルを指定します。このモジュールの実行可能ファイルは、ロード対象のアイコンを保持しています。システム定義のアイコンをロードする場合、このパラメータで NULL を指定します。
lpIconName
ロード対象のアイコンのリソース名を保持している、NULL で終わる文字列へのポインタを指定します。代わりに、上位ワードで 0、下位ワードでアイコンリソース識別子を保持している値を指定することもできます。この値は、 マクロを使って作成できます。

Windows があらかじめ定義しているアイコンを使うには、hInstance パラメータで NULL、lpIconName パラメータで次の値のいずれかを指定します。

値説明
IDI_APPLICATION既定のアプリケーションアイコン
IDI_ASTERISKIDI_INFORMATION と同じです
IDI_ERRORストップマークのアイコン（米国の歩行者用信号の赤と同じで、手を開いて制止しているデザインです）
IDI_EXCLAMATIONIDI_WARNING と同じです
IDI_HANDIDI_ERROR と同じです
IDI_INFORMATION情報アイコン（吹き出しの中に i の文字）
IDI_QUESTION疑問符のアイコン
IDI_WARNING感嘆符のアイコン
IDI_WINLOGOWindows ロゴのアイコン

戻り値

関数が成功すると、新しくロードされたアイコンのハンドルが返ります。

関数が失敗すると、NULL が返ります。拡張エラー情報を取得するには、 関数を使います。

解説

この関数は、アイコンのリソースがまだロードされていない場合にのみ、そのリソースをロードします。そのリソースが既にロードされている場合、既存のリソースのハンドルを返します。この関数は、指定されたアイコンに対応するリソースが複数存在する場合、現在の画面に最も適したリソースを検索します。アイコンのリソースは、カラーとモノクロームどちらのビットマップでもかまいません。

LoadIcon 関数がロードできるのは、GetSystemMetrics 関数の SM_CXCURSOR と SM_CYCURSOR の各フラグに相当するサイズのアイコンだけです。それ以外のサイズのアイコンをロードするには、LoadImage 関数を使ってください。

対応情報

Windows NT/2000：Windows NT 3.1 以降
Windows 95/98：Windows 95 以降
ヘッダー：Winuser.h 内で宣言、Windows.h をインクルード
インポートライブラリ：User32.lib を使用
Unicode：Windows NT/2000 は Unicode 版と ANSI 版を実装

参照

, , CreateIcon, LoadImage,

Page view tracker