`legend`

Adiciona uma legenda que nomeia as séries de dados dos eixos.

Categoria: Graphics > Formatting and Annotation

Sintaxe

legend(label1, ..., labelN)

Rotula as séries plotadas, em ordem, com os textos dados.

legend(labels)

Obtém os rótulos de um cell array ou string array.

legend

Cria uma legenda usando o DisplayName de cada série, ou data1, data2 e assim por diante.

legend(___, 'Location', loc)

Posiciona a legenda, por exemplo 'southwest' ou 'northeastoutside'.

legend off

Remove a legenda. legend boxoff oculta apenas a moldura.

lgd = legend(___)

Retorna o objeto da legenda.

Descrição

A legenda lista uma entrada por série dos eixos, mostrando uma amostra da linha ou do marcador ao lado do rótulo. Com rótulos explícitos, eles são associados às séries na ordem de desenho; com a propriedade DisplayName definida ao plotar, legend sem argumentos usa esses nomes e continua correta se a ordem mudar.

Chame legend depois que as séries existirem, pois a legenda não é atualizada por séries acrescentadas depois, a menos que seja solicitada de novo.

Argumentos de entrada

label1, ..., labelN: Rótulos de texto, um por série, na ordem em que as séries foram desenhadas.
Location: Posição da legenda. O padrão é 'northeast'.

Argumentos de saída

lgd: Objeto da legenda, classe matlab.graphics.illustration.Legend, com propriedades como String e Location.

Exemplo

Nomes a partir de DisplayName

x = 0:0.2:6;
plot(x, sin(x), 'DisplayName', 'sin')
hold on
plot(x, cos(x), 'DisplayName', 'cos')
hold off
lgd = legend;
lgd.String

Saída

ans = 1×2 cell

    {'sin'}    {'cos'}

Veja também

plot title xlabel hold colorbar