Features

機能

Aspose.Cells FOSS for C++ は、Microsoft Excel を必要とせずに Excel .xlsx ワークブックの作成、読み込み、編集、保存を行うオープンソースの C++ ライブラリです。このライブラリは、少数のコアクラスを中心に構成されたヘッダーオンリーの C++ API を提供します。


ワークブックおよびワークシートの管理

Workbook クラスはすべてのスプレッドシート操作のルートオブジェクトです。これを使用して新しいワークブックを作成したり、既存の XLSX ファイルを読み込んだり、変更をディスクに保存したりできます。

  • Workbook() で新しいワークブックを作成する
  • Workbook(filePath) で XLSX ファイルを読み込む
  • Workbook::Save(fileName) でファイルに保存する
  • Workbook::GetWorksheets() を介してすべてのシートにアクセス
  • Worksheet クラスを介してシートを追加、名前変更、設定

セルの値と数式

Cell クラスは単一のスプレッドシートセルを表します。テキスト、数値、ブール値、数式の読み書きをサポートします。

  • Cell::PutValue(value) と Cell::SetValue(value) を使用して値を書き込む
  • Cell::GetValue() を使用して値を読み取り、CellValue を返す
  • Cell::SetFormula(formula) を使用して数式を設定する — 標準的な Excel 数式構文
  • セルを名前 ("A1") で指定するか、Cells::operator[](cellName) を介して行/列インデックスで指定する

セルのスタイリング

Style クラスを使用してセルにリッチな書式設定を適用します。現在のスタイルは Cell::GetStyle() から取得し、変更して、Cell::SetStyle(style) で再適用します。

  • フォント設定は Style::Font() を通じて行い、Font オブジェクトを返します — 太字、色、サイズ
  • 背景塗りつぶしパターンは Style::SetPattern(FillPattern) と Style::SetForegroundColor(Color) を使用します
  • 罫線設定は Style::Borders() で行います
  • 数値書式文字列は Style::SetNumberFormat(format) を使用します

ページ設定と印刷レイアウト

PageSetup クラスは、用紙サイズ、向き、余白、拡大縮小、ヘッダー/フッターテキストなど、ワークシートの印刷設定を構成できるようにします。

  • PageSetup::SetPaperSize(PaperSizeType) で用紙サイズを設定
  • PageSetup::SetOrientation(PageOrientationType) で印刷の向きを設定
  • 余白を設定: PageSetup::SetTopMargin, SetBottomMargin, SetLeftMargin, SetRightMargin
  • PageSetup::SetFitToPagesTall と SetFitToPagesWide によるページに合わせた拡大縮小

条件付き書式

ConditionalFormattingCollection クラスはルールベースのセル書式設定を管理します。ルールはワークシートの範囲に追加でき、優先順位は自動的に管理されます。

  • ConditionalFormattingCollection::Add() を使用してルールを追加
  • インデックスまたは領域でルールを削除
  • 次の利用可能な優先度を ConditionalFormattingCollection::GetNextPriority() で取得

オートフィルター

AutoFilter クラスは、ワークシート範囲に列レベルのデータフィルターを適用することをサポートします。

  • フィルター範囲を AutoFilter::SetRange(rangeAddress) で設定
  • すべてのアクティブなフィルターを AutoFilter::Clear() でクリア
  • カスタムフィルターは AutoFilterCustomFilter と AutoFilterCustomFilterCollection を使用して管理

名前付き範囲と定義名

DefinedName クラスは、ワークブックレベルまたはシートレベルの名前付き数式と範囲を保存し、数式やコードで再利用できるようにします。

  • 定義された名前を DefinedName::GetName() で取得
  • 数式(範囲アドレス)を DefinedName::GetFormula() / SetFormula(formula) で取得または設定
  • DefinedName::GetLocalSheetIndex() を使用して特定のシートにスコープを限定する

XLSX フォーマットのサポート

形式LoadSave
XLSX✔✔
CSV✔—

すべてのロードおよび保存操作は Workbook::Save(fileName) のオーバーロードを使用します。デフォルトでは、形式はファイル拡張子から推測されます。


API Reference の概要

クラス説明
Workbookルートスプレッドシートオブジェクト — 作成、読み込み、そして XLSX ファイルを保存
Worksheet単一ワークシート — 名前、セル、ページ設定、オートフィルタ
Cell単一セル — 値、数式、そしてスタイル操作
Styleセルスタイルファサード — フォント、塗りつぶし、罫線、数値形式
Fontフォント設定 — 太字、色、サイズ
PageSetup印刷レイアウト — 用紙サイズ、向き、余白、スケーリング
ConditionalFormattingCollection条件付き書式ルールのコレクション
AutoFilterワークシート範囲の列単位オートフィルタ
DefinedName名前付き範囲または数式定義

参照

 日本語