第6章 Office Open XML Language Reference

SpreadsheetML Language Reference

workbook（Workbook）

この要素はSpreadsheetMLのワークブックのルートです。ワークブックの構造は以下のように定義されます。
Sheets
ワークブックにおける、ワークシートの集まりを表します。ワークシートはデータを扱い、格納して使用するための主となる文書です。
Views

SpreadsheetMLは基本的なウィンドウの寸法を定義するワークブックビューとワークブックのポジションの集まりを定義します。また、エンドユーザにそれらのワークブックデータに関する一連のビューを定義するCustom Workbook Viewsの集まりも定義します。ユーザはワークブックの別々のコピーを保存せずに同じワークブックの複数のビューを作成することができます。

Properties
ワークブックには、基本のワークブック設定を格納するいくつかのプロパティの集まりがあります。それらは、使用システム日時やファイル保護設定、計算設定や、スマートタグの振舞いなどです。
Names
セルの表現やセル範囲、関数や一定値の記述を表します。
workbook.xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<workbook
 xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/5/main" 
 xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">
  <fileVersion lastEdited="4" lowestEdited="4" rupBuild="4017"/>
  <workbookPr date1904="1" vbName="ThisWorkbook" defaultThemeVersion="123820"/>
  <bookViews>
    <workbookView xWindow="120" yWindow="45" windowWidth="15135"
      windowHeight="7650" activeTab="4"/>
  </bookViews>
  <sheets>
    <sheet name="Sheet1" sheetId="1" r:id="rId1"/>
    <sheet name="Sheet2" sheetId="2" r:id="rId2"/>
    <sheet name="Sheet5" sheetId="3" r:id="rId3"/>
    <sheet name="Chart1" sheetId="4" type="chartsheet" r:id="rId4"/>
  </sheets>
  <definedNames>
    <definedName name="MyDefinedName">Sheet3!$A$1:$C$12</definedName>
  </definedNames>
  <calcPr calcId="122211" calcMode="autoNoTable" refMode="R1C1" iterate="1"
    fullPrecision="0"/>
  <customWorkbookViews>
    <customWorkbookView name="CustomView1" 
      guid="{CE6681F1-E999-414D-8446-68A031534B57}" maximized="1" xWindow="1" 
      yWindow="1" windowWidth="1024" windowHeight="547" activeSheetId="1"/>
  </customWorkbookViews>
  <pivotCaches>
    <pivotCache cacheId="0" r:id="rId8"/>
  </pivotCaches>
  <smartTagPr embed="1" show="noIndicator"/>
  <smartTagTypes>
    <smartTagType namespaceUri="urn:schemas-openxmlformats-org:office:smarttags" 
      name="date"/>
  </smartTagTypes>
  <webPublishing codePage="1252"/>
</workbook>

Parent List

  • SpreadsheetML Workbookパーツのルート要素です。親要素はありません

Child List

  • bookViews (Workbook Views)
  • calcPr (Calculation Properties)
  • customWorkbookViews (Custom Workbook Views)
  • definedNames (Defined Names)
  • externalReferences (External References)
  • extLst (Future Feature Data Storage Area)
  • fileRecoveryPr (File Recovery Properties)
  • fileSharing (File Sharing)
  • fileVersion (File Version)
  • functionGroups (Function Groups)
  • oleSize (Embedded Object Size)
  • pivotCaches (PivotCaches)
  • sheets (Sheets)
  • smartTagPr (Smart Tag Properties)
  • smartTagTypes (Smart Tag Types)
  • webPublishing (Web Publishing Properties)
  • webPublishObjects (Web Publish Objects)
  • workbookPr (Workbook Properties)
  • workbookProtection (Workbook Protection)

workbookPr (Workbook Properties)

ワークブックレベルで設定するプロパティを定義します。

workbookPr
<workbookPr date1904="1" showObjects="none" saveExternalLinkValues="0"
      defaultThemeVersion="123820"/>

Parent List

  • workbook
Name
allowRefreshQuery（Allow Refresh Query）
Description

アプリケーションが、このワークブックでクエリテーブルをリフレッシュするかどうかを示す論理演算子値を指定します。

trueの場合、アプリケーションがワークブックがロードされるときにクエリテーブルをリフレッシュします。

falseの場合、アプリケーションはクエリテーブルをリフレッシュしません。

