IB_BUTTONSET

Define the placement of a set of buttons

WTSupported in traditional Synergy on Windows

 

 

 

xcall IB_BUTTONSET(build_id, [placement], [per_row_col], [justification][, button_name])

Arguments

build_id

The ID of the input window under construction. (n)

placement

(optional) One of the following: (n)

DSB_BOTTOM

The set of buttons will be placed horizontally along the bottom of the window with a maximum of per_row_col buttons per row. (default)

DSB_RIGHT

The set of buttons will be placed vertically along the right side of the window with a maximum of per_row_col buttons per column.

per_row_col

(optional) The maximum number of buttons to place on a row if DSB_BOTTOM is specified, or on a column if DSB_RIGHT is specified. The default behavior is to display as many buttons as will fit and wrap to the next row or column. (n)

justification

(optional) One of the following: (n)

DSB_BEGIN

The buttons will be left‑justified if DSB_BOTTOM is specified, or positioned towards the top if DSB_RIGHT is specified. (default)

DSB_CENTER

The buttons will be centered along the designated side.

DSB_END

The buttons will be right‑justified if DSB_BOTTOM is specified, or positioned towards the bottom if DSB_RIGHT is specified.

button_name

(optional) The name of the default button. (a)

Discussion

IB_BUTTONSET defines the placement of a set of buttons within a new input window. This subroutine is used when building a new input window at runtime.

Every button is contained within a set and only one button set is allowed per input window; therefore, calling IB_BUTTONSET will affect all buttons in an input window.

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.

This routine has no effect on applications running on UNIX or OpenVMS or in Synergy .NET. It does, however, save button information on these platforms, so if the window is saved to a window library (by using U_SAVE) and later loaded from that library on a Windows platform in traditional Synergy, the button will be on the window (assuming ISAM‑compatible platforms).

See also

Examples

The following example places the input window’s buttons on the right side of the window, centered, with, three buttons per column (at most).

xcall ib_buttonset(bldid, DSB_RIGHT, 3, DSB_CENTER)