BitmapImage.DecodePixelType プロパティ

定義

デコード操作で DecodePixelWidth 値と DecodePixelHeight 値を解釈する方法を決定する値を取得または設定します。

public:
 property DecodePixelType DecodePixelType { DecodePixelType get(); void set(DecodePixelType value); };
DecodePixelType DecodePixelType();

void DecodePixelType(DecodePixelType value);
public DecodePixelType DecodePixelType { get; set; }
var decodePixelType = bitmapImage.decodePixelType;
bitmapImage.decodePixelType = decodePixelType;
Public Property DecodePixelType As DecodePixelType

プロパティ値

列挙体の値。 既定値は [物理] です

注釈

DecodePixelType は、 論理 または 物理に設定できます。 既定値は [物理] です。 DecodePixelType が設定されていない場合、または Physical に設定されている場合、イメージは、物理ピクセルを表す DecodePixelWidth 値と DecodePixelHeight 値を使用してデコードされ、デコード操作はこれらの値を直接使用します。 DecodePixelType が Logical に設定されている場合、イメージは、論理ピクセルを表す DecodePixelWidth 値と DecodePixelHeight 値を使用してデコードされます。 内部ロジックは、デバイスの解像度情報と、ターゲット デバイスでの論理ピクセルと物理ピクセルの要因に基づいて、デコードの幅と高さを変換します。

Image 要素の高さは、イメージがレンダリングされると論理ピクセルで指定されますが、それらの論理ピクセルはデバイスの解像度の影響を受けます。 イメージ ファイル ソースを表す BitmapImage 要素の場合、 DecodePixelWidthDecodePixelHeight は既定で物理ピクセルで指定されます。 デコード操作用に指定された の物理ピクセル値は、メモリ内に作成されるビットマップのサイズに影響します。 DecodePixelType を 論理として指定すると、論理解像度に対して事前に考慮された値を使用してイメージがデコードされ、メモリがそれほど多く使用されない可能性があります。 デバイスの解像度とイメージ ソースの詳細については、「 有効なピクセルとスケーリング」を参照してください。

適用対象