LinearGradientBrush::GetTransform, méthode (gdiplusbrush.h)

Article
08/23/2023

La méthode LinearGradientBrush::GetTransform obtient la matrice de transformation de ce pinceau de dégradé linéaire.

Syntaxe

Status GetTransform(
  [out] Matrix *matrix
);

Paramètres

[out] matrix

Type : Matrice*

Pointeur vers un objet Matrix qui reçoit la matrice de transformation.

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 LinearGradientBrush gère une matrice de transformation qui peut stocker n’importe quelle transformation affine. Lorsque vous utilisez un pinceau dégradé linéaire pour remplir une zone, GDI+ transforme les lignes limites du pinceau en fonction de la matrice de transformation du pinceau, puis remplit la zone. Les limites transformées existent uniquement pendant le rendu ; Les limites stockées dans l’objet LinearGradientBrush ne sont pas transformées.

Exemples

L’exemple suivant crée un pinceau de dégradé linéaire et définit sa matrice de transformation. Ensuite, le code obtient la matrice de transformation du pinceau et procède à l’inspection ou à l’utilisation des éléments de matrice.

VOID Example_GetTransform(HDC hdc)
{
   Graphics myGraphics(hdc);

   // Construct a linear gradient brush, and set its transformation.
   LinearGradientBrush linGrBrush( 
      Point(0, 0),
      Point(200, 0),
      Color(255, 255, 0, 0),    // red
      Color(255, 0, 0, 255));   // blue

   Matrix matrixSet(0, 1, -1, 0, 0, 0);

   linGrBrush.SetTransform(&matrixSet);

   // Obtain information about the linear gradient brush.
   Matrix matrixGet;
   REAL   elements[6];

   linGrBrush.GetTransform(&matrixGet);
   matrixGet.GetElements(elements);  

   for(INT j = 0; j <= 5; ++j)
   {
       // Inspect or use the value in elements[j].
   }
}

Spécifications


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