قابلیت نمایش‌دهنده کتاب کار

نمای کلی

علاوه بر دستکاری فایل، برنامه‌های دسکتاپ Delphi اغلب نیازمند نمایش بصری کتاب‌های کار به کاربران هستند؛ HotXLS شامل یک کنترل بصری برای رندر صفحه‌های گستر مستقیماً درون فرم‌های VCL و FMX است

کنترل TXLSWorkbookViewer

مؤلفه TXLSWorkbookViewer پیمایش، انتخاب مستطیلی، ویرایش، ورود فرمول، نظرات، ابرپیوندها، قالب‌بندی شرطی و print preview را بدون ساخت فایل‌های موقت فراهم می‌کند

برای کتاب‌کارهای XLS کلاسیک Workbook و برای کتاب‌کارهای XLSX و ODS مقدار XlsxWorkbook را مقداردهی کنید، یا LoadFromFile را فراخوانی کنید تا کنترل، مالک کتاب کار بارگذاری‌شده باشد

ویرایش و ورود فرمول

مقدار Editable را True کنید تا ویرایش با F2، دابل‌کلیک، کلیدهای حرفی، Delete و نوار فرمول فعال شود؛ سلول‌های قفلِ محافظت‌شده فقط‌خواندنی می‌مانند و سلول‌هایی که صراحتاً از قفل خارج شده‌اند قابل ویرایش می‌مانند

FormulaBarText فرمول سلول انتخاب‌شده را با علامت مساوی ابتدایی آن یا مقدار ورودی آن برمی‌گرداند و مقداردهی این ویژگی، فرمول یا مقدار تایپ‌شده جدیدی را اعمال و فرمول‌های وابسته را از نو محاسبه می‌کند

Undo و Redo از یک تاریخچه حلقوی محدود که با UndoLimit کنترل می‌شود استفاده می‌کنند؛ واگردِ یک سلول تازه‌ساخته XLSX آن را به حالت غایبِ ذخیره‌سازی sparse بازمی‌گرداند. هر مدخل تاریخچه یک snapshot از نوع TXLSViewerCellState است (نوع کتاب کار، وجود، برگه، مختصات، فرمول، مقدار و وضعیت قالب‌بندی) که از طریق روش عمومی خواندن وضعیت هم در دسترس است

قلاب‌های ویرایش callback های نوع‌دار هستند: 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 — تنظیم نسبت‌های بزرگنمایی برگه