BitmapImage Sınıf

Başvuru

Tanım

Ad Alanı:: System.Windows.Media.Imaging

Bütünleştirilmiş Kod:: PresentationCore.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Genişletilebilir Uygulama Biçimlendirme Dili (XAML) kullanarak görüntüleri yüklemek için iyileştirilmiş bir özelleştirilmiş BitmapSource sağlar.

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

Devralma: Object

DispatcherObject

DependencyObject

Freezable

Animatable

ImageSource

BitmapSource
BitmapImage

Uygulamalar: ISupportInitialize IUriContext

Örnekler

Aşağıdaki kod örnekleri, Genişletilebilir Uygulama Biçimlendirme Dili (XAML) ve kodun nasıl kullanılacağını BitmapImage göstermektedir.

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

Açıklamalar

BitmapImage öncelikle Genişletilebilir Uygulama Biçimlendirme Dili (XAML) söz dizimlerini desteklemek için vardır ve bit eşlem yükleme için tarafından BitmapSourcetanımlanmayan ek özellikler sağlar.

BitmapImage birden çok özellikte başlatmayı ISupportInitialize iyileştirmek için arabirimini uygular. Özellik değişiklikleri yalnızca nesne başlatma sırasında oluşabilir. Başlatmanın BeginInit başladığını EndInit ve başlatmanın tamamlandığını belirten sinyal çağrısı. Başlatmadan sonra özellik değişiklikleri yoksayılır.

BitmapImage oluşturucu kullanılarak BitmapImage oluşturulan nesneler otomatik olarak başlatılır ve özellik değişiklikleri yoksayılır.

Oluşturucular

BitmapImage()	BitmapImage sınıfının yeni bir örneğini başlatır.
BitmapImage(Uri)	Sağlanan Urikullanarak sınıfının yeni bir örneğini BitmapImage başlatır.
BitmapImage(Uri, RequestCachePolicy)	kaynağı bir olan ve sağlanan RequestCachePolicyöğesine göre önbelleğe alınan bir görüntü ile sınıfının yeni bir Uriörneğini BitmapImage başlatır.

Alanlar

CacheOptionProperty	CacheOption Bağımlılık özelliğini tanımlar.
CreateOptionsProperty	CreateOptions Bağımlılık özelliğini tanımlar.
DecodePixelHeightProperty	DecodePixelHeight Bağımlılık özelliğini tanımlar.
DecodePixelWidthProperty	DecodePixelWidth Bağımlılık özelliğini tanımlar.
RotationProperty	Rotation Bağımlılık özelliğini tanımlar.
SourceRectProperty	SourceRect Bağımlılık özelliğini tanımlar.
StreamSourceProperty	StreamSource Bağımlılık özelliğini tanımlar.
UriCachePolicyProperty	UriCachePolicy Bağımlılık özelliğini tanımlar.
UriSourceProperty	UriSource Bağımlılık özelliğini tanımlar.

Özellikler

