Méthode TextureBrush::SetWrapMode (gdiplusbrush.h)

Article
08/24/2023

La méthode TextureBrush::SetWrapMode définit le mode d’habillage de ce pinceau de texture.

Syntaxe

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Paramètres

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

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Notes

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. Par exemple, si le mode wrap est spécifié en tant que WrapModeTileFlipX, le pinceau est retourné autour d’une ligne qui est parallèle à l’axe y.

Le pinceau de texture est toujours orienté à (0, 0). Si le mode wrap est spécifié en tant que WrapModeClamp, aucune zone en dehors du pinceau n’est en mosaïque. Par exemple, supposons que vous créez un pinceau de texture, en spécifiant WrapModeClamp comme mode d’habillage :

TextureBrush(&SomeImage, WrapModeClamp)

Ensuite, vous peignez une zone avec le pinceau. Si la taille du pinceau a une hauteur de 50 et que la zone peinte est un rectangle avec son coin supérieur gauche à (0, 50), vous ne verrez aucune copie répétée du pinceau (pas de mosaïsme).

Le mode d’habillage par défaut d’un pinceau de texture est WrapModeTile, qui spécifie qu’il n’y a pas de glissement de la vignette ni de serrage.

Exemples

L’exemple suivant crée un pinceau de texture, définit le mode d’habillage du pinceau et utilise le pinceau pour remplir un rectangle.

VOID Example_SetWrapMode(HDC hdc)
{
   Graphics graphics(hdc);

   Image image(L"HouseAndTree.gif");
   TextureBrush textureBrush(&image);
   textureBrush.SetWrapMode(WrapModeTileFlipX);
   graphics.FillRectangle(&textureBrush, 0, 0, 400, 200);
}

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