TextureBrush::GetTransform-Methode (gdiplusbrush.h)

Artikel
08/23/2023

Die TexturBrush::GetTransform-Methode ruft die Transformationsmatrix dieses Texturpinsels ab.

Syntax

Status GetTransform(
  [out] Matrix *matrix
);

Parameter

[out] matrix

Typ: Matrix*

Zeiger auf ein Matrix-Objekt , das die Transformationsmatrix empfängt.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Ein TextureBrush-Objekt verwaltet eine Transformationsmatrix, die jede affine Transformation speichern kann. Wenn Sie einen Texturpinsel zum Ausfüllen eines Bereichs verwenden, transformiert GDI+ das Bild des Pinsels gemäß der Transformationsmatrix des Pinsels und füllt dann den Bereich aus. Das transformierte Bild ist nur während des Renderings vorhanden. Das im TextureBrush-Objekt gespeicherte Bild wird nicht transformiert. Angenommen, Sie rufen someTextureBrush.ScaleTransform(3) auf und zeichnen dann einen Bereich mit someTextureBrush. Die Breite des Pinselbilds verdreifacht sich, wenn der Bereich gezeichnet wird, aber das in someTextureBrush gespeicherte Bild bleibt unverändert.

Beispiele

Im folgenden Beispiel wird ein Texturpinsel erstellt und die Transformation des Pinsels festgelegt. Der Code ruft dann die Transformationsmatrix des Pinsels ab und fährt fort, die Elemente zu untersuchen oder zu verwenden.

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusbrush.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll