Compartir a través de


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

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

Consulte también

Transformaciones globales y locales

Matriz

Representación matricial de transformaciones

Matrix::IsIdentity

Transformaciones