Méthode IXpsOMPageReference ::SetAdvisoryPageDimensions (xpsobjectmodel.h)
Définit les dimensions suggérées de la page.
Syntaxe
HRESULT SetAdvisoryPageDimensions(
[in] const XPS_SIZE *pageDimensions
);
Paramètres
[in] pageDimensions
Dimensions suggérées à définir pour la page.
Les membres height et width doivent avoir la valeur de –1.0 ou une valeur supérieure ou égale à +1.0.
La taille est décrite dans unités XPS. Il existe 96 unités XPS par pouce. Par exemple, les dimensions d’une page 8.5 » par 11.0 » sont 816 x 1 056 unités XPS.
Valeur retournée
Si la méthode réussit, elle retourne S_OK ; sinon, il retourne un code d’erreur HRESULT .
| Code de retour | Description |
|---|---|
|
S_OK |
|
PageDimensions a la valeur NULL ou champ dans la structure XPS_SIZE référencée par pageDimensions contient une valeur non valide. |
|
La taille de page de conseil décrite dans pageDimensions n’était pas valide. Les membres height et width de pageDimensions doivent avoir la valeur de –1.0 ou une valeur supérieure ou égale à +1.0. |
Remarques
Les membres de hauteur et de largeur de la structure XPS_SIZE référencées par pageDimensions doivent avoir des valeurs supérieures ou égales à +1.0, si les valeurs de ces champs doivent être définies, ou à –1.0 si ce n’est pas le cas. Par exemple, si une dimension de conseil devait être définie uniquement pour la largeur de page, pageDimensions.width aurait la valeur souhaitée et pageDimensions.height aurait la valeur de –1.0.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | xpsobjectmodel.h |