LoadIconA 関数 (winuser.h)
アプリケーション インスタンスに関連付けられている実行可能ファイル (.exe) から指定されたアイコン リソースを読み込みます。
注意
この関数は LoadImage 関数に置き換わりました ( LR_DEFAULTSIZE フラグと LR_SHARED フラグが設定されています)。
構文
HICON LoadIconA(
[in, optional] HINSTANCE hInstance,
[in] LPCSTR lpIconName
);
パラメーター
[in, optional] hInstance
種類: HINSTANCE
読み込まれるアイコンを含む DLL または実行可能ファイル (.exe) のいずれかのモジュールへのハンドル。 詳細については、「 GetModuleHandle」を参照してください。
定義済みのシステム アイコンを読み込むには、このパラメーターを NULL に設定 します。
[in] lpIconName
型: LPCTSTR
hInstance が NULL 以外の場合、lpIconName はアイコン リソースを名前または序数で指定します。 この序数は 、MAKEINTRESOURCE マクロを使用してパッケージ化する必要があります。
hInstance が NULL の場合、lpIconName は、読み込む定義済みのシステム アイコンの識別子 (IDI_ プレフィックスで始まる) を指定します。
戻り値
種類: HICON
関数が成功した場合、戻り値は新しく読み込まれたアイコンへのハンドルです。
関数が失敗した場合は、返される値は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
LoadIcon は、読み込まれていない場合にのみアイコン リソースを読み込みます。それ以外の場合は、既存のリソースへのハンドルを取得します。 関数は、アイコン リソースを検索して、現在の表示に最も適したアイコンを検索します。 アイコン リソースには、カラービットマップまたはモノクロ ビットマップを指定できます。
LoadIcon は、サイズが SM_CXICON に準拠し、システム メトリック値を SM_CYICON アイコンのみを読み込むことができます。 LoadImage 関数を使用して、他のサイズのアイコンを読み込みます。
注意
winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして LoadIcon を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |
| API セット | ext-ms-win-ntuser-gui-l1-1-0 (Windows 8で導入) |
関連項目
概念