createCursor 函式 (winuser.h)
建立具有指定大小、位模式和作用點的單色游標。
若要在運行時間建立彩色數據指標，您可以使用 CreateIconIndirect 函式，根據 ICONINFO 結構的內容建立數據指標。
語法
HCURSOR CreateCursor(
[in, optional] HINSTANCE hInst,
[in] int xHotSpot,
[in] int yHotSpot,
[in] int nWidth,
[in] int nHeight,
[in] const VOID *pvANDPlane,
[in] const VOID *pvXORPlane
);
參數
[in, optional] hInst
類型： HINSTANCE
建立數據指標之應用程式目前實例的句柄。
[in] xHotSpot
類型： int
游標作用點的水準位置。
[in] yHotSpot
類型： int
游標作用點的垂直位置。
[in] nWidth
類型： int
游標的寬度，以像素為單位。
[in] nHeight
類型： int
游標的高度，以像素為單位。
[in] pvANDPlane
類型： const VOID*
位元組陣列，包含游標 AND 遮罩的位值，如單色位圖所示。 請參閱＜備註＞。
[in] pvXORPlane
類型： const VOID*
位元組陣列，包含游標 XOR 遮罩的位值，如同單色位圖。 請參閱＜備註＞。
傳回值
類型： HCURSOR
如果函式成功，則傳回值是數據指標的句柄。
如果函式失敗，傳回值為 NULL。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
若要判斷數據指標的名稱大小，請使用 GetSystemMetrics 函式，指定 SM_CXCURSOR 或 SM_CYCURSOR 值。 此外，您可以使用此 API 的 DPI 感知版本，請參閱 (GetSystemMetricsForDpi) (/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi) 。 如需詳細資訊，請參閱 Windows 上的高 DPI 桌面應用程式開發。
如需 pvANDPlane 和 pvXORPlane 參數的詳細資訊，請參閱 CreateBitmap 函式的 lpBits 參數描述。
CreateCursor 會將下列真實數據表套用至 AND 和 XOR 位掩碼：
| AND 位掩碼 | XOR 位掩碼 | 顯示 |
|---|---|---|
| 0 | 0 | 黑色 |
| 0 | 1 | 白色 |
| 1 | 0 | 畫面 |
| 1 | 1 | 反向畫面 |
關閉之前，應用程式必須呼叫 DestroyCursor函 式，以釋放與數據指標相關聯的任何系統資源。
DPI 虛擬化
此 API 不會參與 DPI 虛擬化。 傳回的輸出是以實體座標為基礎，而且不會受到呼叫線程的 DPI 影響。 請注意，所建立的數據指標仍可調整為符合所繪製之任何指定視窗的 DPI。範例
如需範例，請參閱 建立數據指標。
規格需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | winuser.h (包含 Windows.h) |
| 程式庫 | User32.lib |
| Dll | User32.dll |