Series 300 and 500 Only

NAME

wlist − list status of windows or fonts

SYNOPSIS

wlist [-fl] [window_spec...]

DESCRIPTION

This command lists information about currently existing windows or their loaded fonts.  It only knows about the windows and fonts associated with the one invocation of the window manager (wm) which supports the same physical display.

By default, wlist prints to standard output the full names of the given windows, or the one connected to standard input if you give no window_specs, one name per line. See windows(1) for an explanation of window_spec. (Note in particular that you can use ’−’ to list the window connected to standard input along with others, and ’∗’ to list all windows.) 

Options are:

-f List information about fonts currently loaded for the specified windows, which should be of type term0 (other types appear to have no fonts loaded).  Prints the full name of each window, followed by a colon, followed by the full pathnames of all fonts loaded for that window, one name per line. 

-l List (long-form) all available and useful information about each window or font.  The output formats are described below. 

To get information on font files, whether or not they are currently loaded, use file(1).

Long-form Output Format

For fonts (-f option), each font pathname is preceded by a cell size (pixel width x height) and an activation indicator:

b/a active as both base and alternate font

base active as base font

alt active as alternate font

− font loaded but not active

For windows, wlist prints a title line followed by one line of data for each window.  Field titles and values are:

WT Window type:

t0 term0

gr graphics

K Keyboard attached (window selected):

− not selected

k selected

D Display status:

t top

b bottom

− displayable, but not top or bottom

c concealed offscreen

T Border style:

− normal

t thin

T no border

I Iconic:

− normal

i iconic

A Auto Destroy:

− normal

a autodestroyable and recoverable

d recoverable but not autodestroyable

LOCX LOCY
X,Y locations of window’s normal state (pixels).

WIDE HIGH
Window’s width, height (type-dependent units).

PANX PANY
Window’s pan X,Y offsets (type-dependent units). They appear as "?" for term0 windows because that window type does not support panning. 

RASW RASH
Window’s raster/buffer height, width (type-dependent units).

ILCX ILCY
X,Y location of window’s iconic state (pixels).

FGC BGC
Window’s foreground, background border colors (indices).

WINDOW
The window’s basename.

The output format is carefully arranged so that, even with the longest window basename (12 characters), each output line just fits on one 80-character display line without wrapping.  If any numeric value is larger than five digits (with possible sign), the line may wrap around. 

EXAMPLES

wlist List the full name of the window connected to standard input. 

wlist -f win5
List information on fonts loaded for window “win5”.

wlist -l
List all available information about the window connected to standard input.

The final example checks whether standard input is a window and prints a message accordingly:

if wlist > /dev/null 2>&1
then
    echo "stdin is a window"
else
    echo "stdin is NOT a window"
fi

SEE ALSO

windows(1), file(1), wborder(1), wcreate(1), wdestroy(1), wdisp(1), wmove(1), wselect(1), wsh(1), wsize(1). 

DIAGNOSTICS

This command returns the following values:

0 If no errors are detected. 

1 Prints a message to standard error and returns 1 if it encounters an error which prevents listing any information, 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 list information for one window.  No information is printed for the affected window (or its fonts). 

Hewlett-Packard Company  —  May 11, 2021