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
Questa documentazione è stata archiviata e non viene gestita.

Classe TileBrush

Descrive una modalità per disegnare un'area utilizzando una o più tessere.

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

public abstract class TileBrush : Brush

Il tipo TileBrush espone i seguenti membri.

  NomeDescrizione
Metodo protettoTileBrushFornisce l'inizializzazione per i valori della classe di base quando vengono chiamati dal costruttore di una classe derivata.
In alto

  NomeDescrizione
Proprietà pubblicaAlignmentXOttiene o imposta l'allineamento orizzontale del contenuto nella tessera di base della classe TileBrush.
Proprietà pubblicaAlignmentYOttiene o imposta l'allineamento verticale del contenuto nella tessera di base della classe TileBrush.
Proprietà pubblicaCanFreezeOttiene un valore che indica se è possibile rendere immodificabile l’oggetto. (Ereditato da Freezable)
Proprietà pubblicaDependencyObjectType Ottiene il DependencyObjectType che esegue il wrapping CLR del tipo dell'istanza. (Ereditato da DependencyObject)
Proprietà pubblicaDispatcher Ottiene l'oggetto Dispatcher al quale l'oggetto DispatcherObject è associato. (Ereditato da DispatcherObject)
Proprietà pubblicaHasAnimatedPropertiesOttiene 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)
Proprietà pubblicaIsFrozenOttiene un valore che indica se l’oggetto è attualmente immodificabile. (Ereditato da Freezable)
Proprietà pubblicaIsSealedOttiene un valore che indica se l'istanza è attualmente sealed (di sola lettura). (Ereditato da DependencyObject)
Proprietà pubblicaOpacity Ottiene o imposta il livello di opacità di un oggetto Brush. (Ereditato da Brush)
Proprietà pubblicaRelativeTransformOttiene o imposta la trasformazione applicata al pennello utilizzando coordinate relative. (Ereditato da Brush)
Proprietà pubblicaStretchOttiene o imposta un valore che specifica il modo in cui il contenuto di questa classe TileBrush viene esteso per far sì che si adatti alle relative tessere.
Proprietà pubblicaTileModeOttiene o imposta un valore che specifica il modo in cui una classe TileBrush riempie l'area disegnata se la tessera di base presenta dimensioni inferiori rispetto all'area di output.
Proprietà pubblicaTransformOttiene o imposta la trasformazione applicata al pennello. La trasformazione viene applicata dopo che l'output del pennello è stato mappato e posizionato. (Ereditato da Brush)
Proprietà pubblicaViewboxOttiene o imposta la posizione e le dimensioni del contenuto in una tessera della classe TileBrush.
Proprietà pubblicaViewboxUnitsOttiene o imposta un valore che specifica se il valore Viewbox è relativo al riquadro delimitatore del testo del contenuto della classe TileBrush oppure si tratta di un valore è assoluto.
Proprietà pubblicaViewportOttiene o imposta la posizione e le dimensioni di una tessera di base per una classe TileBrush.
Proprietà pubblicaViewportUnitsOttiene o imposta un'enumerazione BrushMappingMode che specifica se il valore della proprietà Viewport indicante le dimensioni e la posizione della tessera di base della classe TileBrush è relativo o meno alle dimensioni dell'area di output.
In alto

  NomeDescrizione
