BitmapDecoder クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ビットマップ フレームのコンテナーを表します。 各ビットマップ フレームは BitmapSource です。 この抽象クラスは、すべての派生デコーダー オブジェクトの基本機能セットを提供します。
public ref class BitmapDecoder abstract : System::Windows::Threading::DispatcherObjectpublic abstract class BitmapDecoder : System.Windows.Threading.DispatcherObjecttype BitmapDecoder = class
inherit DispatcherObjectPublic MustInherit Class BitmapDecoder
Inherits DispatcherObject- 継承
- 派生
例
次の例では、このメソッドを使用して、特定の Create(Uri, BitmapCreateOptions, BitmapCacheOption) イメージのデコーダーを作成する方法を示します。 イメージの 1 つ目 BitmapFrame は、コントロールの Image ソースとして使用されます。
BitmapDecoder uriBitmap = BitmapDecoder.Create(
new Uri("sampleImages/waterlilies.jpg", UriKind.Relative),
BitmapCreateOptions.None,
BitmapCacheOption.Default);
// Create an image element;
Image uriImage = new Image();
uriImage.Width = 200;
// Set image source.
uriImage.Source = uriBitmap.Frames[0];
Dim uriBitmap As BitmapDecoder = BitmapDecoder.Create(New Uri("sampleImages/waterlilies.jpg", UriKind.Relative), BitmapCreateOptions.None, BitmapCacheOption.Default)
' Create an image element;
Dim uriImage As New Image()
uriImage.Width = 200
' Set image source.
uriImage.Source = uriBitmap.Frames(0)
次のコード例は、組み込み関数 TiffBitmapDecoder を使用して、タグ付けされたイメージ ファイル形式 (TIFF) ビットマップを開いてデコードする方法を示しています。 結果BitmapSourceは、要素のSourceImageものとして使用されます。
// Open a Stream and decode a TIFF image
Stream imageStreamSource = new FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read);
TiffBitmapDecoder decoder = new TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource = decoder.Frames[0];
// Draw the Image
Image myImage1 = new Image();
myImage1.Source = bitmapSource;
myImage1.Stretch = Stretch.None;
myImage1.Margin = new Thickness(20);
' Open a Stream and decode a TIFF image
Dim imageStreamSource As New FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim decoder As New TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource As BitmapSource = decoder.Frames(0)
' Draw the Image
Dim myImage1 As New Image()
myImage1.Source = bitmapSource
myImage1.Stretch = Stretch.None
myImage1.Margin = New Thickness(20)
注釈
BitmapDecoder はそれ自体ではなく BitmapFrame 、オブジェクトの BitmapFrame コンテナーです。 コンテナー内の各 BitmapFrame 属性は、サイズ、解像度、パレットなど、異なる属性を持つ可能性があります。
特定のコーデックが選択されていない限り、Windows Presentation Foundation (WPF) は自動実行時検出を使用してイメージの形式を識別し、適切なコーデックと一致させます。 この検出プロセスにより、独立系ソフトウェア ベンダー (ISV) によって開発されたコーデックをシステムで自動的に検出できます。 特定のコーデックを選択するには、派生またはBitmapDecoderBitmapEncoderクラスなどのコーデックを使用するTiffBitmapDecoder必要があります。
タグ付けされたイメージ ファイル形式 (TIFF) とグラフィックス交換形式 (GIF) は、複数のフレームをサポートする唯一の実装済みイメージ形式です。
コンストラクター
| BitmapDecoder() |
BitmapDecoder の新しいインスタンスを初期化します。 |
プロパティ
| CodecInfo |
このコーデックを説明する情報を取得します。 |
| ColorContexts |
ビットマップに関連付けられているカラー プロファイル (定義されている場合) を表す値を取得します。 |
| Dispatcher |
この Dispatcher が関連付けられている DispatcherObject を取得します。 (継承元 DispatcherObject) |
| Frames |
ビットマップ内の個々のフレームのコンテンツを取得します。 |
| IsDownloading |
デコーダーが現在コンテンツをダウンロードしているかどうかを示す値を取得します。 |
| Metadata |
メタデータが定義されている場合、このビットマップに関連付けられているグローバル メタデータを表す BitmapMetadata のインスタンスを取得します。 |
| Palette |
このデコーダーに関連付けられている BitmapPalette を取得します。 |
| Preview |
このビットマップのグローバル プレビューが定義されている場合、そのプレビューを表す BitmapSource を取得します。 |
| Thumbnail |
ビットマップのサムネイルを表す BitmapSource を取得します (定義されている場合)。 |
メソッド
events
| DownloadCompleted |
BitmapDecoder によるビットマップ コンテンツのダウンロードが終了したときに発生します。 |
| DownloadFailed |
ビットマップ コンテンツのダウンロードが失敗したときに発生します。 |
| DownloadProgress |
BitmapDecoder がビットマップ コンテンツのダウンロードを実行しているときに発生します。 |