통합 문서 보기, 연결 및 XML 맵

이 참조는 셀 그리드 밖에 있는 편집 가능한 통합 문서 메타데이터를 다루며, 시트, 범위, 필터 및 패키지 부분이 변경될 때 일관성을 유지해야 합니다

클래식 사용자 지정 보기

TXLSWorksheet.CustomViews 는 TXLSCustomViews를 반환하며, 해당 Count, Items, Invalidate및 SyncToRaw 멤버는 형식화된 사용자 지정 보기 및 알 수 없는 사용자 지정 보기 레코드를 보존합니다

TXLSCustomView 는 ViewId, Zoom, GridColorIndex, ActivePane, ShowPageBreaks, ShowFormulas, ShowGridLines, ShowHeadings, ShowOutlineSymbols, ShowZeroValues, CenterHorizontally, CenterVertically, PrintHeadings, PrintGridLines, FitToPage, FilterMode, AutoFilterVisible, FrozenPanes, FrozenNoSplit, SplitVertically, SplitHorizontally, TopLeftRow, TopLeftColumn, SplitX, SplitY, RightPaneColumn, BottomPaneRow, SelectionCount, Selections, HorizontalPageBreaks, VerticalPageBreaks, HasPageSetup, PaperSize, PrintScale, FirstPageNumber, FitToPagesWide, FitToPagesTall, PageSetupFlags및 HorizontalResolution를 노출합니다 VerticalResolution, HeaderMargin, FooterMargin, Copies, FilterFieldCount, FilterActive, FilterCriteria1, FilterCriteria2, FilterOperators, ClearFilterCriteria, RawRecordCount, RawRecordIds, and RawRecordData

TXLSCustomViewCellRange, TXLSCustomViewCellRanges, TXLSCustomViewSelectionInfo, TXLSCustomViewPageBreak및 TXLSCustomViewPageBreaks 는 보기가 소유한 선택 영역 및 페이지 나누기 페이로드를 전달합니다

XLSX 통합 문서 창

TXLSXWorkbook.WorkbookViews 는 TXLSXWorkbookView 가 구성한 정렬된 TXLSXWorkbookViewVisibility

시트 삽입, 삭제 및 이동은 독립적인 기하 구조와 표시 설정을 보존하면서 모든 창의 활성 탭 및 첫 번째 표시 탭을 다시 매핑합니다

창별 선택 영역

TXLSXWorksheet.Selections 는 TXLSXSelections를 반환합니다. TXLSXSelectionPane 은 대상 창을 식별하고 각 TXLSXSelection 은 Pane, ActiveCell, ActiveCellId및 다중 영역 Sqref

TXLSXSelection.Assign 은 하나의 선택 영역을 복사하고, TXLSXSelections.Add, AddSelection, Assign, Clear, Delete, IndexOfPane, Count및 Items 은 정렬된 시트 보기 컬렉션을 유지합니다

연결 하위 모델

TXLSConnection 은 데이터베이스, 웹, 텍스트 및 OLAP 메타데이터를 보존합니다. 웹 모델은 WebParsePre, WebHtmlTables및 WebTables를 사용하고, 고정 텍스트 모델은 TextSourceFile 및 TextFields를 사용하며, OLAP 모델은 HasOlapProperties, OlapLocal, OlapLocalConnection, OlapLocalRefresh, OlapSendLocale, OlapRowDrillCount, OlapServerFill, OlapServerNumberFormat, OlapServerFont, OlapServerFontColor, OlapExtraAttributesXml및 OlapChildrenXml

SourceFile 은 최상위 연결 소스를 저장하고 TextSourceFile 은 독립적인 textPr 가져오기 소스를 저장합니다. 빈 TextSourceFile 은 호환성을 위해 SourceFile 로 대체됩니다

TXLSWebTableSelectorKind 는 TXLSWebTableSelector를 구성하며, 해당 Kind, Name, Index, ExtraAttributesXml, ChildrenXml, Assign및 Validate 멤버는 명명된, 인덱스된 및 전체 표 선택기를 보존합니다

TXLSWebTableSelectors 는 Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXml및 UnknownChildrenXml

TXLSTextImportFieldType configures TXLSTextImportField는 FieldType을 구성하며, 해당 Position, ExtraAttributesXml, ChildrenXml, Assign및 Validate 멤버는 하나의 고정 텍스트 필드를 정의합니다

TXLSTextImportFields 는 Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXml및 UnknownChildrenXml

전체 연결 멤버

TXLSConnection 의 공통 속성은 Id, TypeCode, SourceFile, OdcFile, SingleSignOnId, KeepAlive, Interval, BackgroundRefresh, RefreshOnLoad, SaveData, SavePassword, NewConnection, Deleted, OnlyUseConnectionFile, ReconnectionMethod, RefreshedVersion, MinRefreshableVersion, ConnectionString, CommandText, ServerCommandText, CommandType, Parameters및 ExtensionXml

웹 속성은 WebUrl, WebPost, WebEditPage, WebHtmlFormat, WebXml, WebSourceData, WebConsecutive, WebFirstRow, WebXl97, WebTextDates, WebXl2000, WebExtraAttributesXml및 WebChildrenXml

텍스트 속성은 TextSourceFile, TextPrompt, TextDelimited, TextCodePage, TextFirstRow, TextCharacterSet, TextQualifier, TextFileType, TextDecimal, TextThousands, TextTab, TextSpace, TextComma, TextSemicolon, TextConsecutive, TextDelimiter, TextExtraAttributesXml및 TextChildrenXml입니다. 데이터베이스 보존은 DbExtraAttributesXml 및 DbChildrenXml

TXLSConnections.Assign 은 컬렉션을 복사하고, IndexOfId 는 안정적인 연결 식별자를 찾으며, RootAttributesXml 및 UnknownChildrenXml 은 지원되지 않는 루트 내용을 보존합니다

연결 매개 변수

TXLSConnectionParameter 는 Name, ParameterType, SqlType, RefreshOnChange, Prompt, CellReference, IntegerValue, DoubleValue, BooleanValue, StringValue, ValueKind, ExtraAttributesXml및 Assign

TXLSConnectionParameters 는 Add, AddExisting, Assign, Delete, Clear, Count및 Items

쿼리 테이블 및 필드

TXLSQueryTable 는 Assign, ConnectionId, ResultTableName, ResultRange, RowNumbers, DisableRefresh, BackgroundRefresh, FirstBackgroundRefresh, RefreshOnLoad, GrowShrinkType, FillFormulas, RemoveDataOnSave, DisableEdit, PreserveFormatting, Intermediate, AutoFormatId, ApplyNumberFormats, ApplyBorderFormats, ApplyFontFormats, ApplyPatternFormats, ApplyAlignmentFormats, ApplyWidthHeightFormats, PreserveSortFilterLayout, FieldIdWrapped, AdjustColumnWidth, HeadersInLastRefresh, MinimumVersion, UnboundColumnsLeft, UnboundColumnsRight, DeletedFields, SortStateXml, ExtensionXml, RefreshExtensionXml및 UnknownChildrenXml을 사용합니다 ExtraAttributesXml, RefreshExtraAttributesXml, and RefreshUnknownChildrenXml

TXLSQueryTableField 은 Id, Name, TableColumnId, DataBound, RowNumbers, FillFormulas, Clipped, ExtraAttributesXml및 Assign를 사용합니다 Validate

TXLSQueryTableFields provides Add, AddExisting는 Assign, FindById, FindByTableColumnId, NextId, Validate, Delete, Clear, Count및 Items을 제공합니다. TXLSQueryTables.Assign 은 워크시트 쿼리 테이블 컬렉션을 복사합니다

명시적 쿼리 테이블 새로 고침

호출자 공급자 없이 명시적으로 새로 고침하려면, 등록, 네이티브 바인딩, 외부 작업 한도는 자동 쿼리 공급자를 참고하세요

TXLSXWorksheet.RefreshQueryTable은 이름이나 0 기반 컬렉션 인덱스로 기존 쿼리 테이블을 선택하고, 호출자 소유 TXLSQueryTableProvider, 기본값이 1,000,000 데이터 행인 양수 AMaxRows 한도, 선택적 TXLSQueryRefreshProgress 콜백을 받습니다

