LinearGradientBrush::SetBlendBellShape, méthode (gdiplusbrush.h)

La méthode LinearGradientBrush::SetBlendBellShape définit la forme de fusion de ce pinceau de dégradé linéaire pour créer un mélange personnalisé basé sur une courbe en forme de cloche.

Syntaxe

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

Paramètres

[in] focus

Type : REAL

Nombre réel qui spécifie la position de la couleur de fin. Ce nombre est un pourcentage de la distance entre les lignes limites et doit être compris entre 0,0 et 1,0.

[in] scale

Type : REAL

Optionnel. Nombre réel qui spécifie le pourcentage de la couleur de fin du dégradé qui est fusionnée, à la position de focus, avec la couleur de début du dégradé. Ce nombre doit être compris entre 0,0 et 1,0. La valeur par défaut est 1.0, qui spécifie que la couleur de fin est à pleine intensité.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Notes

Par défaut, la couleur passe progressivement de la couleur de départ (couleur à la limite de début du pinceau de dégradé linéaire) à la couleur de fin (couleur à la limite de fin du pinceau dégradé linéaire) à mesure que vous passez de la limite de départ à la limite de fin. Vous pouvez personnaliser le positionnement et la fusion des couleurs de début et de fin à l’aide de la méthode LinearGradientBrush::SetBlendBellShape .

La méthode LinearGradientBrush::SetBlendBellShape personnalise le mélange afin qu’il suive une courbe en forme de cloche avec les extrêmes de la base de la cloche aux limites du dégradé. La couleur de début, qui, dans un mélange par défaut, se trouve à la limite de début d’un pinceau de dégradé linéaire, apparaît aux limites de début et de fin du pinceau de dégradé linéaire lorsqu’un mélange en forme de cloche est appliqué. La position de la couleur de fin, qui, dans un mélange par défaut, se trouve à la limite de fin, se trouve quelque part entre les limites et est déterminée par la valeur du focus. En d’autres termes, le focus spécifie la position du sommet de la cloche. Par exemple, une valeur de focus de 0,7 place le pic à 70 % de la distance entre les limites de début et de fin. La couleur de fin apparaît à ce pic.

La couleur de fin d’un mélange en forme de cloche est un pourcentage de la gamme entre la couleur de début de fusion par défaut du dégradé et la couleur de fin de fusion par défaut. Par exemple, supposons qu’un pinceau dégradé linéaire soit construit avec le rouge comme couleur de départ et le bleu comme couleur de fin. Si LinearGradientBrush::SetBlendBellShape est appelé avec une valeur d’échelle de 0,8, la couleur de fin du mélange en forme de cloche est une teinte de 80 % entre le rouge et le bleu (20 % rouge, 80 % bleu). Une valeur d’échelle de 1,0 produit une couleur de fin 100 % bleue.

Exemples

L’exemple suivant crée un pinceau dégradé linéaire, définit un mélange en forme de cloche et utilise le pinceau pour remplir un rectangle. Deux fois plus, le code définit un mélange en cloche avec des valeurs différentes et, à chaque fois, utilise le pinceau pour remplir un rectangle.

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);
}

Spécifications

Voir aussi

Pinceaux et formes remplies

Création d’un dégradé linéaire

Remplissage d’une forme avec un dégradé de couleur

LinearGradientBrush

LinearGradientBrush::GetBlend

LinearGradientBrush::SetBlend

LinearGradientBrush::SetBlendTriangularShape

Utilisation d'un pinceau pour remplir des formes