ميزة عارض المصنّفات

نظرة عامة

بالإضافة إلى معالجة الملفات، تحتاج تطبيقات Delphi المكتبية غالبًا إلى عرض المصنّفات وتحريرها؛ ويتضمّن HotXLS عنصر تحكّم مرئيًا من نوع VCL يعرض أيًّا من نموذجَي المصنف مباشرة

عنصر تحكّم TXLSWorkbookViewer

يوفر مكوّن TXLSWorkbookViewer التمرير والتحديد المستطيلي والتحرير وإدخال الصيغ والتعليقات والارتباطات التشعبية والتنسيق الشرطي ومعاينة الطباعة دون إنشاء ملفات مؤقتة

أسند Workbook لمصنفات XLS الكلاسيكية أو XlsxWorkbook لمصنفات XLSX وODS، أو استدعِ LoadFromFile ليتملّك عنصر التحكّم المصنف المحمَّل

التحرير وإدخال الصيغ

اضبط Editable على True لتمكين التحرير عبر F2 والنقر المزدوج ومفاتيح الأحرف القابلة للطباعة وDelete وشريط الصيغ؛ تبقى الخلايا المقفلة المحمية للقراءة فقط، بينما تبقى الخلايا غير المقفلة صراحةً قابلة للتحرير

يعيد FormulaBarText صيغة الخلية المحددة بعلامة يساوي البادئة أو قيمتها المُدخلة، وإسناد الخاصية يطبّق صيغة جديدة أو قيمة مكتوبة ويعيد حساب الصيغ التابعة

يستخدم Undo وRedo سجلًّا دائريًّا محدود الحجم تتحكم فيه UndoLimit؛ والتراجع عن خلية XLSX أُنشئت حديثًا يعيد حالة غيابها من التخزين المتناثر. كل إدخال في السجل هو لقطة TXLSViewerCellState (نوع المصنف، الوجود، الورقة، الإحداثيات، الصيغة، القيمة، وحالة التنسيق)، وهي متاحة أيضًا عبر أسلوب قراءة الحالة العام

خطّافات التحرير معاودة اتصال مكتوبة الأنواع: يستقبل OnBeforeEdit (من نوع TXLSViewerBeforeEditEvent) النص المقترح ويمكنه الاعتراض عليه أو إعادة كتابته عبر Allow وText، ويفيد OnAfterEdit (من نوع TXLSViewerAfterEditEvent) بالنص المثبَّت

Viewer.Editable := True;
Viewer.GoToCell(2, 3);
Viewer.FormulaBarText := '=A1*2';
Viewer.Undo;
Viewer.Redo;

اختيار النطاق والمراجع

استخدم التنقل مع Shift أو السحب بالفأرة أو SelectRange لإنشاء تحديد مستطيلي يُكشف عبر SelectionTop وSelectionLeft وSelectionBottom وSelectionRight وSelectedRange

يمكّن BeginReferencePick وضع مراجع الصيغ، وينشر OnReferencePick (من نوع TXLSViewerReferenceEvent) نطاق A1 الحالي كلما تغيّر التحديد؛ واستدعِ EndReferencePick حين يقبل محرر الصيغ في التطبيق المضيف المرجع

خصائص العرض

راجع عناصر التحكّم بالإعداد أدناه

• دليل مرجعي لمكوّن WorkbookViewer — التحرير والتنقل والأحداث والعرض ومعاينة الطباعة
• الخاصية DisplayGridLines — تبديل حدود الشبكة
• الخاصية Zoom — ضبط نسب تكبير الورقة