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

Artigo
02/29/2024

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

Sintaxe

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

Parâmetros

[in] matrix

Tipo: const Matrix*

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

Retornar valor

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 tem um retângulo que especifica os limites inicial e final do gradiente e um modo ou ângulo que afeta a direção. Se a matriz de transformação do pincel estiver definida para representar qualquer transformação diferente da identidade, os limites e a direção serão transformados de acordo com essa matriz durante a renderização.

A transformação se aplica somente durante a renderização. Os limites armazenados pelo objeto LinearGradientBrush não são alterados pelo método LinearGradientBrush::SetTransform .

Exemplos

O exemplo a seguir cria um pincel de gradiente linear e o usa para preencher um retângulo. Em seguida, o código modifica a matriz de transformação do pincel e preenche um retângulo com o 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	Valor
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