SoftwareBitmapSource Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit un objet source, soutenu par un SoftwareBitmap, pour les propriétés qui utilisent une source d’image au format bitmap.
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
- Héritage
- Attributs
- Implémente
Remarques
SoftwareBitmapSource vous permet d’utiliser un SoftwareBitmap comme source d’image à afficher à l’aide d’un objet ImageBrush ou directement dans un contrôle Image . Par exemple, vous pouvez utiliser un SoftwareBitmapSource pour afficher une photo prise par l’appareil photo d’un appareil à l’aide de la classe LowLagPhotoCapture , pour afficher une image que vous avez décodée manuellement à l’aide de la méthode BitmapDecoder.GetSoftwareBitmapAsync , ou pour afficher un IWICBitmap personnalisé dans des scénarios C++ avancés où vous souhaitez gérer manuellement la mémoire d’image.
Un SoftwareBitmap affiché dans une application XAML doit être au format de pixel BGRA avec des valeurs alpha prémultipliées.
Un SoftwareBitmap stocke généralement des données d’image non compressées. Cela signifie qu’il peut nécessiter une grande quantité de mémoire système par rapport à un format compressé tel qu’un fichier PNG (Portable Network Graphics) ou JPEG. Par conséquent, l’utilisation d’un SoftwareBitmap peut augmenter la quantité de mémoire système utilisée par votre application, ce qui peut avoir un impact sur les performances de votre application. Étant donné que le stockage des données d’image non compressées peut utiliser beaucoup de mémoire, vous pouvez appeler la méthode Dispose (C#/VB) ou Close (C++) pour réduire l’utilisation de la mémoire lorsque le SoftwareBitmap est plus nécessaire. Cela entraîne la libération immédiate des ressources système associées au lieu d’attendre le garbage collection.
Constructeurs
SoftwareBitmapSource() |
Initialise une nouvelle instance de la classe SoftwareBitmapSource. |
Propriétés
Dispatcher |
Retourne |
DispatcherQueue |
Obtient le |
Méthodes
ClearValue(DependencyProperty) |
Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject) |
Close() |
Supprime l’objet et les ressources associées. |
Dispose() |
Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées. |
GetAnimationBaseValue(DependencyProperty) |
Retourne toute valeur de base établie pour une propriété de dépendance, qui s’appliquerait dans les cas où une animation n’est pas active. (Hérité de DependencyObject) |
GetValue(DependencyProperty) |
Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un DependencyObject. (Hérité de DependencyObject) |
ReadLocalValue(DependencyProperty) |
Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject) |
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Inscrit une fonction de notification pour écouter les modifications apportées à un DependencyProperty spécifique sur ce instance DependencyObject. (Hérité de DependencyObject) |
SetBitmapAsync(SoftwareBitmap) |
Définit la source SoftwareBitmap à utiliser comme source d’image. |
SetValue(DependencyProperty, Object) |
Définit la valeur locale d’une propriété de dépendance sur un DependencyObject. (Hérité de DependencyObject) |
UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Annule une notification de modification précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject) |