BitmapDecoder BitmapDecoder BitmapDecoder BitmapDecoder Class

Definition

Stellt einen Container für Bitmapframes dar.Represents a container for bitmap frames. Jeder Bitmapframe ist eine BitmapSource.Each bitmap frame is a BitmapSource. Diese abstrakte Klasse stellt einen Basissatz an Funktionalität für alle abgeleiteten Decoderobjekte bereit.This abstract class provides a base set of functionality for all derived decoder objects.

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
Abgeleitet

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Create(Uri, BitmapCreateOptions, BitmapCacheOption) -Methode zum Erstellen eines Decoders für ein bestimmtes Bild verwendet wird.The following example demonstrates how to use the Create(Uri, BitmapCreateOptions, BitmapCacheOption) method to create a decoder for a given image. Der erste BitmapFrame des Bilds wird als Quelle Image eines-Steuer Elements verwendet.The first BitmapFrame of the image is used as the source of an Image control.

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 das integrierte TiffBitmapDecoder zum Öffnen und Decodieren einer Tagged Image File Format (TIFF)Tagged Image File Format (TIFF) Bitmap verwendet wird.The following code example demonstrates how to use the built in TiffBitmapDecoder to open and decode a Tagged Image File Format (TIFF)Tagged Image File Format (TIFF) bitmap. Das resultierende BitmapSource wird Source als eines Image Elements verwendet.The resulting BitmapSource is used as the Source of an Image element.


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

BitmapDecoderist kein BitmapFrame selbst, sondern ein Container für BitmapFrame -Objekte.BitmapDecoder is not a BitmapFrame itself; rather, it is a container for BitmapFrame objects. Jede BitmapFrame im Container kann möglicherweise über unterschiedliche Attribute verfügen, einschließlich unterschiedlicher Größen, Auflösungen oder Paletten.Each BitmapFrame in the container can potentially have different attributes, including different sizes, resolutions, or palettes.

Wenn kein bestimmter Codec ausgewählt ist, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) wird von die automatische Lauf Zeit Ermittlung verwendet, um das Format eines Bilds zu identifizieren und mit dem entsprechenden Codec abzugleichen.Unless a specific codec is selected, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) uses automatic run-time discovery to identify the format of an image and match it with the appropriate codec. Dieser Ermittlungs Vorgang ermöglicht das automatische Auffinden eines unabhängiger Softwarehersteller (independent software vendor, ISV)independent software vendor (ISV) von einem entwickelten Codecs durch das System.This discovery process allows a codec developed by an unabhängiger Softwarehersteller (independent software vendor, ISV)independent software vendor (ISV) to be automatically discoverable by the system. Um einen bestimmten Codec auszuwählen, sollte der BitmapDecoder abgeleitete oder BitmapEncoder, z TiffBitmapDecoder . b. die-Klasse, verwendet werden.To select a specific codec, the derived BitmapDecoder or BitmapEncoder, such as the TiffBitmapDecoder class, should be used.

Tagged Image File Format (TIFF)Tagged Image File Format (TIFF)und Graphics Interchange Format (GIF)Graphics Interchange Format (GIF) sind die einzigen implementierten Bildformate, die mehrere Frames unterstützen.and Graphics Interchange Format (GIF)Graphics Interchange Format (GIF) are the only implemented image formats that support multiple frames.

Konstruktoren

BitmapDecoder() BitmapDecoder() BitmapDecoder() BitmapDecoder()

Initialisiert eine neue Instanz von BitmapDecoder.Initializes a new instance of BitmapDecoder.

Eigenschaften

CodecInfo CodecInfo CodecInfo CodecInfo

Ruft Informationen ab, die diesen Codec beschreiben.Gets information that describes this codec.

ColorContexts ColorContexts ColorContexts ColorContexts

Ruft einen Wert ab, der das Farbprofil darstellt, das einer Bitmap zugeordnet ist, falls eine definiert ist.Gets a value that represents the color profile associated with a bitmap, if one is defined.

Dispatcher Dispatcher Dispatcher Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
Frames Frames Frames Frames

Ruft den Inhalt eines einzelnen Frames innerhalb einer Bitmap ab.Gets the content of an individual frame within a bitmap.

