BitmapCache Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vytvoří a ukládá rastrový obrázek reprezentace UIElement.
public ref class BitmapCache sealed : System::Windows::Media::CacheModepublic sealed class BitmapCache : System.Windows.Media.CacheModetype BitmapCache = class
inherit CacheModePublic NotInheritable Class BitmapCache
Inherits CacheMode- Dědičnost
Příklady
Následující XAML ukazuje, jak uložit prvek do mezipaměti Canvas . Kompletní příklad kódu naleznete v tématu Postupy: Zlepšení výkonu vykreslování ukládáním elementu do mezipaměti.
<!-- //////////////////////////////////////////////////////////////// -->
<!-- // The following XAML creates a BitmapCache with default // -->
<!-- // properties and assigns it as the CacheMode for the canvas. // -->
<!-- //////////////////////////////////////////////////////////////// -->
<Canvas.CacheMode>
<BitmapCache EnableClearType="False"
RenderAtScale="1"
SnapsToDevicePixels="False" />
</Canvas.CacheMode>
Poznámky
BitmapCache Pomocí třídy můžete zlepšit výkon vykreslování komplexního objektu UIElement. BitmapCache Vytvořte a přiřaďte ho UIElement vlastnosti CacheMode k uložení prvku do mezipaměti a jeho podstromu jako rastrový obrázek v paměti videa. To je užitečné, když potřebujete animovat, přeložit nebo škálovat UIElement co nejrychleji. Tento přístup umožňuje kompromis mezi výkonem a kvalitou vizuálu při ukládání obsahu do mezipaměti.
BitmapCacheBrush Použijte třídu k efektivnímu opětovnému použití elementu uloženého v mezipaměti.
RenderAtScale Nastavte vlastnost pro škálování rastrové mezipaměti. To je užitečné, pokud se prvek přiblíží a chcete, aby se prvek vykresloval jasněji, než kdyby byla mezipaměť jednoduše vygenerována v nativním rozlišení elementu.
SnapsToDevicePixels Nastavte vlastnost, když mezipaměť zobrazí obsah, který vyžaduje zarovnání pixelů, aby se vykreslovat správně, například text ClearType. Tato vlastnost je ignorována třídami BitmapCacheBrush a Viewport2DVisual3D třídami.
Ukládání ovládacího prvku do mezipaměti nemá vliv na chování při najetí myší, takže testování pomocí myši funguje, jako by rastrový obrázek byl živý ovládací prvek.
K regeneraci mezipaměti dochází pouze v případě, že se změní struktura UIElement podstromu nebo když se CacheMode změní nastavení. RenderAtScale Nastavení nebo EnableClearType vlastností způsobí regeneraci mezipaměti. Změny nadřazeného vizuálního stromu v mezipaměti UIElement, jako jsou transformace, škálování, opacities a efekty, nemají vliv na mezipaměť.
Funkce mezipaměti, pokud hardwarová akcelerace není k dispozici. V tomto případě se rastrový obrázek vykreslí v softwaru a maximální rozměry rastrových obrázků jsou 2048 x 2048.
Poznámka:
RenderOptions a TextOptions nerozšírujte se prostřednictvím elementu uloženého v mezipaměti. Je možné, že tyto možnosti budete muset znovu nastavit v podřízených prvkách pod mezipamětí.
Konstruktory
| Name | Description |
|---|---|
| BitmapCache() |
Inicializuje novou instanci BitmapCache třídy. |
| BitmapCache(Double) |
Inicializuje novou instanci BitmapCache třídy se zadaným škálováním. |
Pole
| Name | Description |
|---|---|
| EnableClearTypeProperty |
Identifikuje EnableClearType vlastnost závislosti. |
| RenderAtScaleProperty |
Identifikuje RenderAtScale vlastnost závislosti. |
| SnapsToDevicePixelsProperty |
Identifikuje SnapsToDevicePixels vlastnost závislosti. |
Vlastnosti
| Name | Description |
|---|---|
| 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) |
| EnableClearType |
Získá nebo nastaví hodnotu, která určuje, zda rastrový obrázek je vykreslen pomocí ClearType aktivovaný. |
| 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) |
| RenderAtScale |
Získá nebo nastaví hodnotu, která označuje měřítko použité na rastrový obrázek. |
| SnapsToDevicePixels |
Získá nebo nastaví hodnotu, která určuje, zda je rastrový obrázek vykreslen pomocí přichycení pixelů. |
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 BitmapCache, 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 BitmapCache 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 |
| 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) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| 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) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| 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ězec, který představuje aktuální objekt. (Zděděno od Object) |
| 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) |
