أعضاء إضافية لواجهات برمجة المكتبة

تستكمل هذه الصفحة مرجع الأنواع العامة التي تدعم واجهات برمجة المصنفات وأوراق العمل والعرض والاستيراد والتشخيص والعارض الرئيسية دون أن تتطلب دليلًا مستقلًا موجّهًا لمهمة بعينها

التصفية والتنسيق الشرطي

TXLSCfValueتقبل TXLSDataBarSpecو TXLSColorScaleSpecو TXLSIconSetSpecو TXLSDxfStyle و AttachWriteGuardOwnerالخاصية TXLSCondFormatWriteGuardOwner، فتربط كائن القاعدة بمصنفه المالك لتكتسب التعديلات حارس كتابة تلقائيًا؛ وينفذ المالك AcquireWriteGuard ، التي تسلّم طريقتها الوحيدة TXLSDxfStyle القاعدة حارس كتابة المصنف. ويضيف FontColorIndex مع FontColorIsIndexed وزوجي FillFgColorIndex / FillFgColorIsIndexed و FillBgColorIndex / FillBgColorIsIndexed لألوان قواعد مفهرسة حسب اللوحة، إضافة إلى تجاوزات الـ differential-font المسماة FontNameو FontSizeو FontScheme (سلسلة فارغة، أو حجم بالنقاط، أو خانة خط سمة مثل major / minor) إلى جوار أعضاء العريض والمائل والتسطير واللون الموجودة؛ ويكتسب كل إسناد حارس الكتابة ويعلّم القاعدة متسخة لإعادة الإصدار

TXLSConnections, TXLSDataTables, and TXLSQueryTables تكشف OnAcquireWriteGuard و TXLSConnectionAcquireWriteGuardو TXLSDataTableAcquireWriteGuardعن TXLSQueryTableAcquireWriteGuard، الخطاف الذي تستخدمه مسارات التعديل لديها للحصول على IXLSWorkbookWriteGuard الخاص بالمصنف المالك قبل التعديل ولرفع توليد المصنف بعد ذلك؛ ويسجل الحارس StartGeneration، ويشير Complete إلى انتهاء الكتابة بحيث يمكن إعادة بناء الذاكرات المؤقتة التابعة

تحمل اتصالات البيانات المحفوظة وصفًا منمَّطًا: يصنف TXLSConnectionKind (xlckUnknownو xlckOdbcو xlckDaoو xlckFileو xlckWebو xlckOleDbو xlckTextو xlckAdo) الاتصال، ويسجل TXLSConnectionCredentials (xlccIntegratedو xlccNoneو xlccStoredو xlccPrompt) وضع مصادقته، وتوسم كل قيمة معامل اتصال بـ TXLSConnectionParameterValueKind (xlcpvNoneو xlcpvBooleanو xlcpvDoubleو xlcpvIntegerو xlcpvStringو xlcpvCell). ويبلّغ جداول بيانات What-if عن نوع تعريفها المخزن عبر TXLSDataTableKind

جداول بيانات What-if والتجميع المحوري

يمكن عرض حدود مجموعات الأيقونات أو التحقق منها برمجيًا: يبلّغ XLSCfIconSetCount عن عدد الأيقونات التي يعرّفها TXLSIconSetType ، ويملأ XLSBuildCfIconGeometry بنية TXLSCfIconGeometry بالعناصر الأولية (TXLSCfIconPrimitive، من نوع TXLSCfIconPrimitiveKind: cfipPolygonو cfipEllipseو cfipRectو cfipLine) والنقاط (TXLSCfIconPoint) التي ترسم أيقونة واحدة، لتطابق المصدرات المخصصة أشكال أيقونات Excel المدمجة

التشخيص وتتبع الصيغ والتحقق

مخططات التحقق من الاستيراد

يتحقق TXLSImportCheck من lxImportCheck من TXLSXWorksheet مقابل قواعد يملكها التطبيق؛ ويفحص القيم القياسية المخزنة ونتائج الصيغ المخزنة، بإحداثيات ورقة العمل ذات الأساس 1 ودون أي تحويل ضمني من نص إلى رقم أو من نص إلى تاريخ أو من نص إلى Boolean

Validator := TXLSImportCheck.Create;
try
  Validator.HeaderRow := 1;
  Rule := Validator.AddRule(2);
  Rule.Name := 'quantity';
  Rule.Flags := [irRequired, irValueType, irValueRange];
  Rule.ValueKind := ivkInteger;
  Rule.MinimumValue := 1;
  Rule.MaximumValue := 1000;

  Validator.AddUniqueRule([1, 3]).Name := 'account-and-region';
  Validator.AddCrossColumnRule(4, 5, icLessOrEqual).Name := 'start-before-end';
  FailureCount := Validator.Check(Sheet);
  if FailureCount > 0 then
    Validator.Annotate(Sheet, 'Import validator');
finally
  Validator.Free;
end;

يبدأ HeaderRow > 0 الفحص من الصف التالي ويتقدم على FirstRow؛ وإلا فقيمة FirstRow الافتراضية 1؛ وتستخدم LastRow = 0 آخر صف مستخدم في ورقة العمل، بينما يمكن لـ LastRow الموجب تضمين خلايا غائبة دون إنشائها؛ ويجب أن تبقى الأعمدة ضمن 1 إلى 16,384 وحدود صفوف البيانات النشطة ضمن 1 إلى 1,048,576

قواعد الأعمدة والأنواع الصريحة

يستبدل AddRule(Column) أي قاعدة سابقة لذلك العمود ويحررها؛ وتتخطى مسندات نوع القيمة والنطاق والطول والنمط لكل قيمة القيمَ المفقودة وقيم null والسلاسل الفارغة، بينما يبلّغ عنها irRequired؛ وتحتفظ الفرادة بالسياسات المميزة الموصوفة أدناه؛ ويبقى الفراغ غير الفارغ قيمة؛ والرقم لا يصلح Boolean، والتاريخ لا يصلح رقمًا عاديًا، والسلسلة الشبيهة بالأرقام تبقى نصًا

يُمكّن إسناد MinimumValue أو MaximumValue ذلك الحد؛ ويمكن لـ HasMinimum أو HasMaximum تعطيله مجددًا؛ وافتراض مفتاحي الشمول كليهما True؛ ويجب أن تكون الحدود أرقامًا أو تواريخ مُنمَّطة منتهية، ويجب أن يكون الحدان قابلين للمقارنة ويصفان مجالًا غير فارغ؛ وترفع الحدود المعكوسة أو المفقودة أو غير المتوافقة أو الفارغة استثناءً قبل بدء التحقق من ورقة العمل

تقارن حدود الأرقام القيم العددية وتقارن حدود التواريخ التواريخ؛ وتحفظ المقارنات بين صحيحين كل بتات Int64 و UInt64؛ وتفشل قيم الفئة غير المتوافقة في فحص النطاق؛ ويستمر مسندا طول النص و regex في فحص التمثيل النصي للقيمة القياسية، ويحتفظ فحص regex بسلوك IsMatch القائم، فاستخدم مراسي مثل ^...$ عندما يجب أن يطابق النصَ كاملًا؛ ويعطّل regex غير الصالح فحص النمط الخاص به توافقيًا

قيم Excel منسقة التاريخ

يمكن لخلية مستوردة من Excel أن تحمل رقمًا تسلسليًا حتى عندما يعرض تنسيق رقمها تاريخًا؛ فاختر وضعًا تسلسليًا صراحة عندما يكون ذلك هو مخطط الاستيراد المقبول؛ ولا يؤثر الوضع في التحقق فحسب ولا يغيّر قيمة الخلية المخزنة أبدًا

Rule := Validator.AddRule(4);
Rule.Flags := [irRequired, irValueType, irValueRange];
Rule.ValueKind := ivkDate;
if Sheet.Workbook.Date1904 then
  Rule.DateSerialMode := idsExcel1904
else
  Rule.DateSerialMode := idsExcel1900;
Rule.MinimumValue := VarFromDateTime(EncodeDate(2026, 1, 1));
Rule.MaximumValue := VarFromDateTime(EncodeDate(2026, 12, 31));

تُعلن VarFromDateTime في Variants و EncodeDate في SysUtils؛ ويجب أن تكون الأرقام التسلسلية العددية غير سالبة وأن تقع قبل 1 يناير 10000؛ وتحتفظ الأرقام الكسرية بوقتها من اليوم؛ ويرفض نظام 1900 كل رقم تسلسلي من 60 شاملًا إلى 61 حصريًا لأن ذلك المجال يرمز إلى اليوم الكبيسي الوهمي؛ ويعيّن نظام 1904 الرقم صفر إلى 1 يناير 1904

تتضمن حدود التواريخ وقت اليوم، فالحد الأقصى المضبوط على منتصف ليل 31 ديسمبر يستبعد الأوقات اللاحقة في ذلك اليوم؛ واستخدم حدًا علويًا حصريًا عند 1 يناير من السنة التالية عندما يجب قبول اليوم الأخير كاملًا؛ وتبقى التواريخ النصية مثل 10/08/2026 نصًا بصرف النظر عن الوضع التسلسلي المهيأ

الفرادة المركبة والمقارنات عبر الأعمدة

تحتفظ المفاتيح المركبة بنوع Variant الدقيق لهوية كل عضو ونصه؛ فـ Integer(1) و Double(1) والسلسلة '1' وقيمة Boolean والتاريخ أعضاء مميزة؛ ولا يوجد طي حالة ولا تطبيع Unicode ولا تحليل حسب الـ locale ولا التباس فواصل؛ وتبقى التوليفات مثل ('ab', 'c') و ('a', 'bc') مختلفة؛ وتبدأ كل تمريرة تحقق فهرس صفوف جديدًا

عندما تكون SkipIncompleteRows = True، يستبعد العضو المفقود أو null أو السلسلة الفارغة ذلك الصف من فرادة الصفوف؛ وإسناد False يضمّن تلك الأعضاء بهويات Variant الأصلية؛ ويبلّغ التكرار عن عمود الصف الأول بوصفه عنوان الخلية وأول صف متطابق عبر FirstDuplicateRow

يحتفظ irUnique أحادي العمود القائم بسلوك المطابقة النصي غير الحساس لحالة الأحرف ويتخطى القيم المفقودة أو null؛ واستخدم AddUniqueRule([Column]) عندما تُطلب هوية مُنمَّطة صارمة لعمود واحد

لا تحوّل المقارنات عبر الأعمدة السلاسل إلى أرقام ولا الأرقام إلى Boolean ولا الأرقام العادية إلى تواريخ أبدًا؛ وتفشل الفئات المختلطة غير المتوافقة حتى مع icNotEqual؛ وتميز مقارنات السلاسل Unicode المركّب من المفكك، وتحفظ محارف null المضمنة، وتستخدم ترتيب البادئة الأقصر أولًا؛ وعندما تكون SkipBlankValues = False، ينتج أي معامل فارغ مخالفة عبر الأعمدة

النتائج المهيكلة ومصنفات التصحيح

يعيد Check(Sheet) عدد المخالفات، ويسرد ViolationCount مع Violation(Index) ذي الأساس الصفري التقرير؛ وتبلّغ قاعدة العمود الواحد عن أول مسند فاشل لديها، بينما يمكن لقواعد الصفوف والمقارنات المهيأة باستقلال إضافة مخالفات أخرى للخلية نفسها؛ وأسند قيم Name ذات معنى عندما يحتاج المستدعون معرفات قواعد تطبيق مستقرة

تتحقق خلايا الصيغ باستخدام قيمها المخزنة مؤقتًا؛ ويبلّغ الصيغة بلا نتيجة مخزنة مؤقتًا عن ivFormulaCacheMissing، وتبلّغ النتيجة الخطأ عن ivCellError؛ وأعد الحساب صراحة قبل الفحص عندما تُطلب نتائج صيغ طازجة؛ ولا يصل التحقق إلى مصادر خارجية ولا يغيّر تعريفات الصيغ ولا يقيّم صيغًا غير مخزنة مؤقتًا

يحتفظ OnVerifyCell بتوقيع الـ callback‏ TlxImportVerifyCell ويُشغَّل بعد نجاح مسندات الأعمدة المنطبقة وفحوصات الفرادة؛ ويعيد Boolean ويمكنه ضبط رسالة خطأ تطبيقية؛ ويجب أن تبقي الـ callbacks المصنفَ ومخطط التحقق دون تغيير، وتُرفض كتابات المصنف بعقد القراءة؛ وتنتشر استثناءات الـ callbacks ويُحرَّر العقد للعمليات اللاحقة

لا يعلّق Check أبدًا ولا يحذف صفوفًا ولا يجسد قيمًا مضغوطة؛ واستخدم Annotate بعد الفحص لتطبيق خطوط حمراء وإلحاق نص الخطأ بالتعليقات القائمة، أو استدعِ KeepOnlyViolations صراحة لإزالة الصفوف غير المخالفة وإنشاء مصنف تصحيح؛ وتعدّل هاتان الطريقتان ورقة العمل المزوَّدة، فاستدعِيهما على المصنف المقصود بعد مراجعة التقرير

يستعير التحقق ورقة العمل والمصنف للاستدعاء المتزامن؛ ولا يتبنى ملكية كائنات المستدعي ولا يشترط مصنفًا مملوكًا لواجهة؛ ويحمي عقد قراءة لقطات الخلايا المخزنة ذات الصلة والوصول إلى caches الصيغ المخزنة طوال الفحص

سياسات حفظ الارتباطات الخارجية

TXLSExternalLinkUpdateMode = (xluPromptUser, xluNever, xluAlways);

property IXLSWorkbook.SaveExternalLinkValues: Boolean;
property IXLSWorkbook.UpdateLinks: TXLSExternalLinkUpdateMode;
property TXLSXWorkbook.SaveExternalLinkValues: Boolean;
property TXLSXWorkbook.UpdateLinks: TXLSExternalLinkUpdateMode;
      

تدقيق الحساب وتلميحات المصنف

function TXLSWorkbook.RecalcAndVerify(MaxIssues: Integer = 10000): TXLSCalculationAuditReport;
function TXLSXWorkbook.RecalcAndVerify(MaxIssues: Integer = 10000): TXLSCalculationAuditReport;
function TXLSWorkbook.RecalcAndVerifyEx(const Options: TXLSRecalcAuditOptions): TXLSCalculationAuditReport;
function TXLSXWorkbook.RecalcAndVerifyEx(const Options: TXLSRecalcAuditOptions): TXLSCalculationAuditReport;
function TXLSWorkbook.RunCalculationAudit(const Options: TXLSRecalcAuditOptions): TXLSCalculationAuditReport;
function TXLSWorkbook.FormulaIsVolatile(Formula: WideString): Boolean;

function TXLSWorkbook.AuditOverlayHash(SheetIndex, Row, Col: Integer): Integer;
function TXLSWorkbook.AuditOverlayRead(SheetIndex, Row, Col: Integer; var Value: Variant): Boolean;
procedure TXLSWorkbook.AuditOverlayWrite(SheetIndex, Row, Col: Integer; const Value: Variant);
procedure TXLSWorkbook.AuditOverlayClear;

TXLSCalculationAuditIssueKind = (xlcaiCacheMismatch, xlcaiParseFailure,
  xlcaiMissingFunction, xlcaiMissingName, xlcaiUnsupportedArguments,
  xlcaiCircularReference, xlcaiExternalReferenceDenied,
  xlcaiExternalReferenceMissing, xlcaiDataTableSkipped, xlcaiCancelled,
  xlcaiInternalFailure);

TXLSCalculationAuditIssue = record
  Kind: TXLSCalculationAuditIssueKind;
  SheetIndex: Integer;
  SheetName: WideString;
  Row: Integer;
  Col: Integer;
  Formula: WideString;
  Symbol: WideString;
  Expected: Variant;
  Actual: Variant;
  ResultCode: Integer;
  Stack: WideString;
  ExternalTarget: WideString;
end;
TXLSCalculationAuditIssues = array of TXLSCalculationAuditIssue;

TXLSRecalcAuditProgress = procedure(ASender: TObject;
  ACurrent, ATotal: Integer; var ACancel: Boolean) of object;

property WorkbookCodeName: WideString;
property CalculationThreadMode: TXLSCalculationThreadMode;
property ForceFullCalculationState: TXLSOptionalBooleanState;
property RefreshAllOnLoadState: TXLSOptionalBooleanState;
      

حالة صيغ الجداول وIME

property TXLSXTable.ColumnCalculatedFormulaArrayStates[Index: Integer]: TXLSTableFormulaArrayState;
property TXLSXTable.ColumnTotalsFormulaArrayStates[Index: Integer]: TXLSTableFormulaArrayState;
property TDataValidation.ImeMode: TXLSDataValidationImeMode;
property TXLSXDataValidation.ImeModeKind: TXLSDataValidationImeMode;
      

فحص لوحات مهام الوظائف الإضافية للويب وإزالتها

function IXLSWorkbook.HasWebAddinTaskPanes: Boolean;
function IXLSWorkbook.WebAddinTaskPaneCount: Integer;
function IXLSWorkbook.RemoveWebAddinTaskPanes: Integer;
function TXLSXWorkbook.HasWebAddinTaskPanes: Boolean;
function TXLSXWorkbook.WebAddinTaskPaneCount: Integer;
function TXLSXWorkbook.RemoveWebAddinTaskPanes: Integer;
      

سياسة عرض كائنات المصنف

TXLSObjectDisplayMode = (xlsodmShowAll, xlsodmShowPlaceholders,
  xlsodmHideAll);

property IXLSWorkbook.ObjectDisplayMode: TXLSObjectDisplayMode;
property TXLSWorkbook.ObjectDisplayMode: TXLSObjectDisplayMode;
property TXLSXWorkbook.ObjectDisplayMode: TXLSObjectDisplayMode;
property TXLSPaginationModel.ExportObjectPlaceholders: Boolean;
property TXLSPDFExport.ExportObjectPlaceholders: Boolean;
property TXLSSvgExport.ExportObjectPlaceholders: Boolean;
property TXLSPageImageExporter.ExportObjectPlaceholders: Boolean;
property TXLSPrintDocument.ExportObjectPlaceholders: Boolean;
property TXLSXHtmlExportOptions.ExportObjectPlaceholders: Boolean;
      

قيم معايرة العرض واللقطات

TXLSRenderCalibration = record
  WidthCorrection: Double;
  HeightCorrection: Double;
  LineSpacing: Double;
  CellMarginFactor: Double;
  ScreenScaling: Integer;
  MeasurementDpi: Integer;
end;

function XLSDefaultRenderCalibration: TXLSRenderCalibration;
function XLSValidateRenderCalibration(const AValue: TXLSRenderCalibration;
  out AInvalidField: TXLSRenderCalibrationField): Boolean;
      

هندسة العرض وقياس الخطوط

TXLSRenderGeometryBackend = (xlsrgbAutoFit, xlsrgbPagination, xlsrgbPdf,
  xlsrgbSvg, xlsrgbBitmap, xlsrgbPrintPreview, xlsrgbViewer, xlsrgbHtml);

TXLSRenderFont = record
  Name: WideString;
  Size: Double;
  Styles: TXLSRenderFontStyles;
  Charset: Byte;
end;

function CreateXLSRenderGeometry(
  const ACalibration: TXLSRenderCalibration;
  AWorkbookGeneration: UInt64;
  ABackend: TXLSRenderGeometryBackend;
  ACacheCapacity: Integer = 4096): IXLSRenderGeometry;

property TXLSHTMLExport.RenderGeometry: IXLSRenderGeometry;
property TXLSXHtmlExportSession.RenderGeometry: IXLSRenderGeometry;
      

الاستيراد وتوليد الشيفرة والمقارنة والمراقبة

مقارنة المصنفات

يقارن TXLSXWorkbookCompare في lxCompare نسختين من TXLSXWorkbook دون إعادة حساب الصيغ أو تعديل أي من المصنفين؛ وتُزاوج الأوراق بالاسم غير الحساس لحالة الأحرف، ولا ينتج عن تغيير ترتيب الأوراق وحده أي اختلاف

قيمة Options الافتراضية فارغة وافتراض السماحيتين صفر؛ ويبلّغ المقارنة الافتراضية عن الأوراق المضافة أو المحذوفة، والخلايا المخزنة المضافة أو المحذوفة، والقيم الحرفية المُنمَّطة المتغيرة، ونص الصيغ المتغير، والنطاقات المدمجة المضافة أو المحذوفة

تميز مقارنة الحرفيات الأرقام والنص وقيم Boolean والتواريخ والأخطاء والفراغات: فالرقم 1 يختلف عن النص '1'، وقيمة Boolean تختلف عن تهجئتها النصية، وتحتفظ التواريخ بنوعها الخاص، وتقارن الأخطاء برمز الخطأ المخزن لديها؛ وتتساوى أنواع التخزين العددية ذات القيم المتساوية، بينما تبقى قيم Int64 المختلفة مميزة في المقارنة التامة

نوع Options هو TlxCompareOptions، مجموعة من TlxCompareOption؛ ويمكّن كل خيار اختلافاته في المقارنة الافتراضية

يتحقق SetFeatureLimits(MaxBytes, MaxItems) من كلا الحدين الموجبين قبل تغيير أي من الإعدادين؛ وافتراض MaxFeatureBytes هو 64 MiB وافتراض MaxFeatureItems هو 1,000,000، وتحفظ أدوات الضبط الفردية التحقق الذري نفسه

تغطي ميزانيات الميزات البايتات القياسية المنفصلة المجمعة والمدخلات المعدودة من كلا المصنفين، بما يشمل runs النص الغني وعقد XML للمرشحات وحقول Pivot وأعضاء المجالات وقيم السجلات واتصالات Slicer أو Timeline؛ ويفحص القرّاء العدّادات ومدخلات النص الكبيرة قبل بناء XML الأصلي، ويفرضون تدفقات إخراج محودة، ويرفعون EXLSXSemanticBudget عند تجاوز حد

يتحقق SetNumericTolerance(AbsoluteTolerance, RelativeTolerance) من كلا الوسيطين قبل تغيير أي من الإعدادين؛ ويجب أن يكونا منتهيين وغير سالبين، وتستخدم أدوات ضبط AbsoluteTolerance و RelativeTolerance الفردية التحقق نفسه

تتساوى القيم الحرفية العددية وقيم الذاكرة المؤقتة العددية عندما يكون فرقهما المطلق في حدود AbsoluteTolerance أو يكون فرقهما نسبةً إلى القيمة المطلقة الأكبر في حدود RelativeTolerance؛ ويحتفظ عتبة الصفر بالتساوي التام، ويتجنب الحساب النسبي الفيض للقيم المتعاكسة المتطرفة، ولا تحوّل السماحية النص ولا تنطبق على التواريخ أو الأنماط أو الهندسة

تضبط LeftName و RightName أسماء عرض اختيارية تستخدمها أسطر Report، وافتراضهما left و right؛ وتؤثر الأسماء في التقرير فقط، لا في إزواج الأوراق أو المقارنة

Comparer := TXLSXWorkbookCompare.Create;
try
  Comparer.Options := [lcoFormulaCachedResults, lcoCellStyles,
    lcoAxisGeometry];
  Comparer.SetNumericTolerance(0.001, 0.000001);
  DifferenceCount := Comparer.Compare(LeftWorkbook, RightWorkbook);
  for I := 0 to DifferenceCount - 1 do
  begin
    Entry := Comparer.Diff(I);
    ReportLines.Add(Entry.Describe);
  end;
finally
  Comparer.Free;
end;

يعيد Compare عدد الاختلافات، ويقرأ Count ذلك العدد لاحقًا، ويستخدم Diff(Index) الفهرسة ذات الأساس الصفري لإعادة TlxCompareDiff مملوك للمقارن؛ واحتفظ بالمقارن أثناء قراءة مدخلاته، وأعد اكتساب المدخلات بعد مقارنة ناجحة أخرى

يوفر كل مدخل Kind و Sheet و Row و Col ذواتي الأساس 1 حيثما ينطبق، و Ref و LeftText و RightText وقيم LeftKind / RightKind المُنمَّطة؛ وتحتوي TlxCompareValueKind على lcvNone و lcvBlank و lcvNumber و lcvText و lcvBoolean و lcvDateTime و lcvError و lcvFormula، وتستخدم lcvNone للطرف الغائب أو لاختلاف غير قيمي

يحتفظ TlxCompareKind بـ lckSheetAdded و lckSheetRemoved و lckCellAdded و lckCellRemoved و lckValueChanged و lckFormulaChanged و lckMergeAdded و lckMergeRemoved، ويضيف lckFormulaCacheChanged و lckStyleChanged و lckRowGeometryChanged و lckColumnGeometryChanged

تحمل اختلافات الأنماط بصمات أنماط قياسية مستقرة في LeftText و RightText؛ وتحمل اختلافات الهندسة الحجم المقارن وحالة الإخفاء والمخطط التفصيلي والطي، مع Ref محددًا مجال المحور المتصل المتأثر، و Row مضبوطًا على أول صف و Col على صفر للصفوف، أو Col مضبوطًا على أول عمود و Row على صفر للأعمدة

تستخدم اختلافات الميزات lckDefinedNameChanged أو lckDataValidationChanged أو lckConditionalFormatChanged أو lckTableChanged أو lckDrawingChanged أو lckPivotTableChanged أو lckPivotCacheChanged أو lckSlicerChanged أو lckTimelineChanged؛ وتكون Change إحدى lccChanged و lccAdded و lccRemoved، ويحمل كل طرف حاضر بصمة تعريفه القياسية بينما يحمل الطرف الغائب سلسلة فارغة

يحدد lckRichTextChanged تعريف run متغيرًا عند إحداثيات خليته ويحمل بصمات runs القياسية في LeftText و RightText؛ وتنطبق السماحية العددية على الحرفيات الخلوية وcaches الصيغ، بينما تقارن تعريفات الميزات المُنمَّطة تامًا

تحدد مراجع الميزات أسماء ذات نطاق أو أسماء جداول، أو تستخدم مواضع تتابع ذات أساس 1 لتعريفات التحقق والتنسيق الشرطي والرسم؛ ويمكن لإدراج ميزة مرتبة أو نقلها تغيير عدة مواضع، بينما تحمل مدخلات الأسماء على مستوى المصنف قيمة Sheet فارغة

يحدد lckBlankStyleRegionChanged مستطيلًا فارغًا متغيرًا عبر Row و Col و LastRow و LastCol الشاملين و Ref بصيغة A1؛ وتُعالج الإحداثيات المخزنة بمقارنة الخلايا العادية و lcoCellStyles، فمكّن خياري الأنماط معًا لفحص الخلايا المخزنة والمناطق الفارغة معًا

يهيئ Describe مدخلًا واحدًا، بينما يلحق Report(List) المدخلات المهيأة بـ TStrings مملوك للمستدعي؛ ويتضمن تغيير القيمة المُنمَّطة تسميات النوع عندما تختلف الأنواع، وترتب النتائج حسب اسم الورقة والصف والعمود ونوع الاختلاف والمرجع بدل ترتيب إدراج الخلايا

تحمل المقارنة عقود قراءة وتمشي عبر الخلايا المخزنة بوصفها لقطات cursors منفصلة وتحتفظ بالتخزين المضغوط؛ وتقسم الهندسة حدود metadata المخزنة وامتدادات الصفوف المكررة المضغوطة، بينما يمسح مقارنة أنماط الفراغ حدود المستطيل النشط وحدود الخلايا المخزنة دون مسح شبكة مستطيلة بمليون صف؛ وينمو العمل مع الميزات المخزنة وتقاطعات المناطق والاختلافات المبلغة

تحفظ المقارنة الفاشلة النتيجة الناجحة السابقة؛ ويحفظ إسناد سماحية غير صالحة الإعدادات والنتيجة القائمتين أيضًا، بينما يمسح تمرير مصنف nil النتيجة ويعيد صفرًا

تغطي هذه المقارنة محتوى الخلايا المخزن لواجهة XLSX وتعريفات الميزات المُنمَّطة المختارة؛ وتُطبَّع تهجئة صيغ الأسماء والتحقق والتنسيق الشرطي والجداول والمخططات عبر محلل الصيغ الدلالي، بينما تحتفظ صيغ Pivot المحسوبة بنص تعريفها المخزن

تقبل مرشحات الجداول أشكال المرشحات المخصصة وقوائم القيم وتجميع التواريخ والألوان والأيقونات والديناميكية وأعلى-عدد المدعومة وشروط الفرز؛ وتُطبَّع ترتيب أعمدة التصفية المستقلة ومدخلات مجموعات القيم، وتُطبَّع افتراضات Boolean والتهجئات العددية، ويبقى ترتيب شروط الفرز مهمًا

يحل مقارنة Pivot و Slicer و Timeline المُنمَّط مصادر أوراق العمل المحلية المدعومة وارتباطات non-OLAP دون تحديث أو تقييم للتوفر؛ وتكون تلميحات توفر Slicer الأصلية metadata عرض مشتقة، بينما تُقارن تحديدات الأعضاء وmetadata الفرز الأصلية المعترف بها

ترفع خصائص الرسم الأصلية الـ opaque ونماذج Pivot الثنائية غير المكتملة ومصادر Pivot الخارجية أو OLAP وسجلات PivotTable التكميلية الخام وXML الامتدادات وXML المرشحات المجهولة وسمات أو أبناء امتدادات Slicer أو Timeline غير المنمذجة استثناءً EXLSSemanticSnapshot؛ ولا يعني حفظ تلك البيانات تكافؤًا دلاليًا

يتحقق أيضًا من XML الأصلي المحفوظ قبل مقارنة الإسقاط المُنمَّط مجموعة مختارة من ميزات PivotTable و PivotCache المستوردة، بما يشمل metadata الحقول المتداخلة وسجلات الذاكرة المؤقتة؛ وتفشل namespaces وسمات وأبناء وحمولات امتدادات مجهولة صراحةً ضمن حدود الميزات التعاونية نفسها، بينما تبقى ارتباطات ذاكرات Slicer المؤقتة المنمذجة مدعومة

يكشف TSimpleDomNode.RawName عن الـ QName الأصلي للعنصر بجوار Name المطبَّع من القارئ، بما يتيح فحصًا حساسًا لـ namespaces دون تغيير مطابقة أسماء المحلل القائمة

تبقى إعدادات المصنف وmetadata الحزمة الـ opaque خارج المقارنة؛ ولا تقيّم مقارنة الأنماط الأساسية مظهر التنسيق الشرطي أو نمط الجدول، وتحفظ مقارنة الرسم حدود الصور ومربعات النص والمخططات والمجموعات المرتبة المدعومة للقطةِ دلالية

خواص النص الغني الفعلية

يعيد TMsoFbtOpt.StoredPids معرفات خصائص OfficeArt المخزنة بترتيب مفروز، بينما يكشف TMsoFbtSp.PersistentFlags أعلام الشكل الأصلية دون تخصيص خصائص أو مراسي

يميز TMsoShapeContainer.HasPreservedObjectData بايتات ذيل OBJ المحتفظ بها؛ ويفحص HasOrdinaryEmbeddedPictureObjectData أن أذيول الصور لا تحوي سوى سجلات تنسيق حافظة معروفة وسجلات أعلام صور صفرية، ويرفض السجلات المرتبطة أو المجهولة دون نسخ الحمولة

يفحص TMSOShapeTextBox.HasValidTextRuns حدود runs الـ TXO المخزنة والحقول المحجوزة دون إنشاء runs؛ ويحدد TMsoDrawing.HasUnmodeledAppearance بيانات الرسم الأصلية التي تخطاها المحلل المُنمَّط، بما يتيح للالتقاط رفضَ المظهر غير المحلول صراحةً

يميز TXLSXRichTextRun.BoldSet و ItalicSet و StrikethroughSet و UnderlineSet و VertAlignSet و ColorSet خواص الخط الموروثة عن التجاوزات الصريحة، بما يشمل الأعلام الخاطئة وnone وbaseline والألوان التلقائية؛ وتعلن أدوات الضبط الخاصية صراحةً حتى عندما تساوي قيمتها الافتراض الأولي لـ run الجديد

يبلّغ TXLSXRichText.HasUnsupportedAppearance عن خواص النص الغني الأصلية التي لا يستطيع نموذج runs المُنمَّط تمثيلها؛ ويرفض الالتقاط المحمول ومقارنة النص الغني الفعلية تلك runs صراحةً، بينما تحتفظ خواص runs المشتركة/المضمنة المدعومة والفراغات بدلالاتها المستوردة

تطبق مقارنة النص الغني الفعلية التجاوزات الصريحة القيمةَ false قبل دمج runs المتجاورة المتساوية؛ وتبقى الخواص الموروثة والممسوحة صراحةً مميزة أثناء إزالة تكرار السلاسل المشتركة وفي الجولات المدعومة ذهابًا وإيابًا عبر XML

يحل TXMLReader.ResolveNamespaceUri(Prefix, Uri) ربط الـ namespace الجاري داخل النطاق دون تغيير موضع القارئ، ويعيد false عندما لا يوجد ربط؛ والبادئة الفارغة تطلب الـ namespace الافتراضي، وتبقى أسماء QName الخام متاحة للفحص الحساس لـ namespaces

سجلات النص/المشهد غير القابلة للتغيير وامتداد مصدر الالتقاط وعقد نقل HXRSNP02 مشروحة في المخرجات المحمولة الـ headless

فحص منفصل للأنماط والمحاور

يعيد TXLSXWorksheet.ReadSemanticCellStyle(Row, Col) سجلَ TXLSSemanticCellStyle منفصلًا لإحداثيات صالحة ذات أساس 1، محلوًّا من الأنماط المخزنة والمضغوطة وافتراضات ورقة العمل وتراكبات الأنماط المنطبقة وتنسيقات التواريخ الضمنية والألوان المفهرسة وألوان السمة، دون تجسيد خلايا أو تغيير مجمّعات الأنماط؛ والاستدعاء العام يكتسب عقد قراءة ويستبعد قواعد التنسيق الشرطي وأنماط الجداول

يعيد TXLSXWorksheet.GetStoredAxisSpans(IsRow) بنية TXLSXAxisSpans، مصفوفة من سجلات TXLSXAxisSpan بحدود FirstIndex و LastIndex شاملة ذات أساس 1؛ ويبلّغ عن آثار metadata الحجم والإخفاء والمخطط التفصيلي والطي، ويحفظ امتدادات ارتفاع الصفوف المكررة المضغوطة، ويبقي الافتراض الفعلي لورقة العمل متاحًا عبر خواصها العادية

تصف الامتدادات المعادة آثار metadata المخزنة لا تقسيمًا مطبَّعًا متمايزًا؛ ويمكن للتطبيقات التي تقارن محورين جمع حدَّي البداية والنهاية لديها ثم فحص الحالة الفعلية مرة واحدة لكل مجال ناتج

يعيد TXLSXWorksheet.GetStoredStyleRegions بنية TXLSXStyleRegions منفصلة تحمل حدود FirstRow و FirstCol و LastRow و LastCol الشاملة لآثار التنسيق الافتراضي المضغوط؛ وقد تتداخل تلك الآثار، ويقرأ المستدعون مظهرها الفعلي عبر ReadSemanticCellStyle

يعيد TXLSXWorkbook.ReadSemanticFeatures(Kind, Sheet, MaxBytes, MaxItems) مدخلات TXLSXSemanticFeatures منفصلة بمفتاح Key مستقر وبايتات Definition قانونية وعدد ItemCount محسوب؛ والحدود الموجبة الاختيارية افتراضها 64 MiB و1,000,000 مدخل

يضم TXLSXSemanticFeatureKind العناصر xlsxSemanticDefinedNames و xlsxSemanticDataValidations و xlsxSemanticConditionalFormats و xlsxSemanticTables و xlsxSemanticDrawings و xlsxSemanticPivotTables و xlsxSemanticPivotCaches و xlsxSemanticSlicers و xlsxSemanticSlicerCaches و xlsxSemanticTimelines و xlsxSemanticTimelineCaches

تستخدم الأسماء المعرفة والأنواع الثلاثة من الذاكرات المؤقتة نطاقًا يغطي المصنف كاملًا وتسمح بورقة nil؛ أما الأنواع الأخرى فتتطلب ورقة عمل تنتمي إلى المصنف، وتحفظ القواعد والرسومات تسلسلها المخزن، وتكون المصفوفات والمخازن المعادة نسخًا مملوكة للمستدعي؛ ويكتسب هؤلاء القراء عقود قراءة ويرثون التغطية المُنمَّطة وسلوك البيانات غير المدعومة الصريح الموصوف أعلاه

يعيد TXLSXWorksheet.ReadSemanticRichText(Row, Col, IncludePlainText, MaxBytes, MaxItems, ConsumedItems) بايتات runs قانونية منفصلة لإحداثيات ذات أساس 1، أو مخزنًا فارغًا عندما لا يوجد نص غني وكانت IncludePlainText تساوي false؛ والمؤشر الاختياري ConsumedItems: PInteger يستقبل عدد runs الملتقطة، ويحتفظ التقاط النص العادي بالتخزين المضغوط

يكشف TXLSPivotCacheField.GroupItemTypes[Index] عن النوع المُنمَّط المقابل لـ GroupItemLabels[Index] ويرفض فهرسًا خارج مجال التسميات المجمعة المخزنة

metadata الصيغ وردود نداء استعلامات Pivot

تقرأ TXLSGetCellFormulaText و TXLSCalculator.OnGetCellFormulaText نصَّ التعبير المخزن باستخدام SheetIndex ذات أساس 1 وRow/Col ذات أساس صفر، وتعيد lxOk أو رمز خطأ مُنمَّطًا مع احترام حماية إخفاء الصيغة؛ ويحدد TXLSGetPivotTable و OnGetPivotTable جدولًا مستعارًا باستخدام SheetIndex ذات أساس 1 وإحداثيات نطاق ذات أساس صفر

توصّل محركات المصنف ردود النداء الاختيارية هذه في سياقات الحساب العادية وذات القراءة فقط والعزلة؛ ولا تعيد ردود النداء حساب الأهداف ولا تُحدِّث مصادر Pivot ولا تنقل الملكية

يخزن TXLSPivotDataConstraint اسمَ FieldName وعنصر Item مُنمَّطًا، ويجمع TXLSPivotDataConstraints أزواج الحقل/العنصر؛ ويستعلم TXLSPivotTable.GetDataValue عن تجميع واحد مرئي مدعوم من لقطة منفصلة لجدول أو ذاكرة محلية، ويستخدم IntersectsQueryRange حدودَ ورقة عمل ذات أساس 1 شاملةً خلايا مرشح التقرير المنمذجة

يستقبل TlxPivotQueryBudget تقديرات العمل والذاكرة تزامنيًا ويعيد إمكانية استمرار التقييم؛ ويميز EXLSPivotQueryBudget و EXLSPivotQueryUnsupported استنفادَ الحدود عن نماذج الذاكرة أو التجميع غير المدعومة

يسجل TXLSPivotCache.QueryModelIsComplete جهوزية الاستعلام المفكك بصرف النظر عن اكتمال إعادة تشغيل BIFF الخام؛ ويكشف QueryRecordsValid عن صلاحية السجلات المستوردة، ويطبق SetQueryRecordValidity أسبقية قارئ التنسيق دون تحديث السجلات

بايتات صفحة الشيفرة الصريحة

مرِّر RawByteString المعاد مباشرةً إلى AddRawString أو عملية تدفق موجّهة بالبايتات؛ فتحويله إلى AnsiString افتراضي قد يعيد ترميز بايتاته على أنظمة FPC الأصلية

الأسماء المعرفة الكلاسيكية وكتل صيغ المصفوفات

مجمّعات الخطوط والتنسيقات والأنماط الكلاسيكية

مساعدات الحزم والتخزين الثنائي

إضافات الرسم وعارض المصنفات

ترقيم الصفحات ومخرجات الصور والطباعة

نماذج المخططات الكلاسيكية وكائنات مخططات أوراق العمل

نموذج فك ترميز المخططات المنمَّط

تكشف حالة المخطط المفككة كسجلات وتعدادات بسيطة حتى لا تضطر شيفرة الفحص قط إلى تجوال في سجلات BIFF الخام: يحمل TXLSChartInfo ملخص المخطط المفكك مع TXLSChartTypeFamily (cfBarو cfLineو cfPieو cfAreaو cfScatterو cfRadarو cfDoughnutو cfSurfaceو cfBubble)، ويبلّغ كل سلسلة عن TXLSChartSeriesType، وتصف TXLSChart3DState مع TXLSChart3DInfo المشاهد ثلاثية الأبعاد. ويصنف TXLSChartAxisType (catCategoryو catValueو catSeriesو catDate) و TXLSChartLegendPosition المحاور ووسائل الإيضاح، بينما يستخدم نموذج محور التواريخ TXLSChartDateUnit (xcduDaysو xcduMonthsو xcduYears) و TXLSChartDateValues. ويكشف TXLSCustomChart عن النموذج المفكك عبر TXLSChartInfo؛ وتكون تعليقتا خط الاتجاه وأشرطة الخطأ كائنين منمَّطين (TXLSChartTrendlineو TXLSChartErrorBars) يمكن الوصول إليهما من كل سلسلة

سجلات تأليف المخططات

يقبل تأليف أوراق المخططات والباني سجلات بسيطة بدل رسوم الكائنات: تملأ TXLSChartTrendlineInfoو TXLSChartErrorBarsInfoو TXLSChartDataLabelsInfoو TXLSChartSeriesStyleInfo مدخلات السلاسل الممررة إلى TXLSWorksheets.AddChartSheet وباني المخططات المشترك، ويصف TXLSPivotChartInfo تأطير المخطط المحوري المستخدم عند ربط مخطط بجدول محوري

فحص تعبئة المخططات الكلاسيكية

يفك TXLSCustomChart.GetChartModel جداولَ خصائص OfficeArt الأصلية المدعومة وجداول الخصائص الثالثية في سجلات GelFrame، بما يشمل الخصائص التالية لمدخلات الحمولات المركبة؛ ويظل تمثيل الباني القائم مدعومًا، بينما تُبقي حدود الجداول المشوهة التعبئةَ المنمَّطة السابقة دون تغيير وتبلغ عن السجل غير المدعوم

يتحقق فحص المخطط من حمولة النص والتعليقات التوضيحية المخزنة كاملةً قبل إضافة الحالة المنمَّطة: فأسماء خطوط الاتجاه المقتطعة أو فواصل تسميات البيانات تبلغ عن معرف سجلها عبر _UnsupportedSemanticRecordID، بينما تبلغ ترويسات SeriesText الفارغة أو صغيرة الحجم عن ذلك السجل بوصفه غير مدعوم في BIFF5 وBIFF8 معًا؛ ويمدّ مدى نص السلسلة المعلن الذي يتجاوز حمولته استثناءَ EReadError ويحرر النموذج الجزئي ويبقي سجلات المخطط المخزنة دون تغيير

يحفظ مجрим العلامات وفحص التعبئة تخزينَ المخطط الخام؛ ويتحقق مسار التقاط المظهر المعلن على حدة من المخططات الأساسية المدعومة، بينما تبقى بصمات امتدادات العناوين الغنية أو الأشكال غير المتحقق منها غير مدعومة

قرّاء المخططات والسلاسل والخطوط المخزنة محودة الحدود

TXLSChartStoredBytes مصفوفة بايتات منفصلة ويحوي TXLSChartStoredRecord كلًّا من RecordId و Data؛ ويفحص هؤلاء القرّاء تخزين المصدر المحتفظ به دون إنشاء نموذج مخطط مفكك أو تقييم صيغ

صيانة جدول السلاسل المشتركة وإصدار SST

TXLSStringTable في lxStringTable يدعم السلاسل المشتركة للمصنف الكلاسيكي؛ ويغطي الأعضاء أدناه التسجيل من جهة القارئ وصيانة الخانات وإصدار SST الخام لعمليات الحفظ الذهاب والإياب

مرفقات PDF والتواقيع وتصدير HTML

تدقيق الحساب وعناصر تحكم المصنف

توافقية تأطير PivotCache القديم

StreamId بوصفه سجل SXStreamID ([MS-XLS] §2.4.303) ويتكرر بوصفه حقل SXDB في ترويسة idstm الذي يجب أن يساويه؛ ويُكتب SourceDataType بوصفه سجل SXVS ([MS-XLS] §2.4.317: $0001 ورقة عمل، $0002 خارجي، $0004 توحيد، $0010 سيناريو) ويتكرر بوصفه حقل SXDB في ترويسة vsType الذي يجب أن يساويه. وتبدأ الذاكرات المبنية من نطاق ورقة عمل من نوع ورقة العمل، بينما تحفظ الذاكرات المقروءة من ملف القيمة التي حملها تدفقها الفرعي، حتى لا يترك كاتب BIFF أبدًا حقل SXDB يسمي سجلًا لم يصدره؛ ويشير RawHasStorageStream إلى ذاكرة حُملت من تدفق التخزين الخاص بها والذي يسبق واصفه العام على مستوى المصنف السجلات المخزنة مؤقتًا

تكامل الحافظة وخيارات اللصق

TXLSPasteOption = (xlpoValuesOnly, xlpoInsertRows, xlpoInsertCols);
TXLSPasteOptions = set of TXLSPasteOption;

function XLSGetClipboardText: WideString;
function XLSSetClipboardText(const Text: WideString): Boolean;
function XLSSetClipboardTextAndHtml(const Text: WideString;
  const Html: AnsiString): Boolean;
function XLSBuildHtmlClipboard(const Html: AnsiString): AnsiString;
function XLSEncodeClipboardField(const Text: WideString): WideString;
function XLSClipboardHasText: Boolean;
function XLSParseClipboardGrid(const ClipboardText: WideString;
  Loader: TXLSCSVLoader): Boolean;
function XLSClipboardHasXmlSpreadsheet: Boolean;
function XLSGetClipboardXmlSpreadsheet: WideString;
function XLSParseXmlSpreadsheet(const XmlText: WideString;
  Loader: TXLSCSVLoader): Boolean;
function XLSClipboardHasBiff8: Boolean;
function XLSGetClipboardBiff8: AnsiString;
function XLSReadClipboardPasteData(out Biff8: AnsiString;
  out Text: WideString): Boolean;
function XLSSetClipboardBiff8(const Biff8: AnsiString;
  const Text: WideString; const Html: AnsiString = ''): Boolean;
      

حل نص عرض الخلية

TXLSCellDisplayMode = (xcdmFormattedValue, xcdmFormulaText,
  xcdmSuppressedZero);

TXLSCellDisplayOptions = record
  ShowFormulas: Boolean;
  ShowZeros: Boolean;
  SheetProtected: Boolean;
  FormulaWidthFactor: Double;
  DateSerialZero: Double;
end;

TXLSCellDisplayInput = record
  HasFormula: Boolean;
  FormulaHidden: Boolean;
  IsNumericZero: Boolean;
  FormulaText: WideString;
  FormattedText: WideString;
end;

TXLSCellDisplayResult = record
  Mode: TXLSCellDisplayMode;
  Text: WideString;
  TreatAsText: Boolean;
  EffectiveWidthFactor: Double;
end;

function XLSDefaultCellDisplayOptions: TXLSCellDisplayOptions;
function XLSNormalizeFormulaDisplayText(const FormulaText: WideString): WideString;
function XLSResolveCellDisplay(const Options: TXLSCellDisplayOptions;
  const Input: TXLSCellDisplayInput): TXLSCellDisplayResult;
      

كائنات التحقق من صحة البيانات الكلاسيكية

TXLSDataValidationType = (xlsDvAny, xlsDvWhole, xlsDvDecimal, xlsDvList,
  xlsDvDate, xlsDvTime, xlsDvTextLength, xlsDvCustom);
TXLSDvErrorStyle = (xlsDvErrStop, xlsDvErrWarning, xlsDvErrInformation);

TDVRange = class;             { one validation rule over one or more ranges }
TDVRangeList = class;         { the per-sheet rule collection }
TDataValidator = class;       { engine that checks edits against the rules }
      

مسح الألوان المفهرسة وحلها

TXLSIndexedColorKind = (xickPalette, xickAutomatic, xickSystem, xickInvalid);
TXLSSystemColorRole = (xscrNone, xscrWindowText, xscrWindowBackground,
  xscrChartText, xscrChartBackground, xscrChartNeutral, xscrToolTipText);

TXLSIndexedColorResolution = record
  Kind: TXLSIndexedColorKind;
  RawIndex: Int64;
  PaletteSlot: Integer;
  SystemColorRole: TXLSSystemColorRole;
  ARGB: LongWord;
  HasResolvedColor: Boolean;
end;

TXLSNearestIndexedColorMatch = record
  InputARGB: LongWord;
  ColorIndex: Integer;
  PaletteSlot: Integer;
  ARGB: LongWord;
  DistanceSquared: Double;
  ExactMatch: Boolean;
end;

TXLSIndexedColorUsageKind = (xicukFont, xicukFillForeground,
  xicukFillBackground, xicukGradient, xicukBorder, xicukConditionalFormat,
  xicukChart, xicukShape, xicukComment, xicukWorksheet, xicukOther);
      

مساعدات مراجع A1

function XLSA1CellRef(ARow, ACol: Integer): WideString;
function XLSTryParseA1CellRef(const ARef: WideString;
  out ARow, ACol: Integer): Boolean;
function XLSTryParseA1RangeRef(const ARef: WideString;
  out ARow1, ACol1, ARow2, ACol2: Integer): Boolean;
      

انظر أيضًا

• أعضاء API إضافيون لـ Classic XLS
• أعضاء API المتقدمة لـ XLSX
• هندسة المخطط التفصيلي المتناثر
• تتبع الصيغ وتدقيقها
• عارض المصنفات