고급 XLSX API 멤버

이러한 멤버는 기본 통합 문서, 워크시트, 범위, 스타일, 필터 및 차트 참조 페이지를 보완하는 덜 일반적이지만 공개된 XLSX 편집 표면을 다룹니다

워크시트 창, 표시 및 배경

TXLSXWorksheet.SplitPanes 및 RemoveSplit 은 분할 창 상태를 편집합니다. SplitRow, SplitCol, PaneStateKind및 ScrollCol 은 저장된 보기 좌표를 노출합니다

DisplayRowColHeaders 는 행 및 열 머리글을 제어하고, GridLinesSet 은 기본값과 명시적 눈금선 선택을 구분하며, DefaultFormat 및 StyleOverlays 는 시트 수준 스타일 상태를 노출합니다

BackgroundImageData 및 BackgroundImageFormat 은 워크시트 배경 이미지를 노출하고 BackgroundImageResource 는 이를 제거합니다 ClearBackgroundImage removes it

창 선택 및 스크롤

GetSelectedAreas 와 창 우선 SelectAreas 오버로드는 공유 TXLSPanePosition 타입을 사용하고, 순서가 있는 겹치는 A1 영역을 보존하며, 활성 영역 인덱스와 함께 호출자 소유 스냅샷을 반환합니다

행 전체·열 전체 구조 편집은 모든 창 선택을 다시 매핑하고 남는 영역의 순서와 활성 영역 식별자를 보존하며, 활성 영역이 제거되면 결정론적인 후속·선행·경계 셀 폴백을 사용합니다

선택 정규화, 구조 재매핑, 스냅샷 생성은 원패스 빌더와 기하급수적 용량 증가를 사용해 대규모 영역 처리를 분할 상환 선형으로 유지합니다

TryGetWindowScroll 과 ScrollWindow 는 동일한 논리 창과 1 기반 좌표를 사용하면서 전체 sheetView 와 아래·오른쪽 pane 스크롤 위치를 독립적으로 유지합니다

누락된 창과 잘못된 갱신은 워크시트를 그대로 둡니다. 워크시트 창 선택 및 스크롤

페이지 매김 유지 범위

KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogether및 KeepTogetherCount 는 기하 구조가 허용하는 경우 한 페이지에 유지되어야 하는 블록을 정의합니다

BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRow및 KeepColBlockBreakCol 은 제안된 페이지 나누기가 해당 블록과 상호 작용하는 방식을 검사합니다

워크시트 편집 도우미

AddImagePair 은 SVG 및 PNG와 같은 대체 동반 이미지와 함께 기본 이미지를 기록하고, AddChartFromRanges 는 형식화된 범주 및 값 범위에서 차트를 빌드하며, CheckDataValidations 는 모든 위반 셀을 반환합니다

CheckDataValidation 은 후보 값 하나를 셀을 덮는 모든 유효성 검사 규칙과 비교해 유효하면 -1 을, 아니면 1 기반 첫 실패 규칙 인덱스를 반환하고, 유효한 후보에 한해 선택적으로 커밋할 수 있습니다

GetCellVisibleFormat 은 빈 셀을 만들지 않고 워크시트, 행, 열, 범위 오버레이, 명시적 셀 서식을 종합한 유효 서식을 해석합니다. Subtotal 은 한 열의 값 변화를 기준으로 정렬된 범위를 그룹화하고 부분합 수식, 선택적 총합계 수식, 상속된 서식, 아웃라인 수준을 삽입합니다

SortRangeInternal 은 범위 및 보고서 작업에서 사용하는 고급 안정 정렬 진입점입니다. 호출자는 일반적으로 SortRange 또는 TXLSXRange.Sort

ClearColWidth 와 ClearRowHeight 는 열이나 행의 명시적 크기를 제거해 시트 기본값으로 되돌리며, HasColWidth / HasRowHeight 조회와 짝을 이룹니다

아웃라인 노드 제어

TryGetOutlineNode 는 1 기반 행 또는 열 인덱스에 대해 방향을 인식하는 요약 노드, 상세 범위, 아웃라인 수준, 숨김 상태, 명시적 축소 마커를 반환합니다

SetOutlineNodeCollapsed 는 요약 노드 하나를 멱등하게 축소하거나 확장하고, SetOutlineDisplayLevel 은 실체화된 모든 그룹에 1 기반 아웃라인 버튼 수준을 적용합니다. 둘 다 xocPreserve, xocCollapse, xocExpand 자식 처리 방식을 받습니다

ToggleRowGrouped 와 ToggleColGrouped 는 첫 상세 인덱스를 받아 SummaryBelow 나 SummaryRight

OpenDocument 고유 행·열 그룹은 table:display로 매핑되고 직접적인 메타데이터·구조 편집에서 살아남으며, 구성원 수준의 축소 플래그를 유지하지 않은 채 XLSX 요약 노드 마커로 변환됩니다. 희소 아웃라인 지오메트리

명명된 스타일 및 표 스타일 확인

TXLSXRange.ApplyNamedStyle 는 범위를 명명된 셀 스타일에 연결합니다. TXLSXLinkedStyle.AutomaticChoose 는 스타일에서 영향받는 서식 부분을 도출하고, LinkedParts 는 글꼴, 채우기, 테두리, 숫자 서식, 맞춤, 보호를 명시적으로 선택합니다

Editing TXLSXNamedStyle.Style 을 편집하면 로컬 재정의를 버리지 않고 연결된 부분이 갱신되며, GetCellVisibleFormat 은 빈 셀을 실체화하지 않고 워크시트 오버레이와 표 스타일을 함께 반영해 결과를 해석합니다

TXLSXNamedStyles.FindByName 은 컬렉션을 수동으로 훑지 않고 표시 이름으로 명명된 스타일 항목을 찾습니다

60개의 내장 light, medium, dark 표 스타일 이름 전체는 HTML, PDF, 이미지, 미리 보기, 뷰어 출력이 공유하는 완전한 테마 기반 섹션 서식으로 확인됩니다

수식 변환

TXLSXCell.ConvertFormulaToValue 는 하나의 수식을 캐시된 값으로 대체하고 TXLSXCells.ConvertFormulasToValues 는 저장된 셀 컬렉션에 동일한 작업을 적용합니다

수식 입력 유효성 검사

TXLSXWorkbook.FormulaEntryPolicy 와 TXLSXWorksheet.ValidateFormulaEntry 는 공유되는 비변경 수식 입력 계약을 노출하고, 빈 텍스트, 알 수 없는 함수, 알 수 없는 이름, 구문 오류, 잘못된 대상을 구분하며, 등록된 사용자 함수를 호출하지 않고 인식합니다. 수식 입력 유효성 검사 정책

셀 저장소 진단

TXLSXCells.PackedStorageEnabled 는 호환되는 행 우선 형식화 대량 쓰기가 사용하는 압축 RLE 백엔드를 제어하고, PackedCellCount 는 개체 수준 접근이 안정적인 셀 핸들을 실체화하기 전에 그곳에 유지되는 셀 수를 보고합니다

GetStorageStatistics 는 측정 가능한 메모리 판단을 위해 행 블록, 채워진 행, 개체·텍스트·수식·리치 텍스트·예상 압축·활성 압축·할당·사용·압축 문자열 바이트 수를 보고합니다. 스타일 페이로드 수와 절약된 스타일 빈 셀 페이로드 바이트는 쓰기 시 복사 공유를 직접 보여 줍니다

자동 필터 세부 정보

TXLSXAutoFilterColumn.ClearValueFilters 는 열 항목을 유지하면서 값 및 날짜 그룹 필터를 지웁니다

HasCriteria2 및 AndConnector 는 두 조건 사용자 지정 필터를 설명합니다. 색 필터는 HasColorFilter, HasColorFilter_CellColor및 HasColorFilter_DxfId를 사용하고, 아이콘 필터는 HasIconFilter, HasIconFilter_Set및 HasIconFilter_Id

동적 필터는 HasDynamicFilter, HasDynamicFilter_Type, HasDynamicFilter_Val, HasDynamicFilter_ValSet, HasDynamicFilter_MaxVal및 HasDynamicFilter_MaxValSet을 사용합니다. RawXml 은 지원되지 않는 필터 페이로드를 보존합니다

그라데이션 채우기

TXLSXFill.AddGradientStop 은 색상 중지점을 추가합니다. GradientKind, GradientDegree, GradientLeft, GradientTop, GradientRight, GradientBottom, GradientStopCount및 GradientStops 는 선형 또는 경로 기하 구조를 노출합니다

BackgroundColorTheme, BackgroundColorIndex및 BackgroundTintAndShade 는 비 RGB 배경 색상을 보존하고, TXLSXFills.AddLinearGradient 은 완전한 선형 그라데이션을 만들고 등록합니다

TXLSXFill.ForegroundColorTheme, ForegroundColorIndex, ForegroundTintAndShade 는 전경 대응 속성으로, RGB 값과 함께 테마, 팔레트 인덱스, tint-and-shade 전경색을 보존합니다

차트

TXLSXChart 는 PlotGroupCount, ChartStyle, DispBlanksAs, PlotVisibleOnly및 DataLabelsRange 를 노출합니다

TXLSXChartPlotGroup.Assign 은 플롯 그룹을 복사합니다. ZOrder, BarGrouping, GapWidth및 Overlap 은 해당 순서 및 막대 기하 구조를 제어합니다

TXLSXChartSeries 는 SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPos및 LabelPosSet

시리즈별 셀 소스 레이블은 DataLabelsRange, DataLabelsCache, ShowDataLabelsRange, ShowDataLabelsRangeSet을 사용합니다. SetPointShowDataLabelsRange 와 TryGetPointShowDataLabelsRange 는 희소한 0 기반 표시 여부 재정의를 관리하고, ResolveDataLabelsRange 는 통합 문서 생성당 한 번 접근 가능한 워크시트 텍스트를 새로 고치면서 데이터 소스를 열지 않고 외부 캐시를 유지합니다

