<< fplot2d graphics hist3d >>
removed >> removed > 6-1-1 > graphics > get_figure_handle

get_figure_handle

get a figure handle from its id

Syntax

f = get_figure_handle(figure_id)

Arguments

figure_id

Integer, id of the figure to retrieve.

f

Handle of the corresponding figure.

Description

get_figure_handle function allows to retrieve the handle of a graphic figure knowing its id. If a figure with the specified id exists the function returns it. Otherwise is returns an empty matrix.

Examples

// create some figures
scf(0);
scf(5);
scf(12);

// get handle on the figure with id 5
f5 = get_figure_handle(5);
// current figure remains the one with id 12
gcf()

// get a non existing figure
f42 = get_figure_handle(42);

See also

History

VersionDescription
6.1.0 get_figure_handle(n) is declared obsolete. findobj("figure_id",n) is used instead.
6.1.1 get_figure_handle() will be removed in the next Scilab version.

<< fplot2d graphics hist3d >>