Object Model Reference for GUI Testing > UI Automation > Activate Method

UIAObject Object

Description

An object in an application that supports UIAutomation.

Operations

The sections below list the built-in methods and properties that you can use as operations for the UIAButton object.

Note: You can also view a list and descriptions of the UIAObject description properties, for use in object repository descriptions, programmatic descriptions, checkpoint and output value steps, and as argument values for the GetTOProperty and GetROProperty methods.

Methods

Common Methods and Properties

Activate Double-clicks the object to activate it.
Common Method CaptureBitmap Saves a screen capture of the object as a .png or .bmp image, depending on the specified file extension.
Common Method Check Checks whether the actual value of an item matches the expected value.
Common Method CheckProperty Checks whether the specified object property achieves the specified value within the specified timeout.
Common Method ChildObjects Returns the collection of child objects contained within the object.
Click Clicks the object.
Method Drag Performs the 'drag' part of a drag and drop operation.
Method Drop Performs the 'drop' part of a drag and drop operation.
Common Method GetROProperty Returns the current value of the specified description properties from the object in the application.
Common Method GetTOProperties Returns the collection of properties and values used to identify the object.
Common Method GetTOProperty Returns the value of the specified description properties from the test object description.
GetVisibleText Returns the text from the specified area.
Common Method Output Retrieves the current value of an item and stores it in a specified location.
Common Method RefreshObject Instructs UFT to re-identify the object in the application the next time a step refers to this object.
SetFocus Activates the selected object and brings it into focus.
Common Method SetTOProperty Sets the value of the specified description properties in the test object description.
Common Method ToString Returns a string that represents the current test object.
Type Simulates keyboard input on the object.
Common Method WaitProperty Waits until the specified object property achieves the specified value or exceeds the specified timeout before continuing to the next step.

Properties

Common Property Exist Checks whether the object currently exists in the open application.
Common Property Object Accesses the native methods and properties of the object.

UIAutomation Pattern-Based Methods and Properties

Note: The methods in this table are sorted by supported pattern name, not alphabetically.

Method Supported Pattern (A-Z) Description
CanExpand ExpandCollapse Indicates whether an object can expand or not.
Collapse ExpandCollapse Collapses the specified item.
Expand ExpandCollapse Expands the selected item.
IsExpanded ExpandCollapse Indicates whether an object is expanded or not.
ActivateCell Grid Makes a selected cell active by clicking in it.
AddCellToSelection Grid Selects a cell in addition to previously selected cells.
AddRowToSelection Grid

Selects a row and adds it to previously selected rows.

ClickCell Grid Clicks a specific cell in the object.
ClickRow Grid Clicks a specific row in the object.
Common Property GetCellName Grid Returns the value of the name property for the specified cell.
Common Property GetCellValue Grid Returns the value of the value property for the specified cell.
GetRows Grid

Returns a list of all the rows in the object.

RemoveCellFromSelection Grid Removes a selected cell from the list of selected cell (while keeping other cells selected).
RemoveRowFromSelection Grid Removes a row from the list of selected rows(while keeping other rows selected).
SelectRow Grid Selects a row in the table.
Click Invoke Clicks a clickable point in the application.
CanDecrement RangeValue Indicates whether the current value is the minimum.
CanIncrement RangeValue Indicates whether the current value is the maximum.
Decrement RangeValue Lowers the value of the item in the specified object by one step.
Increment RangeValue Raises the value of the item in the specified object by one step.
IsReadOnly RangeValue Indicates whether the object is read-only.
LargeChange RangeValue Indicates whether the change was a large change or not.
Maximum RangeValue Indicates the maximum value of the object.
Minimum RangeValue Indicates the minimum value of the object.
SmallChange RangeValue Indicates whether the change was a small change or not.
SetValue RangeValue
Value
Sets the value of the object.
Value RangeValue The value of the object.
HorizontalScrollPercent Scroll Specifies the amount of horizontal scroll percent.
HorizontallyScrollable Scroll Specifies whether the object is scrollable in the horizontal direction.
HorizontalViewSize Scroll Specifies the amount of viewable space horizonatally.
Scroll Scroll

Scrolls the item in the specified direction for the given distance.

ScrollDown Scroll Scrolls the item downward.
ScrollRight Scroll Scrolls the object right.
ScrollUp Scroll Scrolls the object upwards.
ScrollLeft Scroll Scrolls the item left.
SetScrollPercent Scroll

Sets the percentage by which you should scroll the object.

VerticalScrollPercent Scroll Specifies the amount of vertical scroll percent.
VerticallyScrollable Scroll Specifies whether the object is scrollable in the vertical direction.
VerticalViewSize Scroll Specifies the amount of viewable space vertically.
ScrollIntoView ScrollItem Scrolls the specified object to be visible.
AddToSelection Selection Adds the selected item to the group of previously selected set of items.
GetSelection Selection Returns the collection of selected items.
RemoveFromSelection Selection Removes an item from the set of selected items.
Select Selection Selects one item from the object.
AddToSelection SelectionItem

Selects a cell in addition to previously selected cells.

IsSelected SelectionItem Indicates whether an object is selected or not.
RemoveFromSelection SelectionItem

Removes an item from the set of selected items.

Select SelectionItem Selects one item from the object.
ColumnHeaders Table Returns a list of all column headers in the object.
GetColumnHeaders Table Returns a list of all the column headers in the object.
GetRowHeaders Table Returns a list of all the row headers in the object.
RowHeaders Table Returns a list of all row headers in the object.
RowOrColumnMajor Table Indicates whether the data in the object should be read primarily by row or column.
GetColumnHeaderItems TableItem Returns a list of all the column headers in the object.
GetRowHeaderItems TableItem Returns a list of all the row headers in the object.
GetText Text Retrieves the text of the object.
Text Text The text in the object.
Set Toggle Sets the state of the object.
State Toggle Returns the toggle state of the object.
Move Transform Moves the object.
Resize Transform Resizes the object.
Rotate Transform

Rotates the object.

IsReadOnly Value Indicates if the object is read-only or not.
SetValue Value Sets the value of the control.
Value Value The value of the object.
Close Window Closes the object.
IsMaximized Window Indicates whether the object is maximized at present.
IsMinimized Window Indicates whether the object is minimized at present.
IsReadyForInteraction Window Indicates whether the object is ready for use.
Maximize Window Enlarges the object to its maximum size.
Minimize Window Minimizes the object.
Restore Window Displays the object in its previous position.

Back to top

Activate Method

Description

Double-clicks the object to activate it.

Syntax

object.Activate [x],[y]

Arguments

Parameter Description
x

Optional. A long integer value.

The x-coordinate of the click.

y

Optional. A long integer value.

The y-coordinate of the click.

Return Type

None


Back to top

Click Method

Description

Clicks the object.

Syntax

object.Click [x],[y], [button]

Arguments

Parameter Description
x

Optional. A long integer value.

The x-coordinate of the click.

y

Optional. A long integer value.

The y-coordinate of the click.

button

Optional. A predefined constant or number.

The mouse button used to perform the click.

Return Type

None

Example


Back to top

Drag Method

Description

Performs the 'drag' part of a drag and drop operation.

Syntax

object.Drag [X], [Y], [BUTTON]

Arguments

Parameter Description
X Optional. An integer value.
The x-coordinate within the window from which the object is dragged. Note that the specified coordinates are relative to the upper left corner of the object.
Y Optional. An integer value.
The y-coordinate within the window from which the object is dragged. Note that the specified coordinates are relative to the upper left corner of the object.
BUTTON Optional. A predefined constant or number.
The mouse button used to drag the object.
Default value = micLeftBtn

Return Type

None

Examples


Back to top

Drop Method

Description

Performs the 'drop' part of a drag and drop operation.

Syntax

object.Drop [X], [Y], [BUTTON]

Arguments

Parameter Description
X Optional. An integer value.
The x-coordinate of the object onto which the object is dropped. Note that the specified coordinates are relative to the upper left corner of the object.
Y Optional. An integer value.
The y-coordinate of the object onto which the object is dropped. Note that the specified coordinates are relative to the upper left corner of the object.
BUTTON Optional. A predefined constant or number.
The mouse button that is released to drop the object.
Default value = micLeftBtn

Return Type

None

Examples


Back to top

GetVisibleText Method

Description

Returns the text from the specified area.

Syntax

object.GetVisibleText [left], [top], [right], [bottom]

Arguments

Parameter Description
left

Optional. A long integer value.

