IInkStrokeDisp::Clip 메서드(msinkaut.h)

사각형 외부에 있는 IInkStrokeDisp 개체 또는 InkStrokes 컬렉션의 일부를 제거합니다.

구문

HRESULT Clip(
  [in] IInkRectangle *Rectangle
);

매개 변수

[in] Rectangle

스트로크 또는 스트로크가 잘리는 외부의 사각형을 지정합니다. 사각형은 잉크 공간 좌표로 지정됩니다.

반환 값

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

반환 코드	설명
S_OK	성공.
E_POINTER	매개 변수에 잘못된 포인터가 포함되어 있습니다.
REGDB_CLASSNOTREG	InkDisp 개체가 등록되지 않았습니다.
E_INVALIDARG	클립 사각형이 잘못되었습니다.
E_INK_EXCEPTION	메서드 내에서 예외가 발생했습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.

설명

InkDisp 개체의 경우 사각형과 교차하는 모든 스트로크가 교차 지점에서 분할됩니다. 사각형 외부의 모든 스트로크 부분은 InkDisp 개체에서 제거됩니다. 메서드는 스트로크가 사각형과 교차하는 지점에서 스트로크에 새 점을 추가할 수 있습니다. InkDisp 개체에서 Clip 메서드를 호출한 후 InkDisp 개체의 스트로크 컬렉션에 있는 스트로크의 ID는 고유하지만 다른 정보를 유지하도록 보장되지는 않습니다.

이 메서드는 클리핑할 때 펜 너비를 고려하지 않습니다. 실제 잉크 또는 스트로크 데이터만 클립합니다.

IInkStrokeDisp 개체 또는 InkStrokes 컬렉션의 경우 Clip 메서드는 부모 InkDisp 개체를 업데이트합니다. InkDisp 개체에서 잉크를 제거할 때마다 해당 InkDisp 개체에 대해 정의된 모든 IInkStrokeDisp 개체 또는 InkStrokes 컬렉션이 무효화될 수 있습니다.

잉크 데이터에 대한 자세한 내용은 잉크 데이터를 참조하세요.

요구 사항

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

추가 정보

HitTest(Rectangle, Single) 메서드

IInkStrokeDisp 인터페이스

InkRectangle 클래스