다음을 통해 공유


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

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

참고 항목

ClipboardCopyWithRectangle 메서드

IInkDisp

InkClipboardFormats 열거형

InkClipboardModes 열거형

InkDisp 클래스

InkStrokes 컬렉션