TestComplete ToolBarFunctions
Last Updated:
Actions for working with ToolBar objects.
Toolbars come in many different flavors. The toolbar support defined here is
not going to work for all toolbars in all different environments. The tester
will have to experiment using these commands against their specific toolbar.
TestComplete ToolBarFunctions::ClickButton (deprecated for: ClickButtonText)
Deprecated. Use ClickButtonText instead.
Deprecated. Use ClickButtonText instead.
Fields: [ ]=
Optional with Default Value
-
ButtonTextValue
Case-sensitive text of the toolbar button to select.
Case-sensitive text of the toolbar button to select.
- [ CaseInsensitive = ]
"1", "CaseInsensitive", or "Case-Insensitive" to match button text in a case-insensitive manner.
Examples:
-
T, WINDOW, ToolBar, ClickButton, "AParticularButtonText"
Performs a standard single-click on the "AParticularButtonText" button on the ToolBar object.
Performs a standard single-click on the "AParticularButtonText" button on the ToolBar object.
The routine will also verify that the button is in the clicked or selected state.
-
T, WINDOW, ToolBar, ClickButton, "aparticularbuttontext", CaseInsensitive
Performs a standard single-click on the "AParticularButtonText" button on the ToolBar object.
Performs a standard single-click on the "AParticularButtonText" button on the ToolBar object.
The routine will also verify that the button is in the clicked or selected state.
[How To Read This Reference]
TestComplete ToolBarFunctions::ClickButtonIndex
Click on the icon at a certain position on the ToolBar object, it is 1-based.
Click on the icon at a certain position on the ToolBar object, it is 1-based.
Fields: [ ]=
Optional with Default Value
-
Index
Index described which icon to be clicked in the toolbar.
Index described which icon to be clicked in the toolbar.
RJ Note:
- If the index is bigger than the number of children of toolbar, the last icon will be clicked.
- The tool bar separator is not counted for indexing. If the toolbar contains "button1 | button2", button1 is
at index 1, button2 is at index 2, the separator between these two buttons is not counted.
- [ Coordination = ]
A position within the toolbar button, the mouse will be click there.
RJ Note: This parameter is special for RJ implementation.
Examples:
-
T, WINDOW, ToolBar, ClickButtonIndex, 3
Performs a standard single-click on the third icon on the ToolBar object.
Performs a standard single-click on the third icon on the ToolBar object.
-
T, WINDOW, ToolBar, ClickButtonIndex, 1, "55;8"
Performs a standard single-click on the position (55,8) of the first icon on the ToolBar object.
[How To Read This Reference]
TestComplete ToolBarFunctions::ClickButtonText
Routine to Click on the specified Button.Key (Text) value.
Routine to Click on the specified Button.Key (Text) value.
The user has an optional parameter to specify that the provided
text is case-insensitive. The routine will also verify that the
button is in the clicked or selected state upon completion.
Use ClickUnverifiedButtonText if this post-click verification should
be skipped.
Fields: [ ]=
Optional with Default Value
-
ButtonTextValue
Case-sensitive text of the toolbar button to select.
Case-sensitive text of the toolbar button to select.
RJ Note: This parameter may be a path like "a->b->c"
- [ CaseInsensitive = ]
"1", "CaseInsensitive", or "Case-Insensitive" to match button text in a case-insensitive manner.
- [ Coordination = ]
A position within the toolbar button, the mouse will be click there.
RJ Note: This parameter is special for RJ implementation.
Examples:
-
T, WINDOW, ToolBar, ClickButtonText, "AParticularButtonText"
Performs a standard single-click on the "AParticularButtonText" button on the ToolBar object.
Performs a standard single-click on the "AParticularButtonText" button on the ToolBar object.
The routine will also verify that the button is in the clicked or selected state.
-
T, WINDOW, ToolBar, ClickButtonText, "aparticularbuttontext", CaseInsensitive
Performs a standard single-click on the "AParticularButtonText" button on the ToolBar object.
Performs a standard single-click on the "AParticularButtonText" button on the ToolBar object.
The routine will also verify that the button is in the clicked or selected state.
-
T, WINDOW, ToolBar, ClickButtonText, "parent->child", CaseInsensitive
Performs a standard single-click on the path "parent->child" on the ToolBar object.
Performs a standard single-click on the path "parent->child" on the ToolBar object.
The routine will also verify that the button is in the clicked or selected state.
-
T, WINDOW, ToolBar, ClickButtonText, "AButtonText", , "55;8"
Performs a standard single-click on the position (55,8) of button whose text is "AButtonText" on the ToolBar object.
[How To Read This Reference]
TestComplete ToolBarFunctions::ClickUnverifiedButtonText
Routine to Click on the specified Button.Key (Text) value.
Routine to Click on the specified Button.Key (Text) value.
The user has an optional parameter to specify that the provided
text is case-insensitive. However, not all Toolbars and Buttons will be
able to support this case-insensitive capability.
Fields: [ ]=
Optional with Default Value
-
ButtonTextValue
Case-sensitive text of the toolbar button to select.
Case-sensitive text of the toolbar button to select.
RJ Note: This parameter may be a path like "a->b->c"
- [ CaseInsensitive = ]
"1", "CaseInsensitive", or "Case-Insensitive" to match button text in a case-insensitive manner.
Not all toolbars and buttons will be able to support this case-insensitive option.
- [ Coordination = ]
A position within the toolbar button, the mouse will be click there.
RJ Note: This parameter is special for RJ implementation.
Examples:
-
T, WINDOW, ToolBar, ClickUnverifiedButtonText, "AParticularButtonText"
Performs a standard single-click on the "AParticularButtonText" button on the ToolBar object.
Performs a standard single-click on the "AParticularButtonText" button on the ToolBar object.
-
T, WINDOW, ToolBar, ClickUnverifiedButtonText, "aparticularbuttontext", CaseInsensitive
Performs a standard single-click on the "AParticularButtonText" button on the ToolBar object.
Not all toolbars and buttons will be able to support the case-insensitive option.
-
T, WINDOW, ToolBar, ClickUnverifiedButtonText, "parent->child", CaseInsensitive
Performs a standard single-click on the path "parent->child" on the ToolBar object.
Performs a standard single-click on the path "parent->child" on the ToolBar object.
-
T, WINDOW, ToolBar, ClickUnverifiedButtonText, "AButtonText", , "55;8"
Performs a standard single-click on the position (55,8) of button whose text is "AButtonText" on the ToolBar object.
[How To Read This Reference]