Sdílet prostřednictvím


BitmapImage Třída

Definice

Poskytuje specializovaný BitmapSource nástroj, který je optimalizovaný pro načítání imagí pomocí jazyka XAML (Extensible Application Markup Language).

public ref class BitmapImage sealed : System::Windows::Media::Imaging::BitmapSource, System::ComponentModel::ISupportInitialize, System::Windows::Markup::IUriContext
public sealed class BitmapImage : System.Windows.Media.Imaging.BitmapSource, System.ComponentModel.ISupportInitialize, System.Windows.Markup.IUriContext
type BitmapImage = class
    inherit BitmapSource
    interface ISupportInitialize
    interface IUriContext
Public NotInheritable Class BitmapImage
Inherits BitmapSource
Implements ISupportInitialize, IUriContext
Dědičnost
Implementuje

Příklady

Následující příklady kódu ukazují, jak používat BitmapImage kód v jazyce XAML (Extensible Application Markup Language) a kódu.

<!-- Property Tag XAML Syntax -->
<Image Width="200"  Margin="5" Grid.Column="1" Grid.Row="1" >
   <Image.Source>
      <BitmapImage UriSource="sampleImages/bananas.jpg" />
   </Image.Source>
</Image>
<!-- Property Tag XAML Syntax -->
<Image Width="200"  Margin="5" Grid.Column="1" Grid.Row="1" >
   <Image.Source>
      <BitmapImage UriSource="sampleImages/bananas.jpg" />
   </Image.Source>
</Image>
// Create the image element.
Image simpleImage = new Image();    
simpleImage.Width = 200;
simpleImage.Margin = new Thickness(5);

// Create source.
BitmapImage bi = new BitmapImage();
// BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit();
bi.UriSource = new Uri(@"/sampleImages/cherries_larger.jpg",UriKind.RelativeOrAbsolute);
bi.EndInit();
// Set the image source.
simpleImage.Source = bi;
' Create the image element.
Dim simpleImage As New Image()
simpleImage.Width = 200
simpleImage.Margin = New Thickness(5)

' Create source.
Dim bi As New BitmapImage()
' BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit()
bi.UriSource = New Uri("/sampleImages/cherries_larger.jpg", UriKind.RelativeOrAbsolute)
bi.EndInit()
' Set the image source.
simpleImage.Source = bi

Poznámky

BitmapImage Primárně existuje pro podporu syntaxe XAML (Extensible Application Markup Language) a zavádí další vlastnosti pro načítání rastrových obrázků, které nejsou definovány nástrojem BitmapSource.

BitmapImage implementuje ISupportInitialize rozhraní pro optimalizaci inicializace více vlastností. Ke změnám vlastností může dojít pouze během inicializace objektu. Volání BeginInit signálu o zahájení inicializace a EndInit signálu, že se inicializace dokončila. Po inicializaci se změny vlastností ignorují.

BitmapImage objekty vytvořené pomocí konstruktoru BitmapImage jsou automaticky inicializovány a změny vlastností jsou ignorovány.

Konstruktory

BitmapImage()

Inicializuje novou instanci BitmapImage třídy.

BitmapImage(Uri)

Inicializuje novou instanci BitmapImage třídy pomocí zadané Uri.

BitmapImage(Uri, RequestCachePolicy)

Inicializuje novou instanci BitmapImage třídy pomocí image, jejíž zdrojem je Uri, a je uložen v mezipaměti podle zadané RequestCachePolicy.

Pole

CacheOptionProperty

Identifikuje CacheOption vlastnost závislosti.

CreateOptionsProperty

Identifikuje CreateOptions vlastnost závislosti.

DecodePixelHeightProperty

Identifikuje DecodePixelHeight vlastnost závislosti.

DecodePixelWidthProperty

Identifikuje DecodePixelWidth vlastnost závislosti.

RotationProperty

Identifikuje Rotation vlastnost závislosti.

SourceRectProperty

Identifikuje SourceRect vlastnost závislosti.

StreamSourceProperty

Identifikuje StreamSource vlastnost závislosti.

UriCachePolicyProperty

Identifikuje UriCachePolicy vlastnost závislosti.

UriSourceProperty

Identifikuje UriSource vlastnost závislosti.

Vlastnosti

BaseUri

Získá nebo nastaví hodnotu, která představuje základ Uri aktuálního BitmapImage kontextu.

CacheOption

Získá nebo nastaví BitmapCacheOption na použití pro tuto instanci .BitmapImage

CanFreeze

Získá hodnotu, která označuje, zda objekt lze změnit.

(Zděděno od Freezable)
CreateOptions

Získá nebo nastaví BitmapCreateOptions pro BitmapImage.

DecodePixelHeight

Získá nebo nastaví výšku v pixelech, na kterou je obrázek dekódován.

DecodePixelWidth

Získá nebo nastaví šířku v pixelech, na kterou je obrázek dekódován.

DependencyObjectType

DependencyObjectType Získá, který zabalí typ CLR této instance.

(Zděděno od DependencyObject)
Dispatcher

Získá přidruženou Dispatcher k tomuto DispatcherObject .

(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 BitmapImage je právě stahuje obsah.

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

Nepodporováno BitmapImage nepodporuje Metadata vlastnost a vyvolá NotSupportedException.

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)
Rotation

Získá nebo nastaví úhel, na který BitmapImage je otočen.

SourceRect

Získá nebo nastaví obdélník, který se používá jako zdroj objektu BitmapImage.

StreamSource

Získá nebo nastaví zdroj datového BitmapImageproudu .

UriCachePolicy

Získá nebo nastaví hodnotu, která představuje zásady ukládání do mezipaměti pro image, které pocházejí ze zdroje HTTP.

UriSource

Získá nebo nastaví Uri zdroj BitmapImage.

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)
BeginInit()

Signalizuje začátek BitmapImage inicializace.

CheckAccess()

Určuje, zda má volající vlákno 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 BitmapImageobjektu a vytváří hluboké kopie hodnot tohoto objektu.

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 BitmapImage 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)
EndInit()

Signalizuje konec BitmapImage inicializace.

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()

Vynutí, aby 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)

Platí pro

Viz také