RenderOptions.SetCachingHint(DependencyObject, CachingHint) Yöntem

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)

Parametreler

Özel durumlar

Örnekler

Aşağıdaki örnekte, bir için önbelleğe alma ipucu seçeneğinin nasıl kullanılacağı gösterilmektedir 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)

Açıklamalar

Varsayılan olarak WPF, ve VisualBrush nesnelerinin işlenmiş içeriğini DrawingBrush önbelleğe almaz. Sahnedeki fırçanın ne içeriğinin ne de kullanımının değişmediği statik senaryolarda, önbelleğe alma özelliği video belleğinden tasarruf ettiğinden bir avantaj sağlar. Statik içerik içeren bir fırça statik olmayan bir şekilde kullanıldığında, WPF'nin varsayılan davranışı, içerik değişmese bile fırçanın tüm içeriğini her çerçevede yeniden işlemektir. Örneğin, bir statik DrawingBrush veya VisualBrush dönen bir 3B nesnenin yüzeyine eşlendiğinde bu durum ortaya çıkacaktır. Statik içeriğin yeniden işlenmesi performansı olumsuz etkileyebilir.

Fırçanın CachingHint ekli özelliğini olarak Cacheayarlayarak, döşemeli fırça nesnelerinin önbelleğe alınmış sürümlerini kullanarak performansı artırabilirsiniz.

CacheInvalidationThresholdMinimum ve CacheInvalidationThresholdMaximum özellik değerleri, ölçekteki değişiklikler nedeniyle nesnenin TileBrush ne zaman yeniden oluşturulacaklarını belirleyen göreli boyut değerleridir. Örneğin, CacheInvalidationThresholdMaximum özellik 2.0 olarak ayarlandığında, yalnızca boyutu geçerli önbelleğin boyutunun TileBrush iki katını aştığında önbelleğin yeniden üretilmesi gerekir.

Kodda CachingHint ekli özelliği ayarlamak için bu yöntemi kullanın.

Şunlara uygulanır

Ayrıca bkz.

• SetCacheInvalidationThresholdMaximum(DependencyObject, Double)
• SetCacheInvalidationThresholdMinimum(DependencyObject, Double)