Documentazione HotXLS

Viste della cartella di lavoro, connessioni e mappe XML

Questo riferimento copre i metadati modificabili della cartella di lavoro che si trovano al di fuori della griglia delle celle e che devono rimanere coerenti quando cambiano fogli, intervalli, filtri e parti del pacchetto

Viste personalizzate classiche

TXLSWorksheet.CustomViews restituisce TXLSCustomViews, i cui membri Count, Items, Invalidatee SyncToRaw preservano i record di viste personalizzate tipizzati e sconosciuti

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

TXLSCustomViewCellRange, TXLSCustomViewCellRanges, TXLSCustomViewSelectionInfo, TXLSCustomViewPageBreake TXLSCustomViewPageBreaks trasportano i payload di selezione e interruzione di pagina di proprietà di una vista

Finestre della cartella di lavoro XLSX

TXLSXWorkbook.WorkbookViews possiede voci TXLSXWorkbookView ordinate configurate da TXLSXWorkbookViewVisibility

TXLSXWorkbookViewAssign, ActiveTab, FirstSheet, Visibility, Minimized, ShowHorizontalScroll, ShowVerticalScroll, ShowSheetTabs, XWindow, YWindow, WindowWidth, WindowHeight, TabRatio, AutoFilterDateGroupinge UnknownAttributes, and Extensions
TXLSXWorkbookViewsAdd, Insert, Delete, Move, Clear, Counte Items

L'inserimento, l'eliminazione e lo spostamento dei fogli rimappano la scheda attiva e la prima scheda visibile di ogni finestra preservando geometria e impostazioni di visualizzazione indipendenti

Selezioni per riquadro

TXLSXWorksheet.Selections restituisce TXLSXSelections; TXLSXSelectionPane identifica il riquadro di destinazione e ogni TXLSXSelection memorizza Pane, ActiveCell, ActiveCellIde Sqref

TXLSXSelection.Assign copia una selezione, mentre TXLSXSelections.Add, AddSelection, Assign, Clear, Delete, IndexOfPane, Counte Items mantengono la raccolta ordinata delle viste di foglio

Sottomodelli di connessione

TXLSConnection preserva i metadati di database, web, testo e OLAP. Il suo modello web usa WebParsePre, WebHtmlTablese WebTables; il suo modello a testo fisso usa TextSourceFile e TextFields; il suo modello OLAP usa HasOlapProperties, OlapLocal, OlapLocalConnection, OlapLocalRefresh, OlapSendLocale, OlapRowDrillCount, OlapServerFill, OlapServerNumberFormat, OlapServerFont, OlapServerFontColor, OlapExtraAttributesXmle OlapChildrenXml

SourceFile memorizza la sorgente di connessione di primo livello mentre TextSourceFile memorizza la sorgente di importazione textPr indipendente; un TextSourceFile vuoto torna a SourceFile per compatibilità

TXLSWebTableSelectorKind configura TXLSWebTableSelector, i cui membri Kind, Name, Index, ExtraAttributesXml, ChildrenXml, Assigne Validate preservano selettori denominati, indicizzati e di tabella completa

TXLSWebTableSelectors fornisce Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXmle UnknownChildrenXml

TXLSTextImportFieldType configura TXLSTextImportField, i cui membri FieldType, Position, ExtraAttributesXml, ChildrenXmle Assigndefiniscono un campo a testo fisso Validate members define one fixed-text field

TXLSTextImportFields fornisce Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXmle UnknownChildrenXml

Membri completi della connessione

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

Le proprietà web sono WebUrl, WebPost, WebEditPage, WebHtmlFormat, WebXml, WebSourceData, WebConsecutive, WebFirstRow, WebXl97, WebTextDates, WebXl2000, WebExtraAttributesXmle WebChildrenXml

Le proprietà di testo sono TextSourceFile, TextPrompt, TextDelimited, TextCodePage, TextFirstRow, TextCharacterSet, TextQualifier, TextFileType, TextDecimal, TextThousands, TextTab, TextSpace, TextComma, TextSemicolon, TextConsecutive, TextDelimiter, TextExtraAttributesXmle TextChildrenXml; la conservazione del database usa DbExtraAttributesXml e DbChildrenXml

TXLSConnections.Assign copia una raccolta, IndexOfId trova un identificatore di connessione stabile e RootAttributesXml più UnknownChildrenXml preservano il contenuto root non supportato

Parametri di connessione

TXLSConnectionParameter usa Name, ParameterType, SqlType, RefreshOnChange, Prompt, CellReference, IntegerValue, DoubleValue, BooleanValue, StringValue, ValueKind, ExtraAttributesXmle Assign

TXLSConnectionParameters fornisce Add, AddExisting, Assign, Delete, Clear, Counte Items

Tabelle di query e campi

TXLSQueryTable usa 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, RefreshExtensionXmle UnknownChildrenXml, ExtraAttributesXml, RefreshExtraAttributesXml, and RefreshUnknownChildrenXml

TXLSQueryTableField uses Idusa Name, TableColumnId, DataBound, RowNumbers, FillFormulas, Clipped, ExtraAttributesXml, Assigne Validate

TXLSQueryTableFields fornisce Add, AddExisting, Assign, FindById, FindByTableColumnId, NextId, Validate, Deletee Clear; Countcopia la raccolta di tabelle di query del foglio di lavoro Items; TXLSQueryTables.Assign copia la raccolta delle tabelle query del foglio

Refresh esplicito delle tabelle di query

Vedi provider di query automatici per il refresh esplicito senza un provider del chiamante, la registrazione, i binding nativi e i limiti delle operazioni esterne

TXLSXWorksheet.RefreshQueryTable seleziona una tabella di query esistente per nome o per indice della raccolta a base zero e accetta un TXLSQueryTableProvider di proprietà del chiamante, un limite AMaxRows positivo che ha come predefinito 1,000,000 righe di dati e un callback TXLSQueryRefreshProgress opzionale

Implementa TXLSQueryTableProvider.Fetch(Connection, Query, MaxRows, out Data, var Abort) per restituire un record TXLSQueryResultData con ColumnCount e Rows rettangolari di valori scalari Variant; TXLSQueryResultRow è un array di variant e TXLSQueryResultRows è un array di quelle righe; le righe escludono le intestazioni esistenti e devono corrispondere alla larghezza della destinazione, i valori numerici, le date, i booleani, le stringhe, gli errori, i valori vuoti e i null conservano i loro tipi, e le stringhe che iniziano con = restano valori letterali

Il provider riceve snapshot scollegati di metadati di connessione e query validi solo durante la chiamata e deve rispettare il limite di righe; la libreria rifiuta righe in eccesso, matrici frastagliate, tipi di valore non supportati, larghezze non valide e risultati fuori dalla griglia del foglio di 1,048,576 righe per 16,384 colonne senza troncamento

Il refresh conserva le intestazioni esistenti e la formattazione delle celle, cancella la coda di dati vecchi di un risultato che si restringe, ridimensiona una tabella Excel collegata e gli intervalli di filtro od ordinamento supportati, aggiorna i metadati della tabella di query e invalida i calcoli dipendenti; formule e stili fuori dall'area del risultato restano invariati

Una query disabilitata, una connessione eliminata, celle unite sovrapposte o formule array, un'altra tabella o risultato di query, celle di espansione occupate, colonne di tabelle calcolate, righe di totali, colonne di numeri di riga, comportamento fill-formula o colonne non collegate impediscono il refresh prima che le celle del risultato cambino

Il progresso viene riportato prima del fetch, prima di applicare i risultati e dopo ogni riga applicata o cancellata; imposta Abort nel provider o nel callback di progresso per annullare, e un valore di ritorno di 1 indica successo, 0 annullamento e -1 fallimento, con codici diagnostici 1401 e 1400 che identificano annullamento e fallimento sotto xlsOperationRefresh

L'annullamento o le eccezioni di provider, validazione o callback ripristinano le celle del risultato e i metadati di query o tabella, inclusi gli handle di cella esistenti; i provider espliciti del chiamante sono proprietari del proprio accesso esterno; la selezione automatica per query Text, ADO, ODBC e Web supportate su Windows è disponibile tramite il dispatcher del workbook, e l'apertura di un workbook o la conservazione dei metadati RefreshOnLoad non invoca nessuno dei due percorsi di provider

Mappe XML e XML personalizzato

TXLSXWorkbook.XmlMaps restituisce TXLSXXmlMapse TXLSXWorksheet.XmlCellBindings restituisce la raccolta di associazioni del foglio

TXLSXXmlDataBindingMemorizza l'identificatore di relazione e i metadati di aggiornamento che collegano una mappa a una parte XML personalizzata Enabled, DataBindingName, FileBinding, FileBindingName, ConnectionId, DataBindingLoadMode, and ExtensionXml mirror the OOXML dataBinding attributes
TXLSXXmlSchemaMemorizza un identificatore di schema, uno spazio dei nomi e l'XML dello schema preservato Id, SchemaRef, NamespaceUri, Language, and Xml round-trip the schema part
TXLSXXmlMapConserva l'identità della mappa, l'elemento radice e il namespace, e il suo DataBinding; import behaviour is configured by RootElement, SchemaId, ShowImportExportValidationErrors, AutoFit, Append, PreserveSortAFLayoutMemorizza l'identità della mappa, l'elemento root e lo spazio dei nomi, e il suo PreserveFormat
TXLSXXmlMapsAddSchema, AddMap, FindSchema, FindMap, DeleteSchema, DeleteMap, Clear, Validate, SelectionNamespacese SchemaCountTXLSXXmlCellBinding SchemasAssocia un intervallo del foglio di lavoro a un XPath e a un identificatore di mappa XML MapCount
TXLSXXmlCellBindingOverload di CellReference, XPath, XmlDataType, MapId, XmlCellPropertyIde ConnectionId, and UniqueName preserve the full OOXML binding
TXLSXXmlCellBindingsAdd overloads, Delete, Clear, Validate, Count, and Items
TXLSXCustomXmlPartAddSchemaRef associa un elemento XML personalizzato a un riferimento allo schema; Xml holds the item payload, ItemId the data-store item identifier, and SchemaRefs associa un elemento XML personalizzato a un riferimento di schema

Membri avanzati di clonazione, HTML e immagini

TXLSXRangeClonePart, TXLSXRangeClonePartse TXLSXRangeCloneSourceCounts definiscono la clonazione di intervalli consapevole delle dipendenze. TXLSXWorksheet.CaptureRangeCloneSourceCounts, AuthorizeRepeatedDisjointRangeClones, ResizeTableRowse TileRangeAxisMetadata sono hook avanzati di modifica strutturale usati dall'espansione dei report compilati e dai partecipanti personalizzati

TXLSXHtmlExportSessionState descrive TXLSXHtmlExportSession; usare BeginExport, ExportNextSheete Reset, quindi ispezionare State, Active, ExportedSheetCounte TotalSheetCount. Impostare TXLSXHtmlExportOptions.IncludeDrawings per eseguire il rendering degli oggetti di foglio supportati nella sessione HTML

TXLSXImage espone Gamma, ShadowColor, ShadowOpacity, ShadowBlur, ShadowOffsetXe ShadowOffsetY per il rendering condiviso PDF, SVG, HTML, bitmap e metafile

Vedere anche