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無法直接寫入。 但是，您可以使用語言特定的技術來寫入緩衝區中的基礎圖元內容。 For details, see the Remarks section of WriteableBitmap.PixelBuffer.

您可能已在先前 XAML 架構中使用WriteableBitmap類別的一些案例，可以改為使用RenderTargetBitmap類別，在Windows 執行階段中完成。 如需詳細資訊，請參閱 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)