SoftwareBitmapSource 類別

定義

命名空間:

Microsoft.UI.Xaml.Media.Imaging

針對使用點陣圖格式影像來源的屬性，提供 由 SoftwareBitmap支援的來源物件。

public ref class SoftwareBitmapSource sealed : ImageSource, IClosable

/// [Windows.Foundation.Metadata.Activatable(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 SoftwareBitmapSource final : ImageSource, IClosable

[Windows.Foundation.Metadata.Activatable(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 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

備註

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	一律會在Windows 應用程式 SDK應用程式中傳 null 回。 請改用 DispatcherQueue 。 (繼承來源 DependencyObject)
DispatcherQueue	DispatcherQueue取得與這個 物件相關聯的 。 DispatcherQueue表示即使程式碼是由非 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