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

Artículo
03/13/2024

El método Matrix::Reset actualiza esta matriz con los elementos de la matriz de identidad.

Sintaxis

Status Reset();

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

Los elementos de la diagonal principal de la matriz de identidades son 1. Todos los demás elementos de la matriz de identidad son 0.

Ejemplos

En el ejemplo siguiente se crea un objeto Matrix que representa un escalado horizontal mediante un factor de 5 y un escalado vertical por un factor de 3. El código llama al método Matrix::Reset para reemplazar los elementos de esa matriz por los elementos de la matriz de identidad. A continuación, el código llama al método Matrix::Translate para actualizar la matriz con el producto de sí mismo (la identidad) y una matriz de traducción. El resultado es que la matriz representa solo la traducción, no el escalado. El código usa la matriz para establecer la transformación mundial de un objeto Graphics y, a continuación, dibuja un rectángulo que se transforma según esa transformación mundial.

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	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	gdiplusmatrix.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll