PathGradientBrush::SetWrapMode-Methode (gdipluspath.h)

Artikel
02/29/2024

Die PathGradientBrush::SetWrapMode-Methode legt den Wrap-Modus dieses Pfadverlaufpinsels fest.

Syntax

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Parameter

[in] wrapMode

Typ: WrapMode

Element der WrapMode-Enumeration , das angibt, wie bereiche, die mit dem Pfadfarbverlaufpinsel gezeichnet werden, gekachelt werden. Der Standardwert ist WrapModeClamp.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Das umgebende Rechteck eines Pfadverlaufspinsels ist das kleinste Rechteck, das den Begrenzungspfad des Pinsels umschließt. Wenn Sie das umgebende Rechteck mit dem Pfadverlaufpinsel zeichnen, wird nur der Bereich innerhalb des Begrenzungspfads ausgefüllt. Der Bereich innerhalb des begrenzungsenden Rechtecks, aber außerhalb des Begrenzungspfads wird nicht ausgefüllt.

WrapModeClamp (der Standardumbruchmodus) gibt an, dass außerhalb des umgebenden Rechtecks des Pinsels keine Zeichnung erfolgt. Alle anderen Umbruchmodi geben an, dass Bereiche außerhalb des begrenzungsenden Rechtecks des Pinsels gekachelt werden. Jede Kachel ist eine Kopie (möglicherweise gedreht) des ausgefü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 Wrap-Modus des Pinsels auf WrapModeTileFlipX festzulegen. Die Graphics::FillRectangle-Methode verwendet den Pfadverlaufpinsel, um einen großen Bereich zu kacheln.

Die Ausgabe des Codes ist ein Raster von Kacheln. Wenn Sie in einer bestimmten Zeile von einer Kachel zur nächsten wechseln, wird das Bild (gefüllter Begrenzungspfad innerhalb des umgebenden Rechtecks) horizontal gedreht.

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

Anforderungen

Anforderung	Wert
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