CreateIcon 関数 (winuser.h)
指定したサイズ、色、およびビット パターンを持つアイコンを作成します。
実行時に色付きのアイコンを作成するには、ICONINFO 構造体の内容に基づいてアイコンを作成する CreateIconIndirect 関数を使用できます。
構文
HICON CreateIcon(
[in, optional] HINSTANCE hInstance,
[in] int nWidth,
[in] int nHeight,
[in] BYTE cPlanes,
[in] BYTE cBitsPixel,
[in] const BYTE *lpbANDbits,
[in] const BYTE *lpbXORbits
);
パラメーター
[in, optional] hInstance
種類: HINSTANCE
アイコンを作成するモジュールのインスタンスへのハンドル。
[in] nWidth
型: int
アイコンの幅 (ピクセル単位)。 「解説」を参照してください。
[in] nHeight
型: int
アイコンの高さ (ピクセル単位)。 「解説」を参照してください。
[in] cPlanes
型: BYTE
アイコンの XOR ビットマスク内の平面の数。 「解説」を参照してください。
[in] cBitsPixel
型: BYTE
アイコンの XOR ビットマスク内のピクセルあたりのビット数。
[in] lpbANDbits
型: const BYTE*
アイコンの AND ビットマスクのビット値を含むバイト配列。 このビットマスクは、モノクロ ビットマップを表します。 「解説」を参照してください。
[in] lpbXORbits
型: const BYTE*
アイコンの XOR ビットマスクのビット値を含むバイト配列。 このビットマスクは、モノクロビットマップまたはカラービットマップを記述します。 「解説」を参照してください。
戻り値
種類: HICON
関数が成功した場合、戻り値はアイコンへのハンドルです。
関数が失敗した場合は、返される値は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
アイコンの名目サイズを確認するには、 GetSystemMetrics 関数を使用して、 SM_CXICON または SM_CYICON 値を指定します。 また、この API の DPI 対応バージョンを使用することもできます(GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi) を参照してください。 詳細については、「Windows での アイコン サイズ と 高 DPI デスクトップ アプリケーション開発」を参照してください。
lpbANDbits パラメーターと lpbXORbits パラメーターの詳細については、CreateBitmap 関数の lpBits パラメーターの説明を参照してください。
モノクロ アイコン の場合、CreateIcon は AND ビットマスクと XOR ビットマスクに次の真理値テーブルを適用します。
| AND ビットマスク | XOR ビットマスク | 表示 |
|---|---|---|
| 0 | 0 | Black |
| 0 | 1 | White |
| 1 | 0 | Screen |
| 1 | 1 | 画面の反転 |
アイコンの使用が完了したら、 DestroyIcon 関数を使用してアイコンを破棄します。
例
例については、「 アイコンの作成」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |