สมาชิก API XLSX ขั้นสูง
สมาชิกเหล่านี้ครอบคลุมพื้นผิวการแก้ไข XLSX สาธารณะที่ไม่ค่อยพบแต่เสริมหน้าการอ้างอิงหลักของสมุดงาน, เวิร์กชีต, ช่วง, สไตล์, ตัวกรอง และแผนภูมิ
แพนเวิร์กชีต, การแสดงผล และพื้นหลัง
TXLSXWorksheet.SplitPanes และ RemoveSplit แก้ไขสถานะแพนแบบแยก; SplitRow, SplitCol, PaneStateKind และ ScrollCol เปิดเผยพิกัดมุมมองที่เก็บไว้
DisplayRowColHeaders ควบคุมส่วนหัวแถวและคอลัมน์, GridLinesSet แยกตัวเลือกเส้นกริดที่ชัดเจนจากค่าเริ่มต้น และ DefaultFormat พร้อมกับ StyleOverlays เปิดเผยสถานะสไตล์ระดับชีต
BackgroundImageData และ BackgroundImageFormat เปิดเผยรูปภาพพื้นหลังของเวิร์กชีต, BackgroundImageResource ให้ payload แบบอ่านอย่างเดียวที่เป็นกลางต่อ backend พร้อมคำอธิบายรูปแบบ และ ClearBackgroundImage ลบมันออก
การเลือกพานและการเลื่อนหน้าจอ
GetSelectedAreas กับโอเวอร์โหลด SelectAreas ที่เอาพานมาก่อน ใช้ชนิด TXLSPanePosition ที่ใช้ร่วมกัน คงพื้นที่ A1 แบบมีลำดับและซ้อนทับกันได้ และคืน snapshot ที่เป็นของผู้เรียกพร้อมดัชนีพื้นที่ที่ใช้งานอยู่
การแก้ไขเชิงโครงสร้างทั้งแถวและทั้งคอลัมน์จะแมปการเลือกของทุกพานใหม่ คงลำดับที่เหลือรอดกับตัวตนของพื้นที่ที่ใช้งานอยู่ และใช้ fallback แบบเซลล์ถัดไป เซลล์ก่อนหน้า หรือเซลล์ขอบเขตที่คำนวณได้แน่นอนเมื่อพื้นที่ที่ใช้งานอยู่ถูกลบ
การ normalize การเลือก, การแมปโครงสร้างใหม่ และการสร้าง snapshot ใช้ builder แบบรอบเดียวจบและการขยายความจุแบบเรขาคณิต เพื่อจัดการพื้นที่ขนาดใหญ่ด้วยต้นทุนเชิงเส้นโดยเฉลี่ย
TryGetWindowScroll กับ ScrollWindow ใช้พานตรรกะชุดเดียวกันและพิกัดแบบนับหนึ่ง โดยเก็บตำแหน่ง scroll ของ sheetView โดยรวมกับของ pane ล่างหรือขวาแยกจากกัน
พานที่หายไปและการอัปเดตที่ไม่ถูกต้องจะปล่อยแผ่นงานไว้เหมือนเดิม, ดู การเลือกพานและการเลื่อนหน้าจอของเวิร์กชีต
ช่วง keep-together สำหรับการแบ่งหน้า
KeepRowsTogether, ClearKeepRowsTogether, KeepColumnsTogether, ClearKeepColumnsTogether และ KeepTogetherCount กำหนดบล็อกที่ควรอยู่บนหน้าเดียวเมื่อเรขาคณิตอนุญาต
BreakSplitsKeepBlock, ColBreakSplitsKeepBlock, KeepBlockBreakRow และ KeepColBlockBreakCol ตรวจสอบว่าการแบ่งหน้าที่เสนอโต้ตอบกับบล็อกเหล่านั้นอย่างไร
ตัวช่วยการแก้ไขเวิร์กชีต
AddImagePair เขียนรูปภาพหลักพร้อมคู่แบบย้อนกลับเช่น SVG และ PNG, AddChartFromRanges สร้างแผนภูมิจากช่วงหมวดหมู่และค่าที่มีประเภท และ CheckDataValidations คืนทุกเซลล์ที่ละเมิด
SortRangeInternal คือจุดเริ่มต้นการจัดเรียงที่เสถียรขั้นสูงที่ใช้โดยการทำงานช่วงและรายงาน; ผู้เรียกควรนิยมใช้ SortRange หรือ TXLSXRange.Sort ตามปกติ
CheckDataValidation ทดสอบค่าที่เสนอหนึ่งค่ากับทุกกฎการตรวจสอบที่ครอบเซลล์นั้น คืน -1 ถ้าผ่านหรือคืนดัชนีแบบนับหนึ่งของกฎที่ล้มเหลวตัวแรก และจะ commit เฉพาะค่าที่ผ่านได้ถ้าต้องการ
GetCellVisibleFormat resolve การจัดรูปแบบที่มีผลจริงจากแผ่นงาน, แถว, คอลัมน์, range-overlay และเซลล์โดยตรง โดยไม่สร้างเซลล์ว่างขึ้นมา; Subtotal จัดกลุ่มช่วงที่เรียงแล้วตามการเปลี่ยนแปลงของคอลัมน์ใดคอลัมน์หนึ่ง แล้วแทรกสูตรผลรวมย่อย, สูตรผลรวมทั้งหมด (ถ้าต้องการ), การจัดรูปแบบที่สืบทอด และระดับ outline
ClearColWidth กับ ClearRowHeight ลบขนาดแบบระบุชัดของคอลัมน์หรือแถวหนึ่งเพื่อให้กลับไปใช้ค่าเริ่มต้นของแผ่นงาน เติมเต็มคู่กับตัวตรวจ HasColWidth / HasRowHeight
การควบคุม outline node
TryGetOutlineNode คืน summary node ที่รู้ทิศทาง, ช่วง detail, ระดับ outline, สถานะการซ่อน และตัวมาร์คการย่อแบบระบุชัด สำหรับดัชนีแถวหรือคอลัมน์แบบนับหนึ่ง
SetOutlineNodeCollapsed ย่อหรือขยาย summary node หนึ่งตัวแบบ idempotent ส่วน SetOutlineDisplayLevel ใช้ระดับปุ่ม outline แบบนับหนึ่งกับทุกกลุ่มที่มีอยู่จริง ทั้งคู่รับการจัดการลูกแบบ xocPreserve, xocCollapse หรือ xocExpand
ToggleRowGrouped กับ ToggleColGrouped ยังเป็น wrapper เพื่อความเข้ากันได้ที่รับดัชนี detail ตัวแรกแล้ว resolve summary node จริงจาก SummaryBelow หรือ SummaryRight
กลุ่มแถวและคอลัมน์ของ OpenDocument ต้นฉบับแมปผ่าน table:display, รอดจากการแก้ metadata และโครงสร้างโดยตรง และแปลงเป็นตัวมาร์ค summary node ของ XLSX โดยไม่เก็บแฟล็กการย่อระดับสมาชิก, ดู เรขาคณิต outline แบบ sparse
named style และการ resolve table style
TXLSXRange.ApplyNamedStyle ผูกช่วงเข้ากับ named style ของเซลล์; TXLSXLinkedStyle.AutomaticChoose อนุมานส่วนของฟอร์แมตที่ได้รับผลจากสไตล์ ส่วน LinkedParts เลือกฟอนต์, สีพื้น, เส้นขอบ, number format, การจัดวาง หรือการป้องกันแบบระบุชัด
การแก้ TXLSXNamedStyle.Style อัปเดตส่วนที่ผูกไว้โดยไม่ทิ้ง override ที่เซลล์ตั้งไว้เอง และ GetCellVisibleFormat resolve ผลลัพธ์ร่วมกับ overlay ของแผ่นงานและ table style โดยไม่ทำเซลล์ว่างให้กลายเป็นของจริง
TXLSXNamedStyles.FindByName หารายการ named style ด้วยชื่อที่แสดง โดยไม่ต้องไล่คอลเลกชันเอง
ชื่อ table style ในตัวแบบ light, medium และ dark ทั้ง 60 แบบ resolve เป็นฟอร์แมตแบ่งส่วนที่สมบูรณ์บนฐานธีม ซึ่งเอาต์พุต HTML, PDF, รูปภาพ, พรีวิว และ viewer ใช้ร่วมกัน
การแปลงสูตร
TXLSXCell.ConvertFormulaToValue แทนที่สูตรหนึ่งด้วยค่าที่แคชไว้ และ TXLSXCells.ConvertFormulasToValues ใช้การดำเนินการเดียวกันกับคอลเลกชันเซลล์ที่เก็บไว้
การตรวจสอบการป้อนสูตร
TXLSXWorkbook.FormulaEntryPolicy กับ TXLSXWorksheet.ValidateFormulaEntry เปิดเผยสัญญาการป้อนสูตรแบบไม่แปรสภาพที่ใช้ร่วมกัน แยกแยะข้อความว่าง, ฟังก์ชันไม่รู้จัก, ชื่อไม่รู้จัก, syntax ล้มเหลว และเป้าหมายไม่ถูกต้อง และจดจำฟังก์ชันผู้ใช้ที่ลงทะเบียนไว้โดยไม่เรียกใช้มัน, ดู นโยบายการตรวจสอบการป้อนสูตร
การวินิจฉัยพื้นที่จัดเก็บเซลล์
TXLSXCells.PackedStorageEnabled คุม backend แบบ packed RLE ที่ใช้กับการเขียนแบบมีชนิดข้อมูลจำนวนมากที่เข้ากันได้ และ PackedCellCount รายงานจำนวนเซลล์ที่เก็บอยู่ที่นั่นก่อนที่การเข้าถึงระดับออบเจกต์จะทำ cell handle ที่เสถียรให้เป็นของจริง
GetStorageStatistics รายงานจำนวนบล็อกแถว, แถวที่มีข้อมูล, ออบเจกต์, ข้อความ, สูตร, rich text, แบบ packed โดยประมาณ, packed ที่ใช้งานอยู่, ที่จัดสรร, ที่ใช้ไป และไบต์ของสตริงแบบ packed เพื่อใช้ตัดสินใจเรื่องหน่วยความจำที่วัดได้จริง, จำนวน style payload กับไบต์ที่ประหยัดได้จากเซลล์ว่างที่มีสไตล์ เปิดเผยการแชร์แบบ copy-on-write ได้โดยตรง
รายละเอียด AutoFilter
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 และ facade DataLabelsRange เพื่อความเข้ากันได้ โดย setter จะกระจายค่าไปยัง series ปัจจุบันและใช้เป็นค่าเริ่มต้นของ series ที่สร้างหลังจากนั้น ขณะที่ getter คืนเฉพาะสูตรต่อ series ที่เหมือนกันทั้งหมด
TXLSXChartPlotGroup.Assign คัดลอกกลุ่มพล็อต; ZOrder, BarGrouping, GapWidth และ Overlap ควบคุมลำดับและเรขาคณิตแท่ง
TXLSXChartSeries เปิดเผย SolidFillHex, SolidFillSet, MarkerSymbol, MarkerSize, MarkerSet, LabelNumFmt, LabelNumFmtSet, LabelPos และ LabelPosSet
ป้ายกำกับที่ดึงจากเซลล์ราย series ใช้ DataLabelsRange, DataLabelsCache, ShowDataLabelsRange และ ShowDataLabelsRangeSet; SetPointShowDataLabelsRange กับ TryGetPointShowDataLabelsRange ดูแล override การมองเห็นแบบ sparse เริ่มศูนย์ ส่วน ResolveDataLabelsRange รีเฟรชข้อความของแผ่นงานที่เข้าถึงได้หนึ่งครั้งต่อการสร้างสมุดงาน และเก็บ cache ภายนอกไว้โดยไม่เปิดแหล่งข้อมูล
TXLSXChartSeries.CategoriesMultiLevel ปล่อยหมวดหมู่แบบ c:multiLvlStrRef สำหรับป้ายแกนลำดับชั้น ขณะที่ค่าเริ่มต้นคงการปล่อยแบบแบน c:strRef / c:numRef
TXLSXChartTrendline เปิดเผยช่วงพยากรณ์ Intercept, InterceptSet, Forward และ Backward ในขณะที่ TXLSXChartAxis.ShowDispUnitsLabel ควบคุมป้ายหน่วยแสดงผล
การจัดรูปแบบตามเงื่อนไขและการตรวจสอบ
TXLSXConditionalFormat.ContainsCellFast ทำการตรวจสอบสมาชิกภาพแบบจัดทำดัชนี, HasStyle รายงานสไตล์เชิงอนุพันธ์ และ StdDev, EqualAverage และ IsPivot เปิดเผยแฟล็กกฎขั้นสูง
TXLSXConditionalFormat.AcquireWriteGuard คืน IXLSWorkbookWriteGuard ของสมุดงาน เพื่อให้การแก้กฎเป็นชุดจะเดินเลข generation ของสมุดงานครั้งเดียวเมื่อเสร็จ
TXLSXDataValidation.ContainsCellFast ทำการตรวจสอบสมาชิกภาพช่วงการตรวจสอบแบบจัดทำดัชนีที่เทียบเท่ากัน
ตาราง, ชีต, ลิงก์, หมายเหตุ และภาพวาด
TXLSXTable.TableType, ConnectionId, ColumnQueryTableFieldIds และ HasHeaderRow รักษาข้อมูลเมตาตารางที่รองรับคิวรีและไม่มีส่วนหัว
TXLSXTable.FindFirst กับ FindNext สแกนแผ่นงานที่ผู้เรียกส่งให้เพื่อหาแถวที่คอลัมน์ที่ระบุชื่อเท่ากับค่าที่ให้ คืนแถวแบบนับหนึ่งหรือ 0 โดยเทียบสตริงแบบไม่สนตัวพิมพ์ รวมถึงตัวเลขกับ boolean
TXLSXSheets.AddCopy ทำสำเนาเวิร์กชีตพร้อมออบเจกต์ที่พึ่งพา และ ByPos เข้าถึงคอลเลกชันตามตำแหน่งแท็บปัจจุบัน
TXLSXExternalLink.AddDefinedName กับ DefinedNameCount ดูแลชื่อภายนอกที่แคชไว้ และ FindDefinedName หารายการหนึ่งด้วยชื่อ, พร็อพเพอร์ตี้แบบอ่านอย่างเดียว RelationshipId, SourceSlot และ LinkKind เปิดเผย relationship id ของ external-link part, ช่อง [N] แบบนับหนึ่งที่สูตรภายนอกใช้ และการจำแนกชนิดลิงก์ (workbook, DDE, OLE หรือ unknown); TXLSXHyperlink.TargetFrame รักษาบริบทการเรียกดูเป้าหมาย
TXLSXDefinedName.UnknownAttributes เก็บแอตทริบิวต์ที่ไม่รู้จักบน defined name เอาไว้ ส่วนขยายที่ยังไม่รองรับจึงรอดจากการ round trip
TXLSXComment.AutoSizeFromText ปรับขนาดรูปร่างหมายเหตุให้พอดีกับข้อความ และ ClearFont ลบรันฟอนต์ rich text ที่ชัดเจน
TXLSXImage.SvgData เก็บคู่ SVG และ CameraRange ระบุช่วงแหล่งรูปภาพที่เชื่อมโยง; TXLSXTextBox.PrstToken รักษาโทเคนเรขาคณิต DrawingML ที่ตั้งไว้ล่วงหน้า
รูปภาพแชร์ payload ร่วมกันโดยไม่คัดลอกไบต์: การกำหนด TXLSXImage.Blob (interface IXLSXImageBlob ที่มี Data, SvgData, CacheKey, ContentDigest, SvgContentDigest และ ByteSize) คือเส้นทาง zero-copy สำหรับรูปรายงานที่ใช้ซ้ำ, digest จะถูกคำนวณครั้งเดียวเพื่อ intern มีเดียตอนบันทึก และ TXLSXImage.CacheKey กับ ContentDigest แบบอ่านอย่างเดียวรายงานตัวตนที่กำหนดให้, cache ของรายงานจะปฏิเสธ cache key เดียวกันที่ถูกใช้ซ้ำกับไบต์หรือรูปแบบต่างกัน
DrawingObjectCount กับ DrawingObject เปิดเผยลำดับผสมที่เสถียรหนึ่งชุดครอบรูปภาพ, แผนภูมิ, กล่องข้อความ, raw anchor ที่เก็บรักษา และกลุ่ม, แต่ละ TXLSXDrawingObject เปิดเผย Kind, Parent, ChildCount และ TextBox และจัดลำดับใหม่ได้ด้วย BringToFront, SendToBack, BringForward และ SendBackward
GroupDrawingObjects สร้างกลุ่ม DrawingML ที่รู้เรื่อง transform จากออบเจกต์ที่เลือก และ UngroupDrawingObject คืนลูกของกลุ่มตามลำดับเดิม รวมถึงกลุ่มที่โหลดมาจากแพ็กเกจที่มีอยู่
คู่เทียบเวิร์กชีตแบบคลาสสิก
TXLSWorksheet.SetBackgroundImage, ClearBackgroundImage และ BackgroundImageResource สร้าง, ลบ และตรวจพื้นหลังของแผ่นงาน BIFF8 ข้อมูลบิตแมปถูกเปิดเผยเป็น BMP มาตรฐาน, รูปแบบ native หรือที่ไม่รู้จักจะเก็บ payload ดิบกับรหัสรูปแบบเดิมไว้ และพื้นหลังที่รู้จักแปลงไปกลับระหว่างเอนจิน Classic กับ XLSX ได้
TXLSWorksheet.ConvertFormulasToValues แทนที่สูตรด้วยผลลัพธ์ที่แคชไว้, โอเวอร์โหลด OpenRTF นำเข้าตาราง RTF ที่เป้าหมายเริ่มต้นหรือที่ผู้เรียกเลือก, WriteAutoValue เลือกชนิดเซลล์จากตัวแปร variant และ DefaultFormat เปิดเผย XF เริ่มต้นของเวิร์กชีต