Método PathGradientBrush::SetSurroundColors (gdipluspath.h)

Artigo
03/14/2023

O método PathGradientBrush::SetSurroundColors define as cores surround desse pincel de gradiente de caminho. As cores surround são cores especificadas para pontos discretos no caminho de limite do pincel.

Sintaxe

Status SetSurroundColors(
  [in]      const Color *colors,
  [in, out] INT         *count
);

Parâmetros

[in] colors

Tipo: const Color*

Ponteiro para uma matriz de objetos Color que especificam as cores do surround.

[in, out] count

Tipo: INT*

Ponteiro para um inteiro que, na entrada, especifica o número de objetos Color na matriz de cores . Se o método for bem-sucedido, esse parâmetro, na saída, receberá o número de cores surround definidas. Se o método falhar, esse parâmetro não receberá um valor.

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 pincel de gradiente de caminho tem um caminho de limite e um ponto central. O ponto central é definido como uma única cor, mas você pode especificar cores diferentes para vários pontos no limite. Por exemplo, suponha que você especifique vermelho para a cor central e especifique azul, verde e amarelo para pontos distintos no limite. Em seguida, à medida que você se move ao longo do limite, a cor mudará gradualmente de azul para verde para amarelo e de volta para azul. À medida que você se move ao longo de uma linha reta de qualquer ponto no limite para o ponto central, a cor mudará da cor desse ponto de limite para vermelho.

Exemplos

O exemplo a seguir cria um objeto PathGradientBrush com base em uma matriz de três pontos que define um caminho triangular. O código também inicializa uma matriz de três objetos Color . A chamada para o método PathGradientBrush::SetSurroundColors associa cada cor na matriz de cores ao ponto correspondente (mesmo índice) na matriz de pontos. Depois que as cores surround do pincel de gradiente de caminho tiverem sido definidas, o método Graphics::FillRectangle usará o pincel de gradiente de caminho para pintar um retângulo que inclui o caminho triangular.

Uma borda do triângulo renderizado muda gradualmente de vermelho para verde. A próxima borda muda gradualmente de verde para preto, e a terceira borda muda gradualmente de preto para vermelho. O código não define a cor central, portanto, a cor central tem o valor padrão preto. À medida que você se move ao longo de uma linha reta de qualquer ponto no caminho de limite (triângulo) para o ponto central, a cor muda gradualmente da cor desse ponto de limite para preto.

VOID Example_SetSurColor(HDC hdc)
{
   Graphics graphics(hdc);

   Point pts[] = {
      Point(20, 20), 
      Point(100, 20), 
      Point(100, 100)};

   Color cols[] = {
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 255, 0),  // green
      Color(255, 0, 0, 0)};   // black

   INT count = 3;
   PathGradientBrush pthGrBrush(pts, 3);
   pthGrBrush.SetSurroundColors(cols, &count);
   
   graphics.FillRectangle(&pthGrBrush, 0, 0, 200, 200);
}

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	gdipluspath.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll