SetCursorPos 函式 (winuser.h)

將游標移至指定的螢幕座標。 如果新座標不在最近 ClipCursor 函數調用所設定的螢幕矩形內,系統會自動調整座標,讓游標停留在矩形內。

語法

BOOL SetCursorPos(
  [in] int X,
  [in] int Y
);

參數

[in] X

類型: int

游標的新 X 座標,以螢幕座標表示。

[in] Y

類型: int

游標的新 Y 座標,以螢幕座標為單位。

傳回值

類型: BOOL

如果成功或零,則傳回非零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

數據指標是共享資源。 只有當游標位於視窗的工作區時,視窗才應該移動游標。

呼叫進程 必須WINSTA_WRITEATTRIBUTES視窗 月臺的存取權。

當您呼叫 SetCursorPos 時,輸入桌面必須是目前的桌面。 呼叫 OpenInputDesktop 來判斷目前的桌面是否為輸入桌面。 如果不是,請使用 OpenInputDesktop 傳回的 HDESK 呼叫 SetThreadDesktop 以切換至該桌面。

範例

如需範例,請參閱 使用鍵盤移動游標

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-window-l1-1-2 (於 Windows 10 10.0.10240 版)

另請參閱

ClipCursor

概念

資料指標

GetCursorPos

參考

SetCaretPos

SetCursor

ShowCursor