RadialGradientBrush Klasse

Definition

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="GradientStops")]
class RadialGradientBrush : XamlCompositionBrushBase

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="GradientStops")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class RadialGradientBrush : XamlCompositionBrushBase

[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="GradientStops")]
public class RadialGradientBrush : XamlCompositionBrushBase

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="GradientStops")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class RadialGradientBrush : XamlCompositionBrushBase

Public Class RadialGradientBrush
Inherits XamlCompositionBrushBase

Vererbung

Object IInspectable DependencyObject Brush XamlCompositionBrushBase RadialGradientBrush

Attribute

Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContentPropertyAttribute ContractVersionAttribute

Beispiele

Die WinUI 3 Gallery-App enthält interaktive Beispiele für die meisten WinUI 3-Steuerelemente, -Features und -Funktionen. Holen Sie sich die App aus dem Microsoft Store oder holen Sie sich den Quellcode auf GitHub.

Im folgenden Beispiel wird ein radialer Farbverlauf mit sechs Farbverlaufsstopps erstellt und zum Zeichnen eines Rechtecks verwendet.

<Page
  xmlns:media="using:Microsoft.UI.Xaml.Media">

  <Rectangle Width="200" Height="200">
      <Rectangle.Fill>
          <media:RadialGradientBrush>
              <GradientStop Color="Blue" Offset="0.0" />
              <GradientStop Color="Yellow" Offset="0.2" />
              <GradientStop Color="LimeGreen" Offset="0.4" />
              <GradientStop Color="LightBlue" Offset="0.6" />
              <GradientStop Color="Blue" Offset="0.8" />
              <GradientStop Color="LightGray" Offset="1" />
          </media:RadialGradientBrush>
      </Rectangle.Fill>
  </Rectangle>

</Page>

In diesem Beispiel wird ein radialer Farbverlauf erstellt, der den Absoluten Zuordnungsmodus mit benutzerdefinierten Werten für Center, RadiusXund RadiusYGradientOrigin:

<Page
  xmlns:media="using:Microsoft.UI.Xaml.Media">

  <Rectangle Width="200" Height="200">
      <Rectangle.Fill>
          <media:RadialGradientBrush
            MappingMode="Absolute"
            Center="50,50"
            RadiusX="100"
            RadiusY="100"
            GradientOrigin="100,50"
            >
              <GradientStop Color="Yellow" Offset="0.0" />
              <GradientStop Color="Blue" Offset="1" />
          </media:RadialGradientBrush>
      </Rectangle.Fill>
  </Rectangle>

</Page>

Hinweise

Farbverlaufslayout

Der Farbverlauf wird in einer Ellipse gezeichnet, die durch die Eigenschaften "Center", "RadiusX" und "RadiusY" definiert wird. Farben für den Farbverlauf beginnen im Zentrum der Ellipse und enden am Radius.

Die Farben für den radialen Farbverlauf werden durch Farbstopps definiert, die der GradientStops-Auflistungseigenschaft hinzugefügt werden. Jeder Farbverlaufsstopp gibt eine Farbe und einen Offset entlang des Farbverlaufs an.

Der Farbverlaufsursprung wird standardmäßig zentriert und kann mit der GradientOrigin-Eigenschaft versetzt werden.

MappingMode definiert, ob Center, RadiusX, RadiusY und GradientOrigin relative oder absolute Koordinaten darstellen.

Wenn MappingMode auf <a0/> festgelegt ist, werden die X- und Y-Werte der drei Eigenschaften relativ zu den Elementgrenzen behandelt, wobei die obere linke Ecke dargestellt wird und die untere rechte Ecke der Elementgrenzen für die Eigenschaften "Center", "RadiusX" und "RadiusY" darstellt und die Mitte für die GradientOrigin-Eigenschaft darstellt.

Wenn MappingMode auf Absolute festgelegt ist, werden die X- und Y-Werte der drei Eigenschaften als absolute Koordinaten innerhalb der Elementgrenzen behandelt.

Windows 10 Versionsunterstützung

Das Farbverlaufsrendering wird unter Windows 10 Version 1903 (v10.0.18362.0) und höher unterstützt. In früheren Betriebssystemversionen rendert der Pinsel eine durch die FallbackColor Eigenschaft angegebene Volltonfarbe.

Pinsel als XAML-Ressourcen

Jeder Pinseltyp , der in XAML deklariert werden kann (SolidColorBrush, LinearGradientBrush, ImageBrush) ist als Ressource definiert, sodass Sie diesen Pinsel in der gesamten App als Ressource wiederverwenden können. Die für Pinseltypen gezeigte XAML-Syntax eignet sich zum Definieren des Pinsels als Ressource. Wenn Sie einen Pinsel als Ressource deklarieren, benötigen Sie auch ein x:Key-Attribut , das Sie später verwenden werden, um aus anderen UI-Definitionen auf diese Ressource zu verweisen. Weitere Informationen zu XAML-Ressourcen und zur Verwendung des x:Key-Attributs finden Sie unter ResourceDictionary- und XAML-Ressourcenverweise.

Der Vorteil der Deklarierung von Pinsel als Ressourcen besteht darin, dass die Anzahl der Laufzeitobjekte reduziert wird, die zum Erstellen einer Benutzeroberfläche erforderlich sind: Der Pinsel wird jetzt als gemeinsame Ressource freigegeben, die Werte für mehrere Teile des Objektdiagramms bereitstellt.

Wenn Sie sich die vorhandenen Steuerelementvorlagendefinitionen für Windows-Runtime XAML-Steuerelemente ansehen, werden Sie feststellen, dass die Vorlagen Pinselressourcen umfassend verwenden (obwohl diese normalerweise SolidColorBrush und nicht LinearGradientBrush sind). Viele dieser Ressourcen sind Systemressourcen und verwenden die {ThemeResource}-Markuperweiterung für den Ressourcenverweis anstelle der {StaticResource}-Markuperweiterung. Weitere Informationen zur Verwendung von Systemressourcenpinseln in Ihrer eigenen Steuerelementvorlagen-XAML finden Sie unter XAML-Designressourcen.

Weitere Informationen

• Pinsel
• SolidColorBrush
• LinearGradientBrush
• GradientBrush
• Gradientstop
• XAML-Pinsel
• ResourceDictionary- und XAML-Ressourcenreferenzen