SoftwareBitmapSource Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет исходный объект, поддерживаемый SoftwareBitmap, для свойств, использующих источник изображения в формате растрового изображения.
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
- Наследование
- Атрибуты
- Реализации
Комментарии
SoftwareBitmapSource позволяет использовать SoftwareBitmap в качестве источника изображения для отображения с помощью ImageBrush или непосредственно в элементе управления "Изображение". Например, вы можете использовать SoftwareBitmapSource для отображения фотографии, созданной камерой устройства с помощью класса LowLagPhotoCapture , для отображения изображения, которое вы вручную декодировали с помощью метода BitmapDecoder.GetSoftwareBitmapAsync , или для отображения пользовательского IWICBitmap в расширенных сценариях C++, где требуется вручную управлять памятью изображения.
Файл SoftwareBitmap, отображаемый в приложении XAML, должен находиться в формате пикселя BGRA с предварительно умноженными альфа-значениями.
SoftwareBitmap обычно хранит несжатые данные изображения. Это означает, что может потребоваться большой объем системной памяти по сравнению с сжатым форматом, например переносимым сетевым графическим (PNG) или JPEG-файлом. Поэтому использование SoftwareBitmap может увеличить объем системной памяти, используемой приложением, что может повлиять на производительность вашего приложения. Так как хранение несжатых данных изображения может использовать много памяти, можно вызвать метод Dispose (C#/VB) или Close (C++), чтобы сократить использование памяти, когда SoftwareBitmap требуется больше времени. Это приводит к немедленному освобождению связанных системных ресурсов, а не ожиданию сборки мусора.
Конструкторы
| Имя | Описание |
|---|---|
| SoftwareBitmapSource() |
Инициализирует новый экземпляр класса SoftwareBitmapSource . |
Свойства
| Имя | Описание |
|---|---|
| Dispatcher |
Всегда возвращается |
| DispatcherQueue |
Возвращает, |
Методы
| Имя | Описание |
|---|---|
| ClearValue(DependencyProperty) |
Очищает локальное значение свойства зависимостей. (Унаследовано от DependencyObject) |
| Close() |
Удаляет объект и связанные ресурсы. |
| Dispose() |
Выполняет определяемые приложением задачи, связанные с освобождением, освобождением или сбросом неуправляемых ресурсов. |
| GetAnimationBaseValue(DependencyProperty) |
Возвращает любое базовое значение, установленное для свойства зависимостей, которое будет применяться в случаях, когда анимация не активна. (Унаследовано от DependencyObject) |
| GetValue(DependencyProperty) |
Возвращает текущее эффективное значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject) |
| ReadLocalValue(DependencyProperty) |
Возвращает локальное значение свойства зависимостей, если задано локальное значение. (Унаследовано от DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Регистрирует функцию уведомлений для прослушивания изменений в определенном экземпляре DependencyProperty в этом экземпляре DependencyObject . (Унаследовано от DependencyObject) |
| SetBitmapAsync(SoftwareBitmap) |
Задает источник SoftwareBitmap для использования в качестве источника изображения. |
| SetValue(DependencyProperty, Object) |
Задает локальное значение свойства зависимостей в DependencyObject. (Унаследовано от DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Отменяет уведомление об изменении, которое ранее было зарегистрировано путем вызова RegisterPropertyChangedCallback. (Унаследовано от DependencyObject) |