Método Pen::ResetTransform (gdipluspen.h)

Artigo
02/26/2024

O método Pen::ResetTransform define a matriz de transformação mundial desse objeto Pen 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 Ok .

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 Pen for a matriz de identidade, nenhuma transformação de mundo será aplicada a itens desenhados usando esse objeto Pen .

Exemplos

O exemplo a seguir cria um objeto Pen , define uma matriz de dimensionamento para a caneta e desenha um retângulo. Em seguida, o código redefine a transformação da caneta e desenha um segundo retângulo.

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

   // Create a pen, and set its transformation.
   Pen pen(Color(255, 0, 0, 255), 2);
   pen.ScaleTransform(8, 4);

   // Draw a rectangle with the transformed pen.
   graphics.DrawRectangle(&pen, 50, 50, 150, 100);

   pen.ResetTransform();

   // Draw a rectangle with no pen transformation.
   graphics.DrawRectangle(&pen, 250, 50, 150, 100);
}

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	gdipluspen.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll