SoftwareBitmapSource 类

定义

命名空间:

Windows.UI.Xaml.Media.Imaging

为使用位图格式图像源的属性提供 由 SoftwareBitmap 支持的源对象。

public ref class SoftwareBitmapSource sealed : 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.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.IDisposable

Public NotInheritable Class SoftwareBitmapSource
Inherits ImageSource
Implements IDisposable

继承

Object Platform::Object IInspectable DependencyObject ImageSource SoftwareBitmapSource

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IClosable IDisposable

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

借助 SoftwareBitmapSource，可以将 SoftwareBitmap 用作图像源，以便使用 ImageBrush 或直接在 Image 控件中显示。 例如，可以使用 SoftwareBitmapSource 显示刚刚由设备相机使用 LowLagPhotoCapture 类拍摄的照片、显示使用 BitmapDecoder.GetSoftwareBitmapAsync 方法手动解码的图像，或者在想要手动管理图像内存的高级 C++ 方案中显示自定义 IWICBitmap 。

XAML 应用中显示的 SoftwareBitmap 必须采用具有预乘 alpha 值的 BGRA 像素格式。

SoftwareBitmap 通常存储未压缩的图像数据。 这意味着，与可移植网络图形 (PNG) 或 JPEG 文件等压缩格式相比，它可能需要大量的系统内存。 因此，使用 SoftwareBitmap 可能会增加应用正在使用的系统内存量，这可能会影响应用的性能。 由于存储未压缩的图像数据可能会占用大量内存，因此可以调用 Dispose (C#/VB) 或 Close (C++) 方法，以减少不再需要 SoftwareBitmap 的内存使用量。 这会导致立即释放关联的系统资源，而不是等待垃圾回收。

构造函数

SoftwareBitmapSource()

初始化 SoftwareBitmapSource 类的新实例。

属性

Dispatcher

获取与此对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)

方法

ClearValue(DependencyProperty)	清除依赖属性的本地值。 (继承自 DependencyObject)
Close()	释放 对象和关联的资源。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
GetAnimationBaseValue(DependencyProperty)	返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject)
GetValue(DependencyProperty)	从 DependencyObject 返回依赖属性的当前有效值。 (继承自 DependencyObject)
ReadLocalValue(DependencyProperty)	如果设置了本地值，则返回依赖属性的本地值。 (继承自 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	注册通知函数，用于侦听此 DependencyObject 实例上对特定 DependencyProperty 的更改。 (继承自 DependencyObject)
SetBitmapAsync(SoftwareBitmap)	设置要用作图像源的源 SoftwareBitmap 。
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)

另请参阅

• ImageSource
• IClosable