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 -> unitPublic 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ğinin 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şlenen içeriklerini DrawingBrush önbelleğe almaz. Sahnedeki fırçanın içeriğinin veya kullanımının değişmediği statik senaryolarda, önbelleğe alma özelliği video belleğinden tasarruf sağladığı için bir avantaj sağlamaz. 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, bu durum bir statik DrawingBrush olduğunda veya VisualBrush dönen bir 3B nesnenin yüzeyine eşlendiğinde gerçekleşir. Statik içeriğin yeniden işlenmesi performansı olumsuz etkileyebilir.
Fırçanın CachingHint ekli özelliğini olarak Cacheayarlayarak, kutucuklu 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 özelliği 2.0 olarak ayarlandığında, önbelleğin yalnızca boyutu geçerli önbelleğin TileBrush boyutunun iki katını aştığında yeniden oluşturulmalıdır.
Kodda CachingHint ekli özelliği ayarlamak için bu yöntemi kullanın.
