عروض المصنف والاتصالات وخرائط XML

يغطي هذا المرجع البيانات الوصفية القابلة للتحرير للمصنف الواقعة خارج شبكة الخلايا والتي يجب أن تظل متسقة عند تغيّر الأوراق والنطاقات والمرشحات وأجزاء الحزمة

العروض المخصصة الكلاسيكية

TXLSWorksheet.CustomViews كائن TXLSCustomViewsالذي تحافظ أعضاؤه Countو Itemsو Invalidateو SyncToRaw على سجلات العروض المخصصة المكتوبة وغير المعروفة

TXLSCustomView exposes 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و RawRecordData

TXLSCustomViewCellRangeو TXLSCustomViewCellRangesو TXLSCustomViewSelectionInfoو TXLSCustomViewPageBreakو TXLSCustomViewPageBreaks حمولات التحديد وفواصل الصفحات المملوكة للعرض

نوافذ مصنف XLSX

TXLSXWorkbook.WorkbookViews إدخالات TXLSXWorkbookView المرتبة المُهيَّأة بواسطة TXLSXWorkbookViewVisibility

TXLSXWorkbookView	`Assign`, `ActiveTab`و `FirstSheet`و `Visibility`و `Minimized`و `ShowHorizontalScroll`و `ShowVerticalScroll`و `ShowSheetTabs`و `XWindow`و `YWindow`و `WindowWidth`و `WindowHeight`و `TabRatio`و `AutoFilterDateGrouping`و `UnknownAttributes`و `Extensions`
TXLSXWorkbookViews	`Add`و `Insert`و `Delete`و `Move`و `Clear`و `Count`و `Items`

يعيد إدراج الأوراق وحذفها ونقلها تعيين التبويب النشط والأول الظاهر لكل نافذة مع الحفاظ على الهندسة والإعدادات المستقلة للعرض

التحديدات لكل جزء

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 يُهيئ 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و RefreshUnknownChildrenXml

TXLSQueryTableField يستخدم Id, Nameو TableColumnIdو DataBoundو RowNumbersو FillFormulasو Clippedو ExtraAttributesXmlو Assignو Validate

TXLSQueryTableFields يوفر Add, AddExisting, Assignو FindByIdو FindByTableColumnIdو NextIdو Validateو Deleteو Clearو Countو Items؛ ينسخ TXLSQueryTables.Assign مجموعة جداول استعلام ورقة العمل

تحديث جداول الاستعلام الصريح

راجع مزودات الاستعلام التلقائية لمعرفة التحديث الصريح دون مزود من المستدعي والتسجيل وارتباطات المضيف وحدود العمليات الخارجية

يختار TXLSXWorksheet.RefreshQueryTable جدول استعلام قائمًا بالاسم أو بفهرس مجموعته ذي الأساس الصفري ويقبل TXLSQueryTableProvider مملوكًا للمستدعي، وحد AMaxRows موجبًا افتراضه مليون صف بيانات، وcallback اختياريًا من نوع TXLSQueryRefreshProgress

نفّذ TXLSQueryTableProvider.Fetch(Connection, Query, MaxRows, out Data, var Abort) لإعادة سجل TXLSQueryResultData بـ ColumnCount و Rows مستطيلة من قيم Variant قياسية؛ و TXLSQueryResultRow مصفوفة من variants و TXLSQueryResultRows مصفوفة من تلك الصفوف؛ وتستبعد الصفوف الترويسات القائمة ويجب أن تطابق عرض الهدف، وتحفظ القيم العددية والتواريخ و Boolean والسلاسل والأخطاء والقيم الفارغة وnull أنواعَها، وتبقى السلاسل المبدوءة بـ = قيمًا حرفية

يستقبل المزود لقطاتِ metadata اتصال واستعلام منفصلة صالحة خلال الاستدعاء فقط ويجب أن يحترم حد الصفوف؛ وترفض المكتبة الصفوف الزائدة والمصفوفات غير المتساوية وأنواع القيم غير المدعومة والعروض غير الصالحة والنتائج خارج شبكة ورقة العمل البالغة 1,048,576 صفًا في 16,384 عمودًا دون اقتطاع

يحفظ التحديث الترويسات القائمة وتنسيق الخلايا، ويمسح ذيل البيانات القديم لنتيجة منكمشة، ويعيد تحجيم جدول Excel المرتبط ونطاقات التصفية أو الفرز المدعومة، ويحدّث metadata جدول الاستعلام، ويبطل الحسابات التابعة؛ وتبقى الصيغ والأنماط خارج منطقة النتيجة دون تغيير

