مستندات HotXLS

پشتیبانی Free Pascal و Lazarus

HotXLS از Free Pascal 3.2.2 همراه با Lazarus/LCL روی Windows Win32 و Win64 پشتیبانی می‌کند، شامل APIهای کتاب‌کار XLS/XLSX، فرمول‌ها، قالب‌بندی، جریان‌دهی مستقیم، اجزای export TDataToXLS و TGridToXLS و کمک‌کارهای رندر

ساخت و آزمون

Lib/FPC/HotXLSLaz.lpk را در Lazarus باز کنید و بسته زمان اجرا را کامپایل کنید، یا این فرمان‌ها را از دایرکتوری HotXLS اجرا کنید

build-FPC-Lib.cmd Win64
Tests\Lazarus\Run-HotXLSLazarusSmoke.cmd Win64
build-FPC-Lib.cmd Win32
Tests\Lazarus\Run-HotXLSLazarusSmoke.cmd Win32

LAZARUS_DIR را برای انتخاب یک نصب تنظیم کنید؛ در صورت نیاز FPC_EXE و LAZBUILD_EXE می‌توانند فایل‌های اجرایی صریح کامپایلر و سازنده بسته را انتخاب کنند

نصب انتخاب‌شده باید برای معماری هدف دربردارنده FPC و واحدهای کامپایل‌شده LCL/LazUtils باشد؛ خروجی‌ها و پیکربندی سازنده بسته در دایرکتوری‌های جداگانه برای هر معماری نگه داشته می‌شوند

راه‌اندازی برنامه

Lib و Lib/FPC را به مسیر جست‌وجوی واحدها و Lib را به مسیر جست‌وجوی include بیفزایید، یا بسته زمان اجرا را به‌عنوان وابستگی پروژه Lazarus اضافه کنید

Interfaces را در فهرست uses برنامه، از جمله برنامه‌های کنسولی، پیش از واحدهای HotXLS قرار دهید؛ این کار widgetset LCL و تبدیل UTF-8 را در مرزهای RTL/LCL مقداردهی اولیه می‌کند

program WorkbookExample;
{$mode delphiunicode}
uses
  Interfaces, SysUtils, lxHandleX;
var
  Workbook: TXLSXWorkbook;
begin
  Workbook:= TXLSXWorkbook.Create;
  try
    Workbook.AddSheet('Data');
    Workbook.Sheets[1].Cells[1, 1].Value:= 'Hello';
    if Workbook.SaveAs('example.xlsx')<> 1 then
      raise Exception.Create('Workbook save failed');
  finally
    Workbook.Free;
  end;
end.

واحدهای منبع HotXLS به‌صورت داخلی معناشناسی یونیکد Delphi را برمی‌گزینند تا رشته‌ها، نویسه‌ها و متن فرمول‌ها رفتار UTF-16 خود را حفظ کنند؛ کد برنامه می‌تواند از مود پاسکال مورد علاقه خود استفاده کند

جزئیات سازگاری