Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe Brush

 

Data di pubblicazione: agosto 2016

Definisce gli oggetti usati per disegnare oggetti grafici. Le classi che derivano da Brush descrivono la modalità di disegno dell'area.

Spazio dei nomi:   System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Freezable
        System.Windows.Media.Animation.Animatable
          System.Windows.Media.Brush
            System.Windows.Media.BitmapCacheBrush
            System.Windows.Media.GradientBrush
            System.Windows.Media.SolidColorBrush
            System.Windows.Media.TileBrush

[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
[TypeConverterAttribute(typeof(BrushConverter))]
public abstract class Brush : Animatable, IFormattable

NomeDescrizione
System_CAPS_protmethodBrush()

Inizializza una nuova istanza della classe Brush.

NomeDescrizione
System_CAPS_pubpropertyCanFreeze

Ottiene un valore che indica se l'oggetto può essere impostato come non modificabile.(Ereditato da Freezable.)

System_CAPS_pubpropertyDependencyObjectType

Ottiene il DependencyObjectType che esegue il wrapping di CLR tipo di questa istanza. (Ereditato da DependencyObject.)

System_CAPS_pubpropertyDispatcher

Ottiene il Dispatcher questo DispatcherObject è associato.(Ereditato da DispatcherObject.)

System_CAPS_pubpropertyHasAnimatedProperties

Ottiene un valore che indica se uno o più AnimationClock oggetti è associata a una delle proprietà di dipendenza di questo oggetto.(Ereditato da Animatable.)

System_CAPS_pubpropertyIsFrozen

Ottiene un valore che indica se l'oggetto è attualmente modificabile.(Ereditato da Freezable.)

System_CAPS_pubpropertyIsSealed

Ottiene un valore che indica se questa istanza è attualmente sealed (sola lettura).(Ereditato da DependencyObject.)

System_CAPS_pubpropertyOpacity

Ottiene o imposta il livello di opacità di Brush.

System_CAPS_pubpropertyRelativeTransform

Ottiene o imposta la trasformazione applicata al pennello usando coordinate relative.

System_CAPS_pubpropertyTransform

Ottiene o imposta la trasformazione applicata al pennello. Questa trasformazione viene applicata dopo aver eseguito il mapping e il posizionamento dell'output del pennello.

NomeDescrizione
System_CAPS_pubmethodApplyAnimationClock(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.)

System_CAPS_pubmethodApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Applica un oggetto AnimationClock all'oggetto DependencyProperty specificato. Se la proprietà è già animata, specificato HandoffBehavior viene utilizzato.(Ereditato da Animatable.)

System_CAPS_pubmethodBeginAnimation(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.)

System_CAPS_pubmethodBeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Applica un'animazione all'oggetto DependencyProperty specificato. L'animazione viene avviata quando viene eseguito il rendering del fotogramma successivo. Se la proprietà specificata è già animata, specificato HandoffBehavior viene utilizzato.(Ereditato da Animatable.)

System_CAPS_pubmethodCheckAccess()

Determina se il thread chiamante ha accesso a questo DispatcherObject.(Ereditato da DispatcherObject.)

System_CAPS_pubmethodClearValue(DependencyProperty)

Cancella il valore locale di una proprietà. La proprietà da cancellare è specificata da un identificatore DependencyProperty.(Ereditato da DependencyObject.)

System_CAPS_pubmethodClearValue(DependencyPropertyKey)

Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey.(Ereditato da DependencyObject.)

System_CAPS_pubmethodClone()

Crea un clone modificabile di questo oggetto Brush, 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.

System_CAPS_protmethodCloneCore(Freezable)

Rende l'istanza un clone (copia completa) dell'oggetto Freezable specificato usando i valori di proprietà di base (non animati).(Ereditato da Freezable.)

System_CAPS_pubmethodCloneCurrentValue()

Crea un clone modificabile dell'oggetto Brush, 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.

System_CAPS_protmethodCloneCurrentValueCore(Freezable)

Rende l'istanza un clone (copia completa) modificabile dell'oggetto Freezable specificato usando i valori di proprietà correnti.(Ereditato da Freezable.)

System_CAPS_pubmethodCoerceValue(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.)

System_CAPS_protmethodCreateInstance()

Inizializza una nuova istanza della classe Freezable.(Ereditato da Freezable.)

System_CAPS_protmethodCreateInstanceCore()

Quando implementato in una classe derivata, crea una nuova istanza di Freezable classe derivata.(Ereditato da Freezable.)

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto DependencyObject è equivalente all'oggetto corrente DependencyObject.(Ereditato da DependencyObject.)

System_CAPS_protmethodFinalize()

Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object.)