The coordinate for the left side of the area from which to select the text.

top

Optional. A long integer value.

The coordinate for the top side of the area from which to select the text.

right

Optional. A long integer value.

The coordinate for the right side of the area from which to select the text.

bottom

Optional. A long integer value.

The coordinate for the bottom side of the area from which to select the text.

Return Type

The text of the object in the specified area.


Back to top

SetFocus Method

Description

Activates the selected object and brings it into focus.

Syntax

object.SetFocus

Return Type

None


Back to top

Type Method

Description

Simulates keyboard input on the object.

Syntax

object.Type string

Arguments

Parameter Description
string

Required. A string.

The characters to enter in the object.

Return Type

None


Back to top

ActivateCell Method

Description

Makes a selected cell active by clicking in it.

Syntax

object.ActivateCell rowIdx, columnIdx, [x, y]

Arguments

Parameter Description
rowIdx

Required. An integer.

The row in which the cell to select is found.

colIdx

Required. A variant.

The column to select. You can specify the column name or the index of the column.

Note: Using the column name for this argument is supported only if the Table pattern is implemented for the control.

x

Optional. An integer.

The x-coordinate of the cell to activate.

y

Optional. An integer.

The y-coordinate of the cell to activate.

Return Type

None

IMPORTANT

This method is available only if you implement the Grid pattern in an object in your application.


Back to top

AddCellToSelection Method (Selection Pattern)

Description

Selects a cell in addition to previously selected cells.

Syntax

object.AddToSelection rowIdx, columnIdx

Arguments

Parameter Description
rowIdx

Required. An integer.

The row in which the cell to select is found.

colIdx

Required. A variant.

The column to select. You can specify the column name or the index of the column.

Note: Using the column name for this argument is supported only if the Table pattern is implemented for the control.

Return Type

None

IMPORTANT

This method is available only if you implement the Grid pattern in an object in your application.


Back to top

AddRowToSelection Method

Description

Selects a row and adds it to previously selected rows.

Syntax

object.AddToSelection rowIdx

Arguments

Parameter Description
rowIdx

Required. An integer.

The row in which the cell to select is found.

Return Type

None

IMPORTANT

This method is available only if you implement the Grid pattern in an object in your application.


Back to top

AddToSelection Method

Description

Adds the selected item to the group of previously selected set of items.

Syntax

object.AddToSelection Item

Arguments

Parameter Description
Item

Required. A string

The item to select.

Return Type

None

IMPORTANT

This method is available only if you implement the Selection pattern in an object in your application.

Example


Back to top

AddToSelection Method (SelectionItem Pattern)

Description

Adds the selected item to the group of previously selected set of items.

Syntax

object.AddToSelection

Return Type

None

IMPORTANT

This method is available only if you implement the SelectionItem pattern in an object in your application.


Back to top

CanExpand Property

Description

Indicates whether an object can expand or not.

Syntax

object.CanExpand

Return Type

A string indicating whether the object can be expanded

IMPORTANT

This method is available only if you implement the Expand/Collapse pattern in an object in your application.


Back to top

CanDecrement Property

Description

Checks whether the current value is the minimum or not.

Syntax

object.CanDecrement

Return Type

A string indicating whether the value is the minimum or not..

IMPORTANT

This property is available only if you implement the RangeValue pattern in an object in your application.


Back to top

CanIncrement Property

Description

Checks whether the current value is the maximum

Syntax

object.CanIncrement

Return Type

A string indicating whether the current value is the maximum or not.

IMPORTANT

This property is available only if you implement the RangeValue pattern in an object in your application.


Back to top

ClickCell Method

Description

Clicks a specific cell in the object.

Syntax

object.ClickCell rowIdx,colIdx, [x, y]

Arguments

Parameter Description
rowIdx

Required. An integer.

The row in which the cell to select is found.

colIdx

Required. A variant.

The column to select. You can specify the column name or the index of the column.

Note: Using the column name for this argument is supported only if the Table pattern is implemented for the control.

x

Required. An integer.

The x-coordinate of the click.

y

Required. An integer.

The y-coordinate of the click.

Return Type

None

IMPORTANT

This method is available only if you implement the Grid pattern in an object in your application.


Back to top

ClickRow Method

Description

Clicks a specific row in the object.

Syntax

object.ClickCell rowIdx, [x, y]

Arguments

Parameter Description
rowIdx

Required. An integer.

The row in which the cell to select is found.

x

Required. An integer.

The x-coordinate of the click.

y

Required. An integer.

The y-coordinate of the click.

Return Type

None

IMPORTANT

This method is available only if you implement the Grid pattern in an object in your application.


Back to top

Close Method

Description

Closes the object.

Syntax

object.Close

Return Type

None

IMPORTANT

This method is available only if you implement the Window pattern in an object in your application.


Back to top

Click Method

Description

Clicks a clickable point in the application.

Syntax

object.Click [x, y, button]

Arguments

Parameter Description
x

Required. An integer.

The x-coordinate of the click.

y

Required. An integer.

The y-coordinate of the click.

Button

The mouse button used to make the click.

Possible values include:

  • L = left button
  • R = right button
  • M = middle button
  • 0 = left button
  • 1 = right button
  • 2 = middle button

Return Type

None

IMPORTANT

This method is available only if you implement the Invoke pattern in an object in your application.

Example


Back to top

Collapse Method

Description

Collapses the specified item.

Syntax

object.Collapse Item

Arguments

Parameter Description
Item

Required. A variant.

The name of the tree node. The node value (with quotes) or numeric index (without quotes) can denote the node. The first node in a tree is numbered 0. You must specify the full path to the tree node, using ; as the separator to indicate the node hierarchy.

Return Type

None

IMPORTANT

Example


Back to top

ColumnHeaders Property

Description

Returns a list of column headers in the object.

Syntax

object.ColumnHeaders

Return Type

A string with the column headers, separated by semicolons (;).

IMPORTANT

This method is available only if you implement the Table pattern in an object in your application.


Back to top

Decrement Method

Description

Lowers the value of the item in the specified object by one step.

Syntax

object.Decrement

Return Type

None

IMPORTANT

This method is available only if you implement the RangeValue pattern in an object in your application.


Back to top

Expand Method

Description

Expands the selected item.

Syntax

object.Expand Item

Arguments

Parameter Description
Item

Required. A variant.

The name of the tree node. The node value (with quotes) or numeric index (without quotes) can denote the node. The first node in a tree is numbered 0. You must specify the full path to the tree node, using ; as the separator to indicate the node hierarchy.

Return Type

None

IMPORTANT

Example


Back to top

GetColumnHeaders Method

Description

Returns a list of all the column headers in the object.

Syntax

object.GetColumnHeaders

Return Type

A list of all column header names in the object.

IMPORTANT

This method is available only if you implement the Table pattern in an object in your application.


Back to top

GetColumnHeaderItems Method

Description

Returns a list of all the column headers in the object.

Syntax

object.GetColumnHeaderItems

Return Type

A list of all column header names in the object.

IMPORTANT

This method is available only if you implement the TableItem pattern in an object in your application.


Back to top

GetRows Method

Description

Returns a list of all the rows in the object.

Syntax

object.GetRows

Return Type

An array of all rows in the object.

IMPORTANT

This method is available only if you implement the Grid pattern in an object in your application.


Back to top

GetRowHeaders Method

Description

Returns a list of all the row headers in the object.

Syntax

object.GetRowHeaders

Return Type

A list of all row header names in the object.

IMPORTANT

This method is available only if you implement the Table pattern in an object in your application.


Back to top

GetRowHeaderItems Method

Description

Returns a list of all the row headers in the object.

Syntax

object.GetRowHeaderItems

Return Type

A list of all row header names in the object.

IMPORTANT

This method is available only if you implement the TableItem pattern in an object in your application.


Back to top

GetSelection Method

Description

Returns the collection of selected items.

Syntax

object.GetSelection

Return Type

A list of selected items.

IMPORTANT

This method is available only if you implement the Selection pattern in an object in your application.


Back to top

GetText Method

Description

Retrieves the text of the object.

Syntax

object.GetText

Return Type

String with the text of an object.

IMPORTANT

This method is available only if you implement the Text pattern in an object in your application.


Back to top

HorizontalScroll Percent

Description

Specifies the amount of horizontal scroll percent.

Syntax

object.HorizontalScrollPercent

Return Type

An integer indicating the percent.

IMPORTANT

This property is available only if you implement the Scroll pattern in an object in your application.


Back to top

HorizontallyScrollable Property

Description

Specfies whether an object is scrollable in the horizontal direction.

Syntax

object.HorizontallyScroolable

Return Type

A string indicating if the object is scrollable or not.

IMPORTANT

This property is available only if you implement the Scroll pattern in an object in your application.


Back to top

HorizontalViewSize Property

Description

Specifies the amount of viewable space horizon

Syntax

object.HorizontalViewSize

Return Type

An integer specifying the amount of viewable size horizontally.

IMPORTANT

This method is available only if you implement the Scroll pattern in an object in your application.


Back to top

Increment Method

Description

Raises the value of the item in the specified object by one step.

Syntax

object.Increment

Return Type

None

IMPORTANT

This method is available only if you implement the RangeValue pattern in an object in your application.


Back to top

IsExpanded Property

Description

Indicates whether an object is expanded or not.

Syntax

object.IsExpanded

Return Type

A string indicating whether the object is expanded

IMPORTANT

This method is available only if you implement the Expand/Collapse pattern in an object in your application.


Back to top

IsMaximized Property

Description

Indicates whether the object is maximized at present.

Syntax

object.IsMaximized

Return Type

A string indicating if the object is maximized.

IMPORTANT

This property is available only if you implement the Window pattern in an object in your application.


Back to top

IsMinimized Property

Description

Indicates whether the object is minimized at present.

Syntax

object.IsMinimized

Return Type

A string indicating whether the object is minimized.

IMPORTANT

This property is available only if you implement the Window pattern in an object in your application.


Back to top

IsReadOnly Property

Description

Indicates whether the object is readonly or not.

Syntax

object.IsReadOnly

Return Type

A string indicating if the object is read-only.

IMPORTANT

This property is available only if you implement the Value pattern in an object in your application.


Back to top

IsReadyForInteraction Property

Description

Indicates whether the object is ready for use.

Syntax

object.IsReadyForInteraction

Return Type

A string indicating whether the object is ready.

IMPORTANT

This property is available only if you implement the Window pattern in an object in your application.


Back to top

IsSelected Property

Description

Indicates whether an object is selected or not.

Syntax

object.IsSelected

Return Type

A string indicating if the object is selected or not..

IMPORTANT

This method is available only if you implement the SelectionItem pattern in an object in your application.


Back to top

Maximize Method

Description

Enlarges the object to its maximum size.

Syntax

object.Maximize

Return Type

None

IMPORTANT

This method is available only if you implement the Window pattern in an object in your application.

Example


Back to top

LargeChange Property

Description

Indicates whether the change was a large change or not.

Syntax

object.LargeChange

Return Type

A string indicating if the change was large

IMPORTANT

This property is available only if you implement the LargeChange pattern in an object in your application.


Back to top

Maximum Property

Description

The maximum value of the object

Syntax

object.Maximum

Return Type

A string containing the maximum value.

IMPORTANT

This property is available only if you implement the RangeValue pattern in an object in your application.


Back to top

Minimum Property

Description

The minimum value of the object.

Syntax

object.Minimum

Return Type

A string containing the minimum value.

IMPORTANT

This property is available only if you implement the RangeValue pattern in an object in your application.


Back to top

Minimize Method

Description

Minimizes the object.

Syntax

object.Minimize

Return Type

None

IMPORTANT

This method is available only if you implement the Window pattern in an object in your application.

Example


Back to top

Move Method

Description

Moves the object.

Syntax

object.Move x, y

Arguments

Parameter Description
x

Required. A variant.

The x-coordinate to which to move the object.

y

Required. A variant.

The y-coordinate to which to move the object.

Return Type

None

IMPORTANT

Example


Back to top

ReadOnly Property

Description

Indicates whether the object is readonly or not.

Syntax

object.ReadOnly

Return Type

A string indicating if the object is read-only.

IMPORTANT

This method is available only if you implement the RangeValue pattern in an object in your application.


Back to top

RemoveFromSelection Method (Selection Pattern)

Description

Removes an item from the set of selected items.

Syntax

object.RemoveFromSelection Item

Arguments

Parameter Description
Item

Required. A string

The item for which to clear a selection.

Return Type

None

IMPORTANT

This method is available only if you implement the Selection pattern in an object in your application.


Back to top

RemoveFromSelection Method (SelectionItem Pattern)

