高度な 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 は、ジオメトリが許す限り 1 ページに残す必要があるブロックを定義します

BreakSplitsKeepBlock、 ColBreakSplitsKeepBlock、 KeepBlockBreakRow、および KeepColBlockBreakCol は、提案された改ページがこれらのブロックとどのように相互作用するかを検査します

ワークシート編集ヘルパー

AddImagePair は、SVG や PNG などのフォールバック コンパニオンと共にプライマリ画像を書き込み、 AddChartFromRanges は型付きカテゴリ範囲と値範囲からグラフを構築し、 CheckDataValidations は違反しているすべてのセルを返します

CheckDataValidation は、1 つの候補値をセルをカバーするすべての入力規則ルールに対して検査し、有効なら -1 を、それ以外なら最初に失敗したルールの 1 から始まるインデックスを返します。有効な候補だけを確定させることもできます

GetCellVisibleFormat は、空のセルを作成することなく、ワークシート、行、列、範囲オーバーレイ、明示的なセル書式の実効値を解決します。 Subtotal は、1 つの列の変化でソート済み範囲をグループ化し、小計数式、オプションの総計数式、継承された書式、アウトライン レベルを挿入します

SortRangeInternal は、範囲およびレポート操作で使用される高度な安定ソートのエントリ ポイントです。通常、呼び出し側は SortRange または TXLSXRange.Sort

ClearColWidth と ClearRowHeight は、1 つの列または行の明示的な寸法を削除してシートの既定値にフォールバックさせ、 HasColWidth / HasRowHeight のプローブを補完します

アウトライン ノードの制御

TryGetOutlineNode は、1 から始まる行または列のインデックスに対して、方向を考慮した集計ノード、詳細範囲、アウトライン レベル、非表示状態、明示的な折りたたみマーカーを返します

SetOutlineNodeCollapsed は 1 つの集計ノードを冪等に折りたたんだり展開したりし、 SetOutlineDisplayLevel は 1 から始まるアウトライン ボタン レベルを実体化されたすべてのグループに適用します。どちらも xocPreserve、 xocCollapse、 xocExpand の子扱いを受け付けます

ToggleRowGrouped と ToggleColGrouped は互換性ラッパーのままです。最初の詳細インデックスを受け付け、 SummaryBelow または SummaryRight

ネイティブの OpenDocument の行と列のグループは table:displayを通じてマップされ、直接的なメタデータ編集と構造編集を生き延び、メンバー レベルの折りたたみフラグを保持せずに XLSX の集計ノード マーカーへ変換されます。詳細は スパースなアウトライン ジオメトリ

名前付きスタイルとテーブル スタイルの解決

TXLSXRange.ApplyNamedStyle は、範囲を名前付きセル スタイルにリンクします。 TXLSXLinkedStyle.AutomaticChoose はスタイルから影響を受ける書式パーツを導出し、 LinkedParts はフォント、塗りつぶし、罫線、数値書式、配置、保護を明示的に選択します

Editing TXLSXNamedStyle.Style の編集は、ローカルの上書きを破棄せずにリンクされたパーツを更新します。 GetCellVisibleFormat は、空白セルを実体化せずに、ワークシートのオーバーレイやテーブル スタイルと共に結果を解決します

TXLSXNamedStyles.FindByName は、コレクションを手動で走査することなく、表示名で名前付きスタイル エントリを見つけます

組み込みの light、medium、dark 全 60 のテーブル スタイル名は、HTML、PDF、画像、プレビュー、ビューアー出力で共有される、テーマに基づく完全なセクション書式に解決されます

数式変換

TXLSXCell.ConvertFormulaToValue は 1 つの数式をキャッシュされた値に置き換え、 TXLSXCells.ConvertFormulasToValues は同じ操作を格納されたセル コレクションに適用します

数式入力の検証

TXLSXWorkbook.FormulaEntryPolicy と TXLSXWorksheet.ValidateFormulaEntry は、共有された変更を伴わない数式入力コントラクトを公開し、空のテキスト、未知の関数、未知の名前、構文エラー、無効なターゲットを区別し、呼び出さずに登録済みのユーザー関数を認識します。詳細は 数式入力の検証ポリシー

セル ストレージの診断

TXLSXCells.PackedStorageEnabled は、互換性のある行優先の型付き一括書き込みで使用されるパック RLE バックエンドを制御し、 PackedCellCount は、オブジェクト レベルのアクセスが安定したセル ハンドルを実体化する前にそこに保持されているセル数を報告します

GetStorageStatistics は、行ブロック、入力済み行、オブジェクト、テキスト、数式、リッチ テキスト、推定パック、アクティブ パック、割り当て済み、使用中、パック文字列のバイト数を報告し、測定可能なメモリ判断を支援します。スタイル ペイロードの数と回避されたスタイル付き空白ペイロードのバイト数は、コピー オン ライトの共有を直接公開します

オートフィルターの詳細

TXLSXAutoFilterColumn.ClearValueFilters は、列エントリを保持したまま、値フィルターと日付グループ フィルターをクリアします

HasCriteria2 と AndConnector は 2 条件のカスタム フィルターを説明します。色フィルターは 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 が、完全なリニア グラデーションを作成して登録します

TXLSXFill.ForegroundColorTheme、および ForegroundColorIndexは、非 RGB の背景色を保持し、 ForegroundTintAndShade は、完全な線形グラデーションを作成して登録します

グラフ

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 はスパースな 0 から始まる表示オーバーライドを管理し、 ResolveDataLabelsRange はワークブックの生成ごとに 1 回アクセス可能なワークシート テキストを更新し、データ ソースを開かずに外部キャッシュを保持します

TXLSXChartSeries.CategoriesMultiLevel は、階層的な軸ラベルのために c:multiLvlStrRef カテゴリを出力します。既定ではフラットな c:strRef / c:numRef 出力が保持されます

TXLSXChartTrendline は、 Intercept、 InterceptSet、および予測期間の Forwardと Backward を公開し、 TXLSXChartAxis.ShowDispUnitsLabel は表示単位ラベルを制御します

条件付き書式と入力規則

TXLSXConditionalFormat.ContainsCellFast はインデックス付きメンバーシップ チェックを実行し、 HasStyle は差分スタイルを報告し、 StdDev、 EqualAverage、および IsPivot は高度な規則フラグを公開します

TXLSXConditionalFormat.AcquireWriteGuard はワークブックの IXLSWorkbookWriteGuard を返すため、バッチ化された規則編集は完了時にワークブックの生成を 1 回だけ進めます

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 のプリセット ジオメトリ トークンを保持します

画像はバイトをコピーせずにペイロードを共有します。 TXLSXImage.Blob （ IXLSXImageBlob 、 Data、 SvgData、 CacheKey、 ContentDigest、 SvgContentDigestを持つ ByteSizeインターフェース）の代入は、繰り返し使われるレポート画像のためのゼロコピー パスです。ダイジェストは保存時のメディア インターン化のために 1 回だけ計算され、読み取り専用の TXLSXImage.CacheKey と ContentDigest が割り当てられた ID を報告します。レポート キャッシュは、異なるバイトやフォーマットで再利用されるキャッシュ キーを拒否します

DrawingObjectCount と DrawingObject は、画像、グラフ、テキスト ボックス、保持された raw アンカー、グループにわたる 1 つの安定した混在順序を公開します。各 TXLSXDrawingObject は Kind、 Parent、 ChildCount、 TextBoxを公開し、 BringToFront、 SendToBack、 BringForward、 SendBackward

GroupDrawingObjects は、選択されたオブジェクトから変換を考慮した DrawingML グループを作成し、 UngroupDrawingObject は既存パッケージから読み込まれたグループを含めて、子を順序どおりに復元します

クラシック ワークシートの対応物

TXLSWorksheet.SetBackgroundImage、 ClearBackgroundImage、および BackgroundImageResource は、BIFF8 ワークシートの背景を作成、削除、検査します。ビットマップ データは標準の BMP として公開され、ネイティブまたは未知の形式は raw ペイロードとフォーマット コードを保持し、既知の背景はクラシック エンジンと XLSX エンジンの間で双方向に変換されます

TXLSWorksheet.ConvertFormulasToValues は数式をキャッシュされた結果に置き換え、 OpenRTF オーバーロードは既定または呼び出し側が選択したターゲットに RTF テーブルをインポートし、 WriteAutoValue はバリアントからセル型を選択し、 DefaultFormat はワークシートの既定 XF を公開します

関連項目

• XLSX ファサードの概要
• 追加の XLSX ファサード API メンバー
• ワークブックのビュー、接続、XML マップ