Version

Click(Subitem) Method

Performs a left-mouse click on the specified subitem of this TestObject.
Syntax
'Declaration
 
Public Overloads Overrides Sub Click( _
   ByVal subitem As Rational.Test.Ft.Script.Subitem _
) 
public override void Click( 
   Rational.Test.Ft.Script.Subitem subitem
)

Parameters

subitem
A Name or List object used to identify where the click should occur.
Remarks
The subItem parameter takes one of three types of subItem. These options are listed below.

A Name Subitem. Buttons can be assigned a Key value. If only a Name Subitem is provided the control will search the LeftButtonsCollection first, followed by the RightButtonsCollection. The first button found with a Key that matches the Name Subitem's Name value will be acted against.

A Point Subitem. This will not normally be coded against, but will be recorded against. The Point Subitem is a control relative point.

A List Subitem. A List Subitem can contain other Subitems. This collection of Subitems can be used to act against a particular button in either collection.

Subitems (in order) Description
[Name, Location]

This pairing could be used for a Key based SpinButton button.

The first parameter is a Name Subitem, similar to just passing the Name Subitem alone this will find the first item with a matching Key value.

The second paramerter, a Location Subitem, is used to tell which spin button to activate.

[Location, Position]

This pairing is used during recording. This pattern is used for buttons that are not SpinButtons

The first parameter is a Location Subitem. This designates which button collection should be searched. Legal values are (Left,Right).

The second paramerter, a Position Subitem, is used to tell which button to activate. This value is based the index of the button in the Buttons collection.

[Location, Position, Location]

Similar to the previous entry, this pattern is used during record time. This pattern is used for SpinButtons.

The first parameter is a Location Subitem. This designates which button collection should be searched. Legal values are (Left,Right).

The second parameter, a Position Subitem, is used to tell which button to activate. This value is based the index of the button in the Buttons collection.

The third parameter, a Location Subitem, is used to designate which spin button to activate. Legal values are (SCROLL_UPBUTTON, SCROLL_DOWNBUTTON)

[Location, Index]

This pairing replaces the Position Subitem with an Index. The Index is the Visible index of the button in the collection. This pattern is used for buttons that are not SpinButtons

The first parameter is a Location Subitem. This designates which button collection should be searched. Legal values are (Left,Right).

The second paramerter, an Index Subitem, is used to tell which button to activate. This value is based on the visible index of the button in the Buttons collection.

[Location, Index, Location]

Similar to the previous entry. This pattern is used for SpinButtons.

The first parameter is a Location Subitem. This designates which button collection should be searched. Legal values are (Left,Right).

The second parameter, an Index Subitem, is used to tell which button to activate. This value is based on the visible index of the button in the Buttons collection.

The third parameter, a Location Subitem, is used to designate which spin button to activate. Legal values are (SCROLL_UPBUTTON, SCROLL_DOWNBUTTON)

[Location, Name]

This pairing replaces the Position Subitem with a Name Subitem. The Name is the Key of the button in the collection. This pattern is used for buttons that are not SpinButtons

The first parameter is a Location Subitem. This designates which button collection should be searched. Legal values are (Left,Right).

The second paramerter, an Name Subitem, is used to tell which button to activate. This value is based on the Key of the button in the Buttons collection.

[Location, Name, Location]

Similar to the previous entry. This pattern is used for SpinButtons.

The first parameter is a Location Subitem. This designates which button collection should be searched. Legal values are (Left,Right).

The second parameter, an Key Subitem, is used to tell which button to activate. This value is based on the Key of the button in the Buttons collection.

The third parameter, a Location Subitem, is used to designate which spin button to activate. Legal values are (SCROLL_UPBUTTON, SCROLL_DOWNBUTTON)

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also