Main Content

reset

Reset graphics object properties

collapse all in page

    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.

    example

    Examples

    collapse all

    Open Live Script

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

    reset(gca)
reset(gcf)

    Figure contains an axes object. The axes object is empty.

    Input Arguments

    collapse all

    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

    collapse all

    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

    expand all

    See Also

    Functions

    Topics