TXLSQueryTableProvider.Fetch(Connection, Query, MaxRows, out Data, var Abort)를 구현해 ColumnCount와 스칼라 Variant 값의 사각형 Rows를 담은 TXLSQueryResultData 레코드를 반환하세요. TXLSQueryResultRow는 변형 배열이고 TXLSQueryResultRows는 그 행들의 배열입니다. 행은 기존 헤더를 제외하고 대상 너비와 일치해야 하며, 숫자·날짜·Boolean·문자열·오류·빈 값·null은 타입을 유지하고, =로 시작하는 문자열은 리터럴 값으로 남습니다

공급자는 호출 동안에만 유효한 분리된 연결·쿼리 메타데이터 스냅샷을 받고 행 한도를 존중해야 합니다. 라이브러리는 초과 행, 들쭉날쭉한 행렬, 지원되지 않는 값 타입, 잘못된 너비, 1,048,576행 × 16,384열 워크시트 그리드 밖 결과를 잘라내지 않고 거부합니다

새로 고침은 기존 헤더와 셀 서식을 유지하고, 줄어든 결과의 오래된 데이터 꼬리를 지우고, 붙은 Excel 표와 지원되는 필터·정렬 범위 크기를 조정하고, 쿼리 테이블 메타데이터를 갱신하고, 종속 계산을 무효화합니다. 결과 영역 밖의 수식과 스타일은 바뀌지 않습니다

비활성화된 쿼리, 삭제된 연결, 겹치는 병합 셀이나 배열 수식, 다른 표나 쿼리 결과, 차지된 확장 셀, 계산된 표 열, 합계 행, 행 번호 열, fill-formula 동작, 바인딩되지 않은 열이 있으면 결과 셀이 바뀌기 전에 새로 고침이 막힙니다

진행 상황은 가져오기 전, 결과 적용 전, 적용되거나 지워진 각 행 뒤에 보고됩니다. 공급자나 진행 콜백에서 Abort를 설정해 취소하고, 반환 값 1은 성공, 0은 취소, -1은 실패입니다. 진단 코드 1401과 1400은 xlsOperationRefresh 아래에서 각각 취소와 실패를 식별합니다

취소나 공급자·검증·콜백 예외는 기존 셀 핸들을 포함해 결과 셀과 쿼리·표 메타데이터를 복원합니다. 명시적 호출자 공급자는 자기 외부 접근을 소유합니다. 지원되는 Windows Text, ADO, ODBC, Web 쿼리의 자동 선택은 통합 문서 디스패처를 통해 제공되며, 통합 문서 열기나 RefreshOnLoad 메타데이터 보존은 어느 공급자 경로도 부르지 않습니다

XML 맵 및 사용자 지정 XML

TXLSXWorkbook.XmlMaps 는 TXLSXXmlMaps를 반환하고, TXLSXWorksheet.XmlCellBindings 는 시트 바인딩 컬렉션을 반환합니다

고급 복제, HTML 및 이미지 멤버

TXLSXRangeClonePart, TXLSXRangeCloneParts및 TXLSXRangeCloneSourceCounts 는 종속성 인식 범위 복제를 정의합니다. TXLSXWorksheet.CaptureRangeCloneSourceCounts, AuthorizeRepeatedDisjointRangeClones, ResizeTableRows및 TileRangeAxisMetadata 는 컴파일된 보고서 확장 및 사용자 지정 참여자가 사용하는 고급 구조 편집 후크입니다

TXLSXHtmlExportSessionState 는 TXLSXHtmlExportSession을 설명합니다. BeginExport, ExportNextSheet및 Reset을 사용한 다음 State, Active, ExportedSheetCount및 TotalSheetCount를 검사합니다. TXLSXHtmlExportOptions.IncludeDrawings 를 설정하여 지원되는 워크시트 개체를 HTML 세션으로 렌더링합니다

TXLSXImage 는 공유 PDF, SVG, HTML, 비트맵 및 메타파일 렌더링을 위해 Gamma, ShadowColor, ShadowOpacity, ShadowBlur, ShadowOffsetX및 ShadowOffsetY 를 노출합니다

참고 항목

• XLSX 퍼사드 개요
• 외부 통합 문서 참조
• 컴파일된 보고 API