IsDownloading IsDownloading IsDownloading IsDownloading

Ruft einen Wert ab, der angibt, ob der Decoder gegenwärtig Inhalt herunterlädt.Gets a value that indicates if the decoder is currently downloading content.

Metadata Metadata Metadata Metadata

Ruft eine Instanz von BitmapMetadata ab, die die diesem Bitmap zugeordneten globalen Metadaten darstellt (sofern Metadaten definiert sind).Gets an instance of BitmapMetadata that represents the global metadata associated with this bitmap, if metadata is defined.

Palette Palette Palette Palette

Ruft die BitmapPalette ab, die diesem Decoder zugeordnet ist.Gets the BitmapPalette associated with this decoder.

Preview Preview Preview Preview

Ruft eine BitmapSource ab, die die globale Vorschau der Bitmap darstellt, sofern eine definiert ist.Gets a BitmapSource that represents the global preview of this bitmap, if one is defined.

Thumbnail Thumbnail Thumbnail Thumbnail

Ruft eine BitmapSource ab, die die Miniaturansicht der Bitmap darstellt, sofern eine definiert ist.Gets a BitmapSource that represents the thumbnail of the bitmap, if one is defined.

Methoden

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
Create(Stream, BitmapCreateOptions, BitmapCacheOption) Create(Stream, BitmapCreateOptions, BitmapCacheOption) Create(Stream, BitmapCreateOptions, BitmapCacheOption) Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Erstellt mithilfe der angegebenen BitmapDecoder und Stream einen BitmapCreateOptions aus einem BitmapCacheOption.Creates a BitmapDecoder from a Stream by using the specified BitmapCreateOptions and BitmapCacheOption.

Create(Uri, BitmapCreateOptions, BitmapCacheOption) Create(Uri, BitmapCreateOptions, BitmapCacheOption) Create(Uri, BitmapCreateOptions, BitmapCacheOption) Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Erstellt mithilfe der angegebenen BitmapDecoder und Uri einen BitmapCreateOptions aus einem BitmapCacheOption.Creates a BitmapDecoder from a Uri by using the specified BitmapCreateOptions and BitmapCacheOption.

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Erstellt mithilfe der angegebenen BitmapDecoder, der angegebenen Uri und der angegebenen BitmapCreateOptions einen BitmapCacheOption aus einem RequestCachePolicy.Creates a BitmapDecoder from a Uri by using the specified BitmapCreateOptions, BitmapCacheOption and RequestCachePolicy.

CreateInPlaceBitmapMetadataWriter() CreateInPlaceBitmapMetadataWriter() CreateInPlaceBitmapMetadataWriter() CreateInPlaceBitmapMetadataWriter()

Erstellt eine Instanz von InPlaceBitmapMetadataWriter, die verwendet werden kann, um die Metadaten einer Bitmap zu aktualisieren.Creates an instance of InPlaceBitmapMetadataWriter, which can be used to update the metadata of a bitmap.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Gibt Ressourcen frei und führt andere Bereinigungsvorgänge durch, bevor das BitmapDecoder durch die Garbage Collection wieder freigegeben wird.Frees resources and performs other cleanup operations before the BitmapDecoder is reclaimed by garbage collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Konvertiert den aktuellen Wert eines BitmapDecoder in einen String.Converts the current value of a BitmapDecoder to a String.

VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Ereignisse

DownloadCompleted DownloadCompleted DownloadCompleted DownloadCompleted

Tritt auf, wenn der Download von Bitmapinhalt von einem BitmapDecoder beendet wurde.Occurs when a BitmapDecoder has finished downloading bitmap content.

DownloadFailed DownloadFailed DownloadFailed DownloadFailed

Tritt auf, wenn Bitmapinhalt nicht heruntergeladen werden konnte.Occurs when bitmap content failed to download.

DownloadProgress DownloadProgress DownloadProgress DownloadProgress

Tritt auf, wenn sich der Status des Downloadvorgangs für Bitmapinhalt von einem BitmapDecoder geändert wird.Occurs when a BitmapDecoder has made progress downloading bitmap content.

Gilt für:

Siehe auch