Поделиться через

Метод IXpsOMPageReference::SetAdvisoryPageDimensions (xpsobjectmodel.h)

  • Статья

Задает предлагаемые размеры страницы.

Синтаксис

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

Параметры

[in] pageDimensions

Предлагаемые размеры, которые необходимо задать для страницы.

Элементы высоты и ширины должны иметь значение –1,0 или значение, большее или равное +1,0.

Размер описывается в единицах XPS. На дюйм приходится 96 единиц XPS. Например, размер страницы размером 8,5 на 11,0 дюйма составляет 816 х 1056 единиц XPS.

Возвращаемое значение

Если метод завершается успешно, он возвращает S_OK; В противном случае возвращается код ошибки HRESULT .

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_POINTER
 Значение pageDimensions равно NULL или поле в структуре XPS_SIZE , на которую ссылается pageDimensions , содержит недопустимое значение.
XPS_E_INVALID_PAGE_SIZE
 Недопустимый размер страницы рекомендаций, описанный в разделе pageDimensions . Элементы высоты и ширины объекта pageDimensions должны иметь значение –1,0 или значение, большее или равное +1,0.

Комментарии

Элементы высоты и шириныструктуры XPS_SIZE , на которую ссылается pageDimensions , должны иметь значения, которые больше или равны +1,0, если значения этих полей должны быть заданы, или –1,0, если нет. Например, если бы консультативное измерение было задано только для ширины страницы, pageDimensions.width будет иметь требуемое значение, а pageDimensions.height — значение –1,0.

Требования

Требование Значение
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header xpsobjectmodel.h

См. также раздел

IXpsOMPageReference

XPS

XPS_SIZE