Description

Removes an item from the set of selected items.

Syntax

object.RemoveFromSelection Item

Arguments

Parameter Description
Item

Required. A string

The item for which to clear a selection.

Return Type

None

IMPORTANT

This method is available only if you implement the SelectionItem pattern in an object in your application.


Back to top

RemoveCellFromSelection Method

Description

Removes a selected cell from the list of selected cell (while keeping other cells selected).

Syntax

object.RemoveCellFromSelection rowIdx, colIdx

Arguments

Parameter Description
rowIdx

Required. An integer.

The row in which the cell to remove is located.

colIdx

Required. A variant.

The column to select. You can specify the column name or the index of the column.

Note: Using the column name for this argument is supported only if the Table pattern is implemented for the control.

Return Type

None

IMPORTANT

This method is available only if you implement the Grid pattern in an object in your application.


Back to top

RemoveRowFromSelection Method

Description

Removes a row from the list of selected rows(while keeping other rows selected).

Syntax

object.RemoveRowFromSelection rowIdx

Arguments

Parameter Description
rowIdx

Required. An integer.

The row in which the cell to remove is located.

Return Type

None

IMPORTANT

This method is available only if you implement the Grid pattern in an object in your application.


Back to top

Resize Method

Description

Resizes the object.

Syntax

object.Resize width, height

Arguments

Parameter Description
width

Required. An integer.

The width to which to resize the object, in pixels.

height

Required. An integer.

The height to which to resize the object, in pixels.

Return Type

None

IMPORTANT

Example


Back to top

Restore Method

Description

Displays the object in its previous position.

Syntax

object.Restore

Return Type

None

IMPORTANT

This method is available only if you implement the Window pattern in an object in your application.

Example


Back to top

Rotate Method

Description

Rotates the object.

Syntax

object.Rotate degrees

Arguments

Parameter Description
degrees

Required. An integer.

The number of degrees to which to rotate the object. A positive number rotates clockwise; a negative number rotates counterclockwise.

Return Type

None

IMPORTANT


Back to top

RowHeaders Property

Description

Returns a list of all row headers in the object.

Syntax

object.RowHeaders

Return Type

A string containing all the headers in the object, separated by semicolons (;)

IMPORTANT

This method is available only if you implement the Table pattern in an object in your application.


Back to top

RowOrColumnMajor Property

Description

Indicates whether the data in the object should be read primarily by row or column.

Syntax

object.RowOrColumnMajor

Return Type

A string indicating which way to read the data.

IMPORTANT

This method is available only if you implement the Table pattern in an object in your application.


Back to top

Scroll Method

Description

Scrolls the item in the specified direction for the given distance.

Syntax

object.Scroll horiztonalAmount, [verticalAmount]

Arguments

Parameter Description
horizontalAmount

Required. An integer.

The horizontal distance to scroll the object. You can supply one of the following values:

  • 0 = move the scroll bar left in large amounts
  • 1 = scroll the scroll bar left in small amounts
  • 2 = no scroll
  • 3 = move the scroll bar right in large amounts
  • 4 = move the scroll bar right in small amounts
verticalAmount

Optional. An integer.

The vertical distance to scroll the object. You can supply one of the following values:

  • 0 = scroll right in large amounts
  • 1 = scroll upwards in small amounts
  • 2 = no scroll
  • 3 = scroll downwards in large amounts
  • 4 = scroll downwards in small amounts

Return Type

None

IMPORTANT

This method is available only if you implement the Scroll pattern in an object in your application.


Back to top

ScrollDown Method

Description

Scrolls the item downward.

Syntax

object.ScrollDown

Return Type

None

IMPORTANT

This method is available only if you implement the Scroll pattern in an object in your application.


Back to top

ScrollLeft Method

Description

Scrolls the item left.

Syntax

object.ScrollLeft

Return Type

None

IMPORTANT

This method is available only if you implement the Scroll pattern in an object in your application.


Back to top

ScrollRight Method

Description

Scrolls the object right.

Syntax

object.ScrollRight

Return Type

None

IMPORTANT

This method is available only if you implement the Scroll pattern in an object in your application.


Back to top

ScrollUp Method

Description

Scrolls the object upwards.

Syntax

object.ScrollUp

Return Type

None

IMPORTANT

