# CaretGetPos

检索插入符号的当前位置(文本插入点).

    CaretFound := (&OutputVarX, &OutputVarY)

## 参数

&OutputVarX, &OutputVarY

  类型: VarRef

  用于存储 X 和 Y 坐标的输出变量的引用. 检索到的坐标相对于活动窗口的客户端区域, 除非使用 CoordMode 或 A_CoordModeCaret 覆盖.

## 返回值

类型: 整数(布尔值)

如果没有活动窗口或无法确定插入符号位置, 则函数返回 0(false), 并且输出变量为空. 如果系统返回一个插入符号位置, 则函数返回 1(true), 但这并不一定意味着插入符号是可见的.

## 备注

如果不需要相应的信息, 可以省略任何输出变量.

请注意, 某些窗口(例如 MS Word 的某些版本) 报告的插入符号位置相同, 无论其实际位置如何.

## 相关

CoordMode, A_CoordModeCaret

## 示例

允许用户移动插入光标, 其当前位置显示在一个自动更新的工具提示中.

    SetTimer WatchCaret, 100
    WatchCaret() {
        if CaretGetPos(&x, &y)
            ToolTip "X" x " Y" y, x, y - 20
        else
            ToolTip "No caret"
    }

dftg