BitmapImage クラス

定義

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

アセンブリ:: PresentationCore.dll

重要

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

拡張アプリケーションマークアップ言語 (XAML) を使用したイメージの読み込みに最適化された特殊な BitmapSource を提供します。

public ref class BitmapImage sealed : System::Windows::Media::Imaging::BitmapSource, System::ComponentModel::ISupportInitialize, System::Windows::Markup::IUriContext

public sealed class BitmapImage : System.Windows.Media.Imaging.BitmapSource, System.ComponentModel.ISupportInitialize, System.Windows.Markup.IUriContext

type BitmapImage = class
    inherit BitmapSource
    interface ISupportInitialize
    interface IUriContext

Public NotInheritable Class BitmapImage
Inherits BitmapSource
Implements ISupportInitialize, IUriContext

継承: Object

DispatcherObject

DependencyObject

Freezable

Animatable

ImageSource

BitmapSource
BitmapImage

実装: ISupportInitialize IUriContext

例

次のコード例は、拡張アプリケーションマークアップ言語 (XAML) とコードで BitmapImage を使用する方法を示しています。

<!-- Property Tag XAML Syntax -->
<Image Width="200"  Margin="5" Grid.Column="1" Grid.Row="1" >
   <Image.Source>
      <BitmapImage UriSource="sampleImages/bananas.jpg" />
   </Image.Source>
</Image>

<!-- Property Tag XAML Syntax -->
<Image Width="200"  Margin="5" Grid.Column="1" Grid.Row="1" >
   <Image.Source>
      <BitmapImage UriSource="sampleImages/bananas.jpg" />
   </Image.Source>
</Image>

// Create the image element.
Image simpleImage = new Image();    
simpleImage.Width = 200;
simpleImage.Margin = new Thickness(5);

// Create source.
BitmapImage bi = new BitmapImage();
// BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit();
bi.UriSource = new Uri(@"/sampleImages/cherries_larger.jpg",UriKind.RelativeOrAbsolute);
bi.EndInit();
// Set the image source.
simpleImage.Source = bi;

' Create the image element.
Dim simpleImage As New Image()
simpleImage.Width = 200
simpleImage.Margin = New Thickness(5)

' Create source.
Dim bi As New BitmapImage()
' BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit()
bi.UriSource = New Uri("/sampleImages/cherries_larger.jpg", UriKind.RelativeOrAbsolute)
bi.EndInit()
' Set the image source.
simpleImage.Source = bi

注釈

BitmapImage 主に拡張アプリケーションマークアップ言語 (XAML) 構文をサポートするために存在し、 BitmapSourceで定義されていないビットマップ読み込み用の追加のプロパティが導入されています。

BitmapImage は、複数のプロパティの初期化を最適化するために ISupportInitialize インターフェイスを実装します。プロパティの変更は、オブジェクトの初期化中にのみ行うことができます。初期化が開始されたことを通知する BeginInit を呼び出し、初期化が完了したことを通知する EndInit します。初期化後、プロパティの変更は無視されます。

BitmapImage BitmapImage コンストラクターを使用して作成されたオブジェクトは自動的に初期化され、プロパティの変更は無視されます。

コンストラクター

名前	説明
BitmapImage()	BitmapImage クラスの新しいインスタンスを初期化します。
BitmapImage(Uri, RequestCachePolicy)	ソースがUriで、指定されたRequestCachePolicyに従ってキャッシュされるイメージを使用して、BitmapImage クラスの新しいインスタンスを初期化します。
BitmapImage(Uri)	指定したUriを使用して、BitmapImage クラスの新しいインスタンスを初期化します。

フィールド

名前	説明
CacheOptionProperty	CacheOption依存関係プロパティを識別します。
CreateOptionsProperty	CreateOptions依存関係プロパティを識別します。
DecodePixelHeightProperty	DecodePixelHeight依存関係プロパティを識別します。
DecodePixelWidthProperty	DecodePixelWidth依存関係プロパティを識別します。
RotationProperty	Rotation依存関係プロパティを識別します。
SourceRectProperty	SourceRect依存関係プロパティを識別します。
StreamSourceProperty	StreamSource依存関係プロパティを識別します。
UriCachePolicyProperty	UriCachePolicy依存関係プロパティを識別します。
UriSourceProperty	UriSource依存関係プロパティを識別します。

プロパティ

名前	説明
BaseUri	現在のBitmapImage コンテキストの基本Uriを表す値を取得または設定します。
CacheOption	BitmapImageのこのインスタンスに使用するBitmapCacheOptionを取得または設定します。
CanFreeze	オブジェクトを変更不可にできるかどうかを示す値を取得します。 (継承元 Freezable)
CreateOptions	BitmapCreateOptionsのBitmapImageを取得または設定します。
DecodePixelHeight	イメージのデコードの高さをピクセル単位で取得または設定します。
DecodePixelWidth	イメージのデコードの幅をピクセル単位で取得または設定します。
DependencyObjectType	このインスタンスの CLR 型をラップする DependencyObjectType を取得します。 (継承元 DependencyObject)
Dispatcher	このDispatcherが関連付けられているDispatcherObjectを取得します。 (継承元 DispatcherObject)
DpiX	イメージの 1 インチあたりの水平方向のドット (dpi) を取得します。 (継承元 BitmapSource)
DpiY	イメージの垂直ドット/インチ (dpi) を取得します。 (継承元 BitmapSource)
Format	ビットマップデータのネイティブ PixelFormat を取得します。 (継承元 BitmapSource)
HasAnimatedProperties	1 つ以上の AnimationClock オブジェクトがこのオブジェクトの依存関係プロパティのいずれかに関連付けられているかどうかを示す値を取得します。 (継承元 Animatable)
Height	デバイスに依存しない単位 (ユニットあたり 1/96 インチ) のソースビットマップの高さを取得します。 (継承元 BitmapSource)
IsDownloading	BitmapImageが現在コンテンツをダウンロードしているかどうかを示す値を取得します。
IsFrozen	オブジェクトが現在変更可能かどうかを示す値を取得します。 (継承元 Freezable)
IsSealed	このインスタンスが現在シールされているかどうかを示す値を取得します (読み取り専用)。 (継承元 DependencyObject)
Metadata	サポートされていません。 BitmapImage は、 Metadata プロパティをサポートせず、 NotSupportedExceptionをスローします。
Palette	ビットマップが指定されている場合は、ビットマップのカラーパレットを取得します。 (継承元 BitmapSource)
PixelHeight	ビットマップの高さをピクセル単位で取得します。 (継承元 BitmapSource)
PixelWidth	ビットマップの幅をピクセル単位で取得します。 (継承元 BitmapSource)
Rotation	この BitmapImage の回転角度を取得または設定します。
SourceRect	BitmapImageのソースとして使用される四角形を取得または設定します。
StreamSource	BitmapImageのストリームソースを取得または設定します。
UriCachePolicy	HTTP ソースから取得されるイメージのキャッシュポリシーを表す値を取得または設定します。
UriSource	UriのBitmapImage ソースを取得または設定します。
Width	デバイスに依存しない単位 (単位あたり 1/96 インチ) のビットマップの幅を取得します。 (継承元 BitmapSource)

メソッド

