showplottool

(Not recommended) Show or hide specified plot tool

showplottool is not recommended. Use inspect to launch the Property Inspector instead. For more information, see Version History.

Syntax

showplottool(tool)

showplottool(state,tool)

showplottool(fig,___)

Description

showplottool(tool) shows specified plot tool on the current figure. If no current figure exists, showplottool 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.

showplottool(state,tool) changes the state of the specified plot tool on the current figure. For example, showplottool("on","plotbrowser") shows the Plot Browser.

showplottool(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

Open Specified Plot Tool

Show the Property Editor on a figure by calling the showplottool function. The tool opens in the same configuration as last time you invoked the tool.

plot(1:10);
showplottool("propertyeditor")

Input Arguments

tool — Selected plot tool

"figurepalette" | "plotbrowser" | "propertyeditor"

Selected plot tool, specified as one of these values:

• "figurepalette" — Operate on the Figure Palette.

• "plotbrowser" — Operate on the Plot Browser.

• "propertyeditor" — Operate on the Property Editor.

Example: showplottool("toggle","figurepalette") toggles the state of the Figure Palette in the current figure.

state — Plot tool state

"on" | "off" | "toggle"

Plot tool state, specified as one of these values:

• "on" — Show plot tool.

• "off" — Hide plot tool.

• "toggle" — Switch the plot tool state between the "on" and "off" states.

Example: showplottool("on","propertyeditor") shows the Property Editor plot tool on the current figure.

fig — Target figure

Figure object

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

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

Alternatives

Select the Figure Palette, Plot Browser, and Property Editor options from the View menu of a figure window.

Version History

Introduced before R2006a

R2022a: showplottool behavior will change

The behavior of showplottool will change in a future release.

• Syntaxes opening the figurepalette tool will start plot edit mode in a future release.

• Syntaxes opening the propertyeditor tool will open the Property Inspector and start plot edit mode in a future release.

• Syntaxes opening the plotbrowser tool will expand the Object Browser in the Property Inspector and start plot edit mode in a future release.

Alternatively, interactively modify graphics object properties by using inspect to launch the Property Inspector.