ワークブックビューアー機能

概要

ファイル操作に加えて、Delphi デスクトップアプリケーションではワークブックの表示や編集が必要になることがよくあります。HotXLS には、どちらのワークブック モデルも直接レンダリングするビジュアル VCL コントロールが含まれています

TXLSWorkbookViewer コントロール

TXLSWorkbookViewer コンポーネントは、一時ファイルを作成することなく、スクロール、矩形選択、編集、数式入力、コメント、ハイパーリンク、条件付き書式、印刷プレビューを提供します

クラシック XLS なら Workbook を、XLSX と ODS のワークブックなら XlsxWorkbook を割り当てるか、LoadFromFile を呼び出してロードしたワークブックをコントロールに所有させます

編集と数式入力

Editable を True に設定すると、F2、ダブルクリック、印字キー、Delete、数式バーによる編集が有効になります。保護されたロック済みセルは読み取り専用のまま、明示的にロック解除されたセルは編集可能なままです

FormulaBarText は、選択されたセルの数式を先頭の等号付きで、または入力値をそのまま返します。このプロパティに代入すると、新しい数式または入力値が適用され、依存する数式が再計算されます

Undo と Redo は、UndoLimit で制御される上限付きの循環履歴を使用します。新しく作成した XLSX セルを元に戻すと、存在しないスパース ストレージ状態が復元されます。各履歴エントリは TXLSViewerCellState スナップショット（ワークブックの種類、存在、シート、座標、数式、値、書式状態）で、公開されている状態読み取りメソッドからも取得できます

編集フックは型付きコールバックです。OnBeforeEdit（TXLSViewerBeforeEditEvent）は提案されたテキストを受け取り、Allow と Text によって拒否または書き換えできます。OnAfterEdit（TXLSViewerAfterEditEvent）はコミットされたテキストを報告します

Viewer.Editable := True;
Viewer.GoToCell(2, 3);
Viewer.FormulaBarText := '=A1*2';
Viewer.Undo;
Viewer.Redo;

範囲と参照の選択

Shift ナビゲーション、マウス ドラッグ、または SelectRange で矩形選択を作成できます。選択は SelectionTop、SelectionLeft、SelectionBottom、SelectionRight、SelectedRange として公開されます

BeginReferencePick で数式参照モードが有効になり、選択が変わるたびに OnReferencePick（TXLSViewerReferenceEvent）が現在の A1 範囲を通知します。ホストの数式エディタが参照を受け入れたら EndReferencePick を呼び出します

表示プロパティ

以下の設定コントロールを確認してください

• WorkbookViewer コンポーネントリファレンスガイド — 編集、ナビゲーション、イベント、レンダリング、プレビュー コントロール
• DisplayGridLines プロパティ — グリッドの罫線を切り替えます
• Zoom プロパティ — シートのズーム比率を設定します