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

Erstellt ein TextureBrush-Objekt basierend auf einem Bild, einem Umbruchmodus und einem definierenden Satz von Koordinaten.

Syntax

void TextureBrush(
  [in] Image    *image,
  [in] WrapMode wrapMode,
  [in] REAL     dstX,
  [in] REAL     dstY,
  [in] REAL     dstWidth,
  [in] REAL     dstHeight
);

Parameter

[in] image

Typ: Image*

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 er mit diesem Texturpinsel gezeichnet wird.

[in] dstX

Typ: REAL

Äußerste linke Koordinate des Bildteils, der von diesem Pinsel verwendet werden soll.

[in] dstY

Typ: REAL

Oberste Koordinate des Bildteils, der von diesem Pinsel verwendet werden soll.

[in] dstWidth

Typ: REAL

Breite des Pinsels und Breite des Bildteils, der vom Pinsel verwendet werden soll.

[in] dstHeight

Typ: REAL

Höhe des Pinsels und Höhe des Bildteils, der vom Pinsel verwendet werden soll.

Rückgabewert

Keine

Bemerkungen

Die Parameter dstX, dstY, dstWidth und dstHeight geben ein Rechteck an. Die Größe des Pinsels wird durch dstWidth und dstHeight definiert. Die Parameter dstX und dstY haben keine Auswirkung auf die Größe oder Position des Pinsels – der Pinsel ist immer an (0, 0) ausgerichtet. Die Parameter dstX, dstY, dstWidth und dstHeight definieren den Teil des Bilds, der vom Pinsel verwendet werden soll.

Angenommen, Sie verfügen über ein Bild, das in einem Image-Objekt gespeichert ist und 256 ×512 Pixel (Breite ×) aufweist. Anschließend erstellen Sie ein TextureBrush-Objekt basierend auf diesem Bild wie folgt:

TextureBrush(&someImage, WrapModeTile, 12, 50, 100, 150)

Der Pinsel hat eine Breite von 100 Einheiten und eine Höhe von 150 Einheiten. Der Pinsel verwendet einen rechteckigen Teil des Bilds. Dieser Teil beginnt am Pixel mit Koordinaten (12, 50). Die Breite und Höhe des Teils beträgt 100 bzw. 150, gemessen vom Anfangspixel.

Angenommen, Sie erstellen ein weiteres TextureBrush-Objekt basierend auf demselben Bild und geben ein anderes Rechteck an:

TextureBrush(&someImage, WrapModeTile, 0, 0, 256, 512)

Die Breite und Höhe des Pinsels entspricht 256 bzw. 512. Der Pinsel verwendet das gesamte Bild anstelle eines Teils davon, da das Rechteck ein Startpixel bei Koordinaten (0, 0) und Abmessungen angibt, die mit denen des Bilds identisch sind.

Anforderungen

Anforderung	Wert
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