Compartir a través de


Método IXpsOMPageReference::SetAdvisoryPageDimensions (xpsobjectmodel.h)

Establece las dimensiones sugeridas de la página.

Sintaxis

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

Parámetros

[in] pageDimensions

Las dimensiones sugeridas que se van a establecer para la página.

Los miembros de alto y ancho deben tener el valor de –1,0 o un valor mayor o igual que +1,0.

El tamaño se describe en unidades XPS. Hay 96 unidades XPS por pulgada. Por ejemplo, las dimensiones de una página de 8,5" en 11,0" son 816 por 1056 unidades XPS.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK; de lo contrario, devuelve un código de error HRESULT .

Código devuelto Descripción
S_OK
El método se ha llevado a cabo de forma correcta.
E_POINTER
PageDimensions es NULL o un campo de la estructura XPS_SIZE a la que hace referencia pageDimensions contiene un valor que no es válido.
XPS_E_INVALID_PAGE_SIZE
El tamaño de página de aviso descrito en pageDimensions no era válido. Los miembros de alto y ancho de pageDimensions deben tener el valor de –1,0 o un valor mayor o igual que +1,0.

Comentarios

Los miembros de alto y ancho de la estructura de XPS_SIZE a la que hace referencia pageDimensions deben tener valores mayores o iguales que +1.0, si se deben establecer los valores de esos campos o –1,0 si no. Por ejemplo, si se establecera una dimensión de aviso solo para el ancho de página, pageDimensions.width tendría el valor deseado y pageDimensions.height tendría el valor de –1.0.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado xpsobjectmodel.h

Consulte también

IXpsOMPageReference

XML Paper Specification

XPS_SIZE