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

Artículo
02/29/2024

El método LinearGradientBrush::SetTransform establece la matriz de transformación de este pincel de degradado lineal.

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.

Valor devuelto

Tipo: Estado

Si el método se ejecuta 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 LinearGradientBrush tiene un rectángulo que especifica los límites inicial y final del degradado y un modo o ángulo que afecta a la dirección. Si la matriz de transformación del pincel se establece para representar cualquier transformación distinta de la identidad, los límites y la dirección se transforman según esa matriz durante la representación.

La transformación solo se aplica durante la representación. El método LinearGradientBrush no modifica los límites almacenados por el objeto LinearGradientBrush::SetTransform.

Ejemplos

En el ejemplo siguiente se crea un pincel de degradado lineal y se usa para rellenar un rectángulo. A continuación, el código modifica la matriz de transformación del pincel y rellena un rectángulo con el pincel transformado.

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

Requisitos

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