# captions

Impressão de legendas de gráficos

## Seqüência de Chamamento

    hl=captions(h, strings [,location])

## Parâmetros

h

  vetor de manipuladores de entidades Polyline

strings

  n-vetor de strings, strings(i) é a legenda da i-ésima poligonal

hl

  um manipulador do tipo "`Legend`", pontos para a estrutura contendo todas as informações das legendas (ver legend_properties).

location

  string com possíveis valores

  - `"in_upper_right"` : as legendas são exibidas no canto superior direito da caixa de eixos

  - `"in_upper_left"`: as legendas são exibidas no canto superior esquerdo da caixa de eixos

  - `"in_lower_right"`: as legendas são exibidas no canto inferior direito da caixa de eixos

  - `"in_lower_left"`: as legendas são exibidas no canto inferior esquerdo da caixa de eixos

  - `"out_upper_right"`: as legendas são exibidas à direita do canto superior direito da caixa de eixos

  - `"out_upper_left"`: as legendas são exibidas à esquerda do canto superior esquerdo da caixa de eixos

  - `"out_lower_right"`: as legendas são exibidas à direita do canto inferior direito da caixa de eixos

  - `"out_lower_left"`: as legendas são exibidas à esquerda do canto inferior esquerdo da caixa de eixos

  - `"upper_caption"`: as legendas são exibidas acima do canto superior esquerdo da caixa de eixos

  - `"lower_caption"`: as legendas são exibidas abaixo do canto inferior esquerdo da caixa de eixos. Esta opção corresponde ao argumento `leg` de plot2d

  - `"by_coordinates"`: o canto superior esquerdo da caixa das legendas é dada pelo campo "position" da estrutura de dados associada. As posições `x` e `y` são fornecidas como frações dos tamanhos de `axes_bounds.`

## Descrição

Coloca legendas no esboço corrente no canto inferior esquerdo da janela gráfica utilizando-se os strings especificados como rótulos. `captions` prefixa rótulos por uma nova chamada às poligonais correspondentes. O tipo e propriedades são recuperados do dado manipulador:

A função `captions` cria uma estrutura de dados Legend.

Há no máximo uma `Legend` associada a cada entidade Axes. Se a função caption for chamada novamente enquanto `Legend` ainda existe, a legenda antiga é apagada.

## Exemplos

    t=0:0.1:2*%pi;
    a=gca();a.data_bounds=[t(1) -1.8;t($) 1.8];
    a.margins(4)=0.2;

    plot2d(t,[cos(t'),cos(2*t'),cos(3*t')],[1,2 3]);
    e=gce();
    e.children(1).thickness=3;
    e.children(2).line_style=4;

    hl=captions(e.children,['cos(t)';'cos(2*t)';'cos(3*t)']);
    hl=captions(e.children,['cos(t)';'cos(2*t)';'cos(3*t)'],'in_upper_right');

    hl.legend_location='in_upper_right'
    hl.fill_mode='on';

## Ver Também

- plot2d
- legend
- polyline_properties
- legend_properties