فئة TXLSFormulaDebugger

يحلل TXLSFormulaDebugger صيغة في سياق ورقة عمل XLSX واحدة ويعيد TXLSFormulaDebugSession مملوكًا

تجمع الجلسة شجرة التعبير المُحلَّلة بالكامل مع ترتيب التقييم الفعلي والقيم الوسيطة وإحداثيات التبعيات والفروع الكسولة المختارة والتعبيرات المُتخطاة ومصدر الخطأ الأول

يملك المتصل كل جلسة يعيدها Analyze ويجب أن يحرّرها

الإعلان

type
  TXLSFormulaDebugger = class
    constructor Create(Worksheet: TXLSXWorksheet);
    function Analyze(const Formula: WideString):
      TXLSFormulaDebugSession;
  end;

أعضاء الجلسة

تشخيصات العقدة

يُبلّغ كل TXLSFormulaDebugNode عن أصله وعمقه ومدى المصدر ونوع العقدة واسم العامل أو الدالة ومعرّفات عُقد المعاملات وقيم المعاملات وقيمة النتيجة وفهرس التقييم والحالة والفرع المختار وتفاصيل الخطأ

حالة العقدة هي fdsPending أو fdsEvaluated أو fdsSkipped أو fdsError

تميّز تشخيصات الفروع بين مساري IF الصحيح والخاطئ ومساري القيمة والاحتياطي IFERROR أو IFNA وفرع CHOOSE أو IFS أو SWITCH المختار

تظل الأخطاء الداخلية المستردة مرئية على عُقدها حتى عندما تكون نتيجة الصيغة النهائية صحيحة

التنقل

• يختار MoveFirst خطوة التقييم الأولى
• ينقل MoveNext وMovePrevious المؤشر الحالي دون إعادة حساب
• يختار SeekNode عقدة واحدة بواسطة معرّفها الثابت المحلي للجلسة
• يمسح Reset المؤشر مع الحفاظ على كل التشخيصات

مثال

Debugger := TXLSFormulaDebugger.Create(Sheet);
try
  Session := Debugger.Analyze('=IF(A1=0,42,B1/C1)');
  try
    if Session.MoveFirst then
      repeat
        Writeln(Session.CurrentNode.Source);
      until not Session.MoveNext;
  finally
    Session.Free;
  end;
finally
  Debugger.Free;
end;

انظر أيضًا

• تتبع الصيغ وفحصها
• محرك الحساب
• TXLSXWorksheet