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 必須採用 BGRA 像素格式，且具有預先乘法的 Alpha 值。

SoftwareBitmap通常會儲存未壓縮的影像資料。 這表示相較于可攜式網狀圖形 (PNG) 或 JPEG 檔案等壓縮格式，可能需要大量的系統記憶體。 因此，使用 SoftwareBitmap 可以增加應用程式正在使用的系統記憶體數量，這可能會影響應用程式的效能。 由於儲存未壓縮的影像資料可以使用許多記憶體，因此您可以呼叫 Dispose (C#/VB) 或 Close (C++) 方法，以在不再需要 SoftwareBitmap 時減少記憶體使用量。 這會導致相關聯的系統資源立即釋放，而不是等待垃圾收集。

建構函式

SoftwareBitmapSource()

初始化 SoftwareBitmapSource 類別的新實例。

屬性

Dispatcher

取得與此物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可以存取 UI 執行緒上DependencyObject的功能，即使程式碼是由非 UI 執行緒起始也一樣。 (繼承來源 DependencyObject)

方法

ClearValue(DependencyProperty)	清除相依性屬性的本機值。 (繼承來源 DependencyObject)
Close()	處置物件和相關聯的資源。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
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