BaseUri	Geçerli BitmapImage bağlamın tabanını Uri temsil eden bir değer alır veya ayarlar.
CacheOption	bu örneği BitmapImageiçin kullanılacak öğesini BitmapCacheOption alır veya ayarlar.
CanFreeze	Nesnenin değiştirilemez hale getirilip getirilemeyeceğini belirten bir değer alır. (Devralındığı yer: Freezable)
CreateOptions	için BitmapImageöğesini BitmapCreateOptions alır veya ayarlar.
DecodePixelHeight	Görüntünün kodunun çözüldüğünü piksel cinsinden yüksekliği alır veya ayarlar.
DecodePixelWidth	Görüntünün kodunun çözüldüğünü piksel cinsinden genişliği alır veya ayarlar.
DependencyObjectType	DependencyObjectType Bu örneğin CLR türünü sarmalayan öğesini alır. (Devralındığı yer: DependencyObject)
Dispatcher	Dispatcher Bunun DispatcherObject ilişkili olduğunu alır. (Devralındığı yer: DispatcherObject)
DpiX	Görüntünün inç başına yatay noktaları (dpi) alır. (Devralındığı yer: BitmapSource)
DpiY	Görüntünün inç başına dikey noktaları (dpi) alır. (Devralındığı yer: BitmapSource)
Format	Bit eşlem verilerinin yerelini PixelFormat alır. (Devralındığı yer: BitmapSource)
HasAnimatedProperties	Bir veya daha fazla AnimationClock nesnenin bu nesnenin bağımlılık özelliklerinden herhangi biriyle ilişkili olup olmadığını gösteren bir değer alır. (Devralındığı yer: Animatable)
Height	Kaynak bit eşleminin yüksekliğini cihazdan bağımsız birimlerde (birim başına 1/96 inç) alır. (Devralındığı yer: BitmapSource)
IsDownloading	öğesinin şu anda içerik indirip indirmediğini BitmapImage belirten bir değer alır.
IsFrozen	Nesnenin şu anda değiştirilebilir olup olmadığını gösteren bir değer alır. (Devralındığı yer: Freezable)
IsSealed	Bu örneğin şu anda korumalı (salt okunur) olup olmadığını gösteren bir değer alır. (Devralındığı yer: DependencyObject)
Metadata	Desteklenmez. BitmapImage özelliğini desteklemez Metadata ve bir NotSupportedExceptionoluşturur.
Palette	Bit eşlem belirtilmişse, bit eşlem renk paletini alır. (Devralındığı yer: BitmapSource)
PixelHeight	Bit eşlem yüksekliğini piksel cinsinden alır. (Devralındığı yer: BitmapSource)
PixelWidth	Bit eşlem genişliğini piksel cinsinden alır. (Devralındığı yer: BitmapSource)
Rotation	Bunun BitmapImage döndürülecek açıyı alır veya ayarlar.
SourceRect	kaynağı BitmapImageolarak kullanılan dikdörtgeni alır veya ayarlar.
StreamSource	öğesinin akış kaynağını BitmapImagealır veya ayarlar.
UriCachePolicy	BIR HTTP kaynağından gelen görüntüler için önbelleğe alma ilkesini temsil eden bir değer alır veya ayarlar.
UriSource	öğesinin Uri kaynağını BitmapImagealır veya ayarlar.
Width	Bit eşlem genişliğini cihazdan bağımsız birimler halinde (birim başına 1/96 inç) alır. (Devralındığı yer: BitmapSource)

Yöntemler

