バージョン

WinGrid 内で WinComboEditor を使用

始める前に

このトピックは 2 部から構成される詳細なガイドの第 2 部です。 このトピックの理解を最大限に深めるためには、 「WinGrid 内で WinDropDown を使用」を参照してください。

達成すること

「WinGrid 内で WinDropDown を使用」で作業をしてきた既存の Windows Form サンプルを使用し、WinComboEditor™ を使用して値のシンプルなドロップダウン リストを EmployeeID 列に追加します。これは Orders Entity を Employees Entity に関係づける Foreign Key を表します。

次の手順を実行します

  1. Visual Studio ツールボックスで、UltraComboEditor コントロールを指定して Form にドラッグします。

  2. DataSource プロパティを Employees DataTable に設定します。

  3. DisplayMember プロパティを FirstName に設定します。 これはドロップダウン リスト内に表示するためにこのフィールド内でデータを使用するように ComboEditor に通知します。

  4. その ValueMember プロパティを EmployeeID に設定します。 これは WinGrid の EmployeeID 列に指定するためにこのフィールド内でデータを使用するように ComboEditor に通知します。 つまり、ユーザーがリスト項目を選択すると、その選択された項目からの関連づけられた EmployeeID 値がその行の実際の WinGrid EmployeeID セルに指定されます。 これはその列内の既存の値に基づいてどのリスト項目が自動的に選択されるのかも示します。

  5. WinGrid の [スタート] ボタンをクリックすることによって UltraWinGrid デザイナーを起動します。

  6. [バンドおよび列の設定] で、[バンド[0] - 'Orders'] の順にノードを展開し、列ノードをクリックします。

  7. EmployeeID 列を指定してクリックします。

  8. ComboEditor を列の EditorComponent プロパティに指定します。 EditorComponent プロパティを指定して、ドロップダウン リストから UltraComboEditor1 を選択します。

UltraGrid デザイナー
  1. 適切な Data Adapters または Table Adapters を使用して Employees DataTable を埋めて生成するためのコードがあることを前提として、アプリケーションを実行すると、WinGrid は以下の画像のようになります。

ultragrid 内の ultradropdown を使用します

今回、値の非常にシンプルなドロップダウン リストがどのようにできたかに注目してください。 多数の列を示す DropDown と異なり、ComboEditor は一列の情報しか表示しません。 もうひとつ注目すべきことは、実行する時に ComboEditor が Windows Form にまだ表示されているという事実です。 エンドユーザーに表示されないように Visible プロパティを False に設定する必要があります。 通常、すべての IProvidesEmbeddableEditor の実装では、ランタイムに非表示になるように Visible プロパティを False に設定する必要があります。 このインターフェイスを実装するコントロールは、WinGrid 内に組み込むことも可能であることに加えて、ほとんど常に Windows Form に配置されるスタンドアローンのエディターとして使用できるため、これは通常そうなります。 UltraComboEditor の使用の長所は、データ入力にとって意味がない(読み取り専用)WinGrid があったとしても Foreign Key フィールドに関連づけられたユーザー フレンドリーな文字列を示すためにこの方法をこれまで同様使用できます。 これは、Join to the Lookup Table を含むように SQL ステートメントを変更することによって、オブジェクトの固有のリストを作成することよりも遙かに簡単です。