Client-Side UI Automation Provider - WinForm Sample

Client-Side UI Automation Provider -  WinForm Sample

2014-09-15

源代码

目录

引用程序集
实现提供程序接口
分发客户端提供程序
注册和配置客户端提供程序
WinForm Sample
参考

引用程序集^[1]

---

返回

• UIAutomationClient.dll
• UIAutomationProviders.dll
• UIAutomationTypes.dll

实现提供程序接口^[2]

---

返回

以下示列实现提供程序接口：IRawElementProviderSimple

     class WindowProvider : IRawElementProviderSimple
     {
         IntPtr providerHwnd;
         public WindowProvider(IntPtr hwnd)
         {
             providerHwnd = hwnd;
         }
         internal static IRawElementProviderSimple Create(
             IntPtr hwnd, int idChild, int idObject)
         {
             System.Diagnostics.Process[] processes = System.Diagnostics.Process.GetProcessesByName("WinFormServer");
             if (processes.Length == )
                 return null;
             //Check if the target is specified process
             //If yes, create and run provider instance
             if (processes[].MainWindowHandle != hwnd)
                 return null;
             else
                 return new WindowProvider(hwnd);
         }
         ProviderOptions IRawElementProviderSimple.ProviderOptions
         {
             get
             {
                 //Return ClientSideProvider as the implementation is in client
                 return ProviderOptions.ClientSideProvider;
             }
         }
         IRawElementProviderSimple IRawElementProviderSimple.HostRawElementProvider
         {
             get
             {
                 return AutomationInteropProvider.HostProviderFromHandle(providerHwnd);
             }
         }
         object IRawElementProviderSimple.GetPropertyValue(int aid)
         {
             if (AutomationProperty.LookupById(aid) ==
                 AutomationElementIdentifiers.NameProperty)
             {
                 //Our UIA.Name property implementation
                 //In production code, usually it uses Win32 or MSAA to get real information
                 return "UIA Client Implementation";
             }
             else
             {
                 return null;
             }
         }
         object IRawElementProviderSimple.GetPatternProvider(int iid)
         {
             //Return null means it does not support any Pattern Provider
             return null;
         }
     }

分发客户端提供程序^[1][2]

---

返回

UI 自动化应在托管代码程序集中查找客户端提供程序。该程序集中的命名空间应与该程序集同名。例如，称为UIAClientProvider.dll 的程序集应包含UIAClientProvider命名空间。 在该命名空间内创建 UIAutomationClientSideProviders 类。 在静态 ClientSideProviderDescriptionTable 字段的实现中，创建用于描述该提供程序的 ClientSideProviderDescription 结构数组。

ClientSideProviderDescription 结构数组将指定以下属性：

• 一个回调函数，用于创建提供程序对象。
• 提供程序支持的控件的类名。
• 提供程序支持的应用程序的映像名（通常是可执行文件的全名）。
• 控制如何根据目标应用程序中的窗口类对类名进行匹配的标志。

最后两个参数是可选的。  如果客户端希望对不同的应用程序使用不同的提供程序，则可以指定目标应用程序的映像名。 例如，客户端可以对支持多视图模式的已知应用程序中的 Win32 列表视图控件使用一个提供程序，而对不支持多视图模式的另一个已知应用程序中的类似控件使用另一个提供程序

     class UIAutomationClientSideProviders
     {
         public static ClientSideProviderDescription[] ClientSideProviderDescriptionTable =
             { new ClientSideProviderDescription(
                 WindowProvider.Create,
                 null) };
     }

注册和配置客户端提供程序^[1][2]

---

返回

动态链接库 (DLL) 中的客户端提供程序通过调用 RegisterClientSideProviderAssembly 进行加载。  无需进一步的操作，客户端应用程序便可以使用这些提供程序。

在客户端自己的代码中实现的提供程序通过使用 RegisterClientSideProviders 进行注册。  此方法将 ClientSideProviderDescription 结构数组用作参数。

ClientSettings.RegisterClientSideProviders(UIAutomationClientSideProviders.ClientSideProviderDescriptionTable);

WinForm Sample^[2]

---

返回

创建Console Application:UIAClientProvider,代码如下：

 using System;
 using System.Windows.Automation.Provider;
 using System.Windows.Automation;

 namespace UIAClientProvider
 {
     class Program
     {
         static void Main(string[] args)
         {
             ClientProviderSample.ClientProviderTest();
         }
     }

     public class ClientProviderSample
     {
         public static void ClientProviderTest()
         {
             //Calling RegisterClientSideProviders API to register out Client provider
             //Client Provider’s type information is stored in ClientSideProviderDescriptionTable Array
             ClientSettings.RegisterClientSideProviders(UIAutomationClientSideProviders.ClientSideProviderDescriptionTable);
             //Obtain main window of test target
             System.Diagnostics.Process[] processes = System.Diagnostics.Process.GetProcessesByName("WinFormServer");
             if (processes.Length == )
                 return;
             IntPtr hwnd = processes[].MainWindowHandle;
             //Get UIA object of the test target main window
             AutomationElement elementWindow = AutomationElement.FromHandle(hwnd);
             //Read UIA.Name property
             Console.WriteLine(elementWindow.Current.Name);
             Console.WriteLine();
             Console.WriteLine("Press any key to exit.");
             Console.ReadLine();
         }
     }
     class UIAutomationClientSideProviders
     {
         public static ClientSideProviderDescription[] ClientSideProviderDescriptionTable =
             { new ClientSideProviderDescription(
                 WindowProvider.Create,
                 null) };
     }
     class WindowProvider : IRawElementProviderSimple
     {
         IntPtr providerHwnd;
         public WindowProvider(IntPtr hwnd)
         {
             providerHwnd = hwnd;
         }
         internal static IRawElementProviderSimple Create(
             IntPtr hwnd, int idChild, int idObject)
         {
             System.Diagnostics.Process[] processes = System.Diagnostics.Process.GetProcessesByName("WinFormServer");
             if (processes.Length == )
                 return null;
             //Check if the target is specified process
             //If yes, create and run provider instance
             if (processes[].MainWindowHandle != hwnd)
                 return null;
             else
                 return new WindowProvider(hwnd);
         }
         ProviderOptions IRawElementProviderSimple.ProviderOptions
         {
             get
             {
                 //Return ClientSideProvider as the implementation is in client
                 return ProviderOptions.ClientSideProvider;
             }
         }
         IRawElementProviderSimple IRawElementProviderSimple.HostRawElementProvider
         {
             get
             {
                 return AutomationInteropProvider.HostProviderFromHandle(providerHwnd);
             }
         }
         object IRawElementProviderSimple.GetPropertyValue(int aid)
         {
             if (AutomationProperty.LookupById(aid) ==
                 AutomationElementIdentifiers.NameProperty)
             {
                 //Our UIA.Name property implementation
                 //In production code, usually it uses Win32 or MSAA to get real information
                 return "UIA Client Implementation";
             }
             else
             {
                 return null;
             }
         }
         object IRawElementProviderSimple.GetPatternProvider(int iid)
         {
             //Return null means it does not support any Pattern Provider
             return null;
         }
     }
 }

创建一个简单的WinForm Application: WinFormServer，代码如下：

 using System;
 using System.Windows.Forms;

 namespace WinFormServer
 {
     public partial class Form1 : Form
     {
         public Form1()
         {
             InitializeComponent();

             this.Name = "testForm";
             this.Text = "ClientUIADemo";

         }
     }
 }

操作：

打开WinFormServer.exe。

运行UIAClientProvider。

参考

[1] 客户端 UI 自动化提供程序的实现

[2] UI Automation -- Under the Hood