WriteableBitmap 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供可写入和更新的 BitmapSource 。
public ref class WriteableBitmap sealed : BitmapSource/// [Windows.Foundation.Metadata.Activatable(Microsoft.UI.Xaml.Media.Imaging.IWriteableBitmapFactory, 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 WriteableBitmap final : BitmapSource[Windows.Foundation.Metadata.Activatable(typeof(Microsoft.UI.Xaml.Media.Imaging.IWriteableBitmapFactory), 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 WriteableBitmap : BitmapSourcePublic NotInheritable Class WriteableBitmap
Inherits BitmapSource- 继承
- 属性
示例
有关 C#、C++/WinRT 和 C++/CX 中的代码示例，请参阅 WriteableBitmap.PixelBuffer。
注解
WriteableBitmap 的图像源数据是基础像素缓冲区。
WriteableBitmap.PixelBuffer 返回的 IBuffer 无法直接写入。 但可以使用特定于语言的技术写入缓冲区中的基础像素内容。 有关详细信息，请参阅 WriteableBitmap.PixelBuffer 的“备注”部分。
在以前的 XAML 框架中使用 WriteableBitmap 类的一些方案可以在 Windows 运行时改为使用 RenderTargetBitmap 类来实现。 有关详细信息，请参阅 RenderTargetBitmap。
构造函数
| WriteableBitmap(Int32, Int32) |
初始化 WriteableBitmap 类的新实例。 |
属性
| Dispatcher |
始终在Windows 应用 SDK应用中返回 |
| DispatcherQueue |
|
| 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) |