check toolbar button exists
Check for the existence of a button on a toolbar.
Name | Description | Type | Modifier |
---|---|---|---|
window | TA name of the window. | Interface Entity | None |
control | TA name of the toolbar control. | Interface Element | None |
button | Button, as identified by its caption or index value. | String | None |
Result is Passed if the specified button is found, otherwise Failed.
This action may be used within the following project items: test modules and user-defined actions.
This action is applicable to the following controls: toolbar.
Example - Case 1: Using a text value for button
interface
use interface Music Library
 
window control button
check toolbar button exists library toolbar Search
check toolbar button exists library toolbar About
check toolbar button exists library toolbar Close
check toolbar button exists library toolbar Show/Hide
Example - Case 2: Using a numerical index value for button
window control button
check toolbar button exists library toolbar 2
check toolbar button exists library toolbar 4
- button argument:
The button may be specified by either of two means: the caption text, or its numerical index (Indexes are one-based. That is, numbering begins at 1).
Restriction:Using numerical index values is not supported for Oracle Forms and Microsoft UI Automation (UIA).- Enclose a numerical text string in quotation marks to differentiate it from a numerical index value. For example, if a text value of an item in a control has a value of
12
, you should reference that item by passing12
surrounded by quotation marks (that is,"12"
) instead of the numerical12
. Passing the numerical12
is treated as a reference to an item with an index of 12, rather than an item holding a text string value of12
.
- This action supports the <ignore> modifier. If the string
<ignore>
is present as the value of any of the arguments, or any argument contains an expression that evaluates to<ignore>
, the action is skipped during execution.