Questions fréquemment posées

Des réponses pratiques aux problèmes que rencontrent d'abord les utilisateurs de HotXLS.

Cette page regroupe les questions les plus susceptibles de se poser lors de l'installation de HotXLS, du choix entre les façades XLS et XLSX, de l'évaluation de la version d'essai, de l'export de rapports et du déploiement d'applications Delphi ou C++Builder

Bibliothèque native Les classeurs sont générés dans votre processus Delphi ou C++Builder.
XLS et XLSX Des façades distinctes maintiennent la stabilité du code XLS hérité tandis que le XLSX évolue indépendamment.
Installez en premier Utilisez le programme d'installation pour une configuration normale ; il détecte les versions prises en charge de RAD Studio.
Sans redevances à l'exécution Déployez des applications sans frais d'exécution par copie.

Installation Et Configuration de l'IDE

La plupart des questions de configuration concernent la détection de l'IDE, les versions prises en charge et le contenu C++Builder optionnel.

Quelles versions de Delphi et C++Builder sont prises en charge ?

Le package complet cible Delphi et C++Builder de XE5 à RAD Studio 13.1 Florence. Le programme d'installation de l'essai fournit actuellement des packages pour RAD Studio 11.3, 12.3 et 13.1.

Pourquoi le programme d'installation ne liste-t-il que certaines versions de l'IDE ?

La page IDE liste les installations prises en charge de RAD Studio détectées sur la machine actuelle. Si un IDE pris en charge n'est pas listé, vérifiez que RAD Studio est installé et que le programme d'installation s'exécute sous le même profil utilisateur Windows qui possède les paramètres de l'IDE.

Où apparaissent les composants au moment de la conception ?

Le programme d'installation enregistre un onglet de palette d'outils nommé losLab. Les composants visuels sont DataToXLS et GridToXLS.

Pourquoi les packages ou démos C++Builder manquent-ils après l'installation ?

Les fichiers de packages C++Builder et les projets de démo sont un contenu d'installation optionnel. Sélectionnez la case correspondante de l'IDE C++Builder lors de l'installation lorsque vous avez besoin de l'intégration ou des démos C++Builder.

Win32 et Win64 sont-ils pris en charge ?

Oui. HotXLS fournit des packages de sortie standard Win32 et Win64 pour les versions prises en charge de l'IDE. Le programme d'installation peut enregistrer les chemins de bibliothèque Win64x pour les reconstructions à partir des sources, mais les packages Win64x précompilés ne sont pas encore fournis.

Ai-je besoin de Microsoft Excel installé ?

Non. HotXLS lit, écrit, stylise et exporte directement les classeurs. Il ne requiert pas Microsoft Excel, l'automatisation Office, l'automatisation COM ni un processus externe de feuille de calcul.

Version d'essai

La version d'essai est compatible sur le plan de l'API avec la version complète, mais elle impose des limites de taille de classeur silencieuses.

Quelles limites la version d'essai applique-t-elle ?

Par classeur, l'essai autorise jusqu'à 5 feuilles de calcul, 100 lignes par feuille et 26 colonnes par feuille. Les mêmes limites s'appliquent à la façade XLS et à la façade XLSX.

Pourquoi ma sortie d'essai s'arrête-t-elle après la colonne Z ou la ligne 100 ?

Les écritures au-delà des limites d'essai sont acceptées par l'API mais supprimées du fichier enregistré. La version complète supprime ces limites sans nécessiter de modification du code source.

L'essai va-t-il tronquer les fichiers que j'ouvre ?

Non. L'ouverture d'un classeur existant comportant plus de 5 feuilles ou plus de 100 lignes et 26 colonnes ne tronque pas le fichier. Les limites s'appliquent aux ajouts de feuilles initiés par l'utilisateur et aux écritures de cellules après la création du classeur.

L'essai affiche-t-il des avertissements lorsqu'une limite est atteinte ?

Non. Les limites sont silencieuses : aucune boîte de dialogue, ligne de journal ni exception n'est émise lorsqu'une écriture dépasse la limite d'essai.

Choix De L'API

HotXLS maintient séparées l'API XLS classique et l'API XLSX moderne afin que les projets existants puissent évoluer à leur propre rythme.

Dois-je utiliser lxHandle ou lxHandleX ?

Utilisez lxHandle pour les flux de travail XLS classiques Excel 97-2003 et le code de rapports hérité. Utilisez lxHandleX et TXLSXWorkbook pour les fichiers XLSX Excel 2007+ et les fonctionnalités spécifiques à OOXML.

Un projet peut-il utiliser les deux façades ?

Oui. Les applications peuvent inclure les deux unités et conserver des objets de classeur distincts pour chaque format de fichier. Cela est utile lors de la maintenance d'une sortie XLS ancienne tout en ajoutant de nouveaux rapports XLSX.

Pourquoi certaines fonctionnalités XLSX ne sont-elles pas disponibles via l'ancienne API XLS ?

XLS et XLSX ont des modèles de fichier différents. Les concepts propres au XLSX, tels que les chaînes partagées, les styles OOXML, les tables, les feuilles de graphiques et les relations de package, vivent dans lxHandleX plutôt que d'être rétro-adaptés sur la façade XLS classique.

Où dois-je commencer avec un exemple de code ?

Commencez par les démos QuickStart et ApiTour sous les dossiers de démo Delphi ou C++Builder. Pour du code spécifique au XLSX, utilisez la présentation de la façade XLSX et les démos d'export XLSX.

Fonctionnalités Et Limites Du XLSX

La façade XLSX couvre les besoins courants de génération de rapports et documente les fonctionnalités volontairement réservées.

Quelles fonctionnalités XLSX sont prises en charge ?

TXLSXWorkbook prend en charge les valeurs, les formules, le calcul explicite des formules, les styles, les formats de nombre personnalisés, les largeurs et hauteurs, les cellules fusionnées, l'export HTML au niveau d'une plage, les hyperliens, les commentaires, les images, la mise en forme conditionnelle, la validation des données, les filtres, les tables, les graphiques, le texte enrichi, les propriétés de document, la visibilité des feuilles, les paramètres de page, l'enregistrement chiffré AES et l'ouverture/enregistrement par flux.

Puis-je enregistrer ou ouvrir des fichiers XLSX à partir de flux ?

Oui. La façade XLSX prend en charge SaveAs(Stream) et Open(Stream), adaptés aux tampons mémoire, aux champs BLOB de base de données, aux réponses HTTP et aux autres chemins de stockage non-fichier.

Comment gérer les grands exports XLSX ?

Utilisez la façade XLSX et activez Workbook.StreamingWrite lorsque le rapport est généré feuille par feuille. Les écritures en flux réduisent la pression mémoire du classeur lors de l'enregistrement.

HotXLS peut-il ouvrir ou enregistrer des archives XLSX chiffrées par mot de passe ?

TXLSXWorkbook.SaveAsEncrypted peut écrire un conteneur XLSX protégé par AES ECMA-376 lorsque vous fournissez un mot de passe non vide. OpenEncrypted peut basculer vers l'Open ordinaire pour les packages non chiffrés, mais il lève toujours EXlsxEncryptionNotImplemented pour les packages chiffrés tant que le support du déchiffrement n'est pas disponible. La protection de la feuille de calcul et du classeur restent des fonctions de verrouillage distinctes de type Excel.

Puis-je conserver les macros ?

La façade XLSX peut conserver une charge utile vbaProject.bin octet pour octet à travers le classeur et exposer une vue ParsedVBAProject analysée en lecture seule pour un stockage VBA valide. Elle ne compile ni n'exécute le code VBA.

Les formules calculent-elles dans HotXLS ?

HotXLS écrit le texte des formules dans les classeurs enregistrés, et les applications de feuille de calcul peuvent recalculer ces cellules à l'ouverture du fichier. Pour une évaluation explicite en processus, les façades XLS classique et XLSX exposent toutes deux Calculate ; affectez OnUserFunction lorsque des fonctions de feuille de calcul personnalisées ou non prises en charge doivent être gérées par le code de l'application.

Export, Déploiement Et Licence

Ces réponses couvrent les formats de sortie, les attentes de déploiement et les questions de licence habituellement posées avant la livraison d'une application.

HotXLS peut-il exporter des formats autres que XLS ou XLSX ?

Oui. HotXLS inclut des aides d'export pour des formats tels que CSV, TSV, HTML et RTF. Utilisez la façade qui correspond à votre format de classeur et choisissez la méthode d'export requise par votre flux de travail.

Puis-je utiliser HotXLS dans des services ou des outils par lots ?

Oui. Comme HotXLS n'automatise pas Excel, il convient aux applications de bureau, aux services, aux tâches par lots, aux programmes d'installation et aux utilitaires côté serveur où l'automatisation Office serait fragile ou indisponible.

Y a-t-il des redevances à l'exécution ?

Non. HotXLS ne requiert pas de redevances à l'exécution. Vous avez besoin de licences développeur pour les développeurs qui créent des applications avec la bibliothèque.