Método IXpsOMPageReference::SetAdvisoryPageDimensions (xpsobjectmodel.h)
Define as dimensões sugeridas da página.
Sintaxe
HRESULT SetAdvisoryPageDimensions(
[in] const XPS_SIZE *pageDimensions
);
Parâmetros
[in] pageDimensions
As dimensões sugeridas a serem definidas para a página.
Os membros de altura e largura devem ter o valor de –1,0 ou um valor maior ou igual a +1,0.
O tamanho é descrito em unidades XPS. Há 96 unidades XPS por polegada. Por exemplo, as dimensões de uma página de 8,5" por 11,0" são 816 por 1.056 unidades XPS.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK; caso contrário, ele retornará um código de erro HRESULT .
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
PageDimensions é NULL ou um campo na estrutura XPS_SIZE referenciada por pageDimensions contém um valor que não é válido. |
|
O tamanho da página de consultoria descrito em pageDimensions não era válido. Os membros de altura e largura de pageDimensions devem ter o valor de –1,0 ou um valor maior ou igual a +1,0. |
Comentários
Os membros de altura e largura da estrutura XPS_SIZE referenciada por pageDimensions devem ter valores maiores ou iguais a +1,0, se os valores desses campos devem ser definidos ou –1,0, caso contrário. Por exemplo, se uma dimensão de consultoria fosse definida apenas para a largura da página, pageDimensions.width teria o valor desejado e pageDimensions.height teria o valor de –1,0.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | xpsobjectmodel.h |