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 |
另請參閱
概念
參考