BitmapFrame Klasse

Referenz

Definition

Namespace:: System.Windows.Media.Imaging

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt Bilddaten dar, die von einem Decoder zurückgegeben und von Encodern akzeptiert werden.

public ref class BitmapFrame abstract : System::Windows::Media::Imaging::BitmapSource, System::Windows::Markup::IUriContext

public abstract class BitmapFrame : System.Windows.Media.Imaging.BitmapSource, System.Windows.Markup.IUriContext

type BitmapFrame = class
    inherit BitmapSource
    interface IUriContext

Public MustInherit Class BitmapFrame
Inherits BitmapSource
Implements IUriContext

Vererbung: Object

DispatcherObject

DependencyObject

Freezable

Animatable

ImageSource

BitmapSource
BitmapFrame

Implementiert: IUriContext

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine neue BitmapSource mithilfe von BitmapFrameerstellt wird.

int width = 128;
int height = width;
int stride = width/8;
byte[] pixels = new byte[height*stride];

// Try creating a new image with a custom palette.
List<System.Windows.Media.Color> colors = new List<System.Windows.Media.Color>();
colors.Add(System.Windows.Media.Colors.Red);
colors.Add(System.Windows.Media.Colors.Blue);
colors.Add(System.Windows.Media.Colors.Green);
BitmapPalette myPalette = new BitmapPalette(colors);

// Creates a new empty image with the pre-defined palette

BitmapSource image = BitmapSource.Create(
    width,
    height,
    96,
    96,
    PixelFormats.Indexed1,
    myPalette, 
    pixels, 
    stride);

FileStream stream = new FileStream("empty.tif", FileMode.Create);
TiffBitmapEncoder encoder = new TiffBitmapEncoder();
TextBlock myTextBlock = new TextBlock();
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString();
encoder.Frames.Add(BitmapFrame.Create(image));
MessageBox.Show(myPalette.Colors.Count.ToString());
encoder.Save(stream);

Dim width As Integer = 128
Dim height As Integer = width
Dim stride As Integer = CType(width / 8, Integer)
Dim pixels(height * stride) As Byte

' Try creating a new image with a custom palette.
Dim colors As New List(Of System.Windows.Media.Color)()
colors.Add(System.Windows.Media.Colors.Red)
colors.Add(System.Windows.Media.Colors.Blue)
colors.Add(System.Windows.Media.Colors.Green)
Dim myPalette As New BitmapPalette(colors)

' Creates a new empty image with the pre-defined palette
Dim image As BitmapSource = System.Windows.Media.Imaging.BitmapSource.Create(width, height, 96, 96, PixelFormats.Indexed1, myPalette, pixels, stride)
Dim stream As New FileStream("empty.tif", FileMode.Create)
Dim encoder As New TiffBitmapEncoder()
Dim myTextBlock As New TextBlock()
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString()
encoder.Frames.Add(BitmapFrame.Create(image))
MessageBox.Show(myPalette.Colors.Count.ToString())
encoder.Save(stream)

Im folgenden Codebeispiel wird veranschaulicht, wie Sie das BitmapFrame -Objekt verwenden, um eine PNG-Grafik (Portable Network Graphics) zu öffnen und Metadaten mithilfe der CreateInPlaceBitmapMetadataWriter -Methode zu schreiben.

Stream^ pngStream = gcnew FileStream("smiley.png", FileMode::Open, FileAccess::ReadWrite, FileShare::ReadWrite);
PngBitmapDecoder^ pngDecoder = gcnew PngBitmapDecoder(pngStream, BitmapCreateOptions::PreservePixelFormat, BitmapCacheOption::Default);
BitmapFrame^ pngFrame = pngDecoder->Frames[0];
InPlaceBitmapMetadataWriter^ pngInplace = pngFrame->CreateInPlaceBitmapMetadataWriter();
if (pngInplace->TrySave() == true)
{
   pngInplace->SetQuery("/Text/Description", "Have a nice day.");
}
pngStream->Close();

