Name

text_properties — Descrição das propriedades da entidade Text (texto)

Descrição

A entidade Text é uma folha na hierarquia de entidades gráficas. Esta entidade define parâmetros para escrita de strings.

parent:

esta propriedade contém o manipulador da raiz. A raiz de uma entidade Text deve ser do tipo "Axes" ou "Compound".

children:

esta propriedade contém um vetor com os galhos do manipulador. Contudo, manipuladores text não possuem galhos correntemente.

visible:

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.

text:

a matriz contendo os strings do objeto. As linhas da matriz são exibidas horizontalmente, e as colunas verticalmente.

alignment:

especifica como os strings serão alinhados em suas colunas. o valor deve ser 'left', 'center' ou 'right'.

data:

este campo é o vetor [x,y,[z]] da origem do texto na unidade de dados dos eixos.

box:

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.

line_mode:

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.

fill_mode:

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.

text_box:

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'.

text_box_mode:

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.

font_foreground:

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).

foreground:

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).

background:

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).

font_size:

é 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.

font_style:

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.

fractional_font:

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.

font_angle:

esta propriedade determina a orientação do string. Especifica o valor da rotação em graus.

clip_state:

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.

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).

user_data:

este campo pode ser utilizado para armazenar qualquer variável Scilab na estrutura de dados da entidade texto e recuperá-la.

Exemplos

 
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
 

Ver Também

set, get, delete, xtitle, graphics_entities

Autor

Djalel ABDEMOUCHE, Jean-Baptiste SILVY