<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
<MAN>
  <LANGUAGE>eng</LANGUAGE>
  <TITLE>delete</TITLE>
  <TYPE>Scilab Function</TYPE>
  <DATE> 2002</DATE>
  <SHORT_DESCRIPTION name="delete"> 
   delete  a graphic entity and its children.
  </SHORT_DESCRIPTION>
  <CALLING_SEQUENCE>
    <CALLING_SEQUENCE_ITEM>delete(h) </CALLING_SEQUENCE_ITEM>
    <CALLING_SEQUENCE_ITEM>delete(h,&quot;callback&quot;) </CALLING_SEQUENCE_ITEM>
    <CALLING_SEQUENCE_ITEM>delete() </CALLING_SEQUENCE_ITEM>
    <CALLING_SEQUENCE_ITEM>delete(&quot;all&quot;) </CALLING_SEQUENCE_ITEM>
  </CALLING_SEQUENCE>
  <PARAM>
    <PARAM_INDENT>
      <PARAM_ITEM>
        <PARAM_NAME>h</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: a handle, the handle of the entity  to delete. <VERB>h</VERB> can be a vector of
     handles, in which case all objects identified by h(i) will be deleted.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
      <PARAM_ITEM>
        <PARAM_NAME>&quot;all&quot;  </PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: string keyword (optional).</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
    </PARAM_INDENT>
  </PARAM>
  <DESCRIPTION>
    <P>
    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 <VERB>delete</VERB> removes the
    current entity. With <VERB>&quot;all&quot;</VERB> argument it deletes
    all the entities of the current figure.</P>
    <P> 
    The <VERB>&quot;callback&quot;</VERB> argument is not yet handled.</P>
  </DESCRIPTION>
  <EXAMPLE>
<![CDATA[

  set("figure_style","new") // select entity based graphics  
  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

 ]]>
  </EXAMPLE>
  <SEE_ALSO>
    <SEE_ALSO_ITEM>
      <LINK>get</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>set</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>copy</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>move</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>graphics_entities</LINK>
    </SEE_ALSO_ITEM>
  </SEE_ALSO>
  <AUTHOR> Djalel ABDEMOUCHE</AUTHOR>
</MAN>
