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

Artículo
03/14/2023

El método LinearGradientBrush::SetBlendTriangularShape establece la forma de mezcla de este pincel de degradado lineal para crear una mezcla personalizada basada en una forma triangular.

Sintaxis

Status SetBlendTriangularShape(
  [in] REAL focus,
  [in] REAL scale
);

Parámetros

[in] focus

Tipo: REAL

Número real que especifica la posición del color final. Este número es un porcentaje de la distancia entre las líneas de límite y debe estar en el intervalo comprendido entre 0,0 y 1,0.

[in] scale

Tipo: REAL

Opcional. Número real que especifica el porcentaje del color final del degradado que se mezcla, en la posición del foco, con el color inicial del degradado. Este número debe estar en el intervalo comprendido entre 0,0 y 1,0. El valor predeterminado es 1,0, que especifica que el color final está en intensidad completa.

Valor devuelto

Tipo: Estado

Si el método se realiza 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

De forma predeterminada, el color cambia gradualmente desde el color inicial (color en el límite inicial del pincel de degradado lineal) al color final (color en el límite final del pincel de degradado lineal) a medida que se mueve del límite inicial al límite final. Puede personalizar el posicionamiento y la combinación de los colores iniciales y finales mediante el método LinearGradientBrush::SetBlendTriangularShape .

El método LinearGradientBrush::SetBlendTriangularShape personaliza la mezcla para que siga una forma triangular con los extremos de la base del triángulo en los límites del degradado. El color inicial, que, en una combinación predeterminada, está en el límite inicial de un pincel de degradado lineal, aparece en los límites inicial y final del pincel de degradado lineal cuando se aplica una mezcla en forma triangular. La posición del color final, que, en una combinación predeterminada, está en el límite final, está en algún lugar entre los límites y viene determinado por el valor del foco. En otras palabras, el foco especifica la posición del pico del triángulo. Por ejemplo, un valor de foco de 0,5 coloca el pico medio camino entre los límites inicial y final. El color final aparece en este pico.

El color final de una mezcla con forma triangular es un porcentaje de la gama entre el color inicial de combinación predeterminada del degradado y el color final de combinación predeterminada. Por ejemplo, supongamos que un pincel de degradado lineal se construye con rojo como color inicial y azul como color final. Si se llama a LinearGradientBrush::SetBlendTriangularShape con un valor de escala de 0,3, el color final de la mezcla en forma triangular es un tono que es 30 por ciento entre rojo y azul (70 por ciento rojo, 30 por ciento azul). Un valor de escala de 1,0 genera un color final que es 100 % azul.

Ejemplos

En el ejemplo siguiente se crea un pincel de degradado lineal, se establece una mezcla con forma triangular y se usa el pincel para rellenar un rectángulo. Dos veces más, el código establece una combinación en forma triangular con valores diferentes y, cada vez, usa el pincel para rellenar un rectángulo.

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

   LinearGradientBrush linGrBrush(
      Point(0, 0),
      Point(500, 0),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255));  // blue

   linGrBrush.SetBlendTriangularShape(0.5f, 0.6f);
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 500, 50);

   linGrBrush.SetBlendTriangularShape(0.5f, 0.8f); 
   myGraphics.FillRectangle(&linGrBrush, 0, 75, 500, 50);

   linGrBrush.SetBlendTriangularShape(0.5f, 1.0f); 
   myGraphics.FillRectangle(&linGrBrush, 0, 150, 500, 50);
}

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