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:UsersMBSUserDocumentsVisual Studio 2010ProjectsConsoleApplication2", FileMode.Create, FileAccess.Write);
                //StreamWriter sw = new StreamWriter(fs);
                sw.BaseStream.Seek(0, 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(5000);

            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(1000);
            Console.WriteLine(findMenuItemAutomationId.ToString() + " invoked.");
            #endregion

            #region Step3: Set text: "World" in Find Dialog.
            Console.WriteLine("Step3: Set text in Find Dialog.");
            
            string findTextAutomationId = "1152";
            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 = "1";
            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 = "2";
            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 = "15";
            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(-1);
            TextPatternRange[] searchRange = textPattern.GetSelection();
            int startPoints = textPattern.DocumentRange.CompareEndpoints(
                TextPatternRangeEndpoint.Start,
                searchRange[0],
                TextPatternRangeEndpoint.Start);
            int endPoints = textPattern.DocumentRange.CompareEndpoints(
                TextPatternRangeEndpoint.End,
                searchRange[0],
                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
        }
    }
}