HotXLS Docs

Fonctionnalité de visionneuse de classeur

Vue d'ensemble

En plus de la manipulation de fichiers, les applications de bureau Delphi ont souvent besoin d'afficher et d'éditer des classeurs ; HotXLS inclut un contrôle VCL visuel qui restitue directement l'un ou l'autre modèle de classeur

Contrôle TXLSWorkbookViewer

Le composant TXLSWorkbookViewer fournit défilement, sélection rectangulaire, édition, saisie de formule, commentaires, hyperliens, mise en forme conditionnelle et aperçu avant impression, sans créer de fichiers temporaires

Assignez Workbook pour le XLS classique ou XlsxWorkbook pour les classeurs XLSX et ODS, ou appelez LoadFromFile pour laisser le contrôle posséder le classeur chargé

Édition et saisie de formule

Définissez Editable à True pour activer l'édition par F2, double-clic, touches imprimables, Delete et barre de formule ; les cellules verrouillées protégées restent en lecture seule tandis que les cellules explicitement déverrouillées restent éditables

FormulaBarText renvoie la formule de la cellule sélectionnée avec son signe égal de tête, ou sa valeur de saisie, et l'affectation de la propriété applique une nouvelle formule ou une valeur saisie puis recalcule les formules dépendantes

Undo et Redo utilisent un historique circulaire borné contrôlé par UndoLimit ; annuler une cellule XLSX nouvellement créée restaure son état d'absence dans le stockage creux. Chaque entrée d'historique est un instantané TXLSViewerCellState (type de classeur, existence, feuille, coordonnées, formule, valeur et état de format), également accessible via la méthode publique de lecture d'état

Les hooks d'édition sont des callbacks typés : OnBeforeEdit (un TXLSViewerBeforeEditEvent) reçoit le texte proposé et peut y mettre un veto ou le réécrire via Allow et Text, et OnAfterEdit (un TXLSViewerAfterEditEvent) signale le texte validé

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

Sélection de plages et de références

Utilisez la navigation avec Shift, le glisser de la souris ou SelectRange pour créer une sélection rectangulaire exposée via SelectionTop, SelectionLeft, SelectionBottom, SelectionRight et SelectedRange

BeginReferencePick active le mode référence de formule et OnReferencePick (un TXLSViewerReferenceEvent) publie la plage A1 courante à chaque changement de sélection ; appelez EndReferencePick lorsque l'éditeur de formule hôte a accepté la référence

Propriétés d'affichage

Consultez les contrôles de configuration ci-dessous