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

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

Syntaxe

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

La méthode LinearGradientBrush::SetBlendTriangularShape personnalise le mélange afin qu’il suive une forme triangulaire avec les extrêmes de la base du triangle aux limites du dégradé. La couleur de départ, qui, dans un mélange par défaut, se trouve à la limite de départ 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 de forme triangulaire 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 du triangle. Par exemple, une valeur de focus de 0,5 place le pic à mi-chemin 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 de forme triangulaire est un pourcentage de la gamme entre la couleur de départ 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::SetBlendTriangularShape est appelé avec une valeur d’échelle de 0,3, la couleur de fin du mélange de forme triangulaire est une teinte de 30 % entre le rouge et le bleu (70 % rouge, 30 % 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 de forme triangulaire et utilise le pinceau pour remplir un rectangle. Deux fois plus, le code définit un mélange de forme triangulaire avec des valeurs différentes et, à chaque fois, utilise le pinceau pour remplir un rectangle.

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

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::SetBlendBellShape

Point