Método LinearGradientBrush::LinearGradientBrush(constRectF&,constColor&,constColor&,LinearGradientMode) (gdiplusbrush.h)

Artigo
01/10/2024

Cria um objeto LinearGradientBrush::LinearGradientBrush com base em um retângulo e modo de direção.

Sintaxe

void LinearGradientBrush(
  [in, ref] const RectF &      rect,
  [in, ref] const Color &      color1,
  [in, ref] const Color &      color2,
  [in]      LinearGradientMode mode
);

Parâmetros

[in, ref] rect

Tipo: const RectF

Referência a um retângulo que especifica os pontos inicial e final do gradiente. A direção do gradiente, especificada por modo, afeta a forma como esses pontos são definidos. As dimensões do retângulo afetam a direção do gradiente para o modo diagonal para frente e para o modo diagonal para trás.

[in, ref] color1

Tipo: const Color

Referência a um objeto Color que especifica a cor na linha de limite inicial desse pincel de gradiente linear.

[in, ref] color2

Tipo: const Color

Referência a um objeto Color que especifica a cor na linha de limite final desse pincel de gradiente linear.

[in] mode

Tipo: LinearGradientMode

Elemento da enumeração LinearGradientMode que especifica a direção do gradiente.

Retornar valor

Nenhum

Comentários

O limite inicial do gradiente é uma linha reta que passa pelo ponto inicial ou faz bordas do retângulo retângulo retângulo. O limite final do gradiente é uma linha reta paralela à linha de limite inicial e que passa pelo ponto final ou faz bordas do retângulo. A "linha direcional", uma linha reta imaginária, é perpendicular às linhas de limite. A cor do gradiente é constante ao longo das linhas paralelas às linhas de limite. O gradiente muda gradualmente da cor inicial para a cor final ao longo da linha direcional.

O modo afeta os limites do gradiente:

Modo vertical As linhas de limite são paralelas à parte superior (e inferior) do retângulo retângulo rect. As linhas de limite inicial e final são a parte superior e inferior, respectivamente, do retângulo retângulo rect.
Modo horizontal As linhas de limite são paralelas à esquerda (e à direita) do retângulo retângulo rect. As linhas de limite inicial e final são a esquerda e a direita, respectivamente, do retângulo retângulo rect.
Modo diagonal para a frente As linhas de limite são paralelas à linha diagonal definida pelo canto superior direito e canto inferior esquerdo do retângulo retângulo. A linha de limite inicial passa pelo ponto inicial (canto superior esquerdo do retângulo rect). A linha de limite final passa pelo ponto final (canto inferior direito do retângulo rect). Observe que os pontos inicial e final são opostos dos pontos inicial e final para o modo diagonal para trás.
Modo diagonal para trás As linhas de limite são paralelas à linha diagonal definida pelo canto superior esquerdo e canto inferior direito do retângulo retângulo. A linha de limite inicial passa pelo ponto inicial (canto superior direito do retângulo rect). A linha de limite final passa pelo ponto final (canto inferior esquerdo do retângulo rect). Observe que os pontos inicial e final são opostos dos pontos inicial e final para o modo diagonal para frente.

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