CachedBitmap Třída

Definice

Obor názvů:

System.Windows.Media.Imaging

Sestavení:

PresentationCore.dll

Poskytuje funkci ukládání do mezipaměti pro .BitmapSource

public ref class CachedBitmap sealed : System::Windows::Media::Imaging::BitmapSource

public sealed class CachedBitmap : System.Windows.Media.Imaging.BitmapSource

type CachedBitmap = class
    inherit BitmapSource

Public NotInheritable Class CachedBitmap
Inherits BitmapSource

Dědičnost

Object

DispatcherObject

DependencyObject

Freezable

Animatable

ImageSource

BitmapSource

CachedBitmap

Příklady

Následující příklad kódu ukazuje, jak vytvořit a použít v CachedBitmap kódu.

CachedBitmap cachedSource = new CachedBitmap(
    scaledSource, 
    BitmapCreateOptions.None,
    BitmapCacheOption.OnLoad);


// Create a new BitmapSource using a different format than the original one.
FormatConvertedBitmap newFormatSource = new FormatConvertedBitmap();
newFormatSource.BeginInit();
newFormatSource.Source = cachedSource;
newFormatSource.DestinationFormat = PixelFormats.Gray32Float;
newFormatSource.EndInit();

Dim cachedSource As New CachedBitmap(scaledSource, BitmapCreateOptions.None, BitmapCacheOption.OnLoad)
' Create a new BitmapSource using a different format than the original one.
Dim newFormatSource As New FormatConvertedBitmap()
newFormatSource.BeginInit()
newFormatSource.Source = cachedSource
newFormatSource.DestinationFormat = PixelFormats.Gray32Float
newFormatSource.EndInit()

Poznámky

Objekt BitmapSource neukládá rastrová data do mezipaměti automaticky. Použití objektu CachedBitmap může zlepšit výkon ve scénářích, kdy je potřeba provést více operací (například oříznutí obrázku nebo změnu velikosti) na jednom rastrovém obrázku.

Konstruktory

CachedBitmap(BitmapSource, BitmapCreateOptions, BitmapCacheOption)

Inicializuje novou instanci objektu CachedBitmap , který má zadaný zdroj, možnosti vytvoření rastrového obrázku a možnost mezipaměti rastrových obrázků.

Vlastnosti

CanFreeze	Získá hodnotu, která označuje, zda objekt lze změnit. (Zděděno od Freezable)
DependencyObjectType	DependencyObjectType Získá, který zabalí typ CLR této instance. (Zděděno od DependencyObject)
Dispatcher	Získá to DispatcherDispatcherObject je přidružena k. (Zděděno od DispatcherObject)
DpiX	Získá vodorovné tečky na palec (dpi) obrázku. (Zděděno od BitmapSource)
DpiY	Získá svislé tečky na palec (dpi) obrázku. (Zděděno od BitmapSource)
Format	Získá nativní PixelFormat rastrová data. (Zděděno od BitmapSource)
HasAnimatedProperties	Získá hodnotu, která označuje, zda jeden nebo více AnimationClock objektů je přidružena k některé z vlastností závislostí tohoto objektu. (Zděděno od Animatable)
Height	Získá výšku zdrojového rastrového obrázku v jednotkách nezávislých na zařízení (1/96 palce na jednotku). (Zděděno od BitmapSource)
IsDownloading	Získá hodnotu, která označuje, zda BitmapSource se obsah právě stahuje. (Zděděno od BitmapSource)
IsFrozen	Získá hodnotu, která označuje, zda objekt je aktuálně modifikovatelný. (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)
Metadata	Získá metadata, která je přidružena k tomuto rastrovém obrázku. (Zděděno od BitmapSource)
Palette	Získá paletu barev rastrového obrázku, pokud je zadán. (Zděděno od BitmapSource)
PixelHeight	Získá výšku rastrového obrázku v pixelech. (Zděděno od BitmapSource)
PixelWidth	Získá šířku rastrového obrázku v pixelech. (Zděděno od BitmapSource)
Width	Získá šířku rastrového obrázku v jednotkách nezávislých na zařízení (1/96 inch na jednotku). (Zděděno od BitmapSource)

Metody

ApplyAnimationClock(DependencyProperty, AnimationClock)	Použije na AnimationClock zadaný DependencyPropertyobjekt . Pokud je vlastnost již animovaná, SnapshotAndReplace použije se chování předání. (Zděděno od Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Použije na AnimationClock zadaný DependencyPropertyobjekt . Pokud je vlastnost již animovaná, použije se zadaná HandoffBehavior vlastnost. (Zděděno od Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Použije animaci na zadaný DependencyPropertyobjekt . Animace se spustí při vykreslení dalšího snímku. Pokud je zadaná vlastnost již animované, SnapshotAndReplace použije se chování předání. (Zděděno od Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Použije animaci na zadaný DependencyPropertyobjekt . 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)
CheckAccess()	Určuje, zda volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
CheckIfSiteOfOrigin()	Zkontroluje, jestli zdroj rastrového obrázku pochází ze známého webu původu. Tato metoda se používá k zajištění bezpečnosti operací kopírování pixelů. (Zděděno od BitmapSource)
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á se má vymazat, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject)
Clone()	Vytvoří upravitelný klon tohoto CachedBitmapobjektu a vytváří hluboké kopie hodnot tohoto objektu. Při kopírování vlastností závislostí tato metoda kopíruje odkazy na prostředky a datové vazby (ale nemusí se už překládat), ale ne animace nebo jejich aktuální hodnoty.
CloneCore(Freezable)	Vytvoří tuto instanci jako hlubokou kopii zadaného BitmapSourceobjektu . Při kopírování vlastností závislostí tato metoda kopíruje odkazy na prostředky a datové vazby (ale nemusí se už překládat), ale ne animace nebo jejich aktuální hodnoty. (Zděděno od BitmapSource)
CloneCurrentValue()	Vytvoří upravitelný klon tohoto CachedBitmap objektu a vytváří hluboké kopie aktuálních hodnot tohoto objektu. Odkazy na prostředky, datové vazby a animace se nekopírují, ale jejich aktuální hodnoty jsou.
CloneCurrentValueCore(Freezable)	Vytvoří tuto instanci jako upravitelnou hloubkovou kopii zadaného BitmapSource pomocí aktuálních hodnot vlastností. Odkazy na prostředky, datové vazby a animace se nekopírují, ale jejich aktuální hodnoty jsou. (Zděděno od BitmapSource)
CoerceValue(DependencyProperty)	Převede hodnotu zadané vlastnosti závislosti. Toho dosáhnete vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastnosti pro vlastnost závislosti, protože existuje ve volajícím DependencyObjectobjektu . (Zděděno od DependencyObject)
CopyPixels(Array, Int32, Int32)	Zkopíruje rastrová pixelová data do pole pixelů se zadaným krokem počínaje zadaným posunem. (Zděděno od BitmapSource)
CopyPixels(Int32Rect, Array, Int32, Int32)	Zkopíruje rastrová pixelová data v zadaném obdélníku do pole pixelů, které má zadaný krok počínaje zadaným posunem. (Zděděno od BitmapSource)
CopyPixels(Int32Rect, IntPtr, Int32, Int32)	Zkopíruje data rastrových pixelů v zadaném obdélníku. (Zděděno od BitmapSource)
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 zadaný DependencyObject ekvivalent k 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)	Vytvoří instanci BitmapSource nebo odvozenou třídu neměnnou. (Zděděno od BitmapSource)
GetAnimationBaseValue(DependencyProperty)	Vrátí hodnotu, která není animovaná zadanou DependencyPropertyhodnotou . (Zděděno od Animatable)
GetAsFrozen()	Vytvoří zamrzlou kopii objektu Freezable, pomocí základních (ne animovaných) hodnot vlastností. Vzhledem k tomu, že kopie je zamrzlá, všechny zmrazené pod objekty jsou zkopírovány odkazem. (Zděděno od Freezable)
GetAsFrozenCore(Freezable)	Vytvoří tuto instanci jako klon zadaného BitmapSource objektu. (Zděděno od BitmapSource)
GetCurrentValueAsFrozen()	Vytvoří zmrazenou kopii Freezable pomocí aktuálních hodnot vlastností. Vzhledem k tomu, že kopie je zamrzlá, všechny zmrazené pod objekty jsou zkopírovány odkazem. (Zděděno od Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Vytvoří tuto instanci jako zablokovaný klon zadaného BitmapSourceobjektu . Odkazy na prostředky, datové vazby a animace se nekopírují, ale jejich aktuální hodnoty jsou. (Zděděno od BitmapSource)
GetHashCode()	Získá hash kód pro tento DependencyObject. (Zděděno od DependencyObject)
GetLocalValueEnumerator()	Vytvoří specializovaný enumerátor pro určení vlastností závislostí, které mají místně nastavené hodnoty v tomto DependencyObjectobjektu . (Zděděno od DependencyObject)
GetType()	Získá aktuální Type instanci. (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 Objectsouboru . (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)	Zajišťuje, aby byly pro datový člen, který byl právě nastaven, vytvořeny odpovídající kontextové DependencyObjectType ukazatele. (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)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Přepíše implementaci DependencyObject tak, OnPropertyChanged(DependencyPropertyChangedEventArgs) aby také vyvolala všechny Changed obslužné rutiny v reakci na měnící se vlastnost závislosti 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 Freezable se k souboru přistupuje z platného vlákna. Dědiči Freezable musí tuto metodu volat na začátku jakéhokoli rozhraní API, které čte datové členy, které nejsou vlastnosti závislostí. (Zděděno od Freezable)
SetCurrentValue(DependencyProperty, Object)	Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnoty. (Zděděno od DependencyObject)
SetValue(DependencyProperty, Object)	Nastaví místní hodnotu vlastnosti závislosti určenou 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 DependencyPropertyKey identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Vrátí hodnotu, která označuje, zda serializační procesy mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
ToString()	Vytvoří řetězcovou reprezentaci tohoto objektu na základě aktuální jazykové verze. (Zděděno od ImageSource)
ToString(IFormatProvider)	Vytvoří řetězcovou reprezentaci tohoto objektu na základě předaného objektu IFormatProvider . Pokud je nullzprostředkovatel , použije se CurrentCulture hodnota . (Zděděno od ImageSource)
VerifyAccess()	Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
WritePostscript()	Changed Vyvolá událost pro Freezable a vyvolá její OnChanged() metodu. Třídy odvozené z Freezable by měly tuto metodu volat na konci libovolného rozhraní API, které upravuje členy třídy, které nejsou uloženy jako vlastnosti závislostí. (Zděděno od Freezable)
WritePreamble()	Ověřuje, že Freezable objekt není zamrznutý a že se k němu přistupuje z platného kontextu podprocesů. Freezable Dědiče by měli tuto metodu volat na začátku jakéhokoli rozhraní API, které zapisuje do datových členů, které nejsou vlastnosti závislostí. (Zděděno od Freezable)

Událost

Changed	Nastane při změně objektu Freezable nebo objektu, který obsahuje. (Zděděno od Freezable)
DecodeFailed	Nastane, když se image nenačte kvůli poškozené hlavičce obrázku. (Zděděno od BitmapSource)
DownloadCompleted	Nastane, když je obsah rastrového obrázku zcela stažen. (Zděděno od BitmapSource)
DownloadFailed	Nastane v případě, že se nepodařilo stáhnout obsah rastrového obrázku. (Zděděno od BitmapSource)
DownloadProgress	Nastane při změně průběhu stahování obsahu rastrového obrázku. (Zděděno od BitmapSource)

Explicitní implementace rozhraní

IFormattable.ToString(String, IFormatProvider)

Formátuje hodnotu aktuální instance pomocí zadaného formátu. (Zděděno od ImageSource)

Viz také

• BitmapSource