Brush Classe

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Media

Definisce gli oggetti usati per disegnare oggetti grafici. Le classi che derivano da Pennello descrivono come viene dipinta l'area.

public ref class Brush : DependencyObject, IAnimationObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Brush : DependencyObject, IAnimationObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Brush : DependencyObject, IAnimationObject

Public Class Brush
Inherits DependencyObject
Implements IAnimationObject

<object property="predefinedColorName"/>
- or -
<object property="#rgb"/>
- or -
<object property="#argb"/>
- or -
<object property="#rrggbb"/>
- or -
<object property="#aarrggbb"/>
- or -
<object property="sc#scR,scG,scB"/>
- or -
<object property="sc#scA,scR,scG,scB"/>

Ereditarietà

Object Platform::Object IInspectable DependencyObject Brush

Derivato

Windows.UI.Xaml.Media.GradientBrush

Windows.UI.Xaml.Media.SolidColorBrush

Windows.UI.Xaml.Media.TileBrush

Windows.UI.Xaml.Media.XamlCompositionBrushBase

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IAnimationObject

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Per esempi e altre spiegazioni dei concetti di disegno dell'interfaccia utente rappresentati da Pennello, vedere Usare i pennelli.

Pennelli come risorse XAML

Ogni tipo di pennello che può essere dichiarato in XAML (SolidColorBrush, LinearGradientBrush, ImageBrush) è destinato a essere definito come risorsa, in modo che sia possibile riutilizzare tale pennello come risorsa in tutta l'app. La sintassi XAML illustrata per i tipi Di pennello è appropriata per definire il pennello come risorsa. Quando si dichiara un pennello come risorsa, è necessario anche un attributo x:Key che verrà usato in seguito per fare riferimento a tale risorsa da altre definizioni dell'interfaccia utente. Per altre informazioni sulle risorse XAML e su come usare l'attributo x:Key, vedere Riferimenti alle risorse ResourceDictionary e XAML.

Il vantaggio di dichiarare pennelli come risorse è che riduce il numero di oggetti di runtime necessari per costruire un'interfaccia utente: il pennello è ora condiviso come risorsa comune che fornisce valori per più parti del grafico a oggetti.

Se si esaminano le definizioni dei modelli di controllo esistenti per i controlli XAML Windows Runtime, si noterà che i modelli usano ampiamente le risorse pennello. Molte di queste risorse sono risorse di sistema e usano l'estensione di markup {ThemeResource} per il riferimento alla risorsa anziché all'estensione di markup {StaticResource}. Per altre informazioni su come usare i pennelli delle risorse di sistema nel modello di controllo XAML, vedere Risorse del tema XAML.

Classi derivate del pennello

Pennello è la classe padre per diverse classi derivate che implementano pennelli pratici che dipingono le aree dell'interfaccia utente o sono classi di base intermedie per tali pennelli:

• GradientBrush: classe di base intermedia per LinearGradientBrush.
• SolidColorBrush: questo è per molto il pennello più comunemente usato.
• TileBrush: classe di base intermedia per ImageBrush.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1809	17763	PopolapropertyInfo
1809	17763	PopolarePropertyInfoOverride

Costruttori

Brush()

Fornisce il comportamento di inizializzazione della classe di base per le classi derivate da Pennello.

Proprietà

Dispatcher	Ottiene CoreDispatcher associato a questo oggetto. CoreDispatcher rappresenta una struttura che può accedere a DependencyObject nel thread dell'interfaccia utente anche se il codice viene avviato da un thread non interfaccia utente. (Ereditato da DependencyObject)
Opacity	Ottiene o imposta il grado di opacità di un pennello.
OpacityProperty	Identifica la proprietà di dipendenza Opacity .
RelativeTransform	Ottiene o imposta la trasformazione applicata al pennello usando coordinate relative.
RelativeTransformProperty	Identifica la proprietà di dipendenza RelativeTransform .
Transform	Ottiene o imposta la trasformazione applicata al pennello.
TransformProperty	Identifica la proprietà Transform dependency.

Metodi

ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà di dipendenza. (Ereditato da DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Restituisce qualsiasi valore di base stabilito per una proprietà di dipendenza, che si applica nei casi in cui un'animazione non è attiva. (Ereditato da DependencyObject)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza da un oggetto DependencyObject. (Ereditato da DependencyObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Definisce una proprietà che può essere animata.
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	Quando sottoposto a override in una classe derivata, definisce una proprietà che può essere animata.
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se viene impostato un valore locale. (Ereditato da DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una funzione di notifica per l'ascolto delle modifiche a un'istanza di DependencyObject specifica. (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza in un oggetto DependencyObject. (Ereditato da DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback. (Ereditato da DependencyObject)

Vedi anche

• DependencyObject
• SolidColorBrush
• Color
• Colors
• Usare i pennelli
• Image e ImageBrush
• Riferimenti a ResourceDictionary e risorse XAML