Brush Classe

Definizione

Spazio dei nomi:

System.Windows.Media

Assembly:

PresentationCore.dll

Definisce gli oggetti utilizzati per disegnare oggetti grafici. Le classi che derivano da Brush descrivono il modo in cui viene dipinta l'area.

public ref class Brush abstract : System::Windows::Media::Animation::Animatable, IFormattable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.BrushConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public abstract class Brush : System.Windows.Media.Animation.Animatable, IFormattable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Media.BrushConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type Brush = class
    inherit Animatable
    interface IFormattable

Public MustInherit Class Brush
Inherits Animatable
Implements IFormattable

Ereditarietà

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Brush

Derivato

System.Windows.Media.BitmapCacheBrush

System.Windows.Media.GradientBrush

System.Windows.Media.SolidColorBrush

System.Windows.Media.TileBrush

Attributi

TypeConverterAttribute LocalizabilityAttribute

Implementazioni

IFormattable

Commenti

" Brush disegna" o "riempie" un'area con il relativo output. I pennelli diversi hanno tipi diversi di output. Alcuni pennelli disegnano un'area con un colore a tinta unita, altre con sfumatura, motivo, immagine o disegno. L'elenco seguente descrive i diversi tipi di pennelli WPF:

• SolidColorBrush: disegna un'area con un oggetto solido Color.

• LinearGradientBrush: disegna un'area con una sfumatura lineare.

• RadialGradientBrush: disegna un'area con una sfumatura radiale.

• ImageBrush: disegna un'area con un'immagine (rappresentata da un ImageSource oggetto ).

• DrawingBrush: disegna un'area con un oggetto Drawing. Il disegno può includere oggetti vettoriali e bitmap.

• VisualBrush: disegna un'area con un Visual oggetto . Un VisualBrush consente di duplicare il contenuto da una parte dell'applicazione in un'altra area. È molto utile per creare effetti di reflection e ingrandire parti dello schermo.

Pennelli predefiniti

Utilizzare la Brushes classe per disegnare un oggetto utilizzando un colore a tinta unita predefinito, ad esempio AliceBlue o Red.

Pennelli in XAML

La tabella seguente elenca i diversi Brush tipi che possono essere usati in XAML e la sintassi supportata. Per informazioni dettagliate sulla sintassi per un pennello specifico, vedere la pagina del tipo di pennello.

Classe	Sintassi degli attributi	Sintassi dell'elemento Object
SolidColorBrush	Sì	Sì
DrawingBrush	No	Sì
ImageBrush	No	Sì
LinearGradientBrush	No	Sì
RadialGradientBrush	No	Sì
VisualBrush	No	Sì

Per un esempio che illustra come disegnare rapidamente un'area con un colore a tinta unita, vedere Procedura: Disegnare un'area con un colore a tinta unita.

Funzionalità freezable

Un pennello è un tipo di Freezable oggetto. Per informazioni sulle Freezable funzionalità, ad esempio il blocco e la clonazione, vedere Cenni preliminari sugli oggetti Freezable.

Utilizzo del testo XAML

Per informazioni XAML, vedere la sezione Osservazioni .

Note per gli implementatori

Quando si eredita dalla Brush classe , è necessario eseguire l'override del CreateInstanceCore() metodo . A seconda che la classe debba eseguire operazioni di inizializzazione aggiuntive o che contenga membri dati delle proprietà non di dipendenza, potrebbe essere necessario eseguire l'override di metodi aggiuntivi Freezable . Per altre informazioni sull'ereditarietà dai Freezable tipi, vedere Cenni preliminari sugli oggetti Freezable.

Costruttori

Nome	Descrizione
Brush()	Inizializza una nuova istanza della classe Brush.

Campi

Nome	Descrizione
OpacityProperty	Identifica la Opacity proprietà di dipendenza.
RelativeTransformProperty	Identifica la RelativeTransform proprietà di dipendenza.
TransformProperty	Identifica la Transform proprietà di dipendenza.

Proprietà

Nome	Descrizione
CanFreeze	Ottiene un valore che indica se l'oggetto può essere reso non modificabile. (Ereditato da Freezable)
DependencyObjectType	Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject)
Dispatcher	Ottiene l'oggetto DispatcherDispatcherObject a cui è associato. (Ereditato da DispatcherObject)
HasAnimatedProperties	Ottiene un valore che indica se uno o più AnimationClock oggetti sono associati a una 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 questa istanza è attualmente sealed (sola lettura). (Ereditato da DependencyObject)
Opacity	Ottiene o imposta il grado di opacità di un oggetto Brush.
RelativeTransform	Ottiene o imposta la trasformazione applicata al pennello utilizzando coordinate relative.
Transform	Ottiene o imposta la trasformazione applicata al pennello. Questa trasformazione viene applicata dopo che l'output del pennello è stato mappato e posizionato.

Metodi

