窗口界面控制(FlaUI)
触发Windows窗口的菜单/按钮等控件(通过FlaUI库实现)。
当前模块定义
sys:flauiautomation输入 10 · 输出 12 · 枚举 3
输入参数
- 操作类型
typeEnum必填操作类型。按下和抬起需要配对使用。
6 个选项触发窗口菜单、触发窗口控件、获取窗口控件信息
触发窗口菜单默认TriggerMenu触发窗口控件TriggerControl获取窗口控件信息GetControlInfo获取鼠标指针位置控件信息GetCursorPointControlInfo获取指定位置控件信息GetControlInfoByPosition获取焦点控件信息GetFocusedControlInfo - 窗口句柄
windowText可选要操作哪个窗口的控件。不填写=使用前台窗口;或窗口句柄数字。
- 菜单路径
menuPathText可选菜单的展开路径。每行写一个级别的菜单名(需完全匹配)
- 展开延时
expandDelayInteger可选等待下级菜单展开的时间(ms)
- 控件XPath或Name
controlText可选控件的XPath或Name、AutomationId。XPath以/开始。(可写多个,每行一个,前一个查找失败时会自动尝试下一个)
- 控件类型
controlTypeEnum可选可选。当有多个名称相同但类型不同的控件时区分。
42 个选项任意类型、AppBar、Button
任意类型默认0AppBarAppBarButtonButtonCalendarCalendarCheckBoxCheckBoxComboBoxComboBoxCustomCustomDataGridDataGridDataItemDataItemDocumentDocumentEditEditGroupGroupHeaderHeaderHeaderItemHeaderItemHyperlinkHyperlinkImageImageListListListItemListItemMenuMenuMenuBarMenuBarMenuItemMenuItemPanePaneProgressBarProgressBarRadioButtonRadioButtonScrollBarScrollBarSemanticZoomSemanticZoomSeparatorSeparatorSliderSliderSpinnerSpinnerSplitButtonSplitButtonStatusBarStatusBarTabTabTabItemTabItemTableTableTextTextThumbThumbTitleBarTitleBarToolBarToolBarToolTipToolTipTreeTreeTreeItemTreeItemWindowWindow - 动作
controlOperationEnum可选对控件执行的操作。
18 个选项自动、调用(按钮、菜单项等)、设置焦点
自动默认Auto调用(按钮、菜单项等)Invoke设置焦点SetFocus鼠标左键单击LeftClick鼠标中键单击MiddleClick鼠标右键单击RightClick鼠标左键双击LeftDoubleClick单选:选择(单选框、标签页等)Select多选:添加到多选(多选列表等)AddToSelection多选:从多选中移除(多选列表)RemoveFromSelection多选:切换选中状态ToggleItemSelection展开折叠:展开(菜单等)Expand展开折叠:折叠(菜单等)Collapse展开折叠:切换展开折叠(菜单等)ToggleExpandCollapse切换:切换(检查框等)Toggle切换:开(检查框等)ToggleOn切换:关(检查框等)ToggleOff设置值SetValue - 值
valueText可选仅用于 "设置值" 操作。
- 坐标位置
pointLocationText可选指定要检查的控件的屏幕坐标位置,格式为"x,y"
- 失败后停止
stopIfFailBoolean可选失败后是否停止动作
输出参数
- 是否成功
isSuccessBoolean操作是否成功
- 值
valueText控件的值
- 文本
controlTextText获取控件上的文本。根据控件不同,可能从Value、Text、Name等信息获取。
- 位置
rectText控件坐标位置
- 控件名称
controlNameText - 控件类型
controlTypeText - 控件XPath
controlXPathText - 控件类型ID
controlTypeIdInteger - 其他信息
controlInfoDict - 是否启用
controlIsEnabledBoolean控件未处于禁用状态
- 是否可见
controlIsVisibleBoolean控件是否在屏幕上。
- 原始对象
elementObject返回控件的AutomationElement对象
窗口界面控制(FlaUI)
触发Windows窗口的菜单/按钮等控件(通过FlaUI库实现)。
使用说明
本模块与窗口界面控制共享基础使用说明;本页上方参数表是当前模块自身的定义。