The GETWINDOWS function retrieves either a specific graphic window or all graphics windows.

Example


p = PLOT(/TEST)
c = CONTOUR(/TEST)
pwin = GetWindows('Plot')
HELP, pwin
 
win = GetWindows(NAMES=winNames)
HELP, win
PRINT, winNames

When this example is run, IDL prints:

PWIN            OBJREF    = Array[1]
WIN             OBJREF    = Array[2]
Plot Contour

Syntax


Result = GETWINDOWS( [Name] [, /CURRENT] [, NAMES=variable] )

Return Value


The result is a scalar or array of graphics windows, or a null object if no graphics windows exist.

Arguments


Name

Set this optional argument to a string giving the name of the window to retrieve. The first window whose NAME property matches Name will be returned. If no window exists with that name then a null object is returned.

Keywords


Keywords are applied only during the initial creation of the graphic.

CURRENT

If this keyword is set, then return only the current graphics window or a null object if no graphics windows exist. The SetCurrent Method may be used to change the current window.

NAMES

Set this keyword to a named variable in which to return a scalar string or a string array of the window names in Result.

Version History


8.0

Introduced

8.2

Added CURRENT keyword.

See Also


WINDOW, SetCurrent Method