clf

Clear current figure window

Syntax

clf
clf('reset')
clf(fig)
clf(fig,'reset')
figure_handle = clf(...)

Description

clf deletes from the current figure all graphics objects whose handles are not hidden (i.e., their HandleVisibility property is set to on).

clf('reset') deletes from the current figure all graphics objects regardless of the setting of their HandleVisibility property and resets all figure properties except Position, Units, PaperPosition, and PaperUnits to their default values.

clf(fig) or clf(fig,'reset') clears the single figure with handle fig.

figure_handle = clf(...) returns the handle of the figure. This is useful when the figure IntegerHandle property is off because the noninteger handle becomes invalid when the reset option is used (i.e., IntegerHandle is reset to on, which is the default).

Alternatives

Use Clear Figure from the figure window's Edit menu to clear the contents of a figure. You can also create a desktop shortcut to clear the current figure with one mouse click. See Rerun Favorite Commands.

Tips

The clf command behaves the same way when issued on the command line as it does in callback routines — it does not recognize the HandleVisibility setting of callback. This means that when issued from within a callback routine, clf deletes only those objects whose HandleVisibility property is set to on.

See Also

| | |

Introduced before R2006a