.BUTTON_SET

Define the placement of a set of buttons

WTSupported in traditional Synergy on Windows

 

 

 

.BUTTON_SET [BOTTOM(buttons_per_row)|RIGHT(buttons_per_column)] –
            [, justification][, DEFAULT(button_name)]

Arguments

BOTTOM (buttons_per_row)

(optional) Place the buttons at the bottom of the window and specify the maximum number of buttons per row. (default)

RIGHT (buttons_per_column)

(optional) Place the buttons at the right of the window and specify the maximum number of buttons per column.

justification

(optional) Specifies how the button set is aligned, whether in a row at the bottom of the window or in a column.

BEGINNING

Justify to the beginning of the row or column. (default)

CENTER

Justify to the center of the row or column.

END

Justify to the end of the row or column.

DEFAULT (button_name)

(optional) Specify the name of the default button.

Discussion

You can use the .BUTTON_SET command to define the placement of a set of buttons in a window. It can be specified before or after the .BUTTON commands.

The default button set placement is BOTTOM. If neither buttons_per_row nor buttons_per_column is specified, the maximum number of buttons that will fit on a row or column of the window will be displayed before a new row or column is created.

If the E_STATE option D_RETURNBTN is set, the default button will be selected if you press return, no matter what field you’re on in the window. If button_name is not specified and D_RETURNBTN is set, the first button in the window is the default.

If a tab set container and its contained window both have buttons, the following rules are used to determine which button is the default:

The window will expand downward or to the right to accommodate the buttons. This expansion may cause your window to extend beyond the bottom or right side of your application window.

.BUTTON_SET has no effect on applications running on UNIX or OpenVMS. Script does, however, save button information on these platforms, so if the window is loaded on a Windows platform, the button will be displayed (assuming ISAM-compatible platforms).

See also

Examples

This example shows OK, Cancel, and Help buttons centered on the right side of an input window.

.button I_OK, text("OK")
.button O_ABANDON, text("Cancel")
.button O_HELP, text("Help")
.button_set right, center

   

1. Buttons on an input window.

Buttons on an input window