Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
5.3.2 - English

Change language to:
Français - 日本語 - Português

Please note that the recommended version of Scilab is 2024.0.0. This page might be outdated.
See the recommended documentation of this function

Scilab help >> Graphics > handle > delete

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

Authors

Djalel ABDEMOUCHE

<< copy handle draw >>

Copyright (c) 2022-2023 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Thu May 12 11:44:26 CEST 2011