GetIconInfo 関数 (winuser.h)
指定したアイコンまたはカーソルに関する情報を取得します。
構文
BOOL GetIconInfo(
[in] HICON hIcon,
[out] PICONINFO piconinfo
);
パラメーター
[in] hIcon
種類: HICON
アイコンまたはカーソルへのハンドル。
標準アイコンまたはカーソルに関する情報を取得するには、 IDI_ プレフィックスで始まる識別子 、またはこのパラメーターの IDC_ プレフィックスで始まる識別子 を指定します。
[out] piconinfo
種類: PICONINFO
ICONINFO 構造体へのポインター。 関数は構造体のメンバーを入力します。
戻り値
種類: BOOL
関数が成功した場合、戻り値は 0 以外であり、関数は指定した ICONINFO 構造体のメンバーを入力します。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
GetIconInfo は、 hbmMask および hbmColor または ICONINFO のメンバーのビットマップを作成します。 呼び出し元のアプリケーションでは、これらのビットマップを管理し、必要なくなったときに DeleteObject 呼び出しで削除する必要があります。
DPI 仮想化
この API は DPI 仮想化には参加しません。 返される出力は、呼び出し元スレッドの DPI の影響を受けません。要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |
| API セット | ext-ms-win-ntuser-gui-l1-1-0 (Windows 8で導入) |
関連項目
概念