This method is available only if you implement the Scroll pattern in an object in your application.


Back to top

ScrollIntoView Method

Description

Scrolls the specified object to be visible.

Syntax

object.ScrollIntoView

Return Type

None

IMPORTANT

This method is available only if you implement the ScrollItem pattern in an object in your application.


Back to top

Select Method

Description

Selects one item from the object.

Syntax

object.Select Item

Arguments

Parameter Description
Item

Required. A variant

The item to select.

Return Type

None

IMPORTANT


Back to top

SelectCell Method

Description

Selects a specific cell in the object.

Syntax

object.SelectCell rowIdx, colIdx

Arguments

Parameter Description
rowIdx

Required. A integer.

The row to select.

colIdx

Required. A variant.

The column to select. You can specify the column name or the index of the column.

Note: Using the column name for this argument is supported only if the Table pattern is implemented for the control.

Return Type

None

IMPORTANT

This method is available only if you implement the Grid pattern in an object in your application.


Back to top

SelectRow Method

Description

Selects a row in the table.

Syntax

object.SelectRow rowIdx

Arguments

Parameter Description
rowIdx

Required. A integer.

The row to select.

Return Type

None

IMPORTANT

This method is available only if you implement the Grid pattern in an object in your application.


Back to top

Set Method

Description

Sets the state of the object.

Syntax

object.Set State

Arguments

Parameter Description
state

Required. A variant

The state of the object. The value can be a string or a numeric value:

  • On
  • Off
  • Indeterminate
  • 0 (Off)
  • 1 (On)
  • 2 (Indeterminate)

Return Type

None

IMPORTANT

This method is available only if you implement the Toggle pattern in an object in your application.

Example


Back to top

SetValue Method

Description

Sets the value of the object.

Syntax

object.SetValue Value

Arguments

Parameter Description
state

Required. A string

The state to set in the object.

Return Type

None

IMPORTANT

This method is available only if you implement the RangeValue pattern in an object in your application.


Back to top

SetScrollPercent Method

Description

Sets the horizontal and vertical scroll position as a percentage of the total content area within the control.

Syntax

object.SetScrollPercent horizontalPercent, verticalPercent

Arguments

Parameter Description
horizontalPercent

Required. An integer.

The percent by which to scroll the object horizontally.

verticalPercent

Required. An integer.

The percent by which to scroll the object vertically.

Return Type

None

IMPORTANT


Back to top

SetValue Method

Description

Sets the value of the control.

Syntax

object.SetValue Value

Arguments

Parameter Description
value

Required. A string..

The value to set in the object.

Return Type

None


Back to top

SmallChange Property

Description

Indicates whether a change is a small change or not.

Syntax

object.SmallChange

Return Type

A string indicating if the change was small.

IMPORTANT

This property is available only if you implement the RangeValue pattern in an object in your application.


Back to top

State Property

Description

Returns the toggle state of the object.

Syntax

object.State

Return Type

A string indicating the toggle state of the object.

Possible values:

IMPORTANT

This method is available only if you implement the Toggle pattern in an object in your application.


Back to top

Text Property

Description

The text in the object.

Syntax

object.Text

Return Type

A string containing the object's text.

IMPORTANT

This property is available only if you implement the Text pattern in an object in your application.


Back to top

Value Property

Description

The value of the object.

Syntax

object.Value

Return Type

A string containing the object's value.

IMPORTANT

This property is available only if you implement the RangeValue or Value pattern in an object in your application.


Back to top

VerticalScrollPercent Property

Description

Specifies the amount of vertical scroll percent

Syntax

object.VerticalScrollPercent

Return Type

A integer indicating the amount of vertical scroll percent

IMPORTANT

This method is available only if you implement the Scroll pattern in an object in your application.


Back to top

VerticallyScrollable Property

Description

Indicates whether the object is scrollable in the vertical direction

Syntax

object.VerticallyScrollable

Return Type

A string indicating if you can scroll the object vertically or not.

IMPORTANT

This method is available only if you implement the Scroll pattern in an object in your application.


Back to top

VerticalViewSize Property

Description

Specifies the amount of viewable space vertically.

Syntax

object.VerticalViewSize

Return Type

An integer indicating the amount of viewable size vertically.

IMPORTANT

This method is available only if you implement the Scroll pattern in an object in your application.

Back to top

See also: