IXpsOMPackageWriter 인터페이스는 애플리케이션이 XPS OM의 IXpsOMPage 인터페이스의 내용을 쓸 수 있는 XPS 문서 파일을 만듭니다. IXpsOMPackageWriter 인터페이스는 문서 내용을 순차적으로 처리하거나 만들 때 가장 유용합니다. IXpsOMPackage 인터페이스의 WriteToFile 및 WriteToStream 메서드와 달리 IXpsOMPackageWriter 인터페이스를 사용하려면 전체 FixedDocument 또는 FixedDocumentSequence를 완료할 필요가 없습니다.
개요
IXpsOMPackageWriter 인터페이스는 XPS 문서의 첫 번째 페이지에서 마지막 페이지까지 한 번에 한 페이지를 씁니다. 인터페이스는 간단한 XPS 문서 파일 및 FixedDocumentSequence에 둘 이상의 FixedDocument를 포함하는 복잡한 XPS 문서 파일을 만드는 데 사용할 수 있습니다. 복잡한 XPS 문서 파일에서 FixedDocuments는 FixedDocumentSequence의 첫 번째 FixedDocument부터 순서대로 만들어집니다. IXpsOMPackageWriter 인터페이스는 임의 순서로 문서 콘텐츠를 만드는 것을 지원하지 않습니다. 예를 들어 순차 보고서를 만들거나 문서 내용이 드라이버에 순서대로 공급되는 디바이스 드라이버 필터에서 처리를 수행하는 데 사용합니다.
용어 검토
XPS 문서 파일 XML 용지 사양을 준수하는 OPC(Open Packaging Conventions) 패키지입니다. 따라서 기술적으로 IXpsOMPackageWriter 인터페이스는 OPC 패키지를 만들지만, XML Paper 사양을 준수하는 OPC 패키지입니다. 이러한 이유로 XPS 문서에 대한 논의에서 XPS 문서 및 패키지 용어는 종종 서로 교환적으로 사용됩니다.
IXpsOMPackageWriter 인터페이스에 의해 생성된 패키지에는 FixedDocumentSequence, 하나 이상의 FixedDocument, 하나 이상의 FixedPage 등 필요한 XPS 문서 구성 요소가 포함됩니다. FixedDocumentSequence는 IXpsOMPackageWriter 인터페이스가 인스턴스화될 때 만들어집니다. IXpsOMPackageWriter::StartNewDocument 호출할 때마다 FixedDocument가 만들어지고 IXpsOMPackageWriter::AddPage호출때마다 FixedPage가 생성됩니다. 인터페이스는 문서 내용을 순차적으로 작성하므로 AddPage 메서드는 가장 최근에 만든 FixedDocument에 페이지를 추가합니다.
IXpsOMPackageWriter 인터페이스 사용
다음 절차에서는 IXpsOMPackageWriter 인터페이스를 사용하여 XPS 문서 파일을 만드는 방법을 설명합니다. 이 절차에서는 IXpsOMPage 인터페이스 및 해당 내용을 인스턴스화하는 방법을 설명하지 않습니다. IXpsOMPage 및 페이지에 콘텐츠를 추가하는 방법에 대한 자세한 내용은 XPS OM 페이지 인터페이스 및 '또한 참조' 섹션에 나열된 항목을 참조하십시오.
문서 만들기
IXpsOMPackageWriter 인터페이스를 인스턴스화합니다.
그러면 패키지에 빈 FixedDocumentSequence가 만들어집니다.
- 파일에 XPS 문서를 만들려면 IXpsOMObjectFactory::CreatePackageWriterOnFile호출합니다.
- 스트림에서 XPS 문서를 만들려면 IXpsOMObjectFactory::CreatePackageWriterOnStream호출합니다.
IXpsOMPackageWriter::StartNewDocument호출하여 패키지에서 새 문서를 시작합니다.
페이지를 추가하기 전에 IXpsOMPackageWriter::StartNewDocument 호출하여 1단계에서 만든 FixedDocumentSequence에 FixedDocument를 추가합니다.
콘텐츠를 추가합니다.
- 문서에 새 FixedPage를 추가하려면 IXpsOMPackageWriter::AddPage호출하여 추가할 FixedPage의 내용이 있는 IXpsOMPage 인터페이스에 대한 포인터를 전달합니다.
- FixedDocumentSequence에서 새 FixedDocument를 만들려면 IXpsOMPackageWriter::StartNewDocument호출합니다.
IXpsOMPackageWriter::Close호출하여 패키지 및 해당 콘텐츠를 닫습니다.
고급 기능
IXpsOMPackageWriter 인터페이스의 메서드는 리소스, 썸네일 및 인쇄 티켓의 추가도 지원합니다. 이러한 문서 구성 요소는 패키지, FixedDocumentSequence, FixedDocument 및 FixedPage 수준에서 추가할 수 있습니다. 인쇄에 이 인터페이스를 사용하는 방법에 대한 자세한 내용은 XPS OM인쇄를 참조하세요.
관련 항목
-
XPS OM 탐색