User Tools

Site Tools


button_declare_a_pushbutton_control_.htm
Navigation:  Language Reference > 8 - Controls > Control Declarations >====== BUTTON (declare a pushbutton control) ====== Previous pageReturn to chapter overviewNext page

NewC7.jpg

BUTTON(text),AT( ) [,CURSOR( )] [,USE( )] [,DISABLE] [,KEY( )] [,MSG( )] [,HLP( )] [,SKIP]

[,STD( )] [,FONT( )] [,ICON( )] [,DEFAULT] [,IMM][,REQ] [,FULL] [,SCROLL] [,ALRT( )]
[,HIDE] [,DROPID( )] [,TIP( )] [,FLAT] [,REPEAT( )] [,DELAY( )] [, LEFT ] [,TRN] [,LAYOUT]
[,COLOR( )] RIGHT

blk2blue.jpg

BUTTON Places a command button on the WINDOW or TOOLBAR.
text A string constant containing the text to display on the button face, along with any ICON specified (PROP:Text). This may contain an ampersand (&) to indicate the “hot” letter (accelerator key) for the button.
AT Specifies the initial size and location of the control (PROP:AT). If omitted, default values are set by the runtime library.
CURSOR Specifies a mouse cursor to display when the mouse is positioned over the control (PROP:CURSOR). If omitted, the WINDOW's CURSOR attribute is used, else the Windows default cursor is used.
USE A field equate label to reference the control in executable code (PROP:USE).
DISABLE Specifies the control appears dimmed when the WINDOW or APPLICATION is first opened (PROP:DISABLE).
KEY Specifies an integer constant or keycode equate that immediately gives focus to and presses the button (PROP:KEY).
MSG Specifies a string constant containing the text to display in the status bar when the control has focus (PROP:MSG).
HLP Specifies a string constant containing the help system identifier for the control (PROP:HLP).
SKIP Specifies the control does not receive input focus and may only be accessed with the mouse or accelerator key (PROP:SKIP).
STD Specifies an integer constant or equate that identifies a “Windows standard action” the control executes (PROP:STD).
FONT Specifies the display font for the control (PROP:FONT).
ICON Specifies an image file or standard icon to display on the button face (PROP:ICON).
DEFAULT Specifies the BUTTON is automatically pressed when the user presses the ENTER key (PROP:DEFAULT).
IMM Specifies the control generates an event when the left mouse button is pressed, continuing as long as it is depressed (PROP:IMM). If omitted, an event is generated only when the left mouse button is pressed and released on the control.
REQ Specifies that when the BUTTON is pressed, the runtime library automatically checks all ENTRY controls in the same WINDOW with the REQ attribute to ensure they contain data other than blanks or zeroes (PROP:REQ).
FULL Specifies the control expands to occupy the entire size of the WINDOW for any missing AT attribute width or height parameter (PROP:FULL).
SCROLL Specifies the control scrolls with the window (PROP:SCROLL).
ALRT Specifies “hot” keys active for the control (PROP:ALRT).
HIDE Specifies the control does not appear when the WINDOW or APPLICATION is first opened (PROP:HIDE). UNHIDE must be used to display it.
DROPID Specifies the control may serve as a drop target for drag-and-drop actions (PROP:DROPID).
TIP Specifies the text that displays as “balloon help” when the mouse cursor pauses over the control (PROP:ToolTip).
FLAT Specifies the button appears flat except when the mouse cursor passes over the control (PROP:FLAT). Requires the ICON attribute.
REPEAT Specifies the rate at which EVENT:Accepted generates when the button with the IMM attribute is held down by the user (PROP:REPEAT). Requires the IMM attribute.
DELAY Specifies the delay between the first and second generation of EVENT:Accepted for a button with the IMM attribute (PROP:DELAY). Requires the IMM attribute.
LEFT Specifies that the icon appears to the left of the text (PROP:LEFT).
RIGHT Specifies that the icon appears to the right of the text (PROP:RIGHT).
TRN Specifies that the characters print or display transparently without obliterating the background over which the control is placed.
LAYOUT Specifies the control's left-to-right or right-to-left display orientation (PROP:LAYOUT)
COLOR Specifies a background color for the control (PROP:COLOR).

The BUTTON control places a pushbutton on the WINDOW or TOOLBAR (not valid in a REPORT) at the position and size specified by its AT attribute.

A BUTTON with the IMM attribute generates EVENT:Accepted as soon as the left mouse button is pressed on the control and continues to do so until it is released. This allows the BUTTON control's executable code to execute continuously until the mouse button is released. The rate and delay before continuous event generation can be set by the REPEAT and DELAY attributes. A BUTTON without the IMM attribute generates EVENT:Accepted only when the left mouse button is pressed and then released on the control.

A BUTTON with the REQ attribute is a “required control fields check” button. REQ attributes of ENTRY or TEXT control fields are not checked until a BUTTON with the REQ attribute is pressed or the INCOMPLETE procedure is called. Focus is given to the first required control which is blank or zero.

A BUTTON with an ICON attribute displays the image on the button face in addition to its text parameter (which appears below the image, by default). The text parameter also serves for accelerator “hot” key definition.

Events Generated:

EVENT:Selected The control has received input focus.
EVENT:Accepted The control has been pressed by the user.
EVENT:PreAlertKey The user pressed an ALRT attribute hot key.
EVENT:AlertKey The user pressed an ALRT attribute hot key.
EVENT:Drop A successful drag-and-drop to the control.

Example:

MDIChild WINDOW('Child One'),AT(0,0,320,200),MDI,MAX,HVSCROLL

         BUTTON('1'),AT(0,0,20,20),USE(?B1)

         BUTTON('2'),AT(20,0,20,20),USE(?B2),KEY(F10Key)

         BUTTON('3'),AT(40,0,20,20),USE(?B3),MSG('Button 3')

         BUTTON('4'),AT(60,0,20,20),USE(?B4),HLP('Button4Help')

         BUTTON('5'),AT(80,0,20,20),USE(?B5),STD(STD:Cut)

         BUTTON('6'),AT(100,0,20,20),USE(?B6),FONT('Arial',12)

         BUTTON('7'),AT(120,0,20,20),USE(?B7),ICON(ICON:Question)

         BUTTON('8'),AT(140,0,20,20),USE(?B8),DEFAULT

         BUTTON('9'),AT(160,0,20,20),USE(?B9),IMM

         BUTTON('10'),AT(180,0,20,20),USE(?B10),CURSOR(CURSOR:Wait)

         BUTTON('11'),AT(200,0,20,20),USE(?B11),REQ

         BUTTON('12'),AT(220,0,20,20),USE(?B12),ALRT(F10Key)

         BUTTON('13'),AT(240,0,20,20),USE(?B13),SCROLL

        END

CODE

OPEN(MDIChild)

ACCEPT

 CASE ACCEPTED()

 OF ?B1

  !Perform some action

 END

END

See Also:

CHECK

OPTION

RADIO

button_declare_a_pushbutton_control_.htm.txt · Last modified: 2021/04/15 15:57 (external edit)