GUI ScreenIO for Windows

Pushbutton Control Properties

The items are arranged in alphabetical order.

Item Significance


Gives a flat appearance to the control.

Flush appearance

Draws a border around that button that makes it appear to be flush with the surface of the panel.

Has a border

Draws a line around the entire control and label.

Multiline text

Allows the label text to wrap so that it can be displayed as multiple lines.
Event properties:


The COBOL 88-level name want to assign to this item in the panel copybook. 

The panel name will be prefaced to your 88-name so that it will be unique if you should have more than one panel in one program.

Event properties:

Assign event ID automatically

Strongly recommended.  The panel editor will assign a unique number to each event that can be generated by the panel.

Because the recommended programming model uses 88-level items to identify events, there is no need to use the actual ID number assigned to the event.

Event properties:

Event ID

The number assigned to this event.

Keyboard shortcut

Keyboard shortcut that is assigned to this event.

Use of Alt+ combinations:  You should be careful to avoid conflicts with standard Windows keyboard shortcutsAlt+ combinations should be avoided as they conflict with access keys.

If you enable the standard Windows shortcut to a button or menu item by using the ampersand (&) character in the label, it is redundant to specify an Alt+ character combination as a shortcut key.



Text associated with the control. 

If pushbutton invokes a dialog box or property sheet, you should follow the label with an ellipsis (...).

Use of ampersand (&) character:  To assign an access key to this item, insert an ampersand (&) character in front of the character to be used as the access key.  To define F as the access key for the File command, enter &File as the label.  The ampersand is not displayed, and the following character will be underlined:  File

If you want to display an ampersand, enter two of them (&&).



Press this button to select a key that will be assigned as a shortcut for this event.


ToolTip text that is displayed if the mouse cursor pauses over the control.
Position label horizontally:


Label text will be centered.
Position label horizontally:

Left justify

Label text will be left-justified.
Position label horizontally:

Right justify

Label text will be right-justified.
Position label vertically:


Label text will be positioned near the bottom of the control.
Position label vertically:


Label text will be centered vertically.
Position label vertically:


Label text will be positioned near the top of the control.
Runtime behavior:

Default pushbutton

The button is activated when the user presses Enter, even if the button does not have the keyboard focus.
Runtime behavior:

Does not retain focus

Normally the pushbutton acquires the focus when it is clicked with the mouse.

This option causes the keyboard focus to remain with the control that was active before the pushbutton was clicked.  This ONLY works when the pushbutton was clicked with the mouse, NOT when the user tabs to the pushbutton and then clicks it or activates it with the enter key, spacebar or a function key equivalent. 

The purpose of this option is to allow a selection in a list view, or an array of fields to persist when the user makes a selection, and then clicks the pushbutton.  In such cases you frequently want control to return to your program with the selection retaining the focus so that you can determine which element was selected. 

Runtime behavior:

Equate to Help

Returns a Help event to GUI ScreenIO, which will launch your help file.
Runtime behavior:

Program can enable/disable or set focus to pushbutton

Inserts 88-level items in the panel copybook that allow you to protect this pushbutton, or to set the keyboard focus to it under program control.
Runtime behavior:

Tab stops here

Allows the user to tab to this control.

Related topics:

2000-2019 Norcom, all rights reserved 


Send feedback to Norcom