ICONINFOEXA 構造体 (winuser.h)
アイコンまたはカーソルに関する情報が含まれます。 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 関数を使用して、BITMAP 構造体の hbmMask と hbmColor の内容を取得できます。 ビットマップ ビットは、この構造体のビットマップで GetDIBits を呼び出すと取得できます。
ICONINFOEX は、アイコンまたはカーソル リソース ビットのクエリに使用できる追加の szModName/szResName/wResID メンバーを含む ICONINFO 構造体の拡張バージョンです。 これらのビットは、通常、FindResource、LoadResource、LockResource、 LookupIconIdFromDirectoryEx 関数の呼び出しによって読み込まれます。
注意
winuser.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして ICONINFOEX を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| Header | winuser.h (Windows.h を含む) |
関連項目
概念
参照