Data Type
boolean
Default
false
Use
optional
Name
autoCompressPictures（Auto Compress Pictures）
Description

アプリケーションがワークブックの画像を自動的に圧縮するかどうかをbooleanで指定します。

trueの場合、アプリケーションが自動的にワークブックの画像を圧縮することを示します。画像が圧縮されるとき、アプリケーションは、以下の振る舞いをします。

  • Web用の96dpiと印刷用の200dpiの解決と不要な情報を削除して減らします。

  • 余分な情報を捨てます。例えば、絵が切り取られるか、またはリサイズされたときのパーツはファイルに格納されています。

  • 可能ならば画像を圧縮します。

値が0（off、false）の場合、アプリケーションはこのワークブックで画像を圧縮しません。

Data Type
boolean
Default
true
Use
optional
Name
backupFile（Create Backup File）
Description

アプリケーションがワークブックのバックアップを作成するかどうかをbooleanで指定します。

trueの場合、アプリケーションはセーブのときにバックアップを作成します。

falseの場合、アプリケーションはバックアップを作成しません。

Data Type
boolean
Default
false
Use
optional
Name
checkCompatibility（Check Compatibility On Save）
Description

より古いファイル形式でこのワークブックを保存するとき、アプリケーションが互換性をチェックするかどうかをbooleanで指定します。

trueの場合、古いバイナリ形式で保存するときにアプリケーションが互換性チェックを実行することを示します。

falseの場合、古いバイナリ形式で保存するときにアプリケーションが互換性チェックを実行しないことを示します。

Data Type
boolean
Default
false
Use
optional
Name
codeName（Code Name）
Description

このワークブックを作成したアプリケーションのコードネームを指定します。アプリケーションのリリースにおけるトラックファイルコンテンツにこの属性値を使用します。

Data Type
string
Default
-
Use
optional
Name
date1904（Date 1904）
Description

ワークブックで使用するシステム日付の開始を1904年とするかどうかをbooleanで指定します。

trueの場合、システム日付は1904年を開始とすることを示します。

falseの場合、システム日付の開始は1900年1月1日が開始となることを示します。

Data Type
boolean
Default
false
Use
optional
Name
defaultThemeVersion（Default Theme Version）
Description

ワークブックで適用するためのテーマのデフォルトバージョンを指定します。

defaultThemeVersionの値はアプリケーションに依存します。

Data Type
unsignedInt
Default
-
Use
optional
Name
filterPrivacy（Filter Privacy）
Description

アプリケーションが個人識別情報（PII）のためにワークブックを検分するかどうかをbooleanで指定します。このフラグがセットされると、アプリケーションはユーザーの文書にPIIを挿入する動作に対して警告します。例えば、コメントにユーザー名を挿入することです。

trueの場合、アプリケーションは文書にPIIを挿入するユーザーに警告します。

falseの場合、アプリケーションは文書にPIIを挿入するユーザに警告しません。ワークブックはPIIがあるかどうか点検されません。

Data Type
boolean
Default
false
Use
optional
Name
hidePivotFieldList（Hide Pivot Field List）
Description

フィールドリストがアプリケーションユーザーインタフェースのピボット・テーブルのために表示されるかどうかをbooleanで指定します。

trueの場合、フィールドリストがピボット・テーブルのために表示されることを示します。

falseの場合、フィールドリストはピボット・テーブルのために表示されません。

Data Type
boolean
Default
false
Use
optional
Name
promptedSolutions（Prompted Solutions）
Description

ユーザがSmart Documentコンポーネントをロードすると警告されるかどうかをbooleanで指定します。

trueの場合、ユーザーはSmartDocのロードに対して警告を受けます。

falseの場合、ユーザーは警告を受けません。

Data Type
boolean
Default
false
Use
optional
Name
publishItems（Publish Items）
Description

ワークブックかワークブックアイテムをアプリケーションサーバに発行するかどうかをbooleanで指定します。

trueの場合、ワークブックアイテムが発行されることを示します。

falseの場合、ワークブックが発行されることを示します。

Data Type
boolean
Default
false
Use
optional
Name
refreshAllConnections（Refresh all Connections on Open）
Description

ワークブックがロードされる間、すべてのデータソースへの接続をリフレッシュするかどうかをbooleanで指定します。

Data Type
boolean
Default
false
Use
optional
Name
saveExternalLinkValues（Save External Link Values）
Description

アプリケーションが外部にリンクしている計算式を通して、他のワークブックから検索される値をキャッシュするかどうかをbooleanで指定します。データは保存時にキャッシュされます。

trueの場合、外部にリンクされた計算式からのデータがキャッシュされることを示します。補助パーツは外部のワークブックからのキャッシュされたセルテーブルを含んだ状態で書かれます。

falseの場合は外部にリンクされた計算式からのデータがキャッシュされないことを示します。

Data Type
boolean
Default
true
Use
optional
Name
showBorderUnselectedTables（Show Border Unselected Table）
Description

ワークブックの選択されていないテーブルの周囲に罫線が描かれるかどうかをbooleanで指定します。

trueの場合は選択されていないテーブルの周囲に罫線が描かれます。

falseの場合は選択されていないテーブルの周囲に罫線は描かれません。

Data Type
boolean
Default
true
Use
optional
Name
showObjects（Show Objects）
Description

アプリケーションがワークブックの埋め込まれたオブジェクトをどう表示するかを指定します。

Data Type

string

Enumeration Value

Description

all（All）

ワークブック内のすべてのオブジェクトが表示されます

none（None）

ワークブック内のすべてのオブジェクトは隠されます

placeholders（Show Placeholders）

ワークブック内のオブジェクトのプレースホルダーが表示されます
Default
all
Use
optional
Name
showPivotChartFilter（Show Pivot Chart Filter）
Description

ワークブックのフィルタリングオプションがピボットチャートのために表示されるかどうかをbooleanで指定します。

trueの場合、フィルタリングオプションがピボットチャートのために表示されることを示します。

falseの場合、フィルタリングオプションは表示されません。

Data Type
boolean
Default
false
Use
optional
Name
updateLinks（Update Links Behavior）
Description

ワークブックが開かれるとき、アプリケーションがどう外部のリンクをアップデートするかを指定します。

Data Type

string

Enumeration Value

Description

always（Always Update Links）

他のワークブックへのリンクはすべて更新されます。アプリケーションはユーザーインタフェースにおいて警告（アラート）を表示しません。

never（Never Update Links）

他のワークブックへのリンクはすべて更新されません。アプリケーションはユーザーインタフェースにおいて警告（アラート）を表示しません。

userSet（User Set）

ワークブックがオープンされるとき、他のワークブックへのリンクを更新するかどうかの警告（アラート）を受け取るかどうかをエンドユーザーが指定します。例えば、アプリケーションは設定ダイアログを表示するかもしれません。
Default
userSet
Use
optional

fileVersion（File Version）

この要素はアプリケーションのどのバージョンがファイルに含まれるデータとソースコードにアクセスしたかを追跡するプロパティを定義します。

Parent List

  • workbook
Name
appName（Application Name）
Description

アプリケーション名を指定します。セーブするとき、アプリケーションはappNameに値を書いて、動作を実行したアプリケーションのバージョンを追跡するために、任意にlastEditedとlowestEditedに属性を書くことができます。ワークブックを開くとき、アプリケーションは、appNameの値を調べて、lastEdited、lowestEdited、およびrupBuild属性を解釈する方法を決めることができます。

Data Type
string
Default
-
Use

optional

Name
codeName（Code Name）
Description

ワークブックに関連するコードプロジェクトのGUIDを指定します。

この属性の主な用途はコンパイルされたコードのバージョンを追跡することです。

Data Type

token

"\{[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}\}"

Default
-
Use
optional
Name
lastEdited（Last Edited Version）
Description

ワークブックが最後に保存されたアプリケーションのバージョンを指定します。この値はアプリケーションに依存しています。

Data Type
string
Default
-
Use
optional
Name
lowestEdited（Lowest Edited Version）
Description

ワークブックを保存したアプリケーションの最も初期のバージョンを指定します。この値はファイルの中のすべてのデータを読むことができるアプリケーションがファイルを保存するときにリセットします。この属性はアプリケーションに依存しています。

Data Type
string
Default
-
Use
optional
Name
rupBuild（Build Version）
Description

アプリケーションの追加された計算式リリースを指定します。例えば、ベータ、サービスパック、およびバージョンなどです。

Data Type
string
Default
-
Use
optional

bookViews（Workbook Views）

この要素はワークブックビューの集まりを指定します。それぞれのビューはウィンドウの位置、フィルターオプション、および他の構成を指定することができます。ワークブックのために定義されるビューの数は制限がありません。
bookViews
<bookViews>
  <workbookView showHorizontalScroll="0" showVerticalScroll="0"
    showSheetTabs="0" xWindow="120" yWindow="45" windowWidth="15135" 
    windowHeight="8130" activeTab="2" autoFilterDateGrouping="0"/>
</bookViews>

Parent List

  • workbook

Child List

  • workbookView（Workbook View）

workbookView（Workbook View）

この要素は1つのブックビューを指定します。

ウィンドウ幅と他の寸法の単位はtwipで表されます。計算式は（画面ピクセル）×（20×72）/（論理デバイスdpi）です。

Parent List

  • bookViews

Child List

  • extLst（Future Feature Data Storage Area）
Name
activeTab（Active Sheet Index）
Description

このブックビューにおいてアクティブなシートのインデックス値を指定します。

Data Type
unsignedInt
Default
0
Use
optional
Name
autoFilterDateGrouping（AutoFilter Date Grouping）
Description

ユーザインタフェースでフィルタリングオプションが与えられるとき、日付をグループ化するかどうかをbooleanで指定します。

trueの場合、日付はグループ化されます。

Data Type
boolean
Default
true
Use
optional
Name
firstSheet（First Sheet）
Description

このブックの中の最初のシートのインデックスを指定します。

Data Type
unsignedInt
Default
0
Use
optional
Name
minimized（Minimized）
Description

ブックウィンドウが最小化されるかどうかをbooleanで指定します。

trueの場合ブックウィンドウは最小化されます。

Data Type
boolean
Default
false
Use
optional
Name
showHorizontalScroll（Show Horizontal Scroll）
Description

ユーザーインタフェースで水平スクロールバーを表示するかどうかをbooleanで指定します。

trueの場合に水平スクロールバーは表示されます。

Data Type
boolean
Default
true
Use
optional
Name
showSheetTabs（Show Sheet Tabs）
Description

ユーザーインタフェースでシートタブを表示するかどうかをbooleanで指定します。

trueの場合にシートタブが表示されます。

Data Type
boolean
Default
true
Use
optional
Name
showVerticalScroll（Show Vertical Scroll）
Description

垂直スクロールバーを表示するかどうかをbooleanで指定します。

trueの場合に垂直スクロールバーが表示されます。

Data Type
boolean
Default
true
Use
optional
Name
tabRatio（Sheet Tab Ratio）
Description

ワークブックタブと水平スクロールバーの間の比率を指定します。

この属性のデフォルト値は600です。

Data Type
unsignedInt
Default
600
Use
optional
Name
visibility（Visibility）
Description

ブックビューの状態を指定します。

Data Type

string

Enumeration Value

Description

hidden（Hidden）

ワークシートは不可視状態ですが、ユーザーはユーザーインタフェースから隠されたウインドウを見ることができます。

veryHidden（Very Hidden）

ワークシートは隠され、ユーザーインタフェースからは変更できません。プログラムが処理を行う想定です。

visible（Visible）

ワークブックウィンドウはユーザーから可視の状態です。
Default
visible
Use
optional
Name
windowHeight（Window Height）
Description

ワークブックウィンドウの高さを指定します。この値の単位はtwipです。

Data Type
unsignedInt
Default
-
Use
optional
Name
windowWidth（Window Width）
Description

ワークブックウィンドウの幅を指定します。この値の単位はtwipです。

Data Type
unsignedInt
Default
-
Use
optional
Name
xWindow（Upper Left Corner（X Coordinate）
Description

ブックウィンドウの左上隅にX座標を指定します。この値の単位はtwipです。

Data Type
int
Default
-
Use

optional

Name
yWindow（Upper Left Corner（Y Coordinate）
Description

ブックウィンドウの左上隅にY座標を指定します。この値の単位はtwipです。

Data Type
int
Default
-
Use
optional

sheets（Sheets）

この要素はワークブックにおけるシートの集まりを表します。

SpreadsheetMLでは異なるタイプのシートを作成することができます。

最も一般的なシートタイプはワークシート、またはスプレッドシートと呼ばれます。ワークシートはSpreadsheetMLでデータを格納して扱うために使用する主な文書です。ワークシートは組織化された列と行にあるセルから成っています。

