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

findobj

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

구문

findobj
h = findobj
h = findobj('PropertyName',PropertyValue,...)
h = findobj('PropertyName',PropertyValue,'-logicaloperator', 'PropertyName',PropertyValue,...)
h = findobj('-regexp','PropertyName','regexp',...)
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','regexp',...)는 PropertyName 속성값을 regexp 함수에 다음처럼 전달하는 것으로 정규 표현식을 사용하고 객체를 일치시킵니다.

regexp(PropertyValue,'regexp')

일치가 발생하면 findobj는 객체 핸들을 반환합니다. MATLAB^®이 정규 표현식을 사용하는 방법에 대한 정보는 regexp 함수를 참조하십시오. '-regexp' 옵션이 모든 유형의 속성에 사용되지는 않습니다.

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 이전에 개발됨