BUTTON (declare a pushbutton control)

Top  Previous  Next

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|

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