Widoki skoroszytu, połączenia i mapy XML

Ta dokumentacja referencyjna obejmuje edytowalne metadane skoroszytu znajdujące się poza siatką komórek, które muszą pozostać spójne, gdy zmieniają się arkusze, zakresy, filtry i części pakietu

Klasyczne widoki niestandardowe

TXLSWorksheet.CustomViews zwraca TXLSCustomViews, którego elementy Count, Items, Invalidatei SyncToRaw zachowują wpisane i nieznane rekordy widoków niestandardowych

TXLSCustomView exposes ViewId, Zoom, GridColorIndex, ActivePane, ShowPageBreaks, ShowFormulas, ShowGridLines, ShowHeadings, ShowOutlineSymbols, ShowZeroValues, CenterHorizontally, CenterVertically, PrintHeadingsudostępnia 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, RawRecordIdsi RawRecordData

TXLSCustomViewCellRange, TXLSCustomViewCellRanges, TXLSCustomViewSelectionInfo, TXLSCustomViewPageBreaki TXLSCustomViewPageBreaks przenoszą ładunki zaznaczeń i podziałów stron należące do widoku

Okna skoroszytu XLSX

TXLSXWorkbook.WorkbookViews posiada uporządkowane wpisy TXLSXWorkbookView skonfigurowane przez TXLSXWorkbookViewVisibility

Wstawianie, usuwanie i przenoszenie arkuszy przemieszcza aktywną i pierwszą widoczną kartę każdego okna, zachowując niezależną geometrię i ustawienia wyświetlania

Zaznaczenia per okienko

TXLSXWorksheet.Selections zwraca TXLSXSelections; TXLSXSelectionPane identyfikuje docelowe okienko, a każdy TXLSXSelection przechowuje Pane, ActiveCell, ActiveCellIdi wieloobszarowe Sqref

TXLSXSelection.Assign kopiuje jedno zaznaczenie, natomiast TXLSXSelections.Add, AddSelection, Assign, Clear, Delete, IndexOfPane, Counti Items utrzymują uporządkowaną kolekcję widoków arkusza

Podmodele połączeń

TXLSConnection zachowuje metadane baz danych, sieci Web, tekstu i OLAP. Jego model sieci Web używa WebParsePre, WebHtmlTablesi WebTables; jego model tekstu o stałej szerokości używa TextSourceFile i TextFields; jego model OLAP używa HasOlapProperties, OlapLocal, OlapLocalConnection, OlapLocalRefresh, OlapSendLocale, OlapRowDrillCount, OlapServerFill, OlapServerNumberFormat, OlapServerFont, OlapServerFontColor, OlapExtraAttributesXmli OlapChildrenXml

SourceFile przechowuje najwyższego poziomu źródło połączenia, a TextSourceFile przechowuje niezależne źródło importu textPr ; puste TextSourceFile wraca do SourceFile ze względu na zgodność

TXLSWebTableSelectorKind konfiguruje TXLSWebTableSelector, którego elementy Kind, Name, Index, ExtraAttributesXml, ChildrenXml, Assigni Validate zachowują nazwane, indeksowane i kompletne selektory tabel

TXLSWebTableSelectors udostępnia Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXmli UnknownChildrenXml

TXLSTextImportFieldType konfiguruje TXLSTextImportField, którego elementy FieldType, Position, ExtraAttributesXml, ChildrenXmli Assigndefiniują jedno pole tekstu o stałej szerokości Validate members define one fixed-text field

TXLSTextImportFields udostępnia Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXmli UnknownChildrenXml

Pełne elementy połączeń

TXLSConnection to Id, TypeCode, SourceFile, OdcFile, SingleSignOnId, KeepAlive, Interval, BackgroundRefresh, RefreshOnLoad, SaveData, SavePassword, NewConnection, Deleted, OnlyUseConnectionFile, ReconnectionMethod, RefreshedVersion, MinRefreshableVersion, ConnectionString, CommandText, ServerCommandText, CommandType, Parametersi ExtensionXml

Właściwości sieci Web to WebUrl, WebPost, WebEditPage, WebHtmlFormat, WebXml, WebSourceData, WebConsecutive, WebFirstRow, WebXl97, WebTextDates, WebXl2000, WebExtraAttributesXmli WebChildrenXml

Właściwości tekstu to TextSourceFile, TextPrompt, TextDelimited, TextCodePage, TextFirstRow, TextCharacterSet, TextQualifier, TextFileType, TextDecimal, TextThousands, TextTab, TextSpace, TextComma, TextSemicolon, TextConsecutive, TextDelimiter, TextExtraAttributesXmli TextChildrenXml; zachowywanie bazy danych używa DbExtraAttributesXml i DbChildrenXml

TXLSConnections.Assign kopiuje kolekcję, IndexOfId znajduje stabilny identyfikator połączenia, a RootAttributesXml wraz z UnknownChildrenXml zachowują nieobsługiwaną zawartość główną

Parametry połączeń

TXLSConnectionParameter używa Name, ParameterType, SqlType, RefreshOnChange, Prompt, CellReference, IntegerValue, DoubleValue, BooleanValue, StringValue, ValueKind, ExtraAttributesXmli Assign

TXLSConnectionParameters udostępnia Add, AddExisting, Assign, Delete, Clear, Counti Items

Tabele zapytań i pola

TXLSQueryTable używa 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, RefreshExtensionXmli UnknownChildrenXml, ExtraAttributesXml, RefreshExtraAttributesXml, and RefreshUnknownChildrenXml

TXLSQueryTableField używa Id, Name, TableColumnId, DataBound, RowNumbers, FillFormulas, Clipped, ExtraAttributesXml, Assigni Validate

TXLSQueryTableFields udostępnia Add, AddExisting, Assign, FindById, FindByTableColumnId, NextId, Validate, Delete, Clear, Counti Items; TXLSQueryTables.Assign kopiuje kolekcję tabel zapytań arkusza

Jawne odświeżanie tabel zapytań

Zobacz automatycznych dostawców zapytań, aby poznać jawne odświeżanie bez dostawcy wywołującego, rejestrację, natywne powiązania i limity operacji zewnętrznych

TXLSXWorksheet.RefreshQueryTable wybiera istniejącą tabelę zapytania po nazwie albo jej zero-bazowym indeksie kolekcji i przyjmuje należącego do wywołującego TXLSQueryTableProvider, dodatni limit AMaxRows domyślnie wynoszący 1 000 000 wierszy danych oraz opcjonalny callback TXLSQueryRefreshProgress

Zaimplementuj TXLSQueryTableProvider.Fetch(Connection, Query, MaxRows, out Data, var Abort), aby zwrócić rekord TXLSQueryResultData z ColumnCount i prostokątnymi Rows ze skalarnymi wartościami Variant; TXLSQueryResultRow to tablica wariantów, a TXLSQueryResultRows — tablica takich wierszy; wiersze wykluczają istniejące nagłówki i muszą pasować do szerokości celu, wartości numeryczne, daty, wartości logiczne, ciągi, błędy, wartości puste i nulle zachowują swoje typy, a ciągi zaczynające się od = pozostają wartościami literalnymi

Dostawca otrzymuje odłączone migawki metadanych połączenia i zapytania ważne tylko w trakcie wywołania i musi respektować limit wierszy; biblioteka odrzuca nadmiarowe wiersze, nierówne macierze, nieobsługiwane typy wartości, nieprawidłowe szerokości i wyniki poza siatką arkusza 1 048 576 wierszy na 16 384 kolumn, bez obcinania

Odświeżenie zachowuje istniejące nagłówki i formatowanie komórek, czyści stary ogon danych kurczącego się wyniku, zmienia rozmiar podpiętej tabeli Excela i obsługiwanych zakresów filtra albo sortowania, aktualizuje metadane tabeli zapytania i unieważnia obliczenia zależne; formuły i style poza obszarem wyniku pozostają bez zmian

Wyłączone zapytanie, usunięte połączenie, nakładające się scalone komórki albo formuły tablicowe, inna tabela albo wynik zapytania, zajęte komórki rozwinięcia, obliczeniowe kolumny tabeli, wiersze sum, kolumny numerów wierszy, zachowanie fill-formula albo niepowiązane kolumny uniemożliwiają odświeżenie przed zmianą komórek wyniku

Postęp jest raportowany przed pobraniem, przed zastosowaniem wyników i po każdym zastosowanym albo wyczyszczonym wierszu; ustaw Abort w dostawcy albo callbacku postępu, aby anulować, a wartość zwrotna 1 oznacza sukces, 0 anulowanie, a -1 porażkę, przy czym kody diagnostyczne 1401i 1400 identyfikują anulowanie i porażkę pod xlsOperationRefresh

Anulowanie albo wyjątki dostawcy, walidacji albo callbacku przywracają komórki wyniku oraz metadane zapytania albo tabeli, włącznie z istniejącymi uchwytami komórek; jawni dostawcy wywołującego posiadają własny dostęp zewnętrzny; automatyczny wybór obsługiwanych zapytań Windows Text, ADO, ODBC i Web jest dostępny przez dyspozytora skoroszytu, a otwarcie skoroszytu albo zachowanie metadanych RefreshOnLoad nie wywołuje żadnej z tych ścieżek dostawcy

Mapy XML i niestandardowy XML

TXLSXWorkbook.XmlMaps zwraca TXLSXXmlMaps, a TXLSXWorksheet.XmlCellBindings zwraca kolekcję powiązań arkusza

Zaawansowane elementy klonowania, HTML i obrazów

TXLSXRangeClonePart, TXLSXRangeClonePartsi TXLSXRangeCloneSourceCounts definiują klonowanie zakresów uwzględniające zależności. TXLSXWorksheet.CaptureRangeCloneSourceCounts, AuthorizeRepeatedDisjointRangeClones, ResizeTableRowsi TileRangeAxisMetadata to zaawansowane punkty zaczepienia edycji strukturalnych używane przez rozwijanie raportów skompilowanych i niestandardowych uczestników

TXLSXHtmlExportSessionState opisuje TXLSXHtmlExportSession; użyj BeginExport, ExportNextSheeti Reset, a następnie sprawdź State, Active, ExportedSheetCounti TotalSheetCount. Ustaw TXLSXHtmlExportOptions.IncludeDrawings , aby renderować obsługiwane obiekty arkusza do sesji HTML

TXLSXImage udostępnia Gamma, ShadowColor, ShadowOpacity, ShadowBlur, ShadowOffsetXi ShadowOffsetY dla współdzielonego renderowania PDF, SVG, HTML, bitmap i metafile

Zobacz także

• Omówienie fasady XLSX
• Zewnętrzne odwołania skoroszytu
• Interfejs API raportowania skompilowanego