createCursor 函式 (winuser.h)

發行項
02/05/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/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