進階 XLSX API 成員
這些成員涵蓋較不常見但公開的 XLSX 編輯表面,補足主要的活頁簿、工作表、範圍、樣式、篩選器與圖表參考頁面
工作表窗格、顯示與背景
TXLSXWorksheet.SplitPanes 與 RemoveSplit 編輯分割窗格狀態; SplitRow、 SplitCol、 PaneStateKind與 ScrollCol 公開儲存的檢視座標
DisplayRowColHeaders 控制資料列與資料行標題, GridLinesSet 區分明確的格線選擇與預設值, DefaultFormat 加上 StyleOverlays 則公開工作表層級的樣式狀態
BackgroundImageData 與 BackgroundImageFormat 公開工作表背景影像, BackgroundImageResource 提供後端中立的唯讀承載與格式描述, ClearBackgroundImage 則移除它
窗格選取與捲動
GetSelectedAreas 與以窗格為優先的 SelectAreas 多載使用共用的 TXLSPanePosition 型別,保留有序且可重疊的 A1 範圍,並傳回帶使用中範圍索引的呼叫端自有快照
整列與整欄的結構性編輯會重新映射每個窗格選取,保留存續項目的順序與使用中範圍的身分,並在使用中範圍被移除時,採用確定性的後繼、前驅或邊界儲存格遞補
選取正規化、結構重新映射與快照建構都使用單趟建構器與幾何式容量成長,讓大面積處理達到均攤線性
TryGetWindowScroll 與 ScrollWindow 使用同一組邏輯窗格與 1 起始座標,同時各自獨立保留整體 sheetView 與下/右 pane 的捲動位置
缺少窗格或無效的更新都不會更動工作表;詳見 工作表窗格選取與捲動
分頁保持在一起範圍
KeepRowsTogether、 ClearKeepRowsTogether、 KeepColumnsTogether、 ClearKeepColumnsTogether與 KeepTogetherCount 定義應在幾何允許時留在同一頁的區塊
BreakSplitsKeepBlock、 ColBreakSplitsKeepBlock、 KeepBlockBreakRow與 KeepColBlockBreakCol 檢查建議的分頁符與這些區塊的互動
工作表編輯輔助方法
AddImagePair 寫入主要影像及遞補夥伴(例如 SVG 與 PNG), AddChartFromRanges 從有型別的分類與數值範圍建立圖表, CheckDataValidations 則傳回每個違反的儲存格
CheckDataValidation 針對覆蓋某儲存格的每一條驗證規則測試一個候選值,有效時傳回 -1 ,否則傳回第一條未通過規則的 1 起始索引,並可選擇性地只在實際有效時提交候選值
GetCellVisibleFormat 會解析有效的工作表、列、欄、範圍覆蓋與明確儲存格格式,而不會建立空儲存格; Subtotal 依某一欄的變化將已排序範圍分組,插入小計公式、選擇性的總計公式、繼承的格式與大綱層級
SortRangeInternal 是範圍與報表作業使用的進階穩定排序進入點;呼叫端通常應偏好 SortRange 或 TXLSXRange.Sort
ClearColWidth 與 ClearRowHeight 會移除一欄或一列的明確尺寸,讓它回落到工作表預設值,作為 HasColWidth / HasRowHeight 探測的互補
大綱節點控制
TryGetOutlineNode 會針對 1 起始的列或欄索引,傳回方向感知的摘要節點、明細範圍、大綱層級、隱藏狀態與明確的摺疊標記
SetOutlineNodeCollapsed 冪等地摺疊或展開一個摘要節點; SetOutlineDisplayLevel 則把 1 起始的大綱按鈕層級套用到每個已具體化的群組;兩者都接受 xocPreserve、 xocCollapse或 xocExpand 的子項處理方式
ToggleRowGrouped 與 ToggleColGrouped 仍是相容性包裝,接受第一個明細索引,並依 SummaryBelow 或 SummaryRight
原生的 OpenDocument 列與欄群組透過 table:display對應,能在直接的中繼資料編輯與結構編輯之後存留,並轉換為 XLSX 的摘要節點標記,而不保留成員層級的摺疊旗標;詳見 疏鬆大綱幾何
具名樣式與表格樣式解析
TXLSXRange.ApplyNamedStyle 把範圍連結到具名儲存格樣式; TXLSXLinkedStyle.AutomaticChoose 會從樣式推導受影響的格式部分, LinkedParts 則可明確選取字型、填滿、框線、數字格式、對齊或保護
編輯 TXLSXNamedStyle.Style 會更新連結的部分而不捨棄本機覆寫; GetCellVisibleFormat 會連同工作表覆蓋與表格樣式一起解析結果,不必具體化空白儲存格
TXLSXNamedStyles.FindByName 依顯示名稱尋找具名樣式項目,不必手動掃描集合
全部 60 個內建的淺色、中色與深色表格樣式名稱,都會解析成完整的主題式區段格式,供 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, and BackgroundTintAndShade preserve non-RGB background colors, and TXLSXFills.AddLinearGradient creates and registers a complete linear gradient
TXLSXFill.ForegroundColorTheme與 ForegroundColorIndex保留非 RGB 的背景色彩, ForegroundTintAndShade 則建立並註冊完整的線性漸層
圖表
TXLSXChart 公開 PlotGroupCount、 ChartStyle、 DispBlanksAs、 PlotVisibleOnly,以及相容用的 DataLabelsRange 門面:其 setter 會廣播到現有數列並為之後新增的數列預設,getter 則只在各數列公式一致時傳回共同值
TXLSXChartPlotGroup.Assign 複製繪圖群組; ZOrder、 BarGrouping、 GapWidth與 Overlap 控制其排序與長條幾何
TXLSXChartSeries 公開 SolidFillHex、 SolidFillSet、 MarkerSymbol、 MarkerSize、 MarkerSet、 LabelNumFmt、 LabelNumFmtSet、 LabelPos與 LabelPosSet
數列以儲存格為來源的標籤使用 DataLabelsRange、 DataLabelsCache、 ShowDataLabelsRange與 ShowDataLabelsRangeSet; SetPointShowDataLabelsRange 與 TryGetPointShowDataLabelsRange 維護疏鬆的 0 起始可見性覆寫,而 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 會掃描呼叫端提供的工作表,找出指定名稱欄位等於某值的資料列,傳回 1 起始的列號或 0,字串採不分大小寫比較,另支援數值與布林比較
TXLSXSheets.AddCopy 複製具有相依物件的工作表, ByPos 依目前索引標籤位置存取集合
TXLSXExternalLink.AddDefinedName 與 DefinedNameCount 維護快取的外部名稱, FindDefinedName 依名稱找出一筆項目;唯讀的 RelationshipId、 SourceSlot與 LinkKind 屬性分別暴露外部連結部件的關聯 id、外部公式使用的 1 起始 [N] 槽位,以及連結分類(活頁簿、DDE、OLE 或未知); TXLSXHyperlink.TargetFrame 保留目標瀏覽內容
TXLSXDefinedName.UnknownAttributes 保留已定義名稱上無法識別的屬性,讓不支援的擴充能在往返之間存留
TXLSXComment.AutoSizeFromText 將註解圖案調整為其文字大小, ClearFont 則移除明確的富文字字型執行
TXLSXImage.SvgData 儲存 SVG 夥伴, CameraRange 識別連結圖片的來源範圍; TXLSXTextBox.PrstToken 保留 DrawingML 預設幾何 Token
影像以不複製位元組的方式共用承載:指派 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 暴露,原生或未知格式會保留其原始承載與格式代碼,已知的背景則可在傳統與 XLSX 引擎之間雙向轉換
TXLSWorksheet.ConvertFormulasToValues 將公式取代為快取結果, OpenRTF 多載在預設或呼叫端選取的目標匯入 RTF 資料表, WriteAutoValue 從 Variant 選擇儲存格型別, DefaultFormat 則公開工作表預設 XF