HotXLS Docs

Funkcia przeglądarki skoroszytów

Przegląd

Oprócz manipulowania plikami, aplikacje desktopowe Delphi często muszą wizualnie wyświetlać skoroszyty użytkownikom; HotXLS zawiera wizualną kontrolkę do renderowania arkuszy bezpośrednio w formularzach VCL i FMX

Kontrolka TXLSWorkbookViewer

Komponent TXLSWorkbookViewer zapewnia przewijanie, zaznaczanie prostokątne, edycję, wprowadzanie formuł, komentarze, hiperłącza, formatowanie warunkowe i podgląd wydruku bez tworzenia plików tymczasowych

Przypisz Workbook dla klasycznych skoroszytów XLS albo XlsxWorkbook dla skoroszytów XLSX i ODS, albo wywołaj LoadFromFile, aby kontrolka sama stała się właścicielem wczytanego skoroszytu

Edycja i wprowadzanie formuł

Ustaw Editable na True, aby włączyć edycję przez F2, podwójne kliknięcie, klawisze znaków, Delete oraz pasek formuły; zablokowane komórki w arkuszach chronionych pozostają tylko do odczytu, a komórki jawnie odblokowane pozostają edytowalne

FormulaBarText zwraca formułę zaznaczonej komórki wraz z wiodącym znakiem równości albo jej wartość wejściową, a przypisanie tej właściwości wprowadza nową formułę lub wartość i przelicza formuły zależne

Undo i Redo korzystają z ograniczonej historii cyklicznej sterowanej przez UndoLimit; cofnięcie nowo utworzonej komórki XLSX przywraca jej nieobecny stan w rzadkim magazynie. Każdy wpis historii to migawka TXLSViewerCellState (rodzaj skoroszytu, istnienie, arkusz, współrzędne, formuła, wartość i stan formatu), dostępna także przez publiczną metodę odczytu stanu

Haki edycji to typowane callbacki: OnBeforeEdit (typ TXLSViewerBeforeEditEvent) otrzymuje proponowany tekst i może go zawetować lub przepisać przez Allow i Text, a OnAfterEdit (typ TXLSViewerAfterEditEvent) raportuje tekst zatwierdzony

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

Zaznaczanie zakresów i odwołań

Użyj nawigacji z Shiftem, przeciągania myszą albo SelectRange, aby utworzyć zaznaczenie prostokątne dostępne przez SelectionTop, SelectionLeft, SelectionBottom, SelectionRight i SelectedRange

BeginReferencePick włącza tryb pobierania odwołań do formuł, a OnReferencePick (typ TXLSViewerReferenceEvent) publikuje bieżący zakres A1 przy każdej zmianie zaznaczenia; wywołaj EndReferencePick, gdy edytor formuł gospodarza przyjął odwołanie

Właściwości widoku

Sprawdź kontrolki konfiguracji poniżej