เอกสาร HotXLS

ภาพรวม XLSX Facade (lxHandleX)

lxHandleX เป็นยูนิต facade เฉพาะสำหรับเวิร์กโฟลว์สมุดงาน Excel 2007+ (.xlsx) และ OpenDocument Spreadsheet (.ods) โดยทำงานร่วมกับ facade lxHandle เดิมเพื่อให้โค้ดดั้งเดิมทำงานต่อไปได้โดยไม่ต้องมีการเปลี่ยนแปลงใดๆ

ลำดับชั้นของคลาส

XLSX facade จะเปิดเผยคลาสต่อไปนี้

type
  TXLSXWorkbook           = class  // top-level workbook with SaveAs / Open
  TXLSXHtmlExportOptions  = class  // HTML document, style, BOM, and table class options
  TODSExportOptions        = class  // ODS export options for generator, chart, and image output
  TXLSXSheets             = class  // worksheet collection on the workbook
  TXLSXFonts              = class  // workbook-level font palette
  TXLSXFont               = class  // single font descriptor
  TXLSXFills              = class  // workbook-level fill palette
  TXLSXFill               = class  // single fill (pattern + fg/bg color)
  TXLSXBorders            = class  // workbook-level border palette
  TXLSXBorder             = class  // four edges + diagonal border
  TXLSXNumberFormats      = class  // workbook-level custom format codes
  TXLSXDefinedNames       = class  // workbook-level named ranges
  TXLSXWorksheet          = class  // single worksheet with cells and decorations
  TXLSXCells              = class  // cell collection on the worksheet
  TXLSXCell               = class  // single cell (value, formula, *Index style refs)
  TXLSXRange              = class  // rectangular worksheet range wrapper
  TXLSXMergedCells        = class  // merged-range collection
  TXLSXHyperlinks         = class  // hyperlink collection
  TXLSXComments           = class  // cell-comment collection
  TXLSXImages             = class  // image collection (drawings + media)
  TXLSXConditionalFormats = class  // conditional formatting rules
  TXLSXDataValidations    = class  // data-validation rules
  TXLSXTables             = class  // Excel-style table collection
  TXLSXCharts             = class  // chart collection (anchored or full-page)
  TXLSXChart              = class  // single chart (column / bar / line / pie / scatter / bubble / radar)
  TXLSXChartSeries        = class  // chart series with category, value, and bubble-size ranges
  TXLSXTextBox            = class  // standalone worksheet drawing text box
  TXLSXRichText           = class  // per-run rich-text payload for cells
  TXLSXAlignment          = class  // cell alignment / wrap / indent / rotation
  TXLSXExternalLinks      = class  // external workbook link collection
  TXLSXExternalLink       = class  // single external workbook reference (Target URL + SheetNames)

คลาสเหล่านี้เป็นอิสระจาก lxHandle.TXLSWorkBook และ lxHandle.TXLSWorksheet แอปพลิเคชันที่ต้องการทั้งสองรูปแบบสามารถใช้ทั้งสอง facade ควบคู่กันได้

uses
  lxHandle,   // XLS / HTML / RTF / CSV workbook (TXLSWorkBook)
  lxHandleX;  // XLSX workbook (TXLSXWorkbook)

เริ่มต้นใช้งานอย่างรวดเร็ว

XLSX facade เป็นไปตามแบบแผนโครงสร้างการเรียกแบบเดียวกับ BIFF facade — SaveAs / Open บนสมุดงาน, Sheets.Add / Sheets[i] บนคอลเลกชันเวิร์กชีต และ Cells.Item[Row, Col].Value บนคอลเลกชันเซลล์ ตัวอย่างด้านล่างนี้จะเขียนสมุดงานขนาดเล็กที่สาธิตทุกคุณสมบัติที่รองรับในปัจจุบัน

uses lxHandleX;

var
  wb: TXLSXWorkbook;
  ws: TXLSXWorksheet;
  bold, yellow, box, currency: Integer;
begin
  wb := TXLSXWorkbook.Create;
  try
    bold     := wb.Fonts.Add('Calibri', 12, True, False);
    yellow   := wb.Fills.AddSolid($FFFFFF00);
    box      := wb.Borders.AddBox(xlsxBorderThin);
    currency := wb.NumberFormats.Add('"$"#,##0.00');

    ws := wb.Sheets.Add('Demo');
    ws.Cells.Item[1, 1].Value := 'Hello';
    ws.Cells.Item[1, 1].FontIndex := bold + 1;
    ws.Cells.Item[1, 2].Value := 123.45;
    ws.Cells.Item[1, 2].NumberFormatIndex := currency + 1;
    ws.Cells.Item[2, 1].Value := Now;                 // tagged as date
    ws.Cells.Item[2, 2].Formula := 'SUM(B1:B1)';
    ws.Cells.Item[3, 1].FillIndex := yellow + 1;      // highlight cell
    ws.Cells.Item[3, 2].BorderIndex := box + 1;       // boxed cell
    ws.ColWidth[1] := 24;
    ws.RowHeight[1] := 28;
    ws.MergeCells(4, 1, 4, 3);
    ws.Range['A8:C10'].Merge(True);                  // merge across rows
    ws.AddHyperlink(5, 1, 'https://www.loslab.com', 'Visit losLab');
    ws.AddComment(5, 2, 'Important note', 'Kevin');
    ws.AddImageFromFile(6, 1, 'logo.png');
    ws.AddConditionalFormat('B1:B10', xlsxCfOpGreaterThan, '100');
    ws.AddListValidation('C1:C5', 'Yes,No,Maybe');
    wb.DefinedNames.Add('SalesData', 'Demo!$A$1:$B$10');
    wb.SaveAs('demo.xlsx');
  finally
    wb.Free;
  end;
end;

คุณสมบัติที่รองรับ

API ย่อยสำหรับคอลเลกชัน Facade

คลาสคอลเลกชัน Facade ใช้จัดการรูปแบบตามเงื่อนไข, การตรวจสอบความถูกต้องของข้อมูล, ช่วงที่ตั้งชื่อ, รูปภาพ และตาราง สมาชิกหลักของแต่ละคอลเลกชันมีดังนี้

คุณสมบัติที่รองรับ

โครงสร้างพื้นฐานร่วมกัน

facade ทั้งสองแชร์ชุดยูนิตตัวช่วยระดับล่างร่วมกัน ซึ่งหมายความว่าตัวอธิบายสไตล์, ตารางแฮช, ต้นไม้ AVL, ZIP และ XML I/O, การแปลง RGB เป็น HLS และตัวสร้างสตริง ถูกเขียนขึ้นเพียงครั้งเดียวและถูกนำไปใช้ในเส้นทางใดเส้นทางหนึ่ง ตัวช่วยร่วมกัน ได้แก่

ดูเพิ่มเติม

Copyright © 2010-2026 losLab Software