RadialGradientBrush Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Disegna un'area con una sfumatura radiale. Un punto focale definisce l'inizio della sfumatura e un cerchio definisce il punto finale della sfumatura.
public ref class RadialGradientBrush sealed : System::Windows::Media::GradientBrush
public sealed class RadialGradientBrush : System.Windows.Media.GradientBrush
type RadialGradientBrush = class
inherit GradientBrush
Public NotInheritable Class RadialGradientBrush
Inherits GradientBrush
- Ereditarietà
-
RadialGradientBrush
Commenti
L'oggetto RadialGradientBrush è simile al modello di programmazione all'oggetto LinearGradientBrush. Tuttavia, la sfumatura lineare ha un punto iniziale e un punto finale per definire il vettore sfumatura, mentre la sfumatura radiale ha un cerchio, insieme a un punto focale, per definire il comportamento della sfumatura. Il cerchio definisce il punto finale della sfumatura. In altre parole, una sfumatura si ferma a 1,0 definisce il colore nella circoferenza del cerchio. Il punto focale definisce il centro della sfumatura. Una sfumatura si ferma a 0,0 definisce il colore nel punto focale.
L'immagine seguente mostra un rettangolo riempito con una sfumatura radiale. Sfumatura radiale che passa da bianco a grigio. Il cerchio esterno rappresenta il cerchio sfumatura mentre il punto rosso indica il punto focale. Questa sfumatura è SpreadMethod impostata su Pad.
Sfumatura radiale con un punto focale evidenziato
Nota
RadialGradientBrush gli oggetti vengono sottoposti a rendering usando l'accelerazione hardware su Tier 2 sistemi. Per altre informazioni sui livelli hardware, vedere Livelli di rendering della grafica.
Funzionalità di Freezable
Poiché eredita dalla Freezable classe, la RadialGradientBrush classe fornisce diverse funzionalità speciali: RadialGradientBrush gli oggetti possono essere dichiarati come risorse, condivisi tra più oggetti, resi di sola lettura per migliorare le prestazioni, clonati e resi thread sicuri. Per altre informazioni sulle diverse funzionalità fornite dagli Freezable oggetti, vedere Panoramica degli oggetti freezable.
Costruttori
RadialGradientBrush() |
Inizializza una nuova istanza della classe RadialGradientBrush. |
RadialGradientBrush(Color, Color) |
Inizializza una nuova istanza della classe RadialGradientBrush con i colori di inizio e fine specificati. |
RadialGradientBrush(GradientStopCollection) |
Inizializza una nuova istanza della classe RadialGradientBrush con i cursori sfumatura specificati. |
Campi
CenterProperty |
Identifica la proprietà di dipendenza Center. |
GradientOriginProperty |
Identifica la proprietà di dipendenza GradientOrigin. |
RadiusXProperty |
Identifica la proprietà di dipendenza RadiusX. |
RadiusYProperty |
Identifica la proprietà di dipendenza RadiusY. |
Proprietà
CanFreeze |
Ottiene un valore che indica se l'oggetto può essere impostato come non modificabile. (Ereditato da Freezable) |
Center |
Recupera o imposta il centro del cerchio più esterno della sfumatura radiale. |
ColorInterpolationMode |
Ottiene o imposta un'enumerazione ColorInterpolationMode che specifica la modalità di interpolazione dei colori in una sfumatura. (Ereditato da GradientBrush) |
DependencyObjectType |
Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject) |
Dispatcher |
Ottiene l'oggetto Dispatcher associato a DispatcherObject. (Ereditato da DispatcherObject) |
GradientOrigin |
Recupera o imposta la posizione del punto focale bidimensionale che definisce l'inizio della sfumatura. |
GradientStops |
Ottiene o imposta i cursori sfumatura del pennello. (Ereditato da GradientBrush) |
HasAnimatedProperties |
Ottiene un valore che indica se uno o più oggetti AnimationClock sono associati a una qualsiasi delle proprietà di dipendenza di questo oggetto. (Ereditato da Animatable) |
IsFrozen |
Ottiene un valore che indica se l'oggetto è attualmente modificabile. (Ereditato da Freezable) |
IsSealed |
Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura). (Ereditato da DependencyObject) |
MappingMode |
Recupera o imposta un'enumerazione BrushMappingMode che specifica se le coordinate di posizionamento del pennello sfumatura sono assolute o relative rispetto all'area di output. (Ereditato da GradientBrush) |
Opacity |
Ottiene o imposta il livello di opacità di Brush. (Ereditato da Brush) |
RadiusX |
Recupera o imposta il raggio orizzontale del cerchio più esterno della sfumatura radiale. |
RadiusY |
Ottiene o imposta il raggio verticale del cerchio più esterno di una sfumatura radiale. |
RelativeTransform |
Ottiene o imposta la trasformazione applicata al pennello usando coordinate relative. (Ereditato da Brush) |
SpreadMethod |
Recupera o imposta il tipo di metodo spread che specifica come tracciare una sfumatura che inizia o finisce entro i limiti dell'oggetto da disegnare. (Ereditato da GradientBrush) |
Transform |
Ottiene o imposta la trasformazione applicata al pennello. Questa trasformazione viene applicata dopo aver eseguito il mapping e il posizionamento dell'output del pennello. (Ereditato da Brush) |
Metodi
ApplyAnimationClock(DependencyProperty, AnimationClock) |
Applica un oggetto AnimationClock all'oggetto DependencyProperty specificato. Se la proprietà è già animata, viene usato il comportamento di continuità di SnapshotAndReplace. (Ereditato da Animatable) |
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Applica un oggetto AnimationClock all'oggetto DependencyProperty specificato. Se alla proprietà è già stata aggiunta un'animazione, viene utilizzato l'oggetto HandoffBehavior specificato. (Ereditato da Animatable) |
BeginAnimation(DependencyProperty, AnimationTimeline) |
Applica un'animazione all'oggetto DependencyProperty specificato. L'animazione viene avviata quando viene eseguito il rendering del fotogramma successivo. Se alla proprietà specificata è già applicata un'animazione, viene usato il comportamento di continuità di SnapshotAndReplace. (Ereditato da Animatable) |
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Applica un'animazione all'oggetto DependencyProperty specificato. L'animazione viene avviata quando viene eseguito il rendering del fotogramma successivo. Se alla proprietà specificata è già stata aggiunta un'animazione, viene utilizzato l'oggetto HandoffBehavior specificato. (Ereditato da Animatable) |
CheckAccess() |
Determina se il thread chiamante ha accesso a DispatcherObject. (Ereditato da DispatcherObject) |
ClearValue(DependencyProperty) |
Cancella il valore locale di una proprietà. La proprietà da cancellare è specificata da un identificatore DependencyProperty. (Ereditato da DependencyObject) |
ClearValue(DependencyPropertyKey) |
Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject) |
Clone() |
Crea un clone modificabile di questo oggetto RadialGradientBrush, eseguendo copie complete dei valori dell'oggetto. Durante la copia delle proprietà di dipendenza, questo metodo copia i riferimenti alle risorse e i data binding (che potrebbero non essere più risolti), ma non le animazioni né i relativi valori correnti. |
CloneCore(Freezable) |
Rende l'istanza un clone (copia completa) dell'oggetto Freezable specificato usando i valori di proprietà di base (non animati). (Ereditato da Freezable) |
CloneCurrentValue() |
Crea un clone modificabile dell'oggetto RadialGradientBrush, eseguendo copie complete dei valori correnti di tale oggetto. I riferimenti alle risorse, i data binding e le animazioni non vengono copiati, ma vengono copiati i relativi valori correnti. |
CloneCurrentValueCore(Freezable) |
Rende l'istanza un clone (copia completa) modificabile dell'oggetto Freezable specificato usando i valori di proprietà correnti. (Ereditato da Freezable) |
CoerceValue(DependencyProperty) |
Assegna forzatamente il valore della proprietà di dipendenza specificata. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante. (Ereditato da DependencyObject) |
CreateInstance() |
Inizializza una nuova istanza della classe Freezable. (Ereditato da Freezable) |
CreateInstanceCore() |
Quando è implementato in una classe derivata, crea una nuova istanza della classe derivata Freezable. (Ereditato da Freezable) |
Equals(Object) |
Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente. (Ereditato da DependencyObject) |
Freeze() |
Rende non modificabile l'oggetto corrente e ne imposta la proprietà IsFrozen su |
FreezeCore(Boolean) |
Rende immodificabile questo oggetto Animatable o determina se l'oggetto può essere reso immodificabile. (Ereditato da Animatable) |
GetAnimationBaseValue(DependencyProperty) |
Restituisce il valore non animato dell'oggetto DependencyProperty specificato. (Ereditato da Animatable) |
GetAsFrozen() |
Crea una copia bloccata di Freezable, utilizzando valori delle proprietà di base (non-animati). Dato che la copia è bloccata, gli oggetti secondari bloccati sono copiati dal riferimento. (Ereditato da Freezable) |
GetAsFrozenCore(Freezable) |
Rende l'istanza un clone bloccato dell'oggetto Freezable specificato usando i valori di proprietà di base (non animati). (Ereditato da Freezable) |
GetCurrentValueAsFrozen() |
Crea una copia bloccata di Freezable utilizzando valori della proprietà correnti. Dato che la copia è bloccata, gli oggetti secondari bloccati sono copiati dal riferimento. (Ereditato da Freezable) |
GetCurrentValueAsFrozenCore(Freezable) |
Rende l'istanza corrente un clone bloccato dell'oggetto Freezable specificato. Se l'oggetto ha proprietà di dipendenza animate, i valori animati correnti vengono copiati. (Ereditato da Freezable) |
GetHashCode() |
Ottiene un codice hash per l'oggetto DependencyObject. (Ereditato da DependencyObject) |
GetLocalValueEnumerator() |
Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject. (Ereditato da DependencyObject) |
GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
GetValue(DependencyProperty) |
Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject. (Ereditato da DependencyObject) |
InvalidateProperty(DependencyProperty) |
Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata. (Ereditato da DependencyObject) |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
OnChanged() |
Chiamato quando viene modificato l'oggetto Freezable corrente. (Ereditato da Freezable) |
OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Assicura che adatti puntatori del contesto siano stabiliti per un membro dati DependencyObjectType che è appena stato impostato. (Ereditato da Freezable) |
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Questo membro supporta l'infrastruttura Windows Presentation Foundation (WPF) e non deve essere usata direttamente dal codice. (Ereditato da Freezable) |
OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Esegue l'override dell'implementazione di DependencyObject di OnPropertyChanged(DependencyPropertyChangedEventArgs) per richiamare anche eventuali gestori Changed in risposta alla modifica di una proprietà di dipendenza di tipo Freezable. (Ereditato da Freezable) |
ReadLocalValue(DependencyProperty) |
Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject) |
ReadPreamble() |
Assicura che l’accesso di Freezable sia stato eseguito da un thread valido. Gli eredi di Freezable devono chiamare questo metodo all'inizio di qualsiasi API che legge i membri dei dati che non sono proprietà della dipendenza. (Ereditato da Freezable) |
SetCurrentValue(DependencyProperty, Object) |
Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore. (Ereditato da DependencyObject) |
SetValue(DependencyProperty, Object) |
Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo identificatore della proprietà di dipendenza. (Ereditato da DependencyObject) |
SetValue(DependencyPropertyKey, Object) |
Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza. (Ereditato da DependencyObject) |
ShouldSerializeProperty(DependencyProperty) |
Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza specificata. (Ereditato da DependencyObject) |
ToString() |
Rappresentazione in forma di stringa restituita di Brush. (Ereditato da Brush) |
ToString(IFormatProvider) |
Crea una rappresentazione di stringa dell'oggetto in base alle informazioni di formattazione specifiche delle impostazioni cultura specificate. (Ereditato da Brush) |
VerifyAccess() |
Impone che il thread chiamante abbia accesso a DispatcherObject. (Ereditato da DispatcherObject) |
WritePostscript() |
Genera l'evento Changed per Freezable e richiama il metodo OnChanged(). Le classi che derivano da Freezable devono chiamare questo metodo alla fine di qualsiasi API che modifica i membri di classe che non sono archiviati come proprietà di dipendenza. (Ereditato da Freezable) |
WritePreamble() |
Verifica che l'oggetto Freezable non sia bloccato e che l'accesso sia eseguito da un contesto di threading valido. Gli eredi di Freezable devono chiamare questo metodo all'inizio di qualsiasi API che scrive sui membri dei dati che non sono proprietà della dipendenza. (Ereditato da Freezable) |
Eventi
Changed |
Si verifica quando Freezable o un oggetto che contiene è modificato. (Ereditato da Freezable) |
Implementazioni dell'interfaccia esplicita
IFormattable.ToString(String, IFormatProvider) |
Formatta il valore dell'istanza corrente usando il formato specificato. (Ereditato da Brush) |