SoftwareBitmapSource Klasse

Definition

Namespace:

Windows.UI.Xaml.Media.Imaging

Stellt ein Quellobjekt bereit, das durch eine SoftwareBitmap unterstützt wird, für Eigenschaften, die eine Bildquelle im Bitmapformat verwenden.

public ref class SoftwareBitmapSource sealed : ImageSource, IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class SoftwareBitmapSource final : ImageSource, IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SoftwareBitmapSource : ImageSource, System.IDisposable

Public NotInheritable Class SoftwareBitmapSource
Inherits ImageSource
Implements IDisposable

Vererbung

Object Platform::Object IInspectable DependencyObject ImageSource SoftwareBitmapSource

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IClosable IDisposable

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Mit SoftwareBitmapSource können Sie eine SoftwareBitmap als Bildquelle verwenden, die mithilfe eines ImageBrush-Steuerelements oder direkt in einem Image-Steuerelement angezeigt werden kann. Sie können beispielsweise eine SoftwareBitmapSource verwenden, um ein Foto anzuzeigen, das gerade von der Kamera eines Geräts mit der LowLagPhotoCapture-Klasse aufgenommen wurde, um ein Bild anzuzeigen, das Sie manuell mit der BitmapDecoder.GetSoftwareBitmapAsync-Methode decodiert haben, oder um eine benutzerdefinierte IWICBitmap in erweiterten C++-Szenarien anzuzeigen, in denen Sie den Bildspeicher manuell verwalten möchten.

Eine softwareBitmap , die in einer XAML-App angezeigt wird, muss im BGRA-Pixelformat mit vorab multiplizierten Alphawerten vorliegen.

Eine SoftwareBitmap speichert in der Regel unkomprimierte Bilddaten. Dies bedeutet, dass es eine große Menge an Systemspeicher im Vergleich zu einem komprimierten Format wie einer PNG- oder JPEG-Datei (Portable Network Graphics) erfordern kann. Daher kann die Verwendung einer SoftwareBitmap den Von Ihrer App verwendeten Systemspeicher erhöhen, was sich auf die Leistung Ihrer App auswirken kann. Da das Speichern von nicht komprimierten Bilddaten viel Arbeitsspeicher beanspruchen kann, können Sie die Methode Dispose (C#/VB) oder Close (C++) aufrufen, um die Arbeitsspeicherauslastung zu reduzieren, wenn SoftwareBitmap nicht mehr benötigt wird. Dies führt dazu, dass die zugeordneten Systemressourcen sofort freigegeben werden, anstatt auf die Garbage Collection zu warten.

Konstruktoren

SoftwareBitmapSource()

Initialisiert eine neue instance der SoftwareBitmapSource-Klasse.

Eigenschaften

Dispatcher

Ruft den CoreDispatcher ab, dem dieses Objekt zugeordnet ist. CoreDispatcher stellt eine Funktion dar, die auf das DependencyObject im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)

Methoden

ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
Close()	Entsorgt das Objekt und die zugeordneten Ressourcen.
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.
GetAnimationBaseValue(DependencyProperty)	Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft festgelegt wurde, was in Fällen gilt, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist. (Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance. (Geerbt von DependencyObject)
SetBitmapAsync(SoftwareBitmap)	Legt die SoftwareBitmap-Quelle fest, die als Bildquelle verwendet werden soll.
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Bricht eine Änderungsbenachrichtigung ab, die zuvor registriert wurde, indem RegisterPropertyChangedCallback aufgerufen wurde. (Geerbt von DependencyObject)

Weitere Informationen

• ImageSource
• IClosable