ApplyAnimationClock(DependencyProperty, AnimationClock)	Belirtilen DependencyPropertyöğesine bir AnimationClock uygular. Özellik zaten animasyonluysa, SnapshotAndReplace iletim davranışı kullanılır. (Devralındığı yer: Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Belirtilen DependencyPropertyöğesine bir AnimationClock uygular. Özellik zaten animasyonlu ise, belirtilen HandoffBehavior kullanılır. (Devralındığı yer: Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Belirtilen DependencyPropertyöğesine bir animasyon uygular. Animasyon, bir sonraki çerçeve işlendiğinde başlatılır. Belirtilen özellik zaten animasyonluysa, SnapshotAndReplace iletim davranışı kullanılır. (Devralındığı yer: Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Belirtilen DependencyPropertyöğesine bir animasyon uygular. Animasyon, bir sonraki çerçeve işlendiğinde başlatılır. Belirtilen özellik zaten animasyonluysa, belirtilen HandoffBehavior kullanılır. (Devralındığı yer: Animatable)
BeginInit()	Başlatmanın başlangıcını BitmapImage bildirir.
CheckAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişimi olup olmadığını belirler. (Devralındığı yer: DispatcherObject)
CheckIfSiteOfOrigin()	Bit eşlem kaynak içeriğinin bilinen bir kaynak sitesinden olup olmadığını denetler. Bu yöntem, piksel kopyalama işlemlerinin güvenli olduğundan emin olmak için kullanılır. (Devralındığı yer: BitmapSource)
ClearValue(DependencyProperty)	Bir özelliğin yerel değerini temizler. Temizlenecek özellik bir DependencyProperty tanımlayıcı tarafından belirtilir. (Devralındığı yer: DependencyObject)
ClearValue(DependencyPropertyKey)	Salt okunur özelliğin yerel değerini temizler. Temizlenecek özellik tarafından DependencyPropertyKeybelirtilir. (Devralındığı yer: DependencyObject)
Clone()	Bu BitmapImagenesnenin değerlerinin derin kopyalarını oluşturarak bu öğesinin değiştirilebilir bir kopyasını oluşturur.
CloneCore(Freezable)	Bu örneği belirtilen BitmapSourceöğesinin derin bir kopyası yapar. Bağımlılık özelliklerini kopyalarken, bu yöntem kaynak başvurularını ve veri bağlamalarını kopyalar (ancak bunlar artık çözümlenmeyebilir) ancak animasyonları veya geçerli değerlerini kopyalanmaz. (Devralındığı yer: BitmapSource)
CloneCurrentValue()	Bu BitmapImage nesnenin değiştirilebilir bir kopyasını oluşturur ve bu nesnenin geçerli değerlerinin derin kopyalarını oluşturur. Kaynak başvuruları, veri bağlamaları ve animasyonlar kopyalanmaz, ancak geçerli değerleri kopyalanır.
CloneCurrentValueCore(Freezable)	Bu örneği, geçerli özellik değerlerini kullanarak belirtilenlerin BitmapSource değiştirilebilir bir derin kopyası yapar. Kaynak başvuruları, veri bağlamaları ve animasyonlar kopyalanmaz, ancak geçerli değerleri kopyalanır. (Devralındığı yer: BitmapSource)
CoerceValue(DependencyProperty)	Belirtilen bağımlılık özelliğinin değerini zorlama. Bu, çağrısında var olan bağımlılık özelliği için özellik meta verilerinde belirtilen herhangi bir CoerceValueCallback işlevi çağırarak DependencyObjectgerçekleştirilir. (Devralındığı yer: DependencyObject)
CopyPixels(Array, Int32, Int32)	Bit eşlem piksel verilerini belirtilen uzaklıkta başlayarak belirtilen adımla bir piksel dizisine kopyalar. (Devralındığı yer: BitmapSource)
CopyPixels(Int32Rect, Array, Int32, Int32)	Belirtilen dikdörtgen içindeki bit eşlem piksel verilerini belirtilen uzaklıkta başlayan belirtilen adıma sahip bir piksel dizisine kopyalar. (Devralındığı yer: BitmapSource)
CopyPixels(Int32Rect, IntPtr, Int32, Int32)	Bit eşlem piksel verilerini belirtilen dikdörtgen içinde kopyalar. (Devralındığı yer: BitmapSource)
CreateInstance()	Freezable sınıfının yeni bir örneğini başlatır. (Devralındığı yer: Freezable)
CreateInstanceCore()	Türetilmiş bir sınıfta uygulandığında, türetilmiş sınıfın Freezable yeni bir örneğini oluşturur. (Devralındığı yer: Freezable)
EndInit()	Başlatmanın sona ereceğini BitmapImage bildirir.
Equals(Object)	Sağlanan DependencyObject öğesinin geçerli DependencyObjectile eşdeğer olup olmadığını belirler. (Devralındığı yer: DependencyObject)
Freeze()	Geçerli nesneyi değiştirilemez hale getirir ve özelliğini olarak `true`ayarlarIsFrozen. (Devralındığı yer: Freezable)
FreezeCore(Boolean)	veya türetilmiş bir sınıfın BitmapSource örneğini sabit hale getirir. (Devralındığı yer: BitmapSource)
GetAnimationBaseValue(DependencyProperty)	Belirtilen DependencyPropertyöğesinin animasyonsuz değerini döndürür. (Devralındığı yer: Animatable)
GetAsFrozen()	Temel (animasyonsuz) özellik değerlerini kullanarak öğesinin Freezabledonmuş bir kopyasını oluşturur. Kopya donduruldığından, dondurulan tüm alt nesneler başvuruyla kopyalanır. (Devralındığı yer: Freezable)
GetAsFrozenCore(Freezable)	Bu örneği belirtilen BitmapSource nesnenin bir kopyası yapar. (Devralındığı yer: BitmapSource)
GetCurrentValueAsFrozen()	Geçerli özellik değerlerini kullanarak öğesinin dondurulan Freezable bir kopyasını oluşturur. Kopya donduruldığından, dondurulan tüm alt nesneler başvuruyla kopyalanır. (Devralındığı yer: Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Bu örneği belirtilen BitmapSourceöğesinin dondurulan bir kopyası yapar. Kaynak başvuruları, veri bağlamaları ve animasyonlar kopyalanmaz, ancak geçerli değerleri kopyalanır. (Devralındığı yer: BitmapSource)
GetHashCode()	Bu DependencyObjectiçin bir karma kodu alır. (Devralındığı yer: DependencyObject)
GetLocalValueEnumerator()	Hangi bağımlılık özelliklerinin bu DependencyObjectüzerinde yerel olarak ayarlı değerlere sahip olduğunu belirlemek için özelleştirilmiş bir numaralandırıcı oluşturur. (Devralındığı yer: DependencyObject)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
GetValue(DependencyProperty)	Bir öğesinin bu örneğindeki bağımlılık özelliğinin DependencyObjectgeçerli geçerli değerini döndürür. (Devralındığı yer: DependencyObject)
InvalidateProperty(DependencyProperty)	Belirtilen bağımlılık özelliği için geçerli değeri yeniden değerlendirir. (Devralındığı yer: DependencyObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnChanged()	Geçerli Freezable nesne değiştirildiğinde çağrılır. (Devralındığı yer: Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Yeni ayarlanmış bir DependencyObjectType veri üyesi için uygun bağlam işaretçilerinin oluşturulmasını sağlar. (Devralındığı yer: Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Bu üye Windows Presentation Foundation (WPF) altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır. (Devralındığı yer: Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	türündeki DependencyObject Freezabledeğişen bağımlılık özelliğine yanıt olarak herhangi Changed bir işleyici çağırmak için uygulamasını OnPropertyChanged(DependencyPropertyChangedEventArgs) geçersiz kılar. (Devralındığı yer: Freezable)
ReadLocalValue(DependencyProperty)	Varsa, bağımlılık özelliğinin yerel değerini döndürür. (Devralındığı yer: DependencyObject)
ReadPreamble()	Freezable geçerli bir iş parçacığından erişildiğinden emin olur. öğesinin devralıcıları Freezable , bağımlılık özellikleri olmayan veri üyelerini okuyan herhangi bir API'nin başında bu yöntemi çağırmalıdır. (Devralındığı yer: Freezable)
SetCurrentValue(DependencyProperty, Object)	Bağımlılık özelliğinin değerini, değer kaynağını değiştirmeden ayarlar. (Devralındığı yer: DependencyObject)
SetValue(DependencyProperty, Object)	Bağımlılık özelliği tanımlayıcısı tarafından belirtilen bağımlılık özelliğinin yerel değerini ayarlar. (Devralındığı yer: DependencyObject)
SetValue(DependencyPropertyKey, Object)	Salt okunur bağımlılık özelliğinin, bağımlılık özelliğinin DependencyPropertyKey tanımlayıcısı tarafından belirtilen yerel değerini ayarlar. (Devralındığı yer: DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Serileştirme işlemlerinin sağlanan bağımlılık özelliği için değeri serileştirmesi gerekip gerekmediğini belirten bir değer döndürür. (Devralındığı yer: DependencyObject)
ToString()	Geçerli kültürü temel alarak bu nesnenin dize gösterimini oluşturur. (Devralındığı yer: ImageSource)
ToString(IFormatProvider)	Geçirilen öğesine göre bu nesnenin dize gösterimini IFormatProvider oluşturur. Sağlayıcı ise `null`CurrentCulture kullanılır. (Devralındığı yer: ImageSource)
VerifyAccess()	Çağıran iş parçacığının bu DispatcherObjecterişimine sahip olmasını zorlar. (Devralındığı yer: DispatcherObject)
WritePostscript()	Changed için Freezable olayını oluşturur ve yöntemini çağırırOnChanged(). türetilen Freezable sınıflar, bağımlılık özellikleri olarak depolanmayan sınıf üyelerini değiştiren herhangi bir API'nin sonunda bu yöntemi çağırmalıdır. (Devralındığı yer: Freezable)
WritePreamble()	öğesinin Freezable dondurulmadığını ve geçerli bir iş parçacığı bağlamından erişildiğini doğrular. Freezable inheritor'lar, bağımlılık özellikleri olmayan veri üyelerine yazan herhangi bir API'nin başında bu yöntemi çağırmalıdır. (Devralındığı yer: Freezable)

Ekinlikler

Changed	içerdiği veya nesnesi değiştirildiğinde Freezable gerçekleşir. (Devralındığı yer: Freezable)
DecodeFailed	Bozuk bir görüntü üst bilgisi nedeniyle görüntü yüklenemediğinde gerçekleşir. (Devralındığı yer: BitmapSource)
DownloadCompleted	Bit eşlem içeriği tamamen indirildiğinde gerçekleşir. (Devralındığı yer: BitmapSource)
DownloadFailed	Bit eşlem içeriği indirilemediğinde gerçekleşir. (Devralındığı yer: BitmapSource)
DownloadProgress	Bit eşlem içeriğinin indirme ilerleme durumu değiştiğinde gerçekleşir. (Devralındığı yer: BitmapSource)

Belirtik Arabirim Kullanımları

IFormattable.ToString(String, IFormatProvider)

Belirtilen biçimi kullanarak geçerli örneğin değerini biçimlendirebilir.

(Devralındığı yer: ImageSource)

Şunlara uygulanır