BitmapImage Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Media.Imaging

Zestaw:: PresentationCore.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Udostępnia wyspecjalizowany, BitmapSource który jest zoptymalizowany pod kątem ładowania obrazów przy użyciu języka 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

Dziedziczenie: Object

DispatcherObject

DependencyObject

Freezable

Animatable

ImageSource

BitmapSource
BitmapImage

Implementuje: ISupportInitialize IUriContext

Przykłady

W poniższych przykładach kodu pokazano, jak używać w BitmapImage języku XAML (Extensible Application Markup Language) i kodzie.

<!-- 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

Uwagi

BitmapImage przede wszystkim istnieje, aby obsługiwać składnię języka XAML (Extensible Application Markup Language) i wprowadza dodatkowe właściwości ładowania map bitowych, które nie są zdefiniowane przez BitmapSourceprogram .

BitmapImage implementuje interfejs w ISupportInitialize celu optymalizacji inicjowania na wielu właściwościach. Zmiany właściwości mogą wystąpić tylko podczas inicjowania obiektu. Wywołaj polecenie BeginInit sygnalizujące, że zainicjowanie zaczęło się i EndInit sygnalizuje, że inicjowanie zostało zakończone. Po zainicjowaniu zmiany właściwości są ignorowane.

BitmapImage obiekty utworzone przy użyciu konstruktora BitmapImage są automatycznie inicjowane, a zmiany właściwości są ignorowane.

Konstruktory

BitmapImage()	Inicjuje nowe wystąpienie klasy BitmapImage.
BitmapImage(Uri)	Inicjuje BitmapImage nowe wystąpienie klasy przy użyciu podanego elementu Uri.
BitmapImage(Uri, RequestCachePolicy)	Inicjuje nowe wystąpienie BitmapImage klasy z obrazem Uri, którego źródłem jest , i jest buforowane zgodnie z podanym RequestCachePolicyparametrem .

Pola

CacheOptionProperty	Identyfikuje CacheOption właściwość zależności.
CreateOptionsProperty	Identyfikuje CreateOptions właściwość zależności.
DecodePixelHeightProperty	Identyfikuje DecodePixelHeight właściwość zależności.
DecodePixelWidthProperty	Identyfikuje DecodePixelWidth właściwość zależności.
RotationProperty	Identyfikuje Rotation właściwość zależności.
SourceRectProperty	Identyfikuje SourceRect właściwość zależności.
StreamSourceProperty	Identyfikuje StreamSource właściwość zależności.
UriCachePolicyProperty	Identyfikuje UriCachePolicy właściwość zależności.
UriSourceProperty	Identyfikuje UriSource właściwość zależności.

Właściwości

BaseUri	Pobiera lub ustawia wartość reprezentującą bazę Uri bieżącego BitmapImage kontekstu.
CacheOption	Pobiera lub ustawia parametr BitmapCacheOption , który ma być używany dla tego wystąpienia programu BitmapImage.
CanFreeze	Pobiera wartość wskazującą, czy obiekt może być niemodyfikowalny. (Odziedziczone po Freezable)
CreateOptions	Pobiera lub ustawia dla parametru BitmapCreateOptions BitmapImage.
DecodePixelHeight	Pobiera lub ustawia wysokość w pikselach, na którą obraz jest dekodowany.
DecodePixelWidth	Pobiera lub ustawia szerokość w pikselach, na którą obraz jest dekodowany.
DependencyObjectType	DependencyObjectType Pobiera opakowujący typ clR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (Odziedziczone po DispatcherObject)
DpiX	Pobiera poziome kropki na cal (dpi) obrazu. (Odziedziczone po BitmapSource)
DpiY	Pobiera pionowe kropki na cal (dpi) obrazu. (Odziedziczone po BitmapSource)
Format	Pobiera natywne PixelFormat dane mapy bitowej. (Odziedziczone po BitmapSource)
HasAnimatedProperties	Pobiera wartość wskazującą, czy co najmniej jeden AnimationClock obiekt jest skojarzony z dowolnymi właściwościami zależności tego obiektu. (Odziedziczone po Animatable)
Height	Pobiera wysokość źródłowej mapy bitowej w jednostkach niezależnych od urządzenia (1/96 cala na jednostkę). (Odziedziczone po BitmapSource)
IsDownloading	Pobiera wartość wskazującą, czy BitmapImage aktualnie pobiera zawartość.
IsFrozen	Pobiera wartość wskazującą, czy obiekt jest obecnie modyfikowalny. (Odziedziczone po Freezable)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)
Metadata	Nieobsługiwane. BitmapImage nie obsługuje Metadata właściwości i zgłasza wartość NotSupportedException.
Palette	Pobiera paletę kolorów mapy bitowej, jeśli zostanie określona. (Odziedziczone po BitmapSource)
PixelHeight	Pobiera wysokość mapy bitowej w pikselach. (Odziedziczone po BitmapSource)
PixelWidth	Pobiera szerokość mapy bitowej w pikselach. (Odziedziczone po BitmapSource)
Rotation	Pobiera lub ustawia kąt, na który BitmapImage jest obracany.
SourceRect	Pobiera lub ustawia prostokąt używany jako źródło BitmapImageobiektu .
StreamSource	Pobiera lub ustawia źródło strumienia elementu BitmapImage.
UriCachePolicy	Pobiera lub ustawia wartość reprezentującą zasady buforowania obrazów pochodzących ze źródła HTTP.
UriSource	Pobiera lub ustawia Uri źródło obiektu BitmapImage.
Width	Pobiera szerokość mapy bitowej w jednostkach niezależnych od urządzenia (1/96 cala na jednostkę). (Odziedziczone po BitmapSource)

