<button-push>

The <button-push> element is used to push, or click, a button on the current screen. The button can be pushed in combination with the Shift, Ctrl, and/or Alt keys when in a <script> context as optional attributes to the element. If the button is disabled when this element is processed a script error is thrown.

In a <field-popup> context the element will push a button on the popup dialog displayed. The contents of the <button-push> element contain the label of the button to be pushed. In this context none of the attributes are supported.

Structure

Contains:
  • In a <script> context any text contents ignored.
  • In a <field-popup> context this element contains text that specifies the button to push in the popup screen. Valid contents include:
    • 0-9
    • +/-
    • . (decimal)
    • “Back,” “Clear,” or “Close”
Contained By:
  • <script>
  • <field-popup>
Attributes - <script> context only
Name Description Data Type Default Value Required
shift This attribute specifies whether the Shift key should be held down in combination with the button push. The value t is true and the shift key will be held down. The value f is false. string f No
ctrl This attribute specifies whether the Ctrl key should be held down in combination with the button push. The value t is true and the Ctrl key will be held down. The value f is false. string f No
alt This attribute specifies whether the Alt key should be held down in combination with the button push. The value t is true and the Alt key will be held down. The value f is false. string f No
check This attribute specifies whether the control should be checked or unchecked. The value t is true and will result in the control being checked. The value f is false. This attribute is valid only for check box controls on built-in client screens. string t No
common button attributes For <button-push> these attributes specify the button to be pushed. 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