PathGradientBrush ::SetWrapMode, méthode (gdipluspath.h)

Article
02/26/2024

La méthode PathGradientBrush ::SetWrapMode définit le mode wrap de ce pinceau de dégradé de chemin.

Syntaxe

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Paramètres

[in] wrapMode

Type : WrapMode

Élément de l’énumération WrapMode qui spécifie la façon dont les zones peintes avec le pinceau de dégradé de chemin seront mosaïques. La valeur par défaut est WrapModeClamp.

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 .

Remarques

Le rectangle englobant d’un pinceau de dégradé de chemin est le plus petit rectangle qui entoure le chemin de limite du pinceau. Lorsque vous peignez le rectangle englobant avec le pinceau de dégradé de chemin, seule la zone à l’intérieur du chemin de limite est remplie. La zone à l’intérieur du rectangle englobant mais à l’extérieur du chemin de limite n’est pas remplie.

WrapModeClamp (mode wrap par défaut) indique qu’aucune peinture ne se produit en dehors du rectangle englobant du pinceau. Tous les autres modes d’habillage indiquent que les zones situées en dehors du rectangle englobant du pinceau seront en mosaïque. Chaque vignette est une copie (éventuellement retournée) du chemin rempli à l’intérieur de son rectangle englobant.

Exemples

L’exemple suivant crée un objet PathGradientBrush basé sur un chemin triangulaire. Le code appelle la méthode PathGradientBrush ::SetWrapMode de l’objet PathGradientBrush pour définir le mode wrap du pinceau sur WrapModeTileFlipX. La méthode Graphics ::FillRectangle utilise le pinceau de dégradé de chemin pour carreler une grande zone.

La sortie du code est une grille de vignettes. Lorsque vous passez d’une vignette à l’autre d’une ligne donnée, l’image (chemin de limite rempli à l’intérieur du rectangle englobant) est retournée horizontalement.

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

   Point points[] = {
      Point(0, 0), 
      Point(100, 0), 
      Point(100, 100)};

   Color colors[] = {
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255),   // blue
      Color(255, 0, 255, 0)};  // green

   INT count = 3;

   PathGradientBrush pthGrBrush(points, 3);
   pthGrBrush.SetSurroundColors(colors, &count);
   pthGrBrush.SetWrapMode(WrapModeTileFlipX);

   graphics.FillRectangle(&pthGrBrush, 0, 0, 800, 800); 
}

Configuration requise

Condition requise	Valeur
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	gdipluspath.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll