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 ピクセル形式である必要があります。

SoftwareBitmap は通常、圧縮されていないイメージ データを格納します。 つまり、ポータブル ネットワーク グラフィックス (PNG) ファイルや JPEG ファイルなどの圧縮形式と比較して、大量のシステム メモリが必要になる可能性があります。 したがって、 SoftwareBitmap を使用すると、アプリで使用しているシステム メモリの量が増え、アプリのパフォーマンスに影響を与える可能性があります。 圧縮されていないイメージ データを格納すると大量のメモリが使用される可能性があるため、 Dispose (C#/VB) メソッドまたは Close (C++) メソッドを呼び出して、 SoftwareBitmap が長く必要になったときのメモリ使用量を減らすことができます。 これにより、関連付けられているシステム リソースは、ガベージ コレクションを待機するのではなく、すぐに解放されます。

コンストラクター

SoftwareBitmapSource()

SoftwareBitmapSource クラスの新しいインスタンスを初期化します。

プロパティ

Dispatcher	常に Windows アプリ SDK アプリで を返しますnull。 代わりに DispatcherQueue を使用してください。 (継承元 DependencyObject)
DispatcherQueue	このオブジェクトが DispatcherQueue 関連付けられている を取得します。 は DispatcherQueue 、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の にアクセス DependencyObject できる機能を表します。 (継承元 DependencyObject)

メソッド

ClearValue(DependencyProperty)	依存関係プロパティのローカル値をクリアします。 (継承元 DependencyObject)
Close()	オブジェクトと関連付けられているリソースを破棄します。
Dispose()	アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。
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