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="set" xml:lang="en">
15
<refname>set</refname>
16
<refpurpose>Ajusta um valor de propriedade de uma objeto entidade gr�fica
17
ou de um objeto Interface do Usu�rio (User Interface)
21
<title>Seq��ncia de Chamamento</title>
22
<synopsis>set(prop,val)
29
<title>Par�metros</title>
34
<para>manipulador da entidade da qual a propriedade nomeada se
35
deseja ajustar, <literal>h</literal> pode ser um vetor de
36
manipuladores, em tal caso, ser�o ajustados valores de propriedades
37
para todos os objetos identificados por h
44
<para>string, nome da propriedade a ser ajustada. </para>
50
<para>valor a ser dado � propriedade</para>
56
<title>Descri��o</title>
57
<para>Esta rotina pode ser utilizada para se recuperar o valor de uma
58
propriedade especificada de uma entidade de gr�ficos ou objeto GUI. Neste
59
caso, � equivalente a se usar o operador ponto ('.') em um manipulador.
60
Por exemplo, <literal>set(h,"background",5)</literal> � equivalente a
61
<literal>h.background = 5</literal>.
63
<para>Nomes de propriedades s�o strings. O tipo do valor ajustado dependo
64
do tipo do manipulador e da propriedade.
67
Para obter a lista de todas as propriedade existentes ver <link linkend="graphics_entities">graphics_entities</link> ou <link linkend="uicontrol">uicontrol</link> para objetos de Interface do
71
<literal>set</literal> tamb�m pode ser chamado com apenas uma
72
propriedade como argumento. Neste caso, a propriedade deve ser uma das
77
<term>current_entity or hdl</term>
80
<literal>set('current_entity',h)</literal> ou
81
<literal>set('hdl',h)</literal> ajusta uma nova entidade como a
82
corrente. Neste caso, o valor deve ser um manipulador
88
<term>current_figure</term>
91
<literal>set('current_figure',fig)</literal> ajusta uma nova
92
figura como a corrente. � equivalente a <link linkend="scf">scf</link>. Neste caso, o valor deve ser um
98
<term>current_axes</term>
101
<literal>set('current_axes',axes)</literal> ajusta novos
102
eixos como os correntes. � equivalente a <link linkend="sca">sca</link>. Neste caso, o valor deve ser um
109
<literal>set</literal> tamb�m pode ser chamado com manipuladores
110
gr�ficos e com propriedades como argumentos. O manipulador deve ser de uma
111
figura padr�o ou de eixos padr�es. A propriedade deve ser
112
<literal>"default_values"</literal>. Neste caso, a entidade padr�o �
113
reajustada para os valores que possu�a na inicializa��o do Scilab.
114
<literal>set("default_values",h)</literal> equivale a <link linkend="sda">sda</link> ou <link linkend="sdf">sdf</link>.
118
<title>Exemplos</title>
119
<programlisting role="example"><![CDATA[
15
<refname>set</refname>
16
<refpurpose>Ajusta um valor de propriedade de uma objeto entidade gr�fica
17
ou de um objeto Interface do Usu�rio (User Interface)
21
<title>Seq��ncia de Chamamento</title>
22
<synopsis>set(prop,val)
29
<title>Par�metros</title>
34
<para>manipulador da entidade da qual a propriedade nomeada se
35
deseja ajustar, <literal>h</literal> pode ser um vetor de
36
manipuladores, em tal caso, ser�o ajustados valores de propriedades
37
para todos os objetos identificados por h
44
<para>string, nome da propriedade a ser ajustada. </para>
50
<para>valor a ser dado � propriedade</para>
56
<title>Descri��o</title>
57
<para>Esta rotina pode ser utilizada para se recuperar o valor de uma
58
propriedade especificada de uma entidade de gr�ficos ou objeto GUI. Neste
59
caso, � equivalente a se usar o operador ponto ('.') em um manipulador.
60
Por exemplo, <literal>set(h,"background",5)</literal> � equivalente a
61
<literal>h.background = 5</literal>.
63
<para>Nomes de propriedades s�o strings. O tipo do valor ajustado dependo
64
do tipo do manipulador e da propriedade.
67
Para obter a lista de todas as propriedade existentes ver <link linkend="graphics_entities">graphics_entities</link> ou <link linkend="uicontrol">uicontrol</link> para objetos de Interface do
71
<literal>set</literal> tamb�m pode ser chamado com apenas uma
72
propriedade como argumento. Neste caso, a propriedade deve ser uma das
77
<term>current_entity or hdl</term>
80
<literal>set('current_entity',h)</literal> ou
81
<literal>set('hdl',h)</literal> ajusta uma nova entidade como a
82
corrente. Neste caso, o valor deve ser um manipulador
88
<term>current_figure</term>
91
<literal>set('current_figure',fig)</literal> ajusta uma nova
92
figura como a corrente. � equivalente a <link linkend="scf">scf</link>. Neste caso, o valor deve ser um
98
<term>current_axes</term>
101
<literal>set('current_axes',axes)</literal> ajusta novos
102
eixos como os correntes. � equivalente a <link linkend="sca">sca</link>. Neste caso, o valor deve ser um
109
<literal>set</literal> tamb�m pode ser chamado com manipuladores
110
gr�ficos e com propriedades como argumentos. O manipulador deve ser de uma
111
figura padr�o ou de eixos padr�es. A propriedade deve ser
112
<literal>"default_values"</literal>. Neste caso, a entidade padr�o �
113
reajustada para os valores que possu�a na inicializa��o do Scilab.
114
<literal>set("default_values",h)</literal> equivale a <link linkend="sda">sda</link> ou <link linkend="sdf">sdf</link>.
118
<title>Exemplos</title>
119
<programlisting role="example"><![CDATA[
121
121
set("auto_clear","off") ;
122
122
// Exemple of a Plot 2D
139
139
p3= a.children(1).children;
140
140
set([a p1 p2 p3],"foreground",5)
141
141
]]></programlisting>
144
<title>Ver Tamb�m </title>
145
<simplelist type="inline">
147
<link linkend="get">get</link>
150
<link linkend="delete">delete</link>
153
<link linkend="copy">copy</link>
156
<link linkend="move">move</link>
159
<link linkend="graphics_entities">graphics_entities</link>
162
<link linkend="uicontrol">uicontrol</link>
144
<title>Ver Tamb�m </title>
145
<simplelist type="inline">
147
<link linkend="get">get</link>
150
<link linkend="delete">delete</link>
153
<link linkend="copy">copy</link>
156
<link linkend="move">move</link>
159
<link linkend="graphics_entities">graphics_entities</link>
162
<link linkend="uicontrol">uicontrol</link>