TextureBrush ::ResetTransform, méthode (gdiplusbrush.h)

Article
02/26/2024

La méthode TextureBrush ::ResetTransform réinitialise la matrice de transformation de ce pinceau de texture à la matrice d’identité. Cela signifie qu’aucune transformation n’a lieu.

Syntaxe

Status ResetTransform();

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

Le fait de définir la matrice de transformation sur la matrice d’identité garantit qu’aucune transformation n’est effectuée. Cette méthode est souvent utilisée pour réinitialiser la transformation avant d’y apporter des ajustements (mise à l’échelle, rotation, etc.).

Exemples

L’exemple suivant crée un pinceau de texture et définit la transformation du pinceau. Ensuite, le code utilise le pinceau transformé pour remplir un rectangle. Ensuite, le code réinitialise la transformation du pinceau et utilise le pinceau non transformé pour remplir un rectangle.

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

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	gdiplusbrush.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll