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 |