CreateIconIndirect 関数 (winuser.h)

ICONINFO 構造体からアイコンまたはカーソルを作成します。

構文

HICON CreateIconIndirect(
  [in] PICONINFO piconinfo
);

パラメーター

[in] piconinfo

種類: PICONINFO

関数がアイコンまたはカーソルの作成に使用する ICONINFO 構造体へのポインター。

戻り値

種類: HICON

関数が成功した場合、戻り値は、作成されたアイコンまたはカーソルへのハンドルです。

関数が失敗した場合は、返される値は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

システムは、アイコンまたはカーソルを作成する前に、 ICONINFO 構造体内のビットマップをコピーします。 システムはデバイス コンテキストでビットマップを一時的に選択する可能性があるため、ICONINFO 構造体の hbmMask メンバーと hbmColor メンバーをデバイス コンテキストにまだ選択しないでください。 アプリケーションでは、元のビットマップを引き続き管理し、不要になったら削除する必要があります。

アイコンの使用が完了したら、 DestroyIcon 関数を使用して破棄します。

例

例については、「 カーソルの作成」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll
API セット ext-ms-win-ntuser-gui-l1-3-0 (Windows 10 バージョン 10.0.10240 で導入)

関連項目

概念

DestroyIcon

ICONINFO

アイコン