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

아티클
08/28/2023

패키지에서 현재 열려 있는 FixedDocument 부분에 새 FixedPage 파트를 씁니다.

구문

HRESULT AddPage(
  [in] IXpsOMPage                   *page,
  [in] const XPS_SIZE               *advisoryPageDimensions,
  [in] IXpsOMPartUriCollection      *discardableResourceParts,
  [in] IXpsOMStoryFragmentsResource *storyFragments,
  [in] IXpsOMPrintTicketResource    *pagePrintTicket,
  [in] IXpsOMImageResource          *pageThumbnail
);

매개 변수

[in] page

현재 열려 있는 패키지의 FixedDocument에 페이지 콘텐츠를 쓸 IXpsOMPage 인터페이스입니다.

[in] advisoryPageDimensions

페이지 차원이 포함된 XPS_SIZE 구조체입니다.

크기는 XPS 단위로 설명되어 있습니다. 인치당 XPS 단위는 96개입니다. 예를 들어 8.5" x 11.0" 페이지의 크기는 816 x 1,056 XPS 단위입니다.

[in] discardableResourceParts

삭제 가능한 리소스 파트의 컬렉션을 포함하는 IXpsOMPartUriCollection 인터페이스입니다.

[in] storyFragments

이 페이지에 사용할 IXpsOMStoryFragmentsResource 인터페이스입니다.

[in] pagePrintTicket

이 페이지의 페이지 수준 인쇄 티켓이 포함된 IXpsOMPrintTicketResource 인터페이스입니다. 설명을 참조하십시오.

[in] pageThumbnail

이 페이지의 썸네일 이미지가 포함된 IXpsOMImageResource 인터페이스입니다.

반환 값

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
XPS_E_MISSING_DISCARDCONTROL	페이지는 삭제 가능한 리소스를 참조하지만 DiscardControl 파트 이름을 지정하지는 않습니다.
XPS_E_MISSING_DOCUMENT	이 메서드는 StartNewDocument 이전에 호출되었습니다.
XPS_E_UNAVAILABLE_PACKAGE	심각한 오류가 발생하여 XPS OM의 내용을 복구할 수 없을 수 있습니다. XPS OM의 일부 구성 요소는 여전히 사용할 수 있지만 확인된 후에만 사용할 수 있습니다. 이 오류가 반환된 후에는 XPS OM의 상태를 예측할 수 없으므로 XPS OM의 모든 구성 요소를 해제하고 삭제해야 합니다.

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

설명

StartNewDocument를 호출한 후 이 메서드를 호출합니다.

이 메서드는 패키지에 새 FixedPage 파트를 만들고 페이지 매개 변수에 전달되는 IXpsOMPage 인터페이스의 내용을 복사한 다음 페이지 가 패키지에 기록된 후 새 FixedPage 부분을 닫습니다.

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

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

요구 사항

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