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

알려진 이진 데이터로 새 InkDisp 개체를 채웁니다.

구문

HRESULT Load(
  [in] VARIANT Data
);

매개 변수

[in] Data

잉크 데이터가 포함된 스트림입니다.

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

반환 값

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

반환 코드	Description
S_OK	성공.
E_INVALIDARG	VARIANT가 올바른 형식(바이트 배열)이 아닙니다.
E_OUTOFMEMORY	Stream 메모리를 할당할 수 없습니다.
E_UNEXPECTED	예기치 않은 매개 변수 또는 속성 형식입니다.
E_INK_EXCEPTION	메서드 내에서 예외가 발생했습니다.

설명

스트로크를 수집하지 않았거나 연결된 속성이 없는 비어 있는 새 InkDisp 개체에만 잉크를 로드할 수 있습니다. InkDisp 개체에서 스트로크 또는 속성이 삭제된 경우에도 스트로크 또는 연결된 속성을 수집한 InkDisp 개체에 잉크를 로드하려고 하면 예외가 throw됩니다. 이는 스트로크 ID가 할당되는 방식 때문에 발생합니다. 스트로크에 고유한 ID가 할당되며 Ink 개체에서 스트로크가 삭제된 경우에도 이 ID가 다시 사용되지 않습니다. 즉, InkDisp 개체에 ID가 1인 스트로크가 포함되어 있고 스트로크를 삭제하고 다른 InkDisp 개체를 이 InkDisp 개체에 로드한 경우 스트로크 ID는 2에서 시작됩니다. 이것은 혼란스러울 수 있으므로 허용되지 않습니다.

참고 비어 있지 않은 InkDisp 개체에 잉크를 로드하려고 하면 Load를 호출할 때 사용자 지정 스트로크 또는 확장 속성을 포함한 InkDisp 개체의 모든 데이터가 손실됩니다.

 

Save 메서드를 사용하면 inkDisp 개체를 바이트 데이터 배열로 구성된 GIF(Graphics Interchange Format) 형식으로 유지할 수 있습니다(tla_gif 지속성 형식은 InkPersistenceFormat 열거형 형식으로 지정됨). 바이트 데이터 배열이 있으면 바이트 데이터 배열을 다른 InkDisp 개체로 로드할 수 있습니다. 즉, Save 메서드를 호출하고 GIF 형식이 아닌 바이트 배열을 받은 것과 같은 방식으로 GIF 호환 바이트 배열 데이터를 다른 InkDisp 개체에 로드할 수 있습니다.

참고 이미지를 만들고, 해당 이미지를 바이트 배열로 유지한 다음, 해당 바이트 배열을 다른 InkDisp 개체로 로드할 수 없습니다. 바이트 배열 데이터를 GIF로 로드한 후 태블릿 PC가 해당 데이터의 형식을 제어할 수 없기 때문입니다. 따라서 이미지를 바이트 배열에 다시 유지한 후에는 해당 데이터에 대해 Load 를 호출할 수 없습니다.

 

요구 사항

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

추가 정보

IInkDisp

InkDisp 클래스

Save 메서드