CaretGetPos

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

CaretFound := CaretGetPos(&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"
}