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

تدعم هذه الأعضاء العامة عمليات التكامل التي تفحص الإدخال/الإخراج أو تنفذ مُسلسلات أو تنسق الحساب عبر مصنفات، مع أعضاء المصنف المعلنين في lxHandleX ورسم مساحة العمل المعلن في lxDepGraph

على التطبيقات العادية استخدام تنسيق الخلايا وSaveAs وRecalculate وواجهات مساحة عمل المصنفات الخارجية أولًا؛ فتسجيل مجمعات الأنماط وجدولة الرسم يتطلبان اصطلاحات الفهرس والعمر نفسها التي تتبعها مُسلسلات المكتبة ومحرك الحساب

مراقبة الإدخال/الإخراج والاسترجاع

يتسلم TXLSXWorkbook.OnReadCell فهرس الورقة والصف والعمود والقيمة المخزنة والصيغة لكل خلية مجسَّدة أثناء تحليل XLSX مع علم Cancel قابل للكتابة؛ ويتسلم TXLSXWorkbook.OnWriteCell قيمة إخراج قابلة للكتابة مع علمَي Skip وCancel قبل تسلسل خلية، ليستطيع المضيف تحويل الإخراج أو حذفه دون استبدال واجهة المصنف بواجهة التيار المباشرة

تستخدم النداءتان إحداثيات ورقة عمل وخلايا قائمة على الواحد وأنواعهما المعلنة هي TXLSXCellReadEvent وTXLSXCellWriteEvent؛ وتنفذ النداءات داخل عملية الإدخال/الإخراج النشطة فتجنّب بدء عملية أخرى على المصنف نفسه من نداء

افتراضي TXLSXWorkbook.RecoveryMode هو False ويتيح لإخفاقات تحليل XML أوراق العمل المدعومة أن تصير تشخيصات تحذيرية مع استمرار الفتح، وقد يُبقي محتوى أوراق عمل مسترجعًا جزئيًا فقط؛ وهو لا يضمن الاسترجاع من حزمة ZIP غير قابلة للقراءة، فافحص التشخيصات والبيانات المسترجعة قبل الحفظ

يوزع TXLSXWorkbook.FireProgress طورًا وحالة وعددًا حاليًا وإجماليًا على معالجات التقدم المسندة، فيتسلم المعالج القديم إشعارات العمل ويتسلم المعالج الموسع كل الحالات؛ ويستطيع المعالج الموسع طلب الإلغاء إلا أن إشعارة نهاية الكتابة لا تستطيع عكس إخراج ملتُزم به سلفًا

يلحق TXLSXWorkbook.AddDiagnostic تشخيصًا مملوكًا للمصنف ويعيده، ويسجل الكود والخطورة والعملية والرسالة والكود الأصلي وسياق الورقة واسم جزء الحزمة المزودة، وينسخ اسم فئة الاستثناء عند تزويده، ويستدعي OnDiagnostic؛ وهو لا يتملك الاستثناء ولا يثيره

function TXLSXWorkbook.AddDiagnostic(ACode: Integer;
  ASeverity: TXLSDiagnosticSeverity; AOperation: TXLSDiagnosticOperation;
  const AMessage: WideString; ANativeCode, ASheetIndex: Integer;
  const ASheetName, APartName: WideString;
  AException: Exception): TXLSDiagnostic;

سياسات الإخراج وفحص الحزمة المحفوظة

افتراضي TXLSXWorkbook.CSVEmitFormulas هو False ويحوّل إخراج CSV من نتائج الصيغ إلى نص الصيغ لخلايا الصيغ؛ ويحاول إخراج النتائج تقييم الصيغة ويتراجع إلى نص الخلية المخزن أو قيمتها عند فشل التقييم؛ وافتراضي TXLSXWorkbook.CSVQuoteAllStrings كذلك False ويفرض علامات اقتباس حول حقول النص بينما تحتفظ الأعداد والتواريخ والقيم المنطقية وNull وEmpty بقواعد الاقتباس العادية

