ICONINFOEXA 構造体 (winuser.h)

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

アイコンまたはカーソルに関する情報が含まれます。 ICONINFO拡張します。 GetIconInfoExで使用されます。

構文

typedef struct _ICONINFOEXA {
  DWORD   cbSize;
  BOOL    fIcon;
  DWORD   xHotspot;
  DWORD   yHotspot;
  HBITMAP hbmMask;
  HBITMAP hbmColor;
  WORD    wResID;
  CHAR    szModName[MAX_PATH];
  CHAR    szResName[MAX_PATH];
} ICONINFOEXA, *PICONINFOEXA;

メンバーズ

cbSize

型: DWORD

この構造体のサイズ (バイト単位)。

fIcon

型: BOOL

この構造体がアイコンまたはカーソルを定義するかどうかを指定します。アイコンを指定 TRUE の値。FALSE カーソルを指定します。

xHotspot

型: DWORD

カーソルのホットスポットの x 座標。この構造でアイコンが定義されている場合、ホットスポットは常にアイコンの中央にあり、このメンバーは無視されます。

yHotspot

型: DWORD

カーソルのホットスポットの y 座標。この構造でアイコンが定義されている場合、ホットスポットは常にアイコンの中央にあり、このメンバーは無視されます。

hbmMask

型: HBITMAP

ビットマップのアイコンモノクロマスクハンドル。

hbmColor

型: HBITMAP

ビットマップのアイコンの色ハンドル。

wResID

型: word

szModName モジュール内リソースのリソース識別子。アイコンまたはカーソルが名前で読み込まれた場合、wResID は 0 で、szResName にはリソース名が含まれます。

MAKEINTRESOURCE(wResID) マクロ使用して、リソース識別子を、リソース管理機能と互換性のあるリソース名の種類に変換できます。

szModName[MAX_PATH]

型: TCHAR[MAX_PATH]

アイコンまたはカーソルが読み込まれたモジュールの名前。

GetModuleHandle 関数使用して、リソース管理機能と互換性のあるモジュールハンドルに変換できます。

szResName[MAX_PATH]

型: TCHAR[MAX_PATH]

szModName モジュール内リソースのリソース名。

備考

モノクロアイコンの場合、hbmMask はアイコンの高さの 2 倍になり (上部に AND マスク、下部に XOR マスクが付いています)、hbmColor は NULL。また、この場合、高さは2の偶数倍数でなければなりません。

カラーアイコンの場合、hbmMask と hbmColor ビットマップは同じサイズであり、それぞれがアイコンのサイズです。

GetObject 関数を使用すると、hbmMask の内容取得し、BITMAP 構造体の hbmColor をできます。ビットマップビットは、この構造体のビットマップ GetDIBits を呼び出して取得できます。

ICONINFOEX は、アイコンまたはカーソルリソースビットのクエリに使用できる追加の szModName/szResName/wResID メンバーを含む、ICONINFO 構造体の拡張バージョンです。これらのビットは、通常、FindResource、LoadResource、LockResource、LookupIconIdFromDirectoryEx 関数の呼び出しによって読み込まれます。

手記

winuser.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして ICONINFOEX を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップアプリのみ]
サポートされる最小サーバー	Windows Server 2008 [デスクトップアプリのみ]
ヘッダー	winuser.h (Windows.h を含む)

次の方法で共有

ICONINFOEXA 構造体 (winuser.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース