IInkDisp::HitTestCircle 메서드(msinkaut.h)

완전히 내부에 있거나 알려진 원에 의해 교차되는 InkStrokes 컬렉션을 검색합니다.

구문

HRESULT HitTestCircle(
  [in]          long        X,
  [in]          long        Y,
  [in]          float       radius,
  [out, retval] IInkStrokes **Strokes
);

매개 변수

[in] X

잉크 공간 단위에서 적중 테스트 원의 가운데 x 위치입니다.

[in] Y

잉크 공간 단위에서 적중 테스트 원 중앙의 y 위치입니다.

[in] radius

적중 테스트에서 사용할 원의 반지름(잉크 공간 단위)입니다.

[out, retval] Strokes

이 메서드가 반환될 때 에는 완전히 내부이거나 지정된 원과 교차하는 스트로크 컬렉션이 포함됩니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	성공.
E_POINTER	매개 변수에 잘못된 포인터가 포함되어 있습니다.
E_INK_EXCEPTION	메서드 내에서 예외가 발생했습니다.
E_INVALIDARG	잘못된 표시 핸들입니다.
E_UNEXPECTED	예기치 않은 매개 변수 또는 속성 형식입니다.

설명

스트로크가 원과 교차하면 전체 스트로크가 반환됩니다.

메서드는 전체 펜 너비, 베지어 다듬기(있는 경우) 및 펜 팁의 모양을 포함하여 스트로크에 적용되는 그리기 특성의 전체 집합을 고려하여 교차를 계산합니다.

스트로크 또는 스트로크 컬렉션에서 회전 또는 전단 변환을 수행한 후에는 변환된 x- 좌표와 y- 좌표가 더 이상 원래 좌표와 동심되지 않습니다. 따라서 인수는 radius 또는 y- 좌표에서 x- 계산하면 안 됩니다.

알려진 스트로크가 테스트 영역과 교차하는 지점을 확인하려면 IInkStrokeDisp 개체의 HitTest 메서드를 호출합니다.

애플리케이션은 항상 결과 스트로크 컬렉션에 대한 대상 포인터를 전달해야 합니다. 교차점이 없으면 컬렉션의 개수는 0입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	msinkaut.h
라이브러리	InkObj.dll

추가 정보

HitTest(Point[], Single) 메서드

HitTest(Rectangle, Single) 메서드

IInkDisp

InkDisp 클래스

InkStrokes 컬렉션