CreateIcon 函式 (winuser.h)

建立具有指定大小、色彩和位模式的圖示。

若要在運行時間建立彩色圖示，您可以使用 CreateIconIndirect 函式，根據 ICONINFO 結構的內容建立圖示。

語法

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	黑色
0	1	白色
1	0	畫面
1	1	反向畫面

當您完成使用圖示時，請使用 DestroyIcon 函式來終結它。

範例

如需範例，請參閱 建立圖示。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll

另請參閱

CreateIconIndirect

圖示

圖示大小