RenderOptions.SetCachingHint(DependencyObject, CachingHint) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee stelt u de waarde van de CachingHint gekoppelde eigenschap in voor een opgegeven afhankelijkheidsobject.
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)Parameters
- target
- DependencyObject
Het afhankelijkheidsobject waarop de waarde van de CachingHint eigenschap moet worden ingesteld.
- cachingHint
- CachingHint
De nieuwe waarde voor het instellen van de eigenschap op.
Uitzonderingen
De opgegeven target is null.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de optie voor het opslaan van cachehints voor een DrawingBrushgebruikt.
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)
Opmerkingen
Standaard slaat WPF de weergegeven inhoud van DrawingBrush en VisualBrush-objecten niet in de cache op. In statische scenario's, waarbij de inhoud en het gebruik van de borstel in de scène niet veranderen, biedt caching geen voordeel omdat het videogeheugen bespaart. Wanneer een borstel met statische inhoud op een niet-statische manier wordt gebruikt, is het standaardgedrag van WPF het opnieuw weergeven van alle inhoud van het borstelkader, zelfs als de inhoud niet verandert. Dit gebeurt bijvoorbeeld wanneer een statisch DrawingBrush object wordt toegewezen aan VisualBrush het oppervlak van een draaiend 3D-object. Het opnieuw weergeven van de statische inhoud kan een negatieve invloed hebben op de prestaties.
Door de CachingHint gekoppelde eigenschap van de borstel in te Cachestellen op , kunt u de prestaties verbeteren met behulp van cacheversies van de tegelborstelobjecten.
De CacheInvalidationThresholdMinimum waarden en CacheInvalidationThresholdMaximum eigenschapswaarden zijn waarden voor relatieve grootte die bepalen wanneer het TileBrush object opnieuw moet worden gegenereerd vanwege wijzigingen in de schaal. Wanneer de CacheInvalidationThresholdMaximum eigenschap bijvoorbeeld is ingesteld op 2.0, moet de cache voor de TileBrush eigenschap alleen opnieuw worden gegenereerd wanneer de grootte ervan twee keer groter is dan de grootte van de huidige cache.
Gebruik deze methode om de CachingHint gekoppelde eigenschap in code in te stellen.
