IXpsOMPackageWriter::StartNewDocument 메서드(xpsobjectmodel.h)

아티클
08/28/2023

패키지의 FixedDocumentSequence에서 새 FixedDocument를 열고 초기화합니다.

구문

HRESULT StartNewDocument(
  [in] IOpcPartUri                            *documentPartName,
  [in] IXpsOMPrintTicketResource              *documentPrintTicket,
  [in] IXpsOMDocumentStructureResource        *documentStructure,
  [in] IXpsOMSignatureBlockResourceCollection *signatureBlockResources,
  [in] IXpsOMPartUriCollection                *restrictedFonts
);

매개 변수

[in] documentPartName

새 문서의 파트 이름을 포함하는 IOpcPartUri 인터페이스에 대한 포인터입니다.

[in] documentPrintTicket

문서 수준 인쇄 티켓을 포함하는 IXpsOMPrintTicketResource 인터페이스에 대한 포인터입니다. 이 패키지에 대한 문서 수준 인쇄 티켓이 없는 경우 이 매개 변수를 NULL로 설정할 수 있습니다. 설명을 참조하십시오.

[in] documentStructure

리소스를 사용할 수 있는 경우 초기 문서 구조 리소스를 포함하는 IXpsOMDocumentStructureResource 인터페이스에 대한 포인터입니다. 사용할 수 없는 경우 이 매개 변수를 NULL로 설정할 수 있습니다.

[in] signatureBlockResources

문서에 첨부할 디지털 서명 컬렉션을 포함하는 IXpsOMSignatureBlockResourceCollection 인터페이스에 대한 포인터입니다. 연결할 디지털 서명이 없는 경우 이 매개 변수를 NULL로 설정할 수 있습니다.

[in] restrictedFonts

제한된 글꼴 관계를 작성해야 하는 글꼴이 포함된 IXpsOMPartUriCollection 인터페이스에 대한 포인터입니다. AddResource 또는 Close가 호출될 때까지 글꼴 데이터가 작성되지 않습니다.

문서에 제한된 글꼴이 없으면 이 매개 변수를 NULL로 설정할 수 있습니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값은 다음 표에 있는 값을 포함하지만 이에 국한되지 않습니다. 이 표에 나열되지 않은 XPS 문서 API 반환 값에 대한 자세한 내용은 XPS 문서 오류를 참조하세요.

반환 코드	Description
S_OK	메서드가 성공했습니다.
XPS_E_UNAVAILABLE_PACKAGE	심각한 오류가 발생하여 XPS OM의 내용을 복구할 수 없습니다. XPS OM의 일부 구성 요소는 여전히 사용할 수 있지만 확인된 후에만 사용할 수 있습니다. 이 오류가 반환된 후 XPS OM의 상태를 예측할 수 없으므로 XPS OM의 모든 구성 요소를 해제하고 삭제해야 합니다.
XPS_E_UNEXPECTED_RESTRICTED_FONT_RELATIONSHIP	restrictedFonts에 전달된 제한된 글꼴 컬렉션에는 무제한 글꼴이 포함되어 있습니다.

이 메서드는 패키징 API를 호출합니다. 패키징 API 반환 값에 대한 자세한 내용은 패키징 오류를 참조하세요.

설명

IXpsOMPage 인터페이스의 콘텐츠를 작성하려면 AddPage를 호출하기 전에 이 메서드를 호출해야 합니다.

IXpsOMPackageWriter 인터페이스가 인스턴스화된 직후 패키지에는 빈 고정 문서 시퀀스 부분만 포함됩니다. 이 메서드가 처음 호출되면 FixedDocument 부분이 고정 문서 시퀀스 부분에 추가되고 AddPage 메서드가 해당 FixedDocument 부분에 페이지를 추가합니다. 이 메서드가 처음 호출될 때마다 현재 FixedDocument 부분이 닫혀 있고 새 FixedDocument 부분이 열리고 고정 문서 시퀀스 파트에 추가됩니다. AddPage 메서드에 대한 모든 후속 호출은 가장 최근에 열린 FixedDocument 부분에 페이지를 추가합니다. 이 인터페이스는 닫힌 FixedDocument 부분에 페이지를 추가하는 것을 지원하지 않습니다.

documentPrintTicket에 NULL 포인터가 포함되어 있고 인터리빙이 XPS_INTERLEAVING_ON 설정된 패키지 작성기를 만든 경우 이 메서드는 아직 없는 경우 빈 문서 수준 인쇄 티켓을 만듭니다. documentPrintTicket에서 NULL 포인터를 사용하여 이 메서드를 호출할 때마다 새 문서의 관계를 빈 인쇄 티켓에 추가합니다. 이 작업은 패키지의 보다 효율적인 스트리밍 사용을 제공하기 위해 수행됩니다.

documentPrintTicket에 NULL 포인터가 포함되어 있고 인터리빙이 XPS_INTERLEAVING_OFF 설정된 패키지 작성기를 만든 경우 빈 인쇄 티켓이 만들어지지 않습니다.

참고 패키지에서 새 문서를 만들면 XPS 문서에 대한 썸네일이 자동으로 만들어지지 않습니다. XPS 문서의 썸네일을 만들려면 IXpsOMThumbnailGenerator 인터페이스를 사용합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 포함된 Windows Vista [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	xpsobjectmodel.h