HotXLS Docs

活頁簿檢視器功能

概覽

除了檔案操作之外，Delphi 桌面應用程式常常還需要顯示甚至編輯活頁簿；HotXLS 內建一個視覺化 VCL 控制項，可以直接呈現兩種活頁簿模型

TXLSWorkbookViewer 控制項

TXLSWorkbookViewer 元件提供捲動、矩形選取、編輯、公式輸入、備註、超連結、條件式格式與列印預覽，而且不必產生暫存檔案

指定 Workbook 可掛上傳統 XLS 活頁簿，指定 XlsxWorkbook 可掛上 XLSX 與 ODS 活頁簿，或呼叫 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 結束

顯示屬性

請查看下方的設定控制項

Copyright © 2010-2026 losLab Software