Método Matrix::Reset (gdiplusmatrix.h)

O método Matrix::Reset atualiza essa matriz com os elementos da matriz de identidade.

Sintaxe

Status Reset();

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

Os elementos no main diagonal da matriz de identidade são 1. Todos os outros elementos da matriz de identidade são 0.

Exemplos

O exemplo a seguir cria um objeto Matrix que representa um dimensionamento horizontal por um fator de 5 e um dimensionamento vertical por um fator de 3. O código chama o método Matrix::Reset para substituir os elementos dessa matriz pelos elementos da matriz de identidade. Em seguida, o código chama o método Matrix::Translate para atualizar a matriz com o produto de si mesmo (a identidade) e uma matriz de tradução. O resultado é que a matriz representa apenas a tradução, não o dimensionamento. O código usa a matriz para definir a transformação de mundo de um objeto Graphics e, em seguida, desenha um retângulo que é transformado de acordo com essa transformação de mundo.

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

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

Confira também

Transformações globais e locais

Matriz

Representação matricial de transformações

Matrix::IsIdentity

Transformações