Metodo LinearGradientBrush::GetTransform (gdiplusbrush.h)

Il metodo LinearGradientBrush::GetTransform ottiene la matrice di trasformazione di questo pennello sfumatura lineare.

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 LinearGradientBrush gestisce una matrice di trasformazione che può archiviare qualsiasi trasformazione affine. Quando si usa un pennello sfumatura lineare per riempire un'area, GDI+ trasforma le linee di limite del pennello in base alla matrice di trasformazione del pennello e quindi riempie l'area. I limiti trasformati esistono solo durante il rendering; i limiti archiviati nell'oggetto LinearGradientBrush non vengono trasformati.

Esempio

Nell'esempio seguente viene creato un pennello sfumatura lineare e viene impostata la matrice di trasformazione. Successivamente, il codice ottiene la matrice di trasformazione del pennello e procede per controllare o usare gli elementi 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].
   }
}

Requisiti

Vedi anche

Pennelli e forme piene

Riempimento di forme con un pennello sfumatura

Riempimento di una forma con sfumatura di colore

LinearGradientBrush

LinearGradientBrush::SetTransform

Matrice

Rappresentazione tramite matrici delle trasformazioni

Point

Trasformazioni