.PLACEMENT

Define the placement of a window

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
.PLACEMENT row, column[, UNBOUNDED]

Arguments

row

The screen row at which the upper-left corner of the window is placed (relative to the upper-left corner of the screen body, not the entire screen).

column

The screen column at which the upper-left corner of the window is placed.

UNBOUNDED

(optional) The specification that you want absolute window placement that is not bounded by UI Toolkit’s screen. UNBOUNDED must be omitted for a list class.

Discussion

The .PLACEMENT command defines the location of an input, selection, or general window on the screen. You can also use it to specify the default placement for a list class. If both row and column are set to a value of 0, the window is centered in the application window.

The default position is row 1, column 1. Any border goes around the window’s placement area.

When a selection window defined by the .SELECT command is processed, the position specified by the SELWND input field qualifier will override the position specified by .PLACEMENT. Therefore, with selection windows, .PLACEMENT is most useful when processing a selection window directly through U_LDWND and either S_SELECT or S_SELECTCB.

If .PLACEMENT is specified for a list class, you can override the placement when a list is created with the L_CREATE subroutine. If .PLACEMENT is not defined for a list class, the default placement is inherited from the associated input window specified in the L_CREATE subroutine.

Any window with a display area of up to 50 x 255 can be placed with the .PLACEMENT command. If you use a .PLACEMENT command for a window that Script considers to be larger than the application window, it will generate a nonfatal “Could not place window” error. Script will then continue processing. (Proto will generate the same error for windows larger than 24 x 80 that have a .PLACEMENT command.) Script determines if a window will fit in the application window

See also

.DISPLAY_AREA for more information on defining a movable display area (a view) for general windows (.WINDOW) and input windows (.INPUT)

Examples

The following .INPUT command in the example defines an input window named cusinf whose dimensions are 12 rows by 40 columns. The .PLACEMENT command places the upper-left corner of that window at screen row 4, column 21.

.input cusinf, 12, 40
.placement 4, 21

The list class defined in the following example is placed at row 3, and column 1.

.listclass my_list, items(14), load_method("my_load_method")
.placement 3,1
.end