Stream pngStream = new System.IO.FileStream("smiley.png", FileMode.Open, FileAccess.ReadWrite, FileShare.ReadWrite);
PngBitmapDecoder pngDecoder = new PngBitmapDecoder(pngStream, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapFrame pngFrame = pngDecoder.Frames[0];
InPlaceBitmapMetadataWriter pngInplace = pngFrame.CreateInPlaceBitmapMetadataWriter();
if (pngInplace.TrySave() == true)
{ pngInplace.SetQuery("/Text/Description", "Have a nice day."); }
pngStream.Close();

Dim pngStream As New System.IO.FileStream("smiley.png", FileMode.Open, FileAccess.ReadWrite, FileShare.ReadWrite)
Dim pngDecoder As New PngBitmapDecoder(pngStream, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim pngFrame As BitmapFrame = pngDecoder.Frames(0)
Dim pngInplace As InPlaceBitmapMetadataWriter = pngFrame.CreateInPlaceBitmapMetadataWriter()
If pngInplace.TrySave() = True Then
    pngInplace.SetQuery("/Text/Description", "Have a nice day.")
End If
pngStream.Close()

Hinweise

BitmapFrame stellt zusätzliche Funktionen bereit, die nicht durch definiert werden BitmapSource , indem Zugriff auf die bereitgestellt wird, die Thumbnail einem bestimmten Frame eines Bilds zugeordnet ist. BitmapFrame unterstützt auch das Schreiben von Metadateninformationen mithilfe der Metadata -Eigenschaft oder der CreateInPlaceBitmapMetadataWriter -Methode.

Alle BitmapFrame von einem Decoder zurückgegebenen werden immer eingefroren. Wenn Sie eine änderbare Kopie benötigen, müssen Sie zunächst mithilfe der Clone -Methode eine Kopie von BitmapFrame erstellen.

Nur Tagged Image File Format (TIFF) und Gif-Format (Graphics Interchange Format) unterstützen mehrere Frames.

Konstruktoren

BitmapFrame()

Initialisiert eine neue Instanz der BitmapFrame-Klasse.

Eigenschaften

BaseUri	Ruft beim Überschreiben in einer abgeleiteten Klasse einen Wert ab, der den Basis-Uri des aktuellen Kontexts darstellt.
CanFreeze	Ruft einen Wert ab, der anzeigt, ob das Objekt als nicht änderbar festgelegt werden kann. (Geerbt von Freezable)
ColorContexts	Ruft beim Überschreiben in einer abgeleiteten Klasse eine Auflistung von ColorContext-Objekten ab, die diesem BitmapFrame zugeordnet werden.
Decoder	Ruft beim Überschreiben in einer abgeleiteten Klasse den dieser Instanz von BitmapFrame zugeordneten Decoder ab.
DependencyObjectType	Ruft den ab, der DependencyObjectType den CLR-Typ dieses instance umschließt. (Geerbt von DependencyObject)
Dispatcher	Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
DpiX	Ruft die horizontalen Punkte pro Zoll (dpi) des Bilds ab. (Geerbt von BitmapSource)
DpiY	Ruft die vertikalen Punkte pro Zoll (dpi) des Bilds ab. (Geerbt von BitmapSource)
Format	Ruft das systemeigene PixelFormat der Bitmapdaten ab. (Geerbt von BitmapSource)
HasAnimatedProperties	Ruft einen Wert ab, der angibt, ob einer der Abhängigkeitseigenschaften dieses Objekts ein oder mehrere AnimationClock-Objekte zugeordnet sind. (Geerbt von Animatable)
Height	Ruft die Höhe der Quellbitbitbit in geräteunabhängigen Einheiten (1/96 Zoll pro Einheit) ab. (Geerbt von BitmapSource)
IsDownloading	Ruft einen Wert ab, der angibt, ob der BitmapSource-Inhalt gegenwärtig heruntergeladen wird. (Geerbt von BitmapSource)
IsFrozen	Ruft einen Wert ab, der angibt, ob das Objekt derzeit geändert werden kann. (Geerbt von Freezable)
IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Geerbt von DependencyObject)
Metadata	Ruft die Metadaten ab, die diesem Bitmap-Bild zugeordnet sind. (Geerbt von BitmapSource)
Palette	Ruft die Farbpalette der Bitmap ab (sofern angegeben). (Geerbt von BitmapSource)
PixelHeight	Ruft die Höhe der Bitmap in Pixeln ab. (Geerbt von BitmapSource)
PixelWidth	Ruft die Breite der Bitmap in Pixeln ab. (Geerbt von BitmapSource)
Thumbnail	Ruft beim Überschreiben in einer abgeleiteten Klasse das Miniaturbild ab, das diesem BitmapFrame zugeordnet ist.
Width	Ruft die Breite der Bitmap in geräteunabhängigen Einheiten (1/96 Zoll pro Einheit) ab. (Geerbt von BitmapSource)

Methoden

ApplyAnimationClock(DependencyProperty, AnimationClock)	Wendet einen AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. (Geerbt von Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Wendet einen AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. (Geerbt von Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Wendet eine Animation auf die angegebene DependencyProperty an. Die Animation wird gestartet, wenn der nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. (Geerbt von Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Wendet eine Animation auf die angegebene DependencyProperty an. Die Animation wird gestartet, wenn der nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. (Geerbt von Animatable)
CheckAccess()	Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)
CheckIfSiteOfOrigin()	Überprüft, ob der Inhalt der Bitmapquelle aus einer bekannten Ursprungssite stammt. Diese Methode wird verwendet, um sicherzustellen, dass das Kopieren von Pixeln sicher ist. (Geerbt von BitmapSource)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben. (Geerbt von DependencyObject)
Clone()	Erstellt einen änderbaren Klon dieser BitmapSource, indem tiefe Kopien der Werte dieses Objekts erzeugt werden. Beim Kopieren von Abhängigkeitseigenschaften kopiert diese Methode Ressourcenverweise und Datenbindungen (die aber möglicherweise nicht mehr aufgelöst werden können), jedoch keine Animationen oder ihre aktuellen Werte. (Geerbt von BitmapSource)
CloneCore(Freezable)	Macht diese Instanz zu einer tiefen Kopie der angegebenen BitmapSource. Beim Kopieren von Abhängigkeitseigenschaften kopiert diese Methode Ressourcenverweise und Datenbindungen (die aber möglicherweise nicht mehr aufgelöst werden können), jedoch keine Animationen oder ihre aktuellen Werte. (Geerbt von BitmapSource)
CloneCurrentValue()	Erstellt einen änderbaren Klon des BitmapSource-Objekts, indem tiefe Kopien der aktuellen Werte dieses Objekts erzeugt werden. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, ihre aktuellen Werte werden jedoch kopiert. (Geerbt von BitmapSource)
CloneCurrentValueCore(Freezable)	Macht diese Instanz mithilfe aktueller Eigenschaftswerte zu einer tiefen Kopie der angegebenen BitmapSource, die geändert werden kann. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, ihre aktuellen Werte werden jedoch kopiert. (Geerbt von BitmapSource)
CoerceValue(DependencyProperty)	Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird. (Geerbt von DependencyObject)
CopyPixels(Array, Int32, Int32)	Kopiert die Bitmap-Pixeldaten ab dem angegebenen Offset in ein Array von Pixeln mit dem angegebenen Schritt. (Geerbt von BitmapSource)
CopyPixels(Int32Rect, Array, Int32, Int32)	Kopiert die Bitmap-Pixeldaten in dem angegebenen Rechteck ab dem angegebenen Offset in ein Array von Pixeln mit dem angegebenen Schritt. (Geerbt von BitmapSource)
CopyPixels(Int32Rect, IntPtr, Int32, Int32)	Kopiert die Bitmap-Pixeldaten im angegebenen Rechteck. (Geerbt von BitmapSource)
Create(BitmapSource)	Erstellt einen neuen BitmapFrame aus einer bestimmten BitmapSource.
Create(BitmapSource, BitmapSource)	Erstellt einen neuen BitmapFrame mit der angegebenen Miniaturansicht aus einer angegebenen BitmapSource.
Create(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)	Erstellt einen neuen BitmapFrame aus einer bestimmten BitmapSource mit der angegebenen Miniaturansicht, den angegebenen BitmapMetadata und dem angegebenen ColorContext.
Create(Stream)	Erstellt einen neuen BitmapFrame aus einer bestimmten Stream.
Create(Stream, BitmapCreateOptions, BitmapCacheOption)	Erstellt einen neuen BitmapFrame aus einem angegebenen Stream mit den angegebenen BitmapCreateOptions und der angegebenen BitmapCacheOption.
Create(Uri)	Erstellt einen neuen BitmapFrame aus einer bestimmten Uri.
Create(Uri, BitmapCreateOptions, BitmapCacheOption)	Erstellt einen BitmapFrame aus einem angegebenen Uri mit den angegebenen BitmapCreateOptions und der angegebenen BitmapCacheOption.
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)	Erstellt einen BitmapFrame aus einem angegebenen Uri mit den angegebenen BitmapCreateOptions, der angegebenen BitmapCacheOption und der angegebenen RequestCachePolicy.
Create(Uri, RequestCachePolicy)	Erstellt einen BitmapFrame aus einem angegebenen Uri mit der angegebenen RequestCachePolicy.
CreateInPlaceBitmapMetadataWriter()	Erstellt beim Überschreiben in einer abgeleiteten Klasse eine Instanz des InPlaceBitmapMetadataWriter, die verwendet werden kann, um einem BitmapFrame Metadaten zuzuordnen.
CreateInstance()	Initialisiert eine neue Instanz der Freezable-Klasse. (Geerbt von Freezable)
CreateInstanceCore()	Erstellt beim Implementieren in einer abgeleiteten Klasse eine neue Instanz der abgeleiteten Freezable-Klasse. (Geerbt von Freezable)
Equals(Object)	Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Geerbt von DependencyObject)
Freeze()	Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf `true` fest. (Geerbt von Freezable)
FreezeCore(Boolean)	Legt eine Instanz von BitmapSource oder einer abgeleiteten Klasse als unveränderlich fest. (Geerbt von BitmapSource)
GetAnimationBaseValue(DependencyProperty)	Gibt den nicht animierten Wert der angegebenen DependencyProperty zurück. (Geerbt von Animatable)
GetAsFrozen()	Erstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert). Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Geerbt von Freezable)
GetAsFrozenCore(Freezable)	Macht diese Instanz zu einem Klon des angegebenen BitmapSource-Objekts. (Geerbt von BitmapSource)
GetCurrentValueAsFrozen()	Erstellt eine fixierte Kopie von Freezable mit aktuellen Eigenschaftswerten. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Geerbt von Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Macht diese Instanz zu einem fixierten Klon des angegebenen BitmapSource-Objekts. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, ihre aktuellen Werte werden jedoch kopiert. (Geerbt von BitmapSource)
GetHashCode()	Ruft einen Hashcode für diese DependencyObject ab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Geerbt von DependencyObject)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück. (Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnChanged()	Wird aufgerufen, wenn das aktuelle Freezable-Objekt geändert wird. (Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Stellt sicher, dass entsprechende Kontextzeiger für einen gerade festgelegten DependencyObjectType-Datenmember eingerichtet werden. (Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Dieses Member unterstützt die Windows Presentation Foundation -Infrastruktur (WPF) und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Überschreibt die DependencyObject-Implementierung von OnPropertyChanged(DependencyPropertyChangedEventArgs), damit in Reaktion auf eine geänderte Abhängigkeitseigenschaft des Typs Freezable auch Changed-Handler aufgerufen werden. (Geerbt von Freezable)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist. (Geerbt von DependencyObject)
ReadPreamble()	Stellt sicher, dass über einen gültigen Thread auf Freezable zugegriffen wird. Vererber von Freezable müssen diese Methode am Anfang jeder API aufrufen, die Datenmember liest, bei denen es sich nicht um Abhängigkeitseigenschaften handelt. (Geerbt von Freezable)
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist. (Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)	Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist. (Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
ToString()	Erstellt eine Zeichenfolgendarstellung dieses Objekts auf der Grundlage der aktuellen Kultur. (Geerbt von ImageSource)
ToString(IFormatProvider)	Erstellt eine Zeichenfolgendarstellung dieses Objekts auf Grundlage des übergebenen IFormatProvider. Wenn der Anbieter `null` ist, wird CurrentCulture verwendet. (Geerbt von ImageSource)
VerifyAccess()	Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)
WritePostscript()	Löst das Changed-Ereignis für das Freezable-Objekt aus und ruft dessen OnChanged()-Methode auf. Klassen, die aus Freezable abgeleitet werden, sollten diese Methode am Ende jeder API aufrufen, die Klassenmember ändert, die nicht als Abhängigkeitseigenschaften gespeichert sind. (Geerbt von Freezable)
WritePreamble()	Stellt sicher, dass das Freezable nicht fixiert ist und dass über einen gültigen Threadkontext darauf zugegriffen wird. Vererber von Freezable sollten diese Methode am Anfang jeder API aufrufen, die Datenmember schreibt, bei denen es sich nicht um Abhängigkeitseigenschaften handelt. (Geerbt von Freezable)

Ereignisse

Changed	Tritt auf, wenn Freezable oder ein darin enthaltenes Objekt geändert wird. (Geerbt von Freezable)
DecodeFailed	Tritt auf, wenn das Bild aufgrund eines fehlerhaften Bildheaders nicht geladen werden kann. (Geerbt von BitmapSource)
DownloadCompleted	Tritt auf, wenn der Bitmapinhalt vollständig heruntergeladen wurde. (Geerbt von BitmapSource)
DownloadFailed	Tritt auf, wenn der Bitmapinhalt nicht heruntergeladen werden konnte. (Geerbt von BitmapSource)
DownloadProgress	Tritt auf, wenn sich der Status beim Herunterladen des Bitmapinhalts geändert hat. (Geerbt von BitmapSource)

Explizite Schnittstellenimplementierungen

IFormattable.ToString(String, IFormatProvider)

Formatiert den Wert der aktuellen Instanz mit dem angegebenen Format.

(Geerbt von ImageSource)

Gilt für: