وثائق HotXLS

نظرة عامة على XLSX Facade (lxHandleX)

تعتبر lxHandleX وحدة الواجهة المخصصة لسير عمل مصنفات Excel 2007+ (.xlsx) و OpenDocument Spreadsheet (.ods). وهي تتعايش مع واجهة lxHandle الأصلية بحيث يستمر الكود القديم في العمل دون أي تغييرات

التسلسل الهرمي للفئات

تكشف واجهة XLSX عن الفئات التالية

type
  TXLSXWorkbook           = class  // مصنف ذو مستوى أعلى مع SaveAs / Open
  TXLSXHtmlExportOptions  = class  // خيارات مستند HTML، والنمط، و BOM، وفئة الجدول
  TODSExportOptions        = class  // خيارات تصدير ODS للمولد والمخطط ومخرجات الصور
  TXLSXSheets             = class  // مجموعة أوراق العمل في المصنف
  TXLSXFonts              = class  // لوحة الخطوط على مستوى المصنف
  TXLSXFont               = class  // واصف خط فردي
  TXLSXFills              = class  // لوحة التعبئة على مستوى المصنف
  TXLSXFill               = class  // تعبئة فردية (نمط + لون أمامي/خلفي)
  TXLSXBorders            = class  // لوحة الحدود على مستوى المصنف
  TXLSXBorder             = class  // أربعة حواف + حد قطري
  TXLSXNumberFormats      = class  // رموز التنسيق المخصصة على مستوى المصنف
  TXLSXDefinedNames       = class  // النطاقات المسماة على مستوى المصنف
  TXLSXWorksheet          = class  // ورقة عمل فردية تحتوي على خلايا وزخارف
  TXLSXCells              = class  // مجموعة الخلايا في ورقة العمل
  TXLSXCell               = class  // خلية فردية (قيمة، صيغة، مراجع نمط *Index)
  TXLSXRange              = class  // غلاف نطاق ورقة عمل مستطيل
  TXLSXMergedCells        = class  // مجموعة النطاقات المدمجة
  TXLSXHyperlinks         = class  // مجموعة الارتباطات التشعبية
  TXLSXComments           = class  // مجموعة تعليقات الخلايا
  TXLSXImages             = class  // مجموعة الصور (رسومات + وسائط)
  TXLSXConditionalFormats = class  // قواعد التنسيق الشرطي
  TXLSXDataValidations    = class  // قواعد التحقق من صحة البيانات
  TXLSXTables             = class  // مجموعة جداول بنمط Excel
  TXLSXCharts             = class  // مجموعة المخططات (مراسية أو صفحة كاملة)
  TXLSXChart              = class  // مخطط فردي (عمودي / شريطي / خطي / دائري / مبعثر / فقاعي / راداري)
  TXLSXChartSeries        = class  // سلسلة مخططات مع نطاقات الفئات والقيم وحجم الفقاعة
  TXLSXTextBox            = class  // مربع نص مستقل للرسم في ورقة العمل
  TXLSXRichText           = class  // حمولة نص منسق لكل تشغيل للخلايا
  TXLSXAlignment          = class  // محاذاة الخلايا / التفاف / بادئة / تدوير
  TXLSXExternalLinks      = class  // مجموعة ارتباطات المصنفات الخارجية
  TXLSXExternalLink       = class  // مرجع مصنف خارجي فردي (رابط الهدف + أسماء الأوراق)

هذه الفئات مستقلة عن lxHandle.TXLSWorkBook و lxHandle.TXLSWorksheet. التطبيقات التي تحتاج إلى كلا التنسيقين يمكنها استخدام كلتا الواجهتين جنباً إلى جنب

uses
  lxHandle,   // مصنف XLS / HTML / RTF / CSV (TXLSWorkBook)
  lxHandleX;  // مصنف XLSX (TXLSXWorkbook)

البدء السريع

تتبع واجهة XLSX نفس اتفاقيات شكل الاستدعاء مثل واجهة BIFF — 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;                 // مميز كتاريخ
    ws.Cells.Item[2, 2].Formula := 'SUM(B1:B1)';
    ws.Cells.Item[3, 1].FillIndex := yellow + 1;      // تمييز الخلية
    ws.Cells.Item[3, 2].BorderIndex := box + 1;       // خلية مؤطرة
    ws.ColWidth[1] := 24;
    ws.RowHeight[1] := 28;
    ws.MergeCells(4, 1, 4, 3);
    ws.Range['A8:C10'].Merge(True);                  // دمج عبر الصفوف
    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;

الميزات المدعومة

واجهات برمجة تطبيقات المجموعات الفرعية للواجهة

تدير فئات مجموعات الواجهة التنسيقات الشرطية، والتحقق من صحة البيانات، والنطاقات المسماة، والصور، والجداول. فيما يلي الأعضاء الأساسيون لكل مجموعة

ميزات مدعومة إضافية

البنية التحتية المشتركة

تتشارك كلتا الواجهتين مجموعة مشتركة من الوحدات المساعدة ذات المستوى الأدنى، مما يعني أن واصفات الأنماط وجداول التجزئة وأشجار AVL وإدخال/إخراج ZIP و XML وتحويلات RGB إلى HLS ومنشئات النصوص مكتوبة مرة واحدة وتستخدم من قبل أي من المسارين. تشمل المساعدات المشتركة

انظر أيضاً

حقوق الطبع والنشر © 2010-2026 losLab Software