BitmapCreateOptions BitmapCreateOptions BitmapCreateOptions BitmapCreateOptions Enum

定義

ビットマップ イメージの初期化オプションを指定します。Specifies initialization options for bitmap images.

この列挙型には FlagsAttribute 属性があり、メンバー値ではビットごとの組み合わせを使用できます。

public enum class BitmapCreateOptions
[System.Flags]
public enum BitmapCreateOptions
type BitmapCreateOptions = 
Public Enum BitmapCreateOptions
継承
BitmapCreateOptionsBitmapCreateOptionsBitmapCreateOptionsBitmapCreateOptions
属性

フィールド

DelayCreation DelayCreation DelayCreation DelayCreation 2

必要になるまで、BitmapSource オブジェクトの初期化を遅延させます。Causes a BitmapSource object to delay initialization until it is necessary. これは、イメージのコレクションを処理する場合に便利です。This is useful when dealing with collections of images.

IgnoreColorProfile IgnoreColorProfile IgnoreColorProfile IgnoreColorProfile 4

BitmapSource は埋め込まれたカラー プロファイルを無視します。Causes a BitmapSource to ignore an embedded color profile.

IgnoreImageCache IgnoreImageCache IgnoreImageCache IgnoreImageCache 8

既存のイメージのキャッシュを使用せずにイメージを読み込みます。Loads images without using an existing image cache. このオプションは、キャッシュ内のイメージを更新する必要がある場合にのみ選択します。This option should only be selected when images in a cache need to be refreshed.

None None None None 0

BitmapCreateOptions は指定されません。No BitmapCreateOptions are specified. これが既定値です。This is the default value.

PreservePixelFormat PreservePixelFormat PreservePixelFormat PreservePixelFormat 1

ファイルが格納されている PixelFormat が読み込まれる先と同じであるかどうかを確認します。Ensures that the PixelFormat a file is stored in is the same as it is loaded to.

次のコード例は、インスタンス化する方法を示します、BitmapImage指定IgnoreImageCacheします。The following code example demonstrates how to instantiate a BitmapImage and specify IgnoreImageCache.

// Define a BitmapImage.
Image myImage = new Image();
BitmapImage bi = new BitmapImage();

// Begin initialization.
bi.BeginInit();

// Set properties.
bi.CacheOption = BitmapCacheOption.OnDemand;
bi.CreateOptions = BitmapCreateOptions.DelayCreation;
bi.DecodePixelHeight = 125;
bi.DecodePixelWidth = 125;
bi.Rotation = Rotation.Rotate90;
MessageBox.Show(bi.IsDownloading.ToString());
bi.UriSource = new Uri("smiley.png", UriKind.Relative);

// End initialization.
bi.EndInit();
myImage.Source = bi;
myImage.Stretch = Stretch.None;
myImage.Margin = new Thickness(5);
' Define a BitmapImage.
Dim myImage As New Image()
Dim bi As New BitmapImage()

' Begin initialization.
bi.BeginInit()

' Set properties.
bi.CacheOption = BitmapCacheOption.OnDemand
bi.CreateOptions = BitmapCreateOptions.DelayCreation
bi.DecodePixelHeight = 125
bi.DecodePixelWidth = 125
bi.Rotation = Rotation.Rotate90
MessageBox.Show(bi.IsDownloading.ToString())
bi.UriSource = New Uri("smiley.png", UriKind.Relative)

' End initialization.
bi.EndInit()
myImage.Source = bi
myImage.Stretch = Stretch.None
myImage.Margin = New Thickness(5)

注釈

PreservePixelFormat が選択されていない場合、PixelFormatイメージのシステムによって選択された依存関係が、システムの判断基準、最高のパフォーマンスになります。If PreservePixelFormat is not selected, the PixelFormat of the image is chosen by the system depending on what the system determines will yield the best performance. このオプションを有効にすると、ファイル形式が使用されますが、パフォーマンスが低下する可能性があります。Enabling this option preserves the file format but may result in lesser performance.

場合BitmapCreateOptionsIgnoreColorProfile に設定されているなどのメソッドを呼び出し、CopyPixels(Array, Int32, Int32)色補正のビットは返されません。If BitmapCreateOptions is set to IgnoreColorProfile, calls to methods such as CopyPixels(Array, Int32, Int32) will not return color-corrected bits.

同じ共有している場合でも、イメージ キャッシュ内の既存のエントリが置き換えられます IgnoreImageCache を選択すると、Uriします。When IgnoreImageCache is selected, any existing entries in the image cache are replaced even if they share the same Uri.

適用対象

こちらもご覧ください