BitmapCache Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea e memorizza nella cache una rappresentazione bitmap di un oggetto UIElement.
public ref class BitmapCache sealed : System::Windows::Media::CacheModepublic sealed class BitmapCache : System.Windows.Media.CacheModetype BitmapCache = class
inherit CacheModePublic NotInheritable Class BitmapCache
Inherits CacheMode- Ereditarietà
Esempio
Il codice XAML seguente mostra come memorizzare nella cache un Canvas elemento. Per l'esempio di codice completo, vedere Procedura: Migliorare le prestazioni di rendering memorizzando nella cache un elemento.
<!-- //////////////////////////////////////////////////////////////// -->
<!-- // The following XAML creates a BitmapCache with default // -->
<!-- // properties and assigns it as the CacheMode for the canvas. // -->
<!-- //////////////////////////////////////////////////////////////// -->
<Canvas.CacheMode>
<BitmapCache EnableClearType="False"
RenderAtScale="1"
SnapsToDevicePixels="False" />
</Canvas.CacheMode>
Commenti
Usare la BitmapCache classe per migliorare le prestazioni di rendering di un complesso UIElement. Creare un oggetto BitmapCache e assegnarlo alla CacheMode proprietà di un UIElement oggetto per memorizzare nella cache l'elemento e il relativo sottoalbero come bitmap in memoria video. Ciò è utile quando è necessario animare, tradurre o ridimensionare un oggetto UIElement il più rapidamente possibile. Questo approccio consente un compromesso tra prestazioni e qualità visiva mentre il contenuto viene memorizzato nella cache.
Usare la BitmapCacheBrush classe per riutilizzare in modo efficiente un elemento memorizzato nella cache.
Impostare la RenderAtScale proprietà per ridimensionare la cache bitmap. Ciò è utile se verrà eseguito lo zoom di un elemento e si vuole che l'elemento esegua il rendering più chiaramente di quanto sarebbe se la cache fosse semplicemente generata alla risoluzione nativa dell'elemento.
Impostare la SnapsToDevicePixels proprietà quando la cache visualizza il contenuto che richiede l'allineamento pixel per il rendering corretto, ad esempio testo ClearType. Questa proprietà viene ignorata dalle BitmapCacheBrush classi e Viewport2DVisual3D .
La memorizzazione nella cache di un controllo non influisce sul comportamento del puntatore del mouse, quindi i test di hit test tramite mouse funzionano come se la bitmap fosse un controllo attivo.
La rigenerazione della cache si verifica solo quando cambia la struttura del UIElement sottoalbero o quando le CacheMode impostazioni cambiano. L'impostazione delle proprietà o EnableClearType comporta la RenderAtScale rigenerazione della cache. Le modifiche apportate all'albero visivo padre della cache UIElement, ad esempio trasformazioni, scale, opacità ed effetti, non influiscono sulla cache.
La cache funziona quando l'accelerazione hardware non è disponibile. In questo caso, il rendering della bitmap viene eseguito nel software e le dimensioni massime della bitmap sono 2048 x 2048.
Annotazioni
RenderOptions e TextOptions non propagano attraverso un elemento memorizzato nella cache. Potrebbe essere necessario impostare di nuovo queste opzioni negli elementi figlio sotto la cache.
Costruttori
| Nome | Descrizione |
|---|---|
| BitmapCache() |
Inizializza una nuova istanza della classe BitmapCache. |
| BitmapCache(Double) |
Inizializza una nuova istanza della BitmapCache classe con la scala specificata. |
Campi
| Nome | Descrizione |
|---|---|
| EnableClearTypeProperty |
Identifica la EnableClearType proprietà di dipendenza. |
| RenderAtScaleProperty |
Identifica la RenderAtScale proprietà di dipendenza. |
| SnapsToDevicePixelsProperty |
Identifica la SnapsToDevicePixels 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) |
| EnableClearType |
Ottiene o imposta un valore che indica se viene eseguito il rendering della bitmap con ClearType attivato. |
| 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) |
| RenderAtScale |
Ottiene o imposta un valore che indica la scala applicata alla bitmap. |
| SnapsToDevicePixels |
Ottiene o imposta un valore che indica se il rendering della bitmap viene eseguito con lo snapping pixel. |
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 dell'oggetto BitmapCache, eseguendo copie complete dei valori dell'oggetto. Quando si copiano le proprietà di dipendenza dell'oggetto, questo metodo copia le espressioni (che potrebbero non essere più risolte) 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 (copia completa) dell'oggetto BitmapCache utilizzando i relativi valori correnti. |
| 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 |
| 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) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| 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) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnChanged() |
Chiamato quando l'oggetto corrente Freezable viene modificato. (Ereditato da Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Questo membro supporta l'infrastruttura di Windows Presentation Foundation (WPF) e non deve essere usato 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 una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| 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) |