System_CAPS_pubmethodFreeze()

Rende non modificabile l'oggetto corrente e ne imposta la proprietà IsFrozen su true.(Ereditato da Freezable.)

System_CAPS_protmethodFreezeCore(Boolean)

Rende questa Animatable oggetto o determina se può essere reso non modificabile.(Ereditato da Animatable.)

System_CAPS_pubmethodGetAnimationBaseValue(DependencyProperty)

Restituisce il valore dell'oggetto specificato non animati DependencyProperty.(Ereditato da Animatable.)

System_CAPS_pubmethodGetAsFrozen()

Crea una copia di bloccata la Freezable, utilizzando i valori di proprietà di base (non animati). Poiché la copia è bloccata, gli oggetti secondari bloccati vengono copiati per riferimento.(Ereditato da Freezable.)

System_CAPS_protmethodGetAsFrozenCore(Freezable)

Rende l'istanza un clone bloccato dell'oggetto Freezable specificato usando i valori di proprietà di base (non animati).(Ereditato da Freezable.)

System_CAPS_pubmethodGetCurrentValueAsFrozen()

Crea una copia di bloccata la Freezable utilizzando i valori di proprietà correnti. Poiché la copia è bloccata, gli oggetti secondari bloccati vengono copiati per riferimento.(Ereditato da Freezable.)

System_CAPS_protmethodGetCurrentValueAsFrozenCore(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.)

System_CAPS_pubmethodGetHashCode()

Ottiene un codice hash per l'oggetto DependencyObject.(Ereditato da DependencyObject.)

System_CAPS_pubmethodGetLocalValueEnumerator()

Crea un enumeratore specializzato per determinare quali proprietà di dipendenza presentano valori impostati localmente su questo DependencyObject.(Ereditato da DependencyObject.)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_pubmethodGetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject.(Ereditato da DependencyObject.)

System_CAPS_pubmethodInvalidateProperty(DependencyProperty)

