Método Graphics::ResetTransform (gdiplusgraphics.h)

Artículo
03/11/2023

El método Graphics::ResetTransform establece la matriz de transformación mundial de este objeto Graphics en la matriz de identidad.

Sintaxis

Status ResetTransform();

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

La matriz de identidad representa una transformación que no hace nada. Si la matriz de transformación mundial de un objeto Graphics es la matriz de identidad, no se aplica ninguna transformación del mundo a los elementos dibujados por ese objeto Graphics .

Ejemplos

En el ejemplo siguiente se establece la transformación mundial de un objeto Graphics en un giro de 45 grados y, a continuación, se dibuja un rectángulo. El código llama al método ResetTransform del objeto Graphics y, a continuación, dibuja un segundo rectángulo. No se aplica ninguna transformación de rotación al segundo rectángulo.

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

   // Rotate the transformation and draw a rectangle.
   graphics.RotateTransform(45.0f);
   Pen blackPen(Color(255, 0, 0, 0));
   graphics.DrawRectangle(&blackPen, 100, 0, 100, 50);

   // Reset the transformation to identity, and draw a second rectangle.
   graphics.ResetTransform();
   Pen redPen(Color(255, 255, 0, 0));
   graphics.DrawRectangle(&redPen, 110, 0, 100, 50);
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusgraphics.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll