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

Article
08/24/2023

La méthode TextureBrush::SetTransform définit la matrice de transformation de ce pinceau de texture.

Syntaxe

Status SetTransform(
  [in] const Matrix *matrix
);

Paramètres

[in] matrix

Type : matrice* const

Pointeur vers un objet Matrix qui spécifie la matrice de transformation à utiliser.

Valeur retournée

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 .

Notes

Un objet TextureBrush conserve une matrice de transformation qui peut stocker n’importe quelle transformation affine. Lorsque vous utilisez un pinceau de texture pour remplir une zone, Windows GDI+ transforme l’image du pinceau en fonction de la matrice de transformation du pinceau, puis remplit la zone. L’image transformée existe uniquement pendant le rendu ; l’image stockée dans l’objet TextureBrush n’est pas transformée. Par exemple, supposons que vous appeliez et que vous peigniez une zone avec someTextureBrush.ScaleTransform(3), puis que vous peigniez une zone avec un certainTextureBrush. La largeur de l’image du pinceau triple lorsque la zone est peinte, mais l’image stockée dans someTextureBrush reste inchangée.

Exemples

L’exemple suivant crée un pinceau de texture et définit la transformation du pinceau. Le code utilise ensuite le pinceau transformé pour remplir une ellipse.

VOID Example_SetTransform(HDC hdc)
{
   Graphics graphics(hdc);

   Matrix matrix(2, 0, 0, 1, 0, 0);  // Horizontal stretch

   Image image(L"HouseAndTree.gif");
   TextureBrush textureBrush(&image);
   textureBrush.SetTransform(&matrix);
   graphics.FillEllipse(&textureBrush, 0, 0, 400, 200); 
}

Configuration requise


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