setCursor 函式 (winuser.h)

設定游標圖形。

語法

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

[in, optional] hCursor

類型： HCURSOR

數據指標的句柄。

數據指標必須由 CreateCursor 或 CreateIconIndirect 函式建立，或是由 LoadCursor 或 LoadImage 函式載入。

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

類型： HCURSOR

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

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

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

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

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

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

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

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