LinearGradientBrush Klasse

Referenz

Definition

Namespace:: Microsoft.UI.Xaml.Media

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Zeichnet einen Bereich mit einem linearen Farbverlauf.

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

Vererbung: Object Platform::Object IInspectable DependencyObject Brush GradientBrush LinearGradientBrush

Attribute: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

Dieses Beispiel erstellt einen linearen Farbverlauf mit vier Farben, der zum Zeichnen eines Rectangle verwendet wird.

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

Farbverlaufachse für einen vertikalen Farbverlauf

Hinweise

LinearGradientBrush ist ein Pinseltyp , der für viele mögliche UI-Eigenschaften verwendet wird, die einen Brush verwenden, um den visuellen Bereich eines Objekts in der App-Benutzeroberfläche teilweise oder vollständig auszufüllen. Beispiele für einige der am häufigsten verwendeten Eigenschaften, die einen Pinselwert verwenden, sind: Control.Background, Control.Foreground, Shape.Fill, Control.BorderBrush, Panel.Background, TextBlock.Foreground. LinearGradientBrush ist eine Alternative zum häufiger verwendeten SolidColorBrush-Typ .

Die Eigenschaften StartPoint und EndPoint von LinearGradientBrush beschreiben zwei Punkte in einem relativen Koordinatenbereich. Dadurch wird eine Ausrichtung für den Farbverlauf erstellt, wobei in der Regel ein horizontaler Farbverlauf oder ein vertikaler Farbverlauf angegeben wird. Es kann auch ein diagonaler Farbverlauf verwendet werden. Ein LinearGradientBrush verfügt in der Regel über zwei oder mehr GradientStop-Werte für die GradientStops-Eigenschaft (eine geordnete Auflistung). Jeder GradientStop-Wert gibt eine Farbe und einen Offset an. Offset stellt eine Position zwischen 0 ( StartPoint) und 1 ( EndPoint) entlang des Farbverlaufs dar, und die tatsächliche Pixellänge des Pinsels und dessen Farbverlauf werden basierend auf der Benutzeroberfläche angepasst, auf der Sie Ihren LinearGradientBrush als Wert anwenden. Weitere Informationen dazu, wie Offsetwerte definiert werden und wie Offset, StartPoint und EndPoint zusammenhängen, finden Sie unter XAML-Pinsel. Es ist üblich,

Sie können den Transparent-Wert für eine der GradientStop-Farben verwenden. Obwohl dadurch keine Änderungen an der Benutzeroberfläche vorgenommen werden (sie ist transparent), kann dieser Punkt für Treffertests erkannt werden. Weitere Informationen zum Treffertest finden Sie im Abschnitt "Treffertests" unter Mausinteraktionen.

Die GradientStop-Werte eines LinearGradientBrush können als Teil von Übergängen oder dekorativen Animationen animiert werden. Verwenden Sie einen der dedizierten Animationstypen, die einen Color-Wert animieren können. Dazu gehört .(GradientStop.Color) in der Regel ein längerer Eigenschaftenpfad für einen Storyboard.TargetProperty-Wert . Weitere Informationen zur Eigenschaftenadressierung und zum Animieren von Eigenschaften, die Pinselwerte verwenden, finden Sie unter Storyboardanimationen.

Pinsel als XAML-Ressourcen

Jeder der Pinseltypen , die in XAML deklariert werden können (SolidColorBrush, LinearGradientBrush, ImageBrush), soll als Ressource definiert werden, sodass Sie diesen Pinsel als Ressource in Der gesamten App 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, um auf diese Ressource aus anderen Ui-Definitionen zu verweisen. Weitere Informationen zu XAML-Ressourcen und zur Verwendung des x:Key-Attributs finden Sie unter ResourceDictionary- und XAML-Ressourcenverweise.

Der Vorteil des Deklarierens 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 Objektgraphen bereitstellt.

Wenn Sie sich die vorhandenen Steuerelementvorlagendefinitionen für Windows-Runtime XAML-Steuerelemente ansehen, werden Sie sehen, dass die Vorlagen Pinselressourcen in großem Umfang verwenden (obwohl es sich in der Regel um SolidColorBrush und nicht um LinearGradientBrush handelt). Viele dieser Ressourcen sind Systemressourcen, und sie verwenden die {ThemeResource}-Markuperweiterung für den Ressourcenverweis und nicht die {StaticResource}-Markuperweiterung. Weitere Informationen zur Verwendung von Systemressourcenpinsel in Ihrer eigenen XAML-Steuerelementvorlage finden Sie unter XAML-Designressourcen.

Konstruktoren

LinearGradientBrush()	Initialisiert eine neue instance der LinearGradientBrush-Klasse.
LinearGradientBrush(GradientStopCollection, Double)	Initialisiert eine neue instance der LinearGradientBrush-Klasse, die über die angegebene GradientStopCollection und den angegebenen Winkel verfügt.

Eigenschaften

ColorInterpolationMode	Ruft einen ColorInterpolationMode-Enumerationswert ab, der angibt, wie die Farben des Farbverlaufs interpoliert werden, oder legt diesen fest. (Geerbt von GradientBrush)
Dispatcher	Gibt immer in einer Windows App SDK-App zurück`null`. Verwenden Sie stattdessen DispatcherQueue . (Geerbt von DependencyObject)
DispatcherQueue	Ruft den `DispatcherQueue` ab, dem dieses Objekt zugeordnet ist. Stellt `DispatcherQueue` eine Funktion dar, die auf den `DependencyObject` im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)
EndPoint	Ruft die zweidimensionalen Endkoordinaten des linearen Farbverlaufs ab oder legt diese fest.
EndPointProperty	Identifiziert die EndPoint-Abhängigkeitseigenschaft .
GradientStops	Ruft die Farbverlaufsstopps des Pinsels ab oder legt diese fest. (Geerbt von GradientBrush)
MappingMode	Ruft einen BrushMappingMode-Enumerationswert ab, der angibt, ob die Positionierungskoordinaten des Farbverlaufspinsels absolut oder relativ zum Ausgabebereich sind, oder legt diesen fest. (Geerbt von GradientBrush)
Opacity	Ruft den Deckkraftgrad eines Pinsels ab oder legt diese fest. (Geerbt von Brush)
RelativeTransform	Ruft die auf den Pinsel über relative Koordinaten angewendete Transformation ab oder legt diese fest. (Geerbt von Brush)
SpreadMethod	Ruft die Art der Spread-Methode beim Zeichnen eines Verlaufs, der innerhalb der Grenzen des zu zeichnenden Objekts beginnt oder endet, ab oder legt diese fest. (Geerbt von GradientBrush)
StartPoint	Ruft die zweidimensionalen Anfangskoordinaten des linearen Farbverlaufs ab oder legt diese fest.
StartPointProperty	Gibt die StartPoint-Abhängigkeitseigenschaft an.
Transform	Dient zum Abrufen oder Festlegen der auf den Pinsel angewendeten Transformation. (Geerbt von Brush)

Methoden

ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, der in Fällen gilt, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Definiert eine Eigenschaft, die animiert werden kann. (Geerbt von Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	Definiert beim Überschreiben in einer abgeleiteten Klasse eine Eigenschaft, die animiert werden kann. (Geerbt von Brush)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist. (Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Bricht eine Änderungsbenachrichtigung ab, die zuvor durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject)

Gilt für:

Freigeben über