使用UI Automation Framework公开自定义属性

时间:2015-05-21 09:09:11

标签: winforms microsoft-ui-automation

给定一个非常基本的 WinForms 自定义/用户控件,使用System.Windows.Automation可以操作自定义控件的内置属性。

这样做是这样的:

public object GetPropertyValue(int propertyId)
      {
         if (propertyId == AutomationElementIdentifiers.NameProperty.Id)
           {
              return "Hello World!";
           }
      }

我想做的是将自定义属性暴露给ui自动化,例如ReadyState,LastAccessed等。

这可能吗?

1 个答案:

答案 0 :(得分:2)

不,您无法扩展属性列表,而且使用具有较差UI自动化支持的Winforms(它使用带网桥的IAccessible等)这一事实很复杂。

你可以做的是将一些虚假对象添加到自动化树中,例如,这是一个Winforms UserControl示例:

public partial class UserControl1 : UserControl
{
    public UserControl1()
    {
        InitializeComponent();

        Button button = new Button();
        button.Location = new Point(32, 28);
        button.Size = new Size(75, 23);
        button.Text = "MyButton";
        Controls.Add(button);

        Label label = new Label();
        label.Location = new Point(49, 80);
        label.Size = new Size(35, 13);
        label.Text = "MyLabel";
        Controls.Add(label);

        MyCustomProp = "MyCustomValue";
    }

    public string MyCustomProp { get; set; }

    protected override AccessibleObject CreateAccessibilityInstance()
    {
        return new UserControl1AccessibleObject(this);
    }

    protected class UserControl1AccessibleObject : ControlAccessibleObject
    {
        public UserControl1AccessibleObject(UserControl1 ownerControl)
            : base(ownerControl)
        {
        }

        public new UserControl1 Owner
        {
            get
            {
                return (UserControl1)base.Owner;
            }
        }

        public override int GetChildCount()
        {
            return 1;
        }

        public override AccessibleObject GetChild(int index)
        {
            if (index == 0)
                return new ValueAccessibleObject("MyCustomProp", Owner.MyCustomProp);

            return base.GetChild(index);
        }
    }
}

public class ValueAccessibleObject : AccessibleObject
{
    private string _name;
    private string _value;

    public ValueAccessibleObject(string name, string value)
    {
        _name = name;
        _value = value;
    }

    public override AccessibleRole Role
    {
        get
        {
            return AccessibleRole.Text; // activate Value pattern
        }
    }

    // note you need to override with member values, base value cannot always store something
    public override string Value { get { return _value; } set { _value = value; } }
    public override string Name { get { return _name; } }
}

这就是它在自动化树中的显示方式(使用inspect.exe工具):

enter image description here

请注意,此技术还支持写回属性,因为它基于ValuePattern。