LinearGradientBrush Classe

Définition

public ref class LinearGradientBrush sealed : GradientBrush

/// [Windows.Foundation.Metadata.Activatable(Microsoft.UI.Xaml.Media.ILinearGradientBrushFactory, 65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LinearGradientBrush final : GradientBrush

[Windows.Foundation.Metadata.Activatable(typeof(Microsoft.UI.Xaml.Media.ILinearGradientBrushFactory), 65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class LinearGradientBrush : GradientBrush

Public NotInheritable Class LinearGradientBrush
Inherits GradientBrush

<LinearGradientBrush ...>
  oneOrMoreGradientStops
</LinearGradientBrush

Héritage

Object Platform::Object IInspectable DependencyObject Brush GradientBrush LinearGradientBrush

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemples

Cet exemple crée un dégradé linéaire avec quatre couleurs et l’utilise pour peindre un rectangle.

<StackPanel>
  <!-- This rectangle is painted with a vertical linear gradient. -->
  <Rectangle Width="200" Height="100">
    <Rectangle.Fill>
      <LinearGradientBrush StartPoint="0.5,0" EndPoint="0.5,1">
        <GradientStop Color="Yellow" Offset="0.0" />
        <GradientStop Color="Red" Offset="0.25" />
        <GradientStop Color="Blue" Offset="0.75" />
        <GradientStop Color="LimeGreen" Offset="1.0" />
      </LinearGradientBrush>
    </Rectangle.Fill>
  </Rectangle>
</StackPanel>

Remarques

LinearGradientBrush est un type de pinceau utilisé pour de nombreuses propriétés d’interface utilisateur possibles qui utilisent un pinceau pour remplir une partie ou l’ensemble de la zone visuelle d’un objet dans l’interface utilisateur de l’application. Voici quelques-unes des propriétés les plus couramment utilisées qui utilisent une valeur de pinceau : Control.Background, Control.Foreground, Shape.Fill, Control.BorderBrush, Panel.Background, TextBlock.Foreground. LinearGradientBrush est une alternative au type SolidColorBrush plus couramment utilisé.

Les propriétés StartPoint et EndPoint de LinearGradientBrush décrivent deux points dans un espace de coordonnées relatif. Cela crée une orientation pour le dégradé, et spécifie généralement un dégradé horizontal ou un dégradé vertical. Un dégradé diagonal peut également être utilisé. Un LinearGradientBrush a généralement deux valeurs GradientStop ou plus pour la propriété GradientStops (collection ordonnée). Chaque dégradéStop spécifie une couleur et un décalage. Le décalage représente une position comprise entre 0 ( le Point de départ) et 1 ( EndPoint) le long du dégradé, et la longueur réelle du pinceau et son dégradé sont ajustés en fonction de l’interface utilisateur où vous appliquez votre LinearGradientBrush en tant que valeur. Pour plus d’informations sur la façon dont les valeurs offset sont définies et la façon dont Offset, StartPoint et EndPoint sont associés, consultez pinceaux XAML. Il est courant d’utiliser

Vous pouvez utiliser la valeur transparente pour l’une des couleurs GradientStop . Bien que cela n’applique visuellement aucune modification à l’interface utilisateur (il est transparent), ce point est détectable à des fins de test d’accès. Pour plus d’informations sur les tests de positionnement, consultez la section « Test d’accès » des interactions de la souris.

Les valeurs GradientStop d’un LinearGradientBrush peuvent être animées dans le cadre de transitions ou d’animations décoratives. Utilisez l’un des types d’animation dédiés qui peuvent animer une valeur de couleur . Cela implique généralement d’avoir .(GradientStop.Color) une partie d’un chemin de propriété plus long pour une valeur Storyboard.TargetProperty . Pour plus d’informations sur le ciblage des propriétés et sur la façon d’animer des propriétés qui utilisent des valeurs de pinceau , consultez animations storyboarded.

Pinceaux en tant que ressources XAML

Chacun des types de pinceau pouvant être déclarés en XAML (SolidColorBrush, LinearGradientBrush, ImageBrush) est destiné à être défini comme une ressource, afin de pouvoir réutiliser ce pinceau en tant que ressource dans votre application. La syntaxe XAML indiquée pour les types de pinceau est appropriée pour définir le pinceau en tant que ressource. Lorsque vous déclarez un pinceau en tant que ressource, vous avez également besoin d’un attribut x :Key que vous utiliserez ultérieurement pour faire référence à cette ressource à partir d’autres définitions d’interface utilisateur. Pour plus d’informations sur les ressources XAML et sur l’utilisation de l’attribut x :Key, consultez les références de ressources ResourceDictionary et XAML.

L’avantage de déclarer des pinceaux en tant que ressources est qu’il réduit le nombre d’objets runtime nécessaires à la construction d’une interface utilisateur : le pinceau est désormais partagé en tant que ressource commune qui fournit des valeurs pour plusieurs parties du graphique objet.

Si vous examinez les définitions de modèle de contrôle existantes pour Windows Runtime contrôles XAML, vous verrez que les modèles utilisent largement des ressources de pinceau (bien que ces derniers soient généralement SolidColorBrush, et non LinearGradientBrush). La plupart de ces ressources sont des ressources système et utilisent l’extension de balisage {ThemeResource} pour la référence de ressource plutôt que l’extension de balisage {StaticResource}. Pour plus d’informations sur l’utilisation des pinceaux de ressources système dans votre propre modèle de contrôle XAML, consultez les ressources de thème XAML.

Voir aussi

• GradientBrush
• SolidColorBrush
• RadialGradientBrush
• Pinceaux XAML
• Références aux ressources ResourceDictionary et XAML