isgraphics

유효한 그래픽스 객체 핸들인 경우 True

구문

tf = isgraphics(H)

tf = isgraphics(H,type)

설명

tf = isgraphics(H)는 H의 요소가 유효한 그래픽스 객체이면 true를 반환하고, 유효한 그래픽스 객체가 아니거나 삭제된 그래픽스 객체이면 false를 반환합니다.

tf = isgraphics(H,type)은 H의 요소가 type 인수로 지정된 유형의 유효한 그래픽스 객체이면 true를 반환합니다. 객체 유형은 객체의 Type 속성에 포함된 값입니다.

예제

유효한 핸들인지 테스트

플롯을 만들고 핸들 배열을 반환합니다. 배열에 유효한 핸들이 있는지 테스트합니다.

H = plot(rand(5));

isgraphics(H)

ans = 5×1 logical array

   1
   1
   1
   1
   1

핸들 유형 확인 테스트

플롯을 만들고 핸들 배열을 반환합니다. 다른 그래픽스 객체와 결합한 다음 Line 유형의 핸들이 있는지 테스트합니다.

H = plot(rand(5)); 

a = [H;gca;gcf]; 
isgraphics(a,'line')

ans = 7×1 logical array

   1
   1
   1
   1
   1
   0
   0

입력 인수

H — 입력 변수 또는 표현식

그래픽스 객체 배열

그래픽스 객체 핸들로 평가되는 입력 변수 또는 표현식입니다.

type — 객체 유형

문자형 벡터 | string형 스칼라

객체 유형으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 객체의 유형은 객체의 Type 속성 값입니다.

출력 인수

tf — 결과

논리형 배열

결과값으로, 논리형 배열로 반환됩니다. 값 1은 유효한 입력 배열 요소를 나타내고, 값 0은 유효하지 않은 요소를 나타냅니다. 입력 배열이 비어 있으면 결과값은 빈 배열이 됩니다.

버전 내역

R2014b에 개발됨

R2024b: 다차원 배열을 입력값으로 전달하면 동일한 크기의 출력값이 반환됨

3개 이상의 차원을 갖는 배열을 입력값으로 전달하면 동일한 크기의 배열이 반환됩니다. 이전에는 isgraphics가 입력값에 3개 이상의 차원이 있는 경우 2차원 배열을 반환했습니다. 더 높은 차원이 두 번째 차원으로 축소되었습니다. 예를 들어 입력값이 2×4×5 배열이면 출력값은 2×20 배열이었습니다.

스칼라, 1차원 또는 2차원 배열을 둘 중 어느 한 함수에 전달하면 출력값은 이전 릴리스에서와 동일한 크기로 반환됩니다.

all 또는 any 함수에 대한 중첩 호출을 사용하고 있다면, 출력값의 형태를 유지할 목적으로 중첩 함수를 호출하는 대신 "all" 인수를 사용하도록 코드를 업데이트하십시오.

예를 들어 R2024a에서 다음 코드는 스칼라 논리값을 반환합니다. R2024b에서 이 코드는 논리값으로 구성된 1×1×4 배열을 반환합니다.

h = gobjects(2,3,4);
all(all(isgraphics(h)))

스칼라 출력값을 그대로 유지하려면 "all" 인수와 함께 all 함수를 한 번 호출하십시오. 그러면 스칼라 논리값이 반환됩니다.

h = gobjects(2,3,4);
all(isgraphics(h),"all")

참고 항목

함수

• ishghandle | isa

도움말 항목

• 그래픽스 객체 핸들