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:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:id="relocate_handle" xml:lang="en">
15
<refname>relocate_handle</refname>
16
<refpurpose>Movimenta��o de manipuladores dentro da hierarquia
21
<title>Seq��ncia de Chamamento</title>
22
<synopsis>relocate_handle( movedHandles, parent )</synopsis>
25
<title>Par�metros</title>
28
<term>movedHandles</term>
30
<para>vetor de manipuladores realocados</para>
36
<para>nova raiz dos manipuladores</para>
42
<title>Descri��o</title>
43
<para>A fun��o relocate_handle permite mover manipuladores das suas
44
localiza��es em uma hierarquia gr�fica para outra localiza��o. Todas as
45
entidades s�o realocadas sob o mesmo manipulador raiz especificado pelo
46
par�metro <emphasis role="bold">parent</emphasis>.
48
<para>J� que n�o s�o todos os manipuladores que s�o compat�veis com todos
49
os outros, existem algumas restri��es ao se realocar manipuladores. Por
50
exemplo, n�o � permitido mover um manipulador Axes sob um manipulador
51
Polyline. Para mais informa��es sobre compatibilidade veja a p�gina <link linkend="graphics_entities">graphics_entities</link>.
53
<para>Esta rotina � particularmente �til para se mover um objeto de uma
54
entidade Axes para outra, ou para se move objetos Axes de uma entidade
59
<title>Exemplos</title>
60
<programlisting role="example"><![CDATA[
15
<refname>relocate_handle</refname>
16
<refpurpose>Movimenta��o de manipuladores dentro da hierarquia
21
<title>Seq��ncia de Chamamento</title>
22
<synopsis>relocate_handle( movedHandles, parent )</synopsis>
25
<title>Par�metros</title>
28
<term>movedHandles</term>
30
<para>vetor de manipuladores realocados</para>
36
<para>nova raiz dos manipuladores</para>
42
<title>Descri��o</title>
43
<para>A fun��o relocate_handle permite mover manipuladores das suas
44
localiza��es em uma hierarquia gr�fica para outra localiza��o. Todas as
45
entidades s�o realocadas sob o mesmo manipulador raiz especificado pelo
46
par�metro <emphasis role="bold">parent</emphasis>.
48
<para>J� que n�o s�o todos os manipuladores que s�o compat�veis com todos
49
os outros, existem algumas restri��es ao se realocar manipuladores. Por
50
exemplo, n�o � permitido mover um manipulador Axes sob um manipulador
51
Polyline. Para mais informa��es sobre compatibilidade veja a p�gina <link linkend="graphics_entities">graphics_entities</link>.
53
<para>Esta rotina � particularmente �til para se mover um objeto de uma
54
entidade Axes para outra, ou para se move objetos Axes de uma entidade
59
<title>Exemplos</title>
60
<programlisting role="example"><![CDATA[
63
63
// esbo�ando uma primeira poligonal
75
75
// pondo ambas as poligonais na mesma janela
76
76
relocate_handle( poly2bis, axes1 ) ;
77
77
]]></programlisting>
79
<refsection role="see also">
80
<title>Ver Tamb�m</title>
81
<simplelist type="inline">
83
<link linkend="graphics_entities">graphics_entities</link>
86
<link linkend="copy">copy</link>
89
<link linkend="delete">delete</link>
92
<link linkend="swap_handles">swap_handles</link>
79
<refsection role="see also">
80
<title>Ver Tamb�m</title>
81
<simplelist type="inline">
83
<link linkend="graphics_entities">graphics_entities</link>
86
<link linkend="copy">copy</link>
89
<link linkend="delete">delete</link>
92
<link linkend="swap_handles">swap_handles</link>