あるワークブックはデータのための1つのシートと、それぞれのタイプの分析のための別のワークシートがあるモジュラー設計であるかもしれません。複雑なモジュラシステムでは何十枚もの特定のタスク専用のシートがあるかもしれません。

sheets要素
<sheets> <sheet name="Sheet1" sheetId="1" r:id="rId1"/>
                     <sheet name="Sheet2" sheetId="2" r:id="rId2"/> <sheet name="Sheet5"
                     sheetId="3" r:id="rId3"/> <sheet name="Chart1" sheetId="4"
                     type="chartsheet" r:id="rId4"/> </sheets>

Parent List

  • workbook

Child List

    sheet（Sheet Information）

sheet（Sheet Information）

この要素はこのワークブックのシートを定義します。シートデータは別のパーツに格納されます。

Parent List

  • sheets
Name

id（Relationship Id）

Namespace: .../officeDocument/2006/relationships

Description

このシートのためのシートデータの識別子を指定します。

Data Type
string
Default
-
Use
required
Name
name（Sheet Name）
Description

シートの名前を指定します。この名前はユニークでなければなりません。

Data Type
string
Default
-
Use
required
Name
sheetId（Sheet Tab Id）
Description

シートのための内部識別子を指定します。この識別子はユニークでなければなりません。

Data Type
unsignedInt
Default
-
Use
required
Name
state（Visible State）
Description

このシートの可視状態を指定します。

Data Type

string

Enumeration Value

Description

hidden（Hidden）

ブックウィンドウは隠されます。しかし、ユーザーインタフェースからユーザーは存在を確認できます。

veryHidden（Very Hidden）

ワークシートは隠され、ユーザーインタフェースからは見ることはできません。プログラムに基づいてのみ利用可能です。

visible（Visible）

ワークブックウィンドウは可視の状態です。
Default
visible
Use
optional

calcPr（Calculation Properties）

この要素は、アプリケーションが計算式の計算処理（算出）を行うにあたって、そのための情報をプロパティのとして定義します。

calcPr（workbook.xml）
<calcPr calcId="122211" calcMode="auto" refMode="R1C1" iterate="1" fullPrecision="0"/>

Parent List

  • workbook
Name
calcCompleted（Calc Completed）
Description

ワークブックが保存される前に、ワークブックデータが再計算されたかどうかをbooleanで指定します。

trueの場合は、保存前に再計算が完了したことを示します。

falseの場合は、保存前に再計算が完了していないことを示します。

Data Type
boolean
Default
true
Use
optional
Name
calcId（Calculation Id）
Description

ワークブックの値を算出するのに使用される算出エンジンのバージョンを指定します。

ワークブックを作成したアプリケーションのバージョンで開いたとき、アプリケーションは変更されたセルの計算式だけを再計算します。ワークブックをより古いバージョンのアプリケーションで開くとき、ワークブックのすべての計算式（すべての変更されたセルと変更されていないセルの計算式）が再計算されます。これは、現在のアプリケーションバージョンのための最適化を補強します。

calcIdの値はアプリケーションに依存します。ただし、SpreadsheetMLの既定では数値を[version][build]の書式でversionをアプリケーション番号、buildを算出エンジンの変更時に変更する値としています。

Data Type
unsignedInt
Default
-
Use
optional
calcPrのプロパティ
<calcPr calcId="122211"/>
Name
calcMode（Calculation Mode）
Description

アプリケーションがいつワークブックの計算式を計算するべきであるかを指定します。

Data Type

string

Enumeration Value

Description

auto (Automatic)

ワークブック内のセル値が変更されたときに、計算式の算出が自動的に実行されます。アプリケーションは、（他のセルに依存するセルを含む）それらのセルを再計算します。

autoNoTable (Automatic Calculation (No Tables))

autoと同様ですが、テーブルに含まれるセルは自動的な算出処理から除外されます。

manual (Manual Calculation Mode)

ワークブックの算出処理実行はユーザーが制御します。たとえば、アプリケーションがユーザーインタフェースで算出処理実行のコマンドを用意する場合などです。
Default
auto
Use
optional
Name
calcOnSave（Calculate On Save）
Description

アプリケーションがワークブックを保存するときに値を再計算するかどうかをbooleanで示します。

trueの場合、再計算が実行されます。

falseの場合は再計算は実行されません。

