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

Article
03/04/2024

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

Syntaxe

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

Paramètres

[in] matrix

Type : const Matrix*

Pointeur vers un objet Matrix qui spécifie 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 .

Remarques

Un objet LinearGradientBrush a un rectangle qui spécifie les limites de début et de fin du dégradé, ainsi qu’un mode ou un angle qui affecte la direction. Si la matrice de transformation du pinceau est définie pour représenter toute transformation autre que l’identité, les limites et la direction sont transformées en fonction de cette matrice pendant le rendu.

La transformation s’applique uniquement pendant le rendu. Les limites stockées par l’objet LinearGradientBrush ne sont pas modifiées par la méthode LinearGradientBrush ::SetTransform .

Exemples

L’exemple suivant crée un pinceau de dégradé linéaire et l’utilise pour remplir un rectangle. Ensuite, le code modifie la matrice de transformation du pinceau et remplit un rectangle avec le pinceau transformé.

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

   LinearGradientBrush linGrBrush( 
      Rect(0, 0, 100, 50),
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 0, 255),  // blue
      LinearGradientModeHorizontal);

   Matrix matrix(2.0, 0, 0, 1, 0, 0);  // horizontal doubling

   // Fill a large area with the linear gradient brush (no transformation).
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 800, 50);

   linGrBrush.SetTransform(&matrix);

   // Fill a large area with the transformed linear gradient brush.
   myGraphics.FillRectangle(&linGrBrush, 0, 75, 800, 50);
}

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