LoadIconW 関数 (winuser.h)

  • [アーティクル]

アプリケーション インスタンスに関連付けられている実行可能ファイル (.exe) から指定されたアイコン リソースを読み込みます。

注意

この関数は LoadImage 関数に置き換わりました ( LR_DEFAULTSIZE フラグと LR_SHARED フラグが設定されています)。

構文

HICON LoadIconW(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCWSTR   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で導入)

関連項目

概念

CreateIcon

アイコン

Loadimage

MAKEINTRESOURCE

IS_INTRESOURCE