LinearGradientBrush::SetWrapMode, méthode (gdiplusbrush.h)

La méthode LinearGradientBrush::SetWrapMode définit le mode wrap de ce pinceau de dégradé linéaire.

Syntaxe

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Paramètres

[in] wrapMode

Type : WrapMode

Élément de l’énumération WrapMode qui spécifie comment les zones peintes avec ce pinceau de dégradé linéaire seront mosaïques. La valeur de ce paramètre doit être l’un des éléments suivants :

• WrapModeTile
• WrapModeTileFlipX
• WrapModeTileFlipY
• WrapModeTileFlipXY

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

Les lignes limites d’un pinceau dégradé linéaire forment une vignette. Lorsque vous peignez une zone avec un pinceau dégradé linéaire, la vignette se répète. Un pinceau à dégradé linéaire peut avoir d’autres vignettes retournées dans une certaine direction, comme spécifié par le mode wrap. Le retournement a pour effet d’inverser l’ordre des couleurs.

Le mode wrap par défaut est WrapModeTile lorsqu’un objet LinearGradientBrush est construit.

Exemples

L’exemple suivant crée un pinceau de dégradé linéaire et l’utilise pour remplir un rectangle. Ensuite, le code modifie le mode d’habillage du pinceau et utilise le pinceau modifié pour remplir un autre rectangle.

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

   LinearGradientBrush linGrBrush( 
      Rect(0, 0, 100, 50),
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 0, 255),  // blue
      LinearGradientModeHorizontal);

   // Fill a large area using the gradient brush with the default wrap mode.
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 800, 50);

   linGrBrush.SetWrapMode(WrapModeTileFlipX);

   // Fill a large area using the gradient brush with the new wrap mode.
   myGraphics.FillRectangle(&linGrBrush, 0, 75, 800, 50);
}

Spécifications

Voir aussi

Pinceaux et formes remplies

Création d’un dégradé linéaire

LinearGradientBrush

LinearGradientBrush::GetWrapMode

Rect

Mosaïsage d’une forme avec une image

WrapMode