label_properties

Descrição

A entidade Label é um galho da entidade Axes (de eixos). Quando uma entidade Axes é construída, os manipuladores das entidades Title e Label são criados juntos e são parte das propriedade da entidade Axes. Logo, as propriedades destes sub-objetos são editáveis via o manipulador da entidade Axes (ver gca e gda). Esta entidade define os parâmetros para impressão de rótulos:

parent:

esta propriedade contém o manipulador para a raiz. A raiz de uma entidade Label deve ser do tipo "Axes" .

Note que, por ora, a entidade Label é exclusivamente utilizada na construção de title, x_label, y_label e z_label.

visible:

este campo contém o valor da propriedade visible para a entidade. Pode ser "on" ou "off" . Por padrão, o rótulo é visível, o valor da propriedade é "on". Se "off" o rótulo não é impresso na tela.

text:

Matrix of texts of the label. So, a label can have multiple rows or/and columns of text. Leading and trailing blanks are trimmed. In their columns, texts are left-justified. LaTeX expressions delimited with "$...$" are supported.

font_foreground:

este campo contém o índice de cor utilizado para exibir o rótulo .text. Seu valor deve ser um índice de cor (relativo ao mapa de cores corrente).

foreground:

este campo contém a cor utilizada para exibir o rótulo e a linha ao redor da caixa, se houver. Deve ser um índice de cor (relativo ao mapa de cores corrente).

background:

este campo contém a cor a ser usada para preencher a caixa, se houver. Deve ser um índice de cor (relativo ao mapa de cores corrente).

fill_mode:

This is actually a "box mode" property. "on" draws a box around the block of text of the label. Otherwise, no block's edge is drawn. The .foreground value is the color's index of the edge. The .background value is the index of the filling color.

font_style:

especifica a fonte a ser utilizada para exibir o rótulo. É um inteiro positivo fazendo referência uma das fontes carregadas. Seu valor deve estar entre 0, fazendo referência à primeira fonte, e o número de fontes carregadas menos um, fazendo referência à última fonte. Para mais informações, veja graphics_fonts.

font_size:

é um escalar especificando o tamanho dos caracteres exibidos. Se a propriedade .fractional_font for "off", apenas a parte inteira é utilizada. Para mais informações, veja graphics_fonts.

fractional_font:

esta propriedade especifica se o texto será utilizado utilizando-se tamanhos de fonte fracionários. Seu valor deve ser "on" ou "off". Se "on", o valor em ponto flutuante de .font_size é utilizado para a exibição e evita-se o serrilhamento da fonte. Se "off", apenas a parte inteira é utilizada e a fonte não é suavizada.

font_angle:

Clockwise angle of the label's block, in degrees, horizontal = 0°. The lower-left corner of the horizontal box is used as pivot (fixed point). Setting .font_angle automatically sets .auto_rotation="off".

auto_rotation:

se "on", o Scilab computa automaticamente o melhor ângulo de rotação para a exibição do rótulo. Se "off", o rótulo pode ser girado manualmente através da propriedade .font_angle.

position:

Vector of coordinates of the label's anchor, in data unit. The anchor is the lower-left corner of the horizontal box of the label. Setting the .position automatically sets .auto_position="off".

auto_position:

se "on", o Scilab computa automaticamente a melhor posição para a exibição do rótulo na janela de gráficos. Se "off", o rótulo pode ser posicionado manualmente através da propriedade .position.

Exemplos

a=get("current_axes");
a.title
type(a.title)
plot3d()
a.x_label
a.y_label
a.z_label
xtitle("Meu título","meu rótulo de eixo x", "Volume","Mês")

t=a.title;
t.foreground=9;
t.font_size=5;
t.font_style=5;
t.text="SCILAB";

x_label=a.x_label;
x_label.text=" Peso"
x_label.font_style= 5;
a.y_label.foreground = 12;

Ver Também

• xlabel ylabel zlabel — sets or updates the x-axis label or/and its properties
• xtitle — adidciona títulos a janelas de gráficos
• title — displays a title above a graphic axes, or updates its properties.
• xstring — imprime strings
• xlfont — carrega uma fonte em um contexto gráfico ou pergunta a fonte carregada
• color — Retorna o identificador de uma cor
• set — Ajusta um valor de propriedade de uma objeto entidade gráfica ou de um objeto Interface do Usuário (User Interface)
• text_properties — description of the Text entity properties
• axes_properties — descrição das propriedades de entidades Axes (de eixos)

Histórico