setCaretPos 函式 (winuser.h)
將插入號移至指定的座標。 如果擁有插入號的視窗是以 CS_OWNDC 類別樣式建立的，則指定的座標會受限於與該視窗相關聯之裝置內容的對應模式。
語法
BOOL SetCaretPos(
[in] int X,
[in] int Y
);
參數
[in] X
類型： int
插入號的新 X 座標。
[in] Y
類型： int
插入號的新 Y 座標。
傳回值
類型： BOOL
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
SetCaretPos 會移動插入號是否隱藏插入號。
系統會針對每個佇列提供一個插入號。 只有在視窗具有鍵盤焦點或作用中時，才會建立插入號。 窗口應該會在失去鍵盤焦點或變成非作用中之前終結插入號。 視窗只有在擁有插入號時，才能設定插入號位置。
DPI 虛擬化
此 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) |
另請參閱
概念
參考