TextureBrush::SetTransform-Methode (gdiplusbrush.h)
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 |
Weitere Informationen
Koordinatensysteme und Transformationen