findobj

Encontra objetos gráficos visíveis por valores de propriedades.

Categoria: Graphics > Graphics Objects

Sintaxe

h = findobj

Retorna a raiz e todos os objetos visíveis.

h = findobj(Name, Value)

Retorna objetos de qualquer lugar cuja propriedade coincide.

h = findobj(parent, Name, Value)

Pesquisa apenas parent e seus descendentes.

h = findobj(parent, '-depth', d, ___)

Limita quantos níveis abaixo de parent são pesquisados.

Descrição

Um uso comum é escolher uma linha de um gráfico por Tag ou DisplayName para alterá-la depois. Objetos com HandleVisibility em 'off' são ignorados; use findall para incluí-los.

Argumentos de entrada

parent
Figura, eixos ou outro objeto onde pesquisar.
Name, Value
Propriedade e valor a casar; vários pares são combinados com E (use '-or' para OU).

Argumentos de saída

h
Array coluna de handles; vazio se nada coincidir.

Exemplo

Escolher uma linha pela tag

f = figure;
ax = axes;
l1 = plot(1:3, 'Tag', 'one');
hold on
l2 = plot(3:-1:1, 'Tag', 'two');
o = findobj(ax, 'Tag', 'two');
disp(o == l2)
disp(numel(findobj(f, 'Type', 'line')))
Saída
   1
     2

Veja também

findall allchild get set ancestor