NAME

wdisp − change displayability of windows

SYNOPSIS

wdisp [-tbo] [-ni] [window_spec...]
wdisp -d
wdisp -u

DESCRIPTION

This command changes one or more windows’ positions in the display stack, their concealment, and/or their representation (normal or icon).  By default, if you give no window_specs, the window connected to standard input is made displayable as the top window on the stack and put in normal (not icon) form. See windows(1) for an explanation of window_spec.

Options are:

-t Make the windows displayable and on top of the stack (in the order their names appear).  This (along with -n) is the default if you give no options. 

-b Make the windows displayable and on the bottom of the stack (in the order their names appear).  They may be partially or totally occluded by other windows, thus not totally visible. 

-o Make the windows concealed off-screen.  Concealing windows removes them from the stack. 

Only one of -t, -b, and -o is allowed.  If you give one of them, but neither -n nor -i, then only the windows’ displayability is changed, not their representations. 

-n Make the windows go to normal form (if they were iconic).  This (along with -t) is the default if you give no options. 

-i Make the windows go to iconic form (if they were normal). 

Only one of -n and -i is allowed.  If you give one of them, but none of -t, -b, or -o, then only the windows’ representations are changed, not their displayability. 

-d Shuffle the top window down, i.e. the old top window becomes the bottom window and the new top window becomes selected. 

-u Shuffle the bottom window up, i.e. the old bottom window becomes the top and selected window. 

The -d and -u options each cannot be combined with any other, nor applied to any window_specs. Note also that with these options, the resulting topmost window automatically becomes the selected window.

EXAMPLES

wdisp Make the window connected to standard input displayable, on top of the stack, and normal form. 

wdisp -bi
Make the window connected to standard input displayable, at the bottom of the stack, and convert it to icon form.

wdisp -on minnow tadpole
Make the windows "minnow" and "tadpole" concealed and convert them to normal form.

wdisp -u
Shuffle the bottom window to the top of the display stack and make it selected.

SEE ALSO

windows(1),wcreate(1),wlist(1),wsh(1),wautotop(3W),wbottom(3W),wconceal(3W), wiconic(3W),wshuffle(3W),wtop(3W). 

DIAGNOSTICS

The following values are returned by this routine:

0 If no errors are detected. 

1 Prints a message to standard error and returns 1 if it encounters an error which prevents changing a window or doing a shuffle, including trouble while expanding a window_spec pattern. 

2 Prints a message to standard error, continues, and later returns 2 if it encounters any error while trying to change an attribute of a window. 

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