Button control

The Button control is a coach view that creates a button instance.

When users view a Button instance, they see its label on a background color.

The button also includes an icon if one has been specified using the Icon configuration property. On most browsers, the background color is a gradient. However, in Microsoft Internet Explorer 9, the background color is solid. This difference does not affect the functionality.

Data binding

Set the data binding for the control in the General properties tab.

Table 1. Button control data binding
Binding description	Data type
Records whether the user clicks the button instance.	`Boolean`

Configuration properties

Set or modify control configuration in the Configuration properties tab.

Configuration properties that have the screen sizes icon can have different values for each screen size. If you do not set a value, the screen size inherits the value of the next larger screen size as its default value. If you are using the Process Designer desktop editor, you are setting the value for the large screen size. The other screen sizes inherit this value.

Table 2. Button control configuration properties
Configuration property	Description	Data type
Icon	The URL of the icon file or the path to the managed icon file. The button displays the image at full size. Changing the height and width of the button in its Positioning properties does not affect the image size. Because the button does not resize the image, use an appropriately sized image for the button. If you want to use a larger image, use the Image control instead and set the control instance to fire a boundary event when users select it. The default value is no URL.	`URL`
Icon description	A description of the icon that makes it accessible for users and technologies that cannot see the icon.	`String`
Allow multiple clicks	Select this option if the user can repeat the button action, such as adding something for each click. Do not select this option if the event is to occur only once, such as a bill payment confirmation. The default value is `False` (not selected)	`Boolean`