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

こちらもご覧ください

CreateIconIndirect

アイコン

アイコンのサイズ