BitmapCreateOptions 列挙型
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ビットマップ イメージの初期化オプションを指定します。
この列挙体は、メンバー値のビットごとの組み合わせをサポートしています。
public enum class BitmapCreateOptions[System.Flags]
public enum BitmapCreateOptions[<System.Flags>]
type BitmapCreateOptions = Public Enum BitmapCreateOptions- 継承
- 属性
フィールド
| DelayCreation | 2 | 必要になるまで、BitmapSource オブジェクトの初期化を遅延させます。 これは、イメージのコレクションを処理する場合に便利です。 |
| IgnoreColorProfile | 4 | BitmapSource は埋め込まれたカラー プロファイルを無視します。 |
| IgnoreImageCache | 8 | 既存のイメージのキャッシュを使用せずにイメージを読み込みます。 このオプションは、キャッシュ内のイメージを更新する必要がある場合にのみ選択します。 |
| None | 0 | BitmapCreateOptions は指定されません。 これが既定値です。 |
| PreservePixelFormat | 1 | ファイルが格納されている PixelFormat が読み込まれる先と同じであるかどうかを確認します。 |
例
次の例では、列挙値をインスタンス化 BitmapImage して指定する方法を BitmapCreateOptions 示します。
// 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 システムによって決定される内容に応じて、イメージの選択によって最適なパフォーマンスが得られます。 このオプションを有効にすると、ファイル形式は保持されますが、パフォーマンスが低下する可能性があります。
設定されている場合 IgnoreColorProfile 、メソッドなどの CopyPixels(Array, Int32, Int32) 呼び出しでは、色補正されたビットは返されません。
設定されている場合 IgnoreImageCache 、イメージ キャッシュ内の既存のエントリは、同じ Uriエントリを共有している場合でも置き換えられます。