أعضاء واجهة برمجة تطبيقات XLSX المتقدمة
تغطي هذه الأعضاء أسطح تحرير XLSX العامة الأقل شيوعًا والتي تُكمّل صفحات المرجع الأساسية للمصنف وورقة العمل والنطاق والنمط والمرشح والمخطط
أجزاء ورقة العمل والعرض والخلفية
يعدّل TXLSXWorksheet.SplitPanes وRemoveSplit حالة الأجزاء المقسمة؛ وتكشف SplitRow وSplitCol وPaneStateKind وScrollCol إحداثيات العرض المخزنة
يتحكم DisplayRowColHeaders في ترويسات الصفوف والأعمدة، ويميز GridLinesSet بين اختيار خط الشبكة الصريح والاختيار الافتراضي، ويكشف DefaultFormat مع StyleOverlays عن حالة النمط على مستوى الورقة
تكشف BackgroundImageData وBackgroundImageFormat عن صورة خلفية ورقة العمل، ويوفر BackgroundImageResource حمولة وصف تنسيق للقراءة فقط محايدة بالنسبة للخلفية، ويزيل ClearBackgroundImage الصورة
تحديدات الأجزاء والتمرير
تستخدم GetSelectedAreas والحمل الزائد SelectAreas الذي يعطي الأولوية للأجزاء النوع المشترك TXLSPanePosition، وتحافظ على مناطق A1 المرتبة والمتداخلة، وتعيد لقطات مملوكة للمتصل مع فهرس المنطقة النشطة
تعيد عمليات التحرير البنيوية للصفوف كاملة والأعمدة كاملة تعيين كل تحديدات الأجزاء، وتحافظ على ترتيب الناجين وهوية المنطقة النشطة، وتستخدم بدائل حتمية من الخليفة أو السابق أو خلية الحدود عند إزالة المنطقة النشطة
تستخدم تسوية التحديد وإعادة التعيين البنيوي وبناء اللقطات بانيات تمريرة واحدة ونموًّا هندسيًّا للسعة لمعالجة المناطق الكبيرة بتكلفة خطية مُهَدَّمة
تستخدم TryGetWindowScroll وScrollWindow الأجزاء المنطقية والإحداثيات القائمة على الواحد نفسها مع الاحتفاظ بمواضع تمرير sheetView الكلية وpane السفلية أو اليمنى باستقلال
تترك الأجزاء المفقودة والتحديثات غير الصالحة ورقة العمل دون تغيير؛ انظر تحديدات أجزاء ورقة العمل والتمرير
نطاقات الإبقاء معًا في ترقيم الصفحات
تُعرّف KeepRowsTogether وClearKeepRowsTogether وKeepColumnsTogether وClearKeepColumnsTogether وKeepTogetherCount كتلًا يجب أن تبقى في صفحة واحدة حيث تسمح الهندسة بذلك
تفحص BreakSplitsKeepBlock وColBreakSplitsKeepBlock وKeepBlockBreakRow وKeepColBlockBreakCol كيفية تفاعل فواصل الصفحات المقترحة مع تلك الكتل
أدوات مساعدة لتحرير ورقة العمل
يكتب AddImagePair صورة أساسية مع صورة مرافقة احتياطية مثل SVG وPNG، ويبني AddChartFromRanges مخططًا من نطاقات فئات وقيم مكتوبة، ويعيد CheckDataValidations كل خلية مخالفة
يختبر CheckDataValidation قيمة مرشحة واحدة مقابل كل قاعدة تحقق تغطي خلية، ويعيد -1 عند الصلاحية أو الفهرس القائم على الواحد لأول قاعدة فاشلة، ويثبت المرشح الصالح اختياريًّا وحده
يحلّ GetCellVisibleFormat تنسيق ورقة العمل والصف والعمود وتراكبات النطاق والخلية الصريح الفعلي دون إنشاء خلية فارغة؛ ويجمّع Subtotal نطاقًا مفروزًا حسب التغيرات في عمود واحد ويدرج صيغ مجاميع فرعية وصيغ مجموع كلي اختيارية وتنسيقًا موروثًا ومستويات تخطيط
SortRangeInternal هو نقطة دخول الفرز المستقر المتقدم المستخدمة في عمليات النطاق والتقارير؛ وعادةً ما يُفضّل المتصلون SortRange أو TXLSXRange.Sort
يزيل ClearColWidth وClearRowHeight البُعد الصريح لعمود واحد أو صف واحد فيعود إلى الافتراضي الورقي، مكمّلًا أداتي الفحص HasColWidth / HasRowHeight
التحكم في عقد التخطيط
يعيد TryGetOutlineNode عقدة الملخص الواعية بالاتجاه ونطاق التفاصيل ومستوى التخطيط وحالة الإخفاء وعلامة الطي الصريحة لفهرس صف أو عمود قائم على الواحد
يطوي SetOutlineNodeCollapsed عقدة ملخص واحدة أو يوسعها بأثر حتمي، بينما يطبق SetOutlineDisplayLevel مستوى زر التخطيط القائم على الواحد عبر كل مجموعة مجسدة؛ ويقبل كلاهما معالجة الأبناء xocPreserve أو xocCollapse أو xocExpand
يظل ToggleRowGrouped وToggleColGrouped غلافَي توافق يقبلان أول فهرس تفصيل ويحلّان عقدة الملخص الفعلية من SummaryBelow أو SummaryRight
تُربَط مجموعات صفوف وأعمدة OpenDocument الأصلية عبر table:display، وتنجو من تعديلات البيانات الوصفية والبنية المباشرة، وتتحول إلى علامات عقد ملخص XLSX دون الاحتفاظ بأعلام طي على مستوى الأعضاء؛ انظر هندسة التخطيط المتناثر
الأنماط المسماة وحل أنماط الجداول
يربط TXLSXRange.ApplyNamedStyle نطاقًا بنمط خلية مسمّى؛ ويشتق TXLSXLinkedStyle.AutomaticChoose أجزاء التنسيق المتأثرة من النمط، بينما تختار LinkedParts الخط أو التعبئة أو الحدود أو تنسيق الأرقام أو المحاذاة أو الحماية صراحة
يحدّث تحرير TXLSXNamedStyle.Style الأجزاء المرتبطة دون إهدار التجاوزات المحلية، ويحل GetCellVisibleFormat النتيجة مع تراكبات ورقة العمل وأنماط الجداول دون تجسيد خلايا فارغة
يحدد TXLSXNamedStyles.FindByName موقع إدخال نمط مسمّى باسمه المعروض دون مسح المجموعة يدويًّا
تُحلّ جميع أسماء أنماط الجداول الفاتحة والمتوسطة والداكنة المدمجة الستين إلى تنسيقات أقسام كاملة قائمة على النسق تتشارها مخرجات HTML وPDF والصور والمعاينة والعارض
تحويل الصيغ
يستبدل TXLSXCell.ConvertFormulaToValue صيغة واحدة بقيمتها المخزنة مؤقتًا، ويطبّق TXLSXCells.ConvertFormulasToValues العملية نفسها على مجموعة الخلايا المخزنة
التحقق من إدخال الصيغ
يكشف TXLSXWorkbook.FormulaEntryPolicy وTXLSXWorksheet.ValidateFormulaEntry عن عقد إدخال الصيغ المشترك الخالي من التعديل، ويميز بين النص الفارغ والدوال غير المعروفة والأسماء غير المعروفة وإخفاقات البنية والأهداف غير الصالحة، ويتعرف على دوال المستخدم المسجلة دون استدعائها؛ انظر سياسة التحقق من إدخال الصيغ
تشخيصات تخزين الخلايا
يتحكم TXLSXCells.PackedStorageEnabled في الخلفية المضغوطة RLE التي تستخدمها عمليات الكتابة الكتلية المكتوبة الأنواع المتوافقة بترتيب الصفوف أولاً، ويبلّغ PackedCellCount عن الخلايا المحتفظ بها هناك قبل أن يجسد الوصول على مستوى الكائنات مقابض خلايا مستقرة
يبلّغ GetStorageStatistics عن كتل الصفوف والصفوف المملوءة وعدد البايتات للكائنات والنصوص والصيغ والنص الغني والمضغوط المقدَّر والمضغوط النشط والمخصص والمستخدم وسلاسل الحزم المضغوطة، لدعم قرارات ذاكرة قابلة للقياس؛ وتكشف أعداد حمولات الأنماط وبايتات حمولات الخلايا الفارغة المنسقة التي تم تجنبها عن مشاركة النسخ عند الكتابة مباشرة
تفاصيل التصفية التلقائية
يمسح TXLSXAutoFilterColumn.ClearValueFilters مرشحات القيمة ومجموعة التاريخ مع الإبقاء على إدخال العمود
تصف HasCriteria2 وAndConnector المرشحات المخصصة ثنائية الشرط؛ وتستخدم مرشحات الألوان HasColorFilter وHasColorFilter_CellColor وHasColorFilter_DxfId؛ وتستخدم مرشحات الأيقونات HasIconFilter وHasIconFilter_Set وHasIconFilter_Id
تستخدم المرشحات الديناميكية HasDynamicFilter وHasDynamicFilter_Type وHasDynamicFilter_Val وHasDynamicFilter_ValSet وHasDynamicFilter_MaxVal وHasDynamicFilter_MaxValSet؛ ويحافظ RawXml على حمولة المرشح غير المدعومة
التعبئة المتدرجة
يُضيف TXLSXFill.AddGradientStop نقطة توقف لونية. وتكشف GradientKind وGradientDegree وGradientLeft وGradientTop وGradientRight وGradientBottom وGradientStopCount وGradientStops عن هندسة خطية أو مسارية
تحافظ BackgroundColorTheme وBackgroundColorIndex وBackgroundTintAndShade على ألوان الخلفية غير المعتمدة على RGB، وينشئ TXLSXFills.AddLinearGradient تدرجًا خطيًّا كاملًا ويسجّله
أما TXLSXFill.ForegroundColorTheme وForegroundColorIndex وForegroundTintAndShade فهي نظائر المقدمة، وتحافظ على ألوان المقدمة من النسق وفهرس اللوحة والتظليل بجانب قيمة RGB
المخططات
يكشف TXLSXChart عن PlotGroupCount وChartStyle وDispBlanksAs وPlotVisibleOnly وواجهة التوافق DataLabelsRange التي ينشر أمر ضبطها إلى السلاسل الحالية ويُهيئ السلاسل اللاحقة بينما يعيد أمر جلبها صيغة شائعة لكل سلسلة فقط
ينسخ TXLSXChartPlotGroup.Assign مجموعة رسم؛ وتتحكم ZOrder وBarGrouping وGapWidth وOverlap في ترتيبها وهندسة الأعمدة
يكشف TXLSXChartSeries عن SolidFillHex وSolidFillSet وMarkerSymbol وMarkerSize وMarkerSet وLabelNumFmt وLabelNumFmtSet وLabelPos وLabelPosSet
تستخدم التسميات المأخوذة من الخلايا لكل سلسلة DataLabelsRange وDataLabelsCache وShowDataLabelsRange وShowDataLabelsRangeSet؛ ويحافظ SetPointShowDataLabelsRange وTryGetPointShowDataLabelsRange على تجاوزات رؤية متناثرة صفريّة المؤشر، بينما يحدّث ResolveDataLabelsRange نص ورقة العمل المتاح مرة واحدة لكل توليد مصنف ويحتفظ بذاكرات خارجية مؤقتة دون فتح مصدر بيانات
تُصدر TXLSXChartSeries.CategoriesMultiLevel فئات c:multiLvlStrRef لتسميات محاور هرمية بينما يُبقي الافتراضي على إصدار c:strRef / c:numRef المسطح
يكشف TXLSXChartTrendline عن فترات التنبؤ Intercept وInterceptSet وForward وBackward، بينما يتحكم TXLSXChartAxis.ShowDispUnitsLabel في تسمية وحدات العرض
التنسيقات الشرطية والتحقق من الصحة
يجري TXLSXConditionalFormat.ContainsCellFast فحوصات عضوية مفهرسة، ويُبلّغ HasStyle عن نمط تفاضلي، وتكشف StdDev وEqualAverage وIsPivot عن أعلام القواعد المتقدمة
يعيد TXLSXConditionalFormat.AcquireWriteGuard القيمة IXLSWorkbookWriteGuard الخاصة بالمصنف كي تقدّم تعديلات القواعد الدفعية توليد المصنف مرة واحدة عند الاكتمال
يجري TXLSXDataValidation.ContainsCellFast فحص العضوية المكافئ في نطاق التحقق المفهرس
الجداول والأوراق والروابط والتعليقات والرسومات
تحافظ TXLSXTable.TableType وConnectionId وColumnQueryTableFieldIds وHasHeaderRow على البيانات الوصفية للجداول المدعومة بالاستعلام والخالية من الترويسة
يمسح TXLSXTable.FindFirst وFindNext ورقة عمل يقدمها المتصل بحثًا عن صفوف يساوي عمودها المسمّى قيمة معينة، ويعيد صفًّا قائمًا على الواحد أو 0، مع مقارنات نصية غير حساسة لحالة الأحرف ورقمية ومنطقية
يُنسخ TXLSXSheets.AddCopy ورقة عمل مع الكائنات التابعة لها، ويصل ByPos إلى المجموعة حسب موضع علامة التبويب الحالية
يحافظ TXLSXExternalLink.AddDefinedName وDefinedNameCount على الأسماء الخارجية المخزنة مؤقتًا ويحدد FindDefinedName موقع إدخال بالاسم؛ وتكشف خصائص RelationshipId وSourceSlot وLinkKind للقراءة فقط عن معرف علاقة جزء الارتباط الخارجي والخانة [N] القائمة على الواحد التي تستخدمها الصيغ الخارجية وتصنيف الارتباط (مصنف أو DDE أو OLE أو غير معروف)؛ ويحافظ TXLSXHyperlink.TargetFrame على سياق التصفح الهدف
يحافظ TXLSXDefinedName.UnknownAttributes على الخصائص غير المعروفة في اسم معرَّف كي تنجو الامتدادات غير المدعومة في رحلات الذهاب والإياب
يُحجّم TXLSXComment.AutoSizeFromText شكل التعليق وفق نصه ويزيل ClearFont تشغيلات الخطوط الغنية الصريحة
يخزّن TXLSXImage.SvgData صورة SVG المرافقة ويحدد CameraRange نطاق مصدر صورة مرتبطة؛ ويحافظ TXLSXTextBox.PrstToken على رمز الهندسة الجاهزة في DrawingML
تتشارك الصور الحمولات دون نسخ البايتات: إسناد TXLSXImage.Blob (واجهة IXLSXImageBlob ذات Data وSvgData وCacheKey وContentDigest وSvgContentDigest وByteSize) هو المسار الصفري النسخ لصور التقارير المتكررة، وتُحسب البصمات مرة واحدة لإدخال الوسائط وقت الحفظ، ويبلّغ TXLSXImage.CacheKey وContentDigest للقراءة فقط عن الهوية المسندة؛ ويرفض ذاكرة التقارير المؤقتة مفتاح تخزين مؤقت يُعاد استخدامه ببايتات أو تنسيقات مختلفة
يكشف DrawingObjectCount وDrawingObject ترتيبًا مختلطًا مستقرًّا واحدًا عبر الصور والمخططات وصناديق النص والمراسي الخام المحفوظة والمجموعات؛ ويكشف كل TXLSXDrawingObject عن Kind وParent وChildCount وTextBox ويمكن إعادة ترتيبه بـ BringToFront وSendToBack وBringForward وSendBackward
ينشئ GroupDrawingObjects مجموعة DrawingML واعية بالتحويل من كائنات مختارة ويعيد UngroupDrawingObject أبناءها بترتيبها، بما في ذلك المجموعات المحمَّلة من حزمة موجودة
النظائر الكلاسيكية لورقة العمل
يؤلّف TXLSWorksheet.SetBackgroundImage وClearBackgroundImage وBackgroundImageResource خلفيات أوراق عمل BIFF8 ويزيلها ويفحصها؛ وتُكشف بيانات الصور النقطية كملف BMP قياسي، وتحتفظ التنسيقات الأصلية أو غير المعروفة بحمولتها الخام ورمز تنسيقها، وتتحول الخلفيات المعروفة في الاتجاهين بين محرَّكَي Classic وXLSX
يستبدل TXLSWorksheet.ConvertFormulasToValues الصيغ بالنتائج المخزنة مؤقتًا، وتستورد حمولات OpenRTF الزائدة جدول RTF في الهدف الافتراضي أو الهدف المختار من المتصل، ويختار WriteAutoValue نوع خلية من متغير، ويكشف DefaultFormat عن XF الافتراضي لورقة العمل