Méthode IXpsOMTileBrush ::GetViewbox (xpsobjectmodel.h)

Obtient la partie de l’image source à utiliser par la vignette.

Syntaxe

HRESULT GetViewbox(
  [out, retval] XPS_RECT *viewbox
);

Paramètres

[out, retval] viewbox

Le XPS_RECT structure qui décrit la zone du contenu source à utiliser par la vignette.

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	S_OK
E_POINTER	viewbox a la valeur NULL.

Remarques

La zone d’affichage du pinceau spécifie la partie d’une image ou d’un visuel source à utiliser comme image de vignette.

Les coordonnées de la zone d’affichage du pinceau sont relatives au contenu source, de sorte que (0,0) spécifie le coin supérieur gauche du contenu source. Pour les images, les dimensions spécifiées par la zone d’affichage du pinceau sont exprimées en unités de 1/96 ». Les coordonnées de pixel correspondantes dans l’image source sont calculées comme suit :

Dans l’illustration qui suit, l’image à gauche est un exemple d’image source, l’image au centre montre la zone d’affichage sélectionnée et l’image à droite montre le pinceau résultant.

Si la résolution de l’image source est de 96 par 96 points par pouce et que les dimensions de l’image sont de 96 sur 96 pixels, les valeurs des champs dans le paramètre viewbox sont les suivantes :

Les valeurs de paramètre précédentes correspondent à l’image source comme suit :

SourceLeft = 96 × 48 / 96 = 48 pixels à partir du côté gauche

SourceTop = 96 × 4 / 96 = 24 pixels du haut

SourceWidth = 96 × 24 / 96 = 24 pixels de large

SourceHeight = 96 × 48 / 96 = 48 pixels de haut

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

Voir aussi

IXpsOMTileBrush

XML Paper Specification

XPS_RECT