WriteableBitmap 类

定义

提供可写入和更新的 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 : BitmapSource
Public NotInheritable Class WriteableBitmap
Inherits BitmapSource
继承
Object Platform::Object IInspectable DependencyObject ImageSource BitmapSource WriteableBitmap
属性

示例

有关 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应用中返回 null 。 请改用 DispatcherQueue

(继承自 DependencyObject)
DispatcherQueue

DispatcherQueue获取与此对象关联的 。 表示 DispatcherQueue 一个可以在 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)

适用于

另请参阅