Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen

Übersetzung

Original

Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

BitmapDecoder-Klasse

.NET Framework 4.5

Andere Versionen

Stellt einen Container für Bitmap-Frames dar. Jeder Bitmap-Frame ist eine BitmapSource. Diese abstrakte Klasse stellt grundlegende Funktionen für alle abgeleiteten Decoderobjekte bereit.

Vererbungshierarchie

Namespace: System.Windows.Media.Imaging
Assembly: PresentationCore (in PresentationCore.dll)

Syntax

C++

public abstract class BitmapDecoder : DispatcherObject

Der BitmapDecoder-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	BitmapDecoder	Initialisiert eine neue Instanz von BitmapDecoder.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	CodecInfo	Ruft Informationen ab, die diesen Codec beschreiben.
	ColorContexts	Ruft einen Wert ab, der das einer Bitmap zugeordnete Farbprofil darstellt (sofern definiert).
	Dispatcher	Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Von DispatcherObject geerbt.)
	Frames	Ruft den Inhalt eines einzelnen Frames in einer Bitmap ab.
	IsDownloading	Ruft einen Wert ab, der angibt, ob der Decoder gegenwärtig Inhalt herunterlädt.
	Metadata	Ruft eine Instanz von BitmapMetadata ab, die die globalen Metadaten darstellt, die dieser Bitmap zugeordnet sind, sofern Metadaten definiert sind.
	Palette	Ruft die dem Decoder zugeordnete BitmapPalette ab.
	Preview	Ruft eine BitmapSource ab, die die globale Vorschau dieser Bitmap darstellt (sofern definiert).
	Thumbnail	Ruft eine BitmapSource ab, die die Miniaturansicht der Bitmap darstellt (sofern definiert).

Zum Seitenanfang

Methoden

	Name	Beschreibung
	CheckAccess	Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.)
	Create(Stream, BitmapCreateOptions, BitmapCacheOption)	Erstellt mithilfe der angegebenen BitmapCreateOptions und BitmapCacheOption einen BitmapDecoder aus einem Stream.
	Create(Uri, BitmapCreateOptions, BitmapCacheOption)	Erstellt mithilfe der angegebenen BitmapCreateOptions und BitmapCacheOption einen BitmapDecoder aus einem Uri.
	Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)	Erstellt mithilfe der angegebenen BitmapCreateOptions, der angegebenen BitmapCacheOption und der angegebenen RequestCachePolicy einen BitmapDecoder aus einem Uri.
	CreateInPlaceBitmapMetadataWriter	Erstellt eine Instanz von InPlaceBitmapMetadataWriter, die zum Aktualisieren der Metadaten einer Bitmap verwendet werden kann.
	Equals(Object)	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	Finalize	Gibt Ressourcen frei und führt andere Bereinigungsvorgänge durch, bevor das BitmapDecoder durch die Garbage Collection wieder zugänglich gemacht wird. (Überschreibt Object.Finalize().)
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	ToString	Konvertiert den aktuellen Wert eines BitmapDecoder in einen String. (Überschreibt Object.ToString().)
	VerifyAccess	Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.)

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	DownloadCompleted	Tritt ein, wenn ein BitmapDecoder den Download von Bitmap-Inhalt abgeschlossen hat.
	DownloadFailed	Tritt ein, wenn der Bitmap-Inhalt nicht heruntergeladen werden konnte.
	DownloadProgress	Tritt ein, wenn das Herunterladen von Bitmap-Inhalt durch einen BitmapDecoder fortgeschritten ist.

Zum Seitenanfang

Hinweise

BitmapDecoder selbst ist kein BitmapFrame, sondern ein Container für BitmapFrame-Objekte. Jeder BitmapFrame im Container kann über unterschiedliche Attribute, z. B. unterschiedliche Größen, Auflösungen oder Paletten, verfügen.

Wenn kein bestimmter Codec ausgewählt wird, bezeichnet Windows Presentation Foundation (WPF) das Format eines Bilds automatisch zur Laufzeit und ordnet es dem entsprechenden Codec zu. Im Rahmen dieser Erkennung kann ein von einem unabhängiger Softwareanbieter (independent software vendor, ISV) entwickelter Codec automatisch vom System erkannt 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.

Beispiele

Das folgende Beispiel veranschaulicht, wie die Create(Uri, BitmapCreateOptions, BitmapCacheOption)-Methode zum Erstellen eines Decoders für ein angegebenes Bild verwendet wird. Der erste BitmapFrame des Bilds 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];

Im folgenden Codebeispiel wird veranschaulicht, wie der integrierte TiffBitmapDecoder zum Öffnen und Decodieren einer Tagged Image File Format (TIFF)-Bitmap verwendet wird. Die resultierende BitmapSource wird als Source eines Image-Elements 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);

Versionsinformationen

.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Plattformen

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

System.Windows.Media.Imaging-Namespace

Weitere Ressourcen

Übersicht über die Bildverarbeitung

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN