BitmapDecoder クラス

リファレンス

定義

名前空間:: System.Windows.Media.Imaging

アセンブリ:: PresentationCore.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ビットマップフレームのコンテナーを表します。各ビットマップフレームは BitmapSource です。この抽象クラスは、すべての派生デコーダーオブジェクトの基本機能セットを提供します。

public ref class BitmapDecoder abstract : System::Windows::Threading::DispatcherObject

public abstract class BitmapDecoder : System.Windows.Threading.DispatcherObject

type BitmapDecoder = class
    inherit DispatcherObject

Public MustInherit Class BitmapDecoder
Inherits DispatcherObject

継承: Object

DispatcherObject
BitmapDecoder

派生: System.Windows.Media.Imaging.BmpBitmapDecoder

System.Windows.Media.Imaging.GifBitmapDecoder

System.Windows.Media.Imaging.IconBitmapDecoder

System.Windows.Media.Imaging.JpegBitmapDecoder

System.Windows.Media.Imaging.LateBoundBitmapDecoder

その他…

例

次の例では、このメソッドを使用して、特定の 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は、要素のSource Imageものとして使用されます。


// 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) によって開発されたコーデックをシステムで自動的に検出できます。特定のコーデックを選択するには、派生またはBitmapDecoder BitmapEncoderクラスなどのコーデックを使用するTiffBitmapDecoder必要があります。

タグ付けされたイメージファイル形式 (TIFF) とグラフィックス交換形式 (GIF) は、複数のフレームをサポートする唯一の実装済みイメージ形式です。

コンストラクター

BitmapDecoder()

BitmapDecoder の新しいインスタンスを初期化します。

プロパティ

CodecInfo	このコーデックを説明する情報を取得します。
ColorContexts	ビットマップに関連付けられているカラープロファイル (定義されている場合) を表す値を取得します。
Dispatcher	この Dispatcher が関連付けられている DispatcherObject を取得します。 (継承元 DispatcherObject)
Frames	ビットマップ内の個々のフレームのコンテンツを取得します。
IsDownloading	デコーダーが現在コンテンツをダウンロードしているかどうかを示す値を取得します。
Metadata	メタデータが定義されている場合、このビットマップに関連付けられているグローバルメタデータを表す BitmapMetadata のインスタンスを取得します。
Palette	このデコーダーに関連付けられている BitmapPalette を取得します。
Preview	このビットマップのグローバルプレビューが定義されている場合、そのプレビューを表す BitmapSource を取得します。
Thumbnail	ビットマップのサムネイルを表す BitmapSource を取得します (定義されている場合)。

メソッド

CheckAccess()	呼び出し元のスレッドがこの DispatcherObject にアクセスできるかどうかを確認します。 (継承元 DispatcherObject)
Create(Stream, BitmapCreateOptions, BitmapCacheOption)	指定した BitmapDecoder および Stream を使用して、BitmapCreateOptions から BitmapCacheOption を作成します。
Create(Uri, BitmapCreateOptions, BitmapCacheOption)	指定した BitmapDecoder および Uri を使用して、BitmapCreateOptions から BitmapCacheOption を作成します。
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)	指定した BitmapDecoder、Uri、および BitmapCreateOptions を使用して、BitmapCacheOption から RequestCachePolicy を作成します。
CreateInPlaceBitmapMetadataWriter()	ビットマップのメタデータを更新するために使用できる、InPlaceBitmapMetadataWriter のインスタンスを作成します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
Finalize()	BitmapDecoder がガベージコレクションによって回収される前にリソースを解放し、その他のクリーンアップ操作を実行します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	BitmapDecoder の現在の値を String に変換します。
VerifyAccess()	呼び出し元のスレッドがこの DispatcherObject にアクセスできるように強制します。 (継承元 DispatcherObject)

events

DownloadCompleted	BitmapDecoder によるビットマップコンテンツのダウンロードが終了したときに発生します。
DownloadFailed	ビットマップコンテンツのダウンロードが失敗したときに発生します。
DownloadProgress	BitmapDecoder がビットマップコンテンツのダウンロードを実行しているときに発生します。

適用対象