名前	説明
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	指定したAnimationClockにDependencyPropertyを適用します。プロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。 (継承元 Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	指定したAnimationClockにDependencyPropertyを適用します。プロパティが既にアニメーション化されている場合は、 SnapshotAndReplace ハンドオフ動作が使用されます。 (継承元 Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	指定した DependencyPropertyにアニメーションを適用します。アニメーションは、次のフレームがレンダリングされるときに開始されます。指定したプロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。 (継承元 Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	指定した DependencyPropertyにアニメーションを適用します。アニメーションは、次のフレームがレンダリングされるときに開始されます。指定したプロパティが既にアニメーション化されている場合は、 SnapshotAndReplace ハンドオフ動作が使用されます。 (継承元 Animatable)
BeginInit()	BitmapImage初期化の開始を通知します。
CheckAccess()	呼び出し元のスレッドがこの DispatcherObjectにアクセスできるかどうかを判断します。 (継承元 DispatcherObject)
CheckIfSiteOfOrigin()	ビットマップソースコンテンツが既知の起点サイトからのものかどうかを確認します。このメソッドは、ピクセルコピー操作が安全であることを確認するために使用されます。 (継承元 BitmapSource)
ClearValue(DependencyProperty)	プロパティのローカル値をクリアします。クリアするプロパティは、 DependencyProperty 識別子によって指定されます。 (継承元 DependencyObject)
ClearValue(DependencyPropertyKey)	読み取り専用プロパティのローカル値をクリアします。クリアするプロパティは、 DependencyPropertyKeyによって指定されます。 (継承元 DependencyObject)
Clone()	この BitmapImageの変更可能な複製を作成し、このオブジェクトの値の詳細コピーを作成します。
CloneCore(Freezable)	このインスタンスを、指定した BitmapSourceのディープコピーにします。依存関係プロパティをコピーする場合、このメソッドはリソース参照とデータバインディングをコピーします (ただし、解決されなくなる可能性があります)、アニメーションやその現在の値はコピーしません。 (継承元 BitmapSource)
CloneCurrentValue()	この BitmapImage オブジェクトの変更可能な複製を作成し、このオブジェクトの現在の値の詳細コピーを作成します。リソース参照、データバインディング、およびアニメーションはコピーされませんが、現在の値はコピーされます。
CloneCurrentValueCore(Freezable)	現在のプロパティ値を使用して、このインスタンスを指定した BitmapSource の変更可能なディープコピーにします。リソース参照、データバインディング、およびアニメーションはコピーされませんが、現在の値はコピーされます。 (継承元 BitmapSource)
CoerceValue(DependencyProperty)	指定した依存関係プロパティの値を強制します。これは、呼び出し元のCoerceValueCallbackに存在する依存関係プロパティのプロパティメタデータで指定されたDependencyObject関数を呼び出すことによって実現されます。 (継承元 DependencyObject)
CopyPixels(Array, Int32, Int32)	指定したオフセットから始まる、指定したストライドを持つピクセルの配列にビットマップピクセルデータをコピーします。 (継承元 BitmapSource)
CopyPixels(Int32Rect, Array, Int32, Int32)	指定した四角形内のビットマップピクセルデータを、指定したオフセットから始まる指定したストライドを持つピクセルの配列にコピーします。 (継承元 BitmapSource)
CopyPixels(Int32Rect, IntPtr, Int32, Int32)	指定した四角形内のビットマップピクセルデータをコピーします。 (継承元 BitmapSource)
CreateInstance()	Freezable クラスの新しいインスタンスを初期化します。 (継承元 Freezable)
CreateInstanceCore()	派生クラスで実装された場合は、 Freezable 派生クラスの新しいインスタンスを作成します。 (継承元 Freezable)
EndInit()	BitmapImage初期化の終了を通知します。
Equals(Object)	指定された DependencyObject が現在の DependencyObjectと等しいかどうかを判断します。 (継承元 DependencyObject)
Freeze()	現在のオブジェクトを変更不可にし、その IsFrozen プロパティを `true`に設定します。 (継承元 Freezable)
FreezeCore(Boolean)	BitmapSourceまたは派生クラスのインスタンスを変更不可にします。 (継承元 BitmapSource)
GetAnimationBaseValue(DependencyProperty)	指定した DependencyPropertyのアニメーション化されていない値を返します。 (継承元 Animatable)
GetAsFrozen()	基本 (アニメーション化されていない) プロパティ値を使用して、 Freezableの固定コピーを作成します。コピーは固定されているため、固定されたサブオブジェクトは参照によってコピーされます。 (継承元 Freezable)
GetAsFrozenCore(Freezable)	このインスタンスを、指定した BitmapSource オブジェクトの複製にします。 (継承元 BitmapSource)
GetCurrentValueAsFrozen()	現在のプロパティ値を使用して、 Freezable の固定コピーを作成します。コピーは固定されているため、固定されたサブオブジェクトは参照によってコピーされます。 (継承元 Freezable)
GetCurrentValueAsFrozenCore(Freezable)	このインスタンスを、指定した BitmapSourceの固定された複製にします。リソース参照、データバインディング、およびアニメーションはコピーされませんが、現在の値はコピーされます。 (継承元 BitmapSource)
GetHashCode()	この DependencyObjectのハッシュコードを取得します。 (継承元 DependencyObject)
GetLocalValueEnumerator()	この DependencyObjectでローカルに値が設定されている依存関係プロパティを決定するための特殊な列挙子を作成します。 (継承元 DependencyObject)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetValue(DependencyProperty)	DependencyObjectのこのインスタンスの依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject)
InvalidateProperty(DependencyProperty)	指定した依存関係プロパティの有効な値を再評価します。 (継承元 DependencyObject)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
OnChanged()	現在の Freezable オブジェクトが変更されたときに呼び出されます。 (継承元 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	設定したばかりの DependencyObjectType データメンバーに対して適切なコンテキストポインターが確立されるようにします。 (継承元 Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	DependencyObjectのOnPropertyChanged(DependencyPropertyChangedEventArgs)実装をオーバーライドして、Changed型の依存関係プロパティの変化に応じてFreezable ハンドラーも呼び出します。 (継承元 Freezable)
ReadLocalValue(DependencyProperty)	依存関係プロパティが存在する場合は、そのローカル値を返します。 (継承元 DependencyObject)
ReadPreamble()	Freezableが有効なスレッドからアクセスされていることを確認します。 Freezableの継承子は、依存関係プロパティではないデータメンバーを読み取る API の先頭でこのメソッドを呼び出す必要があります。 (継承元 Freezable)
SetCurrentValue(DependencyProperty, Object)	値ソースを変更せずに依存関係プロパティの値を設定します。 (継承元 DependencyObject)
SetValue(DependencyProperty, Object)	依存関係プロパティ識別子で指定された依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
SetValue(DependencyPropertyKey, Object)	依存関係プロパティの DependencyPropertyKey 識別子で指定された、読み取り専用の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	シリアル化プロセスが指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。 (継承元 DependencyObject)
ToString()	現在のカルチャに基づいて、このオブジェクトの文字列表現を作成します。 (継承元 ImageSource)
ToString(IFormatProvider)	渡された IFormatProvider に基づいて、このオブジェクトの文字列形式を作成します。プロバイダーが `null`されている場合は、 CurrentCulture が使用されます。 (継承元 ImageSource)
VerifyAccess()	呼び出し元のスレッドがこの DispatcherObjectにアクセスできるように強制します。 (継承元 DispatcherObject)
WritePostscript()	ChangedのFreezable イベントを発生させ、そのOnChanged() メソッドを呼び出します。 Freezableから派生するクラスは、依存関係プロパティとして格納されていないクラスメンバーを変更する API の末尾でこのメソッドを呼び出す必要があります。 (継承元 Freezable)
WritePreamble()	Freezableが固定されていないこと、および有効なスレッドコンテキストからアクセスされていることを確認します。 Freezable 継承子は、依存関係プロパティではないデータメンバーに書き込む API の先頭でこのメソッドを呼び出す必要があります。 (継承元 Freezable)

イベント

名前	説明
Changed	Freezableまたはそれに含まれるオブジェクトが変更されたときに発生します。 (継承元 Freezable)
DecodeFailed	イメージヘッダーが破損しているため、イメージの読み込みに失敗したときに発生します。 (継承元 BitmapSource)
DownloadCompleted	ビットマップコンテンツが完全にダウンロードされたときに発生します。 (継承元 BitmapSource)
DownloadFailed	ビットマップコンテンツのダウンロードに失敗したときに発生します。 (継承元 BitmapSource)
DownloadProgress	ビットマップコンテンツのダウンロードの進行状況が変更されたときに発生します。 (継承元 BitmapSource)

明示的なインターフェイスの実装

名前	説明
IFormattable.ToString(String, IFormatProvider)	指定した形式を使用して、現在のインスタンスの値を書式設定します。 (継承元 ImageSource)

適用対象

こちらもご覧ください

フィードバック

このページはお役に立ちましたか?