اعضای پیشرفته API XLSX
این اعضا سطوح ویرایش XLSX عمومی اما کمتر رایج را پوشش میدهند که صفحات مرجع اصلی کتاب کار، کاربرگ، محدوده، سبک، فیلتر و نمودار را تکمیل میکنند
صفحههای کاربرگ، نمایش و پسزمینه
TXLSXWorksheet.SplitPanes و RemoveSplit وضعیت صفحه شکسته را ویرایش میکنند؛ SplitRow، SplitCol، PaneStateKind و ScrollCol مختصات نمای ذخیرهشده را در معرض دید قرار میدهند
DisplayRowColHeaders سرفصلهای سطر و ستون را کنترل میکند، GridLinesSet انتخاب صریح خط شبکه را از پیشفرض متمایز میکند و DefaultFormat بههمراه StyleOverlays وضعیت سبک در سطح برگه را در معرض دید قرار میدهند
BackgroundImageData و BackgroundImageFormat تصویر پسزمینه کاربرگ را در معرض دید قرار میدهند، در حالی که ClearBackgroundImage آن را حذف میکند
انتخابهای قاب و پیمایش
GetSelectedAreas و overload قاب-محورِ SelectAreas از نوع مشترک TXLSPanePosition استفاده میکنند، نواحی A1 مرتب و همپوشان را حفظ میکنند و snapshot هایی متعلق به فراخوان را همراه با اندیس ناحیه فعال برمیگردانند
ویرایشهای ساختاری کل-سطر و کل-ستون، همه انتخابهای قاب را بازنگاشت میکنند، ترتیب بازماندهها و هویت ناحیه فعال را حفظ میکنند و وقتی ناحیه فعال حذف شده باشد از جانشین یا پیشین قطعی یا سلول مرزی بهعنوان جایگزین استفاده میکنند
نرمالسازی انتخاب، بازنگاشت ساختاری و ساخت snapshot از سازندههای تکگذره و رشد ظرفیت هندسی برای پردازش بزرگمقیاس با هزینه خطی معدلشده استفاده میکنند
TryGetWindowScroll و ScrollWindow از همان قابهای منطقی و مختصات مبتنی بر 1 استفاده میکنند در حالی که موقعیت اسکرول کلی sheetView و اسکرول pane پایین یا راست را مستقل نگه میدارند
قابهای غایب و بهروزرسانیهای نامعتبر کاربرگ را بدون تغییر میگذارند؛ به انتخابها و پیمایش قاب کاربرگ مراجعه کنید
محدودههای همراه-نگهدار صفحهبندی
KeepRowsTogether، ClearKeepRowsTogether، KeepColumnsTogether، ClearKeepColumnsTogether و KeepTogetherCount بلوکهایی را تعریف میکنند که در صورت امکان هندسی باید در یک صفحه باقی بمانند
BreakSplitsKeepBlock، ColBreakSplitsKeepBlock، KeepBlockBreakRow و KeepColBlockBreakCol بررسی میکنند که شکستهای صفحه پیشنهادی چگونه با آن بلوکها تعامل دارند
کمککنندههای ویرایش کاربرگ
AddImagePair یک تصویر اصلی بههمراه همراه جایگزین مانند SVG و PNG مینویسد، AddChartFromRanges یک نمودار از محدودههای مقوله و مقدار تایپشده میسازد و CheckDataValidations هر سلول متخلف را برمیگرداند
SortRangeInternal نقطه ورود مرتبسازی پایدار پیشرفته است که توسط عملیات محدوده و گزارش استفاده میشود؛ فراخوانندهها معمولاً باید SortRange یا TXLSXRange.Sort را ترجیح دهند
کنترل گرههای نمای کلی
TryGetOutlineNode گره خلاصه جهتآگاه، بازه جزئیات، سطح نمای کلی، وضعیت مخفی و نشانگر جمعشدن صریح را برای یک اندیس سطر یا ستون مبتنی بر 1 برمیگرداند
SetOutlineNodeCollapsed بهصورت idempotent یک گره خلاصه را جمع یا باز میکند و SetOutlineDisplayLevel سطح دکمه نمای کلی مبتنی بر 1 را روی همه گروههای عینیسازیشده اعمال میکند؛ هر دو مدیریت فرزند xocPreserve، xocCollapse یا xocExpand را میپذیرند
ToggleRowGrouped و ToggleColGrouped بهعنوان wrapper های سازگاری میمانند که اندیس اولین جزئیات را میپذیرند و گره خلاصه واقعی را از SummaryBelow یا SummaryRight حل میکنند
گروههای بومی سطر و ستون OpenDocument از طریق table:display نگاشت میشوند، از ویرایشهای مستقیم متادیتا و ساختاری جان سالم به در میبرند و بدون نگهداشتن فلگهای جمعشدن در سطح عضو، به نشانگرهای گره خلاصه XLSX تبدیل میشوند؛ به هندسه نمای کلی sparse مراجعه کنید
استایلهای نامدار و حل استایل جدول
TXLSXRange.ApplyNamedStyle یک محدوده را به یک استایل سلولی نامدار پیوند میزند؛ TXLSXLinkedStyle.AutomaticChoose بخشهای قالب متأثر را از استایل استنتاج میکند و LinkedParts فونت، fill، کادر، قالب عددی، تراز یا حفاظت را صریح انتخاب میکند
ویرایش TXLSXNamedStyle.Style بخشهای پیوندشده را بدون دور ریختن بازنویسیهای محلی بهروزرسانی میکند و GetCellVisibleFormat نتیجه را همراه با همپوشانیهای کاربرگ و استایلهای جدول، بدون عینیسازی سلولهای خالی حل میکند
TXLSXNamedStyles.FindByName یک مدخل استایل نامدار را با نام نمایشیاش پیدا میکند بدون اینکه مجبور به پیمایش دستی مجموعه باشید
هر 60 نام استایل جدول داخلیِ light، medium و dark به قالببندی کامل بخشهای مبتنی بر theme حل میشوند که خروجی HTML، PDF، تصویر، پیشنمایش و viewer بهصورت مشترک از آن استفاده میکنند
تبدیل فرمول
TXLSXCell.ConvertFormulaToValue یک فرمول را با مقدار کششدهٔ آن جایگزین میکند و TXLSXCells.ConvertFormulasToValues همان عملیات را روی مجموعه سلول ذخیرهشده اعمال میکند
اعتبارسنجی ورود فرمول
TXLSXWorkbook.FormulaEntryPolicy و TXLSXWorksheet.ValidateFormulaEntry قرارداد مشترک ورود فرمولِ بدون تغییردهندگی را در معرض میگذارند، متن خالی، توابع ناشناخته، نامهای ناشناخته، خطاهای نحوی و مقاصد نامعتبر را تفکیک میکنند و توابع کاربر ثبتشده را بدون فراخوانیشان میشناسند؛ به سیاست اعتبارسنجی ورود فرمول مراجعه کنید
عیبیابی ذخیرهسازی سلول
TXLSXCells.PackedStorageEnabled بکاند بستهبندی RLE را که نوشتنهای انبوه نوعدارِ سازگار با ترتیب سطر-محور استفاده میکنند کنترل میکند و PackedCellCount سلولهای نگهداشتهشده در آن را گزارش میکند، قبل از اینکه دسترسی در سطح شیء، هندلهای پایدار سلول را عینیسازی کند
GetStorageStatistics بلوکهای سطر، سطرهای پُر و شمارش بایت شیء، متن، فرمول، rich-text، بستهبندیشده تخمینی، بستهبندیشده فعال، تخصیصیافته، استفادهشده و رشتههای بستهبندیشده را برای تصمیمگیریهای قابل اندازهگیری حافظه گزارش میکند؛ شمارش payload های استایل و بایتهای صرفهجوییشده سلولهای خالی استایلی، اشتراک copy-on-write را مستقیماً نشان میدهند
جزئیات فیلتر خودکار
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 یک گرادیان خطی کامل ایجاد و ثبت میکند
نمودارها
TXLSXChart PlotGroupCount، ChartStyle، DispBlanksAs، PlotVisibleOnly و DataLabelsRange را در معرض دید قرار میدهد
TXLSXChartPlotGroup.Assign یک گروه نمودار را کپی میکند؛ ZOrder، BarGrouping، GapWidth و Overlap ترتیب و هندسه میله آن را کنترل میکنند
TXLSXChartSeries SolidFillHex، SolidFillSet، MarkerSymbol، MarkerSize، MarkerSet، LabelNumFmt، LabelNumFmtSet، LabelPos و LabelPosSet را در معرض دید قرار میدهد
TXLSXChartTrendline Intercept، InterceptSet و Backward را در معرض دید قرار میدهد، در حالی که TXLSXChartAxis.ShowDispUnitsLabel برچسب واحدهای نمایش را کنترل میکند
قالبهای شرطی و اعتبارسنجیها
TXLSXConditionalFormat.ContainsCellFast بررسیهای عضویت نمایهشده را انجام میدهد، HasStyle یک سبک تفاضلی را گزارش میدهد و StdDev، EqualAverage و IsPivot پرچمهای قانون پیشرفته را در معرض دید قرار میدهند
TXLSXDataValidation.ContainsCellFast بررسی عضویت معادل در محدوده اعتبارسنجی نمایهشده را انجام میدهد
جداول، برگهها، لینکها، نظرات و ترسیمها
TXLSXTable.TableType، ConnectionId، ColumnQueryTableFieldIds و HasHeaderRow فراداده جدول مبتنی بر پرسوجو و بدون سرفصل را حفظ میکنند
TXLSXSheets.AddCopy یک کاربرگ را با اشیای وابسته کپی میکند و ByPos به مجموعه با موقعیت تب جاری دسترسی پیدا میکند
TXLSXExternalLink.AddDefinedName و DefinedNameCount نامهای خارجی کششده را نگهداری میکنند؛ TXLSXHyperlink.TargetFrame زمینه مرور هدف را حفظ میکند
TXLSXComment.AutoSizeFromText شکل نظر را با متن آن اندازه میکند و ClearFont اجرای فونت صریح متن غنی را حذف میکند
TXLSXImage.SvgData همراه SVG را ذخیره میکند و CameraRange یک محدوده منبع تصویر-پیوندی را شناسایی میکند؛ TXLSXTextBox.PrstToken توکن هندسه ازپیشتنظیم DrawingML را حفظ میکند
معادلهای کاربرگ کلاسیک
TXLSWorksheet.ConvertFormulasToValues فرمولها را با نتایج کششده جایگزین میکند، نسخههای سربارگذاریشدهٔ OpenRTF یک جدول RTF را در هدف پیشفرض یا انتخابشده توسط فراخواننده وارد میکنند، WriteAutoValue یک نوع سلول را از یک Variant انتخاب میکند و DefaultFormat XF پیشفرض کاربرگ را در معرض دید قرار میدهد