label_properties Descrição de propriedades da entidade Label (rótulo)

## 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
- xtitle
- title
- xstring
- xlfont
- color
- set
- text_properties
- axes_properties

## Histórico

5.2 LaTeX expressions delimited with "$..$" are now supported