7.3 列・編集・選択

Tableの列・編集・選択

モデル列と表示列

Modelの列はデータの型を定め、append_*_columnはそれをどう表示・操作するかを定めます。前ページの1列モデルなら、表示列は次のように作れます。

table = UIng::Table.new(model) do
  append_text_column("Language", 0, editable: :always)
end

複数列に拡張する場合、各表示列に対応する型のモデル列を先に用意します。

表示列	追加メソッド	データ列の型
テキスト	`append_text_column`	`String`
画像	`append_image_column`	`Image`
チェックボックス	`append_checkbox_column`	`Int`
進捗バー	`append_progress_bar_column`	`Int`
ボタン	`append_button_column`	`String`

画像付きテキストやチェックボックス付きテキストは複数のモデル列を参照します。テキスト色にはColor列、編集可否やクリック可否を行ごとに切り替える場合はInt列を追加できます。列の引数はAPIリファレンスを確認してください。

編集を元データへ反映する

editable: :alwaysを指定すると、ユーザー操作でset_cell_valueが呼ばれます。そこでTableではなく元データを更新します。受け取る値はコールバックの外へ保存しません。

set_cell_value do |row, column, value|
  next unless column == 0
  next unless name = value.try(&.string)

  rows[row] = name
end

このコールバックを前ページのHandlerに追加します。ユーザーの編集をこのコールバックで受けた場合、row_changedを追加で呼ぶ必要はありません。アプリケーションの別の処理で値を変えた場合は通知します。

ボタン列のクリックではvalueがnilになります。列番号を確認して、その行に対する操作を実行してください。純粋な読み取り専用のTableではset_cell_valueを省略できますが、ボタン列を使う場合は登録します。

選択とクリック

選択はselection_modeで制御します。

モード	選択できる行数	用途
`None`	0	行選択を無効にする
`ZeroOrOne`	0または1	任意選択の単一行リスト
`One`	常に1	必ず1行を選ばせる画面
`ZeroOrMany`	0以上	複数選択

on_selection_changedのSelectionは選択行のスナップショットです。コールバック後も保持でき、freeは不要です。selection.rowsは行番号の配列をコピーして返します。 table.selectionで直接取得した値も同じように扱えます。

table.selection_mode = UIng::Table::Selection::Mode::ZeroOrOne
table.on_selection_changed do |selection|
  selected_rows = selection.rows
  puts(selected_rows.empty? ? "未選択" : rows[selected_rows.first])
end

table.on_row_double_clicked do |row|
  puts "ダブルクリック: #{rows[row]}"
end

選択行の番号を一度だけ順に処理する場合はeach_selected_indexを使えます。ネイティブの選択結果を直接走査するため、行番号をCrystalの配列へコピーしません。ネイティブの選択結果は、途中で例外が発生しても列挙後に解放されます。

table.each_selected_index do |row_index|
  puts rows[row_index]
end

ヘッダークリックや行クリックのイベントも利用できます。ソートを実装する場合は元データを並べ替えた後、表示に変更を通知します。

発展例はadvanced_table.crを参照してください。