Server-Side UI Automation Provider - WPF Sample

Server-Side UI Automation Provider - WPF Sample

2014-09-14

引用程序集

自动化对等类

WPF Sample

参考

引用程序集

---

返回

• UIAutomationProviders.dll
• UIAutomationTypes.dll
• WindowsBase.dll

自动化对等类^[1]

---

返回

WPF 控件通过派生自 AutomationPeer 的对等类的树来支持 UI 自动化。  按照约定，对等类的名称须以控件类的名称开头，并以“AutomationPeer”结尾。 例如，ButtonAutomationPeer 是 Button 控件类的对等类。 这些对等类基本等效于 UI 自动化控件类型，但专用于 WPF 元素。 通过 UI 自动化接口访问 WPF 应用程序的自动化代码不直接使用自动化对等类，但同一进程空间中的自动化代码可以直接使用自动化对等类。

图1 ButtonAutomationPeer metadata

WPF Sample^[2]

---

返回

示例代码如下：

 using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Text;
 using System.Windows;
 using System.Windows.Controls;
 using System.Windows.Data;
 using System.Windows.Documents;
 using System.Windows.Input;
 using System.Windows.Media;
 using System.Windows.Media.Imaging;
 using System.Windows.Navigation;
 using System.Windows.Shapes;
 using System.Windows.Automation.Peers;
 using System.Windows.Automation.Provider;
 namespace WpfServerProvider
 {
     /// <summary>
     /// Interaction logic for MainWindow.xaml
     /// </summary>
     public partial class MainWindow : Window
     {
         public MainWindow()
         {
             InitializeComponent();
             UIAButton btn = new UIAButton();
             btn.Content = "TestButton";
             this.Content = btn;
         }
     }
     //My WPF button class, derive from WPF Button class
     public class UIAButton : Button
     {
         //Override this function to return my derived AutomationPeer class
         protected override AutomationPeer OnCreateAutomationPeer()
         {
             return new UIAButtonAutomationPeer(this);
         }
     }
     //My AutomationPeer class
     //Add implementation of UI ValuePattern comparing with base implementation
     public class UIAButtonAutomationPeer : ButtonAutomationPeer, IValueProvider
     {
         //owner parameter is the WPF Button instance
         public UIAButtonAutomationPeer(Button owner)
             : base(owner)
         {
         }
         //Return UIA Name property
         protected override string GetNameCore()
         {
             string originalName = base.GetNameCore();
             return string.Format("{0} {1}", originalName, DateTime.Now.ToLongTimeString());
         }
         //Return ValuePattern interface
         public override object GetPattern(PatternInterface patternInterface)
         {
             if (patternInterface == PatternInterface.Value)
             {
                 return this;
             }
             return null;
         }
         public bool IsReadOnly { get { return true; } }
         //ValuePattern's implementation
         public string Value
         {
             get
             {
                 return string.Format("Height={0},Wideth={1}",
                     Owner.RenderSize.Height, Owner.RenderSize.Width);
             }
         }
         public void SetValue(string value) { }
     }
 }

图2 UISpy to WPF provider sample

参考

[1] WPF 自定义控件的 UI 自动化
[2] UI Automation -- Under the Hood