figflag (MATLAB Function Reference)

Test if figure is on screen

Syntax

[flag] = figflag('figurename')
[flag,fig] = figflag('figurename')
[...] = figflag('figurename',silent)

Description

Use figflag to determine if a particular figure exists, bring a figure to the foreground, or set the window focus to a figure.

[flag] = figflag('figurename')

returns a 1 if the figure named 'figurename' exists and pops the figure to the foreground; otherwise this function returns 0.

[flag,fig] = figflag('figurename')

returns a 1 in flag, returns the figure's handle in fig, and pops the figure to the foreground, if the figure named 'figurename' exists. Otherwise this function returns 0.

[...] = figflag('figurename',silent)

pops the figure window to the foreground if silent is 0, and leaves the figure in its current position if silent is 1.

Examples

To determine if a figure window named 'Fluid Jet Simulation' exists, type

[flag,fig] = figflag('Fluid Jet Simulation')

MATLAB returns:

flag =
    1
fig =
    1

If two figures with handles 1 and 3 have the name 'Fluid Jet Simulation', MATLAB returns:

flag =
    1
fig = 
    1 3