CachingHint Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt an, ob gekachelte Pinselobjekte zwischengespeichert werden sollen.
public enum class CachingHint
public enum CachingHint
type CachingHint =
Public Enum CachingHint
- Vererbung
Felder
Cache | 1 | Führt eine Zwischenspeicherung der gekachelten Pinselobjekte unter Verwendung der von den RenderOptions-Einstellungen angegebenen Zwischenspeicherungshinweise in einem Offscreenpuffer aus. |
Unspecified | 0 | Es werden keine Zwischenspeicherungshinweise angegeben. |
Beispiele
Das folgende Beispiel zeigt, wie Sie die Zwischenspeicherungshinweisoption für eine 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)
Hinweise
Standardmäßig speichert WPF den gerenderten Inhalt und DrawingBrush VisualBrush die gerenderten Objekte nicht zwischen. In statischen Szenarien, in denen weder der Inhalt noch die Verwendung des Pinsels in der Szene geändert wird, bietet keine Zwischenspeicherung einen Vorteil, da sie den Videospeicher spart. Wenn ein Pinsel mit statischem Inhalt auf nicht statische Weise verwendet wird, besteht das Standardverhalten von WPF darin, den gesamten Inhalt des Pinsels erneut zu rendern, auch wenn der Inhalt nicht geändert wird. Dies geschieht beispielsweise, wenn eine statische DrawingBrush VisualBrush oder der Oberfläche eines drehenden 3D-Objekts zugeordnet ist. Das Erneute Rendern des statischen Inhalts kann negative Auswirkungen auf die Leistung haben.
Durch Festlegen der angefügten Eigenschaft auf dem Pinsel auf Cache können Sie die CachingHint Leistung erhöhen, indem Sie zwischengespeicherte Versionen der gekachelten Pinselobjekte verwenden.
Die CacheInvalidationThresholdMinimum Werte der CacheInvalidationThresholdMaximum Eigenschaft sind relative Größenwerte, die bestimmen, wann das TileBrush Objekt aufgrund von Änderungen im Maßstab neu generiert werden soll. Wenn Sie beispielsweise die CacheInvalidationThresholdMaximum Eigenschaft auf 2.0 festlegen, muss der Cache nur TileBrush dann neu generiert werden, wenn seine Größe zweimal die Größe des aktuellen Caches überschreitet.