Condividi tramite

CachingHint Enumerazione

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Media
Assembly:
PresentationCore.dll

Specifica se memorizzare nella cache oggetti pennello affiancati.

public enum class CachingHint
public enum CachingHint
type CachingHint = 
Public Enum CachingHint
Ereditarietà
Object
ValueType
Enum
CachingHint

Campi

Cache 1

Memorizzare nella cache gli oggetti pennello affiancati in un buffer fuori schermo, utilizzando i suggerimenti di memorizzazione nella cache specificati dalle impostazioni RenderOptions.
Unspecified 0

Nessun suggerimento di memorizzazione nella cache specificato.

Esempio

Nell'esempio seguente viene illustrato come usare l'opzione hint per la memorizzazione nella cache per un oggetto DrawingBrush.

DrawingBrush drawingBrush = new DrawingBrush();
            
// Set the caching hint option for the brush.
RenderOptions.SetCachingHint(drawingBrush, CachingHint.Cache);

// Set the minimum and maximum relative sizes for regenerating the tiled brush.
// The tiled brush will be regenerated and re-cached when its size is
// 0.5x or 2x of the current cached size.
RenderOptions.SetCacheInvalidationThresholdMinimum(drawingBrush, 0.5);
RenderOptions.SetCacheInvalidationThresholdMaximum(drawingBrush, 2.0);

Dim drawingBrush As New DrawingBrush()

' Set the caching hint option for the brush.
RenderOptions.SetCachingHint(drawingBrush, CachingHint.Cache)

' Set the minimum and maximum relative sizes for regenerating the tiled brush.
' The tiled brush will be regenerated and re-cached when its size is
' 0.5x or 2x of the current cached size.
RenderOptions.SetCacheInvalidationThresholdMinimum(drawingBrush, 0.5)
RenderOptions.SetCacheInvalidationThresholdMaximum(drawingBrush, 2.0)

Commenti

Per impostazione predefinita, WPF non memorizza nella cache il contenuto sottoposto a rendering di DrawingBrush oggetti e VisualBrush . Negli scenari statici in cui né il contenuto né l'uso del pennello nella scena cambiano, non la memorizzazione nella cache offre un vantaggio perché consente di risparmiare memoria video. Quando un pennello con contenuto statico viene usato in modo non statico, il comportamento predefinito di WPF consiste nel eseguire nuovamente il rendering dell'intero contenuto del pennello ogni fotogramma, anche se il contenuto non cambia. Ad esempio, ciò si verifica quando viene eseguito il mapping di un oggetto statico DrawingBrush o VisualBrush alla superficie di un oggetto 3D rotante. Il rendering del contenuto statico può avere un impatto negativo sulle prestazioni.

Impostando la CachingHint proprietà associata sul pennello su Cache, è possibile aumentare le prestazioni usando le versioni memorizzate nella cache degli oggetti pennello affiancati.

I valori delle CacheInvalidationThresholdMinimum proprietà e CacheInvalidationThresholdMaximum sono valori di dimensioni relative che determinano quando l'oggetto TileBrush deve essere rigenerato a causa di modifiche nella scala. Impostando ad esempio la CacheInvalidationThresholdMaximum proprietà su 2.0, è necessario rigenerare la TileBrush cache solo quando le dimensioni superano due volte le dimensioni della cache corrente.

Si applica a

Vedi anche