用于检索有关控件的信息, 或对控件进行各种操作的函数. 单击函数名查看详细信息.
| 函数 | 描述 |
|---|---|
| ControlAddItem | 在列表框, 组合框或下拉列表的底部添加一个新的条目. |
| ControlChooseIndex | 通过索引在列表框, 组合框, 下拉列表或选项卡控件页面中选择一个条目. |
| ControlChooseString | 通过字符串在列表框, 组合框, 下拉列表或选项卡控件页面中选择一个条目. |
| ControlClick | 发送鼠标按钮或鼠标滚轮事件到窗口或控件. |
| ControlDeleteItem | 通过索引删除列表框, 组合框, 下拉列表中的一个条目. |
| ControlFindItem | 通过字符串搜索列表框, 组合框, 下拉列表中的条目, 并返回它的索引. |
| ControlFocus | 设置键盘焦点到窗口的指定控件上. |
| ControlGetChecked | 如果选中复选框或单选按钮, 则返回 1, 或未选中时返回 0. |
| ControlGetChoice | 返回列表框, 组合框或下拉列表中当前选定条目的文本. |
| ControlGetClassNN | 返回控件的 ClassNN(类名和序号). |
| ControlGetEnabled | 如果控件是启用的, 返回 1, 或禁用时返回 0. |
| ControlGetFocus | 如果有, 则获取目标窗口中具有键盘焦点的控件. |
| ControlGetHwnd | 返回控件的窗口句柄(HWND). |
| ControlGetIndex | 返回列表框, 组合框, 下拉列表当前选中条目的序号, 或选项卡控件中当前激活页面的索引. |
| ControlGetItems | 返回列表框, 组合框或下拉列表中的条目数组. |
| ControlGetPos | 获取控件的位置和大小. |
| ControlGetStyle ControlGetExStyle |
返回表示控件样式或扩展样式的整数. |
| ControlGetText | 从控件检索文本. |
| ControlGetVisible | 如果控件可见, 则返回 1, 或者隐藏时返回 0. |
| ControlHide | 隐藏控件. |
| ControlHideDropDown | 隐藏组合框或下拉列表的弹出列表. |
| ControlMove | 移动和/或调整控件. |
| ControlSend ControlSendText |
向窗口或控件发送模拟的击键或文本. |
| ControlSetChecked | 选中 或取消选中复选框或单选按钮. |
| ControlSetEnabled | 启用或禁用控件. |
| ControlSetStyle ControlSetExStyle |
分别更改控件的样式或扩展样式. |
| ControlSetText | 更改控件的文本. |
| ControlShow | 如果控件先前是隐藏的, 则显示该控件. |
| ControlShowDropDown | 显示组合框或下拉列表的弹出列表. |
| EditGetCurrentCol | 返回编辑控件中光标所在位置的列号. |
| EditGetCurrentLine | 返回编辑控件中光标所在位置的行号. |
| EditGetLine | 根据行号返回编辑控件中某一行的文本内容. |
| EditGetLineCount | 返回编辑控件的行数. |
| EditGetSelectedText | 返回编辑控件中选定的文本. |
| EditPaste | 将字符串粘贴到编辑控件中的光标处. |
| ListViewGetContent | 返回列表视图控件(如行, 列或计数值) 的内容数据. |
通常情况下, 可能会抛出以下错误之一:
这里列出的大多数函数都是为在非图形用户界面窗口中的控件使用而设计的, 即那些并非通过 Gui 函数创建的窗口. 它们最适用于常见的或预定义的 Microsoft 控件; 而某些应用程序则使用自定义或修改后的控件, 在这种情况下, 函数可能无法按预期工作. 对于 GUI 控件, 如果存在一个合适的对应项, 通常使用其 GuiControl 对象.
对单个控件进行操作的函数有一个名为 ControlID 的参数, 该参数支持多种不同的方式来标识控件. 有关详情, 请参阅控件标识符.
为了提高可靠性, 在每次使用更改控件的控件函数(除了 ControlSetStyle 和 ControlSetExStyle 外) 之后, 会自动执行延迟. 该延迟可以通过 SetControlDelay 或给 A_ControlDelay 赋值来更改. 有关详情, 请参阅 SetControlDelay 备注.
要发现鼠标当前悬停的控件的 ClassNN 或 HWND, 请使用 MouseGetPos.
要检索窗口中所有控件的数组, 请使用 WinGetControls 或 WinGetControlsHwnd.
SetControlDelay, 窗口函数, GuiControl 对象(用于由脚本创建的控件)