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

아티클
03/06/2024

알려진 사각형을 사용하여 추출할 스트로크를 확인하여 기존 InkDisp 개체에서 스트로크를 잘라내거나 복사하여 새 InkDisp 개체에 붙여넣습니다.

구문

HRESULT ExtractWithRectangle(
  [in]           IInkRectangle   *Rectangle,
  [in, optional] InkExtractFlags extractFlags,
  [out, retval]  IInkDisp        **ExtractedInk
);

매개 변수

[in] Rectangle

InkDisp 개체에서 추출할 잉크를 구분하는 InkRectangle 개체를 지정합니다.

[in, optional] extractFlags

선택 사항입니다. InkExtractFlags 열거형 형식을 지정하여 기존 InkDisp 개체에서 잉크를 잘라내거나 복사해야 하는지 여부를 결정합니다. 기본값은 기존 InkDisp 개체에서 스트로크를 잘라내는 IEF_DEFAULT.

[out, retval] ExtractedInk

이 메서드가 반환될 때 는 추출된 스트로크 컬렉션을 포함하는 InkDisp 개체에 대한 포인터를 포함합니다.

반환 값

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

반환 코드	Description
S_OK	성공.
E_POINTER	매개 변수에 잘못된 포인터가 포함되어 있습니다.
E_INK_EXCEPTION	메서드 내에서 예외가 발생했습니다.
E_INK_SOME_STROKES_NOT_EXTRACTED	모든 스트로크가 추출된 것은 아닙니다.
E_OUTOFMEMORY	작업을 완료하기 위해 메모리를 할당할 수 없습니다.
E_INVALIDARG	추출 플래그가 잘못되었습니다.
REGDB_CLASSNOTREG	Ink 개체가 등록되지 않았습니다.

설명

새 InkDisp 개체는 원래 InkDisp 개체의 그리기 특성, 속성 및 좌표를 유지합니다.

이 메서드는 원래 개체에서 스트로크를 삭제하거나 잘라내지 않고 새 InkDisp 개체를 만드는 데 유용합니다.

알려진 스트로크 컬렉션에서 스트로크를 추출하려면 ExtractStrokes 메서드를 호출합니다.

사각형 내에 있는 스트로크 부분만 새 InkDisp 개체에 추가됩니다.

extractFlags 매개 변수가 RemoveFromOriginal 또는 Default이면 사각형을 교차하는 모든 스트로크가 분할되고 사각형 내의 부분이 기존 InkDisp 개체에서 제거됩니다.

요구 사항

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