Metodo pubblicoApplyAnimationClock(DependencyProperty, AnimationClock)Applica un oggetto AnimationClock all'oggetto DependencyProperty specificato. Se alla proprietà è già stata aggiunta un'animazione, viene utilizzato il comportamento uniforme dell'oggetto SnapshotAndReplace. (Ereditato da Animatable)
Metodo pubblicoApplyAnimationClock(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)
Metodo pubblicoBeginAnimation(DependencyProperty, AnimationTimeline)Applica un'animazione all'oggetto DependencyProperty specificato. L'animazione viene avviata quando si esegue il rendering del fotogramma successivo. Se alla proprietà specificata è già stata aggiunta un'animazione, viene utilizzato il comportamento uniforme dell'oggetto SnapshotAndReplace. (Ereditato da Animatable)
Metodo pubblicoBeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)Applica un'animazione all'oggetto DependencyProperty specificato. L'animazione viene avviata quando si esegue il rendering del fotogramma successivo. Se alla proprietà specificata è già stata aggiunta un'animazione, viene utilizzato l'oggetto HandoffBehavior specificato. (Ereditato da Animatable)
Metodo pubblicoCheckAccess Determina se il thread chiamante ha accesso a questo DispatcherObject. (Ereditato da DispatcherObject)
Metodo pubblicoClearValue(DependencyProperty) Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un identificatore DependencyProperty. (Ereditato da DependencyObject)
Metodo pubblicoClearValue(DependencyPropertyKey)Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare è indicata da un identificatore DependencyPropertyKey. (Ereditato da DependencyObject)
Metodo pubblicoCloneCrea una copia modificabile di questo oggetto TileBrush eseguendo copie complete dei relativi valori.
Metodo protettoCloneCoreSi prenda ad esempio un clone (copia completa) di Freezable specificato utilizzando valori della proprietà di base (non-animati). (Ereditato da Freezable)
Metodo pubblicoCloneCurrentValueCrea 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.
Metodo protettoCloneCurrentValueCoreRende l’istanza una copia modificabile (copia completa) dell'oggetto Freezable specificato utilizzando i valori della proprietà correnti. (Ereditato da Freezable)
Metodo pubblicoCoerceValueAssegna 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)
Metodo protettoCreateInstanceInizializza una nuova istanza della classe Freezable. (Ereditato da Freezable)
Metodo protettoCreateInstanceCoreQuando è implementato in una classe derivata, crea una nuova istanza della classe derivata Freezable. (Ereditato da Freezable)
Metodo pubblicoEquals Determina se il DependencyObject fornito equivale al DependencyObject corrente. (Ereditato da DependencyObject)
Metodo protettoFinalize 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)
Metodo pubblicoFreeze()Rende immodificabile l'oggetto corrente e imposta la proprietà IsFrozen su true. (Ereditato da Freezable)
Metodo protettoFreezeCoreRende immodificabile questo oggetto Animatable o determina se l'oggetto può essere reso immodificabile. (Ereditato da Animatable)
Metodo pubblicoGetAnimationBaseValueRestituisce il valore non animato dell'oggetto DependencyProperty specificato. (Ereditato da Animatable)
Metodo pubblicoGetAsFrozenCrea 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)
Metodo protettoGetAsFrozenCoreSi prenda ad esempio una copia bloccata di Freezable specificato utilizzando valori della proprietà di base (non-animati). (Ereditato da Freezable)
Metodo protettoGetContentBoundsOttiene i limiti correnti del contenuto della classe TileBrush
Metodo pubblicoGetCurrentValueAsFrozenCrea 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)
Metodo protettoGetCurrentValueAsFrozenCoreRende l’istanza corrente una copia bloccata di Freezablespecificato. Se l'oggetto dispone di proprietà di dipendenza animate, i valori animati correnti vengono copiati. (Ereditato da Freezable)
Metodo pubblicoGetHashCodeOttiene un codice hash per questo oggetto DependencyObject. (Ereditato da DependencyObject)
Metodo pubblicoGetLocalValueEnumeratorCrea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject. (Ereditato da DependencyObject)
Metodo pubblicoGetType Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblicoGetValueRestituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject. (Ereditato da DependencyObject)
Metodo pubblicoInvalidatePropertyValuta di nuovo il valore effettivo della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
Metodo protettoMemberwiseClone Crea una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo protettoOnChangedViene chiamato quando l'oggetto Freezable corrente viene modificato. (Ereditato da Freezable)
Metodo protettoOnFreezablePropertyChanged(DependencyObject, DependencyObject)Assicura che adatti puntatori del contesto siano stabiliti per un membro dati DependencyObjectType che è appena stato impostato. (Ereditato da Freezable)
Metodo protettoOnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)Questo membro supporta l'infrastruttura Windows Presentation Foundation (WPF) e non può essere utilizzato direttamente dal codice. (Ereditato da Freezable)
Metodo protettoOnPropertyChangedEsegue l'override dell'implementazione DependencyObject di OnPropertyChanged per richiamare anche qualsiasi gestore Changed in risposta a una modifica della proprietà di dipendenza di tipo Freezable. (Ereditato da Freezable)
Metodo pubblicoReadLocalValueRestituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject)
Metodo protettoReadPreambleAssicura 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)
Metodo pubblicoSetCurrentValueImposta il valore di una proprietà di dipendenza senza modificare l'origine del valore. (Ereditato da DependencyObject)
Metodo pubblicoSetValue(DependencyProperty, Object)Imposta il valore locale di una proprietà di dipendenza, specificata dal relativo identificatore. (Ereditato da DependencyObject)
Metodo pubblicoSetValue(DependencyPropertyKey, Object) Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore della proprietà di dipendenza DependencyPropertyKey. (Ereditato da DependencyObject)
Metodo protettoShouldSerializeProperty Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore fornito per la proprietà di dipendenza specificata. (Ereditato da DependencyObject)
Metodo pubblicoToString() Rappresentazione in forma di stringa restituita di Brush. (Ereditato da Brush)
Metodo pubblicoToString(IFormatProvider) Crea una rappresentazione di stringa dell'oggetto in base alle informazioni di formattazione specifiche delle impostazioni cultura specificate. (Ereditato da Brush)
Metodo pubblicoVerifyAccess Impone che il thread chiamante abbia accesso a questo DispatcherObject. (Ereditato da DispatcherObject)
Metodo protettoWritePostscriptGenera 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 della classe non archiviati come proprietà di dipendenza. (Ereditato da Freezable)
Metodo protettoWritePreambleVerifica 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)
In alto

  NomeDescrizione
