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

Article
08/24/2023

La méthode PathGradientBrush::GetWrapMode obtient le mode wrap actuellement défini pour ce pinceau de dégradé de chemin.

Syntaxe

WrapMode GetWrapMode();

Valeur de retour

Type : WrapMode

Cette méthode retourne un élément de l’énumération WrapMode qui indique le mode wrap actuellement défini pour ce pinceau de dégradé de chemin d’accès.

Notes

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.

Le mode wrap par défaut pour un pinceau de dégradé de chemin est WrapModeClamp, ce qui 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 sur WrapModeTileFlipX. Ensuite, le code appelle la méthode PathGradientBrush::GetWrapMode de l’objet PathGradientBrush pour obtenir le mode d’enveloppement du pinceau. Si le mode wrap obtenu est WrapModeTileFlipX, le code appelle FillRectangle pour mosaïquer une grande zone avec le pinceau de dégradé de chemin.

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

   // Create a path gradient brush based on an array of points,
   // and set its wrap mode.
   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);

   // Obtain information about the path gradient brush.
   WrapMode wrapMode; 
   wrapMode = pthGrBrush.GetWrapMode();

   if(wrapMode == WrapModeTileFlipX)
         graphics.FillRectangle(&pthGrBrush, 0, 0, 800, 800);
}

Spécifications


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