delete

delete a graphic entity and its children.

Calling Sequence

delete(h)
delete(h,"callback")
delete()
delete("all")

Arguments

:h a handle, the handle of the entity to delete. h can be a vector

of handles, in which case all objects identified by h(i) will be deleted.

: :”all” string keyword (optional). :

Description

This routine can be used to delete a graphics entity identified by the handle given as argument. In this case, All children of this graphics entity will be deleted. Without any argument delete removes the current entity. With “all” argument it deletes all the entities of the current figure.

The “callback” argument is not yet handled.

Examples

`subplot`_(211);
t=1:10;`plot2d`_(t,t.^2),
`subplot`_(223);
`plot3d`_();
`subplot`_(224);
`plot2d`_();
`xfrect`_(1,0,3,1);
a=`get`_("current_axes")
delete(); //delete the graphics object newly created
delete(a.children); //delete all children of the current axes
delete(a); //delete the axes
delete("all"); //delete all the graphics objects of the figure

See Also

• get Retrieve a property value from a graphics entity or an User Interface object.
• set set a property value of a graphic entity object or of a User Interface object.
• copy copy a graphics entity.
• move move, translate, a graphic entity and its children.
• is_handle_valid Check wether a set of graphic handles is still valid.
• graphics_entities description of the graphics entities data structures
• xdel delete a graphics window
• close close a figure