다음을 통해 공유


IXamlDiagnostics2::HitTestForXamlRoot 메서드(xamlom.winui.h)

지정된 사각형 내에 속하는 시각적 트리의 모든 요소를 가져옵니다.

구문론

HRESULT HitTestForXamlRoot(
  InstanceHandle instanceHandle,
  RECT           rect,
  unsigned int   *pCount,
  InstanceHandle **ppInstanceHandles
);

매개 변수

instanceHandle

XamlRoot 인스턴스에 대한 핸들입니다.

rect

적중 테스트할 영역입니다.

pCount

찾은 요소의 수입니다.

ppInstanceHandles

찾은 모든 요소를 포함하는 배열입니다.

반환 값

이 메서드가 성공하면 S_OK 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

비고

이 메서드는 rect범위 내에서 instanceHandle전달된 XamlRoot에 대한 적중 테스트를 수행합니다. pCount 적중된 요소의 수와 ppInstanceHandles요소 자체를 반환합니다. 이 메서드는 iXamlDiagnostics::HitTest 대체합니다. 여기서는 주 창이 하나만 있고 그 안에 적중 테스트만 수행된다고 가정합니다.

요구 사항

요구 사항 가치
지원되는 최소 클라이언트 Windows 10 버전 1809(Windows 앱 SDK 1.0 이상 포함)
헤더 xamlom.winui.h