Evento pubblicoChangedSi verifica quando Freezable o un oggetto che contiene è modificato. (Ereditato da Freezable)
In alto

  NomeDescrizione
Campo pubblicoMembro staticoAlignmentXPropertyIdentifica la proprietà di dipendenza AlignmentX.
Campo pubblicoMembro staticoAlignmentYPropertyIdentifica la proprietà di dipendenza AlignmentY.
Campo pubblicoMembro staticoStretchPropertyIdentifica la proprietà di dipendenza Stretch.
Campo pubblicoMembro staticoTileModePropertyIdentifica la proprietà di dipendenza TileMode.
Campo pubblicoMembro staticoViewboxPropertyIdentifica la proprietà di dipendenza Viewbox.
Campo pubblicoMembro staticoViewboxUnitsPropertyIdentifica la proprietà di dipendenza ViewboxUnits.
Campo pubblicoMembro staticoViewportPropertyIdentifica la proprietà di dipendenza Viewport.
Campo pubblicoMembro staticoViewportUnitsPropertyIdentifica la proprietà di dipendenza ViewportUnits.
In alto

  NomeDescrizione
Implementazione esplicita dell'interfacciaMetodo privatoIFormattable.ToStringFormatta il valore dell'istanza corrente utilizzando il formato specificato. (Ereditato da Brush)
In alto

Le classi derivate di TileBrush definiscono il contenuto delle tessere utilizzate per disegnare un'area. Ad esempio, utilizzare la classe ImageBrush per disegnare un'area utilizzando un'immagine.

Utilizzare una classe TileBrush per controllare il modo in cui si disegna un'area. In Windows Presentation Foundation (WPF), ad esempio, sono disponibili diversi tipi di pennelli.

  • Per disegnare utilizzando un'immagine, utilizzare la classe ImageBrush.

  • Per disegnare tracciando un disegno, utilizzare la classe DrawingBrush.

  • Per disegnare utilizzando un oggetto Visual, utilizzare la classe VisualBrush.

Se si utilizza la classe TileBrush anziché una sola immagine estesa, è possibile disegnare un'area tramite una serie di tessere che creano un motivo.

Quando si disegna un'area utilizzando una classe TileBrush, si utilizzano tre componenti, ovvero contenuto, tessere e area di output. Di seguito è illustrata la relazione tra questi tre componenti della classe TileBrush.

Componenti di un oggetto TileBrush con una sola tessera

Componenti di TileBrush
Componenti di un oggetto TileBrush con TileMode impostata su Tile

Componenti di un oggetto TileBrush affiancato

Contenuto: una classe TileBrush può presentare diversi tipi di contenuto.

Per specificare la posizione e le dimensioni del contenuto della classe TileBrush è possibile utilizzare la proprietà Viewbox.

Tessere: una classe TileBrush produce una o più tessere. Per impostazione predefinita, il contenuto del pennello viene esteso per riempire una sola tessera e questa, a sua volta, viene estesa per riempire l'area di output. La proprietà Viewport viene utilizzata per specificare le dimensioni e la posizione della tessera di base per la classe TileBrush. La proprietà ViewportUnits determina se le dimensioni e la posizione relative alla proprietà Viewport sono relative all'area di output (comportamento predefinito) oppure sono valori assoluti.

Area di output: per area di output si intende l'area disegnata dal pennello, ad esempio la proprietà Fill di un oggetto Ellipse o la proprietà Background di un oggetto Button.

Per ulteriori informazioni sulla classe TileBrush, vedere Painting with Images, Drawings, and Visuals.

Funzionalità dell'oggetto Freezable

Una classe TileBrush è di tipo Freezable. Per informazioni sulle funzionalità di Freezable, quali il blocco e la clonazione, vedere Freezable Objects Overview.

Note per gli eredi

Quando si eredita dalla classe TileBrush, è necessario eseguire l'override del metodo CreateInstanceCore. Per ulteriori informazioni sull'eredità dagli oggetti di tipo Freezable, vedere Freezable Objects Overview.

.NET Framework

Supportato in: 4, 3.5, 3.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Mostra: