gcf (MATLAB Functions)

Get current figure handle

Syntax

```
h = gcf
```

Description

h = gcf returns the handle of the current figure. The current figure is the figure window in which graphics commands such as plot, title, and surf draw their results. If no figure exists, MATLAB creates one and returns its handle. You can use the statement

```
get(0,'CurrentFigure')
```

if you do not want MATLAB to create a figure if one does not already exist.

See Also

clf, figure, gca

Root CurrentFigure property

Finding and Identifying Graphics Objects for related functions

gcd gco