mmarquee.automation

Class UIAutomation

java.lang.Object

mmarquee.automation.UIAutomation

public class UIAutomation
extends Object

Created by HumphreysM on 26/01/2016. The base automation wrapper.

Field Summary

Fields

Modifier and Type	Field and Description
protected IUIAutomation	automation

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	UIAutomation() Constructor for UIAutomation library

Method Summary

Modifier and Type	Method and Description
void	addAutomationEventHandler(IUIAutomationElement sender, int eventId, TreeScope treeScope, EventHandler eventHandler) Adds an event handler for the given event.
AutomationApplication	attach(Process process) Attaches to the application process
void	captureScreen(String filename) Captures the screen.
IUIAutomationCondition	CreateAndCondition(IUIAutomationCondition condition0, IUIAutomationCondition condition1) Creates the raw and condition
CacheRequest	createCacheRequest() Create a cache request
IUIAutomationCacheRequest	CreateCacheRequest()
IUIAutomationCondition	CreateFalseCondition() Creates a false Condition
IUIAutomationCondition	CreateOrCondition(IUIAutomationCondition condition0, IUIAutomationCondition condition1) Getst the raw condition
IUIAutomationCondition	CreatePropertyCondition(int property, Object value) Creates a property condition
IUIAutomationCondition	CreateTrueCondition() Creates a true Condition
AutomationApplication	findProcess(String... command) Finds the given process
AutomationWindow	getDesktopWindow(String title) Gets the desktop window associated with the title
List<AutomationWindow>	getDesktopWindows() Gets the list of desktop windows
static UIAutomation	getInstance() Gets the instance
AutomationApplication	launch(String... command) Launches the application
AutomationApplication	launchOrAttach(String... command) Attaches or launches the application
boolean	supportsAutomation2() Does this automation object support IUIAutomation2 i.e.
boolean	supportsAutomation3() Does this automation object support IUIAutomation3 i.e.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

automation

protected IUIAutomation automation

Constructor Detail

UIAutomation

protected UIAutomation()

Constructor for UIAutomation library

Method Detail

getInstance

public static final UIAutomation getInstance()

Gets the instance

Returns:

the instance of the ui automation library

createCacheRequest

public CacheRequest createCacheRequest()

Create a cache request

Returns:

The created mmarquee.automation.cache request

launch

public AutomationApplication launch(String... command)
                             throws IOException

Launches the application

Parameters:

command - The command to be called

Returns:

AutomationApplication that represents the application

Throws:

IOException - Cannot start application?

attach

public AutomationApplication attach(Process process)

Attaches to the application process

Parameters:

process - Process to attach to

Returns:

AutomationApplication that represents the application

findProcess

public AutomationApplication findProcess(String... command)
                                  throws Exception

Finds the given process

Parameters:

command - Command to look for

Returns:

The Application

Throws:

Exception - If findProcessEntry throws an exception.

launchOrAttach

public AutomationApplication launchOrAttach(String... command)
                                     throws Exception

Attaches or launches the application

Parameters:

command - Command to be started

Returns:

AutomationApplication that represents the application

Throws:

Exception - Unable to find process

getDesktopWindow

public AutomationWindow getDesktopWindow(String title)
                                  throws ElementNotFoundException

Gets the desktop window associated with the title

Parameters:

title - Title to search for

Returns:

AutomationWindow The found window

Throws:

ElementNotFoundException - Element is not found

getDesktopWindows

public List<AutomationWindow> getDesktopWindows()

Gets the list of desktop windows

Returns:

List of desktop windows

supportsAutomation2

public boolean supportsAutomation2()

Does this automation object support IUIAutomation2 i.e. is it Windows 8 or above?

Returns:

supports IUIAutomation2

supportsAutomation3

public boolean supportsAutomation3()

Does this automation object support IUIAutomation3 i.e. is it Windows 8.1 or above?

Returns:

supports IUIAutomation3

captureScreen

public void captureScreen(String filename)
                   throws AWTException,
                          IOException

Captures the screen.

Parameters:

filename - The filename

Throws:

AWTException - Robot exception

IOException - IO Exception

addAutomationEventHandler

public void addAutomationEventHandler(IUIAutomationElement sender,
                                      int eventId,
                                      TreeScope treeScope,
                                      EventHandler eventHandler)

Adds an event handler for the given event.

Parameters:

sender - The sender

eventId - The event id

treeScope - The treescope

eventHandler - The EventHandler to add

CreateAndCondition

public IUIAutomationCondition CreateAndCondition(IUIAutomationCondition condition0,
                                                 IUIAutomationCondition condition1)

Creates the raw and condition

Parameters:

condition0 - First condition

condition1 - Second condition

Returns:

The AndCondition

CreateFalseCondition

public IUIAutomationCondition CreateFalseCondition()

Creates a false Condition

Returns:

The condition

CreateTrueCondition

public IUIAutomationCondition CreateTrueCondition()

Creates a true Condition

Returns:

The condition

CreateOrCondition

public IUIAutomationCondition CreateOrCondition(IUIAutomationCondition condition0,
                                                IUIAutomationCondition condition1)

Getst the raw condition

Returns:

the underlying IUIAutomationCondition

CreatePropertyCondition

public IUIAutomationCondition CreatePropertyCondition(int property,
                                                      Object value)

Creates a property condition

Parameters:

property - The property to check

value - The value of the property

Returns:

The property condition

CreateCacheRequest

public IUIAutomationCacheRequest CreateCacheRequest()