Méthode TextureBrush::GetTransform (gdiplusbrush.h)

La méthode TextureBrush::GetTransform obtient la matrice de transformation de ce pinceau de texture.

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 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, 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 appelez someTextureBrush.ScaleTransform(3), puis que vous peignez une zone avec someTextureBrush. 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 obtient ensuite la matrice de transformation du pinceau et procède à l’inspection ou à l’utilisation des éléments.

VOID Example_GetTransform(HDC hdc)
{
   Graphics graphics(hdc);
  
   // Create a texture brush, and set its transform.
   Image image(L"marble.jpg");
   TextureBrush textureBrush(&image);
   textureBrush.ScaleTransform(3, 2);

   // Obtain information about the texture brush.
   Matrix matrix;
   REAL elements[6];

   textureBrush.GetTransform(&matrix);
   matrix.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

Systèmes de coordonnées et transformations

Remplissage d’une forme avec une texture d’image

Matrice

TextureBrush

TextureBrush::ResetTransform

TextureBrush::SetTransform

Transformations