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

Change language to:
Français - 日本語 - Português - Русский

Please note that the recommended version of Scilab is 2024.1.0. This page might be outdated.
However, this page did not exist in the previous stable version.

Scilab Help >> Graphics > handle > relocate_handle


Move handles inside the graphic hierarchy. This function is obsolete.

Calling Sequence

relocate_handle( movedHandles, parent )



Vector of relocated handles.


New parent of the handles.


The relocate_handle function allows to move handles from their current locations in the graphical hierarchy to another. All the moved entities are relocated under the same parent handle specified with the parent parameter.

Since not every handles are compatible with each others, some restrictions exist when relocationg handles. For examples, it is not allowed to move an axes handle under a polyline. More information about compatibility can be found in the graphics_entities page.

This routine is particularly useful to move an object from an axes entity to an other or to move axes from figures handles.


x = 0:10 ;

// plot a first polyline
plot(x,x^2) ;
axes1 = gca() ;
poly1 = gce() ;

// plot a second in an other window
scf() ;
plot( x,x )  ;
axes2 = gca() ;
poly2 = gce()  ;
poly2bis = copy( poly2 ) ; // make a copy of the polyline

// put both polyline in the same window
relocate_handle( poly2bis, axes1 ) ;

See Also

  • graphics_entities — description of the graphics entities data structures
  • copy — copy a graphics entity.
  • delete — delete a graphic entity and its children.
  • swap_handles — Permute two handles in the graphic Hierarchy.


5.5.0 Function tagged as obsolete. Will be removed in 5.5.1.
Report an issue
<< is_handle_valid handle swap_handles >>

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 Oct 02 13:46:52 CEST 2014