跳到主要内容

窗口界面控制(FlaUI)

触发Windows窗口的菜单/按钮等控件(通过FlaUI库实现)。

当前模块定义

sys:flauiautomation第三方软件交互Action
标准模块
输入 10 · 输出 12 · 枚举 3

输入参数

  • 操作类型typeEnum必填

    操作类型。按下和抬起需要配对使用。

    填写 固定输入默认 TriggerMenu
    6 个选项触发窗口菜单、触发窗口控件、获取窗口控件信息
    触发窗口菜单默认TriggerMenu
    触发窗口控件TriggerControl
    获取窗口控件信息GetControlInfo
    获取鼠标指针位置控件信息GetCursorPointControlInfo
    获取指定位置控件信息GetControlInfoByPosition
    获取焦点控件信息GetFocusedControlInfo
  • 窗口句柄windowText可选

    要操作哪个窗口的控件。不填写=使用前台窗口;或窗口句柄数字。

    填写 输入或变量条件 仅:TriggerMenu, TriggerControl, GetControlInfo
  • 菜单路径menuPathText可选

    菜单的展开路径。每行写一个级别的菜单名(需完全匹配)

    填写 输入或变量条件 仅:TriggerMenu
  • 展开延时expandDelayInteger可选

    等待下级菜单展开的时间(ms)

    填写 固定输入条件 仅:TriggerMenu默认 200
  • 控件XPath或NamecontrolText可选

    控件的XPath或Name、AutomationId。XPath以/开始。(可写多个,每行一个,前一个查找失败时会自动尝试下一个)

    填写 输入或变量条件 仅:TriggerControl, GetControlInfo
  • 控件类型controlTypeEnum可选

    可选。当有多个名称相同但类型不同的控件时区分。

    填写 输入或变量条件 仅:TriggerControl, GetControlInfo默认 0
    42 个选项任意类型、AppBar、Button
    任意类型默认0
    AppBarAppBar
    ButtonButton
    CalendarCalendar
    CheckBoxCheckBox
    ComboBoxComboBox
    CustomCustom
    DataGridDataGrid
    DataItemDataItem
    DocumentDocument
    EditEdit
    GroupGroup
    HeaderHeader
    HeaderItemHeaderItem
    HyperlinkHyperlink
    ImageImage
    ListList
    ListItemListItem
    MenuMenu
    MenuBarMenuBar
    MenuItemMenuItem
    PanePane
    ProgressBarProgressBar
    RadioButtonRadioButton
    ScrollBarScrollBar
    SemanticZoomSemanticZoom
    SeparatorSeparator
    SliderSlider
    SpinnerSpinner
    SplitButtonSplitButton
    StatusBarStatusBar
    TabTab
    TabItemTabItem
    TableTable
    TextText
    ThumbThumb
    TitleBarTitleBar
    ToolBarToolBar
    ToolTipToolTip
    TreeTree
    TreeItemTreeItem
    WindowWindow
  • 动作controlOperationEnum可选

    对控件执行的操作。

    填写 固定输入条件 仅:TriggerControl默认 Auto
    18 个选项自动、调用(按钮、菜单项等)、设置焦点
    自动默认Auto
    调用(按钮、菜单项等)Invoke
    设置焦点SetFocus
    鼠标左键单击LeftClick
    鼠标中键单击MiddleClick
    鼠标右键单击RightClick
    鼠标左键双击LeftDoubleClick
    单选:选择(单选框、标签页等)Select
    多选:添加到多选(多选列表等)AddToSelection
    多选:从多选中移除(多选列表)RemoveFromSelection
    多选:切换选中状态ToggleItemSelection
    展开折叠:展开(菜单等)Expand
    展开折叠:折叠(菜单等)Collapse
    展开折叠:切换展开折叠(菜单等)ToggleExpandCollapse
    切换:切换(检查框等)Toggle
    切换:开(检查框等)ToggleOn
    切换:关(检查框等)ToggleOff
    设置值SetValue
  • valueText可选

    仅用于 "设置值" 操作。

    填写 输入或变量条件 仅:TriggerControl
  • 坐标位置pointLocationText可选

    指定要检查的控件的屏幕坐标位置,格式为"x,y"

    填写 输入或变量条件 仅:GetControlInfoByPosition
  • 失败后停止stopIfFailBoolean可选

    失败后是否停止动作

    填写 固定输入默认 true

输出参数

  • 是否成功isSuccessBoolean

    操作是否成功

  • valueText

    控件的值

    条件 仅:GetControlInfo, GetCursorPointControlInfo, GetFocusedControlInfo, GetControlInfoByPosition
  • 文本controlTextText

    获取控件上的文本。根据控件不同,可能从Value、Text、Name等信息获取。

    条件 仅:GetControlInfo, GetCursorPointControlInfo, GetFocusedControlInfo, GetControlInfoByPosition
  • 位置rectText

    控件坐标位置

    条件 仅:GetControlInfo, GetCursorPointControlInfo, GetFocusedControlInfo, GetControlInfoByPosition
  • 控件名称controlNameText
    条件 仅:GetControlInfo, GetCursorPointControlInfo, GetFocusedControlInfo, GetControlInfoByPosition
  • 控件类型controlTypeText
    条件 仅:GetControlInfo, GetCursorPointControlInfo, GetFocusedControlInfo, GetControlInfoByPosition
  • 控件XPathcontrolXPathText
    条件 仅:GetControlInfo, GetCursorPointControlInfo, GetFocusedControlInfo, GetControlInfoByPosition
  • 控件类型IDcontrolTypeIdInteger
    条件 仅:GetControlInfo, GetCursorPointControlInfo, GetFocusedControlInfo, GetControlInfoByPosition
  • 其他信息controlInfoDict
    条件 仅:GetControlInfo, GetCursorPointControlInfo, GetFocusedControlInfo, GetControlInfoByPosition
  • 是否启用controlIsEnabledBoolean

    控件未处于禁用状态

    条件 仅:GetControlInfo, GetCursorPointControlInfo, GetFocusedControlInfo, GetControlInfoByPosition
  • 是否可见controlIsVisibleBoolean

    控件是否在屏幕上。

    条件 仅:GetControlInfo, GetCursorPointControlInfo, GetFocusedControlInfo, GetControlInfoByPosition
  • 原始对象elementObject

    返回控件的AutomationElement对象

    条件 仅:GetControlInfo, GetCursorPointControlInfo, GetFocusedControlInfo, GetControlInfoByPosition

窗口界面控制(FlaUI)

触发Windows窗口的菜单/按钮等控件(通过FlaUI库实现)。
操作类型
操作类型。按下和抬起需要配对使用。
窗口句柄
 
要操作哪个窗口的控件。不填写=使用前台窗口;或窗口句柄数字。
菜单路径
 
菜单的展开路径。每行写一个级别的菜单名(需完全匹配)
展开延时
200
等待下级菜单展开的时间(ms)
是否成功
-- 选择变量 --
操作是否成功
步骤注释
 

使用说明

本模块与窗口界面控制共享基础使用说明;本页上方参数表是当前模块自身的定义。