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

Artikel
01/10/2024

Erstellt ein TextureBrush-Objekt basierend auf einem Bild, einem definierenden Rechteck und einer Reihe von Bildeigenschaften.

Syntax

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

Parameter

[in] image

Typ: Image*

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

[in, ref] dstRect

Typ: 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 entsprechend der Größe des Pinsels skaliert wird.

[in] imageAttributes

Typ: ImageAttributes*

Optional. Zeiger auf ein ImageAttributes-Objekt , das Eigenschaften des Bilds enthält. Der Standardwert ist NULL.

Rückgabewert

Keine

Bemerkungen

Die Breite und Höhe des dstRect-Rechtecks definieren die Breite und Höhe eines Texturpinsels. 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 Bildern ohne Metadaten verwendet

Wenn die Abmessungen des dstRect-Rechtecks kleiner sind als die Abmessungen des Bilds, auf dem der Pinsel basiert, wird das Bild des Pinsels zugeschnitten – es ist ein Teil des Bilds. Wenn die Abmessungen 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 Abmessungen des Bilds enthalten. Dies führt entweder zu unvorhersehbarem Verhalten oder zu einem Laufzeitfehler. Angenommen, Sie verfügen über ein Bild mit 256 ×256 Pixeln, und Sie 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 untere linke Ecke des Bilds. Angenommen, Sie erstellen ein weiteres TextureBrush-Objekt basierend auf demselben Bild, das als dstRect-Parameter übergeben wird. Beachten Sie, dass dieses Rechteck seine oberste Koordinate bei 157 anstelle von 156 aufweist. Dieses Rechteck erweitert eine Einheit über die Höhe des Bilds hinaus und erzeugt höchstwahrscheinlich eine Zugriffsverletzung.

Verwenden des dstRect-Rechtecks mit Metadateibildern durch diesen Konstruktor

Wenn sich die Abmessungen des dstRect-Rechtecks von denen des Bilds unterscheiden, wird das Bild des Pinsels je nach Bedarf kleiner oder größer skaliert, um an das Rechteck anzupassen. Angenommen, Sie verfügen über ein Metadateibild mit 256 ×256 Pixeln und 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 gestreckt und horizontal gestreckt. Wenn die Abmessungen des Rechtecks denen des Bilds entsprechen, ist das Bild des Pinsels mit dem Bild identisch.

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