Partilhar via


RenderOptions.CacheInvalidationThresholdMaximum Propriedade anexada

Definição

Obtém ou define o valor de máximo de limite de invalidação de cache para determinado DependencyObject.

see GetCacheInvalidationThresholdMaximum, and SetCacheInvalidationThresholdMaximum
see GetCacheInvalidationThresholdMaximum, and SetCacheInvalidationThresholdMaximum
see GetCacheInvalidationThresholdMaximum, and SetCacheInvalidationThresholdMaximum

Exemplos

O exemplo a seguir mostra como usar a opção de dica de cache para um 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>

Comentários

Essa propriedade anexada tem suporte TileBrush e seus tipos derivados. Destina-se a ser usado com pincéis que têm superfícies intermediárias, como DrawingBrush e VisualBrush. Ele só tem um efeito quando a CachingHint propriedade é definida como Cache.

Por padrão, o WPF não armazena em cache o conteúdo renderizado de DrawingBrush objetos e VisualBrush objetos. Em cenários estáticos, em que nem o conteúdo nem o uso do pincel na cena estão mudando, não armazenar em cache o conteúdo oferece um benefício porque conserva a memória de vídeo. Quando um pincel com conteúdo estático é usado de forma não estática, o comportamento padrão do WPF é renderizar novamente todo o conteúdo do pincel em todos os quadros, mesmo que o conteúdo esteja inalterado. Por exemplo, isso ocorrerá quando um estático DrawingBrush ou VisualBrush for mapeado para a superfície de um objeto 3D giratório. Renderizar novamente o conteúdo estático pode ter um impacto negativo no desempenho.

Ao definir a CachingHint propriedade anexada no pincel, Cachevocê pode aumentar o desempenho usando versões armazenadas em cache dos objetos de pincel em bloco.

Os CacheInvalidationThresholdMinimum valores e CacheInvalidationThresholdMaximum a propriedade são valores de tamanho relativo que determinam quando o TileBrush objeto deve ser regenerado devido a alterações na escala. Por exemplo, quando a CacheInvalidationThresholdMaximum propriedade é definida como 2.0, o cache para o qual ele TileBrush precisa ser regenerado somente quando seu tamanho excede duas vezes o tamanho do cache atual.

Para acessar essa propriedade no código, use os métodos e SetCacheInvalidationThresholdMaximum os GetCacheInvalidationThresholdMaximum métodos.

Informações da propriedade de dependência

Campo identificador CacheInvalidationThresholdMaximumProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a

Confira também