Metody

ApplyAnimationClock(DependencyProperty, AnimationClock)	Stosuje element AnimationClock do określonego DependencyPropertyelementu . Jeśli właściwość jest już animowana, SnapshotAndReplace używane jest zachowanie przekazywania. (Odziedziczone po Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Stosuje element AnimationClock do określonego DependencyPropertyelementu . Jeśli właściwość jest już animowana, zostanie użyta określona HandoffBehavior wartość . (Odziedziczone po Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Stosuje animację do określonego DependencyPropertyelementu . Animacja jest uruchamiana po renderowaniu następnej ramki. Jeśli określona właściwość jest już animowana, SnapshotAndReplace zostanie użyte zachowanie przekazywania. (Odziedziczone po Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Stosuje animację do określonego DependencyPropertyelementu . Animacja jest uruchamiana po renderowaniu następnej ramki. Jeśli określona właściwość jest już animowana, zostanie użyta określona HandoffBehavior właściwość. (Odziedziczone po Animatable)
BeginInit()	Sygnalizuje początek inicjowania BitmapImage .
CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
CheckIfSiteOfOrigin()	Sprawdza, czy zawartość źródłowa mapy bitowej pochodzi ze znanej lokacji pochodzenia. Ta metoda służy do zapewnienia, że operacje kopiowania pikseli są bezpieczne. (Odziedziczone po BitmapSource)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez DependencyPropertyKeyelement . (Odziedziczone po DependencyObject)
Clone()	Tworzy modyfikowalny klon tego BitmapImageobiektu , tworząc głębokie kopie wartości tego obiektu.
CloneCore(Freezable)	Sprawia, że to wystąpienie jest głęboką kopią określonego BitmapSourceelementu . Podczas kopiowania właściwości zależności ta metoda kopiuje odwołania do zasobów i powiązania danych (ale mogą nie być już rozpoznawane), ale nie animacje ani ich bieżące wartości. (Odziedziczone po BitmapSource)
CloneCurrentValue()	Tworzy modyfikowalny klon tego BitmapImage obiektu, tworząc głębokie kopie bieżących wartości tego obiektu. Odwołania do zasobów, powiązania danych i animacje nie są kopiowane, ale ich bieżące wartości są.
CloneCurrentValueCore(Freezable)	Sprawia, że to wystąpienie jest modyfikowalną kopią głęboką określonej wartości BitmapSource właściwości przy użyciu bieżących wartości właściwości. Odwołania do zasobów, powiązania danych i animacje nie są kopiowane, ale ich bieżące wartości są. (Odziedziczone po BitmapSource)
CoerceValue(DependencyProperty)	Coerce wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
CopyPixels(Array, Int32, Int32)	Kopiuje dane pikseli mapy bitowej do tablicy pikseli z określonym krokiem, zaczynając od określonego przesunięcia. (Odziedziczone po BitmapSource)
CopyPixels(Int32Rect, Array, Int32, Int32)	Kopiuje dane pikseli mapy bitowej w określonym prostokątze do tablicy pikseli, która ma określony krok rozpoczynający się od określonego przesunięcia. (Odziedziczone po BitmapSource)
CopyPixels(Int32Rect, IntPtr, Int32, Int32)	Kopiuje dane pikseli mapy bitowej w określonym prostokątze. (Odziedziczone po BitmapSource)
CreateInstance()	Inicjuje nowe wystąpienie klasy Freezable. (Odziedziczone po Freezable)
CreateInstanceCore()	Po zaimplementowaniu w klasie pochodnej tworzy nowe wystąpienie klasy pochodnej Freezable . (Odziedziczone po Freezable)
EndInit()	Sygnalizuje koniec inicjowania BitmapImage .
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
Freeze()	Sprawia, że bieżący obiekt jest niezmodyfikowalny i ustawia jego IsFrozen właściwość na `true`. (Odziedziczone po Freezable)
FreezeCore(Boolean)	Sprawia, że wystąpienie klasy pochodnej BitmapSource jest niezmienne. (Odziedziczone po BitmapSource)
GetAnimationBaseValue(DependencyProperty)	Zwraca wartość nie animowaną określonego DependencyPropertyelementu . (Odziedziczone po Animatable)
GetAsFrozen()	Tworzy zamrożoną kopię obiektu Freezableprzy użyciu wartości właściwości base (nie animowanych). Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable)
GetAsFrozenCore(Freezable)	Sprawia, że to wystąpienie jest klonem określonego BitmapSource obiektu. (Odziedziczone po BitmapSource)
GetCurrentValueAsFrozen()	Tworzy zamrożoną kopię przy użyciu bieżących Freezable wartości właściwości. Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Sprawia, że to wystąpienie jest zamrożonym klonem określonego BitmapSourceobiektu . Odwołania do zasobów, powiązania danych i animacje nie są kopiowane, ale ich bieżące wartości są. (Odziedziczone po BitmapSource)
GetHashCode()	Pobiera kod skrótu dla tego pliku DependencyObject. (Odziedziczone po DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości w tym DependencyObjectelemecie . (Odziedziczone po DependencyObject)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia obiektu DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnChanged()	Wywoływana po zmodyfikowaniu bieżącego Freezable obiektu. (Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Zapewnia, że odpowiednie wskaźniki kontekstu są ustanawiane dla DependencyObjectType elementu członkowskiego danych, który został właśnie ustawiony. (Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Ten element członkowski obsługuje infrastrukturę Windows Presentation Foundation (WPF) i nie jest przeznaczony do użycia bezpośrednio z kodu. (Odziedziczone po Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Zastępuje implementację DependencyObject OnPropertyChanged(DependencyPropertyChangedEventArgs) metody w celu wywołania wszystkich Changed procedur obsługi w odpowiedzi na zmieniającą się właściwość zależności typu Freezable. (Odziedziczone po Freezable)
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
ReadPreamble()	Gwarantuje, że dostęp do obiektu Freezable jest uzyskiwany z prawidłowego wątku. Dziedzicze muszą Freezable wywoływać tę metodę na początku dowolnego interfejsu API, który odczytuje elementy członkowskie danych, które nie są właściwościami zależności. (Odziedziczone po Freezable)
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmiany źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jego identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określona przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Tworzy reprezentację ciągu tego obiektu na podstawie bieżącej kultury. (Odziedziczone po ImageSource)
ToString(IFormatProvider)	Tworzy reprezentację ciągu tego obiektu na podstawie przekazanego IFormatProvider elementu. Jeśli dostawca to `null`, CurrentCulture jest używany. (Odziedziczone po ImageSource)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
WritePostscript()	Changed Zgłasza zdarzenie dla Freezable metody i wywołuje jej OnChanged() metodę. Klasy pochodzące z Freezable programu powinny wywoływać tę metodę na końcu dowolnego interfejsu API, który modyfikuje składowe klasy, które nie są przechowywane jako właściwości zależności. (Odziedziczone po Freezable)
WritePreamble()	Sprawdza, czy Freezable element nie jest zamrożony i czy jest uzyskiwany dostęp do niego z prawidłowego kontekstu wątkowego. Freezable dziedzicze powinny wywoływać tę metodę na początku dowolnego interfejsu API, który zapisuje do elementów członkowskich danych, które nie są właściwościami zależności. (Odziedziczone po Freezable)

Zdarzenia

Changed	Występuje, gdy Freezable obiekt lub, który zawiera, jest modyfikowany. (Odziedziczone po Freezable)
DecodeFailed	Występuje, gdy nie można załadować obrazu z powodu uszkodzonego nagłówka obrazu. (Odziedziczone po BitmapSource)
DownloadCompleted	Występuje, gdy zawartość mapy bitowej została całkowicie pobrana. (Odziedziczone po BitmapSource)
DownloadFailed	Występuje, gdy nie można pobrać zawartości mapy bitowej. (Odziedziczone po BitmapSource)
DownloadProgress	Występuje, gdy postęp pobierania zawartości mapy bitowej uległ zmianie. (Odziedziczone po BitmapSource)

Jawne implementacje interfejsu

IFormattable.ToString(String, IFormatProvider)

Formatuje wartość bieżącego wystąpienia przy użyciu określonego formatu.

(Odziedziczone po ImageSource)

Dotyczy