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

Artículo
08/23/2023

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

Sintaxis

Status SetBlendBellShape(
  [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::SetBlendBellShape .

El método LinearGradientBrush::SetBlendBellShape personaliza la mezcla para que siga una curva en forma de campana con los extremos de la base de la campana 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 de campana. 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 de la campana. Por ejemplo, un valor de foco de 0,7 coloca el pico en el 70 % de la distancia entre los límites inicial y final. El color final aparece en este pico.

El color final de una mezcla en forma de campana 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::SetBlendBellShape con un valor de escala de 0,8, el color final de la mezcla en forma de campana es un tono del 80 por ciento entre rojo y azul (20 por ciento rojo, 80 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 degradado lineal, se establece una mezcla en forma de campana y se usa el pincel para rellenar un rectángulo. Dos veces más, el código establece una mezcla en forma de campana con valores diferentes y, cada vez, usa el pincel para rellenar un rectángulo.

VOID Example_SetBlendBell(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.SetBlendBellShape(0.5f, 0.6f);
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 500, 50);

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

   linGrBrush.SetBlendBellShape(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