よくある質問

HotXLS ユーザーが最初に直面する問題への実践的な回答

このページでは、HotXLS のインストール、XLS ファサードと XLSX ファサードの選択、評価版の評価、レポートのエクスポート、Delphi または C++Builder アプリケーションの展開時に最も発生しやすい質問をまとめています

ネイティブライブラリ ワークブックは Delphi または C++Builder のプロセス内で生成されます
XLS と XLSX 個別のファサードにより、XLSX が独立して成長する間、従来の XLS コードは安定した状態を保ちます
インストーラー優先 通常のセットアップにはインストーラーを使用してください。サポートされている RAD Studio のバージョンが検出されます
ランタイムロイヤリティなし コピーごとのランタイム料金なしでアプリケーションを展開できます

インストールと IDE の設定

セットアップに関する質問のほとんどは、IDE の検出、サポートされているバージョン、およびオプションの C++Builder コンテンツに関するものです

サポートされている Delphi と C++Builder のバージョンは何ですか?

完全版パッケージは、XE5 から RAD Studio 13.1 Florence までの Delphi と C++Builder を対象としています。評価版インストーラーでは現在、RAD Studio 11.3、12.3、13.1 用のパッケージが提供されています

インストーラーに一部の IDE バージョンしか表示されないのはなぜですか?

IDE ページには、現在のマシンで検出されたサポート対象の RAD Studio インストールが一覧表示されます。サポートされている IDE が一覧にない場合は、RAD Studio がインストールされていること、およびインストーラーが IDE 設定を所有する同じ Windows ユーザープロファイルで実行されていることを確認してください

設計時コンポーネントはどこに表示されますか?

インストーラーは losLab という名前のツールパレットタブを登録します。ビジュアルコンポーネントは DataToXLS と GridToXLS です

セットアップ後に C++Builder パッケージやデモが表示されないのはなぜですか?

C++Builder パッケージファイルとデモプロジェクトはオプションのインストーラーコンテンツです。C++Builder の統合やデモが必要な場合は、セットアップ時に一致する C++Builder IDE チェックボックスを選択してください

Win32 と Win64 はサポートされていますか?

はい、HotXLS にはサポートされている IDE バージョン用の標準の Win32 および Win64 パッケージ出力が付属しています。インストーラーはソースの再構築用に Win64x ライブラリパスを登録する場合がありますが、ビルド済みの Win64x パッケージは現在提供されていません

Microsoft Excel をインストールする必要がありますか?

いいえ、HotXLS はワークブックを直接読み取り、書き込み、スタイル設定、エクスポートします。Microsoft Excel、Office 自動化、COM 自動化、または外部のスプレッドシートプロセスは必要ありません

評価版ビルド

評価版ビルドは完全版と API 互換性がありますが、ワークブックのサイズに暗黙的な制限があります

評価版にはどのような制限がありますか?

ワークブックごとに、評価版では最大 5 ワークシート、ワークシートごとに 100 行、ワークシートごとに 26 列が許可されます。同じ制限が XLS ファサードと XLSX ファサードに適用されます

評価版の出力が Z 列または 100 行目で停止するのはなぜですか?

評価版の制限を超える書き込みは API によって受け入れられますが、保存されたファイルからは削除されます。完全版では、ソースコードを変更しなくてもこれらの制限が解除されます

評価版では開いたファイルが切り捨てられますか?

いいえ、5 シート以上、または 100 行と 26 列を超える既存のワークブックを開いても、ファイルは切り捨てられません。制限は、ワークブックが作成された後のユーザー主導のシート追加とセルの書き込みに適用されます

制限に達したときに評価版は警告を表示しますか?

いいえ、制限は暗黙的です。書き込みが評価版の制限を超えた場合でも、ダイアログ、ログ行、または例外は出力されません

API の選択

HotXLS は、既存のプロジェクトが独自のペースで移行できるように、クラシック XLS API と最新の XLSX API を分離しています

lxHandle と lxHandleX のどちらを使用する必要がありますか?

クラシックな Excel 97-2003 XLS ワークフローおよび従来のレポートコードには lxHandle を使用します。Excel 2007 以降の XLSX ファイルおよび OOXML 固有の機能には lxHandleX と TXLSXWorkbook を使用します

1 つのプロジェクトで両方のファサードを使用できますか?

はい、アプリケーションには両方のユニットを含めることができ、ファイル形式ごとに個別のワークブックオブジェクトを保持できます。これは、新しい XLSX レポートを追加しながら古い XLS 出力を維持する場合に便利です

一部の XLSX 機能が古い XLS API 経由で利用できないのはなぜですか?

XLS と XLSX ではファイルモデルが異なります。共有文字列、OOXML スタイル、テーブル、グラフシート、パッケージの関連付けなどの XLSX 固有の概念は、クラシック XLS ファサードに後付けされるのではなく、lxHandleX に存在します

サンプルコードはどこから始めればよいですか?

Delphi または C++Builder のデモフォルダにある QuickStart および ApiTour デモから始めます。XLSX 固有のコードについては、XLSX ファサードの概要と XLSX エクスポートのデモを使用してください

XLSX の機能と制限

XLSX ファサードは一般的なレポート生成のニーズをカバーし、意図的に予約されている機能を文書化しています

サポートされている XLSX 機能は何ですか?

TXLSXWorkbook は、値、数式、明示的な数式計算、スタイル、カスタム数値形式、幅と高さ、結合されたセル、範囲レベルの HTML エクスポート、ハイパーリンク、コメント、画像、条件付き書式、データ検証、フィルター、テーブル、グラフ、リッチテキスト、ドキュメントのプロパティ、シートの表示、ページ設定、AES 暗号化保存、ストリームベースの開く/保存をサポートしています

ストリームから XLSX ファイルを保存または開くことはできますか?

はい、XLSX ファサードは SaveAs(Stream) と Open(Stream) をサポートしており、これらはメモリバッファー、データベース BLOB フィールド、HTTP 応答、およびその他のファイル以外のストレージパスに適しています

大規模な XLSX エクスポートはどのように処理する必要がありますか?

レポートがシートごとに生成される場合は、XLSX ファサードを使用し、Workbook.StreamingWrite を有効にします。ストリーミング書き込みにより、保存中のワークブックのメモリ圧迫が軽減されます

HotXLS はパスワードで暗号化された XLSX アーカイブを開いたり保存したりできますか?

TXLSXWorkbook.SaveAsEncrypted は、空ではないパスワードを指定した場合、ECMA-376 AES で保護された XLSX コンテナーを書き込むことができます。OpenEncrypted は暗号化されていないパッケージの通常の Open にフォールバックできますが、暗号化解除のサポートが追加されるまでは、暗号化されたパッケージに対して EXlsxEncryptionNotImplemented が発生します。ワークシートとワークブックの保護は、Excel スタイルの個別のロック機能のままです

マクロを保持できますか?

XLSX ファサードは、ワークブックを通じて vbaProject.bin ペイロードをバイト単位で保持し、有効な VBA ストレージ用に解析済みの読み取り専用の ParsedVBAProject ビューを公開できます。VBA コードのコンパイルや実行は行いません

数式は HotXLS 内で計算されますか?

HotXLS は数式テキストを保存されたワークブックに書き込み、スプレッドシートアプリケーションはファイルが開いたときにそれらのセルを再計算できます。明示的なプロセス内評価の場合、クラシック XLS ファサードと XLSX ファサードの両方が Calculate を公開します。カスタムまたはサポートされていないワークシート関数をアプリケーションコードで処理する必要がある場合は、OnUserFunction を割り当てます

エクスポート、展開、およびライセンス

これらの回答は、出力形式、展開の期待値、およびアプリケーションをリリースする前によく尋ねられるライセンスに関する質問をカバーしています

HotXLS は XLS または XLSX 以外の形式をエクスポートできますか?

はい、HotXLS には CSV、TSV、HTML、RTF などの形式のエクスポートヘルパーが含まれています。ワークブックの形式に一致するファサードを使用し、ワークフローで必要なエクスポートメソッドを選択します

サービスやバッチツールで HotXLS を使用できますか?

はい、HotXLS は Excel を自動化しないため、Office の自動化が脆弱または使用できないデスクトップアプリケーション、サービス、バッチジョブ、インストーラー、サーバーサイドユーティリティに適しています

ランタイムロイヤリティはありますか?

いいえ、HotXLS にはランタイムロイヤリティは必要ありません。ライブラリを使用してアプリケーションを構築する開発者には、開発者ライセンスが必要です