Nome	Descrizione
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Applica un oggetto AnimationClock all'oggetto specificato DependencyProperty. Se la proprietà è già animata, viene utilizzato l'oggetto specificato HandoffBehavior . (Ereditato da Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Applica un oggetto AnimationClock all'oggetto specificato DependencyProperty. Se la proprietà è già animata, viene utilizzato il SnapshotAndReplace comportamento di handoff. (Ereditato da Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Applica un'animazione all'oggetto specificato DependencyProperty. L'animazione viene avviata quando viene eseguito il rendering del fotogramma successivo. Se la proprietà specificata è già animata, viene utilizzato l'oggetto specificato HandoffBehavior . (Ereditato da Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Applica un'animazione all'oggetto specificato DependencyProperty. L'animazione viene avviata quando viene eseguito il rendering del fotogramma successivo. Se la proprietà specificata è già animata, viene utilizzato il SnapshotAndReplace comportamento di handoff. (Ereditato da Animatable)
CheckAccess()	Determina se il thread chiamante ha accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject)
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un DependencyProperty identificatore. (Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)	Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare viene specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject)
Clone()	Crea un clone modificabile di questo Brushoggetto , eseguendo copie complete dei valori di questo oggetto. Quando si copiano le proprietà di dipendenza, questo metodo copia i riferimenti alle risorse e i data binding (ma potrebbero non essere più risolti), ma non le animazioni o i relativi valori correnti.
CloneCore(Freezable)	Rende l'istanza un clone (copia completa) dell'oggetto specificato Freezable usando valori di proprietà di base (non animati). (Ereditato da Freezable)
CloneCurrentValue()	Crea un clone modificabile di questo Brush oggetto, eseguendo copie complete dei valori correnti dell'oggetto. I riferimenti alle risorse, i data binding e le animazioni non vengono copiati, ma i relativi valori correnti sono.
CloneCurrentValueCore(Freezable)	Rende l'istanza un clone modificabile (copia completa) dell'oggetto specificato Freezable utilizzando i valori delle proprietà correnti. (Ereditato da Freezable)
CoerceValue(DependencyProperty)	Forza il valore della proprietà di dipendenza specificata. A tale scopo, richiamare qualsiasi CoerceValueCallback funzione specificata nei metadati della proprietà per la proprietà di dipendenza così come esiste nella chiamata DependencyObjectdi . (Ereditato da DependencyObject)
CreateInstance()	Inizializza una nuova istanza della classe Freezable. (Ereditato da Freezable)
CreateInstanceCore()	Se implementato in una classe derivata, crea una nuova istanza della Freezable classe derivata. (Ereditato da Freezable)
Equals(Object)	Determina se un oggetto specificato DependencyObject è equivalente all'oggetto corrente DependencyObject. (Ereditato da DependencyObject)
Freeze()	Rende l'oggetto corrente non modificabile e imposta la relativa IsFrozen proprietà su true. (Ereditato da Freezable)
FreezeCore(Boolean)	Animatable Rende questo oggetto non modificabile o determina se può essere reso non modificabile. (Ereditato da Animatable)
GetAnimationBaseValue(DependencyProperty)	Restituisce il valore non animato dell'oggetto specificato DependencyProperty. (Ereditato da Animatable)
GetAsFrozen()	Crea una copia bloccata della proprietà , utilizzando i valori della Freezableproprietà base (non animati). Poiché la copia è bloccata, tutti gli oggetti secondari bloccati vengono copiati in base al riferimento. (Ereditato da Freezable)
GetAsFrozenCore(Freezable)	Rende l'istanza un clone bloccato dell'oggetto specificato Freezable utilizzando valori di proprietà di base (non animati). (Ereditato da Freezable)
GetCurrentValueAsFrozen()	Crea una copia bloccata dell'oggetto utilizzando i valori correnti delle Freezable proprietà. Poiché la copia è bloccata, tutti gli oggetti secondari bloccati vengono copiati in base al riferimento. (Ereditato da Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Rende l'istanza corrente un clone bloccato dell'oggetto specificato Freezable. 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 quali proprietà di dipendenza hanno valori impostati localmente in questo DependencyObjectoggetto . (Ereditato da DependencyObject)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di un oggetto DependencyObject. (Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)	Rivaluta il valore effettivo per la proprietà di dipendenza specificata. (Ereditato da DependencyObject)
OnChanged()	Chiamato quando l'oggetto corrente Freezable viene modificato. (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)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Assicura che vengano stabiliti puntatori di contesto appropriati per un DependencyObjectType membro dati appena impostato. (Ereditato da Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Esegue l'override dell'implementazione DependencyObject di OnPropertyChanged(DependencyPropertyChangedEventArgs) per richiamare anche i Changed gestori in risposta a una proprietà di dipendenza modificata 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'oggetto Freezable sia accessibile da un thread valido. Gli eredi di Freezable devono chiamare questo metodo all'inizio di qualsiasi API che legge i membri dati che non sono proprietà di dipendenza. (Ereditato da Freezable)
SetCurrentValue(DependencyProperty, Object)	Imposta il valore di una proprietà di dipendenza senza modificarne l'origine del valore. (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza, specificato dall'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 per la proprietà di dipendenza specificata. (Ereditato da DependencyObject)
ToString()	Restituisce la rappresentazione di stringa di questo Brushoggetto .
ToString(IFormatProvider)	Crea una rappresentazione di stringa di questo oggetto in base alle informazioni di formattazione specifiche delle impostazioni cultura specificate.
VerifyAccess()	Impone che il thread chiamante abbia accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject)
WritePostscript()	Genera l'evento Changed per Freezable e richiama il relativo OnChanged() metodo. Le classi che derivano da Freezable devono chiamare questo metodo alla fine di qualsiasi API che modifica i membri della classe non archiviati come proprietà di dipendenza. (Ereditato da Freezable)
WritePreamble()	Verifica che l'oggetto Freezable non sia bloccato e che sia accessibile da un contesto di threading valido. Freezable Gli eredi devono chiamare questo metodo all'inizio di qualsiasi API che scrive nei membri dati che non sono proprietà di dipendenza. (Ereditato da Freezable)

Eventi

Nome	Descrizione
Changed	Si verifica quando l'oggetto Freezable o un oggetto che contiene viene modificato. (Ereditato da Freezable)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IFormattable.ToString(String, IFormatProvider)	Formatta il valore dell'istanza corrente utilizzando il formato specificato.

Vedi anche

• Brushes
• Esempio di pennelli