L_BUTTONSET

Define the placement of a set of buttons on a list

WTSupported in traditional Synergy on Windows

 

 

 

xcall L_BUTTONSET(list_id, [placement], [per_row_col], [justification][, button_name])

Arguments

list_id

The ID of the list. (n)

placement

(optional) One of the following: (n)

DSB_BOTTOM

The set of buttons will be placed horizontally along the bottom of the container 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 container 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

L_BUTTONSET defines the placement of a set of buttons for a list. Every button is contained within a set and only one button set is allowed per list; therefore, calling L_BUTTONSET will affect all buttons for the list.

The background rendition of the button area is defined by the background rendition of the input window at the time that L_CREATE is called.

This routine is ignored on UNIX and OpenVMS.

See also

Using the button routines for general information on buttons and button sets on windows, tab sets, and lists.

Examples

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

xcall l_buttonset(list_id, DSB_RIGHT, 3, DSB_CENTER)