مرور کلی

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;

ورودی/خروجی فایل و پشتیبانی از جریان

مقادیر سلول و فرمول‌ها

• توابع متنی (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)
• callback تکرار ForEachCell برای پردازش دسته‌ای سلول

ویژگی‌های برگه کار

• نام برگه، رنگ زبانه، دید (پنهان / بسیار پنهان)، و ناوبری بر اساس فهرست
• حفاظت از برگه با دقت مجوز به ازای هر مجوز؛ حفاظت در سطح کتاب کار
• قفل کردن صفحه، تقسیم صفحه، و موقعیت اسکرول
• محدوده‌های فیلتر خودکار با معیارها؛ قوانین اعتبارسنجی داده‌های فهرستی
• قالب‌بندی شرطی: مقیاس‌های رنگی (۲ و ۳ رنگ)، نوارهای داده، و مجموعه‌های آیکون
• جستجو و جایگزینی متن در سراسر برگه کار
• گزینه‌های نما: رنگ خطوط شبکه، حالت نمایش فرمول، نمایش صفرها، نمایش عناوین، نمایش راست به چپ، نمایش نمادهای طرح کلی، و سطح بزرگ‌نمایی
• جداول ساختاریافته (TXLSTable / TXLSXTable): افزودن، دسترسی، و قالب‌بندی جداول Excel با ردیف‌های سرستون و ردیف‌های نواری
• نمودارها: افزودن برگه‌های نمودار و نمودارهای تعبیه‌شده از طریق TXLSWorksheetsAddChartSheet و TXLSXChart

لینک‌های فراپیوند و محدوده‌های نام‌دار

تصاویر و اشکال

تنظیم صفحه و چاپ

• اندازه کاغذ (A4، Letter، Legal، و بسیاری دیگر؛ به PaperSize مراجعه کنید)
• جهت‌گیری (عمودی / افقی)، حاشیه‌ها، توسط افقی / عمودی
• رشته‌های سرصفحه و پاصفحه با کدهای قالب‌بندی Excel (ضخیم، مورب، شماره صفحه، تاریخ، و غیره؛ به کدهای قالب‌بندی سرصفحه/پاصفحه مراجعه کنید)
• شکست‌های صفحه افقی و عمودی دستی
• مقیاس‌بندی جا شدن در صفحات؛ درصد بزرگ‌نمایی؛ ناحیه چاپ؛ عناوین چاپ (تکرار ردیف‌ها / ستون‌ها)
• کیفیت پیش‌نویس؛ سیاه و سفید؛ چاپ خطوط شبکه؛ چاپ عناوین؛ چاپ یادداشت‌ها

فرمت‌های صادرات

• HTML — سند کامل یا یک جزء جدول درون‌خطی برای پیش‌نمایش یا جریان‌های کاری ایمیل؛ قابل کنترل از طریق TXLSHTMLExport و TXLSXHtmlExportOptions
• RTF — متن غنی برای وارد کردن در پردازنده‌های متنی
• CSV — مقادیر جداشده با کاما با جداکننده و رمزگذاری قابل تنظیم
• TSV — مقادیر جداشده با تب
• ODS — صفحه گسترده OpenDocument از طریق رابط lxHandleX

صادرات پایگاه داده و شبکه

حفظ پروژه VBA

Unicode و متن بین‌المللی

جداول محوری (XLS کلاسیک)

• مرور کلی رابط XLSX (lxHandleX) — سلسله مراتب کامل کلاس و اعضای API مختص XLSX/ODS
• نمونه تور API — اولین نمایشی که هنگام یادگیری HotXLS از صفر اجرا می‌شود
• IXLSWorkbook — مرجع رابط کتاب کار XLS کلاسیک
• TXLSWorksheet — مرجع کلاس برگه کار XLS کلاسیک
• IXLSRange — رابط محدوده: دسترسی به سلول، قالب‌بندی، و عملیات
• TXLSXWorkbook — مرجع کلاس کتاب کار XLSX
• TXLSXWorksheet — مرجع کلاس برگه کار XLSX
• TGridToXLS — کامپوننت آماده صادرات DBGrid به Excel
• TDataToXLS — کامپوننت آماده صادرات مجموعه داده به Excel
• callback OnUserFunction — نقطه گسترش تابع برگه کار سفارشی
• مدل رنگ کلاسیک XLS — منطق طراحی رنگ مبتنی بر پالت و رنگ تم
• اعضای API اضافی XLS کلاسیک — خصوصیات محاسبه، خصوصیات سند، جداول محوری، و موارد بیشتر
• مثال‌ها — مرور کلی پروژه‌های نمونه
• نمونه سفارش خرید — مثال کامل ایجاد XLS با کد منبع