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 자동화 패턴을 다룹니다. 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가 이제 사용자 지정 눈금선 색과 고정 창 상태를 보존합니다. 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 범위에 맞을 때 compact tInt token을 사용하며, TXLSIconSetSpec.ThresholdEqualsInclude[Index]가 이제 CF12 icon-set threshold equals byte를 제어하므로 호출자가 include 또는 exclude 비교 의미를 선택할 수 있습니다.

버전 2.88.103

Classic XLS worksheet에 텍스트 찾기 helper가 추가되었습니다. IXLSWorksheet.FindText(SearchText, Row, Col[, MatchCase])는 처음 일치하는 로드된 텍스트 셀을 찾고, 수식 및 비텍스트 셀은 건너뛰며, 일치 항목이 없으면 반환 좌표를 초기화합니다.

버전 2.88.102

Classic XLS worksheet에 텍스트 치환 helper가 추가되었습니다. IXLSWorksheet.ReplaceText(SearchText, ReplacementText[, MatchCase])는 로드된 텍스트 셀의 일치 항목을 치환하고, 수식 및 비텍스트 셀은 건너뛰며, template 채우기 workflow를 위해 변경된 셀 수를 반환합니다.

버전 2.88.101

Range에 직접 HTML 내보내기 helper가 추가되었습니다. IXLSRange.SaveAsHTML(FileName) 및 IXLSRange.SaveAsHTML(Stream)은 기존 HTML renderer를 통해 선택한 range를 내보내므로, 일반적인 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 편의 overload가 추가되며, 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는 callback에서 숫자 범위 또는 A1-style 범위를 채우며 셀별 건너뛰기와 취소를 지원합니다.

버전 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 조건을 한 번의 호출로 설정할 수 있습니다. IXLSWorksheet.ApplyAutoFilter 는 worksheet AutoFilter 범위를 설정하고 같은 호출에서 필드 조건을 기록하며, A1-style 및 1-based 숫자 범위 overload 와 선택적 두 조건 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이 first visible tab을 변경하지 않고 선택한 worksheet에서 다시 열리게 합니다.

버전 2.88.79

Classic XLS worksheet outline에서 이제 automatic outline styles를 제어할 수 있습니다. TXLSOutline.ApplyStyles는 WSBool outline style 플래그를 공개하여, 저장된 worksheet가 outline levels 또는 summary placement를 변경하지 않고 Excel outline style application을 보존하거나 명시적으로 활성화할 수 있게 합니다.

버전 2.88.78

Classic XLS page setup에서 이제 automatic page breaks를 제어할 수 있습니다. IXLSPageSetup.AutoPageBreaks는 worksheet WSBool의 automatic page-break 플래그를 공개하여, 저장된 worksheet가 manual page breaks를 보존하면서 automatic 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 플래그에 매핑되어, 저장된 workbook이 worksheet 표시 상태를 바꾸지 않고 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 플래그에 매핑되어, 저장된 workbook이 worksheet 표시 상태를 바꾸지 않고 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가 이제 분할 창 helper를 제공합니다. IXLSWorksheet.SplitPanes(Width, Height)는 기존 BIFF pane writer를 사용해 이동 가능한 창 분할을 만들고, UnsplitPanes는 저장 전에 pane record를 지웁니다.

버전 2.88.62

Classic XLS worksheet에 더 간단한 틀 고정 helper가 추가되었습니다. IXLSWorksheet.FreezePanes(Cols, Rows)는 요청한 왼쪽 열과 위쪽 행을 고정하고, UnfreezePanes는 저장 전에 pane record를 제거합니다.

버전 2.88.61

Classic XLS sheet 이름 검색이 이제 스트림을 받습니다. TXLSWorkbook.GetSheetNames(Stream, List)은 호출자가 제공한 XLS stream에서 BIFF sheet 이름을 읽으며 worksheet 내용을 로드하지 않으므로, 메모리의 workbook 데이터도 파일 이름 helper와 같은 방식으로 빠르게 처리할 수 있습니다.

버전 2.88.60

Worksheet collection이 이제 이름으로 직접 찾는 helper를 제공합니다. 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 필터 레코드를 기록합니다. TXLSRange.Autofilter(Field, Criteria)는 필요할 때 필터 범위를 만들고, 단순 문자열, 숫자, Boolean, 공백, 공백 아님, 비교 접두사가 붙은 조건에 대해 AUTOFILTER 조건을 내보냅니다.

버전 2.88.54

기존 XLS worksheet에 이제 worksheet 수준 AutoFilter helper가 제공됩니다. IXLSWorksheet.SetAutoFilter, ClearAutoFilter, AutoFilterRange는 기존 AUTOFILTERINFO 및 필터 데이터베이스 이름 writer를 재사용하면서 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)는 행마다 하나의 <mergeCell> 항목을 기록하여 기존 XLS Range.Merge(True) 동작과 일치하며, 인수 없는 Merge와 Merge(False)는 계속 전체 range에 대한 하나의 병합 사각형을 만듭니다.

버전 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

댓글 rich-text 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 열기/저장 왕복에서 유지됩니다. HotXLS는 로드된 SUPBOOK 항목에 연결된 BIFF8 XCT 및 CRN 레코드를 보존하므로 외부 통합 문서 링크의 cached cell values가 저장 중 더 이상 삭제되지 않습니다.

버전 2.88.46

기본 제공 스타일 outline level이 이제 .xls 열기/저장 왕복에서 유지됩니다. HotXLS는 기본 제공 스타일의 BIFF8 STYLE iLevel 바이트를 읽고 보존하므로 Excel RowLevel_1..7 및 ColLevel_1..7 스타일 메타데이터가 저장 중 더 이상 기본값으로 재설정되지 않습니다.

버전 2.88.45

정의된 이름 메타데이터가 이제 .xls 열기/저장 왕복에서 유지됩니다. 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는 대화 상자 시트, 자동 페이지 나누기, 스타일 적용, 윤곽 gutter 표시와 같은 모델링되지 않은 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를 빈 문자열로 대체하지 않고 parse하여 drawing note model로 전달하므로, Excel이 쓴 comment "Created by" author가 HotXLS로 workbook을 다시 저장해도 유지됩니다.

버전 2.88.34

shape OfficeArt FOPT options가 이제 low-level option bag으로 노출됩니다. TXLSShape.OfficeArtOptions를 통해 고급 호출자는 저장된 임의의 FOPT PID를 LongWord 또는 WideString으로 검사, 설정, 삭제할 수 있으며 기존 high-level Line, Fill, 색상, 표시 API는 변경되지 않습니다.

버전 2.88.33

추가 OfficeArt solver-container rule record도 이제 round-trip 보존됩니다. typed 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를 정확히 한 번만 emit합니다. XLS 사양에 맞지 않는 container-style 가정은 XLS path에 넣지 않습니다.

버전 2.88.31

OfficeArt connector rule이 이제 round-trip됩니다. Excel이 만든 .xls drawing은 connector binding을 msofbtSolverContainer($F005) 안의 하위 msofbtConnectorRule($F012) record로 저장합니다. v2.88.31은 TMsoConnectorRules를 통해 $F005/$F012 쌍을 parse하고 emit하여 save/reload 사이에 시작 shape, 끝 shape, connector shape, connection site를 보존합니다. 이전 audit note는 $F121로 적었지만 MS-ODRAW는 OfficeArtFConnectorRule을 $F012로 정의합니다.

버전 2.88.30

인식되지 않은 OfficeArt SpContainer leaf record가 이제 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 순서대로 다시 emit합니다.
범위와 후속 작업. 다른 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 를 통해 새로 생성된 콤보 / 리스트 박스는 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 는 그 후 해당 바이트를 typed 서브레코드 출력 후, FtEnd 마커 전에 그대로 내보냅니다. 매크로 후크가 있는 소스 파일 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 사이에 레거시 하드코딩된 FtCf ($0007, 본문 $FFFF) 와 FtPioGrbit ($0008, 본문 $0000) 서브레코드만 내보냈습니다. 새로 작성된 그림 프레임의 경우 새 코드는 여전히 해당 기본값을 내보냅니다. 소스 .xls 에서 파싱된 그림 프레임의 경우 캡처된 FObjTailRaw 바이트가 대신 그대로 내보내져, 소스 파일의 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 에 그대로 캡처합니다. Store 는 이들을 서식 실행 Continue 로 다시 내보내고, 기본 레코드의 cbRuns 헤더를 일치하도록 조정합니다. 새로 생성된 메모 (AddComment 를 통해) 는 기존의 단일 기본 실행 출력을 변경 없이 유지하므로, 기본 통합 문서에 대해 바이트 단위로 동일한 출력이 유지됩니다. 개별 서식 실행에 대한 타입화된 Excel API 액세스는 여전히 연기됨 — 기존 단일 WideString 메모 API 는 변경되지 않았습니다.

버전 2.88.23

인쇄 해상도와 매수가 이제 저장 주기를 거쳐도 유지됩니다 — Setup 레코드 완전 커버. Setup 레코드의 세 Word 필드 (오프셋 12 의 iRes, 오프셋 14 의 iVRes, 오프셋 32 의 iCopies, MS-XLS §2.4.257) 는 Excel 의 "페이지 설정 → 페이지 → 인쇄 품질" 과 "매수" 선택을 운반합니다. HotXLS 는 이전에 셋 모두 읽을 때 버리고 하드코딩된 값 (600 DPI / 600 DPI / 1 매) 을 내보냈기 때문에, 사용자가 조정한 해상도나 매수가 HotXLS 의 매 저장 후 조용히 되돌아갔습니다.
세 개의 새 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 비트 두 개 (fNoPls, fNoOrient) 만 노출되지 않음 — HotXLS 는 둘 다 0 으로 쓰며 Excel 의 기본 동작과 일치합니다.

버전 2.88.22

사용자 지정 페이지 설정 "첫 페이지 번호" 가 이제 저장 주기를 거쳐도 유지됩니다. BIFF8 Setup 레코드는 통합 문서의 페이지 설정 → 페이지 → "첫 페이지 번호" 선택을 두 개의 관련 필드로 운반합니다: grbit 비트 7 (fUsePage) 은 Excel 의 "자동" 기본값과 명시적인 시작 페이지 번호 사이에서 선택하고, 오프셋 4 의 부호 있는 Word (iPageStart) 는 그 사용자 지정 값을 보유합니다 (MS-XLS §2.4.257). HotXLS 는 이전에 둘 다 읽을 때 버리고 비트가 지워진 상태로 iPageStart = 1 을 내보냈기 때문에, 사용자가 입력한 "첫 페이지 번호: 100" 이 HotXLS 의 매 저장 후 조용히 "자동" 으로 되돌아갔습니다.
두 개의 새 TXLSPageSetup 프로퍼티. UseFirstPageNumber: Boolean 은 비트를 반영합니다 (False = "자동", 기본값). FirstPageNumber: Integer 는 iPageStart 값을 운반합니다 (기본값 1, 세터에 의해 spec 의 signed-Word 범위 -32768..32767 로 클램프). HotXLS 는 UseFirstPageNumber 가 False 일 때도 iPageStart 를 그대로 round-trip 하므로, Excel 에서 자동과 사용자 지정 사이를 전환할 때 사용자가 마지막으로 입력한 값이 유지됩니다.

버전 2.88.21

"시트 끝에 메모 인쇄" 선택이 이제 저장 주기를 거쳐도 유지됩니다. BIFF8 Setup 레코드의 grbit 비트 9 (fEndNotes, MS-XLS §2.4.257) 는 페이지 설정 → 시트 → 메모 드롭다운의 "시트에 표시된 대로" (기본값) 와 "시트 끝" 의 구분을 운반합니다. HotXLS 는 이미 메모가 인쇄되는지 여부를 제어하기 위해 PrintNotes (비트 5) 를 round-trip 하고 있었지만, 비트 9 는 읽을 때 버려지고 쓸 때 0 으로 내보내졌습니다 — 그래서 사용자가 선택한 "시트 끝" 은 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 과 바이트 단위로 동일한 출력을 유지합니다. 세터는 임의의 불리언을 받아들이고, 리더는 임의의 0 이 아닌 원본 바이트를 True 로 정규화합니다.

버전 2.88.18

반복 계산 설정 (활성화 + 최대 반복 횟수 + 최대 변화량) 이 이제 저장 주기를 거쳐도 유지됩니다. BIFF8 의 CalcIter ($0011), CalcCount ($000C), CalcDelta ($0010) 레코드는 함께 Excel 의 "반복 계산 활성화" 세 가지 옵션 (파일 → 옵션 → 수식) 을 운반합니다 (MS-XLS §2.4.33 / §2.4.31 / §2.4.32). 세 가지 모두 이전에 디스패처 케이스가 없었고, StoreCalculationSettings 는 하드코딩된 값 (꺼짐 / 100 / 0.001) 으로 내보냈습니다. 사용자가 구성한 1000 회 반복 + 0.0001 수렴 델타는 HotXLS 로 다시 저장할 때마다 조용히 "반복 꺼짐, 100, 0.001" 로 재설정되었습니다 — 순환 참조 수식과 수렴에 민감한 재무 모델을 망가뜨립니다.
세 개의 새 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 에서 내보낸 세 개의 새 상수. 세터는 알 수 없는 값을 spec 기본값으로 클램프하므로 손상된 원본 파일이 통합 문서를 정의되지 않은 상태로 둘 수 없습니다. 이 프로퍼티를 건드리지 않는 기존 코드는 레거시 "자동" 기본값을 유지하므로 기본 통합 문서의 이전 출력은 바이트 단위로 동일합니다.

버전 2.88.16

페이지 설정의 "셀 오류 표시" 선택이 이제 저장 주기를 거쳐도 유지됩니다. BIFF8 Setup 레코드 ($00A1) 는 페이지 설정 → 시트의 "셀 오류 표시: 표시된 대로 / <공백> / <대시> / <N/A>" 드롭다운을 grbit 워드의 비트 10-11 즉 iErrors 로 묶어 둡니다 (MS-XLS §2.4.257). HotXLS 는 이전에 읽을 때 이 비트들을 버리고 쓸 때 0 으로 출력했기 때문에, #DIV/0! 를 #N/A 로 인쇄하도록 사용자가 구성한 통합 문서가 HotXLS 로 다시 저장할 때마다 조용히 "표시된 대로" 로 되돌아갔습니다. 리더는 이제 iErrors 를 새로운 TXLSPageSetup.PrintCellErrors 프로퍼티로 디코딩하고, 라이터는 그것으로부터 필드를 재구성합니다.
새 TXLSPageSetup.PrintCellErrors 프로퍼티. 읽기/쓰기 가능한 LongWord 프로퍼티로, xlPrintErrorsDisplayed (0, 기본값), xlPrintErrorsBlank (1), xlPrintErrorsDash (2), 또는 xlPrintErrorsNA (3) 를 받습니다 — lxTNC.inc 에서 내보낸 네 개의 새 상수. 이 프로퍼티를 건드리지 않는 기존 PageSetup 호출자는 기본값 ("표시된 대로") 을 유지하므로 이전 인쇄 출력은 변하지 않습니다.

버전 2.88.15

셀 메모의 정렬과 방향이 이제 저장 주기를 거쳐도 유지됩니다. BIFF8 TXO base 레코드 ($01B6) 는 grbit 워드 안에 다섯 개의 타입화된 플래그 (hAlignment, vAlignment, fLockText, fJustLast, fSecretEdit) 와 텍스트 방향을 위한 별도의 rot 워드를 갖고 있습니다 (MS-XLS §2.4.329). 리더는 이전에 이들을 모두 버렸고, 라이터는 grbit 를 하드코딩된 0x0012 (왼쪽 + 위) 에 고정하고 회전은 항상 0 으로 설정하여, 가운데 정렬되거나 회전된 메모도 저장 시마다 소스와 상관없이 왼쪽+위+수평으로 리셋되었습니다. 리더는 이제 로드 시 타입화된 필드를 디코딩하고 라이터는 그것들로부터 grbit 를 합성하므로, 레이아웃이 save/reload 사이클을 살아남습니다.
명시적인 메모 스타일 지정을 위한 TMSOShapeTextBox 의 여섯 가지 새 프로퍼티. HAlignment, VAlignment, Rotation, LockText, JustLastLine, SecretEdit 가 각 메모 도형에 대해 읽기/쓰기 프로퍼티로 노출됩니다. AddComment 는 기본적으로 왼쪽+위+수평+잠금해제로 초기화되므로 이를 건드리지 않는 호출자는 기존의 외관을 유지합니다.
TXO 라이터는 이제 reserved4 / reserved5 를 spec 필드 경계에 따라 배치합니다. 이전 코드는 base 레코드의 offset 2-9 를 두 개의 Long 쓰기 (rot + reserved4 다음 reserved5) 로 내보냈습니다. 라이터는 이제 이를 Word rot, Word reserved4, Long reserved5 로 분할합니다. 바이트 내용은 변하지 않지만 (Note 도형은 여전히 모두 0) 코드 구조는 이제 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 long 내부에 떨어지는데, Note 형태 객체에서는 항상 0이므로 모든 주석이 조용히 방어적 폴백으로 미끄러져 사실상 v2.88.13 이전 동작으로 되돌아갔습니다. 이번 수정으로 오프셋을 10으로 바로잡았고, 긴 주석이 실제로 Continue 레코드를 가로질러 이어 붙고 짧은 주석도 끝에 패딩을 더 이상 줍지 않습니다. v2.88.13이 본래 제공하기로 했던 동작 외에는 다른 변경이 없습니다.

버전 2.88.13

긴 셀 주석이 이제 전체 길이로 다시 읽힙니다. BIFF8 TXO 레코드($01B6)는 텍스트 본체를 기본 레코드와 하나 이상의 Continue 레코드로 나누며 문자 수는 기본 레코드 오프셋 8의 cchText에 게시됩니다. 이전 주석 리더는 기본 레코드를 완전히 건너뛰고 DataList[1]을 전체 텍스트로 취급하여 거기서 멈췄기 때문에 약 4100 와이드 문자를 초과하는 주석은 조용히 잘리고, 더 짧은 주석도 Continue 레코드가 끝에 패딩을 끌고 다니면 그 쓰레기를 끝에 주워 모았습니다. 리더는 이제 cchText를 권위 있는 문자 수로 사용하고 MS-XLS §2.4.329에 따라 각 Continue 세그먼트를 순회하며(rgb 컷이 문자 경계에 있으므로 부분 문자 회계는 필요 없음), 예산이 충족되는 즉시 멈춥니다. 그래서 텍스트 다음에 오는 서식 runs 블록이 문자열로 흘러 들지 않습니다. 손상되거나 누락된 기본 레코드를 가진 주석은 계속해서 "남은 모든 바이트 소비" 레거시 경로를 따릅니다.

버전 2.88.12

문자열을 반환하는 수식에서 나온 약 4100자를 넘는 캐시 문자열이 이제 Continue 레코드를 가로질러 라운드 트립에서 보존됩니다. v2.88.11은 BIFF8 String 레코드($0207)의 읽기 측을 연결했지만 첫 레코드 본체만 소비했기 때문에 UCS-2 바이트가 8224바이트 BIFF 한도를 넘어 하나 이상의 Continue 레코드($003C)로 넘친 캐시 문자열은 조용히 잘렸습니다. 처리기는 이제 디스패치 계층의 DataList 전체를 순회합니다. 기준 레코드에서 cch와 fHighByte를 읽고 거기 들어가는 본체를 복사한 다음, 후속 Continue 세그먼트를 각각 MS-XLS §2.5.293의 문자 경계 보장에 따라 원시 바이트로 이어 붙입니다. XLUnicodeString은 문자열 중간에 fHighByte를 다시 내보내지 않습니다. 각 세그먼트는 남은 문자 예산으로 제한되므로 잘못 커진 Continue가 결과를 cch보다 길게 만들 수 없습니다. 단일 레코드 문자열(일반적 경우)은 이전과 정확히 같은 빠른 경로를 탑니다.

버전 2.88.11

문자열을 반환하는 수식이 이제 Excel이 계산한 캐시 텍스트를 라운드 트립에서 보존합니다. 이전 릴리스는 BIFF8 FormulaValue 캐시(MS-XLS §2.5.133)의 숫자, 부울, 오류, 빈 값 네 가지 변형을 처리했지만 문자열 변형은 캐시 값이 Formula 레코드 바로 뒤에 따라오는 별도의 String 레코드($0207)에 있기 때문에 미완료 작업으로 남겨두었습니다. ParseFormula는 이제 문자열 변형 Formula를 발견하면 셀 좌표를 기억하고, 새 ParseString 처리기는 뒤따르는 $0207 레코드를 MS-XLS §2.4.268에 따라 디코딩하여 WideString을 FCachedFormulaValue로 라우팅합니다. GetCellValue는 이제 HotXLS evaluator가 재현하지 못할 때 Excel이 계산한 텍스트로 폴백할 수 있습니다. ParseFormula 상단의 방어적 재설정이 모든 오래된 보류 앵커를 폐기하여 String 레코드가 누락된 잘못된 소스 파일이 이후의 것을 잘못 라우팅하는 것을 방지합니다. 8224바이트보다 큰 레코드는 Continue 청크로 넘쳐 알려진 제한 사항으로서 평가자 출력으로 폴백을 계속합니다.

버전 2.88.10

BIFF8 Formula 레코드가 Excel이 계산한 캐시 값을 라운드 트립으로 유지합니다. ParseFormula는 이전에 offset 6에 있는 8바이트 FormulaValue 페이로드를 완전히 건너뛰었기 때문에 로드된 .xls의 모든 수식 캐시 결과(숫자, 부울, 오류, 빈 값)가 폐기되었고 HotXLS는 자체 수식 엔진으로 모든 셀을 다시 평가해야 했습니다. 그 엔진이 Excel과 일치할 수 없을 때(지원되지 않는 XLM 함수, 손상된 외부 링크, 아직 구현되지 않은 수식) 셀은 조용히 비거나 0을 표시했습니다. 리더는 이제 MS-XLS §2.5.133에 따라 숫자 / 부울 / 오류 / 빈 값 네 가지 변형을 디코딩하여 새 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하여 인코딩했으며, MS-XLS §2.4.221이 miyRw를 8192 twips로 제한함에도 HotXLS는 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로 표시된 두 항목이 실제 버그가 아님이 명확해졌습니다. BOF 이력 플래그 $000080C9에서 설정된 비트 15는 verXLHigh 필드(비트 14-17, 값 2 = "Excel 2002")에 속하며 reserved1 꼬리(비트 19-31)가 아닙니다. ParseFormula가 선행 PtgExp 토큰으로 공유 또는 배열 수식을 감지하는 방법은 사양이 의도하는 바와 일치하며 후속 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 bit 4)를 버렸고 라이터는 인접 행의 윤곽 수준 전환에서 추론하여 소스 파일이 명시적으로 접거나 경계로 표시한 행을 잘못 분류했습니다. 상위 3비트 (fExAsc 28, fExDes 29, fPhonetic 30)도 읽히지 않았고 라이터가 4바이트 grbit을 단일 16비트 ixfe 슬롯으로 잘라내기 때문에 항상 0으로 출력되었습니다. 리더는 이제 MS-XLS §2.4.221에 따라 네 비트 모두를 소비하고 fCollapsed를 explicit로 고정합니다. 라이터는 ExAsc, ExDes, Phonetic을 ixfe 워드의 비트 12-14에 패킹하고 ixfe를 사양 허용 12비트 범위로 마스크합니다. ExAsc 및 ExDes가 주도하는 두꺼운 상단 및 중간 하단 테두리 힌트가 이제 HotXLS SaveAs 후에도 유지되며 일본어 시트의 음성 정보 가시성이 매 저장 시마다 재설정되지 않습니다.

버전 2.88.4

BIFF8 Window2 fPaged 비트가 이제 활성 시트만 표시합니다. 이전 릴리스에서는 fPaged(MS-XLS §2.4.346 bit 10)를 모든 표시되는 시트에 설정했기 때문에 HotXLS 출력이 Excel 자체 출력과 달랐습니다(사양상 이 비트는 "이 시트는 현재 워크북 창에 표시됨"을 의미하므로 활성 시트의 substream만 가지고 있어야 합니다). Excel 리더는 어차피 Window1.itabCur로 폴백하여 실제 활성 시트를 식별하므로 오용이 허용되었지만, Apache POI 엄격 모드와 fPaged를 주요 신호로 신뢰하는 다른 도구는 이제 올바르게 표시된 시트를 봅니다.

버전 2.88.3

BIFF8 Window2 줌과 눈금선 색상이 이제 라운드 트립에서 유지됩니다. 이전 릴리스에서는 WINDOW2 레코드의 offset 6 이후 필드를 읽기 측에서 폐기하고 쓰기 측에서 하드코딩된 0을 송출했기 때문에 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을 감시 셀 참조로 해석하려다 실패하고 이미지를 조용히 폐기했습니다. 머리글이나 바닥글 이미지가 있는 워크북은 이제 HotXLS를 거치는 round-trip에서도 이미지가 유지됩니다.

버전 2.88.1

BIFF8 Theme 레코드 opcode 수정. 저장된 .xls 파일은 이제 MS-XLS §2.4.326에 따라 올바른 frtHeader.rt = 0x0896으로 Theme 레코드를 기록합니다. 이전 릴리스에서는 0x0892(StyleExt의 opcode)를 사용했기 때문에 Excel이 포함된 OOXML 테마 페이로드를 셀 스타일 확장으로 해석하고 조용히 기본 Office 테마로 폴백했습니다. 사용자 지정 테마 색이 있는 워크북은 이제 HotXLS를 거치는 round-trip에서도 사용자 지정 팔레트가 유지됩니다.

버전 2.88.0

**[MS-XLSX] 4차 교차 감사 — 테마 부분 및 시트 이름 설정 기능 추가.** 1~3차 감사에서 남은 문제점을 해결하기 위한 두 가지 수정 사항입니다 (v2.51.0 / v2.52.0 / v2.54.1). 두 수정 사항 모두 기존 기능을 손상시키지 않으며, 하나는 설정 기능의 동작을 확장하고, 다른 하나는 항상 생성되는 새로운 부분을 추가합니다.
**이제 .xlsx 파일은 `xl/theme/theme1.xml` 부분을 포함합니다.** `styles.xml`은 항상 테마 인덱스 경로를 통해 설정된 글꼴/채우기/테두리/탭 색상에 대해 `` 참조를 생성했지만, 테마 부분이 작성되지 않았으므로 참조가 유효하지 않았습니다. Excel은 기본 "Office" 테마로 대체하여 이 문제를 무시했지만, Office 파일 유효성 검사에서는 모든 참조를 "테마 부분이 누락됨"으로 표시했으며, 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` 파일에 `theme/theme1.xml` 관계 항목이 추가됩니다. 이 항목은 rid 범위의 끝에 위치하므로 기존의 시트/sst/스타일/vba/외부 링크에 대한 `XlsxFirstExternalLinkRid` 오프셋은 변경되지 않습니다.
**`Sheet.Name`에 직접 값을 할당하면 이제 자동으로 유효성 검사 및 중복 제거가 수행됩니다.** 3차 수정(v2.54.1)에서는 `TXLSXSheets.Add(AName)`에서 Excel의 명명 규칙을 적용했지만, `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 Data Bar / Color Scale / Icon Set 규칙은 더 이상 금지된 DXF payload를 쓰지 않습니다. HotXLS는 MS-XLS 요구대로 DXF 블록을 비우고 실제 설정은 CF12 종류별 tail에 보존합니다.

버전 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]에서 정의된 행 번호 및 열 번호 제한과 일치합니다. 이전에 내부 제한은 0부터 시작하는 최대값을 사용했기 때문에, `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단계의 네 개의 `\005DataSpaces` 메타데이터 스트림 (버전 / 데이터 공간 맵 / 데이터 공간 정보 / 변환 정보)과 모든 데이터를 CFB 컨테이너에 저장하는 OLE Compound File Binary 작성기가 추가되었습니다. Excel은 사용자가 입력한 암호를 사용하여 파일을 엽니다. 워크플로우는 다음과 같습니다. 호출자는 비어 있지 않은 암호와 함께 `SaveAsEncrypted`를 호출합니다. HotXLS는 워크북을 메모리 내의 일반 텍스트 .xlsx zip 파일로 직렬화합니다. 그런 다음 AES-128 CBC를 사용하여 새로운 16바이트의 임의 난수 솔트와 검증자를 사용하여 암호화합니다. 마지막으로 `StgCreateDocfile`을 통해 CFB 출력을 작성합니다. Excel 2007 이상에서 파일을 열면 암호를 입력하고 콘텐츠가 표시됩니다. 잘못된 암호를 입력하면 거부됩니다. `OpenEncrypted` (복호화) 기능은 별도의 백로그 항목이며, 암호화된 파일을 받으면 여전히 `EXlsxEncryptionNotImplemented` 예외를 발생시킵니다.

버전 2.86.1

**XLSX 표준 암호화 — 암호화 기반 (J 단계 1, 백로그 #29).** 두 개의 새로운 내부 모듈이 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바이트 경계로 채우기 + 0으로 채워진 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 및 외부 데이터 연결 (데이터 → 웹/SQL/OLEDB에서 외부 데이터 가져오기)이 HotXLS 저장/열기 주기를 거쳐도 유지됩니다. 이전에 BIFF8 리더가 `QsiSXTag` ($0802), `QsiSXTagExt` ($0810) 및 `DConn` ($0876)을 무시하여 저장 시 상위 쿼리를 설명하는 메타데이터가 삭제되고 테이블이 일반 셀 값으로 저하되었습니다. 이제 리더는 이러한 레코드를 불투명한 바이트로 캡처하고, 작성기는 이러한 바이트를 워크시트 서브스트림으로 다시 출력합니다 ( [MS-XLS] §2.1.7.20.5에 따른 PIVOTVIEW 블록과 함께) 및 워크북 전역 영역 (§2.1.7.20.3에 따른 EOF 이전의 후기 전역 블록과 함께). HotXLS는 여전히 QSI/DConn 구조를 프로그래밍 방식으로 모델링하지 않으며, 호출 코드에서 새로운 QueryTable을 생성하는 작업은 후속 단계로 연기됩니다. 하지만 이미 QueryTable을 포함하고 있는 워크북은 더 이상 새로 고침 메타데이터를 잃지 않습니다. BIFF8 (.xls)만 해당되며, BIFF5에는 영향을 미치지 않습니다.

버전 2.85.1

**Win32/Win64 라이브러리 빌드 복원.** 웨이브 H5.3 멀티 데이터 필드 SXLI 생성기에서 두 개의 피벗-라인-아이템 도우미 변수가 `array of array of Word` 형식의 별도 익명 타입으로 선언되었는데, Delphi 컴파일러는 이를 서로 다른 이름 없는 타입으로 취급하여 직접 할당 시 `E2008 호환되지 않는 타입` 오류를 발생시킵니다. HotXLS 라이브러리는 v2.84.1 이후 RAD Studio 12.0부터 37.0까지 빌드되지 않았습니다. 이제 두 변수는 함께 선언되어 단일 익명 타입을 공유하므로 할당 오류가 수정되고 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에 정의된 단일 비트와 매핑됩니다. 기존의 `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 및 기타 리더는 호출자가 의도한 레이아웃으로 다중 데이터 필드 피벗을 렌더링하며, 이전의 "조합당 단일 `iData = 0`" 근사 방식 대신 정확하게 표시합니다. 단일 데이터 필드 피벗은 v2.84.0과 동일한 출력을 생성합니다. 델타 압축 (H5.1)은 반복되는 조합을 약 8바이트로 줄여주므로, 확장은 최소한의 바이트 오버헤드를 추가합니다. 이 변경 사항은 H4.3 파동에서 알려진 문제인 "다중 데이터 필드 SXLI가 올바르게 확장되지 않음"을 해결합니다.

버전 2.84.0

**피벗 테이블 축 사전 선택 API (H5.2 웨이브).** 이제 `TXLSPivotField` 유형은 `PageItemIndex` 속성을 가지며, 이를 통해 프로그래밍 방식으로 생성된 피벗 테이블이 페이지 축 필터에서 특정 캐시 항목을 미리 선택하도록 설정할 수 있습니다. 기본값인 `xlPageItemAll` (= $7FFD)은 필터를 "(전체)" 상태로 유지하므로, `PageItemIndex`를 할당하지 않는 경우 이전 버전(v2.83.2)과 동일한 동작을 합니다. SXPI ($00B6) 작성기는 `Field.PageItemIndex`를 읽고, 유형화된 리더는 열 때 SXPI에서 `PageItemIndex`를 채워 사용자가 저장된 페이지 선택을 검사할 수 있도록 합니다. 이는 H4.3 웨이브에서 알려진 제한 사항인 "API에서 페이지 필터 사전 선택 기능이 사용 불가능" 문제를 해결합니다.

버전 2.83.2

**델타 압축을 통해 피벗 SXLI 레코드 크기를 줄입니다 (H5.1 파형).** 피벗 작성기는 이제 SXLI 레코드의 각 행에 대해 델타 압축을 적용합니다. 각 행의 시작 부분에 있는 캐시 항목 인덱스를 이전 행과 비교하여 공유되는 접두사를 계산하고, 이 접두사 정보와 함께 나머지 인덱스만 출력합니다. 일반적인 행 축 SXLI 레코드(몇 개의 행 필드와 수십 개의 항목)는 의미 변화 없이 30~60% 정도 크기가 줄어듭니다. 출력은 여전히 8224바이트 BIFF 레코드 제한을 유지하기 위해 청크 단위로 작성됩니다. 모든 SXLI 레코드의 첫 번째 행에서는 항상 cSic 값을 0으로 출력합니다 (레코드 내에서만 사용되며, 다른 레코드와의 참조는 없음). 또한, 총합 행은 델타 압축되지 않습니다.

버전 2.83.1

**셀 채우기, 글꼴 및 테두리 색상이 RGB 값을 통해 설정된 경우, .xls 파일로 저장하고 열 때 정상적으로 유지됩니다.** 이전에는 BIFF8 XFExt ($087D) 작성기가 각 레코드의 ixfe 필드를 메모리 내 XF 배열의 위치를 사용하여 출력했지만, 디스크에 저장되는 해당 셀 레코드에서는 SaveIndex 순서대로 ixfe를 사용했습니다. 저장 시 테이블의 이전 XF가 제거되면(일반적으로 셀이 임시 XF에서 최종 XF로 이동할 때 발생), 각 XFExt의 ixfe 값이 제거된 슬롯 수만큼 오차가 발생하여, 각 셀과 연결된 색상이 다시 로드될 때 인접한 셀로 이동했습니다. 이제 작성기는 각 rich-slot 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의 중첩된 행 레이아웃과 일치함) 그리고 각 조합에 대해 한 줄씩 출력하며, `SXLI nTypes fGrandTotal` 비트가 설정된 후행 총합계를 출력합니다. 각 줄은 `cSic = 0`을 사용합니다 (델타 압축을 사용하지 않으며, 줄당 몇 바이트가 더 많지만 간단합니다). 출력은 한 줄의 개수가 8224바이트의 BIFF 제한을 초과할 때 여러 SXLI 레코드로 분할됩니다. 16384줄의 안전 제한은 비정상적인 입력에서 과도한 확장을 방지합니다.
**SXPI 페이지 축 상태.** 최소 하나의 필드가 `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)는 여전히 웨이브 H1 원시 바이트 경로를 통해 왕복합니다. 새로운 SXDBB 작성기는 `IXLSWorksheet.AddPivotTable`에 의해 생성된 유형 캐시에 대해서만 작동합니다. 혼합된 워크북(하나의 왕복 캐시 + 하나의 새로운 캐시)은 두 경로 모두를 문제 없이 생성합니다.

버전 2.81.0

**피벗 데이터 필드 숫자 형식 지원 (H4.1).** 이제 피벗 데이터 필드에 Excel 숫자 형식 문자열을 적용할 수 있습니다. 이를 통해 통화, 백분율 또는 날짜 데이터가 Open에서 올바른 글리프로 표시되도록 할 수 있으며, 일반 형식의 원시 값을 표시하지 않습니다. 새로운 `IXLSWorksheet.PivotSetDataFieldFormat(DataField, FormatStr): Word` 함수는 워크북의 NumFormats 테이블에 형식을 등록합니다 (자동 추가 또는 재사용). 또한 결과 ifmt 인덱스를 `TXLSPivotDataField.NumberFormat`에 기록합니다. 이 기능은 기존 SXDI.ifmt 출력을 보완합니다.
**TXLSWorkbook 클래스에 Public NumFormats 도우미 추가.** `Workbook.RegisterNumFormat(FormatStr): Word`는 워크북 수준에서 동일한 자동 추가 기능을 제공하며, 피벗 테이블이 아닌 컨텍스트에서 ifmt 인덱스가 필요한 사용자를 위한 것입니다. 빈 FormatStr의 경우, 인덱스 0 ('General')으로 처리됩니다.

**호출자 사용법.**

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`을 출력하도록 변경되었습니다 (이는 규격에 맞는 값이며, `0x05`는 필터 규칙에 예약되어 있습니다). 그러나 해당 읽기 모듈은 여전히 이전의 `0x05` 값을 인식했습니다. 그 결과, HotXLS v2.49.0부터 v2.80.0까지로 작성된 .xls 파일에서 아이콘 세트 규칙이 다시 로드될 때 손실되었습니다. 규칙 유형이 일반 셀-이 규칙으로 변경되고, 아이콘 세트 유형/역순/표시만 플래그가 기본값으로 재설정되었습니다. 이제 읽기 모듈은 `0x05` (이전 버전의 HotXLS)와 `0x06` (규격/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)에서 가져온 집계 값을 포함합니다.
**캐시 모델.** 각 `TXLSPivotCache` 객체는 CacheId, SourceRange (시트 및 0부터 시작하는 행/열 범위), RecordCount 및 `Fields` 목록을 포함합니다. 각 캐시 필드는 데이터 유형 (xlpcftNumber / String / Boolean / Error / Empty / DateTime / Mixed), 이름, NumberFormat 인덱스 및 고유 값으로 이루어진 Items[]를 가지고 있습니다. 각 필드의 Items[] 내에서 레코드별 인덱스는 `Cache.RecordIndices[Record, Field]`를 통해 프로그래밍 방식으로 생성된 캐시에 노출되며, 디스크에서 읽은 캐시는 레코드별 인덱스가 채워지지 않고 원시 바이트 데이터를 사용하여 정확성을 유지합니다.
**안전한 양방향 변환.** 원시 바이트에서 생성된 피벗 테이블의 경우 `FromRawBlobs = True`로 설정되며, 쓰기 작업은 원시 바이트 데이터를 그대로 다시 재생합니다. 타입이 지정된 모델은 호출자가 검사할 수 있도록 최선을 다해 생성됩니다. 타입이 지정된 모델을 사용하여 바이트 데이터를 생성하는 기능은 H3 버전(프로그래밍 방식의 AddPivotTable 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에서 피벗 테이블이 손상되는 문제가 있었습니다. 이제 리더는 이러한 모든 데이터를 그대로 저장하고, 작성기는 이를 정확하게 재현하므로, 저장/로드 과정을 거친 후에도 피벗 테이블이 덮개 시트에 올바르게 표시됩니다.
**워크시트 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까지의 모든 내용을 하나의 캐시 버킷으로 처리합니다. 동일한 통합 문서 내의 여러 캐시는 각각 자체 버킷을 갖습니다. 저장 시, 작성기는 각 캡처된 캐시에 대한 전체 BOF / 레코드 / EOF 하위 스트림을 다시 생성하고, 각 시트의 본문 뒤에 있는 통합 문서 OLE 스트림에 이를 추가합니다. 이는 [MS-XLS] §2.1.7.20에서 예상하는 위치입니다.
**범위: 원시 바이트 보존만 해당 (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 오류 막대가 있는 일반적인 컬럼 차트의 경우 두 개의 항목이 사용됩니다 (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` 필드는 사용자 정의 데이터 포인트의 개수를 나타냅니다. 사양에 따르면 다른 소스의 경우 반드시 0이어야 하므로, 빌더는 호출자의 입력에 관계없이 사용자 정의가 아닌 항목의 경우 `Cnum`을 0으로 강제 설정합니다.
**T-cap 렌더링 토글 기능 추가.** `FTeeTop`은 Excel에서 막대 끝에 T자 모양의 캡을 표시할지 여부를 제어합니다 (Excel의 기본 설정은 표시). 호출자가 더 간결한 "점만 표시" 스타일을 원하는 경우 유용합니다.
**사용자 정의 값 시리즈(Ebsrc=5)에 대한 주의사항.** 최소 빌더는 선택한 Cnum 값과 함께 SerErrBar 레코드를 생성하지만, 사용자 정의 값 배열을 가리키는 관련 BRAI 클러스터는 아직 생성하지 않습니다. 따라서 사용자 정의 오류 막대는 향후 BRAI 연결이 완료될 때까지 기본 크기로 표시됩니다. 백분율/고정값/표준편차/표준오류(Ebsrc 1~4)는 이번 릴리스에서 완전히 작동합니다.

버전 2.67.0

**차트 백로그 웨이브 F의 하위 기능 2: 시리즈 추세선.** `TXLSChartSeriesInfo`에 `Trendlines: TXLSChartTrendlineInfo 배열` 필드가 추가되었습니다. 각 항목은 부모 Series 블록 내에 추세선 레코드([MS-XLS] §2.4.328, $2050)를 생성하며, SerToCrt 이후, Series End 이전에 호출 순서대로 생성됩니다. 단일 시리즈에 여러 추세선을 사용하는 것은 유효하며, Excel은 이 모든 추세선을 렌더링합니다.
**여섯 가지 회귀 유형.** `Regt`는 0=다항식, 1=지수, 2=로그, 3=거듭제곱, 4=이동 평균, 5=선형을 선택합니다. 다항식의 경우 `NOrder` 필드는 차수를 설정합니다 (2~6). 이동 평균의 경우 기간을 설정합니다 (2~N). 다른 유형의 경우 `NOrder`는 무시되지만 사양에서는 1~6을 요구하므로, 빌더는 범위를 벗어난 값을 각각 1 또는 6으로 기본 설정합니다.
**방정식 및 R² 표시 기능 추가 및 예측 기능.** `FDispEq` / `FDispRSqr` 옵션을 사용하여 차트에 방정식 및 R² 레이블을 표시합니다. `NumForecast` / `NumBackcast`는 순방향/역방향 외삽 기간을 설정합니다 (Double, ≥ 0). `NumIntercept`는 y절편을 설정하며, "자동"으로 설정하려면 NaN ($7FF8000000000000) 값을 사용합니다.
**추세선 레이블을 인라인 LPWideString으로 표시합니다.** `Name` 필드는 추세선 레코드의 sName 슬롯에 기록됩니다 ([MS-XLS] XLUnicodeString: cch:2 + grbit:1 + UTF-16 본문). 이름이 비어 있으면 Excel에서 "Linear (Series1)"과 같은 범례 항목을 자동으로 생성합니다.
**`AddSeries` 내부 함수 재구성.** 내부 `AddSeries` 도우미 함수는 이제 이전의 (이름, 범주 영역, 값 영역) 3가지 매개변수 대신 `TPreparedSeriesInfo` 단일 매개변수를 사용합니다. 이렇게 하면 향후 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에 따라 Chart3d 레코드를 추가하여 Excel의 3D 렌더링 파이프라인으로 전환합니다.
**기본 3D 기하학은 Excel의 "삽입 > 3D 열"과 동일합니다.** 20° 회전, 15° 상승, 원근 효과 해제, 클러스터 활성화, 자동 크기 조정 활성화, 높이와 깊이는 모두 너비의 100%, 간격은 150%. 벽과 직각 축은 Excel의 기본값과 일치합니다. 현재 기하학은 하드 코딩되어 있습니다(호출 측에서 제어할 수 없음); 다음 단계에서는 이를 레코드 스타일의 오버라이드로 승격할 수 있습니다.
**Chart3DBarShape ($105F) 기능이 조건부로 복원되었습니다.** v2.55.0 버전에서는 [MS-XLS] §2.4.47에서 "현재 서브스트림에 Chart3d 레코드가 포함되어 있지 않은 경우 무시해야 합니다"라고 명시되어 있고, 2D 차트에는 해당 레코드가 없으므로, Chart3DBarShape 생성을 무조건적으로 제거했습니다. Wave F는 3D 막대/3D 열 차트에 대해서만 이 기능을 복원합니다 (riser=rectangle, taper=none). 이 기능은 CHARTFORMAT 내의 Chart3d 레코드 옆에 생성되어, 사양과의 관계를 바이트 레이아웃에서 확인할 수 있도록 했습니다. 3D 선 및 3D 파이 차트에서는 여전히 이 기능을 생략합니다 (riser/taper 개념이 적용되지 않음).
**3D 파이 차트는 축을 모두 생략합니다.** 축 사용 횟수 및 축 생성 경로는 이제 `xlsChartType3DPie`를 `xlsChartTypePie`와 동일하게 처리합니다. 즉, 축 사용 횟수는 0이고, 범주/값 축이 생성되지 않습니다. 이 기능을 활성화하지 않으면 Excel에서 차트의 경계를 벗어난 축 선이 표시되는 문제가 있었습니다.

버전 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 왕복 기능 및 드로잉 테마 도우미.** 세 가지 개선 사항은 이전 단계에서 해결하지 못한 테마 색상 관련 문제를 해결합니다. Excel에서 페이지 레이아웃 → 색상을 통해 설정된 사용자 정의 테마 팔레트가 로드 과정에서 유지됩니다. 파서는 BIFF8 `$0892` 테마 레코드에 포함된 OOXML ``을 읽고 워크북의 12개 슬롯을 가진 `FBiffTheme`을 업데이트합니다. 쓰기 모듈은 팔레트가 기본 Office 스키마에서 변경된 경우 동일한 레코드를 생성하므로, 사용자가 설정한 테마가 HotXLS를 통해 변경 사항 없이 유지됩니다. 새로운 `XlsApplyThemeColorToDrawing` 도우미를 통해 차트/도형에서 셀과 동일한 테마 인덱스 및 색조를 사용하여 드로잉 색상을 설정할 수 있습니다.
**OOXML 테마 XML 파싱:** `ParseTheme` 함수는 레코드 본문(frtRefHeaderU + dwThemeVersion + 가변 길이 XML 페이로드, 여러 개의 Continue 레코드를 포함할 수 있음)을 하나의 바이트 버퍼로 결합하고, 12개의 `` 자식 요소(dk1, lt1, dk2, lt2, accent1..6, hlink, folHlink)를 찾기 위한 특정 부분 문자열 검색을 수행합니다. 각 슬롯에 대해 ``를 우선적으로 사용하고, 그렇지 않은 경우 ``를 사용합니다. 그런 다음 `RRGGBB`를 HotXLS의 COLORREF 형식으로 변환하고 `FBiffTheme.SetThemeRGBColor` 함수를 호출합니다. OOXML 형식이 아닌 경우(예: `` 요소가 누락되었거나 ZIP으로 압축된 경우) 팔레트를 기본 스키드로 유지하여 일반적인 렌더링이 올바르게 유지되도록 합니다.
**작성자:** 테마 레코드 방출 시 기본값일 경우 건너습니다. `TXLSWorkbook.StoreTheme`는 `IsBiffThemeDefault`가 팔레트가 Office 기본 스키마와 다를 경우에만 `$0892` 레코드를 방출합니다. OOXML 본문은 결정적인 템플릿에서 생성됩니다. 여기에는 12개의 `` 항목(Excel 기본 sysClr 형식이 아닌 이유는 dk1/lt1의 경우 동일한 파서를 통해 처리되지만 sysColor 이름 해석기가 필요하지 않기 때문)과 스키마에서 요구하는 최소한의 `` / `` 섹션이 포함됩니다. 수정되지 않은 워크북은 레코드를 방출하지 않으며 이전 버전(Phase 5 이전)의 출력과 동일한 바이트 크기를 유지합니다.
**그림 테마 색상 도우미.** 새로운 무료 함수 `XlsApplyThemeColorToDrawing(ColorFormat, Workbook, ThemeIdx, Tint)`는 워크북 팔레트를 통해 테마 인덱스와 음영을 처리하고, 그 결과를 `TXLSColorFormat` 객체(도형 채우기/선/차트 색상)에 RGB 값으로 기록합니다. BIFF8 OfficeArt는 Office 2007 이전의 이진 형식이며, 기본적으로 테마 색상 인코딩을 지원하지 않으므로, 이 기능은 쓰기 전용입니다. 읽어올 경우, 테마 슬롯 대신 처리된 RGB 값이 반환되며, 디스크에 저장되는 테마 참조 정보는 손실됩니다. 완전한 테마 지원을 위해서는 셀에 `IXLSInterior.SetThemeColor`, `IXLSFont.SetThemeColor`, `IXLSBorder.SetThemeColor`를 사용하십시오. 이 기능은 XFExt $087D를 활용합니다.
**Wave D는 총 다섯 단계로 완료되었습니다.** 1단계(v2.58.1)에서는 테이블 인식 기능을 추가했습니다. 2단계(v2.59.0)에서는 RGB 셀 색상에 대한 XFExt를 구현했습니다. 3단계(v2.60.0)에서는 RGB 리더 루프를 완료했습니다. 4단계(v2.61.0)에서는 셀에 대한 테마 색상 경로를 적용했습니다. 5단계(현재)에서는 사용자 정의 테마 XML의 양방향 처리 및 드로잉 관련 지원 기능을 추가하여 마무리합니다. 이제 셀은 BIFF8 사양이 표현할 수 있는 모든 팔레트/RGB/테마 색상 조합에 대해 엑셀과 동일한 픽셀 단위로 렌더링됩니다. 드로잉은 시각적 의도를 유지하지만, 읽기 시 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).** 엑셀에서 워크시트에 헤더 또는 푸터 배경 이미지를 저장할 때 (삽입 → 머리글 & 바닥글 → 그림, 예를 들어 회사 로고 스타일), 해당 이미지는 `HFPicture` ($086C) 레코드에 포함되어 있으며, 이 레코드는 OfficeArt BLIP을 포함합니다. 이전 버전의 HotXLS에서는 이 레코드에 대한 처리 로직이 없어 로드 시 전체 데이터가 삭제되었고, 따라서 워크북을 다시 저장하면 헤더/푸터 이미지가 손실되었습니다. 이제 HotXLS는 각 시트에 대해 전체 레코드 내용을 (연속된 모든 청크를 연결하여) 유지하고, 쓰기 작업 시 해당 내용을 규격에 맞게 정확한 위치에 다시 기록하여 엑셀이 파일을 열 때 원래 이미지가 그대로 유지되도록 합니다.
**Reader는 데이터를 저장하기 전에 모든 "Continue" 청크를 연결합니다.** `ParseWorksheetRecord` 내의 새로운 `ParseHFPicture` 분기는 정렬된 `DataList`의 모든 항목을 순회합니다 (슬롯 0의 $086C 본문과 뒤따르는 $003C 본문). 이 연결된 바이트를 단일 `TBytes` 객체로 저장하여 워크시트에 저장합니다. 워크시트는 여러 항목을 포함할 수 있습니다. (Excel UI에서 최대 6개 항목까지 가능하며, 이는 기본/첫 페이지/짝수 페이지에 대해 왼쪽/가운데/오른쪽 위치를 나타냅니다). 따라서 저장 방식은 단일 필드 대신 배열을 사용합니다.
**작성기는 PageSetup 바로 뒤에 HFPicture 레코드를 생성하고, 기존의 Continue 분할기를 사용하여 BLIP 오버플로우를 처리합니다.** 새로운 `StoreHFPictures` 단계가 각 시트 저장 순서에서 `StoreSetup` 바로 뒤에 삽입되어 [MS-XLS] §2.1.7.20.2 워크시트 ABNF에서 `*HFPicture`의 위치와 일치합니다. 보존된 각 데이터는 새로운 $086C 헤더로 래핑되고 `AppendData`를 통해 처리됩니다. 기존의 `AddContinue` 도우미는 BLIP가 8224바이트 BIFF 제한을 초과할 때 사용되며, 결과적으로 30~50KB의 JPEG 이미지가 하나의 $086C 레코드와 네 개에서 여섯 개의 $003C 레코드로 분산되어 저장되며, 이는 Excel이 사용하는 방식과 동일합니다.
**새로운 공개 API는 추가되지 않았습니다.** Wave G는 양방향 보존 기능입니다. HFPicture 콘텐츠는 애플리케이션 코드에 대해 투명하며, 새로운 헤더 이미지를 삽입할 수 있는 공개 setter는 제공되지 않습니다. HFPicture 레코드를 포함하지 않았던 워크북은 이전과 동일한 바이트 출력을 생성합니다. 내부 도우미 함수 `TXLSWorksheet._AddHFPictureBlob`은 사용자를 위한 것이며, 밑줄 접두사는 `_Drawing` / `_Autofilter`와 동일한 방식으로 내부 함수임을 나타냅니다.

버전 2.56.0

**차트 백로그 웨이브 B: 워크시트 탭 색상 양방향 지원 (BIFF8 SheetExt).** 엑셀에서 마우스 오른쪽 버튼 클릭을 통해 설정한 탭 색상이 이제 BIFF8 경로를 통해 읽기 및 쓰기가 모두 가능합니다. `TXLSWorksheet.TabColor`는 새로운 공개 속성으로, HotXLS의 `LongWord` 색상 값을 받습니다 (하위 바이트는 R, 중간 바이트는 G, 상위 바이트는 B, 최상위 바이트는 0이며, `Font.Color` / `Interior.Color`와 동일한 규칙). 기본값인 `0`은 "자동 / 탭 색상 없음"을 의미하며, 해당 레코드를 완전히 제거합니다.
**Writer는 각 시트에 대한 `SheetExt`($0862) 레코드를 생성합니다.** `TabColor` 값이 0이 아닌 각 시트에 대해, 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 레코드가 없습니다).
**Reader는 열기 시 탭 색상을 복원합니다.** `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에서 가져온 파일 중 탭 색상이 하나 이상 있는 경우, 모든 탭이 기본 자동 색상으로 변경되는 대신, 원래의 색상이 유지되도록 처리됩니다.

버전 2.55.1

**주요 브랜치 빌드 복원.** HotXLS가 RAD Studio 12 이상 버전에서 컴파일되지 않도록 하는 두 가지 기존 식별자 오류가 수정되었습니다. 이 오류들은 이전 버그 수정 릴리스에 포함되었지만, 컴파일 검사를 거치지 않아 다음 기여자가 패키지를 다시 빌드하려고 할 때 문제가 발생했습니다.
**공유 수식 다중 열 작성기가 더 이상 존재하지 않는 레코드 필드를 참조하지 않습니다.** v2.50.0 SHRFMLA의 와이어 형식 수정 사항은 `WriteShrfmla` 함수에 `Data.AddByte(Group.LastCol)`을 추가했지만, `TXLSShrfmlaGroup`에 새로운 필드를 추가하지 않았기 때문에 "Undeclared identifier: LastCol" 오류로 컴파일에 실패했습니다. 이제 레코드에는 기존의 `FirstCol`과 함께 `LastCol` 필드가 포함되어 있으며, `CollectSharedFormulas.OpenGroup` 함수는 이 필드를 그룹의 기준 열로 채웁니다. 단일 열 공유 수식 그룹(현재 콜렉터가 생성하는 유일한 유형)의 동작은 변경되지 않았습니다. 사양에 맞게 `colLast` 바이트가 이제 `colFirst`의 별칭이 아닌 실제 값으로 설정되었습니다.
**XLSX 셀 작성기는 `XlsxFloatToStr` 함수를 순방향 선언을 통해 참조합니다.** v2.51.0 버전의 로케일 안전성 수정 사항에서, 셀 값 처리 부분(2718행)에서 `XlsxFloatToStr` 함수가 호출되었지만, 해당 함수는 수백 줄 아래(2910행)에 정의되어 있었습니다. 순방향 선언이 없었기 때문에 Delphi의 단일 패스 컴파일러는 "선언되지 않은 식별자: XlsxFloatToStr" 오류를 보고했습니다. 이제 순방향 선언을 `lxHandleX` 구현 블록의 맨 위에 배치하여 초기 호출 위치와 기존 정의가 모두 정상적으로 컴파일되도록 했습니다.

버전 2.55.0

**차트 개선 작업 A: 다중 시리즈 캐시 연결 + 차트/축 제목 캡션.** 오랫동안 지속되어 온 두 가지 차트 생성 기능 제한 사항이 해결되었습니다. 이 두 가지 개선 사항 모두 v2.54.0 버전의 개선 작업 목록에서 비롯되었습니다. 첫 번째 변경 사항은 데이터 전송 방식만 변경되었으며 API 변경은 없습니다. 두 번째 변경 사항은 기존 `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)`와 일치합니다. 캐시 슬롯은 여전히 0 값을 유지합니다 (BRAI `PtgArea3d` 참조는 드로 타임에 실제 소스 셀을 참조함); 이 변경 사항은 Excel의 엄격한 파서에게 완전한 캐시 정보를 제공하는 것뿐입니다.
**차트 제목 / 범주 축 제목 / 값 축 제목** 텍스트가 올바르게 표시됩니다. 1단계 구현에서는 `AddChartSheet` 함수의 여러 버전에서 세 개의 제목 매개변수를 받았지만, 아무 작업도 수행하지 않고 버렸습니다("`Junk := Length(...)`" 임시 코드). 이제는 올바른 연결 레이블 블록을 생성합니다. 이 블록은 `TEXT`($1025) + `POS` + `BRAI` 리터럴-tStr + `SeriesText`($100D) + `OBJECTLINK`($1027) + End로 구성되며, [MS-XLS] §2.1.7.20.1 CHARTTITLES ABNF에 따라 `CHART` 컨테이너의 끝 레코드 바로 앞에 위치합니다. `OBJECTLINK.wLinkObj`는 [MS-XLS] §2.4.182에 따라 차트 제목의 경우 1, 값 축 제목의 경우 2, 범주 축 제목의 경우 3을 사용합니다. 이제 호출자가 `Title := 'Quarterly Sales'`를 전달하면 Excel에서 플롯 영역 위에 "Quarterly Sales"라는 텍스트가 표시됩니다.

버전 2.54.1

**[MS-XLSX] 교차 감사 후속 조치.** v2.52.0 감사에서 "보류" 목록에 있던 두 가지 문제에 대한 수정 사항입니다. 두 가지 모두 사용자에게 영향을 미치며, 기존 기능에 영향을 미치지 않습니다.
**날짜 셀은 다른 스타일과 함께 사용될 때 날짜 형식을 유지합니다.** `FontIndex` / `FillIndex` / `BorderIndex` / `AlignmentIndex` / `ProtectionIndex`가 설정되었지만 명시적인 `NumberFormatIndex`가 사용되지 않은 `TDateTime` 셀은 `numFmtId`가 0인 단일 차원 셀Xf를 통해 처리되었으며, 이로 인해 Excel에서 셀이 날짜 대신 원시 시리얼 번호(예: `46038`)로 렌더링되었습니다. XLSX 스타일 엔진은 이제 암시적 날짜를 가상 차원으로 처리합니다. 다른 스타일이 적용된 차원은 셀을 실제 차원과 함께 `numFmtId=14`를 포함하는 복합 셀Xf로 변환합니다. 다른 스타일이 없는 순수 날짜 셀은 이전과 같이 `XlsxXfIndexDate`로 처리됩니다. 새로운 공개 기능: `TXLSXWorkbook.RegisterCompositeXf` / `GetCompositeXf`는 7개의 인수를 받는 오버로드 기능을 추가하여 OOXML 내장 `numFmtId`를 재정의할 수 있습니다 (기존의 6개 인수를 받는 시그니처는 변경되지 않았으며, 재정의가 비활성화된 새로운 변형으로 전달됩니다).
**Excel의 명명 규칙을 위반하는 시트 이름은 자동으로 수정됩니다.** Excel은 31자를 초과하거나, `: , /, ? * [ ]` 문자를 포함하거나, 작은따옴표로 시작하거나 끝나거나, 예약된 이름 `History` (대소문자 구분 없음)와 동일하거나, 다른 시트 이름과 충돌하는 시트 이름을 거부합니다. 이전에는 HotXLS가 사용자의 입력값을 그대로 전달했기 때문에, `Workbook.Sheets.Add('Q1:Q2 Sales')`와 같은 호출은 "입력하신 이름이 유효하지 않습니다"라는 오류 메시지가 표시되는 워크북을 생성했습니다. `TXLSXSheets.Add`는 이제 새로운 `XlsxSanitizeSheetName` 함수를 사용하여 이름을 정규화합니다 (금지된 문자는 `_`로 대체되고, 앞뒤의 작은따옴표는 제거되며, 길이는 31자로 제한되고, 비어 있거나 예약된 이름은 `Sheet`으로 대체됨) 그리고 대소문자 구분 없이 충돌하는 경우 `'(2)'` / `'(3)'` 접미사를 추가합니다. 이미 유효한 이름의 경우 변경되지 않으므로, 규격에 맞는 .xlsx 파일에서 추출된 시트는 변경 없이 유지됩니다.

버전 2.54.0

**[MS-XLS] v20250520 및 [MS-OFFCRYPTO] v20240820에 대한 두 번째 심층 사양 감사.** 워크시트 셸 레코드, SST/Continue 경계, 수식 PTG 깊이, 암호화 패딩, 차트 레코드, 드로잉/주석 작성 및 피벗/테이블 지원과 관련된 8개의 독립적인 예외/와이어 형식 결함이 발견되었으며, 8명의 병렬 코드 검토자가 이를 확인했습니다. 공개 API는 변경되지 않았으며, 기존 코드는 수정 없이 다시 컴파일됩니다.
**Comment Note 레코드가 이제 사양을 준수합니다.** `TMsoDrawing.StoreNotes`에서 두 가지 중요한 수정 사항이 적용되었습니다 ( [MS-XLS] §2.4.179 Note 참조): (1) `idObj`가 이제 LongWord(4 바이트) 대신 Word(2 바이트)로 기록되어 `idObj` 이후의 모든 바이트가 잘못 정렬되는 문제를 해결했습니다. (2) 이전에 존재하지 않았던 `stAuthor` XLUnicodeString 필드가 `FAuthor`에서 직렬화됩니다 (cch + 플래그 + UTF-16 본문). Excel의 엄격한 리더는 `stAuthor`에서 Note 구문 분석을 중단하므로, 이 필드를 생략하면 Excel이 파일을 열 수 있더라도 주석 메타데이터가 손상되었습니다.
**`Visible` 속성이 더 이상 의도를 반대로 해석하지 않습니다.** `TMSOShapeTextBox.GetVisible` / `SetVisible` 메서드는 `fHidden`이 설정되었을 때 `True`를 반환하고, 호출자가 주석을 보이도록 요청하면 `fHidden` 값을 저장했습니다. 여기서 비트의 의미는 반대입니다 ([MS-XLS] §2.4.179 grbit 비트1: 1 = 숨김). 이전에 `Comment.Visible := True`를 사용하여 호출하면 숨겨진 주석이 표시되었지만, 이제 이 속성은 이름에 맞게 양방향으로 작동합니다.
**RC4 암호 파생이 16자 이상의 비밀번호에 대해 올바르게 작동하도록 수정되었습니다.** [MS-OFFCRYPTO] §2.3.6.1에서는 MD5 단일 블록 메시지 길이를 56~63 바이트에 64비트 리틀 엔디안 비트 수로 저장합니다. 이전 읽기(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에 따르면 최대 하나의 FILEPASS만 허용됩니다. 악의적이거나 잘못된 형식의 워크북에서 두 번째 FILEPASS 레코드가 사용될 경우, 활성 해독기를 해제하고 중간 과정에서 새로운 키 스트림을 다시 생성하여 데이터와 동기화가 깨질 수 있습니다. 이후의 FILEPASS 레코드는 이제 조용히 무시되지만, 암호화는 계속 유지됩니다.
**PtgArray V 클래스 opcode가 올바르게 생성됩니다.** 이전에 `GetArrayData(aClass=0)`는 A 클래스 opcode ($60)로 잘못 처리되었지만, [MS-XLS] §2.5.198.32에 따르면 V 클래스 opcode는 $20, R 클래스 opcode는 $40, A 클래스 opcode는 $60입니다. 이제 `aClass=0`이 올바르게 $20으로 매핑됩니다.
**Chart3DBarShape가 더 이상 2D 차트에 생성되지 않습니다.** [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` 함수에서 인라인 문자열 대체 기능을 사용할 때 `<is><t>...</t></is> 코드가 생성되었지만, `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> 요소의 두 번째 자식 요소로 이 요소를 생성합니다 (<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 작성기에 대한 다섯 가지 와이어 형식 및 로케일 안전 관련 오류를 수정했습니다. 공개 API는 변경되지 않았으며, 기존 애플리케이션은 수정 없이 다시 컴파일하고 저장할 수 있습니다.
**이제 .xlsx 파일이 모든 Windows 지역에서 열립니다.** 페이지 여백, 열 너비, 행 높이, 글꼴 크기, 색상 음영, 테마 음영, 사용자 정의 글꼴 서식의 텍스트 실행 크기, 그리고 각 셀의 숫자 값(<v>로 묶임)은 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 문서의 어느 곳에도 사용할 수 없으며, 이러한 값은 숫자 문자 참조로 인코딩할 수도 없습니다. 이전에 이러한 바이트를 포함하는 셀 값(레거시 데이터 피드, 로그 덤프, 이스케이프 키 센티넬)은 `...` 태그 내에 그대로 기록되었으며, 이로 인해 .xlsx 파일을 열 수 없었습니다. 이제 쓰기기는 금지된 코드 포인트를 조용히 제거하며, 유효한 공백(탭/줄 바꿈/캐리지 리턴)은 유지됩니다.
**속성 값 내의 줄 바꿈이 올바르게 왕복됩니다.** XML 섹션 3.3.3에서는 속성 값 내의 원시 탭/줄 바꿈/캐리지 리턴을 단일 공백으로 정규화한 다음 값을 애플리케이션에 전달합니다. 여러 줄의 머리글/바닥글, 정의된 이름의 주석, 여러 줄의 데이터 유효성 검사 프롬프트, 하이퍼링크 표시 문자열 및 줄 바꿈을 포함하는 다른 모든 속성은 로드 시 단일 공백으로 축소되었습니다. `XlsxEscapeAttr`은 이제 해당 문자를 `	` / `
` / `` 숫자 문자 참조로 출력하므로 Excel에서 원래의 공백 문자로 읽을 수 있습니다.
<col> entries emitted in ascending column order. ECMA-376 18.3.1.4 / 18.3.1.13 expects every <col min="..."/> entry to appear in ascending min order. The previous TStringList(Sorted=True) dedup sorted the integer column indices lexically ("10" before "2"), so a sheet that customised both column 2 and column 10 produced <col min="10"/> before <col min="2"/>. Excel tolerated the layout but Office File Validation flagged the file and strict OOXML consumers (Apache POI strict mode, LibreOffice with strict-validation enabled) rejected it. Column entries are now sorted numerically before emission.

버전 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

Spec-audit pass against [MS-XLS] v20250520. Sixteen wire-format and behaviour fixes across the BIFF8 writer, formula decoder, encryption path, chart builder, conditional-format and data-validation runtime, SST/ExtSST index, VBA storage reader and OLE stream open path. Public API unchanged; existing code recompiles untouched. Highlights below.
BIFF8 Formula record Boolean and Error results now round-trip correctly. [MS-XLS] §2.5.133 FormulaValue packs the type tag into byte[0] and the bool/error code into byte[1]; the writer used to emit $0001/$0002 as a Word and put the value into byte[2], so cached Boolean formulas read back as False and Error formulas as #NULL! in every consuming application.
Cell colours set via SetColorRGB render correctly. The colour manager wrote ColorType=1 (theme) for RGB values and ColorType=2 (RGB) for theme values, swapping the two code paths. Both setters now route through the matching ColorType bucket so RGB values feed the RGB resolver and theme indices feed the theme resolver.
XOR Obfuscation and RC4 decryption fixed. The XOR Method-1 decrypt loop now matches [MS-OFFCRYPTO] §2.3.7.3 (XOR first, then rotate-right 5; seed XorArray index from the entry stream position, not the post-process position). RC4 Skip now walks every 1024-byte boundary continuously instead of jumping straight to the destination block, keeping the keystream state aligned with the file position for every subsequent Decrypt call.
Chart sheet wire format aligned with the spec. SIIndex records emit in numIndex=1 → 2 → 3 order ([MS-XLS] §2.4.262; was 2 → 1 → 3, which strict parsers reject), DEFAULTTEXT count clamped to the spec maximum of 2 ([MS-XLS] §2.1.7.20.1; was 4), Chart3DBarShape placeholder uses the correct id $105F (was $1066).
HLink tooltip records load correctly. The HLinkTooltip ($0800) body decoder used to read FrtRefHeader anchor fields at offsets 2/4/6/8 instead of 4/6/8/10, so the anchor-range comparison never matched and per-cell tooltips were silently discarded; tooltips now associate with their hyperlinks. BIFF8 range-reference decoder also fixed a FFirstColRel/FLastColRel typo in the BIFF5/7 fallback sign-extension path that mis-decoded ranges with negative last-column relative offsets.
Conditional formatting and data validation runtime fixes. IsContainRow in both TCondRange and TDVRange returned true only when the range degenerated to a single row (the comparison was inverted); per-row clearing of CF / DV rules now works on multi-row ranges. Three destructors (CondFormat, formatter, DVRangeList) used for i := 0 to cnt on lists whose valid indices are 0..cnt-1; the off-by-one is fixed and long-running workloads no longer occasionally AV during teardown. CF12 icon-set rules emit ct=$06 (IconSet per [MS-XLS] §2.4.43) instead of ct=$05 (Filter), so workbooks containing icon-set rules open with the rules intact.
ExtSST quick-find index spec-conformant for large workbooks. The dsst field is now computed as max((cstUnique / 128) + 1, 8) per [MS-XLS] §2.4.107 instead of the static default of 8; workbooks with more than ~900 unique strings now build a correct rgISSTInf bucket array and Excel's quick-find SST lookup works.
WriteAccess record honours [MS-XLS] §2.4.349 cch <= 54. The userName.cch field now carries the actual user-name length (6 for "HotXLS") with the remaining bytes filled by the spec-defined "unused" trailer. Previously the field carried cch=109, which Office File Validation flags as a hard format violation.
BIFF8 Workbook stream open path matches the spec spelling. The first OLE OpenStream attempt uses 'Workbook' (capital W per [MS-XLS] §2.1.7.20) instead of all-lowercase, so compound-file containers on case-sensitive OLE implementations open the stream on the first try.
VBA module reader no longer drops the last byte of each stream. The seek-to-end length used trunc(l) - 1 instead of trunc(l), truncating the compressed-source tail and causing the RLE container decompressor to terminate early on certain modules.

버전 2.48.10

HotXLS 가 저장한 .xls 파일은 이제 Excel 이 모든 워크북에서 기대하는 두 개의 OLE 복합 파일 속성 세트 스트림을 포함합니다: \005SummaryInformation 과 \005DocumentSummaryInformation. v2.48.10 이전에는 TRIAL 빌드만 작성했습니다(배너 스탬핑 메커니즘으로); 릴리즈 빌드는 Workbook 스트림이 유효한 BIFF8 이지만 OLE 컨테이너가 표준 Office 메타데이터 스트림을 누락한 .xls 파일을 생성했습니다. Excel 2003 의 엄격한 파서는 이를 "File error: data may have been lost" 조건으로 취급합니다(현대 Excel 은 보호된 보기 "이 파일에 문제가 있습니다" 배너를 유지). 스트림을 추가하면 BIFF8 레코드를 변경하지 않고 차트 워크북의 대화 상자가 해결됩니다.
두 스트림은 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 유닛이 두 개의 헬퍼 프로시저를 보유합니다; lxHandle.pas 는 StoreWorkbook 이 Workbook 스트림을 채운 후 FDocStorage.Commit 전에 TXLSWorkbook.SaveWorkbook 내에서 무조건 호출합니다.
이 릴리즈는 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 바이트), 카테고리 / 값 / 버블 크기 캐시 슬롯을 표시하는 세 개의 SERIESINDEX($1065), 캐시된 값 포인트당 하나의 NUMBER($0203, 14 바이트), 그리고 끝에 WINDOW2($023E, 10 바이트 차트 시트 변형).
바이트 값은 dev-notes/biffview-refs/excel_column_chart_resaved.xls(Excel 이 저장한 세로 막대 차트 참조, 로컬)에서 그대로 복사.
값 캐시는 현재 0 자리 표시자(각 데이터 포인트에 대해 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 까지 모든 차트 릴리즈에 전파되었습니다. 올바른 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 은 거기에 카테고리 셀 범위를 기대, 문자열 리터럴을 찾고 포기하여 X 축을 네 개의 0 으로 렌더링.
Excel 저장 세로 막대 차트 wire 형식과도 재정렬: SERIES.sdtX 가 이제 0x0003(텍스트 카테고리에 대한 Excel 의 관찰값, [MS-XLS] §2.4.252 가 문서화한 0x0001 아님), 그리고 cValx 가 0 이 아닌 실제 카테고리 수를 운반합니다. "sdtX ∈ {1, 3} 일 때 cValx MUST = 0" 규칙은 검사된 모든 Excel 저장 샘플에 의해 모순됩니다.
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 의 차트 substream 을 레코드 별 디코딩과 함께 덤프합니다(SERIES / BRAI / SERIESTEXT / AXIS / CATSERRANGE / LEGEND / OBJECTLINK / POS / TEXT). 이번 릴리즈 동안 HotXLS 출력을 Excel 저장 참조 샘플과 바이트 diff 하는 데 사용; 미래의 차트 spec follow-up 에 사용 가능.

버전 2.48.6

BIFF8 차트 시트 substream 이 v2.48.5 변경 사항을 철회합니다. 재생성된 v2.48.5 데모의 실제 Excel 테스트는 차트를 전혀 렌더링하지 않았습니다 —— v2.47.0 베이스라인(차트가 그려지지만 X 축 레이블이 잘못됨)보다 나쁩니다. v2.48.5 의 두 가지 변경이 원인이었습니다:
- Apache POI 가 CATEGORY_DATA_TYPE_TEXT = 4 를 노출함에도 불구하고 SERIES.sdtX = 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 준수 수정 하나를 추가합니다: sdtX = 1 일 때 SERIES.cValx 가 이제 0 입니다([MS-XLS] §2.4.252 spec MUST 규칙). v2.48.6 이전에는 cValx = count(데모에서 4)를 썼고 이 규칙을 위반했으며, 이로 인해 Excel 의 "문서에 문제가 있습니다" 보호된 보기 프롬프트에 기여했을 수 있습니다. cValy 는 실제 값 수를 유지합니다(sdtY=1 은 0 규칙 없음).
새 XlsCreateChart Delphi 데모를 Demo/Delphi/XlsCreateChart/ 에 추가했습니다. 두 시트 워크북을 생성합니다: 4 행 (Region, Sales)의 "Data" 시트와 series 가 Data!$A$2:$A$5 / Data!$B$2:$B$5 을 Categories / Values 로 바인딩하는 "Chart1" 세로 막대 차트 시트. 이 데모는 v2.47.0 — v2.48.5 가 BiffView 테스트를 위해 저장소 루트에 두었던 임시 chart_phase2_demo.xls 의 영구 후속입니다. 루트 파일은 제거되었고, 새 데모는 자체 .exe 의 디렉토리 옆에 출력을 씁니다.
알려진 미해결: v2.48.6 의 wire 형식으로도 Excel 은 여전히 세로 막대 차트의 X 축 레이블을 0 으로 렌더링하고, 범례에 대해서는 BRAI id=2 PTG tStr 리터럴 'Q1 Sales' 를 사용하는 대신 카테고리 셀 텍스트 연결로 폴백합니다. 바이트 diff 를 위해 Excel 자체가 저장한 참조 세로 막대 차트가 필요한 실제 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")를 사용자 지정 Name 대신 범례와 자동 제목 모두에 사용했습니다. 두 가지 수정으로 의도된 렌더링이 복원됩니다:
SERIES 레코드의 sdtX 필드가 이제 1 이 아닌 4(텍스트 카테고리)입니다. [MS-XLS] §2.4.252 는 1(날짜)과 3(BIFF7 시퀀스)만 문서화하지만, 실제 Excel 이 저장하는 세로 막대 / 가로 막대 / 꺽은선 차트 파일은 텍스트 축 카테고리에 4 를 씁니다(Apache POI 의 CATEGORY_DATA_TYPE_TEXT 상수와 일치). sdtX=1 일 때 Excel 은 'North' / 'South' 셀을 숫자로 변환하려다 실패 → 0 으로 폴백; sdtX=4 면 텍스트 레이블이 그대로 표시됩니다. 이전의 wire format 은 또한 "sdtX=1 일 때 cValx 는 0 이어야 한다"는 spec 규칙을 위반했습니다.
리터럴 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 형식을 얻습니다; 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는 막대 색상, 최소/최대 임계값 및 백분율 길이 경계를 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

NPOI CFRule12Record.serialize() 및 Excel 저장 참조 파일에 따라 BIFF8 CF12 ($087A) 헤더 레이아웃 수정. Excel은 formula tokens 앞에 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

Excel 저장 파일과 일치하도록 BIFF8 CONDFMT12 ($0879) 레코드 와이어 형식 수정. 이전 구현은 초기 spec 초안을 따라 8바이트 관련 범위를 FtrHeader 내의 "예약됨"으로 두고 numCF 앞에 존재하지 않는 4바이트 예약 필드를 삽입했습니다. Excel 저장 .xls 파일은 실제로 그 8바이트를 규칙의 관련 셀 범위로 채웁니다. 참조: poi_ConditionalFormattingSamples.xls 레코드 152가 이제 바이트 단위로 일치합니다.
v2.34.0 — v2.47.0에서 HotXLS로 생성된 .xls 파일은 CONDFMT12 레코드를 복구하기 위해 v2.47.1을 통해 다시 저장해야 합니다.

버전 2.47.0

BIFF8 차트 시트 생성이 이제 series 에 실제 데이터 범위를 바인딩합니다. AddChartSheet의 6 인자 오버로드에 전달되는 Categories와 Values A1 문자열(예: 'Data!$A$2:$A$5')은 tArea3D PTG 토큰으로 컴파일되어 시리즈의 BRAI id=0(카테고리)와 BRAI id=1(값) 레코드에 기록됩니다. Excel 에서 연 .xls 파일은 이제 v2.42.0 의 빈 플레이스홀더 차트가 아니라 플롯 영역에 실제 데이터 포인트를 렌더링합니다.
시트 이름 해석과 EXTERNSHEET 등록은 자동입니다: 파서는 워크북에서 명명된 시트를 찾고, XTI 항목이 없으면 등록하며, 해당하는 0 기반 ixti를 PtgArea3d 본문에 기록합니다. 다시 저장할 때 차트 레코드 스트림은 수식 컴파일러를 통해 재직렬화되어 ixti가 최종 EXTERNSHEET 순서와 일관성을 유지합니다.
허용되는 참조 형태: Sheet1!$A$2:$A$5 (절대), Sheet1!A2:A5 (상대 마커 허용 — 차트 시리즈는 항상 절대로 저장), 'My Sheet'!$A$1:$B$5 (공백이 포함된 시트 이름은 작은따옴표로 감쌈), Sheet1!$A$1 같은 단일 셀 참조(1×1 PtgArea3d 로 축약). 데이터 포인트 개수(cValx / cValy)는 영역 차원에서 자동으로 유도됩니다.
지원되지 않는 참조 형태는 차트가 Excel 에서 계속 열리도록 v2.41.0 스타일의 cce=0 자리표시자 BRAI 로 조용히 폴백합니다: 워크북 간 참조([Book2.xls]Sheet1!...), 명명된 범위(Sheet1!ProfitColumn), ! 시트 접두사가 없는 참조, 그리고 차트 시트 자신을 가리키는 참조. 이러한 케이스는 후속 단계로 미뤄집니다.
이로써 Roadmap #10 Phase 2 (세로 막대 차트 엔드투엔드)가 완료됩니다. 시리즈 라벨(Phase 2 전반, v2.42.0) + 시리즈 범위 바인딩(이번 릴리스)으로 AddChartSheet로 생성한 세로 막대 차트가 이제 Excel 내 후처리 없이 올바른 범례 항목과 실제 데이터를 표시합니다.

버전 2.46.0

BIFF8 측의 DXF 디코더는 이제 표준 Excel 2003 64색 팔레트에서 xclrType=1(인덱스 팔레트) 색상을 해석합니다.
조회는 HotXLS 내장 Excel 2003 기본 팔레트를 사용합니다 — icv 0..7은 8개 시스템 색상, icv 8..15는 시스템 색상을 미러링, icv 16..63은 표준 사용자 정의 가능한 기본값. 범위 밖 icv는 검정으로 폴백합니다.
BIFF8 PALETTE 레코드의 워크북 사용자 정의는 참조되지 않습니다.
xclrType=0(자동) 및 xclrType=2(RGB) 경로는 변경되지 않았습니다.

버전 2.45.0

조건부 서식 규칙은 이제 XLSX <cfRule priority="N"/>와 BIFF8 CF12 ipriority 필드 양쪽에서 priority 속성을 라운드트립합니다.
TCondFormatRule(BIFF8 측) 및 TXLSXConditionalFormat(XLSX 측)에 새 Priority 속성. 기본값 0은 기존 auto-by-index 동작을 유지하며, 양수 값은 우선순위를 고정합니다.
Priority는 다중 규칙 레이어링을 제어합니다 — 여러 규칙이 같은 범위를 다룰 때 Excel은 우선순위 순서로 적용합니다. Priority의 라운드트립은 사용자가 의도한 렌더링 순서를 유지합니다.
Priority를 건드리지 않는 호출자의 기본 동작은 변경되지 않았습니다.

버전 2.44.0

아이콘 집합 조건부 서식 규칙은 이제 XLSX 측에서 stop별 아이콘 재정의를 지원합니다. 3 / 4 / 5 stop 아이콘 집합의 각 stop은 패밀리 기본값을 옵트아웃하고 17개의 Excel 2007 내장 아이콘 패밀리 중 어느 것에서든 아이콘을 표시할 수 있으며, 아이콘 세트 이름 + 아이콘 id로 식별됩니다. OOXML 요소: <cfIcon iconSet="OtherSet" iconId="N"/>.
TXLSIconSetSpec의 새 메서드: SetIconOverride(stopIndex, OverrideSet, IconId) 및 ClearIconOverride(stopIndex). 읽기 전용 속성 HasIconOverride[i], IconOverrideSet[i], IconOverrideId[i].
XLSX 라이터는 SetIconOverride를 호출한 stop에 대해서만 <cfIcon> 자식을 발행합니다. 리더는 들어오는 <cfIcon> 요소를 위치별로 파싱합니다.
알려진 제한 사항: BIFF8(.xls) CFEX는 stop별 재정의 슬롯이 없으므로, 재정의가 있는 규칙을 .xls로 저장하면 모든 stop이 패밀리 기본값으로 렌더링됩니다.

버전 2.43.0

XLSX(.xlsx) 조건부 서식 규칙은 이제 데이터 막대 및 색조 규칙의 <color> 요소에서 테마 색상 참조를 라운드트립합니다. 이전에는 라이터가 <color rgb="FFRRGGBB"/>만 발행하고 리더가 theme / tint 속성을 무시했습니다.
TXLSDataBarSpec 및 TXLSCfValue의 새 메서드가 슬롯을 테마 모드로 전환합니다: SetThemeColor(themeId, tint) 및 ClearThemeColor.
XLSX 라이터는 Tint가 정확히 0.0일 때 <color theme="N"/>을, 0이 아닐 때 <color theme="N" tint="0.5"/>를 발행합니다.
기본 동작은 변경되지 않았습니다: 기존 RGB 전용 진입점으로 생성된 규칙은 이전과 정확히 동일한 <color rgb="..."/>를 계속 발행합니다.
알려진 제한 사항: BIFF8(.xls) CFEX는 여전히 RGB 색상만 운반합니다; 워크북 테마 팔레트 해석은 여전히 범위 외; iconSet 규칙은 <color> 요소를 운반하지 않습니다.

버전 2.42.0

BIFF8 차트 시트 생성 API에 TXLSChartSeriesInfo 레코드 배열(Name, Categories, Values)을 받는 다섯 번째 AddChartSheet 오버로드 추가. 비어 있지 않은 각 Name은 시리즈 이름 BRAI(id=2)의 tStr PTG 토큰을 통해 리터럴 시리즈 레이블로 차트 서브스트림에 기록된다. Excel은 이 레이블을 범례와 시리즈 선택기에서 사용하므로, 다중 시리즈 차트는 이제 기본 "Series1 / Series2" 자리표시자 대신 적절한 시리즈 캡션과 함께 제공된다.
TXLSChartSeriesInfo는 TXLSChartType과 함께 lxHandle에서 재내보내기되므로, 호출자는 lxChartBuilder를 직접 임포트하지 않고도 배열을 구성할 수 있다.
이는 Roadmap #10 페이즈 2(열 차트 종단 간)의 전반부다. 시리즈 이름 경로는 연결됐다; 범주 및 값 데이터 바인딩(Categories / Values A1-range 문자열을 BRAI 내부의 실제 tArea3D 셀 범위 참조로 변환)은 여전히 자리표시자다 — 이 두 필드는 API에서 받아들이지만 아직 차트 서브스트림에 방출되지 않는다. 후속 릴리스가 수식 컴파일러와 EXTERNSHEET 참조 테이블을 통해 페이즈 2의 후반부를 마무리할 것이다.

버전 2.41.0

HotXLS에 BIFF8 차트 시트의 프로그래밍 방식 생성 기능 추가. Sheets의 새 AddChartSheet 오버로드 집합은 저장된 .xls 파일에 완전한 차트 서브스트림을 기록한다. 이전에는 차트 시트가 load-save 라운드트립에서 불투명하게만 보존될 수 있었다. 네 개의 오버로드가 일반적인 진입점을 다룬다: 이름만 / 이름 + 차트 종류 / + 제목 / + 범주 축 제목 + 값 축 제목. 반환되는 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를 종단 간 시연합니다. 세 가지 버튼으로 CondFormat12.xls(BIFF8 백엔드), CondFormat12.xlsx(XLSX 백엔드) 또는 둘 다를 나란히 생성할 수 있습니다. 각 출력 시트는 동일한 네 가지 규칙 종류 — 데이터 막대, 3색 색조, 아이콘 집합(3 화살표), 2색 색조 — 를 10개 데이터 행에 걸쳐 담아 Excel에서 열어 시각적으로 확인할 수 있습니다.
BIFF8 경로는 추가로 v2.35.0 DXF 스타일 재정의를 시연합니다: 데이터 막대 규칙은 어두운 막대 채우기 위에서도 셀 텍스트가 가독성을 유지하도록 흰색 굵은 글꼴 색상을 첨부합니다.
Tests/Delphi/HotXLS.CondFormat12Tests.pas에 새 DUnitX 테스트 픽스처가 10개의 라운드트립 및 API 표면 시나리오를 다룹니다: 네 가지 규칙 종류 모두에 대한 BIFF8 라운드트립, RGB 색상 / 테마 색상 / 글꼴 플래그에 대한 DXF Style 라운드트립, ShowOnly가 있는 데이터 막대 / 3색 색조 / 아이콘 집합에 대한 XLSX 라운드트립. 픽스처는 HotXLSDelphiTests.dpr 및 해당 .dproj에 연결되어 있습니다.
테스트 픽스처를 지원하기 위해 TCondFormat은 두 가지 새 공개 액세서를 노출합니다: RuleCount와 Rule(I).
검증 노트: 데모의 .xls 및 .xlsx를 Excel에서 열어 네 가지 CF12 / OOXML 확장 규칙이 나란히 렌더링되는 것을 확인하세요.

버전 2.39.0

조건부 서식 규칙의 차분 XF(DXF) 스타일 재정의는 이제 기존 RGB 모드 외에 테마 색상 인코딩을 지원합니다. 각 색상 슬롯 — 글꼴 색상, 채우기 배경, 채우기 전경 — 은 워크북 테마 인덱스와 tint 값에 대해 설정될 수 있습니다.
TXLSDxfStyle의 세 가지 새 메서드가 슬롯을 테마 모드로 전환합니다: SetFontColorTheme(themeId, tint), SetFillBgColorTheme(themeId, tint), SetFillFgColorTheme(themeId, tint). Tint는 [-1.0, +1.0] 범위의 single입니다. 해당 기존 SetXxxColor(rgb) 메서드는 RGB 모드를 유지합니다; 두 모드는 슬롯별로 상호 배타적입니다.
새로운 읽기 전용 속성 XxxColorIsTheme / XxxColorThemeId / XxxColorThemeTint로 활성 모드를 조회합니다. HasXxxColor는 어느 모드에서든 True를 반환합니다.
BIFF8 와이어 형식은 표준 XFProp Colour 레이아웃을 따릅니다: RGB는 xclrType=2 + 4바이트 BGR LongWord, 테마 모드는 xclrType=3 + 2바이트 부호 있는 tint × 32767 + 4바이트 테마 인덱스. DXF blob 디코더는 이 dispatch를 미러링합니다.
알려진 제한 사항: 테마 모드 라운드트립은 BIFF8(.xls) 측에서만 지원됩니다 — XLSX(.xlsx) 측은 여전히 <color rgb="..."/>만 발행하고 읽습니다.

버전 2.38.0

XLSX(.xlsx) 읽기는 이제 들어오는 파일에서 Excel 2007+ 조건부 서식 확장 규칙 — 데이터 막대, 색조(cfvo 수에서 자동 감지된 2 stop 및 3 stop), 아이콘 집합 — 을 인식하고 해당 TXLSXConditionalFormat 객체를 채워 사용자 코드가 이러한 규칙을 잃지 않고 검사 및 라운드트립할 수 있도록 합니다. 이전에는 Excel에 저장된 이러한 규칙 유형이 있는 .xlsx 워크북이 로드 시 조용히 삭제되었습니다.
리더는 OOXML <cfRule type="dataBar|colorScale|iconSet"> 외피와 내부 <dataBar> / <colorScale> / <iconSet> 본문을 파싱하고, 자식 <cfvo> 항목을 순회하여 각 임계값의 type과 val을 복구하며, <color> 항목을 순회하여 데이터 막대 색상 또는 색조 stop별 색상을 복구합니다.
아이콘 집합 규칙은 iconSet 패밀리 이름(Excel 2007 기본 17개 집합), reverse 플래그, showValue 플래그(ShowOnly에 매핑됨)를 라운드트립합니다.
OOXML rgb="AARRGGBB" 속성에서 파싱된 색상 값은 쓰기 API가 사용하는 것과 동일한 BGR LongWord 규약으로 변환되므로 load-edit-save 라운드트립이 시각적 색상을 정확하게 보존합니다.
기존 XLSX <cfRule type="cellIs"> 처리는 변경되지 않습니다; dispatch는 type 속성이 새 규칙 종류를 지정할 때만 새 경로를 선택합니다.
알려진 제한 사항: 테마 색상 참조는 0으로 읽히며 워크북 테마 팔레트에 대해 해결되지 않습니다; stop별 iconId 재정의는 캡처되지 않습니다; <cfRule>의 priority 속성은 읽기 시 무시됩니다.

버전 2.37.0

BIFF8 CFEX 레코드 형식이 이제 막대/정지점 색상만이 아니라 정지점별 전체 cfvo 배열([MS-XLS] cfvo 시맨틱에 따른 kind + 값 문자열 + 색상)을 운반합니다. 데이터 막대 규칙은 이제 min/max 임계값 종류와 값을 유지하고, 색조는 각 정지점의 kind + value + color 조합을 유지하며, 아이콘 집합은 reverse / showOnly 플래그와 함께 각 임계값의 kind + value를 유지합니다.
CFEX 쓰기는 버전 플래그 바이트(ver=1)를 추가하여 v2.34.0 최소 CFEX 레이아웃을 기대하는 이전 HotXLS 리더가 자동으로 레거시 해석으로 되돌아갈 수 있도록 합니다. v2.37.0 리더는 이전 빌드에서 생성된 ver=0 레코드도 인식합니다.
리더는 이제 동일한 범위의 혼합 CONDFMT + CONDFMT12 항목을 감지합니다 — Excel에 저장된 파일에서 일반적인 패턴. 이전 CONDFMT 항목은 TCondFormat의 새 IsShadowed 속성을 통해 표시됩니다. 저장 시 라이터는 계속 두 레코드 패밀리를 모두 발행합니다.
TCondFormat의 새 TotalRange 속성은 이전에 private이었던 병합 범위를 노출합니다.
알려진 제한 사항: 그림자 감지는 정확한 경계 상자 일치로 제한됩니다. ColorScale의 전체 cfvo 라운드트립은 8개의 표준 kind 값을 보존하지만 Excel의 테마 색상 색조 메타데이터는 보존하지 않습니다.

버전 2.36.0

XLSX(.xlsx) 출력이 이제 Excel 2007+ 확장 조건부 서식 규칙의 세 가지 종류 — 데이터 막대, 색조(2-stop 및 3-stop), 아이콘 집합 — 를 지원하여 XLSX 백엔드를 v2.34.0 BIFF8(.xls) 백엔드와 동등하게 만듭니다. TXLSXWorksheet의 네 가지 새로운 공개 메서드가 XLS API 표면을 반영합니다: AddCondFormatDataBar, AddCondFormatColorScale2, AddCondFormatColorScale3, AddCondFormatIconSet.
저장된 .xlsx 파일은 이제 각 규칙 종류에 적합한 자식 구조를 가진 OOXML <conditionalFormatting> 요소를 발행합니다: 막대는 <cfRule type="dataBar"><dataBar>, 색조는 2개 또는 3개 cfvo + color stops를 가진 <cfRule type="colorScale"><colorScale>, 아이콘 집합은 적절한 cfvo 세트를 가진 <cfRule type="iconSet"><iconSet iconSet="...">.
내장 아이콘 집합 이름 매핑은 XLS 백엔드가 지원하는 동일한 Excel 2007 기본 17개 집합을 표준 OOXML iconSet 속성 문자열로 출력합니다.
임계값 유형과 색상 값은 XLS API와 동일한 열거형과 색상 규약을 사용합니다 — 동일한 TXLSCfValueKind, 동일한 Delphi BGR LongWord 형식. 기존 XLSX 셀 값 AddConditionalFormat 호출은 계속 동일하게 동작합니다.
알려진 제한 사항: 테마 색상 인코딩은 아직 발행되지 않습니다; 아이콘 집합에서 stop별 iconId 재정의는 지원되지 않습니다. Excel에 저장된 파일에서 들어오는 데이터 막대 / 색조 / 아이콘 집합 규칙의 XLSX 읽기 측 인식은 계속 연기됩니다 — 이번 릴리스에서는 쓰기만 연결되어 있습니다.

버전 2.35.1

BIFF8 리더는 이제 CF12 규칙에 첨부된 Differential XF(DXF) 바이트를 규칙의 TXLSDxfStyle 속성 백으로 다시 디코딩하며, 원시 바이트는 DxfBlob에 그대로 유지합니다. 스타일이 적용된 데이터 막대 / 색조 / 아이콘 집합 규칙을 가진 Excel 저장 워크북을 로드하면 각 Rule.Style의 HasXxx+값 쌍을 통해 글꼴 색상, 채우기 색상, 굵게 / 기울임꼴 / 밑줄, 숫자 서식 id에 직접 액세스할 수 있습니다.
라운드트립 동작: load-edit-save 사이클은 이제 Rule.Style의 로드 후 모든 변경 사항을 반영합니다. 사용자가 워크북을 읽고 Rule.Style.SetFontColor를 변경한 다음 저장하면 새 색상이 승리합니다. 사용자가 Style을 건드리지 않으면 저장된 파일은 원본과 동일한 재정의를 운반합니다.
DXF blob의 알 수 없는 xfPropType 값은 거부되지 않고 건너뜁니다. 따라서 이번 릴리스에서 아직 인식되지 않은 속성 유형을 사용하는 새로운 Excel 파일도 계속 로드됩니다(원시 바이트는 DxfBlob에 남아 검사 또는 향후 라운드트립 지원에 사용됨).

버전 2.35.0

조건부 서식 규칙은 이제 차분 XF(DXF) 스타일 재정의를 운반할 수 있어, Excel에서 CF12 규칙이 발동될 때 셀의 기본 XF를 변경하지 않고 셀의 글꼴 색상, 채우기, 글꼴 굵기, 기울임꼴, 밑줄 또는 숫자 서식을 변경할 수 있습니다. 이 재정의는 각 TCondFormatRule의 새로운 TXLSDxfStyle 속성으로 노출되며, 기존 AddCondFormatDataBar / AddCondFormatColorScale* / AddCondFormatIconSet API로 규칙을 생성한 후 액세스할 수 있습니다.
이번 릴리스에서 지원하는 스타일 재정의: 글꼴 색상, 채우기 배경 색상, 채우기 전경 색상, 채우기 패턴, 글꼴 굵게, 글꼴 기울임꼴, 글꼴 밑줄 스타일, 내장 숫자 서식 id. 각 속성에는 짝을 이루는 HasXxx 플래그가 있으며 — SetXxx를 통해 명시적으로 설정된 속성만 BIFF8 파일로 발행됩니다.
BIFF8 라이터는 이제 규칙의 Style에 최소한 하나의 재정의가 설정되어 있을 때마다 CF12 레코드에 비어 있지 않은 DXF 블록을 추가합니다. DXF 블록은 공개 XFProp 배열 레이아웃(cxfp + 속성별 type / size / data 튜플)을 사용하여 규칙이 적용될 때 Excel이 스타일 변경 사항을 가져올 수 있도록 합니다.
BIFF8 리더는 Excel에 저장된 파일에서 원시 DXF 바이트를 규칙의 DxfBlob 속성에 보존하므로, load-edit-save 라운드트립이 CF12 규칙이 운반하는 셀 스타일을 더 이상 조용히 잃지 않습니다. 원시 바이트를 다시 TXLSDxfStyle 속성 백으로 디코딩하는 것은 후속 릴리스에 계획되어 있습니다.
스타일을 옵트인하지 않는 규칙의 기본 동작은 변경되지 않습니다 — v2.34.0과 동일하게 cbdxf = 0이 발행되므로 기존 데이터 막대 / 색조 / 아이콘 집합 규칙은 이전과 정확히 동일하게 렌더링됩니다.
알려진 제한 사항: DXF에 대한 테마 색상 인코딩은 지원되지 않습니다(RGB만); 테두리 재정의와 그라데이션 정지점은 이번 릴리스의 속성 세트에 포함되지 않습니다; XFProp 값 블롭에 대한 바이트 순서는 공개 [MS-XLS] 노트를 따르며 BiffView로 검증된 후 Excel의 완전한 round-trip 충실도를 위해 작은 조정이 필요할 수 있습니다. 세 가지 새 규칙 종류에 대한 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색 색조 / 아이콘 집합 규칙이 디스크에 보존됩니다.
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 출력은 아직 연결되지 않았습니다(기존 XLSX 셀 값 규칙은 영향받지 않음). CF12의 차분 XF 스타일 블록이 비어 있게 발행되므로 Excel이 API에서 제공한 색상이 아닌 기본 색상으로 막대와 색조를 렌더링할 수 있습니다. CFEX의 정지점별 cfvo 배열은 색상만 전달하며 종류 / 값 조합은 전달하지 않습니다. 이러한 격차는 데모 워크북 및 Excel 렌더링 검증과 함께 v2.34.x / v2.35.x 후속 릴리스에서 채워질 예정입니다.

버전 2.33.3

Demo/Delphi/XlsTables/ 아래의 새로운 XlsTables Delphi 데모는 BIFF8 Tables (ListObject) 쓰기 측을 종단 간 시연합니다. Sheet.AddTable('SalesTable', 'A1:D10', headers) 를 사용해 A1:D10 의 Table 로 바인딩된 네 열의 판매 영역 (지역 / 제품 / 분기 / 수익) 을 가진 SalesTable.xls 를 생성합니다. 생성된 .xls 를 Excel 에서 열어 열 드롭다운, 줄무늬 행 및 이름 상자의 SalesTable 구조화 참조 이름을 확인하세요.
데모는 v2.33.0 의 AddTable API 를 채택하기 위한 가장 짧은 종단 간 레시피입니다: StyleName = 'TableStyleMedium2' 및 ShowRowStripes = True 를 설정하고, 9 개의 데이터 행 + 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 은 autofilter 드롭다운을 Table 객체 자체 내에 포함시키므로, 동일한 범위에 대한 추가 시트 수준 autofilter 를 발행하면 Office File Validation 이 파일을 거부합니다. 이는 v2.29.4 에서 출시된 XLSX 측 수정과 일치합니다.
커버리지 검사는 보수적입니다: Table 의 첫/마지막 행과 첫/마지막 열이 autofilter 의 경계를 포함할 때만 Table 이 autofilter 를 "커버" 하는 것으로 간주됩니다. 부분 중첩은 시트 수준 autofilter 발행 동작을 유지합니다.
BIFF5 저장 및 Table 이 없는 워크시트는 영향을 받지 않습니다 — 억제 검사는 파일 형식이 BIFF8 이고 워크시트에 최소 하나의 Table 이 있을 때만 실행됩니다. 공개 API 변경 없음.

버전 2.33.1

BIFF8 (.xls) 읽기 측에서 이제 v2.33.0 이 쓰기 측에 추가한 공유 기능 Tables 레코드를 인식합니다. Excel (또는 HotXLS 자체) 에서 저장된 하나 이상의 ListObjects/Tables 가 포함된 .xls 를 열면, 워크시트의 Tables 컬렉션이 파싱된 각 FEAT11 ($0872) 마다 TXLSTable 로 채워집니다: 기본 Ref8U 에서 테이블 범위를 재구성하고, 존재하는 경우 테이블 ID, 이름, 표시 이름을 복원하며, 쌍을 이루는 LIST12 ($0877) 레코드에서 테이블 스타일 이름을 채웁니다. 이전에는 이러한 레코드가 조용히 무시되었습니다.
공유된 FEATHEADR ($0867) opcode 가 이제 항상 보호 파서로 가는 대신 Isf 필드에 따라 디스패치됩니다. Isf=2 (향상된 보호) 는 기존 동작을 유지하고; Isf=4 (SharedList) 는 시트의 Tables 마커로 인식되며; Isf=3 (SmartTags) 및 기타 값은 안전하게 무시됩니다. FEATHEADR11 ($0871) 도 Tables 마커로 조용히 인식됩니다.
리더는 최선을 다하고 관대합니다: 잘못된 형식이거나 Excel 변형 FEAT11 페이로드는 적어도 올바른 셀 범위를 갖는 Table 로 우아하게 저하됩니다. 시트 보호 라운드 트립은 변경되지 않았습니다.

버전 2.33.0

BIFF8 (.xls) 워크시트가 이제 Table 객체 (Excel ListObject) 를 지원합니다. IXLSWorksheet 에서 Worksheet.AddTable(Name, Range, Columns) 을 호출하여 명명된 Table 영역을 셀 범위에 연결하세요 — 예: 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 저장은 영향받지 않습니다.
Table 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 리더는 열 때 비밀번호를 요청하고 잘못된 경우 접근을 거부합니다. 이전에는 쓰기 측에서 비밀번호 setter가 조용히 무시되었습니다.
쓰기 경로는 워크북 BOF 직후에 BIFF8 FILEPASS 레코드($002F)를 출력하고, 읽기 측과 동일한 RC4 알고리즘(vMajor=1, vMinor=1, Excel의 "Office 97/2000 호환" 암호화)으로 이후 모든 레코드 본문을 암호화합니다. 16바이트 Salt 및 Verifier는 Pascal Random이 아닌 Windows CryptGenRandom으로 생성됩니다. 1024바이트 경계마다의 블록 키 재유도가 보존됩니다.
암호화는 BIFF8(xlExcel97) 저장 경로에만 적용됩니다. BIFF5 경로는 평문 상태를 유지합니다. EncryptionPassword가 비어 있으면 기존 평문 출력 동작이 유지되며(기본값) setter를 호출하지 않는 기존 애플리케이션은 영향을 받지 않습니다.
읽기 측: ParseFilePass의 잠재적 버그를 수정했습니다. FILEPASS 직후의 첫 번째 레코드 본문(일반적으로 CODEPAGE)이 평문으로 처리되던 문제입니다. 이제 HotXLS가 작성한 암호화 파일이 HotXLS 자체에서 올바르게 라운드트립됩니다.
보안 참고: 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 데모의 네 번째 컴파일 오류 유형을 수정했습니다: 인터페이스 스마트 포인터에 ->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 컴파일러에서 오류 없이 빌드됩니다. 세 가지 유형의 컴파일 오류를 수정했습니다: 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은 항상 이 셋을 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 내보내기 워크플로용 선택적 unit cxGridAddExcel을 추가했습니다. 의도적으로 기본 패키지에 포함되지 않으므로 DevExpress 없이 설치하더라도 깨끗하게 빌드됩니다.
워크북을 Excel에서 열었을 때 차트가 비어 보이는 XLSX 차트 시트 렌더링을 수정했습니다 (새로 연 차트 시트는 오른쪽 상단에 3개의 차트 컨텍스트 아이콘을 잠시 표시한 다음 삭제하여 시트를 비워 둡니다). 차트 시트 그림은 이제 cx=0/cy=0인 <xdr:twoCellAnchor> 대신 명시적 범위(~10in × 7.2in = 9525000 × 6858000 EMU)를 갖는 <xdr:absoluteAnchor>를 사용합니다. 차트 시트에는 twoCellAnchor를 해결할 셀 그리드가 없으므로 Excel은 크기가 0인 내부 xfrm으로 폴백하여 차트를 0픽셀로 렌더링했습니다. ECMA-376-1 14.2.3.2에 따라 차트 시트 그림은 absoluteAnchor를 사용해야 합니다. 워크시트 차트 앵커는 변경되지 않습니다.

버전 2.29.4

시트 레벨 autoFilter와 Table이 동일한 범위를 커버하는 워크북 (예: MemoryDataExport 데모의 XlsxFeatureGallery.xlsx Details 시트, AddTable('SalesTable', 'A1:F9', ...) 다음에 SetAutoFilter('A1:F9')를 호출)에서 Excel 복구 프롬프트 "<file>.xlsx의 일부 콘텐츠에 문제가 있습니다"를 일으키는 XLSX 패키징 버그를 수정했습니다. OOXML은 동일한 범위에 두 개의 필터 메커니즘을 금지합니다; 라이터는 이제 시트 레벨 <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이 <c s="N"/>가 styles.xml cellXf를 참조하는 셀을 읽었을 때, N을 직접 cell.FormatIndex에 저장했습니다. SaveAs에서는 cellXfs가 워크북 스타일 풀에서 재구축되며 (선택적 복합 항목 포함), 동일한 숫자 인덱스의 새 레이아웃 슬롯은 거의 동일한 의미를 가지지 않습니다; 다시 저장된 셀은 잘못된 cellXf를 가리키거나 -- 또는 새 cellXfs 테이블의 끝을 넘어 -- Excel은 "Office에서 이 파일에 문제가 감지되었습니다. 복구를 시도할 수 있습니다"라고 보고했습니다. ApplyStyle는 이제 cellStyle을 ParseStylesXml이 이미 채우는 CellXfXxxMap 테이블을 통해 FontIndex / FillIndex / BorderIndex / NumberFormatIndex / AlignmentIndex / ProtectionIndex로 역매핑하므로 round-trip은 새로 구축된 cellXfs에 대해 셀을 재 emit합니다.

버전 2.29.1

ApiTour 데모가 노출한 두 가지 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-키 클래스를 `TXLSKeyList` / `TXLSKeyEntry` / `TXLSKeyArray`에서 `TXLSStringKeyList` / `TXLSStringKeyEntry` / `TXLSStringKeyArray`로 이름을 바꾸어, unit 이름이 메인 클래스 `TXLSObjectKeyList`와 일치하고 두 key-list 세대가 자체 설명적이 되도록 했습니다 (`TXLSStringKey*`는 레거시 WideString-키 풀, `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 x 기본 활성 시트 / 명시적 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? 유니코드 이스케이프를 사용하여 인코딩되며, 이는 전체 BMP 범위를 지원합니다. 병합된 셀은 확장되지 않으며, 원본 셀에는 내용이 포함되고 범위 내의 다른 셀은 빈 셀로 출력됩니다. 기본 SheetIndex는 활성 시트를 작성하며, 범위를 벗어난 경우 -1을 반환합니다. 빈 시트는 최소한의 유효한 RTF 문서를 생성합니다.

버전 2.27.0

TXLSXWorkbook에서 HTML 내보내기를 추가했습니다. 새로운 SaveAsHTML 함수 오버로드(FileName / Stream x 기본 활성 시트 / 명시적 SheetIndex)는 선택된 시트를 UTF-8 BOM을 포함하는 UTF-8 HTML 문서로 작성합니다. 출력은 최소 HTML 페이지 내의 단일 <table> 태그입니다. 병합된 셀은 colspan / rowspan 속성으로 표현됩니다. 셀 스타일은 인라인 CSS로 출력되며, 여기에는 글꼴 패밀리, 크기 (pt), 굵게 표시 (font-weight:bold), 기울임꼴 (font-style:italic), 밑줄 (text-decoration:line-through) 및 명시적 글꼴 색상이 포함됩니다. 솔리드 패턴 채우기는 배경색으로 사용되며, 가로 정렬 (왼쪽 / 중앙 / 오른쪽 / 정렬) 및 텍스트 줄 바꿈 (white-space:pre-wrap)도 포함됩니다. 날짜 값은 'yyyy-mm-dd hh:nn:ss' 형식으로 표시되며, 서식 있는 텍스트 셀은 연결된 텍스트로 변환됩니다. 테마 색상은 조용히 건너뜁니다 (간단한 HTML 내보내기에서는 theme1.xml 파일을 사용하지 않습니다). 기본 SheetIndex는 활성 시트를 작성하며, 범위를 벗어난 경우 -1을 반환합니다.

버전 2.26.0

TXLSXFont, TXLSXFill 및 TXLSXBorderEdge에 테마 색상, 인덱스 색상 및 음영/명암 지원을 추가했습니다. 각 색상 슬롯은 기존 RGB 색상 외에 세 개의 새 필드를 포함합니다. 필드는 다음과 같습니다. ColorTheme(정수, -1 = 설정되지 않음, 0..11 = OOXML 테마 슬롯), ColorIndex(정수, -1 = 설정되지 않음, 0..63 = OOXML 레거시 팔레트 슬롯 - Workbook.IndexedColor[N] 및 XlsxDefaultIndexedPalette와 쌍을 이룹니다.), TintAndShade([-1.0, 1.0] 범위의 실수; 테마 색상인 경우에만 출력됨). TXLSXFill은 모든 세 가지 색상에 대한 Foreground/Background 변형을 제공합니다. Writer 우선순위는 다음과 같습니다. 테마 > 인덱스 > RGB. 이전의 "ColorIsAuto = True" 방식은 해당 요소를 완전히 숨깁니다. SaveAs 및 Open 기능은 글꼴/채우기/테두리 색상에 대한 전체 <color theme="N" tint="..."/> 및 <color indexed="N"/> 속성 세트를 왕복합니다. 내부 관리: TXLSXBorders.LookupOrAdd는 이제 세 개의 새 필드를 모두 비교하여 테마 색상 테두리가 색상 풀에 있는 RGB 색상 항목과 충돌하지 않도록 합니다.

버전 2.25.0

TXLSXWorkbook에서 외부 워크북 링크 왕복 기능을 추가했습니다. 새 유형: TXLSXExternalLink(대상 URL + 시트 이름 목록) + TXLSXExternalLinks 컬렉션. TXLSXWorkbook.ExternalLinks 속성은 컬렉션을 노출하며, Add(Target)은 새 링크를 추가하고 호출자가 채우도록 반환합니다. SaveAs는 xl/workbook.xml에 워크북 수준의 <externalReferences> 블록을 출력하고, xl/_rels/workbook.xml.rels에 externalLink rel을 출력합니다(기존 rid 범위를 유지하기 위해 마지막에 위치). 또한 각 항목에 대해 xl/externalLinks/externalLink{N}.xml 파일과 해당 .rels 파일을 출력합니다. .rels 파일은 원격 워크북 URL을 TargetMode="External"과 함께 가리키며, ContentType Overrides도 포함합니다. Open은 인덱스 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) (기본값은 불투명한 검정색) 함수는 범위 내의 각 셀에 대해 호출되며, 각 셀의 위치에 따라 가장자리 마스크를 계산합니다(모서리 셀은 두 개의 외부 가장자리, 가장자리 셀은 하나의 가장자리, 내부 셀은 내부 그리드 라인). 스타일과 색상을 셀의 현재 가장자리에 복사하여 적용합니다(따라서 Outline + Inside 호출은 덮어쓰는 대신 누적됩니다). 그런 다음 Workbook.Borders에서 lookup-or-add 작업을 수행하고 결과적으로 생성된 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(일반적으로 TSV의 경우 탭 #9)를 허용합니다. 필드 따옴표는 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 = 팔레트가 기본값으로 출력). 새로운 XlsxDefaultIndexedPalette 상수는 OOXML 레거시 ECMA-376 팔레트를 0..63 슬롯에 노출합니다. SaveAs는 최소한 하나의 슬롯이 재정의된 경우에만 <colors><indexedColors>와 함께 모든 64개의 <rgbColor> 자식을 출력합니다. 변경되지 않은 슬롯은 기본 팔레트로 되돌아가므로, 변경 없이 다시 저장된 파일은 깨끗하게 유지됩니다. Open은 블록을 구문 분석하고 기본값과 일치하는 슬롯을 자동으로 삭제하여 최소한의 변경으로 원본 파일을 유지합니다. 범위를 벗어난 슬롯 할당(0보다 작거나 63보다 큰 값)은 예외를 발생시키지 않고 무시됩니다.

버전 2.21.0

TXLSXWorksheet 클래스에 시트 보기 표시 속성 6가지 추가: Zoom: 정수 값으로 Excel 상태 표시줄에 표시되는 확대/축소 비율 (10~400, 기본값 100; 범위를 벗어난 값은 쓰기 시 제한). DisplayGridLines / DisplayZeros: 부울 값 (기본값 True)으로 셀 그리드 선을 숨기거나 0 값을 가진 셀을 비워 표시할지 여부. DisplayRightToLeft: 부울 값 (기본값 False)으로 아랍어/히브리어 등을 위한 오른쪽에서 왼쪽 레이아웃으로 시트 방향을 변경. StandardWidth / StandardHeight: 실수 값으로 기본 열 너비 (Excel 문자 단위) / 기본 행 높이 (포인트) 설정; 0은 설정되지 않음을 의미하며, 이 경우 Excel의 기본값 8.43 / 15가 적용됩니다. SaveAs는 값이 Excel 기본값과 다를 경우에만 <sheetView showGridLines / showZeros / rightToLeft / zoomScale> 및 <sheetFormatPr defaultColWidth / defaultRowHeight>를 출력하고, Open은 이를 다시 파싱합니다. 기존의 freeze-pane + tab-selected 처리 방식은 <sheetView>에서 동일하며, 이제 단일 출력기로 공유됩니다.

버전 2.20.7

TXLSXWorkbook 클래스에 TStream 오버로드를 추가하여 메모리 내 직렬화를 지원합니다. 새로운 진입점: SaveAs(Stream: TStream) / SaveAs(Stream: TStream; FileFormat: TXLSXFileFormat)은 .xlsx 패키지 전체를 지정된 스트림에 현재 위치부터 씁니다. Open(Stream: TStream)은 스트림에서 데이터를 읽어옵니다. 호출자는 스트림을 소유하며, 스트림을 해제해야 합니다. HTTP 응답, 블롭 저장소, 메모리 파이프라인 및 로컬 파일 시스템을 우회하는 단위 테스트에 유용합니다. 기존의 파일 기반 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에 다섯 가지 추가 글꼴 속성을 추가했습니다. 새로운 TXLSXFontVertAlign 열거형(xlsxVertAlignBaseline / Superscript / Subscript)이 기존 Excel의 "Superscript" / "Subscript" 글꼴 확인란을 단일 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는 <font> 내부에 해당하는 <vertAlign> / <outline/> / <shadow/> / <family> / <charset> 자식 요소를 생성하며, 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는 설정된 경우 xl/workbook.xml에 <workbookPr date1904="1"/>을 생성하며, 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 및 인덱스 RowBreaks(Index) / ColBreaks(Index)는 반복을 위한 1 기반 "Before" 인덱스를 노출합니다. SaveAs는 <headerFooter>와 <drawing> 사이에 <rowBreaks> / <colBreaks>를 <brk id="N-1" max="..." man="1"/> 자식 요소와 함께 생성합니다. Open은 이를 파싱하여 다시 적용합니다.

버전 2.20.0

TXLSXWorkbook / TXLSXSheets / TXLSXWorksheet에 시트 가시성(Hidden / VeryHidden), 시트 선택 및 활성 시트 추적 기능이 추가되었습니다. 새로운 유형: TXLSXSheetVisibility 열거형(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> 기능을 완벽하게 지원하기 위해 BlackAndWhite (흑백 렌더링), Draft (미리보기 속도를 높이기 위해 그래픽을 숨김), PrintNotes (셀 주석을 숨기지 않고 표시), PrintOverThenDown (기본값인 위에서 아래로 순회하는 대신 왼쪽에서 오른쪽으로 행을 먼저 순회)의 네 가지 PageSetup 속성 토글을 추가했습니다. SaveAs는 해당 blackAndWhite / draft / cellComments / pageOrder 속성을 출력하고, Open은 이를 다시 파싱합니다. 기본값은 꺼짐으로 유지되어 변경되지 않은 워크시트에 불필요한 속성이 추가되지 않습니다.

버전 2.19.1

TXLSXWorksheet에 헤더 및 푸터 설정을 간편하게 사용할 수 있는 속성을 추가했습니다. 새로운 속성: LeftHeader / CenterHeader / RightHeader 및 LeftFooter / CenterFooter / RightFooter. 각 속성은 기존 HeaderText / FooterText 문자열의 해당 &L / &C / &R 부분을 읽거나 씁니다. 어느 한 부분을 쓰면 전체 문자열이 다시 생성되므로, 쓰기 및 읽기 기능이 변경 없이 유지됩니다.
시트 수준의 페이지 출력 옵션을 위한 토글을 추가했습니다. 새로운 TXLSXWorksheet 속성: CenterHorizontally, CenterVertically, PrintGridlines, PrintHeadings. 네 가지 옵션 중 하나라도 활성화되면 SaveAs는 <printOptions horizontalCentered / verticalCentered / gridLines / headings/> 요소를 출력하고, Open은 동일한 속성을 파싱합니다. 기본값은 꺼짐으로 유지되어 변경되지 않은 워크시트에 불필요한 <printOptions/> 요소가 추가되지 않습니다.
각 시트별 PrintArea, PrintTitleRows 및 PrintTitleCols 값을 저장하고 불러오는 기능을 추가했습니다. 이 기능은 OOXML에서 정의된 workbook 수준의 _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 테이블의 각 항목에 대한 범위 문자열(범위가 완전히 잘린 영역 내에 있는 항목은 제거됨)이 포함됩니다.
지원 컬렉션에 새로운 Delete(Index) 멤버가 추가되어, Clear 명령 없이도 단일 항목을 제거할 수 있도록 했습니다. (TXLSXHyperlinks, TXLSXComments, TXLSXConditionalFormats, TXLSXDataValidations, TXLSXTables).
이번 릴리스의 범위를 벗어나는 항목: 이미지 및 차트는 이동되지 않습니다 (EMU 픽셀 고정은 셀 그리드와 분리되어, 정확한 이동을 위해서는 EMU 오프셋을 다시 계산해야 함). 워크북 수준의 정의된 이름(DefinedNames) 공식은 다시 작성되지 않습니다. 이 두 가지 항목은 추후 릴리스에서 다루어질 예정입니다.

버전 2.18.2

열 너비 및 행 높이에 대한 AutoFit 기능을 추가했습니다. TXLSXWorksheet는 AutoFitColumn(ACol) / AutoFitColumns(ColMin, ColMax) 및 AutoFitRow(ARow) / AutoFitRows(RowMin, RowMax)를 노출하며, TXLSXRange는 AutoFitColumns 및 AutoFitRows를 노출하여, 범위의 경계를 기준으로 워크시트로 전달합니다. 너비는 Excel 문자 단위(Calibri 11pt 기본 글꼴; ASCII 문자는 1, CJK 문자는 2로 계산)로 추정되며, 1.20 픽셀/문자 보정 및 1.0의 패딩이 적용됩니다. 값은 [8.43, 255.0] 범위로 제한됩니다. 행 높이는 기본적으로 15pt이며, 셀 텍스트 내의 각 줄 바꿈마다 12.75pt씩 증가합니다. 넓은 범위(EntireRow / EntireColumn)는 워크시트의 마지막 데이터가 있는 행/열로 제한되어, AutoFit이 Excel 그리드의 제한까지 반복하지 않도록 합니다.

버전 2.18.1

XLSX 엔진에 셀 보호 기능을 추가했습니다. TXLSXCell은 Excel의 셀 보호 모델을 반영하는 새로운 Boolean 속성 Locked (기본값: True) 및 FormulaHidden (기본값: False)을 제공합니다. 이 속성은 셀 보호 인덱스 TXLSXCell.ProtectionIndex (새로운 워크북 수준의 TXLSXProtections 풀에서 1부터 시작)를 노출합니다. 편의 속성을 설정하면, 풀에서 (Locked, FormulaHidden) 쌍을 찾거나 추가합니다. 기본값(Locked=True, FormulaHidden=False)은 ProtectionIndex=0으로 설정되어, 일반 셀의 경우 풀이 비어 있도록 합니다.
TXLSXRange 객체에 TXLSXRange.SetLocked(ALocked) 및 TXLSXRange.SetFormulaHidden(AHidden) 배치 도우미를 추가하여 전체 범위를 잠금 해제하거나 수식을 숨기는 작업을 한 번의 풀 조회 또는 추가 작업으로 수행하고 결과를 사각형의 모든 셀에 적용합니다.
해당 쓰기/읽기 기능을 추가했습니다. SaveAs는 워크북 보호 항목마다 하나의 cellXf를 생성하며, 이 cellXf에는 인라인 <protection locked="N" hidden="M"/> 자식 요소가 포함됩니다(정렬 블록 이후). Open은 <protection> 요소를 Workbook.Protections으로 다시 파싱하고, ParseStylesXml 및 ParseWorksheetXml을 통해 새로운 CellXfProtMap을 전달하여 각 셀의 보호 인덱스가 기존 글꼴/채우기/테두리/숫자 형식/정렬 인덱스와 함께 정상적으로 왕복되도록 합니다.

버전 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.NumberFormat에 WideString 편의 기능을 추가했습니다. 이 기능은 기존 NumberFormatIndex와 함께 사용됩니다. 읽기 작업 시에는 워크북 풀에서 형식 문자열을 가져오고, 쓰기 작업 시에는 문자열을 조회하거나 추가하고 NumberFormatIndex를 투명하게 업데이트합니다. 이 기능은 셀이 워크북에 연결되어 있어야 합니다(일반적인 흐름은 TXLSXWorkbook.Sheets.Add(...).Cells[r, c]를 통해 이루어집니다).
셀에서 워크시트 및 워크북으로의 역참조를 추가하여, 각 TXLSXCell이 외부 관리 없이 소유 워크북을 확인할 수 있도록 했습니다. TXLSXSheets, TXLSXWorksheet 및 TXLSXCells는 내부 Owner 참조를 추가했으며, 이는 생성자에서 설정됩니다. TXLSXCell은 읽기 전용 Workbook 속성을 제공하며, TXLSXCells.GetItem이 접근 시 셀을 자동으로 생성할 때 사용하는 내부 SetWorkbook 함수를 제공합니다.

버전 2.17.42

XLSX 파일 열기 시 셀 데이터가 손실되는 문제를 해결했습니다. SaveAs를 사용하여 저장된 파일에서 Open을 수행할 때, 일부 셀이 삭제되어 HasCell(row, col)이 False를 반환하고, 셀의 모든 정보(값, 수식, 글꼴 인덱스, 채우기 인덱스, 테두리 인덱스, 숫자 형식 인덱스)가 손실되었습니다. 원인은 워크시트 파서에서 불필요한 MoveToAttribute('r') 호출로 인해 리더의 노드 유형이 속성으로 변경되어, IsEmptyElement 검사가 항상 True를 반환하고 <c> 요소의 셀 파싱을 중단시키는 것이었습니다. 불필요한 커서 이동을 제거하여 텍스트, 숫자, 수식 및 날짜 셀의 데이터를 정상적으로 복원합니다.
XLSX 파일 열기 시 스타일 인덱스가 올바르게 복원되지 않는 문제를 해결했습니다. 셀에 정의된 사용자 정의 글꼴, 채우기, 테두리 및 숫자 형식 인덱스가 올바르게 복원되지 않고 0으로 표시되는 문제가 있었습니다. cellXf 파서는 위치를 카운터로 추적했지만, </xf> 종료 태그에서만 카운터가 증가했습니다. Excel은 종종 내부 정렬이 없는 자체 닫는 <xf .../> 항목을 생성하므로 카운터가 0을 넘지 않아 모든 cellXf 매핑이 이전 값을 덮어썼습니다. 이제 파서는 자체 닫는 <xf/>에서도 카운터를 증가시켜 각 셀의 글꼴 인덱스/채우기 인덱스/테두리 인덱스/숫자 형식 인덱스를 올바르게 복원합니다.
XLSX 파일의 날짜 셀 데이터가 올바르게 복원되지 않는 문제를 해결했습니다. TDateTime 값을 TXLSXCell.Value에 저장할 때, 공유 문자열 풀을 통해 저장되어 t="s"로 표시되었습니다. SaveAs는 이제 날짜 시리얼 번호를 <v> 태그에 직접 쓰고 날짜 cellXf를 적용하여, 날짜 셀이 열릴 때 TDateTime 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] 부울 속성, 그리고 SetRowCollapsed / SetColCollapsed / ClearRowCollapsed / ClearColCollapsed 헬퍼 함수를 노출합니다. SaveAs는 해당 <row> 및 <col> 항목에 collapsed="1" 속성을 출력합니다. Open은 이 속성을 파싱하여 워크시트에 적용하므로, 행/열 접기 계층 구조가 완벽하게 유지됩니다.

버전 2.17.38

XLSX 엔진에 숨겨진 행/열의 양방향 지원을 추가했습니다. TXLSXWorksheet는 RowHidden[Row] 및 ColHidden[Col] 부울 속성, 그리고 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(1부터 시작)를 포함하며, 이는 Workbook.Alignments 내에서의 인덱스를 나타냅니다. SaveAs 기능은 각 워크북 정렬 항목에 대해 하나의 cellXf와 인라인 <alignment/> 자식 요소를 추가합니다. 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 파이프라인은 아직 구현되지 않았으며, 실제로 암호화된 아카이브의 읽기 및 쓰기 작업은 모두 해당 예외를 발생시킵니다. 예외 유형은 기존 호출자가 이를 포착하고 Worksheet.Protect / Workbook.ProtectWorkbook를 사용하여 시각적 잠금 기능을 사용하도록 설계되었습니다.

버전 2.17.34

성능: 각 워크시트의 셀 행을 생성하는 O(N^2) WideString 연결을 TXLSWideStringBuilder로 대체했습니다. 대규모 시트(10,000개 이상의 셀)의 경우, SaveAs 기능에서 메모리와 CPU 사용량이 선형적으로 유지됩니다. 새로운 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) (잘라내기 및 붙여넣기)를 제공합니다. 각 작업은 셀 값, 수식, 네 가지 스타일 인덱스 및 모든 서식 텍스트를 복제합니다. MoveRange는 대상 영역과의 중복을 건너뛰므로 부분 중복 영역은 복사된 값을 유지합니다. TXLSXCells는 Remove(Row, Col) 도우미 기능을 추가했습니다.

버전 2.17.32

XLSX 엔진에 내부 하이퍼링크 앵커를 추가했습니다. TXLSXHyperlink는 이제 Location 속성(예: "Sheet2!A1")과 IsInternal 도우미 기능을 갖습니다. TXLSXHyperlinks는 AddInternal을 제공하며, TXLSXWorksheet는 AddHyperlinkToCell의 세 가지 오버로드를 추가했습니다. SaveAs는 inline location="" 속성을 가진 내부 하이퍼링크를 생성하고 워크시트 rels 항목을 건너니다. Open은 location="" 하이퍼링크를 인식하고 AddInternal을 통해 처리합니다. 외부 URL 하이퍼링크는 rels 파일에서 변경되지 않고 그대로 유지됩니다.

버전 2.17.31

XLSX 엔진에 서식 텍스트의 양방향 지원을 추가했습니다. 새로운 TXLSXRichTextRun 클래스(각 런에 대한 이름/크기/굵게/이체/취소선/밑줄/색상)와 TXLSXRichText 컨테이너를 추가했습니다. TXLSXRichText는 AddRun/AddRunText/Clear/PlainText를 제공합니다. TXLSXCell은 이제 RichText 속성을 가집니다. SaveAs는 셀을 공유 문자열로 저장하며, 여러 <r>/<rPr>/<t> 런을 사용합니다. Open은 파싱된 SST 항목에서 TXLSXRichText를 재구성하며, 셀의 Variant 값은 서식을 무시하는 호출자에게는 연결된 일반 텍스트를 제공합니다.

버전 2.17.30

XLSX 엔진에 차트의 양방향 지원을 추가했습니다. 새로운 TXLSXChartType 열거형(column/bar/line/pie), 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

TStringList 필드에서 발생하는 "정렬된 목록에서 허용되지 않는 작업" 오류(EListError)를 수정했습니다. SetColWidth, SetRowHeight, SetRowOutlineLevel 및 SetColOutlineLevel 함수에서 사용되는 네 개의 TStringList 필드는 Sorted=True로 생성되었지만, Values[Name] := X 설정자를 통해 값이 쓰여졌는데, 이는 RAD Studio의 RTL에서 정렬된 목록에서 허용되지 않습니다. 이제 목록은 정렬되지 않은 상태로 생성되며, 조회는 IndexOfName을 통해 계속 수행되는데, 이는 일반적인 시트별 열/행 수에서는 문제가 되지 않습니다.

버전 2.17.28

TZipArchive.Exists 함수를 수정했습니다. 이 함수는 항상 false를 반환하는 임시 함수였습니다. XLSX Open 경로는 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은 ProtectWorkbook (선택적으로 비밀번호, LockStructure, LockWindows 플래그 사용 가능) 및 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

TXLSX 엔진에 엑셀 스타일의 테이블 왕복 기능을 추가했습니다. 새로운 TXLSXTable 클래스(Id, Name, DisplayName, Range, Columns, StyleName, ShowFirstColumn / ShowLastColumn / ShowRowStripes / ShowColumnStripes)와 각 워크시트에 대한 TXLSXTables 컬렉션을 추가했습니다. TXLSXWorksheet는 Tables 속성과 AddTable(Name, Range, ColumnNames) 메서드를 제공합니다. SaveAs는 xl/tables/tableN.xml 파일을 생성합니다(워크북 전체 번호), 워크시트 관계를 업데이트하여 테이블 관계를 설정하고, 워크시트에 <tableParts>를 추가하며, 테이블 콘텐츠 유형을 등록합니다. Open은 테이블 관계와 tableN.xml 파일을 워크시트로 다시 파싱하여 스타일이 적용된 테이블이 저장 후 다시 열 때 유지되도록 합니다.

버전 2.17.23

TXLSX 엔진에 자동 필터 왕복 기능을 추가했습니다. TXLSXWorksheet는 AutoFilterRange 속성과 SetAutoFilter(Row1, Col1, Row2, Col2) / SetAutoFilter(Range) / ClearAutoFilter 도우미 메서드를 제공합니다. SaveAs는 범위가 비어 있지 않은 경우 병합 셀 블록 다음에 <autoFilter ref="...">를 생성합니다. Open은 ref 속성을 해당 속성으로 다시 파싱하여 워크시트의 필터 영역이 저장 후 다시 열 때 유지되도록 합니다.

버전 2.17.22

TXLSX 엔진에 페이지 설정 왕복 기능을 추가했습니다. 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

TXLSX 엔진에 고정 셀 왕복 기능을 추가했습니다. TXLSXWorksheet는 FreezePane(Col, Row) / UnfreezePane 메서드와 읽기 전용 FreezeCol 및 FreezeRow 속성을 제공합니다. SaveAs는 <sheetData> 앞에 <sheetViews>/<pane state="frozen"> 블록을 작성하여 활성 셀과 선택 영역을 일치시킵니다. Open은 <pane state="frozen">을 해당 고정 위치로 다시 파싱하여 고정된 상단/왼쪽/모서리 레이아웃이 저장 후 다시 열 때 유지되도록 합니다.

버전 2.17.20

TXLSX 엔진에 행 및 열 개요(그룹화) 레벨을 추가했습니다. 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 이상인 항목은 localSheetId 속성을 가지며(시트 범위), SheetIndex가 -1인 항목은 워크북 범위입니다. Open은 <definedName> 요소를 컬렉션으로 파싱하여 저장하고 다시 열린 워크북에서 정의된 이름 범위를 유지합니다.

버전 2.17.17

XLSX 엔진에 이미지 기능을 추가했습니다. 새로운 TXLSXImageFormat 열거형(png, jpeg, gif, bmp), TXLSXImage 클래스(Row/Col anchor, WidthEMU/HeightEMU, Format, Data)와 각 워크시트에 있는 TXLSXImages 컬렉션을 추가했습니다. TXLSXWorksheet는 Images 컬렉션과 함께 AddImage(Row, Col, Data, Format) 및 AddImageFromFile(Row, Col, FileName) 도우미 기능을 제공합니다. SaveAs는 이미지 바이트를 xl/media/imageN.<ext>에 저장하고, xl/drawings/drawingN.xml을 생성합니다(각 이미지에 대해 하나의 oneCellAnchor 포함). 또한 매칭되는 _rels 파일을 생성하고, 콘텐츠 유형 및 워크시트/드로잉 관계를 등록하고, 워크시트에 <drawing r:id="..."/> 참조를 생성합니다. Open은 drawingN.xml, drawing rels 및 media를 파싱하여 이미지를 Worksheet.Images 컬렉션으로 다시 가져옵니다.

버전 2.17.16

XLSX 엔진에 사용자 정의 숫자 형식의 양방향 변환 기능을 추가했습니다. 새로운 TXLSXNumberFormat 클래스와 워크북 레벨의 TXLSXNumberFormats 컬렉션(Workbook.NumberFormats)을 도입하여 중복된 형식 코드를 Add(FormatCode)를 통해 제거합니다. TXLSXCell은 새로운 NumberFormatIndex 속성을 제공하며, SaveAs는 xl/styles.xml에 <numFmts> 블록을 생성합니다 (사용자 정의 ID는 OOXML에서 예약된 기본값 164부터 시작). Open은 사용자 정의 numFmts를 파싱하고 cellXf->numFmtId 매핑을 NumberFormatIndex로 변환합니다. 충돌 시 우선순위는 FormatIndex > FontIndex > FillIndex > BorderIndex > NumberFormatIndex입니다.

버전 2.17.15

XLSX 엔진에 셀 테두리 양방향 변환 기능을 추가했습니다. 새로운 TXLSXBorderStyle 열거형, TXLSXBorderEdge 클래스(각 면에 대해 Style + Color + ColorIsAuto), TXLSXBorder 클래스(왼쪽/오른쪽/위쪽/아래쪽/대각선 가장자리) 및 SetAll(Style[, Color]) 헬퍼 함수를 도입했습니다. 워크북 레벨의 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로 변환합니다. 폰트 인덱스는 여전히 두 항목이 모두 설정된 경우 우선순위를 갖습니다.

버전 2.17.13

XLSX 폰트 양방향 변환을 완료했습니다. Open은 이제 xl/styles.xml을 Workbook.Fonts 및 cellXf->fontId 테이블로 파싱합니다. 각 셀의 s 속성은 TXLSXCell.FontIndex로 매핑되어 저장하고 다시 열 때 사용자 정의 폰트(이름, 크기, 굵게, 기울임꼴, 밑줄, 취소선, 색상)가 유지됩니다.

버전 2.17.12

TXLSXFont 클래스와 Workbook.Fonts 컬렉션을 추가하여 XLSX 셀이 사용자 정의 폰트를 선택할 수 있도록 했습니다. TXLSXCell은 새로운 FontIndex 속성을 갖습니다. SaveAs는 폰트 목록을 xl/styles.xml에 생성하고 각 폰트에 대해 하나의 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은 주석N.xml 파일을 컬렉션으로 다시 읽어옵니다. 워크시트 관계, 콘텐츠 유형 및 <legacyDrawing> 연결은 자동으로 처리됩니다.

버전 2.17.8

XLSX 엔진에 하이퍼링크 양방향 지원을 추가했습니다. TXLSXWorksheet는 Hyperlinks 컬렉션 및 AddHyperlink(Row, Col, Url[, Display[, Tooltip]]) 오버로드를 제공합니다. SaveAs는 각 워크시트에 <hyperlinks> 블록을 작성하고 외부 URL 대상을 포함하는 해당 xl/worksheets/_rels/sheetN.xml.rels 파일을 생성합니다. Open은 먼저 워크시트 관계를 읽어 <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 시리얼 번호로 직렬화되고 내장된 날짜 cellXf 태그가 추가되어 Excel에서 날짜로 렌더링됩니다. 열 때, 스타일이 날짜 cellXf를 참조하는 셀은 TDateTime 변형으로 다시 디코딩됩니다. TXLSXCell은 새로운 Formula 속성을 제공합니다. SaveAs는 수식을 <f> 자식 요소로 작성하고, Open은 <f> 텍스트를 셀로 다시 파싱합니다.

버전 2.17.5

XLSX 엔진에 styles.xml 스캐폴드를 추가했습니다. SaveAs는 기본 글꼴, 채우기, 테두리, cellStyleXfs 및 cellXfs 항목이 포함된 최소 유효한 xl/styles.xml을 생성하며, 관련 content-type 및 workbook-relationship 등록도 수행합니다. 셀에는 FormatIndex 속성이 포함되어 있으며, 값이 0이 아니면 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 facade의 IXLSCells / IXLSRange 구조와 일치합니다. Worksheet.Cells.HasCell / Cells.Count / Cells.CellByIndex / Cells.Clear도 사용할 수 있습니다.

버전 2.17.2

TXLSXWorkbook에 TXLSXSheets 컬렉션 클래스를 도입하여 BIFF facade의 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에서 읽어옵니다. 공유 문자열, 스타일, 날짜 및 수식은 아직 지원되지 않습니다.
향후 XLSX 기능에 사용하기 위해 OOXML 네임스페이스, 콘텐츠 유형, 관계 상수 및 참조/파싱/이스케이프 도우미(XlsxColumnLabel, XlsxCellRef, XlsxColumnIndex, XlsxParseCellRef, XlsxParseRangeRef, XlsxEscapeText, XlsxEscapeAttr)를 추가했습니다.

버전 2.16.4

XLSX 인터페이스 유닛(lxHandleX)은 이제 자체 워크북 및 워크시트 유형(TXLSXWorkbook, TXLSXWorksheet)을 정의하며, 이는 BIFF 인터페이스와 독립적입니다. 저장 및 로드 진입점은 예약되어 있으며, OOXML 연결은 추후 릴리스에서 구현될 예정입니다.
새로운 XLSX facade에 대한 개발자 참조 문서를 추가하여, lxHandle과 lxHandleX가 어떻게 공존하며 어떤 helper 유닛을 공유하는지 설명합니다.

버전 2.16.3

기존 BIFF 파사드 lxHandle와 나란히 위치하는 전용 XLSX 파사드 유닛 lxHandleX를 도입했습니다. 두 유닛은 동일한 기반 인프라(스타일 풀, XML 유틸리티, ZIP 아카이브)를 공유하지만 독립적인 클래스 계층을 노출합니다. lxHandle는 TXLSWorkBook과 기존 XLS/HTML/RTF/CSV 경로를 담당하고, lxHandleX는 TXLSXWorkbook과 모든 XLSX 전용 API를 담당합니다. lxHandle에 실수로 추가된 세 개의 메서드 스텁(SetCodePage, GetColumnXFIndex, GetRowXFIndex)을 제거하여 BIFF 파사드의 공개 API를 v2.15.0과 동일하게 유지했습니다. lxHandle를 사용하는 기존 코드는 변경이 필요 없습니다.

버전 2.16.2

XLSX 엔진 기반을 완성하는 세 개의 내부 데이터 구조 유닛을 추가했습니다. lxAvlTree는 정렬된 조회를 위한 O(log N) AVL 트리(TAVLTree/TAVLNode)를 제공합니다. lxCols와 lxRows는 세밀한 중복 제거 및 인덱스 재작성 기능을 갖춘 열 및 행 정보 컨테이너로, XLSX 엔진의 시트별 열 너비 및 행 높이 맵에 사용됩니다. 세 유닛 모두 이 버전에서는 비활성 상태이며, v2.17.0에서 XLSX 읽기/쓰기 엔진이 처음 활성화될 때 동작합니다.

버전 2.16.1

XLSX 엔진의 인프라 계층을 완성하는 여섯 개의 내부 XML 및 ZIP 유틸리티 유닛을 추가했습니다. lxWStream(파일 존재 확인 및 AnsiString 쓰기 헬퍼를 갖춘 와이드 문자 파일 스트림), lxCacheStream(하위 I/O 호출을 줄이는 버퍼링 스트림 래퍼), lxZlibStream(기존 loZlib BIFF 암호화 바인딩과 독립적인 전방 전용 deflate/inflate 스트림), lxXmlReader(고속 XML 파싱을 위한 SAX 방식 풀 리더), lxXmlWriter(요소 이름 재사용 기능을 갖춘 스트리밍 XML 라이터), lxZipArchive(항목별 deflate 스트림을 갖춘 중앙 디렉터리 ZIP 리더/라이터). v2.16.0의 일곱 유닛과 함께 XLSX 엔진의 완전한 내부 기반을 형성합니다.

버전 2.16.0

차기 XLSX 엔진의 기반이 되는 일곱 개의 내부 스타일 인프라 유닛을 추가했습니다. lxHashTable(정수, WideString, 객체 키 변형을 갖춘 범용 해시 테이블), lxKeyList(빠른 조회 및 인덱스 재작성 기능을 갖춘 객체 키 목록), lxStyleColor(Office 테마 색상 및 팔레트 슬롯 관리자), lxStyleFont, lxStyleFill, lxStyleBorder(12가지 BIFF 선 유형과 XLSX 스타일 매핑을 모두 포함하는 글꼴, 채우기, 테두리 스타일의 중복 제거 풀), lxStyleXf(다섯 개의 스타일 풀과 숫자 형식 목록을 단일 XF 레코드로 집계). 일곱 유닛 모두 이 버전에서는 비활성 상태이며 기존 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 참조를 웹 환경에 적합한 구조로 재구성하고, 주제, 자산, 스크립트, 스타일 및 소스 폴더를 분리했습니다.
브라우저 친화적인 도움말 홈 페이지와 목차 탐색 페이지를 추가했으며, 통일된 헤더, 주제 바로 가기 및 푸터를 제공합니다.