[ CompositionBoxColumn ] IMEを利用して入力した文字列(フリガナ)を取得&設定する機能を持った DataGridTextBoxColumn 型の DataGridColumnStyle クラスライブラリ

【概要】

  Windows.Forms.DataGridColumnStyle をベースにした、IMEを利用して入力した文字列(フリガナ)を、取得&設定する機能を持ったDataGridTextBoxColumn型のDataGrid組込み用のクラスライブラリです。

【特徴】

  ・DataGridTableStyle に組み込むことができる、TextBox型の DataGridColumnStyle です。
 ・DataGridTextBoxColumn と同等の機能を提供します。
  ・従属する列を設定できます。これにより、IMEを利用して入力した文字列(カナ文字)を指定した列に連動して設定します。
  ・従属列の初期化(クリア)入力機能を提供します。全置換または空状態での入力時には、従属する列の値を一度クリアします。
 ・従属列の連動削除機能を提供します。入力欄で全て削除した場合、従属する列の値を空にします。
 ・個々のセル単位で、編集および描画の条件設定ができます。
     ・セルの編集が開始されるときにイベントが発生します。
     ・セルが描画されるときにイベントが発生します。
ダウンロード (CompositionBoxColumn.lzh、8.38KB : C#.NETソースコード)
【使い方】
 DataGridTableStyleに設定するには、以下の様に記述します。
// インスタンスを生成します。
CompositionBoxColumn myColumn = new CompositionBoxColumn();

// 従属する列名を設定する
myColumn.ChildMappingName = childColumn;

// DataTable項目名を設定
myColumn.MappingName = name;
// DataGrid列項目名を設定
myColumn.HeaderText = headerText;
// DataGrid列幅を設定
myColumn.Width = width;
// DataGrid列表示位置を設定
myColumn.Alignment = alignment;
// DataGrid Nullデータ表示形式を設定
myColumn.NullText = " ";            

// DataGrid列表示書式を設定
if ( myFormat != "" )
    myColumn.Format = myFormat;

// DataGrid日本語入力形式を設定
myColumn.ImeMode = ImeMode;

// DataGrid編集可否を設定
if ( readOnlyFlag )
    myColumn.ReadOnly = readOnlyFlag;

// ValueEventルーチンの設定
if ( ValueEvent != null )
    myColumn.ValueChanging += new ValueChangingEventHandler(ValueEvent);

// FormatEventルーチンの設定
if ( FormatEvent != null )
    myColumn.CellFormat += new CellFormatEventHandler(FormatEvent);

// GridColumnStyles定義を追加(ts:DataGridTableStyle)
ts.GridColumnStyles.Add(myColumn);
カスタムプロパティ 説  明
ChildMappingName 従属する列を指定する為に使用する名前を取得または設定します。

カスタムイベント 説  明
CellFormat セルが描画されるときに発生します。
ValueChanging セルの編集が開始されるときに発生します。

【補足】

  上記プロパティ/イベントには DataGridTextBoxColumn と共通する内容は含んでいません。
【参考】 このライブラリで内でのDataGridTextBoxの拡張は諸農さんのサンプルを参考にさせていただいています。
【利用法】
このライブラリは、システム開発に利用できるように、.NET 上のクラスライブラリとして作られています。
単独の DLL として参照設定して利用するか、プロジェクト内に追加して利用してください。
また、標準の DataGridTextBoxColumn と置換えて利用してください。
【注意】 このライブラリを利用する場合、利用規約を確認してください。
Home | Library | 戻る