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

  • 아티클

폴리라인 선택 영역 내의 스트로크를 검색합니다.

구문

HRESULT HitTestWithLasso(
  [in]                VARIANT     Points,
  [in]                float       IntersectPercent,
  [in, out, optional] VARIANT     *LassoPoints,
  [out, retval]       IInkStrokes **Strokes
);

매개 변수

[in] Points

선택 도구에서 스트로크를 선택하는 데 사용되는 점입니다. 선택 영역은 경계가 먼저 자체적으로 교차하는 선택 경계 내의 영역입니다. 경계가 자체적으로 교차하지 않으면 메서드는 배열의 끝에 점을 추가하여 첫 번째 지점에서 마지막 지점까지 직선을 만듭니다. 경계가 직선(선택 영역 내에 영역 없음)이면 스트로크가 선택되지 않습니다.

VARIANT 구조에 대한 자세한 내용은 COM 라이브러리 사용을 참조하세요.

[in] IntersectPercent

결과 스트로크 컬렉션에 스트로크를 포함하려면 선택 도구 내에 포함되어야 하는 스트로크 점의 백분율입니다. 0(0)이면 선택 도구 내에 포함되거나 선택 도구에 의해 교차되는 모든 스트로크가 결과 스트로크 컬렉션에 포함됩니다. 100이면 선택 도구에 완전히 포함된 스트로크만 컬렉션에 포함됩니다. 선택 도구와 교차하는 스트로크는 선택 도구에 포함된 스트로크의 점 백분율이 percentIntersect 백분율보다 크거나 같은 경우 컬렉션에 포함됩니다. 소수 비율은 반올림됩니다.

[in, out, optional] LassoPoints

선택 사항입니다. 선택 영역에 사용되는 선택 도구의 특정 부분을 검색합니다. 사용자가 여러 가지 유형의 선택 도구를 그릴 수 있으며, 그 중 일부는 여러 번 겹치므로 선택 도구의 어느 부분을 선택 영역에 사용했는지 설명하는 데 유용할 수 있습니다. 기본값은 NULL 포인터입니다. 즉, 정보가 반환되지 않습니다.

VARIANT 구조에 대한 자세한 내용은 COM 라이브러리 사용을 참조하세요.

[out, retval] Strokes

이 메서드가 반환되면 잉크를 구성하는 스트로크 컬렉션에 대한 포인터가 포함됩니다.

반환 값

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

반환 코드 Description
S_OK
 성공.
E_POINTER
 매개 변수에 잘못된 포인터가 포함되어 있습니다.
E_INK_EXCEPTION
 메서드 내에서 예외가 발생했습니다.
E_INVALIDARG
 표시 핸들이 잘못되었습니다.
E_OUTOFMEMORY
 메모리 작업을 할당할 수 없습니다.

요구 사항

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

추가 정보

HitTest(Point, Single) 메서드

HitTest(Rectangle, Single) 메서드

IInkDisp

InkDisp 클래스

InkStrokes 컬렉션