BitmapCacheBrush Třída

Definice

Obor názvů:

System.Windows.Media

Sestavení:

PresentationCore.dll

Nakreslí oblast obsahem uloženým v mezipaměti.

public ref class BitmapCacheBrush sealed : System::Windows::Media::Brush

public sealed class BitmapCacheBrush : System.Windows.Media.Brush

type BitmapCacheBrush = class
    inherit Brush

Public NotInheritable Class BitmapCacheBrush
Inherits Brush

Dědičnost

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Brush

BitmapCacheBrush

Příklady

Následující příklad kódu ukazuje, jak přidružit k BitmapCache .BitmapCacheBrush Prostředek můžete použít BitmapCacheBrush u více prvků a dosáhnout dobrého výkonu. Úplný výpis kódu najdete v tématu Postupy: Použití elementu cached jako štětce.

<Window.Resources>
    <RichTextBox x:Key="cachedRichTextBox"  >
        <RichTextBox.CacheMode>
            <BitmapCache EnableClearType="True" RenderAtScale="1" SnapsToDevicePixels="True" />
        </RichTextBox.CacheMode>
    </RichTextBox>

    <BitmapCacheBrush x:Key="cachedRichTextBoxBrush" Target="{StaticResource cachedRichTextBox}">
        <BitmapCacheBrush.BitmapCache>
            <BitmapCache EnableClearType="False" RenderAtScale="0.4" SnapsToDevicePixels="False" />
        </BitmapCacheBrush.BitmapCache>
    </BitmapCacheBrush>        
</Window.Resources>

Poznámky

BitmapCacheBrush Použijte třídu k efektivnímu opětovnému použití prvku v mezipaměti. To je užitečné, když potřebujete nakreslit složitý obsah na více prvků. BitmapCache Třída slouží k ukládání komplexního elementu do mezipaměti.

Visual Přiřaďte vlastnost a Target volitelně mu přiřaďte BitmapCacheBitmapCache vlastnost. CacheMode Štětec a cíl Visual pracují s různými chováními. Tato interakce je popsána v následující tabulce.

Štětec má CacheMode	Cíl nemá žádný cacheMode	Cíl má CacheMode
Ne	Cílový vizuál se vykresluje normálně; štětec používá výchozí chování mezipaměti.	Cílový vizuál se vykreslí do vlastní mezipaměti; při vykreslování používá mezipaměť cíle.
Ano	Cílový vizuál se vykresluje normálně; štětec vykreslí cíl do vlastní mezipaměti a použije ho k vykreslení.	Cílový vizuál se vykreslí do vlastní mezipaměti; štětec vykreslí cíl do vlastní mezipaměti štětce a použije ho k vykreslení.

Třída BitmapCacheBrush je podobná VisualBrush třídě, ale BitmapCacheBrush vždy se vykreslí z mezipaměti na cílovém prvku nebo z mezipaměti definované BitmapCache vlastností. Třída BitmapCacheBrush také podporuje špinavé oblasti.

Následující tabulka ukazuje výchozí nastavení mezipaměti rastrového obrázku BitmapCacheBrush pro třídu.

Bitmap Cache – vlastnost	Výchozí nastavení
SnapsToDevicePixels	false
EnableClearType	false
RenderAtScale	1

Vlastnost SnapsToDevicePixels je ignorována BitmapCacheBrush třídou.

Třída BitmapCacheBrush ignoruje následující vlastnosti v kořenovém adresáři Visual. Toto chování se liší od VisualBrush třídy.

• VisualOffset

• VisualTransform

• VisualClip

• VisualEffect

• VisualOpacity

• VisualOpacityMask

Konstruktory

Name	Description
BitmapCacheBrush()	Inicializuje novou instanci BitmapCacheBrush třídy.
BitmapCacheBrush(Visual)	Inicializuje novou instanci BitmapCacheBrush třídy se zadaným Visual.

Pole

Name	Description
AutoLayoutContentProperty	Identifikuje AutoLayoutContent vlastnost závislosti.
BitmapCacheProperty	Identifikuje BitmapCache vlastnost závislosti.
TargetProperty	Identifikuje Target vlastnost závislosti.

Vlastnosti

