Méthode TextureBrush ::TextureBrush(Image*,WrapMode,constRect&) (gdiplusbrush.h)
Crée un objet TextureBrush basé sur une image, un mode d’habillage et un rectangle de définition.
Syntaxe
void TextureBrush(
[in] Image *image,
[in] WrapMode wrapMode,
[in, ref] const Rect & dstRect
);
Paramètres
[in] image
Type : Image*
Pointeur vers un objet Image qui contient la bitmap de l’image à utiliser.
[in] wrapMode
Type : WrapMode
Élément de l’énumération WrapMode qui spécifie comment les copies répétées d’une image sont utilisées pour mettre en mosaïque une zone lorsqu’elle est peinte avec ce pinceau de texture.
[in, ref] dstRect
Type : const Rect
Référence à un rectangle qui définit la taille de ce pinceau de texture et la partie de l’image à utiliser par ce pinceau de texture. Si l’objet Image est créé à partir d’un métafichier, le pinceau utilise l’image entière, qui est mise à l’échelle pour s’adapter à la taille du pinceau.
Valeur de retour
None
Remarques
La largeur et la hauteur d’un pinceau de texture sont définies par la largeur et la hauteur du rectangle dstRect . Un pinceau de texture est toujours orienté à (0, 0). Le point supérieur gauche, la largeur et la hauteur du rectangle spécifient le point de départ, la largeur et la hauteur de la partie de l’image à utiliser par un pinceau de texture.
Comment ce constructeur utilise le rectangle dstRect avec des images nonmetafile
Si les dimensions du rectangle dstRect sont inférieures à celles de l’image sur laquelle le pinceau est basé, l’image du pinceau est rognée, c’est-à-dire une partie de l’image. Si les dimensions du rectangle dstRect sont égales à celles de l’image, l’image du pinceau est identique à l’image. Le rectangle dstRect ne doit pas inclure de zones en dehors des dimensions de l’image. Cela génère un comportement imprévisible ou génère une erreur d’exécution. Par exemple, supposons que vous ayez une image de 256 ×256 pixels et que vous créez un objet TextureBrush basé sur cette image, en passant comme paramètre dstRect . Le pinceau utilise la partie inférieure gauche de l’image. Le coin inférieur gauche de cette partie est également le coin inférieur gauche de l’image. Supposons maintenant que vous créez un autre objet TextureBrush basé sur la même image, en passant comme paramètre dstRect . Notez que ce rectangle a sa coordonnée la plus haute à 157 au lieu de 156. Ce rectangle étend une unité au-delà de la hauteur de l’image et génère probablement une violation d’accès.Comment ce constructeur utilise le rectangle dstRect avec des images de métafichier
Si les dimensions du rectangle dstRect sont différentes de celles de l’image, l’image du pinceau est mise à l’échelle plus petite ou plus grande en fonction des besoins pour s’adapter au rectangle. Par exemple, supposons que vous ayez une image de métafichier de 256 ×256 pixels et que vous créez un objet TextureBrush , en passant comme paramètre dstRect . L’image du pinceau inclut l’ensemble de l’image de métafichier, mais elle est mise à l’échelle pour s’adapter au pinceau : elle sera tendue verticalement et étirée horizontalement. Si les dimensions du rectangle sont égales à celles de l’image, l’image du pinceau est identique à l’image.Comment ce constructeur utilise le mode wrap
Une zone qui s’étend au-delà des limites du pinceau est en mosaïque avec des copies répétées du pinceau. Un pinceau de texture peut avoir d’autres vignettes retournées dans une certaine direction, comme spécifié par le mode d’habillage. Le retournement a pour effet d’inverser l’image du pinceau.Configuration requise
| Client minimal pris en charge | Windows XP, Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | gdiplusbrush.h (inclure Gdiplus.h) |
| Bibliothèque | Gdiplus.lib |
| DLL | Gdiplus.dll |