Méthode IXpsOMTileBrush ::SetViewbox (xpsobjectmodel.h)
Définit la partie du contenu source à utiliser comme image de vignette.
Syntaxe
HRESULT SetViewbox(
[in] const XPS_RECT *viewbox
);
Paramètres
[in] viewbox
Une structure XPS_RECT qui décrit la partie du contenu source à utiliser comme image de vignette.
Valeur retournée
Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, celles de la table qui suit. Pour plus d’informations sur les valeurs de retour de l’API de document XPS qui ne sont pas répertoriées dans ce tableau, consultez Erreurs de document XPS.
| Code de retour | Description |
|---|---|
|
S_OK |
|
viewbox a la valeur NULL. |
|
Le rectangle décrit dans la zone d’affichage n’était pas valide. |
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 de gauche est un exemple d’image source, tandis qu’à droite se trouve l’image source avec la zone d’affichage sélectionnée pour le pinceau sous la forme d’un rectangle rouge. Dans cet exemple, la partie de l’image source utilisée comme contenu pour le pinceau de mosaïque est la zone du rectangle rouge. La zone ombrée de l’image n’est pas utilisée par le pinceau.
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 * 24 / 96 = 24 pixels du haut
- SourceWidth = 96 * 24 / 96 = 24 pixels de large
- SourceHeight = 96 * 48 / 96 = 48 pixels de haut
Configuration requise
| 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 |