Método TextureBrush::ResetTransform (gdiplusbrush.h)

Artigo
02/29/2024

O método TextureBrush::ResetTransform redefine a matriz de transformação desse pincel de textura para a matriz de identidade. Isso significa que nenhuma transformação ocorre.

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

Definir a matriz de transformação como a matriz de identidade garante que nenhuma transformação seja feita. Esse método geralmente é usado para redefinir a transformação antes de fazer ajustes (dimensionamento, rotação e assim por diante) para ele.

Exemplos

O exemplo a seguir cria um pincel de textura e define a transformação do pincel. Em seguida, o código usa o pincel transformado para preencher um retângulo. Em seguida, o código redefine a transformação do pincel e usa o pincel nãotransformado para preencher um retângulo.

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);
}

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