Main Content

figurepalette

(Not recommended) Show or hide the Figure Palette

    figurepalette is not recommended. Use plotedit instead. For more information, see Compatibility Considerations.

    Description

    example

    figurepalette shows the Figure Palette plot tool on the current figure. If no current figure exists, figurepalette will create one.

    When you dock, undock, resize, or reposition a plot tool, MATLAB® restores that configuration when you invoke the tool for subsequent figures, both within and across MATLAB sessions. There is no command to reset a plot tool to its original configuration.

    figurepalette(state) changes the state of the Figure Palette plot tool on the figure. For example, figurepalette("on") shows the Figure Palette.

    figurepalette(fig,___) operates on the specified figure instead of the current figure. The input fig can precede any of the input argument combinations in the previous syntaxes.

    Examples

    collapse all

    Show the Figure Palette on a figure by calling the figurepalette function. The tool opens in the same configuration as last time you invoked the tool.

    plot(1:10);
    figurepalette

    Figure Palette tool to the left of a figure window. The Figure Palette tool has sections titled "New Subplots", "Variables", and "Annotations".

    Input Arguments

    collapse all

    Figure Palette tool state, specified as one of these values:

    • "on" — Show Figure Palette.

    • "off" — Hide Figure Palette.

    • "toggle" — Switch the Figure Palette state between the "on" and "off" states.

    Example: figurepalette("on") shows the Figure Palette plot tool on the current figure.

    Target figure, specified as a Figure object. Use fig to show or hide the Figure Palette on a specific figure instead of the current figure.

    Example: figurepalette(f) shows the Figure Palette plot tool on the figure f.

    Tips

    If you call figurepalette in a MATLAB program and subsequent lines depend on the Figure Palette being fully initialized, follow it by drawnow to ensure complete initialization.

    Alternatives

    Show or hide the Figure Palette tool from the View menu of a figure window.

    Version History

    Introduced before R2006a

    expand all

    Behavior change in future release