.TRIM

Trim extra blanks from end of window

WSupported on Windows

USupported on Unix

VSupported on OpenVMS

NSupported in Synergy .NET

.TRIM [#lines_to_leave]

Arguments

#lines_to_leave

(optional) The number of blank lines to leave at the bottom of the window after it is trimmed.

Discussion

The .TRIM command tells the script compiler to trim extra blank lines from the end of the window and redefine the window height given in the .WINDOW or .INPUT command. If #lines_to_leave is omitted, all blank lines will be trimmed.

If you have an empty window and either omit #lines_to_leave or specify a value of 1, UI Toolkit will create a one-line window.

The displayed height cannot be less than one line, so .TRIM cannot reduce a window to 0 lines.

Examples

This example trims all blank lines but one from the bottom of the window.

.window h_general, 5, 40
.placement 1,1
.text mytext, position(1,1)
This window is trimmed to three lines, with the last line blank
.trim 1
.end