NAME

wborder − control window border style, color, label

SYNOPSIS

wborder [-ntT] [-c fcolor,bcolor] [-l label] [window_spec...]

DESCRIPTION

This command lets you change the border style (normal, thin, or none), colors, and/or label for the specified windows (by default, if you give no window_specs, the window connected to standard input). See windows(1) for an explanation of window_spec.

Options are:

-n Set the borders to normal form (label and manipulation areas displayable).  This is the default if you give no options. 

-t Set the borders to thin form.  Label and manipulation areas are concealed and inaccessible, except that you can get a pop-up menu using the thin border. 

-T Do not display a border. 

You can only give one of -n, -t, or -T. 

-c fcolor,bcolor
Set the border foreground (fcolor) and background (bcolor) colors (index numbers).  Each number specifies an actual color in the color map (there is only one per physical display).  The colors are not changed unless you give this option. 

Color names or abbreviations (substrings) may be given instead of numbers, in any mixture of upper and lower case.  They are mapped to color indices as follows:

black0 ("b" and "bl" mean "black")
white1
red2
yellow3
green4
cyan5
blue6 ("blu" or "blue" is required)
magenta7

This mapping is only valid as long as the default color map for the device is not changed. 

-l label
Set the windows’ labels to the given string, which should be enclosed in quotes if necessary to have the shell treat it as a single item. The label is not changed unless you give this option.

Up to 128 characters of the label are displayed in the border of a graphics window, and up to 12 characters of the label are displayed in the border of a term0 window.  Only the first 12 characters of the label are displayed in the icon label and the default pop-up menu title.  Only the first 14 characters are displayed in the title in the SFK area.  When a window is sized such that not all of the label would fit in the border, the display length of the label is truncated, down to a minimum of one character.  (A window cannot be sized any smaller than this if the border is normal). 

Note that the label is not necessarily the true name of the window.  Only the true name can be given to other commands as window_spec. You can use wlist(1) with no arguments to get the true name.

None of the changes made using this command are immediately visible if a window is concealed or occluded.  The border label is only displayed when the border is normal. 

You can’t make the border normal on a window whose current size is less than the minimum size allowed with a normal border.  If a window does not have a big enough raster/buffer to allow it to grow to this minimum size, it can never have a normal border. 

EXAMPLES

wborder
Set the border to normal width on the window connected to standard input.

wborder -t
Set the border to thin style on the window connected to standard input.

wborder -n -c 23,104 -l’A Window’ win4 win5
Set the border to normal, the border foreground color to 23 and background color to 104, and the label to "A Window" for the windows named "win4" and "win5".

wborder -cb,cy
Set the border foreground color to black (0) and the background color to cyan (6) for the window connected to standard input.

wborder -c Red,Green
Set the border foreground color to red (5) and the background color to green (3) for the window connected to standard input.

HARDWARE DEPENDENCIES

Series 500:
The −T option is not supported on Series 500.  The Series 500 does not support the null border type; each window must have either a thin or normal border. 

SEE ALSO

windows(1), wcreate(1), wlist(1),wsh(1),wsize(1),wbanner(3W),wsetbcolor(3W), wsetlabel(3W). 

DIAGNOSTICS

The following values are returned by this routine:

0 If no errors are detected. 

1 If it encounters an error which prevents changing border attributes for a window, including trouble while expanding a window_spec pattern.  Note that an error message is also displayed to standard error in this case. 

2 If it encounters any error while trying to set attributes for one window.  An error message is also displayed to standard error. 

Hewlett-Packard Company  —  HP-UX Release 8.0: January 1991