RenderOptions.CachingHint Proprietà associata

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Media

Assembly:: PresentationCore.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta un valore che indica la necessità di memorizzare nella cache il contenuto sottoposto a rendering, quando possibile.

see GetCachingHint, and SetCachingHint

see GetCachingHint, and SetCachingHint

see GetCachingHint, and SetCachingHint

Esempio

Nell'esempio seguente viene illustrato come usare l'opzione hint di memorizzazione nella cache per un DrawingBrushoggetto .

<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>

Commenti

Questa proprietà associata è supportata da e dai TileBrush relativi tipi derivati. È destinato a essere usato con pennelli con superfici intermedie, ad esempio DrawingBrush e VisualBrush.

Per impostazione predefinita, WPF non memorizza nella cache il contenuto di DrawingBrush e VisualBrush gli oggetti di cui è stato eseguito il rendering. Negli scenari statici, in cui né il contenuto né l'uso del pennello nella scena cambiano, non la memorizzazione nella cache offre un vantaggio perché conserva la memoria video. Quando un pennello con contenuto statico viene usato in modo non statico, il comportamento predefinito di WPF consiste nel eseguire nuovamente il rendering di tutto il contenuto di ogni frame, anche se il contenuto non è modificabile. Si verificherà, ad esempio, quando viene eseguito il mapping di un oggetto 3D statico DrawingBrush o VisualBrush mappato alla superficie di un oggetto 3D ruotante. Il re-rendering del contenuto statico può avere un impatto negativo sulle prestazioni.

Impostando la proprietà associata del pennello su Cache, è possibile aumentare le CachingHint prestazioni usando le versioni memorizzate nella cache degli oggetti pennello riquadri.

I CacheInvalidationThresholdMinimum valori delle proprietà e CacheInvalidationThresholdMaximum sono valori di dimensioni relative che determinano quando l'oggetto TileBrush deve essere rigenerato a causa di modifiche nella scala. Ad esempio, quando la CacheInvalidationThresholdMaximum proprietà è impostata su 2.0, la cache deve TileBrush essere rigenerata solo quando la dimensione supera due volte la dimensione della cache corrente.

Per accedere a questa proprietà nel codice, usare i GetCachingHint metodi e SetCachingHint .

Informazioni proprietà di dipendenza


Campo Identificatore	CachingHintProperty
Proprietà dei metadati impostate su `true`	Nessuno

Si applica a

Condividi tramite