RenderOptions.CachingHint Propriété attachée

  • Référence

Définition

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

Obtient ou définit une valeur qui indique que le contenu rendu doit être mis en cache si possible.

see GetCachingHint, and SetCachingHint
see GetCachingHint, and SetCachingHint
see GetCachingHint, and SetCachingHint

Exemples

L’exemple suivant montre comment utiliser l’option d’indicateur de mise en cache pour un DrawingBrush.

<DrawingBrush x:Key="drawingBrush"
              RenderOptions.CachingHint="Cache"
              RenderOptions.CacheInvalidationThresholdMaximum="2.0"
              RenderOptions.CacheInvalidationThresholdMinimum="0.5">
    <DrawingBrush.Drawing>
        <GeometryDrawing Brush="Blue">
            <GeometryDrawing.Geometry>
                <GeometryGroup>
                    <EllipseGeometry RadiusX="20" RadiusY="20" Center="10,10" />
                </GeometryGroup>
            </GeometryDrawing.Geometry>
            <GeometryDrawing.Pen>
                <Pen Thickness="10" Brush="Black" />
            </GeometryDrawing.Pen>
        </GeometryDrawing>
    </DrawingBrush.Drawing>
</DrawingBrush>

Remarques

Cette propriété jointe est prise en charge par TileBrush et ses types dérivés. Il est destiné à être utilisé avec des pinceaux qui ont des surfaces intermédiaires, telles que DrawingBrush et VisualBrush.

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 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 à renvoyer 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é attachée du pinceau sur Cache, vous pouvez augmenter les performances à l’aide des 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.

Pour accéder à cette propriété dans le code, utilisez les GetCachingHint méthodes et SetCachingHint .

Informations sur les propriétés de dépendance
Champ Identificateur CachingHintProperty
Propriétés de métadonnées définies sur true Aucun

S’applique à

Voir aussi