PathGradientBrush ::SetBlendTriangularShape, méthode (gdipluspath.h)
La méthode PathGradientBrush ::SetBlendTriangularShape définit la forme de fusion de ce pinceau de dégradé de chemin d’accès.
Syntaxe
Status SetBlendTriangularShape(
[in] REAL focus,
[in, optional] REAL scale
);
Paramètres
[in] focus
Type : REAL
Nombre réel qui spécifie où la couleur centrale sera à son intensité la plus élevée. Ce nombre doit être compris entre 0 et 1.
[in, optional] scale
Type : REAL
facultatif. Nombre réel qui spécifie l’intensité maximale de la couleur du centre qui est fusionnée avec la couleur de limite. Ce nombre doit être compris entre 0 et 1. La valeur par défaut est 1.
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 .
Remarques
Par défaut, lorsque vous passez de la limite d’un dégradé de chemin au point central, la couleur change progressivement de la couleur de la limite à la couleur du centre. Vous pouvez personnaliser le positionnement et la fusion des couleurs de la limite et du centre en appelant la méthode PathGradientBrush ::SetBlendTriangularShape .
Exemples
L’exemple suivant crée un objet PathGradientBrush basé sur une ellipse. Le code appelle la méthode PathGradientBrush ::SetBlendTriangularShape de l’objet PathGradientBrush , en passant un focus de 0,2 et une échelle de 0,7. Ensuite, le code utilise le pinceau dégradé de chemin d’accès pour peindre un rectangle qui contient l’ellipse.
VOID Example_SetBlendShape(HDC hdc)
{
Graphics graphics(hdc);
// Create a path that consists of a single ellipse.
GraphicsPath path;
path.AddEllipse(0, 0, 200, 100);
// Use the path to construct a brush.
PathGradientBrush pthGrBrush(&path);
// Set the color at the center of the path to red.
pthGrBrush.SetCenterColor(Color(255, 255, 0, 0));
// Set the color along the entire boundary of the path to blue.
Color colors[] = {Color(255, 0, 0, 255)};
INT count = 1;
pthGrBrush.SetSurroundColors(colors, &count);
pthGrBrush.SetBlendTriangularShape(0.2f, 0.7f);
// The color is blue on the boundary and at the center.
// At points that are 20 percent of the way from the boundary to the
// center, the color is 70 percent red and 30 percent blue.
graphics.FillRectangle(&pthGrBrush, 0, 0, 300, 300);
}
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows XP, Windows 2000 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | gdipluspath.h (include Gdiplus.h) |
Bibliothèque | Gdiplus.lib |
DLL | Gdiplus.dll |
Voir aussi
Création d’un dégradé de chemin
Remplissage d’une forme avec un dégradé de couleur
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour