获取 GUI 窗口中控件的各种类型的信息.
GuiControlGet, OutputVar , SubCommand, ControlID, Value
如果为空或省略, 它的表现就好像已经指定了该控件所关联变量名称(如果有), 例如 GuiControlGet, MyEdit 等同于 GuiControlGet, MyEdit,, MyEdit). 请指定该控件所关联的变量名(如果有), ClassNN, 文本, 或 [v1.1.04+] 中的控件 HWND. 有关详情, 请参阅控件标识符.
如果控件不在默认 GUI 中, 那么 必须设置 GUI 的名称或 HWND -- 除非在 [v1.1.20+] 版本中, ControlID 参数为 HWND, 因为每个 HWND 都是唯一值. 有关详情, 请参阅备注 .
对于 SubCommand, 指定以下命令之一:
检索控件的内容.
GuiControlGet, OutputVar ,, ControlID, Text
留空 SubCommand, 来获取控件的内容.
若要无条件获取控件的文本/标题而非其实际内容, 请指定 Text 为最后一个参数. 此设置仅适用于 CheckBox, Radio, DropDownList 和 ComboBox.
除以下情况外, 所有控件类型都无需额外说明:
Picture: 获取控件创建时最初指定的图片文件名. 即使指定了新的图片文件名, 此名称也不会改变.
Edit: 获取控件的内容, 但文本中断行的位置表示为单独的换行符(`n) 而不是非 GUI 命令(例如 ControlGetText 和 ControlSetText) 使用的传统 CR+LF(`r`n).
Hotkey: 如果控件中不含控件, 则获取到空值. 否则它获取到修饰符和键名. 例如: ^!C, ^Home, +^NumpadHome.
CheckBox/Radio: 控件被选中时获取的值为 1, 未选中时为 0, 而中间状态时为 -1. 要获取控件的文本/标题, 请指定单词 Text 为最后一个参数. 注: 与 Gui Submit 不同, 单选按钮的状态总是单独获取的, 不论它们是否在单选按钮组中.
UpDown/Slider/Progress: 获取控件的当前位置.
Tab/DropDownList/ComboBox/ListBox: 获取当前选择的项目/选项卡的文本(如果控件含有 AltSubmit 则为其位置). 对于组合框, 如果没有选择的项目, 则获取控件编辑区域的文本. 对于多选列表框, 输出结果中使用窗口的当前分隔符. 若要无条件获取 DropDownList 或 ComboBox 中的文本/标题内容, 则需将最后一个参数指定为单词 Text.
ListView/TreeView: 当 SubCommand 为空时不支持它们. 作为替代, 请使用内置的 ListView 函数和 TreeView 函数.
StatusBar: 仅获取首个部分的文本.
ActiveX: 获取控件的 ActiveX 组件的新包装器对象.
检索控件的位置和大小.
GuiControlGet, OutputVar, Pos , ControlID
这里的位置相对于 GUI 窗口的工作区, 不包括窗口的标题栏, 菜单栏和边框的区域. 信息保存在四个名称以 OutputVar 开始的变量中. 例如:
GuiControlGet, MyEdit, Pos MsgBox The X coordinate is %MyEditX%. The Y coordinate is %MyEditY%. The width is %MyEditW%. The height is %MyEditH%.
在函数中, 要创建一组全局变量而不是局部变量, 请在此命令前声明 OutputVar 为全局变量(对于假设全局函数, 反之亦成). 但是, 通常需要对每个变量都进行声明, 因为可能会造成混乱的根源.
有关演示, 请参阅示例 #4.
检索带有键盘焦点的控件的 ClassNN.
GuiControlGet, OutputVar, Focus
由于 GUI 窗口必须是活动的, 这样其中的某个控件才会含有焦点, 所以如果窗口不是活动的 OutputVar 将会置空.
有关演示, 请参阅示例 #5.
检索带有焦点的控件的关联变量的名称.
GuiControlGet, OutputVar, FocusV
由于 GUI 窗口必须是活动的, 这样其中的某个控件才会含有焦点, 所以如果窗口不是活动的 OutputVar 将会置空.
如果那个控件没有关联变量, 则获取控件的文本/标题中前 63 个字符(这常用来避免给每个按钮分配变量名).
如果控件是启用的检索 1, 或者如果是禁用的检索 0.
GuiControlGet, OutputVar, Enabled , ControlID
如果控件是可见的检索 1, 或者如果是隐藏的检索 0.
GuiControlGet, OutputVar, Visible , ControlID
检索控件的窗口句柄(HWND).
GuiControlGet, OutputVar, Hwnd , ControlID
但是, 选项 +HwndOutputVar 通常是获取 HWND 的一种更简便的方法.
检索控件的关联变量名称.
GuiControlGet, OutputVar, Name , ControlID
如果控件没有关联变量, OutputVar 将会置空.
[v1.1.04+]: 此命令失败时会抛出异常. 想了解更多信息, 请参阅运行时错误.
如果指定的窗口/控件不存在或由于其他问题使得命令无法工作, ErrorLevel 设为 1. 否则, 设为 0.
此命令仅能与图形用户界面窗口中的控件一起使用, 即那些通过 Gui 命令创建的窗口中的控件. 对于非图形用户界面控件, 请使用 ControlGet, ControlGetFocus, ControlGetPos, ControlGetText, 等命令.
要对非默认窗口进行操作(请参阅下面), 需要在子命令前加上窗口名称或编号(或在 [v1.1.03+] 中可以为窗口的 HWND) 后跟一个冒号, 例如:
GuiControlGet, MyEdit, MyGui: GuiControlGet, MyEdit, MyGui:Pos GuiControlGet, OutputVar, MyGui:Focus
这是必须的, 即使 ControlID 是控件的关联变量, 因为变量可用于多个 GUI 窗体. [v1.1.20+] 开始, 当 ControlID 为控件的 HWND 时 GUI 名称可以省略.
GUI 线程是由 GUI 动作启动的. GUI 动作包含从 GUI 窗口的菜单栏选择一个项目或触发其某个 g-标签(例如按下按钮).
GUI 线程的默认窗口名称是运行此线程的窗口名称. 非 GUI 线程的默认窗口编号为 1.
Gui, GuiControl, ControlGet, ControlGetFocus, ControlGetPos, ControlGetText
通过使用与 Edit 控件相关联的变量来获取该编辑控件的文本, 并将其存储在同一个变量中.
Gui, Add, Edit, vMyEdit, This is a test. Gui, Show GuiControlGet, MyEdit MsgBox %MyEdit%
Gui, Add, Edit, vMyEdit, This is a test. Gui, Show GuiControlGet, CtrlContents,, MyEdit MsgBox %CtrlContents%
通过使用 A_GuiControl 获取 CheckBox 控件的标题和勾选状态, 并将这些值存储在不同的变量中.
Gui, Add, CheckBox, gReportState, CheckBox 1 Gui, Add, CheckBox, gReportState, CheckBox 2 Gui, Show return ReportState: GuiControlGet, Caption,, %A_GuiControl%, Text GuiControlGet, State,, %A_GuiControl% MsgBox % Caption " is " (State = 0 ? "unchecked" : "checked") return
通过使用 ClassNN 获取 Picture 控件的位置和大小, 并将这些值存储在 PicX, PicY, PicW 和 PicH 变量中.
Gui, Add, Picture,, %A_AhkPath% Gui, Show GuiControlGet, Pic, Pos, Static1 MsgBox % "x" PicX ", y" PicY ", w" PicW ", h" PicH
获取带有键盘焦点控件的 ClassNN.
Gui, Add, Edit Gui, Show GuiControlGet, focused_control, Focus MsgBox %focused_control%