UI Automation Test

UI Automation test is based on the windows API. U can find the UI Automation MSDN file from http://msdn.microsoft.com/en-us/library/ms753107.aspx link.

The important part is Using UI Automation fir Automated Testing.

As a new tester of UI Automation. I can give a demo that U can understand the UI automation better.

1st. Adding the refer reference. The reference U need add include(UIAutomation.dll, UIAutomationClientSideProvider.dll, UIAutomationTypes.dll). if U can not find these DLL U can find these in your computer C disc.

2nd. Add the using system.(System.Window.Automation).

3rd. Find the control. U must find the control which U using such as Button, textbox or label.

　　var desktop = AutomationElement.RootElement; // find the root element, can be consider as desktop
　　var condition = new PropertyCondition(AutomationElement.NameProperty, "test"); // define the string that should be find，name as "test"
　　var window = desktop.FindFirst(TreeScope.Children, condition); //find the desktop child control which confirm the string control

UI Automation  need a tool to find the control property and the event. The tool is the UI Spy.

If U want managemet the more properties, U can use the AndContion object.  Such as click the "OK" button.

　　var btnCondition = new AndCondition(
                new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Button),
                new PropertyCondition(AutomationElement.NameProperty, "ok"));

4th. How to trigger the control. Like Button click event, window drag event and so on. An easy example Button click:

　　var button = window.FindFirst(TreeScope.Children, btnCondition);
　　var clickPattern = (InvokePattern)button.GetCurrentPattern(InvokePattern.Pattern);
　　clickPattern.Invoke();

How to find the control contains which Patter?  See the UI Spy.

UI Automation Control Patterns Overview

Summary:

　　Read more MDSN file, test mare.

