Matrix::Reset-Methode (gdiplusmatrix.h)

Die Matrix::Reset-Methode aktualisiert diese Matrix mit den Elementen der Identitätsmatrix.

Syntax

Status Reset();

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

Die Elemente auf der Standard Diagonale der Identitätsmatrix sind 1. Alle anderen Elemente der Identitätsmatrix sind 0.

Beispiele

Im folgenden Beispiel wird ein Matrix-Objekt erstellt, das eine horizontale Skalierung um den Faktor 5 und eine vertikale Skalierung um den Faktor 3 darstellt. Der Code ruft die Matrix::Reset-Methode auf, um die Elemente dieser Matrix durch die Elemente der Identitätsmatrix zu ersetzen. Anschließend ruft der Code die Matrix::Translate-Methode auf, um die Matrix mit dem Produkt selbst (der Identität) und einer Übersetzungsmatrix zu aktualisieren. Das Ergebnis ist, dass die Matrix nur die Übersetzung und nicht die Skalierung darstellt. Der Code verwendet die Matrix, um die Welttransformation eines Graphics-Objekts festzulegen, und zeichnet dann ein Rechteck, das gemäß dieser Welttransformation transformiert wird.

VOID Example_Reset(HDC hdc)
{
   Graphics graphics(hdc);
   Pen pen(Color(255, 0, 0, 255));

   Matrix matrix(5.0f, 0.0f, 0.0f, 3.0f, 0.0f, 0.0f);
   matrix.Reset();
   matrix.Translate(50.0f, 40.0f);

   graphics.SetTransform(&matrix);
   graphics.DrawRectangle(&pen, 0, 0, 100, 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	gdiplusmatrix.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll

Weitere Informationen

Globale und lokale Transformationen

Matrix

Matrixdarstellung von Transformationen

Matrix::IsIdentity

Transformationen