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 |
|
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 |