다음을 통해 공유

IXpsOMPageReference::SetAdvisoryPageDimensions 메서드(xpsobjectmodel.h)

  • 아티클

페이지의 제안된 차원을 설정합니다.

구문

HRESULT SetAdvisoryPageDimensions(
  [in] const XPS_SIZE *pageDimensions
);

매개 변수

[in] pageDimensions

페이지에 대해 설정할 제안된 차원입니다.

높이 및 너비 멤버의 값은 –1.0이거나 +1.0보다 크거나 같은 값이어야 합니다.

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

반환 값

메서드가 성공하면 S_OK 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

반환 코드 Description
S_OK
 메서드가 성공했습니다.
E_POINTER
 pageDimensions는 NULL이거나 pageDimensions에서 참조하는 XPS_SIZE 구조의 필드에 유효하지 않은 값이 포함되어 있습니다.
XPS_E_INVALID_PAGE_SIZE
 pageDimensions에 설명된 권고 페이지 크기가 잘못되었습니다. pageDimensions의 높이 및 너비 멤버의 값은 –1.0이거나 +1.0보다 크거나 같은 값이어야 합니다.

설명

pageDimensions에서 참조하는 XPS_SIZE 구조체의 높이 및 너비 멤버에는 해당 필드의 값을 설정해야 하는 경우 +1.0보다 크거나 같은 값이 있어야 합니다. 그렇지 않으면 –1.0입니다. 예를 들어 권고 차원을 페이지 너비에 맞게 설정하려는 경우 pageDimensions.width 에는 원하는 값이 있고 pageDimensions.height 의 값은 –1.0입니다.

요구 사항

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

추가 정보

IXpsOMPageReference

XML Paper Specification

XPS_SIZE