ClickItem Action (ComboBox Controls)

Applies to TestComplete 15.70, last modified on December 17, 2024
This method is not supported in web tests (including cross-platform web tests) that use XPath expressions and CSS selectors to locate web elements. This method can be only used in tests that locate web objects by using internal identification properties provided by TestComplete.

Description

The ClickItem action selects the specified control’s item.

Declaration

TestObj.ClickItem(Item)

TestObj A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section
Item [in]    Required    Variant    
Result None

Applies To

The method is applied to the following objects:

AngularUI Bootstrap Dropdown, AngularUI Select, Bootstrap Dropdown and 27 more objects

View Mode

This method is available in the Object Browser panel and in other panels and dialogs in both Basic and Advanced view modes.

Parameters

The method has the following parameter:

Item

Specifies the desired item. You can enter the item’s index (from 0) or its caption. The caption can contain asterisk (*) or question mark (?) wildcards or regular expressions. The asterisk (*) corresponds to a string of any length (including an empty string), the question mark corresponds to any single character (including none). To specify more complicated parts of a caption, use regular expressions.

The caption can be case-sensitive or case-insensitive depending on the value of the Use case-sensitive parameters project setting.

Notes:

  • Win32ComboBox controls: If the Win32ComboBox object has the CBS_OWNERDRAWFIXED or CBS_OWNERDRAWVARIABLE style and does not have the CBS_HASSTRINGS style, the Item parameter should specify the item’s index, not caption. See also OWNERDRAW Controls Support.

  • JComboBox controls: You can select the combo box's item by its caption only if the items were inherited from the JLabel or AbstractButton classes (in most cases they are). Otherwise the captions may be interpreted as empty strings.

  • AngularUI Select controls: You can select item by its caption only if the Select control does not use data binding for its items. Otherwise the captions may be interpreted as empty strings.

Result Value

None.

Remarks

  • If the item is not found, ClickItem fails and posts an error message to the test log.

  • Microsoft Edge:

    • In certain cases, TestComplete can select an item without simulating a click on it.
    • TestComplete can fail to simulate the ClickItem action on jQuery controls.

  • Chrome browser: TestComplete may fail to record the ClickItem method for web controls in Chrome. It will record ordinary coordinate clicks instead. You can replace those clicks with the ClickItem method in your tests manually.

Example

To view an example that demonstrates how to use the ClickItem method, see Selecting Combo Box Items in Desktop Windows Applications.

See Also

wItemCount Property (Combo Box Controls)
wItem Property (ComboBox Controls)

Highlight search results