Sdílet prostřednictvím

RenderOptions.SetCachingHint(DependencyObject, CachingHint) Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Media
Sestavení:
PresentationCore.dll

Nastaví hodnotu CachingHint připojené vlastnosti u zadaného objektu závislosti.

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)

Parametry

target
DependencyObject

Objekt závislosti, na kterém chcete nastavit hodnotu CachingHint vlastnosti.

cachingHint
CachingHint

Nová hodnota pro nastavení vlastnosti.

Výjimky

ArgumentNullException

target Zadané je null.

Příklady

Následující příklad ukazuje, jak použít možnost nápovědy pro ukládání do mezipaměti pro 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)

Poznámky

WpF ve výchozím nastavení neukládá vykreslený obsah DrawingBrush a VisualBrush objekty do mezipaměti. Ve statických scénářích, kdy se obsah ani použití štětce ve scéně nemění, neposkytuje ukládání do mezipaměti výhodu, protože šetří paměť videa. Pokud je štětec se statickým obsahem používán nestatický způsobem, je výchozím chováním WPF znovu vykreslit veškerý obsah štětce při každém rámečku, i když se obsah nemění. K tomu dojde například v případě, že je statická DrawingBrush nebo VisualBrush mapovaná na povrch otočného 3D objektu. Opětovné vykreslení statického obsahu může mít negativní dopad na výkon.

CachingHint Nastavením připojené vlastnosti štětce Cachemůžete zvýšit výkon pomocí verzí uložených v mezipaměti dlaždicových objektů štětce.

Hodnoty CacheInvalidationThresholdMinimum vlastností CacheInvalidationThresholdMaximum jsou hodnoty relativní velikosti, které určují, kdy se TileBrush má objekt znovu vygenerovat kvůli změnám ve velkém měřítku. Pokud je například CacheInvalidationThresholdMaximum vlastnost nastavena na hodnotu 2.0, musí se mezipaměť znovu TileBrush vygenerovat pouze v případě, že jeho velikost překročí dvakrát velikost aktuální mezipaměti.

Tuto metodu CachingHint použijte k nastavení připojené vlastnosti v kódu.

Platí pro

Viz také