LinearGradientBrush::SetWrapMode-Methode (gdiplusbrush.h)

Artikel
08/23/2023

Die LinearGradientBrush::SetWrapMode-Methode legt den Wrap-Modus dieses linearen Farbverlaufpinsels fest.

Syntax

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Parameter

[in] wrapMode

Typ: WrapMode

Element der WrapMode-Enumeration , das angibt, wie Bereiche, die mit diesem linearen Farbverlaufpinsel gezeichnet wurden, kacheln werden. Der Wert dieses Parameters muss eines der folgenden Elemente sein:

WrapModeTile
WrapModeTileFlipX
WrapModeTileFlipY
WrapModeTileFlipXYY

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

Die Begrenzungslinien eines linearen Farbverlaufspinsels bilden eine Kachel. Wenn Sie einen Bereich mit einem linearen Farbverlaufpinsel zeichnen, wird die Kachel wiederholt. Bei einem linearen Farbverlaufpinsel können alternative Kacheln in eine bestimmte Richtung gedreht werden, wie im Umbruchmodus angegeben. Das Kippen bewirkt, dass die Reihenfolge der Farben umgedreht wird.

Der Umbruchmodus ist standardmäßig WrapModeTile, wenn ein LinearGradientBrush-Objekt erstellt wird.

Beispiele

Im folgenden Beispiel wird ein linearer Farbverlaufspinsel erstellt und zum Ausfüllen eines Rechtecks verwendet. Als Nächstes ändert der Code den Umbruchmodus des Pinsels und verwendet den geänderten Pinsel, um ein anderes Rechteck zu füllen.

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

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	gdiplusbrush.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll