SoftwareBitmapSource Klasse

Referenz

Definition

Namespace:: Microsoft.UI.Xaml.Media.Imaging

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.

Bearbeiten

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

public ref class SoftwareBitmapSource sealed : ImageSource, IClosable

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

[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
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

Hinweise

Mit SoftwareBitmapSource können Sie eine SoftwareBitmap als Bildquelle verwenden, die mit einem ImageBrush oder direkt in einem Image-Steuerelement angezeigt wird. 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 mithilfe der BitmapDecoder.GetSoftwareBitmapAsync-Methode manuell 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 im Vergleich zu einem komprimierten Format wie einer PORTABLE Network Graphics (PNG) oder JPEG-Datei eine große Menge an Systemspeicher benötigen 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 unkomprimierten Bilddaten viel Arbeitsspeicher beanspruchen kann, können Sie die Dispose-Methode (C#/VB) oder Close (C++) aufrufen, um die Speicherauslastung zu reduzieren, wenn SoftwareBitmap länger benötigt wird. Dies führt dazu, dass die zugeordneten Systemressourcen sofort freigegeben werden, anstatt auf die Garbage Collection zu warten.

Konstruktoren

SoftwareBitmapSource()

Initialisiert einen neuen instance der SoftwareBitmapSource-Klasse.

Eigenschaften

Dispatcher	Gibt immer in einer Windows App SDK-App zurück`null`. Verwenden Sie stattdessen DispatcherQueue . (Geerbt von DependencyObject)
DispatcherQueue	Ruft den `DispatcherQueue` ab, dem dieses Objekt zugeordnet ist. Stellt `DispatcherQueue` eine Funktion dar, die auf den `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 eingerichtet wurde, der 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 durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject)

Gilt für:

Freigeben über