画像フィールドの構成 (XamDataGrid)

このトピックでは、XamDataGrid コントロールで ImageField を使用して画像を表示するフィールドを作成する方法を説明します。

本トピックの理解を深めるために、以下のトピックを参照することをお勧めします。

トピック	目的
用語と概念	このセクションでは、Data Presenter Family のコントロールを構成する主要な要素を定義します。
XamDataGrid をページに追加	このトピックでは、XamDataGrid コントロールをページに追加する方法について説明します。
フィールドの生成、手動と自動	このトピックでは、XamDataGrid コントロールで FieldLayout および Field を手動で指定する方法を説明します。

このトピックは、以下のセクションで構成されます。

画像フィールドの構成の概要

ImageField を以下の型を表す値がある基本データ項目のプロパティに関連できます。

ImageField の関連付けたエディターは ImageEditor 型の要素です。このエディターは常に読み取り専用で、画像を描画するためにデザインされました。つまり、編集モードに入ることができません。

以下の表は、画像の描画する方法を制御する ImageField の構成可能なプロパティを説明します。

プロパティ名	プロパティ型	説明
BaseUri	`Uri`	画像の位置設定に使用する基本 Uri を取得または設定します。この値は、セルのバインドされたデータが Uri または UriString を含む場合に完全に解決された URI を構築するために使用されます。
ImageHeight	`double`	画像を描画するためにエディターが使用する高さを返すか、設定します。double.NaN (デフォルト値) に設定される場合、画像がその高さを使用して描画されます。
ImageWidth	`double`	画像を描画するためにエディターが使用する幅を返すか、設定します。double.NaN (デフォルト値) に設定される場合、画像がその幅を使用して描画されます。
Stretch	`Stretch`	描画された画像が指定した長方形を埋めるために引き伸ばす方法を説明する値を返すか、設定します。
StretchDirection	`StretchDirection`	描画された画像を拡大縮小する方法を示す値を返すか、設定します。

以下のスクリーンショットは、以下のコード例を使用した結果、ImageField がどのように表示されるかを示しています。

以下のコードは ImageField を XamDataGrid に実装します。「Photo」は基本データ項目のプロパティで、上記の型があります。

XAML の場合:

<igDP:ImageField Name="Photo" ImageHeight="100" ImageWidth="100" />

このトピックに関連する追加情報については、以下のトピックを参照してください。

トピック	目的
フィールドレイアウトの定義	このトピックでは、表示するフィールドを指定し、XamDataGrid コントロールでこれらのフィールドに関連するプロパティを設定するために、フィールドのレイアウトを定義する方法を説明します。
フィールドの生成、手動と自動	このトピックでは、XamDataGrid コントロールによるフィールドの自動生成と手動生成の違いを説明します。
フィールドレイアウトの XamDataGrid への手動割り当て	このトピックでは、XamDataGrid コントロールに対する複数の FieldLayouts を作成する方法を説明します。