Rivaluta il valore effettivo della proprietà di dipendenza specificata(Ereditato da DependencyObject.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_protmethodOnChanged()

Chiamato quando l'oggetto corrente Freezable oggetto viene modificato.(Ereditato da Freezable.)

System_CAPS_protmethodOnFreezablePropertyChanged(DependencyObject, DependencyObject)

Assicura che adatti puntatori del contesto vengono stabiliti per un DependencyObjectType (membro dati) che è appena stato impostato.(Ereditato da Freezable.)

System_CAPS_protmethodOnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Questo membro supporta l'infrastruttura di Windows Presentation Foundation (WPF) e non deve essere usato direttamente dal codice.(Ereditato da Freezable.)

System_CAPS_protmethodOnPropertyChanged(DependencyPropertyChangedEventArgs)

Esegue l'override dell'implementazione di DependencyObject di OnPropertyChanged per richiamare anche eventuali gestori Changed in risposta alla modifica di una proprietà di dipendenza di tipo Freezable.(Ereditato da Freezable.)

System_CAPS_pubmethodReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se presente.(Ereditato da DependencyObject.)

System_CAPS_protmethodReadPreamble()

Assicura che il Freezable si accede da un thread valido. Gli eredi Freezable necessario chiamare questo metodo all'inizio di qualsiasi API che legge i membri di dati che non sono proprietà di dipendenza.(Ereditato da Freezable.)

System_CAPS_pubmethodSetCurrentValue(DependencyProperty, Object)

Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore.(Ereditato da DependencyObject.)

System_CAPS_pubmethodSetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo identificatore della proprietà di dipendenza.(Ereditato da DependencyObject.)

System_CAPS_pubmethodSetValue(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.)

System_CAPS_protmethodShouldSerializeProperty(DependencyProperty)

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza specificata.(Ereditato da DependencyObject.)

System_CAPS_pubmethodToString()

Restituisce una rappresentazione di stringa del Brush.(Esegue l'override di Object.ToString().)

System_CAPS_pubmethodToString(IFormatProvider)

Crea una rappresentazione di stringa dell'oggetto in base alle informazioni di formattazione specifiche delle impostazioni cultura specificate.

System_CAPS_pubmethodVerifyAccess()

Impone che il thread chiamante abbia accesso a questo DispatcherObject.(Ereditato da DispatcherObject.)

System_CAPS_protmethodWritePostscript()

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

System_CAPS_protmethodWritePreamble()

Verifica che il Freezable non sia bloccato e che si accede da un contesto di threading valido. Freezable gli eredi devono chiamare questo metodo all'inizio di qualsiasi API che scrive i membri di dati che non sono proprietà di dipendenza.(Ereditato da Freezable.)

NomeDescrizione
System_CAPS_pubfieldSystem_CAPS_staticOpacityProperty

Identifica la proprietà di dipendenza Opacity.

System_CAPS_pubfieldSystem_CAPS_staticRelativeTransformProperty

Identifica la proprietà di dipendenza RelativeTransform.

System_CAPS_pubfieldSystem_CAPS_staticTransformProperty

Identifica la proprietà di dipendenza Transform.

NomeDescrizione
System_CAPS_pubeventChanged

Si verifica quando il Freezable o si modifica un oggetto che contiene.(Ereditato da Freezable.)

NomeDescrizione
System_CAPS_pubinterfaceSystem_CAPS_privmethodIFormattable.ToString(String, IFormatProvider)

Formatta il valore dell'istanza corrente usando il formato specificato.

Oggetto Brush "disegna" o "riempie" un'area con il proprio output. Pennelli diversi hanno tipi diversi di output. Alcuni pennelli disegnano un'area con un colore a tinta unita, altri utenti con una sfumatura, motivo, immagine o disegno. L'elenco seguente descrive i diversi tipi di WPF pennelli:

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

Nella tabella seguente sono elencati i diversi Brush tipi che possono essere usati in XAML e la sintassi che supportano. Per informazioni dettagliate sulla sintassi per un pennello specifico, vedere pagina tipo di tale del pennello.

Classe

Sintassi degli attributi

Sintassi degli elementi oggetto

SolidColorBrush

DrawingBrush

No

ImageBrush

No

LinearGradientBrush

No

RadialGradientBrush

No

VisualBrush

No

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.

Un pennello è un tipo di Freezable oggetti. Per informazioni su Freezable funzionalità, ad esempio il blocco e la clonazione, vedere il panoramica sugli oggetti Freezable.

Per XAML informazioni, vedere il osservazioni sezione.

Note per gli eredi:

Quando si eredita dalla classe Brush, è necessario eseguire l'override del motodo CreateInstanceCore. A seconda che la classe deve eseguire operazioni di inizializzazione aggiuntive o contiene membri dati della proprietà di non dipendenza, potrebbe essere necessario eseguire l'override aggiuntive Freezable metodi. Per ulteriori informazioni sull'ereditarietà da Freezable tipi, vedere il panoramica sugli oggetti Freezable.

.NET Framework
Disponibile da 3.0
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: