SoftwareBitmapSource Klasse
Definition
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 ein Quellobjekt bereit, das von einer SoftwareBitmap unterstützt wird, für Eigenschaften, die eine Bitmapformat-Bildquelle 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.IDisposablePublic NotInheritable Class SoftwareBitmapSource
Inherits ImageSource
Implements IDisposable- Vererbung
- Attribute
- Implementiert
Hinweise
Mit SoftwareBitmapSource können Sie eine SoftwareBitmap als Bildquelle verwenden, die mit einem ImageBrush oder direkt in einem Image-Steuerelement angezeigt werden soll. Sie können z. B. 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 in einer XAML-App angezeigte SoftwareBitmap muss im BGRA-Pixelformat mit vor multiplizierten Alphawerten vorliegen.
Eine SoftwareBitmap speichert in der Regel nicht komprimierte Bilddaten. Dies bedeutet, dass im Vergleich zu einem komprimierten Format wie einer PNG- oder JPEG-Datei (Portable Network Graphics) eine große Menge Systemspeicher erforderlich sein kann. Daher kann die Verwendung einer SoftwareBitmap die Menge des verwendeten Systemspeichers erhöhen, den Ihre App verwendet, was sich auf die Leistung Ihrer App auswirken könnte. Da das Speichern von nicht komprimierten Bilddaten viel Arbeitsspeicher verwenden kann, können Sie die Dispose-Methode (C#/VB) oder Close (C++) aufrufen, um die Speicherauslastung zu verringern, wenn die SoftwareBitmap länger benötigt wird. Dies bewirkt, dass die zugeordneten Systemressourcen sofort freigegeben werden, anstatt auf die Garbage Collection zu warten.
Konstruktoren
| Name | Beschreibung |
|---|---|
| SoftwareBitmapSource() |
Initialisiert eine neue Instanz der SoftwareBitmapSource-Klasse . |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Dispatcher |
Gibt immer in einer Windows App SDK-App zurück |
| DispatcherQueue |
Ruft ab |
Methoden
| Name | Beschreibung |
|---|---|
| ClearValue(DependencyProperty) |
Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject) |
| Close() |
Entfernt das Objekt und die zugeordneten Ressourcen. |
| Dispose() |
Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind. |
| GetAnimationBaseValue(DependencyProperty) |
Gibt einen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, was in Fällen angewendet wird, 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 wird. (Geerbt von DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registriert eine Benachrichtigungsfunktion, um Änderungen an einer bestimmten DependencyProperty für diese DependencyObject-Instanz zu überwachen. (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) |