BitmapDecoder Sınıf

Tanım

Bit eşlem çerçeveleri için bir kapsayıcıyı temsil eder. Her bit eşlem çerçevesi bir BitmapSourceşeklindedir. Bu soyut sınıf, türetilmiş tüm kod çözücü nesneleri için temel bir işlev kümesi sağlar.

public ref class BitmapDecoder abstract : System::Windows::Threading::DispatcherObject
public abstract class BitmapDecoder : System.Windows.Threading.DispatcherObject
type BitmapDecoder = class
    inherit DispatcherObject
Public MustInherit Class BitmapDecoder
Inherits DispatcherObject
Devralma
BitmapDecoder
Türetilmiş

Örnekler

Aşağıdaki örnekte, belirli bir görüntü için kod çözücü oluşturmak için yönteminin nasıl kullanılacağı Create(Uri, BitmapCreateOptions, BitmapCacheOption) gösterilmektedir. Görüntünün ilki BitmapFrame bir Image denetimin kaynağı olarak kullanılır.

BitmapDecoder uriBitmap = BitmapDecoder.Create(
   new Uri("sampleImages/waterlilies.jpg", UriKind.Relative),
   BitmapCreateOptions.None,
   BitmapCacheOption.Default);

// Create an image element;
Image uriImage = new Image();
uriImage.Width = 200;
// Set image source.
uriImage.Source = uriBitmap.Frames[0];
Dim uriBitmap As BitmapDecoder = BitmapDecoder.Create(New Uri("sampleImages/waterlilies.jpg", UriKind.Relative), BitmapCreateOptions.None, BitmapCacheOption.Default)

' Create an image element;
Dim uriImage As New Image()
uriImage.Width = 200
' Set image source.
uriImage.Source = uriBitmap.Frames(0)

Aşağıdaki kod örneği, Etiketli Görüntü Dosya Biçimi (TIFF) bit eşlemini açmak ve kodunu çözmek için yerleşik TiffBitmapDecoder öğesinin nasıl kullanılacağını gösterir. BitmapSource Sonuçta elde edilen öğe Image olarak Source kullanılır.


// Open a Stream and decode a TIFF image
Stream imageStreamSource = new FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read);
TiffBitmapDecoder decoder = new TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource = decoder.Frames[0];

// Draw the Image
Image myImage1 = new Image();
myImage1.Source = bitmapSource;
myImage1.Stretch = Stretch.None;
myImage1.Margin = new Thickness(20);
' Open a Stream and decode a TIFF image
Dim imageStreamSource As New FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim decoder As New TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource As BitmapSource = decoder.Frames(0)

' Draw the Image
Dim myImage1 As New Image()
myImage1.Source = bitmapSource
myImage1.Stretch = Stretch.None
myImage1.Margin = New Thickness(20)

Açıklamalar

BitmapDecoder kendisi değildir BitmapFrame ; bunun yerine nesneler için BitmapFrame bir kapsayıcıdır. Kapsayıcıdaki her BitmapFrame bir öğe farklı boyutlar, çözünürlükler veya paletler gibi farklı özniteliklere sahip olabilir.

Belirli bir codec seçilmediği sürece, Windows Presentation Foundation (WPF) görüntünün biçimini tanımlamak ve uygun codec ile eşleştirmek için otomatik çalışma zamanı bulma kullanır. Bu bulma işlemi, bağımsız bir yazılım satıcısı (ISV) tarafından geliştirilen bir codec'in sistem tarafından otomatik olarak bulunabilir olmasını sağlar. Belirli bir codec'i seçmek için türetilmiş BitmapDecoder veya BitmapEncodersınıfı gibi TiffBitmapDecoder kullanılmalıdır.

Etiketli Görüntü Dosya Biçimi (TIFF) ve Grafik Değişim Biçimi (GIF), birden çok kareyi destekleyen tek uygulanan görüntü biçimleridir.

Oluşturucular

BitmapDecoder()

öğesinin yeni bir örneğini BitmapDecoderbaşlatır.

Özellikler

CodecInfo

Bu codec bileşenini açıklayan bilgileri alır.

ColorContexts

Tanımlanmışsa, bit eşlem ile ilişkili renk profilini temsil eden bir değer alır.

Dispatcher

Dispatcher Bunun DispatcherObject ilişkili olduğunu alır.

(Devralındığı yer: DispatcherObject)
Frames

Bit eşlem içindeki tek bir çerçevenin içeriğini alır.

IsDownloading

Kod çözücüün şu anda içerik indirip indirmediğini belirten bir değer alır.

Metadata

Meta veriler tanımlanmışsa, bu bit eşlemle ilişkili genel meta verileri temsil eden bir örneğini BitmapMetadata alır.

Palette

Bu kod çözücüyle ilişkili öğesini BitmapPalette alır.

Preview

BitmapSource Tanımlanmışsa, bu bit eşlem genel önizlemesini temsil eden bir alır.

Thumbnail

BitmapSource Tanımlanmışsa bit eşlem küçük resmini temsil eden bir alır.

Yöntemler

CheckAccess()

Çağıran iş parçacığının bu DispatcherObjectöğesine erişimi olup olmadığını belirler.

(Devralındığı yer: DispatcherObject)
Create(Stream, BitmapCreateOptions, BitmapCacheOption)

belirtilen BitmapCreateOptions ve BitmapCacheOptionkullanarak a'dan Stream oluştururBitmapDecoder.

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

belirtilen BitmapCreateOptions ve BitmapCacheOptionkullanarak a'dan Uri oluştururBitmapDecoder.

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Belirtilen BitmapCreateOptionsve BitmapCacheOption RequestCachePolicykullanarak a'dan oluşturur.BitmapDecoder Uri

CreateInPlaceBitmapMetadataWriter()

bit eşlem meta InPlaceBitmapMetadataWriterverilerini güncelleştirmek için kullanılabilecek bir örneği oluşturur.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
Finalize()

kaynakları serbest kaldırır ve çöp toplama tarafından geri kazanılmadan önce BitmapDecoder diğer temizleme işlemlerini gerçekleştirir.

GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

geçerli değerini değerine BitmapDecoder Stringdönüştürür.

VerifyAccess()

Çağıran iş parçacığının bu DispatcherObjecterişimine sahip olmasını zorlar.

(Devralındığı yer: DispatcherObject)

Ekinlikler

DownloadCompleted

BitmapDecoder Bit eşlem içeriğinin indirilmesi tamamlandığında gerçekleşir.

DownloadFailed

Bit eşlem içeriği indirilemediğinde gerçekleşir.

DownloadProgress

bit eşlem içeriği indirilirken ilerleme kaydedildiğinde BitmapDecoder gerçekleşir.

Şunlara uygulanır

Ayrıca bkz.