SoftwareBitmapSource Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce un oggetto di origine, supportato da softwareBitmap, per le proprietà che usano un'origine immagine in formato bitmap.
public ref class SoftwareBitmapSource sealed : ImageSource, IClosable/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class SoftwareBitmapSource final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class SoftwareBitmapSource : ImageSource, System.IDisposable[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.IDisposablePublic NotInheritable Class SoftwareBitmapSource
Inherits ImageSource
Implements IDisposable- Ereditarietà
- Attributi
- Implementazioni
Requisiti Windows
| Famiglia di dispositivi |
Windows 10 (è stato introdotto in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
|
Commenti
SoftwareBitmapSource consente di usare softwareBitmap come origine dell'immagine da visualizzare usando imageBrush o direttamente in un controllo Image . Ad esempio, puoi usare softwareBitmapSource per visualizzare una foto appena scattata dalla fotocamera di un dispositivo usando la classe LowLagPhotoCapture , per visualizzare un'immagine che hai decodificato manualmente usando il metodo BitmapDecoder.GetSoftwareBitmapAsync o per visualizzare un oggetto IWICBitmap personalizzato in scenari C++ avanzati in cui vuoi gestire manualmente la memoria dell'immagine.
Un oggetto SoftwareBitmap visualizzato in un'app XAML deve essere in formato pixel BGRA con valori alfa pre-moltiplicati.
Un Oggetto SoftwareBitmap archivia in genere i dati di immagine non compressi. Ciò significa che può richiedere una grande quantità di memoria di sistema rispetto a un formato compresso come un file PNG (Portable Network Graphics) o JPEG. Di conseguenza, l'uso di softwareBitmap può aumentare la quantità di memoria di sistema usata dall'app, che potrebbe influire sulle prestazioni dell'app. Poiché l'archiviazione di dati immagine non compressi può usare molta memoria, è possibile chiamare il metodo Dispose (C#/VB) o Close (C++) per ridurre l'utilizzo della memoria quando SoftwareBitmap non è più necessario. In questo modo le risorse di sistema associate vengono liberate immediatamente anziché attendere l'operazione di Garbage Collection.
Costruttori
| SoftwareBitmapSource() |
Inizializza una nuova istanza della classe SoftwareBitmapSource . |
Proprietà
| Dispatcher |
Ottiene coreDispatcher a cui è associato questo oggetto. CoreDispatcher rappresenta una funzionalità che può accedere a DependencyObject nel thread dell'interfaccia utente anche se il codice viene avviato da un thread non dell'interfaccia utente. (Ereditato da DependencyObject) |
Metodi
| ClearValue(DependencyProperty) |
Cancella il valore locale di una proprietà di dipendenza. (Ereditato da DependencyObject) |
| Close() |
Elimina l'oggetto e le risorse associate. |
| Dispose() |
Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. |
| GetAnimationBaseValue(DependencyProperty) |
Restituisce qualsiasi valore di base stabilito per una proprietà di dipendenza, che si applica nei casi in cui un'animazione non è attiva. (Ereditato da DependencyObject) |
| GetValue(DependencyProperty) |
Restituisce il valore effettivo corrente di una proprietà di dipendenza da dependencyObject. (Ereditato da DependencyObject) |
| ReadLocalValue(DependencyProperty) |
Restituisce il valore locale di una proprietà di dipendenza, se è impostato un valore locale. (Ereditato da DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registra una funzione di notifica per l'ascolto delle modifiche apportate a una dipendenza specifica in questa istanza di DependencyObject . (Ereditato da DependencyObject) |
| SetBitmapAsync(SoftwareBitmap) |
Imposta l'origine SoftwareBitmap da usare come origine dell'immagine. |
| SetValue(DependencyProperty, Object) |
Imposta il valore locale di una proprietà di dipendenza su dependencyObject. (Ereditato da DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback. (Ereditato da DependencyObject) |