HotXLS Docs

Функція переглядача книг

Огляд

Окрім маніпуляцій з файлами, настільні додатки Delphi часто потребують візуального відображення книг користувачам; HotXLS включає візуальний елемент керування для відображення таблиць безпосередньо у формах VCL та FMX

Елемент керування 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, коли формульний редактор хоста прийняв посилання

Властивості відображення

Перевірте елементи керування конфігурацією нижче