Partager via


Matrix ::Reset, méthode (gdiplusmatrix.h)

La méthode Matrix ::Reset met à jour cette matrice avec les éléments de la matrice d’identité.

Syntaxe

Status Reset();

Valeur de retour

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Remarques

Les éléments de la main diagonale de la matrice d’identité sont 1. Tous les autres éléments de la matrice d’identité sont 0.

Exemples

L’exemple suivant crée un objet Matrix qui représente une mise à l’échelle horizontale d’un facteur 5 et une mise à l’échelle verticale d’un facteur 3. Le code appelle la méthode Matrix ::Reset pour remplacer les éléments de cette matrice par les éléments de la matrice d’identité. Ensuite, le code appelle la méthode Matrix ::Translate pour mettre à jour la matrice avec le produit d’elle-même (l’identité) et une matrice de traduction. Le résultat est que la matrice représente uniquement la traduction, pas la mise à l’échelle. Le code utilise la matrice pour définir la transformation mondiale d’un objet Graphics , puis dessine un rectangle qui est transformé en fonction de cette transformation mondiale.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête gdiplusmatrix.h (inclure Gdiplus.h)
Bibliothèque Gdiplus.lib
DLL Gdiplus.dll

Voir aussi

Transformations globales et locales

Matrice

Représentation matricielle des transformations

Matrice ::IsIdentity

Transformations