LinearGradientBrush::GetWrapMode-Methode (gdiplusbrush.h)

Artikel
08/23/2023

Die LinearGradientBrush::GetWrapMode-Methode ruft den Umbruchmodus für diesen Pinsel ab. Der Umbruchmodus bestimmt, wie ein Bereich gekachelt wird, wenn er mit einem Pinsel gemalt wird.

Syntax

WrapMode GetWrapMode();

Rückgabewert

Typ: WrapMode

Diese Methode gibt eines der folgenden Elemente der WrapMode-Enumeration zurück:

WrapModeTile
WrapModeTileFlipX
WrapModeTileFlipY
WrapModeTileFlipXY

Hinweise

Die Begrenzungslinien eines linearen Farbverlaufspinsels bilden eine Kachel. Wenn Sie einen Bereich mit einem linearen Farbverlaufspinsel zeichnen, wird die Kachel wiederholt. Bei einem Pinsel für linearen Farbverlauf können alternative Kacheln in eine bestimmte Richtung gedreht werden, wie im Umbruchmodus angegeben. Das Drehen hat den Effekt, dass die Reihenfolge der Farben umgedreht wird.

Der Standardumbruchmodus für einen linearen Farbverlaufspinsel ist WrapModeTile, was angibt, dass kein Umdrehen stattfindet.

Beispiele

Im folgenden Beispiel wird ein linearer Farbverlaufspinsel erstellt und dessen Umbruchmodus festgelegt. Als Nächstes ruft der Code den Umbruchmodus des Pinsels ab und führt Aufgaben basierend auf dem aktuellen Umbruchmodus des Pinsels aus.

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

   // Create a linear gradient brush, and set its wrap mode.
   LinearGradientBrush linGrBrush( 
      Point(0,0),
      Point(200, 0),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255));  // blue

   linGrBrush.SetWrapMode(WrapModeTileFlipX);

   // Obtain information about the linear gradient brush.
   WrapMode wrapMode;
   wrapMode = linGrBrush.GetWrapMode();

   if (wrapMode == WrapModeTileFlipX)
   {
       // Do some task. 
   }
   else if (wrapMode == WrapModeTileFlipY)
   {
       // Do a different task.
   }
}

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