TextureBrush::ResetTransform-Methode (gdiplusbrush.h)

Artikel
02/26/2024

Die TextureBrush::ResetTransform-Methode setzt die Transformationsmatrix dieses Texturpinsels auf die Identitätsmatrix zurück. Das bedeutet, dass keine Transformation stattfindet.

Syntax

Status ResetTransform();

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Das Festlegen der Transformationsmatrix auf die Identitätsmatrix garantiert, dass keine Transformation durchgeführt wird. Diese Methode wird häufig verwendet, um die Transformation zurückzusetzen, bevor Anpassungen vorgenommen werden (Skalieren, Rotieren usw.).

Beispiele

Im folgenden Beispiel wird ein Texturpinsel erstellt und die Transformation des Pinsels festgelegt. Als Nächstes verwendet der Code den transformierten Pinsel, um ein Rechteck zu füllen. Anschließend setzt der Code die Transformation des Pinsels zurück und verwendet den nicht übersetzten Pinsel, um ein Rechteck zu füllen.

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

   // Create a texture brush, and set its transformation.
   Image image(L"HouseAndTree.Gif");
   TextureBrush textureBrush(&image);
   textureBrush.RotateTransform(30);

   // Fill a rectangle with the transformed texture brush.
   graphics.FillRectangle(&textureBrush, 0, 0, 200, 100);

   textureBrush.ResetTransform();
   
   // Fill a rectangle with the texture brush (no transformation).
   graphics.FillRectangle(&textureBrush, 250, 0, 200, 100);
}

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