CreateIconFromResourceEx 関数 (winuser.h)

[アーティクル]
11/20/2024

アイコンを記述するリソースビットからアイコンまたはカーソルを作成します。

構文

HICON CreateIconFromResourceEx(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer,
  [in] int   cxDesired,
  [in] int   cyDesired,
  [in] UINT  Flags
);

パラメーター

[in] presbits

型: PBYTE

アイコン (RT_ICON) またはカーソル (RT_CURSOR) リソースビットを含む DWORD アラインバッファーポインター。これらのビットは、通常、LookupIconIdFromDirectoryEx および LoadResource 関数呼び出しによって読み込まれます。

アイコンとカーソルのリソース形式の詳細については、「カーソルとアイコンリソースの」を参照してください。

[in] dwResSize

型: DWORD

pbIconBits パラメーターによって指されるビットのセットのサイズ (バイト単位)。

[in] fIcon

型: BOOL

アイコンまたはカーソルを作成するかどうかを示します。このパラメーターが TRUE場合は、アイコンが作成されます。 FALSE場合は、カーソルが作成されます。

LOCALHEADER 構造体は、カーソルのホットスポットを定義し、カーソルリソースビットから読み取られた最初のデータです。

[in] dwVer

型: DWORD

プリビット パラメーターによって指されるリソースビットのアイコンまたはカーソル形式のバージョン番号。値は、0x00020000以上で、0x00030000以下である必要があります。このパラメーターは通常、0x00030000に設定されます。

[in] cxDesired

型: int

アイコンまたはカーソルの幅 (ピクセル単位)。このパラメーターが 0 で、Flags パラメーターが LR_DEFAULTSIZE場合、関数は SM_CXICON または SM_CXCURSOR システムメトリック値を使用して幅を設定します。このパラメーターが 0 で、LR_DEFAULTSIZE が使用されていない場合、関数は実際のリソース幅を使用します。

[in] cyDesired

型: int

アイコンまたはカーソルの高さ (ピクセル単位)。このパラメーターが 0 で、Flags パラメーターが LR_DEFAULTSIZEされている場合、関数は SM_CYICON または SM_CYCURSOR システムメトリック値を使用して高さを設定します。このパラメーターが 0 で、LR_DEFAULTSIZE が使用されていない場合、関数は実際のリソースの高さを使用します。

[in] Flags

型: UINT

次の値の組み合わせ。

価値	意味
LR_DEFAULTCOLOR 0x00000000	既定の色形式を使用します。
LR_DEFAULTSIZE 0x00000040	cxDesired または cyDesired 値が 0 に設定されている場合は、カーソルまたはアイコンのシステムメトリック値で指定された幅または高さを使用します。このフラグを指定せず、cxDesired をし、cyDesired 0 に設定すると、関数は実際のリソースサイズを使用します。
LR_MONOCHROME 0x00000001	モノクロアイコンまたはカーソルを作成します。
LR_SHARED 0x00008000	アイコンまたはカーソルが複数回作成された場合に、アイコンまたはカーソルハンドルを共有します。 LR_SHARED が設定されていない場合、同じリソース CreateIconFromResourceEx を 2 回目に呼び出すと、アイコンまたはカーソルが再度作成され、別のハンドルが返されます。このフラグを使用すると、不要になったときにシステムによってリソースが破棄されます。標準以外のサイズを持つアイコンまたはカーソル、読み込み後に変更される可能性がある、またはファイルから読み込まれるアイコンまたはカーソルには、LR_SHARED を使用しないでください。

戻り値

型: HICON

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

関数が失敗した場合、戻り値は NULL。拡張エラー情報を取得するには、GetLastError呼び出します。

備考

CreateIconFromResource、CreateIconFromResourceEx、createIconIndirect、GetIconInfo、LookupIconIdFromDirectoryEx 関数をすると、シェルアプリケーションとアイコンブラウザーでシステム全体のリソースを調べて使用できます。

アイコン DestroyIcon を呼び出すか、CreateIconFromResourceExで作成されたカーソルに対して DestroyCursor する必要があります。

例

例については、「共有アイコンリソースをする」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	winuser.h (Windows.h を含む)
ライブラリ	User32.lib
DLL	User32.dll

次の方法で共有

CreateIconFromResourceEx 関数 (winuser.h)

構文

パラメーター

戻り値

備考

例

必要条件

関連項目

フィードバック

その他のリソース