WriteableBitmap 类

定义

命名空间:

Windows.UI.Xaml.Media.Imaging

提供可写入和更新的 BitmapSource 。

public ref class WriteableBitmap sealed : BitmapSource

/// [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(Windows.UI.Xaml.Media.Imaging.IWriteableBitmapFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class WriteableBitmap final : BitmapSource

[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(typeof(Windows.UI.Xaml.Media.Imaging.IWriteableBitmapFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class WriteableBitmap : BitmapSource

Public NotInheritable Class WriteableBitmap
Inherits BitmapSource

继承

Object Platform::Object IInspectable DependencyObject ImageSource BitmapSource WriteableBitmap

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

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

示例

有关 C#、C++/WinRT 和 C++/CX 中的代码示例，请参阅 WriteableBitmap.PixelBuffer。

注解

WriteableBitmap 的图像源数据是基础像素缓冲区。

WriteableBitmap.PixelBuffer 返回的 IBuffer 不能直接写入。 但可以使用特定于语言的技术写入缓冲区中的基础像素内容。 有关详细信息，请参阅 WriteableBitmap.PixelBuffer 的“备注”部分。

在以前的 XAML 框架中使用 WriteableBitmap 类的一些方案可以在 Windows 运行时中改为使用 RenderTargetBitmap 类来完成。 有关详细信息，请参阅 RenderTargetBitmap。

构造函数

WriteableBitmap(Int32, Int32)

初始化 WriteableBitmap 类的新实例。

属性

Dispatcher	获取与此 对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)
PixelBuffer	获取写入 WriteableBitmap 的每个像素的直接缓冲区的访问权限。
PixelHeight	获取位图的高度（以像素为单位）。 (继承自 BitmapSource)
PixelWidth	获取位图的宽度（以像素为单位）。 (继承自 BitmapSource)

方法

ClearValue(DependencyProperty)	清除依赖属性的本地值。 (继承自 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject)
GetValue(DependencyProperty)	从 DependencyObject 返回依赖属性的当前有效值。 (继承自 DependencyObject)
Invalidate()	请求绘制或重绘整个位图。
ReadLocalValue(DependencyProperty)	如果设置了本地值，则返回依赖属性的本地值。 (继承自 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	注册一个通知函数，用于侦听此 DependencyObject 实例上特定 DependencyProperty 的更改。 (继承自 DependencyObject)
SetSource(IRandomAccessStream)	通过访问流设置 BitmapSource 的源图像。 大多数调用方应改用 SetSourceAsync 。 (继承自 BitmapSource)
SetSourceAsync(IRandomAccessStream)	通过访问流并异步处理结果来设置 BitmapSource 的源图像。 (继承自 BitmapSource)
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)

另请参阅

• BitmapSource
• PixelBuffer
• BitmapDecoder
• Windows.Graphics.Imaging
• XAML 图像示例
• 相机预览帧示例 (Windows 10)