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

아티클
08/24/2023

InkStrokes 컬렉션을 클립보드에 복사합니다.

구문

HRESULT ClipboardCopy(
  [in, optional] IInkStrokes         *strokes,
  [in, optional] InkClipboardFormats ClipboardFormats,
  [in, optional] InkClipboardModes   ClipboardModes,
  [out, retval]  IDataObject         **DataObject
);

매개 변수

[in, optional] strokes

선택 사항입니다. 복사할 스트로크를 지정합니다. strokes 매개 변수가 NULL이면 ClipboardCopy 메서드는 전체 InkDisp 개체를 복사합니다. 기본값은 NULL입니다.

[in, optional] ClipboardFormats

(선택 사항) InkDisp 개체의 InkClipboardFormats 열거형 값을 지정합니다. 기본값은 ICF_Default.

[in, optional] ClipboardModes

(선택 사항) InkDisp 개체의 InkClipboardModes 열거형 값을 지정합니다. 기본값은 ICB_Default.

[out, retval] DataObject

이 메서드가 반환되면 새로 만든 데이터 개체에 대한 포인터가 포함됩니다.

반환 값

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

반환 코드	설명
S_OK	성공.
E_POINTER	매개 변수에 잘못된 포인터가 포함되어 있습니다.
E_INK_EXCEPTION	메서드 내에서 예외가 발생했습니다.
E_INK_MISMATCHED_INK_OBJECT	strokes 매개 변수는 다른 Ink 개체와 연결됩니다.

설명

이 메서드는 인식 결과를 포함하여 스트로크의 모든 속성을 복사합니다. strokes 매개 변수를 NULL로 설정하면 CustomStrokes 속성을 포함하여 InkDisp 개체가 클립보드에 복사되고 InkDisp 개체의 IInkCustomStrokes 컬렉션에 있는 스트로크에 대한 인식 결과가 유지됩니다.

빈 InkStrokes 컬렉션이 전달되면 메서드는 NULL 을 반환하고 클립보드의 내용은 수정되지 않습니다.

참고 클립보드 API가 작동하려면 먼저 NULL(OleInitialize)을 호출해야 합니다.

주의ICB_DelayedCopy 플래그를 사용한 결과로 메모리 누수 가능성을 방지하려면 OleFlushClipboard 또는 OleSetClipboard 메서드를 호출해야 합니다. ClipboardCopy 메서드에 대한 마지막 호출에서 ICB_DelayedCopy 플래그를 사용한 경우 애플리케이션이 종료되기 전에 이 작업을 수행해야 합니다.

요구 사항


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