`text`

Escreve texto em uma posição dos eixos, em coordenadas de dados.

Categoria: Graphics > Formatting and Annotation

Sintaxe

text(x, y, txt)

Escreve txt com a âncora no ponto (x, y).

text(x, y, z, txt)

Posiciona o texto em eixos 3-D.

text(___, Name, Value)

Define propriedades como 'FontSize', 'Color' ou 'HorizontalAlignment'.

t = text(___)

Retorna o objeto de texto.

Descrição

O texto é ancorado no ponto dado e, por padrão, alinhado à esquerda. Faz parte dos eixos, portanto acompanha os dados quando os limites mudam. Usos comuns são identificar pontos individuais, rotular picos e marcar regiões de um gráfico.

A marcação TeX, como \alpha ou x^2, é interpretada por padrão.

Argumentos de entrada

x, y, z: Coordenadas da âncora, em unidades de dados. Vetores posicionam vários rótulos de uma vez.
txt: Texto, string array ou cell array com uma entrada por posição.

Argumentos de saída

t: Objeto de texto, classe matlab.graphics.primitive.Text, com as propriedades String e Position.

Exemplo

Rotular o máximo

x = 0:0.1:6;
y = sin(x);
plot(x, y)
[m, i] = max(y);
t = text(x(i), m, ' max', 'VerticalAlignment', 'bottom');
t.String
t.Position

Saída

ans = ' max'
ans = 1×3

    1.6000    0.9996         0

Veja também

title xlabel annotation line