概觀

HotXLS Excel 讀寫元件庫是適用於 Delphi 和 C++Builder 的高效能 Excel 讀寫元件 它無需在電腦上安裝 Microsoft Excel 或 Office，即可建立新的 Excel 試算表，並讀取或修改現有的 XLS 和 XLSX 活頁簿 HotXLS 完全以 Object Pascal 撰寫。它在二進位和 OOXML 層級直接讀寫 Excel 檔案， 因此沒有 COM/OLE 自動化的額外負擔，也不依賴 Office 的授權或安裝。HotXLS 支援 Delphi 和 C++Builder XE5 至 13 Florence 傳統 XLS 色彩格式設定刻意保持以調色盤為基礎的方式。ThemeColor / TintAndShade 的設計決策請參閱 傳統 XLS 色彩模型

lxHandle	Excel 97–2003 BIFF8 格式（.xls）的主要介面，另支援 HTML、RTF、CSV 和 TSV 匯出 所有現有使用者程式碼可繼續使用此單元而無需變更。進入點： TXLSWorkbook、TXLSWorksheet、IXLSWorkbook、IXLSRange
lxHandleX	Excel 2007+ OOXML 格式（.xlsx）和 OpenDocument Spreadsheet（.ods）讀寫的主要介面 提供專屬的活頁簿和工作表型別，以避免將 XLSX 特有行為強加於 BIFF 程式碼路徑。進入點： TXLSXWorkbook、TXLSXWorksheet、TXLSXCell

傳統 XLS（lxHandle）

uses lxHandle;

var
  Book: IXLSWorkbook;
  ws:   TXLSWorksheet;
begin
  Book := TXLSWorkbook.Create;
  // 新增工作表並命名
  ws := Book.Sheets.Add;
  ws.Name := 'Sheet1';

  // 使用 A1 表示法向儲存格寫入值
  ws.Range['A1'].Value := 'Hello';
  ws.Range['B1'].Value := 42;
  ws.Range['C1'].Formula := '=B1*2';

  // 套用基本格式設定
  ws.Range['A1'].Font.Bold := True;
  ws.Range['A1'].Interior.Color := clYellow;

  Book.SaveAs('output.xls');
end;

XLSX（lxHandleX）

uses lxHandleX;

var
  Book: TXLSXWorkbook;
  ws:   TXLSXWorksheet;
  cell: TXLSXCell;
begin
  Book := TXLSXWorkbook.Create;
  try
    ws := Book.Sheets.Add('Sheet1');

    // 寫入字串和數值
    ws.Cells[1, 1].Value := 'Product';
    ws.Cells[1, 2].Value := 'Price';
    ws.Cells[2, 1].Value := 'Widget';
    ws.Cells[2, 2].Value := 9.99;

    // 套用貨幣數字格式
    cell := ws.Cells[2, 2];
    cell.NumberFormat := '$#,##0.00';

    Book.SaveAs('output.xlsx');
  finally
    Book.Free;
  end;
end;

檔案 I/O 與串流支援

儲存格值與公式

• 文字函式（LEFT、MID、TRIM、SUBSTITUTE、…）
• 日期和工作日函式（DATE、NETWORKDAYS、WORKDAY、…）
• 工程和進位制轉換函式（BIN2DEC、HEX2DEC、…）
• 位元運算函式（BITAND、BITOR、BITXOR、…）
• 統計和彙總函式（AVERAGE、SUMIF、COUNTIFS、…）
• 數學函式（ROUND、MOD、POWER、…）

儲存格格式設定

• 字型 — 名稱、大小、色彩（RGB 或佈景主題色彩 + 色調）、粗體、斜體、底線、 刪除線、上標、下標、陰影和外框
• 對齊方式 — 水平和垂直對齊、文字方向（角度）、縮排層級、自動換列、 縮小至適當大小，以及閱讀順序（RTL/LTR）
• 框線 — 四個邊緣和對角線、線條樣式、粗細，以及 RGB / 佈景主題色彩
• 內部（填滿） — 純色填滿、圖樣填滿、前景色和背景色， 包含具有 TintAndShade 的佈景主題色彩
• 數字格式 — 日期、時間、貨幣、百分比和科學記號的內建和自訂格式字串
• 註解 / 附註 — 新增、讀取和設定儲存格註解的樣式

範圍操作

• 合併和取消合併儲存格；存取任一儲存格的合併區域
• 複製、移動、插入和刪除範圍，並可控制位移方向
• 對列或欄進行群組和取消群組，以建立大綱/摺疊檢視
• 根據儲存格內容自動調整列高和欄寬
• 套用內建具名儲存格樣式（ApplyBuiltinStyle）
• 多重選取區域（TXLSWorksheet.SelectAreas）
• ForEachCell 迭代回呼，用於批次儲存格處理

工作表功能

• 工作表名稱、索引標籤色彩、可見性（隱藏 / 非常隱藏），以及以索引為基礎的導覽
• 具有逐權限細部設定的工作表保護；活頁簿層級保護
• 凍結窗格、分割窗格和捲動位置
• 含準則的自動篩選範圍；清單資料驗證規則
• 條件格式設定：色階（2 色和 3 色）、資料橫條和圖示集
• 在工作表中尋找文字和取代文字
• 檢視選項：格線色彩、顯示公式模式、顯示零值、顯示標題、 顯示由右至左、顯示大綱符號和縮放層級
• 結構化表格（TXLSTable / TXLSXTable）：新增、存取和設定含標題列和帶狀列的 Excel 表格樣式
• 圖表：透過 TXLSWorksheetsAddChartSheet 和 TXLSXChart 新增圖表工作表和內嵌圖表

