setCaretPos 函式 (winuser.h)

將插入號移至指定的座標。如果擁有插入號的視窗是以 CS_OWNDC 類別樣式建立的，則指定的座標會受限於與該視窗相關聯之裝置內容的對應模式。

語法

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

[in] X

類型： int

插入號的新 X 座標。

[in] Y

類型： int

插入號的新 Y 座標。

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

SetCaretPos 會移動插入號是否隱藏插入號。

系統會針對每個佇列提供一個插入號。只有在視窗具有鍵盤焦點或作用中時，才會建立插入號。窗口應該會在失去鍵盤焦點或變成非作用中之前終結插入號。視窗只有在擁有插入號時，才能設定插入號位置。

此 API 不會參與 DPI 虛擬化。根據與插入號相關聯的視窗，提供的位置會解譯為邏輯座標。呼叫線程不會納入考慮。

如需範例，請參閱建立和顯示插入號。

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