TileBrush Classe

Definizione

Spazio dei nomi:

System.Windows.Media

Assembly:

PresentationCore.dll

Descrive un modo per disegnare un'area utilizzando uno o più tessere.

public ref class TileBrush abstract : System::Windows::Media::Brush

public abstract class TileBrush : System.Windows.Media.Brush

type TileBrush = class
    inherit Brush

Public MustInherit Class TileBrush
Inherits Brush

Ereditarietà

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Brush

TileBrush

Derivato

System.Windows.Media.DrawingBrush

System.Windows.Media.ImageBrush

System.Windows.Media.VisualBrush

Commenti

Le classi derivate di TileBrush definiscono il contenuto dei riquadri usati per disegnare un'area. Ad esempio, usare la ImageBrush classe per disegnare un'area usando un'immagine.

Utilizzare un TileBrush oggetto per controllare la modalità di disegno di un'area. Ad esempio, Windows Presentation Foundation (WPF) fornisce diversi tipi di pennelli:

• Per disegnare usando un'immagine, usare .ImageBrush

• Per disegnare tramite disegno, utilizzare .DrawingBrush

• Per disegnare usando un Visualoggetto , utilizzare .VisualBrush

Quando si utilizza per disegnare un'area TileBrush , anziché disegnare un'area utilizzando un'unica immagine estesa, è possibile disegnare un'area usando una serie di riquadri immagine che creano un motivo.

Quando si disegna un'area usando un TileBrush, si usano tre componenti: contenuto, riquadri e area di output. Le illustrazioni seguenti illustrano in che modo questi tre TileBrush componenti sono correlati tra loro.

Componenti di un oggetto TileBrush con una sola tessera

Componenti di un oggetto TileBrush con TileMode impostata su Tile

Contenuto: A TileBrush può avere diversi tipi di contenuto:

• Se il pennello è un ImageBrushoggetto , questo contenuto è un'immagine. La ImageSource proprietà specifica il contenuto dell'oggetto ImageBrush.

• Se il pennello è un DrawingBrushoggetto , questo contenuto è un disegno. La Drawing proprietà specifica il contenuto dell'oggetto DrawingBrush.

• Se il pennello è un VisualBrushoggetto , questo contenuto è un oggetto visivo. La Visual proprietà specifica il contenuto dell'oggetto VisualBrush.

È possibile specificare la posizione e le dimensioni del TileBrush contenuto usando la Viewbox proprietà .

Riquadri: un oggetto TileBrush produce uno o più riquadri. Per impostazione predefinita, il contenuto del pennello viene esteso per riempire un singolo riquadro e tale riquadro viene esteso per riempire l'area di output. La Viewport proprietà viene utilizzata per specificare le dimensioni e la posizione del riquadro di base per .TileBrush La ViewportUnits proprietà determina se le dimensioni e la posizione di sono relative all'area di Viewport output (comportamento predefinito) o se sono valori assoluti.

Area di output: l'area di output è l'area di disegno del pennello, ad esempio l'oggetto Fill di un oggetto Ellipse o Background di un oggetto Button.

Per altre informazioni sulla TileBrush classe , vedere Disegno con immagini, disegni e oggetti visivi .

Funzionalità di Freezable

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

Note per gli implementatori

Quando si eredita dalla TileBrush classe , è necessario eseguire l'override del CreateInstanceCore() metodo . Per altre informazioni sull'ereditarietà dai Freezable tipi, vedere Cenni preliminari sugli oggetti Freezable.

Costruttori

TileBrush()

Fornisce l'inizializzazione per i valori della classe base quando vengono chiamati dal costruttore di una classe derivata.

Campi

AlignmentXProperty	Identifica la proprietà di dipendenza AlignmentX.
AlignmentYProperty	Identifica la proprietà di dipendenza AlignmentY.
StretchProperty	Identifica la proprietà di dipendenza Stretch.
TileModeProperty	Identifica la proprietà di dipendenza TileMode.
ViewboxProperty	Identifica la proprietà di dipendenza Viewbox.
ViewboxUnitsProperty	Identifica la proprietà di dipendenza ViewboxUnits.
ViewportProperty	Identifica la proprietà di dipendenza Viewport.
ViewportUnitsProperty	Identifica la proprietà di dipendenza ViewportUnits.

Proprietà

AlignmentX	Ottiene o imposta l'allineamento orizzontale del contenuto nella tessera di base di TileBrush.
AlignmentY	Ottiene o imposta l'allineamento verticale del contenuto nella tessera di base di TileBrush.
CanFreeze	Ottiene un valore che indica se l'oggetto può essere impostato come 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 Dispatcher associato a DispatcherObject. (Ereditato da DispatcherObject)
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)
Opacity	Ottiene o imposta il livello di opacità di Brush. (Ereditato da Brush)
RelativeTransform	Ottiene o imposta la trasformazione applicata al pennello usando coordinate relative. (Ereditato da Brush)
Stretch	Ottiene o imposta un valore che specifica il modo in cui il contenuto di TileBrush occupa interamente le proprie tessere.
TileMode	Recupera o imposta un valore che specifica la modalità di riempimento dell'area da disegnare con un controllo TileBrush nel caso in cui la tessera di base sia più piccola dell'area di output.
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)
Viewbox	Ottiene o imposta la posizione e le dimensioni del contenuto in una tessera TileBrush.
ViewboxUnits	Ottiene o imposta un valore che specifica se il valore di Viewbox è relativo al riquadro delimitatore del testo del contenuto di TileBrush o se il valore è assoluto.
Viewport	Ottiene o imposta la posizione e le dimensioni di una tessera di base per una classe TileBrush.
ViewportUnits	Ottiene o imposta un'enumerazione BrushMappingMode che specifica se il valore di Viewport, che indica le dimensioni e la posizione della tessera di base TileBrush, è relativo alle dimensioni dell'area di output.

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 una copia modificabile di questo oggetto TileBrush, eseguendo copie complete dei suoi valori.
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 una copia modificabile di questo oggetto TileBrush eseguendo copie complete dei relativi valori. Questo metodo non copia riferimenti di risorsa, associazioni dati né animazioni, sebbene esegua una copia dei 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 true. (Ereditato da Freezable)
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)
GetContentBounds(Rect)	Ottiene i limiti correnti del contenuto della classe TileBrush.
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 usato 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)

Vedi anche

• Stretch
• Viewport
• TileMode
• AlignmentX
• AlignmentY
• Viewbox