CachingHint Énumération

  • Référence

Définition

Espace de noms:
System.Windows.Media
Assembly:
PresentationCore.dll

Spécifie si les objets de pinceau en mosaïque doivent être mis en cache.

public enum class CachingHint
public enum CachingHint
type CachingHint = 
Public Enum CachingHint
Héritage
Object
ValueType
Enum
CachingHint

Champs

Cache 1

Met en cache les objets de pinceau en mosaïque dans une mémoire tampon hors écran, à l'aide des valeurs d'optimisation de mise en cache spécifiées par les paramètres RenderOptions.
Unspecified 0

Aucune valeur d'optimisation de mise en cache n'est spécifiée.

Exemples

L’exemple suivant montre comment utiliser l’option d’indicateur de mise en cache pour un 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)

Remarques

Par défaut, WPF ne met pas en cache le contenu rendu des objets et VisualBrush des DrawingBrush objets. Dans les scénarios statiques où ni le contenu ni l’utilisation du pinceau dans la scène changent, la mise en cache n’offre pas d’avantages car elle conserve la mémoire vidéo. Lorsqu’un pinceau avec du contenu statique est utilisé de manière non statique, le comportement par défaut de WPF consiste à réexécrire l’intégralité du contenu du pinceau, même si le contenu n’change pas. Par exemple, cela se produit lorsqu’un objet statique DrawingBrush ou VisualBrush est mappé à la surface d’un objet 3D pivotant. Le rendu du contenu statique peut avoir un impact négatif sur les performances.

En définissant la CachingHint propriété jointe sur le pinceau sur Cache, vous pouvez augmenter les performances à l’aide de versions mises en cache des objets de pinceau en mosaïques.

Les CacheInvalidationThresholdMinimum valeurs et CacheInvalidationThresholdMaximum les valeurs de propriété sont des valeurs de taille relative qui déterminent quand l’objet doit être régénéré en raison des modifications apportées à l’échelle TileBrush . Par exemple, en définissant la CacheInvalidationThresholdMaximum propriété sur 2.0, le cache pour le TileBrush seul doit être régénéré lorsque sa taille dépasse deux fois la taille du cache actuel.

S’applique à

Voir aussi