Méthode TextureBrush ::TextureBrush(Image*,constRect&,constImageAttributes*) (gdiplusbrush.h)
Crée un objet TextureBrush basé sur une image, un rectangle de définition et un ensemble de propriétés d’image.
Syntaxe
void TextureBrush(
[in] Image *image,
[in, ref] const Rect & dstRect,
[in] const ImageAttributes *imageAttributes
);
Paramètres
[in] image
Type : Image*
Pointeur vers un objet Image qui contient l’image bitmap de l’image à utiliser.
[in, ref] dstRect
Type : 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.
[in] imageAttributes
Type : ImageAttributes*
facultatif. Pointeur vers un objet ImageAttributes qui contient les propriétés de l’image. La valeur par défaut est NULL.
Valeur de retour
None
Remarques
La largeur et la hauteur du rectangle dstRect définissent la largeur et la hauteur d’un pinceau de texture. 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 plus petites que celles de l’image sur laquelle le pinceau est basé, l’image du pinceau est rognée , il s’agit d’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 des 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 supérieure à 157 au lieu de 156. Ce rectangle étend une unité au-delà de la hauteur de l’image et génère très 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 sera 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.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 |