Metodo TextureBrush::GetTransform (gdiplusbrush.h)

Articolo
08/23/2023

Il metodo TextureBrush::GetTransform ottiene la matrice di trasformazione di questo pennello di trama.

Sintassi

Status GetTransform(
  [out] Matrix *matrix
);

Parametri

[out] matrix

Tipo: Matrice*

Puntatore a un oggetto Matrix che riceve la matrice di trasformazione.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Un oggetto TextureBrush gestisce una matrice di trasformazione che può archiviare qualsiasi trasformazione affine. Quando si usa un pennello di trama per riempire un'area, GDI+ trasforma l'immagine del pennello in base alla matrice di trasformazione del pennello e quindi riempie l'area. L'immagine trasformata esiste solo durante il rendering; l'immagine archiviata nell'oggetto TextureBrush non viene trasformata. Si supponga, ad esempio, di chiamare alcuniTextureBrush.ScaleTransform(3) e quindi disegnare un'area con alcuniTextureBrush. La larghezza dell'immagine del pennello si triplica quando l'area viene dipinta, ma l'immagine archiviata in alcuniTextureBrush rimane invariata.

Esempio

Nell'esempio seguente viene creato un pennello di trama e viene impostata la trasformazione del pennello. Il codice ottiene quindi la matrice di trasformazione del pennello e procede per controllare o usare gli elementi.

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].
   }
}

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusbrush.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll