CreateCursor 函式（winuser.h）

發行項
11/20/2024

建立具有指定大小、位模式和作用點的單色游標。

若要在運行時間建立彩色游標，您可以使用 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上高 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 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winuser.h （包括 Windows.h）
連結庫	User32.lib
DLL	User32.dll