TextureBrush::SetTransform-Methode (gdiplusbrush.h)

Artikel
08/24/2023

Die TexturBrush::SetTransform-Methode legt die Transformationsmatrix dieses Texturpinsels fest.

Syntax

Status SetTransform(
  [in] const Matrix *matrix
);

Parameter

[in] matrix

Typ: const Matrix*

Zeiger auf ein Matrix-Objekt , das die zu verwendende Transformationsmatrix angibt.

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 TextureBrush-Objekt verwaltet eine Transformationsmatrix, die jede affine Transformation speichern kann. Wenn Sie einen Texturpinsel zum Ausfüllen eines Bereichs verwenden, transformiert Windows GDI+ das Bild des Pinsels gemäß der Transformationsmatrix des Pinsels und füllt dann den Bereich aus. Das transformierte Bild ist nur während des Renderings vorhanden. Das im TextureBrush-Objekt gespeicherte Bild wird nicht transformiert. Angenommen, Sie rufen auf und zeichnen dann einen Bereich mit someTextureBrush.ScaleTransform(3) und zeichnen dann einen Bereich mit someTextureBrush. Die Breite des Pinselbilds verdreifacht sich, wenn der Bereich gezeichnet wird, aber das in someTextureBrush gespeicherte Bild bleibt unverändert.

Beispiele

Im folgenden Beispiel wird ein Texturpinsel erstellt und die Transformation des Pinsels festgelegt. Der Code verwendet dann den transformierten Pinsel, um eine Ellipse zu füllen.

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

   Matrix matrix(2, 0, 0, 1, 0, 0);  // Horizontal stretch

   Image image(L"HouseAndTree.gif");
   TextureBrush textureBrush(&image);
   textureBrush.SetTransform(&matrix);
   graphics.FillEllipse(&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