The ButtonField class provides an area on the form that the end user can click to initiate an action. The field is highlighted when the user clicks it, and the action occurs when the user releases the mouse button while the mouse is still positioned in the button field area.

Unless the field is associated with a default button, there is no toolkit control or widget associated with the field. The field always displays as the bottom of the stack field unless it is being clicked. While clicked, the button appears at the top of the frame stack. This behavior can be changed by setting the RequireRealField attribute that associates a toolkit control or widget with the field.

The variable for a button field must be of type integer. In conjunction with the field function, this variable serves as a means to access and change the display attributes of the button. For the ToggleField class, a subclass of ButtonField, the value of the variable represents the current setting of the toggle.