RenderOptions.CacheInvalidationThresholdMaximum 添付プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した DependencyObject のキャッシュ無効化の最大しきい値を取得または設定します。
see GetCacheInvalidationThresholdMaximum, and SetCacheInvalidationThresholdMaximumsee GetCacheInvalidationThresholdMaximum, and SetCacheInvalidationThresholdMaximumsee GetCacheInvalidationThresholdMaximum, and SetCacheInvalidationThresholdMaximum例
DrawingBrush のキャッシュ ヒント オプションの使用方法の例を次に示します。
<DrawingBrush x:Key="drawingBrush"
RenderOptions.CachingHint="Cache"
RenderOptions.CacheInvalidationThresholdMaximum="2.0"
RenderOptions.CacheInvalidationThresholdMinimum="0.5">
<DrawingBrush.Drawing>
<GeometryDrawing Brush="Blue">
<GeometryDrawing.Geometry>
<GeometryGroup>
<EllipseGeometry RadiusX="20" RadiusY="20" Center="10,10" />
</GeometryGroup>
</GeometryDrawing.Geometry>
<GeometryDrawing.Pen>
<Pen Thickness="10" Brush="Black" />
</GeometryDrawing.Pen>
</GeometryDrawing>
</DrawingBrush.Drawing>
</DrawingBrush>
注釈
この添付プロパティは、その派生型で TileBrush サポートされています。 などの中間サーフェス DrawingBrush を持つブラシで使用することを目的としています VisualBrush。 プロパティが に設定Cacheされている場合CachingHintにのみ効果があります。
既定では、WPF はレンダリングされたコンテンツとVisualBrushオブジェクトをDrawingBrushキャッシュしません。 静的なシナリオでは、コンテンツもシーン内のブラシの使用も変わっていない場合、コンテンツをキャッシュしないと、ビデオ メモリが節約されるため、利点があります。 静的コンテンツを持つブラシを非静的な方法で使用する場合、WPF の既定の動作では、コンテンツが変更されていない場合でも、フレームごとにブラシのすべてのコンテンツを再レンダリングします。 たとえば、静的 DrawingBrush な場合や VisualBrush 、回転する 3D オブジェクトのサーフェスにマップされている場合に発生します。 静的コンテンツを再レンダリングすると、パフォーマンスに悪影響を及ぼす可能性があります。
ブラシCacheの添付プロパティをCachingHint設定すると、キャッシュされたバージョンのタイル ブラシ オブジェクトを使用してパフォーマンスを向上させることができます。
CacheInvalidationThresholdMinimumプロパティ値とCacheInvalidationThresholdMaximumプロパティ値は、スケールが変更されたためにオブジェクトをTileBrush再生成するタイミングを決定する相対サイズ値です。 たとえば、プロパティが CacheInvalidationThresholdMaximum 2.0 に設定されている場合、キャッシュのサイズが現在の TileBrush キャッシュのサイズの 2 倍を超える場合にのみ、キャッシュを再生成する必要があります。
コードでこのプロパティにアクセスするには、and SetCacheInvalidationThresholdMaximum メソッドをGetCacheInvalidationThresholdMaximum使用します。
依存プロパティ情報
| 識別子フィールド | CacheInvalidationThresholdMaximumProperty |
に設定されたメタデータ プロパティ true |
なし |