Vues de classeur, connexions et mappages XML

Cette référence couvre les métadonnées de classeur modifiables qui se situent en dehors de la grille de cellules et doivent rester cohérentes lorsque les feuilles, les plages, les filtres et les parties du package changent

Vues personnalisées classiques

TXLSWorksheet.CustomViews renvoie TXLSCustomViews, dont les membres Count, Items, Invalidateet SyncToRaw préservent les enregistrements de vues personnalisées typés et inconnus

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

TXLSCustomViewCellRange, TXLSCustomViewCellRanges, TXLSCustomViewSelectionInfo, TXLSCustomViewPageBreaket TXLSCustomViewPageBreaks transportent les données de sélection et de saut de page appartenant à une vue

Fenêtres de classeur XLSX

TXLSXWorkbook.WorkbookViews possède des entrées ordonnées TXLSXWorkbookView configurées par TXLSXWorkbookViewVisibility

L'insertion, la suppression et le déplacement de feuilles remappent l'onglet actif et le premier onglet visible de chaque fenêtre tout en préservant la géométrie et les paramètres d'affichage indépendants

Sélections par volet

TXLSXWorksheet.Selections renvoie TXLSXSelections; TXLSXSelectionPane identifie le volet cible et chaque TXLSXSelection stocke Pane, ActiveCell, ActiveCellIdet le Sqref

TXLSXSelection.Assign copie une sélection, tandis que TXLSXSelections.Add, AddSelection, Assign, Clear, Delete, IndexOfPane, Countet Items maintiennent la collection ordonnée de vues de feuille

Sous-modèles de connexion

TXLSConnection préserve les métadonnées de base de données, web, texte et OLAP. Son modèle web utilise WebParsePre, WebHtmlTableset WebTables; son modèle de texte fixe utilise TextSourceFile et TextFields; son modèle OLAP utilise HasOlapProperties, OlapLocal, OlapLocalConnection, OlapLocalRefresh, OlapSendLocale, OlapRowDrillCount, OlapServerFill, OlapServerNumberFormat, OlapServerFont, OlapServerFontColor, OlapExtraAttributesXmlet OlapChildrenXml

SourceFile stocke la source de connexion de premier niveau tandis que TextSourceFile stocke la source d'importation indépendante textPr ; un TextSourceFile vide revient à SourceFile pour des raisons de compatibilité

TXLSWebTableSelectorKind configure TXLSWebTableSelector, dont les membres Kind, Name, Index, ExtraAttributesXml, ChildrenXml, Assignet Validate préservent les sélecteurs nommés, indexés et de table complète

TXLSWebTableSelectors fournit Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXmlet UnknownChildrenXml

TXLSTextImportFieldType configure TXLSTextImportField, dont les membres FieldType, Position, ExtraAttributesXml, ChildrenXmlet Assigndéfinissent un champ de texte fixe Validate members define one fixed-text field

TXLSTextImportFields fournit Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXmlet UnknownChildrenXml

Membres complets de connexion

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

Les propriétés web sont WebUrl, WebPost, WebEditPage, WebHtmlFormat, WebXml, WebSourceData, WebConsecutive, WebFirstRow, WebXl97, WebTextDates, WebXl2000, WebExtraAttributesXmlet WebChildrenXml

Les propriétés de texte sont TextSourceFile, TextPrompt, TextDelimited, TextCodePage, TextFirstRow, TextCharacterSet, TextQualifier, TextFileType, TextDecimal, TextThousands, TextTab, TextSpace, TextComma, TextSemicolon, TextConsecutive, TextDelimiter, TextExtraAttributesXmlet TextChildrenXml; la préservation de la base de données utilise DbExtraAttributesXml et DbChildrenXml

TXLSConnections.Assign copie une collection, IndexOfId trouve un identifiant de connexion stable, et RootAttributesXml ainsi que UnknownChildrenXml préservent le contenu racine non pris en charge

Paramètres de connexion

TXLSConnectionParameter utilise Name, ParameterType, SqlType, RefreshOnChange, Prompt, CellReference, IntegerValue, DoubleValue, BooleanValue, StringValue, ValueKind, ExtraAttributesXmlet Assign

TXLSConnectionParameters fournit Add, AddExisting, Assign, Delete, Clear, Countet Items

Tables de requête et champs

TXLSQueryTable utilise 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, RefreshExtensionXmlet UnknownChildrenXml, ExtraAttributesXml, RefreshExtraAttributesXml, and RefreshUnknownChildrenXml

TXLSQueryTableField uses Idutilise Name, TableColumnId, DataBound, RowNumbers, FillFormulas, Clipped, ExtraAttributesXml, Assignet Validate