يبلّغ TXLSXWorkbook.LastSaveUsedStreaming عما إذا كان الحفظ المجهز الأخير استخدم بث ورقات العمل، بينما يبلّغ TXLSXWorkbook.LastSavePeakRowXmlChars عن أكبر جزء XML صف مخزَّن، ويبلّغ TXLSXWorkbook.LastSaveBufferedWorksheetXmlChars عن XML ورقة العمل المخزَّن المجمع، ويبلّغ TXLSXWorkbook.LastSavePeakAuxiliaryXmlChars عن أكبر جزء XML مساعد متتبَّع؛ وهي أعداد محارف من أجهزة قياس المُسلسل لا قياسات ذاكرة العملية الكلية، ولا يستخدم إخراج ODS مسار بث أوراق عمل XLSX

يحاول TXLSXWorkbook.TryCopyPreservedPart نسخ جزء مصدر محفوظ مؤهل، بما يشمل تمثيله المضغوط، إلى ‏TZipArchive وجهة يزودها المستدعي معادًا True عند النسخ وFalse عند وجوب التسلسل العادي؛ ويجب أن يبقى المصدر متاحًا من فتح مدعوم بملف، والأجزاء المفقودة أو الممسوحة صراحةً لا تُنسخ

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

التشفير والبيانات الوصفية للمصنف

يقبل TXLSXWorkbook.SaveAsEncryptedAgile اسم ملف وكلمة مرور غير فارغة ويسلسل حزمة XLSX في الذاكرة ويكتب الحاوية المشفرة Agile معادًا 1 عند النجاح أو ‎-1 عند فشل مُبلَّغ؛ ويجري VerifyEncryptedSave الاختياري فحص إعادة فتح بعد الكتابة، وتتطلب الطريقة ذاكرةً للحزمة غير المشفرة إضافةً إلى بايتاتها المسلسلة

يفتح TXLSXWorkbook.VerifyEncryptedFile الملف وكلمة المرور المزودين في مصنف مؤقت ويعيد True فقط عندما ينجح ذلك الفتح محوِّلًا الاستثناءات إلى False؛ وهذا يفحص القابلية للقراءة لا مطابقة كل خلية مع المصنف الحالي، ويتبع سلوك OpenEncrypted العادي لإدخال XLSX غير مشفر

يخزن TXLSXWorkbook.DocSecurity حقل بتات خصائص المستند الموسعة: 1 يعني الحماية بكلمة مرور، و2 التوصية بالقراءة فقط، و4 فرض حالة القراءة فقط، و8 قفل التعليقات؛ وهذه بتات البيانات الوصفية لا تطبق بنفسها تشفيرًا ولا قيود وصول

TXLSXWorkbook.DocPropsTouched علم القراءة فقط الذي تستخدمه كتّاب خصائص المستند ليقرروا هل هُيئت الخصائص المتتبعة؛ وتعيّنه أدوات ضبط الخصائص المتتبعة مثل Title، بينما لا تعيّنه تلقائيًا البيانات الوصفية الموسعة المسندة مباشرة

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

يعرض TXLSXWorkbook.ThemeMajorFont وTXLSXWorkbook.ThemeMinorFont خطي العناوين والمتن المحمَّلين من النسق ويتجاوزان الاسمين عند توليد نسق Office الافتراضي؛ ويستبق النسق المحفوظ حرفيًا إعدادَي اسم الخط هذين

أنماط الجداول ومجمعات أنماط المُسلسلات

تعاود TXLSXWorkbook.DefaultTableStyleName وTXLSXWorkbook.DefaultPivotStyleName الأسماءَ الافتراضية المخزنة في جدول الأنماط لجداول Excel وPivotTables المدرجة حديثًا؛ وإسنادهما لا يعيد تنسيق كل الكائنات القائمة مباشرة

يعيد TXLSXWorkbook.ResolveTableStyle نمطًا مخصصًا مملوكًا للمصنف بالاسم، وإلا يحل ويخزّن الأنماط المدمجة المدعومة ‏TableStyleLight1 حتى TableStyleLight21 وTableStyleMedium1 حتى TableStyleMedium28 أو TableStyleDark1 حتى TableStyleDark11 ويعيد nil لاسم غير معروف؛ ولا تحرّر النمط المعاد

افتراضي TXLSXWorkbook.FastStyleAppend هو False ويتيح للإنشاء الجماعي تخطي مسحات إزالة التكرار في مجمعات الأنماط وتسجيل الأنماط المركبة العادية، مقايضةً بجدول أنماط أكبر مقابل إدراج أسرع عند إنشاء أنماط متمايزة كثيرة

function TXLSXWorkbook.RegisterCompositeXf(
  AFont, AFill, ABorder, ANumFmt, AAlign, AProt: Integer): Integer; overload;
function TXLSXWorkbook.RegisterCompositeXf(
  AFont, AFill, ABorder, ANumFmt, AAlign, AProt,
  ABuiltinNumFmt: Integer): Integer; overload;
function TXLSXWorkbook.RegisterLinkedCompositeXf(
  AFont, AFill, ABorder, ANumFmt, AAlign, AProt,
  AParentXfId: Integer; ALinkedParts: TXLSXFormatParts): Integer;

يسجل TXLSXWorkbook.RegisterCompositeXf فهارس الخط والتعبئة والحد وتنسيق الأعداد والمحاذاة والحماية مجتمعةً ويعيد فهرس cellXfs المطلق لا خانة مجمّع مركب؛ وتقبل الحمولة ذات سبعة وسائط معرف تنسيق أعداد مدمجًا يتقدم على فهرس التنسيق المخصص المزود، والصفر يعني لا تجاوز

يسجل TXLSXWorkbook.RegisterLinkedCompositeXf إضافةً معرف نمط XF الأب وأجزاء التنسيق المرتبطة بذلك الأب محافظًا على مداخل منفصلة لتركيبات الأب أو الارتباط المختلفة؛ ويعيد كذلك فهرس cellXfs مطلقًا

يعيد TXLSXWorkbook.CompositeXfBase أول فهرس مركب مطلق محسوبًا من مجمعات الأنماط أحادية البعد الحالية، بينما يَعُدُّ TXLSXWorkbook.CompositeXfCount المداخلَ المركبة المسجلة؛ وخانة المجمّع التي تستخدمها GetCompositeXf هي الفهرس المطلق ناقص الأساس، ويتغير الأساس عندما تكبر تلك المجاميع فهذه القيم تعود لحالة التسلسل الحالية

يسجل TXLSXWorkbook.RegisterCondDxf مرجع TXLSDxfStyle مستعارًا ويعيد معرف نمطه التفاضلي المبني على الصفر معيدًا استخدام المعرف القائم لمرجع الكائن نفسه؛ وأبقِ الكائن حيًّا ما دام التسلسل يستخدمه

يمسح TXLSXWorkbook.ResetCondDxfs عدد السجل النشط دون تحرير الأنماط المستعارة ويبلّغ TXLSXWorkbook.CondDxfCount عن ذلك العدد؛ ويعيد تجهيز الحفظ بناء هذا السجل فلا تخزّن هذه المعرفات باستقلال عن الحزمة المكتوبة

TXLSXWorkbook.PivotCaches هي مجموعة TXLSPivotCaches المملوكة للمصنف المشتركة بين جداول Pivot لأوراق العمل؛ ويعيد AddPivotTable استخدام cache مصدر مطابق أو ينشئ واحدًا، ويحدّث RefreshPivotCache الـ cache المحدد مع الحفاظ على هويات الأعضاء المدعومة

تكامل الحساب

افتراضي TXLSXWorkbook.RecalcThreads هو صفر، مع استخدام الصفر أو الواحد إعادة حساب تسلسلية وقيم أكبر تفعّل تقييم العمال لجبهات الصيغ المستقلة؛ وتستخدم المصنفات ذات المصفوفات الديناميكية تمريرة تسلسلية بصرف النظر عن هذا الإعداد، وتبقى عقد what-if لجداول البيانات تسلسلية، ويجب أن تكون معالجات دوال المستخدم التي يستخدمها العمال آمنة الخيوط

TXLSXWorkbook.SolveCycleIteratively نقطة دخول متقدمة يستدعيها Recalculate عادةً عند تفعيل التكرار، مستهلِكةً فهارس العقد من رسم التبعيات الحالي لذلك المصنف ومقيِّمًا عقد الدورات في TList المزود؛ وفهارس رسم مساحة عمل أو مصنف آخر غير قابلة للتبادل

يستخدم الحلّال IterateCount وIterateDelta ويحتفظ بالقيم النهائية حتى عند بلوغ حد التكرار ويعيد lxOk دون شهادة تقارب؛ ويعيد أعضاء دورات المصفوفات الديناميكية ‏lxErrorCircumRef، ولا يستبدل وسيط CycleCount في التوقيع تصنيفَ الدورات على عقد الرسم

بناء رسم تبعيات مساحة العمل

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

function TXLSWorkspaceDepGraph.AddNode(
  const AWorkbookIdentity, ASheetName: WideString;
  ASheetIndex, ARow, ACol, AOutRow2, AOutCol2: Integer;
  AVolatile: Boolean; AReferences: TXLSWorkspaceDepReferenceList;
  ARefUnstable: Boolean = False): Integer;
procedure TXLSWorkspaceDepGraph.DirtyTopoOrder(AOrder: TList;
  out ACycleNodeCount, ABlockedNodeCount: Integer);

يلحق TXLSWorkspaceDepGraph.AddNode عقدة صيغة ويعيد فهرس عقدته المبني على الصفر منسخًا المراجعَ المزودة لا مالكًا لقائمتها؛ وفهارس الأوراق قائمة على الواحد، بينما إحداثيات الصفوف والأعمدة بما يشمل الركن الأيمن السفلي لمستطيل الإخراج الشامل قائمة على الصفر بإحداثيات المقيّم

يلحق TXLSWorkspaceDepReferenceList.Add سجل مرجع خلية أو نطاق أو اسم معرَّف محلولًا، وتقرأ TXLSWorkspaceDepReferenceList.Items تلك السجلات بفهرس مبني على الصفر، ويعيد TXLSWorkspaceDepReferenceList.Clear القائمة للاستخدام؛ وتمتلك المستدعي قائمة الإدخال هذه ويستطيع مسحها أو تحريرها بعد نسخ AddNode مداخلها

يحل TXLSWorkspaceDepGraph.BuildEdges مراجع الخلايا والنطاقات المخزنة مقابل مستطيلات إخراج الصيغ؛ وتنشر المراجع المعلمة ‏LookupScan الاتساخَ لكنها لا تفرض ترتيب تقييم ولا تشارك في كشف الدورات

يحل TXLSWorkspaceDepGraph.NodeIndexOf مصنفًا وورقةً وصفًا وعمودًا إلى فهرس عقدة مبني على الصفر أو ‎-1 عند الغياب مستخدمًا اسم الورقة عند توفره وفهرس الورقة المعلن بديلًا

يمسح TXLSWorkspaceDepGraph.FindDependentsOfDefinedName ‏TList غير nil المزود ويمتلئه بفهارس العقد التي تشير مباشرةً إلى الرمز المسماى في المصنف والنطاق المحددين، ويعطي فهرس النطاق السالب كل النطاقات؛ وتُشفَّر المداخل ‏Pointer(NativeInt(NodeIndex)) فيستطيع مدخل قائمة nil تمثيل العقدة صفر

أجيال الاتساخ وترتيب التقييم في مساحة العمل

يبدأ TXLSWorkspaceDepGraph.BeginDirtyGeneration جيلًا جديدًا ويصفّر عدد عقد الاتساخ النشطة وأعلام الحجب الدوري ويجعل أختام الاتساخ السابقة غير نشطة؛ واستدعه قبل تعليم عقد تمريرة إعادة الحساب الجديدة

يعلّم TXLSWorkspaceDepGraph.MarkAllDirty كل عقدة في الجيل الحالي؛ ويبذّر TXLSWorkspaceDepGraph.MarkWorkbookDirty العقدَ العائدة للمصنف المحدد والعقدَ الإشارة إليه ثم ينشر إلى التابعين، بينما يبذر TXLSWorkspaceDepGraph.MarkVolatileDirty العقدَ المتقلبة وTXLSWorkspaceDepGraph.MarkCyclesDirty مكوّنات الدورات المكتشفة منشرًا كذلك اتساخهما

يبلّغ TXLSWorkspaceDepGraph.IsNodeDirty عما إذا كانت عقدة صالحة تحمل ختم الجيل الحالي ويعيد False لفهرس غير صالح؛ ويعرض TXLSWorkspaceDepGraph.DirtyGeneration ذلك الختم ويَعُدُّ TXLSWorkspaceDepGraph.DirtyNodeCount العقدَ المعلمة في الجيل النشط

يتطلب TXLSWorkspaceDepGraph.DirtyTopoOrder قائمة TList غير nil مملوكة للمستدعي ويمسحها ويمتلئها بفهارس العقد المتسخة بترتيب التبعيات مستثنيًا عقد الدورات المتسخة والعقد المحجوبة بتلك الدورات؛ ويميز عدداهما المخرجان أعضاءَ الدورات عن العقد اللاحقة المحجوبة، وتستخدم مداخل القائمة اصطلاح الفهرس المبني على الصفر المشفَّر كمؤشر نفسه

يبلّغ TXLSWorkspaceDepGraph.HasRefUnstable عما إذا أُضيفت أي عقدة بعلم مرجع غير مستقر، بما يتيح للمستدعي تفادي الاعتماد على جدولة ثابتة متقادمة عندما تستطيع مراجع الصيغ التغير عند وقت التقييم؛ والرسم لا يحل تلك المراجع المتغيرة بنفسه

فحص رسم مساحة العمل

يَعُدُّ TXLSWorkspaceDepGraph.NodeCount عقد الصيغ ويَعُدُّ TXLSWorkspaceDepGraph.ReferenceCount المراجع المنسوخة ويبلّغ TXLSWorkspaceDepGraph.EdgeCount عن حواف التبعية المبنية؛ واستدعِ BuildEdges قبل استهلاك إحصاءات الحواف

يَعُدُّ TXLSWorkspaceDepGraph.WorkbookCount هويات المصنفات المُسجَّلة بما يشمل الهويات المقدمة من المراجع، ويدوّد TXLSWorkspaceDepGraph.WorkbookIdentities تلك الهويات بفهرس مبني على الصفر؛ وهذه سلاسل الهوية مفاتيح رسم لا دليلًا على تحميل ملف خارجي

يبلّغ TXLSWorkspaceDepGraph.ComponentCount عن عدد المكونات شديدة الاتصال بعد بناء المكونات الذي تطلبه MarkCyclesDirty أو DirtyTopoOrder أو الوصول إلى المكونات؛ ويزود كل سجل Components‏ NodeStart وNodeCount وIsCycle

يعرض TXLSWorkspaceDepGraph.ComponentNodes مصفوفة فهارس العقد المسطحة المبنية على الصفر لتلك المكونات مفهرسةً من NodeStart للمكون حتى NodeStart + NodeCount - 1؛ وتصف الأعداد والسجلات المفهرسة الرسمَ الحالي فينبغي إعادة اكتسابها بعد إعادة بناء الرسم

واصل مع أعضاء واجهة XLSX الإضافيين ونظرة عامة على واجهة XLSX لنقاط دخول المصنف العادية