The <button-expect> element is used to verify the state of a button definition within a screen. This includes the button’s label text, enabled state, checked state, whether or not it is a popup button, and whether or not it is visible. The type of button definition checked by this element will dictate the supported states and other expected values for the button definition.
If any of the configured expected state information is not matched by the button, a script error is thrown.
| Name | Description | Data Type | Default Value | Required |
|---|---|---|---|---|
| enabled | This attribute specifies the expected enabled state of the button. The value t is true, meaning the button is expected to be enabled. The value f is false, meaning the button is expected to be disabled. | string | t | No |
| checked | This attribute specifies the expected checked state of the button, which is either checked or unchecked. The value t is true, meaning the button is expected to checked. The value f is false, meaning the button is expected to not be checked. | string | t | No |
| popup | This attribute specifies whether the button is expected to be an Action Button with a defined action of popup menu. The value t is true, meaning the button is expected to be a popup menu. The value f is false, meaning the button is not expected to be a popup menu. | string | f | No |
| visible | This attribute specifies whether the button is expected to be visible or not. The value t is true, meaning the button is expected to be visible. The value f is false, meaning the button is not expected to be visible. | string | t | No |
| common button attributes | For <button-expect> these attributes specify the expected related items for each attribute. | N/A | N/A | N/A |
| common script attributes | A set of related attributes common to most elements within the Agentry Test Script. | N/A | N/A | N/A |