RenderOptions.SetCachingHint(DependencyObject, CachingHint) Méthode

Définition

Définit la valeur de la propriété attachée CachingHint sur un objet de dépendance spécifié.

public:
 static void SetCachingHint(System::Windows::DependencyObject ^ target, System::Windows::Media::CachingHint cachingHint);
public static void SetCachingHint (System.Windows.DependencyObject target, System.Windows.Media.CachingHint cachingHint);
static member SetCachingHint : System.Windows.DependencyObject * System.Windows.Media.CachingHint -> unit
Public Shared Sub SetCachingHint (target As DependencyObject, cachingHint As CachingHint)

Paramètres

target
DependencyObject

Objet de dépendance sur lequel définir la valeur de la propriété CachingHint.

cachingHint
CachingHint

Nouvelle valeur à affecter à la propriété.

Exceptions

Le target spécifié a la valeur null.

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 DrawingBrush objets et VisualBrush . Dans les scénarios statiques, où ni le contenu ni l’utilisation du pinceau dans la scène ne changent, la non-mise en cache offre un avantage, 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 à restituer tout le contenu du pinceau à chaque image, même si le contenu est immuable. Par exemple, cela se produit lorsqu’un objet statique DrawingBrush ou VisualBrush est mappé à la surface d’un objet 3D en rotation. Le rendu du contenu statique peut avoir un impact négatif sur les performances.

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

Les CacheInvalidationThresholdMinimum valeurs de propriété et CacheInvalidationThresholdMaximum sont des valeurs de taille relative qui déterminent quand l’objet TileBrush doit être régénéré en raison de changements d’échelle. Par exemple, lorsque la CacheInvalidationThresholdMaximum propriété est définie sur 2.0, le cache du TileBrush doit être régénéré uniquement lorsque sa taille dépasse deux fois la taille du cache actuel.

Utilisez cette méthode pour définir la CachingHint propriété jointe dans le code.

S’applique à

Voir aussi