guihandles

Figure의 자식 객체 검색

구문

s = guihandles(obj)

s = guihandles

설명

참고

guihandles를 사용하는 것보다 findobj 또는 findall을 사용하여 Figure의 하위 객체를 찾는 방법이 권장됩니다. 권장된 함수를 사용하면 특정 속성값이나 정규 표현식을 통해 반환되는 객체의 유형을 제어할 수 있습니다. 그래픽스 객체의 자식 객체 검색에 대한 자세한 내용은 객체 찾기 항목을 참조하십시오.

s = guihandles(obj)는 Tag 속성이 비어 있지 않은 Figure의 자식 객체를 반환합니다.

• obj가 Figure 객체인 경우 guihandles는 지정된 Figure의 자식 객체를 반환합니다.

• obj가 Figure의 그래픽스 객체인 경우 guihandles는 obj가 포함된 Figure의 자식 객체를 반환합니다.

s = guihandles는 현재 Figure에서 Tag 속성이 비어 있지 않은 모든 자식 객체를 반환합니다. Figure가 없는 경우 MATLAB^®은 새 Figure를 만들어 현재 Figure로 설정합니다.

예제

UI Figure에서 태그가 지정된 자식 객체 가져오기

먼저 UI Figure를 만든 다음 UI Figure에 UI 컴포넌트를 추가합니다.

f = uifigure;
p = uipanel(f,"Position",[80 10 450 400]);
b1 = uibutton(f,"Text","One","Position",[10 40 60 30]);
b2 = uibutton(f,"Text","Two","Position",[10 10 60 30]);
b3 = uibutton(p,"Text","Three","Position",[10 10 60 30]);

일부 UI 컴포넌트에 Tag 속성을 사용하여 태그를 추가합니다.

p.Tag = "panel";
b1.Tag = "button";

guihandles 함수를 사용하여 UI Figure의 객체를 쿼리합니다. 대부분의 UI 컴포넌트에는 기본적으로 Tag 속성이 비어 있기 때문에 패널 p와 버튼 b1만 출력 구조체에 포함됩니다. 구조체 필드 이름은 자식 객체의 Tag 속성값과 일치합니다.

s = guihandles(f)

s = struct with fields:
    button: [1×1 Button]
     panel: [1×1 Panel]

구조체 필드 이름을 사용하여 UI 컴포넌트와 특정 컴포넌트 속성에 액세스합니다. 예를 들어, 첫 번째 버튼에 표시된 텍스트에 액세스해 보겠습니다.

s.button.Text

ans = 'One'

또한 Figure 객체의 자식 컴포넌트를 guihandles에 전달하여 해당 컴포넌트가 포함된 Figure의 자식 객체를 가져올 수도 있습니다. 예를 들어, Panel 객체를 함수에 전달하면 동일한 구조체가 반환됩니다.

s2 = guihandles(p)

s2 = struct with fields:
    button: [1×1 Button]
     panel: [1×1 Panel]

입력 인수

obj — 그래픽스 객체

그래픽스 객체

그래픽스 객체 Figure 객체 또는 Figure의 자식 객체를 지정할 수 있습니다.

출력 인수

s — Figure 내 객체

구조체

Tag 속성이 비어 있지 않은 Figure 내 객체로, 구조체로 반환됩니다. 구조체의 필드 이름은 Figure에 배치된 UI 컴포넌트 또는 그래픽스 객체의 Tag 속성값과 일치합니다. guihandles는 유효한 변수 이름이 아닌 Tag 속성값이 있는 객체를 반환하지 않습니다.

• 하나의 객체에만 Tag 속성이 지정된 경우 태그와 연결된 필드의 값이 그래픽스 객체를 포함합니다.

• 여러 객체가 동일한 Tag 속성을 가진 경우 태그와 연결된 필드의 값은 그래픽스 객체로 구성된 벡터를 포함합니다.

guihandles는 HandleVisibility 속성이 "off"로 설정된 경우에도 객체를 반환합니다. 숨겨진 객체에 대한 자세한 내용은 Figure와 좌표축에 대한 액세스 방지하기 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

참고 항목

함수

• findobj | findall | guidata

도움말 항목

• 속성값 액세스