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

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

Voir aussi

Pinceaux et formes remplies

Remplissage de formes avec un pinceau dégradé

Remplissage d’une forme avec un dégradé de couleur

LinearGradientBrush

LinearGradientBrush::SetTransform

Matrice

Représentation matricielle des transformations

Point

Transformations