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

Artikel
08/24/2023

Erstellt ein TextureBrush-Objekt basierend auf einem Bild, einem Umbruchmodus und einem definierenden Rechteck.

Syntax

void TextureBrush(
  [in]      Image        *image,
  [in]      WrapMode     wrapMode,
  [in, ref] const Rect & dstRect
);

Parameter

[in] image

Typ: Bild*

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

[in] wrapMode

Typ: WrapMode

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

[in, ref] dstRect

Typ: const Rect

Verweis auf ein Rechteck, das die Größe dieses Texturpinsels und den Teil des Bilds definiert, der von diesem Texturpinsel verwendet werden soll. Wenn das Image-Objekt aus einer Metadatei erstellt wird, verwendet der Pinsel das gesamte Bild, das an die Größe des Pinsels skaliert wird.

Rückgabewert

Keine

Bemerkungen

Die Breite und Höhe eines Texturpinsels werden durch die Breite und Höhe des dstRect-Rechtecks definiert. Ein Texturpinsel ist immer an (0, 0) ausgerichtet. Der obere linke Punkt, die Breite und die Höhe des Rechtecks geben den Startpunkt, die Breite und die Höhe des Bildteils an, der von einem Texturpinsel verwendet werden soll.

Wie dieser Konstruktor das dstRect-Rechteck mit Nichtmetadateiimages verwendet

Wenn die Dimensionen des dstRect-Rechtecks kleiner sind als die des Bilds, auf dem der Pinsel basiert, wird das Bild des Pinsels abgeschnitten – es ist ein Teil des Bilds. Wenn die Dimensionen des dstRect-Rechtecks denen des Bilds entsprechen, ist das Bild des Pinsels mit dem Bild identisch. Das dstRect-Rechteck darf keine Bereiche außerhalb der Bilddimensionen enthalten. Dies führt entweder zu unvorhersehbarem Verhalten oder zu einem Laufzeitfehler. Angenommen, Sie verfügen über ein Bild mit 256 ×256 Pixeln und erstellen ein TextureBrush-Objekt basierend auf diesem Bild, das als dstRect-Parameter übergeben wird. Der Pinsel verwendet den unteren linken Teil des Bilds. Die linke untere Ecke dieses Teils ist auch die linke untere Ecke des Bilds. Angenommen, Sie erstellen ein weiteres TextureBrush-Objekt basierend auf demselben Bild und übergeben es als dstRect-Parameter . Beachten Sie, dass dieses Rechteck seine oberste Koordinate mit 157 anstelle von 156 aufweist. Dieses Rechteck erweitert eine Einheit über die Bildhöhe hinaus und erzeugt höchstwahrscheinlich eine Zugriffsverletzung.

Wie dieser Konstruktor das dstRect-Rechteck mit Metadateibildern verwendet

Wenn sich die Dimensionen des dstRect-Rechtecks von denen des Bilds unterscheiden, wird das Bild des Pinsels je nach Bedarf kleiner oder größer skaliert, um das Rechteck anzupassen. Angenommen, Sie verfügen über ein Metadateibild mit 256 ×256 Pixeln, und Sie erstellen ein TextureBrush-Objekt , das als dstRect-Parameter übergeben wird. Das Bild des Pinsels enthält das gesamte Metadateibild, wird jedoch entsprechend dem Pinsel skaliert: Es wird vertikal und horizontal gestreckt. Wenn die Dimensionen des Rechtecks denen des Bilds entsprechen, ist das Bild des Pinsels mit dem Bild identisch.

Wie dieser Konstruktor den Umbruchmodus verwendet

Ein Bereich, der über die Grenzen des Pinsels hinausgeht, wird mit wiederholten Kopien des Pinsels gekachelt. Bei einem Texturpinsel können alternative Kacheln in eine bestimmte Richtung gedreht werden, wie im Umbruchmodus angegeben. Das Drehen hat den Effekt, dass das Bild des Pinsels umgedreht wird.

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