RenderOptions.CacheInvalidationThresholdMinimum 添付プロパティ

  • リファレンス

定義

名前空間:
System.Windows.Media
アセンブリ:
PresentationCore.dll

指定した DependencyObject のキャッシュ無効化の最小しきい値を取得または設定します。

see GetCacheInvalidationThresholdMinimum, and SetCacheInvalidationThresholdMinimum
see GetCacheInvalidationThresholdMinimum, and SetCacheInvalidationThresholdMinimum
see GetCacheInvalidationThresholdMinimum, and SetCacheInvalidationThresholdMinimum

例

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 サポートされています。 これは、 や VisualBrushなどのDrawingBrush中間サーフェスを持つブラシで使用することを目的としています。 プロパティが に設定されている場合 CachingHint にのみ効果があります Cache。

既定では、WPF は および オブジェクトのレンダリングされた内容をDrawingBrushVisualBrushキャッシュしません。 コンテンツもシーン内のブラシの使用も変化しない静的なシナリオでは、コンテンツをキャッシュしないと、ビデオ メモリが節約されるため、利点があります。 静的コンテンツを持つブラシが非静的な方法で使用される場合、WPF の既定の動作は、コンテンツが変更されていない場合でも、フレームごとにブラシのすべてのコンテンツを再レンダリングすることです。 たとえば、これは、静的 DrawingBrush または VisualBrush 回転する 3D オブジェクトのサーフェスにマップされている場合に発生します。 静的コンテンツを再レンダリングすると、パフォーマンスに悪影響を及ぼす可能性があります。

ブラシの添付プロパティを CachingHint に Cache設定すると、キャッシュされたバージョンのタイル ブラシ オブジェクトを使用してパフォーマンスを向上させることができます。

CacheInvalidationThresholdMinimumおよび CacheInvalidationThresholdMaximum プロパティの値は、スケールの変化のためにオブジェクトをTileBrushいつ再生成するかを決定する相対サイズの値です。 たとえば、 プロパティが CacheInvalidationThresholdMinimum 0.5 に設定されている場合、 のキャッシュは、そのサイズが現在のキャッシュ TileBrush のサイズの 2 分の 1 未満に縮小された場合にのみ再生成する必要があります。

コードでこのプロパティにアクセスするには、 メソッドと SetCacheInvalidationThresholdMinimum メソッドをGetCacheInvalidationThresholdMinimum使用します。

依存プロパティ情報
識別子フィールド CacheInvalidationThresholdMinimumProperty
に設定されたメタデータ プロパティ true なし

適用対象

こちらもご覧ください