BitmapImage Sınıf
Tanım
Ö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::IUriContextpublic sealed class BitmapImage : System.Windows.Media.Imaging.BitmapSource, System.ComponentModel.ISupportInitialize, System.Windows.Markup.IUriContexttype BitmapImage = class
inherit BitmapSource
interface ISupportInitialize
interface IUriContextPublic NotInheritable Class BitmapImage
Inherits BitmapSource
Implements ISupportInitialize, IUriContext- Devralma
- Uygulamalar
Örnekler
Aşağıdaki kod örneklerinde Genişletilebilir Uygulama biçimlendirme dili (XAML) ve kodun nasıl kullanılacağı BitmapImage gösterilmektedir.
<!-- 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 öncelikli olarak Genişletilebilir Uygulama Biçimlendirme Dili (XAML) söz dizimlerini desteklemek için vardır ve bit eşlem yüklemesi 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 gerçekleşebilir. Başlatmanın BeginInit başladığını EndInit ve başlatmanın tamamlandığını belirten bir çağrı. 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
| Name | Description |
|---|---|
| BitmapImage() |
BitmapImage sınıfının yeni bir örneğini başlatır. |
| BitmapImage(Uri, RequestCachePolicy) |
Kaynağı bir olan ve sağlanan BitmapImageöğesine göre önbelleğe alınan bir görüntü ile sınıfının yeni bir Uriörneğini RequestCachePolicy başlatır. |
| BitmapImage(Uri) |
Sağlanan BitmapImageöğesini kullanarak sınıfının yeni bir örneğini Uri başlatır. |
Alanlar
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
| BaseUri |
Geçerli Uri bağlamın tabanını BitmapImage temsil eden bir değer alır veya ayarlar. |
| CacheOption |
bu örneği BitmapCacheOptioniçin kullanılacak öğesini BitmapImage alır veya ayarlar. |
| CanFreeze |
Nesnenin değiştirilemez hale getirilip getirilemeyeceğini gösteren bir değer alır. (Devralındığı yer: Freezable) |
| CreateOptions |
için BitmapCreateOptionsöğesini BitmapImage 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ğu öğesini 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 gösteren 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 |
Desteklenmiyor. 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 |
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
| Name | Description |
|---|---|
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Belirtilen AnimationClocköğesine bir DependencyProperty uygular. Özellik zaten animasyonluysa, belirtilen HandoffBehavior kullanılır. (Devralındığı yer: Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Belirtilen AnimationClocköğesine bir DependencyProperty uygular. Özelliği zaten animasyonlu ise, SnapshotAndReplace iletim davranışı kullanılır. (Devralındığı yer: Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Belirtilen DependencyPropertyöğesine bir animasyon uygular. Animasyon, sonraki çerçeve işlendiğinde başlatılır. Belirtilen özellik zaten animasyonluysa, belirtilen HandoffBehavior kullanılır. (Devralındığı yer: Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Belirtilen DependencyPropertyöğesine bir animasyon uygular. Animasyon, sonraki çerçeve işlendiğinde başlatılır. Belirtilen özellik zaten animasyonluysa, SnapshotAndReplace iletim davranışı kullanılır. (Devralındığı yer: Animatable) |
| BeginInit() |
Başlatmanın başlangıcına BitmapImage işaret eder. |
| 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 kopyalar. (Devralındığı yer: BitmapSource) |
| CloneCurrentValue() |
Bu nesnenin değiştirilebilir bir kopyasını oluşturarak bu BitmapImage 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 CoerceValueCallbackvar olan bağımlılık özelliği için özellik meta verilerinde belirtilen herhangi bir DependencyObject işlevi çağırarak gerç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 sonuna işaret BitmapImage eder. |
| 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 IsFrozenayarlar |
| 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 donmuş bir kopyasını Freezableoluşturur. Kopya dondurulacağından, dondurulan 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 donmuş Freezable bir kopyasını oluşturur. Kopya dondurulacağından, dondurulan alt nesneler başvuruyla kopyalanır. (Devralındığı yer: Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Bu örneği, belirtilen BitmapSourceöğesinin donmuş 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 özel bir numaralandırıcı oluşturur. (Devralındığı yer: DependencyObject) |
| GetType() |
Geçerli örneğin Type alır. (Devralındığı yer: Object) |
| GetValue(DependencyProperty) |
Bir öğesinin bu örneğindeki bir bağımlılık özelliğinin DependencyObjectgeçerli etkin 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 Objectbasit 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, 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) |
| 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) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
türündeki DependencyObjectOnPropertyChanged(DependencyPropertyChangedEventArgs)değişen bağımlılık özelliğine yanıt olarak herhangi Changed bir işleyici çağırmak için uygulamasını Freezable 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 Freezable devralanları, 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) |
Bir 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 bir bağımlılık özelliğinin yerel değerini ayarlar. (Devralındığı yer: DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Bağımlılık özelliğinin tanımlayıcısı tarafından belirtilen salt okunur bağımlılık özelliğinin DependencyPropertyKey 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 gösteren bir değer döndürür. (Devralındığı yer: DependencyObject) |
| ToString() |
Geçerli kültüre göre bu nesnenin dize gösterimini oluşturur. (Devralındığı yer: ImageSource) |
| ToString(IFormatProvider) |
Geçirilen öğesini temel alarak bu nesnenin dize gösterimini IFormatProvider oluşturur. Sağlayıcı ise |
| VerifyAccess() |
Çağıran iş parçacığının bu DispatcherObjectöğesine erişmesini zorlar. (Devralındığı yer: DispatcherObject) |
| WritePostscript() |
Changed için Freezable olayını oluşturur ve yöntemini çağırırOnChanged(). öğesinden Freezable türetilen 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 devralanların, bağımlılık özellikleri olmayan veri üyelerine yazan herhangi bir API'nin başında bu yöntemi çağırması gerekir. (Devralındığı yer: Freezable) |
Ekinlikler
| Name | Description |
|---|---|
| Changed |
veya içerdiği bir nesne 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ı
| Name | Description |
|---|---|
| IFormattable.ToString(String, IFormatProvider) |
Belirtilen biçimi kullanarak geçerli örneğin değerini biçimlendirin. (Devralındığı yer: ImageSource) |
