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

Artigo
08/23/2023

O método LinearGradientBrush::GetTransform obtém a matriz de transformação desse pincel de gradiente linear.

Sintaxe

Status GetTransform(
  [out] Matrix *matrix
);

Parâmetros

[out] matrix

Tipo: Matriz*

Ponteiro para um objeto Matrix que recebe a matriz de transformação.

Valor retornado

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Um objeto LinearGradientBrush mantém uma matriz de transformação que pode armazenar qualquer transformação afim. Quando você usa um pincel de gradiente linear para preencher uma área, o GDI+ transforma as linhas de limite do pincel de acordo com a matriz de transformação do pincel e preenche a área. Os limites transformados existem somente durante a renderização; os limites armazenados no objeto LinearGradientBrush não são transformados.

Exemplos

O exemplo a seguir cria um pincel de gradiente linear e define sua matriz de transformação. Em seguida, o código obtém a matriz de transformação do pincel e passa a inspecionar ou usar os 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 com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusbrush.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll