HTBasic Help
×
Menu
Index

Pushbutton Widget

 
_______________________________________________________
PUSHBUTTON Widget
A stand-alone button that can be placed anywhere on the screen or in a PANEL
_______________________________________________________
 
Legal Usage                Level-0 Widget:                Yes
                 Parent to:                None
                 Child of:                        PANEL
 
Example Image
 
     
 
Example Program
 
See PUSHBUTTON Widget for a program that creates a PUSHBUTTON widget and provides a display similar to that shown above.
 
See the following programs for other examples using the PUSHBUTTON widget:
 
         Alarm Clock
         Calculator
         Cyclical PUSHBUTTON
         Environmental Chamber
         Function Generator
         Hammer Game
         Ice Cream Sundae
         PID Controller
         PUSHBUTTON Events
         Slot Machine
         Tab Groups
         Tic-Tac-Toe
         Using ON EVENT
 
Attributes
 
See PUSHBUTTON Widget Attributes for the PUSHBUTTON widget attribute list.
 
Remarks
 
The PUSHBUTTON widget is a stand-alone button that can be placed anywhere on the screen or in a PANEL.
 
Clicking the mouse button (or pressing the Spacebar or the Return key) while the focus in on the PUSHBUTTON causes an ACTIVATED event to be generated. For example, if you execute the following statements, when you click on the "Push Me" button the "Handler" routine will be executed.
 
  ASSIGN @Btn TO WIDGET "PUSHBUTTON"; SET ("LABEL":"Push Me")
  ON EVENT @Btn, "ACTIVATED" GOSUB Handler
 
If you specify a string array as a parameter to LABELS, and specify the number of elements in the array with the STATES attribute, PUSHBUTTON will cycle through the different labels. You can query the current PUSHBUTTON label setting with the STATE attribute.
 
Clicking the mouse button (or pressing the Spacebar or the Return key) while the focus is on the PUSHBUTTON causes an ACTIVATED event to be generated. PUSHBUTTON can be a multi-state device (see LABEL and STATES attributes) where each push of the button cycles to the next state.
 
Events
 
Events for the PUSHBUTTON widget are:
 
·
ACTIVATED
·
SYSTEM MENU
 
ACTIVATED
 
This event occurs only when the mouse button is pushed and released
while the the cursor is within the border of the PUSHBUTTON.
 
SYSTEM MENU
 
This event is generated when the operator selects items from the SYSTEM MENU.