13
13
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" version="5.0-subset Scilab" xml:lang="en" xml:id="relocate_handle">
15
<refname>relocate_handle</refname>
16
<refpurpose>Move handles inside the graphic
21
<title>Calling Sequence</title>
22
<synopsis>relocate_handle( movedHandles, parent )</synopsis>
25
<title>Arguments</title>
28
<term>movedHandles</term>
30
<para>Vector of relocated handles.</para>
36
<para>New parent of the handles.</para>
42
<title>Description</title>
43
<para>The relocate_handle function allows to move handles from their current
44
locations in the graphical hierarchy to another. All the moved entities
45
are relocated under the same parent handle specified with the
46
<emphasis role="bold">parent</emphasis> parameter.
48
<para>Since not every handles are compatible with each others, some
49
restrictions exist when relocationg handles. For examples, it is not
50
allowed to move an axes handle under a polyline. More information about
51
compatibility can be found in the <link linkend="graphics_entities">graphics_entities</link> page.
53
<para>This routine is particularly useful to move an object from an axes
54
entity to an other or to move axes from figures handles.
58
<title>Examples</title>
59
<programlisting role="example"><![CDATA[
15
<refname>relocate_handle</refname>
16
<refpurpose>Move handles inside the graphic
21
<title>Calling Sequence</title>
22
<synopsis>relocate_handle( movedHandles, parent )</synopsis>
25
<title>Arguments</title>
28
<term>movedHandles</term>
30
<para>Vector of relocated handles.</para>
36
<para>New parent of the handles.</para>
42
<title>Description</title>
43
<para>The relocate_handle function allows to move handles from their current
44
locations in the graphical hierarchy to another. All the moved entities
45
are relocated under the same parent handle specified with the
46
<emphasis role="bold">parent</emphasis> parameter.
48
<para>Since not every handles are compatible with each others, some
49
restrictions exist when relocationg handles. For examples, it is not
50
allowed to move an axes handle under a polyline. More information about
51
compatibility can be found in the <link linkend="graphics_entities">graphics_entities</link> page.
53
<para>This routine is particularly useful to move an object from an axes
54
entity to an other or to move axes from figures handles.
58
<title>Examples</title>
59
<programlisting role="example"><![CDATA[
62
62
// plot a first polyline
74
74
// put both polyline in the same window
75
75
relocate_handle( poly2bis, axes1 ) ;
76
76
]]></programlisting>
78
<refsection role="see also">
79
<title>See Also</title>
80
<simplelist type="inline">
82
<link linkend="graphics_entities">graphics_entities</link>
85
<link linkend="copy">copy</link>
88
<link linkend="delete">delete</link>
91
<link linkend="swap_handles">swap_handles</link>
78
<refsection role="see also">
79
<title>See Also</title>
80
<simplelist type="inline">
82
<link linkend="graphics_entities">graphics_entities</link>
85
<link linkend="copy">copy</link>
88
<link linkend="delete">delete</link>
91
<link linkend="swap_handles">swap_handles</link>