يمنع استعلام معطل أو اتصال محذوف أو خلايا مدمجة متداخلة أو صيغ مصفوفات أو جدول آخر أو نتيجة استعلام أو خلايا توسيع مشغولة أو أعمدة جداول محسوبة أو صفوف إجماليات أو أعمدة أرقام صفوف أو سلوك fill-formula أو أعمدة غير مرتبطة التحديثَ قبل تغيير خلايا النتيجة

يُبلّغ التقدم قبل الجلب وقبل تطبيق النتائج وبعد كل صف مطبق أو ممسوح؛ واضبط Abort في المزود أو في callback التقدم للإلغاء، وتعني قيمة الإرجاع 1 النجاح و 0 الإلغاء و -1 الفشل، مع رمزَي تشخيص 1401 و 1400 معرِّفَيْن الإلغاء والفشل تحت xlsOperationRefresh

يستعيد الإلغاء أو استثناءات المزود أو التحقق أو الـ callback خلايا النتيجة وmetadata الاستعلام أو الجدول، بما يشمل مقابض الخلايا القائمة؛ ويمتلك مزودات المستدعي الصريحة وصولها الخارجي؛ ويتاح الاختيار التلقائي لاستعلامات Windows المدعومة من نوع Text و ADO و ODBC و Web عبر مُوزِّع المصنف، ولا يستدعي فتح مصنف أو حفظ metadata ‏RefreshOnLoad أيًّا من مسارَي المزود

خرائط XML وXML المخصص

TXLSXWorkbook.XmlMaps كائن TXLSXXmlMaps، ويعيد TXLSXWorksheet.XmlCellBindings مجموعة ربط الورقة

TXLSXXmlDataBinding	يخزن معرّف العلاقة والبيانات الوصفية للتحديث التي تربط الخريطة بجزء XML مخصص `Enabled`TXLSXXmlSchema `DataBindingName`, `FileBinding`, `FileBindingName`, `ConnectionId`, `DataBindingLoadMode`, and `ExtensionXml` mirror the OOXML `dataBinding` يخزن معرّف مخططًا واحدًا ومساحة اسم وXML المخطط المحفوظ
TXLSXXmlSchema	يخزن هوية الخريطة والعنصر الجذري ومساحة الاسم و `Id`الخاصة به `SchemaRef`, `NamespaceUri`, `Language`, and `Xml` round-trip the schema part
TXLSXXmlMap	تخزن هوية الخريطة والعنصر الجذر ومساحة الأسماء، وـ `DataBinding`; import behaviour is configured by `RootElement`, `SchemaId`, `ShowImportExportValidationErrors`, `AutoFit`, `Append`, `PreserveSortAFLayout`, and `PreserveFormat`
TXLSXXmlMaps	`AddSchema`, `AddMap`, `FindSchema`و `FindMap`و `DeleteSchema`و `DeleteMap`و `Clear`و `Validate`و `SelectionNamespaces`و `SchemaCount`و `Schemas`و `MapCount`
TXLSXXmlCellBinding	يربط نطاق ورقة عمل واحدًا بمسار XPath ومعرّف خريطة XML `CellReference`, `XPath`, `XmlDataType`, `MapId`, `XmlCellPropertyId`, `ConnectionId`, and `UniqueName` preserve the full OOXML binding
TXLSXXmlCellBindings	`Add` و `Delete`و `Clear`و `Validate`و `Count`و `Items`
TXLSXCustomXmlPart	`AddSchemaRef` يربط عنصر XML مخصصًا بمرجع مخطط؛ `Xml` holds the item payload, `ItemId` يربط `SchemaRefs` عنصر XML مخصصًا بمرجع مخطط

أعضاء الاستنساخ وHTML والصور المتقدمة

TXLSXRangeClonePartو TXLSXRangeClonePartsو TXLSXRangeCloneSourceCounts استنساخ النطاق الواعي بالتبعية. تُعد TXLSXWorksheet.CaptureRangeCloneSourceCountsو AuthorizeRepeatedDisjointRangeClonesو ResizeTableRowsو TileRangeAxisMetadata خطافات تحرير بنيوي متقدمة تستخدمها توسعة التقارير المُجمَّعة والمشاركون المخصصون

TXLSXHtmlExportSessionState كائن TXLSXHtmlExportSession؛ استخدم BeginExportو ExportNextSheetو Reset، ثم افحص Stateو Activeو ExportedSheetCountو TotalSheetCount. اضبط TXLSXHtmlExportOptions.IncludeDrawings لعرض كائنات ورقة العمل المدعومة في جلسة HTML

TXLSXImage عن Gammaو ShadowColorو ShadowOpacityو ShadowBlurو ShadowOffsetXو ShadowOffsetY لعرض مشترك عبر PDF وSVG وHTML والصورة النقطية والملف الوصفي