Data Type
boolean
Default
true
Use
optional
Name
concurrentCalc（Concurrent Calculations）
Description

算出処理がこのワークブックにおいて並行に可能かどうかをbooleanで指定します。

trueの場合に算出処理がこのワークブックにおいて並行に可能であることを示します。

falseの場合、並列での算出処理がこのワークブックにおいて不可能であることを示します。

Data Type
boolean
Default
true
Use
optional
Name
concurrentManualCount（Concurrent Thread Manual Count）
Description

ユーザーが手動で設定する同時計算のプロセスのカウントを指定します。

このプロパティが省略される場合は、アプリケーションによって自動的に設定されます。

Data Type
unsignedInt
Default
-
Use
optional
Name
forceFullCalc（Force Full Calculation）
Description

アプリケーションが完全な再計算を実行するかどうかが、他の算出プロパティによって示されなかったときの動作を示す論理演算子値を指定します。

trueの場合、アプリケーションがワークブックの完全な再計算を実行することを示します。

falseの場合、アプリケーションがワークブックの完全な再計算を実行しないことを示します。

Data Type
boolean
Default
-
Use
optional
Name
fullCalcOnLoad（Full Calculation On Load）
Description

ワークブックを開くオープンされるとき、アプリケーションが完全な再計算を実行するかどうかをbooleanで指定します。ロードと計算が成功した後に、アプリケーションはこの値をfalseに設定するべきです。アプリケーションがワークブックをオープンしている間にセルの計算式や値が別のプロセスによって更新されたなら、アプリケーションはこの値をtrueに設定するべきです。

trueの場合、アプリケーションはワークブックが開かれているときにワークブックの値の完全な再計算を実行することを示します。

falseの場合、アプリケーションはワークブックが開かれているときにワークブックの値の完全な再計算を実行しないことを示します。

この属性が設定されていたとしても、calcModeが手動であるならロード時に完全な再計算は実行されません。

Data Type
boolean
Default
false
Use
optional
Name
fullPrecision（Full Precision Calculation）
Description

ワークブックの計算を実行するときにアプリケーションが使用する精度を示す論理演算子を指定します。

Data Type
boolean
Default
true
Use
optional
Name
refMode（Reference Mode）
Description

ワークブックのセルの参照スタイルを指定します。"A1"のように列と行番号の文字を使う代わりに、このオプションは"R1C1"のように行番号と列番号の両方を使うことを可能にします。

Data Type

string

Enumeration Value

Description

A1（A1 Mode）

ワークブックがA1参照スタイルを使用することを意味します。A1参照スタイルは文字によってカラム（列）を表し、数字によって行を表します。

R1C1（R1C1 Reference Mode）

ワークブックがR1C1参照スタイルを使用することを意味します。R1C1参照スタイルはワークシートのカラム（列）と行の両方を数字で表します。セルのロケーションは行をRの後の番号で表しカラム（列）をCの後の番号で表します。
Default
"A1."
Use
optional

worksheet（Worksheet）

これはワークシートタイプであるシートパーツのルート要素です。

Parent List

  • SpreadsheetML ワークシートパーツのルート要素です。親要素はありません。

