text_properties — Descrição das propriedades da entidade Text (texto)
A entidade Text é uma folha na hierarquia de entidades gráficas. Esta entidade define parâmetros para escrita de strings.
esta propriedade contém o manipulador da raiz. A raiz de uma
entidade Text deve ser do tipo "Axes" ou
"Compound".
esta propriedade contém um vetor com os galhos do manipulador. Contudo, manipuladores text não possuem galhos correntemente.
este campo contém o valor da propriedade
visible para a entidade. Pode ser "on"
ou "off" . Por padrão, o texto é
visível, a propriedade é "on". Se
"off", o texto não é exibido na tela.
a matriz contendo os strings do objeto. As linhas da matriz são exibidas horizontalmente, e as colunas verticalmente.
especifica como os strings serão alinhados em suas colunas. o valor deve ser 'left', 'center' ou 'right'.
este campo é o vetor [x,y,[z]] da origem do
texto na unidade de dados dos eixos.
o valor deste campo pode ser "on" ou
"off". Se "on" uma caixa é
desenhada ao redor do texto com uma linha em sua borda e um plano de
fundo.
esta propriedade booleana permite desenhar apenas o plano de
fundo da caixa quando a propriedade box é
"on". Se line_mode é
"off" , a linha da caixa não é desenhada.
esta propriedade booleana permite desenhar ou não o plano de
fundo da caixa quando a propriedade box é
"on". Se fill_mode for
"off", o plano de fundo da caixa não é
transparente.
um vetor bidimensional especificando o tamanho do retângulo em coordenadas do usuário. O retângulo é utilizado quando a propriedade text_box_mode está ajustada pára 'centered' ou 'filled'.
Pode ter três valores diferentes : 'off', 'centered' ou 'filled'. Se 'off', os strings são exibidos utilizando-se a dada fonte e o campo data especifica a posição do ponto inferior esquerdo do texto. Se 'centered', o texto é exibido no meio do retângulo cujo tamanho é fornecido por text_box. Se 'filled', o tamanho de fonte dos strings será expandido para se preencher o retângulo.
Ao se utilizar os modos 'off' ou 'centered' , o tamanho dos textos se mantém constante sob ampliação. Eles são os melhores modos para se criar anotações em um gráfico. Por outro lado, ao se utilizar o modo 'filled', o tamanho do texto segue a escala gráfica. É então possível ampliar objetos textos.
este campo contém a cor utilizada para exibir os caracteres do texto. O valor deve ser um índice de cor (relativo ao mapa de cores corrente).
este campo contém a cor utilizada para exibir a linha na borda da caixa. O valor deve ser um índice de cores (relativo ao mapa de cores corrente).
este campo contém a cor utilizada para preencher a caixa ao redor do texto. O valor deve ser um índice de cor (relativo ao mapa de cores corrente).
é um escalar especificando o tamanho dos caracteres exibidos.
Se a propriedade fractional_font é
"off" , apenas a parte inteira do valor é
utilzada. Para mais informações, veja graphics_fonts.
especifica a fonte a ser utilizada para exibir os strings. É um inteiro positivo fazendo referência a uma das fontes carregadas. Seu valor deve estar entre 0, referência à primeira fonte, e o número de fontes carregadas menos um, referência à última fonte. Para mais informações, veja graphics_fonts.
Esta propriedade indica se o texto será exibido utilizando-se
tamanhos de fonte fracionários. Pode ser "on" ou
"off". Se "on" o valor em
ponto flutuante de font_size é utilizado para
exibição e retira-se o serrilhamento da fonte. Se
"off" , apenas a parte inteira é utilizada e a
fonte não é suavizada.
esta propriedade determina a orientação do string. Especifica o valor da rotação em graus.
este campo contém o valor da propriedade
clip_state para o texto. O valor de clip_state
pode ser:
"off" significa que o texto não é
recortado.
"cliprf" significa que o texto é
recortado fora da caixa dos eixos.
"on" significa que o texto é recortado
fora do retângulo dado pela propriedade clip_box.
este campo contém o valor da propriedade
clip_box. Seu valor deve ser uma matriz vazia se
clip_state é "off" ou o vetor [x,y,w,h] (ponto
superior esquerdo, largura, altura).
este campo pode ser utilizado para armazenar qualquer variável Scilab na estrutura de dados da entidade texto e recuperá-la.
a=get("current_axes");
a.data_bounds=[0,0;1,1];
a.axes_visible = 'on' ;
xstring(0.5,0.5,"Scilab is not esilaB",0,0)
t=get("hdl") //obtendo o manipulador do novo objeto criado
t.font_foreground=6; // alterando as propriedades da fonte
t.font_size=5;
t.font_style=5;
t.text=["SCILAB","não";"é","esilaB"] ; // alterando
t.font_angle=90 ; // virando os strings
t.text_box = [0,0] ;
t.text_box_mode = 'centered' ; // o texto está agora centrado em [0.5,0.5].
t.alignment = 'center' ;
t.box = 'on' ; // desenhando uma caixa ao redor do texto