TXLSXChartSeries.CategoriesMultiLevel 은 계층적 축 레이블을 위해 c:multiLvlStrRef 범주를 기록하고, 기본값은 평면적인 c:strRef / c:numRef 기록을 유지합니다

TXLSXChartTrendline 은 Intercept, InterceptSet, Forward, Backward 예측 구간을 노출하고, TXLSXChartAxis.ShowDispUnitsLabel 은 표시 단위 레이블을 제어합니다

조건부 서식 및 유효성 검사

TXLSXConditionalFormat.ContainsCellFast 는 인덱스 멤버십 검사를 수행하고, HasStyle 은 차등 스타일을 보고하며, StdDev, EqualAverage및 IsPivot 은 고급 규칙 플래그를 노출합니다

TXLSXConditionalFormat.AcquireWriteGuard 는 통합 문서의 IXLSWorkbookWriteGuard 를 반환하므로, 묶음으로 처리한 규칙 편집이 완료 시점에 통합 문서 세대를 한 번만 진행시킵니다

TXLSXDataValidation.ContainsCellFast 는 동등한 인덱스 유효성 검사 범위 멤버십 검사를 수행합니다

표, 시트, 링크, 주석 및 도형

TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIds및 HasHeaderRow 는 쿼리 기반 및 머리글 없는 표 메타데이터를 보존합니다

TXLSXTable.FindFirst 와 FindNext 는 호출자가 지정한 워크시트에서 명명된 열의 값이 주어진 값과 같은 행을 훑으며, 대소문자를 구분하지 않는 문자열·숫자·Boolean 비교로 1 기반 행 또는 0을 반환합니다

TXLSXSheets.AddCopy 는 종속 개체와 함께 워크시트를 복제하고 ByPos 는 현재 탭 위치로 컬렉션에 접근합니다

TXLSXExternalLink.AddDefinedName 와 DefinedNameCount 는 캐시된 외부 이름을 유지하고, FindDefinedName 은 이름으로 항목을 찾습니다. 읽기 전용 RelationshipId, SourceSlot, LinkKind 속성은 외부 링크 파트의 관계 id, 외부 수식이 쓰는 1 기반 [N] 슬롯, 링크 분류(workbook, DDE, OLE, unknown)를 노출합니다. TXLSXHyperlink.TargetFrame 은 대상 탐색 컨텍스트를 보존합니다

TXLSXDefinedName.UnknownAttributes 는 정의된 이름에서 인식하지 못한 속성을 보존해 지원되지 않는 확장도 왕복에서 살아남게 합니다

TXLSXComment.AutoSizeFromText 는 주석 도형을 텍스트 크기에 맞추고 ClearFont 는 명시적 서식 있는 텍스트 글꼴 실행을 제거합니다

TXLSXImage.SvgData 는 SVG 동반 데이터를 저장하고 CameraRange 는 연결된 그림 소스 범위를 식별합니다. TXLSXTextBox.PrstToken 은 DrawingML 사전 설정 기하 구조 토큰을 보존합니다

이미지는 바이트를 복사하지 않고 페이로드를 공유합니다. TXLSXImage.Blob ( IXLSXImageBlob , Data, SvgData, CacheKey, ContentDigest, SvgContentDigest를 가진 ByteSize인터페이스)를 할당하는 것이 반복되는 보고서 이미지의 제로 카피 경로이고, 다이제스트는 저장 시점 미디어 인터닝을 위해 한 번 계산되며, 읽기 전용 TXLSXImage.CacheKey 와 ContentDigest 가 할당된 식별자를 보고합니다. 보고서 캐시는 같은 캐시 키가 다른 바이트나 서식과 함께 재사용되면 거부합니다

DrawingObjectCount 와 DrawingObject 는 이미지, 차트, 텍스트 상자, 보존된 원시 앵커, 그룹에 걸쳐 하나의 안정적인 혼합 순서를 노출합니다. 각 TXLSXDrawingObject 는 Kind, Parent, ChildCount, TextBox를 노출하며 BringToFront, SendToBack, BringForward, SendBackward

GroupDrawingObjects 는 선택한 개체로 변환을 인식하는 DrawingML 그룹을 만들고, UngroupDrawingObject 는 기존 패키지에서 로드된 그룹을 포함해 자식을 순서대로 복원합니다

클래식 워크시트 대응 요소

TXLSWorksheet.SetBackgroundImage, ClearBackgroundImage, BackgroundImageResource 는 BIFF8 워크시트 배경을 만들고, 제거하고, 검사합니다. 비트맵 데이터는 표준 BMP로 노출되고, 고유 형식이나 알 수 없는 형식은 원시 페이로드와 형식 코드를 유지하며, 알려진 배경은 클래식 엔진과 XLSX 엔진 사이에서 어느 방향으로든 변환됩니다

TXLSWorksheet.ConvertFormulasToValues 는 수식을 캐시된 결과로 대체하고, OpenRTF 오버로드는 기본 또는 호출자가 선택한 대상에 RTF 표를 가져오며, WriteAutoValue 는 변형에서 셀 형식을 선택하고, DefaultFormat 은 워크시트 기본 XF를 노출합니다