Next give a demo of UI Automation of Notepad Test.

 using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Text;
 using System.Windows.Automation;
 using System.Threading;
 using System.Diagnostics;
 using System.IO;
 using System.Windows.Automation.Text;

 namespace ConsoleApplication2
 {
     class Program
     {
         static void Main(string[] args)
         {
             #region step 0: create a txt file and name it with Demon.txt.
             if (!File.Exists("C:\\Users\\MBSUser\\Documents\\Visual Studio 2010\\Projects\\ConsoleApplication2\\Demo.txt"))
             {
                 FileStream fs = new FileStream("C:\\Users\\MBSUser\\Documents\\Visual Studio 2010\\Projects\\ConsoleApplication2\\ConsoleApplication2\\Demo.txt", FileMode.Create, FileAccess.Write);
                 StreamWriter sw = new StreamWriter(fs);

                 //FileStream fs = new FileStream(@"C:\Users\MBSUser\Documents\Visual Studio 2010\Projects\ConsoleApplication2", FileMode.Create, FileAccess.Write);
                 //StreamWriter sw = new StreamWriter(fs);
                 sw.BaseStream.Seek(, SeekOrigin.Begin);
                 sw.WriteLine("This is just a txt demo, Test World!.");
                 sw.Close();
             }
             else
             {
                 FileStream fsexist = new FileStream("C:\\Users\\MBSUser\\Documents\\Visual Studio 2010\\Projects\\ConsoleApplication2\\ConsoleApplication2\\Demo.txt", FileMode.Open, FileAccess.Write);
                 StreamWriter swexist = new StreamWriter(fsexist);
                 swexist.WriteLine("This is just a txt demo, Test World!.");
                 swexist.Close();
                 fsexist.Close();
             }
             #endregion

             #region step 1: Open 1 txt file by notepad
             ProcessStartInfo psi = new ProcessStartInfo("C:\\Users\\MBSUser\\Documents\\Visual Studio 2010\\Projects\\ConsoleApplication2\\ConsoleApplication2\\Demo.txt");
             psi.WindowStyle = ProcessWindowStyle.Normal;
             psi.UseShellExecute = true;

             Console.WriteLine("1.open 1 txt file by notepad.");
             Process p = Process.Start(psi);

             Thread.Sleep();

             IntPtr windowHandle = p.MainWindowHandle;
             AutomationElement notepad = AutomationElement.FromHandle(windowHandle);
             #endregion

             #region Step2: Click "Edit->Find" menu.
             // Step2-1: Expand Edit Menu.
             string editMenuAutomationId = "Item 2";
             Console.WriteLine("Step2: Click Find menu.");
             PropertyCondition propertyCondition = new PropertyCondition(
                 AutomationElement.AutomationIdProperty,
                 editMenuAutomationId);
             AutomationElement editMenu = notepad.FindFirst(TreeScope.Element | TreeScope.Descendants, propertyCondition);

             if (editMenu == null)
             {
                 Console.WriteLine(editMenuAutomationId.ToString() + " could not be found.");
                 return;
             }
             if ((bool)editMenu.GetCurrentPropertyValue(AutomationElement.IsEnabledProperty) == false)
             {
                 Console.WriteLine("Element not enabled.");
                 return;
             }
             ExpandCollapsePattern expandEdit = editMenu.GetCurrentPattern(ExpandCollapsePattern.Pattern)
                 as ExpandCollapsePattern;
             expandEdit.Expand();
             Console.WriteLine(editMenuAutomationId.ToString() + " expanded.");

             // Step2-2: Click Find menu item.
             string findMenuItemAutomationId = "Item 21";
             propertyCondition = new PropertyCondition(
                 AutomationElement.AutomationIdProperty,
                 findMenuItemAutomationId);
             AutomationElement findMenuItem = notepad.FindFirst(TreeScope.Element | TreeScope.Descendants, propertyCondition);

             if (findMenuItem == null)
             {
                 Console.WriteLine(findMenuItemAutomationId.ToString() + " could not be found.");
                 return;
             }
             if ((bool)findMenuItem.GetCurrentPropertyValue(AutomationElement.IsEnabledProperty) == false)
             {
                 Console.WriteLine("Element not enabled.");
                 return;
             }
             InvokePattern invokePattern = findMenuItem.GetCurrentPattern(InvokePattern.Pattern)
                 as InvokePattern;
             invokePattern.Invoke();

             // Wait for Find dialog pop up. Can use verify Find dialog existing to avoid hardcode sleep time.
             Thread.Sleep();
             Console.WriteLine(findMenuItemAutomationId.ToString() + " invoked.");
             #endregion

             #region Step3: Set text: "World" in Find Dialog.
             Console.WriteLine("Step3: Set text in Find Dialog.");

             string findTextAutomationId = "";
             string findText = "World";
             propertyCondition = new PropertyCondition(
                 AutomationElement.AutomationIdProperty,
                 findTextAutomationId);
             AutomationElement findTextField = notepad.FindFirst(TreeScope.Element | TreeScope.Descendants, propertyCondition);
             if (findTextField == null)
             {
                 Console.WriteLine(findTextAutomationId.ToString() + " could not be found.");
                 return;
             }
             if ((bool)findTextField.GetCurrentPropertyValue(AutomationElement.IsEnabledProperty) == false)
             {
                 Console.WriteLine("Element not enabled.");
                 return;
             }
             ValuePattern valuePattern =
                 findTextField.GetCurrentPattern(ValuePattern.Pattern)
                 as ValuePattern;
             valuePattern.SetValue(findText);
             Console.WriteLine(findTextAutomationId.ToString() + " value changed.");
             #endregion

             #region Step4: Click "Find Next".
             Console.WriteLine("Step3: Click Find Next button in Find Dialog.");

             string findNextAutomationId = "";
             propertyCondition = new PropertyCondition(
                 AutomationElement.AutomationIdProperty,
                 findNextAutomationId);
             AutomationElement findNextButton = notepad.FindFirst(TreeScope.Element | TreeScope.Descendants, propertyCondition);

             if (findNextButton == null)
             {
                 Console.WriteLine(findNextAutomationId.ToString() + " could not be found.");
                 return;
             }
             if ((bool)findNextButton.GetCurrentPropertyValue(AutomationElement.IsEnabledProperty) == false)
             {
                 Console.WriteLine("Element not enabled.");
                 return;
             }
             invokePattern =
                 findNextButton.GetCurrentPattern(InvokePattern.Pattern)
                 as InvokePattern;
             invokePattern.Invoke();
             Console.WriteLine(findNextAutomationId.ToString() + " invoked.");
             #endregion

             #region Step5: Click "Cancel" to close the Find dialog.
             Console.WriteLine("Step3: Click Cancel button to close the Find dialog.");

             string cancelAutomationId = "";
             propertyCondition = new PropertyCondition(
                 AutomationElement.AutomationIdProperty,
                 cancelAutomationId);
             AutomationElement cancelButton = notepad.FindFirst(TreeScope.Element | TreeScope.Descendants, propertyCondition);

             if (cancelButton == null)
             {
                 Console.WriteLine(cancelAutomationId.ToString() + " could not be found.");
                 return;
             }
             if ((bool)cancelButton.GetCurrentPropertyValue(AutomationElement.IsEnabledProperty) == false)
             {
                 Console.WriteLine("Element not enabled.");
                 return;
             }
             invokePattern =
                 cancelButton.GetCurrentPattern(InvokePattern.Pattern)
                 as InvokePattern;
             invokePattern.Invoke();
             Console.WriteLine(cancelAutomationId.ToString() + " invoked.");
             #endregion

             #region Step6: Verify the string is found.
             Console.WriteLine("Step6: Verify the string is found.");

             string actualResult = "";
             string expectedResult = findText;
             string editAreaAutomationId = "";
             propertyCondition = new PropertyCondition(
                 AutomationElement.AutomationIdProperty,
                 editAreaAutomationId);
             AutomationElement editArea = notepad.FindFirst(TreeScope.Element | TreeScope.Descendants, propertyCondition);

             if (editArea == null)
             {
                 Console.WriteLine(editAreaAutomationId.ToString() + " could not be found.");
                 return;
             }
             if ((bool)editArea.GetCurrentPropertyValue(AutomationElement.IsEnabledProperty) == false)
             {
                 Console.WriteLine("Element not enabled.");
                 return;
             }
             TextPattern textPattern =
                 editArea.GetCurrentPattern(TextPattern.Pattern)
                 as TextPattern;
             actualResult = textPattern.DocumentRange.GetText(-);
             TextPatternRange[] searchRange = textPattern.GetSelection();
             int startPoints = textPattern.DocumentRange.CompareEndpoints(
                 TextPatternRangeEndpoint.Start,
                 searchRange[],
                 TextPatternRangeEndpoint.Start);
             int endPoints = textPattern.DocumentRange.CompareEndpoints(
                 TextPatternRangeEndpoint.End,
                 searchRange[],
                 TextPatternRangeEndpoint.End);
             actualResult = actualResult.Substring(actualResult.Length + startPoints, -(startPoints + endPoints));

             if (expectedResult == actualResult)
             {
                 Console.WriteLine("Pass. The expected string is found.");
             }
             else
             {
                 Console.WriteLine(String.Format("Fail. The expected string is {0}; the actual string is {1}", expectedResult, actualResult));
             }

             #endregion

             #region Test Cleanup: Close notepad.
             Console.WriteLine("Test Cleanup: Close notepad.");
             p.CloseMainWindow();
             #endregion
         }
     }
 }