Skip to content

SimpleGraphics

Graphics control.

Extends SeSSimulatedObject

Behavior Pattern: Win32Generic

Property Summary

Property Description Getter Setter
Bitmap UI Image of the object. GetBitmap
BWBitmap UI Image of the object in 1-bit format (black&white). GetBWBitmap
Class Class of the object. GetClass
Height Height of the object. GetHeight
Name Name of the object. GetName
ObjectType SeSMatcherRule type for this object. GetObjectType
State State of the object. GetState
Value Value of the object. GetValue SetValue
Width Width of the object. GetWidth
WindowText Window text of the object. GetWindowText SetWindowText
X X-coordinate of the top left corner of the object. GetX
Y Y-coordinate of the top left corner of the object. GetY

Action Summary

Action Description
DoAction Performs default action for an object.
DoAnalogPlay Plays analog recording using coordinates relative to this object.
DoClick Performs left click at the center of an object.
DoEnsureVisible Makes sure specified element is visible on the screen.
DoLButtonDown Performs left mouse button down.
DoLButtonUp Performs left mouse button up.
DoLClick Performs a left click at the center of an object or at the specified location.
DoLDClick Performs a left double click at the center of an object or at the specified location.
DoMButtonDown Performs middle mouse button down.
DoMButtonUp Performs middle mouse button up.
DoMClick Performs a middle click at the center of an object or at the specified location.
DoMDClick Performs a middle double click at the center of an object or at the specified location.
DoMouseMove Moves mouse cursor to a location relative to this object position.
DoRButtonDown Performs right mouse button down.
DoRButtonUp Performs right mouse button up.
DoRClick Performs a right click at the center of an object or at the specified location.
DoRDClick Performs a right double click at the center of an object or at the specified location.
DoSendKeys Sends series of keystrokes to an object.
DoSendText Sends text to the active application as is (while SendKeys also supports sending special keys).

Property Detail

Bitmap

UI Image of the object.

Type: ImageWrapper

Accessors: GetBitmap

value = SeS('SomeSimpleGraphics').GetBitmap()

BWBitmap

UI Image of the object in 1-bit format (black&white).

Type: ImageWrapper

Accessors: GetBWBitmap

value = SeS('SomeSimpleGraphics').GetBWBitmap()

Class

Class of the object.

Type: string

Accessors: GetClass

value = SeS('SomeSimpleGraphics').GetClass()

Height

Height of the object.

Type: number

Accessors: GetHeight

value = SeS('SomeSimpleGraphics').GetHeight()

Name

Name of the object.

Type: string

Accessors: GetName

value = SeS('SomeSimpleGraphics').GetName()

ObjectType

SeSMatcherRule type for this object.

Type: string

Accessors: GetObjectType

value = SeS('SomeSimpleGraphics').GetObjectType()

State

State of the object.

Type: string

Accessors: GetState

value = SeS('SomeSimpleGraphics').GetState()

Value

Value of the object.

Type: string

Accessors: GetValue, SetValue

value = SeS('SomeSimpleGraphics').GetValue()

SeS('SomeSimpleGraphics').SetValue(value)

Width

Width of the object.

Type: number

Accessors: GetWidth

value = SeS('SomeSimpleGraphics').GetWidth()

WindowText

Window text of the object.

Type: string

Accessors: GetWindowText, SetWindowText

value = SeS('SomeSimpleGraphics').GetWindowText()

SeS('SomeSimpleGraphics').SetWindowText(value)

X

X-coordinate of the top left corner of the object.

Type: number

Accessors: GetX

value = SeS('SomeSimpleGraphics').GetX()

Y

Y-coordinate of the top left corner of the object.

Type: number

Accessors: GetY

value = SeS('SomeSimpleGraphics').GetY()

Action Detail

DoAction

Performs default action for an object. If the object doesn't have default action then 'LClick' is performed.

SeS('SomeSimpleGraphics').DoAction()

DoAnalogPlay

Plays analog recording using coordinates relative to this object.

SeS('SomeSimpleGraphics').DoAnalogPlay(path, left, top)

Parameters:

Name Type Description
path string Path to analog recording (usually an .arf file).
left number X-coordinate of top-left corner of the analog area, relative to object top-left corner
Optional.
top number Y-coordinate of the top-left corner of the analog area, relative to object top-left corner.
Optional.

DoClick

Performs left click at the center of an object. It is a customizable variant of LClick action.

SeS('SomeSimpleGraphics').DoClick(clickType, xOffset, yOffset)

Parameters:

Name Type Description
clickType string Type of click, can be one of "L" - left click, "LD" - double left click, "R" - right click, "RD" - double right click, "M" - middle click, "MD" - double middle click, "N" - don't click Possible values: "L", "LD", "R", "RD", "M", "MD", "N"
Optional, Default: "L".
xOffset number X offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the width.
Optional.
yOffset number Y offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the height.
Optional.

Returns:

boolean: 'true' if operation is successful, 'false' otherwise

DoEnsureVisible

Makes sure specified element is visible on the screen.

SeS('SomeSimpleGraphics').DoEnsureVisible()

DoLButtonDown

Performs left mouse button down. This method does not change cursor coordinates. Make sure that you use 'DoMouseMove' to position mouse cursor properly before calling this method. Note: This action must be followed by 'DoLButtonUp', otherwise it may lock mouse cursor.

SeS('SomeSimpleGraphics').DoLButtonDown()

DoLButtonUp

Performs left mouse button up. This method does not change cursor coordinates. Make sure that you use 'DoMouseMove' to position mouse cursor properly before calling this method. Note: Use this action after 'DoLButtonDown', otherwise it will have no effect.

SeS('SomeSimpleGraphics').DoLButtonUp()

DoLClick

Performs a left click at the center of an object or at the specified location.

SeS('SomeSimpleGraphics').DoLClick(x, y)

Parameters:

Name Type Description
x number X offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the width.
Optional.
y number Y offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the height.
Optional.

Returns:

boolean: 'true' if operation is successful, 'false' otherwise

DoLDClick

Performs a left double click at the center of an object or at the specified location.

SeS('SomeSimpleGraphics').DoLDClick(x, y)

Parameters:

Name Type Description
x number X offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the width.
Optional.
y number Y offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the height.
Optional.

Returns:

boolean: 'true' if operation is successful, 'false' otherwise

DoMButtonDown

Performs middle mouse button down. This method does not change cursor coordinates. Make sure that you use 'DoMouseMove' to position mouse cursor properly before calling this method. Note: This action must be followed by 'DoMButtonUp', otherwise it may lock mouse cursor.

SeS('SomeSimpleGraphics').DoMButtonDown()

DoMButtonUp

Performs middle mouse button up. This method does not change cursor coordinates. Make sure that you use 'DoMouseMove' to position mouse cursor properly before calling this method. Note: Use this action after 'DoMButtonDown', otherwise it will have no effect.

SeS('SomeSimpleGraphics').DoMButtonUp()

DoMClick

Performs a middle click at the center of an object or at the specified location.

SeS('SomeSimpleGraphics').DoMClick(x, y)

Parameters:

Name Type Description
x number X offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the width.
Optional.
y number Y offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the height.
Optional.

Returns:

boolean: 'true' if operation is successful, 'false' otherwise

DoMDClick

Performs a middle double click at the center of an object or at the specified location.

SeS('SomeSimpleGraphics').DoMDClick(x, y)

Parameters:

Name Type Description
x number X offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the width.
Optional.
y number Y offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the height.
Optional.

Returns:

boolean: 'true' if operation is successful, 'false' otherwise

DoMouseMove

Moves mouse cursor to a location relative to this object position.

SeS('SomeSimpleGraphics').DoMouseMove(x, y, duration)

Parameters:

Name Type Description
x number X offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the width.
Optional.
y number Y offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the height.
Optional.
duration number Mouse move duration (milliseconds). If 0 - do immediate move.
Optional, Default: "0".

DoRButtonDown

Performs right mouse button down. This method does not change cursor coordinates. Make sure that you use 'DoMouseMove' to position mouse cursor properly before calling this method. Note: This action must be followed by 'DoRButtonUp', otherwise it may lock mouse cursor.

SeS('SomeSimpleGraphics').DoRButtonDown()

DoRButtonUp

Performs right mouse button up. This method does not change cursor coordinates. Make sure that you use 'DoMouseMove' to position mouse cursor properly before calling this method. Note: Use this action after 'DoRButtonDown', otherwise it will have no effect.

SeS('SomeSimpleGraphics').DoRButtonUp()

DoRClick

Performs a right click at the center of an object or at the specified location.

SeS('SomeSimpleGraphics').DoRClick(x, y)

Parameters:

Name Type Description
x number X offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the width.
Optional.
y number Y offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the height.
Optional.

Returns:

boolean: 'true' if operation is successful, 'false' otherwise

DoRDClick

Performs a right double click at the center of an object or at the specified location.

SeS('SomeSimpleGraphics').DoRDClick(x, y)

Parameters:

Name Type Description
x number X offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the width.
Optional.
y number Y offset to click within object. Calculated from the top-left corner. Default is a center. Floating point in the range (-2, 2) means percentage of the height.
Optional.

Returns:

boolean: 'true' if operation is successful, 'false' otherwise

DoSendKeys

Sends series of keystrokes to an object. For example: DoSendKeys('^F') - sends {CTRL} + {F}. See MSDN Article for SendKeys

SeS('SomeSimpleGraphics').DoSendKeys(keys)

Parameters:

Name Type Description
keys string A sequence of keystrokes.

DoSendText

Sends text to the active application as is (while SendKeys also supports sending special keys).

SeS('SomeSimpleGraphics').DoSendText(text)

Parameters:

Name Type Description
text string A sequence of keystrokes.