Metodo LinearGradientBrush::SetTransform (gdiplusbrush.h)

Articolo
02/26/2024

Il metodo LinearGradientBrush::SetTransform imposta la matrice di trasformazione di questo pennello sfumatura lineare.

Sintassi

Status SetTransform(
  [in] const Matrix *matrix
);

Parametri

[in] matrix

Tipo: matrice const*

Puntatore a un oggetto Matrix che specifica 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 ha un rettangolo che specifica i limiti iniziali e finali della sfumatura e una modalità o un angolo che influisce sulla direzione. Se la matrice di trasformazione del pennello è impostata per rappresentare qualsiasi trasformazione diversa dall'identità, i limiti e la direzione vengono trasformati in base a tale matrice durante il rendering.

La trasformazione si applica solo durante il rendering. I limiti archiviati dall'oggetto LinearGradientBrush non vengono modificati dal metodo LinearGradientBrush::SetTransform .

Esempio

L'esempio seguente crea un pennello sfumatura lineare e lo usa per riempire un rettangolo. Successivamente, il codice modifica la matrice di trasformazione del pennello e riempie un rettangolo con il pennello trasformato.

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);
}

Requisiti

Requisito	Valore
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