PathGradientBrush::GetWrapMode-Methode (gdipluspath.h)

Artikel
08/24/2023

Die PathGradientBrush::GetWrapMode-Methode ruft den Umbruchmodus ab, der derzeit für diesen Pfadverlaufspinsel festgelegt ist.

Syntax

WrapMode GetWrapMode();

Rückgabewert

Typ: WrapMode

Diese Methode gibt ein Element der WrapMode-Enumeration zurück, das den derzeit für diesen Pfadverlaufspinsel festgelegten Umbruchmodus angibt.

Hinweise

Das umgebende Rechteck eines Pfadverlaufspinsels ist das kleinste Rechteck, das den Begrenzungspfad des Pinsels einschließt. Wenn Sie das umgebende Rechteck mit dem Pfadverlaufspinsel malen, wird nur der Bereich innerhalb des Begrenzungspfads gefüllt. Der Bereich innerhalb des umgebenden Rechtecks, aber außerhalb des Begrenzungspfads wird nicht gefüllt.

Der Standardumbruchmodus für einen Pfadverlaufspinsel ist WrapModeClamp, der angibt, dass außerhalb des begrenzungsenden Rechtecks des Pinsels keine Malerei erfolgt. Alle anderen Umbruchmodi geben an, dass Bereiche außerhalb des umgebenden Rechtecks des Pinsels gekachelt werden. Jede Kachel ist eine Kopie (möglicherweise gedreht) des gefüllten Pfads innerhalb des umgebenden Rechtecks.

Beispiele

Im folgenden Beispiel wird ein PathGradientBrush-Objekt basierend auf einem dreieckigen Pfad erstellt. Der Code ruft die PathGradientBrush::SetWrapMode-Methode des PathGradientBrush-Objekts auf, um den Umbruchmodus auf WrapModeTileFlipX festzulegen. Als Nächstes ruft der Code die PathGradientBrush::GetWrapMode-Methode des PathGradientBrush-Objekts auf, um den Umbruchmodus des Pinsels abzurufen. Wenn der abgerufene Umbruchmodus WrapModeTileFlipX ist, ruft der Code FillRectangle auf, um einen großen Bereich mit dem Pfadverlaufspinsel zu kacheln.

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);
}

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdipluspath.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll