TextureBrush::TextureBrush(Image*,WrapMode)-Methode (gdiplusbrush.h)

Artikel
08/24/2023

Erstellt ein TextureBrush-Objekt basierend auf einem Bild und einem Umbruchmodus. Die Größe des Pinsels entspricht standardmäßig der Größe des Bilds, sodass das gesamte Bild vom Pinsel verwendet wird.

Syntax

void TextureBrush(
  [in] Image    *image,
  [in] WrapMode wrapMode
);

Parameter

[in] image

Typ: Image*

Zeiger auf ein Image-Objekt , das die Bitmap des zu verwendenden Bilds enthält.

[in] wrapMode

Typ: WrapMode

Optional. 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. Der Standardwert ist WrapModeTile.

Rückgabewert

Keine

Bemerkungen

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.

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