Child List

  • autoFilter (AutoFilter Settings)
  • cellWatches (Cell Watch Items)
  • colBreaks (Vertical Page Breaks)
  • cols (Column Information)
  • conditionalFormatting (Conditional Formatting)
  • controls (Embedded Controls)
  • customProperties (Custom Properties)
  • customSheetViews (Custom Sheet Views)
  • dataConsolidate (Data Consolidate)
  • dataValidations (Data Validations)
  • dimension (Worksheet Dimensions)
  • drawing (Drawing)
  • extLst (Future Feature Data Storage Area)
  • headerFooter (Header Footer Settings)
  • hyperlinks (Hyperlinks)
  • ignoredErrors (Ignored Errors)
  • legacyDrawing (Legacy Drawing Reference)
  • legacyDrawingHF (Legacy Drawing Reference in Header Footer)
  • mergeCells (Merge Cells)
  • oleObjects (Embedded Objects)
  • pageMargins (Page Margins)
  • pageSetup (Page Setup Settings）
  • picture (Background Image)
  • printOptions (Print Options)
  • protectedRanges (Protected Ranges)
  • rowBreaks (Horizontal Page Breaks (Row))
  • scenarios (Scenarios)
  • sheetCalcPr (Sheet Calculation Properties)
  • sheetData (Sheet Data)
  • sheetFormatPr (Sheet Format Properties)
  • sheetPr (Sheet Properties)
  • sheetProtection (Sheet Protection Options)
  • sheetViews (Sheet Views)
  • smartTags (Smart Tags)
  • sortState (Sort State)
  • tableParts (Table Parts)
  • webPublishItems (Web Publishing Items)

sheetViews (Sheet Views)

この要素はワークシートビューの集まりを示します。

下の例は1つのシートビューを示します。定義はそのシートがアクティブかつ選択されたシートであり、ビューに分割された枠が適用されていることを示します。また、セルがアクティブセルであるそれぞれの4つの分割ウィンドウの枠を示します。

sheetView
<sheetViews>
  <sheetView tabSelected="1" workbookViewId="0">
    <pane xSplit="2310" ySplit="2070" topLeftCell="C1" 
      activePane="bottomRight"/>
    <selection/>
    <selection pane="bottomLeft" activeCell="A6" sqref="A6"/>
    <selection pane="topRight" activeCell="C1" sqref="C1"/>
    <selection pane="bottomRight" activeCell="E13" sqref="E13"/>
  </sheetView>
</sheetViews>

Parent List

  • dialogsheet
  • worksheet

Child List

  • extLst（Future Feature Data Storage Area）
  • sheetView（Worksheet View）

sheetData（Sheet Data）

セルテーブルを表す、ワークシートパーツの必須要素です。行定義の集合（cols要素）が存在するとき、その直後に記述されます。

Parent List

  • worksheet

Child List

  • row（Row）

row（Row）

この要素は、ワークシートの全体の行に関する情報を表し、ワークシートの中の特定の行のすべてのセル定義を含んでいます。

次の例では、この行はワークシートで行2（r="2"）に関する情報を表し、3つのセル定義を含んでいます。

ワークシートで行2に関する情報を表し、3つのセル定義を含むrow
<row r="2" spans="2:12">
  <c r="C2" s="1">
    <f>PMT（B3/12,B4,-B5）</f>
    <v>672.68336574300008</v>
  </c>
  <c r="D2">
    <v>180</v>
  </c>
  <c r="E2">
    <v>360</v>
  </c>
</row>

Parent List

  • sheetData

Child List

  • c（Cell）
  • extLst（Future Feature Data Storage Area）
Name
customFormat（Custom Format）
Description

行スタイルが適用されるかどうかをbooleanで指定します。

値がtrueの場合に行スタイルが適用されます。

Data Type
boolean
Default
false
Use
optional
Name
customHeight（Custom Height）
Description

行の高さが手動で設定されているかどうかをbooleanで指定します。

値がtrueの場合に、行高さは手動で設定されていることを示します。

Data Type
boolean
Default
false
Use
optional
Name
hidden（Hidden）
Description

行が隠されているかどうかを示す論理演算子値を指定します。

Data Type
boolean
Default
false
Use
optional
Name
ht（Row Height）
Description

行高さをポイントサイズで指定します。この行高さにはマージンやパディングは含まれません。

Data Type
double
Default
-
Use
optional
Name
outlineLevel（Outline Level）
Description

行のアウトラインレベルを指定します。

Data Type
unsignedByte
Default
0
Use
optional
Name
ph（Show Phonetic）
Description

行の音声情報を表示するかどうかをbooleanで指定します。

trueの場合に行の音声情報が表示されます。

Data Type
boolean
Default
false
Use
optional
Name
r（Row Index）
Description

行のインデックスを指定します。

Data Type
unsignedInt
Default
-
Use
optional
Name
s（Style Index）
Description

行のスタイル情報のインデックスを指定します。この属性はcustomFormat属性の値が1である場合のみ有効です。

Data Type
unsignedInt
Default
0
Use
optional
Name
spans（Spans）
Description

spans属性には、シートの中でセルに値が存在する列の範囲を記述できます。この値はアプリケーションによる処理の最適化に使用します。オプションの属性です。

そのr要素が定義する行の中で、空でない列の範囲をX:Yの形で指定します。途中に空のセルを挟む場合、空でない列が存在する最も端の列を範囲の始点、終点とします。

Data Type
string
Default
-
Use
optional

たとえば、セルF8、E9、およびD10がデータを持っていて、ほかの箇所は空であるとします。

列の位置について、インデックス値は、F列が6、E列が5、D列が4となります。このとき空でない列の範囲は、4:6となります。よって、 それらの3つの行（8、9、および10）においてspans属性は"4:6"の値を持つべきです。

セルに値が存在しない行は記述する必要がないため、sheetData要素の子要素rは8、9、10行目のものだけが記述されます。

sheetData
<sheetData>
  <row r="8" spans="4:6">
    <c r="F8">
      <v>1</v>
    </c>
  </row>
  <row r="9" spans="4:6">
    <c r="E9">
      <v>2</v>
    </c>
  </row>
  <row r="10" spans="4:6">
    <c r="D10">
      <v>3</v>
    </c>
  </row>
</sheetData>

また、セルA1とセルJ8がデータを持っていて、残りのセルは空であるとします。A列とJ列の間に空の列が存在しますが、row要素のspans属性には左端A列（1）、右端J列(10)を1:10のように記述すべきです。

セルのA1とJ8のみがデータを持つ
<sheetData>
  <row r="1" spans="1:10">
    <c r="A1">
      <v>1</v>
    </c>
  </row>
  <row r="8" spans="1:10">
    <c r="J8">
      <v>2</v>
    </c>
  </row>
</sheetData>
Name
thickBot（Thick Bottom）
Description

行の下部にmediumまたはthickの罫線があるかどうかを示す論理演算子値を指定します。

Data Type
boolean
Default
false
Use
optional
Name
thickTop（Thick Top Border）
Description

行の上部にmediumまたはthickの罫線があるかどうかを示す論理演算子値を指定します。

Data Type
boolean
Default
false
Use
optional

c（Cell）

この要素はワークシートのセルを表します。セルの位置（参照）、値、データ型、書式、および計算式に関する情報はここで表されます。

以下の例はC6のセルのために格納された情報を示します。スタイルインデックスは'6'であり、値のメタデータインデックスは15です。セルは計算式とその計算式の計算された結果を含みます。

c
<c r="C6" s="1" vm="15">
  <f>CUBEVALUE（"xlextdat9 Adventure Works",C$5,$A6）</f>
  <v>2838512.355</v>
</c>

Parent List

  • row

Child List

  • extLst（Future Feature Data Storage Area）
  • f（Formula）
  • is（Rich Text Inline）
  • v（Cell Value）
Name
cm（Cell Metadata Index）
Description

セルに関連付けられるセルメタデータの0ベースのインデックス値を指定します。メタデータ情報はMetadata Partで見つけられます。セルメタデータは、セルレベルで格納されたその他の情報であり、セルに添付されます（移動、コピー/ペースト、クリアなど）。

Data Type
unsignedInt
Default
0
Use
optional
Name
ph（Show Phonetic）
Description

phoneticPr要素によってふりがなの情報が格納されているとき、アプリケーションがふりがなの情報を示すべきであるかどうかを示す論理演算子値を指定します。 表示する場合、テキストと同じセルの中で表示されて、テキストがどう発音されるべきであるかを示すヒントとして役立ちます。ふりがな以外への用途は推奨されません。

Data Type
boolean
Default
false
Use
optional
Name
r（Reference）
Description

セルのロケーションの参照をA1スタイルで指定します。

Data Type
string
Default
-
Use
optional
Name
s（Style Index）
Description

このセルのスタイルインデックスを指定します。スタイル情報はスタイルパーツに格納されています。

Data Type
unsignedInt
Default
0
Use
optional
Name
t（Cell Data Type）
Description

セルのデータタイプを表します。

Data Type

string

Enumeration Value

Description

b（Boolean）

セルはbooleanタイプの値を含みます。

e（Error）

セルはエラーを含みます。

inlineStr（Inline String）

セルはインラインのRich文字列（書式付文字列）を含みます。すなわち、shared string tableには含まれません。

n（Number）

セルは数値を含みます

s（Shared String）

セルはshared stringを含みます。

str（String）

セルは計算式文字列を含みます。
Default
n
Use
optional
Name
vm (Value Metadata Index)
Description

セルの値に関連付けられた値メタデータのインデックスをゼロベースで指定します。メタデータはメタデータパーツに格納されています。

Data Type
unsignedInt
Default
0
Use
optional