BitmapDecoder Klasse

Definition

Namespace:
System.Windows.Media.Imaging
Assembly:
PresentationCore.dll

Stellt einen Container für Bitmapframes dar. Jeder Bitmapframe ist ein BitmapSource. Diese abstrakte Klasse stellt eine Basisfunktion für alle abgeleiteten Decoderobjekte bereit.

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
Vererbung
Object
DispatcherObject
BitmapDecoder
Abgeleitet

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Methode zum Erstellen eines Decoders für ein bestimmtes Bild verwendet Create(Uri, BitmapCreateOptions, BitmapCacheOption) wird. Das erste BitmapFrame Bild wird als Quelle eines Image Steuerelements verwendet.

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)

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die integrierte TiffBitmapDecoder Bitmap verwenden, um eine Tagged Image File Format (TIFF)-Bitmap zu öffnen und zu decodieren. Das Ergebnis BitmapSource wird als Source Element Image verwendet.


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

Hinweise

BitmapDecoder ist nicht selbst, BitmapFrame sondern ein Container für BitmapFrame Objekte. Jeder BitmapFrame im Container kann möglicherweise unterschiedliche Attribute aufweisen, einschließlich unterschiedlicher Größen, Auflösungen oder Paletten.

Sofern kein bestimmter Codec ausgewählt ist, verwendet Windows Presentation Foundation (WPF) die automatische Laufzeitermittlung, um das Format eines Bilds zu identifizieren und mit dem entsprechenden Codec übereinzugleichen. Dieser Ermittlungsprozess ermöglicht es einem Codec, der von einem unabhängigen Softwareanbieter (ISV) entwickelt wurde, automatisch vom System auffindbar zu werden. Um einen bestimmten Codec auszuwählen, sollte der abgeleitete BitmapDecoder oder BitmapEncoder, z. B. die TiffBitmapDecoder Klasse, verwendet werden.

Tagged Image File Format (TIFF) und Graphics Interchange Format (GIF) sind die einzigen implementierten Bildformate, die mehrere Frames unterstützen.

Konstruktoren

Name Beschreibung
BitmapDecoder()

Initialisiert eine neue instance von BitmapDecoder.

Eigenschaften

Name Beschreibung
CodecInfo

Ruft Informationen ab, die diesen Codec beschreiben.
ColorContexts

Ruft einen Wert ab, der das Farbprofil darstellt, das einer Bitmap zugeordnet ist, wenn eine definiert ist.
Dispatcher

Ruft dies Dispatcher ab, dem dies DispatcherObject zugeordnet ist.

(Geerbt von DispatcherObject)
Frames

Ruft den Inhalt eines einzelnen Frames innerhalb einer Bitmap ab.
IsDownloading

Ruft einen Wert ab, der angibt, ob der Decoder derzeit Inhalte herunter lädt.
Metadata

Ruft eine Instanz davon ab, die BitmapMetadata die globalen Metadaten darstellt, die dieser Bitmap zugeordnet sind, wenn Metadaten definiert sind.
Palette

Ruft den BitmapPalette diesem Decoder zugeordneten ab.
Preview

Ruft eine BitmapSource , die die globale Vorschau dieser Bitmap darstellt, wenn eine definiert ist.
Thumbnail

Ruft ein BitmapSource , das die Miniaturansicht der Bitmap darstellt, wenn eine definiert ist.

Methoden

Name Beschreibung
CheckAccess()

Bestimmt, ob der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat.

(Geerbt von DispatcherObject)
Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Erstellt ein Aus BitmapDecoder einer Stream mithilfe der angegebenen BitmapCreateOptions und BitmapCacheOption.
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Erstellt ein Aus BitmapDecoder einer Uri mithilfe des angegebenen BitmapCreateOptionsund BitmapCacheOptionRequestCachePolicy.
Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Erstellt ein Aus BitmapDecoder einer Uri mithilfe der angegebenen BitmapCreateOptions und BitmapCacheOption.
CreateInPlaceBitmapMetadataWriter()

Erstellt eine Instanz von InPlaceBitmapMetadataWriter, die zum Aktualisieren der Metadaten einer Bitmap verwendet werden kann.
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
Finalize()

Gibt Ressourcen frei und führt andere Bereinigungsvorgänge aus, bevor die BitmapDecoder Garbage Collection zurückgefordert wird.
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Konvertiert den aktuellen Wert eines in BitmapDecoder ein String.
VerifyAccess()

Erzwingt, dass der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat.

(Geerbt von DispatcherObject)

Ereignisse

Name Beschreibung
DownloadCompleted

Tritt auf, wenn der Download von BitmapDecoder Bitmapinhalten abgeschlossen ist.
DownloadFailed

Tritt auf, wenn Der Bitmapinhalt nicht heruntergeladen werden konnte.
DownloadProgress

Tritt auf, wenn ein BitmapDecoder Fortschritt beim Herunterladen von Bitmapinhalten vorgenommen wurde.

Gilt für:

Weitere Informationen