超連結與具名範圍

圖像與圖形

版面設定與列印

• 紙張大小（A4、Letter、Legal 及多種其他尺寸；請參閱 PaperSize）
• 方向（直向 / 橫向）、邊界、水平 / 垂直置中
• 含 Excel 格式代碼的頁首和頁尾字串（粗體、斜體、頁碼、日期等； 請參閱 頁首/頁尾格式代碼）
• 手動水平和垂直分頁
• 縮放至頁數；縮放百分比；列印範圍；列印標題（重複列 / 欄）
• 草稿品質；黑白列印；列印格線；列印標題；列印備註

匯出格式

• HTML — 完整文件或內嵌表格片段，用於預覽或電子郵件工作流程； 可透過 TXLSHTMLExport 和 TXLSXHtmlExportOptions 控制
• RTF — 用於文書處理器匯入的富文字格式
• CSV — 可設定分隔符號和編碼的逗號分隔值
• TSV — 定位字元分隔值
• ODS — 透過 lxHandleX 介面的 OpenDocument Spreadsheet

資料庫與格線匯出

VBA 專案保留

Unicode 與國際化文字

樞紐分析表（傳統 XLS）

No Office dependency	直接在二進位層級讀寫 XLS 和 XLSX 檔案。無需安裝、授權或執行 Microsoft Excel 或 Office 這消除了 COM/OLE 自動化的額外負擔，避免了 Office interop 施加的執行緒限制， 並允許在不適合安裝桌面 Office 的伺服器端和服務情境中使用 HotXLS
High performance	BIFF8 和 OOXML 解析器以原生 Object Pascal 撰寫，關鍵路徑不進行中間 XML DOM 配置 含有數十萬列的大型活頁簿可以在較低的記憶體峰值下讀寫 共用字串去重複和共用公式壓縮會自動套用，以縮小檔案大小
OLE migration path	傳統介面的 API 介面（活頁簿、工作表、範圍、字型、框線、內部、版面設定） 緊密對應 OLE Automation 中熟悉的 Excel 物件模型 這使得現有 OLE 專案的移轉變得簡單：將 COM 呼叫替換為 HotXLS 呼叫， 移除 Office 相依性，並獲得原生效能
Dual-facade design	舊版 XLS 程式碼可繼續針對 lxHandle 編譯和執行而無需任何變更， 同時新的 XLSX 程式碼使用功能更豐富的 lxHandleX 介面 一次移轉一種檔案格式既安全又漸進
Formula engine included	內建多道計算引擎可處理最常見的工作表函式，而無需 Excel 在開啟時重新計算 自訂函式透過 OnUserFunction 回呼處理
Easy to use	即插即用的 Delphi 元件（TDataToXLS、TGridToXLS）對於常見的匯出工作無需撰寫程式碼 流暢的範圍 API 支援 A1 表示法、R1C1 表示法和以零為基礎的列 / 欄索引
Thread-safe file I/O	由於沒有共用的 Office 處理程序，多個 TXLSXWorkbook 執行個體可在獨立執行緒上並行建立和儲存， 無需同步，使 HotXLS 適用於多執行緒報表產生伺服器

Delphi	XE5、XE6、XE7、XE8、10 Seattle、10.1 Berlin、10.2 Tokyo、10.3 Rio、 10.4 Sydney、11 Alexandria、12 Athens、13 Florence
C++Builder	XE5、XE6、XE7、XE8、10 Seattle、10.1 Berlin、10.2 Tokyo、10.3 Rio、 10.4 Sydney、11 Alexandria、12 Athens、13 Florence
Target platforms	Windows 32 位元和 64 位元
Excel file formats	XLS（BIFF8，Excel 97–2003）、XLSX（OOXML，Excel 2007+）、ODS（OpenDocument 1.2）
Export-only formats	HTML、RTF、CSV、TSV

• XLSX 介面概觀（lxHandleX） — 完整類別階層及 XLSX/ODS 特有的 API 成員
• API 導覽範例 — 從頭學習 HotXLS 時的第一個執行範例
• IXLSWorkbook — 傳統 XLS 活頁簿介面參考
• TXLSWorksheet — 傳統 XLS 工作表類別參考
• IXLSRange — 範圍介面：儲存格存取、格式設定和操作
• TXLSXWorkbook — XLSX 活頁簿類別參考
• TXLSXWorksheet — XLSX 工作表類別參考
• TGridToXLS — 即插即用的 DBGrid 轉 Excel 匯出元件
• TDataToXLS — 即插即用的資料集轉 Excel 匯出元件
• OnUserFunction 回呼 — 自訂工作表函式擴充點
• 傳統 XLS 色彩模型 — 以調色盤為基礎的色彩和佈景主題色彩設計原理
• 傳統 XLS 其他 API 成員 — 計算屬性、文件屬性、樞紐分析表等
• 範例 — 範例專案概觀
• 採購單範例 — 含原始程式碼的完整 XLS 建立範例