次の方法で共有


BitmapDecoder クラス

定義

ビットマップ フレームのコンテナーを表します。 各ビットマップ フレームは 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
継承
BitmapDecoder
派生

次の例では、このメソッドを使用して、特定の 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 を取得します (定義されている場合)。

メソッド

CheckAccess()

呼び出し元のスレッドがこの DispatcherObject にアクセスできるかどうかを確認します。

(継承元 DispatcherObject)
Create(Stream, BitmapCreateOptions, BitmapCacheOption)

指定した BitmapDecoder および Stream を使用して、BitmapCreateOptions から BitmapCacheOption を作成します。

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

指定した BitmapDecoder および Uri を使用して、BitmapCreateOptions から BitmapCacheOption を作成します。

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

指定した BitmapDecoderUri、および 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 がビットマップ コンテンツのダウンロードを実行しているときに発生します。

適用対象

こちらもご覧ください