共用方式為


setCursor 函式 (winuser.h)

設定游標圖形。

語法

HCURSOR SetCursor(
  [in, optional] HCURSOR hCursor
);

參數

[in, optional] hCursor

類型: HCURSOR

數據指標的句柄。

數據指標必須由 CreateCursorCreateIconIndirect 函式建立,或是 由 LoadCursorLoadImage 函式載入。

如果此參數為 NULL,則會從畫面中移除游標。

傳回值

類型: HCURSOR

如果有一個數據指標,則傳回值是前一個數據指標的句柄。

如果沒有先前的數據指標,則傳回值為 NULL

備註

只有在新數據指標與上一個數據指標不同時,才會設定數據指標;否則,函式會立即傳回。

數據指標是共享資源。 只有當游標位於其工作區或視窗擷取滑鼠輸入時,視窗才應該設定游標圖形。 在沒有滑鼠的系統中,視窗應該在游標離開工作區之前,或將控制權放棄給另一個視窗之前,先還原前一個游標。

如果您的應用程式在視窗內時必須設定游標,請確定指定視窗類別的類別數據指標設定為 NULL。 如果類別數據指標不是 NULL,系統會在每次移動滑鼠時還原類別游標。

如果內部數據指標顯示計數小於零,則不會在畫面上顯示游標。 如果應用程式使用 ShowCursor 函式來隱藏資料指標超過顯示數據指標的次數,就會發生這種情況。

範例

如需範例,請參閱 顯示數據指標

規格需求

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

另請參閱

概念

資料指標

建立數據指標

CreateCursor

CreateIconIndirect

GetCursor

GetSystemMetrics

LoadCursor

LoadImage

參考

SetCursorPos

ShowCursor