Name	Description
AutoLayoutContent	Získá nebo nastaví hodnotu, která určuje, zda je rozložení použito na obsah tohoto štětce.
BitmapCache	Získá nebo nastaví CacheMode , který představuje obsah uložený v mezipaměti.
CanFreeze	Získá hodnotu, která označuje, zda objekt lze vytvořit nemodifovatelný. (Zděděno od Freezable)
DependencyObjectType	DependencyObjectType Získá ten, který zabalí typ CLR této instance. (Zděděno od DependencyObject)
Dispatcher	Dispatcher Získá toto DispatcherObject je přidružené. (Zděděno od DispatcherObject)
HasAnimatedProperties	Získá hodnotu, která určuje, zda jeden nebo více AnimationClock objektů je přidružen k některé z vlastností závislosti tohoto objektu. (Zděděno od Animatable)
IsFrozen	Získá hodnotu, která označuje, zda objekt je aktuálně upravitelný. (Zděděno od Freezable)
IsSealed	Získá hodnotu, která označuje, zda je tato instance aktuálně zapečetěna (jen pro čtení). (Zděděno od DependencyObject)
Opacity	Získá nebo nastaví stupeň neprůhlednosti Brush. (Zděděno od Brush)
RelativeTransform	Získá nebo nastaví transformaci, která se použije na štětec pomocí relativních souřadnic. (Zděděno od Brush)
Target	Získá nebo nastaví cílový vizuál do mezipaměti.
Transform	Získá nebo nastaví transformaci, která je použita na štětec. Tato transformace se použije po namapovaném a umístěném výstupu štětce. (Zděděno od Brush)

Metody

Name	Description
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Použije pro AnimationClock zadaný DependencyPropertyparametr . Pokud je vlastnost již animovaná, použije se zadané HandoffBehavior . (Zděděno od Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Použije pro AnimationClock zadaný DependencyPropertyparametr . Pokud je vlastnost již animované, použije se SnapshotAndReplace chování předání. (Zděděno od Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Použije animaci na zadanou DependencyPropertypoložku . Animace se spustí při vykreslení dalšího snímku. Pokud je zadaná vlastnost již animované, použije se zadaná HandoffBehavior vlastnost. (Zděděno od Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Použije animaci na zadanou DependencyPropertypoložku . Animace se spustí při vykreslení dalšího snímku. Pokud je zadaná vlastnost již animované, použije se SnapshotAndReplace chování předání. (Zděděno od Animatable)
CheckAccess()	Určuje, zda volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
ClearValue(DependencyProperty)	Vymaže místní hodnotu vlastnosti. Vlastnost, která se má vymazat, je určena identifikátorem DependencyProperty . (Zděděno od DependencyObject)
ClearValue(DependencyPropertyKey)	Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která má být vymazána, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject)
Clone()	Vytvoří upravitelný klon objektu BitmapCacheBrush, vytváření hlubokých kopií hodnot objektu. Při kopírování vlastností závislostí objektu tato metoda kopíruje výrazy (které se už nemusí překládat), ale ne animace nebo jejich aktuální hodnoty.
CloneCore(Freezable)	Vytvoří instanci klonem (hloubkovou kopií) zadaného Freezable pomocí základních (ne animovaných) hodnot vlastností. (Zděděno od Freezable)
CloneCurrentValue()	Vytvoří upravitelný klon (hloubkovou BitmapCacheBrush kopii) pomocí aktuálních hodnot.
CloneCurrentValueCore(Freezable)	Vytvoří instanci upravitelný klon (hloubkovou kopii) zadaného Freezable pomocí aktuálních hodnot vlastností. (Zděděno od Freezable)
CoerceValue(DependencyProperty)	Převede hodnotu zadané vlastnosti závislosti. Toho se dosahuje vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastností pro vlastnost závislosti, protože existuje ve volání DependencyObject. (Zděděno od DependencyObject)
CreateInstance()	Inicializuje novou instanci Freezable třídy. (Zděděno od Freezable)
CreateInstanceCore()	Při implementaci v odvozené třídě vytvoří novou instanci odvozené Freezable třídy. (Zděděno od Freezable)
Equals(Object)	Určuje, zda je poskytnutá DependencyObject hodnota ekvivalentní aktuálnímu DependencyObject. (Zděděno od DependencyObject)
Freeze()	Nastaví aktuální objekt jako nemodifikovatelný a nastaví jeho IsFrozen vlastnost na true. (Zděděno od Freezable)
FreezeCore(Boolean)	Znepřístupňuje tento Animatable objekt nebo určuje, zda jej lze upravit. (Zděděno od Animatable)
GetAnimationBaseValue(DependencyProperty)	Vrátí ne animovanou hodnotu zadané DependencyPropertyhodnoty . (Zděděno od Animatable)
GetAsFrozen()	Vytvoří zablokovanou kopii Freezablevlastnosti , pomocí základních (ne animovaných) hodnot vlastností. Vzhledem k tomu, že je kopie zablokovaná, všechny ukotvené dílčí objekty se zkopírují odkazem. (Zděděno od Freezable)
GetAsFrozenCore(Freezable)	Vytvoří instanci ukotveným klonem zadaného Freezable pomocí základních (ne animovaných) hodnot vlastností. (Zděděno od Freezable)
GetCurrentValueAsFrozen()	Vytvoří ukotvenou kopii s použitím aktuálních Freezable hodnot vlastností. Vzhledem k tomu, že je kopie zablokovaná, všechny ukotvené dílčí objekty se zkopírují odkazem. (Zděděno od Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Vytvoří aktuální instanci zmrazený klon zadaného Freezable. Pokud má objekt animované vlastnosti závislostí, jejich aktuální animované hodnoty se zkopírují. (Zděděno od Freezable)
GetHashCode()	Získá hash kód pro tento DependencyObject. (Zděděno od DependencyObject)
GetLocalValueEnumerator()	Vytvoří specializovaný enumerátor pro určení, které vlastnosti závislosti mají místně nastavené hodnoty na tomto DependencyObject. (Zděděno od DependencyObject)
GetValue(DependencyProperty)	Vrátí aktuální efektivní hodnotu vlastnosti závislosti na této instanci objektu DependencyObject. (Zděděno od DependencyObject)
InvalidateProperty(DependencyProperty)	Znovu vyhodnotí efektivní hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
OnChanged()	Volá se při změně aktuálního Freezable objektu. (Zděděno od Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Tento člen podporuje infrastrukturu Windows Presentation Foundation (WPF) a není určená k použití přímo z vašeho kódu. (Zděděno od Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Zajišťuje, aby byly pro datový člen, který byl právě nastaven, vytvořeny DependencyObjectType příslušné kontextové ukazatele. (Zděděno od Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Přepíše implementaci DependencyObjectOnPropertyChanged(DependencyPropertyChangedEventArgs) také vyvolat všechny Changed obslužné rutiny v reakci na měnící se závislost vlastnost typu Freezable. (Zděděno od Freezable)
ReadLocalValue(DependencyProperty)	Vrátí místní hodnotu vlastnosti závislosti, pokud existuje. (Zděděno od DependencyObject)
ReadPreamble()	Zajišťuje, že se k němu Freezable přistupuje z platného vlákna. Dědiče Freezable této metody musí volat tuto metodu na začátku jakéhokoli rozhraní API, které čte datové členy, které nejsou vlastnostmi závislosti. (Zděděno od Freezable)
SetCurrentValue(DependencyProperty, Object)	Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnot. (Zděděno od DependencyObject)
SetValue(DependencyProperty, Object)	Nastaví místní hodnotu vlastnosti závislosti určenou jeho identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
SetValue(DependencyPropertyKey, Object)	Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou identifikátorem DependencyPropertyKey vlastnosti závislosti. (Zděděno od DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Vrátí hodnotu, která určuje, zda procesy serializace mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
ToString()	Vrátí řetězcovou reprezentaci tohoto Brushvýrazu . (Zděděno od Brush)
ToString(IFormatProvider)	Vytvoří řetězcovou reprezentaci tohoto objektu na základě zadaných informací o formátování specifické pro jazykovou verzi. (Zděděno od Brush)
VerifyAccess()	Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
WritePostscript()	Changed Vyvolá událost pro událost Freezable a vyvolá její OnChanged() metodu. Třídy odvozené z Freezable by měly volat tuto metodu na konci jakéhokoli rozhraní API, které upravuje členy třídy, které nejsou uloženy jako vlastnosti závislosti. (Zděděno od Freezable)
WritePreamble()	Ověřuje, že Freezable není zablokovaný a že k němu přistupujete z platného kontextu podprocesu. Freezable dědiče by měly tuto metodu volat na začátku jakéhokoli rozhraní API, které zapisuje do datových členů, které nejsou vlastnostmi závislosti. (Zděděno od Freezable)

Událost

Name	Description
Changed	Nastane, když Freezable je objekt, který obsahuje, změněn. (Zděděno od Freezable)

Explicitní implementace rozhraní

Name	Description
IFormattable.ToString(String, IFormatProvider)	Naformátuje hodnotu aktuální instance pomocí zadaného formátu. (Zděděno od Brush)

Viz také

• BitmapCache
• Visual