RenderOptions.SetCachingHint(DependencyObject, CachingHint) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengatur nilai CachingHint properti terlampir pada objek dependensi tertentu.
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)Parameter
- target
- DependencyObject
Objek dependensi untuk mengatur nilai CachingHint properti.
- cachingHint
- CachingHint
Nilai baru untuk mengatur properti ke.
Pengecualian
Yang ditentukan target adalah null.
Contoh
Contoh berikut menunjukkan cara menggunakan opsi petunjuk penembolokan untuk 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)
Keterangan
Secara default, WPF tidak menyimpan cache konten DrawingBrush dan VisualBrush objek yang dirender. Dalam skenario statis, di mana konten maupun penggunaan kuas dalam adegan berubah, bukan penembolokan memberikan manfaat karena menghemat memori video. Ketika kuas dengan konten statis digunakan dengan cara yang tidak statis, perilaku default WPF adalah merender ulang semua konten kuas setiap bingkai, meskipun kontennya tidak berubah. Misalnya, ini akan terjadi ketika statis DrawingBrush atau VisualBrush dipetakan ke permukaan objek 3D yang berputar. Merender ulang konten statis dapat berdampak negatif pada performa.
Dengan mengatur CachingHint properti terlampir dari kuas ke Cache, Anda dapat meningkatkan performa dengan menggunakan versi cache objek sikat keramik.
Nilai CacheInvalidationThresholdMinimum properti dan CacheInvalidationThresholdMaximum adalah nilai ukuran relatif yang menentukan kapan TileBrush objek harus diregenerasi karena perubahan skala. Misalnya, ketika CacheInvalidationThresholdMaximum properti diatur ke 2.0, cache untuk TileBrush kebutuhan yang perlu diregenerasi hanya ketika ukurannya melebihi dua kali ukuran cache saat ini.
Gunakan metode ini untuk mengatur CachingHint properti terlampir dalam kode.
