HotXLS リリースノート

HotXLS のユーザー向け機能、修正、XLS/XLSX 強化、エクスポート更新、互換性変更、ドキュメント更新のバージョン履歴です。

言語： English (US)English (UK) Español (España) Español (Latinoamérica) Deutsch Français Italiano 日本語 Português Nederlands Svenska Polski Türkçe 한국어 العربية Русский 简体中文繁體中文

[Unreleased]

バージョン 2.88.111

Classic XLS ワークシートで独立した描画 TextBox を作成できるようになりました。 TXLSShapes.AddTextBox を使うと、独自の行/列アンカー、テキスト、text runs、線/塗りつぶし書式、通常の shape 削除を備えた TXLSTextBox を、セルコメントを作成せずに追加できます。

バージョン 2.88.110

ApiTour デモで、より多くの workbook automation パターンを確認できるようになりました。 Delphi と C++Builder の ApiTour サンプルは、WriteCells による callback ベースの範囲書き込み、ForEachCell による読み込み済みセルの走査、FindText と ReplaceText によるテンプレート更新、選択範囲を ApiTour-Range.html へ HTML エクスポートする流れ、Delphi の OnUserFunction によるカスタム数式 callback を示します。

バージョン 2.88.109

QuickStart デモで、より完成度の高い最初のブックを確認できるようになりました。 Delphi と C++Builder の QuickStart サンプルは、行合計と列合計の数式、固定ペイン、一致した XLS/XLSX 操作を含む書式付き掛け算表を作成します。デモツリーには各サンプル用の見やすい HTML readme ページも追加されました。

バージョン 2.88.108

XLSX 範囲に直接 HTML エクスポート helper が追加されました。 TXLSXRange.SaveAsHTML(FileName) と TXLSXRange.SaveAsHTML(Stream) は、選択した XLSX 範囲だけを UTF-8 HTML テーブルとしてエクスポートし、workbook HTML renderer のエスケープ、基本スタイル出力、結合セル span 処理を共有します。

バージョン 2.88.107

XLSX ワークシートにテキスト検索と置換の helper が追加されました。 TXLSXWorksheet.FindText と TXLSXWorksheet.ReplaceText は、読み込まれたテキストセルを row-major 順に走査し、数式と非テキスト値をスキップし、テンプレートワークフロー向けに任意の大文字小文字区別マッチをサポートします。

バージョン 2.88.106

BIFF8 Window2 view flags が、カスタムグリッド線色と frozen-pane 状態を保持するようになりました。 Window2.icvHdr がカスタムグリッド線色を保存する場合、HotXLS は fDefaultHdr をクリアし、open/save 中に Excel が書いた fFrozenNoSplit を保持し、FreezePanes 出力に fFrozenNoSplit を書き込みます。

バージョン 2.88.105

CF12 formula thresholds が BIFF8 Data Bar、Color Scale、Icon Set ルールで round-trip できるようになりました。 数式ベースの threshold values は保存時に CF12 formula token bytes にコンパイルされ、workbook を再度開いたときに TXLSCfValue.Value へ復元されます。

バージョン 2.88.104

Classic XLS の数式とアイコンセットしきい値が、よりコンパクトな BIFF8 レコードを出力するようになりました。 数式内の整数定数は BIFF unsigned-integer 範囲に収まる場合にコンパクトな tInt token を使用し、TXLSIconSetSpec.ThresholdEqualsInclude[Index] が CF12 icon-set threshold equals byte を制御するため、呼び出し側は include または exclude の比較セマンティクスを選択できます。

バージョン 2.88.103

Classic XLS worksheet にテキスト検索ヘルパーが追加されました。IXLSWorksheet.FindText(SearchText, Row, Col[, MatchCase]) は最初に一致する読み込み済みテキストセルを特定し、数式セルと非テキストセルをスキップし、一致がない場合は返却座標をクリアします。

バージョン 2.88.102

Classic XLS worksheet にテキスト置換ヘルパーが追加されました。IXLSWorksheet.ReplaceText(SearchText, ReplacementText[, MatchCase]) は読み込み済みのテキストセル内の一致を置換し、数式セルと非テキストセルをスキップし、テンプレート入力ワークフロー向けに変更されたセル数を返します。

バージョン 2.88.101

Range に直接 HTML エクスポート用ヘルパーが追加されました。IXLSRange.SaveAsHTML(FileName) と IXLSRange.SaveAsHTML(Stream) は既存の HTML レンダラーを使って選択範囲を出力するため、一般的な range fragment の出力で TXLSHTMLExport インスタンスを作成したり xlHTML を明示的に渡したりする必要がなくなりました。

バージョン 2.88.100

TXLSWorkbook.GetSheetNames(Stream, AList) が Classic XLS ストリームに加えて XLSX package ストリームも読み取るようになりました。アプリケーションはメモリストリーム、データベース BLOB ストリーム、ダウンロード済み XLSX ストリームを classic facade に渡し、先にファイルへ保存せずにワークシート名を順序どおり取得できます。

バージョン 2.88.99

ワークシート検索、ハイパーリンク作成、複数範囲選択の API が使いやすくなりました。Classic XLS と XLSX のシートコレクションに TryGetSheetByName を追加し、Classic XLS ワークシートに AddHyperlink の便利なオーバーロードを追加し、IXLSWorksheet.SelectAreas でアクティブな複数範囲選択を書き込めます。

バージョン 2.88.98

Classic XLS ワークブックで saved-by フィールドの UserName エイリアスを公開しました。IXLSWorkbook.UserName は LastSavedBy と同じ WRITEACCESS 値に対応するため、UserName 命名規則を使うコードからワークブックの監査名を直接読み書きできます。

バージョン 2.88.97

XLSX ワークシートでも callback セルスキャンと範囲書き込み helper を共有できるようになりました。TXLSXWorksheet.ForEachCell は読み込まれたセルを行順に、値と数式テキスト付きで列挙し、TXLSXWorksheet.WriteCells は数値範囲または A1-style 範囲を callback から埋め、セル単位のスキップとキャンセルに対応します。

バージョン 2.88.96

Classic XLS ワークシートで callback 駆動の範囲書き込みをサポートしました。IXLSWorksheet.WriteCells は 1-based の数値範囲または A1-style 範囲を行順に埋め、callback が各セル値を提供し、セル単位のスキップと長い書き込みループの早期キャンセルに対応します。

バージョン 2.88.95

Classic XLS ワークシートで、読み込まれたセルを callback で列挙できるようになりました。IXLSWorksheet.ForEachCell は既存のワークシートセルを行順に走査し、1-based のシート、行、列座標、値、数式テキストを渡し、callback から長いスキャンを早期にキャンセルできます。

バージョン 2.88.94

数式計算からアプリケーション定義関数を呼び出せるようになりました。TXLSWorkbook.OnUserFunction と TXLSXWorkbook.OnUserFunction により、Calculate はカスタム関数または未対応のワークシート関数をアプリケーションコードへ委譲し、評価済み引数を渡し、処理済みの場合は返された Variant 結果を使用します。

バージョン 2.88.93

Classic XLS ワークシート保護で操作別の権限フラグを公開しました。IXLSWorksheet に AllowDeleteRows、AllowInsertRows、AllowFormatCells、AllowSort、AllowAutoFilter と残りの SheetProtect 権限プロパティを追加し、BIFF8 オプションを既存の保護レコードで書き込み、読み戻します。

バージョン 2.88.92

Classic XLS VBA payload に明示的な load/save/clear helper が追加されました。IXLSWorkbook.LoadVBAProjectFromFile、SaveVBAProjectToFile、HasVBAProject、ClearVBAProject は保持された OLE VBA storage payload を公開し、VBAProject は解析済みの読み取り専用モジュールビューのままです。

バージョン 2.88.91

Classic XLS AutoFilter 条件をフィールド collection から検査できるようになりました。IXLSWorksheet.AutoFilterColumns は、現在の BIFF8 AutoFilter フィールド数と 1-based フィールド項目を公開し、active state、operator、保存された Criteria1 / Criteria2 DOPER 値を確認できます。

バージョン 2.88.90

Classic XLS worksheets で AutoFilter 条件を 1 回の呼び出しで設定できるようになりました。IXLSWorksheet.ApplyAutoFilter は worksheet AutoFilter 範囲の設定とフィールド条件の書き込みを同じ呼び出しで行い、A1-style と 1-based 数値範囲の overload、および任意の 2 条件 operator をサポートします。

バージョン 2.88.89

Classic XLS shapes をセル範囲で削除できるようになりました。TXLSShapes.DeleteInRange は、OfficeArt client anchors が 1-based のワークシート範囲と交差する固定画像または shapes を削除し、削除した shapes の数を返します。

バージョン 2.88.88

Classic HTML export の table layout attributes を設定できるようになりました。 TXLSHTMLExport.TableBorderWidth、CellPadding、CellSpacing は styled と simple HTML output の両方で生成される <table> attributes を制御し、既定値は従来どおり 0 です。

バージョン 2.88.87

Classic HTML export が minimal table output に対応しました。 TXLSHTMLExport.SimpleExport は生成 CSS classes、hyperlink anchors、comment title attributes を含まない plain HTML table を出力しつつ、escape 済み display text と merged-cell spans を保持します。

バージョン 2.88.86

Classic HTML export で document title を書き込めるようになりました。 TXLSHTMLExport.Title は生成される style block の前に escape 済みの HTML <title> element を出力します。既定の空値では従来の出力を変更しません。

バージョン 2.88.85

Classic HTML export で cell comments を tooltip として保持できるようになりました。 TXLSHTMLExport.Options は既定で xhComments を含み、cell comment text を escape 済みの title attribute として出力します。呼び出し側はこの option を外して plain cell output にできます。

バージョン 2.88.84

Classic HTML export の hyperlink 出力を設定できるようになりました。 TXLSHTMLExport.Options は既存動作のため既定で [xhHyperlinks] になり、呼び出し側は xhHyperlinks を外して link 付き cell を plain escaped text として export できます。

バージョン 2.88.83

Classic HTML export で cell hyperlink を保持できるようになりました。 SaveAsHTML は link 付き cell を HTML anchor tag で包み、hyperlink address を escape 済みの href として出力し、ScreenTip text を escape 済みの title attribute として保持し、表示 cell text も link 内で escape したままにします。

バージョン 2.88.82

Classic XLS workbook で saved-by ユーザー名を制御できるようになりました。 IXLSWorkbook.LastSavedBy は WRITEACCESS の saved-by フィールドを公開し、生成または編集された workbook が明示的な監査名を保存できるようにします。未編集のソース workbook は引き続き元の metadata を保持します。

バージョン 2.88.81

Classic XLS ワークシートで、表示グリッド線のカラーインデックスを制御できるようになりました。IXLSWorksheet.GridlineColorIndex は Window2 icvHdr フィールドを公開し、保存したワークシートを指定したグリッド線色で再度開けるようにします。グリッド線の表示状態や印刷グリッド線設定は変更しません。

バージョン 2.88.80

Classic XLS workbook で active sheet をインデックス指定できるようになりました。IXLSWorkbook.ActiveSheetIndex は WINDOW1 active sheet フィールドに基づく 1-based active-tab プロパティを公開し、保存済み workbook を指定した worksheet で再オープンできます。first visible tab は変更しません。

バージョン 2.88.79

Classic XLS worksheet outline で automatic outline styles を制御できるようになりました。TXLSOutline.ApplyStyles は WSBool の outline style フラグを公開し、保存済み worksheet で Excel outline style application を保持または明示的に有効化できます。outline levels や summary placement は変更しません。

バージョン 2.88.78

Classic XLS page setup で automatic page breaks を制御できるようになりました。IXLSPageSetup.AutoPageBreaks は worksheet WSBool の automatic page-break フラグを公開し、保存済み worksheet で automatic page breaks を有効のままにするか、manual page breaks を保持したまま明示的に無効化できます。

バージョン 2.88.77

Classic XLS workbook で AutoFilter の日付グループ化を制御できるようになりました。IXLSWorkbook.AutoFilterDateGrouping は Window1 の date-grouping フラグを正方向の Boolean API として公開し、保存済み workbook で Excel の日付フィルターグループ化を有効のままにするか、明示的に無効化できます。

バージョン 2.88.76

Classic XLS workbook で workbook window の位置とサイズを直接設定できるようになりました。IXLSWorkbook.XWindow、YWindow、WindowWidth、WindowHeight は Window1 geometry フィールドを公開し、保存された workbook を指定した window rectangle で再度開けます。

バージョン 2.88.75

Classic XLS workbook で workbook window の hidden 状態を直接保存できるようになりました。IXLSWorkbook.WindowHidden は Window1 の hidden フラグに対応し、worksheet の表示状態を変更せずに、保存された workbook を workbook window hidden の状態で再度開けます。

バージョン 2.88.74

Classic XLS workbook で workbook window の minimized 状態を直接保存できるようになりました。IXLSWorkbook.Minimized は Window1 の minimized フラグに対応し、保存された workbook を workbook window が minimized の状態で再度開けます。

バージョン 2.88.73

Classic XLS workbook で垂直スクロールバーを直接非表示または表示できるようになりました。IXLSWorkbook.ShowVerticalScroll は Window1 fDspVScroll フラグに対応し、保存された workbook を垂直スクロールバーが非表示または表示された状態で開けます。

バージョン 2.88.72

Classic XLS workbook で水平スクロールバーを直接非表示または表示できるようになりました。IXLSWorkbook.ShowHorizontalScroll は Window1 fDspHScroll フラグに対応し、保存された workbook を水平スクロールバーが非表示または表示された状態で開けます。

バージョン 2.88.71

Classic XLS workbook で sheet tab bar を直接非表示または表示できるようになりました。IXLSWorkbook.ShowSheetTabs は Window1 fDspTabs フラグに対応し、worksheet の表示状態を変更せずに、保存された workbook を sheet tabs が非表示または表示された状態で開けます。

バージョン 2.88.70

Classic XLS workbook で workbook tab bar の比率を直接設定できるようになりました。IXLSWorkbook.TabRatio は Window1 wTabRatio 値を公開し、sheet tabs 用に確保する領域と水平スクロールバーの比率を呼び出し側が調整できます。

バージョン 2.88.69

Classic XLS workbook で最初に表示される sheet tab を直接設定できるようになりました。IXLSWorkbook.FirstSheet は Window1 itabFirst 値を 1-based プロパティとして公開し、Excel が workbook を開いたとき左端に表示される sheet tab を呼び出し側が選択できます。

バージョン 2.88.68

Classic XLS worksheet で outline symbols の表示状態を保持および設定できるようになりました。IXLSWorksheet.DisplayOutlineSymbols は BIFF WINDOW2 fDspGuts フラグに対応し、保存された sheets がウィンドウ表示で outline と grouping の記号を非表示にできます。

バージョン 2.88.67

Classic XLS worksheet で行見出しと列見出しの表示状態を保持および設定できるようになりました。IXLSWorksheet.DisplayHeadings は BIFF WINDOW2 fDspRwCol フラグに対応し、保存された sheets がウィンドウ表示で行番号と列文字を非表示にできます。

バージョン 2.88.66

Classic XLS worksheet で数式表示ビューを保持および設定できるようになりました。IXLSWorksheet.DisplayFormulas は BIFF WINDOW2 fDspFmla フラグに対応し、Excel が計算結果ではなく数式テキストを表示して sheet を開けるようにします。

バージョン 2.88.65

Classic XLS worksheet で Normal view のズームを独立して設定できるようになりました。IXLSWorksheet.NormalViewZoom はキャッシュされた WINDOW2 Normal zoom を公開し、sheet が Page Break Preview の間でも呼び出し元は異なるズーム値を保存できます。

バージョン 2.88.64

Classic XLS worksheet で Page Break Preview のズームを直接設定できるようになりました。IXLSWorksheet.PageBreakPreviewZoom はキャッシュされた WINDOW2 preview zoom を公開し、呼び出し元は Normal と Page Break Preview で異なるズーム値を保存できます。

バージョン 2.88.63

Classic XLS worksheet に分割ウィンドウヘルパーが追加されました。IXLSWorksheet.SplitPanes(Width, Height) は既存の BIFF pane writer を使って移動可能な分割を作成し、UnsplitPanes は保存前に pane record を消去します。

バージョン 2.88.62

Classic XLS worksheet に、より簡単なウィンドウ枠固定ヘルパーが追加されました。IXLSWorksheet.FreezePanes(Cols, Rows) は指定した左側列と上部行を固定し、UnfreezePanes は保存前に pane record を削除します。

バージョン 2.88.61

Classic XLS の sheet 名検出がストリームを受け取れるようになりました。TXLSWorkbook.GetSheetNames(Stream, List) は、呼び出し元が渡した XLS stream から BIFF sheet 名を読み取り、worksheet 内容を読み込まないため、メモリ上の workbook データでもファイル名ヘルパーと同じ使い方ができます。

バージョン 2.88.60

Worksheet collection に名前で直接検索するヘルパーが追加されました。IXLSWorkSheets.SheetByName(Name) と TXLSXSheets.SheetByName(Name) は一致する worksheet オブジェクトまたは nil を返すため、sheet にアクセスする前に index を解決する必要がなくなりました。

バージョン 2.88.59

XLSX facade はストリームから sheet 名を直接読み取れるようになりました。TXLSXWorkbook.GetSheetNames(Stream, List) は worksheet XML を読み込まずに xl/workbook.xml から順序付きの名前を読み取り、メモリ内または BLOB ベースのブックでもファイル名オーバーロードと同じ用途に使えます。

バージョン 2.88.58

XLSX facade でシート名をすばやく取得できるようになりました。TXLSXWorkbook.GetSheetNames(FileName, List) は worksheet XML を読み込まずに、xl/workbook.xml から順序付きの名前を読み取ります。

バージョン 2.88.57

TXLSWorkbook.GetSheetNames が XLSX パッケージに対応しました。このメソッドは .xlsx、.xlsm、.xltx、.xltm ファイルから xl/workbook.xml を読み取り、worksheet XML を読み込まずに順序付きのシート名を返します。

バージョン 2.88.56

クラシック XLS ワークブックで、ワークシートを読み込まずにシート名を取得できるようになりました。TXLSWorkbook.GetSheetNames(FileName, List) は workbook globals stream をスキャンし、Excel 97-2003 .xls ファイルから順序付きのシート名を返します。

バージョン 2.88.55

クラシック XLS range の AutoFilter 条件が BIFF8 フィルター record を書き出すようになりました。TXLSRange.Autofilter(Field, Criteria) は必要に応じてフィルター範囲を作成し、単純な文字列、数値、Boolean、空白、非空白、比較プレフィックス付き条件の AUTOFILTER 条件を出力します。

バージョン 2.88.54

従来の XLS worksheet に worksheet レベルの AutoFilter ヘルパーが追加されました。 IXLSWorksheet.SetAutoFilter、ClearAutoFilter、AutoFilterRange は、既存の AUTOFILTERINFO とフィルターデータベース名の書き込みを再利用しながら、BIFF8 のフィルタードロップダウン範囲を直接管理します。

バージョン 2.88.53

従来の XLS worksheet でリストデータ検証を作成できるようになりました。 IXLSWorksheet.AddListValidation(Range, Items) は BIFF8 DVAL と DV レコードを書き込み、既定でドロップダウンを表示したままにし、カンマ区切りのインラインリストをサポートし、Open / SaveAs の往復後もルールを保持します。

バージョン 2.88.52

数式計算が XLS と XLSX のエントリポイント全体で一貫して動作するようになりました。 TXLSWorkbook.Calculate は、=SUM(A1:B1)+C1 のような Excel 形式の先頭に等号が付いた数式を受け入れるようになりました。また、XLSX ファサードには TXLSXWorkbook.Calculate と TXLSXWorksheet.Calculate が追加されました。XLSX パスでは、セル参照と範囲参照、数式から参照されるセル、シート間参照、ブックまたはシートのスコープを持つ定義名範囲に対して、HotXLS の数式トークンパーサーと評価器を共有します。

バージョン 2.88.51

XLSX range が Excel 形式の merge across をサポートしました。 TXLSXRange.Merge(True) は行ごとに 1 つの <mergeCell> エントリを書き出し、従来の XLS Range.Merge(True) と同じ動作になります。引数なしの Merge と Merge(False) は引き続き range 全体を 1 つの結合矩形として作成します。

バージョン 2.88.50

BIFF8 HeaderFooter と HFPicture の配置が現在の MS-XLS ルールに一致しました。 HotXLS は、Excel が書き込んだ偶数ページ / 先頭ページ用のヘッダー・フッターテキストを含む HeaderFooter ($089C) レコードを保持し、worksheet ABNF に従って worksheet dimensions と drawing objects の後に HFPicture ($0866) レコードを再出力するため、.xls の開く/保存 round-trip でページレイアウトの詳細が失われません。

バージョン 2.88.49

コメントのリッチテキスト run を typed API で扱えるようになりました。 TXLSComment.TextRuns が BIFF8 TXO の FormatRun エントリを公開し、呼び出し側は .xls コメント内の文字単位のフォント境界を確認または設定できます。HotXLS は安全な round-trip のため、基になる run バイトも引き続き保持します。

バージョン 2.88.48

ピボットテーブルの supplemental SX records が typed API から参照できるようになりました。 HotXLS は、読み込んだ BIFF8 pivot records（SXIVD、SXLI、SXFormat、SXEx、SXVDEx、SXRule、SXFilt、SXAddl など）を TXLSPivotTable.SupplementalRecords に関連付けて検査可能にしつつ、保存時のラウンドトリップでは元の raw bytes を引き続き保持します。

バージョン 2.88.47

外部ブックの cached values が .xls の open/save ラウンドトリップで保持されるようになりました。 HotXLS は、読み込んだ SUPBOOK エントリに付随する BIFF8 XCT および CRN レコードを保持するため、外部ブックリンクの cached cell values が保存時に失われなくなりました。

バージョン 2.88.46

組み込みスタイルの outline level が .xls の open/save ラウンドトリップで保持されるようになりました。 HotXLS は、組み込みスタイルの BIFF8 STYLE iLevel バイトを読み取って保持するため、Excel の RowLevel_1..7 と ColLevel_1..7 スタイルメタデータが保存時に既定値へリセットされなくなりました。

バージョン 2.88.45

定義名メタデータが .xls の open/save ラウンドトリップで保持されるようになりました。 HotXLS は、定義名が編集されていない限り、読み込んだ BIFF8 NAME レコードの option bits と shortcut bytes を保持するため、Excel が書き込んだ function、object、procedure、calculated-expression、binary-name メタデータが保存時に消去されなくなりました。

バージョン 2.88.44

ObProj ブックマーカーが .xls の開く/保存ラウンドトリップ後も保持されるようになりました。 HotXLS は、オブジェクトモデルから VBA storage が公開されていない場合でも、読み込み済み BIFF8 ObProj レコードを保持するため、ブックレベルの VBA project マーカーやサードパーティメタデータが保存時に失われなくなりました。

バージョン 2.88.43

ワークシートオプションフラグが .xls の開く/保存ラウンドトリップ後も保持されるようになりました。 HotXLS は、ダイアログシート、自動改ページ、スタイル適用、アウトラインガター表示などの未モデル化 BIFF8 WSBOOL ビットを保持しつつ、既存のページに合わせる設定とアウトライン集計設定は引き続き公開 API から更新します。

バージョン 2.88.42

追加のブックメタデータレコードが .xls の開く/保存ラウンドトリップ後も保持されるようになりました。 HotXLS は、読み込み済み BIFF8 COUNTRY、BOOKBOOL、BACKUP、FNGROUPCOUNT、USESELFS、RECALCID レコード body を既定値で書き換えずに保持し、ブックレベルの互換性と計算メタデータを安定させます。

バージョン 2.88.41

複数範囲の選択とアクティブペインのフォーカスが .xls の開く/保存ラウンドトリップ後も保持されるようになりました。 HotXLS は、API でシート選択またはペインが変更されない限り、読み込み済み BIFF8 SELECTION レコードと PANES のアクティブペイン値を保持するため、Excel の分割/固定ペインのフォーカスと複数範囲選択が保存時に折りたたまれなくなりました。

バージョン 2.88.40

外部ブック名が .xls の開く/保存ラウンドトリップ後も保持されるようになりました。 HotXLS は、外部 SUPBOOK エントリに付属する読み込み済み BIFF8 EXTERNALNAME レコードを、DDE/OLE/リンクのメタデータや数式末尾を含めて保持するため、保存時に外部名とリンク定義が失われなくなりました。

バージョン 2.88.39

パスワード保護された BIFF8 .xls ファイルで RC4 CryptoAPI FILEPASS レコードを読み書きできるようになりました。 HotXLS は暗号化された .xls ワークブックに Excel 2007/2010 形式の FILEPASS vMajor=2 メタデータを書き出し、従来の RC4 vMajor=1 と RC4 CryptoAPI vMajor=2/3/4 の両方を読み取ります。これにより、パスワード保護されたワークブックがこの暗号化ヘッダーで失敗したり、古いヘッダーへ戻ったりしなくなります。

バージョン 2.88.38

Excel が書き込んだ .xls ハイパーリンクメタデータが開く/保存ラウンドトリップ後も保持されるようになりました。 HotXLS は読み込んだハイパーリンクが編集されない限り BIFF8 HLink record body を保持し、保存後も streamVersion、fIcon などの hlstmf option bits、moniker データ、関連するターゲットメタデータを安定させます。

バージョン 2.88.37

ブックのウィンドウ状態が .xls の開く/保存ラウンドトリップ後も保持されるようになりました。 HotXLS は BIFF8 WINDOW1 record のウィンドウ位置、サイズ、表示/iconic flags、最初に表示されるシートタブ、選択タブ数、タブとスクロールバーの比率を読み取り保持し、保存のたびに既定値へ書き換えなくなりました。

バージョン 2.88.36

BIFF8 WriteAccess の saved-by ユーザーが .xls の開く/保存ラウンドトリップ後も保持されるようになりました。 HotXLS は Excel が書き込んだ saved-by ユーザーを HotXLS に置き換えるのではなく、$005C WRITEACCESS record body を読み取り保持するため、保存後もブックの監査メタデータが安定します。

バージョン 2.88.35

Excel comment author が .xls の open/save round-trip 後も保持されるようになりました。 BIFF8 Note record の stAuthor field を解析して drawing note model に渡すようにし、空文字列で置き換えないため、Excel が書き込んだ comment の "Created by" author は HotXLS で再保存しても失われません。

バージョン 2.88.34

Shape の OfficeArt FOPT options が低レベル option bag から利用できるようになりました。 TXLSShape.OfficeArtOptions により、高度な呼び出し側は保存済みの任意の FOPT PID を LongWord または WideString として検査、設定、削除できます。既存の高レベル Line、Fill、色、表示 API は変更されません。

バージョン 2.88.33

OfficeArt solver-container 内の追加 rule record も round-trip 保持されるようになりました。 型付きの msofbtConnectorRule ($F012) に加えて、HotXLS は OfficeArtFArcRule ($F014) や OfficeArtFCalloutRule ($F017) などの folder ではない solver children を msofbtSolverContainer ($F005) 内の raw OfficeArt record として保持します。そのため高度な Excel drawing を保存しても、connector 以外の solver 関係が失われません。

バージョン 2.88.32

Unknown record preservation の後に OfficeArt ClientData marker が重複出力されなくなりました。 MS-XLS では OfficeArtClientData（$F011）は長さ 0 の marker であり、後続の Obj record は別個の BIFF record のままです。v2.88.32 はこの marker を unknown SpContainer leaf として捕捉せずに認識するため、parse 済み shape の保存時に $F011 marker は 1 つだけ出力されます。XLS 仕様に合わない container-style の前提は XLS path には入れません。

バージョン 2.88.31

OfficeArt のコネクタールールを round-trip できるようにしました。 Excel が作成した .xls の drawing は、コネクターの binding を msofbtSolverContainer（$F005）内の子 msofbtConnectorRule（$F012）レコードとして保存します。v2.88.31 は TMsoConnectorRules で $F005/$F012 の組み合わせを解析・出力し、save/reload の間で開始 shape、終了 shape、コネクター shape、接続サイトを保持します。以前の audit note は $F121 としていましたが、MS-ODRAW では OfficeArtFConnectorRule は $F012 です。

バージョン 2.88.30

認識されない OfficeArt SpContainer leaf レコードを round-trip できるようにしました。 Excel が作成した .xls ファイルでは、各 shape の SpContainer 内に msofbtClientTextbox ($F00D), OfficeArtFPSPL ($F11D), and OfficeArtUDefProp ($F122)などの leaf Fbt が含まれることがあります。v2.88.30 は shape-level の unknown leaf を TMsoFbtUnknown として捕捉し、ClientAnchor と末尾の zero-body msofbtClientData marker の間へ parse 順に再出力します。
範囲と後続作業。 その他の drawing-level unknown leaf は引き続き保留です。connector-rule solver-container のケースは v2.88.31 で対応済みです。msofbtClientData（$F011）が sibling marker ではなく container として使われるような container-form unknown は、audit-round Slice 3 に残ります。

バージョン 2.88.29

ComboBox と ListBox の OBJ 未知サブレコードが round-trip されるようになりました。TMSOShapeComboBox.ParseObj と TMSOShapeListBox.ParseObj は既に FtSbs ($000C)、FtSbsFmla ($000E)、FtLbsData ($0013) を typed-parse して専用フィールドに格納していましたが、CMO と FtLbsData の間に現れるその他のソースファイルサブレコード (FtMacro $0004、ObjLinkFmla、FtNts $000D 等) は case fall-through で静かに破棄されていました。v2.88.29 は v2.88.28 Picture と同じ else ブランチを追加し、未知サブレコードの 4 バイトヘッダ + 本体を FObjTailRaw にキャプチャします。両 AddObj メソッドは BIFF8 spec のサブレコード順序に合わせるため、CMO 本体と FtSbs サブレコードの間にキャプチャされたバイトを出力します。
FtLbsData の "全飲み込み" 動作がスコープを制限。既存の $0013 ケースは RecLen := Len - offs を上書きして FtLbsData ヘッダ以降のすべてのバイトを FObjRec_LBSData の blob に吸収するため、FtLbsData の後に現れるサブレコード (通常は FtEnd のみ) は依然としてそのメカニズム経由で変更なしに round-trip します。新しい FObjTailRaw 統合は、FtMacro と ObjLinkFmla が通常存在する FtLbsData 前のギャップを具体的に対象とします。Drawing API 経由で新しく作成された combo / list boxes は FObjTailRaw が空 → v2.88.28 とバイト単位で同一の出力。

バージョン 2.88.28

Picture シェイプの OBJ 未知サブレコードが round-trip されるようになりました。TMSOShapePicture.ParseObj は既に FtCf ($0007)、FtPioGrbit ($0008)、FtPictFmla ($0009) を typed-parse して専用フィールドに格納していましたが、その他のソースファイルサブレコード (FtMacro $0004、FtNts $000D 等) は case fall-through で静かに破棄されていました。v2.88.28 は else ブランチを追加し、認識されないサブレコードの完全な 4 バイトヘッダ + 本体を FObjTailRaw に追加します。TMSOShapePicture.AddObj はそれらのバイトを type 付きサブレコード出力の後、FtEnd マーカーの前に verbatim で出力します。マクロフックを持つソースファイルの picture オブジェクトは保存後も保持されます。
typed + raw 共存パターン。PictureFrame (v2.88.27) が typed と raw emit を if/else でスワップするのと異なり、Picture は両方を組み合わせます。typed フィールドが API 表面を維持し (呼び出し元は引き続き ftCfValue 等を調整可能)、raw tail は未知のバイトのみを保存します。Drawing API 経由で新しく作成された画像は FObjTailRaw が空なので、出力は v2.88.27 とバイト単位で同一です。

バージョン 2.88.27

OBJ 末尾サブレコード round-trip を PictureFrame シェイプに拡張。TMSOShapePictureFrame.AddObj は以前 CMO と FtEnd の間に legacy ハードコード FtCf ($0007、本体 $FFFF) と FtPioGrbit ($0008、本体 $0000) サブレコードのみを出力していました。新しく作成された画像フレームの場合、新しいコードは引き続きそれらのデフォルトを出力します。ソース .xls から解析された画像フレームの場合、キャプチャされた FObjTailRaw バイトが代わりに verbatim で出力され、ソースファイルの FtPictFmla / 非デフォルトの FtCf / 非デフォルトの FtPioGrbit コンテンツが保存サイクルを通じて保持されます。
調査メモ — Flush は sz を自動修正します。TMsoShapeContainer.Flush は Data.SetWord(Data.DataLength - 4, 2) を介してコミット時に Obj レコードのサイズヘッダを書き直します。つまり、HotXLS の AddObj 実装に何年も存在していたハードコードされた sz := $1A の値は結局のところ spec バグではなく — Flush がそれらを自動的に修正します。v2.88.27 はソースコードの明確性のために sz を正確に計算し続けますが、その観点からの実行時の動作は変わりません。

バージョン 2.88.26

OBJ 末尾サブレコード round-trip を Chart と CheckBox シェイプに拡張。v2.88.25 では Obj レコードの CMO ($0015) と FtEnd ($0000) マーカー間のバイトに対する生バイト保存を導入しましたが、キャプチャされた末尾を出力していたのは TMSOShapeTextBox.AddObj のみでした。このリリースでは同じパターンを TMSOShapeChart.AddObj と TMSOShapeCheckBox.AddObj に適用します — 両者は TextBox の単純な「CMO + FtEnd」出力構造を共有するため、変更は一行の変数置換 (sz := $1A + Word(Length(FObjTailRaw))) と FtEnd マーカー前のバイト単位 emit ループだけです。
Chart の末尾サブレコード (たとえば埋め込み chart オブジェクトマクロの FtMacro) およびチェックボックス状態サブレコード (FtCbls + FtCblsData + ObjLinkFmla、MS-XLS §2.5.140-141 / §2.5.149) が HotXLS の保存/再読み込みで保持されるようになりました。Drawing API 経由で新規作成された chart と checkbox はデフォルトの 26 バイト CMO+FtEnd を引き続き出力します (v2.88.25 とバイト単位で同一)、既存の呼び出し元には動作変更は見えません。Picture / ComboBox / ListBox / PictureFrame シェイプは独自の動的な型付きサブレコード出力を持ち、FObjTailRaw と競合します — それらの統合は将来のコミットに延期されます。

バージョン 2.88.25

OBJ レコードの末尾サブレコードがコメントについて保存サイクルを経ても保持されるようになりました。BIFF8 Obj レコード ($005D) は、必須の CMO ($0015) の後に型付きサブレコードの並びを連結し、FtEnd ($0000) マーカーで終端します (MS-XLS §2.4.181)。Note (コメント) シェイプの場合、末尾ブロックは通常 26 バイトの FtNts (§2.5.149) で、GUID と fSharedNote フラグを運びます — Excel が後でユーザ間でコメントを共有ワークブックでマージするときに両方とも不可欠です。HotXLS は以前 CMO の後のバイトすべてを読み込み時に破棄し、書き込み時には空の FtEnd のみを出力していたため、ソースファイルの FtNts は HotXLS の各保存後に失われていました。
ジェネリックベースでキャプチャ、TextBox のみで出力 (R5-3 第一段階)。TMsoShapeContainer.ParseObj は CMO 本体の終わりから FtEnd マーカーまでのバイト範囲を新しい内部フィールド FObjTailRaw: TBytes にキャプチャします。TMSOShapeTextBox.AddObj はそれらのバイトを CMO 出力と FtEnd マーカーの間に挿入し、Obj レコードヘッダのサイズをそれに応じて調整します。新しく作成されたコメント (ソースバイトなし) は v2.88.24 とバイト単位で同一の出力を保持します。他のシェイプクラス (Picture / CheckBox / ComboBox / ListBox / Chart) はキャプチャを継承しますが、型付きの AddObj オーバーライドは従来の "ゼロから合成" 動作を保持します — これらのシェイプタイプの生バイト出力は将来のコミットに延期されます。

バージョン 2.88.24

複数フォント・複数色のセルコメントが保存サイクルを経ても保持されるようになりました。BIFF8 TXO レコードの書式設定実行ブロック (rgTxoRuns + TxOLastRun、MS-XLS §2.5.272) は、コメントにリッチテキストスタイルを与える実行ごとのフォントと色のオーバーライドを運びます。HotXLS は以前読み込み時にブロック全体を破棄し、書き込み時に単一の空のデフォルト実行 + LastRun を出力していました — 赤で強調表示された "重要!" やコメントテキスト内の太字の単語は HotXLS の各保存後にすべて統一されたデフォルト書式に押し潰されていました。
TMSOShapeTextBox での生バイト保存。ParseTXO はテキスト後の Continue バイトを新しい内部フィールド FFormatRunsRaw: TBytes に verbatim でキャプチャします。Store はそれらを書式設定実行 Continue として書き戻し、基礎レコードの cbRuns ヘッダを一致するように調整します。新しく作成されたコメント (AddComment 経由) は従来の単一デフォルト実行出力を変更せずに保持するため、デフォルトワークブックではバイト単位で同一の出力が保持されます。個別書式設定実行への型付き Excel API アクセスはまだ延期されています — 既存の単一 WideString コメント API は変わりません。

バージョン 2.88.23

印刷解像度とコピー数が保存サイクルを経ても保持されるようになりました — Setup レコード完全カバー。Setup レコードの 3 つの Word フィールド (オフセット 12 の iRes、オフセット 14 の iVRes、オフセット 32 の iCopies、MS-XLS §2.4.257) は、Excel の "ページ設定 → ページ → 印刷品質" と "印刷部数" の選択を運びます。HotXLS は以前 3 つすべてを読み込み時に破棄し、ハードコードされた値 (600 DPI / 600 DPI / 1 部) を出力していたため、ユーザが調整した解像度やコピー数は HotXLS の各保存後に静かに元に戻されていました。
3 つの新しい TXLSPageSetup プロパティ。PrintResolution: LongWord、PrintVResolution: LongWord、Copies: LongWord — すべてのデフォルト値はライタが以前にハードコードしていた値 (600 / 600 / 1) と一致するため、これらに触れないワークブックは v2.88.22 とバイト単位で同一の出力を生成します。セッターは High(Word) にクランプし、過大な呼び出し元値が emit 時にオーバーフローしないようにします。
Setup レコードの round-trip 作業完了。この修正により、BIFF8 Setup レコード ($00A1) のすべてのユーザ可視フィールドがエンドツーエンドで round-trip します — 用紙サイズ / 縮尺 / 先頭ページ番号 / 幅と高さに合わせる / 印刷の向き / 印刷順序 / 白黒 / 下書き / コメント印刷 / セルエラー / 解像度 / コピー数。spec hint の grbit ビット 2 つ (fNoPls、fNoOrient) のみ未公開 — HotXLS はどちらもゼロで書き込み、Excel のデフォルト動作に一致します。

バージョン 2.88.22

カスタムページ設定 "先頭ページ番号" が保存サイクルを経ても保持されるようになりました。BIFF8 Setup レコードは、ワークブックのページ設定 → ページ → "先頭ページ番号" の選択を 2 つの関連フィールドとして運びます: grbit ビット 7 (fUsePage) は Excel の "自動" デフォルトと明示的な開始ページ番号の間を選択し、オフセット 4 の符号付き Word (iPageStart) はそのカスタム値を保持します (MS-XLS §2.4.257)。HotXLS は以前両方を読み込み時に破棄し、ビットクリアで iPageStart = 1 を出力していたため、ユーザが入力した "先頭ページ番号: 100" は HotXLS の各保存後に静かに "自動" に戻されていました。
2 つの新しい TXLSPageSetup プロパティ。UseFirstPageNumber: Boolean はビットを反映します (False = "自動"、デフォルト)。FirstPageNumber: Integer は iPageStart 値を運びます (デフォルト 1、セッターによって spec の signed-Word 範囲 -32768..32767 にクランプ)。HotXLS は UseFirstPageNumber が False のときでも iPageStart を verbatim に round-trip するため、Excel で自動とカスタム間を切り替えるときに最後にユーザが入力した値が保持されます。

バージョン 2.88.21

"シートの末尾にコメントを印刷" の選択が保存サイクルを経ても保持されるようになりました。BIFF8 Setup レコードの grbit ビット 9 (fEndNotes、MS-XLS §2.4.257) は、ページ設定 → シート → コメントドロップダウンの "シートに表示されたとおりに" (デフォルト) と "シートの末尾に" の区別を運びます。HotXLS は既にコメントを印刷するかどうかを制御するために PrintNotes (ビット 5) を round-trip していましたが、ビット 9 は読み込み時に破棄され、書き込み時にゼロとして出力されていました — そのためユーザが選択した "シートの末尾に" は HotXLS の各保存後に静かに "シートに表示されたとおりに" に戻されていました。
新しい TXLSPageSetup.PrintNotesAtEnd ブールプロパティ。デフォルトは False で Excel の UI デフォルトと一致します。リーダとライタは (PrintNotes = False のときでも) ビットを忠実に round-trip するため、コメントを一時的に無効化したワークブックは、ユーザがコメントを再度有効化したときの "末尾に" の優先設定を保持します — Excel 自身の動作を反映しています。

バージョン 2.88.20

ワークブックの "表示桁数で計算する" 選択が保存サイクルを経ても保持されるようになりました。BIFF8 CalcPrecision レコード ($000E) は、ワークブック全体のファイル → オプション → 詳細設定 → "表示桁数で計算する" チェックボックスを MS-XLS §2.4.35 に従って格納します。HotXLS は以前 $000E のディスパッチャケースを持っておらず、TXLSWorkbook.StorePrecision はハードコードされた 1 (= 全精度を保持) を出力していました。ユーザがチェックした "表示桁数で計算する" は HotXLS の各保存後に静かに "全精度" に戻されていました — ユーザが意図的に、後続の再計算でセル値を書式化された小数桁に永続的に切り詰めることを望んでいた意図を隠蔽していました。
新しい TXLSWorkbook.UseFullPrecision ブールプロパティ。デフォルトは True (BIFF8 デフォルトおよび Excel UI のデフォルト 未チェック 状態と一致)。False に設定すると破壊的な "表示桁数で計算" オプションをチェックすることに相当します — HotXLS 自体は round-trip 中にセル値を切り詰めませんが、フラグは忠実に書き戻されるため、Excel の次回再計算でそれが尊重されます。この修正により、すべての BIFF8 calc レコード (CalcCount / CalcMode / CalcPrecision / CalcDelta / CalcIter / CalcSaveRecalc) はエンドツーエンドで round-trip します。

バージョン 2.88.19

"保存前にブックを再計算する" チェックボックスが保存サイクルを経ても保持されるようになりました。BIFF8 CalcSaveRecalc レコード ($005F) は、ワークブックのファイル → オプション → 保存 → "保存前にブックを再計算する" ブール値を MS-XLS §2.4.37 に従って格納します。HotXLS は以前 $005F のディスパッチャケースを持っておらず、StoreCalculationSettings はハードコードされた 1 を出力していました — そのためユーザが無効化した "保存時の再計算" が HotXLS の各保存で静かに再有効化されていました。これは手動計算モードのワークブックで特に重要で、ユーザがディスク上のセル値を意図的に固定していた場合に影響しました。
新しい TXLSWorkbook.RecalcOnSave ブールプロパティ。デフォルトは True (Excel の UI デフォルトおよびレガシーのハードコード値と一致) なので、プロパティに触れないワークブックは v2.88.18 とバイト単位で同一の出力を保ちます。セッターは任意のブールを受け付けます。リーダは任意のゼロ以外のソースバイトを True に正規化します。

バージョン 2.88.18

反復計算の設定 (有効化 + 最大反復回数 + 最大変化量) が保存サイクルを経ても保持されるようになりました。BIFF8 の CalcIter ($0011)、CalcCount ($000C)、CalcDelta ($0010) の各レコードは、Excel の "反復計算を行う" 3 つのオプション (ファイル → オプション → 数式) を一緒に運びます (MS-XLS §2.4.33 / §2.4.31 / §2.4.32)。これら 3 つにはディスパッチャケースがなく、StoreCalculationSettings はハードコードされた値 (オフ / 100 / 0.001) で出力していました。ユーザが設定した 1000 反復 + 0.0001 収束デルタは HotXLS で再保存するたびに静かに "反復オフ、100、0.001" にリセットされていました — 循環参照の数式と収束に敏感な財務モデルを壊します。
3 つの新しい TXLSWorkbook プロパティ。EnableIteration: Boolean はチェックボックスを反映します。MaxIterations: LongWord は反復上限です (セッターは spec 合法範囲 1..32767 にクランプします)。MaxIterationChange: Double は収束デルタです (負の入力は spec デフォルト 0.001 にスナップします)。デフォルト値はライタが以前ハードコードしていた値と一致するため、新しいプロパティに触れないワークブックは v2.88.17 とバイト単位で同一の出力を生成します。

バージョン 2.88.17

ワークブックの計算モード (手動 / 自動 / テーブル以外自動) が保存サイクルを経ても保持されるようになりました。BIFF8 CalcMode レコード ($000D) は、ワークブックレベルの "数式 → 計算方法の設定" の選択を MS-XLS §2.4.36 に従って格納します。HotXLS には以前 $000D のディスパッチャケースが全く存在せず、ソースファイルの値は読み込み時に破棄され、ライタは常にハードコードされた $0001 (自動) を出力していました。ユーザが選択した手動モードは HotXLS で再保存するたびに静かに自動に戻っていました — パフォーマンスのために意図的に手動を設定している大規模ワークブックでは特に問題です。新しい ParseCalcMode ハンドラはソース値をワークブックに保存し、StoreCalculationSettings は定数ではなく保存された値を出力するようになりました。
新しい TXLSWorkbook.CalculationMode プロパティ。読み書き可能な LongWord プロパティで、xlCalcManual (0)、xlCalcAutomatic (1、デフォルト)、または xlCalcAutomaticExceptTables (0xFFFF) を受け付けます — lxTNC.inc からエクスポートされた 3 つの新しい定数。セッターは未知の値を spec デフォルトにクランプするため、破損したソースファイルがワークブックを未定義の状態にすることはありません。プロパティに触れない既存のコードはレガシーの "自動" デフォルトを保持するため、デフォルトワークブックの以前の出力はバイト単位で同一です。

バージョン 2.88.16

ページ設定の "セルエラー" の選択が保存サイクルを経ても保持されるようになりました。BIFF8 Setup レコード ($00A1) は、ページ設定 → シートの "セルエラー: 表示する / <空白> / <ダッシュ> / <N/A>" ドロップダウンを、grbit ワードの bits 10-11 すなわち iErrors としてパックしています (MS-XLS §2.4.257)。HotXLS は以前読み込み時にこれらのビットを破棄し、書き込み時にゼロとして出力していたため、#DIV/0! を #N/A として印刷するように設定されたブックが HotXLS で再保存するたびに静かに "表示する" に戻っていました。リーダは iErrors を新しい TXLSPageSetup.PrintCellErrors プロパティにデコードし、ライタはそれからフィールドを再構築します。
新しい TXLSPageSetup.PrintCellErrors プロパティ。読み書き可能な LongWord プロパティで、xlPrintErrorsDisplayed (0、デフォルト)、xlPrintErrorsBlank (1)、xlPrintErrorsDash (2)、または xlPrintErrorsNA (3) を受け付けます — lxTNC.inc からエクスポートされた 4 つの新しい定数。プロパティに触れない既存の PageSetup 呼び出し元はデフォルト値 ("表示する") を維持するため、以前の印刷出力は変わりません。

バージョン 2.88.15

セルコメントの配置と向きが保存サイクルを経ても保持されるようになりました。BIFF8 TXO base レコード ($01B6) は grbit ワード内に 5 つの型付きフラグ (hAlignment, vAlignment, fLockText, fJustLast, fSecretEdit) と、テキスト向きを示す別の rot ワードを持ちます (MS-XLS §2.4.329)。リーダはこれらをすべて捨て、ライタは grbit をハードコードされた 0x0012 (左 + 上) に固定し、回転も常に 0 にしていました。そのため中央揃えや回転されたコメントは保存のたびにソースに関係なく左+上+水平にリセットされていました。リーダは読み込み時に型付きフィールドをデコードし、ライタはそれらから grbit を再合成するため、レイアウトが save/reload サイクルを生き残るようになりました。
明示的なコメントスタイル指定のための TMSOShapeTextBox の 6 つの新しいプロパティ。HAlignment、VAlignment、Rotation、LockText、JustLastLine、SecretEdit が各コメントシェイプ上の読み書きプロパティとして公開されました。AddComment はデフォルトで左+上+水平+ロック解除に初期化されるため、これらに触れない呼び出し元は以前の外観を維持します。
TXO ライタは reserved4 / reserved5 を spec のフィールド境界に沿って配置するようになりました。以前のコードは base レコードの offset 2-9 を 2 つの Long 書き込み (rot + reserved4 続いて reserved5) として出力していましたが、ライタは現在これらを Word rot、Word reserved4、Long reserved5 に分割します。バイト内容は変わりません (Note シェイプの場合は依然としてすべてゼロ) が、コードの構造は MS-XLS §2.4.329 のフィールドオフセットと一致するため、将来の TXO 修正で位置を間違えにくくなります。

バージョン 2.88.14

TXO cchText オフセットを修正 — v2.88.13 のコメント長修正が今ようやく実際に発火するようになりました。前のリリースは TXO ベースレコードのサニティチェックとしてオフセット 8 から cchText を読み取りましたが、MS-XLS §2.4.329 は cchText をオフセット 10（grbit、rot、6 バイトの reserved / controlInfo の後）に置いています。オフセット 8 は reserved5 ロングの内部にあり、Note 形状のオブジェクトでは常にゼロなので、すべてのコメントが防御的フォールバックに静かに滑り落ち、v2.88.13 以前の挙動に戻っていました。この修正でオフセットを 10 に直し、長いコメントが本当に Continue レコードを跨いで連結され、短いコメントは末尾にパディングを拾わなくなります。v2.88.13 が本来出荷するはずだった挙動以外の変更はありません。

バージョン 2.88.13

長いセルコメントが全長で読み戻されるようになりました。BIFF8 TXO レコード（$01B6）はテキスト本体をベースレコードと 1 つ以上の Continue レコードに分割し、文字数はベースレコードのオフセット 8 にある cchText に公開されます。以前のコメントリーダーはベースレコードを完全にスキップし、DataList[1] をテキスト全体として扱って終わっていたため、約 4100 ワイド文字を超えるコメントは静かに切り捨てられ、Continue レコードに末尾パディングが付いた短いコメントもそのゴミを末尾に拾っていました。リーダーは現在 cchText を権威ある文字数として消費し、MS-XLS §2.4.329 に従って各 Continue セグメントを順に走査（rgb の break は文字境界に置かれるので部分文字の簿記は不要）、予算が満たされた瞬間に停止します。これにより、テキストの直後に続くフォーマット runs ブロックが文字列にしみ出すことはありません。ベースレコードが破損 / 欠落しているコメントは引き続き「残りバイトをすべて消費する」レガシーパスへフォールバックします。

バージョン 2.88.12

文字列を返す数式から得られる、約 4100 文字を超えるキャッシュ文字列が Continue レコードを跨いでラウンドトリップで保持されるようになりました。v2.88.11 は BIFF8 String レコード ($0207) の読み取り側を接続しましたが、最初のレコード本体しか消費しなかったため、UCS-2 バイトが 8224 バイトの BIFF 限界を超えて 1 つ以上の Continue レコード ($003C) にあふれたキャッシュ文字列は静かに切り捨てられていました。ハンドラーは今やディスパッチ層の DataList 全体を走査します。ベースレコードから cch と fHighByte を読み、そこに収まる本体をコピーし、それから後続の Continue セグメントを MS-XLS §2.5.293 の文字境界保証に従って raw バイトとして連結します。XLUnicodeString は文字列の途中で fHighByte を再送しません。各セグメントは残り文字数の予算で区切られているため、過大な Continue があっても結果が cch を超えることはありません。単一レコード文字列（一般的なケース）は以前とまったく同じ高速パスを通ります。

バージョン 2.88.11

文字列を返す数式が Excel の計算済みテキストキャッシュをラウンドトリップで保持するようになりました。前のリリースは BIFF8 FormulaValue キャッシュ（MS-XLS §2.5.133）の数値・ブール・エラー・空の 4 つのバリアントをカバーしましたが、文字列バリアントは Formula レコードの直後に続く独立した String レコード ($0207) にキャッシュ値が存在するため、to-do 項目として残されていました。ParseFormula は文字列バリアントの Formula を見るとセル座標を覚えておき、新しい ParseString ハンドラーが MS-XLS §2.4.268 に従って後続の $0207 レコードをデコードし、WideString を FCachedFormulaValue へルーティングします。HotXLS のエバリュエーターが Excel 計算のテキストを再現できない場合、GetCellValue はそのテキストへフォールバックできるようになりました。ParseFormula の冒頭にある防御的リセットが古い保留中アンカーを破棄し、ソースファイルが String レコードを欠落させた場合に後続のものを誤って結び付けるのを防ぎます。8224 バイトを超えて Continue チャンクへあふれるレコードは引き続き既知の制限としてエバリュエーター出力にフォールバックします。

バージョン 2.88.10

BIFF8 Formula レコードが Excel の計算済みキャッシュ値をラウンドトリップで保持するようになりました。ParseFormula は以前、オフセット 6 にある 8 バイトの FormulaValue ペイロードを完全にスキップしていたため、読み込んだ .xls 内のすべての数式のキャッシュ結果（数値、ブール、エラー、空）が失われ、HotXLS は自前の数式エンジンですべてのセルを再評価していました。そのエンジンが Excel と一致できない場合（未対応の XLM 関数、壊れた外部リンク、未実装の数式）、セルは静かに空または 0 になっていました。リーダーは MS-XLS §2.5.133 に従って数値 / ブール / エラー / 空の 4 種類のバリアントをデコードし、新規の TXLSCellRef.FCachedFormulaValue フィールドに格納します。GetCellValue はエバリュエーターが失敗したときのみそのキャッシュにフォールバックするため、新たに作成した数式は従来どおり評価を通ります。文字列バリアントは後続の String レコード ($0207) のパーサーがまだ接続されていないため、引き続きエバリュエーターに委ねます。

バージョン 2.88.9

BIFF8 Formula レコードで値が解決できない場合、reserved1 ビットではなく fAlwaysCalc を立てるようになりました。HotXLS の evaluator が保存時に数式を計算できなかった場合、ライターは grbit = 0x0002（ビット 1、MS-XLS §2.4.127 が予約済みで読み取り側に無視を要求する reserved1）を設定していました。Excel は仕様どおりこれを無視し、プレースホルダーのキャッシュ値 0 を権威として扱い、再計算せず黙って 0 を表示していました。ライターは現在 grbit = 0x0001（fAlwaysCalc、ビット 0）を設定するため、Excel は次の再計算時に数式を再実行し、セルは正しい結果を表示します。

バージョン 2.88.8

PageSetup.PrintTitleColumns / PrintTitleRows が不正な入力で例外を発生させるようになりました。これらのプロパティに不正な範囲文字列（ColDiapasonToValues / RowDiapasonToValues が解析できない入力）を設定すると、以前は代入が黙って捨てられていました。ブックは既存の Print_Titles 範囲を保持するか未設定のままで、呼び出し側は何が起きたか知る術がありませんでした。セッターは今や TXLSRange の不正インデックスパスで使われているのと同じ raise スタイルに合わせて Exception.Create で問題の値を含む詳細メッセージ付きの例外を発生させます。

バージョン 2.88.7

Row レコードの miyRw フィールドが MS-XLS 仕様範囲内に収まるようになりました。BIFF8 以前の Excel は miyRw にビット 15 を OR することで「ブック既定の行高を使用」を表現しており、HotXLS は MS-XLS §2.4.221 が miyRw を 8192 twips に制限しているにもかかわらず BIFF8 ライターでもこの慣用を続けていました。最新の Excel は同じケースで素の 255（12.75pt 既定）を出力し、手動オーバーライドを fUnsynced grbit ビットで示すため、ビット 15 のハックは HotXLS の出力を正規の .xls から逸脱させていました（"既定" が 32 959 = 0x80FF と書かれ、技術的には仕様外）。ライターは OR を取り除き 255 を直接書き込むようになりました。リーダーは v2.88.6 以前のファイルおよび BIFF5 慣用を踏襲した一部のサードパーティ生成物との後方互換のため、依然としてビット 15 を入力時に剥がします。
BIFF8 仕様監査ラウンド 2 に正誤注を追加。[MS-XLS] のフィールド境界を再確認したところ、元レポート（dev-notes/XLS-BIFF8-Spec-Audit-Round2.md）で P2 とした 2 件は実際にはバグでないことが分かりました。BOF history flag $000080C9 のビット 15 設定は verXLHigh フィールド（ビット 14-17、値 2 = 「Excel 2002」）に属し、reserved1 末尾（ビット 19-31）ではありません。また ParseFormula が先頭 PtgExp トークンで shared / array formula を検出する方法は仕様が示すものと一致し、後続の ShrFmla / Array レコードで正しく曖昧性解消されます。両項目とも撤回として注釈されました。

バージョン 2.88.6

マクロシートと VBA モジュールが BoundSheet8 の順序スロットを保持するようになりました。読み取り側は以前、dt フィールドが 1（マクロシート）または 6（VBA モジュール）の BoundSheet8 レコードを破棄しており、HotXLS の Sheets コレクションがこれらのエントリの分だけ短くなっていました。ExternSheet 内の XTI がファイル順でマクロシートを越えた位置のシートを参照していると、HotXLS SaveAs 後に誤ったワークシートに解決されていました。読み取り側は今や BoundSheet8 レコードごとにプレースホルダーシートを追加し、生の dt バイトを新しい Sheet.SheetTypeRaw プロパティに格納します。書き込み側は元のバイトをそのまま書き戻します。マクロ substream BOF レコード（$0040）も解析中はワークシート substream として扱われるため、マクロシート内のセルは黙って前のシートに吸収されず保持されます。

バージョン 2.88.5

BIFF8 Row レコードが fCollapsed、fExAsc、fExDes、fPhonetic をラウンドトリップで保持します。以前は読み取り側で fCollapsed（grbit ビット 4）を破棄し、書き込み側は隣接行のアウトラインレベル遷移から推測していたため、ソースファイルが明示的に折りたたんだ行や境界として印付けた行を誤分類していました。上位 3 ビット fExAsc (ビット 28)、fExDes (ビット 29)、fPhonetic (ビット 30) も読み取られておらず、書き込み側で 4 バイト grbit を単一の 16 ビット ixfe スロットに切り詰めていたため常にゼロが書き出されていました。読み取り側は MS-XLS §2.4.221 に従い 4 つのビットすべてを取り込み、fCollapsed を explicit としてピン留めするため書き込み側の推測は Excel が表明した値を上書きしません。書き込み側は ExAsc / ExDes / Phonetic を ixfe ワードのビット 12-14 に詰め、ixfe を仕様で許される 12 ビット範囲にマスクして XF インデックスが新しいフラグと衝突するのを防ぎます。ラウンドトリップ副作用：ExAsc / ExDes が駆動する太い上罫線 / 中太い下罫線のヒントが HotXLS SaveAs 後も保持され、日本語シート上の振り仮名情報の可視性が保存のたびにリセットされなくなります。

バージョン 2.88.4

BIFF8 Window2 fPaged ビットがアクティブシートのみを示すようになりました。以前のリリースでは fPaged（MS-XLS §2.4.346 ビット 10）をすべての可視シートに立てており、Excel 自身の出力と乖離していました（仕様ではこのビットは「このシートはワークブックウィンドウに現在表示されている」を意味し、アクティブシートのサブストリームのみが保持すべきです）。Excel リーダーは Window1.itabCur へフォールバックして真のアクティブシートを特定するため誤用を許容していましたが、Apache POI 厳格モードや fPaged を主要シグナルとして信頼するその他のツールは正しく旗の立ったシートを取得できるようになりました。

バージョン 2.88.3

BIFF8 Window2 ズームおよびグリッド線の色がラウンドトリップで保持されます。以前のリリースでは WINDOW2 レコードの offset 6 以降のフィールドを読み取り側で破棄し、書き込み側でハードコードゼロを送出していたため、Excel で保存されたシートズーム（75%、125% など）とグリッド線の色カスタマイズは HotXLS の SaveAs 後にすべて既定値に戻っていました。読み取り側は MS-XLS §2.4.346 に従い icvHdr、wScaleSLV、wScaleNormal を取り込みます。アクティブビューのズームは Sheet.Zoom に入り、反対側ビューのキャッシュズームは新規キャッシュスロットに入るため、Excel で Normal と Page Break Preview を切り替えても以前のズームが復元されます。書き込み側は Sheet.View に応じて Sheet.Zoom を対応スロットに、反対側にキャッシュ値を送出し、保持されたグリッド線色インデックスを書き戻します。

バージョン 2.88.2

BIFF8 HFPicture レコードの opcode を修正。保存される .xls ファイルは MS-XLS §2.4.138 に従って正しい rt = 0x0866 でヘッダー / フッター背景画像レコードを書き出すようになりました。以前のリリースでは 0x086C（CellWatch の opcode）が使われており、Excel は埋め込まれた OfficeArt BLIP を監視セル参照として解析しようとして失敗し、画像を静かに破棄していました（埋め込み画像のバイトが偶然 CellWatch の予期する 16 バイト構造を破った場合、ワークブックを開くことを拒否することもありました）。HotXLS で往復保存されたヘッダー / フッター画像付きのワークブックは、画像を維持するようになりました。

バージョン 2.88.1

BIFF8 Theme レコードの opcode を修正。保存される .xls ファイルは MS-XLS §2.4.326 に従って frtHeader.rt = 0x0896 で Theme レコードを書き出すようになりました。以前のリリースでは 0x0892（StyleExt の opcode）が使われており、Excel は埋め込まれた OOXML テーマペイロードをセルスタイル拡張として解釈し、組み込みの Office テーマへ静かにフォールバックしていました。カスタマイズしたテーマカラーを持つワークブックを HotXLS で往復保存しても、カスタムパレットが保持されます。

バージョン 2.88.0

**[MS-XLSX] 第四轮交叉审计 — 主题部分 + 工作表名称设置器。** 针对第一轮至第三轮（v2.51.0 / v2.52.0 / v2.54.1）后遗留问题的两个后续修复。两个修复均未破坏现有调用点；一个扩展了设置器的功能，另一个添加了一个始终生成的新的部分。
**.xlsx パッケージの保存機能が改善され、`xl/theme/theme1.xml` というファイルが追加されました。** 以前から、テーマインデックスを介して設定されたフォント、塗りつぶし、罫線、タブの色に対して、`<color theme="N"/>` という参照が生成されていましたが、テーマファイルが書き込まれていなかったため、参照が無効になっていました。Excel は、デフォルトの「Office」テーマに自動的に切り替えて問題を回避していましたが、Office File Validation ではすべての参照が「テーマファイルが見つかりません」と報告され、Apache POI の厳密モードでは、最初の参照時にワークブックが拒否されていました。 `SaveAs` 機能は、標準的な Office (2007 以降) のテーマを生成するようになりました。これは、12 スロットのカラースキーム (システムの色 `windowText` / `window`、Excel のデフォルトカラー 4 色、アクセントカラー 6 色、ハイパーリンクカラー 2 色)、Calibri Light / Calibri フォントスキーム、および最小限の有効なフォーマットスキーム (各 `CT_StyleMatrix` に対して、塗りつぶし、線、効果、背景塗りつぶしがそれぞれ 3 つ) を使用します。 `[Content_Types].xml` に対応する `Override` が追加され、`xl/_rels/workbook.xml.rels` には、既存の `XlsxFirstExternalLinkRid` のオフセットが変更されないように、`theme/theme1.xml` の関連付けが追加されます。
**`Sheet.Name` 属性的直接赋值现在也进行安全处理和去重。** 在第三轮（v2.54.1）中，添加了对 Excel 命名规则的强制执行，具体是在 `TXLSXSheets.Add(AName)` 中，但 `TXLSXWorksheet.Name` 属性的设置器仍然是直接的 `write FName` 操作，因此，最常见的修改路径（该轮次未覆盖）——`lxXlsxExport.pas:122 Target.Name := Source.Name`，即 XLS 到 XLSX 的转换过程——允许通过任何 BIFF8 源包含的名称（禁止字符 `: \ / ? * [ ]`，长度 > 31，周围的单引号，保留的 `History`，现有工作表的忽略大小写的重复项）。现在，属性设置器通过一个新的 `SetName` 方法，该方法重放相同的 `XlsxSanitizeSheetName` + `'(N)'` 后缀去重逻辑（忽略大小写，排除自身），并将其应用于父工作簿的工作表集合。对于未连接的工作表（尚未有 `FWorkbook` 反向指针），会跳过去重步骤，仅进行安全处理——`TXLSXSheets.Add` 将在工作表连接时强制执行唯一性。对于已验证的名称，操作是幂等的，因此读取端的 `FSheets.Add(names[i])` 仍然是纯粹的转换过程。

バージョン 2.87.4

XLS 共有数式は有効な ShrFmla 本体を書き出すようになりました。 BIFF8 出力は共有解析数式の前に必須の cUse バイトを含め、UseSharedFormulas 使用時の 1 バイトずれを防ぎます。
XLS テーブルのスタイルとフィルターのメタデータは最新の MS-XLS レイアウトに従います。 AddTable は LIST12 を List12TableStyleClientInfo として書き、Feature11 に AutoFilter フラグを設定し、列ごとの空 Feat11FdaAutoFilter ブロックを出力します。
BIFF8 CF12 のデータバー / カラースケール / アイコンセットは、禁止された DXF payload を書き出さなくなりました。 HotXLS は MS-XLS に従って DXF ブロックを空にし、実際の設定は CF12 種別別の末尾データに保持します。

バージョン 2.87.3

**XLSワークシートのテーブルメタデータは、現在、MS-XLSのFeature11テーブルレイアウトに従います。** AddTable関数による.xlsファイルの出力において、FeatHdr11テーブルヘッダーと、Feature11のTableFeatureType/Feat11FieldDataItemデータが書き込まれ、従来の$0867 FeatHdrテーブルマーカーが削除され、テーブル名と列名がXLUnicodeString値として保存されます。
**XLS 表格读取功能现在能够正确理解规范定义的字段布局。** HotXLS 解析 `TableFeatureType` 表格的名称、范围、总计行状态以及字段标题，同时保留了对旧版 HotXLS 生成的表格记录的支持。

バージョン 2.87.2

**XLS BIFF8 継続レコード теперь 正しくベース長が設定されます。** ライターによって分割された、サイズの大きな XLS レコードの場合、最初のレコードの長さを元のサイズの大きな長さのままにするのではなく、8224 バイトに更新します。
**大きなXLSワークシートのテーブルは、仕様に準拠したContinueFrt11チャンクを使用するようになりました。** 幅広いAddTable出力で、大きなFeature11データを含む場合、$0875 ContinueFrt11の継続レコードを使用して保存され、テーブルのメタデータが保持された状態で再度開かれます。これは、[MS-XLS]のFeature11/ContinueFrt11レイアウトと一致します。

バージョン 2.87.1

**XLSXワークシートのグリッド制限は、現在、Excelの最終行と最終列を含みます。** `TXLSXRange`、`RCRange`、`EntireRow`、および`EntireColumn`は、行1048576と列16384（`XFD`）をサポートするようになりました。これは、[MS-XLSX]で定義されている行番号と列番号の制限に一致します。以前は、内部の制限がゼロベースの最大値を使用していたため、`XFD1048576`や、最終行または最終列に隣接する範囲は、問題なく前の行/列にクリップされていました。
**XLSX暗号化に関するドキュメントとテストが、実装されている書き込みパスと一致するようになりました。** ヘルプページと回帰テストスイートでは、`SaveAsEncrypted`が、空でないパスワードの場合にECMA-376規格の暗号化出力を作成すること、一方`OpenEncrypted`は、暗号化されたファイルに対してはエラーを発生させ、暗号化されていない.xlsxファイルに対しては正常に動作することを明記しています。

バージョン 2.87.0

**XLSXファイルのパスワード保護による保存機能が正常に動作するようになりました (Jフェーズ2、バックログ#29)。** `TXLSXWorkbook.SaveAsEncrypted(FileName, Password)` は、ECMA-376規格に準拠した、暗号化された.xlsxファイルを生成します (Office 2007以降の形式)。 [MS-OFFCRYPTO] §2.3.4で定義されている完全なパイプラインが実装されました。フェーズ1のSHA-1による50000回のパスワード導出、AES-128の検証ブロック、AES-CBCによるパッケージ全体の暗号化、およびバイナリ`EncryptionInfo`シリアライザーに加えて、フェーズ2の4つの`\005DataSpaces`メタデータストリーム (バージョン/データスペースマップ/データスペース情報/変換情報) と、OLEコンパウンドファイルバイナリライターが追加されました。これにより、すべてのデータがCFBコンテナに格納され、Excelでユーザーのパスワードを入力するとファイルが開きます。ワークフローは次のとおりです。呼び出し元が空でないパスワードを指定して`SaveAsEncrypted`を呼び出す → HotXLSが、ワークブックをメモリ内のプレーンテキスト.xlsx ZIPファイルにシリアライズする → 新しいランダムな16バイトのソルトと検証子を使用して、AES-128 CBCで暗号化する → `StgCreateDocfile`を介してCFB出力を書き込む。Excel 2007以降で開く: パスワードを入力すると、コンテンツが表示されます。パスワードが間違っている場合、拒否されます。`OpenEncrypted` (復号側) は、別のバックログ項目であり、暗号化されたファイルが渡されると、引き続き`EXlsxEncryptionNotImplemented`例外を発生させます。

バージョン 2.86.1

**XLSX 標準暗号化 — 暗号化基盤 (Jフェーズ 1、バックログ #29)。** 2つの新しい内部モジュールが、ECMA-376 標準暗号化の書き込みパスにおける暗号化と鍵導出の機能を実装します。`lxAES.pas` は、Brian Gladman氏のAES (thirdparty/Win32/aes*.obj および thirdparty/Win64/aes*.obj からリンク) をラップし、AES-128 ECB (単一ブロック) および AES-128 CBC 暗号化のエントリポイントを提供します。`lxXlsxStdEncrypt.pas` は、純粋なPascalで記述されたSHA-1 (FIPS-180-4) を実装し、[MS-OFFCRYPTO] の §2.3.4.10 で定義されている、50000回の反復パスワード導出、および §2.3.4.7 で定義されている検証ブロック (`EncryptedVerifier` + `EncryptedVerifierHash`)、AES-CBC パッケージ本体暗号化 (8バイトのLEサイズプレフィックス + 16バイト境界へのゼロパディング + ゼロのIV)、および §2.3.4.6 で定義されているバイナリ `EncryptionInfo` シリアライザを実装します。`TXLSXWorkbook.SaveAsEncrypted` は、依然として `EXlsxEncryptionNotImplemented` 例外を発生させます。Jフェーズ 2 では、OLE Compound File Binary ライター (`\005DataSpaces` コンテナストリーム) が追加され、パイプラインが `SaveAsEncrypted` に接続されます。それまでの間、これらの新しいモジュールはライブラリ内部で使用されるものであり、呼び出し側は依存すべきではありません。

バージョン 2.86.0

**QueryTable および外部データ接続のラウンドトリップ (第1段階、バックログ #28)。** Excel で作成された QueryTable および外部データ接続 (データ → Web / SQL / OLEDB から外部データ取得) が、HotXLS による保存/読み込みサイクルを乗り越えるようになりました。以前は、BIFF8 リーダーが `QsiSXTag` ($0802)、`QsiSXTagExt` ($0810)、および `DConn` ($0876) をサイレントでスキップしていたため、上流のクエリを記述するメタデータが保存時に削除され、テーブルが単純なセル値に劣化していました。リーダーは現在、これらのレコードを不透明なバイトとしてキャプチャし、ライターはこれらをワークシートのサブストリーム (PIVOTVIEW ブロック [MS-XLS] §2.1.7.20.5 に従って) およびワークブックのグローバル領域 (EOF 前の遅延グローバルブロック §2.1.7.20.3 に従って) に書き戻します。 HotXLS は、まだ QSI / DConn 構造をプログラム的にモデル化していませんが (新しい QueryTable を呼び出し元のコードで作成することは、後続の段階に延期されます)。ただし、すでにそれらを含むワークブックは、リフレッシュメタデータを失うことはありません。 BIFF8 (.xls) のみで、BIFF5 には影響ありません。

バージョン 2.85.1

**Win32/Win64ライブラリのビルドを復元しました。** wave H5.3 マルチデータフィールド SXLI エミッタ内の2つのピボット・ラインアイテム補助変数について、それぞれが `array of array of Word` という匿名型として宣言されていましたが、Delphiコンパイラはこれらを異なる名前のない型として扱い、直接代入時に `E2008 不可能な型` エラーを発生させます。 HotXLSライブラリは、v2.84.1以降、RAD Studio 12.0から37.0までのバージョンでビルドされていませんでした。 2つの変数をまとめて宣言することで、同じ匿名型を共有するように変更し、代入の問題を修正し、Win32とWin64の両方のターゲットに対して、`.dcu` / `.bpl` ファイルの出力が復元されました。実行時の動作は変更されず、生成されるSXLIバイトはv2.85.0と同じです。

バージョン 2.85.0

**追加された型付きピボット集計API（H5.4）。** 新しいTXLSPivotFieldオブジェクトは、既存のSubtotalMask: Wordプロパティに加えて、Subtotals: TXLSPivotSubtotalsという新しいプロパティを公開します。呼び出し元は、例えばField.Subtotals := [xlpsSum, xlpsAverage];のように設定できます。これにより、SXVDのgrbitSubフィールドを手動でビットパックする必要がなくなります。 12種類の集計タイプが公開されており（xlpsDefault、xlpsSum、xlpsCount/CountA、xlpsAverage、xlpsMax、xlpsMin、xlpsProduct、xlpsCountNums、xlpsStdDev、xlpsStdDevP、xlpsVar、xlpsVarP）、それぞれが[MS-XLS]セクション2.4.279で定義されている1つのビットに対応します。既存のSubtotalMaskは、データの整合性を保つための参照として引き続き使用されます。読み取り/書き込み時に、予約済みのビット12〜15は保持されます。これにより、以前のH4.3で知られていた制限「行フィールドの集計に関するSXVD.grbitSubの設定がAPIから利用できない」が解消され、H5のピボット機能に関する追加機能が完了します。

バージョン 2.84.1

**複数のデータフィールドを持つSXLIの拡張（H5.3）。** ピボットテーブルが複数のデータフィールドを持ち、かつデータフィールド軸が特定のSXLI軸と一致する場合（`DataFieldAxisIsRow = True`の場合、行軸、または`DataFieldAxisIsRow = False`の場合、列軸）、ライターは、各直積の組み合わせを`DataFieldCount`回複製し、`iData = 0 .. DataFieldCount - 1`の範囲で繰り返します。さらに、`DataFieldCount`個の合計行を追加し、各データフィールドに独自の合計を提供します。ホストされていない軸は変更されません。Excelやその他のリーダーは、呼び出し元が意図したレイアウトで、複数のデータフィールドを持つピボットテーブルをレンダリングするようになり、以前の「各組み合わせにつき1つの`iData = 0`」という近似的な表示ではなくなります。単一のデータフィールドを持つピボットテーブルは、v2.84.0と同じビット単位の出力を生成します。デルタ圧縮（H5.1）により、繰り返される組み合わせは約8バイト/複製に圧縮されるため、拡張によるバイトオーバーヘッドは最小限です。これにより、以前に知られていた制限「複数のデータフィールドを持つSXLIが正しく拡張されない」が解消されます。

バージョン 2.84.0

**ピボットテーブルの軸の事前選択API（H5.2ウェーブ）。** 型付きの`TXLSPivotField`には、プログラムで作成されたピボットテーブルが、ページ軸のフィルターで特定のキャッシュ項目を事前に選択するために設定できる`PageItemIndex`プロパティが追加されました。デフォルト値`xlPageItemAll`（=$7FFD）はフィルターを「(すべて)」のままにし、`PageItemIndex`を割り当てない呼び出し元は、v2.83.2と同じ動作をします。 SXPI（$00B6）ライターは、`Field.PageItemIndex`を読み込み、以前はハードコードされていた$7FFDを使用します。また、型付きのリーダーは、開く際にSXPIから`PageItemIndex`を読み込み、呼び出し元が保存されたページ選択内容を検査できるようにします。これにより、以前のH4.3ウェーブで知られていた制限「APIからページフィルターの呼び出し元の事前選択が利用できない」が解消されます。

バージョン 2.83.2

**ピボットテーブルのSXLIレコードを、差分圧縮によって小型化 (wave H5.1)。** ピボットテーブルの書き込み機能は、仕様のcSicフィールドを使用して、SXLIレコードの行項目を差分圧縮するようになりました。各行の先頭にあるキャッシュ項目のインデックスで、前の行と同じSXLIレコード内のインデックスが一致する場合、それらは共有プレフィックスのカウントにまとめられ、末尾のインデックスのみが出力されます。通常、行軸のSXLIレコード（数行のフィールド×数十の項目）は、意味が変わらずに30〜60%小型化されます。出力は、8224バイトのBIFFレコード制限を超えないように、チャンクに分割されます。すべてのSXLIレコードの最初の行では、常にcSic = 0が出力されます（レコードローカルで、レコード間の参照はありません）。また、総計行は差分圧縮されません。

バージョン 2.83.1

**セルの塗りつぶし、フォント、および境界線の色の設定は、RGB 値で指定され、.xls ファイルの保存/読み込みで正しく処理されるようになりました。** 以前、BIFF8 XFExt ($087D) ライターは、各レコードの ixfe フィールドを、メモリ内の XF 配列の位置を使用して出力していました。しかし、ディスクに書き込まれる対応するセルのレコードは、保存後のインデックス順序で ixfe を使用していました。保存時にテーブル内の以前の XF が削除される場合（通常、セルが一時的な XF から最終的な XF に移行する場合）、すべての XFExt の ixfe が削除されたスロット数だけずれてしまい、各セルの関連するカラー情報が読み込み時に隣接するセルにシフトしていました。ライターは、各リッチスロット XF に対して SaveIndex を解決し、対応するディスク上の ixfe を出力するように変更されました。これにより、HotXLS で保存されたセルの RGB カラー（塗りつぶし、フォントの色、境界線の色）が、保存/読み込みのサイクルで問題なく維持されるようになりました。完全に削除された XF に対応する XFExt レコードは、不要な ixfe を出力する代わりにスキップされるようになりました。

バージョン 2.83.0

**ピボットテーブルの行項目とページ項目状態 (H4.3)。** プログラムによって作成されたピボットテーブルは、行軸と列軸の両方に対してSXLI ([MS-XLS] §2.4.275, $00B5) を、およびページ軸に対してSXPI ($00B6) を生成します。これにより、ピボットビューのレイアウト忠実性が向上します。Excel以外のアプリケーションでは、作成者が意図した正確な表示順序が表示され、大きなピボットテーブルはより高速に開きます (Excelは行のレイアウトを最初から再計算する必要がなくなります)。また、ページフィルターは、各ページフィールドに対してデフォルトの "(すべて)" 選択で保持されます。
行と列のSXLI列挙。書き込みエンジンは、軸フィールドのキャッシュアイテムの直積を列挙します（最も内側のフィールドが最も速く変化し、Excelのネストされた行レイアウトに一致します）。そして、各組み合わせに対して1行を出力し、最後に「SXLI nTypes fGrandTotal」ビットでマークされた合計行を出力します。各行では、cSic = 0を使用します（デルタ圧縮は行いませんが、1行あたりわずかに多くのバイトを使用します）。出力は、行数が8224バイトのBIFF制限を超えた場合に、複数のSXLIレコードに分割されます。また、16384行という安全制限を設けることで、異常な入力による過剰な拡張を防ぎます。
**SXPIページ軸の状態。** 少なくとも1つのフィールドがAxis = xlpfaPageFieldの場合にのみ出力されます。各エントリは10バイト（isxvd + iCache + ipos + objId）で構成され、iCacheは$7FFDで"(すべて)"を示します。特定のページ項目を事前に選択するためのAPIは、H5のバージョンで提供される予定です。ページフィールドを持たないピボットは、SXPIを出力しません（ワークシートのABNFではオプションとしてリストされています）。
**修正了H3中已知的限制，即“SXLI / SXPI未输出”。** 结合了H4.1（数据字段的数字格式）和H4.2（SXDBB逐记录流），H4解决了H3透视表生成器中的所有三个已知限制。通过`IXLSWorksheet.AddPivotTable`创建的透视表现在包含完整的布局元数据，并以自包含的缓存形式提供。

バージョン 2.82.0

**ピボットキャッシュは、レコードごとに独立したストリームとして扱われます（H4.2）。** プログラムによって作成されたピボットキャッシュは、仕様のビット圧縮エンコーディングで、レコードごとのフィールド値のインデックスを含むSXDBBレコード（[MS-XLS] §2.4.272、キャッシュコンテキストにおける$00C5）を出力します。 SXDBBがない場合、Excelは開いたときにソース範囲からキャッシュを再構築する必要がありましたが、これはソースデータが存在し、変更されていない場合に機能しましたが、ソースの名前が変更または削除された場合、またはピボットが作成されてからソースが変更された場合に問題が発生していました。現在、キャッシュは独立しています。
**仕様に従ったビット圧縮符号化。** 各フィールドは、レコードごとにceil(log2(itemCount + 1))ビットを使用します（センチネル領域を含む）。レコードはバイトアラインメントされており、すべての新しいレコードは新しいバイト境界から始まります。ライターは、ストリームを複数のSXDBBレコードに分割して、8224バイトのBIFFサイズ制限内に収めます。これにより、数万行のソースデータを持つキャッシュでも、正常にシリアル化できます。
**ラウンドトリップパスは変更されていません。** ディスクから読み込まれたピボットキャッシュ（FromRawBlobs = True）は、引き続きwave H1の生データパスを経由してラウンドトリップされます。新しいSXDBBライターは、`IXLSWorksheet.AddPivotTable`によって作成された型付きキャッシュに対してのみ有効になります。混合ワークブック（ラウンドトリップされたキャッシュと新しいキャッシュの両方を含む）は、両方のパスを問題なく出力します。

バージョン 2.81.0

**ピボットデータフィールドの数値書式設定 (wave H4.1)。** ピボットデータフィールドは、Excelの数値書式文字列を適用できるようになりました。これにより、通貨、パーセント、日付データが、Open上で正しい記号で表示されるようになり、生の汎用書式の値が表示されることはなくなります。新しい`IXLSWorksheet.PivotSetDataFieldFormat(DataField, FormatStr): Word`メソッドは、ワークブックのNumFormatsテーブルに書式設定を登録します（自動追加または再利用）。そして、結果のifmtインデックスを`TXLSPivotDataField.NumberFormat`に書き込みます。このメソッドは、既存のSXDI.ifmtの生成機能と連携し、処理を完了させます。
**TXLSWorkbook对象上公开了NumFormats辅助函数。** `Workbook.RegisterNumFormat(FormatStr): Word` 在工作簿级别暴露了相同的自动添加行为，供需要非透视上下文中的ifmt索引的调用者使用。如果FormatStr为空，则会直接返回索引0（“常规”）。

**呼び出し元の使用方法。**

df := pivot.AddDataFieldByName('Revenue', xlpaSum);
Sheet.PivotSetDataFieldFormat(df, '$#,##0.00');
df := pivot.AddDataFieldByName('GrowthPct', xlpaAverage);
Sheet.PivotSetDataFieldFormat(df, '0.00%');

バージョン 2.80.1

**アイコンセットの条件付き書式設定が、HotXLSの保存/読み込みで問題なく処理されるようになりました。** v2.49.0の修正により、CF12ライターが、[MS-XLS] §2.4.43に従って、アイコンセットのルールに対してct=$06を出力するように変更されました（これは仕様に準拠した値であり、$05はフィルタールール用に予約されています）。しかし、対応するリーダー側では、依然として従来の$05の値しか認識されていませんでした。その結果、HotXLS v2.49.0～v2.80.0で作成された.xlsファイルを開き直すと、アイコンセットのルールが失われていました。ルールの種類が単純なセル比較ルールに劣化し、アイコンセットの種類/反転/表示のみフラグがデフォルト値にリセットされていました。現在、リーダーは$05（従来のHotXLSのv2.49.0以前のバージョン）と$06（仕様/v2.49.0以降）の両方をサポートしているため、どちらのバージョンのワークブックも問題なく再オープンされます。

バージョン 2.80.0

Programmatic pivot table creation API (wave H3, MAJOR). New IXLSWorksheet.AddPivotTable(SourceRangeA1, DestRow, DestCol, Name): TXLSPivotTable method walks the supplied source range, infers each column's data type from the cell values, auto-builds a TXLSPivotCache (or reuses an existing one bound to the same range), and creates a typed pivot table on the destination sheet with one TXLSPivotField per cache field (axes initially unset).
Caller wires axes / data via convenience methods. pivot.AddRowField('Region'), pivot.AddColumnField('Quarter'), pivot.AddPageField('Year'), pivot.AddDataFieldByName('Revenue', xlpaSum). SetFieldAxis + AddDataField are exposed for finer control. Field axis enum: xlpfaRowField / xlpfaColumnField / xlpfaPageField / xlpfaDataField / xlpfaNone. Eleven aggregation functions: Sum, Count, Average, Max, Min, Product, CountNums, StdDev, StdDevP, Var, VarP.
Typed writer emits SX* records + cache substream. When pivot.FromRawBlobs = False (the default for programmatically created tables), the writer serialises the typed model into SXView ($00B0) + SXVD ($00B1) per field + SXVI ($00B2) per item + SXIVD ($00B4) row/col index arrays + SXDI ($00C5) per data field + SXEx ($00C6) into the worksheet footer. The matching pivot cache (cache.FromRawBlobs = False) emits a fresh BOF (dt=$0006) + SXDB ($00C6) header + SXFDB ($00C8) + SXFDBType ($00FB) + per-item SXSTRING / SXNUM / SXBOOLEAN / SXERR / SXDATETIME / SXEMPTY + EOF substream appended after the worksheet bodies.
Round-trip safety preserved. Pivot tables and caches read from disk keep their wave H1 FromRawBlobs = True flag and continue to round-trip via the raw-byte path. Only the new programmatically created pivots flow through the typed writer. Mixed workbooks (one round-tripped pivot + one new pivot via AddPivotTable) emit both paths cleanly.
Wave H3 limitations. Source range types other than rectangular A1 (named ranges, external workbook refs) are out of scope. SXLI / SXPI (line items / page items) are not emitted for typed pivots — Excel computes them on Open. Formatting customisation (data field number format beyond per-field NumberFormat) is exposed as a field but the writer treats it as 0 (general). Multiple pivots sharing a cache are supported but caller must wire the same source range string each time.

バージョン 2.70.0

**ピボットテーブルの型付き読み込みモデル（H2ウェーブ）。** H1ウェーブで導入された生バイトの保持機能に加え、この機能では、呼び出し元がバイトコードの解析なしにピボットテーブルの構造を検査できるように、型付きオブジェクトモデルも構築されます。新しい型である `TXLSPivotTable`、`TXLSPivotField`、`TXLSPivotItem`、`TXLSPivotDataField`、`TXLSPivotCache`、`TXLSPivotCacheField`、`TXLSPivotCacheItem`、`TXLSPivotCaches`、`TXLSPivotTables` が、新しい `IXLSWorksheet.PivotTables` および `TXLSWorkbook.PivotCaches` プロパティを通じて提供されます。
**モデルが捉える内容：** 各ピボットテーブルについて、位置（最初の行/列/最後の行/列/最初のデータ行/最初のデータ列）、名前、データキャプション、キャッシュID、および順序付けられたFieldsリスト（それぞれに名前、軸∈{xlpfaRowField、xlpfaColumnField、xlpfaPageField、xlpfaDataField、xlpfaNone}、アイテム[]、サブ合計マスク、キャッシュフィールドインデックス）が含まれます。データ軸は、並行してDataFieldsリストを生成し、各リストには11個の値を持つTXLSPivotAggregation列挙型（xlpaSum / Count / Average / Max / Min / Product / CountNums / StdDev / StdDevP / Var / VarP）からのAggregationが含まれます。
**キャッシュモデル。** 各 `TXLSPivotCache` オブジェクトは、CacheId、SourceRange（シートと0ベースの行/列範囲）、RecordCount、および `Fields` のリストを保持します。各キャッシュフィールドは、データ型（xlpcftNumber / String / Boolean / Error / Empty / DateTime / Mixed）、名前、NumberFormat のインデックス、および一意の値を持つ Items[] を持ちます。各フィールドの Items[] 内のレコードごとのインデックスは、プログラムによって作成されたキャッシュの場合、`Cache.RecordIndices[Record, Field]` を介して公開されます。ディスクから読み込まれたキャッシュの場合、レコードごとのインデックスは設定されず、データの完全性を保つために生のバイトデータが使用されます。
**双向兼容性。** 从原始字节数据导入的透视表具有 `FromRawBlobs = True` 属性，写入器会完全按照原始状态重放 H1 格式的原始数据块。针对调用者进行内省的类型化模型会尽力进行填充。将模型转换为字节数据的类型化模型写入器仅适用于 H3 版本（通过编程方式添加透视表的 API）。
**新增了 `lxPivot.pas` 单元。** 所有透视表类型都位于自己的单元中，与 `lxChart`、`lxFormula` 和 `lxNames` 单元并列。`lxHandle` 重新导出公共类型，以便现有的导入保持正常工作。

バージョン 2.69.0

**ピボットテーブルのラウンドトリップ時のデータ保持 (H1ウェーブ)。** HotXLSは、Excelで作成された.xlsファイルがOpen→Saveの操作を経る際に、ピボットテーブルを構成するすべてのレコードを保持するようになりました。このリリース以前は、HotXLSの読み込みエンジンは、認識できないSX*レコード（SXView、SXVD、SXVI、SXIVD、SXLI、SXPI、SXDI、SXAddlなど）を無音で破棄し、ピボットキャッシュのサブストリーム全体をスキップしていました。そのため、Excelのピボットファイルを再保存すると、Excelを開くたびにピボットテーブルが破損していました。現在、読み込みエンジンはこれらのデータをそのままのバイト列として保持し、書き込みエンジンはそれを完全に再現するため、カバーシート上のピボットテーブルは、保存/再読み込みサイクル後もExcelで正しく表示されます。
**ワークシートのPIVOTVIEWブロック。** SX*ビューのレコード（$00B0–$00B2、$00B4–$00B6、$00C5–$00C8、$00D0–$00D2、$00D5、$00E3、$00F0、$00FB、$0100、$0864）は、ストリームの順序でキャプチャされ、ライターの各シートのフッターに書き込まれます（テーブルブロックと末尾のEOFの間）。これは、[MS-XLS] §2.1.7.20.1で定義されているワークシートABNFのPIVOTVIEWの位置と一致します。大きなSXAddlペイロードは、既存のContinue（$003C）スプリッターを介して、HFPictureと同じように送信されます。
**ピボットキャッシュのサブストリーム。** BOF (dt=$0006) の後に続く SXDB / SXFDB / SXFDBType / SXSTRING / SXNUM / SXBOOLEAN / SXERR レコードを、対応する EOF までまとめて1つのキャッシュバケットとして扱います。同じワークブック内の複数のキャッシュは、それぞれ独自のバケットを持ちます。保存時に、ライターは各キャッシュバケットの完全な BOF / レコード / EOF サブストリームを再構築し、[MS-XLS] §2.1.7.20 で規定されているように、各シートのデータセクションの後に、ワークブックの OLE ストリームにそれらを付加します。
**対象範囲：生データそのままの保持（H1）。** Wave H1 は、意図的にピボットデータを型付きモデルに解析しません。TXLSPivotTable / TXLSPivotField / TXLSPivotCache および、プログラムによるピボットテーブル追加機能 (AddPivotTable API) は、今後の Wave H2 / H3 で実装予定です。それまでの間、HotXLS を利用するアプリケーションは、ピボットテーブルの構造を検査したり変更したりできませんが、既存の Excel で作成されたピボットテーブルは、HotXLS を経由して問題なく読み書きできます。

バージョン 2.68.0

**グラフの未対応機能Fのサブ機能3：系列のエラーバー。** `TXLSChartSeriesInfo` に、`ErrorBars: TXLSChartErrorBarsInfo の配列` というフィールドが追加されました。各エントリは、親の Series ブロック内で、Trendlines の後、Series End の前に、呼び出し元の順序で SerErrBar レコード（[MS-XLS] §2.4.105、$105B）を生成します。Y軸のエラーバーを持つ典型的な棒グラフでは、2つのエントリが使用されます（Sertm=1 Y+ および Sertm=2 Y-）。散布図/バブルチャートでは、X+/X- のペア（Sertm=3 / 4）が追加されます。
**五つの値のソース。** `Ebsrc` は、1=パーセント、2=固定値、3=標準偏差、4=標準誤差、5=カスタムのいずれかを選択します。 `NumValue` は、その値を表します (Ebsrc=1 の場合、10.0 は 10%、固定値の場合はそのままの値、標準偏差の場合は乗数)。カスタムの場合 (Ebsrc=5)、`Cnum` フィールドはカスタムデータの点の数を持ちます。仕様では、他のソースの場合は `MUST=0` と定められており、そのため、この機能は、呼び出し元の入力に関係なく、カスタム以外のエントリに対して `Cnum` を常に 0 に設定します。
**T-cap 描画切换。** `FTeeTop` 控制是否在图表条的末端绘制 T 形盖帽（Excel 的默认视觉效果为启用）。当调用者希望使用更简洁的“仅刻度”样式时，此功能很有用。
**カスタム値シリーズ（Ebsrc=5）に関する注意点。** 最小限のビルダは、選択されたCnumと共にSerErrBarレコードを生成しますが、カスタム値配列を指すサポートとなるBRAIクラスタはまだ生成されません。そのため、カスタムのエラーバーは、将来のバージョンでBRAIフォロワーが実装されるまで、デフォルトのスケールで表示されます。パーセント、固定値、標準偏差、および標準誤差（Ebsrc 1～4）は、このリリースで完全に機能します。

バージョン 2.67.0

**チャートの未対応機能Fのサブ機能2：系列のトレンドライン。** `TXLSChartSeriesInfo` に `Trendlines: TXLSChartTrendlineInfo の配列` というフィールドが追加されました。各エントリは、親の Series ブロック内で、SerToCrt の後、Series End の前に、トレンドラインのレコード ([MS-XLS] §2.4.328、$2050) を生成します。1つの系列に複数のトレンドラインを設定することは有効であり、Excel はそれらすべてをレンダリングします。
**6種類の回帰タイプ。** `Regt` は、0=多項式、1=指数関数、2=対数関数、3=べき乗、4=移動平均、5=線形を選択します。多項式の場合、`NOrder` フィールドは次数 (2～6) を設定します。移動平均の場合、期間 (2～N) を設定します。他のタイプの場合、`NOrder` は無視されますが、仕様では 1～6 の範囲である必要があり、そのため、無効な値はそれぞれ 1 または 6 に設定されます。
**数式とR²の表示機能を追加し、予測機能も搭載しました。** `FDispEq` / `FDispRSqr` を使用すると、グラフ上に数式とR²のラベルを表示できます。 `NumForecast` / `NumBackcast` で、将来予測および過去予測の期間を設定します（数値、0以上）。 `NumIntercept` でy切片を設定します。 "自動"の場合は、NaN（$7FF8000000000000）を指定します。
**トレンドラインのラベルをインラインのLPWideStringとして表示します。** `Name`フィールドは、トレンドラインレコードのsNameスロットに書き込まれます（[MS-XLS] XLUnicodeString: cch:2 + grbit:1 + UTF-16 body）。名前が空の場合、Excelは「線形（シリーズ1）」のような凡例エントリを自動的に生成します。
**内部 `AddSeries` 函数的重构。** 内部 `AddSeries` 辅助函数现在接受单个 `TPreparedSeriesInfo` 对象，而不是以前的 (Name, CatArea, ValArea) 三元组，以便未来与 Series 相关的记录（下一阶段：误差线）可以通过一个参数传递，而无需进一步更改函数签名。

バージョン 2.66.0

**チャートのバックログフェーズF、サブ機能1：3Dチャートの種類。** プログラムによって作成されたチャートシートは、`AddChartSheet(Name, ChartType, ...)`を介して、`xlsChartType3DColumn`、`xlsChartType3DBar`、`xlsChartType3DLine`、または`xlsChartType3DPie`を要求できるようになりました。これらの3Dバリアントは、2Dバリアントと同じBARCHART/LINECHART/PIECHARTのチャートタイプレコードを使用しますが、周囲のCHARTFORMATブロックも、[MS-XLS] §2.4.46に従って、Excelの3Dレンダリングパイプラインを切り替えるためのChart3dレコードを生成します。
**デフォルトの3Dジオメトリは、Excelの「挿入 > 3D列」を模倣しています。** 20度の回転、15度の仰角、透視図オフ、クラスタリングオン、自動スケーリングオン、高さと奥行きはどちらも幅の100%、間隔は150%。壁と直角軸は、Excelのデフォルト設定と一致します。現在、このジオメトリはハードコーディングされています（呼び出し元からの設定変更は不可）。次の段階では、これをレコード形式のオーバーライドに移行できます。
**Chart3DBarShape ($105F) 在特定条件下已恢复。** v2.55.0 版本移除了无条件地生成 Chart3DBarShape，因为 [MS-XLS] §2.4.47 规定“必须忽略，如果当前子流不包含 Chart3d 记录”，而 2D 图表没有这种记录。Wave F 仅在 3D 条形图/3D 柱状图中恢复它（riser=rectangle，taper=none），并将其与 Chart3d 一起在 CHARTFORMAT 中发出，以便从底层布局中可见。3D 折线图和 3D 饼图仍然不生成它（没有 riser/taper 的概念）。
**3D Pieグラフでは、両方の軸が省略されます。** 軸の使用回数と軸の出力パスは、`xlsChartType3DPie`を`xlsChartTypePie`と同じように扱います。つまり、軸の使用回数は0で、カテゴリ軸または値軸は出力されません。この変更がないと、Excelはグラフから離れた軸線が伸びている3D Pieグラフをレンダリングしていました。

バージョン 2.65.0

Formula array constants round-trip with their data. PtgArray tokens ($20 / $40 / $60 — V / R / A class) in formula streams now carry their PtgExtraArray payload through both read and write paths. SUM({1,2,3}), =MMULT(...), {=COUNTIF(...)} and other array-literal formulas preserve the literal values in .xls files written by HotXLS instead of round-tripping with empty rgcb sections.
Array data hangs off the syntax tree. TXLSSyntaxItem grew ArrayCols / ArrayRows / ArrayValues properties (with the matching TXLSArraySerVal record describing num / str / bool / err / empty cells per [MS-XLS] §2.5.198.122 SerAr). Tools that walk the syntax tree can introspect array constants directly without needing the separate external-data container.
Programmatic array-literal construction. Code that builds TXLSSyntaxItem trees via the API can populate SA_ARRAY items with SetArrayDimensions + ArrayValues[i] and HotXLS emits the matching PtgExtraArray in the rgcb section automatically. The wire ordering matches the [MS-XLS] §2.5.198.59 rule that PtgExtraArray entries are sequenced by the position of their PtgArray token in the rgce stream.
Existing read path stays correct for mixed rgcb. The new code only consumes PtgExtraArray entries that correspond to PtgArray tokens it parsed; any other extra data (e.g. PtgExtraMem from PtgMemArea / PtgMemFunc, still unsupported) is left alone for downstream handling, and a malformed rgcb falls back to leaving array values empty rather than discarding the parsed tree.

バージョン 2.64.0

Chart backlog wave D phase 7: drawing theme color get / set round-trip within a process. Phase 5 introduced XlsApplyThemeColorToDrawing as a set-only helper because BIFF8 OfficeArt is a pre-Office-2007 binary format with no theme color slot on disk. The setter still down-casts to RGB for the on-disk OfficeArt opt blob, but the workbook now also keeps an in-memory side-table that remembers the original theme idx + tint per (TMsoShapeContainer, OfficeArt property id) pair. A new XlsGetDrawingThemeColor reader consults that side-table so the same process can pull back the theme intent it just wrote — useful for in-app render code that wants to highlight theme-driven colors or expose them in property panes. After Save / Open the side-table starts empty again and the getter returns False, falling through to ColorFormat.RGB.
New caller API. XlsGetDrawingThemeColor(ColorFormat, Workbook, out ThemeIdx, out Tint): Boolean joins the existing XlsApplyThemeColorToDrawing. The setter signature is unchanged; it now also records the entry into TXLSWorkbook.FDrawingThemeColors (a dynamic array of records keyed by container pointer + property id). Subsequent XlsApplyThemeColorToDrawing calls on the same slot overwrite the entry, so the table tracks the latest intent rather than accumulating history.
Stable identity through new internal properties. TXLSColorFormat grew read-only _Container and _Pid accessors so the helpers can compose the side-table key without the caller fishing private fields out of the class. Underscore prefix marks them as the same internal-API tier as _StringTable / _XFList / _BiffTheme: stable enough for library glue code, not part of the public contract.
Why this is "single-process round-trip" only. The BIFF8 OfficeArt format only stores indexed / RGB / scheme / sysColor in its 4-byte ColorRef; there's no extension record analogous to XFExt $087D where the theme idx + tint could live. So the disk round-trip cap is structural, not a HotXLS gap. The Phase 7 side-table bridges the in-process gap so app-internal code can pretend the format supports theme colors as long as it lives within one workbook session.

バージョン 2.63.0

Chart backlog wave D phase 6: compound border selectors round-trip RGB / theme through XFExt. The last theme-color known-limit is closed: Border[xlAround], Border[xlInsideVertical], Border[xlInsideHorizontal], and Border[xlInsideAll] now register the same RGB or theme color against every physical edge slot they target instead of falling back to the indexed-palette path. The new TXLSXfRichSlotSet (set of TXLSXfRichSlotID) lifts the pending-rich stash from a single slot to a set, so one cell-loop pass on SetRangeXFBordersProperty registers up to four XFExt slots in one go.
Compound selector mapping. The new BorderEdgeSlotSet(BorderIndex): TXLSXfRichSlotSet helper centralises the selector → slot translation: xlEdgeLeft / Right / Top / Bottom → singleton sets (unchanged from phase 2); xlDiagonalDown / Up → [rsDiag]; xlAround → [rsTop, rsBottom, rsLeft, rsRight]; xlInsideVertical → [rsLeft, rsRight]; xlInsideHorizontal → [rsTop, rsBottom]; xlInsideAll → [rsTop, rsBottom, rsLeft, rsRight]. Border.SetColor and Border.SetThemeColor share the same mapping, so RGB and theme paths behave identically across all selectors.
TXLSBorders.SetColor restored to a single dispatch. Phase 2 had to fan Borders.Color := V out to four per-edge GetBorder(edge).Color := V calls because the pending-rich stash only carried one slot at a time. With the set form, Borders.SetColor now stashes the full {rsTop, rsBottom, rsLeft, rsRight} set and calls SetColorIndex once — SetBordersColorIndex takes the optimal wire path (single cells loop with BorderMask=15), and ConsumePendingRichSlot registers all four XFExt slots on each touched XF in the same pass. ~4x fewer cell-loop iterations than the phase-2 fan-out, byte-identical XFExt result.
ConsumePendingRichSlot iterates the set. The slot-registration loop walks the eight enum members and dispatches each one present in FPendingRichSlot through RegisterXFExtSlot. Boundary cells whose XF didn't actually change during a compound-selector update still fire the callback — that's harmless because the XFExt slot is only visually relevant when the cell genuinely has the matching border line, and the indexed wire is set by the per-cell BorderMask Excel already understands.

バージョン 2.62.0

**グラフの未対応機能Dフェーズ5：カスタムテーマXMLの往復処理と描画テーマヘルパー。** 3つの機能が、フェーズ4で残されたテーマカラーのギャップを埋めます。Excelでページレイアウトから設定したカスタムテーマのカラーパレットが、ロードサイクルを乗り越えて保持されるようになりました。パーサーは、BIFF8の`$0892`テーマレコードに埋め込まれたOOXMLの``を解析し、ワークブックの12スロットの`FBiffTheme`を更新します。対応する書き込み機能は、パレットがデフォルトのOfficeのスキームからずれている場合に同じレコードを生成するため、ユーザーがカスタマイズしたテーマは、デフォルトに戻ることなくHotXLSを介して往復処理されます。新しい`XlsApplyThemeColorToDrawing`ヘルパーにより、グラフ/シェイプの呼び出し元は、セルで使用しているテーマインデックスと彩度という語彙と同じものを使用して、描画の色を指定できます。
**OOXMLテーマXMLの解析:** `ParseTheme`関数将记录主体（frtRefHeaderU + dwThemeVersion + 可变长度的XML负载，可能跨越继续记录）拼接成单个字节缓冲区，然后针对性地扫描查找十二个`<a:clrScheme>`子元素（`dk1, lt1, dk2, lt2, accent1..6, hlink, folHlink`）。对于每个槽，它优先使用`<a:srgbClr val="RRGGBB"/>`，如果找不到则回退到`<a:sysClr ... lastClr="RRGGBB"/>`，然后将`RRGGBB`转换为HotXLS的COLORREF布局，并调用`FBiffTheme.SetThemeRGBColor`。如果记录主体看起来不像OOXML（缺少`<a:clrScheme>`标记，ZIP压缩变体等），则将调色板保留在其默认方案，以确保常见的渲染效果正确。
**Writer: 主题记录生成，默认情况下跳过。** `TXLSWorkbook.StoreTheme` 仅在 `IsBiffThemeDefault` 指示调色板已偏离 Office 默认方案时，才会生成 `$0892` 记录。OOXML 主体是从一个确定的模板构建的，包含十二个 `` 条目（相对于 Excel 原生的 sysClr 形式，因为它可以与相同的解析器进行双向转换，而无需 sysColor 名称解析器），以及模式要求的最小的 `` / `` 部分。未修改的工作簿不会生成任何记录，并且与 Phase 5 之前的输出保持字节兼容。
**描画テーマカラーのヘルパー機能。** 新しい無料関数 `XlsApplyThemeColorToDrawing(ColorFormat, Workbook, ThemeIdx, Tint)` は、ワークブックのパレットを通じてテーマインデックスと色相を解決し、結果のRGB値を `TXLSColorFormat` (図形の塗りつぶし/線/グラフの色) に書き込みます。 BIFF8 OfficeArt は、Office 2007 より前のバイナリ形式であり、ネイティブのテーマカラーエンコーディングを持たないため、これは設定専用です。読み出し時に、テーマのスロットではなく解決されたRGB値が返され、テーマ参照はディスク上で失われます。完全なテーマのラウンドトリップには、セルに対して `IXLSInterior.SetThemeColor` / `IXLSFont.SetThemeColor` / `IXLSBorder.SetThemeColor` を使用し、これにより XFExt $087D が利用されます。
**Wave D 完全に5つの段階で完了しました。** 1段階目（v2.58.1）では、テーブル形式の注釈機能を追加しました。2段階目（v2.59.0）では、RGB カラーのセルに対応する XFExt を実装しました。3段階目（v2.60.0）では、RGB リーダーの処理を完了しました。4段階目（v2.61.0）では、セルにテーマカラーのパスを適用しました。そして、5段階目（今回）では、カスタムテーマ XML の丸め処理と、描画側のヘルパー機能を実装し、完了しました。これにより、セルは BIFF8 仕様で表現可能なあらゆるパレット/RGB/テーマカラーの組み合わせにおいて、Excel のレンダリングとピクセル単位で一致するようになりました。描画オブジェクトはヘルパーによって視覚的な意図を維持しますが、読み込み時には OfficeArt 形式の RGB のみを使用するという制約があります。

バージョン 2.61.0

Chart backlog wave D phase 4: BIFF8 theme color support (theme idx + tint via XFExt $087D). Office's 12-slot theme palette (lt1, dk1, lt2, dk2, accent1..6, hlink, foHlink) now round-trips on the .xls side: callers can address theme colors directly with the new Interior.SetThemeColor(themeIdx, tint) / Interior.SetPatternThemeColor / Font.SetThemeColor / per-edge Border.SetThemeColor APIs, and the cell color getters resolve the same theme idx + tint back through the workbook's BIFF theme palette when reading. The XF record still receives a best-match indexed icv (so legacy readers like Excel 2003 keep rendering an approximate color), while Excel 2007+ recovers the exact theme intent through the XFExt FullColorExt (xclrType=3) future-extension record — same backward-compatibility trick Microsoft uses when "Save As" downgrades a theme-styled .xlsx to .xls.
New caller API. Five new SetThemeColor entry points join the existing RGB / index setters: IXLSInterior.SetThemeColor(ThemeIdx, Tint), IXLSInterior.SetPatternThemeColor(ThemeIdx, Tint), IXLSFont.SetThemeColor(ThemeIdx, Tint), and IXLSBorder.SetThemeColor(ThemeIdx, Tint) on each border edge. ThemeIdx is the 0-based theme slot (0=lt1, 1=dk1, 2=lt2, 3=dk2, 4..9=accent1..6, 10=hlink, 11=foHlink); Tint is the spec-style -1.0..+1.0 lighter/darker adjustment that gets encoded into FullColorExt.nTintShade as Q15 signed integer.
Workbook BIFF theme palette. TXLSWorkbook now carries an FBiffTheme: TXLSThemeColors initialised to the default Office theme scheme that the XLSX side has used for years through TXLSColorManager.FTheme. Cell color getters resolve theme idx + tint through this palette via GetThemeRGBColor(idx, tint) (which already applies HSL-based tint adjustment in lxRgb.GetRGBTInt). Internal _BiffTheme property exposes the palette for parser-side updates.
Theme record ($0892) acknowledged on read. lxRead.ParseTheme takes $0892 out of the default-skip path so the workbook-globals case table treats it as a known record. The embedded OOXML theme XML body itself is left unparsed for now — the 12 default Office theme colors already match the most common source and Excel-set theme cells render correctly through them. Workbooks with a fully customised theme will surface theme cells through the default palette here (documented known limit; XML-based theme parsing is a follow-up wave).
Why no Theme record on write. HotXLS-saved .xls files don't emit a Theme record. Excel 2007+ falls back to the default Office theme when no $0892 is present, which exactly matches HotXLS's FBiffTheme default scheme, so cells using SetThemeColor render with the right color in Excel without us having to ship the embedded XML. Files therefore stay smaller and the writer side has no XML-emit dependency.

バージョン 2.60.0

Chart backlog wave D phase 3: XFExt ($087D) read-side RGB / theme recovery closes the round-trip. The Phase 1 acknowledgement and Phase 2 emitter are now joined by a parser that actually consumes each $087D record into the workbook XF rich-color side-table. Files saved by Excel with RGB cell colors (fill, font, individual borders) now surface through cell.Interior.Color / Interior.PatternColor / Font.Color / per-edge Border.Color at the exact RGB Excel wrote, instead of the indexed-palette approximation HotXLS used to return for the same cells. Wave D is now fully closed in both directions.
Reader: ParseXFExt walks ixfe + cexts + rgExt. The parser handles the eight color ExtProp extTypes ($0004 fillFg, $0005 fillBg, $000D font, $0007/$0008/$0009/$000A/$000B for top / bottom / left / right / diagonal borders) and decodes each one's FullColorExt body (xclrType, nTintShade as signed Q15, xclrValue). xclrType 2 (RGB) and 3 (theme) get registered on the workbook side-table against the record's ixfe; other extTypes ($0006 FillGradient, $000E FontScheme, $000F TextIndent) skip cleanly so a future wave can add them without disturbing this code path. Defensive bounds checks on cb mean a malformed record terminates parsing of its tail without reading past the declared length.
Cell color getters consult the side-table first. The eight color getters that previously routed straight through the indexed-palette path (GetCustomColor(GetColorIndex)) now resolve their XF index, query TlxFormatList.TryGetRichSlot for the matching rich-color slot, and apply nTintShade via the existing GetRGBTInt helper when the slot carries an RGB value. xclrType=3 (theme) falls through to the indexed path: the BIFF workbook has no theme model on this call chain, so the palette approximation remains the best available answer for theme cells. Cells whose XF was never touched by a Phase 2 setter or a parsed XFExt produce the same byte-identical read result as before.
Wave D is closed. Save preserves caller-set RGB (Phase 2). Load preserves Excel-set RGB (Phase 3). Workbooks with no rich color information emit the same byte stream as before. The only remaining caveats stay documented as known limits: theme colors still down-grade through the BIFF palette because there is no theme color manager on this side of the codebase, and compound border selectors (xlAround / xlInside*) tag a single ambiguous side-table slot rather than per-edge — both rare enough to leave for a future wave.

バージョン 2.59.0

Chart backlog wave D phase 2: XFExt ($087D) emission for BIFF8 cell colors. When application code sets cell.Interior.Color := $00FF6633 (or any other RGB) on the BIFF8 path, the writer now emits a $087D XFExt record alongside the indexed-palette XF entry so Excel reopens the workbook with the exact RGB the caller passed in, rather than the closest 56-color palette approximation HotXLS used to fall back to. Covers all four cell color surfaces: Interior.Color / Interior.PatternColor / Font.Color / per-edge Border.Color (top / bottom / left / right / diagonal) and the convenience Borders.Color which now distributes to the four primary edges so each gets its own XFExt slot.
How the round-trip stays safe. The BIFF8 cell setter chain still produces the indexed-palette XF wire output it always did — readers (HotXLS or anything else) that ignore $087D see the legacy approximation. The XFExt record sits next to the XF and carries the original RGB as a 16-byte FullColorExt (xclrType=2, xclrValue=$00BBGGRR, nTintShade=0) wrapped in an ExtProp with the spec-correct extType for each slot ($0004 fillFg, $0005 fillBg, $000D font, $0007/$0008/$0009/$000A/$000B for top/bottom/left/right/diagonal borders). Cells that never took the color-setter path still emit no XFExt — workbooks with no rich colors produce the same byte stream as before.
Storage and bookkeeping. A new per-XF rich-color side-table in TlxFormatList holds the original RGB / theme info the cell setter passed in, keyed by the workbook's hash-resolved XF index. TXLSRange.SetXFProperty / SetRangeXFBordersProperty grew an optional OnNewIndex callback so the cell setter can register the rich color against every XF index the cell ends up on (multi-cell ranges that hash to multiple distinct XFs all get tagged). The side-table is consulted in StoreWorkbook right after STYLES and before PALETTE, matching the *XFExt position in [MS-XLS] §2.1.7.20.3 Workbook Globals ABNF. xlExcel5 output is untouched (BIFF5 has no XFExt record).
Known limit. The reader side stays at the wave-D-phase-1 acknowledgement: ParseXFExt consumes $087D records from the input stream but does not yet feed the recovered RGB back into the workbook's style objects, because doing so in the hash-keyed style model risks invalidating existing XF entries. Files saved by HotXLS now look correct in Excel; files coming in from Excel still surface the indexed-palette approximation when read back through cell.Interior.Color. Closing that read-side gap is a separate follow-up (Phase 3) that requires reworking the style hash to admit per-XF rich color before the first hash anchor.

バージョン 2.58.1

Chart backlog wave D (read-side acknowledgement only): XFExt ($087D) no longer routed through the default-skip path. A new ParseXFExt branch in the BIFF8 workbook-globals case table consumes $087D records that Excel writes alongside RGB and theme-colored cell styles. The reader still leaves the indexed-color XF record unchanged — full RGB / theme precision recovery onto the workbook's hash-key style model is deferred to a separate wave because it would require the BIFF writer-side style classes to grow an RGB / theme color field that doesn't exist today. Files coming from Excel with rich colors continue to load with the indexed approximation HotXLS has always produced, but the spec-conformance gap of "treating $087D as unknown" is closed.
Why not the full wave-D scope. The plan envisioned a paired write + read implementation, but exploration found that the BIFF write pipeline (TXLSWorkbook.FXFList: TlxFormatList) encodes XF style data as a string-key with hex-packed indexed color slots and has no analogue of the XLSX-side TXLSStyleColor (which carries ColorType / ColorValue / TintAndShade). Adding XFExt emission would mean either bridging the two style models or extending TlxFormatList with per-XF rich color side-tables, both of which are larger refactors than a single wave can absorb. The change here therefore stays surgical: lxRead recognises the record, lxStyleXf and lxHandle are unchanged.

バージョン 2.58.0

Chart backlog wave C: SST rich-text and phonetic round-trip (BIFF8 XLUnicodeRichExtendedString). Rich-text formatting set in Excel (a cell whose individual characters carry their own font / color, the "two colors in one cell" effect from the Format Cells dialog) sits in the shared string table as an XLUnicodeRichExtendedString with an attached rgRun FormatRun array. Far-East phonetic info (the furigana / hiragana annotation above kanji) attaches as an rgExtRst block on the same record. HotXLS previously dropped both on load and re-emitted the string as plain text on save, so opening then resaving a workbook flattened every multi-format cell to a single font / color. The shared-string parser now preserves both trailing blocks per unique string, and the writer re-attaches them when the string fits a single SST record.
Reader walks Continue boundaries without re-reading flag bytes. A new CollectRawTail helper inside ParseSST pulls the raw rgRun bytes (cRun × 4 bytes per FormatRun) followed by the raw rgExtRst bytes, spilling across Continue ($003C) records as needed — neither block is re-prefixed with the string's flag byte at a Continue boundary per [MS-XLS] §2.4.58, which the old per-byte skip logic could not preserve correctly when rt or sz overshot the current record. The preserved tails are registered against the workbook SST through the new TXLSStringTable.AddWithExtras, which deliberately does not bump the cell-reference counter so subsequent LabelSST parsing still produces correct cstTotal on save.
Writer attaches fRichSt / fExtSt + cRun / cbExtRst + rgRun + rgExtRst when the whole record fits in one BIFF chunk. AddSSTItem now factors the rich / phonetic tail size into its overflow check; strings whose body + tails fit a single 8224-byte SST chunk emit the full preserved layout, and Excel re-opens the workbook with the original formatting intact. Strings that overflow fall back to plain text without formatting (the splitter would otherwise need to interleave Continue flag bytes with the still-running rgRun byte stream, a state machine the current writer doesn't have); this is the explicit known limitation documented in the wave-C plan and affects only very long rich-formatted strings (> ~4000 wide chars).
Continue flag byte corner case fix (carried over from the v2.54.0 SST audit). Per [MS-XLS] §2.4.58 the leading flag byte of an SST Continue record carries only the fHighByte bit (bit 0); bits fExtSt (bit 2) and fRichSt (bit 3) MUST be ignored because those structures exist exactly once at the head of the first record. ParseSST now masks the Continue flag byte with $01, preventing a stray high bit from making the reader skip ahead 2 or 4 bytes looking for cRun / cbExtRst fields that aren't there and misaligning every byte that follows.

バージョン 2.57.0

**チャートの未対応項目G：ヘッダー/フッターの画像がラウンドトリップで保持される（BIFF8 HFPicture）。** Excelで、ヘッダーまたはフッターの背景画像を含むワークシートを保存する場合（挿入 → ヘッダーとフッター → 画像、例えば会社のロゴスタイル）、画像は`HFPicture`（$086C）レコードに格納され、OfficeArt BLIPが埋め込まれます。以前のHotXLSでは、このレコードに対する処理が実装されていなかったため、ロード時にすべてのデータが破棄され、ワークブックを再度保存するとヘッダー/フッターの画像が失われていました。現在、リーダーは各シートで完全なレコードの内容（すべての継続チャンクを連結）を保持し、ライターは仕様に準拠した位置にそれを再出力するため、Excelは元の画像が保持された状態でファイルを再度開くことができます。
**リーダーは、ペイロードを保存する前に、すべての「続行」チャンクを連結します。** `ParseWorksheetRecord` 内の新しい `ParseHFPicture` ブランチでは、結合された `DataList` のすべてのエントリ（スロット 0 の $086C データ本体に加えて、続く可能性のある任意の数の $003C データ本体）を処理し、結合されたバイトを単一の `TBytes` オブジェクトとしてワークシートに保存します。1つのシートには、Excel の UI では最大 6 つのエントリ（デフォルト / 最初の / 偶数ページ × 左 / 中央 / 右）が含まれる可能性があるため、ストレージは単一のフィールドではなく配列として実装されています。
**Writer は、PageSetup の直後に HFPicture レコードを生成し、既存の Continue スプリッタによって BLIP のオーバーフローが処理されます。** 新しい `StoreHFPictures` ステップが、各シートのストアシーケンスに `StoreSetup` の直後に挿入され、[MS-XLS] §2.1.7.20.2 のワークシート ABNF における `*HFPicture` の位置と一致します。保存された各データは、新しい $086C ヘッダーでラップされ、`AppendData` を介して送信されます。既存の `AddContinue` ヘルパーは、BLIP が 8224 バイトの BIFF 制限を超える場合に、その処理を引き継ぎます。これにより、30〜50 KB の JPEG 画像が、Excel が書き込むのとまったく同じように、1 つの $086C レコードと、さらに 4〜6 つの $003C レコードに分割されます。
**公开API接口未有新增。** Wave G是一个双向保留功能；HFPicture内容对应用程序代码是不可见的（没有公开的setter方法用于注入新的页眉图像）。那些从未包含HFPicture记录的工作簿，其输出结果与之前完全相同。内部辅助函数`TXLSWorksheet._AddHFPictureBlob`仅供读取器使用；下划线前缀以与`_Drawing` / `_Autofilter`相同的方式标记它。

バージョン 2.56.0

**チャートの未対応機能B：ワークシートタブの色に関する双方向対応（BIFF8 SheetExt）。** Excelで右クリックから設定できるワークシートタブの色が、BIFF8のパスを通じて読み書きできるようになりました。 `TXLSWorksheet.TabColor`は、新しい公開プロパティで、HotXLSの`LongWord`形式の色を受け取ります（下位バイト=R、中間バイト=G、上位バイト=B、最上位バイト=0。`Font.Color`または`Interior.Color`と同じ形式）。デフォルト値`0`は「自動/タブに色なし」を意味し、レコード全体を省略します。
**Writer は、各シートごとに SheetExt レコード ($0862) を生成します。** TabColor がゼロでない各シートについて、1 つの 48 バイトのレコードが、ファイルの末尾 (EOF) の直前にワークブックのグローバルストリームに追加されます。レイアウトは [MS-XLS] §2.4.282 SheetExt v1 および §2.5.108 FullColorExt に従います。具体的には、12 バイトの frtRefHeaderU + 4 バイトの cb + 4 バイトの予約フィールド flagsTab1 + 16 バイトの FullColorExt ブロック (xclrType=2 RGB、nTintShade=0、xclrValue=タブの色) + 4 バイトの iTabId (対応する BoundSheet8 の 0 ベースのストリーム順序) + 4 バイトの予約フィールド flagsTab2 です。iTabId は、BoundSheet ブロックと同じ反復順序を使用するため、マルチシートワークブック全体で整合性が保たれます。xlExcel5 の出力は変更されません (BIFF5 には SheetExt レコードはありません)。
**起動時に、リーダーがタブの色を復元します。** `ParseWorkbookRecord`のケーステーブルに、新しい`ParseSheetExt`ブランチが追加され、`iTabId`とFullColorExtブロックを読み込み、解決されたRGB値を`Sheets[iTabId + 1].TabColor`に書き戻します。 `xclrType=2`（RGB）は生の値を格納し、`xclrType=1`（インデックス付きicv）はワークブックのパレット（`Colors[icv, 0]`）を介して解決されるため、アプリケーションはExcelがどのようにエンコードしたかにかかわらず、具体的なRGB値が表示されます。 `xclrType=0`（自動）と`xclrType=3`（テーマ）は、`TabColor`をデフォルト値`0`のままにし、書き込み側の「タブに色がない」という意味と一致します。
**ラウンドトリップの例。** `Workbook.Sheets[1].TabColor := $00FF00`（緑：B=0、G=$FF、R=$00）をSaveAsで.xls形式で保存すると、Excelで開くとタブの色が緑になります。その後、同じファイルを再度保存して開き直すと、タブの色が元の`$00FF00`に戻ります。Excelから読み込まれたファイルで、タブの色が1つ以上設定されている場合、以前はすべてのタブが自動色にリセットされていましたが、現在はその色を保持したまま開くことができます。

バージョン 2.55.1

**メインブランチのビルドを復元しました。** HotXLSがRAD Studio 12以降でコンパイルできなくなる原因となっていた、2つの既存の識別子エラーが修正されました。これらのエラーは、以前のバグ修正リリースで導入されましたが、コンパイルチェックが施されていなかったため、次の貢献者がパッケージを再構築しようとしたときに初めて問題が表面化しました。
共有数式マルチカラムライターは、存在しないレコードフィールドを参照しなくなりました。v2.50.0のSHRFMLAワイヤフォーマット修正で、`WriteShrfmla`に`Data.AddByte(Group.LastCol)`が追加されましたが、新しいフィールドで`TXLSShrfmlaGroup`が拡張されなかったため、コンパイル時に「未定義の識別子: LastCol」というエラーが発生していました。レコードは、既存の`FirstCol`とともに`LastCol`を持ち、`CollectSharedFormulas.OpenGroup`は、グループのアンカー列でそれを設定します。シングルカラムの共有数式グループ（現在コレクターが生成する唯一の種類）の動作は変更されていません。仕様に準拠した`colLast`バイトが、以前は`colFirst`のエイリアスでしたが、現在は実際の値になります。
`XlsxFloatToStr`関数は、前方宣言を通じてXLSXセルライターによって参照されます。v2.51.0で導入されたローカライズ安全対策により、セル値の処理部分（2718行目）で`XlsxFloatToStr`が呼び出されますが、このヘルパー関数は数百行下の位置（2910行目）で定義されています。前方宣言がない場合、Delphiのシングルパスコンパイラは「未定義の識別子：XlsxFloatToStr」というエラーを報告します。そのため、前方宣言を`lxHandleX`の実装ブロックの先頭に配置し、早期に呼び出される箇所と既存の定義の両方が正常にコンパイルされるようにしました。

バージョン 2.55.0

**グラフ機能の改善（A波）：複数シリーズのキャッシュ処理の改善 + グラフ/軸のタイトル表示機能の追加。** 以前から存在していた2つのグラフ作成機能の制限が修正されました。これらはすべてv2.54.0の改善リストに含まれています。最初の変更は出力側の変更であり、APIの変更はありません。2つ目の変更は、既存の`AddChartSheet`のTitle/CatAxisTitle/ValAxisTitleパラメータに影響を与え、以前は機能していませんでした。
**各系列值的缓存，不再截断到 Series[0]。** [MS-XLS] §2.1.7.20.1 图表工作表 ABNF 允许 `*(SIIndex *NUMBER)`，即每个系列对应一个 `SIIndex(1) + N×NUMBER` 块。之前的构建器只生成一个大小由 `Series[0].ValArea` 确定的缓存块，因此，任何后续具有更长值范围的系列，其缓存槽会被静默地截断。现在，构建器 (a) 计算所有系列中 `DIMENSIONS` 行范围内最大点数，(b) 遍历每个已准备好的系列，生成一个独立的 `SIIndex(1)` 块，其 `NUMBER` 计数与该系列的 `AreaPointCount(ValArea)` 匹配。缓存槽保持零值（BRAI `PtgArea3d` 引用仍然在绘制时解析到原始单元格）；此更改的目的是为 Excel 的严格解析器提供完整的缓存信息。
**グラフのタイトル、カテゴリ軸のタイトル、値軸のタイトルのテキストが正しく表示されます。** 最初の実装では、`AddChartSheet` のオーバーロードで3つのタイトルパラメータを受け入れていましたが、何もせずに破棄していました（"Junk := Length(...)" のプレースホルダー）。現在は、仕様に準拠した位置で、`CHART` コンテナの End レコードの直前に、適切なアタッチラベルブロックを生成します。このブロックは、`TEXT` ($1025) + `POS` + `BRAI`-リテラル-tStr + `SeriesText` ($100D) + `OBJECTLINK` ($1027) + End で構成されます。`OBJECTLINK.wLinkObj` は、[MS-XLS] §2.4.182 に従って、グラフタイトルには 1、値軸のタイトルには 2、カテゴリ軸のタイトルには 3 を使用します。`Title := 'Quarterly Sales'` を設定した呼び出し元は、Excel のプロット領域の上部に "Quarterly Sales" が表示されるようになります。

バージョン 2.54.1

**[MS-XLSX] 監査結果のフォローアップ。** v2.52.0 の監査で「保留」リストにされていた、2つの重要な修正が実装されました。どちらもユーザーに影響を与えますが、既存の機能に悪影響はありません。
**日付セルは、任意の単一の非数値スタイルと組み合わせる際に、日付形式を維持します。** `FontIndex`、`FillIndex`、`BorderIndex`、`AlignmentIndex`、`ProtectionIndex` が設定されているが、明示的な `NumberFormatIndex` が使用されていない `TDateTime` セルは、`numFmtId` が 0 (汎用) の単一次元のセルXf を経由するため、Excel はセルを生のシリアル番号 (例: `46038`) としてレンダリングし、`1/15/2026` のように日付としてレンダリングされませんでした。 XLSX スタイルエンジンは、暗黙的な日付を仮想次元として扱います。他のスタイルが適用された次元は、実際の次元とともに `numFmtId=14` を持つ複合セルXf にセルを変換します。他のスタイルがない純粋な日付セルは、以前と同様に `XlsxXfIndexDate` にルーティングされます。新しい公開インターフェース: `TXLSXWorkbook.RegisterCompositeXf` および `GetCompositeXf` には、OOXML の組み込み `numFmtId` をオーバーライドできる 7 引数のオーバーロードが追加されました (既存の 6 引数のシグネチャは変更されておらず、オーバーライドが無効な新しいバリアントにフォワードされます)。
Excelの命名規則に違反するシート名は、自動的に修正されます。Excelは、31文字を超えるシート名、または: \ / ? * [を含むシート名を拒否します。また、シングルクォートで始まるまたは終わるシート名、予約語History（大文字と小文字を区別しない）、または他のシート名と重複するシート名も拒否されます。以前のバージョンでは、HotXLSはユーザーからの入力をそのまま使用していたため、例えばWorkbook.Sheets.Add('Q1:Q2 Sales')のような呼び出しで、無効な名前のエラーが表示されるワークブックが作成されていました。`TXLSXSheets.Add`は、新しいヘルパー関数XlsxSanitizeSheetNameを使用してシート名を修正します（禁止文字はアンダースコアに置き換えられ、前後のシングルクォートは削除され、長さは31文字に制限され、空または予約済みの場合は'Sheet'に置き換えられます）。また、大文字と小文字を区別せずに他のシート名と重複する場合、' (2)'または' (3)'というサフィックスが追加されます。すでに有効な名前の場合は、変更されません。したがって、準拠した.xlsxファイルから解析されたシートは、変更せずに元の状態に戻ります。

バージョン 2.54.0

**第2回、基于 [MS-XLS] v20250520 / [MS-OFFCRYPTO] v20240820 的深入规范审查。** 八名独立的审查员发现了八个与工作表结构记录、SST/Continue 边界、公式 PTG 深度、加密填充、图表记录、绘图/注释写入以及透视表/表格支持相关的 corner-case / 格式缺陷。公共 API 未改变；现有代码可以不修改地重新编译。
**Comment Note レコードが、仕様に準拠するようになりました。** TMsoDrawing.StoreNotes 内に、[MS-XLS] §2.4.179 Note で説明されている、2つの異なる修正が適用されました。(1) idObj が、以前は LongWord (4 バイト) として記述されていたものを、Word (2 バイト) として記述されるようになりました。これにより、idObj の後のすべてのバイトがずれるという問題を修正しました。(2) 以前は存在しなかった、XLUnicodeString フィールドである stAuthor が、FAuthor からシリアル化されるようになりました (cch + フラグ + UTF-16 ボディ)。Excel の厳格なリーダーは、Note の解析を stAuthor で終了するため、これがないと、Excel がファイルを開ける場合でも、コメントのメタデータがラウンドトリップで破損していました。
**`Visible`プロパティの動作が変更され、意図が反転しなくなりました。** `TMSOShapeTextBox.GetVisible` / `SetVisible` は、`fHidden` が設定されている場合に True を返していました。また、呼び出し元がコメントを表示するように要求すると、`fHidden` が保存されていました。ビットの意味は逆でした（[MS-XLS] §2.4.179 grbit bit1: 1 = hidden）。以前、`Comment.Visible := True` を使用すると、非表示のコメントが表示されていましたが、現在はプロパティ名が示すように、両方の方向で動作します。
**RC4パスワードの導出処理が、16文字以上のパスワードに対して正しく動作するようになりました。** [MS-OFFCRYPTO] §2.3.6.1では、MD5の単一ブロックメッセージ長フィールドを、64ビットのリトルエンディアン形式で、バイト56～63に格納しています。以前の読み込み（lxDecryption）および書き込み（lxEncrypter）処理では、両方ともSetByteを使用して下位バイトのみを書き込んでおり、16文字以上のパスワードの場合、上位バイトを無音で破棄していました（ビット数 ≥ 256）。長いパスワードを使用したファイルでは、両側で同じValDigestが導出されるようになり、以前は正しい場合でも長いパスワードが拒否されることがありましたが、HotXLSで暗号化されたファイルで長いパスワードが使用されている場合、再オープンできなかった問題が修正されました。
`tFuncVar` トークンは、関数名検索時にfCeFuncビットをマスクします。[MS-XLS] §2.5.198.63では、末尾の単語をtab(15 low) + fCeFunc(1 high)に分割します。以前は、この完全な単語がItem.IntValueとして保存され、ハッシュテーブルのキーとして使用されるため、ユーザープロンプトフラグ（マクロ/UDF呼び出し）を持つ関数は$8000 | iftabにハッシュされ、空の関数名が生成され、数式全体が無効になりました。現在、$7FFFでマスクされています。
**複数のFILEPASSレコードが、最初のレコード以降は無視されるようになりました。** [MS-XLS] §2.4.117では、最大で1つのFILEPASSのみが許可されています。悪意のある、または不正な形式のワークブックにおいて、2つ目のFILEPASSレコードが使用されると、暗号化プロセスが中断され、新しい鍵ストリームが生成され、これによりデータとの同期が失われることがありました。今後は、そのようなFILEPASSレコードを検出し、警告なしに無視し、暗号化プロセスは引き続き実行されます。
**PtgArray Vクラスのオペコードが正しく出力されます。** 以前は、`GetArrayData(aClass=0)` が Aクラスのオペコード ($60) に誤って処理されていましたが、[MS-XLS] §2.5.198.32 によれば、Vクラスのオペコードは $20、Rクラスは $40、Aクラスは $60 です。 `aClass=0` が正しく $20 にマッピングされるようになりました。
2DグラフでChart3DBarShapeが生成されなくなりました。 [MS-XLS] §2.4.47では、Chart3DBarShapeは「現在のサブストリームにChart3dレコードが含まれていない場合、無視される必要があります」と規定されています。HotXLSはまだ3Dグラフの種類をサポートしていません（Chart3dレコードは生成されません）。そのため、DataFormatブロック内に空のChart3DBarShapeを記述することは、冗長であり、仕様に反していました（空のペイロードは2バイトのリザーバー+テーパーのレイアウトにも適合しません）。このレコードは、今後完全に省略されます。
TechnicalNotes.mdに監査の未対応事項が記録されています。第2回の監査で明らかになった、より大きな仕様のギャップ（XFExtレコードが生成されない、PtgArray定数データがシリアル化されない、グラフのタイトル/カテゴリ軸タイトル/値軸タイトルのパラメータが削除される、シリーズごとのグラフキャッシュ、ピボットテーブル/クエリテーブル/DConnがサポートされていないなど）は、将来の機能開発における既知のギャップとして記録され、黙って省略されることはありません。

バージョン 2.53.0

OpenOffice excelfileformat.pdf cross-audit round 2. Three additional BIFF8 wire-format fixes uncovered by re-running the spec sweep after v2.50.0, targeting modules the first pass had touched only lightly: the formula token decoder, the XF alignment byte, and the ROW outline-collapse boundary check.
Macro-command formulas with the user-prompt flag no longer corrupt the parser (§3.7.2 tFuncVar). The byte at offset+1 of a tFuncVar token packs the argument count in bits 6-0 ($7F) and the user-prompt flag in bit 7. Without masking, prompt-flagged tFuncVars were read as 128+N arguments, blowing the formula stack and yielding nil for the whole expression.
JustifyLastLine alignment flag round-trips correctly (§5.115 XF). The XF BIFF8 alignment byte (offset 6) packs HorAlign + WrapText + VerAlign + JustifyLastLine. Bit 7 ($80, JustifyLastLine) was never written, so cells configured with the flag reverted to the Excel default after save / reopen.
Row 0 / row 65535 no longer mis-flagged as outline-group boundaries (§5.88 ROW). The fCollapsed ($10) bit fired for the boundary rows when their explicit outline level differed from the absent neighbours' default level 1. Absent neighbours are now treated as matching the row's own level.

バージョン 2.52.0

**[MS-XLSX] 相互監査 — 第2回。** 在 v2.51.0 監査之后，对 XLSX 写入器进行了三次后续改进。每个改进都独立地基于 ECMA-376 或 W3C XML 的相关条款；综合效果是更好的 OOXML 兼容性和更少的验证输出。
**セルの文字列において、先頭または末尾の空白文字が丸め処理されます。** `XlsxFormatCellValue` 内のインライン文字列のフォールバック機能は、`... ` という形式で出力していましたが、`xml:space="preserve"` 属性が含まれていませんでした。XML 1.0 の §3.3.3 に基づく正規化処理により、読み込み時に周囲の空白文字が削除され、値が "Pending" であるセルが、"Pending" と表示されていました。SST、リッチテキスト、およびコメントテキストのパスでは、この属性が既に設定されていましたが、インライン文字列のフォールバック機能も、この動作に一致するように変更されました。
**すべてのワークシートに、<dimension> ヒントが追加されました。** ECMA-376 §18.3.1.35 では、<dimension ref="..."/> 要素はオプションとされていますが、すべての Excel で作成された .xlsx ファイルにはこの要素が含まれています。このヒントを読み取るアプリケーション（Apache POI / NPOI / OOXML SDK など）は、動的にサイズを変更するのではなく、このヒントに基づいてセルバッファのサイズを事前に決定します。書き込みエンジンは、行のグループ化処理中に、データセルで囲まれた領域を計算し、その情報を <worksheet> 要素の 2 番目の子要素として出力します（<sheetPr> が存在する場合はその後に、<sheetViews> の前に）。空のワークシートは、<dimension ref="A1"/> に縮小されます。
`<sst count="..."> 属性报告的是单元格引用的总数，而不是唯一字符串的数量。ECMA-376 第 18.4.8 节将 `count` 定义为总引用计数，将 `uniqueCount` 定义为不同字符串的计数；以前的版本将这两个值都作为 `FStrings.Count` 输出（两者总是相等），这可能会误导使用 OOXML 的应用程序，使其对引用密度产生错误的理解。现在，`TXLSXSharedStrings` 跟踪一个单独的 `RefCount` 属性，该属性在每次 `Add` / `AddRich` 调用时都会递增，无论是否进行去重，并且该属性报告的是实际的引用总数。

バージョン 2.51.0

**[MS-XLSX] 相互監査の合格。** Microsoftの*「[MS-XLSX] — Office Open XMLスプレッドシートMLファイル形式へのExcel (.xlsx)拡張機能」*ドキュメント（v20260108）およびXML 1.0/OOXMLスキーマ要件に対する検証により、XLSX書き込み機能において、5つのバイナリ形式およびロケール安全性の問題が修正されました。公開APIは変更されていません。既存のアプリケーションは、再コンパイルおよび再保存を行うことで動作します。
**.xlsx ファイルは、すべての Windows リージョンで開けるようになりました。** ページマージン、列の幅、行の高さ、フォントサイズ、色の濃淡、テーマの濃淡、カスタムフォントのリッチテキストのサイズ、および各セルの数値の `` で囲まれた値は、Delphi のロケール対応の `FloatToStr` 関数を使用してシリアル化されていました。 Windows で、小数点記号がコンマ (ヨーロッパ大陸およびアジア/ラテンアメリカの一部) に設定されている場合、書き込み処理は `width="8,43"` や `top="0,75"` のような属性値を生成し、これは OOXML スキーマによって拒否されます。 Excel は「.xlsx に問題が見つかりました」というメッセージを表示し、ページ設定、列の幅、および数値のセル値を消去する復旧オプションを提供しました。すべての浮動小数点数の OOXML 属性は、現在アクティブなリージョンに関係なく、不変の '.' 記号を使用します。この修正は、以前にロケール形式の文字列を保存していた、メモリ内の列幅/行高さのキャッシュにも適用されます。そのリージョンで、`SetColWidth` / `SetRowHeight` を呼び出した直後に、`GetColWidth` / `GetRowHeight` が `0.0` を返していました。
ワークブックがクラッシュする原因となっていた、制御文字を含むセルが修正されました。XML 1.0 §2.2 では、ASCII コード 0x00～0x08、0x0B、0x0C、0x0E～0x1F (および U+FFFE / U+FFFF) を XML ドキュメント内のどこにも使用することを禁じています。これらのバイトを含むセル値 (レガシーデータフィード、ログダンプ、エスケープキーの送信など) は、以前は `<t>...</t>` タグ内にそのまま書き込まれていましたが、これにより .xlsx ファイルが開けなくなり、データにアクセスできなくなっていました。現在、書き込みエンジンは、これらの禁止されたコードポイントを静かに削除し、有効な空白文字 (タブ / LF / CR) は保持されます。


        属性値内の改行が正しくラウンドトリップされるようになりました。XMLの§3.3.3では、属性値内の生のタブ/LF/CRが、アプリケーションに値を渡す前に、単一のスペースに正規化されます。以前、複数行のヘッダー/フッター、定義済み名前のコメント、複数行のデータ検証プロンプト、ハイパーリンクの表示文字列、および改行を含むその他の属性は、読み込み時に単一のスペースに圧縮されていました。`XlsxEscapeAttr`は、これらの文字を`&#x9;` / `&#xA;` / `&#xD;`という数値文字参照として出力するため、Excelはそれらを元の空白として読み取ることができます。
        **<col> エントリは、昇順の列順で出力されます。** ECMA-376 18.3.1.4 / 18.3.1.13 では、すべての <col min="..."/> エントリが、昇順の `min` 順で表示されることが求められています。 以前は、`TStringList(Sorted=True)` を使用して、整数列のインデックスを辞書順にソートしていたため、文字列 "10" が "2" より前に配置され、列 2 と列 10 の両方をカスタマイズしたシートでは、`<col min="10"/>` が `<col min="2"/>` の前に表示されていました。 Excel はこのレイアウトを許容していましたが、Office File Validation ではファイルがフラグされ、厳格な OOXML 対応ツール (Apache POI の厳格モード、strict-validation が有効な LibreOffice) ではファイルが拒否されていました。 現在、列のエントリは、出力前に数値的にソートされます。



      バージョン 2.50.0
      
        OpenOffice excelfileformat.pdf cross-audit pass. Eight follow-up wire-format and lifetime fixes uncovered by re-validating the BIFF8 writer / reader against the OpenOffice Microsoft Excel File Format documentation after the v2.49.0 [MS-XLS] pass. Public API is unchanged; existing applications recompile and re-save without modification.
        Shared formulas now span the full column range (§5.94 SHAREDFMLA). The SHRFMLA record body wrote colFirst into the colLast byte, collapsing every multi-column shared formula group to a single-column group in Excel. Fill-down formulas across two or more columns now expand to the correct cells when the workbook is reopened. The reader-side colLast width was also corrected.
        Shared formula Boolean / Error results round-trip correctly (§5.50 FORMULA). The same FormulaValue byte-layout bug fixed in v2.49.0 for standalone formulas was still present in the shared-formula writer (cells that carry a tExp token pointing at a SHRFMLA master). Cached TRUE/FALSE and #REF!/#DIV/0!/etc. values now appear as written.
        FORMULA option flags identify shared-formula members (§5.50 FORMULA). Cells inside a shared-formula group now set the fShrFmla bit (0x0008) in the FORMULA record option flags so strict parsers recognise the tExp token as a back-reference.
        Bold and underlined fonts identified correctly by strict readers (§5.45 FONT). The FONT option-flags word now sets bit 0 (bold) and bit 2 (underlined) in addition to the dedicated bls / uls fields.
        CFRULE option flags carry spec-mandated constant bits (§5.16 CFRULE). When at least one formatting block is present the option-flags DWORD now ORs in bit 7 (0x00000080, "Always 1") and bits 21-19 (0x00380000, "Always 111").
        CHOOSE() formulas read back correctly (§3.10.5 tAttrChoose). The tAttr parser previously skipped a fixed 4 bytes for every subtype; tAttrChoose ($04) is variable-length. The decoder now reads nc and advances by 6 + 2·nc bytes.
        Data-validation and conditional-formatting teardown no longer dereferences past the tail. Two Destroy destructors (TDataValidator, TCondFormatter) walked 0..cnt on lists whose valid indices are 0..cnt-1.
      
    

      バージョン 2.49.0
      
        **[MS-XLS] v20250520 规范审计已通过。** 在 BIFF8 写入器、公式解码器、加密路径、图表生成器、条件格式和数据验证运行时、SST/ExtSST 索引、VBA 存储读取器以及 OLE 流打开路径等方面，修复了 16 个与数据格式和行为相关的问题。公共 API 未更改，现有代码无需修改即可重新编译。以下是主要改进。
        **BIFF8 Formula レコードにおけるブール値とエラーの結果が、正しくやり取りされるようになりました。** [MS-XLS] §2.5.133 FormulaValue は、型タグを byte[0] に、ブール値/エラーコードを byte[1] に格納します。以前の書き込み処理では、$0001/$0002 が単語として出力され、値が byte[2] に格納されていたため、キャッシュされたブール値の式は常に False と読み込まれ、エラー式の式はすべてのアプリケーションで #NULL! と表示されていました。
        SetColorRGBメソッドで設定されたセルの色は正しく表示されます。以前は、カラーマネージャーがRGB値に対してColorType=1（テーマ）を、テーマ値に対してColorType=2（RGB）を書き込んでおり、この2つの処理が逆になっていました。現在は、両方の設定メソッドが対応するColorTypeに基づいて処理されるように変更され、RGB値はRGB解決関数に、テーマインデックスはテーマ解決関数に渡されます。
        **XOR 難読化および RC4 デコードの問題が修正されました。** XOR メソッド 1 のデコードループは、[MS-OFFCRYPTO] §2.3.7.3 に準拠するように変更されました (まず XOR を実行し、次に 5 ビットを右にシフトします。XorArray のインデックスは、後処理位置ではなく、エントリストリームの位置から取得します)。RC4 の `Skip` 関数は、目的のブロックに直接ジャンプするのではなく、1024 バイトごとの境界を連続的に走査し、キーストリームの状態をファイル位置に合わせて、以降の `Decrypt` 呼び出しごとに調整します。
        **グラフシートの内部フォーマットを仕様に準拠させました。** SIIndex レコードは、numIndex=1 → 2 → 3 の順で出力されます ([MS-XLS] §2.4.262。以前は 2 → 1 → 3 で、厳密なパーサーでは拒否されていました)。DEFAULTTEXT の数は、仕様で規定されている最大値である 2 に制限されています ([MS-XLS] §2.1.7.20.1。以前は 4 でした)。Chart3DBarShape のプレースホルダーには、正しい ID である `$105F を使用しています (以前は `$1066 でした)。
        **HLinkツールチップレコードが正しく読み込まれます。** 以前は、`HLinkTooltip` ($0800) のデータ部分のデコーダーが、オフセット2/4/6/8の位置にあるFrtRefHeaderのアンカーフィールドを読み取っていたため、アンカーと範囲の比較が一致せず、セルごとのツールチップが静かに破棄されていました。現在、ツールチップは対応するハイパーリンクに関連付けられます。また、BIFF8の範囲参照デコーダーにおいて、BIFF5/7のフォールバックにおける符号拡張パスの`FFirstColRel`/`FLastColRel`のタイプミスを修正しました。これにより、負の相対オフセットを持つ最後の列を持つ範囲の誤ったデコードが修正されました。
        条件付き書式設定とデータ検証の実行時エラー修正。`TCondRange`と`TDVRange`の両方で、`IsContainRow`は、範囲が単一行に縮小された場合にのみtrueを返していました（比較が逆になっていました）。これにより、複数行の範囲で、行ごとの条件付き書式/データ検証ルールのクリアが機能するようになりました。3つのデストラクタ（CondFormat、formatter、DVRangeList）は、有効なインデックスが0からcnt-1までのリストに対して、`for i := 0 to cnt`を使用していました。このオフセットエラーを修正し、長時間実行のワークロードで、まれに発生していたクラッシュを解消しました。CF12アイコンセットルールは、`ct=$06`（[MS-XLS] §2.4.43のアイコンセット）を生成します（以前は`ct=$05`（フィルター）でした）。これにより、アイコンセットルールを含むワークブックを開くと、ルールがそのまま保持されるようになりました。
        **ExtSSTの高速検索インデックスが、大規模なワークブックに対して仕様に準拠するように改善されました。** `dsst`フィールドは、[MS-XLS] §2.4.107に従って、静的なデフォルト値である8ではなく、`max((cstUnique / 128) + 1, 8)`として計算されます。これにより、約900以上のユニーク文字列を持つワークブックで、正しい`rgISSTInf`バケット配列が構築され、Excelの高速検索SSTルックアップが機能するようになりました。
        **WriteAccess レコードは、[MS-XLS] §2.4.349 の cch <= 54 を遵守します。** `userName.cch` フィールドは、現在、実際のユーザー名長（"HotXLS" の場合は 6）を保持し、残りのバイトは仕様で定義された「未使用」の末尾で埋められます。 以前は、このフィールドが cch=109 を保持しており、これは Office File Validation によって重大なフォーマット違反としてフラグが立てられていました。
        **BIFF8 工作簿流的打开路径与规范中的拼写相匹配。** 首次尝试使用 OLE OpenStream 时，使用 'Workbook'（[MS-XLS] §2.1.7.20 中规定的首字母大写），而不是全部小写，因此，在对大小写敏感的 OLE 实现中，复合文件容器可以在第一次尝试时成功打开该流。
        **VBAモジュールリーダーは、各ストリームの最後のバイトを削除する問題を修正しました。** 以前は、ファイルの末尾へのシークに使用する長さが `trunc(l) - 1` であり、`trunc(l)` ではなく、これにより圧縮されたソースの末尾が切り捨てられ、特定のモジュールでRLEコンテナデコンプレッサーが早期に終了していました。
      
    

      バージョン 2.48.10
      
        HotXLS で保存された .xls ファイルは、Excel がすべてのワークブックに期待する 2 つの OLE 複合ファイル プロパティセットストリームを含むようになりました:\005SummaryInformation と \005DocumentSummaryInformation。v2.48.10 以前は TRIAL ビルドのみが書き込んでいました(バナースタンプメカニズムとして);リリースビルドは Workbook ストリームが有効な BIFF8 だが OLE コンテナが標準 Office メタデータストリームを欠いている .xls ファイルを生成していました。Excel 2003 の厳密なパーサはこれを「File error: data may have been lost」状態として扱います(現代の Excel は保護ビュー「このファイルには問題があります」バナーを保持)。ストリームを追加することで BIFF8 レコードを変更せずにチャートワークブックのダイアログを解決します。
        2 つのストリームは Win32 の StgCreatePropSetStg + IPropertySetStorage.Create + IPropertyStorage.WriteMultiple パス経由で出力されます —— Microsoft Office 自身が使うのと同じコードなので、Office File Validation はバイトレイアウトを受け入れます。SummaryInformation ストリームはデフォルトの AppName="HotXLS" と空の Author で作成されます;TRIAL ビルドはデフォルトスタンプの後に lxTrial.XlsTrialStampXlsSummary 経由で Author / AppName 値をトライアルバナーで上書きするため、トライアルファイルは Excel のファイル > 情報 > プロパティペインで識別可能のままです。DocumentSummaryInformation ストリームは空で作成されます(Win32 はプロパティセットヘッダー + CODEPAGE プロパティを出力します —— Excel の厳密なパーサがメタデータを「存在し正しく形成されている」と見なすには十分)。
        この修正は普遍的です —— HotXLS で保存されたすべての .xls が今や標準 OLE メタデータを携帯し、チャートワークブックに限らない。以前のリリースのワークシートのみの出力は、Excel がメタデータのないチャートシートワークブックよりもワークシートのみワークブックに対して寛容だったため症状を逃れていましたが、技術的にはそれらにもストリームが欠けていました。新しい Lib/lxXlsSummary.pas ユニットが 2 つのヘルパープロシージャを保持します;lxHandle.pas は TXLSWorkbook.SaveWorkbook 内で StoreWorkbook が Workbook ストリームを投入した後、FDocStorage.Commit の前に無条件で呼び出します。
        このリリースは 8 バージョンに及ぶチャート Phase 2 フォローアップシーケンス(v2.47.0 — v2.48.10)を閉じます:tArea3D シリーズバインディングから始まり、BRAI id 再整列、sdtX/cValx Excel 観測値、SERIESTEXT 配置、Workbook ストリームパディング削除、シートレベルシェルレコード、そして今 OLE メタデータストリーム。結果は Excel 2003 と現代の Excel でいかなる「ファイルに問題があります」警告もなしに開くチャート .xls であり、Excel 自身が同じデータに対して書くものとバイト単位で整合しています。
      
    

      バージョン 2.48.9
      
        BIFF8 チャートシートが Excel 2003+ が要求する完全なシートレベルシェルレコードのセットを携帯するようになりました。v2.48.8 の chart_phase2_demo.xls は縦棒チャートを正しくレンダリングしましたが、Excel 2003 はまだ「File error: data may have been lost」ダイアログを表示しました(新しい Excel バージョンは保護ビューバナーを保持しました)、これはチャート substream にワークシート substream が通常持つ同じシートレベルレコードが欠けていたためです。実際の Excel ファイル(from-scratch と HotXLS 出力の re-saved の両バリアント)は、チャートレコードをこのシェルで囲みます:
          
            チャートレコードの前(BOF と UNITS の間):HEADER($0014、空)、FOOTER($0015、空)、HCENTER($0083、値 0)、VCENTER($0084、値 0)、SETUP($00A1、34 バイトのページ設定)、PRINTSIZE($0033、値 3)。
            チャートレコードの後(最外部 CHART END の後、EOF の前):DIMENSIONS($0200、14 バイト)がキャッシュデータ範囲を宣言、3 つの SERIESINDEX($1065)がカテゴリ / 値 / バブルサイズキャッシュスロットをマーク、キャッシュされた値ポイントごとに NUMBER($0203、14 バイト)、最後に WINDOW2($023E、10 バイトのチャートシートバリアント)。
          
          バイト値は dev-notes/biffview-refs/excel_column_chart_resaved.xls(Excel が保存した縦棒チャートリファレンス、ローカル)から逐語コピー。
        
        値キャッシュは現在ゼロプレースホルダ(各データポイントで 0.0)を出力しており、Excel 自身がソースキャッシュが事前に投入されていないチャートを再保存するときに書くものと一致します。チャートは BRAI の PtgArea3d 参照が描画時にソースワークシートセルに解決されるため、実データを依然として描画します —— キャッシュは Excel が警告なしにチャートシートを解析できるようにするためのものであり、プロットを駆動するものではありません。将来のリリースでは、実際の Values 範囲の数値でキャッシュを投入できます;wire 形式は整っています。
        エンドツーエンドスモークテスト:再生成された Demo/Delphi/XlsCreateChart/chart_phase2_demo.xls を Excel 2003 で開く —— "File error: data may have been lost" プロンプトはもう表示されず、縦棒チャートは以前と同じようにレンダリングされます。同じファイルは現代の Excel でも保護ビューバナーなしで綺麗に開きます。
      
    

      バージョン 2.48.8
      
        BIFF8 (.xls) ライタは Workbook ストリームの末尾にゼロバイトのパディングを追加しなくなりました。TXLSWorkbook.StoreOleFile は以前、最後のシートのレコードの後で StoreExtraSpace(Book) を呼び出し、ストリーム長を次の 512 バイト(OLE セクタ)境界までパディングしていました。Excel の厳密なパーサはこれらの末尾ゼロバイトを偽の 0x0000 id レコードストリームとして扱い、保護ビューの「このファイルには問題があります」プロンプトを表示します —— v2.48.7 chart_phase2_demo.xls で BRAI / sdtX / SERIESTEXT wire 形式が修正されチャートが正しくレンダリングされた後も表示されていました。この呼び出しを削除すると Workbook ストリームコンテンツからパディングが消えます。OLE セクタパディングは依然として発生しますが、ストリームの下の CFB コンテナ層で発生し、Excel 自身が配置する場所と一致します(Excel が保存するすべての .xls は Workbook ストリーム長がセクタ非整列です)。
        症状の歴史:HotXLS で保存されたあらゆる .xls は、有効レコードの合計バイト長がたまたま 512 バイト境界に着地しない限り、末尾ゼロストリームを持っていました。このバグはリポジトリのブートストラップコミット以降存在しましたが、ほとんど表面化しませんでした —— ほとんどのワークブックには十分なレコードがあり、パディングが小さくなる(Excel が許容する ≤ 4 ゼロバイト)からです。チャートシートワークブックはセクタ境界よりはるかに少ないところに着地(v2.47.0 — v2.48.7 デモは 420 ゼロバイトをパディング)するため、保護ビュープロンプトが一貫して現れる場所です。
        StoreExtraSpace メソッド自体は lxHandle.pas に private な dead code として残ります、将来のコードパスが本当にセクタ丸めストリームを必要とする場合のため;StoreOleFile 内の呼び出し点が削除されます。Workbook ストリーム長は今やすべての有効レコードのバイト長と正確に等しくなります(チャートデモ:3164 バイト;Excel from-scratch リファレンス:4419 バイト —— 両方ともセクタ非整列)。リーダーコードパスは影響を受けません —— HotXLS は常に Excel 保存ファイルの非セクタ整列 Workbook ストリームを正しく読んできました。
      
    

      バージョン 2.48.7
      
        BIFF8 チャート series レコードがついに Excel で正しくレンダリングされます。修正は BRAI id 割り当て を [MS-XLS] §2.4.51 に再整列することです —— 親実装計画は id 意味を反転して文書化しており、このバグが v2.41.0 から v2.48.6 までの各 chart リリースに波及していました。正しい id セマンティクスは:
          
            id = 0 — series name / 凡例ラベル(計画では:categories)
            id = 1 — values(正しい)
            id = 2 — categories(計画では:name)
            id = 3 — bubble sizes(計画では:errBars)
          
          反転の Excel 症状は完全に一致:Categories 範囲(テキストラベル A2:A5)が BRAI id=0 として出力 → Excel はそれを series 名として読み、4 セルを "North South East West" に連結して凡例 / 自動タイトルに使用。PTG tStr 'Q1 Sales' リテラルが BRAI id=2 として出力 → Excel はそこに category セル範囲を期待、文字列リテラルを見つけて諦め、X 軸を 4 つのゼロとしてレンダリング。
        
        Excel-saved 縦棒チャートの wire 形式にも再整列:SERIES.sdtX は 0x0003(テキストカテゴリに対する Excel の観測値、[MS-XLS] §2.4.252 が文書化する 0x0001 ではない)、cValx は 0 ではなく実際のカテゴリ数を運びます。「sdtX ∈ {1, 3} のとき cValx MUST = 0」という spec 規則は、検査されたすべての Excel-saved サンプルに反します。
        SERIESTEXT($100D)リテラル名キャリアが戻ってきましたが、正しい場所にあります:id = 0 BRAI の直後、SERIES BEGIN/END ブロック内。これは実際の Excel ファイルが行うこと —— v2.48.5 の出力ポイント(BRAI クラスタ全体の後、DataFormat の前)は間違っていてチャート parsing を壊しました。正しい位置は series 名 BRAI のすぐ隣です。
        v2.41.0 — v2.48.6 で保存されたチャートファイルはすべて反転 BRAI wire 形式を持ちます。Excel ではエラーなく開きますが、上記の凡例 / X 軸の症状を示します。v2.48.7+ で再保存して移行;API 変更なし —— 同じ AddChartSheet 呼び出しが、同じデータに対して Excel 自身が書くものと同一にレンダリングされるチャートを生成します。
        新しいバイトレベル検査ツール dev-notes/biffview-refs/dump_chart_substream.py は、任意の BIFF8 .xls の chart substream をレコード毎にデコードしてダンプします(SERIES / BRAI / SERIESTEXT / AXIS / CATSERRANGE / LEGEND / OBJECTLINK / POS / TEXT)。このリリース中に HotXLS 出力を Excel-saved 参照サンプルに対してバイト diff するために使用;将来のチャート spec follow-up のために利用可能。
      
    

      バージョン 2.48.6
      
        BIFF8 チャートシート substream は v2.48.5 の変更を撤回します。再生成された v2.48.5 デモを実際の Excel でテストすると、チャートがまったく表示されません —— v2.47.0 ベースライン(チャートは描画されるが X 軸ラベルが間違い)より悪化。v2.48.5 の 2 つの変更が原因でした:
          
            SERIES.sdtX = 4 は Apache POI が CATEGORY_DATA_TYPE_TEXT = 4 を公開しているにもかかわらず、実際には Excel に受け入れられません。[MS-XLS] §2.4.252 は sdtX が 0x0001 または 0x0003 であることを厳密に要求します。
            SERIES BEGIN/END ブロック内に追加された SERIESTEXT($100D)レコードは構造違反 —— SERIESTEXT は TEXT ブロック(チャートタイトル / 軸タイトル / データラベルのコンテキスト)に属し、SERIES ブロック内には属しません。そこに埋め込むと Excel のチャートパーサが substream 全体を拒否します。
          
        
        v2.48.6 は v2.47.0 の wire 形式を復元し、加えて spec 準拠修正を 1 つ追加します:sdtX = 1 のとき SERIES.cValx は今 0 です([MS-XLS] §2.4.252 spec MUST 規則)。v2.48.6 以前は cValx = count(デモでは 4)を書いており、この規則に違反していました。これが Excel の「ドキュメントに問題があります」保護ビュープロンプトに寄与していた可能性があります。cValy は実際の値数を保持(sdtY=1 はゼロ規則なし)。
        新しい XlsCreateChart Delphi デモを Demo/Delphi/XlsCreateChart/ に追加。2 シートのワークブックを作成:4 行(Region, Sales)の "Data" シートと、シリーズが Data!$A$2:$A$5 / Data!$B$2:$B$5 を Categories / Values としてバインドする "Chart1" 縦棒チャートシート。このデモは v2.47.0 — v2.48.5 がリポジトリのルートに置いていたアドホック chart_phase2_demo.xls の恒久的後継です。ルートファイルは削除済み、新デモは自身の .exe のディレクトリに出力を書き込みます。
        既知の未解決: v2.48.6 の wire 形式でも、Excel は縦棒チャートの X 軸ラベルをゼロとして描画し続け、凡例には BRAI id=2 PTG tStr リテラル 'Q1 Sales' を使わずカテゴリセルテキストの連結にフォールバックします。これは Excel 自身が保存した参照縦棒チャートとバイト diff する必要がある実 wire 形式のギャップ —— follow-up としてトラッキング。4 本の棒のプロットエリア自体は正しく描画されます(高さ 100/150/200/175 が Values と一致)。
      
    

      バージョン 2.48.5
      
        BIFF8 チャート series レコードが Excel で正しくレンダリングされるようになりました。v2.47.0 で Categories / Values 範囲の tArea3D バインディングを接続しましたが、Excel は X 軸ラベルを全て 0 として描画し、連結されたカテゴリテキスト("North South East West")を凡例と自動タイトルの両方に使用していました。2 つの修正で意図通りの表示に戻ります:
        SERIES レコードの sdtX フィールドを 1 から 4(text categories)に変更。[MS-XLS] §2.4.252 は 1(dates)と 3(BIFF7 sequence)のみ記載していますが、実際の Excel が保存する縦棒 / 横棒 / 折れ線チャートはテキスト軸カテゴリに 4 を書き込みます(Apache POI の CATEGORY_DATA_TYPE_TEXT 定数に一致)。sdtX=1 では Excel が 'North' / 'South' セルを数値に変換しようとして失敗し 0 にフォールバック、sdtX=4 ならテキストラベルがそのまま表示されます。以前の wire format は spec の「sdtX=1 のとき cValx はゼロでなければならない」規則にも違反していました。
        literal series Name が指定された場合、SERIES BEGIN/END ブロック内(BRAI クラスタの後、DataFormat の前)に SERIESTEXT($100D)レコードが生成されます。Phase 2 前半の仕組み(BRAI id=2 + PTG tStr)は spec 完全性のため残しますが、Excel は実際には SERIESTEXT から凡例ラベルと自動タイトルを取得します。BRAI バリアントだけだと Excel はカテゴリセルの連結にフォールバックしていました。修正後、凡例は実際の Name(例: 'Q1 Sales')を表示し、空のチャートタイトルは自動タイトルスロットを空のままにします。
        移行: v2.42.0 — v2.47.0 のチャートシート出力はエラーなしで Excel で開けますが、上記の症状でレンダリングされていました。v2.48.5+ で再保存すると修正された wire format になります。API 変更不要、同じ AddChartSheet 呼び出しで正しいチャートが生成されます。
      
    

      バージョン 2.48.4
      
        BIFF8 CFEX ($087B) の出力は引退しました。HotXLS は CF12 ($087A) の後にペアの CFEX を書き込まなくなり、すべての Data Bar / Color Scale / Icon Set 設定は CF12 の種類別 tail（v2.48.1 — v2.48.3）にインラインで含まれます。Apache POI / NPOI は CFEX を無視するので、純粋な簡素化です。
        BIFF8 CF12 読み取りパスは CF12 から種類別 tail を直接消費するようになりました。これにより 5-PATCH Gap #6 wire-format 書き直し（v2.48.0 header + v2.48.1 data_bar + v2.48.2 color_gradient + v2.48.3 multistate + v2.48.4 CFEX 引退）が完了します。
      
    

      バージョン 2.48.3
      
        BIFF8 CF12 ($087A) の Icon Set ルールは NPOI 互換の multistate サブレコードをインラインで出力するようになり、Apache POI / NPOI はアイコンファミリー、stop ごとのしきい値、reverse / icon-only フラグを CF12 から直接読めるようになります。レイアウトは NPOI IconMultiStateFormatting.Serialize() と完全一致。
        v2.48.2 で HotXLS 生成された .xls ファイルは、Icon Set ルールが新しいインライン tail を持つよう v2.48.3 で再保存する必要があります。CFEX 出力の引退は v2.48.4 で対応します。
      
    

      バージョン 2.48.2
      
        BIFF8 CF12 ($087A) の 2-stop / 3-stop Color Scale ルールは NPOI 互換の color_gradient サブレコードをインラインで出力するようになり、Apache POI / NPOI は各 stop のしきい値、色、補間位置を CF12 から直接読めるようになります。レイアウトは NPOI ColorGradientFormatting.Serialize() と完全一致。
        v2.48.1 で HotXLS 生成された .xls ファイルは、Color Scale ルールが新しいインライン tail を持つよう v2.48.2 で再保存する必要があります。Icon Set tail は v2.48.3 で対応します。
      
    

      バージョン 2.48.1
      
        BIFF8 CF12 ($087A) Data Bar ルールは NPOI 互換の data_bar サブレコード（template_params の後に 28 バイト追加）をインラインで出力するようになり、Apache POI / NPOI はバー色、min/max しきい値、パーセント長境界を CF12 から直接デコードできます（POI が無視するレガシー CFEX レコードは不要）。レイアウトは NPOI DataBarFormatting.Serialize() と完全一致。
        v2.48.0 で HotXLS 生成された .xls ファイルは、Data Bar ルールが新しいインライン tail を持つよう v2.48.1 で再保存する必要があります。Color Scale / Icon Set 種別 tail は v2.48.2 — v2.48.3 で対応します。
      
    

      バージョン 2.48.0
      
        BIFF8 CF12 ($087A) ヘッダーレイアウトを NPOI CFRule12Record.serialize() および Excel 保存リファレンスファイルに合わせて修正。Excel は ext_formatting_length(4) をフォーミュラトークンの前に、長さプレフィックス付きの template_params ブロックを書き込みます。HotXLS はこれらのフィールドが間違った順序でした。種類別 tail (data_bar / color_gradient / multistate) は v2.48.1 — v2.48.3 で対応します。
        v2.34.0 — v2.47.1 で HotXLS 生成された .xls ファイルは、CF12 レコードを書き換えるため v2.48.0 で再保存する必要があります。各 CF12 の末尾にあった仕様外の 2 バイト nID フィールドは削除されました。
      
    

      バージョン 2.47.1
      
        BIFF8 CONDFMT12 ($0879) レコードの wire 形式を Excel 保存ファイルに合わせて修正。以前の実装は初期 spec ドラフトに従って 8 バイトの関連範囲を FtrHeader 内の "予約済み" として扱い、numCF の前に存在しない 4 バイト Reserved フィールドを挿入していました。Excel 保存の .xls は実際には FtrHeader のその 8 バイトを規則の関連セル範囲で埋め、Reserved フィールドを持ちません。リファレンス: poi_ConditionalFormattingSamples.xls レコード 152 と HotXLS 出力がバイト単位で一致。
        v2.34.0 — v2.47.0 で HotXLS 生成された .xls ファイルは、CONDFMT12 レコードを修復するため v2.47.1 で再保存する必要があります。
      
    

      バージョン 2.47.0
      
        BIFF8 のチャートシート作成が series に 実データ範囲 をバインドできるようになりました。6 引数の AddChartSheet オーバーロードに渡される Categories と Values の A1 文字列（例: 'Data!$A$2:$A$5'）は tArea3D PTG トークンへコンパイルされ、series の BRAI id=0（カテゴリ）と BRAI id=1（値）レコードに書き込まれます。Excel で開いた .xls は v2.42.0 の空のプロットエリアではなく、実際のデータ点を描画します。
        Sheet 名解決と EXTERNSHEET 登録は自動：パーサがブック内で該当シートを検索し、XTI エントリが未登録なら登録し、対応する 0-based の ixti を PtgArea3d 本体に書き込みます。再保存時にチャートレコードストリームは数式コンパイラを通って再シリアライズされるため、ixti は最終的な EXTERNSHEET 順序と整合性が保たれます。
        受け付ける範囲形式：Sheet1!$A$2:$A$5（絶対参照）、Sheet1!A2:A5（相対マーカーも許容 —— チャート series は常に絶対として保存）、'My Sheet'!$A$1:$B$5（スペースを含むシート名はシングルクォートで囲む）、Sheet1!$A$1 のような単一セル参照（1×1 PtgArea3d に縮退）。データ点数（cValx / cValy）は area 寸法から自動算出されます。
        サポートされない参照形式は v2.41.0 風の cce=0 プレースホルダ BRAI へ無音 fallback し、チャートは引き続き Excel で開けます：ブック間参照（[Book2.xls]Sheet1!...）、名前付き範囲（Sheet1!ProfitColumn）、! シートプレフィックス欠落、チャートシート自身を指す参照。これらは後続フェーズに繰り延べ。
        これで Roadmap #10 Phase 2（縦棒チャートのエンドツーエンド）完了。Series ラベル（Phase 2 前半 / v2.42.0）と series 範囲バインディング（このリリース）が揃い、AddChartSheet 経由で作成した縦棒チャートが Excel 内で適切な凡例と実データを描画します。
      
    

      バージョン 2.46.0
      
        BIFF8 側の差分 XF（DXF）デコーダーが、標準 Excel 2003 64 色パレットから xclrType=1（インデックスパレット）カラー を解決するようになりました。以前はインデックスカラーが RGB パスにフォールスルーし、icv バイトが RGB 値の一部として誤解釈されていました。
        ルックアップは HotXLS 組み込みの Excel 2003 デフォルトパレットを使用します —— icv 0..7 は 8 つのシステムカラー、icv 8..15 はシステムカラーをミラー、icv 16..63 は標準カスタマイズ可能なデフォルト値。範囲外の icv は黒にフォールバック。
        BIFF8 PALETTE レコード（rt=$0092）のワークブックカスタマイズは 参照されません —— カスタマイズされたパレットを持つファイルではカラーのわずかな偏差が出る可能性があります。
        xclrType=0（自動）と xclrType=2（RGB）のパスは変更ありません。
      
    

      バージョン 2.45.0
      
        条件付き書式ルールは XLSX <cfRule priority="N"/> と BIFF8 CF12 ipriority フィールドの両方で priority 属性 を round-trip するようになりました。以前は保存時に各ルールに対してコレクション内の index に基づく連番 priority が割り当てられ、Excel 保存ファイルの priority は読み込み時に無視されていました。
        新しい Priority プロパティが TCondFormatRule（BIFF8 側）と TXLSXConditionalFormat（XLSX 側）に追加。デフォルトはゼロで保存時の auto-by-index 動作を保持；正の値を設定すると priority がピン留めされます。
        Priority はマルチルールレイヤリングを制御 —— 複数のルールが同じ範囲をカバーするとき、Excel は priority 順に適用します。Priority の round-trip により HotXLS で編集したワークブックは意図したレンダリング順序を保持します。
        Priority に触れない呼び出し元のデフォルト動作は変更なし：XLSX ライターはコレクション順で priority="1"、"2"... を出力し続けます。
      
    

      バージョン 2.44.0
      
        アイコンセット条件付き書式ルールが XLSX 側で stop ごとのアイコンオーバーライド をサポートするようになりました。3 / 4 / 5 stop アイコンセット内の各 stop は、ファミリーのデフォルトを離れて、17 個の Excel 2007 組み込みアイコンファミリーのいずれかから任意のアイコンを表示でき、icon set name + icon id で識別されます。OOXML 要素は <cfIcon iconSet="OtherSet" iconId="N"/>。
        TXLSIconSetSpec に新しいメソッド：SetIconOverride(stopIndex, OverrideSet, IconId) と ClearIconOverride(stopIndex)。読み取り専用プロパティ HasIconOverride[i]、IconOverrideSet[i]、IconOverrideId[i]。
        XLSX ライターは SetIconOverride を呼んだ stop に対してのみ <cfIcon> 子要素を出力します；他の stop はファミリーのデフォルトを保ちます。リーダーは入力 <cfIcon> 要素を位置で解析します。
        既知の制限：BIFF8（.xls）CFEX には stop ごとのオーバーライド用のスロットがないため、オーバーライド付きルールを .xls に保存すると全 stop がファミリーのデフォルトでレンダリングされます。
      
    

      バージョン 2.43.0
      
        XLSX（.xlsx）条件付き書式ルールが、データバーとカラースケールルールの <color> 要素で テーマカラー参照 を round-trip するようになりました。以前はライターが <color rgb="FFRRGGBB"/> のみを出力し、リーダーは theme / tint 属性を無視していました。今は両側がテーマパレットインデックスとオプションの tint を保持します。
        TXLSDataBarSpec と TXLSCfValue（ColorScale stops が使用）の新しいメソッドがスロットをテーマモードに切り替えます：SetThemeColor(themeId, tint) と ClearThemeColor。読み取り専用プロパティ IsThemeColor、ThemeColorId、ThemeColorTint。
        XLSX ライターは Tint が正確に 0.0 のときに <color theme="N"/> を、非ゼロのときに <color theme="N" tint="0.5"/> を出力し、Excel 自身の "最短形式" 出力と一致します。
        デフォルト動作は変更なし：既存の RGB のみエントリポイントで作成されたルールは以前と完全に同じ <color rgb="..."/> を出力し続けます。
        既知の制限：BIFF8（.xls）CFEX は依然として RGB カラーのみ運びます；ワークブックテーマパレット解決（theme1.xml 解析）は引き続き範囲外；iconSet ルールは <color> 要素を運びません。
      
    

      バージョン 2.42.0
      
        BIFF8 グラフシート作成 API に TXLSChartSeriesInfo レコードの配列（Name、Categories、Values）を受け取る 5 番目の AddChartSheet オーバーロードを追加。空でない Name は系列名 BRAI（id=2）上の tStr PTG トークン経由でリテラル系列ラベルとしてグラフサブストリームに書き込まれる。Excel はこのラベルを凡例と系列セレクタで使うため、複数系列グラフは既定の "Series1 / Series2" プレースホルダの代わりに適切な系列キャプションを表示するようになった。
        TXLSChartSeriesInfo は TXLSChartType と並んで lxHandle から再エクスポートされる。呼び出し側は lxChartBuilder を直接インポートせずに配列を構築できる。
        これは Roadmap #10 フェーズ 2（縦棒グラフのエンドツーエンド）の前半。系列名のパスは配線済み；分類と値のデータバインディング（Categories / Values の A1-range 文字列を BRAI 内の実際の tArea3D セル範囲参照に変換）はまだプレースホルダのまま — これら 2 フィールドは API では受け入れられるがグラフサブストリームにまだ出力されない。後続リリースで数式コンパイラと EXTERNSHEET 参照テーブル経由でフェーズ 2 の後半を仕上げる。
      
    

      バージョン 2.41.0
      
        HotXLS に BIFF8 グラフシートのプログラマティック作成を追加。Sheets の新しい AddChartSheet オーバーロード群は、保存される .xls ファイルに完全なグラフサブストリームを書き込む。以前はグラフシートは load-save ラウンドトリップで不透明に保持できるだけだった。4 つのオーバーロードが一般的なエントリポイントをカバー：名前のみ / 名前 + グラフ種別 / + タイトル / + 分類軸タイトル + 値軸タイトル。返される IXLSWorksheet は Sheets コレクションに現れ、保存時にグラフシートの boundsheet エントリが書き出され、Excel はグラフタブとして開く。
        新しい列挙型 TXLSChartType がグラフ種別を選択：xlsChartTypeColumn、xlsChartTypeBar、xlsChartTypeLine、xlsChartTypePie。この列挙型は lxHandle から再エクスポートされるため、利用者コードは chart-builder ユニットを直接インポートする必要がない。
        発行されるグラフサブストリームは仕様が要求する BIFF8 のフレーミングをカバー — BOF (dt=$0020)、Chart / PlotGrowth / Frame / Series / SheetProperties / AxesUsed / AxisParent（POS + 分類軸 + 値軸 + PlotArea + Frame + ChartFormat + グラフ種別レコード + ChartFormatLink + Legend）、EOF — これにより Excel は結果を要求された種別の本物のグラフタブとして認識する。既存の TXLSCustomChart 経由のグラフシートラウンドトリップは変更なし。
        これは Roadmap #10（CHART サブストリーム — BIFF8 監査で最大の項目）の最初のリリース。フェーズ 1 はフレームワークと API 面を提供し、続くフェーズで系列データバインディング、軸タイトル、種別ごとの詳細な書式設定をレイヤー化できるようにする。
        制限事項：新しいグラフシートは要求された種別の空のデフォルトグラフを描画する。系列データバインディング（グラフを実際のセル範囲にリンク）、入力されたタイトルテキスト、種別ごとの詳細な書式設定（gap width / overlap / hole size / marker style）は後続フェーズに延期。Excel での保存と再オープンはグラフシートの存在と種別を保持するが、ユーザー提供データはまだ保持しない。
      
    

      バージョン 2.40.0
      
        Demo/Delphi/XlsCondFormat12/ に新しい XlsCondFormat12 Delphi デモプロジェクトを追加しました。v2.34.0+ の条件付き書式拡張 API をエンドツーエンドで実演します。3 つのボタンで CondFormat12.xls（BIFF8 バックエンド）、CondFormat12.xlsx（XLSX バックエンド）、または両方を並べて生成できます。各出力シートは同じ 4 種類のルール — データバー、3 色カラースケール、アイコンセット（3 矢印）、2 色カラースケール — を 10 行のデータでカバーし、Excel で開いて両バックエンドのレンダリングを目視確認できます。
        BIFF8 パスはさらに v2.35.0 DXF スタイルオーバーライドを実演します：データバールールに白色太字フォント色を付加し、暗いバー塗りつぶし上でもセルテキストが読みやすくなります。
        新しい DUnitX テストフィクスチャ Tests/Delphi/HotXLS.CondFormat12Tests.pas が、10 個の round-trip と API 表面シナリオをカバーします：4 種類のルールの BIFF8 round-trip、DXF Style の RGB カラー / テーマカラー / フォントフラグ round-trip、Data Bar / 3-color scale / ShowOnly 付き Icon Set の XLSX round-trip。フィクスチャは HotXLSDelphiTests.dpr と対応する .dproj に配線済みです。
        テストフィクスチャをサポートするため、TCondFormat に 2 つの新しい公開アクセサ：RuleCount と Rule(I) を公開しました。
        検証ノート：デモの .xls と .xlsx を Excel で開いて、4 つの CF12 / OOXML 拡張ルールが並列にレンダリングされるのを確認してください。
      
    

      バージョン 2.39.0
      
        条件付き書式ルールの差分 XF（DXF）スタイルオーバーライドが、既存の RGB モードに加えて テーマカラーエンコーディング をサポートするようになりました。3 つのカラースロット — フォント色、塗りつぶし背景、塗りつぶし前景 — それぞれを、ワークブックテーマインデックスと tint 値に対して設定でき、"accent-2 を 50% 明るく" のようなスタイルが固定 RGB に潰されることなく round-trip します。
        TXLSDxfStyle の 3 つの新しいメソッドが スロットをテーマモードに切り替えます：SetFontColorTheme(themeId, tint)、SetFillBgColorTheme(themeId, tint)、SetFillFgColorTheme(themeId, tint)。Tint は [-1.0, +1.0] 範囲の single — 負の値はテーマカラーを暗くし、正の値は明るくし、0.0 はベースカラーのまま。対応する既存の SetXxxColor(rgb) は RGB モードのまま；2 つのモードはスロットごとに相互排他的です。
        新しい読み取り専用プロパティ XxxColorIsTheme / XxxColorThemeId / XxxColorThemeTint でアクティブモードを問い合わせます。HasXxxColor はどちらのモードでも True を返します。
        BIFF8 wire 形式は標準の XFProp Colour レイアウトに従います：RGB は xclrType=2 + 4 バイト BGR LongWord、テーマモードは xclrType=3 + 2 バイト符号付き tint × 32767 + 4 バイトテーマインデックス。DXF blob デコーダーはこの dispatch をミラーリングします。
        既知の制限：テーマモード round-trip は BIFF8（.xls）側でのみサポートされます — XLSX（.xlsx）側は依然として <color rgb="..."/> のみを出力・読み込みします。
      
    

      バージョン 2.38.0
      
        XLSX（.xlsx）読み込みが受信ファイル内の Excel 2007+ 条件付き書式拡張ルール — データバー、カラースケール（cfvo 数から自動判定する 2 段と 3 段）、アイコンセット — を認識し、対応する TXLSXConditionalFormat オブジェクトに値を設定するようになりました。ユーザーコードはこれらのルールを失うことなく検査・round-trip できます。以前は Excel 保存のこれらルール種別を含む .xlsx ワークブックは読み込み時に黙って破棄されていました。
        リーダーは OOXML <cfRule type="dataBar|colorScale|iconSet"> ラッパーと内部の <dataBar> / <colorScale> / <iconSet> 本体を解析し、子の <cfvo> エントリを巡って各しきい値の type と val を回復し、<color> エントリを巡ってデータバーの色やスケールの段ごとの色を回復します。
        アイコンセットルールは iconSet ファミリー名（Excel 2007 ベースラインの 17 セット）、reverse フラグ、showValue フラグ（ShowOnly にマップ）を round-trip します。
        OOXML rgb="AARRGGBB" 属性から解析された色値は、書き込み API が使用するのと同じ BGR LongWord 規約に変換されるため、load-edit-save round-trip は視覚的な色を正確に保持します。
        既存の XLSX <cfRule type="cellIs"> 処理は変更ありません；dispatch は type 属性が新しいルール種別を指定した場合のみ新パスを取り、それ以外は cell-value パスにフォールバックします。
        既知の制限：テーマカラー参照は 0 として読まれ、ワークブックテーマパレットに対して解決されません；iconId の段ごとオーバーライドはキャプチャされません；<cfRule> の priority 属性は読み込み時に無視されます。
      
    

      バージョン 2.37.0
      
        BIFF8 CFEX レコード形式が stop ごとの完全な cfvo 配列（kind + value 文字列 + color、[MS-XLS] cfvo セマンティクスに準拠）を運ぶようになりました。バー/ストップカラーだけではありません。データバールールは min/max しきい値の種類と値を永続化し、カラースケールは各ストップの kind + value + color の組み合わせを永続化し、アイコンセットは reverse / showOnly フラグと共に各しきい値の kind + value を永続化します。
        CFEX 書き込みはバージョンフラグバイト（ver=1）を追加し、v2.34.0 minimal CFEX レイアウトを期待する古い HotXLS リーダーが暗黙的にレガシー解釈にフォールバックできるようにします。v2.37.0 リーダーは古いビルドが生成した ver=0 レコードも認識するため、混合バージョンインストールでの round-trip が古い形式で扱われる kind/color フィールドで双方向に機能します。
        リーダーは 同じ範囲上の混合 CONDFMT + CONDFMT12 エントリ を検出するようになりました — 古いセル値バックアップと新しいルールが同一の sqref をカバーする Excel 保存ファイルでよく見られるパターン。古い CONDFMT エントリは TCondFormat の新しい IsShadowed プロパティを介してフラグが立てられます。ライターは Excel 2003 ↔ Excel 2007+ クロスバージョン互換性のために保存時に両方のレコードファミリーを出力し続けます。
        TCondFormat の新しい TotalRange プロパティは以前は private だったマージされた範囲を公開します。
        既知の制限：shadow 検出は正確な境界ボックス一致に制限されています。ColorScale の完全 cfvo round-trip は 8 つの標準 kind 値を保持しますが、Excel のテーマカラーチントメタデータは保持されません。
      
    

      バージョン 2.36.0
      
        XLSX（.xlsx）出力が Excel 2007+ の 3 種類の条件付き書式拡張ルール — データバー、カラースケール（2 段と 3 段）、アイコンセット — をサポートするようになり、XLSX バックエンドが v2.34.0 BIFF8（.xls）バックエンドと同等になりました。TXLSXWorksheet に XLS 側の API と対応する 4 つの新しい公開メソッドが追加されました：AddCondFormatDataBar、AddCondFormatColorScale2、AddCondFormatColorScale3、AddCondFormatIconSet。
        保存される .xlsx ファイルは、各ルール種別に応じた OOXML <conditionalFormatting> 要素を出力します：データバーは <cfRule type="dataBar"><dataBar>、カラースケールは <cfRule type="colorScale"><colorScale> に 2 または 3 個の cfvo + color stops、アイコンセットは <cfRule type="iconSet"><iconSet iconSet="..."> に対応する数の cfvo。
        組み込みアイコンセット名マッピングは、XLS バックエンドがサポートする Excel 2007 ベースラインの 17 セットを網羅し、標準 OOXML iconSet 属性文字列として出力されます。
        しきい値タイプとカラー値は XLS API と同じ列挙体とカラー規約を使用します — 同じ TXLSCfValueKind、同じ Delphi BGR LongWord 形式。既存の XLSX セル値 AddConditionalFormat 呼び出しの動作は完全に同じです。
        既知の制限：テーマカラーエンコーディングはまだ出力されません；アイコンセット内の stop ごとの iconId オーバーライドは未対応。Excel で保存されたファイルからの XLSX 読み取り側のデータバー / カラースケール / アイコンセットルールの認識はまだ延期されています — このリリースでは書き込みのみが配線されています。
      
    

      バージョン 2.35.1
      
        BIFF8 リーダーは、CF12 ルールに付加された差分 XF（DXF）バイトをルールの TXLSDxfStyle プロパティバッグにデコードし戻すようになりました。同時に生バイトは DxfBlob に保持されます。スタイル付きのデータバー / カラースケール / アイコンセットルールを持つ Excel 保存ワークブックを読み込むと、各 Rule.Style 上の HasXxx + 値のペアを通じてフォント色、塗りつぶし色、太字 / 斜体 / 下線、数値書式 id に直接アクセスできます。
        Round-trip 動作：load-edit-save サイクルは Rule.Style のロード後の任意の変更を反映するようになりました。ユーザーがワークブックを読み、Rule.Style.SetFontColor を変更して保存すると、新しい色が反映されます。ユーザーが Style に触れなければ、保存されたファイルはオリジナルと同じオーバーライドを持ちます。
        DXF blob 内の未知の xfPropType 値は拒否されずにスキップされるため、本リリースで未対応のプロパティタイプを使用する新しい Excel ファイルも引き続きロードできます（生バイトは DxfBlob に残り、検査や将来の round-trip サポートに使用できます）。
      
    

      バージョン 2.35.0
      
        条件付き書式ルールは 差分 XF（DXF）スタイルオーバーライド を持てるようになり、CF12 ルールが Excel で発火したときに、セルのベース XF を変更せずにフォント色、塗りつぶし、フォントの太さ、斜体、下線、または数値書式を変更できます。このオーバーライドは各 TCondFormatRule 上の新規 TXLSDxfStyle プロパティとして公開され、既存の AddCondFormatDataBar / AddCondFormatColorScale* / AddCondFormatIconSet API でルールを作成した後にアクセスできます。
        本リリースでサポートするスタイルオーバーライド：フォント色、塗りつぶし背景色、塗りつぶし前景色、塗りつぶしパターン、フォント太字、フォント斜体、フォント下線スタイル、組み込み数値書式 id。各プロパティにはペアの HasXxx フラグがあり、SetXxx で明示的に設定したプロパティのみが BIFF8 ファイルに出力されます。
        BIFF8 ライターは、ルールの Style に少なくとも 1 つのオーバーライドが設定されている場合、CF12 レコードに非空の DXF ブロックを追加します。DXF ブロックは公開 XFProp 配列レイアウト（cxfp + プロパティごとのタイプ / サイズ / データのタプル）を使用するため、ルールが適用されたときに Excel がスタイル変更を認識できます。
        BIFF8 リーダーは Excel で保存されたファイルから読み取った生の DXF バイトをルールの DxfBlob プロパティに保持するため、load-edit-save の round-trip で CF12 ルールが担うセルスタイルが暗黙に失われることはなくなりました。生バイトを TXLSDxfStyle プロパティバッグに復号する処理は後続リリースに計画されています。
        スタイルをオプトインしないルールのデフォルト動作は変更ありません — v2.34.0 と同じく cbdxf = 0 が出力され、既存のデータバー / カラースケール / アイコンセットルールは以前とまったく同じようにレンダリングされます。
        既知の制限：DXF のテーマカラーエンコーディングは未対応（RGB のみ）；本リリースのプロパティセットに罫線オーバーライドとグラデーション停止点は含まれません；XFProp 値ブロブのバイト順は公開 [MS-XLS] ノートに従っており、Excel との完全な round-trip 忠実度のために BiffView での検証後に小さな調整が必要かもしれません。3 つの新規ルール種別の XLSX 側パリティは引き続き延期されています。
      
    

      バージョン 2.34.0
      
        Excel 2007 以降の拡張条件付き書式ルール用に、ワークシートへ新しい公開 API を追加：AddCondFormatDataBar（データバー）、AddCondFormatColorScale2 / AddCondFormatColorScale3（2 色 / 3 色のカラースケール）、AddCondFormatIconSet（アイコンセット）。各メソッドは "A1:A10" 形式の sqref 範囲と種類固有のパラメーター（バーの色、グラデーション停止点の色、アイコンセットの種類）を受け取り、作成されたルールオブジェクトを返します。
        BIFF8（.xls）ライターは既存のセル値ルール CONDFMT / CF に加えて、対応する CONDFMT12 / CF12 / CFEX レコード群を出力するようになり、新 API で作成したデータバー / 2 色・3 色カラースケール / アイコンセットルールが .xls ファイルに保存されるようになりました。
        BIFF8 リーダーは受信した CONDFMT12 / CF12 / CFEX レコードを認識し、同じインメモリルールモデルで公開します。これにより Excel で作成された拡張ルール付き .xls ファイルが読み込み時に黙って破棄されることがなくなりました。
        組み込みアイコンセットカタログは Excel 2007 ベースラインの 17 種類（3 矢印 / 3 旗 / 3 信号 / 3 標識 / 3 記号、4 矢印 / 4 評価 / 4 信号、5 矢印 / 5 評価 / 5 四半期）を網羅し、TXLSIconSetType 列挙体で選択できます。
        データバーの上下限、カラースケール / アイコンセットの停止点に使えるしきい値タイプは 数値、範囲の最小 / 最大、パーセント、パーセンタイル、数式。Excel の cfvo 種別と一致します。
        既存のセル値条件付き書式の挙動は変わりません。新 API と新しい BIFF8 レコード処理が追加されただけです。
        本リリースの既知の制限：XLSX 出力側の 3 種類の新ルール対応は未着手（既存の XLSX セル値ルールは影響なし）。CF12 の差分 XF スタイルブロックは空で出力されるため、Excel はバーやカラースケールを API で指定した色ではなく既定色でレンダリングする可能性があります。CFEX 内の各停止点は色のみを保持し、種類 / 数値の組み合わせは未保持。これらのギャップは v2.34.x / v2.35.x の後続リリースで、デモワークブックと Excel レンダリング検証と合わせて埋める予定です。
      
    

      バージョン 2.33.3
      
        Demo/Delphi/XlsTables/ の新しい XlsTables Delphi デモは、BIFF8 Tables (ListObjects) 書き込み側をエンドツーエンドで示します。Sheet.AddTable('SalesTable', 'A1:D10', headers) を使って A1:D10 の Table としてバインドされた 4 列の売上領域 (地域 / 製品 / 四半期 / 収益) を持つ SalesTable.xls を生成します。生成された .xls を Excel で開いて、列ドロップダウン、縞模様の行、および名前ボックスの SalesTable 構造化参照名を確認してください。
        このデモは v2.33.0 の AddTable API を採用するための最短のエンドツーエンドレシピです: StyleName = 'TableStyleMedium2' と ShowRowStripes = True を設定し、9 行のデータ + 1 行のヘッダーを埋め、1 回の SaveAs 呼び出しでワークブックを書き込みます。出力は実行可能ファイルの隣に配置されます。
        コンパイルインフラストラクチャは変更されていません: 既存の build-Win32-Demo.cmd は for /r Demo *.dpr スイープを介して XlsTables.dpr を自動的に拾います — ビルドスクリプトまたは .cbproj/.dproj 構成への変更は不要です。
      
    

      バージョン 2.33.2
      
        BIFF8 (.xls) の SaveAs は、同じシート上の Table が autofilter 範囲を完全にカバーするとき、スタンドアロンのシートレベル AUTOFILTERINFO/AUTOFILTER レコード ($009D / $009E) を抑制するようになりました。Excel は Table オブジェクト自体内に autofilter ドロップダウンを埋め込むため、同一範囲に対して追加のシートレベル autofilter を発行すると、Office File Validation がファイルを拒否します。これは v2.29.4 で出荷された XLSX 側の修正と一致します。
        カバレッジチェックは保守的です: Table の最初/最後の行と最初/最後の列が autofilter の境界を囲む場合にのみ、Table が autofilter を「カバー」していると見なされます。部分的なオーバーラップはシートレベルの autofilter を発行する動作を維持します。
        BIFF5 の保存と Table のないワークシートは影響を受けません — 抑制チェックは、ファイル形式が BIFF8 で、ワークシートに少なくとも 1 つの Table がある場合にのみ実行されます。パブリック API の変更はありません。
      
    

      バージョン 2.33.1
      
        BIFF8 (.xls) 読み取り側で、v2.33.0 が書き込み側に追加した共有機能 Tables レコードを認識するようになりました。Excel (または HotXLS 自身) で保存された ListObjects/Tables を含む .xls を開くと、ワークシートの Tables コレクションが、解析された FEAT11 ($0872) ごとに TXLSTable で埋められます: プライマリ Ref8U からテーブル範囲を再構築し、存在する場合はテーブルの id、name、displayName を復元し、ペアになっている LIST12 ($0877) レコードからテーブルスタイル名を埋め込みます。以前は、これらのレコードは静かに無視されていました。
        共有 FEATHEADR ($0867) opcode は、常に保護パーサーに送られるのではなく、その Isf フィールドによってディスパッチされるようになりました。Isf=2 (拡張保護) は既存の動作を維持; Isf=4 (SharedList) はシート上の Tables のマーカーとして認識されます; Isf=3 (SmartTags) およびその他の値は安全に無視されます。FEATHEADR11 ($0871) も Tables マーカーとして静かに認識されます。
        リーダーはベストエフォートで寛容です: 不正な形式または Excel バリアントの FEAT11 ペイロードは、少なくとも正しいセル範囲を持つ Table へとエレガントに劣化します。シート保護の round-trip は変更されていません。
      
    

      バージョン 2.33.0
      
        BIFF8 (.xls) ワークシートが Table オブジェクト (Excel ListObject) をサポートするようになりました。IXLSWorksheet 上で Worksheet.AddTable(Name, Range, Columns) を呼び出して、名前付きテーブル領域をセル範囲にアタッチします — 例えば Sheet.AddTable('SalesTable', 'A1:F9', HeaderList)。.xls の保存パスは、シートに Table が含まれていることを示す BIFF8 共有機能レコードファミリーを発行するようになりました: FEATHEADR ($0867、Isf=4)、FEATHEADR11 ($0871)、および各テーブルごとの FEAT11 ($0872) + LIST12 ($0877) のペア。以前は、XLS ファサードで AddTable は利用できず、ワークシートに定義されたテーブルは SaveAs(xlExcel97) で静かに破棄されていました。
        IXLSWorksheet の新しい公開 API: Tables: TXLSTables プロパティ (読み取り専用コレクション) と AddTable メソッド。形状は XLSX 側の TXLSXTable / TXLSXTables をミラーリングします。TXLSTable は Id、Name、DisplayName、Range、Columns、StyleName (デフォルト 'TableStyleMedium2')、ShowFirstColumn、ShowLastColumn、ShowRowStripes (デフォルト true)、ShowColumnStripes、TotalsRowShown を公開します。
        新しいシートストリームレコードは、シート保護の後、ワークシート EOF の直前に発行されます。ファイル形式が BIFF8 (xlExcel97) の場合のみです。テーブルのないワークブックは以前とまったく同じように保存されます — FEATHEADR は発行されず、レコードストリームの変更もなく、オーバーヘッドもありません。BIFF5 保存は影響を受けません。
        テーブル ID は、事前設定されていない場合、保存時にシートごとに順次 (1..N) 割り当てられます。デフォルトのスタイル名 'TableStyleMedium2' は、Excel および XLSX 側がすでに使用しているものと一致します。
        この初期リリース (v2.33.0) の既知の制限事項: 合計行の数式と構造化参照の補助範囲はまだ発行されていません; シートレベルの AUTOFILTERINFO と Table 範囲の競合抑制はフォローアップで追加されます; 読み取り側 (テーブル付き Excel 保存 .xls を Tables コレクションに解析し直す) もフォローアップです。
      
    

      バージョン 2.32.1
      
        v2.32.0 の FILEPASS 書き出し機能で導入されたコンパイルエラーを修正しました。これにより、厳密な型チェックを行う RAD Studio 12+ でライブラリのビルドが失敗していました。EncryptAllBlobs ヘルパーは分散バッファを PByte として宣言していましたが、その文脈では PByte は lxHandle ローカルの別名に解決され、一方呼び出し先の lxEncrypter の EncryptBlobData は lxBLOB.PByte を期待していました。両方の型は内部的に ^Byte ですが、Delphi は E2010 厳密型チェック下で別の型として扱います。バッファ変数は lxBLOB.PByte として完全修飾されたため、v2.32.0 のパスワード暗号化パスはサポートされるすべての RAD Studio バージョン (12.0–37.0) でクリーンにコンパイルされます。
      
    

      バージョン 2.32.0
      
        IXLSWorkbook に EncryptionPassword プロパティを追加しました。SaveAs を呼び出す前に空でないパスワードを設定すると、Excel 互換のパスワード保護付き .xls ファイルが生成されます：Excel、LibreOffice Calc など BIFF8 リーダーは開く際にパスワード入力を要求し、誤ったパスワードではアクセスを拒否します。これまで書き込み側のパスワード設定は無視され、常に平文で書き出されていました。
        書き込み経路は、ワークブック BOF の直後に BIFF8 FILEPASS レコード（$002F）を出力し、以降のすべてのレコード本体を読み取り側と同じ RC4 アルゴリズム（vMajor=1、vMinor=1、Excel の「Office 97/2000 互換」暗号化）で暗号化します。16 バイトの Salt と Verifier は Pascal の Random ではなく Windows の CryptGenRandom で生成されます。1024 バイト境界ごとのブロックキー再導出も維持されており、大規模ワークブック、SST CONTINUE チェーン、複数シートストリームも正しく暗号化されます。
        暗号化は BIFF8（xlExcel97）保存パスのみに適用されます。BIFF5 経路は平文のままです。EncryptionPassword のデフォルトは空文字列で、既存の平文出力動作が保たれ、セッターを呼び出さない既存アプリケーションには影響しません。
        読み取り側：ParseFilePass の潜在的バグを修正しました。FILEPASS 直後の最初のレコード本体（通常は CODEPAGE）が平文として扱われていた問題です。HotXLS で書き出した暗号化ファイルが HotXLS 自身でラウンドトリップ可能になり、Excel 製暗号化ファイルの CODEPAGE 値も正しく復号されます。
        セキュリティ注意：BIFF8 RC4（vMajor=1/vMinor=1）は 40 ビット鍵を使用し、2025 年時点では破られた暗号化と見なされます。本機能は Excel の古典的パスワード保護 UI との互換性のために使用してください。機密データの保護用途には適しません。本格的なセキュリティが必要な場合は XLSX + AES を使用してください。
      
    

      バージョン 2.31.0
      
        IXLSWorkbook に UseSharedFormulas プロパティを追加しました。True に設定すると、BIFF8形式のSaveAs時に、テンプレート数式を共有するセルがネイティブのSHRFMLAレコード（$04BC）にグループ化され、Microsoft Excelのコンパクトな出力形式と一致します。=A1*B1、=A2*B2、…、=A99*B99 のような列数式は自動的にグループ化され、テンプレート数式が多いシートではファイルサイズが30〜60%削減されます。
        グループ化は列方向下向き、連続、テンプレートベースで行われます：同じ列の連続する行でPTGが等価な数式を持つセルのみがグループ化されます。配列数式やセル結合フラグを持つセルは除外されます。
        デフォルト値は False で、既存のセルごとのFORMULAレコード出力は変更されません。SaveAs を呼び出す前に Workbook.UseSharedFormulas := True を設定することで機能を有効化できます。
        読み取り側は影響を受けません。新しいパブリックプロパティが追加され、機能有効時にBIFF8出力形式が変わるため、MINORバージョンアップ（2.30.x → 2.31.0）となります。
      
    

      バージョン 2.30.6
      
        RAD Studio 37.0のclangベースbcc32コンパイラでC++Builderデモをビルドする際の第4の種類のコンパイルエラーを修正しました：インターフェイスのスマートポインタに ->Borders[idx]->Prop のインデックス構文を使用するとエラーE5843（「メンバー参照型はポインタではありません」）が発生していました。すべての箇所を ->Borders->Item[idx]->Prop に変更しました。この修正はApiTour、ExportWithColoring、PurchaseOrder、QuickStartデモに適用され、9つのC++Builderデモプロジェクト全体でclangとの完全な互換性が確立されました。
      
    

      バージョン 2.30.5
      
        9つのC++Builderデモプロジェクトがすべて、RAD Studio 37.0のclangベースのbcc32コンパイラでクリーンにビルドできるようになりました。3種類のコンパイルエラーを修正しました：lxFormulaのプロパティEOFをIsEofに改名してC標準ライブラリstdio.hマクロとの競合を解消；C++Builderデモコード内のXLS API列挙定数（xlHAlignCenter、xlAround、xlMediumなど）にLxhandle::名前空間修飾子を明示的に追加；XLSXセル値の代入をOleVariant(...)からVariant(...)に変更（TXLSXCell.ValueはSystem::Variant型であり、clangコンパイラが保護基底クラスOleVariantからの暗黙の変換を拒否するため）。
      
    

      バージョン 2.30.4
      
        OrderCalc デモ（Delphi 購買注文サンプル）は、既存の XLS・HTML・RTF 形式に加えて XLSX エクスポートオプションをサポートするようになりました。保存ダイアログで「Excel 2007+ (*.xlsx)」を選択すると、ネイティブの TXLSXWorkbook API を使用して購買注文書が書き出され、フォント・塗りつぶし・罫線・配置・数値フォーマット・Excel 数式を含む標準準拠の XLSX ファイルが直接生成されます。
      
    

      バージョン 2.30.3
      
        SaveXLSWorkbookAsXLSX（対象ファイル名が .xlsx で終わる場合に TDataToXLS.SaveAs および TGridToXLS.SaveAs が使用するブリッジ）が、元となる XLS ワークブックからセルの背景塗りつぶし色、フォント色、フォントスタイル属性（名前、サイズ、太字、斜体）を XLSX 出力にコピーするようになりました。意図的に狭くしたデコレーション列も含め、列幅も引き継がれます。以前は値と数値書式のみが転送されていたため、XLSX 出力にはスタイルが反映されず、すべての列幅がデフォルト値のままで、意図的に狭くした列が過剰に広い空列として表示されていました。
      
    

      バージョン 2.30.2
      
        XLS リーダーで Open 後に Outline.SummaryRow の方向が反転する round-trip バグを修正しました。WSBOOL レコードの fRwSumsBelow フラグ (BIFF8 仕様 p278 byte 0 bit 6、マスク $0040) は「集計行が詳細の*下*に表示される」を意味しますが、パーサーは以前ビットがセットされているときに SummaryRow = xlAbove (クリアされているときに xlBelow) を設定していました -- 仕様とちょうど逆です。ライター側は既に正しく ($0040 を xlBelow に対して emit) 動作していたため、「集計行が詳細の下」設定の Excel ファイルを HotXLS で開き再保存すると、outline の方向が静かに「上」に反転していました。パース方向が仕様とライターに一致するようになり、outline 設定が正しく round-trip するようになりました。fColSumsRight ($0080) は既に正しく扱われており変更ありません。
      
    

      バージョン 2.30.1
      
        XLS (BIFF8) ライターがワークブック globals セクションに INTERFACEHDR / INTERFACEEND / WRITEACCESS レコードを emit するようになり、Microsoft Excel のネイティブなレコード レイアウトに一致するようになりました。ネイティブ Excel は常にこの 3 つを CODEPAGE/DSF と WINDOW1 の間に書き込み、より厳格な BIFF リーダー / Office File Validation パスはこれらを要求する場合があります。INTERFACEHDR は code page (1200、UTF-16) を、INTERFACEEND は空のマーカーを、WRITEACCESS は「保存者」ユーザー名 (現在は "HotXLS" にハードコード。将来のリリースで Workbook プロパティに昇格する可能性あり) を保持します。出力される XLS ファイルが Excel のネイティブなバイト レイアウトにより近づきました。
      
    

      バージョン 2.30.0
      
        クラシックから XLSX へのエクスポート ブリッジを追加しました。TDataToXLS.SaveAs と TGridToXLS.SaveAs は、既存の .xls、.html、.rtf パスを変更せずに、.xlsx ファイル名を XLSX エンジン経由で書き込むようになりました。
        XLS および XLSX 用のワークシート ビュー API を追加しました。IXLSWorksheet.View と TXLSXWorksheet.View は通常ビュー、改ページ プレビュー、ページ レイアウト ビューをサポートし、設定は該当するファイル ライター/リーダー パスによって保持されます。
        クラシック ワークブック互換性 API を追加しました: IXLSWorkbook.SetCodePage および IXLSWorkbook.VBAProject。VBA プロジェクトは、ワークブックに VBA ストレージが含まれている場合、TXLSVBAProject/TXLSVBAModule のモジュール名とソース テキストを通じて検査できるようになりました。
        TXLSXWorkbook を ParsedVBAProject で拡張しました。これは有効な vbaProject.bin ペイロードに対する読み取り専用のパース済みビューであり、既存の VbaProject の生バイト round-trip 動作を維持します。
        DevExpress cxGrid エクスポート ワークフロー用のオプション ユニット cxGridAddExcel を追加しました。これは意図的にデフォルト パッケージに含まれていないため、DevExpress なしのインストールでもクリーンにビルドできます。
        ワークブックを Excel で開いたときにチャートが空に表示される XLSX チャート シートのレンダリングを修正しました (新しく開いたチャート シートは右上に 3 つのチャート コンテキスト アイコンを一瞬表示してから削除し、シートが空のまま残されました)。チャート シートの描画は、cx=0/cy=0 の <xdr:twoCellAnchor> の代わりに、明示的な範囲 (~10in × 7.2in = 9525000 × 6858000 EMU) を持つ <xdr:absoluteAnchor> を使用するようになりました。チャート シートには twoCellAnchor を解決するためのセル グリッドがないため、Excel はサイズ ゼロの内部 xfrm にフォールバックし、チャートをゼロ ピクセルでレンダリングしていました。ECMA-376-1 14.2.3.2 によると、チャート シートの描画は absoluteAnchor を使用する必要があります。ワークシートのチャート アンカーは変更されていません。
      
    

      バージョン 2.29.4
      
        シート レベルの autoFilter とテーブルが同じ範囲をカバーするワークブック (例: MemoryDataExport デモの XlsxFeatureGallery.xlsx Details シートで、AddTable('SalesTable', 'A1:F9', ...) の後に SetAutoFilter('A1:F9') を呼んだもの) で Excel の修復プロンプト「<file>.xlsx の一部の内容に問題が見つかりました」を引き起こす XLSX パッケージング バグを修正しました。OOXML は同じ範囲に 2 つのフィルター メカニズムを許可しません。ライターは、シート レベルの <autoFilter> がいずれかのテーブルの範囲と一致する場合、重複した出力を抑制するようになりました。テーブル独自の autoFilter (テーブル ヘッダーのドロップダウンとしてレンダリング) は引き続き機能します。
        <dataValidation> 出力で関連するスキーマ違反を修正しました: operator 属性がすべての validation に対して emit されていましたが、ECMA-376-1 18.3.1.32 はこれを whole / decimal / date / time / textLength 型にのみ許可します。AddListValidation は type="list" を生成し、以前は operator="between" を漏出していました。OFV はこの点について Excel より厳格で、ワークブックを拒否することがありました。operator 属性は list / custom / none に対して省略されるようになりました。
        内部および外部ハイパーリンクとコメントを混在させるシート (XlsxFeatureGallery.xlsx Dashboard シートには 1 内部 + 1 外部 + 1 コメントがあります) 上の <legacyDrawing r:id="..."/> 要素を修正しました。rId 計算は外部リンクだけでなくすべてのハイパーリンクをカウントしていた (内部リンクはインラインの location= 属性を使用し rId を消費しません) ため、legacyDrawing は vmlDrawing ターゲットではなく comments rels ターゲットを指していました。ECMA-376-1 18.3.1.51 は legacyDrawing が vmlDrawing 型 rels を参照することを要求します。rId は外部ハイパーリンク数からのみ計算されるようになりました。
        また、AddChartSheet で追加されたチャート シート用の冗長な xl/worksheets/_rels/sheetN.xml.rels ファイルの emit を停止しました。重複した関係ファイルは存在しないワークシート パートを指しており、.xlsx zip 内に孤児として現れていました。チャート シートは今や正しい xl/chartsheets/_rels/sheetN.xml.rels のみを書き込みます。
        MemoryDataExport デモ (XlsxFeatureGallery) を更新し、Details シートでの冗長な SetAutoFilter('A1:F9') 呼び出しを削除しました -- AddTable は既にテーブル範囲に autoFilter を追加するため、余分な呼び出しは上記の OFV 拒否を引き起こしていました。ライターの防御的な抑制は、デモ更新を受け取らない顧客コードをカバーします。
      
    

      バージョン 2.29.3
      
        Open + modify + SaveAs の後で otherwise-empty な行に描画された borders が削除される XLSX round-trip リグレッションを修正しました。ApiTour の行 8 の水平区切り線 (データのない行への Range.SetBorders 呼び出しで生成) は新しく生成された ApiTour.xlsx では正しくレンダリングされていましたが、デモの Modify パスがファイルを再保存した後の ApiTour-XLSX-Modified.xlsx では消えていました。これにより Excel は修正されたファイルでのみ C8 / D8 の縦のグリッド線が途切れて表示されていました (元の ApiTour.xlsx は影響を受けず)。XLSX パーサーは、`<c>` 要素が自己クローズまたは value/formula の子を持たない場合にもセル スタイルを適用するようになり、スタイル付きの値なしセルが round-trip を生き残るようになりました。
      
    

      バージョン 2.29.2
      
        Open + modify + SaveAs フローにおける XLSX round-trip リグレッションを修正しました。ParseWorksheetXml が、styles.xml の cellXf を参照する <c s="N"/> を持つセルを読み込むと、N を cell.FormatIndex に直接保存していました。SaveAs では cellXfs がワークブックのスタイル プールから再構築され (オプションの複合エントリを含む)、同じ数値インデックスにある新しいレイアウトのスロットはほとんど同じセマンティクスを持ちません。再保存されたセルは間違った cellXf を指す (または新しい cellXfs テーブルの末尾を超える) ことになり、Excel は「Office がこのファイルに問題を検出しました。回復を試みることができます」と報告していました。ApplyStyle は cellStyle を、ParseStylesXml がすでに populate している CellXfXxxMap テーブルを介して FontIndex / FillIndex / BorderIndex / NumberFormatIndex / AlignmentIndex / ProtectionIndex に逆マッピングするようになり、round-trip は新しく構築された cellXfs に対してセルを再 emit します。
      
    

      バージョン 2.29.1
      
        ApiTour デモで明らかになった 2 つの XLSX レンダリング リグレッションを修正しました: (1) Range.SetBorders 呼び出しが非単調な順序でセルを追加すると (例: outline パスが A8/C8 を作成し、inside パスが B8 を作成 -- 出力は A8 / B8 / C8 / の代わりに A8 / C8 / B8 /)、行内のセルが列順序から外れて emit される可能性があり、Excel は「Office がこのファイルに問題を検出しました」と報告し Protected View を強制していました。XLSX ライターは、OOXML CT_Row スキーマに一致するように emit 前に各行のセルを列でソートするようになりました。(2) 2 つ以上のスタイル インデックスを同時に設定するセル (Font + Fill + Border 等) は、優先チェーンを経由して 1 次元の cellXf に折りたたまれていました (FontIndex が勝ち、Border / Fill が削除)。例えば Range[..].SetBorders に FontIndex + FillIndex + BorderIndex を設定するヘッダー行は borders なしでレンダリングされていました。ライターは SaveAs 中に複合 cellXf プールを収集し、複次元セルをすべての次元を保持する合成 cellXf にルーティングするようになりました。
      
    

      バージョン 2.29.0
      
        内部ヘルパー unit `lxList2` を `lxKeyList` にリネームし、`lxList` の WideString-key クラスを `TXLSKeyList` / `TXLSKeyEntry` / `TXLSKeyArray` から `TXLSStringKeyList` / `TXLSStringKeyEntry` / `TXLSStringKeyArray` にリネームしました。これにより unit 名がメイン クラス `TXLSObjectKeyList` と一致し、2 つの key-list 世代が自己記述的になります (`TXLSStringKey*` がレガシー WideString-key プール、`TXLSObjectKey*` が THashtableKey ベースの dedup プール)。コードが古い unit 名やクラス名を参照している場合は、uses 句と型名を適宜更新してください。
      
    

      バージョン 2.28.3
      
        otherwise-empty な行に設定された borders が消える XLSX セル emit リグレッションを修正しました。行 8 にデータのないシート上での `Range[''A3:C10''].SetBorders(xlsxEdgeOutline,...)` は、ライターが Value 未割り当ての任意のセルをスキップしていた -- セルが BorderIndex / FontIndex / FillIndex / NumberFormatIndex / AlignmentIndex / ProtectionIndex を持っていてもスキップしていた -- ため、その行の C/D 縦グリッド線が途切れてレンダリングされていました。ライターは、任意のスタイル インデックスを持つ値なしセルに対して `<c r='..' s='..' />` を emit するようになりました。
      
    

      バージョン 2.28.2
      
        Excel が merged cells と AutoFilter を組み合わせたシートのロードを拒否する XLSX ワークシート スキーマ違反を修正しました。XLSX ライターは、OOXML CT_Worksheet シーケンス (autoFilter は #11、mergeCells は #15) に従って、<mergeCells> の前に <autoFilter> 要素を emit するようになりました。以前は、このようなワークブックは sheet1.xml で `Load error. Line 1, column 0` という Excel の修復ダイアログをトリガーし、リカバリーは兄弟 Details シートから tableParts / autoFilter も削除していました。
      
    

      バージョン 2.28.1
      
        クラシックなXLSインターフェースに便利なAPIを追加しました。IXLSRangeは、読み取り専用のWidthとWidthInPixelsヘルパーを提供し、さらにSaveAsCSV(FileName)メソッドを公開します。IXLSWorksheetとIXLSWorkbookは、使用範囲またはアクティブなシートに対して、SaveAsCSV(FileName / Stream)メソッドのオーバーロードを提供します。IXLSPageSetupは、Order、Draft、BlackAndWhite、PrintNotes、および読み取り専用のIsFitToPagesプロパティを公開します。SETUPレコードの保存/読み込み時に、これらの印刷設定が保持されるようになりました。
      
    

      バージョン 2.28.0
      
        TXLSXWorkbook に、RTF エクスポート機能を追加しました。新しい SaveAsRTF メソッド（FileName / Stream、default-active-sheet / explicit SheetIndex を引数とするオーバーロード）により、選択されたシートを、プレーンなテーブルを含む RTF 1.6 ドキュメントとして保存できます。列幅は、シートの ColWidth データから取得されます（1 Excel 文字単位は約 96 RTF twips）。明示的に幅が設定されていない列は、StandardWidth が設定されている場合はそれを使用し、そうでない場合は 809 twips（約 8.43 文字）を使用します。セルの太字（\\b）、イタリック（\\i）、およびフォントサイズ（\\fsN、単位はハーフポイント）は、セルの FontIndex から適用されます。非 ASCII 文字は、RTF 1.6 §2.4.2 に従って、符号付き 16 ビットの RTF \\uN? Unicode エスケープとしてエンコードされ、BMP 全範囲をカバーします。結合されたセルは、結合範囲の開始セルにコンテンツが含まれ、範囲内の他のセルは空のセルとして出力されます。デフォルトの SheetIndex はアクティブなシートを書き込みます。範囲外の場合は -1 を返します。空のシートは、最小限の有効な RTF ドキュメントを生成します。
      
    

      バージョン 2.27.0
      
        TXLSXWorkbookにHTMLエクスポート機能を追加しました。新しいSaveAsHTMLメソッド（FileName / Stream、default-active-sheet / explicit SheetIndexのオーバーロード）により、選択されたシートをUTF-8エンコードのHTMLドキュメント（UTF-8 BOM付き）として書き出すことができます。出力は、最小限のHTMLページ内に<table>タグで囲まれた内容になります。結合されたセルは、colspanおよびrowspan属性で表現されます。セルのスタイルは、インラインCSSとして出力されます。具体的には、フォントファミリー、サイズ（pt）、太字（font-weight:bold）、イタリック（font-style:italic）、取り消し線（text-decoration:line-through）、および明示的なフォントカラーです。塗りつぶしは、background-color属性で表現されます。水平方向の配置（左寄せ / 中央寄せ / 右寄せ / 両端揃え）およびWrapText（white-space:pre-wrap）もサポートされます。日付の表示形式は'yyyy-mm-dd hh:nn:ss'です。リッチテキストセルは、連結されたテキストに変換されます。テーマカラーは、単純なHTMLエクスポートでは無視されます（theme1.xmlは解決されません）。Default SheetIndexでは、アクティブなシートが書き出され、範囲外の場合は-1が返されます。
      
    

      バージョン 2.26.0
      
        TXLSXFont、TXLSXFill、およびTXLSXBorderEdgeに、テーマカラー、インデックスカラー、およびティント/シェードのサポートを追加しました。各カラー設定には、既存のRGBカラーに加えて、以下の3つの新しいフィールドがあります。ColorTheme（整数; -1 = 未設定; 0～11 = OOXMLのテーマスロット）、ColorIndex（整数; -1 = 未設定; 0～63 = OOXMLのレガシーパレットスロット — Workbook.IndexedColor[N]およびXlsxDefaultIndexedPaletteとペア）、およびTintAndShade（[-1.0, 1.0]の範囲の倍精度浮動小数点数; テーマカラーの場合にのみ出力されます）。TXLSXFillは、これら3つのすべてのカラー設定について、フォアグラウンド/バックグラウンドのバリアントを提供します。カラーの優先順位は、テーマ > インデックス > RGBです。以前の"ColorIsAuto = True"の動作は、要素全体を完全に抑制し続けます。SaveAsおよびOpen機能では、フォント、塗りつぶし、および境界線のカラー設定において、`<color theme="N" tint="..."/>`および`<color indexed="N"/>`のすべての属性が完全に保持されます。内部処理: TXLSXBorders.LookupOrAddは、これら3つの新しいフィールドをすべて比較するため、テーマカラーの境界線が、カラープール内のRGBカラーのエントリと衝突するのを防ぎます。
      
    

      バージョン 2.25.0
      
        TXLSXWorkbook クラスに、外部ワークブックへのリンクの双方向操作機能を追加しました。 新しい型として、TXLSXExternalLink (ターゲット URL とシート名リスト) と、TXLSXExternalLinks コレクションを導入しました。 TXLSXWorkbook.ExternalLinks プロパティは、このコレクションを公開します。 Add(Target) メソッドは、新しいリンクをコレクションに追加し、呼び出し元に返します。 SaveAs メソッドは、ワークブックレベルで xl/workbook.xml に `<externalReferences>` ブロックを生成し、xl/_rels/workbook.xml.rels に `externalLink` リレーションを生成します (既存の RID の範囲の末尾に配置し、既存の RID を維持します)。 また、各エントリに対して xl/externalLinks/externalLink{N}.xml ファイルと、リモートワークブックの URL を指す .rels ファイルを生成します。 このファイルには、`TargetMode="External"` が設定され、対応する ContentType Overrides も設定されます。 Open メソッドは、index 1 から `externalLink{N}.xml` ファイルと対応する `.rels` ファイルのペアを読み込み、最初のギャップで停止します。 現在のリリースでは、ターゲット URL とシート名のみが双方向でサポートされており、`<sheetDataSet>` 内にキャッシュされたセルの値は保持されません。
      
    

      バージョン 2.24.0
      
        TXLSXRange.SetBorders ヘルパー関数を追加しました。新しい TXLSXBorderEdgeKind 列挙型 (xlsxEdgeAll / Outline / Inside / InsideHorizontal / InsideVertical / Top / Bottom / Left / Right / DiagonalUp / DiagonalDown) を導入し、どのエッジに書き込むかを指定します。SetBorders(Kind, Style, Color) / SetBorders(Kind, Style) (デフォルトは不透明な黒) は、範囲内のすべてのセルに対して実行され、各セルの位置に基づいてエッジマスクを計算します (角のセルは 2 つのアウトラインエッジ、端のセルは 1 つ、内側のセルは内部のグリッド線など)。Style と Color をセルの現在のボーダーのコピーに適用し (これにより、連続する Outline + Inside の呼び出しは上書きされずに積み重ねられます)、ワークブックレベルで Workbook.Borders を検索または追加し、結果の 1 ベースの BorderIndex をセルに書き戻します。新しい TXLSXBorders.LookupOrAdd ヘルパー関数は、空のボーダーの場合は 0 を返します。これにより、無効なエントリによるメモリ消費を抑えます。
      
    

      バージョン 2.23.0
      
        TXLSXWorkbookクラスに、CSVエクスポートのオーバーロードを追加しました。新しいエントリーポイントとして、以下のメソッドが提供されます: SaveAsCSV(FileName) / SaveAsCSV(FileName, SheetIndex, Delimiter) / SaveAsCSV(Stream) / SaveAsCSV(Stream, SheetIndex, Delimiter)。これらのメソッドは、指定されたシートのデータ範囲をUTF-8エンコーディングで、先頭にBOM（Byte Order Mark）を付加し、CRLF（Carriage Return Line Feed）の行末記号を使用してファイルに書き込みます。デフォルトのバリエーションでは、アクティブなシートが選択され、カンマが区切り文字として使用されます。SheetIndex/Delimiterオーバーロードでは、任意のWideChar（通常はタブ文字#9でTSVファイルを作成）を使用できます。フィールドの引用符の処理は、RFC 4180に従います。区切り文字、二重引用符、CR、またはLFを含む値は、引用符で囲まれ、二重引用符は二重化されます。日付値は 'yyyy-mm-dd hh:nn:ss' の形式で表示されます。リッチテキストセルは、連結されたテキストに変換されます。データ範囲内の空のセルは、区切り文字として扱われ、行は最後のデータが入力された列で終了します。
      
    

      バージョン 2.22.0
      
        TXLSXWorkbookクラスに、ワークブックレベルでのインデックス付きカラーパレットのオーバーライド機能を追加しました。新しい機能は以下の通りです。 - `IndexedColor[Index: Integer]: LongWord`: (読み取り/書き込み可能。有効な範囲は0～63。ARGBのLongWord形式) - `HasCustomIndexedColor(Index): Boolean`: (呼び出し元が特定のインデックスのカラーパレットをオーバーライドしているかどうかを報告します) - `CustomIndexedColorCount: Integer`: (オーバーライドされたインデックスの数。0はデフォルトのパレットを使用していることを意味します) - `ResetIndexedColors: procedure`: (すべてのオーバーライドを破棄します) 新しい定数 `XlsxDefaultIndexedPalette` は、OOXMLのレガシーECMA-376パレットをインデックス0～63で使用します。`SaveAs` メソッドでは、少なくとも1つのインデックスがオーバーライドされている場合にのみ、`<colors><indexedColors>` セクションと、その64個の `<rgbColor>` 子要素を出力します。変更されていないインデックスはデフォルトのパレットを使用するため、変更のないファイルの再保存は元の状態が維持されます。`Open` メソッドは、デフォルト値と一致するインデックスを解析し、サイレントに無視するため、データの丸め誤差を最小限に抑えます。範囲外のインデックス（0未満または63より大きい）はエラーを発生させる代わりに無視されます。
      
    

      バージョン 2.21.0
      
        TXLSXWorksheetクラスに、シート表示に関する6つのプロパティを追加しました。Zoom: 整数で、Excelのステータスバーに表示されるズーム率を表します（10～400、デフォルトは100。範囲外の値は書き込み時に制限されます）。DisplayGridLines / DisplayZeros: ブール値（デフォルトはTrue）。Falseに設定すると、セルのグリッド線が非表示になったり、ゼロ値のセルが空として表示されたりします。DisplayRightToLeft: ブール値（デフォルトはFalse）。アラビア語/ヘブライ語などの言語向けに、シートを右から左へのレイアウトに切り替えます。StandardWidth / StandardHeight: double型の値で、デフォルトの列幅（Excelの文字単位）/デフォルトの行の高さ（ポイント）を設定します。0の場合、設定されず、Excelのデフォルト値（8.43 / 15）が適用されます。SaveAsメソッドは、これらの値がExcelのデフォルト値と異なる場合にのみ、`<sheetView showGridLines / showZeros / rightToLeft / zoomScale>`および`<sheetFormatPr defaultColWidth / defaultRowHeight>`を生成します。Openメソッドは、これらの属性をExcelのデフォルト値に戻します。既存のfreeze-pane（固定ペイン）とtab-selected（タブ選択）の処理は`<sheetView>`で変更されていません。これらは、単一の出力エンジンを共有しています。
      
    

      バージョン 2.20.7
      
        TXLSXWorkbook クラスに、インメモリでのシリアライズを行うための TStream オーバーロードを追加しました。新しい機能として、SaveAs(Stream: TStream) / SaveAs(Stream: TStream; FileFormat: TXLSXFileFormat) メソッドは、指定されたストリームに .xlsx ファイル全体を書き込みます（現在の位置から開始）。Open(Stream: TStream) メソッドは、ストリームからファイルを読み込みます。呼び出し元はストリームの所有権を持ち、解放する必要があります。これは、HTTP レスポンス、Blob ストレージ、インメモリパイプライン、およびローカルファイルシステムをバイパスするユニットテストに役立ちます。既存のファイルベースの SaveAs / Open オーバーロードは変更されておらず、同じ内部の書き込み/読み込みヘルパーに委譲されます。
      
    

      バージョン 2.20.6
      
        TXLSXDefinedName クラスに、Hidden、Visible、Comment プロパティを追加しました。Hidden プロパティは、OOXML の `<definedName hidden="1"/>` 属性に対応します（デフォルトは False、Visible は True です。True にすると、名前が Excel の名前管理 UI から非表示になります）。Visible プロパティは、Hidden プロパティの真偽値の反転であり、コードの可読性を向上させるためのエイリアスです。Comment プロパティは、`<definedName comment="..."/>` に対応します。SaveAs メソッドは、これらの属性がデフォルト値と異なる場合に、両方の属性を出力します。Open メソッドは、これらの属性を解析して復元します。SheetIndex (既存の Local スコープのバインディングで、localSheetId を使用) は変更ありません。
      
    

      バージョン 2.20.5
      
        TXLSXFontクラスに、さらに5つのフォント属性を追加しました。新しいTXLSXFontVertAlign列挙型（xlsxVertAlignBaseline / Superscript / Subscript）を導入し、既存のExcelの「上付き文字」/「下付き文字」チェックボックスを、単一のVertAlignプロパティで制御するようにしました（UI上では相互排他的）。対応するExcelのフォント効果であるアウトラインフォントとシャドウのBooleanプロパティ（OutlineFont、Shadow）を追加しました。新しいInteger型のFamily（OOXMLフォントファミリー番号：1=Roman / 2=Swiss / 3=Modern / 4=Script / 5=Decorative; 0=未設定）とCharSet（GDI文字セット番号：0=ANSI / 1=Default / 134=GB2312 / 136=ChineseBig5 / など; -1=未設定）プロパティを追加しました。SaveAsメソッドは、対応する`<vertAlign>` / `<outline/>` / `<shadow/>` / `<family>` / `<charset>`の子要素を`<font>`要素内に生成します。Openメソッドは、これらを解析して復元します。ColorIndex / ThemeColor / TintAndShadeは、今後のテーマ関連の機能で実装予定です。
      
    

      バージョン 2.20.4
      
        ボーダーの斜め方向設定オプションを追加しました。`TXLSXBorder` クラスで、`DiagonalUp: Boolean` と `DiagonalDown: Boolean` プロパティを公開しました。これらのフラグは、既存の `Diagonal` エッジのスタイルと色を共有し、Excel がどの斜め方向を描画するかを制御します。設定可能なのは、上方向のみ（左下から右上）、下方向のみ（右上から左下）、または両方向です。`SaveAs` メソッドは、これらのフラグが設定されている場合に、`<border>` 要素に `diagonalUp` および `diagonalDown` 属性を出力します。`Open` メソッドは、これらの属性を解析して復元します。以前は、方向制御なしで単一の `Diagonal` エッジのみが書き込まれていたため、Excel はどちらの斜め線も描画しませんでした。
      
    

      バージョン 2.20.3
      
        ワークブックの `Date1904` オプションを追加しました。`TXLSXWorkbook` クラスは、`Date1904: Boolean` プロパティを公開し、Windows 1900 年代 (デフォルト; Windows 版 Excel と同じ) と、Mac 1904 年代 (Mac 版 Excel のレガシー) のいずれかを選択できます。`SaveAs` メソッドは、`date1904="1"` を `xl/workbook.xml` に出力します。`Open` メソッドは、この値を読み込みます。このフラグはメタデータのみであり、エンジンは格納されたシリアル値を変換しません。呼び出し元は、`TDateTime` セル値を設定する前に `Date1904` を設定する必要があります。これにより、データのやり取りが正しいカレンダーで処理されるようになります。
      
    

      バージョン 2.20.2
      
        ソースデータごとに自動フィルタの条件をサポートしました。 新しい型として、`TXLSXAutoFilterOp` 列挙型 (Equal / NotEqual / GreaterThan / LessThan / GreaterOrEqual / LessOrEqual)、`TXLSXAutoFilterColumn` クラス (ColId + 1つまたは2つの条件 + AND/OR 接続子)、および `TXLSXAutoFilterColumns` コレクションが追加されました。 `TXLSXWorksheet` クラスは、`AutoFilterColumns` プロパティと、`AddAutoFilterColumn(ColId, Op, Criteria) / AddAutoFilterColumn(ColId, Op1, Criteria1, Op2, Criteria2, AndConnector) / ClearAutoFilterColumns` などの便利なメソッドを公開します。 `SaveAs` メソッドでは、既存の `<autoFilter ref="..."/>` を拡張し、条件が設定されている場合は、各列に対して `<filterColumn colId=N><customFilters and=0|1><customFilter operator="..." val="..."/>...</customFilters></filterColumn>` のような構造体を生成します。 `Open` メソッドは、同じ構造体を解析します。 以前は、エンジンは自動フィルタの範囲 (sqref) のみ保存しており、Excel ではフィルタのドロップダウンが空表示されていました。
      
    

      バージョン 2.20.1
      
        TXLSXWorksheet に、手動ページ区切り機能を追加しました。新しいメソッドとして、`AddRowBreak(BeforeRow)` と `AddColBreak(BeforeCol)` を追加し、指定された行または列の前に、水平または垂直のページ区切りを挿入します（Excel の UI での "Before" の意味合いと同様に、行 N から新しいページを開始します）。`HasRowBreak` / `HasColBreak` でページ区切りの有無を確認できます。`RemoveRowBreak` / `RemoveColBreak` で、単一のページ区切りを削除できます。`ClearRowBreaks` / `ClearColBreaks` / `ClearAllPageBreaks` で、複数のページ区切りを一括で削除できます。`RowBreakCount` / `ColBreakCount` で、格納されている 1 ベースの "Before" インデックスの数を取得できます。また、`RowBreaks(Index)` / `ColBreaks(Index)` で、インデックスを使用して個々のページ区切りにアクセスできます。`SaveAs` メソッドでは、`<headerFooter>` と `<drawing>` の間に、`<rowBreaks>` / `<colBreaks>` を `<brk id="N-1" max="..." man="1"/>` という子要素とともに出力します。`Open` メソッドでは、これらの要素を解析して読み込みます。
      
    

      バージョン 2.20.0
      
        TXLSXWorkbook、TXLSXSheets、TXLSXWorksheetにおいて、シートの可視性（非表示/非常に非表示）、シートごとの選択、およびアクティブシートの追跡機能を追加しました。 新しい型: TXLSXSheetVisibility enum (xlsxSheetVisible / xlsxSheetHidden / xlsxSheetVeryHidden)。 新しいTXLSXWorksheetのプロパティ: Visibility、Visible (Booleanのエイリアス)、IsSelected (読み取り専用)。 新しいTXLSXSheetsのメンバー: ActiveIndex、Activate(Index)、Move(FromIndex, ToIndex)。 新しいTXLSXWorkbook.ActiveSheet プロキシ。 SaveAsは、ワークブックのシートエントリに`<sheet state="...">`を、アクティブシートがデフォルトの0でない場合に`<bookViews><workbookView activeTab=N/></bookViews>`を、アクティブシートの`<sheetView>`に`tabSelected="1"`を生成します。 Openは、これらすべてを新しいプロパティに解析します。 最初に追加されたシートは、デフォルトで可視かつアクティブになるため、既存の呼び出し元は引き続き動作します。
      
    

      バージョン 2.19.2
      
        TXLSXWorksheetクラスに、OOXML `<pageSetup>` の機能をより網羅的にサポートするために、以下の4つのPageSetup属性のトグルを追加しました。これらは、BlackAndWhite（白黒レンダリング）、Draft（プレビューの高速化のためにグラフィックスを抑制）、PrintNotes（セルコメントを非表示にする代わりに表示して印刷）、そしてPrintOverThenDown（デフォルトの縦方向ではなく、横方向にデータを配置）です。SaveAs関数は、対応するblackAndWhite、draft、cellComments、pageOrder属性を出力し、Open関数はそれらを解析します。デフォルトではこれらの機能はオフになっており、変更されていないワークシートには追加の属性が付加されることはありません。
      
    

      バージョン 2.19.1
      
        TXLSXWorksheetクラスに、ヘッダーとフッターを簡単に設定できる便利なプロパティを追加しました。 新しい項目として、LeftHeader、CenterHeader、RightHeader、およびLeftFooter、CenterFooter、RightFooterがあります。 それぞれが、既存のHeaderText/FooterTextの対応する&L、&C、&Rセグメントを読み書きします。 いずれかのセグメントを書き込むと、完全なraw文字列が再構築されるため、ラウンドトリップの書き込みと読み込みが変更なしに動作します。
        シートレベルのページ出力のための印刷オプションのトグルを追加しました。 新しいTXLSXWorksheetプロパティ：CenterHorizontally, CenterVertically, PrintGridlines, PrintHeadings。 SaveAsメソッドは、これらのいずれかが有効な場合に、`<printOptions horizontalCentered / verticalCentered / gridLines / headings/>`要素を生成します。 Openメソッドは、これらの属性を解析します。 デフォルトではすべてオフになっているため、変更されていないワークシートには余分な`<printOptions/>`要素は追加されません。
        各シートごとに、PrintArea、PrintTitleRows、およびPrintTitleColsのラウンドトリップ機能が追加されました。これらは、OOXMLの組み込みワークブックレベルの_xlnm.Print_Areaおよび_xlnm.Print_Titlesという名前で定義され、localSheetIdによってスコープが指定されます。PrintAreaは、単純なA1形式の参照（例："$A$1:$D$10"）を受け取ります。PrintTitleRowsとPrintTitleColsは、行のみまたは列のみの参照（例："$1:$3"または"$A:$B"）を受け取り、これらを組み合わせて単一のPrint_Titlesエントリとして扱います。書き込み時には、シート名に適切な引用符（スペースや特殊文字を含む名前にはシングルクォート）が追加されます。読み込み時には、このプレフィックスが削除され、エントリは対応するシートに登録されます。これにより、ユーザーが直接操作できるTXLSXWorkbook.DefinedNamesコレクションには登録されません。
      
    

      バージョン 2.19.0
      
        TXLSXWorksheet に、行/列の挿入および削除操作を追加しました。これらの操作は、シート全体にわたるシフトを伴います。新しいメソッドは以下の通りです: InsertRows(BeforeRow, Count), DeleteRows(StartRow, Count), InsertCols(BeforeCol, Count), DeleteCols(StartCol, Count)。InsertRows / InsertCols は、挿入によって削除される行/列よりも前の行/列を Count の分だけ移動させます。DeleteRows / DeleteCols は、[Start, Start+Count-1] の範囲の行/列を削除し、削除された範囲より後の行/列を Count の分だけ上に移動させます。
        この変更は、行/列の位置に依存するすべてのシートのジオメトリに適用されます。具体的には、セルのアンカー (Cells)、結合されたセルの角 (MergedCells – 範囲がまたがる場合は、残っているエッジにクリップされ、完全に範囲内にある場合は削除されます)、行/列のメタデータリスト (FRowHeights / FColWidths / アウトラインレベル / 非表示/折りたたみ)、ハイパーリンクとコメントのアンカー (削除されたバンド内のエントリは削除されます)、FreezePane (FFreezeRow / FFreezeCol)、AutoFilterRange、および、ConditionalFormat、DataValidation、Excel Table の各エントリにおける Range 文字列 (完全に切り取られた範囲内のエントリは削除されます)。
        サポート対象コレクションに、`Delete(Index)` メソッドが追加されました。これにより、`Clear` メソッドを使用せずに、単一のエントリを削除できるようになりました。対象は、`TXLSXHyperlinks`, `TXLSXComments`, `TXLSXConditionalFormats`, `TXLSXDataValidations`, `TXLSXTables` です。
        今回のリリースでは、以下の機能は対象外です。画像とグラフは移動されません（これらのEMUピクセルアンカーはセルグリッドから独立しているため、正確な移動にはEMUオフセットの再計算が必要です）。また、ワークブックレベルのDefinedNamesの数式は書き換えられません。これらの機能は、今後のリリースで対応予定です。
      
    

      バージョン 2.18.2
      
        カラム幅と行の高さの自動調整機能を追加しました。`TXLSXWorksheet` クラスは、`AutoFitColumn(ACol)` / `AutoFitColumns(ColMin, ColMax)` および `AutoFitRow(ARow) / AutoFitRows(RowMin, RowMax)` メソッドを公開します。`TXLSXRange` クラスは、範囲内のワークシートに対して `AutoFitColumns` および `AutoFitRows` メソッドを提供し、これらはそれぞれワークシートの範囲境界を考慮します。幅は、Excel の文字単位（Calibri 11pt、ASCII 文字は 1、CJK 文字は 2）で推定され、1.20 px/文字の補正と 1.0 のパディングが適用されます。値は [8.43, 255.0] の範囲に制限されます。行の高さはデフォルトで 15 pt であり、セル内の改行ごとに 12.75 pt ずつ増加します。広範囲（`EntireRow` / `EntireColumn`）の場合、ワークシート上でデータを含む最後の行/列に制限され、`AutoFit` が Excel のグリッド全体の範囲を反復処理しないようにします。
      
    

      バージョン 2.18.1
      
        XLSXエンジンに、セルごとの保護機能の双方向変換機能を追加しました。`TXLSXCell`クラスには、Excelのセル保護モデルを反映した、新しい便利なプロパティ`Locked: Boolean`（デフォルトはTrue）と`FormulaHidden: Boolean`（デフォルトはFalse）が公開されています。これらのプロパティは、新しいワークブックレベルの`TXLSXProtections`プール内のインデックス`TXLSXCell.ProtectionIndex`（1を基準）を参照します。`Locked`と`FormulaHidden`の組み合わせは、このプール内で検索または追加されます。デフォルト値（`Locked=True`、`FormulaHidden=False`）の場合、`ProtectionIndex`は0となり、標準のセルではプールが空のままになります。
        TXLSXRange クラスに、TXLSXRange.SetLocked(ALocked) と TXLSXRange.SetFormulaHidden(AHidden) というバッチ処理ヘルパーを追加しました。これにより、範囲全体をロック解除または数式を非表示にする際に、1回の検索または追加処理で結果を範囲内のすべてのセルに適用できます。
        対応する書き込み/読み込み機能を追加しました。`SaveAs` は、ワークブックの `Protections` エントリごとに、アライメントブロックの後に、インラインの `<protection locked="N" hidden="M"/>` 子要素を持つ `cellXf` を 1 つ生成します。`Open` は、`<protection>` 要素を `Workbook.Protections` に解析し、`ParseStylesXml` および `ParseWorksheetXml` を通じて新しい `CellXfProtMap` を連携させます。これにより、既存のフォント/塗りつぶし/罫線/数値形式/アライメントのインデックスとともに、セルごとの `ProtectionIndex` が正しく保持されます。
      
    

      バージョン 2.18.0
      
        TXLSXWorksheet オブジェクトに対する、複数セルへのアクセスと一括操作を可能にする TXLSXRange オブジェクトを追加しました。新しい機能として、Worksheet.Range['A1:C5']、Worksheet.RCRange[r1,c1,r2,c2]、Worksheet.UsedRange、Worksheet.EntireRow(r)、Worksheet.EntireColumn(c) が提供されます。返される範囲オブジェクトは、SetValue、SetFormula、Clear、ClearAll、Merge、Unmerge、Offset、Resize などのメソッドに加え、セルごとのスタイルインデックス設定関数 (SetFontIndex、SetFillIndex、SetBorderIndex、SetNumberFormatIndex、SetAlignmentIndex) と、ワークブックのフォーマット文字列を検索または追加する便利なメソッド SetNumberFormat(Fmt) を提供します。TXLSXRange オブジェクトは、ワークシートによって所有され、ワークシートの破棄時に解放されます。呼び出し側は、これらのオブジェクトを解放する必要はありません。
        TXLSXCell クラスに、NumberFormatIndex と連携する便利な機能である TXLSXCell.NumberFormat: WideString が追加されました。読み込み時には、ワークブックからフォーマット文字列を取得し、書き込み時には、文字列を検索または追加し、NumberFormatIndex を自動的に更新します。この機能を使用するには、セルをワークブックに紐付ける必要があります (通常は TXLSXWorkbook.Sheets.Add(...).Cells[r, c] を使用します)。
        TXLSXCell が、外部の管理なしに、自身の所属するワークブックを解決できるように、セルからシート、ワークブックへの参照を追加しました。TXLSXSheets、TXLSXWorksheet、および TXLSXCells クラスに、コンストラクタを通じて内部の Owner 参照を追加しました。TXLSXCell は、読み取り専用の Workbook プロパティと、TXLSXCells.GetItem がアクセス時に自動的にセルを作成する際に使用される内部の SetWorkbook メソッドを公開します。
      
    

      バージョン 2.17.42
      
        XLSXファイルのセルの読み込み/書き込みに関する問題を修正しました。`SaveAs`で書き込まれたセルのデータが、ファイルを開いた際に失われる現象がありました。具体的には、`HasCell(row, col)`が`False`を返し、セルのすべての情報（値、数式、フォントインデックス、塗りつぶしインデックス、罫線インデックス、数値フォーマットインデックス）が失われていました。原因は、ワークシートパーサー内の不要な`MoveToAttribute('r')`呼び出しによるもので、これによりパーサーのノードタイプが属性に変わってしまい、その結果、`IsEmptyElement`チェックが常に`True`を返し、`r=""`属性を持つすべての`<c>`要素（つまり、すべてのセル）の解析が停止していました。この不要なカーソルの移動を削除することで、テキスト、数値、数式、日付セルの読み込み/書き込みが正常に行われるようになりました。
        XLSXファイルのスタイルインデックスの復元に関する問題を修正しました。セルのカスタムフォント、塗りつぶし、罫線、および数値形式のインデックスが、関連するプール（Workbook.Fonts/Fills/Borders/NumberFormats）が正常に処理された後でもゼロとして読み込まれるという問題がありました。`cellXf`パーサーは、位置をカウンターで追跡していましたが、このカウンターは`<xf>`の終了タグでのみ増加していました。しかし、Excelは`<xf .../>`のような自己完結型のタグ（`<alignment>`タグがない）を頻繁に生成するため、カウンターはゼロから動かず、すべての`cellXf`マッピングが前のものを上書きしていました。パーサーは、自己完結型の`<xf/>`タグに対してもカウンターを増加させるように変更されました。これにより、セルごとのFontIndex / FillIndex / BorderIndex / NumberFormatIndexが正しく復元されるようになりました。
        XLSXの日付セルの読み込みと書き込みの問題を修正しました。以前、`TDateTime`を`TXLSXCell.Value`に書き込む際に、共有文字列プールを経由して`t="s"`として扱われていました。これは、Delphiの`VarIsNumeric()`関数が`varDate`に対して`False`を返すためです。現在は、`SaveAs`が日付のシリアル値を直接`<v>`に書き込み、`date cellXf`を適用します。これにより、日付セルは、呼び出し元が`TDateTime`に変換できないローカライズされた文字列ではなく、`varDate`のVariantとして再オープンされます。
      
    

      バージョン 2.17.41
      
        .xlsxファイル（特に、埋め込み画像やVBAプロジェクトを含む.xlsmファイル）を再度開く際に発生する「zlibストリームはシークをサポートしていません」というエラーを修正しました。画像のリロードパスとVBAペイロードのリロードパスの両方で、インフレートされたエントリーストリームが`TMemoryStream.CopyFrom(Source, 0)`を通じて処理されていましたが、これは内部的に`Source`を巻き戻し、バイト数を取得するため、フォワード専用のDeflateストリームでは許可されていません。両方の箇所で、チャンク単位でEOFまで読み込むヘルパー関数を使用するように変更しました。これにより、画像やマクロを含む.xlsxファイルが、`SaveAs/Open`で問題なく処理できるようになりました。
      
    

      バージョン 2.17.40
      
        XLSXエンジンに、チャートシート（フルページのチャートワークシート）のサポートを追加しました。`TXLSXWorksheet`クラスには、新しい`IsChartSheet`フラグが追加され、ワークブックレベルで`Workbook.AddChartSheet(Name, ChartType, Title)`というヘルパー関数が提供されました。この関数は、シートを作成し、フラグを反転させ、`Charts[0]`に適切なデフォルトのアンカーを設定します。`SaveAs`メソッドは、`IsChartSheet`のシートを`xl/chartsheets/sheetN.xml`に保存し、共有ドローイングパーツを指す専用の`rels`ファイルを作成します。また、これらのシートをチャートシートとしてコンテンツタイプを登録し、`xl/_rels/workbook.xml.rels`にチャートシートの関係を記述します。通常のワークシートは、既存の`xl/worksheets/sheetN.xml`のパスを維持します。`Open`関数は、関係タイプに基づいてチャートシートを認識しますが、現在ではプレーンなワークシートとしてロードします（チャートデータは、引き続き共有チャートパーツ経由で読み込まれます）。
      
    

      バージョン 2.17.39
      
        XLSXエンジンにおいて、アウトライングループに対する行の折りたたみ/展開、および列の折りたたみ/展開の機能を追加しました。`TXLSXWorksheet`クラスには、`RowCollapsed[Row]`および`ColCollapsed[Col]`というBooleanプロパティ、および`SetRowCollapsed`、`SetColCollapsed`、`ClearRowCollapsed`、`ClearColCollapsed`というヘルパーメソッドが公開されています。`SaveAs`メソッドは、対応する`<row>`および`<col>`要素に`collapsed="1"`という属性を出力し、`Open`メソッドは、この属性を解析します。既存の`outlineLevel`および`hidden`属性と合わせて、この機能により、XLSXエンジンは完全に折りたたまれたグループ化階層を丸ごと保存・読み込みできるようになります。
      
    

      バージョン 2.17.38
      
        XLSXエンジンに、非表示の行/列の往復変換機能を追加しました。`TXLSXWorksheet`クラスには、`RowHidden[Row]`および`ColHidden[Col]`というBooleanプロパティと、`SetRowHidden`、`SetColHidden`、`ClearRowHidden`、`ClearColHidden`といったヘルパーメソッドが用意されています。`SaveAs`メソッドでは、対応する`<row>`および`<col>`要素に`hidden="1"`属性を出力します。`Open`メソッドは、この属性をワークシートに解析し、非表示の行/列が、カスタムの幅やアウトラインレベルを設定することなく、往復変換を乗り越えられるようにします。
      
    

      バージョン 2.17.37
      
        XLSXエンジンに、ワークシートタブの色に関する双方向変換機能を追加しました。`TXLSXWorksheet`クラスは、`TabColor`（ARGB形式）および`TabColorIsAuto`プロパティを公開します。`SaveAs`メソッドは、タブの色が設定されている場合、`<worksheet>`要素の最初のサブ要素として`<sheetPr><tabColor rgb="..."/></sheetPr>`ブロックを出力します。`Open`メソッドは、`<tabColor>`要素をワークシートに解析し、カラーリングされたワークシートタブが双方向変換を乗り越えられるようにします。デフォルトのワークブックには、この追加のブロックは含まれません（`TabColorIsAuto = True`）。
      
    

      バージョン 2.17.36
      
        XLSXエンジンに、セルの配置に関する双方向変換機能を追加しました。新しい`TXLSXHorizontalAlignment`および`TXLSXVerticalAlignment`のトークン列挙型、`TXLSXAlignment`クラス（`Horizontal`、`Vertical`、`WrapText`、`ShrinkToFit`、`Indent`、`TextRotation`）、およびワークブックレベルの`TXLSXAlignments`コレクション（`Workbook.Alignments`）が導入されました。`TXLSXCell`には、`AlignmentIndex`（`Workbook.Alignments`内の1ベースのインデックス）が追加されました。`SaveAs`メソッドは、各ワークブックの配置エントリごとに、インラインの`<alignment/>`子要素を持つ`cellXf`を1つ追加します。`Open`メソッドは、`<alignment>`属性を`Workbook.Alignments`に読み込み、`cellXf`を`TXLSXCell.AlignmentIndex`にマッピングします。`ParseWorksheetXml`および`ParseStylesXml`メソッドには、このマッピングを渡すための`CellXfAlignMap`パラメータが追加されました。
      
    

      バージョン 2.17.35
      
        XLSXエンジンに、AES暗号化（ECMA-376規格に基づく暗号化）APIを追加しました。`TXLSXWorkbook`クラスは、`SaveAsEncrypted(FileName, Password)`、`OpenEncrypted(FileName, Password)`、`CanReadEncrypted(FileName)`メソッドを提供します。また、`EXlsxEncryptionNotImplemented`という型付き例外も用意されています。`CanReadEncrypted`メソッドは、Microsoft Compound File Binaryのマジックバイト（`$D0 $CF $11 $E0 $A1 $B1 $1A $E1`）を認識するため、呼び出し元は暗号化されたアーカイブかどうかを事前に判定できます。`OpenEncrypted`メソッドは、暗号化されていない`.xlsx`ファイルの場合、自動的に通常の`Open`メソッドにフォールバックします。AES-128/256 + SHA + OLE Compound Fileのパイプライン自体はまだ実装されていません。そのため、実際に暗号化されたアーカイブの読み書きを行うと、`EXlsxEncryptionNotImplemented`例外が発生します。この例外型は、既存の呼び出し元がこれを捕捉し、`Worksheet.Protect`または`Workbook.ProtectWorkbook`を使用して、視覚的なロックを適用できるように、意図的に他の例外型とは区別されています。
      
    

      バージョン 2.17.34
      
        パフォーマンス: 各ワークシートのセル行を構築する際のO(N^2)のWideString結合処理を、TXLSWideStringBuilderに置き換えました。大規模なシート（10,000セル以上）の場合、メモリとCPU使用量がSaveAs操作において線形に保たれます。新しいWriteWorksheetXmlStreamingヘルパーと、TXLSXWorkbook.StreamingWriteオプションを追加しました。このオプションを有効にすると、SaveAs操作で、すべてのワークシートのXMLを同時にsheetXmlsキャッシュに保持しなくなります。各ワークシートは構築され、書き出され、その後すぐに破棄されます。sharedStrings.xmlは最後に書き出されるため、ストリーミングパスでも完全にパブリッシュされたSSTが生成されます。デフォルトの動作は変更ありません。
      
    

      バージョン 2.17.33
      
        XLSXエンジンに、セル範囲操作を追加しました。`TXLSXWorksheet`クラスは、`ClearRange(R1, C1, R2, C2)`（範囲のクリア）、`CopyRange(SrcR1, SrcC1, SrcR2, SrcC2, DstR, DstC)`（シート内コピー）、`CopyRangeTo(... TargetSheet, DstR, DstC)`（シート間コピー）、および`MoveRange(SrcR1, SrcC1, SrcR2, SrcC2, DstR, DstC)`（カット＆ペースト）を提供します。各操作は、セルの値、数式、4つのスタイルインデックス、およびリッチテキストデータを複製します。`MoveRange`は、コピー元とコピー先の範囲が重なる場合でも、一部が重なる部分はコピーされた値を保持します。また、`TXLSXCells`クラスに、`Remove(Row, Col)`ヘルパー関数を追加しました。
      
    

      バージョン 2.17.32
      
        XLSXエンジンに、内部ハイパーリンクのアンカーを追加しました。`TXLSXHyperlink`クラスに、場所を示す`Location`プロパティ（例：「Sheet2!A1」）と、内部リンクかどうかを示す`IsInternal`ヘルパーを追加しました。`TXLSXHyperlinks`クラスに`AddInternal`メソッドを追加し、`TXLSXWorksheet`クラスに、`AddHyperlinkToCell`メソッドの3つのオーバーロードを追加しました。`SaveAs`メソッドは、`location=""`属性を持つ内部ハイパーリンクを生成し、ワークシートのrelsエントリをスキップします。`Open`メソッドは、`location=""`を持つハイパーリンクを認識し、`AddInternal`メソッドを通じて処理します。外部URLハイパーリンクは、relsファイルを通じて変更されずに処理されます。
      
    

      バージョン 2.17.31
      
        XLSXエンジンに、リッチテキストの双方向処理機能を追加しました。新しい`TXLSXRichTextRun`クラス（各実行単位ごとに、名前、サイズ、太字、イタリック、取り消し線、下線、色を設定可能）と、`AddRun`、`AddRunText`、`Clear`、`PlainText`メソッドを提供する`TXLSXRichText`コンテナを導入しました。`TXLSXCell`クラスは、`RichText`プロパティを所有するようになりました。`SaveAs`メソッドは、セルを共有文字列として保存し、複数の`<r>/<rPr>/<t>`要素で構成します。`Open`メソッドは、解析されたSSTエントリから`TXLSXRichText`を再構築し、セルのVariant Valueとして、フォーマットを無視する呼び出し元に対しては、連結されたプレーンテキストを提供します。
      
    

      バージョン 2.17.30
      
        XLSXエンジンに、グラフの往復変換機能を追加しました。新しい`TXLSXChartType`列挙型（棒グラフ/折れ線グラフ/円グラフ）、`TXLSXChartSeries`クラス（Name, CategoriesRange, ValuesRange）、および`TXLSXChart`クラス（ChartType, Title, 軸タイトル, From/Toアンカーセル, Series）を導入しました。また、各ワークシートごとに`TXLSXCharts`コレクション（`Worksheet.Charts`）を提供します。`TXLSXWorksheet`クラスには、`AddChart(Type, Title, FromRow, FromCol, ToRow, ToCol)`メソッドが追加されました。`SaveAs`メソッドは、ワークブック全体で管理される番号付けの`xl/charts/chartN.xml`ファイルを生成し、`xl/drawings/drawingN.xml`内のtwoCellAnchor/graphicFrameにバインドします。`Open`メソッドは、アンカーとグラフ定義の両方をコレクションに解析します。グラフタイトル、軸タイトル、シリーズ名、およびデータソース範囲の往復変換が可能です。
      
    

      バージョン 2.17.29
      
        `SetColWidth`, `SetRowHeight`, `SetRowOutlineLevel`、および `SetColOutlineLevel` によって発生する `EListError`（"ソートされたリストに対して許可されていない操作"）を修正しました。これらの4つの `TStringList` フィールドは、`Sorted=True` で作成されていましたが、`Values[Name] := X` という書き込み方法が使用されていました。RAD Studio の RTL は、ソートされたリストに対してこの書き込み方法を許可していません。そのため、リストはソートされていない状態で作成されるようになりました。検索は引き続き `IndexOfName` を使用して行われますが、これは通常のシートごとの列/行数では問題ありません。
      
    

      バージョン 2.17.28
      
        `TZipArchive.Exists` の問題を修正しました。これは以前は常に `false` を返すだけのプレースホルダー関数でした。XLSX ファイルの読み込み処理では、`zip.Exists(...)` を使用して、すべてのデータの読み込みを制御していました。そのため、以前には読み込み時に、セルのデータ、スタイル、コメント、図、ドキュメントのプロパティ、定義済み名前、保護設定、VBA コードなど、すべての関連データが静かに破棄されていました。`Exists` は、既存の `Fcd.Entries.Exists` の機能を利用するように変更され、`OpenFile` / `CreateFile` の動作と一致するようになりました。
      
    

      バージョン 2.17.27
      
        XLSXエンジンに、VBAプロジェクトの保存機能を追加しました。`TXLSXWorkbook`クラスは、VbaProjectのバイトデータを提供し、`LoadVbaProjectFromFile(FileName)`、`ClearVbaProject`、および`HasVbaProject`といったヘルパー関数を提供します。`SaveAs`メソッドは、これらのバイトデータを`xl/vbaProject.bin`ファイルに書き込み、`.bin`ファイルのコンテンツタイプを登録し、ワークブックのコンテンツタイプをマクロ対応版に変更し、ワークブックのリレーションズファイルに`vbaProject`の関係を追加します。`Open`メソッドは、`xl/vbaProject.bin`ファイルを読み込み、プロパティに格納します。これらのバイトデータは解析または変更されないため、既存の`.xlsm`プロジェクトは完全にそのまま保存・読み込み可能です。注意点：マクロ対応のワークブックは、Excelでマクロを有効にするために、`.xlsm`拡張子で保存する必要があります。
      
    

      バージョン 2.17.26
      
        XLSXエンジンに、ワークブックおよびシートの保護機能を追加しました。`TXLSXWorksheet`は、`Protect`、`Protect(Password)`、`UnProtect`に加え、`IsProtected`および`SheetProtectHash`を公開します。`TXLSXWorkbook`は、オプションでパスワード、`LockStructure`、`LockWindows`フラグを指定して`ProtectWorkbook`および`UnProtectWorkbook`を提供し、さらに`IsWorkbookProtected`、`WorkbookProtectHash`、`LockStructure`、`LockWindows`も追加しました。`SaveAs`メソッドは、保護された各ワークシートに対して`<sheetProtection>`タグ、保護されたワークブックに対して`<workbookProtection>`タグを出力します。`Open`メソッドは、これらのブロックをAPIにパースします。パスワードは、互換性を保つために、標準的な4桁の16進数ハッシュとして保存されます（元のプレーンテキストは復元できません）。
      
    

      バージョン 2.17.25
      
        XLSXエンジンに、ドキュメントプロパティのラウンドトリップ機能を追加しました。`TXLSXWorkbook`クラスは、`Title`、`Author`、`Subject`、`Keywords`、`Description`、`Category`、`LastModifiedBy`、`Created`、`Modified`、`Company`、`Application`、および`AppVersion`プロパティを公開します。`SaveAs`メソッドは、いずれかのプロパティが変更された場合に、`docProps/core.xml`および`docProps/app.xml`ファイルを生成し、それらを`[Content_Types].xml`および`_rels/.rels`に登録します。`Open`メソッドは、これらのファイルを解析し、作成者、変更日時、およびアプリケーションに関するメタデータが、保存後に再度開いた場合でも保持されるようにします。
      
    

      バージョン 2.17.24
      
        XLSXエンジンに、Excelスタイルのテーブルのラウンドトリップ機能を追加しました。新しい`TXLSXTable`クラス（`Id`, `Name`, `DisplayName`, `Range`, `Columns`, `StyleName`, `ShowFirstColumn / ShowLastColumn / ShowRowStripes / ShowColumnStripes`）と、各ワークシートごとの`TXLSXTables`コレクションが追加されました。`TXLSXWorksheet`は`Tables`プロパティを公開し、`AddTable(Name, Range, ColumnNames)`メソッドを提供します。`SaveAs`メソッドは、`xl/tables/tableN.xml`（ワークブック全体の番号付け）を出力し、ワークシートのrelsにテーブルの関係を更新し、ワークシートに`<tableParts>`を追加し、テーブルのコンテンツタイプを登録します。`Open`メソッドは、テーブルの関係と`tableN.xml`をワークシートに解析し、スタイルが適用されたテーブルが保存後に再度開かれた際にも維持されるようにします。
      
    

      バージョン 2.17.23
      
        XLSXエンジンに、自動フィルタのラウンドトリップ機能を追加しました。`TXLSXWorksheet`クラスには、`AutoFilterRange`プロパティと、`SetAutoFilter(Row1, Col1, Row2, Col2) / SetAutoFilter(Range) / ClearAutoFilter`ヘルパーメソッドが公開されています。`SaveAs`メソッドは、範囲が空でない場合に、マージセルブロックの後に`<autoFilter ref="..."/>`を生成します。`Open`メソッドは、`ref`属性をプロパティに解析し、ワークシートのフィルタバーが保存後に再度開いても維持されるようにします。
      
    

      バージョン 2.17.22
      
        XLSXエンジンに、ページ設定の双方向変換機能を追加しました。`TXLSXWorksheet`クラスは、`Margin{Left,Right,Top,Bottom,Header,Footer}`、`PageLandscape`、`PaperSize`、`PageScale`、`FitToWidth`、`FitToHeight`、`HeaderText`、および`FooterText`プロパティを公開しています。また、`SetPageMargins(L, R, T, B[, H, F])`という便利なオーバーロードも提供しています。`SaveAs`メソッドは、ハイパーリンクと図のブロック間に、対応する`<pageMargins>`、`<pageSetup>`、および`<headerFooter>`ブロックを出力します。`Open`メソッドは、これらを解析して復元します。デフォルト設定のみのワークシートは変更されません（`PageSetupTouched`フラグによって出力が制御されます）。
      
    

      バージョン 2.17.21
      
        XLSXエンジンに、フリーズペインのラウンドトリップ機能を追加しました。`TXLSXWorksheet`クラスには、`FreezePane(Col, Row)`/`UnfreezePane`メソッドと、読み取り専用の`FreezeCol`および`FreezeRow`プロパティが公開されています。`SaveAs`メソッドは、`<sheetData>`ブロックの前に、アクティブなペインと選択内容に対応する`<sheetViews>/<pane state="frozen">`ブロックを書き込みます。`Open`メソッドは、`<pane state="frozen">`ブロックを解析し、フリーズ位置を復元するため、フリーズされた上部/左側/コーナーのレイアウトは、保存後に再度開いても維持されます。
      
    

      バージョン 2.17.20
      
        XLSXエンジンに、行と列のアウトライン（グループ化）レベルを追加しました。`TXLSXWorksheet`クラスには、`RowOutlineLevel[Row]`および`ColOutlineLevel[Col]`というインデックス付きプロパティに加え、`SetRowOutlineLevel`、`HasRowOutlineLevel`、`ClearRowOutlineLevels`、およびそれに対応する列関連のヘルパーメソッドが用意されています。`SaveAs`メソッドは、`<row>`要素および結合された`<col>`要素に`outlineLevel`属性を出力します（カスタム幅が存在する場合は、それらも併せて出力します）。`Open`メソッドは、これらの属性をワークシートに解析し、グループ化された行/列の階層構造が保存と読み込みのサイクルを乗り越えられるようにします。
      
    

      バージョン 2.17.19
      
        XLSXエンジンに、条件付き書式とデータ検証の双方向対応機能を追加しました。新しい`TXLSXCfOperator`列挙型と`TXLSXConditionalFormat`クラス（`Range`, `Op`, `Formula1`, `Formula2`）を導入し、各ワークシートに`TXLSXConditionalFormats`コレクション（`Worksheet.ConditionalFormats`）を追加しました。また、`TXLSXDataValidationType`, `TXLSXDvOperator`, `TXLSXDataValidation`（`Range`, `ValidationType`, `Op`, `Formula1`, `Formula2`, `AllowBlank`, `ShowInputMessage`, `ShowErrorMessage`）を導入し、`TXLSXDataValidations`コレクション（`Worksheet.DataValidations`）に、一般的なドロップダウンリストのケースに対応する`AddList(Range, Items)`ショートカットを追加しました。`TXLSXWorksheet`クラスには、`AddConditionalFormat`と`AddDataValidation / AddListValidation`ヘルパー関数を公開しています。`SaveAs`メソッドは、`<conditionalFormatting>`ブロック（`cfRule`属性が`type="cellIs"`の場合）と、`<dataValidations>`ブロックを`sheetData`の後に書き込みます。`Open`メソッドは、これらのブロックをコレクションに読み込みます。
      
    

      バージョン 2.17.18
      
        XLSXエンジンに、定義済み名前のラウンドトリップ機能を追加しました。新しい`TXLSXDefinedName`クラス（`Name`, `Formula`, `SheetIndex`）と、ワークブックレベルの`TXLSXDefinedNames`コレクション（`Workbook.DefinedNames`）を導入しました。`Add(Name, Formula[, SheetIndex])`のオーバーロードと、`IndexOfName`による検索機能を提供します。`SaveAs`メソッドは、`xl/workbook.xml`に`<definedNames>`ブロックを出力します。`SheetIndex`が0以上のエントリには、ローカルシートID属性（シートスコープ）が設定され、`SheetIndex`が-1のエントリはワークブックスコープになります。`Open`メソッドは、`<definedName>`要素をコレクションに解析し、保存後に再度開いたワークブックでも、定義済み名前が保持されるようにします。
      
    

      バージョン 2.17.17
      
        XLSXエンジンに、画像のラウンドトリップ機能を追加しました。新しい`TXLSXImageFormat`列挙型（png, jpeg, gif, bmp）、`TXLSXImage`クラス（行/列アンカー、`WidthEMU`/`HeightEMU`、フォーマット、データ）、および各ワークシートごとの`TXLSXImages`コレクションを導入しました。`TXLSXWorksheet`クラスは、`Images`プロパティに加え、`AddImage(Row, Col, Data, Format)`および`AddImageFromFile(Row, Col, FileName)`ヘルパーメソッドを提供します。`SaveAs`メソッドは、画像データを`xl/media/imageN.<ext>`に書き込み、`xl/drawings/drawingN.xml`ファイルを生成します。このXMLファイルには、各画像ごとに1つの`oneCellAnchor`が含まれており、対応する`_rels`ファイルも生成されます。さらに、コンテンツタイプとワークシート/ドローイングの関係を登録し、ワークシート内に`<drawing r:id="..."/>`という参照を生成します。`Open`メソッドは、`drawingN.xml`、ドローイングの`rels`ファイル、およびメディアファイルを解析し、画像を`Worksheet.Images`にラウンドトリップします。
      
    

      バージョン 2.17.16
      
        XLSXエンジンに、カスタム数値フォーマットの往復変換機能を追加しました。新しい`TXLSXNumberFormat`クラスと、ワークブックレベルの`TXLSXNumberFormats`コレクション（`Workbook.NumberFormats`）を導入し、`Add(FormatCode)`メソッドを使用してフォーマットコードの重複を排除します。`TXLSXCell`クラスには、新しい`NumberFormatIndex`プロパティが追加されました。`SaveAs`メソッドは、`xl/styles.xml`に`<numFmts>`ブロックを出力します（カスタムIDはOOXMLで予約されている164から開始）。各フォーマットには専用の`cellXf`が関連付けられ、Openはカスタム`numFmts`を解析し、読み込み時に`cellXf->numFmtId`のマッピングを`NumberFormatIndex`に変換します。競合時の優先順位は、`FormatIndex` > `FontIndex` > `FillIndex` > `BorderIndex` > `NumberFormatIndex`です。
      
    

      バージョン 2.17.15
      
        XLSXエンジンに、セルのボーダーに関するラウンドトリップ機能を追加しました。新しい`TXLSXBorderStyle`列挙型、`TXLSXBorderEdge`クラス（各辺に対してスタイル、色、自動色フラグ）、`TXLSXBorder`クラス（左、右、上、下、斜めの辺）、およびワークブックレベルの`TXLSXBorders`コレクション（`Workbook.Borders`）を導入しました。また、`Borders.AddBox(Style[, Color])`というショートカット機能も追加しました。`TXLSXCell`には、新しい`BorderIndex`プロパティが追加されています。`SaveAs`関数は、各ボーダーを`xl/styles.xml`に出力し、専用の`cellXf`と紐付けます。`Open`関数は、ボーダーを解析し、`cellXf->borderId`のマッピングを読み込み時に`BorderIndex`に変換します。複数の設定が同じセルに適用されている場合、優先順位は`FormatIndex > FontIndex > FillIndex > BorderIndex`のままです。
      
    

      バージョン 2.17.14
      
        XLSXエンジンに、セル塗りつぶしのラウンドトリップ機能を追加しました。新しい`TXLSXFillPattern`列挙型と`TXLSXFill`クラスにより、`patternType`、`fgColor`、および`bgColor`を記述できます。ワークブックレベルの`TXLSXFills`コレクションは、`Workbook.Fills`を通じてアクセス可能で、`Fills.AddSolid(color)`という便利なメソッドで、一般的な単色塗りつぶしを簡単に設定できます。`TXLSXCell`には、新しい`FillIndex`プロパティが追加されました。`SaveAs`メソッドは、各塗りつぶしを`xl/styles.xml`に出力し、専用の`cellXf`と紐付けます。`Open`メソッドは、これらを解析し、読み込み時にセルの属性を`FillIndex`に反映します。`FontIndex`は、両方が設定されている場合でも、依然として優先されます。
      
    

      バージョン 2.17.13
      
        XLSXフォントのラウンドトリップ処理が完了しました。現在は、xl/styles.xmlファイルをWorkbook.FontsとcellXf->fontIdテーブルに解析し、各セルのs属性をTXLSXCell.FontIndexにマッピングすることで、保存したワークブックを再度開いた際に、カスタムフォント（フォント名、サイズ、太字、イタリック、取り消し線、下線、色）が保持されるようになりました。
      
    

      バージョン 2.17.12
      
        TXLSXFont クラスを追加し、Workbook クラスに Fonts コレクションを追加しました。これにより、XLSX セルでカスタムフォントを選択できるようになりました。TXLSXCell クラスには、新しい FontIndex プロパティが追加されています。SaveAs メソッドは、フォントリストを xl/styles.xml に出力し、各フォントに対して 1 つの cellXf を生成し、各セルの s 属性から対応する cellXf を参照します。FontIndex の読み込みと書き込みの機能は、次回のリリースで実装予定です。
      
    

      バージョン 2.17.11
      
        XLSXエンジンに、行の高さに関する双方向変換機能を追加しました。`TXLSXWorksheet`クラスには、`RowHeight[Row]`プロパティに加え、`SetRowHeight`、`HasRowHeight`、および`ClearRowHeights`ヘルパーメソッドが提供されています。`SaveAs`メソッドは、カスタムの高さを持つ各`<row>`要素に対して、`ht`属性と`customHeight="1"`属性を書き込みます（セルデータを持たない行も対象）。`Open`メソッドは、`ht`属性を読み込み、行の高さマップに反映します。
      
    

      バージョン 2.17.10
      
        XLSXエンジンに、列幅のラウンドトリップ機能を追加しました。`TXLSXWorksheet`クラスには、`ColWidth[Col]`プロパティに加え、`SetColWidth`、`HasColWidth`、および`ClearColWidths`ヘルパー関数が用意されています。`SaveAs`メソッドは、カスタマイズされた列ごとに`<col>`エントリを含む`<cols>`ブロックを出力します。`Open`メソッドは、`<col min/max/width>`エントリをワークシートに再適用し、変更されていない列幅はExcelのデフォルト値に戻ります。
      
    

      バージョン 2.17.9
      
        XLSXエンジンに、セルコメントの往復変換機能を追加しました。`TXLSXWorksheet`クラスは、`Comments`コレクションを公開し、`AddComment(Row, Col, Text[, Author])`メソッドのオーバーロードを提供します。`SaveAs`メソッドは、`xl/commentsN.xml`ファイル（重複した作成者リストは削除されます）と、Excelがコメントの吹き出しをレンダリングするために必要な`xl/drawings/vmlDrawingN.vml`ファイルを生成します。`Open`メソッドは、`commentsN.xml`ファイルをコレクションに読み込みます。ワークシートのrels、content types、および`<legacyDrawing>`の設定は、自動的に処理されます。
      
    

      バージョン 2.17.8
      
        XLSXエンジンにハイパーリンクの双方向対応を追加しました。`TXLSXWorksheet`クラスは`Hyperlinks`コレクションを公開し、`AddHyperlink(Row, Col, Url[, Display[, Tooltip]])`メソッドのオーバーロードを提供します。`SaveAs`メソッドは、各ワークシートに`<hyperlinks>`ブロックを書き込み、外部URLターゲットに対応する`xl/worksheets/_rels/sheetN.xml.rels`ファイルを生成します。`Open`メソッドは、まずワークシートのrelsファイルを読み込み、`<hyperlink r:id="..."/>`エントリをURLに解決し、コレクションに格納します。
      
    

      バージョン 2.17.7
      
        XLSXエンジンに、結合されたセルのラウンドトリップ機能を追加しました。`TXLSXWorksheet`クラスは、`MergedCells`コレクションと、BIFFのファサードスタイルを反映した`MergeCells(R1, C1, R2, C2)`という便利なメソッドを公開しています。`SaveAs`メソッドは、`sheetData`ブロックの後に`<mergeCells>`ブロックを出力し、`Open`メソッドは、`<mergeCell ref="A1:B2"/>`エントリをコレクションにパースします。
      
    

      バージョン 2.17.6
      
        XLSXエンジンは、日付値と数式を丸め処理できるようになりました。TDateTime型のセルの値は、Excelのシリアル番号としてシリアライズされ、組み込みの日付セルXfタグが付与されます。これにより、Excelがそれらを日付として表示します。読み込み時には、スタイルが日付セルXfを参照しているセルは、TDateTime型の値にデコードされます。TXLSXCellクラスには、新しいFormulaプロパティが追加されました。SaveAsメソッドは、数式を`<f>`という子要素として書き込み、Openメソッドは、`<f>`テキストをセルの値として解析します。
      
    

      バージョン 2.17.5
      
        XLSXエンジンに、`styles.xml`のテンプレートを追加しました。`SaveAs`関数は、デフォルトのフォント、塗りつぶし、罫線、`cellStyleXfs`、および`cellXfs`エントリを含む、最小限の有効な`xl/styles.xml`ファイルを生成します。さらに、対応する`content-type`と`workbook-relationship`の登録も行います。セルには`FormatIndex`プロパティが設定され、ゼロでない場合は`s="N"`という属性が出力されます。`Open`関数は、`s="N"`を`FormatIndex`に読み戻します。具体的なスタイル記述子（フォント、塗りつぶし、罫線、ワークブックレベルの`cellXfs`コレクション）は、今後のコミットで追加されます。
      
    

      バージョン 2.17.4
      
        XLSXエンジンに、共有文字列（SST）のサポートを追加しました。SaveAs機能は、重複を排除した文字列テーブルを構築し、xl/sharedStrings.xmlファイルを生成します。これにより、インライン文字列の出力が置き換えられます。Open機能は、まずxl/sharedStrings.xmlファイルを読み込み、SSTを使用してt="s"というセル参照を解決します。サードパーティ製のXLSXファイルからのインライン文字列を含むセルは、Open機能で引き続きサポートされます。
      
    

      バージョン 2.17.3
      
        TXLSXWorksheetのセルレコード配列を、TXLSXCellオブジェクトとTXLSXCellsコレクションに置き換えました。 セルへのアクセス箇所は、現在はWorksheet.Cells.Item[Row, Col].Valueとして読み込まれるようになり、BIFFファサードにおけるIXLSCells/IXLSRangeの構造に一致します。 また、Worksheet.Cells.HasCell、Cells.Count、Cells.CellByIndex、Cells.Clearも利用可能です。
      
    

      バージョン 2.17.2
      
        TXLSXWorkbook クラスに TXLSXSheets コレクションクラスを追加しました。これは、BIFF ファサードの IXLSWorkSheets コレクションを模倣したものです。コードでは、`Workbook.Sheets.Add`、`Workbook.Sheets.Count`、`Workbook.Sheets[i]`、`Workbook.Sheets.IndexByName` などのメソッドを使用するようになりました。以前は `Workbook.AddSheet`、`Workbook.SheetCount`、`Workbook.Sheet[i]` などのメソッドが使用されていました。
      
    

      バージョン 2.17.1
      
        TXLSXWorkbook.SaveToFile の名称を SaveAs に、TXLSXWorkbook.LoadFromFile の名称を Open に変更しました。これにより、既存の IXLSWorkBook の命名規則に準拠します。ファイル形式とパスワードに関するオーバーロードを追加し、XLSX ファサードが BIFF ファサードと同じように動作するようにしました。AddSheet には、デフォルトのシート名が生成される引数なしのオーバーロードを追加しました。
      
    

      バージョン 2.17.0
      
        TXLSXWorkbook.SaveAs メソッドは、セルの値（数値、ブール値、およびインライン文字列）を含む、最小限の OOXML .xlsx アーカイブを作成します。このアーカイブには、コンテンツタイプ、ルートリレーションシップ、ワークブックとリレーションシップ、および各シートごとにワークシートが含まれます。
        TXLSXWorkbook.Open は、最小限の OOXML .xlsx アーカイブを読み込みます。具体的には、xl/workbook.xml からシート名、xl/worksheets/sheetN.xml からセルの値を読み込みます。共有文字列、スタイル、日付、数式はまだサポートされていません。
        OOXMLのネームスペース、コンテンツタイプ、および関連付け定数を追加しました。また、今後のXLSX機能で使用するための、参照/解析/エスケープ処理ヘルパー（XlsxColumnLabel, XlsxCellRef, XlsxColumnIndex, XlsxParseCellRef, XlsxParseRangeRef, XlsxEscapeText, XlsxEscapeAttr）も追加しました。
      
    

      バージョン 2.16.4
      
        XLSX ファサードユニット (lxHandleX) は、BIFF ファサードに依存せず、独自のワークブックとワークシートの型 (TXLSXWorkbook, TXLSXWorksheet) を定義するようになりました。 保存および読み込みのエントリポイントは予約されており、OOXML 関連の実装は、今後のリリースで追加されます。
        新しいXLSXファサードに関する開発者向けドキュメントを追加しました。このドキュメントでは、`lxHandle`と`lxHandleX`がどのように共存し、どのヘルパーユニットを共有しているかを説明しています。
      
    

      バージョン 2.16.3
      
        既存のBIFFファサード lxHandle と並存する、XLSX専用ファサードユニット lxHandleX を導入しました。両ユニットは同じ基盤インフラ（スタイルプール、XMLユーティリティ、ZIPアーカイブ）を共有しますが、独立したクラス階層を持ちます。lxHandle は TXLSWorkBook と従来のXLS/HTML/RTF/CSVパスを担当し、lxHandleX は TXLSXWorkbook とすべてのXLSX固有APIを担当します。誤って lxHandle に追加されていた3つのメソッドスタブ（SetCodePage、GetColumnXFIndex、GetRowXFIndex）を削除し、BIFFファサードのパブリックAPIをv2.15.0と同一に保ちました。lxHandle を使用する既存コードの変更は不要です。
      
    

      バージョン 2.16.2
      
        XLSXエンジンの基盤を完成させる3つの内部データ構造ユニットを追加しました。lxAvlTree はソート済み検索のためのO(log N) AVLツリー（TAVLTree/TAVLNode）を提供します。lxCols と lxRows は、細粒度の重複排除とインデックス書き換えを備えた列・行情報コンテナで、XLSXエンジンのシートごとの列幅・行高マップに使用されます。3つのユニットはこのバージョンでは休眠状態であり、v2.17.0でXLSX読み書きエンジンが初めて有効化されたときにアクティブになります。
      
    

      バージョン 2.16.1
      
        XLSXエンジンのインフラ層を完成させる6つの内部XMLおよびZIPユーティリティユニットを追加しました。lxWStream（ファイル存在チェックとAnsiString書き込みヘルパーを備えたワイド文字ファイルストリーム）、lxCacheStream（下位I/O呼び出しを削減するバッファ付きストリームラッパー）、lxZlibStream（既存の loZlib BIFF暗号化バインディングとは独立した前方専用deflate/inflateストリーム）、lxXmlReader（高速XML解析のためのSAXスタイルプルリーダー）、lxXmlWriter（要素名再利用機能付きストリーミングXMLライター）、lxZipArchive（エントリごとのdeflateストリームを持つセントラルディレクトリZIPリーダー/ライター）。v2.16.0の7つのユニットと合わせて、XLSXエンジンの完全な内部基盤を形成します。
      
    

      バージョン 2.16.0
      
        次期XLSXエンジンの基盤となる7つの内部スタイルインフラユニットを追加しました。lxHashTable（整数・WideString・オブジェクトキー変種を持つ汎用ハッシュテーブル）、lxKeyList（高速検索とインデックス書き換えを備えたオブジェクトキーリスト）、lxStyleColor（Officeテーマカラーとパレットスロットマネージャー）、lxStyleFont・lxStyleFill・lxStyleBorder（12種類すべてのBIFF線種とXLSXスタイルマッピングをカバーする、フォント・塗りつぶし・罫線スタイルの重複排除プール）、lxStyleXf（5つのスタイルプールと数値書式リストを単一のXFレコードに集約）。7つのユニットはこのバージョンでは休眠状態であり、既存のXLSパスには影響しません。
      
    

      バージョン 2.15.1
      
        lxRgb カラーユーティリティヘルパーを追加しました。RGBtoHLS、HLStoRGB、RGBTint、GetRGBTint はRGBとHLS色空間（HLS範囲0–240）の間で変換を行います。これらはXLSX出力におけるテーマカラーの色調計算、カラースケール条件付き書式、パレット補間の基盤となります。
        lxStrBuilder 高性能文字列ビルダーを追加しました。TXLSStringBuilder（AnsiChar）と TXLSWideStringBuilder（WideChar）は、事前割り当て・倍増成長バッファを使用して、標準Pascalの文字列連結時のメモリ再割り当てを排除します。AnsiChar変種はXLSX XMLシリアライズパスを、WideChar変種はXLSXパーサーのワイド文字列アセンブリを担当します。
      
    

      バージョン 2.15.0
      
        HtmlHelp の参照を、ウェブ対応の構造に再構築しました。専用のトピック、アセット、スクリプト、スタイル、およびソースのフォルダを用意しました。
        ブラウザで使いやすいヘルプのトップページと目次ページを追加しました。これらは、統一されたヘッダー、トピックへのショートカット、およびフッターを備えています。