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

  • 아티클

잉크를 지정된 InkPersistenceFormat으로 변환하고, 지정된 InkPersistenceCompressionMode를 사용하여 잉크를 저장하고, 바이트 배열에 이진 데이터를 반환합니다.

구문

HRESULT Save(
  [in, optional] InkPersistenceFormat          PersistenceFormat,
  [in, optional] InkPersistenceCompressionMode CompressionMode,
  [out, retval]  VARIANT                       *Data
);

매개 변수

[in, optional] PersistenceFormat

선택 사항입니다. 지속형 잉크의 형식을 나타내는 InkPersistenceFormat 값 중 하나를 설정합니다. 기본값은 InkSerializedFormat입니다.

Name Description
InkSerializedFormat
 잉크는 ISF(잉크 직렬화된 형식)를 사용하여 유지됩니다.

이 형식은 잉크에 대한 최대로 압축된 영구적 표현입니다. 이진 문서 형식에 포함되거나 클립보드에 직접 배치될 수 있습니다. 이것은 기본값입니다.
Base64InkSerializedFormat
 잉크는 ISF를 base64 스트림으로 인코딩하여 유지됩니다.

이 형식은 XML(Extensible Markup Language) 또는 HTML 파일에서 직접 잉크를 인코딩할 수 있도록 제공됩니다.
Gif
 잉크는 파일에 포함된 메타데이터로 ISF를 포함하는 GIF(그래픽 교환 형식) 파일을 사용하여 유지됩니다.

이렇게 하면 잉크를 사용할 수 없는 애플리케이션에서 잉크를 볼 수 있으며 잉크 사용 애플리케이션으로 돌아올 때 전체 잉크 충실도를 유지할 수 있습니다. 이 형식은 HTML 파일 내에서 잉크 콘텐츠를 전송하고 잉크 사용 및 잉크 인식 애플리케이션에서 사용할 수 있도록 하는 경우에 이상적입니다.
Base64Gif
 잉크는 base64로 인코딩된 fortified를 사용하여 유지됩니다.

이 GIFformat은 잉크가 나중에 이미지로 변환된 XML 또는 HTML 파일에서 직접 인코딩될 때 제공됩니다. 가능한 사용은 모든 잉크 정보를 포함하도록 생성되고 XSLT(확장 가능한 스타일시트 언어 변환)를 통해 HTML을 생성하는 방법으로 사용되는 XML 형식입니다.

[in, optional] CompressionMode

선택 사항입니다. 지속형 잉크의 압축 모드를 지정하는 InkPersistenceCompressionMode 값 중 하나입니다. 기본값은 IPCM_Default.

Name Description
IPCM_Default
 일반적인 애플리케이션에 대한 저장 시간과 스토리지 간의 절충이 필요한 경우에 사용됩니다.
IPCM_MaximumCompression
 스토리지 공간을 최소화하는 것이 잉크 저장 속도보다 더 중요할 때 사용됩니다.
IPCM_NoCompression
 사용 중인 스토리지 공간의 양보다 저장 시간이 더 중요하고 버전 간 호환성이 중요한 경우에 사용됩니다.

[out, retval] Data

이 메서드가 반환될 때 에는 지속형 잉크를 포함하는 바이트 배열이 포함됩니다.

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

반환 값

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

반환 코드 Description
S_OK
 성공.
E_POINTER
 매개 변수에 잘못된 포인터가 포함되어 있습니다.
E_INK_EXCEPTION
 메서드 내에서 예외가 발생했습니다.
E_INVALIDARG
 압축 모드가 잘못되었습니다.
E_OUTOFMEMORY
 바이트 배열을 할당할 수 없습니다.
E_UNEXPECTED
 빈 Ink 개체를 GIF 형식으로 저장하려고 하면 발생합니다.

설명

빈 InkDisp 개체를 GIF 형식으로 저장하려고 하면 오류가 발생합니다.

참고InkPersistenceFormat 값이 Base64InkSerializedFormat인 Save 메서드를 호출할 때 반환 값은 NULL -terminated 바이트 배열입니다. 저장된 잉크를 XML 파일에 쓰려면 먼저 배열을 8비트 UTF-8(유니코드 변환 형식) 인코딩 문자열로 변환하기 전에 배열에서 마지막 바이트를 제거합니다.
 

요구 사항

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

추가 정보

IInkDisp

InkDisp 클래스

InkPersistenceCompressionMode 열거형

InkPersistenceFormat 열거형

Load 메서드