이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

findobj

특정 속성을 가진 그래픽스 객체 찾기

구문

findobj
h = findobj
h = findobj('PropertyName',PropertyValue,...)
h = findobj('PropertyName',PropertyValue,'-logicaloperator', 'PropertyName',PropertyValue,...)
h = findobj('-regexp','PropertyName','expression',...)
h = findobj('-property','PropertyName')
h = findobj(objhandles,...)
h = findobj(objhandles,'-depth',d,...)
h = findobj(objhandles,'flat','PropertyName',PropertyValue,...)


설명

findobj는 결과를 변수에 할당하지 않고 root 객체와 root 객체의 모든 자식 항목에 대한 핸들을 반환합니다.

h = findobj는 root 객체와 root 객체의 모든 자식 항목에 대한 핸들을 반환합니다.

h = findobj('PropertyName',PropertyValue,...)는 PropertyName 속성을 가지며 그 속성값이 PropertyValue 값으로 설정된 모든 그래픽스 객체의 핸들을 반환합니다. 여러 속성/값 쌍을 지정할 수 있으며, 이 경우 findobj는 지정된 값을 모두 가진 객체만 반환합니다.

h = findobj('PropertyName',PropertyValue,'-logicaloperator', 'PropertyName',PropertyValue,...)는 속성값 매칭에 논리 연산자를 적용합니다. -logicaloperator로 가능한 값은 다음과 같습니다.

• -and

• -or

• -xor

• -not

논리 연산자에 대한 자세한 내용은 논리 연산 항목을 참조하십시오.

h = findobj('-regexp','PropertyName','expression',...)은 지정된 속성값으로 지정된 정규 표현식을 실행하여 이에 맞는 객체를 찾습니다. 해당 정규 표현식을 충족하는 속성값을 가진 객체가 반환됩니다.

h = findobj('-property','PropertyName')은 지정된 속성을 가진 모든 객체를 찾습니다.

h = findobj(objhandles,...)는 objhandles에 나열된 객체와 이 객체의 모든 자식 항목으로 검색을 제한합니다.

h = findobj(objhandles,'-depth',d,...)는 검색의 깊이를 지정합니다. 깊이 인수 d는 objhandles에서 MATLAB^®이 트래버스(통과)하는 핸들 아래의 수준을 제어합니다. 모든 수준의 디폴트 동작을 가져오려면 d를 inf로 지정합니다. flat 인수를 사용할 때와 동일한 동작을 가져오려면 d를 0으로 지정합니다.

h = findobj(objhandles,'flat','PropertyName',PropertyValue,...)는 objhandles에 나열된 객체로 검색을 제한하고 그 자식 항목은 검색하지 않습니다.

findobj는 핸들이 존재하지 않는 그래픽스 객체를 참조하는 경우 오류를 반환합니다.

findobj는 모든 올바른 속성값과 정확히 일치하는 객체를 검색합니다. 예를 들면 다음과 같습니다.

findobj('Color','r')

위 구문은 Color 속성이 red, r 또는 [1 0 0]으로 설정된 객체를 모두 찾습니다.

그래픽스 객체가 objhandles에서 식별된 여러 객체의 후손인 경우 MATLAB은 findobj가 해당 핸들을 발견할 때마다 이 그래픽스 객체를 검색합니다. 따라서 그래픽스 객체에 대한 암묵적 참조로 해당 핸들이 여러 번 반환될 수 있습니다.

참고

findobj는 HandleVisibility 속성이 'off'로 설정된 그래픽스 객체를 반환하지 않습니다. 자세한 내용은 HandleVisibility 속성 설명을 참조하십시오.

예제

현재 좌표축 내에서의 모든 선 객체를 찾습니다.

h = findobj(gca,'Type','line')

Label이 'foo'로 설정되고 String 속성이 'bar'로 설정된 객체를 모두 찾습니다.

h = findobj('Label','foo','-and','String','bar');

String 속성이 'foo'가 아니고 'bar'도 아닌 객체를 모두 찾습니다.

h = findobj('-not','String','foo','-not','String','bar');

String 속성이 'foo'로 설정되고 Tag 속성이 'button one'으로 설정되고, Color 속성이 'red' 또는 'blue'가 아닌 객체를 모두 찾습니다.

h = findobj('String','foo','-and','Tag','button one',...
	'-and','-not',{'Color','red','-or','Color','blue'})

Tag 속성에 값(값이 빈 문자형 벡터 ''이 아님)이 할당된 객체를 모두 찾습니다.

h = findobj('-regexp','Tag','[^'']')

BackgroundColor 속성이 특정 회색 음영([.7 .7 .7])으로 설정된 현재 Figure의 자식을 모두 찾습니다. 이 명령문은 현재 Figure에서 일치하는 속성값 쌍도 검색합니다.

h = findobj(gcf,'-depth',1,'BackgroundColor',[.7 .7 .7])

참고 항목

copyobj | findall | findobj | gca | gcbo | gcf | gco | get | regexp | set

도움말 항목

• 객체 찾기

R2006a 이전에 개발됨