バージョン

エディター

DataPresenterBase クラスから派生したすべての Ultimate UI for WPF コントロールは、拡張可能な編集オブジェクト モデルにユーザーの編集体験をデリゲートするという同じパターンに従っています。これによって、状況に最も適した xamEditor コントロールにプラグインすることができます (xamTextEditor など)。どのようなコントロールを使用していようとも、エディターのプログラミングを容易にするいくつかの一般的な原則もあります。

コントロールに組み込み可能なすべてのエディターは、ValueEditor 抽象基本クラスを拡張します。次にエディターは、継承によって必要な特化した編集機能を追加します。xamEditor コントロールのグループ化は、最も頻繁に遭遇するデータ入力のシナリオのためのエディターを提供するため、固有のエディターを記述する必要はありません。この基本クラスは、すべてのエディターに編集関連イベントの一般的なセットを提供します (詳細は、ValueEditor クラスの概要を参照)。これによってエディターを操作することができます。

コントロールによって表示される値とエディターを関連付けるために使用できる 3 つのプロパティがあります。

  • EditorType -- これは、特化したエディター クラスのタイプです。ValueEditor から継承する必要があります。

  • EditAsType -- これは、データを編集する時にエディターが使用すべきタイプです。たとえば、String に格納される数値データ値を編集するためにこれを Double に設定することができます。String がスキーマを認識しない XML データ プロバイダーから生じるために、Field に数しか含まれていないとしてもこれが発生する場合があります。

  • EditorStyle -- これは編集モードのときにエディターの外観を制御します。

エディターは Field または Cell レベルのいずれかで適用できます。

上記の図は、エディターを WPF コントロールと関連付けることができる 2 つの異なる範囲を示しています。

  • フィールド レベル --  FieldSettings で一度エディターを設定し、持っているデータ レコードの数に関係なく、そのフィールド内のすべてのセルに再利用されます。

  • セル レベル --  DataRecord の各 Cell にエディターを設定します。同じ Field の異なるセルの値が異なる種類のエディターを必要とした場合にこれを実行します。

セル レベルでエディターを設定する場合には、 InitializeRecord イベントを処理することを推奨します。