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

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

Voir aussi

Pinceaux et formes remplies

Création d’un dégradé linéaire

Remplissage de formes avec un pinceau dégradé

LinearGradientBrush

LinearGradientBrush ::GetTransform

LinearGradientBrush ::ResetTransform

Matrice

Représentation matricielle des transformations

Rect

Transformations