ancestor

Encontra o objeto envolvente mais próximo de um tipo dado, como os eixos ou a figura de uma linha.

Categoria: Graphics > Graphics Objects

Sintaxe

p = ancestor(h, type)

Sobe a partir de h e retorna o primeiro ancestral do tipo dado.

p = ancestor(h, type, 'toplevel')

Retorna o ancestral mais alto desse tipo em vez do mais próximo.

Descrição

ancestor segue a cadeia de Parent para cima até encontrar um objeto do tipo pedido. Se o próprio h tem esse tipo, ele é devolvido sem mudança. É útil em callbacks, onde o objeto de origem é conhecido mas seus eixos ou figura não.

Argumentos de entrada

h
Handle gráfico ou array de handles.
type
Nome do tipo, como 'axes' ou 'figure', ou um cell array de nomes.

Argumentos de saída

p
Handle do ancestral, ou um array vazio se nenhum corresponder.

Exemplo

Eixos e figura de uma linha

f = figure;
ax = axes;
h = plot(1:3);
disp(ancestor(h, 'axes') == ax)
disp(ancestor(h, 'figure') == f)
Saída
   1
   1

Veja também

allchild findobj gca gcf get