reset

Reset graphics object properties

Syntax

reset(h)

Description

reset(h) resets all of the properties of the specified graphics object to their default values. Properties that do not have default values are not reset.

MATLAB^® does not reset the Position or Units properties for any graphics object. In addition, if h is a Figure object, then MATLAB does not reset any of the figure properties unaffected by reset.

Examples

Reset Axes and Figure Properties

Reset the properties of the current axes and the current figure.

reset(gca)
reset(gcf)

Input Arguments

h — Graphics objects

single object | vector of objects

Graphics objects, specified as a single object or a vector of objects.

Limitations

• The reset function is not supported in app building workflows.

More About

Figure Properties Unaffected by Reset

When reset resets the properties of a figure, some properties are not reset. These properties include:

• Properties that do not have a default value, such as Number

• Properties that have a value that depends on user interaction, such as CurrentObject and SelectionType

• Properties that control the figure size, such as Position and Units

• Properties that control the figure window behavior and tools, such as WindowStyle, MenuBar, and ToolBar

Version History

Introduced before R2006a

R2024b: Figure menu bar and toolbar are unaffected by reset

When you call reset on a figure, the MenuBar and ToolBar properties of the Figure object are unaffected.