.BORDER

Define border renditions

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
.BORDER [border_on_off][, rendition, …][, DRAGBAR[(ON|OFF)]]

Arguments

border_on_off

(optional) Determines whether the window displays a border. Valid options are as follows:

ON = Window displays a border. (default)

OFF = Window does not display a border.

NOCELL = Window displays a border only if it does not require a full character cell for display. See Discussion.

rendition

(optional) One or more of the following display renditions:

BLINK | ITALIC

Blinking (on UNIX and OpenVMS) or italic (on Windows).

NOBLINK | NOITALIC

Not blinking (on UNIX and OpenVMS) or not italic (on Windows). (default)

BOLD

Highlighted (or boldfaced).

NOBOLD

Not highlighted (or boldfaced). (default)

COLOR(palette#)

Assign specified palette#, where palette# is a palette number in the range 1 to 16. The default is 1.

HIGHLIGHT

Highlighted (or boldfaced).

NOHIGHLIGHT

Not highlighted (or boldfaced). (default)

REVERSE

Reverse video.

NOREVERSE

Normal video. (default)

UNDERLINE

Underlined.

NOUNDERLINE

Not underlined. (default)

DRAGBAR [(ON | OFF)]

(optional) Specifies whether the window will (ON, the default) or will not (OFF) have a drag bar in a Windows environment. This option has no effect on UNIX and OpenVMS.

Discussion

The .BORDER command defines the renditions of the border around the window. Renditions can be listed in any order.

On Windows, window borders may not take up an entire “cell” as they do in cell‑based environments. Therefore, if you are depending on one window’s border to fully occlude a certain area of another window when your application runs on UNIX or OpenVMS, you won’t be able to depend on this same occlusion when your application runs in a Windows environment.

In addition, none of the renditions available for borders have any effect in on Windows, and if you specify NOCELL, the window will have a border only if the application runs in a Windows environment.

An option for Windows environments is to specify DRAGBAR and the argument ON or OFF. DRAGBAR only affects the window when the border is turned on. If you don’t pass DRAGBAR and if the window is more than one row in height, the default is ON. If the window is one row in height, the default is OFF. If you specify DRAGBAR without specifying ON or OFF, DRAGBAR defaults to ON.

Examples

This example displays a border in reverse video with color palette number 3.

.border on, reverse, color(3)

This Windows example displays a border around a window that the user will not be able to drag.

.border on, dragbar(off)