figflag (MATLAB Functions)

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 sends 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 sends 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
```

See Also

figure

Figure Windows for related functions

fieldnames figure