TextureBrush::SetWrapMode-Methode (gdiplusbrush.h)

Artikel
08/24/2023

Die TextureBrush::SetWrapMode-Methode legt den Wrap-Modus dieses Texturpinsels fest.

Syntax

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Parameter

[in] wrapMode

Typ: WrapMode

Element der WrapMode-Enumeration , das angibt, wie wiederholte Kopien eines Bilds verwendet werden, um einen Bereich zu kacheln, wenn er mit diesem Texturpinsel gezeichnet wird.

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

Ein Bereich, der über die Grenzen des Pinsels hinausgeht, wird mit wiederholten Kopien des Pinsels angeordnet. Bei einem Texturpinsel können alternative Kacheln in eine bestimmte Richtung gedreht werden, wie im Umbruchmodus angegeben. Das Kippen hat den Effekt, dass das Bild des Pinsels umgekehrt wird. Wenn der Umbruchmodus beispielsweise als WrapModeTileFlipX angegeben ist, wird der Pinsel um eine Linie gedreht, die parallel zur y-Achse ist.

Der Texturpinsel ist immer an (0, 0) ausgerichtet. Wenn der Umbruchmodus als WrapModeClamp angegeben ist, wird kein Bereich außerhalb des Pinsels gekachelt. Angenommen, Sie erstellen einen Texturpinsel und geben WrapModeClamp als WrapModeClamp-Modus an:

TextureBrush(&SomeImage, WrapModeClamp)

Anschließend zeichnen Sie einen Bereich mit dem Pinsel. Wenn die Größe des Pinsels eine Höhe von 50 hat und der gemalte Bereich ein Rechteck mit seiner oberen linken Ecke bei (0, 50) ist, werden keine wiederholten Kopien des Pinsels (keine Kachelung) angezeigt.

Der Standardmäßige Umbruchmodus für einen Texturpinsel ist WrapModeTile, der kein Umdrehen der Kachel und keine Klemmung angibt.

Beispiele

Im folgenden Beispiel wird ein Texturpinsel erstellt, der Umbruchmodus des Pinsels festgelegt und der Pinsel zum Füllen eines Rechtecks verwendet.

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

   Image image(L"HouseAndTree.gif");
   TextureBrush textureBrush(&image);
   textureBrush.SetWrapMode(WrapModeTileFlipX);
   graphics.FillRectangle(&textureBrush, 0, 0, 400, 200);
}

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