RenderOptions.CachingHint 附加屬性

  • 參考

定義

命名空間:
System.Windows.Media
組件:
PresentationCore.dll

取得或設定值，此值指出如果可能應該快取呈現的內容。

see GetCachingHint, and SetCachingHint
see GetCachingHint, and SetCachingHint
see GetCachingHint, and SetCachingHint

範例

下列範例示範如何使用 的 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 。

根據預設，WPF 不會快取 和 VisualBrush 物件的轉譯內容 DrawingBrush 。 在靜態案例中，其中內容和場景中筆刷的使用都不會變更，而不是快取可提供好處，因為它會節省視訊記憶體。 以非靜態方式使用具有靜態內容的筆刷時，WPF 的預設行為是重新轉譯每一個畫面格的所有筆刷內容，即使內容未變更也一樣。 例如，當靜態 DrawingBrush 或 VisualBrush 對應至旋轉 3D 物件的表面時，就會發生這種情況。 重新轉譯靜態內容可能會對效能造成負面影響。

藉由將 CachingHint 筆刷的附加屬性設定為 Cache ，您可以使用已快取的磚筆刷物件版本來提升效能。

CacheInvalidationThresholdMinimum和 CacheInvalidationThresholdMaximum 屬性值是相對大小值，決定 TileBrush 何時應該重新產生物件，因為縮放比例變更。 例如，當 屬性設定為 2.0 時 CacheInvalidationThresholdMaximum ，只有當其大小超過目前快取的大小兩倍時， TileBrush 才需要重新產生 的快取。

若要在程式碼中存取此屬性，請使用 GetCachingHint 和 SetCachingHint 方法。

相依性屬性資訊
識別碼欄位 CachingHintProperty
設定為 的中繼資料屬性 true 無

適用於

另請參閱