ワークブック操作
Workbook API はセルの変更と再計算に加えて、構造編集も扱います。WASM、Native Node、Python は同じ C ABI に沿って広い Workbook API を公開し、CLI は再計算と調査に絞っています。
用語: 0 始まりの座標
バインディングは (sheet, row, col) をすべて 0 から始まる整数で扱います。Sheet1!A1 は (0, 0, 0) です。ロケール依存のアドレス解析を避け、C ABI と一致させるためです。A1 テキストは CLI 引数・数式文字列のように明示的に要求している箇所だけで使います。
シート
const wb = Module.Workbook.createDefault()
try {
wb.addSheet('Inputs')
wb.renameSheet(0, 'Model')
wb.moveSheet(1, 0)
wb.removeSheet(1)
} finally {
wb.delete()
}with Workbook.create_default() as wb:
wb.add_sheet("Inputs")
wb.rename_sheet(0, "Model")
wb.move_sheet(1, 0)
wb.remove_sheet(1)
print(wb.sheet_count(), wb.sheet_name(0))addSheet と renameSheet は、空の名前、31 UTF-16 単位を超える名前、: \ / ? * [ ] のいずれかを含む名前、先頭または末尾がアポストロフィの名前、他のシートと大文字小文字を区別せず重複する名前を拒否し、いずれも kInvalidSheetName を返します。既定を含む win-* の Excel プロファイルでは、大文字小文字を問わず History も拒否します。Mac プロファイルは Mac 版 Excel と同じく受け付けます。先頭または末尾にアポストロフィがある名前を持つ .xlsx / .xlsb ファイルは、Excel が開けないため kIoSheetCorrupt で読み込みに失敗します。
activeSheet() はワークブックが開くシートを { status, index } で返し、setActiveSheet(sheet) で変更します。Python では active_sheet() と set_active_sheet(index) です。この番号はシートの挿入、削除、移動に追随し、設定すると tabSelected もそのシートへ移ります。非表示または完全非表示のシートは kInvalidArgument で拒否されます。アクティブなシートを非表示にするか削除すると、右隣の表示中のシートが、なければ左側で最も近い表示中のシートがアクティブになります。表示中の唯一のシートを非表示にするか削除する操作は kInvalidArgument で失敗し、ワークブックは変更されません。
Excel プロファイルから作成したワークブックに追加したシートは、最初のシートの行メトリクス、ページ余白、phoneticPr を引き継ぎます。これらは作成時点で固定されるため、後からプロファイルを変更（setExcelProfileId() / set_excel_profile_id()）しても、追加するシートが受け取る内容は変わりません。プレーンなワークブックと読み込んだワークブックは、何も引き継がないシートを追加します。
セル
種類ごとに値を設定し、再計算のステータスを確認してからキャッシュ済みの結果を読み出します。各例は、そのコードブロック内でワークブックのライフサイクルを完結させています。
import createFormulon, { ValueKind } from '@libraz/formulon'
const Module = await createFormulon()
const wb = Module.Workbook.createDefault()
try {
wb.setNumber(0, 0, 0, 10)
wb.setBool(0, 0, 1, true)
wb.setText(0, 0, 2, 'sku-001')
wb.setFormula(0, 0, 3, '=SUM(A1:A10)')
wb.setBlank(0, 0, 4)
const recalcStatus = wb.recalc()
if (!recalcStatus.ok) throw new Error(recalcStatus.message)
const result = wb.getValue(0, 0, 3)
if (!result.status.ok) throw new Error(result.status.message)
if (result.value.kind === ValueKind.Number) console.log(result.value.number)
} finally {
wb.delete()
}import { ValueKind, Workbook } from '@libraz/formulon-native'
const wb = Workbook.createDefault()
try {
wb.setNumber(0, 0, 0, 10)
wb.setBool(0, 0, 1, true)
wb.setText(0, 0, 2, 'sku-001')
wb.setFormula(0, 0, 3, '=SUM(A1:A10)')
wb.setBlank(0, 0, 4)
const recalcStatus = wb.recalc()
if (!recalcStatus.ok) throw new Error(recalcStatus.message)
const result = wb.getValue(0, 0, 3)
if (!result.status.ok) throw new Error(result.status.message)
if (result.value.kind === ValueKind.Number) console.log(result.value.number)
} finally {
wb.dispose()
}from formulon import Workbook
with Workbook.create_default() as wb:
wb.set_number(0, 0, 0, 10)
wb.set_bool(0, 0, 1, True)
wb.set_text(0, 0, 2, "sku-001")
wb.set_formula(0, 0, 3, "=SUM(A1:A10)")
wb.set_blank(0, 0, 4)
wb.recalc()
print(wb.get_value(0, 0, 3).to_python())数式を設定しても、その場では計算されない
setFormula() はモデルを書き換えるだけです。結果は recalc()（または partialRecalc()）を呼ぶまで Blank のままになります。編集後に値を読むホストは必ず再計算を実行してください。
範囲を調べる
getFormula(sheet, row, col) は入力時の文字列ではなく、Excel が保存する表記へ正規化した A1 形式の数式を返します。たとえば、1.50 は 1.5、数値リテラルに接する単項の +5 は 5 になり、Excel が削除する空白も取り除かれます。動的配列以前の数式には Excel の暗黙の交差 @ が含まれます。この正規化は定義名、条件付き書式、入力規則の数式にも適用されます。保存テキストに先頭の = がある場合だけ、戻り値にも含まれます。getFormulaR1C1() は保存された数式を解析し、セルを基準に先頭の = なしの R1C1 形式へ整形します。両 JavaScript バインディングの戻り値は { status, formula } で、数式がない場合は formula: null です。Python は get_formula() / get_formula_r1c1() を使い、文字列か None を返します。
公開されている数式設定メソッドは、空でない不正な数式をワークブックへ変更を加える前に拒否します。セル数式、定義名、条件付き書式の数式、入力規則の数式では、C と JavaScript のステータス結果が kParserUnexpectedToken（1000）を返し、Python はホスト側のエラーを送出します。入力時にはタブ、復帰文字、組み込み関数名と ( の間の空白も拒否します。Excel の数値範囲外にあるゼロ以外の数値リテラル（1E308、1E-310 など）は、計算時に #NUM! や 0 になる代わりに同じパーサーエラーになります。入力ファイルにすでに保存されていた不正な数式はラウンドトリップのため文字列を保持し、評価すると #NAME? になり、getFormulaR1C1() は kParserUnexpectedToken を返します。数式設定メソッドがこの状態を作ることはありません。
getCellsInRange(sheet, range, cursor, limit) は { status, cells, nextCursor } を行順で返します。各セルには row、col、formula、現在のキャッシュ値 value があります。範囲は firstRow、firstCol、lastRow、lastCol で指定し、両端を含みます。最初はカーソルを省略し、以後は nextCursor を渡して、null になったら終了します。limit を省略するか 0 にすると、最大 65,536 件を取得します。数式、空白以外の値、スピル先のセルが対象で、書式だけの空白セルは含みません。最新の数式値が必要なら、列挙の前に再計算してください。
Python の get_cells_in_range(sheet, cell_range, cursor=None, limit=None) は MergeRange を受け取り、(cells, next_cursor) を返します。終了時のカーソルは None です。カーソルはページ番号ではなく、続きから読み出すための値として扱ってください。JavaScript のカーソルは非負の安全な整数である必要があります。getMergesInRange() / get_merges_in_range() は指定矩形と交差する結合範囲を列挙します。
getExternalLinks() / get_external_links() は外部リンクレコードをファイル内の順序で列挙します。C 層では fm_workbook_external_link_count と fm_workbook_external_link_at を使います。セル、定義名、条件付き書式、入力規則の数式に未登録のブックを角括弧形式またはパス形式で書くと、既存リンクの番号を変えずにレコードを追加します。大文字・小文字だけが異なる既存ブックは同じレコードを再利用します。
cellCount(sheet) と cellAt(sheet, idx) は、値・数式・書式の設定や setBlank で書き込んだ座標と、スピル先のセルを列挙します。セルをクリアしても格納済みの座標は残り、未書き込みの隙間は数えません。インデックスは [0, cellCount) の連続した整数で、(row, col) の昇順です。Python の iter_cells() と C の fm_workbook_cell_count / fm_workbook_cell_at も同じ仕様です。列挙中はシートを変更しないでください。
構造編集
行・列の挿入 / 削除は影響を受ける数式を自動で書き換えます。
wb.insertRows(/*sheet*/ 0, /*startRow*/ 5, /*count*/ 2)
wb.deleteCols(/*sheet*/ 0, /*startCol*/ 3, /*count*/ 1)wb.insert_rows(0, 5, 2) # sheet, start row, count
wb.delete_cols(0, 3, 1) # sheet, start column, count挿入 / 削除範囲とともに移動する参照は、$ で固定した参照を含めてシフトされます。これは数式をコピーするときの相対参照の動きとは異なる、構造編集による書き換えです。残る範囲は必要に応じて縮小・拡張されます。削除された領域に入ってしまった参照はシフト先がないため、繰り上がってきた別のセルを指すのではなく #REF! になります。挿入した行や列がセル単位の書式を引き継ぐと、書式だけを持つセルが作られるため、cellCount が増えることがあります。
データテーブル、レガシー配列ブロック、ピボットテーブルを分断する行・列の挿入 / 削除、またはそれらやテーブルをグリッドの端より先へ押し出す挿入 / 削除は、Excel と同じく kPreconditionFailed で拒否され、ワークブックは変更されません。ブロック全体を削除する場合は、ブロックごと削除されます。
下のパネルでは、これらの呼び出しを実際のシートに対して実行できます。セルを選ぶと対象の行 / 列がそれに追随し、数式の一覧は操作の前後にワークブックから読み直しています。書き換えられた数式も、壊れた数式も、エンジンが保持しているテキストそのものです。
行と列の挿入 / 削除
行や列を挿入・削除すると、影響を受ける数式はエンジン側で書き換えられます。下の一覧は操作前後にワークブックから読み直した数式そのもので、削除範囲に入った参照は #REF! に変わります。
本物の Formulon エンジン (WASM) がこのページ内で動作します。データは送信されません。
挿入した行は直上の行から行スタイル、ユーザー設定の高さ、セル単位の書式、スパークラインを引き継ぎます。挿入した列は左隣の列から幅、列スタイル、セル単位の書式、スパークラインを引き継ぎます。非表示状態とアウトラインレベルは引き継ぎません。先頭の行または列への挿入には隣接する行・列がないため、引き継ぎはありません。構造編集では、可逆保存のために保持している範囲も移動します。対象は x14 の条件付き書式と入力規則、スパークライングループ、保護範囲、シナリオ、並べ替えの状態、ウォッチ式、エラー無視の範囲、Web 公開範囲です。埋め込み OLE オブジェクトとフォームコントロールの起点は編集前のセルのまま残り、そのことは報告されません。
名前・結合・ハイパーリンク・アウトライン
const check = (s: { ok: boolean; message: string }) => {
if (!s.ok) throw new Error(s.message)
}
for (const [row, v] of [10, 20, 30].entries()) check(wb.setNumber(0, row, 0, v))
check(wb.setDefinedName('Sales', 'Sheet1!$A$1:$A$3')) // workbook scope
check(wb.setDefinedNameScoped('Rate', '0.1', 0)) // local to sheet 0
check(wb.setFormula(0, 0, 1, '=SUM(Sales)*(1+Rate)'))
check(wb.addMerge(0, { firstRow: 4, firstCol: 0, lastRow: 4, lastCol: 2 }))
check(wb.addHyperlink(0, 5, 0, 'https://formulon.libraz.net', 'Docs', '', ''))
check(wb.addHyperlink(0, 6, 0, '', 'Back to top', '', 'Sheet1!A1'))
check(wb.setRowHidden(0, 2, true))
check(wb.setColumnOutline(0, 3, 5, 1))
check(wb.recalc())
console.log(wb.getValue(0, 0, 1).value.number) // 66from formulon import MergeRange
for row, value in enumerate((10, 20, 30)):
wb.set_number(0, row, 0, value)
wb.set_defined_name("Sales", "Sheet1!$A$1:$A$3") # workbook scope
wb.set_defined_name_scoped("Rate", "0.1", 0) # local to sheet 0
wb.set_formula(0, 0, 1, "=SUM(Sales)*(1+Rate)")
wb.add_merge(0, MergeRange(4, 0, 4, 2))
wb.add_hyperlink(0, 5, 0, "https://formulon.libraz.net", display="Docs")
wb.add_hyperlink(0, 6, 0, "", display="Back to top", location="Sheet1!A1")
wb.set_row_hidden(0, 2, True)
wb.set_column_outline(0, 3, 5, 1)
wb.recalc()
print(wb.get_value(0, 0, 1).to_python()) # 66.0setDefinedNameScoped()の第 3 引数は、ワークブック全体なら-1、シートローカルなら 0 始まりのシート番号です。名前の数式は先頭の=なしで保存され、読み戻しも同じ形です。==で始まる数式はkParserUnexpectedTokenで拒否されます。数式に空文字列を渡すと名前を削除します。definedNameCount()/definedNameAt(i)は名前をlocalSheetId付きで列挙します。Python ではiter_defined_names()を使います。setDefinedNameAttrs(name, localSheetId, { comment, hidden })は名前のコメントと非表示フラグを設定します。省略したキーは変更されず、存在しない名前はkInvalidArgumentで失敗します。Python ではset_defined_name_attrs(name, local_sheet_id, comment=..., hidden=...)です。名前の数式を置き換えても、どちらの属性も保持されます。getMerges()はシート上の結合をすべて返します。removeMerge(range)は範囲と重なる結合をすべて削除し、removeMergeAt(i)は番号で 1 つ、clearMerges()はすべてを削除します。- ハイパーリンクは、外部リンクなら
targetに URL を渡し、ブック内のリンクならtargetを空にしてlocationに A1 形式の移動先を渡します。getHyperlinks()で読み出し、removeHyperlink(sheet, row, col)、removeHyperlinkAt()、clearHyperlinks()で削除します。 setRowHidden()/setColumnHidden()とsetRowOutline()/setColumnOutline()が変えるのはレイアウトだけです。アウトラインレベルは Excel が保存できる最大の 7 までの 0〜7 で、それより大きい値はkInvalidArgumentで失敗します。通常の数式は上のSUMのように非表示行も読みます。非表示行を除くのはSUBTOTALの 101〜111 です。setRowCollapsed()/setColumnCollapsed()（Python はset_row_collapsed()/set_column_collapsed()）は、アウトライングループを要約する行または列にcollapsedフラグを設定し、行・列の上書きを返すゲッターもこの値を報告します。<sheetFormatPr outlineLevelRow outlineLevelCol>は保存のたびに（XLSX も XLSB も）最も深い行・列のレベルから導出されるため、Excel ではアウトラインの記号が表示されます。getSheetProtection()/setSheetProtection()は<sheetProtection>のフラグをまとめて読み書きします。enabled: 0を設定すると、保存時に保護を外します。エンジンはフラグを保持するだけで、ロックは強制しません。
Python では各メソッドの snake_case 名を使います。
レイアウト・書式・メタデータ
Workbook.createDefault()（および fm_workbook_create）は、Excel の最小スタイル表から始まります。フォント、罫線、セルスタイルのインデックス 0 と、塗りつぶしのインデックス 0（none）、1（gray125）が最初から存在します。そのため、重複しない最初の addFont() / addBorder() は 1、新しい最初の addFill() は 2 を返します。CJK ロケールの createForProfile() ではインデックス 1 にふりがなフォントがすでに存在する場合があるため、スタイル表が空だと仮定せず、返り値のインデックスを使ってください。
setDefaultFont() はフォントスロット 0 を置き換えます。setFont() は既存の任意のフォントスロットをその場で置き換えます。FontRecord.scheme はテーマフォントへのリンクを読み込みと保存で保持します。セルの実効書式には行や列の設定も使われますが、セルに明示したスタイル 0 はそれらに優先し、書式未設定とは区別されます。
setColumnStyle() / set_column_style() と setRowStyle() / set_row_style() は、両端を含む列または行の範囲にスタイル XF を設定します。clear 版はそのスタイル設定だけを削除し、範囲の幅または高さ、非表示、アウトラインの属性を保持します。後から書き込む未設定セルは列または行のスタイルを受け取り、両方が範囲を覆う場合は行のスタイルが優先されます。
setCellXfIndex(..., 0) は明示的な標準スタイルであり、行や列のスタイルに優先します。clearCellXfIndex() / clear_cell_xf_index() はセルの直接指定を削除し、空白セルが再び行または列のスタイルを継承できるようにします。値、数式、コメントは保持され、存在しないセルは作成されません。空白でないセルは既定 XF の所有を維持します。getEffectiveStyle().source / get_effective_style().source で、継承したスタイルとセルの直接指定を区別できます。
WASM と Native Node の setCellStyle(record) は name、xfId、builtinId、iLevel、hidden、customBuiltin を受け取ります。Python は snake_case のフィールドを持つ CellStyle を set_cell_style() に渡します。XF はセル XF ではなく、名前付きスタイルの基底を指定します。removeCellStyle(name) / remove_cell_style(name) で名前付きスタイルを削除できます。テーマ、解決済みの色、実効書式、表示文字列は 表示とレイアウト を参照してください。
ふりがなは getCellPhoneticRuns() / setCellPhoneticRuns() で UTF-16 のテキスト範囲として順序付きで取得・設定できます。getCellPhoneticProperties() / setCellPhoneticProperties() は、ルビのフォント、かなの形式、配置を読みと表示内容から独立して扱います。セルの値を書き換えると、読みとプロパティの両方が消えます。
ワークブックの設定と保護
<calcPr> の設定には型付きのアクセサがあります。fullPrecision() / setFullPrecision()（false は「表示桁数で計算」）、calcOnSave() / setCalcOnSave()、refMode() / setRefMode()（RefMode.A1 または RefMode.R1C1）です。これらはワークブックの状態を記録するだけで、評価は変わりません。その他の <calcPr> 属性は再保存でも保持されます。date1904() / setDate1904() は日付システムを読み取り、切り替えます。切り替えても保存済みのシリアル値は変換されないため、すべての日付が 1462 日ずれます。Python では full_precision()、calc_on_save()、ref_mode()、date1904() と、対応する set_ メソッドを使います。
getWorkbookProtection() / setWorkbookProtection(protection) は <workbookProtection> を読み取り、置き換えます。対象は lockStructure、lockWindows、lockRevision、従来形式のパスワードハッシュ、workbook* と revisions* のアルゴリズム・ハッシュ・ソルト・スピン回数です。ハッシュはホストが計算した値のまま保存され、エンジンはロックを強制せず、レコードがモデル化していない属性は保持されます。すべて空のレコードを渡すと要素を削除します。Python では WorkbookProtection を使う get_workbook_protection() / set_workbook_protection() です。
シートの <protectedRange> は getProtectedRanges(sheet) で列挙し、addProtectedRange、updateProtectedRange(sheet, index, range)、removeProtectedRange(sheet, index) で管理します。各エントリは name（空でなく、シート内で一意）、"B2:C3 E5" のような A1 形式の sqref リスト、パスワードハッシュ、アルゴリズム、ソルト、スピン回数、セキュリティ記述子のフィールドを持ちます。範囲は行・列の編集に追随して移動します。Python では get_protected_ranges()、add_protected_range()、update_protected_range()、remove_protected_range() です。
テーブルと AutoFilter
WASM、Native Node、Python はワークシートテーブルを作成できます。JavaScript は createTable() / updateTable() / removeTable()、Python は table_create() / table_update() / table_remove() を使います。テーブルの columns は ref の列幅と一致させ、headerRow を有効にする場合も呼び出し側が見出しセルを書き込みます。部分更新では省略したメタデータが保持され、既存テーブルの AutoFilter は ref だけを書き換えて追従します。
tableAt(idx) は、テーブルの <tableStyleInfo>（styleName、showFirstColumn、showLastColumn、showRowStripes、showColumnStripes。要素がない場合は hasStyleInfo が false）、見出し行と集計行の数、各列の集計行の関数・ラベル・数式を読み取ります。Python の iter_tables() も同じフィールドを返します。updateTable() はスタイルと切り替え（styleName を空にするとスタイルを削除）、および headerRow / totalsRow フラグを変更します。Python には table_set_style_info() もあります。setTableColumnTotals(idx, column, { function, label, formula })（Python は table_set_column_totals()）は 1 列の集計行の関数を設定し、'custom' では formula が必須です。集計行が表示されている間は、その列の集計セルが設定に追随します。組み込み関数なら SUBTOTAL(109,Table[Column]) などの 1xx コード、カスタムなら指定した数式、それ以外ならラベルのテキストです。totalsRow を有効にすると、全列の集計セルを書き込みます。
updateTable() に name を渡すと（Python は table_rename()、C は fm_workbook_table_rename）、テーブルの名前と表示名を変更し、旧名を使う構造化参照を、セルの数式、定義名、条件付き書式、入力規則、計算列と集計行の数式、グラフ系列の中で書き換えます。そのテーブルを元にしたピボットキャッシュも追随します。参照としてテーブル名だけを書いた式は書き換えず、更新は全か無かで適用されます。
ユーザー定義のテーブルスタイルとピボットテーブルスタイルは、tableStyleCount() / getTableStyle(index) で列挙し、setTableStyle(style) で名前を指定して追加または置換し、removeTableStyle(name) で削除します。Python は table_style_count()、get_table_style()、set_table_style()、remove_table_style() です。スタイルは、名前、使用できる対象を示す table / pivot フラグ、書式を付けた領域ごとの要素（wholeTable、headerRow、firstRowStripe など）で構成され、各要素は dxfId で差分書式を指します。名前は組み込みスタイル名にできず、同じ種類の要素は 1 つまでです。getTableStyleDefaults() / setTableStyleDefaults({ tableStyle, pivotStyle }) はワークブックの既定のテーブルスタイル名とピボットテーブルスタイル名を読み書きし、空文字列を渡すとその指定を削除します。
ワークシート単位の AutoFilter XML は、完全な <autoFilter> 要素を不透明な値として扱えます。WASM は getSheetAutoFilterXml() / setSheetAutoFilterXml()、Python は get_auto_filter_xml() / set_auto_filter_xml() を公開します。フィルター条件、並べ替え状態、拡張ペイロードはそのまま保持されます。空の値を渡すと AutoFilter を削除し、空でない値は完全な <autoFilter> 要素である必要があります。
WASM・Native Node・Python は、シートとテーブルの型付き AutoFilter も公開します。条件を設定するだけでは行の表示状態は変わりません。評価して結果を確認するか、適用して行を表示・非表示にします。設定・適用・条件の解除・フィルターの削除の違いは フィルターと入力規則 を参照してください。
行・列の挿入 / 削除では、シートとテーブルの AutoFilter 範囲も対象データと一緒に移動します。編集で範囲全体がなくなった場合はフィルターを削除します。範囲内で列を挿入・削除すると、フィルター条件の列位置も移動します。
シートの表示状態は 3 状態です。WASM / Native Node は SheetVisibility.Visible、Hidden、VeryHidden と setSheetVisibility(sheet, visibility)、Python は set_sheet_visibility(sheet, visibility) を使います。getSheetView() / get_sheet_view() は、従来の 2 状態 tabHidden とともに正規の visibility を返します。すでに VeryHidden のシートに setSheetTabHidden(true) を呼んでも Hidden へ降格しません。3 状態の設定メソッドで明示してください。
ワークシートの印刷設定を作成する
WASM と Native Node は、ページ設定、余白、印刷オプション、ヘッダー / フッター、印刷範囲、印刷タイトル、手動の行 / 列改ページを型付きの設定メソッド（setSheetPageSetup()、setSheetPageMargins()、setSheetPrintOptions()、setSheetHeaderFooter()、setSheetPrintArea()、setSheetPrintTitles()、addSheetRowBreak()、addSheetColBreak()）で設定できます。Python は対応する set_page_setup()、set_page_margins()、set_print_options()、set_header_footer()、set_print_area()、set_print_titles()、add_row_break()、add_col_break() を公開します。モデル化していない項目には生の XML を設定するメソッドも使えますが、不正な断片は拒否します。ヘッダー / フッターのセクション文字列は Excel のデコード済み構文を受け取り、文字どおりのアンパサンドは && と書きます。
setRangeXfIndex()（WASM / Native Node）と set_range_xf_index()（Python）は、セルスタイルの XF インデックスを両端を含む矩形へ 1 回で適用します。存在しないセルは書式付きの空白セルとして作成されるため、空の帳票領域にも罫線を設定できます。
属性だけを変更する範囲スタイル
rangeStyleBases() / range_style_bases() は、選択範囲のいずれかのセルが実際に解決するセル XF を昇順で返します。独自の XF を持つセルはその XF、それ以外のセルは行・列のスタイルまたは既定（0）のスタイルに解決します。選択範囲がすべて書式付きセルで覆われていれば 0 は含まれず、全域で行スタイルに隠れる列スタイルも含まれません。属性だけを変更する場合は、まずこの一覧を読み、addFont() / addXf()（Python は add_font() / add_cell_xf()）で変更後の XF を作り、対応する組を remapRangeStyle() / remap_range_style() に渡します。取り消しが必要な操作では先に snapshotRangeStyle() / snapshot_range_style() を取得し、そのバイト列を restoreRangeStyle() / restore_range_style() に渡して書式状態を戻します。
再マッピングは対象となる行・列のスタイルと既存セルの XF を書き換えますが、値と数式は変更しません。通常の有限範囲ではすべてのセルが実体化され、行・列またはワークシート全体の選択では、行が列より優先される関係が変わるセルだけが実体化され、対象軸の空白セルは列挙されません。対応する配列の長さが違う場合、元の XF が重複する場合、変換先がセル XF 表の範囲外の場合、書き込みセル数が 1,048,576 を超える場合は、状態を変更せず失敗します。
入力規則の既定値
addValidation() / add_validation() で allowBlank を省略すると、WASM と Native Node は Python と同じく false を使います。空セルを許可する場合は allowBlank: true（Python は allow_blank=True）を明示してください。showDropDown（Python は show_dropdown）だけは OOXML の意味が反転する真偽値オプションで、ホスト向けの値は正規化されています。
入力候補は validateValue() / validate_value() で保存せずに検証し、既存セルの違反は listInvalidCells() / list_invalid_cells() で調べられます。編集を受け入れるかはホストが判断します。値を設定するメソッドは入力規則を強制しません。詳しくは フィルターと入力規則 を参照してください。
条件付き書式
addConditionalFormat() / add_conditional_format() でルールを追加し、evaluateCfRange() / evaluate_cf_range() で一致するセルを調べます。ルールの種類、差分書式、データバー、カラースケール、アイコンセット、todaySerial 引数については 条件付き書式 を参照してください。
ハイパーリンクの範囲
addHyperlinkRange()（WASM / Native Node）と add_hyperlink_range()（Python）は、(row, col) から (lastRow, lastCol) / (last_row, last_col) までの両端を含む矩形に 1 つのハイパーリンクを追加します。読み出したハイパーリンクにも矩形の終点が含まれ、OOXML と XLSB のどちらでも範囲全体を保持します。
ピボットキャッシュのワークシート参照
API で新しく作成したピボットテーブルは、保存前にキャッシュのワークシートソースを設定する必要があります。WASM / Native Node では pivotCacheSetWorksheetSource(cacheId, { present: true, ref: 'A1:C10', sheet: 'Data' })、Python では set_pivot_cache_worksheet_source(cache_id, PivotWorksheetSource(ref='A1:C10', sheet='Data')) を使います。シートが空でも宣言した範囲があれば十分です。ワークシートソースのない新規キャッシュを保存すると失敗します。ファイルから読み込んだキャッシュには対応するソース情報が残りますが、元がワークシート以外や外部ソースの場合もあります。
ページ分割
paginate(sheet) は、印刷範囲、自動改ページと手動改ページ、物理ページ数を求めます。
const result = wb.paginate(0)
console.log(result.pageCount, result.printArea, result.horizontalBreaks, result.verticalBreaks)const result = wb.paginate(0)
console.log(result.pageCount, result.printArea, result.horizontalBreaks, result.verticalBreaks)result = wb.paginate(0)
print(result.page_count, result.print_area, result.horizontal_breaks, result.vertical_breaks)formulon paginate --sheet 0 input.xlsx結果の座標は 0 始まりで、印刷範囲は両端を含みます。結果には用紙、余白、印刷可能領域、倍率、ページ順、印刷タイトル、ページごとのレイアウト、手動改ページのフラグも含まれます。単位と配置の挙動は 表示とレイアウト を参照してください。
アドホック数式評価
アドホック評価は、数式をどこにも書き込まずに「このセルでこの数式は何を返すか」を求めます。
const result = wb.evaluateFormulaText(/*sheet*/ 0, /*row*/ 0, /*col*/ 0, '=A1+B1')
if (result.status.ok && result.value.kind === ValueKind.Number) {
console.log(result.value.number)
}
const array = wb.evaluateFormulaArray(0, 0, 0, '=SEQUENCE(2)')
if (array.status.ok) console.log(array.rows, array.cols, array.cells)rows = wb.evaluate_formula_array(0, 0, 0, "=SEQUENCE(2)") # list of rows of Value
print([[v.to_python() for v in row] for row in rows])この呼び出しはワークブックを変更せず、依存関係グラフにも登録されません。そのため、評価した数式が後の編集で再計算待ちになることもありません。evaluateFormulaText() は配列の結果を左上の要素に縮約します。=SEQUENCE(3) は 3 行のスピルではなく 1 を返します。配列全体が必要なら evaluateFormulaArray() / evaluate_formula_array() を使います。同じ数式を実際のセルに書き込めば通常どおりスピルします。詳しくは 動的配列 を参照してください。
Python には、ワークブックの文脈でスカラーを返す評価メソッドがありません。evaluate_formula_array() の左上の要素を使うか、新しい 1 シートのワークブックに対して評価するモジュール関数 formulon.eval_formula() を使います。
evaluateConditionalFormula()（WASM と Native Node）と evaluate_cf_formula()（Python）は、条件付き書式の判定式を同じく読み取り専用で評価します。さらにルールの起点から相対参照をずらし、Excel の判定規則（エラー、空白、文字列、数値ゼロは false、それ以外の数値は true）を適用するので、そのセルで実際のルールを評価した結果と一致します。
通常の編集経路とアドホック経路は異なる問いに答えます。前者はあとで読み返せる値を確定させ、後者は使い捨ての「もし」問い合わせです。
実装済み関数を実行時に確認する
WASM / Native Node の wb.functionNames() や MCP の formulon_function_lookup は、実行時に登録されている関数を列挙できます。静的なドキュメントを読むより、対象 Excel バージョンに合わせて毎回確認するほうが確実です。関数選択 UI を作る場合は、mergeFunctionMetadata()（両方の npm パッケージが公開）/ merge_function_metadata()（Python）で、ホストが用意したローカライズ済みの説明をエンジンのメタデータに重ねられます。優先順位は、ロケール別の上書き、エントリの既定値、エンジンの値の順です。