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

Artigo
03/13/2024

O método Graphics::ResetTransform define a matriz de transformação mundial desse objeto Graphics como a matriz de identidade.

Sintaxe

Status ResetTransform();

Retornar valor

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

A matriz de identidade representa uma transformação que não faz nada. Se a matriz de transformação mundial de um objeto Graphics for a matriz de identidade, nenhuma transformação de mundo será aplicada a itens desenhados por esse objeto Graphics .

Exemplos

O exemplo a seguir define a transformação de mundo de um objeto Graphics como uma rotação de 45 graus e desenha um retângulo. O código chama o método ResetTransform do objeto Graphics e desenha um segundo retângulo. Nenhuma transformação de rotação é aplicada ao segundo retâ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	Valor
Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusgraphics.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll