This is an old revision of the document!
Table of Contents
PushButton
com.ergotech.vib.graphics.PushButton
Image Examples
 |  |
| PushButton in the graphics palette. | PushButton graphic example. |
Overview
The PushButton graphic is an Active Control based on the Button graphic.
A PushButton is used to send an output value when the user interacts with it. It is visually different from a regular Button because it can appear pressed when it is in the on state.
PushButton shares many common properties with other button-style controls. See Button-Style Control Common Properties for shared label, color, image, value, bezel, quality indicator, enabled, rotation, and visibility properties.
Common Uses
- Creating a button-style control
- Sending a boolean-style value
- Triggering application logic
- Showing a pressed or unpressed button state
- Displaying different labels or images for on and off states
Input Behavior
The PushButton has the regular input behavior of an Active Control.
The PushButton display can be updated from an input connection. This can be useful when the PushButton needs to show a state from another source.
Output Behavior
The PushButton sends an output value when its state changes.
In a typical on/off setup, the off state sends the configured Value for Off, and the on state sends the configured Value for On.
By default, these values are commonly set to 0 for off and 1 for on.
Difference From Button
PushButton shares many properties with Button.
The main difference is visual behavior. When PushButton is in the on state, it appears pressed in.
Notes
For shared active control behavior, see Active Control Common Properties.
For shared Button, PushButton, and URLButton settings, see Button-Style Control Common Properties.
For the similar regular Button graphic, see Button.