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

Artículo
08/23/2023

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

Sintaxis

Status GetTransform(
  [out] Matrix *matrix
);

Parámetros

[out] matrix

Tipo: Matriz*

Puntero a un objeto Matrix que recibe 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 mantiene una matriz de transformación que puede almacenar cualquier transformación afín. Cuando se usa un pincel de degradado lineal para rellenar un área, GDI+ transforma las líneas de límite del pincel según la matriz de transformación del pincel y, a continuación, rellena el área. Los límites transformados solo existen durante la representación; los límites almacenados en el objeto LinearGradientBrush no se transforman.

Ejemplos

En el ejemplo siguiente se crea un pincel de degradado lineal y se establece su matriz de transformación. A continuación, el código obtiene la matriz de transformación del pincel y continúa inspeccionando o usando los elementos de matriz.

VOID Example_GetTransform(HDC hdc)
{
   Graphics myGraphics(hdc);

   // Construct a linear gradient brush, and set its transformation.
   LinearGradientBrush linGrBrush( 
      Point(0, 0),
      Point(200, 0),
      Color(255, 255, 0, 0),    // red
      Color(255, 0, 0, 255));   // blue

   Matrix matrixSet(0, 1, -1, 0, 0, 0);

   linGrBrush.SetTransform(&matrixSet);

   // Obtain information about the linear gradient brush.
   Matrix matrixGet;
   REAL   elements[6];

   linGrBrush.GetTransform(&matrixGet);
   matrixGet.GetElements(elements);  

   for(INT j = 0; j <= 5; ++j)
   {
       // Inspect or use the value in elements[j].
   }
}

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