TXLSQueryTableFields fournit Add, AddExisting, Assign, FindById, FindByTableColumnId, NextId, Validate, Deleteet Clear; Countcopie la collection de tables de requête de la feuille de calcul Items; TXLSQueryTables.Assign copie la collection de tables de requête de la feuille

Actualisation explicite des tables de requête

Voir les fournisseurs de requêtes automatiques pour une actualisation explicite sans provider de l'appelant, l'enregistrement, les liaisons natives et les limites d'opérations externes

TXLSXWorksheet.RefreshQueryTable sélectionne une table de requête existante par nom ou par son index de collection en base zéro, et accepte un TXLSQueryTableProvider détenu par l'appelant, une limite AMaxRows positive qui vaut par défaut 1 000 000 de lignes de données, et un callback facultatif TXLSQueryRefreshProgress

Implémentez TXLSQueryTableProvider.Fetch(Connection, Query, MaxRows, out Data, var Abort) pour renvoyer un enregistrement TXLSQueryResultData avec ColumnCount et des Rows rectangulaires de valeurs scalaires Variant ; TXLSQueryResultRow est un tableau de variants et TXLSQueryResultRows un tableau de ces lignes ; les lignes excluent les en-têtes existants et doivent correspondre à la largeur cible, les valeurs numériques, dates, booléennes, chaînes, erreurs, vides et nulls conservent leurs types, et les chaînes commençant par = restent des valeurs littérales

Le provider reçoit des instantanés détachés de métadonnées de connexion et de requête valables uniquement pendant l'appel, et doit respecter la limite de lignes ; la bibliothèque rejette sans troncature les lignes en excès, les matrices inégales, les types de valeurs non pris en charge, les largeurs invalides et les résultats hors de la grille de feuille de 1 048 576 lignes sur 16 384 colonnes

L'actualisation préserve les en-têtes existants et la mise en forme des cellules, efface la queue de données anciennes d'un résultat qui rétrécit, redimensionne une table Excel attachée et les plages de filtre ou de tri prises en charge, met à jour les métadonnées de la table de requête, et invalide les calculs dépendants ; les formules et styles hors de la zone de résultat restent inchangés

Une requête désactivée, une connexion supprimée, des cellules fusionnées qui se chevauchent ou des formules matricielles, une autre table ou un autre résultat de requête, des cellules d'expansion occupées, des colonnes de table calculées, des lignes de totaux, des colonnes de numéros de ligne, un comportement fill-formula ou des colonnes non liées empêchent l'actualisation avant tout changement des cellules de résultat

La progression est signalée avant la récupération, avant l'application des résultats et après chaque ligne appliquée ou effacée ; définissez Abort dans le provider ou le callback de progression pour annuler, et une valeur de retour de 1 indique un succès, 0 une annulation et -1 un échec, avec les codes de diagnostic 1401 et 1400 identifiant l'annulation et l'échec sous xlsOperationRefresh

Une annulation ou des exceptions de provider, de validation ou de callback restaurent les cellules de résultat et les métadonnées de requête ou de table, y compris les handles de cellules existants ; les providers explicites de l'appelant possèdent leur accès externe ; la sélection automatique pour les requêtes Text, ADO, ODBC et Web Windows prises en charge est disponible via le dispatcher du classeur, et l'ouverture d'un classeur ou la préservation des métadonnées RefreshOnLoad n'invoque aucun des deux chemins de provider

Mappages XML et XML personnalisé

TXLSXWorkbook.XmlMaps renvoie TXLSXXmlMaps, et TXLSXWorksheet.XmlCellBindings renvoie la collection de liaisons de la feuille

Membres avancés de clonage, HTML et image

TXLSXRangeClonePart, TXLSXRangeClonePartset TXLSXRangeCloneSourceCounts définissent le clonage de plages sensible aux dépendances. TXLSXWorksheet.CaptureRangeCloneSourceCounts, AuthorizeRepeatedDisjointRangeClones, ResizeTableRowset TileRangeAxisMetadata sont des points d'accroche avancés d'édition structurelle utilisés par l'expansion de rapports compilés et les participants personnalisés

TXLSXHtmlExportSessionState décrit TXLSXHtmlExportSession; utilisez BeginExport, ExportNextSheetet Reset, puis inspectez State, Active, ExportedSheetCountet TotalSheetCount. Définissez TXLSXHtmlExportOptions.IncludeDrawings pour restituer les objets de feuille de calcul pris en charge dans la session HTML

TXLSXImage expose Gamma, ShadowColor, ShadowOpacity, ShadowBlur, ShadowOffsetXet ShadowOffsetY pour le rendu partagé PDF, SVG, HTML, bitmap et métafichier

Voir aussi

• Aperçu de la facade XLSX
• Références externes de classeur
• API de génération de rapports compilés