RadialGradientBrush Klasse
Definition
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.
Zeichnet einen Bereich mit einem radialen Farbverlauf. Ein Fokus definiert den Anfang des Farbverlaufs, und ein Kreis definiert den Endpunkt des Farbverlaufs.
public ref class RadialGradientBrush sealed : System::Windows::Media::GradientBrushpublic sealed class RadialGradientBrush : System.Windows.Media.GradientBrushtype RadialGradientBrush = class
inherit GradientBrushPublic NotInheritable Class RadialGradientBrush
Inherits GradientBrush- Vererbung
-
RadialGradientBrush
Hinweise
Dies RadialGradientBrush ähnelt dem Programmiermodell der LinearGradientBrush. Der lineare Farbverlauf weist jedoch einen Start- und einen Endpunkt auf, um den Farbverlaufsvektor zu definieren, während der Radialverlauf einen Kreis und einen Fokus hat, um das Farbverlaufsverhalten zu definieren. Der Kreis definiert den Endpunkt des Farbverlaufs. Mit anderen Worten, ein Farbverlaufsstopp bei 1,0 definiert die Farbe am Kreisumfang. Der Fokus definiert die Mitte des Farbverlaufs. Ein Farbverlaufsstopp bei 0,0 definiert die Farbe am Mittelpunkt.
Die folgende Abbildung zeigt ein Rechteck, das mit einem radialen Farbverlauf gefüllt ist. Der radiale Farbverlauf, der von Weiß zu Grau verläuft. Der äußere Kreis stellt den Farbverlaufskreis dar, während der rote Punkt den Mittelpunkt angibt. Dieser Farbverlauf hat seinen SpreadMethod Satz auf Pad.
Radialer Farbverlauf mit hervorgehobenem Fokuspunkt
Hinweis
RadialGradientBrush Objekte werden mithilfe der Hardwarebeschleunigung auf Tier 2 Systemen gerendert. Weitere Informationen zu Hardwareebenen finden Sie unter Grafikrenderingebenen.
Freizierbare Features
Da sie von der Freezable Klasse erbt, bietet die RadialGradientBrush Klasse mehrere spezielle Features: RadialGradientBrush Objekte können als Ressourcen deklariert werden, die von mehreren Objekten gemeinsam genutzt werden, schreibgeschützt gemacht werden, um die Leistung, geklont und threadsicher zu machen. Weitere Informationen zu den verschiedenen Features, die von Freezable Objekten bereitgestellt werden, finden Sie unter "Freezable Objects Overview".
Konstruktoren
| Name | Beschreibung |
|---|---|
| RadialGradientBrush() |
Initialisiert eine neue Instanz der RadialGradientBrush-Klasse. |
| RadialGradientBrush(Color, Color) |
Initialisiert eine neue Instanz der RadialGradientBrush Klasse mit den angegebenen Start- und Stoppfarben. |
| RadialGradientBrush(GradientStopCollection) |
Initialisiert eine neue Instanz der RadialGradientBrush Klasse mit den angegebenen Farbverlaufsstopps. |
Felder
| Name | Beschreibung |
|---|---|
| CenterProperty |
Identifies the Center dependency property. |
| GradientOriginProperty |
Identifies the GradientOrigin dependency property. |
| RadiusXProperty |
Identifies the RadiusX dependency property. |
| RadiusYProperty |
Identifies the RadiusY dependency property. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| CanFreeze |
Ruft einen Wert ab, der angibt, ob das Objekt unveränderlich gemacht werden kann. (Geerbt von Freezable) |
| Center |
Dient zum Abrufen oder Festlegen der Mitte des äußersten Kreises des Radialverlaufs. |
| ColorInterpolationMode |
Dient zum Abrufen oder Festlegen einer ColorInterpolationMode Aufzählung, die angibt, wie die Farben des Farbverlaufs interpoliert werden. (Geerbt von GradientBrush) |
| DependencyObjectType |
Ruft den DependencyObjectType CLR-Typ dieser Instanz ab. (Geerbt von DependencyObject) |
| Dispatcher |
Ruft dies Dispatcher ab, dem dies DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject) |
| GradientOrigin |
Dient zum Abrufen oder Festlegen der Position des zweidimensionalen Fokuspunkts, der den Anfang des Farbverlaufs definiert. |
| GradientStops |
Ruft die Farbverlaufsstopps des Pinsels ab oder legt sie fest. (Geerbt von GradientBrush) |
| HasAnimatedProperties |
Ruft einen Wert ab, der angibt, ob ein oder AnimationClock mehrere Objekte einer der Abhängigkeitseigenschaften dieses Objekts zugeordnet sind. (Geerbt von Animatable) |
| IsFrozen |
Ruft einen Wert ab, der angibt, ob das Objekt derzeit geändert werden kann. (Geerbt von Freezable) |
| IsSealed |
Ruft einen Wert ab, der angibt, ob diese Instanz aktuell versiegelt ist (schreibgeschützt). (Geerbt von DependencyObject) |
| MappingMode |
Dient zum Abrufen oder Festlegen einer BrushMappingMode Enumeration, die angibt, ob die Positionierungskoordinaten des Farbverlaufspinsels absolut oder relativ zum Ausgabebereich sind. (Geerbt von GradientBrush) |
| Opacity |
Dient zum Abrufen oder Festlegen des Grads der Deckkraft eines .Brush (Geerbt von Brush) |
| RadiusX |
Dient zum Abrufen oder Festlegen des horizontalen Radius des äußersten Kreises des radialen Farbverlaufs. |
| RadiusY |
Dient zum Abrufen oder Festlegen des vertikalen Radius des äußersten Kreises eines radialen Farbverlaufs. |
| RelativeTransform |
Dient zum Abrufen oder Festlegen der Transformation, die mit relativen Koordinaten auf den Pinsel angewendet wird. (Geerbt von Brush) |
| SpreadMethod |
Dient zum Abrufen oder Festlegen des Typs der Spread-Methode, die angibt, wie ein Farbverlauf gezeichnet wird, der innerhalb der Grenzen des zu zeichnenden Objekts beginnt oder endet. (Geerbt von GradientBrush) |
| Transform |
Dient zum Abrufen oder Festlegen der Transformation, die auf den Pinsel angewendet wird. Diese Transformation wird angewendet, nachdem die Ausgabe des Pinsels zugeordnet und positioniert wurde. (Geerbt von Brush) |
Methoden
| Name | Beschreibung |
|---|---|
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Wendet eine AnimationClock auf die angegebene DependencyProperty. Wenn die Eigenschaft bereits animiert ist, wird die angegebene HandoffBehavior Eigenschaft verwendet. (Geerbt von Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Wendet eine AnimationClock auf die angegebene DependencyProperty. Wenn die Eigenschaft bereits animiert ist, wird das SnapshotAndReplace Übergabeverhalten verwendet. (Geerbt von Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Wendet eine Animation auf die angegebene DependencyPropertyAnimation an. Die Animation wird gestartet, wenn der nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert ist, wird die angegebene HandoffBehavior Eigenschaft verwendet. (Geerbt von Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Wendet eine Animation auf die angegebene DependencyPropertyAnimation an. Die Animation wird gestartet, wenn der nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert ist, wird das SnapshotAndReplace Übergabeverhalten verwendet. (Geerbt von Animatable) |
| CheckAccess() |
Bestimmt, ob der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject) |
| ClearValue(DependencyProperty) |
Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird durch einen DependencyProperty Bezeichner angegeben. (Geerbt von DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird durch eine DependencyPropertyKey. (Geerbt von DependencyObject) |
| Clone() |
Erstellt einen modifizierbaren Klon dieses RadialGradientBrushObjekts, wodurch tiefe Kopien der Werte dieses Objekts erstellt werden. Beim Kopieren von Abhängigkeitseigenschaften kopiert diese Methode Ressourcenverweise und Datenbindungen (aber möglicherweise nicht mehr auflösen), jedoch keine Animationen oder ihre aktuellen Werte. |
| CloneCore(Freezable) |
Macht die Instanz zu einem Klon (deep copy) der angegebenen Freezable Basiseigenschaftswerte (nicht animiert). (Geerbt von Freezable) |
| CloneCurrentValue() |
Erstellt einen modifizierbaren Klon dieses RadialGradientBrush Objekts, wodurch tiefe Kopien der aktuellen Werte dieses Objekts erstellt werden. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, aber ihre aktuellen Werte sind. |
| CloneCurrentValueCore(Freezable) |
Macht die Instanz zu einem modifizierbaren Klon (deep copy) des angegebenen Freezable Werts mit aktuellen Eigenschaftswerten. (Geerbt von Freezable) |
| CoerceValue(DependencyProperty) |
Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Dies wird erreicht, indem alle CoerceValueCallback in Eigenschaftsmetadaten für die Abhängigkeitseigenschaft angegebenen Funktionen aufgerufen werden, wie sie für den Aufruf DependencyObjectvorhanden sind. (Geerbt von DependencyObject) |
| CreateInstance() |
Initialisiert eine neue Instanz der Freezable-Klasse. (Geerbt von Freezable) |
| CreateInstanceCore() |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird eine neue Instanz der Freezable abgeleiteten Klasse erstellt. (Geerbt von Freezable) |
| Equals(Object) |
Bestimmt, ob ein bereitgestelltes DependencyObject Element dem aktuellen DependencyObjectentspricht. (Geerbt von DependencyObject) |
| Freeze() |
Macht das aktuelle Objekt unveränderlich und legt seine IsFrozen Eigenschaft auf |
| FreezeCore(Boolean) |
Macht dieses Animatable Objekt unveränderlich oder bestimmt, ob es unveränderlich gemacht werden kann. (Geerbt von Animatable) |
| GetAnimationBaseValue(DependencyProperty) |
Gibt den nicht animierten Wert des angegebenen DependencyPropertyWerts zurück. (Geerbt von Animatable) |
| GetAsFrozen() |
Erstellt eine fixierte Kopie der Freezablebasisbasierten (nicht animierten) Eigenschaftswerte. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte per Verweis kopiert. (Geerbt von Freezable) |
| GetAsFrozenCore(Freezable) |
Macht die Instanz zu einem fixierten Klon der angegebenen Freezable Basiseigenschaft (nicht animierte) Eigenschaftswerte. (Geerbt von Freezable) |
| GetCurrentValueAsFrozen() |
Erstellt eine fixierte Kopie der Freezable aktuellen Eigenschaftswerte. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte per Verweis kopiert. (Geerbt von Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Macht die aktuelle Instanz zu einem fixierten Klon des angegebenen Freezable. Wenn das Objekt animierte Abhängigkeitseigenschaften aufweist, werden die aktuellen animierten Werte kopiert. (Geerbt von Freezable) |
| GetHashCode() |
Ruft einen Hashcode für diese DependencyObjectab. (Geerbt von DependencyObject) |
| GetLocalValueEnumerator() |
Erstellt einen speziellen Enumerator, um zu bestimmen, welche Abhängigkeitseigenschaften lokal festgelegte Werte für diese DependencyObjectEigenschaft haben. (Geerbt von DependencyObject) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetValue(DependencyProperty) |
Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz einer .DependencyObject (Geerbt von DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| OnChanged() |
Wird aufgerufen, wenn das aktuelle Freezable Objekt geändert wird. (Geerbt von Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Dieses Mitglied unterstützt die Windows Presentation Foundation-Infrastruktur (WPF) und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Stellt sicher, dass geeignete Kontextzeiger für ein DependencyObjectType soeben festgelegtes Datenelement eingerichtet werden. (Geerbt von Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Setzt die DependencyObject Implementierung OnPropertyChanged(DependencyPropertyChangedEventArgs) außer Kraft, um auch alle Changed Handler als Reaktion auf eine sich ändernde Abhängigkeitseigenschaft vom Typ Freezableaufzurufen. (Geerbt von Freezable) |
| ReadLocalValue(DependencyProperty) |
Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, sofern vorhanden. (Geerbt von DependencyObject) |
| ReadPreamble() |
Stellt sicher, dass der Freezable Zugriff über einen gültigen Thread erfolgt. Erber von Freezable müssen diese Methode am Anfang einer API aufrufen, die Datenmmber liest, die keine Abhängigkeitseigenschaften sind. (Geerbt von Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Geerbt von DependencyObject) |
| SetValue(DependencyProperty, Object) |
Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird. (Geerbt von DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey Bezeichner der Abhängigkeitseigenschaft angegeben wird. (Geerbt von DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert für die bereitgestellte Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject) |
| ToString() |
Gibt die Zeichenfolgendarstellung dieses Werts Brushzurück. (Geerbt von Brush) |
| ToString(IFormatProvider) |
Erstellt eine Zeichenfolgendarstellung dieses Objekts basierend auf den angegebenen kulturspezifischen Formatierungsinformationen. (Geerbt von Brush) |
| VerifyAccess() |
Erzwingt, dass der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject) |
| WritePostscript() |
Löst das Changed Ereignis für die Freezable Methode aus und ruft es OnChanged() auf. Klassen, die von Freezable dieser Methode abgeleitet werden, sollten am Ende einer API aufgerufen werden, die Klassenmmber ändert, die nicht als Abhängigkeitseigenschaften gespeichert sind. (Geerbt von Freezable) |
| WritePreamble() |
Überprüft, ob der Freezable Zugriff nicht fixiert ist und über einen gültigen Threadingkontext darauf zugegriffen wird. Freezable Vererbungen sollten diese Methode am Anfang einer API aufrufen, die in Datenmmber schreibt, die keine Abhängigkeitseigenschaften sind. (Geerbt von Freezable) |
Ereignisse
| Name | Beschreibung |
|---|---|
| Changed |
Tritt auf, wenn das Freezable darin enthaltene Objekt geändert wird. (Geerbt von Freezable) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IFormattable.ToString(String, IFormatProvider) |
Formatiert den Wert der aktuellen Instanz mithilfe des angegebenen Formats. (Geerbt von Brush) |
