RenderOptions.SetCachingHint(DependencyObject, CachingHint) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 -> unitPublic 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
Zadaná target hodnota 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 se štětec se statickým obsahem používá nestatický způsob, je výchozím chováním WPF znovu vykreslit veškerý obsah štětce v 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 rotující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ětců.
Hodnoty CacheInvalidationThresholdMinimum vlastností CacheInvalidationThresholdMaximum jsou relativní velikosti, které určují, kdy TileBrush se 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í být mezipaměť pro TileBrush tuto mezipaměť znovu vygenerována 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.
