Compartir a través de

RenderOptions.CachingHint Propiedad adjunta

  • Referencia

Definición

Espacio de nombres:
System.Windows.Media
Ensamblado:
PresentationCore.dll

Obtiene o establece un valor que indica que el contenido representado debe almacenarse en la memoria caché cuando sea posible.

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

Ejemplos

En el ejemplo siguiente se muestra cómo usar la opción de sugerencia de almacenamiento en caché para .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>

Comentarios

Esta propiedad adjunta es compatible TileBrush con y sus tipos derivados. Está diseñado para usarse con pinceles que tienen superficies intermedias, como DrawingBrush y VisualBrush.

De forma predeterminada, WPF no almacena en caché el contenido representado de DrawingBrush los objetos y VisualBrush . En escenarios estáticos, donde ni el contenido ni el uso del pincel en la escena cambian, el almacenamiento en caché proporciona una ventaja porque conserva la memoria de vídeo. Cuando se usa un pincel con contenido estático de forma no estática, el comportamiento predeterminado de WPF es volver a representar todo el contenido del pincel en todos los fotogramas, aunque el contenido no cambie. Por ejemplo, esto ocurrirá cuando un objeto estático DrawingBrush o VisualBrush se asigne a la superficie de un objeto 3D giratorio. Volver a representar el contenido estático puede tener un impacto negativo en el rendimiento.

Al establecer la CachingHint propiedad adjunta del pincel Cacheen , puede aumentar el rendimiento mediante versiones almacenadas en caché de los objetos de pincel en mosaico.

Los CacheInvalidationThresholdMinimum valores de propiedad y CacheInvalidationThresholdMaximum son valores de tamaño relativo que determinan cuándo se debe volver a generar el TileBrush objeto debido a cambios en la escala. Por ejemplo, cuando la CacheInvalidationThresholdMaximum propiedad se establece en 2.0, la memoria caché de TileBrush se debe volver a generar solo cuando su tamaño supera dos veces el tamaño de la memoria caché actual.

Para acceder a esta propiedad en el código, use los GetCachingHint métodos y SetCachingHint .

Información sobre propiedades de dependencia
Campo identificador CachingHintProperty
Propiedades de metadatos establecidas en true Ninguno

Se aplica a

Consulte también