ICONINFOEXW 構造体 (winuser.h)

  • [アーティクル]

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

構文

typedef struct _ICONINFOEXW {
  DWORD   cbSize;
  BOOL    fIcon;
  DWORD   xHotspot;
  DWORD   yHotspot;
  HBITMAP hbmMask;
  HBITMAP hbmColor;
  WORD    wResID;
  WCHAR   szModName[MAX_PATH];
  WCHAR   szResName[MAX_PATH];
} ICONINFOEXW, *PICONINFOEXW;

メンバー

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 関数の呼び出しによって読み込まれます。

Note

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

要件

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

関連項目

概念

CreateIconIndirect

GetIconInfo

アイコン

ビットマップ

GetObject

ビットマップ

GetDIBits

参照