RenderOptions.SetCachingHint(DependencyObject, CachingHint) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Belirtilen bağımlılık nesnesinde CachingHint ekli özelliğin değerini ayarlar.
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
- target
- DependencyObject
Özelliğinin değerinin CachingHint ayarlanacağı bağımlılık nesnesi.
- cachingHint
- CachingHint
Özelliğin ayarlanacağı yeni değer.
Özel durumlar
Belirtilen target
değeridir null
.
Ö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.