SoftwareBitmapSource Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет исходный объект с поддержкой SoftwareBitmap для свойств, использующих источник изображения в растровом формате.
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- Наследование
- Атрибуты
- Реализации
Требования к Windows
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Комментарии
SoftwareBitmapSource позволяет использовать SoftwareBitmap в качестве источника изображения для отображения с помощью ImageBrush или непосредственно в элементе управления Image . Например, softwareBitmapSource можно использовать для отображения фотографии, только что снятой камерой устройства, с помощью класса LowLagPhotoCapture , для отображения изображения, декодированного вручную с помощью метода BitmapDecoder.GetSoftwareBitmapAsync , или для отображения пользовательского IWICBitmap в расширенных сценариях C++, где требуется вручную управлять памятью изображений.
SoftwareBitmap, отображаемый в приложении XAML, должен иметь формат пикселей BGRA с предварительно умноженными альфа-значениями.
SoftwareBitmap обычно хранит несжатые данные изображений. Это означает, что для этого может потребоваться большой объем системной памяти по сравнению со сжатым форматом, например png или JPEG-файлом. Таким образом, использование SoftwareBitmap может увеличить объем системной памяти, используемой приложением, что может повлиять на производительность приложения. Так как хранение несжатых данных изображений может использовать много памяти, можно вызвать метод Dispose (C#/VB) или Close (C++), чтобы сократить использование памяти, когда SoftwareBitmap больше не требуется. Это приводит к немедленному освобождению связанных системных ресурсов, а не ожиданию сборки мусора.
Конструкторы
| SoftwareBitmapSource() |
Инициализирует новый экземпляр класса SoftwareBitmapSource . |
Свойства
| Dispatcher |
Возвращает CoreDispatcher , с которым связан этот объект. CoreDispatcher представляет средство, которое может получить доступ к DependencyObject в потоке пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу. (Унаследовано от DependencyObject) |
Методы
| 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) |