Método TextureBrush::SetTransform (gdiplusbrush.h)

Artículo
03/14/2023

El método TextureBrush::SetTransform establece la matriz de transformación de este pincel de textura.

Sintaxis

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

Parámetros

[in] matrix

Tipo: matriz const *

Puntero a un objeto Matrix que especifica la matriz de transformación que se va a usar.

Valor devuelto

Tipo: Estado

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Un objeto TextureBrush mantiene una matriz de transformación que puede almacenar cualquier transformación afín. Cuando se usa un pincel de textura para rellenar un área, Windows GDI+ transforma la imagen del pincel según la matriz de transformación del pincel y, a continuación, rellena el área. La imagen transformada solo existe durante la representación; la imagen almacenada en el objeto TextureBrush no se transforma. Por ejemplo, supongamos que llama a y, a continuación, pinta un área con someTextureBrush.ScaleTransform(3) y luego pinta un área con someTextureBrush. El ancho de la imagen del pincel se triplica cuando se pinta el área, pero la imagen almacenada en someTextureBrush permanece sin cambios.

Ejemplos

En el ejemplo siguiente se crea un pincel de textura y se establece la transformación del pincel. A continuación, el código usa el pincel transformado para rellenar una elipse.

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

Requisitos


Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusbrush.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll