iOSObject¶
iOS Object.
Behavior Pattern: iOSObjectGenericBehavior
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 | |
| ChildAt | Child object at index. | GetChildAt | |
| ChildCount | Number of child items. | GetChildCount | |
| Class | Class name of the object. | GetClass | |
| Height | Height of the object. | GetHeight | |
| Label | Label of the iOS object | GetLabel | |
| Name | Name of the object. | GetName | |
| NextSibling | iOSObject for the next sibling element. |
GetNextSibling | |
| ObjectType | Type of the object. | GetObjectType | |
| Parent | iOSObject for the parent element. |
GetParent | |
| PrevSibling | iOSObject for the previous sibling element. |
GetPrevSibling | |
| Property | Value of a named property of the object. | GetProperty | |
| Text | Text of the object, 'false' if text can not be read. | GetText | |
| Width | Width of the object. | GetWidth | |
| 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 | Clicks in the middle of the control. |
| DoClear | Clears the text of the object. |
| DoClick | Clicks in the middle of the control if offset is not specified. |
| DoEnsureVisible | Ensure that a child item with the specified text is visible on screen. |
| DoFindByXPath | Finds an element by relative XPath expression. |
| DoLongPress | Performs long press in the middle of the control if offset is not specified. |
| DoPress | Presses in the middle of the control if offset is not specified. |
| DoSendKeys | Send a text to the object in character-by-character mode. |
| DoTap | Taps the control. |
| DoTwoFingerTap | Taps the control with two fingers. |
Property Detail¶
Bitmap¶
UI Image of the object.
Type: ImageWrapper
Accessors: GetBitmap
value = SeS('SomeiOSObject').GetBitmap()
BWBitmap¶
UI Image of the object in 1-bit format (black&white).
Type: ImageWrapper
Accessors: GetBWBitmap
value = SeS('SomeiOSObject').GetBWBitmap()
ChildAt¶
Child object at index.
Getter Parameters:
| Name | Type | Description |
|---|---|---|
| index | number | Index of the object to get. |
Type: string
Accessors: GetChildAt
value = SeS('SomeiOSObject').GetChildAt(index)
ChildCount¶
Number of child items.
Type: number
Accessors: GetChildCount
value = SeS('SomeiOSObject').GetChildCount()
Class¶
Class name of the object.
Type: string
Accessors: GetClass
value = SeS('SomeiOSObject').GetClass()
Height¶
Height of the object.
Type: number
Accessors: GetHeight
value = SeS('SomeiOSObject').GetHeight()
Label¶
Label of the iOS object
Type: string
Accessors: GetLabel
value = SeS('SomeiOSObject').GetLabel()
Name¶
Name of the object.
Type: string
Accessors: GetName
value = SeS('SomeiOSObject').GetName()
NextSibling¶
iOSObject for the next sibling element. Requires Rapise 6.6+
Type: iOSObject
Accessors: GetNextSibling
value = SeS('SomeiOSObject').GetNextSibling()
ObjectType¶
Type of the object.
Type: string
Accessors: GetObjectType
value = SeS('SomeiOSObject').GetObjectType()
Parent¶
iOSObject for the parent element. Requires Rapise 6.6+
Type: iOSObject
Accessors: GetParent
value = SeS('SomeiOSObject').GetParent()
PrevSibling¶
iOSObject for the previous sibling element. Requires Rapise 6.6+
Type: iOSObject
Accessors: GetPrevSibling
value = SeS('SomeiOSObject').GetPrevSibling()
Property¶
Value of a named property of the object.
Getter Parameters:
| Name | Type | Description |
|---|---|---|
| name | string | Property name. |
Type: string
Accessors: GetProperty
value = SeS('SomeiOSObject').GetProperty(name)
Text¶
Text of the object, 'false' if text can not be read.
Type: string
Accessors: GetText
value = SeS('SomeiOSObject').GetText()
Width¶
Width of the object.
Type: number
Accessors: GetWidth
value = SeS('SomeiOSObject').GetWidth()
X¶
X-coordinate of the top left corner of the object.
Type: number
Accessors: GetX
value = SeS('SomeiOSObject').GetX()
Y¶
Y-coordinate of the top left corner of the object.
Type: number
Accessors: GetY
value = SeS('SomeiOSObject').GetY()
Action Detail¶
DoAction¶
Clicks in the middle of the control.
SeS('SomeiOSObject').DoAction()
Returns:
boolean: 'true' if success, 'false' otherwise.
DoClear¶
Clears the text of the object.
SeS('SomeiOSObject').DoClear()
Returns:
boolean: 'true' if success, 'false' otherwise.
DoClick¶
Clicks in the middle of the control if offset is not specified. Clicking with offset requires Rapise 8.0+.
SeS('SomeiOSObject').DoClick(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 success, 'false' otherwise.
DoEnsureVisible¶
Ensure that a child item with the specified text is visible on screen.
SeS('SomeiOSObject').DoEnsureVisible()
Returns:
boolean: 'true' if success, 'false' otherwise.
DoFindByXPath¶
Finds an element by relative XPath expression. Requires Rapise 6.6+
SeS('SomeiOSObject').DoFindByXPath(xpath)
Parameters:
| Name | Type | Description |
|---|---|---|
| xpath | string | Relative XPath expression. |
Returns:
iOSObject: iOSObject if success, null otherwise.
DoLongPress¶
Performs long press in the middle of the control if offset is not specified. Requires Rapise 8.0+.
SeS('SomeiOSObject').DoLongPress(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 success, 'false' otherwise.
DoPress¶
Presses in the middle of the control if offset is not specified. Requires Rapise 8.0+.
SeS('SomeiOSObject').DoPress(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 | Duration of press action. Optional. |
Returns:
boolean: 'true' if success, 'false' otherwise.
DoSendKeys¶
Send a text to the object in character-by-character mode.
SeS('SomeiOSObject').DoSendKeys(keys)
Parameters:
| Name | Type | Description |
|---|---|---|
| keys | string | Text to type into the object. |
Returns:
boolean: 'true' if success, 'false' otherwise.
DoTap¶
Taps the control.
SeS('SomeiOSObject').DoTap()
Returns:
boolean: 'true' if success, 'false' otherwise.
DoTwoFingerTap¶
Taps the control with two fingers.
SeS('SomeiOSObject').DoTwoFingerTap()
Returns:
boolean: 'true' if success, 'false' otherwise.