Metodo TextureBrush::SetTransform (gdiplusbrush.h)

Articolo
08/24/2023

Il metodo TextureBrush::SetTransform imposta la matrice di trasformazione di questo pennello di trama.

Sintassi

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

Parametri

[in] matrix

Tipo: matrice const *

Puntatore a un oggetto Matrix che specifica la matrice di trasformazione da utilizzare.

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

Un oggetto TextureBrush mantiene una matrice di trasformazione in grado di archiviare qualsiasi trasformazione affine. Quando si usa un pennello trama per riempire un'area, Windows 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 e disegnare un'area con someTextureBrush.ScaleTransform(3) e quindi disegnare un'area con someTextureBrush. La larghezza dell'immagine del pennello viene triplicata quando l'area viene dipinta, ma l'immagine archiviata in someTextureBrush rimane invariata.

Esempio

Nell'esempio seguente viene creato un pennello di trama e viene impostata la trasformazione del pennello. Il codice usa quindi il pennello trasformato per riempire un'ellisse.

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

   Matrix matrix(2, 0, 0, 1, 0, 0);  // Horizontal stretch

   Image image(L"HouseAndTree.gif");
   TextureBrush textureBrush(&image);
   textureBrush.SetTransform(&matrix);
   graphics.FillEllipse(&textureBrush, 0, 0, 400, 200); 
}

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