SoftwareBitmapSource クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ビットマップ形式のイメージ ソースを使用するプロパティに対して、 SoftwareBitmap によってサポートされるソース オブジェクトを提供します。
public ref class SoftwareBitmapSource sealed : ImageSource, IClosable/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class SoftwareBitmapSource final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class SoftwareBitmapSource : ImageSource, System.IDisposable[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.IDisposablePublic NotInheritable Class SoftwareBitmapSource
Inherits ImageSource
Implements 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 ピクセル形式である必要があります。
SoftwareBitmap は通常、圧縮されていないイメージ データを格納します。 つまり、ポータブル ネットワーク グラフィックス (PNG) ファイルや JPEG ファイルなどの圧縮形式と比較して、大量のシステム メモリが必要になる可能性があります。 したがって、 SoftwareBitmap を使用すると、アプリで使用されているシステム メモリの量が増加し、アプリのパフォーマンスに影響を与える可能性があります。 圧縮されていないイメージ データを格納すると大量のメモリを使用できるため、 Dispose (C#/VB) メソッドまたは Close (C++) メソッドを呼び出して、 SoftwareBitmap が不要になったときのメモリ使用量を減らすことができます。 これにより、関連付けられているシステム リソースは、ガベージ コレクションを待機するのではなく、すぐに解放されます。
コンストラクター
| SoftwareBitmapSource() |
SoftwareBitmapSource クラスの新しいインスタンスを初期化します。 |
プロパティ
| Dispatcher |
このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが 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) |