Metodo PathGradientBrush::RotateTransform (gdipluspath.h)

Articolo
08/24/2023

Il metodo PathGradientBrush::RotateTransform aggiorna la matrice di trasformazione corrente del pennello con il prodotto stesso e una matrice di rotazione.

Sintassi

Status RotateTransform(
  [in] REAL        angle,
  [in] MatrixOrder order
);

Parametri

[in] angle

Tipo: REAL

Numero reale che specifica l'angolo di rotazione in gradi.

[in] order

Tipo: MatrixOrder

Facoltativa. Elemento dell'enumerazione MatrixOrder che specifica l'ordine della moltiplicazione. MatrixOrderPrepend specifica che la matrice di rotazione si trova a sinistra e MatrixOrderAppend specifica che la matrice di rotazione si trova a destra. Il valore predefinito è MatrixOrderPrepend.

Valore restituito

Tipo: Stato

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

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

Commenti

Una singola matrice di ×3 può archiviare qualsiasi sequenza di trasformazioni affine. Se sono presenti più di 3 matrici ×3, ognuna delle quali rappresenta una trasformazione affine, il prodotto di tali matrici è una singola matrice 3 ×3 che rappresenta l'intera sequenza di trasformazioni. La trasformazione rappresentata da tale prodotto è detta trasformazione composita. Si supponga, ad esempio, che la matrice T rappresenti una traslazione e una matrice R rappresenti una rotazione. Se matrice M è il prodotto TR, matrice M rappresenta una trasformazione composita: prima traduci, quindi ruota.

Esempio

Nell'esempio seguente viene creato un oggetto PathGradientBrush basato su un percorso triangolare. Le chiamate ai metodi PathGradientBrush::ScaleTransform e PathGradientBrush::RotateTransform dell'oggetto PathGradientBrush impostano gli elementi della matrice di trasformazione del pennello in modo che rappresenti una trasformazione composita: prima scala, quindi ruota. Il codice usa il pennello sfumato del percorso due volte per disegnare un rettangolo: una volta prima che la trasformazione venga impostata e una volta dopo l'impostazione della trasformazione.

VOID Example_RotateTransform(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a path gradient brush based on an array of points.
   Point pts[] = {Point(0, 0), Point(50, 0), Point(50, 50)};
   PathGradientBrush pthGrBrush(pts, 3);

   // Fill an area with the path gradient brush (no transformation).
   graphics.FillRectangle(&pthGrBrush, 0, 0, 500, 500);

   pthGrBrush.ScaleTransform(3.0f, 1.0f);                 // first scale
   pthGrBrush.RotateTransform(60.0f, MatrixOrderAppend);  // then rotate

   // Fill the same area with the transformed path gradient brush.
   graphics.FillRectangle(&pthGrBrush, 0, 0, 500, 500);
}

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	gdipluspath.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll