SelectItemForm

SelectItemForm is a dialogue form which is using for select an item from lists such as IEnumerable or DataTable. Also, the SelectItemForm has ability to search items by criteria.

Simple using SelectItemForm

var items = new Dictionary<int, string>();
items.Add(1, "First value");
items.Add(2, "Second value");
items.Add(3, "More values...");
using (var form = SelectItemForm.CreateFormWithoutColumns(
                      items, "My values", "These values are mine"))
{
  form.dataGrid.AddTextColumn("key", "Key").SetNumberStyle();
  form.dataGrid.AddTextColumn("value", "Value").SetAutoSizeFillStyle(50);
  form.ShowDialog();
}

SelectItemForm

Using SelectItemForm with DataTable

var items = new DataTable();
items.Columns.AddRange(new DataColumn[] {
    new DataColumn("ID", typeof(byte)),
    new DataColumn("Group", typeof(string)),
    new DataColumn("Remarks", typeof(string))});
items.Columns[0].Unique = true;
items.Columns[2].AllowDBNull = true;
items.Rows.Add(0, "Default");
items.Rows.Add(1, "Regular", "Regular group");
items.Rows.Add(2, "RG+Bonus", "Regular group with bonuses");
items.Rows.Add(3, "RET");
items.Rows.Add(4, "BIN");
using (var form = SelectItemForm.CreateFormWithoutColumns(items, "Groups"))
{
  form.dataGrid.AddTextColumn(
        items.Columns[0].ColumnName, "ID").SetNumberStyle();
  form.dataGrid.AddTextColumn(
        items.Columns[1].ColumnName, "Group");
  form.dataGrid.AddTextColumn(
        items.Columns[2].ColumnName, "Remarks").SetAutoSizeFillStyle(50);
  form.ShowDialog();
}

SelectItemForm

The methods

In additional, SelectItemForm provides methods for setting text on Header and Footer:

public void SetHeaderText(string Text)

public void SetFooterText(string Text)

The static methods

The main static method for selecting an item from IEnumerable:

public static T GetSelectedRow<T>(
                    string Text, string HeaderText, 
                    IEnumerable<T> DataSource, T SelectedRow, 
                    params SelectItemForm.ColumnDefinition[] Columns)

The main static method for selecting DataRow from typed or untyped DataTable:

public static T GetSelectedRow<T>(
                    DataTable DataSource, T SelectedRow, 
                    params SelectItemForm.ColumnDefinition[] Columns) 
                where T : DataRow

The main static method for selecting untyped DataRow from any DataSource:

public static DataRow GetSelectedRow(
                          object DataSource, 
                          string ValueMember = null, 
                          string DisplayMember = null, 
                          object SelectedValue = null, 
                          bool AutoGenerateColumns = false)

The main static method for showing data from any DataSource:

public static DialogResult
                  ShowData(
                      object DataSource, 
                      string Text, string HeaderText, 
                      params SelectItemForm.ColumnDefinition[] Columns)