CachingHint Wyliczenie

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Media
Zestaw:
PresentationCore.dll

Określa, czy buforować obiekty pędzla kafelków.

public enum class CachingHint
public enum CachingHint
type CachingHint = 
Public Enum CachingHint
Dziedziczenie
Object
ValueType
Enum
CachingHint

Pola

Cache 1

Buforuj obiekty pędzla kafelków w buforze poza ekranem przy użyciu wskazówek buforowania określonych przez RenderOptions ustawienia.
Unspecified 0

Nie określono wskazówek dotyczących buforowania.

Przykłady

W poniższym przykładzie pokazano, jak użyć opcji wskazówek buforowania dla elementu 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)

Uwagi

Domyślnie WPF nie buforuje renderowanej zawartości DrawingBrush obiektów i VisualBrush . W scenariuszach statycznych, w których nie zmienia się ani zawartość, ani użycie pędzla w scenie, nie buforowanie zapewnia korzyść, ponieważ oszczędza pamięć wideo. Gdy szczotka z zawartością statyczną jest używana w sposób niestatyczny, domyślnym zachowaniem platformy WPF jest ponowne renderowanie całej zawartości pędzla dla każdej ramki, mimo że zawartość jest niezmienna. Na przykład dzieje się tak, gdy statyczny DrawingBrush lub VisualBrush jest mapowany na powierzchnię obracającego się obiektu 3D. Ponowne renderowanie zawartości statycznej może mieć negatywny wpływ na wydajność.

Ustawiając dołączoną CachingHint właściwość na pędzlu na pamięć podręczną, można zwiększyć wydajność przy użyciu buforowanych wersji obiektów pędzla kafelków.

Wartości CacheInvalidationThresholdMinimum właściwości i CacheInvalidationThresholdMaximum są względnymi wartościami rozmiaru, które określają, kiedy TileBrush obiekt powinien być ponownie wygenerowany z powodu zmian skali. Na przykład przez ustawienie CacheInvalidationThresholdMaximum właściwości na 2.0 pamięć podręczna tylko TileBrush musi zostać ponownie wygenerowana, gdy jej rozmiar przekracza dwa razy większy rozmiar bieżącej pamięci podręcznej.

Dotyczy

Zobacz też