diff --git a/AGENTS.md b/AGENTS.md index 989dfc2..c723d58 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -35,7 +35,7 @@ ### Мост `.doc` → `.docx` (`internal/doc`) -Нормативный источник — `docs/standards/doc/` ([MS-DOC], [MS-CFB], [MS-OLEPS], [MS-ODRAW]; [MS-ODRAWXML] лежит в `docs/standards/docx/`), ссылки — с номерами секций. Новых runtime-зависимостей нет (POI/POIFS — test-scope). Публичные точки: `DocToDocx.convert(byte[])` (вызывает `WordPdfConverter`) и `DocToDocx.countPages(byte[])` (вызывает `WordPdfValidator.checkPageCountDoc`); общий разбор — `DocFile` (CFB → потоки WordDocument / 0Table|1Table / Data + FIB + piece table). 16 из 18 классов package-private; наружу — `DocToDocx` и `CfbReader`. +Нормативный источник — [MS-DOC] в `docs/standards/doc/`, общее OLE-окружение ([MS-CFB], [MS-OLEPS], [MS-ODRAW]) в `docs/standards/binary/`, [MS-ODRAWXML] в `docs/standards/ooxml/`, ссылки — с номерами секций. Новых runtime-зависимостей нет (POI/POIFS — test-scope). Публичные точки: `DocToDocx.convert(byte[])` (вызывает `WordPdfConverter`) и `DocToDocx.countPages(byte[])` (вызывает `WordPdfValidator.checkPageCountDoc`); общий разбор — `DocFile` (CFB → потоки WordDocument / 0Table|1Table / Data + FIB + piece table). 16 из 18 классов package-private; наружу — `DocToDocx` и `CfbReader`. |Класс|Семантика (полные байтовые раскладки — `docs/agent/doc-bridge.md`)| |---|---| @@ -89,7 +89,7 @@ ### Chart/SmartArt-движок (`internal/chart`) -Нормативный источник любых правок — ECMA-376 (`docs/standards/docx/`: графики §21.2, diagram-разметка §21.4, пресет-геометрия Annex D, XSD `schema/strict/`/`schema/transitional/`); поведение Word — `ms-oi29500.md`, `ms-odrawxml.md`. Эмпирические калибровки (камера, `PIE_DEPTH`) менять только вместе с пиксельными тестами; фикстура невалидна — правится фикстура, не код. +Нормативный источник любых правок — ECMA-376 (`docs/standards/ooxml/`: графики §21.2, diagram-разметка §21.4, пресет-геометрия Annex D, XSD `schema/strict/`/`schema/transitional/`); поведение Word — `ms-oi29500.md`, `ms-odrawxml.md`. Эмпирические калибровки (камера, `PIE_DEPTH`) менять только вместе с пиксельными тестами; фикстура невалидна — правится фикстура, не код. Java2D → PNG: `ChartRenderer.DPI = 300`, потолок растра `MAX_PIXELS = 16_777_216` (`fitDpi` понижает эффективный dpi). Защитные лимиты: `ChartSpec.MAX_POINTS = 100_000`, `ChartRenderer.MAX_TICKS = 1000`, `DrawingPreRenderer.MAX_EXTENT_EMU = 22_000_000` — деградация «объект остаётся как есть / удалён + warn», не OOM. @@ -124,7 +124,7 @@ chart-PNG вставляются media-частями вручную (`DrawingPr | `wordpdf-web/` | SPA: `src/api.ts` (вся сеть) + компоненты | | корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf` | контейнеры; единственный вход — gateway (`:9010`/`:9011`) | | `.gitea/workflows/` | Gitea Actions (`pr.yml`, `main.yml`) — нарратив job'ов `docs/agent/ci-cd.md` | -| `docs/standards/` | нормативные спецификации OOXML/.doc + XSD + `validate-fixtures.py` | +|`docs/standards/`|нормативные спецификации форматов Word/Excel (навигатор — `README.md`): `ooxml/` (ECMA-376 + XSD + MS-OI29500/MS-ODRAWXML), `binary/` (OLE2-окружение), `doc/` ([MS-DOC]), `docx/` (валидатор фикстур), `xls/` ([MS-XLS]), `xlsx/` ([MS-XLSX])| | `docs/agent/` | глубокие справочники (когда читать — по имени файла) | | `prod-autotests/` | прод-автотесты (pytest, конфиг только env) | diff --git a/docs/agent/chart.md b/docs/agent/chart.md index a9cdfb7..a937ffc 100644 --- a/docs/agent/chart.md +++ b/docs/agent/chart.md @@ -1,6 +1,6 @@ > Извлечение из AGENTS.md; читать при правке `internal/chart`. Авторитетно наравне с AGENTS.md. -Нормативный источник любых правок — ECMA-376 (`docs/standards/docx/`: графики §21.2, diagram-разметка §21.4, пресет-геометрия Annex D + полные наборы XSD `schema/strict/`/`schema/transitional/`; поведение Word — `ms-oi29500.md`, `ms-odrawxml.md`), а не догадки по исходникам LibreOffice/Word. Формулировки из стандарта при ссылке — с номером секции (§21.2.2.132 и т.п.). Эмпирические калибровки (камера, `PIE_DEPTH`) менять только вместе с пиксельными тестами. Фикстуры могут быть невалидны — код под фикстуру не правится, правится фикстура (после проверки по XSD/секции). +Нормативный источник любых правок — ECMA-376 (`docs/standards/ooxml/`: графики §21.2, diagram-разметка §21.4, пресет-геометрия Annex D + полные наборы XSD `schema/strict/`/`schema/transitional/`; поведение Word — `ms-oi29500.md`, `ms-odrawxml.md`), а не догадки по исходникам LibreOffice/Word. Формулировки из стандарта при ссылке — с номером секции (§21.2.2.132 и т.п.). Эмпирические калибровки (камера, `PIE_DEPTH`) менять только вместе с пиксельными тестами. Фикстуры могут быть невалидны — код под фикстуру не правится, правится фикстура (после проверки по XSD/секции). Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры в пунктах, EMU→pt `cx/12700.0`). Потолок растра `ChartRenderer.MAX_PIXELS = 16_777_216` (4096², 64 МБ ARGB): при превышении `fitDpi` uniform-но понижает эффективный dpi (геометрия в пунктах и безразмерные пропорции не меняются; 24″-график: 208 МБ → 64 МБ, dpi 300 → ≈171); `SmartArtRenderer` использует тот же `DPI`/`fitDpi`. `ChartSpec.parse` (`enum Type`: PIE, PIE3D, DOUGHNUT, BAR, BAR_HORIZONTAL, LINE, AREA, SURFACE3D, AREA3D, BAR3D, LINE3D, RADAR, SCATTER, BUBBLE, STOCK, OF_PIE, SURFACE, UNSUPPORTED). `c:autoTitleDeleted` (§21.2.2.7, `val` опущен — default true) применяется только при отсутствии `c:title` (MS-OI29500 §2.1.1431(a)) — явный заголовок показывается при любом флаге; при отсутствии `c:title` и `val=0` рисуется автозаголовок. Пустой/пробельный `c:title` (или `val=0` без `c:title`) — автозаголовок Office (MS-OI29500 §2.1.1561(a)): одиночный ряд с именем → имя ряда (любой тип графика), иначе `ChartSpec.AUTO_TITLE = "Название диаграммы"`; несколько абзацев `a:p` склеиваются `'\n'` (жёсткий перенос в `DrawMlText`). Регрессии — `ChartSpecTest#emptyTitleSingleSeriesBar_usesSeriesName`, `#deletedTitleWithText_stillShown`, `#deletedTitleValOmitted_stillShown`, `#multiSeriesDoughnut_placeholderNotSeriesName`, `#multiParagraphTitle_joinedWithNewlines`. Палитра `accent1..6` темы; легенда по умолчанию снизу; `overlay` (§21.2.2.132) рисуется поверх области построения, место не резервирует. diff --git a/docs/agent/doc-bridge.md b/docs/agent/doc-bridge.md index cf2be49..61a004e 100644 --- a/docs/agent/doc-bridge.md +++ b/docs/agent/doc-bridge.md @@ -1,6 +1,6 @@ > Извлечение из AGENTS.md; читать при правке моста `internal/doc`. Авторитетно наравне с AGENTS.md. -Нормативный источник — `docs/standards/doc/` ([MS-DOC], [MS-CFB], [MS-OLEPS], [MS-ODRAW]; [MS-ODRAWXML] лежит в `docs/standards/docx/`), ссылки — с номерами секций. Новых runtime-зависимостей нет (POI остаётся test-scope; POIFS — только в тестах для упаковки крафтовых CFB). Публичные точки: `DocToDocx.convert(byte[])` (вызывает `WordPdfConverter`) и `DocToDocx.countPages(byte[])` (вызывает `WordPdfValidator.checkPageCountDoc`); общий разбор — `DocFile` (CFB → потоки WordDocument / 0Table|1Table / Data + FIB + piece table). 16 из 18 классов package-private; наружу — `DocToDocx` и `CfbReader` (public, публичный член — `static readStreams(byte[])`). +Нормативный источник — [MS-DOC] в `docs/standards/doc/`, общее OLE-окружение ([MS-CFB], [MS-OLEPS], [MS-ODRAW]) в `docs/standards/binary/`, [MS-ODRAWXML] в `docs/standards/ooxml/`, ссылки — с номерами секций. Новых runtime-зависимостей нет (POI остаётся test-scope; POIFS — только в тестах для упаковки крафтовых CFB). Публичные точки: `DocToDocx.convert(byte[])` (вызывает `WordPdfConverter`) и `DocToDocx.countPages(byte[])` (вызывает `WordPdfValidator.checkPageCountDoc`); общий разбор — `DocFile` (CFB → потоки WordDocument / 0Table|1Table / Data + FIB + piece table). 16 из 18 классов package-private; наружу — `DocToDocx` и `CfbReader` (public, публичный член — `static readStreams(byte[])`). |Класс|Спецификация| |---|---| diff --git a/docs/agent/repo-map.md b/docs/agent/repo-map.md index 8aa9220..1544bce 100644 --- a/docs/agent/repo-map.md +++ b/docs/agent/repo-map.md @@ -20,7 +20,7 @@ | `.gitea/workflows/` | Gitea Actions: `pr.yml` (`PR checks`), `main.yml` (тесты + coverage-сводка и комментарий в PR → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback) | | `GITEA-vars.md` | Инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений | | `prod-autotests/` | Прод-автотесты API (pytest + requests, 31 проверка): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет | -| `docs/standards/` | Нормативная документация форматов Word, две категории: `docx/` — OOXML: PDF+md ECMA-376 Part 1 (5-е изд.), md [MS-OI29500]/[MS-ODRAWXML], полные наборы XSD `docx/schema/strict/` (21) + `docx/schema/transitional/` (26), `docx/validate-fixtures.py` — XSD-валидация `samples/*.docx` (lxml, ставится отдельно); `doc/` — бинарный .doc: md [MS-DOC] (`ms-doc.md` + `ms-doc-full.md` — тот же текст с HTML packet diagram'ами и таблицами sprm §2.6.1–2.6.3, где `ms-doc.md` даёт `[TABLE]`) + окружение [MS-CFB]/[MS-OSHARED]/[MS-ODRAW]/[MS-OLEPS]/[MS-OFFCRYPTO]/[MS-OVBA]/[MS-WMF]/[MS-EMF]; регенерация — README в каждой категории: `docx/README.md`, `doc/README.md` | +| `docs/standards/` | Нормативная документация форматов Word/Excel, шесть каталогов + навигатор `README.md`: `ooxml/` — OOXML: PDF+md ECMA-376 Part 1 (5-е изд.), md [MS-OI29500]/[MS-ODRAWXML], полные наборы XSD `ooxml/schema/strict/` (21) + `ooxml/schema/transitional/` (26); `binary/` — общее OLE2-окружение .doc/.xls [MS-CFB]/[MS-OSHARED]/[MS-ODRAW]/[MS-OLEPS]/[MS-OFFCRYPTO]/[MS-OVBA]/[MS-WMF]/[MS-EMF]; `doc/` — [MS-DOC] (`ms-doc.md` + `ms-doc-full.md` — тот же текст с HTML packet diagram'ами и таблицами sprm §2.6.1–2.6.3, где `ms-doc.md` даёт `[TABLE]`); `docx/` — `validate-fixtures.py` (XSD-валидация `samples/*.docx`, lxml, ставится отдельно); `xls/` — [MS-XLS] (`ms-xls.md` + `ms-xls-full.md` — тот же приём `[TABLE]`); `xlsx/` — [MS-XLSX] (`ms-xlsx.md`); регенерация — README в каждом каталоге | | `develop/` (вне git, gitignored) | Рабочие материалы и эталоны сравнения рендера — **не фикстуры**, в тесты/jar не подключать; пиксельные замеры зашиты числами в chart-тестах | | `docs/agent/` | Глубокие справочники: `pipeline` / `doc-bridge` / `chart` / `render-limitations` / `testing` / `ci-cd` (когда читать — по имени файла) | diff --git a/docs/standards/README.md b/docs/standards/README.md new file mode 100644 index 0000000..d019108 --- /dev/null +++ b/docs/standards/README.md @@ -0,0 +1,30 @@ +# Нормативная документация форматов Office + +Источник истины по форматам документов, которые принимает конвертер (`.docx`/`.doc`), и по соседним форматам того же семейства (`.xlsx`/`.xls`). Правило репозитория: любое решение про уже существующий формат — по спецификациям отсюда, а не по памяти или догадкам; ссылка на спецификацию — **с номером секции** (см. `AGENTS.md` «Documentation FIRST»). + +### Формат → директория + +|Формат|Специфика формата|Общее окружение| +|---|---|---| +|`.doc` (Word 97–2003, бинарный OLE2)|`doc/` ([MS-DOC])|`binary/` (CFB-контейнер, OLEPS-метаданные, ODRAW-рисунки, OFFCRYPTO, OVBA, WMF/EMF; общие типы — [MS-OSHARED] в `binary/`)| +|`.docx` (Word OOXML)|`docx/` (валидатор фикстур)|`ooxml/` (ECMA-376 Part 1 §17 WordprocessingML + XSD; [MS-OI29500], [MS-ODRAWXML])| +|`.xls` (Excel 97–2003, бинарный OLE2)|`xls/` ([MS-XLS])|`binary/` (то же окружение, что у .doc)| +|`.xlsx` (Excel OOXML)|`xlsx/` ([MS-XLSX])|`ooxml/` (ECMA-376 Part 1 §18 SpreadsheetML + `sml.xsd`; [MS-OI29500], [MS-ODRAWXML])| + +Схемы ECMA-376 покрывают и PowerPoint (`pml.xsd`, §19 — в PDF и `ecma376-part1-5th.md` в `ooxml/`); специализированных MS-документов по PowerPoint здесь нет. + +### Как искать по номеру секции + +|Семейство файлов|Что искать|Как| +|---|---|---| +|`doc/ms-doc.md`, `xls/ms-xls.md`|номер вида §2.9.38|заголовки в теле без номеров (автонумерация Word теряется при конвертации) — грепом по строкам оглавления: `grep -n "^\[2\.9\.38 " doc/ms-doc.md`, `grep -n "^\[2\.4\.21 " xls/ms-xls.md`| +|`ooxml/ecma376-part1-5th.md`|номер вида §18.3.1.53|по нумерованным заголовкам в теле: `grep -n "^18\.3\.1" ooxml/ecma376-part1-5th.md` (пример строки: `18.3.1.53 is (Rich Text Inline)`)| +|`ooxml/ms-oi29500.md`|комментарий Office к Part 1|указатели вида `§2.17.3.3.13` (→ Part 1 §17.3.3.13)| +|`binary/*.md`, `xlsx/ms-xlsx.md`|номер вида §2.2|тот же приём оглавления: `grep -n "^\[2\.2 " xlsx/ms-xlsx.md`| + +### Конвенции + +- Первичен оригинал — `.docx`/`.pdf` в таблицах «Источники»; `.md` — производные извлечения, их SHA-256 справочные (сменишь инструмент — сменится SHA). +- Регенерация — dated `.docx` с CDN (два хоста: у office_protocols-документов путь с сегментом `/files/`, у windows_protocols — без) + `pandoc -t gfm-raw_html --wrap=none`; плейсхолдеры `[TABLE]` (packet diagram'ы) и «full»-конверты с HTML-таблицами (`-t gfm`) описаны в README'ах каталогов. +- ECMA-376 `.md` — из PDF (`pdftotext -layout` + постобработка), XSD — из официальных ECMA-архивов: `ooxml/README.md`. +- Валидация `.docx`-фикстур по transitional-XSD — `docx/validate-fixtures.py`, см. `docx/README.md`. diff --git a/docs/standards/binary/README.md b/docs/standards/binary/README.md new file mode 100644 index 0000000..9399301 --- /dev/null +++ b/docs/standards/binary/README.md @@ -0,0 +1,61 @@ +# Нормативная документация общего OLE2-окружения (.doc/.xls/.ppt) + +Справочный комплект вокруг бинарных форматов Office 97–2003: контейнер и его служебные потоки (CFB, property sets, OfficeArt-рисунки, шифрование, VBA, метафайлы) общие для Word, Excel и PowerPoint — правки по документам ниже, а не по догадкам. Специфика форматов: Word — `../doc/README.md` ([MS-DOC]), Excel — `../xls/README.md` ([MS-XLS]). Документация OOXML — `../ooxml/README.md`. + +SHA-256 `.md`-файлов — справочные: они производные от инструментов извлечения (poppler/pandoc), при регенерации другим инструментом могут измениться; первичен docx в таблице «Источники». + +Метка `[TABLE]` в `.md` — таблицы битовых макетов (packet diagram) со span-ячейками: конверсионная команда `-t gfm-raw_html` отключает HTML-fallback pandoc, и такие таблицы не выразимы в GFM; все поля описаны текстом сразу за плейсхолдером. + +### Источники + +|Файл|Документ|Редакция/дата|URL|SHA-256| +|---|---|---|---|---| +|`ms-cfb.md`|[MS-CFB] «Compound File Binary File Format» — OLE2-контейнер .doc/.xls (заголовок, FAT/MiniFAT, directory entries, потоки)|13.0 (261026, октябрь 2026)|https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net/MS-CFB/%5bMS-CFB%5d-261026.docx|`84d0f9f282aa00dac631a575514264b6bc1f3cec1b9c8fed095e12f7cc042913`| +|`ms-oshared.md`|[MS-OSHARED] «Office Common Data Types and Objects Structures» — общие типы MS-DOC/MS-PPT/MS-XLS (MSONFC/FilePointer/FixedPoint, тулбары TBC, property sets, RefEdit, VBA-подпись)|11.1 (251113, ноябрь 2025)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OSHARED/%5bMS-OSHARED%5d-251113.docx|`ccac510af0266a0804f6a242b08bc4df2f6d1f5b27935c113609b4faf198cb57`| +|`ms-odraw.md`|[MS-ODRAW] «Office Drawing Binary File Format» — бинарные рисунки OfficeArt (картинки/фигуры внутри .doc/.xls)|12.4 (250819, август 2025)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-ODRAW/%5bMS-ODRAW%5d-250819.docx|`f7b9b19222ca8b22ab773846a0c7ff4fa1898e391fff1b3ce41ca3b528f36cf6`| +|`ms-oleps.md`|[MS-OLEPS] «Object Linking and Embedding (OLE) Property Set Data Structures» — метаданные-потоки `\x05SummaryInformation`/`\x05DocumentSummaryInformation`|9.0 (240423, апрель 2024)|https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net/MS-OLEPS/%5bMS-OLEPS%5d-240423.docx|`ff255baa60ef6002a62f632ffc71e7c0cb0d7a72273d844e85efb97557c0e107`| +|`ms-offcrypto.md`|[MS-OFFCRYPTO] «Office Document Cryptography Structure» — шифрование документов (CryptoAPI-обёртка .doc/.xls, agile .docx/.xlsx)|14.0 (260217, февраль 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OFFCRYPTO/%5bMS-OFFCRYPTO%5d-260217.docx|`70836fa126b785efcc4e223480bd938e57c45799129d47ef6c8c3524a5a1dfdf`| +|`ms-ovba.md`|[MS-OVBA] «Office VBA File Format Structure» — VBA-проект (макросы) в CFB-потоках|15.0 (260519, май 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OVBA/%5bMS-OVBA%5d-260519.docx|`a9c32389ff0f03341f73a141f14269f7aae71c35af8c375e37be0cb013e706af`| +|`ms-wmf.md`|[MS-WMF] «Windows Metafile Format» — записи метафайла (встраиваемые картинки .doc/.xls)|18.0 (240423, апрель 2024)|https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net/MS-WMF/%5bMS-WMF%5d-240423.docx|`f7fc5dfb2ffa671c81badea2a983b62c215bb10aad4fc1d04d6d9ff3df00a262`| +|`ms-emf.md`|[MS-EMF] «Enhanced Metafile Format» — записи расширенного метафайла|18.0 (240423, апрель 2024)|https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net/MS-EMF/%5bMS-EMF%5d-240423.docx|`dcb97229d0201556c3f21b07f32388363a80348f0ce87fbe308e4b3048a29c3f`| + +### Что где искать + +- **Контейнер .doc/.xls (OLE2/CFB)** — `ms-cfb.md`: §2.2 Compound File Header (сигнатура `D0 CF 11 E0 A1 B1 1A E1` — предикат бинарного входа в `WordPdfValidator`), §2.3–2.5 FAT/Mini FAT/DIFAT-секторы, §2.6 Directory Sectors — где лежат потоки `WordDocument`/`1Table` (MS-DOC §2.1) и `Workbook` (MS-XLS §2.1.7.20). Тот же контейнер образуют шифрованные OOXML-файлы (`EncryptedPackage`-поток, MS-OFFCRYPTO §2.3.4.4). +- **Общие типы Office** — `ms-oshared.md`: §2.2 Data Types (MSONFC §2.2.1.3, FilePointer, FixedPoint), §2.3 Common Objects (Toolbar Customization §2.3.1, VBA Digital Signature §2.3.2 — `WordSignBlob`, Property Set Storage §2.3.3, RefEdit Control §2.3.5) — за этим, а не за форматом конкретного файла, MS-DOC и MS-XLS цитируют MS-OSHARED. +- **Рисунки OfficeArt (и .doc, и .xls)** — `ms-odraw.md`: §2.2 записи OfficeArt: корень файла `OfficeArtDggContainer` §2.2.12, `OfficeArtSpContainer` §2.2.14, BLIP-картинки §2.2.23–2.2.30; MS-DOC отсылает сюда за содержимым `Data`-потока рисунков, MS-XLS — за картинками/объектами листов. +- **Метаданные .doc/.xls** — `ms-oleps.md`: §2.20 PropertySet, §2.21 PropertySetStream, §2.23 имена потоков/хранилищ, §2.25 Well-Known Property Set Formats — аналог `docProps/core|app.xml` для OOXML (заголовок, автор, счётчики страниц — кэш PageCount в мосте .doc). +- **Шифрование** — `ms-offcrypto.md`: §2.3.5 Office Binary Document RC4 CryptoAPI (обёртка .doc/.xls), §2.3.4 ECMA-376 Document Encryption (Standard/Extensible = agile, `EncryptedPackage` §2.3.4.4); шифрованный вход нечитаем — распознавание по CFB-потокам `EncryptedStream` (в .doc) и `encryption` (в .xls — MS-XLS §2.1.7.6). +- **Макросы (VBA)** — `ms-ovba.md`: §2.2 File Structure (корневое хранилище `_VBA_PROJECT_CUR` §2.2.1, `_VBA_PROJECT`-поток §2.2.3, `dir`-поток §2.2.4, модули §2.2.5), §2.4.1 сжатие, §2.4.3 Data Encryption (обфускация модулей) — что пропускать при разборе .doc/.xls (в .xls хранилище — MS-XLS §2.1.7.18). +- **Метафайлы-картинки** — `ms-wmf.md` / `ms-emf.md`: §2.3 записи (WMF/EMF — один и тот же набор типов записей, EMF расширенный); частый формат inline-изображений в бинарных документах (BLIP-типы `OfficeArtBlipWMF`/`OfficeArtBlipEMF` §2.2.24–2.2.25 MS-ODRAW). + +### Регенерация + +```bash +# Окружение — dated-.docx с лендингов (при 404 — самый свежий из таблицы +# «Published Version»). Два CDN: у windows_protocols-документов (CFB, OLEPS, +# WMF, EMF) путь БЕЗ сегмента /files/. +O="https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files" +W="https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net" +curl -sSL -o /tmp/ms-cfb.docx "$W/MS-CFB/%5bMS-CFB%5d-261026.docx" +curl -sSL -o /tmp/ms-oshared.docx "$O/MS-OSHARED/%5bMS-OSHARED%5d-251113.docx" +curl -sSL -o /tmp/ms-odraw.docx "$O/MS-ODRAW/%5bMS-ODRAW%5d-250819.docx" +curl -sSL -o /tmp/ms-oleps.docx "$W/MS-OLEPS/%5bMS-OLEPS%5d-240423.docx" +curl -sSL -o /tmp/ms-offcrypto.docx "$O/MS-OFFCRYPTO/%5bMS-OFFCRYPTO%5d-260217.docx" +curl -sSL -o /tmp/ms-ovba.docx "$O/MS-OVBA/%5bMS-OVBA%5d-260519.docx" +curl -sSL -o /tmp/ms-wmf.docx "$W/MS-WMF/%5bMS-WMF%5d-240423.docx" +curl -sSL -o /tmp/ms-emf.docx "$W/MS-EMF/%5bMS-EMF%5d-240423.docx" +for n in ms-cfb ms-oshared ms-odraw ms-oleps ms-offcrypto ms-ovba ms-wmf ms-emf; do + pandoc "/tmp/$n.docx" -t gfm-raw_html --wrap=none -o "docs/standards/binary/$n.md" +done + +# Лендинги (свежий dated .docx — в таблице «Published Version»): +# MS-CFB https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-cfb/53989ce4-7b05-4f8d-829b-d08d6148375b +# MS-OSHARED https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-oshared/d93502fa-5b8f-4f47-a3fe-5574046f4b8d +# MS-ODRAW https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-odraw/8560795e-7759-4745-838f-f7f2ef2f1872 +# MS-OLEPS https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-oleps/bf7aeae8-c47a-4939-9f45-700158dac3bc +# MS-OFFCRYPTO https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-offcrypto/3c34d72a-1a61-4b52-a893-196f9157f083 +# MS-OVBA https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-ovba/575462ba-bf67-4190-9fac-c275523c75fc +# MS-WMF https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wmf/4813e7fd-52d0-4f42-965f-228c8b7488d2 +# MS-EMF https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-emf/91c257d7-c39d-4a36-9b1f-63e3f73d30ca +``` diff --git a/docs/standards/doc/ms-cfb.md b/docs/standards/binary/ms-cfb.md similarity index 100% rename from docs/standards/doc/ms-cfb.md rename to docs/standards/binary/ms-cfb.md diff --git a/docs/standards/doc/ms-emf.md b/docs/standards/binary/ms-emf.md similarity index 100% rename from docs/standards/doc/ms-emf.md rename to docs/standards/binary/ms-emf.md diff --git a/docs/standards/doc/ms-odraw.md b/docs/standards/binary/ms-odraw.md similarity index 100% rename from docs/standards/doc/ms-odraw.md rename to docs/standards/binary/ms-odraw.md diff --git a/docs/standards/doc/ms-offcrypto.md b/docs/standards/binary/ms-offcrypto.md similarity index 100% rename from docs/standards/doc/ms-offcrypto.md rename to docs/standards/binary/ms-offcrypto.md diff --git a/docs/standards/doc/ms-oleps.md b/docs/standards/binary/ms-oleps.md similarity index 100% rename from docs/standards/doc/ms-oleps.md rename to docs/standards/binary/ms-oleps.md diff --git a/docs/standards/doc/ms-oshared.md b/docs/standards/binary/ms-oshared.md similarity index 100% rename from docs/standards/doc/ms-oshared.md rename to docs/standards/binary/ms-oshared.md diff --git a/docs/standards/doc/ms-ovba.md b/docs/standards/binary/ms-ovba.md similarity index 100% rename from docs/standards/doc/ms-ovba.md rename to docs/standards/binary/ms-ovba.md diff --git a/docs/standards/doc/ms-wmf.md b/docs/standards/binary/ms-wmf.md similarity index 100% rename from docs/standards/doc/ms-wmf.md rename to docs/standards/binary/ms-wmf.md diff --git a/docs/standards/doc/README.md b/docs/standards/doc/README.md index e8f8919..7a99180 100644 --- a/docs/standards/doc/README.md +++ b/docs/standards/doc/README.md @@ -1,8 +1,8 @@ # Нормативная документация бинарного .doc (Word 97–2003) -Справочный комплект форматов бинарного .doc: источник истины по структуре контейнера и его потоков (CFB, FIB, CHPX/PAPX, piece table, OfficeArt, property sets, шифрование, VBA) — правки по документам ниже, а не по догадкам. Конвертер принимает только .docx — всё здесь справочное. Документация OOXML — `../docx/README.md`. +Справочный комплект формата бинарного .doc: источник истины по его потокам и структурам (FIB, CHPX/PAPX, piece table, TAP/секции, колонтитуки) — правки по документам ниже, а не по догадкам. Конвертер принимает .doc через собственный мост `internal/doc` — всё здесь нормативно для моста. Общее OLE2-окружение (CFB-контейнер, property sets, OfficeArt, шифрование, VBA, метафайлы, общие типы MS-OSHARED) — `../binary/README.md`; документация OOXML — `../ooxml/README.md`. -SHA-256 `.md`-файлов — справочные: они производные от инструментов извлечения (poppler/pandoc), при регенерации другим инструментом могут измениться; первичен PDF/docx в таблице «Источники». +SHA-256 `.md`-файлов — справочные: они производные от инструментов извлечения (poppler/pandoc), при регенерации другим инструментом могут измениться; первичен docx в таблице «Источники». Метка `[TABLE]` в `.md` — таблицы битовых макетов (packet diagram) со span-ячейками: конверсионная команда `-t gfm-raw_html` отключает HTML-fallback pandoc, и такие таблицы не выразимы в GFM; все поля описаны текстом сразу за плейсхолдером (одинаково во всех файлах, включая `ms-doc.md`). @@ -12,25 +12,11 @@ SHA-256 `.md`-файлов — справочные: они производны |---|---|---|---|---| |`ms-doc.md`|[MS-DOC] «Word (.doc) Binary File Format» — бинарный формат .doc Word 97–2003 (WordDocument/1Table-потоки, FIB, CHPX/PAPX, Clx/PlcPcd/Pcd — «piece table»)|12.5 (260217, февраль 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-DOC/%5bMS-DOC%5d-260217.docx|`c2886120e92aa2790a5603156fb0ca8b23151d58476592fef3ede7fb6841ee7d`| |`ms-doc-full.md`|Тот же [MS-DOC] 12.5, полный конверт **с** HTML-packet-diagram'ами (`-t gfm`, raw_html включён): битовые макеты §2.4/§2.6/§2.9 и таблицы sprm §2.6.1–2.6.3 — то, что в `ms-doc.md` свёрнуто в `[TABLE]`|12.5 (260217, февраль 2026)|тот же dated-.docx, что `ms-doc.md`|`35cbcd5b5228cf02200008c2145d941e66dbf8a9e296305745d2bdc099c8a5ad`| -|`ms-cfb.md`|[MS-CFB] «Compound File Binary File Format» — OLE2-контейнер .doc (заголовок, FAT/MiniFAT, directory entries, потоки)|13.0 (261026, октябрь 2026)|https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net/MS-CFB/%5bMS-CFB%5d-261026.docx|`84d0f9f282aa00dac631a575514264b6bc1f3cec1b9c8fed095e12f7cc042913`| -|`ms-oshared.md`|[MS-OSHARED] «Office Common Data Types and Objects Structures» — общие типы MS-DOC/MS-PPT/MS-XLS (MSONFC/FilePointer/FixedPoint, тулбары TBC, property sets, RefEdit, VBA-подпись)|11.1 (251113, ноябрь 2025)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OSHARED/%5bMS-OSHARED%5d-251113.docx|`ccac510af0266a0804f6a242b08bc4df2f6d1f5b27935c113609b4faf198cb57`| -|`ms-odraw.md`|[MS-ODRAW] «Office Drawing Binary File Format» — бинарные рисунки OfficeArt (картинки/фигуры внутри .doc)|12.4 (250819, август 2025)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-ODRAW/%5bMS-ODRAW%5d-250819.docx|`f7b9b19222ca8b22ab773846a0c7ff4fa1898e391fff1b3ce41ca3b528f36cf6`| -|`ms-oleps.md`|[MS-OLEPS] «Object Linking and Embedding (OLE) Property Set Data Structures» — метаданные-потоки `\x05SummaryInformation`/`\x05DocumentSummaryInformation`|9.0 (240423, апрель 2024)|https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net/MS-OLEPS/%5bMS-OLEPS%5d-240423.docx|`ff255baa60ef6002a62f632ffc71e7c0cb0d7a72273d844e85efb97557c0e107`| -|`ms-offcrypto.md`|[MS-OFFCRYPTO] «Office Document Cryptography Structure» — шифрование документов (CryptoAPI-обёртка .doc, agile .docx)|14.0 (260217, февраль 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OFFCRYPTO/%5bMS-OFFCRYPTO%5d-260217.docx|`70836fa126b785efcc4e223480bd938e57c45799129d47ef6c8c3524a5a1dfdf`| -|`ms-ovba.md`|[MS-OVBA] «Office VBA File Format Structure» — VBA-проект (макросы) в CFB-потоках|15.0 (260519, май 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OVBA/%5bMS-OVBA%5d-260519.docx|`a9c32389ff0f03341f73a141f14269f7aae71c35af8c375e37be0cb013e706af`| -|`ms-wmf.md`|[MS-WMF] «Windows Metafile Format» — записи метафайла (встраиваемые картинки .doc)|18.0 (240423, апрель 2024)|https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net/MS-WMF/%5bMS-WMF%5d-240423.docx|`f7fc5dfb2ffa671c81badea2a983b62c215bb10aad4fc1d04d6d9ff3df00a262`| -|`ms-emf.md`|[MS-EMF] «Enhanced Metafile Format» — записи расширенного метафайла|18.0 (240423, апрель 2024)|https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net/MS-EMF/%5bMS-EMF%5d-240423.docx|`dcb97229d0201556c3f21b07f32388363a80348f0ce87fbe308e4b3048a29c3f`| +|`ms-doc.docx`|Оригинальный dated-.docx [MS-DOC] 12.5 (первичный источник двух `.md`-конвертов)|12.5 (260217)|тот же URL, что `ms-doc.md`|—| ### Что где искать -- **Бинарный .doc (Word 97–2003)** — `ms-doc.md`: §2.1 File Structure (WordDocument-, 1Table/0Table-, Data-потоки), §2.5 FIB (FibBase, флага), §2.8–2.9 структуры данных (Chpx §2.9.32, PapxFkp, Grpprl, Clx §2.9.38, PlcPcd §2.8.35, Pcd), §3 Structure Examples, §6 Change Tracking; поиск по номерам секций — по строкам оглавления вида `[2.9.38 Clx …]` (заголовки в теле без номеров — автонумерация Word потерялась при извлечении). Конвертер принимает только .docx — документ справочный. -- **Контейнер .doc (OLE2/CFB)** — `ms-cfb.md`: §2.2 Compound File Header, §2.3–2.5 FAT/Mini FAT/DIFAT-секторы, §2.6 Directory Sectors — где лежат потоки `WordDocument`/`1Table`/`Data` из MS-DOC §2.1. -- **Общие типы Office** — `ms-oshared.md`: §2.2 Data Types (MSONFC §2.2.1.3, FilePointer, FixedPoint), §2.3 Common Objects (Toolbar Customization §2.3.1, VBA Digital Signature §2.3.2 — `WordSignBlob`, Property Set Storage §2.3.3, RefEdit Control §2.3.5) — за этим, а не за форматом .doc, MS-DOC и цитирует MS-OSHARED. -- **Рисунки .doc (OfficeArt)** — `ms-odraw.md`: §2.2 записи OfficeArt: корень файла `OfficeArtDggContainer` §2.2.12, `OfficeArtSpContainer` §2.2.14, BLIP-картинки §2.2.23–2.2.30; MS-DOC отсылает сюда за содержимым `Data`-потока рисунков. -- **Метаданные .doc** — `ms-oleps.md`: §2.20 PropertySet, §2.21 PropertySetStream, §2.23 имена потоков/хранилищ, §2.25 Well-Known Property Set Formats — аналог `docProps/core|app.xml` для OOXML (заголовок, автор, счётчики страниц). -- **Шифрование** — `ms-offcrypto.md`: §2.3.5 Office Binary Document RC4 CryptoAPI (обёртка .doc), §2.3.4 ECMA-376 Document Encryption (Standard/Extensible = agile, `EncryptedPackage` §2.3.4.4); шифрованный вход нечитаем — распознавание по CFB-потокам `EncryptedStream`/`EncryptedPackage`. -- **Макросы (VBA)** — `ms-ovba.md`: §2.2 File Structure (корневое хранилище `_VBA_PROJECT_CUR` §2.2.1, `_VBA_PROJECT`-поток §2.2.3, `dir`-поток §2.2.4, модули §2.2.5), §2.4.1 сжатие, §2.4.3 Data Encryption (обфускация модулей) — что пропускать при разборе .doc. -- **Метафайлы-картинки** — `ms-wmf.md` / `ms-emf.md`: §2.3 записи (WMF/EMF — один и тот же набор типов записей, EMF расширенный); частый формат inline-изображений в .doc (BLIP-типы `OfficeArtBlipWMF`/`OfficeArtBlipEMF` §2.2.24–2.2.25 MS-ODRAW). +- **Бинарный .doc (Word 97–2003)** — `ms-doc.md`: §2.1 File Structure (WordDocument-, 1Table/0Table-, Data-потоки), §2.5 FIB (FibBase, флага), §2.8–2.9 структуры данных (Chpx §2.9.32, PapxFkp, Grpprl, Clx §2.9.38, PlcPcd §2.8.35, Pcd), §3 Structure Examples, §6 Change Tracking; поиск по номерам секций — по строкам оглавления вида `[2.9.38 Clx …]` (заголовки в теле без номеров — автонумерация Word потерялась при извлечении). ### Регенерация @@ -44,29 +30,5 @@ pandoc /tmp/msdoc.docx -t gfm-raw_html --wrap=none -o docs/standards/doc/ms-doc. # таблицы sprm (§2.6.1–2.6.3) остаются HTML-таблицами вместо [TABLE]-плейсхолдеров. pandoc /tmp/msdoc.docx -t gfm --wrap=none -o docs/standards/doc/ms-doc-full.md -# Окружение MS-DOC — те же dated-.docx (при 404 — самый свежий с лендингов ниже). -# Два CDN: у windows_protocols-документов (CFB, OLEPS, WMF, EMF) путь БЕЗ сегмента /files/. -O="https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files" -W="https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net" -curl -sSL -o /tmp/ms-cfb.docx "$W/MS-CFB/%5bMS-CFB%5d-261026.docx" -curl -sSL -o /tmp/ms-oshared.docx "$O/MS-OSHARED/%5bMS-OSHARED%5d-251113.docx" -curl -sSL -o /tmp/ms-odraw.docx "$O/MS-ODRAW/%5bMS-ODRAW%5d-250819.docx" -curl -sSL -o /tmp/ms-oleps.docx "$W/MS-OLEPS/%5bMS-OLEPS%5d-240423.docx" -curl -sSL -o /tmp/ms-offcrypto.docx "$O/MS-OFFCRYPTO/%5bMS-OFFCRYPTO%5d-260217.docx" -curl -sSL -o /tmp/ms-ovba.docx "$O/MS-OVBA/%5bMS-OVBA%5d-260519.docx" -curl -sSL -o /tmp/ms-wmf.docx "$W/MS-WMF/%5bMS-WMF%5d-240423.docx" -curl -sSL -o /tmp/ms-emf.docx "$W/MS-EMF/%5bMS-EMF%5d-240423.docx" -for n in ms-cfb ms-oshared ms-odraw ms-oleps ms-offcrypto ms-ovba ms-wmf ms-emf; do - pandoc "/tmp/$n.docx" -t gfm-raw_html --wrap=none -o "docs/standards/doc/$n.md" -done - -# Лендинги (свежий dated .docx — в таблице «Published Version»): -# MS-CFB https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-cfb/53989ce4-7b05-4f8d-829b-d08d6148375b -# MS-OSHARED https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-oshared/d93502fa-5b8f-4f47-a3fe-5574046f4b8d -# MS-ODRAW https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-odraw/8560795e-7759-4745-838f-f7f2ef2f1872 -# MS-OLEPS https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-oleps/bf7aeae8-c47a-4939-9f45-700158dac3bc -# MS-OFFCRYPTO https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-offcrypto/3c34d72a-1a61-4b52-a893-196f9157f083 -# MS-OVBA https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-ovba/575462ba-bf67-4190-9fac-c275523c75fc -# MS-WMF https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wmf/4813e7fd-52d0-4f42-965f-228c8b7488d2 -# MS-EMF https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-emf/91c257d7-c39d-4a36-9b1f-63e3f73d30ca +# Обновлённый dated-.docx при этом перекладывается в ms-doc.docx (первичный источник). ``` diff --git a/docs/standards/docx/README.md b/docs/standards/docx/README.md index 3e4d9a5..d16fa08 100644 --- a/docs/standards/docx/README.md +++ b/docs/standards/docx/README.md @@ -1,59 +1,24 @@ -# Нормативная документация форматов Word +# Документация формата .docx в этом репозитории -Источник истины для chart-движка (`wordpdf-core/.../internal/chart/`) и нормализаторов: любые правки диаграмм/SmartArt/представления docx — по документам ниже, а не по догадкам. Правило закреплено в `AGENTS.md` (секция «Chart-движок»). Документация бинарного .doc — `../doc/README.md`. - -SHA-256 `.md`-файлов — справочные: они производные от инструментов извлечения (poppler/pandoc), при регенерации другим инструментом могут измениться; первичен PDF/docx в таблице «Источники». +Здесь — только специфика WordprocessingML-пайплайна этого репозитория: нормативная база OOXML (ECMA-376 Part 1 §17, XSD `wml.xsd`, комментарии Word [MS-OI29500], расширения [MS-ODRAWXML]) живёт в `../ooxml/README.md` — там же таблицы «Источники» с SHA и команды регенерации. Нормативная база моста .doc — `../doc/README.md` + `../binary/README.md`. ### Источники |Файл|Документ|Редакция/дата|URL|SHA-256| |---|---|---|---|---| -|`ECMA-376-1_5th_edition_december_2016.pdf`|ECMA-376 Part 1 «Fundamentals and Markup Language Reference»|5-е изд., декабрь 2016|https://ecma-international.org/wp-content/uploads/ECMA-376-1_5th_edition_december_2016.pdf|`7cccfd0ad0e2ef89316acece15e44a8a088d0603ce4bba4e7b0361b50d13a37d`| -|`ecma376-part1-5th.md`|Тот же текст, извлечённый из PDF (поиск по номерам секций)|5-е изд.|производный (см. регенерацию)|`86af445c080d9a481eaa426fc1721d50a1c4eff875535f9d03fe93d2b95b21b6`| -|`ms-oi29500.md`|[MS-OI29500] «Office Implementation Information for ISO/IEC-29500 Standards» — как Word реально пишет docx (§2.1 — комментарий к Part 1, §3.1 — к Part 4)|260818 (август 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OI29500/%5bMS-OI29500%5d-260818.docx|`3e3eabb060a3772d096f001e7fee682fc4be12a2dd55ea360430fff14dd5845d`| -|`ms-odrawxml.md`|[MS-ODRAWXML] «Office Drawing Extensions to Office Open XML» — расширения Word/Excel для чартов (ChartEx, стили/цвета)|261006 (октябрь 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-ODRAWXML/%5bMS-ODRAWXML%5d-261006.docx|`f5a2517c4984b2ba2f0ade504bd0c9660c74f619290910a9b491c0f2ca9db64a`| -|`schema/strict/`|Полный набор XSD Strict (21 файл: `wml`/`sml`/`pml`/`dml-*`/`shared-*`)|5-е изд.|вложенный `OfficeOpenXML-XMLSchema-Strict.zip` в https://ecma-international.org/wp-content/uploads/ECMA-376-1_5th_edition_december_2016.zip|`9d0bcad9cf06054785b03762fcfadbf6bab7e54a5f9d69434e34b7fd464d4129` (zip)| -|`schema/transitional/`|Полный набор XSD Transitional (26 файлов, +5 `vml-*`)|5-е изд.|вложенный `OfficeOpenXML-XMLSchema-Transitional.zip` в https://ecma-international.org/wp-content/uploads/ECMA-376-4_5th_edition_december_2016.zip|`bd25da1109f73762356596918bf5ff8b74a1331642dba5f1c1d1dfc6bed34ecd` (zip)| +|`validate-fixtures.py`|Валидатор `.docx`-фикстур (lxml + переходные XSD из `../ooxml/schema/transitional/`)|—|—|—| ### Что где искать -- **Диаграммы (`c:chart`)** — ECMA-376 §21.2 (`grep -n "^21.2" ecma376-part1-5th.md`; каждый элемент — секция вида `21.2.2.132 overlay (Overlay)`) + `schema/transitional/dml-chart.xsd` (он же в `schema/strict/`); расширения Word — `ms-odrawxml.md`. -- **Диаграммы-схемы SmartArt (`dgm:`)** — ECMA-376 §21.4 + `schema/transitional/dml-diagram.xsd`. Кэш разложенной схемы (`word/diagrams/drawing1.xml`, relationship `…/office/2007/relationships/diagramDrawing`) — проприетарный MS-формат (`dsp:`, [MS-ODRAWXML]), нормативного ECMA-XSD нет; authoritative источник фактической геометрии — сам `dsp:drawing`. -- **Пресет-геометрия (`a:prstGeom`)** — ECMA-376 Annex D; машинная копия таблицы пресетов — `wordpdf-core/src/test/resources/geom/presetShapeDefinitions.xml` (синхрон пинит `PresetGeometryTest#tableMatchesEcmaXml`). -- **Chart Drawings (`c:drawing`)** — ECMA-376 §21.3. -- **Поведение Word (что он реально пишет в `w:r`/`w:t`/`lastRenderedPageBreak`, текстбоксы, чарты)** — `ms-oi29500.md` (указатели на секции Part 1, напр. §2.17.3.3.13 → Part 1 §17.3.3.13). - -### Регенерация - -```bash -# ecma376-part1-5th.md — из PDF в репозитории (постобработка: выбросить строки -# `^\s*\d{1,4}\s*$` (номера страниц), `^ECMA-376 Part 1\s*$` (колонтитул), -# строки с `.....` (точки оглавления); остальной текст — как есть) -pdftotext -layout docs/standards/docx/ECMA-376-1_5th_edition_december_2016.pdf /tmp/p1.txt - -# ms-oi29500.md / ms-odrawxml.md — свежие dated-.docx с learn.microsoft.com -# (при 404 — самый свежий .docx со страниц лендингов: -# https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oi29500/1fd4a662-8623-49c0-82f0-18fa91b413b8 -# https://learn.microsoft.com/en-us/openspecs/office_standards/ms-odrawxml/06cff208-c6e1-4db7-bb68-665135e5f0de) -curl -sSL -o /tmp/oi29500.docx "https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OI29500/%5bMS-OI29500%5d-260818.docx" -curl -sSL -o /tmp/odrawxml.docx "https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-ODRAWXML/%5bMS-ODRAWXML%5d-261006.docx" -pandoc /tmp/oi29500.docx -t gfm-raw_html --wrap=none -o docs/standards/docx/ms-oi29500.md -pandoc /tmp/odrawxml.docx -t gfm-raw_html --wrap=none -o docs/standards/docx/ms-odrawxml.md - -# schema/strict/ и schema/transitional/ — полные наборы из официальных ECMA-архивов -curl -sSL -o /tmp/p1.zip "https://ecma-international.org/wp-content/uploads/ECMA-376-1_5th_edition_december_2016.zip" -unzip -o /tmp/p1.zip "OfficeOpenXML-XMLSchema-Strict.zip" -d /tmp/ -unzip -o -d docs/standards/docx/schema/strict /tmp/OfficeOpenXML-XMLSchema-Strict.zip "*.xsd" -curl -sSL -o /tmp/p4.zip "https://ecma-international.org/wp-content/uploads/ECMA-376-4_5th_edition_december_2016.zip" -unzip -o /tmp/p4.zip "OfficeOpenXML-XMLSchema-Transitional.zip" -d /tmp/ -unzip -o -d docs/standards/docx/schema/transitional /tmp/OfficeOpenXML-XMLSchema-Transitional.zip "*.xsd" -``` +- **Нормативная разметка .docx** (`w:r`/`w:t`, таблицы §17.4, `w:position` §17.3.2.24, `mc:AlternateContent` §15.2.15, `xml:space` §5.1.2) — `../ooxml/ecma376-part1-5th.md` и `../ooxml/schema/transitional/wml.xsd`; поведение Word — `../ooxml/ms-oi29500.md`. +- **Диаграммы/SmartArt/пресет-геометрия** — `../ooxml/README.md` (§21.2/§21.3/§21.4, Annex D). +- **Валидация фикстур** — см. ниже. ### Валидация фикстур `samples/*.docx` обязаны быть ECMA-conformant (фикстуры — источник истины по входу, код под них не подгоняется). Проверка — `docx/validate-fixtures.py` (lxml + схемы -`docx/schema/transitional/`): +`../ooxml/schema/transitional/`): ```bash python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources/samples/*.docx diff --git a/docs/standards/docx/validate-fixtures.py b/docs/standards/docx/validate-fixtures.py index bcb4d0b..0218710 100755 --- a/docs/standards/docx/validate-fixtures.py +++ b/docs/standards/docx/validate-fixtures.py @@ -1,7 +1,7 @@ #!/usr/bin/env python3 """Валидация XML-частей samples/*.docx против XSD ECMA-376 (transitional). -Схемы — docs/standards/docx/schema/transitional/ (полный набор ECMA-376 5-го изд.). +Схемы — docs/standards/ooxml/schema/transitional/ (полный набор ECMA-376 5-го изд.). wml.xsd — word/*.xml (document/styles/settings/header/footer/...); dml-chart.xsd — word/charts/chart*.xml; dml-diagram.xsd — word/diagrams/*; dml-main.xsd — word/theme/theme*.xml. @@ -18,7 +18,7 @@ import os, re, sys, shutil, tempfile, zipfile from lxml import etree REPO = os.path.dirname(os.path.abspath(__file__)) -SCHEMA_DIR = os.path.join(REPO, "schema", "transitional") +SCHEMA_DIR = os.path.join(REPO, os.pardir, "ooxml", "schema", "transitional") XML_XSD = """ . + +- **License Programs**. To see all of the protocols in scope under a specific license program and the associated patents, visit the [Patent Map](https://aka.ms/AA9ufj8). + +- **Trademarks**. The names of companies and products contained in this documentation might be covered by trademarks or similar intellectual property rights. This notice does not grant any licenses under those rights. For a list of Microsoft trademarks, visit [www.microsoft.com/trademarks](https://www.microsoft.com/trademarks). + +- **Fictitious Names**. The example companies, organizations, products, domain names, email addresses, logos, people, places, and events that are depicted in this documentation are fictitious. No association with any real company, organization, product, domain name, email address, logo, person, place, or event is intended or should be inferred. + +**Reservation of Rights**. All other rights are reserved, and this notice does not grant any rights other than as specifically described above, whether by implication, estoppel, or otherwise. + +**Tools**. The Open Specifications documentation does not require the use of Microsoft programming tools or programming environments in order for you to develop an implementation. If you have access to Microsoft programming tools and environments, you are free to take advantage of them. Certain Open Specifications documents are intended for use in conjunction with publicly available standards specifications and network programming art and, as such, assume that the reader either is familiar with the aforementioned material or has immediate access to it. + +**Support.** For questions and support, please contact . + +**Revision Summary** + +| Date | Revision History | Revision Class | Comments | +|----|----|----|----| +| 6/27/2008 | 1.0 | New | First release | +| 8/15/2008 | 1.01 | Minor | Revised and edited the technical content | +| 10/6/2008 | 1.02 | Minor | Revised and edited the technical content | +| 1/16/2009 | 1.03 | Minor | Updated the Intellectual Property Rights Notice | +| 7/13/2009 | 1.04 | Major | Changes made for template compliance | +| 8/28/2009 | 1.05 | Editorial | Revised and edited the technical content | +| 11/6/2009 | 1.06 | Editorial | Revised and edited the technical content | +| 2/19/2010 | 2.0 | Major | Updated and revised the technical content | +| 3/31/2010 | 2.01 | Editorial | Revised and edited the technical content | +| 4/30/2010 | 2.02 | Editorial | Revised and edited the technical content | +| 6/7/2010 | 2.03 | Minor | Updated the technical content | +| 6/29/2010 | 2.04 | Editorial | Changed language and formatting in the technical content. | +| 7/23/2010 | 2.04 | None | No changes to the meaning, language, or formatting of the technical content. | +| 9/27/2010 | 2.05 | Minor | Clarified the meaning of the technical content. | +| 11/15/2010 | 2.05 | None | No changes to the meaning, language, or formatting of the technical content. | +| 12/17/2010 | 2.05 | None | No changes to the meaning, language, or formatting of the technical content. | +| 3/18/2011 | 2.05 | None | No changes to the meaning, language, or formatting of the technical content. | +| 6/10/2011 | 2.05 | None | No changes to the meaning, language, or formatting of the technical content. | +| 1/20/2012 | 2.6 | Minor | Clarified the meaning of the technical content. | +| 4/11/2012 | 2.6 | None | No changes to the meaning, language, or formatting of the technical content. | +| 7/16/2012 | 2.6 | None | No changes to the meaning, language, or formatting of the technical content. | +| 10/8/2012 | 2.7 | Minor | Clarified the meaning of the technical content. | +| 2/11/2013 | 2.7 | None | No changes to the meaning, language, or formatting of the technical content. | +| 7/30/2013 | 2.8 | Minor | Clarified the meaning of the technical content. | +| 11/18/2013 | 2.8 | None | No changes to the meaning, language, or formatting of the technical content. | +| 2/10/2014 | 2.8 | None | No changes to the meaning, language, or formatting of the technical content. | +| 4/30/2014 | 3.0 | Major | Significantly changed the technical content. | +| 7/31/2014 | 3.1 | Minor | Clarified the meaning of the technical content. | +| 10/30/2014 | 3.2 | Minor | Clarified the meaning of the technical content. | +| 3/16/2015 | 4.0 | Major | Significantly changed the technical content. | +| 9/4/2015 | 4.1 | Minor | Clarified the meaning of the technical content. | +| 7/15/2016 | 4.2 | Minor | Clarified the meaning of the technical content. | +| 8/23/2016 | 4.2 | None | No changes to the meaning, language, or formatting of the technical content. | +| 9/14/2016 | 4.2 | None | No changes to the meaning, language, or formatting of the technical content. | +| 10/17/2016 | 5.0 | Major | Significantly changed the technical content. | +| 6/20/2017 | 6.0 | Major | Significantly changed the technical content. | +| 9/19/2017 | 6.1 | Minor | Clarified the meaning of the technical content. | +| 12/12/2017 | 6.1 | None | No changes to the meaning, language, or formatting of the technical content. | +| 4/27/2018 | 7.0 | Major | Significantly changed the technical content. | +| 8/28/2018 | 8.0 | Major | Significantly changed the technical content. | +| 12/11/2018 | 8.0 | None | No changes to the meaning, language, or formatting of the technical content. | +| 3/19/2019 | 8.0 | None | No changes to the meaning, language, or formatting of the technical content. | +| 6/18/2019 | 8.0 | None | No changes to the meaning, language, or formatting of the technical content. | +| 4/22/2021 | 9.0 | Major | Significantly changed the technical content. | +| 8/17/2021 | 10.0 | Major | Significantly changed the technical content. | +| 11/16/2021 | 10.1 | Minor | Clarified the meaning of the technical content. | +| 2/15/2022 | 10.2 | Minor | Clarified the meaning of the technical content. | +| 5/17/2022 | 10.3 | Minor | Clarified the meaning of the technical content. | +| 8/16/2022 | 10.4 | Minor | Clarified the meaning of the technical content. | +| 11/15/2022 | 10.5 | Minor | Clarified the meaning of the technical content. | +| 2/21/2023 | 10.6 | Minor | Clarified the meaning of the technical content. | +| 5/16/2023 | 10.7 | Minor | Clarified the meaning of the technical content. | +| 4/16/2024 | 11.0 | Major | Significantly changed the technical content. | +| 8/20/2024 | 12.0 | Major | Significantly changed the technical content. | +| 5/20/2025 | 12.1 | Minor | Clarified the meaning of the technical content. | +| 8/19/2025 | 12.2 | Minor | Clarified the meaning of the technical content. | + +Table of Contents + +[1 Introduction [29](#introduction)](#introduction) + +[1.1 Glossary [29](#glossary)](#glossary) + +[1.2 References [52](#references)](#references) + +[1.2.1 Normative References [52](#normative-references)](#normative-references) + +[1.2.2 Informative References [53](#informative-references)](#informative-references) + +[1.3 Overview [53](#overview)](#overview) + +[1.3.1 stream Byte Ordering [54](#stream-byte-ordering)](#stream-byte-ordering) + +[1.3.2 Organization of This Documentation [54](#organization-of-this-documentation)](#organization-of-this-documentation) + +[1.4 Relationship to Protocols and Other Structures [55](#relationship-to-protocols-and-other-structures)](#relationship-to-protocols-and-other-structures) + +[1.5 Applicability Statement [55](#applicability-statement)](#applicability-statement) + +[1.6 Versioning and Localization [55](#versioning-and-localization)](#versioning-and-localization) + +[1.7 Vendor-Extensible Fields [56](#vendor-extensible-fields)](#vendor-extensible-fields) + +[2 Structures [57](#structures)](#structures) + +[2.1 File Structure [57](#file-structure)](#file-structure) + +[2.1.1 Compound File [57](#compound-file)](#compound-file) + +[2.1.2 Stream [57](#stream)](#stream) + +[2.1.3 Substream [57](#substream)](#substream) + +[2.1.4 Record [57](#record)](#record) + +[2.1.5 Collection of Records [58](#collection-of-records)](#collection-of-records) + +[2.1.6 Future Record [58](#future-record)](#future-record) + +[2.1.6.1 Chart [59](#chart)](#chart) + +[2.1.6.2 PivotTable [59](#pivottable)](#pivottable) + +[2.1.7 Storages and Streams [59](#storages-and-streams)](#storages-and-streams) + +[2.1.7.1 Component Object Stream (\001CompObj) [59](#component-object-stream-001compobj)](#component-object-stream-001compobj) + +[2.1.7.2 Control Stream (Ctls) [60](#control-stream-ctls)](#control-stream-ctls) + +[2.1.7.3 Data Spaces Storage (\006DataSpaces) [60](#data-spaces-storage-006dataspaces)](#data-spaces-storage-006dataspaces) + +[2.1.7.4 Document Summary Information Stream (\005DocumentSummaryInformation) [60](#document-summary-information-stream-005documentsummaryinformation)](#document-summary-information-stream-005documentsummaryinformation) + +[2.1.7.5 Embedding Storage (MBD...) [60](#embedding-storage-mbd...)](#embedding-storage-mbd...) + +[2.1.7.6 Encryption Stream (encryption) [60](#encryption-stream-encryption)](#encryption-stream-encryption) + +[2.1.7.7 Link Storage (LNK...) [60](#link-storage-lnk...)](#link-storage-lnk...) + +[2.1.7.8 List Data Stream (List Data) [61](#list-data-stream-list-data)](#list-data-stream-list-data) + +[2.1.7.8.1 Attributes [62](#attributes)](#attributes) + +[2.1.7.8.2 Elements [62](#elements)](#elements) + +[2.1.7.8.2.1 LISTNAME [63](#listname)](#listname) + +[2.1.7.8.2.2 VIEWGUID [63](#viewguid)](#viewguid) + +[2.1.7.8.2.3 LISTWEB [63](#listweb)](#listweb) + +[2.1.7.8.2.4 ROOTFOLDER [63](#rootfolder)](#rootfolder) + +[2.1.7.8.2.5 LISTSCHEMA [63](#listschema)](#listschema) + +[2.1.7.8.2.6 VIEWSCHEMA [64](#viewschema)](#viewschema) + +[2.1.7.8.2.7 LISTDATA [64](#listdata)](#listdata) + +[2.1.7.8.2.8 UPDATE [64](#update)](#update) + +[2.1.7.8.2.9 LISTDATAFTR [65](#listdataftr)](#listdataftr) + +[2.1.7.9 Office Data Store Storage (MsoDataStore) [65](#office-data-store-storage-msodatastore)](#office-data-store-storage-msodatastore) + +[2.1.7.10 Office Toolbars Stream (XCB) [65](#office-toolbars-stream-xcb)](#office-toolbars-stream-xcb) + +[2.1.7.11 OLE Stream (\001Ole) [66](#ole-stream-001ole)](#ole-stream-001ole) + +[2.1.7.12 Pivot Cache Storage (\_SX_DB_CUR) [66](#pivot-cache-storage-_sx_db_cur)](#pivot-cache-storage-_sx_db_cur) + +[2.1.7.13 Protected Content Stream (\009DRMContent) [66](#protected-content-stream-009drmcontent)](#protected-content-stream-009drmcontent) + +[2.1.7.14 Revision Stream (Revision Log) [66](#revision-stream-revision-log)](#revision-stream-revision-log) + +[2.1.7.15 Signatures Stream (\_signatures) [67](#signatures-stream-_signatures)](#signatures-stream-_signatures) + +[2.1.7.16 Summary Information Stream (\005SummaryInformation) [67](#summary-information-stream-005summaryinformation)](#summary-information-stream-005summaryinformation) + +[2.1.7.17 User Names Stream (User Names) [68](#user-names-stream-user-names)](#user-names-stream-user-names) + +[2.1.7.18 VBA Storage (\_VBA_PROJECT_CUR) [68](#vba-storage-_vba_project_cur)](#vba-storage-_vba_project_cur) + +[2.1.7.19 Viewer Content Stream (\009DRMViewerContent) [68](#viewer-content-stream-009drmviewercontent)](#viewer-content-stream-009drmviewercontent) + +[2.1.7.20 Workbook Stream (Workbook) [68](#workbook-stream-workbook)](#workbook-stream-workbook) + +[2.1.7.20.1 Chart Sheet Substream [68](#chart-sheet-substream)](#chart-sheet-substream) + +[2.1.7.20.2 Dialog Sheet Substream [70](#dialog-sheet-substream)](#dialog-sheet-substream) + +[2.1.7.20.3 Globals Substream [70](#globals-substream)](#globals-substream) + +[2.1.7.20.4 Macro Sheet Substream [72](#macro-sheet-substream)](#macro-sheet-substream) + +[2.1.7.20.5 Worksheet Substream [72](#worksheet-substream)](#worksheet-substream) + +[2.1.7.20.6 Common Productions [74](#common-productions)](#common-productions) + +[2.1.7.21 XML Signatures Storage (\_xmlsignatures) [76](#xml-signatures-storage-_xmlsignatures)](#xml-signatures-storage-_xmlsignatures) + +[2.1.7.22 XML Stream (XML) [76](#xml-stream-xml)](#xml-stream-xml) + +[2.1.7.22.1 Elements [77](#elements-1)](#elements-1) + +[2.1.7.22.1.1 MapInfo [78](#mapinfo)](#mapinfo) + +[2.1.7.22.1.2 Schema [78](#schema)](#schema) + +[2.1.7.22.1.3 Map [78](#map)](#map) + +[2.1.7.22.1.4 DataBinding [79](#databinding)](#databinding) + +[2.1.7.22.2 Simple Types [79](#simple-types)](#simple-types) + +[2.1.7.22.2.1 ST_DataBindingLoadMode [79](#st_databindingloadmode)](#st_databindingloadmode) + +[2.1.7.22.2.2 ST_XmlMapBoolean [80](#st_xmlmapboolean)](#st_xmlmapboolean) + +[2.1.7.22.2.3 ST_XmlMapId [80](#st_xmlmapid)](#st_xmlmapid) + +[2.1.7.22.2.4 ST_XmlString65535 [80](#st_xmlstring65535)](#st_xmlstring65535) + +[2.1.7.22.2.5 ST_XmlString256 [80](#st_xmlstring256)](#st_xmlstring256) + +[2.2 Conceptual Overview [80](#conceptual-overview)](#conceptual-overview) + +[2.2.1 Cell Table [80](#cell-table)](#cell-table) + +[2.2.1.1 Retrieval of Last-Calculated Cell Values Without Loading Cell Table [81](#retrieval-of-last-calculated-cell-values-without-loading-cell-table)](#retrieval-of-last-calculated-cell-values-without-loading-cell-table) + +[2.2.2 Formulas [81](#formulas)](#formulas) + +[2.2.2.1 Operator Tokens [82](#operator-tokens)](#operator-tokens) + +[2.2.2.2 Operand Tokens [82](#operand-tokens)](#operand-tokens) + +[2.2.2.2.1 Value Class [82](#value-class)](#value-class) + +[2.2.2.2.2 Reference Class [83](#reference-class)](#reference-class) + +[2.2.2.3 Control Tokens [83](#control-tokens)](#control-tokens) + +[2.2.2.4 Display Tokens [83](#display-tokens)](#display-tokens) + +[2.2.2.5 Mem Tokens [83](#mem-tokens)](#mem-tokens) + +[2.2.2.6 Formula Elements [83](#formula-elements)](#formula-elements) + +[2.2.3 Charts [83](#charts)](#charts) + +[2.2.3.1 Chart Sheet [84](#chart-sheet)](#chart-sheet) + +[2.2.3.2 Chart Data Cache [85](#chart-data-cache)](#chart-data-cache) + +[2.2.3.3 Chart [86](#chart-1)](#chart-1) + +[2.2.3.4 Pivot Chart [87](#pivot-chart)](#pivot-chart) + +[2.2.3.5 Axis Group [87](#axis-group)](#axis-group) + +[2.2.3.6 Axis [89](#axis)](#axis) + +[2.2.3.7 Chart Group [91](#chart-group)](#chart-group) + +[2.2.3.8 Legend [92](#legend)](#legend) + +[2.2.3.9 Series [94](#series)](#series) + +[2.2.3.10 Data Point [95](#data-point)](#data-point) + +[2.2.3.11 Data Label [95](#data-label)](#data-label) + +[2.2.3.12 Trendline [101](#trendline)](#trendline) + +[2.2.3.13 Error Bar [101](#error-bar)](#error-bar) + +[2.2.3.14 Data Table [102](#data-table)](#data-table) + +[2.2.3.15 Attached Label [103](#attached-label)](#attached-label) + +[2.2.3.16 SPRC [104](#sprc)](#sprc) + +[2.2.3.17 Chart Area [104](#chart-area)](#chart-area) + +[2.2.4 Metadata [104](#metadata)](#metadata) + +[2.2.4.1 Metadata Types [105](#metadata-types)](#metadata-types) + +[2.2.4.2 Cell Metadata [105](#cell-metadata)](#cell-metadata) + +[2.2.4.3 Value Metadata [105](#value-metadata)](#value-metadata) + +[2.2.4.4 Metadata Block [106](#metadata-block)](#metadata-block) + +[2.2.4.5 MDX Metadata [106](#mdx-metadata)](#mdx-metadata) + +[2.2.4.5.1 MDX Tuple Metadata [107](#mdx-tuple-metadata)](#mdx-tuple-metadata) + +[2.2.4.5.2 MDX Set Metadata [107](#mdx-set-metadata)](#mdx-set-metadata) + +[2.2.4.5.3 MDX Member Property Metadata [107](#mdx-member-property-metadata)](#mdx-member-property-metadata) + +[2.2.4.5.4 MDX KPI Metadata [107](#mdx-kpi-metadata)](#mdx-kpi-metadata) + +[2.2.5 PivotTables [107](#pivottables)](#pivottables) + +[2.2.5.1 PivotTable Records [108](#pivottable-records)](#pivottable-records) + +[2.2.5.1.1 Usage of SXAddl Records [108](#usage-of-sxaddl-records)](#usage-of-sxaddl-records) + +[2.2.5.1.1.1 Class [108](#class)](#class) + +[2.2.5.1.1.1.1 SxcView Class [109](#sxcview-class)](#sxcview-class) + +[2.2.5.1.1.1.2 SxcField Class [110](#sxcfield-class)](#sxcfield-class) + +[2.2.5.1.1.1.3 SxcHierarchy Class [110](#sxchierarchy-class)](#sxchierarchy-class) + +[2.2.5.1.1.1.4 SxcCache Class [111](#sxccache-class)](#sxccache-class) + +[2.2.5.1.1.1.5 SxcCacheField Class [112](#sxccachefield-class)](#sxccachefield-class) + +[2.2.5.1.1.1.6 SxcQsi Class [112](#sxcqsi-class)](#sxcqsi-class) + +[2.2.5.1.1.1.7 SxcQuery Class [113](#sxcquery-class)](#sxcquery-class) + +[2.2.5.1.1.1.8 SxcGrpLevel Class [113](#sxcgrplevel-class)](#sxcgrplevel-class) + +[2.2.5.1.1.1.9 SxcGroup Class [113](#sxcgroup-class)](#sxcgroup-class) + +[2.2.5.1.1.1.10 SxcCacheItem Class [114](#sxccacheitem-class)](#sxccacheitem-class) + +[2.2.5.1.1.1.11 SxcSXrule Class [114](#sxcsxrule-class)](#sxcsxrule-class) + +[2.2.5.1.1.1.12 SxcSXfilt Class [115](#sxcsxfilt-class)](#sxcsxfilt-class) + +[2.2.5.1.1.1.13 SxcSXDH Class [115](#sxcsxdh-class)](#sxcsxdh-class) + +[2.2.5.1.1.1.14 SxcAutoSort Class [115](#sxcautosort-class)](#sxcautosort-class) + +[2.2.5.1.1.1.15 SxcSXMgs Class [116](#sxcsxmgs-class)](#sxcsxmgs-class) + +[2.2.5.1.1.1.16 SxcSXMg Class [116](#sxcsxmg-class)](#sxcsxmg-class) + +[2.2.5.1.1.1.17 SxcField12 Class [116](#sxcfield12-class)](#sxcfield12-class) + +[2.2.5.1.1.1.18 SxcSXCondFmts Class [117](#sxcsxcondfmts-class)](#sxcsxcondfmts-class) + +[2.2.5.1.1.1.19 SxcSXCondFmt Class [117](#sxcsxcondfmt-class)](#sxcsxcondfmt-class) + +[2.2.5.1.1.1.20 SxcSXFilters12 Class [117](#sxcsxfilters12-class)](#sxcsxfilters12-class) + +[2.2.5.1.1.1.21 SxcSXFilter12 Class [118](#sxcsxfilter12-class)](#sxcsxfilter12-class) + +[2.2.5.2 Data Functionality Level [118](#data-functionality-level)](#data-functionality-level) + +[2.2.5.3 PivotCache [118](#pivotcache)](#pivotcache) + +[2.2.5.3.1 PivotCache Functionality Level [119](#pivotcache-functionality-level)](#pivotcache-functionality-level) + +[2.2.5.3.2 Source Data [119](#source-data)](#source-data) + +[2.2.5.3.2.1 Multiple Consolidation Ranges [120](#multiple-consolidation-ranges)](#multiple-consolidation-ranges) + +[2.2.5.3.3 Associated PivotTable views [122](#associated-pivottable-views)](#associated-pivottable-views) + +[2.2.5.3.4 OLAP PivotCache [122](#olap-pivotcache)](#olap-pivotcache) + +[2.2.5.3.4.1 OLAP Data Model [122](#olap-data-model)](#olap-data-model) + +[2.2.5.3.5 Cache Fields [123](#cache-fields)](#cache-fields) + +[2.2.5.3.6 Cache Items [124](#cache-items)](#cache-items) + +[2.2.5.3.7 Grouping [126](#grouping)](#grouping) + +[2.2.5.3.8 Calculated Fields [132](#calculated-fields)](#calculated-fields) + +[2.2.5.3.9 Calculated Items [133](#calculated-items)](#calculated-items) + +[2.2.5.3.10 OLAP Grouping [133](#olap-grouping)](#olap-grouping) + +[2.2.5.3.11 OLAP Calculated Members [133](#olap-calculated-members)](#olap-calculated-members) + +[2.2.5.3.12 Cache Records [134](#cache-records)](#cache-records) + +[2.2.5.4 PivotTable View [135](#pivottable-view)](#pivottable-view) + +[2.2.5.4.1 Associated PivotCache [135](#associated-pivotcache)](#associated-pivotcache) + +[2.2.5.4.2 OLAP PivotTable view [135](#olap-pivottable-view)](#olap-pivottable-view) + +[2.2.5.4.3 Pivot Fields [135](#pivot-fields)](#pivot-fields) + +[2.2.5.4.3.1 Pivot Field Sorting [136](#pivot-field-sorting)](#pivot-field-sorting) + +[2.2.5.4.4 Pivot Items [137](#pivot-items)](#pivot-items) + +[2.2.5.4.5 Pivot Hierarchies [137](#pivot-hierarchies)](#pivot-hierarchies) + +[2.2.5.4.5.1 Association of Pivot Hierarchies and Pivot Fields and Cache Fields [138](#association-of-pivot-hierarchies-and-pivot-fields-and-cache-fields)](#association-of-pivot-hierarchies-and-pivot-fields-and-cache-fields) + +[2.2.5.4.5.2 Measures [139](#measures)](#measures) + +[2.2.5.4.5.3 KPIs [139](#kpis)](#kpis) + +[2.2.5.4.5.4 Named Sets [139](#named-sets)](#named-sets) + +[2.2.5.4.6 Member Properties [139](#member-properties)](#member-properties) + +[2.2.5.4.7 Manual Filters [140](#manual-filters)](#manual-filters) + +[2.2.5.4.7.1 Non-OLAP Manual Filters [140](#non-olap-manual-filters)](#non-olap-manual-filters) + +[2.2.5.4.7.2 OLAP Manual Filters [140](#olap-manual-filters)](#olap-manual-filters) + +[2.2.5.4.8 Filtering by Criteria [141](#filtering-by-criteria)](#filtering-by-criteria) + +[2.2.5.4.8.1 Advanced Filters [141](#advanced-filters)](#advanced-filters) + +[2.2.5.4.8.1.1 Label Filters [142](#label-filters)](#label-filters) + +[2.2.5.4.8.1.2 Date Filters [142](#date-filters)](#date-filters) + +[2.2.5.4.8.1.3 Value Filters [143](#value-filters)](#value-filters) + +[2.2.5.4.8.2 Simple Filters [143](#simple-filters)](#simple-filters) + +[2.2.5.4.9 PivotTable Axes [143](#pivottable-axes)](#pivottable-axes) + +[2.2.5.4.9.1 Page Axis [143](#page-axis)](#page-axis) + +[2.2.5.4.9.1.1 Non-OLAP Page Filtering [144](#non-olap-page-filtering)](#non-olap-page-filtering) + +[2.2.5.4.9.1.2 OLAP Page Filtering [144](#olap-page-filtering)](#olap-page-filtering) + +[2.2.5.4.9.2 Row Axis [145](#row-axis)](#row-axis) + +[2.2.5.4.9.3 Column Axis [146](#column-axis)](#column-axis) + +[2.2.5.4.9.4 Nesting [146](#nesting)](#nesting) + +[2.2.5.4.9.4.1 Collapsing [147](#collapsing)](#collapsing) + +[2.2.5.4.9.4.2 Subtotalling [148](#subtotalling)](#subtotalling) + +[2.2.5.4.9.5 Data Axis [150](#data-axis)](#data-axis) + +[2.2.5.4.9.5.1 Data Items [150](#data-items)](#data-items) + +[2.2.5.4.9.5.2 Data Field [150](#data-field)](#data-field) + +[2.2.5.4.10 PivotTable Layout [150](#pivottable-layout)](#pivottable-layout) + +[2.2.5.4.10.1 Location and Body [151](#location-and-body)](#location-and-body) + +[2.2.5.4.10.1.1 Row Area [153](#row-area)](#row-area) + +[2.2.5.4.10.1.2 Column Area [154](#column-area)](#column-area) + +[2.2.5.4.10.1.3 Page Area [154](#page-area)](#page-area) + +[2.2.5.4.10.1.4 Data Area [155](#data-area)](#data-area) + +[2.2.5.4.10.2 Truncation [155](#truncation)](#truncation) + +[2.2.5.4.10.3 Pivot Lines [155](#pivot-lines)](#pivot-lines) + +[2.2.5.4.10.4 Pivot Line Entries [156](#pivot-line-entries)](#pivot-line-entries) + +[2.2.5.4.11 PivotTable Rules [157](#pivottable-rules)](#pivottable-rules) + +[2.2.6 Styles [158](#styles)](#styles) + +[2.2.6.1 XFs [158](#xfs)](#xfs) + +[2.2.6.1.1 Cell XFs [158](#cell-xfs)](#cell-xfs) + +[2.2.6.1.2 Cell Styles [158](#cell-styles)](#cell-styles) + +[2.2.6.1.2.1 Cell Style XFs [159](#cell-style-xfs)](#cell-style-xfs) + +[2.2.6.1.2.2 Normal Style [159](#normal-style)](#normal-style) + +[2.2.6.2 Differential Formatting (DXFs) [159](#differential-formatting-dxfs)](#differential-formatting-dxfs) + +[2.2.6.2.1 Conditional Formatting [159](#conditional-formatting)](#conditional-formatting) + +[2.2.6.2.2 Table Style Elements [160](#table-style-elements)](#table-style-elements) + +[2.2.6.2.3 Table Block-Level Formatting [160](#table-block-level-formatting)](#table-block-level-formatting) + +[2.2.6.2.4 PivotTable Areas [160](#pivottable-areas)](#pivottable-areas) + +[2.2.6.2.5 Sorting and Filtering [160](#sorting-and-filtering)](#sorting-and-filtering) + +[2.2.6.3 Table Styles [160](#table-styles)](#table-styles) + +[2.2.6.4 Format Conflicts [160](#format-conflicts)](#format-conflicts) + +[2.2.7 External References [161](#external-references)](#external-references) + +[2.2.7.1 External Reference Consumers [161](#external-reference-consumers)](#external-reference-consumers) + +[2.2.7.2 Supporting Link [161](#supporting-link)](#supporting-link) + +[2.2.7.3 External Workbook [162](#external-workbook)](#external-workbook) + +[2.2.7.4 External Defined Name [162](#external-defined-name)](#external-defined-name) + +[2.2.7.5 External Cell Cache [162](#external-cell-cache)](#external-cell-cache) + +[2.2.7.6 DDE Data Source [162](#dde-data-source)](#dde-data-source) + +[2.2.7.7 DDE Data Item [162](#dde-data-item)](#dde-data-item) + +[2.2.7.8 OLE Data Source [162](#ole-data-source)](#ole-data-source) + +[2.2.7.9 OLE Data Item [162](#ole-data-item)](#ole-data-item) + +[2.2.8 External Connections [163](#external-connections)](#external-connections) + +[2.2.8.1 Connection Name [163](#connection-name)](#connection-name) + +[2.2.8.2 External Connection Files [163](#external-connection-files)](#external-connection-files) + +[2.2.8.3 OLE DB Connections [163](#ole-db-connections)](#ole-db-connections) + +[2.2.8.3.1 OLAP Connections [163](#olap-connections)](#olap-connections) + +[2.2.8.4 ODBC Connections [164](#odbc-connections)](#odbc-connections) + +[2.2.8.5 Web Connections [164](#web-connections)](#web-connections) + +[2.2.8.6 Text Import Connections [164](#text-import-connections)](#text-import-connections) + +[2.2.8.7 ADO Recordset Connections [164](#ado-recordset-connections)](#ado-recordset-connections) + +[2.2.8.8 DAO Recordset Connections [164](#dao-recordset-connections)](#dao-recordset-connections) + +[2.2.9 Password Verifier Algorithm [164](#password-verifier-algorithm)](#password-verifier-algorithm) + +[2.2.10 Encryption (Password to Open) [165](#encryption-password-to-open)](#encryption-password-to-open) + +[2.2.11 Shared Workbooks [166](#shared-workbooks)](#shared-workbooks) + +[2.2.11.1 User Log [168](#user-log)](#user-log) + +[2.2.11.2 Revision Logs [168](#revision-logs)](#revision-logs) + +[2.2.11.3 Revision Records [168](#revision-records)](#revision-records) + +[2.2.11.4 Insertion / Deletion of Rows / Columns Revision [168](#insertion-deletion-of-rows-columns-revision)](#insertion-deletion-of-rows-columns-revision) + +[2.2.11.5 Move Cells Revision [169](#move-cells-revision)](#move-cells-revision) + +[2.2.11.6 Change Cells Revision [169](#change-cells-revision)](#change-cells-revision) + +[2.2.11.7 Sort Map [169](#sort-map)](#sort-map) + +[2.2.12 Shared Feature [169](#shared-feature)](#shared-feature) + +[2.3 Record Enumeration [169](#record-enumeration)](#record-enumeration) + +[2.3.1 By Name [170](#by-name)](#by-name) + +[2.3.2 By Number [181](#by-number)](#by-number) + +[2.4 Records [192](#records)](#records) + +[2.4.1 AlRuns [192](#alruns)](#alruns) + +[2.4.2 Area [192](#area)](#area) + +[2.4.3 AreaFormat [193](#areaformat)](#areaformat) + +[2.4.4 Array [198](#array)](#array) + +[2.4.5 AttachedLabel [199](#attachedlabel)](#attachedlabel) + +[2.4.6 AutoFilter [200](#autofilter)](#autofilter) + +[2.4.7 AutoFilter12 [202](#autofilter12)](#autofilter12) + +[2.4.8 AutoFilterInfo [205](#autofilterinfo)](#autofilterinfo) + +[2.4.9 AxcExt [205](#axcext)](#axcext) + +[2.4.10 AxesUsed [208](#axesused)](#axesused) + +[2.4.11 Axis [208](#axis-1)](#axis-1) + +[2.4.12 AxisLine [209](#axisline)](#axisline) + +[2.4.13 AxisParent [210](#axisparent)](#axisparent) + +[2.4.14 Backup [210](#backup)](#backup) + +[2.4.15 Bar [210](#bar)](#bar) + +[2.4.16 BCUsrs [211](#bcusrs)](#bcusrs) + +[2.4.17 Begin [211](#begin)](#begin) + +[2.4.18 BigName [212](#bigname)](#bigname) + +[2.4.19 BkHim [212](#bkhim)](#bkhim) + +[2.4.20 Blank [213](#blank)](#blank) + +[2.4.21 BOF [213](#bof)](#bof) + +[2.4.22 BookBool [215](#bookbool)](#bookbool) + +[2.4.23 BookExt [216](#bookext)](#bookext) + +[2.4.24 BoolErr [217](#boolerr)](#boolerr) + +[2.4.25 BopPop [217](#boppop)](#boppop) + +[2.4.26 BopPopCustom [219](#boppopcustom)](#boppopcustom) + +[2.4.27 BottomMargin [220](#bottommargin)](#bottommargin) + +[2.4.28 BoundSheet8 [221](#boundsheet8)](#boundsheet8) + +[2.4.29 BRAI [222](#brai)](#brai) + +[2.4.30 BuiltInFnGroupCount [223](#builtinfngroupcount)](#builtinfngroupcount) + +[2.4.31 CalcCount [224](#calccount)](#calccount) + +[2.4.32 CalcDelta [224](#calcdelta)](#calcdelta) + +[2.4.33 CalcIter [224](#calciter)](#calciter) + +[2.4.34 CalcMode [224](#calcmode)](#calcmode) + +[2.4.35 CalcPrecision [225](#calcprecision)](#calcprecision) + +[2.4.36 CalcRefMode [225](#calcrefmode)](#calcrefmode) + +[2.4.37 CalcSaveRecalc [225](#calcsaverecalc)](#calcsaverecalc) + +[2.4.38 CatLab [226](#catlab)](#catlab) + +[2.4.39 CatSerRange [226](#catserrange)](#catserrange) + +[2.4.40 CbUsr [228](#cbusr)](#cbusr) + +[2.4.41 CellWatch [228](#cellwatch)](#cellwatch) + +[2.4.42 CF [229](#cf)](#cf) + +[2.4.43 CF12 [230](#cf12)](#cf12) + +[2.4.44 CFEx [233](#cfex)](#cfex) + +[2.4.45 Chart [234](#chart-2)](#chart-2) + +[2.4.46 Chart3d [235](#chart3d)](#chart3d) + +[2.4.47 Chart3DBarShape [237](#chart3dbarshape)](#chart3dbarshape) + +[2.4.48 ChartFormat [237](#chartformat)](#chartformat) + +[2.4.49 ChartFrtInfo [238](#chartfrtinfo)](#chartfrtinfo) + +[2.4.50 ClrtClient [239](#clrtclient)](#clrtclient) + +[2.4.51 CodeName [240](#codename)](#codename) + +[2.4.52 CodePage [240](#codepage)](#codepage) + +[2.4.53 ColInfo [241](#colinfo)](#colinfo) + +[2.4.54 Compat12 [242](#compat12)](#compat12) + +[2.4.55 CompressPictures [242](#compresspictures)](#compresspictures) + +[2.4.56 CondFmt [243](#condfmt)](#condfmt) + +[2.4.57 CondFmt12 [243](#condfmt12)](#condfmt12) + +[2.4.58 Continue [244](#continue)](#continue) + +[2.4.59 ContinueBigName [244](#continuebigname)](#continuebigname) + +[2.4.60 ContinueFrt [245](#continuefrt)](#continuefrt) + +[2.4.61 ContinueFrt11 [245](#continuefrt11)](#continuefrt11) + +[2.4.62 ContinueFrt12 [246](#continuefrt12)](#continuefrt12) + +[2.4.63 Country [246](#country)](#country) + +[2.4.64 CrErr [248](#crerr)](#crerr) + +[2.4.65 CRN [248](#crn)](#crn) + +[2.4.66 CrtLayout12 [249](#crtlayout12)](#crtlayout12) + +[2.4.67 CrtLayout12A [251](#crtlayout12a)](#crtlayout12a) + +[2.4.68 CrtLine [253](#crtline)](#crtline) + +[2.4.69 CrtLink [254](#crtlink)](#crtlink) + +[2.4.70 CrtMlFrt [254](#crtmlfrt)](#crtmlfrt) + +[2.4.71 CrtMlFrtContinue [255](#crtmlfrtcontinue)](#crtmlfrtcontinue) + +[2.4.72 CUsr [255](#cusr)](#cusr) + +[2.4.73 Dat [255](#dat)](#dat) + +[2.4.74 DataFormat [256](#dataformat)](#dataformat) + +[2.4.75 DataLabExt [256](#datalabext)](#datalabext) + +[2.4.76 DataLabExtContents [257](#datalabextcontents)](#datalabextcontents) + +[2.4.77 Date1904 [258](#date1904)](#date1904) + +[2.4.78 DBCell [258](#dbcell)](#dbcell) + +[2.4.79 DbOrParamQry [259](#dborparamqry)](#dborparamqry) + +[2.4.80 DbQuery [259](#dbquery)](#dbquery) + +[2.4.81 DBQueryExt [261](#dbqueryext)](#dbqueryext) + +[2.4.82 DCon [263](#dcon)](#dcon) + +[2.4.83 DConBin [265](#dconbin)](#dconbin) + +[2.4.84 DConn [266](#dconn)](#dconn) + +[2.4.85 DConName [271](#dconname)](#dconname) + +[2.4.86 DConRef [272](#dconref)](#dconref) + +[2.4.87 DefaultRowHeight [273](#defaultrowheight)](#defaultrowheight) + +[2.4.88 DefaultText [273](#defaulttext)](#defaulttext) + +[2.4.89 DefColWidth [274](#defcolwidth)](#defcolwidth) + +[2.4.90 Dimensions [274](#dimensions)](#dimensions) + +[2.4.91 DocRoute [275](#docroute)](#docroute) + +[2.4.92 DropBar [277](#dropbar)](#dropbar) + +[2.4.93 DropDownObjIds [278](#dropdownobjids)](#dropdownobjids) + +[2.4.94 DSF [278](#dsf)](#dsf) + +[2.4.95 Dv [278](#dv)](#dv) + +[2.4.96 DVal [281](#dval)](#dval) + +[2.4.97 DXF [282](#dxf)](#dxf) + +[2.4.98 DxGCol [283](#dxgcol)](#dxgcol) + +[2.4.99 End [283](#end)](#end) + +[2.4.100 EndBlock [283](#endblock)](#endblock) + +[2.4.101 EndObject [285](#endobject)](#endobject) + +[2.4.102 EntExU2 [286](#entexu2)](#entexu2) + +[2.4.103 EOF [286](#eof)](#eof) + +[2.4.104 Excel9File [286](#excel9file)](#excel9file) + +[2.4.105 ExternName [286](#externname)](#externname) + +[2.4.106 ExternSheet [288](#externsheet)](#externsheet) + +[2.4.107 ExtSST [289](#extsst)](#extsst) + +[2.4.108 ExtString [289](#extstring)](#extstring) + +[2.4.109 Fbi [290](#fbi)](#fbi) + +[2.4.110 Fbi2 [291](#fbi2)](#fbi2) + +[2.4.111 Feat [292](#feat)](#feat) + +[2.4.112 FeatHdr [293](#feathdr)](#feathdr) + +[2.4.113 FeatHdr11 [294](#feathdr11)](#feathdr11) + +[2.4.114 Feature11 [294](#feature11)](#feature11) + +[2.4.115 Feature12 [296](#feature12)](#feature12) + +[2.4.116 FileLock [296](#filelock)](#filelock) + +[2.4.117 FilePass [297](#filepass)](#filepass) + +[2.4.118 FileSharing [298](#filesharing)](#filesharing) + +[2.4.119 FilterMode [298](#filtermode)](#filtermode) + +[2.4.120 FnGroupName [298](#fngroupname)](#fngroupname) + +[2.4.121 FnGrp12 [298](#fngrp12)](#fngrp12) + +[2.4.122 Font [299](#font)](#font) + +[2.4.123 FontX [301](#fontx)](#fontx) + +[2.4.124 Footer [302](#footer)](#footer) + +[2.4.125 ForceFullCalculation [302](#forcefullcalculation)](#forcefullcalculation) + +[2.4.126 Format [303](#format)](#format) + +[2.4.127 Formula [310](#formula)](#formula) + +[2.4.128 Frame [311](#frame)](#frame) + +[2.4.129 FrtFontList [312](#frtfontlist)](#frtfontlist) + +[2.4.130 FrtWrapper [312](#frtwrapper)](#frtwrapper) + +[2.4.131 GelFrame [313](#gelframe)](#gelframe) + +[2.4.132 GridSet [315](#gridset)](#gridset) + +[2.4.133 GUIDTypeLib [315](#guidtypelib)](#guidtypelib) + +[2.4.134 Guts [315](#guts)](#guts) + +[2.4.135 HCenter [316](#hcenter)](#hcenter) + +[2.4.136 Header [316](#header)](#header) + +[2.4.137 HeaderFooter [320](#headerfooter)](#headerfooter) + +[2.4.138 HFPicture [321](#hfpicture)](#hfpicture) + +[2.4.139 HideObj [323](#hideobj)](#hideobj) + +[2.4.140 HLink [323](#hlink)](#hlink) + +[2.4.141 HLinkTooltip [323](#hlinktooltip)](#hlinktooltip) + +[2.4.142 HorizontalPageBreaks [324](#horizontalpagebreaks)](#horizontalpagebreaks) + +[2.4.143 IFmtRecord [324](#ifmtrecord)](#ifmtrecord) + +[2.4.144 Index [324](#index)](#index) + +[2.4.145 InterfaceEnd [325](#interfaceend)](#interfaceend) + +[2.4.146 InterfaceHdr [325](#interfacehdr)](#interfacehdr) + +[2.4.147 Intl [325](#intl)](#intl) + +[2.4.148 Label [326](#label)](#label) + +[2.4.149 LabelSst [326](#labelsst)](#labelsst) + +[2.4.150 Lbl [326](#lbl)](#lbl) + +[2.4.151 LeftMargin [329](#leftmargin)](#leftmargin) + +[2.4.152 Legend [329](#legend-1)](#legend-1) + +[2.4.153 LegendException [330](#legendexception)](#legendexception) + +[2.4.154 Lel [331](#lel)](#lel) + +[2.4.155 Line [331](#line)](#line) + +[2.4.156 LineFormat [332](#lineformat)](#lineformat) + +[2.4.157 List12 [333](#list12)](#list12) + +[2.4.158 LPr [334](#lpr)](#lpr) + +[2.4.159 LRng [335](#lrng)](#lrng) + +[2.4.160 MarkerFormat [335](#markerformat)](#markerformat) + +[2.4.161 MDB [337](#mdb)](#mdb) + +[2.4.162 MDTInfo [337](#mdtinfo)](#mdtinfo) + +[2.4.163 MDXKPI [339](#mdxkpi)](#mdxkpi) + +[2.4.164 MDXProp [340](#mdxprop)](#mdxprop) + +[2.4.165 MDXSet [340](#mdxset)](#mdxset) + +[2.4.166 MDXStr [341](#mdxstr)](#mdxstr) + +[2.4.167 MDXTuple [342](#mdxtuple)](#mdxtuple) + +[2.4.168 MergeCells [342](#mergecells)](#mergecells) + +[2.4.169 Mms [343](#mms)](#mms) + +[2.4.170 MsoDrawing [343](#msodrawing)](#msodrawing) + +[2.4.171 MsoDrawingGroup [343](#msodrawinggroup)](#msodrawinggroup) + +[2.4.172 MsoDrawingSelection [344](#msodrawingselection)](#msodrawingselection) + +[2.4.173 MTRSettings [344](#mtrsettings)](#mtrsettings) + +[2.4.174 MulBlank [345](#mulblank)](#mulblank) + +[2.4.175 MulRk [345](#mulrk)](#mulrk) + +[2.4.176 NameCmt [346](#namecmt)](#namecmt) + +[2.4.177 NameFnGrp12 [347](#namefngrp12)](#namefngrp12) + +[2.4.178 NamePublish [348](#namepublish)](#namepublish) + +[2.4.179 Note [348](#note)](#note) + +[2.4.180 Number [349](#number)](#number) + +[2.4.181 Obj [349](#obj)](#obj) + +[2.4.182 ObjectLink [352](#objectlink)](#objectlink) + +[2.4.183 ObjProtect [352](#objprotect)](#objprotect) + +[2.4.184 ObNoMacros [353](#obnomacros)](#obnomacros) + +[2.4.185 ObProj [353](#obproj)](#obproj) + +[2.4.186 OleDbConn [353](#oledbconn)](#oledbconn) + +[2.4.187 OleObjectSize [354](#oleobjectsize)](#oleobjectsize) + +[2.4.188 Palette [354](#palette)](#palette) + +[2.4.189 Pane [354](#pane)](#pane) + +[2.4.190 ParamQry [355](#paramqry)](#paramqry) + +[2.4.191 Password [355](#password)](#password) + +[2.4.192 PhoneticInfo [356](#phoneticinfo)](#phoneticinfo) + +[2.4.193 PicF [356](#picf)](#picf) + +[2.4.194 Pie [357](#pie)](#pie) + +[2.4.195 PieFormat [358](#pieformat)](#pieformat) + +[2.4.196 PivotChartBits [358](#pivotchartbits)](#pivotchartbits) + +[2.4.197 PlotArea [359](#plotarea)](#plotarea) + +[2.4.198 PlotGrowth [359](#plotgrowth)](#plotgrowth) + +[2.4.199 Pls [359](#pls)](#pls) + +[2.4.200 PLV [360](#plv)](#plv) + +[2.4.201 Pos [360](#pos)](#pos) + +[2.4.202 PrintGrid [362](#printgrid)](#printgrid) + +[2.4.203 PrintRowCol [362](#printrowcol)](#printrowcol) + +[2.4.204 PrintSize [363](#printsize)](#printsize) + +[2.4.205 Prot4Rev [363](#prot4rev)](#prot4rev) + +[2.4.206 Prot4RevPass [364](#prot4revpass)](#prot4revpass) + +[2.4.207 Protect [364](#protect)](#protect) + +[2.4.208 Qsi [364](#qsi)](#qsi) + +[2.4.209 Qsif [367](#qsif)](#qsif) + +[2.4.210 Qsir [368](#qsir)](#qsir) + +[2.4.211 QsiSXTag [370](#qsisxtag)](#qsisxtag) + +[2.4.212 Radar [372](#radar)](#radar) + +[2.4.213 RadarArea [372](#radararea)](#radararea) + +[2.4.214 RealTimeData [373](#realtimedata)](#realtimedata) + +[2.4.215 RecalcId [374](#recalcid)](#recalcid) + +[2.4.216 RecipName [374](#recipname)](#recipname) + +[2.4.217 RefreshAll [375](#refreshall)](#refreshall) + +[2.4.218 RichTextStream [375](#richtextstream)](#richtextstream) + +[2.4.219 RightMargin [377](#rightmargin)](#rightmargin) + +[2.4.220 RK [377](#rk)](#rk) + +[2.4.221 Row [378](#row)](#row) + +[2.4.222 RRAutoFmt [379](#rrautofmt)](#rrautofmt) + +[2.4.223 RRDChgCell [380](#rrdchgcell)](#rrdchgcell) + +[2.4.224 RRDConflict [384](#rrdconflict)](#rrdconflict) + +[2.4.225 RRDDefName [385](#rrddefname)](#rrddefname) + +[2.4.226 RRDHead [387](#rrdhead)](#rrdhead) + +[2.4.227 RRDInfo [389](#rrdinfo)](#rrdinfo) + +[2.4.228 RRDInsDel [390](#rrdinsdel)](#rrdinsdel) + +[2.4.229 RRDInsDelBegin [391](#rrdinsdelbegin)](#rrdinsdelbegin) + +[2.4.230 RRDInsDelEnd [391](#rrdinsdelend)](#rrdinsdelend) + +[2.4.231 RRDMove [391](#rrdmove)](#rrdmove) + +[2.4.232 RRDMoveBegin [392](#rrdmovebegin)](#rrdmovebegin) + +[2.4.233 RRDMoveEnd [392](#rrdmoveend)](#rrdmoveend) + +[2.4.234 RRDRenSheet [392](#rrdrensheet)](#rrdrensheet) + +[2.4.235 RRDRstEtxp [393](#rrdrstetxp)](#rrdrstetxp) + +[2.4.236 RRDTQSIF [394](#rrdtqsif)](#rrdtqsif) + +[2.4.237 RRDUserView [395](#rrduserview)](#rrduserview) + +[2.4.238 RRFormat [396](#rrformat)](#rrformat) + +[2.4.239 RRInsertSh [396](#rrinsertsh)](#rrinsertsh) + +[2.4.240 RRSort [397](#rrsort)](#rrsort) + +[2.4.241 RRTabId [398](#rrtabid)](#rrtabid) + +[2.4.242 SBaseRef [398](#sbaseref)](#sbaseref) + +[2.4.243 Scatter [399](#scatter)](#scatter) + +[2.4.244 SCENARIO [400](#scenario)](#scenario) + +[2.4.245 ScenarioProtect [401](#scenarioprotect)](#scenarioprotect) + +[2.4.246 ScenMan [401](#scenman)](#scenman) + +[2.4.247 Scl [402](#scl)](#scl) + +[2.4.248 Selection [402](#selection)](#selection) + +[2.4.249 SerAuxErrBar [403](#serauxerrbar)](#serauxerrbar) + +[2.4.250 SerAuxTrend [404](#serauxtrend)](#serauxtrend) + +[2.4.251 SerFmt [405](#serfmt)](#serfmt) + +[2.4.252 Series [406](#series-1)](#series-1) + +[2.4.253 SeriesList [407](#serieslist)](#serieslist) + +[2.4.254 SeriesText [407](#seriestext)](#seriestext) + +[2.4.255 SerParent [407](#serparent)](#serparent) + +[2.4.256 SerToCrt [408](#sertocrt)](#sertocrt) + +[2.4.257 Setup [408](#setup)](#setup) + +[2.4.258 ShapePropsStream [413](#shapepropsstream)](#shapepropsstream) + +[2.4.259 SheetExt [414](#sheetext)](#sheetext) + +[2.4.260 ShrFmla [415](#shrfmla)](#shrfmla) + +[2.4.261 ShtProps [415](#shtprops)](#shtprops) + +[2.4.262 SIIndex [416](#siindex)](#siindex) + +[2.4.263 Sort [417](#sort)](#sort) + +[2.4.264 SortData [418](#sortdata)](#sortdata) + +[2.4.265 SST [420](#sst)](#sst) + +[2.4.266 StartBlock [421](#startblock)](#startblock) + +[2.4.267 StartObject [426](#startobject)](#startobject) + +[2.4.268 String [427](#string)](#string) + +[2.4.269 Style [427](#style)](#style) + +[2.4.270 StyleExt [428](#styleext)](#styleext) + +[2.4.271 SupBook [429](#supbook)](#supbook) + +[2.4.272 Surf [431](#surf)](#surf) + +[2.4.273 SXAddl Records [432](#sxaddl-records)](#sxaddl-records) + +[2.4.273.1 Continue_SxaddlSxString [432](#continue_sxaddlsxstring)](#continue_sxaddlsxstring) + +[2.4.273.2 SXAddl [432](#sxaddl)](#sxaddl) + +[2.4.273.3 SXAddl_SXCAutoSort_SXDEnd [433](#sxaddl_sxcautosort_sxdend)](#sxaddl_sxcautosort_sxdend) + +[2.4.273.4 SXAddl_SXCAutoSort_SXDId [433](#sxaddl_sxcautosort_sxdid)](#sxaddl_sxcautosort_sxdid) + +[2.4.273.5 SXAddl_SXCCache_SXDEnd [434](#sxaddl_sxccache_sxdend)](#sxaddl_sxccache_sxdend) + +[2.4.273.6 SXAddl_SXCCache_SXDId [434](#sxaddl_sxccache_sxdid)](#sxaddl_sxccache_sxdid) + +[2.4.273.7 SXAddl_SXCCache_SXDInfo12 [434](#sxaddl_sxccache_sxdinfo12)](#sxaddl_sxccache_sxdinfo12) + +[2.4.273.8 SXAddl_SXCCache_SXDInvRefreshReal [435](#sxaddl_sxccache_sxdinvrefreshreal)](#sxaddl_sxccache_sxdinvrefreshreal) + +[2.4.273.9 SXAddl_SXCCache_SXDVer10Info [435](#sxaddl_sxccache_sxdver10info)](#sxaddl_sxccache_sxdver10info) + +[2.4.273.10 SXAddl_SXCCache_SXDVerSXMacro [436](#sxaddl_sxccache_sxdversxmacro)](#sxaddl_sxccache_sxdversxmacro) + +[2.4.273.11 SXAddl_SXCCache_SXDVerUpdInv [437](#sxaddl_sxccache_sxdverupdinv)](#sxaddl_sxccache_sxdverupdinv) + +[2.4.273.12 SXAddl_SXCCacheField_SXDCaption [437](#sxaddl_sxccachefield_sxdcaption)](#sxaddl_sxccachefield_sxdcaption) + +[2.4.273.13 SXAddl_SXCCacheField_SXDEnd [437](#sxaddl_sxccachefield_sxdend)](#sxaddl_sxccachefield_sxdend) + +[2.4.273.14 SXAddl_SXCCacheField_SXDId [438](#sxaddl_sxccachefield_sxdid)](#sxaddl_sxccachefield_sxdid) + +[2.4.273.15 SXAddl_SXCCacheField_SXDIfdbMempropMap [438](#sxaddl_sxccachefield_sxdifdbmempropmap)](#sxaddl_sxccachefield_sxdifdbmempropmap) + +[2.4.273.16 SXAddl_SXCCacheField_SXDIfdbMpMapCount [439](#sxaddl_sxccachefield_sxdifdbmpmapcount)](#sxaddl_sxccachefield_sxdifdbmpmapcount) + +[2.4.273.17 SXAddl_SXCCacheField_SXDProperty [439](#sxaddl_sxccachefield_sxdproperty)](#sxaddl_sxccachefield_sxdproperty) + +[2.4.273.18 SXAddl_SXCCacheField_SXDPropName [440](#sxaddl_sxccachefield_sxdpropname)](#sxaddl_sxccachefield_sxdpropname) + +[2.4.273.19 SXAddl_SXCCacheField_SXDSxrmitmCount [440](#sxaddl_sxccachefield_sxdsxrmitmcount)](#sxaddl_sxccachefield_sxdsxrmitmcount) + +[2.4.273.20 SXAddl_SXCCacheItem_SXDEnd [441](#sxaddl_sxccacheitem_sxdend)](#sxaddl_sxccacheitem_sxdend) + +[2.4.273.21 SXAddl_SXCCacheItem_SXDId [441](#sxaddl_sxccacheitem_sxdid)](#sxaddl_sxccacheitem_sxdid) + +[2.4.273.22 SXAddl_SXCCacheItem_SXDItmMpMapCount [441](#sxaddl_sxccacheitem_sxditmmpmapcount)](#sxaddl_sxccacheitem_sxditmmpmapcount) + +[2.4.273.23 SXAddl_SXCCacheItem_SXDItmMpropMap [442](#sxaddl_sxccacheitem_sxditmmpropmap)](#sxaddl_sxccacheitem_sxditmmpropmap) + +[2.4.273.24 SXAddl_SXCCacheItem_SXDSxrmitmDisp [442](#sxaddl_sxccacheitem_sxdsxrmitmdisp)](#sxaddl_sxccacheitem_sxdsxrmitmdisp) + +[2.4.273.25 SXAddl_SXCField_SXDEnd [443](#sxaddl_sxcfield_sxdend)](#sxaddl_sxcfield_sxdend) + +[2.4.273.26 SXAddl_SXCField_SXDId [443](#sxaddl_sxcfield_sxdid)](#sxaddl_sxcfield_sxdid) + +[2.4.273.27 SXAddl_SXCField_SXDVer10Info [443](#sxaddl_sxcfield_sxdver10info)](#sxaddl_sxcfield_sxdver10info) + +[2.4.273.28 SXAddl_SXCField12_SXDAutoshow [444](#sxaddl_sxcfield12_sxdautoshow)](#sxaddl_sxcfield12_sxdautoshow) + +[2.4.273.29 SXAddl_SXCField12_SXDEnd [444](#sxaddl_sxcfield12_sxdend)](#sxaddl_sxcfield12_sxdend) + +[2.4.273.30 SXAddl_SXCField12_SXDId [445](#sxaddl_sxcfield12_sxdid)](#sxaddl_sxcfield12_sxdid) + +[2.4.273.31 SXAddl_SXCField12_SXDISXTH [445](#sxaddl_sxcfield12_sxdisxth)](#sxaddl_sxcfield12_sxdisxth) + +[2.4.273.32 SXAddl_SXCField12_SXDMemberCaption [446](#sxaddl_sxcfield12_sxdmembercaption)](#sxaddl_sxcfield12_sxdmembercaption) + +[2.4.273.33 SXAddl_SXCField12_SXDVer12Info [446](#sxaddl_sxcfield12_sxdver12info)](#sxaddl_sxcfield12_sxdver12info) + +[2.4.273.34 SXAddl_SXCField12_SXDVerUpdInv [447](#sxaddl_sxcfield12_sxdverupdinv)](#sxaddl_sxcfield12_sxdverupdinv) + +[2.4.273.35 SXAddl_SXCGroup_SXDEnd [447](#sxaddl_sxcgroup_sxdend)](#sxaddl_sxcgroup_sxdend) + +[2.4.273.36 SXAddl_SXCGroup_SXDGrpInfo [448](#sxaddl_sxcgroup_sxdgrpinfo)](#sxaddl_sxcgroup_sxdgrpinfo) + +[2.4.273.37 SXAddl_SXCGroup_SXDId [449](#sxaddl_sxcgroup_sxdid)](#sxaddl_sxcgroup_sxdid) + +[2.4.273.38 SXAddl_SXCGroup_SXDMember [449](#sxaddl_sxcgroup_sxdmember)](#sxaddl_sxcgroup_sxdmember) + +[2.4.273.39 SXAddl_SXCGrpLevel_SXDEnd [450](#sxaddl_sxcgrplevel_sxdend)](#sxaddl_sxcgrplevel_sxdend) + +[2.4.273.40 SXAddl_SXCGrpLevel_SXDGrpLevelInfo [450](#sxaddl_sxcgrplevel_sxdgrplevelinfo)](#sxaddl_sxcgrplevel_sxdgrplevelinfo) + +[2.4.273.41 SXAddl_SXCGrpLevel_SXDId [451](#sxaddl_sxcgrplevel_sxdid)](#sxaddl_sxcgrplevel_sxdid) + +[2.4.273.42 SXAddl_SXCHierarchy_SXDDisplayFolder [451](#sxaddl_sxchierarchy_sxddisplayfolder)](#sxaddl_sxchierarchy_sxddisplayfolder) + +[2.4.273.43 SXAddl_SXCHierarchy_SXDEnd [452](#sxaddl_sxchierarchy_sxdend)](#sxaddl_sxchierarchy_sxdend) + +[2.4.273.44 SXAddl_SXCHierarchy_SXDFilterMember [452](#sxaddl_sxchierarchy_sxdfiltermember)](#sxaddl_sxchierarchy_sxdfiltermember) + +[2.4.273.45 SXAddl_SXCHierarchy_SXDFilterMember12 [453](#sxaddl_sxchierarchy_sxdfiltermember12)](#sxaddl_sxchierarchy_sxdfiltermember12) + +[2.4.273.46 SXAddl_SXCHierarchy_SXDIconSet [454](#sxaddl_sxchierarchy_sxdiconset)](#sxaddl_sxchierarchy_sxdiconset) + +[2.4.273.47 SXAddl_SXCHierarchy_SXDId [454](#sxaddl_sxchierarchy_sxdid)](#sxaddl_sxchierarchy_sxdid) + +[2.4.273.48 SXAddl_SXCHierarchy_SXDInfo12 [455](#sxaddl_sxchierarchy_sxdinfo12)](#sxaddl_sxchierarchy_sxdinfo12) + +[2.4.273.49 SXAddl_SXCHierarchy_SXDKPIGoal [456](#sxaddl_sxchierarchy_sxdkpigoal)](#sxaddl_sxchierarchy_sxdkpigoal) + +[2.4.273.50 SXAddl_SXCHierarchy_SXDKPIStatus [456](#sxaddl_sxchierarchy_sxdkpistatus)](#sxaddl_sxchierarchy_sxdkpistatus) + +[2.4.273.51 SXAddl_SXCHierarchy_SXDKPITime [456](#sxaddl_sxchierarchy_sxdkpitime)](#sxaddl_sxchierarchy_sxdkpitime) + +[2.4.273.52 SXAddl_SXCHierarchy_SXDKPITrend [457](#sxaddl_sxchierarchy_sxdkpitrend)](#sxaddl_sxchierarchy_sxdkpitrend) + +[2.4.273.53 SXAddl_SXCHierarchy_SXDKPIValue [457](#sxaddl_sxchierarchy_sxdkpivalue)](#sxaddl_sxchierarchy_sxdkpivalue) + +[2.4.273.54 SXAddl_SXCHierarchy_SXDKPIWeight [458](#sxaddl_sxchierarchy_sxdkpiweight)](#sxaddl_sxchierarchy_sxdkpiweight) + +[2.4.273.55 SXAddl_SXCHierarchy_SXDMeasureGrp [458](#sxaddl_sxchierarchy_sxdmeasuregrp)](#sxaddl_sxchierarchy_sxdmeasuregrp) + +[2.4.273.56 SXAddl_SXCHierarchy_SXDParentKPI [459](#sxaddl_sxchierarchy_sxdparentkpi)](#sxaddl_sxchierarchy_sxdparentkpi) + +[2.4.273.57 SXAddl_SXCHierarchy_SXDProperty [459](#sxaddl_sxchierarchy_sxdproperty)](#sxaddl_sxchierarchy_sxdproperty) + +[2.4.273.58 SXAddl_SXCHierarchy_SXDSXSetParentUnique [461](#sxaddl_sxchierarchy_sxdsxsetparentunique)](#sxaddl_sxchierarchy_sxdsxsetparentunique) + +[2.4.273.59 SXAddl_SXCHierarchy_SXDUserCaption [461](#sxaddl_sxchierarchy_sxdusercaption)](#sxaddl_sxchierarchy_sxdusercaption) + +[2.4.273.60 SXAddl_SXCHierarchy_SXDVerUpdInv [461](#sxaddl_sxchierarchy_sxdverupdinv)](#sxaddl_sxchierarchy_sxdverupdinv) + +[2.4.273.61 SXAddl_SXCQsi_SXDEnd [462](#sxaddl_sxcqsi_sxdend)](#sxaddl_sxcqsi_sxdend) + +[2.4.273.62 SXAddl_SXCQsi_SXDId [462](#sxaddl_sxcqsi_sxdid)](#sxaddl_sxcqsi_sxdid) + +[2.4.273.63 SXAddl_SXCQuery_SXDEnd [462](#sxaddl_sxcquery_sxdend)](#sxaddl_sxcquery_sxdend) + +[2.4.273.64 SXAddl_SXCQuery_SXDReconnCond [463](#sxaddl_sxcquery_sxdreconncond)](#sxaddl_sxcquery_sxdreconncond) + +[2.4.273.65 SXAddl_SXCQuery_SXDSrcConnFile [464](#sxaddl_sxcquery_sxdsrcconnfile)](#sxaddl_sxcquery_sxdsrcconnfile) + +[2.4.273.66 SXAddl_SXCQuery_SXDSrcDataFile [464](#sxaddl_sxcquery_sxdsrcdatafile)](#sxaddl_sxcquery_sxdsrcdatafile) + +[2.4.273.67 SXAddl_SXCQuery_SXDXMLSource [464](#sxaddl_sxcquery_sxdxmlsource)](#sxaddl_sxcquery_sxdxmlsource) + +[2.4.273.68 SXAddl_SXCSXCondFmt_SXDEnd [465](#sxaddl_sxcsxcondfmt_sxdend)](#sxaddl_sxcsxcondfmt_sxdend) + +[2.4.273.69 SXAddl_SXCSXCondFmt_SXDSXCondFmt [465](#sxaddl_sxcsxcondfmt_sxdsxcondfmt)](#sxaddl_sxcsxcondfmt_sxdsxcondfmt) + +[2.4.273.70 SXAddl_SXCSXCondFmts_SXDEnd [466](#sxaddl_sxcsxcondfmts_sxdend)](#sxaddl_sxcsxcondfmts_sxdend) + +[2.4.273.71 SXAddl_SXCSXCondFmts_SXDId [467](#sxaddl_sxcsxcondfmts_sxdid)](#sxaddl_sxcsxcondfmts_sxdid) + +[2.4.273.72 SXAddl_SXCSXDH_SXDEnd [467](#sxaddl_sxcsxdh_sxdend)](#sxaddl_sxcsxdh_sxdend) + +[2.4.273.73 SXAddl_SXCSXDH_SXDId [468](#sxaddl_sxcsxdh_sxdid)](#sxaddl_sxcsxdh_sxdid) + +[2.4.273.74 SXAddl_SXCSXDH_SXDSxdh [468](#sxaddl_sxcsxdh_sxdsxdh)](#sxaddl_sxcsxdh_sxdsxdh) + +[2.4.273.75 SXAddl_SXCSXfilt_SXDEnd [469](#sxaddl_sxcsxfilt_sxdend)](#sxaddl_sxcsxfilt_sxdend) + +[2.4.273.76 SXAddl_SXCSXfilt_SXDId [470](#sxaddl_sxcsxfilt_sxdid)](#sxaddl_sxcsxfilt_sxdid) + +[2.4.273.77 SXAddl_SXCSXfilt_SXDSXfilt [470](#sxaddl_sxcsxfilt_sxdsxfilt)](#sxaddl_sxcsxfilt_sxdsxfilt) + +[2.4.273.78 SXAddl_SXCSXfilt_SXDSXItm [471](#sxaddl_sxcsxfilt_sxdsxitm)](#sxaddl_sxcsxfilt_sxdsxitm) + +[2.4.273.79 SXAddl_SXCSXFilter12_SXDCaption [472](#sxaddl_sxcsxfilter12_sxdcaption)](#sxaddl_sxcsxfilter12_sxdcaption) + +[2.4.273.80 SXAddl_SXCSXFilter12_SXDEnd [473](#sxaddl_sxcsxfilter12_sxdend)](#sxaddl_sxcsxfilter12_sxdend) + +[2.4.273.81 SXAddl_SXCSXFilter12_SXDId [473](#sxaddl_sxcsxfilter12_sxdid)](#sxaddl_sxcsxfilter12_sxdid) + +[2.4.273.82 SXAddl_SXCSXFilter12_SXDSXFilter [473](#sxaddl_sxcsxfilter12_sxdsxfilter)](#sxaddl_sxcsxfilter12_sxdsxfilter) + +[2.4.273.83 SXAddl_SXCSXFilter12_SXDSXFilterDesc [475](#sxaddl_sxcsxfilter12_sxdsxfilterdesc)](#sxaddl_sxcsxfilter12_sxdsxfilterdesc) + +[2.4.273.84 SXAddl_SXCSXFilter12_SXDSXFilterValue1 [475](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1)](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1) + +[2.4.273.85 SXAddl_SXCSXFilter12_SXDSXFilterValue2 [475](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2)](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2) + +[2.4.273.86 SXAddl_SXCSXFilter12_SXDXlsFilter [476](#sxaddl_sxcsxfilter12_sxdxlsfilter)](#sxaddl_sxcsxfilter12_sxdxlsfilter) + +[2.4.273.87 SXAddl_SXCSXFilter12_SXDXlsFilterValue1 [476](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1)](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1) + +[2.4.273.88 SXAddl_SXCSXFilter12_SXDXlsFilterValue2 [477](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2)](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2) + +[2.4.273.89 SXAddl_SXCSXFilters12_SXDEnd [477](#sxaddl_sxcsxfilters12_sxdend)](#sxaddl_sxcsxfilters12_sxdend) + +[2.4.273.90 SXAddl_SXCSXFilters12_SXDId [478](#sxaddl_sxcsxfilters12_sxdid)](#sxaddl_sxcsxfilters12_sxdid) + +[2.4.273.91 SXAddl_SXCSXMg_SXDEnd [478](#sxaddl_sxcsxmg_sxdend)](#sxaddl_sxcsxmg_sxdend) + +[2.4.273.92 SXAddl_SXCSXMg_SXDId [478](#sxaddl_sxcsxmg_sxdid)](#sxaddl_sxcsxmg_sxdid) + +[2.4.273.93 SXAddl_SXCSXMg_SXDUserCaption [479](#sxaddl_sxcsxmg_sxdusercaption)](#sxaddl_sxcsxmg_sxdusercaption) + +[2.4.273.94 SXAddl_SXCSXMgs_SXDEnd [479](#sxaddl_sxcsxmgs_sxdend)](#sxaddl_sxcsxmgs_sxdend) + +[2.4.273.95 SXAddl_SXCSXMgs_SXDId [479](#sxaddl_sxcsxmgs_sxdid)](#sxaddl_sxcsxmgs_sxdid) + +[2.4.273.96 SXAddl_SXCSXMgs_SXDMGrpSXDHMap [480](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap)](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap) + +[2.4.273.97 SXAddl_SXCSXrule_SXDEnd [481](#sxaddl_sxcsxrule_sxdend)](#sxaddl_sxcsxrule_sxdend) + +[2.4.273.98 SXAddl_SXCSXrule_SXDId [481](#sxaddl_sxcsxrule_sxdid)](#sxaddl_sxcsxrule_sxdid) + +[2.4.273.99 SXAddl_SXCSXrule_SXDSXrule [481](#sxaddl_sxcsxrule_sxdsxrule)](#sxaddl_sxcsxrule_sxdsxrule) + +[2.4.273.100 SXAddl_SXCView_SXDCalcMember [484](#sxaddl_sxcview_sxdcalcmember)](#sxaddl_sxcview_sxdcalcmember) + +[2.4.273.101 SXAddl_SXCView_SXDCalcMemString [486](#sxaddl_sxcview_sxdcalcmemstring)](#sxaddl_sxcview_sxdcalcmemstring) + +[2.4.273.102 SXAddl_SXCView_SXDCompactColHdr [486](#sxaddl_sxcview_sxdcompactcolhdr)](#sxaddl_sxcview_sxdcompactcolhdr) + +[2.4.273.103 SXAddl_SXCView_SXDCompactRwHdr [487](#sxaddl_sxcview_sxdcompactrwhdr)](#sxaddl_sxcview_sxdcompactrwhdr) + +[2.4.273.104 SXAddl_SXCView_SXDEnd [487](#sxaddl_sxcview_sxdend)](#sxaddl_sxcview_sxdend) + +[2.4.273.105 SXAddl_SXCView_SXDId [488](#sxaddl_sxcview_sxdid)](#sxaddl_sxcview_sxdid) + +[2.4.273.106 SXAddl_SXCView_SXDSXPIIvmb [488](#sxaddl_sxcview_sxdsxpiivmb)](#sxaddl_sxcview_sxdsxpiivmb) + +[2.4.273.107 SXAddl_SXCView_SXDTableStyleClient [489](#sxaddl_sxcview_sxdtablestyleclient)](#sxaddl_sxcview_sxdtablestyleclient) + +[2.4.273.108 SXAddl_SXCView_SXDVer10Info [489](#sxaddl_sxcview_sxdver10info)](#sxaddl_sxcview_sxdver10info) + +[2.4.273.109 SXAddl_SXCView_SXDVer12Info [491](#sxaddl_sxcview_sxdver12info)](#sxaddl_sxcview_sxdver12info) + +[2.4.273.110 SXAddl_SXCView_SXDVerUpdInv [493](#sxaddl_sxcview_sxdverupdinv)](#sxaddl_sxcview_sxdverupdinv) + +[2.4.274 SxBool [494](#sxbool)](#sxbool) + +[2.4.275 SXDB [494](#sxdb)](#sxdb) + +[2.4.276 SXDBB [495](#sxdbb)](#sxdbb) + +[2.4.277 SXDBEx [495](#sxdbex)](#sxdbex) + +[2.4.278 SXDI [496](#sxdi)](#sxdi) + +[2.4.279 SXDtr [498](#sxdtr)](#sxdtr) + +[2.4.280 SxDXF [498](#sxdxf)](#sxdxf) + +[2.4.281 SxErr [499](#sxerr)](#sxerr) + +[2.4.282 SXEx [499](#sxex)](#sxex) + +[2.4.283 SXFDB [502](#sxfdb)](#sxfdb) + +[2.4.284 SXFDBType [505](#sxfdbtype)](#sxfdbtype) + +[2.4.285 SxFilt [505](#sxfilt)](#sxfilt) + +[2.4.286 SxFmla [506](#sxfmla)](#sxfmla) + +[2.4.287 SxFormat [507](#sxformat)](#sxformat) + +[2.4.288 SXFormula [507](#sxformula)](#sxformula) + +[2.4.289 SXInt [507](#sxint)](#sxint) + +[2.4.290 SxIsxoper [508](#sxisxoper)](#sxisxoper) + +[2.4.291 SxItm [508](#sxitm)](#sxitm) + +[2.4.292 SxIvd [509](#sxivd)](#sxivd) + +[2.4.293 SXLI [510](#sxli)](#sxli) + +[2.4.294 SxName [510](#sxname)](#sxname) + +[2.4.295 SxNil [511](#sxnil)](#sxnil) + +[2.4.296 SXNum [511](#sxnum)](#sxnum) + +[2.4.297 SXPair [511](#sxpair)](#sxpair) + +[2.4.298 SXPI [512](#sxpi)](#sxpi) + +[2.4.299 SXPIEx [513](#sxpiex)](#sxpiex) + +[2.4.300 SXRng [513](#sxrng)](#sxrng) + +[2.4.301 SxRule [515](#sxrule)](#sxrule) + +[2.4.302 SxSelect [517](#sxselect)](#sxselect) + +[2.4.303 SXStreamID [519](#sxstreamid)](#sxstreamid) + +[2.4.304 SXString [519](#sxstring)](#sxstring) + +[2.4.305 SXTbl [519](#sxtbl)](#sxtbl) + +[2.4.306 SxTbpg [520](#sxtbpg)](#sxtbpg) + +[2.4.307 SXTBRGIITM [521](#sxtbrgiitm)](#sxtbrgiitm) + +[2.4.308 SXTH [521](#sxth)](#sxth) + +[2.4.309 Sxvd [524](#sxvd)](#sxvd) + +[2.4.310 SXVDEx [528](#sxvdex)](#sxvdex) + +[2.4.311 SXVDTEx [531](#sxvdtex)](#sxvdtex) + +[2.4.312 SXVI [532](#sxvi)](#sxvi) + +[2.4.313 SxView [534](#sxview)](#sxview) + +[2.4.314 SXViewEx [536](#sxviewex)](#sxviewex) + +[2.4.315 SXViewEx9 [537](#sxviewex9)](#sxviewex9) + +[2.4.316 SXViewLink [538](#sxviewlink)](#sxviewlink) + +[2.4.317 SXVS [539](#sxvs)](#sxvs) + +[2.4.318 Sync [539](#sync)](#sync) + +[2.4.319 Table [539](#table)](#table) + +[2.4.320 TableStyle [541](#tablestyle)](#tablestyle) + +[2.4.321 TableStyleElement [542](#tablestyleelement)](#tablestyleelement) + +[2.4.322 TableStyles [545](#tablestyles)](#tablestyles) + +[2.4.323 Template [546](#template)](#template) + +[2.4.324 Text [546](#text)](#text) + +[2.4.325 TextPropsStream [551](#textpropsstream)](#textpropsstream) + +[2.4.326 Theme [553](#theme)](#theme) + +[2.4.327 Tick [553](#tick)](#tick) + +[2.4.328 TopMargin [556](#topmargin)](#topmargin) + +[2.4.329 TxO [557](#txo)](#txo) + +[2.4.330 TxtQry [559](#txtqry)](#txtqry) + +[2.4.331 Uncalced [561](#uncalced)](#uncalced) + +[2.4.332 Units [561](#units)](#units) + +[2.4.333 UserBView [561](#userbview)](#userbview) + +[2.4.334 UserSViewBegin [565](#usersviewbegin)](#usersviewbegin) + +[2.4.335 UserSViewBegin_Chart [568](#usersviewbegin_chart)](#usersviewbegin_chart) + +[2.4.336 UserSViewEnd [570](#usersviewend)](#usersviewend) + +[2.4.337 UsesELFs [570](#useselfs)](#useselfs) + +[2.4.338 UsrChk [570](#usrchk)](#usrchk) + +[2.4.339 UsrExcl [571](#usrexcl)](#usrexcl) + +[2.4.340 UsrInfo [572](#usrinfo)](#usrinfo) + +[2.4.341 ValueRange [572](#valuerange)](#valuerange) + +[2.4.342 VCenter [575](#vcenter)](#vcenter) + +[2.4.343 VerticalPageBreaks [575](#verticalpagebreaks)](#verticalpagebreaks) + +[2.4.344 WebPub [575](#webpub)](#webpub) + +[2.4.345 Window1 [578](#window1)](#window1) + +[2.4.346 Window2 [579](#window2)](#window2) + +[2.4.347 WinProtect [581](#winprotect)](#winprotect) + +[2.4.348 WOpt [582](#wopt)](#wopt) + +[2.4.349 WriteAccess [583](#writeaccess)](#writeaccess) + +[2.4.350 WriteProtect [584](#writeprotect)](#writeprotect) + +[2.4.351 WsBool [584](#wsbool)](#wsbool) + +[2.4.352 XCT [585](#xct)](#xct) + +[2.4.353 XF [585](#xf)](#xf) + +[2.4.354 XFCRC [586](#xfcrc)](#xfcrc) + +[2.4.355 XFExt [586](#xfext)](#xfext) + +[2.4.356 YMult [587](#ymult)](#ymult) + +[2.5 Structures [588](#structures-1)](#structures-1) + +[2.5.1 AddinUdf [588](#addinudf)](#addinudf) + +[2.5.2 AF12CellIcon [588](#af12cellicon)](#af12cellicon) + +[2.5.3 AF12Criteria [589](#af12criteria)](#af12criteria) + +[2.5.4 AF12DateInfo [589](#af12dateinfo)](#af12dateinfo) + +[2.5.5 AFDOper [590](#afdoper)](#afdoper) + +[2.5.6 AFDOperBoolErr [591](#afdoperboolerr)](#afdoperboolerr) + +[2.5.7 AFDOperRk [592](#afdoperrk)](#afdoperrk) + +[2.5.8 AFDOperStr [592](#afdoperstr)](#afdoperstr) + +[2.5.9 AutoFmt8 [593](#autofmt8)](#autofmt8) + +[2.5.10 Bes [594](#bes)](#bes) + +[2.5.11 Bold [595](#bold)](#bold) + +[2.5.12 BookExt_Conditional11 [595](#bookext_conditional11)](#bookext_conditional11) + +[2.5.13 BookExt_Conditional12 [595](#bookext_conditional12)](#bookext_conditional12) + +[2.5.14 Boolean [596](#boolean)](#boolean) + +[2.5.15 BorderStyle [596](#borderstyle)](#borderstyle) + +[2.5.16 BuiltInStyle [597](#builtinstyle)](#builtinstyle) + +[2.5.17 CachedDiskHeader [597](#cacheddiskheader)](#cacheddiskheader) + +[2.5.18 Cch255 [598](#cch255)](#cch255) + +[2.5.19 Cell [598](#cell)](#cell) + +[2.5.20 CellXF [598](#cellxf)](#cellxf) + +[2.5.21 CFColor [602](#cfcolor)](#cfcolor) + +[2.5.22 CFDatabar [602](#cfdatabar)](#cfdatabar) + +[2.5.23 CFExAveragesTemplateParams [604](#cfexaveragestemplateparams)](#cfexaveragestemplateparams) + +[2.5.24 CFExDateTemplateParams [604](#cfexdatetemplateparams)](#cfexdatetemplateparams) + +[2.5.25 CFExDefaultTemplateParams [605](#cfexdefaulttemplateparams)](#cfexdefaulttemplateparams) + +[2.5.26 CFExFilterParams [605](#cfexfilterparams)](#cfexfilterparams) + +[2.5.27 CFExNonCF12 [606](#cfexnoncf12)](#cfexnoncf12) + +[2.5.28 CFExTemplateParams [608](#cfextemplateparams)](#cfextemplateparams) + +[2.5.29 CFExTextTemplateParams [609](#cfextexttemplateparams)](#cfextexttemplateparams) + +[2.5.30 CFFilter [609](#cffilter)](#cffilter) + +[2.5.31 CFFlag [610](#cfflag)](#cfflag) + +[2.5.32 CFGradient [611](#cfgradient)](#cfgradient) + +[2.5.33 CFGradientInterpItem [611](#cfgradientinterpitem)](#cfgradientinterpitem) + +[2.5.34 CFGradientItem [612](#cfgradientitem)](#cfgradientitem) + +[2.5.35 CFMStateItem [613](#cfmstateitem)](#cfmstateitem) + +[2.5.36 CFMultistate [613](#cfmultistate)](#cfmultistate) + +[2.5.37 CFrtId [614](#cfrtid)](#cfrtid) + +[2.5.38 CFT [615](#cft)](#cft) + +[2.5.39 CFVO [616](#cfvo)](#cfvo) + +[2.5.40 ChartNumNillable [617](#chartnumnillable)](#chartnumnillable) + +[2.5.41 Col [617](#col)](#col) + +[2.5.42 Col_NegativeOne [617](#col_negativeone)](#col_negativeone) + +[2.5.43 Col12 [618](#col12)](#col12) + +[2.5.44 Col256U [618](#col256u)](#col256u) + +[2.5.45 ColByte [618](#colbyte)](#colbyte) + +[2.5.46 ColByteU [619](#colbyteu)](#colbyteu) + +[2.5.47 ColElfU [619](#colelfu)](#colelfu) + +[2.5.48 ColorICV [619](#coloricv)](#coloricv) + +[2.5.49 ColorTheme [620](#colortheme)](#colortheme) + +[2.5.50 ColRelNegU [620](#colrelnegu)](#colrelnegu) + +[2.5.51 ColRelU [621](#colrelu)](#colrelu) + +[2.5.52 ColSlco8U [621](#colslco8u)](#colslco8u) + +[2.5.53 ColU [621](#colu)](#colu) + +[2.5.54 Colx [622](#colx)](#colx) + +[2.5.55 CondDataValue [622](#conddatavalue)](#conddatavalue) + +[2.5.56 CondFmtStructure [622](#condfmtstructure)](#condfmtstructure) + +[2.5.57 ConnGrbitDbt [623](#conngrbitdbt)](#conngrbitdbt) + +[2.5.58 ConnGrbitDbtAdo [623](#conngrbitdbtado)](#conngrbitdbtado) + +[2.5.59 ConnGrbitDbtOledb [624](#conngrbitdbtoledb)](#conngrbitdbtoledb) + +[2.5.60 ConnGrbitDbtWeb [625](#conngrbitdbtweb)](#conngrbitdbtweb) + +[2.5.61 ControlInfo [626](#controlinfo)](#controlinfo) + +[2.5.62 CrtLayout12Mode [626](#crtlayout12mode)](#crtlayout12mode) + +[2.5.63 DataFunctionalityLevel [627](#datafunctionalitylevel)](#datafunctionalitylevel) + +[2.5.64 DataSourceType [627](#datasourcetype)](#datasourcetype) + +[2.5.65 DateAsNum [627](#dateasnum)](#dateasnum) + +[2.5.66 DateUnit [627](#dateunit)](#dateunit) + +[2.5.67 DCol [628](#dcol)](#dcol) + +[2.5.68 DColByteU [628](#dcolbyteu)](#dcolbyteu) + +[2.5.69 DConFile [628](#dconfile)](#dconfile) + +[2.5.70 DConnConnectionOleDb [629](#dconnconnectionoledb)](#dconnconnectionoledb) + +[2.5.71 DConnConnectionWeb [630](#dconnconnectionweb)](#dconnconnectionweb) + +[2.5.72 DConnId [630](#dconnid)](#dconnid) + +[2.5.73 DConnParamBinding [631](#dconnparambinding)](#dconnparambinding) + +[2.5.74 DConnParamBindingValByte [631](#dconnparambindingvalbyte)](#dconnparambindingvalbyte) + +[2.5.75 DConnParamBindingValInt [631](#dconnparambindingvalint)](#dconnparambindingvalint) + +[2.5.76 DConnParamBindingValString [631](#dconnparambindingvalstring)](#dconnparambindingvalstring) + +[2.5.77 DConnParamBindingValType [632](#dconnparambindingvaltype)](#dconnparambindingvaltype) + +[2.5.78 DConnParameter [632](#dconnparameter)](#dconnparameter) + +[2.5.79 DConnStringSequence [633](#dconnstringsequence)](#dconnstringsequence) + +[2.5.80 DConnUnicodeStringSegmented [633](#dconnunicodestringsegmented)](#dconnunicodestringsegmented) + +[2.5.81 DJoin [634](#djoin)](#djoin) + +[2.5.82 DRw [634](#drw)](#drw) + +[2.5.83 DRwByteU [634](#drwbyteu)](#drwbyteu) + +[2.5.84 Duce [634](#duce)](#duce) + +[2.5.85 DuceRadical [635](#duceradical)](#duceradical) + +[2.5.86 DuceStacked [636](#ducestacked)](#ducestacked) + +[2.5.87 Ducr [636](#ducr)](#ducr) + +[2.5.88 DucrConditionalLbl [637](#ducrconditionallbl)](#ducrconditionallbl) + +[2.5.89 DucrConditionalNoLbl [638](#ducrconditionalnolbl)](#ducrconditionalnolbl) + +[2.5.90 DwQsiFuture [638](#dwqsifuture)](#dwqsifuture) + +[2.5.91 DXFALC [639](#dxfalc)](#dxfalc) + +[2.5.92 DXFBdr [640](#dxfbdr)](#dxfbdr) + +[2.5.93 DXFFntD [641](#dxffntd)](#dxffntd) + +[2.5.94 DXFId [642](#dxfid)](#dxfid) + +[2.5.95 DXFN [642](#dxfn)](#dxfn) + +[2.5.96 DXFN12 [645](#dxfn12)](#dxfn12) + +[2.5.97 DXFN12List [646](#dxfn12list)](#dxfn12list) + +[2.5.98 DXFN12NoCB [646](#dxfn12nocb)](#dxfn12nocb) + +[2.5.99 DXFNum [646](#dxfnum)](#dxfnum) + +[2.5.100 DXFNumIFmt [647](#dxfnumifmt)](#dxfnumifmt) + +[2.5.101 DXFNumUsr [647](#dxfnumusr)](#dxfnumusr) + +[2.5.102 DXFPat [647](#dxfpat)](#dxfpat) + +[2.5.103 DXFProt [648](#dxfprot)](#dxfprot) + +[2.5.104 EnhancedProtection [648](#enhancedprotection)](#enhancedprotection) + +[2.5.105 ExternDdeLinkNoOper [649](#externddelinknooper)](#externddelinknooper) + +[2.5.106 ExternDocName [649](#externdocname)](#externdocname) + +[2.5.107 ExternOleDdeLink [650](#externoleddelink)](#externoleddelink) + +[2.5.108 ExtProp [650](#extprop)](#extprop) + +[2.5.109 ExtRst [651](#extrst)](#extrst) + +[2.5.110 FactoidData [652](#factoiddata)](#factoiddata) + +[2.5.111 Feat11CellStruct [652](#feat11cellstruct)](#feat11cellstruct) + +[2.5.112 Feat11FdaAutoFilter [652](#feat11fdaautofilter)](#feat11fdaautofilter) + +[2.5.113 Feat11FieldDataItem [653](#feat11fielddataitem)](#feat11fielddataitem) + +[2.5.114 Feat11Fmla [660](#feat11fmla)](#feat11fmla) + +[2.5.115 Feat11RgInvalidCells [660](#feat11rginvalidcells)](#feat11rginvalidcells) + +[2.5.116 Feat11RgSharepointIdChange [660](#feat11rgsharepointidchange)](#feat11rgsharepointidchange) + +[2.5.117 Feat11RgSharepointIdDel [661](#feat11rgsharepointiddel)](#feat11rgsharepointiddel) + +[2.5.118 Feat11TotalFmla [661](#feat11totalfmla)](#feat11totalfmla) + +[2.5.119 Feat11WSSListInfo [661](#feat11wsslistinfo)](#feat11wsslistinfo) + +[2.5.120 Feat11XMap [664](#feat11xmap)](#feat11xmap) + +[2.5.121 Feat11XMapEntry [664](#feat11xmapentry)](#feat11xmapentry) + +[2.5.122 Feat11XMapEntry2 [665](#feat11xmapentry2)](#feat11xmapentry2) + +[2.5.123 FeatFormulaErr2 [665](#featformulaerr2)](#featformulaerr2) + +[2.5.124 FeatProtection [665](#featprotection)](#featprotection) + +[2.5.125 FeatSmartTag [666](#featsmarttag)](#featsmarttag) + +[2.5.126 FFErrorCheck [667](#fferrorcheck)](#fferrorcheck) + +[2.5.127 FillPattern [667](#fillpattern)](#fillpattern) + +[2.5.128 FillStylePropertiesForShapePropsStreamChecksum [668](#fillstylepropertiesforshapepropsstreamchecksum)](#fillstylepropertiesforshapepropsstreamchecksum) + +[2.5.129 FontIndex [678](#fontindex)](#fontindex) + +[2.5.130 FontInfo [678](#fontinfo)](#fontinfo) + +[2.5.131 FontScheme [679](#fontscheme)](#fontscheme) + +[2.5.132 FormatRun [679](#formatrun)](#formatrun) + +[2.5.133 FormulaValue [679](#formulavalue)](#formulavalue) + +[2.5.134 FrtFlags [680](#frtflags)](#frtflags) + +[2.5.135 FrtHeader [681](#frtheader)](#frtheader) + +[2.5.136 FrtHeaderOld [681](#frtheaderold)](#frtheaderold) + +[2.5.137 FrtRefHeader [681](#frtrefheader)](#frtrefheader) + +[2.5.138 FrtRefHeaderNoGrbit [682](#frtrefheadernogrbit)](#frtrefheadernogrbit) + +[2.5.139 FrtRefHeaderU [682](#frtrefheaderu)](#frtrefheaderu) + +[2.5.140 FtCbls [683](#ftcbls)](#ftcbls) + +[2.5.141 FtCblsData [683](#ftcblsdata)](#ftcblsdata) + +[2.5.142 FtCf [684](#ftcf)](#ftcf) + +[2.5.143 FtCmo [684](#ftcmo)](#ftcmo) + +[2.5.144 FtEdoData [687](#ftedodata)](#ftedodata) + +[2.5.145 FtGboData [688](#ftgbodata)](#ftgbodata) + +[2.5.146 FtGmo [688](#ftgmo)](#ftgmo) + +[2.5.147 FtLbsData [689](#ftlbsdata)](#ftlbsdata) + +[2.5.148 FtMacro [691](#ftmacro)](#ftmacro) + +[2.5.149 FtNts [692](#ftnts)](#ftnts) + +[2.5.150 FtPictFmla [692](#ftpictfmla)](#ftpictfmla) + +[2.5.151 FtPioGrbit [693](#ftpiogrbit)](#ftpiogrbit) + +[2.5.152 FtRbo [695](#ftrbo)](#ftrbo) + +[2.5.153 FtRboData [695](#ftrbodata)](#ftrbodata) + +[2.5.154 FtSbs [696](#ftsbs)](#ftsbs) + +[2.5.155 FullColorExt [697](#fullcolorext)](#fullcolorext) + +[2.5.156 GradStop [697](#gradstop)](#gradstop) + +[2.5.157 HiddenMemberSet [698](#hiddenmemberset)](#hiddenmemberset) + +[2.5.158 HideObjEnum [698](#hideobjenum)](#hideobjenum) + +[2.5.159 HorizAlign [699](#horizalign)](#horizalign) + +[2.5.160 HorzBrk [699](#horzbrk)](#horzbrk) + +[2.5.161 Icv [699](#icv)](#icv) + +[2.5.162 IcvChart [703](#icvchart)](#icvchart) + +[2.5.163 IcvFont [703](#icvfont)](#icvfont) + +[2.5.164 IcvXF [703](#icvxf)](#icvxf) + +[2.5.165 IFmt [703](#ifmt)](#ifmt) + +[2.5.166 InteriorColorPropertiesForShapePropsStreamChecksum [704](#interiorcolorpropertiesforshapepropsstreamchecksum)](#interiorcolorpropertiesforshapepropsstreamchecksum) + +[2.5.167 ISSTInf [705](#isstinf)](#isstinf) + +[2.5.168 IXFCell [705](#ixfcell)](#ixfcell) + +[2.5.169 KPIProp [705](#kpiprop)](#kpiprop) + +[2.5.170 KPISets [706](#kpisets)](#kpisets) + +[2.5.171 LbsDropData [706](#lbsdropdata)](#lbsdropdata) + +[2.5.172 LEMMode [707](#lemmode)](#lemmode) + +[2.5.173 LinePropertiesForShapePropsStreamChecksum [708](#linepropertiesforshapepropsstreamchecksum)](#linepropertiesforshapepropsstreamchecksum) + +[2.5.174 List12BlockLevel [709](#list12blocklevel)](#list12blocklevel) + +[2.5.175 List12DisplayName [711](#list12displayname)](#list12displayname) + +[2.5.176 List12TableStyleClientInfo [712](#list12tablestyleclientinfo)](#list12tablestyleclientinfo) + +[2.5.177 LongRGB [712](#longrgb)](#longrgb) + +[2.5.178 LongRGBA [713](#longrgba)](#longrgba) + +[2.5.179 LPWideString [713](#lpwidestring)](#lpwidestring) + +[2.5.180 MDir [713](#mdir)](#mdir) + +[2.5.181 MDTInfoIndex [714](#mdtinfoindex)](#mdtinfoindex) + +[2.5.182 MDXStrIndex [714](#mdxstrindex)](#mdxstrindex) + +[2.5.183 MOper [714](#moper)](#moper) + +[2.5.184 NilChartNum [715](#nilchartnum)](#nilchartnum) + +[2.5.185 NoteRR [715](#noterr)](#noterr) + +[2.5.186 NoteSh [716](#notesh)](#notesh) + +[2.5.187 ObjFmla [717](#objfmla)](#objfmla) + +[2.5.188 ObjId [718](#objid)](#objid) + +[2.5.189 ObjLinkFmla [718](#objlinkfmla)](#objlinkfmla) + +[2.5.190 ODBCType [719](#odbctype)](#odbctype) + +[2.5.191 OfficeArtClientAnchorChart [719](#officeartclientanchorchart)](#officeartclientanchorchart) + +[2.5.192 OfficeArtClientAnchorHF [720](#officeartclientanchorhf)](#officeartclientanchorhf) + +[2.5.193 OfficeArtClientAnchorSheet [721](#officeartclientanchorsheet)](#officeartclientanchorsheet) + +[2.5.194 OfficeArtClientData [722](#officeartclientdata)](#officeartclientdata) + +[2.5.195 OfficeArtClientTextbox [723](#officeartclienttextbox)](#officeartclienttextbox) + +[2.5.196 PaneType [723](#panetype)](#panetype) + +[2.5.197 PARAMQRY_Fixed [724](#paramqry_fixed)](#paramqry_fixed) + +[2.5.198 Parsed Expressions [725](#parsed-expressions)](#parsed-expressions) + +[2.5.198.1 ArrayParsedFormula [725](#arrayparsedformula)](#arrayparsedformula) + +[2.5.198.2 BErr [725](#berr)](#berr) + +[2.5.198.3 CellParsedFormula [726](#cellparsedformula)](#cellparsedformula) + +[2.5.198.4 Cetab [726](#cetab)](#cetab) + +[2.5.198.5 CFParsedFormula [755](#cfparsedformula)](#cfparsedformula) + +[2.5.198.6 CFParsedFormulaNoCCE [755](#cfparsedformulanocce)](#cfparsedformulanocce) + +[2.5.198.7 CFVOParsedFormula [755](#cfvoparsedformula)](#cfvoparsedformula) + +[2.5.198.8 ChartParsedFormula [756](#chartparsedformula)](#chartparsedformula) + +[2.5.198.9 DVParsedFormula [756](#dvparsedformula)](#dvparsedformula) + +[2.5.198.10 ExtNameParsedFormula [757](#extnameparsedformula)](#extnameparsedformula) + +[2.5.198.11 ExtPtgArea3D [758](#extptgarea3d)](#extptgarea3d) + +[2.5.198.12 ExtPtgAreaErr3D [758](#extptgareaerr3d)](#extptgareaerr3d) + +[2.5.198.13 ExtPtgErr [758](#extptgerr)](#extptgerr) + +[2.5.198.14 ExtPtgRef3D [759](#extptgref3d)](#extptgref3d) + +[2.5.198.15 ExtPtgRefErr3D [759](#extptgreferr3d)](#extptgreferr3d) + +[2.5.198.16 ExtSheetPair [759](#extsheetpair)](#extsheetpair) + +[2.5.198.17 Ftab [760](#ftab)](#ftab) + +[2.5.198.18 Ilel [787](#ilel)](#ilel) + +[2.5.198.19 ListParsedArrayFormula [788](#listparsedarrayformula)](#listparsedarrayformula) + +[2.5.198.20 ListParsedFormula [788](#listparsedformula)](#listparsedformula) + +[2.5.198.21 NameParsedFormula [788](#nameparsedformula)](#nameparsedformula) + +[2.5.198.22 ObjectParsedFormula [789](#objectparsedformula)](#objectparsedformula) + +[2.5.198.23 ParameterParsedFormula [789](#parameterparsedformula)](#parameterparsedformula) + +[2.5.198.24 PivotParsedFormula [790](#pivotparsedformula)](#pivotparsedformula) + +[2.5.198.25 Ptg [790](#ptg)](#ptg) + +[2.5.198.26 PtgAdd [793](#ptgadd)](#ptgadd) + +[2.5.198.27 PtgArea [793](#ptgarea)](#ptgarea) + +[2.5.198.28 PtgArea3d [794](#ptgarea3d)](#ptgarea3d) + +[2.5.198.29 PtgAreaErr [794](#ptgareaerr)](#ptgareaerr) + +[2.5.198.30 PtgAreaErr3d [795](#ptgareaerr3d)](#ptgareaerr3d) + +[2.5.198.31 PtgAreaN [795](#ptgarean)](#ptgarean) + +[2.5.198.32 PtgArray [796](#ptgarray)](#ptgarray) + +[2.5.198.33 PtgAttrBaxcel [796](#ptgattrbaxcel)](#ptgattrbaxcel) + +[2.5.198.34 PtgAttrChoose [797](#ptgattrchoose)](#ptgattrchoose) + +[2.5.198.35 PtgAttrGoto [797](#ptgattrgoto)](#ptgattrgoto) + +[2.5.198.36 PtgAttrIf [798](#ptgattrif)](#ptgattrif) + +[2.5.198.37 PtgAttrSemi [798](#ptgattrsemi)](#ptgattrsemi) + +[2.5.198.38 PtgAttrSpace [798](#ptgattrspace)](#ptgattrspace) + +[2.5.198.39 PtgAttrSpaceSemi [799](#ptgattrspacesemi)](#ptgattrspacesemi) + +[2.5.198.40 PtgAttrSpaceType [799](#ptgattrspacetype)](#ptgattrspacetype) + +[2.5.198.41 PtgAttrSum [800](#ptgattrsum)](#ptgattrsum) + +[2.5.198.42 PtgBool [800](#ptgbool)](#ptgbool) + +[2.5.198.43 PtgConcat [800](#ptgconcat)](#ptgconcat) + +[2.5.198.44 PtgDataType [800](#ptgdatatype)](#ptgdatatype) + +[2.5.198.45 PtgDiv [801](#ptgdiv)](#ptgdiv) + +[2.5.198.46 PtgElfCol [801](#ptgelfcol)](#ptgelfcol) + +[2.5.198.47 PtgElfColS [801](#ptgelfcols)](#ptgelfcols) + +[2.5.198.48 PtgElfColSV [802](#ptgelfcolsv)](#ptgelfcolsv) + +[2.5.198.49 PtgElfColV [802](#ptgelfcolv)](#ptgelfcolv) + +[2.5.198.50 PtgElfLel [802](#ptgelflel)](#ptgelflel) + +[2.5.198.51 PtgElfRadical [803](#ptgelfradical)](#ptgelfradical) + +[2.5.198.52 PtgElfRadicalLel [803](#ptgelfradicallel)](#ptgelfradicallel) + +[2.5.198.53 PtgElfRadicalS [804](#ptgelfradicals)](#ptgelfradicals) + +[2.5.198.54 PtgElfRw [804](#ptgelfrw)](#ptgelfrw) + +[2.5.198.55 PtgElfRwV [805](#ptgelfrwv)](#ptgelfrwv) + +[2.5.198.56 PtgEq [805](#ptgeq)](#ptgeq) + +[2.5.198.57 PtgErr [805](#ptgerr)](#ptgerr) + +[2.5.198.58 PtgExp [805](#ptgexp)](#ptgexp) + +[2.5.198.59 PtgExtraArray [806](#ptgextraarray)](#ptgextraarray) + +[2.5.198.60 PtgExtraElf [806](#ptgextraelf)](#ptgextraelf) + +[2.5.198.61 PtgExtraMem [807](#ptgextramem)](#ptgextramem) + +[2.5.198.62 PtgFunc [807](#ptgfunc)](#ptgfunc) + +[2.5.198.63 PtgFuncVar [807](#ptgfuncvar)](#ptgfuncvar) + +[2.5.198.64 PtgGe [808](#ptgge)](#ptgge) + +[2.5.198.65 PtgGt [808](#ptggt)](#ptggt) + +[2.5.198.66 PtgInt [808](#ptgint)](#ptgint) + +[2.5.198.67 PtgIsect [809](#ptgisect)](#ptgisect) + +[2.5.198.68 PtgLe [809](#ptgle)](#ptgle) + +[2.5.198.69 PtgLt [809](#ptglt)](#ptglt) + +[2.5.198.70 PtgMemArea [809](#ptgmemarea)](#ptgmemarea) + +[2.5.198.71 PtgMemErr [810](#ptgmemerr)](#ptgmemerr) + +[2.5.198.72 PtgMemFunc [810](#ptgmemfunc)](#ptgmemfunc) + +[2.5.198.73 PtgMemNoMem [811](#ptgmemnomem)](#ptgmemnomem) + +[2.5.198.74 PtgMissArg [811](#ptgmissarg)](#ptgmissarg) + +[2.5.198.75 PtgMul [811](#ptgmul)](#ptgmul) + +[2.5.198.76 PtgName [812](#ptgname)](#ptgname) + +[2.5.198.77 PtgNameX [812](#ptgnamex)](#ptgnamex) + +[2.5.198.78 PtgNe [813](#ptgne)](#ptgne) + +[2.5.198.79 PtgNum [813](#ptgnum)](#ptgnum) + +[2.5.198.80 PtgParen [813](#ptgparen)](#ptgparen) + +[2.5.198.81 PtgPercent [814](#ptgpercent)](#ptgpercent) + +[2.5.198.82 PtgPower [814](#ptgpower)](#ptgpower) + +[2.5.198.83 PtgRange [814](#ptgrange)](#ptgrange) + +[2.5.198.84 PtgRef [814](#ptgref)](#ptgref) + +[2.5.198.85 PtgRef3d [815](#ptgref3d)](#ptgref3d) + +[2.5.198.86 PtgRefErr [815](#ptgreferr)](#ptgreferr) + +[2.5.198.87 PtgRefErr3d [816](#ptgreferr3d)](#ptgreferr3d) + +[2.5.198.88 PtgRefN [816](#ptgrefn)](#ptgrefn) + +[2.5.198.89 PtgStr [816](#ptgstr)](#ptgstr) + +[2.5.198.90 PtgSub [817](#ptgsub)](#ptgsub) + +[2.5.198.91 PtgSxName [817](#ptgsxname)](#ptgsxname) + +[2.5.198.92 PtgTbl [817](#ptgtbl)](#ptgtbl) + +[2.5.198.93 PtgUminus [818](#ptguminus)](#ptguminus) + +[2.5.198.94 PtgUnion [818](#ptgunion)](#ptgunion) + +[2.5.198.95 PtgUplus [818](#ptguplus)](#ptguplus) + +[2.5.198.96 RevExtern [819](#revextern)](#revextern) + +[2.5.198.97 RevItab [819](#revitab)](#revitab) + +[2.5.198.98 RevLblName [820](#revlblname)](#revlblname) + +[2.5.198.99 RevName [821](#revname)](#revname) + +[2.5.198.100 RevNamePly [822](#revnameply)](#revnameply) + +[2.5.198.101 RevNameTabid [822](#revnametabid)](#revnametabid) + +[2.5.198.102 RevSheetName [822](#revsheetname)](#revsheetname) + +[2.5.198.103 RgbExtra [823](#rgbextra)](#rgbextra) + +[2.5.198.104 Rgce [824](#rgce)](#rgce) + +[2.5.198.105 RgceArea [827](#rgcearea)](#rgcearea) + +[2.5.198.106 RgceAreaRel [828](#rgcearearel)](#rgcearearel) + +[2.5.198.107 RgceElfLoc [828](#rgceelfloc)](#rgceelfloc) + +[2.5.198.108 RgceElfLocExtra [829](#rgceelflocextra)](#rgceelflocextra) + +[2.5.198.109 RgceLoc [829](#rgceloc)](#rgceloc) + +[2.5.198.110 RgceLoc8 [829](#rgceloc8)](#rgceloc8) + +[2.5.198.111 RgceLocRel [829](#rgcelocrel)](#rgcelocrel) + +[2.5.198.112 SerAr [830](#serar)](#serar) + +[2.5.198.113 SerBool [830](#serbool)](#serbool) + +[2.5.198.114 SerErr [831](#sererr)](#sererr) + +[2.5.198.115 SerNil [831](#sernil)](#sernil) + +[2.5.198.116 SerNum [831](#sernum)](#sernum) + +[2.5.198.117 SerStr [832](#serstr)](#serstr) + +[2.5.198.118 SharedParsedFormula [832](#sharedparsedformula)](#sharedparsedformula) + +[2.5.198.119 XtiIndex [833](#xtiindex)](#xtiindex) + +[2.5.199 PBT [833](#pbt)](#pbt) + +[2.5.200 PhRuns [834](#phruns)](#phruns) + +[2.5.201 Phs [834](#phs)](#phs) + +[2.5.202 PictFmlaEmbedInfo [835](#pictfmlaembedinfo)](#pictfmlaembedinfo) + +[2.5.203 PictFmlaKey [835](#pictfmlakey)](#pictfmlakey) + +[2.5.204 PivotCompProp [836](#pivotcompprop)](#pivotcompprop) + +[2.5.205 PositionMode [836](#positionmode)](#positionmode) + +[2.5.206 ReadingOrder [836](#readingorder)](#readingorder) + +[2.5.207 Ref [837](#ref)](#ref) + +[2.5.208 Ref8 [837](#ref8)](#ref8) + +[2.5.209 Ref8U [838](#ref8u)](#ref8u) + +[2.5.210 Ref8U2007 [838](#ref8u2007)](#ref8u2007) + +[2.5.211 RefU [839](#refu)](#refu) + +[2.5.212 RevisionType [839](#revisiontype)](#revisiontype) + +[2.5.213 RFX [840](#rfx)](#rfx) + +[2.5.214 RichTextStreamChecksumData [840](#richtextstreamchecksumdata)](#richtextstreamchecksumdata) + +[2.5.215 RichTextStreamChecksumFontInformation [842](#richtextstreamchecksumfontinformation)](#richtextstreamchecksumfontinformation) + +[2.5.216 RichTextStreamChecksumFontInformationArrayItem [844](#richtextstreamchecksumfontinformationarrayitem)](#richtextstreamchecksumfontinformationarrayitem) + +[2.5.217 RkNumber [844](#rknumber)](#rknumber) + +[2.5.218 RkRec [845](#rkrec)](#rkrec) + +[2.5.219 RPHSSub [845](#rphssub)](#rphssub) + +[2.5.220 RRD [846](#rrd)](#rrd) + +[2.5.221 RRDDefNameFlags [846](#rrddefnameflags)](#rrddefnameflags) + +[2.5.222 RRLoc [848](#rrloc)](#rrloc) + +[2.5.223 RTDEItem [848](#rtdeitem)](#rtdeitem) + +[2.5.224 RTDOper [848](#rtdoper)](#rtdoper) + +[2.5.225 RTDOperStr [849](#rtdoperstr)](#rtdoperstr) + +[2.5.226 Run [849](#run)](#run) + +[2.5.227 Rw [849](#rw)](#rw) + +[2.5.228 Rw12 [850](#rw12)](#rw12) + +[2.5.229 RwLongU [850](#rwlongu)](#rwlongu) + +[2.5.230 RwU [850](#rwu)](#rwu) + +[2.5.231 Rwx [850](#rwx)](#rwx) + +[2.5.232 Script [851](#script)](#script) + +[2.5.233 SD_SetSortOrder [851](#sd_setsortorder)](#sd_setsortorder) + +[2.5.234 SDContainer [851](#sdcontainer)](#sdcontainer) + +[2.5.235 SecurityDescriptor [852](#securitydescriptor)](#securitydescriptor) + +[2.5.236 ShapePropsStreamChecksumData [852](#shapepropsstreamchecksumdata)](#shapepropsstreamchecksumdata) + +[2.5.237 SharedFeatureType [853](#sharedfeaturetype)](#sharedfeaturetype) + +[2.5.238 SheetExtOptional [854](#sheetextoptional)](#sheetextoptional) + +[2.5.239 ShortDTR [855](#shortdtr)](#shortdtr) + +[2.5.240 ShortXLUnicodeString [855](#shortxlunicodestring)](#shortxlunicodestring) + +[2.5.241 SLCO8 [856](#slco8)](#slco8) + +[2.5.242 SortCond12 [856](#sortcond12)](#sortcond12) + +[2.5.243 SortItem [857](#sortitem)](#sortitem) + +[2.5.244 SourceType [858](#sourcetype)](#sourcetype) + +[2.5.245 SQElfFlags [858](#sqelfflags)](#sqelfflags) + +[2.5.246 SqRef [858](#sqref)](#sqref) + +[2.5.247 SqRefU [859](#sqrefu)](#sqrefu) + +[2.5.248 Stxp [859](#stxp)](#stxp) + +[2.5.249 StyleXF [860](#stylexf)](#stylexf) + +[2.5.250 SXAddl_SXDEnd [862](#sxaddl_sxdend)](#sxaddl_sxdend) + +[2.5.251 SXAddl_SXDVerUpdInv [862](#sxaddl_sxdverupdinv)](#sxaddl_sxdverupdinv) + +[2.5.252 SXAddl_SXString [862](#sxaddl_sxstring)](#sxaddl_sxstring) + +[2.5.253 SXAddlHdr [863](#sxaddlhdr)](#sxaddlhdr) + +[2.5.254 SXAxis [863](#sxaxis)](#sxaxis) + +[2.5.255 SXEZDoper [863](#sxezdoper)](#sxezdoper) + +[2.5.256 SxFT [864](#sxft)](#sxft) + +[2.5.257 SxIvdCol [868](#sxivdcol)](#sxivdcol) + +[2.5.258 SxIvdRw [868](#sxivdrw)](#sxivdrw) + +[2.5.259 SXLIItem [868](#sxliitem)](#sxliitem) + +[2.5.260 SXPI_Item [871](#sxpi_item)](#sxpi_item) + +[2.5.261 SXVDEx_Opt [871](#sxvdex_opt)](#sxvdex_opt) + +[2.5.262 SXView9Save [872](#sxview9save)](#sxview9save) + +[2.5.263 SXVIFlags [872](#sxviflags)](#sxviflags) + +[2.5.264 TabId [873](#tabid)](#tabid) + +[2.5.265 TabIndex [873](#tabindex)](#tabindex) + +[2.5.266 TableFeatureType [873](#tablefeaturetype)](#tablefeaturetype) + +[2.5.267 Tag_Fn_MDX [877](#tag_fn_mdx)](#tag_fn_mdx) + +[2.5.268 TextPropsStreamChecksumData [878](#textpropsstreamchecksumdata)](#textpropsstreamchecksumdata) + +[2.5.269 Top10FT [880](#top10ft)](#top10ft) + +[2.5.270 Ts [880](#ts)](#ts) + +[2.5.271 TxOLastRun [880](#txolastrun)](#txolastrun) + +[2.5.272 TxORuns [881](#txoruns)](#txoruns) + +[2.5.273 TxtWf [881](#txtwf)](#txtwf) + +[2.5.274 Underline [882](#underline)](#underline) + +[2.5.275 VertAlign [882](#vertalign)](#vertalign) + +[2.5.276 VertBrk [882](#vertbrk)](#vertbrk) + +[2.5.277 VirtualPath [882](#virtualpath)](#virtualpath) + +[2.5.278 WebPubString [884](#webpubstring)](#webpubstring) + +[2.5.279 XColorType [885](#xcolortype)](#xcolortype) + +[2.5.280 XFExtGradient [885](#xfextgradient)](#xfextgradient) + +[2.5.281 XFExtNoFRT [886](#xfextnofrt)](#xfextnofrt) + +[2.5.282 XFIndex [886](#xfindex)](#xfindex) + +[2.5.283 XFProp [888](#xfprop)](#xfprop) + +[2.5.284 XFPropBorder [890](#xfpropborder)](#xfpropborder) + +[2.5.285 XFPropColor [890](#xfpropcolor)](#xfpropcolor) + +[2.5.286 XFPropGradient [891](#xfpropgradient)](#xfpropgradient) + +[2.5.287 XFPropGradientStop [892](#xfpropgradientstop)](#xfpropgradientstop) + +[2.5.288 XFProps [892](#xfprops)](#xfprops) + +[2.5.289 XFPropTextRotation [893](#xfproptextrotation)](#xfproptextrotation) + +[2.5.290 XLNameUnicodeString [893](#xlnameunicodestring)](#xlnameunicodestring) + +[2.5.291 XlsFilter_Criteria [894](#xlsfilter_criteria)](#xlsfilter_criteria) + +[2.5.292 XlsFilter_Top10 [895](#xlsfilter_top10)](#xlsfilter_top10) + +[2.5.293 XLUnicodeRichExtendedString [896](#xlunicoderichextendedstring)](#xlunicoderichextendedstring) + +[2.5.294 XLUnicodeString [897](#xlunicodestring)](#xlunicodestring) + +[2.5.295 XLUnicodeStringMin2 [898](#xlunicodestringmin2)](#xlunicodestringmin2) + +[2.5.296 XLUnicodeStringNoCch [898](#xlunicodestringnocch)](#xlunicodestringnocch) + +[2.5.297 XLUnicodeStringSegmented [898](#xlunicodestringsegmented)](#xlunicodestringsegmented) + +[2.5.298 XLUnicodeStringSegmentedRTD [899](#xlunicodestringsegmentedrtd)](#xlunicodestringsegmentedrtd) + +[2.5.299 XLUnicodeStringSegmentedSXAddl [899](#xlunicodestringsegmentedsxaddl)](#xlunicodestringsegmentedsxaddl) + +[2.5.300 XmlTkBackWallThicknessFrt [900](#xmltkbackwallthicknessfrt)](#xmltkbackwallthicknessfrt) + +[2.5.301 XmlTkBaseTimeUnitFrt [900](#xmltkbasetimeunitfrt)](#xmltkbasetimeunitfrt) + +[2.5.302 XmlTkBlob [901](#xmltkblob)](#xmltkblob) + +[2.5.303 XmlTkBool [901](#xmltkbool)](#xmltkbool) + +[2.5.304 XmlTkChain [902](#xmltkchain)](#xmltkchain) + +[2.5.305 XmlTkColorMappingOverride [904](#xmltkcolormappingoverride)](#xmltkcolormappingoverride) + +[2.5.306 XmlTkDispBlanksAsFrt [904](#xmltkdispblanksasfrt)](#xmltkdispblanksasfrt) + +[2.5.307 XmlTkDouble [905](#xmltkdouble)](#xmltkdouble) + +[2.5.308 XmlTkDWord [905](#xmltkdword)](#xmltkdword) + +[2.5.309 XmlTkEnd [906](#xmltkend)](#xmltkend) + +[2.5.310 XmlTkEndSurface [906](#xmltkendsurface)](#xmltkendsurface) + +[2.5.311 XmlTkFloorThicknessFrt [906](#xmltkfloorthicknessfrt)](#xmltkfloorthicknessfrt) + +[2.5.312 XmlTkFormatCodeFrt [907](#xmltkformatcodefrt)](#xmltkformatcodefrt) + +[2.5.313 XmlTkHeader [907](#xmltkheader)](#xmltkheader) + +[2.5.314 XmlTkHeightPercent [907](#xmltkheightpercent)](#xmltkheightpercent) + +[2.5.315 XmlTkLogBaseFrt [908](#xmltklogbasefrt)](#xmltklogbasefrt) + +[2.5.316 XmlTkMajorUnitFrt [908](#xmltkmajorunitfrt)](#xmltkmajorunitfrt) + +[2.5.317 XmlTkMajorUnitTypeFrt [908](#xmltkmajorunittypefrt)](#xmltkmajorunittypefrt) + +[2.5.318 XmlTkMaxFrt [909](#xmltkmaxfrt)](#xmltkmaxfrt) + +[2.5.319 XmlTkMinFrt [909](#xmltkminfrt)](#xmltkminfrt) + +[2.5.320 XmlTkMinorUnitFrt [910](#xmltkminorunitfrt)](#xmltkminorunitfrt) + +[2.5.321 XmlTkMinorUnitTypeFrt [910](#xmltkminorunittypefrt)](#xmltkminorunittypefrt) + +[2.5.322 XmlTkNoMultiLvlLbl [911](#xmltknomultilvllbl)](#xmltknomultilvllbl) + +[2.5.323 XmlTkOverlay [911](#xmltkoverlay)](#xmltkoverlay) + +[2.5.324 XmlTkPerspectiveFrt [912](#xmltkperspectivefrt)](#xmltkperspectivefrt) + +[2.5.325 XmlTkPieComboFrom12Frt [912](#xmltkpiecombofrom12frt)](#xmltkpiecombofrom12frt) + +[2.5.326 XmlTkRAngAxOffFrt [912](#xmltkrangaxofffrt)](#xmltkrangaxofffrt) + +[2.5.327 XmlTkRotXFrt [913](#xmltkrotxfrt)](#xmltkrotxfrt) + +[2.5.328 XmlTkRotYFrt [913](#xmltkrotyfrt)](#xmltkrotyfrt) + +[2.5.329 XmlTkShowDLblsOverMax [913](#xmltkshowdlblsovermax)](#xmltkshowdlblsovermax) + +[2.5.330 XmlTkSpb [914](#xmltkspb)](#xmltkspb) + +[2.5.331 XmlTkStart [914](#xmltkstart)](#xmltkstart) + +[2.5.332 XmlTkStartSurface [914](#xmltkstartsurface)](#xmltkstartsurface) + +[2.5.333 XmlTkString [915](#xmltkstring)](#xmltkstring) + +[2.5.334 XmlTkStyle [915](#xmltkstyle)](#xmltkstyle) + +[2.5.335 XmlTkSymbolFrt [915](#xmltksymbolfrt)](#xmltksymbolfrt) + +[2.5.336 XmlTkThemeOverride [916](#xmltkthemeoverride)](#xmltkthemeoverride) + +[2.5.337 XmlTkTickLabelPositionFrt [916](#xmltkticklabelpositionfrt)](#xmltkticklabelpositionfrt) + +[2.5.338 XmlTkTickLabelSkipFrt [917](#xmltkticklabelskipfrt)](#xmltkticklabelskipfrt) + +[2.5.339 XmlTkTickMarkSkipFrt [917](#xmltktickmarkskipfrt)](#xmltktickmarkskipfrt) + +[2.5.340 XmlTkToken [917](#xmltktoken)](#xmltktoken) + +[2.5.341 XmlTkTpb [918](#xmltktpb)](#xmltktpb) + +[2.5.342 Xnum [918](#xnum)](#xnum) + +[2.5.343 XORObfuscation [918](#xorobfuscation)](#xorobfuscation) + +[2.5.344 XTI [918](#xti)](#xti) + +[2.6 XCB Structures [920](#xcb-structures)](#xcb-structures) + +[2.6.1 CTBWRAPPER [920](#ctbwrapper)](#ctbwrapper) + +[2.6.2 CTBS [920](#ctbs)](#ctbs) + +[2.6.3 CTB [921](#ctb)](#ctb) + +[2.6.4 TBC [922](#tbc)](#tbc) + +[2.6.5 TBCCmd [923](#tbccmd)](#tbccmd) + +[2.7 Algorithms [924](#algorithms)](#algorithms) + +[2.7.1 Application Data For VtHyperlink [924](#application-data-for-vthyperlink)](#application-data-for-vthyperlink) + +[3 Structure Examples [925](#structure-examples)](#structure-examples) + +[3.1 Conditional Formatting [925](#conditional-formatting-1)](#conditional-formatting-1) + +[3.1.1 Conditional Formatting: CondFmt [925](#conditional-formatting-condfmt)](#conditional-formatting-condfmt) + +[3.1.2 Conditional Formatting: CF [927](#conditional-formatting-cf)](#conditional-formatting-cf) + +[3.2 Defined Name [934](#defined-name)](#defined-name) + +[3.2.1 Defined Name: Lbl [934](#defined-name-lbl)](#defined-name-lbl) + +[3.2.2 Defined Name: ExternSheet [936](#defined-name-externsheet)](#defined-name-externsheet) + +[3.2.3 Defined Name: SupBook [937](#defined-name-supbook)](#defined-name-supbook) + +[3.3 Table [937](#table-1)](#table-1) + +[3.3.1 Table: Feathdr11 [937](#table-feathdr11)](#table-feathdr11) + +[3.3.2 Table: Feature11 [938](#table-feature11)](#table-feature11) + +[3.4 Filters [947](#filters)](#filters) + +[3.4.1 Filters: FilterMode [947](#filters-filtermode)](#filters-filtermode) + +[3.4.2 Filters: AutoFilterInfo [948](#filters-autofilterinfo)](#filters-autofilterinfo) + +[3.4.3 Filters: AutoFilter [948](#filters-autofilter)](#filters-autofilter) + +[3.5 External References [949](#external-references-1)](#external-references-1) + +[3.5.1 External References: Formula [950](#external-references-formula)](#external-references-formula) + +[3.5.2 External References: String [952](#external-references-string)](#external-references-string) + +[3.5.3 External References: SupBook 1 [953](#external-references-supbook-1)](#external-references-supbook-1) + +[3.5.4 External References: XCT [953](#external-references-xct)](#external-references-xct) + +[3.5.5 External References: CRN [954](#external-references-crn)](#external-references-crn) + +[3.5.6 External References: SupBook 2 [955](#external-references-supbook-2)](#external-references-supbook-2) + +[3.5.7 External References: ExternSheet [955](#external-references-externsheet)](#external-references-externsheet) + +[3.6 Column Chart Object [956](#column-chart-object)](#column-chart-object) + +[3.6.1 Column Chart Object: Chart [957](#column-chart-object-chart)](#column-chart-object-chart) + +[3.6.2 Column Chart Object: Frame [957](#column-chart-object-frame)](#column-chart-object-frame) + +[3.6.3 Column Chart Object: LineFormat [958](#column-chart-object-lineformat)](#column-chart-object-lineformat) + +[3.6.4 Column Chart Object: AreaFormat [959](#column-chart-object-areaformat)](#column-chart-object-areaformat) + +[3.6.5 Column Chart Object: Series [960](#column-chart-object-series)](#column-chart-object-series) + +[3.6.6 Column Chart Object: BRAI 1 [960](#column-chart-object-brai-1)](#column-chart-object-brai-1) + +[3.6.7 Column Chart Object: SeriesText [962](#column-chart-object-seriestext)](#column-chart-object-seriestext) + +[3.6.8 Column Chart Object: BRAI 2 [962](#column-chart-object-brai-2)](#column-chart-object-brai-2) + +[3.6.9 Column Chart Object: BRAI 3 [964](#column-chart-object-brai-3)](#column-chart-object-brai-3) + +[3.6.10 Column Chart Object: DataFormat [966](#column-chart-object-dataformat)](#column-chart-object-dataformat) + +[3.6.11 Column Chart Object: SerToCrt [966](#column-chart-object-sertocrt)](#column-chart-object-sertocrt) + +[3.6.12 Column Chart Object: ShtProps [966](#column-chart-object-shtprops)](#column-chart-object-shtprops) + +[3.6.13 Column Chart Object: DefaultText [967](#column-chart-object-defaulttext)](#column-chart-object-defaulttext) + +[3.6.14 Column Chart Object: Text [967](#column-chart-object-text)](#column-chart-object-text) + +[3.6.15 Column Chart Object: FontX [969](#column-chart-object-fontx)](#column-chart-object-fontx) + +[3.6.16 Column Chart Object: AxesUsed [969](#column-chart-object-axesused)](#column-chart-object-axesused) + +[3.6.17 Column Chart Object: AxisParent [970](#column-chart-object-axisparent)](#column-chart-object-axisparent) + +[3.6.18 Column Chart Object: Axis [970](#column-chart-object-axis)](#column-chart-object-axis) + +[3.6.19 Column Chart Object: CatSerRange [970](#column-chart-object-catserrange)](#column-chart-object-catserrange) + +[3.6.20 Column Chart Object: Tick [971](#column-chart-object-tick)](#column-chart-object-tick) + +[3.6.21 Column Chart Object: ChartFormat [972](#column-chart-object-chartformat)](#column-chart-object-chartformat) + +[3.6.22 Column Chart Object: Bar [973](#column-chart-object-bar)](#column-chart-object-bar) + +[3.7 Pie Chart Sheet [974](#pie-chart-sheet)](#pie-chart-sheet) + +[3.7.1 Pie Chart Sheet: PrintSize [974](#pie-chart-sheet-printsize)](#pie-chart-sheet-printsize) + +[3.7.2 Pie Chart Sheet: Chart [974](#pie-chart-sheet-chart)](#pie-chart-sheet-chart) + +[3.7.3 Pie Chart Sheet: ShtProps [975](#pie-chart-sheet-shtprops)](#pie-chart-sheet-shtprops) + +[3.7.4 Pie Chart Sheet: AxesUsed [975](#pie-chart-sheet-axesused)](#pie-chart-sheet-axesused) + +[3.7.5 Pie Chart Sheet: AxisParent [976](#pie-chart-sheet-axisparent)](#pie-chart-sheet-axisparent) + +[3.7.6 Pie Chart Sheet: ChartFormat [976](#pie-chart-sheet-chartformat)](#pie-chart-sheet-chartformat) + +[3.7.7 Pie Chart Sheet: Pie [976](#pie-chart-sheet-pie)](#pie-chart-sheet-pie) + +[3.7.8 Pie Chart Sheet: Legend [977](#pie-chart-sheet-legend)](#pie-chart-sheet-legend) + +[3.7.9 Pie Chart Sheet: Pos [978](#pie-chart-sheet-pos)](#pie-chart-sheet-pos) + +[3.7.10 Pie Chart Sheet: Text [979](#pie-chart-sheet-text)](#pie-chart-sheet-text) + +[3.7.11 Pie Chart Sheet: BRAI [981](#pie-chart-sheet-brai)](#pie-chart-sheet-brai) + +[3.7.12 Pie Chart Sheet: Window2 [981](#pie-chart-sheet-window2)](#pie-chart-sheet-window2) + +[3.8 Formatting [982](#formatting)](#formatting) + +[3.8.1 Formatting: Font 1 [983](#formatting-font-1)](#formatting-font-1) + +[3.8.2 Formatting: Font 2 [984](#formatting-font-2)](#formatting-font-2) + +[3.8.3 Formatting: Format [985](#formatting-format)](#formatting-format) + +[3.8.4 Formatting: XF 1 [986](#formatting-xf-1)](#formatting-xf-1) + +[3.8.5 Formatting: XF 2 [988](#formatting-xf-2)](#formatting-xf-2) + +[3.8.6 Formatting: XF 3 [990](#formatting-xf-3)](#formatting-xf-3) + +[3.8.7 Formatting: XF 4 [992](#formatting-xf-4)](#formatting-xf-4) + +[3.8.8 Formatting: Number 1 [994](#formatting-number-1)](#formatting-number-1) + +[3.8.9 Formatting: Number 2 [995](#formatting-number-2)](#formatting-number-2) + +[3.8.10 Formatting: Number 3 [996](#formatting-number-3)](#formatting-number-3) + +[3.9 Workbook [996](#workbook)](#workbook) + +[3.9.1 Workbook: BOF 1 [997](#workbook-bof-1)](#workbook-bof-1) + +[3.9.2 Workbook: RRTabId [998](#workbook-rrtabid)](#workbook-rrtabid) + +[3.9.3 Workbook: BuiltInFnGroupCount [999](#workbook-builtinfngroupcount)](#workbook-builtinfngroupcount) + +[3.9.4 Workbook: Window1 [999](#workbook-window1)](#workbook-window1) + +[3.9.5 Workbook: HideObj [1001](#workbook-hideobj)](#workbook-hideobj) + +[3.9.6 Workbook: Date1904 [1001](#workbook-date1904)](#workbook-date1904) + +[3.9.7 Workbook: CalcPrecision [1001](#workbook-calcprecision)](#workbook-calcprecision) + +[3.9.8 Workbook: BookBool [1001](#workbook-bookbool)](#workbook-bookbool) + +[3.9.9 Workbook: Font [1002](#workbook-font)](#workbook-font) + +[3.9.10 Workbook: Format [1003](#workbook-format)](#workbook-format) + +[3.9.11 Workbook: XF [1004](#workbook-xf)](#workbook-xf) + +[3.9.12 Workbook: Style [1006](#workbook-style)](#workbook-style) + +[3.9.13 Workbook: BoundSheet8 1 [1007](#workbook-boundsheet8-1)](#workbook-boundsheet8-1) + +[3.9.14 Workbook: BoundSheet8 2 [1007](#workbook-boundsheet8-2)](#workbook-boundsheet8-2) + +[3.9.15 Workbook: BoundSheet8 3 [1008](#workbook-boundsheet8-3)](#workbook-boundsheet8-3) + +[3.9.16 Workbook: Country [1008](#workbook-country)](#workbook-country) + +[3.9.17 Workbook: RecalcId [1009](#workbook-recalcid)](#workbook-recalcid) + +[3.9.18 Workbook: SST [1009](#workbook-sst)](#workbook-sst) + +[3.9.19 Workbook: ExtSST [1009](#workbook-extsst)](#workbook-extsst) + +[3.9.20 Workbook: BookExt [1010](#workbook-bookext)](#workbook-bookext) + +[3.9.21 Workbook: EOF 1 [1012](#workbook-eof-1)](#workbook-eof-1) + +[3.9.22 Workbook: BOF 2 [1012](#workbook-bof-2)](#workbook-bof-2) + +[3.9.23 Workbook: Index [1013](#workbook-index)](#workbook-index) + +[3.9.24 Workbook: DefaultRowHeight [1014](#workbook-defaultrowheight)](#workbook-defaultrowheight) + +[3.9.25 Workbook: WsBool [1014](#workbook-wsbool)](#workbook-wsbool) + +[3.9.26 Workbook: Setup [1015](#workbook-setup)](#workbook-setup) + +[3.9.27 Workbook: DefColWidth [1017](#workbook-defcolwidth)](#workbook-defcolwidth) + +[3.9.28 Workbook: Dimensions [1017](#workbook-dimensions)](#workbook-dimensions) + +[3.9.29 Workbook: Row 1 [1018](#workbook-row-1)](#workbook-row-1) + +[3.9.30 Workbook: Row 2 [1019](#workbook-row-2)](#workbook-row-2) + +[3.9.31 Workbook: Row 3 [1020](#workbook-row-3)](#workbook-row-3) + +[3.9.32 Workbook: Row 4 [1020](#workbook-row-4)](#workbook-row-4) + +[3.9.33 Workbook: LabelSst 1 [1021](#workbook-labelsst-1)](#workbook-labelsst-1) + +[3.9.34 Workbook: RK [1022](#workbook-rk)](#workbook-rk) + +[3.9.35 Workbook: LabelSst 2 [1023](#workbook-labelsst-2)](#workbook-labelsst-2) + +[3.9.36 Workbook: Formula [1024](#workbook-formula)](#workbook-formula) + +[3.9.37 Workbook: DBCell [1027](#workbook-dbcell)](#workbook-dbcell) + +[3.9.38 Workbook: Window2 [1027](#workbook-window2)](#workbook-window2) + +[3.9.39 Workbook: Selection [1029](#workbook-selection)](#workbook-selection) + +[3.9.40 Workbook: PhoneticInfo [1030](#workbook-phoneticinfo)](#workbook-phoneticinfo) + +[3.9.41 Workbook: EOF 2 [1031](#workbook-eof-2)](#workbook-eof-2) + +[3.10 PivotTable [1031](#pivottable-1)](#pivottable-1) + +[3.10.1 PivotTable: SXStreamID [1032](#pivottable-sxstreamid)](#pivottable-sxstreamid) + +[3.10.2 PivotTable: SXVS [1032](#pivottable-sxvs)](#pivottable-sxvs) + +[3.10.3 PivotTable: DConRef [1033](#pivottable-dconref)](#pivottable-dconref) + +[3.10.4 PivotTable: SXAddl 1 [1034](#pivottable-sxaddl-1)](#pivottable-sxaddl-1) + +[3.10.5 PivotTable: SXAddl 2 [1035](#pivottable-sxaddl-2)](#pivottable-sxaddl-2) + +[3.10.6 PivotTable: SXAddl 3 [1036](#pivottable-sxaddl-3)](#pivottable-sxaddl-3) + +[3.10.7 PivotTable: SxView [1036](#pivottable-sxview)](#pivottable-sxview) + +[3.10.8 PivotTable: Sxvd 1 [1040](#pivottable-sxvd-1)](#pivottable-sxvd-1) + +[3.10.9 PivotTable: SXVI 1 [1041](#pivottable-sxvi-1)](#pivottable-sxvi-1) + +[3.10.10 PivotTable: SXVI 2 [1042](#pivottable-sxvi-2)](#pivottable-sxvi-2) + +[3.10.11 PivotTable: SXVI 3 [1042](#pivottable-sxvi-3)](#pivottable-sxvi-3) + +[3.10.12 PivotTable: SXVI 4 [1043](#pivottable-sxvi-4)](#pivottable-sxvi-4) + +[3.10.13 PivotTable: SXVDEx 1 [1044](#pivottable-sxvdex-1)](#pivottable-sxvdex-1) + +[3.10.14 PivotTable: Sxvd 2 [1045](#pivottable-sxvd-2)](#pivottable-sxvd-2) + +[3.10.15 PivotTable: SXVI 5 [1047](#pivottable-sxvi-5)](#pivottable-sxvi-5) + +[3.10.16 PivotTable: SXVI 6 [1047](#pivottable-sxvi-6)](#pivottable-sxvi-6) + +[3.10.17 PivotTable: SXVI 7 [1048](#pivottable-sxvi-7)](#pivottable-sxvi-7) + +[3.10.18 PivotTable: SXVDEx 2 [1048](#pivottable-sxvdex-2)](#pivottable-sxvdex-2) + +[3.10.19 PivotTable: Sxvd 3 [1049](#pivottable-sxvd-3)](#pivottable-sxvd-3) + +[3.10.20 PivotTable: Sxvd 4 [1050](#pivottable-sxvd-4)](#pivottable-sxvd-4) + +[3.10.21 PivotTable: SXVDEx 3 [1052](#pivottable-sxvdex-3)](#pivottable-sxvdex-3) + +[3.10.22 PivotTable: Sxvd 5 [1053](#pivottable-sxvd-5)](#pivottable-sxvd-5) + +[3.10.23 PivotTable: SXVDEx 4 [1054](#pivottable-sxvdex-4)](#pivottable-sxvdex-4) + +[3.10.24 PivotTable: SxIvd [1056](#pivottable-sxivd)](#pivottable-sxivd) + +[3.10.25 PivotTable: SXPI [1056](#pivottable-sxpi)](#pivottable-sxpi) + +[3.10.26 PivotTable: SXDI [1057](#pivottable-sxdi)](#pivottable-sxdi) + +[3.10.27 PivotTable: SXLI 1 [1057](#pivottable-sxli-1)](#pivottable-sxli-1) + +[3.10.28 PivotTable: SXLI 2 [1063](#pivottable-sxli-2)](#pivottable-sxli-2) + +[3.10.29 PivotTable: SXEx [1064](#pivottable-sxex)](#pivottable-sxex) + +[3.10.30 PivotTable: QsiSXTag [1066](#pivottable-qsisxtag)](#pivottable-qsisxtag) + +[3.10.31 PivotTable: SXViewEx9 [1068](#pivottable-sxviewex9)](#pivottable-sxviewex9) + +[3.10.32 PivotTable: SxAddl 4 [1068](#pivottable-sxaddl-4)](#pivottable-sxaddl-4) + +[3.10.33 PivotTable: SxAddl 5 [1069](#pivottable-sxaddl-5)](#pivottable-sxaddl-5) + +[3.10.34 PivotTable: SxAddl 6 [1071](#pivottable-sxaddl-6)](#pivottable-sxaddl-6) + +[3.10.35 PivotTable: SXDB [1071](#pivottable-sxdb)](#pivottable-sxdb) + +[3.10.36 PivotTable: SXDBEx [1073](#pivottable-sxdbex)](#pivottable-sxdbex) + +[3.10.37 PivotTable: SXFDB 1 [1073](#pivottable-sxfdb-1)](#pivottable-sxfdb-1) + +[3.10.38 PivotTable: SXString 1 [1075](#pivottable-sxstring-1)](#pivottable-sxstring-1) + +[3.10.39 PivotTable: SXString 2 [1075](#pivottable-sxstring-2)](#pivottable-sxstring-2) + +[3.10.40 PivotTable: SXString 3 [1075](#pivottable-sxstring-3)](#pivottable-sxstring-3) + +[3.10.41 PivotTable: SXFDB 2 [1076](#pivottable-sxfdb-2)](#pivottable-sxfdb-2) + +[3.10.42 PivotTable: SXDtr 1 [1077](#pivottable-sxdtr-1)](#pivottable-sxdtr-1) + +[3.10.43 PivotTable: SXDtr 2 [1077](#pivottable-sxdtr-2)](#pivottable-sxdtr-2) + +[3.10.44 PivotTable: SXFDB 3 [1078](#pivottable-sxfdb-3)](#pivottable-sxfdb-3) + +[3.10.45 PivotTable: SXFDB 4 [1079](#pivottable-sxfdb-4)](#pivottable-sxfdb-4) + +[3.10.46 PivotTable: SXNum 1 [1080](#pivottable-sxnum-1)](#pivottable-sxnum-1) + +[3.10.47 PivotTable: SXFDB 5 [1081](#pivottable-sxfdb-5)](#pivottable-sxfdb-5) + +[3.10.48 PivotTable: SXDBB 1 [1082](#pivottable-sxdbb-1)](#pivottable-sxdbb-1) + +[3.10.49 PivotTable: SXNum 2 [1082](#pivottable-sxnum-2)](#pivottable-sxnum-2) + +[3.10.50 PivotTable: SXDBB 2 [1083](#pivottable-sxdbb-2)](#pivottable-sxdbb-2) + +[3.10.51 PivotTable: SXNum 3 [1083](#pivottable-sxnum-3)](#pivottable-sxnum-3) + +[3.10.52 PivotTable: EOF [1084](#pivottable-eof)](#pivottable-eof) + +[4 Security Considerations [1085](#security-considerations)](#security-considerations) + +[5 Appendix A: Product Behavior [1086](#appendix-a-product-behavior)](#appendix-a-product-behavior) + +[6 Change Tracking [1096](#change-tracking)](#change-tracking) + +[7 Index [1098](#index-1)](#index-1) + +# Introduction + +The Excel Binary File Format (.xls) Structure specifies the Excel Binary File Format (.xls). The Excel Binary File Format (.xls) is a collection of records and structures that specify [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) content, which can include unstructured or semi-structured tables of numbers, text, or both numbers and text, formulas, external data connections, charts, and images. Workbook content is typically organized in a grid based layout, and often includes numeric data, structured data, and formulas. + +Sections 1.7 and 2 of this specification are normative. All other sections and examples in this specification are informative. + +## Glossary + +This document uses the following terms: + +> **3-D Phong shading**: A shading algorithm that is used to apply shading to 3-D charts. The algorithm interpolates color between points on the surface of a chart to give a smooth 3-D appearance. +> +> **A1**: A [**reference style**](#gt_71d7e4ad-d6b6-49d9-b247-e2ebba1469e9) in which each column is identified sequentially from left-to-right with a letter or series of letters in alphabetical order. Column headings are ordered A-Z, then AA-AZ, BA-BZ... ZA-ZZ, AAA-AAZ, and so forth. Each row is numbered sequentially from the top down. +> +> **absolute reference**: A reference to a fixed location on a [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). An absolute reference always refers to the same range, even if the formula that contains it is moved or copied to a new location. +> +> **accelerator key**: Any combination of keys that are pressed simultaneously to run a command. +> +> **active cell**: The cell that is currently selected in a worksheet. +> +> **active pane**: The pane that currently has focus or contains the current selection or object. +> +> **active sheet**: The sheet that is currently selected. +> +> **ActiveX control**: A reusable software control, such as a check box or button, that uses ActiveX technology and provides options to users or runs macros or scripts that automate a task. See also [**ActiveX object**](#gt_0d95e494-61b2-43bc-8818-51aa162d2018). +> +> **ActiveX Data Objects (ADO)**: A data access interface that connects to, retrieves, manipulates, and updates data in [**Object Linking and Embedding (OLE)**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) database-compliant data sources. +> +> **ActiveX object**: An object that is supplied by a component that supports automation. +> +> **add-in**: Supplemental functionality that is provided by an external application or macro to extend the capabilities of an application. +> +> **add-in function**: A worksheet function that is provided by an [**add-in**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6), instead of being built-in. +> +> **advanced filter**: An extended filter option that enables users to specify complex filter criteria and a destination range for the filter results. +> +> **aggregation function**: A function, such as sum or average, that appears in the total row of a table and is used to summarize data. +> +> **ALL**: See OLAP All member. +> +> **alternate startup directory**: A secondary location that stores files to be opened by an application when the application starts. +> +> **American National Standards Institute (ANSI) character set**: A [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204) defined by a [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38) approved by the American National Standards Institute (ANSI). The term "ANSI" as used to signify Windows code pages is a historical reference and a misnomer that persists in the Windows community. The source of this misnomer stems from the fact that the Windows code page 1252 was originally based on an ANSI draft, which became International Organization for Standardization (ISO) Standard 8859-1 [\[ISO/IEC-8859-1\]](https://go.microsoft.com/fwlink/?LinkId=90689). In Windows, the ANSI character set can be any of the following code pages: 1252, 1250, 1251, 1253, 1254, 1255, 1256, 1257, 1258, 874, 932, 936, 949, or 950. For example, "ANSI application" is usually a reference to a non-[**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) or code-page-based application. Therefore, "ANSI character set" is often misused to refer to one of the character sets defined by a Windows code page that can be used as an active system code page; for example, character sets defined by code page 1252 or character sets defined by code page 950. Windows is now based on Unicode, so the use of ANSI character sets is strongly discouraged unless they are used to interoperate with legacy applications or legacy data. +> +> **ASCII**: The American Standard Code for Information Interchange (ASCII) is an 8-bit character-encoding scheme based on the English alphabet. ASCII codes represent text in computers, communications equipment, and other devices that work with text. ASCII refers to a single 8-bit ASCII character or an array of 8-bit ASCII characters with the high bit of each character set to zero. +> +> **attribute hierarchy**: A single-level [**hierarchy**](#gt_a07fc05d-cdb0-442c-984a-dd3589b9f682) that uses only an attribute or a column from a source, back-end relational database as its hierarchy. An attribute hierarchy typically has the same name as the attribute and is always associated with the attribute on which it is based. An all-level member can optionally be enabled for an attribute hierarchy. See also OLAP hierarchy. +> +> **Augmented Backus-Naur Form (ABNF)**: A modified version of Backus-Naur Form (BNF), commonly used by Internet specifications. ABNF notation balances compactness and simplicity with reasonable representational power. ABNF differs from standard BNF in its definitions and uses of naming rules, repetition, alternatives, order-independence, and value ranges. For more information, see [\[RFC5234\]](https://go.microsoft.com/fwlink/?LinkId=123096). +> +> **AutoComplete**: A feature that suggests text automatically based on the first few characters that a user types. +> +> **AutoFilter**: A mechanism that can be used to filter tabular data based on user-defined criteria such as values, strings, and formatting. +> +> **AutoFormat**: A built-in set of complementary formatting options that can be applied to ranges of cells and other objects in a document. +> +> **AutoRecover**: A feature that recovers document and application states in the event of a hardware or software failure. +> +> **AutoShow**: A filter option that enables users to display a specified number of the top- or bottom-most items within a PivotTable field. +> +> **background color**: A color against which characters, patterns, and graphics are displayed. See also [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a). +> +> **beta**: A pre-released version of a product that is sent to customers and partners for evaluation and feedback. +> +> **BIFF12**: A binary file format that is used to save workbooks in Microsoft Office Excel 2007 and Microsoft Excel 2010. +> +> **BIFF2**: A binary file format that is used by default to save worksheets in Microsoft Excel 2.1. +> +> **BIFF3**: A binary file format that is used by default to save worksheets in Microsoft Excel 3.0 for Windows. +> +> **BIFF4**: A binary file format that is used by default to save worksheets in Microsoft Excel 4.0 for Windows. +> +> **BIFF5**: A binary file format that is used by default to save workbooks in Microsoft Excel 5.0 for Windows and Microsoft Excel for Windows 95. +> +> **BIFF8**: A binary file format that is used to save workbooks in Microsoft Office Excel 2003 and earlier versions of Microsoft Excel. +> +> **big-endian**: Multiple-byte values that are byte-ordered with the most significant byte stored in the memory location with the lowest address. +> +> **Binary Interchange File Format (BIFF)**: The binary file formats that are used to save Excel workbooks. +> +> **block-level formatting**: A type of formatting that can be applied to a field or column in a table. It is applied to all existing records and automatically to new records. +> +> **border**: A line that can be applied to the outer edge of a cell, shape, object, or chart element. A border can be variously formatted for style, color, and thickness. +> +> **border formatting**: A set of properties that, as a whole, specify the appearance of a border, such as color, line style, and thickness. +> +> **border style**: See [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad). +> +> **bounding rectangle**: A frame that encompasses an object. A bounding rectangle is not rotated and, therefore, always aligns along the x and y axes. +> +> **Briefcase**: A system folder in Windows that is used to share and synchronize files between computers. +> +> **bubble size**: A value that represents the diameter of a bubble in a bubble chart. +> +> **build identifier**: An integer that identifies a build. +> +> **build number**: A part of a sequential numbering system that is used to differentiate one version of a software product from another. +> +> **built-in name**: A member of the group of defined names that are reserved for specific functionality. +> +> **ButtonPopup control**: A type of Button control that displays a menu of related commands when activated. +> +> **calculation mode**: A setting that determines whether the formulas in a worksheet are recalculated automatically or manually. See also automatic calculation mode and manual calculation mode. +> +> **camera picture**: An image of a range of cells that is generated by using the camera tool. The image can be linked such that when the data in the source range changes, the image is updated automatically. +> +> **caption**: One or more characters that can be used as a label for display purposes or as an identifier. +> +> **cascading style sheet (CSS)**: An extension to [**HTML**](#gt_549c4960-e8be-4c24-bc2b-b86530f1c1bf) that enables authors and users of HTML documents to attach style sheets to those documents, as described in [\[CSS-LEVEL1\]](https://go.microsoft.com/fwlink/?LinkId=99527) and [\[CSS-LEVEL2\]](https://go.microsoft.com/fwlink/?LinkId=114090). A style sheet includes typographical information about the appearance of a page, including the font for text on the page. +> +> **category**: A subdivision of items into useful groups such as geographical regions. For example, categories that represent geographical regions could be North, South, East, and West. +> +> **category label**: A label that appears on the horizontal (x) axis of a chart and identifies the categories of the source data. +> +> **cell**: A box that is formed by the intersection of a row and a column in a worksheet or a table. A cell can contain numbers, strings, and formulas, and various formats can be applied to that data. +> +> **cell reference**: A set of coordinates that a cell occupies on a worksheet. For example, "B3" is the reference of a cell that appears at the intersection of column "B" and row "3". +> +> **cell value**: The text or numeric content of a cell, or the results of a formula. A cell value does not include a formula expression, cell formatting, or other metadata. +> +> **center-across-selection alignment**: A formatting setting that centers cell content horizontally within a selected range of cells. +> +> **centered alignment**: A formatting setting that specifies how content is positioned within the horizontal, vertical, or both horizontal and vertical space within a cell, object, or page. When centered, content is equidistant from the edges of the cell, object, or page. +> +> **character set**: A mapping between the characters of a written language and the values that are used to represent those characters to a computer. +> +> **chart area**: A region in a chart object that is used to position chart elements, render axes, and plot data. +> +> **chart sheet**: A single logical container that is used to create and store charts in a workbook. +> +> **checksum**: A value that is the summation of a byte stream. By comparing the checksums computed from a data item at two different times, one can quickly assess whether the data items are identical. +> +> **child**: An object that is immediately below the current object in a hierarchy. +> +> **class identifier (CLSID)**: A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) that identifies a software component; for instance, a DCOM object class or a COM class. +> +> **class module**: A module that contains the definition for a new object. Each instance of a class creates a new object, and procedures that are defined in the module become properties and methods of the object. +> +> **client area**: In an application, the display area that is used to create data, such as drawing or typing functions. The client area does not include toolbars, menus, or status bars. +> +> **code page**: An ordered set of characters of a specific script in which a numerical index (code-point value) is associated with each character. Code pages are a means of providing support for [**character sets**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204) and keyboard layouts used in different countries. Devices such as the display and keyboard can be configured to use a specific code page and to switch from one code page (such as the United States) to another (such as Portugal) at the user's request. +> +> **collapsed outline state**: A state in which the content that is nested within an outline is not displayed. +> +> **color palette**: A collection of colors that is available to format text, shapes, cells, and chart elements. +> +> **color scale**: A specific range of colors that is used to give additional meaning to data by assigning certain values to colors in the spectrum. +> +> **color scheme**: A table of color values that enables colors to be referenced by an index value in the table instead of a color value. See also [**color palette**](#gt_05879d13-b9e0-4333-b96d-63cc3433997e). +> +> **column formula**: A formula that is used in a calculated column. +> +> **column outline**: A nested grouping of columns in a worksheet. +> +> **comment**: An annotation that is associated with a cell, text, or other object to provide context-specific information or reviewer feedback. +> +> **compact axis**: A state in which PivotTable members from different levels in a hierarchy are displayed in a single column. +> +> **Component Object Model (COM)**: An object-oriented programming model that defines how objects interact within a single process or between processes. In [**COM**](#gt_ef2ebebc-1760-407a-9ace-af48f9050e02), clients have access to an object through interfaces implemented on the object. For more information, see [\[MS-DCOM\]](%5bMS-DCOM%5d.pdf#Section_4a893f3dbd2948cd9f43d9777a4415b0). +> +> **conditional formatting**: A mechanism that changes the appearance of a user interface element based on the evaluation of a rule or expression. +> +> **connection string**: A series of arguments, delimited by a semicolon, that defines the location of a database and how to connect to it. +> +> **consolidation range**: A range of source data that is used in a data consolidation process. +> +> **cryptographic service provider**: An independent software module that performs authentication, encoding, and encryption services that Windows-based applications access through the CryptoAPI. +> +> **cube**: A set of data that is organized and summarized into a multidimensional structure that is defined by a set of [**dimensions (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) and [**measures**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998). +> +> **cube function**: A function that is used to extract and display Online Analytical Processing (OLAP) data sets and values. +> +> **custom color palette**: A set of user-defined colors that is available for formatting. +> +> **custom filter**: A filter that contains preconfigured expressions in which users can optionally enter a string to filter data. +> +> **custom list**: A user-defined list or enumeration that can be used to sort data in a worksheet. +> +> **custom rollup**: An aggregation calculation that is customized for a dimension level, dimension member, or measure. A custom rollup contains a custom formula or operator, overrides the aggregate functions of a cube's measures, and is defined on a hierarchy. +> +> **custom view**: A collection of display and print settings that users can name and save. Users can switch between custom views to change settings quickly. +> +> **Data Access Objects (DAO)**: A programming interface that can be used to access and manipulate database objects. +> +> **data bar**: A graphical representation of cell content as a bar graph. +> +> **data consolidation**: The process of combining tabular data from various worksheets into a single list. +> +> **data marker**: A customizable symbol or shape that identifies a data point on a line, scatter, or radar chart. A data marker can be formatted with various sizes and colors. +> +> **data provider**: A known data source that is specific to a target type and that provides data to a collector type. +> +> **data recovery**: A process in which files are repaired through error correction or restored from backup media. +> +> **data region**: A region of a table that encompasses the range of cells that contains the table records. A data region does not include the [**header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38), insert row, or total row of a table. +> +> **data source**: A database, web service, disk, file, or other collection of information from which data is queried or submitted. Supported data sources vary based on application and data provider. +> +> **data table**: (1) A range of cells that is designated to perform what-if analysis for formulas, based on various input values. +> +> \(2\) A grid that can be added to some charts and contains the numeric data that is plotted in the chart. +> +> **data validation**: The process of testing the accuracy of data; a set of rules that specify the type and range of data that users can enter. +> +> **date system**: A method of calculating calendar dates and times. +> +> **DDE link**: A connection between a [**Dynamic Data Exchange (DDE)**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) source document and a destination document. +> +> **DDE server**: An application that responds to a [**Dynamic Data Exchange (DDE)**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) request from a DDE client application. +> +> **DDE topic**: A general classification of information about a [**Dynamic Data Exchange (DDE)**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) server within which multiple, specific data items related to the topic can be exchanged. +> +> **defined name**: A word or string of characters in a formula that represents a cell, range of cells, formula, or constant value. +> +> **descending order**: A sort order in which text strings are arranged in reverse alphabetical order, numerical values are arranged from largest to smallest, and dates and times are arranged from newest to oldest. +> +> **diagonal-down**: A cell [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad) that displays a line diagonally from the top left corner of a cell to the bottom right corner. +> +> **diagonal-up**: A cell [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad) that displays a line diagonally from the bottom left corner of a cell to the top right corner. +> +> **dialog sheet**: A single logical container that is used to create a custom dialog box. +> +> **dimension**: (1) A structural attribute of a cube, which is an organized hierarchy of categories (levels) that describe data in a fact table. These categories typically describe a similar set of members upon which the user bases an analysis. +> +> \(2\) A categorization of data in rows or columns in an Excel worksheet. +> +> **display folder**: A folder into which attributes, measures, calculated members, and key performance indicators can be organized to facilitate browsing. +> +> **display units**: An axis-formatting option that determines how numeric units are displayed on a value axis. +> +> **distributed alignment**: A formatting setting that spreads text evenly, both vertically and horizontally, between the edges of a cell, object, or page. Distributed alignment is used primarily with East Asian languages. See also [**justify distributed**](#gt_11eced66-af2c-4391-8b45-87a60ad41483). +> +> **document library**: A type of list that is a container for documents and folders. +> +> **double accounting**: An underline style that places two lines beneath the formatted text. Double accounting is frequently used to indicate totals. +> +> **down bar**: See [**up-down bar**](#gt_54f291c2-81aa-41b6-8831-88d180a09ea0). +> +> **drawing**: A collection of drawing objects, such as shapes, curves, or WordArt, that are viewed together as a single image. +> +> **drawing group**: A collection of images that are designated by the user as a single group of images and manipulated as a single [**drawing object**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac). +> +> **drawing object**: A shape, curve, line, WordArt, or other type of graphical object that can be inserted into a document. +> +> **drillthrough**: A query that is used to retrieve individual records that were used to calculate an aggregate value. +> +> **drop lines**: A set of supplemental lines on an area chart or a line chart. Drop lines increase the legibility of a chart by connecting each data point in a series to the category axis. +> +> **Dynamic Data Exchange (DDE)**: An inter-process communication method that is featured in Windows. DDE allows two or more applications that are running simultaneously to exchange data and commands. +> +> **embedded object**: An object that is created by using one application and is hosted in a document that was created by using another application. Embedding an object, rather than inserting or pasting it, ensures that the object retains its original format. Users can double-click an embedded object and edit it with the toolbars and menus from the application that was used to create it. See also [**Object Linking and Embedding (OLE)**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c). +> +> **Excel Linked Library (XLL)**: A Dynamic Link Library (DLL) that is authored to function as an [**add-in**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6) for Microsoft Excel. +> +> **Excel macro (XLM)**: A programming language that provides development capability in Microsoft Excel. XLM was superseded by Microsoft Visual Basic for Applications (VBA). +> +> **expand/collapse button**: A user interface control that is used to determine which hierarchical level is displayed in an outline, or in row and column groupings. +> +> **expression**: A combination of operators, symbols, constants, literal values, functions, names of fields or columns, controls, and properties that evaluates to a single value. +> +> **external data**: Data that is stored in a repository outside a workbook. +> +> **external link**: A reference to a cell, range, defined name, or other object in another worksheet or workbook. +> +> **fill**: A color, pattern, or other attribute that is used to format the background of a cell, shape, or chart element. See also [**fill color**](#gt_ed1c5310-a27a-4576-883a-f9f3e18ba20a) and [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e). +> +> **fill alignment**: A setting that repeats a cell value to fill the horizontal space of a cell. If the cell value exceeds the horizontal width of the cell, the value is truncated. +> +> **fill color**: A color that is used to fill the background of a cell, shape, or chart element. +> +> **fill pattern**: A repetitive design that users can add to the background of a cell, shape, or chart element. +> +> **filter**: A mechanism by which a set of data is scoped to display only those entries that meet specified logical criteria. +> +> **filtering state**: A setting that indicates whether a filter value or filter date value is included as part of the criteria that is used to define the filter for an [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). +> +> **fit to page**: A printing option that scales a document to print on a specified number of pages. +> +> **floating-point number**: A number that is represented by a mantissa and an exponent according to a given base. The mantissa is typically a value between "0" and "1". To find the value of a floating-point number, the base is raised to the power of the exponent, and the mantissa is multiplied by the result. +> +> **floor**: An extension of the horizontal axis, or the area created by the inclusion of the z axis, in a 3-D chart to create a three-dimensional effect. See also [**wall**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c). +> +> **folder**: A file system construct. File systems organize a volume's data by providing a hierarchy of objects, which are referred to as folders or directories, that contain files and can also contain other folders. +> +> **followed hyperlink**: A hyperlink that has been activated by a user. +> +> **font**: An object that defines the graphic design, or formatting, of a collection of numbers, symbols, and letters. A font specifies the style (such as bold and strikeout), size, family (a typeface such as Times New Roman), and other qualities to describe how the collection is drawn. +> +> **font face weight**: A value that specifies the thickness of a font. +> +> **font family**: A set of fonts that all have common stroke width and serif characteristics. For example, Times Roman and Times Roman Italic are members of the same font family. +> +> **font scaling**: A process of resizing a proportionally-spaced font. +> +> **font scheme**: A combination of complementary fonts in a [**theme**](#gt_8b5eb4c0-949b-47d9-8b63-b9bda81d61b8). +> +> **forecast**: The process of projecting values forward or backward in a series, based on trends in existing data. +> +> **foreground color**: A color that is used to display text, patterns, and other objects that appear in front of or on top of the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c). +> +> **form**: A structured document with controls and spaces that are reserved for entering and displaying information. Forms can contain special coding for actions such as submitting and querying data. +> +> **format string**: A string that contains the number formatting information to apply to data, such as decimal position, percentage indicator, or currency symbol. +> +> **formatting run**: A set of formatting properties that are applied to a [**text run**](#gt_393612a7-9552-48b0-abf6-0371dbd6d553). +> +> **formula bar**: A user interface element that appears at the top of a worksheet and is used to display and edit cell content. +> +> **formula error checking**: A mechanism that identifies invalid worksheet data, formulas, or formatting and then proposes corrections. +> +> **friendly name**: A name for a user or object that can be read and understood easily by a human. +> +> **frozen**: See [**frozen panes**](#gt_28507dfc-4443-4a02-a18c-27b5db006946). +> +> **frozen panes**: Portions of a worksheet that remain static and do not scroll when the worksheet is displayed in split pane view. See also [**split pane**](#gt_03a3359c-d8a8-4988-ace6-369a2ae4ff82). +> +> **full screen view**: A document view that expands the display of a document to fill the computer screen. The view hides menus, toolbars, and taskbars. +> +> **function**: A code module that takes a value as input, performs an operation, and returns the results to a worksheet. +> +> **function category**: A group of worksheet functions that are part of the same broad usage area, such as Finance or Statistical. A function category can be built-in or user-defined. +> +> **general alignment**: A default formatting setting for the horizontal alignment of cell content in a worksheet. Text is positioned to the left and numbers are positioned to the right. +> +> **globally unique identifier (GUID)**: A term used interchangeably with universally unique identifier (UUID) in Microsoft protocol technical documents (TDs). Interchanging the usage of these terms does not imply or require a specific algorithm or mechanism to generate the value. Specifically, the use of this term does not imply or require that the algorithms described in [\[RFC4122\]](https://go.microsoft.com/fwlink/?LinkId=90460) or [\[C706\]](https://go.microsoft.com/fwlink/?LinkId=89824) have to be used for generating the GUID. See also universally unique identifier (UUID). +> +> **gradient fill**: A type of fill that applies gradient formatting to the background of a cell or an object. +> +> **gradient stop**: A marker on a gradient spectrum that denotes where a specific color is introduced in gradient formatting. +> +> **grand total**: An aggregation of all of the field subtotals in a PivotTable report. +> +> **graph object**: An object that represents a chart and the datasheet that contains the data for that chart. +> +> **GraphicDropDown control**: A type of DropDown control that can display custom graphics in a list of options. +> +> **gridline**: A line that is drawn on a worksheet or table for use as a visual aid to distinguish between cells. +> +> **gutter**: An area above a column heading and to the left of a row heading. A gutter typically displays outline symbols that are used to expand and collapse groups of cells. +> +> **hash**: A fixed-size result that is obtained by applying a one-way mathematical function, which is sometimes referred to as a hash algorithm, to an arbitrary amount of data. If the input data changes, the hash also changes. The hash can be used in many operations, including authentication and digital signing. +> +> **header row**: A row in a table, typically the first row, that contains labels for columns in the table. +> +> **hidden**: A condition of an object that prevents it from being displayed in rendered output. +> +> **hidden cell**: A cell that does not appear in a worksheet view because it is contained within a [**hidden row**](#gt_3833addc-1f77-4c64-856c-c1b967fdaa75) or a [**hidden column**](#gt_ea5c8135-254e-407c-999b-5cf39e709164). +> +> **hidden column**: A column that does not appear in a worksheet view because its width is set to 0 (zero). A column can be hidden if an outline is collapsed. +> +> **hidden protection**: A cell protection property that prevents formulas, but not values, from appearing in a cell when a worksheet is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829). +> +> **hidden row**: A row that does not appear in a worksheet view because its height is set to "0" (zero). A row can be hidden if the data is filtered or an outline is collapsed. +> +> **hierarchy**: A logical tree structure that organizes the members of a dimension such that each member has one parent member and zero or more child members. +> +> **high-low lines**: Supplemental lines that are added to a line chart and connect the maximum data points of one series with the minimum data points of another series for each [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1). High-low lines are typically used on stock charts. +> +> **horizontal alignment**: A formatting setting that specifies how content is positioned within the horizontal space of a cell, object, or page. Content can be aligned along the left or right edge, or distributed evenly across the horizontal space. +> +> **hyperlink**: A relationship between two anchors, as described in [\[RFC1866\]](https://go.microsoft.com/fwlink/?LinkId=90296). +> +> **Hypertext Markup Language (HTML)**: An application of the Standard Generalized Markup Language (SGML) that uses tags to mark elements in a document, as described in [\[HTML\]](https://go.microsoft.com/fwlink/?LinkId=89880). +> +> **icon**: A graphical image used to supplement alphanumeric text in the visual identification of an object on a computer monitor. [**Icons**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) are typically small, relative to the size of the area on which they are displayed. +> +> **icon set**: A collection of icons that can be used to comment and classify data into categories. +> +> **indentation level**: A measure of the distance between the position of content that is in a cell and the logical left side of the cell. An indentation level is equal to three spaces. +> +> **Information Rights Management (IRM)**: A technology that provides persistent protection to digital data by using encryption, certificates, and authentication. Authorized recipients or users acquire a license to gain access to the protected files according to the rights or business rules that are set by the content owner. +> +> **ink**: A process of entering text in handwritten form. Instead of converting handwritten text to typed text, ink is converted to an object and displayed exactly as it was written. +> +> **inner rectangle**: In a cell that is formatted with a rectangular gradient, a rectangle that is formed by the leftmost, rightmost, topmost, and bottommost lines of pixels in which the initial color of the gradient is completely dissipated. See also [**rectangular gradient**](#gt_bc10f1e2-8a79-4d73-92ff-f4648d3f0ada). +> +> **input cell**: A cell in which each input value from a data table is substituted. +> +> **input language**: A pairing of input language and input method. The pairing determines what language is currently being entered and how. The input language is usually determined by the keyboard language that is currently active in the operating system. Users can install keyboard layouts and Input Method Editors (IMEs) for several languages, and then switch between them at appropriate times to indicate the input language. +> +> **Input Method Editor (IME)**: An application that is used to enter characters in written Asian languages by using a standard 101-key keyboard. An IME consists of both an engine that converts keystrokes into phonetic and ideographic characters and a dictionary of commonly used ideographic words. +> +> **insert row**: A placeholder row at the bottom of a table. It is used to enter new records. +> +> **international macro sheet**: A macro sheet that displays English function names and operates with U.S. English locale settings, regardless of product locale, user locale, or system locale. +> +> **iterative calculation**: A [**calculation mode**](#gt_f02f81e1-8eda-4ec3-88e9-c2c483ff47ee) in which calculations are performed until a specific numeric condition is met or a maximum number of iterations is reached. +> +> **justify distributed**: A special, distributed-alignment setting that evenly distributes the last line of text in a cell. The setting is primarily used for East Asian languages. See also [**distributed alignment**](#gt_dae18ea5-2a98-4e10-9570-7f4ac695c6b8). +> +> **key performance indicator (KPI)**: A predefined measure that is used to track performance against a strategic goal, objective, plan, initiative, or business process. A visual cue is frequently used to communicate performance against the measure. +> +> **language code identifier (LCID)**: A 32-bit number that identifies the user interface human language dialect or variation that is supported by an application or a client computer. +> +> **leader line**: A line that connects a data label to its corresponding data point. The primary purpose of a leader line is to increase legibility. +> +> **left-to-right**: A reading order in which characters in words are read from left to right, and words are read from left to right in sentences. +> +> **legend entry**: An item in a chart legend that identifies a single series or [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1). +> +> **legend key**: A symbol that is associated with a legend entry. +> +> **library directory**: A directory in which Microsoft Excel [**add-ins**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6) are installed. +> +> **license key**: An array of bytes that enables access to a control according to the usage policies for that control. +> +> **line style**: A style, including width and dash type, that is applied to and alters the appearance of a line or [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c). +> +> **linear gradient**: A type of gradient fill in which the color of a cell or other object gradually changes horizontally, vertically, or diagonally from one edge of the object to the other. +> +> **linked object**: An object that is inserted into a document and continues to exist in a separate source file. If the object in the source file changes, the object in the document is updated automatically to reflect those changes. +> +> **list**: A container within a SharePoint site that stores list items. A list has a customizable schema that is composed of one or more fields. +> +> **list view**: A named collection of settings for querying and displaying items in a SharePoint list. There are two types of views: Personal, which can be used only by the user who created the view; and Public, which can be used by all users who have permission to access to the site. +> +> **little-endian**: Multiple-byte values that are byte-ordered with the least significant byte stored in the memory location with the lowest address. +> +> **local name**: A defined name whose scope is limited to a specific sheet instead of the entire workbook. +> +> **locale**: A collection of rules and data that are specific to a language and a geographical area. A locale can include information about sorting rules, date and time formatting, numeric and monetary conventions, and character classification. +> +> **localization**: The process of adapting an application or documentation, including text and non-text elements, to meet the language, cultural, and political expectations and requirements of a specific geographic country or region. +> +> **locked**: The condition of a cell, worksheet, or other object that restricts edits or modifications to it by users. +> +> **locked protection**: A cell-protection property that restricts the editing of cell content when a worksheet is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829). +> +> **logical left**: A position that is relative to the language orientation of a document. Logical left means left, except in a right-to-left language where it means right. Also referred to as leading edge. +> +> **logical right**: A position that is relative to the language orientation of a document. Logical right means right, except in a right-to-left language where it means left. Also referred to as trailing edge. +> +> **logical top-left**: A position that is relative to the language orientation of a document. Logical top-left is the upper-left corner of a range or object when in left-to-right mode. It is the upper-right corner when in right-to-left mode. +> +> **logical top-right**: A position that is relative to the language orientation of a document. Logical top-right is the upper-right corner of a range or object when in left-to-right mode. It is the upper-left corner when in right-to-left mode. +> +> **long file name**: A folder or file name that is longer than the 8.3 file name standard, which permits as many as eight characters followed by a period and a file name extension of three characters. +> +> **macro**: A set of instructions that are recorded or written, and then typically saved to a file. When a macro is run, all of the instructions are performed automatically. +> +> **macro sheet**: A single, logical container that is used to store and run Excel 4.0 macro formulas. +> +> **major gridline**: A horizontal or vertical line that is in the plot area of a chart and corresponds to the major scaling unit on an axis. +> +> **major scheme**: A font scheme that is used for primary text elements, such as headings and titles, in a [**theme**](#gt_8b5eb4c0-949b-47d9-8b63-b9bda81d61b8). +> +> **major tick mark**: A tick mark that corresponds to a major scaling unit on an axis. +> +> **Mandarin phonetic symbols**: A phonetic system for transcribing Chinese through the use of an alphabet that includes characters for all possible sounds in the spoken Mandarin language. +> +> **manifest**: A file that stores metadata about an expansion pack, such as the name of the expansion pack, the files and resources that are included in the expansion pack, and the dependencies that it has on other files and components. +> +> **MD5**: A one-way, 128-bit hashing scheme that was developed by RSA Data Security, Inc., as described in [\[RFC1321\]](https://go.microsoft.com/fwlink/?LinkId=90275). +> +> **MDX unique name**: A unique identifier for a multidimensional expression (MDX) member or value in a given Online Analytical Processing (OLAP) cube, for example "\[Customer\].\[Customer Geography\].\[Country\].&\[Australia\]". +> +> **measure**: In a cube, a set of values that are typically numeric and are based on a column in the fact table of the cube. Measures are the central values that are aggregated and analyzed. +> +> **measure group**: A collection of related [**measures**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) in a [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7) that derive from a single fact table, typically in a data source view. +> +> **member**: (1) An identity that belongs to a shared space. +> +> \(2\) See [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32). +> +> **member property**: An attribute on a data item within a specific dimension in an Online Analytical Processing (OLAP) database. +> +> **merge conflict**: A problem that occurs if two users are editing the same cell or other type of object in a workbook while changes are being merged in a shared workbook. +> +> **merged cell**: A single cell that is created by combining two or more adjacent cells. +> +> **messaging system service provider**: A business that supplies email and other messaging services to individuals, businesses, and other organizations. +> +> **metafile**: A file that stores an image as graphical objects, such as lines, circles, and polygons, instead of pixels. A metafile preserves an image more accurately than pixels when an image is resized. +> +> **Microsoft Office Web Components**: A set of controls that can be used to create data analysis and reporting solutions. +> +> **minimal save**: A process that saves only critical workbook data to disk when errors are detected during a file save operation. +> +> **minor gridline**: A horizontal or vertical line that is in the plot area of a chart and corresponds to the minor scaling unit on an axis. +> +> **minor scheme**: A font scheme that is used for secondary text elements, such as body text, in a [**theme**](#gt_8b5eb4c0-949b-47d9-8b63-b9bda81d61b8). +> +> **minor tick mark**: A tick mark that corresponds to a minor scaling unit on an axis. +> +> **module**: A collection of routines and data structures that performs a specific task or implements a specific abstract data type. Modules usually consist of two parts, a module header and a module body. A module header is a set of name/value attribute pairs that specify the linguistic characteristics of the module. A module body is the VBA source code, a set of declarations followed by procedures. VBA supports two types of modules, procedural modules and class modules. +> +> **moving average**: A type of trendline that is calculated based on the most recent period of data points in a series. +> +> **Multidimensional Expressions (MDX)**: A syntax that is used for defining multidimensional objects, and for querying and manipulating multidimensional data. +> +> **named range**: See [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). +> +> **narrow katakana**: A non-cursive [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204) that is used to write non-Japanese words phonetically in Japanese. Narrow katakana characters are represented with a single byte. Also referred to as half-width katakana. +> +> **natural language formula**: A syntax for referring to tabular data in formulas by using column and row labels instead of cell references. +> +> **natural language label**: A value of a cell or cells that identifies a range in a natural language formula. A label is typically the same as a column or row header in tabular data. +> +> **ninched**: A condition in which a group of selected cells or objects do not share a specific property. For example, if a selection has three cells and only two of the cells share the same color formatting, the color formatting of the selection is in a ninched state. +> +> **non-contiguous range**: A selected [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that includes non-adjacent cells. +> +> **Normal view**: A document view that displays text formatting and a simplified page layout of a document. The Normal view hides some layout elements such as the header and footer. Referred to as Draft view in Microsoft Office Word 2007 and Microsoft Word 2010. +> +> **number format**: A property of a cell or other type of object that determines how numerical data is displayed or interpreted. For example, a currency number format affixes the proper currency symbol to the number. +> +> **obfuscation key**: A secret shared key combined with a cryptographic hash function that is intended to prevent a reversal of an encoding process. See also [**XOR obfuscation**](#gt_cbfd1a35-e8c9-4c5a-bc26-e618633d2f50). +> +> **Object Linking and Embedding (OLE)**: A technology for transferring and sharing information between applications by inserting a file or part of a file into a compound document. The inserted file can be either embedded or linked. See also [**embedded object**](#gt_708607be-8655-416e-93f3-b434e9ecbd56) and [**linked object**](#gt_cfc45e76-9219-4c47-9ef2-5832a172f795). +> +> **object model**: A collection of object-oriented APIs that represent data structures and are designed to promote software interoperability. +> +> **OCXDropDown control**: A type of DropDown control that displays a list of the ActiveX controls that are available within that application. +> +> **Office data connection (ODC) file**: A file that stores information about a connection to a data source, such as an Access database, worksheet, or text file. This file facilitates data source administration. +> +> **OLAP calculated member**: An [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) whose value is calculated at run time. +> +> **OLAP cube**: A data structure that aggregates [**Online Analytical Processing (OLAP)**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) measures by [**OLAP levels**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) and [**OLAP hierarchies**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c). An OLAP cube combines several OLAP hierarchies, such as time, geography, and product lines, with OLAP measures, such as sales or inventory figures. +> +> **OLAP hierarchy**: An [**attribute hierarchy**](#gt_8f75d668-e8c6-4f42-ba44-d90604d3b9dc) or a user-defined hierarchy in a data structure. By default, each dimension attribute has an attribute hierarchy. A user-defined hierarchy is a set of related attribute hierarchies that is used to facilitate browsing an [**OLAP cube**](#gt_11427e13-37ed-49dd-8f0d-5f2b21f7aa4c). +> +> **OLAP KPI**: See [**key performance indicator (KPI)**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8). +> +> **OLAP level**: Within an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c), a set of data that is organized into a lower or higher level of detail, such as Year, Quarter, Month, and Day levels in a Time hierarchy. +> +> **OLAP measure**: A set of numeric values in an [**OLAP cube**](#gt_11427e13-37ed-49dd-8f0d-5f2b21f7aa4c) that is used in aggregation and analysis. +> +> **OLAP measure group**: A collection of related [**OLAP measures**](#gt_7431c051-4564-4476-ad00-39c66f169118) in an [**OLAP cube**](#gt_11427e13-37ed-49dd-8f0d-5f2b21f7aa4c). An OLAP cube can contain multiple measure groups. +> +> **OLAP member**: An item that is in an [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168). For example, a Canada member in a Country level of a Geography hierarchy. +> +> **OLAP member property**: A relationship between two [**OLAP hierarchies**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c), such as a Population member property of a Country member. +> +> **OLAP named set**: A collection of [**OLAP tuples**](#gt_3a1a687f-d28b-485b-96a0-ba0b7eb4119e) that have the same dimensionality. Also referred to as OLAP set. +> +> **OLAP set**: A collection of [**OLAP tuples**](#gt_3a1a687f-d28b-485b-96a0-ba0b7eb4119e) with the same dimensionality. Also referred to as OLAP named set. +> +> **OLAP tuple**: An ordered collection of members that are from different dimensions of an [**OLAP cube**](#gt_11427e13-37ed-49dd-8f0d-5f2b21f7aa4c). A single member is a special case of a tuple. +> +> **OLE compound file**: A form of structured storage, as described in [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b). A compound file allows independent storages and streams to exist within a single file. +> +> **OLE DB**: A set of interfaces that are based on the Component Object Model (COM) programming model and expose data from a variety of sources. These interfaces support the amount of Database Management System (DBMS) functionality that is appropriate for a data store and they enable a data store to share data. +> +> **OLE link**: A connection between an [**Object Linking and Embedding (OLE)**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) object and its OLE server. See also [**DDE link**](#gt_0aa0fad9-afc1-4433-b772-2dc11e641721). +> +> **OLE object**: An object that supports the [**Object Linking and Embedding (OLE)**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) protocol. +> +> **OLE server**: An application or DLL that supplies a linked or embedded OLE object to another application. +> +> **OLE2**: See [**Object Linking and Embedding (OLE)**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c). +> +> **one-variable data table**: A data table that consists of only one input cell, which is either a row input cell or a column input cell. +> +> **Online Analytical Processing (OLAP)**: A technology that uses multidimensional structures to provide access to data for analysis. The source data for OLAP is stored in data warehouses in a relational database. See also [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7). +> +> **Open Database Connectivity (ODBC)**: A standard software API method for accessing data that is stored in a variety of proprietary personal computer, minicomputer, and mainframe databases. It is an implementation of [\[ISO/IEC9075-3:2008\]](https://go.microsoft.com/fwlink/?LinkId=223900) and provides extensions to that standard. +> +> **outline**: A nested grouping of rows or columns that are in a worksheet. +> +> **outline effect**: A formatting effect in which a line is placed around the edge of a shape or around each character in a text string. +> +> **outline level**: The number of levels that a task is indented from the top level of an outline; the order associated with an outline. +> +> **outline state**: A setting that specifies whether an outline is currently outline expanded or outline collapsed. +> +> **out-of-memory**: A state of a computer or application when it halts because all of the available volatile memory has been allocated and none is currently available for reallocation. +> +> **page break**: A divider that breaks a worksheet into separate pages for printing. Page breaks are inserted automatically based on the paper size, margin settings, scaling options, and the positions of any page breaks that are inserted manually. +> +> **Page Break Preview view**: A worksheet view that displays the areas to be printed and the locations of page breaks. +> +> **Page Layout view**: A sheet view that displays a sheet as it would appear on a printed page, including margins, header and footer elements, and pagination. +> +> **palette color**: A specific color among those that are available on the active color palette. +> +> **pane**: A portion of a software window that has a distinct function and is bounded by and separated from other portions of the window by vertical or horizontal bars. +> +> **Pane control**: A type of toolbar control that hosts a window within itself. The hosted window is not constrained by the layout and control type options of a basic toolbar or a menu toolbar. +> +> **parameterized query**: A query that contains parameters. It applies to Open Database Connectivity (ODBC) and web queries. For example, a web query that retrieves stock quotes from a webpage can prompt users for a parameter, such as a stock symbol. +> +> **phonetic guide**: A set of supplemental phonetic symbols that appears above text in Japanese and other East Asian languages. A phonetic guide is displayed automatically and can be edited by the user. +> +> **phonetic information**: A series of characters that appear above text in a cell and provide information that helps users pronounce the text. +> +> **phonetic string**: A series of characters that appear above a string and provide information that helps users pronounce the string. Phonetic strings are typically used in East Asian languages. +> +> **phonetic text run**: A series of characters that are within a [**phonetic string**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77). +> +> **PivotChart filter pane**: A user interface element that displays a list of active fields in a PivotChart view and is used to apply filters to those fields. +> +> **PivotTable field list**: A user interface element that displays a list of all of the fields in a PivotTable report. It can be used to populate a PivotTable report and to manipulate the fields. +> +> **pixel**: A discrete unit of display on a computer display device. +> +> **placeholder**: A character or symbol that is used in place of an actual value, text, or object. The actual value that the placeholder represents is unknown or unavailable at the current time, or is not displayed for security reasons. +> +> **plot area**: A portion of a chart area that contains the plotted data and axes. +> +> **point**: A unit of measurement for fonts and spacing. A point is equal to 1/72 of an inch. +> +> **Popup control**: A built-in or custom control on a menu bar or toolbar that displays a menu of related commands when clicked. +> +> **post method**: A method of submitting form data in the header of an HTTP request. +> +> **precision as displayed**: A calculation setting that permanently changes stored values in cells from full precision (15 digits) to the currently displayed format, including the number of decimal places. +> +> **primary pie**: The main chart in a bar of pie or pie of pie chart. A primary pie chart has one pie slice (data point) that is a grouping of data points. +> +> **print area**: A collection of one or more ranges of cells that are designated to be printed. If a worksheet includes a print area, only the content inside the print area is printed. +> +> **print settings**: The settings that specify how a file is printed in a specific print job, such as duplex or landscape orientation. Printer settings are settings that can differ from printer to printer but apply to every print job of a given printer. Print settings are values that typically vary between print jobs. +> +> **print titles**: The rows or columns that appear on each page when a page is printed. Print titles are typically used to print column headers above tabular data that spans several printed pages. +> +> **ProgID**: An identifier that is used by the Windows registry to uniquely identify an object and is in the form OLEServerName.ObjectName, for example, "Excel.Sheet" or "PowerPoint.Slide." +> +> **property stream**: A series of object properties that is used in processes such as checksum calculations. +> +> **protected**: A property that is applied manually to a file or a portion of a file, with or without a password, and that helps prevent users from accidentally or deliberately changing, moving, or deleting data. +> +> **protection**: A mechanism that helps restrict users from making unwanted changes to the data or structure of a workbook. +> +> **published**: A condition of portions of a workbook that are marked as being available to the user when that workbook is processed by a protocol server. +> +> **published item**: A specific named object that is in a published workbook. +> +> **query**: A formalized instruction to a data source to either extract data or perform a specified action. A query can be in the form of a query expression, a method-based query, or a combination of the two. The data source can be in different forms, such as a relational database, XML document, or in-memory object. See also search query. +> +> **query table**: A two-dimensional table that presents data from an external data source. +> +> **R1C1**: A [**reference style**](#gt_71d7e4ad-d6b6-49d9-b247-e2ebba1469e9) in which each row and each column has a numeric heading that is numbered sequentially from top to bottom and left to right, respectively. "R" stands for row and "C" stands for column. +> +> **range**: An addressable region that is in a workbook. A range typically consists of zero or more cells and represents a single, contiguous rectangle of cells on a single sheet. +> +> **reading order**: The positioning of characters in words and the positioning of words in sentences. This can be left-to-right or right-to-left. +> +> **read-only recommended**: A file sharing property that displays an alert when a file is being opened. The text of the alert recommends that the user open the file with read-only permission. +> +> **real-time data (RTD)**: Data that is pushed into a worksheet from an [**RTD server**](#gt_d4fc2cb5-c030-4ce4-9078-69627d562fc7) and is updated continually. Real-time data is frequently used to track stock prices or inventory levels in real time. +> +> **recalculate**: The process of computing a value in a workbook by initiating a calculation repeatedly. +> +> **reconnect condition**: A condition that specifies whether to connect to a database again after a connection expires. +> +> **rectangular gradient**: A type of gradient fill in which the color of a cell or other object gradually changes with each successive inner rectangle of pixels. +> +> **red-green-blue-alpha (RGBA)**: A color model that describes color information in terms of the red (R), green (G), blue (B), and alpha (A) intensities that comprise a color. +> +> **reference style**: A system that is used in formulas to specify cells or ranges of cells. A reference style specifies a cell in a two-dimensional table by identifying the row and column that contain that cell or range of cells. +> +> **refresh**: A process that retrieves values from a data source and populates a workbook with those values. +> +> **regional settings**: See locale settings. +> +> **relative reference**: A reference to a location on a sheet that is relative to the cell that contains the reference. A relative reference can be stored as a cell reference or as an offset. +> +> **relative security descriptor**: A security descriptor that contains all associated security information in a contiguous block of memory. +> +> **result cell**: A cell that contains the results of the calculation of changing cells in a scenario. +> +> **revision**: A change in a document, file, or other object. +> +> **revision history**: A list of data that describes document updates, such as when and by whom a document was modified. +> +> **revision record**: Any of the records in the revision stream of a [**shared workbook**](#gt_241c4cae-c49a-438a-87dc-c8fb2c871921) that stores user edits to the workbook and other tracked information. +> +> **right-to-left**: A reading and display order that is optimized for right-to-left languages. +> +> **routing slip**: Information that specifies how a document is to be distributed from a document originator and processed by one or more recipients. It also specifies subject and message body text that is associated with the document routing process and routing status or workflow information. +> +> **routing stage**: The current status of a document with a routing slip. +> +> **row outline**: A mechanism for grouping and nesting the rows in a worksheet. +> +> **RTD server**: A Component Object Model (COM) Automation server that is used by the real-time data (RTD) function to retrieve data in real time. The RTD server can exist as an ActiveX DLL or as an executable (.exe) file that runs on the same local computer or on a remote server. +> +> **RTD topic**: A discrete combination of parameters that is used to request data from a real-time data (RTD) server. +> +> **ruler**: A user interface element that enables users to adjust page margins and to measure and align objects in a document. +> +> **safe load**: A process of loading a file in which additional error checking is performed and various corruption patterns in the file are detected and repaired. +> +> **scenario**: A named set of input values (changing cells) that can be substituted in a worksheet model. +> +> **Scenario Manager**: A process for creating and managing different sets of input values for calculation models in a worksheet. +> +> **secondary bar/pie**: A secondary chart in a bar of pie or pie of pie chart that displays the detailed data of the grouped data point in the primary pie chart. The secondary bar/pie chart takes the form of a stacked bar chart or a pie chart that is connected to the primary pie chart with series lines. +> +> **security descriptor**: A data structure containing the security information associated with a securable object. A [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) identifies an object's owner by its security identifier (SID). If access control is configured for the object, its [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) contains a discretionary access control list (DACL) with SIDs for the security principals who are allowed or denied access. Applications use this structure to set and query an object's security status. The [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) is used to guard access to an object as well as to control which type of auditing takes place when the object is accessed. The [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) format is specified in [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) section 2.4.6; a string representation of [**security descriptors**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350), called SDDL, is specified in \[MS-DTYP\] section 2.5.1. +> +> **selected**: The condition of a set of items that has focus in a workbook. +> +> **selection**: An item or set of items, such as cells, shapes, objects, and chart elements, that has focus in a document. +> +> **series line**: A supplemental line on a stacked column, stacked bar, pie of pie, or bar of pie chart that connects each data point in a series with the next data point to increase legibility. +> +> **server name**: The name of a server, as specified in the operating system settings for that server. +> +> **shade**: A color that is mixed with black. A 10-percent shade is one part of the original color and nine parts black. +> +> **shadow effect**: A formatting effect that makes a font or object appear to be elevated from the page or screen surface, and therefore casts a shadow. +> +> **shape**: A collection of qualifiers, such as names, and quantifiers, such as coordinates, that is used to represent a geometric object. A shape can be contained in a document, file structure, run-time structure, or other medium. +> +> **shared workbook**: A workbook that is configured to enable multiple users on a network to view and make changes to it at the same time. Each user who saves the workbook sees the changes that are made by other users. +> +> **sheet**: (1) A part of an Excel workbook. There are four types of sheets: [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615), [**macro sheet**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491), [**dialog sheet**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8), and [**chart sheet**](#gt_da561b7b-c629-4cd8-bfaa-6e62471d9e83). Multiple sheets are stored together within a workbook. +> +> \(2\) A worksheet. The term sheet frequently refers to a worksheet because worksheets are the most common type of sheet. +> +> **sheet stream**: See [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) and document stream. +> +> **sheet tab**: A control that is used to select a sheet. +> +> **sheet view**: A collection of display settings, such as which cells are shown, and the zoom level for a sheet window. +> +> **shrink to fit**: The process of adjusting the font size of text in a cell to fit the current height and width of the cell. +> +> **single accounting**: An underline style that places one line beneath the text. Single accounting can be used to indicate subtotals. +> +> **single sign-on (SSO) identifier**: A string that represents the definition of user credentials that permit a user to access a network. See also single sign-on (SSO). +> +> **smart document**: A file that is programmed to assist the user as the user creates or updates the document. Several types of files, such as forms and templates, can also function as smart documents. +> +> **smart tag**: A feature that adds the ability to recognize and label specific data types, such as people's names, within a document and displays an action button that enables users to perform common tasks for that data type. +> +> **smart tag actions button**: A user interface control that displays a menu of actions that are associated with a specific smart tag. +> +> **smart tag indicator**: A triangular symbol that appears in the bottom right corner of a cell and indicates that the cell contains a smart tag. +> +> **sort**: A process that arranges cells in ascending or descending order, based on cell content. +> +> **sort condition**: A condition that determines how to sort cells in a range. +> +> **sort order**: A specific arrangement of cells that is based on cell content. The order can be ascending or descending. +> +> **sort range**: A range of cells that will be or has been sorted. +> +> **source data**: The data that is used as the basis for charts, PivotTable reports, and other data visualization features. +> +> **split pane**: A pane that consists of two or more discrete areas of a window. Each area displays content and scrolls independently from other areas of the window. See also [**frozen panes**](#gt_28507dfc-4443-4a02-a18c-27b5db006946). +> +> **SplitButtonMRUPopup control**: A type of [**SplitButtonPopup control**](#gt_1c046ab6-2530-4a41-8d19-03f92914beaf) whose icon changes to reflect the command that the user most recently selected from the menu that is displayed by that button. +> +> **SplitButtonPopup control**: A type of Button control that performs an action when clicked, and can also display a menu of related commands when the user clicks a drop-down arrow that appears on the button. +> +> **SplitDropDown control**: A type of Button control that performs a default action when clicked, and can also expand to display a list of other possible actions when the user clicks a drop-down arrow that appears on the button. +> +> **startup directory**: The directory from which an application opens data files when the application starts. +> +> **storage**: An element of a compound file that is a unit of containment for one or more storages and streams, analogous to directories in a file system, as described in \[MS-CFB\]. +> +> **stream**: An element of a compound file, as described in \[MS-CFB\]. A stream contains a sequence of bytes that can be read from or written to by an application, and they can exist only in storages. +> +> **strikethrough formatting**: A formatting option in which characters are crossed out by horizontal line. +> +> **stripe band**: One or more adjacent columns or rows that are in a table and have the same stripe formatting. +> +> **stroke order**: A sort order that arranges items in a sort range according to the number of strokes that is used to write each glyph. Stroke order is used when sorting text that is written in some East Asian languages. +> +> **Structured Query Language (SQL)**: A database query and programming language that is widely used for accessing, querying, updating, and managing data in relational database systems. +> +> **style**: A set of formatting options that is applied to text, tables, charts, and other objects in a document. +> +> **subtotal column**: A column that uses a summary or subtotal function to display the total of detail items in a PivotTable field. +> +> **table**: A list that is defined in a workbook. +> +> **template**: A file that contains pre-defined formatting including layout, text and graphics. It serves as the basis for new documents that have a similar look or purpose. See also form template (Microsoft InfoPath) and site template (SharePoint Products and Technologies). +> +> **text importation**: A process that incorporates textual data into a workbook, either by opening a text file or through an external link. +> +> **text query**: A query that is used to import data from text files. +> +> **text run**: A string of characters that represents a discrete span of text with the same formatting properties. +> +> **text style**: A formatting option, such as bold or italic, that can be applied to a font. +> +> **theme**: A set of unified design elements, such as colors, fonts, graphics, and styles, that define the appearance of a website, document, or data visualization. +> +> **time hierarchy**: A specialized Online Analytical Processing (OLAP) hierarchy that can be organized into lower and higher levels of detail, such as Year, Quarter, Month, and Day. +> +> **toolbar control**: An object that appears on a toolbar and enables user interaction or input, typically to initiate an action, display information, or set values. +> +> **toolbar view**: A visual state of a toolbar that depends on the current state of the application. Valid toolbar views are docked, floating, and not visible. +> +> **tooltip**: A window displaying text that is created when the mouse is moved over a window or notification icon. +> +> **top N filter**: A filter that matches the top or bottom N items or N% of items in a specified column. +> +> **total row**: A row in a list or table that provides a selection of aggregate functions that are useful for working with numerical data. +> +> **transfer protocol**: A protocol that governs the transfer of files, Internet messages, and webpages between networked computers. On the Open Systems Interconnection (OSI) Basic Reference Model, these are application layer protocols. Examples of transfer protocols are Hypertext Transfer Protocol (HTTP), Simple Mail Transfer Protocol (SMTP), and File Transfer Protocol (FTP). +> +> **transition formula entry**: A worksheet option that enables users to enter formulas that use IBM Lotus 1-2-3 syntax. +> +> **transition formula evaluation**: A setting that enables formulas in a worksheet to be calculated in a manner that is consistent with IBM Lotus 1-2-3. +> +> **trendline**: A line that is added to a chart to show the trend of multiple data points in a series. A trendline is used to facilitate regression analysis. +> +> **tuple**: An ordered grouping of members from different dimensions or hierarchies. A single member is a special case of a tuple and can be used as an expression. Every hierarchy does not have to be represented in a tuple. +> +> **twip**: A unit of measurement that is used in typesetting and desktop publishing. It equals one-twentieth of a printer's point, or 1/1440 of an inch. +> +> **two-variable data table**: A data table that consists of two input cells, a row input cell and a column input cell. +> +> **type library**: A binary file that describes the methods, properties, and data structure of a component. +> +> **UNC volume**: A storage device that is accessible by network protocols and addressed in the standard Universal Naming Convention format, for example, "\\Server Name\Share Name". +> +> **unfrozen pane**: A portion of a worksheet that continues to scroll and function normally in split pane view. See also [**frozen pane**](#gt_28507dfc-4443-4a02-a18c-27b5db006946). +> +> **Unicode**: A character encoding standard developed by the Unicode Consortium that represents almost all of the written languages of the world. The [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) standard [\[UNICODE5.0.0/2007\]](https://go.microsoft.com/fwlink/?LinkId=154659) provides three forms (UTF-8, UTF-16, and UTF-32) and seven schemes (UTF-8, UTF-16, UTF-16 BE, UTF-16 LE, UTF-32, UTF-32 LE, and UTF-32 BE). +> +> **Uniform Resource Identifier (URI)**: A string that identifies a resource. The URI is an addressing mechanism defined in Internet Engineering Task Force (IETF) Uniform Resource Identifier (URI): Generic Syntax [\[RFC3986\]](https://go.microsoft.com/fwlink/?LinkId=90453). +> +> **Uniform Resource Locator (URL)**: A string of characters in a standardized format that identifies a document or resource on the World Wide Web. The format is as specified in [\[RFC1738\]](https://go.microsoft.com/fwlink/?LinkId=90287). +> +> **up bar**: See [**up-down bar**](#gt_54f291c2-81aa-41b6-8831-88d180a09ea0). +> +> **up-down bar**: A vertical bar that highlights the difference between data points in a line chart that contains more than one data series. +> +> **user name**: A unique name that identifies a specific user account. The user name of an account is unique among the other group names and user names within its own domain or workgroup. +> +> **user-defined function (UDF)**: A function that is coded in a VBA module, macro sheet, [**add-in**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6), or [**Excel Linked Library (XLL)**](#gt_3d6e3f45-91e7-46d5-871c-0b2fde20b5f5). A UDF can be used in formulas to return values to a worksheet, similar to built-in functions. +> +> **VBA project**: A collection of the modules, class modules, and user forms that are needed to create an application. Modules, class modules, and user forms can be imported into and exported from a project. +> +> **Vector Markup Language (VML)**: A system of marking up or tagging two-dimensional vector graphics for publication on the World Wide Web. VML graphics are scalable and editable, and typically require less disk space and less time to download. +> +> **vertical alignment**: A formatting setting that specifies how content is positioned within the vertical space of a cell, object, or page. Content can be aligned along the top or bottom edge, or distributed evenly across the vertical space. +> +> **visible**: A condition of an object that allows it to be displayed in rendered output. +> +> **Visual Basic for Applications (VBA)**: A macro-based programming language that derives from Microsoft Visual Basic and can be used to customize and extend an application. Unlike Visual Basic, VBA code and macros can be run only from within a host application that supports VBA. +> +> **volatile**: A condition of a formula in which the formula is calculated every time the workbook is calculated. This is unlike a non-volatile formula, which is calculated only when dependent values are changed. +> +> **wall**: An extension of the background of a 3-D chart to create a three-dimensional effect. See also [**floor**](#gt_dc38c098-e0d3-4701-9656-5f2cf4d80f29). +> +> **watched cell**: A cell whose value is monitored in a separate window while formulas that are associated with the cell are calculated. +> +> **web query**: An external data connection that retrieves a table from a website and inserts table data into a workbook. +> +> **web-only view**: A view of a workbook from within a web browser. +> +> **wide katakana**: A non-cursive [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204) that is used to write non-Japanese words phonetically in Japanese. Wide katakana characters are represented with two bytes. +> +> **window state**: The current positioning state of a window. Windows can be maximized or minimized, or the window size can be customized by the user. +> +> **workbook**: A container for a collection of [**sheets (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). +> +> **workbook parameter**: A single cell that is designated to receive input from users. +> +> **worksheet**: A single logical container for a set of tabular data and other objects in a workbook. +> +> **write reservation**: A field or condition that is set on a document, workbook, or presentation to help prevent users from modifying it. +> +> **XML**: The Extensible Markup Language, as described in [\[XML1.0\]](https://go.microsoft.com/fwlink/?LinkId=90599). +> +> **XML map**: A feature that is used to import data from databases and applications and to map XML elements and attributes from the associated [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) to cells in a worksheet. The revised [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) data can then be exported for interaction with other databases and applications. +> +> **XML namespace**: A collection of names that is used to identify elements, types, and attributes in XML documents identified in a URI reference \[RFC3986\]. A combination of XML namespace and local name allows XML documents to use elements, types, and attributes that have the same names but come from different sources. For more information, see [\[XMLNS-2ED\]](https://go.microsoft.com/fwlink/?LinkId=90602). +> +> **XML node**: The smallest unit of a valid, complete structure in an XML document. For example, a node can represent an element, an attribute, or a text string. +> +> **XML Path Language (XPath)**: A language used to create expressions that can address parts of an XML document, manipulate strings, numbers, and Booleans, and can match a set of nodes in the document, as specified in \[XPATH\]. XPath models an XML document as a tree of nodes of different types, including element, attribute, and text. XPath expressions can identify the nodes in an XML document based on their type, name, and values, as well as the relationship of a node to other nodes in the document. +> +> **XML schema**: A description of a type of XML document that is typically expressed in terms of constraints on the structure and content of documents of that type, in addition to the basic syntax constraints that are imposed by [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) itself. An XML schema provides a view of a document type at a relatively high level of abstraction. +> +> **XML schema definition (XSD)**: The World Wide Web Consortium (W3C) standard language that is used in defining XML schemas. Schemas are useful for enforcing structure and constraining the types of data that can be used validly within other XML documents. XML schema definition refers to the fully specified and currently recommended standard for use in authoring [**XML schemas**](#gt_bd0ce6f9-c350-4900-827e-951265294067). +> +> **XOR obfuscation**: A type of file encryption that helps protect private data by using an exclusive or bitwise operation. This is done by adding a mathematical expression that prevents a simple reverse-engineering process. +> +> **XPath expression**: An expression that searches an71 XML document and can extract and manipulate data in elements or attributes within that document. +> +> **zoom level**: The degree to which a portion of an image, document, or other screen object is made to appear closer or farther away relative to its default appearance. This value is usually expressed as a percentage of the default appearance. +> +> **z-order**: The rendering order of an object on a z axis. +> +> **MAY, SHOULD, MUST, SHOULD NOT, MUST NOT:** These terms (in all caps) are used as defined in [\[RFC2119\]](https://go.microsoft.com/fwlink/?LinkId=90317). All statements of optional behavior use either MAY, SHOULD, or SHOULD NOT. + +## References + +Links to a document in the Microsoft Open Specifications library point to the correct section in the most recently published version of the referenced document. However, because individual documents in the library are not updated at the same time, the section numbers in the documents may not match. You can confirm the correct section numbering by checking the [Errata](https://go.microsoft.com/fwlink/?linkid=850906). + +### Normative References + +We conduct frequent surveys of the normative references to assure their continued availability. If you have any issue with finding a normative reference, please contact . We will assist you in finding the relevant information. + +\[CODEPG\] Microsoft Corporation, "Code Pages", [https://learn.microsoft.com/en-us/globalization/encoding/code-pages](https://go.microsoft.com/fwlink/?LinkId=89840) + +\[DEVMODE\] Microsoft Corporation, "DEVMODE structure", [http://msdn.microsoft.com/en-us/library/dd183565(VS.85).aspx](https://go.microsoft.com/fwlink/?LinkId=89844) + +\[ECMA-376\] ECMA International, "Office Open XML File Formats", [https://www.ecma-international.org/publications-and-standards/standards/ecma-376/](https://go.microsoft.com/fwlink/?LinkId=200054) + +\[IEEE754\] IEEE, "IEEE Standard for Binary Floating-Point Arithmetic", IEEE 754-1985, October 1985, [http://ieeexplore.ieee.org/servlet/opac?punumber=2355](https://go.microsoft.com/fwlink/?LinkId=89903) + +\[MS-CFB\] Microsoft Corporation, "[Compound File Binary File Format](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b)". + +\[MS-CTXLS\] Microsoft Corporation, "[Excel Custom Toolbar Binary File Format](%5bMS-CTXLS%5d.pdf#Section_b461dcd9933e471081bcdc1c74801b6b)". + +\[MS-DTYP\] Microsoft Corporation, "[Windows Data Types](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2)". + +\[MS-LISTSWS\] Microsoft Corporation, "[Lists Web Service Protocol](%5bMS-LISTSWS%5d.pdf#Section_30b364cc38374e839ce81963292e2ee5)". + +\[MS-OAUT\] Microsoft Corporation, "[OLE Automation Protocol](%5bMS-OAUT%5d.pdf#Section_bbb05720f72445c78d17f83c3d1a3961)". + +\[MS-ODRAW\] Microsoft Corporation, "[Office Drawing Binary File Format](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872)". + +\[MS-OFFCRYPTO\] Microsoft Corporation, "[Office Document Cryptography Structure](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083)". + +\[MS-OLEDS\] Microsoft Corporation, "[Object Linking and Embedding (OLE) Data Structures](%5bMS-OLEDS%5d.pdf#Section_85583d21c1cf4afea35fd6701c5fbb6f)". + +\[MS-OSHARED\] Microsoft Corporation, "[Office Common Data Types and Objects Structures](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d)". + +\[MS-OVBA\] Microsoft Corporation, "[Office VBA File Format Structure](%5bMS-OVBA%5d.pdf#Section_575462babf6741909facc275523c75fc)". + +\[MS-PRSTFR\] Microsoft Corporation, "[ADO XML Persistence Format](%5bMS-PRSTFR%5d.pdf#Section_7e50a09b3cf44bd9ae0c3eccddabe363)". + +\[MS-VIEWSS\] Microsoft Corporation, "[Views Web Service Protocol](%5bMS-VIEWSS%5d.pdf#Section_84e77d68e69244ba9e4e1d08abcb2d99)". + +\[MS-WSSTS\] Microsoft Corporation, "[Windows SharePoint Services](%5bMS-WSSTS%5d.pdf#Section_52b95801d55f4d63a1c3b4e857c43b31)". + +\[RFC1320\] Rivest, R., "The MD4 Message-Digest Algorithm", RFC 1320, April 1992, [https://www.rfc-editor.org/info/rfc1320](https://go.microsoft.com/fwlink/?LinkId=90274) + +\[RFC1321\] Rivest, R., "The MD5 Message-Digest Algorithm", RFC 1321, April 1992, [https://www.rfc-editor.org/info/rfc1321](https://go.microsoft.com/fwlink/?LinkId=90275) + +\[RFC1951\] Deutsch, P., "DEFLATE Compressed Data Format Specification version 1.3", RFC 1951, May 1996, [https://www.rfc-editor.org/info/rfc1951](https://go.microsoft.com/fwlink/?LinkId=90302) + +\[RFC2119\] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997, [https://www.rfc-editor.org/info/rfc2119](https://go.microsoft.com/fwlink/?LinkId=90317) + +\[RFC2781\] Hoffman, P., and Yergeau, F., "UTF-16, an encoding of ISO 10646", RFC 2781, February 2000, [https://www.rfc-editor.org/info/rfc2781](https://go.microsoft.com/fwlink/?LinkId=90380) + +\[RFC3986\] Berners-Lee, T., Fielding, R., and Masinter, L., "Uniform Resource Identifier (URI): Generic Syntax", STD 66, RFC 3986, January 2005, [https://www.rfc-editor.org/info/rfc3986](https://go.microsoft.com/fwlink/?LinkId=90453) + +\[RFC5234\] Crocker, D., Ed., and Overell, P., "Augmented BNF for Syntax Specifications: ABNF", STD 68, RFC 5234, January 2008, [https://www.rfc-editor.org/info/rfc5234](https://go.microsoft.com/fwlink/?LinkId=123096) + +\[SCHNEIER\] Schneier, B., "Applied Cryptography, Second Edition", John Wiley and Sons, 1996, ISBN: 0471117099. + +\[XMLDSig\] Bartel, M., Boyer, J., Fox, B., et al., "XML-Signature Syntax and Processing", W3C Recommendation, February 2002, [http://www.w3.org/TR/2002/REC-xmldsig-core-20020212/](https://go.microsoft.com/fwlink/?LinkId=130861) + +\[XMLNS\] Bray, T., Hollander, D., Layman, A., et al., Eds., "Namespaces in XML 1.0 (Third Edition)", W3C Recommendation, December 2009, [https://www.w3.org/TR/2009/REC-xml-names-20091208/](https://go.microsoft.com/fwlink/?LinkId=191840) + +\[XMLSCHEMA1/2\] Thompson, H., Beech, D., Maloney, M., and Mendelsohn, N., Eds., "XML Schema Part 1: Structures Second Edition", W3C Recommendation, October 2004, [https://www.w3.org/TR/2004/REC-xmlschema-1-20041028/](https://go.microsoft.com/fwlink/?LinkId=90607) + +\[XMLSCHEMA2/2\] Biron, P., and Malhotra, A., Eds., "XML Schema Part 2: Datatypes Second Edition", W3C Recommendation, October 2004, [https://www.w3.org/TR/2004/REC-xmlschema-2-20041028/](https://go.microsoft.com/fwlink/?LinkId=90609) + +### Informative References + +\[MSDN-ASRSD\] Microsoft Corporation, "Absolute and Self-Relative Security Descriptors", [http://msdn.microsoft.com/en-us/library/aa374807.aspx](https://go.microsoft.com/fwlink/?LinkId=119907) + +\[MSDN-BMP\] Microsoft Corporation, "Types of Bitmaps", [http://msdn.microsoft.com/en-us/library/ms536393.aspx](https://go.microsoft.com/fwlink/?LinkId=89960) + +\[MSDN-FONTS\] Microsoft Corporation, "About Fonts", [http://msdn.microsoft.com/en-us/library/dd162470(VS.85).aspx](https://go.microsoft.com/fwlink/?LinkId=90008) + +\[MSDN-OpenDBConnectivity\] Microsoft Corporation, "Microsoft Open Database Connectivity (ODBC)", [http://msdn.microsoft.com/en-us/library/ms710252.aspx](https://go.microsoft.com/fwlink/?LinkId=114655) + +\[MSDN-OSTD\] Microsoft Corporation, "Overview of Smart Tag Development \[Office 2003 SDK Documentation\]", [http://msdn.microsoft.com/en-us/library/aa169328.aspx](https://go.microsoft.com/fwlink/?LinkId=120036) + +\[MSDN-SOM\] Microsoft Corporation, "SOM Reference", [http://msdn.microsoft.com/en-us/library/ms754618(VS.85).aspx](https://go.microsoft.com/fwlink/?LinkID=156653&clcid=0x409) + +## Overview + +This document specifies [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) data contained in a compound file as described in [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b). The data is stored in the compound file by using storages, **streams** (section [2.1.2](#Section_f67ac5edb0a74b2c9b7a28933eeaac7e)), and **substreams** (section [2.1.3](#Section_5e380e95a9f54dfdb6d9c6998a9772f8)) that contain information about the content and structure of a workbook, including workbook data such as [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) definitions. Some storages, **streams**, and **substreams** store information by using binary **records** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)). The binary **record** (section 2.1.4) structure and content are specified in this document. Each binary **record** contains its record type, information about the record size, and zero or more type-specific fields depending on the record type, which is specified in section [2.3](#Section_7c84e174e96f45e0b23fa5e81f8b5def). Type-specific fields contain information further specifying the workbook data. Specifications of the fields for a given record type can be found in section [2.4](#Section_6fba03830d7a4c7aafe9642ff70cbd36). + +See the **File Structure** section (section [2.1](#Section_2e6147d9e8ad48b09ff7bbfc51ca950d)) for a more detailed overview of specific file architecture and content. + +### stream Byte Ordering + +Some computer architectures number bytes in a binary word from left to right, which is referred to as [**big-endian**](#gt_6f6f9e8e-5966-4727-8527-7e02fb864e7e). This documentation uses big-endian bit diagrams. Other architectures number the bytes in a binary word from right to left, which is referred to as [**little-endian**](#gt_079478cb-f4c5-4ce5-b72b-2144da5d2ce7). The underlying file format enumerations, objects, and records are little-endian. + +Using big-endian and little-endian methods, the number 0x12345678 would be stored as shown in the following table: + +| Byte order | Byte 0 | Byte 1 | Byte 2 | Byte 3 | +|---------------|--------|--------|--------|--------| +| Big-endian | 0x12 | 0x34 | 0x56 | 0x78 | +| Little-endian | 0x78 | 0x56 | 0x34 | 0x12 | + +Unless otherwise specified, all data in files of the type specified by this document are stored in little-endian format. + +### Organization of This Documentation + +Section [2](#Section_c227d7656ccf411a84f4198592b6f843) of this document is arranged with overviews of higher-level concepts being followed by more detailed concepts. Section [2.1](#Section_2e6147d9e8ad48b09ff7bbfc51ca950d) and section [2.2](#Section_492295cd134443929aa9717534c9d475), in particular, specify higher-level concepts that are required to understand the remainder of the document, and are read before reading the remainder of section 2. + +Section 2.1 specifies the structures and concepts that are used to organize and structure the file itself. Subsection [2.1.7](#Section_e1ea0a148d2c469b8875272091ea5aa9) further specifies the valid storages, **streams** (section [2.1.2](#Section_f67ac5edb0a74b2c9b7a28933eeaac7e)), and **substreams** (section [2.1.3](#Section_5e380e95a9f54dfdb6d9c6998a9772f8)) allowed within files of the type specified by this document. + +Section 2.2 specifies higher-level concepts that are normatively described for use in later sections of this document. + +Section [2.3](#Section_7c84e174e96f45e0b23fa5e81f8b5def) specifies the record name associated with a given record type. For more information about record types, see section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388). These associations are listed by record name as well as by record type. + +Section [2.4](#Section_6fba03830d7a4c7aafe9642ff70cbd36) specifies the details of individual records. + +Section [2.5](#Section_67410b0bfca64019ae2da53f9d392e03) specifies the details of structures used by records and other structures. + +Section [3](#Section_ff0abdfb49934cfd99d476cb2d3b2cde) provides specific examples intended to illustrate the concepts, records, and structures of this file format. + +Section [4](#Section_6df63a1fecd54d13801ea5321aa39caa) discusses encryption, obfuscation and other security issues relating to files of the type specified by this document. + +Section 5 is a list of version-specific behaviors. It is not intended to be read alone, but rather to be understood in the context of specifications in section 2. Specifications in section 2 provide links to the relevant items in Section 5. + +## Relationship to Protocols and Other Structures + +The Excel Binary File Format is an [**OLE compound file**](#gt_b39d4d3a-2d16-4bab-b9fd-ba8e1f16e6a4) as described in [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b). It is dependent on the structures defined in the following references: + +- [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) for the persistence of custom [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) mappings. + +- [\[MS-CTXLS\]](%5bMS-CTXLS%5d.pdf#Section_b461dcd9933e471081bcdc1c74801b6b) for command bar tables. + +- [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) for the persistence format for [**shapes**](#gt_d0e38aa4-2c71-4a6f-b5e6-75766fa9409e). + +- [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) for the persistence format for document signing, information rights management, document encryption and obfuscation. + +- [\[MS-OVBA\]](%5bMS-OVBA%5d.pdf#Section_575462babf6741909facc275523c75fc) for the persistence format for a [**VBA project**](#gt_980e3334-2874-4425-a73a-f2235cec1e1e). + +- [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) for the persistence format for additional common structures. + +## Applicability Statement + +This document specifies a persistence format for [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) content and templates, which can include unstructured or semi-structured tables of numbers, text, or both numbers and text, formulas, external data connections, charts and images. This persistence format is applicable for persistence of documents with a grid-based layout, including those with numeric data, structured data, and formulas. + +This persistence format is applicable for use as a stand-alone document, and for containment within other documents as an embedded object as described in [\[MS-OLEDS\]](%5bMS-OLEDS%5d.pdf#Section_85583d21c1cf4afea35fd6701c5fbb6f). + +This persistence format provides interoperability with applications that create or read documents conforming to this structure. + +## Versioning and Localization + +This document covers versioning issues in the following areas: + +**Structure Versions:** There is only one version of the Excel Binary File Format (.xls) Structure Specification. + +**Localization:** The following records and structures contain fields that specify locale-dependent meaning: + +- **Header** (section [2.4.136](#header)) + +- **Footer** (section [2.4.124](#footer)) + +- **Format** (section [2.4.126](#format)) + +- **CodeName** (section [2.4.51](#codename)) + +- **Font** (section [2.4.122](#font)) + +The Security Considerations section (section [4](#Section_6df63a1fecd54d13801ea5321aa39caa)), the **Password Verifier Algorithm** section (section [2.2.9](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4)), the Encryption (Password to Open) section (section [2.2.10](#Section_0f2ea0a19fc8468d97aa9d333b72d106)), and the **Macro Sheet Substream** section (section [2.1.7.20.4](#Section_0dddd943f77a4fc2bf92868acb4587f7)) also specify processes and data that are locale-dependent. See each record, structure, and section description for more information. + +## Vendor-Extensible Fields + +This persistence format can be extended by storing information in [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) and storages not specified in section [2](#Section_c227d7656ccf411a84f4198592b6f843). Implementations are not required to preserve or remove additional streams or storages when modifying an existing document. + +# Structures + +## File Structure + +This section specifies the overall structure of a file that conforms to this specification. + +A file of the type specified by this document is an [**OLE compound file**](#gt_b39d4d3a-2d16-4bab-b9fd-ba8e1f16e6a4). A **compound file** (section [2.1.1](#Section_b91df1c96bfa4ab482187bb0d73624ca)) contains storages, **streams** (section [2.1.2](#Section_f67ac5edb0a74b2c9b7a28933eeaac7e)), and **substreams** (section [2.1.3](#Section_5e380e95a9f54dfdb6d9c6998a9772f8)). Each **stream** or **substream** contains a series of binary **records** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)). Each binary **record** contains zero or more structured fields that contain the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) data. + +### Compound File + +A file of the type specified by this document MUST be an [**OLE compound file**](#gt_b39d4d3a-2d16-4bab-b9fd-ba8e1f16e6a4) as specified in [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b). + +### Stream + +A file of the type specified by this document consists of storages and [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) as specified in [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b). Each binary stream or **substream** (section [2.1.3](#Section_5e380e95a9f54dfdb6d9c6998a9772f8)) that contains [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) data MUST be written as a series of binary **records** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)) as specified in section [2.1.7](#Section_e1ea0a148d2c469b8875272091ea5aa9). + +The valid storages, streams, and **substreams** in a file of the type specified by this document are specified in section 2.1.7. + +A workbook MUST contain the **workbook** stream (section [2.1.7.20](#Section_f682f4b08c6b444e83f852d156f1e8ba)), with at least one [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) **substream** (**Worksheet Substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)), **Chart Sheet Substream** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)), **Macro Sheet Substream** (section [2.1.7.20.4](#Section_0dddd943f77a4fc2bf92868acb4587f7)), or **Dialog Sheet Substream** (section [2.1.7.20.2](#Section_da37feb48b9a462d87772a5fddd4866e))) that follows the **Globals Substream** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). + +This document uses [**Augmented Backus-Naur Form (ABNF)**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) as specified in [\[RFC5234\]](https://go.microsoft.com/fwlink/?LinkId=123096) to specify the **record** sequence for **streams** and **substreams** that contain binary **records**. + +### Substream + +The **workbook** stream (section [2.1.7.20](#Section_f682f4b08c6b444e83f852d156f1e8ba)) contains substreams that specify global properties and data for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and specify the [**sheets (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that constitute the workbook. The beginning of each substream is marked by a **BOF** record (section [2.4.21](#bof)) that has a **dt** field that specifies the type of the substream. The end of each substream is marked by an **EOF record** (section [2.4.103](#eof)). + +For more information about these substreams, see section 2.1.7.20 and subsections. + +### Record + +A record is the basic building block used to store information about features in a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). Each binary record is a variable-length sequence of bytes. A binary record consists of three components: a record type, a record size, and the record data that is specific to that record type. + +The record type is a two-byte unsigned integer that specifies what type of information is specified by the record and how the structure of the record data specific to this record is ordered and structured. Record type values MUST be a value from the **Record** Enumeration (section [2.3](#Section_7c84e174e96f45e0b23fa5e81f8b5def)) or the record MUST make use of the **future record** architecture (section [2.1.6](#Section_b660b67822684414839ed1ae9a4e4e85)). + +The record size is a two-byte unsigned integer that specifies the count of bytes that specifies the total size of the record data. The record size MUST be greater than or equal to 0 and MUST be less than or equal to 8224. + +The record data component contains fields that correspond to a particular record type and comprise the remainder of the record. The order and structure of the fields for a given record type listed in section 2.3 are specified in the corresponding section for that record type in section [2.4](#Section_6fba03830d7a4c7aafe9642ff70cbd36). The size of the record data component MUST be equal to the record size. Fields in the record data component can contain simple values, arrays of values, structures of several fields, arrays of fields, and arrays of structures. + +If the total number of bytes to be written for a given record data component is greater than 8224, a collection of **Continue** (section [2.4.58](#continue)), **ContinueFrt** (section [2.4.60](#continuefrt)), **ContinueFrt11** (section [2.4.61](#continuefrt11)), or **ContinueFrt12** (section [2.4.62](#continuefrt12)) records, as specified in the respective [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) for that record, is used to contain the remaining record data. In general, the first 8224 bytes of data is contained in the record data component of the given record and the remaining data is divided into blocks of 8224 bytes and contained in the subsequent collection of **Continue** (section 2.4.58), **ContinueFrt** (section 2.4.60), **ContinueFrt11** (section 2.4.61), or **ContinueFrt12** records, until all the data is written. See specific record definitions for exceptions. **ContinueBigName** (section [2.4.59](#continuebigname)) and **CrtMlFrtContinue** (section [2.4.71](#crtmlfrtcontinue)) are special cases that only apply to a single record type. + +### Collection of Records + +A collection of **records** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)) is a series of related **records** that are treated as a single set. **Records** in a collection do not have to share the same **record** type. A collection of **records** can further contain other collections of **records**. The beginning of a collection of **records** is sometimes indicated by a different type of **record**, as specified in the **record** sequence [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) where the rule that contains that **record** is specified. Similarly the end of a collection of **records** is sometimes indicated by a different type of **record**, as specified by the **record** sequence ABNF where the rule that contains that **record** is specified. Each **record** or collection within the collection can be referred to by index, and the index count starts over for each collection. + +In this document, **record** A precedes **record** B when **record** A is the last **record** of that type to appear before **record** B, in the **stream** (section [2.1.2](#Section_f67ac5edb0a74b2c9b7a28933eeaac7e)) or **substream** (section [2.1.3](#Section_5e380e95a9f54dfdb6d9c6998a9772f8)) that contains those **records**. + +In this document, **record** B follows **record** A when **record** A is the last **record** of that type to appear before **record** B, in the **stream** or **substream** that contains those **records**. + +### Future Record + +The future record architecture enables an application that does not support certain **records** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)) to open and save the file while ignoring but preserving those **records** in the file. **Records** that contain an **FRTHeader** (section [2.5.135](#frtheader)), **FrtHeaderOld** (section [2.5.136](#frtheaderold)), **FrtRefHeader** (section [2.5.137](#frtrefheader)), **FrtRefHeaderNoGrbit** (section [2.5.138](#frtrefheadernogrbit)). or **FrtRefHeaderU** (section [2.5.139](#frtrefheaderu)) structure, as specified in this document, are future records and can be treated as such by an application that implements the future record architecture. Future **records** that are not supported by an application can be cached on load and persisted on save, enabling the data to be retained in the file for an application that does support those **records**. When loading and caching these unsupported **records**, an application can process [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) references associated with the unsupported **records** as specified in the **FRTHeader**, **FrtHeaderOld**, **FrtRefHeader**, **FrtRefHeaderNoGrbit**, or **FrtRefHeaderU** structures. The application can adjust these range references as [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) are inserted, deleted or moved in the [**sheets (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) to preserve the correctness and validity of these range references associated with the unsupported **records** when saving the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) along with the unsupported **records**. + +For an in-depth discussion of how these structures relate to each other, read the specification for each structure in section [2.5](#Section_67410b0bfca64019ae2da53f9d392e03). + +#### Chart + +There are three types of **future records** (section [2.1.6](#Section_b660b67822684414839ed1ae9a4e4e85)) that can appear in the **Chart Sheet Substream** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)). + +The first type of **future record** is specific to a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) and is stored by using the **future record** architecture as specified in the Future Record section (section 2.1.6). Specifically, these **future records** that are specific to **charts** have a record type that MUST be greater than or equal to 2048 and MUST be less than or equal to 2303, as specified in section [2.3](#Section_7c84e174e96f45e0b23fa5e81f8b5def). These **future records** MUST exist in the collection of **records** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)) specified by the **StartBlock** records (section [2.4.266](#startblock)) and **EndBlock** records (section [2.4.100](#endblock)), unless they exist in the collection of **records** specified by the **StartObject** records (section [2.4.267](#startobject)) and **EndObject** records (section [2.4.101](#endobject)). The **StartBlock** records (section 2.4.266) and **EndBlock** records themselves MUST NOT appear in the collection of **records** specified by the **StartObject** records and **EndObject records**. Furthermore, a **ChartFrtInfo** record (section [2.4.49](#chartfrtinfo)) MUST precede the first **future record** that is specific to a **chart** in a **Chart Sheet Substream**. + +The second type of **future record** is stored by wrapping otherwise non-**future records** in the **FrtWrapper** record (section [2.4.130](#frtwrapper)), as specified in section 2.4.130. These **records** MUST be written in their entirety (the record type, record size and record data components, as specified in section 2.1.4) in the **wrappedRecord** field of the **FrtWrapper record**. These MUST exist in the collection of **records** specified by the **StartObject** records and **EndObject** records. + +The third type of **future record** is any other **future record** that is stored by using the **future record** architecture as specified in section 2.1.6, not belonging to the first two types. + +See the respective **record definitions** (section [2.4](#Section_6fba03830d7a4c7aafe9642ff70cbd36)) for details on how these **records** are written relative to other **future records** in the **Chart Sheet Substream**. + +#### PivotTable + +**PivotTables** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) implement the future record architecture as specified in section [2.1.6](#Section_b660b67822684414839ed1ae9a4e4e85). There are multiple classes of PivotTable records (section [2.2.5.1](#Section_ae3481143a7a4952baab4a7010a581c6)) represented using the **SXAddl record** (section [2.4.273.2](#sxaddl)). Each **record** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)) in a class specifies a different piece of information for the part of the **PivotTable** (section 2.2.5) to which the **SXAddl record** applies. For more information about how the **SXAddl record** is used, read section [2.2.5.1.1](#Section_db61fa8bdb7b4e1c99615c2f3ed1c369). + +### Storages and Streams + +This section specifies the [**storages**](#gt_63525252-3f66-4459-9b64-5b77f57b2f84), [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) and substreams of the Excel Binary File Format (.xls) file. Refer to section [2.1](#Section_2e6147d9e8ad48b09ff7bbfc51ca950d) for an understanding of storages, **streams**, and **substreams**. + +If the stream is in **[Binary Interchange File Format (BIFF)](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517)** format, the record sequence is specified using [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) grammar. + +#### Component Object Stream (\001CompObj) + +The Component Object Stream is specified in [\[MS-OLEDS\]](%5bMS-OLEDS%5d.pdf#Section_85583d21c1cf4afea35fd6701c5fbb6f) section [2.3.8](http://msdn.microsoft.com/en-us/library/142e0420-2f74-4ed9-829b-0b3d5a684d01/). + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "*\001*CompObj", where *\001* is the character with the value 0x01, not the string literal "\001". + +A file MUST contain at most one **Component O**bject **S**tream. + +#### Control Stream (Ctls) + +An instance of the **Control Stream** specifies the [**OLE objects**](#gt_cdff9514-a3fb-4897-941d-4e99193a0096) and [**ActiveX controls**](#gt_f3dcc35f-8f80-474e-ac39-106a23f059c2) that use stream-based persistence. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "Ctls". A file MUST contain at most one **Control S**tream. An object persisted in this stream MUST have a corresponding **Obj** record (section [2.4.181](#obj)) in a **worksheet substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) with a **cmo.ot** field that equals 8 and a **pictFlags.fPrstm** field that equals 1. The **pictFmla.lPosInCtlStm** and **pictFmla.cbBufInCtlStm** fields of the **Obj** record specify the location of the object data associated with that **Obj** record. + +#### Data Spaces Storage (\006DataSpaces) + +The Data Spaces Storage is specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.1. + +The name of this [**storage**](#gt_63525252-3f66-4459-9b64-5b77f57b2f84) MUST be "*\006*DataSpaces", where *\006* is the character with the value 0x06, not the string literal "\006". A file MUST contain at most one **Data Spaces Storage**. + +#### Document Summary Information Stream (\005DocumentSummaryInformation) + +The Document Summary Information Stream is specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.3.2.2. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "\005DocumentSummaryInformation", where \005 is the character with the value 0x05, not the string literal "\005". A file MUST contain at most one Document Summary **Information S**tream. + +#### Embedding Storage (MBD...) + +An instance of the **Embedding Storage** specifies an embedded [**OLE object**](#gt_cdff9514-a3fb-4897-941d-4e99193a0096) or an [**ActiveX control**](#gt_f3dcc35f-8f80-474e-ac39-106a23f059c2) that uses [**storage**](#gt_63525252-3f66-4459-9b64-5b77f57b2f84)-based persistence. + +The name of this storage MUST be "MBD" followed by eight hexadecimal digits uniquely identifying the [**embedded object**](#gt_708607be-8655-416e-93f3-b434e9ecbd56). An object persisted in an **Embedding Storage** MUST have a corresponding **Obj** (section [2.4.181](#obj)) in a **worksheet substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)), **macro sheet substream** (section [2.1.7.20.4](#Section_0dddd943f77a4fc2bf92868acb4587f7)), or **dialog sheet substream** (section [2.1.7.20.2](#Section_da37feb48b9a462d87772a5fddd4866e)) with a **cmo.ot** field that equals 8, a **pictFlags.fPrstm** field that equals 0, and a **pictFlags.fDde** field that equals 0. The **pictFmla.lPosInCtlStm** field of the **Obj** record specifies the name of the **Embedding Storage** that is associated with that **Obj** record. + +#### Encryption Stream (encryption) + +The Encryption Stream is specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.3.5.4**.** + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "encryption". A file MUST contain at most one **Encryption S**tream. + +#### Link Storage (LNK...) + +An instance of the **Link Storage** specifies a linked [**OLE object**](#gt_cdff9514-a3fb-4897-941d-4e99193a0096) and any default data or presentation caching established for it. + +The name of this storage MUST be "LNK" followed by eight hexadecimal digits uniquely identifying the [**linked object**](#gt_cfc45e76-9219-4c47-9ef2-5832a172f795). An object persisted in a **Link Storage** MUST have a corresponding **Obj** (section [2.4.181](#obj)) in a **worksheet substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)), **macro sheet substream** (section [2.1.7.20.4](#Section_0dddd943f77a4fc2bf92868acb4587f7)), or **dialog sheet substream** (section [2.1.7.20.2](#Section_da37feb48b9a462d87772a5fddd4866e)) with a **cmo.ot** field that equals 8, a **pictFlags.fPrstm** field that equals 0, and a **pictFlags.fDde** field that equals 1. Additionally, the **pictFmla.fmla** field of the **Obj** record (section 2.4.181) specifies a formula that refers to an **ExternName** (section [2.4.105](#externname)) with a **body** field of type **ExternOleDdeLink** (section [2.5.107](#externoleddelink)) with a **lStgName** field that specifies the name of the **Link Storage** that is associated with that **Obj** record. + +#### List Data Stream (List Data) + +The List **Data S**tream specifies one or more Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) definitions. Each data source definition is related to a Web-based data provider list. + +The name of the [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "List Data". A file MUST contain at most one List **Data S**tream. Each data source definition is related to a **Feature11** record (section [2.4.114](#feature11)) or **Feature12** record (section [2.4.115](#feature12)). The **lPosStmCache**, **cbStmCache** and **cchStmCache** fields of the **TableFeatureType** structure (section [2.5.266](#tablefeaturetype)) specify the relationship between the **Feature11** record or **Feature12** record and the **List Data S**tream. + +Each data source definition is specified as a compressed stream. The compression algorithm is specified in [\[RFC1951\]](https://go.microsoft.com/fwlink/?LinkId=90302). The stream is specified by the following [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067): + +1. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +##### Attributes + +The following table specifies the attributes that can be used in the LIST element: + +| Attribute | Description | +|----|----| +| Version | Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) server version from which the data was retrieved. MUST be less than or equal to 20 characters. | + +##### Elements + +The following table specifies the [**XML schema definition (XSD)**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae) elements that are specific to the LIST element: + +| Element | Description | +|----|----| +| **LISTNAME** (section [2.1.7.8.2.1](#Section_a2ce9676a4ff4916ad76f0288b8f28af)) | Display name or [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1), as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2), of a Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list. | +| **VIEWGUID** (section [2.1.7.8.2.2](#Section_0befe177e146420c83b2e950e89f7d70)) | GUID, as specified by \[MS-DTYP\], of a Web-based data provider [**list view**](#gt_1b49f76a-a3f7-4c2b-935e-2f764eafec71). | +| **LISTWEB** (section [2.1.7.8.2.3](#Section_273b3f763d40405ea77ec4c8fb67f006)) | [**Uniform Resource Identifier (URI)**](#gt_e18af8e8-01d7-4f91-8a1e-0fb21b191f95) of the Web-based data provider server from which the list was retrieved. | +| **ROOTFOLDER** (section [2.1.7.8.2.4](#Section_11af3867410f4d9f8ffc1b5d44b5434e)) | Path on the Web-based data provider server where the list is located. | +| **LISTSCHEMA** (section [2.1.7.8.2.5](#Section_922df830ac614fd7a8d97c8fb691fe45)) | [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) of the fields of the Web-based data provider list. | +| **VIEWSCHEMA** (section [2.1.7.8.2.6](#Section_2a2fb860f7ab4feab2f211e70d764f9e)) | XML schema of the Web-based data provider list view. | +| **LISTDATA** (section [2.1.7.8.2.7](#Section_03cb982d548044a1862edf25298d2df4)) | Specifies the data of the list. | +| **UPDATE** (section [2.1.7.8.2.8](#Section_8ee49ab1475b4c879e058aed4399920a)) | Specifies the inserted, deleted, and updated fields that were modified from the original [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) . | +| **LISTDATAFTR** (section [2.1.7.8.2.9](#Section_0c02ed6322d8426285ac6c626174896d)) | Validation footer used to validate the integrity of the data within the [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) . | + +###### LISTNAME + +The **LISTNAME** element specifies a list on the Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) server. It MUST be the display name or the [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1), as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2), of a [**list**](#gt_04ce231e-214c-44fd-b7ba-7cc19eee79bf). The **LISTNAME** element is specified as follows: + +68. \ + +###### VIEWGUID + +The **VIEWGUID** element specifies a list view on the server. It MUST be the [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1), as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2), of a list view. The **VIEWGUID** element is specified as follows: + +69. \ + +When the **VIEWGUID** element is not present or the value of the **VIEWGUID** element is empty, the current [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) definition within the **List Data Stream** (section [2.1.7.8](#Section_914f09bd8c944c099e8631dfe058f037)) MUST retrieve data from the default list view of the list on the server. + +###### LISTWEB + +The **LISTWEB** element specifies, as a [**URI**](#gt_e18af8e8-01d7-4f91-8a1e-0fb21b191f95), the name of the Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) server from which the list data was retrieved. MUST be a valid URI, as specified by [\[RFC3986\]](https://go.microsoft.com/fwlink/?LinkId=90453). The **LISTWEB** element is specified as follows: + +70. \ + +###### ROOTFOLDER + +The **ROOTFOLDER** element specifies the path from the **LISTWEB** [**URI**](#gt_e18af8e8-01d7-4f91-8a1e-0fb21b191f95) where the Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list from which the data was retrieved is located. When concatenated to the end of the **LISTWEB** field value, the result MUST be a valid URI, as specified by [\[RFC3986\]](https://go.microsoft.com/fwlink/?LinkId=90453). The **ROOTFOLDER** element is specified as follows: + +71. \ + +###### LISTSCHEMA + +The **LISTSCHEMA** element specifies the fields of the Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list from which the data was retrieved, along with additional information. The additional information includes [**regional settings**](#gt_ede60f7f-1131-4845-800b-b6848215e015) and whether attachments are enabled. The **LISTSCHEMA** element is specified as follows: + +72. \ + + \ + + \ + + \ + + \ + + \ + + \ + +The **LISTSCHEMA** element is further specified in [\[MS-LISTSWS\]](%5bMS-LISTSWS%5d.pdf#Section_30b364cc38374e839ce81963292e2ee5) section 2.2.4.12. + +###### VIEWSCHEMA + +The **VIEWSCHEMA** element specifies the list view of the Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list from which the data was retrieved. The **VIEWSCHEMA** element is specified as follows: + +79. \ + + \ + + \ + + \ + + \ + + \ + + \ + +The **VIEWSCHEMA** element is further specified in [\[MS-VIEWSS\]](%5bMS-VIEWSS%5d.pdf#Section_84e77d68e69244ba9e4e1d08abcb2d99) section 2.2. + +###### LISTDATA + +The **LISTDATA** element specifies the data retrieved from the Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list. The **LISTDATA** element is specified as follows: + +86. \ + + \ + + \ + + \ + + \ + + \ + + \ + +The referenced **rs:data** type is specified in [\[MS-PRSTFR\]](%5bMS-PRSTFR%5d.pdf#Section_7e50a09b3cf44bd9ae0c3eccddabe363) section 2.2. Additional information and examples is also specified in [\[MS-LISTSWS\]](%5bMS-LISTSWS%5d.pdf#Section_30b364cc38374e839ce81963292e2ee5) section 3.1.4.21.2.2. + +###### UPDATE + +The **UPDATE** element specifies the inserted, deleted, and updated fields that were modified from the data specified in **LISTDATA** (section [2.1.7.8.2.7](#Section_03cb982d548044a1862edf25298d2df4)). The definition of the **UPDATE** element is as follows: + +93. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +The **UPDATE** element is a parent element, which contains 3 optional child elements: **Inserts**, **Updates** and **Deletes**. **Inserts** specifies rows that were added locally, and are not synchronized with the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). **Updates** specifies rows that were modified locally, and that are not synchronized with the data source. **Deletes** specifies rows that were deleted locally, and that are not synchronized with the data source. The referenced **rs:data** type for each of the elements is specified in [\[MS-PRSTFR\]](%5bMS-PRSTFR%5d.pdf#Section_7e50a09b3cf44bd9ae0c3eccddabe363) section 2.2. Additional information and examples is also specified in [\[MS-LISTSWS\]](%5bMS-LISTSWS%5d.pdf#Section_30b364cc38374e839ce81963292e2ee5) section 3.1.4.21.2.2. + +###### LISTDATAFTR + +The **LISTDATAFTR** element specifies elements used to validate the integrity of the data within the [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6). It contains a sequence of signed integers which specify the [**MD5**](#gt_1535fdac-8d46-4605-96af-252907c4a593) [**hash**](#gt_b7e2b611-0af5-4fec-8af2-3f9ce7bad205) of each **rs:data** within the stream. The definition of the **LISTDATAFTR** element is a follows: + +120. \ + +The signed integers specified in the string data MUST be separated by the ";#" separator. There MUST be an MD5 hash, as specified by [\[RFC1321\]](https://go.microsoft.com/fwlink/?LinkId=90275), for the **LISTDATA** element, the **UPDATE.Inserts** element, the **UPDATE.Updates** element and the **UPDATE.Deletes** element. The MD5 hash MUST appear in the following order: **LISTDATA** element, the **UPDATE.Inserts** element, the **UPDATE.Updates** element and the **UPDATE.Deletes** element. If an element is not present in the stream, the corresponding MD5 hash MUST NOT be present. + +#### Office Data Store Storage (MsoDataStore) + +The **Office Data Store Storage** is specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.6. + +The name of this storage MUST be "MsoDataStore". A file MUST contain at most one **Office Data Store S**torage. + +#### Office Toolbars Stream (XCB) + +The **Office Toolbars Stream** specifies the custom toolbars attached to the file. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "XCB". A file MUST contain at most one **Office Toolbars S**tream. This stream MUST only contain a single **CTBWRAPPER** structure (section [2.6.1](#ctbwrapper)). + +Parts of this stream are specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.1. Refer to \[MS-OSHARED\] section 1.3 for a diagram that illustrates an example of the XCB binary stream with its toolbar customization structures. + +Following is the record sequence [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) for the XCB binary stream: + +121. XCB = CTBWRAPPER + + CTBWRAPPER = CTBS 1\*CTB + +For more information about the **CTBWRAPPER** structure, see section 2.6.1. For more information about the **CTBS** structure, see section [2.6.2](#ctbs). For more information about the **CTB** structure, see section [2.6.3](#ctb). + +#### OLE Stream (\001Ole) + +The OLE Stream is specified in [\[MS-OLEDS\]](%5bMS-OLEDS%5d.pdf#Section_85583d21c1cf4afea35fd6701c5fbb6f) section [2.3.3](http://msdn.microsoft.com/en-us/library/e0dc105e-77f1-4072-a938-9aa516dc43e9/). + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "*\001*Ole", where *\001* is the character with the value 0x01, not the string literal "\001". + +A file MUST contain at most one **OLE Stream**. + +#### Pivot Cache Storage (\_SX_DB_CUR) + +The **Pivot Cache Storage** specifies zero or more streams, each of which specify a **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) for a **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). The name of each [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be unique within the storage, and the name MUST be a four digit hexadecimal number stored as text. + +The name of this storage MUST be "\_SX_DB_CUR". A file MUST contain at most one **Pivot Cache Storage**. + +The number of **FDB** rules that occur MUST be equal to the value of **cfdbTot** in the **SXDB record** (section [2.4.275](#sxdb)). + +Record sequence [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) for each stream: + +PIVOTCACHE = SXDB [SXDBEx](#sxdbex) \*SXFORMULA \*FDB \*DBB [EOF](#eof) + +FDB = [SXFDB](#sxfdb) [SXFDBType](#sxfdbtype) \[SXFMLA / (\*GRPSXOPER \[SXRANGE / \*([SxIsxoper](#sxisxoper) \*[Continue](#continue))\])\] \*SRCSXOPER + +DBB = \[[SXDBB](#sxdbb)\] \*SXOPER + +SXFORMULA = SXFMLA PIVOTRULE [SXFormula](#sxformula) + +SXFMLA = [SxFmla](#sxfmla) \*([SxName](#sxname) \*[SXPair](#sxpair)) + +GRPSXOPER = SXOPER + +SRCSXOPER = SXOPER + +SXOPER = [SxNil](#sxnil) / [SXNum](#sxnum) / [SxBool](#sxbool) / [SxErr](#sxerr) / [SXString](#sxstring) / [SXDtr](#sxdtr) + +SXRANGE = [SXRng](#sxrng) (3SXNum / (2SXDtr [SXInt](#sxint))) + +#### Protected Content Stream (\009DRMContent) + +The **Protected Content Stream** is specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.2.10. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "*\009*DRMContent", where *\009* is the character with the value 0x09, not the string literal "\009". A file MUST contain at most one **Protected Content S**tream. + +#### Revision Stream (Revision Log) + +An instance of the **Revision Stream** specifies the **revision logs** (section [2.2.11.2](#Section_2cbd26e86f7e4195ada414c8b7e595b8)) and **revision records** (section [2.2.11.3](#Section_9e91e8bce4f249b897d4741481349d1b)) for a **shared workbook** (section [2.2.11](#Section_e45a62c4490f4304a09668908b57dacc)). + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "Revision Log". A file MUST contain at most one **Revision Stream**. The **Revision Stream** MUST exist if the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is a **shared workbook** (section 2.2.11). + +Record sequence [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf): + +REVISION = [RRDInfo](#rrdinfo) [FileLock](#filelock) [UsrExcl](#usrexcl) \*(HEADER \*(RENSHEET / INSDEL / CONFLICT / INSDELSH / CHGCELL / MOVE / FORMAT / AUTOFMT / DEFNAME / VIEW / NOTE / TRASHQTFIELD)) [EOF](#eof) + +HEADER = [RRDHead](#rrdhead) [RRTabId](#rrtabid) + +RENSHEET = [RRDRenSheet](#rrdrensheet) + +INSDEL = INS / DEL + +INS = [RRDInsDel](#rrdinsdel) \*(CHGCELL / FORMAT) + +DEL = [RRDInsDelBegin](#rrdinsdelbegin) RRDInsDel \*(CHGCELL / FORMAT) [RRDInsDelEnd](#rrdinsdelend) + +CONFLICT = [RRDConflict](#rrdconflict) + +INSDELSH = [RRInsertSh](#rrinsertsh) + +CHGCELL = [RRDChgCell](#rrdchgcell) \*[Continue](#continue) \*[RRDRstEtxp](#rrdrstetxp) + +MOVE = [RRDMoveBegin](#rrdmovebegin) [RRDMove](#rrdmove) \*(CHGCELL / FORMAT) [RRDMoveEnd](#rrdmoveend) + +FORMAT = [RRFormat](#rrformat) + +AUTOFMT = [RRAutoFmt](#rrautofmt) + +DEFNAME = [RRDDefName](#rrddefname) + +VIEW = [RRDUserView](#rrduserview) + +NOTE = [Note](#note) + +TRASHQTFIELD = [RRDTQSIF](#rrdtqsif) + +#### Signatures Stream (\_signatures) + +The **Signatures Stream** is specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.5.1. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "\_signatures". A file MUST contain at most one **Signatures S**tream[\<1\>](#Appendix_A_1). + +When generating the **Signature** value, as specified in \[MS-OFFCRYPTO\] section 2.5.1.5, the record data, as specified in section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388), of the **WriteAccess record** (section [2.4.349](#writeaccess)) in the **Globals Substream** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) is skipped. + +#### Summary Information Stream (\005SummaryInformation) + +The **Summary Information Stream** is specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.3.2.1. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "*\005*SummaryInformation", where *\005* is the character with the value 0x05, not the string literal "\005". A file MUST contain at most one Summary **Information S**tream. + +#### User Names Stream (User Names) + +The **User Names Stream** specifies a **user log** (section [2.2.11.1](#Section_df0e3725a65f459daa1c011679c5b904)) for a **shared workbook** (section [2.2.11](#Section_e45a62c4490f4304a09668908b57dacc)). + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "User Names". The presence of the **User Names Stream** indicates the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is a **shared workbook** (section 2.2.11). A file MUST contain at most one **User Names Stream**. + +Record sequence [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf): + +USERNAMES = [CUsr](#cusr) [UsrChk](#usrchk) [CbUsr](#cbusr) [BCUsrs](#bcusrs) \*[UsrInfo](#usrinfo) + +#### VBA Storage (\_VBA_PROJECT_CUR) + +The **VBA Storage** is specified in [\[MS-OVBA\]](%5bMS-OVBA%5d.pdf#Section_575462babf6741909facc275523c75fc). + +The name of this storage MUST be "\_VBA_PROJECT_CUR". A file MUST contain at most one **VBA S**torage. + +#### Viewer Content Stream (\009DRMViewerContent) + +The **Viewer Content Stream** is specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.2.11. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "*\009*DRMViewerContent", where *\009* is the character with the value 0x09, not the string literal "\009". A file MUST contain at most one **Viewer Content S**tream. + +#### Workbook Stream (Workbook) + +The **Workbook Stream** specifies global properties and data for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), as well as the [**sheets (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that constitute a workbook. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "Workbook". A file MUST contain exactly one **Workbook Stream**, which consists of several substreams. There MUST be exactly one **substream** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)), and the **substream** MUST be the first substream to appear in the **Workbook Stream**, which MUST be followed by one or more of the following substreams: + +- **Chart Sheet Substream** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) + +- **Dialog Sheet Substream** (section [2.1.7.20.2](#Section_da37feb48b9a462d87772a5fddd4866e)) + +- **Macro Sheet Substream** (section [2.1.7.20.4](#Section_0dddd943f77a4fc2bf92868acb4587f7)) + +- **Worksheet Substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) + +##### Chart Sheet Substream + +The **Chart Sheet Substream** specifies either a separate [**chart sheet**](#gt_da561b7b-c629-4cd8-bfaa-6e62471d9e83) that contains a single chart, or an **embedded** chart **object** (section [2.2.3.1](#Section_2c90d75bc92645aa8ff29d4483f51831)) contained within a **worksheet** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) or **macro sheet** (section [2.1.7.20.4](#Section_0dddd943f77a4fc2bf92868acb4587f7)). + +If a record in the [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) grammar for this substream is one of the following: **Font** (section [2.4.122](#font)), **Continue** (section [2.4.58](#continue)), **LineFormat** (section [2.4.156](#lineformat)), **AreaFormat** (section [2.4.3](#areaformat)), **SeriesText** (section [2.4.254](#seriestext)), **DefaultText** (section [2.4.88](#defaulttext)), **Text** (section [2.4.324](#text)), **FontX** (section [2.4.123](#fontx)), **ObjectLink** (section [2.4.182](#objectlink)), **Frame** (section [2.4.128](#frame)), **Begin** (section [2.4.17](#begin)), **End** (section [2.4.99](#end)), **PicF** (section [2.4.193](#picf)), **Pos** (section [2.4.201](#pos)), **AlRuns** (section [2.4.1](#alruns)), **BRAI** (section [2.4.29](#brai)), **Fbi** (section [2.4.109](#fbi)), or **GelFrame** (section [2.4.131](#gelframe)), and is in a collection specified by **StartObject** (section [2.4.267](#startobject)) and **EndObject** (section [2.4.101](#endobject)), that record MUST be replaced by an **FrtWrapper** record (section [2.4.130](#frtwrapper)) and the **wrappedRecord** field of that **FrtWrapper** record MUST specify the record that is replaced. **StartBlock** record (section [2.4.266](#startblock)) and **EndBlock** record (section [2.4.100](#endblock)) pairs and **ChartFrtInfo** (section [2.4.49](#chartfrtinfo)) are omitted from the ABNF grammar. See section [2.1.6.1](#Section_0d96d51a09bd44ddbb691541de053776) and the respective record specifications for more information. + +Record sequence[\<2\>](#Appendix_A_2) ABNF: + +CHARTSHEETCONTENT = \[[WriteProtect](#writeprotect)\] \[[SheetExt](#sheetext)\] \[[WebPub](#webpub)\] \*[HFPicture](#hfpicture) PAGESETUP [PrintSize](#printsize) \[[HeaderFooter](#headerfooter)\] \[BACKGROUND\] \*Fbi \*[Fbi2](#fbi2) \[[ClrtClient](#clrtclient)\] \[PROTECTION\] \[[Palette](#palette)\] \[[SXViewLink](#sxviewlink)\] \[[PivotChartBits](#pivotchartbits)\] \[[SBaseRef](#sbaseref)\] \[[MsoDrawingGroup](#msodrawinggroup)\] OBJECTS [Units](#units) CHARTFOMATS SERIESDATA \*WINDOW \*CUSTOMVIEW \[[CodeName](#codename)\] \[CRTMLFRT\] [EOF](#eof) + +CHARTSHEET = [BOF](#bof) CHARTSHEETCONTENT + +CHARTFOMATS = [Chart](#chart-2) Begin \*2FONTLIST [Scl](#scl) [PlotGrowth](#plotgrowth) \[FRAME\] \*SERIESFORMAT \*SS [ShtProps](#shtprops) \*2DFTTEXT [AxesUsed](#axesused) 1\*2AXISPARENT \[[CrtLayout12A](#crtlayout12a)\] \[DAT\] \*ATTACHEDLABEL \[CRTMLFRT\] \*(\[[DataLabExt](#datalabext) StartObject\] ATTACHEDLABEL \[EndObject\]) \[TEXTPROPS\] \*2CRTMLFRT End + +FONTLIST = [FrtFontList](#frtfontlist) StartObject \*(Font \[Fbi\]) EndObject + +AXISPARENT = [AxisParent](#axisparent) Begin Pos \[AXES\] 1\*4CRT End + +SERIESDATA = [Dimensions](#dimensions) 3([SIIndex](#siindex) \*([Number](#number) / [BoolErr](#boolerr) / [Blank](#blank) / [Label](#label))) + +AXES = \[IVAXIS DVAXIS \[SERIESAXIS\] / DVAXIS DVAXIS\] \*3ATTACHEDLABEL \[[PlotArea](#plotarea) FRAME\] + +IVAXIS = [Axis](#axis-1) Begin \[[CatSerRange](#catserrange)\] [AxcExt](#axcext) \[[CatLab](#catlab)\] AXS \[CRTMLFRT\] End + +DVAXIS = Axis Begin \[[ValueRange](#valuerange)\] \[AXM\] AXS \[CRTMLFRT\] End + +SERIESAXIS = Axis Begin \[CatSerRange\] AXS \[CRTMLFRT\] End + +CRT = [ChartFormat](#chartformat) Begin ([Bar](#bar) / [Line](#line) / ([BopPop](#boppop) \[[BopPopCustom](#boppopcustom)\]) / [Pie](#pie) / [Area](#area) / [Scatter](#scatter) / [Radar](#radar) / [RadarArea](#radararea) / [Surf](#surf)) [CrtLink](#crtlink) \[[SeriesList](#serieslist)\] \[[Chart3d](#chart3d)\] \[LD\] \[2DROPBAR\] \*4([CrtLine](#crtline) LineFormat) \*2DFTTEXT \[[DataLabExtContents](#datalabextcontents)\] \[SS\] \*4SHAPEPROPS End + +LD = [Legend](#legend-1) Begin Pos ATTACHEDLABEL \[FRAME\] \[[CrtLayout12](#crtlayout12)\] \[TEXTPROPS\] \[CRTMLFRT\] End + +SERIESFORMAT = [Series](#series-1) Begin 4AI \*SS ([SerToCrt](#sertocrt) / ([SerParent](#serparent) ([SerAuxTrend](#serauxtrend) / [SerAuxErrBar](#serauxerrbar)))) \*([LegendException](#legendexception) \[Begin ATTACHEDLABEL \[TEXTPROPS\] End\]) End + +FRAME = Frame Begin LineFormat AreaFormat \[GELFRAME\] \[SHAPEPROPS\] End + +AI = BRAI \[SeriesText\] + +ATTACHEDLABEL = Text Begin Pos \[FontX\] \[AlRuns\] AI \[FRAME\] \[ObjectLink\] \[DataLabExtContents\] \[CrtLayout12\] \[TEXTPROPS\] \[CRTMLFRT\] End + +SS = [DataFormat](#dataformat) Begin \[[Chart3DBarShape](#chart3dbarshape)\] \[LineFormat AreaFormat [PieFormat](#pieformat)\] \[[SerFmt](#serfmt)\] \[GELFRAME\] \[[MarkerFormat](#markerformat)\] \[[AttachedLabel](#attachedlabel)\] \*2SHAPEPROPS \[CRTMLFRT\] End + +SHAPEPROPS = [ShapePropsStream](#shapepropsstream) \*[ContinueFrt12](#continuefrt12) + +TEXTPROPS = ([RichTextStream](#richtextstream) / [TextPropsStream](#textpropsstream)) \*ContinueFrt12 + +AXS = \[[IFmtRecord](#ifmtrecord)\] \[[Tick](#tick)\] \[FontX\] \*4([AxisLine](#axisline) LineFormat) \[AreaFormat\] \[GELFRAME\] \*4SHAPEPROPS \[TextPropsStream \*ContinueFrt12\] + +DFTTEXT = \[DataLabExt StartObject\] DefaultText ATTACHEDLABEL \[EndObject\] + +DROPBAR = [DropBar](#dropbar) Begin LineFormat AreaFormat \[GELFRAME\] \[SHAPEPROPS\] End + +AXM = [YMult](#ymult) StartObject ATTACHEDLABEL EndObject + +DAT = [Dat](#dat) Begin LD End + +GELFRAME = 1\*2GelFrame \*Continue \[PICF\] + +PICF = Begin PicF End + +CRTMLFRT = [CrtMlFrt](#crtmlfrt) \*[CrtMlFrtContinue](#crtmlfrtcontinue) + +For ABNF rules not listed here, see section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082). Within the sequence of records specified by the **CUSTOMVIEW** rule (section 2.1.7.20.6) specified in section 2.1.7.20.6, the **Selection** (section [2.4.248](#selection)), **HorizontalPageBreaks** (section [2.4.142](#horizontalpagebreaks)), and **VerticalPageBreaks** (section [2.4.343](#verticalpagebreaks)) records MUST NOT be present. + +##### Dialog Sheet Substream + +The **Dialog Sheet Substream** specifies a [**dialog sheet**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8). + +Record sequence[\<3\>](#Appendix_A_3)[\<4\>](#Appendix_A_4) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf): + +DIALOGSHEETCONTENT = \[[Uncalced](#uncalced)\] [Index](#index) GLOBALS PAGESETUP \[[HeaderFooter](#headerfooter)\] \*BIGNAME \[DIALOGPROTECTION\] [DefColWidth](#defcolwidth) [Dimensions](#dimensions) OBJECTS \*[HFPicture](#hfpicture) \*[Note](#note) 1\*DIALOGWINDOW \*DIALOGCUSTOMVIEW \[[CodeName](#codename)\] \[[SheetExt](#sheetext)\] \*RECORD12 [EOF](#eof) + +DIALOGSHEET = [BOF](#bof) DIALOGSHEETCONTENT + +DIALOGPROTECTION = \[[Protect](#protect)\] \[[Password](#password)\] + +DIALOGWINDOW = [Window2](#window2) \[[Pane](#pane)\] \*[Selection](#selection) + +DIALOGCUSTOMVIEW = [UserSViewBegin](#usersviewbegin) \*Selection \[[HorizontalPageBreaks](#horizontalpagebreaks)\] \[[VerticalPageBreaks](#verticalpagebreaks)\] \[[Header](#header)\] \[[Footer](#footer)\] \[[HCenter](#hcenter)\] \[[VCenter](#vcenter)\] \[[LeftMargin](#leftmargin)\] \[[RightMargin](#rightmargin)\] \[[TopMargin](#topmargin)\] \[[BottomMargin](#bottommargin)\] \[[Pls](#pls)\] \[[Setup](#setup)\] \[[PrintSize](#printsize)\] \[HeaderFooter\] [UserSViewEnd](#usersviewend) + +OBJECTS = \*(MSODRAWING \*(TEXTOBJECT / OBJ)) \[[MsoDrawingSelection](#msodrawingselection)\] + +MSODRAWING = [MsoDrawing](#msodrawing) \*[Continue](#continue) + +OBJ = [Obj](#obj) \*Continue + +TEXTOBJECT = [TxO](#txo) \*Continue + +For ABNF rules not listed here, see section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082). + +##### Globals Substream + +The **Globals Substream** specifies global properties and data in a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +There MUST be exactly one **Globals Substream** in a **Workbook Stream** (section [2.1.7.20](#Section_f682f4b08c6b444e83f852d156f1e8ba)), and the **Globals Substream** MUST be the first substream in the **Workbook Stream**. + +Record sequence[\<5\>](#Appendix_A_5)[\<6\>](#Appendix_A_6) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf): + +WORKBOOKCONTENT = \[[WriteProtect](#writeprotect)\] \[[FilePass](#filepass)\] \[[Template](#template)\] INTERFACE [WriteAccess](#writeaccess) \[[FileSharing](#filesharing)\] [CodePage](#codepage) \*2047[Lel](#lel) [DSF](#dsf) \[[Excel9File](#excel9file)\] [RRTabId](#rrtabid) \[[ObProj](#obproj)\] \[[ObNoMacros](#obnomacros)\] \[[CodeName](#codename)\] \[FNGROUPS\] \*[Lbl](#lbl) \[[OleObjectSize](#oleobjectsize)\] PROTECTION 1\*[Window1](#window1) [Backup](#backup) [HideObj](#hideobj) [Date1904](#date1904) [CalcPrecision](#calcprecision) [RefreshAll](#refreshall) [BookBool](#bookbool) FORMATTING \*(PIVOTCACHEDEFINITION) \[DOCROUTE\] \*[UserBView](#userbview) [UsesELFs](#useselfs) 1\*BUNDLESHEET METADATA \[[MTRSettings](#mtrsettings)\] \[[ForceFullCalculation](#forcefullcalculation)\] [Country](#country) \*SUPBOOK \*LBL \*RTD \[[RecalcId](#recalcid)\] \*[HFPicture](#hfpicture) \*MSODRAWINGGROUP \[SHAREDSTRINGS\] [ExtSST](#extsst) \*[WebPub](#webpub) \[[WOpt](#wopt)\] \[[CrErr](#crerr)\] \[[BookExt](#bookext)\] \*[FeatHdr](#feathdr) \*[DConn](#dconn) \[THEME\] \[[CompressPictures](#compresspictures)\] \[[Compat12](#compat12)\] \[[GUIDTypeLib](#guidtypelib)\] [EOF](#eof) + +WORKBOOK = [BOF](#bof) WORKBOOKCONTENT + +INTERFACE = [InterfaceHdr](#interfacehdr) [Mms](#mms) [InterfaceEnd](#interfaceend) + +FNGROUPS = [BuiltInFnGroupCount](#builtinfngroupcount) \*[FnGroupName](#fngroupname) \*[FnGrp12](#fngrp12) + +PROTECTION = [WinProtect](#winprotect) [Protect](#protect) [Password](#password) [Prot4Rev](#prot4rev) [Prot4RevPass](#prot4revpass) + +FORMATTING = 1\*510[Font](#font) 8\*218[Format](#format) XFS \*[DXF](#dxf) STYLES \[TABLESTYLES\] \[[Palette](#palette)\] \[[ClrtClient](#clrtclient)\] + +XFS = 16\*[XF](#xf) \[[XFCRC](#xfcrc) 16\*4050[XFExt](#xfext)\] + +STYLES = 1\*([Style](#style) \[[StyleExt](#styleext)\]) + +TABLESTYLES = [TableStyles](#tablestyles) \*([TableStyle](#tablestyle) \*28[TableStyleElement](#tablestyleelement)) + +PIVOTCACHEDEFINITION = [SXStreamID](#sxstreamid) [SXVS](#sxvs) \[SXSRC\] \[SXADDLCACHE\] + +SXSRC = DREF / SXTBL / DBQUERY + +DREF = [DConName](#dconname) / [DConBin](#dconbin) / [DConRef](#dconref) + +SXTBL = [SXTbl](#sxtbl) \*DREF \*[SxTbpg](#sxtbpg) \*([SXTBRGIITM](#sxtbrgiitm) \*[SXString](#sxstring)) + +DBQUERY = [DbOrParamQry](#dborparamqry) \[1\*SXString \[DbOrParamQry \*(SXString DbOrParamQry)\]\] \*SXString + +DOCROUTE = [DocRoute](#docroute) 1\*65535[RecipName](#recipname) + +BUNDLESHEET = [BoundSheet8](#boundsheet8) + +METADATA = \*MDTINFO \*MDXSTR \*(MDXTUPLESET / [MDXProp](#mdxprop) / [MDXKPI](#mdxkpi)) \*MDBLOCK + +MDTINFO = [MDTInfo](#mdtinfo) \*[ContinueFrt12](#continuefrt12) + +MDXSTR = [MDXStr](#mdxstr) \*ContinueFrt12 + +MDXTUPLESET = ([MDXTuple](#mdxtuple) / [MDXSet](#mdxset)) \*ContinueFrt12 + +MDBLOCK = [MDB](#mdb) \*ContinueFrt12 + +SUPBOOK = [SupBook](#supbook) \[\*[ExternName](#externname) \*([XCT](#xct) \*[CRN](#crn))\] \[[ExternSheet](#externsheet)\] \*[Continue](#continue) + +LBL = Lbl \[[NameCmt](#namecmt)\] \[[NameFnGrp12](#namefngrp12)\] \[[NamePublish](#namepublish)\] + +RTD = [RealTimeData](#realtimedata) \*[ContinueFrt](#continuefrt) + +MSODRAWINGGROUP = [MsoDrawingGroup](#msodrawinggroup) \*Continue + +SHAREDSTRINGS = [SST](#sst) \*Continue + +THEME = [Theme](#theme) \*ContinueFrt12 + +SXADDLCACHE = [SXAddl_SXCCache_SXDId](#sxaddl_sxccache_sxdid) [SXAddl_SXCCache_SXDVer10Info](#sxaddl_sxccache_sxdver10info) \[[SXAddl_SXCCache_SXDVerSXMacro](#sxaddl_sxccache_sxdversxmacro)\] \[SXADDLCACHE12\] \[SXADDLDBQUERY\] \*UNKNOWNFRT [SXAddl_SXCCache_SXDEnd](#sxaddl_sxccache_sxdend) + +SXADDLCACHE12 = [SXAddl_SXCCache_SXDVerUpdInv](#sxaddl_sxccache_sxdverupdinv) [SXAddl_SXCCache_SXDInfo12](#sxaddl_sxccache_sxdinfo12) [SXAddl_SXCCache_SXDInvRefreshReal](#sxaddl_sxccache_sxdinvrefreshreal) \*SXADDLCACHEFIELD \[SXADDLSXDH\] \[SXADDLSXMGS\] SXAddl_SXCCache_SXDVerUpdInv + +SXADDLSXDH = [SXAddl_SXCSXDH_SXDId](#sxaddl_sxcsxdh_sxdid) \*[SXAddl_SXCSXDH_SXDSxdh](#sxaddl_sxcsxdh_sxdsxdh) [SXAddl_SXCSXDH_SXDEnd](#sxaddl_sxcsxdh_sxdend) + +SXADDLSXMGS = [SXAddl_SXCSXMgs_SXDId](#sxaddl_sxcsxmgs_sxdid) \*SXADDLSXMG \*[SXAddl_SXCSXMgs_SXDMGrpSXDHMap](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap) \*UNKNOWNFRT [SXAddl_SXCSXMgs_SXDEnd](#sxaddl_sxcsxmgs_sxdend) + +SXADDLSXMG = [SXAddl_SXCSXMg_SXDId](#sxaddl_sxcsxmg_sxdid) \*[Continue_SxaddlSxString](#continue_sxaddlsxstring) \[[SXAddl_SXCSXMg_SXDUserCaption](#sxaddl_sxcsxmg_sxdusercaption) \*Continue_SxaddlSxString\] \*UNKNOWNFRT [SXAddl_SXCSXMg_SXDEnd](#sxaddl_sxcsxmg_sxdend) + +SXADDLCACHEFIELD = [SXAddl_SXCCacheField_SXDId](#sxaddl_sxccachefield_sxdid) \*Continue_SxaddlSxString \[[SXAddl_SXCCacheField_SXDCaption](#sxaddl_sxccachefield_sxdcaption) \*Continue_SxaddlSxString\] \[[SXAddl_SXCCacheField_SXDProperty](#sxaddl_sxccachefield_sxdproperty) \[[SXAddl_SXCCacheField_SXDPropName](#sxaddl_sxccachefield_sxdpropname) \*Continue_SxaddlSxString\]\] \[[SXAddl_SXCCacheField_SXDIfdbMpMapCount](#sxaddl_sxccachefield_sxdifdbmpmapcount) [SXAddl_SXCCacheField_SXDIfdbMempropMap](#sxaddl_sxccachefield_sxdifdbmempropmap)\] \[[SXAddl_SXCCacheField_SXDSxrmitmCount](#sxaddl_sxccachefield_sxdsxrmitmcount) \*SXADDLCACHEITEM [SXAddl_SXCCacheItem_SXDEnd](#sxaddl_sxccacheitem_sxdend)\] [SXAddl_SXCCacheField_SXDEnd](#sxaddl_sxccachefield_sxdend) + +SXADDLCACHEITEM = [SXAddl_SXCCacheItem_SXDId](#sxaddl_sxccacheitem_sxdid) \[[SXAddl_SXCCacheItem_SXDSxrmitmDisp](#sxaddl_sxccacheitem_sxdsxrmitmdisp) \*Continue_SxaddlSxString\] \*([SXAddl_SXCCacheItem_SXDItmMpMapCount](#sxaddl_sxccacheitem_sxditmmpmapcount) [SXAddl_SXCCacheItem_SXDItmMpropMap](#sxaddl_sxccacheitem_sxditmmpropmap)) + +##### Macro Sheet Substream + +The **Macro Sheet Substream** specifies a [**macro sheet**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491). This substream specifies an [**international macro sheet**](#gt_17a6eea5-8094-4056-84fd-8d97fbf0c865) if the **Intl** record (section [2.4.147](#intl)) is present. + +Record sequence[\<7\>](#Appendix_A_7) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf): + +MACROSHEETCONTENT = \[[Uncalced](#uncalced)\] [Index](#index) \[Intl\] GLOBALS PAGESETUP \[[HeaderFooter](#headerfooter)\] \[BACKGROUND\] \*BIGNAME \[PROTECTION\] COLUMNS MACROSORTANDFILTER [Dimensions](#dimensions) \[CELLTABLE\] OBJECTS \*[HFPicture](#hfpicture) \*[Note](#note) \[DCON\] 1\*WINDOW \*CUSTOMVIEW \*2SORT \[[DxGCol](#dxgcol)\] \[PHONETICINFO\] \[[CodeName](#codename)\] \*[CellWatch](#cellwatch) \[[SheetExt](#sheetext)\] \*FEAT \*RECORD12 [EOF](#eof) + +MACROSHEET = [BOF](#bof) MACROSHEETCONTENT + +MACROSORTANDFILTER = \[[Sort](#sort)\] \[SORTDATA12\] \[[DropDownObjIds](#dropdownobjids)\] \[AUTOFILTER\] + +For ABNF rules not listed here, see section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082). **Table** (section [2.4.319](#table)) MUST NOT appear under this substream. + +##### Worksheet Substream + +The **Worksheet Substream** specifies a [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +Record sequence[\<8\>](#Appendix_A_8) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf): + +WORKSHEETCONTENT = \[[Uncalced](#uncalced)\] [Index](#index) GLOBALS PAGESETUP \[[HeaderFooter](#headerfooter)\] \[BACKGROUND\] \*BIGNAME \[PROTECTION\] COLUMNS \[SCENARIOS\] SORTANDFILTER [Dimensions](#dimensions) \[CELLTABLE\] OBJECTS \*[HFPicture](#hfpicture) \*[Note](#note) \*PIVOTVIEW \[DCON\] 1\*WINDOW \*CUSTOMVIEW \*2SORT \[[DxGCol](#dxgcol)\] \*[MergeCells](#mergecells) \[[LRng](#lrng)\] \*QUERYTABLE \[PHONETICINFO\] CONDFMTS \*HLINK \[DVAL\] \[[CodeName](#codename)\] \*[WebPub](#webpub) \*[CellWatch](#cellwatch) \[[SheetExt](#sheetext)\] \*FEAT \*FEAT11 \*RECORD12 [EOF](#eof) + +WORKSHEET = [BOF](#bof) WORKSHEETCONTENT + +SCENARIOS = [ScenMan](#scenman) \*([SCENARIO](#scenario) \*[Continue](#continue)) + +SORTANDFILTER = \[[Sort](#sort)\] \[SORTDATA12\] \[[FilterMode](#filtermode)\] \[[DropDownObjIds](#dropdownobjids)\] \[AUTOFILTER\] + +PIVOTVIEW = PIVOTCORE \[PIVOTFRT\] + +PIVOTCORE = [SxView](#sxview) \*PIVOTVD \*2PIVOTIVD \[PIVOTPI\] \*[SXDI](#sxdi) \*PIVOTLI PIVOTEX + +PIVOTFRT = PIVOTFRT9 \[PIVOTADDL\] + +PIVOTFRT9 = [QsiSXTag](#qsisxtag) \[DBQUERYEXT\] \[PIVOTVIEWEX\] [SXViewEx9](#sxviewex9) + +PIVOTVD = [Sxvd](#sxvd) \*[SXVI](#sxvi) [SXVDEx](#sxvdex) + +PIVOTIVD = [SxIvd](#sxivd) \*Continue + +PIVOTPI = [SXPI](#sxpi) \*Continue + +PIVOTLI = [SXLI](#sxli) \*Continue + +PIVOTEX = [SXEx](#sxex) \*PIVOTSELECT \*PIVOTFORMAT + +PIVOTSELECT = [SxSelect](#sxselect) PIVOTRULE + +PIVOTFORMAT = [SxFormat](#sxformat) PIVOTRULE \[[SxDXF](#sxdxf)\] + +PIVOTVIEWEX = [SXViewEx](#sxviewex) \*PIVOTTH \*[SXPIEx](#sxpiex) \*PIVOTVDTEX + +PIVOTTH = [SXTH](#sxth) \*[ContinueFrt](#continuefrt) + +PIVOTVDTEX = [SXVDTEx](#sxvdtex) \*ContinueFrt + +QUERYTABLE = [Qsi](#qsi) DBQUERY QsiSXTag DBQUERYEXT \[SXADDLQSI\] \[QSIR\] \[SORTDATA12\] + +SXADDLQSI = [SXAddl_SXCQsi_SXDId](#sxaddl_sxcqsi_sxdid) SXADDLDBQUERY \*UNKNOWNFRT [SXAddl_SXCQsi_SXDEnd](#sxaddl_sxcqsi_sxdend) + +QSIR = [Qsir](#qsir) \*[Qsif](#qsif) + +DBQUERY = [DbOrParamQry](#dborparamqry) \[1\*[SXString](#sxstring) \[DbOrParamQry \*(SXString DbOrParamQry)\]\] \*SXString + +DBQUERYEXT = [DBQueryExt](#dbqueryext) \[[ExtString](#extstring)\] \*4\[[OleDbConn](#oledbconn) \*ExtString\] \[[TxtQry](#txtqry) \*ExtString\] + +CONDFMTS = \*(CONDFMT / CONDFMT12) \*([CFEx](#cfex) \[[CF12](#cf12)\]) + +CONDFMT = [CondFmt](#condfmt) 1\*3[CF](#cf) + +CONDFMT12 = [CondFmt12](#condfmt12) 1\*CF12 + +HLINK = [HLink](#hlink) \[[HLinkTooltip](#hlinktooltip)\] + +DVAL = [DVal](#dval) \*65534[Dv](#dv) + +PIVOTADDL = [SXAddl_SXCView_SXDId](#sxaddl_sxcview_sxdid) \*[Continue_SxaddlSxString](#continue_sxaddlsxstring) \[[SXAddl_SXCView_SXDVer10Info](#sxaddl_sxcview_sxdver10info)\] \[[SXAddl_SXCView_SXDVer12Info](#sxaddl_sxcview_sxdver12info)\] \*SXADDLCALCMEMBER \*SXADDLHIERARCHY \*SXADDLFIELD \*UNKNOWNFRT \[[SXAddl_SXCView_SXDTableStyleClient](#sxaddl_sxcview_sxdtablestyleclient)\] \[[SXAddl_SXCView_SXDCompactRwHdr](#sxaddl_sxcview_sxdcompactrwhdr) \*Continue_SxaddlSxString\] \[[SXAddl_SXCView_SXDCompactColHdr](#sxaddl_sxcview_sxdcompactcolhdr) \*Continue_SxaddlSxString\] \[[SXAddl_SXCView_SXDVerUpdInv](#sxaddl_sxcview_sxdverupdinv)\] \[SXADDLCONDFMTS\] \[SXADDLSXFILTERS12\] \*SXAddl_SXCView_SXDVerUpdInv \*[SXAddl_SXCView_SXDSXPIIvmb](#sxaddl_sxcview_sxdsxpiivmb) \[SXAddl_SXCView_SXDVerUpdInv\] [SXAddl_SXCView_SXDEnd](#sxaddl_sxcview_sxdend) + +SXADDLCALCMEMBER = ([SXAddl_SXCView_SXDCalcMember](#sxaddl_sxcview_sxdcalcmember) \[[SXAddl_SXCView_SXDCalcMemString](#sxaddl_sxcview_sxdcalcmemstring) \*Continue_SxaddlSxString\]) + +SXADDLCONDFMTS = [SXAddl_SXCSXCondFmts_SXDId](#sxaddl_sxcsxcondfmts_sxdid) \*SXADDLCONDFMT [SXAddl_SXCSXCondFmts_SXDEnd](#sxaddl_sxcsxcondfmts_sxdend) + +SXADDLCONDFMT = [SXAddl_SXCSXCondFmt_SXDSXCondFmt](#sxaddl_sxcsxcondfmt_sxdsxcondfmt) \*SXADDLSXRULE [SXAddl_SXCSXCondFmt_SXDEnd](#sxaddl_sxcsxcondfmt_sxdend) + +SXADDLAUTOSORT = [SXAddl_SXCAutoSort_SXDId](#sxaddl_sxcautosort_sxdid) SXADDLSXRULE [SXAddl_SXCAutoSort_SXDEnd](#sxaddl_sxcautosort_sxdend) + +SXADDLSXRULE = [SXAddl_SXCSXrule_SXDId](#sxaddl_sxcsxrule_sxdid) [SXAddl_SXCSXrule_SXDSXrule](#sxaddl_sxcsxrule_sxdsxrule) \*SXADDLSXFILT [SXAddl_SXCSXrule_SXDEnd](#sxaddl_sxcsxrule_sxdend) + +SXADDLSXFILT = [SXAddl_SXCSXfilt_SXDId](#sxaddl_sxcsxfilt_sxdid) [SXAddl_SXCSXfilt_SXDSXfilt](#sxaddl_sxcsxfilt_sxdsxfilt) \[[SXAddl_SXCSXfilt_SXDSXItm](#sxaddl_sxcsxfilt_sxdsxitm)\] [SXAddl_SXCSXfilt_SXDEnd](#sxaddl_sxcsxfilt_sxdend) + +SXADDLSXFILTERS12 = [SXAddl_SXCSXFilters12_SXDId](#sxaddl_sxcsxfilters12_sxdid) \*SXADDLSXFILTER12 [SXAddl_SXCSXFilters12_SXDEnd](#sxaddl_sxcsxfilters12_sxdend) + +SXADDLSXFILTER12 = [SXAddl_SXCSXFilter12_SXDId](#sxaddl_sxcsxfilter12_sxdid) [SXAddl_SXCSXFilter12_SXDSXFilter](#sxaddl_sxcsxfilter12_sxdsxfilter) \[[SXAddl_SXCSXFilter12_SXDCaption](#sxaddl_sxcsxfilter12_sxdcaption) \*Continue_SxaddlSxString\] \[[SXAddl_SXCSXFilter12_SXDSXFilterDesc](#sxaddl_sxcsxfilter12_sxdsxfilterdesc) \*Continue_SxaddlSxString\] \[[SXAddl_SXCSXFilter12_SXDSXFilterValue1](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1) \*Continue_SxaddlSxString\] \[[SXAddl_SXCSXFilter12_SXDSXFilterValue2](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2) \*Continue_SxaddlSxString\] [SXAddl_SXCSXFilter12_SXDXlsFilter](#sxaddl_sxcsxfilter12_sxdxlsfilter) \[[SXAddl_SXCSXFilter12_SXDXlsFilterValue1](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1) \*Continue_SxaddlSxString\] \[[SXAddl_SXCSXFilter12_SXDXlsFilterValue2](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2) \*Continue_SxaddlSxString\] [SXAddl_SXCSXFilter12_SXDEnd](#sxaddl_sxcsxfilter12_sxdend) + +SXADDLFIELD = \[[SXAddl_SXCField_SXDId](#sxaddl_sxcfield_sxdid) \*Continue_SxaddlSxString [SXAddl_SXCField_SXDVer10Info](#sxaddl_sxcfield_sxdver10info) [SXAddl_SXCField_SXDEnd](#sxaddl_sxcfield_sxdend)\] \[SXADDLFIELD12\] + +SXADDLFIELD12 = [SXAddl_SXCField12_SXDId](#sxaddl_sxcfield12_sxdid) \*Continue_SxaddlSxString [SXAddl_SXCField12_SXDVer12Info](#sxaddl_sxcfield12_sxdver12info) [SXAddl_SXCField12_SXDVerUpdInv](#sxaddl_sxcfield12_sxdverupdinv) \[[SXAddl_SXCField12_SXDMemberCaption](#sxaddl_sxcfield12_sxdmembercaption) \*Continue_SxaddlSxString\] \[[SXAddl_SXCField12_SXDAutoshow](#sxaddl_sxcfield12_sxdautoshow)\] \[[SXAddl_SXCField12_SXDISXTH](#sxaddl_sxcfield12_sxdisxth)\] \[SXADDLAUTOSORT\] SXAddl_SXCField12_SXDVerUpdInv \*UNKNOWNFRT [SXAddl_SXCField12_SXDEnd](#sxaddl_sxcfield12_sxdend) + +SXADDLHIERARCHY = [SXAddl_SXCHierarchy_SXDId](#sxaddl_sxchierarchy_sxdid) \*Continue_SxaddlSxString \*[SXAddl_SXCHierarchy_SXDProperty](#sxaddl_sxchierarchy_sxdproperty) \*SXADDLGRPLEVEL \[[SXAddl_SXCHierarchy_SXDVerUpdInv](#sxaddl_sxchierarchy_sxdverupdinv)\] \*[SXAddl_SXCHierarchy_SXDFilterMember](#sxaddl_sxchierarchy_sxdfiltermember) \[SXAddl_SXCHierarchy_SXDVerUpdInv\] \[[SXAddl_SXCHierarchy_SXDSXSetParentUnique](#sxaddl_sxchierarchy_sxdsxsetparentunique) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDIconSet](#sxaddl_sxchierarchy_sxdiconset)\] \[[SXAddl_SXCHierarchy_SXDUserCaption](#sxaddl_sxchierarchy_sxdusercaption) \*Continue_SxaddlSxString\] \*UNKNOWNFRT \[SXAddl_SXCHierarchy_SXDVerUpdInv\] \*[SXAddl_SXCHierarchy_SXDFilterMember12](#sxaddl_sxchierarchy_sxdfiltermember12) \[SXAddl_SXCHierarchy_SXDVerUpdInv\] \[[SXAddl_SXCHierarchy_SXDInfo12](#sxaddl_sxchierarchy_sxdinfo12)\] \[[SXAddl_SXCHierarchy_SXDDisplayFolder](#sxaddl_sxchierarchy_sxddisplayfolder) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDMeasureGrp](#sxaddl_sxchierarchy_sxdmeasuregrp) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDParentKPI](#sxaddl_sxchierarchy_sxdparentkpi) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDKPIValue](#sxaddl_sxchierarchy_sxdkpivalue) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDKPIGoal](#sxaddl_sxchierarchy_sxdkpigoal) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDKPIStatus](#sxaddl_sxchierarchy_sxdkpistatus) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDKPITrend](#sxaddl_sxchierarchy_sxdkpitrend) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDKPIWeight](#sxaddl_sxchierarchy_sxdkpiweight) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDKPITime](#sxaddl_sxchierarchy_sxdkpitime) \*Continue_SxaddlSxString\] [SXAddl_SXCHierarchy_SXDEnd](#sxaddl_sxchierarchy_sxdend) + +SXADDLGRPLEVEL = [SXAddl_SXCGrpLevel_SXDId](#sxaddl_sxcgrplevel_sxdid) \*Continue_SxaddlSxString [SXAddl_SXCGrpLevel_SXDGrpLevelInfo](#sxaddl_sxcgrplevel_sxdgrplevelinfo) \*SXADDLGROUP \*UNKNOWNFRT [SXAddl_SXCGrpLevel_SXDEnd](#sxaddl_sxcgrplevel_sxdend) + +SXADDLGROUP = [SXAddl_SXCGroup_SXDId](#sxaddl_sxcgroup_sxdid) \*Continue_SxaddlSxString [SXAddl_SXCGroup_SXDGrpInfo](#sxaddl_sxcgroup_sxdgrpinfo) \*[SXAddl_SXCGroup_SXDMember](#sxaddl_sxcgroup_sxdmember) \*UNKNOWNFRT [SXAddl_SXCGroup_SXDEnd](#sxaddl_sxcgroup_sxdend) + +For ABNF rules not listed here, see the [Common Productions](#Section_a1b3d8b4744241fd9c57bbd2a6394082) section. + +##### Common Productions + +Record sequence fragments that are common to multiple substreams are specified here. If a fragment cannot be found under its part, look for it in this record sequence[\<9\>](#Appendix_A_9)[\<10\>](#Appendix_A_10)[\<11\>](#Appendix_A_11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf): + +GLOBALS = [CalcMode](#calcmode) [CalcCount](#calccount) [CalcRefMode](#calcrefmode) [CalcIter](#calciter) [CalcDelta](#calcdelta) [CalcSaveRecalc](#calcsaverecalc) [PrintRowCol](#printrowcol) [PrintGrid](#printgrid) [GridSet](#gridset) [Guts](#guts) [DefaultRowHeight](#defaultrowheight) [WsBool](#wsbool) \[[Sync](#sync)\] \[[LPr](#lpr)\] \[[HorizontalPageBreaks](#horizontalpagebreaks)\] \[[VerticalPageBreaks](#verticalpagebreaks)\] + +PAGESETUP = [Header](#header) [Footer](#footer) [HCenter](#hcenter) [VCenter](#vcenter) \[[LeftMargin](#leftmargin)\] \[[RightMargin](#rightmargin)\] \[[TopMargin](#topmargin)\] \[[BottomMargin](#bottommargin)\] \[[Pls](#pls) \*[Continue](#continue)\] [Setup](#setup) + +BACKGROUND = [BkHim](#bkhim) \*Continue + +BIGNAME = [BigName](#bigname) \*[ContinueBigName](#continuebigname) + +PROTECTION = \[[Protect](#protect)\] \[[ScenarioProtect](#scenarioprotect)\] \[[ObjProtect](#objprotect)\] \[[Password](#password)\] + +COLUMNS = [DefColWidth](#defcolwidth) \*255[ColInfo](#colinfo) + +AUTOFILTER = [AutoFilterInfo](#autofilterinfo) \*([AutoFilter](#autofilter) / ([AutoFilter12](#autofilter12) \*[ContinueFrt12](#continuefrt12))) \*SORTDATA12 + +CELLTABLE = 1\*(1\*[Row](#row) \*CELL 1\*[DBCell](#dbcell)) \*[EntExU2](#entexu2) + +CELL = FORMULA / [Blank](#blank) / [MulBlank](#mulblank) / [RK](#rk) / [MulRk](#mulrk) / [BoolErr](#boolerr) / [Number](#number) / [LabelSst](#labelsst) + +FORMULA = \[[Uncalced](#uncalced)\] [Formula](#formula) \[[Array](#array) / [Table](#table) / [ShrFmla](#shrfmla) / SUB\] \[[String](#string) \*Continue\] + +PHONETICINFO = [PhoneticInfo](#phoneticinfo) \*Continue + +OBJECTS = \*(MSODRAWING \*(TEXTOBJECT / OBJ)) \[[MsoDrawingSelection](#msodrawingselection)\] + +MSODRAWING = [MsoDrawing](#msodrawing) \*Continue + +OBJ = [Obj](#obj) \*Continue \*CHART + +CHART = CHARTSHEET \*Continue + +TEXTOBJECT = [TxO](#txo) \*Continue + +DCON = [DCon](#dcon) \*([DConName](#dconname) / [DConBin](#dconbin) / [DConRef](#dconref)) + +WINDOW = [Window2](#window2) \[[PLV](#plv)\] \[[Scl](#scl)\] \[[Pane](#pane)\] \*[Selection](#selection) + +CUSTOMVIEW = [UserSViewBegin](#usersviewbegin) \*Selection \[HorizontalPageBreaks\] \[VerticalPageBreaks\] \[Header\] \[Footer\] \[HCenter\] \[VCenter\] \[LeftMargin\] \[RightMargin\] \[TopMargin\] \[BottomMargin\] \[Pls\] \[Setup\] \[[PrintSize](#printsize)\] \[[HeaderFooter](#headerfooter)\] \[AUTOFILTER\] [UserSViewEnd](#usersviewend) + +SORT = [RRSort](#rrsort) \*Continue + +SORTDATA12 = [SortData](#sortdata) \*ContinueFrt12 + +PIVOTRULE = [SxRule](#sxrule) \*PRFILTER + +PRFILTER = [SxFilt](#sxfilt) \[[SxItm](#sxitm) \*Continue\] + +FEAT = [FeatHdr](#feathdr) \*([Feat](#feat) \*[ContinueFrt](#continuefrt)) + +FEAT11 = [FeatHdr11](#feathdr11) \*(([Feature11](#feature11) / [Feature12](#feature12)) \*[ContinueFrt11](#continuefrt11) \*[List12](#list12) \[AutoFilter12 \*ContinueFrt12\] \*List12 \[SORTDATA12\]) + +RECORD12 = HeaderFooter + +SXADDLDBQUERY = \[[SXAddl_SXCQuery_SXDXMLSource](#sxaddl_sxcquery_sxdxmlsource) \*[Continue_SxaddlSxString](#continue_sxaddlsxstring)\] \[[SXAddl_SXCQuery_SXDSrcDataFile](#sxaddl_sxcquery_sxdsrcdatafile) \*Continue_SxaddlSxString\] \[[SXAddl_SXCQuery_SXDSrcConnFile](#sxaddl_sxcquery_sxdsrcconnfile) \*Continue_SxaddlSxString\] \[[SXAddl_SXCQuery_SXDReconnCond](#sxaddl_sxcquery_sxdreconncond)\] [SXAddl_SXCQuery_SXDEnd](#sxaddl_sxcquery_sxdend) + +UNKNOWNFRT = [SXAddl](#sxaddl) + +#### XML Signatures Storage (\_xmlsignatures) + +The **XML Signatures Storage** is specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.5.2. + +The name of this storage MUST be "\_xmlsignatures". A file MUST contain at most one **XML Signatures S**torage[\<12\>](#Appendix_A_12). + +When generating the **DigestValue**, as specified in [\[XMLDSig\]](https://go.microsoft.com/fwlink/?LinkId=130861) section 4.3.3.6, the record data, as specified in the **Record** section (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)), in the **WriteAccess record** (section [2.4.349](#writeaccess)) in the **Globals Substream** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) is skipped. + +#### XML Stream (XML) + +The XML **S**tream specifies one or more [**XML maps**](#gt_01b93f1f-ca62-4216-82d5-b6154e925c9f). + +The name of the stream MUST be "XML". A file MUST contain at most one XML **S**tream. + +The syntax of the structures contained in this part uses [**XML schema definition (XSD)**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this stream is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) as specified by the following [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067): + +123. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +##### Elements + +The following table specifies the [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae) elements that are specific to the **XML Stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)): + +| Element | Description | +|----|----| +| **MapInfo** (section [2.1.7.22.1.1](#Section_a7ea1bde730c4ef3bc9379f78f793aab)) | This element specifies a container for all of the [**XML schemas**](#gt_bd0ce6f9-c350-4900-827e-951265294067) and [**XML maps**](#gt_01b93f1f-ca62-4216-82d5-b6154e925c9f) attached to workbook. | +| **Schema** (section [2.1.7.22.1.2](#Section_085d058b1173411ead93fddbd822f781)) | This element specifies an XML schema associated with an XML map. | +| **Map** (section [2.1.7.22.1.3](#Section_82224f3b936a44cbbec1b0992d1a1281)) | This element specifies an XML map and the behaviors expected during [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) operations. | +| **DataBinding** (section [2.1.7.22.1.4](#Section_53d6d872ee4849689d06365efeb5b416)) | This element specifies a connection to an [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) file [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) that is used when the XML map is refreshed. | + +###### MapInfo + +The **MapInfo element** specifies a container for all of the [**XML schemas**](#gt_bd0ce6f9-c350-4900-827e-951265294067) and [**XML maps**](#gt_01b93f1f-ca62-4216-82d5-b6154e925c9f) attached to workbook. + +**SelectionNamespaces:** An **ST_Xstring65535** (section [2.1.7.22.2.4](#Section_5e49634084e34b73af72f38e0ab2a29a)) that specifies the [**XML namespace**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) for use in [**XPath**](#gt_9ec9a242-d5db-4c3b-8aeb-61708ee75045) expressions. + +###### Schema + +The **Schema element** specifies an [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) associated with an [**XML map**](#gt_01b93f1f-ca62-4216-82d5-b6154e925c9f). The contents of this element MUST be an [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +**ID:** An **ST_Xstring65535** that specifies the unique name for this attached XML schema. + +**Namespace:** An **ST_Xstring65535** that specifies the [**XML namespace**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) used by the XML schema. + +**SchemaRef:** An **ST_Xstring65535** that specifies the other **Schema elements** in this parent **MapInfo element** (section [2.1.7.22.1.1](#Section_a7ea1bde730c4ef3bc9379f78f793aab)) that contain XML schemas that the XML schema for this **Schema element** is dependent on. The value MUST specify the dependent **Schema** elements by **ID** in a space-delimited list. The **SchemaRef** attribute MUST be absent or the value MUST be empty if there are no dependencies. + +###### Map + +The **Map element** specifies an [**XML map**](#gt_01b93f1f-ca62-4216-82d5-b6154e925c9f) and the behaviors expected during [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) operations. + +**Append:** An **ST_XmlMapBoolean** (section [2.1.7.22.2.2](#Section_67ff54e278704f6f8994eb2432722d8e)) that specifies whether [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) data overwrites or is appended to the [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) or [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells associated with the XML map on refresh. + +**AutoFit:** An **ST_XmlMapBoolean** that specifies whether columns are resized to fit the XML data after a refresh operation. + +**ID:** An **ST_XmlMapId** (section [2.1.7.22.2.3](#Section_f5c694496137446f8e60c2d6454482ef)) that specifies the identifier of the XML map. + +**Name:** An **ST_Xstring256** (section [2.1.7.22.2.5](#Section_6e4faeb05d3649918607f6165a328d56)) that specifies the name of the XML map. **Name** MUST be unique for each **Map**. + +**PreserveFormat:** An **ST_XmlMapBoolean** that specifies whether [**number formats**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) in the [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) are preserved during refresh or whether the number formats specified by the [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) are used. + +**PreserveSortAFlayout:** An **ST_XmlMapBoolean** that specifies whether to reapply the [**filtering state**](#gt_23b8e882-6774-4028-924c-74fffbb370f8) of the table after a refresh. + +**RootElement:** An **ST_Xstring65535** (section [2.1.7.22.2.4](#Section_5e49634084e34b73af72f38e0ab2a29a)) that specifies the name of the root XML element. + +**SchemaID:** An **ST_Xstring65535** that specifies the name of the XML schema used for the XML map. **SchemaID** MUST equal the **ID** attribute of a **Schema** element (section [2.1.7.22.1.2](#Section_085d058b1173411ead93fddbd822f781)) contained within the parent **MapInfo** element (section [2.1.7.22.1.1](#Section_a7ea1bde730c4ef3bc9379f78f793aab)). + +**ShowImportExportValidationErrors:** An **ST_XmlMapBoolean** that specifies whether validation errors are displayed during refresh or data export. + +###### DataBinding + +The **DataBinding element** specifies a connection to an [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) file [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) that is used when the [**XML map**](#gt_01b93f1f-ca62-4216-82d5-b6154e925c9f) is refreshed. + +**DataBindingLoadMode:** An **ST_DataBindingLoadMode** (section [2.1.7.22.2.1](#Section_7c8660087ce84de883e29a0404a6fc0c)) that specifies the method for loading XML data. + +**DataBindingName:** An **ST_Xstring65535** that specifies the name for this connection. **DataBindingName** MUST be unique for each **DataBinding** element. + +**FileBinding:** An **ST_Xstring65535** that specifies the XML file data source used for [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060). **FileBinding** MUST NOT be "true" or "false". + +**FileBindingName:** An **ST_Xstring65535** that specifies the name for the XML file data source. **FileBindingName** MUST be unique for each **DataBinding** element. + +##### Simple Types + +The following table specifies the [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae) simple types that are specific to the **XML Stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)): + +| Element | Description | +|----|----| +| **ST_DataBindingLoadMode** (section [2.1.7.22.2.1](#Section_7c8660087ce84de883e29a0404a6fc0c)) | This simple type specifies the method for loading [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) data related to a **DataBinding** element (section [2.1.7.22.1.4](#Section_53d6d872ee4849689d06365efeb5b416)). | +| **ST_XmlMapBoolean** (section [2.1.7.22.2.2](#Section_67ff54e278704f6f8994eb2432722d8e)) | This simple type specifies Boolean values. | +| **ST_XmlMapId** (section [2.1.7.22.2.3](#Section_f5c694496137446f8e60c2d6454482ef)) | This simple type is an integral value that specifies the identifier of an **XML map** (section [2.1.7.22.1.3](#Section_82224f3b936a44cbbec1b0992d1a1281)) in the **XML Stream** (section 2.1.7.22). | +| **ST_Xstring65535** (section [2.1.7.22.2.4](#Section_5e49634084e34b73af72f38e0ab2a29a)) | This simple type is a string that MUST NOT exceed 65,535 [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters. | +| **ST_Xstring256** (section [2.1.7.22.2.5](#Section_6e4faeb05d3649918607f6165a328d56)) | This simple type is a string that MUST NOT exceed 256 Unicode characters. | + +###### ST_DataBindingLoadMode + +The **ST_DataBindingLoadMode** simple type specifies the method for loading [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) data related to a **DataBinding** element (section [2.1.7.22.1.4](#Section_53d6d872ee4849689d06365efeb5b416)). + +The following are possible enumeration values for this type: + +| **Enumeration Value** | **Description** | +|-----------------------|-----------------| +| 0 | None. | +| 1 | Normal. | +| 2 | Delay Load. | +| 3 | Asynchronous. | +| 4 | Object Model. | + +###### ST_XmlMapBoolean + +The **ST_XmlMapBoolean** simple type defines **Boolean** values (section [2.5.14](#boolean)). + +The following are possible enumeration values for this type: + +| **Enumeration Value** | **Description** | +|-----------------------|----------------------| +| false | False Boolean value. | +| true | True Boolean value. | + +###### ST_XmlMapId + +The **ST_XmlMapId** simple type is an integral value that specifies the identifier of an **XML map** (section [2.1.7.22.1.3](#Section_82224f3b936a44cbbec1b0992d1a1281)) in the **XML Stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)). **ST_XmlMapId** MUST be greater than or equal to 1 and less than or equal to 2147483647. + +###### ST_XmlString65535 + +The **ST_XmlString65535** simple type is a string that MUST NOT exceed 65,535 [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters. + +###### ST_XmlString256 + +The **ST_XmlString256** simple type is a string that MUST NOT exceed 256 [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters. + +## Conceptual Overview + +This section specifies how higher-level features of the file format are represented by combinations of records. + +### Cell Table + +Text, formulas, and numerical data within [**workbooks**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) are primarily stored in the cells that make up **worksheets** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) and **macro sheets** (section [2.1.7.20.4](#Section_0dddd943f77a4fc2bf92868acb4587f7)). Cells are the fundamental building blocks that contain data, formulas, and formatting to form the workbook. The data structure associated with the grid of cells is called the **cell table**. + +The cell table is stored in the sequence of records that conform to the **CELLTABLE** rule (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)) within the Common Productions [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The cell table consists of a series of row blocks. From the first row containing data to the last row containing data, every 32 consecutive rows, including blank rows, comprise a row block. + +The number of row blocks in a [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) is specified by the following algorithm that uses fields from the **Dimensions** record (section [2.4.90](#dimensions)): + +213. if ((rwMac –rwMic) % 32 == 0) + + number of row blocks = (rwMac –rwMic) / 32 + + else + + number of row blocks = (rwMac –rwMic) / 32 + 1 + +Within each row block, a **Row** record (section [2.4.221](#row)) is saved for each row that contains data or row formatting. For each such row, every [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that contains data or individual cell formatting is represented by a record. Formatting information for a cell can be derived from individual cell formatting, row formatting, column formatting, or the default cell format as specified by the **XFIndex** structure (section [2.5.282](#xfindex)). The order of precedence for formatting is individual cell formatting with the highest precedence, followed by row formatting, and then column formatting, and then the default cell format. Cells that do not contain data and do not contain individual formatting are not saved. + +Cells are specified by any of the records specified in the **CELL** rule (section 2.1.7.20.6). Multiple cells can be represented by one record—for example, a **MulBlank** record (section [2.4.174](#mulblank)) specifies a series of blank cells. Note that blank cells are only included when they contain individual cell formatting. Rows are saved in increasing order, and cells are saved in row-major order. + +The order of the records that comprise a row block begins with a series of **Row** records (a maximum of 32 such records), followed by the records representing the cells, followed by the **DBCell** record (section [2.4.78](#dbcell)). A cell in the cell table is referred to by its row and column indexes, which are zero-based. The maximum row index is 65535. The maximum column index is 255. + +The bounding box of the non-empty cells is stored in the **Dimensions** record. Information that applies to each column is specified in the **COLUMNS** collection (section 2.1.7.20.6). + +#### Retrieval of Last-Calculated Cell Values Without Loading Cell Table + +The only way to retrieve formulas, formats and other cell data is to read the cell table normally as defined earlier. However, in certain situations (for example when resolving external references to values) it is beneficial to retrieve only the last calculated value from a cell, without actually loading the cell table. To improve the performance of a random read access to the values in the **cell table** (section [2.2.1](#Section_d690007dd25c4822a650b24c13288bb7)), [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) provides **Index** (section [2.4.144](#index)) and **DBCell** (section [2.4.78](#dbcell)) records. To find a particular [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) value, an application can perform the following: + +1. Read **Index** records to find one such that the cell row is greater or equal to **rwMic** and less than **rwMac**. + +2. Compute the data offset of the required **DBCell** record according to the description of the **Index** record. + +3. Read the **DBCell** record (section 2.4.78) in the obtained position, and compute the data offset of the cell row according to the following: + + 1. The file position of the first non-empty **Row** (section [2.4.221](#row)) in a row block is equal to the file position of the **DBCell** record ─the **dbRtrw** field of **DBCell** record. + + 2. The file position of the first **CELL** record (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)) for the first non-empty **Row** (section 2.4.221) is equal to the file position of the second **Row** record (the end of the first **Row** record) + **rgdb\[0\]**. Other non-empty **CELL** records for the first row follow this first **CELL** record. + + 3. The file position of the first **CELL** record for the second non-empty **Row** is equal to the file position of the first **CELL** record for the first **Row** + **rgdb\[1\]**. Other non-empty **CELL** records for the 2nd row follow this first **CELL** record. + + 4. The file position for the first **CELL** record for the third non-empty **Row** is equal to the file position of the first **CELL** record for the second **Row** + **rgdb\[2\]**. + +4. Read cell table data starting from the previously computed position. + +Note that if the **Row** of the **CELL** record is known, it is possible to calculate the file position of the first **CELL** record of that **Row** first, and then get all the following **CELL** records without going through the first **Row**, the second **Row**, and so on. + +### Formulas + +A formula is sequence of values, cell references, names, functions, or operators in a cell that together produce a new value. **Formulas** are stored in a tokenized representation known as "parsed expressions." In this section, formula is a synonym for parsed expression. A parsed expression is converted into a textual formula at runtime for display and user editing. Cell formulas are specified by the **Formula** record (section [2.4.127](#formula)). Array formulas are specified by the **Array** record (section [2.4.4](#array)). Shared formulas are specified by the **ShrFmla** record (section [2.4.260](#shrfmla)). + +**Formulas** that are part of a [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) as specified in the Shared Workbooks overview (section [2.2.11](#Section_e45a62c4490f4304a09668908b57dacc)) are specified by the **pe**.**rgce** field or the **peOld**.**rgce** field of the **RRDDefName** record (section [2.4.225](#rrddefname)), or by the **xpe**.**rgce** field or the **xpeOld**.**rgce** field of the **RRDChgCell** record (section [2.4.223](#rrdchgcell)). + +A parsed [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) contains a sequence of parse tokens, each of which is either an **operand** token (section [2.2.2.2](#Section_011ec51c5e8742aea0a1f5ee242c1189)), an **operator** token (section [2.2.2.1](#Section_0c6cc754f96f4061a9759d6eae97f8a3)), a **control** token (section [2.2.2.3](#Section_3701f8837bef4eacb0e05ecbf4a23cbd)), a **display** token (section [2.2.2.4](#Section_44ae9bca374542a482095e7ded229789)), or a **mem** token (section [2.2.2.5](#Section_0e7857a5d73a4abaafdaaa3996f562fd)). All tokens are stored as Parse Things (**Ptg** (section [2.5.198.25](#ptg))). + +With the exception of **control** tokens (section 2.2.2.3), **display** tokens (section 2.2.2.4), and **mem** tokens (section 2.2.2.5) that are described in subsequent sections, parsed expressions are stored in **Rgce** (section [2.5.198.104](#rgce)) using Reverse-Polish notation. Reverse-Polish notation is a logical system for the specification of mathematical formulas in which operands are followed by operators. Inside an **Rgce,** the operands and operators are represented by an array of **Ptg** structures (section 2.5.198.25) of variable lengths. The first one or two bytes of a **Ptg** structure (section 2.5.198.25) contain the token type that determines which specific **Ptg** type (section 2.5.198.25) the **Ptg** is, as specified in the **Ptg** structure The remainder of the structure varies according to the token type. + +Evaluation of a formula specified in Reverse-Polish notation is usually based around an evaluation stack. The expression is parsed from beginning to end, and operands are pushed onto the stack as they are encountered. When operators are encountered, the required number of operands is popped from the stack and the result of the operation is pushed back onto the stack. Evaluation begins with an empty stack, and when the evaluation is finished, there will be exactly one value left on the stack. The value is the result of the evaluation. Subsequent subsections refer to a stack as described by this model. + +#### Operator Tokens + +**Unary Operator Tokens** + +**Unary Operator** Tokens specify operations that are performed on the previous element in the grammar specified by **Rgce** (section [2.5.198.104](#rgce)). For example, **PtgPercent** (section [2.5.198.81](#ptgpercent)) divides the last expression on the stack by 100. + +**Binary Operator Tokens** + +**Binary Operator T**okens specify operations that are performed on the previous two elements in the grammar specified by **Rgce**. For example, **PtgIsect** (section [2.5.198.67](#ptgisect)), which intersects the topmost two expressions on the stack. + +#### Operand Tokens + +**Operand** Tokens represent values and references that are used by operators and functions. Operands fall into one of two classes, **reference class** (section [2.2.2.2.2](#Section_a8fde0d5759c437eb385169df8117372)), or **value class** (section [2.2.2.2.1](#Section_9a43cbef26504581af603ff0d876d82a)), depending on what result type the formula expects from the operand. + +##### Value Class + +**Value Class** is the most common type of operand, and represents a single value or array of values. When **Ptg records** (section [2.5.198.25](#ptg)) with reference contents are used by an operator that requires **Value Class** operands, the **Ptg records** can be stored as **Value Class** operands rather than **reference class** (section [2.2.2.2.2](#Section_a8fde0d5759c437eb385169df8117372)) operands. For example, in a formula where the contents of A1 is added to the integer value 1, the value of [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) A1 is pushed onto the stack as a **Value Class** operand **PtgRef** (section [2.5.198.84](#ptgref)) because the subsequent **PtgAdd** operator (section [2.5.198.26](#ptgadd)) requires **Value Class** operands. Arrays are stored in a similar fashion. For example, when adding the array of values {1,2,3,4,5,6}, the values are stored in a **PtgArray** operand (section [2.5.198.32](#ptgarray)). + +##### Reference Class + +When operands are stored as **R**eference **Class** operands, any references contained in the operand are not de-referenced and do not return the underlying value or values. They are pushed onto the stack in reference form. + +#### Control Tokens + +Control Tokens do not perform operations or push values onto the stack. Conditional **C**ontrol Tokens (**PtgAttrIf** (section [2.5.198.36](#ptgattrif)), **PtgAttrChoose** (section [2.5.198.34](#ptgattrchoose)), and **PtgAttrGoto** (section [2.5.198.35](#ptgattrgoto))) are used at runtime to prescribe short-circuit evaluation inside conditional functions and can be ignored when converting parsed expressions into textual formulas. + +#### Display Tokens + +**Display** Tokens, like **C**ontrol Tokens (section [2.2.2.3](#Section_3701f8837bef4eacb0e05ecbf4a23cbd)), do not perform operations or push values onto the stack. **Display** Tokens (**PtgParen** (section [2.5.198.80](#ptgparen) and **PtgAttrSpace** (section [2.5.198.38](#ptgattrspace))) are used at runtime to represent parentheses and space characters in a formula when parsed expressions are converted into textual formulas. **Display** Tokens do not affect the order of operations of the formula. + +#### Mem Tokens + +**Mem** Tokens have two purposes: they cache the results of **reference class expressions** (section [2.2.2.2.2](#Section_a8fde0d5759c437eb385169df8117372)) and they can return the results of **reference class expressions** (section 2.2.2.2.2) as **value class expressions** (section [2.2.2.2.1](#Section_9a43cbef26504581af603ff0d876d82a)). **Mem** Tokens act on **binary-reference-expressions** (section [2.5.198.104](#rgce)) that follow them it in a **mem-area-expression** (section 2.5.198.104). + +#### Formula Elements + +Some **Ptg** records (section [2.5.198.25](#ptg)) require extra data that is not stored in the **Rgce** (section [2.5.198.104](#rgce)). When an **Rgce**contains one or more of these **Ptg** records, the containing formula structure includes an **RgbExtra** (section [2.5.198.103](#rgbextra)) containing the data for those **Ptg** records. The size of these components is specified by the **RgbExtra** structures. The **Ptg** records do not contain an offset into the **RgbExtra** for their data. The **Ptg** records that require a corresponding structure in **RgbExtra** are specified in section 2.5.198.103. + +### Charts + +The following diagram identifies the major aspects of the file format representation of a chart. + +
+ +

Figure 1: High-level structure of a chart

+
+ +The **chart sheet** (section [2.2.3.1](#Section_2c90d75bc92645aa8ff29d4483f51831)) specifies a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)), a graphic that displays data or the relationships between sets of data in a visual form, and a **chart data cache** (section [2.2.3.2](#Section_e21d24e4e71f4fdc81077f0d6a6efa6a)), a local copy of the data that is used if the **chart** data is missing or if links to external [**data sources**](#gt_e091613c-6901-4874-b9b2-27273ead1075) are broken. The **chart** specifies one or two **axis groups** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)), a set of **axes** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)) the **chart** data is plotted against, and the set of **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)), **trendlines** (section [2.2.3.12](#Section_61d74ebc36714d6dbdc0626db604530d)), and **error bars** (section [2.2.3.13](#Section_762a461d0a45474ebd7d5994bb294af2)) specified in the **chart**. Each **axis groups** specifies one to four **chart groups** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) that specify the type of visualization used to display the data. Each **series**, **trendline**, and **error bar** specifies a **chart group** it is associated with. + +#### Chart Sheet + +A **chart sheet** is a set of data and the **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) that displays the data. There are two types of **chart sheets**: embedded **chart sheets**, and chart sheets that are not embedded. + +A **chart sheet** that is not embedded is a separate [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) that is intended to display a **chart**. An embedded **chart sheet** is the logical container for a **chart** displayed on a [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +A **chart sheet** is specified by the **chart sheet substream** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)). + +The **chart sheet substream** for an embedded **chart sheet** is contained within a **worksheet substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). A chart sheet that is not embedded is specified by a **chart sheet substream** that is not contained in another substream. + +The following records and rules specify the significant parts of a **chart sheet**: + +- The **SheetExt** record (section [2.4.259](#sheetext)) specifies properties of the sheet (1) containing the **chart**. If the **chart sheet** is embedded, the **SheetExt** record MUST NOT exist. + +- The **WebPub** record (section [2.4.344](#webpub)) specifies properties of a **chart sheet** that has been published to the web. + +- The sequences of records that conform to the **PAGESETUP** rule (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)) and **BACKGROUND** rule (section 2.1.7.20.6) and the **HFPicture** (section [2.4.138](#hfpicture)), **PrintSize** (section [2.4.204](#printsize)), and **HeaderFooter** (section [2.4.137](#headerfooter)) records specify information about how the **chart** is printed. + +- The **Fbi** (section [2.4.109](#fbi)) and **Fbi2** (section [2.4.110](#fbi2)) records specify properties used for [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) scaling on the **chart**. + +- The **Palette** (section [2.4.188](#palette)) and **ClrtClient** (section [2.4.50](#clrtclient)) records specify properties of the [**color palettes**](#gt_05879d13-b9e0-4333-b96d-63cc3433997e) used in the **chart sheet**. + +- The sequence of records that conforms to the **PROTECTION** rule (section 2.1.7.20.6) and the **WriteProtect** record (section [2.4.350](#writeprotect)) specify [**protection**](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499) settings for the **chart**. If the chart sheet is embedded, the **WriteProtect** record MUST NOT exist. + +- The **SXViewLink** (section [2.4.316](#sxviewlink)), **PivotChartBits** (section [2.4.196](#pivotchartbits)), and **SBaseRef** (section [2.4.242](#sbaseref)) records specify the **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) that is the data source for this **chart**. If the **chart** is not a **Pivot Chart** (section [2.2.3.4](#Section_bed5fbd356f54997bb54b49f04e734b7)) these records MUST be ignored. + +- The sequence of records that conforms to the **OBJECTS** rule (section 2.1.7.20.6) and the **MsoDrawingGroup** record (section [2.4.171](#msodrawinggroup)) specify the drawing objects on the **chart** + +- The sequence of records that conforms to the **CHARTFOMATS** rule (section 2.1.7.20.6) specifies the **chart** that is contained in the **chart sheet**. + +- The sequence of records that conforms to the **SERIESDATA** rule (section 2.1.7.20.6) specifies the **chart data cache** (section [2.2.3.2](#Section_e21d24e4e71f4fdc81077f0d6a6efa6a)). + +- The sequences of records that conform to the **WINDOW** rule (section 2.1.7.20.6) and **CUSTOMVIEW** rule (section 2.1.7.20.6) specify the sheet (1) that contains the **chart**. If the **chart sheet** is not embedded, at least one sequence of records that conform to the **WINDOW** rule MUST exist. If the **chart sheet** is embedded, a sequence of records that conforms to the **WINDOW** rule and **CUSTOMVIEW** rule MUST NOT exist. + +- The sequence of records that conforms to the **CRTMLFRT** rule (section 2.1.7.20.6) specifies **future records** (section [2.1.6](#Section_b660b67822684414839ed1ae9a4e4e85)) for the **chart sheet**. + +#### Chart Data Cache + +A **chart data cache** is a local copy of the data for a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). The **chart data cache** is used if data is missing or if links to external [**data sources**](#gt_e091613c-6901-4874-b9b2-27273ead1075) are broken. + +A **chart data cache** is specified by a sequence of records that conforms to the **SERIESDATA** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +The following records and rules specify the significant parts of a **chart data cache**: + +- The **Dimensions** record (section [2.4.90](#dimensions)) specifies the cells that contain data used by this **chart**. + +- The **SIIndex** record (section [2.4.262](#siindex)) specifies the beginning of a sequence of records that contains a cache of the data for the sequence of records that conforms to a specific **AI** rule (section 2.1.7.20.1) in the **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) and **error bars** (section [2.2.3.13](#Section_762a461d0a45474ebd7d5994bb294af2)). The relationship between the **series** and the chart data cache is specified as follows: + + + +- The first **SIIndex** record in the **chart sheet substream**, which MUST contain a **numIndex** field equal to 0x0001, corresponds to the second sequence of records that conforms to the **AI** rule. + +- The second **SIIndex** record in the **chart sheet substream**, which MUST contain a **numIndex** field equal to 0x0002, corresponds to the third sequence of records that conforms to the **AI** rule. + +- The third **SIIndex** record in the **chart sheet substream**, which MUST contain a **numIndex** field equal to 0x0003, corresponds to the fourth sequence of records that conforms to the **AI** rule. + + + +- The **Number** (section [2.4.180](#number)), **BoolErr** (section [2.4.24](#boolerr)), **Blank** (section [2.4.20](#blank)), and **Label** (section [2.4.148](#label)) records each specify an individual value stored in the cache. Each column in the cache corresponds to a **series** or **error bar**, where the zero-based index of the column, specified by the **cell.col** field in the **Number**, **BoolErr**, **Blank**, or **Label** records, equals the zero-based index of the **Series** record (section [2.4.252](#series-1)) in the collection of **Series** records that corresponds to the **series** or **error bar**. + +The following restrictions apply to the **chart data cache**: + +- The **chart data cache** MUST contain data that corresponds to a sequence of records that conforms to the **AI** rule in a **series** if the corresponding data is not specified in the **chart** or on the same [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) as the **chart**. + +- The **chart data cache** MUST NOT contain data that corresponds to a sequence of records that conforms to the **AI** rule in a **series** if the corresponding data is specified in the **chart** or on the same sheet (1) as the **chart**. + +- The **chart data cache** MUST NOT contain data that corresponds to the third or fourth sequence of records that conforms to the **AI** rule in an **error bar**. + +- If the **ebsrc** field of the **SerAuxErrBar** record (section [2.4.249](#serauxerrbar)) in an **error bar** equals 0x04, the **chart data cache** MUST contain data that corresponds to the second sequence of records that conforms to the **AI** rule in the **error bar**. + +- If the **ebsrc** field of the **SerAuxErrBar** record in an error bar does not equal 0x04, the **chart data cache** MUST NOT contain data that corresponds to the second sequence of records that conforms to the **AI** rule in the **error bar**. + +- The **chart data cache** MUST NOT contain data that corresponds to a **trendline** (section [2.2.3.12](#Section_61d74ebc36714d6dbdc0626db604530d)). + +#### Chart + +A **chart** is a graphic that displays data or the relationships between sets of data in a visual form. A **chart** element is an item within the chart such as an **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)), **legend** (section [2.2.3.8](#Section_1832229b7d1945f488d455e9c07466f0)), **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)), **data point** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)), **data label** (section [2.2.3.11](#Section_cac7f43a3af142f58ff2814c2870427f)), **trendline** (section [2.2.3.12](#Section_61d74ebc36714d6dbdc0626db604530d)), **error bar** (section [2.2.3.13](#Section_762a461d0a45474ebd7d5994bb294af2)), or **data table** (section [2.2.3.14](#Section_69938f61d2e94da3af87e154edcb0d98)). + +A **chart data cache** (section [2.2.3.2](#Section_e21d24e4e71f4fdc81077f0d6a6efa6a)) is specified by a sequence of records that conforms to the **CHARTFOMATS** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +A **chart** can contain the following records and rules that specify the parts of the **chart**: + +- The **Chart** record (section [2.4.45](#chart-2)) specifies the position and size of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)) for a non-embedded chart. + +- The sequence of records that conforms to the **FONTLIST** rule (section 2.1.7.20.1) specifies [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information for the **chart**. + +- The **Scl** record (section [2.4.247](#scl)) specifies the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) of the current view in the window used to display the **chart**. + +- The **PlotGrowth** record (section [2.4.198](#plotgrowth)) specifies font scaling for the text on the **chart**. + +- The sequence of records that conforms to the **FRAME** rule (section 2.1.7.20.1) specifies formatting of the chart area (section 2.2.3.17). + +- The sequence of records that conforms to the **SERIESFORMAT** rule (section 2.1.7.20.1) specifies the **series**, **trendlines**, and **error** on the **chart**. + +- The sequences of records that conform to the **SS** rule (section 2.1.7.20.1) specify properties of the **data labels**, **series**, **data points**, **trendlines**, and **error bars** on the **chart**. These records MUST NOT exist if the **chart sheet substream** contains a **Series** record (section [2.4.252](#series-1)). See the **data label** overview for additional restrictions on these collections of records. + +- The sequences of records that conform to the **DFTTEXT** rule (section 2.1.7.20.1) and **TEXTPROPS** rule (section 2.1.7.20.1) specify default properties of the text in the **chart**. The **DataLabExt** (section [2.4.75](#datalabext)), **StartObject** (section [2.4.267](#startobject)), and **EndObject** (section [2.4.101](#endobject)) records MUST NOT exist in these sequences of records that conform to the **DFTTEXT** rule (section 2.1.7.20.1). + +- The **AxesUsed** record (section [2.4.10](#axesused)) and the sequence of records that conforms to the **AXISPARENT** rule (section 2.1.7.20.1) specify the **axis groups** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)) of the **chart**. + +- The **CrtLayout12A** record (section [2.4.67](#crtlayout12a)) specifies layout information for the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). + +- The sequence of records that conforms to the **DAT** rule (section 2.1.7.20.1) specifies the **data table** for the **chart**. + +- The sequence of records that conforms to the **ATTACHEDLABEL** rule (section 2.1.7.20.1) specifies the chart title. This sequence of records MUST have an **ObjectLink** record (section [2.4.182](#objectlink)) where the **wLinkObj** field has a value of 0x0001. + +- The sequence of records that conforms to the **ATTACHEDLABEL** rule and is preceded by the optional **DataLabExt** record specifies properties of series and data point **data labels**. This sequence of records MUST have an **ObjectLink** record where the **wLinkObj** field has a value of 0x0004. See the **data label** overview for additional information and restrictions on this collection of records. + +- The sequence of records that conforms to the **CRTMLFRT** rule (section 2.1.7.20.1) specifies **future records** (section [2.1.6](#Section_b660b67822684414839ed1ae9a4e4e85)) for the **chart**. + +#### Pivot Chart + +A **Pivot Chart** is a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) that uses a **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) as a [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). The **SXViewLink** (section [2.4.316](#sxviewlink)), **PivotChartBits** (section [2.4.196](#pivotchartbits)), and **SBaseRef** (section [2.4.242](#sbaseref)) records in the **chart sheet** (section [2.2.3.1](#Section_2c90d75bc92645aa8ff29d4483f51831)) specify the **PivotTable**. + +#### Axis Group + +An **axis group** is a set of **axes** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)) that specify a coordinate system, a set of **chart groups** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) that are plotted using these **axes** and the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) that defines where the **axes** are rendered on the **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). + +An **axis group** is specified by a sequence of records that conforms to the **AXISPARENT** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +The following records and rules define the significant parts of an **axis group**: + +- The **AxisParent** record (section [2.4.13](#axisparent)) specifies if the **axis group** is the primary axis group or the secondary axis group on a **chart**. Often the **axes** of the primary **axis group** are displayed to the left and bottom sides of the plot area, while **axes** of the secondary **axis group** are displayed on the right and top sides of the plot area. + +- The **Pos** record (section [2.4.201](#pos)) specifies the position and size of the outer plot area. The outer plot area is the [**bounding rectangle**](#gt_e349a155-0fb9-4ba1-abd4-e363e21abcd1) that includes the **axis** labels, the **axis** titles, and **data table** (section [2.2.3.14](#Section_69938f61d2e94da3af87e154edcb0d98)) of the **chart**. This record MUST be ignored on a secondary **axis group**. + +- The sequences of records that conform to the **IVAXIS** (section 2.1.7.20.1), **DVAXIS** (section 2.1.7.20.1), and **SERIESAXIS** (section 2.1.7.20.1) rules in the collection of records that conform to the **AXES** rule (section 2.1.7.20.1) specify the **axes** of the **axis group**. + +- The sequences of records that conform to the **ATTACHEDLABEL** rule (section 2.1.7.20.1) in the sequence of records that conform to the **AXES** rule specify the **axis** titles of the **axis group**. Each **attached label** (section [2.2.3.15](#Section_9ac44e58af9940f4a99ace470eff0f5a)) MUST contain an **ObjectLink** record (section [2.4.182](#objectlink)) that conforms to the following requirements: + + - The **wLinkObj** field MUST equal to 0x0002, 0x0003, or 0x0007, indicating which **axis** the **axis** title is associated. + + - The **wLinkObj** field MUST specify an **axis** defined in the current **axis group**. + + - The **wLinkObj** field MUST be unique among the other **attached labels** that represent **axis** titles in the same **axis group**. + +- The **PlotArea** record (section [2.4.197](#plotarea)) and the sequence of records that conforms to the **FRAME** rule (section 2.1.7.20.1) in the sequence of records that conform to the **AXES** rule specify the properties of the inner plot area. The inner plot area is the rectangle bounded by the chart **axes**. The **PlotArea** record (section 2.4.197) MUST NOT exist on a secondary **axis group**. + +- The sequences of records that conform to the **CRT** rule (section 2.1.7.20.1) specify the **chart groups** of the **axis group**. + +Because there are many different ways to represent data visually, each representation has specific requirements about the layout of the data and the way it is plotted. This results in restrictions on the combinations of **chart group** types that can be plotted on the same **axis group**, and the combinations of **chart group** types that can be plotted in the same **chart**. + +A **chart** MUST contain one of the following: + +- A single **axis group** that contains a single **chart group** that contains a **Chart3d** record (section [2.4.46](#chart3d)). + +- One or two **axis groups** that each contain a single bubble **chart group**. + +- One or two **axis groups** that each conform to one of the following restrictions on **chart group** type combinations: + + - Zero or one of each of the following **chart group** types: area, column, line, and scatter. + + - Zero or one of each of the following **chart group** types: bar of pie, doughnut, pie, and pie of pie. + + - A single bar **chart group**. + + - A single filled radar **chart group**. + + - A single radar **chart group**. + +In addition to the restrictions on the combinations of **chart group** types that can be plotted on the same **axis group** or **chart**, there are additional restrictions on the **axes** of the **axis group** based on the **chart groups** of the axis group. + +The following restrictions apply to the **axes** of an **axis group**: + +- The **axis group** MUST NOT contain any **axes** if the **axis group** contains a bar of pie, doughnut, pie, or pie of pie **chart group**. + +- The **axis group** MUST contain a [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) or date **axis** if the axis group contains an area, bar, column, filled radar, line, radar, or surface **chart group**. + +- The **axis group** MUST contain an area, bar, column, filled radar, line, radar, or surface **chart group** if the axis group contains a category or date **axis**. + +- The **axis group** MUST contain two value **axes** if and only if all **chart groups** are of type bubble or scatter. + +- The **axis group** MUST contain a series **axis** if and only if the **chart group** attached to the **axis group** is one of the following: + + - An area **chart group** with the **fStacked** field of the **Area** record (section [2.4.2](#area)) equal to 0. + + - A column **chart group** with the **fStacked** field of the **Bar** record (section [2.4.15](#bar)) equal to 0 and the **fCluster** field of the **Chart3d** record equal to 0. + + - A line **chart group** with field **fStacked** of the **Line** record (section [2.4.155](#line)) equal to 0. + + - A surface **chart group**. + + + +- The **chart group** on the **axis group** MUST contain a **Chart3d** record if the **axis group** contains a series **axis**. + +#### Axis + +An **axis** is a line that borders the **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) and provides a frame of reference for measurement. In addition to the **axis** line and its properties, the **axis** also specifies all parts of the **chart** that are associated with the **axis** line, such as the **axis** labels, [**major gridlines**](#gt_2803347c-6396-46a5-9ede-6bef1149b013), [**minor gridlines**](#gt_49980976-6314-43ad-ad51-8d3e55ef4b59), and the [**walls**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c) and [**floor**](#gt_dc38c098-e0d3-4701-9656-5f2cf4d80f29) of the **chart**. + +An **axis** is specified by a sequence of records that conforms to either the **IVAXIS** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)), **DVAXIS** (section 2.1.7.20.1), or **SERIESAXIS** (section 2.1.7.20.1) rules specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +An **axis** has a type as defined by the following table: + +| Type | Specified By | Description | +|----|----|----| +| Category | A sequence of records that conform to the **IVAXIS** that contains an **AxcExt** record (section [2.4.9](#axcext)) with field **fDateAxis** equal to 0. | A [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) **axis** displays a set of category labels that are evenly distributed along the **axis** in a given order. A category axis displays arbitrary text values such as "Qtr1", "Qtr2", and "Qtr3", and cannot display scaled numerical values. | +| Date | A sequence of records that conform to the **IVAXIS** rule that contains an **AxcExt** record with field **fDateAxis** equal to 1. | A date **axis** displays scaled date or time values and can display **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) located at uneven intervals. | +| Series | A sequence of records that conform to the **SERIESAXIS** rule. | A series **axis** displays a set of **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) names that are evenly distributed along the axis. When this **axis** is used, the **data points** of each **series** are plotted in a 3-dimensional space. The **data points** of a single **series** are plotted on a plane identified by the corresponding **series** name on this **axis**. | +| Value | A sequence of records that conform to the **DVAXIS** rule. | A value **axis** displays scaled numeric values. The bubble and scatter **chart groups** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)), which can contain two value axes, distinguish the value **axes** by specifying the **axis** orientation, either horizontal or vertical. | + +The following records and rules define the significant parts of an axis: + +- The **CatSerRange (**section [2.4.39](#catserrange)**)** and **ValueRange** (section [2.4.341](#valuerange)) records specify the scaling properties of the **axis**, the crossing location of the other **axis** in the **axis group** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)), and the direction of the **axis**. + +- The **AxcExt** record specifies if an **axis** is of type category or date and specifies properties of a date **axis**. + +- The **CatLab** record (section [2.4.38](#catlab)) specifies additional properties of the **axis** labels. + +- The **IFmtRecord** record (section [2.4.143](#ifmtrecord)) in the sequence of records that conform to the **AXS** rule (section 2.1.7.20.1) specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) of the **axis** labels. + +- The **Tick** record (section [2.4.327](#tick)) in the sequence of records that conform to the **AXS** rule specifies properties of the **axis** labels, and specifies the [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) and [**minor tick marks**](#gt_c2eb605a-6c5a-427e-8608-f16940de82a6) of the **axis**. + +- The **FontX** record (section [2.4.123](#fontx)) and the sequence of records that conforms to the **TEXTPROPS** rule (section 2.1.7.20.1), in the collection of records that conform to the **AXS** rule, specify the font properties of the **axis** labels. + +- The **AxisLine** (section [2.4.12](#axisline)) and **LineFormat** (section [2.4.156](#lineformat)) record pairs and the sequences of records that conform to the **SHAPEPROPS** rule (section 2.1.7.20.1), in the sequence of records that conform to the **AXS** rule, specify the **axis** line, major gridlines and minor gridlines of the **axis**, and the [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) lines of the walls and floor of the **chart**. The omission of the **AxisLine** and **LineFormat** record pair specifying the axis line results in the **axis** line having default line format properties. The omission of other **AxisLine** and **LineFormat** record pairs results in the corresponding **chart** element being omitted from the **chart**. + +- The **AreaFormat** record (section [2.4.3](#areaformat)) and the collection of records that conform to the **GELFRAME** rule (section 2.1.7.20.1) in the sequence of records that conform to the **AXS** rule specifies the fill format for the walls and floor of the **chart**. If the **wType** field of the **Axis** record (section [2.4.11](#axis-1)) in the **axis** equals 0x0000, these records apply to the walls of the **chart**. If the **wType** field of the **Axis** record in the **axis** equals 0x0001, these records apply to the floor of the **chart**. If the **wType** field of the **Axis** record in the axis equals 0x0002, these records MUST NOT exist. If the **chart sheet substream** does not contain a **Chart3d** record (section [2.4.46](#chart3d)), these records MUST NOT exist. + +- The sequence of records that conforms to the **AXM** rule (section 2.1.7.20.1) specifies the [**display units**](#gt_7d807b62-cff1-4e03-a73f-840844345b83) and the display units label of a value **axis**. + +#### Chart Group + +A **chart group** is a set of one or more **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) that visually represent data in a similar manner and are plotted using the same coordinate system. A **chart group** also includes all parts of the **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) that are associated with the set of **series** and the chart group can specify default properties for the **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) and **data labels** (section [2.2.3.11](#Section_cac7f43a3af142f58ff2814c2870427f)) associated with the **series**. + +Basic **charts** have a single **chart group** because they contain one or more **series** of a single type and all **data points** are plotted using the same coordinates. Complex **charts**, such as combination **charts** that contain multiple **series** of different types or multiple **series** of similar type that are plotted using different sets of **axes** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)), contain multiple **chart groups**. + +A **chart group** specifies a collection of **series** of a common type that share an **axis group** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)) and specifies the **chart** elements that are common to the collection of **series**. + +A **chart group** is specified by a sequence of records that conforms to the **CRT** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +A **chart group** has a type as defined by the following table: + +| Type | Specified By | Description | +|----|----|----| +| Area | A **chart group** that contains an **Area** record (section [2.4.2](#area)). | A **chart group** type in which the **data points** of a **series** are plotted in a line and the region between the line and the horizontal **axis** is filled. | +| Bar | A **chart group** that contains a **Bar** record (section [2.4.15](#bar)) with field **fTranspose** equal to 1. | A **chart group** type in which the **data points** in a **series** are represented as horizontal bars. | +| Bar of pie | A **chart group** that contains a **BopPop** record (section [2.4.25](#boppop)) with field **pst** equal to 0x02. | A **chart group** type that plots **data points** as segments in a circle or bar, where the bar displays the details of the data called out from a single segment of the circle. | +| Bubble | A **chart group** that contains a **Scatter** record (section [2.4.243](#scatter)) with field **fBubbles** equal to 1. | A **chart group** type that is a variation on a scatter chart group type in which the **data points** are represented as bubbles. A bubble chart group type compares three variables. The third variable determines the size of the **data point**. | +| Column | A **chart group** that contains a Bar record (section 2.4.15) with field **fTranspose** equal to 0. | A **chart group** type in which the **data points** in a **series** are represented as vertical bars. | +| Doughnut | A **chart group** that contains a **Pie** record (section [2.4.194](#pie)) with field **pcDonut** not equal to 0x0000. | A **chart group** type in which multiple **series** are represented as concentric rings and the **data points** are represented as segments of the ring. | +| Filled radar | A **chart group** that contains a **RadarArea** record (section [2.4.213](#radararea)). | A **chart group** type that is a variation on a radar group type in which the **data points** in a **series** are connected by a line and the area enclosed by the line is filled. | +| Line | A **chart group** that contains a **Line** record (section [2.4.155](#line)). | A **chart group** type in which **data points** in a **series** are connected by a line. | +| Pie | A **chart group** that contains a **Pie** record (section 2.4.194) with field **pcDonut** equal to 0x0000. | A **chart group** type that plots **data points** as segments (or slices) of a circle. | +| Pie of pie | A **chart group** that contains a **BopPop** record (section 2.4.25) with field **pst** equal to 0x01. | A **chart group** type that plots **data points** as segments (or slices) of two circles, where the secondary circle displays the details of the data called out from a single segment of the primary circle. | +| Radar | A **chart group** that contains a **RadarArea** record (section 2.4.213). | A **chart group** type in which each **data point** in a **series** is plotted along a separate **axis** that starts at the center of the **chart** and extends outward. | +| Scatter | A **chart group** that contains a **Scatter** record (section 2.4.243) with field **fBubbles** equal to 0. | A **chart group** type that displays quantitative values on both horizontal and vertical **axes** to represent two variables as a single **data point**. | +| Surface | A **chart group** that contains a **Surf** record (section [2.4.272](#surf)). | A **chart group** type that shows a three dimensional surface that connects a set of **data points**. | + +The following records and rules define the significant parts of a chart group: + +- The **SeriesList** record (section [2.4.253](#serieslist)) specifies the **series** of the **chart**. This record MUST NOT exist in the first **chart group** in the **chart sheet substream**. This record MUST exist when not in the first **chart group** in the **chart sheet substream**. + +- The **Chart3d** record (section [2.4.46](#chart3d)) specifies that the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c), **axis group** (section 2.2.3.5), and **chart group** are rendered in a 3-D scene, rather than a 2-D scene, and specifies properties of the 3-D scene. If this record exists in the **chart sheet substream**, the **chart sheet substream** MUST have exactly one **chart group**. This record MUST NOT exist in a bar of pie, bubble, doughnut, filled radar, pie of pie, radar, or scatter **chart group**. + +- The sequence of records that conforms to the **LD** rule (section 2.1.7.20.1) specifies the **legend** (section [2.2.3.8](#Section_1832229b7d1945f488d455e9c07466f0)) on the **chart**. The sequence of records that conforms to the **LD** rule (section 2.1.7.20.1) MUST NOT exist in a **chart group** that is not the first **chart group** in the **chart sheet substream**. + +- The sequences of records that conform to the **DROPBAR** rule (section 2.1.7.20.1) specify the [**up-down bars**](#gt_54f291c2-81aa-41b6-8831-88d180a09ea0) on the **chart group**. + +- The **CrtLine** (section [2.4.68](#crtline)) **LineFormat** (section [2.4.156](#lineformat)) record pairs and the sequences of records that conform to the **SHAPEPROPS** rule (section 2.1.7.20.1) specify the [**drop lines**](#gt_e8c745bf-646c-4acd-8b5e-5314fa4965fa), [**high-low lines**](#gt_56aec928-ddcc-4415-9d08-5d1dd3982bbc), [**series lines**](#gt_bda50b03-68fa-49f9-bd9e-d0dc289ac88a), and [**leader lines**](#gt_8b7c448e-82e3-4d22-a8ba-52e0a10b14fa) for the **chart**. + +- The sequences of records that conform to the **DFTTEXT** rule (section 2.1.7.20.1), the **DataLabExtContents** record (section [2.4.76](#datalabextcontents)), and the sequence of records that conforms to the **SS** rule (section 2.1.7.20.1) specify the **data label** and **data point** formatting for the **chart group**. Refer to the **data label** overview for details on the **chart group** **data label**. + +#### Legend + +A **legend** identifies different groupings of information about the **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). A **legend** consists of a set of [**legend entries**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e). Each legend entry, which consists of a [**legend key**](#gt_6981bc96-6d51-425c-9550-63c5b8b08e54) and a text label, identifies either the **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) in the **chart**, the **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) and [**trendlines**](#gt_d5df9e9f-4c24-41e9-a015-44bd67d1a67c) in the **chart**, or the bands on a surface **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)). + +A **legend** is specified by a sequence of records that conforms to an **LD** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) in a **chart group** as specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +A **legend** on a **chart** can contain three types of content: + +- A **legend** can contain legend entries for each of the **series** and trendlines in the **chart**: + + - Each legend entry represents a single **series** or trendline. + + - The legend keys contain the same formatting as the corresponding **series** or trendline. + + - The **legend** text labels contain the name of the corresponding **series** or trendline. + + - This type of **legend** is used when the **chart group** type is not surface and one of the following conditions is satisfied: + + - The **chart** has more than one included **series**. + + - The **chart** has a single included **series**, no **data point** formatting exceptions on the included **series**, and either contains a trendline or contains a **ChartFormat** record (section [2.4.48](#chartformat)) associated with the included **series** that has the **fVaried** field equal to 0 or ignored. + +- A **legend** can contain legend entries for each **data point** in the **chart**: + + - Each legend entry represents a single **data point** on the **chart**. + + - The legend keys contain the same formatting as the corresponding **data point**. + + - The **legend** text labels contain the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) name or horizontal value of the corresponding **data point**. + + - This type of **legend** is used when the **chart group** type is not surface and the conditions for a **legend** that contains legend entries for each of the **series** and trendlines in the **chart** are not satisfied. + +- A **legend** can contain legend entries for each band on a surface **chart group** (which is formatted into different bands based on the value of the surface at any given **data point** in space): + + - Each legend entry represents a single band that represents a range of values on a surface **chart group**. + + - The legend keys contain the same formatting as the corresponding band. + + - The **legend** text labels contain the value range of the corresponding band. + + - This type of **legend** is used when the chart contains a surface **chart group**. + +The following records and rules define the significant parts of a **legend**: + +- The **Legend** record (section [2.4.152](#legend-1)) specifies the layout of the legend and specifies if the **legend** is automatically positioned. + +- The **Pos** record (section [2.4.201](#pos)), **CrtLayout12** record (section [2.4.66](#crtlayout12)), and the sequence of records that conforms to the **CRTMLFRT** rule (section 2.1.7.20.1), specify the position of the **legend**. + +- The sequences of records that conform to the **ATTACHEDLABEL** (section 2.1.7.20.1) and **TEXTPROPS** (section 2.1.7.20.1) rules specify the default text formatting for the legend entries. The **Pos** record of the **attached label** (section [2.2.3.15](#Section_9ac44e58af9940f4a99ace470eff0f5a)) MUST be ignored. The **ObjectLink** record (section [2.4.182](#objectlink)) of the attached label MUST NOT exist. A **series** can specify formatting exceptions for individual legend entries. + + + +- The sequence of records that conforms to the **FRAME** rule (section 2.1.7.20.1) specifies the fill and [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad) properties of the **legend**. + +#### Series + +A **series** is of a set of related **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) that are plotted in a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). In addition to specifying the **data points** of the **series** and the formatting properties of the **data points**, a **series** can also specify a series name and properties of the **data label** (section [2.2.3.11](#Section_cac7f43a3af142f58ff2814c2870427f)) and [**legend entries**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e) that are associated with the **series**. + +A **series** is defined by a sequence of records that conforms to the **SERIESFORMAT** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that contains a **SerToCrt** record (section [2.4.256](#sertocrt)). + +A **series** can either be of type included or excluded. Included **series** are **series** that are shown in the **chart**. Excluded **series** are not shown in the **chart**, but exist as **series** in the file. A **series** is an excluded **series** if both of the following conditions are satisfied: + +- The **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) type of the **series** is bar of pie, pie, or pie of pie. + +- The **series** is not the first **series** in the **chart sheet substream** to be on the **chart group** and contain in the second sequence of records that conform to the **AI** rule (section 2.1.7.20.1) a **BRAI** record (section [2.4.29](#brai)) that contains an **ifmt** field that specifies a **formula** (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that equals to a row or column that is not excluded from the **chart sheet**. + +This occurs when the **chart group** is of type bar of pie, pie, or pie of pie, and the **chart sheet** contains multiple **series**, because these **chart group** types will only display the first **series** of data on the **chart**. + +All other **series** are included **series**. + +The following records and rules define the significant parts of a **series**: + +The **Series** record (section [2.4.252](#series-1)) specifies the type and size of the data in the **series**. + +- The four sequences of records that conform to the **AI** rule specify **formulas**. The meaning of the **formulas** are specified as follows: + + 1. In the first sequence, the value of the **formula** specifies the name of the **series**. The **SeriesText** record (section [2.4.254](#seriestext)) specifies a cache of the name of the **series**. + + 2. In the second sequence, the value of the **formula** specifies: + + - A set of coordinates along the vertical value **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)) if the series is in a bubble or scatter **chart group**. + + - A set of coordinates along the value **axis** if the series is in any other **chart group** type. + + 3. In the third sequence, the value of the **formula** specifies: + + - A set of coordinates along a horizontal value **axis** if the **series** is in a bubble or scatter **chart group**. + + - A set of [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) **axis** labels that are distributed evenly along the category **axis** based on their order in the set or a set of dates along a date **axis** is in any other **chart group** type. + + 4. In the fourth sequence of records, the value of the **formula** specifies a set of scalar values used in a bubble **chart group** to define the size of the bubbles. + +- The sequence of records that conform to the **SS** rule (section 2.1.7.20.1) specify the **data point** and **data label** properties for a **series** or individual **data points** of the **series**. If formatting is not specified for an individual **data point**, the **data point** inherits the formatting of the series. If formatting is not specified for the **series**, the **series** inherits the formatting of the **chart group** that contains the **series**. The **yi** field of the **DataFormat** record (section [2.4.74](#dataformat)) MUST specify the zero-based index of the **Series** record associated with this **series** in the collection of all **Series** records in the current **chart sheet substream** that contains the **series**. Refer to the **data label** overview for an explanation of the **data label** and the conditions on this collection of records. + +- The **SerToCrt** record (section 2.4.256) specifies the **chart group** that contains the current **series**. + +- The **LegendException** record (section [2.4.153](#legendexception)) specifies a legend entry in the **legend** (section [2.2.3.8](#Section_1832229b7d1945f488d455e9c07466f0)) that corresponds to the **series**. If the **LegendException** record (section 2.4.153) specifies that the legend entry has non-default formatting, then the **attached label** (section [2.2.3.15](#Section_9ac44e58af9940f4a99ace470eff0f5a)) and the sequence of records that conforms to the **TEXTPROPS** rule (section 2.1.7.20.1) that follow the **LegendException** (section 2.4.153) and **Begin** (section [2.4.17](#begin)) records specify the custom formatting of the legend entry. If the **fLabel** field of **LegendException** equals 0, the **attached label** MUST NOT exist. + +#### Data Point + +A **data point** is a value plotted in a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) and visually displayed as shapes, such as bars, columns and markers, as specified by the **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) type of the **chart**. + +A **data point** consists of a set of three values located on the same index of the second to fourth sequences of records that conform to the **AI** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) contained in the **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) of the **data point**. For example, the set of three values for a **data point** in a bubble **chart group** consists of a coordinate of the **data point** along the vertical value **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)), the coordinate of the **data point** along the horizontal value **axis**, and the scalar value that defines the [**bubble size**](#gt_3a0cf938-5b61-4460-bdbb-3540d84d4180) of the **data point**. + +#### Data Label + +A **data label** is a label on a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) that is associated with a **data point** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)), or associated with a **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) on an area or filled radar **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)). A **data label** contains information about the associated **data point**, such as the description of the **data point**, a [**legend key**](#gt_6981bc96-6d51-425c-9550-63c5b8b08e54), or custom text. + +**Inheritance** + +For any given **data point**, there is an order of inheritance that determines the contents of a **data label** associated with the **data point**: + +- **Data labels** can be specified for a **chart group**, specifying the default setting for the **data labels** associated with the **data points** on the **chart group**. + +- **Data labels** can be specified for a **series**, specifying the default setting for the **data labels** associated with the **data points** of the **series**. This type of **data label** overrides the **data label** properties specified on the **chart group** for the **data labels** associated with the **data points** in a given **series**. + +- **Data labels** can be specified for a **data point**, specifying the settings for a **data label** associated with a particular **data point**. This type of **data label** overrides the **data label** properties specified on the **chart group** and **series** for the **data labels** associated with a given **data point**. + +**Records** + +The set of records that specifies a **data label**, and the requirements that exist on these records, differ if the **data label** is specified for a **chart group**, **series**, or **data point**. The set of records that represent a **data label** are as follows: + +- For a **chart group**, properties of a data label are specified by the following collections of records that are specified in the **chart group**: + + 1. The sequence of records that conforms to the **DFTTEXT** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)). + + 2. The **DataLabExtContents** record (section [2.4.76](#datalabextcontents)) that is not contained in the sequence of records that conforms to the **LD** rule (section 2.1.7.20.1) or the sequence of records that conforms to the **DFTTEXT** rule. + + 3. The **AttachedLabel** record (section [2.4.5](#attachedlabel)) that is contained in the sequence of records that conforms to the **SS** rule (section 2.1.7.20.1). + +- For a **series** or **data point**, properties of a data label are specified by the following collections of records that are specified in the **chart**: + + 1. The **attached label** (section [2.2.3.15](#Section_9ac44e58af9940f4a99ace470eff0f5a)) that corresponds to the **series** or **data point**. The **attached label** that corresponds to a **series** or **data point** appears in the **chart sheet substream** (section 2.1.7.20.1) after the **axis group** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)) and is specified by the following properties of the **attached label**: + + 1. The **wLinkObj** field of the **ObjectLink** record (section [2.4.182](#objectlink)) equals 0x0004. + + 2. The **wLinkVar1** field of the **ObjectLink** record equals the index to the corresponding **series**. + + 3. The **wLinkVar2** field of the **ObjectLink** record equals the index to the corresponding **data point** or equals 0xFFFF for a corresponding **series**. + + 2. The **AttachedLabel** record (section 2.4.5) that corresponds to the **series** or **data point**. The **AttachedLabel** record that corresponds to a **series** or **data point** appears in the sequence of records that conforms to the **SS** rule that has the following properties: + + 1. The **yi** field of the **DataFormat** record (section [2.4.74](#dataformat)) equals the index to the corresponding **series**. + + 2. The **xi** field of the **DataFormat** record equals the index to the corresponding **data point** or equals 0xFFFF for a corresponding **series**. + +**Overrides** + +Some properties of the records that specify the contents of a **data label** can overlap and conflict. For the information that overlaps between these records, there is a set of rules that specifies the relationships between these records and specifies the fields that need to be ignored in conflict situations. + +In general, properties of the **DataLabExtContents** record (section 2.4.76) of the **data label** override properties of the **Text** record (section [2.4.324](#text)) of the of the **data label**, which overrides the properties of the **AttachedLabel** record of the **data label**. Details of the relationships between individual fields are specified in the records. + +The following section provides an explanation of how to interpret the **data label** and when the different records that specify the **data label** are relevant to the **data label**. + +On a **data label** associated with a **chart group**: + +- When the **chart group** has a data label, the following algorithm determines the **data label** contents. Once the set of records that represents the **data label** has been established, the data label information that overlaps across records is respected on the **DataLabExtContents** record and ignored on the **Text** and **AttachedLabel** records of the **data label**. In this algorithm, [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) rules are used to specify the sequence of records that conform to the rule. In this algorithm, "DFTTEXT with id" specifies the sequence of records that conforms to the **DFTTEXT** rule that contains a **DefaultText** record (section [2.4.88](#defaulttext)) with and **id** field equal to the value specified. + +217. //Define variables + + X equals a DataLabExtContents record + + Y equals a DataLabExtContents record + + SS equals an to AttachedLabel record + + SWAP equals a boolean + + //Initialize SWAP + + SET SWAP equal to FALSE + + //Initialize SS + + SET SS equal to AttachedLabel record in the sequence of records that conforms to + + the SS rule + + //Initialize X + + IF DFTTEXT with id field equal to 0 exists + + IF DFTTEXT with id field equals to 0 has a DataLabExtContents record + + SET X equal to DataLabExtContents record in DFTTEXT with id field equal to + + 0 + + ELSE + + IF chart group type equals area or filled radar + + SET field fSerName of X equal to field fShowLabel of Text record in + + DFTTEXT with id field equal to 0 + + SET field fCatName of X equal to 0 + + ELSE + + SET field fCatName of X equal to field fShowLabel of Text record in + + DFTTEXT with id field equal to 0 + + SET field fSerName of X equal to 0 + + END IF + + SET field fValue of X equal to field fShowValue of Text record in DFTTEXT + + with id field equal to 0 + + SET field fPercent of X equal to field (fShowPercent OR fShowLabelAndPerc) + + of Text record in DFTTEXT with id field equal to 0 + + SET field fBubSizes of X equal to field fShowBubbleSizes of Text record in + + DFTTEXT with id field equal to 0 + + SET field RgchSet of X equal to NULL + + END IF + + ELSE + + SET field fCatName of X equal 1 + + SET fields fSerName, fValue, fPercent, fBubSizes of X equal to 0 + + SET field RgchSet of X equal to NULL + + END IF + + //Initialize Y + + IF DFTTEXT with id field equal to 1 exists + + IF DFTTEXT with id field equals to 1 has a DataLabExtContents record + + SET Y equal to DataLabExtContents record in DFTTEXT with id field equal to + + 1 + + ELSE + + IF chart group type equals area or filled radar + + SET field fSerName of Y equal to field (fShowLabel OR + + fShowLabelAndPerc)of Text record in DFTTEXT with id field equal to + + 1 + + SET field fCatName of Y equal to 0 + + ELSE + + SET field fCatName of Y equal to field (fShowLabel OR + + fShowLabelAndPerc) of Text record in DFTTEXT with id field equal to + + 1 + + SET field fSerName of Y equal to 0 + + END IF + + SET field fValue of Y equal to field fShowValue of Text record in DFTTEXT + + with id field equal to 1 + + SET field fPercent of Y equal to field (fShowPercent OR fShowLabelAndPerc) + + of Text record in DFTTEXT with id field equal to 1 + + SET field fBubSizes of Y equal to field fShowBubbleSizes of Text record in + + DFTTEXT with id field equal to 1 + + SET field RgchSet of X equal to NULL + + END IF + + ELSE + + SET field fValue of Y equal to 1 + + SET fields fCatName, fSerName, fPercent, fBubSizes of Y equal to 0 + + SET field RgchSet of X equal to NULL + + END IF + + //Modify X, Y, and SS + + IF (field fCatName of X equals 1) AND (fields fSerName, fValue, fPercent, AND + + fBubSizes of X equal 0) + + IF (field fShowValue of SS equals 1) AND (fields fShowPercent, + + fShowLabelAndPerc, fShowLabel, fShowBubbleSizes, AND fShowSeriesName of + + SS equal 0) + + IF (field fValue of Y equals 1) AND (fields fSerName, fCatName, + + fPercent, OR fBubSizes of Y equal 1) + + SET SWAP equals to TRUE + + SET field fValue of X equal to 1 + + SET fields fSerName, fCatName, fPercent, AND fBubSizes of X equal + + to 0 + + SET field fShowValue of SS equal to field fValue of Y + + SET field fShowPercent of SS equal to field fSPercent of Y + + SET field fShowLabel of SS equal to field fCatName of Y + + SET field fShowBubbleSizes of SS equal to field fBubSizes of Y + + SET field fShowSeriesName of SS equal to field fSerName of Y + + END IF + + ELSE + + IF ((field fShowPercent of SS equals 1) AND (field fShowBubbleSizes of + + SS equals 0)) OR ((field fShowPercent of SS equals 0) AND (field + + fShowBubbleSizes of SS equals 1)) AND (fields fShowLabelAndPerc, + + fShowLabel, fShowValue, AND fShowSeriesName of SS equal 0) + + SET SWAP equals to TRUE + + SET field fValue of X equal to 1 + + SET fields fSerName, fCatName, fPercent, AND fBubSizes of X equal + + to 0 + + SET field fShowValue of SS equal to field fValue of Y + + SET field fShowPercent of SS equal to field fSPercent of Y + + SET field fShowLabel of SS equal to field fCatName of Y + + SET field fShowBubbleSizes of SS equal to field fBubSizes of Y + + SET field fShowSeriesName of SS equal to field fSerName of Y + + ELSE + + IF (field fShowLabel of SS equals 1) AND (fields fShowPercent, + + fShowLabelAndPerc, fShowValue, fShowBubbleSizes, AND + + fShowSeriesName of SS equal 0) + + IF chart group type equals area or filled radar + + SET field fSerName of X equal to 1 + + SET fields fCatName, fValue, fPercent, AND fBubSizes equal + + to 0 + + SET field fShowValue of SS to 1 + + SET fields fShowPercent, fShowLabelAndPerc, fShowLabel, + + fShowBubbleSize, and fShowSeriesName of SS to 0 + + END IF + + SET field fValue of Y equals to 1 + + SET fields fSerName, fCatName, fPercent, AND fBubSizes of Y + + equal to 0 + + ELSE + + IF fields fShowLabel, fShowPercent, fShowLabelAndPerc, + + fShowValue, fShowBubbleSizes, AND fShowSeriesName of SS + + equal 0 + + IF chart group type equals area or filled radar + + SET fields fShowLabel of SS to 1 + + SET fields fShowPercent, fShowLabelAndPerc, fShowValue, + + fShowBubbleSize, and fShowSeriesName of SS to 0 + + END IF + + SET field fValue of Y equals to 1 + + SET fields fSerName, fCatName, fPercent, AND fBubSizes of Y + + equal to 0 + + END IF + + END IF + + END IF + + END IF + + ELSE + + IF (field fValue of Y equals 1) AND (fields fSerName, fCatName, fPercent, + + AND fBubSizes of Y equal 0) + + IF fields fShowLabel, fShowPercent, fShowLabelAndPerc, fShowValue, + + fShowBubbleSizes, AND fShowSeriesName of SS equal 0 + + IF (chart group type equals area or filled radar) AND (field + + fSerName of X equals 1) AND (fields fCatName, fValue, fPercent, + + AND fBubSizes of X equal 0) + + SET field fShowSeriesName of SS to 1 + + SET fields fShowPercent, fShowLabelAndPerc, fShowValue, + + fShowBubbleSize, and fShowLabel of SS to 0 + + ELSE + + SET field fCatName of X equals to 1 + + SET fields fSerName, fValue, fPercent, AND fBubSizes of X equal + + to 0 + + END IF + + ELSE + + IF (field fShowValue of SS equals 1) AND (fields fShowLabel, + + fShowPercent, fShowLabelAndPerc, fShowBubbleSizes, AND + + fShowSeriesName of SS equal 0) + + SET field fCatName of X equals to 1 + + SET fields fSerName, fValue, fPercent, AND fBubSizes of X equal + + to 0 + + ELSE + + SET field fShowValue of SS equal to field fValue of X + + SET field fShowPercent of SS equal to field fSPercent of X + + SET field fShowLabel of SS equal to field fCatName of X + + SET field fShowBubbleSizes of SS equal to field fBubSizes of X + + SET field fShowSeriesName of SS equal to field fSerName of X + + END IF + + END IF + + END IF + + END IF + + //Determine if X or Y is used + + IF (field fShowValue of SS equals 1) AND (fields fShowLabel, fShowPercent, + + fShowLabelAndPerc, fShowBubbleSizes, AND fShowSeriesName of SS equal 0) + + IF (SWAP equals FALSE) + + IF DFTTEXT with id field equal to 1 exists + + SET the data label equal to DFTTEXT with id field equal to 1 + + ELSE + + SET the data label equal to the default formatting properties + + END IF + + SET the DataLabExtContents record of the data label equal to Y + + ELSE + + IF DFTTEXT with id field equal to 0 exists + + SET the data label equal to DFTTEXT with id field equal to 0 + + ELSE + + SET the data label equal to the default formatting properties + + END IF + + SET the DataLabExtContents record of the data label equal to X + + END IF + + ELSE + + IF (SWAP equals FALSE) + + IF DFTTEXT with id field equal to 0 exists + + SET the data label equal to DFTTEXT with id field equal to 0 + + ELSE + + SET the data label equal to the default formatting properties + + END IF + + SET the DataLabExtContents record of the data label equal to X + + ELSE + + IF DFTTEXT with id field equal to 1 exists + + SET the data label equal to DFTTEXT with id field equal to 1 + + ELSE + + SET the data label equal to the default formatting properties + + END IF + + SET the DataLabExtContents record of the data label equal to Y + + END IF + + END IF + +On a **data label** associated with a **series** or **data point**: + +- The **attached label** specifies an exception on the **data label** and indicates that the current **data label** differs from the **data label** inherited from the **chart group** for a **series**, or from the **chart group** and **series** for a **data point**. The **attached label** of the **data label** contains a **Text** record and can contain a **DataLabExtContents** record. + +- On a **data label** associated with a **data point**, when the **attached label** exists and contains a **BRAI** record (section [2.4.29](#brai)) with field **formula** not equal to 0x0000, the **formula** field specifies the contents of the **data label**. + +- On a **data label** associated with a **data point**, when the **attached label** exists and contains a **SeriesText** record (section [2.4.254](#seriestext)) and a **BRAI** record with field **formula** equal to 0x0000, the **SeriesText** record specifies the contents of the **data label**. + +- When the **attached label** exists and contains a **DataLabExtContents** record, the **data label** information specified by the **DataLabExtContents** record that overlaps across records is respected, and the information contained in the **Text** and **AttachedLabel** records of the **data label** that overlaps is ignored. + +- When the **attached label** exists and does not contain a **DataLabExtContents** record, the **data label** specified by the **Text** record that overlaps across records is respected, and the information contained in the **AttachedLabel** record of the **data label** that overlaps is ignored. + +- When the **data label** does not specify an **attached label**, the **AttachedLabel** record of the **data label** specifies the content properties of the **data label**. + +**Restrictions** + +The following requirements and restrictions exist on different parts of the collections of records that represent the **data label**. + +If the **chart group** contains a **data label**: + +- The **chart group** SHOULD[\<13\>](#Appendix_A_13) contain two sequences of records that conform to the **DFTTEXT** rule that have the same records with the same field values. + +- If the **chart group** contains a **DataLabExtContents** record, the **DataLabExtContents** record in the sequences of records that conform to the **DFTTEXT** rule on the chart group and the **DataLabExtContents** record that is not specified in the sequences of records that conform to the **DFTTEXT** rule on the chart group SHOULD[\<14\>](#Appendix_A_14) contain the same field values. + +- If the **chart group** contains a sequence of records that conforms to the **DFTTEXT** rule the following restrictions apply: + + - The **fShowValue** field of the **AttachedLabel** record SHOULD[\<15\>](#Appendix_A_15) equal the **fShowValue** field of the **Text** record in the sequence of records that conforms to the **DFTTEXT** rule. + + - The **fShowPercent** field of the **AttachedLabel** record SHOULD[\<16\>](#Appendix_A_16) equal the **fShowPercent** field of the **Text** record in the sequence of records that conforms to the **DFTTEXT** rule. + + - The **fShowLabelAndPerc** field of the **AttachedLabel** record SHOULD[\<17\>](#Appendix_A_17) equal the **fShowLabelAndPerc** field of the **Text** record in the sequence of records that conforms to the **DFTTEXT** rule. + +#### Trendline + +A **trendline** is a straight or curved line that graphically represents the general trend of the **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) of a **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)). In addition to specifying the data and formatting properties of the line, the **trendline** name and the **trendline** label can also be specified in the **trendline**. + +A trendline is defined by a sequence of records that conforms to the **SERIESFORMAT** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that contains a **SerAuxTrend** record (section [2.4.250](#serauxtrend)). + +The following records and rules define the significant parts of a **trendline**: + +- The **SeriesText** record (section [2.4.254](#seriestext)) in the first sequence of records that conforms to the **AI rule** (section 2.1.7.20.1) specifies a custom **trendline** name to display in the **legend** (section [2.2.3.8](#Section_1832229b7d1945f488d455e9c07466f0)). + +- The sequence of records that conforms to the **SS** rule (section 2.1.7.20.1) specifies the formatting properties of the **trendline**. The **yi** field of the **DataFormat** record (section [2.4.74](#dataformat)) MUST specify the zero-based index of the **Series** record (section [2.4.252](#series-1)) associated with this **trendline** in the collection of all **Series** records in the current **chart sheet substream**. Each **trendline** MUST contain zero or one sequences of records that conform to the **SS** rule. + +- The **SerParent** record (section [2.4.255](#serparent)) specifies the **series** associated with the **trendline**. + +- The **SerAuxTrend** record specifies properties of the **trendline**, such as the **trendline** type and the number of periods to [**forecast**](#gt_0a5478cf-8836-4a9a-a663-7684366646a3) forward and backward, and specifies properties of the content of the **trendline** label. + +- The **LegendException** record (section [2.4.153](#legendexception)) specifies the formatting of the [**legend entry**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e) in the **legend** (section 2.2.3.8) that corresponds to the **trendline**. This record is specified if the legend entry has been deleted or does not use the default formatting of the **legend**. When the legend entry has non-default formatting, the **attached label** (section [2.2.3.15](#Section_9ac44e58af9940f4a99ace470eff0f5a)) that follows the **LegendException** record and **Begin** records (section [2.4.17](#begin)) specifies the custom formatting of the legend entry. + +The following restrictions apply to a **trendline**: + +- All fields except the **cValx** and **cValy** fields in the **Series** record (section 2.4.252) MUST be ignored. The **cValy** and **cValx** fields in the **Series** records MUST be greater than 0. + +- The **BRAI** records (section [2.4.29](#brai)) in the sequence of records that conforms to the **AI** rule (section 2.1.7.20.1) MUST be ignored and the **ifmt** field of the **BRAI** records MUST equal 0x0000. + +#### Error Bar + +An **error bar** is a set of lines displayed on a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) that indicates a range of uncertainty in the measurement of each **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) in a **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)). + +An **error bar** is specified by a sequence of records that conforms to the **SERIESFORMAT** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that contains a **SerAuxErrBar** record (section [2.4.249](#serauxerrbar)). + +The following records and rules define the significant parts of an **error bar**: + +- The sequence of records that conforms to the **SS** rule (section 2.1.7.20.1) specifies the formatting properties of the **error bar**. The **yi** field of the **DataFormat** record (section [2.4.74](#dataformat)) MUST specify the zero-based index of the **Series** record (section [2.4.252](#series-1)) associated with this **error bar** in the collection of all **Series** record in the current **chart sheet substream**. Each **error bar** MUST contain zero or one sequences of records that conform to the **SS** rule. + +- The **SerParent** record (section [2.4.255](#serparent)) specifies the **series** associated with the **error bar**. + +- The **SerAuxErrBar** record specifies properties of the **error bar**, including the direction and type of the **error bar**. + +The following restrictions apply to **error bars**: + +- All fields except the **cValx** and **cValy** fields in the **Series** record MUST be ignored. + +- The **cValx** field MUST equal the **cValx** field of the **Series** record in the associated **series** specified by the **SerParent** record. + +- If the **ebsrc** field of the **SerAuxErrBar** record equals 0x04 and the **sertm** field of the **SerAuxErrBar** equals 0x01 or 0x02, the **cValx** field MUST equal the number of values represented by the **formula** field of the second **BRAI** record (section [2.4.29](#brai)) in the sequence of records that conforms to the **AI** rule (section 2.1.7.20.1). + +- If the **ebsrc** field of the **SerAuxErrBar** record equals 0x04 and the **sertm** field of the **SerAuxErrBar** equals 0x03 or 0x04, the **cValy** field MUST equal the number of values represented by the **formula** field of the second **BRAI** record in the sequence of records that conforms to the **AI** rule. + +- If the **ebsrc** field of the **SerAuxErrBar** record does not equal 0x04, the **cValy** field MUST equal the **cValy** field of the **Series** record in the associated **series** specified by the **SerParent** record. + +- The **BRAI** records in the first, third, and fourth sequences of records that conform to the **AI** rule MUST be ignored and the **ifmt** field of the **BRAI** records MUST equal 0x0000. + +- If the **ebsrc** field of the **SerAuxErrBar** record equals 0x04, the **ifmt** field of the **BRAI** records contained in the second collection of records that conform to the **AI** rule specifies a **Formula** (section [2.4.127](#formula)) that specifies custom values of the **error bar**. + +- If the **ebsrc** field of the **SerAuxErrBar** record equals 0x04, the **BRAI** records in the second sequence of records that conforms to the **AI** rule MUST be ignored and the **ifmt** field of the **BRAI** records MUST equal 0x0000. + +- The **LegendException** record (section [2.4.153](#legendexception)) in the **chart sheet substream** MUST NOT exist. + +#### Data Table + +A [**data table (2)**](#gt_9e13d7ee-50d6-40ae-8789-29ecafe24bd4) is a table on a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) that contains a row for each **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) and lists the values of each **data point** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) on the **chart**. + +A data table (2) is specified by a sequence of records that conforms to a **DAT** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) as specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +The following records and rules define the significant parts of a data table (2): + +- The **Dat** record (section [2.4.73](#dat)) specifies if the data table (2) shows [**legend keys**](#gt_6981bc96-6d51-425c-9550-63c5b8b08e54) next to the name of the **series** and specifies which data table (2) borders are displayed. + +- The sequences of records that conform to the **ATTACHEDLABEL** (section 2.1.7.20.1) and **TEXTPROPS** (section 2.1.7.20.1) rules in the sequence of records that conforms to the **LD** rule (section 2.1.7.20.1) specify the text formatting for the data table (2). The **Pos** record (section [2.4.201](#pos)) of the **attached label** (section [2.2.3.15](#Section_9ac44e58af9940f4a99ace470eff0f5a)) MUST be ignored. The **ObjectLink** record (section [2.4.182](#objectlink)) of the **attached label** MUST NOT exist. + +- The sequence of records that conforms to the **FRAME** rule (section 2.1.7.20.1) in the sequence of records that conforms to the **LD** rule specifies the formatting properties of the data table (2). + +The following restrictions apply to the collection of records that represents a data table (2): + +- The **fWasDataTable** field of the **Legend** record (section [2.4.152](#legend-1)) in the sequence of records that conforms to the **LD** rule MUST equal 1. + +- The **Pos** record in the sequence of records that conforms to the **LD** rule MUST be ignored. A data table (2) is automatically positioned. + +- The **CrtLayout12** record (section [2.4.66](#crtlayout12)) and the sequence of records that conforms to the **CRTMLFRT** rule (section 2.1.7.20.1), in the sequence of records that conforms to the **LD** rule, MUST NOT exist in a data table (2). + +A data table (2) is not displayed on a **chart** if the **chart** contains a bar of pie, bubble, doughnut, filled radar, pie, pie of pie, radar, or scatter **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)). + +#### Attached Label + +An **attached label** is a generic text element that is used on a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). An **attached label** can specify properties of an **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)) title, **chart** title, **data label** (section [2.2.3.11](#Section_cac7f43a3af142f58ff2814c2870427f)), **data table** (section [2.2.3.14](#Section_69938f61d2e94da3af87e154edcb0d98)), [**display units**](#gt_7d807b62-cff1-4e03-a73f-840844345b83) label, **legend** (section [2.2.3.8](#Section_1832229b7d1945f488d455e9c07466f0)), [**legend entry**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e), **trendline** (section [2.2.3.12](#Section_61d74ebc36714d6dbdc0626db604530d)) label, or the default text properties of the entire **chart**. + +The location of the **attached label** in the **chart sheet substream** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) and the properties of the **ObjectLink** record (section [2.4.182](#objectlink)) of the **attached label** specify the **chart** element to which the **attached label** applies. Refer to the **conceptual overviews** (section [2.2.3](#Section_3e15a76353f14118a8f45f4e42a981c2)) for explanation of the meaning of the **attached label** in each context that it is used. + +An **attached label** is specified by a collection of records that conforms to an **ATTACHEDLABEL** rule (section 2.1.7.20.1) as specified by the **chart sheet substream** (section 2.1.7.20.1) ABNF. + +- The **Text** record (section [2.4.324](#text)) and the collection of records that conforms to the **TEXTPROPS** rule (section 2.1.7.20.1) specify properties of the text in the **attached label**. These properties include text options such as text rotation and reading order. On **attached labels** that represent **data labels**, the **Text** record also specifies content and layout properties of the **data labels**. + +- The **Pos** (section [2.4.201](#pos)) and **CrtLayout12** (section [2.4.66](#crtlayout12)) records specify the position of the **attached label** on the **chart**. The **Pos** record MUST be ignored if the **attached label** represents the **data labels** on a **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) or **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)), a **data table**, the default text of the **chart**, or a [**legend key**](#gt_6981bc96-6d51-425c-9550-63c5b8b08e54). + +- The **FontX** (section [2.4.123](#fontx)) and **AlRuns** (section [2.4.1](#alruns)) records specify the font and rich text formatting properties of the **attached label**. + +- The collection of records that conforms to the **AI** rule (section 2.1.7.20.1) specifies custom text of the **attached label**. + +- The collection of records that conforms to the **FRAME** rule (section 2.1.7.20.1) specifies the fill and border properties of the **attached label**. + +- The **ObjectLink** record specifies the **chart** element the **attached label** applies to. + +- The **DataLabExtContents** record (section [2.4.76](#datalabextcontents)) specifies additional **data label** properties on **attached labels** that represent a **data label**. Refer to the **data label** overview for the conditions when this record can be written. This record MUST NOT exist unless the **attached label** specifies properties of a **data label**. An **attached label** specifies properties of a **data label** if the **wLinkObj** field of the **ObjectLink** record is equal to 0x0004 or the attached label is in the collection of records that conforms to the **DFTTEXT** rule (section 2.1.7.20.1) in a **chart group**. + +- The collection of records that conforms to the **CRTMLFRT rule** (section 2.1.7.20.1) specifies **future records** (section [2.1.6](#Section_b660b67822684414839ed1ae9a4e4e85)) for the **attached label**. + +#### SPRC + +A **SPRC** is a unit of measurement that is 1/4000th of the height or width of the **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). If the field is being used to specify a width or horizontal distance, the **SPRC** is 1/4000th of the width of the **chart**. If the field is being used to specify a height or vertical distance, the **SPRC** is 1/4000th of the height of the **chart**. + +#### Chart Area + +For non-embedded **charts**, the size of the area is specified by the **Chart** record (section [2.4.45](#chart-2)) in points. For embedded **charts**, the **chart** is treated as a drawing and its size is calculated from the **OfficeArtClientAnchorSheet** record (section [2.5.193](#officeartclientanchorsheet)) that is contained in the **MsoDrawing** (section [2.4.170](#msodrawing)) preceding the **chart** stream. The **chart area** calculation is as follows: + +1\. Get **chart area width in pixels** + +**chart area width in pixels** = (dx field of **Chart** record - 8) \* DPI of the display device / 72 for non-embedded **charts**. + +**chart area width in pixels** is calculated from individual cell widths/heights that anchor the **chart** as indicated by **OfficeArtClientAnchorSheet** (section 2.5.193) for embedded charts. + +If the **frt** field of the **Frame** record (section [2.4.128](#frame)) following the **Chart** record (section 2.4.45) is 0x0004 and the **chart** is not embedded, add the shadow size: + +**chart area width in pixels** -= 2 \* line width of the display device in pixels + +2\. Get **chart area height in pixels** + +**chart area height in pixels** = (dy field of **Chart** record - 8) \* DPI of the display device / 72 for non-embedded **charts**. + +**chart area height in pixels** is calculated from individual cell widths/heights that anchor the **chart** as indicated by **OfficeArtClientAnchorSheet** (section 2.5.193) for embedded charts. + +If the **frt** field of the **Frame** record (section 2.4.128) following the **Chart** record (section 2.4.45) is 0x0004 and the **chart** is not embedded, add the shadow size: + +**chart area height in pixels** -= 2 \* line height of the display device in pixels + +### Metadata + +**Metadata** is additional data associated with a particular [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) or its content. **Metadata** is recorded in [**BIFF8**](#gt_e60b71bb-c66c-4a44-ab07-0f9f20ee3dd5) for future extensibility purpose only. + +
+ +

Figure 2: Metadata

+
+ +The following sections define terms used in this diagram. + +#### Metadata Types + +The architecture of the metadata allows for multiple types of metadata. + +Each type of metadata has an associated collection of metadata records, a unique name, and a set of predefined properties. Those properties describe whether the metadata remains associated with the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) or its content during runtime operations (for example, insert, shift, copy/paste, merge, or unmerge operations), as well as whether the metadata is **cell metadata** (section [2.2.4.2](#Section_c925f5199fe14b6ab01807fa18351e68)) or **value metadata** (section [2.2.4.3](#Section_e78bf5ba22754bad8e6cf4f59644efa6)). + +A metadata type is represented by an **MDTInfo** record (section [2.4.162](#mdtinfo)). + +#### Cell Metadata + +**Cell metadata** is metadata associated with a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) itself. **Cell metadata** is not represented in [**BIFF8**](#gt_e60b71bb-c66c-4a44-ab07-0f9f20ee3dd5) format. + +#### Value Metadata + +**Value metadata** is metadata associated with the value of a particular [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). **Value metadata** is associated with a cell through a **formula** (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing a single special function, \_xlfn.COMPOUNDVALUE, whose single mandatory argument references a **metadata block** record (section [2.2.4.4](#Section_9fd157237cbe4334b4d10f23e3ed706c))[\<18\>](#Appendix_A_18). + +The only **value metadata** type represented in [**BIFF8**](#gt_e60b71bb-c66c-4a44-ab07-0f9f20ee3dd5) is **MDX metadata** (section [2.2.4.5](#Section_0f7583182c0b4155bf75c7399f89305c)). + +#### Metadata Block + +Cells are associated with actual metadata values using a metadata mapping table known as a **metadata block**. A **metadata block** contains a collection of indexes to metadata records, along with the corresponding **metadata types** (section [2.2.4.1](#Section_bbefb91d7be44ea69e2e707bae2c69ab)). + +A **metadata block** is represented by an **MDB record** (section [2.4.161](#mdb)). + +#### MDX Metadata + +The only type of metadata used is [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) metadata. + +The **MDTInfo** record (section [2.4.162](#mdtinfo)) that specifies the **metadata type** (section [2.2.4.1](#Section_bbefb91d7be44ea69e2e707bae2c69ab)) for MDX metadata MUST have the following values: + +| Field | Value | +|--------------------------|:-------:| +| **fGhostRow** | 0 | +| **fGhostCol** | 0 | +| **fEdit** | 0 | +| **fDelete** | 0 | +| **fCopy** | 1 | +| **fPasteAll** | 1 | +| **fPasteFormulas** | 0 | +| **fPasteValues** | 1 | +| **fPasteFormats** | 0 | +| **fPasteComments** | 0 | +| **fPasteDataValidation** | 0 | +| **fPasteBorders** | 0 | +| **fPasteColWidths** | 0 | +| **fPasteNumberFormats** | 0 | +| **fMerge** | 1 | +| **fSplitFirst** | 1 | +| **fSplitAll** | 0 | +| **fRowColShift** | 1 | +| **fClearAll** | 0 | +| **fClearFormats** | 1 | +| **fClearContents** | 0 | +| **fClearComments** | 1 | +| **fAssign** | 1 | +| **fCoerce** | 1 | +| **fAdjust** | 0 | +| **fCellMeta** | 0 | +| **stName** | "XLMDX" | + +An MDX metadata record references the connection name and the [**cube function**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3) used or referenced in a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +There are four types of MDX metadata records: **MDX tuple metadata** (section [2.2.4.5.1](#Section_277444ebcca34128b302b39de79eeb41)), **MDX set metadata** (section [2.2.4.5.2](#Section_84d4d0b542b6405ea07be3272dc517f8)), **MDX member property metadata** (section [2.2.4.5.3](#Section_722f7e05ca3e4a20b30fbbed1a597e88)), and **MDX KPI metadata (**section [2.2.4.5.4](#Section_db8664f2502b43d2aa88274035b52570)**)**. + +##### MDX Tuple Metadata + +An [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**tuple**](#gt_e64f7e8a-c55b-47dc-9c6e-2afe5f13d448) is the intersection between two or more [**members (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) from different [**dimensions (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c). + +MDX tuple metadata is used by [**cube functions**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3) returning a member (2) or a value. + +MDX tuple metadata is represented by an **MDXTuple** record (section [2.4.167](#mdxtuple)). + +##### MDX Set Metadata + +An [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) set is an ordered collection of [**members (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) within the same [**dimension (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c). + +MDX set metadata is used by [**cube functions**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3) returning a set or the number of items in a set. + +MDX set metadata is represented by an **MDXSet** record (section [2.4.165](#mdxset)). + +##### MDX Member Property Metadata + +An [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**member property**](#gt_c7ddc1fa-c564-42c5-b755-aed72a0cb000) represents the property value of a [**member (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11). + +MDX member property metadata references a member (2) name and a property name. + +MDX member property metadata is represented by an **MDXProp** record (section [2.4.164](#mdxprop)). + +##### MDX KPI Metadata + +An [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**key performance indicator (KPI)**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) represents the KPI property value of a KPI [**member (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11). + +MDX KPI metadata references a KPI name, a KPI property, and a member (2) name. + +MDX KPI metadata is represented by an **MDXKPI** record (section [2.4.163](#mdxkpi)). + +### PivotTables + +A PivotTable is a mechanism for summarizing **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) to get an overview of the distribution of that data. In a PivotTable, applicable columns of the **source data** become fields that can be used to summarize data. + +When the **source data** of the **PivotTable** is [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) **source data**, [**OLAP hierarchies**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) and some other OLAP entities become fields in the PivotTable. + +A PivotTable has two major parts, a **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) and a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). These parts are described in the following sections. There can be multiple **PivotTable views** based on a single non-**OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)). An **OLAP PivotCache** MUST have exactly one **associated PivotTable view** (section [2.2.5.3.3](#Section_855483943345473bb926de5189fd664d)). + +The values produced by a PivotTable are placed in cells of a [**sheet (2)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and these cells make up a PivotTable report. + +The PivotTable structures are not needed to obtain values from a **PivotTable** report because those values are available in the sheet (2) cells. The structures are needed for the following purposes: + +- To show extra information related to a PivotTable report in an application, such as sort and filter information. + +- To recalculate a **PivotTable view**, to incorporate changes such as sorting and filtering made to it, and to update the corresponding **PivotTable** report accordingly. + +- To refresh a **PivotCache**, to incorporate changes made to the **source data**, and then recalculate any **PivotTable views** associated with the **PivotCache** and to update the corresponding **PivotTable** reports accordingly. + +#### PivotTable Records + +For general information about records see section [2.1](#Section_2e6147d9e8ad48b09ff7bbfc51ca950d). **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) uses records from the **Worksheet Substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)), the **Globals Substream** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)), and the [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) in the **Pivot Cache Storage (\_SX_DB_CUR)** (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)). + +Concepts specified for **PivotTables** can have multiple sequences of records specifying them. The sequences can be in different streams or substreams. In these cases additional information is specified for the concept in the **PIVOTFRT9** rule (section 2.1.7.20.5) or by **SXAddl** records (section [2.4.273.2](#sxaddl)). See the individual records, the **QsiSXTag** record (section [2.4.211](#qsisxtag)) and section [2.2.5.1.1](#Section_db61fa8bdb7b4e1c99615c2f3ed1c369) for more information about how the additional information is connected to the concept. + +##### Usage of SXAddl Records + +The **SXAddl** records (section [2.4.273.2](#sxaddl)) is a record used for storing additional **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)), **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) or [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) information of a variety of types. + +**SXAddl** records have an **hdr** field of type **SXAddlHdr** (section [2.5.253](#sxaddlhdr)) that specifies the current **class** (section [2.2.5.1.1.1](#Section_3450b26af2b247dd982c6b9eb2d448b0)) and the full type of record, see section 2.2.5.1.1.1 for details. The full record type specifies the meaning of the **data** field of the **SXAddl** record. + +###### Class + +All **SXAddl** records (section [2.4.273.2](#sxaddl)) are grouped into classes. Each **SXAddl** record has a current class. An **SXAddl** record can be in other classes as well. The different classes and their specifications follow. + +Unless the value of the **hdr.sxc** field of **SXAddl** is 0x09 and the value of the **hdr.sxd** field of **SXAddl** is 0xFF, the **hdr.sxc** field of the **SXAddl** record specifies the current class and MUST be a value from the following table: + +| Name | Value | Current Class | +|----|----|----| +| sxcView | 0x00 | **SxcView** class (section [2.2.5.1.1.1.1](#Section_a17d6dc32db74ec4b3cbeded2b7126c3)) | +| sxcField | 0x01 | **SxcField** class (section [2.2.5.1.1.1.2](#Section_51de615365d949198b2a537779e0a9f7)) | +| sxcHierarchy | 0x02 | **SxcHierarchy** class (section [2.2.5.1.1.1.3](#Section_6167aeb40d774815b3218d3f117c438d)) | +| sxcCache | 0x03 | **SxcCache** class (section [2.2.5.1.1.1.4](#Section_1681856cae2d4f64b8cc40d2702754e7)) | +| sxcCacheField | 0x04 | **SxcCacheField** class (section [2.2.5.1.1.1.5](#Section_102acda2fb58485d9a40a37d0a219103)) | +| sxcQsi | 0x05 | **SxcQsi** class (section [2.2.5.1.1.1.6](#Section_953f8be387154b688af387eef7855f27)) | +| sxcQuery | 0x06 | **SxcQuery** class (section [2.2.5.1.1.1.7](#Section_78ae192deccb4971bc9b33e46f7ab527)) | +| sxcGrpLevel | 0x07 | **SxcGrpLevel** class (section [2.2.5.1.1.1.8](#Section_86689e7b9d264225b6be580f86cea53e)) | +| sxcGroup | 0x08 | **SxcGroup** class (section [2.2.5.1.1.1.9](#Section_664bdb47dfb148b69cbd2d9b6bc48600)) | +| sxcCacheItem | 0x09 | **SxcCacheItem** class (section [2.2.5.1.1.1.10](#Section_23b4298b5a8e4357b2c07c2ea90d91c5)) | +| sxcSxrule | 0x0C | **SxcSXRule** class (section [2.2.5.1.1.1.11](#Section_dd12edef6e8747379bed6f4ceff33127)) | +| sxcSxfilt | 0x0D | **SxcSXFilt** class (section [2.2.5.1.1.1.12](#Section_22611924dd5649078c7ab385cd2ccdc0)) | +| sxcSxdh | 0x10 | **SxcSXDH** class (section [2.2.5.1.1.1.13](#Section_284c3ab876c54d36961f1e0006764807)) | +| sxcAutoSort | 0x12 | **SxcAutoSort** class (section [2.2.5.1.1.1.14](#Section_212512d2c740431f838b7ec651364e2f)) | +| sxcSxmgs | 0x13 | **SxcSXMgs** class (section [2.2.5.1.1.1.15](#Section_7081e96f74c24e339021305d28e3da1a)) | +| sxcSxmg | 0x14 | **SxcSXMg** class (section [2.2.5.1.1.1.16](#Section_7a80fae6884c401f8ecab68064099425)) | +| sxcField12 | 0x17 | **SxcField12** class (section [2.2.5.1.1.1.17](#Section_4bd42ced53544e2ea2665ea9f7787a85)) | +| sxcSxcondfmts | 0x1A | **SxcSXCondFmts** class (section [2.2.5.1.1.1.18](#Section_fdd787b53b0e43f888b9c86cb063a54f)) | +| sxcSxcondfmt | 0x1B | **SxcSXCondFmt** class (section [2.2.5.1.1.1.19](#Section_59cc4e9903ad43f395985be87afdcc92)) | +| sxcSxfilters12 | 0x1C | **SxcSXFilters12** class (section [2.2.5.1.1.1.20](#Section_38fb61e517e742219ea43f1e5a665bc2)) | +| sxcSxfilter12 | 0x1D | **SxcSXFilter12** class (section [2.2.5.1.1.1.21](#Section_9b54e335ef8846d28d19dfbfe2078154)) | + +The current **class** and the **hdr.sxd** field of **SXAddl** specify the full type of the record, see the individual **classes** for details. + +If the value of the **hdr.sxc** field of **SXAddl** is 0x09 and the value of the **hdr.sxd** field of **SXAddl** is 0xFF, then the current **class** is specified by **SxcCacheField** class and the full record type is **SXAddl_SXCCacheItem_SXDEnd** (section [2.4.273.20](#sxaddl_sxccacheitem_sxdend)). + +**Classes** can be nested inside other **classes** in a hierarchical manner as specified by the **Globals Substream** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) [**Augmented Backus-Naur Form (ABNF)**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), **Worksheet Substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) ABNF, and **Common Productions** (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)) ABNF. Properties from the outer **classes** apply to the inner **classes** unless otherwise specified. Records in **classes** nested inside other **classes**, are [**members (1)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) of both the inner and outer **classes**, but their current **class** is given by the value of their **hdr.sxc** field. For example, **SXAddl_SXCHierarchy_SXDProperty** (section [2.4.273.57](#sxaddl_sxchierarchy_sxdproperty)) is a member (1) of the **SxcView** class and the **SxcHierarchy** class and its current **class** is the **SxcHierarchy** class. + +####### SxcView Class + +The **SxcView** class specifies additional information for a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +The **SxcView** class is specified by the sequence of records specified by the **PIVOTADDL** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The **PivotTable view** that the **SxcView** class specifies information for is specified by the **stName** field of the **SXAddl_SXCView_SXDId** record (section [2.4.273.105](#sxaddl_sxcview_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCVIEW (0x00), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCView_SXDId** | +| sxdVerUpdInv | 0x01 | **SXAddl_SXCView_SXDVerUpdInv** (section [2.4.273.110](#sxaddl_sxcview_sxdverupdinv)) | +| sxdVer10Info | 0x02 | **SXAddl_SXCView_SXDVer10Info** (section [2.4.273.108](#sxaddl_sxcview_sxdver10info)) | +| sxdCalcMember | 0x03 | **SXAddl_SXCView_SXDCalcMember** (section [2.4.273.100](#sxaddl_sxcview_sxdcalcmember)) | +| sxdCalcMemString | 0x0A | **SXAddl_SXCView_SXDCalcMemString** (section [2.4.273.101](#sxaddl_sxcview_sxdcalcmemstring)) | +| sxdVer12Info | 0x19 | **SXAddl_SXCView_SXDVer12Info** (section [2.4.273.109](#sxaddl_sxcview_sxdver12info)) | +| sxdTableStyleClient | 0x1E | **SXAddl_SXCView_SXDTableStyleClient** (section [2.4.273.107](#sxaddl_sxcview_sxdtablestyleclient)) | +| sxdCompactRwHdr | 0x21 | **SXAddl_SXCView_SXDCompactRwHdr** (section [2.4.273.103](#sxaddl_sxcview_sxdcompactrwhdr)) | +| sxdCompactColHdr | 0x22 | **SXAddl_SXCView_SXDCompactColHdr** (section [2.4.273.102](#sxaddl_sxcview_sxdcompactcolhdr)) | +| sxdSxpiIvmb | 0x26 | **SXAddl_SXCView_SXDSXPIIvmb** (section [2.4.273.106](#sxaddl_sxcview_sxdsxpiivmb)) | +| sxdEnd | 0xFF | **SXAddl_SXCView_SXDEnd** (section [2.4.273.104](#sxaddl_sxcview_sxdend)) | + +####### SxcField Class + +The **SxcField** class specifies additional information for a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). + +The **SxcField** class is specified by the sequence of records specified by the **SXADDLFIELD** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The **pivot field** that the **SxcField** class specifies information for is specified by the **stName** field of the **SXAddl_SXCField SXDId** record (section [2.4.273.26](#sxaddl_sxcfield_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCFIELD (0x01), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCField SXDId** | +| sxdVer10Info | 0x02 | **SXAddl_SXCField_SXDVer10Info** (section [2.4.273.27](#sxaddl_sxcfield_sxdver10info)) | +| sxdEnd | 0xFF | **SXAddl_SXCField_SXDEnd** (section [2.4.273.25](#sxaddl_sxcfield_sxdend)) | + +####### SxcHierarchy Class + +The **SxcHierarchy** class specifies additional information for a **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)). + +The **SxcHierarchy** class is specified by the sequence of records specified by the **SXADDLHIERARCHY** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The **pivot hierarchy** (section 2.2.5.4.5) that the **SxcHierarchy** class specifies information for is specified by the **stHierUnq** field of the **SXAddl_SXCHierarchy_SXDId** record (section [2.4.273.47](#sxaddl_sxchierarchy_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals sxcHierarchy (0x02), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCHierarchy_SXDId** | +| sxdVerUpdInv | 0x01 | **SXAddl_SXCHierarchy_SXDVerUpdInv** (section [2.4.273.60](#sxaddl_sxchierarchy_sxdverupdinv)) | +| sxdProperty | 0x05 | **SXAddl_SXCHierarchy_SXDProperty** (section [2.4.273.57](#sxaddl_sxchierarchy_sxdproperty)) | +| sxdFilterMember | 0x09 | **SXAddl_SXCHierarchy_SXDFilterMember** (section [2.4.273.44](#sxaddl_sxchierarchy_sxdfiltermember)) | +| sxdSxSetParentUnique | 0x1D | **SXAddl_SXCHierarchy_SXDSXSetParentUnique** (section [2.4.273.58](#sxaddl_sxchierarchy_sxdsxsetparentunique)) | +| sxdUserCaption | 0x1F | **SXAddl_SXCHierarchy_SXDUserCaption** (section [2.4.273.59](#sxaddl_sxchierarchy_sxdusercaption)) | +| sxdIconset | 0x20 | **SXAddl_SXCHierarchy_SXDIconSet** (section [2.4.273.46](#sxaddl_sxchierarchy_sxdiconset)) | +| sxdMeasureGrp | 0x24 | **SXAddl_SXCHierarchy_SXDMeasureGrp** (section [2.4.273.55](#sxaddl_sxchierarchy_sxdmeasuregrp)) | +| sxdDisplayFolder | 0x25 | **SXAddl_SXCHierarchy_SXDDisplayFolder** (section [2.4.273.42](#sxaddl_sxchierarchy_sxddisplayfolder)) | +| sxdParentKPI | 0x26 | **SXAddl_SXCHierarchy_SXDParentKPI** (section [2.4.273.56](#sxaddl_sxchierarchy_sxdparentkpi)) | +| sxdKPIValue | 0x27 | **SXAddl_SXCHierarchy_SXDKPIValue** (section [2.4.273.53](#sxaddl_sxchierarchy_sxdkpivalue)) | +| sxdKPIGoal | 0x28 | **SXAddl_SXCHierarchy_SXDKPIGoal** (section [2.4.273.49](#sxaddl_sxchierarchy_sxdkpigoal)) | +| sxdKPIStatus | 0x29 | **SXAddl_SXCHierarchy_SXDKPIStatus** (section [2.4.273.50](#sxaddl_sxchierarchy_sxdkpistatus)) | +| sxdKPITrend | 0x2A | **SXAddl_SXCHierarchy_SXDKPITrend** (section [2.4.273.52](#sxaddl_sxchierarchy_sxdkpitrend)) | +| sxdKPIWeight | 0x2B | **SXAddl_SXCHierarchy_SXDKPIWeight** (section [2.4.273.54](#sxaddl_sxchierarchy_sxdkpiweight)) | +| sxdKPITime | 0x2C | **SXAddl_SXCHierarchy_sxdKPITime** (section [2.4.273.51](#sxaddl_sxchierarchy_sxdkpitime)) | +| sxdFilterMember12 | 0x3F | **SXAddl_SXCHierarchy_sxdFilterMember12** (section [2.4.273.45](#sxaddl_sxchierarchy_sxdfiltermember12)) | +| sxdInfo12 | 0x41 | **SXAddl_SXCHierarchy_SXDInfo12** (section [2.4.273.48](#sxaddl_sxchierarchy_sxdinfo12)) | +| sxdEnd | 0xFF | **SXAddl_SXCHierarchy_SXDEnd** (section [2.4.273.43](#sxaddl_sxchierarchy_sxdend)) | + +####### SxcCache Class + +The **SxcCache** class specifies additional information for a **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)). + +The **SxcCache** class is specified by the sequence of records specified by the **SXADDLCACHE** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The **PivotCache** that the **SxcCache** class specifies information for is specified by the **idCache** field of the **SXAddl_SXCCache_SXDId** record (section [2.4.273.6](#sxaddl_sxccache_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCCACHE (0x03), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| SxdId | 0x00 | **SXAddl_SXCCache_SXDId** | +| SxdVerUpdInv | 0x01 | **SXAddl_SXCCache_SXDVerUpdInv** (section [2.4.273.11](#sxaddl_sxccache_sxdverupdinv)) | +| SxdVer10Info | 0x02 | **SXAddl_SXCCache_SXDVer10Info** (section [2.4.273.9](#sxaddl_sxccache_sxdver10info)) | +| SxdVerSxMacro | 0x18 | **SXAddl_SXCCache_SXDVerSXMacro (**section [2.4.273.10](#sxaddl_sxccache_sxdversxmacro)**)** | +| SxdInvRefreshReal | 0x34 | **SXAddl_SXCCache_SXDInvRefreshReal** (section [2.4.273.8](#sxaddl_sxccache_sxdinvrefreshreal)) | +| SxdInfo12 | 0x41 | **SXAddl_SXCCache_SXDInfo12** (section [2.4.273.7](#sxaddl_sxccache_sxdinfo12)) | +| sxdEnd | 0xFF | **SXAddl_SXCCache_SXDEnd** (section [2.4.273.5](#sxaddl_sxccache_sxdend)) | + +####### SxcCacheField Class + +The **SxcCacheField** class specifies additional information for a **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)). + +The **SxcCacheField** class is specified by the sequence of records specified by the **SXADDLCACHEFIELD** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). + +The **cache field** that the **SxcCacheField** class specifies information for is specified by the **stSourceName** field of the **SXAddl_SXCCacheField_SXDId** record (section [2.4.273.14](#sxaddl_sxccachefield_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCCACHEFIELD (0x04), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCCacheField_SXDId** | +| sxdProperty | 0x05 | **SXAddl_SXCCacheField_SXDProperty** (section [2.4.273.17](#sxaddl_sxccachefield_sxdproperty)) | +| sxdSxrmitmCount | 0x2D | **SXAddl_SXCCacheField_SXDSxrmitmCount** (section [2.4.273.19](#sxaddl_sxccachefield_sxdsxrmitmcount)) | +| sxdCaption | 0x2F | **SXAddl_SXCCacheField_SXDCaption** (section [2.4.273.12](#sxaddl_sxccachefield_sxdcaption)) | +| sxdIfdbMempropMap | 0x30 | **SXAddl_SXCCacheField_SXDIfdbMempropMap** (section [2.4.273.15](#sxaddl_sxccachefield_sxdifdbmempropmap)) | +| sxdIfdbMpMapCount | 0x31 | **SXAddl_SXCCacheField_SXDIfdbMpMapCount** (section [2.4.273.16](#sxaddl_sxccachefield_sxdifdbmpmapcount)) | +| sxdPropName | 0x40 | **SXAddl_SXCCacheField_SXDPropName** (section [2.4.273.18](#sxaddl_sxccachefield_sxdpropname)) | +| sxdEnd | 0xFF | **SXAddl_SXCCacheField_SXDEnd** (section [2.4.273.13](#sxaddl_sxccachefield_sxdend)) | + +Additionally, **SXAddl_SXCCacheItem_SXDEnd** has a current class of **SxcCacheField** class, as specified in section [2.2.5.1.1.1](#Section_3450b26af2b247dd982c6b9eb2d448b0). + +####### SxcQsi Class + +The **SxcQsi** class specifies additional information for a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289). + +The **SxcQsi** class is specified by the sequence of records specified by the **SXADDLQSI** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The query table that the **SxcQsi** class specifies information for is specified by **stName** field of the **SXAddl_SXCQsi_SXDId** record (section [2.4.273.62](#sxaddl_sxcqsi_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCQSI (0x05), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCQsi_SXDId** | +| sxdEnd | 0xFF | **SXAddl_SXCQsi_SXDEnd** (section [2.4.273.61](#sxaddl_sxcqsi_sxdend)) | + +####### SxcQuery Class + +The **SxcQuery** class specifies additional information for an **external connection** (section [2.2.8](#Section_69df8d03b6fd45cda0a09b026e50a3d9)). + +The **SxcQuery** class is specified by the sequence of records specified by the **SXADDLDBQUERY** rule (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)). + +The **external connection** (section 2.2.8) the **SxcQuery** class specifies information for is specified by the **stURL** field of the **SXAddl_SXCQuery_SXDXMLSource** record (section [2.4.273.67](#sxaddl_sxcquery_sxdxmlsource)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCQUERY (0x06), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdXMLSource | 0x04 | **SXAddl_SXCQuery_SXDXMLSource** | +| sxdScrDataFile | 0x05 | **SXAddl_SXCQuery_SXDSrcDataFile** (section [2.4.273.66](#sxaddl_sxcquery_sxdsrcdatafile)) | +| sxdSrcConnFile | 0x06 | **SXAddl_SXCQuery_SXDSrcConnFile** (section [2.4.273.65](#sxaddl_sxcquery_sxdsrcconnfile)) | +| sxdReconnCond | 0x07 | **SXAddl_SXCQuery_SXDReconnCond** (section [2.4.273.64](#sxaddl_sxcquery_sxdreconncond)) | +| sxdEnd | 0xFF | **SXAddl_SXCQuery_SXDEnd** (section [2.4.273.63](#sxaddl_sxcquery_sxdend)) | + +####### SxcGrpLevel Class + +The **SxcGrpLevel** class specifies information for an **OLAP group level** (section [2.2.5.3.10](#Section_1e04807706d14d4f961ecacb50a12a3d)). + +The **SxcGrpLevel** class is specified by the sequence of records specified by the **SXADDLGRPLEVEL** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The **OLAP group level** the **SxcGrpLevel** class specifies information for is specified by the **stUnique** field of the **SXAddl_SXCGrpLevel_SXDId** record (section [2.4.273.41](#sxaddl_sxcgrplevel_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCGRPLEVEL (0x07), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCGrpLevel_SXDId** | +| sxdGrpLevelnfo | 0x06 | **SXAddl_SXCGrpLevel_SXDGrpLevelInfo** (section [2.4.273.40](#sxaddl_sxcgrplevel_sxdgrplevelinfo)) | +| sxdEnd | 0xFF | **SXAddl_SXCGrpLevel_SXDEnd** (section [2.4.273.39](#sxaddl_sxcgrplevel_sxdend)) | + +####### SxcGroup Class + +The **SxcGroup** class specifies information for an **OLAP grouping** (section [2.2.5.3.10](#Section_1e04807706d14d4f961ecacb50a12a3d)). + +The **SxcGroup** class is specified by the sequence of records specified by the **SXADDLGROUP** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The **OLAP grouping** the **SxcGroup** class specifies information for is specified by the **stName** field of the **SXAddl_SXCGroup_SXDId** record (section [2.4.273.37](#sxaddl_sxcgroup_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCGROUP (0x08), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCGroup_SXDId** | +| sxdGrpInfo | 0x07 | **SXAddl_SXCGroup_SXDGrpInfo** (section [2.4.273.36](#sxaddl_sxcgroup_sxdgrpinfo)) | +| sxdMember | 0x08 | **SXAddl_SXCGroup_SXDMember** (section [2.4.273.38](#sxaddl_sxcgroup_sxdmember)) | +| sxdEnd | 0xFF | **SXAddl_SXCGroup_SXDEnd** (section [2.4.273.35](#sxaddl_sxcgroup_sxdend)) | + +####### SxcCacheItem Class + +The **SxcCacheItem** class specifies additional information for a **cache item** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)). + +The **SxcCacheItem** class is specified by the sequence of records specified by the **SXADDLCACHEITEM** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). + +The **cache item** that the **SxcCacheItem** class specifies information for is specified by the **dwItem** field of the **SXAddl_SXCCacheItem_SXDId** record (section [2.4.273.21](#sxaddl_sxccacheitem_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCCACHEITEM (0x09), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCCacheItem_SXDId** | +| sxdSxrmitmDisp | 0x2E | **SXAddl_SXCCacheItem_SXDSxrmitmDisp** (section [2.4.273.24](#sxaddl_sxccacheitem_sxdsxrmitmdisp)) | +| sxdItmMpropMap | 0x32 | **SXAddl_SXCCacheItem_SXDItmMpropMap** (section [2.4.273.23](#sxaddl_sxccacheitem_sxditmmpropmap)) | +| sxdItmMpMapCount | 0x33 | **SxAddl_SXCCacheItem_SXDItmMpMapCount** (section [2.4.273.22](#sxaddl_sxccacheitem_sxditmmpmapcount)) | +| sxdEnd | 0xFF | **SXAddl_SXCCacheItem_SXDEnd** (section [2.4.273.20](#sxaddl_sxccacheitem_sxdend)) | + +**SXAddl_SXCCacheItem_SXDEnd** is a part of the **SxcCacheField** class (section [2.2.5.1.1.1.5](#Section_102acda2fb58485d9a40a37d0a219103)) and is not a [**member (1)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) of the **SxcCacheItem** class. **SXAddl_SXCCacheItem_SXDEnd** specifies the end of a collection of **SxcCacheItem** classes. + +####### SxcSXrule Class + +The **SxcSXrule** class specifies a **PivotTable** rule (section [2.2.5.4.11](#Section_ce60432dda944422929fcf3f6a0a206f)). + +The **SxcSXrule class** is specified by the sequence of records specified by the **SXADDLSXRULE** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCRULE (0x0C), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXrule_SXDId** (section [2.4.273.98](#sxaddl_sxcsxrule_sxdid)) | +| sxdSxrule | 0x13 | **SXAddl_SXCSXrule_SXDSXrule** (section [2.4.273.99](#sxaddl_sxcsxrule_sxdsxrule)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXrule_SXDEnd** (section [2.4.273.97](#sxaddl_sxcsxrule_sxdend)) | + +####### SxcSXfilt Class + +The **SxcSXfilt** class specifies information for a **PivotTable rule filter** (section [2.2.5.4.11](#Section_ce60432dda944422929fcf3f6a0a206f)). + +The **SxcSXfilt** class is specified by the sequence of records specified by the **SXADDLSXFILT** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXFILT (0x0D), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXfilt_SXDId** (section [2.4.273.76](#sxaddl_sxcsxfilt_sxdid)) | +| sxdSxfilt | 0x14 | **SXAddl_SXCSXfilt_SXDSXfilt** (section [2.4.273.77](#sxaddl_sxcsxfilt_sxdsxfilt)) | +| sxdSxitm | 0x15 | **SXAddl_SXCSXfilt_SXDSXItm** (section [2.4.273.78](#sxaddl_sxcsxfilt_sxdsxitm)) | +| sxDEnd | 0xFF | **SXAddl_SXCSXfilt_SXDEnd** (section [2.4.273.75](#sxaddl_sxcsxfilt_sxdend)) | + +####### SxcSXDH Class + +The **SxcSXDH** class specifies the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**dimensions (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) for **pivot hierarchies** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) in the **associated PivotTable view** (section [2.2.5.3.3](#Section_855483943345473bb926de5189fd664d)) of the **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)). MUST NOT be present if the **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) is a non- **OLAP PivotCache**. + +The **SxcSXDH** class is specified by the sequence of records specified by the **SXADDLSXDH** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXDH (0x10), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXDH_SXDId** (section [2.4.273.73](#sxaddl_sxcsxdh_sxdid)) | +| sxdSxdh | 0x1A | **SXAddl_SXCSXDH_SXDSxdh** (section [2.4.273.74](#sxaddl_sxcsxdh_sxdsxdh)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXDH_SXDEnd** (section [2.4.273.72](#sxaddl_sxcsxdh_sxdend)) | + +####### SxcAutoSort Class + +The **SxcAutoSort** class specifies **pivot field sorting** (section [2.2.5.4.3.1](#Section_6a008d4253834e13a1d06d8ee5d93b76)) information for a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). + +The **SxcAutoSort** class is specified by the sequence of records specified by the **SXADDLAUTOSORT** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCAUTOSORT (0x12), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCAutoSort_SXDId** (section [2.4.273.4](#sxaddl_sxcautosort_sxdid)) | +| sxdEnd | 0xFF | **SXAddl_SXCAutoSort_SXDEnd** (section [2.4.273.3](#sxaddl_sxcautosort_sxdend)) | + +####### SxcSXMgs Class + +The **SxcSXMgs** class specifies [**OLAP measure groups**](#gt_a14d2b2b-03ca-40e2-a237-3d1a53f87261). + +The **SxcSXMgs** class is specified by the sequence of records specified by the **SXADDLSXMGS** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXMGS (0x13), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXMgs_SXDId** (section [2.4.273.95](#sxaddl_sxcsxmgs_sxdid)) | +| sxdMgrpSxdhMap | 0x23 | **SXAddl_SXCSXMgs_SXDMGrpSXDHMap** (section [2.4.273.96](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXMgs_SXDEnd** (section [2.4.273.94](#sxaddl_sxcsxmgs_sxdend)) | + +####### SxcSXMg Class + +The **SxcSXMg** class specifies information for an [**OLAP measure group**](#gt_a14d2b2b-03ca-40e2-a237-3d1a53f87261). + +The **SxcSXMg** class is specified by the sequence of records specified by the **SXADDLSXMG** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). + +The OLAP measure group that the **SxcSXMg** class specifies information for is specified by the **stName** field of the **SXAddl_SXCSXMg_SXDId** record (section [2.4.273.92](#sxaddl_sxcsxmg_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXMG (0x14), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXMg_SXDId** | +| sxdUserCaption | 0x1F | **SXAddl_SXCSXMg_SXDUserCaption** (section [2.4.273.93](#sxaddl_sxcsxmg_sxdusercaption)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXMg_SXDEnd** (section [2.4.273.91](#sxaddl_sxcsxmg_sxdend)) | + +####### SxcField12 Class + +The **SxcField12** class specifies additional information for a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). + +The **SxcField12** class is specified by the sequence of records specified by the **SXADDLFIELD12** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The **pivot field** that the **SxcField12** class specifies information for is specified by **stName** field of the **SXAddl_SXCField12_SXDId** record (section [2.4.273.30](#sxaddl_sxcfield12_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCFIELD12 (0x17), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCField12_SXDId** | +| sxdVerUpdInv | 0x01 | **SXAddl_SXCField12_SXDVerUpdInv** (section [2.4.273.34](#sxaddl_sxcfield12_sxdverupdinv)) | +| sxdMemberCaption | 0x11 | **SXAddl_SXCField12_SXDMemberCaption** (section [2.4.273.32](#sxaddl_sxcfield12_sxdmembercaption)) | +| sxdVer12Info | 0x19 | **SXAddl_SXCField12_SXDVer12Info** (section [2.4.273.33](#sxaddl_sxcfield12_sxdver12info)) | +| sxdIsxth | 0x1C | **SXAddl_SXCField12_SXDISXTH** (section [2.4.273.31](#sxaddl_sxcfield12_sxdisxth)) | +| sxdAutoshow | 0x37 | **SXAddl_SXCField12_SXDAutoshow** (section [2.4.273.28](#sxaddl_sxcfield12_sxdautoshow)) | +| sxdEnd | 0xFF | **SXAddl_SXCField12_SXDEnd** (section [2.4.273.29](#sxaddl_sxcfield12_sxdend)) | + +####### SxcSXCondFmts Class + +The **SxcSXCondFmts** class specifies information for **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules. + +The **SxcSXCondFmts** class is specified by the sequence of records specified by the **SXADDLCONDFMTS** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXCONDFMTS (0x1A), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXCondFmts_SXDId** (section [2.4.273.71](#sxaddl_sxcsxcondfmts_sxdid)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXCondFmts_SXDEnd** (section [2.4.273.70](#sxaddl_sxcsxcondfmts_sxdend)) | + +####### SxcSXCondFmt Class + +The **SxcSXCondFmt** class specifies information for a **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule. + +The **SxcSXCondFmt** class is specified by the sequence of records specified by the **SXADDLCONDFMT** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXCONDFMT (0x1B), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdSxcondfmt | 0x35 | **SXAddl_SXCSXCondFmt_SXDSXCondFmt** (section [2.4.273.69](#sxaddl_sxcsxcondfmt_sxdsxcondfmt)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXCondFmt_SXDEnd** (section [2.4.273.68](#sxaddl_sxcsxcondfmt_sxdend)) | + +####### SxcSXFilters12 Class + +The **SxcSXFilters12** class specifies **advanced filters** (section [2.2.5.4.8.1](#Section_d490d0634e074f0093389812040ebdff)). + +The **SxcSXFilters12** class is specified by the sequence of records specified by the **SXADDLSXFILTERS12** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXFILTERS12 (0x1C), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXFilters12_SXDId** (section [2.4.273.90](#sxaddl_sxcsxfilters12_sxdid)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXFilters12_SXDEnd** (section [2.4.273.89](#sxaddl_sxcsxfilters12_sxdend)) | + +####### SxcSXFilter12 Class + +The **SxcSXFilter12** class specifies an **advanced filters** (section [2.2.5.4.8.1](#Section_d490d0634e074f0093389812040ebdff)). + +The **SxcSXFilter12** class is specified by the sequence of records specified by the **SXADDLSXFILTER12** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXFILTER12 (0x1D), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXFilter12_SXDId** (section [2.4.273.81](#sxaddl_sxcsxfilter12_sxdid)) | +| sxdCaption | 0x2F | **SXAddl_SXCSXFilter12_SXDCaption** (section [2.4.273.79](#sxaddl_sxcsxfilter12_sxdcaption)) | +| sxdSxfilter | 0x38 | **SXAddl_SXCSXFilter12_SXDSXFilter** (section [2.4.273.82](#sxaddl_sxcsxfilter12_sxdsxfilter)) | +| sxdSxfilterDesc | 0x39 | **SXAddl_SXCSXFilter12_SXDSXFilterDesc** (section [2.4.273.83](#sxaddl_sxcsxfilter12_sxdsxfilterdesc)) | +| sxdSxfilterValue1 | 0x3A | **SXAddl_SXCSXFilter12_SXDSXFilterValue1** (section [2.4.273.84](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1)) | +| sxdSxfilterValue2 | 0x3B | **SXAddl_SXCSXFilter12_SXDSXFilterValue2** (section [2.4.273.85](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2)) | +| sxdXlsFilter | 0x3C | **SXAddl_SXCSXFilter12_SXDXlsFilter** (section [2.4.273.86](#sxaddl_sxcsxfilter12_sxdxlsfilter)) | +| sxdXlsfilterValue1 | 0x3D | **SXAddl_SXCSXFilter12_SXDSXFilterValue1** (section [2.4.273.87](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1)) | +| sxdXlsfilterValue2 | 0x3E | **SXAddl_SXCSXFilter12_SXDXlsFilterValue2** (section [2.4.273.88](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXFilter12_SXDEnd** (section [2.4.273.80](#sxaddl_sxcsxfilter12_sxdend)) | + +#### Data Functionality Level + +A **data functionality level** is a number that represents a set of features and run-time behaviors in the following areas related to data manipulation and display: **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)), [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289), and **external connections** (section [2.2.8](#Section_69df8d03b6fd45cda0a09b026e50a3d9)). + +See section [2.2.5.3.1](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) for specific details about the **data functionality level** of a **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)). + +#### PivotCache + +The **PivotCache** is a set of structures that contains information about the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) being summarized in the **PivotTable views** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) using that **PivotCache**. The information includes **source data** organization, data types, and the values. A PivotCache is specified by the records conforming to the following rules: + +| Rule | Notes | +|----|----| +| **PIVOTCACHE** (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)) | This is in a stream as specified in section 2.1.7.12. | +| **PIVOTCACHEDEFINITION** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) | The **SXStreamID** record (section [2.4.303](#sxstreamid)) specifies the associated stream in section 2.1.7.12. | +| **PIVOTFRT9** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) | If an **associated PivotTable view** (section [2.2.5.3.3](#Section_855483943345473bb926de5189fd664d)) is specified by the **QsiSXTag** record (section [2.4.211](#qsisxtag)), then **PivotCache** properties specified in this rule apply to this **PivotCache**. | + +##### PivotCache Functionality Level + +The **PivotCache functionality level** is the **data functionality level** (section [2.2.5.2](#Section_2bcedd76ef064e6084c718ea55042ed6)) associated with a **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)). The **PivotCache functionality level** is used in specification of restrictions for the **PivotCache** and **associated PivotTable views** (section [2.2.5.3.3](#Section_855483943345473bb926de5189fd664d)). It is specified as follows: + +- If an **SXAddl_SXCCache_SXDVerSXMacro** record (section [2.4.273.10](#sxaddl_sxccache_sxdversxmacro)) exists, then the value of the **dwVer** field of the **SXAddl_SXCCache_SXDVerSXMacro** specifies the **PivotCache functionality level**. + +- If an **SXAddl_SXCCache_SXDVerSXMacro** record does not exist and an **SXAddl_SXCView_SXDVer10Info** record (section [2.4.273.108](#sxaddl_sxcview_sxdver10info)) exists for an **associated PivotTable views**, then the value of the **bVerSxMacro** field of the **SXAddl_SXCView_SXDVer10Info** record specifies the **PivotCache functionality level**, except if that value is greater than or equal to 3, in which case the **PivotCache functionality level** is specified to be 1. + +- If an **SXAddl_SXCCache_SXDVerSXMacro** record does not exist and an **SXAddl_SXCView_SXDVer10Info** record does not exist for an **associated PivotTable views**, then the **PivotCache functionality level** is specified to be 0. + +##### Source Data + +A **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) can be based on four different types of **source data**. The type of **source data** is specified by the **sxvs** field of the **SXVS** record (section [2.4.317](#sxvs)). + +When the **source data** type is SHEET as specified by **SXVS**, the data is read from the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) specified by a **DConRef** (section [2.4.86](#dconref)), **DConName** (section [2.4.85](#dconname)), or **DConBin** (section [2.4.83](#dconbin)) record. If the range is a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7), then the **PivotCache** will have one **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) for each column of the table using the column header captions for **cache field** names, and the [**data region**](#gt_6abb146e-d02e-45aa-a034-b25b23b0dd48) values of the table are used as **source data** values, specified by **cache records** (section [2.2.5.3.12](#Section_fe6e4ca0a9b646a4898124e4b61a770a)). Otherwise the **PivotCache** has one **cache field** for each column of the range, using the values in the first row of the range for **cache field** names, and all other rows are used as **source data** values, specified by **cache records**. + +When the **source data** type is SCENARIO as specified by **SXVS**, no new **source data** is available for the **PivotCache** and the **PivotCache** cannot be refreshed. A snapshot of the **source data** might be available in the **cache records**. + +When the **source data** type is EXTERNAL, as specified by **SXVS**, the **source data** is read from an external [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). There is an associated **external connection** (section [2.2.8](#Section_69df8d03b6fd45cda0a09b026e50a3d9)) that is used to obtain data from the external data source. The **external connection** is specified by the sequence of records that conforms to the **DBQUERY** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) in the sequence of records that conforms to the **PIVOTCACHEDEFINITION** rule (section 2.1.7.20.3) and the combination of other records as specified in section 2.2.8. For a non-**OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)), the **source data** is a rectangular table and the **PivotCache** (section 2.2.5.3) has one **cache field** for each column of the table using the column header captions for **cache field** names, and the rows of the table are used as **source data** values, specified by **cache records**. + +If the source data is external and the external connection is an **OLAP Connection** (section [2.2.8.3.1](#Section_068796f9e5154dab8e69f9a7b52aaa9a)) then the **PivotCache** MUST be an **OLAP PivotCache**. For an **OLAP PivotCache**, the **source data** is handled by the data provider specified by the associated **OLAP Connection** and the **PivotCache** MUST NOT have **cache records**. + +When the **source data** type is CONSOLIDATION as specified by **SXVS**, the **source data** is read from one or more ranges. For more details, see the section [2.2.5.3.2.1](#Section_2535c296b76b4728b52c72fbabaf3047). + +When a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) is on the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)) of the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)), the **pivot field** is a server-based page field if the **fServerBased** field of the **SXVDEx** record (section [2.4.310](#sxvdex)) is equal to 1 and the **fServerBased** field of the associated **SXFDB** record (section [2.4.283](#sxfdb)) is equal to 1. A server-based page field is a **pivot field** on the **page axis** that causes the query that is used to retrieve **source data** for populating the **PivotCache** to be parameterized. The query is parameterized according to the page filter criteria, as specified in section 2.2.5.4.9.1. This feature can only be used for an [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) **PivotCache**. + +###### Multiple Consolidation Ranges + +A **multiple** consolidation ranges **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) is used for summarizing multiple [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that contain [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0) in cross-tab format. A **multiple consolidation ranges** **PivotCache** is a collection of ranges and page information that is specified by the sequence of records that conforms to the **SXTBL** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). Each range is specified by one of the **DConName** (section [2.4.85](#dconname)), **DConBin** (section [2.4.83](#dconbin)), or **DConRef** (section [2.4.86](#dconref)) records. + +The following figure shows an example of a range in cross-tab format. The first column of the range contains names of sales people ("George" and "Allan"). The first row in the range contains product groups ("Cars" and "Bikes"). The remaining [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the range contain numeric values representing how many products in a certain product group were sold by each sales person. + +
+ +

Figure 3: Example of a range in cross-tab format

+
+ +A **multiple** consolidation ranges **PivotCache** is used to summarize multiple cross-tab ranges as shown in the following figure, which shows eight cross-tab ranges. + +
+ +

Figure 4: Example of eight ranges in cross-tab format

+
+ +The values in the first column of each range are used to create a **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) with a default name specified by the application. Each **cache item** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)) of this **cache field** corresponds to one of the values in the first column of the range, eliminating duplicates. This **cache field** is the first **cache field** in the collection of sequences of records that conform to the **FDB** rule (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)) in the sequence of records that conforms to the **PIVOTCACHE** rule. + +The values in the first row of each range are used to create a **cache field** with a default name specified by the application. Each **cache item** of this **cache field** corresponds to one of the values in the first row of the range, eliminating duplicates. This **cache field** is the second **cache field** in the collection of **FDB** rules (section 2.1.7.12) in the **PIVOTCACHE** rule (section 2.1.7.12). + +The values in all other cells of each range are used to create a **cache field** with a default name specified by the application. Each **cache item** of this **cache field** corresponds to one of the values in the other cells of the range, eliminating duplicates. This **cache field** is the third **cache field** in the collection of **FDB** rules in **PIVOTCACHE** rule. + +A **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) associated with the **multiple** consolidation ranges **PivotCache** is added on creation. The **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) corresponding to the **cache fields** described previously are added to the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)), **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)), and **data axis** (section [2.2.5.4.9.5](#Section_4c5c2daa289746e1854b0ce04209f060)), respectively. + +Up to four additional **cache fields** can optionally exist with default names specified by the application. The corresponding **pivot fields** are added to the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)) of the **PivotTable view** on creation, enabling the user to summarize data from all or a subset of the ranges. The ranges to be summarized in the **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) are selected by adding a **manual filter** (section [2.2.5.4.7](#Section_b0b282651e334c86ad030f5693c1d1e4)) to one or more of these **pivot fields** on the **page axis**. The number of optional **cache fields** created is user-defined and is equal to the **cPages** field of the **SXTbl** record (section [2.4.305](#sxtbl)). Each optional **cache field** corresponds to an **SXTBRGIITM** record. + +The first **SXTBRGIITM** record (section [2.4.307](#sxtbrgiitm)) in the **SXTBL** collection (section 2.1.7.20.3) corresponds to the fourth **cache field** in the collection of **FDB** rules. Each **cache item** of this **cache field** corresponds to the **SXString** record (section [2.4.304](#sxstring)) in the collection of **SXString** records directly following this **SXTBRGIITM** record. + +The second **SXTBRGIITM** record in the **SXTBL** collection corresponds to the fifth **cache field** in the collection of **FDB** rules. Each **cache item** of this **cache field** corresponds to the **SXString** record in the collection of **SXString** records directly following this **SXTBRGIITM** record. + +The third **SXTBRGIITM** record in the **SXTBL** collection corresponds to the sixth **cache field** in the collection of **FDB** rules. Each **cache item** of this **cache field** corresponds to the **SXString** record in the collection of **SXString** records directly following this **SXTBRGIITM** record. + +The fourth **SXTBRGIITM** record in the **SXTBL** collection corresponds to the seventh **cache field** in the collection of **FDB** rules. Each **cache item** of this **cache field** corresponds to the **SXString** record in the collection of **SXString** records directly following this **SXTBRGIITM** record. + +The following figure shows a multiple consolidation ranges **PivotTable** report (section 2.2.5) with two **pivot fields** on the **page axis**. The **PivotTable** report is based on the eight ranges in the figure titled **Example of eight ranges in cross-tab format** and summarizes the values from all the ranges because no **manual filter** (section 2.2.5.4.7) has been applied to any of the **pivot fields** on the **page axis**. + +
+ +

Figure 5: Multiple consolidation ranges PivotTable

+
+ +The **rgiitem** field of the **SxTbpg** record (section [2.4.306](#sxtbpg)) specifies the relationship between each range and the **SXString** records that follow each **SXTBRGIITM** record. + +##### Associated PivotTable views + +The set of **PivotTable views** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) that share an **associated PivotCache** (section [2.2.5.4.1](#Section_6f60301b107346d3b7ad0041566272a4)) are specified to be the **associated PivotTable views** of that **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)). + +A **PivotCache** MUST have at least one associated PivotTable view, and an **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) MUST have exactly one **associated PivotTable view**. + +##### OLAP PivotCache + +A **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) is specified to be an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) PivotCache if it has an **associated PivotTable view** (section [2.2.5.3.3](#Section_855483943345473bb926de5189fd664d)) that is an **OLAP PivotTable view** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)). + +An OLAP PivotCache MUST have exactly one **associated PivotTable view**. + +###### OLAP Data Model + +This section provides background information about the underlying data model for [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) entities. + +The principal unit of scope is an [**OLAP cube**](#gt_11427e13-37ed-49dd-8f0d-5f2b21f7aa4c). See section [2.2.8](#Section_69df8d03b6fd45cda0a09b026e50a3d9) for information about how an OLAP cube is accessed. Items within an OLAP cube can be addressed by an [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) string. Within an OLAP cube, there are [**OLAP hierarchies**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c), [**OLAP measures**](#gt_7431c051-4564-4476-ad00-39c66f169118) and [**OLAP sets**](#gt_bae9ed13-bcae-417e-a59c-d07f85116049). + +An OLAP hierarchy consists of one or more [**OLAP levels**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) and [**OLAP member properties**](#gt_b39deb4c-b405-40a9-90ed-1ba07e39ed9f). An OLAP level consists of one or more [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32). An OLAP member is an atomic unit of data, for example customer "Jim Smith", or a grouping of data, for example "customers in the city of Chicago". OLAP levels contain OLAP members of similar type within an OLAP hierarchy. OLAP members can have parent and child [**members (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) in OLAP levels above and below them, for example "Jim Smith" might be a child of "customers in the city of Chicago". An OLAP member property can be associated with a single OLAP level or all OLAP levels of an OLAP hierarchy, for example a "Mayor" OLAP member property might be associated with a "City" OLAP level. + +An [**OLAP tuple**](#gt_3a1a687f-d28b-485b-96a0-ba0b7eb4119e) is a way of combining multiple OLAP members to reference a particular point in an OLAP cube, for example "customers in the city of Chicago" and "2008" references data in the OLAP cube corresponding to the year 2008 and customers in Chicago. + +An OLAP measure is a value that is available in the OLAP cube. Usually it is numeric, "Sales" and "Head Count" are typical examples of OLAP measures. An OLAP measure is an OLAP member in a measures OLAP hierarchy. For a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)), OLAP measures are stored differently from other OLAP members in this file format. + +An OLAP tuple including an OLAP measure can be used to get a value, for example "customers in the city of Chicago", "2008" and "sales" might reference the value \$659,000. + +An [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28) is a collection of OLAP tuples. OLAP named sets are typically used for specific analytical needs that require custom logic, for example an OLAP named set might be defined as the OLAP tuples corresponding to "the top 10 customers by month and sales". + +##### Cache Fields + +A **cache field** represents an entity by which data can be summarized. + +Consider a **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) based on the following **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)): + +| Country | Product | Date | Sales | +|---------|---------|-----------|-------| +| USA | Bicycle | 6/5/2007 | 500 | +| USA | Car | 8/3/2007 | 20000 | +| Canada | Bicycle | 9/2/2007 | 300 | +| Canada | Car | 10/5/2007 | 35000 | + +In this example, four **cache fields** exist in the **PivotCache**. Each **cache field** corresponds to one of the columns in the **source data**: Country, Product, Date, and Sales. + +The sequence of records that conforms to the **FDB** rule (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)), and optionally the **SXADDLCACHEFIELD** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)), specify a **cache field**. A **cache field** is contained in a **PivotCache**. + +A cache field index is a zero-based index of an **FDB** rule in the **PIVOTCACHE** rule (section 2.1.7.12). + +A **cache** field typically corresponds to a **source data entity**. However, **grouping** (section [2.2.5.3.7](#Section_63e07ed20a764cb08cf446aaf25464c2)) **cache fields** and **cache fields** representing **calculated fields** (section [2.2.5.3.8](#Section_4594f2ac815740b381142e77ba8efb7d)) do not correspond to **source data entities** (section 2.2.5.3.2). Such **cache fields** are fully specified by information in the **PivotCache**. + +The cfdbdb field of the **SXDB** record (section [2.4.275](#sxdb)) specifies the number of **cache fields** that correspond to **source data entities**. If the cache field index of an **SXFDB** record (section [2.4.283](#sxfdb)) is less than cfdbdb, the cache field corresponds to a **source data entity**. Otherwise, the cache field does not correspond to a **source data entity**. A non- **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) MUST have one or more **cache fields** corresponding to **source data columns**. An **OLAP PivotCache** MUST NOT have **cache fields** that do not correspond to **source data entities**. + +In a non- **OLAP PivotCache**, a cache field typically corresponds to one column in the **source data** and contains information about that column. The **cache** field name is specified by the **stFieldName** field of the **SXFDB** record. The **cache** field name of a cache field corresponding to a **source data column** is derived from the name of that column in the **source data** and is used to associate the **cache** field with that **source data column**. + +All **cache field** names MUST be unique, when using a case-insensitive comparison, within the associated **PivotCache**. + +In an **OLAP PivotCache** each **cache field** can be associated with a **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)). For more information, see section [2.2.5.4.5.1](#Section_01a66b9be4a24396b55c28d6207fd28f). + +##### Cache Items + +**Cache items** represent specific instances of the entities represented by **cache fields** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)). For example, an instance of a Country **cache field** might be the USA **cache item**. Having a USA **cache item** in the Country **cache field** enables **PivotTable views** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) associated with the **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) to display data by USA. + +Each cache item specifies its value and a type. In some cases, a **cache item** can have additional information associated with it. + +A **cache item** is contained in a **cache field**. A **cache field** can have zero **cache items** if the **cache field** is not in use in the **PivotTable view**. + +For a **cache field** that corresponds to **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)), a collection of cache items is specified by a collection of sequences of records that conform to the **SRCSXOPER** rule (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)), with each cache item being specified by a sequence of records that conforms to the **SXOPER** rule (section 2.1.7.12), which optionally has a sequence of records that conforms to the **SXADDLCACHEITEM** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) associated with it. The sequence of records that conforms to the **SXOPER** rule specifies the value of the cache item. + +For **grouping** (section [2.2.5.3.7](#Section_63e07ed20a764cb08cf446aaf25464c2)) **cache fields**, the collection of cache items is specified by a collection of sequences of records that conform to the **GRPSXOPER** rule (section 2.1.7.12) with each cache item being specified by an **SXOPER** rule. + +**Calculated fields** (section [2.2.5.3.8](#Section_4594f2ac815740b381142e77ba8efb7d)) do not contain **cache items**. + +A **cache item** index can be used to reference a **cache item** within the **cache field**. Referencing a **cache** item by index requires an implicit or explicit reference to that **cache field** because a **cache item** collection is associated with a specific **cache field**. A **cache field** can be referenced by a **cache field** index, as specified in section 2.2.5.3.5. + +If a collection of **GRPSXOPER** rules exists in the cache field, a **cache item** index is a zero-based index into the collection of **GRPSXOPER** rules. Otherwise, a **cache item** index is a zero-based index into the collection of **SRCSXOPER** rules. + +There can be multiple entries of **source data** that have the same combination of value and type for a **cache field**. Each **cache item** within a **cache field** MUST have a unique combination of value and type. + +If there is one or more references by index to **cache** items of a particular **cache field**, that **cache field** MUST have a **cache items** collection. A **grouping** **cache field** MUST have a collection of **cache items** associated with it. + +A **cache** item collection can contain unused **cache items**. + +Unused **cache items** are values that did not exist in the **source data** when the **PivotCache** was last refreshed but existed when the **PivotCache** was refreshed previously. The **PivotCache** can retain such unused **cache items** to preserve information associated with them to reapply that information if the value corresponding to the **cache item** is added back to the **source data** at some later point in time. + +For an **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)), a **cache field** associated with an [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118) MUST NOT have a **cache** item collection. + +For an **OLAP PivotCache**, a **cache item** with a string value specifies the unique name of an [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32), unless the **cache field** is a **member property** (section [2.2.5.4.6](#Section_e5db3a66677f43db8fb038584797c95f)) **cache field**. + +An example of **cache items** and their association with **source data** is provided here. + +Consider a **PivotCache** based on the following **source data** table: + +| Country | Product | Date | Sales | +|---------|---------|-----------|-------| +| USA | Bicycle | 6/5/2007 | 500 | +| USA | Car | 8/3/2007 | 20000 | +| Canada | Bicycle | 9/2/2007 | 500 | +| Canada | Car | 10/5/2007 | 35000 | + +Four **cache fields** exist, each corresponding to one of the columns: Country, Product, Date, and Sales. Each of the four **cache fields** can have **cache items** corresponding to the unique values in the **source data columns** as illustrated in the following tables: + +| Cache items for the Country cache field | +|-----------------------------------------| +| Canada | +| USA | + +| Cache items for the Product cache field | +|-----------------------------------------| +| Bicycle | +| Car | + +| Cache items for the Date cache field | +|--------------------------------------| +| 6/5/2007 | +| 8/3/2007 | +| 9/2/2007 | +| 10/5/2007 | + +| Cache items for the Sales cache field | +|---------------------------------------| +| 500 | +| 20000 | +| 500 | +| 35000 | + +##### Grouping + +**Grouping** is used to combine a set of **cache items** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)), typically ones that are related in some logical way. There are three different types of **grouping**: numeric grouping, date grouping, and discrete grouping. Numeric grouping combines numeric **cache items** into ranges of values. Date grouping combines date **cache items** into date ranges. Discrete grouping combines specifically selected **cache items** into groups. + +The **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) that contains the **cache items** that are to be grouped is called the base **cache field**. The resultant **cache field** that contains the groups of **cache items** is called the parent grouping **cache field**. Each group of **cache items** in the base **cache field** is associated with a single **cache item** in the parent grouping **cache field**. Often **cache items** in parent grouping **cache fields** can be further grouped, creating a hierarchy of parent grouping **cache fields**. The base **cache field** is at the lowest level of the hierarchy. + +Numeric grouping is specified by records in the **PivotCache Storage part** (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)) that conform to the **GRPSXOPER** (section 2.1.7.12) and **SXRANGE** (section 2.1.7.12) rules. + +For numeric grouping, there is only one **cache field** associated with the grouping and it serves as both the parent grouping **cache field** and the base **cache field**. The numeric grouping is specified by the **fRangeGroup** and **fNumField** fields of the **SXFDB** record (section [2.4.283](#sxfdb)) associated with the **cache field** being equal to 1. The **fHasParent** field of the **SXFDB** record MUST be 0. + +The **cache items** that specify the groups are specified by **SXString** records (section [2.4.304](#sxstring)) that follow the **SXFDB** record. The grouping criteria is specified by the **SxRng** record (section [2.4.300](#sxrng)) that follows the **SXFDB** record. The **iByType** field of the **SxRng** record MUST be 0. For more details, see section 2.4.300. + +Date grouping is specified by records in the **PivotCache Storage part** that conform to the **GRPSXOPER** and **SXRANGE** rules. + +For date grouping, there can be up to seven levels of grouping hierarchy. The grouping level for a **cache field** is specified by the **iByType** field of the **SxRng** record that follows the **SXFDB** record which specifies that **cache field**. The **cache field** with the lowest **iByType** value has the finest level of detail, the **cache field** with the next lowest **iByType** value has the next finest level of detail, and so on. Each **cache field** in the hierarchy MUST have an **SxRng** record with a unique **iByType** value. + +The **cache field** corresponding to the finest level of detail of date information included serves as both a parent grouping **cache field** and the base **cache field**. Other parent grouping **cache fields** specify additional levels in the hierarchy. The date grouping is specified by the **fRangeGroup** and **fNumField** fields of the **SXFDB** record associated with the **cache field** being equal to 1 and 0 respectively for all **cache fields** in the grouping. The **ifdbBase** field of each **SXFDB** record associated with the date grouping, except for the **SXFDB** record corresponding to the base **cache field**, MUST specify a **cache field** index to the **SXFDB** record corresponding to the lowest level of the hierarchy. + +The **cache items** that specify the groups are specified by **SXString** record that follow the **SXFDB** record for the parent grouping **cache fields**. The grouping criteria is specified by the **SxRng** record that follows the **SXFDB** record. The **iByType** field of the **SxRng** record MUST be greater than or equal to 1 (Seconds) and less than or equal to 7 (Years). For more details, see section 2.4.300. + +Discrete grouping is specified by the **GRPSXOPER** rule, the **SxIsxoper** record (section [2.4.290](#sxisxoper)), and the **Continue** records (section [2.4.58](#continue)) in the **PivotCache Storage part**. + +For discrete grouping, a hierarchy of parent grouping **cache fields** can exist, where each parent grouping **cache field** combines the **cache items** of the **cache field** at the next lower level. The discrete grouping is specified by the **fRangeGroup** field of the **SXFDB** record associated with the **cache field** being equal to 0 and the **csxoper** field of the **SXFDB** record being greater than 0. The **ifdbBase** field of the **SXFDB** record specifies a **cache field** index to the base **cache field** at the lowest level of the grouping hierarchy. The **ifdbParent** field of the **SXFDB** record specifies a **cache field** index to the parent grouping **cache field** at the next higher level of the hierarchy. If there is no higher level, then the **fHasParent** field of the **SXFDB** record MUST be 0 and **ifdbParent** MUST be ignored. + +The **cache items** that specify the groups are specified by records that conform to the **GRPSXOPER** rule following the **SXFDB** record. The mapping between the **cache items** in the lower level **cache field** and the **cache items** in the parent grouping **cache field** is specified by the **SxIsxoper** record following the **SXFDB** record for the parent grouping **cache field**. The **rgSxIsxoper** field in the **SxIsxoper** record contains an array element for each **cache item** in the lower level **cache field**. The value of the array element is the index of the **cache item** in the parent grouping **cache field** that the **cache item** in the lower level **cache field** is grouped by. For more details, see section 2.4.290. + +The following paragraphs explain the three different types of grouping and provide examples of them. + +Numeric grouping combines numeric **cache items** into ranges of values. For example, consider the following PivotTable report where the number of people, represented by "Count of Name", of a certain age are listed. + +
+ +

Figure 6: PivotTable report with ages

+
+ +Analysis of specific ages might not be particularly meaningful. Instead, looking at age groups can be more interesting. The following **PivotTable** report (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) illustrates numeric grouping applied to the "Age" **cache field**. In this example, the numeric grouping is set to start at 0, end at 100, and have groups of 20 years. + +
+ +

Figure 7: PivotTable report with age groups

+
+ +Date grouping is similar to numeric grouping and is used to group **cache items** into date ranges. + +One to seven parent grouping **cache fields** can exist when date grouping is applied to a **cache field**, each corresponding to a different level of detail of date and time information. The **cache field**, to which the date grouping is originally applied, is included in the set of parent grouping **cache fields** and is considered the base **cache field** of the parent grouping **cache fields**. For date grouping, the base **cache field** represents the finest level of detail of date and time information. The following levels of detail of date information are available, each corresponding to one **cache field**: + +- Seconds + +- Minutes + +- Hours + +- Days + +- Months + +- Quarters + +- Years + +For example, consider the following **PivotTable** report where the number of sales is listed for each individual date. + +
+ +

Figure 8: PivotTable report with dates

+
+ +This information can be too detailed for some analytical purposes. With date grouping, a more useful higher level summary can be created. The following PivotTable report illustrates the result of applying date grouping to the "Date" **cache field** and including two levels of grouping ("Years" and "Quarters"). In this example, the "Quarters" **cache field** represents the finest level of date information included and is therefore the base **cache field** for this date grouping. The "Years" **cache field** is a parent grouping **cache field** with the "Quarters" **cache field** as its base **cache field**. The items "\<1/1/2007" in the two **cache fields** represent dates before 1/1/2007, where the start date is specified by the first **SXNum** record (section [2.4.296](#sxnum)) following the **SxRng** record. The items "\>12/13/2008" in the two **cache fields** represent dates after 12/13/2008, where the end date is specified by the second **SXNum** record following the **SxRng** record. + +
+ +

Figure 9: PivotTable report with date groups

+
+ +Discrete grouping combines specifically selected **cache items** into groups. When discrete grouping is applied to a **cache field**, a separate parent grouping **cache field** is created and the **cache field** that the grouping is applied to will become the base **cache field** for that parent grouping **cache field**. Multiple parent grouping **cache fields** can exist for one base **cache field**, forming a hierarchy of parent grouping **cache fields**. A parent grouping **cache field** higher in the hierarchy is considered the parent of the **cache field** just below it in the hierarchy. For a parent grouping **cache field**, each **cache item** in the **cache items** collection represents one group. + +For example, consider the following **PivotTable** report listing sales by state in the Unites States. + +
+ +

Figure 10: PivotTable report with state names

+
+ +Discrete grouping can be used to group sets of states, for example, into geographical areas. The following PivotTable report illustrates the result of applying six groups ("Group1" through "Group6") to the **cache field** representing states. The **cache field** representing states is considered the base **cache field** for the discrete grouping in this example. Each group in the example, represented by a **cache item** in the parent grouping **cache field**, combines states in the same geographical area. + +
+ +

Figure 11: PivotTable report with state groups

+
+ +##### Calculated Fields + +**Calculated fields** allow users to add calculations to a **PivotTable** report (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). For example, if a **PivotTable** report contains values for sales and cost by products, but no profit values, a **calculated field** with the formula "=sales-cost" can be added so that profit values are calculated and can be analyzed in the **PivotTable** report. + +A calculated field is a **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) and does not correspond to a column in the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)). The values for a **calculated field** are calculated based on the formula specified for the **calculated field**. A **calculated field** is specified by the **fCalculatedField** field of the **SXFDB** record (section [2.4.283](#sxfdb)) being equal to 1. The formula is specified by the **SXFormula** record (section [2.4.288](#sxformula)) following the **SXFDB** record. + +A **pivot field** associated with a calculated field MUST NOT appear on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)), **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)), or **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)) of a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +An **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) MUST NOT have **calculated fields**. + +##### Calculated Items + +**Calculated items** allow users to add a **cache item** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)) that does not exist in the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) to a **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)). For example, consider a **PivotTable** report (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) displaying sales for the four quarters of 2007. If there are **source data** rows for sales in 2008, a **calculated item** can be used to add an additional **cache item** as a calculated item that calculates the projected sales for the first quarter of the year 2008 as being 25% higher than the sales for the fourth quarter of 2007. The following figure illustrates a **PivotTable** report with such a **calculated item** (2008 Q1 projected). + +
+ +

Figure 12: PivotTable report with a calculated item

+
+ +The values for a **calculated item** are calculated based on the formula specified for the **calculated** item. + +The sequence of records that conform to the **SXFORMULA** rule (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)) specifies one calculation for a specific **calculated item**. Each **calculated item** can have multiple calculations associated with it and in that case, there are multiple sequences of records that conform to the **SXFORMULA** rule corresponding to the same **calculated item**. The **calculated item** that a calculation is associated with is specified by the sequence of records that conform to the **PIVOTRULE** rule (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)) in the **SXFORMULA** rule. The **PIVOTRULE** rule can also specify additional scoping information. For example, if one calculation for a calculated item named "2008 Q1 projected" only applies to the "Cars" product group, the **PIVOTRULE** rule will specify the **cache field** corresponding to "product group" and the **cache item** corresponding to "Cars". + +An **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) MUST NOT have **calculated items**. + +##### OLAP Grouping + +Grouping in an **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) is the associating of multiple [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) that belong to the same [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) and have the same OLAP member parent. When OLAP members in a particular OLAP level are grouped, a parent grouping OLAP level exists. Each group is represented in the parent grouping OLAP level by one parent grouping OLAP member, and one or more child OLAP members in the OLAP level that the grouping is applied to. + +A parent grouping OLAP level is specified by the sequence of records that conform to the **SXADDLGRPLEVEL** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +A parent grouping OLAP member is specified by the sequence of records that conform to the **SXADDLGROUP** rule (section 2.1.7.20.5). + +##### OLAP Calculated Members + +A calculated [**member (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) is specified by the sequence of records that conform to the **SXADDLCALCMEMBER** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) and is used to create an [**OLAP calculated member**](#gt_16cb1b2a-a915-42c1-81ef-fcf221adb0fe) or an [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28) with an associated user-specified [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) for a custom calculation. + +If the **fLongFormula** field of the **SXAddl_SXCView_SXDCalcMember** record (section [2.4.273.100](#sxaddl_sxcview_sxdcalcmember)) is equal to one, then the **stMDXFormula** field of the **SXAddl_SXCView_SXDCalcMemString** record (section [2.4.273.101](#sxaddl_sxcview_sxdcalcmemstring)) specifies the user-specified MDX expression. If the **fLongFormula** field of the **SXAddl_SXCView_SXDCalcMember** record is equal to zero, then the **stMDXFormula** field of the **SXAddl_SXCView_SXDCalcMember** record specifies the MDX expression. + +The **fSet** field of the **SXAddl_SXCView_SXDCalcMember** record specifies whether the associated calculated member (2) creates an OLAP named set or an OLAP calculated member. + +If the user-specified MDX expression associated with a calculated member (2) defines an [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118), then this calculated member (2) is associated with a measure **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) as specified in section [2.2.5.4.5.2](#Section_4308b88c7f1e42bcb3dd8a1387b69c51). + +If the user-specified MDX expression associated with a calculated member (2) specifies an [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) in an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) other than the OLAP measure hierarchy, then this calculated member (2) can only be associated with a **cache item** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)). + +If a calculated member (2) specifies an OLAP named set, then this calculated member (2) is associated with a named set **pivot hierarchy** as specified in section [2.2.5.4.5.4](#Section_c7f4e861a4e846b28279670fc6edcf6f). + +##### Cache Records + +**Cache records**, as defined by the **Pivot Cache Storage** (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)), represent a copy of the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) for a **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) and allow for **PivotTable views** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) using a **PivotCache** to be recalculated without retrieving the **source data**. + +Each **cache** record specifies values for one row of **source data**. Each value in a **cache** record is associated with a corresponding **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)). **Cache records** are specified by the sequence of records that conform to the **DBB** rule (section 2.1.7.12). The count of **cache records** MUST be equal to the **crdbdb** field of the **SXDB** record (section [2.4.275](#sxdb)). The **SXDBB** record (section [2.4.276](#sxdbb)) specifies an array of **cache item** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)) indexes for the **cache fields** for which the **fAllAtoms** field of the **SXFDB** record (section [2.4.283](#sxfdb)) is equal to 1. The values for the remaining **cache fields** that correspond to **source data** columns are specified by the sequence of records that conform to the **SXOPER** rule (section 2.1.7.12), with each record specifying a value. For each **cache** record, the number of records in the sequence of records that conforms to the **SXOPER** rule (section 2.1.7.12) MUST be the same as the count of **cache fields**, corresponding to **source data** columns, for which the **fAllAtoms** field of the **SXFDB** record is equal to 0. + +The **cache records** in a **PivotCache** can be invalid, in which case the **cache records** MUST be ignored. The validity of the **cache records** is determined from the **SXAddl_SXCCache_SXDInvRefreshReal** record (section [2.4.273.8](#sxaddl_sxccache_sxdinvrefreshreal)), if one is present and associated with this **PivotCache**, the **QsiSXTag** record (section [2.4.211](#qsisxtag)), if one is present and associated with this **PivotCache**, and the **SXDB** record. If the **SXAddl_SXCCache_SXDInvRefreshReal** record is present, then the **cache records** are not valid if the **fInvalid** field of the **SXAddl_SXCCache_SXDInvRefreshReal** record is 1 and valid if that field is 0. Otherwise, if the **QsiSXTag** record is present, then the **cache records** are not valid if the **fInvalid** field of the **QsiSXTag** record is 1 and valid if that field is 0. Otherwise, the **cache records** are not valid if the **fInvalid** field of the **SXDB** record is 1 and valid if that field is 0. + +An **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) MUST NOT have **cache records**. **Cache records** are optional for a non- **OLAP PivotCache**. + +#### PivotTable View + +A PivotTable view is a set of structures that specify layout, filtering, and other properties. These properties are used to produce a **PivotTable** report (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) based on data from the associated **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)). + +A **PivotTable view** is specified by the sequence of records that conform to the **PIVOTVIEW** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +Functionality specified by a **PivotTable view** includes: + +- The arrangement of **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)), **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)), or both to produce a **PivotTable** report. + +- Using **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) on the **data axis** (section [2.2.5.4.9.5](#Section_4c5c2daa289746e1854b0ce04209f060)) to show summarized result values in the **PivotTable** report. + +- Filtering the data in the **PivotTable** report by performing manual filtering (section [2.2.5.4.7](#Section_b0b282651e334c86ad030f5693c1d1e4)), filtering by criteria (section [2.2.5.4.8](#Section_5b29f1fa92f74d018648957cea96c4c2)), or filtering in the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)). + +- Determining the **PivotTable layout** (section [2.2.5.4.10](#Section_2f81b5b422d546778ec53c5dc1ad80d4)). + +- Formatting the entire **PivotTable** report with a **table style** (section [2.4.320](#tablestyle)). See the **SXAddl_SXCView_SXDTableStyleClient** report (section [2.4.273.107](#sxaddl_sxcview_sxdtablestyleclient)) for details. Alternatively, for an [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f), see section [2.4.313](#sxview) and section [2.4.315](#sxviewex9) for details. + +- Formatting an area of the **PivotTable** report in a way that logically tracks changes in the **PivotTable** report. For details, see the record specifications for records specified by the **PIVOTFORMAT** rule (section 2.1.7.20.5). + +- [**Conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) an area of the **PivotTable** report in a way that logically tracks changes in the **PivotTable** report and performs calculations based the fact that the area is in a **PivotTable** report. For details, see the record specifications for records specified by the **SXADDLCONDFMT** rule (section 2.1.7.20.5). + +- Sorting **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) of **pivot fields** (section 2.2.5.4.3) within the **PivotTable** report. For details, see section [2.2.5.4.3.1](#Section_6a008d4253834e13a1d06d8ee5d93b76). + +##### Associated PivotCache + +A **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) is associated with the **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) specified by the **iCache** field of the **SxView** record (section [2.4.313](#sxview)). **iCache** is a zero-based index of a sequence of records that conform to the **PIVOTCACHEDEFINITION** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) in the sequence of records that conform to the **WORKBOOKCONTENT** rule (section 2.1.7.20.3). + +Each **PivotTable view** MUST be associated with exactly one **PivotCache**. A non- **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) MUST be associated with one or more **PivotTable views**. An **OLAP PivotCache** MUST be associated with exactly one **PivotTable view**. + +##### OLAP PivotTable view + +A **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) is specified to be an **OLAP PivotTable view** if a **QsiSXTag** record (section [2.4.211](#qsisxtag)) exists for the **PivotTable view** and the **fTensorEx** bit of the **QsiSXTag** record is 1. Otherwise, the **PivotTable view** is specified to be a non-**OLAP PivotTable view**. An **OLAP PivotTable view** has an **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) as its associated **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)). + +##### Pivot Fields + +A **pivot field** corresponds to a **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)). A **pivot field** specifies display information of the data in the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +A **pivot field** is specified by a sequence of records that conforms to the **PIVOTVD** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) and optionally the **PIVOTVDTEX** (section 2.1.7.20.5) and **SXADDLFIELD** (section 2.1.7.20.5) rules. The **PIVOTVDTEX** rule specifies additional properties for **OLAP PivotTable** views (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)), and the **SXADDLFIELD** rule (section 2.1.7.20.5) specifies additional version specific properties. A pivot field is contained in the **PivotTable view**. A **PivotTable view** contains a collection of **pivot fields** which is specified by the sequence of records that conforms to the **PIVOTVIEW** rule (section 2.1.7.20.5). + +A pivot field index, which identifies a pivot field, is specified as the zero-based index of a **PIVOTVD** rule in the collection specified by a **PIVOTVIEW** rule. + +Each **pivot field** is associated with the **cache field** with a **cache field** index equal to the **pivot field** index of this **pivot field**. For more details, see section 2.2.5.3.5. The number of pivot fields in the sequence of records that conforms to a **PIVOTCORE** rule (section 2.1.7.20.5) MUST be equal to the number of **cache fields** in the **associated PivotCache** (section [2.2.5.4.1](#Section_6f60301b107346d3b7ad0041566272a4)) for the **PivotTable view**. + +A **PivotTable view** is used to create a **PivotTable** report (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). This can include information about **pivot fields** placed on **PivotTable axes** (section [2.2.5.4.9](#Section_89db73685e8e4324b592af85e4559e6c)) and **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) referring to **pivot fields**. + +A **pivot field** can have **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)). A **pivot field** can describe information such as **pivot field sorting** (section [2.2.5.4.3.1](#Section_6a008d4253834e13a1d06d8ee5d93b76)) and **subtotaling** (section [2.2.5.4.9.4.2](#Section_427438d9b8e34a5c8b678f158fbf680f)) settings. + +The following figure shows a **PivotTable** report with three pivot fields displaying Sales by Country and Fiscal Year. + +
+ +

Figure 13: PivotTable report with three pivot fields: Sales, Country, and Fiscal Year

+
+ +###### Pivot Field Sorting + +A **Pivot Field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) has a [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7) specified if the **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) is recalculated and the **Pivot Field** (section 2.2.5.4.3) is on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)) or **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)). + +A **Pivot Field** is sorted depending on the setting of the **fAutoSort** field of **SXVDEx** (section [2.4.310](#sxvdex)). + +If the **fAutoSort** field of **SXVDEx** is equal to 0, then the sort order is specified depending on the value of the **fTensorSort** field of **SXVDTEx** record (section [2.4.311](#sxvdtex)) of the **Pivot Field**. + +| fTensorSort field of SXVDTEx | Meaning | +|----|----| +| 0 or **SXVDTEx** record not present | The order is determined by the order of the **SXVI** records (section [2.4.312](#sxvi)) for this **Pivot Field**. | +| 1 | The order is determined by the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). Only valid for an **OLAP PivotTable view** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)). | + +If the **fAutoSort** field of **SXVDEx** is equal to 1, then sorting is in ascending or descending order according to the **fAscendSort** field of **SXVDEx**. What is sorted depends on the following: + +| SxcAutoSort class of pivot field presence | isxdiAutoSort field of SXVDEx | Meaning | +|----|----|----| +| Not Present | Greater than or equal to 0 | Sorting is based on the values in the cells in the **PivotTable data area** (section [2.2.5.4.10.1.4](#Section_237a24905c614931923f7ee856f23c72)) that are specified by the **data item** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) referenced by the **isxdiAutoSort** field of **SXVDEx**. | +| Not Present | -1 | Sorting is based on the values of the **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) themselves. | +| Present | | Sorting is either based on the values in the cells in the **PivotTable data area** or on the values of **member properties** (section [2.2.5.4.6](#Section_e5db3a66677f43db8fb038584797c95f)) associated with this **pivot field** as specified by the **SxcSXRule** class (section [2.2.5.1.1.1.11](#Section_dd12edef6e8747379bed6f4ceff33127)) in the **SxcAutoSort** class (section [2.2.5.1.1.1.14](#Section_212512d2c740431f838b7ec651364e2f)). | + +##### Pivot Items + +**Pivot items** represent specific instances of the entities represented by **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). Each **pivot item** specifies its display properties. For example, it can contain the user defined caption for the **pivot item** or information about whether this **pivot item** is hidden or not. + +A **pivot item** specifies view properties of a **cache item** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)) or of an aggregation value associated with a **pivot fields** (section 2.2.5.4.3). + +A pivot item is specified by an **SXVI** record (section [2.4.312](#sxvi)) in a sequence of records that conforms to the **PIVOTVD rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)), and optionally an **SXVIFlags structure** (section [2.5.263](#sxviflags)) specified by an element in the array specified by the **rgsxvi** field of the **SXVDTEx** record (section [2.4.311](#sxvdtex)). The **SXVIFlags structure** (section 2.5.263) specifies additional properties for **OLAP PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)). + +If the **itmType** field of **SXVI** (section 2.4.312) is 0x0000, then this **pivot item** is associated with the **cache item** (section 2.2.5.3.6) specified by the iCache field of the **SXVI** record (section 2.4.312). Each **pivot item** that is associated with a **cache item** (section 2.2.5.3.6) MUST be associated with a different **cache item** (section 2.2.5.3.6) than the other **pivot items** in the collection. If the **itmType** field of this **SXVI** record (section 2.4.312) is not 0x0000, then this **pivot item** MUST NOT have an associated **cache item** (section 2.2.5.3.6). + +The number of **pivot items** where the **itmType** field of the **SXVI** record (section 2.4.312) of the **pivot item** is 0x0000 MUST equal zero or the number of **cache items** (section 2.2.5.3.6) in the **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) of the **pivot fields** (section 2.2.5.4.3). + +A pivot item can be referenced by a pivot item index. A pivot item index is a zero-based index of **SXVI** records (section 2.4.312) in a **PIVOTVD rule** (section 2.1.7.20.5). Note that unlike pivot field index and cache field index, **pivot item** index and cache item index are not necessarily equal. + +##### Pivot Hierarchies + +A **pivot hierarchy** is specified to be contained by a **PivotTable axis** (section [2.2.5.4.9](#Section_89db73685e8e4324b592af85e4559e6c)) when all **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) associated with that pivot hierarchy are placed on that **PivotTable axis** (section 2.2.5.4.9). **Pivot fields** (section 2.2.5.4.3) MUST NOT be placed on a **PivotTable axis** (section 2.2.5.4.9) different from the pivot axis that any other **pivot field** (section 2.2.5.4.3) associated with the same pivot hierarchy is placed on. Additional restrictions can apply, as specified by the **SXTH rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) and the PivotTable Axes section. + +A **pivot hierarchy** corresponds to one of the following entities in the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) associated with an **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)): + +- [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) + +- [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118) + +- [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28) + +- OLAP [**key performance indicator (KPI)**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) + +A **pivot hierarchy** is associated with an OLAP hierarchy in the **source data** (section 2.2.5.3.2). A pivot hierarchy is specified by the sequence of records that conform to the **PIVOTTH rule** (section 2.1.7.20.5) and, optionally, the **SXADDLHIERARCHY rule** (section 2.1.7.20.5). + +Pivot hierarchies MUST NOT exist if the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) is a non- **OLAP PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)). At least one **p**ivot hierarchy MUST exist if the **PivotTable view** (section 2.2.5.4) is an **OLAP PivotTable views** (section 2.2.5.4.2). + +A **pivot hierarchy** specifies OLAP hierarchy information and has one or more associated **pivot fields** (section 2.2.5.4.3) associated with [**OLAP levels**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of the OLAP hierarchy, an OLAP named set, an [**OLAP KPI**](#gt_d49d8fc7-18d5-4e3d-b6ab-547944dba3ca), or an OLAP measure. + +A pivot hierarchy can be referenced by pivot hierarchy index. A pivot hierarchy index is the zero-based index of a **PIVOTTH rule** (section 2.1.7.20.5) in the associated **PIVOTVIEW rule** (section 2.1.7.20.5). + +A pivot hierarchy is associated with an OLAP object as specified in the following table: + +| fMeasure field of SXTH | fSet field of SXTH | fKPI field of SXTH | Meaning | +|------------------------|--------------------|--------------------|----------------| +| 0 | 0 | 0 | OLAP hierarchy | +| 0 | 1 | 0 | OLAP named set | +| 0 | 0 | 1 | OLAP KPI | +| 1 | 0 | 0 | OLAP measure | + +###### Association of Pivot Hierarchies and Pivot Fields and Cache Fields + +A **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) is associated with the **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) specified by either the **isxth** field of the **SXVDTEx record** (section [2.4.311](#sxvdtex)) of that **pivot field** (section 2.2.5.4.3), or the **isxth** field of the **SXAddl_SXCField12_SXDISXTH record** (section [2.4.273.31](#sxaddl_sxcfield12_sxdisxth)) of that **pivot field** (section 2.2.5.4.3). + +If a **pivot field** (section 2.2.5.4.3) has an **SXAddl_SXCField12_SXDISXTH record** (section 2.4.273.31), the **isxth** field of the **SXVDTEx record** (section 2.4.311) MUST be -1 and the association is specified by **isxth** field of the **SXAddl_SXCField12_SXDISXTH record** (section 2.4.273.31). + +A **pivot hierarchy** (section 2.2.5.4.5) associated with a **pivot field** (section 2.2.5.4.3) is associated with the **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) the **pivot field** (section 2.2.5.4.3) is associated. + +If a **pivot hierarchy** (section 2.2.5.4.5) is on the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)) or **data axis** (section [2.2.5.4.9.5](#Section_4c5c2daa289746e1854b0ce04209f060)), the **isxvd** field of **SXTH** (section [2.4.308](#sxth)) is a reference to an associated **pivot field** (section 2.2.5.4.3). + +If the **pivot hierarchy** (section 2.2.5.4.5) is not a **measure** (section [2.2.5.4.5.2](#Section_4308b88c7f1e42bcb3dd8a1387b69c51)), **named set** (section [2.2.5.4.5.4](#Section_c7f4e861a4e846b28279670fc6edcf6f)), **KPI** (section [2.2.5.4.5.3](#Section_239d9d6560154f06a8359f2868568a33)), there can be more than one **pivot field** (section 2.2.5.4.3) associated with it and each array elements in the **rgisxvd** field of **SXTH** (section 2.4.308) is a reference to the associated **pivot field** (section 2.2.5.4.3) for the **pivot hierarchy** (section 2.2.5.4.5) level. + +If a **pivot field** (section 2.2.5.4.3) has an **SXAddl_SXCField12_SXDISXTH record** (section 2.4.273.31) **sxaxis.sxaxisData**, **sxaxis.sxaxisRw**, **sxaxis.sxaxisCol** and **sxaxis.sxaxisPage** fields of the **Sxvd record** (section [2.4.309](#sxvd)) of the **pivot field** (section 2.2.5.4.3) MUST be 0. + +If a **pivot hierarchy** (section 2.2.5.4.5) is a **measure** (section 2.2.5.4.5.2), **named set** (section 2.2.5.4.5.4), or **KPI** (section 2.2.5.4.5.3), there can be no more than one **pivot field** (section 2.2.5.4.3) associated with it. + +###### Measures + +A measure pivot hierarchy is a pivot hierarchy that is associated with an [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118). The **fMeasure** field of the **SXTH** (section [2.4.308](#sxth)) specifies if a pivot hierarchy is a **measure** pivot hierarchy. An OLAP measure MUST NOT have more than one **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) associated with it. A **measure** pivot hierarchy MUST NOT be located on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)), **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)), or **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)). + +###### KPIs + +A [**key performance indicator (KPI)**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) is a **pivot hierarchy** (section 2.2.5.4.5) that is associated with an [**OLAP KPI**](#gt_d49d8fc7-18d5-4e3d-b6ab-547944dba3ca). A **KPI** **pivot hierarchy** (section 2.2.5.4.5) includes the four main components of an OLAP KPI; value, goal, status and trend. The **fKPI** field of the **SXTH record** (section [2.4.308](#sxth)) specifies if a pivot hierarchy is a KPI **pivot hierarchy** (section 2.2.5.4.5). + +###### Named Sets + +A **named set** **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) is a **pivot hierarchy** (section 2.2.5.4.5) that is associated with an [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28). The **fSet** field of the **SXTH record** (section [2.4.308](#sxth)) specifies if a **pivot hierarchy** (section 2.2.5.4.5) is a **named set** **pivot hierarchy** (section 2.2.5.4.5). An OLAP named set MUST NOT have more than one **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) associated with it. A **named set** **pivot hierarchy** (section 2.2.5.4.5) MUST NOT be located on the **data axis** (section [2.2.5.4.9.5](#Section_4c5c2daa289746e1854b0ce04209f060)) or **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)). + +##### Member Properties + +A **member property** is the **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) representation of an [**OLAP member property**](#gt_b39deb4c-b405-40a9-90ed-1ba07e39ed9f). **Member properties** can have properties that are associated with the **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) and a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +A **member property** is specified by the **SXAddl_SXCHierarchy_SXDProperty record** (section [2.4.273.57](#sxaddl_sxchierarchy_sxdproperty)) in the sequence of records that conform to the **SXADDLHIERARCHY rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). A **member property** is contained in a **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)). + +A **member property** is associated with one OLAP member property of the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) specified by the **pivot hierarchy** (section 2.2.5.4.5) of the **member property**. + +A **member property** can be associated with a **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) and a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). If there is a **cache field** (section 2.2.5.3.5) with an **stFieldName** field of the [SXFDB](#sxfdb) record equal to the **stProperty** field of the **SXAddl_SXCHierarchy_SXDProperty record** (section 2.4.273.57), then this specifies that the **member property** is associated with that **cache field** (section 2.2.5.3.5), and the **cache field** (section 2.2.5.3.5) is specified to be a **member property** **cache field** (section 2.2.5.3.5). The associated **pivot field** (section 2.2.5.4.3) of a **member property** **cache field** (section 2.2.5.3.5) is specified to be a **member property** **pivot field** (section 2.2.5.4.3). + +It is not required that a **member property** is associated with any **cache field** (section 2.2.5.3.5) or **pivot field** (section 2.2.5.4.3). If there is no **cache field** (section 2.2.5.3.5) with a **stFieldName** field of the **SXFDB record** (section 2.4.283) equal to the **stProperty** field of the **SXAddl_SXCHierarchy_SXDProperty record** (section 2.4.273.57), then this specifies that the **member property** is not associated with any **cache field** (section 2.2.5.3.5) or **pivot field** (section 2.2.5.4.3). Such a **member property** does not participate in the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)) or **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)). + +A **member property** **pivot field** (section 2.2.5.4.3) can be shown only in the **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)) or **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)) of a **PivotTable view** (section 2.2.5.4). A **member property** **pivot field** (section 2.2.5.4.3) can only be shown after the last visible level of the corresponding **pivot hierarchy** (section 2.2.5.4.5). The order of **member property** fields shown in the **PivotTable view** (section 2.2.5.4) is the same as the order of **SXAddl_SXCHierarchy_SXDProperty records** (section 2.4.273.57) in the corresponding **pivot hierarchy** (section 2.2.5.4.5). + +##### Manual Filters + +A manual filter enables specific **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) or [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) associated with **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) to be shown or hidden in the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). **Manual filtering** affects calculations when **pivot fields** (section 2.2.5.4.3) that have **manual filters** are located on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)), **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)), or **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)). The **pivot items** (section 2.2.5.4.4) that are hidden for such **pivot fields** (section 2.2.5.4.3) are not included when calculating values for the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +At least one **SXVI record** (section [2.4.312](#sxvi)) following an **Sxvd record** (section [2.4.309](#sxvd)) MUST have the **fHidden** field equal to 0x0. + +Details about manual **filtering** for **pivot fields** (section 2.2.5.4.3) on the **page axis** (section 2.2.5.4.9.1) are covered in the Page Axis section. + +###### Non-OLAP Manual Filters + +For non-**OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)), the state of the **manual filter** (section [2.2.5.4.7](#Section_b0b282651e334c86ad030f5693c1d1e4)) on a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) can be determined by the value of the **fHidden** field of the **SXVI records** (section [2.4.312](#sxvi)) directly following the corresponding **Sxvd record** (section [2.4.309](#sxvd)). This field specifies whether the corresponding **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) is shown or hidden in the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). + +For non-[**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) **PivotTable** (section 2.2.5) with **PivotCache functionality level** (section [2.2.5.3.1](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8)) greater than or equal to 3, the **fFilterInclusive** field of the **SXAddl_SXCField12_SXDVer12Info record** (section [2.4.273.33](#sxaddl_sxcfield12_sxdver12info)) specifies whether new **pivot items** (section 2.2.5.4.4) in the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) are shown or hidden by default when the **PivotTable report** (section 2.2.5) is refreshed in addition to the **pivot items** (section 2.2.5.4.4) that are already shown in the **PivotTable report** (section 2.2.5) as the result of an applied **manual filter** (section 2.2.5.4.7). + +###### OLAP Manual Filters + +For **OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)), **manual filtering** (section [2.2.5.4.7](#Section_b0b282651e334c86ad030f5693c1d1e4)) operates on **pivot hierarchies** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)). **OLAP manual filtering** uses filtering lists to determine what filtering to apply. The **OLAP manual filtering** operation depends on the **PivotCache Functionality Level** (section [2.2.5.3.1](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8)) of the **associated PivotCache** (section [2.2.5.4.1](#Section_6f60301b107346d3b7ad0041566272a4)) of the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +The list of excluded [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) is specified by the **rgHiddenMemberSets** field of the **SXTH record** (section [2.4.308](#sxth)). If the **fFilterInclusive** field of the **SXTH record** (section 2.4.308) of the **pivot hierarchy** (section 2.2.5.4.5) is equal to 0x1, the list of excluded OLAP members MUST be empty. + +The list of included OLAP members is specified by a collection of **SXAddl_SXCHierarchy_SXDFilterMember12 records** (section [2.4.273.45](#sxaddl_sxchierarchy_sxdfiltermember12)) of the **pivot hierarchy** (section 2.2.5.4.5). If the **PivotCache Functionality Level** (section 2.2.5.3.1) of the **associated PivotCache** (section 2.2.5.4.1) of the **PivotTable view** (section 2.2.5.4) is less than 3, the selected **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) list MUST be empty. If the **fFilterInclusive** field of the **SXTH record** (section 2.4.308) of the **pivot hierarchy** (section 2.2.5.4.5) is equal to 0x0, the list of included OLAP members MUST be empty. + +The selected **pivot items** (section 2.2.5.4.4) list is specified to be the list of **pivot items** (section 2.2.5.4.4), with the **fOlapFilterSelected** field of the **SXVIFlags structure** (section [2.5.263](#sxviflags)) that corresponds to each **pivot item** (section 2.2.5.4.4) equal to 0x1, in the **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) associated with the **pivot hierarchy** (section 2.2.5.4.5). If the **PivotCache Functionality Level** (section 2.2.5.3.1) of the **associated PivotCache** (section 2.2.5.4.1) of the **PivotTable view** (section 2.2.5.4) is less than 3, the selected **pivot items** (section 2.2.5.4.4) list MUST be empty. + +If all of the lists of excluded OLAP members, included OLAP members and the selected **pivot items** (section 2.2.5.4.4) are empty, then no **manual filtering** (section 2.2.5.4.7) is specified for the **pivot hierarchy** (section 2.2.5.4.5). Otherwise, the value of the **fFilterInclusive** field of the **SXTH record** (section 2.4.308) of the **pivot hierarchy** (section 2.2.5.4.5) determines how the lists are used. + +If the **fFilterInclusive** field of the **SXTH record** (section 2.4.308) of the **pivot hierarchy** (section 2.2.5.4.5) is equal to 0x1, the [**members (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) of the included OLAP members list and their ascendants and descendants are included in the **manual filter** (section 2.2.5.4.7). The **pivot items** (section 2.2.5.4.4) in the selected **pivot items** (section 2.2.5.4.4) list, and their ascendants and descendants are also included in the **manual filter** (section 2.2.5.4.7). New OLAP members in the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) will be excluded by default when the **PivotTable view** (section 2.2.5.4) is refreshed. + +If the **fFilterInclusive** field of the **SXTH record** (section 2.4.308) of the **pivot hierarchy** (section 2.2.5.4.5) is equal to 0x0, the members (2) of the excluded OLAP members list and their descendants are excluded in the **manual filter** (section 2.2.5.4.7). The **pivot items** (section 2.2.5.4.4) in the selected **pivot items** (section 2.2.5.4.4) list and their descendants are also excluded in the **manual filter** (section 2.2.5.4.7). New OLAP members in the **source data** (section 2.2.5.3.2) will be included by default when the **PivotTable view** (section 2.2.5.4) is refreshed. + +The filtering lists do not include OLAP members which are parent or child members (1) of other OLAP members in the lists. + +##### Filtering by Criteria + +**Filtering by criteria** is the ability to conditionally show **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) of **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) based on user-defined criteria. For example, a criteria [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) might be defined to show all products that sold for more than \$30,000. + +###### Advanced Filters + +An **advanced filter** specifies a user-defined criterion that is used to determine the **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) of a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) that are included when calculating values for the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) and that are displayed in the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). + +Only **advanced filters** that are associated with **pivot fields** (section 2.2.5.4.3) that are located on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)) or the **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)) are applied when the **PivotTable view** (section 2.2.5.4) is calculated. + +An **advanced filter** is specified by the [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154) section. The **isxvd** field of the **SXAddl_SXCSXFilter12_SXDSXFilter record** (section [2.4.273.82](#sxaddl_sxcsxfilter12_sxdsxfilter)) specifies the **pivot field** (section 2.2.5.4.3) associated with the **a**dvanced filter. + +**Advanced filters** MUST NOT be applied to **pivot fields** (section 2.2.5.4.3) of a **PivotTable view** (section 2.2.5.4) if the **PivotCache functionality level** (section [2.2.5.3.1](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8)) of the **associated PivotCache** (section [2.2.5.4.1](#Section_6f60301b107346d3b7ad0041566272a4)) is less than 3. **Advanced filters** MUST NOT be applied to an **OLAP** **PivotTable view** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)) with a value of 0 for the **fSrvSupportSubquery** field of the **SXAddl_SXCCache_SXDInfo12 record** (section [2.4.273.7](#sxaddl_sxccache_sxdinfo12)) of the **associated PivotCache** (section 2.2.5.4.1). + +There are three types of **advanced filters**: **label filter** (section [2.2.5.4.8.1.1](#Section_f221b81b892c4b5c91722d4ed17c937c)), **date filter** (section [2.2.5.4.8.1.2](#Section_2b9377c5055e4efcbcf587fb13c513bd)), and **value filter** (section [2.2.5.4.8.1.3](#Section_05a1c98e21cd4941979880f4bf301bb2)). + +A **pivot field** (section 2.2.5.4.3) MUST NOT have more than one associated **advanced filter** of the same type. + +####### Label Filters + +A **label filter** specifies a criterion that is applied to **pivot item** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) captions to determine which **pivot items** (section 2.2.5.4.4) are included in the calculation of values for the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) and displayed in the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). + +A **label filter** is specified by an **SXAddl_SXCSXFilter12_SXDSXFilter record** (section [2.4.273.82](#sxaddl_sxcsxfilter12_sxdsxfilter)) with the **sxft** field equal to a value in the range 0x00000004 through 0x00000011. + +**Label filters** are applied before any **value filters** (section [2.2.5.4.8.1.3](#Section_05a1c98e21cd4941979880f4bf301bb2)), but the order of **label filters** is not specified. + +If a caption is specified, the **label filter** is applied to the **stName** field in the **SXVI records** (section [2.4.312](#sxvi)) associated with the **pivot items** (section 2.2.5.4.4). If captions are not specified for the **pivot items** (section 2.2.5.4.4), the **label filter** is applied to the values of the **cache items** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)) associated with these **pivot items** (section 2.2.5.4.4). + +A **label filter** can be applied to **member properties** (section [2.2.5.4.6](#Section_e5db3a66677f43db8fb038584797c95f)). The **isxvdMProp** field of the **SXAddl_SXCSXFilter12_SXDSXFilter record** (section 2.4.273.82) specifies the **member property** (section 2.2.5.4.6) on which this **label filter** is applied. + +####### Date Filters + +A **date filter** specifies a criterion that is applied to date type **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) of a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). A **date filter** determines which **pivot items** (section 2.2.5.4.4) are included in the calculation of the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) and are displayed in the **PivotTable view** (section 2.2.5.4) report. + +**Date filters** are specified by **SXAddl_SXCSXFilter12_SXDSXFilter records** (section [2.4.273.82](#sxaddl_sxcsxfilter12_sxdsxfilter)) with the **sxft** field in the range from 0x0000001A through 0x00000041. + +For non-**OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)), a **date filter** can be applied if and only if the **SXFDB record** (section [2.4.283](#sxfdb)) associated with the corresponding **pivot field** (section 2.2.5.4.3) has the **fDateInField** field equal to 0x1, and the **fNonDates** field is equal to 0. For **OLAP** **PivotTable views** (section 2.2.5.4.2), a date filter can be applied if the **fTimeHierarchy** field of the **SXTH record** (section [2.4.308](#sxth)) that specifies the **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) is equal to 1. + +**Date filters** are applied before **value filters** (section [2.2.5.4.8.1.3](#Section_05a1c98e21cd4941979880f4bf301bb2)) and in no specific order. + +####### Value Filters + +A **value filter** specifies a criterion that is applied to values of a **data item** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) for **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) of the **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) that the **value filter** is applied to. The **value filter** determines which **pivot items** (section 2.2.5.4.4) are included when calculating values for the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) and displayed in the **PivotTable view** (section 2.2.5.4) report. + +A **value filter** is specified by the **SXAddl_SXCSXFilter12_SXDSXFilter records** (section [2.4.273.82](#sxaddl_sxcsxfilter12_sxdsxfilter)) with the **sxft** field equal to a value in one of the following the ranges: from 0x00000001 through 0x00000003 or from 0x00000012 through 0x00000019. + +**Value filters** are applied after **manual filters** (section [2.2.5.4.7](#Section_b0b282651e334c86ad030f5693c1d1e4)), **date filters** (section [2.2.5.4.8.1.2](#Section_2b9377c5055e4efcbcf587fb13c513bd)) and **label filters** (section [2.2.5.4.8.1.1](#Section_f221b81b892c4b5c91722d4ed17c937c)) are applied. **Value filters** are applied in the order in which they are specified in the [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154) section. **Value filtering** takes previous filtering into account when evaluating filters. + +###### Simple Filters + +A **simple filter** is a [**top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9) which is also known as [**AutoShow**](#gt_42126923-0aed-4547-8761-95a0ce2badde). The **fAutoShow** field of the **SXVDEx record** (section [2.4.310](#sxvdex)) specifies whether a **simple filter** is applied for a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). The **fTopAutoShow** field of the **SXVDEx record** (section 2.4.310) specifies whether a **simple filter** applies to the top or bottom *n* items. The **citmAutoShow** field of the **SXVDEx record** (section 2.4.310) specifies the number of **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) displayed. + +**Simple filters** MUST only be applied to **pivot fields** (section 2.2.5.4.3) of a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) with **data functionality level** (section [2.2.5.2](#Section_2bcedd76ef064e6084c718ea55042ed6)) less than or equal to 2, or to **pivot fields** (section 2.2.5.4.3) of an **OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)) with the **fSrvSupportSubquery** field of the **SXAddl_SXCCache_SXDInfo12 record** (section [2.4.273.7](#sxaddl_sxccache_sxdinfo12)) of the corresponding **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) equal to zero. + +##### PivotTable Axes + +A **PivotTable axis** is the set of **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) or **pivot hierarchies** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) in a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) used to populate an area of the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). The placement and positions of **pivot fields** (section 2.2.5.4.3) on the axes are used to determine the **PivotTable Layout** (section [2.2.5.4.10](#Section_2f81b5b422d546778ec53c5dc1ad80d4)). The four axes of a **PivotTable view** (section 2.2.5.4) are the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)), the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)), the **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)), and the **data axis** (section [2.2.5.4.9.5](#Section_4c5c2daa289746e1854b0ce04209f060)). For non- **OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)), a **pivot field** (section 2.2.5.4.3) MUST NOT appear more than once on the **PivotTable view** (section 2.2.5.4), with the exception of the **data axis** (section 2.2.5.4.9.5). For non-**OLAP** **PivotTable views** (section 2.2.5.4.2), a **pivot field** (section 2.2.5.4.3) can be placed one or more times on the **data axis** (section 2.2.5.4.9.5) independently of whether it was placed on any other axis. For **OLAP** **PivotTable views** (section 2.2.5.4.2), a **pivot field** (section 2.2.5.4.3) MUST NOT be placed more than once on any axis. For both [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) and non-**OLAP** **PivotTable views** (section 2.2.5.4.2), **pivot fields** (section 2.2.5.4.3) do not have to be placed on any **PivotTable axis**. + +###### Page Axis + +The **page axis** contains the **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) or **pivot hierarchies** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) that populate the **page area** (section [2.2.5.4.10.1.3](#Section_f10ef7d86c044d35a5830d6f2ce92063)) of the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)), as specified by **PivotTable Layout** (section [2.2.5.4.10](#Section_2f81b5b422d546778ec53c5dc1ad80d4)), and that are intended for use as [**filters**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). These **pivot fields** (section 2.2.5.4.3) and **pivot hierarchies** (section 2.2.5.4.5) do not affect the layout of the other areas of the **PivotTable report** (section 2.2.5), but rather filter the data used by the entire **PivotTable view** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)). + +The **page axis** is specified by the sequence of records that conform to the **PIVOTPI rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) and optionally by the collection of **SXPIEx records** (section [2.4.299](#sxpiex)) in the sequence of records that conform to the **PIVOTVIEWEX rule** (section 2.1.7.20.5). For non-**OLAP** **PivotTable views** (section 2.2.5.4.2), the **SXPI_Item structure** (section [2.5.260](#sxpi_item)) specified by each array element of the **rgsxpi** field of the **SXPI record** (section [2.4.298](#sxpi)) specifies one **pivot field** (section 2.2.5.4.3) on the page axis. For **OLAP** **PivotTable views** (section 2.2.5.4.2), each **SXPIEx record** (section 2.4.299) specifies one **pivot hierarchy** (section 2.2.5.4.5) on the **page axis**. The order of the **pivot fields** (section 2.2.5.4.3) and **pivot hierarchies** (section 2.2.5.4.5) in these collections for the non-[**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) and OLAP cases specifies the order in which the **pivot fields** (section 2.2.5.4.3) and **pivot hierarchies** (section 2.2.5.4.5) appear on the **page axis**. + +For non-**OLAP** **PivotTable views** (section 2.2.5.4.2), the **isxvd** field of the **SXPI_Item structure** (section 2.5.260) specifies the associated **pivot field** (section 2.2.5.4.3). For **OLAP** **PivotTable views** (section 2.2.5.4.2), the **isxth** field of the **SXPIEx record** (section 2.4.299) specifies the associated **pivot hierarchy** (section 2.2.5.4.5). + +####### Non-OLAP Page Filtering + +A non-**OLAP** **PivotTable view** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)) can be filtered to not include some **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) from the **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) on the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)). The **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) only includes values specified by **cache items** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)) that are associated with **pivot items** (section 2.2.5.4.4) that are filtered in. + +The following table specifies how the filtering of **pivot items** (section 2.2.5.4.4) of a **pivot field** (section 2.2.5.4.3) is specified. + +In the following table, the first column is the value of the **rgsxpi**.**isxvi** field of the **SXPI record** (section [2.4.298](#sxpi)), and the second column is the value of the **fSubtotalHiddenPageItems** field of the **SXEx record** (section [2.4.282](#sxex)). + +| Value of rgsxpi.isxvi | Value of fSubtotalHiddenPageItems | Filtering Behavior | +|----|----|----| +| Not 0x7FFD | Any | Specifies that the **rgsxpi**.**isxvi** field of the **SXPI record** (section 2.4.298) specifies a **pivot item** (section 2.2.5.4.4) index, as specified by the Pivot Items section, of the one **pivot item** (section 2.2.5.4.4) of a **pivot field** (section 2.2.5.4.3) that is filtered in. | +| 0x7FFD | 0 | Specifies that **pivot items** (section 2.2.5.4.4) are filtered in if and only if the **fHidden** field of the corresponding **SXVI records (**section [2.4.312](#sxvi)**)** is equal to 0. However, all **pivot items** (section 2.2.5.4.4) are factored into the subtotal. | +| 0x7FFD | 1 | Specifies that **pivot items** (section 2.2.5.4.4) are filtered in if and only if the **fHidden** field of the corresponding **SXVI records (**section 2.4.312**)** is equal to zero. Only **pivot items** (section 2.2.5.4.4) that are filtered in are factored into the subtotal. | + +####### OLAP Page Filtering + +In an **OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)) the filtering on the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)) is specified using the **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) that the **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) is associated with, as specified in the [Association of Pivot Hierarchies and Pivot Fields and Cache Fields](#Section_01a66b9be4a24396b55c28d6207fd28f) section. + +If the value of the **fEnableMultiplePageItems** field of the **SXTH record** (section [2.4.308](#sxth)) of the **pivot hierarchy** (section 2.2.5.4.5) is 0, the **stUnique** field of the **SXPIEx record** (section [2.4.299](#sxpiex)) specifies an [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) to filter by. + +If the value of the **fEnableMultiplePageItems** field of the **SXTH record** (section 2.4.308) of the **pivot hierarchy** (section 2.2.5.4.5) is 1, then the specification depends on the **PivotCache Functionality Level** (section [2.2.5.3.1](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8)) of the **associated PivotCache** (section [2.2.5.4.1](#Section_6f60301b107346d3b7ad0041566272a4)) of the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)), as specified in the following table: + +| PivotCache Functionality Level | Filtering Behavior | +|----|----| +| Less than 3 | Specifies that the **SXAddl_SXCHierarchy_SXDFilterMember records** (section [2.4.273.44](#sxaddl_sxchierarchy_sxdfiltermember)) of the **pivot hierarchy** (section 2.2.5.4.5) specify the OLAP members to filter by. | +| Greater than or equal to 3 | Specifies that the filtering is applied as specified by **Manual Filters** (section [2.2.5.4.7](#Section_b0b282651e334c86ad030f5693c1d1e4)) and **OLAP Manual Filters** (section [2.2.5.4.7.2](#Section_bd4665ebb56a44e690b9ceaf7ec55389)) for this **pivot hierarchy** (section 2.2.5.4.5). | + +###### Row Axis + +The **row axis** contains the **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) and an optional **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)) used to populate the **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)) of the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)), as specified by the [PivotTable Layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4) section. + +The **pivot fields** (section 2.2.5.4.3) on the **row axis** are specified by the first **SxIvd record** (section [2.4.292](#sxivd)) in the sequence of records that conform to the **PIVOTCORE rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) as defined by the Worksheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), which specifies an array of **SxIvdRw structures** (section [2.5.258](#sxivdrw)). The order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) are referenced from the **SxIvd record** (section 2.4.292) specifies the order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) display on the row axis. The order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) display on the row axis corresponds to the order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) are placed in the **row area** (section 2.2.5.4.10.1.1) of the **PivotTable report** (section 2.2.5). + +For adjacent **SxIvdRw structures** (section 2.5.258) in the **rgSxivd** field of the **SxIvd record** (section 2.4.292), the **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) that the first **SxIvdRw references** (section 2.5.258) is defined to be an outer field with respect to the **pivot field** (section 2.2.5.4.3) or the **data field** (section 2.2.5.4.9.5.2) that the second **SxIvdRw references** (section 2.5.258). The **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) that the second **SxIvdRw references** (section 2.5.258) is defined to be an inner field with respect to the **pivot field** (section 2.2.5.4.3) or the **data field** (section 2.2.5.4.9.5.2) that the first **SxIvdRw references** (section 2.5.258). + +For [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) **PivotTables** (section 2.2.5), all **SxIvdRw records** (section 2.5.258) in the **rgSxivd** field of the **SxIvd record** (section 2.4.292) that reference **pivot fields** (section 2.2.5.4.3) that are associated with the same **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) MUST be adjacent. **Pivot fields** (section 2.2.5.4.3) associated with **member properties** (section [2.2.5.4.6](#Section_e5db3a66677f43db8fb038584797c95f)) of the **pivot hierarchy** (section 2.2.5.4.5) MUST be located on the row axis after other types of **pivot fields** (section 2.2.5.4.3) associated with the same **pivot hierarchy** (section 2.2.5.4.5). **Pivot fields** (section 2.2.5.4.3) not associated with **member properties** (section 2.2.5.4.6) of the **pivot hierarchy** (section 2.2.5.4.5) MUST appear on the row axis in an order such that the zero-based ordinal of the [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of each **pivot field** (section 2.2.5.4.3) associated with the same **pivot hierarchy** (section 2.2.5.4.5) is ascending. The zero-based ordinal of the OLAP level of a **pivot field** (section 2.2.5.4.3) is specified by the **isxtl** field of the **SXVDTEx record** (section [2.4.311](#sxvdtex)). + +For OLAP **PivotTables** (section 2.2.5), the **SXTH record** (section [2.4.308](#sxth)) specifies information about a **pivot hierarchy** (section 2.2.5.4.5), including which axis the **pivot hierarchy** (section 2.2.5.4.5) is on. + +See the [Nesting](#Section_7268e3daa5474b95a707fdcfc9f68c64) section for more information. + +###### Column Axis + +The column axis contains the **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) and an optional **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)) used to populate the **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)) of the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)), as specified by the [PivotTable Layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4) section. + +The **pivot fields** (section 2.2.5.4.3) on the row axis are specified by the second **SxIvd record** (section [2.4.292](#sxivd)) in the sequence of records that conform to the **PIVOTCORE rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) as defined by the Worksheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), which specifies an array of **SxIvdCol structures** (section [2.5.257](#sxivdcol)). + +The order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) are referenced from the **SxIvd record** (section 2.4.292) specifies the order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) display on the column axis. The order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) display on the column axis corresponds to the order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) are placed in the **column area** (section 2.2.5.4.10.1.2) of the **PivotTable report** (section 2.2.5). + +For adjacent **SxIvdCol structures** (section 2.5.257) in the **rgSxivd** field of the **SxIvd record** (section 2.4.292), the **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) that the first **SxIvdCol references** (section 2.5.257)is defined to be an outer field with respect to the **pivot field** (section 2.2.5.4.3) or the **data field** (section 2.2.5.4.9.5.2) that the second **SxIvdCol references** (section 2.5.257). The **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) that the second **SxIvdCol references** (section 2.5.257) is defined to be an inner field with respect to the **pivot field** (section 2.2.5.4.3) or the **data field** (section 2.2.5.4.9.5.2) that the first **SxIvdCol references** (section 2.5.257). + +For [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) **PivotTables** (section 2.2.5), all **SxIvdCol structures** (section 2.5.257) in the **rgSxivd** field of the **SxIvd record** (section 2.4.292) that reference **pivot fields** (section 2.2.5.4.3) that are associated with the same **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) MUST be adjacent. **Pivot fields** (section 2.2.5.4.3) associated with **member properties** (section [2.2.5.4.6](#Section_e5db3a66677f43db8fb038584797c95f)) of the **pivot hierarchy** (section 2.2.5.4.5) MUST be located on the column axis after other types of **pivot fields** (section 2.2.5.4.3) associated with the same **pivot hierarchy** (section 2.2.5.4.5). **Pivot fields** (section 2.2.5.4.3) not associated with **member properties** (section 2.2.5.4.6) of the **pivot hierarchy** (section 2.2.5.4.5) MUST appear on the column axis in an order such that the zero-based ordinal of the [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of each **pivot field** (section 2.2.5.4.3) associated with the same **pivot hierarchy** (section 2.2.5.4.5) is ascending. The zero-based ordinal of the OLAP level of a **pivot field** (section 2.2.5.4.3) is specified by the **isxtl** field of the **SXVDTEx record** (section [2.4.311](#sxvdtex)). + +For OLAP **PivotTables** (section 2.2.5), the **SXTH record** (section [2.4.308](#sxth)) specifies information about a **pivot hierarchy** (section 2.2.5.4.5), including which axis the **pivot hierarchy** (section 2.2.5.4.5) is on. + +See the [Nesting](#Section_7268e3daa5474b95a707fdcfc9f68c64) section for more information. + +###### Nesting + +This section applies to both the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)) and **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)) unless otherwise specified. Within this section, axis means the **row axis** (section 2.2.5.4.9.2) or the **column axis** (section 2.2.5.4.9.3) as appropriate; fields means **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)), the **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)), or both on the axis; area means the in **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)) and **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)) as appropriate; items means **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) or **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) as appropriate. + +The axes specify an order that the fields are represented in the areas, see the [PivotTable layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4) section for more information about the areas. **Pivot lines** (section [2.2.5.4.10.3](#Section_76610990666f492791b6d2280f607464)) within the areas have references to items. Usually a **pivot line** (section 2.2.5.4.10.3) including an item of an outer field only includes items in the inner fields that exist with the item of the outer field in the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)), subject to the filtering on the PivotTable view. Usually all the instances of an item in the area are grouped together, with grouping on the outer fields taking precedence over grouping on the inner fields. This process is called **nesting**. + +A nested item group is specified to be the contiguous set of **pivot lines** (section 2.2.5.4.10.3) that have the same item in an outer field. + +The following example shows nested item groups for Country, State and City. + +| Country | State | City | +|---------|-----------|-------------| +| USA | Illinois | Chicago | +| USA | Illinois | Springfield | +| USA | Louisiana | New Orleans | +| USA | Louisiana | Baton Rouge | +| Mexico | Jalisco | Guadalajara | + +The first two lines are a nested item group for Illinois. The next two lines are a nested item group for Louisiana. The first four lines are a nested item group for USA. The last line is both a nested item group for Jalisco and Mexico. Note that often in a **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) the repeated item labels will be omitted. + +For an [**OLAP PivotTable view**](#Section_bbdb91f53cc644e4a812d5e06c977f6f) (section 2.2.5.4.2), nesting can be the result of either: + +- Items in the inner field that are in a different **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)), or, + +- Items in an inner pivot field that is associated with the same **pivot hierarchy** (section 2.2.5.4.5) and that are child OLAP members. + +####### Collapsing + +Settings in the file format can specify that a **pivot item** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) of an outer **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)), rather than having inner nested **pivot items** (section 2.2.5.4.4) of inner **pivot fields** (section 2.2.5.4.3), is collapsed. Usually when a **pivot item** (section 2.2.5.4.4) on an outer **pivot field** (section 2.2.5.4.3) is collapsed, it does not have a nested **pivot item** (section 2.2.5.4.4) group and when it appears in a **pivot line** (section [2.2.5.4.10.3](#Section_76610990666f492791b6d2280f607464)), the **pivot items** (section 2.2.5.4.4) of the inner **pivot fields** (section 2.2.5.4.3) for the collapsed **pivot item** (section 2.2.5.4.4) do not appear in the **pivot line** (section 2.2.5.4.10.3). + +If Illinois and Mexico were collapsed in the preceding table, the result might look like the following table. + +| Country | State | City | +|---------|-----------|-------------| +| USA | Illinois | | +| USA | Louisiana | New Orleans | +| USA | Louisiana | Baton Rouge | +| Mexico | | | + +For a non-**OLAP** **PivotTable view** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)), the collapsed state is specified by the **fHideDetail** field of the **SXVI record** (section [2.4.312](#sxvi)). + +For an **OLAP** **PivotTable views**(section 2.2.5.4.2), there are two types of collapsing: child **collapsing** and [**attribute hierarchy**](#gt_8f75d668-e8c6-4f42-ba44-d90604d3b9dc) **collapsing**. + +Child **collapsing** is when the child **pivot items** (section 2.2.5.4.4), corresponding to child [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32), of a **pivot item** (section 2.2.5.4.4) corresponding to a parent OLAP member in an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) are not shown. + +If a **pivot field** (section 2.2.5.4.3) is the first **pivot field** (section 2.2.5.4.3) of the **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) on the axis then the **fDrilledLevel** field of the **SXVDTEx record** (section [2.4.311](#sxvdtex)) **pivot field** (section 2.2.5.4.3) MUST be 1. + +If a **pivot field** (section 2.2.5.4.3) is not the first **pivot field** (section 2.2.5.4.3) of the **pivot hierarchy** (section 2.2.5.4.5) on the axis and if the **fDrilledLevel** field of the **SXVDTEx record** (section 2.4.311)of the **pivot field** (section 2.2.5.4.3) is 1, then there is no child collapsing for the preceding **pivot field** (section 2.2.5.4.3) of the **pivot hierarchy** (section 2.2.5.4.5) on the axis and the **fDrilledMember** field of the **SXVIFlags structure** (section [2.5.263](#sxviflags)) for the **pivot items** (section 2.2.5.4.4) of the preceding **pivot field** (section 2.2.5.4.3) of the **pivot hierarchy** (section 2.2.5.4.5) on the axis MUST be 0. If a **pivot field** (section 2.2.5.4.3) is followed by another **pivot field** (section 2.2.5.4.3) of the same **pivot hierarchy** (section 2.2.5.4.5) on the axis, and the **fDrilledLevel** field of the **SXVDTEx record** (section 2.4.311) of the inner **pivot field** (section 2.2.5.4.3) is equal to 0 and the **fDrilledMember** field of the **SXVIFlags structure** (section 2.5.263) of the **pivot item** (section 2.2.5.4.4) of the outer **pivot field** (section 2.2.5.4.3) is 0, then the **pivot item** (section 2.2.5.4.4) associated with the **SXVIFlags structure** (section 2.5.263) is collapsed using child **collapsing**. + +Attribute hierarchy **collapsing** only occurs when a **pivot field** (section 2.2.5.4.3) is associated with a **pivot hierarchy** (section 2.2.5.4.5) that is an attribute hierarchy and the **pivot field** (section 2.2.5.4.3) immediately following that outer **pivot field** (section 2.2.5.4.3) is associated with a different **pivot hierarchy** (section 2.2.5.4.5) that is an attribute hierarchy. In that case, if a **pivot item** (section 2.2.5.4.4) is attribute hierarchy collapsed, **pivot items** (section 2.2.5.4.4), corresponding to OLAP members, will not be shown for the inner **pivot field** (section 2.2.5.4.3). The attribute hierarchy collapsed state of a **pivot item** (section 2.2.5.4.4) is specified by the **fCollapsedMember** flag of the **SXVIFlags structure** (section 2.5.263). The **fItemsDrilledByDefault** flag of the **SXVDTEx record** (section 2.4.311) provides a default value for **pivot items** (section 2.2.5.4.4) in the **pivot field** (section 2.2.5.4.3). + +For an **OLAP** **PivotTable view** (section 2.2.5.4.2), there can be **pivot items** (section 2.2.5.4.4) for an inner **pivot field** (section 2.2.5.4.3) on the **pivot line** (section 2.2.5.4.10.3) if either the outer **pivot field** (section 2.2.5.4.3) is collapsed and the inner **pivot field** (section 2.2.5.4.3) and outer **pivot field** (section 2.2.5.4.3) are in different **pivot hierarchies** (section 2.2.5.4.5) and attribute hierarchy **collapsing** is not being used or if the **pivot items** (section 2.2.5.4.4) are **member properties** (section [2.2.5.4.6](#Section_e5db3a66677f43db8fb038584797c95f)). + +####### Subtotalling + +A nested item group, as specified in the [Nesting](#Section_7268e3daa5474b95a707fdcfc9f68c64) section, can have summaries of the values for the items in the nested item group, called subtotals. A subtotal is typically an aggregation such as a sum, count or average of the values of the items. + +The creation of subtotals is specified by the **fDefault**, **fSum**, **fCounta**, **fAverage**, **fMax**, **fMin**, **fProduct**, **fCount**, **fStdev**, **fStdevp**, **fVariance** and **fVariancep** fields of the **Sxvd record** (section [2.4.309](#sxvd)) of the **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). If none of the fields are equal to 1, then no subtotals exist for the **pivot field** (section 2.2.5.4.3). If the **fDefault** field is equal to 1 the subtotal calculation for each item is done according to the [**aggregation functions**](#gt_f9b44a9d-68c4-4a28-b347-cce9eb5f8845) of the **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) on the **data axis** (section [2.2.5.4.9.5](#Section_4c5c2daa289746e1854b0ce04209f060)), as specified by the **iiftab** field of the **SXDI record** (section [2.4.278](#sxdi)) for each **data item** (section 2.2.5.4.9.5.1). + +For example, the subtotal is calculated as the sum of the relevant values of the nested item group for a **data item** (section 2.2.5.4.9.5.1) with a sum aggregation function and subtotal is calculated as the average of the relevant values of the nested item group for a **data item** (section 2.2.5.4.9.5.1) with an average aggregation function. + +The other subtotal fields are called custom subtotals because they override the **data item** (section 2.2.5.4.9.5.1) aggregation function when calculating subtotals. + +In some cases, such as for certain **OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)), the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) is not able to provide a requested subtotal. + +The **fOutline** field of the **SXVDEx record** (section [2.4.310](#sxvdex)) specifies that an extra **pivot line** (section [2.2.5.4.10.3](#Section_76610990666f492791b6d2280f607464)) is added at the logical top of the nested item groups if the **pivot field** (section 2.2.5.4.3) is on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)). This **pivot line** (section 2.2.5.4.10.3) contains the item and any items of **member properties** (section [2.2.5.4.6](#Section_e5db3a66677f43db8fb038584797c95f)) **pivot fields** (section 2.2.5.4.3), if they are shown, but no other items for inner **pivot fields** (section 2.2.5.4.3) of this **pivot field** (section 2.2.5.4.3). + +The **fOutlineData** field of the **SXAddl_SXCView_SXDVer12Info record** (section [2.4.273.109](#sxaddl_sxcview_sxdver12info)) specifies that an extra **pivot line** (section 2.2.5.4.10.3) is added at the logical top of the nested item groups if the **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)) is on the **row axis** (section 2.2.5.4.9.2). This **pivot line** (section 2.2.5.4.10.3) contains the **data item** (section 2.2.5.4.9.5.1), but no other items for inner **pivot fields** (section 2.2.5.4.3) of this **data field** (section 2.2.5.4.9.5.2). + +If the **fDefault** field of the **Sxvd record** (section 2.4.309) of the **pivot field** (section 2.2.5.4.3) is equal to 1, the **fOutline** field of the **SXVDEx record** (section 2.4.310) of the **pivot field** (section 2.2.5.4.3) is equal to 1, the **pivot field** (section 2.2.5.4.3) is on the **row axis** (section 2.2.5.4.9.2), and the **data field** (section 2.2.5.4.9.5.2) is not placed inner of the **pivot field** (section 2.2.5.4.3) on the **row axis** (section 2.2.5.4.9.2), then the following is specified for the **fSubtotalAtTop** field of the **SXVDEx record** (section 2.4.310) of the **pivot field** (section 2.2.5.4.3): + +| Value of fSubtotalAtTop | Meaning | +|----|----| +| 0x0 | Specifies that subtotal **pivot lines** (section 2.2.5.4.10.3) are added at the bottom of the nested item groups. See the **subName.stSubName** field of the **SXVDEx record** (section 2.4.310) for details of the label used. | +| 0x1 | Specifies that the **pivot lines** (section 2.2.5.4.10.3) added as specified by the **fOutline** flag of the **SXVDEx record** (section 2.4.310) being equal to 1 are used for displaying the subtotals in the **data area** (section [2.2.5.4.10.1.4](#Section_237a24905c614931923f7ee856f23c72)). | + +In the following figure, the Category, Subcategory, and Product columns represent **pivot fields** (section 2.2.5.4.3) on the **row axis** (section 2.2.5.4.9.2) and the Color column represents a **member properties** (section 2.2.5.4.6) **pivot field** (section 2.2.5.4.3) associated with the Product **pivot field** (section 2.2.5.4.3). Subtotals are displayed at the logical top of the nested item groups for Clothing, Caps, and Gloves. + +
+ +

Figure 14: PivotTable report with Category and Subcategory pivot fields with fOutline and fSubtotalAtTop fields of the SXVDEx record equal to 1

+
+ +###### Data Axis + +The **data axis** contains the **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) values that are used to populate the **data area** (section [2.2.5.4.10.1.4](#Section_237a24905c614931923f7ee856f23c72)) of the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) as specified by the [PivotTable Layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4) section. The **data axis** also specifies additional information related to summarizing and presenting the values as specified by the [Data Items](#Section_b51aa7b309b34aa78cb4964ad24d1679) section. The **data axis** is specified by the collection of **SXDI records** (section [2.4.278](#sxdi)) that conform to the **PIVOTCORE rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) as defined by the Worksheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +####### Data Items + +A **data item** is a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) placed on the **data axis** (section [2.2.5.4.9.5](#Section_4c5c2daa289746e1854b0ce04209f060)). Each **data item** is specified by an **SXDI record** (section [2.4.278](#sxdi)). + +The **isxvdData** field of the **SXDI record** (section 2.4.278) specifies a reference to the **pivot field** (section 2.2.5.4.3) that is associated with a **data item**. It also specifies additional information that is used to produce or present summarized values. + +A **data item** can be referenced by a data item index, which is the zero-based index of an **SXDI record** (section 2.4.278) in the sequence of records that conforms to the **PIVOTCORE rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) as defined by the Worksheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +####### Data Field + +The **data field** is a conceptual field that represents all **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) and enables them to be referenced as a single object. The **data field** is intended to enable all **data items** (section 2.2.5.4.9.5.1) to be placed on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)) or **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)). + +If the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) has more than one **data item** (section 2.2.5.4.9.5.1), then the **data field** MUST be located on either the **row axis** (section 2.2.5.4.9.2) as specified by the **rgSxivd** field of the first **SxIvd record** (section [2.4.292](#sxivd)), or the **column axis** (section 2.2.5.4.9.3) as specified by the **rgSxivd** field of the second **SxIvd record** (section 2.4.292). + +##### PivotTable Layout + +The **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) in the [**sheet (2)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) has four main areas: the **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)), the **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)), the **data area** (section [2.2.5.4.10.1.4](#Section_237a24905c614931923f7ee856f23c72)), and the **page area** (section [2.2.5.4.10.1.3](#Section_f10ef7d86c044d35a5830d6f2ce92063)). + +
+ +

Figure 15: PivotTable report illustrating the four different areas

+
+ +All the records described here MUST exist in the same **worksheet substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +###### Location and Body + +The **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)) is located immediately above the **data area** (section [2.2.5.4.10.1.4](#Section_237a24905c614931923f7ee856f23c72)). The [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the **column area** (section 2.2.5.4.10.1.2) containing the **pivot item** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) [**caption**](#gt_81d81412-1575-4084-ba61-742de406b418) or **data item** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) caption to the farthest [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) is in the same column as the [**logical top-left**](#gt_88b25c47-61c2-44de-abb0-12ea3348a412) cell of the **data area** (section 2.2.5.4.10.1.4). + +The **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)) is located immediately to the logical left of the **data area** (section 2.2.5.4.10.1.4). The cell in the **row area** (section 2.2.5.4.10.1.1) containing the top-most **pivot item** (section 2.2.5.4.4) caption or **data item** (section 2.2.5.4.9.5.1) caption is in the same row as the logical top-left cell of the **data area** (section 2.2.5.4.10.1.4). + +The **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) body is the rectangular area defined by the union of the **row area** (section 2.2.5.4.10.1.1), **column area** (section 2.2.5.4.10.1.2), and **data area** (section 2.2.5.4.10.1.4). + +The **page area** (section [2.2.5.4.10.1.3](#Section_f10ef7d86c044d35a5830d6f2ce92063)), if it is not empty, is located above the **PivotTable report** (section 2.2.5) body. There is one row between the top-most cell of the **PivotTable report** (section 2.2.5) body and the bottom-most cell of the **page area** (section 2.2.5.4.10.1.3). + +The **PivotTable report** (section 2.2.5) is a [**non-contiguous range**](#gt_3c4e66c6-ccfd-405c-ad82-5d30098d09d6) containing the union of the **PivotTable report** (section 2.2.5) body and the **page area** (section 2.2.5.4.10.1.3). + +An [SxView](#sxview) record and the **SXEx record** (section [2.4.282](#sxex)) specify details about the location of the **PivotTable report** (section 2.2.5) in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and the sizes of the areas of the **PivotTable report** (section 2.2.5) as specified by the following. All fields are of the **SxView record** (section 2.4.313) unless otherwise specified. + +The **column area** (section 2.2.5.4.10.1.2) of the **PivotTable report** (section 2.2.5) is specified to be the following range of cells: + +| Column Area | Row or Column Index | +|----------------------|---------------------| +| Top row | **ref.rwFirst** | +| Bottom row | **rwFirstData** – 1 | +| Logical left column | **colFirstData** | +| Logical right column | **ref.colLast** | + +If **colFirstData** is greater than **ref**.**colLast**, the **column area** (section 2.2.5.4.10.1.2) does not exist for this **PivotTable report** (section 2.2.5). + +The **row area** (section 2.2.5.4.10.1.1) of the **PivotTable report** (section 2.2.5) is specified to be the following range of cells: + +| Row Area | Row or Column Index | +|----------------------|----------------------| +| Top row | **rwFirstData** | +| Bottom row | **ref.rwLast** | +| Logical left column | **ref.colFirst** | +| Logical right column | **colFirstData** – 1 | + +If **colFirstData** – 1 is less than **ref.colFirst**, the **row area** (section 2.2.5.4.10.1.1) does not exist for this **PivotTable report** (section 2.2.5). + +The **data area** (section 2.2.5.4.10.1.4) of the **PivotTable report** (section 2.2.5) is specified to be the following range of cells: + +| Data Area | Row or Column Index | +|----------------------|---------------------| +| Top row | **rwFirstData** | +| Bottom row | **ref.rwLast** | +| Logical left column | **colFirstData** | +| Logical right column | **ref.colLast** | + +If the **row area** (section 2.2.5.4.10.1.1) or the **column area** (section 2.2.5.4.10.1.2) does not exist for this **PivotTable report** (section 2.2.5), the **data area** (section 2.2.5.4.10.1.4) does not exist for this **PivotTable report** (section 2.2.5). + +The **page area** (section 2.2.5.4.10.1.3) of the **PivotTable report** (section 2.2.5) is specified to be the following range of cells. The **cRwPage** field and the **cColPage** field are of the **SXEx record** (section 2.4.282): + +| Page Area | Row or Column Index | +|----------------------|-------------------------------------| +| Top row | **ref.rwFirst** – **cRwPage** – 1 | +| Bottom row | **ref.rwFirst** – 2 | +| Logical left column | **ref.colFirst** | +| Logical right column | **ref.colFirst** + **cColPage** – 1 | + +If the **cRwPage** field of the **SXEx record** (section 2.4.282) is equal to 0 and the **fNewDropZones** field of the **SXAddl_SXCView_SXDVer12Info record** (section [2.4.273.109](#sxaddl_sxcview_sxdver12info)) is equal to 1 the **page area** (section 2.2.5.4.10.1.3) does not exist for this **PivotTable report** (section 2.2.5). + +If the **cRwPage** field is equal to 0 and the **fNewDropZones** field is equal to 0, then the **page area** (section 2.2.5.4.10.1.3) of the **PivotTable report** (section 2.2.5) is specified to be the following [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells: + +| Page Area | Row or Column Index | +|----------------------|---------------------| +| Top row | **ref.rwFirst** - 2 | +| Bottom row | **ref.rwFirst** - 2 | +| Logical left column | **ref.colFirst** | +| Logical right column | **ref.colLast** | + +####### Row Area + +The **row area** contains **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)), the optional **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)), or both that are placed on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)), along with associated **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) and **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)). The first row of the **row area** can contain **pivot field** (section 2.2.5.4.3) captions, **data field** (section 2.2.5.4.9.5.2) captions, or both as specified by the **fNoHeaders** field of the **SXAddl_SXCView_SXDVer12Info record** (section [2.4.273.109](#sxaddl_sxcview_sxdver12info)). If the **fNoHeaders** field of the **SXAddl_SXCView_SXDVer12Info record** (section 2.4.273.109) is equal to 0 or the **SXAddl_SXCView_SXDVer12Info record** (section 2.4.273.109) is not present, the **pivot field** (section 2.2.5.4.3) and **data field** (section 2.2.5.4.9.5.2) captions are located above their **pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1). + +**Pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) of the **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) that has a position of 0 on the **row axis** (section 2.2.5.4.9.2) are placed in the first column of the **row area**. For every other **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) on the **row axis** (section 2.2.5.4.9.2), placement of **pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) are calculated as follows: + +- If the previous **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) is not in [**compact axis**](#gt_87303118-9ef7-437d-914a-2ad9964b5e81) mode, then **pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) of the current **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) are placed in the next column of the **row area**. **Pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) are grouped by the parent **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1), which is the **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1) on the immediate [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d). To achieve this, **pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) of the parent **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) can be repeated multiple times. In this case, when **pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) are repeated, the caption is not necessarily displayed in every [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that contains a **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1). For more details, see the [Pivot Lines](#Section_76610990666f492791b6d2280f607464) section. + +- If the previous **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) is in compact axis mode, then the **pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) of the current **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) are placed in the same column as **pivot items** (section 2.2.5.4.4) of the previous **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2). **Pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) are grouped by the parent **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1) and placed immediately under the parent **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1). + +For the **data field** (section 2.2.5.4.9.5.2), if the **fCompactData** field and the **fOutlineData** field of the **SXAddl_SXCView_SXDVer12Info record** (section 2.4.273.109) are equal to 1, this specifies that the **data field** (section 2.2.5.4.9.5.2) is in compact axis mode. If the **SXAddl_SXCView_SXDVer12Info** (section 2.4.273.109) is not present, the **data field** (section 2.2.5.4.9.5.2) is not in compact axis mode. + +For **pivot fields** (section 2.2.5.4.3), if the **fCompact** flag on the **SXAddl_SXCField12_SXDVer12Info record** (section [2.4.273.33](#sxaddl_sxcfield12_sxdver12info)) is equal to 1 and **fOutline** field of the [SXVDEx](#sxvdex) record is equal to 1, this specifies that the **pivot field** (section 2.2.5.4.3) is in compact axis mode. If the **SXAddl_SXCField12_SXDVer12Info record** (section 2.4.273.33) is not present, the **pivot field** (section 2.2.5.4.3) is not in compact axis mode. + +The **row area** can have special entries at the end for [**grand totals**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7). If there are no **pivot fields** (section 2.2.5.4.3) and no **data field** (section 2.2.5.4.9.5.2) on the **row axis** (section 2.2.5.4.9.2), then the **row area** is empty. + +####### Column Area + +The **column area** contains **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)), the optional **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)), or both placed on the **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)), along with associated **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) or **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)). The first row of the **column area** can contain **pivot field** (section 2.2.5.4.3) captions, **data field** (section 2.2.5.4.9.5.2) captions, or both as specified by the **fNoHeaders** field of the **SXAddl_SXCView_SXDVer12Info record** (section [2.4.273.109](#sxaddl_sxcview_sxdver12info)). + +If the **fNoHeaders** field of the **SXAddl_SXCView_SXDVer12Info record** (section 2.4.273.109) is equal to 0, and no **pivot fields** (section 2.2.5.4.3) are in [**compact axis**](#gt_87303118-9ef7-437d-914a-2ad9964b5e81) mode, and the **data field** (section 2.2.5.4.9.5.2) is not in compact axis mode, then the **pivot field** (section 2.2.5.4.3) and **data field** (section 2.2.5.4.9.5.2) captions are placed sequentially in [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) of the first row of the **column area** according to their placement on the **column axis** (section 2.2.5.4.9.3). + +If the **fNoHeaders** field of the **SXAddl_SXCView_SXDVer12Info record** (section 2.4.273.109) is equal to 0, and any **pivot field** (section 2.2.5.4.3) is in compact axis mode or the **data field** (section 2.2.5.4.9.5.2) is in compact axis mode, the **pivot field** (section 2.2.5.4.3) and **data field** (section 2.2.5.4.9.5.2) captions are placed in the top [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) cell of the **column area**. + +For the **data field** (section 2.2.5.4.9.5.2), if the **fCompactData** field and the **fOutlineData** field of the **SXAddl_SXCView_SXDVer12Info record** (section 2.4.273.109) are equal to 1, this specifies that the **data field** (section 2.2.5.4.9.5.2) is in compact axis mode. If the **SXAddl_SXCView_SXDVer12Info record** (section 2.4.273.109) is not present, the **data field** (section 2.2.5.4.9.5.2) is not in compact axis mode. + +For **pivot fields** (section 2.2.5.4.3), if the **fCompact** flag on the **SXAddl_SXCField12_SXDVer12Info record** (section [2.4.273.33](#sxaddl_sxcfield12_sxdver12info)) is equal to 1 and **fOutline** field of the [SXVDEx](#sxvdex) record is equal to 1, this specifies that the **pivot field** (section 2.2.5.4.3) is in compact axis mode. If the **SXAddl_SXCField12_SXDVer12Info record** (section 2.4.273.33) is not present, the **pivot field** (section 2.2.5.4.3) is not in compact axis mode. + +The second row in the **column area** contains **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1) labels for the **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) placed first on the **column axis** (section 2.2.5.4.9.3), and each subsequent row contains the **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1) labels for **pivot fields** (section 2.2.5.4.3) or **data fields** (section 2.2.5.4.9.5.2) that occur later on the **column axis** (section 2.2.5.4.9.3). The row containing **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1) labels for the **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) at position *n* is row (*n* +1) of the **column area**. + +If the **fNoHeaders** field is equal to 1, the **pivot field** (section 2.2.5.4.3) and **data field** (section 2.2.5.4.9.5.2) captions are not displayed. The row containing **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1) labels for the **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) at position *n* on the **column axis** (section 2.2.5.4.9.3) is row *n* of the **column area**. + +The **column area** can have special entries at the end for [**grand totals**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7). + +####### Page Area + +The **page area** contains **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) that are placed on the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)) for non-**OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)) and **pivot hierarchies** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) that are placed on the **page axis** (section 2.2.5.4.9.1) for **OLAP** **PivotTable views** (section 2.2.5.4.2). For each **pivot field** (section 2.2.5.4.3) or **pivot hierarchy** (section 2.2.5.4.5) on the **page axis** (section 2.2.5.4.9.1), the page area contains a caption and information about the current filtering associated with the **pivot field** (section 2.2.5.4.3) or **pivot hierarchy** (section 2.2.5.4.5) in the next [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) at the [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7). The relative position of pairs of caption and filtering information is specified by the **SxView record** (section [2.4.313](#sxview)) and the **SXEx record** (section [2.4.282](#sxex)). For more details, see the [Location and Body](#Section_7f7d9d76a55041d9ae9f0d8539cc09f8) section. + +####### Data Area + +The **data area** contains summarized values for the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). [**Cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the **data area** contain summarized values for associated **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)). The summarized value in a cell is restricted by all the **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) in the **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)) that are located in the same column, by all the **pivot items** (section 2.2.5.4.4) in the **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)) that are located in the same row, and by any page filter applied, as specified in the [Page Axis](#Section_ff63f3d9274542878e6e11120ecf30b7) section. + +If the **row area** (section 2.2.5.4.10.1.1) has a [**grand total**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7), then the value in that row is not restricted by **pivot items** (section 2.2.5.4.4) from the **row area** (section 2.2.5.4.10.1.1). If the **column area** (section 2.2.5.4.10.1.2) has a grand total, then the value in that column is not restricted by **pivot items** (section 2.2.5.4.4) from the **column area** (section 2.2.5.4.10.1.2). If the **PivotTable view** (section 2.2.5.4) has more than one **data item** (section 2.2.5.4.9.5.1), then the associated **data item** (section 2.2.5.4.9.5.1) is the one that is located in the same column in the **column area** (section 2.2.5.4.10.1.2) or the same row in the **row area** (section 2.2.5.4.10.1.1) as the cell with the summarized value. + +If a **PivotTable view** (section 2.2.5.4) has zero **data items** (section 2.2.5.4.9.5.1) then the **data area** is empty. + +###### Truncation + +When a **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) does not fit within the boundaries of the [**sheet (2)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) it is truncated from the [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) and the bottom. It is truncated such that a part of the **PivotTable report** (section 2.2.5) is displayed within the sheet boundaries. + +###### Pivot Lines + +A **pivot line** specifies a collection of **pivot line entries** (section [2.2.5.4.10.4](#Section_ecba812f4a31495ebeb46749e5897f2d)) for a single row or column in the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). + +A **pivot line** in the **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)) is the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) defined by the intersection of: + +- A column. + +- A set of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the **column area** (section 2.2.5.4.10.1.2). These are cells that contain **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)), **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)), blank cells, or a [**grand total**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7). + +A **pivot line** in the **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)) is the range defined by the intersection of: + +- A row. + +- A set of cells in the **row area** (section 2.2.5.4.10.1.1). These are cells that contain **pivot items** (section 2.2.5.4.4), **data items** (section 2.2.5.4.9.5.1), blank cells, or a grand total. + +A **pivot line** is specified by a sequence of records that conforms to the **PIVOTLI rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). If either the **cRw** field or the **cCol** field of the associated **SxView record** (section [2.4.313](#sxview)) is greater than 0, then two **PIVOTLI rules** (section 2.1.7.20.5) MUST exist in the sequence of records that conforms to the **PIVOTCORE rule** (section 2.1.7.20.5), otherwise a **PIVOTLI rule** (section 2.1.7.20.5) MUST NOT exist in the **PIVOTCORE rule** (section 2.1.7.20.5). + +If **PIVOTLI rules** (section 2.1.7.20.5) for a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) exist, the first **PIVOTLI rule** (section 2.1.7.20.5) specifies the collection of **pivot lines** for the **row area** (section 2.2.5.4.10.1.1). The order of the **SXLIItem structures** (section [2.5.259](#sxliitem)) in the **rgsxli** field of the **SXLI record** (section [2.4.293](#sxli)) specifies the top to bottom order of the **pivot lines** of the **row area** (section 2.2.5.4.10.1.1). + +If **PIVOTLI rules** (section 2.1.7.20.5) for a **PivotTable view** (section 2.2.5.4) exist, the second **PIVOTLI rule** (section 2.1.7.20.5) specifies the collection of **pivot lines** for the **column area** (section 2.2.5.4.10.1.2). The order of the **SXLIItem structures** (section 2.5.259) in the **rgsxli** field of the **SXLI record** (section 2.4.293) specifies the [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) to [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) order of the **pivot lines** of the **column area** (section 2.2.5.4.10.1.2). + +Each individual **pivot line** is specified by an **SXLIItem structure** (section 2.5.259) in the **rgsxli** field of the associated **SXLI record** (section 2.4.293). Each **pivot line** contains a number of **pivot line entries** (section 2.2.5.4.10.4). **Pivot line entries** (section 2.2.5.4.10.4) are specified by the **rgisxvi** field of the **SXLIItem structure** (section 2.5.259). + +The first **pivot line** in the **row area** (section 2.2.5.4.10.1.1) or the **column area** (section 2.2.5.4.10.1.2) MUST have a **cSic** field of its associated **SXLIItem structure** (section 2.5.259) equal to 0. + +The following shows an example of a **PivotTable report** (section 2.2.5) and the pivot lines corresponding to each row in the **row area** (section 2.2.5.4.10.1.1). + +
+ +

Figure 16: PivotTable and a table illustrating each pivot line

+
+ +###### Pivot Line Entries + +**Pivot line entries** specify references to the **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)), **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)), or blank items of a **pivot line** (section [2.2.5.4.10.3](#Section_76610990666f492791b6d2280f607464)). **Pivot line entries** are specified by the records that conform to the **PIVOTLI rules** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) in the **PIVOTCORE rule** (section 2.1.7.20.5). A **pivot line entry** is an element in the array specified by the **rgisxvi** field of the **SXLIItem structure** (section [2.5.259](#sxliitem)). + +All **pivot line entries** that have an index less than the value specified by the **cSic** field of the **SXLIItem structure** (section 2.5.259) of a given **pivot line** (section 2.2.5.4.10.3) are identical to those of the **pivot line** (section 2.2.5.4.10.3) preceding the given **pivot line** (section 2.2.5.4.10.3). + +For the purposes of the rest of this section, *n* specifies a position of the **pivot line entry** of a given **pivot line** (section 2.2.5.4.10.3). + +If the value of *n* is less than the **cSic** field of the **SXLIItem structure** (section 2.5.259) of a given **pivot line** (section 2.2.5.4.10.3), then the **pivot line entry** at position *n* is identical to the corresponding **pivot line entry** of the **pivot line** (section 2.2.5.4.10.3) preceding the given **pivot line** (section 2.2.5.4.10.3). + +If the value of *n* is greater than or equal to the **cSic** field of the **SXLIItem structure** (section 2.5.259) of a given **pivot line** (section 2.2.5.4.10.3), then the value of *n* is equal to the sum of the **cSic** field of the **SXLIItem structure** (section 2.5.259) and the current index in the **rgisxvi** field of the **SXLIItem structure** (section 2.5.259) of the given **pivot line** (section 2.2.5.4.10.3). + +If a **pivot line entry** is in a **pivot line** (section 2.2.5.4.10.3) in the **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)), each **pivot line entry** at a position *n* specifies a **pivot item** (section 2.2.5.4.4) index of a **pivot item** (section 2.2.5.4.4) in the *n*th **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)) or specifies a **data item** (section 2.2.5.4.9.5.1) index, if the *n*th field of the **row axis** (section 2.2.5.4.9.2) is the **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)). + +If a **pivot line entry** is in a **pivot line** (section 2.2.5.4.10.3) in the **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)), each pivot line entry at a position *n* specifies the **pivot item** (section 2.2.5.4.4) index of a **pivot item** (section 2.2.5.4.4) in the *n*th **pivot field** (section 2.2.5.4.3) on the **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)) or specifies a **data item** (section 2.2.5.4.9.5.1) index, if the *n*th field on the **column area** (section 2.2.5.4.10.1.2) is the **data field** (section 2.2.5.4.9.5.2). + +If the *n*th **pivot field** (section 2.2.5.4.3) on the **row axis** (section 2.2.5.4.9.2) or **column axis** (section 2.2.5.4.9.3) is the **data field** (section 2.2.5.4.9.5.2), the **pivot line entry** is a **data items** (section 2.2.5.4.9.5.1) index, as specified by the Data Items section. + +**Pivot items** (section 2.2.5.4.4) are specified sequentially from [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) to [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) for row **pivot lines** (section 2.2.5.4.10.3), and from top to bottom for column **pivot lines** (section 2.2.5.4.10.3). + +A value of 0x7FFF is used to specify the absence of a **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1). + +##### PivotTable Rules + +A **PivotTable rule** is used to specify [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). A **PivotTable rule** is specified by the sequence of records that conform to the **PIVOTRULE rule** (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)) or by an **SxcSXRule class** (section [2.2.5.1.1.1.11](#Section_dd12edef6e8747379bed6f4ceff33127)). Each **PivotTable rule** has references to specific area of a **PivotTable report** (section 2.2.5), [**pivot fields**](#Section_1edf7f2294084945b2de56526c14fca5) (section 2.2.5.4.3), **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)), **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)), or **cache items** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)). These references are used to determine the ranges of cells in the **PivotTable report** (section 2.2.5). The various areas of the **PivotTable report** (section 2.2.5) specified in the [Location and Body](#Section_7f7d9d76a55041d9ae9f0d8539cc09f8) section and the **pivot lines** (section [2.2.5.4.10.3](#Section_76610990666f492791b6d2280f607464)) can be used in this determination. + +The **SxRule** (section [2.4.301](#sxrule)) or **SXAddl_SXCSXrule_SXDSXrule** (section [2.4.273.99](#sxaddl_sxcsxrule_sxdsxrule)) records specify information for a **PivotTable rule**, including restrictions such as what areas of the **PivotTable report** (section 2.2.5) the **PivotTable rule** applies to. In the case of the **SxRule record** (section 2.4.301) the fCacheBased field specifies whether the **PivotTable rule** specifies **cache items** (section 2.2.5.3.6) instead of **pivot items** (section 2.2.5.4.4). + +A **PivotTable rule** can have PivotTable rule filters. A PivotTable rule filter is specified by the sequence of records that conform to a **PRFILTER rule** (section 2.1.7.20.6) or an **SxcSXFilt class** (section [2.2.5.1.1.1.12](#Section_22611924dd5649078c7ab385cd2ccdc0)). A PivotTable rule filter specifies a set of **pivot items** (section 2.2.5.4.4), **data items** (section 2.2.5.4.9.5.1), or **cache items** (section 2.2.5.3.6) for an individual **pivot field** (section 2.2.5.4.3), **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)), or **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)). + +Ranges of cells that are associated, in the **PivotTable report** (section 2.2.5), with any **pivot item** (section 2.2.5.4.4), **data item** (section 2.2.5.4.9.5.1), or **cache item** (section 2.2.5.3.6) from a PivotTable rule filter and that meet other restrictions as specified by the **SxFilt** (section [2.4.285](#sxfilt)) or **SXAddl_SXCSXfilt_SXDSXfilt** (section [2.4.273.77](#sxaddl_sxcsxfilt_sxdsxfilt)) record are associated with the PivotTable rule filter. Ranges of cells that are associated with every PivotTable rule filter of the PivotTable **rule** and that meet other restrictions of the **PivotTable rule** are the ranges of cells specified by the **PivotTable rule**. + +A range of cells is associated with a particular **cache item** (section 2.2.5.3.6) if it is associated with the **pivot item** (section 2.2.5.4.4) that has an association with that **cache item** (section 2.2.5.3.6). + +### Styles + +This overview describes how formatting and protection information for [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) is specified. + +Cell formatting is composed of several sets of properties: + +- [**Font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) properties (bold, italic, font color, font size, etc…) + +- [**Fill**](#gt_215c1c51-d5ef-46af-8596-d7ef63c1fe89) properties ([**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a), [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c), pattern, gradient, etc…) + +- Alignment properties (left, center, right alignment, etc…) + +- [**Border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) properties (left, right, top, bottom, thick or thin, color, etc…) + +- Number formatting properties (date, time, number of decimal places, etc…) + +- [**Protection**](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499) properties ([**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81), [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd), etc…) + +These properties, as a whole, describe how a particular cell is displayed and printed. + +There are two types of objects that contain formatting properties. They are **XFs** (section [2.2.6.1](#Section_4fe94af3cd05427ab32d1f27a85c412a)) and **DXFs** (section [2.2.6.2](#Section_f0b6070c31f54d3dbcb719612da8b8f6)). In general, **XFs** (section 2.2.6.1) describe the formatting directly associated with a cell, and **DXFs** (section 2.2.6.2) describe additional formatting properties that can be applied to one or more cells. + +#### XFs + +**XFs** specify formatting for [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and **cell styles** (section [2.2.6.1.2](#Section_f9425d3f127545be8389bf80f65b56b7)). **XFs** are specified by records in the **XFS collection** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). This collection contains **XF** (section [2.4.353](#xf)) and **XFExt** (section [2.4.355](#xfext)) records, which specify formatting properties. + +##### Cell XFs + +A **cell XF** is specified by an **XF** record (section [2.4.353](#xf)) (and an optional **XFExt record** (section [2.4.355](#xfext))) where the **fStyle** field of the **XF** record (section 2.4.353) equals 0. Each [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) MUST reference a **cell XF**. These records specify the complete set of formatting properties for the cells that reference them. + +##### Cell Styles + +**Cell styles** specify a set of formatting properties that can be associated with one or more [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). **Cell styles** provide two benefits: + +- The set of formatting properties in a **cell style** can be applied to one or more cells in a single operation. + +- After a **cell style** is applied to a cell, subsequent changes to the formatting properties in the **cell style** can be propagated to the cell automatically. + +For example, if it is desired that multiple cells in a [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) share a common set of formatting properties, like bold [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) with a blue [**fill**](#gt_215c1c51-d5ef-46af-8596-d7ef63c1fe89), then **cell styles** make it convenient to apply this set of formatting, and potentially modify the set later. + +Supporting information for a **cell style** is specified in a **Style** record (section [2.4.269](#style)) (and optional **StyleExt** record (section [2.4.270](#styleext))). This information includes a [**friendly name**](#gt_3dafc161-8c9d-406a-8cbd-c61e7f925eea) for the **cell style** and an index to the **cell style XF** (section [2.2.6.1.2.1](#Section_3d5348ded9df4c31b1fd9f9377273152)) that specifies the formatting for the **cell style**. + +###### Cell Style XFs + +A **cell style XF** is specified by an **XF** record (section [2.4.353](#xf)) (and an optional **XFExt record** (section [2.4.355](#xfext))) where the **fStyle** field of the **XF** record (section 2.4.353) equals 1. Each [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) MUST reference a **cell XF** (section [2.2.6.1.1](#Section_518a740d71c640c8bb97e7df6915861a)), and each **cell XF** (section 2.2.6.1.1) MUST reference a **cell style XF** with the **ixfParent** field. + +###### Normal Style + +At least one **cell style** (section [2.2.6.1.2](#Section_f9425d3f127545be8389bf80f65b56b7)) MUST be included in the **STYLES collection** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) and this **cell style** (section 2.2.6.1.2) is called the **Normal style**. The **Normal style** MUST reference the first **XF** record (section [2.4.353](#xf)) in the **XFS collection** (section 2.1.7.20.3), and this **XF** record (section 2.4.353) MUST be a **cell style XF** (section [2.2.6.1.2.1](#Section_3d5348ded9df4c31b1fd9f9377273152)), where the **fStyle** field equals 1. + +The **Normal style**, being the only required **cell style** (section 2.2.6.1.2), ensures that all [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) have a **cell style** (section 2.2.6.1.2) to reference. The **Normal style** also provides a convenient object in which to store default cell formatting properties for an entire [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), because all cells will typically reference the **Normal style** by default, until they are modified to reference a different **cell style** (section 2.2.6.1.2). + +#### Differential Formatting (DXFs) + +Like **XFs** (section [2.2.6.1](#Section_4fe94af3cd05427ab32d1f27a85c412a)), **DXFs** define a set of formatting properties. Unlike **XFs** (section 2.2.6.1), **DXFs** can define any number of formatting properties, from just one to all of them. + +**DXFs** provide a way for features to reference a set of formatting properties. How those properties are used depends on the feature. The subsections that follow describe each of these features and how they use **DXFs**. + +**DXFs** can be specified in several different ways. The following records and structures specify a **DXF**: + +- **DXF** (section [2.4.97](#dxf)) + +- **DXFN** (section [2.5.95](#dxfn)) + +- **DXFN12** (section [2.5.96](#dxfn12)) + +- **DXFN12List** (section [2.5.97](#dxfn12list)) + +- **DXFN12NoCB** (section [2.5.98](#dxfn12nocb)) + +**DXF records** (section 2.4.97) are saved into a collection as specified by [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) and referenced with a **DXFId** (section [2.5.94](#dxfid)). + +The remaining structures are saved within containing records, such as **CF** (section [2.4.42](#cf)) and **SxDXF** (section [2.4.280](#sxdxf)). **DXFN12** (section 2.5.96), **DXFN12List** (section 2.5.97), and **DXFN12NoCB** (section 2.5.98) are extensions of the **DXFN structure** (section 2.5.95). + +##### Conditional Formatting + +Some [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules, as specified by the records in the **CONDFMT collection** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)), reference a **DXF** (section [2.2.6.2](#Section_f0b6070c31f54d3dbcb719612da8b8f6)). That **DXF** (section 2.2.6.2) describes additional formatting applied to [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the bounds of the rule, if the rule’s condition is TRUE for those cells. + +##### Table Style Elements + +**Table style elements**, as specified by **TableStyleElement** (section [2.4.321](#tablestyleelement)), can reference a **DXF** (section [2.2.6.2](#Section_f0b6070c31f54d3dbcb719612da8b8f6)). That **DXF** (section 2.2.6.2) describes additional formatting applied to [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the bounds of the **table style element**. + +##### Table Block-Level Formatting + +**Table block-level formatting**, as specified by **List12BlockLevel** (section [2.5.174](#list12blocklevel)), can reference one or more **DXFs** (section [2.2.6.2](#Section_f0b6070c31f54d3dbcb719612da8b8f6)). These **DXFs** (section 2.2.6.2) represent formatting that can be applied to the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the appropriate regions of the [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +##### PivotTable Areas + +A **PivotTable format** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)), as specified by an **SxFormat** record (section [2.4.287](#sxformat)), can specify a **DXF** (section [2.2.6.2](#Section_f0b6070c31f54d3dbcb719612da8b8f6)). This **DXF** (section 2.2.6.2) represents formatting that can be applied to the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the appropriate area of the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +##### Sorting and Filtering + +Sorting, as specified by **SortCond12** (section [2.5.242](#sortcond12)), and filtering, as specified by **AutoFilter12** (section [2.4.7](#autofilter12))**,** can include formatting properties as part of their criteria. These properties are stored as **DXFs** (section [2.2.6.2](#Section_f0b6070c31f54d3dbcb719612da8b8f6)). For example, a [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) criteria that is "filter only [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) with red [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) color" will reference a **DXF** (section 2.2.6.2) with the property "font color = red". + +#### Table Styles + +**Table styles** specify additional formatting for [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) inside [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) or **PivotTable views** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +Tables can specify an applied **table style** with the **List12TableStyleClientInfo** record (section [2.5.176](#list12tablestyleclientinfo)). **PivotTable views** (section 2.2.5.4) specify an applied **table style** with the **SXAddl_SXCView_SXDTableStyleClient** record (section [2.4.273.107](#sxaddl_sxcview_sxdtablestyleclient)). These two records reference a **table style** by name with the **stListStyleName** and **stName** fields, respectively. + +**Table styles** are either built-in or custom. Built-in **table styles** are specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) part 1, 18.8.40. Custom **table styles** used in a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) are specified in the collection of records beginning with **TableStyles** (section [2.4.322](#tablestyles)). + +A **table style** consists of a collection of **table style elements** (section [2.2.6.2.2](#Section_84f2f67849214e8c83eb10d4fff7e935)). For custom **table styles**, these elements are specified by the collection of **TableStyleElement** records (section [2.4.321](#tablestyleelement)) following the **TableStyle** record (section [2.4.320](#tablestyle)). + +Each **table style element** (section 2.2.6.2.2) specifies the formatting to be applied to cells in a particular region of the table or **PivotTable view** (section 2.2.5.4). These regions are specified by the possible values of the **tseType** field of the **TableStyleElement** record (section 2.4.321). + +#### Format Conflicts + +As described previously, the formatting to be displayed or printed for a particular [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) can be specified in several independent records. It is up to the application to resolve conflicting formatting properties for a particular cell. + +As an example, say a cell has a **conditional format** (section [2.2.6.2.1](#Section_abb828767c9c4377858fb1a6be7fe8f9)) applied and also falls within the bounds of a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) with a **table style** (section [2.2.6.3](#Section_4ac7212b4aa74ece962526c58224ae80)). Furthermore, say the **cell XF** (section [2.2.6.1.1](#Section_518a740d71c640c8bb97e7df6915861a)), **conditional format** (section 2.2.6.2.1) and **table style element** (section [2.2.6.2.2](#Section_84f2f67849214e8c83eb10d4fff7e935)) all specify a different [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) color. It is up to the application to decide the appropriate font color to use in this situation. + +### External References + +The **external references** infrastructure exists to support **formulas** (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) which reference [**data sources**](#gt_e091613c-6901-4874-b9b2-27273ead1075) outside the scope of the [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) on which the **formula** (section 2.2.2) resides. These sources could be other sheets (1) in the same [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), data in another workbook, [**DDE**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) links or [**Object Linking and Embedding (OLE)**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) links. A workbook that uses **external references** contains a collection of **XTI records** (section [2.5.344](#xti)) that in turn reference **SupBook records** (section [2.4.271](#supbook)) that specify the source of the data. + +#### External Reference Consumers + +Within the formula, only certain **formula elements** (section [2.2.2.6](#Section_9f95ff16743f4882bbb4242d6e560069)) can contain external references. These specific **formula elements** (section 2.2.2.6) contain an **XtiIndex structure** (section [2.5.198.119](#xtiindex)) specifying an **XTI** (section [2.5.344](#xti)), which in turn specifies the location and type of the external reference data. Only the following **Ptg structures** (section [2.5.198.25](#ptg)) can be **external r**eference **consumers**: + +- **PtgRef3d** (section [2.5.198.85](#ptgref3d)) + +- **PtgRefErr3d** (section [2.5.198.87](#ptgreferr3d)) + +- **PtgArea3d** (section [2.5.198.28](#ptgarea3d)) + +- **PtgAreaErr3d** (section [2.5.198.30](#ptgareaerr3d)) + +- **PtgNameX** (section [2.5.198.77](#ptgnamex)) + +#### Supporting Link + +Each **formula element** (section [2.2.2.6](#Section_9f95ff16743f4882bbb4242d6e560069)) which references external data refers to a **XTI** (section [2.5.344](#xti)). The **XTI** (section 2.5.344) references a **SupBook record** (section [2.4.271](#supbook)) that specifies the type of **supporting link** and, in certain cases, specifies additional data about the **supporting link**. + +There are several types of **supporting links**. The type of the **supporting link** used is specified by the **cch** and **virtPath** fields of the **SupBook record** (section 2.4.271). **Supporting link** types are specified in the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Supporting Link TypeMeaning
Self-Referencing

A reference to the current workbook.

+

This supporting link type supports cross-sheet (1) references, where the target sheets (1) are specified by the XTI (section 2.5.344). This record also supports defined name or User Defined Function (UDF) references on the same book.

Same-Sheet Referencing

A reference to the active sheet in the context of the consuming formula (section 2.2.2).

+

This supporting link type is used by formulas in macro sheets and in defined names to reference the sheet (1) of the caller.

Add-in ReferencingA reference to a UDF on any Excel Linked Library (XLL) or COM add-in.
External Workbook ReferencingA reference to an External Workbook (section 2.2.7.3).
DDE Data Source ReferencingA reference to a DDE Data Source (section 2.2.7.6).
OLE Data Source ReferencingA reference to an OLE Data Source (section 2.2.7.8).
UnusedAn unused supporting link. A reference to this type of supporting link can be specified by an XTI (section 2.5.344), but that XTI (section 2.5.344) MUST NOT be used by any external reference consumer (section 2.2.7.1).
+ +#### External Workbook + +An external workbook link is a reference to a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) other than the one in which the source **formula** (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) resides. It contains the referencing [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106), and data relating to that expression. This data includes the workbook location, [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) names, **external defined names** (section [2.2.7.4](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2)), and an **external cell cache** (section [2.2.7.5](#Section_b985d1a223f3483ebebdbd0e882d4c89)) for referenced cells in that workbook. + +#### External Defined Name + +An external defined name is a reference to a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) in an **external workbook** (section [2.2.7.3](#Section_c8bd9cdbb0784622a3bffb87f35a36cc)). The records specifying the external defined name will provide the name, scope, and **formula** (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) of the defined name on that [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The restrictions on the types of **formulas** (section 2.2.2) supported in **external defined names** are described in **ExtNameParsedFormula** (section [2.5.198.10](#extnameparsedformula)). + +#### External Cell Cache + +To allow external cell references to be calculated without opening the referenced [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), an **external** cell **cache** is stored in the file which contains cached values for cells in a [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in an **external workbook** (section [2.2.7.3](#Section_c8bd9cdbb0784622a3bffb87f35a36cc)). The **external** cell **cache** contains [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) values of the specific cells that are referenced in that sheet (1). The beginning of an **external** cell **cache** is specified by the **XCT** record (section [2.4.352](#xct)). + +The **external** cell **cache** is composed of a collection of sequences of cells that correspond to cells in the source sheet (1). Each cell sequence is specified by a **CRN** record (section [2.4.65](#crn)). + +#### DDE Data Source + +A **DDE data source** specifies information about the [**DDE server**](#gt_aa46dc6a-247b-459b-8acd-af7550514fee) and [**DDE topic**](#gt_c1335a84-baa7-4fc6-904c-cccdbf74bc2a) name of a [**Dynamic Data Exchange (DDE)**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) connection. A **DDE data source** is specified by the **SupBook record** (section [2.4.271](#supbook)). + +#### DDE Data Item + +A **DDE data i**tem specifies the name and properties of a [**DDE**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) item. It also contains cached values from the most recent DDE data update. A **DDE data** item is specified by the **ExternName** record (section [2.4.105](#externname)). + +#### OLE Data Source + +An **OLE data source** specifies information about an [**OLE2**](#gt_0b0e3a28-4780-4123-9bfd-f933b01d64a4) data connection. It specifies the path to the OLE2 [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) file and the [**ProgID**](#gt_06b2ae3d-4106-49f3-9ca0-e2bcd649e75a) of the application handler. An **OLE data source** is specified by the **SupBook record** (section [2.4.271](#supbook)). + +#### OLE Data Item + +An **OLE data i**tem specifies the name and properties of a connection to an [**OLE2**](#gt_0b0e3a28-4780-4123-9bfd-f933b01d64a4) data object. Unlike **DDE Data Sources** (section [2.2.7.6](#Section_b11538fba8244cc3bf8834a1cf5f3559)), **OLE Data Sources** (section [2.2.7.8](#Section_2318e95632614d72a28e412392b8c919)) do not store cached data returned by OLE2 data objects. An **OLE data** item is specified by the **ExternName** record (section [2.4.105](#externname)). + +### External Connections + +A [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) often pulls in data from external [**data sources**](#gt_e091613c-6901-4874-b9b2-27273ead1075), such as a database or an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7). An **external connection** represents a link between a workbook and a particular external data source. It contains properties about the way that the application establishes the connection to the data source and retrieves the data, such as the type of [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) ([**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31), [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e), and so on), a [**server name**](#gt_854f54be-1a9d-40d2-82e5-55cf9e48e2c2), security information, and a command to execute on the server. In addition, the **external connection** contains details about the way the connection is used in the workbook, such as how often to refresh the data. + +A data connection object contains **external connection** information for an external data source that a workbook uses. Data connection objects are independent of the constructs in the workbook that display data, such as [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) or **PivotTables** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). + +A connection definition can be established in an **external connection** file for easier sharing and reuse, but this overview describes the representation for external data connections that are directly embedded within a workbook file. This embedded representation is required whenever external data is used, and ensures portability of the document and continued operation of the external query in the most cases. + +An **external** connection is specified by a combination of the records defined in **DBQUERY_WORKBOOK** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)), **DBQUERY_WORKSHEET** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)), **DBQUERYEXT** (section 2.1.7.20.5) and **SXADDLDBQUERY** (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)), and the **DConn** record (section [2.4.84](#dconn)). + +If an **external** connection is not used by any workbook object, it is represented only by a **DConn** record (section 2.4.84) and the **fStandAlone** field of the **DConn** record (section 2.4.84) is set to 1. + +#### Connection Name + +Each external connection has a unique name, which can be used by the application as a user-friendly name for the connection, for example, for UI purposes. The **c**onnection **name** is specified by the **rgchConnectionName** field of the **DConn** record (section [2.4.84](#dconn)). + +#### External Connection Files + +An **external connection** file specifies an external connection in a separate file (external to the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe)). An **external connection** file enables managing connection information separately from a specific workbook and sharing it among multiple workbooks. It is used for creating a new data connection in a workbook or for restoring a lost connection. The **stSourceConnectionFile** field of the **SXAddl_SXCQuery_SXDSrcConnFile record** (section [2.4.273.65](#sxaddl_sxcquery_sxdsrcconnfile)) and the **rgchSourceConnectionFile** field of the **DConn** record (section [2.4.84](#dconn)) specify a path to an external connection file. + +#### OLE DB Connections + +An **OLE DB connection** is a connection to an [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). An external connection is an **OLE DB connection** if the **dbt** field of the **DbQuery** record (section [2.4.80](#dbquery)) is 0x5, the **dbt** field of the **DBQueryExt** record (section [2.4.81](#dbqueryext)) is **DBT_OLEDB** (section [2.5.64](#datasourcetype)), and the **dbt** field of the **DConn** record (section [2.4.84](#dconn)) is **DBT_OLEDB** (section 2.5.64). + +##### OLAP Connections + +An **OLAP connection** is a connection to an [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) for [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). An OLE DB connection is an **OLAP connection** if the **dbost** field of the **ConnGrbitDbtOledb** structure (section [2.5.59](#conngrbitdbtoledb)) is 0x1. + +#### ODBC Connections + +An **ODBC connection** is a connection to an [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). An external connection is an **ODBC connection** if the **dbt** field of the **DbQuery** record (section [2.4.80](#dbquery)) is 0x1, the **dbt** field of the **DBQueryExt** record (section [2.4.81](#dbqueryext)) is **DBT_ODBC** (section [2.5.64](#datasourcetype)), and the **dbt** field of the **DConn** record (section [2.4.84](#dconn)) is **DBT_ODBC** (section 2.5.64). For more information about ODBC, see [\[MSDN-OpenDBConnectivity\]](https://go.microsoft.com/fwlink/?LinkId=114655). + +#### Web Connections + +A **Web connection** pulls the content of a Web page, or part of a Web page (an [**HTML**](#gt_549c4960-e8be-4c24-bc2b-b86530f1c1bf) table), into the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). An external connection is a **Web** connection if the **dbt** field of the **DbQuery** record (section [2.4.80](#dbquery)) is 0x4, the **dbt** field of the **DBQueryExt** record (section [2.4.81](#dbqueryext)) is **DBT_WEB** (section [2.5.64](#datasourcetype)), and the **dbt** field of the **DConn** record (section [2.4.84](#dconn)) is **DBT_WEB** (section 2.5.64). + +#### Text Import Connections + +A **text import connection** pulls in data from a structured text file into the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). An external connection is a **text import connection** if the **dbt** field of the **DbQuery** record (section [2.4.80](#dbquery)) is 0x6, the **dbt** field of the **DBQueryExt** record (section [2.4.81](#dbqueryext)) is **DBT_TXT** (section [2.5.64](#datasourcetype)), and the **dbt** field of the **DConn** record (section [2.4.84](#dconn)) is **DBT_TXT** (section 2.5.64). + +#### ADO Recordset Connections + +An [**ADO**](#gt_3477d72a-874b-4a2a-b6a9-1431c128df49) recordset pulls in data from a set of records in an ADO [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). An external connection is an **ADO recordset connection** if the **dbt** field of the **DbQuery** record (section [2.4.80](#dbquery)) is 0x7, the **dbt** field of the **DBQueryExt** record (section [2.4.81](#dbqueryext)) is **DBT_ADO** (section [2.5.64](#datasourcetype)), and the **dbt** field of the **DConn** record (section [2.4.84](#dconn)) is **DBT_ADO** (section 2.5.64). + +Note: For this type of connection, the file format does not contain sufficient information for establishing the connection and fetching a recordset. Data is provided to the application through another mechanism, for example by script code using an [**object model**](#gt_91bed4f8-fc06-4d55-b040-7a84c42e4973). + +#### DAO Recordset Connections + +A DAO recordset pulls in data from a set of records in a DAO [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). An external connection is a **DAO recordset connection** if the **dbt** field of the **DbQuery** record (section [2.4.80](#dbquery)) is 0x2, the **dbt** field of the **DBQueryExt** record (section [2.4.81](#dbqueryext)) is **DBT_DAO** (section [2.5.64](#datasourcetype)), and the **dbt** field of the **DConn** record (section [2.4.84](#dconn)) is **DBT_DAO** (section 2.5.64). + +Note: For this type of connection, the file format does not contain sufficient information for establishing the connection and fetching a recordset. Data is provided to the application through another mechanism, for example by script code using an [**object model**](#gt_91bed4f8-fc06-4d55-b040-7a84c42e4973). + +### Password Verifier Algorithm + +Several records (**Password** (section [2.4.191](#password)), **FileSharing** (section [2.4.118](#filesharing)), **Prot4RevPass** (section [2.4.206](#prot4revpass)), **FeatProtection** (section [2.5.124](#featprotection)), and **FilePass** (section [2.4.117](#filepass))) use a password verifier to provide a locking and unlocking system for viewing or editing parts of the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). This password verifier is used to prevent accidental editing, and is not designed to be used as a security feature. The verifier value is calculated in two stages. First, the provided [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) password string is converted to a new character string in the [**American National Standards Institute (ANSI) character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583) code page of the current system using the algorithm specified in the **revisionsPassword** attribute in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) part 4, 15.3.3. Second, this string is input into the [**XOR obfuscation**](#gt_cbfd1a35-e8c9-4c5a-bc26-e618633d2f50) algorithm specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083), 2.3.7.1, Binary Document Password Verifier Derivation Method 1 to produce a 16-bit password verifier value. + +See the [Security Considerations](#Section_6df63a1fecd54d13801ea5321aa39caa) section for information about security concerns related to the use of this algorithm for password verification in this file format.[\<19\>](#Appendix_A_19) + +### Encryption (Password to Open) + +[**Workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) files can contain sensitive information that needs to be protected. A file can be protected by **encrypting** it using a password[\<20\>](#Appendix_A_20). Once a file is **encrypted**, the data can only be accessed by decrypting the file using the same password. + +If a file in this format is saved with **encryption** it MUST be saved with [**XOR obfuscation**](#gt_cbfd1a35-e8c9-4c5a-bc26-e618633d2f50)[\<21\>](#Appendix_A_21) as specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.3.7, or RC4 **encryption** as specified in \[MS-OFFCRYPTO\] section 2.3.6, or one of a number of RC4 CryptoAPI **encryption**[\<22\>](#Appendix_A_22) algorithms as specified in \[MS-OFFCRYPTO\] section 2.3.5. The specific obfuscation or **encryption** method being used, and the associated obfuscation or **encryption** information, is specified in the **FilePass** record (section [2.4.117](#filepass)). + +If RC4 CryptoAPI **encryption** is used, certain storages and [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) are stored in the **Encryption Stream** (section [2.1.7.6](#Section_3ff73530461c45079b669e18aba3124e)) as specified in \[MS-OFFCRYPTO\] section 2.3.5.3. See the following table for details. + +| Storage/Stream | XOR obfuscation or RC4 encryption | RC4 CryptoAPI encryption | +|----|----|----| +| **Component Object Stream** (section [2.1.7.1](#Section_0259345a59e34ab0b489a467b7c19498)) | Not encrypted | Not encrypted. | +| **Control Stream** (section [2.1.7.2](#Section_ce07d64476c84d368badb6419bd152fe)) | Not encrypted | Encrypted in **encryption stream** (section 2.1.7.6). | +| **Data Spaces Storage** (section [2.1.7.3](#Section_2d2a5085fa014807b232f39878b399ce)) | Not encrypted | Not encrypted. | +| **Document Summary Information Stream** (section [2.1.7.4](#Section_a9dabd4a684845a689f40ce0caa11c75)) | Not encrypted | Encrypted in **encryption stream** (section 2.1.7.6) if and only if flag is set \*\* | +| **Embedding Storage** (section [2.1.7.5](#Section_b406ade0fb1c4512bff2b576fdfff545)) | Not encrypted | Encrypted in **encryption stream** (section 2.1.7.6). | +| **Link Storage** (section [2.1.7.7](#Section_a05f262bbc9a44be88b4eba16b41ac6b)) | Not encrypted | Encrypted in **encryption stream** (section 2.1.7.6). | +| **List Data Stream** (section [2.1.7.8](#Section_914f09bd8c944c099e8631dfe058f037)) | Not encrypted | Encrypted in **encryption stream** (section 2.1.7.6). | +| **Office Data Store Storage** (section [2.1.7.9](#Section_ab70c85c1750466f8887c2f343ae4b4f)) | Not encrypted | Not encrypted. | +| **Office Toolbars Stream** (section [2.1.7.10](#Section_3c0ad5b8a61e486c802e282c02c1897a)) | Not encrypted | Not encrypted. | +| **OLE Stream** (section [2.1.7.11](#Section_77f7aefa1bd44d0a970b809503c38bee)) | Not encrypted | Not encrypted. | +| **Pivot Cache Storage** (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687))\* | Encrypted | Encrypted. | +| **Protected Content Stream** (section [2.1.7.13](#Section_a1671bd186fc480a885152d714a5cc02)) | Not encrypted | Not encrypted. | +| **Revision Stream** (section [2.1.7.14](#Section_d120a1ffd2e6488381a507236f1994b0))\* | Encrypted | Encrypted. | +| **Signatures Stream** (section [2.1.7.15](#Section_23a8b9bf5ae447a7ad42a9aa7d84f75b)) | Not encrypted | Not encrypted. | +| **Summary Information Stream** (section [2.1.7.16](#Section_d604544ba58044ad99d6ca20855a9036)) | Not encrypted | Encrypted in **encryption stream** (section 2.1.7.6) if and only if flag is set \*\* | +| **User Names Stream** (section [2.1.7.17](#Section_1b98bc4df7c640a088dba99426635acd))\* | Not encrypted | Not encrypted. | +| **VBA Storage** (section [2.1.7.18](#Section_27d93f33eaa941d49ec07f2a69d8ff5f)) | Not encrypted | Not encrypted. | +| **Viewer Content Stream** (section [2.1.7.19](#Section_120ab19d71cd43a3be1b88828891cc6a)) | Not encrypted | Not encrypted | +| **Workbook Stream** (section [2.1.7.20](#Section_f682f4b08c6b444e83f852d156f1e8ba))\* | Encrypted | Encrypted. | +| **XML Signatures Storage** (section [2.1.7.21](#Section_f8e1068d19e04fe890720dbb4ff75de7)) | Not encrypted | Not encrypted. | +| **XML Stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)) | Not encrypted | Encrypted in **encryption stream** (section 2.1.7.6) | + +> \* The indicated items specify either streams that contain [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) records as specified in **Record** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)) or storages that contain streams that contain BIFF records as specified in **Record** (section 2.1.4). When obfuscating or **encrypting** BIFF records in these streams the record type and record size components MUST NOT be obfuscated or encrypted. In addition the following records MUST NOT be obfuscated or **encrypted**: **BOF** (section [2.4.21](#bof)), **FilePass** (section 2.4.117), **UsrExcl** (section [2.4.339](#usrexcl)), **FileLock** (section [2.4.116](#filelock)), **InterfaceHdr** (section [2.4.146](#interfacehdr)), **RRDInfo** (section [2.4.227](#rrdinfo)), and **RRDHead** (section [2.4.226](#rrdhead)). Additionally, the **lbPlyPos** field of the **BoundSheet8 record** (section [2.4.28](#boundsheet8)) MUST NOT be **encrypted**. +> +> \*\* The indicated streams for the indicated **encryption** method MUST be **encrypted** if and only if the 0x08 bit of **EncryptionHeader.flags** is equal to 0. **EncryptionHeader.flags** is specified in \[MS-OFFCRYPTO\] section 2.3.5.1. + +For XOR obfuscation, the obfuscation key is generated as specified in the [Password Verifier Algorithm](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4) section. The algorithm for XOR obfuscation is specified in \[MS-OFFCRYPTO\] section 2.3.7. The [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) password string is converted to a new character string in the ANSI code page of the current system using the algorithm specified in the **revisionsPassword** attribute in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) part 4, 15.3.3. The new string is then provided as input into the XOR obfuscation array initialization as specified in \[MS-OFFCRYPTO\] section 2.3.7.2. The initialized array is then used by the algorithm specified in \[MS-OFFCRYPTO\] section 2.3.7.3 to obfuscate the file data. + +For RC4 **encryption** and RC4 CryptoAPI **encryption**, the Unicode password string is used to generate the **encryption** key as specified in \[MS-OFFCRYPTO\] section 2.3.6.2 or \[MS-OFFCRYPTO\] section 2.3.5.2 depending on the RC4 algorithm used. The record data is then **encrypted** by the specific RC4 algorithm in 1024-byte blocks. The block number is set to zero at the beginning of every BIFF record stream, and incremented by one at each 1024-byte boundary. Bytes to be encrypted are passed into the RC4 **encryption** function and then written to the stream. For unencrypted records and the record headers consisting of the record type and record size, a byte buffer of all zeros, of the same size as the section of unencrypted bytes, is passed into the RC4 **encryption** function. The results are then ignored and the unencrypted bytes are written to the stream. + +See the [Security Considerations](#Section_6df63a1fecd54d13801ea5321aa39caa) section for information about security concerns relating to file **encryption** for this file format. + +### Shared Workbooks + +The **shared workbook** infrastructure is used to enable multiple users to make changes to a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) at the same time as well as track changes that certain users make. A **shared workbook** contains a collection of users that currently have the document open and a set of **revision logs** (section [2.2.11.2](#Section_2cbd26e86f7e4195ada414c8b7e595b8)) that contain the changes that users have made to the workbook. Each of these logs has a corresponding revision header associated with it and contains either a set of **revision records** (section [2.2.11.3](#Section_9e91e8bce4f249b897d4741481349d1b)) that have been made to the **shared workbook** because it has been shared or no **revision records** (section 2.2.11.3). A workbook is a **shared workbook** if and only if the **user names stream** (section [2.1.7.17](#Section_1b98bc4df7c640a088dba99426635acd)) exists. + +
+ +

Figure 17: Structure of shared workbooks

+
+ +The following sections define terms used in this diagram. + +#### User Log + +The **user log** contains the set of users who currently have the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) open. The **iCount** field of **CUsr** (section [2.4.72](#cusr)) specifies the number of **UsrInfo records** (section [2.4.340](#usrinfo)) that this section contains. Each **UsrInfo** record (section 2.4.340) corresponds to a user that currently has the workbook open. The **guid** field of the **UsrInfo maps** (section 2.4.340) to the **guid** field of **RRDHead** (section [2.4.226](#rrdhead)) that specifies which **revision log** (section [2.2.11.2](#Section_2cbd26e86f7e4195ada414c8b7e595b8)) the user is currently synchronized to. + +#### Revision Logs + +The revision **logs** section contains a set of revision **logs**. Each revision **log** contains various **revision records** (section [2.2.11.3](#Section_9e91e8bce4f249b897d4741481349d1b)) that a single user has made to a **shared workbook** (section [2.2.11](#Section_e45a62c4490f4304a09668908b57dacc)) or a user action. Each revision **log** has a revision header (**RRDHead** (section [2.4.226](#rrdhead))) and a tab identifier map (**RRTabId** (section [2.4.241](#rrtabid))) that describes general information. The **stUserName** field of **RRDHead** (section 2.4.226)is the name of the user who made changes or performed an action for that particular log. If the revision **log** is meant to describe user changes (and not a user action), it will also contain other revision **log** content that will describe all the changes made by that user. This **revision log** [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) also contains general information about the **shared workbook** (section 2.2.11) in **RRDInfo** (section [2.4.227](#rrdinfo)), **FileLock** (section [2.4.116](#filelock)), and **UsrExcl** (section [2.4.339](#usrexcl)). + +#### Revision Records + +A **revision record** describes changes, or revisions, that a single user has made to a **shared workbook** (section [2.2.11](#Section_e45a62c4490f4304a09668908b57dacc)). The following changes can be recorded by the **shared workbook** (section 2.2.11): + +- Inserting or deleting a row or column (**RRDInsDel** (section [2.4.228](#rrdinsdel))) + +- Moving a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) (**RRDMove** (section [2.4.231](#rrdmove))) + +- Changing a cell (**RRDChgCell** (section [2.4.223](#rrdchgcell))) + +- Adding or removing a [**custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4) (**RRDUserView** (section [2.4.237](#rrduserview))) + +- Renaming an existing [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) (**RRDRenSheet** (section [2.4.234](#rrdrensheet))) + +- Inserting a new sheet (1) (**RRInsertSh** (section [2.4.239](#rrinsertsh))) + +- Changing a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) (**RRDDefName** ()section [2.4.225](#rrddefname)) + +- Changing a [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) (**Note** (section [2.4.179](#note))) + +- Conflict resolution from previous conflicting changes (**RRDConflict** (section [2.4.224](#rrdconflict))) + +- Removing a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) (**RRDTQSIF** (section [2.4.236](#rrdtqsif))) + +- Changing the format (**RRFormat** (section [2.4.238](#rrformat))) + +- Changing the [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f) information for a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) (**RRAutoFmt** (section [2.4.222](#rrautofmt))) + +#### Insertion / Deletion of Rows / Columns Revision + +This revision corresponds to an insertion or deletion of a row or column. In between **RRDInsDel** (section [2.4.228](#rrdinsdel)) and **RRDInsDelEnd** (section [2.4.230](#rrdinsdelend)), any number of **RRFormat** (section [2.4.238](#rrformat)) and **RRDChgCell records** (section [2.4.223](#rrdchgcell)) can appear as well as the other records associated with **RRDChgCell** (section 2.4.223) (**RRDRstEtxp** (section [2.4.235](#rrdrstetxp))). These records describe the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and format changes as a result of inserting or deleting the row or column. + +#### Move Cells Revision + +This revision corresponds to moving a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). In between **RRDMove** (section [2.4.231](#rrdmove)) and **RRDMoveEnd** (section [2.4.233](#rrdmoveend)), any number of **RRFormat** (section [2.4.238](#rrformat)) and **RRDChgCell records** (section [2.4.223](#rrdchgcell)) can appear as well as the other records associated with **RRDChgCell** (section 2.4.223) (**RRDRstEtxp** (section [2.4.235](#rrdrstetxp))). These records describe the cell and format changes as a result of moving a range of cells. + +#### Change Cells Revision + +This revision (**RRDChgCell** (section [2.4.223](#rrdchgcell))) corresponds to a change or edit of a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). It can be followed by any number of **RRDRstEtxp records** (section [2.4.235](#rrdrstetxp)). These specify [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information for the [**formatting run**](#gt_10031ac8-2a26-4200-beee-cd8d9420ca96) as specified in **RRDChgCell** (section 2.4.223). + +#### Sort Map + +The **Sort Map** contains changes to sorting done on the [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) level in a **shared workbook** (section [2.2.11](#Section_e45a62c4490f4304a09668908b57dacc)). Each sheet (1) can have a **Sort Map**. The **Sort Map** is made of up to two sorts (**RRSort** (section [2.4.240](#rrsort))). One specifies sheet (1) level sort changes in rows followed by sheet (1) level sort changes in columns. If there are no changes in sort for rows or columns, the sort map does not exist for rows or columns respectively. + +### Shared Feature + +A **shared feature** is a mechanism that enables different application features to share a common set of record types. For an enumeration of the types of **shared features**, see **SharedFeatureType** (section [2.5.237](#sharedfeaturetype)). For each type of **shared feature** the required records vary. All **shared features** use the following: + +- Common information stored in a **FeatHdr** (section [2.4.112](#feathdr)) or **FeatHdr11** (section [2.4.113](#feathdr11)) record. There MUST be one **FeatHdr** (section 2.4.112) or **FeatHdr11** (section 2.4.113) record for each type of **shared feature** used in one of the **Workbook substreams** (section [2.1.7.20](#Section_f682f4b08c6b444e83f852d156f1e8ba)). + +- Instance specific feature data stored in a **Feat** (section [2.4.111](#feat)), **Feature11** (section [2.4.114](#feature11)), or **Feature12** (section [2.4.115](#feature12)) record. There MUST be one or more **Feat** (section 2.4.111), **Feature11** (section 2.4.114), or **Feature12** (section 2.4.115) records for each instance of a **shared feature**. + +Some **shared features** require other feature-specific records. See **FEAT** (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)) and **FEAT11** (section 2.1.7.20.6) records for additional records used for **shared features**. + +## Record Enumeration + +This section specifies the record name associated with a given record type value. For more information about record types, see the section on **Records** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)). + +These associations between record name and record type are listed by record name as well as by record type. + +The type-specific meaning and fields for each record type are specified in the subsection of the **Records section** (section [2.4](#Section_6fba03830d7a4c7aafe9642ff70cbd36)) corresponding to the record name. + +### By Name + +| Name | Record type (number) | +|----|---:| +| **AlRuns** (section [2.4.1](#alruns)) | 4176 | +| **Area** (section [2.4.2](#area)) | 4122 | +| **AreaFormat** (section [2.4.3](#areaformat)) | 4106 | +| **Array** (section [2.4.4](#array)) | 545 | +| **AttachedLabel** (section [2.4.5](#attachedlabel)) | 4108 | +| **AutoFilter** (section [2.4.6](#autofilter)) | 158 | +| **AutoFilter12** (section [2.4.7](#autofilter12)) | 2174 | +| **AutoFilterInfo** (section [2.4.8](#autofilterinfo)) | 157 | +| **AxcExt** (section [2.4.9](#axcext)) | 4194 | +| **AxesUsed** (section [2.4.10](#axesused)) | 4166 | +| **Axis** (section [2.4.11](#axis-1)) | 4125 | +| **AxisLine** (section [2.4.12](#axisline)) | 4129 | +| **AxisParent** (section [2.4.13](#axisparent)) | 4161 | +| **Backup** (section [2.4.14](#backup)) | 64 | +| **Bar** (section [2.4.15](#bar)) | 4119 | +| **BCUsrs** (section [2.4.16](#bcusrs)) | 407 | +| **Begin** (section [2.4.17](#begin)) | 4147 | +| **BigName** (section [2.4.18](#bigname)) | 1048 | +| **BkHim** (section [2.4.19](#bkhim)) | 233 | +| **Blank** (section [2.4.20](#blank)) | 513 | +| **BOF** (section [2.4.21](#bof)) | 2057 | +| **BookBool** (section [2.4.22](#bookbool)) | 218 | +| **BookExt** (section [2.4.23](#bookext)) | 2147 | +| **BoolErr** (section [2.4.24](#boolerr)) | 517 | +| **BopPop** (section [2.4.25](#boppop)) | 4193 | +| **BopPopCustom** (section [2.4.26](#boppopcustom)) | 4199 | +| **BottomMargin** (section [2.4.27](#bottommargin)) | 41 | +| **BoundSheet8** (section [2.4.28](#boundsheet8)) | 133 | +| **BRAI** (section [2.4.29](#brai)) | 4177 | +| **BuiltInFnGroupCount** (section [2.4.30](#builtinfngroupcount)) | 156 | +| **CalcCount** (section [2.4.31](#calccount)) | 12 | +| **CalcDelta** (section [2.4.32](#calcdelta)) | 16 | +| **CalcIter** (section [2.4.33](#calciter)) | 17 | +| **CalcMode** (section [2.4.34](#calcmode)) | 13 | +| **CalcPrecision** (section [2.4.35](#calcprecision)) | 14 | +| **CalcRefMode** (section [2.4.36](#calcrefmode)) | 15 | +| **CalcSaveRecalc** (section [2.4.37](#calcsaverecalc)) | 95 | +| **CatLab** (section [2.4.38](#catlab)) | 2134 | +| **CatSerRange** (section [2.4.39](#catserrange)) | 4128 | +| **CbUsr** (section [2.4.40](#cbusr)) | 402 | +| **CellWatch** (section [2.4.41](#cellwatch)) | 2156 | +| **CF** (section [2.4.42](#cf)) | 433 | +| **CF12** (section [2.4.43](#cf12)) | 2170 | +| **CFEx** (section [2.4.44](#cfex)) | 2171 | +| **Chart** (section [2.4.45](#chart-2)) | 4098 | +| **Chart3d** (section [2.4.46](#chart3d)) | 4154 | +| **Chart3DBarShape** (section [2.4.47](#chart3dbarshape)) | 4191 | +| **ChartFormat** (section [2.4.48](#chartformat)) | 4116 | +| **ChartFrtInfo** (section [2.4.49](#chartfrtinfo)) | 2128 | +| **ClrtClient** (section [2.4.50](#clrtclient)) | 4188 | +| **CodeName** (section [2.4.51](#codename)) | 442 | +| **CodePage** (section [2.4.52](#codepage)) | 66 | +| **ColInfo** (section [2.4.53](#colinfo)) | 125 | +| **Compat12** (section [2.4.54](#compat12)) | 2188 | +| **CompressPictures** (section [2.4.55](#compresspictures)) | 2203 | +| **CondFmt** (section [2.4.56](#condfmt)) | 432 | +| **CondFmt12** (section [2.4.57](#condfmt12)) | 2169 | +| **Continue** (section [2.4.58](#continue)) | 60 | +| **ContinueBigName** (section [2.4.59](#continuebigname)) | 1084 | +| **ContinueFrt** (section [2.4.60](#continuefrt)) | 2066 | +| **ContinueFrt11** (section [2.4.61](#continuefrt11)) | 2165 | +| **ContinueFrt12** (section [2.4.62](#continuefrt12)) | 2175 | +| **Country** (section [2.4.63](#country)) | 140 | +| **CrErr** (section [2.4.64](#crerr)) | 2149 | +| **CRN** (section [2.4.65](#crn)) | 90 | +| **CrtLayout12** (section [2.4.66](#crtlayout12)) | 2205 | +| **CrtLayout12A** (section [2.4.67](#crtlayout12a)) | 2215 | +| **CrtLine** (section [2.4.68](#crtline)) | 4124 | +| **CrtLink** (section [2.4.69](#crtlink)) | 4130 | +| **CrtMlFrt** (section [2.4.70](#crtmlfrt)) | 2206 | +| **CrtMlFrtContinue** (section [2.4.71](#crtmlfrtcontinue)) | 2207 | +| **CUsr** (section [2.4.72](#cusr)) | 401 | +| **Dat** (section [2.4.73](#dat)) | 4195 | +| **DataFormat** (section [2.4.74](#dataformat)) | 4102 | +| **DataLabExt** (section [2.4.75](#datalabext)) | 2154 | +| **DataLabExtContents** (section [2.4.76](#datalabextcontents)) | 2155 | +| **Date1904** (section [2.4.77](#date1904)) | 34 | +| **DBCell** (section [2.4.78](#dbcell)) | 215 | +| **DbOrParamQry** (section [2.4.79](#dborparamqry)) | 220 | +| **DBQueryExt** (section [2.4.81](#dbqueryext)) | 2051 | +| **DCon** (section [2.4.82](#dcon)) | 80 | +| **DconBin** (section [2.4.83](#dconbin)) | 437 | +| **DConn** (section [2.4.84](#dconn)) | 2166 | +| **DConName** (section [2.4.85](#dconname)) | 82 | +| **DConRef** (section [2.4.86](#dconref)) | 81 | +| **DefaultRowHeight** (section [2.4.87](#defaultrowheight)) | 549 | +| **DefaultText** (section [2.4.88](#defaulttext)) | 4132 | +| **DefColWidth** (section [2.4.89](#defcolwidth)) | 85 | +| **Dimensions** (section [2.4.90](#dimensions)) | 512 | +| **DocRoute** (section [2.4.91](#docroute)) | 184 | +| **DropBar** (section [2.4.92](#dropbar)) | 4157 | +| **DropDownObjIds** (section [2.4.93](#dropdownobjids)) | 2164 | +| **DSF** (section [2.4.94](#dsf)) | 353 | +| **Dv** (section [2.4.95](#dv)) | 446 | +| **DVal** (section [2.4.96](#dval)) | 434 | +| **DXF** (section [2.4.97](#dxf)) | 2189 | +| **DxGCol** (section [2.4.98](#dxgcol)) | 153 | +| **End** (section [2.4.99](#end)) | 4148 | +| **EndBlock** (section [2.4.100](#endblock)) | 2131 | +| **EndObject** (section [2.4.101](#endobject)) | 2133 | +| **EntExU2** (section [2.4.102](#entexu2)) | 450 | +| **EOF** (section [2.4.103](#eof)) | 10 | +| **Excel9File** (section [2.4.104](#excel9file)) | 448 | +| **ExternName** (section [2.4.105](#externname)) | 35 | +| **ExternSheet** (section [2.4.106](#externsheet)) | 23 | +| **ExtSST** (section [2.4.107](#extsst)) | 255 | +| **ExtString** (section [2.4.108](#extstring)) | 2052 | +| **Fbi** (section [2.4.109](#fbi)) | 4192 | +| **Fbi2** (section [2.4.110](#fbi2)) | 4200 | +| **Feat** (section [2.4.111](#feat)) | 2152 | +| **FeatHdr** (section [2.4.112](#feathdr)) | 2151 | +| **FeatHdr11** (section [2.4.113](#feathdr11)) | 2161 | +| **Feature11** (section [2.4.114](#feature11)) | 2162 | +| **Feature12** (section [2.4.115](#feature12)) | 2168 | +| **FileLock** (section [2.4.116](#filelock)) | 405 | +| **FilePass** (section [2.4.117](#filepass)) | 47 | +| **FileSharing** (section [2.4.118](#filesharing)) | 91 | +| **FilterMode** (section [2.4.119](#filtermode)) | 155 | +| **FnGroupName** (section [2.4.120](#fngroupname)) | 154 | +| **FnGrp12** (section [2.4.121](#fngrp12)) | 2200 | +| **Font** (section [2.4.122](#font)) | 49 | +| **FontX** (section [2.4.123](#fontx)) | 4134 | +| **Footer** (section [2.4.124](#footer)) | 21 | +| **ForceFullCalculation** (section [2.4.125](#forcefullcalculation)) | 2211 | +| **Format** (section [2.4.126](#format)) | 1054 | +| **Formula** (section [2.4.127](#formula)) | 6 | +| **Frame** (section [2.4.128](#frame)) | 4146 | +| **FrtFontList** (section [2.4.129](#frtfontlist)) | 2138 | +| **FrtWrapper** (section [2.4.130](#frtwrapper)) | 2129 | +| **GelFrame** (section [2.4.131](#gelframe)) | 4198 | +| **GridSet** (section [2.4.132](#gridset)) | 130 | +| **GUIDTypeLib** (section [2.4.133](#guidtypelib)) | 2199 | +| **Guts** (section [2.4.134](#guts)) | 128 | +| **HCenter** (section [2.4.135](#hcenter)) | 131 | +| **Header** (section [2.4.136](#header)) | 20 | +| **HeaderFooter** (section [2.4.137](#headerfooter)) | 2204 | +| **HFPicture** (section [2.4.138](#hfpicture)) | 2150 | +| **HideObj** (section [2.4.139](#hideobj)) | 141 | +| **HLink** (section [2.4.140](#hlink)) | 440 | +| **HLinkTooltip** (section [2.4.141](#hlinktooltip)) | 2048 | +| **HorizontalPageBreaks** (section [2.4.142](#horizontalpagebreaks)) | 27 | +| **IFmtRecord** (section [2.4.143](#ifmtrecord)) | 4174 | +| **Index** (section [2.4.144](#index)) | 523 | +| **InterfaceEnd** (section [2.4.145](#interfaceend)) | 226 | +| **InterfaceHdr** (section [2.4.146](#interfacehdr)) | 225 | +| **Intl** (section [2.4.147](#intl)) | 97 | +| **Label** (section [2.4.148](#label)) | 516 | +| **LabelSst** (section [2.4.149](#labelsst)) | 253 | +| **Lbl** (section [2.4.150](#lbl)) | 24 | +| **LeftMargin** (section [2.4.151](#leftmargin)) | 38 | +| **Legend** (section [2.4.152](#legend-1)) | 4117 | +| **LegendException** (section [2.4.153](#legendexception)) | 4163 | +| **Lel** (section [2.4.154](#lel)) | 441 | +| **Line** (section [2.4.155](#line)) | 4120 | +| **LineFormat** (section [2.4.156](#lineformat)) | 4103 | +| **List12** (section [2.4.157](#list12)) | 2167 | +| **LPr** (section [2.4.158](#lpr)) | 152 | +| **LRng** (section [2.4.159](#lrng)) | 351 | +| **MarkerFormat** (section [2.4.160](#markerformat)) | 4105 | +| **MDB** (section [2.4.161](#mdb)) | 2186 | +| **MDTInfo** (section [2.4.162](#mdtinfo)) | 2180 | +| **MDXKPI** (section [2.4.163](#mdxkpi)) | 2185 | +| **MDXProp** (section [2.4.164](#mdxprop)) | 2184 | +| **MDXSet** (section [2.4.165](#mdxset)) | 2183 | +| **MDXStr** (section [2.4.166](#mdxstr)) | 2181 | +| **MDXTuple** (section [2.4.167](#mdxtuple)) | 2182 | +| **MergeCells** (section [2.4.168](#mergecells)) | 229 | +| **Mms** (section [2.4.169](#mms)) | 193 | +| **MsoDrawing** (section [2.4.170](#msodrawing)) | 236 | +| **MsoDrawingGroup** (section [2.4.171](#msodrawinggroup)) | 235 | +| **MsoDrawingSelection** (section [2.4.172](#msodrawingselection)) | 237 | +| **MTRSettings** (section [2.4.173](#mtrsettings)) | 2202 | +| **MulBlank** (section [2.4.174](#mulblank)) | 190 | +| **MulRk** (section [2.4.175](#mulrk)) | 189 | +| **NameCmt** (section [2.4.176](#namecmt)) | 2196 | +| **NameFnGrp12** (section [2.4.177](#namefngrp12)) | 2201 | +| **NamePublish** (section [2.4.178](#namepublish)) | 2195 | +| **Note** (section [2.4.179](#note)) | 28 | +| **Number** (section [2.4.180](#number)) | 515 | +| **Obj** (section [2.4.181](#obj)) | 93 | +| **ObjectLink** (section [2.4.182](#objectlink)) | 4135 | +| **ObjProtect** (section [2.4.183](#objprotect)) | 99 | +| **ObNoMacros** (section [2.4.184](#obnomacros)) | 445 | +| **ObProj** (section [2.4.185](#obproj)) | 211 | +| **OleDbConn** (section [2.4.186](#oledbconn)) | 2058 | +| **OleObjectSize** (section [2.4.187](#oleobjectsize)) | 222 | +| **Palette** (section [2.4.188](#palette)) | 146 | +| **Pane** (section [2.4.189](#pane)) | 65 | +| **Password** (section [2.4.191](#password)) | 19 | +| **PhoneticInfo** (section [2.4.192](#phoneticinfo)) | 239 | +| **PicF** (section [2.4.193](#picf)) | 4156 | +| **Pie** (section [2.4.194](#pie)) | 4121 | +| **PieFormat** (section [2.4.195](#pieformat)) | 4107 | +| **PivotChartBits** (section [2.4.196](#pivotchartbits)) | 2137 | +| **PlotArea** (section [2.4.197](#plotarea)) | 4149 | +| **PlotGrowth** (section [2.4.198](#plotgrowth)) | 4196 | +| **Pls** (section [2.4.199](#pls)) | 77 | +| **PLV** (section [2.4.200](#plv)) | 2187 | +| **Pos** (section [2.4.201](#pos)) | 4175 | +| **PrintGrid** (section [2.4.202](#printgrid)) | 43 | +| **PrintRowCol** (section [2.4.203](#printrowcol)) | 42 | +| **PrintSize** (section [2.4.204](#printsize)) | 51 | +| **Prot4Rev** (section [2.4.205](#prot4rev)) | 431 | +| **Prot4RevPass** (section [2.4.206](#prot4revpass)) | 444 | +| **Protect** (section [2.4.207](#protect)) | 18 | +| **Qsi** (section [2.4.208](#qsi)) | 429 | +| **Qsif** (section [2.4.209](#qsif)) | 2055 | +| **Qsir** (section [2.4.210](#qsir)) | 2054 | +| **QsiSXTag** (section [2.4.211](#qsisxtag)) | 2050 | +| **Radar** (section [2.4.212](#radar)) | 4158 | +| **RadarArea** (section [2.4.213](#radararea)) | 4160 | +| **RealTimeData** (section [2.4.214](#realtimedata)) | 2067 | +| **RecalcId** (section [2.4.215](#recalcid)) | 449 | +| **RecipName** (section [2.4.216](#recipname)) | 185 | +| **RefreshAll** (section [2.4.217](#refreshall)) | 439 | +| **RichTextStream** (section [2.4.218](#richtextstream)) | 2214 | +| **RightMargin** (section [2.4.219](#rightmargin)) | 39 | +| **RK** (section [2.4.220](#rk)) | 638 | +| **Row** (section [2.4.221](#row)) | 520 | +| **RRAutoFmt** (section [2.4.222](#rrautofmt)) | 331 | +| **RRDChgCell** (section [2.4.223](#rrdchgcell)) | 315 | +| **RRDConflict** (section [2.4.224](#rrdconflict)) | 338 | +| **RRDDefName** (section [2.4.225](#rrddefname)) | 339 | +| **RRDHead** (section [2.4.226](#rrdhead)) | 312 | +| **RRDInfo** (section [2.4.227](#rrdinfo)) | 406 | +| **RRDInsDel** (section [2.4.228](#rrdinsdel)) | 311 | +| **RRDInsDelBegin** (section [2.4.229](#rrdinsdelbegin)) | 336 | +| **RRDInsDelEnd** (section [2.4.230](#rrdinsdelend)) | 337 | +| **RRDMove** (section [2.4.231](#rrdmove)) | 320 | +| **RRDMoveBegin** (section [2.4.232](#rrdmovebegin)) | 334 | +| **RRDMoveEnd** (section [2.4.233](#rrdmoveend)) | 335 | +| **RRDRenSheet** (section [2.4.234](#rrdrensheet)) | 318 | +| **RRDRstEtxp** (section [2.4.235](#rrdrstetxp)) | 340 | +| **RRDTQSIF** (section [2.4.236](#rrdtqsif)) | 2056 | +| **RRDUserView** (section [2.4.237](#rrduserview)) | 428 | +| **RRFormat** (section [2.4.238](#rrformat)) | 330 | +| **RRInsertSh** (section [2.4.239](#rrinsertsh)) | 333 | +| **RRSort** (section [2.4.240](#rrsort)) | 319 | +| **RRTabId** (section [2.4.241](#rrtabid)) | 317 | +| **SBaseRef** (section [2.4.242](#sbaseref)) | 4168 | +| **Scatter** (section [2.4.243](#scatter)) | 4123 | +| **SCENARIO** (section [2.4.244](#scenario)) | 175 | +| **ScenarioProtect** (section [2.4.245](#scenarioprotect)) | 221 | +| **ScenMan** (section [2.4.246](#scenman)) | 174 | +| **Scl** (section [2.4.247](#scl)) | 160 | +| **Selection** (section [2.4.248](#selection)) | 29 | +| **SerAuxErrBar** (section [2.4.249](#serauxerrbar)) | 4187 | +| **SerAuxTrend** (section [2.4.250](#serauxtrend)) | 4171 | +| **SerFmt** (section [2.4.251](#serfmt)) | 4189 | +| **Series** (section [2.4.252](#series-1)) | 4099 | +| **SeriesList** (section [2.4.253](#serieslist)) | 4118 | +| **SeriesText** (section [2.4.254](#seriestext)) | 4109 | +| **SerParent** (section [2.4.255](#serparent)) | 4170 | +| **SerToCrt** (section [2.4.256](#sertocrt)) | 4165 | +| **Setup** (section [2.4.257](#setup)) | 161 | +| **ShapePropsStream** (section [2.4.258](#shapepropsstream)) | 2212 | +| **SheetExt** (section [2.4.259](#sheetext)) | 2146 | +| **ShrFmla** (section [2.4.260](#shrfmla)) | 1212 | +| **ShtProps** (section [2.4.261](#shtprops)) | 4164 | +| **SIIndex** (section [2.4.262](#siindex)) | 4197 | +| **Sort** (section [2.4.263](#sort)) | 144 | +| **SortData** (section [2.4.264](#sortdata)) | 2197 | +| **SST** (section [2.4.265](#sst)) | 252 | +| **StartBlock** (section [2.4.266](#startblock)) | 2130 | +| **StartObject** (section [2.4.267](#startobject)) | 2132 | +| **String** (section [2.4.268](#string)) | 519 | +| **Style** (section [2.4.269](#style)) | 659 | +| **StyleExt** (section [2.4.270](#styleext)) | 2194 | +| **SupBook** (section [2.4.271](#supbook)) | 430 | +| **Surf** (section [2.4.272](#surf)) | 4159 | +| **SXAddl** (section [2.4.273](#Section_3b2dcb9451544f03b24e37a77e48a20e)) | 2148 | +| **SxBool** (section [2.4.274](#sxbool)) | 202 | +| **SXDB** (section [2.4.275](#sxdb)) | 198 | +| **SXDBB** (section [2.4.276](#sxdbb)) | 200 | +| **SXDBEx** (section [2.4.277](#sxdbex)) | 290 | +| **SXDI** (section [2.4.278](#sxdi)) | 197 | +| **SXDtr** (section [2.4.279](#sxdtr)) | 206 | +| **SxDXF** (section [2.4.280](#sxdxf)) | 244 | +| **SxErr** (section [2.4.281](#sxerr)) | 203 | +| **SXEx** (section [2.4.282](#sxex)) | 241 | +| **SXFDB** (section [2.4.283](#sxfdb)) | 199 | +| **SXFDBType** (section [2.4.284](#sxfdbtype)) | 443 | +| **SxFilt** (section [2.4.285](#sxfilt)) | 242 | +| **SxFmla** (section [2.4.286](#sxfmla)) | 249 | +| **SxFormat** (section [2.4.287](#sxformat)) | 251 | +| **SXFormula** (section [2.4.288](#sxformula)) | 259 | +| **SXInt** (section [2.4.289](#sxint)) | 204 | +| **SxIsxoper** (section [2.4.290](#sxisxoper)) | 217 | +| **SxItm** (section [2.4.291](#sxitm)) | 245 | +| **SxIvd** (section [2.4.292](#sxivd)) | 180 | +| **SXLI** (section [2.4.293](#sxli)) | 181 | +| **SxName** (section [2.4.294](#sxname)) | 246 | +| **SxNil** (section [2.4.295](#sxnil)) | 207 | +| **SXNum** (section [2.4.296](#sxnum)) | 201 | +| **SXPair** (section [2.4.297](#sxpair)) | 248 | +| **SXPI** (section [2.4.298](#sxpi)) | 182 | +| **SXPIEx** (section [2.4.299](#sxpiex)) | 2062 | +| **SXRng** (section [2.4.300](#sxrng)) | 216 | +| **SxRule** (section [2.4.301](#sxrule)) | 240 | +| **SxSelect** (section [2.4.302](#sxselect)) | 247 | +| **SXStreamID** (section [2.4.303](#sxstreamid)) | 213 | +| **SXString** (section [2.4.304](#sxstring)) | 205 | +| **SXTbl** (section [2.4.305](#sxtbl)) | 208 | +| **SxTbpg** (section [2.4.306](#sxtbpg)) | 210 | +| **SXTBRGIITM** (section [2.4.307](#sxtbrgiitm)) | 209 | +| **SXTH** (section [2.4.308](#sxth)) | 2061 | +| **Sxvd** (section [2.4.309](#sxvd)) | 177 | +| **SXVDEx** (section [2.4.310](#sxvdex)) | 256 | +| **SXVDTEx** (section [2.4.311](#sxvdtex)) | 2063 | +| **SXVI** (section [2.4.312](#sxvi)) | 178 | +| **SxView** (section [2.4.313](#sxview)) | 176 | +| **SXViewEx** (section [2.4.314](#sxviewex)) | 2060 | +| **SXViewEx9** (section [2.4.315](#sxviewex9)) | 2064 | +| **SXViewLink** (section [2.4.316](#sxviewlink)) | 2136 | +| **SXVS** (section [2.4.317](#sxvs)) | 227 | +| **Sync** (section [2.4.318](#sync)) | 151 | +| **Table** (section [2.4.319](#table)) | 566 | +| **TableStyle** (section [2.4.320](#tablestyle)) | 2191 | +| **TableStyleElement** (section [2.4.321](#tablestyleelement)) | 2192 | +| **TableStyles** (section [2.4.322](#tablestyles)) | 2190 | +| **Template** (section [2.4.323](#template)) | 96 | +| **Text** (section [2.4.324](#text)) | 4133 | +| **TextPropsStream** (section [2.4.325](#textpropsstream)) | 2213 | +| **Theme** (section [2.4.326](#theme)) | 2198 | +| **Tick** (section [2.4.327](#tick)) | 4126 | +| **TopMargin** (section [2.4.328](#topmargin)) | 40 | +| **TxO** (section [2.4.329](#txo)) | 438 | +| **TxtQry** (section [2.4.330](#txtqry)) | 2053 | +| **Uncalced**(section [2.4.331](#uncalced)) | 94 | +| **Units** (section [2.4.332](#units)) | 4097 | +| **UserBView** (section [2.4.333](#userbview)) | 425 | +| **UserSViewBegin** (section [2.4.334](#usersviewbegin)) | 426 | +| **UserSViewBegin_Chart** (section [2.4.335](#usersviewbegin_chart)) | 426 | +| **UserSViewEnd** (section [2.4.336](#usersviewend)) | 427 | +| **UsesELFs** (section [2.4.337](#useselfs)) | 352 | +| **UsrChk** (section [2.4.338](#usrchk)) | 408 | +| **UsrExcl** (section [2.4.339](#usrexcl)) | 404 | +| **UsrInfo** (section [2.4.340](#usrinfo)) | 403 | +| **ValueRange** (section [2.4.341](#valuerange)) | 4127 | +| **VCenter** (section [2.4.342](#vcenter)) | 132 | +| **VerticalPageBreaks** (section [2.4.343](#verticalpagebreaks)) | 26 | +| **WebPub** (section [2.4.344](#webpub)) | 2049 | +| **Window1** (section [2.4.345](#window1)) | 61 | +| **Window2** (section [2.4.346](#window2)) | 574 | +| **WinProtect** (section [2.4.347](#winprotect)) | 25 | +| **WOpt** (section [2.4.348](#wopt)) | 2059 | +| **WriteAccess** (section [2.4.349](#writeaccess)) | 92 | +| **WriteProtect** (section [2.4.350](#writeprotect)) | 134 | +| **WsBool** (section [2.4.351](#wsbool)) | 129 | +| **XCT** (section [2.4.352](#xct)) | 89 | +| **XF** (section [2.4.353](#xf)) | 224 | +| **XFCRC** (section [2.4.354](#xfcrc)) | 2172 | +| **XFExt** (section [2.4.355](#xfext)) | 2173 | +| **YMult** (section [2.4.356](#ymult)) | 2135 | + +### By Number + +| Name | Record type (number) | +|----|---:| +| **Formula** (section [2.4.127](#formula)) | 6 | +| **EOF** (section [2.4.103](#eof)) | 10 | +| **CalcCount** (section [2.4.31](#calccount)) | 12 | +| **CalcMode** (section [2.4.34](#calcmode)) | 13 | +| **CalcPrecision** (section [2.4.35](#calcprecision)) | 14 | +| **CalcRefMode** (section [2.4.36](#calcrefmode)) | 15 | +| **CalcDelta** (section [2.4.32](#calcdelta)) | 16 | +| **CalcIter** (section [2.4.33](#calciter)) | 17 | +| **Protect** (section [2.4.207](#protect)) | 18 | +| **Password** (section [2.4.191](#password)) | 19 | +| **Header** (section [2.4.136](#header)) | 20 | +| **Footer** (section [2.4.124](#footer)) | 21 | +| **ExternSheet** (section [2.4.106](#externsheet)) | 23 | +| **Lbl** (section [2.4.150](#lbl)) | 24 | +| **WinProtect** (section [2.4.347](#winprotect)) | 25 | +| **VerticalPageBreaks** (section [2.4.343](#verticalpagebreaks)) | 26 | +| **HorizontalPageBreaks** (section [2.4.142](#horizontalpagebreaks)) | 27 | +| **Note** (section [2.4.179](#note)) | 28 | +| **Selection** (section [2.4.248](#selection)) | 29 | +| **Date1904** (section [2.4.77](#date1904)) | 34 | +| **ExternName** (section [2.4.105](#externname)) | 35 | +| **LeftMargin** (section [2.4.151](#leftmargin)) | 38 | +| **RightMargin** (section [2.4.219](#rightmargin)) | 39 | +| **TopMargin** (section [2.4.328](#topmargin)) | 40 | +| **BottomMargin** (section [2.4.27](#bottommargin)) | 41 | +| **PrintRowCol** (section [2.4.203](#printrowcol)) | 42 | +| **PrintGrid** (section [2.4.202](#printgrid)) | 43 | +| **FilePass** (section [2.4.117](#filepass)) | 47 | +| **Font** (section [2.4.122](#font)) | 49 | +| **PrintSize** (section [2.4.204](#printsize)) | 51 | +| **Continue** (section [2.4.58](#continue)) | 60 | +| **Window1** (section [2.4.345](#window1)) | 61 | +| **Backup** (section [2.4.14](#backup)) | 64 | +| **Pane** (section [2.4.189](#pane)) | 65 | +| **CodePage** (section [2.4.52](#codepage)) | 66 | +| **Pls** (section [2.4.199](#pls)) | 77 | +| **DCon** (section [2.4.82](#dcon)) | 80 | +| **DConRef** (section [2.4.86](#dconref)) | 81 | +| **DConName** (section [2.4.85](#dconname)) | 82 | +| **DefColWidth** (section [2.4.89](#defcolwidth)) | 85 | +| **XCT** (section [2.4.352](#xct)) | 89 | +| **CRN** (section [2.4.65](#crn)) | 90 | +| **FileSharing** (section [2.4.118](#filesharing)) | 91 | +| **WriteAccess** (section [2.4.349](#writeaccess)) | 92 | +| **Obj** (section [2.4.181](#obj)) | 93 | +| **Uncalced** (section [2.4.331](#uncalced)) | 94 | +| **CalcSaveRecalc** (section [2.4.37](#calcsaverecalc)) | 95 | +| **Template** (section [2.4.323](#template)) | 96 | +| **Intl** (section [2.4.147](#intl)) | 97 | +| **ObjProtect** (section [2.4.183](#objprotect)) | 99 | +| **ColInfo** (section [2.4.53](#colinfo)) | 125 | +| **Guts** (section [2.4.134](#guts)) | 128 | +| **WsBool** (section [2.4.351](#wsbool)) | 129 | +| **GridSet** (section [2.4.132](#gridset)) | 130 | +| **HCenter** (section [2.4.135](#hcenter)) | 131 | +| **VCenter** (section [2.4.342](#vcenter)) | 132 | +| **BoundSheet8** (section [2.4.28](#boundsheet8)) | 133 | +| **WriteProtect** (section [2.4.350](#writeprotect)) | 134 | +| **Country** (section [2.4.63](#country)) | 140 | +| **HideObj** (section [2.4.139](#hideobj)) | 141 | +| **Sort** (section [2.4.263](#sort)) | 144 | +| **Palette** (section [2.4.188](#palette)) | 146 | +| **Sync** (section [2.4.318](#sync)) | 151 | +| **LPr** (section [2.4.158](#lpr)) | 152 | +| **DxGCol** (section [2.4.98](#dxgcol)) | 153 | +| **FnGroupName** (section [2.4.120](#fngroupname)) | 154 | +| **FilterMode** (section [2.4.119](#filtermode)) | 155 | +| **BuiltInFnGroupCount** (section [2.4.30](#builtinfngroupcount)) | 156 | +| **AutoFilterInfo** (section [2.4.8](#autofilterinfo)) | 157 | +| **AutoFilter** (section [2.4.6](#autofilter)) | 158 | +| **Scl** (section [2.4.247](#scl)) | 160 | +| **Setup** (section [2.4.257](#setup)) | 161 | +| **ScenMan** (section [2.4.246](#scenman)) | 174 | +| **SCENARIO** (section [2.4.244](#scenario)) | 175 | +| **SxView** (section [2.4.313](#sxview)) | 176 | +| **Sxvd** (section [2.4.309](#sxvd)) | 177 | +| **SXVI** (section [2.4.312](#sxvi)) | 178 | +| **SxIvd** (section [2.4.292](#sxivd)) | 180 | +| **SXLI** (section [2.4.293](#sxli)) | 181 | +| **SXPI** (section [2.4.298](#sxpi)) | 182 | +| **DocRoute** (section [2.4.91](#docroute)) | 184 | +| **RecipName** (section [2.4.216](#recipname)) | 185 | +| **MulRk** (section [2.4.175](#mulrk)) | 189 | +| **MulBlank** (section [2.4.174](#mulblank)) | 190 | +| **Mms** (section [2.4.169](#mms)) | 193 | +| **SXDI** (section [2.4.278](#sxdi)) | 197 | +| **SXDB** (section [2.4.275](#sxdb)) | 198 | +| **SXFDB** (section [2.4.283](#sxfdb)) | 199 | +| **SXDBB** (section [2.4.276](#sxdbb)) | 200 | +| **SXNum** (section [2.4.296](#sxnum)) | 201 | +| **SxBool** (section [2.4.274](#sxbool)) | 202 | +| **SxErr** (section [2.4.281](#sxerr)) | 203 | +| **SXInt** (section [2.4.289](#sxint)) | 204 | +| **SXString** (section [2.4.304](#sxstring)) | 205 | +| **SXDtr** (section [2.4.279](#sxdtr)) | 206 | +| **SxNil** (section [2.4.295](#sxnil)) | 207 | +| **SXTbl** (section [2.4.305](#sxtbl)) | 208 | +| **SXTBRGIITM** (section [2.4.307](#sxtbrgiitm)) | 209 | +| **SxTbpg** (section [2.4.306](#sxtbpg)) | 210 | +| **ObProj** (section [2.4.185](#obproj)) | 211 | +| **SXStreamID** (section [2.4.303](#sxstreamid)) | 213 | +| **DBCell** (section [2.4.78](#dbcell)) | 215 | +| **SXRng** (section [2.4.300](#sxrng)) | 216 | +| **SxIsxoper** (section [2.4.290](#sxisxoper)) | 217 | +| **BookBool** (section [2.4.22](#bookbool)) | 218 | +| **DbOrParamQry** (section [2.4.79](#dborparamqry)) | 220 | +| **ScenarioProtect** (section [2.4.245](#scenarioprotect)) | 221 | +| **OleObjectSize** (section [2.4.187](#oleobjectsize)) | 222 | +| **XF** (section [2.4.353](#xf)) | 224 | +| **InterfaceHdr** (section [2.4.146](#interfacehdr)) | 225 | +| **InterfaceEnd** (section [2.4.145](#interfaceend)) | 226 | +| **SXVS** (section [2.4.317](#sxvs)) | 227 | +| **MergeCells** (section [2.4.168](#mergecells)) | 229 | +| **BkHim** (section [2.4.19](#bkhim)) | 233 | +| **MsoDrawingGroup** (section [2.4.171](#msodrawinggroup)) | 235 | +| **MsoDrawing** (section [2.4.170](#msodrawing)) | 236 | +| **MsoDrawingSelection** (section [2.4.172](#msodrawingselection)) | 237 | +| **PhoneticInfo** (section [2.4.192](#phoneticinfo)) | 239 | +| **SxRule** (section [2.4.301](#sxrule)) | 240 | +| **SXEx** (section [2.4.282](#sxex)) | 241 | +| **SxFilt** (section [2.4.285](#sxfilt)) | 242 | +| **SxDXF** (section [2.4.280](#sxdxf)) | 244 | +| **SxItm** (section [2.4.291](#sxitm)) | 245 | +| **SxName** (section [2.4.294](#sxname)) | 246 | +| **SxSelect** (section [2.4.302](#sxselect)) | 247 | +| **SXPair** (section [2.4.297](#sxpair)) | 248 | +| **SxFmla** (section [2.4.286](#sxfmla)) | 249 | +| **SxFormat** (section [2.4.287](#sxformat)) | 251 | +| **SST** (section [2.4.265](#sst)) | 252 | +| **LabelSst** (section [2.4.149](#labelsst)) | 253 | +| **ExtSST** (section [2.4.107](#extsst)) | 255 | +| **SXVDEx** (section [2.4.310](#sxvdex)) | 256 | +| **SXFormula** (section [2.4.288](#sxformula)) | 259 | +| **SXDBEx** (section [2.4.277](#sxdbex)) | 290 | +| **RRDInsDel** (section [2.4.228](#rrdinsdel)) | 311 | +| **RRDHead** (section [2.4.226](#rrdhead)) | 312 | +| **RRDChgCell** (section [2.4.223](#rrdchgcell)) | 315 | +| **RRTabId** (section [2.4.241](#rrtabid)) | 317 | +| **RRDRenSheet** (section [2.4.234](#rrdrensheet)) | 318 | +| **RRSort** (section [2.4.240](#rrsort)) | 319 | +| **RRDMove** (section [2.4.231](#rrdmove)) | 320 | +| **RRFormat** (section [2.4.238](#rrformat)) | 330 | +| **RRAutoFmt** (section [2.4.222](#rrautofmt)) | 331 | +| **RRInsertSh** (section [2.4.239](#rrinsertsh)) | 333 | +| **RRDMoveBegin** (section [2.4.232](#rrdmovebegin)) | 334 | +| **RRDMoveEnd** (section [2.4.233](#rrdmoveend)) | 335 | +| **RRDInsDelBegin** (section [2.4.229](#rrdinsdelbegin)) | 336 | +| **RRDInsDelEnd** (section [2.4.230](#rrdinsdelend)) | 337 | +| **RRDConflict** (section [2.4.224](#rrdconflict)) | 338 | +| **RRDDefName** (section [2.4.225](#rrddefname)) | 339 | +| **RRDRstEtxp** (section [2.4.235](#rrdrstetxp)) | 340 | +| **LRng** (section [2.4.159](#lrng)) | 351 | +| **UsesELFs** (section [2.4.337](#useselfs)) | 352 | +| **DSF** (section [2.4.94](#dsf)) | 353 | +| **CUsr** (section [2.4.72](#cusr)) | 401 | +| **CbUsr** (section [2.4.40](#cbusr)) | 402 | +| **UsrInfo** (section [2.4.340](#usrinfo)) | 403 | +| **UsrExcl** (section [2.4.339](#usrexcl)) | 404 | +| **FileLock** (section [2.4.116](#filelock)) | 405 | +| **RRDInfo** (section [2.4.227](#rrdinfo)) | 406 | +| **BCUsrs** (section [2.4.16](#bcusrs)) | 407 | +| **UsrChk** (section [2.4.338](#usrchk)) | 408 | +| **UserBView** (section [2.4.333](#userbview)) | 425 | +| **UserSViewBegin** (section [2.4.334](#usersviewbegin)) | 426 | +| **UserSViewBegin_Chart** (section [2.4.335](#usersviewbegin_chart)) | 426 | +| **UserSViewEnd** (section [2.4.336](#usersviewend)) | 427 | +| **RRDUserView** (section [2.4.237](#rrduserview)) | 428 | +| **Qsi** (section [2.4.208](#qsi)) | 429 | +| **SupBook** (section [2.4.271](#supbook)) | 430 | +| **Prot4Rev** (section [2.4.205](#prot4rev)) | 431 | +| **CondFmt** (section [2.4.56](#condfmt)) | 432 | +| **CF** (section [2.4.42](#cf)) | 433 | +| **DVal** (section [2.4.96](#dval)) | 434 | +| **DConBin** (section [2.4.83](#dconbin)) | 437 | +| **TxO** (section [2.4.329](#txo)) | 438 | +| **RefreshAll** (section [2.4.217](#refreshall)) | 439 | +| **HLink** (section [2.4.140](#hlink)) | 440 | +| **Lel** (section [2.4.154](#lel)) | 441 | +| **CodeName** (section [2.4.51](#codename)) | 442 | +| **SXFDBType** (section [2.4.284](#sxfdbtype)) | 443 | +| **Prot4RevPass** (section [2.4.206](#prot4revpass)) | 444 | +| **ObNoMacros** (section [2.4.184](#obnomacros)) | 445 | +| **Dv** (section [2.4.95](#dv)) | 446 | +| **Excel9File** (section [2.4.104](#excel9file)) | 448 | +| **RecalcId** (section [2.4.215](#recalcid)) | 449 | +| **EntExU2** (section [2.4.102](#entexu2)) | 450 | +| **Dimensions** (section [2.4.90](#dimensions)) | 512 | +| **Blank** (section [2.4.20](#blank)) | 513 | +| **Number** (section [2.4.180](#number)) | 515 | +| **Label** (section [2.4.148](#label)) | 516 | +| **BoolErr** (section [2.4.24](#boolerr)) | 517 | +| **String** (section [2.4.268](#string)) | 519 | +| **Row** (section [2.4.221](#row)) | 520 | +| **Index** (section [2.4.144](#index)) | 523 | +| **Array** (section [2.4.4](#array)) | 545 | +| **DefaultRowHeight** (section [2.4.87](#defaultrowheight)) | 549 | +| **Table** (section [2.4.319](#table)) | 566 | +| **Window2** (section [2.4.346](#window2)) | 574 | +| **RK** (section [2.4.220](#rk)) | 638 | +| **Style** (section [2.4.269](#style)) | 659 | +| **BigName** (section [2.4.18](#bigname)) | 1048 | +| **Format** (section [2.4.126](#format)) | 1054 | +| **ContinueBigName** (section [2.4.59](#continuebigname)) | 1084 | +| **ShrFmla** (section [2.4.260](#shrfmla)) | 1212 | +| **HLinkTooltip** (section [2.4.141](#hlinktooltip)) | 2048 | +| **WebPub** (section [2.4.344](#webpub)) | 2049 | +| **QsiSXTag** (section [2.4.211](#qsisxtag)) | 2050 | +| **DBQueryExt** (section [2.4.81](#dbqueryext)) | 2051 | +| **ExtString** (section [2.4.108](#extstring)) | 2052 | +| **TxtQry** (section [2.4.330](#txtqry)) | 2053 | +| **Qsir** (section [2.4.210](#qsir)) | 2054 | +| **Qsif** (section [2.4.209](#qsif)) | 2055 | +| **RRDTQSIF** (section [2.4.236](#rrdtqsif)) | 2056 | +| **BOF** (section [2.4.21](#bof)) | 2057 | +| **OleDbConn** (section [2.4.186](#oledbconn)) | 2058 | +| **WOpt** (section [2.4.348](#wopt)) | 2059 | +| **SXViewEx** (section [2.4.314](#sxviewex)) | 2060 | +| **SXTH** (section [2.4.308](#sxth)) | 2061 | +| **SXPIEx** (section [2.4.299](#sxpiex)) | 2062 | +| **SXVDTEx** (section [2.4.311](#sxvdtex)) | 2063 | +| **SXViewEx9** (section [2.4.315](#sxviewex9)) | 2064 | +| **ContinueFrt** (section [2.4.60](#continuefrt)) | 2066 | +| **RealTimeData** (section [2.4.214](#realtimedata)) | 2067 | +| **ChartFrtInfo** (section [2.4.49](#chartfrtinfo)) | 2128 | +| **FrtWrapper** (section [2.4.130](#frtwrapper)) | 2129 | +| **StartBlock** (section [2.4.266](#startblock)) | 2130 | +| **EndBlock** (section [2.4.100](#endblock)) | 2131 | +| **StartObject** (section [2.4.267](#startobject)) | 2132 | +| **EndObject** (section [2.4.101](#endobject)) | 2133 | +| **CatLab** (section [2.4.38](#catlab)) | 2134 | +| **YMult** (section [2.4.356](#ymult)) | 2135 | +| **SXViewLink** (section [2.4.316](#sxviewlink)) | 2136 | +| **PivotChartBits** (section [2.4.196](#pivotchartbits)) | 2137 | +| **FrtFontList** (section [2.4.129](#frtfontlist)) | 2138 | +| **SheetExt** (section [2.4.259](#sheetext)) | 2146 | +| **BookExt** (section [2.4.23](#bookext)) | 2147 | +| **SXAddl** (section [2.4.273.2](#sxaddl)) | 2148 | +| **CrErr** (section [2.4.64](#crerr)) | 2149 | +| **HFPicture** (section [2.4.138](#hfpicture)) | 2150 | +| **FeatHdr** (section [2.4.112](#feathdr)) | 2151 | +| **Feat** (section [2.4.111](#feat)) | 2152 | +| **DataLabExt** (section [2.4.75](#datalabext)) | 2154 | +| **DataLabExtContents** (section [2.4.76](#datalabextcontents)) | 2155 | +| **CellWatch** (section [2.4.41](#cellwatch)) | 2156 | +| **FeatHdr11** (section [2.4.113](#feathdr11)) | 2161 | +| **Feature11** (section [2.4.114](#feature11)) | 2162 | +| **DropDownObjIds** (section [2.4.93](#dropdownobjids)) | 2164 | +| **ContinueFrt11** (section [2.4.61](#continuefrt11)) | 2165 | +| **DConn** (section [2.4.84](#dconn)) | 2166 | +| **List12** (section [2.4.157](#list12)) | 2167 | +| **Feature12** (section [2.4.115](#feature12)) | 2168 | +| **CondFmt12** (section [2.4.57](#condfmt12)) | 2169 | +| **CF12** (section [2.4.43](#cf12)) | 2170 | +| **CFEx** (section [2.4.44](#cfex)) | 2171 | +| **XFCRC** (section [2.4.354](#xfcrc)) | 2172 | +| **XFExt** (section [2.4.355](#xfext)) | 2173 | +| **AutoFilter12** (section [2.4.7](#autofilter12)) | 2174 | +| **ContinueFrt12** (section [2.4.62](#continuefrt12)) | 2175 | +| **MDTInfo** (section [2.4.162](#mdtinfo)) | 2180 | +| **MDXStr** (section [2.4.166](#mdxstr)) | 2181 | +| **MDXTuple** (section [2.4.167](#mdxtuple)) | 2182 | +| **MDXSet** (section [2.4.165](#mdxset)) | 2183 | +| **MDXProp** (section [2.4.164](#mdxprop)) | 2184 | +| **MDXKPI** (section [2.4.163](#mdxkpi)) | 2185 | +| **MDB** (section [2.4.161](#mdb)) | 2186 | +| **PLV** (section [2.4.200](#plv)) | 2187 | +| **Compat12** (section [2.4.54](#compat12)) | 2188 | +| **DXF** (section [2.4.97](#dxf)) | 2189 | +| **TableStyles** (section [2.4.322](#tablestyles)) | 2190 | +| **TableStyle** (section [2.4.320](#tablestyle)) | 2191 | +| **TableStyleElement** (section [2.4.321](#tablestyleelement)) | 2192 | +| **StyleExt** (section [2.4.270](#styleext)) | 2194 | +| **NamePublish** (section [2.4.178](#namepublish)) | 2195 | +| **NameCmt** (section [2.4.176](#namecmt)) | 2196 | +| **SortData** (section [2.4.264](#sortdata)) | 2197 | +| **Theme** (section [2.4.326](#theme)) | 2198 | +| **GUIDTypeLib** (section [2.4.133](#guidtypelib)) | 2199 | +| **FnGrp12** (section [2.4.121](#fngrp12)) | 2200 | +| **NameFnGrp12** (section [2.4.177](#namefngrp12)) | 2201 | +| **MTRSettings** (section [2.4.173](#mtrsettings)) | 2202 | +| **CompressPictures** (section [2.4.55](#compresspictures)) | 2203 | +| **HeaderFooter** (section [2.4.137](#headerfooter)) | 2204 | +| **CrtLayout12** (section [2.4.66](#crtlayout12)) | 2205 | +| **CrtMlFrt** (section [2.4.70](#crtmlfrt)) | 2206 | +| **CrtMlFrtContinue** (section [2.4.71](#crtmlfrtcontinue)) | 2207 | +| **ForceFullCalculation** (section [2.4.125](#forcefullcalculation)) | 2211 | +| **ShapePropsStream** (section [2.4.258](#shapepropsstream)) | 2212 | +| **TextPropsStream** (section [2.4.325](#textpropsstream)) | 2213 | +| **RichTextStream** (section [2.4.218](#richtextstream)) | 2214 | +| **CrtLayout12A** (section [2.4.67](#crtlayout12a)) | 2215 | +| **Units** (section [2.4.332](#units)) | 4097 | +| **Chart** (section [2.4.45](#chart-2)) | 4098 | +| **Series** (section [2.4.252](#series-1)) | 4099 | +| **DataFormat** (section [2.4.74](#dataformat)) | 4102 | +| **LineFormat** (section [2.4.156](#lineformat)) | 4103 | +| **MarkerFormat** (section [2.4.160](#markerformat)) | 4105 | +| **AreaFormat** (section [2.4.3](#areaformat)) | 4106 | +| **PieFormat** (section [2.4.195](#pieformat)) | 4107 | +| **AttachedLabel** (section [2.4.5](#attachedlabel)) | 4108 | +| **SeriesText** (section [2.4.254](#seriestext)) | 4109 | +| **ChartFormat** (section [2.4.48](#chartformat)) | 4116 | +| **Legend** (section [2.4.152](#legend-1)) | 4117 | +| **SeriesList** (section [2.4.253](#serieslist)) | 4118 | +| **Bar** (section [2.4.15](#bar)) | 4119 | +| **Line** (section [2.4.155](#line)) | 4120 | +| **Pie** (section [2.4.194](#pie)) | 4121 | +| **Area** (section [2.4.2](#area)) | 4122 | +| **Scatter** (section [2.4.243](#scatter)) | 4123 | +| **CrtLine** (section [2.4.68](#crtline)) | 4124 | +| **Axis** (section [2.4.11](#axis-1)) | 4125 | +| **Tick** (section [2.4.327](#tick)) | 4126 | +| **ValueRange** (section [2.4.341](#valuerange)) | 4127 | +| **CatSerRange** (section [2.4.39](#catserrange)) | 4128 | +| **AxisLine** (section [2.4.12](#axisline)) | 4129 | +| **CrtLink** (section [2.4.69](#crtlink)) | 4130 | +| **DefaultText** (section [2.4.88](#defaulttext)) | 4132 | +| **Text** (section [2.4.324](#text)) | 4133 | +| **FontX** (section [2.4.123](#fontx)) | 4134 | +| **ObjectLink** (section [2.4.182](#objectlink)) | 4135 | +| **Frame** (section [2.4.128](#frame)) | 4146 | +| **Begin** (section [2.4.17](#begin)) | 4147 | +| **End** (section [2.4.99](#end)) | 4148 | +| **PlotArea** (section [2.4.197](#plotarea)) | 4149 | +| **Chart3d** (section [2.4.46](#chart3d)) | 4154 | +| **PicF** (section [2.4.193](#picf)) | 4156 | +| **DropBar** (section [2.4.92](#dropbar)) | 4157 | +| **Radar** (section [2.4.212](#radar)) | 4158 | +| **Surf** (section [2.4.272](#surf)) | 4159 | +| **RadarArea** (section [2.4.213](#radararea)) | 4160 | +| **AxisParent** (section [2.4.13](#axisparent)) | 4161 | +| **LegendException** section [2.4.153](#legendexception)() | 4163 | +| **ShtProps** (section [2.4.261](#shtprops)) | 4164 | +| **SerToCrt** (section [2.4.256](#sertocrt)) | 4165 | +| **AxesUsed** (section [2.4.10](#axesused)) | 4166 | +| **SBaseRef** (section [2.4.242](#sbaseref)) | 4168 | +| **SerParent** (section [2.4.255](#serparent)) | 4170 | +| **SerAuxTrend** (section [2.4.250](#serauxtrend)) | 4171 | +| **IFmtRecord** (section [2.4.143](#ifmtrecord)) | 4174 | +| **Pos** (section [2.4.201](#pos)) | 4175 | +| **AlRuns** (section [2.4.1](#alruns)) | 4176 | +| **BRAI** (section [2.4.29](#brai)) | 4177 | +| **SerAuxErrBar** (section [2.4.249](#serauxerrbar)) | 4187 | +| **ClrtClient** (section [2.4.50](#clrtclient)) | 4188 | +| **SerFmt** (section [2.4.251](#serfmt)) | 4189 | +| **Chart3DBarShape** (section [2.4.47](#chart3dbarshape)) | 4191 | +| **Fbi** (section [2.4.109](#fbi)) | 4192 | +| **BopPop** (section [2.4.25](#boppop)) | 4193 | +| **AxcExt** (section [2.4.9](#axcext)) | 4194 | +| **Dat** (section [2.4.73](#dat)) | 4195 | +| **PlotGrowth** (section [2.4.198](#plotgrowth)) | 4196 | +| **SIIndex** (section [2.4.262](#siindex)) | 4197 | +| **GelFrame** (section [2.4.131](#gelframe)) | 4198 | +| **BopPopCustom** (section [2.4.26](#boppopcustom)) | 4199 | +| **Fbi2** (section [2.4.110](#fbi2)) | 4200 | + +## Records + +### AlRuns + +The **AlRuns** record specifies Rich Text Formatting within **chart titles** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)), **trendline** (section [2.2.3.12](#Section_61d74ebc36714d6dbdc0626db604530d)), and **data labels** (section [2.2.3.11](#Section_cac7f43a3af142f58ff2814c2870427f)). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cRunsrgRuns (variable)
...
+ +**cRuns (2 bytes):** An unsigned integer that specifies the number of Rich Text Format runs. MUST be greater than or equal to 3 and less than or equal to 256. + +**rgRuns (variable):** An array of **FormatRun structures** (section [2.5.132](#formatrun)) that specifies the Rich Text Format runs. The number of elements in the array MUST be equal to **cRuns**. + +### Area + +The **Area** record specifies that the **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) is an area **chart group** (section 2.2.3.7) and specifies the **chart group** (section 2.2.3.7) attributes. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ABCreserved
+ +**A - fStacked (1 bit):** A bit that specifies whether the **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) in the **chart group** (section 2.2.3.7) that share the same [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) are stacked. + +**B - f100 (1 bit):** A bit that specifies whether the **data points** (section 2.2.3.10) in the **chart group** (section 2.2.3.7) are displayed as a percentage of the sum of all **data points** (section 2.2.3.10) in the **chart group** (section 2.2.3.7) that share the same category. MUST be 0 if **fStacked** is 0. + +**C - fHasShadow (1 bit):** A bit that specifies whether one or more **data points** (section 2.2.3.10) in the **chart group** (section 2.2.3.7) has shadows. + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +### AreaFormat + +The **AreaFormat** record specifies the patterns and colors used in a filled region of a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). If this record is not present in the sequence of records that conforms to the **SS rule** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) of the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), the patterns and colors used are specified by the default values of the fields of this record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgbFore
rgbBack
flsABreserved
icvForeicvBack
+ +**rgbFore (4 bytes):** A **LongRGB structure** (section [2.5.177](#longrgb)) that specifies the [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) of the [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e).[\<23\>](#Appendix_A_23) The default value of this field is automatically selected from the next available color in the **chart** (section 2.2.3.3) color table. + +**rgbBack (4 bytes):** A **LongRGB structure** (section 2.5.177) that specifies the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) of the fill pattern.[\<24\>](#Appendix_A_24) The default value of this field is 0xFFFFFF. + +**fls (2 bytes):** An unsigned integer that specifies the type of fill pattern. If **fls** is neither 0x0000 nor 0x0001, this record MUST be immediately followed by a corresponding **GelFrame** record (section [2.4.131](#gelframe)) that specifies the fill pattern. The fillType as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.3.7.1 of the **OPT1** field of the corresponding **GelFrame** record (section 2.4.131) MUST be **msofillPattern** as specified in \[MS-ODRAW\] section 2.4.11. The default value of this field is 0x0001. **fls** MUST be a value from the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ValueMeaning
0x0000The fill pattern is none (no fill). When rgbFore or rgbBack are specified, a pattern of 'none' overrides and means there is no fill.
0x0001The fill pattern is solid. When solid is specified, rgbFore is the only color rendered, even when rgbBack is also specified.
0x0002

The fill pattern is medium gray. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following gray patterns is used.

+

Percent50 - Specifies a 50 percent hatch. The ratio of foreground color to background color is 50:100.

0x0003

The fill pattern is dark gray. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following dark gray patterns is used.

+

Percent60 - Specifies a 60 percent hatch. The ratio of foreground color to background color is 60:100.

+

Percent70 - Specifies a 70 percent hatch. The ratio of foreground color to background color is 70:100.

+

Percent75 - Specifies a 75 percent hatch. The ratio of foreground color to background color is 75:100.

+

Percent80 - Specifies a 80 percent hatch. The ratio of foreground color to background color is 80:100.

+

Percent90 - Specifies a 90 percent hatch. The ratio of foreground color to background color is 90:100.

0x0004

The fill pattern is light gray. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following light gray patterns is used.

+

Percent25 - Specifies a 25 percent hatch. The ratio of foreground color to background color is 25:100.

0x0005

The fill pattern is horizontal stripes. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following horizontal stripe pattern is used.

+

DarkHorizontal - Specifies a pattern of horizontal lines.

0x0006

The fill pattern is vertical stripes. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following vertical stripes patterns is used.

+

DarkVertical - Specifies a pattern of vertical lines.

0x0007

The fill pattern is downward diagonal stripes. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following diagonal stripes patterns is used.

+

DarkDownwardDiagonal - Specifies diagonal lines that slant to the right from top points to bottom points. This hatch pattern is not anti-aliased.

+

WideDownwardDiagonal - Specifies diagonal lines that slant to the right from top points to bottom points, are 1.5 times the width of DarkDownwardDiagonal, but are not anti-aliased.

0x0008

The fill pattern is upward diagonal stripes. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following diagonal stripes patterns is used.

+

DarkUpwardDiagonal - Specifies diagonal lines that slant to the left from top points to bottom points, but the lines are not anti-aliased.

+

WideUpwardDiagonal - Specifies diagonal lines that slant to the left from top points to bottom points, are 1.5 times the width of DarkUpwardDiagonal, but are not anti-aliased.

0x0009

The fill pattern is grid. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following grid patterns is used.

+

LargeCheckerBoard - Specifies a hatch that has the appearance of a checkerboard with squares that are twice the size of SmallCheckerBoard.

+

Plaid - Specifies a hatch that has the appearance of a plaid material.

+

SmallCheckerBoard - Specifies a hatch that has the appearance of a checkerboard.

+

SolidDiamond - Specifies a hatch that has the appearance of a checkerboard placed diagonally.

+

Sphere - Specifies a hatch that has the appearance of spheres laid adjacent to one another.

0x000A

The fill pattern is trellis. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following trellis patterns is used.

+

Trellis - Specifies a hatch that has the appearance of a trellis.

0x000B

The fill pattern is light horizontal stripes. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following light horizontal stripes patterns is used.

+

DashedHorizontal - Specifies dashed horizontal lines.

+

LightHorizontal - Specifies a pattern of horizontal lines.

+

NarrowHorizontal - Specifies horizontal lines that are spaced 25 percent closer together than LightHorizontal.

0x000C

The fill pattern is light vertical stripes. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following light vertical stripes patterns is used.

+

DashedVertical - Specifies dashed vertical lines.

+

LightVertical - Specifies a pattern of vertical lines.

+

NarrowVertical - Specifies vertical lines that are spaced 25 percent closer together than LightVertical.

0x000D

The fill pattern is light down. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following light down patterns is used.

+

DashedDownwardDiagonal – Specifies dashed diagonal lines that slant to the right from top points to bottom points.

+

DiagonalBrick – Specifies a hatch that has the appearance of layered bricks that slant to the left from top points to bottom points.

+

DottedGrid – Specifies horizontal and vertical lines (each of which is composed of dots) that cross.

+

LightDownwardDiagonal - Specifies diagonal lines that slant to the right from top points to bottom points, but are not anti-aliased.

+

OutlinedDiamond - Specifies forward diagonal and backward diagonal lines that cross but are not anti-aliased.

+

Shingle - Specifies a hatch that has the appearance of diagonally layered shingles that slant to the right from top points to bottom points.

+

Wave - Specifies horizontal lines that is composed of tildes.

+

ZigZag - Specifies horizontal lines that are composed of zigzags.

0x000E

The fill pattern is light up. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following light up patterns is used.

+

DashedUpwardDiagonal – Specifies dashed diagonal lines that slant to the left from top points to bottom points.

+

Divot - Specifies a hatch that has the appearance of divots.

+

LightUpwardDiagonal - Specifies diagonal lines that slant to the left from top points to bottom points, but they are not anti-aliased.

+

Weave - Specifies a hatch that has the appearance of a woven material.

0x000F

The fill pattern is light grid. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following light grid patterns is used.

+

HorizontalBrick - Specifies a hatch that has the appearance of horizontally layered bricks.

+

LargeGrid - Specifies horizontal and vertical lines that cross.

+

SmallGrid - Specifies horizontal and vertical lines that cross and are spaced 50 percent closer together than hatch style LargeGrid.

0x0010

The fill pattern is light trellis. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following light trellis patterns is used.

+

Percent30 - Specifies a 30 percent hatch. The ratio of foreground color to background color is 30:100.

+

Percent40 - Specifies a 40 percent hatch. The ratio of foreground color to background color is 40:100.

+

LargeConfetti - Specifies a hatch that has the appearance of confetti, and is composed of larger pieces than SmallConfetti.

0x0011

The fill pattern is grayscale of 0.125 (1/8) value. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following grayscale patterns is used.

+

Percent20 - Specifies a 20 percent hatch. The ratio of foreground color to background color is 20:100.

+

DottedDiamond - Specifies forward diagonal and backward diagonal lines (each of which is composed of dots) that cross.

+

SmallConfetti - Specifies a hatch that has the appearance of confetti.

0x0012

The fill pattern is grayscale of 0.0625 (1/16) value. Additional properties in the corresponding GelFrame record (section 2.4.131) specify which of the following grayscale patterns is used.

+

Percent5 - Specifies a 5 percent hatch. The ratio of foreground color to background color is 5:100.

+

Percent10 - Specifies a 10 percent hatch. The ratio of foreground color to background color is 10:100.

+ +**A - fAuto (1 bit):** A bit that specifies whether the fill colors are automatically set. If **fls is equal to** 0x1 formatting is automatic. The default value of this field is 1. + +**B - fInvertNeg (1 bit):** A bit that specifies whether the foreground and background are swapped when the data value of the filled area is negative. This field MUST be ignored if the formatting is not being applied to a **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) on a bar or column **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)). The default value of this field is 0. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +**icvFore (2 bytes):** An **IcvChart structure** (section [2.5.162](#icvchart)) that specifies the foreground color of the fill pattern. The default value of this field is automatically selected from the next available color in the **chart** (section 2.2.3.3) color table. + +**icvBack (2 bytes):** An **IcvChart structure** (section 2.5.162) that specifies the background color of the fill pattern. The default value of this field is 0x0009. + +### Array + +The **Array** record specifies an array **formula** (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) for a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that performs calculations on one or more sets of values, and then returns either a single result or multiple results across a continuous range of cells. This record is preceded by a single **Formula** record (section [2.4.127](#formula)) that defines the first cell in the range that uses this array **formula** (section 2.2.2). Other **Formula** records (section 2.4.127) that use this array **formula** (section 2.2.2) follow later in the file, not necessarily in a contiguous sequence. **Formula** records (section 2.4.127) that use this array **formula** (section 2.2.2) MUST have a **cell** field that is within the range specified in the **ref** field of this record and MUST have their **formula** begin with **PtgExp** (section [2.5.198.58](#ptgexp)). Also, each cell specified in the **ref** field MUST have a **Formula** (section 2.4.127) that uses this array **formula** (section 2.2.2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ref
...Areserved
unused
formula (variable)
...
+ +**ref (6 bytes):** A **Ref structure** (section [2.5.207](#ref)) that specifies the range of the array **formula** (section 2.2.2). + +**A - fAlwaysCalc (1 bit):** A bit that specifies whether the array **formula** (section 2.2.2) needs to be calculated during the next recalculation. + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +**unused (4 bytes):** Undefined and MUST be ignored. + +**formula (variable):** An **ArrayParsedFormula structure** (section [2.5.198.1](#arrayparsedformula)) that specifies the array **formula** (section 2.2.2). + +### AttachedLabel + +The **AttachedLabel** record specifies properties of a **data label** (section [2.2.3.11](#Section_cac7f43a3af142f58ff2814c2870427f)) on a **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)), **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)), or **data point** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)). Refer to the **data label** (section 2.2.3.11) overview for additional information about how this record is used and when this record is ignored. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ABCDEFGreserved
+ +**A - fShowValue (1 bit):** A bit that specifies whether the value, or the vertical value on bubble or scatter **chart groups** (section 2.2.3.7), is displayed in the **data label** (section 2.2.3.11). + +This value MUST be 0 if this record is in a **chart group** (section 2.2.3.7) and either **fShowLabelAndPerc** or **fShowPercent** is equal to 1. + +**B - fShowPercent (1 bit):** A bit that specifies whether the value, represented as a percentage of the sum of the values of the **series** (section 2.2.3.9) the **data label** (section 2.2.3.11) is associated with, is displayed in the **data label** (section 2.2.3.11). + +MUST equal 0 if the **chart group** (section 2.2.3.7) type of the corresponding **chart group** (section 2.2.3.7), **series** (section 2.2.3.9), or **data point** (section 2.2.3.10), is not bar of pie, doughnut, pie, or pie of pie **chart group** (section 2.2.3.7). + +If this record is contained in a **chart group** (section 2.2.3.7) and **fShowLabelAndPerc** is equal to 1 then this field MUST equal 1. + +**C - fShowLabelAndPerc (1 bit):** A bit that specifies whether the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) name and value, represented as a percentage of the sum of the values of the **series** (section 2.2.3.9) the **data label** (section 2.2.3.11) is associated with, are displayed in the **data label** (section 2.2.3.11). + +MUST equal 0 if the **chart group** (section 2.2.3.7) type of the corresponding **chart group** (section 2.2.3.7), **series** (section 2.2.3.9), or **data point** (section 2.2.3.10), is not bar of pie, doughnut, pie, or pie of pie **chart group** (section 2.2.3.7). + +**D - unused (1 bit):** Undefined and MUST be ignored. + +**E - fShowLabel (1 bit):** A bit that specifies whether the category, or the horizontal value on bubble or scatter **chart groups** (section 2.2.3.7), is displayed in the **data label** (section 2.2.3.11) on a non-area **chart group** (section 2.2.3.7), or the **series** (section 2.2.3.9) name is displayed in the **data label** (section 2.2.3.11) on an area **chart group** (section 2.2.3.7). + +This field MUST equal 0 if this record is contained in a **chart group** (section 2.2.3.7) and one of the following conditions is satisfied: + +- The **fShowValue** field is equal to 1. + +- The **fShowLabelAndPerc** field is equal to 0 and the **fShowPercent** field is equal to 1. + +**F - fShowBubbleSizes (1 bit):** A bit that specifies whether the [**bubble size**](#gt_3a0cf938-5b61-4460-bdbb-3540d84d4180) is displayed in the **data label** (section 2.2.3.11). + +MUST equal 0 if the **chart group** (section 2.2.3.7) type of the corresponding **chart group** (section 2.2.3.7), **series** (section 2.2.3.9), or **data point** (section 2.2.3.10) is not bubble **chart group** (section 2.2.3.7). + +If the current record is contained in a **chart group** (section 2.2.3.7) and **fShowPercent**, **fShowValue**, or **fShowLabel** equal 1, this field MUST equal 0. + +**G - fShowSeriesName (1 bit):** A bit that specifies whether the **data label** (section 2.2.3.11) contains the name of the **series** (section 2.2.3.9). + +If the current record is contained in a **chart group** (section 2.2.3.7) and **fShowLabelAndPerc**, **fShowPercent**, **fShowValue**, **fShowValue**, **fShowLabel**, or **fShowBubbleSizes** equal 1 then this MUST equal to 0. + +**reserved (9 bits):** MUST be zero, and MUST be ignored. + +### AutoFilter + +The **AutoFilter** record specifies an [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). An **Lbl record** (section [2.4.150](#lbl)) where the **Name** field has a value of 0x0D (\_FilterDatabase) MUST exist for the current [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). The **rgce.rgce** field of the **Lbl record** (section 2.4.150) MUST consist of a single **PtgArea3d operand** (section [2.5.198.28](#ptgarea3d)).) + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iEntryABCDEFwTopN
doper1
...
...doper2
...
...
str1 (variable)
...
str2 (variable)
...
+ +**iEntry (2 bytes):** An unsigned integer that specifies the sheet (1) column that this AutoFilter applies to. The column index is determined by the following formula: + +((the **area.columnFirst** field of the **PtgArea3d** (section 2.5.198.28) in the **rgce.rgce** field of the **Lbl record** (section 2.4.150) where the **Name** field is equal to 0x0D (\_FilterDatabase) and the **Lbl record** (section 2.4.150) is for the current sheet (1)) + **iEntry**). + +The value of **iEntry** MUST be less than the **cEntries** field of the proceeding **AutoFilterInfo** record (section [2.4.8](#autofilterinfo)). + +**A - wJoin (2 bits):** A **Boolean** (section [2.5.14](#boolean)) that specifies whether **doper1** and **doper2** are combined using a logical AND operation or a logical OR operation. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | **doper1** and **doper2** are combined using a logical AND operation. | +| 1 | **doper1** and **doper2** are combined using a logical OR operation. | + +If **fTopN** is 1, **wJoin** is undefined and MUST be ignored. + +**B - fSimple1 (1 bit):** A bit that specifies whether an application-specific performance optimization can be used to compute this AutoFilter. MUST be 1 if and only if **doper1.vt** is 0x06 and **doper1.vtValue** is not a regular expression string, or **doper1.vt** is 0x0C, or **doper1.vt** is 0x0E. If **fTopN** is 1, **fSimple1** is undefined and MUST be ignored. + +**C - fSimple2 (1 bit):** A bit that specifies whether an application-specific performance optimization can be used to compute this AutoFilter. MUST be 1 if and only if **doper2.vt** is 0x06 and **doper2.vtValue** is not a regular expression string, or **doper2.vt** is 0x0C, or **doper2.vt** is 0x0E. If **fTopN** is 1, **fSimple2** is undefined and MUST be ignored. + +**D - fTopN (1 bit):** A bit that specifies whether the AutoFilter is a [**Top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9). + +**E - fTop (1 bit):** A bit that specifies whether the Top N filter selects the bottom items or the top items. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------| +| 0 | Top N filter selects the bottom items. | +| 1 | Top N filter selects the top items. | + +If **fTopN** is 0, **fTop** is undefined and MUST be ignored. + +**F - fPercent (1 bit):** A bit that specifies whether the Top N filter selects a count of items or a percent of items. MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------------| +| 0 | Top N filter selects a count of items. | +| 1 | Top N filter selects a percent of items. | + +If **fTopN** is 0, **fPercent** is undefined and MUST be ignored. + +**wTopN (9 bits):** An unsigned integer that specifies the number of Top N filter items to show. If **fTopN** is 0, **wTopN** MUST be ignored. If **fTopN** is 1, **wTopN** MUST be greater than or equal to 1 and less than or equal to 500. + +**doper1 (10 bytes):** An **AFDOper structure** (section [2.5.5](#afdoper)) that specifies the first AutoFilter condition. If **fTopN** is 1, **doper1** is undefined and MUST be ignored. + +**doper2 (10 bytes):** An **AFDOper structure** (section 2.5.5) that specifies the second AutoFilter condition. If **fTopN** is 1, **doper2** is undefined and MUST be ignored. + +**str1 (variable):** An optional **XLUnicodeStringNoCch structure** (section [2.5.296](#xlunicodestringnocch)) that specifies the string comparison constant for **doper1**. MUST exist if and only if **doper1.vt** is equal to 0x06. The length MUST be equal to **doper1.vtValue.cch**. + +**str2 (variable):** An optional **XLUnicodeStringNoCch structure** (section 2.5.296) that specifies the string comparison constant for **doper2**. MUST exist if and only if **doper2.vt** is equal to 0x06. The length MUST be equal to **doper2.vtValue.cch**. + +### AutoFilter12 + +The **AutoFilter12** record specifies [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) properties. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtRefHeader
...
...
iEntryfHideArrow
...ft
...cft
...cCriteria
...cDateGroupings
...ABunused1
unused2
idList
guidSview (16 bytes)
...
...
rgb (variable)
...
rgCriteria (variable)
...
rgDateGroupings (variable)
...
+ +**frtRefHeader (12 bytes):** An **FrtRefHeader structure** (section [2.5.137](#frtrefheader)). The **frtRefHeader.rt** MUST be 0x087E. **frtRefHeader.grbitFrt.fFrtRef** MUST be 0x1. The **frtRefHeader.ref8** field MUST refer to the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with this record. + +**iEntry (2 bytes):** An unsigned integer that specifies the [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) column that this AutoFilter applies to. The column index is determined by the following formula: + +**frtRefHeader**.**ref8**.**colFirst** + **iEntry**. + +The value of **iEntry** MUST be less than or equal to 255. + +**fHideArrow (4 bytes):** A **Boolean** (section [2.5.14](#boolean)) that specifies whether the user interface used to display AutoFilter settings is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**ft (4 bytes):** An unsigned integer that specifies the [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) type. MUST be one of the values in the table specified in **rgb.** + +**cft (4 bytes):** An unsigned integer that specifies the [**custom filter**](#gt_8593ee2f-c2dd-4793-a684-45fe40c840d2) type. MUST be one of the values in the following table: + +| Value | Meaning | +|----|----| +| 0x00000000 | No custom filter | +| 0x00000001 | The custom filter displays items that are above average. | +| 0x00000002 | The custom filter displays items that are below average. | +| 0x00000008 | The custom filter displays items that are from tomorrow. | +| 0x00000009 | The custom filter displays items that are from today. | +| 0x0000000A | The custom filter displays items that are from yesterday. | +| 0x0000000B | The custom filter displays items that are from next week. | +| 0x0000000C | The custom filter displays items that are from this week. | +| 0x0000000D | The custom filter displays items that are from last week | +| 0x0000000E | The custom filter displays items that are from next month. | +| 0x0000000F | The custom filter displays items that are from this month. | +| 0x00000010 | The custom filter displays items that are from last month. | +| 0x00000011 | The custom filter displays items that are from next quarter. | +| 0x00000012 | The custom filter displays items that are from this quarter. | +| 0x00000013 | The custom filter displays items that are from last quarter. | +| 0x00000014 | The custom filter displays items that are from next year. | +| 0x00000015 | The custom filter displays items that are from this year. | +| 0x00000016 | The custom filter displays items that are from last year. | +| 0x00000017 | The custom filter displays items that are from year-to-date. | +| 0x00000018 | The custom filter displays items that are from the 1st quarter. | +| 0x00000019 | The custom filter displays items that are from the 2nd quarter. | +| 0x0000001A | The custom filter displays items that are from the 3rd quarter. | +| 0x0000001B | The custom filter displays items that are from the 4th quarter. | +| 0x0000001C | The custom filter displays items that are from the 1st month. | +| 0x0000001D | The custom filter displays items that are from the 2nd month. | +| 0x0000001E | The custom filter displays items that are from the 3rd month. | +| 0x0000001F | The custom filter displays items that are from the 4th month. | +| 0x00000020 | The custom filter displays items that are from the 5th month. | +| 0x00000021 | The custom filter displays items that are from the 6th month. | +| 0x00000022 | The custom filter displays items that are from the 7th month. | +| 0x00000023 | The custom filter displays items that are from the 8th month. | +| 0x00000024 | The custom filter displays items that are from the 9th month. | +| 0x00000025 | The custom filter displays items that are from the 10th month. | +| 0x00000026 | The custom filter displays items that are from the 11th month. | +| 0x00000027 | The custom filter displays items that are from the 12th month. | + +**cCriteria (4 bytes):** An unsigned integer that specifies the number of items in **rgCriteria**. MUST be ignored if **ft** is nonzero. + +**cDateGroupings (4 bytes):** An unsigned integer that specifies the number of items in **rgDateGroupings**. MUST be ignored if **ft** is nonzero. + +**A - reserved1 (3 bits):** MUST be zero, and MUST be ignored. + +**B - fWorksheetAutoFilter (1 bit):** A bit that specifies whether this filter is a sheet (1) AutoFilter. A sheet (1) AutoFilter filters items in the sheet specified by the **Worksheet part** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) that contains this record. MUST be 1 if and only if **idList** is equal to 0xFFFFFFFF. + +**unused1 (12 bits):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +**idList (4 bytes):** An unsigned integer that specifies the [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) with items that are filtered by this AutoFilter. MUST either be equal to the **idList** field of the associated **TableFeatureType structure** (section [2.5.266](#tablefeaturetype)) or MUST be 0xFFFFFFFF if this filter is a sheet (1) AutoFilter. + +**guidSview (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that specifies the associated **UserSViewBegin** record (section [2.4.334](#usersviewbegin)). MUST be 0, or MUST be equal to the **guid** field of the preceding **UserSViewBegin** record (section 2.4.334). + +**rgb (variable):** A variable type field whose type and meaning is specified by the value of **ft**, as defined in the following table: + +| Value of ft | Type of rgb | +|----|----| +| 0x00000000 | **rgb** does not exist. Either **cCriteria** or **cDateGroupings** MUST be greater than zero. | +| 0x00000001 | **rgb** is a **DXFN12NoCB structure** (section [2.5.98](#dxfn12nocb)) that specifies the cell color to use for the filter. | +| 0x00000002 | **rgb** is a **DXFN12NoCB structure** (section 2.5.98) that specifies the cell [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) to use for the filter. | +| 0x00000003 | **rgb** is an **AF12CellIcon structure** (section [2.5.2](#af12cellicon)) that specifies the cell [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) to use for the filter. | + +**rgCriteria (variable):** An optional array of **AF12Criteria structures** (section [2.5.3](#af12criteria)). The length of the array MUST be equal to **cCriteria**. MUST exist if and only if **ft** is zero and **cCriteria** is nonzero. Each element of the array MUST be specified in a separate **ContinueFrt12** record (section [2.4.62](#continuefrt12)). + +**rgDateGroupings (variable):** An optional array of **AF12DateInfo structures** (section [2.5.4](#af12dateinfo)). The length of the array MUST be equal to **cDateGroupings**. MUST exist if and only if **ft** is zero and **cDateGroupings** is nonzero. Each element of the array MUST be specified in a separate **ContinueFrt12** record (section 2.4.62). + +### AutoFilterInfo + +The **AutoFilterInfo** record specifies the number of columns that have [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) enabled and specifies the beginning of a collection of records as defined by the [Macro Sheet Substream](#Section_0dddd943f77a4fc2bf92868acb4587f7) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) and [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF. The collection of records specifies AutoFilter information and data used for sorting a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
cEntries
+ +**cEntries (2 bytes):** An unsigned integer that specifies the number of columns that have AutoFilter enabled. MUST be greater than or equal to 1 and less than or equal to 256. + +### AxcExt + +The **AxcExt** record specifies additional extension properties of a date **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)), along with a **CatSerRange record** (section [2.4.39](#catserrange)). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
catMincatMax
catMajorduMajor
catMinorduMinor
duBasecatCrossDate
ABCDEFGHreserved
+ +**catMin (2 bytes):** An unsigned integer that specifies the minimum date, as a date in the [**date system**](#gt_cfc29c5e-eb23-4077-b6eb-492f20f5c87f) specified by the **Date1904 record** (section [2.4.77](#date1904)), in the units defined by **duBase**. SHOULD[\<25\>](#Appendix_A_25) be less than or equal to **catMax**. If **fAutoMin** is set to 1, MUST be ignored. If **fDateAxis** is set to 0, MUST be ignored. + +**catMax (2 bytes):** An unsigned integer that specifies the maximum date, as a date in the date system specified by the **Date1904 record** (section 2.4.77), in the units defined by **duBase**. SHOULD[\<26\>](#Appendix_A_26) be greater than or equal to **catMin**. If **fAutoMax** is set to 1, MUST be ignored. If **fDateAxis** is set to 0, MUST be ignored. + +**catMajor (2 bytes):** An unsigned integer that specifies the interval at which the [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) are displayed on the **axis** (section 2.2.3.6), in the unit defined by **duMajor**. MUST be greater than or equal to **catMinor** when **duMajor** is equal to **duMinor**. If **fAutoMajor** is set to 1, MUST be ignored. If **fDateAxis** is set to 0, MUST be ignored. + +**duMajor (2 bytes):** A **DateUnit enumeration** (section [2.5.66](#dateunit)) that specifies the unit of time to use for **catMajor** when the **axis** (section 2.2.3.6) is a date **axis** (section 2.2.3.6). If **fDateAxis** is set to 0, MUST be ignored. + +**catMinor (2 bytes):** An unsigned integer that specifies the interval at which the [**minor tick marks**](#gt_c2eb605a-6c5a-427e-8608-f16940de82a6) are displayed on the **axis** (section 2.2.3.6), in a unit defined by **duMinor**. MUST be less than or equal to **catMajor** when **duMajor** is equal to **duMinor**. If **fAutoMinor** is set to 1, MUST be ignored. If **fDateAxis** is set to 0, MUST be ignored. + +**duMinor (2 bytes):** A **DateUnit enumeration** (section 2.5.66) that specifies the unit of time to use for **catMinor** when the **axis** (section 2.2.3.6) is a date **axis** (section 2.2.3.6). If **fDateAxis** is set to 0, MUST be ignored. + +**duBase (2 bytes):** A **DateUnit enumeration** (section 2.5.66) that specifies the smallest unit of time used by the **axis** (section 2.2.3.6). If **fAutoBase** is set to 1, this field MUST be ignored. If **fDateAxis** is set to 0, MUST be ignored. + +**catCrossDate (2 bytes):** An unsigned integer that specifies at which date, as a date in the date system specified by the **Date1904 record** (section 2.4.77), in the units defined by **duBase**, the value **axis** (section 2.2.3.6) crosses this **axis** (section 2.2.3.6). If **fDateAxis** is set to 0, MUST be ignored. If **fAutoCross** is set to 1, MUST be ignored. + +**A - fAutoMin (1 bit):** A bit that specifies whether **catMin** is calculated automatically. If **fDateAxis** is set to 0, MUST be ignored. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **catMin** is used and **catMin** is not calculated automatically. | +| 1 | **catMin** is calculated such that the minimum **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) value can be displayed. | + +**B - fAutoMax (1 bit):** A bit that specifies whether **catMax** is calculated automatically. If **fDateAxis** is set to 0, then **fAutoMax** MUST be ignored. If the value of the **fMaxCross** field in the **CatSerRange** (section 2.4.39) record is 1, then **fAutoMax** MUST be ignored. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **catMax** is used and **catMax** is not calculated automatically. | +| 1 | **catMax** is calculated such that the minimum **data points** (section 2.2.3.10) value can be displayed. | + +**C - fAutoMajor (1 bit):** A bit that specifies whether **catMajor** is calculated automatically. If **fDateAxis** is set to 0, MUST be ignored. + +| Value | Meaning | +|----|----| +| 0 | The value specified by **catMajor** is used and **catMajor** is not calculated automatically. | +| 1 | **catMajor** is calculated automatically. | + +**D - fAutoMinor (1 bit):** A bit that specifies whether **catMinor** is calculated automatically. If **fDateAxis** is set to 0, MUST be ignored. + +| Value | Meaning | +|----|----| +| 0 | The value specified by **catMinor** is used and **catMinor** is not calculated automatically. | +| 1 | **catMinor** is calculated automatically. | + +**E - fDateAxis (1 bit):** A bit that specifies whether the **axis** (section 2.2.3.6) is a date **axis** (section 2.2.3.6). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The **axis** (section 2.2.3.6) is not a date **axis** (section 2.2.3.6). | +| 1 | The **axis** (section 2.2.3.6) is a date **axis** (section 2.2.3.6). | + +**F - fAutoBase (1 bit):** A bit that specifies whether the units of the date **axis** (section 2.2.3.6) are chosen automatically. If **fDateAxis** is set to 0, MUST be ignored. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **duBase** is used and **duBase** is not computed automatically. | +| 1 | **duBase** is calculated automatically. | + +**G - fAutoCross (1 bit):** A bit that specifies whether **catCrossDate** is calculated automatically. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **catCrossDate** is used and **catCrossDate** is not calculated automatically. | +| 1 | **catCrossDate** is calculated automatically such that it can be displayed. | + +**H - fAutoDate (1 bit):** A bit that specifies whether the **axis** (section 2.2.3.6) type is detected automatically. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The **axis** (section 2.2.3.6) will stay as specified by the **fDateAxis** field. | +| 1 | The **axis** (section 2.2.3.6) will automatically become a date **axis** (section 2.2.3.6) when the data it is related to contains date values. Otherwise, the **axis** (section 2.2.3.6) will be a [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) **axis** (section 2.2.3.6). | + +**reserved (8 bits):** MUST be zero, and MUST be ignored. + +### AxesUsed + +The **AxesUsed** record specifies the number of **axis groups** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)) on the **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
cAxes
+ +**cAxes (2 bytes):** An unsigned integer that specifies the number of **axis groups** (section 2.2.3.5) on the **chart** (section 2.2.3.3). MUST be a value from the following table: + +| Value | Axis present | +|----|----| +| 0x0001 | A single primary **axis group** (section 2.2.3.5) is present. | +| 0x0002 | Both a primary **axis group** (section 2.2.3.5) and a secondary **axis group** (section 2.2.3.5) are present. | + +If no **chart groups** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) are present on the **chart** (section 2.2.3.3), MUST be 0x0001. If the **chart sheet substream** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) contains a **Chart3d record** (section [2.4.46](#chart3d)), MUST be 0x0001. + +### Axis + +The **Axis** record specifies properties of an **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)) and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that specifies an **axis** (section 2.2.3.6). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
wTypereserved1
...reserved2
...reserved3
...reserved4
...
+ +**wType (2 bytes):** An unsigned integer that specifies the type of **axis** (section 2.2.3.6). The value MUST be 0x0000 if the record is the first **axis** (section 2.2.3.6) in the **axis group** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)). The value MUST be 0x0001 if the record is the second **axis** (section 2.2.3.6) in the **axis group** (section 2.2.3.5). The value MUST be 0x0002 if the record is the third **axis** (section 2.2.3.6) in the **axis group** (section 2.2.3.5). MUST be a value from the following table: + +| Value | Axis type | +|----|----| +| 0x0000 | **Axis** (section 2.2.3.6) type is a horizontal value **axis** (section 2.2.3.6) for a scatter **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) or a bubble **chart group** (section 2.2.3.7), or [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) **axis** (section 2.2.3.6) for all other **chart group** (section 2.2.3.7) types. | +| 0x0001 | **Axis** (section 2.2.3.6) type is a vertical value **axis** (section 2.2.3.6) for a scatter **chart group** (section 2.2.3.7) or a bubble **chart group** (section 2.2.3.7), or value **axis** (section 2.2.3.6) for all other **chart group** (section 2.2.3.7) types. | +| 0x0002 | **Axis** (section 2.2.3.6) type is a series **axis** (section 2.2.3.6). | + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved3 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved4 (4 bytes):** MUST be zero, and MUST be ignored. + +### AxisLine + +The **AxisLine** record specifies which part of the **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)) is specified by the **LineFormat** record (section [2.4.156](#lineformat)) that follows. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
id
+ +**id (2 bytes):** An unsigned integer that specifies which part of the **axis** (section 2.2.3.6) is defined by the **LineFormat** record (section 2.4.156) that follows be unique among all other **id** field values in AxisLine records in the current **axis** (section 2.2.3.6). MUST be greater than the **id** field values in preceding AxisLine records in the current **axis** (section 2.2.3.6). MUST be a value from the following table: + +| Value | Part of the axis defined | +|----|----| +| 0x0000 | The **axis** (section 2.2.3.6) line itself. | +| 0x0001 | The [**major gridlines**](#gt_2803347c-6396-46a5-9ede-6bef1149b013) along the **axis** (section 2.2.3.6). | +| 0x0002 | The [**minor gridlines**](#gt_49980976-6314-43ad-ad51-8d3e55ef4b59) along the **axis** (section 2.2.3.6). | +| 0x0003 | The [**walls**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c) or [**floor**](#gt_dc38c098-e0d3-4701-9656-5f2cf4d80f29) of a 3-D **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). | + +In the case where **id** is set to 0x0003, this record MUST be preceded by an **Axis** record (section [2.4.11](#axis-1)) with the **wType** set to a value from the following table: + +| Value of wType | Formatted object | +|----------------|-------------------------------------------------| +| 0x0000 | The walls of a 3-D **chart** (section 2.2.3.3). | +| 0x0001 | The floor of a 3-D **chart** (section 2.2.3.3). | + +### AxisParent + +The **AxisParent** record specifies properties of an **axis group** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)) and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that specifies an **axis group** (section 2.2.3.5). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iaxunused (16 bytes)
...
...
...
+ +**iax (2 bytes):** A **Boolean** (section [2.5.14](#boolean)) that specifies whether the **axis group** (section 2.2.3.5) is primary or secondary. MUST be a value from the following table. This field MUST equal 0 when in the first **AxisParent record** in the Chart Sheet Substream ABNF. This field MUST equal 1 when in the second **AxisParent record** in the Chart Sheet Substream ABNF. + +| Value | Meaning | +|--------|------------------------------------------------| +| 0x0000 | **Axis group** (section 2.2.3.5) is primary. | +| 0x0001 | **Axis group** (section 2.2.3.5) is secondary. | + +**unused (16 bytes):** Undefined and MUST be ignored. + +### Backup + +The **Backup** record specifies whether to save a backup copy of the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
fBackup
+ +**fBackup (2 bytes):** A **Boolean** (section [2.5.14](#boolean)) that specifies whether to save a backup file. The value 1 means that a backup copy of the workbook is saved when the workbook is saved. + +### Bar + +The **Bar** record specifies that the **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) is a bar **chart group** (section 2.2.3.7) or a column **chart group** (section 2.2.3.7), and specifies the **chart group** (section 2.2.3.7) attributes. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
pcOverlappcGap
ABCDreserved
+ +**pcOverlap (2 bytes):** A signed integer that specifies the overlap between **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) in the same [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) as a percentage of the **data points** (section 2.2.3.10) width. MUST be greater than or equal to -100 and less than or equal to 100. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -100 to -1 | Size of the separation between **data points** (section 2.2.3.10). | +| 0 | No overlap. | +| 1 to 100 | Size of the overlap between **data points** (section 2.2.3.10). | + +**pcGap (2 bytes):** An unsigned integer that specifies the width of the gap between the categories and the left and right edges of the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) as a percentage of the **data point** (section 2.2.3.10) width divided by 2. It also specifies the width of the gap between adjacent categories as a percentage of the **data point** (section 2.2.3.10) width. MUST be less than or equal to 500. + +**A - fTranspose (1 bit):** A bit that specifies whether the **data points** (section 2.2.3.10) and value **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)) are horizontal (for a bar **chart group** (section 2.2.3.7)) or vertical (for a column **chart group** (section 2.2.3.7)). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | **Data points** (section 2.2.3.10) and value **axis** (section 2.2.3.6) are vertical. | +| 1 | **Data points** (section 2.2.3.10) and value **axis** (section 2.2.3.6) are horizontal. | + +**B - fStacked (1 bit):** A bit that specifies whether the **data points** (section 2.2.3.10) in the **chart group** (section 2.2.3.7) that share the same category are stacked. + +**C - f100 (1 bit):** A bit that specifies whether the **data points** (section 2.2.3.10) in the **chart group** (section 2.2.3.7) are displayed as a percentage of the sum of all **data points** (section 2.2.3.10) in the **chart group** (section 2.2.3.7) that share the same category. MUST be 0 if **fStacked** is 0. + +**D - fHasShadow (1 bit):** A bit that specifies whether one or more **data points** (section 2.2.3.10) in the **chart group** (section 2.2.3.7) has shadows. + +**reserved (12 bits):** MUST be zero, and MUST be ignored. + +### BCUsrs + +The **BCUsrs** record specifies the beginning of a collection of **UsrInfo records** (section [2.4.340](#usrinfo)) as defined the [user names](#Section_1b98bc4df7c640a088dba99426635acd) stream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of **UsrInfo records** (section 2.4.340) specifies information about a user who currently has the **shared workbook** (section [2.2.11](#Section_e45a62c4490f4304a09668908b57dacc)) open. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
iCount
+ +**iCount (2 bytes):** An unsigned integer that specifies the number of users of an operating system [**Briefcase**](#gt_f95e9f06-66e9-4128-bd17-f8b60e41ef31) who have the current [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) open. + +### Begin + +The **Begin** record specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies properties of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +### BigName + +The **BigName** record specifies a name/value pair of arbitrary user-defined data that is associated with the current [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reservedlcbData
...cbNamergbName (variable)
...
rgbData (variable)
...
+ +**reserved (2 bytes):** MUST be 0x1000, and MUST be ignored. + +**lcbData (4 bytes):** A signed integer that specifies the byte count for **rgbData**. MUST be greater than or equal to zero. + +**cbName (1 byte):** An unsigned integer that specifies the byte count for **rgbName**. + +**rgbName (variable):** An array of ANSI characters whose length is specified by **cbName** that specifies the name of the custom property. + +**rgbData (variable):** An array of bytes that specifies the value of the custom property. It can continue with the [ContinueBigName](#continuebigname) records. + +### BkHim + +The **BkHim** record specifies image data for a [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) background. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cfreserved
lcb
imageBlob (variable)
...
+ +**cf (2 bytes):** A signed integer that specifies the image format. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0009 | Bitmap format. The image data is stored in a bitmap format as described in [\[MSDN-BMP\]](https://go.microsoft.com/fwlink/?LinkId=89960). | +| 0x000E | Native format. The image data is stored in the native format of another application and cannot be directly processed. | + +**reserved (2 bytes):** MUST be 0x0001, and MUST be ignored. + +**lcb (4 bytes):** A signed integer that specifies the size of **imageBlob** in bytes. MUST be greater than or equal to 1. + +**imageBlob (variable):** An array of bytes that specifies the image data for the given format. + +### Blank + +The **Blank** record specifies an empty [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) with no formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) or value. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cell
...
+ +**cell (6 bytes):** A [Cell](#cell) structure that specifies the cell. + +### BOF + +The **BOF** record specifies the beginning of the individual substreams as specified by the [workbook](#Section_f682f4b08c6b444e83f852d156f1e8ba) section. It also specifies history information for the substreams. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
versdt
rupBuildrupYear
ABCDEFGHIJKLMNreserved1
verLowestBiffOreserved2
+ +**vers (2 bytes):** An unsigned integer that specifies the [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) version of the file. The value MUST be 0x0600. + +**dt (2 bytes):** An unsigned integer that specifies the document type of the substream of records following this record. For more information about the layout of the sub-streams in the workbook stream see [File Structure](#Section_2e6147d9e8ad48b09ff7bbfc51ca950d). MUST be a value from the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
ValueMeaning
0x0005Specifies the workbook substream.
0x0010

Specifies the dialog sheet substream or the worksheet substream.

+

The sheet (1) substream that starts with this BOF record MUST contain one WsBool record. If the fDialog field in that WsBool is 1 then the sheet (1) is dialog sheet otherwise the sheet (1) is a worksheet.

0x0020Specifies the chart sheet substream.
0x0040Specifies the macro sheet substream.
+ +**rupBuild (2 bytes):** An unsigned integer that specifies the [**build identifier**](#gt_0748643f-8a66-42ea-959a-3acd533eedc5). + +**rupYear (2 bytes):** An unsigned integer that specifies the year when this BIFF version was first created. The value MUST be 0x07CC[\<27\>](#Appendix_A_27) or 0x07CD. + +**A - fWin (1 bit):** A bit that specifies whether this file was last edited on a Windows platform. The value MUST be 1. + +**B - fRisc (1 bit):** A bit that specifies whether the file was last edited on a Reduced Instruction Set Computing (RISC) platform. The value MUST be 0. + +**C - fBeta (1 bit):** A bit that specifies whether this file was last edited by a [**beta**](#gt_b7cc0e52-196c-41e1-afa2-14da4352ac5d) version of the application. The value MUST be 0. + +**D - fWinAny (1 bit):** A bit that specifies whether this file has ever been edited on a Windows platform. The value SHOULD[\<28\>](#Appendix_A_28) be 1. + +**E - fMacAny (1 bit):** A bit that specifies whether this file has ever been edited on a Macintosh platform. The value MUST be 0. + +**F - fBetaAny (1 bit):** A bit that specifies whether this file has ever been edited by a beta version of the application. The value MUST be 0. + +**G - unused1 (2 bits):** Undefined and MUST be ignored. + +**H - fRiscAny (1 bit):** A bit that specifies whether this file has ever been edited on a RISC platform. The value MUST be 0. + +**I - fOOM (1 bit):** A bit that specifies whether this file had an [**out-of-memory**](#gt_1607fcec-cc19-40a2-9a61-678f90f5943e) failure. + +**J - fGlJmp (1 bit):** A bit that specifies whether this file had an out-of-memory failure during rendering. + +**K - unused2 (2 bits):** Undefined, and MUST be ignored. + +**L - fFontLimit (1 bit):** A bit that specified that whether this file hit the 255 [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) limit[\<29\>](#Appendix_A_29). + +**M - verXLHigh (4 bits):** An unsigned integer that specifies the highest version of the application that once saved this file. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies the highest version of the application that has ever saved this file. [\<30\>](#Appendix_A_30) | +| 0x1 | Specifies the highest version of the application that has ever saved this file. [\<31\>](#Appendix_A_31) | +| 0x2 | Specifies the highest version of the application that has ever saved this file. [\<32\>](#Appendix_A_32) | +| 0x3 | Specifies the highest version of the application that has ever saved this file. [\<33\>](#Appendix_A_33) | +| 0x4 | Specifies the highest version of the application that has ever saved this file. [\<34\>](#Appendix_A_34) | +| 0x6 | Specifies the highest version of the application that has ever saved this file. [\<35\>](#Appendix_A_35) | +| 0x7 | Specifies the highest version of the application that has ever saved this file. [\<36\>](#Appendix_A_36) | + +**N - unused3 (1 bit):** Undefined, and MUST be ignored. + +**reserved1 (13 bits):** MUST be zero, and MUST be ignored. + +**verLowestBiff (8 bits):** An unsigned integer that specifies the BIFF version saved. The value MUST be 6. + +**O - verLastXLSaved (4 bits):** An unsigned integer that specifies the application that saved this file most recently. The value MUST be the value of field **verXLHigh** or less. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies the highest version of the application that has ever saved this file. [\<37\>](#Appendix_A_37) | +| 0x1 | Specifies the highest version of the application that has ever saved this file.[\<38\>](#Appendix_A_38) | +| 0x2 | Specifies the highest version of the application that has ever saved this file.[\<39\>](#Appendix_A_39) | +| 0x3 | Specifies the highest version of the application that has ever saved this file. [\<40\>](#Appendix_A_40) | +| 0x4 | Specifies the highest version of the application that has ever saved this file.[\<41\>](#Appendix_A_41) | +| 0x6 | Specifies the highest version of the application that has ever saved this file.[\<42\>](#Appendix_A_42) | +| 0x7 | Specifies the highest version of the application that has ever saved this file.[\<43\>](#Appendix_A_43) | + +**reserved2 (20 bits):** MUST be zero, and MUST be ignored. + +### BookBool + +The **BookBool** record specifies some of the properties associated with a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ABCDEFGHreserved2
+ +**A - fNoSaveSup (1 bit):** A bit that specifies that [**external link**](#gt_496fd743-2045-4c53-81b9-83fb90a7fab1) values are saved in the workbook. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------| +| 0 | External link values are saved. | +| 1 | External link values are not saved. | + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fHasEnvelope (1 bit):** A bit that specifies whether the workbook has an envelope as a result of sending the workbook to a mail recipient. If **fEnvelopeVisible** is 1 or **fEnvelopeInitDone** is 1, then this bit MUST be 1. + +**D - fEnvelopeVisible (1 bit):** A bit that specifies whether the envelope is [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72). + +**E - fEnvelopeInitDone (1 bit):** A bit that specifies whether the envelope has been initialized. + +**F - grUpdateLinks (2 bits):** An unsigned integer that specifies when the application updates external links in the workbook. The value MUST be one of the following: + +| Value | Meaning | +|----|----| +| 0 | Prompt user to update. | +| 1 | Do not update, and do not prompt user. | +| 2 | Silently update external links. The application can choose to prompt the user because of security concerns[\<44\>](#Appendix_A_44). | + +**G - unused (1 bit):** Undefined and MUST be ignored. + +**H - fHideBorderUnselLists (1 bit):** A bit that specifies whether to hide borders of [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) that do not contain the [**active cell**](#gt_2c0759a5-6721-422b-8cb9-f4bb09e07c84)[\<45\>](#Appendix_A_45). + +**reserved2 (7 bits):** MUST be zero, and MUST be ignored. + +### BookExt + +The **BookExt** record specifies properties of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) file. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
cb
ABCDEFGHIreserved
grbit1 (optional)grbit2 (optional)
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0863. + +**cb (4 bytes):** An unsigned integer that specifies the size of the record in bytes. + +**A - fDontAutoRecover (1 bit):** A bit that specifies whether [**AutoRecover**](#gt_082e4fd1-0461-4797-baa0-d2797f0ba555) is disabled for the workbook. + +**B - fHidePivotList (1 bit):** A bit that specifies whether the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) field list is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) for this workbook. + +**C - fFilterPrivacy (1 bit):** A bit that specifies whether personal information is removed from this workbook on save. + +**D - fEmbedFactoids (1 bit):** A bit that specifies whether [**smart tags**](#gt_2f57a49a-d503-4605-8798-0e53bd637609) are embedded in this workbook on save. + +**E - mdFactoidDisplay (2 bits):** A bit that specifies how smart tags are displayed in the workbook. The value MUST be one of the following: + +| Value | Meaning | +|----|----| +| 0x00 | The application will display the [**smart tag actions button**](#gt_7c1f7dd0-048a-433e-a5ac-98b32121bcb9) and the [**smart tag indicator**](#gt_62e83b67-c6c5-4a3e-8a09-2a5f0f39f65f). | +| 0x01 | The application will display the smart tag actions button only. The smart tag indicators will not be displayed. | +| 0x02 | The application will not display the smart tag actions button or the smart tag indicator. | + +**F - fSavedDuringRecovery (1 bit):** A bit that specifies whether the workbook was saved during AutoRecover. + +**G - fCreatedViaMinimalSave (1 bit):** A bit that specifies whether the workbook was created by a [**minimal save**](#gt_37ba5c27-ec42-4ccf-8122-86166df37c61) during [**data recovery**](#gt_667a7046-739a-4c24-9674-837d88e0031b). + +**H - fOpenedViaDataRecovery (1 bit):** A bit that specifies whether the workbook was opened by means of data recovery. + +**I - fOpenedViaSafeLoad (1 bit):** A bit that specifies whether the workbook was opened in [**safe load**](#gt_78d75560-7171-4a5d-be0e-3b8c14bc62c4) mode. + +**reserved (22 bits):** MUST be zero, and MUST be ignored. + +**grbit1 (1 byte):** A [BookExt_Conditional11](#bookext_conditional11) structure that specifies additional workbook-specific information. This structure MUST exist when **cb** is greater than 20. + +**grbit2 (1 byte):** A [BookExt_Conditional12](#bookext_conditional12) structure that specifies additional workbook-specific information. This structure MUST exist when **cb** is greater than 21. + +### BoolErr + +The **BoolErr** record specifies a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that contains either a Boolean value or an error value. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cell
...bes
+ +**cell (6 bytes):** A [Cell](#cell) structure that specifies the cell. + +**bes (2 bytes):** A [Bes](#bes) structure that specifies a Boolean or an error value. + +### BopPop + +The **BopPop** record specifies that the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is a bar of pie chart group or a pie of pie chart group and specifies the chart group attributes. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
pstfAutoSplitsplit
iSplitPospcSplitPercent
pcPie2SizepcGap
numSplitValue
...
Areserved
+ +**pst (1 byte):** An unsigned integer that specifies whether this chart group is a bar of pie chart group or a pie of pie chart group. MUST be a value from the following table: + +| Value | Subtype | +|-------|------------------------| +| 0x01 | Pie of pie chart group | +| 0x02 | Bar of pie chart group | + +**fAutoSplit (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether the split point of the chart group is determined automatically. If the value is 1, when a bar of pie chart group or pie of pie chart group is initially created the [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) from the [**primary pie**](#gt_e2300016-b59d-4384-9b70-c000523747e0) are selected and inserted into the [**secondary bar/pie**](#gt_e452a278-4e13-44c6-9f1b-db3c93841bc6) automatically. + +**split (2 bytes):** An unsigned integer that specifies what determines the split between the primary pie and the secondary bar/pie. MUST be ignored if **fAutoSplit** is set to 1. MUST be a value from the following table: + +| Value | Type of split | Meaning | +|----|----|----| +| 0x0000 | Position | The data is split based on the position of the data point in the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) as specified by **iSplitPos**. | +| 0x0001 | Value | The data is split based on a threshold value as specified by **numSplitValue**. | +| 0x0002 | Percent | The data is split based on a percentage threshold and the data point values represented as a percentage as specified by **pcSplitPercent**. | +| 0x0003 | Custom | The data is split as arranged by the user. Custom split is specified in a following [BopPopCustom](#boppopcustom) record. | + +**iSplitPos (2 bytes):** A signed integer that specifies how many data points are contained in the secondary bar/pie. Data points are contained in the secondary bar/pie starting from the end of the series. For example, if the value is 2, the last 2 data points in the series are contained in the secondary bar/pie. MUST be a value greater than or equal to 0 and less than or equal to 32000. If the value is more than the number of data points in the series, the entire series will be in the secondary bar/pie, except for the first data point. If **split** is not set to 0x0000 or **fAutoSplit** is set to 1, this value MUST be ignored. + +**pcSplitPercent (2 bytes):** A signed integer that specifies the percentage below which each data point is contained in the secondary bar/pie as opposed to the primary pie. The percentage value of a data point is calculated using the following formula: + +(value of the data point x 100) / sum of all data points in the series + +If **split** is not set to 0x0002 or if **fAutoSplit** is set to 1, this value MUST be ignored + +**pcPie2Size (2 bytes):** A signed integer that specifies the size of the secondary bar/pie as a percentage of the size of the primary pie. MUST be a value greater than or equal to 5 and less than or equal to 200. + +**pcGap (2 bytes):** A signed integer that specifies the distance between the primary pie and the secondary bar/pie. The distance is specified as a percentage of the average width of the primary pie and secondary bar/pie. MUST be a value greater than or equal to 0 and less than or equal to 500, where 0 is 0% of the average width of the primary pie and the secondary bar/pie, and 500 is 250% of the average width of the primary pie and the secondary bar/pie. + +**numSplitValue (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the split when the **split** field is set to 0x0001. The value of this field specifies the threshold that selects which data points of the primary pie move to the secondary bar/pie. The secondary bar/pie contains any data points with a value less than the value of this field. If **split** is not set to 0x0001 or if **fAutoSplit** is set to 1, this value MUST be ignored. + +**A - fHasShadow (1 bit):** A bit that specifies whether one or more data points in the chart group have shadows. + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +### BopPopCustom + +The **BopPopCustom** record specifies which [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) in the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) are contained in the [**secondary bar/pie**](#gt_e452a278-4e13-44c6-9f1b-db3c93841bc6) instead of the [**primary pie**](#gt_e2300016-b59d-4384-9b70-c000523747e0). MUST follow a [BopPop](#boppop) record that has its **split** field set to Custom (0x0003). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cxirggrbit (variable)
...
+ +**cxi (2 bytes):** An unsigned integer that specifies to the number of data points in the series plus one. MUST be less than 32000. + +**rggrbit (variable):** A sequence of bits that specifies whether each data point in the series is contained in the primary pie or the secondary bar/pie. For each data point a corresponding bit specifies whether a data point is contained in the secondary bar/pie or primary pie as specified in the following table: + +| Value | **Meaning** | +|-------|---------------------------------------------------| +| 0 | Data point is contained in the primary pie. | +| 1 | Data point is contained in the secondary bar/pie. | + +The size of this field, in bytes, is calculated using the following formula: + +size of **rggrbit** in bytes = 1+floor(**cxi** / 8) + +The padding of this field, in bits, is calculated using the following formula: + +padding = size of **rggrbit** in bits - **cxi** + +The position of each bit in the sequence corresponds to the position of each data point in the series arranged as follows: + +- Any padding is placed in the most significant bits of the first byte. The next most significant bit of the first byte corresponds to the first data point in the series. If there are any more unused bits in the first byte, the next most significant bit corresponds to the second data point in the series. This pattern continues until there are no remaining unused bits in the first byte. + +- The most significant bit of the next byte corresponds to the next data point in the series. The next most significant bit contains the next data point in the series. This pattern continues for each byte in the sequence. + +- The least significant bit of the final byte is an additional bit that specifies whether the secondary bar/pie does not contain data points. If the value of the additional bit is 1, the value of every other bit MUST be 0. + +The following figure demonstrates this order: + + ++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Byte 0
0 (LSB)1234567
Data Point 3Data Point 2Data Point 1Data Point 0Padding
+ + ++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Byte 1
89101112131415 (MSB)
Additional BitData Point 10Data Point 9Data Point 8Data Point 7Data Point 6Data Point 5Data Point 4
+ +### BottomMargin + +The **BottomMargin** record specifies the bottom margin of the current [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
num
...
+ +**num (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the bottom margin of the current sheet (1) in inches. The value MUST be greater than or equal to 0 and less than or equal to 49. + +### BoundSheet8 + +The **BoundSheet8** record specifies basic information about a [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d), including the sheet (1) name, [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) state, and type of sheet (1). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
lbPlyPos
AunuseddtstName (variable)
...
+ +**lbPlyPos (4 bytes):** A FilePointer as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.5 that specifies the stream position of the start of the [BOF](#bof) record for the sheet (1). + +**A - hsState (2 bits):** An unsigned integer that specifies the hidden state of the sheet (1). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | [**Visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) | +| 0x01 | Hidden | +| 0x02 | Very Hidden; the sheet (1) is hidden and cannot be displayed using the user interface. | + +**unused (6 bits):** Undefined and MUST be ignored. + +**dt (8 bits):** An unsigned integer that specifies the sheet (1) type. MUST be a value from the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
ValueMeaning
0x00

Worksheet or dialog sheet

+

The sheet substream that starts with the BOF record specified in lbPlyPos MUST contain one WsBool record. If the fDialog field in that WsBool is 1 then the sheet is dialog sheet. Otherwise, the sheet is a worksheet.

0x01Macro sheet
0x02Chart sheet
0x06VBA module
+ +**stName (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) structure that specifies the unique case-insensitive name of the sheet (1). The character count of this string, **stName.cch,** MUST be greater than or equal to 1 and less than or equal to 31. The string MUST NOT contain the any of the following characters: + +- 0x0000 + +- 0x0003 + +- colon (:) + +- backslash (\\ + +- asterisk (\*) + +- question mark (?) + +- forward slash (/) + +- opening square bracket (\[) + +- closing square bracket (\]) + +The string MUST NOT begin or end with the single quote (') character. + +### BRAI + +The **BRAI** record specifies a reference to data in a sheet that is used by a part of a [series](#Section_527ce4dfc9f84e50a314d4b07519593c), [**legend entry**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e), [trendline](#Section_61d74ebc36714d6dbdc0626db604530d) or [error bars](#Section_762a461d0a45474ebd7d5994bb294af2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
idrtAreserved
ifmtformula (variable)
...
+ +**id (1 byte):** An unsigned integer that specifies the part of the series, trendline, or error bars the referenced data specifies. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | Referenced data specifies the series, legend entry, or trendline name. Error bars name MUST be empty. | +| 0x01 | Referenced data specifies the values or horizontal values on bubble and scatter [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5) of the series and error bars. | +| 0x02 | Referenced data specifies the [**categories**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) or vertical values on bubble and scatter chart groups of the series and error bars. | +| 0x03 | Referenced data specifies the [**bubble size**](#gt_3a0cf938-5b61-4460-bdbb-3540d84d4180) values of the series. | + +**rt (1 byte):** An unsigned integer that specifies the type of data that is being referenced. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | The [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is a category name, series name or bubble size that was automatically generated. | +| 0x01 | The data source is the text or value as specified by the **formula** field. | +| 0x02 | The data source is the value from a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells in a sheet specified by the **formula** field. | + +**A - fUnlinkedIfmt (1 bit):** A bit that specifies whether the part of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) specified by the **id** field uses number formatting from the referenced data. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The data uses the number formatting of the referenced data. | +| 0x1 | The data uses the custom number formatting specified in the **ifmt** field. | + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +**ifmt (2 bytes):** An [IFmt](#ifmt) structure that specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) to use for the data. + +**formula (variable):** A [ChartParsedFormula](#chartparsedformula) structure that specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that specifies the reference. + +### BuiltInFnGroupCount + +The **BuiltInFnGroupCount** record specifies the beginning of a collection of records as defined by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies information about the built-in [**function categories**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
count
+ +**count (2 bytes):** An unsigned integer that specifies the number of built-in function categories in the workbook. The sum of **count,** the count of **FnGroupName** (section [2.4.120](#fngroupname)) records and the count of **FnGrp12** (section [2.4.121](#fngrp12)) records in the current workbook MUST be less than or equal to 256. The user-defined function categories include those defined in **FnGroupName** records and **FnGrp12** records. The value MUST be one of the following: + + ++++ + + + + + + + + + + + + + + + + +
ValueMeaning
0x0E

There are 14 built-in function categories in the workbook. This implies that the file was last saved by a specific version of the application<46>.

+

The following 9 built-in function categories are visible to the end-user: Financial, Date & Time, Math & Trig, Statistical, Lookup & Reference, Database, Text, Logical, Information.

+

The following 5 built-in function categories are not visible to the end-user: UserDefined, Commands, Customize, MacroControl, DDEExternal.

0x10

There are 16 built-in function categories in the workbook. This implies that the file was last saved by a specific version of the application<47>.

+

The following 11 built-in function categories are visible to the end-user: Financial, Date & time, Math & Trig, Statistical, Lookup & Reference, Database, Text, Logical, Information, Engineering, Cube.

+

The following 5 built-in function categories are not visible to the end-user: UserDefined, commands, Customize, MacroControl, DDEExternal

+ +### CalcCount + +The **CalcCount** record specifies the iteration count for a calculation in [**iterative calculation**](#gt_82aafd33-4105-4e36-a897-987cc03d8386) mode. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
cIter
+ +**cIter (2 bytes):** A signed integer that specifies the maximum number of iterations that can occur for a calculation in iterative calculation mode. MUST be greater than or equal to one and less than or equal to 32767. + +### CalcDelta + +The **CalcDelta** record specifies the minimum value change required for [**iterative calculation**](#gt_82aafd33-4105-4e36-a897-987cc03d8386) to continue. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
numDelta
...
+ +**numDelta (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the amount of change in value for a given [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) from the previously calculated value for that cell that MUST exist for the iteration to continue. The value MUST be greater than or equal to 0. + +### CalcIter + +The **CalcIter** record specifies the state of [**iterative calculation**](#gt_82aafd33-4105-4e36-a897-987cc03d8386). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
vfIter
+ +**vfIter (2 bytes):** A **Boolean** (section [2.5.14](#boolean)) that specifies whether to enable iterative calculation. + +If the value is 0, iterative calculation is disabled. If the value is 1, iterative calculation is enabled. + +### CalcMode + +The **CalcMode** record specifies the [**calculation mode**](#gt_f02f81e1-8eda-4ec3-88e9-c2c483ff47ee) for the workbook. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
fAutoRecalc
+ +**fAutoRecalc (2 bytes):** A signed integer that specifies whether the calculation mode is automatic or manual. + +The value MUST be one of the following: + +| Value | Meaning | +|-------|------------------------------| +| 0 | Manual | +| 1 | Automatic | +| 2 | Automatic, except for tables | + +### CalcPrecision + +The **CalcPrecision** record specifies the calculation precision mode for the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
fFullPrec
+ +**fFullPrec (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the [**precision as displayed**](#gt_e2ff81a6-eb9a-4e49-a1d0-cd4483e2e9a6) mode is [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595). + +If the value is 0, the precision as displayed mode is selected. If the value is 1, the precision as displayed mode is not selected. + +### CalcRefMode + +The **CalcRefMode** record specifies the [**reference style**](#gt_71d7e4ad-d6b6-49d9-b247-e2ebba1469e9) for the workbook. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
fRefA1
+ +**fRefA1 (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies the reference style for all formulas. + +If the value is 0, the mode is [**R1C1**](#gt_c7769777-74d5-4020-b9e5-4cd863f70132). If the value is 1, the mode is [**A1**](#gt_950691d0-4b64-4e03-84ae-10d6c872bbdb). + +### CalcSaveRecalc + +The **CalcSaveRecalc** record specifies the recalculation behavior. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
fSaveRecalc
+ +**fSaveRecalc (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether to [**recalculate**](#gt_74366612-1dc4-4e8f-8e1a-d833b829f0c3) the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) before it is saved, when in manual [**calculation mode**](#gt_f02f81e1-8eda-4ec3-88e9-c2c483ff47ee). If the value is 0, the workbook is not recalculated before it is saved. If the value is 1, the workbook is recalculated before it is saved. + +### CatLab + +The **CatLab** record specifies the attributes of the [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) label. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
wOffsetat
Aunusedreserved (optional)
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0856. + +**wOffset (2 bytes):** An unsigned integer that specifies the distance between the axis and axis label. It contains the offset as a percentage of the default distance. The default distance is equal to 1/3 the height of the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) calculated in pixels. MUST be a value greater than or equal to 0 (0%) and less than or equal to 1000 (1000%). + +**at (2 bytes):** An unsigned integer that specifies the alignment of the axis label. MUST be a value from the following table: + +| Value | Alignment | +|----|----| +| 0x0001 | Top-aligned if the **trot** field of the [Text](#text) record of the axis is not equal to 0. Left-aligned if the **iReadingOrder** field of the Text record of the axis specifies [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067) [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361); otherwise, right-aligned. | +| 0x0002 | Center-alignment | +| 0x0003 | Bottom-aligned if the **trot** field of the Text record of the axis is not equal to 0. Right-aligned if the **iReadingOrder** field of the Text record of the axis specifies left-to-right reading order; otherwise, left-aligned. | + +**A - cAutoCatLabelReal (1 bit):** A bit that specifies whether the number of [**categories**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) between axis labels is set to the default value. MUST be a value from the following table: + +| Value | Description | +|----|----| +| 0 | The value is set to **catLabel** field as specified by [CatSerRange](#catserrange) record. | +| 1 | The value is set to the default value. The number of category labels is automatically calculated by the application based on the data in the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). | + +**unused (15 bits):** Undefined, and MUST be ignored. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +### CatSerRange + +The **CatSerRange** record specifies the properties of a [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3), a date axis, or a [series](#Section_527ce4dfc9f84e50a314d4b07519593c) axis. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
catCrosscatLabel
catMarkABCreserved
+ +**catCross (2 bytes):** A signed integer that specifies where the value axis crosses this axis, based on the following table. If **fMaxCross** is set to 1, the value this field MUST be ignored. + + ++++ + + + + + + + + + + + + + + + + + + + + +
Axis TypecatCross Range
Category axisThis field specifies the category at which the value axis crosses. For example, if this field is 2, the value axis crosses this axis at the second category on this axis. MUST be greater than or equal to 1 and less than or equal to 31999.
Series axisMUST be 0.
Date axis

catCross MUST be equal to the value given by the following formula:

+
    +
  1. catCross = catCrossDate – catMin + 1

  2. +
+

Where catCrossDate is the catCrossDate field of the AxcExt record and catMin is the catMin field of the AxcExt record.

+ +**catLabel (2 bytes):** A signed integer that specifies the interval between axis labels on this axis. MUST be greater than or equal to 1 and less than or equal to 31999. MUST be ignored for a date axis. + +**catMark (2 bytes):** A signed integer that specifies the interval at which [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) and [**minor tick marks**](#gt_c2eb605a-6c5a-427e-8608-f16940de82a6) are displayed on the axis. Major tick marks and minor tick marks that would have been visible are hidden unless they are located at a multiple of this field. MUST be greater than or equal to 1, and less than or equal to 31999. MUST be ignored for a date axis. + +**A - fBetween (1 bit):** A bit that specifies whether the value axis crosses this axis between major tick marks. MUST be a value from to following table: + +| Value | Meaning | +|-------|------------------------------------------------------------| +| 0 | The value axis crosses this axis on a major tick mark. | +| 1 | The value axis crosses this axis between major tick marks. | + +**B - fMaxCross (1 bit):** A bit that specifies whether the value axis crosses this axis at the last category, the last series, or the maximum date. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value axis crosses this axis at the value specified by **catCross**. | +| 1 | The value axis crosses this axis at the last category, the last series, or the maximum date. | + +**C - fReverse (1 bit):** A bit that specifies whether the axis is displayed in reverse order. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------| +| 0 | The axis is displayed in order. | +| 1 | The axis is display in reverse order. | + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +### CbUsr + +The **CbUsr** record specifies the size of each [UsrInfo](#usrinfo) record stored as part of a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgCbUsr (512 bytes)
...
...
+ +**rgCbUsr (512 bytes):** An array of 2-byte unsigned integers. Each element in the array specifies the byte count for the UsrInfo record whose index in the collection of UsrInfo records following CbUsr corresponds to the index of the element. Array elements with a zero-based index greater than or equal to the count of users specified in the **iCount** field in [CUsr](#cusr) MUST be zero and MUST be ignored. + +### CellWatch + +The **CellWatch** record specifies a reference to a [**watched cell**](#gt_d385eaa5-d238-4320-8ac4-f1a55becdb68). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtRefHeaderU
...
...
reserved
+ +**frtRefHeaderU (12 bytes):** An [FrtRefHeaderU](#frtrefheaderu) structure that specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) to be watched. The **frtRefHeaderU.rt** field MUST be 0x086C. The **frtRefHeaderU.grbitFrt.fFrtRef** MUST be 1. The **frtRefHeaderU.ref8** specifies the cell. + +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +### CF + +The **CF** record specifies a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ctcpcce1
cce2rgbdxf (variable)
...
rgce1 (variable)
...
rgce2 (variable)
...
+ +**ct (1 byte):** An unsigned integer that specifies the type of condition. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x01 | Apply the conditional formatting when the comparison [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) specified by **cp** applied to the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) value, **rgce1** and **rgce2**, evaluates to TRUE. | +| 0x02 | Apply the conditional formatting when the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) specified by **rgce1** evaluates to TRUE. | + +**cp (1 byte):** An unsigned integer that specifies the comparison function used when **ct** is equal to 0x01. In the following table, *v* represents the cell value, and *v1* and *v2* represent the results of evaluating the formulas specified by **rgce1** and **rgce2**. The value of this field MUST be a value from the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ValueApply the conditional formatting if
0x01

v2 is greater than or equal to v1, and v is greater than or equal to v1 and less than or equal to v2

+

–Or–

+

v1 is greater than v2, and v is greater than or equal to v2 and less than or equal to v1

0x02

v2 is greater than or equal to v1, and v is less than v1 or greater than v2

+

–Or–

+

v1 is greater than v2, and v is less than v2 or greater than v1

0x03v is equal to v1
0x04v is not equal to v1
0x05v is greater than v1
0x06v is less than v1
0x07v is greater than or equal to v1
0x08v is less than or equal to v1
+ +**cce1 (2 bytes):** An unsigned integer that specifies the size of **rgce1** in bytes. MUST be less than or equal to 16409. + +**cce2 (2 bytes):** An unsigned integer that specifies the size of **rgce2** in bytes. MUST be zero when **ct** is equal to 0x02. MUST be zero when **ct** is equal to 0x01 and **cp** is greater than 0x02. MUST be less than or equal to 16409. + +**rgbdxf (variable):** A [DXFN](#dxfn) structure that specifies the formatting to apply to a cell that fulfills the condition. + +**rgce1 (variable):** A [CFParsedFormulaNoCCE](#cfparsedformulanocce) structure that specifies the first formula. If **ct** is equal to 0x01, this field is the first operand of the comparison. If **ct** is equal to 0x02, this formula is used to determine if the conditional formatting is applied. The size of **rgce1** in bytes MUST be equal to **cce1**. + +**rgce2 (variable):** A CFParsedFormulaNoCCE structure that specifies the formula that is the second operand of the comparison if **ct** is equal to 0x01 and **cp** is either equal to 0x01 or 0x02. The size of **rgce2** in bytes MUST be equal to **cce2**. + +### CF12 + +The **CF12** record specifies a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule. + +All CF12 records MUST follow a [CondFmt12](#condfmt12) record, another CF12 record, or a [CFEx](#cfex) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtRefHeader
...
...
ctcpcce1
cce2dxf (variable)
...
rgce1 (variable)
...
rgce2 (variable)
...
fmlaActive (variable)
...
ABCDEipriorityicfTemplate
...cbTemplateParmrgbTemplateParms (16 bytes)
...
...
...rgbCT (variable)
...
+ +**frtRefHeader (12 bytes):** An [FrtRefHeader](#frtrefheader). The **frtRefHeader.rt** field MUST be 0x087A. The **frtRefHeader.grbitFrt.fFrtRef** field MUST be zero. All of the fields of the **frtRefHeader.ref8** structure MUST be zero and MUST be ignored. + +**ct (1 byte):** An unsigned integer that specifies the type of condition. This field determines the type of the **rgbCT** field as specified in the following table. MUST be a value from the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ValueMeaning
0x01

Apply the conditional formatting if the comparison operation specified by cp evaluates to TRUE

+

rgbCT MUST be omitted.

0x02

Apply the conditional formatting if the formula (section 2.2.2) specified by rgce1 evaluates to TRUE.

+

rgbCT MUST be omitted.

0x03

Use color scale formatting.

+

rgbCT is a CFGradient.

0x04

Use data bar formatting.

+

rgbCT is a CFDatabar.

0x05

Apply the conditional formatting when the cell value passes a filter specified in the rgbCT structure.

+

rgbCT is a CFFilter.

0x06

Use icon set formatting

+

rgbCT is a CFMultistate.

+ +**cp (1 byte):** An unsigned integer that specifies the comparison [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) used when **ct** is equal to 0x01. In the following table, *v* represents the cell value, and *v1* and *v2* represent the results of evaluating **rgce1** and **rgce2**. The value of this field MUST be a value from the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ValueApply the conditional formatting if
0x01

v2 is greater than or equal to v1, and v is greater than or equal to v1 and less than or equal to v2

+

–Or–

+

v1 is greater than v2, and v is greater than or equal to v2 and less than or equal to v1

0x02

v2 is greater than or equal to v1, and v is less than v1 or greater than v2

+

–Or–

+

v1 is greater than v2, and v is less than v2 or greater than v1

0x03v is equal to v1
0x04v is not equal to v1
0x05v is greater than v1
0x06v is less than v1
0x07v is greater than or equal to v1
0x08v is less than or equal to v1
+ +**cce1 (2 bytes):** An unsigned integer that specifies the size of **rgce1** in bytes. MUST be zero unless **ct** is equal to 0x01 or 0x02. MUST be less than or equal to 16409. + +**cce2 (2 bytes):** An unsigned integer that specifies the size of **rgce2** in bytes. MUST be zero unless **ct** is equal to 0x01 and **cp** is equal to 0x01 or 0x02. MUST be less than or equal to 16409. + +**dxf (variable):** A [DXFN12](#dxfn12) that specifies the formatting to apply to a cell that fulfills the condition. If **ct** is equal to 0x03, 0x04 or 0x06, then **dxf.cbDxf** MUST be equal to 0x00000000. + +**rgce1 (variable):** A [CFParsedFormulaNoCCE](#cfparsedformulanocce) that specifies the formula used to evaluate the first operand in a comparison when **ct** is 0x01. If **ct** is 0x02 **rgce1** MUST be a Boolean function. + +**rgce2 (variable):** A CFParsedFormulaNoCCE that specifies the formula used to evaluate the second operand of the comparison when **ct** is 0x01 and **cp** is either 0x01 or 0x02. + +**fmlaActive (variable):** A [CFParsedFormula](#cfparsedformula) that specifies the formula that specifies an activity condition for the color scale, data bar and icon set formatting rule types. If **ct** is equal to 0x03, 0x04 or 0x06, then the conditional formatting is applied if **fmlaActive** evaluates to TRUE. + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - fStopIfTrue (1 bit):** A bit that specifies whether, when a cell fulfills the condition corresponding to this rule, the lower priority conditional formatting rules that apply to this cell are evaluated. MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x0 | Evaluate lower priority conditional formatting rules that apply to this cell | +| 0x1 | If the cell fulfills the condition corresponding to this rule, do not evaluate lower priority conditional formatting rules that apply to this cell | + +MUST be zero when **ct** is equal to 0x03, 0x04 or 0x06. + +**C - reserved1 (2 bits):** MUST be zero and MUST be ignored. + +**D - unused2 (1 bit):** Undefined and MUST be ignored. + +**E - reserved2 (3 bits):** MUST be zero and MUST be ignored. + +**ipriority (2 bytes):** An unsigned integer that specifies the priority of the rule. Rules that apply to the same cell are evaluated in increasing order of **ipriority**. MUST be unique across all CF12 records and [CFExNonCF12](#cfexnoncf12) structures in the [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream. + +**icfTemplate (2 bytes):** An unsigned integer that specifies the [**template**](#gt_159ca22f-c24d-4c6d-b08a-3d4c4c923953) from which the rule was created. MUST be a value from the following table: + +| Value | Meaning | +|--------|---------------------------| +| 0x0000 | Cell value | +| 0x0001 | Formula | +| 0x0002 | Color scale formatting | +| 0x0003 | Data bar formatting | +| 0x0004 | Icon set formatting | +| 0x0005 | Filter | +| 0x0007 | Unique values | +| 0x0008 | Contains text | +| 0x0009 | Contains blanks | +| 0x000A | Contains no blanks | +| 0x000B | Contains errors | +| 0x000C | Contains no errors | +| 0x000F | Today | +| 0x0010 | Tomorrow | +| 0x0011 | Yesterday | +| 0x0012 | Last 7 days | +| 0x0013 | Last month | +| 0x0014 | Next month | +| 0x0015 | This week | +| 0x0016 | Next week | +| 0x0017 | Last week | +| 0x0018 | This month | +| 0x0019 | Above average | +| 0x001A | Below Average | +| 0x001B | Duplicate values | +| 0x001D | Above or equal to average | +| 0x001E | Below or equal to average | + +**cbTemplateParm (1 byte):** An unsigned integer that specifies the size of the **rgbTemplateParms** field in bytes. MUST be 16. + +**rgbTemplateParms (16 bytes):** A [CFExTemplateParams](#cfextemplateparams) that specifies the parameters for the rule. + +**rgbCT (variable):** A field that specifies the parameters of this rule. The type of **rgbCT** depends on the value of **ct**. + +### CFEx + +The **CFEx** record extends a [CondFmt](#condfmt). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtRefHeaderU
...
...
fIsCF12
nIDrgbContent (variable)
...
+ +**frtRefHeaderU (12 bytes):** An [FrtRefHeaderU](#frtrefheaderu) structure. The **frtRefHeaderU.rt** field MUST be 0x087B. The **frtRefHeaderU.grbitFrt.fFrtRef** MUST be 1. The **frtRefHeaderU.ref8** MUST be equal to the **sqref** field of the associated CondFmt record specified by **nID**. + +**fIsCF12 (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies what type of rule this record extends. MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x00000000 | This record extends a rule specified by a [CF](#cf) record and MUST NOT be followed by a [CF12](#cf12) record. | +| 0x00000001 | This record extends a rule specified by a CF12 record and MUST be followed by the CF12 record it extends. | + +**nID (2 bytes):** An unsigned integer that specifies which CondFmt record is being extended. It MUST be equal to the **nID** field of one of the CondFmt records in the [Worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream. + +**rgbContent (variable):** A [CFExNonCF12](#cfexnoncf12) structure that specifies the extensions to an existing CF record. MUST be omitted when **fIsCF12** is not equal to 0x00. + +### Chart + +The **Chart** record specifies the position and size of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)) and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). The position information MUST be ignored if the chart is embedded in a sheet. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
x
y
dx
dy
+ +**x (4 bytes):** A FixedPoint as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.6 that specifies the horizontal position of the upper-left corner of the chart in [**points**](#gt_d072e4da-7898-4227-8f25-9fe77db43571). SHOULD[\<48\>](#Appendix_A_48) be greater than or equal to zero. + +**y (4 bytes):** A FixedPoint as specified in \[MS-OSHARED\] section 2.2.1.6 that specifies the vertical position of the upper-left corner of the chart in points. SHOULD[\<49\>](#Appendix_A_49) be greater than or equal to zero. + +**dx (4 bytes):** A FixedPoint as specified in \[MS-OSHARED\] section 2.2.1.6 that specifies the width in points. SHOULD[\<50\>](#Appendix_A_50) be greater than or equal to zero. + +**dy (4 bytes):** A FixedPoint as specified in \[MS-OSHARED\] section 2.2.1.6 that specifies the height in points. SHOULD[\<51\>](#Appendix_A_51) be greater than or equal to zero. + +### Chart3d + +The **Chart3d** record specifies that the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) of the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is rendered in a 3-D scene and also specifies the attributes of the 3-D plot area. The preceding chart group type MUST be of type bar, pie, line, area, or surface. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
anRotanElev
pcDistpcHeight
pcDepthpcGap
ABCDEFreserved2
+ +**anRot (2 bytes):** A signed integer that specifies the clockwise rotation, in degrees, of the 3-D plot area around a vertical line through the center of the 3-D plot area. MUST be greater than or equal to 0 and MUST be less than or equal to 360. If chart group type is bar and the value of field **fTranspose** in the record [Bar](#bar) is 1, then MUST be less than or equal to 44. + +**anElev (2 bytes):** A signed integer that specifies the rotation, in degrees, of the 3-D plot area around a horizontal line through the center of the 3-D plot area. MUST be greater than or equal to -90 and MUST be less than or equal to 90. If the chart group type is bar and the value of field **fTranspose** in the record Bar is 1, or the chart group type is pie then MUST be greater than or equal to 0. If the chart group type is bar and the value of field **fTranspose** in the record Bar is 1, then the value MUST be less than or equal to 44. + +**pcDist (2 bytes):** A signed integer that specifies the field of view angle for the 3-D plot area. MUST be greater than or equal to zero and less than 200. SHOULD[\<52\>](#Appendix_A_52) be less than or equal to 100. + +**pcHeight (2 bytes):** If **fNotPieChart** is 0, then this is an unsigned integer that specifies the thickness of the pie for a pie chart group. If **fNotPieChart** is 1, then this is a signed integer that specifies the height of the 3-D plot area as a percentage of its width. SHOULD[\<53\>](#Appendix_A_53) be greater than or equal to 5, MUST be less than 65535 and SHOULD[\<54\>](#Appendix_A_54) be less than or equal to 500. + +**pcDepth (2 bytes):** A signed integer that specifies the depth of the 3-D plot area as a percentage of its width. MUST be greater than or equal to 1 and less than or equal to 2000. + +**pcGap (2 bytes):** An unsigned integer that specifies the width of the gap between the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) and the front and back edges of the 3-D plot area as a percentage of the [data point](#Section_9c986ad250d44fa1a157063ac5c971a0) depth divided by 2. If **fCluster** is not 1 and chart group type is not a bar then **pcGap** also specifies distance between adjacent series as a percentage of the data point depth. MUST be less than or equal to 500. + +**A - fPerspective (1 bit):** A bit that specifies whether the 3-D plot area is rendered with a vanishing point. If **fNotPieChart** is 0 the value MUST be 0. If **fNotPieChart** is 1 then the value MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------------------------| +| 0 | No vanishing point applied. | +| 1 | Perspective vanishing point applied based on value of **pcDist.** | + +**B - fCluster (1 bit):** A bit that specifies whether data points are clustered together in a bar chart group. If chart group type is not bar or pie, value MUST be ignored. If chart group type is pie, value MUST be 0. If chart group type is bar, then the value MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------| +| 0 | Data points are not clustered. | +| 1 | Data points are clustered. | + +**C - f3DScaling (1 bit):** A bit that specifies whether the height of the 3-D plot area is automatically determined. If **fNotPieChart** is 0 then this MUST be 0. If **fNotPieChart** is 1 then the value MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value of **pcHeight** is used to determine the height of the 3-D plot area | +| 1 | The height of the 3-D plot area is automatically determined | + +**D - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**E - fNotPieChart (1 bit):** A bit that specifies whether the chart group type is pie. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------| +| 0 | Chart group type MUST be pie. | +| 1 | Chart group type MUST NOT be pie. | + +**F - fWalls2D (1 bit):** A bit that specifies whether the [**walls**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c) are rendered in 2-D[\<55\>](#Appendix_A_55). If **fPerspective** is 1 then this MUST be ignored. If the chart group type is not bar, area or pie this MUST be ignored. If the chart group is of type bar and **fCluster** is 0, then this MUST be ignored. If the chart group type is pie this MUST be 0 and MUST be ignored. If the chart group type is bar or area, then the value MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Chart walls and [**floor**](#gt_dc38c098-e0d3-4701-9656-5f2cf4d80f29) are rendered in 3D. | +| 1 | Chart walls are rendered in 2D and the chart floor is not rendered. | + +**reserved2 (10 bits):** MUST be zero, and MUST be ignored. + +### Chart3DBarShape + +The **Chart3DBarShape** record specifies the shape of the [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) in a bar or column [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). This record is only used for a bar or column chart group and MUST be ignored for all other chart groups. This record MUST be ignored if the current substream does not contain a [Chart3d](#chart3d) record. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
risertaper
+ +**riser (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies the shape of the base of the data points in a bar or column chart group. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------| +| 0x00 | The base of the data point is a rectangle. | +| 0x01 | The base of the data point is an ellipse. | + +**taper (1 byte):** An unsigned integer that specifies how the data points in a bar or column chart group taper from base to tip. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | The data points of the bar or column chart group do not taper. The shape at the maximum value of the data point is the same as the shape at the base. | +| 0x01 | The data points of the bar or column chart group taper to a point at the maximum value of each data point. | +| 0x02 | The data points of the bar or column chart group taper towards a projected point at the position of the maximum value of all of the data points in the chart group, but are clipped at the value of each data point. | + +### ChartFormat + +The **ChartFormat** record specifies properties of a [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a chart group. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reserved1
reserved2
reserved3
reserved4
Areserved5icrt
+ +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved3 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved4 (4 bytes):** MUST be zero, and MUST be ignored. + +**A - fVaried (1 bit):** A bit that specifies whether the color for each [data point](#Section_9c986ad250d44fa1a157063ac5c971a0) and the color and type for each [**data marker**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) varies. If the chart group has multiple [series](#Section_527ce4dfc9f84e50a314d4b07519593c), or the chart group has one series and the type is either a surface, stock, or area chart group, then this field MUST be ignored, and the data points do not vary. For all other chart group types, if the chart group has one series, then a value of 0x1 specifies that the data points vary. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The color for each data point and the color and type for each data marker does not vary. | +| 0x1 | The color for data points or the color or type for data markers varies. | + +**reserved5 (15 bits):** MUST be zero, and MUST be ignored. + +**icrt (2 bytes):** An unsigned integer that specifies the drawing order of the chart group relative to the other chart groups, where 0x0000 is the bottom of the [**z-order**](#gt_5d059b23-337a-4ab8-82f5-e3789b2e7ae9). This value MUST be unique for each instance of this record and MUST be less than or equal to 0x0009. + +### ChartFrtInfo + +The **ChartFrtInfo** record specifies the versions of the application that originally created and last saved the file, and the [Future Record](#Section_b660b67822684414839ed1ae9a4e4e85) identifiers that are used in the file. This property was introduced by a version of the application[\<56\>](#Appendix_A_56) as a Future Record for a [chart](#Section_0d96d51a09bd44ddbb691541de053776). + +In a file written by some versions of the application [\<57\>](#Appendix_A_57), this record appears before the end of the [Chart](#chart-2) record block and before any other Future Record in the record stream. This record does not exist in a file created by certain versions of the application[\<58\>](#Appendix_A_58), but appears after the [End](#end) record of the Chart record block in a file updated by other versions of the application[\<59\>](#Appendix_A_59), in which case the **verWriter** field MUST be a certain version of the application[\<60\>](#Appendix_A_60) regardless of the actual value in the record. + +If a [CrtMlFrt](#crtmlfrt) record exists in a sequence of records that conforms to the [CRTMLFRT](#chart-sheet-substream) rule of the chart sheet substream, then this record MUST immediately precede the sequence of records that conforms to the [PAGESETUP](#common-productions) rule for the chart sheet substream. Otherwise, it MUST immediately precede the first chart-specific future record, which is a [record](#Section_170e90ce87d747589331dcf14cd72388) that has a record number greater than or equal to 2048 and less than or equal to 2303 according to [Record Enumeration](#Section_7c84e174e96f45e0b23fa5e81f8b5def). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
verOriginatorverWritercCFRTID
rgCFRTID (variable)
...
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0850. + +**verOriginator (1 byte):** An unsigned integer that specifies the application version that originally created the file. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x9 | Specifies the application version[\<61\>](#Appendix_A_61) | +| 0xA | Specifies the application version[\<62\>](#Appendix_A_62) | +| 0xC | Specifies the application version[\<63\>](#Appendix_A_63) | +| 0xE | Specifies the application version[\<64\>](#Appendix_A_64) | +| 0xF | Specifies the application version[\<65\>](#Appendix_A_65) | + +**verWriter (1 byte):** An unsigned integer that specifies the application version that last saved the file. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x9 | Specifies the application version[\<66\>](#Appendix_A_66) | +| 0xA | Specifies the application version[\<67\>](#Appendix_A_67) | +| 0xC | Specifies the application version[\<68\>](#Appendix_A_68) | +| 0xE | Specifies the application version[\<69\>](#Appendix_A_69) | +| 0xF | Specifies the application version[\<70\>](#Appendix_A_70) | + +**cCFRTID (2 bytes):** An unsigned integer that specifies the number of elements in **rgCFRTID**. The value depends on the value in **verWriter**. It MUST be 0x1 if **verWriter** is 0x9; 0x3 if **verWriter** is 0xA; 0x4 if **verWriter** is 0xC or 0xE. + +**rgCFRTID (variable):** An array of [CFrtId](#cfrtid) structures. This field specifies the range of Future Record Type identifiers used in the chart. The range of values is determined by the value of **verWriter** as specified in the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + +
verWriter valueValue range(first,last)
0x90x0850, 0x085A
0xA

0x0850, 0x085A

+

0x0861, 0x0861

+

0x086A, 0x086B

0xC or 0xE

0x0850, 0x085A

+

0x0861, 0x0861

+

0x086A, 0x086B

+

0x089D, 0x08A6

+ +### ClrtClient + +The **ClrtClient** record specifies a [**custom color palette**](#gt_c24c2bf1-b41b-4eae-92a5-fe10cca57e2e) for a chart. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccvrgColor (variable)
...
+ +**ccv (2 bytes):** A signed integer that specifies the number of colors in the **rgColor** array. The value MUST be 3. + +**rgColor (variable):** An array of [LongRGB](#longrgb) structures. The array specifies the colors of the [**color palette**](#gt_05879d13-b9e0-4333-b96d-63cc3433997e). The elements MUST contain the following values: + +| Index | Element | Value | +|----|----|----| +| 0 | [**Foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) | This value MUST be equal to the system window text color. | +| 1 | [**Background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) | This value MUST be equal to the system window color. | +| 2 | Neutral color | This value MUST be black. | + +### CodeName + +The **CodeName** record specifies the name of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) object, a sheet object in the [**VBA project**](#gt_980e3334-2874-4425-a73a-f2235cec1e1e) located in this file. If this record is in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1), the name is for the workbook object. If this record is in a [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11), the name is for the [**chart sheet**](#gt_da561b7b-c629-4cd8-bfaa-6e62471d9e83) object representing the sheet. If this record is in a [Macro Sheet Substream](#macro-sheet-substream), the name is for the [**macro sheet**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491) object representing the sheet. If this record is in a [Dialog Sheet Substream](#dialog-sheet-substream), the name is for the [**dialog sheet**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8) object representing the sheet. If this record is in a [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56), the name is for the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) object representing the sheet. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
codeName (variable)
...
+ +**codeName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the name used to identify the workbook object or sheet object in the VBA project embedded in this file. The value of **codename.cch** MUST be less than or equal to 31. + +If this string is not empty, it MUST contain only the characters that can be mapped from [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) to a multiple-byte [**ANSI character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583) specified by the system [**locale**](#gt_7b78ebef-e35d-45ab-abfd-4121b60995de). If the system locale is Chinese, Japanese, or Korean, then the full-width characters in the resulting ANSI string are further mapped to corresponding half-width characters where applicable. + +In the resulting ANSI string, the first character MUST be a letter, a single-byte character with a code greater than 0x7F, or multiple-byte character. The subsequent characters in the resulting ANSI string MUST be a digit, an underscore, a single-byte character with a code greater that 0x7F, or a multiple-byte character. + +If the system locale is Japanese, the original Unicode string MUST NOT contain a character with a code equal to 0xFFE3. + +### CodePage + +The **CodePage** record specifies [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38) information for the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
cv
+ +**cv (2 bytes):** An unsigned integer that specifies the workbook’s code page. The value MUST be one of the code page values specified in [\[CODEPG\]](https://go.microsoft.com/fwlink/?LinkId=89840) or the special value 1200, which means that the workbook is [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8). + +### ColInfo + +The **ColInfo** record specifies the column formatting for a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of columns. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
colFirstcolLast
coldxixfe
ABCDEFGHIunused2
+ +**colFirst (2 bytes):** A [Col256U](#col256u) structure that specifies the first formatted column. + +**colLast (2 bytes):** A Col256U structure that specifies the last formatted column. The value MUST be greater than or equal to **colFirst**. + +**coldx (2 bytes):** An unsigned integer that specifies the column width in units of 1/256th of a character width. Character width is defined as the maximum digit width of the numbers 0, 1, 2, … 9 as rendered in the [Normal style](#Section_d039c65186dc4d9da6ee1cb8c1088f20)’s [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). + +**ixfe (2 bytes):** An [IXFCell](#ixfcell) structure that specifies the default format for the column cells. + +**A - fHidden (1 bit):** A bit that specifies whether the column range defined by **colFirst** and **colLast** is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**B - fUserSet (1 bit):** A bit that specifies that the column width was either manually set by the user or is different from the default column width as specified by [DefColWidth](#defcolwidth). If the value is 1, the column width was manually set or is different from DefColWidth. + +**C - fBestFit (1 bit):** A bit that specifies whether the column range defined by **colFirst** and **colLast** is set to "best fit." "Best fit" implies that the column width resizes based on the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) contents, and that the column width does not equal the default column width as specified by DefColWidth. + +**D - fPhonetic (1 bit):** A bit that specifies whether [**phonetic information**](#gt_b60c7bf3-21f1-481f-806f-812461e98742) is displayed by default for the column range defined by **colFirst** and **colLast**. + +**E - reserved1 (4 bits):** MUST be zero, and MUST be ignored. + +**F - iOutLevel (3 bits):** An unsigned integer that specifies the [**outline level**](#gt_a5cd5eff-ddeb-490b-bc71-f6256774e3c3) of the column range defined by **colFirst** and **colLast**. + +**G - unused1 (1 bit):** Undefined and MUST be ignored. + +**H - fCollapsed (1 bit):** A bit that specifies whether the column range defined by **colFirst** and **colLast** is in a [**collapsed outline state**](#gt_37d20510-d4a0-4fa6-9ff1-83d99d8f9262). + +**I - reserved2 (3 bits):** MUST be zero, and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +### Compat12 + +The **Compat12** record specifies whether to check for compatibility with earlier application versions when saving the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) from a version of the application[\<71\>](#Appendix_A_71) to the binary formats of other versions of the application[\<72\>](#Appendix_A_72). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
fNoCompatChk
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x088C. + +**fNoCompatChk (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether to check compatibility with earlier versions when saving the workbook. The value MUST be one of the following: + +| Value | Meaning | +|----|----| +| 0x0000 | When saving the workbook to a binary format of a version of the application[\<73\>](#Appendix_A_73), the user is given the message that some newer features could be lost during the save and prompted to continue or cancel the save. | +| 0x0001 | When saving the workbook to a binary format of a version of the application[\<74\>](#Appendix_A_74), the user is given no message or prompt before the workbook is saved. | + +### CompressPictures + +The **CompressPictures** record specifies a recommendation for picture compression when saving. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
fAutoCompressPictures
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x89B. + +**fAutoCompressPictures (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether picture compression is recommended. MUST be a value from the following table: + +| Value | Meaning | +|------------|---------------------------------| +| 0x00000000 | Compression is not recommended. | +| 0x00000001 | Compression is recommended. | + +### CondFmt + +The **CondFmt** record specifies [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules that are associated with a set of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +This record specifies the beginning of a collection of [CF](#cf) records as defined in the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of CF records specifies conditional formatting rules. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccfAnID
refBound
...
sqref (variable)
...
+ +**ccf (2 bytes):** An unsigned integer that specifies the count of CF records that follow this record. MUST be greater than or equal to 0x0001, and less than or equal to 0x0003. + +**A - fToughRecalc (1 bit):** A bit that specifies that the appearance of the cell requires significant processing. This information can be used to optimize the redraw of conditional formatting when data values change. + +For example, an application could determine that a conditional formatting rule that contains certain functions or a conditional formatting rule that takes more than a predetermined amount of time to calculate designates that the conditional formatting requires significant processing, and could set this bit to 1. + +**nID (15 bits):** An unsigned integer that identifies this record. The [CFEx](#cfex) record uses this identifier to specify which CondFmt it extends. + +**refBound (8 bytes):** A [Ref8U](#ref8u) structure that specifies the bounds of the set of cells to which the conditional formatting rules apply. The set of cells that this field represents MUST include all of the cells represented by the **sqref** field. + +**sqref (variable):** A [SqRefU](#sqrefu) structure that specifies the cells to which the conditional formatting rules apply. **sqref.cref** MUST be greater than zero and less than or equal to 1026. + +### CondFmt12 + +The **CondFmt12** record specifies [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules that are associated with a set of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461), when all the rules are specified using [CF12](#cf12) records. + +This record specifies the beginning of a collection of CF12 records as defined in the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +This record MUST be followed by the number of CF12 records specified by **mainCF.ccf** + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtRefHeaderU
...
...
mainCF (variable)
...
+ +**frtRefHeaderU (12 bytes):** An [FrtRefHeaderU](#frtrefheaderu) structure. The **frtRefHeaderU.rt** field MUST be 0x0879. The **frtRefHeaderU.grbitFrt.fFrtRef** field MUST be 1. Each field of the **frtRefHeaderU.ref8** structure MUST be equal to the corresponding field of the **mainCF.refBound** structure. + +**mainCF (variable):** A [CondFmtStructure](#condfmtstructure) structure that specifies properties of a set of conditional formatting rules. + +### Continue + +The **Continue** record specifies a continuation of the data in a preceding record. Records with data longer than 8,224 bytes MUST be split into several records. The first section of the data appears in the base record and subsequent sections appear in one or more **Continue** records that appear after the base record. Records with data shorter than 8,225 bytes can also store data in the base record and following **Continue** records. For example, the size of [TxO](#txo) record is less than 8,225 bytes, but it is followed by **Continue** records that store the string data and [**formatting runs**](#gt_10031ac8-2a26-4200-beee-cd8d9420ca96). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
continue (variable)
...
+ +**continue (variable):** A binary stream that specifies the structure data. The number of bytes in this stream MUST be less than 8225. + +### ContinueBigName + +The **ContinueBigName** record specifies a continuation of the data in a preceding [BigName](#bigname) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
continue (variable)
...
+ +**continue (variable):** A binary stream that specifies the structure data. The number of bytes in this stream MUST be less than 8225. + +### ContinueFrt + +The **ContinueFrt** record specifies a continuation of the data in a preceding [Future Record Type](#Section_b660b67822684414839ed1ae9a4e4e85) record that has data longer than 8,224 bytes. Such records are split into several records. The first section of the data appears in the base record and subsequent sections appear in one or more **ContinueFrt** records that appear after the base record. How the data is split varies for different types of records. The base record can have data size shorter than 8,224 bytes after splitting. [SXTH](#sxth) is such an example. The preceding base record MUST contain an [FrtHeaderOld](#frtheaderold) or an [FrtHeader](#frtheader) field. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
rgb (variable)
...
+ +**frtHeaderOld (4 bytes):** An FrtHeaderOld structure. The **frtHeaderOld**.**rt** field MUST be 0x0812. + +**rgb (variable):** A binary stream that specifies the record data. The number of bytes in this stream MUST be less than 8,221. + +### ContinueFrt11 + +The **ContinueFrt11** record specifies a continuation of the data in a preceding [Future Record Type](#Section_b660b67822684414839ed1ae9a4e4e85) record that has data longer than 8,224 bytes. Such records are split into several records. The first section of the data appears in the base record and subsequent sections appear in one or more **ContinueFrt11** records that appear after the base record. The preceding base record MUST contain a [FrtRefHeaderU](#frtrefheaderu) field. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
rgb (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0875. + +**rgb (variable):** A binary stream that specifies the record data. The number of bytes in this stream MUST be less than 8,213. + +### ContinueFrt12 + +The **ContinueFrt12** record specifies a continuation of the data in a preceding [Future Record Type](#Section_b660b67822684414839ed1ae9a4e4e85) record that has data longer than 8,224 bytes. Such records are split into several records. The first section of the data appears in the base record and subsequent sections appear in one or more **ContinueFrt12** records that appear after the base record. The preceding base record MUST contain a [FrtRefHeader](#frtrefheader) or a [FrtHeader](#frtheader) field. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtRefHeader
...
...
rgb (variable)
...
+ +**frtRefHeader (12 bytes):** An FrtRefHeader structure. The **frtRefHeader.rt** field MUST be 0x087F. If **frtRefHeader.grbitFrt.fFrtRef** is 1 then the **frtRefHeader.ref8** MUST refer to the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells associated with this record. If **frtRefHeader.grbitFrt.fFrtRef** is 0 then all of the fields of the **frtRefHeader.ref8** structure MUST be zero and MUST be ignored. + +**rgb (variable):** A binary stream that specifies the record data. The number of bytes in this stream MUST be less than 8,213. + +### Country + +The **Country** record specifies [**locale**](#gt_7b78ebef-e35d-45ab-abfd-4121b60995de) information for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iCountryDefiCountryWinIni
+ +**iCountryDef (2 bytes):** An unsigned integer that specifies the country/region code determined by the locale in effect when the workbook was saved. MUST be greater than or equal to 1 and less than or equal to 981 and MUST be a value from the table in **iCountryWinIni**. + +**iCountryWinIni (2 bytes):** An unsigned integer that specifies the system [**regional settings**](#gt_ede60f7f-1131-4845-800b-b6848215e015) country/region code in effect when the workbook was saved. MUST greater than or equal to 1 and less than or equal to 981 and MUST be a value from the table of Country/Region codes in this section. + +Country/Region codes are defined as follows: + +| Code | Country/Region | +|------|------------------------------| +| 1 | United States | +| 2 | Canada | +| 3 | Latin America, except Brazil | +| 7 | Russia | +| 20 | Egypt | +| 30 | Greece | +| 31 | Netherlands | +| 32 | Belgium | +| 33 | France | +| 34 | Spain | +| 36 | Hungary | +| 39 | Italy | +| 41 | Switzerland | +| 43 | Austria | +| 44 | United Kingdom | +| 45 | Denmark | +| 46 | Sweden | +| 47 | Norway | +| 48 | Poland | +| 49 | Germany | +| 52 | Mexico | +| 55 | Brazil | +| 61 | Australia | +| 64 | New Zealand | +| 66 | Thailand | +| 81 | Japan | +| 82 | Korea | +| 84 | Viet Nam | +| 86 | People’s Republic of China | +| 90 | Turkey | +| 213 | Algeria | +| 216 | Morocco | +| 218 | Libya | +| 351 | Portugal | +| 354 | Iceland | +| 358 | Finland | +| 420 | Czech Republic | +| 886 | Taiwan | +| 961 | Lebanon | +| 962 | Jordan | +| 963 | Syria | +| 964 | Iraq | +| 965 | Kuwait | +| 966 | Saudi Arabia | +| 971 | United Arab Emirates | +| 972 | Israel | +| 974 | Qatar | +| 981 | Iran | + +### CrErr + +The **CrErr** record specifies the errors detected during crash recovery of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
cb
cchrgch (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0865. + +**cb (4 bytes):** An unsigned integer that specifies the fixed size of this record. MUST be set to 0x0013. + +**cch (2 bytes):** An unsigned integer that specifies the number of characters in the crash recovery error message stored in the **rgch** field. MUST be greater than zero. + +**rgch (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the localized text of a crash recovery error message. If the **cch** field is greater than 8211 this record MUST be followed by one or more [Continue](#continue) records, which specify the continuation of the crash recovery error message. If the text is extended with Continue records a value from the table for **rgch.fHighByte** MUST be specified in the first byte of the **continue** field of the Continue record followed by the remaining portions of the text. + +### CRN + +The **CRN** record specifies the values of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a sheet in an [external cell cache](#Section_b985d1a223f3483ebebdbd0e882d4c89). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
colLastcolFirstrow
crnOper (variable)
...
+ +**colLast (1 byte):** A [ColByteU](#colbyteu) structure that specifies the zero-based column index of the last cell whose value is contained within this record. MUST be greater than or equal to the value of **colFirst**. + +**colFirst (1 byte):** A ColByteU structure that specifies the zero-based column index of the first cell whose value is contained within this record. MUST be less than or equal to the value of **colLast**. + +**row (2 bytes):** A [RwU](#rwu) structure that specifies the zero-based row index of the cells whose values are contained within this record. + +**crnOper (variable):** An array of [SerAr](#serar) structures that specifies the cell values for the cells in the row starting at **colFirst**. The number of elements in this array MUST equal the following formula: + +**colLast** - **colFirst** + 1 + +### CrtLayout12 + +The **CrtLayout12** record specifies the layout information for [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a), when contained in the sequence of records that conforms to the [ATTACHEDLABEL](#chart-sheet-substream) rule, or [legend](#Section_1832229b7d1945f488d455e9c07466f0), when contained in the sequence of records that conforms to the LD rule. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
dwCheckSum
ABreserved1wXMode
wYModewWidthMode
wHeightModex
...
...y
...
...dx
...
...dy
...
...reserved2
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x089D. + +**dwCheckSum (4 bytes):** An unsigned integer that specifies the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the values in the order as follows, if the checksum is incorrect, the layout information specified in this record MUST be ignored. + + ++++ + + + + + + + + + + + + + + + + +
Checksum for typeValues
AttachedLabel
    +
  1. x1 field of the Pos record in the sequence of records that contains this CrtLayout12 record and conforms to the ATTACHEDLABEL rule.

  2. +
  3. y1 field of the Pos record in the in the sequence of records that contains this CrtLayout12 record and conforms to the ATTACHEDLABEL rule.

  4. +
  5. An unsigned integer that specifies whether the attached label is at its default position. MUST be 1 if the dlp field of the Text record in the in the sequence of records that contains this CrtLayout12 record and conforms to the ATTACHEDLABEL rule is equal to 0xA. Otherwise, MUST be zero.

  6. +
Legend
    +
  1. x1 field of the Pos record in the in the sequence of records that contains this CrtLayout12 record and conforms to the LD rule.

  2. +
  3. y1 field of the Pos record in the in the sequence of records that contains this CrtLayout12 record and conforms to the LD rule.

  4. +
  5. Width of the legend in pixels.

  6. +
  7. Height of the legend in pixels.

  8. +
  9. The fAutoPosX field of Legend record.

  10. +
  11. The fAutoPosY field of Legend record.

  12. +
  13. The fAutoSize of the Frame record in the in the sequence of records that contains this CrtLayout12 record and conforms to the LD rule.

  14. +
+ +The checksum is calculated using the following algorithm: + +> FUNCTION SimpleCheckSum values +> +> SET dwChecksum to 0x0000 +> +> FOR each value in values +> +> SET dwChecksum TO (dwChecksum XOR value) +> +> RETURN dwChecksum + +The width and height of legend in pixels are calculated with the following steps: + +1. Get [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) width in pixels as indicated by section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d) "Chart Area" + +2. Get chart area height in pixels as indicated by section 2.2.3.17 "Chart Area" + +3. Compute legend size in pixels + +legend width in pixels = **dx** field of Legend / 4000 \* chart area width in pixels + +legend height in pixels = **dy** field of Legend / 4000 \* chart area height in pixels + +**A - unused (1 bit):** Undefined and MUST be ignored. + +**B - autolayouttype (4 bits):** An unsigned integer that specifies the automatic layout type of the legend. MUST be ignored when this record is in the sequence of records that conforms to the ATTACHEDLABEL rule. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------| +| 0x0 | Align to the bottom | +| 0x1 | Align to top right corner | +| 0x2 | Align to the top | +| 0x3 | Align to the right | +| 0x4 | Align to the left | + +**reserved1 (11 bits):** MUST be zero, and MUST be ignored. + +**wXMode (2 bytes):** A [CrtLayout12Mode](#crtlayout12mode) structure that specifies the meaning of **x**. + +**wYMode (2 bytes):** A CrtLayout12Mode structure that specifies the meaning of **y**. + +**wWidthMode (2 bytes):** A CrtLayout12Mode structure that specifies the meaning of **dx**. + +**wHeightMode (2 bytes):** A CrtLayout12Mode structure that specifies the meaning of **dy**. + +**x (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies a horizontal offset. The meaning is determined by **wXMode**. + +**y (8 bytes):** An Xnum value that specifies a vertical offset. The meaning is determined by **wYMode**. + +**dx (8 bytes):** An Xnum value that specifies a width or an horizontal offset. The meaning is determined by **wWidthMode**. + +**dy (8 bytes):** An Xnum value that specifies a height or an vertical offset. The meaning is determined by **wHeightMode**. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +### CrtLayout12A + +The **CrtLayout12A** record specifies layout information for a [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
dwCheckSum
Areserved1xTL
yTLxBR
yBRwXMode
wYModewWidthMode
wHeightModex
...
...y
...
...dx
...
...dy
...
...reserved2
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtheader.rt** field MUST be 0x08A7. + +**dwCheckSum (4 bytes):** An unsigned integer that specifies the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c). MUST be a value from the following table: + +| **fManPlotArea** field **of ShtProps** | **fAlwaysAutoPlotArea** field **of ShtProps** | **dwCheckSum** | +|----|----|----| +| 0x0 | 0x0 | 0x00000001 | +| 0x0 | 0x1 | 0x00000000 | +| 0x1 | 0x0 | 0x00000000 | +| 0x1 | 0x1 | 0x00000001 | + +**A - fLayoutTargetInner (1 bit):** A bit that specifies the type of plot area for the layout target. + +| Value | Meaning | +|----|----| +| 0x0 | Outer plot area - The bounding rectangle that includes the [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) labels, axis titles, [**data table (2)**](#gt_9e13d7ee-50d6-40ae-8789-29ecafe24bd4) and plot area of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). | +| 0x1 | Inner plot area – The rectangle bounded by the chart axes. | + +**reserved1 (15 bits):** MUST be zero, and MUST be ignored. + +**xTL (2 bytes):** A signed integer that specifies the horizontal offset of the plot area’s upper-left corner, relative to the upper-left corner of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)), in [SPRC](#Section_d5fc728e68de4972905a975bcef8c82d). + +**yTL (2 bytes):** A signed integer that specifies the vertical offset of the plot area’s upper-left corner, relative to the upper-left corner of the chart area (section 2.2.3.17), in SPRC. + +**xBR (2 bytes):** A signed integer that specifies the width of the plot area, in SPRC. + +**yBR (2 bytes):** A signed integer that specifies the height of the plot area, in SPRC. + +**wXMode (2 bytes):** A [CrtLayout12Mode](#crtlayout12mode) structure that specifies the meaning of **x**. + +**wYMode (2 bytes):** A CrtLayout12Mode structure that specifies the meaning of **y**. + +**wWidthMode (2 bytes):** A CrtLayout12Mode structure that specifies the meaning of **dx**. + +**wHeightMode (2 bytes):** A CrtLayout12Mode structure that specifies the meaning of **dy**. + +**x (8 bytes):** An Xnum (section [2.5.342](#xnum))value that specifies a horizontal offset. The meaning is determined by **wXMode**. + +**y (8 bytes):** An Xnum value that specifies a vertical offset. The meaning is determined by **wYMode**. + +**dx (8 bytes):** An Xnum value that specifies a width or a horizontal offset. The meaning is determined by **wWidthMode**. + +**dy (8 bytes):** An Xnum value that specifies a height or a vertical offset. The meaning is determined by **wHeightMode**. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +### CrtLine + +The **CrtLine** record specifies the presence of [**drop lines**](#gt_e8c745bf-646c-4acd-8b5e-5314fa4965fa), [**high-low lines**](#gt_56aec928-ddcc-4415-9d08-5d1dd3982bbc), [**series lines**](#gt_bda50b03-68fa-49f9-bd9e-d0dc289ac88a) or [**leader lines**](#gt_8b7c448e-82e3-4d22-a8ba-52e0a10b14fa) on the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). This record is followed by a [LineFormat](#lineformat) record which specifies the format of the lines. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
id
+ +**id (2 bytes):** An unsigned integer that specifies the type of line that is present on the chart group. This field value MUST be unique among the other **id** field values in CrtLine records in the current chart group. This field MUST be greater than the **id** field values in preceding CrtLine records in the current chart group. MUST be a value from the following table: + +| Value | Type of Line | +|----|----| +| 0x0000 | Drop lines below the [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) of line, area, and stock chart groups. | +| 0x0001 | High-low lines around the data points of line and stock chart groups. | +| 0x0002 | Series lines connecting data points of stacked column and bar chart groups, and the [**primary pie**](#gt_e2300016-b59d-4384-9b70-c000523747e0) to the [**secondary bar/pie**](#gt_e452a278-4e13-44c6-9f1b-db3c93841bc6) of bar of pie and pie of pie chart groups. | +| 0x0003 | Leader lines with non-default formatting connecting [data labels](#Section_cac7f43a3af142f58ff2814c2870427f) to the data point of pie and pie of pie chart groups. | + +### CrtLink + +The **CrtLink** record is written but unused. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
unused
...
...
+ +**unused (10 bytes):** Undefined and MUST be ignored. + +### CrtMlFrt + +The **CrtMlFrt** record specifies additional properties for [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) elements, as specified by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). These properties complement the record to which they correspond, and are stored as a structure chain defined in [XmlTkChain](#xmltkchain). An application can ignore this record without loss of functionality, except for the additional properties. If this record is longer than 8224 bytes, it MUST be split into several records. The first section of the data appears in this record and subsequent sections appear in one or more [CrtMlFrtContinue](#crtmlfrtcontinue) records that follow this record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
cb
xmltkChain (variable)
...
unused
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x089E. + +**cb (4 bytes):** An unsigned integer that specifies the size, in bytes, of the XmlTkChain structure starting in the **xmltkChain** field, including the data contained in the optional CrtMlFrtContinue records. MUST be less than or equal to 0x7FFFFFEB. + +**xmltkChain (variable):** An XmlTkChain structure that specifies a chain of structures. The size of the XmlTkChain is specified by the **cb** field. + +**unused (4 bytes):** Undefined, and MUST be ignored. + +### CrtMlFrtContinue + +The **CrtMlFrtContinue** record specifies additional data for a [CrtMlFrt](#crtmlfrt) record, as specified in the CrtMlFrt record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
xmltkChain (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x089F. + +**xmltkChain (variable):** An array of bytes that contains the continuation of the **xmltkChain** field of the CrtMlFrt record associated with this record. If the length of this record is greater than 8224 bytes, additional CrtMlFrtContinue records follow. + +### CUsr + +The **CUsr** record specifies the number of unique users that have this [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc) open. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
iCount
+ +**iCount (2 bytes):** An unsigned integer that specifies the number of unique users that have this shared workbook open. MUST be greater than or equal to 0 and less than or equal to 255. + +### Dat + +The **Dat** record specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies the options of the [data table](#Section_69938f61d2e94da3af87e154edcb0d98) which can be displayed within a [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ABCDreserved
+ +**A - fHasBordHorz (1 bit):** A bit that specifies whether horizontal [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) [**borders**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) are displayed within the data table. + +**B - fHasBordVert (1 bit):** A bit that specifies whether vertical cell borders are displayed within the data table. + +**C - fHasBordOutline (1 bit):** A bit that specifies whether an outside [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) is displayed around the data table. + +**D - fShowSeriesKey (1 bit):** A bit that specifies whether the [**legend key**](#gt_6981bc96-6d51-425c-9550-63c5b8b08e54) is displayed next to the name of the [series](#Section_527ce4dfc9f84e50a314d4b07519593c). If the value is 1, the legend key symbols are displayed next to the name of the series. + +**reserved (12 bits):** MUST be zero, and MUST be ignored. + +### DataFormat + +The **DataFormat** record specifies the [data point](#Section_9c986ad250d44fa1a157063ac5c971a0) or [series](#Section_527ce4dfc9f84e50a314d4b07519593c) that the formatting information that follows applies to and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). This collection of records specifies formatting properties for the data point or series. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xiyi
issAreserved
+ +**xi (2 bytes):** An unsigned integer that specifies the zero-based index of the data point within the series specified by **yi**. If this value is 0xFFFF, the formatting information that follows applies to the series. Otherwise, the formatting information that follows applies to a data point. This value MUST be less than or equal to 31999. This value MUST be less than or equal to 3999 for a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) that contains a [Chart3d](#chart3d) record. This value MUST be 0xFFFF if the formatting information in this record is applied to a [trendline](#Section_61d74ebc36714d6dbdc0626db604530d) or [error bar](#Section_762a461d0a45474ebd7d5994bb294af2). + +**yi (2 bytes):** An unsigned integer that specifies the zero-based index of a [Series](#series-1) record in the collection of Series records in this chart sheet substream. SHOULD[\<75\>](#Appendix_A_75) be less than or equal to 254. + +**iss (2 bytes):** An unsigned integer that specifies properties of the data series, trendline or error bar, depending on the type of records in sequence of records that conforms to the SERIESFORMAT rule that contains the sequence of records that conforms to the SS rule that contains this record. + +- If the SERIESFORMAT rule does not contain a [SerAuxTrend](#serauxtrend) or [SerAuxErrBar](#serauxerrbar) record, then this field specifies the plot order of the data series. If the series order was changed, this field can be different from **yi**. SHOULD[\<76\>](#Appendix_A_76) be less than or equal to the number of series in the chart. MUST be unique among **iss** values for all instances of this record contained in the SERIESFORMAT rule that does not contain a SerAuxTrend or SerAuxErrBar record. + +- If the SERIESFORMAT rule contains a SerAuxTrend record on the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), then this field specifies the trendline number for the series. + +- If the SERIESFORMAT rule contains a SerAuxErrBar record on the chart group, then this field specifies a zero-based index into a Series record in the collection of Series records in the current chart sheet substream for which the error bar applies to. + +**A - fXL4iss (1 bit):** MUST be zero, and MUST be ignored. + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +### DataLabExt + +The **DataLabExt** record specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection specifies an extended [data label](#Section_cac7f43a3af142f58ff2814c2870427f). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x086A. + +### DataLabExtContents + +The **DataLabExtContents** record specifies the contents of an extended [data label](#Section_cac7f43a3af142f58ff2814c2870427f). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
ABCDEreservedrgchSep (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x086B. + +**A - fSerName (1 bit):** A bit that specifies whether the name of the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) is displayed in the extended data label. + +**B - fCatName (1 bit):** A bit that specifies whether the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) name, or the horizontal value on bubble or scatter [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5), is displayed in the extended data label. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Neither of the data values are displayed in the extended data label. | +| 1 | If bubble or scatter chart group, the horizontal value is displayed in the extended data label. Otherwise, the category name is displayed in the extended data label. | + +**C - fValue (1 bit):** A bit that specifies whether the data value, or the vertical value on bubble or scatter chart groups, is displayed in the extended data label. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Neither of the data values are displayed in the data label. | +| 1 | If bubble or scatter chart group, the vertical value is displayed in the extended data label. Otherwise, the data value is displayed in the extended data label. | + +**D - fPercent (1 bit):** A bit that specifies whether the value of the corresponding [data point](#Section_9c986ad250d44fa1a157063ac5c971a0), represented as a percentage of the sum of the values of the series the data label is associated with, is displayed in the extended data label. + +MUST equal 0 if the chart group type of the corresponding chart group, series, or data point is not a bar of pie, doughnut, pie, or pie of pie chart group. + +**E - fBubSizes (1 bit):** A bit that specifies whether the [**bubble size**](#gt_3a0cf938-5b61-4460-bdbb-3540d84d4180) is displayed in the data label. + +MUST equal 0 if the chart group type of the corresponding chart group, series, or data point is not a bubble chart group. + +**reserved (11 bits):** MUST be zero, and MUST be ignored. + +**rgchSep (variable):** A case-sensitive [XLUnicodeStringMin2](#xlunicodestringmin2) structure that specifies the string that is inserted between every data value to form the extended data label. For example, if **fCatName** and **fValue** are set to 1, the labels will look like "*Category Name*\<*value of* **rgchSep**\>*Data Value*". The length of the string is contained in the **cch** field of the XLUnicodeStringMin2 structure. + +### Date1904 + +The **Date1904** record specifies the [**date system**](#gt_cfc29c5e-eb23-4077-b6eb-492f20f5c87f) that the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) uses. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
f1904DateSystem
+ +**f1904DateSystem (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies the date system used in this workbook. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The workbook uses the 1900 date system. The first date of the 1900 date system is 00:00:00 on January 1, 1900, specified by a serial value of 1. | +| 0x0001 | The workbook uses the 1904 date system. The first date of the 1904 date system is 00:00:00 on January 1, 1904, specified by a serial value of 0. | + +### DBCell + +The **DBCell** record specifies a row block, which is a series of up to 32 consecutive rows. + +**DBCell**, combined with the [Index](#index) record, is used to optimize the [lookup of cells](#Section_24bbaffdab88489e983f3c400c8a8559) in a [cell table](#Section_d690007dd25c4822a650b24c13288bb7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
dbRtrw
rgdb (variable)
...
+ +**dbRtrw (4 bytes):** An unsigned integer that specifies the offset in bytes from the starting file position of this record to the file position of the first [Row](#row) record. If the value is 0, the referenced row block does not contain any rows that contain cells that have data. + +**rgdb (variable):** An array of 2-byte unsigned integers that specify the file offset in bytes to the first record that specifies a [CELL](#common-productions) in each row that is a part of this row block. For the first array element, the starting position of the file offset is specified relative to the file position of the end of the first Row record in the row block. For all other elements, the file offset is specified relative to the file position of the CELL record specified by the previous element in this array. The number of elements in the array MUST be less than or equal to 32. + +### DbOrParamQry + +The **DbOrParamQry** record specifies a [DbQuery](#dbquery) or [ParamQry](#paramqry) record depending on the record that precedes this record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgb (variable)
...
+ +**rgb (variable):** A variable type field that specifies a DbQuery or ParamQry record depending on the record that precedes this record as specified by the following table: + +| Preceding Record | Record Type | +|-------------------------------|-------------| +| [SXString](#sxstring) | ParamQry | +| DbOrParamQry of type ParamQry | ParamQry | +| Any other record | DbQuery | + +### DbQuery + +The **DbQuery** record specifies information about an [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9). This record is followed by [SXString](#sxstring) and [ParamQry](#paramqry) records that specify the strings and parameters. The records MUST be in the following order: + +- If and only if **fSql** equals 1, zero or more SXString records as specified by **cstQuery**. + +- If and only if **fOdbcConn** equals 1, zero or more SXString records as specified by **cstOdbcConn**. + +- If and only if **fWeb** equals 1, zero or more SXString records as specified by **cstQuery**. + +- If and only if **fWeb** equals 1, zero or more SXString records as specified by **cstWebPost**. + +- Zero or more SXString and ParamQry pairs as specified by **cparams**. + +- If and only if **fSqlSav** equals 1, zero or more SXString records as specified by **cstSQLSav**. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
dbtABCDEFunusedcparams
cstQuerycstWebPost
cstSQLSavcstOdbcConn
+ +**dbt (3 bits):** An unsigned integer that specifies the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) type. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------------------| +| 0x1 | [ODBC data source](#Section_a8c9314e9f904738a482e97aa5ec2383) | +| 0x2 | [DAO record set](#Section_fee470a1ff184493a4dab8168e34dd58) | +| 0x4 | [Web query](#Section_f9e7fd044675413a949b2ffdb6c30324) | +| 0x5 | [OLE DB database](#Section_78e87a5485b44714ba6b90d19c098138) | +| 0x6 | [Text query](#Section_d6c94f8620c84fefac836217c00b307b) | +| 0x7 | [ADO query](#Section_d6796128906c4687a63d985bff2364d1) | + +**A - fOdbcConn (1 bit):** A bit that specifies whether the data source type is [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e). MUST be 1 if **dbt** is equal to 0x1. + +**B - fSql (1 bit):** A bit that specifies whether there is a database command string. MUST be 0 if **fWeb** is 1. If the value of **dbt** is 5 see the **grbitDbt** field of the [DBQueryExt](#dbqueryext) record for details on what the database command string specifies. Otherwise the database command string specifies an [**Structured Query Language (SQL)**](#gt_37416b0f-ca5b-4fac-96e5-082eb80a3d84) [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) string. The database command string is contained by zero or more SXString records following this record, as specified by **cstQuery**. + +**C - fSqlSav (1 bit):** A bit that specifies whether there is a SQL query string for server-based fields. For more information about server-based fields see the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) section. If and only if **fSqlSav** equals 1, the SQL query string for server-based fields is contained by zero or more SXString records following this record, as specified by **cstSQLSav**. + +**D - fWeb (1 bit):** A bit that specifies whether there is a [**Uniform Resource Locator (URL)**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) for a [**Web query**](#gt_7f21a511-63e5-43a2-ad46-235ce53af5f2). MUST be 1 if **dbt** is equal to 0x4. The URL is the command string contained in zero or more SXString records following this record, as specified by **cstQuery**. + +**E - fSavePwd (1 bit):** A bit that specifies whether the password is saved with the ODBC [**connection string**](#gt_03a9d0ca-2f10-4f3d-b910-052714a96f7d) specified by SXString records following this record. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------------------------| +| 0 | Password is removed from the ODBC connection string. | +| 1 | Password is not removed from the ODBC connection string. | + +MUST be ignored if **dbt** is not equal to 0x1. + +**F - fTablesOnlyHTML (1 bit):** A bit that specifies whether Web queries only works on HTML tables. + +**unused (7 bits):** Undefined and MUST be ignored. + +**cparams (2 bytes):** A signed integer that specifies the number of SQL parameters. Each parameter consists of an SXString record followed by a ParamQry record. The SXString record specifies the name of the parameter and the ParamQry record specifies the query parameters. MUST be greater than or equal to zero. + +**cstQuery (2 bytes):** A signed integer that specifies the number of SXString records that contain the command string, see **fWeb** and **fSql** for more details. Each SXString record specifies up to 255 characters of the complete command string. MUST be greater than or equal to zero. + +**cstWebPost (2 bytes):** A signed integer that specifies the number of SXString records that contain the Web query statement. Each SXString record specifies up to 255 characters of the complete query statement. MUST be greater than or equal to zero. MUST be 0 if **fWeb** is equal to 0. + +**cstSQLSav (2 bytes):** A signed integer that specifies the number of SXString records that contain the SQL statement for server-based fields. For more information about server-based fields see the source data section. Each SXString record specifies up to 255 characters of the complete SQL statement. MUST be greater than or equal to zero. MUST be 0 if **fSqlSav** is equal to 0. + +**cstOdbcConn (2 bytes):** A signed integer that specifies the number of SXString records that contain the ODBC connection string. Each SXString record specifies up to 255 characters of the complete connection string. MUST be greater than or equal to zero. MUST be 0 if **fOdbcConn** is equal to 0. + +### DBQueryExt + +The **DBQueryExt** record specifies information about an [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9). This record specifies the beginning of a collection of records as specified by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection specifies more information about the external connection. See the [QsiSXTag](#qsisxtag) record for details about how the [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) or [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) for the external connection is determined. The records of the collection MUST be in the following order: + +- The first record MUST be an [ExtString](#extstring) record that specifies the comma-delimited list of [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) names to import, if and only if **fTableNames** is equal to 1. + +- The next record MUST be a [TxtQry](#txtqry) record, if and only if **fTxtWiz** is equal to 1. + +- The next record or records MUST be zero or more [OleDbConn](#oledbconn) records as specified by **coledb**. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
dbtABCDEFGreserved1
grbitDbt (variable)
...
HIJreserved3bVerDbqueryEditbVerDbqueryRefreshed
bVerDbqueryRefreshableMinreserved4reserved5
coledbcstFuture
wRefreshIntervalwHtmlFmt
cwParamFlagsrgPbt (variable)
...
rgbFutureBytes (variable)
...
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0803. + +**dbt (2 bytes):** A [DataSourceType](#datasourcetype) enumeration that specifies the database source. + +**A - fMaintain (1 bit):** A bit that specifies whether the connection with the database remains open once established. + +**B - fNewQuery (1 bit):** A bit that specifies whether the connection was not refreshed. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------| +| 0 | Connection was refreshed one or more times | +| 1 | Connection was not refreshed | + +**C - fImportXmlSource (1 bit):** A bit that specifies whether the underlying [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) source or the Web page table is imported. MUST be ignored if **dbt** is not equal to 0x0004. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------| +| 0 | Web page table is imported | +| 1 | XML source is imported | + +**D - fSPListSrc (1 bit):** A bit that specifies if the external connection is using the Web based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). + +**E - fSPListReinitCache (1 bit):** A bit that specifies whether the Web based data is reinitialized rather than refreshed. MUST be ignored if **fSPListSrc** is equal to 0. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Web based data is refreshed. | +| 1 | Web based data is reinitialized by reconnecting to the Web based data provider. | + +**F - unused (2 bits):** Undefined and MUST be ignored. + +**G - fSrcIsXml (1 bit):** A bit that specifies whether the external connection source is XML. + +**reserved1 (8 bits):** MUST be zero, and MUST be ignored. + +**grbitDbt (variable):** A [ConnGrbitDbt](#conngrbitdbt) structure that specifies external connection properties specific to **dbt.** + +**H - fTxtWiz (1 bit):** A bit that specifies whether this is a [**text query**](#gt_c636d3ce-a120-4acf-91ac-40b3ec79593a). If the value is equal to 1, this record MUST be followed by a TxtQry record. + +**I - fTableNames (1 bit):** A bit that specifies whether the tables to import are specified in the ExtString record that follows this record. + +**J - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**reserved3 (13 bits):** MUST be zero, and MUST be ignored. + +**bVerDbqueryEdit (1 byte):** A [DataFunctionalityLevel](#datafunctionalitylevel) value that specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) the external connection was last edited with. + +**bVerDbqueryRefreshed (1 byte):** A DataFunctionalityLevel value that specifies the data functionality level the external connection was last refreshed with. MUST be ignored if **fNewQuery** is equal to 1. + +**bVerDbqueryRefreshableMin (1 byte):** A DataFunctionalityLevel value that specifies the minimum data functionality level that the application is required to support refreshing the external connection. MUST be ignored if **fNewQuery** is equal to 1. + +**reserved4 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved5 (2 bytes):** MUST be zero, and MUST be ignored. + +**coledb (2 bytes):** An unsigned integer that specifies the count of OleDbConn records that follow this record. MUST be zero if **dbt** is not equal to DBT_OLEDB. + +**cstFuture (2 bytes):** An unsigned integer that specifies the count of bytes in **rgbFutureBytes**. + +**wRefreshInterval (2 bytes):** An unsigned integer that specifies the number of minutes to wait between automatic refreshes of the external connection. The value MUST be greater than or equal to 0. A value of 0 specifies that the timed [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) is off. + +**wHtmlFmt (2 bytes):** An unsigned integer that specifies the HTML formatting to apply to the imported data for a [**Web query**](#gt_7f21a511-63e5-43a2-ad46-235ce53af5f2). MUST be ignored if **dbt** is not equal to 0x0004. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0001 | No formatting is applied | +| 0x0002 | Rich text formatting only | +| 0x0003 | Full HTML formatting, including [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) formatting | + +**cwParamFlags (2 bytes):** An unsigned integer that specifies the count of [PBT](#pbt) items in **rgPbt.** + +**rgPbt (variable):** An array of PBT items, each of which specifies information about the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) parameters. The PBT items in the array specify information about same query parameters as the collection of [ParamQry](#paramqry) records of the external connection. The nth PBT item in this array corresponds to the nth ParamQry record within the collection. + +**rgbFutureBytes (variable):** Information from future versions. The byte count MUST be equal to **cstFuture**. + +### DCon + +The **DCon** record specifies the [**data consolidation**](#gt_ede978bb-cef1-4f8c-b56a-7129cb228738) settings of the associated [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and specifies the beginning of a collection of records as defined by the [Macro Sheet Substream](#Section_0dddd943f77a4fc2bf92868acb4587f7) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) and [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF. The collection of records specifies the [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0) [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). Data consolidation settings can exist in a sheet that does not have a data consolidation range. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iiftabfLeftCat
fTopCatfLinkConsole
+ +**iiftab (2 bytes):** An unsigned integer that specifies the [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) used to aggregate the source data. MUST be a value from the following table: + +| Value | Function Name | Meaning | +|----|----|----| +| 0x0000 | Average | The average (arithmetic mean). | +| 0x0001 | Count Numbers | The count of the numeric values. | +| 0x0002 | Count | The count of data values. | +| 0x0003 | Maximum | The largest value. | +| 0x0004 | Minimum | The smallest value. | +| 0x0005 | Product | The product of the values. | +| 0x0006 | Standard Deviation | An estimate of the standard deviation of a population, where the sample is a subset of the entire population. | +| 0x0007 | Standard Deviation Population | The standard deviation based on the entire population. | +| 0x0008 | Sum | The summation of the numeric values. | +| 0x0009 | Variance | An estimate of the variance of a population, where the sample is a subset of the entire population. | +| 0x000A | Variance Population | The variance of a population, where the population is all of the data to be summarized. | + +**fLeftCat (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies how to identify rows for data consolidation. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | Data consolidation is based on the position of the row in the source data ranges. | +| 0x0001 | Data consolidation is based on row labels from the leftmost column of the source data ranges. String comparison is case independent and the consolidated data contains a row for each unique row label. The unique row labels appear in the first column in the [**consolidation range**](#gt_0b4c0b1d-2421-4ac6-aa61-ffb82e6a3bc1), if it exists. | + +**fTopCat (2 bytes):** A Boolean that specifies how to identify columns for data consolidation. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | Data consolidation is based on the position of the column in the source data ranges. | +| 0x0001 | Data consolidation is based on column labels from the top row of the source data ranges. String comparison is case independent and the consolidated data contains a column for each unique column label. The unique column labels appear in the top row of the consolidation range, if it exists. | + +**fLinkConsole (2 bytes):** A Boolean that specifies whether data consolidation will create references to the source data. MUST be a value from the following table: + +| Value | Meaning | +|--------|------------------------------------------------| +| 0x0000 | References are not created to the source data. | +| 0x0001 | References are created to the source data. | + +### DConBin + +The **DConBin** record specifies a built-in [**named range**](#gt_042582ea-4050-4e5c-a2df-ae39706a19b6) that is a [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) or a data source for the [**data consolidation**](#gt_ede978bb-cef1-4f8c-b56a-7129cb228738) settings of the associated [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
nBuiltinreserved1reserved2
cchFilestFile (variable)
...
unused (variable)
...
+ +**nBuiltin (1 byte):** An unsigned integer that specifies the built-in [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) for the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). MUST be a value from the following table: + +| **Value** | **Meaning** | +|-----------|--------------------| +| 0x00 | "Consolidate_Area" | +| 0x01 | "Auto_Open" | +| 0x02 | "Auto_Close" | +| 0x03 | "Extract" | +| 0x04 | "Database" | +| 0x05 | "Criteria" | +| 0x06 | "Print_Area" | +| 0x07 | "Print_Titles" | +| 0x08 | "Recorder" | +| 0x09 | "Data_Form" | +| 0x0A | "Auto_Activate" | +| 0x0B | "Auto_Deactivate" | +| 0x0C | "Sheet_Title" | +| 0x0D | "\_FilterDatabase" | + +**reserved1 (2 bytes):** MUST be zero and MUST be ignored. + +**reserved2 (1 byte):** MUST be zero and MUST be ignored. + +**cchFile (2 bytes):** An unsigned integer that specifies the character count of **stFile.** MUST be 0x0000, or greater than or equal to 0x0002. A value of 0x0000 specifies that the built-in defined name specified in **nBuiltin** has a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) scope and is contained in this file. + +**stFile (variable):** An [DConFile](#dconfile) structure that specifies the workbook or workbook and sheet that contains the range specified in **nBuiltin.** This field MUST exist if and only if the value of **cchFile** is greater than zero. If the built-in defined name has workbook scope this field specifies the workbook file that contains the built-in defined name and its associated range. If the built-in defined name has a sheet–level scope this field specifies both the sheet name and the workbook file that contains the built-in defined name and its associated range. + +**unused (variable):** An array of bytes that is unused and MUST be ignored. MUST exist if and only if **cchFile** is greater than 0 and **stFile** specifies a self-reference (the value of **stFile.stFile.rgb**\[0\] is 2). If the value **stFile.stFile.fHighByte** is 0 the size of this array is 1. If the value of **stFile.stFile.fHighByte** is 1 the size of this array is 2. + +### DConn + +The **DConn** record specifies information for a single data connection. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
dbtABCDEFGHIunused1
cParamsreserved1
JKLMNOPreserved2grbitDbt (variable)
...
bVerDbqueryEditbVerDbqueryRefreshedbVerDbqueryRefreshableMinwRefreshInterval
...wHtmlFmtrcc
...credMethod
reserved3rgchSourceDataFile (variable)
...
rgchSourceConnectionFile (variable)
...
rgchConnectionName (variable)
...
rgchConnectionDesc (variable)
...
rgchSSOApplicationID (variable)
...
tableNames (variable)
...
params (variable)
...
connection (variable)
...
rgbSQL (variable)
...
rgbSQLSav (variable)
...
rgbEditWebPage (variable)
...
id (variable)
...
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold). The **frtHeaderOld.rt** field MUST be 0x0876. + +**dbt (2 bytes):** A [DataSourceType](#datasourcetype) that specifies the type of this data connection. + +**A - fSavePwd (1 bit):** A bit that specifies whether a password is saved for this data connection. This field MUST be ignored if **dbt** is not equal to 0x0001 or 0x0005. + +**B - fTablesOnlyHtml (1 bit):** A bit that specifies whether web queries retrieve data from HTML tables only. MUST be ignored if **dbt** is not equal to 0x0004. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------| +| 0x0 | Web queries retrieve data from the entire page. | +| 0x1 | Web queries retrieve data from HTML tables only. | + +**C - fTableNames (1 bit):** A bit that specifies whether there are any HTML tables saved for this data connection. MUST be ignored if **dbt** is not equal to 0x0004. Value MUST equal 1 if **fTablesOnlyHtml** is equal to 1. + +**D - fDeleted (1 bit):** A bit that specifies whether the data connection associated with the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) has been deleted. + +**E - fStandAlone (1 bit):** A bit that specifies whether the data connection is used by the workbook. + +**F - fAlwaysUseConnectionFile (1 bit):** A bit that specifies whether the data connection information in the connection file is used when the data is refreshed. This field MUST be ignored if **dbt** is not equal to 0x0001 or 0x0005. + +**G - fBackgroundQuery (1 bit):** A bit that specifies whether the data connection is refreshed asynchronously. + +**H - fRefreshOnLoad (1 bit):** A bit that specifies whether the data connection is refreshed after the file is loaded. + +**I - fSaveData (1 bit):** A bit that specifies if the data for the data connection is persisted in the workbook. + +**unused1 (7 bits):** Undefined and MUST be ignored. + +**cParams (2 bytes):** An unsigned integer that specifies the number of parameters for a [**parameterized query**](#gt_c68a3a26-317d-4a1d-9eff-c2630b53067c). The value MUST equal 0 if **fStandAlone** equals 0. + +**reserved1 (2 bytes):** MUST be zero and MUST be ignored. + +**J - fMaintain (1 bit):** A bit that specifies whether the data connection remains open once it is established. + +**K - fNewQuery (1 bit):** A bit that specifies whether the data connection has been refreshed. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------| +| 0 | Connection has been refreshed one or more times | +| 1 | Connection has not yet been refreshed | + +**L - fImportXmlSource (1 bit):** A bit that specifies whether the underlying [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) source or the Web page table has been imported. MUST be ignored if **dbt** is not equal to 0x0004. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------| +| 0 | Web page table has been imported | +| 1 | XML source has been imported | + +**M - fSPListSrc (1 bit):** A bit that specifies whether the query is using a Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). MUST be ignored if **dbt** is not equal to 0x0005. + +**N - fSPListReinitCache (1 bit):** A bit that specifies whether the Web based data is reinitialized rather than refreshed. MUST be ignored if **dbt** is not equal to 0x0005. MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------------------------------| +| 0 | List is refreshed | +| 1 | List is reinitialized by reconnecting to the data provider | + +**O - unused2 (2 bits):** Undefined and MUST be ignored. + +**P - fSrcIsXml (1 bit):** A bit that specifies whether the query source is XML. MUST be ignored if **dbt** is not equal to 0x0004. + +**reserved2 (8 bits):** MUST be zero and MUST be ignored. + +**grbitDbt (variable):** A [ConnGrbitDbt](#conngrbitdbt) that specifies the query flags. + +**bVerDbqueryEdit (1 byte):** A [DataFunctionalityLevel](#datafunctionalitylevel) that specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) was last edited with. + +**bVerDbqueryRefreshed (1 byte):** A DataFunctionalityLevel that specifies the data functionality level the query was last refreshed with. + +**bVerDbqueryRefreshableMin (1 byte):** A DataFunctionalityLevel that specifies the minimum data functionality level that the application is required to support to [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) the query. + +**wRefreshInterval (2 bytes):** An unsigned integer that specifies the number of minutes to wait between automatic refreshes of the query. The value MUST be greater than or equal 0. + +**wHtmlFmt (2 bytes):** An unsigned integer that specifies the HTML formatting to apply to the imported data for a [**Web query**](#gt_7f21a511-63e5-43a2-ad46-235ce53af5f2). MUST be ignored if **dbt** is not equal to 0x0004. MUST be a value from the following table: + +| Value | Meaning | +|--------|---------------------------| +| 0x0001 | None | +| 0x0002 | Rich text formatting only | +| 0x0003 | Full HTML formatting | + +**rcc (4 bytes):** An unsigned integer that specifies the reconnection method. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00000000 | Reconnection method is determined by the application. | +| 0x00000001 | Reconnect. When the data connection is refreshed, the updated connection information is retrieved if it is available. This information is used instead of the persisted connection information. | +| 0x00000002 | Never reconnect. Updated connection information is never used even if the information is available and the existing connection information is invalid. | + +**credMethod (1 byte):** An unsigned integer that specifies the credentials used during reconnection. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------| +| 0x00 | Integrated authentication | +| 0x01 | Use no credentials | +| 0x02 | Use stored credentials | +| 0x03 | Prompt for credentials | + +**reserved3 (1 byte):** MUST be zero and MUST be ignored. + +**rgchSourceDataFile (variable):** A [DConnUnicodeStringSegmented](#dconnunicodestringsegmented) that specifies the database file to use if the existing [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) connection fails. MUST be ignored if **dbt** does not equal 0x0005. + +**rgchSourceConnectionFile (variable):** A DConnUnicodeStringSegmented that specifies the [**Office data connection (ODC) file**](#gt_e6fb952a-b6b6-40af-ad1b-ea6cf97da509) to use if the existing connection fails. + +**rgchConnectionName (variable):** A DConnUnicodeStringSegmented that specifies the name of the data connection associated with the workbook. + +**rgchConnectionDesc (variable):** A DConnUnicodeStringSegmented that specifies the description of the data connection associated with the workbook. + +**rgchSSOApplicationID (variable):** A DConnUnicodeStringSegmented that specifies the [**single sign-on (SSO) identifier**](#gt_aef76345-0a1f-4bcd-8700-ef5022a57cd1) string. MUST be ignored if **dbt** does not equal 0x0001 or 0x0005. + +**tableNames (variable):** A DConnUnicodeStringSegmented that specifies the list of [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) names as a comma-separated list. This field only exists when **fTableNames** is equal to 1. The total number of characters MUST be less than or equal to 255. + +**params (variable):** An array of [DConnParameter](#dconnparameter) that specifies the parameters of a parameterized query. The size of the array is determined by **cParams**. MUST NOT exist if **fStandAlone** is equal to 0. + +**connection (variable):** A variable type field. The data type and meaning vary depending on the value of **dbt**. + +| Value of dbt | Meaning | +|----|----| +| 1 | **connection** is a DConnUnicodeStringSegmented that specifies the [**connection string**](#gt_03a9d0ca-2f10-4f3d-b910-052714a96f7d). If field **fStandAlone** is 0, then connection.**st.cch** MUST be 0. | +| 4 | **connection** is a [DConnConnectionWeb](#dconnconnectionweb) that specifies the connection information for a Web query. | +| 5 | **connection** is a [DConnConnectionOleDb](#dconnconnectionoledb) that specifies the connection information for an OLE DB connection string. | +| 6 | **connection** is a [TxtQry](#txtqry) that specifies information for a [**text query**](#gt_c636d3ce-a120-4acf-91ac-40b3ec79593a). | +| Any other value | **connection** does not exist. | + +**rgbSQL (variable):** A [DConnStringSequence](#dconnstringsequence) that specifies the database command. For an OLE DB [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075), the meaning of the **dbost** field of [ConnGrbitDbtOledb](#conngrbitdbtoledb) determines the meaning of this field. For an [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) data source, this string specifies the [**SQL**](#gt_37416b0f-ca5b-4fac-96e5-082eb80a3d84) statement. MUST be ignored if **dbt** does not equal 0x0001 or 0x0005. + +**rgbSQLSav (variable):** A DConnStringSequence that specifies the original, non-parameterized SQL statement for an ODBC data source. MUST be ignored if **dbt** does not equal 0x0001. + +**rgbEditWebPage (variable):** A DConnStringSequence that specifies the [**URL**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) for the Web query edit query dialog. MUST be ignored if **dbt** does not equal 0x0004. + +**id (variable):** A [DConnId](#dconnid) that specifies the object that this connection is associated with. + +### DConName + +The **DConName** record specifies a [**named range**](#gt_042582ea-4050-4e5c-a2df-ae39706a19b6) that is a [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) or a data source for the [**data consolidation**](#gt_ede978bb-cef1-4f8c-b56a-7129cb228738) settings of the associated [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). The [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) is specified as a reference to an [external workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc) or a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). If the named range is in an external workbook, this record specifies the path to the external workbook. If the named range has a defined name that has a sheet-level scope, this record also specifies the name of the sheet that contains the range. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
stName (variable)
...
cchFilestFile (variable)
...
unused (variable)
...
+ +**stName (variable):** An [XLNameUnicodeString](#xlnameunicodestring) structure that specifies a defined name for the source range. + +**cchFile (2 bytes):** An unsigned integer that specifies the character count of **stFile**. MUST be 0x0000, or greater than or equal to 0x0002. A value of 0x0000 specifies that the defined name in **stName** has a workbook scope and is contained in this file. + +**stFile (variable):** A [DConFile](#dconfile) structure that specifies the workbook, or workbook and sheet, that contains the range specified in **stName.** This field exists only if the value of **cchFile** is greater than zero. If the defined name in **stName** has workbook scope, this field specifies the workbook file that contains the defined name and its associated range. If the defined name in **stName** has a sheet-level scope, this field specifies both the sheet name and the workbook that contains the defined name and its associated range. + +**unused (variable):** An array of bytes that is unused and MUST be ignored. MUST exist if and only if **cchFile** is greater than 0 and **stFile** specifies a self-reference (the value of **stFile.stFile.rgb**\[0\] is 2). If the value **stFile.stFile.fHighByte** is 0, the size of this array is 1. If the value of **stFile.stFile.fHighByte** is 1, the size of this array is 2. + +### DConRef + +The **DConRef** record specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) or in an [external workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc) that is a [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) or a data source for the [**data consolidation**](#gt_ede978bb-cef1-4f8c-b56a-7129cb228738) settings of the associated [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). If the range specified is in an external workbook this record also specifies the path to the external workbook. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ref
...cchFile
stFile (variable)
...
unused (variable)
...
+ +**ref (6 bytes):** A [RefU](#refu) structure that specifies the range. If this record is part of an [SXTBL](#globals-substream) production as specified in the Globals Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) and this field has a **rwFirst** equal to 0 and a **rwLast** equal to 16383, this reference specifies all rows within the columns specified by **colFirst** and **colLast**. + +**cchFile (2 bytes):** An unsigned integer that specifies the count of characters in **stFile**. MUST be greater than or equal to 0x0002. + +**stFile (variable):** A [DConFile](#dconfile) structure that specifies the workbook and sheet that contains the range specified in the **ref** field. + +**unused (variable):** An array of bytes that is unused and MUST be ignored. MUST exist if and only if **stFile** specifies a self reference (the value of **stFile.stFile.rgb**\[0\] is 2). If the value **stFile.stFile.fHighByte** is 0 the size of this array is 1. If the value of **stFile.stFile.fHighByte** is 1 the size of this array is 2. + +### DefaultRowHeight + +The **DefaultRowHeight** record specifies the height of all empty rows in the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). An empty row is a row that only contains [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) without data or formatting. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDreservedmiyRw (optional)
miyRwHidden (optional)
+ +**A - fUnsynced (1 bit):** A bit that specifies whether the default settings for the row height have been changed. + +**B - fDyZero (1 bit):** A bit that specifies whether empty rows have a height of zero. + +**C - fExAsc (1 bit):** A bit that specifies whether all empty rows have a thick [**border style**](#gt_2baf659e-8e18-4f60-b3d0-ce0b8e1f2eab) applied to the top [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) (as specified in field **fExAsc** of record [Row](#row)). + +**D - fExDsc (1 bit):** A bit that specifies whether all empty rows have a thick border style applied to the bottom border (as specified in field **fExDes** of record Row). + +**reserved (12 bits):** MUST be zero, and MUST be ignored. + +**miyRw (2 bytes):** A signed integer that specifies the default row height, in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382), for empty rows. MUST exist if and only if **fDyZero** is 0. MUST be greater than or equal to 1 and less than or equal to 8179. + +**miyRwHidden (2 bytes):** A signed integer that specifies the default row height, in twips, to apply to a [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) row when unhidden. MUST exist if and only if **fDyZero** is 1. MUST be greater than or equal to 0 and less than or equal to 8179. + +### DefaultText + +The **DefaultText** record specifies the text elements that are formatted using the information specified by the [Text](#text) record immediately following this record. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
id
+ +**id (2 bytes):** An unsigned integer that specifies the text elements that are formatted using the position and appearance information specified by the Text record immediately following this record. MUST be a value from the following table. + +If this record is in a sequence of records that conforms to the [CRT](#chart-sheet-substream) rule as specified by the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), then this field MUST be 0x0000 or 0x0001. If this record is not in a sequence of records that conforms to the CRT rule as specified by the Chart Sheet Substream ABNF, then this field MUST be 0x0002 or 0x0003. + +| Value | Meaning | +|----|----| +| 0x0000 | Format all Text records in the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) where **fShowPercent** is equal to 0 or **fShowValue** is equal to 0. | +| 0x0001 | Format all Text records in the chart group where **fShowPercent** is equal to 1 or **fShowValue** is equal to 1. | +| 0x0002 | Format all Text records in the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) where the value of **fScaled** of the associated [FontInfo](#fontinfo) structure is equal to 0. | +| 0x0003 | Format all Text records in the chart where the value of **fScaled** of the associated FontInfo structure is equal to 1. | + +### DefColWidth + +The **DefColWidth** record specifies the default column width of a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and specifies the beginning of a collection of [ColInfo](#colinfo) records as defined by the [Macro Sheet Substream](#Section_0dddd943f77a4fc2bf92868acb4587f7) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) and [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF. The collection of ColInfo records specifies the column formatting for a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of columns. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
cchdefColWidth
+ +**cchdefColWidth (2 bytes):** An unsigned integer that specifies the default width, in number of characters, of the columns in the sheet. MUST be less than or equal to 255. + +### Dimensions + +The **Dimensions** record specifies the used [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). It specifies the row and column bounds of used [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the sheet. Used cells include all cells with formulas (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) or data. Used cells also include all cells with formatting applied directly to the cell. Cells can also be formatted by default row or column formatting. If a row has default formatting then the used range includes that row in its row bounds, but does not affect the used range column bounds, unless the used range would otherwise be empty, in which case the column bounds are set to include the first column. If a column has default formatting then the used range includes that column in its column bounds, but does not affect the used range row bounds, unless the used range would otherwise be empty, in which case the row bounds are set to include the first row. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwMic
rwMac
colMiccolMac
reserved
+ +**rwMic (4 bytes):** A [RwLongU](#rwlongu) structure that specifies the first row in the sheet that contains a used cell. + +**rwMac (4 bytes):** An unsigned integer that specifies the zero-based index of the row after the last row in the sheet that contains a used cell. MUST be less than or equal to 0x00010000. If this value is 0x00000000, no cells on the sheet are used cells. + +**colMic (2 bytes):** A [ColU](#colu) structure that specifies the first column in the sheet that contains a used cell. + +**colMac (2 bytes):** An unsigned integer that specifies the zero-based index of the column after the last column in the sheet that contains a used cell. MUST be less than or equal to 0x0100. If this value is 0x0000, no cells on the sheet are used cells. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +### DocRoute + +The **DocRoute** record specifies the document routing information for a [**routing slip**](#gt_8cedfe36-260c-416e-aeab-7fee4bdef9c3)[\<77\>](#Appendix_A_77) that is used to send a document in an e-mail message and specifies the beginning of a collection of [RecipName](#recipname) records as defined by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of RecipName records specifies the recipients of the routing slip. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iStagecRecip
delOptionABCDEFunused2
cchSubjectcchMessage
cchRouteIDcchCustType
cchBookTitlecchOrg
ulEIDSize
szSubject (variable)
...
szMessage (variable)
...
szRouteID (variable)
...
szCustType (variable)
...
szBookTitle (variable)
...
szOrg (variable)
...
rgchSSAddr (variable)
...
+ +**iStage (2 bytes):** An unsigned integer that specifies the [**routing stage**](#gt_8a637321-ad73-45ee-bfdb-9de9c12fc505) of the slip. This value MUST be less than or equal to the **cRecip** field +1. + +**cRecip (2 bytes):** An unsigned integer that specifies the number of recipients. MUST equal the actual number of RecipName records that follow this record. + +**delOption (2 bytes):** An unsigned integer that specifies the delivery option. MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------| +| 0x00 | Deliver to one recipient at a time | +| 0x01 | Deliver to all recipients at once | + +**A - fRouted (1 bit):** A bit that specifies whether the document has been routed. + +**B - fReturnOrig (1 bit):** A bit that specifies whether the document is returned to the originator after being routed to the last recipient. + +**C - fTrackStatus (1 bit):** A bit that specifies whether a status message is sent to the originator after the document is routed. + +**D - fCustomType (1 bit):** A bit that specifies whether there is a custom message type defined by **szCustType**. + +**E - unused1 (3 bits):** Undefined and MUST be ignored. + +**F - fSaveRouteInfo (1 bit):** A bit that specifies whether the routing information is saved with the document. MUST equal 1. + +**unused2 (8 bits):** Undefined and MUST be ignored. + +**cchSubject (2 bytes):** An unsigned integer that specifies the count of characters in the **szSubject** field string. MUST be less than or equal to 256. + +**cchMessage (2 bytes):** An unsigned integer that specifies the count of characters in the **szMessage** field string. MUST be less than or equal to 256. + +**cchRouteID (2 bytes):** An unsigned integer that specifies the count of characters in the **szRouteID** field string. MUST be less than or equal to 256. + +**cchCustType (2 bytes):** An unsigned integer that specifies the count of characters in the **szCustType** field string. MUST be less than or equal to 256. MUST equal 0 if the **fCustomType** field equals 0. + +**cchBookTitle (2 bytes):** An unsigned integer that specifies the count of characters in the **szBookTitle** field string. MUST be less than or equal to 256. + +**cchOrg (2 bytes):** An unsigned integer that specifies the count of characters in the **szOrg** field string. MUST be less than or equal to 256. + +**ulEIDSize (4 bytes):** An unsigned integer that specifies the count of characters in the **rgchSSAddr** field string. When combined with the values of **cchSubject**, **cchMessage**, **cchRouteID**, **cchCustType**, **cchBookTitle**, and **cchOrg** fields, the value MUST be less than or equal to 8202. + +**szSubject (variable):** A NULL terminated array of ANSI characters that specifies the subject of the routed document. The length of the string MUST be specified by the **cchSubject** field. The field MUST NOT exist if the **cchSubject** field is 0. + +**szMessage (variable):** A NULL terminated array of ANSI characters that specifies the message of the routed document. The length of the string MUST be specified by the **cchMessage** field. The field MUST NOT exist if the **cchMessage** field is 0. + +**szRouteID (variable):** A NULL terminated array of ANSI characters that specifies the name of the routing identifier. The length of the string MUST be specified by the **cchRouteID** field. The field MUST NOT exist if the **cchRouteID** field is 0. + +**szCustType (variable):** A NULL terminated array of ANSI characters that specifies a custom message. The length of the string MUST be specified by the **cchCustType** field. The field MUST NOT exist if the field **cchCustType** is 0. + +**szBookTitle (variable):** A NULL terminated array of ANSI characters that specifies the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) title. The length of the string MUST be specified by the **cchBookTitle** field. The field MUST NOT exist if the **cchBookTitle** field is 0. + +**szOrg (variable):** A NULL terminated array of ANSI characters that specifies the originator’s [**friendly name**](#gt_3dafc161-8c9d-406a-8cbd-c61e7f925eea). The length of the string MUST be specified by the **cchOrg** field. The field MUST NOT exist if the **cchOrg** field is 0. + +**rgchSSAddr (variable):** A NULL terminated array of ANSI characters that specifies the identifier used by the [**messaging system service provider**](#gt_ff288e35-3b60-4a5e-99d6-faa6afa8009a) to identify the originator’s e-mail address. The length of the string MUST be specified by the **ulEIDSize** field. The field MUST NOT exist if the **ulEIDSize** field is 0. + +### DropBar + +The **DropBar** record specifies the attributes of the [**up bars**](#gt_24acb31a-39aa-4a44-829b-c18e1767a4ac) or the [**down bars**](#gt_d8bcbdc9-46a4-44e5-b184-40c565e4dd07) between multiple [series](#Section_527ce4dfc9f84e50a314d4b07519593c) of a line [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The first of these collections in the line chart group specifies the attributes of the up bars.  The second specifies the attributes of the down bars.  If this record exists, then the chart group type MUST be line and the field **cSer** in the record [SeriesList](#serieslist) MUST be greater than 1. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
pcGap
+ +**pcGap (2 bytes):** A signed integer that specifies the width of the gap between the up bars or the down bars. MUST be a value between 0 and 500. The width of the gap in [SPRCs](#Section_d5fc728e68de4972905a975bcef8c82d) can be calculated by the following formula: + +Width of the gap in SPRCs = 1 + **pcGap** + +### DropDownObjIds + +The **DropDownObjIds** record specifies the object identifiers that can be reused by the application when creating the dropdown objects for the [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) at runtime in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
cidObjrgidObj (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0874. + +**cidObj (2 bytes):** An unsigned integer that specifies the count of the object identifiers in **rgidObj**. + +**rgidObj (variable):** An array of 2-byte unsigned integers that specifies the object identifiers that can be reused by the application when creating the dropdown objects for the AutoFilter at runtime in a sheet. These object identifiers MUST NOT equal an existing [ObjId](#objid) structure in the [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream. + +### DSF + +The **DSF** record is reserved and MUST be ignored. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
reserved
+ +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +### Dv + +The **Dv** record specifies a single set of [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) criteria defined for a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) on this [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
valTypeABCDmdImeModeEFGreserved
PromptTitle (variable)
...
ErrorTitle (variable)
...
Prompt (variable)
...
Error (variable)
...
formula1 (variable)
...
formula2 (variable)
...
sqref (variable)
...
+ +**valType (4 bits):** An unsigned integer that specifies the type of data validation.  MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that the data validation allows any type of value and does not check for a type or range of values. | +| 0x1 | Specifies that the data validation checks for and allows whole number values satisfying the given condition. | +| 0x2 | Specifies that the data validation checks for and allows decimal values satisfying the given condition. | +| 0x3 | Specifies that the data validation checks for and allows a value that matches one in a list of values. | +| 0x4 | Specifies that the data validation checks for and allows date values satisfying the given condition. | +| 0x5 | Specifies that the data validation checks for and allows time values satisfying the given condition. | +| 0x6 | Specifies that the data validation checks for and allows text values whose length satisfies the given condition. | +| 0x7 | Specifies that the data validation uses a custom formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) to check the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) value. | + +**A - errStyle (3 bits):** An unsigned integer that specifies the style of error alert to be used in the error message which is shown if the **fShowErrorMsg** bit is set to 1.  MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that the data validation error style uses a stop [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) in the error alert. | +| 0x1 | Specifies that the data validation error style uses a warning icon in the error alert. | +| 0x2 | Specifies that the data validation error style uses an information icon in the error alert | + +**B - fStrLookup (1 bit):** A bit that specifies whether a list of valid inputs was specified for data validation. MUST be ignored if **valType** is not equal to 3. + +**C - fAllowBlank (1 bit):** A bit that specifies whether the data validation treats empty or blank entries as valid. + +**D - fSuppressCombo (1 bit):** A bit that specifies whether to suppress the display of the in-cell drop-down when the cell is [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595). MUST be ignored if **valType** is not equal to 3. + +**mdImeMode (8 bits):** An unsigned integer that specifies the [**Input Method Editor (IME)**](#gt_19d3dd70-8d6a-4847-9827-ebbde6b1a9b7) mode enforced by this data validation. This value is only used when the [**input language**](#gt_223b5207-0d94-4cc1-891d-3c74349d606a) is one of the following languages: + +- Chinese Simplified (Locale identifier = 2052) + +- Chinese Traditional (Locale identifier = 1028) + +- Japanese (Locale identifier = 1041) + +- Korean  (Locale identifier = 1042) + +The input for the cell can be restricted to specific sets of characters, as specified by the value of **mdImeMode**. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------------------------------| +| 0x00 | No Control | +| 0x01 | On | +| 0x02 | Off (English) | +| 0x04 | Hiragana | +| 0x05 | [**wide katakana**](#gt_49e3662b-e146-4c32-a815-eaac74a92000) | +| 0x06 | [**narrow katakana**](#gt_514e674e-2e44-41d8-9c31-ee11c825b669) | +| 0x07 | Full-width alphanumeric | +| 0x08 | Half-width alphanumeric | +| 0x09 | Full-width hangul | +| 0x0A | Half-width hangul | + +**E - fShowInputMsg (1 bit):** A bit that specifies whether to show an input prompt when the cell is selected. + +**F - fShowErrorMsg (1 bit):** A bit that specifies whether to display an error message when the data validation fails. + +**G - typOperator (4 bits):** An unsigned integer that specifies the relational operator used with this data validation.  If **valType** is equal to 0, 3 or 7, the value of the **typOperator** field is undefined and MUST be ignored.  MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------| +| 0x0 | Between | +| 0x1 | Not Between | +| 0x2 | Equals | +| 0x3 | Not Equals | +| 0x4 | Greater Than | +| 0x5 | Less Than | +| 0x6 | Greater Than or Equal To | +| 0x7 | Less Than or Equal To | + +**reserved (8 bits):** MUST be zero, and MUST be ignored. + +**PromptTitle (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the title of the input prompt that is displayed when the cell is selected. The number of characters in this string MUST be less than or equal to 32. + +**ErrorTitle (variable):** An XLUnicodeString structure that specifies the title of the error that is displayed when the cell value entered fails the data validation criteria. The number of characters in this string MUST be less than or equal to 32. + +**Prompt (variable):** An XLUnicodeString structure that specifies the message shown in the input prompt that is displayed when the cell is selected. The number of characters in this string MUST be less than or equal to 255. + +**Error (variable):** An XLUnicodeString structure that specifies the error message that is displayed when the cell value entered fails the data validation criteria. The number of characters in this string MUST be less than or equal to 225. + +**formula1 (variable):** A [DVParsedFormula](#dvparsedformula) structure that specifies the first formula (section 2.2.2) used in data validation. + +If **valType** is equal to 0, this formula MUST be ignored and **formula1.cce** MUST be zero. + +If **valType** is not one of 0, 3, or 7 and **typOperator** is equal to 0 or 1, this formula is used as the lesser of two bounding values and **formula1.cce** MUST be greater than or equal to 1. + +Otherwise, this formula is the only formula for those cases, and **formula1.cce** MUST be greater than or equal to 1. + +**formula2 (variable):** A DVParsedFormula structure that specifies the second formula used in data validation. + +If **typOperator** is greater than or equal to 2 or **valType** is equal to 0, 3 or 7, this formula MUST be ignored and **formula2.cce** MUST be zero. + +Otherwise, this formula is used as the greater of two bounding values and **formula2.cce** MUST be greater than or equal to 1. + +**sqref (variable):** A [SqRefU](#sqrefu) structure that specifies all the ranges over which data validation is applied. The value of **sqref.cref** MUST be greater than 0 and less than or equal to 432. + +### DVal + +The **DVal** record specifies [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) information that is common to all cells in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that have data validation applied and specifies the beginning of a collection of [Dv](#dv) records as defined by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of Dv records specifies data validation criteria for individual [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) in the sheet. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCreserved2xLeft
...yTop
...idObj
...idvMac
...
+ +**A - fWnClosed (1 bit):** A bit that specifies whether the window used for input is closed. + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - unused (1 bit):** Undefined and MUST be ignored. + +**reserved2 (13 bits):** MUST be zero, and MUST be ignored. + +**xLeft (4 bytes):** An unsigned integer that specifies the X-coordinate of the top left corner of the window used for input relative to the window used to display the sheet, in pixels. MUST be less than or equal to 65535. + +**yTop (4 bytes):** An unsigned integer that specifies the Y-coordinate of the top left corner of the window used for input relative to the window used to display the sheet, in pixels. MUST be less than or equal to 65535. + +**idObj (4 bytes):** A signed integer that specifies a reference to an [Obj](#obj) that represents the drop-down button displayed if a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) with a drop-down button is the [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) cell at the time the file is saved. The value of this field specifies the value of the **cmo.id** field of the associated Obj record. MUST be greater than 0 and less than or equal to 32767 if the drop-down button is displayed. MUST be -1 if there is no drop-down button being displayed in the selected cell at the time the file is saved. + +**idvMac (4 bytes):** An unsigned integer that specifies the number of Dv records that follow this record. MUST be greater than or equal to 0 and less than or equal to 65534. There MUST be exactly that many Dv records following this record. + +### DXF + +The **DXF** record specifies a [differential format](#Section_f0b6070c31f54d3dbcb719612da8b8f6). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
ABCreservedxfprops (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 2189. + +**A - unused1 (1 bit):** Undefined and MUST be ignored.[\<78\>](#Appendix_A_78) + +**B - fNewBorder (1 bit):** A bit that specifies whether it is possible to specify internal [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad) in **xfprops**. Internal border formatting is formatting that applies to borders that lie between a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that internal border formatting cannot be used in **xfprops**. | +| 0x1 | Specifies that internal border formatting can be used in **xfprops**. | + +**C - unused2 (1 bit):** Undefined and MUST be ignored. + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +**xfprops (variable):** An [XFProps](#xfprops) structure that specifies the formatting properties. + +### DxGCol + +The **DxGCol** record specifies the default column width for all [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) columns that do not have a column width explicitly specified. If an explicit column width was specified for a column, it is stored in a [ColInfo](#colinfo) record. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
dxgCol
+ +**dxgCol (2 bytes):** An unsigned integer that specifies the default column width. For the purposes of this field specification, a standard digit is defined to be the widest digit in the [Normal style](#Section_d039c65186dc4d9da6ee1cb8c1088f20) [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). The default column width is measured in the number of standard digits that fit in the column multiplied by 256 and rounded down. The value MUST be less than or equal to 65535 or be equal to 0xFFFFFFFF. If the value is 0xFFFFFFFF, this value MUST be ignored. + +### End + +The **End** record specifies the end of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies properties of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +### EndBlock + +The **EndBlock** record specifies the end of a collection of records. [Future records](#Section_b660b67822684414839ed1ae9a4e4e85) contained in this collection specify saved features to allow applications that do not support the feature to preserve the information. This record MUST have an associated [StartBlock](#startblock) record. StartBlock and EndBlock pairs can be nested. Up to 100 levels of blocks can be nested. + +EndBlock records MUST be written according to the following rules: + +- If there exists a StartBlock record with **iObjectKind** equal to 0x0000 without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the [End](#end) record of the current [Axis Group](#Section_578b739742624944b5a67ee6d4d3bb55). + +- If there exists a StartBlock record with **iObjectKind** equal to 0x0002 without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current [AttachedLabel](#Section_9ac44e58af9940f4a99ace470eff0f5a). + +- If there exists a StartBlock record with **iObjectKind** equal to 0x0004 without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current [Axis](#Section_4117f73aa0f348d89c0f65864918ffb3). + +- If there exists a StartBlock record with **iObjectKind** equal to 0x0005 without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). + +- If there exists a StartBlock record with **iObjectKind** equal to 0x0006 without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the sequence of records containing the StartBlock and conforming to the [DAT](#chart-sheet-substream) rule. + +- If there exists a StartBlock record with **iObjectKind** equal to 0x0007 without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the sequence of records containing the StartBlock and conforming to the FRAME rule. + +- If there exists a StartBlock record with **iObjectKind** equal to 0x0009 without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current [Legend](#Section_1832229b7d1945f488d455e9c07466f0). + +- If there exists a StartBlock record with **iObjectKind** equal to 0x000A without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current [Begin](#begin) and End collection that exists immediately after [LegendException](#legendexception) in the sequence of records conforming to the SERIESFORMAT rule. + +- If there exists a StartBlock record with **iObjectKind** equal to 0x000C without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current [Series](#Section_527ce4dfc9f84e50a314d4b07519593c). + +- If there exists a StartBlock record with **iObjectKind** equal to 0x000D without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current [Sheet](#Section_2c90d75bc92645aa8ff29d4483f51831). + +- If there exists a StartBlock record with **iObjectKind** equal to 0x000E without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current SS production. + +- If there exists a StartBlock record with **iObjectKind** equal to 0x000F without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the sequence of records containing the StartBlock and conforming to the DROPBAR rule. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
iObjectKindunused1 (optional)
unused2 (optional)unused3 (optional)
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0853. + +**iObjectKind (2 bytes):** An unsigned integer that specifies the type of object that is encompassed by the block. MUST equal the **iObjectKind** field of the associated StartBlock record. MUST be a value from the following table: + +| Value | Object Type | +|--------|---------------------------| +| 0x0000 | Axis Group | +| 0x0002 | AttachedLabel | +| 0x0004 | Axis | +| 0x0005 | chart group | +| 0x0006 | [Dat](#dat) | +| 0x0007 | Frame | +| 0x0009 | Legend | +| 0x000A | LegendException | +| 0x000C | Series | +| 0x000D | Sheet | +| 0x000E | [DataFormat](#dataformat) | +| 0x000F | DropBar | + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**unused3 (2 bytes):** Undefined and MUST be ignored. + +### EndObject + +The **EndObject** record specifies properties of an [Future Record Type (FRT)](#Section_b660b67822684414839ed1ae9a4e4e85) as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a feature saved as an FRT such that an application not supporting the feature can preserve it. This record MUST have an associated [StartObject](#startobject) record. StartObject and EndObject pairs can be nested. Up to 100 levels of blocks can be nested. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
iObjectKindunused1 (optional)
unused2 (optional)unused3 (optional)
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0855. + +**iObjectKind (2 bytes):** An unsigned integer that specifies the type of object that is encompassed by the block. MUST equal the **iObjectKind** field of the associated StartObject record. MUST be a value from the following table: + +| Value | Object Type | +|--------|-----------------------------| +| 0x0010 | [YMult](#ymult) | +| 0x0011 | [FrtFontList](#frtfontlist) | +| 0x0012 | [DataLabExt](#datalabext) | + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**unused3 (2 bytes):** Undefined and MUST be ignored. + +### EntExU2 + +The **EntExU2** record specifies an application-specific cache of information. SHOULD NOT[\<79\>](#Appendix_A_79) be written, and SHOULD[\<80\>](#Appendix_A_80) be ignored. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgb (variable)
...
+ +**rgb (variable):** An array of bytes that specifies an application-specific cache of information. This cache exists for performance reasons only, and can be rebuilt based on information stored elsewhere in the file without affecting calculation results. + +### EOF + +The **EOF** record specifies the end of a collection of records as defined by [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF, [Dialog Sheet Substream](#Section_da37feb48b9a462d87772a5fddd4866e) ABNF, [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) ABNF, [macro sheet](#Section_0dddd943f77a4fc2bf92868acb4587f7) substream ABNF, [revision](#revision-stream-revision-log) stream ABNF, and [pivot cache](#Section_c5fb3f663ef64308ae3de59244159687) storage ABNF. + +### Excel9File + +The **Excel9File** record is optional and is unused. It doesn’t exist on files that were last saved in a specific version of the application[\<81\>](#Appendix_A_81). + +### ExternName + +The **ExternName** record specifies an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2), a User Defined Function ([**UDF**](#gt_5068e37f-372c-41df-9357-1072e12ed970)) reference on a [**XLL**](#gt_3d6e3f45-91e7-46d5-871c-0b2fde20b5f5) or [**COM**](#gt_ef2ebebc-1760-407a-9ace-af48f9050e02) [**add-in**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6), a [DDE data item](#Section_2492b742489e489f945187a703134708) or an [OLE data item](#Section_11cff7c06cf34f8694bede7a72497e21), depending on the value of the **virtPath** field in the preceding [SupBook](#supbook) record. If the **cch** field in the preceding SupBook record is 0x3A01, then this record specifies a UDF reference. Otherwise if the **virtPath** field in the preceding SupBook record conforms to the ole-link rule specified in the [VirtualPath](#virtualpath) ABNF, then this record specifies a DDE data item or an OLE data item. Otherwise, this record specifies an external defined name. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEcfFbody (variable)
...
+ +**A - fBuiltIn (1 bit):** A bit that specifies whether this record specifies a user-defined or built-in external defined name. The value MUST be 0 if this record specifies a DDE data item, an OLE data item or a UDF reference on a XLL or COM add-in. Otherwise, MUST be one of the following: + +| Value | Meaning | +|-------|--------------------------------------------| +| 0 | The external defined name is user-defined. | +| 1 | The external defined name is built-in. | + +**B - fWantAdvise (1 bit):** A bit that specifies whether this record is an automatic DDE data item or OLE data item. MUST be one of the following: + +| Value | Meaning | +|----|----| +| 0 | The record is an external defined name, a manual DDE data item, a manual OLE data item or a UDF reference on a XLL or COM add-in. | +| 1 | The record is either an automatic DDE data item or an automatic OLE data item. | + +**C - fWantPict (1 bit):** A bit that specifies whether this record's linked data uses a picture format. The value MUST be 0 if this record specifies an external defined name or a UDF reference on a XLL or COM add-in. + +**D - fOle (1 bit):** A bit that, together with the value of **fOleLink**, specifies the structure of **body**. The value MUST be 0 if this record is an external defined name, an OLE data item or a UDF reference on a XLL or COM add-in. If this value is 1, **fOleLink** MUST be 0. + +**E - fOleLink (1 bit):** A bit that, together with the value of **fOle**, specifies the structure of **body**. The value MUST be 0 if this record is an external defined name or a UDF reference on a XLL or COM add-in. If this value is 1, **fOle** MUST be 0 and this record specifies an OLE data item. + +**cf (10 bits):** A signed integer that specifies the type of the cached clipboard format for a DDE data item or an OLE data item. The value MUST be 0 if this record is an external defined name or a UDF reference on a XLL or COM add-in. The value MUST be one of the values in the following table: + +| Value | Meaning | +|----|----| +| -1 | There is no cached clipboard format. | +| 0 | This record is an external defined name or the cached clipboard format is text. For the text format, each line ends with a carriage return/linefeed (CR-LF) combination. A null character signals the end of the data. | +| 2 | Cached clipboard format is Enhanced Metafile. | +| 5 | Cached clipboard format is CSV (comma-delimited). | +| 6 | Cached clipboard format is Microsoft Symbolic Link (SYLK). SYLK is a format used to exchange data between applications. | +| 7 | Cached clipboard format is rich text (RTF). | +| 8 | Cached clipboard format is [**BIFF8**](#gt_e60b71bb-c66c-4a44-ab07-0f9f20ee3dd5). | +| 9 | Cached clipboard format is Bitmap. | +| 16 | Cached clipboard format is a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) created using a specific application[\<82\>](#Appendix_A_82). | +| 20 | Cached clipboard format is [**BIFF3**](#gt_3b9d80df-ea32-495e-b43b-fa8a6d942ab9). | +| 30 | Cached clipboard format is [**BIFF4**](#gt_d99263f5-d806-4c42-9923-00c72054162a). | +| 36 | Cached clipboard format is Metafile Picture Format. | +| 44 | Cached clipboard format is [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) text. Each line ends with a carriage return/linefeed (CR-LF) combination. A null character signals the end of the data. | +| 63 | Cached clipboard format is [**BIFF12**](#gt_3da41ba7-d5ae-4b62-b410-e36e20650d0d). | + +**F - fIcon (1 bit):** A bit that specifies whether linked data is displayed as an [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870). The value MUST be 0 if this record is an external defined name, a DDE data item or a UDF reference on a XLL or COM add-in. + +**body (variable):** A variable type field whose type and meaning is dictated by the values of **fOle** and **fOleLink**, as specified in the following table: + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
cch in the preceding SupBookDDE data item or OLE data itemfOlefOleLinkMeaning
!= 0x3A01no00body is an ExternDocName that specifies an external defined name.
!= 0x3A01yes00body is an ExternOleDdeLink that specifies an OLE data item or DDE data item.
!= 0x3A01yes01
!= 0x3A01yes10body is an ExternDdeLinkNoOper that specifies a DDE data item.
0x3A01no00Body is an AddinUdf that specifies a UDF reference on a XLL or COM add-in.
+ +### ExternSheet + +The **ExternSheet** record specifies a collection of [XTI](#xti) structures. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cXTIrgXTI (variable)
...
+ +**cXTI (2 bytes):** An unsigned integer that specifies the number of elements in the **rgXTI** array. + +**rgXTI (variable):** An array of XTI structures. The number of elements in this array MUST be **cXTI**. + +### ExtSST + +The **ExtSST** record specifies the location of sets of strings within the shared string table, specified in the [SST](#sst) record. This record is used to perform a quick lookup of a string within the shared string table, given the string’s index into the table (as specified in [LabelSst](#labelsst)). To do that, first use the string’s index and the value of **dsst** to find the set the string is in, then use the corresponding element in **rgISSTInf** to find the beginning of that set, and finally search incrementally forward in that set to locate the string. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
dsstrgISSTInf (variable)
...
+ +**dsst (2 bytes):** An unsigned integer that specifies the number of strings in each set specified by [ISSTInf](#isstinf). Number of strings in each set except the last set MUST be equal to the value specified by the following formula: + +max(((SST.**cstUnique** / 128) + 1),8) + +Number of strings in the last set MUST be less than or equal to the value specified by the following formula: + +max(((SST.**cstUnique** / 128) + 1),8) + +**rgISSTInf (variable):** An array of ISSTInf structures. Each array element specifies the location of a set of strings within the SST record. The number of elements is determined by first evaluating the following formula[\<83\>](#Appendix_A_83): + +(SST.**cstUnique** mod **ExtSST**.**dsst**) + +If the result of the previous formula is equal to 0, then the number of elements MUST be equal to the value as specified by the following formula: + +(SST.**cstUnique** / **ExtSST**.**dsst**) + +Otherwise, the number of elements MUST be equal to the value as specified by the following formula: + +(SST.**cstUnique** / **ExtSST**.**dsst**) + 1 + +### ExtString + +The **ExtString** record specifies the [**connection string**](#gt_03a9d0ca-2f10-4f3d-b910-052714a96f7d) for a [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) that retrieves [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
string (variable)
...
unused1 (variable)
...
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 2052. + +**string (variable):** A [XLUnicodeString](#xlunicodestring) structure that specifies the connection string. + +**unused1 (variable):** Undefined and MUST be ignored. MUST exist if and only if the value of the following formula is less than 12 bytes: + +size of **string** + size of **frtHeaderOld** + +The size of this field, in bytes, is calculated using the following formula: + +12 – (size of **string** + size of **frtHeaderOld**) + +### Fbi + +The **Fbi** record specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information at the time the scalable font is added to the chart.[\<84\>](#Appendix_A_84) + +If the scaled font size matches the font size of the [Font](#font) record (as specified by **ifnt** and Font.**dyHeight**), then that Font record is used to render the scaled fonts. If the scaled font size doesn't match the size of the Font record (as specified by **ifnt**), then a new Font record is added to the font table and the following [**font scaling**](#gt_47254269-4165-4a8c-92a0-c920f732d0bd) algorithm is used to determine the scaled font size: + +1. Start with the current chart area in dots or pixels at 96 DPI. Convert this size to Twips by multiplying width and height by 1440 Twips per inch / 96 dots per inch. Call this dmix and dmiy respectively. + +2. If the scale basis **scab** is [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c), then apply the plot area scaling factors PlotGrowth.**dxPlotGrowth**/65536 and PlotGrowth.**dyPlotGrowth**/65536 to dmix and dmiy respectively. + +3. Determine the scaled height basis by multiplying **twpHeightBasis** by dmix / **dmixBasis**; name this twpX. + +4. Multiply **twpHeightBasis** by dmiy / **dmiyBasis**; call this twpY. + +5. Take the smaller of twpX and twpY and name this twpNew. If this value is less than 10, set it equal to 10. + +6. Round this value to the nearest quarter [**point**](#gt_d072e4da-7898-4227-8f25-9fe77db43571). + +7. If the value of **twpHeightBasis** is between 160 (inclusive) and 240 (inclusive), and the value of twpNew is between 120 (inclusive) and 160, make twpNew equal to 160. If the value of Fbi.**twpHeightBasis** is between 160 (inclusive) and 240 (inclusive), and value of twpNew is between 240 and 280 (inclusive), make twpNew equal to 240. + +8. twpNew is the new scaled font size. If the **dyHeight** field of the Font record (as specified by Fbi.**ifnt**) is the same as the value of twpNew, then load that Font record for the scaled font. If it isn't the same, twpNew is the new scaled font size and a new Font record is added to the font table. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
dmixBasisdmiyBasis
twpHeightBasisscab
ifnt
+ +**dmixBasis (2 bytes):** An unsigned integer that specifies the font width, in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382), when the font was first applied. MUST be greater than or equal to 0 and less than or equal to 0x7FFF. + +**dmiyBasis (2 bytes):** An unsigned integer that specifies the font height, in twips, when the font was first applied. MUST be greater than or equal to 0 and less than or equal to 0x7FFF. + +**twpHeightBasis (2 bytes):** An unsigned integer that specifies the default font height in twips. MUST be greater than or equal to 20 and less than or equal to 8180. + +**scab (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies the scale to use. The value MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x0000 | Scale by [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) | +| 0x0001 | Scale by plot area | + +**ifnt (2 bytes):** A [FontIndex](#fontindex) structure that specifies the font. MUST be used when **ifnt** is less than or equal to 255. + +### Fbi2 + +The **Fbi2** record specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information at the time the scalable font is added to the chart.[\<85\>](#Appendix_A_85) + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
dmixBasisdmiyBasis
twpHeightBasisscab
ifnt
+ +**dmixBasis (2 bytes):** An unsigned integer that specifies the font width, in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382), when the font was first applied. MUST be greater than or equal to 0 and less than or equal to 0x7FFF. + +**dmiyBasis (2 bytes):** An unsigned integer that specifies the font height, in twips, when the font was first applied. MUST be greater than or equal to 0 and less than or equal to 0x7FFF + +**twpHeightBasis (2 bytes):** An unsigned integer that specifies the default font height in twips. MUST be greater than or equal to 20 and less than or equal to 8180. + +**scab (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies the scale to use. The value MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x0000 | Scale by [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)) | +| 0x0001 | Scale by [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) | + +**ifnt (2 bytes):** A [FontIndex](#fontindex) structure that specifies the font. MUST be used when **ifnt** is greater than 255. + +### Feat + +The **Feat** record specifies [Shared Feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2) data. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
isfreserved1reserved2
...cref
...cbFeatData
...reserved3refs (variable)
...
rgbFeat (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. **frtHeader.rt** MUST be 0x0868. + +**isf (2 bytes):** A [SharedFeatureType](#sharedfeaturetype) enumeration that specifies the type of Shared Feature data stored in the **rgbFeat** field. MUST NOT be ISFLIST. + +**reserved1 (1 byte):** Reserved and MUST be zero. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +**cref (2 bytes):** An unsigned integer that specifies the number of elements in the **refs** field. + +**cbFeatData (4 bytes):** An unsigned integer whose meaning is determined by the value of **isf**. If **isf** is ISFFEC2, this field specifies the size in bytes of Shared Feature data that is stored in the **rgbFeat** field. Otherwise, this field MUST be zero and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**refs (variable):** An array of [Ref8U](#ref8u) structures. Specifies the [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) referenced by the Shared Feature. The number of elements in the array is specified by **cref**. + +**rgbFeat (variable):** A variable type field that specifies Shared Feature data. The type is dictated by the value of **isf**, as specified in the following table: + +| Value of isf | Meaning | +|---------------|-----------------------------------------------------------| +| ISFPROTECTION | Value is a [FeatProtection](#featprotection) structure. | +| ISFFEC2 | Value is a [FeatFormulaErr2](#featformulaerr2) structure. | +| ISFFACTOID | Value is a [FeatSmartTag](#featsmarttag) structure. | + +### FeatHdr + +The **FeatHdr** record specifies common information for [Shared Features](#Section_86882c8e8d6d46b3aafe006b9e1f18e2) and specifies the beginning of a collection of records as defined by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), [macro sheet](#Section_0dddd943f77a4fc2bf92868acb4587f7) substream ABNF and [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream ABNF. The collection of records specifies Shared Feature data. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
isfreservedcbHdrData
...rgbHdrData (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** MUST be 0x0867. + +**isf (2 bytes):** A [SharedFeatureType](#sharedfeaturetype) enumeration that specifies the type of Shared Feature. MUST be ISFPROTECTION, ISFFEC2 or ISFFACTOID. + +**reserved (1 byte):** Reserved and MUST be 1. + +**cbHdrData (4 bytes):** An unsigned integer that specifies whether **rgbHdrData** exists. MUST be a value from the following table: + +| Value | Meaning | +|------------|--------------------------------| +| 0x00000000 | **rgbHdrData** MUST NOT exist. | +| 0xFFFFFFFF | **rgbHdrData** MUST exist. | + +**rgbHdrData (variable):** A variable type field containing data whose type and meaning is dictated by the value of the **isf** field of this record and the value of the **dt** field of the [BOF](#bof) record preceding this record, as specified in the following table: + + +++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Value of isfContaining substreamMeaning of rgbHdrData
ISFPROTECTIONGlobalsAn EnhancedProtection structure that specifies common protection rule settings.
ISFFEC2GlobalsrgbHdrData MUST NOT exist.
ISFFACTOIDGlobalsA PropertyBagStore as defined in [MS-OSHARED] section 2.3.4.1 that specifies smart tag header data.
Worksheet or Macro SheetrgbHdrData MUST NOT exist.
+ +### FeatHdr11 + +The **FeatHdr11** record specifies common information for all [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and specifies the beginning of a collection as specified by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies table information, [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) information and data used for sorting a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
isfreserved1reserved2
...reserved3
...idListNext
...reserved4
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader). The **frtHeader.rt** field MUST be 0x0871. + +**isf (2 bytes):** A [SharedFeatureType](#sharedfeaturetype) enumeration that specifies the type of [Shared Feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2). MUST be ISFLIST. + +**reserved1 (1 byte):** Reserved and MUST be 1. + +**reserved2 (4 bytes):** MUST be 0xFFFFFFFF and MUST be ignored. + +**reserved3 (4 bytes):** MUST be 0xFFFFFFFF and MUST be ignored. + +**idListNext (4 bytes):** An unsigned integer that specifies the next identifier to try when assigning a unique identifier to a new table. + +**reserved4 (2 bytes):** MUST be zero, and MUST be ignored. + +### Feature11 + +The **Feature11** record specifies specific [shared feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2) data. The only shared feature type stored in this record is a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) in a [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56). + +**feature (variable):** A [TableFeatureType](#tablefeaturetype) structure. + +If this record is not a [Feature12](#feature12) record, then these rules apply: + +- The **feature.frtRefHeaderU**.**rt** field MUST be 0x0872. + +- **lt** of the embedded TableFeatureType MUST NOT be LTEXTERNALDATA. + +- If **crwHeader** of the embedded TableFeatureType is zero then and **fSingleCell** of the embedded TableFeatureType MUST be zero. + +- **fLoadTotalFmla** and **fLoadTotalStr** of all embedded [Feat11FieldDataItem](#feat11fielddataitem) MUST be zero. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtRefHeaderU
...
...
isfreserved1reserved2
...cref2
...cbFeatData
...reserved3refs2 (variable)
...
rgbFeat (variable)
...
+ +**frtRefHeaderU (12 bytes):** An [FrtRefHeaderU](#frtrefheaderu). The **frtRefHeaderU.rt** field MUST be 0x0872. The **frtRefHeaderU.ref8** MUST refer to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells associated with this record. + +**isf (2 bytes):** A [SharedFeatureType](#sharedfeaturetype) enumeration that specifies the type of Shared Feature data stored in the **rgbFeat** field. MUST be ISFLIST. + +**reserved1 (1 byte):** Reserved and MUST be zero. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +**cref2 (2 bytes):** An unsigned integer that specifies the count of [Ref8U](#ref8u) records within the **refs2** field. + +**cbFeatData (4 bytes):** An unsigned integer that specifies the size in bytes of the **rgbFeat** variable-size field. If the value is 0x0000, the size of the **rgbFeat** field is calculated by the following formula: + +size of **rgbFeat** = total size of record in bytes – size of **refs2** in bytes – 27 bytes + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**refs2 (variable):** An array of Ref8U structures that specifies references to ranges of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the worksheet associated with the feature. The count of records within this field is specified by the **cref2** field. + +**rgbFeat (variable):** A variable-size structure that contains feature specific data. The size of the structure is specified by the **cbFeatData** field. This field MUST contain a TableFeatureType structure. + +### Feature12 + +The **Feature12** record specifies [shared feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2) data that is used to describe a table in a [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56). This record is used to encapsulate a table that has properties not supported by the [Feature11](#feature11) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
feature (variable)
...
+ +**feature (variable):** A Feature11 record with additional properties enabled. The **feature.frtRefHeaderU**.**rt** field MUST be 0x0878. + +On or more of these additional properties MUST be present in a Feature12 record: + +- **lt** of the embedded [TableFeatureType](#tablefeaturetype) structure is LTEXTERNALDATA. + +- **crwHeader** and **fSingleCell** of the embedded TableFeatureType structure are zero. + +- An embedded [Feat11FieldDataItem](#feat11fielddataitem) structure has **fLoadTotalFmla** or **fLoadTotalStr** equal to 1. + +### FileLock + +The **FileLock** record specifies that the [**shared workbook**](#gt_241c4cae-c49a-438a-87dc-c8fb2c871921) was [**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81) by a particular user. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
lPurpose
stUsrName (variable)
...
unused (variable)
...
+ +**lPurpose (4 bytes):** An unsigned integer that specifies the purpose of the file lock. MUST be one of the following: + +| Value | Meaning | +|----|----| +| 0x00000000 | The shared workbook is not locked. | +| 0x00010001 | The shared workbook is locked for writing or releasing user information. | +| 0x00010002 | The shared workbook is locked for merging two revisions. | +| 0x00010004 | The shared workbook is locked to make it exclusive. | +| 0x00010008 | The shared workbook is locked to be deleted or renamed. | + +**stUsrName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the [**user name**](#gt_c298446e-09d2-470d-a70f-5249dafa15c6). The string length MUST be less than or equal to 52. + +**unused (variable):** Undefined and MUST be ignored. This size of this field in bytes is specified by the following formula: + +size = 158 - (byte count of **stUsrName**) + +### FilePass + +The **FilePass** record specifies the encryption algorithm used to encrypt the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and the structure that is used to verify the password provided when attempting to open the workbook. If this record exists, the workbook MUST be encrypted. Refer to the [Encryption (Password to Open)](#Section_0f2ea0a19fc8468d97aa9d333b72d106) overview to understand the details of workbook files that have been encrypted. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
wEncryptionTypeencryptionInfo (variable)
...
+ +**wEncryptionType (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies the encryption type. MUST be a value from the following table:[\<86\>](#Appendix_A_86) + +| Value of wEncryptionType | Meaning | +|----|----| +| 0x0000 | [**XOR obfuscation**](#gt_cbfd1a35-e8c9-4c5a-bc26-e618633d2f50) | +| 0x0001 | RC4 encryption. For more details about RC4 encryption, see \[SCHNEIER\] section 17.1 | + +**encryptionInfo (variable):** A variable type field. The type and meaning of this field is dictated by the value of **wEncryptionType.** If **wEncryptionType** is equal to 0x0000, this field is an [XORObfuscation](#xorobfuscation) structure. If **wEncryptionType** is equal to 0x0001, this field is an RC4 encryption header structure as specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083), 2.3.5.1 or \[MS-OFFCRYPTO\], 2.3.6.1 depending on the value of the first two bytes. The first two bytes of the RC4 encryption header structure MUST be a value from the following table: + + ++++ + + + + + + + + + + + + + + + + +
Value of the first two bytes of encryptionInfoType of encryptionInfo
0x0001RC4 encryption header structure
+[MS-OFFCRYPTO], 2.3.6.1
0x0002, 0x0003, or 0x0004RC4 CryptoAPI encryption header structure
+[MS-OFFCRYPTO], 2.3.5.1
+ +### FileSharing + +The **FileSharing** record specifies file sharing options. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
fReadOnlyRecwResPass
iNoResPass (optional)stUNUsername (variable)
...
+ +**fReadOnlyRec (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the [**read-only recommended**](#gt_720d1791-fa2b-4ee8-a1ef-11139a085dc2) option is selected for this file. If the value is 1, the read-only recommended is selected for this file. + +**wResPass (2 bytes):** An unsigned integer that specifies the password verifier for [**write reservation**](#gt_7bfb4760-386d-41b0-8c74-6faa53221628). If the value is 0, there is no write reservation password. The algorithm is specified in [Password Verifier Algorithm](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4). + +**iNoResPass (2 bytes):** An unsigned integer that specifies that there is no write reservation password. This field exists if and only if **wResPass** is 0. The value MUST be 0. + +**stUNUsername (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the [**user name**](#gt_c298446e-09d2-470d-a70f-5249dafa15c6) that added the write reservation password. This field exists if and only if **wResPass** is not 0. The value of **stUNUsername.cch** MUST be less than or equal to 54. + +### FilterMode + +The **FilterMode** record specifies that the containing [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) data was filtered. If this record exists one or more [AutoFilter](#autofilter) or [AutoFilter12](#autofilter12) records MUST exist within the containing sheet. + +### FnGroupName + +The **FnGroupName** record specifies a user-defined [**function category**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) in the current [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgch (variable)
...
+ +**rgch (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the function category name. MUST be less than or equal to 32 characters in length. The value of this field MUST NOT equal any of the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) names specified by FnGroupName and [FnGrp12](#fngrp12). + +### FnGrp12 + +The **FnGrp12** record specifies the name of a user-defined [**function category**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) in the current [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The user-defined function categories include the function categories defined in both [FnGroupName](#fngroupname) records and FnGrp12 records. The sum of the built-in function categories as specified by [BuiltInFnGroupCount](#builtinfngroupcount) and the user defined function categories in the current workbook MUST be less than or equal to 256. This record specifies the name of a function category after the 32nd function category. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
astFnGrp (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0898. + +**astFnGrp (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the name of the function category. The length of this string MUST be less than or equal to 32 characters. The value of this field MUST NOT equal any of the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) names specified by FnGrp12 and FnGroupName. + +### Font + +The **Font** record specifies a [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) and font formatting information. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
dyHeightABCDEFGHreserved
icvbls
sssulsbFamily
bCharSetunused3fontName (variable)
...
+ +**dyHeight (2 bytes):** An unsigned integer that specifies the height of the font in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382). SHOULD[\<87\>](#Appendix_A_87) be greater than or equal to 20 and less than or equal to 8191. MUST be greater than or equal to 20 and less than or equal to 8191, or 0. + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - fItalic (1 bit):** A bit that specifies whether the font is italic. + +**C - unused2 (1 bit):** Undefined and MUST be ignored. MUST be 1 when **uls** is greater than 0x00. + +**D - fStrikeOut (1 bit):** A bit that specifies whether the font has [**strikethrough formatting**](#gt_b16d9600-aebb-4a4f-bf14-c38e13c11c14) applied. + +**E - fOutline (1 bit):** A bit that specifies whether the font has an [**outline effect**](#gt_4e818802-fdc1-4227-b32f-1a3cb0943de7) applied. + +**F - fShadow (1 bit):** A bit that specifies whether the font has a [**shadow effect**](#gt_83056968-00f2-463b-abc6-607dbb242cbf) applied. + +**G - fCondense (1 bit):** A bit that specifies whether the font is condensed. + +**H - fExtend (1 bit):** A bit that specifies whether the font is extended. + +**reserved (8 bits):** MUST be zero, and MUST be ignored. + +**icv (2 bytes):** An unsigned integer that specifies the color of the font. The value SHOULD[\<88\>](#Appendix_A_88) be an [IcvFont](#icvfont) value. The value MUST be an IcvFont value, or 0. + +**bls (2 bytes):** An unsigned integer that specifies the font weight. The value SHOULD[\<89\>](#Appendix_A_89) be a value from the following table. This value MUST be 0, or greater than or equal to 100 and less than or equal to 1000. + +| Value | Meaning | +|-------|--------------------| +| 400 | Normal font weight | +| 700 | Bold font weight | + +**sss (2 bytes):** An unsigned integer that specifies whether superscript, subscript, or normal script is used. The value MUST be one of the following: + +| Value | Meaning | +|--------|---------------| +| 0x0000 | Normal script | +| 0x0001 | Superscript | +| 0x0002 | Subscript | + +**uls (1 byte):** An unsigned integer that specifies the underline [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633). The value MUST be one of the following: + +| Value | Meaning | +|-------|-------------------------------------------------------------------| +| 0x00 | No underline | +| 0x01 | Single underline | +| 0x02 | Double underline | +| 0x21 | [**Single accounting**](#gt_7ad49c0f-e183-47b5-bdbd-c23a5a8315fc) | +| 0x22 | [**Double accounting**](#gt_89f4f531-9a8b-419c-8f51-98ef409b7bdf) | + +**bFamily (1 byte):** An unsigned integer that specifies the [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2) this font belongs to. MUST be a value from the following table:[\<90\>](#Appendix_A_90) + +| Value | Meaning | +|-------|----------------| +| 0x00 | Not applicable | +| 0x01 | Roman | +| 0x02 | Swiss | +| 0x03 | Modern | +| 0x04 | Script | +| 0x05 | Decorative | + +For more information about font family, see the Windows API LOGFONT structure in [\[MSDN-FONTS\]](https://go.microsoft.com/fwlink/?LinkId=90008). + +**bCharSet (1 byte):** An unsigned integer that specifies the [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204). MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------| +| 0x00 | ANSI_CHARSET | +| 0x01 | DEFAULT_CHARSET | +| 0x02 | SYMBOL_CHARSET | +| 0x4D | MAC_CHARSET | +| 0x80 | SHIFTJIS_CHARSET | +| 0x81 | HANGEUL_CHARSET | +| 0x81 | HANGUL_CHARSET | +| 0x82 | JOHAB_CHARSET | +| 0x86 | GB2312_CHARSET | +| 0x88 | CHINESEBIG5_CHARSET | +| 0xA1 | GREEK_CHARSET | +| 0xA2 | TURKISH_CHARSET | +| 0xA3 | VIETNAMESE_CHARSET | +| 0xB1 | HEBREW_CHARSET | +| 0xB2 | ARABIC_CHARSET | +| 0xBA | BALTIC_CHARSET | +| 0xCC | RUSSIAN_CHARSET | +| 0xDD | THAI_CHARSET | +| 0xEE | EASTEUROPE_CHARSET | +| 0xFF | OEM_CHARSET | + +For more information about character set, see the Windows API LOGFONT structure in \[MSDN-FONTS\]. + +**unused3 (1 byte):** Undefined and MUST be ignored. + +**fontName (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) structure that specifies the name of this font. String length MUST be greater than or equal to 1 and less than or equal to 31. The **fontName.fHighByte** field MUST equal 1. MUST NOT contain any null characters. + +### FontX + +The **FontX** record specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) for a given text element. The [Font](#font) record referenced by **iFont** can exist in this [chart sheet](#Section_732ff614d939416bb7c76d983471ff11) substream or the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
iFont
+ +**iFont (2 bytes):** An unsigned integer that specifies the font to use for subsequent records. This font can either be the default font of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), part of the collection of Font records following the [FrtFontList](#frtfontlist) record, or part of the collection of Font records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). If **iFont** is 0x0000, this record specifies the default font of the chart. If **iFont** is less than or equal to the number of Font records in the Globals Substream, **iFont** is a one-based index to a Font record in the Globals Substream. Otherwise **iFont** is a one-based index into the collection of Font records in this chart sheet substream where the index is equal to **iFont** – n, where n is the number of Font records in the Globals Substream. + +### Footer + +The **Footer** record specifies the footer text of the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) when printed. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ast (variable)
...
+ +**ast (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the footer text for the current sheet. It is optional and exists only if the record size is not zero. The footer text appears at the bottom of every page when printed. The length of the text MUST be less than or equal to 255. The footer text can contain special commands, for example a placeholder for the page number, current date or text formatting attributes, as specified in the [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) grammar for special commands as specified in [Header](#header). + +### ForceFullCalculation + +The **ForceFullCalculation** record specifies the value of the forced [**calculation mode**](#gt_f02f81e1-8eda-4ec3-88e9-c2c483ff47ee) for this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
fNoDeps
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader). The **frtHeader.rt** field MUST be 0x08A3. + +**fNoDeps (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether all cells in the workbook are calculated or not. MUST be one of the following: + +| Value | Meaning | +|----|----| +| 0 | Dependencies are respected and only formulas (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that depend on cells that changed in the workbook are calculated. | +| 1 | Dependencies are ignored and all [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) formulas in this workbook fully calculate every time a calculation is triggered. | + +### Format + +The **Format** record specifies a [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ifmtstFormat (variable)
...
+ +**ifmt (2 bytes):** An [IFmt](#ifmt) structure that specifies the identifier of the [**format string**](#gt_07085e26-506a-4b35-81ad-972464e277ff) specified by **stFormat**. The value of **ifmt.ifmt** SHOULD[\<91\>](#Appendix_A_91) be a value within one of the following ranges. The value of **ifmt.ifmt** MUST be a value within one of the following ranges or within 383 to 392. + +- 5 to 8 + +- 23 to 26 + +- 41 to 44 + +- 63 to 66 + +- 164 to 382 + +**stFormat (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the format string for this number format. The format string indicates how to format the numeric value of the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). The length of this field MUST be greater than or equal to 1 character and less than or equal to 255 characters. For more information about how format strings are interpreted, see [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1: Fundamentals And Markup Language Reference, section 18.8.31. + +For a string to be considered a valid format string, it MUST be well-formed according to the following [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) specification. + +**ABNF Grammar for number** format strings + +These definitions are for en-US [**locale**](#gt_7b78ebef-e35d-45ab-abfd-4121b60995de). International consideration as specified in \[ECMA-376\] Part 1: Fundamentals And Markup Language Reference, section 18.8.31 MUST be accounted for and the ABNF MUST be modified accordingly for specific international number formats. + +The following rules are not expressed in the ABNF grammar, but apply to the grammar: + +1. In the following ABNF specification, the following tokens in the first table that follows can occur 0 or more times anywhere in the grammar, as long as they do not break apart the elements in the second table that follows: + +| Token | +|---------------------| +| LITERAL-STRING | +| LITERAL-CHAR-REPEAT | +| LITERAL-CHAR-SPACE | + +| Elements | +|-------------------| +| INTL\* | +| LITERAL\* | +| NFDateTimeToken | +| NFPartExponential | +| NFPartCond | +| NFPartLocaleID | +| NFPartColor | +| NFPartIntNum | +| NFPartStrColor | + +| Elements | +|-------------------| +| INTL\* | +| LITERAL\* | +| NFDateTimeToken | +| NFPartExponential | +| NFPartCond | +| NFPartLocaleID | +| NFPartColor | +| NFPartIntNum | +| NFPartStrColor | + +2. The following token MUST occur 0 or 1 times in each section as defined in \[ECMA-376\] Part 1: Fundamentals And Markup Language Reference, section 18.8.31. + +NFPartLocaleID + +NFAbsTimeToken MUST occur 0 or 1 times in NFDateTime. + +An absolute time token, such as NFPartAbsHour, MUST NOT coexist with a non-absolute equivalent token, such as NFPartHour, in NFDateTime. + +Following is the ABNF grammar for number format strings. + +All = (\[NFPartColor\] NFPartCond NFGeneral) / NFAnyNoCond / (NFAnyNoText ASCII-SEMICOLON NFAny) / (NFAnyNoText ASCII-SEMICOLON NFAnyNoText ASCII-SEMICOLON NFAnyNoCond) / (NFAnyNoText ASCII-SEMICOLON NFAnyNoText ASCII-SEMICOLON NFAnyNoTextNoCond ASCII-SEMICOLON \[NFText / NFGeneral\]) + +NFAny = \[NFPartColor\] ((\[NFPartCond\] NFNumber) / NFText / (\[NFPartCond\] NFFraction) / (\[NFPartCond\] \[NFDateTime\] \[NFGeneral\] \[NFDateTime\])) + +NFAnyNoText = \[NFPartColor\] \[NFPartCond\] (NFNumber / NFFraction / (\[NFDateTime\] \[NFGeneral\] \[NFDateTime\])) + +NFAnyNoCond = \[NFPartColor\] (NFNumber / NFText / NFFraction / (\[NFDateTime\] \[NFGeneral\] \[NFDateTime\])) + +NFAnyNoTextNoCond = \[NFPartColor\] (NFNumber / NFFraction / (\[NFDateTime\] \[NFGeneral\] \[NFDateTime\])) + +NFGeneral = INTL-NUMFMT-GENERAL + +NFNumber = NFPartNum \[NFPartExponential NFPartNum\] \*INTL-CHAR-NUMGRP-SEP \*INTL-AMPM + +NFDateTimeToken = NFPartYear / NFPartMonth / NFPartDay / NFPartHour / NFPartMinute / NFPartSecond / NFAbsTimeToken + +NFAbsTimeToken = NFPartAbsHour / NFPartAbsSecond / NFPartAbsMinute + +NFDateTime = \*INTL-AMPM (1\*(NFDateTimeToken) \*(NFDateTimeToken / NFPartSubSecond / INTL-CHAR-DATE-SEP / INTL-CHAR-TIME-SEP / INTL-AMPM)) + +NFText = (1\*ASCII-COMMERCIAL-AT \*(ASCII-COMMERCIAL-AT / INTL-AMPM)) / (\*(ASCII-COMMERCIAL-AT / INTL-AMPM) 1\*ASCII-COMMERCIAL-AT) + +NFFraction = NFPartFraction ASCII-SOLIDUS NFPartFraction \[NFPartNum\] \*INTL-AMPM + +NFPartNum = 1\*NFPartNumToken2 \*(NFPartNumToken2 / ASCII-PERCENT-SIGN)) / (\*(NFPartNumToken2 / ASCII-PERCENT-SIGN) 1\*NFPartNumToken2) + +NFPartExponential = ASCII-CAPITAL-LETTER-E NFPartSign + +NFPartYear = 2(ASCII-SMALL-LETTER-Y) / 4(ASCII-SMALL-LETTER-Y) + +NFPartMonth = 1\*5(ASCII-SMALL-LETTER-M) + +NFPartDay = 1\*4(ASCII-SMALL-LETTER-D) + +NFPartHour = 1\*2(ASCII-SMALL-LETTER-H) + +NFPartAbsHour = ASCII-LEFT-SQUARE-BRACKET 1\*ASCII-SMALL-LETTER-H ASCII-RIGHT-SQUARE-BRACKET + +NFPartMinute = 1\*2(ASCII-SMALL-LETTER-M) + +NFPartAbsMinute = ASCII-LEFT-SQUARE-BRACKET 1\*ASCII-SMALL-LETTER-M ASCII-RIGHT-SQUARE-BRACKET + +NFPartSecond = 1\*2(ASCII-SMALL-LETTER-S) + +NFPartAbsSecond = ASCII-LEFT-SQUARE-BRACKET 1\*ASCII-SMALL-LETTER-S ASCII-RIGHT-SQUARE-BRACKET + +NFPartSubSecond = INTL-CHAR-DECIMAL-SEP 1\*3ASCII-DIGIT-ZERO + +NFPartCond = ASCII-LEFT-SQUARE-BRACKET NFPartCompOper NFPartCondNum ASCII-RIGHT-SQUARE-BRACKET + +NFPartCompOper = (ASCII-LESS-THAN-SIGN \[ASCII-EQUALS-SIGN / ASCII-GREATER-THAN-SIGN\]) / ASCII-EQUALS-SIGN / (ASCII-GREATER-THAN-SIGN \[ASCII-EQUALS-SIGN\]) + +NFPartLocaleID = ASCII-LEFT-SQUARE-BRACKET ASCII-DOLLAR-SIGN 1\*UTF16-ANY \[ASCII-HYPHEN-MINUS 3\*8ASCII-DIGIT-HEXADECIMAL\] ASCII-RIGHT-SQUARE-BRACKET + +NFPartCondNum = \[ASCII-HYPHEN-MINUS\] NFPartIntNum \[INTL-CHAR-DECIMAL-SEP NFPartIntNum\] \[NFPartExponential NFPartIntNum\] + +NFPartSign = ASCII-PLUS-SIGN / ASCII-HYPHEN-MINUS + +NFPartColor = ASCII-LEFT-SQUARE-BRACKET INTL-COLOR / (NFPartStrColor NFPart1To56) ASCII-RIGHT-SQUARE-BRACKET + +NFPart1To56 = NFPartNumber1To9 / NFPartNumber1To4 ASCII-DIGIT / ASCII-DIGIT-FIVE (ASCII-DIGIT-ZERO / NFPartNumber1To6) + +NFPartIntNum = 1\*ASCII-DIGIT + +NFPartNumToken1 = ASCII-NUMBER-SIGN / ASCII-QUESTION-MARK / ASCII-DIGIT-ZERO + +NFPartNumToken2 = NFPartNumToken1 / INTL-CHAR-DECIMAL-SEP / INTL-CHAR-NUMGRP-SEP + +NFPartFraction = (1\*NFPartIntNum \*(NFPartIntNum / ASCII-PERCENT-SIGN)) / (\*(NFPartIntNum / ASCII-PERCENT-SIGN) 1\*NFPartIntNum) / (1\*NFPartNumToken1 \*(NFPartNumToken1 / ASCII-PERCENT-SIGN)) / (\*(NFPartNumToken1 / ASCII-PERCENT-SIGN) 1\*NFPartNumToken1) + +NFPartNumber1To4 = ASCII-DIGIT-ONE / ASCII-DIGIT-TWO / ASCII-DIGIT-THREE / ASCII-DIGIT-FOUR + +NFPartNumber1To6 = NFPartNumber1To4 / ASCII-DIGIT-FIVE / ASCII-DIGIT-SIX + +NFPartNumber1To9 = NFPartNumber1To6 / ASCII-DIGIT-SEVEN / ASCII-DIGIT-EIGHT / ASCII-DIGIT-NINE + +NFPartStrColor = ASCII-CAPITAL-LETTER-C ASCII-SMALL-LETTER-O ASCII-SMALL-LETTER-L ASCII-SMALL-LETTER-O ASCII-SMALL-LETTER-R + +LITERAL-CHAR = ASCII-REVERSE-SOLIDUS UTF16-ANY + +LITERAL-CHAR-REPEAT = ASCII-ASTERISK UTF16-ANY + +LITERAL-STRING = (ASCII-QUOTATION-MARK 1\*UTF16-ANY-WITHOUT-QUOTE ASCII-QUOTATION-MARK) / 1\*LITERAL-CHAR + +UTF16-ANY-WITHOUT-QUOTE = %x0000-0021 / %x0023-FFFF + +LITERAL-CHAR-SPACE = ASCII-LOW-LINE UTF16-ANY + +INTL-CHAR-DECIMAL-SEP = ASCII-FULL-STOP + +INTL-CHAR-NUMGRP-SEP = ASCII-COMMA + +INTL-CHAR-DATE-SEP = ASCII-SOLIDUS + +INTL-CHAR-TIME-SEP = ASCII-COLON + +INTL-COLOR = (ASCII-CAPITAL-LETTER-B ASCII-SMALL-LETTER-L ASCII-SMALL-LETTER-A ASCII-SMALL-LETTER-C ASCII-SMALL-LETTER-K) / (ASCII-CAPITAL-LETTER-B ASCII-SMALL-LETTER-L ASCII-SMALL-LETTER-U ASCII-SMALL-LETTER-E) / (ASCII-CAPITAL-LETTER-C ASCII-SMALL-LETTER-Y ASCII-SMALL-LETTER-A ASCII-SMALL-LETTER-N) / (ASCII-CAPITAL-LETTER-G ASCII-SMALL-LETTER-R ASCII-SMALL-LETTER-E ASCII-SMALL-LETTER-E ASCII-SMALL-LETTER-N) / (ASCII-CAPITAL-LETTER-M ASCII-SMALL-LETTER-A ASCII-SMALL-LETTER-G ASCII-SMALL-LETTER-E ASCII-SMALL-LETTER-N ASCII-SMALL-LETTER-T ASCII-SMALL-LETTER-A) / (ASCII-CAPITAL-LETTER-R ASCII-SMALL-LETTER-E ASCII-SMALL-LETTER-D ) / (ASCII-CAPITAL-LETTER-W ASCII-SMALL-LETTER-H ASCII-SMALL-LETTER-I ASCII-SMALL-LETTER-T ASCII-SMALL-LETTER-E) / (ASCII-CAPITAL-LETTER-Y ASCII-SMALL-LETTER-E ASCII-SMALL-LETTER-L ASCII-SMALL-LETTER-L ASCII-SMALL-LETTER-O ASCII-SMALL-LETTER-W) + +INTL-NUMFMT-GENERAL = ASCII-CAPITAL-LETTER-G ASCII-SMALL-LETTER-E ASCII-SMALL-LETTER-N ASCII-SMALL-LETTER-E ASCII-SMALL-LETTER-R ASCII-SMALL-LETTER-A ASCII-SMALL-LETTER-L + +INTL-AMPM = (ASCII-CAPITAL-LETTER-A ASCII-CAPITAL-LETTER-M ASCII-SOLIDUS ASCII-CAPITAL-LETTER-P ASCII-CAPITAL-LETTER-M) / "A/P" + +UTF16-ANY = %x0000-FFFF + +ASCII-SPACE = %x20 + +ASCII-EXCLAMATION-MARK = %x21 + +ASCII-QUOTATION-MARK = %x22 + +ASCII-NUMBER-SIGN = %x23 + +ASCII-DOLLAR-SIGN = %x24 + +ASCII-PERCENT-SIGN = %x25 + +ASCII-AMPERSAND = %x26 + +ASCII-APOSTROPHE = %x27 + +ASCII-LEFT-PARENTHESIS = %x28 + +ASCII-RIGHT-PARENTHESIS = %x29 + +ASCII-ASTERISK = %x2A + +ASCII-PLUS-SIGN = %x2B + +ASCII-COMMA = %x2C + +ASCII-HYPHEN-MINUS = %x2D + +ASCII-FULL-STOP = %x2E + +ASCII-SOLIDUS = %x2F + +ASCII-DIGIT-ZERO = %x30 + +ASCII-DIGIT-ONE = %x31 + +ASCII-DIGIT-TWO = %x32 + +ASCII-DIGIT-THREE = %x33 + +ASCII-DIGIT-FOUR = %x34 + +ASCII-DIGIT-FIVE = %x35 + +ASCII-DIGIT-SIX = %x36 + +ASCII-DIGIT-SEVEN = %x37 + +ASCII-DIGIT-EIGHT = %x38 + +ASCII-DIGIT-NINE = %x39 + +ASCII-COLON = %x3A + +ASCII-SEMICOLON = %x3B + +ASCII-LESS-THAN-SIGN = %x3C + +ASCII-EQUALS-SIGN = %x3D + +ASCII-GREATER-THAN-SIGN = %x3E + +ASCII-QUESTION-MARK = %x3F + +ASCII-COMMERCIAL-AT = %x40 + +ASCII-CAPITAL-LETTER-A = %x41 + +ASCII-CAPITAL-LETTER-B = %x42 + +ASCII-CAPITAL-LETTER-C = %x43 + +ASCII-CAPITAL-LETTER-D = %x44 + +ASCII-CAPITAL-LETTER-E = %x45 + +ASCII-CAPITAL-LETTER-F = %x46 + +ASCII-CAPITAL-LETTER-G = %x47 + +ASCII-CAPITAL-LETTER-H = %x48 + +ASCII-CAPITAL-LETTER-I = %x49 + +ASCII-CAPITAL-LETTER-J = %x4A + +ASCII-CAPITAL-LETTER-K = %x4B + +ASCII-CAPITAL-LETTER-L = %x4C + +ASCII-CAPITAL-LETTER-M = %x4D + +ASCII-CAPITAL-LETTER-N = %x4E + +ASCII-CAPITAL-LETTER-O = %x4F + +ASCII-CAPITAL-LETTER-P = %x50 + +ASCII-CAPITAL-LETTER-Q = %x51 + +ASCII-CAPITAL-LETTER-R = %x52 + +ASCII-CAPITAL-LETTER-S = %x53 + +ASCII-CAPITAL-LETTER-T = %x54 + +ASCII-CAPITAL-LETTER-U = %x55 + +ASCII-CAPITAL-LETTER-V = %x56 + +ASCII-CAPITAL-LETTER-W = %x57 + +ASCII-CAPITAL-LETTER-X = %x58 + +ASCII-CAPITAL-LETTER-Y = %x59 + +ASCII-CAPITAL-LETTER-Z = %x5A + +ASCII-LEFT-SQUARE-BRACKET = %x5B + +ASCII-REVERSE-SOLIDUS = %x5C + +ASCII-RIGHT-SQUARE-BRACKET = %x5D + +ASCII-CIRCUMFLEX-ACCENT = %x5E + +ASCII-LOW-LINE = %x5F + +ASCII-GRAVE-ACCENT = %x60 + +ASCII-SMALL-LETTER-A = %x61 + +ASCII-SMALL-LETTER-B = %x62 + +ASCII-SMALL-LETTER-C = %x63 + +ASCII-SMALL-LETTER-D = %x64 + +ASCII-SMALL-LETTER-E = %x65 + +ASCII-SMALL-LETTER-F = %x66 + +ASCII-SMALL-LETTER-G = %x67 + +ASCII-SMALL-LETTER-H = %x68 + +ASCII-SMALL-LETTER-I = %x69 + +ASCII-SMALL-LETTER-J = %x6A + +ASCII-SMALL-LETTER-K = %x6B + +ASCII-SMALL-LETTER-L = %x6C + +ASCII-SMALL-LETTER-M = %x6D + +ASCII-SMALL-LETTER-N = %x6E + +ASCII-SMALL-LETTER-O = %x6F + +ASCII-SMALL-LETTER-P = %x70 + +ASCII-SMALL-LETTER-Q = %x71 + +ASCII-SMALL-LETTER-R = %x72 + +ASCII-SMALL-LETTER-S = %x73 + +ASCII-SMALL-LETTER-T = %x74 + +ASCII-SMALL-LETTER-U = %x75 + +ASCII-SMALL-LETTER-V = %x76 + +ASCII-SMALL-LETTER-W = %x77 + +ASCII-SMALL-LETTER-X = %x78 + +ASCII-SMALL-LETTER-Y = %x79 + +ASCII-SMALL-LETTER-Z = %x7A + +ASCII-LEFT-CURLY-BRACKET = %x7B + +ASCII-VERTICAL-LINE = %x7C + +ASCII-RIGHT-CURLY-BRACKET = %x7D + +ASCII-TILDE = %x7E + +ASCII-DELETE = %x7F + +ASCII-CRLF = %x0d.0a + +ASCII-DIGIT = ASCII-DIGIT-ZERO / ASCII-DIGIT-ONE / ASCII-DIGIT-TWO / ASCII-DIGIT-THREE / ASCII-DIGIT-FOUR / ASCII-DIGIT-FIVE / ASCII-DIGIT-SIX / ASCII-DIGIT-SEVEN / ASCII-DIGIT-EIGHT / ASCII-DIGIT-NINE + +ASCII-DIGIT-HEXADECIMAL = ASCII-DIGIT / ASCII-SMALL-LETTER-A / ASCII-SMALL-LETTER-B / ASCII-SMALL-LETTER-C / ASCII-SMALL-LETTER-D / ASCII-SMALL-LETTER-E / ASCII-SMALL-LETTER-F / ASCII-CAPITAL-LETTER-A / ASCII-CAPITAL-LETTER-B / ASCII-CAPITAL-LETTER-C / ASCII-CAPITAL-LETTER-D / ASCII-CAPITAL-LETTER-E / ASCII-CAPITAL-LETTER-F + +### Formula + +The **Formula** record specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cell
...val
...
...ABCDEFreserved3
chn
formula (variable)
...
+ +**cell (6 bytes):** A [Cell](#cell) structure that specifies a cell on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**val (8 bytes):** A [FormulaValue](#formulavalue) structure that specifies the value of the formula. + +**A - fAlwaysCalc (1 bit):** A bit that specifies whether the formula needs to be calculated during the next recalculation. + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fFill (1 bit):** A bit that specifies whether the cell has a [**fill alignment**](#gt_cfc4e171-6104-470e-9ebb-812afea17078) or a [**center-across-selection alignment**](#gt_ef7324bd-dac8-46e2-8df5-db44d8b925a8). + +| Value | Meaning | +|----|----| +| 0 | Cell does not have a fill alignment or a center-across-selection alignment. | +| 1 | Cell has either a fill alignment or a center-across-selection alignment. | + +**D - fShrFmla (1 bit):** A bit that specifies whether the formula is part of a shared formula as defined in [ShrFmla](#shrfmla). If this formula is part of a shared formula, **formula**.**rgce** MUST begin with a [PtgExp](#ptgexp) structure. + +**E - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**F - fClearErrors (1 bit):** A bit that specifies whether the formula is excluded from [**formula error checking**](#gt_c28d38d6-c6d1-4d06-89c2-29816f9c5b23). + +**reserved3 (10 bits):** MUST be zero, and MUST be ignored. + +**chn (4 bytes):** A field that specifies an application-specific cache of information. This cache exists for performance reasons only, and can be rebuilt based on information stored elsewhere in the file without affecting calculation results. + +**formula (variable):** A [CellParsedFormula](#cellparsedformula) structure that specifies the formula. + +### Frame + +The **Frame** record specifies the type, size and position of the frame around a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) element as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). A chart element’s frame is specified by the Frame record following it. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtABreserved
+ +**frt (2 bytes):** An unsigned integer that specifies the type of frame to be drawn. MUST be a value from the following table: + +| Value | Frame Type | +|--------|------------------------------------------------------| +| 0x0000 | A frame surrounding the chart element. | +| 0x0004 | A frame with a shadow surrounding the chart element. | + +**A - fAutoSize (1 bit):** A bit that specifies if the size of the frame is automatically calculated. If the value is 1, the size of the frame is automatically calculated. In this case, the width and height specified by the chart element are ignored and the size of the frame is calculated automatically. If the value is 0, the width and height specified by the chart element are used as the size of the frame. + +**B - fAutoPosition (1 bit):** A bit that specifies if the position of the frame is automatically calculated. If the value is 1, the position of the frame is automatically calculated. In this case, the (x, y) specified by the chart element are ignored, and the position of the frame is automatically calculated. If the value is 0, the (x, y) location specified by the chart element are used as the position of the frame. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +### FrtFontList + +The **FrtFontList** record specifies [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information used on the chart and specifies the beginning of a collection of [Font](#font) records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
verExcelreservedcFont
rgFontInfo (variable)
...
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x085A. + +**verExcel (1 byte):** An unsigned integer that specifies the application version where new [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) elements were introduced that use the font information specified by **rgFontInfo**. MUST be a value from the following table and MUST be equal to iObjectInstance1 of the [StartObject](#startobject) record that immediately follows this record as defined by the Chart Sheet Substream ABNF: + +| Value | Meaning | +|----|----| +| 0x09 | This record pertains to new objects introduced in an application version[\<92\>](#Appendix_A_92). **rgFontInfo** specifies the font information that is used by [**display units**](#gt_7d807b62-cff1-4e03-a73f-840844345b83) labels specified by [YMult](#ymult). | +| 0x0A | This record pertains to new objects introduced in an application version[\<93\>](#Appendix_A_93). **rgFontInfo** specifies the font information that is used by extended [data label](#Section_cac7f43a3af142f58ff2814c2870427f) specified by [DataLabExt](#datalabext). | + +**reserved (1 byte):** MUST be zero, and MUST be ignored. + +**cFont (2 bytes):** An unsigned integer that specifies the number of items in **rgFontInfo**. + +**rgFontInfo (variable):** An array of [FontInfo](#fontinfo) structures that specify the font information. The number of elements in this array MUST be equal to the value specified in **cFont**. + +### FrtWrapper + +The **FrtWrapper** record wraps around a non-Future Record Type ([FRT](#Section_b660b67822684414839ed1ae9a4e4e85)) record and converts it into an FRT record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
wrappedRecord (variable)
...
frtWrapperPadding (variable)
...
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** MUST be 0x0851. + +**wrappedRecord (variable):** A [Font](#font), [Continue](#continue), [LineFormat](#lineformat), [AreaFormat](#areaformat), [SeriesText](#seriestext), [DefaultText](#defaulttext), [Text](#text), [FontX](#fontx), [ObjectLink](#objectlink), [Frame](#frame), [Begin](#begin), [End](#end), [PicF](#picf), [Pos](#pos), [AlRuns](#alruns), [BRAI](#brai), [Fbi](#fbi), or [GelFrame](#gelframe) that specifies the record being wrapped. These records MUST be wrapped in this FrtWrapper if they are part of a collection defined by [StartObject](#startobject) and [EndObject](#endobject). These records appear according to their record name and not as FrtWrapper in the [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) specified in [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11). + +**frtWrapperPadding (variable):** An array of bytes that is used to pad **FrtWrapper**. Each element MUST be zero and MUST be ignored. This field MUST be present if and only if the size of the **wrappedRecord** is less than 8 bytes. If present, the size of **frtWrapperPadding** MUST be specified by the following formula: + +8 bytes – (size of **wrappedRecord**) + +The size of the padded **FrtWrapper** MUST be no less than the size of the [FrtHeader](#frtheader) structure (12 bytes). + +### GelFrame + +The **GelFrame** record specifies the properties of a [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e) for parts of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). The record consists of an OfficeArtFOPT, as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.2.9, and an OfficeArtTertiaryFOPT, as specified in \[MS-ODRAW\] section 2.2.11, that both contain properties for the fill pattern applied.[\<94\>](#Appendix_A_94) + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
OPT1 (variable)
...
OPT2 (variable)
...
+ +**OPT1 (variable):** An OfficeArtFOPT, as specified in \[MS-ODRAW\] section 2.2.9, specifies the primary properties of the fill pattern. MUST only contain the subset of OfficeArtFOPT properties specified in the following list: + +- fillType, as specified in \[MS-ODRAW\] section 2.3.7.1 + +- fillColor, as specified in \[MS-ODRAW\] section 2.3.7.2 + +- fillOpacity, as specified in \[MS-ODRAW\] section 2.3.7.3 + +- fillBackColor, as specified in \[MS-ODRAW\] section 2.3.7.4 + +- fillBackOpacity, as specified in \[MS-ODRAW\] section 2.3.7.5 + +- fillCrMod, as specified in \[MS-ODRAW\] section 2.3.7.6 + +- fillBlip_complex, as specified in \[MS-ODRAW\] section 2.3.7.8 + +- fillBlipName_complex, as specified in \[MS-ODRAW\] section 2.3.7.10 + +- fillBlipFlags, as specified in \[MS-ODRAW\] section 2.3.7.11 + +- fillWidth, as specified in \[MS-ODRAW\] section 2.3.7.12 + +- fillHeight, as specified in \[MS-ODRAW\] section 2.3.7.13 + +- fillAngle, as specified in \[MS-ODRAW\] section 2.3.7.14 + +- fillFocus, as specified in \[MS-ODRAW\] section 2.3.7.15 + +- fillToLeft, as specified in \[MS-ODRAW\] section 2.3.7.16 + +- fillToTop, as specified in \[MS-ODRAW\] section 2.3.7.17 + +- fillToRight, as specified in \[MS-ODRAW\] section 2.3.7.18 + +- fillToBottom, as specified in \[MS-ODRAW\] section 2.3.7.19 + +- fillRectLeft, as specified in \[MS-ODRAW\] section 2.3.7.20 + +- fillRectTop, as specified in \[MS-ODRAW\] section 2.3.7.21 + +- fillRectRight, as specified in \[MS-ODRAW\] section 2.3.7.22 + +- fillRectBottom, as specified in \[MS-ODRAW\] section 2.3.7.23 + +- fillDztype, as specified in \[MS-ODRAW\] section 2.3.7.24 + +- fillShadePreset, as specified in \[MS-ODRAW\] section 2.3.7.25 + +- fillShadeColors_complex, as specified in \[MS-ODRAW\] section 2.3.7.27 + +- fillOriginX, as specified in \[MS-ODRAW\] section 2.3.7.28 + +- fillOriginY, as specified in \[MS-ODRAW\] section 2.3.7.29 + +- fillShapeOriginX, as specified in \[MS-ODRAW\] section 2.3.7.30 + +- fillShapeOriginY, as specified in \[MS-ODRAW\] section 2.3.7.31 + +- fillShadeType, as specified in \[MS-ODRAW\] section 2.3.7.32 + +- fFilled, as specified in \[MS-ODRAW\] section 2.3.7.43 + +- fHitTestFill, as specified in \[MS-ODRAW\] section 2.3.7.43 + +- fillShape, as specified in \[MS-ODRAW\] section 2.3.7.43 + +- fillUseRect, as specified in \[MS-ODRAW\] section 2.3.7.43 + +- fNoFillHitTest, as specified in \[MS-ODRAW\] section 2.3.7.43 + +**OPT2 (variable):** An OfficeArtTertiaryFOPT, as specified in \[MS-ODRAW\] section 2.2.11 specifies the additional properties of the fill pattern. MUST only contain the subset of OfficeArtTertiaryFOPT properties specified in the following list[\<95\>](#Appendix_A_95): + +- fillColorExt, as specified in \[MS-ODRAW\] section 2.3.7.33 + +- fillColorExtMod, as specified in \[MS-ODRAW\] section 2.3.7.35 + +- fillBackColorExt, as specified in \[MS-ODRAW\] section 2.3.7.37 + +- fillBackColorExtMod, as specified in \[MS-ODRAW\] section 2.3.7.39 + +- fRecolorFillAsPicture, as specified in \[MS-ODRAW\] section 2.3.7.43 + +- fUseShapeAnchor, as specified in \[MS-ODRAW\] section 2.3.7.43 + +### GridSet + +The **GridSet** record specifies a reserved value. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
gridset
+ +**gridset (2 bytes):** Reserved, and MUST be 1. + +### GUIDTypeLib + +The **GUIDTypeLib** record specifies the [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that uniquely identifies the [**type library**](#gt_c7033bd7-d429-4131-8bc4-f5007b7ef3fa) of the application that wrote the [**Visual Basic for Applications (VBA)**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) project in the file. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
guid (16 bytes)
...
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0897. + +**guid (16 bytes):** A GUID as specified by \[MS-DTYP\] that uniquely identifies the type library of the application that wrote the VBA project. The value SHOULD[\<96\>](#Appendix_A_96) be 0x0. + +### Guts + +The **Guts** record specifies the maximum [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) levels for row and column [**gutters**](#gt_d38255f8-dca6-4e1c-be9d-71691a6ab4e5). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
unused1unused2
iLevelRwMaciLevelColMac
+ +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**iLevelRwMac (2 bytes):** An unsigned integer that specifies the maximum [**outline level**](#gt_a5cd5eff-ddeb-490b-bc71-f6256774e3c3) for the row gutter. The value MUST be one of the values specified in the following table. + +**iLevelColMac (2 bytes):** An unsigned integer that specifies the maximum outline level for the column gutter. The value MUST be one of the values specified in the following table. + +| Value | Maximum outline level | +|--------|-----------------------| +| 0x0000 | 0 | +| 0x0002 | 1 | +| 0x0003 | 2 | +| 0x0004 | 3 | +| 0x0005 | 4 | +| 0x0006 | 5 | +| 0x0007 | 6 | +| 0x0008 | 7 | + +### HCenter + +The **HCenter** record specifies whether the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) is to be centered horizontally when printed. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
hcenter
+ +**hcenter (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the sheet is to be centered between [LeftMargin](#leftmargin) and [RightMargin](#rightmargin) when printed. + +### Header + +The **Header** record specifies the header text of the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) when printed. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ast (variable)
...
+ +**ast (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the header text for the current sheet. It is optional and exists only if the record size is not zero. The text appears at the top of every page when printed. The length of the text MUST be less than or equal to 255. The header text can contain special commands, for example a [**placeholder**](#gt_25caffec-4e4b-4192-a04d-edcd14f0ec5f) for the page number, current date or text formatting attributes. Special commands are represented by single letter with a leading ampersand ("&"). The following [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) lists the possible commands and how they are used: + +**ABNF Grammar for Header and Footer Strings** + +headerfooter = \*(left / pagenum / pagetotal / fontsize / strikethrough / superscript / subscript / center / date / time / filepath / picture / underline / doubleunderline / right / bookpath / sheetname / fontname / fonttype / font / bold / italic / ampersand / emptytoken / UNICHAR) + +UNICHAR = %x0020-FFFF + +> This code specifies [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters, starting with the space character (%x0020). + +DIGIT = %x0030-0039 + +> This code specifies a digit between 0 and 9. + +HEXALPHA = %x0041-0046 / %x0061-0066 + +> This code specifies a character between A and F or between a and f. + +DQUOTE = %x0022 + +> This code specifies a double quotation mark. + +left = "&L" + +> This code specifies the beginning of the left section. There are three header and footer sections: left, center, and right. When two or more of this section marker exist, the contents from all markers are concatenated, in the order of appearance, and placed into the left section. + +pagenum = "&P" + +> This code specifies the current page number. + +pagetotal = "&N" 0\*1(("-" / "+") \*DIGIT) + +> This code specifies the total number of pages. + +fontsize = "&" 1\*3DIGIT + +> This code specifies the text [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) size, where font size is measured in points. + +strikethrough = "&S" + +> This code specifies whether the strikethrough [**text style**](#gt_7df49f57-34f0-4063-9c66-8e32767d9562) is on or off. The first occurrence of this code MUST turn the strikethrough text style on, and the second occurrence MUST turn it off. + +superscript = "&X" + +> This code specifies whether the superscript text style is on or off. The first occurrence of this code MUST turn the superscript text style on, and the second occurrence MUST turn it off. The superscript and subscript codes MUST NOT both be on at same time. If both codes occur in the string, the code that occurs first is applied and the other is ignored. + +subscript = "&Y" + +> This code specifies whether the subscript text style is on or off. The first occurrence of this code MUST turn the subscript text style on, and the second occurrence MUST turn it off. The superscript and subscript codes MUST NOT both be on at same time. If both codes occur in the string, the code that occurs first is applied and the other is ignored. + +center = "&C" + +> This code specifies the beginning of the center section. When two or more of this section marker exist, the contents from all markers are concatenated, in the order of appearance, and placed into the center section. + +date = "&D" + +> This code specifies a date. + +time = "&T" + +> This code specifies a time. + +picture = "&G" + +> This code specifies a picture. + +underline = "&U" + +> This code specifies whether the single underline text style is on or off. The first occurrence of this code MUST turn the underline text style on, and the second occurrence MUST turn it off. + +doubleunderline = "&E" + +> This code specifies whether the double underline text style is on or off. The first occurrence of this code MUST turn the double underline text style on, and the second occurrence MUST turn it off. + +right = "&R" + +> This code specifies the beginning of the right section. When two or more of this section marker exist, the contents from all markers are concatenated, in the order of appearance, and placed into the right section. + +bookpath = "&Z" + +> This code specifies a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) file path. + +bookname = "&F" + +> This code specifies a workbook file name. + +sheetname = "&A" + +> This code specifies a sheet name. + +fontname = (1\*UNICHAR / "-") + +> This code specifies the text font name. When the font name is a hyphen, no font is specified. This can be a localized string. + +fonttype = ("italic" / "bold" / "regular" / "italic bold" / "bold italic") + +> This code specifies the text font type. This can be a localized string. + +font = "&" DQUOTE fontname , fonttype DQUOTE + +> This code specifies the text font. + +bold = "&B" + +> This code specifies whether the bold text style is on or off. The first occurrence of this code MUST turn the bold text style on, and the second occurrence MUST turn it off. + +italic = "&I" + +> This code specifies whether the italic text style is on or off. The first occurrence of this code MUST turn the italic text style on, and the second occurrence MUST turn it off. + +ampersand = "&&" + +> This code specifies an ampersand character. + +emptytoken = "&" \*1UNICHAR + +> This code specifies an unidentified token. If just "&" appears, or if there is a UNICHAR specified after "&" and it is not one of the UNICHAR characters listed in the preceding rules, then the token is interpreted as empty and nothing is rendered in the header or footer text. + +### HeaderFooter + +The **HeaderFooter** record specifies the even page header and footer text, and the first page header and footer text of the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
guidSView (16 bytes, optional)
...
...
ABCDunusedcchHeaderEven
cchFooterEvencchHeaderFirst
cchFooterFirststrHeaderEven (variable)
...
strFooterEven (variable)
...
strHeaderFirst (variable)
...
strFooterFirst (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x089C. + +**guidSView (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that specifies the current [**sheet view**](#gt_353fb2f1-8556-4d04-8fa8-f38da52d7ecc). If it is zero it means the current sheet. Otherwise, this field MUST match the **guid** field of the preceding [UserSViewBegin](#usersviewbegin) record. + +**A - fHFDiffOddEven (1 bit):** A bit that specifies whether the odd and even pages use a different header and footer. If the value is 1, the [Header](#header) and [Footer](#footer) records specify the odd page header and footer, and **strHeaderEven** and **strFooterEven** specify the even page header and footer. + +**B - fHFDiffFirst (1 bit):** A bit that specifies whether the first page uses a different header and footer from the rest of the pages. If the value is 1, the Header and Footer records specify the header and footer of the rest of the pages, and **strHeaderFirst** and **strFooterFirst** specify the first page header and footer. + +**C - fHFScaleWithDoc (1 bit):** A bit that specifies whether the header and footer is scaled with the sheet. + +**D - fHFAlignMargins (1 bit):** A bit that specifies whether the left and right edges of the header and footer are lined up with the left and right margins of the sheet. + +**unused (12 bits):** Undefined, and MUST be ignored. + +**cchHeaderEven (2 bytes):** An unsigned integer that specifies the number of characters in **strHeaderEven**. MUST be less than or equal to 255. The value MUST be zero if **fHFDiffOddEven** is zero. + +**cchFooterEven (2 bytes):** An unsigned integer that specifies the number of characters in **strFooterEven**. MUST be less than or equal to 255. The value MUST be zero if **fHFDiffOddEven** is zero. + +**cchHeaderFirst (2 bytes):** An unsigned integer that specifies the number of characters in **strHeaderFirst**. MUST be less than or equal to 255. The value MUST be zero if **fHFDiffFirst** is zero. + +**cchFooterFirst (2 bytes):** An unsigned integer that specifies the number of characters in **strFooterFirst**. MUST be less than or equal to 255. The value MUST be zero if **fHFDiffFirst** is zero. + +**strHeaderEven (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the header text on the even pages. The number of characters in the string MUST be equal to **cchHeaderEven**. The string can contain special commands, for example a [**placeholder**](#gt_25caffec-4e4b-4192-a04d-edcd14f0ec5f) for the page number, current date or text formatting attributes. Refer to Header for more details about the string format. + +**strFooterEven (variable):** An XLUnicodeString structure that specifies the footer text on the even pages. The number of characters in the string MUST be equal to **cchFooterEven**. The string can contain special commands, for example a placeholder for the page number, current date or text formatting attributes. Refer to Header for more details about the string format. + +**strHeaderFirst (variable):** An XLUnicodeString structure that specifies the header text on the first page. The number of characters in the string MUST be equal to **cchHeaderFirst**. The string can contain special commands, for example a placeholder for the page number, current date or text formatting attributes. Refer to Header for more details about the string format. + +**strFooterFirst (variable):** An XLUnicodeString structure that specifies the footer text on the first page. The number of characters in the string MUST be equal to **cchFooterFirst**. The string can contain special commands, for example a placeholder for the page number, current date or text formatting attributes. Refer to Header for more details about the string format. + +### HFPicture + +The **HFPicture** record specifies a picture used by a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) header or footer. The picture MUST be specified in either an **OfficeArtDgContainer** or **OfficeArtDggContainer** record as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872). The picture can be continued across multiple HFPicture records. The **OfficeArtClientAnchor** structure mentioned in \[MS-ODRAW\] refers to [OfficeArtClientAnchorHF](#officeartclientanchorhf). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
ABCunusedreservedrgDrawing (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0866. + +**A - fIsDrawing (1 bit):** A bit that specifies whether **rgDrawing** is an **OfficeArtDgContainer** record as specified in \[MS-ODRAW\]. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | **rgDrawing** is an **OfficeArtDggContainer** record as specified in \[MS-ODRAW\] and **fIsDrawingGroup** MUST be 1. | +| 1 | **rgDrawing** is an **OfficeArtDgContainer** record as specified in \[MS-ODRAW\] and **fIsDrawingGroup** MUST be 0. | + +**B - fIsDrawingGroup (1 bit):** A bit that specifies whether **rgDrawing** is an **OfficeArtDggContainer** record as specified in \[MS-ODRAW\]. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | **rgDrawing** is an **OfficeArtDgContainer** record as specified in \[MS-ODRAW\] and **fIsDrawing** MUST be 1. | +| 1 | **rgDrawing** is an **OfficeArtDggContainer** record as specified in \[MS-ODRAW\] and **fIsDrawing** MUST be 0. | + +**C - fContinue (1 bit):** A bit that specifies whether this record is continuing the previous HFPicture record. The value 0 means it is the first HFPicture record. + +**unused (5 bits):** Undefined and MUST be ignored. + +**reserved (1 byte):** MUST be zero, and MUST be ignored. + +**rgDrawing (variable):** The meaning of this field is specified in the following table. + +| Value of fIsDrawing | Meaning of rgDrawing | +|----|----| +| 0 | This is an **OfficeArtDggContainer** as specified in \[MS-ODRAW\] that specifies the [**drawing group**](#gt_329c715f-dc26-4866-a759-0d622aa92e92) of this picture. | +| 1 | This is an **OfficeArtDgContainer** as specified in \[MS-ODRAW\] that specifies the [**drawing object**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) of this picture | + +### HideObj + +The **HideObj** record specifies how [**ActiveX objects**](#gt_0d95e494-61b2-43bc-8818-51aa162d2018), [**OLE objects**](#gt_cdff9514-a3fb-4897-941d-4e99193a0096), and [**drawing objects**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) appear in a window that contains the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
hideObj
+ +**hideObj (2 bytes):** A [**HideObjEnum**](#hideobjenum) enumeration that specifies how ActiveX objects, OLE objects, and drawing objects appear in a window that contains the workbook. + +### HLink + +The **HLink** record specifies a [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) associated with a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ref8
...
hlinkClsid (16 bytes)
...
...
hyperlink (variable)
...
+ +**ref8 (8 bytes):** A [Ref8U](#ref8u) structure that specifies the range of cells containing the hyperlink. + +**hlinkClsid (16 bytes):** A [**class identifier (CLSID)**](#gt_e433c806-6cb6-46a2-bb95-523df8818c99) that specifies the [**COM**](#gt_ef2ebebc-1760-407a-9ace-af48f9050e02) component which saved the Hyperlink Object (as defined by [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.7.1) in **hyperlink**. + +**hyperlink (variable):** A Hyperlink Object (as defined by \[MS-OSHARED\] section 2.3.7.1) that specifies the hyperlink and hyperlink-related information. + +### HLinkTooltip + +The **HLinkTooltip** record specifies the [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) [**ToolTip**](#gt_84d44447-feaf-41a4-bf12-004c0f080fc2) associated with a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtRefHeaderNoGrbit
...
...wzTooltip (variable)
...
+ +**frtRefHeaderNoGrbit (10 bytes):** An [FrtRefHeaderNoGrbit](#frtrefheadernogrbit) structure. The **frtRefHeaderNoGrbit.rt** field MUST be 0x0800. The **frtRefHeaderNoGrbit.ref8** field MUST match a [Ref8U](#ref8u) field from an existing [HLink](#hlink) record. + +**wzTooltip (variable):** An array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters that specifies the ToolTip string. String length MUST be greater than or equal to 2 and less than or equal to 256 (inclusive of null terminator) and the string MUST be null-terminated. + +### HorizontalPageBreaks + +The **HorizontalPageBreaks** record specifies a list of explicit row [**page breaks**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cbrkrgbrk (variable)
...
+ +**cbrk (2 bytes):** An unsigned integer that specifies the number of page breaks. The value MUST be less than or equal to 1026. + +**rgbrk (variable):** An array of [**HorzBrk**](#horzbrk) structure that specifies all of the page breaks. The array MUST be sorted first by **rgbrk.row**, and then by **rgbrk.ColStart.** Two page breaks MUST NOT overlap. The number of **HorzBrk** structures MUST equal the value of **cbrk**. + +### IFmtRecord + +The **IFmtRecord** record specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) to use for the text on an [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ifmt
+ +**ifmt (2 bytes):** An [IFmt](#ifmt) structure that specifies the number format identifier. + +### Index + +The **Index** record specifies row information and the file locations for all [DBCell](#dbcell) records corresponding to each row block in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). This record, combined with the DBCell records, is used to optimize the [lookup of cells](#Section_24bbaffdab88489e983f3c400c8a8559) in a [cell table](#Section_d690007dd25c4822a650b24c13288bb7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reserved
rwMic
rwMac
ibXF
rgibRw (variable)
...
+ +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +**rwMic (4 bytes):** A [RwLongU](#rwlongu) structure that specifies the first row that has at least one [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) with data in current sheet. MUST be 0 if there are no rows that have at least one cell with data. + +**rwMac (4 bytes):** An unsigned integer that specifies one plus the zero-based index of the last row that has at least one cell with data in the sheet. MUST be 0 if there are no rows that have at least one cell with data. If not 0, MUST be greater than **rwMic**. + +**ibXF (4 bytes):** A FilePointer as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.5 that specifies the file position of the [DefColWidth](#defcolwidth) record in the current sheet. + +**rgibRw (variable):** An array of FilePointer. Each FilePointer as specified in \[MS-OSHARED\] section 2.2.1.5 specifies the file position of each referenced DBCell record. If the positions of DBCell records are not correct, there is no optimized method to do cell lookup and this can cause performance issues. The number of elements in the array MUST be equal to the number of row blocks in this sheet. + +### InterfaceEnd + +The **InterfaceEnd** record specifies the end of a collection of records as defined by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies information about the user interface. + +### InterfaceHdr + +The **InterfaceHdr** record specifies the [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38) of the user interface and specifies the beginning of a collection of records as defined by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies information about the user interface. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
codePage
+ +**codePage (2 bytes):** An unsigned integer that specifies the code page. + +MUST be 0x04B0, which specifies [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8). + +### Intl + +The **Intl** record specifies that the [**macro sheet**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491) is an [**international macro sheet**](#gt_17a6eea5-8094-4056-84fd-8d97fbf0c865). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
reserved
+ +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +### Label + +The **Label** record specifies a label on the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) for each [series](#Section_527ce4dfc9f84e50a314d4b07519593c). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cell
...st (variable)
...
+ +**cell (6 bytes):** A [Cell](#cell) structure that specifies the row and column of the label and the index of the label’s format. + +**st (variable):** A [XLUnicodeString](#xlunicodestring) structure that contains the text of the label. + +### LabelSst + +The **LabelSst** record specifies a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that contains a string. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cell
...isst
...
+ +**cell (6 bytes):** A [Cell](#cell) structure that specifies the cell containing the string from the shared string table. + +**isst (4 bytes):** An unsigned integer that specifies the zero-based index of an element in the array of [XLUnicodeRichExtendedString](#xlunicoderichextendedstring) structure in the **rgb** field of the [SST](#sst) record in this [Workbook Stream](#Section_f682f4b08c6b444e83f852d156f1e8ba) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that specifies the string contained in the cell. MUST be greater than or equal to zero and less than the number of elements in the **rgb** field of the SST record. + +### Lbl + +The **Lbl** record specifies a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEFfGrpGHIJchKeycch
ccereserved3
itabreserved4reserved5
reserved6reserved7Name (variable)
...
rgce (variable)
...
+ +**A - fHidden (1 bit):** A bit that specifies whether the defined name is not [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) in the list of defined names. + +**B - fFunc (1 bit):** A bit that specifies whether the defined name represents an [**Excel macro (XLM)**](#gt_11e8ff9f-bce2-4d8b-9ba2-11ac468f7c7b). If this bit is 1, **fProc** MUST also be 1. + +**C - fOB (1 bit):** A bit that specifies whether the defined name represents a [**Visual Basic for Applications (VBA)**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) [**macro**](#gt_cd2933d3-08d1-4931-bd5c-7ae0a668fe7c). If this bit is 1, the **fProc** MUST also be 1. + +**D - fProc (1 bit):** A bit that specifies whether the defined name represents a macro. + +**E - fCalcExp (1 bit):** A bit that specifies whether **rgce** contains a call to a function that can return an array. + +**F - fBuiltin (1 bit):** A bit that specifies whether the defined name represents a [**built-in name**](#gt_d40a51df-e96f-45ec-885d-6f936d172b39). + +**fGrp (6 bits):** An unsigned integer that specifies the [**function category**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) for the defined name. MUST be less than or equal to 31. The values 17 to 31 are user-defined. User-defined values are specified in the [FnGroupName](#fngroupname) record. The values 0 to 16 are defined as specified in the following table: + +| Value | Category | +|-------|--------------------------------------------------------------| +| 0 | All | +| 1 | Financial | +| 2 | Date Time | +| 3 | Math Trigonometry | +| 4 | Statistical | +| 5 | Lookup | +| 6 | Database | +| 7 | Text | +| 8 | Logical | +| 9 | Info | +| 10 | Commands | +| 11 | Customize | +| 12 | Macro Control | +| 13 | [**DDE**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) External | +| 14 | User Defined | +| 15 | Engineering | +| 16 | [**Cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7) | + +**G - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**H - fPublished (1 bit):** A bit that specifies whether the defined name is [**published**](#gt_8ffc383a-d4f1-4515-a8b5-874d84ab2d2b). This bit is ignored if the **fPublishedBookItems** field of the [BookExt_Conditional12](#bookext_conditional12) structure is 0. + +**I - fWorkbookParam (1 bit):** A bit that specifies whether the defined name is a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) parameter. + +**J - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**chKey (1 byte):** The unsigned integer value of the [**ASCII**](#gt_79fa85ca-ac61-467c-b819-e97dc1a7a599) character that specifies the shortcut key for the macro represented by the defined name. MUST be 0 (no shortcut key) if **fFunc** is 1 or if **fProc** is 0. Otherwise MUST[\<97\>](#Appendix_A_97) be greater than or equal to 0x41 and less than or equal to 0x5A, or greater than or equal to 0x61 and less than or equal to 0x7A. + +**cch (1 byte):** An unsigned integer that specifies the number of characters in **Name**. MUST be greater than or equal to zero. + +**cce (2 bytes):** An unsigned integer that specifies length of **rgce** in bytes. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**itab (2 bytes):** An unsigned integer that specifies if the defined name is a [**local name**](#gt_6f2787cc-ab35-4cc1-bebd-fb120864d320), and if so, which [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) it is on. If **itab** is not 0, the defined name is a local name and the value MUST be a one-based index to the collection of [BoundSheet8](#boundsheet8) records as they appear in the Globals Substream. + +**reserved4 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved5 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved6 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved7 (1 byte):** MUST be zero, and MUST be ignored. + +**Name (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name for the defined name. If **fBuiltin** is 0, this field MUST satisfy the same restrictions as the **name** field of the [XLNameUnicodeString](#xlnameunicodestring) structure. If **fBuiltin** is 1, this field is for a built-in name. Each built-in name has a zero-based index value associated with it. A built-in name or its index value MUST be used for this field. The built-in names are defined in the following table: + +| Values | Names | +|--------|------------------| +| 0x00 | Consolidate_Area | +| 0x01 | Auto_Open | +| 0x02 | Auto_Close | +| 0x03 | Extract | +| 0x04 | Database | +| 0x05 | Criteria | +| 0x06 | Print_Area | +| 0x07 | Print_Titles | +| 0x08 | Recorder | +| 0x09 | Data_Form | +| 0x0A | Auto_Activate | +| 0x0B | Auto_Deactivate | +| 0x0C | Sheet_Title | +| 0x0D | \_FilterDatabase | + +**rgce (variable):** A [NameParsedFormula](#nameparsedformula) structure that specifies the **formula** for the **defined name**. + +### LeftMargin + +The **LeftMargin** record specifies the left margin of the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
num
...
+ +**num (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the left margin of the current sheet in inches. The value MUST be greater than or equal to 0 and less than or equal to 49. + +### Legend + +The **Legend** record specifies properties of a [legend](#Section_1832229b7d1945f488d455e9c07466f0), and specifies the beginning of a collection of records defined by [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a legend. The absence of this collection of records implies that a legend does not exist on the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
x
y
dx
dy
unusedwSpaceABCDEFreserved2
+ +**x (4 bytes):** An unsigned integer that specifies the x-position, in [SPRC](#Section_d5fc728e68de4972905a975bcef8c82d), of the upper-left corner of the [**bounding rectangle**](#gt_e349a155-0fb9-4ba1-abd4-e363e21abcd1) of the legend. MUST be ignored and the **x1** field from the following [Pos](#pos) record MUST be used instead. + +**y (4 bytes):** An unsigned integer that specifies the y-position, in SPRC, of the upper-left corner of the bounding rectangle of the legend. MUST be ignored and the **y1** field from the following Pos record MUST be used instead. + +**dx (4 bytes):** An unsigned integer that specifies the width, in SPRC, of the bounding rectangle of the legend. MUST be ignored and the **x2** field from the following Pos record MUST be used instead. + +**dy (4 bytes):** An unsigned integer that specifies the height, in SPRC, of the bounding rectangle of the legend. MUST be ignored and the **y2** field from the following Pos record MUST be used instead. + +**unused (1 byte):** Undefined and MUST be ignored. + +**wSpace (1 byte):** An unsigned integer that specifies the space between [**legend entries**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e). MUST be 0x01, which represents 40 [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382) between legend entries. + +**A - fAutoPosition (1 bit):** A bit that specifies whether the legend is automatically positioned. If this field is 0x1, then **fAutoPosX** MUST be 0x1 and **fAutoPosY** MUST be 0x1. + +**B - reserved1 (1 bit):** MUST be 1, and MUST be ignored. + +**C - fAutoPosX (1 bit):** A bit that specifies whether the x-positioning of the legend is automatic. + +**D - fAutoPosY (1 bit):** A bit that specifies whether the y-positioning of the legend is automatic. + +**E - fVert (1 bit):** A bit that specifies the layout of the legend entries. MUST equal 0x1 if **fWasDataTable** is equal to 0x1. MUST be a value from the following table: + +| **Value** | **Meaning** | +|----|----| +| 0x0 | The legend contains multiple columns of legend entries, or the size of the legend was manually changed from the default size. | +| 0x1 | The legend contains a single column of legend entries. | + +**F - fWasDataTable (1 bit):** A bit that specifies whether the legend is shown in a [data table](#Section_69938f61d2e94da3af87e154edcb0d98). + +**reserved2 (10 bits):** MUST be zero, and MUST be ignored. + +### LegendException + +The **LegendException** record specifies information about a [**legend entry**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e) which was changed from the default legend entry settings, and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies legend entry formatting. On a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) where the [legend](#Section_1832229b7d1945f488d455e9c07466f0) contains legend entries for the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) and [trendlines](#Section_61d74ebc36714d6dbdc0626db604530d), as defined in the legend overview, there MUST be zero instances or one instance of this record in the sequence of records that conform to the SERIESFORMAT rule. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
issABreserved
+ +**iss (2 bytes):** An unsigned integer that specifies the legend entry. This field has different interpretations depending on the content of the legend in the chart. The legend overview specifies the types of content the legend can contain, as follows: + +- In a chart where the legend contains legend entries for the series and trendlines, this field MUST be 0xFFFF. This record specifies the legend entry of the series or trendline that contains this record. + +- In a chart where the legend contains legend entries for each [data point](#Section_9c986ad250d44fa1a157063ac5c971a0) in the chart, this field specifies the zero-based index of a legend entry in the legend, where 0x0000 is the legend entry for the first data point in the series. + +- In a chart with a surface [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), this field specifies the zero-based index of a legend entry in the legend, where 0x0000 is the legend entry for the lowest band of the surface chart group. + +**A - fDeleted (1 bit):** A bit that specifies whether the legend entry specified by **iss** was deleted. + +**B - fLabel (1 bit):** A bit that specifies whether the legend entry specified by **iss** was formatted. If this field is 1, there MUST be a sequence of records that conform to the ATTACHEDLABEL rule in the Chart Sheet Substream ABNF following this record. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +### Lel + +The **Lel** record specifies that a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) was lost because of the deletion of a supporting label[\<98\>](#Appendix_A_98). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
stFormulaName (variable)
...
+ +**stFormulaName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the name of the deleted label. The number of characters MUST be less than 252. + +### Line + +The **Line** record specifies that the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is a line chart group, and specifies the chart group attributes. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ABCreserved
+ +**A - fStacked (1 bit):** A bit that specifies whether the [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) in the chart group that share the same [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) are stacked. + +**B - f100 (1 bit):** A bit that specifies whether the data points in the chart group are displayed as a percentage of the sum of all data points in the chart group that share the same category. MUST be 0 if **fStacked** is 0. + +**C - fHasShadow (1 bit):** A bit that specifies whether one or more [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) in the chart group has shadows. + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +### LineFormat + +The **LineFormat** record specifies the appearance of a line. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgb
lnswe
ABCDreserved2icv
+ +**rgb (4 bytes):** A [LongRGB](#longrgb) structure that specifies the color of the line. The color MUST match the color specified by **icv**. + +**lns (2 bytes):** An unsigned integer that specifies the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) of the line. MUST be a value from the following table: + +| Value | Meaning | +|--------|---------------------| +| 0x0000 | Solid | +| 0x0001 | Dash | +| 0x0002 | Dot | +| 0x0003 | Dash-dot | +| 0x0004 | Dash dot-dot | +| 0x0005 | None | +| 0x0006 | Dark gray pattern | +| 0x0007 | Medium gray pattern | +| 0x0008 | Light gray pattern | + +When the value of this field is 0x0005 (None), the values of **we** and **icv** MUST be set to the values specified in the following table: + +| Attribute | Default Value | +|-------------------------|-------------------| +| Line thickness (**we**) | 0xFFFF (Hairline) | +| Line color (**icv**) | 0x004D | + +**we (2 bytes):** A signed integer that specifies the thickness of the line. MUST be a value from the following table: + +| Value | Meaning | +|-------------|-----------------| +| 0xFFFF (-1) | Hairline | +| 0x0000 | Narrow (single) | +| 0x0001 | Medium (double) | +| 0x0002 | Wide (triple) | + +**A - fAuto (1 bit):** A bit that specifies whether the line has default formatting. + +If the value of **fAuto** is 0, the line has formatting as specified by **lns**, **we**, and **icv**. + +If the value of **fAuto** is 1, **lns**, **we**, **icv**, and **rgb** MUST be ignored and default values are used as specified in the following table: + +| Attribute | Default Value | +|-------------------------|------------------------------------------| +| Line pattern (**lns**) | 0xFFFF (Hairline) | +| Line thickness (**we**) | 0x0000 (Narrow) | +| Line color (**icv**) | 0x004D | +| Line color (**rgb**) | Match the default color used for **icv** | + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fAxisOn (1 bit):** A bit that specifies whether the [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) line is displayed. + +If the previous record is [AxisLine](#axisline) and the value of the **id** field of the AxisLine record is equal to 0x0000, this field MUST be a value from the following table: + +| fAxisOn | Lns | Meaning | +|---------|-------------------------------|---------------------------------| +| 0 | 0x0005 | The axis line is not displayed. | +| 0 | Any legal value except 0x0005 | The axis line is displayed. | +| 1 | Any legal value | The axis line is displayed. | + +If the previous record is not AxisLine and the value of the **id** field of the AxisLine record is equal to 0x0000, this field MUST be zero, and MUST be ignored. + +**D - fAutoCo (1 bit):** A bit that specifies whether **icv** is equal to 0x004D. If the value is 1, **icv** MUST equal 0x004D. If the value is 0, **icv** MUST NOT equal 0x004D. + +**reserved2 (12 bits):** MUST be zero, and MUST be ignored. + +**icv (2 bytes):** An [IcvChart](#icvchart) structure that specifies the color of the line. The color MUST match the color specified by **rgb**. + +### List12 + +The **List12** record specifies the additional formatting information for a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). These records immediately follow a [Feature11](#feature11) or [Feature12](#feature12) record, and specify additional formatting information for the table specified by the Feature11 or Feature12 record. This record is a [future record type](#Section_b660b67822684414839ed1ae9a4e4e85) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
lsdidList
...rgb (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0877. + +**lsd (2 bytes):** An unsigned integer that specifies the type of data contained in the **rgb** field. + +MUST be a value specified in the table listed under **rgb**. + +**idList (4 bytes):** An unsigned integer that identifies the associated table for which this record specifies additional formatting. MUST NOT be zero. MUST be equal to the **idList** field of the [TableFeatureType](#tablefeaturetype) structure embedded in the associated Feature11 or Feature12 record. + +**rgb (variable):** A structure whose type and meaning are specified by the value of **lsd**, as specified in the following table: + +| Value of lsd | Meaning of rgb | +|----|----| +| 0x0000 | **rgb** is a [List12BlockLevel](#list12blocklevel) structure that specifies the [table block-level formatting](#Section_0c7947ddc8874a69a5cbc14494d21034). | +| 0x0001 | **rgb** is a [List12TableStyleClientInfo](#list12tablestyleclientinfo) structure that specifies the [table style](#Section_4ac7212b4aa74ece962526c58224ae80). | +| 0x0002 | **rgb** is a [List12DisplayName](#list12displayname) structure that specifies the display name. | + +### LPr + +The **LPr** record specifies a record that is unused. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCreservedunused4
unused5unused6
unused7unused8
unused9 (variable)
...
+ +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - unused2 (1 bit):** Undefined and MUST be ignored. + +**C - unused3 (1 bit):** Undefined and MUST be ignored. + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +**unused4 (2 bytes):** Undefined and MUST be ignored. + +**unused5 (2 bytes):** Undefined and MUST be ignored. + +**unused6 (2 bytes):** Undefined and MUST be ignored. + +**unused7 (2 bytes):** Undefined and MUST be ignored. + +**unused8 (2 bytes):** Undefined and MUST be ignored. + +**unused9 (variable):** Undefined and MUST be ignored. + +### LRng + +The **LRng** record specifies a label [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) for [**natural language formulas**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b)[\<99\>](#Appendix_A_99). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
crefRwrefRow (variable)
...
crefColrefCol (variable)
...
+ +**crefRw (2 bytes):** An unsigned integer that specifies the number of row label ranges. When added to the value of **crefCol**, the value MUST be less than 1028. + +**refRow (variable):** An array of [Ref8U](#ref8u) structures. The array specifies the row label ranges. The size of the array is specified by **crefRw**. + +**crefCol (2 bytes):** An unsigned integer that specifies the number of column label ranges. When added to the value of **crefRw**, the value MUST be less than 1028. + +**refCol (variable):** An array of Ref8U structures. The array specifies the column label ranges. The size of the array is specified by **crefCol**. + +### MarkerFormat + +The **MarkerFormat** record specifies the color, size, and shape of the associated [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) that appear on line, radar, and scatter [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5). The associated data markers are specified by the preceding [DataFormat](#dataformat) record. If this record is not present in the sequence of records that conforms to the [SS](#chart-sheet-substream) rule of the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), then the color, size, and shape of the associated data markers are specified by the default values of the fields of this record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgbFore
rgbBack
imkABCDreserved2
icvForeicvBack
miSize
+ +**rgbFore (4 bytes):** A [LongRGB](#longrgb) structure that specifies the [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) color of the data marker. The color MUST match the color specified by **icvFore**. The default value of this field is automatically selected from the next available color in the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) color table. + +**rgbBack (4 bytes):** A LongRGB structure that specifies the interior color of the data marker. The color MUST match the color specified by **icvBack**. The default value of this field is the same as the default value for **rgbFore** only when the default **imk** is 0x0001, 0x0002, 0x0003, or 0x0008. Otherwise, the default value is 0xFFFFFF. + +**imk (2 bytes):** An unsigned integer that specifies the type of data marker. The default value for this field is automatically selected from the list of data marker types and cannot be 0x0000. MUST be a value from the following table: + +| Value | Meaning | +|--------|----------------------------------| +| 0x0000 | No marker. | +| 0x0001 | Square markers. | +| 0x0002 | Diamond-shaped markers. | +| 0x0003 | Triangular markers. | +| 0x0004 | Square markers with an X. | +| 0x0005 | Square markers with an asterisk. | +| 0x0006 | Short bar markers. | +| 0x0007 | Long bar markers. | +| 0x0008 | Circular markers. | +| 0x0009 | Square markers with a plus sign. | + +**A - fAuto (1 bit):** A bit that specifies whether the data marker is automatically generated. The default value for this field is 1. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The data marker is not automatically generated. | +| 0x1 | The data marker type, size, and color are automatically generated and the values are set accordingly in this record. | + +**B - reserved1 (3 bits):** MUST be zero, and MUST be ignored. + +**C - fNotShowInt (1 bit):** A bit that specifies whether to show the data marker interior. The default value for this field is 0. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------| +| 0x0 | The data marker interior is shown. | +| 0x1 | The data marker interior is not shown. | + +**D - fNotShowBrd (1 bit):** A bit that specifies whether to show the data marker border. The default value for this field is 0. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------| +| 0x0 | The data marker border is shown. | +| 0x1 | The data marker border is not shown. | + +**reserved2 (10 bits):** MUST be zero, and MUST be ignored. + +**icvFore (2 bytes):** An [IcvChart](#icvchart) structure that specifies the border color of the data marker. The color MUST match the color specified by **rgbFore**. The default value of this field is automatically set to match the color specified by **rgbFore**. + +**icvBack (2 bytes):** An IcvChart structure that specifies the interior color of the data marker. The color MUST match the color specified by **rgbBack**. The default value of this field is automatically set to match the color specified by **rgbBack**. + +**miSize (4 bytes):** An unsigned integer that specifies the size in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382) of the data marker. MUST be greater than or equal to 40 and less than or equal to 1440. The default value for this field is 100. + +### MDB + +The **MDB** record specifies a unique set of [MDX metadata](#Section_0f7583182c0b4155bf75c7399f89305c) type/value pairs that are shared among all [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) that reference [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) metadata. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
rgmdir (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x88A. + +**rgmdir (variable):** An array of [MDir](#mdir) structures that specifies a block of [metadata](#Section_c2df6678f9ab4f71a17b1dfa8b9ac76a) records. + +### MDTInfo + +The **MDTInfo** record specifies the information about a single type of [metadata](#Section_c2df6678f9ab4f71a17b1dfa8b9ac76a). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
ABCDEFGHIJKLMNOPQRSTUVWunused1XYZa
stName (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0884. + +**A - fGhostRow (1 bit):** A bit that specifies whether the metadata is applied to all [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in newly inserted rows. + +**B - fGhostCol (1 bit):** A bit that specifies whether the metadata is applied to all cells in newly inserted columns. + +**C - fEdit (1 bit):** A bit that specifies whether the metadata is preserved when the cell is edited. + +**D - fDelete (1 bit):** A bit that specifies whether the metadata is preserved when the cell's value is deleted. + +**E - fCopy (1 bit):** A bit that specifies whether the metadata is copied when the cell is copied. MUST be 1 if one or more of the values of **fPasteAll**, **fPasteFormulas**, **fPasteValues**, **fPasteFormats**, **fPasteComments**, **fPasteDataValidation**, **fPasteBorders**, **fPasteColWidths**, or **fPasteNumberFormats** is 1. + +**F - fPasteAll (1 bit):** A bit that specifies whether the metadata is pasted when all formulas, values, formatting, comments, and [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) rules are pasted from the previously copied cell. + +**G - fPasteFormulas (1 bit):** A bit that specifies whether the metadata is pasted when only formulas are pasted from the previously copied cell. + +**H - fPasteValues (1 bit):** A bit that specifies whether the metadata is pasted when only values are pasted from the previously copied cell. + +**I - fPasteFormats (1 bit):** A bit that specifies whether the metadata is pasted when only formatting is pasted from the previously copied cell. + +**J - fPasteComments (1 bit):** A bit that specifies whether the metadata is pasted when only comments are pasted from the previously copied cell. + +**K - fPasteDataValidation (1 bit):** A bit that specifies whether the metadata is pasted when only data validation rules are pasted from the previously copied cell. + +**L - fPasteBorders (1 bit):** A bit that specifies whether the metadata is pasted when only borders are pasted from the previously copied cell. + +**M - fPasteColWidths (1 bit):** A bit that specifies whether the metadata is pasted when only column widths are pasted from the previously copied cell. + +**N - fPasteNumberFormats (1 bit):** A bit that specifies whether the metadata is pasted when only number formatting is pasted from the previously copied cell. + +**O - fMerge (1 bit):** A bit that specifies whether the metadata is preserved after cells are merged. If the value of this bit is 1, and the cell has the smallest row and column number of the cells that are being merged, the metadata is preserved. + +**P - fSplitFirst (1 bit):** A bit that specifies whether, when a cell is split, the metadata is copied to the cell with the smallest row and column number. If **fSplitAll** is set to 1, **fSplitAll** takes precedence. + +**Q - fSplitAll (1 bit):** A bit that specifies whether, when a cell is split, the metadata is copied to all the resulting cells. If the value is 1, the value of **fSplitFirst** MUST be ignored. + +**R - fRowColShift (1 bit):** A bit that specifies whether the metadata is preserved when the cell is shifted because of row or column deletion or insertion. + +**S - fClearAll (1 bit):** A bit that specifies whether the metadata is preserved when the contents, formatting, and comments of the cell are cleared. + +**T - fClearFormats (1 bit):** A bit that specifies whether the metadata is preserved when the formatting of the cell is cleared. + +**U - fClearContents (1 bit):** A bit that specifies whether the metadata is preserved when the contents of the cell is cleared. + +**V - fClearComments (1 bit):** A bit that specifies whether the metadata is preserved when the comments of the cell are cleared. + +**W - fAssign (1 bit):** A bit that specifies whether the metadata is preserved when the cell's value is changed by formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) assignment. + +**unused1 (5 bits):** Undefined and MUST be ignored. + +**X - fCoerce (1 bit):** A bit that specifies whether the metadata is preserved when the cell's value is coerced to a different type. + +**Y - fAdjust (1 bit):** A bit that specifies whether the metadata is updated when the cell's location is changed. + +**Z - fCellMeta (1 bit):** A bit that specifies whether this metadata type is [cell metadata](#Section_c925f5199fe14b6ab01807fa18351e68) or [value metadata](#Section_e78bf5ba22754bad8e6cf4f59644efa6). MUST be 0 from the following table: + +| Value | Meaning | +|-------|-----------------------------| +| 0 | Metadata is value metadata. | +| 1 | Metadata is cell metadata. | + +**a - unused2 (1 bit):** Undefined and MUST be ignored. + +**stName (variable):** An [LPWideString](#lpwidestring) type that specifies the name of the metadata type. + +### MDXKPI + +The **MDXKPI** record specifies [MDX KPI metadata](#Section_db8664f2502b43d2aa88274035b52570). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
istrConnName
tfnSrckpipropistrKPIName
...istrMbrKPI
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x889. + +**istrConnName (4 bytes):** An [MDXStrIndex](#mdxstrindex) structure that specifies the index of the connection name string. + +**tfnSrc (1 byte):** A [Tag_Fn_MDX](#tag_fn_mdx) enumeration that specifies the type of [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) that generated the metadata. The value MUST be **TFNCUBEKPIPROPERTY**. + +**kpiprop (1 byte):** A [KPIProp](#kpiprop) enumeration that specifies the KPI type. + +**istrKPIName (4 bytes):** An MDXStrIndex structure that specifies the index of the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) string. + +**istrMbrKPI (4 bytes):** An MDXStrIndex structure that specifies the index of the key performance indicator name string. + +### MDXProp + +The **MDXProp** record specifies [member property MDX metadata](#Section_722f7e05ca3e4a20b30fbbed1a597e88). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
istrConnName
tfnSrcistrMbr
...istrProp
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x888. + +**istrConnName (4 bytes):** An [MDXStrIndex](#mdxstrindex) structure that specifies the index of the connection name string. + +**tfnSrc (1 byte):** A [Tag_Fn_MDX](#tag_fn_mdx) enumeration that specifies the type of [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) that generated the metadata. The value MUST be **TFNCUBEMEMBERPROPERTY**. + +**istrMbr (4 bytes):** An MDXStrIndex structure that specifies the index of the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) string. + +**istrProp (4 bytes):** An MDXStrIndex structure that specifies the index of the property name string. + +### MDXSet + +The **MDXSet** record specifies [MDX set metadata](#Section_84d4d0b542b6405ea07be3272dc517f8). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
istrConnName
tfnSrcssoistrSetDef
...cistr
...rgistr (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x887. + +**istrConnName (4 bytes):** An [MDXStrIndex](#mdxstrindex) structure that specifies the index of the connection name string. + +**tfnSrc (1 byte):** A [Tag_Fn_MDX](#tag_fn_mdx) enumeration that specifies the type of [**cube function**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3) that generated the metadata. The value MUST be equal to **TFNCUBESET** or **TFNCUBESETCOUNT**. + +**sso (1 byte):** An [SD_SetSortOrder](#sd_setsortorder) enumeration that specifies the set [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7). + +**istrSetDef (4 bytes):** An MDXStrIndex structure that specifies the index of the set definition string. + +**cistr (4 bytes):** A signed integer that specifies the number of [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) strings. The value MUST be greater than or equal to 0, and less than or equal to the total number of [MDXStr](#mdxstr) records in the file. + +**rgistr (variable):** An array of MDXStrIndex structures that specifies the indexes of the MDX unique name strings. The number of the elements in the array MUST be equal to the value of **cistr**. + +### MDXStr + +The **MDXStr** record specifies a shared text string used by records specifying [MDX metadata](#Section_0f7583182c0b4155bf75c7399f89305c). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
st (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x885. + +**st (variable):** An [LPWideString](#lpwidestring) type that specifies the content of the string. + +### MDXTuple + +The **MDXTuple** record specifies [MDX tuple metadata](#Section_277444ebcca34128b302b39de79eeb41). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
istrConnName
tfnSrccistr
...rgistr (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x886. + +**istrConnName (4 bytes):** An [MDXStrIndex](#mdxstrindex) structure that specifies the index of the connection name string. + +**tfnSrc (1 byte):** A [Tag_Fn_MDX](#tag_fn_mdx) enumeration that specifies the type of [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) that generated the metadata. The value MUST be equal to **TFNCUBEMEMBER**, **TFNCUBEVALUE**, or **TFNCUBERANKEDMEMBER**. + +**cistr (4 bytes):** A signed integer that specifies the number of [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) strings. The value MUST be greater than or equal to 0, and less than or equal to the total number of [MDXStr](#mdxstr) records in the file. + +**rgistr (variable):** An array of MDXStrIndex structures that specifies the indexes of the MDX unique name strings. The number of the elements in the array MUST be equal to the value of **cistr.** + +### MergeCells + +The **MergeCells** record specifies [**merged cells**](#gt_75cf70e2-3993-471f-9589-b70d384588f2) in the document. If the count of the merged cells in the document is greater than 1026, the file will contain multiple adjacent **MergeCells** records. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cmcsrgref (variable)
...
+ +**cmcs (2 bytes):** An unsigned integer that specifies the count of [Ref8](#ref8) structures. MUST be less than or equal to 1026. + +**rgref (variable):** An array of Ref8 structures. Each array element specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that are merged into a single merged cell. These ranges MUST NOT overlap. MUST contain the number of elements specified by **cmcs.** + +### Mms + +The **Mms** record is reserved and MUST be ignored. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
reserved1reserved2
+ +**reserved1 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +### MsoDrawing + +The **MsoDrawing** record specifies a [**drawing**](#gt_4b4d1a42-c4a2-464d-ad16-d53b5c493fd3). If this record is in the [Worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56), [Macro Sheet](#Section_0dddd943f77a4fc2bf92868acb4587f7), or [Dialog Sheet](#Section_da37feb48b9a462d87772a5fddd4866e) substream, the **OfficeArtClientAnchor** structure mentioned in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) refers to the [OfficeArtClientAnchorSheet](#officeartclientanchorsheet) structure. If this record appears in the [Chart Sheet](#Section_732ff614d939416bb7c76d983471ff11) substream, the **OfficeArtClientAnchor** structure mentioned in \[MS-ODRAW\] refers to the [OfficeArtClientAnchorChart](#officeartclientanchorchart) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgChildRec (variable)
...
+ +**rgChildRec (variable):** An **OfficeArtDgContainer** structure as specified in \[MS-ODRAW\] that specifies the drawing. If the **rgChildRec** has a **shape** structure in it as specified in \[MS-ODRAW\] and that **shape** has a **clientData** record in it as specified in \[MS-ODRAW\], then the next record following this record MUST be an [Obj](#obj). The size of the **clientData** record does not include the size of the following Obj record. If the **rgChildRec** has a **shape** structure in it as specified in \[MS-ODRAW\] and that **shape** has a **clientTextbox** record in it as specified in \[MS-ODRAW\], then the next record following this record MUST be a [TxO](#txo). The size of the **clientTextbox** record does not include the size of this TxO record. + +### MsoDrawingGroup + +The **MsoDrawingGroup** record specifies a group of [**drawing objects**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgChildRec (variable)
...
+ +**rgChildRec (variable):** An **OfficeArtDggContainer** as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) that specifies the group of drawing objects. + +### MsoDrawingSelection + +The **MsoDrawingSelection** record specifies [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) [**drawing objects**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) and the drawing objects in focus on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
selection (variable)
...
+ +**selection (variable):** An **OfficeArtFDGSL** structure as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.2.33 that specifies the selected drawing objects. + +### MTRSettings + +The **MTRSettings** record specifies multithreaded calculation settings. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
fMTREnabled
fUserSetThreadCount
cUserThreadCount
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x089A. + +**fMTREnabled (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the multithreaded calculation is enabled. MUST be a value from the following table: + +| Value | Meaning | +|------------|----------------------------------------| +| 0x00000000 | Multithreaded calculation is disabled. | +| 0x00000001 | Multithreaded calculation is enabled. | + +**fUserSetThreadCount (4 bytes):** A Boolean that specifies whether the thread count was manually specified by the user. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00000000 | The thread count **cUserThreadCount** was not manually specified by the user. | +| 0x00000001 | The thread count **cUserThreadCount** was manually specified by the user. | + +**cUserThreadCount (4 bytes):** A signed integer that specifies the count of calculation threads. MUST be greater than or equal to 0x00000001 and MUST be less than or equal to 0x00000400. If **fMTREnabled** is 0x00000000 or **fUserSetThreadCount** is 0x00000000, the value of this field MUST be ignored. + +### MulBlank + +The **MulBlank** record specifies a [series](#Section_527ce4dfc9f84e50a314d4b07519593c) of blank [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) row. This record can store up to 256 [IXFCell](#ixfcell) structures. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwcolFirst
rgixfe (variable)
...
colLast
+ +**rw (2 bytes):** An [Rw](#rw) structure that specifies a row containing the blank cells. + +**colFirst (2 bytes):** A [Col](#col) structure that specifies the first column in the series of blank cells within the sheet. The value of **colFirst.col** MUST be less than or equal to 254. + +**rgixfe (variable):** An array of IXFCell structures. Each element of this array contains an IXFCell structure corresponding to a blank cell in the series. The number of entries in the array MUST be equal to the value given by the following formula: + +Number of entries in **rgixfe** = (**colLast.col** – **colFirst.col** +1) + +**colLast (2 bytes):** A Col structure that specifies the last column in the series of blank cells within the sheet. This **colLast.col** value MUST be greater than **colFirst.col** value. + +### MulRk + +The **MulRk** record specifies a [series](#Section_527ce4dfc9f84e50a314d4b07519593c) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) with numeric data in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) row. This record can store up to 256 [RkRec](#rkrec) structures. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwcolFirst
rgrkrec (variable)
...
colLast
+ +**rw (2 bytes):** An [Rw](#rw) structure that specifies the row containing the cells with numeric data. + +**colFirst (2 bytes):** A [Col](#col) structure that specifies the first column in the series of numeric cells within the sheet. The value of **colFirst.col** MUST be less than or equal to 254. + +**rgrkrec (variable):** An array of RkRec structures. Each element in the array specifies an RkRec in the row. The number of entries in the array MUST be equal to the value given by the following formula: + +Number of entries in **rgrkrec** = (**colLast.col** – **colFirst.col** +1) + +**colLast (2 bytes):** A Col structure that specifies the last column in the set of numeric cells within the sheet. This **colLast.col** value MUST be greater than the **colFirst.col** value. + +### NameCmt + +The **NameCmt** record specifies a [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) associated with a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
cchNamecchComment
name (variable)
...
comment (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0894. + +**cchName (2 bytes):** An unsigned integer that specifies the number of characters in the **name**. The value MUST be less than or equal to 0x00FF. + +**cchComment (2 bytes):** An unsigned integer that specifies the number of characters in the **comment**. The value MUST be less than or equal to 0x00FF. + +**name (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the defined name; **cchName** specifies the number of characters in this string. This string MUST satisfy the formatting restrictions specified in the [XLNameUnicodeString](#xlnameunicodestring) structure. This string MUST also satisfy the following formatting restriction based on the **fBuiltin** field in the preceding [Lbl](#lbl) record: + +| Value of fBuiltIn field in the preceding Lbl record | Restrictions on this field | +|----|----| +| 0 | The string in this field MUST be the same string (using case-insensitive comparison) as the string in the **name** field of the preceding Lbl record. | +| 1 | The string in this field MUST be the defined name associated with the [**built-in name**](#gt_d40a51df-e96f-45ec-885d-6f936d172b39) number that appears in the **name** field in the preceding Lbl record. | + +**comment (variable):** An XLUnicodeStringNoCch structure that specifies the comment; **cchComment** specifies the number of characters in this string. + +### NameFnGrp12 + +The **NameFnGrp12** record specifies the name of a [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) in a [**function category**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) that is specified in an [**FnGrp12**](#fngrp12) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
cachNamefgrp
rgach (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0899. + +**cachName (2 bytes):** An unsigned integer that specifies the number of characters in the name of the function. The value MUST be greater than or equal to 1 and less than or equal to 255. + +**fgrp (2 bytes):** An unsigned integer that specifies the zero-based index of the function category that this function belongs to. This value minus 32 specifies the zero-based index of an FnGrp12 record in the collection of FnGrp12 records, as specified by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). MUST be greater than or equal to 32 and less than or equal to 255. + +**rgach (variable):** An [XLNameUnicodeString](#xlnameunicodestring) structure that specifies the name of the function. The length MUST be equal to **cachName**. + +### NamePublish + +The **NamePublish** record specifies information about a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
ABunusedstrName (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0893. + +**A - fPublished (1 bit):** A bit that specifies whether the defined name is published to a server. This bit is ignored if the **fPublishedBookItems** field of the [BookExt_Conditional12](#bookext_conditional12) structure is 0. + +**B - fWorkbookParam (1 bit):** A bit that specifies whether the defined name is a [**workbook parameter**](#gt_be16812d-eaff-41db-83cc-d145e61e8ef6). + +**unused (14 bits):** Undefined and MUST be ignored. + +**strName (variable):** An [XLNameUnicodeString](#xlnameunicodestring) structure that specifies the defined name. + +### Note + +The **Note** record specifies a [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) associated with a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) or revision information about a comment associated with a cell. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
body (variable)
...
+ +**body (variable):** A variable type field. The data type and meaning of this field is determined by the stream that contains this record, as specified in the following table: + + ++++ + + + + + + + + + + + + + + + + +
Stream that contains this recordBody field data type and meaning

Workbook stream

+

In the Workbook stream the record MUST be in a Worksheet substream, a Dialog Sheet substream, or a Macro Sheet substream.

A NoteSh structure that specifies a comment associated with a cell.
Revision stream (revision log)A NoteRR structure that specifies a revision record for a comment associated with a cell.
+ +### Number + +The **Number** record specifies a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that contains a [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cell
...num
...
...
+ +**cell (6 bytes):** A [Cell](#cell) structure that specifies the cell. + +**num (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the cell value. + +If this record appears in a [SERIESDATA](#chart-sheet-substream) record collection, and this record specifies a cell in the [chart data cache](#Section_e21d24e4e71f4fdc81077f0d6a6efa6a) that specifies data for an [error bar](#Section_762a461d0a45474ebd7d5994bb294af2) [series](#Section_527ce4dfc9f84e50a314d4b07519593c), then this field is a [ChartNumNillable](#chartnumnillable) value. If a ChartNumNillable is used, a blank cell is specified by a [NilChartNum](#nilchartnum) structure that has a **type** field with a value of 0x0000, and a cell with a \#N/A error is specified by a NilChartNum that has a **type** field with a value of 0x0100. + +### Obj + +The **Obj** record specifies the properties of an object in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cmo (22 bytes)
...
...
...gmo (optional)
...
pictFormat (optional)
...pictFlags (optional)
...
cbls (16 bytes, optional)
...
...
rbo (optional)
...
...sbs (24 bytes, optional)
...
...
...nts (26 bytes, optional)
...
...
...
macro (variable)
...
pictFmla (variable)
...
linkFmla (variable)
...
checkBox (optional)
...
...
radioButton (optional)
...
edit (optional)
...
...
list (variable)
...
gbo (optional)
...
...reserved (optional)
...
+ +**cmo (22 bytes):** An [FtCmo](#ftcmo) structure that specifies the common properties of this object. + +**gmo (6 bytes):** An optional [FtGmo](#ftgmo) structure that specifies the properties of this group object. This field MUST exist if and only if **cmo.ot** is equal to 0x00. + +**pictFormat (6 bytes):** An optional [FtCf](#ftcf) structure that specifies the format of this picture object. This field MUST exist if and only if **cmo.ot** is equal to 0x08. + +**pictFlags (6 bytes):** An optional [FtPioGrbit](#ftpiogrbit) structure that specifies additional properties of this picture object. This field MUST exist if and only if **cmo.ot** is equal to 0x08. + +**cbls (16 bytes):** An optional [FtCbls](#ftcbls) structure that represents a check box or radio button. This field MUST exist if and only if **cmo.ot** is equal to 0x0B or 0x0C. + +**rbo (10 bytes):** An optional [FtRbo](#ftrbo) structure that represents a radio button. This field MUST exist if and only if **cmo.ot** is equal to 0x0C. + +**sbs (24 bytes):** An optional [FtSbs](#ftsbs) structure that specifies the properties of this spin control, scrollbar, list, or drop-down list object. This field MUST exist if and only if **cmo.ot** is equal to 0x10, 0x11, 0x12, or 0x14. + +**nts (26 bytes):** An optional [FtNts](#ftnts) structure that specifies the properties of this [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) object. This field MUST exist if and only if **cmo.ot** is equal to 0x19. + +**macro (variable):** An optional [FtMacro](#ftmacro) structure that specifies the action associated with this object. + +**pictFmla (variable):** An optional [FtPictFmla](#ftpictfmla) structure that specifies the location of the data associated with this picture object. This field MUST NOT exist unless **cmo.ot** is equal to 0x08. + +**linkFmla (variable):** An optional [ObjLinkFmla](#objlinkfmla) structure that specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that has a value linked to this object. This field MUST NOT exist unless **cmo.ot** is equal to 0x0B, 0x0C, 0x10, 0x11, 0x12, or 0x14. The value of **linkFmla.ft** MUST equal 0x14 if **cmo.ot** is equal to 0x0B or 0x0C. Otherwise, **linkFmla.ft** MUST equal 0x0E. + +**checkBox (12 bytes):** An optional [FtCblsData](#ftcblsdata) structure that specifies the properties of this check box or radio button object. This field MUST exist if and only if **cmo.ot** is equal to 0x0B or 0x0C. + +**radioButton (8 bytes):** An optional [FtRboData](#ftrbodata) structure that specifies additional properties of this radio button object. This field MUST exist if and only if **cmo.ot** is equal to 0x0C. + +**edit (12 bytes):** An optional [FtEdoData](#ftedodata) structure that specifies the properties of this edit box object. This field MUST exist if and only if **cmo.ot** is equal to 0x0D. + +**list (variable):** An optional [FtLbsData](#ftlbsdata) structure that specifies the properties of this list box or drop-down object. This field MUST exist if and only if **cmo.ot** is equal to 0x12 or 0x14. + +**gbo (10 bytes):** An optional [FtGboData](#ftgbodata) structure that specifies the properties of this group box object. This field MUST exist if and only if **cmo.ot** is equal to 0x13. + +**reserved (4 bytes):** Optional. MUST be 0, and MUST be ignored. This field MUST exist if and only if **cmo.ot** does not equal 0x12 or 0x14. + +### ObjectLink + +The **ObjectLink** record specifies an object on a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), or the entire chart, to which the [Text](#text) record is linked. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
wLinkObjwLinkVar1
wLinkVar2
+ +**wLinkObj (2 bytes):** An unsigned integer that specifies the object that the Text record is linked to. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0001 | Entire chart. | +| 0x0002 | Value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3), or vertical value axis on bubble and scatter [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5) | +| 0x0003 | [**Category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) axis, or horizontal value axis on bubble and scatter chart groups. | +| 0x0004 | [Series](#Section_527ce4dfc9f84e50a314d4b07519593c) or [data points](#Section_9c986ad250d44fa1a157063ac5c971a0). | +| 0x0007 | Series axis. | +| 0x000C | [**Display units**](#gt_7d807b62-cff1-4e03-a73f-840844345b83) labels of an axis. | + +**wLinkVar1 (2 bytes):** An unsigned integer that specifies the zero-based index into a [Series](#series-1) record in the collection of Series records in the current Chart Sheet substream. Each referenced Series record specifies a series for the chart group to which the Text record is linked. When the **wLinkObj** field is 4, MUST be less than or equal to 254. When the **wLinkObj** field is not 4, MUST be zero, and MUST be ignored. + +**wLinkVar2 (2 bytes):** An unsigned integer that specifies the zero-based index into the category within the series specified by **wLinkVar1**, to which the Text record is linked. When the **wLinkObj** field is 4, if the Text record is linked to a series instead of a single data point, the value MUST be 0xFFFF; if the Text record is linked to a data point, the value MUST be less than or equal to 31999. When the **wLinkObj** field is not 4, MUST be zero, and MUST be ignored. + +### ObjProtect + +The **ObjProtect** record specifies the [**protection**](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499) state of the objects on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). This record exists if the sheet is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829) and the objects on the sheet are protected. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
fLockObj
+ +**fLockObj (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies that the objects are protected. MUST be 0x0001. + +### ObNoMacros + +The existence of the **ObNoMacros** record specifies that an [ObProj](#obproj) record exists in the file, and that there are no [**forms**](#gt_c7858bfa-d4d2-48a7-ac9c-d2e90fbe3590), [**modules**](#gt_3f7df968-a51b-4dea-9f2c-4cf6ce65ccc1), or [**class modules**](#gt_25ca6ee7-698a-45cc-9e3c-8be094d77324) in the [**VBA project**](#gt_980e3334-2874-4425-a73a-f2235cec1e1e) located in the [VBA storage](#Section_27d93f33eaa941d49ec07f2a69d8ff5f) stream. + +### ObProj + +The existence of the **ObProj** record specifies that there is a [**VBA project**](#gt_980e3334-2874-4425-a73a-f2235cec1e1e) in the file. This project is located in the [VBA storage](#Section_27d93f33eaa941d49ec07f2a69d8ff5f) stream. + +### OleDbConn + +The **OleDbConn** record specifies the connection information for an [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) [**connection string**](#gt_03a9d0ca-2f10-4f3d-b910-052714a96f7d), and specifies the beginning of a collection of [ExtString](#extstring) records as defined by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of ExtString records specifies the connection string for a [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) that retrieves [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
ABreserved1cst
reserved2
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x080A. + +**A - fPasswd (1 bit):** A bit that specifies whether the connection password is present in the connection string. A value of 1 specifies that the password was stripped from the connection string. + +**B - fLocal (1 bit):** A bit that specifies whether the connection string is the main connection string or an alternate connection string. See [ConnGrbitDbtOledb](#conngrbitdbtoledb) for more information. + +**reserved1 (14 bits):** MUST be zero, and MUST be ignored. + +**cst (2 bytes):** An unsigned integer that specifies the number of ExtString records that follow this record. MUST be greater than 0. If the value is 1, the connection string is specified by ExtString.**string**. If the value is greater than 1, the connection string is determined by concatenating each of the ExtString.**string** fields of the ExtString records that follow. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +### OleObjectSize + +The **OleObjectSize** record specifies the visible [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) when this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is displayed as an [**embedded object**](#gt_708607be-8655-416e-93f3-b434e9ecbd56) in another document. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
unusedref
...
+ +**unused (2 bytes):** Undefined and MUST be ignored. + +**ref (6 bytes):** A [RefU](#refu) structure that specifies the visible range of cells, if the workbook is an embedded object and the [**active sheet**](#gt_767d2df7-5efd-40a1-9e58-4b6a597cc389) is a [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615), a [**macro sheet**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491), or a [**dialog sheet**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8) as specified by the **itabCur** field of a [Window1](#window1) record. Otherwise, **ref** is undefined and MUST be ignored. + +### Palette + +The **Palette** record specifies a [**custom color palette**](#gt_c24c2bf1-b41b-4eae-92a5-fe10cca57e2e). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccvrgColor (variable)
...
+ +**ccv (2 bytes):** A signed integer that specifies the number of colors in the **rgColor** array. The value MUST be 56. + +**rgColor (variable):** An array of [LongRGB](#longrgb) structures that specifies the colors of the [**color palette**](#gt_05879d13-b9e0-4333-b96d-63cc3433997e). The number of items in the array MUST be equal to the value specified in the **ccv** field. + +### Pane + +The **Pane** record specifies the position of [**frozen**](#gt_1e984b7c-9760-4832-88c8-798e30f845db) [**panes**](#gt_fa363a22-6c89-4829-86aa-09f939f40a54) or unfrozen panes in the window used to display the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xy
rwTopcolLeft
pnnAcctreserved
+ +**x (2 bytes):** An unsigned integer that specifies the horizontal position of the split in the pane. If the value of **fFrozenRt** in the preceding [Window2](#window2) record is 1, the value of **x** is measured in cells and MUST be less than or equal to 255. If the value of **fFrozenRt** in the preceding Window2 is 0, the value of **x** is measured in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382), and MUST be less than or equal to 32767. + +**y (2 bytes):** An unsigned integer that specifies the vertical position of the split in the pane. If the value of **fFrozenRt** in the preceding Window2 record is 1, the value of **y** is measured in cells. If the value of **fFrozenRt** in the preceding Window2 is 0, the value of **y** is measured in twips, and MUST be less than or equal to 32767. + +**rwTop (2 bytes):** An [RwU](#rwu) structure that specifies the topmost [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) row in the bottom pane. + +**colLeft (2 bytes):** A [ColU](#colu) structure that specifies the first visible [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) column in the [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) pane. + +**pnnAcct (1 byte):** A [PaneType](#panetype) enumeration that specifies the active pane. + +**reserved (1 byte):** MUST be zero, and MUST be ignored. + +### ParamQry + +The **ParamQry** record specifies the parameters for a [**parameterized query**](#gt_c68a3a26-317d-4a1d-9eff-c2630b53067c). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
fixed
...
rgb (variable)
...
+ +**fixed (8 bytes):** A [PARAMQRY_Fixed](#paramqry_fixed) structure that specifies the type information of the parameters. + +**rgb (variable):** Variable type field that specifies a parameter for a parameterized query. The data type and meaning are specified in the following table: + +| Value of fixed.pbt | Value of fixed.grbit | Meaning | +|----|----|----| +| 0 | Any | **rgb** is an [SXString](#sxstring) followed by an unused byte. | +| 1 | 0x001 | **rgb** is an Xnum (section [2.5.342](#xnum)). | +| 1 | 0x002 | **rgb** is an SXString followed by an unused byte. | +| 1 | 0x800 | **rgb** is a 4-byte signed integer. | +| 2 | Any | **rgb** is an [FMSER_param](#parameterparsedformula) that specifies the cell reference containing the parameter. | + +### Password + +The **Password** record specifies the password verifier for the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) or [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). If this record exists in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1), then it is a password for the workbook. If this record exists in a [worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56), [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11), [macro sheet substream](#Section_0dddd943f77a4fc2bf92868acb4587f7), or [dialog sheet substream](#Section_da37feb48b9a462d87772a5fddd4866e), then it is a password for only that sheet. This record MUST exist for the workbook. A sheet has a password if and only if this record exists. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
wPassword
+ +**wPassword (2 bytes):** An unsigned integer that specifies the password verifier[\<100\>](#Appendix_A_100). See [Password Verifier Algorithm](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4) for more information. If the password is for a sheet, MUST NOT equal 0x0000. If **wPassword** is 0x0000 it means the workbook has no password. + +### PhoneticInfo + +The **PhoneticInfo** record specifies the default format for [**phonetic strings**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77) and the [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that have phonetic strings that are [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
phs
sqref (variable)
...
+ +**phs (4 bytes):** A [Phs](#phs) structure that specifies the default format for phonetic strings on the sheet. When a phonetic string is entered into a cell that does not already contain a phonetic string, the default format is applied to the phonetic string. + +**sqref (variable):** An [SqRef](#sqref) structure that specifies the ranges of cells on the sheet that have phonetic strings that are visible. + +### PicF + +The **PicF** record specifies the layout of a picture that is attached to a picture-filled chart element. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptypunused
reserved1ABCDnumScale
...
...
+ +**ptyp (2 bytes):** An unsigned integer that specifies the picture layout. If this record is not located in the sequence of records that conform to the [SS](#chart-sheet-substream) rule, as specified by the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), then this field MUST be 0x0001. If this record is located in the sequence of records that conform to the SS rule, then this field MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0001 | Stretched. The picture is scaled to fit within the [**dimensions (2)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) of the filled areas of the chart element. | +| 0x0002 | Stacked. The pictures in the [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) are stacked on top of each other in the direction of the value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). | +| 0x0003 | Stacked and scaled. The pictures in the data points are stacked next to or on top of each other, and each picture is scaled to fit in the number of units on the value axis as specified by **numScale**. | + +**unused (2 bytes):** Undefined and MUST be ignored. + +**reserved1 (9 bits):** MUST be zero, and MUST be ignored. + +**A - fTopBottom (1 bit):** A bit that specifies whether the picture covers the top and bottom fill areas of the data points. The top and bottom fill areas of the data points are parallel to the [**floor**](#gt_dc38c098-e0d3-4701-9656-5f2cf4d80f29) in a 3-D [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). If a [Chart3d](#chart3d) record does not exist in the chart sheet substream, or if this record is not in an SS rule or if this record is in an SS rule that contains a [Chart3DBarShape](#chart3dbarshape) record with the **riser** field equal to 0x01, this field MUST be 1. + +**B - fBackFront (1 bit):** A bit that specifies whether the picture covers the front and back fill areas of the data points on a bar or column [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). If a Chart3d record does not exist in the chart sheet substream, or if this record is not in an SS rule or if this record is in an SS rule that contains a Chart3DBarShape record with the **riser** field equal to 0x01, this field MUST be 1. + +**C - fSide (1 bit):** A bit that specifies whether the picture covers the side fill areas of the data points on a bar or column chart group. If a Chart3d record does not exist in the chart sheet substream, or if this record is not in an SS rule or if this record is in an SS rule that contains a Chart3DBarShape record with the **riser** field equal to 0x01, this field MUST be 1. + +**D - reserved2 (4 bits):** MUST be zero, and MUST be ignored. + +**numScale (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the number of units on the value axis in which to fit the entire picture. The picture is scaled to fit within this number of units. If the value of **ptyp** is not 0x0003, this field is undefined and MUST be ignored. + +### Pie + +The **Pie** record specifies that the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is a pie chart group or a doughnut chart group, and specifies the chart group attributes. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
anStartpcDonut
ABreserved
+ +**anStart (2 bytes):** An unsigned integer that specifies the starting angle of the first [data point](#Section_9c986ad250d44fa1a157063ac5c971a0), clockwise from the top of the circle. MUST be less than or equal to 360. + +**pcDonut (2 bytes):** An unsigned integer that specifies the size of the center hole in a doughnut chart group as a percentage of the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) size. MUST be a value from the following table: + +| Value | Meaning | +|----------|-----------------------| +| 0 | Pie chart group. | +| 10 to 90 | Doughnut chart group. | + +**A - fHasShadow (1 bit):** A bit that specifies whether one data point or more data points in the chart group have shadows. + +**B - fShowLdrLines (1 bit):** A bit that specifies whether the [**leader lines**](#gt_8b7c448e-82e3-4d22-a8ba-52e0a10b14fa) to the [data labels](#Section_cac7f43a3af142f58ff2814c2870427f) are shown. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +### PieFormat + +The **PieFormat** record specifies the distance of a [data point](#Section_9c986ad250d44fa1a157063ac5c971a0) or data points in a [series](#Section_527ce4dfc9f84e50a314d4b07519593c) from the center of one of the following: + +- The [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) for a doughnut or pie [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). + +- The [**primary pie**](#gt_e2300016-b59d-4384-9b70-c000523747e0) in a pie of pie or bar of pie chart group. + +- The [**secondary bar/pie**](#gt_e452a278-4e13-44c6-9f1b-db3c93841bc6) of a pie of pie chart group. + +The data point or data points in a series are specified by the sequence of records that conforms to the [SS](#chart-sheet-substream) rule in the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that contains this record. + +MUST NOT exist on chart group types other than pie, doughnut, bar of pie, or pie of pie. MUST NOT exist if the chart group type is doughnut and the series is not the outermost series. MUST NOT exist on the data points on the secondary bar/pie of a bar of pie chart group. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
pcExplode
+ +**pcExplode (2 bytes):** A signed integer that specifies the distance of a data point or data points in a series from the center of one of the following: + +- The plot area for a doughnut or pie chart group. + +- The primary pie in a pie of pie or bar of pie chart group. + +- The secondary bar/pie of a pie of pie chart group. + +The value of this field specifies the distance as a percentage. If this value is 0, then the data point or data points in a series is as close to the center as possible for the particular chart group type. If this value is 100, then the data point is at the edge of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)). If this value is greater than 100, such that the data point is beyond the edge of the chart area, then all the data points in the chart group are scaled down to fit inside the chart area such that the data point with the highest **pcExplode** value is at the edge of the chart area . + +MUST be greater than or equal to 0. + +### PivotChartBits + +The **PivotChartBits** record specifies the flags applicable to a [Pivot Chart](#Section_bed5fbd356f54997bb54b49f04e734b7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rtunused1
Aunused2reserved1 (optional)
reserved2 (optional)reserved3 (optional)
+ +**rt (2 bytes):** An unsigned integer that specifies the [FRT](#Section_b660b67822684414839ed1ae9a4e4e85) record type. MUST be 0x0859. + +**unused1 (2 bytes):** Undefined, and MUST be ignored. + +**A - fGXHide (1 bit):** A bit that specifies whether to hide the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) captions in the Pivot Chart. + +**unused2 (15 bits):** Undefined, and MUST be ignored. + +**reserved1 (2 bytes):** This field SHOULD[\<101\>](#Appendix_A_101) exist. If this field exists, this value MUST be 0x0000, and MUST be ignored. + +**reserved2 (2 bytes):** This field SHOULD[\<102\>](#Appendix_A_102) exist. If this field exists, this value MUST be 0x0000, and MUST be ignored. + +**reserved3 (2 bytes):** This field SHOULD[\<103\>](#Appendix_A_103) exist. If this field exists, this value MUST be 0x0000, and MUST be ignored. + +### PlotArea + +The **PlotArea** record is empty, specifying that the [Frame](#frame) record that immediately follows this record specifies properties of the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). + +### PlotGrowth + +The **PlotGrowth** record specifies the scale factors to use when calculating the [**font scaling**](#gt_47254269-4165-4a8c-92a0-c920f732d0bd) information for a [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) in the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). If no [Fbi](#fbi) record exists in the [chart sheet](#Section_2c90d75bc92645aa8ff29d4483f51831) where **scab** is 0x0001, this record is unused and MUST be ignored. Otherwise, the values from each Fbi record where **scab** is 0x0001 are used in conjunction with values in this record to render the scaled fonts in the plot area. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
dxPlotGrowth
dyPlotGrowth
+ +**dxPlotGrowth (4 bytes):** A **FixedPoint** as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.6 that specifies the horizontal growth (in [**points**](#gt_d072e4da-7898-4227-8f25-9fe77db43571)) of the plot area for font scaling. + +**dyPlotGrowth (4 bytes):** A **FixedPoint** as specified in \[MS-OSHARED\] section 2.2.1.6 that specifies the vertical growth (in points) of the plot area for font scaling. + +### Pls + +The **Pls** record specifies printer settings and the printer driver information. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reservedrgb (variable)
...
+ +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**rgb (variable):** A **DEVMODE** structure, as defined in [\[DEVMODE\]](https://go.microsoft.com/fwlink/?LinkId=89844), which specifies the printer settings. The size of this field is equal to the size of the current record and all of the following [Continue](#continue) records, excluding the record's heading and **reserved** field. + +### PLV + +The **PLV** record specifies the settings of a [**Page Layout view**](#gt_c5ea3e6c-db72-4a85-b273-596e95a3841e) for a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
wScalePLVABCunused
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x088B. + +**wScalePLV (2 bytes):** An unsigned integer that specifies zoom scale as a percentage for the Page Layout view of the current sheet. For example, if the value is 107, then the zoom scale is 107%. The value 0 means that the zoom scale is not set. If the value is nonzero, it MUST be greater than or equal to 10 and less than or equal to 400. + +**A - fPageLayoutView (1 bit):** A bit that specifies whether the sheet is in the Page Layout view. If the **fSLV** in [**Window2**](#window2) record is 1 for this sheet, it MUST be 0. + +**B - fRulerVisible (1 bit):** A bit that specifies whether the application displays the [**ruler**](#gt_03895998-6780-4615-8795-0fda97bd6379). + +**C - fWhitespaceHidden (1 bit):** A bit that specifies whether the margins between pages are [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) in the Page Layout view. + +**unused (13 bits):** Undefined, and MUST be ignored. + +### Pos + +The **Pos** record specifies the size and position for a [legend](#Section_1832229b7d1945f488d455e9c07466f0), an [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a), or the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c), as specified by the primary [axis group](#Section_578b739742624944b5a67ee6d4d3bb55). This record MUST be ignored for the plot area when the **fManPlotArea** field of [ShtProps](#shtprops) in the associated [chart sheet](#chart-sheet-substream) substream is set to 1. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
mdTopLtmdBotRt
x1unused1
y1unused2
x2unused3
y2unused4
+ +**mdTopLt (2 bytes):** A [PositionMode](#positionmode) structure that specifies the positioning mode for the upper-left corner of a legend, an attached label, or the plot area. The valid combinations of **mdTopLt** and **mdBotRt** and the meaning of **x1**, **y1**, **x2**, **y2** are specified in the **Valid Combinations of mdTopLt and mdBotRt by Type** table. + +**mdBotRt (2 bytes):** A PositionMode structure that specifies the positioning mode for the lower-right corner of a legend, an attached label, or the plot area. The valid combinations of **mdTopLt** and **mdBotRt** and the meaning of **x1**, **y1**, **x2**, **y2** are specified in the following table. + + ++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Type

mdTopLt

+

Position Mode

mdBotRt Position ModeMeaning
plot area (axis group)MDPARENTMDPARENTThe values of x1 and y1 specify the horizontal and vertical offsets of the primary axis group's upper-left corner, relative to the upper-left corner of the chart area (section 2.2.3.17), in SPRC. The values of x2 and y2 specify the width and height of the primary axis group, in SPRC.
legendMDCHARTMDABSThe values x1 and y1 specify the horizontal and vertical offsets of the legend's upper-left corner, relative to the upper-left corner of the chart area (section 2.2.3.17) in SPRC. The values of x2 and y2 specify the width and height of the legend, in points.
legendMDCHARTMDPARENTThe values of x1 and y1 specify the horizontal and vertical offsets of the legend's upper-left corner, relative to the upper-left corner of the chart area (section 2.2.3.17) in SPRC. The values of x2 and y2 MUST be ignored. The size of the legend is determined by the application.
legendMDKTHMDPARENTThe values of x1, y1, x2 and y2 MUST be ignored. The legend is located inside a data table.
attached labelMDPARENTMDPARENTThe meaning of x1 and y1 is specified in the Meaning of x1 and y1 as specified by the Type of Attached Label table. x2 and y2 MUST be ignored. The size of the attached label is determined by the application.
+ +The following table shows the meaning of x1 and y1 as specified by the type of attached label. + + ++++ + + + + + + + + + + + + + + + + + + + + +
Type of Attached LabelMeaning
Chart titleThe value of x1 and y1 specify the horizontal and vertical offset of the title, relative to its default position, in SPRC.
Axis titleThe value of x1 and y1 specify the offset of the title along the direction of a specific axis. The value of x1 specifies an offset along the category axis, date axis, or horizontal value axis. The value of y1 specifies an offset along the value axis. Both offsets are relative to the title's default position, in 1/1000th of the axis length.
Data label

If the chart is not a pie chart group or a radar chart group, x1 and y1 specify the offset of the label along the direction of the specific axis. The x1 value is an offset along the category axis, date axis, or horizontal value axis. The y1 value is an offset along the value axis, opposite to the direction of the value axis. Both offsets are relative to the label's default position, in 1/1000th of the axis length.

+

For a pie chart group, the value of x1 specifies the clockwise angle, in degrees, and the value of y1 specifies the radius offset of the label relative to its default position, in 1/1000th of the pie radius length. A label moved toward the pie center has a negative radius offset.

+

For a radar chart group, the values of x1 and y1 specify the horizontal and vertical offset of the label relative to its default position, in 1/1000th of the axis length.

+ +**x1 (2 bytes):** A signed integer that specifies a position. The meaning is specified in the earlier table showing the valid combinations **mdTopLt** and **mdBotRt** by type. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**y1 (2 bytes):** A signed integer that specifies a position. The meaning is specified in the earlier table showing the valid combinations **mdTopLt** and **mdBotRt** by type. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**x2 (2 bytes):** A signed integer that specifies a width. The meaning is specified in the earlier table showing the valid combinations **mdTopLt** and **mdBotRt** by type. + +**unused3 (2 bytes):** Undefined and MUST be ignored. + +**y2 (2 bytes):** A signed integer that specifies a height. The meaning is specified in the earlier table showing the valid combinations **mdTopLt** and **mdBotRt** by type. + +**unused4 (2 bytes):** Undefined and MUST be ignored. + +### PrintGrid + +The **PrintGrid** record specifies whether the [**gridlines**](#gt_82f8a326-64b0-4506-a18e-930f7c2c95b9) are printed. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
Aunused
+ +**A - fPrintGrid (1 bit):** A bit that specifies whether the gridlines are printed. + +**unused (15 bits):** Undefined, and MUST be ignored. + +### PrintRowCol + +The **PrintRowCol** record specifies whether the row and column headers are printed. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
printRwCol
+ +**printRwCol (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the row and column headers are printed. MUST be a value from the following table: + +| **Value** | **Meaning** | +|:----------|:----------------------------------------| +| 0x0000 | Row and column headers are not printed. | +| 0x0001 | Row and column headers are not printed. | + +### PrintSize + +The **PrintSize** record specifies the printed size of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). This record affects the charts printed only on their own page. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
printSize
+ +**printSize (2 bytes):** An unsigned integer that specifies the printed size of the chart. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The record is part of a [UserSViewBegin](#usersviewbegin) block and the [**print settings**](#gt_6ef7745e-6602-4ff5-a8b0-9b9fd9f95b4a) are unchanged from the defaults specified in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). | +| 0x0001 | The chart is resized to fill the entire page regardless of the original chart proportions, within page margins. | +| 0x0002 | The chart is resized proportionally to fill the entire page, within page margins. | +| 0x0003 | The printed size of the chart is defined in the [Chart](#chart-2) record. | + +### Prot4Rev + +The **Prot4Rev** record specifies whether removal of the [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc)'s [revision logs](#Section_2cbd26e86f7e4195ada414c8b7e595b8) is disallowed. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
fRevLock
+ +**fRevLock (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether removal of the shared workbook's revision logs is disallowed. The value MUST be one of the values specified in the following table: + +| Value | Meaning | +|--------|---------------------------------------------------------------| +| 0x0000 | Removal of the shared workbook's revision logs is allowed. | +| 0x0001 | Removal of the shared workbook's revision logs is disallowed. | + +### Prot4RevPass + +The **Prot4RevPass** record specifies the password verifier that is required to change the value of the **fRevLock** field of the [Prot4Rev](#prot4rev) record that immediately precedes this record. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
protPwdRev
+ +**protPwdRev (2 bytes):** An unsigned integer that specifies the password verifier that is required to change the value of the **fRevLock** field of the Prot4Rev record that immediately precedes this record[\<104\>](#Appendix_A_104). The algorithm to generate the password verifier is documented in the [password verifier algorithm](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4). If the value is 0, there is no password. MUST be 0 if the **fRevLock** field of Prot4Rev is 0x0000. + +### Protect + +The **Protect** record specifies the [**protection**](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499) state for the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) or [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). If this record exists in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1), then the protection state specified in this record applies to the workbook. If this record exists in a [worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56), [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11), [macro sheet substream](#Section_0dddd943f77a4fc2bf92868acb4587f7), or [dialog sheet substream](#Section_da37feb48b9a462d87772a5fddd4866e), then the protection state specified in this record applies to only that sheet. This record MUST exist for the workbook. For a sheet, the sheet is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829) if and only if this record exists. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
fLock
+ +**fLock (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the sheet or workbook is protected. For a sheet, **fLock** MUST be 0x0001, and it means the sheet is protected. For the workbook, it MUST be a value from the following table: + +| Value | Meaning | +|--------|--------------------------------| +| 0x0000 | The workbook is not protected. | +| 0x0001 | The workbook is protected. | + +### Qsi + +The **Qsi** record specifies properties for a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289), and specifies the beginning of a collection of records as defined by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies additional information for the query table. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEFGHIJKLMNitblAutoFmt
OPQRSTunused3reserved
...rgchName (variable)
...
unused4
+ +**A - fTitles (1 bit):** A bit that specifies whether the first row of the query table contains column titles. + +**B - fRowNums (1 bit):** A bit that specifies whether the first column of the query table displays row numbers. + +**C - fDisableRefresh (1 bit):** A bit that specifies whether the query table can be refreshed. + +| Value | Meaning | +|-------|--------------------------------------| +| 0 | The query table can be refreshed. | +| 1 | The query table cannot be refreshed. | + +**D - fAsync (1 bit):** A bit that specifies whether the query table refreshes data asynchronously. MUST be set to 1 if **fNewAsync** field is set to1. + +**E - fNewAsync (1 bit):** A bit that specifies whether data has been refreshed for this query table. MUST be set to 0 if **fAsync** field is set to 0. + +| Value | Meaning | +|----|----| +| 0 | The first background data [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) was finished at the time the file was saved. | +| 1 | The first background data refresh was not finished at the time the file was saved. | + +**F - fAutoRefresh (1 bit):** A bit that specifies whether the query table refreshes its data automatically when the document is opened. + +**G - fShrink (1 bit):** A bit that specifies the behavior when dealing with a variable number of rows of data in the query table between refresh operations. If **fOverwrite** is 1, this value MUST be 0. MUST be one of the following. + +| Value | Meaning | +|----|----| +| 0 | Unused [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) are to be cleared. | +| 1 | Unused cells are to be deleted | + +**H - fFill (1 bit):** A bit that specifies whether formulas in columns adjacent to the query table are filled down whenever the query table is refreshed. + +**I - fAutoFormat (1 bit):** A bit that is unused and SHOULD be set to zero[\<105\>](#Appendix_A_105). + +**J - fSaveData (1 bit):** A bit that specifies whether the query table preserves all of its data in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) when the document is saved. MUST be one of the following: + +| Value | Meaning | +|:-----:|-------------------------------------------| +| 0x0 | Data in the query table will not be saved | +| 0x1 | Data in the query table will be saved | + +**K - fDisableEdit (1 bit):** A bit that specifies whether the content used with this query table is editable. + +| Value | Meaning | +|-------|-------------------------------------------------------------------| +| 0 | Content is editable | +| 1 | Content is [**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81) | + +**L - unused1 (2 bits):** Undefined and MUST be ignored. + +**M - fOverwrite (1 bit):** A bit that specifies the behavior when dealing with a variable number of rows of data in the query table between refresh operations. If **fShrink** is 1, this value MUST be 0. MUST be one of the following. + +| Value | Meaning | +|-------|---------------------------------------| +| 0 | Insert new cells for new data | +| 1 | Overwrite existing cells for new data | + +**N - unused2 (2 bits):** Undefined and MUST be ignored. + +**itblAutoFmt (2 bytes):** An [AutoFmt8](#autofmt8) that specifies the [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f) to be applied to the query table. MUST be less than or equal to 0x0014. + +**O - fibitAtrNum (1 bit):** A bit that specifies whether numeric cell data is formatted according to the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) specified in **itblAutoFmt** field. + +**P - fibitAtrFnt (1 bit):** A bit that specifies whether cell text is formatted according to the style specified in **itblAutoFmt** field. + +**Q - fibitAtrAlc (1 bit):** A bit that specifies whether cell text alignment is set according to the style specified in **itblAutoFmt** field. + +**R - fibitAtrBdr (1 bit):** A bit that specifies whether [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) is set according to the style specified in **itblAutoFmt** field. + +**S - fibitAtrPat (1 bit):** A bit that specifies whether the pattern is formatted according to the style specified in **itblAutoFmt** field. + +**T - fibitAtrProt (1 bit):** A bit that specifies whether the cell is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829) according to the style specified in **itblAutoFmt** field. + +**unused3 (10 bits):** Undefined and MUST be ignored. + +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +**rgchName (variable):** A [XLUnicodeString](#xlunicodestring) string that specifies the name of the query table. The number of characters in this array MUST be less than 0x00FF. Within this [workbook](#Section_f682f4b08c6b444e83f852d156f1e8ba), there MUST be a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) as specified by an [Lbl](#lbl) record with its **fHidden** field equal to 1 and its **Name** field matching this field’s value and the **rgce** field only containing a [PtgArea3d](#ptgarea3d) referencing the range of cells for the query table fields. Spaces within **rgchName** are converted to underscores for the purposes of this comparison. + +**unused4 (2 bytes):** Undefined and MUST be ignored. + +### Qsif + +The **Qsif** record specifies the properties for a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) field. One Qsif record is stored for each query table field. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
ABCiSortKeyDEFGHreserved3
idField
idList (optional)
rgbTitle (variable)
...
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0807. + +**A - fUserIns (1 bit):** A bit that specifies whether this column was inserted into the query table. + +| Value | Meaning | +|----|----| +| 0 | The column is from the [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) source. | +| 1 | The column was inserted into the query table and is not from the external data source. | + +**B - fFillDown (1 bit):** A bit that specifies whether the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in this query table field is filled down on data [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060). + +**C - fSortDes (1 bit):** A bit that specifies whether this query table field is sorted in [**descending order**](#gt_f6de77a5-8743-4d03-813a-fa5e4d7c9fe8) if it is included as part of a [**sort range**](#gt_9d8dbd94-ffa2-47fc-a60b-3ffdad40d90e). + +**iSortKey (8 bits):** An unsigned integer that specifies the position of this query table field in the sort range. MUST be a value from the following table: + +| Value | Axis Description | +|----|----| +| 0 | This query table field does not contain [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880) criteria. | +| 1 | This query table field contains sort criteria for the first sort key as specified in the [Sort](#sort) record. | +| 2 | This query table field contains sort criteria for the second sort key as specified in the Sort record. | +| 3 | This query table field contains sort criteria for the third sort key as specified in the Sort record. | + +**D - fRowNums (1 bit):** A bit that specifies whether this query table field contains the row numbers for the data from the external data source. + +**E - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**F - fSorted (1 bit):** A bit that specifies whether this query table field is part of a sort range. + +**G - reserved2 (2 bits):** MUST be zero, and MUST be ignored. + +**H - fClipped (1 bit):** A bit that specifies whether this query table field is currently outside the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) bounds as specified in the [cell table](#Section_d690007dd25c4822a650b24c13288bb7). If the **fUserIns** field is set to 1, this field MUST be set to 0. + +**reserved3 (15 bits):** MUST be zero, and MUST be ignored. + +**idField (4 bytes):** An unsigned integer that specifies a unique identifier of this query table field in the query table. MUST be greater than or equal to 0x0001 and less than or equal to 0xFFFF. + +**idList (4 bytes):** An optional unsigned integer that specifies the value corresponding to the **idList** field of the [TableFeatureType](#tablefeaturetype) structure that is linked with this query table. This field exists only if the **verLastXLSaved** field of the [BOF](#bof) records is greater than or equal to 0x4. + +**rgbTitle (variable):** An [XLUnicodeString](#xlunicodestring) string that specifies the name of the query table field. The length of the query table field MUST less than or equal to 0x00FF. + +### Qsir + +The **Qsir** record specifies the properties related to the formatting of a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289), and specifies the beginning of a collection of [Qsif](#qsif) records as defined by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of Qsif records specifies properties for a query table field. + +One Qsir record is stored for each query table + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtRefHeaderU
...
...
cbQsirSavedcbQsifSaved
ABCreserved1DEFGHIJwVerBeforeRefreshAlertK
iSortCustom
cQsif
cpstDeleted
idFieldNext
ccolExtraLeftccolExtraRight
idList (optional)
rgbTitle (variable)
...
+ +**frtRefHeaderU (12 bytes):** An [FrtRefHeaderU](#frtrefheaderu) structure. The **frtRefHeaderU.rt** field MUST be 0x0806. The **frtRefHeaderU.grbitFrt.fFrtRef** field MUST be 1 and the **frtRefHeaderU.ref8** field MUST refer to the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with this record. + +**cbQsirSaved (2 bytes):** An unsigned integer that specifies the number of bytes in the Qsir record excluding the **frtRefHeaderU** , **cbQsirSaved**, and **cbQsifSaved** fields. + +**cbQsifSaved (2 bytes):** An unsigned integer that specifies the size in bytes of each Qsif record that follows this Qsir record. This value MUST be less than the difference between the size in bytes for the Qsif record and the size in bytes of the **frtHeaderOld** field in the same record. + +**A - fPersist (1 bit):** A bit that specifies whether sorting, filtering, and layout is preserved for this query table after data [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) operations. + +**B - fPersistSort (1 bit):** A bit that specifies whether the sorting is preserved for this query table after data refresh operations. MUST be equal to **fPersist**. + +**C - fPersistAutoFilter (1 bit):** A bit that specifies whether [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) is preserved for this query table after data refresh operations. MUST be equal to **fPersist**. + +**reserved1 (16 bits):** MUST be zero, and MUST be ignored. + +**D - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**E - fSorted (1 bit):** A bit that specifies whether a [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880) was applied for this query table. + +**F - fCaseSensSort (1 bit):** A bit that specifies whether the sort on the query table is case-sensitive. + +**G - fHdrRowSort (1 bit):** A bit that specifies whether the query table sort accounted for a [**header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38). + +**H - fidWrapped (1 bit):** A bit that specifies whether the **idFieldNext** field value has exceeded its upper-bound value (0xFFFF). + +**I - reserved3 (1 bit):** MUST be zero, and MUST be ignored. + +**J - fTitlesOld (1 bit):** A bit that specifies whether the query table had titles the last time it was refreshed. + +**wVerBeforeRefreshAlert (5 bits):** An unsigned integer that specifies the oldest version of the application that is expected to correctly refresh the data in the query table without any errors. MUST be less than or equal to 0x000C. The application version is a value specified in the following table: + +| Value | Application Version | +|----|----| +| 0x0008 | Specifies the application version.[\<106\>](#Appendix_A_106) | +| 0x0009 | Specifies the application version.[\<107\>](#Appendix_A_107) | +| 0x000A | Specifies the application version.[\<108\>](#Appendix_A_108) | +| 0x000B | Specifies the application version.[\<109\>](#Appendix_A_109) | +| 0x000C | Specifies the application version.[\<110\>](#Appendix_A_110) | +| 0x000E | Specifies the application version.[\<111\>](#Appendix_A_111) | +| 0x000F | Specifies the application version.[\<112\>](#Appendix_A_112) | + +**K - reserved4 (1 bit):** MUST be zero, and MUST be ignored. + +**iSortCustom (4 bytes):** An unsigned integer that specifies the zero-based index of the [**custom list**](#gt_92d2bb3a-2615-4bf8-b87f-887302d4c40c) that specifies the [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7). The set of custom lists is based on the current user's environment. + +**cQsif (4 bytes):** An unsigned integer that specifies the count of Qsif records that immediately follow this Qsir record. + +**cpstDeleted (4 bytes):** An unsigned integer that specifies the number of elements in the **rgbTitle** array. + +**idFieldNext (4 bytes):** An unsigned integer that specifies the next unique number available for assignment to a newly created Qsif record. MUST be greater than or equal to 0x0001 and less than or equal to 0xFFFF. + +**ccolExtraLeft (2 bytes):** A [DCol](#dcol) structure that specifies the number of columns that do not contain [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) that are included at the beginning of the query table by resizing. When a sort is applied to the query table, they are also applied to these columns. + +**ccolExtraRight (2 bytes):** A DCol structure that specifies the number of columns that do not contain external data that are included at the end of the query table by resizing. When a sort is applied to the query table, they are also applied to these columns. + +**idList (4 bytes):** An optional unsigned integer that specifies the value corresponding to the **idList** field of the [TableFeatureType](#tablefeaturetype) structure that is linked with this query table. This field exists only if the **verLastXLSaved** field of the [BOF](#bof) record is greater than or equal to 0x3. + +**rgbTitle (variable):** An array of [XLUnicodeString](#xlunicodestring) structures. This array specifies the names of the database fields in the database [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) that are not included in the query table. The number of elements in this array MUST be equal to the value of the **cpstDeleted** field. The count of characters in each name MUST be greater than or equal to 0x0001 and less than or equal to 0x00FF. + +### QsiSXTag + +The **QsiSXTag** record specifies the name and [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) information for a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) or a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), and specifies the beginning of a collection of records as defined by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies additional information for a query table or a PivotTable view. + +If **fSx** is 0 and **stName** is equal to the **rgchName** field of a [Qsi](#qsi) record in this worksheet substream, then this collection of records applies to the query table that the Qsi record is associated with. If **fSx** is 1 and **stName** is equal to the **stName** field of an [SxView](#sxview) record in this worksheet substream, then this collection of records applies to the PivotTable view that the SxView record is associated with and its [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4). Otherwise, this collection of records MUST be ignored. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
fSxABCreserved1
dwQsiFuture
verSxLastUpdatedverSxUpdatableMinobCchNamereserved2
stName (variable)
...
unused
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0802. + +**fSx (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether this record relates to a PivotTable view or a query table. + +| Value | Meaning | +|--------|----------------------------------------------------------| +| 0x0000 | Specifies that this record relates to a query table. | +| 0x0001 | Specifies that this record relates to a PivotTable view. | + +**A - fEnableRefresh (1 bit):** A bit that specifies whether refresh of the PivotTable view or query table is enabled. MUST be 0 if **fSx** is 1 and the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated PivotCache is greater than or equal to 3. + +| Value | Value of fSx | Meaning | +|----|----|----| +| 0 | 0 | Whether refresh of the query table is enabled is specified by the fDisableRefresh field of the associated Qsi record. | +| 0 | 1 | Whether refresh of the associated PivotCache is enabled is specified by the fEnableRefresh field in the [SXDB](#sxdb) record of the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). | +| 1 | 0 | Specifies that refresh of the query table is enabled. | +| 1 | 1 | Specifies that refresh of the associated PivotCache is enabled. | + +**B - fInvalid (1 bit):** A bit that specifies the invalid state of the [cache records](#Section_fe6e4ca0a9b646a4898124e4b61a770a) of the associated PivotCache; see Cache Records for more information. MUST be 1 if **fSx** is 1 and the PivotCache functionality level of the associated PivotCache is greater than or equal to 3. + +**C - fTensorEx (1 bit):** A bit that specifies whether the PivotTable view is an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f). MUST be equal to 0 if fSx is 0. + +**reserved1 (13 bits):** MUST be zero, and MUST be ignored. + +**dwQsiFuture (4 bytes):** This structure specifies additional option flags for a query table or a PivotTable view depending on the value of the **fSx** field. + +| Value of fSx Field | Type of dwQsiFuture | +|--------------------|-----------------------------| +| 0x0000 | [DwQsiFuture](#dwqsifuture) | +| 0x0001 | [SXView9Save](#sxview9save) | + +**verSxLastUpdated (1 byte):** A [DataFunctionalityLevel](#datafunctionalitylevel) value that specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) that the PivotTable view was last refreshed with. MUST be 0 if this record relates to a query table. + +**verSxUpdatableMin (1 byte):** A DataFunctionalityLevel value that specifies the minimum version of the application that can recalculate the PivotTable view. MUST be 0x00 or 0x03. MUST be 0 if this record is for a query table. MUST be 3 if the PivotCache functionality level of the associated PivotCache is 3. + +**obCchName (1 byte):** MUST be 0x10, and MUST be ignored. + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +**stName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the query table or PivotTable view name. + +**unused (2 bytes):** Undefined and MUST be ignored. + +### Radar + +The **Radar** record specifies that the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is a radar chart group and specifies the chart group attributes. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABreservedunused
+ +**A - fRdrAxLab (1 bit):** A bit that specifies whether [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) labels are displayed. + +**B - fHasShadow (1 bit):** A bit that specifies whether one or more [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) in the chart group has shadows. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +**unused (2 bytes):** Undefined and MUST be ignored. + +### RadarArea + +The **RadarArea** record specifies that the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is a filled radar chart group and specifies the chart group attributes. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABreservedunused
+ +**A - fRdrAxLab (1 bit):** A bit that specifies whether [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) labels are displayed. + +**B - fHasShadow (1 bit):** A bit that specifies whether the [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) in the chart group have shadows. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +**unused (2 bytes):** Undefined and MUST be ignored. + +### RealTimeData + +The **RealTimeData** record specifies the [**real-time data (RTD)**](#gt_1e71aa16-cd0f-4271-b57d-1fd99d8740b6) information for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +There is one RealTimeData record for each [**RTD topic**](#gt_1b5b3428-25ab-4aa9-bbee-c1c147ece9de) in the workbook. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
ichSamePrefix
stTopic (variable)
...
rtdOper (variable)
...
rgRTDE (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0813. + +**ichSamePrefix (4 bytes):** An unsigned integer that specifies the number of leading characters in common with the **stTopic** string in the previous RealTimeData record. MUST be 0 if there is no prefix in common or if this is the first RealTimeData record. + +**stTopic (variable):** An [XLUnicodeStringSegmentedRTD](#xlunicodestringsegmentedrtd) structure that specifies the string for the RTD topic specified by this record. The string can be stored in a compressed or uncompressed format. When **ichSamePrefix** is greater than 0, this string does not include any leading characters that are in common with the **stTopic** string in the previous RealTimeData record. The first substring specifies the [**ProgID**](#gt_06b2ae3d-4106-49f3-9ca0-e2bcd649e75a) of the [**RTD server**](#gt_d4fc2cb5-c030-4ce4-9078-69627d562fc7). The second substring specifies the [**server name**](#gt_854f54be-1a9d-40d2-82e5-55cf9e48e2c2) that the RTD server is running on or, if this substring is empty, specifies that the RTD server is running locally. The rest of the substrings are combined to form a unique RTD topic. + +**rtdOper (variable):** An [RTDOper](#rtdoper) structure that specifies the data returned by the RTD server. + +**rgRTDE (variable):** An array of [RTDEItem](#rtdeitem) structures that specifies the set of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with the RTD topic. The length of the array is specified by the following formula: + +Array length = (size of this record and associated [ContinueFrt](#continuefrt) records - 16 - size of **stTopic** – size of **rtdOper**) / 6 + +### RecalcId + +The **RecalcId** record specifies the identifier of the recalculation engine that performed the last recalculation. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rtreserved
dwBuild
+ +**rt (2 bytes):** An unsigned integer that specifies the record identifier. MUST be 449. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**dwBuild (4 bytes):** An unsigned integer that specifies the identifier of the recalculation engine that performed the last recalculation. If the value is less than the recalculation engine identifier associated with the application, the application will [**recalculate**](#gt_74366612-1dc4-4e8f-8e1a-d833b829f0c3) the results of all formulas on this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) immediately after loading the file. + +### RecipName + +The **RecipName** record specifies information about a recipient of a [**routing slip**](#gt_8cedfe36-260c-416e-aeab-7fee4bdef9c3)[\<113\>](#Appendix_A_113). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cchRecipulEIDSize
...szFriendly (variable)
...
rgchSSAddr (variable)
...
+ +**cchRecip (2 bytes):** An unsigned integer that specifies the count of characters in the **szFriendly** field string. MUST be less than or equal to 256. + +**ulEIDSize (4 bytes):** An unsigned integer that specifies the count of characters in the **rgchSSAddr** field string. + +**szFriendly (variable):** A NULL-terminated array of ANSI characters that specifies the recipient's [**friendly name**](#gt_3dafc161-8c9d-406a-8cbd-c61e7f925eea). The length of the string MUST be specified by the **cchRecip** field. + +**rgchSSAddr (variable):** An array of ANSI characters whose length is specified by the **ulEIDSize** field that specifies the identifier used by the [**messaging system service provider**](#gt_ff288e35-3b60-4a5e-99d6-faa6afa8009a) to identify the recipient. + +### RefreshAll + +The **RefreshAll** record specifies whether [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) ranges, [PivotTables](#Section_a5f57198f2af40b2ba07e4b1836d73f3) and [**XML maps**](#gt_01b93f1f-ca62-4216-82d5-b6154e925c9f) will be refreshed on [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) load. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
refreshAll
+ +**refreshAll (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether to force [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) of external data ranges, PivotTables and XML maps on workbook load. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0001 | Force refresh of external data ranges, PivotTables and XML maps on workbook load. | +| 0x0000 | Do not force refresh of external data ranges, PivotTables and XML maps on workbook load. | + +MUST be 0x0000 if workbook is not a [**template**](#gt_159ca22f-c24d-4c6d-b08a-3d4c4c923953). + +### RichTextStream + +The **RichTextStream** record specifies additional text properties for the text in the entire [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), text in the current [legend](#Section_1832229b7d1945f488d455e9c07466f0), text in the current [**legend entry**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e), or text in the [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a). These text properties are a superset of the properties stored in the [Text](#text), [Font](#font), [FontX](#fontx), [BRAI](#brai), and [ObjectLink](#objectlink) records based on the following table, as specified by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). In each case, the associated Font record is specified by the associated FontX record. [\<114\>](#Appendix_A_114) + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Rule Containing the RichTextStream recordMeaning
CHARTFORMATS

Specifies additional Rich Text Format properties for the text of the entire chart.

+

The associated Text and FontX records are contained in the attached label that is contained in the first sequence of records that conforms to the DFTTEXT rule in the chart, and not contained in the chart group.

LD

Specifies additional Rich Text Format properties for text in the current legend.

+

The associated Text and FontX records are contained in the sequence of records that conforms to the ATTACHEDLABEL rule that is contained in the sequence of records that conforms to the LD rule.

SERIESFORMAT

Specifies additional Rich Text Format properties for the current legend entry.

+

The associated Text and FontX records are contained in the sequence of records that conforms to the ATTACHEDLABEL rule that immediately precedes this record in the sequence of records that conforms to the SERIESFORMAT rule.

+

The associated BRAI record is contained in the sequence of records that conforms to the AI rule that is contained in the sequence of records that conforms to the SERIESFORMAT rule.

ATTACHEDLABEL

Specifies additional Rich Text Format properties for the text in the attached label.

+

The associated Text and FontX records are contained in the sequence of records that conforms to the ATTACHEDLABEL rule.

+

The associated BRAI record is contained in the sequence of records that conforms to the ATTACHEDLABEL rule.

+

The associated ObjectLink record is contained in the sequence of records that conforms to the ATTACHEDLABEL rule.

+ +These Rich Text Format properties are stored in the **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)) specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, section 21.2.2.216. + +An application can choose to ignore this record without loss of functionality, but will lose access to the additional Rich Text Format properties. If an application chooses to implement this record, the application MUST implement the validation [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) specified by the **dwCheckSum** field. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
dwCheckSum
cb
rgb (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x08A6. + +**dwCheckSum (4 bytes):** An unsigned integer that specifies the checksum of the attributes of the Rich Text Format properties related to this record. The algorithm used to calculate the checksum is specified by [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.4.3.2. The checksum MUST be calculated from every property of the [**property stream**](#gt_dbd8bc67-1371-445e-af6a-dfa5eeef670c), taken as an array of bytes as specified by the [RichTextStreamChecksumData](#richtextstreamchecksumdata) structure. + +The information required to build the memory stream can be gathered from the Text, FontX, Font, BRAI, and ObjectLink records associated with this record, as previously specified. + +When reading this record, the checksum is calculated as previously specified and compared to the **dwCheckSum** value stored in this record. If the calculated checksum does not match the **dwCheckSum** data, the application MUST assume that the **XML stream** (section 2.1.7.22) is out of date, and the data from the associated records MUST be used instead of the data specified by the **XML stream** (section 2.1.7.22). + +**cb (4 bytes):** An unsigned integer that specifies the size of the **rgb** field. This field MUST contain the exact length in bytes of the **rgb** field. + +**rgb (variable):** An array of ANSI characters that contains the [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) representation of the text formatting properties, as defined in \[ECMA-376\] Part 1, section 21.2.2.216. The length of this field is specified by the **cb** field. + +### RightMargin + +The **RightMargin** record specifies the right margin of the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
num
...
+ +**num (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the right margin of the current sheet in inches. The value MUST be greater than or equal to 0 and less than or equal to 49. + +### RK + +The **RK** record specifies the numeric data contained in a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwcol
rkrec
...
+ +**rw (2 bytes):** An [Rw](#rw) structure that specifies a row index. + +**col (2 bytes):** A [Col](#col) structure that specifies a column index. + +**rkrec (6 bytes):** An [RkRec](#rkrec) structure that specifies the numeric data for a single cell. + +### Row + +The **Row** record specifies a single row on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwcolMic
colMacmiyRw
reserved1unused1
ABCDEFreserved3ixfe_valGHIJ
+ +**rw (2 bytes):** An [Rw](#rw) structure that specifies the row index. + +**colMic (2 bytes):** An unsigned integer that specifies the zero-based index of the first column that contains a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) populated with data or formatting in the current row. MUST be less than or equal to 255. + +**colMac (2 bytes):** An unsigned integer that specifies the one-based index of the last column that contains a cell populated with data or formatting in the current row. MUST be less than or equal to 256. If **colMac** is equal to **colMic**, this record specifies a row with no [CELL](#common-productions) records. + +**miyRw (2 bytes):** An unsigned integer that specifies the row height in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382). If **fDyZero** is 1, the row is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) and the value of **miyRw** specifies the original row height. MUST be greater than or equal to 2 and MUST be less than or equal to 8192. + +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**A - iOutLevel (3 bits):** An unsigned integer that specifies the [**outline level**](#gt_a5cd5eff-ddeb-490b-bc71-f6256774e3c3) of the row. + +**B - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fCollapsed (1 bit):** A bit that specifies whether the rows that are one level of outlining deeper than the current row are included in the [**collapsed outline state**](#gt_37d20510-d4a0-4fa6-9ff1-83d99d8f9262). + +**D - fDyZero (1 bit):** A bit that specifies whether the row is hidden. + +**E - fUnsynced (1 bit):** A bit that specifies whether the row height was manually set. + +**F - fGhostDirty (1 bit):** A bit that specifies whether the row was formatted. + +**reserved3 (1 byte):** MUST be 1, and MUST be ignored. + +**ixfe_val (12 bits):** An unsigned integer that specifies an [XF](#xf) record for the row formatting. See [IXFCell](#ixfcell) for more information. If **fGhostDirty** is 0, **ixfe_val** is undefined and MUST be ignored. + +**G - fExAsc (1 bit):** A bit that specifies whether any cell in the row has a thick top [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c), or any cell in the row directly above the current row has a thick bottom border. Thick borders are specified by the following enumeration values from [BorderStyle](#borderstyle): **THICK** and **DOUBLE**. + +**H - fExDes (1 bit):** A bit that specifies whether any cell in the row has a medium or thick bottom border, or any cell in the row directly below the current row has a medium or thick top border. Thick borders are previously specified. Medium borders are specified by the following enumeration values from BorderStyle: **MEDIUM**, **MEDIUMDASHED**, **MEDIUMDASHDOT**, **MEDIUMDASHDOTDOT**, and **SLANTDASHDOT**. + +**I - fPhonetic (1 bit):** A bit that specifies whether the [**phonetic guide**](#gt_f5ae2680-242d-4731-8f12-da90d5d7f09f) feature is enabled for any cell in this row. + +**J - unused2 (1 bit):** Undefined and MUST be ignored. + +### RRAutoFmt + +The **RRAutoFmt** record specifies the changes caused by [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f) actions in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rrd (14 bytes)
...
...
...ref8
...
...itbl
ABCDEFreserved
+ +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a shared workbook. The **rrd.revid** MUST be 0 because this is a [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) that cannot be reviewed. The **rrd.revt** MUST be equal to 0x000C. The **rrd.tabid** MUST NOT be 0xFFFF because this revision corresponds to a specific [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**ref8 (8 bytes):** A [Ref8U](#ref8u) structure that specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells affected by AutoFormat changes. + +**itbl (2 bytes):** An [AutoFmt8](#autofmt8) structure that specifies which AutoFormat was applied. + +**A - fApplyNumberFormats (1 bit):** A bit that specifies whether the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) properties contained in the AutoFormat specified by **itbl** were applied. + +**B - fApplyFontFormats (1 bit):** A bit that specifies whether the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) properties contained in the AutoFormat specified by **itbl** were applied. + +**C - fApplyAlignmentFormats (1 bit):** A bit that specifies whether the text alignment properties contained in the AutoFormat specified by **itbl** were applied. + +**D - fApplyBorderFormats (1 bit):** A bit that specifies whether the [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) properties contained in the AutoFormat specified by **itbl** were applied. + +**E - fApplyPatternFormats (1 bit):** A bit that specifies whether the color pattern properties contained in the AutoFormat specified by **itbl** were applied. + +**F - fApplyWidthHeightFormats (1 bit):** A bit that specifies whether the width or height properties contained in the AutoFormat specified by **itbl** were applied. + +**reserved (10 bits):** MUST be zero, and MUST be ignored. + +### RRDChgCell + +The **RRDChgCell** record specifies a [change cells revision](#Section_5184d2e269654093971afeb70ff736cb). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rrd (14 bytes)
...
...
...vtvtOldABCDEFGHI
ifmtDispJKLreserved2loc
...cbOldVal
...cetxpRst
dxfOld (variable)
...
dxf (variable)
...
rkOld (optional)
numOld (optional)
...
stOld (variable)
...
besOld (optional)xpeOld (variable)
...
rk (optional)
num (optional)
...
st (variable)
...
bes (optional)xpe (variable)
...
+ +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). Because this [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) corresponds to a specific [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d), **rrd**.**revt** MUST be 0x0008, **rrd**.**fDelAtEdgeOfSort** MUST be 0x0000, **rrd**.**revid** MUST be greater than or equal to 0, and **rrd**.**tabid** MUST NOT be 0xFFFF. + +**vt (3 bits):** An unsigned integer that specifies the type of the new [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) contents. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | New cell is blank. | +| 0x1 | New cell contains an [RkNumber](#rknumber) value. | +| 0x2 | New cell contains an Xnum (section [2.5.342](#xnum)) value. | +| 0x3 | New cell contains an [XLUnicodeRichExtendedString](#xlunicoderichextendedstring) value. | +| 0x4 | New cell contains a [Bes](#bes) value. | +| 0x5 | New cell contains a [CellParsedFormula](#cellparsedformula) value. | + +**vtOld (3 bits):** An unsigned integer that specifies the type of the old cell contents. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------------| +| 0x0 | Old cell is blank. | +| 0x1 | Old cell contains an RkNumber value. | +| 0x2 | Old cell contains an Xnum value. | +| 0x3 | Old cell contains an XLUnicodeRichExtendedString value. | +| 0x4 | Old cell contains a Bes value. | +| 0x5 | Old cell contains a CellParsedFormula value. | + +**A - f123Prefix (1 bit):** A bit that specifies whether prefix characters are present in the cell. Possible prefix characters include single quotation mark (0x27), double quotation mark (0x22), caret (0x5E), and backslash (0x5C). + +**B - unused (1 bit):** Undefined and MUST be ignored. + +**C - fOldFmt (1 bit):** A bit that specifies whether there is old formatting information available for this cell. If **fOldFmt** is 0x1 and **fOldFmtNull** is 0x0, **dxfOld** MUST exist. + +**D - fOldFmtNull (1 bit):** A bit that specifies whether the old formatting information is empty. This value MUST be ignored if **fOldFmt** is 0. If **fOldFmt** is 0x1 and **fOldFmtNull** is 0x0, **dxfOld** MUST exist. If **fOldFmt** is 0x1 and **fOldFmtNull** is 0x1, old formatting information is available for the cell, but the old formatting information is not written to disk and **dxfOld** MUST NOT exist. + +**E - fXfDxf (1 bit):** A bit that specifies that the affected cells will have their format reset to the format defined by the current [cell style](#Section_f9425d3f127545be8389bf80f65b56b7) before applying any format from **dxf**, if present. + +**F - fStyXfDxf (1 bit):** A bit that specifies that the format of the cell will be cleared before applying any format from **dxf**, if present. + +**G - fDxf (1 bit):** A bit that specifies whether there was a formatting change for this cell. If **fDxf** is 0x1 and **fDxfNull** is 0x0, **dxf** MUST exist. + +**H - fDxfNull (1 bit):** A bit that specifies whether the new formatting information is empty. This value MUST be ignored if **fDxf** is 0. If **fDxf** is 0x1 and **fDxfNull** is 0x0, **dxf** MUST exist. If **fDxf** is 0x1 and **fDxfNull** is 0x1, this means that there was a formatting change for this cell, but the **dxf** describing the formatting change MUST NOT exist. + +**I - reserved1 (2 bits):** MUST be zero, and MUST be ignored. + +**ifmtDisp (8 bits):** An unsigned integer that specifies the identifier of the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) to use to display the new cell contents. MUST be a value from the following table. For more information about how [**format strings**](#gt_07085e26-506a-4b35-81ad-972464e277ff) are interpreted, see [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1: Fundamentals And Markup Language Reference, section 18.8.31. + +| Value | Description | Positive Value Format | Negative Value Format | Zero Format | +|----|----|---:|---:|---:| +| 0x0000 | Automatic | 0 | -0 | 0 | +| 0x0004 | Number, two decimal places, use the 1000 separator (,) | \#,##0.00 | -#,##0.00 | 0.00 | +| 0x000B | Currency, two decimal places, use parentheses for negative values | \$#,##0.00 | (\$#,##0.00) | \$0.00 | +| 0x000D | Percentage, zero decimal places | 0% | -0% | 0% | +| 0x000E | Percentage, two decimal places | 0.00% | -0.00% | 0.00% | +| 0x000F | Scientific | 0.00E+00 | -0.00E+00 | 0.00E+00 | +| 0x0010 | Engineering | \##0.0E+0 | -##0.0E+0 | 0.0E+0 | +| 0x0011 | Fraction, up to one digit numerator and denominator | \# ?/? | -# ?/? | 0 | +| 0x0012 | Fraction, up to two digit numerator and denominator | \# ??/?? | -# ??/?? | 0 | +| 0x0013 | Date (MM-DD-YY) | mm-dd-yy | mm-dd-yy | | +| 0x0015 | Date (DD-MMM) | d-mmm | d-mmm | | +| 0x0017 | Time (H:MM AM/PM) | h:mm AM/PM | h:mm AM/PM | | +| 0x001B | Date/Time, 24 hour format (M/D/YY H:MM) | m/d/yy h:mm | m/d/yy h:mm | | +| 0x0022 | Accounting (currency with decimal point aligned, and centered minus-sign for 0-value), two decimal places, use currency symbol | \_(\$\* \#,##0.00\_) | \_(\$\* \#,##0.00) | \_(\$\* "-" ??\_) | + +**J - fPhShow (1 bit):** A bit that specifies whether the new cell contains a [**phonetic string**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77). + +**K - fPhShowOld (1 bit):** A bit that specifies whether the old cell contains a phonetic string. + +**L - fEOLFmlaUpdate (1 bit):** A bit that specifies whether the new cell contents were changed because of an adjustment to the formula. + +**reserved2 (5 bits):** MUST be zero, and MUST be ignored. + +**loc (4 bytes):** An [RgceLoc](#rgceloc) structure that specifies the location of the cell change revision. + +**cbOldVal (4 bytes):** An unsigned integer that specifies the size of the old cell contents. If **cbOldVal** is greater than 0, the old cell contents immediately follow the **cetxpRst** field, then it is followed by the new cell contents. MUST be a value from the following table based on the value of **vtOld**: + +| vtOld | cbOldVal | +|----|----| +| 0x0 | MUST be 0x00000000. | +| 0x1 | MUST be 0x00000004. | +| 0x2 | MUST be 0x00000008. | +| 0x3 | MUST be equal to the size of the old XLUnicodeRichExtendedString. The size is calculated assuming all characters are double-byte characters. That is, if XLUnicodeRichExtendedString.**fHighByte** is 1, the calculation is made by using the size of XLUnicodeRichExtendedString. | +| 0x4 | MUST be 0x00000002. | +| 0x5 | MUST be greater than or equal to 0x00000018. | + +**cetxpRst (2 bytes):** An unsigned integer that specifies the number of [RRDRstEtxp](#rrdrstetxp) records that follow this record. + +**dxfOld (variable):** A [DXFN](#dxfn) structure that specifies the [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6) for the old cell contents. This field MUST exist if **fOldFmt** is 0x1 and **fOldFmtNull** is 0x0. + +**dxf (variable):** A DXFN structure that specifies the differential formatting for the new cell contents. This field MUST exist if **fDxf** is 0x1 and **fDxfNull** is 0x0. + +**rkOld (4 bytes):** An RkNumber structure that specifies the old cell contents. This field MUST exist if and only if **cbOldVal** is greater than 0 and **vtOld** is 0x1. + +**numOld (8 bytes):** An Xnum value that specifies the old cell contents. This field MUST exist if and only if **cbOldVal** is greater than 0 and **vtOld** is 0x2. + +**stOld (variable):** An XLUnicodeRichExtendedString structure that specifies the old cell contents. This field MUST exist if and only if **cbOldVal** is greater than 0 and **vtOld** is 0x3. + +**besOld (2 bytes):** A Bes structure that specifies the old cell contents. This field MUST exist if and only if **cbOldVal** is greater than 0 and **vtOld** is 0x4. + +**xpeOld (variable):** A CellParsedFormula structure that specifies the old cell contents. This field MUST exist if and only if **cbOldVal** is greater than 0 and **vtOld** is 0x5. + +**rk (4 bytes):** An RkNumber value that specifies the new cell contents. This field MUST exist if and only if **vt** is 0x1. + +**num (8 bytes):** An Xnum value that specifies the new cell contents. This field MUST exist if and only if **vt** is 0x2. + +**st (variable):** An XLUnicodeRichExtendedString structure that specifies the new cell contents. This field MUST exist if and only if **vt** is 0x3. + +**bes (2 bytes):** A Bes structure that specifies the new cell contents. This field MUST exist if and only if **vt** is 0x4. + +**xpe (variable):** A CellParsedFormula structure that specifies the new cell contents. This field MUST exist if and only if **vt** is 0x5. + +### RRDConflict + +The **RRDConflict** record specifies the resolution of a conflict between the revisions of two uses'. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rrd (14 bytes)
...
...
...
+ +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). The **rrd.revid** MUST be greater than 0. The **rrd.revid** identifies the [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) that won the conflict. The **rrd.revt** MUST be equal to [**revtConflict**](#revisiontype). + +### RRDDefName + +The **RRDDefName** record specifies a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) revision. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rrd (14 bytes)
...
...
...tabidLocal
fViewNamereservedgrbit
...
grbitOld
...builtinIndexunused (optional)
...stDefName (variable)
...
pe (variable)
...
stCustomMenu (variable)
...
stDescription (variable)
...
stHelpTopic (variable)
...
stStatusText (variable)
...
peOld (variable)
...
stCustomMenuOld (variable)
...
stDescriptionOld (variable)
...
stHelpTopicOld (variable)
...
stStatusTextOld (variable)
...
+ +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). The **revt** field of the RRD structure MUST be 0x000A or 0x0022. The **fDelAtEdgeOfSort** field of the RRD structure MUST be 0x0000. The **revid** field of the RRD structure MUST be greater than or equal to 0. + +**tabidLocal (2 bytes):** A [TabId](#tabid) structure that specifies the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing the defined name. A value of 0xFFFF specifies that the defined name is not a [**local name**](#gt_6f2787cc-ab35-4cc1-bebd-fb120864d320). + +**fViewName (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether the defined name belongs to a [**custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4). MUST be a value from the following table: + +| **Value** | **Meaning** | +|-----------|----------------------------------------------------| +| 0x00 | The defined name does not belong to a custom view. | +| 0x01 | The defined name belongs to a custom view. | + +**reserved (1 byte):** MUST be zero, and MUST be ignored. + +**grbit (6 bytes):** An [RRDDefNameFlags](#rrddefnameflags) structure that specifies data for the new defined name. + +**grbitOld (6 bytes):** An RRDDefNameFlags structure that specifies data for the old defined name. + +**builtinIndex (1 byte):** An unsigned integer that specifies the identifier of a built-in name. MUST be a value from the following table: + +| Identifier | Built-in Name | +|------------|---------------------| +| 0x00 | Not a built-in name | +| 0x01 | "Consolidate_Area" | +| 0x02 | "Auto_Open" | +| 0x03 | "Auto_Close" | +| 0x04 | "Extract" | +| 0x05 | "Database" | +| 0x09 | "Recorder" | +| 0x0A | "Data_Form" | +| 0x0B | "Auto_Activate" | +| 0x0C | "Auto_Deactivate" | +| 0x0D | "Sheet_Title" | + +**unused (3 bytes):** Optional, undefined, and MUST be ignored. MUST exist if and only if **builtinIndex** is not equal to 0. + +**stDefName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the defined name. MUST exist if and only if **builtinIndex** is equal to 0. MUST be less than or equal to 255 characters. MUST begin with a letter or underscore character. + +**pe (variable):** A [NameParsedFormula](#nameparsedformula) structure that specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) of the new defined name. The length of the formula in bytes is specified by **grbit**.**cce**. + +**stCustomMenu (variable):** An XLUnicodeString structure that specifies the new custom menu text. + +**stDescription (variable):** An XLUnicodeString structure that specifies the new description text. + +**stHelpTopic (variable):** An XLUnicodeString structure that specifies the new help text. + +**stStatusText (variable):** An XLUnicodeString structure that specifies the new status bar text. + +**peOld (variable):** A NameParsedFormula structure that specifies the formula of the old defined name. The length of the formula in bytes is specified by **grbitOld**.**cce**. + +**stCustomMenuOld (variable):** An XLUnicodeString structure that specifies the old custom menu text. + +**stDescriptionOld (variable):** An XLUnicodeString structure that specifies the old description text. + +**stHelpTopicOld (variable):** An XLUnicodeString structure that specifies the old help text. + +**stStatusTextOld (variable):** An XLUnicodeString structure that specifies the old status bar text. + +### RRDHead + +The **RRDHead** record specifies metadata about a set of revisions that a user has made in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rrd (14 bytes)
...
...
...guid (16 bytes)
...
...
...wFileCodePage
cchUserstUser (114 bytes)
...
...
...
sddtr
...
tabidMac
+ +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a shared workbook. The **rrd.revt** MUST be equal to 0x0020. The **rrd.cbMemory** MUST be equal to 0xFFFFFFFF and MUST be ignored. The **rrd.revid** MUST be 0 because this is a [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) that cannot be reviewed. + +**guid (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that specifies a unique identifier for this set of revisions. + +**wFileCodePage (2 bytes):** An unsigned integer that specifies the [**sheet's**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38). The value MUST be one of the code page values specified in [\[CODEPG\]](https://go.microsoft.com/fwlink/?LinkId=89840) or the special value 1200, which means that the sheet is [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8). + +**cchUser (2 bytes):** An unsigned integer that specifies the number of characters in **stUser** that are used to specify the name of the user who made this set of revisions. Characters in **stUser** that are to the right of these used characters are ignored. The value of **cchUser** MUST be less than or equal to 54. + +**stUser (114 bytes):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of the user who made this set of revisions. + +**sddtr (8 bytes):** A [ShortDTR](#shortdtr) structure that specifies the date and time when the user saved this set of revisions. + +**tabidMac (2 bytes):** A signed integer that specifies the next available sheet identifier in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The value MUST be greater than or equal to -1. Each sheet identifier is specified by the order in which the [BoundSheet8](#boundsheet8) records appear in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +### RRDInfo + +The **RRDInfo** record specifies information about a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
wXLVerreserved1
ABCDEreserved2guid (16 bytes)
...
...
...guidRoot (16 bytes)
...
...
...revid
...version
...FGreserved3
wRevHistoryInterval
+ +**wXLVer (2 bytes):** An unsigned integer that specifies the major [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) version that was last used to save a shared workbook. + +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +**A - fssShared (1 bit):** A bit that specifies whether this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is a shared workbook. If this value is 1, **fssExclusive** MUST be equal to 0. + +**B - fssDiskHasRev (1 bit):** A bit that specifies whether the [**revision history**](#gt_3ff09b0f-14fb-44b7-bfc7-675c39a2da1e) on disk contains revisions. If this value is 1, **fssRevTrack** MUST be equal to 1. + +**C - fssRevHist (1 bit):** A bit that specifies whether revisions are automatically deleted. If this value is 1, **fssRevTrack** MUST be equal to 1. MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------------| +| 0 | Revisions are not automatically deleted. | +| 1 | Revisions are automatically deleted. | + +**D - fssRevTrack (1 bit):** A bit that specifies whether the revisions are being tracked. If this value is 1, **fssShared** MUST be equal to 1. + +**E - fssExclusive (1 bit):** A bit that specifies whether this workbook is in exclusive mode. Exclusive mode means the workbook was shared when revisions were made, but it is no longer shared. If this value is 1, **fssShared** MUST be equal to 0. + +**reserved2 (11 bits):** MUST be zero, and MUST be ignored. + +**guid (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that specifies the last set of revisions. MUST be 0, or MUST match the GUID for the most recent header. + +**guidRoot (16 bytes):** A GUID as specified by \[MS-DTYP\] that specifies the last set of revisions that was saved to the file. MUST be 0, or MUST match the GUID for one of the [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) headers. + +**revid (4 bytes):** A signed integer that specifies the current revision number of this shared workbook. This identifier is used to track the order of [revision records](#Section_9e91e8bce4f249b897d4741481349d1b). MUST be greater than or equal to 0. + +**version (4 bytes):** An unsigned integer that specifies the current version of this shared workbook. + +**F - fNoRevHist (1 bit):** A bit that specifies whether this workbook preserves revision history. If this value is 1, **wRevHistoryInterval** MUST be equal to 0 and **fssShared** MUST be equal to 1. If this value is 0, **wRevHistoryInterval** MUST be greater than or equal to 1. + +**G - fProtRev (1 bit):** A bit that specifies whether the revision history is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829) for this shared workbook. If this value is 1, **fssShared** MUST be equal to 1. + +**reserved3 (14 bits):** MUST be zero, and MUST be ignored. + +**wRevHistoryInterval (2 bytes):** An unsigned integer that specifies the number of days for which the revision history is stored for this workbook. MUST be less than or equal to 0x7FFF. If **fssExclusive** is equal to 1, this field MUST be ignored. + +### RRDInsDel + +The **RRDInsDel** record specifies the [insertion / deletion of rows / columns revision](#Section_6241f2cd16874b319cab2ff269a8e892) changes, and specifies the beginning of a collection of records as defined by the [Revision Stream](#Section_d120a1ffd2e6488381a507236f1994b0) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies insertions and deletions in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rrd (14 bytes)
...
...
...Areserved
refn
...
cUcr
rgDucr (variable)
...
+ +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a shared workbook. The **rrd.revid** field MUST be greater than 0. The **rrd.tabid** field MUST NOT be 0xFFFF. The **rrd.revt** field MUST be greater than or equal to 0 and less than or equal to 3. + +**A - fEndOfList (1 bit):** A bit that specifies that a row was inserted at the bottom of the filled cells [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). This field has meaning only if the **rrd.revt** field of this record is [REVTINSRW](#revisiontype). MUST be 1 if data was inserted at the bottom of the filled cells range. MUST be 0 if data was inserted or deleted in any other place. + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +**refn (8 bytes):** A [Ref8U](#ref8u) structure that specifies the range of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) affected by the insertion or deletion action. + +**cUcr (4 bytes):** An unsigned integer that specifies the number of items in **rgDucr**. + +**rgDucr (variable):** An array of [Ducr](#ducr) structures that specifies undo data to apply to an [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) for which the [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) was rejected. + +### RRDInsDelBegin + +The **RRDInsDelBegin** record specifies the beginning of a collection of records as defined by the [Revision Stream](#Section_d120a1ffd2e6488381a507236f1994b0) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a set of [Insertion / Deletion of Rows / Columns Revision](#Section_6241f2cd16874b319cab2ff269a8e892) changes. + +### RRDInsDelEnd + +The **RRDInsDelEnd** record specifies the end of a collection of records as defined by the [Revision Stream](#Section_d120a1ffd2e6488381a507236f1994b0) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a set of [Insertion / Deletion of Rows / Columns Revision](#Section_6241f2cd16874b319cab2ff269a8e892) changes. + +### RRDMove + +The **RRDMove** record represents [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information about the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that have moved. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rrd (14 bytes)
...
...
...refSrc
...
...refDst
...
...tabidSrc
cUcr
rgDucr (variable)
...
+ +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the revision record information used to track changes in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). The **rrd.revid** MUST be greater than 0. The **rrd.revt** MUST be equal to 0x0004. The **rrd.tabid** MUST NOT be 0xFFFF because this [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) corresponds to a specific [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**refSrc (8 bytes):** A [Ref8U](#ref8u) structure that specifies the original location of the range of cells that moved. + +**refDst (8 bytes):** A Ref8U structure that specifies the new location of the range of cells that moved. + +**tabidSrc (2 bytes):** A [TabId](#tabid) structure that specifies the sheet on which **refSrc** resides. + +**cUcr (4 bytes):** An unsigned integer that specifies the number of elements in **rgDucr**. + +**rgDucr (variable):** An array of [Ducr](#ducr) structures that specifies undo data that will have to be applied to an [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) if the revision is rejected. + +### RRDMoveBegin + +The **RRDMoveBegin** record specifies the beginning of a collection of records as defined by the [Revision Stream](#Section_d120a1ffd2e6488381a507236f1994b0) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies moved [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +### RRDMoveEnd + +The **RRDMoveEnd** record specifies the end of a collection of records as defined by the [Revision Stream](#Section_d120a1ffd2e6488381a507236f1994b0) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies moved [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +### RRDRenSheet + +The **RRDRenSheet** record specifies the old and new name of a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) after renaming the sheet in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rrd (14 bytes)
...
...
...cchOldName
stOldName (255 bytes)
...
...
...cchNewName
...stNewName (255 bytes)
...
...
...
+ +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a shared workbook. The **rrd.revid** MUST be greater than 0. The **rrd.revt** MUST be equal to 0x0009. The **rrd.tabid** MUST NOT be 0xFFFF. + +**cchOldName (2 bytes):** An unsigned integer that specifies the number of characters in **stOldName** that are used to specify the name of the old sheet. Characters in **stOldName** that are to the right of these used characters are ignored. If **stOldName.fHighByte** is 0, the value MUST be less than or equal to 227. If **stOldName.fHighByte** is 1, the value MUST be less than or equal to 127. + +**stOldName (255 bytes):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of the old sheet. + +**cchNewName (2 bytes):** An unsigned integer that specifies the number of characters in **stNewName** that are used to specify the name of the new sheet. Characters in **stNewName** that are to the right of these used characters are ignored. If **stNewName.fHighByte** is 0, the value MUST be less than or equal to 227. If **stNewName.fHighByte** is 1, the value MUST be less than or equal to 127. + +**stNewName (255 bytes):** An XLUnicodeStringNoCch structure that specifies the name of the new sheet. + +### RRDRstEtxp + +The **RRDRstEtxp** record specifies [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information for a [**formatting run**](#gt_10031ac8-2a26-4200-beee-cd8d9420ca96). Instances of this record MUST be preceded by an [RRDChgCell](#rrdchgcell) record that specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) containing the formatting run. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iFntcchFontNamefFullStr
stFontName (62 bytes)
...
...
...stxp (16 bytes)
...
...
...icvFore
reserved1reserved2
...
+ +**iFnt (2 bytes):** An unsigned integer that specifies the zero-based index of this record in the set of RRDRstEtxp records that have a common preceding RRDChgCell record. MUST be greater than or equal to zero and less than the **cetxpRst** field of the preceding RRDChgCell record. + +**cchFontName (1 byte):** An unsigned integer that specifies the count of double-byte [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters in **stFontName**. MUST be less than or equal to 0x1F. + +**fFullStr (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies that **stFontName** contains double-byte Unicode characters. MUST be 0x01 if **cchFontName** is greater than 0. If **cchFontName** is 0, the value of **fFullStr** is undefined and MUST be ignored. + +**stFontName (62 bytes):** A fixed length array of Unicode characters that specifies the name of the font. Characters whose position in this array is greater than **cchFontName** are undefined and MUST be ignored. + +**stxp (16 bytes):** An [Stxp](#stxp) structure that specifies the font attributes. + +**icvFore (2 bytes):** An [Icv](#icv) structure that specifies the [**color palette**](#gt_05879d13-b9e0-4333-b96d-63cc3433997e) value for the font. + +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +### RRDTQSIF + +The **RRDTQSIF** record specifies the [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) field that has been removed in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rtgrbitfrt
ref (variable)
...
rrd (14 bytes)
...
...
...idField
...
+ +**rt (2 bytes):** An unsigned integer that specifies the RRDTQSIF record type. The value MUST be 0x0808. + +**grbitfrt (2 bytes):** MUST be 0x0001, and MUST be ignored. + +**ref (variable):** An [Ref8U](#ref8u) or [Ref8U2007](#ref8u2007) that specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of the query table from which the field was removed. If the value of the **wXLVer** field of the [RRDInfo](#rrdinfo) record in this [revision log](#Section_2cbd26e86f7e4195ada414c8b7e595b8) as specified by the [Revision Stream (Revision Log)](#revision-stream-revision-log) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) is equal to 12, Ref8U2007 is used. Otherwise, Ref8U is used. + +**rrd (14 bytes):** An [RRD](#rrd) that specifies the properties of this [**revision record**](#gt_8a81af64-18af-4ccf-8bf6-1a26d77f257f). The value of **rrd.revid** MUST be 0x0. The value of **rrd.revt** MUST be 0x2E. The value of **rrd.fDelAtEdgeofSort** MUST be 0x0. + +**idField (4 bytes):** An unsigned integer that specifies the identity of this field in the query table. The value MUST be unique among **idField** fields of all RRDTQSIF records in the query table and all [Qsif](#qsif) records in the query table. MUST be greater than 0x00000000 and less than 0x0000FFFF. + +### RRDUserView + +The **RRDUserView** record specifies the changes caused by a [**custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4) [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rrd (14 bytes)
...
...
...guid (16 bytes)
...
...
...
+ +**rrd (14 bytes):** An [RRD](#rrd) that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a shared workbook. The **rrd.revid** MUST be 0 because this is a revision that cannot be reviewed The **rrd.revt** MUST be equal to 0x002B or 0x002C. The **rrd.tabid** MUST be 0xFFFF because this revision does not correspond to a specific [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**guid (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that specifies the custom view in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) whose revision caused the changes specified in this record. MUST be globally unique. The value of this field MUST be equal to one of the **guid** fields of the [UserSViewBegin](#usersviewbegin) collection in the sheet. + +### RRFormat + +The **RRFormat** record specifies a formatting change that was applied to a [**shared workbook**](#gt_241c4cae-c49a-438a-87dc-c8fb2c871921). If the change information is too large for a single RRFormat record, it is split into multiple RRFormat records. This record cannot be continued with [Continue](#continue) records. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rrd (14 bytes)
...
...
...ABCreserved
sqref (variable)
...
dxfn (variable)
...
+ +**rrd (14 bytes):** An [RRD](#rrd) that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). The RRD structure MUST conform to the restrictions specified in the following table: + +| Value | Restriction | +|---------------|---------------------| +| **rrd.revt** | MUST be 0x000B. | +| **rrd.revid** | MUST be 0x0. | +| **rrd.tabid** | MUST NOT be 0xFFFF. | + +**A - fXfDxf (1 bit):** A bit that specifies that the affected [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) need to have their format reset to the format specified by the current [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) before applying any format from **dxfn**, if present. + +**B - fXfDxfNull (1 bit):** A bit that specifies whether **dxfn** exists. + +**C - fStyXfDxf (1 bit):** A bit that specifies that the format of the cells need to be cleared before applying any format from **dxfn**, if present. + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +**sqref (variable):** An [SqRefU](#sqrefu) structure that specifies the location or locations on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) affected by the formatting changes specified by this record. + +**dxfn (variable):** A [DXFN](#dxfn) structure that specifies the new cell formatting. MUST exist if and only if fXfDxfNull is 0. + +### RRInsertSh + +The **RRInsertSh** record specifies the changes caused by inserting a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rrd (14 bytes)
...
...
...itabPos
reservedcch
stName (256 bytes)
...
...
+ +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a shared workbook. The **rrd.revid** MUST be greater than 0 because this is a reviewable [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e). The **rrd.revt** MUST be equal to 0x0005. The **rrd.tabid** MUST NOT be 0xFFFF because this revision corresponds to a specific sheet. + +**itabPos (2 bytes):** A [TabIndex](#tabindex) structure that specifies the position of the new sheet in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**cch (2 bytes):** An unsigned integer that specifies the number of characters in **stName** that are used to specify the name of the new sheet. Characters in **stName** that are to the right of these used characters are ignored. If **stName.fHighByte** is 0, the value MUST be less than or equal to 227. If **stName.fHighByte** is 1, the value MUST be less than or equal to 127. + +**stName (256 bytes):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of the new sheet. + +### RRSort + +The **RRSort** record specifies the changes caused by [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880) actions in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rrd (14 bytes)
...
...
...ref8
...
...Areserved
cbSort
rgSortMap (variable)
...
+ +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a shared workbook. The **rrd.revt** MUST be equal to 0x0007. The **rrd.tabid** MUST NOT be 0xFFFF because this [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) corresponds to a specific [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**ref8 (8 bytes):** A [Ref8U](#ref8u) structure that specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells affected by sort actions. If the value of **fCol** is 0, the range of rows MUST be within the valid range of the number of rows on the sheet as defined in the used range specified by the [Dimensions](#dimensions) record. If the value of **fCol** is 1, the range of columns MUST be within the valid range of the number of columns on the sheet as defined in the used range specified by the Dimensions record. + +**A - fCol (1 bit):** A bit that specifies whether sorting is performed on the columns. + +| Value | Meaning | +|-------|----------------------------------| +| 0 | The rows have been reordered. | +| 1 | The columns have been reordered. | + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +**cbSort (4 bytes):** An unsigned integer that specifies the size of **rgSortMap** in bytes. + +**rgSortMap (variable):** An array of [SortItem](#sortitem) structures. The size MUST be equal to **cbSort**. + +### RRTabId + +The **RRTabId** record specifies an array of unique [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) identifiers, each of which is associated with a sheet in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The order of the sheet identifiers in the array matches the order of the [BoundSheet8](#boundsheet8) records as they appear in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). If the workbook contains more than 4112 sheets, then this record is not present and each sheet identifier is specified by the order in which the BoundSheet8 records appear in the Globals Substream, beginning with 1.[\<115\>](#Appendix_A_115) + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgtabid (variable)
...
+ +**rgtabid (variable):** An array of 2-byte unsigned integers. Each element of this array is a unique sheet identifier, which is associated with a sheet in the workbook. The order of the sheet identifiers in the array matches the order in which the BoundSheet8 records appear in the Globals Substream. + +### SBaseRef + +The **SBaseRef** record specifies the location of a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) referenced by a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ref
...
+ +**ref (8 bytes):** A [Ref8U](#ref8u) structure that specifies the location of a PivotTable view referenced by a chart. + +### Scatter + +The **Scatter** record specifies that the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is a scatter chart group or a bubble chart group, and specifies the chart group attributes. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
pcBubbleSizeRatiowBubbleSize
ABCreserved
+ +**pcBubbleSizeRatio (2 bytes):** An unsigned integer that specifies the size of the [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) as a percentage of their default size. A value of 100 shows all the data points in their default size, as determined by the application. MUST be greater than or equal to 0 and less than or equal to 300. MUST be ignored if the **fBubbles** field is 0. + +**wBubbleSize (2 bytes):** An unsigned integer that specifies how the default size of the data points represents the value. MUST be ignored if the **fBubbles** field is 0. MUST be a value from the following table: + +| Value | Meaning | +|--------|---------------------------------------------------| +| 0x0001 | The area of the data point represents the value. | +| 0x0002 | The width of the data point represents the value. | + +**A - fBubbles (1 bit):** A bit that specifies whether this chart group is a scatter chart group or bubble chart group. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------| +| 0 | Scatter chart group | +| 1 | Bubble chart group | + +**B - fShowNegBubbles (1 bit):** A bit that specifies whether data points with negative values in the chart group are shown on the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). MUST be ignored if the **fBubbles** field is 0. + +**C - fHasShadow (1 bit):** A bit that specifies whether one or more [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) in a scatter chart group or data points in a bubble chart group have shadows. + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +### SCENARIO + +The **SCENARIO** record specifies a [**scenario**](#gt_ee14f43c-19d8-467b-aa0b-e025635f6ba3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
creffLockedfHidden
cchNamecchCommentcchNameUserrgchName (variable)
...
rgchNameUser (variable)
...
rgchComment (variable)
...
rgSLC (variable)
...
rgst (variable)
...
unused (variable)
...
+ +**cref (2 bytes):** An unsigned integer that specifies the number of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the scenario. MUST be greater than zero and less than or equal to 32. + +**fLocked (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether the scenario can be modified if the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829). It MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | The user can change the scenario. | +| 0x01 | When the workbook is protected, the user cannot change the scenario. | + +**fHidden (1 byte):** A Boolean that specifies whether the scenario is to be [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) from the user if the workbook is protected. It MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | The scenario is never hidden | +| 0x01 | When the workbook is protected, the scenario is hidden from the user. | + +**cchName (1 byte):** An unsigned integer that specifies the character count in the field **rgchName**. + +**cchComment (1 byte):** An unsigned integer that specifies the character count in the field **rgchComment**. + +**cchNameUser (1 byte):** An unsigned integer that specifies the character count in the field **rgchNameUser**. + +**rgchName (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of the scenario. + +**rgchNameUser (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the name of the user who created the scenario. The character count MUST be less than or equal to 52. MUST be omitted if **cchNameUser** is 0. + +**rgchComment (variable):** An XLUnicodeString structure that specifies a [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) associated with the scenario. MUST be omitted if **cchComment** is 0. + +**rgSLC (variable):** An array of [SLCO8](#slco8) structures. Each element of the array specifies one cell that is changed by the scenario. Its element count MUST be **cref**. + +**rgst (variable):** An array of XLUnicodeString structures. Each element of the array specifies the value associated to a cell by the scenario. Its element count MUST be **cref**. + +**unused (variable):** Undefined and MUST be ignored. The size of this field in bytes MUST be 2\***cref**. + +### ScenarioProtect + +The **ScenarioProtect** record specifies the [**protection**](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499) state for [**scenarios**](#gt_ee14f43c-19d8-467b-aa0b-e025635f6ba3) in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). Scenarios are defined in the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
fScenProtect
+ +**fScenProtect (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the scenarios in the sheet are [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829). MUST be a value from the following table: + +| Value | Meaning | +|--------|------------------------------| +| 0x0000 | Scenarios are not protected. | +| 0x0001 | Scenarios are protected. | + +### ScenMan + +The **ScenMan** record specifies the state of the [**Scenario Manager**](#gt_66a30626-8b99-48f5-9488-7706735454e7) for the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +This record also specifies the beginning of a collection of [Scenario](#scenario) records as defined by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of Scenario records specifies individual scenarios. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
csctisctCur
isctShownirefResult
rgref (variable)
...
+ +**csct (2 bytes):** A signed integer that specifies the total number of [**scenarios**](#gt_ee14f43c-19d8-467b-aa0b-e025635f6ba3) in the sheet. MUST be equal to the number of Scenario records in the Worksheet substream and MUST be greater than or equal to 0. + +**isctCur (2 bytes):** A signed integer that specifies the zero-based index of the Scenario in this Worksheet substream that is currently [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) in the Scenario Manager. If **csct** is greater than 0, then **isctCur** MUST be greater than or equal to –1 and MUST be less than the number of Scenario records in the Worksheet substream. The value -1 means that no scenario is currently selected. + +**isctShown (2 bytes):** A signed integer that specifies the zero-based index of the Scenario in this Worksheet substream that specifies the scenario that is currently applied in the sheet associated with this record. If **csct** is greater than 0, then **isctShown** MUST be greater than or equal to –1 and MUST be less than the number of Scenario records in the Worksheet substream. The value –1 means that no scenario is currently shown. + +**irefResult (2 bytes):** A signed integer that specifies the number of [**result cells**](#gt_353bd534-530f-4478-b618-271b85cab0b8) that are referenced in the field **rgref**. MUST be greater than or equal to 0 and less than or equal to 32. + +**rgref (variable):** An array of [Ref8U](#ref8u) structures. Each element specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells in the current sheet. These cells contain the results that are to be compared across scenarios. Its count MUST be equal to **irefResult**. + +### Scl + +The **Scl** record specifies the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) of the current view in the window used to display the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) as a fraction given by the following formula: + +Fraction = **nscl** / **dscl** + +The fraction MUST be greater than or equal to 1/10 and less than or equal to 4. + +This record MUST exist if the zoom level of the current view is not equal to 1. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
nscldscl
+ +**nscl (2 bytes):** A signed integer that specifies the numerator of the fraction. The value MUST be greater than or equal to 1. + +**dscl (2 bytes):** A signed integer that specifies the denominator of the fraction. The value MUST be greater than or equal to 1. + +### Selection + +The **Selection** record specifies [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). There can be multiple contiguous Selection records that have the same **pnn** value to specify all selected cells within a sheet[\<116\>](#Appendix_A_116). If this is the case, the values of **rwAct**, **colAct**, and **irefAct** MUST be the same across all the contiguous Selection records that have the same **pnn** value. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
pnnrwActcolAct
...irefActcref
...rgref (variable)
...
+ +**pnn (1 byte):** A [PaneType](#panetype) enumeration that specifies the [**active pane**](#gt_33f49274-001d-40a3-bcca-f54a93906c29). + +**rwAct (2 bytes):** An [RwU](#rwu) structure that specifies the zero-based row number of the [**active cell**](#gt_2c0759a5-6721-422b-8cb9-f4bb09e07c84). + +**colAct (2 bytes):** A [ColU](#colu) structure that specifies the zero-based column number of the active cell. + +**irefAct (2 bytes):** A signed integer that specifies the zero-based index to the [RefU](#refu) structure in **rgref** that contains the active cell. MUST be greater than or equal to 0. If this record is one of multiple contiguous Selection records, this value is the index to the RefU structure across the aggregation of **rgref** arrays of all Selection records. + +**cref (2 bytes):** An unsigned integer that specifies the number of RefU structures in the **rgref** array of this record. + +**rgref (variable):** An array of RefU structures that specifies ranges of selected cells in the sheet. The number of RefU structures in this array MUST be less than or equal to 1369. + +### SerAuxErrBar + +The **SerAuxErrBar** record specifies properties of an [error bar](#Section_762a461d0a45474ebd7d5994bb294af2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
sertmebsrcfTeeTopreserved
numValue
...
cnum
+ +**sertm (1 byte):** An unsigned integer that specifies the direction of the error bars. MUST be a value from the following table. + +| Value | Meaning | +|-------|---------------------------------------------------| +| 0x01 | Error bars are horizontal in the plus direction. | +| 0x02 | Error bars are horizontal in the minus direction. | +| 0x03 | Error bars are vertical in the plus direction. | +| 0x04 | Error bars are vertical in the minus direction. | + +**ebsrc (1 byte):** An unsigned integer that specifies the error amount type of the error bars. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x01 | Percentage | +| 0x02 | Fixed value | +| 0x03 | Standard deviation | +| 0x04 | Custom values (array of values or [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99)) | +| 0x05 | Standard error | + +If the **cce** field of the [ChartParsedFormula](#chartparsedformula) record contained in the **formula** field of the closest preceding [BRAI](#brai) record with **id** field equal to 0x0001 is 0x0000, then the error bars value source is an array of values. Each value in this array MUST be stored in a [Number](#number) record in the [SERIESDATA](#chart-sheet-substream) part of the Chart Sheet substream as specified in the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The **cell.col** field of each Number record MUST store the zero-based position index of the closest preceding [Series](#series-1) record, as it is calculated across all Series records in the current [Chart Sheet](#Section_2c90d75bc92645aa8ff29d4483f51831) substream. The **cell.rw** field MUST store the zero-based index of this value in the array. + +Otherwise, the value source is a range. The closest preceding BRAI record with the **id** field equal to 0x0001 specifies a link to the [Rgce](#rgce) structure that describes this range. + +**fTeeTop (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether the error bars are T-shaped. + +**reserved (1 byte):** MUST be 0x01 and MUST be ignored. + +**numValue (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the fixed value, percentage, or number of standard deviations for the error bars. If **ebsrc** is equal to 0x05 or 0x04, MUST be ignored. + +**cnum (2 bytes):** An unsigned integer that specifies the number of value or cell references used for custom error bars when **ebsrc** is equal to 0x04. This value MUST be ignored if **ebsrc** does not equal 0x04. + +If the value source is an array of values, this value MUST equal the count of Number records whose **cell.col** field stores the zero-based index of the closest preceding Series record in the collection of Series records in the current chart sheet substream. + +If the value source is a range, this value MUST equal the count of cell references of the range as specified in the **rgce** field of the ChartParsedFormula contained in the **formula** field of the closest preceding BRAI record that has an **id** field equal to 0x0001. + +### SerAuxTrend + +The **SerAuxTrend** record specifies a [trendline](#Section_61d74ebc36714d6dbdc0626db604530d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
regtordUsernumIntercept
...
...fEquationfRSquared
numForecast
...
numBackcast
...
+ +**regt (1 byte):** An unsigned integer that specifies the type of trendline. The value MUST be one of the following values: + +| Value | Meaning | +|-------|----------------------------------------------------------------| +| 0x00 | Polynomial | +| 0x01 | Exponential | +| 0x02 | Logarithmic | +| 0x03 | Power | +| 0x04 | [**Moving average**](#gt_4b582231-b8d5-4dea-bda8-83c6f83b05e6) | + +**ordUser (1 byte):** An unsigned integer that specifies the polynomial order or moving average period. MUST be greater than or equal to 0x02 and less than or equal to 0x06 if **regt** is equal to 0x00; MUST be greater than or equal to 0x02 and less than or equal to the value of the **cValx** field of the [Series](#series-1) record specified by the preceding [SerParent](#serparent) record minus one if **regt** is equal to 0x04. MUST be ignored for trendlines of all other types. + +**numIntercept (8 bytes):** A [ChartNumNillable](#chartnumnillable) structure that specifies where the trendline intersects the value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) or vertical axis on bubble and scatter [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5). If no intercept is specified, this ChartNumNillable structure MUST specify a [NilChartNum](#nilchartnum) structure, and the value of the **type** field in the NilChartNum structure MUST be 0x0100. + +**fEquation (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether the trendline equation is displayed in the trendline label. MUST be ignored if **regt** is equal to 0x04. MUST be ignored if the [chart sheet](#Section_732ff614d939416bb7c76d983471ff11) substream contains an [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a) with an [ObjectLink](#objectlink) record that contains both a **wLinkObj** field equal to 0x0004 and a **wLinkVar1** field equal to the zero-based index into a Series record in the collection of Series records in the current chart sheet substream that represents this trendline , and the attached label contains a [SeriesText](#seriestext) record. + +**fRSquared (1 byte):** A Boolean that specifies whether the R-squared value is displayed in the trendline label. MUST be ignored if **regt** is equal to 0x04. MUST be ignored if the chart sheet substream contains an attached label with an ObjectLink record that contains both a **wLinkObj** field equal to 0x0004 and a **wLinkVar1** field equal to the zero-based index into a Series record in the collection of Series records in the current chart sheet substream that represents this trendline, and the attached label contains a SeriesText record. + +**numForecast (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the number of periods to [**forecast**](#gt_0a5478cf-8836-4a9a-a663-7684366646a3) forward. + +**numBackcast (8 bytes):** An Xnum that specifies the number of periods to forecast backward. + +### SerFmt + +The **SerFmt** record specifies properties of the associated [data points](#Section_9c986ad250d44fa1a157063ac5c971a0), [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b), or lines of the [series](#Section_527ce4dfc9f84e50a314d4b07519593c).  The associated data points, data markers, or lines of the series are specified by the preceding [DataFormat](#dataformat) record. If this record is not present in the sequence of records that conforms to the [SS](#chart-sheet-substream) rule of the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), then the properties of the associated data points, data markers, or lines of the series are specified by the default values of the fields of this record. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ABCreserved
+ +**A - fSmoothedLine (1 bit):** A bit that specifies whether the lines of the series are displayed with a smooth line effect on a scatter, radar, and line [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). The default value of this field is 0. + +**B - f3DBubbles (1 bit):** A bit that specifies whether the data points of a bubble chart group are displayed with a 3-D effect.  MUST be ignored for all other chart groups. The default value of this field is 0. + +**C - fArShadow (1 bit):** A bit that specifies whether the data markers are displayed with a shadow on bubble, scatter, radar, stock, and line chart groups. The default value of this field is 0. + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +### Series + +The **Series** record specifies properties of the data for a [series](#Section_527ce4dfc9f84e50a314d4b07519593c), a [trendline](#Section_61d74ebc36714d6dbdc0626db604530d), or [error bars](#Section_762a461d0a45474ebd7d5994bb294af2), and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a series, a trendline, or error bars. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
sdtXsdtY
cValxcValy
sdtBSizecValBSize
+ +**sdtX (2 bytes):** An unsigned integer that specifies the type of data in [**categories**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1), or horizontal values on bubble and scatter [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5), in the series. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0001 | The series contains categories, or horizontal values on bubble and scatter chart groups, with numeric information. | +| 0x0003 | The series contains categories, or horizontal values on bubble and scatter chart groups, with text information. | + +**sdtY (2 bytes):** An unsigned integer that specifies that the values or vertical values on bubble and scatter chart groups, in the series contain numeric information. It MUST be 0x0001 and MUST be ignored. + +**cValx (2 bytes):** An unsigned integer that specifies the count of categories, or horizontal values on bubble and scatter chart groups, in the series. The value MUST be less than or equal to 32767. + +**cValy (2 bytes):** An unsigned integer that specifies the count of values, or vertical values on bubble and scatter chart groups, in the series. The value MUST be less than or equal to 32767. + +**sdtBSize (2 bytes):** An unsigned integer that specifies that the [**bubble size**](#gt_3a0cf938-5b61-4460-bdbb-3540d84d4180) values in the series contain numeric information. The value MUST be 0x0001, and MUST be ignored. + +**cValBSize (2 bytes):** An unsigned integer that specifies the count of bubble size values in the series. The value MUST be less than or equal to 32767. + +### SeriesList + +The **SeriesList** record specifies the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) for the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cserrgiser (variable)
...
+ +**cser (2 bytes):** An unsigned integer that specifies the count of series indexes in the **rgiser** field. + +**rgiser (variable):** An array of 2-byte unsigned integers, each of which specifies a one-based index of a [Series](#series-1) record in the collection of Series records in the current [chart sheet](#Section_732ff614d939416bb7c76d983471ff11) substream. Each referenced Series specifies a series for the chart. + +### SeriesText + +The **SeriesText** record specifies the text for a [series](#Section_527ce4dfc9f84e50a314d4b07519593c), [trendline](#Section_61d74ebc36714d6dbdc0626db604530d) name, trendline label, [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) title or [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) title. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reservedstText (variable)
...
+ +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**stText (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) that specifies the text string. + +### SerParent + +The **SerParent** record specifies the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) to which the current [trendline](#Section_61d74ebc36714d6dbdc0626db604530d) or [error bar](#Section_762a461d0a45474ebd7d5994bb294af2) corresponds. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
series
+ +**series (2 bytes):** An unsigned integer that specifies the one-based index of a [Series](#series-1) record in the collection of Series records in the current [chart sheet](#Section_2c90d75bc92645aa8ff29d4483f51831) substream. The referenced Series record specifies the series associated with the current trendline or error bar. The value MUST be greater than or equal to 0x0001 and less than or equal to 0x0FE. + +### SerToCrt + +The **SerToCrt** record specifies the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) for the current [series](#Section_527ce4dfc9f84e50a314d4b07519593c). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
id
+ +**id (2 bytes):** An unsigned integer that specifies the zero-based index of a [ChartFormat](#chartformat) record in the collection of ChartFormat records in the current [chart sheet](#Section_2c90d75bc92645aa8ff29d4483f51831) substream. The referenced ChartFormat record specifies the chart group that contains the current series. + +### Setup + +The **Setup** record specifies the page format settings used to print the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iPaperSizeiScale
iPageStartiFitWidth
iFitHeightABCDEFGHIJKL
iResiVRes
numHdr
...
numFtr
...
iCopies
+ +**iPaperSize (2 bytes):** An unsigned integer that specifies the paper size. Refer to the following table for values. The value 0, or values greater than or equal to 256, specify custom printer paper sizes. Values between 118 and 255 are reserved for future use. If **fNoPls** is 1, this value is undefined and MUST be ignored. + +| Value | Meaning | +|-------|-----------------------------------------------| +| 1 | US Letter 8 1/2 x 11 in | +| 2 | US Letter Small 8 1/2 x 11 in | +| 3 | US Tabloid 11 x 17 in | +| 4 | US Ledger 17 x 11 in | +| 5 | US Legal 8 1/2 x 14 in | +| 6 | US Statement 5 1/2 x 8 1/2 in | +| 7 | US Executive 7 1/4 x 10 1/2 in | +| 8 | A3 297 x 420 mm | +| 9 | A4 210 x 297 mm | +| 10 | A4 Small 210 x 297 mm | +| 11 | A5 148 x 210 mm | +| 12 | B4 (JIS) 250 x 354 | +| 13 | B5 (JIS) 182 x 257 mm | +| 14 | Folio 8 1/2 x 13 in | +| 15 | Quarto 215 x 275 mm | +| 16 | 10 x 14 in | +| 17 | 11 x 17 in | +| 18 | US Note 8 1/2 x 11 in | +| 19 | US Envelope \#9 3 7/8 x 8 7/8 | +| 20 | US Envelope \#10 4 1/8 x 9 1/2 | +| 21 | US Envelope \#11 4 1/2 x 10 3/8 | +| 22 | US Envelope \#12 4 \276 x 11 | +| 23 | US Envelope \#14 5 x 11 1/2 | +| 24 | C size sheet | +| 25 | D size sheet | +| 26 | E size sheet | +| 27 | Envelope DL 110 x 220mm | +| 28 | Envelope C5 162 x 229 mm | +| 29 | Envelope C3 324 x 458 mm | +| 30 | Envelope C4 229 x 324 mm | +| 31 | Envelope C6 114 x 162 mm | +| 32 | Envelope C65 114 x 229 mm | +| 33 | Envelope B4 250 x 353 mm | +| 34 | Envelope B5 176 x 250 mm | +| 35 | Envelope B6 176 x 125 mm | +| 36 | Envelope 110 x 230 mm | +| 37 | US Envelope Monarch 3.875 x 7.5 in | +| 38 | 6 3/4 US Envelope 3 5/8 x 6 1/2 in | +| 39 | US Std Fanfold 14 7/8 x 11 in | +| 40 | German Std Fanfold 8 1/2 x 12 in | +| 41 | German Legal Fanfold 8 1/2 x 13 in | +| 42 | B4 (ISO) 250 x 353 mm | +| 43 | Japanese Postcard 100 x 148 mm | +| 44 | 9 x 11 in | +| 45 | 10 x 11 in | +| 46 | 15 x 11 in | +| 47 | Envelope Invite 220 x 220 mm | +| 48 | RESERVED--DO NOT USE | +| 49 | RESERVED--DO NOT USE | +| 50 | US Letter Extra 9 \275 x 12 in | +| 51 | US Legal Extra 9 \275 x 15 in | +| 52 | US Tabloid Extra 11.69 x 18 in | +| 53 | A4 Extra 9.27 x 12.69 in | +| 54 | Letter Transverse 8 \275 x 11 in | +| 55 | A4 Transverse 210 x 297 mm | +| 56 | Letter Extra Transverse 9\275 x 12 in | +| 57 | SuperA/SuperA/A4 227 x 356 mm | +| 58 | SuperB/SuperB/A3 305 x 487 mm | +| 59 | US Letter Plus 8.5 x 12.69 in | +| 60 | A4 Plus 210 x 330 mm | +| 61 | A5 Transverse 148 x 210 mm | +| 62 | B5 (JIS) Transverse 182 x 257 mm | +| 63 | A3 Extra 322 x 445 mm | +| 64 | A5 Extra 174 x 235 mm | +| 65 | B5 (ISO) Extra 201 x 276 mm | +| 66 | A2 420 x 594 mm | +| 67 | A3 Transverse 297 x 420 mm | +| 68 | A3 Extra Transverse 322 x 445 mm | +| 69 | Japanese Double Postcard 200 x 148 mm | +| 70 | A6 105 x 148 mm | +| 71 | Japanese Envelope Kaku \#2 | +| 72 | Japanese Envelope Kaku \#3 | +| 73 | Japanese Envelope Chou \#3 | +| 74 | Japanese Envelope Chou \#4 | +| 75 | Letter Rotated 11 x 8 1/2 11 in | +| 76 | A3 Rotated 420 x 297 mm | +| 77 | A4 Rotated 297 x 210 mm | +| 78 | A5 Rotated 210 x 148 mm | +| 79 | B4 (JIS) Rotated 364 x 257 mm | +| 80 | B5 (JIS) Rotated 257 x 182 mm | +| 81 | Japanese Postcard Rotated 148 x 100 mm | +| 82 | Double Japanese Postcard Rotated 148 x 200 mm | +| 83 | A6 Rotated 148 x 105 mm | +| 84 | Japanese Envelope Kaku \#2 Rotated | +| 85 | Japanese Envelope Kaku \#3 Rotated | +| 86 | Japanese Envelope Chou \#3 Rotated | +| 87 | Japanese Envelope Chou \#4 Rotated | +| 88 | B6 (JIS) 128 x 182 mm | +| 89 | B6 (JIS) Rotated 182 x 128 mm | +| 90 | 12 x 11 in | +| 91 | Japanese Envelope You \#4 | +| 92 | Japanese Envelope You \#4 Rotated | +| 93 | PRC 16K 146 x 215 mm | +| 94 | PRC 32K 97 x 151 mm | +| 95 | PRC 32K(Big) 97 x 151 mm | +| 96 | PRC Envelope \#1 102 x 165 mm | +| 97 | PRC Envelope \#2 102 x 176 mm | +| 98 | PRC Envelope \#3 125 x 176 mm | +| 99 | PRC Envelope \#4 110 x 208 mm | +| 100 | PRC Envelope \#5 110 x 220 mm | +| 101 | PRC Envelope \#6 120 x 230 mm | +| 102 | PRC Envelope \#7 160 x 230 mm | +| 103 | PRC Envelope \#8 120 x 309 mm | +| 104 | PRC Envelope \#9 229 x 324 mm | +| 105 | PRC Envelope \#10 324 x 458 mm | +| 106 | PRC 16K Rotated | +| 107 | PRC 32K Rotated | +| 108 | PRC 32K(Big) Rotated | +| 109 | PRC Envelope \#1 Rotated 165 x 102 mm | +| 110 | PRC Envelope \#2 Rotated 176 x 102 mm | +| 111 | PRC Envelope \#3 Rotated 176 x 125 mm | +| 112 | PRC Envelope \#4 Rotated 208 x 110 mm | +| 113 | PRC Envelope \#5 Rotated 220 x 110 mm | +| 114 | PRC Envelope \#6 Rotated 230 x 120 mm | +| 115 | PRC Envelope \#7 Rotated 230 x 160 mm | +| 116 | PRC Envelope \#8 Rotated 309 x 120 mm | +| 117 | PRC Envelope \#9 Rotated 324 x 229 mm | +| 118 | PRC Envelope \#10 Rotated 458 x 324 mm | + +**iScale (2 bytes):** An unsigned integer that specifies the scaling factor for printing as a percentage. For example, if the value is 107 then the scaling factor is 107%. If **fNoPls** is 1, this value is undefined and MUST be ignored. + +**iPageStart (2 bytes):** A signed integer that specifies the starting page number. If **fUsePage** is 0, MUST be ignored. + +**iFitWidth (2 bytes):** An unsigned integer that specifies the number of pages the sheet width is fit to. MUST be less than or equal to 32767. The value 0 means use as many pages as necessary to print the columns in the sheet. + +**iFitHeight (2 bytes):** An unsigned integer that specifies the number of pages the sheet height is fit to. MUST be less than or equal to 32767. The value 0 means use as many pages as necessary to print the rows of the sheet. + +**A - fLeftToRight (1 bit):** A bit that specifies the order that multiple pages are sent to the printer for a single sheet. + +| Value | Meaning | +|-------|---------------------------------------------------------------| +| 0 | Pages are printed top-to-bottom first and then left-to-right. | +| 1 | Pages are printed left-to-right first and then top-to-bottom. | + +**B - fPortrait (1 bit):** A bit that specifies whether to print using portrait mode or landscape mode. If **fNoPls** is 1, the value is undefined and MUST be ignored. If **fNoOrient** is 1, the value is undefined and MUST be ignored. + +| Value | Meaning | +|-------|-----------------------------------------| +| 0 | Pages are printed using landscape mode. | +| 1 | Pages are printed using portrait mode. | + +**C - fNoPls (1 bit):** A bit that specifies whether the **iPaperSize**, **iScale**, **iRes**, **iVRes**, **iCopies**, **fNoOrient**, and **fPortrait** data are undefined and ignored. If the value is 1, they are undefined and ignored. + +**D - fNoColor (1 bit):** A bit that specifies whether the document is printed in black and white. + +**E - fDraft (1 bit):** A bit that specifies whether the document is printed using draft quality. + +**F - fNotes (1 bit):** A bit that specifies whether [**comments**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) are printed. + +**G - fNoOrient (1 bit):** A bit that specifies whether the paper orientation is set. + +| Value | Meaning | +|-------|---------------------------------------------------------------| +| 0 | Paper orientation is specified by the value of **fPortrait**. | +| 1 | Pages are printed using portrait mode. | + +**H - fUsePage (1 bit):** A bit that specifies whether a custom starting page number is used to print. If the value is 1, the custom starting page number specified by the value of **iPageStart** is used. + +**I - unused1 (1 bit):** Undefined and MUST be ignored. + +**J - fEndNotes (1 bit):** A bit that specifies whether the comments are printed at the end of the sheet. If **fNotes** is 0, the value MUST be ignored. + +| Value | Meaning | +|-------|-------------------------------------------------| +| 0 | Comments are printed as displayed on the sheet. | +| 1 | Comments are printed at the end of the sheet. | + +**K - iErrors (2 bits):** An unsigned integer that specifies how to handle errors in the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) data. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------| +| 0 | Print errors as displayed on the sheet. | +| 1 | Print errors as blank. | +| 2 | Print errors as dashes ("--"). | +| 3 | Print errors as "#N/A". | + +**L - reserved (4 bits):** MUST be zero, and MUST be ignored. + +**iRes (2 bytes):** An unsigned integer that specifies the print resolution in dots per inch (DPI). If **fNoPls** is 1, this value is undefined and MUST be ignored. + +**iVRes (2 bytes):** An unsigned integer that specifies the vertical print resolution in DPI. If **fNoPls** is 1, this value is undefined and MUST be ignored. + +**numHdr (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the header margin in inches. The value MUST be greater than or equal to 0 and less than 49. + +**numFtr (8 bytes):** An Xnum value that specifies the footer margin in inches. The value MUST be greater than or equal to 0 and less than 49. + +**iCopies (2 bytes):** An unsigned integer that specifies the number of copies to print. If **fNoPls** is 1, this value is undefined and MUST be ignored. + +### ShapePropsStream + +The **ShapePropsStream** record specifies the [**shape**](#gt_d0e38aa4-2c71-4a6f-b5e6-75766fa9409e) formatting properties for [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) elements. These shape formatting properties are a superset of the properties stored in the [LineFormat](#lineformat), [AreaFormat](#areaformat), [MarkerFormat](#markerformat), and [GelFrame](#gelframe) records. They are stored in the **rgb** field, which is an **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)), as defined in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, section 21.2.2.197.[\<117\>](#Appendix_A_117) + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
wObjContextunused
dwChecksum
cb
rgb (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field of the field MUST be 0x08A4. + +**wObjContext (2 bytes):** An unsigned integer that specifies the chart element that the shape formatting properties in this record apply to. + +If this record is in a sequence of records that specifies an [AXS](#chart-sheet-substream) rule, then it MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The shape properties in this record apply to the [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). | +| 0x0001 | The shape properties in this record apply to the [**major gridlines**](#gt_2803347c-6396-46a5-9ede-6bef1149b013) of the axis. | +| 0x0002 | The shape properties in this record apply to the [**minor gridlines**](#gt_49980976-6314-43ad-ad51-8d3e55ef4b59) of the axis. | +| 0x0003 | The shape properties in this record apply to the three-dimensional surfaces of the [**walls**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c) or [**floor**](#gt_dc38c098-e0d3-4701-9656-5f2cf4d80f29). | + +If this record precedes an [End](#end) record matched by a [Begin](#begin) record in a sequence of records that conforms to the CRT rule, then this field MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The shape properties in this record apply to the [**drop lines**](#gt_e8c745bf-646c-4acd-8b5e-5314fa4965fa) of the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). | +| 0x0001 | The shape properties in this record apply to the [**high-low lines**](#gt_56aec928-ddcc-4415-9d08-5d1dd3982bbc) of the chart group. | +| 0x0002 | The shape properties in this record apply to the [**leader lines**](#gt_8b7c448e-82e3-4d22-a8ba-52e0a10b14fa) of the chart group. | +| 0x0003 | The shape properties in this record apply to the [**series lines**](#gt_bda50b03-68fa-49f9-bd9e-d0dc289ac88a) of the chart group. | + +If this record is in a sequence of records that conforms to the SS rule, then this field MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The shape properties in this record apply to the [series](#Section_527ce4dfc9f84e50a314d4b07519593c), [data points](#Section_9c986ad250d44fa1a157063ac5c971a0), [error bars](#Section_762a461d0a45474ebd7d5994bb294af2), or [trendlines](#Section_61d74ebc36714d6dbdc0626db604530d) specified by the [DataFormat](#dataformat) record. | +| 0x0001 | The shape properties in this record apply to the [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) specified by the DataFormat record. | + +If this record is in a sequence of records that conforms to the FRAME rule, then it MUST be 0x0000, which means the shape properties apply to the current [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)), [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c), [legend](#Section_1832229b7d1945f488d455e9c07466f0), or [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a). + +If this record is in a sequence of records that conforms to the DROPBAR rule as specified by the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), then it MUST be 0x0000, which means the shape properties apply to [**up bar**](#gt_24acb31a-39aa-4a44-829b-c18e1767a4ac) or [**down bar**](#gt_d8bcbdc9-46a4-44e5-b184-40c565e4dd07) formatting. + +**unused (2 bytes):** Undefined and MUST be ignored. + +**dwChecksum (4 bytes):** An unsigned integer that specifies the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the shape formatting properties related to this record. The algorithm used to calculate the checksum is defined by [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.4.3.2. The checksum MUST be calculated by using every property of the [**property stream**](#gt_dbd8bc67-1371-445e-af6a-dfa5eeef670c), as a stream of bytes as specified by the [ShapePropsStreamChecksumData](#shapepropsstreamchecksumdata) structure. + +The information required to build the stream of bytes can be gathered from the LineFormat, AreaFormat, MarkerFormat, and GelFrame records associated with this record, as specified by [LinePropertiesForShapePropsStreamChecksum](#linepropertiesforshapepropsstreamchecksum), [InteriorColorPropertiesForShapePropsStreamChecksum](#interiorcolorpropertiesforshapepropsstreamchecksum), and [FillStylePropertiesForShapePropsStreamChecksum](#fillstylepropertiesforshapepropsstreamchecksum). + +When reading this record, the checksum is calculated as previously specified and compared to the **dwChecksum** value stored in this record. If the calculated checksum does not match the **dwChecksum** value, the application MUST assume that the XML stream is out of date, and the data from the LineFormat, AreaFormat, MarkerFormat, and GelFrame records MUST be used instead of the data specified by the **XML stream** (section 2.1.7.22). + +**cb (4 bytes):** An unsigned integer that specifies the length of the character array in the **rgb** field. + +**rgb (variable):** An array of ANSI characters whose length is specified by **cb** that contains the XML representation of the shape formatting properties as defined in \[ECMA-376\] Part 1, section 21.2.2.197.[\<118\>](#Appendix_A_118) + +### SheetExt + +The **SheetExt** record specifies [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) properties, including [**sheet tab**](#gt_3b131045-238c-4ce8-9c22-b6aac874c7c5) color and additional optional information specified by using the [SheetExtOptional](#sheetextoptional) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
cb
icvPlainreserved
sheetExtOptional (20 bytes, optional)
...
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0862. + +**cb (4 bytes):** An unsigned integer that specifies the size of this record in bytes. + +**icvPlain (7 bits):** An unsigned integer that specifies the tab color of this sheet. If the tab has a color assigned to it, the value of this field MUST be greater than or equal to 0x08 and less than or equal to 0x3F, as specified in the color table for the [Icv](#icv) structure. If the tab has no color assigned to it, the value of this field MUST be 0x7F, and MUST be ignored. + +**reserved (25 bits):** MUST be zero, and MUST be ignored. + +**sheetExtOptional (20 bytes):** A SheetExtOptional structure that specifies optional[\<119\>](#Appendix_A_119) fields. Exists if and only if the value of **cb** is 0x00000028. + +### ShrFmla + +The **ShrFmla** record specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that is shared across multiple [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). This record specifies a file size optimization. It is used with the [Formula](#formula) record to compress the amount of storage required for the formula. This record is preceded by a single Formula record that specifies the first cell in the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that uses this shared formula. Other Formula records that use this shared formula follow later in the file, not necessarily in a contiguous sequence. Formula records that use this shared formula have the Formula.**fShrFmla** bit set, and a Formula.**cell** that is within the range specified in the **ref** field of this record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ref
...reservedcUse
formula (variable)
...
+ +**ref (6 bytes):** A [RefU](#refu) structure that specifies the range of cells that use this shared formula. Cells in this range do not have to use the shared formula. + +**reserved (8 bits):** MUST be zero, and MUST be ignored. + +**cUse (8 bits):** An unsigned integer that specifies the number of cells that use this shared formula. + +**formula (variable):** A [SharedParsedFormula](#sharedparsedformula) structure that specifies the shared formula. + +### ShtProps + +The **ShtProps** record specifies properties of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEreserved1mdBlankreserved2
+ +**A - fManSerAlloc (1 bit):** A bit that specifies whether [series](#Section_527ce4dfc9f84e50a314d4b07519593c) are automatically allocated for the chart. + +**B - fPlotVisOnly (1 bit):** A bit that specifies whether to plot [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) cells only. + +**C - fNotSizeWith (1 bit):** A bit that specifies whether to size the chart with the window. + +**D - fManPlotArea (1 bit):** If **fAlwaysAutoPlotArea** is 1, then this field MUST be 1. If **fAlwaysAutoPlotArea** is 0, then this field MUST be ignored. + +**E - fAlwaysAutoPlotArea (1 bit):** A bit that specifies whether the default [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) [**dimension (2)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) is used. + +| Value | Meaning | +|----|----| +| 0 | Use the default plot area dimension (2) regardless of the [Pos](#pos) record information. | +| 1 | Use the plot area dimension (2) of the Pos record; and **fManPlotArea** MUST be 1. | + +**reserved1 (11 bits):** MUST be zero, and MUST be ignored. + +**mdBlank (1 byte):** An unsigned integer that specifies how the empty cells are plotted be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------------| +| 0x00 | Empty cells are not plotted. | +| 0x01 | Empty cells are plotted as zero. | +| 0x02 | Empty cells are plotted as interpolated. | + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +### SIIndex + +The **SIIndex** record is part of a group of records which specify the data of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). This particular record indicates the type of data contained in the [Number](#number) records following it. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
numIndex
+ +**numIndex (2 bytes):** An unsigned integer that specifies the type of the data records contained by the Number records following it. MUST be a value from the following table: + +| Value | Number Records Following It Contain | +|----|----| +| 0x0001 | [Series](#Section_527ce4dfc9f84e50a314d4b07519593c) values or vertical values (for scatter or bubble [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) | +| 0x0002 | [**Category labels**](#gt_f357eb23-3045-4017-87d0-3946b2980a72) or horizontal values (for scatter or bubble chart groups) | +| 0x0003 | [**Bubble sizes**](#gt_3a0cf938-5b61-4460-bdbb-3540d84d4180) | + +### Sort + +The **Sort** record specifies the information used to [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880) values contained in a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEiOrderFreserved1cchKey1cchKey2
cchKey3stKey1 (variable)
...
stKey2 (variable)
...
stKey3 (variable)
...
reserved2
+ +**A - fCol (1 bit):** A bit that specifies whether to sort by columns or rows. MUST be one of the values from the following table: + +| Value | Meaning | +|----|----| +| 0 | Sort rows from top to bottom. | +| 1 | Sort columns from [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) to right. | + +**B - fKey1Dsc (1 bit):** A bit that specifies whether **stKey1** sorts in [**descending order**](#gt_f6de77a5-8743-4d03-813a-fa5e4d7c9fe8). MUST be one of the values from the following table: + +| Value | Meaning | +|-------|---------------------------| +| 0 | Sort in ascending order. | +| 1 | Sort in descending order. | + +**C - fKey2Dsc (1 bit):** A bit that specifies whether **stKey2** sorts in descending order. MUST be one of the values from the following table: + +| Value | Meaning | +|-------|---------------------------| +| 0 | Sort in ascending order. | +| 1 | Sort in descending order. | + +**D - fKey3Dsc (1 bit):** A bit that specifies whether **stKey3** sorts in descending order. MUST be one of the values from the following table: + +| Value | Meaning | +|-------|---------------------------| +| 0 | Sort in ascending order. | +| 1 | Sort in descending order. | + +**E - fCaseSensitive (1 bit):** A bit that specifies whether the sort is case-sensitive. MUST be one of the values from the following table: + +| Value | Meaning | +|-------|---------------------------------| +| 0 | The sort is not case-sensitive. | +| 1 | The sort is case-sensitive. | + +**iOrder (5 bits):** A signed integer that specifies the zero-based index of the [**custom list**](#gt_92d2bb3a-2615-4bf8-b87f-887302d4c40c) that specifies the [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7). The set of custom lists is based on the current user's environment. + +**F - fAltMethod (1 bit):** A bit that specifies whether to use [**phonetic information**](#gt_b60c7bf3-21f1-481f-806f-812461e98742) when sorting. MUST be one of the values from the following table: + +| Value | Meaning | +|-------|-----------------------------------------------| +| 0 | Do not use phonetic information when sorting. | +| 1 | Use phonetic information when sorting. | + +**reserved1 (5 bits):** MUST be zero, and MUST be ignored. + +**cchKey1 (1 byte):** An unsigned integer that specifies the length of **stKey1**. + +**cchKey2 (1 byte):** An unsigned integer that specifies the length of **stKey2**. + +**cchKey3 (1 byte):** An unsigned integer that specifies the length of **stKey3**. + +**stKey1 (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the string for the first sort key. MUST exist if and only if **cchKey1** is greater than 0. + +**stKey2 (variable):** An XLUnicodeStringNoCch structure that specifies the string for the second sort key. MUST exist if and only if **cchKey2** is greater than 0. + +**stKey3 (variable):** An XLUnicodeStringNoCch structure that specifies the string for the third sort key. MUST exist if and only if **cchKey3** is greater than 0. + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +### SortData + +The **SortData** record specifies data used for sorting a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
ABCsfpunusedrfx (16 bytes)
...
...
...cconditions
...idParent
...sortCond12Array (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0895. + +**A - fCol (1 bit):** A bit that specifies whether to [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880) by columns or rows. MUST be one of the values from the following table: + +| Value | Meaning | +|-------|------------------| +| 0x0 | Sort by rows. | +| 0x1 | Sort by columns. | + +**B - fCaseSensitive (1 bit):** A bit that specifies whether to use a case-sensitive sorting method. MUST be one of the values from the following table: + +| Value | Meaning | +|-------|---------------------------------| +| 0x0 | The sort is not case-sensitive. | +| 0x1 | The sort is case-sensitive. | + +**C - fAltMethod (1 bit):** A bit that specifies whether to use a sorting method other than character order, such as [**stroke order**](#gt_6d6a1f46-4502-44ab-ba14-07b78c9f0a54) or [**Mandarin phonetic symbols**](#gt_1c4c06fb-6eaf-4c13-a975-f014e49a5f3a). MUST be one of the values from the following table: + +| Value | Meaning | +|-------|----------------------------------------------------| +| 0x0 | The sort uses character order. | +| 0x1 | The sort uses a method other than character order. | + +**sfp (3 bits):** An unsigned integer that specifies the type of the object that contains the sort field. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The sort field is contained in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). | +| 0x1 | The sort field is contained in a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). | +| 0x2 | The sort field is contained in an [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). | +| 0x3 | The sort field is contained in a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289). | + +**unused (10 bits):** Undefined and MUST be ignored. + +**rfx (16 bytes):** An [RFX](#rfx) structure that specifies the range to sort. + +**cconditions (4 bytes):** An unsigned integer that specifies the count of [**sort conditions**](#gt_198a56e7-6045-43cf-8acd-793eab3647c1). This record MUST be followed by one [ContinueFrt12](#continuefrt12) record for each sort condition. + +**idParent (4 bytes):** An unsigned integer that specifies the identifier of the object that contains the sort field, if the **sfp** field is 0x1 or 0x3. If the **sfp** field is equal to 0x1, the value of this field MUST be equal to the **idList** field of the associated [TableFeatureType](#tablefeaturetype). If the **sfp** field is equal to 0x3, the value of this field MUST be equal to the zero-based index of the associated query table ([Qsi](#qsi)) in the Qsi records in the current substream. If the **sfp** field is equal to 0x0 or 0x2, this is undefined and MUST be ignored. + +**sortCond12Array (variable):** An array of [SortCond12](#sortcond12) structures that specifies the sort conditions. + +### SST + +The **SST** record specifies string constants. + +Each string constant in this record has one or more references in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), with the goal of improving performance in opening and saving the file. The [LabelSst](#labelsst) record specifies how to make a reference to a string in this record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cstTotal
cstUnique
rgb (variable)
...
+ +**cstTotal (4 bytes):** A signed integer that specifies the total number of references in the workbook to the strings in the shared string table. MUST be greater than or equal to 0. + +**cstUnique (4 bytes):** A signed integer that specifies the number of unique strings in the shared string table. MUST be greater than or equal to 0. + +**rgb (variable):** An array of [XLUnicodeRichExtendedString](#xlunicoderichextendedstring) structures. Records in this array are unique. + +### StartBlock + +The **StartBlock** record specifies the beginning of a collection of records. [Future records](#Section_b660b67822684414839ed1ae9a4e4e85) contained in this collection specify saved features to allow applications that do not support the feature to preserve the information. This record MUST have a matching [EndBlock](#endblock) record. StartBlock and EndBlock pairs can be nested. Up to 100 levels of blocks can be nested. + +Prior to writing a [chart-specific future record](#Section_0d96d51a09bd44ddbb691541de053776), which is a [record](#Section_170e90ce87d747589331dcf14cd72388) with a record number greater than or equal to 2048 and less than or equal to 2303, according to [Record Enumeration](#Section_7c84e174e96f45e0b23fa5e81f8b5def), StartBlock records MUST be written according to the following rules: + +- A StartBlock record MUST NOT be written if the record is preceded by a [StartObject](#startobject) record but not preceded by the matching [EndObject](#endobject) record. That is, StartBlock and EndBlock pairs MUST NOT belong to any collection defined by StartObject and EndObject. + +- If there does not exist a StartBlock record with **iObjectKind** equal to 0x000D without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x000D MUST be written. + +- If the chart-specific future record exists in the sequence of records that conforms to the [DAT](#chart-sheet-substream) rule, and there does not exist a StartBlock record with **iObjectKind** equal to 0x0006 without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x0006 MUST be written. If a StartBlock record is written because of rule number 2, then this StartBlock record MUST be written immediately after that record. + +- If the chart-specific future record is in a [series](#Section_527ce4dfc9f84e50a314d4b07519593c), and there does not exist a StartBlock record with **iObjectKind** equal to 0x000C without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x000C and **iObjectInstance1** equal to the number of series prior to this series in the current [Sheet](#Section_2c90d75bc92645aa8ff29d4483f51831) MUST be written. If any StartBlock records are written because of rule number 2 or 3, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record exists in the sequence of records that conforms to the SS rule, and there does not exist a StartBlock record with **iObjectKind** equal to 0x000E without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x000E, **iObjectContext** equal to the **yi** field of the [DataFormat](#dataformat) record in the current SS rule, and **iObjectInstance1** equal to the **xi** field of the DataFormat record in the current SS rule MUST be written. If any StartBlock records are written because of rule number 2, 3, or 4, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record is in a series, and is part of a collection defined by a [Begin](#begin) and [End](#end) pair written immediately after a [LegendException](#legendexception) record, and there does not exist a StartBlock record with **iObjectKind** equal to 0x000A without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x000A and **iObjectInstance1** equal to the **iss** field of the LegendException record in the series MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, or 5, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record is in an [axis group](#Section_578b739742624944b5a67ee6d4d3bb55). and there does not exist a StartBlock record with **iObjectKind** equal to 0x0000 without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x0000 and **iObjectInstance1** equal to the **iax** field of the [AxisParent](#axisparent) record of the axis group MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, or 6, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record is in a [Chart Group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), and there does not exist a StartBlock record with **iObjectKind** equal to 0x0005 without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x0005 and **iObjectInstance1** equal to the **iax** field of the AxisParent record of the axis group MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, or 7, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record is in an [axis](#Section_4117f73aa0f348d89c0f65864918ffb3), and there does not exist a StartBlock record with **iObjectKind** equal to 0x0004 without a matching EndBlock record, then: + + + +- If the chart-specific future record exists in the sequence of records that conforms to the IVAXIS rule, then a corresponding StartBlock record with **iObjectKind** equal to 0x0004 and **iObjectInstance1** equal to 0x0000 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, or 8, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record exists in the sequence of records that conforms to the SERIESAXIS rule, then a corresponding StartBlock record with **iObjectKind** equal to 0x0004 and **iObjectInstance1** equal to 0x0002 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, or 8, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record exists in the sequence of records that conforms to the DVAXIS rule, and **wType** of the [Axis](#axis-1) record in the sequence of records that conforms to the DVAXIS rule is equal to 0, then a corresponding StartBlock record with **iObjectKind** equal to 0x0004 and **iObjectInstance1** equal to 0x0001 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, or 8, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record exists in the sequence of records that conforms to the DVAXIS rule, and **wType** of the Axis record in the sequence of records that conforms to the DVAXIS rule is equal to 1, then a corresponding StartBlock record with **iObjectKind** equal to 0x0004 and **iObjectInstance1** equal to 0x0003 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, or 8, then this StartBlock record MUST be written immediately after those records. + + + +- If the chart-specific future record exists in the sequence of records that conforms to the DROPBAR rule, and there does not exist a StartBlock record with **iObjectKind** equal to 0x000F without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x000F and **iObjectInstance1** equal to one less than the number of [DropBar](#dropbar) records written prior to the chart-specific future record in the current Chart Group MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, or 9, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record is in a [legend](#Section_1832229b7d1945f488d455e9c07466f0) and there does not exist a StartBlock record with **iObjectKind** equal to 0x0009 without a matching EndBlock record, then: + + + +- If the chart-specific future record is in a chart group, then a corresponding StartBlock record with **iObjectKind** equal to 0x0009 and **iObjectContext** equal to 0x0001 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, or 10, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record is not in a chart group, then a corresponding StartBlock record with **iObjectKind** equal to 0x0009 and **iObjectContext** equal to 0x0000 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, or 10, then this StartBlock record MUST be written immediately after those records. + + + +- If the chart-specific future record is in an [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a), and there does not exist a StartBlock record with **iObjectKind** equal to 0x0002 without a matching EndBlock record, then: + + + +- If the chart-specific future record exists in the sequence of records that conforms to the DFTTEXT rule of a chart group, and the **id** field of the [DefaultText](#defaulttext) record in the sequence of records that conforms to the DFTTEXT rule is greater than or equal to 0x0002, then a corresponding StartBlock record with **iObjectKind** equal to 0x0002, **iObjectContext** equal to 0x0002, and **iObjectInstance1** equal to 0xFFFF MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, 10, or 11, then this StartBlock record MUST be written immediately after those records. Else, + +- If the chart-specific future record exists in the sequence of records that conforms to the DFTTEXT rule of a chart group, then a corresponding StartBlock record with **iObjectKind** equal to 0x0002, **iObjectContext** equal to 0x0002, and **iObjectInstance1** equal to the **id** field of the DefaultText record in the sequence of records that conforms to the DFTTEXT rule MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, 10, or 11, then this StartBlock record MUST be written immediately after those records. Else, + +- If the **wLinkVar1** of the [ObjectLink](#objectlink) record of the attached label is equal to 0x0003, then a corresponding StartBlock record with **iObjectKind** equal to 0x0002, **iObjectContext** equal to 0x0004 and **iObjectInstance1** equal to 0x0000 MUST be written. If any StartBlock records are written because of rules number 2, 3, 4, 5, 6, 7, 8, 9, 10 or 11, then this StartBlock record MUST be written immediately after those records. Else, + +- If the **wLinkVar1** of the ObjectLink record of the attached label is equal to 0x0002, then a corresponding StartBlock record with **iObjectKind** equal to 0x0002, **iObjectContext** equal to 0x0004 and **iObjectInstance1** equal to 0x0001 MUST be written. If any StartBlock records are written because of rules number 2, 3, 4, 5, 6, 7, 8, 9, 10 or 11, then this StartBlock record MUST be written immediately after those records. Else, + +- If the **wLinkVar1** of the ObjectLink record of the attached label is equal to 0x0007, then a corresponding StartBlock record with **iObjectKind** equal to 0x0002, **iObjectContext** equal to 0x0004, and **iObjectInstance1** equal to 0x0002 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, 10, or 11, then this StartBlock record MUST be written immediately after those records. Else, + +- If the chart-specific future record is in the first attached label of a chart sheet, then a corresponding StartBlock record with **iObjectKind** equal to 0x0002 and **iObjectContext** equal to 0x0000 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, 10, or 11, then this StartBlock record MUST be written immediately after those records. Else, + +- If the chart-specific future record is not in the first attached label of a chart sheet, then a corresponding StartBlock record with **iObjectKind** equal to 0x0002 and **iObjectContext** equal to 0x0005, **iObjectInstance1** equal to **wLinkVar1** of the ObjectLink record of the attached label and **iObjectInstance2** equal to **wLinkVar2** of the ObjectLink record of the attached label MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, 10, or 11, then this StartBlock record MUST be written immediately after those records. + + + +- If the chart-specific future record exists in the sequence of records that conforms to the FRAME rule, and there does not exist a StartBlock record with **iObjectKind** equal to 0x0007 without a matching EndBlock record, then: + + + +- If the chart-specific future record is in an attached label or legend, then a corresponding StartBlock record with **iObjectKind** equal to 0x0007, **iObjectContext** equal to 0x0000, and **iObjectInstance1** equal to 0x0000 MUST be written. If any StartBlock records are written because of rules number 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12, then this StartBlock record MUST be written immediately after those records. Else, + +- If the chart-specific future record exists in the sequence of records that conforms to the AXES rule, then a corresponding StartBlock record with **iObjectKind** equal to 0x0007, **iObjectContext** equal to 0x0001, and **iObjectInstance1** equal to 0x0000 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12, then this StartBlock record MUST be written immediately after those records. Else, + +- If the chart-specific future record is in a Sheet, then a corresponding StartBlock record with **iObjectKind** equal to 0x0007, **iObjectContext** equal to 0x0002, and **iObjectInstance1** equal to 0x0000 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12, then this StartBlock record MUST be written immediately after those records. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
iObjectKindiObjectContext
iObjectInstance1iObjectInstance2
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0852. + +**iObjectKind (2 bytes):** An unsigned integer that specifies the type of object that is encompassed by the block. MUST be a value from the following table: + +| Value | Object Type | +|--------|------------------------| +| 0x0000 | Axis group | +| 0x0002 | Attached label record | +| 0x0004 | Axis | +| 0x0005 | Chart group | +| 0x0006 | [Dat](#dat) record | +| 0x0007 | Frame | +| 0x0009 | Legend | +| 0x000A | LegendException record | +| 0x000C | Series | +| 0x000D | Sheet | +| 0x000E | DataFormat record | +| 0x000F | DropBar record | + +**iObjectContext (2 bytes):** An unsigned integer that specifies the context of the object. This value further specifies the object specified in **iObjectKind**. MUST be a value from the following table: + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
iObjectKindiObjectContextiObjectInstance1iObjectInstance2Description of Future Record Type Contents
0x0000 (Axis group)0x00000x00000x0000Primary axis group of the current chart.

0x0000

+

(Axis group)

0x00000x00010x0000Secondary axis group of the current chart.

0x0002

+

(AttachedLabel)

0x00000x00000x0000Chart title of the current chart.

0x0002

+

(AttachedLabel)

0x00020x00000x0000Default data labels in the chart that are not displayed as a percentage of the sum of all data points, and that do not contain values.

0x0002

+

(AttachedLabel)

0x00020x00010x0000Default data labels that contain values or percentage values.

0x0002

+

(AttachedLabel)

0x00020xFFFF0x0000Default for all text in the chart.

0x0002

+

(AttachedLabel)

0x00040x00000x0000A: The title formatting Text record of the Category axis or horizontal value axis on a scatter or bubble chart group.

0x0002

+

(AttachedLabel)

0x00040x00010x0000B: The title formatting Text record of value axis or vertical value axis on a scatter or bubble chart group. A chart MUST NOT have both A and B.

0x0002

+

(AttachedLabel)

0x00040x00020x0000C: The title formatting Text record of the series axis. A chart MUST NOT have both B and C.

0x0002

+

(AttachedLabel)

0x0005Data Point IndexSeries IndexData labels for data points in visible series, identified by the zero-based index of the Series record of the current chart and the zero-based index of the AttachedLabel record of the current series.
0x0002 (AttachedLabel)0x00050xFFFFSeries IndexDefault data labels for a given series, identified by the zero-based index of the Series record of the current chart.
0x0004 (Axis)0x00000x00000x0000Category axis or fill effect of the walls of the current chart.
0x0004 (Axis)0x00000x00010x0000Value axis or fill effect of the walls of the current chart.
0x0004 (Axis)0x00000x00020x0000Series axis.
0x0004 (Axis)0x00000x00030x0000Horizontal value axis for scatter chart group.
0x0005 (Chart group)0x00000x00000x0000Chart group of the primary axis group.
0x0005 (Chart group)0x00000x00010x0000Chart group of the secondary axis group.
0x0006 (Dat)0x00000x00000x0000Data table definition.
0x0007 (Frame)0x00000x00000x0000Frame of the current CHARTFORMATS, LD, AXES, and ATTACHEDLABEL in the collection.
0x0007 (Frame)0x00010x00000x0000Frame of the plot area.
0x0007 (Frame)0x00020x00000x0000Frame of the chart area (section 2.2.3.17)
0x0009 (Legend)0x00000x00000x0000Legend of the data table.
0x0009 (Legend)0x00010x00000x0000Legend of the chart.
0x000A (LegendException)0x00000xFFFF0x0000Default legend formatting exception information for entries in the current legend.
0x000A (LegendException)0x0000Series Index0x0000Legend formatting exception information for a series index entry in the current legend, identified by the zero-based index of the Series record of the current chart.
0x000C (Series)0x0000Series Index0x0000Series of the current chart, identified by the zero-based index of the Series record of the current chart.
0x000D (Chart)0x00000x00000x0000Current chart.
0x000E (DataFormat)Series Index0xFFFF0x0000Default formatting for all data points of a given series identified by the zero-based index of the Series record of the current chart.
0x000E (DataFormat)Series IndexDataFormat Index0x0000Formatting of a given data point identified by the zero-based index of the Series record of the current chart and the zero-based index of the DataFormat record of the current chart.
0x000F (DropBar)0x00000x00000x0000Up bar of the current chart.
0x000F (DropBar)0x00000x00010x0000Down bar of the current chart.
+ +**iObjectInstance1 (2 bytes):** An unsigned integer that specifies additional information about the context of the object, together with **iObjectContext**, **iObjectInstance2,** and **iObjectKind**. This field MUST equal one of the values specified in the previous [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) under the **iObjectContext** field. + +**iObjectInstance2 (2 bytes):** An unsigned integer that specifies more information about the object context, together with **iObjectContext**, **iObjectInstance1**, and **iObjectKind.** This field MUST equal one of the values specified in the previous table under the **iObjectContext** field. + +### StartObject + +The **StartObject** record specifies the beginning of a collection of [Future Record Type](#Section_b660b67822684414839ed1ae9a4e4e85) records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a feature saved as a Future Record Type such that an application that does not support the feature can preserve it. This record MUST have a matching [EndObject](#endobject) record. StartObject and EndObject pairs can be nested. Up to 100 levels of blocks can be nested. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
iObjectKindiObjectContext
iObjectInstance1iObjectInstance2
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0854. + +**iObjectKind (2 bytes):** An unsigned integer that specifies the kind of object that is encompassed by the block. MUST be a value from the following table: + + +++++ + + + + + + + + + + + + + + + + + + + + + + + + +
ValueObject Type Encompassed By the BlockDescription of Future Record Type Contents
0x0010A sequence of records that conforms to the ATTACHEDLABEL rule is encompassed by the block.Display units labels of the current axis.
0x0011A sequence of records that conforms to *(Font [Fbi]) is encompassed by the block, as specified by the FONTLIST rule.Font cache for a given application version. The block contains fonts for only those records introduced in the specified application version.
0x0012

A DefaultText record followed by a sequence of records that conforms to the ATTACHEDLABEL rule is encompassed by the block when in a sequence of records that conforms to the DFTTEXT rule.

+

A sequence of records that conforms to the ATTACHEDLABEL rule is encompassed by the block when in a sequence of records that conforms to the CHARTFOMATS rule.

An extended data label.
+ +**iObjectContext (2 bytes):** An unsigned integer that specifies the object context. MUST be 0x0000. + +**iObjectInstance1 (2 bytes):** An unsigned integer that specifies additional information about the context of the object, together with **iObjectContext**, **iObjectInstance2**, and **iObjectKind**. This field MUST equal 0x0000 if **iObjectKind** is equal to 0x0010 or 0x0012. MUST be a value from the following table if **iObjectKind** is equal to 0x0011: + +| iObjectInstance1 | Application Version | +|----|----| +| 0x0008 | Specifies the application version.[\<120\>](#Appendix_A_120) | +| 0x0009 | Specifies the application version.[\<121\>](#Appendix_A_121) | +| 0x000A | Specifies the application version.[\<122\>](#Appendix_A_122) | +| 0x000B | Specifies the application version.[\<123\>](#Appendix_A_123) | +| 0x000C | Specifies the application version.[\<124\>](#Appendix_A_124) | +| 0x000E | Specifies the application version.[\<125\>](#Appendix_A_125) | +| 0x000F | Specifies the application version.[\<126\>](#Appendix_A_126) | + +**iObjectInstance2 (2 bytes):** An unsigned integer that specifies more information about the object context, together with **iObjectContext**, **iObjectInstance1** and **iObjectKind.** This field MUST equal 0x0000. + +### String + +The **String** record specifies the string value of a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
string (variable)
...
+ +**string (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the string value of a formula (section 2.2.2). The value of **string.cch** MUST be less than or equal to 32767. + +### Style + +The **Style** record specifies a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ixfeABbuiltInData (optional)
user (variable)
...
+ +**ixfe (12 bits):** An unsigned integer that specifies the zero-based index of the [cell style XF](#Section_3d5348ded9df4c31b1fd9f9377273152) in the collection of [XF](#xf) records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). See [XFIndex](#xfindex) for more information about the organization of XF records in the file. + +**A - unused (3 bits):** Undefined and MUST be ignored. + +**B - fBuiltIn (1 bit):** A bit that specifies whether the cell style is built-in. + +**builtInData (2 bytes):** An optional [BuiltInStyle](#builtinstyle) structure that specifies the built-in cell style properties. MUST exist if and only if **fBuiltIn** is 1. The value of **builtInData.istyBuiltIn** MUST be less than or equal to 0x09. + +**user (variable):** An optional [XLUnicodeString](#xlunicodestring) structure that specifies the name of the user-defined cell style. MUST exist if and only if **fBuiltIn** is 0. The number of characters in this string SHOULD be greater than or equal to 1 and MUST be less than or equal to 255.[\<127\>](#Appendix_A_127) + +### StyleExt + +The **StyleExt** record specifies additional information for a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
ABCreservediCategorybuiltInData
stName (variable)
...
xfProps (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0892. + +**A - fBuiltIn (1 bit):** A bit that specifies if this is a built-in cell style. If the value is 1, this is a built-in cell style. This value MUST match the **fBuiltIn** field of the preceding [Style](#style) record. + +**B - fHidden (1 bit):** A bit that specifies whether the cell style is not displayed in the user interface. + +**C - fCustom (1 bit):** A bit that specifies whether the built-in cell style was modified by the user and thus has a custom definition. If this field is equal to 1, then **fBuiltIn** MUST equal 1. + +**reserved (5 bits):** MUST be zero and MUST be ignored. + +**iCategory (1 byte):** An unsigned integer that specifies which [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) that this style belongs to. MUST be one of the values from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------------------------| +| 0x00 | Custom style | +| 0x01 | Good, bad, neutral style | +| 0x02 | Data model style | +| 0x03 | Title and heading style | +| 0x04 | Themed cell style | +| 0x05 | [**Number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) style | + +**builtInData (2 bytes):** A [BuiltInStyle](#builtinstyle) structure that specifies the built-in cell style properties. If **fBuiltIn** is 0, this field MUST be 0xFFFF and MUST be ignored. If **fBuiltIn** is 1, this field MUST match the **builtInData** field of the preceding Style record. + +**stName (variable):** An [LPWideString](#lpwidestring) structure that specifies the name of the style to extend. MUST be less than or equal to 255 characters in length. If **fBuiltIn** is 0, the name specified by this field MUST match the name specified by the **user** field of the preceding Style record. + +**xfProps (variable):** An [XFProps](#xfprops) structure that specifies the formatting properties. + +### SupBook + +The **SupBook** record specifies a [supporting link](#Section_cc5920ba01074d92bbdfc12ca986f31f) and specifies the beginning of a collection of records as defined by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies the contents of an [external workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc), [DDE data source](#Section_b11538fba8244cc3bf8834a1cf5f3559), or [OLE data source](#Section_2318e95632614d72a28e412392b8c919). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ctabcch
virtPath (variable)
...
rgst (variable)
...
+ +**ctab (2 bytes):** An undefined field, a reserved field, or an unsigned integer that specifies the number of [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in a referenced external workbook. The type and meaning of this field is dependent on the type of supporting link specified by the **cch** and **virtPath** fields, and is defined in the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Type of supporting link specified by cch and virtPathMeaning
Self-referencingUndefined and MUST be ignored.

Same-sheet referencing

+

DDE data source referencing

+

OLE data source referencing

Reserved. MUST be 0x0000.
Add-in referencingReserved. MUST be 0x0001.
External workbook referencingAn unsigned integer that specifies the count of sheets in the referenced external workbook.
UnusedAn unsigned integer that specifies the count of sheets in the external workbook formerly referenced by this supporting link, if this supporting link was an external workbook referencing type, when used. Otherwise, this value MUST be 0x0000.
+ +**cch (2 bytes):** An unsigned integer that specifies a type of supporting link or specifies the length of the string in **virtPath**. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0401 | This record specifies a self-referencing supporting link. | +| 0x3A01 | This record specifies an add-in referencing type of supporting link. The names of all [**add-in functions**](#gt_19f0478a-919a-4951-b8c0-f9900a1ddd3e) implemented by [**XLL**](#gt_3d6e3f45-91e7-46d5-871c-0b2fde20b5f5), or [**COM**](#gt_ef2ebebc-1760-407a-9ace-af48f9050e02) automation [**add-ins**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6) that are referenced by formulas in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), MUST be specified in the [ExternName](#externname) records that follow this record. | +| 0x0001 to 0x00ff (inclusive) | The type of supporting link specified by this record is specified by **virtPath**. This value is the count of characters in **virtPath**. | + +**virtPath (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the type of supporting link and, if applicable, the target of that supporting link. This field MUST exist if and only if the value of **cch** is between 0x0001 and 0x00ff (inclusive). The length of the string in this field MUST be equal to **cch**. The contents of this field MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| A single character of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) value 0x20 (SPACE) | This record specifies an unused supporting link. This supporting link MUST NOT be used by any [external reference consumers](#Section_70b28c8b29cb4aff89f5d6023c28fbf6). | +| A single character of Unicode value 0x00 (NULL) | This record specifies a same-sheet referencing type of supporting link. | +| A string that conforms to the OLE-link rule, as specified in [VirtualPath](#virtualpath) | This record specifies a DDE data source referencing or an OLE data source referencing type of supporting link. The value of this field specifies the target of the supporting link. | +| A string that conforms to the virt-path rule, but does not conform to the ole-link rule, as specified in VirtualPath | This record specifies an external workbook referencing type of supporting link. The value of this field specifies the path and file name of the external workbook. | + +**rgst (variable):** An array of [XLUnicodeString](#xlunicodestring) structures that specify sheet names in the external workbook. This field MUST exist if and only if the supporting link type specified by **cch** and **virtPath** is external workbook referencing or unused. If this field exists, the number of elements in this array MUST be equal to **ctab.** The contents and meaning of this array are defined in the following table: + +| Type of supporting link | rgst value | +|----|----| +| External workbook referencing | An array of XLUnicodeString structures that specify the sheet names in the external workbook. Each element in this array MUST conform to the restrictions set on the **stName** field of the [BoundSheet8](#boundsheet8) record. | +| Unused | An array of XLUnicodeString structures that provide placeholders for any [XTI](#xti) references to sheets in this unused supporting link. Each element in this array MUST be a string that contains a single character of Unicode value 0x20 (SPACE). | + +### Surf + +The **Surf** record specifies that the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is a surface chart group and specifies the chart group attributes. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ABreserved
+ +**A - fFillSurface (1 bit):** A bit that specifies whether the surface chart group is wireframe or has a [**fill**](#gt_215c1c51-d5ef-46af-8596-d7ef63c1fe89). MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------| +| 0 | Surface chart group is wireframe. | +| 1 | Surface chart group has a fill. | + +**B - f3DPhongShade (1 bit):** A bit that specifies whether [**3-D Phong shading**](#gt_f97b18d4-bf3e-4e80-bd1c-4f58aba7c43b) is displayed. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +### SXAddl Records + +#### Continue_SxaddlSxString + +The **Continue_SxaddlSxString** record specifies a continuation of the [SXAddl_SXString](#sxaddl_sxstring) in the preceding [SXAddl](#sxaddl) record. If the string specified by the SXAddl_SXString is longer than 255 characters, the first 255 characters of the string exist in the SXAddl_SXString in the preceding SXAddl record. Subsequent 255 character segments exist in one or more Continue_SxaddlSxString records that exist after the SXAddl record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stContinue (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of the **hdr.sxc** field MUST equal the value of the **hdr.sxc** field of the preceding SXAddl record and the **hdr.sxd** field MUST equal the value of the **hdr.sxd** field of the preceding SXAddl record. + +**stContinue (variable):** An SXAddl_SXString structure that specifies the next segment of the string. + +#### SXAddl + +The **SXAddl** record specifies additional information for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e), or [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289). The current [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) and full type of this record are specified by the **hdr** field which determines the contents of the **data** field. See [Usage of SXAddl records](#Section_db61fa8bdb7b4e1c99615c2f3ed1c369) for more information. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...data (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure that specifies header information for an SXAddl record. + +**data (variable):** A variable-size field that contains data specific to the full record type of the SXAddl record. + +#### SXAddl_SXCAutoSort_SXDEnd + +The **SXAddl_SXCAutoSort_SXDEnd** record specifies the end of an [SXCAutoSort class](#Section_212512d2c740431f838b7ec651364e2f). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x12 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCAutoSort_SXDId + +The **SXAddl_SXCAutoSort_SXDId** record specifies information for [pivot field sorting](#Section_6a008d4253834e13a1d06d8ee5d93b76) for an [SXCAutoSort class](#Section_212512d2c740431f838b7ec651364e2f). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...Areserved1
...reserved2
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x12 and the value of **hdr.sxd** MUST equal 0x00. + +**A - fAscendSort (1 bit):** A bit that specifies whether the [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7) is ascending or descending. The value MUST be one of the values from the following table: + +| Value | Description | +|-------|---------------------------| +| 0 | Sort order is descending. | +| 1 | Sort order is ascending. | + +**reserved1 (31 bits):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCache_SXDEnd + +The **SXAddl_SXCCache_SXDEnd** record specifies the end of an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x03 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCache_SXDId + +The **SXAddl_SXCCache_SXDId** record specifies how an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7) is associated with other records for a [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...idCache
...reserved
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x03 and the value of **hdr.sxd** MUST equal 0x00. + +> **idCache (4 bytes):** An unsigned integer that specifies the PivotCache [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) associated with this SxcCache class. MUST be equal to the **idStm** field of the [SXStreamID](#sxstreamid) record of the PivotCache stream associated with this SxcCache class. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCache_SXDInfo12 + +The **SXAddl_SXCCache_SXDInfo12** record specifies information for a [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) for an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...ABCreserved1
...reserved2
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x03 and the value of **hdr.sxd** MUST equal 0x41. + +**A - fSheetData (1 bit):** MUST be zero, and MUST be ignored. + +**B - fSrvSupportAttribDrill (1 bit):** A bit that specifies whether the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) of the PivotCache supports attribute drilldown. MUST be ignored if the data source is not [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f). + +**C - fSrvSupportSubQuery (1 bit):** A bit that specifies whether the data source of the PivotCache supports the MDX SUBSELECT statement. MUST be ignored if the data source is not OLAP. + +**reserved1 (29 bits):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCache_SXDInvRefreshReal + +The **SXAddl_SXCCache_SXDInvRefreshReal** record specifies properties related to [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) for an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...ABreserved1
...reserved2
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x03 and the value of **hdr.sxd** MUST equal 0x34. + +**A - fEnableRefresh (1 bit):** A bit that specifies whether refresh is enabled for the PivotCache. + +**B - fInvalid (1 bit):** A bit that specifies whether the [cache records](#Section_fe6e4ca0a9b646a4898124e4b61a770a) are not valid. If the value is 1, the cache records MUST be ignored. See cache record for more information. + +**reserved1 (30 bits):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCache_SXDVer10Info + +The **SXAddl_SXCCache_SXDVer10Info** record specifies information for a [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) for an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved1
...
citmGhostMax
bVerCacheLastRefreshbVerCacheRefreshableMinnumDateCopy
...
...reserved2
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x03 and the value of **hdr.sxd** MUST equal 0x02. + +**reserved1 (6 bytes):** MUST be zero, and MUST be ignored. + +**citmGhostMax (4 bytes):** A signed integer that specifies the number of unused [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) to allow before discarding unused cache items. MUST[\<128\>](#Appendix_A_128) be greater than or equal to -1 and less than or equal to 1048576. If this value is -1, the number of unused cache items retained by the application is optimized to balance memory usage on the system and future usage of cache items. + +**bVerCacheLastRefresh (1 byte):** A [DataFunctionalityLevel](#datafunctionalitylevel) type that specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) that the PivotCache was last refreshed with. MUST be 0xFF or one of the values of the DataFunctionalityLevel type. If this value is equal to 0xFF, the data functionality level is not set. + +**bVerCacheRefreshableMin (1 byte):** A DataFunctionalityLevel type that specifies the lowest data functionality level the application is allowed to [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) the PivotCache with. MUST be 0xFF or one of the values of the DataFunctionalityLevel type. If this value is equal to 0xFF, the data functionality level is not set. + +**numDateCopy (8 bytes):** A [DateAsNum](#dateasnum) structure that specifies the date and time when the PivotCache was last refreshed. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCache_SXDVerSXMacro + +The **SXAddl_SXCCache_SXDVerSXMacro** record specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) of the application that created the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) for an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...dwVerreserved1
reserved2reserved3
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x03 and the value of **hdr.sxd** MUST equal 0x18. + +**dwVer (1 byte):** A [DataFunctionalityLevel](#datafunctionalitylevel) type that specifies the data functionality level that the PivotCache was created with. + +**reserved1 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCache_SXDVerUpdInv + +The **SXAddl_SXCCache_SXDVerUpdInv** record specifies the record-handling behavior for following records of the [SXCCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
data
...
...
+ +**data (12 bytes):** An [SXAddl_SXDVerUpdInv](#sxaddl_sxdverupdinv) structure. The value of **data.hdr.sxc** MUST equal 0x03 and the value of **data.hdr.sxd** MUST equal 0x01. The value of **data.dwVersionInvalidates** MUST equal 0x0002 or 0x00FF. + +If the value of **data.dwVersionInvalidates** is not 0x00FF and is greater than or equal to the value of the **bVerCacheLastRefresh** field of the [SXAddl_SXCCache_SXDVer10Info](#sxaddl_sxccache_sxdver10info) record of this SXCCache class, the following records of this SXCCache class (including nested classes or until another SXAddl_SXCCache_SXDVerUpdInv record is encountered) MUST be ignored. + +#### SXAddl_SXCCacheField_SXDCaption + +The **SXAddl_SXCCacheField_SXDCaption** record specifies the caption of a [cache field](#Section_6497eb794042445780e75959c9f0583c) for an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). This record exists only if this is an [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b) and the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than 2. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stCaption (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0x2F. + +**stCaption (variable):** A [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the caption of the cache field. The number of characters in the string MUST be less than or equal to 255. + +#### SXAddl_SXCCacheField_SXDEnd + +The **SXAddl_SXCCacheField_SXDEnd** record specifies the end of an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCacheField_SXDId + +The **SXAddl_SXCCacheField_SXDId** record specifies how an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103) is associated with other records for a [cache field](#Section_6497eb794042445780e75959c9f0583c). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stSourceName (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0x00. + +**stSourceName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the cache field to which this SxcCacheField class applies. The number of characters in the string MUST be less than or equal to 255. The corresponding [SXFDB](#sxfdb) record is the SXFDB record with its **stFieldName** field equal to the value of this field. If there exists no such SXFDB record, then this SxcCacheField class MUST be ignored. + +#### SXAddl_SXCCacheField_SXDIfdbMempropMap + +The **SXAddl_SXCCacheField_SXDIfdbMempropMap** record specifies the indexes of the [member properties](#Section_e5db3a66677f43db8fb038584797c95f) for the [cache field](#Section_6497eb794042445780e75959c9f0583c) for an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). This record exists only if this is an [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b) and the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than 2. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
rgMap (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0x30. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +**rgMap (variable):** An array of 2-byte unsigned integers. The array MUST NOT be empty. Each element in the array specifies a cache field index, as specified by Cache Fields. The referenced cache field is associated with a member property as specified in member properties. The **isxtl** field of the [SXVDTEx](#sxvdtex) record of the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) associated with the referenced cache field MUST be equal to 0x00007FFF or equal to **isxtl** of the SXVDTEx record of the pivot field associated with this cache field. The **ihdb** field of the [SXAddl_SXCCacheField_SXDProperty](#sxaddl_sxccachefield_sxdproperty) record associated with the referenced cache field MUST be equal to the **isxth** field of SXVDTEx record of the pivot field associated with this cache field. The size of the array MUST be equal to the **ifdbMemProp** field in the [SXAddl_SXCCacheField_SXDIfdbMpMapCount](#sxaddl_sxccachefield_sxdifdbmpmapcount) record in this [SXAddl](#sxaddl) collection. The value of each element in the array MUST be less than the number of cache fields in this [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) as specified by the cfdbdb field of the [SXDB](#sxdb) record for this PivotCache. + +#### SXAddl_SXCCacheField_SXDIfdbMpMapCount + +The **SXAddl_SXCCacheField_SXDIfdbMpMapCount** record specifies the number of [member properties](#Section_e5db3a66677f43db8fb038584797c95f) for the [cache field](#Section_6497eb794042445780e75959c9f0583c), for an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). This record exists only if this is an [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b) and the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than 2. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...ifdbMemProp
...reserved
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0x31. + +**ifdbMemProp (4 bytes):** An unsigned integer that specifies the number of elements in the array specified by the **rgMap** field of the [SXAddl_SXCCacheField_SXDIfdbMempropMap](#sxaddl_sxccachefield_sxdifdbmempropmap) record that follows this record. MUST be greater than 0 and less than the number of cache fields in this [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCacheField_SXDProperty + +> The **SXAddl_SXCCacheField_SXDProperty** record specifies the hierarchy information of the [cache field](#Section_6497eb794042445780e75959c9f0583c) for an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). This record exists only if this is an [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b), the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than 2, and this cache field is associated with a [member property](#Section_e5db3a66677f43db8fb038584797c95f). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...ihdb
...reserved
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0x05. + +**ihdb (4 bytes):** An unsigned integer that specifies a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) index. The pivot hierarchy index specifies which pivot hierarchy this cache field is part of. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCacheField_SXDPropName + +The **SXAddl_SXCCacheField_SXDPropName** record specifies the name of a [member property](#Section_e5db3a66677f43db8fb038584797c95f) of the associated [cache field](#Section_6497eb794042445780e75959c9f0583c) for an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). This record exists only if this is an [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b), the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than 2, and this cache field is associated with a member property. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stPropName (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0x40. + +**stPropName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the member property associated with this cache field. The length of the string MUST be greater than 0 and less than 32768. + +#### SXAddl_SXCCacheField_SXDSxrmitmCount + +The **SXAddl_SXCCacheField_SXDSxrmitmCount** record specifies the number of [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) records in this [cache field](#Section_6497eb794042445780e75959c9f0583c) for an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). This record exists only if this is an [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b) and the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than 2. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...citm
...reserved
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0x2D. + +**citm (4 bytes):** An unsigned integer that specifies the number of cache item records. The value MUST be greater than or equal to 0 and less than or equal to 1048576. The number of [SXADDLCACHEITEM](#globals-substream) collections that follows this record MUST match this value. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCacheItem_SXDEnd + +The **SXAddl_SXCCacheItem_SXDEnd** record specifies the end of a collection of [SxcCacheItem classes](#Section_23b4298b5a8e4357b2c07c2ea90d91c5) for the [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x09 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCacheItem_SXDId + +The **SXAddl_SXCCacheItem_SXDId** record specifies how an [SxcCacheItem class](#Section_23b4298b5a8e4357b2c07c2ea90d91c5) is associated with other records for a [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0). The records of this class exist if and only if this is an [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b), the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than or equal to 3, the **fAllAtoms** field of the [SXFDB](#sxfdb) record of this [cache field](#Section_6497eb794042445780e75959c9f0583c) is equal to 1, and the **catm** field of that SXFDB record is greater than 0. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...dwItem
...reserved
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x09 and the value of **hdr.sxd** MUST equal 0x00. + +**dwItem (4 bytes):** An unsigned integer that specifies the cache item index that this SxcCacheItem class applies to. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCacheItem_SXDItmMpMapCount + +The **SXAddl_SXCCacheItem_SXDItmMpMapCount** record specifies the number of [member property](#Section_e5db3a66677f43db8fb038584797c95f) mappings for this [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0), for an [SxcCacheItem class](#Section_23b4298b5a8e4357b2c07c2ea90d91c5). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...cMemProps
...reserved
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x09 and the value of **hdr.sxd** MUST equal 0x33. + +**cMemProps (4 bytes):** An unsigned integer that specifies the number of member property mappings for this cache item. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCacheItem_SXDItmMpropMap + +The **SXAddl_SXCCacheItem_SXDItmMpropMap** record specifies the mapping of the [member properties](#Section_e5db3a66677f43db8fb038584797c95f) for this [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0), for an [SxcCacheItem class](#Section_23b4298b5a8e4357b2c07c2ea90d91c5). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
rgMemProps (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x09 and the value of **hdr.sxd** MUST equal 0x32. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +**rgMemProps (variable):** An array of 4-byte signed integers. Each element of this array specifies a cache item index, as specified by Cache Items, in the [cache field](#Section_6497eb794042445780e75959c9f0583c) associated with that element. For a given element, the associated cache field is the cache field specified by the element with the same index in the **rgMap** array of the preceding [SXAddl_SXCCacheField_SXDIfdbMempropMap](#sxaddl_sxccachefield_sxdifdbmempropmap) record. Each referenced cache item specifies a member property value. + +A value of -1 specifies no cache item. Each element in this array MUST be greater than or equal to -1. + +#### SXAddl_SXCCacheItem_SXDSxrmitmDisp + +The **SXAddl_SXCCacheItem_SXDSxrmitmDisp** record specifies the display name of this [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) for an [SxcCacheItem class](#Section_23b4298b5a8e4357b2c07c2ea90d91c5). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stDisplay (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x09 and the value of **hdr.sxd** MUST equal 0x2E. + +**stDisplay (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the display name of this cache item. + +#### SXAddl_SXCField_SXDEnd + +The **SXAddl_SXCField_SXDEnd** record specifies the end of an [SxcField class](#Section_51de615365d949198b2a537779e0a9f7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x01 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCField_SXDId + +The **SXAddl_SXCField_SXDId** record specifies how an [SxcField class](#Section_51de615365d949198b2a537779e0a9f7) is associated with other records for a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stName (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x01 and the value of **hdr.sxd** MUST equal 0x00. + +**stName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the pivot field to which this SxcField class applies. The corresponding [SXFDB](#sxfdb) record, of the associated [cache field](#Section_6497eb794042445780e75959c9f0583c) of this pivot field, is the SXFDB record with its **stFieldName** field equal to the value of this field. If there exists no such SXFDB record, then this SxcField class MUST be ignored. + +#### SXAddl_SXCField_SXDVer10Info + +The **SXAddl_SXCField_SXDVer10Info** record specifies additional properties of the [PivotTable fields](#Section_1edf7f2294084945b2de56526c14fca5) for an [SxcField class](#Section_51de615365d949198b2a537779e0a9f7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...Areserved1
...reserved2
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x01 and the value of **hdr.sxd** MUST equal 0x02. + +**A - fHideDD (1 bit):** A bit that specifies whether the per pivot field drop-down user interface is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) for the pivot field. + +**reserved1 (31 bits):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCField12_SXDAutoshow + +The **SXAddl_SXCField12_SXDAutoshow** record specifies the number of items for [simple filters](#Section_d662b8d1d1234fc5bac05fd76cdf0ff0) in the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) for an [SXCField12 class](#Section_4bd42ced53544e2ea2665ea9f7787a85). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...citmAutoShow
...reserved
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x17 and the value of **hdr.sxd** MUST equal 0x37. + +**citmAutoShow (4 bytes):** An unsigned integer that specifies the number of items for simple filters. The value MUST be greater than or equal to 1 and less than or equal to 0x7FFFFFFF. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCField12_SXDEnd + +The **SXAddl_SXCField12_SXDEnd** record specifies the end of an [SXCField12 class](#Section_4bd42ced53544e2ea2665ea9f7787a85). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x17 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCField12_SXDId + +The **SXAddl_SXCField12_SXDId** record specifies how this [SXCField12 class](#Section_4bd42ced53544e2ea2665ea9f7787a85) is associated with other records for a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stName (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x17 and the value of **hdr.sxd** MUST equal 0x00. + +**stName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the pivot field to which this SXCField12 class applies. The corresponding [SXFDB](#sxfdb) record, of the associated [cache field](#Section_6497eb794042445780e75959c9f0583c) of this pivot field, is the SXFDB record with its **stFieldName** field equal to the value of this field. If there exists no such SXFDB record, then this SXCField12 class MUST be ignored. + +#### SXAddl_SXCField12_SXDISXTH + +The **SXAddl_SXCField12_SXDISXTH** record specifies a particular [Pivot Hierarchy](#Section_54818c671590494084e0c3ff8b433c33) to which this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) is associated for an [SXCField12 class](#Section_4bd42ced53544e2ea2665ea9f7787a85). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...isxth
...reserved
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x17 and the value of **hdr.sxd** MUST equal 0x1C. + +**isxth (4 bytes):** An unsigned integer that specifies a pivot hierarchy index that specifies the pivot hierarchy to which this pivot field is associated. See [Association of Pivot Hierarchies and Pivot Fields and Cache Fields](#Section_01a66b9be4a24396b55c28d6207fd28f) for more information. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCField12_SXDMemberCaption + +The **SXAddl_SXCField12_SXDMemberCaption** record specifies the name of the [member property](#Section_e5db3a66677f43db8fb038584797c95f) used as a caption for the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5), for an [SXCField12 class](#Section_4bd42ced53544e2ea2665ea9f7787a85). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stMemberPropertyCaptionUnique (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x17 and the value of **hdr.sxd** MUST equal 0x11. + +**stMemberPropertyCaptionUnique (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the unique name of the member property used as a caption for the pivot field. MUST be ignored if the value of **fUseMemPropCaption** in [SXAddl_SXCField12_SXDVer12Info](#sxaddl_sxcfield12_sxdver12info) is not equal to 1. + +#### SXAddl_SXCField12_SXDVer12Info + +The **SXAddl_SXCField12_SXDVer12Info** record specifies additional properties of a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) for an [SXCField12 class](#Section_4bd42ced53544e2ea2665ea9f7787a85). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...ABCDEFreserved2
...reserved3
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x17 and the value of **hdr.sxd** MUST equal 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - fHiddenLvl (1 bit):** A bit that specifies whether the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) pivot field is a [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) level. The value is ignored if it is not an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f). + +**C - fUseMemPropCaption (1 bit):** A bit that specifies whether the [member property](#Section_e5db3a66677f43db8fb038584797c95f) is used as a caption for the pivot field. If it is set and there is a [SXAddl_SXCField12_SXDMemberCaption](#sxaddl_sxcfield12_sxdmembercaption) record in this SXCField12 class, then the value from the member property specified by SXAddl_SXCField12_SXDMemberCaption is used as captions for the [pivot items](#Section_58891cc5dd9b4293a97831070779524f) of this pivot field. + +**D - fCompact (1 bit):** A bit that specifies where the next pivot field is displayed in the [PivotTable layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4). + +| Value | Meaning | +|----|----| +| 0x0 | The pivot field is displayed in the next column on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). | +| 0x1 | The pivot field is displayed in the same column on the sheet. | + +**E - fNotAutoSortDft (1 bit):** A bit that specifies whether, during the next sort operation that is done on this pivot field, the pivot items are sorted or whether the sort condition is remembered and reapplied on subsequent recalculation of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). A value of 1 specifies that pivot items are to be sorted. + +**F - fFilterInclusive (1 bit):** A bit that specifies whether any [manual filter](#Section_b0b282651e334c86ad030f5693c1d1e4) applied to this pivot field specifies pivot items that are included or excluded. If this pivot field is associated with a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), this value MUST equal the **fFilterInclusive** field on the [SXTH](#sxth) record that specifies the pivot hierarchy that this pivot field is associated with. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Any manual filter applied to this pivot field specifies pivot items that are excluded. | +| 0x1 | Any manual filter applied to this pivot field specifies pivot items that are included. | + +**reserved2 (26 bits):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCField12_SXDVerUpdInv + +The **SXAddl_SXCField12_SXDVerUpdInv** record specifies the record handling behavior for following records of the [SXCField12 class](#Section_4bd42ced53544e2ea2665ea9f7787a85). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
data
...
...
+ +**data (12 bytes):** An [SXAddl_SXDVerUpdInv](#sxaddl_sxdverupdinv) structure. The value of **data.hdr.sxc** MUST equal 0x17 and the value of **data.hdr.sxd** MUST equal 0x01. The value of **data.dwVersionInvalidates** MUST equal 0x0002 or 0x00FF. + +If the value of **data.dwVersionInvalidates** is not equal to 0x00FF and is greater than or equal to the value of the **VerSxLastUpdated** field of the [QsiSXTag](#qsisxtag) record of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), the following records of this SXCField12 class, including nested classes or until another SXAddl_SXCField12_SXDVerUpdInv record is encountered, MUST be ignored. + +#### SXAddl_SXCGroup_SXDEnd + +The **SXAddl_SXCGroup_SXDEnd** record specifies the end of an [SxcGroup class](#Section_664bdb47dfb148b69cbd2d9b6bc48600). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x08 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCGroup_SXDGrpInfo + +The **SXAddl_SXCGroup_SXDGrpInfo** record specifies information about an [OLAP grouping](#Section_1e04807706d14d4f961ecacb50a12a3d) for an [SxcGroup class](#Section_664bdb47dfb148b69cbd2d9b6bc48600). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...ABCDreserved2
...reserved3
stUniqueName (variable)
...
stCaption (variable)
...
stParentUniqueName (variable)
...
iGroupNum
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x08 and the value of **hdr.sxd** MUST equal 0x07. + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - reserved1 (2 bits):** MUST be zero, and MUST be ignored. + +**C - unused2 (1 bit):** Undefined and MUST be ignored. + +**D - fHasNoParent (1 bit):** A bit that specifies whether the **stParentUniqueName** field does not exist. + +**reserved2 (27 bits):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**stUniqueName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the fully qualified unique name of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) group. The length of this field MUST be less than or equal to 255 characters. + +**stCaption (variable):** An XLUnicodeString structure that specifies the caption (display name) of the OLAP group. The length of this field MUST be less than or equal to 255 characters. + +**stParentUniqueName (variable):** An optional XLUnicodeString structure that specifies an [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32), which is the parent of the [**members (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) of this group in the OLAP [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7). This field exists if and only if the value of **fHasNoParent** is zero. The length of this field MUST be less than or equal to 255 characters. + +**iGroupNum (4 bytes):** A signed integer that specifies a unique identifier for this OLAP group within the OLAP grouping level containing it. MUST be greater than zero. + +#### SXAddl_SXCGroup_SXDId + +The **SXAddl_SXCGroup_SXDId** record specifies information about an [OLAP grouping](#Section_1e04807706d14d4f961ecacb50a12a3d) for an [SxcGroup class](#Section_664bdb47dfb148b69cbd2d9b6bc48600). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stName (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x08 and the value of **hdr.sxd** MUST equal 0x00. + +**stName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) group. MUST contain less than or equal to 255 characters. + +#### SXAddl_SXCGroup_SXDMember + +The **SXAddl_SXCGroup_SXDMember** record specifies an [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) or the name of a group in the subsequent [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) that is part of this [OLAP grouping](#Section_1e04807706d14d4f961ecacb50a12a3d) for an [SxcGroup class](#Section_664bdb47dfb148b69cbd2d9b6bc48600). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...ABCreserved1
...reserved2
stUnique (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x08 and the value of **hdr.sxd** MUST equal 0x08. + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - fGroup (1 bit):** A bit that specifies whether this record specifies the name of a group in the subsequent OLAP level. + +| Value | Meaning | +|----|----| +| 0 | This record specifies an OLAP member. | +| 1 | This record specifies the name of a group in the subsequent OLAP level. | + +**C - unused2 (1 bit):** Undefined and MUST be ignored. + +**reserved1 (29 bits):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +**stUnique (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of an OLAP member or the name of a group in the subsequent OLAP level. If the value of **fGroup** is 0, this is an MDX unique name of an OLAP member. If the value of **fGroup** is 1, this is a group name and it MUST match the **stName** field in one of the [SXAddl_SXCGroup_SXDId](#sxaddl_sxcgroup_sxdid) records for the subsequent OLAP level. The length of this field MUST be less than or equal to 255 characters. + +#### SXAddl_SXCGrpLevel_SXDEnd + +The **SXAddl_SXCGrpLevel_SXDEnd** record specifies the end of an [SxcGrpLevel class](#Section_86689e7b9d264225b6be580f86cea53e). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x07 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCGrpLevel_SXDGrpLevelInfo + +The **SXAddl_SXCGrpLevel_SXDGrpLevelInfo** record specifies information about an [OLAP group](#Section_1e04807706d14d4f961ecacb50a12a3d) for an [SxcGrpLevel class](#Section_86689e7b9d264225b6be580f86cea53e). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...ABCreserved2
...reserved3
stLevelName (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x08 and the value of **hdr.sxd** MUST equal 0x06. + +**A - fGroupLevel (1 bit):** A bit that specifies whether this is a user-defined group level. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The record specifies a group level that corresponds to the source [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7) level. | +| 1 | The record specifies a user-defined group level. | + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fCustomRollup (1 bit):** A bit that specifies whether the OLAP group level has [**custom rollup**](#gt_2748adff-afd3-4c5d-8095-ec69348c0a89). + +**reserved2 (29 bits):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**stLevelName (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the display name of the OLAP group level. The length of this field MUST be less than or equal to 255 characters. + +#### SXAddl_SXCGrpLevel_SXDId + +The **SXAddl_SXCGrpLevel_SXDId** record specifies information about an [OLAP group](#Section_1e04807706d14d4f961ecacb50a12a3d), for an [SxcGrpLevel class](#Section_86689e7b9d264225b6be580f86cea53e). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stUnique (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x07 and the value of **hdr.sxd** MUST equal 0x00. + +**stUnique (variable):** An [SXAddl_SXString](#sxaddl_sxstring) that specifies the unique name of the OLAP group level. + +#### SXAddl_SXCHierarchy_SXDDisplayFolder + +The **SXAddl_SXCHierarchy_SXDDisplayFolder** record specifies the name for the [**display folder**](#gt_6571ebdb-265a-40a1-807b-2aac2b5697d8) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) for an [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stDisplayFolder (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x25. + +**stDisplayFolder (variable):** An [SXAddl_SXString](#sxaddl_sxstring) that specifies the name of the pivot hierarchy display folder. + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 65535 characters. + +#### SXAddl_SXCHierarchy_SXDEnd + +The **SXAddl_SXCHierarchy_SXDEnd** record specifies the end of an [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCHierarchy_SXDFilterMember + +The **SXAddl_SXCHierarchy_SXDFilterMember** record specifies [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) used in [OLAP page filtering](#Section_e04e871619234e2db02a270894d6be73) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) for an [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4) is greater than or equal to 3. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...ABreserved2
...reserved3
cItemsrgStPageItems (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x09. + +**A - reserved1 (1 bit):** MUST be 1 and MUST be ignored. + +**B - fMultFiltHavePlex (1 bit):** A bit that specifies whether multiple OLAP members in this pivot hierarchy are selected in the OLAP page filtering. If the value of this field is 0, **cItems** and **rgStPageItems** MUST be ignored. + +**reserved2 (30 bits):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**cItems (2 bytes):** An unsigned integer that specifies the number of elements in **rgStPageItems**. MUST be greater than 0 if **fMultFiltHavePlex** is 1. + +**rgStPageItems (variable):** An array of [XLUnicodeString](#xlunicodestring). Each element specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of an OLAP member selected in the OLAP page filtering. The number of elements in the array is specified by **cItems**. The length of each element MUST be greater than zero characters and less than or equal to 255 characters. + +#### SXAddl_SXCHierarchy_SXDFilterMember12 + +The **SXAddl_SXCHierarchy_SXDFilterMember12** record specifies an [OLAP manual filter](#Section_bd4665ebb56a44e690b9ceaf7ec55389) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4) is less than 3. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...isxtl
...reserved
cItemsrgStMembers (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x3F. + +**isxtl (4 bytes):** An unsigned integer that specifies the zero-based ordinal of the [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) in the pivot hierarchy that the OLAP manual filter applies to. MUST be greater than or equal to 0. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**cItems (2 bytes):** An unsigned integer that specifies the number of items in **rgStMembers**. + +**rgStMembers (variable):** An array of [XLUnicodeString](#xlunicodestring). Each element specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of an [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) selected in the OLAP manual filter. The number of elements in the array is specified by **cItems**. The length of each element MUST be greater than zero characters and less than or equal to 255 characters. + +#### SXAddl_SXCHierarchy_SXDIconSet + +The **SXAddl_SXCHierarchy_SXDIconSet** record specifies the [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for an [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...dwIconset
...reserved
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x20. + +**dwIconset (4 bytes):** An unsigned integer that specifies the icon set. + +MUST be a value from the following table: + +| Value | Meaning | +|--------|------------------------| +| 0x0000 | Default | +| 0x0001 | 3-arrow ascending | +| 0x0002 | 3-arrow descending | +| 0x0003 | 5-arrow ascending | +| 0x0004 | 5-arrow descending | +| 0x0005 | 5-arrow gray ascending | +| 0x0006 | Traffic lights | +| 0x0007 | Traffic lights 2 | +| 0x0008 | Quarters ascending | +| 0x0009 | Quarters descending | +| 0x000A | Signs | +| 0x000B | Symbols | + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCHierarchy_SXDId + +The **SXAddl_SXCHierarchy_SXDId** record specifies how an [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d) is associated with other records for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stHierUnq (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x00. + +**stHierUnq (variable):** An [SXAddl_SXString](#sxaddl_sxstring) that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the corresponding pivot hierarchy to which this SxcHierarchy class applies. The corresponding [SXTH](#sxth), of the pivot hierarchy in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), is the SXTH record with its **stUnique** field equal to the value of this field. + +If there exists no such SXTH record, then this SxcHierarchy class MUST be ignored. + +The length of this field MUST be greater than zero characters and less than or equal to 255 characters. + +#### SXAddl_SXCHierarchy_SXDInfo12 + +The **SXAddl_SXCHierarchy_SXDInfo12** record specifies additional properties for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for an [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...ABCDEreserved1
...reserved2
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x41. + +**A - fUnbalancedRealKnown (1 bit):** A bit that specifies whether **fUnbalancedReal** is valid. MUST be 0 if the pivot hierarchy is grouped. + +**B - fUnbalancedReal (1 bit):** A bit that specifies whether the pivot hierarchy is balanced or unbalanced. If the value is 1 and **fUnbalancedRealKnown** is 1, the pivot hierarchy is unbalanced. If the value is 0 and **fUnbalancedRealKnown** is 1, the pivot hierarchy is balanced. If **fUnbalancedRealKnown** is 0 the value is undefined. + +**C - fUnbalancedGroupKnown (1 bit):** A bit that specifies whether **fUnbalancedGroup** is valid. MUST be 0 if the pivot hierarchy is not grouped. + +**D - fUnbalancedGroup (1 bit):** A bit that specifies whether the [OLAP group](#Section_1e04807706d14d4f961ecacb50a12a3d) pivot hierarchy is balanced or unbalanced. If the value is 1 and **fUnbalancedGroupKnown** is 1, the pivot hierarchy is unbalanced. If the value is 0 and **fUnbalancedGroupKnown** is 1, the pivot hierarchy is balanced. If **fUnbalancedGroupKnown** is 0 the value is undefined. + +**E - fHidden (1 bit):** A bit that specifies whether the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) corresponding to this pivot hierarchy is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**reserved1 (27 bits):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCHierarchy_SXDKPIGoal + +The **SXAddl_SXCHierarchy_SXDKPIGoal** record specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**KPI**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) goal [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stKPIGoal (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x28. + +**stKPIGoal (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the MDX unique name of the KPI goal measure. + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 32767 characters. + +#### SXAddl_SXCHierarchy_SXDKPIStatus + +The **SXAddl_SXCHierarchy_SXDKPIStatus** record specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**KPI**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) status [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stKPIStatus (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x29. + +**stKPIStatus (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the MDX unique name of the KPI status measure. + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 32767 characters. + +#### SXAddl_SXCHierarchy_SXDKPITime + +The **SXAddl_SXCHierarchy_SXDKPITime** record specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**KPI**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) time [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stKPITime (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x2C. + +**stKPITime (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the MDX unique name of the KPI time [**Multidimensional Expressions (MDX)**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f). + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 32767 characters. + +#### SXAddl_SXCHierarchy_SXDKPITrend + +The **SXAddl_SXCHierarchy_SXDKPITrend** record specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**KPI**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) trend [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stKPITrend (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x2A. + +**stKPITrend (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the MDX unique name of the KPI trend measure. + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 32767 characters. + +#### SXAddl_SXCHierarchy_SXDKPIValue + +The **SXAddl_SXCHierarchy_SXDKPIValue** record specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**KPI**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) value [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stKPIValue (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x27. + +**stKPIValue (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the MDX unique name of the KPI value measure. + +The length of this field MUST be greater than zero characters and less than or equal to 32767 characters. + +#### SXAddl_SXCHierarchy_SXDKPIWeight + +The **SXAddl_SXCHierarchy_SXDKPIWeight** record specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**KPI**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) weight [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stKPIWeight (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x2B. + +**stKPIWeight (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the MDX unique name of the KPI weight [**Multidimensional Expressions (MDX)**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f). + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 32767 characters. + +#### SXAddl_SXCHierarchy_SXDMeasureGrp + +The **SXAddl_SXCHierarchy_SXDMeasureGrp** record specifies the name of the [**OLAP measure group**](#gt_a14d2b2b-03ca-40e2-a237-3d1a53f87261) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stMeasureGroup (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x24. + +**stMeasureGroup (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the OLAP measure group. + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 65535 characters. + +#### SXAddl_SXCHierarchy_SXDParentKPI + +The **SXAddl_SXCHierarchy_SXDParentKPI** record specifies the name of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) parent [**KPI**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stParentKPI (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x26. + +**stParentKPI (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the parent KPI. + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 65535 characters. + +#### SXAddl_SXCHierarchy_SXDProperty + +The **SXAddl_SXCHierarchy_SXDProperty** record specifies a [member property](#Section_e5db3a66677f43db8fb038584797c95f) of a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). The member property is displayed if the [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) is recalculated and the pivot hierarchy is either on the [row axis](#Section_3f46e7207706400cba9473cb829f869a) as specified by the **sxaxis.sxaxisRw** field of [SXTH](#sxth) or on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) as specified by the **sxaxis.sxaxisCol** field of SXTH. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...ABCreserved1
...reserved2
cchPropertystProperty (variable)
...
cchLevelUnqichPropName
cchPropNameisxtl
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x05. + +**A - fDisplayInReport (1 bit):** A bit that specifies whether this member property is displayed in the row axis or in the column axis, if this member property is associated with a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5). + +**B - fDisplayInTip (1 bit):** A bit that specifies whether this member property is displayed in a [**ToolTip**](#gt_84d44447-feaf-41a4-bf12-004c0f080fc2). + +**C - fDisplayInCaption (1 bit):** A bit that specifies whether this member property is used as a caption for [pivot items](#Section_58891cc5dd9b4293a97831070779524f) in the pivot field that is in this pivot hierarchy and is specified by the [SXVDTex](#sxvdtex) record with an isxtl field equal to the value of the isxtl field of this record. MUST be 0 if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + +**reserved1 (29 bits):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +**cchProperty (2 bytes):** An unsigned integer that specifies the length in characters of **stProperty**. + +The value MUST be greater than or equal to five characters and less than or equal to 255 characters. + +**stProperty (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of this member property. If a [cache field](#Section_6497eb794042445780e75959c9f0583c) has a matching value in the **stFieldName** field of [SXFDB](#sxfdb), then the cache field is a member property cache field and is associated with this pivot hierarchy. + +The length is specified in **cchProperty**. + +**cchLevelUnq (2 bytes):** An unsigned integer that specifies the length in characters of the [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) MDX unique name of the cache pivot hierarchy in **stProperty**. The OLAP level MDX unique name comes before the member property name in **stProperty**. For example, if the value for **stProperty** equals "\[Store\].\[Store Name\].\[Store Manager\]", then **cchLevelUnq** equals 20. This refers to "\[Store\].\[Store Name\]". + +If the PivotCache functionality level of the [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4) is 3, then this value is undefined and MUST be ignored. + +**ichPropName (2 bytes):** An unsigned integer that specifies the zero-based index of the character where the property name portion begins in **stProperty**. For example, if the value for **stProperty** equals "\[Store\].\[Store Name\].\[Store Manager\]", **ichPropName** equals 22. This refers to the starting character of "Store Manager". + +If the PivotCache functionality level of the associated PivotCache is 3, then this value is undefined and MUST be ignored. + +**cchPropName (2 bytes):** An unsigned integer that specifies the length in characters of the name portion of **stProperty**. For example, if the value for **stProperty** equals "\[Store\].\[Store Name\].\[Store Manager\]", **cchPropName** equals 13. This refers to the length of "Store Manager". + +If the PivotCache functionality level of the associated PivotCache is 3, then this value is undefined and MUST be ignored. + +**isxtl (2 bytes):** A signed integer that specifies the zero-based index of the OLAP level in the pivot hierarchy that this property applies to. The value MUST be greater than or equal to -1. + +#### SXAddl_SXCHierarchy_SXDSXSetParentUnique + +The **SXAddl_SXCHierarchy_SXDSXSetParentUnique** record specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the parent [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) for an [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record exists only if this pivot hierarchy is a [named set](#Section_c7f4e861a4e846b28279670fc6edcf6f). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stHierUnique (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x1D. + +**stHierUnique (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the MDX unique name of the parent pivot hierarchy. The length of this field MUST be greater than zero characters and less than or equal to 32767 characters. + +#### SXAddl_SXCHierarchy_SXDUserCaption + +The **SXAddl_SXCHierarchy_SXDUserCaption** record specifies the user-defined caption for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stCaption (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x1F. + +**stCaption (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the user-defined caption of this pivot hierarchy. The length of this field MUST be greater than zero characters and less than or equal to 255 characters. + +#### SXAddl_SXCHierarchy_SXDVerUpdInv + +The **SXAddl_SXCHierarchy_SXDVerUpdInv** record specifies the record-handling behavior for records of the [SXCHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
data
...
...
+ +**data (12 bytes):** An [SXAddl_SXDVerUpdInv](#sxaddl_sxdverupdinv). The value of **data.hdr.sxc** MUST equal 0x02 and the value of **data.hdr.sxd** MUST equal 0x01. + +If the value of **data.dwVersionInvalidates** is not 0x00FF and is greater than or equal to the value of the **VerSxLastUpdated** field of the [QsiSXTag](#qsisxtag) record of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), then all the records and nested records of this SXCHierarchy class MUST be ignored until another SXAddl_SXCHierarchy_SXDVerUpdInv record is encountered. + +#### SXAddl_SXCQsi_SXDEnd + +The **SXAddl_SXCQsi_SXDEnd** record specifies the end of a [SxcQsi class](#Section_953f8be387154b688af387eef7855f27). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x05 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCQsi_SXDId + +The **SXAddl_SXCQsi_SXDId** record specifies how a [SxcQsi class](#Section_953f8be387154b688af387eef7855f27) is associated with other records for a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stName (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x05 and the value of **hdr.sxd** MUST equal 0x00. + +**stName (variable):** A [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the query table. If the **stName** field equals the **rgchName** field of a [Qsi](#qsi) record in this [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream, then this SxcQsi class applies to the query table that the Qsi record is associated with. Otherwise, this SxcQsi class MUST be ignored. + +#### SXAddl_SXCQuery_SXDEnd + +The **SXAddl_SXCQuery_SXDEnd** record specifies the end of a [SxcQuery class](#Section_78ae192deccb4971bc9b33e46f7ab527). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x07 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCQuery_SXDReconnCond + +The **SXAddl_SXCQuery_SXDReconnCond** record specifies the [**reconnect condition**](#gt_4a37eb9c-89fb-4159-a709-e8180672a287) for an [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9), for a [SxcQuery class](#Section_78ae192deccb4971bc9b33e46f7ab527). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...rccDBQuery
...reserved
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x06 and the value of **hdr.sxd** MUST equal 0x07. + +**rccDBQuery (4 bytes):** An unsigned integer that specifies the reconnect condition for the database [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2). MUST be a value from the following table: + +| Value | Reconnect condition | +|----|----| +| 0x00000000 | Retrieve external connection information as required. When [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) is refreshed from the external connection, use the existing external connection information; if the external data [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) from the external connection fails, then retrieve updated external connection information, if available, from the [external connection file](#Section_6b0123b3be2248e19f57249f87425640). | +| 0x00000001 | Retrieve external connection information. When external data is refreshed from the external connection, retrieve updated external connection information from the external connection file, if available, and use that instead of the existing external connection information. In this case, the external data refresh fails if the external connection file is unavailable. | +| 0x0000000 | Never retrieve external connection information. Never get updated external connection information from the external connection file even if it is available and even if the existing external connection information is not valid. | + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCQuery_SXDSrcConnFile + +The **SXAddl_SXCQuery_SXDSrcConnFile** record specifies the [external connection file](#Section_6b0123b3be2248e19f57249f87425640) for an [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9), for a [SxcQuery class](#Section_78ae192deccb4971bc9b33e46f7ab527). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stSourceConnectionFile (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x06 and the value of **hdr.sxd** MUST equal 0x06. + +**stSourceConnectionFile (variable):** An [SXAddl_SXString](#sxaddl_sxstring) that specifies the external connection file for the database [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2). The total count of characters of the string MUST be less than or equal to 65535. + +#### SXAddl_SXCQuery_SXDSrcDataFile + +The **SXAddl_SXCQuery_SXDSrcDataFile** record specifies the [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0) file for an [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9), for a [SxcQuery class](#Section_78ae192deccb4971bc9b33e46f7ab527). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stSourceDataFile (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x06 and the value of **hdr.sxd** MUST equal 0x05. + +**stSourceDataFile (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the source data file for the database [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2). The total count of characters of the string MUST be less than or equal to 65535. + +#### SXAddl_SXCQuery_SXDXMLSource + +The **SXAddl_SXCQuery_SXDXMLSource** record specifies the [**Uniform Resource Locator (URL)**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1), used to display an edit dialog for an [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9), for a [SxcQuery class](#Section_78ae192deccb4971bc9b33e46f7ab527). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stURL (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure The value of **hdr.sxc** MUST equal 0x06 and the value of **hdr.sxd** MUST equal 0x04. + +**stURL (variable):** An [XLUnicodeStringSegmentedSXAddl](#xlunicodestringsegmentedsxaddl) that specifies the URL used to display an edit dialog. + +#### SXAddl_SXCSXCondFmt_SXDEnd + +The **SXAddl_SXCSXCondFmt_SXDEnd** record specifies the end of a [SXCSXCondFmt class](#Section_59cc4e9903ad43f395985be87afdcc92). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1B and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXCondFmt_SXDSXCondFmt + +The **SXAddl_SXCSXCondFmt_SXDSXCondFmt** record specifies information for a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule, for a [SXCSXCondFmt class](#Section_59cc4e9903ad43f395985be87afdcc92). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
sxcondfmtScope
sxcondfmtType
ipriority
csxrule
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1B and the value of **hdr.sxd** MUST equal 0x35. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +**sxcondfmtScope (4 bytes):** An unsigned integer that specifies the scope of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) conditional formatting. MUST be a value from the following table: + +| Name | Value | Description | +|----|----|----| +| SXCONDFMTSELECTIONSCOPE | 0x00000000 | This conditional formatting is applied to the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461), as specified by the [SXCSXrule classes](#Section_dd12edef6e8747379bed6f4ceff33127) contained in this SXCSXCondFmt class. | +| SXCONDFMTDATASCOPE | 0x00000001 | This conditional formatting is applied to all cells that display values for the [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679), as specified by the SXCSXrule class contained in this SXCSXCondFmt class. | +| SXCONDFMTFIELDSCOPE | 0x00000002 | This conditional formatting is applied to all cells that display values for the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) intersections, as specified by the SXCSXrule class contained in this SXCSXCondFmt class. | + +The value MUST be SXCONDFMTFIELDSCOPE if the value of **sxcondfmtType** is SXCONDFMTTOP10R or SXCONDFMTTOP10C. + +If the value is SXCONDFMTDATASCOPE or SXCONDFMTFIELDSCOPE, there MUST be only one SXCSXrule class contained in this SXCSXCondFmt class. + +**sxcondfmtType (4 bytes):** An unsigned integer that specifies the type of this PivotTable view conditional formatting. MUST be one of the values from following table: + +| Name | Value | Description | +|----|----|----| +| SXCONDFMTTOP10NIL | 0x00000000 | Top N or Bottom N conditional formatting is not evaluated. | +| SXCONDFMTTOP10A | 0x00000001 | Top N or Bottom N conditional formatting is evaluated across the entire scope [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). | +| SXCONDFMTTOP10R | 0x00000002 | Top N or Bottom N conditional formatting is evaluated for each row. | +| SXCONDFMTTOP10C | 0x00000003 | Top N or Bottom N conditional formatting is evaluated for each column. | + +The value MUST be equal to SXCONDFMTTOP10NIL or SXCONDFMTTOP10A if the value of **sxcondfmtScope** is SXCONDFMTSELECTIONSCOPE or SXCONDFMTDATASCOPE. + +**ipriority (4 bytes):** An unsigned integer that specifies the priority of the PivotTable view conditional formatting. It is used to locate the conditional formatting rule by matching the **ipriority** field of either [CF12](#cf12) or the **rgbContent** field which is a [CFExNonCF12](#cfexnoncf12) structure in [CFEx](#cfex). MUST be greater than or equal to 1. + +**csxrule (4 bytes):** An unsigned integer that specifies the number of SXCSXrule classes contained in this SXCSXCondFmt class. The SXCSXrule classes specify the area that the conditional formatting is applied to. + +#### SXAddl_SXCSXCondFmts_SXDEnd + +The **SXAddl_SXCSXCondFmts_SXDEnd** record specifies the end of a [SXCSXCondFmts class](#Section_fdd787b53b0e43f888b9c86cb063a54f). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1A and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXCondFmts_SXDId + +The **SXAddl_SXCSXCondFmts_SXDId** record specifies information for [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) [conditional formatting](#Section_abb828767c9c4377858fb1a6be7fe8f9) rules, for a [SXCSXCondFmts class](#Section_fdd787b53b0e43f888b9c86cb063a54f). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...cSxcondfmt
...reserved
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1A and the value of **hdr.sxd** MUST equal 0x00. + +**cSxcondfmt (4 bytes):** A signed integer that specifies the number of [SXCSXCondFmt class](#Section_59cc4e9903ad43f395985be87afdcc92) instances that follow this record. MUST be greater than 0. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXDH_SXDEnd + +The **SXAddl_SXCSXDH_SXDEnd** record specifies the end of an [SXCSXDH class](#Section_284c3ab876c54d36961f1e0006764807). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x10 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXDH_SXDId + +The **SXAddl_SXCSXDH_SXDId** record specifies information for an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**dimension (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) for a [SXCSXDH class](#Section_284c3ab876c54d36961f1e0006764807). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...dwCount
...reserved
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x10 and the value of **hdr.sxd** MUST equal 0x00. + +**dwCount (4 bytes):** An unsigned integer that specifies the number of [SXAddl](#sxaddl) records of type [SXADDL_SXCSXDH_SXDSXDH](#sxaddl_sxcsxdh_sxdsxdh) that follow this record. The count MUST be greater than zero and less than 0xFFFFFFFF. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXDH_SXDSxdh + +The **SXAddl_SXCSXDH_SXDSxdh** record specifies a mapping between an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**dimension (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) and a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) for a [SXCSXDH class](#Section_284c3ab876c54d36961f1e0006764807). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved1
...reserved2
isxth
cchDimensionNamecchDimensionUnique
cchDimensionCaptionstDimensionName (variable)
...
stDimensionUnique (variable)
...
stDimensionCaption (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x10 and the value of **hdr.sxd** MUST equal 0x1A. + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +**isxth (4 bytes):** A signed integer that specifies a reference to a pivot hierarchy. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -2 | This value specifies the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592). | +| 0+ | A pivot hierarchy index, as specified in Pivot Hierarchies, that specifies a pivot hierarchy in the [associated PivotTable view](#Section_855483943345473bb926de5189fd664d) of the [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b). | + +The value MUST be -2 or greater than or equal to zero and less than the number of pivot hierarchy in the associated PivotTable view of the OLAP PivotCache. + +**cchDimensionName (2 bytes):** An unsigned integer that specifies the length, in characters, of the [XLUnicodeStringNoCch](#xlunicodestringnocch) in the **stDimensionName** field. MUST be greater than zero and less than or equal to 0x00FF. + +**cchDimensionUnique (2 bytes):** An unsigned integer that specifies the length, in characters, of the XLUnicodeStringNoCch in the **stDimensionUnique** field. MUST be greater than zero and less than or equal to 0x00FF. + +**cchDimensionCaption (2 bytes):** An unsigned integer that specifies the length, in characters, of the XLUnicodeStringNoCch in the **stDimensionCaption** field. MUST be greater than zero and less than or equal to 0x00FF. + +**stDimensionName (variable):** An XLUnicodeStringNoCch that specifies the name of the OLAP dimension (1). The length is specified in **cchDimensionName**. + +**stDimensionUnique (variable):** An XLUnicodeStringNoCch that specifies the fully qualified unique name of the [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7) dimension (1). The length is specified in **cchDimensionUnique**. + +**stDimensionCaption (variable):** An XLUnicodeStringNoCch that specifies the caption of the OLAP dimension (1). The length is specified in **cchDimensionCaption**. + +#### SXAddl_SXCSXfilt_SXDEnd + +The **SXAddl_SXCSXfilt_SXDEnd** record specifies the end of an [SXCSXfilt class](#Section_22611924dd5649078c7ab385cd2ccdc0). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x0D and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXfilt_SXDId + +The **SXAddl_SXCSXfilt_SXDId** record specifies information for a [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f) filter, for an [SXCSXfilt class](#Section_22611924dd5649078c7ab385cd2ccdc0). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x0D and the value of **hdr.sxd** MUST equal 0x00. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXfilt_SXDSXfilt + +The **SXAddl_SXCSXfilt_SXDSXfilt** record specifies information for a [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f) filter, for an [SXCSXfilt class](#Section_22611924dd5649078c7ab385cd2ccdc0). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved1
...
ABCDEFGreserved5grbitSbt
iDim
isxvd
cisxvi
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x0D and the value of **hdr.sxd** MUST equal 0x14. + +**reserved1 (6 bytes):** MUST be zero, and MUST be ignored. + +**A - sxaxisRw (1 bit):** A bit that specifies whether the [row axis](#Section_3f46e7207706400cba9473cb829f869a) is being referred to. + +MUST be zero if the value of **sxaxisCol** is 1 or the value of **sxaxisPage** is 1 or the value of **sxaxisData** is 1. + +**B - sxaxisCol (1 bit):** A bit that specifies whether the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) is being referred to. + +MUST be zero if the value of **sxaxisRw** is 1 or the value of **sxaxisPage** is 1 or the value of **sxaxisData** is 1. + +**C - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**D - sxaxisData (1 bit):** A bit that specifies whether the [value axis](#Section_4c5c2daa289746e1854b0ce04209f060) is being referred to. + +MUST be zero if the value of **sxaxisRw** is 1 or the value of **sxaxisCol** is 1 or the value of **sxaxisPage** is 1. + +**E - fSelected (1 bit):** A bit that specifies whether the header of the [Pivot Field](#Section_1edf7f2294084945b2de56526c14fca5) is included in the PivotTable rule filters. + +**F - reserved3 (1 bit):** MUST be zero, and MUST be ignored. + +**G - reserved4 (1 bit):** MUST be zero, and MUST be ignored. + +**reserved5 (9 bits):** MUST be zero, and MUST be ignored. + +**grbitSbt (2 bytes):** A signed integer that specifies the subtotals for this PivotTable rule filter. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------| +| 0 | No subtotals are displayed. | +| 1 | Data value subtotals are displayed. | + +**iDim (4 bytes):** A signed integer that specifies the position of the Pivot Field within the axis specified by **sxaxisRw**, **sxaxisCol**, **sxaxisPage**, or **sxaxisData**. MUST be greater than or equal to -1 and less than or equal to 0x0000001F. + +**isxvd (4 bytes):** A signed integer that specifies the Pivot Field that this PivotTable rule filter refers to. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -2 | This PivotTable rule filter refers to the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592). | +| -1 | This PivotTable rule filter does not refer to a pivot field | +| 0 to 255 | This value specifies a pivot field index, as specified in Pivot Fields. The pivot field index specifies which pivot field this PivotTable rule filter refers to. | + +If the value is greater than or equal to zero, MUST be less than the number of pivot fields in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +**cisxvi (4 bytes):** An unsigned integer that specifies the count of [pivot item](#Section_58891cc5dd9b4293a97831070779524f) indexes in the [SXAddl_SXCSXfilt_SXDSXItm](#sxaddl_sxcsxfilt_sxdsxitm) record that follows this record. MUST be greater than or equal to zero. If **isxvd** is -1, MUST be 0. + +#### SXAddl_SXCSXfilt_SXDSXItm + +The **SXAddl_SXCSXfilt_SXDSXItm** record specifies an array of [pivot item](#Section_58891cc5dd9b4293a97831070779524f) records of a [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f) filter for an [SXCSXfilt class](#Section_22611924dd5649078c7ab385cd2ccdc0). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
rgIsxvi (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x0D and the value of **hdr.sxd** MUST equal 0x15. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +**rgIsxvi (variable):** An array of 2-byte unsigned integers. Each element specifies the pivot item or [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679) index in the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) or [data field](#Section_b4187a6caa2d4a9789bd26f394d67592) specified by the **isxvd** field of the preceding [SXAddl_SXCSXfilt_SXDSXfilt](#sxaddl_sxcsxfilt_sxdsxfilt) record. See PivotTable rule for more information about the references that are used. + +The number of items in the array MUST equal the **cisxvi** field of the preceding SXAddl_SXCSXfilt_SXDSXfilt record. + +The value of each element in **rgIsxvi** MUST be in sorted order such that **rgIsxvi**\[item\] is less than **rgIsxvi**\[item+1\] where item is between 0 and the number of elements in **rgIsxvi** – 2. + +If the value of the **isxvd** field of the preceding SXAddl_SXCSXfilt_SXDSXfilt record is greater than or equal to zero, each item in this array MUST be 0x7FFF (isxviNULL) or greater than or equal to zero plus the number of pivot items in the pivot field specified by the **isxvd** field of the preceding SXAddl_SXCSXfilt_SXDSXfilt record. + +If the value of the **isxvd** field of the preceding SXAddl_SXCSXfilt_SXDSXfilt record is less than zero, each item in this array MUST be greater than or equal to zero and less than the number of data items in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +#### SXAddl_SXCSXFilter12_SXDCaption + +The **SXAddl_SXCSXFilter12_SXDCaption** record specifies the name of the [advanced filter](#Section_d490d0634e074f0093389812040ebdff) for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stName (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x2F. + +**stName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). + +#### SXAddl_SXCSXFilter12_SXDEnd + +The **SXAddl_SXCSXFilter12_SXDEnd** record specifies the end of an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXFilter12_SXDId + +The **SXAddl_SXCSXFilter12_SXDId** record specifies information for an [advanced filter](#Section_d490d0634e074f0093389812040ebdff), for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...dwFilterid
...reserved
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x00. + +**dwFilterid (4 bytes):** An unsigned integer that specifies the unique identifier of this [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXFilter12_SXDSXFilter + +The **SXAddl_SXCSXFilter12_SXDSXFilter** record specifies the [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) information of an [advanced filter](#Section_d490d0634e074f0093389812040ebdff) for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved1
...reserved2
isxvd
isxvdMProp
sxft
unused
isxdiMeasure
isxthMeasure
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x38. + +**reserved1 (4 bytes):** MUST be zero and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero and MUST be ignored. + +**isxvd (4 bytes):** An unsigned integer that specifies a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) index as specified in pivot fields. The pivot field index specifies which pivot field this filter applies to. The value MUST be less than the **cDim** field of the [SxView](#sxview) record of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +**isxvdMProp (4 bytes):** A signed integer that specifies the [member property](#Section_e5db3a66677f43db8fb038584797c95f) pivot field on which this advanced filter is based. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | This advanced filter is not defined on a [**member property**](#gt_c7ddc1fa-c564-42c5-b755-aed72a0cb000). | +| Greater than or equal to zero | This value specifies a pivot field index as specified in pivot fields. The pivot field index specifies which pivot field this advanced filter is based on. | + +> This value MUST be -1 and MUST be ignored if the value of the **sxft** field is less than 0x00000004 or greater than 0x00000011. The value MUST be greater than or equal to -1 and less than the value of the **cDim** field of the SxView record of this PivotTable view. + +**sxft (4 bytes):** A [SxFT](#sxft) structure that specifies the advanced filter type. If the value is equal to SXFTCOUNT, SXFTPERCENT, or SXFTSUM, the **cft** field in [SXAddl_SXCSXFilter12_SXDXlsFilter](#sxaddl_sxcsxfilter12_sxdxlsfilter) MUST be equal to CFTTOP10. + +**unused (4 bytes):** Undefined and MUST be ignored. + +**isxdiMeasure (4 bytes):** A signed integer that specifies a [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679) index of the data item on which this advanced filter is based. If this is an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) then isxdiMeasure MUST be -1, if this is a [value filter](#Section_05a1c98e21cd4941979880f4bf301bb2) then isxdiMeasure MUST be greater than or equal to zero and less than the number of [SXDI](#sxdi) records in this PivotTable view. Otherwise isxdiMeasure MUST be 0. + +**isxthMeasure (4 bytes):** A signed integer that specifies a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) index of the [measure](#Section_4308b88c7f1e42bcb3dd8a1387b69c51) pivot hierarchy on which this advanced filter applies. If this is a non-OLAP PivotTable view then isxthMeasure MUST be -1. If this is a value filter then **isxthMeasure** MUST be greater than or equal to zero and less than the number of [SXTH](#sxth) records in this PivotTable view. Otherwise isxthMeasure MUST be 0. + +#### SXAddl_SXCSXFilter12_SXDSXFilterDesc + +The **SXAddl_SXCSXFilter12_SXDSXFilterDesc** record specifies the description of an [advanced filter](#Section_d490d0634e074f0093389812040ebdff) for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stDescription (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x39. + +**stDescription (variable):** A [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the description of the [[PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37)](#Section_a5f57198f2af40b2ba07e4b1836d73f3) [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). + +#### SXAddl_SXCSXFilter12_SXDSXFilterValue1 + +The **SXAddl_SXCSXFilter12_SXDSXFilterValue1** record specifies the first value used by the [label filter](#Section_f221b81b892c4b5c91722d4ed17c937c) for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). This record MUST NOT exist if the value of the **sxft** field of the preceding [SXAddl_SXCSXFilter12_SXDSXFilter](#sxaddl_sxcsxfilter12_sxdsxfilter) record is less than 0x00000004 or greater than 0x00000011. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stValue (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x3A. + +**stValue (variable):** A [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the first value used by the label filter. + +#### SXAddl_SXCSXFilter12_SXDSXFilterValue2 + +The **SXAddl_SXCSXFilter12_SXDSXFilterValue2** record specifies the second value used by the [label filter](#Section_f221b81b892c4b5c91722d4ed17c937c) for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). This record MUST NOT exist if the value of the **sxft** field of the preceding [SXAddl_SXCSXFilter12_SXDSXFilter](#sxaddl_sxcsxfilter12_sxdsxfilter) record is less than 0x00000004 or greater than 0x00000011. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stValue (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x3B. + +**stValue (variable):** A [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the second value used by the label filter. + +#### SXAddl_SXCSXFilter12_SXDXlsFilter + +The **SXAddl_SXCSXFilter12_SXDXlsFilter** record specifies information for an [advanced filter](#Section_d490d0634e074f0093389812040ebdff), for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
cft
ccriteria
data (28 bytes)
...
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x3C. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +**cft (4 bytes):** A [**CFT**](#cft) enumeration that specifies the [**custom filter**](#gt_8593ee2f-c2dd-4793-a684-45fe40c840d2) type. If the **sxft** field in [SXAddl_SXCSXFilter12_SXDSXFilter](#sxaddl_sxcsxfilter12_sxdsxfilter) is equal to SXFTCOUNT, SXFTPERCENT, or SXFTSUM, this value MUST be CFTTOP10. + +**ccriteria (4 bytes):** A signed integer that specifies the number of criteria. MUST be greater than or equal to zero and less than or equal to 2. + +**data (28 bytes):** A 28-byte structure that contains the [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) data. + +If **cft** equals CFTTOP10 this is an [XlsFilter_Top10](#xlsfilter_top10) structure, otherwise this is an [XlsFilter_Criteria](#xlsfilter_criteria) structure. + +#### SXAddl_SXCSXFilter12_SXDXlsFilterValue1 + +The **SXAddl_SXCSXFilter12_SXDXlsFilterValue1** record specifies the first value of an [advanced filter](#Section_d490d0634e074f0093389812040ebdff) for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stValue (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x3D. + +**stValue (variable):** A [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the first value string of the [SXAddl_SXCSXFilter12_SXDXlsFilter](#sxaddl_sxcsxfilter12_sxdxlsfilter) [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). + +#### SXAddl_SXCSXFilter12_SXDXlsFilterValue2 + +The **SXAddl_SXCSXFilter12_SXDXlsFilterValue2** record specifies the second value of an [advanced filter](#Section_d490d0634e074f0093389812040ebdff) for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stValue (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x3E. + +**stValue (variable):** A [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the second value of the [SXAddl_SXCSXFilter12_SXDXlsFilter](#sxaddl_sxcsxfilter12_sxdxlsfilter) [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). + +#### SXAddl_SXCSXFilters12_SXDEnd + +The **SXAddl_SXCSXFilters12_SXDEnd** record specifies the end of an [SXCSXFilters12 class](#Section_38fb61e517e742219ea43f1e5a665bc2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1C and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXFilters12_SXDId + +The **SXAddl_SXCSXFilters12_SXDId** record specifies information for [advanced filters](#Section_d490d0634e074f0093389812040ebdff), for an [SXCSXFilters12 class](#Section_38fb61e517e742219ea43f1e5a665bc2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...cSxfilter12
...reserved
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1C and the value of **hdr.sxd** MUST equal 0x00. + +**cSxfilter12 (4 bytes):** An unsigned integer that specifies the count of PivotTable advanced filters in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXMg_SXDEnd + +The **SXAddl_SXCSXMg_SXDEnd** record specifies the end of an [SXCSXMg class](#Section_7a80fae6884c401f8ecab68064099425). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x14 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXMg_SXDId + +The **SXAddl_SXCSXMg_SXDId** record specifies information for an [**OLAP measure group**](#gt_a14d2b2b-03ca-40e2-a237-3d1a53f87261), for an [SXCSXMg class](#Section_7a80fae6884c401f8ecab68064099425). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stName (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x14 and the value of **hdr.sxd** MUST equal 0x00. + +**stName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the OLAP measure group. + +#### SXAddl_SXCSXMg_SXDUserCaption + +The **SXAddl_SXCSXMg_SXDUserCaption** record specifies the display name for the [**OLAP measure group**](#gt_a14d2b2b-03ca-40e2-a237-3d1a53f87261) specified in this [SXAddl](#sxaddl) record collection. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stUserCaption (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x14 and the value of **hdr.sxd** MUST equal 0x1F. + +**stUserCaption (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the display name of the OLAP measure group. + +#### SXAddl_SXCSXMgs_SXDEnd + +The **SXAddl_SXCSXMgs_SXDEnd** record specifies the end of an [SxcSXMgs class](#Section_7081e96f74c24e339021305d28e3da1a). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x13 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXMgs_SXDId + +The **SXAddl_SXCSXMgs_SXDId** record specifies information for an [**OLAP measure group**](#gt_a14d2b2b-03ca-40e2-a237-3d1a53f87261) collection, for an [SxcSXMgs class](#Section_7081e96f74c24e339021305d28e3da1a). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...cmgs
...reserved
cmaps
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x13 and the value of **hdr.sxd** MUST equal 0x00. + +**cmgs (4 bytes):** An unsigned integer that specifies the number of OLAP measure groups in the OLAP measure group collection. MUST be equal to the number of [SXCSXMg classes](#Section_7a80fae6884c401f8ecab68064099425) that are nested inside this SxcSXMgs class. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**cmaps (4 bytes):** An unsigned integer that specifies the number of mappings between OLAP measure groups and [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**dimensions (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) in the OLAP measure group collection. Each mapping is defined by an [SXAddl_SXCSXMgs_SXDMGrpSXDHMap](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap) record. This value MUST be equal to the number of SXAddl_SXCSXMgs_SXDMGrpSXDHMap records that follow this record. + +#### SXAddl_SXCSXMgs_SXDMGrpSXDHMap + +The **SXAddl_SXCSXMgs_SXDMGrpSXDHMap** record specifies a mapping between an [**OLAP measure group**](#gt_a14d2b2b-03ca-40e2-a237-3d1a53f87261) and an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**dimension (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) for an [SxcSXMgs class](#Section_7081e96f74c24e339021305d28e3da1a). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved1
...reserved2
iKey
iVal
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x13 and the value of **hdr.sxd** MUST equal 0x23. + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +**iKey (4 bytes):** An unsigned integer that specifies a zero-based index of an [SXCSXMg class](#Section_7a80fae6884c401f8ecab68064099425) in the collection of SXCSXMg classes. The [SXAddl_SXCSXMg_SXDId](#sxaddl_sxcsxmg_sxdid) record of the referenced SXCSXMg class specifies an OLAP measure group in the [**measure group**](#gt_1f51f60a-8a0f-4b0d-9e7e-80cbd596e164) collection. MUST be less than the value of the **cmgs** field of the [SXAddl_SXCSXMgs_SXDId](#sxaddl_sxcsxmgs_sxdid) record of this SxcSXMgs class. + +**iVal (4 bytes):** An unsigned integer that specifies a zero-based index of the [SXAddl_SXCSXDH_SXDSxdh](#sxaddl_sxcsxdh_sxdsxdh) record in the collection of SXAddl_SXCSXDH_SXDSxdh records in the [SXCSXDH class](#Section_284c3ab876c54d36961f1e0006764807) of the containing [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7) of this record. The referenced record specifies an OLAP dimension (1). MUST be less than the value of the **dwCount** field of the [SXAddl_SXCSXDH_SXDId](#sxaddl_sxcsxdh_sxdid) record of the SXCSXDH class. + +#### SXAddl_SXCSXrule_SXDEnd + +The **SXAddl_SXCSXrule_SXDEnd** record specifies the end of an [SXCSXrule class](#Section_dd12edef6e8747379bed6f4ceff33127). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x0C and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXrule_SXDId + +The **SXAddl_SXCSXrule_SXDId** record specifies information for a [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f), for the [SXCSXrule class](#Section_dd12edef6e8747379bed6f4ceff33127). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x0C and the value of **hdr.sxd** MUST equal 0x00. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXrule_SXDSXrule + +The **SXAddl_SXCSXrule_SXDSXrule** record specifies information for a [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f), for an [SXCSXrule class](#Section_dd12edef6e8747379bed6f4ceff33127). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved1
...
AsxrtypeBCDEFGHIJreserved4
KLMNOPreserved6irwFirstirwLast
icolFirsticolLastcsxfilt
...iDim
...isxvd
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x0C and the value of **hdr.sxd** MUST equal 0x13. + +**reserved1 (6 bytes):** MUST be zero, and MUST be ignored. + +**A - reserved2 (4 bits):** MUST be zero, and MUST be ignored. + +**sxrtype (4 bits):** An unsigned integer that specifies the area of the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) specified by this PivotTable rule. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | This rule applies to no area. | +| 0x1 | This rule applies to [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the [row area](#Section_5594c95e6819461e80706f4b4fdfa091), [column area](#Section_03aced8c25864e83982a1e3551a563d6), or [data area](#Section_237a24905c614931923f7ee856f23c72) of the PivotTable report. | +| 0x2 | This rule applies to the data area of the PivotTable report. | +| 0x3 | This rule applies to the entire PivotTable report. | +| 0x4 | This rule applies to the blank cells at the [**logical top-left**](#gt_88b25c47-61c2-44de-abb0-12ea3348a412) of the PivotTable report. | +| 0x5 | This rule applies to a button shown next to a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) in the PivotTable report. | +| 0x6 | This rule applies to the blank cells at the [**logical top-right**](#gt_90beae65-f411-4252-9b4b-6b539f263415) of the PivotTable report. | + +If the value of **isxvd** is not -1, MUST be 0x1 or 0x2 or 0x5. + +**B - fPart (1 bit):** A bit that specifies whether only a portion of the [PivotTable area](#Section_c3139d36c8934b57a44df7b7c13556e5) is included in this rule. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The entire PivotTable area is included in the rule. The **irwFirst**, **irwLast**, **icolFirst**, and **icolLast** fields are undefined and MUST be ignored. | +| 0x1 | A portion of the PivotTable area is included in the rule. The **irwFirst, irwLast, icolFirst,** and **icolLast** fields hold the relative offset into the PivotTable area included in this rule. | + +**C - fDataOnly (1 bit):** A bit that specifies whether only the cells in the data area are included in this PivotTable rule. If **fLabelOnly** is 1 then **fDataOnly** MUST be 0. If **sxrtype** is 0x2, the value of this field value MUST be 1. + +**D - fLabelOnly (1 bit):** A bit that specifies whether only cells in the [page area](#Section_f10ef7d86c044d35a5830d6f2ce92063), row area, or column area are included in this PivotTable rule. If **fDataOnly** is 1 then **fLabelOnly** MUST be 0. If **sxrtype** is 0x5 or 0x6, this value MUST be 1. + +**E - fGrandRw (1 bit):** A bit that specifies whether cells in the [**grand total**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7) row are included in this PivotTable rule. + +**F - fGrandCol (1 bit):** A bit that specifies whether cells in the grand total column are included in this PivotTable rule. + +**G - fGrandRwSav (1 bit):** A bit that specifies whether cells in the grand total row are included in this PivotTable rule. MUST be equal to **fGrandRw**. + +**H - reserved3 (1 bit):** MUST be zero, and MUST be ignored. + +**I - fGrandColSav (1 bit):** A bit that specifies whether cells in the grand total column are included in this PivotTable rule. MUST be equal to **fGrandCol**. + +**J - fFuzzy (1 bit):** A bit that specifies whether the [pivot items](#Section_58891cc5dd9b4293a97831070779524f) of the pivot field specified by this rule are treated as subtotals for the purposes of formatting when the pivot field is displayed in outline mode. + +**reserved4 (15 bits):** MUST be zero, and MUST be ignored. + +**K - unused1 (1 bit):** Undefined, MUST be ignored. + +**L - fLineMode (1 bit):** A bit that specifies whether the area of the PivotTable report specified by this PivotTable rule is displayed in outline mode. + +**M - unused2 (1 bit):** Undefined, MUST be ignored. + +**N - unused3 (1 bit):** Undefined, MUST be ignored. + +**O - reserved5 (1 bit):** MUST be zero, and MUST be ignored. + +**P - fDrillOnly (1 bit):** A bit that specifies the [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7) of the PivotTable rule filters specified by **csxfilt**. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | PivotTable rule filters are sorted by Pivot Field index as specified in Pivot Fields. | +| 0x1 | PivotTable rule filters are sorted by position. | + +**reserved6 (10 bits):** MUST be zero, and MUST be ignored. + +**irwFirst (1 byte):** A [DRwByteU](#drwbyteu) structure that specifies the difference between the index of the first row of the range of cells included in this rule and the index of the first row of the PivotTable. + +**irwLast (1 byte):** A DRwByteU structure that specifies the difference between the index of the last row of the range of cells included in this rule and the index of the first row of the PivotTable. If **fPart** is 1, MUST be greater than or equal to **irwFirst**. + +**icolFirst (1 byte):** A [DColByteU](#dcolbyteu) structure that specifies the difference between the index of the first column of the range of cells included in this rule and the index of the first column of the PivotTable. + +**icolLast (1 byte):** A DColByteU structure that specifies the difference between the index of the last column of the range of cells included in this rule and the index of the first column of the PivotTable. If **fPart** is 1, MUST be greater than or equal to **icolFirst**. + +**csxfilt (4 bytes):** An unsigned integer that specifies the number of [SXAddl_SXCSXfilt_SXDId](#sxaddl_sxcsxfilt_sxdid) records following this record. MUST be greater than or equal to 0. If **sxrtype** is not 0x1 or 0x2, this value MUST be 0. + +**iDim (4 bytes):** An signed integer that specifies the position of the pivot field within the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) for this PivotTable rule. If **isxvd** is 0xFFFFFFFE or 0xFFFFFFFF this field MUST be ignored. If **isxvd** is between 0x00000000 and 0x000000FF, then the value of **iDim** depends on the value of certain fields in the **sxaxis** structure in **isxvd**. The following table shows the values that **iDim** MUST have given certain values of the specified fields of **isxvd.sxaxis**. + +| Value | Meaning | +|----|----| +| **isxvd.sxaxis.sxaxisRw** is 1 | The value of **iDim** MUST be greater than 0 and less than the number of pivot fields on the [row axis](#Section_3f46e7207706400cba9473cb829f869a). | +| **isxvd.sxaxis.sxaxisCol** is 1 | The value of **iDim** MUST be greater than 0 and less than the number of pivot fields on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). | +| **isxvd.sxaxis.sxaxisPage** is 1 | The value of **iDim** MUST be greater than 0 and less than the number of pivot fields on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). | +| **isxvd.sxaxis.sxaxisData** is 1 | The value of **iDim** MUST be greater than 0 and less than the number of pivot fields on the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060) | + +**isxvd (4 bytes):** A signed integer that specifies the pivot field this rule refers to. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0xFFFFFFFE | This rule refers to the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592). | +| 0xFFFFFFFF | This rule does not refer to a pivot field. | +| 0x0000000 to 0x000000FF | This value specifies a pivot field index as specified in Pivot Fields. The pivot field index specifies which pivot field this rule refers to. | + +MUST be greater than or equal to 0xFFFFFFFE and less than or equal to 0x000000FF. If the value is greater than or equal to 0x00000000, MUST be less than the value of the **cDim** field of the preceding [SxView](#sxview). + +#### SXAddl_SXCView_SXDCalcMember + +The **SXAddl_SXCView_SXDCalcMember** record specifies [OLAP calculated members](#Section_e67071408ab5499ca7bab1d8eca85058) properties for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...ABCDEFreserved2
...reserved3
stName (variable)
...
stMDXFormula (variable)
...
stMemberName (variable)
...
stSourceHierarchy (variable)
...
stParentUnique (variable)
...
wSolveOrder
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x03. + +**A - fParentUnique (1 bit):** A bit that specifies whether **stParentUnique** exists. If the value is 1, **stParentUnique** exists. If **fSet** is 1, this field MUST be zero. + +**B - fMemberName (1 bit):** A bit that specifies whether **stMemberName** exists. If the value is 1, **stMemberName** exists. If **fSet** is 1, this field MUST be zero; otherwise, this field MUST be 1. + +**C - fSourceHier (1 bit):** A bit that specifies whether **stSourceHierarchy** exists. If the value is 1, **stSourceHierarchy** exists. If **fSet** is 1, this field MUST be zero; otherwise, this field MUST be 1. + +**D - fLongFormula (1 bit):** A bit that specifies whether the length of the user-specified [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) that defines the calculation is greater than 255 characters. + +MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Length of the user-specified MDX expression is less than or equal to 255 characters and **stMDXFormula** contains the MDX. | +| 1 | Length of the user-specified MDX expression is greater than 255 characters and the user-specified MDX expression is written to a subsequent [SXAddl_SXCView_SXDCalcMemString](#sxaddl_sxcview_sxdcalcmemstring) record. | + +**E - reserved1 (4 bits):** MUST be zero, and MUST be ignored. + +**F - fSet (1 bit):** A bit that specifies whether this calculation is for an [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28). + +**reserved2 (23 bits):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**stName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of this OLAP calculated member. The length of this field MUST be greater than 0 characters and less than or equal to 255 characters. + +**stMDXFormula (variable):** An XLUnicodeString structure that specifies the user-specified MDX expression for this OLAP calculated member. If **fLongFormula** is 1, this field does not exist. If **fLongFormula** is 0, the length of this field MUST be greater than 0 characters and less than or equal to 255 characters. + +**stMemberName (variable):** An XLUnicodeString structure that specifies the name of this OLAP calculated member. If **fMemberName** is 0, this field does not exist. If **fMemberName** is 1, the length of this field MUST be less than or equal to 255 characters. + +**stSourceHierarchy (variable):** An XLUnicodeString structure that specifies the MDX unique name of the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) that this OLAP calculated member is associated with. If **fSourceHier** is zero this field does not exist. If **fSourceHier** is 1 then the length of this field MUST be less than or equal to 255 characters. + +**stParentUnique (variable):** An XLUnicodeString structure that specifies the MDX unique name of the parent [**member (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) that this OLAP calculated member is associated with. If **fParentUnique** is zero this field does not exist. If **fParentUnique** is 1 then the length of this field MUST be less than or equal to 255 characters. + +**wSolveOrder (4 bytes):** An unsigned integer that specifies the calculation order when there are multiple OLAP calculated members. The calculation order goes from lowest **wSolveOrder** value to highest. If the value is zero the calculation order is determined by the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). + +#### SXAddl_SXCView_SXDCalcMemString + +The **SXAddl_SXCView_SXDCalcMemString** record specifies a user-specified [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) for an [OLAP calculated member](#Section_e67071408ab5499ca7bab1d8eca85058), for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). The other properties of the OLAP calculated member are specified in the preceding [SXAddl_SXCView_SXDCalcMember](#sxaddl_sxcview_sxdcalcmember) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stMDXFormula (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x0A. + +**stMDXFormula (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the user-specified MDX expression. The length of this field MUST be greater than zero. If the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4) of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) is less than 3, the length of this field MUST be less than 2048 characters; otherwise, the length MUST be less than 32767 characters. + +#### SXAddl_SXCView_SXDCompactColHdr + +The **SXAddl_SXCView_SXDCompactColHdr** record specifies the [column area](#Section_03aced8c25864e83982a1e3551a563d6) caption string used in the compact [PivotTable layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4) for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stHeader (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x22. + +**stHeader (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the caption displayed in the column area of the compact PivotTable layout. The length MUST be less than or equal to 255 characters. + +#### SXAddl_SXCView_SXDCompactRwHdr + +The **SXAddl_SXCView_SXDCompactRwHdr** record specifies the [row area](#Section_5594c95e6819461e80706f4b4fdfa091) caption string used in the compact [PivotTable layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4) for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stHeader (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x21. + +**stHeader (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the caption displayed in the row area of the compact PivotTable layout. The length MUST be less than or equal to 255 characters. + +#### SXAddl_SXCView_SXDEnd + +The **SXAddl_SXCView_SXDEnd** record specifies the end of an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCView_SXDId + +The **SXAddl_SXCView_SXDId** record specifies how an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3) is associated with other records for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...stName (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x00. + +**stName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the [PivotTable view](#Section_a5f57198f2af40b2ba07e4b1836d73f3) that this SxcView class applies to. The corresponding [SxView](#sxview) record of this PivotTable view is the SxView record, in this [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56), with its **stTable** field equal to the value of this field. If there exists no such SxView record then this SxcView class MUST be ignored. + +#### SXAddl_SXCView_SXDSXPIIvmb + +The **SXAddl_SXCView_SXDSXPIIvmb** record specifies a mapping between [value metadata](#Section_e78bf5ba22754bad8e6cf4f59644efa6) and a field on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
isxpi
ivmb
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x36. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +**isxpi (4 bytes):** An unsigned integer that specifies the index of the entry on the page axis. MUST be greater than or equal to zero and less than the value of the **cDimPg** field of the [SxView](#sxview) record of the PivotTable view. + +**ivmb (4 bytes):** An unsigned integer that specifies the zero-based index of the [MDB](#mdb) record in the sequence of records that conforms to the [MDBLOCK](#globals-substream) rule. The referenced MDB specifies the value metadata. MUST be greater than or equal to zero and less than the count of MDB records. + +#### SXAddl_SXCView_SXDTableStyleClient + +The **SXAddl_SXCView_SXDTableStyleClient** record specifies [table style](#Section_4ac7212b4aa74ece962526c58224ae80) properties for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved1
...
ABCDEFGreserved2stName (variable)
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x1E. + +**reserved1 (6 bytes):** MUST be zero, and MUST be ignored. + +**A - unused (1 bit):** Undefined and MUST be ignored. + +**B - fLastColumn (1 bit):** A bit that specifies whether any [table style elements](#Section_84f2f67849214e8c83eb10d4fff7e935) (as specified by [TableStyleElement](#tablestyleelement)) with a **tseType** field equal to 0x00000004 are applied to the [PivotTable view](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +**C - fRowStrips (1 bit):** A bit that specifies whether any table style elements (as specified by TableStyleElement) with a **tseType** field equal to 0x00000005 or 0x00000006 are applied to the PivotTable view. + +**D - fColumnStrips (1 bit):** A bit that specifies whether any table style elements (as specified by TableStyleElement) with a **tseType** field equal to 0x00000007 or 0x00000008 are applied to the PivotTable view. + +**E - fRowHeaders (1 bit):** A bit that specifies whether any table style elements (as specified by TableStyleElement) with a **tseType** field equal to 0x00000003, 0x00000017, 0x00000018, or 0x00000019 are applied to the PivotTable view. + +**F - fColumnHeaders (1 bit):** A bit that specifies whether any table style elements (as specified by TableStyleElement) with a **tseType** field equal to 0x00000001, 0x00000014, 0x00000015, or 0x00000016 are applied to the PivotTable view. + +**G - fDefaultStyle (1 bit):** A bit that specifies whether to apply the default [TableStyle](#tablestyle) to the PivotTable view. + +**reserved2 (9 bits):** MUST be zero, and MUST be ignored. + +**stName (variable):** An [LPWideString](#lpwidestring) structure that specifies the name of the TableStyle applied to the PivotTable view. The length MUST be greater than zero and less than or equal to 255 characters. + +#### SXAddl_SXCView_SXDVer10Info + +The **SXAddl_SXCView_SXDVer10Info** record specifies information about a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...bVerSxMacroABCDEFGH
IJunusedreserved2
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x02. + +**bVerSxMacro (1 byte):** A [DataFunctionalityLevel](#datafunctionalitylevel) structure that specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) that this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) was created with. SHOULD[\<129\>](#Appendix_A_129) be less than 3 if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4) is less than 3. MUST be greater than or equal to 3 if the PivotCache functionality level of the associated PivotCache is greater than or equal to 3. + +**A - fDisplayImmediateItems (1 bit):** A bit that specifies whether [pivot items](#Section_58891cc5dd9b4293a97831070779524f) are displayed in the PivotTable view even when there is no [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) on the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). If **bVerSxMacro** is greater than or equal to 3 then this value MUST be 1. + +**B - fEnableDataEd (1 bit):** A bit that specifies whether the user is allowed to change values in the data axis of the PivotTable view. + +**C - fDisableFList (1 bit):** A bit that specifies whether the [**PivotTable field list**](#gt_1760fb56-0c97-4c0d-a077-38338baa7577) is disabled. + +**D - fReenterOnLoadOnce (1 bit):** A bit that specifies whether the PivotTable view is recalculated the next time the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is opened. + +**E - fNotViewCalculatedMembers (1 bit):** A bit that specifies whether [**OLAP calculated members**](#gt_16cb1b2a-a915-42c1-81ef-fcf221adb0fe) are [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) in the PivotTable view. + +MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------| +| 0 | OLAP calculated members are not hidden. | +| 1 | OLAP calculated members are hidden. | + +MUST be ignored if the PivotTable view is a non-[OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f). + +**F - fNotVisualTotals (1 bit):** A bit that specifies whether [**grand totals**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7) and subtotals in an OLAP PivotTable view include the values of hidden [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32). + +MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------------------------| +| 0 | Hidden OLAP members are not included in grand totals and subtotals. | +| 1 | Hidden OLAP members are included in grand totals and subtotals. | + +MUST be ignored if the PivotTable view is a non-OLAP PivotTable view. + +**G - fPageMultipleItemLabel (1 bit):** A bit that specifies what text is displayed in a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the page area when a non-[**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) has one or more hidden pivot items. + +MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Show text indicating that all items are displayed. | +| 1 | If the data source has one or more hidden pivot items, show text indicating that not all items are displayed, otherwise show text indicating that all items are displayed. | + +MUST be ignored if the PivotTable view is an OLAP PivotTable view. + +**H - fTensorFillCv (1 bit):** A bit that specifies whether the [**fill color**](#gt_ed1c5310-a27a-4576-883a-f9f3e18ba20a) retrieved from the OLAP data source is used in the PivotTable view. + +MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The fill color from the OLAP data source is not used. | +| 1 | If the data source is OLAP and the fill color is available from the OLAP data source, then the fill color is used. | + +MUST be ignored if the PivotTable view is a non-OLAP PivotTable view. + +**I - fHideDDData (1 bit):** A bit that specifies whether the control for selecting the pivot items to be displayed in the PivotTable view is hidden. + +**J - reserved1 (3 bits):** MUST be zero, and MUST be ignored. + +**unused (12 bits):** Undefined, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCView_SXDVer12Info + +The **SXAddl_SXCView_SXDVer12Info** record specifies information for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...ABCDEFGHIJKreserved2
...LMNOcIndentIncPreserved3
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x19. + +**A - fDefaultCompact (1 bit):** A bit that specifies whether new [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5) added to the [PivotTable view](#Section_a5f57198f2af40b2ba07e4b1836d73f3) are in [**compact axis**](#gt_87303118-9ef7-437d-914a-2ad9964b5e81) mode by default. + +**B - fDefaultOutline (1 bit):** A bit that specifies whether new pivot fields added to the PivotTable view are displayed in outline format by default. + +**C - fOutlineData (1 bit):** A bit that specifies whether the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592) is displayed in outline format. See [Subtotalling](#Section_427438d9b8e34a5c8b678f158fbf680f) for more information. + +**D - fCompactData (1 bit):** A bit that specifies whether the data field is displayed in compact axis mode. See [PivotTable Layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4) for more information. + +**E - fNewDropZones (1 bit):** A bit that specifies whether the application allows dragging within the [**PivotTable field list**](#gt_1760fb56-0c97-4c0d-a077-38338baa7577). + +**F - fPublished (1 bit):** A bit that specifies whether this PivotTable is marked as having already been [**published**](#gt_8ffc383a-d4f1-4515-a8b5-874d84ab2d2b) to a server-based application. This bit is ignored if the **fPublishedBookItems** field of the [BookExt_Conditional12](#bookext_conditional12) structure is zero. + +**G - fTurnOffImmersive (1 bit):** A bit that specifies whether a user interface for manipulating PivotTable options is displayed. + +MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | A user interface for manipulating PivotTable options is displayed. | +| 1 | A user interface for manipulating PivotTable options is not displayed. | + +**H - fSingleFilterPerField (1 bit):** A bit that specifies whether this PivotTable can have multiple [**filters**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) per field. + +MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------------------------------| +| 0 | The PivotTable can have many filters per field. | +| 1 | The PivotTable can have a maximum of one filter per field. | + +**I - fNonDefaultSortInFlist (1 bit):** A bit that specifies whether PivotTable fields are sorted in the PivotTable field list. + +MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------------------------------| +| 0 | PivotTable fields are not sorted in the PivotTable field list. | +| 1 | PivotTable fields are sorted in the PivotTable field list. | + +**J - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**K - fDontUseCustomLists (1 bit):** A bit that specifies whether to use [**custom lists**](#gt_92d2bb3a-2615-4bf8-b87f-887302d4c40c) when sorting the PivotTable. + +MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------------| +| 0 | Custom lists are used when sorting the PivotTable. | +| 1 | Custom lists are not used when sorting the PivotTable. | + +**reserved2 (9 bits):** MUST be zero, and MUST be ignored. + +**L - fHideDrillIndicators (1 bit):** A bit that specifies whether the [**expand/collapse buttons**](#gt_6b6cf48b-35ae-4101-86b4-c5d63aca70a6) are [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) in the PivotTable view. + +**M - fPrintDrillIndicators (1 bit):** A bit that specifies whether the expand/collapse buttons are printed. + +**N - fMemPropsInTips (1 bit):** A bit that specifies whether [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) properties are displayed in [**ToolTips**](#gt_84d44447-feaf-41a4-bf12-004c0f080fc2). + +**O - fNoPivotTips (1 bit):** A bit that specifies whether ToolTips are displayed on cells in the PivotTable view. + +MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------------------| +| 0 | ToolTips are displayed on cells in the PivotTable view. | +| 1 | ToolTips are not displayed on cells in the PivotTable view. | + +**cIndentInc (7 bits):** An unsigned integer that specifies the number of characters to indent row labels by when compact axis mode is used. See PivotTable Layout for more information. + +**P - fNoHeaders (1 bit):** A bit that specifies whether field captions are displayed in the PivotTable layout. + +MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------------------------------| +| 0 | Field captions are displayed in the PivotTable layout. | +| 1 | Field captions are not displayed in the PivotTable layout. | + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCView_SXDVerUpdInv + +The **SXAddl_SXCView_SXDVerUpdInv** record specifies the record-handling behavior for following records of the [SXCView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
data
...
...
+ +**data (12 bytes):** An [SXAddl_SXDVerUpdInv](#sxaddl_sxdverupdinv) structure. The value of **data.hdr.sxc** MUST equal 0x00 and the value of **data.hdr.sxd** MUST equal 0x01. The value of **data.dwVersionInvalidates** MUST equal 0x0002 or 0x00FF. + +If the value of **data.dwVersionInvalidates** is not 0x00FF and is greater than or equal to the value of the **VerSxLastUpdated** field of the [QsiSXTag](#qsisxtag) record of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), the following records of this SXCView class, including nested classes or until another SXAddl_SXCView_SXDVerUpdInv record is encountered, MUST be ignored. + +### SxBool + +The **SxBool** record specifies a Boolean [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) or value. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
bool
+ +**bool (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies the record value. + +### SXDB + +The **SXDB** record specifies [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) properties. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
crdbdb
idstmABCDEFunused1
unused2cfdbdb
cfdbTotcrdbUsed
vsTypecchWho
rgb (variable)
...
+ +**crdbdb (4 bytes):** A signed integer that specifies the number of [cache records](#Section_fe6e4ca0a9b646a4898124e4b61a770a) for this PivotCache. MUST be greater than or equal to 0. MUST be 0 for [OLAP PivotCaches](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b). MUST be ignored if **fSaveData** is 0. + +**idstm (2 bytes):** An unsigned integer that specifies the stream that contains the data for this PivotCache. MUST be equal to the value of the **idstm** field of the [SXStreamID](#sxstreamid) record that specifies the PivotCache stream that contains this record. + +**A - fSaveData (1 bit):** A bit that specifies whether cache records exist. MUST be 0 for OLAP PivotCaches. + +**B - fInvalid (1 bit):** A bit that specifies whether the cache records are in the not-valid state. MUST be equal to 1 if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than or equal to 3. MUST be equal to 1 for OLAP PivotCaches. See cache records for more information. + +**C - fRefreshOnLoad (1 bit):** A bit that specifies whether the PivotCache is refreshed on load. + +**D - fOptimizeCache (1 bit):** A bit that specifies whether optimization is applied to the PivotCache to reduce memory usage. MUST be 0 and MUST be ignored for a non-[**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) PivotCache. + +**E - fBackgroundQuery (1 bit):** A bit that specifies whether the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) used to [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) the PivotCache is executed asynchronously. MUST be ignored if **vsType** not equals 0x0002. + +**F - fEnableRefresh (1 bit):** A bit that specifies whether refresh of the PivotCache is enabled. MUST be equal to 0 if the PivotCache functionality level is greater than or equal to 3. MUST be equal to 0 for OLAP PivotCaches. + +**unused1 (10 bits):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**cfdbdb (2 bytes):** A signed integer that specifies the number of [cache fields](#Section_6497eb794042445780e75959c9f0583c) that corresponds to the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4). MUST be greater than or equal to 0. + +**cfdbTot (2 bytes):** A signed integer that specifies the number of cache fields in the PivotCache. MUST be greater than or equal to 0. + +**crdbUsed (2 bytes):** An unsigned integer that specifies the number of records used to calculate the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) report. Records excluded by [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) filtering are not included in this value. MUST be 0 for OLAP PivotCaches. + +**vsType (2 bytes):** An unsigned integer that specifies the type of source data. MUST be equal to the value of the **sxvs** field of the [SXVS](#sxvs) record that follows the SXStreamID record that specifies the PivotCache stream that contains this record. + +**cchWho (2 bytes):** An unsigned integer that specifies the number of characters in **rgb**. MUST be equal to 0xFFFF, or MUST be greater than or equal to 1 and less than or equal to 0x00FF. + +**rgb (variable):** An optional [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of the user who last refreshed the PivotCache. MUST exist if and only if the value of **cchWho** is not equal to 0xFFFF.  If this field exists, the length MUST equal **cchWho**. The length of this value MUST be less than 256 characters. The name is an application-specific setting that is not necessarily related to the [User Names Stream](#Section_1b98bc4df7c640a088dba99426635acd) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +### SXDBB + +The **SXDBB** record specifies the values of all the [cache fields](#Section_6497eb794042445780e75959c9f0583c) that have a **fAllAtoms** field of the [SXFDB](#sxfdb) record equal to 1 and that correspond to [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) entities, as specified by cache fields, for a single [cache record](#Section_fe6e4ca0a9b646a4898124e4b61a770a). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
blob (variable)
...
+ +**blob (variable):** An array of 1-byte and 2-byte unsigned integers that specifies indexes to [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) of cache fields that correspond to source data entities, as specified by cache fields, that have an **fAllAtoms** field of the SXFDB record equal to 1. The order of the indexes specified in the array corresponds to the order of the cache fields as they appear in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). Each unsigned integer specifies a zero-based index of a record in the sequence of records that conforms to the [SRCSXOPER](#pivot-cache-storage-_sx_db_cur) rule of the associated cache field. The referenced record from the SRCSXOPER rule specifies a cache item that specifies a value for the associated cache field. If the **fShortIitms** field of an SXFDB record of the cache field equals 1, the index value for this cache field is stored in this field in two bytes; otherwise, the index value is stored in this field in a single byte. + +### SXDBEx + +The **SXDBEx** record specifies additional [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) properties. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
numDate
...
cSxFormula
+ +**numDate (8 bytes):** A [DateAsNum](#dateasnum) structure that specifies the date and time on which the PivotCache was created or last refreshed. + +**cSxFormula (4 bytes):** An unsigned integer that specifies the count of [SXFormula](#sxformula) records for this cache. + +### SXDI + +The **SXDI** record specifies a [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679) for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
isxvdDataiiftab
dfisxvd
isxviifmt
cchNamestName (variable)
...
+ +**isxvdData (2 bytes):** A signed integer that specifies a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) index as specified in Pivot Fields. + +If the PivotTable view is a non-[OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f), the values in the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) associated with the associated [cache field](#Section_6497eb794042445780e75959c9f0583c) of the referenced pivot field are aggregated as specified in this record. + +If the PivotTable view is an OLAP PivotTable view, the associated [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) of the referenced pivot field specifies the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) for this data item and the **iiftab** field is ignored. See [Association of Pivot Hierarchies and Pivot Fields and Cache Fields](#Section_01a66b9be4a24396b55c28d6207fd28f) to determine the associated pivot hierarchy. + +MUST be greater than or equal to zero and less than the value of the **cDim** field of the preceding [SxView](#sxview) record. + +The value of the **sxaxis.sxaxisData** field of the [Sxvd](#sxvd) record of the referenced pivot field MUST be 1. + +**iiftab (2 bytes):** A signed integer that specifies the [**aggregation function**](#gt_f9b44a9d-68c4-4a28-b347-cce9eb5f8845). + +MUST be a value from the following table: + +| Value | Meaning | +|--------|---------------------------------------------| +| 0x0000 | Sum of values | +| 0x0001 | Count of values | +| 0x0002 | Average of values | +| 0x0003 | Max of values | +| 0x0004 | Min of values | +| 0x0005 | Product of values | +| 0x0006 | Count of numbers | +| 0x0007 | Statistical standard deviation (sample) | +| 0x0008 | Statistical standard deviation (population) | +| 0x0009 | Statistical variance (sample) | +| 0x000A | Statistical variance (population) | + +**df (2 bytes):** A signed integer that specifies the calculation used to display the value of this data item. + +MUST be a value from the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ValueMeaning
0x0000The data item value is displayed.
0x0001Display as the difference between this data item value and the value of the pivot item specified by isxvi.
0x0002Display as a percentage of the value of the pivot item specified by isxvi.
0x0003Display as a percentage difference from the value of the pivot item specified by isxvi.
0x0004Display as the running total for successive pivot items in the pivot field specified by isxvd.
0x0005Display as a percentage of the total for the row containing this data item.
0x0006Display as a percentage of the total for the column containing this data item.
0x0007Display as a percentage of the grand total of the data item.
0x0008

Calculate the value to display using the following formula:

+

((this data item value) * (grand total of grand totals)) / ((row grand total) * (column grand total))

+ +**isxvd (2 bytes):** A signed integer that specifies a pivot field index as specified in Pivot Fields. The referenced pivot field is used in calculations as specified by the **df** field. + +If **df** is 0x0001, 0x0002, 0x0003, or 0x0004 then the value of **isxvd** MUST be greater than or equal to zero and less than the value of the **cDim** field in the preceding SxView record. Otherwise, the value of **isxvd** is undefined and MUST be ignored. + +**isxvi (2 bytes):** A signed integer that specifies the pivot item used by **df**. + +If **df** is 0x0001, 0x0002, or 0x0003 then the value of this field MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 to 0x7EFE | A pivot item index, as specified by Pivot Items, that specifies a pivot item in the pivot field specified by **isxvd**. MUST be less than the **cItm** field of the Sxvd record of the pivot field specified by **isxvd**. | +| 0x7FFB | The previous pivot item in the pivot field specified by **isxvd**. | +| 0x7FFC | The next pivot item in the pivot field specified by **isxvd.** | + +Otherwise, the value is undefined and MUST be ignored. + +**ifmt (2 bytes):** An [IFmt](#ifmt) structure that specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) for this item. + +**cchName (2 bytes):** An unsigned integer that specifies the length, in characters, of the [XLUnicodeStringNoCch](#xlunicodestringnocch) structure in the **stName** field. If the value is 0xFFFF then **stName** does not exist. Otherwise, the value MUST be greater than zero and less than or equal to 0x00FF. + +MUST NOT be 0xFFFF when the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is less than 3, or for non-OLAP PivotTable view . + +**stName (variable):** An XLUnicodeStringNoCch structure that specifies the name of this data item. A value that is not NULL specifies that this string is used to override the name in the corresponding cache field. + +MUST NOT exist if **cchName** is 0xFFFF. Otherwise, MUST exist and the length MUST equal **cchName**. + +If this string is not NULL and the PivotTable view is a non-OLAP PivotTable view, this field MUST be unique within all SXDI records in this [PivotTable view](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +### SXDtr + +The **SXDtr** record specifies a [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) or a value in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) that is an instance in time, expressed as a date and time of day. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
yrmon
domhrminsec
+ +**yr (2 bytes):** An unsigned integer that specifies the year component of the date. MUST be greater than or equal to 1900 and MUST be less than or equal to 9999. If **dom** is 0, **yr** MUST be 1900. + +**mon (2 bytes):** An unsigned integer that specifies the month component of the date. MUST be greater than or equal to 1, and MUST be less than or equal to 12. If **dom** is equal to 0, **mon** MUST be equal to 1. + +**dom (1 byte):** An unsigned integer that specifies the day of month component of the date. MUST be greater than or equal to 0 and MUST be less than or equal to 31. + +**hr (1 byte):** An unsigned integer that specifies the hour component of the time of day. MUST be less than or equal to 23. + +**min (1 byte):** An unsigned integer that specifies the minute component of the time of day. MUST be less than or equal to 59. + +**sec (1 byte):** An unsigned integer that specifies the second component of the time of day. MUST be less than or equal to 59. + +### SxDXF + +The **SxDXF** record specifies [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6) applied to a [PivotTable area](#Section_c3139d36c8934b57a44df7b7c13556e5). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
dxf (variable)
...
+ +**dxf (variable):** A [DXFN12NoCB](#dxfn12nocb) structure that specifies the differential formatting. + +### SxErr + +The **SxErr** record specifies an error [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) or value. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
wbe
+ +**wbe (2 bytes):** An unsigned integer that specifies the error record value. MUST be a value from the following table**[\<130\>](#Appendix_A_130):** + +| Value | Meaning | +|-------|----------| +| 0x00 | \#NULL! | +| 0x07 | \#DIV/0! | +| 0x0F | \#VALUE! | +| 0x17 | \#REF! | +| 0x1D | \#NAME? | +| 0x24 | \#NUM! | +| 0x2A | \#N/A | + +### SXEx + +The **SXEx** record specifies additional properties of a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) and specifies the beginning of a collection of records as defined by the [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies [**selection**](#gt_8a241461-3c59-45fb-9094-b6692a0c27fe) and formatting properties for the PivotTable view. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
csxformatcchErrorString
cchNullStringcchTag
csxselectcrwPage
ccolPageAcWrapPageBCreserved2
DEFGHIJKreserved3cchPageFieldStyle
cchTableStylecchVacateStyle
stError (variable)
...
stDisplayNull (variable)
...
stTag (variable)
...
stPageFieldStyle (variable)
...
stTableStyle (variable)
...
stVacateStyle (variable)
...
+ +**csxformat (2 bytes):** An unsigned integer that specifies the number of [SxFormat](#sxformat) records that follow this record. MUST be less than or equal to 0xFFFF. + +**cchErrorString (2 bytes):** An unsigned integer that specifies the length, in characters, of the [XLUnicodeStringNoCch](#xlunicodestringnocch) structure in the **stError** field. If the value is 0xFFFF, then **stError** does not exist. MUST be 0xFFFF or MUST be greater than zero and less than or equal to 0x00FF. + +**cchNullString (2 bytes):** An unsigned integer that specifies the length, in characters, of the XLUnicodeStringNoCch structure in the **stDisplayNull** field. If the value is 0xFFFF, then **stDisplayNull** does not exist. MUST be 0xFFFF or MUST be greater than zero and less than or equal to 0x00FF. + +**cchTag (2 bytes):** An unsigned integer that specifies the length, in characters, of the XLUnicodeStringNoCch structure in the **stTag** field. If the value is 0xFFFF, then **stTag** does not exist. MUST be 0xFFFF or MUST be greater than zero and less than or equal to 0x00FF. + +**csxselect (2 bytes):** An unsigned integer that specifies the number of [SxSelect](#sxselect) records that follow this record. MUST be less than or equal to 0xFFFF. + +**crwPage (2 bytes):** A [DRw](#drw) structure that specifies the number of rows in the page area (see [Location and Body](#Section_7f7d9d76a55041d9ae9f0d8539cc09f8)) of the PivotTable view. + +**ccolPage (2 bytes):** A [DCol](#dcol) structure that specifies the number of columns in the page area (see Location and Body) of the PivotTable view. + +**A - fAcrossPageLay (1 bit):** A bit that specifies how [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5) are laid out in the page area (see Location and Body) when there are multiple pivot fields on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Pivot fields are displayed in the page area from the top to the bottom first, as fields are added, before moving to another column. | +| 0x1 | Pivot fields are displayed in the page area from left to right first, as fields are added, before moving to another row. | + +**cWrapPage (8 bits):** An unsigned integer that specifies the number of pivot fields in the page area (see Location and Body) to display before moving to another row or column, as specified by **fAcrossPageLay**. + +MUST be less than or equal to 0xFF. A value of 0 means that no wrap is allowed. + +**B - unused (1 bit):** Undefined and MUST be ignored. + +**C - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**reserved2 (5 bits):** MUST be zero and MUST be ignored. + +**D - fEnableWizard (1 bit):** A bit that specifies whether a wizard user interface is displayed to work with the PivotTable view. + +**E - fEnableDrilldown (1 bit):** A bit that specifies whether details can be shown for [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the data area, as specified by [PivotTable Layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4). + +**F - fEnableFieldDialog (1 bit):** A bit that specifies whether a user interface for setting properties of a pivot field can be displayed. + +**G - fPreserveFormatting (1 bit):** A bit that specifies whether formatting is preserved when the PivotTable view is recalculated. + +If the value is 1, **csxformat** MUST be 0 and there MUST be no SxFormat records following this record. + +**H - fMergeLabels (1 bit):** A bit that specifies whether empty cells adjacent to the cells displaying [pivot item](#Section_58891cc5dd9b4293a97831070779524f) captions of pivot fields on the [row axis](#Section_3f46e7207706400cba9473cb829f869a) and [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) of the PivotTable view are merged into a single cell with center-aligned text. + +**I - fDisplayErrorString (1 bit):** A bit that specifies whether the PivotTable view displays the custom error string **stError** in cells that contain errors. + +**J - fDisplayNullString (1 bit):** A bit that specifies whether the PivotTable view displays the custom string **stDisplayNull** in cells that contain NULL values. + +**K - fSubtotalHiddenPageItems (1 bit):** A bit that specifies whether hidden pivot items, as specified by [SXVI](#sxvi) records with the **fHidden** field equal to 1, of a pivot field on the page axis with the **isxvi** field of the corresponding [SXPI_Item](#sxpi_item) structure equal to 0x7FFD are filtered out when calculating the PivotTable view. + +MUST be 0 for non-[**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data sources**](#gt_e091613c-6901-4874-b9b2-27273ead1075) if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is 3. + +**reserved3 (8 bits):** MUST be zero and MUST be ignored. + +**cchPageFieldStyle (2 bytes):** An unsigned integer that specifies the length, in characters, of the XLUnicodeStringNoCch structure in the **stPageFieldStyle** field. If the value is 0xFFFF, then **stPageFieldStyle** does not exist. + +MUST be 0xFFFF or MUST be greater than zero and less than or equal to 0x00FF. + +**cchTableStyle (2 bytes):** An unsigned integer that specifies the length, in characters, of the XLUnicodeStringNoCch structure in the **stTableStyle** field. If the value is 0xFFFF, then **stTableStyle** does not exist. + +MUST be 0xFFFF or MUST be greater than zero and less than or equal to 0x00FF. + +**cchVacateStyle (2 bytes):** An unsigned integer that specifies the length, in characters, of the XLUnicodeStringNoCch structure in the **stVacateStyle** field. If the value is 0xFFFF, then **stVacateStyle** does not exist. + +MUST be 0xFFFF or MUST be greater than zero and less than or equal to 0x00FF. + +**stError (variable):** An XLUnicodeStringNoCch structure that specifies a custom string displayed in cells that contain errors when the value of **fDisplayErrorString** is 1. The length is specified in **cchErrorString**. + +This field is optional and MUST NOT exist if **cchErrorString** is 0xFFFF. + +**stDisplayNull (variable):** An XLUnicodeStringNoCch structure that specifies a custom string displayed in cells that contain NULL values when **fDisplayNullString** is 1. The length is specified in **cchNullString**. + +This field is optional and MUST NOT exist if **cchNullString** is 0xFFFF. + +**stTag (variable):** An XLUnicodeStringNoCch structure that specifies a custom string saved with the PivotTable view. The length is specified in **cchTag**. + +This field is optional and MUST NOT exist if **cchTag** is 0xFFFF. + +**stPageFieldStyle (variable):** An XLUnicodeStringNoCch structure that specifies the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) used in the page area (see Location and Body) of the PivotTable view. The style is specified by the [StyleExt](#styleext) record with its **stName** field equal to this field's value. If **cchPageFieldStyle** is 0xFFFF or less than 1, no style is applied. The length is specified in **cchPageFieldStyle**. + +This field is optional and MUST NOT exist if **cchPageFieldStyle** is 0xFFFF. + +**stTableStyle (variable):** An XLUnicodeStringNoCch structure that specifies the style used in the body of the PivotTable view. The style is specified by the StyleExt record with its **stName** field equal to this field's value. If **cchTableStyle** is 0xFFFF or less than 1, no style is applied. The length is specified in **cchTableStyle**. + +This field is optional and MUST NOT exist if **cchTableStyle** is 0xFFFF. + +**stVacateStyle (variable):** An XLUnicodeStringNoCch structure that specifies the style applied to cells that become empty when the PivotTable view is recalculated. The style is specified by the StyleExt record with its **stName** field equal to this field's value. If **cchVacateStyle** is 0xFFFF or less than 1, no style is applied. The length is specified in **cchVacateStyle**. + +This field is optional and MUST NOT exist if **cchVacateStyle** is 0xFFFF. + +### SXFDB + +The **SXFDB** record specifies properties for a [cache field](#Section_6497eb794042445780e75959c9f0583c) within a [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEFGHIJKLMNOPifdbParent
ifdbBasecitmUnq
csxopercisxoper
catmstFieldName (variable)
...
+ +**A - fAllAtoms (1 bit):** A bit that specifies whether this cache field has a collection of [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0). If **fSomeUnhashed** is equal to 1, this value MUST be equal to 0. + +**B - fSomeUnhashed (1 bit):** Undefined, and MUST be ignored. If the **fAllAtoms** field is equal to 1, MUST be equal to 0. + +**C - fUsed (1 bit):** Undefined, and MUST be ignored. + +**D - fHasParent (1 bit):** A bit that specifies whether **ifdbParent** specifies a reference to a parent grouping cache field. For more information, see [Grouping](#Section_63e07ed20a764cb08cf446aaf25464c2). If the **fCalculatedField** field is equal to 1, then this field MUST be equal to 0. + +**E - fRangeGroup (1 bit):** A bit that specifies whether this cache field is grouped by using numeric grouping or date grouping, as specified by Grouping. If this field is equal to 1, then this record MUST be followed by a sequence of [SXString](#sxstring) records, as specified by the [GRPSXOPER](#pivot-cache-storage-_sx_db_cur) rule. The quantity of SXString records is specified by **csxoper**. If this field is equal to 1, then this record MUST be followed by a sequence of records that conforms to the SXRANGE rule that specifies the grouping properties for the ranges of values. + +**F - fNumField (1 bit):** A bit that specifies whether the cache items in this cache field contain at least one numeric cache item, as specified by [SXNum](#sxnum). If **fDateInField** is equal to 1, this field MUST be equal to 0. + +**G - unused1 (1 bit):** Undefined and MUST be ignored. + +**H - fTextEtcField (1 bit):** A bit that specifies whether the cache items contain text data. If **fNumField** is 1, this field MUST be ignored. + +**I - fnumMinMaxValid (1 bit):** A bit that specifies whether a valid minimum or maximum value can be computed for the cache field. MUST be equal to 1 if **fDateInField** or **fNumField** is equal to 1. + +**J - fShortIitms (1 bit):** A bit that specifies whether there are more than 255 cache items in this cache field. If **catm** is greater than 255, this value MUST be equal to 1; otherwise it MUST be 0. + +**K - fNonDates (1 bit):** A bit that specifies whether the cache items in this cache field contain values that are not time or date values. If this cache field is a grouping cache field, as specified by Grouping, then this field MUST be ignored. Otherwise, if **fDateInField** is equal to 1, then this field MUST be 0. + +**L - fDateInField (1 bit):** A bit that specifies whether the cache items in this cache field contain at least one time or date cache item, as specified by [SXDtr](#sxdtr). If **fNonDates** is equal to 1, then this field MUST be equal to 0. + +**M - unused2 (1 bit):** Undefined and MUST be ignored. + +**N - fServerBased (1 bit):** A bit that specifies whether this cache field is a server-based page field when the corresponding [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) is on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), as specified in [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4). + +This value applies only to an [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) PivotCache. MUST NOT be equal to 1 if **fCantGetUniqueItems** is equal to 1. If **fCantGetUniqueItems** is equal to 1, then the [ODBC connection](#Section_a8c9314e9f904738a482e97aa5ec2383) cannot provide a list of unique items for the cache field. + +> MUST be 0 for a cache field in a non-ODBC PivotCache. + +**O - fCantGetUniqueItems (1 bit):** A bit that specifies whether a list of unique values for the cache field was not available while refreshing the source data. This field applies only to a PivotCache that uses ODBC source data and is intended to be used in conjunction with optimization features. For example, the application can optimize memory usage when populating PivotCache records if it has a list of unique values for a cache field before all the records are retrieved from the ODBC connection. Or, the application can determine the appropriate setting of **fServerBased** based on this value. + +MUST be 0 for fields in a non-ODBC PivotCache. + +**P - fCalculatedField (1 bit):** A bit that specifies whether this field is a [calculated field](#Section_4594f2ac815740b381142e77ba8efb7d). The formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) of the calculated field is stored in a directly following [SXFormula](#sxformula) record. If **fHasParent** is equal to 1, this field MUST be equal to 0. + +**ifdbParent (2 bytes):** An unsigned integer that specifies the cache field index, as specified by Cache Fields, of the grouping cache field for this cache field. MUST be greater than or equal to 0x0000 and less than the **cfdbTot** field of the [SXDB](#sxdb) record of this PivotCache. If **fHasParent** is equal to 0, then this field MUST be ignored. If **fHasParent** is equal to 1, and **fRangeGroup** is equal to 1, and the **iByType** field of the [SXRng](#sxrng) record of this cache field is greater than 0, then the **fRangeGroup** of the SXFDB record of the cache field specified by **ifdbParent** MUST be 1 and the **iByType** field of the SXRng record of the cache field specified by **ifdbParent** MUST be greater than the **iByType** field of the SXRng record of this cache field. + +**ifdbBase (2 bytes):** An unsigned integer that specifies the cache field index, as specified by Cache Fields, of the base cache field, as specified by Grouping, for the cache field specified by this record. MUST be greater than or equal to 0x0000 and less than the value of the **cfdbdb** field of the SXDB record of this PivotCache. If the cache field specified by this record is not a grouping cache field, then this field MUST be ignored. + +**citmUnq (2 bytes):** Undefined and MUST be ignored. + +**csxoper (2 bytes):** An unsigned integer that specifies the number of cache items in this cache field when this cache field is a grouping cache field, as specified by Grouping. There MUST be an equivalent number of sequences of records that conform to the GRPSXOPER rule following this record that specify the cache items. If the **fRangeGroup** field and the **fCalculatedField** field are equal to 0 and this cache field corresponds to a source data entity, this field MUST be equal to 0. If the **fRangeGroup** field is equal to 1, this value MUST be greater than or equal to 1. + +**cisxoper (2 bytes):** An unsigned integer that specifies the number of cache items in the base cache field that are grouped by this cache field. There MUST be an equivalent number of [SxIsxoper](#sxisxoper) records following this record that specify which cache item in this cache field groups each of the cache items in the base cache field. For more information, see Grouping. + +**catm (2 bytes):** An unsigned integer that specifies the number of cache items in the collection sequences of records that conform to the SRCSXOPER rule in this cache field. If **fAllAtoms** is 0, then this field MUST be equal to 0x0000. If this cache field corresponds to source data entities then there MUST be an equal number of SRCSXOPER rules in this cache field. + +**stFieldName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the name of the cache field. MUST be less than or equal to 255 characters long. + +### SXFDBType + +The **SXFDBType** record specifies the type of data contained in this [cache field](#Section_6497eb794042445780e75959c9f0583c). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
wTypeSql
+ +**wTypeSql (2 bytes):** An [ODBCType](#odbctype) structure that specifies the [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) data type as returned by the ODBC provider of the data in this cache field. + +### SxFilt + +The **SxFilt** record specifies information for a [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f) filter. + +See [SxRule](#sxrule) for more information about [PivotTable views](#Section_09410dfbaac84a719ecf177ffba12c37) that this record applies to. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEiDimisxvdFGH
grbitSbtcisxvi
+ +**A - sxaxisRw (1 bit):** A bit that specifies whether this [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) refers to the [row axis](#Section_3f46e7207706400cba9473cb829f869a). MUST be zero if **sxaxisCol** is 1, if **sxaxisPage** is 1, or if **sxaxisData** is 1. + +**B - sxaxisCol (1 bit):** A bit that specifies whether this filter refers to the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). MUST be zero if **sxaxisRw** is 1, if **sxaxisPage** is 1, or if **sxaxisData** is 1. + +**C - sxaxisPage (1 bit):** A bit that specifies whether this filter refers to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). MUST be zero if **sxaxisRw** is 1, if **sxaxisCol** is 1, or if **sxaxisData** is 1. + +**D - sxaxisData (1 bit):** A bit that specifies whether this filter refers to the [value axis](#Section_4c5c2daa289746e1854b0ce04209f060). MUST be zero if **sxaxisRw** is 1, if **sxaxisCol** is 1, or if **sxaxisPage** is 1. + +**E - reserved1 (2 bits):** MUST be zero, and MUST be ignored. + +**iDim (10 bits):** A signed integer that specifies the zero-based position of the [PivotTable field](#Section_1edf7f2294084945b2de56526c14fca5) within the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) specified by **sxAxis**. MUST be greater than or equal to 0 and less than or equal to 31. + +**isxvd (10 bits):** A signed integer that specifies the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592), pivot field, or [cache field](#Section_6497eb794042445780e75959c9f0583c) that this filter refers to. MUST be greater than or equal to 0 and less than or equal to 255 or equal to -2. MUST be a value from the following table: + +| Value | Value of the fCacheBased field of the preceding SxRule record | Meaning | +|----|----|----| +| -2 | MUST be 0 | Specifies that this rule refers to the data field. | +| A value greater than or equal to zero | 0 | Specifies a pivot field index as specified by pivot fields. The pivot field index specifies which pivot field is referenced by this filter. | +| A value greater than or equal to zero | 1 | Specifies a cache field index as specified by cache fields. The cache field index specifies which cache field is referenced by this filter. | + +**F - fSelected (1 bit):** A bit that specifies whether the header of the PivotTable field this filter refers to is included in the PivotTable rule that this record belongs to. + +**G - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**H - reserved3 (4 bits):** MUST be zero, and MUST be ignored. + +**grbitSbt (2 bytes):** A signed integer that specifies the set of subtotals used in this filter. MUST be one of the following bits, or a combination of the following bits. DEFAULT MUST be combined only with DATA, BLANK, or both. + +| Bits | Meaning | +|--------|---------| +| 0x0001 | DATA | +| 0x0002 | DEFAULT | +| 0x0004 | SUM | +| 0x0008 | COUNTA | +| 0x0010 | AVERAGE | +| 0x0020 | MAX | +| 0x0040 | MIN | +| 0x0080 | PRODUCT | +| 0x0100 | COUNT | +| 0x0200 | STDEV | +| 0x0400 | STDEVP | +| 0x0800 | VAR | +| 0x1000 | VARP | +| 0x4000 | BLANK | + +**cisxvi (2 bytes):** An unsigned integer that specifies the number of indexes in the [SxItm](#sxitm) record that follows this record. + +### SxFmla + +The **SxFmla** record specifies a [PivotParsedFormula](#pivotparsedformula) and specifies the beginning of a collection of records as defined by the [pivot cache](#Section_c5fb3f663ef64308ae3de59244159687) storage [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) [calculated field](#Section_4594f2ac815740b381142e77ba8efb7d) or [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b) formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
formula (variable)
...
+ +**formula (variable):** A PivotParsedFormula structure that specifies the formula. + +### SxFormat + +The **SxFormat** record specifies the beginning of a collection of records as defined by the [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies the [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6) and specifies a [PivotRule](#Section_ce60432dda944422929fcf3f6a0a206f) that specifies the area of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) to apply the formatting to. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rlTypereservedcbData
+ +**rlType (4 bits):** A Boolean (section [2.5.14](#boolean)) that specifies whether formatting was applied to the PivotTable view. MUST be a value from the following table: + +| Value | Description | +|--------|-----------------------------| +| 0x0000 | The formatting was cleared. | +| 0x0001 | The formatting was applied. | + +**reserved (12 bits):** MUST be zero, and MUST be ignored + +**cbData (2 bytes):** An unsigned integer that specifies the number of bytes in the [SxDXF](#sxdxf) record that follows this record. MUST be zero if **rlType** is zero. If this field is zero then zero SxDXF records MUST follow this record. + +### SXFormula + +The **SXFormula** record specifies the [cache field](#Section_6497eb794042445780e75959c9f0583c) that a [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b) formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) applies to. The calculated item formula is stored in the last [SxFmla](#sxfmla) record preceding this record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reservedifdb
+ +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**ifdb (2 bytes):** A signed integer that specifies the cache field index as specified in Cache Fields. The cache field index specifies which cache field the calculated item formula applies to. MUST be greater than or equal to -1. If the value is -1, the calculated item formula applies to all cache fields. If the cache field is a source field, the value MUST be equal to the value of **isxvd** in the last [SxRule](#sxrule) record preceding this record. + +### SXInt + +The **SXInt** record specifies a number in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
num
+ +**num (2 bytes):** A signed integer that specifies a number in the PivotCache. + +### SxIsxoper + +The **SxIsxoper** record specifies the mapping between [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in a [cache field](#Section_6497eb794042445780e75959c9f0583c) and cache items in a grouping cache field for discrete grouping, as specified by [Grouping](#Section_63e07ed20a764cb08cf446aaf25464c2). The grouping cache field is specified by the [SXFDB](#sxfdb) record preceding this record. The value of the **fRangeGroup** field of the SXFDB record MUST be 0 and the value of the **csxoper** field of the SXFDB record MUST be greater than 0. This record immediately follows the collection of records that specifies cache item values for the SXFDB record as defined in the [PivotCache Storage](#Section_c5fb3f663ef64308ae3de59244159687) part [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgSxIsxoper (variable)
...
+ +**rgSxIsxoper (variable):** An array of 2-byte unsigned integers. Each element of the array corresponds to a cache item in the cache field being grouped by the grouping cache field. The value of each element specifies the index of the cache item, as specified by Cache Items, in the grouping cache field that the cache item in the cache field is grouped under. + +The count of elements in the array MUST be equal to the value of the **cisxoper** field of the SXFDB record preceding this record and is identical to the number of cache items in the cache field being grouped. The value of each element MUST be less than the total number of cache items in the grouping cache field. + +### SxItm + +The **SxItm** record specifies references to [pivot items](#Section_58891cc5dd9b4293a97831070779524f), [data items](#Section_b51aa7b309b34aa78cb4964ad24d1679), or [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) as part of a [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f) filter. + +If this record exists, the **cisxvi** field of the preceding [SxFilt](#sxfilt) MUST be greater than 0. + +See [SxRule](#sxrule) for more information about [PivotTable views](#Section_09410dfbaac84a719ecf177ffba12c37) that this record applies to. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgisxvi (variable)
...
+ +**rgisxvi (variable):** An array of 2-byte unsigned integers that specifies pivot items, data item, or cache items associated with [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) included in the PivotTable rule. The array MUST be sorted in ascending order. The size of the array MUST be equal to the value of the **cisxvi** field of the preceding SxFilt record. Each unsigned 2-byte integer in the array MUST be less than or equal to 32500, or equal to 32767. The value 32767 specifies that there is no associated pivot item, data item, or cache item with the index. For more information, see PivotTable Rules. The meaning of this field is specified in the following table: + + +++++ + + + + + + + + + + + + + + + + + + + + + + + +

Value of the isxvd field of the preceding

+

SxFilt record

Value of the fCacheBased field of the preceding SxRule recordMeaning of the index
-2Not usedA data item index that specifies a data item associated with ranges of cells included in the PivotTable rules. MUST be less than the value of the cDimData field of the associated SxView record.
>= 00A pivot item index that specifies a pivot item in the pivot field specified by the isxvd field of the SxFilt record. The referenced pivot item is associated with ranges of cells included in the PivotTable rule. MUST be less than the cItems field of the Sxvd record.
1A cache item index, as specified by cache items, within the cache field specified by the isxvd field of the SxFilt record in the current PivotCache. The referenced cache item is associated with ranges of cells included in the PivotTable rule. MUST be less than the total number of cache items within the cache field associated with the pivot field specified by the isxvd field of the SxFilt record.
+ +### SxIvd + +The **SxIvd** record specifies an array of [SxIvdRw](#sxivdrw) or [SxIvdCol](#sxivdcol). + +An array of SxIvdRw specifies all items for the [row axis](#Section_3f46e7207706400cba9473cb829f869a) of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). An array of SxIvdCol specifies all items on [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) of the PivotTable view. + +Two or fewer records of this type appear in the file depending on the values of the **cDimRw** and **cDimCol** fields of the [SxView](#sxview) record of the PivotTable view. + +If the **cDimRw** and **cDimCol** fields of the SxView record are both greater than zero, then two records of this type appear in the file for the PivotTable view. The first record is an array of SxIvdRw and the second record is an array of SxIvdCol. + +If the value of the **cDimRw** field of the SxView record is greater than zero and the value of the **cDimCol** field of the SxView record is equal to zero, then only one record of this type appears in the file for the PivotTable view and it is an array of SxIvdRw. + +If the value of the **cDimCol** field of the SxView record is greater than zero and the value of the **cDimRw** field of the SxView record is equal to zero, then only one record of this type appears in the file for the PivotTable view and it is an array of SxIvdCol. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgSxivd (variable)
...
+ +**rgSxivd (variable):** An array of SxIvdRw or SxIvdCol items. + +If this is an array of SxIvdRw, the count of elements in the array MUST equal the value of the **cDimRw** field of the SxView record. + +If this is an array of SxIvdCol, the count of elements in the array MUST equal the value of the **cDimCol** field of the SxView record. + +### SXLI + +The **SXLI** record specifies [pivot lines](#Section_76610990666f492791b6d2280f607464) for the [row area](#Section_5594c95e6819461e80706f4b4fdfa091) or [column area](#Section_03aced8c25864e83982a1e3551a563d6) of a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgsxli (variable)
...
+ +**rgsxli (variable):** An array of [SXLIItem](#sxliitem). + +Zero or two records of this type appear in the file for each PivotTable view depending on the values of the **cRw** and **cCol** fields of the associated [SxView](#sxview) record. + +If the value of either of the **cRw** or **cCol** fields of the associated SxView is greater than zero, then two records of this type MUST exist in the file for the associated SxView. The first record contains row area pivot lines and the second record contains column area pivot lines. + +The count of SXLIItem structures in **rgsxli**, which are row area pivot lines, MUST equal the **cRw** field of SxView. + +The count of SXLIItem structures in **rgsxli**, which are column area pivot lines, MUST equal the **cCol** field of SxView. + +The associated SxView record is the SxView record of the PivotTable view. + +### SxName + +The **SxName** record specifies information used for a [calculated field](#Section_4594f2ac815740b381142e77ba8efb7d) or [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b) and that specifies the beginning of a collection of records as specified by the [pivot cache](#Section_c5fb3f663ef64308ae3de59244159687) storage [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf).  When used for a calculated field, this record specifies the index of a [cache field](#Section_6497eb794042445780e75959c9f0583c) used in a calculated field formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)).  When used for a calculated item, this record is followed by a collection of [SxPair](#sxpair) records that specify a [pivot item](#Section_58891cc5dd9b4293a97831070779524f) used in a calculated item formula (section 2.2.2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABunused2ifdb
ifncsxpair
+ +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - fErrName (1 bit):** A bit that specifies whether this record is not valid. MUST be set to 1 if **ifdb** field is set to -1. + +**unused2 (14 bits):** Undefined and MUST be ignored. + +**ifdb (2 bytes):** A signed integer that specifies a cache field index. The cache field index specifies a cache field used in a calculated field formula. MUST be greater than or equal to -1. MUST be set to -1 if **csxpair** is greater than 0. MUST be set to -1 when the calculated field formula cannot be computed because the cache field used in the formula is removed. + +**ifn (2 bytes):** A signed integer that MUST be set to -1. + +**csxpair (2 bytes):** An unsigned integer that specifies the count of contiguous SXPair records that follow this record. MUST be less than or equal to 1. MUST be equal to 0 if and only if this record is in a calculated field. + +### SxNil + +The **SxNil** record specifies an empty [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) or value. + +### SXNum + +The **SXNum** record specifies a numeric [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) or value. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
num
...
+ +**num (8 bytes):** An Xnum (section [2.5.342](#xnum)) structure that specifies the numeric record value. + +### SXPair + +The **SXPair** record specifies a reference to a [pivot item](#Section_58891cc5dd9b4293a97831070779524f) used to compute the value of a [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b) in a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
isxvdiCache
reserved1ABCDreserved3
+ +**isxvd (2 bytes):** An unsigned integer that specifies a [cache field](#Section_6497eb794042445780e75959c9f0583c) index. This index specifies a cache field that contains the [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) associated with the pivot item specified by **iCache**. + +**iCache (2 bytes):** A signed integer that specifies a pivot item of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) associated with this record as specified by [Associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4). This pivot item is used in a calculated item formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). If more than one PivotTable view is associated with this record, **iCache** specifies a pivot item for each such PivotTable view. + +If the value of **fPhysical** is 0, **iCache** is a cache item index and specifies the pivot item associated with that cache item. + +Otherwise, if the value of **fRelative** is 0 or if no pivot item in the visible item collection has a pivot item index smaller than the pivot item index of the current pivot item, **iCache** is a visible item index. Otherwise, the pivot item specified by **iCache** is the pivot item whose visible item index equals the value of **iCache** + 1 + the largest visible item index whose associated pivot item has a pivot item index smaller than the pivot item index of the current pivot item. If this value is less than 0 or greater than or equal to the number of elements in the visible item collection, no pivot item is specified. + +The current pivot item is the pivot item in the current [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) that corresponds to the calculated item that contains this record. + +The current pivot field is the pivot field of the PivotTable view associated with the cache field specified by **isxvd**. + +The visible item collection is the ordered collection of all pivot items specified by the sequence of records that conforms to the [PIVOTVD](#worksheet-substream) rule associated with the current pivot field that satisfy the following criteria: + +- The value of the **fHidden** field of the [SXVI](#sxvi) record associated with the pivot item is 0. + +- The value of the **fMissing** field of the SXVI record associated with the pivot item is 0 or the value of the **fShowAllItems** field of the SXVI record associated with the current pivot field is 1. + +- The value of the **itmType** field of the SXVI record associated with the pivot item is 0. + +A visible item index is specified to be the zero-based index of a pivot item in the visible item collection. + +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +**A - fFormula (1 bit):** A bit that specifies whether the item is a calculated item. If **fPhysical** is 1, it MUST have the same value as the **fFormula** field of the SXVI record corresponding to the pivot item specified by **iCache**. + +**B - reserved2 (2 bits):** MUST be zero, and MUST be ignored. + +**C - fPhysical (1 bit):** A bit that specifies whether **iCache** specifies a cache item index. + +| Value | Meaning | +|-------|-------------------------------------------------| +| 0 | **iCache** specifies a cache item index. | +| 1 | **iCache** does not specify a cache item index. | + +**D - fRelative (1 bit):** A bit that specifies whether the item is referred to by relative position rather than absolute position. If **fPhysical** is 0, **fRelative** MUST be 0 and MUST be ignored. If **fPhysical** is 1, **fRelative** MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------------------| +| 0 | Absolute position. | +| 1 | Position relative to the calculated item referring this item. | + +**reserved3 (11 bits):** MUST be zero, and MUST be ignored. + +### SXPI + +The **SXPI** record specifies the [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5) and information about filtering on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +MUST exist if and only if the value of the **cDimPg** field of the [SxView](#sxview) record of the PivotTable view is greater than zero. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgsxpi (variable)
...
+ +**rgsxpi (variable):** An array of [SXPI_Item](#sxpi_item)s that specifies the pivot fields and information about filtering on the page axis of a PivotTable view. The number of array elements MUST equal the value of the **cDimPg** field of the SxView record of the PivotTable view. + +### SXPIEx + +The **SXPIEx** record specifies [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) extensions to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). The number of SXPIEx records MUST equal the number of array elements in the **rgsxpi** field of the [SXPI](#sxpi) record. Each SXPIEx record corresponds to the [SXPI_Item](#sxpi_item) at the same position in the **rgsxpi** field of the SXPI record. + +For more information, see [OLAP Page Filtering](#Section_e04e871619234e2db02a270894d6be73). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
isxth
stUnique (variable)
...
stDisplay (variable)
...
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x080E. + +**isxth (4 bytes):** An unsigned integer that specifies a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) index, as specified in Pivot Hierarchies, of the pivot hierarchy associated with this entry on the page axis. The **sxaxis.sxaxisPage** field of the [SXTH](#sxth) record of the pivot hierarchy MUST be 1. + +**stUnique (variable):** A [XLUnicodeString](#xlunicodestring) structure that specifies the unique name of the [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) that is used for filtering. The length of the string MUST be less than or equal to 255. + +**stDisplay (variable):** A XLUnicodeString structure that specifies the caption of this OLAP member. The length of the string MUST be less than or equal to 255. + +### SXRng + +The **SXRng** record specifies properties for numeric grouping or date grouping of [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in a grouping [cache field](#Section_6497eb794042445780e75959c9f0583c), as specified by [Grouping](#Section_63e07ed20a764cb08cf446aaf25464c2). The values of the **fRangeGroup** and **fCalculatedField** fields of the [SXFDB](#sxfdb) record of this cache field MUST be 1 and 0, respectively. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ABCunused
+ +**A - fAutoStart (1 bit):** A bit that specifies whether the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) is used to set the starting range value. + +| Value | Meaning | +|----|----| +| 0 | The starting range value is not recalculated from the source data on the next refresh. | +| 1 | The starting range value is recalculated from the source data on the next refresh. | + +**B - fAutoEnd (1 bit):** A bit that specifies whether the source data is used to set the ending range value. + +| Value | Meaning | +|----|----| +| 0 | The ending range value is not recalculated from the source data on the next refresh. | +| 1 | The ending range value is recalculated from the source data on the next refresh. | + +**C - iByType (3 bits):** An unsigned integer that specifies the grouping criteria. + +If the value of the **fNumField** field of the SXFDB record of this cache field is 1, **iByType** specifies numeric grouping, as specified by Grouping. In this case, **iByType** MUST be 0 and this record MUST be followed by three [SXNum](#sxnum) records specifying the starting number, the ending number, and the interval size, respectively. Additionally, the ending number MUST be greater than or equal to the starting number. + +If the value of the **fNumField** field of the SXFDB record of this cache field is 0, **iByType** specifies date grouping, as specified by Grouping. In this case, **iByType** MUST be greater than 0. Additionally, this record MUST be followed by two [SXDtr](#sxdtr) records followed by one [SXInt](#sxint) record specifying the starting date/time, the ending date/time, and the interval size, respectively. The ending date/time MUST be greater than or equal to the starting date/time. If this cache field corresponds to source data entities, the collection of sequences of records that conform to the [SRCSXOPER](#pivot-cache-storage-_sx_db_cur) rule in this cache field MUST contain only SXDtr and [SxNil](#sxnil) records. + +**iByType** MUST be a value from the following table: + +| Value | Meaning | Restriction on the value of the catm field of the SXFDB record of this cache field, dictated by the value of iByType. | +|----|----|----| +| 0 | Group by numeric value. | No restriction. | +| 1 | Group by seconds. | MUST be 62. | +| 2 | Group by minutes. | MUST be 62. | +| 3 | Group by hours. | MUST be 26. | +| 4 | Group by days. | MUST be 368. | +| 5 | Group by months. | MUST be 14. | +| 6 | Group by quarters. | MUST be 6. | +| 7 | Group by years. | No restriction. | + +**unused (11 bits):** Undefined and MUST be ignored. + +### SxRule + +The **SxRule** record specifies areas or parts of a one or more [PivotTable views](#Section_09410dfbaac84a719ecf177ffba12c37), as specified in [PivotTable rules](#Section_ce60432dda944422929fcf3f6a0a206f), and that specifies the beginning of a collection of [SxFilt](#sxfilt) records as specified by the [Common Productions](#Section_a1b3d8b4744241fd9c57bbd2a6394082) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). Each SxFilt record specifies an individual area or part of the PivotTable view. + +If this record occurs as part of the specification of a PivotTable view, references (in this record and in the collection) to [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5), the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592), and [pivot items](#Section_58891cc5dd9b4293a97831070779524f) are instances of those entities in the context of the PivotTable view. + +If this record occurs as part of the specification of a [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e), references (in this record and the collection) to PivotTable view, pivot fields, the data field, and pivot items are instances of those entities in the context of all the [associated PivotTable views](#Section_855483943345473bb926de5189fd664d) of the PivotCache. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iDimisxvdABCDsxrTypeEFGHIJKL
reservedcsxFilt
irwFirst (optional)irwLast (optional)icolFirst (optional)icolLast (optional)
+ +**iDim (8 bits):** An unsigned integer that specifies the zero-based position of the pivot field specified by **isxvd** within the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c). MUST be greater than or equal to 0 and less than or equal to 255. + +**isxvd (8 bits):** An unsigned integer that specifies the data field, pivot field, or [cache field](#Section_6497eb794042445780e75959c9f0583c) that this rule refers to. MUST be equal to 0xFF if this record is followed by any SxFilt records. MUST be a value from the following table: + +| Value | Value of fCacheBased | Meaning | +|----|----|----| +| 0 to 0xFD | 0 | Specifies a pivot field index, as specified by pivot fields, to the pivot field that this rule refers to. | +| 0 to 0xFD | 1 | Specifies a cache field index, as specified by cache fields, to the cache field that this rule refers to. | +| 0xFE | MUST be 0 | Specifies that this rule refers to the data field. | +| 0xFF | 0 | Specifies that the rule is followed by zero or more SxFilt records, which specify the pivot fields that this rule refers to. | +| 0xFF | 1 | Specifies that the rule is followed by zero or more SxFilt records, which specify the cache fields that this rule refers to. | + +**A - sxaxisRw (1 bit):** A bit that specifies whether the [row axis](#Section_3f46e7207706400cba9473cb829f869a) is referenced by this record. + +MUST be zero if **sxaxisCol** is 1, **sxaxisPage** is 1, or **sxaxisData** is 1. + +**B - sxaxisCol (1 bit):** A bit that specifies whether the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) is referenced by this record. + +MUST be zero if **sxaxisRw** is 1, **sxaxisPage** is 1, or **sxaxisData** is 1. + +**C - sxaxisPage (1 bit):** A bit that specifies whether the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) is referenced by this record. + +MUST be zero if **sxaxisRw** is 1, **sxaxisCol** is 1, or **sxaxisData** is 1. + +**D - sxaxisData (1 bit):** A bit that specifies whether the [value axis](#Section_4c5c2daa289746e1854b0ce04209f060) is referenced by this record. + +MUST be zero if **sxaxisRw** is 1, **sxaxisCol** is 1, or **sxaxisPage** is 1. + +**sxrType (4 bits):** An unsigned integer that specifies the PivotTable view area that this rule refers to. MUST be a value from the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ValueMeaning
0x0Does not refer to any area.
0x1Refers to one or more pivot fields specified by SxFilt records that follow this record.
0x2Refers to cells displaying values of data items specified by SxFilt records that follow this record.
0x3Refers to the entire PivotTable view.
0x4Refers to the cells at the top-left of the PivotTable view, or at the top-right for a right-to-left sheet. For more information about this area, see Location and Body.
0x5

Refers to a cell displaying a pivot field caption.

+

The pivot field is specified by isxvd.

0x6Refers to the cells at the top-right of the PivotTable view, or at the top-left for a right-to-left sheet. For more information about this area, see Location and Body.
+ +This rule is followed by SxFilt records if and only if that value of **sxrType** is equal to 0x1 or 0x2. + +**E - fPart (1 bit):** A bit that specifies whether only a portion of the PivotTable view area is included in this rule. If the value equals 1, **irwFirst, irwLast, icolFirst,** and **icolLast** hold the relative location in the PivotTable view area included in this rule. + +**F - fDataOnly (1 bit):** A bit that specifies whether only the data cells of the PivotTable view are included in this rule. MUST be 0 if **fLabelOnly** is equal to 1. + +**G - fLabelOnly (1 bit):** A bit that specifies whether only the labels of the PivotTable view are included in this rule. MUST be 1 if **sxrType** is equal to 0x5 or 0x6. MUST be 0 if **fDataOnly** is equal to 1. + +**H - fGrandRw (1 bit):** A bit that specifies whether the grand total row is included in this rule. + +**I - fGrandCol (1 bit):** A bit that specifies whether the grand total column is included in this rule. + +**J - fGrandRwSav (1 bit):** A bit that specifies whether the grand total row was included in this PivotTable rule when the PivotTable rule was created. + +**K - fCacheBased (1 bit):** A bit that specifies whether **isxvd** specifies a cache field in the PivotCache, or a pivot field or the data field in a PivotTable view. + +| Value | Meaning | +|----|----| +| 0 | **isxvd** specifies a pivot field or the data field in a PivotTable view. | +| 1 | **isxvd** specifies a cache field in the PivotCache. | + +**L - fGrandColSav (1 bit):** A bit that specifies whether the grand total column was included in this PivotTable rule when the PivotTable rule was created. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**csxFilt (2 bytes):** An unsigned integer that specifies the number of SxFilt records following this record. MUST be zero if **sxrType** is neither 0x1 nor 0x2. + +**irwFirst (1 byte):** An optional unsigned integer that specifies the offset of the first row, from the first cell in the PivotTable view area to the first cell in the partial area included in this rule. MUST be less than or equal to 255. This field MUST NOT exist if **fPart** is equal to 0. + +**irwLast (1 byte):** An optional unsigned integer that specifies the offset of the last row, from the first cell in the PivotTable view area to the last cell in the partial area included in this rule. MUST be greater than or equal to **irwFirst** and less than or equal to 255. This field MUST NOT exist if **fPart** is equal to 0. + +**icolFirst (1 byte):** An optional unsigned integer that specifies the offset of the first column, from the first cell in the PivotTable view area to the first cell in the partial area included in this rule. MUST be less than or equal to 255. This field MUST NOT exist if **fPart** is equal to 0. + +**icolLast (1 byte):** An optional unsigned integer that specifies the offset of the last column, from the first cell in the PivotTable view area to the last cell in the partial area included in this rule. MUST be greater than or equal to **icolFirst** and less than or equal to 255. This field MUST NOT exist if **fPart** is equal to 0. + +### SxSelect + +The **SxSelect** record specifies information about [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) report for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). The selection is stored in the [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f) following this record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reserved1pnnreserved2
sxaxisActiDimAct
iLiStartiLiAct
iLiMiniLiMax
rwClickcolClick
rwClickPrevcolClickPrev
cClickABCDEunused
+ +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +**pnn (1 byte):** A [**PaneType**](#panetype) structure that specifies the [**active pane**](#gt_33f49274-001d-40a3-bcca-f54a93906c29). + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +**sxaxisAct (2 bytes):** An [SXAxis](#sxaxis) structure that specifies the [PivotTable Axis](#Section_89db73685e8e4324b592af85e4559e6c) of the PivotTable [**selection**](#gt_8a241461-3c59-45fb-9094-b6692a0c27fe). + +The value of the **sxaxisData** field of SXAxis MUST be zero. + +**iDimAct (2 bytes):** An unsigned integer that specifies the zero-based field position of the field that is selected within the PivotTable Axis. + +**iLiStart (2 bytes):** An unsigned integer that specifies the zero-based position of the [PivotTable line](#Section_76610990666f492791b6d2280f607464) where the selection operation started. MUST be greater than or equal to the **iLiMin** field and less than or equal to the **iLiMax** field. + +**iLiAct (2 bytes):** An unsigned integer that specifies the zero-based position of the PivotTable line that was most recently included in the selection. MUST be greater than or equal to zero and less than or equal to the **iLiMax** field. + +**iLiMin (2 bytes):** An unsigned integer that specifies the zero-based position of the minimum PivotTable line that could be included in the selection. MUST be greater than or equal to zero and less than or equal to the **iLiMax** field. + +**iLiMax (2 bytes):** An unsigned integer that specifies the zero-based position of the maximum PivotTable line that could be included in the selection. MUST be greater than or equal to zero. MUST be greater than or equal to the **iLiMin** field. + +**rwClick (2 bytes):** An [RwU](#rwu) structure that specifies the row of the cell where the user last clicked for the PivotTable selection. + +**colClick (2 bytes):** A [ColU](#colu) structure that specifies the column of the cell where the user last clicked for the PivotTable selection. + +**rwClickPrev (2 bytes):** An RwU structure that specifies the row of the cell previously clicked by the user on the PivotTable selection. + +**colClickPrev (2 bytes):** A ColU structure that specifies the column of the cell previously clicked on the PivotTable selection. + +**cClick (5 bits):** An unsigned integer that specifies the number of clicks made by the user to refine the current PivotTable selection. + +**A - fLabelOnly (1 bit):** A bit that specifies that only cells in the [row area](#Section_5594c95e6819461e80706f4b4fdfa091), [column area](#Section_03aced8c25864e83982a1e3551a563d6), or [page area](#Section_f10ef7d86c044d35a5830d6f2ce92063) are selected. + +**B - fDataOnly (1 bit):** A bit that specifies that only cells in the [data area](#Section_237a24905c614931923f7ee856f23c72) are selected. + +**C - fToggleDataHeader (1 bit):** A bit that specifies whether the PivotTable selection toggle is enabled. The selection toggle enables a method for the user to select values, labels, or both values and labels. + +**D - fSelectionClick (1 bit):** A bit that specifies whether any selections on the PivotTable were refined by the user. + +**E - fExtendable (1 bit):** A bit that specifies whether an additional PivotTable line can be added to the current selection. + +**unused (6 bits):** Undefined and MUST be ignored. + +### SXStreamID + +The **SXStreamID** record specifies a stream in the [PivotCache storage](#Section_c5fb3f663ef64308ae3de59244159687). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
idStm
+ +**idStm (2 bytes):** An unsigned integer that specifies a stream in the PivotCache storage. The stream specified is the one that has its name equal to the hexadecimal representation of this field. The four-digit hexadecimal string representation of this field, where each hexadecimal letter digit is a capital letter, MUST be equal to the name of a stream in the PivotCache storage. + +### SXString + +The **SXString** record specifies a segment of a string that contains information about a [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) or an [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9). When this record occurs in a sequence of records that conforms to the [SRCSXOPER](#pivot-cache-storage-_sx_db_cur) rule or the GRPSXOPER rule, then it specifies a [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) with a string value. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cchsegment (variable)
...
+ +**cch (2 bytes):** An unsigned integer that specifies the length, in characters, of the [XLUnicodeStringNoCch](#xlunicodestringnocch) structure in the **segment** field. If **cch** is 0xFFFF, **segment** MUST NOT exist. + +**segment (variable):** An XLUnicodeStringNoCch structure that specifies a segment of the string. This exists only if the value of the **cch** field is different than 0xFFFF. + +### SXTbl + +The **SXTbl** record stores information about [multiple consolidation ranges](#Section_2535c296b76b4728b52c72fbabaf3047). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cdrefcsxtbpg
cPagesA
+ +**cdref (2 bytes):** An unsigned integer that specifies the number of multiple consolidation ranges used as [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) for the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). MUST be equal to the number of [DConRef](#dconref), [DConBin](#dconbin), or [DConName](#dconname) records that follow this record. + +**csxtbpg (2 bytes):** An unsigned integer that specifies the number of [SxTbpg](#sxtbpg) records that follow this record. MUST be equal to **cdref**. + +**cPages (15 bits):** An unsigned integer that specifies the number of optional [cache fields](#Section_6497eb794042445780e75959c9f0583c) in the PivotCache, as specified by Multiple Consolidation Ranges. MUST be less than or equal to 0x0004. + +**A - fAutoPage (1 bit):** A bit that specifies whether there is one automatically created cache field with [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) qualifying each source data [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of the multiple consolidation ranges PivotCache. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The cache fields that qualify the source data ranges are not automatically created. | +| 1 | There is one automatically created cache field with cache items qualifying each source data range of the multiple consolidation ranges PivotCache. Each cache item qualifies one source data range. | + +### SxTbpg + +The **SxTbpg** record specifies properties of [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) for a [multiple consolidation ranges](#Section_2535c296b76b4728b52c72fbabaf3047) [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). There MUST be one SxTbpg record for each source data range. The order of the SxTbpg records corresponds to the order of the [DREF](#globals-substream) records that precede this record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgiitem (variable)
...
+ +**rgiitem (variable):** An array of signed 2-byte integers that associates [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) with the range associated with this record. Each element in this array is associated with a [cache field](#Section_6497eb794042445780e75959c9f0583c), as specified in the multiple consolidation ranges overview. + +The number of elements in this array MUST be equal to the value of the **cPages** field of the preceding [SXTbl](#sxtbl) record and MUST be equal to the number of [SXTBRGIITM](#sxtbrgiitm) records that follow this record. The *nth* element in this array is associated with the *nth* SXTBRGIITM record that follows this record. + +Each element in this array MUST be less than the value of the **cItems** field of the associated SXTBRGIITM. Each element in this array MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | Specifies that a blank cache item is used. | +| Greater than or equal to zero | Specifies the zero-based index of an [SXString](#sxstring) record in the collection of SXString records directly following the associated SXTBRGIITM record. | + +### SXTBRGIITM + +The **SXTBRGIITM** record specifies the beginning of a collection of [SXString](#sxstring) records as specified by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of SXString records specifies the values corresponding to the [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) for an optional [cache field](#Section_6497eb794042445780e75959c9f0583c) in a [multiple consolidation ranges](#Section_2535c296b76b4728b52c72fbabaf3047) [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
cItems
+ +**cItems (2 bytes):** An unsigned integer that specifies the number of SXString records that follow this record. MUST be less than or equal to 65534. + +### SXTH + +The **SXTH** record specifies properties of a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
ABCDEFGHIJKLMunused3
sxaxisreserved
isxvd
csxvdXl
NOPQRunused4stUnique (variable)
...
stDisplay (variable)
...
stDefault (variable)
...
stAll (variable)
...
stDimension (variable)
...
cisxvd
rgisxvd (variable)
...
cHiddenMemberSets
rgHiddenMemberSets (variable)
...
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x080D. + +**A - fMeasure (1 bit):** A bit that specifies whether this pivot hierarchy is an [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118), which means it can be placed only on the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**B - unused1 (1 bit):** Undefined and MUST be ignored. + +**C - fOutlineMode (1 bit):** A bit that specifies whether the [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5) representing the levels of this pivot hierarchy have the **fOutline** field of the [SXVDEx](#sxvdex) record set to 1 when the pivot fields are first created. See [Subtotalling](#Section_427438d9b8e34a5c8b678f158fbf680f) for more information. + +**D - fEnableMultiplePageItems (1 bit):** A bit that specifies whether multiple [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) can be selected when the pivot hierarchy is on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +**E - fSubtotalAtTop (1 bit):** A bit that specifies whether the pivot fields representing the levels of this pivot hierarchy have the **fSubtotalAtTop** field of the SXVDEx record set to 1 when the pivot fields are first created. See Subtotalling for more information. + +**F - fSet (1 bit):** A bit that specifies whether this pivot hierarchy is an [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28). MUST be 0 if **fMeasure** is 1. + +**G - fDontShowFList (1 bit):** A bit that specifies whether this pivot hierarchy is hidden in the list of pivot fields that can be added to or removed from the PivotTable view. + +**H - fAttributeHierarchy (1 bit):** A bit that specifies whether this pivot hierarchy is an [**attribute hierarchy**](#gt_8f75d668-e8c6-4f42-ba44-d90604d3b9dc). + +**I - fTimeHierarchy (1 bit):** A bit that specifies whether this pivot hierarchy is a [**time hierarchy**](#gt_1c5d8e4b-5628-41ec-aa9f-95f243e2bed5). + +**J - fFilterInclusive (1 bit):** A bit that specifies whether [manual filters](#Section_b0b282651e334c86ad030f5693c1d1e4) applied to this pivot hierarchy are inclusive or exclusive. MUST be a value from the following table: + +| **Value** | **Meaning** | +|----|----| +| 0 | OLAP members specified in the manual filter are excluded from the PivotTable view along with their descendants. | +| 1 | OLAP members specified in the manual filter are included from the PivotTable view along with their ascendants and descendants. | + +For more information, see [OLAP Manual Filters](#Section_bd4665ebb56a44e690b9ceaf7ec55389). + +**K - unused2 (1 bit):** Undefined and MUST be ignored. + +**L - fKeyAttributeHierarchy (1 bit):** A bit that specifies whether this pivot hierarchy is the key attribute hierarchy in the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**dimension (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c). + +**M - fKPI (1 bit):** A bit that specifies whether this pivot hierarchy is a [**key performance indicator (KPI)**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) [**hierarchy**](#gt_a07fc05d-cdb0-442c-984a-dd3589b9f682). + +**unused3 (19 bits):** Undefined and MUST be ignored. + +**sxaxis (2 bytes):** An [SXAxis](#sxaxis) structure that specifies the axis or axes this pivot hierarchy is present on. For more information, see [PivotTable Axes](#Section_89db73685e8e4324b592af85e4559e6c). + +- If **sxaxis.sxaxisData** is 1, then **sxaxis.sxaxisRw**, **sxaxis.sxaxisCol**, and **sxaxis.sxaxisPage** MUST be zero. + +- If **sxaxis.sxaxisRw** is 1, then **sxaxis.sxaxisCol** and **sxaxis.sxaxisPage** MUST be zero. + +- If **sxaxis.sxaxisCol** is 1, **sxaxis.sxaxisPage** MUST be zero. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**isxvd (4 bytes):** A signed integer that specifies a pivot field index as specified by Pivot Fields. The pivot field index specifies the associated pivot field for this pivot hierarchy. + +If the value of **sxaxis.sxaxisPage** is 1 or the value of **sxaxis.sxaxisData** is 1, then the value of this field MUST be greater than or equal to 0 and MUST be less than the value of the **cDim** field of the [SxView](#sxview) record of the PivotTable view, and the value of **cisxvd** MUST be 0. Also, the **sxaxis** field of the [Sxvd](#sxvd) record of the referenced pivot field MUST be equal to the **sxaxis** field of this record. + +If both **sxaxis.sxaxisPage** and **sxaxis.sxaxisData** are equal to 0, the value of this field MUST be ignored. + +**csxvdXl (4 bytes):** A signed integer that specifies the number of pivot fields in the PivotTable view on PivotTable axes for this pivot hierarchy. MUST be greater than or equal to 0. + +If **sxaxis.sxaxisPage** is 1 or **sxaxis.sxaxisData** is 1, then the value of this field MUST be 1. + +If **sxaxis.sxaxisPage** is 0, **sxaxis.sxaxisData** is 0, **sxaxis.sxaxisRw** is 0 and **sxaxis.sxaxisCol** is 0, the value of this field MUST be 0. + +If **sxaxis.sxaxisRw** is 1 or **sxaxis.sxaxisCol** is 1, the restrictions on the value of this field vary depending on the value of the **stAll** string, as specified in the following table: + +| stAll | Value of csxvdXl | +|-----------|------------------------------------------| +| Empty | MUST be equal to the value of **cisxvd** | +| Not empty | MUST be equal to **cisxvd** – 1 | + +**N - fDragToRow (1 bit):** A bit that specifies whether this pivot hierarchy can be placed on the [row axis](#Section_3f46e7207706400cba9473cb829f869a) of the PivotTable view. MUST be 0 if **fMeasure** is 1. + +**O - fDragToColumn (1 bit):** A bit that specifies whether this pivot hierarchy can be placed on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) of the PivotTable view. MUST be 0 if **fMeasure** is 1. + +**P - fDragToPage (1 bit):** A bit that specifies whether this pivot hierarchy can be placed on the page axis of the PivotTable view. MUST be 0 if **fMeasure** is 1. + +**Q - fDragToData (1 bit):** A bit that specifies whether this pivot hierarchy can be placed on the data axis of the PivotTable view. + +**R - fDragToHide (1 bit):** A bit that specifies whether this pivot hierarchy can be removed from the PivotTable view. + +**unused4 (11 bits):** Undefined and MUST be ignored. + +**stUnique (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of this pivot hierarchy. The length of the string MUST be greater than zero and less than or equal to 255. + +**stDisplay (variable):** An XLUnicodeString structure that specifies the display name of this pivot hierarchy. The length of the string MUST be greater than zero and less than or equal to 255. + +**stDefault (variable):** An XLUnicodeString structure that specifies the MDX unique name of the default [**member (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) of this pivot hierarchy. The length of the string MUST be less than or equal to 255. + +**stAll (variable):** An XLUnicodeString structure that specifies the unique name of the [**ALL**](#gt_cffb889a-4468-44be-9817-24bbac1adfe3) member (2) of this pivot hierarchy. The length of the string MUST be less than or equal to 255. A length of zero specifies that there is no ALL member (2) of this pivot hierarchy. + +**stDimension (variable):** An XLUnicodeString structure that specifies the unique name of the OLAP dimension (1) to which this pivot hierarchy belongs, unless the length of the string is zero. The length of the string MUST be less than or equal to 255. If **fMeasure** is 1, the length of the string MUST be zero. + +**cisxvd (4 bytes):** An unsigned integer that specifies the number of elements in **rgisxvd**. MUST be zero If **sxaxis.sxaxisRw** is 0 and **sxaxis.sxaxisCol** is 0. + +**rgisxvd (variable):** An array of 4-byte signed integers that specify the pivot fields associated with this pivot hierarchy. Each array element MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | No pivot field is referenced. | +| Greater than or equal to zero | A pivot field index, as specified by pivot fields, that specifies a pivot field that is associated with this pivot hierarchy. The referenced pivot field MUST have an **sxaxis** field equal to the value of the **sxaxis** field of this record. | + +This field is arranged such that the *n*th element in the array is a reference to the Sxvd record that has a related [SXVDTEx](#sxvdtex) record that has a value of *n* for its **isxtl** field. If there is no such SXVDTEx for the *n*th element, the value of the *n*th element MUST be equal to -1. + +**cHiddenMemberSets (4 bytes):** An unsigned integer that specifies the deepest one-based level in the pivot hierarchy that has OLAP members [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) from the PivotTable view. If the value of **cisxvd** is greater than 0, then the value of this field also specifies the number of elements in **rgHiddenMemberSets**. If the value of **fFilterInclusive** is 1, then the value of this field MUST be 0. + +**rgHiddenMemberSets (variable):** An array of [HiddenMemberSet](#hiddenmemberset) structures that specifies which of the OLAP members in the pivot hierarchy are hidden from the PivotTable view through manual filtering at each level of the pivot hierarchy. The index of each member (2) in the array corresponds to a level in the pivot hierarchy, beginning with index 0. MUST exist if and only if **cHiddenMemberSets** is greater than 0 and **cisxvd** is greater than 0. + +### Sxvd + +The **Sxvd** record specifies [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) properties and that specifies the beginning of a collection of records as defined in the [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). This collection of records specifies details for a pivot field. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
sxaxiscSub
ABCDEFGHIJKLMcItm
cchNamestName (variable)
...
+ +**sxaxis (2 bytes):** An [SXAxis](#sxaxis) structure that specifies the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) that this pivot field is on. If the **sxaxis.sxaxisData** field equals 1, there MUST be a corresponding [SXDI](#sxdi) record with an **isxvd** field that specifies this Sxvd record. + +**cSub (2 bytes):** An unsigned integer that specifies the number of subtotal functions used for this pivot field. MUST equal the count of subtotal fields of this record whose value is 1. The subtotal fields of this record are **fDefault**, **fSum**, **fCounta**, **fAverage**, **fMax**, **fMin**, **fProduct**, **fCount**, **fStdev**, **fStdevp**, **fVariance**, and **fVariancep**. For more information, see [Subtotalling](#Section_427438d9b8e34a5c8b678f158fbf680f). + +**A - fDefault (1 bit):** A bit that specifies whether the default subtotal [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) is applied. The default subtotal is separately determined for each [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679). If the **fDefault** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one [SXVI](#sxvi) record with the **itmType** field of the SXVI record equal to 1. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------------| +| 0 | The default subtotal function is not applied. | +| 1 | The default subtotal function is applied. | + +**B - fSum (1 bit):** A bit that specifies whether the sum subtotal function is displayed. If the **fDefault** field equals 1, this value MUST be 0. If the **fSum** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 2. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------| +| 0 | The sum subtotal function is not displayed. | +| 1 | The sum subtotal function is displayed. | + +**C - fCounta (1 bit):** A bit that specifies whether the count subtotal function is displayed. If the **fDefault** field equals 1, this value MUST be 0. If the **fCounta** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 3. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------------| +| 0 | The count subtotal function is not displayed. | +| 1 | The count subtotal function is displayed. | + +**D - fAverage (1 bit):** A bit that specifies whether the average subtotal function is displayed. If the **fDefault** field equals 1, this value MUST be 0. If the **fAverage** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 4. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------| +| 0 | The average subtotal function is not displayed. | +| 1 | The average subtotal function is displayed. | + +**E - fMax (1 bit):** A bit that specifies whether the max subtotal function is displayed. If the **fDefault** field equals 1, this value MUST be 0. If the **fMax** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 5. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------| +| 0 | The max subtotal function is not displayed. | +| 1 | The max subtotal function is displayed. | + +**F - fMin (1 bit):** A bit that specifies whether the min subtotal function is displayed. If the **fDefault** field equals 1, this value MUST be 0. If the **fMin** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 6. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------| +| 0 | The min subtotal function is not displayed. | +| 1 | The min subtotal function is displayed. | + +**G - fProduct (1 bit):** A bit that specifies whether the product subtotal function is displayed. If the **fDefault** field is 1, this value MUST be 0. If the **fProduct** field is 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 7. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------| +| 0 | The product subtotal function is not displayed. | +| 1 | The product subtotal function is displayed. | + +**H - fCount (1 bit):** A bit that specifies whether the count numbers subtotal function is displayed. If the **fDefault** field is 1, this value MUST be 0. If the **fCount** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 8. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------------| +| 0 | The count numbers subtotal function is not displayed. | +| 1 | The count numbers subtotal function is displayed. | + +**I - fStdev (1 bit):** A bit that specifies whether the standard deviation subtotal function is displayed. If the **fDefault** field is 1, this value MUST be 0. If the **fStdev** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 9. MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------------------------------| +| 0 | The standard deviation subtotal function is not displayed. | +| 1 | The standard deviation subtotal function is displayed. | + +**J - fStdevp (1 bit):** A bit that specifies whether the standard deviation population subtotal function is displayed. If the **fDefault** field equals 1, this value MUST be 0. If the **fStdevp** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 10. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The standard deviation population subtotal function is not displayed. | +| 1 | The standard deviation population subtotal function is displayed. | + +**K - fVariance (1 bit):** A bit that specifies whether the variance subtotal function is displayed. If the **fDefault** field is 1, this value MUST be 0. If the **fVariance** field is 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 11. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------| +| 0 | The variance subtotal function is not displayed. | +| 1 | The variance subtotal function is displayed. | + +**L - fVariancep (1 bit):** A bit that specifies whether the variance population subtotal function is displayed. If the **fDefault** field is 1, the value MUST be 0. If the **fVariancep** field equals 1 and **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 12. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------------------| +| 0 | The variance population subtotal function is not displayed. | +| 1 | The variance population subtotal function is displayed. | + +**M - reserved (4 bits):** MUST be zero, and MUST be ignored. + +**cItm (2 bytes):** A signed integer that specifies the number of [pivot items](#Section_58891cc5dd9b4293a97831070779524f) for this pivot field. This value MUST match the number of SXVI records following this record and MUST be less than or equal to the following formula: + +32500 + the **cSub** field + +**cchName (2 bytes):** An unsigned integer that specifies the length, in characters, of the **stName** field. If the value is 0xFFFF then **stName** is NULL. The value MUST be 0xFFFF or greater than zero and less than or equal to 255. + +**stName (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the caption of this pivot field. A non-NULL value specifies that this string is used to override the **stFieldName** field in [SXFDB](#sxfdb) record from the associated [cache field](#Section_6497eb794042445780e75959c9f0583c), as specified in pivot fields. The length is specified in **cchName**. This field exists only if the value of **cchName** is not 0xFFFF. If this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) is not an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) and this string is non-NULL, then **stName** MUST be unique within all Sxvd records in this PivotTable view. + +### SXVDEx + +The **SXVDEx** record specifies extended [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) properties. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEFGHIJKLMNOPreserved3QRScitmAutoShow
isxdiAutoSortisxdiAutoShow
ifmtsubName (variable)
...
+ +**A - fShowAllItems (1 bit):** A bit that specifies whether to show all [pivot items](#Section_58891cc5dd9b4293a97831070779524f) for this pivot field, including pivot items that do not currently exist in the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4). The value MUST be 0 for an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f). MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------| +| 0x0 | Specifies that all pivot items are not displayed. | +| 0x1 | Specifies that all pivot items are displayed. | + +**B - fDragToRow (1 bit):** A bit that specifies whether this pivot field can be placed on the [row axis](#Section_3f46e7207706400cba9473cb829f869a). This value MUST be ignored for an OLAP PivotTable view. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that the user is prevented from placing this pivot field on the row axis. | +| 0x1 | Specifies that the user is not prevented from placing this pivot field on the row axis. | + +**C - fDragToColumn (1 bit):** A bit that specifies whether this pivot field can be placed on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). This value MUST be ignored for an OLAP PivotTable view. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that the user is prevented from placing this pivot field on the column axis. | +| 0x1 | Specifies that the user is not prevented from placing this pivot field on the column axis. | + +**D - fDragToPage (1 bit):** A bit that specifies whether this pivot field can be placed on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). This value MUST be ignored for an OLAP PivotTable view. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that the user is prevented from placing this pivot field on the page axis. | +| 0x1 | Specifies that the user is not prevented from placing this pivot field on the page axis. | + +**E - fDragToHide (1 bit):** A bit that specifies whether this pivot field can be removed from the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). This value MUST be ignored for an OLAP PivotTable view. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that the user is prevented from removing this pivot field from the PivotTable view. | +| 0x1 | Specifies that the user is not prevented from removing this pivot field from the PivotTable view. | + +**F - fNotDragToData (1 bit):** A bit that specifies whether this pivot field can be placed on the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). This value MUST be ignored for an OLAP PivotTable view. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that the user is not prevented from placing this pivot field on the data axis. | +| 0x1 | Specifies that the user is prevented from placing this pivot field on the data axis. | + +**G - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**H - fServerBased (1 bit):** A bit that specifies whether this pivot field is server-based when on the page axis. For more information, see Source Data. A value of 1 specifies that this pivot field is a server-based pivot field. + +MUST be 1 if and only if the value of the **fServerBased** field of the [SXFDB](#sxfdb) record of the associated [cache field](#Section_6497eb794042445780e75959c9f0583c) of this pivot field is 1. + +**I - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**J - fAutoSort (1 bit):** A bit that specifies whether AutoSort will be applied to this pivot field. For more information, see [Pivot Field Sorting](#Section_6a008d4253834e13a1d06d8ee5d93b76). + +**K - fAscendSort (1 bit):** A bit that specifies whether any AutoSort applied to this pivot field will [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880) in ascending order. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------| +| 0x0 | Sort in descending order. | +| 0x1 | Sort in ascending order. | + +**L - fAutoShow (1 bit):** A bit that specifies whether an [**AutoShow**](#gt_42126923-0aed-4547-8761-95a0ce2badde) [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) is applied to this pivot field. For more information, see [Simple Filters](#Section_d662b8d1d1234fc5bac05fd76cdf0ff0). + +**M - fTopAutoShow (1 bit):** A bit that specifies whether any AutoShow filter applied to this pivot field shows the top-ranked or bottom-ranked values. For more information, see Simple Filters. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Any AutoShow filter applied to this pivot field shows the bottom-ranked values. | +| 0x1 | Any AutoShow filter applied to this pivot field shows the top-ranked values. | + +**N - fCalculatedField (1 bit):** A bit that specifies whether this pivot field is a [calculated field](#Section_4594f2ac815740b381142e77ba8efb7d). A value of 1 specifies that this pivot field is a calculated field. + +MUST be 1 if and only if the value of the **fCalculatedField** field of the SXFDB record of the cache field associated with this pivot field is 1. + +**O - fPageBreaksBetweenItems (1 bit):** A bit that specifies whether a [**page break**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871) is inserted after each pivot item when the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) is printed. + +**P - fHideNewItems (1 bit):** A bit that specifies whether new pivot items that appear after a [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) are [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) by default. This value MUST be equal to 0 for a non-OLAP PivotTable view. + +| Value | Meaning | +|-------|----------------------------------------| +| 0x0 | New pivot items are shown by default. | +| 0x1 | New pivot items are hidden by default. | + +**reserved3 (5 bits):** MUST be zero, and MUST be ignored. + +**Q - fOutline (1 bit):** A bit that specifies whether this pivot field is in [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) form. For more information, see [PivotTable layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4). + +**R - fInsertBlankRow (1 bit):** A bit that specifies whether to insert a blank row after each pivot item. + +**S - fSubtotalAtTop (1 bit):** A bit that specifies whether subtotals are displayed at the top of the group when the **fOutline** field is equal to 1. For more information, see PivotTable layout. + +**citmAutoShow (8 bits):** An unsigned integer that specifies the number of pivot items to show when the **fAutoShow** field is equal to 1. The value MUST be greater than or equal to 1 and less than or equal to 255. + +**isxdiAutoSort (2 bytes):** A signed integer that specifies the [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679) that AutoSort uses when the **fAutoSort** field is equal to 1. If the value of the **fAutoSort** field is one, the value MUST be greater than or equal to zero and less than the count of [SXDI](#sxdi) records. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | Specifies that the values of the pivot items themselves are used. | +| Greater than or equal to zero | Specifies a data item index, as specified in Data Items, of the data item that is used. | + +**isxdiAutoShow (2 bytes):** A signed integer that specifies the data item that AutoShow ranks by when the **fAutoShow** field is equal to 1. For more information, see Simple Filters. If the value of the **fAutoShow** field is 1, this value MUST be greater than or equal to zero and less than the count of SXDI records. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | AutoShow is not enabled for this pivot field. | +| Greater than or equal to zero | Specifies a data item index, as specified in Data Items, of the data item that is used. | + +**ifmt (2 bytes):** An [IFmt](#ifmt) structure that specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) of this pivot field. + +**subName (variable):** An optional [SXVDEx_Opt](#sxvdex_opt) structure that specifies the name of the aggregate [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) used to calculate this pivot field's subtotals. SHOULD[\<131\>](#Appendix_A_131) be present. + +### SXVDTEx + +The **SXVDTEx** record specifies [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) extensions to a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5). This record MUST NOT exist if this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) is a non-[OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f). + +The pivot field associated with this record is the pivot field with an index that equals the index of this SXVDTEx record in the collection of SXVDTEx records of this PivotTable view. + +The count of SXVDTEx records MUST equal the count of pivot fields in the OLAP PivotTable view. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
ABCDEFreservedisxth
isxtl
csxvi
rgsxvi (variable)
...
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x080F. + +**A - fTensorSort (1 bit):** A bit that specifies whether the [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7) is determined by the OLAP [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0). See [Pivot Field Sorting](#Section_6a008d4253834e13a1d06d8ee5d93b76) for more information. + +**B - fDrilledLevel (1 bit):** A bit that specifies whether all [pivot items](#Section_58891cc5dd9b4293a97831070779524f) in this pivot field are expanded. See [Collapsing](#Section_1c9375b4cc664783821f6b2b49bac169) for more information. + +**C - fItemsDrilledByDefault (1 bit):** A bit that specifies whether this [**attribute hierarchy**](#gt_8f75d668-e8c6-4f42-ba44-d90604d3b9dc) is expanded by default. See Collapsing for more information. + +**D - fMemPropDisplayInReport (1 bit):** A bit that specifies whether this [member property](#Section_e5db3a66677f43db8fb038584797c95f) pivot field is displayed in the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) report. See [row axis](#Section_3f46e7207706400cba9473cb829f869a) or [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) for more information. MUST be 0 if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4) is less than 3. MUST be ignored if this pivot field is not a member property pivot field. + +**E - fMemPropDisplayInTip (1 bit):** A bit that specifies whether this member property pivot field is displayed in a [**ToolTip**](#gt_84d44447-feaf-41a4-bf12-004c0f080fc2). MUST be 0 if the PivotCache functionality level of the associated PivotCache is less than 3. MUST be ignored if this pivot field is not a member property pivot field. + +**F - fMemPropDisplayInCaption (1 bit):** A bit that specifies whether to display member property captions from this pivot field, for a pivot field of the associated OLAP levels and associated [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) as this pivot field, instead of the pivot item captions. The pivot field for which to display captions has an [SXAddl_SXCField12_SXDMemberCaption](#sxaddl_sxcfield12_sxdmembercaption) record. MUST be 0 if the PivotCache functionality level of the associated PivotCache is less than 3. MUST be ignored if this pivot field is not a member property pivot field. + +**reserved (10 bits):** MUST be zero, and MUST be ignored. + +**isxth (2 bytes):** A signed integer that specifies the pivot hierarchy that this pivot field is associated with. See [Association of Pivot Hierarchies and Pivot Fields and Cache Fields](#Section_01a66b9be4a24396b55c28d6207fd28f) for more information. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | This pivot field is not part of a pivot hierarchy. | +| Greater than or equal to zero | This specifies a pivot hierarchy index, as specified in Pivot Hierarchies, that specifies a pivot hierarchy. | + +MUST be greater than or equal to -1 and less than the **csxth** field of the [SXViewEx](#sxviewex) record of the PivotTable view. + +**isxtl (4 bytes):** A signed integer that specifies the zero-based index of the OLAP level associated with the pivot hierarchy. If **isxth** specifies a pivot hierarchy that is not an OLAP [**Hierarchy**](#gt_a07fc05d-cdb0-442c-984a-dd3589b9f682), this value MUST be ignored. + +**csxvi (4 bytes):** A signed integer that specifies the number of items in the array specified by **rgsxvi**. MUST equal the count of pivot items in this pivot field. + +**rgsxvi (variable):** An array of [SXVIFlags](#sxviflags) that specifies additional properties for the pivot items in this pivot field. Each SXVIFlags in the **rgsxvi** array specifies additional properties of the pivot item with a pivot item index equal to the index of the SXVIFlags element in the **rgsxvi** array. + +The number of elements in this array MUST equal **csxvi**. + +### SXVI + +The **SXVI** record specifies information about a [pivot item](#Section_58891cc5dd9b4293a97831070779524f). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
itmTypeABCDEreserved2
iCachecchName
stName (variable)
...
+ +**itmType (2 bytes):** A signed integer that specifies the pivot item type. The value MUST be one of the following values: + +| Value | Name | Meaning | +|----|----|----| +| 0x0000 | itmtypeData | A data value | +| 0x0001 | itmtypeDEFAULT | Default subtotal for the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) | +| 0x0002 | itmtypeSUM | Sum of values in the pivot field | +| 0x0003 | itmtypeCOUNTA | Count of values in the pivot field | +| 0x0004 | itmtypeAVERAGE | Average of values in the pivot field | +| 0x0005 | itmtypeMAX | Max of values in the pivot field | +| 0x0006 | itmtypeMIN | Min of values in the pivot field | +| 0x0007 | itmtypePRODUCT | Product of values in the pivot field | +| 0x0008 | itmtypeCOUNT | Count of numbers in the pivot field | +| 0x0009 | itmtypeSTDEV | Statistical standard deviation (estimate) of the pivot field | +| 0x000A | itmtypeSTDEVP | Statistical standard deviation (entire population) of the pivot field | +| 0x000B | itmtypeVAR | Statistical variance (estimate) of the pivot field | +| 0x000C | itmtypeVARP | Statistical variance (entire population) of the pivot field | + +**A - fHidden (1 bit):** A bit that specifies whether this pivot item is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). For more information, see [Manual Filtering](#Section_b0b282651e334c86ad030f5693c1d1e4). + +MUST be zero if **itmType** is not itmtypeData. MUST be zero for [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f). + +**B - fHideDetail (1 bit):** A bit that specifies whether the pivot item detail is collapsed. + +MUST be zero for OLAP PivotTable view. + +**C - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**D - fFormula (1 bit):** A bit that specifies whether this pivot item is a [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b). + +This field MUST be zero if any of the following apply: + +- **itmType** is not zero. + +- This item is in an OLAP PivotTable view. + +- The **sxaxisPage** field of **sxaxis** in the [Sxvd](#sxvd) record of the pivot field equals 1 (the associated Sxvd is the last Sxvd record before this record in the stream). + +- The **fCalculatedField** field in the [SXVDEx](#sxvdex) record of the pivot field equals 1. + +- There is not an associated [SXFDB](#sxfdb) record in the [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4). + +- The **fRangeGroup** field of the SXFDB record, of the associated [cache field](#Section_6497eb794042445780e75959c9f0583c) of the pivot field, equals 1. + +- The **fCalculatedField** field of the SXFDB record, of the associated cache field of the pivot field, equals 1. + +**E - fMissing (1 bit):** A bit that specifies if this pivot item does not exist in the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + +MUST be zero if **itmType** is not zero. MUST be zero for OLAP PivotTable view. + +**reserved2 (11 bits):** MUST be zero, and MUST be ignored. + +**iCache (2 bytes):** A signed integer that specifies a reference to a [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | No cache item is referenced. | +| 0+ | A cache item index in the cache field associated with the pivot field, as specified by Cache Items. | + +If **itmType** is not zero, a reference to a cache item is not specified and this value MUST be -1. Otherwise, this value MUST be greater than or equal to 0. + +**cchName (2 bytes):** An unsigned integer that specifies the length of the **stName** string. If the value is 0xFFFF then **stName** is NULL. Otherwise, the value MUST be less than or equal to 254. + +**stName (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of this pivot item. If not NULL, this is used as the caption of the pivot item instead of the value in the cache item specified by **iCache**. The length of this field is specified in **cchName**. This field exists only if **cchName** is not 0xFFFF. If this is in a non-OLAP PivotTable view and this string is not NULL, it MUST be unique within all SXVI records in associated with the pivot field. + +### SxView + +The **SxView** record specifies [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) information and that specifies the beginning of a collection of records as defined by the [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection specifies the remainder of the PivotTable view. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ref
...
rwFirstHeadrwFirstData
colFirstDataiCache
reservedsxaxis4Data
ipos4DatacDim
cDimRwcDimCol
cDimPgcDimData
cRwcCol
ABCDEFGHIJunused2itblAutoFmt
cchTableNamecchDataName
stTable (variable)
...
stData (variable)
...
+ +**ref (8 bytes):** A [Ref8U](#ref8u) structure that specifies the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) report body. For more information, see [Location and Body](#Section_7f7d9d76a55041d9ae9f0d8539cc09f8). + +**rwFirstHead (2 bytes):** An [RwU](#rwu) structure that specifies the first row of the [row area](#Section_5594c95e6819461e80706f4b4fdfa091). MUST be 1 if none of the axes are assigned in this PivotTable view. Otherwise, the value MUST be greater than or equal to **ref.rwFirst**. + +**rwFirstData (2 bytes):** An RwU structure that specifies the first row of the [data area](#Section_237a24905c614931923f7ee856f23c72). MUST be 1 if none of the axes are assigned in this PivotTable view. Otherwise, it MUST be equal to the value as specified by the following formula: + +**rwFirstData** = **rwFirstHead** + **cDimCol** + +**colFirstData (2 bytes):** A [ColU](#colu) structure that specifies the first column of the data area. It MUST be 1 if none of the axes are assigned in this PivotTable view. Otherwise, the value MUST be greater than or equal to **ref.colFirst,** and if the value of **cDimCol** or **cDimData** is not zero, it MUST be less than or equal to **ref.colLast**. + +**iCache (2 bytes):** A signed integer that specifies the zero-based index of an [SXStreamID](#sxstreamid) record in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). See [Associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4) for more information. MUST be greater than or equal to zero and less than the number of SXStreamID records in the Globals Substream. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**sxaxis4Data (2 bytes):** An [SXAxis](#sxaxis) structure that specifies the default axis for the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592). Either the **sxaxis4Data.sxaxisRw** field MUST be 1 or the **sxaxis4Data.sxaxisCol** field MUST be 1. The **sxaxis4Data.sxaxisPage** field MUST be 0 and the **sxaxis4Data.sxaxisData** field MUST be 0. + +**ipos4Data (2 bytes):** A signed integer that specifies the row or column position for the data field in the PivotTable view. The **sxaxis4Data** field specifies whether this is a row or column position. MUST be greater than or equal to -1 and less than or equal to 0x7FFF. A value of -1 specifies the default position. + +**cDim (2 bytes):** A signed integer that specifies the number of [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5) in the PivotTable view. MUST equal the number of [Sxvd](#sxvd) records following this record. MUST equal the number of fields in the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) specified by **iCache**. + +**cDimRw (2 bytes):** An unsigned integer that specifies the number of fields on the row axis of the PivotTable view. MUST be less than or equal to 0x7FFF. MUST equal the number of array elements in the [SxIvd](#sxivd) record in this PivotTable view that contain row items. + +**cDimCol (2 bytes):** An unsigned integer that specifies the number of fields on the column axis of the PivotTable view. MUST be less than or equal to 0x7FFF. MUST equal the number of array elements in the SxIvd record in this PivotTable view that contain column items. + +**cDimPg (2 bytes):** An unsigned integer that specifies the number of page fields in the PivotTable view. MUST be less than or equal to 0x7FFF. MUST equal the number of array elements in the [SXPI](#sxpi) record in this PivotTable view. + +**cDimData (2 bytes):** A signed integer that specifies the number of data fields in the PivotTable view. MUST be greater than or equal to zero and less than or equal to 0x7FFF. MUST equal the number of [SXDI](#sxdi) records in this PivotTable view. + +**cRw (2 bytes):** An unsigned integer that specifies the number of [pivot lines](#Section_76610990666f492791b6d2280f607464) in the row area of the PivotTable view. MUST be less than or equal to 0x7FFF. MUST equal the number of array elements in the first [SXLI](#sxli) record in this PivotTable view. + +**cCol (2 bytes):** An unsigned integer that specifies the number of pivot lines in the [column area](#Section_03aced8c25864e83982a1e3551a563d6) of the PivotTable view. MUST equal the number of array elements in the second SXLI record in this PivotTable view. + +**A - fRwGrand (1 bit):** A bit that specifies whether the PivotTable contains grand totals for rows. MUST be 0 if none of the axes have been assigned in this PivotTable view. + +**B - fColGrand (1 bit):** A bit that specifies whether the PivotTable contains grand totals for columns. MUST be 1 if none of the axes are assigned in this PivotTable view. + +**C - unused1 (1 bit):** Undefined and MUST be ignored. + +**D - fAutoFormat (1 bit):** A bit that specifies whether the PivotTable has [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f) applied. + +**E - fAtrNum (1 bit):** A bit that specifies whether the PivotTable has number AutoFormat applied. + +**F - fAtrFnt (1 bit):** A bit that specifies whether the PivotTable has [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) AutoFormat applied. + +**G - fAtrAlc (1 bit):** A bit that specifies whether the PivotTable has alignment AutoFormat applied. + +**H - fAtrBdr (1 bit):** A bit that specifies whether the PivotTable has [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) AutoFormat applied. + +**I - fAtrPat (1 bit):** A bit that specifies whether the PivotTable has pattern AutoFormat applied. + +**J - fAtrProc (1 bit):** A bit that specifies whether the PivotTable has width/height AutoFormat applied. + +**unused2 (6 bits):** Undefined and MUST be ignored. + +**itblAutoFmt (2 bytes):** An [AutoFmt8](#autofmt8) structure that specifies the PivotTable AutoFormat. If the value of **itblAutoFmt** in the associated [SXViewEx9](#sxviewex9) record is not 1, this field is overridden by the value of **itblAutoFmt** in the associated SXViewEx9. + +**cchTableName (2 bytes):** An unsigned integer that specifies the length, in characters, of **stTable**. MUST be greater than or equal to zero and less than or equal to 0x00FF. + +**cchDataName (2 bytes):** An unsigned integer that specifies the length, in characters of **stData**. MUST be greater than zero and less than or equal to 0x00FE. + +**stTable (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of the PivotTable. The length of this field is specified by **cchTableName**. + +**stData (variable):** An XLUnicodeStringNoCch structure that specifies the name of the data field. The length of this field is specified by **cchDataName**. + +### SXViewEx + +The **SXViewEx** record specifies the beginning of a collection of records as specified in the [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies details about an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
csxth
csxpi
csxvdtex
cbFuture
rgbFuture (variable)
...
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The value of the **frtHeaderOld.rt** field MUST be 0x80C. + +**csxth (4 bytes):** A signed integer that specifies the number of [SXTH](#sxth) records following this record. MUST be greater than or equal to 1. + +**csxpi (4 bytes):** A signed integer that specifies the number of [SXPIEx](#sxpiex) records following the SXTH records. MUST be greater than or equal to zero. + +**csxvdtex (4 bytes):** A signed integer that specifies the number of [SXVDTEx](#sxvdtex) records following the SXPIEx records. MUST be greater than or equal to zero. + +**cbFuture (4 bytes):** An unsigned integer that specifies the count of bytes in **rgbFuture**. MUST be greater than or equal to zero and less than or equal to 1024. MUST be equal to the byte count of **rgbFuture**. + +**rgbFuture (variable):** Information from future versions. The byte count MUST equal **cbFuture**. + +### SXViewEx9 + +The **SXViewEx9** record specifies extensions to the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rtABreserved2
reserved3
CDEFGreserved6
itblAutoFmtchGrand (variable)
...
+ +**rt (2 bytes):** An unsigned integer that specifies the record type identifier. The value MUST be 0x0810. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - fFrtAlert (1 bit):** A bit that specifies whether features of this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) are not supported in earlier versions of the [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517). + +An application can alert the user of possible problems when saving as an earlier version of the BIFF. + +**reserved2 (14 bits):** MUST be zero, and MUST be ignored. + +**reserved3 (4 bytes):** MUST be zero, and MUST be ignored. + +**C - reserved4 (1 bit):** MUST be zero, and MUST be ignored. + +**D - fPrintTitles (1 bit):** A bit that specifies whether the print titles for the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) are set based on the PivotTable report. The row print titles are set to the pivot item captions on the column axis and the column print titles are set to the pivot item captions on the row axis. + +**E - fLineMode (1 bit):** A bit that specifies whether any [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) is in outline mode. See [Subtotalling](#Section_427438d9b8e34a5c8b678f158fbf680f) for more information. + +**F - reserved5 (2 bits):** MUST be zero, and MUST be ignored. + +**G - fRepeatItemsOnEachPrintedPage (1 bit):** A bit that specifies whether [pivot item](#Section_58891cc5dd9b4293a97831070779524f) captions on the [row axis](#Section_3f46e7207706400cba9473cb829f869a) are repeated on each printed page for pivot fields in tabular form. + +**reserved6 (26 bits):** MUST be zero, and MUST be ignored. + +**itblAutoFmt (2 bytes):** An [AutoFmt8](#autofmt8) structure that specifies the PivotTable [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f). If the value of this field is not 1, this field overrides the **itblAutoFmt** field in the previous [SxView](#sxview) record. + +**chGrand (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies a user-entered caption to display for grand totals when the PivotTable is recalculated. The length MUST be less than or equal to 255 characters. + +### SXViewLink + +The **SXViewLink** record specifies the name of the source [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) associated with a [Pivot Chart](#Section_bed5fbd356f54997bb54b49f04e734b7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rtunused
reservedcchstPivotTable (variable)
...
+ +**rt (2 bytes):** An unsigned integer. MUST be 0x0858. + +**unused (2 bytes):** Undefined, and MUST be ignored. + +**reserved (2 bytes):** MUST be zero and MUST be ignored. + +**cch (1 byte):** An unsigned integer that specifies the count of characters of the **stPivotTable** field. + +**stPivotTable (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) non-null-terminated, case-sensitive [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string that specifies the name of the PivotTable view associated with the Pivot Chart. The size of this field in bytes MUST be **cch**. + +### SXVS + +The **SXVS** record specifies the type of [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) used for a [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). This record is followed by a sequence of records that specify additional information about the source data. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
sxvs
+ +**sxvs (2 bytes):** An unsigned integer that specifies the type of source data used for the PivotCache. The types of records that follow this record are dictated by the value of this field. MUST be a value from the following table: + +| **Name** | **Value** | **Meaning** | +|----|----|----| +| SHEET | 0x0001 | Specifies that the source data is a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). This record MUST be followed by a [DConRef](#dconref) record that specifies a simple range, or a [DConName](#dconname) record that specifies a [**named range**](#gt_042582ea-4050-4e5c-a2df-ae39706a19b6), or a [DConBin](#dconbin) record that specifies a built-in named range. | +| EXTERNAL | 0x0002 | Specifies that external source data is used. This record MUST be followed by a sequence of records beginning with a [DbQuery](#dbquery) record that specifies connection and query information that is used to retrieve [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e). | +| CONSOLIDATION | 0x0004 | Specifies that [multiple consolidation ranges](#Section_2535c296b76b4728b52c72fbabaf3047) are used as the source data. This record MUST be followed by a sequence of records beginning with an [SXTbl](#sxtbl) record that specifies information about the multiple consolidation ranges. | +| SCENARIO | 0x0010 | The source data is populated from a temporary internal structure. In this case there is no additional source data information because the raw data does not exist as a permanent structure and the logic to produce it is application-dependent. | + +### Sync + +When multiple windows are used to view a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) with synchronous scrolling enabled, the **Sync** record specifies the coordinates of the top-left visible [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) of all windows. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwcol
+ +**rw (2 bytes):** A [RwU](#rwu) structure that specifies the row for the top-left [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) cell of all windows. + +**col (2 bytes):** A [ColU](#colu) structure that specifies the column for the top-left visible cell of all windows. + +### Table + +The **Table** record specifies a [**data table (1)**](#gt_9e13d7ee-50d6-40ae-8789-29ecafe24bd4). This record is preceded by a single [Formula](#formula) record that defines the first [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the data table (1). Other Formula records that represent the rest of cells in the data table (1) follow later in the file, not necessarily in a contiguous sequence. Formula records that define the cells in the data table (1) MUST have the cell field that is within the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) specified in the **ref** field of this record and MUST have their formula begin with [PtgTbl](#ptgtbl). Also, each cell specified in the **ref** field MUST have a Formula that is part of this table. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ref
...ABCDEFreserved2
rwInpRwcolInpRw
rwInpColcolInpCol
+ +**ref (6 bytes):** A [Ref](#ref) structure that specifies the range of the data table (1). The value of **ref.rwFirst.rw** MUST be greater than or equal to 1. The value of **ref.colFirst.col** MUST be greater than or equal to 1. + +**A - fAlwaysCalc (1 bit):** A bit that specifies whether this data table (1) is recalculated as part of the next recalculation. + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fRw (1 bit):** A bit that specifies whether the [**input cell**](#gt_55b5bfbd-5f13-48d0-92e4-68d0c499b318) of a [**one-variable data table**](#gt_52eadba5-3428-4b54-bb99-e26cbd17c924) is a row input cell or a column input cell. If the value is 1, the input cell for a one-variable data table is a row input cell. + +If the value of the **fTbl2** field is 1, the value of **fRw** is undefined and MUST be ignored. + +**D - fTbl2 (1 bit):** A bit that specifies whether the data table (1) is a [**two-variable data table**](#gt_f699cf35-15b3-4efe-af97-391bda3016b0) or a one-variable data table. If the value is 1, the data table (1) is a two-variable data table. + +**E - fDeleted1 (1 bit):** A bit that specifies whether the cell referenced in the input cell specified by the **rwInpRw** and **colInpRw** fields is deleted. + +**F - fDeleted2 (1 bit):** A bit that specifies whether the cell referenced in the input cell specified by the **rwInpCol** and **colInpCol** fields is deleted. + +**reserved2 (10 bits):** MUST be zero, and MUST be ignored. + +**rwInpRw (2 bytes):** A [RwU](#rwu) structure that specifies either the row of a row input cell or the row of a column input cell. If the value of the **fTbl2** field is 0 and the value of the **fRw** field is 0, the value of **rwInpRw** specifies the row of a column input cell; for any other combination of the **fTbl2** and **fRw** fields, **rwInpRw** specifies the row of a row input cell. If the value of **fDeleted** field is 1, the value of **rwInpRw** MUST be 65535. + +If **fTbl2** is 1, the following statement (1) holds. + +If **fTbl2** is 0, exactly one of these statements holds: + +- **rwInpRw** and **colInpRw** MUST specify a cell outside the bounds specified by **ref.rwFirst** – 1, **ref.rwLast**, **ref.colFirst** – 1, and **ref.colLast**. + +- **rwInpRw** and **colInpRw** MUST be equal to **ref.rwFirst** -1 and **ref.colFirst** – 1, respectively. + +**colInpRw (2 bytes):** A [Col_NegativeOne](#col_negativeone) structure that specifies either the column of a row input cell or the column of a column input cell. If the value of the **fTbl2** field is 0 and the value of **fRw** field is 0, the value of **colInpRw** specifies the column of the column input cell; for any other combination of the **fTbl2** and **fRw** fields, **colInpRw** specifies the column of a row input cell. If the value of the **fDeleted** field is 1, the value of **colInpRw** MUST be -1. If the value of the **fDeleted** field is 0, the value of **colInpRw** MUST be greater than or equal to 0. + +**rwInpCol (2 bytes):** A RwU structure that specifies the row of the column input cell. The restrictions on the value of **rwInpCol** are dictated by the value of the **fTbl2** field and the value of the **fDeleted2** field, as specified in the following table: + +| fTbl2 | fDeleted2 | rwInpCol | +|----|----|----| +| 1 | 1 | The value MUST be 65535. | +| 1 | 0 | If the **colInpCol** is a value between **ref.colFirst** – 1 and **ref.colLast** inclusive, **rwInpCol** MUST NOT be a value between **ref.rwFirst** – 1 and **ref.rwLast** inclusive. | +| 0 | 1 or 0 | Undefined and MUST be ignored. | + +**colInpCol (2 bytes):** A Col_NegativeOne structure that specifies the column of the column input cell. The restrictions on the value of **colInpCol** are dictated by the value of the **fTbl2** field and the value of the **fDeleted2** field, as specified in the following table: + + +++++ + + + + + + + + + + + + + + + + + + + + + + + + +
fTbl2fDeleted2colInpCol
11The value MUST be -1.
10

The value MUST be greater than or equal to 0.

+

If the rwInpCol is a value between ref.rwFirst – 1 and ref.rwLast inclusive, colInpCol MUST NOT be a value between ref.colFirst – 1 and ref.colLast, inclusive.

01 or 0Undefined and MUST be ignored.
+ +### TableStyle + +The **TableStyle** record specifies a user-defined [table style](#Section_4ac7212b4aa74ece962526c58224ae80) and the beginning of a collection of [TableStyleElement](#tablestyleelement) records as specified by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of TableStyleElement records specifies the properties of the table style. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
ABCreserved2ctse
...cchName
rgchName (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x088F. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - fIsPivot (1 bit):** A bit that specifies whether the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) can be applied to [PivotTable views](#Section_09410dfbaac84a719ecf177ffba12c37). + +**C - fIsTable (1 bit):** A bit that specifies whether the style can be applied to [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +**reserved2 (13 bits):** MUST be zero, and MUST be ignored. + +**ctse (4 bytes):** An unsigned integer that specifies the count of TableStyleElement records to follow this record. MUST be less than or equal to 28. + +**cchName (2 bytes):** An unsigned integer that specifies the count of characters in the **rgchName** field. This value MUST be less than or equal to 255 and greater than or equal to 1. + +**rgchName (variable):** An array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters whose length is specified by **cchName** that specifies the style name. + +### TableStyleElement + +The **TableStyleElement** record specifies formatting for one element of a [table style](#Section_4ac7212b4aa74ece962526c58224ae80). Each table style element specifies the formatting to apply to a particular area of a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) or [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) when the table style is applied. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
tseType
size
index
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0890. + +**tseType (4 bytes):** An unsigned integer that specifies the area of the table or [PivotTable view](#Section_a5f57198f2af40b2ba07e4b1836d73f3)to which the formatting is applied. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00000000 | Whole table. If this table style is applied to a PivotTable view, this formatting type also applies to page field captions and page item captions. | +| 0x00000001 | [**Header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38). If this table style is applied to a PivotTable view, this formatting type applies to the collection of rows above the [**data region**](#gt_6abb146e-d02e-45aa-a034-b25b23b0dd48). See *S* in the PivotTable Style Diagram. | +| 0x00000002 | [**Total row**](#gt_95e9bcf4-d644-4e96-9070-dbc80b4d1b28). If this table style is applied to a PivotTable view, this formatting type applies to the [**grand total**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7) row. See *N* in the PivotTable Style Diagram. | +| 0x00000003 | First column. If this table style is applied to a PivotTable view, this formatting type applies to the row label area, which can span multiple columns. See *R* in the PivotTable Style Diagram. | +| 0x00000004 | Last column. If this table style is applied to a PivotTable view, this formatting type applies to the grand total column. See *A* in the PivotTable Style Diagram. | +| 0x00000005 | Row [**stripe band**](#gt_8c31265f-bec6-4a86-90cf-6139819a34d1) 1 | +| 0x00000006 | Row stripe band 2 | +| 0x00000007 | Column stripe band 1 | +| 0x00000008 | Column stripe band 2 | +| 0x00000009 | First [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) of Header row. If this table style is applied to a PivotTable view, this formatting type applies to cells contained in area intersected by the header row and first column. | +| 0x0000000A | Last cell of header row. MUST be ignored if this table style is applied to a PivotTable view. | +| 0x0000000B | First cell of Total row. MUST be ignored if this table style is applied to a PivotTable view. | +| 0x0000000C | Last cell of Total row. MUST be ignored if this table style is applied to a PivotTable view. | +| 0x0000000D | Outermost [**subtotal columns**](#gt_1916aca3-9be3-4739-b439-b4c77e8dc40c) in a PivotTable view, specified by the columns displaying subtotals for the first [Sxvd](#sxvd) record in the [PIVOTVD](#worksheet-substream) collection where the **sxaxis** field of the Sxvd record specifies the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). See *B* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x0000000E | Alternating even subtotal columns in a PivotTable view, specified by the columns displaying subtotals for Sxvd records for which the zero-based index in the PIVOTVD collection is an odd number, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the column axis. See *C* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x0000000F | Alternating odd subtotal columns in a PivotTable view, specified by the columns displaying subtotals for Sxvd records for which the zero-based index in the PIVOTVD collection is an even number greater than zero, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the column axis. See *D* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000010 | Outermost subtotal rows in a PivotTable view, specified by the rows displaying subtotals for the first Sxvd record in the PIVOTVD collection where the **sxaxis** field of the Sxvd record specifies the [row axis](#Section_3f46e7207706400cba9473cb829f869a). See *M* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000011 | Alternating even subtotal rows in a PivotTable view, specified by the rows displaying subtotals for Sxvd records for which the zero-based index in the PIVOTVD collection is an odd number, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the row axis. See *K* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000012 | Alternating odd subtotal rows in a PivotTable view, specified by the rows displaying subtotals for Sxvd records for which the zero-based index in the PIVOTVD collection is an even number greater than zero, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the row axis. See *J* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000013 | Empty rows after each subtotal row. See *L* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000014 | Outermost column subheadings in a PivotTable view, specified by the columns displaying [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) captions for the first Sxvd record in the PIVOTVD collection where the **sxaxis** field of the Sxvd record specifies the column axis. See *O* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000015 | Alternating even column subheadings in a PivotTable view, specified by the column columns displaying pivot field captions for Sxvd records for which the zero-based index in the PIVOTVD collection is an odd number, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the column axis. See *P* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000016 | Alternating odd column subheadings in a PivotTable view, specified by the columns displaying pivot field captions for Sxvd records for which the zero-based index in the PIVOTVD collection is an even number greater than zero, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the column axis. See *Q* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000017 | Outermost row subheadings in a PivotTable view, specified by the rows displaying pivot field captions for the first Sxvd record in the PIVOTVD collection where the **sxaxis** field of the Sxvd record specifies the row axis. See *G* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000018 | Alternating even row subheadings in a PivotTable view, specified by the rows displaying pivot field captions for Sxvd records for which the zero-based index in the PIVOTVD collection is an odd number, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the row axis. See *H* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000019 | Alternating odd row subheadings in a PivotTable view, specified by the rows displaying pivot field captions for Sxvd records for which the zero-based index in the PIVOTVD collection is an even number greater than zero, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the row axis. See *I* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x0000001A | Page field captions in a PivotTable view, specified by the cells displaying pivot field captions for the Sxvd records in the PIVOTVD collection where the **sxaxis** field of the Sxvd record specifies the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). See *F* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x0000001B | Page item captions in a PivotTable view, specified by the cells displaying [pivot item](#Section_58891cc5dd9b4293a97831070779524f) captions for the Sxvd records in the PIVOTVD collection where the **sxaxis** field of the Sxvd record specifies the page axis. See *E* in the PivotTable Style Diagram. Used only for PivotTables. | + +
+ +

Figure 18: PivotTable-style diagram

+
+ +**size (4 bytes):** An unsigned integer that specifies the number of rows or columns to include in a single stripe band. MUST be ignored when the value of **tseType** does not equal 0x00000005, 0x00000006, 0x00000007, or 0x00000008. MUST be greater than or equal to 1 and less than or equal to 9. + +**index (4 bytes):** A [DXFId](#dxfid) structure that specifies the [DXF](#dxf) record that contains the [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6) properties for this element. + +### TableStyles + +The **TableStyles** record specifies the default [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) and [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) [table styles](#Section_4ac7212b4aa74ece962526c58224ae80) and specifies the beginning of a collection of [TableStyle](#tablestyle) records as defined by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of TableStyle records specifies user-defined table styles. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
cts
cchDefTableStylecchDefPivotStyle
rgchDefTableStyle (variable)
...
rgchDefPivotStyle (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x088E. + +**cts (4 bytes):** An unsigned integer that specifies the total number of table styles in this document. This is the sum of the standard built-in table styles and all of the custom table styles. This value MUST be greater than or equal to 144 (the number of built-in table styles). + +**cchDefTableStyle (2 bytes):** An unsigned integer that specifies the count of characters in the **rgchDefTableStyle** field. This value MUST be less than or equal to 255. + +**cchDefPivotStyle (2 bytes):** An unsigned integer that specifies the count of characters in the **rgchDefPivotStyle** field. This value MUST be less than or equal to 255. + +**rgchDefTableStyle (variable):** An array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters whose length is specified by **cchDefTableStyle** that specifies the name of the default table style. + +**rgchDefPivotStyle (variable):** An array of Unicode characters whose length is specified by **cchDefPivotStyle** that specifies the name of the default PivotTable [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633). + +### Template + +The **Template** record is an empty record that specifies whether the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is a [**template**](#gt_159ca22f-c24d-4c6d-b08a-3d4c4c923953). If this record is present, the workbook is a template. + +### Text + +The **Text** record specifies the properties of an [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a) and specifies the beginning of a collection of records as defined by the [chart sheet](#Section_732ff614d939416bb7c76d983471ff11) substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). This collection of records specifies an attached label. + +The **fShowKey**, **fShowValue**, **fShowLabelAndPerc**, **fShowPercent**, **fShowBubbleSizes**, and **fShowLabel** fields MUST equal 0 and MUST be ignored if the current attached label does not contain an [ObjectLink](#objectlink) record that satisfies the following conditions: + +- The **wLinkObj** field of the ObjectLink record equals 0x0004. + +- The **wLinkVar1** field of the ObjectLink record references a [series](#Section_527ce4dfc9f84e50a314d4b07519593c). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
atvatwBkgMode
rgbText
x
y
dx
dy
ABCDEFGHIJKLMNicvText
dlpunused3Otrot
+ +**at (1 byte):** An unsigned integer that specifies the [**horizontal alignment**](#gt_f0e60ca8-51d5-4553-9126-3d89a4d08f90) of the text. MUST be a value from the following table: + +| Value | Alignment | +|----|----| +| 0x01 | Left-alignment if **iReadingOrder** specifies [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067) [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361); otherwise, right-alignment | +| 0x02 | Center-alignment | +| 0x03 | Right-alignment if **iReadingOrder** specifies left-to-right reading order; otherwise, left-alignment | +| 0x04 | Justify-alignment | +| 0x07 | [**Distributed alignment**](#gt_dae18ea5-2a98-4e10-9570-7f4ac695c6b8) | + +**vat (1 byte):** An unsigned integer that specifies the [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878) of the text. MUST be a value from the following table: + +| Value | Alignment | +|-------|-----------------------| +| 0x01 | Top-alignment | +| 0x02 | Center-alignment | +| 0x03 | Bottom-alignment | +| 0x04 | Justify-alignment | +| 0x07 | Distributed alignment | + +**wBkgMode (2 bytes):** An unsigned integer that specifies the display mode of the background of the text. MUST be a value from the following table: + +| Value | Background Mode | +|--------|------------------------| +| 0x0001 | Transparent background | +| 0x0002 | Opaque background | + +**rgbText (4 bytes):** A [LongRGB](#longrgb) structure that specifies the color of the text. + +**x (4 bytes):** A signed integer that specifies the horizontal position of the text, relative to the upper-left of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)) in [SPRC](#Section_d5fc728e68de4972905a975bcef8c82d). This value MUST be ignored when this record is preceded by a [DefaultText](#defaulttext) record or when it is followed by a [Pos](#pos) record; otherwise MUST be greater than or equal to 0 and less than or equal to 32767. SHOULD[\<132\>](#Appendix_A_132) be less than or equal to 4000. + +**y (4 bytes):** A signed integer that specifies the vertical position of the text, relative to the upper-left of the chart area (section 2.2.3.17) in SPRC. This value MUST be ignored when this record is preceded by a DefaultText record or when it is followed by a Pos record; otherwise MUST be greater than or equal to 0 and less than or equal to 32767. SHOULD[\<133\>](#Appendix_A_133) be less than or equal to 4000. + +**dx (4 bytes):** A signed integer that specifies the horizontal size of the text, relative to the chart area (section 2.2.3.17) in SPRC. This value MUST be ignored when this record is followed by a Pos record; otherwise MUST be greater than or equal to 0 and less than or equal to 32767. SHOULD[\<134\>](#Appendix_A_134) be less than or equal to 4000. + +**dy (4 bytes):** A signed integer that specifies the vertical size of the text, relative to the chart area (section 2.2.3.17) in SPRC. This value MUST be ignored when this record is followed by a Pos record; otherwise MUST be greater than or equal to 0 and less than or equal to 32767. SHOULD[\<135\>](#Appendix_A_135) be less than or equal to 4000. + +**A - fAutoColor (1 bit):** A bit that specifies whether the foreground text color is determined automatically. + +**B - fShowKey (1 bit):** A bit that specifies whether the text is attached to a [**legend key**](#gt_6981bc96-6d51-425c-9550-63c5b8b08e54). + +**C - fShowValue (1 bit):** A bit that specifies whether the value, or the vertical value on bubble or scatter [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5), is displayed in the [data label](#Section_cac7f43a3af142f58ff2814c2870427f). + +If the current attached label contains a [DataLabExtContents](#datalabextcontents) record and the **fPercent** field of the DataLabExtContents record equals 0, this field MUST equal the **fValue** field of the DataLabExtContents record. + +If the current attached label does not contain a DataLabExtContents record and **fShowLabelAndPerc** equals 1, this field MUST equal 0. + +This field MUST equal 0 if the current attached label does not contain a DataLabExtContents record and one or more of the following conditions are satisfied: + +- The **fShowLabelAndPerc** field equals 1. + +- The **fShowPercent** field equals 1. + +**D - unused1 (1 bit):** Undefined and MUST be ignored. + +**E - fAutoText (1 bit):** A bit that specifies whether the text value of this text field is automatically generated and unchanged. + +**F - fGenerated (1 bit):** A bit that specifies whether the properties of this text field are automatically generated and unchanged. + +**G - fDeleted (1 bit):** A bit that specifies whether this data label was deleted by the user. + +**H - fAutoMode (1 bit):** A bit that specifies whether the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) is determined automatically. + +**I - unused2 (3 bits):** Undefined and MUST be ignored. + +**J - fShowLabelAndPerc (1 bit):** A bit that specifies whether the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) name and the value, represented as a percentage of the sum of the values of the series the data label is associated with, are displayed in the data label. + +MUST equal 0 if the chart group type of the corresponding chart group, series, or [data point](#Section_9c986ad250d44fa1a157063ac5c971a0), is not a bar of pie, doughnut, pie, or pie of pie chart group. + +This field MUST equal 1 if the current attached label contains a DataLabExtContents record and both of the following conditions are satisfied: + +- The **fCatName** and **fPercent** fields of the DataLabExtContents record equal 1. + +- The **fSerName**, **fValue**, and **fBubSizes** fields of the DataLabExtContents record equal 0. + +This field MUST equal 0 if the current attached label contains a DataLabExtContents record and one or more of the following conditions is satisfied: + +- The **fCatName** or **fPercent** fields of the DataLabExtContents record equal 0. + +- The **fSerName**, **fValue**, or **fBubSizes** fields of the DataLabExtContents record equal 1. + +MUST be ignored if **fAutoText** equals 0. + +**K - fShowPercent (1 bit):** A bit that specifies whether the value, represented as a percentage of the sum of the values of the series the data label is associated with, is displayed in the data label. + +MUST equal 0 if the chart group type of the corresponding chart group, series, or data point is not a bar of pie, doughnut, pie, or pie of pie chart group. + +If the current attached label contains a DataLabExtContents record, this field MUST equal the value of the **fPercent** field of the DataLabExtContents record. + +If the current attached label does not contain a DataLabExtContents record and **fShowLabelAndPerc** equals 1, this field MUST equal 1. + +MUST be ignored if **fAutoText** equals 0. + +**L - fShowBubbleSizes (1 bit):** A bit that specifies whether the [**bubble size**](#gt_3a0cf938-5b61-4460-bdbb-3540d84d4180) is displayed in the data label. + +MUST equal 0 if the chart group type of the corresponding chart group, series, or data point is not a bubble chart group. + +If the current attached label contains a DataLabExtContents record and the **fPercent**, **fValue**, and **fCatName** fields of the DataLabExtContents record equal 0, this field MUST equal the **fBubSizes** field of the DataLabExtContents record. + +If the current attached label contains a DataLabExtContents record and the **fPercent, fValue,** or **fCatName** fields of the DataLabExtContents record equal 1, this field MUST equal 0. + +If the current attached label does not contain a DataLabExtContents record and **fShowPercent**, **fShowValue**, or **fShowLabel** equal 1, this field MUST equal 0. + +MUST be ignored if **fAutoText** equals 0. + +**M - fShowLabel (1 bit):** A bit that specifies whether the category, or the horizontal value on bubble or scatter chart groups, is displayed in the data label on a non-area chart group, or the series name is displayed in the data label on an area chart group. + +This field MUST equal the **fCatNameLabel** field of the DataLabExtContents record if the current attached label contains a DataLabExtContents record, the chart group is non-area, and both of the following conditions are satisfied: + +- The **fValue** field of the DataLabExtContents record equals 0. + +- The **fShowLabelAndPerc** field equals 1 or the **fPercent** field equals 0. + +This field MUST equal the **fCatNameLabel** field of the DataLabExtContents record if the current attached label contains a DataLabExtContents record, the chart group is area or filled radar, and the following condition is satisfied: + +- The **fValue** field of the DataLabExtContents record equals 0. + +If the current attached label contains a DataLabExtContents record and the **fValue** field of the DataLabExtContents record equals 1, this field MUST equal 0. + +This field MUST equal 0 if the current attached label does not contain a DataLabExtContents record and one of the following conditions is satisfied: + +- The **fShowValue** field equals 1. + +- The **fShowLabelAndPerc** field equals 0 and the **fShowPercent** field equals 1. + +MUST be ignored if **fAutoText** equals 0. + +**N - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**icvText (2 bytes):** An [Icv](#icv) structure that specifies the color of the text. + +**dlp (4 bits):** An unsigned integer that specifies the data label positioning of the text, relative to the [**graph object**](#gt_f4c97882-38e3-4b03-9f11-09ee6566da21) item the text is attached to. For all data label text fields, MUST be a value from the following table: + +| Data label position | Value | Value for chart group type | +|----|----|----| +| Auto | 0x0 | Pie chart group | +| Right | 0x0 | Line, Bubble, or Scatter chart group | +| Outside | 0x0 | Bar or Column chart group with **fStacked** equal to 0 | +| Center | 0x0 | Bar or Column chart group with **fStacked** equal to 1 | +| Outside End | 0x1 | Bar, Column, or Pie chart group | +| Inside End | 0x2 | Bar, Column, or Pie chart group | +| Center | 0x3 | Bar, Column, Line, Bubble, Scatter, or Pie chart group | +| Inside Base | 0x4 | Bar or Column chart group | +| Above | 0x5 | Line, Bubble, or Scatter chart group | +| Below | 0x6 | Line, Bubble, or Scatter chart group | +| Left | 0x7 | Line, Bubble, or Scatter chart group | +| Right | 0x8 | Line, Bubble, or Scatter chart group | +| Auto | 0x9 | Pie chart group | +| Moved by user | 0xA | All | + +For all non-data label text fields, it MUST be 0x0. + +**unused3 (10 bits):** Undefined and MUST be ignored. + +**O - iReadingOrder (2 bits):** An unsigned integer that specifies the reading order of the text. MUST be a value from the following table: + +| Value | Reading order | +|----|----| +| 0x0 | The reading order is equal to the **iReadingOrder** value of the Text record immediately following the closest preceding [Chart](#chart-2), [DataFormat](#dataformat), [Legend](#legend-1), [Series](#series-1), or [YMult](#ymult) record where **iReadingOrder** is not equal to 0x0. If no such preceding record exists, the DefaultText settings of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) are used. If the DefaultText settings also specify 0x0, the reading order is determined by the application. | +| 0x1 | Left-to-right | +| 0x2 | [**Right-to-left**](#gt_91359688-7863-4e88-b507-f57b3dada5ec) | + +**trot (2 bytes):** An unsigned integer that specifies the text rotation. MUST be a value from the following table: + +| Value | Angle description | +|-----------|-----------------------------------------------------------------| +| 0 to 90 | Text rotated 0 to 90 degrees counter-clockwise | +| 91 to 180 | Text rotated 1 to 90 degrees clockwise (angle is **trot** – 90) | +| 255 | Text top-to-bottom with letters upright | + +### TextPropsStream + +The **TextPropsStream** record specifies additional text properties for the text in the entire [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), text in the current [legend](#Section_1832229b7d1945f488d455e9c07466f0), text in the current [**legend entry**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e), text in the [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a), or the [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) labels of the current axis. These text properties are a superset of the properties stored in the associated [Text](#text) and [Font](#font) records based on the following table, as specified by [Chart Sheet substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). In each case, the associated Font record is specified by the associated [FontX](#fontx) record.[\<136\>](#Appendix_A_136) + +| Rule containing the TextPropsStream record | Meaning | +|----|----| +| CHARTFORMATS | Specifies additional Rich Text Format properties for the text of the entire chart. The associated Text and FontX records are contained in the attached label that is contained in the first sequence of records that conforms to the DFTTEXT rule in the chart and that is not contained in the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). | +| LD | Specifies additional Rich Text Format properties for text in the current legend. The associated Text and FontX records are contained in the sequence of records that conforms to the ATTACHEDLABEL rule that is contained in the collection of records conforming to the LD rule. | +| SERIESFORMAT | Specifies additional Rich Text Format properties for the current legend entry. The associated Text and FontX records are contained in the sequence of records that conforms to the ATTACHEDLABEL rule that immediately precedes this record contained in the sequence of records that conforms to the SERIESFORMAT rule. | +| ATTACHEDLABEL | Specifies additional Rich Text Format properties for the text in the attached label. The associated Text and FontX records are contained in the sequence of records that conforms to the ATTACHEDLABEL rule. | +| AXS | Specifies additional Rich Text Format properties for the axis labels of the current axis. The associated Text and FontX records are contained in the sequence of records that conforms to the AXS rule. | + +These text properties are stored in the **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)), as specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, section 21.2.2.216. + +An application can choose to ignore this record without loss of functionality, except for the additional text properties. If an application chooses to implement this record, the application MUST implement the validation [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) specified by the **dwChecksum** field. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
dwChecksum
cb
rgb (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x08A5. + +**dwChecksum (4 bytes):** An unsigned integer that specifies the checksum of the text properties attributes related to this record. The algorithm used to calculate the checksum is specified by [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.4.3.2. The checksum MUST be calculated from every property of the [**property stream**](#gt_dbd8bc67-1371-445e-af6a-dfa5eeef670c), taken as an array of bytes as specified by the [TextPropsStreamChecksumData](#textpropsstreamchecksumdata) structure. + +The information required to build the memory stream can be gathered from the Text and Font records associated with this record, as previously specified. + +When reading this record, the checksum is calculated as previously specified and compared to the **dwChecksum** value stored in this record. If the calculated checksum does not match the **dwChecksum** data, the application MUST assume that the **XML stream** (section 2.1.7.22) is out of date, and the data from the associated Text and Font records MUST be used instead of the data specified by the **XML stream** (section 2.1.7.22). + +**cb (4 bytes):** An unsigned integer that specifies the size of the **rgb** field. This field MUST contain the exact length in bytes of the **rgb** field. + +**rgb (variable):** An array of ANSI characters that contains the [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) representation of the text formatting properties, as defined in \[ECMA-376\] Part 1, section 21.2.2.216. The length of this field is specified by the **cb** field. + +### Theme + +The **Theme** record specifies the [**theme**](#gt_8b5eb4c0-949b-47d9-8b63-b9bda81d61b8) in use in the document. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
dwThemeVersion
rgb (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The value of the **frtHeader.rt** field MUST be 2198. + +**dwThemeVersion (4 bytes):** An unsigned integer that specifies the theme type. SHOULD be a value from the following table[\<137\>](#Appendix_A_137): + +| Value | Meaning | +|--------|---------------| +| 0 | Custom theme | +| 124226 | Default theme | + +**rgb (variable):** An optional byte stream that specifies the theme contents (as defined in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, Section 14.2.7). MUST exist if **dwThemeVersion** equals 0. + +### Tick + +The **Tick** record specifies the attributes of the [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) labels, [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb), and [**minor tick marks**](#gt_c2eb605a-6c5a-427e-8608-f16940de82a6) associated with an axis. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
tktMajortktMinortltwBkgMode
rgb
reserved1
reserved2
reserved3
reserved4
ABrotCunusedDicv
trot
+ +**tktMajor (1 byte):** An unsigned integer that specifies the location of major tick marks. MUST be a value from the following table: + +| Value | Tick mark location | +|----|----| +| 0x0000 | None. No major tick marks are drawn on the axis. | +| 0x0001 | Inside. Major tick marks are drawn toward the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). | +| 0x0002 | Outside. Major tick marks are drawn away from the plot area. | +| 0x0003 | Crossing. Major tick marks are drawn evenly on both sides of the axis. | + +**tktMinor (1 byte):** An unsigned integer that specifies the location of minor tick marks. MUST be a value from the following table: + +| Value | Tick mark location | +|----|----| +| 0x0000 | None. No minor tick marks are present on the axis. | +| 0x0001 | Inside. Minor tick marks are drawn toward the plot area. | +| 0x0002 | Outside. Minor tick marks are drawn away from the plot area. | +| 0x0003 | Crossing. Minor tick marks are drawn evenly on both sides of the axis. | + +**tlt (1 byte):** An unsigned integer that specifies the location of axis labels. MUST be a value from the following table: + +| Value | Tick mark label location | +|----|----| +| 0x0000 | None. No axis labels are present on the axis. | +| 0x0001 | Low. Axis labels are drawn to the left of the plot area for a vertical axis or below the plot area for a horizontal axis for all [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) types except radar. Axis labels for radar chart group types will be drawn as if the value was 0x0003. | +| 0x0002 | High. Axis labels are drawn to the right of the plot area for a vertical axis or above the plot area for a horizontal axis for all chart group types except radar. Axis labels for radar chart group types will be drawn as if the value was 0x0003. | +| 0x0003 | Next to Axis. Axis labels are drawn next to the axis. | + +**wBkgMode (1 byte):** An unsigned integer that specifies the display mode of the background of the text of the axis labels. MUST be ignored if the value of **fAutoCo** is 1. MUST be a value from the following table: + +| Value | Background Mode | +|----|----| +| 0x0001 | Transparent background | +| 0x0002 | Opaque background. The background color will match the **rgbBack** field in the associated [AreaFormat](#areaformat) record as specified by the [AXS](#chart-sheet-substream) rule in the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). | + +**rgb (4 bytes):** A [LongRGB](#longrgb) structure that specifies the color of the text for the axis labels. MUST be ignored if **fAutoCo** is 1. + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved3 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved4 (4 bytes):** MUST be zero, and MUST be ignored. + +**A - fAutoCo (1 bit):** A bit that specifies if the foreground text color of the axis labels is determined automatically. + +| Value | Meaning | +|----|----| +| 0 | The text uses the color specified by **rgb**. | +| 1 | The text uses an automatically selected foreground color, based on the computer’s display settings. | + +. + +**B - fAutoMode (1 bit):** A bit that specifies if the background color of the axis label is determined automatically. + +| Value | Meaning | +|----|----| +| 0 | The background color is specified by **wBkgMode**. | +| 1 | The background color is set according to the [DefaultText](#defaulttext) settings of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). | + +. + +**rot (3 bits):** An unsigned integer that specifies text rotation of the axis labels. MUST be a value from the following table: + +| Value | Text Rotation | +|-------|---------------------------------------------------------------------| +| 0x0 | Text is drawn with the rotation specified by the value of **trot**. | +| 0x1 | Text is drawn stacked, top-to-bottom, with the letters upright. | +| 0x2 | Text is drawn rotated at 90 degrees counterclockwise. | +| 0x3 | Text is drawn rotated at 90 degrees clockwise. | + +**C - fAutoRot (1 bit):** A bit that specifies whether the text rotation of the axis label is determined automatically. + +| Value | Meaning | +|----|----| +| 0 | The axis labels do not rotate automatically, and follow the rotation specified by **rot** and **trot**. | +| 1 | The axis labels rotate as the location of the axis changes and the value of the **rot** and **trot** fields MUST be ignored. | + +. + +**unused (8 bits):** Undefined, and MUST be ignored. + +**D - iReadingOrder (2 bits):** An unsigned integer that specifies the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361) of the axis labels. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The reading order is equal to the **iReadingOrder** value of the [Text](#text) record immediately following the closest preceding [Chart](#chart-2), [DataFormat](#dataformat), [Legend](#legend-1), [Series](#series-1) or [YMult](#ymult) record where **iReadingOrder** is not equal to 0x0. If no such preceding record exists, the DefaultText settings of the chart is used. If the DefaultText settings also specify 0x0, the reading order is determined by the Application. | +| 0x1 | [**Left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067) | +| 0x2 | [**Right-to-left**](#gt_91359688-7863-4e88-b507-f57b3dada5ec) | + +**icv (2 bytes):** An [Icv](#icv) that specifies the color of the text. The color MUST be the same as **rgb**. + +**trot (2 bytes):** An unsigned integer that specifies the axis label’s text rotation. MUST be a value from the following table: + +| Value | Meaning | +|-----------|-----------------------------------------------------------------| +| 0 to 90 | Text rotated 0 to 90 degrees counterclockwise | +| 91 to 180 | Text rotated 1 to 90 degrees clockwise (angle is **trot** – 90) | +| 255 | Text top-to-bottom with letters upright | + +### TopMargin + +The **TopMargin** record specifies the top margin of the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
num
...
+ +**num (8 bytes):** An Xnum (section [2.5.342](#xnum)) structure that specifies the top margin of the current sheet in inches. The value MUST be greater than or equal to 0 and less than or equal to 49. + +### TxO + +The **TxO** record specifies the text in a text box or a [**form**](#gt_c7858bfa-d4d2-48a7-ac9c-d2e90fbe3590) control. This record can be followed by a collection of [Continue](#continue) records that specifies additional feature data to complete this record, as follows: + +- If the value of the **cchText** field is not zero, this record does not fully specify the text. The rest of the data that MUST be specified is the text string and the [**formatting runs**](#gt_10031ac8-2a26-4200-beee-cd8d9420ca96) information. That data is specified in two sets of following Continue records: + + + +- **Text String Specification**: The first set of Continue records specifies the text string. Each of these Continue records contains an [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies part of the string. The total number of characters in all XLUnicodeStringNoCch MUST be **cchText**. + +- Formatting Run **Specification**: The second set of Continue records specifies formatting runs. These Continue records contain a [TxORuns](#txoruns) structure. If the size of the TxORuns structure is longer than 8,224 bytes, it is split across multiple Continue records. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEFGHrot
reserved4 (optional)reserved5 (optional)
...controlInfo (optional)
...
cchTextcbRuns
ifntEmptyfmla (variable)
...
+ +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - hAlignment (3 bits):** An unsigned integer that specifies the [**horizontal alignment**](#gt_f0e60ca8-51d5-4553-9126-3d89a4d08f90). The value MUST be one of the values in the following table: + +| Value | Meaning | +|----|----| +| 1 | Specifies left alignment. | +| 2[\<138\>](#Appendix_A_138) | Specifies centered alignment. | +| 3 | Specifies right alignment. | +| 4 | Specifies justify alignment. | +| 7 | Specifies [**justify distributed**](#gt_11eced66-af2c-4391-8b45-87a60ad41483) alignment. | + +**C - vAlignment (3 bits):** An unsigned integer that specifies the [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878). The value MUST be one of the values in the following table: + +| Value | Meaning | +|----|----| +| 1 | Specifies top alignment. | +| 2 | Specifies middle alignment. | +| 3 | Specifies bottom alignment. | +| 4 | Specifies justify alignment[\<139\>](#Appendix_A_139). | +| 7 | Specifies justify distributed alignment. | + +**D - reserved2 (2 bits):** MUST be zero, and MUST be ignored. + +**E - fLockText (1 bit):** A bit that specifies whether the text is [**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81). + +**F - reserved3 (4 bits):** MUST be zero, and MUST be ignored. + +**G - fJustLast (1 bit):** A bit that specifies whether the justify alignment or justify distributed alignment is used on the last line of the text in specific versions of the application[\<140\>](#Appendix_A_140). + +**H - fSecretEdit (1 bit):** A bit that specifies whether this is a text box used for typing passwords and hiding the actual characters being typed by the user. + +**rot (2 bytes):** An unsigned integer that specifies the orientation of the text within the object boundary. The value MUST be one of the values in the following table: + +| Value | Meaning | +|-------|-------------------------------------------------| +| 0 | Specifies no rotation. | +| 1 | Specifies stacked or vertical orientation. | +| 2 | Specifies 90-degree counter-clockwise rotation. | +| 3 | Specifies 90-degree clockwise rotation. | + +**reserved4 (2 bytes):** MUST be zero and MUST be ignored. This field MUST exist if and only if the value of **cmo.ot** in the preceding [Obj](#obj) record is not 0, 5, 7, 11, 12 or 14. + +**reserved5 (4 bytes):** MUST be zero and MUST be ignored. This field MUST exist if and only if the value of **cmo.ot** in the preceding Obj record is not 0, 5, 7, 11, 12 or 14. + +**controlInfo (6 bytes):** An optional [ControlInfo](#controlinfo) structure that specifies the properties for some form controls. The field MUST exist if and only if the value of **cmo.ot** in the preceding Obj record is 0, 5, 7, 11, 12, or 14. + +**cchText (2 bytes):** An unsigned integer that specifies the number of characters in the text string contained in the Continue records immediately following this record. + +**cbRuns (2 bytes):** An unsigned integer that specifies the number of bytes of formatting run information in the TxORuns structure contained in the Continue records following this record. If **cchText** is 0, this value MUST be 0. Otherwise, the value MUST be greater than or equal to 16 and MUST be a multiple of 8. + +**ifntEmpty (2 bytes):** A [FontIndex](#fontindex) structure that specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) when the value of **cchText** is 0. + +**fmla (variable):** An [ObjFmla](#objfmla) structure that specifies the [parsed expression](#Section_a795978bfa7845788e2dc07d78edae0e) of the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) for the text. + +### TxtQry + +The **TxtQry** record specifies information for a [**text query**](#gt_c636d3ce-a120-4acf-91ac-40b3ec79593a) and that specifies the beginning of a collection of [ExtString](#extstring) records, as defined by the [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of ExtString records specifies the [**connection string**](#gt_03a9d0ca-2f10-4f3d-b910-052714a96f7d) for a [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) that retrieves [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rtreserved
ABCDiCpidNewEunused1
rowStartAt
FGHIJKLchCustomunused2
itwf
chDecimalchThousSeprgtxtwf (variable)
...
rgchFile (variable)
...
+ +**rt (2 bytes):** An unsigned integer that specifies the record type. MUST be 0x0805. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**A - fFile (1 bit):** A bit that specifies that the query was generated from an import text file action. MUST be 1. + +**B - fDelimited (1 bit):** A bit that specifies whether the data is delimited. MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------| +| 0x0 | The data fields are of fixed size. | +| 0x1 | The data is delimited. | + +**C - iCpid (2 bits):** An unsigned integer that specifies the [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38) used for the origin of the file. This value is unused when the value of the **fUseNewiCpid** field is equal to 1 and the value of the **iCpidNew** field is greater than 2. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------| +| 0x0 | Macintosh | +| 0x1 | Windows (ANSI) | +| 0x2 | MS-DOS (PC-8) | + +**D - fPromptForFile (1 bit):** A bit that specifies whether a file name is prompted for on [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060). MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------| +| 0x0 | Saved file location is used during refresh | +| 0x1 | Prompt for file name on refresh | + +**iCpidNew (10 bits):** An unsigned integer that specifies application-specific code page information that can be used to optimize [**text importation**](#gt_82f6fb9c-cd59-46ec-ba3e-e7dacfc5c830) and can be ignored. + +**E - fUseNewiCpid (1 bit):** A bit that specifies whether the **iCpidNew** value is used for specifying the code page instead of the **iCpid** value. + +**unused1 (16 bits):** Undefined and MUST be ignored. + +**rowStartAt (4 bytes):** A signed integer that specifies the row in the source file where the query begins. + +**F - fTab (1 bit):** A bit that specifies whether the tab character is treated as a column delimiter. + +**G - fSpace (1 bit):** A bit that specifies whether the space character is treated as a column delimiter. + +**H - fComma (1 bit):** A bit that specifies whether the comma character is treated as a field delimiter. + +**I - fSemiColon (1 bit):** A bit that specifies whether the semi-colon character is treated as a column delimiter. + +**J - fCustom (1 bit):** A bit that specifies whether the custom character defined in the **chCustom** field is treated as a column delimiter. + +**K - fConsecutive (1 bit):** A bit that specifies whether consecutive delimiters are treated as one delimiter. + +**L - iTextDelm (2 bits):** An unsigned integer that specifies a text delimiter. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------| +| 0x0 | Quotation mark | +| 0x1 | Apostrophe | +| 0x2 | No text delimiter | + +**chCustom (16 bits):** An unsigned integer that specifies the custom delimiter [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) character. This value is used if the **fCustom** value equals 1. + +**unused2 (8 bits):** Undefined and MUST be ignored. + +**itwf (4 bytes):** A signed integer that specifies the number of fields in each row of data. MUST be greater than 0 and less than or equal to 256. + +**chDecimal (1 byte):** An unsigned integer that specifies the decimal separator. MUST be a character from the [**ANSI character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583). + +**chThousSep (1 byte):** An unsigned integer that specifies the thousands separator. MUST be a character from the ANSI character set. + +**rgtxtwf (variable):** An array of [TxtWf](#txtwf) that specifies the text to column fields. The size of the array is determined by the **itwf** value. The array MUST NOT be empty. + +**rgchFile (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the name of the text file that is the source of the query. + +### Uncalced + +The **Uncalced** record specifies that formulas (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) were pending recalculation when the file was saved. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
reserved1
+ +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +### Units + +The **Units** record MUST be zero, and MUST be ignored. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
reserved
+ +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +### UserBView + +The **UserBView** record specifies the general [**custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4) settings that apply to a whole [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). There are accompanying [UserSViewBegin](#usersviewbegin) records that specify individual custom view settings of each [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). The set of this record and the accompanying UserSViewBegin records share the same [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
unused1
tabIdreserved1
guid (16 bytes)
...
...
x
y
dx
dy
wTabRatioABCDEFGHIJKLMN
unused2OPunused3
wMergeIntervalst (variable)
...
+ +**unused1 (4 bytes):** Undefined and MUST be ignored. + +**tabId (2 bytes):** A [TabId](#tabid) structure that specifies the [**active sheet**](#gt_767d2df7-5efd-40a1-9e58-4b6a597cc389) in this custom view. If the value of the **fInvalidTabId** field is 1, the value of **tabId** is undefined and MUST be ignored. + +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +**guid (16 bytes):** A GUID as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that specifies the identity of the custom view. + +**x (4 bytes):** A signed integer that specifies the horizontal position of the workbook window, in [**pixels**](#gt_fe932605-d3bc-442f-9239-594676bce6ba). + +**y (4 bytes):** A signed integer that specifies the vertical position of the workbook window, in pixels. + +**dx (4 bytes):** A signed integer that specifies the width of the workbook window, in pixels. MUST be greater than or equal to 0. + +**dy (4 bytes):** A signed integer that specifies the height of the workbook window, in pixels. MUST be greater than or equal to 0. + +**wTabRatio (2 bytes):** An unsigned integer that specifies the ratio of the window area used to display [**sheet tabs**](#gt_3b131045-238c-4ce8-9c22-b6aac874c7c5) and the window area used to display the horizontal scroll bar. The value of **wTabRatio** MUST be greater than or equal to zero and less than or equal to 1000. A value of 0 specifies that only the horizontal scroll bar is displayed. A value of 1000 specifies that only sheet tabs are displayed. + +**A - fDspFmlaBar (1 bit):** A bit that specifies whether a [**formula bar**](#gt_1292cd97-b42c-415b-b71f-739f1f842c53) is displayed. + +**B - fDspStatus (1 bit):** A bit that specifies whether a status bar is displayed. + +**C - mdNoteDisp (2 bits):** An unsigned integer that specifies whether to show [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) and visual cue on each cell that has a comment. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------------------| +| 0x0 | Comment and visual cue are off for each cell with a comment. | +| 0x1 | A visual cue that indicates the cell has a comment. | +| 0x2 | Comment and visual cue are on for each cell with a comment. | + +**D - fDspHScroll (1 bit):** A bit that specifies whether a horizontal scroll bar is displayed. + +**E - fDspVScroll (1 bit):** A bit that specifies whether a vertical scroll bar is displayed. + +**F - fBotAdornment (1 bit):** A bit that specifies whether sheet tabs are displayed. + +**G - fZoom (1 bit):** A bit that specifies whether the workbook window is maximized. The value of **fIconic** and the value of **fZoom** MUST NOT both be 1. + +**H - fHideObj (2 bits):** A [**HideObjEnum**](#hideobjenum) structure that specifies how [**ActiveX objects**](#gt_0d95e494-61b2-43bc-8818-51aa162d2018), [**OLE objects**](#gt_cdff9514-a3fb-4897-941d-4e99193a0096), and [**drawing objects**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) appear in the workbook Window. + +**I - fPrintIncl (1 bit):** A bit that specifies whether the custom view includes the [**print settings**](#gt_6ef7745e-6602-4ff5-a8b0-9b9fd9f95b4a) of the workbook. MUST be a value from the following table: + + ++++ + + + + + + + + + + + + + + + + +
ValueMeaning
0x0The custom view does not include print settings of the workbook.
0x1

The custom view includes print settings of the workbook.

+

UserSViewBegin records that have a guid field value equal to the guid of this record specify which print settings are included in the custom view.

+

Additionally, print titles and print areas are specified by Lbl records that have Name containing the guid of this record, using the following form, where <guid> matches the value of guid with the characters left brace "{", right brace "}", and dash "-" in guid replaced by an underscore "_" character:

+
    +
  • Print titles: Z<guid>.wvu.PrintTitles

  • +
  • Print area: Z<guid>.wvu.PrintArea

  • +
+ +**J - fRowColIncl (1 bit):** A bit that specifies whether the custom view includes the [**hidden rows**](#gt_3833addc-1f77-4c64-856c-c1b967fdaa75), [**hidden columns**](#gt_ea5c8135-254e-407c-999b-5cf39e709164), and [**filters**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) for the workbook. MUST be a value from the following table: + + ++++ + + + + + + + + + + + + + + + + +
ValueMeaning
0x0The custom view does not include Hidden rows, hidden columns, or filter settings.
0x1

The custom view includes Hidden rows, hidden columns, or filter settings of the workbook.

+

UserSViewBegin records that have a guid field value equal to the guid of this record specify whether Hidden rows, hidden columns, or filter settings are included in the custom view.

+

Additionally, hidden rows and hidden columns are specified by Lbl records that have Name containing the guid of this record, using the following form, where <guid> matches the value of guid with the characters left brace "{", right brace "}", and dash "-" in guid replaced by an underscore "_" character:

+
    +
  • Hidden rows: Z<guid>.wvu.Rows

  • +
  • Hidden columns: Z<guid>.wvu.Cols

  • +
+

Filter settings are also specified by Lbl records that have Name containing the value of guid for this record, using the following form, where <guid> matches the value of guid with the characters left brace "{", right brace "}", and dash "-" in guid replaced by an underscore "_" character:

+
    +
  • Range being filtered: Z<guid>.wvu.FilterData

  • +
  • Range containing filter criteria: Z<guid>.wvu.FilterCriteria

  • +
+ +**K - fInvalidTabId (1 bit):** A bit that specifies whether the **tabId** field is ignored. + +**L - fTimedUpdate (1 bit):** A bit that specifies whether updates associated with linked or [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) are coordinated. If the value of the **fPersonalView** field is 0, the value of **fTimedUpdate** MUST be 0. + +**M - fAllMemChanges (1 bit):** A bit that specifies whether the changes being saved have priority in a [**merge conflict**](#gt_7854bf7f-3ead-4a20-9686-77d75fd6cefa). If the value of the **fTimedUpdate** field is 0, the value of **fAllMemChanges** is undefined and MUST be ignored. + +**N - fOnlySync (1 bit):** A bit that specifies whether the automatic update merges the current changes into a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc) or whether the automatic update merges and also saves the changes. If the value of the **fPersonalView** field is 0, the value of **fOnlySync** MUST be 0. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**O - fPersonalView (1 bit):** A bit that specifies whether the custom view is the personal view of a shared workbook. MUST be 0 if this is not a shared workbook. + +**P - fIconic (1 bit):** A bit that specifies whether the workbook window is minimized. The value of **fIconic** and the value of **fZoom** MUST NOT both be 1. + +**unused3 (14 bits):** Undefined and MUST be ignored. + +**wMergeInterval (2 bytes):** An unsigned integer that specifies the time interval, in minutes, between automatic merges of a shared workbook. The restrictions on the value of **wMergeInterval** are dictated by the value of the **fPersonalView** field and the value of the **fTimedUpdate** field, as specified in the following table: + +| fPersonalView | fTimedUpdate | wMergeInterval | +|----|----|----| +| 1 | 1 | MUST be greater than or equal to 5 and less than or equal to 1440. | +| 1 | 0 | Undefined and MUST be ignored. | +| 0 | 0 | MUST be 65535. | + +**st (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the name of the custom view. + +### UserSViewBegin + +The **UserSViewBegin** record specifies [**custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4) settings for the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and specifies the beginning of a collection of records as defined by the [Chart Sheet substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), [Dialog Sheet substream](#Section_da37feb48b9a462d87772a5fddd4866e) ABNF, [Macro Sheet substream](#Section_0dddd943f77a4fc2bf92868acb4587f7) ABNF, and [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF. The collection of records specifies custom view settings for the current sheet. There is an associated [UserBView](#userbview) record, specified by the **guid** field, that specifies custom view settings that apply to the whole [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). If the current sheet is a [**chart sheet**](#gt_da561b7b-c629-4cd8-bfaa-6e62471d9e83), the [UserSViewBegin_Chart](#usersviewbegin_chart) version of this record MUST be used. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
guid (16 bytes)
...
...
iTabidreserved1
wScale
icvHdrreserved2
pnnSelreserved3reserved4
ABCDEFGHIJKLMNOPQRSTUVWXYZab
ref8TopLeft
...
operNumX
...
operNumY
...
colRPanerwBPane
+ +**guid (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1), as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2), that specifies the association with a UserBView. MUST equal the value of the **guid** field of the UserBView. + +**iTabid (2 bytes):** A [TabId](#tabid) structure that specifies the sheet of this custom view. + +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +**wScale (4 bytes):** An unsigned integer that specifies the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) of the window used to display the sheet. MUST be greater than or equal to 10 and less than or equal to 400. + +**icvHdr (2 bytes):** An [Icv](#icv) structure that specifies the color of the [**gridlines**](#gt_82f8a326-64b0-4506-a18e-930f7c2c95b9) displayed in the view. MUST be less than or equal to 64. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +**pnnSel (1 byte):** A [**PaneType**](#panetype) structure that specifies the [**active pane**](#gt_33f49274-001d-40a3-bcca-f54a93906c29). + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**reserved4 (1 byte):** MUST be zero, and MUST be ignored. + +**A - fShowBrks (1 bit):** A bit that specifies whether [**page breaks**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871) are displayed. + +**B - fDspFmlaSv (1 bit):** A bit that specifies whether the window used to display the sheet displays formulas or values. MUST be 0 for [**dialog sheets**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8). MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------------| +| 0x0 | The window used to display the sheet displays values. | +| 0x1 | The window used to display the sheet displays formulas. | + +**C - fDspGridSv (1 bit):** A bit that specifies whether the window used to display the sheet displays gridlines. + +**D - fDspRwColSv (1 bit):** A bit that specifies whether the window used to display the sheet displays row and column headings. MUST be 0 for dialog sheets. + +**E - fDspGutsSv (1 bit):** A bit that specifies whether outline symbols are displayed. MUST be 0 for dialog sheets. MUST be 1 for [**macro sheets**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491). + +**F - fDspZerosSv (1 bit):** A bit that specifies whether the window used to display the sheet displays zero values or suppresses display of zero values. MUST be 0 for dialog sheets. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The window used to display the sheet displays zero values. | +| 1 | The window used to display the sheet suppresses display of zero values. | + +**G - fHorizontal (1 bit):** A bit that specifies whether the sheet is centered between the horizontal margins when printed. + +**H - fVertical (1 bit):** A bit that specifies whether the sheet is centered between the vertical margins when printed. + +**I - fPrintRwCol (1 bit):** A bit that specifies whether to print the row and column headings. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fPrintIncl** field value of 0. + +**J - fPrintGrid (1 bit):** A bit that specifies whether to print the gridlines. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equals to the **guid** of this record has the **fPrintIncl** field value of 0. + +**K - fFitToPage (1 bit):** A bit that specifies whether the [**fit to page**](#gt_5245d03e-06db-43aa-9752-60a624fc6338) option is enabled. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fPrintIncl** field value of 0. + +**L - fPrintArea (1 bit):** A bit that specifies whether there is at least one [**print area**](#gt_5832abeb-7b03-49db-8cf0-512745131ff5) on the sheet. If the value of **fOnePrintArea** is 1, the value of **fPrintArea** MUST be 1. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fPrintIncl** field value of 0. + +Additionally, if **fPrintArea** is 1, there MUST exist an [Lbl](#lbl) record for the print area as specified in the description for the **fPrintIncl** field in UserBView. + +**M - fOnePrintArea (1 bit):** A bit that specifies whether there is only one print area on the sheet. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fPrintIncl** field value of 0. + +Additionally, if **fOnePrintArea** is 1, there MUST exist an Lbl record for the print area as specified in the description for the **fPrintIncl** field in UserBView. + +**N - fFilterMode (1 bit):** A bit that specifies whether there are [**hidden cells**](#gt_cde68c21-0bab-4e40-8b24-5954ff12fae2) because of filtering. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fRowColIncl** field value of 0. + +Additionally, if **fFilterMode** is 1, there MUST exist an Lbl record for the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) being filtered as specified in the description for the **fRowColIncl** field in UserBView. There can exist an Lbl record for the range containing [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) criteria as specified in the description for the fRowColIncl field in UserBView. + +**O - fEzFilter (1 bit):** A bit that specifies whether the [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) icon is shown on the sheet. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fRowColIncl** field value of 0. + +Additionally, if **fEzFilter** is 1, there MUST exist an Lbl record for the range being filtered as specified in the description for the **fRowColIncl** field in UserBView. There can exist an Lbl record for the range containing filter criteria as specified in the description for the fRowColIncl field in UserBView. + +**P - fFrozen (1 bit):** A bit that specifies whether the [**panes**](#gt_fa363a22-6c89-4829-86aa-09f939f40a54) in the window used to display the sheet are [**frozen**](#gt_1e984b7c-9760-4832-88c8-798e30f845db). If the value of **fFrozenNoSplit** is 1, the value of **fFrozen** MUST be 1. + +**Q - fFrozenNoSplit (1 bit):** A bit that specifies whether the panes in the window used to display the sheet are [**frozen panes**](#gt_28507dfc-4443-4a02-a18c-27b5db006946) but are not [**split panes**](#gt_03a3359c-d8a8-4988-ace6-369a2ae4ff82). + +**R - fSplitV (1 bit):** A bit that specifies whether the window used to display the sheet is split vertically. + +**S - fSplitH (1 bit):** A bit that specifies whether the window used to display the sheet is split horizontally. + +**T - fHiddenRw (2 bits):** An unsigned integer that specifies the state of [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) rows, excluding the filtered rows. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Indicates a [**hidden row**](#gt_3833addc-1f77-4c64-856c-c1b967fdaa75) is present. | +| 0x1 | Indicates a hidden row is not present. | + +MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fRowColIncl** field value of 0. + +Additionally, if **fHiddenRw** is 1, there MUST exist an Lbl record for the hidden rows as specified in the description for the **fRowColIncl** field in UserBView. + +**U - fHiddenCol (1 bit):** A bit that specifies whether there is at least one [**hidden column**](#gt_ea5c8135-254e-407c-999b-5cf39e709164) in the sheet. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fRowColIncl** field value of 0. + +Additionally, if **fHiddenRw** is 1, there MUST exist an Lbl record for the hidden columns as specified in the description for the **fRowColIncl** field in UserBView. + +**V - unused1 (3 bits):** Undefined and MUST be ignored. + +**W - fFilterUnique (1 bit):** A bit that specifies whether the sheet has the [**advanced filter**](#gt_31065343-5514-44e3-884d-9b16ddd36176) enabled and is displaying only unique rows. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fRowColIncl** field value of 0. + +Additionally, if **fFilterUnique** is 1, there MUST exist an Lbl record for the range being filtered as specified in the description for the **fRowColIncl** field in UserBView. There can exist an Lbl record for the range containing filter criteria as specified in the description for the fRowColIncl field in UserBView. + +**X - fSheetLayoutView (1 bit):** A bit that specifies whether the sheet is in the [**Page Break Preview view**](#gt_a7342c25-b4fd-4c84-9922-ae9c4a92d180). Only one of this value or the value of **fPageLayoutView** can be 1. If both values are 0, the custom view is in the [**Normal view**](#gt_b3c343ae-05ca-4b91-9cc1-383ee3563990). MUST be 0 for dialog sheets and macro sheets. + +**Y - fPageLayoutView (1 bit):** A bit that specifies whether the sheet is in the [**Page Layout view**](#gt_c5ea3e6c-db72-4a85-b273-596e95a3841e). MUST be 0 for dialog sheets and macro sheets. + +**Z - unused2 (1 bit):** Undefined and MUST be ignored. + +**a - fRuler (1 bit):** A bit that specifies whether the [**ruler**](#gt_03895998-6780-4615-8795-0fda97bd6379) is displayed. + +**b - reserved5 (2 bits):** MUST be zero, and MUST be ignored. + +**ref8TopLeft (8 bytes):** A [Ref8U](#ref8u) structure that specifies the [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) area of the [**logical top-left**](#gt_88b25c47-61c2-44de-abb0-12ea3348a412) pane. + +**operNumX (8 bytes):** A [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d) that specifies the left-to-right position of the start of the split pane expressed as a column number. The value MUST be greater than or equal to 0. The sum of this value and the value of **ref8TopLeft**.**colFirst** MUST be less than or equal to 256. + +**operNumY (8 bytes):** A floating-point number that specifies the top-to-bottom position of the start of the split pane expressed as a row number. The value MUST be greater than or equal to 0. The sum of this value and the value of **ref8TopLeft**.**rowFirst** MUST be less than or equal to 65536. + +**colRPane (2 bytes):** An unsigned integer that specifies the first visible column of the [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) pane. MUST be 65535 or less than or equal to 255. If the value of the **fSplitV** field is 1, the value of **colRPane** MUST be 65535. If the value of the **fSplitV** field is 0, the value of **colRPane** MUST be less than or equal to 255. + +**rwBPane (2 bytes):** An unsigned integer that specifies the first visible row of the bottom pane. If the value of the **fSplitH** field is 1, the value of **rwBPane** MUST be 65535. + +### UserSViewBegin_Chart + +The **UserSViewBegin_Chart** record specifies [**custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4) settings for the current [**chart sheet**](#gt_da561b7b-c629-4cd8-bfaa-6e62471d9e83) and that specifies the beginning of a collection of records as defined by the [Chart Sheet substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies custom view settings for the current chart sheet. There is an associated [UserBView](#userbview) record, specified by the **guid** field, that specifies custom view settings that apply to the whole [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
guid (16 bytes)
...
...
iTabid
wScale
reserved1
unused1
reserved2Areserved3BC
unused2
...
unused3
...
unused4
...
unused5unused6
+ +**guid (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1), as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2), that specifies the association with a UserBView. MUST equal the value of the **guid** field of the UserBView record. + +**iTabid (4 bytes):** A [TabId](#tabid) structure that specifies the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) of this custom view. + +**wScale (4 bytes):** An unsigned integer that specifies the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) of the window used to display the sheet. MUST be greater than or equal to 10 and less than or equal to 400. + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +**reserved2 (22 bits):** MUST be zero, and MUST be ignored. + +**A - hsState (2 bits):** An unsigned integer that specifies the [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) state of the chart sheet. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The chart sheet is [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72). | +| 0x1 | The chart sheet is hidden. | +| 0x2 | Very Hidden; the sheet is hidden and cannot be displayed using the user interface. | + +**reserved3 (6 bits):** MUST be zero, and MUST be ignored. + +**B - fZoomToFit (1 bit):** A bit that specifies whether the zoom level is set to "Zoom to Fit Selection". SHOULD[\<141\>](#Appendix_A_141) be 1 if the current zoom level specified by the **wScale** field fits the current [**selection**](#gt_8a241461-3c59-45fb-9094-b6692a0c27fe). + +**C - reserved4 (1 bit):** MUST be zero, and MUST be ignored. + +**unused2 (8 bytes):** Undefined and MUST be ignored. + +**unused3 (8 bytes):** Undefined and MUST be ignored. + +**unused4 (8 bytes):** Undefined and MUST be ignored. + +**unused5 (2 bytes):** Undefined and MUST be ignored. + +**unused6 (2 bytes):** Undefined and MUST be ignored. + +### UserSViewEnd + +The **UserSViewEnd** record specifies the end of a collection of records, as defined by the [common productions](#Section_a1b3d8b4744241fd9c57bbd2a6394082) substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) and the [Dialog Sheet substream](#Section_da37feb48b9a462d87772a5fddd4866e) ABNF. The collection of records specifies a collection of [**custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4) records. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
reserved
+ +**reserved (2 bytes):** MUST be 1, and MUST be ignored. + +### UsesELFs + +The **UsesELFs** record specifies whether the file supports [**natural language formulas**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
useselfs
+ +**useselfs (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the file supports natural language formulas. The value SHOULD[\<142\>](#Appendix_A_142) be 0x0000. + +### UsrChk + +The **UsrChk** record specifies the version information for the last user who opened the [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
versionreserved
+ +**version (2 bytes):** An unsigned integer that specifies the [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) version that was used by the last user to open the shared workbook. The value MUST be a value from the following table: + +| Value | Meaning | +|--------|-------------------------------------------------------| +| 0x0200 | [**BIFF2**](#gt_c0c2618b-ae39-4e3d-9615-4b71d8fb888a) | +| 0x0300 | [**BIFF3**](#gt_3b9d80df-ea32-495e-b43b-fa8a6d942ab9) | +| 0x0400 | [**BIFF4**](#gt_d99263f5-d806-4c42-9923-00c72054162a) | +| 0x0500 | [**BIFF5**](#gt_1448958e-abe8-40f3-9d71-40500c3cf9a3) | +| 0x0600 | [**BIFF8**](#gt_e60b71bb-c66c-4a44-ab07-0f9f20ee3dd5) | + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +### UsrExcl + +The **UsrExcl** record specifies whether a user has acquired an exclusive lock on the [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc) and that specifies the beginning of a collection of records as defined by the [revision](#Section_d120a1ffd2e6488381a507236f1994b0) stream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies properties for a shared workbook. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
fExclusive
sdtr
...
cchUserstUser (variable)
...
+ +**fExclusive (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the user has an exclusive lock on the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The value MUST be a value from the following table: + +| Value | Meaning | +|------------|-----------------------------------------------------------| +| 0x00000000 | The user does not have an exclusive lock on the workbook. | +| 0x00000001 | The user has an exclusive lock on the workbook. | + +**sdtr (8 bytes):** A [ShortDTR](#shortdtr) structure that specifies the date and time when **fExclusive** was set to 0x00000001. + +**cchUser (2 bytes):** An unsigned integer that specifies the number of characters in **stUser** that are used to specify the name of the user who has [**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81) the workbook. Characters in **stUser** that are to the right of these used characters are ignored. MUST be less than or equal to 0x0036. + +**stUser (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of the user who has locked the workbook. The count of characters MUST be 147. + +### UsrInfo + +The **UsrInfo** record specifies information about a user who currently has the [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc) open. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
lUsrId
guid (16 bytes)
...
...
shortdtr
...
stUserName (variable)
...
unused
+ +**lUsrId (4 bytes):** A signed integer that specifies a unique user identifier for this user. + +**guid (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1), as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2), that specifies the last set of revisions synced to by this user. + +**shortdtr (8 bytes):** A [ShortDTR](#shortdtr) structure that specifies the date and time this user opened the shared workbook. + +**stUserName (variable):** A [XLUnicodeString](#xlunicodestring) structure that specifies the name of this user. The number of characters in this string MUST be greater than or equal to 1 and less than or equal to 54. + +**unused (1 byte):** Undefined and MUST be ignored. + +### ValueRange + +The **ValueRange** record specifies the properties of a value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
numMin
...
numMax
...
numMajor
...
numMinor
...
numCross
...
ABCDEFGHunused
+ +**numMin (8 bytes):** An Xnum (section [2.5.342](#xnum)) structure that specifies the minimum value of the value axis. MUST be less than the value of **numMax**. If the value of **fAutoMin** is 1, this field MUST be ignored. + +**numMax (8 bytes):** An Xnum structure that specifies the maximum value of the value axis. MUST be greater than the value of **numMin**. If the value of **fAutoMax** is 1, this field MUST be ignored. + +**numMajor (8 bytes):** An Xnum structure that specifies the interval at which [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) and [**major gridlines**](#gt_2803347c-6396-46a5-9ede-6bef1149b013) are displayed. MUST be greater than or equal to the value of **numMinor**. If the value of **fAutoMajor** is 1, this field MUST be ignored. + +**numMinor (8 bytes):** An Xnum structure that specifies the interval at which [**minor tick marks**](#gt_c2eb605a-6c5a-427e-8608-f16940de82a6) and [**minor gridlines**](#gt_49980976-6314-43ad-ad51-8d3e55ef4b59) are displayed. MUST be greater than or equal to zero. If the value of **fAutoMinor** is 1, this field MUST be ignored. + +**numCross (8 bytes):** An Xnum structure that specifies at which value the other axes in the [axis group](#Section_578b739742624944b5a67ee6d4d3bb55) cross this value axis. If the value of **fAutoCross** is 1, this field MUST be ignored. + +**A - fAutoMin (1 bit):** A bit that specifies whether **numMin** is calculated automatically. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **numMin** is used as the minimum value of the value axis. | +| 1 | **numMin** is calculated such that the [data point](#Section_9c986ad250d44fa1a157063ac5c971a0) with the minimum value can be displayed in the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). | + +**B - fAutoMax (1 bit):** A bit that specifies whether **numMax** is calculated automatically. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **numMax** is used as the maximum value of the value axis. | +| 1 | **numMax** is calculated such that the data point with the maximum value can be displayed in the plot area. | + +**C - fAutoMajor (1 bit):** A bit that specifies whether **numMajor** is calculated automatically. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **numMajor** is used as the interval at which major tick marks and major gridlines are displayed. | +| 1 | **numMajor** is calculated automatically. | + +**D - fAutoMinor (1 bit):** A bit that specifies whether **numMinor** is calculated automatically. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **numMinor** is used as the interval at which minor tick marks and minor gridlines are displayed. | +| 1 | **numMinor** is calculated automatically. | + +**E - fAutoCross (1 bit):** A bit that specifies whether **numCross** is calculated automatically. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **numCross** is used as the point at which the other axes in the axis group cross this value axis. | +| 1 | **numCross** is calculated so that the crossing point is displayed in the plot area. | + +**F - fLog (1 bit):** A bit that specifies whether the value axis has a logarithmic scale. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The scale of the value axis is linear. | +| 1 | The scale of the value axis is logarithmic. The default base of the logarithmic scale is 10, unless a [CrtMlFrt](#crtmlfrt) record follows this record, specifying the base in a [XmlTkLogBaseFrt](#xmltklogbasefrt) structure. | + +**G - fReversed (1 bit):** A bit that specifies whether the values on the value axis are displayed in reverse order. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Values are displayed from smallest-to-largest, from left-to-right, or from bottom-to-top, respectively, depending on the orientation of the axis. | +| 1 | The values are displayed in reverse order, meaning largest-to-smallest, from left-to-right, or from bottom-to-top, respectively. | + +**H - fMaxCross (1 bit):** A bit that specifies whether the other axes in the axis group cross this value axis at the maximum value. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The other axes in the axis group cross this value axis at the value specified by **numCross**. | +| 1 | The other axes in the axis group cross the value axis at the maximum value. If **fMaxCross** is 1, then both **fAutoCross** and **numCross** MUST be ignored. | + +**unused (8 bits):** Undefined and MUST be ignored. + +### VCenter + +The **VCenter** record specifies whether the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) is centered vertically when printed. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
vcenter
+ +**vcenter (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the sheet is centered between [TopMargin](#topmargin) and [BottomMargin](#bottommargin) when printed. + +### VerticalPageBreaks + +The **VerticalPageBreaks** record specifies a list of all explicit column [**page breaks**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871) in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cbrkrgbrk (variable)
...
+ +**cbrk (2 bytes):** An unsigned integer that specifies the number of page breaks. The value MUST be less than or equal to 255. + +**rgbrk (variable):** An array of [VertBrk](#vertbrk) that specifies all of the page breaks. The array MUST be sorted first by the **col** value and then by the **RowStart** value in each VertBrk. Two page breaks MUST NOT overlap. The number of VertBrk MUST equal the value of **cbrk**. + +### WebPub + +The **WebPub** record specifies the information for a single [**published**](#gt_8ffc383a-d4f1-4515-a8b5-874d84ab2d2b) Web page. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtRefHeaderU
...
...
twstwdABCDreserved2
reserved3unused2
nStyleId
cb
srcName (variable)
...
stFileDest (variable)
...
stDivId (variable)
...
stTitle (variable)
...
crtID (optional)
frtRgb (variable)
...
unused3
+ +**frtRefHeaderU (12 bytes):** An [FrtRefHeaderU](#frtrefheaderu) structure. If the value of **tws** is 4, then **frtRefHeaderU.ref8** specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells associated with this record and **frtRefHeaderU.grbitFrt.fFrtRef** MUST be 1. If the value of **tws** is not 4, then **frtRefHeaderU.grbigFrt.fFrtRef** MUST be zero. + +**tws (1 byte):** An unsigned integer that specifies the type of Web source that was published. It MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0xFF | The source is undefined. | +| 0x00 | [**Workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) | +| 0x01 | Entire [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) | +| 0x02 | [**Print area**](#gt_5832abeb-7b03-49db-8cf0-512745131ff5) | +| 0x03 | [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) range | +| 0x04 | Range of cells | +| 0x05 | Chart | +| 0x06 | [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) report | +| 0x07 | [**Query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) ([**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) range) | +| 0x08 | [**Named range**](#gt_042582ea-4050-4e5c-a2df-ae39706a19b6) | + +**twd (1 byte):** An unsigned integer that specifies the type of Web page created and whether the item is static or interactive. It MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------| +| 0x00 | Non-interactive page, only for viewing | +| 0x01 | Uses workbook functionality | +| 0x02 | Uses PivotTable functionality | +| 0x03 | Uses chart functionality | + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - fAutoRepublish (1 bit):** This bit specifies whether to republish the Web page when it is saved. + +**C - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**D - fMhtml (1 bit):** This bit specifies whether the file is published as a single Web page or as a Web page with references to other files. + +**reserved2 (12 bits):** MUST be zero and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**nStyleId (4 bytes):** An unsigned integer that specifies the unique identifier for this published content. + +**cb (4 bytes):** An unsigned integer that specifies the size of the data that follows in this record according to the following formula: + +size of **srcName** + size of **stFileDest** + size of **stDivId** + size of **stTitle** + size of **crtID** + size of **frtRGB** + size of **unused3** + +The value MUST be greater than 0. + +**srcName (variable):** A [WebPubString](#webpubstring) structure that specifies the named range to be published. The field MUST exist if and only if the value of **tws** is greater than 4. The character count in the string MUST be less than or equal to 255. + +**stFileDest (variable):** A WebPubString structure that specifies the [**URL**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) or the path to the location of the published page. The character count in the string MUST be less than or equal to 255. + +**stDivId (variable):** A WebPubString structure that specifies the destination bookmark of the published page. The character count in the string MUST be less than or equal to 255. + +**stTitle (variable):** A WebPubString structure that specifies the title of the [**published item**](#gt_14dfffe3-13a6-4c5f-b1d8-22e1e241634f). + +**crtID (4 bytes):** An MSOSPID structure, as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872), that specifies the published chart object. This field MUST exist if and only if **tws** equals 5. + +**frtRgb (variable):** A binary stream that specifies the bytes reserved for future use. The size of this field in bytes is calculated according to the following formula: + +size of this record – 30 – size of **srcName** – size of **stFileDest** – size of **stDivId** – size of **stTitle** – size of **crtID**[**\<143\>**](#Appendix_A_143) + +**unused3 (2 bytes):** Undefined and MUST be ignored. + +### Window1 + +The **Window1** record specifies attributes of a window used to display a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) (called "the window" within this record definition). For each Window1 record in the Globals Substream there MUST be an associated [Window2](#window2) record in each [chart sheet](#Section_732ff614d939416bb7c76d983471ff11), [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56), [macro sheet](#Section_0dddd943f77a4fc2bf92868acb4587f7), and [dialog sheet](#Section_da37feb48b9a462d87772a5fddd4866e) substream that exists in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The Window2 record in a given substream associated with a given Window1 record is the Window2 record whose ordinal position in the collection of Window2 records in the containing substream is equal to the ordinal position of the given Window1 record in the collection of Window1 records in the [Globals Substream](#globals-substream). Each Window2 record specifies extended properties of the associated Window1 record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xWnyWn
dxWndyWn
ABCDEFGreserveditabCur
itabFirstctabSel
wTabRatio
+ +**xWn (2 bytes):** A signed integer that specifies the horizontal position, in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382), of the window. The value is relative to the [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) edge of the [**client area**](#gt_623ea69b-ffdb-4751-8751-2cbf4cc11f08) of the window. + +**yWn (2 bytes):** A signed integer that specifies the vertical position, in twips, of the window. The value is relative to the top edge of the client area of the window. + +**dxWn (2 bytes):** A signed integer that specifies the width, in twips, of the window. MUST be greater than or equal to 1. + +**dyWn (2 bytes):** A signed integer that specifies the height, in twips, of the window. MUST be greater than or equal to 1. + +**A - fHidden (1 bit):** A bit that specifies whether the window is in the list of [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) windows. + +**B - fIconic (1 bit):** A bit that specifies whether the window is minimized. + +**C - fVeryHidden (1 bit):** A bit that specifies whether the window has the properties of **fHidden** and that also specifies that the user cannot see that the window is in the list of hidden windows. + +**D - fDspHScroll (1 bit):** A bit that specifies whether a horizontal scroll bar is displayed. + +**E - fDspVScroll (1 bit):** A bit that specifies whether a vertical scroll bar is displayed. + +**F - fBotAdornment (1 bit):** A bit that specifies whether [**sheet tabs**](#gt_3b131045-238c-4ce8-9c22-b6aac874c7c5) are displayed. + +**G - fNoAFDateGroup (1 bit):** A bit that specifies whether dates are grouped hierarchically in the [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) menu or listed chronologically in the AutoFilter menu. + +| Value | Meaning | +|-------|------------------------------------------------------------------| +| 0 | Dates are grouped by year, month and day in the AutoFilter menu. | +| 1 | Dates are listed chronologically in the AutoFilter menu. | + +**reserved (9 bits):** MUST be zero, and MUST be ignored. + +**itabCur (2 bytes):** A [TabIndex](#tabindex) structure that specifies the [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) sheet tab. + +**itabFirst (2 bytes):** A TabIndex structure that specifies the first displayed sheet tab. + +**ctabSel (2 bytes):** An unsigned integer that specifies the number of sheet tabs that are selected. The value MUST be less than or equal to the number of sheets in the workbook. Each [**sheet stream**](#gt_ed6406c5-331a-443d-a472-3666215c18fd) in the [workbook stream](#Section_f682f4b08c6b444e83f852d156f1e8ba) specifies a sheet. + +**wTabRatio (2 bytes):** An unsigned integer that specifies the ratio of the width of the sheet tabs to the width of the horizontal scroll bar, multiplied by 1000. MUST be less than or equal to 1000. + +### Window2 + +The **Window2** record specifies attributes of the window used to display a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and that specifies the beginning of a collection of records as defined by the [Chart Sheet substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), [Macro Sheet substream](#Section_0dddd943f77a4fc2bf92868acb4587f7) ABNF, and [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF. The collection of records specifies the settings of a [**Page Layout view**](#gt_c5ea3e6c-db72-4a85-b273-596e95a3841e) for a sheet, the zoom of the current view, the position of either [**frozen panes**](#gt_28507dfc-4443-4a02-a18c-27b5db006946) or [**unfrozen panes**](#gt_172b6800-45a6-4d45-938b-0f21abf83672), and the [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the sheet. When this record is contained in a macro sheet substream or a worksheet substream, it has a length of 18 bytes. When this record is contained in a chart sheet substream, it has a length of 10 bytes (which are the first 10 bytes of the original 18-byte record) and only the **fSelected** field is used. This record specifies extended properties of an associated [Window1](#window1) record, and that association is specified in Window1. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEFGHIJKLMrwTop
colLefticvHdr
reserved2wScaleSLV
wScaleNormalunused
reserved3
+ +**A - fDspFmlaRt (1 bit):** A bit that specifies whether the window displays formulas (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) or values. If the value is 1, the window displays formulas (section 2.2.2). This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**B - fDspGridRt (1 bit):** A bit that specifies whether the window displays [**gridlines**](#gt_82f8a326-64b0-4506-a18e-930f7c2c95b9). + +| Value | Meaning | +|-------|----------------------------------------| +| 0 | The window does not display gridlines. | +| 1 | The window displays gridlines. | + +This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**C - fDspRwColRt (1 bit):** A bit that specifies whether the window displays row headings and column headings. + +| Value | Meaning | +|-------|---------------------------------------------------------------| +| 0 | The window does not display row headings and column headings. | +| 1 | The window displays row headings and column headings. | + +This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**D - fFrozenRt (1 bit):** A bit that specifies whether the panes in the window are [**frozen**](#gt_1e984b7c-9760-4832-88c8-798e30f845db). The value MUST be 0 if either the value of **colLeft** is 255 or the value of **rwTop** is 65535. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**E - fDspZerosRt (1 bit):** A bit that specifies whether the window displays zero values. + +| Value | Meaning | +|-------|----------------------------------------------------------------| +| 0 | The window displays cells that have a value of zero as blank. | +| 1 | The window displays cells that have a value of zero as a zero. | + +This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**F - fDefaultHdr (1 bit):** A bit that specifies whether the gridlines of the window are drawn in the window's default [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) or in the color specified by the value of **icvHdr**. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +| Value | Meaning | +|----|----| +| 0 | Gridlines of the window are drawn in the color specified by the value of **icvHdr**. | +| 1 | Gridlines of the window are drawn in the default foreground color of the window. | + +**G - fRightToLeft (1 bit):** A bit that specifies whether the text is displayed in [**right-to-left**](#gt_91359688-7863-4e88-b507-f57b3dada5ec) mode in the window. + +| Value | Meaning | +|----|----| +| 0 | The text is displayed in [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067) mode. | +| 1 | The text is displayed in right-to-left mode. | + +This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**H - fDspGuts (1 bit):** A bit that specifies whether the window displays the [**outline state**](#gt_595fa0de-0130-489d-ba83-fbba78917310). This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**I - fFrozenNoSplit (1 bit):** A bit that specifies whether the panes in the window are frozen without [**pane**](#gt_fa363a22-6c89-4829-86aa-09f939f40a54) splits or frozen with pane splits. If the value of **fFrozenRt** is 0, the value of **fFrozenNoSplit** MUST be 0. + +| Value | Meaning | +|-------|---------------------------------------------------------| +| 0 | The panes in the window are frozen with pane splits. | +| 1 | The panes in the window are frozen without pane splits. | + +This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**J - fSelected (1 bit):** A bit that specifies whether the [**sheet tab**](#gt_3b131045-238c-4ce8-9c22-b6aac874c7c5) is selected. + +**K - fPaged (1 bit):** A bit that specifies whether the sheet is currently being displayed in the window. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**L - fSLV (1 bit):** A bit that specifies whether the sheet is in [**Page Break Preview view**](#gt_a7342c25-b4fd-4c84-9922-ae9c4a92d180). This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**M - reserved1 (4 bits):** MUST be zero, and MUST be ignored. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**rwTop (2 bytes):** A [RwU](#rwu) structure that specifies a zero-based row index of the first [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) row of the sheet. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**colLeft (2 bytes):** A [ColU](#colu) structure that specifies a zero-based column index of the [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d)-most visible column. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**icvHdr (2 bytes):** An [Icv](#icv) structure that specifies the color of the gridlines. MUST be less than or equal to 64. MUST be 64 if and only if the value of **fDefaultHdr** is 1. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**wScaleSLV (2 bytes):** An unsigned integer that specifies the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) in the Page Break Preview view. If the value of **fSLV** is 1 and this record has an associated [Scl](#scl) as specified in the ABNF in [Common Productions](#Section_a1b3d8b4744241fd9c57bbd2a6394082), the value of **wScaleSLV** is undefined and MUST be ignored. MUST[\<144\>](#Appendix_A_144) be either 0 or greater than or equal to 10 and less than or equal to 400. A value of 0 specifies the default zoom level. This field MUST NOT exist if this record is contained in a chart sheet substream. + +**wScaleNormal (2 bytes):** An unsigned integer that specifies the zoom level in the [**Normal view**](#gt_b3c343ae-05ca-4b91-9cc1-383ee3563990). If the value of **fSLV** is 0 and the value of the **fPageLayoutView** field of the [PLV](#plv), as specified in the ABNF in Common Productions, is 0 and this record has an associated Scl, then the value of **wScaleNormal** is undefined and MUST be ignored. MUST[\<145\>](#Appendix_A_145) be either 0 or greater than or equal to 10 and less than or equal to 400. A value of 0 specifies the default zoom level. This field MUST NOT exist if this record is contained in a chart sheet substream. + +**unused (2 bytes):** Undefined and MUST be ignored. This field MUST NOT exist if this record is contained in a chart sheet substream. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. This field MUST NOT exist if this record is contained in a chart sheet substream. + +### WinProtect + +The **WinProtect** record specifies whether the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) windows can be resized or moved and whether the [**window state**](#gt_b470d08f-cbdd-49db-a2e0-08bb9a04d503) can be changed. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
fLockWn
+ +**fLockWn (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the windows can be resized or moved and whether the window state can be changed. It MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The workbook windows can be resized or moved and the window state can be changed. | +| 0x0001 | The workbook windows cannot be resized or moved and the window state cannot be changed. | + +### WOpt + +The **WOpt** record specifies options for saving as a Web page. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
ABCDEFreserved1screenSizereserved2
dwPixelsPerInch
uiCodePage
rgbLocationOfComponents (variable)
...
rgbFuture (variable)
...
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The value of the **frtHeaderOld.rt** field MUST be 0x080B. + +**A - fRelyOnCSS (1 bit):** A bit that specifies whether [**cascading style sheets (CSS)**](#gt_22155692-26b0-4146-9737-ef43f4b31305) is used for [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) formatting when viewing the saved file in a Web browser. + +**B - fOrganizeInFolder (1 bit):** A bit that specifies whether all supporting files, such as background textures and graphics, are organized in a separate [**folder**](#gt_6afebb3e-5358-4ab8-b0fc-fcc8de47fcc1) when saving this file as a Web page. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------------------------| +| 0 | All supporting files are saved in the same folder as the Web page. | +| 1 | All supporting files are organized in a separate folder. | + +**C - fUseLongFileNames (1 bit):** A bit that specifies whether [**long file names**](#gt_7d480c8b-0dfe-4c54-8d8d-5e8718a8c638) are used when saving this file as a Web page. + +**D - fDownloadComponents (1 bit):** A bit that specifies whether the necessary [**Microsoft Office Web Components**](#gt_c362a2c8-f385-404c-8967-3143d111bb97) are downloaded if they are not installed when viewing the saved file in a Web browser. + +**E - fRelyOnVML (1 bit):** A bit that specifies whether the application uses [**VML**](#gt_eb6b7893-b656-4b91-8fab-51fd1cf28a38) to display graphics in a Web browser. + +**F - fAllowPNG (1 bit):** A bit that specifies whether Portable Network Graphics (PNG) format is allowed as an image format when saving this file as a Web page. + +**reserved1 (10 bits):** MUST be zero, and MUST be ignored. + +**screenSize (1 byte):** A **WebScreenSizeEnum**, as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.4, that specifies the ideal minimum screen size of the target monitor used to view the saved file in a Web browser. + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +**dwPixelsPerInch (4 bytes):** An unsigned integer that specifies the density, in pixels per inch, of graphics images and [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) cells when saving this file as a Web page. The value MUST be greater than or equal to 19 and less than or equal to 480. + +**uiCodePage (4 bytes):** An unsigned integer that specifies the [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38). The value MUST be one of the code page values specified in [\[CODEPG\]](https://go.microsoft.com/fwlink/?LinkId=89840), to be used by the Web browser when viewing the saved file. + +**rgbLocationOfComponents (variable):** An [LPWideString](#lpwidestring) structure that specifies the [**URL**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) or the file path to the location from which authorized users can download Microsoft Office Web Components when viewing the saved file as a Web page. The value of **rgbLocationOfComponents.cch** MUST be less than or equal to 2083. + +**rgbFuture (variable):** A binary stream that specifies the bytes reserved for future use. The size of this field in bytes is calculated according to the following formula: + +size of this record – 16 – size of **rgbLocationOfComponents** + +### WriteAccess + +The **WriteAccess** record specifies the name of the user who last created, opened, or modified the file. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
userName (variable)
...
unused (variable)
...
+ +**userName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the [**user name**](#gt_c298446e-09d2-470d-a70f-5249dafa15c6). The value of **userName.cch** MUST be less than or equal to 54. If the value of **userName.rgb** is equal to "\0x20\0x20" no user name is specified. + +**unused (variable):** Undefined and MUST be ignored. The size of this field in bytes + +MUST be equal to the value of the following formula: (112 – number of bytes of **userName**). + +### WriteProtect + +The existence of the **WriteProtect** record specifies that the file is write-[**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829). + +### WsBool + +The **WsBool** record specifies information about a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ABCDEFGHIJKLM
+ +**A - fShowAutoBreaks (1 bit):** A bit that specifies whether [**page breaks**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871) inserted automatically are [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) on the sheet. + +**B - reserved1 (3 bits):** MUST be zero, and MUST be ignored. + +**C - fDialog (1 bit):** A bit that specifies whether the sheet is a [**dialog sheet**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8). + +**D - fApplyStyles (1 bit):** A bit that specifies whether to apply styles in an [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) when an outline is applied. + +**E - fRowSumsBelow (1 bit):** A bit that specifies whether summary rows appear below an outline's detail rows. + +**F - fColSumsRight (1 bit):** A bit that specifies whether summary columns appear to the right or left of an outline's detail columns. Valid values are specified in the following table: + +| Value | Meaning | +|----|----| +| 0 | The summary columns appear to the right, if the sheet is displayed [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067), or appear to the left, if the sheet is displayed [**right-to-left**](#gt_91359688-7863-4e88-b507-f57b3dada5ec). | +| 1 | The summary columns appear to the left, if the sheet is displayed left-to-right, or appear to the right, if the sheet is displayed right-to-left. | + +**G - fFitToPage (1 bit):** A bit that specifies whether to fit the printable contents to a single page when printing this sheet. + +**H - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**I - unused (2 bits):** Undefined and MUST be ignored. + +**J - fSyncHoriz (1 bit):** A bit that specifies whether horizontal scrolling is synchronized across multiple windows displaying this sheet. + +**K - fSyncVert (1 bit):** A bit that specifies whether vertical scrolling is synchronized across multiple windows displaying this sheet. + +**L - fAltExprEval (1 bit):** A bit that specifies whether the sheet uses [**transition formula evaluation**](#gt_47a54c6a-a541-44ae-a0a9-acf78ab8a331). + +**M - fAltFormulaEntry (1 bit):** A bit that specifies whether the sheet uses [**transition formula entry**](#gt_fd2c615c-ad67-4b97-bde4-7827b37196eb). + +### XCT + +The **XCT** record specifies the beginning of an [external cell cache](#Section_b985d1a223f3483ebebdbd0e882d4c89) and that specifies the beginning of a collection of [CRN](#crn) records as defined in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of CRN records specifies the values of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the external cell cache. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccrnitab (optional)
+ +**ccrn (2 bytes):** A signed integer of which the absolute value specifies the number of CRN records immediately following this record. A value less than zero specifies that the most recent [SupBook](#supbook) preceding this record contains a link that is not valid. + +**itab (2 bytes):** An unsigned integer that specifies a zero-based index into the **rgst** array of the most recent instance of a SupBook preceding this record in the file. The element of the **rgst** array specified by this field contains the name of the sheet that contains the cached cells. The value of **itab** MUST be less than the value of the **ctab** field of the most recent instance of SupBook. + +### XF + +The **XF** record specifies formatting properties for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) or a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ifntifmt
ABCDixfParentData (variable)
...
+ +**ifnt (2 bytes):** A [FontIndex](#fontindex) structure that specifies a [Font](#font) record. + +**ifmt (2 bytes):** An [IFmt](#ifmt) structure that specifies a [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) identifier. + +**A - fLocked (1 bit):** A bit that specifies whether the [**locked protection**](#gt_10f1ec97-0464-49da-bf78-5339b9d3520c) property is set to true. + +**B - fHidden (1 bit):** A bit that specifies whether the [**hidden protection**](#gt_1b14d877-9a96-485f-8eb8-b2c26f3355cf) property is set to true. + +**C - fStyle (1 bit):** A bit that specifies whether this record specifies a [cell XF](#Section_518a740d71c640c8bb97e7df6915861a) or a [cell style XF](#Section_3d5348ded9df4c31b1fd9f9377273152). If the value is 1, this record specifies a cell style XF. + +**D - f123Prefix (1 bit):** A bit that specifies whether prefix characters are present in the cell. The possible prefix characters are single quote (0x27), double quote (0x22), caret (0x5E), and backslash (0x5C).[\<146\>](#Appendix_A_146) If **fStyle** equals 1, this field MUST equal 0. + +**ixfParent (12 bits):** An unsigned integer that specifies the zero-based index of a cell style XF record in the collection of XF records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) that this cell format inherits properties from. Cell style XF records are the subset of XF records with an **fStyle** field equal to 1. See [XFIndex](#xfindex) for more information about the organization of XF records in the file. + +If **fStyle** equals 1, this field SHOULD equal 0xFFF, indicating there is no inheritance from a cell style XF. [\<147\>](#Appendix_A_147) + +**Data (variable):** If the value of **fStyle** equals 0, this field contains a [CellXF](#cellxf) that specifies additional properties of the cell XF. If the value of **fStyle** equals 1, this field contains a [StyleXF](#stylexf) that specifies additional properties of the cell style XF. + +### XFCRC + +The **XFCRC** record specifies the number of [XF](#xf) records contained in this file and that contains a [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the data in those records. This record MUST exist if and only if there are [XFExt](#xfext) records in the file. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
reservedcxfs
crc
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x87C. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**cxfs (2 bytes):** An unsigned integer that specifies the number of XF records in this file. MUST be greater than or equal to 16 and less than or equal to 4050. + +**crc (4 bytes):** An unsigned integer that specifies a checksum, as specified by [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.4.3, of the data portion of the XF records. This checksum is used to detect whether the XF records in the file were modified by an application that does not support the formatting feature extensions in XFExt records. + +### XFExt + +The **XFExt** record specifies a set of formatting property extensions to an [XF](#xf) record in this file. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeader
...
...
reserved1ixfe
reserved2cexts
rgExt (variable)
...
+ +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x087D. + +**reserved1 (2 bytes):** MUST be zero and MUST be ignored. + +**ixfe (2 bytes):** An [XFIndex](#xfindex) structure that specifies the XF record in the file that this record extends. MUST be less than or equal to 4050. + +**reserved2 (2 bytes):** MUST be zero and MUST be ignored. + +**cexts (2 bytes):** An unsigned integer that specifies the number of elements in **rgExt.** + +**rgExt (variable):** An array of [ExtProp](#extprop). Each array element specifies a formatting property extension. + +### YMult + +The **YMult** record specifies properties of the value multiplier for a value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) and that specifies the beginning of a collection of records as defined by the [Chart Sheet substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a [**display units**](#gt_7d807b62-cff1-4e03-a73f-840844345b83) label. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
axmidnumLabelMultiplier
...
...ABCreserved2
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0857. + +**axmid (2 bytes):** A signed integer that specifies the axis multiplier type. MUST be a value from the following table: + +| Value | Multiplier type | +|----|----| +| 0xFFFF (-1) | Custom multiplier, multiplier value MUST be stored in **numLabelMultiplier** | +| 0x0000 | Values on axis are multiplied by 1.0 | +| 0x0001 | Values on axis are multiplied by 100.0 | +| 0x0002 | Values on axis are multiplied by 1000.0 | +| 0x0003 | Values on axis are multiplied by 10,000.0 | +| 0x0004 | Values on axis are multiplied by 100,000.0 | +| 0x0005 | Values on axis are multiplied by 1,000,000.0 | +| 0x0006 | Values on axis are multiplied by 10,000,000.0 | +| 0x0007 | Values on axis are multiplied by 100,000,000.0 | +| 0x0008 | Values on axis are multiplied by 1,000,000,000.0 | +| 0x0009 | Values on axis are multiplied by 1,000,000,000,000.0 | + +**numLabelMultiplier (8 bytes):** An Xnum (section [2.5.342](#xnum)) structure that specifies a custom multiplier. The value on the axis are multiplied by the value of this field. MUST be greater than 0.0. If **axmid** is set to a value other than 0xFFFF, this field is ignored. + +**A - reserved1 (1 bit):** MUST be 1, and MUST be ignored. + +**B - fAutoShowMultiplier (1 bit):** A bit that specifies whether the display units label is displayed. + +**C - fBeingEditted (1 bit):** A bit that specifies whether the display units label is currently being edited. + +**reserved2 (13 bits):** MUST be zero, and MUST be ignored. + +## Structures + +### AddinUdf + +The **AddinUdf** structure specifies the data for a [**UDF**](#gt_5068e37f-372c-41df-9357-1072e12ed970) reference on an [**XLL**](#gt_3d6e3f45-91e7-46d5-871c-0b2fde20b5f5) or [**COM**](#gt_ef2ebebc-1760-407a-9ace-af48f9050e02) [**add-in**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6) in the [ExternName](#externname) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reserved
udfName (variable)
...
cbunused (variable)
...
+ +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +**udfName (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) that specifies the name of the referenced UDF. **udfName.cch** MUST be less than or equal to 255. For COM [**add-in functions**](#gt_19f0478a-919a-4951-b8c0-f9900a1ddd3e) only, it also specifies the [**ProgID**](#gt_06b2ae3d-4106-49f3-9ca0-e2bcd649e75a) of the COM object that implements the add-in function (XLL add-in functions do not have their implementing libraries uniquely specified). + +**cb (2 bytes):** An unsigned integer that specifies the size of **unused** in bytes. + +**unused (variable):** Undefined and MUST be ignored. The size of this field in bytes is specified by **cb**. + +### AF12CellIcon + +The **AF12CellIcon** structure specifies the [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) for an advanced [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) comparison. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iIconSet
iIcon
+ +**iIconSet (4 bytes):** An unsigned integer that specifies the [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9) number. MUST be a value as specified in [KPISets](#kpisets). + +**iIcon (4 bytes):** An unsigned integer that specifies the icon number within the icon set. MUST be a value as specified in the following table: + +| iIconSet value | Valid iIcon values | +|----|----| +| KPINIL (no icon) | 0xFFFFFFFF | +| KPI3ARROWS | 0x00000000, 0x00000001, or 0x00000002 | +| KPI3ARROWSGRAY | 0x00000000, 0x00000001, or 0x00000002 | +| KPI3FLAGS | 0x00000000, 0x00000001, or 0x00000002 | +| KPI3TRAFFICLIGHTS1 | 0x00000000, 0x00000001, or 0x00000002 | +| KPI3TRAFFICLIGHTS2 | 0x00000000, 0x00000001, or 0x00000002 | +| KPI3SIGNS | 0x00000000, 0x00000001, or 0x00000002 | +| KPI3SYMBOLS | 0x00000000, 0x00000001, or 0x00000002 | +| KPI3SYMBOLS2 | 0x00000000, 0x00000001, or 0x00000002 | +| KPI4ARROWS | 0x00000000, 0x00000001, 0x00000002, or 0x00000003 | +| KPI4ARROWSGRAY | 0x00000000, 0x00000001, 0x00000002, or 0x00000003 | +| KPI4REDTOBLACK | 0x00000000, 0x00000001, 0x00000002, or 0x00000003 | +| KPI4RATING | 0x00000000, 0x00000001, 0x00000002, or 0x00000003 | +| KPI4TRAFFICLIGHTS | 0x00000000, 0x00000001, 0x00000002, or 0x00000003 | +| KPI5ARROWS | 0x00000000, 0x00000001, 0x00000002, 0x00000003, or 0x00000004 | +| KPI5ARROWSGRAY | 0x00000000, 0x00000001, 0x00000002, 0x00000003, or 0x00000004 | +| KPI5RATING | 0x00000000, 0x00000001, 0x00000002, 0x00000003, or 0x00000004 | +| KPI5QUARTERS | 0x00000000, 0x00000001, 0x00000002, 0x00000003, or 0x00000004 | + +### AF12Criteria + +The **AF12Criteria** structure specifies the criteria for an advanced [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) comparison. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
doper
...
...str (variable)
...
+ +**doper (10 bytes):** An [AFDOper](#afdoper) that specifies the comparison condition. + +**str (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) that specifies the string value to use for the comparison. MUST exist if and only if **doper.vt** equals 0x06. The length MUST be equal to **doper.vtValue.cch**. + +### AF12DateInfo + +The **AF12DateInfo** structure specifies the date and time for an advanced [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) comparison. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
yearmonth
day
hourminute
secondunused1
reserved1
nodeType
+ +**year (2 bytes):** An unsigned integer that specifies the year. + +**month (2 bytes):** An unsigned integer that specifies the month. MUST be greater than or equal to 1 and less than or equal to 12. + +**day (4 bytes):** An unsigned integer that specifies the day of the month. MUST be greater than or equal to 1[\<148\>](#Appendix_A_148) and less than or equal to 31. + +**hour (2 bytes):** An unsigned integer that specifies the hour. MUST be greater than or equal to 0 and less than or equal to 23. + +**minute (2 bytes):** An unsigned integer that specifies the minute. MUST be greater than or equal to 0 and less than or equal to 59. + +**second (2 bytes):** An unsigned integer that specifies the second. MUST be greater than or equal to 0 and less than or equal to 59. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**nodeType (4 bytes):** An unsigned integer that specifies the date and time to filter on. MUST be one of the values from the table: + +| Value | Meaning | +|----|----| +| 0x00000000 | [**Filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) on **year** field. | +| 0x00000001 | Filter on **year** and **month** fields. | +| 0x00000002 | Filter on **year, month,** and **day** fields. | +| 0x00000003 | Filter on **year, month, day,** and **hour** fields. | +| 0x00000004 | Filter on **year, month, day, hour,** and **minute** fields. | +| 0x00000005 | Filter on **year, month, day, hour, minute,** and **second** fields. | + +### AFDOper + +The **AFDOper** structure specifies an [AutoFilter](#autofilter) data operation. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
vtgrbitSignvtValue
...
...
+ +**vt (1 byte):** An unsigned integer that specifies the type of comparison. MUST be a value as specified in the table listed under **vtValue**. If this structure is part of an [AutoFilter12](#autofilter12) record, the value of **vt** MUST NOT be 0x02. + +**grbitSign (1 byte):** An unsigned integer that specifies the comparison operation between a [**cell value**](#gt_4d48a886-7f1d-4d41-a668-54f7f2f1a966) and **vtValue**. MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x01 | [**Cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) value is displayed if it is less than the value specified in **vtValue.** | +| 0x02 | Cell value is displayed if it is equal to the value specified in **vtValue**. | +| 0x03 | Cell value is displayed if it is less than or equal to the value specified in **vtValue**. | +| 0x04 | Cell value is displayed if it is greater than the value specified in **vtValue.** | +| 0x05 | Cell value is displayed if it is not equal to the value specified in **vtValue.** | +| 0x06 | Cell value is displayed if it is greater than or equal to the value specified in **vtValue.** | + +If **vt** is equal to 0x00, this field is undefined and MUST be ignored. + +**vtValue (8 bytes):** A variable type field whose type and meaning is dictated by the value of **vt**, as specified in the following table: + +| Value of vt | Meaning of vtValue | +|----|----| +| 0x00 | **vtValue** is 8 bytes which are undefined and MUST be ignored. | +| 0x02 | **vtValue** is an [AFDOperRk](#afdoperrk) that specifies a numeric value. MUST exist if and only if this structure is part of an AutoFilter record. | +| 0x04 | **vtValue** is an Xnum (section [2.5.342](#xnum)) that specifies a numeric value. | +| 0x06 | **vtValue** is an [AFDOperStr](#afdoperstr) that specifies a string value. | +| 0x08 | **vtValue** is an [AFDOperBoolErr](#afdoperboolerr) that specifies a Boolean or error value. | +| 0x0C | All blanks are matched. **vtValue** is 8 bytes which are reserved, MUST be 0, and MUST be ignored. | +| 0x0E | All non-blanks are matched. **vtValue** is 8 bytes which are reserved, MUST be 0, and MUST be ignored. | + +### AFDOperBoolErr + +The **AFDOperBoolErr** structure specifies a Boolean or error value for an [AutoFilter](#autofilter) comparison. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
besunused1
unused2
+ +**bes (2 bytes):** A [Bes](#bes) that specifies the Boolean or error value. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +### AFDOperRk + +The **AFDOperRk** structure specifies a numeric value for an [AutoFilter](#autofilter) comparison. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rk
unused1
+ +**rk (4 bytes):** An [RkNumber](#rknumber) that specifies a numeric value. + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +### AFDOperStr + +The **AFDOperStr** structure specifies a string value for an [AutoFilter](#autofilter) comparison. The string location is specified by the record or structure that contains this structure. + +A question mark character (‘?’) in the string specifies a matching condition on any single character. An asterisk character (‘\*’) in the string specifies a matching condition on a sequence of zero or more characters. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
unused1 (optional)
cchfComparereserved1unused2
unused3 (optional)
+ +**unused1 (4 bytes):** Undefined and MUST be ignored. MUST exist if and only if this structure is part of an AutoFilter, a [Feature11](#feature11) or a [Feature12](#feature12) record. + +**cch (1 byte):** An unsigned integer that specifies the number of characters in the string. MUST be greater than or equal to 1. + +**fCompare (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether the string comparison contains question mark or asterisk characters. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | String comparison contains question mark or asterisk characters. | +| 1 | String comparison does not contain question mark or asterisk characters. | + +**reserved1 (1 byte):** MUST be zero, and MUST be ignored. + +**unused2 (1 byte):** Undefined and MUST be ignored. + +**unused3 (4 bytes):** Undefined and MUST be ignored. MUST exist if and only if this structure is part of an [AutoFilter12](#autofilter12). + +### AutoFmt8 + +The **AutoFmt8** enumeration specifies the following auto formatting styles[\<149\>](#Appendix_A_149). + +| Name | Value | Meaning | +|-------------------------|--------|-----------------| +| **XL8_ITBLSIMPLE** | 0x0000 | Simple | +| **XL8_ITBLCLASSIC1** | 0x0001 | Classic 1 | +| **XL8_ITBLCLASSIC2** | 0x0002 | Classic 2 | +| **XL8_ITBLCLASSIC3** | 0x0003 | Classic 3 | +| **XL8_ITBLACCOUNTING1** | 0x0004 | Accounting 1 | +| **XL8_ITBLACCOUNTING2** | 0x0005 | Accounting 2 | +| **XL8_ITBLACCOUNTING3** | 0x0006 | Accounting 3 | +| **XL8_ITBLACCOUNTING4** | 0x0007 | Accounting 4 | +| **XL8_ITBLCOLORFUL1** | 0x0008 | Colorful 1 | +| **XL8_ITBLCOLORFUL2** | 0x0009 | Colorful 2 | +| **XL8_ITBLCOLORFUL3** | 0x000A | Colorful 3 | +| **XL8_ITBLLIST1** | 0x000B | List 1 | +| **XL8_ITBLLIST2** | 0x000C | List 2 | +| **XL8_ITBLLIST3** | 0x000D | List 3 | +| **XL8_ITBL3DEFFECTS1** | 0x000E | 3Deffects 1 | +| **XL8_ITBL3DEFFECTS2** | 0x000F | 3Deffects 2 | +| **XL8_ITBLNONE_GEN** | 0x0010 | None | +| **XL8_ITBLJAPAN2** | 0x0011 | Japan 2 | +| **XL8_ITBLJAPAN3** | 0x0012 | Japan 3 | +| **XL8_ITBLJAPAN4** | 0x0013 | Japan 4 | +| **XL8_ITBLNONE_JPN** | 0x0014 | Japan None | +| **XL8_ITBLREPORT1** | 0x1000 | Report 1 | +| **XL8_ITBLREPORT2** | 0x1001 | Report 2 | +| **XL8_ITBLREPORT3** | 0x1002 | Report 3 | +| **XL8_ITBLREPORT4** | 0x1003 | Report 4 | +| **XL8_ITBLREPORT5** | 0x1004 | Report 5 | +| **XL8_ITBLREPORT6** | 0x1005 | Report 6 | +| **XL8_ITBLREPORT7** | 0x1006 | Report 7 | +| **XL8_ITBLREPORT8** | 0x1007 | Report 8 | +| **XL8_ITBLREPORT9** | 0x1008 | Report 9 | +| **XL8_ITBLREPORT10** | 0x1009 | Report 10 | +| **XL8_ITBLTABLE1** | 0x100A | Table 1 | +| **XL8_ITBLTABLE2** | 0x100B | Table 2 | +| **XL8_ITBLTABLE3** | 0x100C | Table 3 | +| **XL8_ITBLTABLE4** | 0x100D | Table 4 | +| **XL8_ITBLTABLE5** | 0x100E | Table 5 | +| **XL8_ITBLTABLE6** | 0x100F | Table 6 | +| **XL8_ITBLTABLE7** | 0x1010 | Table 7 | +| **XL8_ITBLTABLE8** | 0x1011 | Table 8 | +| **XL8_ITBLTABLE9** | 0x1012 | Table 9 | +| **XL8_ITBLTABLE10** | 0x1013 | Table 10 | +| **XL8_ITBLPTCLASSIC** | 0x1014 | Table PTClassic | +| **XL8_ITBLPTNONE** | 0x1015 | None | + +### Bes + +The **Bes** structure specifies either a Boolean (section [2.5.14](#boolean)) value or an error value. **bBoolErr** specifies the value and **fError** specifies the value’s type. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
bBoolErrfError
+ +**bBoolErr (1 byte):** An unsigned integer that specifies either a Boolean value or an error value, depending on the value of **fError**. + +A Boolean value MUST be a value from the following table: + +| Value | Meaning | +|-------|---------| +| 0x00 | False | +| 0x01 | True | + +An error value MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------| +| 0x00 | \#NULL! | +| 0x07 | \#DIV/0! | +| 0x0F | \#VALUE! | +| 0x17 | \#REF! | +| 0x1D | \#NAME? | +| 0x24 | \#NUM! | +| 0x2A | \#N/A | +| 0x2B | \#GETTING_DATA | + +**fError (1 byte):** A Boolean that specifies whether **bBoolErr** contains an error code or a Boolean value. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | bBoolErr SHOULD[\<150\>](#Appendix_A_150) contain a Boolean value. | +| 0x01 | bBoolErr contains an error value. | + +### Bold + +The **Bold** enumeration specifies the [**font face weight**](#gt_8fd5e2d4-bd9a-48f2-ba16-42d23697508c). + +| Name | Value | Meaning | +|---------------|--------|--------------------| +| **BLSNORMAL** | 0x0190 | Normal font weight | +| **BLSBOLD** | 0x02BC | Bold font weight | + +### BookExt_Conditional11 + +The **BookExt_Conditional11** structure specifies two properties of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + + ++++++++++ + + + + + + + + + + + + + + + + + + + +
01234567
ABunused
+ +**A - fBuggedUserAboutSolution (1 bit):** A bit that specifies whether a warning is requested before loading a [**manifest**](#gt_d1a20cdc-cced-44de-a041-857fb9054856) that is a [**smart document**](#gt_cc9fe152-6a63-4555-91f1-1543ff84035d). + +**B - fShowInkAnnotation (1 bit):** A bit that specifies whether [**ink**](#gt_9fcdd1d5-3563-49b9-8a2e-bf696fb08fd0) [**comments**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) are visible in this workbook. + +**unused (6 bits):** Undefined and MUST be ignored. + +### BookExt_Conditional12 + +The **BookExt_Conditional12** structure specifies [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) related information. + + ++++++++++ + + + + + + + + + + + + + + + + + + + + +
01234567
ABCreserved2
+ +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - fPublishedBookItems (1 bit):** A bit that specifies whether only specific [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) items, including [**defined names**](#gt_5bb97b28-4adc-48ec-b544-02542753a933), [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7), [chart](#chart-2) object and [PivotTables](#Section_a5f57198f2af40b2ba07e4b1836d73f3), are shown when the workbook is published to a server. + + ++++ + + + + + + + + + + + + + + + + +
ValueMeaning
0All sheets or selected sheets are published. Each sheet is published, unless the SheetExt record for the sheet exists and the fNotPublished field of the SheetExtOptional structure of the SheetExt record is 1.
1

Only selected items are published. For each item, the fPublished field in the record or structure within the record that specifies the item determines whether the item is published. For each type of item, the records and structures that contain the fPublished flag are as follows:

+

Chart object: FtCmo structure of the Obj record

+

Table: TableFeatureType structure of the Feature11 record

+

Defined name: Lbl record

+

Defined name: NamePublish record

+

PivotTable: SXAddl_SXCView_SXDVer12Info record

+ +**C - fShowPivotChartFilter (1 bit):** A bit that specifies whether to show the [**PivotChart filter pane**](#gt_90f8a2d5-5501-4b3c-9186-f59b26b97f16). + +**reserved2 (5 bits):** MUST be zero, and MUST be ignored. + +### Boolean + +An unsigned integer greater than 1 bit in size that specifies a Boolean value. MUST be a value from the following table. All other bits in the field MUST be 0. + +| Value | Meaning | +|-------|---------------------| +| 0x0 | Boolean value FALSE | +| 0x1 | Boolean value TRUE | + +### BorderStyle + +The **BorderStyle** enumeration specifies the border line [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633). + +| Name | Value | Meaning | +|----|----|----| +| **NONE** | 0x0000 | No [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) | +| **THIN** | 0x0001 | Thin line | +| **MEDIUM** | 0x0002 | Medium line | +| **DASHED** | 0x0003 | Dashed line | +| **DOTTED** | 0x0004 | Dotted line | +| **THICK** | 0x0005 | Thick line | +| **DOUBLE** | 0x0006 | Double line | +| **HAIR** | 0x0007 | Hairline | +| **MEDIUMDASHED** | 0x0008 | Medium dashed line | +| **DASHDOT** | 0x0009 | Dash-dot line | +| **MEDIUMDASHDOT** | 0x000A | Medium dash-dot line | +| **DASHDOTDOT** | 0x000B | Dash-dot-dot line | +| **MEDIUMDASHDOTDOT** | 0x000C | Medium dash-dot-dot line | +| **SLANTDASHDOT** | 0x000D | Slanted dash-dot-dot line | + +### BuiltInStyle + +The **BuiltInStyle** structure specifies the type of a built**-**in [cell style](#Section_f9425d3f127545be8389bf80f65b56b7). For [**row outline**](#gt_b5d24145-1614-4e62-b4dd-96f1af5e76fe) and [**column outline**](#gt_56df9ab8-ed36-41fc-9522-4d23740e0901) types this structure also specifies the [**outline level**](#gt_a5cd5eff-ddeb-490b-bc71-f6256774e3c3) of the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
istyBuiltIniLevel
+ +**istyBuiltIn (1 byte):** An unsigned integer that specifies the type of the built-in cell style. SHOULD be a value from the list of built in cell styles specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1: Fundamentals And Markup Language Reference, section 18.8.7.[\<151\>](#Appendix_A_151) + +**iLevel (1 byte):** An unsigned integer that specifies the depth level of row/column automatic outlining. If **istyBuiltIn** equals 0x01 or 0x02, this value MUST be one of the following: + +| Value | Meaning | +|-------|--------------------| +| 0x00 | Outline level is 1 | +| 0x01 | Outline level is 2 | +| 0x02 | Outline level is 3 | +| 0x03 | Outline level is 4 | +| 0x04 | Outline level is 5 | +| 0x05 | Outline level is 6 | +| 0x06 | Outline level is 7 | + +Otherwise, this value MUST be 0xFF and MUST be ignored. + +### CachedDiskHeader + +The **CachedDiskHeader** structure specifies the formatting information of a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) column heading. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cbdxfHdrDisk
rgHdrDisk (variable)
...
strStyleName (variable)
...
+ +**cbdxfHdrDisk (4 bytes):** An unsigned integer that specifies the size, in bytes, of the **rgHdrDisk** field. + +**rgHdrDisk (variable):** A [DXFN12List](#dxfn12list) structure that specifies the formatting of the column heading. + +**strStyleName (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the name of the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) to use for the column heading. The name of the style MUST equal the **user** field of a [Style](#style) record in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), or the name of a built-in style, as specified by the [BuiltInStyle](#builtinstyle) record. This field is present only if the **fSaveStyleName** field of the containing [Feat11FieldDataItem](#feat11fielddataitem) structure is set to 0x1. + +If present, the formatting as specified by **strStyleName** is applied first, before the formatting as specified by **rgHdrDisk** is applied. + +### Cch255 + +A 2 byte unsigned integer that specifies a string size in characters. + +The value 0xFFFF specifies that the string is NULL. + +The value MUST be 0xFFFF or less than or equal to 0x00FF. + +### Cell + +The **Cell** structure specifies a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwcol
ixfe
+ +**rw (2 bytes):** An [Rw](#rw) that specifies the row. + +**col (2 bytes):** A [Col](#col) that specifies the column. + +**ixfe (2 bytes):** An [IXFCell](#ixfcell) that specifies the [XF](#xf) record. + +### CellXF + +This structure specifies formatting properties for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
alcAalcVBtrotcIndentCDEFGHIJKL
dgLeftdgRightdgTopMicvLefticvRightN
icvTopicvBottomicvDiagdgDiagOfls
icvForeicvBackPQ
+ +**alc (3 bits):** A [**HorizAlign**](#horizalign) that specifies the [**horizontal alignment**](#gt_f0e60ca8-51d5-4553-9126-3d89a4d08f90). + +**A - fWrap (1 bit):** A bit that specifies whether the cell text is wrapped. + +**alcV (3 bits):** A [**VertAlign**](#vertalign) that specifies the [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878). + +**B - fJustLast (1 bit):** A bit that specifies whether the justified or distributed alignment of the cell is used on the last line of text (setting this to 1 is typical for East Asian text but not typical in other contexts). If this field equals 1, then **alc** MUST equal 7. + +**trot (1 byte):** An [XFPropTextRotation](#xfproptextrotation) that specifies the text rotation. + +**cIndent (4 bits):** An unsigned integer that specifies the text [**indentation level**](#gt_2779d3df-3c50-44dc-9d2d-6996c4573aa9). MUST be less than or equal to 15. + +**C - fShrinkToFit (1 bit):** A bit that specifies whether the cell is [**shrink to fit**](#gt_4740d2ef-00d3-4a29-983c-b7b3a6aa01e0). + +**D - reserved1 (1 bit):** MUST be 0, and MUST be ignored. + +**E - iReadOrder (2 bits):** A [**ReadingOrder**](#readingorder) that specifies the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361). + +**F - reserved2 (2 bits):** MUST be 0, and MUST be ignored. + +**G - fAtrNum (1 bit):** A bit that specifies that if the **ifmt** field of the [XF](#xf) record specified by the **ixfParent** field of the containing XF record is updated, the corresponding field of the containing XF record will not be set to the same value. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The **ifmt** field of the containing XF record is updated when the corresponding field of the XF record specified by the **ixfParent** field of the containing XF record is changed. | +| 0x1 | The **ifmt** field of the containing XF record is not updated when the corresponding field of the XF record specified by the **ixfParent** field of the containing XF record is changed. | + +**H - fAtrFnt (1 bit):** A bit that specifies that if the **ifnt** field of the XF record specified by the **ixfParent** field of the containing XF record is updated, the corresponding field of the containing XF record will not be set to the same value. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The **ifnt** field of the containing XF record is updated when the corresponding field of the XF record specified by the **ixfParent** field of the containing XF record is changed. | +| 0x1 | The **ifnt** field of the containing XF record is not updated when the corresponding field of the XF record specified by the **ixfParent** field of the containing XF record is changed. | + +**I - fAtrAlc (1 bit):** A bit that specifies that if the **alc** field, or the **fWrap** field, or the alcV field, or the fJustLast field, or the trot field, or the cIndent field, or the fShrinkToFit field or the iReadOrder field of the XF record specified by the **ixfParent** field of the containing XF record is updated, the corresponding fields of this structure will not be set to the same values. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The **alc**, **fWrap**, alcV, fJustLast, trot, cIndent, fShrinkToFit, iReadOrder fields are updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | +| 0x1 | The **alc**, **fWrap**, alcV, fJustLast, trot, cIndent, fShrinkToFit, iReadOrder fields are not updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | + +**J - fAtrBdr (1 bit):** A bit that specifies that if the **dgLeft** field, or the **dgRight** field, or the **dgTop** field, or the **dgBottom** field, or the **dgDiag** field, or the **icvLeft** field, or the **icvRight** field, or the **grbitDiag** field, or the **icvTop** field, or the **icvBottom** field, or the **icvDiag** field of the XF record specified by the **ixfParent** field of the containing XF record is updated, the corresponding fields of this structure will not be set to the same values. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The **dgLeft**, **dgRight**, **dgTop**, **dgBottom**, **dgDiag**, **icvLeft**, **icvRight**, **grbitDiag**, **icvTop**, **icvBottom**, **icvDiag** fields are updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | +| 0x1 | The **dgLeft**, **dgRight**, **dgTop**, **dgBottom**, **dgDiag**, **icvLeft**, **icvRight**, **grbitDiag**, **icvTop**, **icvBottom**, **icvDiag** fields are not updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | + +**K - fAtrPat (1 bit):** A bit that specifies that if the **fls** field, the **icvFore** field, or the **icvBack** field of the XF record specified by the **ixfParent** field of the containing XF record is updated, the corresponding fields of this structure will not be set to the same values. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The **fls**, **icvFore**, and **icvBack** fields are updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | +| 0x1 | The **fls**, **icvFore**, and **icvBack** fields are not updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | + +**L - fAtrProt (1 bit):** A bit that specifies that if the **fLocked** field or the **fHidden** field of the XF record specified by the **ixfParent** field of the containing XF record is updated, the corresponding fields of the containing XF record will not be set to the same values. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The **fLocked** and **fHidden** fields of the containing XF record are updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | +| 0x1 | The **fLocked** and **fHidden** fields of the containing XF record are not updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | + +**dgLeft (4 bits):** A [BorderStyle](#borderstyle) that specifies the [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad). + +**dgRight (4 bits):** A BorderStyle that specifies the [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) border formatting. + +**dgTop (4 bits):** A BorderStyle that specifies the top border formatting. + +**M - dgBottom (4 bits):** A BorderStyle that specifies the bottom border formatting. + +**icvLeft (7 bits):** An unsigned integer that specifies the color of the logical left [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c). The value MUST be one of the values specified in [IcvXF](#icvxf) or 0. A value of 0 means the logical left border color has not been specified. If this value is 0, then **dgLeft** MUST also be 0. + +**icvRight (7 bits):** An unsigned integer that specifies the color of the logical right border. The value MUST be one of the values specified in IcvXF or 0. A value of 0 means the logical right border color has not been specified. If this value is 0, then **dgRight** MUST also be 0. + +**N - grbitDiag (2 bits):** An unsigned integer that specifies which diagonal borders are present (if any). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | No diagonal border | +| 0x1 | [**Diagonal-down**](#gt_494c0660-9ece-4dcc-b8d3-1a5616a57782) border | +| 0x2 | [**Diagonal-up**](#gt_d4878a4d-c65e-471d-b9fb-da7a5a5aa929) border | +| 0x3 | Both diagonal-down and diagonal-up | + +**icvTop (7 bits):** An unsigned integer that specifies the color of the top border. The value MUST be one of the values specified in IcvXF or 0. A value of 0 means the top border color has not been specified. If this value is 0, then **dgTop** MUST also be 0. + +**icvBottom (7 bits):** An unsigned integer that specifies the color of the bottom border. The value MUST be one of the values specified in IcvXF or 0. A value of 0 means the bottom border color has not been specified. If this value is 0 then **dgBottom** MUST also be 0. + +**icvDiag (7 bits):** An unsigned integer that specifies the color of the diagonal border. The value MUST be one of the values specified in IcvXF or 0. A value of 0 means the diagonal border color has not been specified. If this value is 0 then **dgDiag** MUST also be 0. + +**dgDiag (4 bits):** A BorderStyle that specifies the diagonal border formatting. + +**O - fHasXFExt (1 bit):** A bit that specifies whether an [XFExt](#xfext) will extend the information in this XF. + +**fls (6 bits):** A [**FillPattern**](#fillpattern) that specifies the [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e). If this value is 1, which specifies a solid fill pattern, then only **icvFore** is rendered. + +**icvFore (7 bits):** An IcvXF that specifies the [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) of the fill pattern. + +**icvBack (7 bits):** An unsigned integer that specifies the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) of the fill pattern. The value SHOULD[\<152\>](#Appendix_A_152) be an IcvXF value. + +**P - fsxButton (1 bit):** A bit that specifies whether the XF record is attached to a pivot field drop-down button. + +**Q - reserved3 (1 bit):** MUST be 0 and MUST be ignored. + +### CFColor + +The **CFColor** structure specifies a color in [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) records or in a [SheetExt](#sheetext) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xclrType
xclrValue
numTint
...
+ +**xclrType (4 bytes):** An [**XColorType**](#xcolortype) that specifies the type of color reference. MUST be different from XCLRNINCHED. MUST be different from XCLRAUTO unless it is contained in a SheetExt record. + +**xclrValue (4 bytes):** A structure that specifies the color value. The type of structure depends on the color reference type specified by **xclrType** and MUST be a structure from the following table: + +| Value of xclrType | Type | +|----|----| +| XCLRAUTO | Ignored | +| XCLRINDEXED | [ColorICV](#coloricv) | +| XCLRRGB | [LongRGBA](#longrgba)[\<153\>](#Appendix_A_153) | +| XCLRTHEMED | [ColorTheme](#colortheme) | + +**numTint (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the tint and [**shade**](#gt_46cefc61-d599-4408-bd6c-9c3dec0c1db4) value to be applied to the color. MUST be greater than or equal to -1.0 and less than or equal to 1.0 + +### CFDatabar + +The **CFDatabar** structure specifies the parameters of a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule that uses [**data bar**](#gt_d8d5ab5a-ebee-45a3-bd11-2a5779bb54ed) formatting. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
unusedreserved1ABreserved2
iPercentMiniPercentMaxcolor (16 bytes)
...
...
...cfvoDB1 (variable)
...
cfvoDB2 (variable)
...
+ +**unused (2 bytes):** Undefined and MUST be ignored. + +**reserved1 (1 byte):** MUST be zero and MUST be ignored. + +**A - fRightToLeft (1 bit):** A bit that specifies whether the data bars are drawn starting from the right of the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). MUST be a value from the following table: + +| **Value** | **Meaning** | +|:----------|:--------------------------------------------------------| +| 0x0 | Data bars are drawn starting from the left of the cell | +| 0x1 | Data bars are drawn starting from the right of the cell | + +**B - fShowValue (1 bit):** A bit that specifies whether the numerical value of the cell appears in the cell along with the data bar. + +**reserved2 (6 bits):** MUST be zero and MUST be ignored. + +**iPercentMin (1 byte):** An unsigned integer that specifies the length of a data bar, as a percentage of the cell width, that is applied to cells with values equal to the [CFVO](#cfvo) value specified by **cfvoDB1**. MUST be less than or equal to 100. + +**iPercentMax (1 byte):** An unsigned integer that specifies the length of a data bar, as a percentage of the cell width, that is applied to cells with values equal to the CFVO value specified by **cfvoDB2**. MUST be greater than **iPercentMin** and less than or equal to 100. + +**color (16 bytes):** A [CFColor](#cfcolor) structure that specifies the color of the data bar. + +**cfvoDB1 (variable):** A CFVO that specifies the maximum [**cell value**](#gt_4d48a886-7f1d-4d41-a668-54f7f2f1a966) that will be represented with a minimum width data bar. All cell values that are less than or equal to the CFVO value specified by this field are represented with a data bar of **iPercentMin** percent of the cell width. + +**cfvoDB2 (variable):** A CFVO that specifies the minimum cell value that will be represented with a maximum width data bar. All cell values that are greater than or equal to the CFVO value specified by this field are represented with a data bar of **iPercentMax** percent of the cell width. + +### CFExAveragesTemplateParams + +This structure specifies the parameters for an above or below average [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule in a containing [CF12](#cf12) record or [CFExNonCF12](#cfexnoncf12) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iParamreserved (14 bytes)
...
...
...
+ +**iParam (2 bytes):** An unsigned integer that specifies the number of standard deviations above or below the average for the rule. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The threshold is not offset by a multiple of the standard deviation. | +| 0x0001 | The threshold is offset by 1 standard deviation. | +| 0x0002 | The threshold is offset by 2 standard deviations. | + +**reserved (14 bytes):** MUST be zero and MUST be ignored. + +### CFExDateTemplateParams + +The **CFExDateTemplateParams** structure specifies parameters for the date-related [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules specified by a [CF12](#cf12) record or [CFExNonCF12](#cfexnoncf12) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
dateOpreserved (14 bytes)
...
...
...
+ +**dateOp (2 bytes):** An unsigned integer that specifies the type of date comparison. The value of this field MUST be equal to the value that corresponds to the **icfTemplate** field in the containing CF12 record or CFExNonCF12 structure, according to the following table: + +| Value of icfTemplate | Value of this field | +|----------------------|---------------------| +| 15 | 0 | +| 16 | 6 | +| 17 | 1 | +| 18 | 2 | +| 19 | 5 | +| 20 | 8 | +| 21 | 3 | +| 22 | 7 | +| 23 | 4 | +| 24 | 9 | + +**reserved (14 bytes):** MUST be zero and MUST be ignored. + +### CFExDefaultTemplateParams + +This structure specifies that there are no parameters for extensions to [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules specified by [CFEx](#cfex). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
unused (16 bytes)
...
...
+ +**unused (16 bytes):** Undefined and MUST be ignored. + +### CFExFilterParams + +The **CFExFilterParams** structure specifies parameters for a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule of type [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABreserved1iParamreserved2 (13 bytes)
...
...
...
+ +**A - fTop (1 bit):** A bit that specifies whether the top or bottom items are displayed with the conditional formatting. MUST be one of the following values: + +| Value | Meaning | +|-------|------------------------------------------------------------| +| 0x0 | Bottom items are displayed with the conditional formatting | +| 0x1 | Top items are displayed with the conditional formatting | + +**B - fPercent (1 bit):** A bit that specifies whether a percentage of the top or bottom items are displayed with the conditional formatting, or whether a set number of the top or bottom items are displayed with the conditional formatting. MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x0 | A set number of top or bottom items, specified by **iParam,** are displayed with the conditional formatting. | +| 0x1 | A percentage of top or bottom items, specified by **iParam,** are displayed with the conditional formatting | + +**reserved1 (6 bits):** MUST be zero and MUST be ignored. + +**iParam (2 bytes):** An unsigned integer that specifies how many values are displayed with the conditional formatting. If **fPercent** equals 1 then this field represents a percent and MUST be less than or equal to 100. Otherwise, this field represents a set number of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and MUST be less than or equal to 1000. + +**reserved2 (13 bytes):** MUST be zero and MUST be ignored. + +### CFExNonCF12 + +The **CFExNonCF12** structure specifies properties that extend a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule that is specified by a [CF](#cf) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
icfcpicfTemplate
ipriorityABCDEfHasDXF
dxf (variable)
...
cbTemplateParmrgbTemplateParms (16 bytes)
...
...
...
+ +**icf (2 bytes):** An unsigned integer that specifies a zero-based index of a CF record in the collection of CF records directly following the [CondFmt](#condfmt) record that is referenced by the parent [CFEx](#cfex) record with the **nID** field. The referenced CF specifies the conditional formatting rule to be extended. + +**cp (1 byte):** An unsigned integer that specifies the type of comparison operation to use when the **ct** field of the CF record referenced by the **icf** field of this structure is equal to 0x01. MUST be zero when the **ct** field of the CF record is not equal to 1. SHOULD[\<154\>](#Appendix_A_154) be equal to the **cp** field in the referenced CF record. + +In the following table, *v* represents the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) value, and *v1* and *v2* represent the results of evaluating the formulas specified by **rgce1** and **rgce2** fields of the referenced CF record specified by icf. The value of this field MUST be a value from the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ValueComparison Operation
0x00No comparison
0x01

v2 is greater than or equal to v1, and v is greater than or equal to v1 and less than or equal to v2

+

–Or–

+

v1 is greater than v2, and v is greater than or equal to v2 and less than or equal to v1

0x02

v2 is greater than or equal to v1, and v is less than v1 or greater than v2

+

–Or–

+

v1 is greater than v2, and v is less than v2 or greater than v1

0x03v is equal to v1
0x04v is not equal to v1
0x05v is greater than v1
0x06v is less than v1
0x07v is greater than or equal to v1
0x08v is less than or equal to v1
+ +**icfTemplate (1 byte):** An unsigned integer that specifies the template from which the rule was created. MUST be the least significant byte of one of the valid values specified for the **icfTemplate** field in the [CF12](#cf12) record. + +**ipriority (2 bytes):** An unsigned integer that specifies the priority of the rule. Rules that apply to the same cell are evaluated in increasing order of **ipriority**. MUST be unique across all CF12 records and CFExNonCF12 structures in the [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream. + +**A - fActive (1 bit):** A bit that specifies whether the rule is active. If set to zero, the rule will be ignored. + +**B - fStopIfTrue (1 bit):** A bit that specifies whether, when a cell fulfills the condition corresponding to this rule, the lower priority conditional formatting rules that apply to this cell are evaluated. MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x0 | Evaluate lower priority conditional formatting rules that apply to this cell | +| 0x1 | If the cell fulfills the condition corresponding to this rule, do not evaluate lower priority conditional formatting rules that apply to this cell | + +**C - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**D - unused (1 bit):** Undefined and MUST be ignored. + +**E - reserved2 (4 bits):** MUST be zero and MUST be ignored. + +**fHasDXF (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether cell formatting data is part of this record extension. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------| +| 0x00 | No formatting data in this record extension. | +| 0x01 | Formatting data is part of this record extension. | + +**dxf (variable):** A [DXFN12](#dxfn12) structure that specifies the format to use for cells that satisfy the condition. MUST NOT be present when **fHasDXF** is zero. + +**cbTemplateParm (1 byte):** An unsigned integer that specifies the size of the **rgbTemplateParms** field in bytes. MUST be equal to 16. + +**rgbTemplateParms (16 bytes):** A [CFExTemplateParams](#cfextemplateparams) that specifies parameters for the rule specified by this structure. + +### CFExTemplateParams + +The **CFExTemplateParams** structure specifies parameters for [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules of type [CF12](#cf12) or [CFExNonCF12](#cfexnoncf12). The type of this structure depends on the **icfTemplate** field in the containing structure as specified in the following table: + +| Value of icfTemplate | Type of CFExTemplateParams | +|----|----| +| 0x05 | [CFExFilterParams](#cfexfilterparams) | +| 0x08 | [CFExTextTemplateParams](#cfextexttemplateparams) | +| 0x0F | [CFExDateTemplateParams](#cfexdatetemplateparams) | +| 0x10 | CFExDateTemplateParams | +| 0x11 | CFExDateTemplateParams | +| 0x12 | CFExDateTemplateParams | +| 0x13 | CFExDateTemplateParams | +| 0x14 | CFExDateTemplateParams | +| 0x15 | CFExDateTemplateParams | +| 0x16 | CFExDateTemplateParams | +| 0x17 | CFExDateTemplateParams | +| 0x18 | CFExDateTemplateParams | +| 0x19 | [CFExAveragesTemplateParams](#cfexaveragestemplateparams) | +| 0x1A | CFExAveragesTemplateParams | +| 0x1D | CFExAveragesTemplateParams | +| 0x1E | CFExAveragesTemplateParams | +| other | [CFExDefaultTemplateParams](#cfexdefaulttemplateparams) | + +### CFExTextTemplateParams + +The **CFExTextTemplateParams** structure specifies parameters for text-related [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules as specified by a [CF12](#cf12) record or [CFExNonCF12](#cfexnoncf12) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ctpreserved (14 bytes)
...
...
...
+ +**ctp (2 bytes):** An unsigned integer that specifies the type of text rule. MUST be a value from the following table: + +| Value | Meaning | +|--------|-----------------------| +| 0x0000 | Text contains | +| 0x0001 | Text does not contain | +| 0x0002 | Text begins with | +| 0x0003 | Text ends with | + +**reserved (14 bytes):** MUST be zero and MUST be ignored. + +### CFFilter + +The **CFFilter** structure specifies the parameters of a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule of type [**top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cbFilterreserved1ABreserved2
iParam
+ +**cbFilter (2 bytes):** An unsigned integer that specifies the size of the structure in bytes, excluding the **cbFilter** field itself. + +**reserved1 (1 byte):** MUST be zero and MUST be ignored. + +**A - fTop (1 bit):** A bit that specifies whether the top or bottom items are displayed with the conditional formatting. MUST be one of the following values: + +| Value | Meaning | +|-------|------------------------------------------------------------| +| 0x0 | Bottom items are displayed with the conditional formatting | +| 0x1 | Top items are displayed with the conditional formatting | + +**B - fPercent (1 bit):** A bit that specifies whether a percentage of top or bottom items are displayed with the conditional formatting, or a set number of top or bottom items are displayed with the conditional formatting. MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x0 | Top or bottom **iParam** items are displayed with the conditional formatting. | +| 0x1 | Top or bottom **iParam** percent of items are displayed with the conditional formatting | + +**reserved2 (6 bits):** MUST be zero and MUST be ignored. + +**iParam (2 bytes):** An unsigned integer that specifies how many values are displayed with the conditional formatting. If **fPercent** is set to 1 then this field represents a percent and MUST be less than or equal to 100, otherwise this field is a number of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and MUST be less than or equal to 1000. + +### CFFlag + +The **CFFlag** structure specifies the conditional format flag information. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iIconSet
iIcon
+ +**iIconSet (4 bytes):** A [KPISets](#kpisets) that identifies an [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9). + +**iIcon (4 bytes):** A signed integer that specifies an [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) in the set. The value of this field changes the [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7) for custom sorts that are based on icon sets. + +MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------| +| -1 | No icon | +| 0 | First icon in the icon set | +| 1 | Second icon in the icon set | +| 2 | Third icon in the icon set | +| 3 | Fourth icon in the icon set | +| 4 | Fifth icon in the icon set | + +### CFGradient + +The **CFGradient** structure specifies the parameters of a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule that uses [**color scale**](#gt_11144129-6c0d-4ad5-ba59-59439c4747db) formatting. Color scale formatting maps [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) values to colors through the following process: + +1. An interpolation curve maps cell values to values between 0 and 1. The first and last control points, as specified in **rgInterp**, specify the cell values that map to 0 and 1 respectively. + +2. A gradient curve maps values between 0 and 1 to colors. + +Both curves are determined by two or three control points, with linear interpolation between those points. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
unusedreserved1cInterpCurve
cGradientCurveABreserved2rgInterp (variable)
...
rgCurve (variable)
...
+ +**unused (2 bytes):** Undefined and MUST be ignored. + +**reserved1 (1 byte):** MUST be zero and MUST be ignored. + +**cInterpCurve (1 byte):** An unsigned integer that specifies the number of control points in the interpolation curve. It MUST be 0x2 or 0x3. + +**cGradientCurve (1 byte):** An unsigned integer that specifies the number of control points in the gradient curve. It MUST be equal to **cInterpCurve**. + +**A - fClamp (1 bit):** A bit that specifies that the cell values are not used when they are out of the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of the interpolation curve. The minimum or the maximum of the interpolation curve is used instead of the cell value. The value SHOULD[\<155\>](#Appendix_A_155) be 1. + +**B - fBackground (1 bit):** A bit that specifies that the color scale formatting applies to the background of the cells. It MUST be 1. + +**reserved2 (6 bits):** MUST be zero and MUST be ignored. + +**rgInterp (variable):** An array of [CFGradientInterpItem](#cfgradientinterpitem). Each element is a control point of the interpolation curve. Its element count MUST be **cInterpCurve**. + +**rgCurve (variable):** An array of [CFGradientItem](#cfgradientitem). Each element is a control point of the gradient curve. Its element count MUST be **cGradientCurve**. + +### CFGradientInterpItem + +The **CFGradientInterpItem** structure specifies one control point in the interpolation curve. The interpolation curve maps [**cell values**](#gt_4d48a886-7f1d-4d41-a668-54f7f2f1a966) to colors for a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule using [**color scale**](#gt_11144129-6c0d-4ad5-ba59-59439c4747db) formatting. The color is specified as the numerical value associated with the color in the corresponding **CFGradient.rgCurve** array of the containing [CFGradient](#cfgradient) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cfvoInterp (variable)
...
numDomain
...
+ +**cfvoInterp (variable):** A [CFVO](#cfvo) structure that specifies the cell value associated with the numerical value specified in **numDomain**. + +**numDomain (8 bytes):** An Xnum (section [2.5.342](#xnum)) structure that specifies the numerical value of this control point. MUST be equal to 0.0 if the structure is the first item in the **rgbCT.rgInterp** array of the containing [CF12](#cf12) record. MUST be equal to 1.0 if this structure is the last item in the **rgbCT.rgInterp** array of the containing CF12 record. MUST be equal to 0.5 if this structure is the second item in the **rgbCT.rgInterp** array of the containing CF12 record and **rgbCT.cInterpCurve** field of the containing CF12 record is equal to 0x03. + +### CFGradientItem + +The **CFGradientItem** structure specifies one control point in the gradient curve. The gradient curve specifies a [**color scale**](#gt_11144129-6c0d-4ad5-ba59-59439c4747db) used in [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) and maps numerical values to colors. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
numGrange
...
color (16 bytes)
...
...
+ +**numGrange (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the numerical value of the control point. MUST be equal to 0.0 if this structure is the first element in the **rgbCT.rgCurve** array of the containing [CF12](#cf12) record. MUST be equal to 1.0 if this structure is the last element in the **rgbCT.rgCurve** array of the containing CF12 record. MUST be equal to 0.5 if this structure is the second element in the **rgbCT.rgCurve** array of the containing CF12 record and the **rgbCT.cInterpCurve** field of the containing CF12 record is equal to 0x03. + +**color (16 bytes):** A [CFColor](#cfcolor) that specifies the color associated with the numerical value specified in **numGrange**. + +### CFMStateItem + +The **CFMStateItem** structure specifies the threshold value associated with an [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) for a [CFMultistate](#cfmultistate) [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cfvo (variable)
...
fEqualunused
...
+ +**cfvo (variable):** A [CFVO](#cfvo) that specifies the threshold value. + +**fEqual (1 byte):** A Boolean (section [2.5.14](#boolean)) that MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | [**Cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) values that are equal to the threshold value do not pass the threshold | +| 0x01 | Cell values that are equal to the threshold value pass the threshold. | + +**unused (4 bytes):** Undefined and MUST be ignored. + +### CFMultistate + +The **CFMultistate** structure specifies the parameters for a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule that represents [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) values with icons from an [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
unusedreserved1cStates
iIconSetABCreserved3rgStates (variable)
...
+ +**unused (2 bytes):** Undefined and MUST be ignored. + +**reserved1 (1 byte):** MUST be zero and MUST be ignored. + +**cStates (1 byte):** An unsigned integer that specifies the number of items in the icon set. MUST be the value from the following table: + +| Value of iIconSet | Value of cStates | +|--------------------------------|------------------| +| Between 0x00 and 0x07 included | 0x03 | +| Between 0x08 and 0x0C included | 0x04 | +| Between 0x0D and 0x10 included | 0x05 | + +**iIconSet (1 byte):** An unsigned integer that specifies the icon set that represents the cell values. MUST be the value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | | +| 0x01 | | +| 0x02 | | +| 0x03 | | +| 0x04 | | +| 0x05 | | +| 0x06 | | +| 0x07 | | +| 0x08 | | +| 0x09 | | +| 0x0A | | +| 0x0B | | +| 0x0C | | +| 0x0D | | +| 0x0E | | +| 0x0F | | +| 0x10 | | + +**A - fIconOnly (1 bit):** A bit that specifies whether only the [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) will be displayed in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and that the cell value will be [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**B - reserved2 (1 bit):** MUST be zero and MUST be ignored. + +**C - fReverse (1 bit):** A bit that specifies whether the order of the icons in the set is reversed. + +**reserved3 (5 bits):** MUST be zero and MUST be ignored. + +**rgStates (variable):** An array of [CFMStateItem](#cfmstateitem). Each element specifies a threshold for the respective icon in the set, below which cell values are represented by the next icon in the set. The element count MUST be equal to **cStates**. + +### CFrtId + +The **CFrtId** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [Future Record Type](#Section_b660b67822684414839ed1ae9a4e4e85) identifier values. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rtFirstrtLast
+ +**rtFirst (2 bytes):** An unsigned integer that specifies the first Future Record Type in the range. The value MUST be less than or equal to **rtLast**. + +**rtLast (2 bytes):** An unsigned integer that specifies the last Future Record Type in the range. + +### CFT + +The **CFT** enumeration specifies [**custom filter**](#gt_8593ee2f-c2dd-4793-a684-45fe40c840d2) types. + +| Name | Value | Meaning | +|----|----|----| +| **CFTNIL** | 0x00000000 | None | +| **CFTTOP10** | 0x00000003 | [**Top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9) | +| **CFTEQUALDATE** | 0x00000004 | Equal to date | +| **CFTBEFORE** | 0x00000005 | Before | +| **CFTAFTER** | 0x00000006 | After | +| **CFTBETWEENDATE** | 0x00000007 | Between dates | +| **CFTTOMORROW** | 0x00000008 | Tomorrow | +| **CFTTODAY** | 0x00000009 | Today | +| **CFTYESTERDAY** | 0x0000000A | Yesterday | +| **CFTNEXTWEEK** | 0x0000000B | Next week | +| **CFTTHISWEEK** | 0x0000000C | This week | +| **CFTLASTWEEK** | 0x0000000D | Last week | +| **CFTNEXTMONTH** | 0x0000000E | Next month | +| **CFTTHISMONTH** | 0x0000000F | This month | +| **CFTLASTMONTH** | 0x00000010 | Last month | +| **CFTNEXTQUARTER** | 0x00000011 | Next quarter | +| **CFTTHISQUARTER** | 0x00000012 | This quarter | +| **CFTLASTQUARTER** | 0x00000013 | Last quarter | +| **CFTNEXTYEAR** | 0x00000014 | Next year | +| **CFTTHISYEAR** | 0x00000015 | This year | +| **CFTLASTYEAR** | 0x00000016 | Last year | +| **CFTYEARTODATE** | 0x00000017 | Year to date | +| **CFTQ1** | 0x00000018 | First quarter | +| **CFTQ2** | 0x00000019 | Second quarter | +| **CFTQ3** | 0x0000001A | Third quarter | +| **CFTQ4** | 0x0000001B | Fourth quarter | +| **CFTM1** | 0x0000001C | January | +| **CFTM2** | 0x0000001D | February | +| **CFTM3** | 0x0000001E | March | +| **CFTM4** | 0x0000001F | April | +| **CFTM5** | 0x00000020 | May | +| **CFTM6** | 0x00000021 | June | +| **CFTM7** | 0x00000022 | July | +| **CFTM8** | 0x00000023 | August | +| **CFTM9** | 0x00000024 | September | +| **CFTM10** | 0x00000025 | October | +| **CFTM11** | 0x00000026 | November | +| **CFTM12** | 0x00000027 | December | +| **CFTNOTEQUALDATE** | 0x00000028 | Does not equal date | +| **CFTBEFOREOREQUAL** | 0x00000029 | Equal or earlier date | +| **CFTAFTEROREQUAL** | 0x0000002A | Equal or later date | +| **CFTNOTBETWEENDATE** | 0x0000002B | Not between two dates | + +### CFVO + +The **CFVO** structure specifies a Conditional Formatting Value Object (CFVO) that specifies how to calculate a value from the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells that a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule applies to. + +The value this structure specifies how to calculate is referred to as a CFVO value in other records. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cfvoTypefmla (variable)
...
numValue (optional)
...
+ +**cfvoType (1 byte):** An unsigned integer that specifies how the CFVO value is determined. In the following table, X represents a parameter value. If **fmla.cce** is greater than zero, then X is the result of evaluating **fmla,** otherwise, X is **numValue.** **cfvoType** MUST be one of the following values: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ValueMeaning of CFVO Value
0x01X
0x02The minimum value from the range of cells that the conditional formatting rule applies to.
0x03The maximum value from the range of cells that the conditional formatting rule applies to.
0x04

The minimum value in the range of cells that the conditional formatting rule applies to plus X percent of the difference between the maximum and minimum values in the range of cells that the conditional formatting rule applies to.

+

For example, if the min and max values in the range are 1 and 10 respectively, and X is 10, then the CFVO value is 1.9.

0x05The minimum value of the cell that is in X percentile of the range of cells that the conditional formatting rule applies to.
0x07The result of evaluating fmla.
+ +**fmla (variable):** A [CFVOParsedFormula](#cfvoparsedformula) that specifies the formula used to calculate the CFVO value. If **cfvoType** is 0x07, then **fmla.cce** MUST be greater than zero. + +**numValue (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies a static value used to calculate the CFVO value. MUST be omitted if **fmla.cce** is greater than zero, or if **cfvoType** is equal to 0x02 or 0x03. MUST be greater than 0.0 and less than 100.0 if **cfvoType** is either 0x04 or 0x05 + +### ChartNumNillable + +**ChartNumNillable** is an 8-byte union that specifies a floating-point value, or a non-numeric value defined by the containing record. The type and meaning of the union contents are determined by the most significant 2 bytes, and is defined in the following table: + +| Value of most significant 2 bytes | Type and meaning of union contents | +|----|----| +| 0xFFFF | A [NilChartNum](#nilchartnum) that specifies a non-numeric value, as defined by the containing record. | +| Any other value. | An Xnum (section [2.5.342](#xnum)) that specifies a floating-point value. | + +### Col + +The **Col** structure specifies the zero-based column index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
col
+ +**col (2 bytes):** An unsigned integer that specifies the zero-based column index of the column in the sheet that contains this structure. MUST be greater than or equal to the **colMic** field of the [Dimensions](#dimensions) record of the sheet that contains this structure and MUST be less than the **colMac** field of the Dimensions record of the sheet that contains this structure. MUST be less than or equal to 0x00FF. + +### Col_NegativeOne + +The **Col_NegativeOne** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
col
+ +**col (2 bytes):** A signed integer that specifies the zero-based index of a column in the sheet that contains this structure. The value 0xFFFF specifies a null column index. MUST be greater than or equal to 0xFFFF and less than or equal to 0x00FF. + +### Col12 + +The **Col12** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
col
+ +**col (4 bytes):** A signed integer that specifies a zero-based index of the sheet. MUST be greater than or equal to zero, and MUST be less than or equal to 0x3FFF. + +### Col256U + +The **Col256U** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
col
+ +**col (2 bytes):** An unsigned integer that specifies the zero-based index of a column in the sheet that contains this structure. MUST be less than or equal to 0x0100. The value 0x0100 specifies that the formatting in the containing record also specifies the default column formatting. If additional columns become [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) at the extreme right of the column [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) because of column deletion, those columns have this default formatting applied. + +### ColByte + +The **ColByte** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++ + + + + + + + + + + + + + + + + + +
01234567
col
+ +**col (1 byte):** An unsigned integer that specifies the zero-based index of the column in the sheet that contains this structure. MUST be greater than or equal to the **colMic** field of the [Dimensions](#dimensions) record of the sheet that contains this structure and MUST be less than the **colMac** field of the Dimensions record of the sheet that contains this structure. + +### ColByteU + +The **ColByteU** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++ + + + + + + + + + + + + + + + + + +
01234567
col
+ +**col (1 byte):** An unsigned integer that specifies the zero-based index of a column in the sheet that contains this structure. + +### ColElfU + +The **ColElfU** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and [**relative reference**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) information for this column index and a corresponding row index. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
colAB
+ +**col (14 bits):** An unsigned integer that specifies the zero-based index of a column in the sheet that contains this structure. MUST be less than or equal to 0x00FF. + +**A - fQuoted (1 bit):** A bit that specifies if the label occurrences in the [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) are surrounded by single quote characters. + +**B - fRelative (1 bit):** A bit that specifies whether a corresponding row index from the containing structure and **column** are relative or absolute. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | A corresponding row index from the containing structure and **column** are absolute coordinates and are specified by a fixed position in a sheet. | +| 0x1 | A corresponding row index from the containing structure and **column** are relative coordinates and are specified by their position in relation to the current row or current column. | + +### ColorICV + +The **ColorICV** structure specifies a color in the color table. + +This structure differs from the [IcvXF](#icvxf) structure in size (4 bytes versus 7 bits), and the validity of the values 0x40 and 0x41. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iCV
+ +**iCV (4 bytes):** An unsigned integer that specifies a color in the color table. The value MUST be an IcvXF value. The value MUST NOT be 0x00000040 or 0x00000041. + +### ColorTheme + +The **ColorTheme** structure specifies a color from the document’s [**theme**](#gt_8b5eb4c0-949b-47d9-8b63-b9bda81d61b8). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iCV
+ +**iCV (4 bytes):** An unsigned integer that specifies one of the colors defined in the [**color scheme**](#gt_b0feeac6-f711-4ed7-b8c6-3a490734a9e5) of the document’s [Theme](#theme) record. MUST be one of the following values: + +| Value | Color from the color scheme | +|----|----| +| 0x00000000 | Dark 1 | +| 0x00000001 | Light 1 | +| 0x00000002 | Dark 2 | +| 0x00000003 | Light 2 | +| 0x00000004 | Accent 1 | +| 0x00000005 | Accent 2 | +| 0x00000006 | Accent 3 | +| 0x00000007 | Accent 4 | +| 0x00000008 | Accent 5 | +| 0x00000009 | Accent 6 | +| 0x0000000A | [**Hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) | +| 0x0000000B | [**Followed hyperlink**](#gt_7ddfa06d-f75c-47d3-b7b7-8a3a4aa47975) | + +If this structure is contained in a [CF12](#cf12) record, the value MUST be different from 0x0000000B. + +### ColRelNegU + +The **ColRelNegU** structure specifies the zero-based column index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) offset information for this column index and a corresponding row index. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
colAB
+ +**col (14 bits):** A signed integer that specifies the zero-based column index or offset of a column in the sheet that contains this structure. MUST be greater than or equal to -255 be less than or equal to 255. + +**A - colRelative (1 bit):** A bit that specifies whether **col** is an offset. + +**B - rowRelative (1 bit):** bit that specifies whether a row index corresponding to **col** in the structure containing this structure is an offset. + +### ColRelU + +The **ColRelU** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and [**relative reference**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) information for this column index and a corresponding row index. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
colAB
+ +**col (14 bits):** An unsigned integer that specifies the zero-based index of a column in the sheet that contains this structure. MUST be less than or equal to 0x00FF. + +**A - colRelative (1 bit):** A bit that specifies whether **col** is a relative reference. + +**B - rowRelative (1 bit):** A bit that specifies whether a row index corresponding to **col** in the structure containing this structure is a relative reference. + +### ColSlco8U + +The **ColSlco8U** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and information about whether a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) has been deleted. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
colAB
+ +**col (14 bits):** An unsigned integer that specifies the zero-based index of a column in the sheet that contains this structure. MUST be less than or equal to 0x00FF. + +**A - fDeleted (1 bit):** A bit that specifies whether the cell that is referenced by the containing structure, has been deleted. When set to 1, the [**cell reference**](#gt_4d15aeb2-3a7d-44d7-b8d1-8a441f1cc24f) of the containing structure MUST be ignored. + +**B - unused (1 bit):** Undefined and MUST be ignored. + +### ColU + +The **ColU** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
col
+ +**col (2 bytes):** An unsigned integer that specifies the zero-based index of a column in the sheet that contains this structure. MUST be less than or equal to 0x00FF. + +### Colx + +The **Colx** structure specifies the zero-based column index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
col
+ +**col (2 bytes):** An unsigned integer that specifies the zero-based column index of a column in the sheet. The value MUST be 0, 0xFF or be greater than or equal to the **colMic** field of the [Dimensions](#dimensions) record of the sheet that contains this structure and less than the **colMac** field of the Dimensions record of the sheet that contains this structure. + +### CondDataValue + +The **CondDataValue** structure specifies the conditional data information. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
condDataValue
reserved
+ +**condDataValue (4 bytes):** An unsigned integer that specifies a conditional data value. If [SortCond12](#sortcond12).**sortOn** is 0x1 or 0x2, it specifies the zero-based index of a [DXF](#dxf) record in the collection of DXF records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The referenced DXF specifies the formatting. If SortCond12.**sortOn** is 0x0, this MUST be zero, and MUST be ignored. + +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +### CondFmtStructure + +The **CondFmtStructure** structure specifies [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules that are associated with a set of cells in a containing [CondFmt12](#condfmt12) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccfAnID
refBound
...
sqref (variable)
...
+ +**ccf (2 bytes):** An unsigned integer that specifies the count of [CF12](#cf12) records that follow the containing record. MUST be greater than or equal to 0x0001. + +**A - fToughRecalc (1 bit):** A bit that specifies that the appearance of the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) requires significant processing. This information can be used to optimize the redraw of conditional formatting when data values change. + +For example, an application could determine that a conditional formatting rule that contains certain functions or a conditional formatting rule that takes more than a predetermined amount of time to calculate designates that the conditional formatting requires significant processing, and could set this bit to 1. + +**nID (15 bits):** An unsigned integer that identifies this record. + +**refBound (8 bytes):** A [Ref8U](#ref8u) structure that specifies bounds of the set of cells to which the rules are applied. The set of cells that it represents MUST include all of the cells represented by field **sqref**. + +**sqref (variable):** A [SqRefU](#sqrefu) structure that specifies the cells to which the conditional formatting rules apply. **sqref.cref** MUST be greater than zero and less than or equal to 1026. + +### ConnGrbitDbt + +The **ConnGrbitDbt** structure is a 2 byte variable-type structure that specifies [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9) properties for the containing record. Its meaning depends on the value of the **dbt** field of the containing record. + +| Value | Meaning | +|----|----| +| 4 | A [ConnGrbitDbtWeb](#conngrbitdbtweb) that specifies the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) flags for a Web data connection. | +| 5 | A [ConnGrbitDbtOledb](#conngrbitdbtoledb) that specifies the query flags for an [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) data connection. | +| 7 | A [ConnGrbitDbtAdo](#conngrbitdbtado) that specifies the query flags for an [**ADO**](#gt_3477d72a-874b-4a2a-b6a9-1431c128df49) data connection. | +| Any other value | A 2 byte unsigned integer. Unused and MUST be 0. | + +### ConnGrbitDbtAdo + +The **ConnGrbitDbtAdo** structure specifies the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) flags for an [**ADO**](#gt_3477d72a-874b-4a2a-b6a9-1431c128df49) data connection. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
reserved1Areserved2
+ +**reserved1 (8 bits):** MUST be zero and MUST be ignored. + +**A - fAdoRefreshable (1 bit):** A bit that specifies if the ADO query can be refreshed. + +**reserved2 (7 bits):** MUST be zero and MUST be ignored. + +### ConnGrbitDbtOledb + +The **ConnGrbitDbtOledb** structure specifies the [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9) properties for an [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) data connection. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
dbostABCDEFGHIJ
+ +**dbost (3 bits):** An unsigned integer that specifies the OLE DB command type. This field applies to the database command strings that are saved with the parent records. MUST be a value from the following table: + +| Name | Value | Meaning | +|----|----|----| +| CMDNULL | 0x0 | The string is not specified. | +| CMDCUBE | 0x1 | The string specifies the name of a [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7) within an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) database, see also [OLAP Connections](#Section_068796f9e5154dab8e69f9a7b52aaa9a). | +| CMDSQL | 0x2 | The string specifies an [**SQL**](#gt_37416b0f-ca5b-4fac-96e5-082eb80a3d84) statement. | +| CMDTABLE | 0x3 | The string specifies a database table name. | +| CMDDEFALT | 0x4 | The string specifies a statement in the default language of the database. | +| CMDSPLIST | 0x5 | The string specifies a list from a Web-based data provider. | + +**A - fLocalConn (1 bit):** A bit that specifies which connection string to use for this external connection. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Uses the main connection string, as specified by a value of 0 in the **fLocal** field in [OleDbConn](#oledbconn), or by a value of 0 or 1 in the **rgIOleDbValid** of a [DConnConnectionOleDb](#dconnconnectionoledb). | +| 0x1 | Uses the alternate connection string, as specified by a value of 1 in the **fLocal** field in OleDbConn, or by a value of 2 or 3 in the **rgIOleDbValid** of a DConnConnectionOleDb. | + +**B - fNoRefreshCube (1 bit):** A bit that specifies whether any local cache of data from the OLAP [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is to be flushed when the a refresh is done. The value zero specifies any local cache of data from the OLAP data source is to be flushed when the a refresh is done. MUST be zero and MUST be ignored if the **dbost** field does not equal 0x1. + +**C - fUseOfficeLcid (1 bit):** A bit that specifies whether the user’s [**locale**](#gt_7b78ebef-e35d-45ab-abfd-4121b60995de) information is provided to the OLAP data source for retrieval of translated data and errors. MUST be zero and MUST be ignored if the **dbost** field does not equal 0x1. + +**D - fSrvFmtNum (1 bit):** A bit that specifies whether to apply OLAP data source number formatting to the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). MUST be zero and MUST be ignored if the **dbost** field does not equal 0x1. + +**E - fSrvFmtBack (1 bit):** A bit that specifies whether to apply OLAP data source [**fill**](#gt_215c1c51-d5ef-46af-8596-d7ef63c1fe89) colors to the PivotTable. MUST be zero and MUST be ignored if the **dbost** field does not equal 0x1. + +**F - fSrvFmtFore (1 bit):** A bit that specifies whether to apply OLAP data source [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) colors to the PivotTable. MUST be zero and MUST be ignored if the **dbost** field does not equal 0x1. + +**G - fSrvFmtFlags (1 bit):** A bit that specifies whether to apply OLAP data source font formatting to the PivotTable. MUST be zero and MUST be ignored if the **dbost** field does not equal 0x1. + +**H - fSupportsLangCellProp (1 bit):** A bit that specifies whether the user’s locale information is provided to the OLAP data source to support [**member (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) [**localization**](#gt_c26ef2a9-60ae-4cba-a409-5202571f152c). MUST be zero and MUST be ignored if the **dbost** field does not equal 0x1. + +**I - fSrvSupportsClientCube (1 bit):** A bit that specifies that the server supports local embedded data storage. + +**J - reserved (4 bits):** MUST be zero and MUST be ignored. + +### ConnGrbitDbtWeb + +The **ConnGrbitDbtWeb** structure specifies the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) flags for a Web data connection. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ABCDEFreserved
+ +**A - fParsePreFormatted (1 bit):** A bit that specifies how text enclosed in \ tags is handled. + +| Value | Meaning | +|----|----| +| 0x0 | Each row of text enclosed in \ tags will be imported as a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). | +| 0x1 | The text is parsed as tables. | + +**B - fConsecDelim (1 bit):** A bit that specifies how consecutive delimiters are treated. + +| Value | Meaning | +|-------|----------------------------------------------------------------| +| 0x0 | Each consecutive delimiter is treated as a separate delimiter. | +| 0x1 | Consecutive delimiters is treated as a single delimiter. | + +**C - fSameSettings (1 bit):** A bit that specifies how tables inside \ blocks are parsed. + +| Value | Meaning | +|----|----| +| 0x0 | Each [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) is parsed separately. | +| 0x1 | All tables are parsed with the same width settings as the first row of the first table. | + +**D - fXL97Format (1 bit):** A bit that specifies whether the query was created by a specific version of the application[\<156\>](#Appendix_A_156). + +| Value | Meaning | +|----|----| +| 0x0 | The query was created by specific versions of the application[\<157\>](#Appendix_A_157). | +| 0x1 | The query was created by a specific version of the application[\<158\>](#Appendix_A_158). | + +**E - fNoDateRecog (1 bit):** A bit that specifies how dates are imported. + +| Value | Meaning | +|-------|--------------------------------------------| +| 0x0 | Dates are imported as values of type date. | +| 0x1 | Dates are imported as text. | + +**F - fRefreshedInXl9 (1 bit):** A bit that specifies whether the query was refreshed in a specific version of the application[\<159\>](#Appendix_A_159). + +**reserved (10 bits):** MUST be zero and MUST be ignored. + +### ControlInfo + +The **ControlInfo** structure specifies the properties of some [**form**](#gt_c7858bfa-d4d2-48a7-ac9c-d2e90fbe3590) control in a [Dialog Sheet](#Section_da37feb48b9a462d87772a5fddd4866e). The control MUST be a group, radio button, label, button or checkbox. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDreserved1accel1
reserved2
+ +**A - fDefault (1 bit):** A bit that specifies whether this control dismisses the Dialog Sheet and performs the default behavior. If the control is not a button, the value MUST be 0. + +**B - fHelp (1 bit):** A bit that specifies whether this control is intended to load context-sensitive help for the Dialog Sheet. If the control is not a button, the value MUST be 0. + +**C - fCancel (1 bit):** A bit that specifies whether this control dismisses the Dialog Sheet and take no action. If the control is not a button, the value MUST be 0. + +**D - fDismiss (1 bit):** A bit that specifies whether this control dismisses the Dialog Sheet. If the control is not a button, the value MUST be 0. + +**reserved1 (12 bits):** MUST be zero and MUST be ignored. + +**accel1 (2 bytes):** A signed integer that specifies the [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) character of the control’s [**accelerator key**](#gt_d61b4a07-b6c1-4c08-9ebd-1d00b360f953). The value MUST be greater than or equal to 0x0000. A value of 0x0000 specifies there is no accelerator associated with this control. + +**reserved2 (2 bytes):** Reserved. MUST be 0x0000. + +### CrtLayout12Mode + +The **CrtLayout12Mode** record specifies a layout mode. Each layout mode specifies a different meaning of the **x**, **y**, **dx**, and **dy** fields of [CrtLayout12](#crtlayout12) and [CrtLayout12A](#crtlayout12a). + +| Name | Value | Meaning | +|----|----|----| +| **L12MAUTO** | 0x0000 | Position and [**dimension (2)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) are determined by the application. **x**, **y**, **dx** and **dy** MUST be ignored. | +| **L12MFACTOR** | 0x0001 | **x** and **y** specify the offset of the top left corner, relative to its default position, as a fraction of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)). MUST be greater than or equal to -1.0 and MUST be less than or equal to 1.0. **dx** and **dy** specify the width and height, as a fraction of the chart area, MUST be greater than or equal to 0.0, and MUST be less than or equal to 1.0. | +| **L12MEDGE** | 0x0002 | **x** and **y** specify the offset of the upper-left corner; **dx** and **dy** specify the offset of the bottom-right corner. **x**, **y**, **dx** and **dy** are specified relative to the upper-left corner of the chart area (section 2.2.3.17) as a fraction of the chart area. **x**, **y**, **dx** and **dy** MUST be greater than or equal to 0.0, and MUST be less than or equal to 1.0. | + +### DataFunctionalityLevel + +The **DataFunctionalityLevel** is a 1 byte unsigned integer that specifies a [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6)[\<160\>](#Appendix_A_160). SHOULD[\<161\>](#Appendix_A_161) be 0, 1, or 3. MUST be greater than or equal to 0 and less than or equal to 254. + +### DataSourceType + +The **DataSourceType** enumeration specifies the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) types. + +| Name | Value | Meaning | +|----|----|----| +| **DBT_ODBC** | 0x0001 | [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e)-based source | +| **DBT_DAO** | 0x0002 | [**DAO**](#gt_0aa33fda-1d81-4d7a-aa7a-aae64b50674f)-based source | +| **DBT_WEB** | 0x0004 | [**Web query**](#gt_7f21a511-63e5-43a2-ad46-235ce53af5f2) | +| **DBT_OLEDB** | 0x0005 | [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31)-based source | +| **DBT_TXT** | 0x0006 | Text-based source created via [**text query**](#gt_c636d3ce-a120-4acf-91ac-40b3ec79593a) | +| **DBT_ADO** | 0x0007 | [**ADO**](#gt_3477d72a-874b-4a2a-b6a9-1431c128df49) record set | + +### DateAsNum + +The **DateAsNum** structure specifies a date and time value stored as an Xnum (section [2.5.342](#xnum)). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
dateNum
...
+ +**dateNum (8 bytes):** An Xnum that specifies a date and time value. The value uses the double-precision floating point number in the Xnum structure as follows: The integer part of the number specifies the date as a number of days from a base date[\<162\>](#Appendix_A_162), and the fractional part specifies the time of day as a fraction of a 24-hour day. The base date for the number of days is determined by the [**date system**](#gt_cfc29c5e-eb23-4077-b6eb-492f20f5c87f) used in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), as specified by the [Date1904](#date1904) record in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1), according to the following table: + +| Date system | Meaning | +|----|----| +| 1900 | A value of 1 to **dateNum** specifies 00:00:00 on January 1, 1900. | +| 1904 | A value of 0 to **dateNum** specifies 00:00:00 on January 1, 1904. | + +### DateUnit + +The **DateUnit** enumeration specifies the unit of measurement of a date value. + +| Name | Value | Meaning | +|--------------|--------|-----------------------------------| +| **DUDAYS** | 0x0000 | Time value is measured in days. | +| **DUMONTHS** | 0x0001 | Time value is measured in months. | +| **DUYEARS** | 0x0002 | Time value is measured in years. | + +### DCol + +The **DCol** structure specifies a count of column indexes in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
dcol
+ +**dcol (2 bytes):** An unsigned integer that specifies the count of column indexes in a sheet. + +### DColByteU + +The **DColByteU** structure specifies a count or difference of column indexes in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++ + + + + + + + + + + + + + + + + + +
01234567
dcol
+ +**dcol (1 byte):** An unsigned integer that specifies the count of column indexes in a sheet. + +### DConFile + +The **DConFile** structure specifies the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) file or workbook file and [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that contain a [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). This structure is used by the [DConBin](#dconbin), [DConRef](#dconref) and [DConName](#dconname) records. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
stFile (variable)
...
+ +**stFile (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) that specifies the workbook file or workbook file and sheet that contain the range specified in the DConBin, DConRef or DConName record. + +> MUST be a string that conforms to the following ABNF grammar: + +dcon-file = external-virt-path / self-reference + +external-virt-path = volume / unc-volume / rel-volume  / transfer-protocol / startup / alt-startup / library /  simple-file-path-dcon + +simple-file-path-dcon = %x0001 file-path   + +self-reference = %x0002 sheet-name + +> See [VirtualPath](#virtualpath) for the definition of the volume, unc-volume, rel-volume, transfer-protocol, startup, alt-startup, library, file-path and sheet-name rules used in the [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) grammar.  Note that the volume, unc-volume, rel-volume, transfer-protocol, startup, alt-startup, library, and file-path rules specify that an optional sheet name can be included.   +> +> If this structure is contained in a DConName or DConBin record and the [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) has a workbook scope, then this string MUST satisfy the external-virt-path rule and MUST NOT specify a sheet name.  Otherwise a sheet name MUST be specified. + +### DConnConnectionOleDb + +The **DConnConnectionOleDb** structure specifies data connection properties of an [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) data connection. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
nDrillthroughRows
cOleDbrgIOleDbValid (variable)
...
rgIOleDbInvalid (variable)
...
unusedrgConn (variable)
...
+ +**nDrillthroughRows (4 bytes):** An unsigned integer that specifies the maximum number of rows that the application will retrieve during a [**drillthrough**](#gt_e5a4d8db-0d30-4977-9cab-fb66457f0ff7) operation on a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) based on this data connection. + +**cOleDb (2 bytes):** An unsigned integer that specifies the number of [**connection strings**](#gt_03a9d0ca-2f10-4f3d-b910-052714a96f7d) associated with the OLE DB connection specified in **rgConn**. MUST be less than or equal to 4. MUST be equal to 0 if the **fStandAlone** field of the associated [DConn](#dconn) of structure is 0. + +**rgIOleDbValid (variable):** An array of 2-byte unsigned integers that specify the type of connection strings in **rgConn.** The size of the array MUST be equal to **cOleDb**. Each element of the array MUST be unique within **rgIOleDbValid**. Each element of the array MUST be from the following table: + +| Value | Meaning of string in rgConn | +|----|----| +| 0 | The main connection string of the connection. This element MUST exist. | +| 1 | The variant of the main connection string that has the password removed. | +| 2 | The connection string to the local [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7) file. | +| 3 | The variant of the connection string to the local cube file that has the password removed. | + +**rgIOleDbInvalid (variable):** Undefined and MUST be ignored. The size of the field, in bytes, MUST equal the value specified by the following formula: + +2 \* (4 – **cOleDb**) + +**unused (2 bytes):** Undefined and MUST be ignored. + +**rgConn (variable):** An array of [DConnUnicodeStringSegmented](#dconnunicodestringsegmented). The array specifies the connection strings associated with the OLE DB connection that correspond to the elements in **rgIOleDbValid**. The number of elements in the array MUST be equal to **cOleDb**. This field MUST NOT exist if **cOleDb** equals 0. The meaning of each item in **rgConn** is defined by the item with a matching index in **rgIOleDbValid** as defined in the table under **rgIOleDbValid.** + +### DConnConnectionWeb + +The **DConnConnectionWeb** structure specifies data connection properties of [**Web query**](#gt_7f21a511-63e5-43a2-ad46-235ce53af5f2) data connections. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgbURL (variable)
...
rgbWebPost (variable)
...
+ +**rgbURL (variable):** A [DConnStringSequence](#dconnstringsequence) that specifies the URL for a Web query. + +**rgbWebPost (variable):** A DConnStringSequence that specifies the **[post method](#gt_ab84d1e3-1d4d-4085-a25e-f05593820d67)** for a Web query. + +### DConnId + +The **DConnId** structure specifies the identifier of the object that a connection is associated with. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
bTypedata (variable)
...
+ +**bType (1 byte):** An unsigned integer that specifies the identifier type. MUST be a value as specified in the table listed under field **data**. + +**data (variable):** A variable field that specifies the identifier of the object whose type and meaning are dictated by the value of field **bType**, as specified in the following table: + +| bType Value | Meaning | +|----|----| +| 0 | This field does not exist. There is no associated object. | +| 1 | A [DConnUnicodeStringSegmented](#dconnunicodestringsegmented) that specifies the name of a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289). | +| 2 | An [SXStreamID](#sxstreamid) that specifies the stream in the [PivotCache storage](#Section_c5fb3f663ef64308ae3de59244159687). | + +### DConnParamBinding + +The **DConnParamBinding** structure that specifies a parameter’s binding value based on field **pbt** of structure [DConnParameter](#dconnparameter). + +| Value | Meaning | +|----|----| +| 0 | A [DConnUnicodeStringSegmented](#dconnunicodestringsegmented) that specifies the parameter prompt. | +| 1 | A [DConnParamBindingValType](#dconnparambindingvaltype) structure that specifies the parameter value as defined in the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2). | + +### DConnParamBindingValByte + +The **DConnParamBindingValByte** structure specifies the parameter binding. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
fValreserved1
reserved2
+ +**fVal (8 bits):** An unsigned integer that specifies the binding Boolean value. + +**reserved1 (24 bits):** MUST be zero and MUST be ignored. + +**reserved2 (4 bytes):** MUST be zero and MUST be ignored. + +### DConnParamBindingValInt + +The **DConnParamBindingValInt** structure specifies the parameter binding. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
val
reserved
+ +**val (4 bytes):** An unsigned integer that specifies the binding value. + +**reserved (4 bytes):** MUST be zero and MUST be ignored. + +### DConnParamBindingValString + +The **DConnParamBindingValString** structure specifies properties for a data connection parameter that has a string data type. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reserved
...
rgchBindingValueStr (variable)
...
+ +**reserved (8 bytes):** MUST be zero and MUST be ignored. + +**rgchBindingValueStr (variable):** A [DConnUnicodeStringSegmented](#dconnunicodestringsegmented) that specifies the value for a data connection parameter. + +### DConnParamBindingValType + +The **DConnParamBindingValType** structure specifies properties for a data connection parameter. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
wBindingValueGrbitrgbBindingValue (variable)
...
+ +**wBindingValueGrbit (2 bytes):** An unsigned integer that specifies the data type of the parameter. MUST be a value from the table as specified in the **rgbBindingValue** field. + +**rgbBindingValue (variable):** A variable type field whose type and meaning are specified by the value of **wBindingValueGrbit** as specified in the following table: + +| wBindingValueGrbit Value | Meaning | +|----|----| +| 0x0001 | An Xnum (section [2.5.342](#xnum)) that specifies the value for a parameter that has a numeric data type. | +| 0x0002 | A [DConnParamBindingValString](#dconnparambindingvalstring) that specifies the value for a parameter that has a string data type. | +| 0x0004 | A [DConnParamBindingValByte](#dconnparambindingvalbyte) that specifies the value for a parameter that has a Boolean data type. | +| 0x0800 | A [DConnParamBindingValInt](#dconnparambindingvalint) that specifies the value for a parameter that has an integer data type. | + +### DConnParameter + +The **DConnParameter** structure specifies a parameter of a [**parameterized query**](#gt_c68a3a26-317d-4a1d-9eff-c2630b53067c). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgchName (variable)
...
pbtreservedwTypeSql
AunusedparamBinding (variable)
...
+ +**rgchName (variable):** A [DConnUnicodeStringSegmented](#dconnunicodestringsegmented) that specifies the name of the parameter. + +**pbt (3 bits):** An unsigned integer that specifies the parameter type. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Prompt. User is prompted for the value of the parameter. | +| 0x1 | Value. The parameter value is specified in the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2). | + +**reserved (13 bits):** MUST be zero and MUST be ignored. + +**wTypeSql (2 bytes):** An [ODBCType](#odbctype) structure that specifies the [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) data type as returned by the ODBC provider of the data. This signed integer specifies the [**SQL**](#gt_37416b0f-ca5b-4fac-96e5-082eb80a3d84) data type. + +**A - fDefaultName (1 bit):** A bit that specifies whether a default name has been assigned by the application to the parameter. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------------------| +| 0x0 | The user specified a name for the parameter. | +| 0x1 | The application specified a name for the parameter. | + +**unused (15 bits):** Undefined and MUST be ignored. + +**paramBinding (variable):** A [DConnParamBinding](#dconnparambinding) structure that specifies the parameter’s bindings. + +### DConnStringSequence + +The **DConnStringSequence** structure specifies a sequence of strings. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cstrgString (variable)
...
+ +**cst (2 bytes):** An unsigned integer that specifies the number of strings in the **rgString** array. + +**rgString (variable):** An array of [DConnUnicodeStringSegmented](#dconnunicodestringsegmented) that specifies a segmented [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string. + +### DConnUnicodeStringSegmented + +The **DConnUnicodeStringSegmented** structure specifies a segmented Unicode string. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
st (variable)
...
+ +**st (variable):** An [XLUnicodeStringSegmented](#xlunicodestringsegmented) that specifies a segmented Unicode string. + +### DJoin + +The **DJoin** enumeration specifies the join type for two data operations. + +| Name | Value | Meaning | +|---------------|------------|---------| +| **DJOINNULL** | 0x00000000 | None | +| **DJOINAND** | 0x00000001 | And | +| **DJOINOR** | 0x00000002 | Or | + +### DRw + +The **DRw** structure specifies a count of row indexes in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
drw
+ +**drw (2 bytes):** An unsigned integer that specifies the count or difference of row indexes in a sheet. + +### DRwByteU + +The **DRwByteU** structure specifies a count of row indexes in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++ + + + + + + + + + + + + + + + + + +
01234567
drw
+ +**drw (1 byte):** An unsigned integer that specifies the count or difference of row indexes in a sheet. + +### Duce + +The **Duce** structure specifies additional undo data that is applied to an [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) that uses a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) if the [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) is rejected. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
duceStacked
duceRadical
...
...eptgrgloc (variable)
...
+ +**duceStacked (4 bytes):** A [DuceStacked](#ducestacked) that specifies additional undo data used for the natural language formula. + +**duceRadical (9 bytes):** A [DuceRadical](#duceradical) that specifies additional undo data used for the natural language formula. If **eptg** does not specify that this natural language formula is an ElfRadical, then this field is undefined and MUST be ignored. + +**eptg (1 byte):** An unsigned integer that specifies the type of natural language formula. **eptg** MUST equal the second byte of the [Ptg](#ptg) specified by the **ptg** field of the [Ducr](#ducr) that contains this structure. The type of the natural language formula is either ElfStacked or ElfRadical, neither or both. + +**eptg** MUST be a value from the following table. + +| Value | ElfStacked | ElfRadical | +|-------|------------|------------| +| 0x02 | No | No | +| 0x03 | No | No | +| 0x06 | No | No | +| 0x07 | No | No | +| 0x0A | No | Yes | +| 0x0B | Yes | Yes | +| 0x0D | Yes | No | +| 0x0F | Yes | No | + +ElfStacked: A natural language formula is considered to be stacked if more than one [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) is used for the label.ElfRadical: A natural language formula is considered to be radical if the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) refers to more than one cell. + +**rgloc (variable):** An array of [RRLoc](#rrloc) structures. The number of elements is specified by the **cLoc** field of **duceStacked**. MUST exist if and only if the type of the natural language formula as specified by **eptg** is ElfStacked. The **fNoDollarOnLabel** field of each RRLoc structure in the array is undefined and MUST be ignored. + +### DuceRadical + +The **DuceRadical** structure specifies additional undo data associated with a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
refRadical (optional)
...
unused (optional)
...
ptgRadical
+ +**refRadical (8 bytes):** A [Ref8U](#ref8u) that specifies the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) referenced by the natural language formula. MUST exist if and only if **ptgRadical** is a [PtgArea](#ptgarea). + +**unused (8 bytes):** An array of 1-byte signed integers. Undefined and MUST be ignored. MUST exist if and only if **ptgRadical** is equal to [PtgAreaErr](#ptgareaerr). + +**ptgRadical (1 byte):** An unsigned integer that specifies the next [Ptg](#ptg) in the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) associated with this natural language formula. MUST either by a PtgArea or a PtgAreaErr. + +### DuceStacked + +The type and meaning of the **DuceStacked** structure are specified by the type of the **eptg** field of the [Duce](#duce) structure that contains this structure, as specified in the following table: + +| Value | Meaning | +|----|----| +| 1 | This structure specifies an [SQElfFlags](#sqelfflags) that specifies additional undo data associated with the [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b). | +| 0 | This structure specifies an [RRLoc](#rrloc) that specifies the location affected by the natural language formula. | + +### Ducr + +The **Ducr** structure specifies undo data that is applied to an [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) that was affected by an [insertion / deletion of rows / columns revision](#Section_6241f2cd16874b319cab2ff269a8e892) or a [move cells revision](#Section_a04c9efd436f48a59adff4752a2411ba) if the [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) is rejected. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reserved1
iptgptgABreserved2
duce (variable)
...
duceRadical (optional)
...
ducr_cond_1 (variable)
...
ducr_cond_2 (optional)
...
+ +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**iptg (2 bytes):** An unsigned integer that specifies a zero-based index of a [Ptg](#ptg) structure in the array specified by the [Rgce](#rgce) structure associated with the affected expression. The referenced Ptg specifies which Ptg is affected by the revision. + +**ptg (1 byte):** The Ptg before the revision action occurred. + +**A - fLbl (1 bit):** A bit that specifies whether the affected expression is contained in a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + +**B - fUseSh2 (1 bit):** A bit that specifies whether the affected expression is on a different [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). MUST be zero for [RRDInsDel](#rrdinsdel). + +**reserved2 (6 bits):** MUST be zero, and MUST be ignored. + +**duce (variable):** A [Duce](#duce) that specifies additional undo data that is used for a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b). MUST exist if and only if **ptg** is equal to 0x18. + +**duceRadical (8 bytes):** A variable type field with the type and meaning determined by the value of **ptg**, as specified in the following table. MUST exist if and only if **ptg** is not equal to 0x18. + +| ptg Value | Type | +|----|----| +| [PtgRef](#ptgref) | A [RgceLoc8](#rgceloc8) that specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) reference originally contained by the expression. | +| [PtgRef3d](#ptgref3d) | A RgceLoc8 that specifies the cell reference originally contained by the expression. | +| [PtgArea](#ptgarea) | A [RgceArea](#rgcearea) that specifies a reference to a rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells originally contained by the expression. | +| [PtgArea3d](#ptgarea3d) | A RgceArea that specifies a reference to a rectangular range of cells originally contained by the expression. | +| All other values | MUST be zero, and MUST be ignored. | + +**ducr_cond_1 (variable):** A [DucrConditionalLbl](#ducrconditionallbl) that specifies defined name information associated with the affected expression. MUST exist if and only if **fLbl** equals 1. + +**ducr_cond_2 (6 bytes):** A [DucrConditionalNoLbl](#ducrconditionalnolbl) that specifies location information associated with the affected expression. MUST exist if and only if **fLbl** equals 0. + +### DucrConditionalLbl + +The **DucrConditionalLbl** structure specifies information associated with the [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) in the [Ducr](#ducr) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
tabidbuiltinIndexunused (optional)
...stDefName (variable)
...
+ +**tabid (2 bytes):** A [TabId](#tabid) that specifies the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing the defined name. A value of 0xFFFF specifies that the defined name is not associated with the sheet. + +**builtinIndex (1 byte):** An unsigned integer that specifies the identifier of a [**built-in name**](#gt_d40a51df-e96f-45ec-885d-6f936d172b39). MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------| +| 0x00 | Not a built-in name | +| 0x01 | The built-in name is "Consolidate_Area" | +| 0x02 | The built-in name is "Auto_Open" | +| 0x03 | The built-in name is "Auto_Close" | +| 0x04 | The built-in name is "Extract" | +| 0x05 | The built-in name is "Database" | +| 0x06 | The built-in name is "Criteria" | +| 0x07 | The built-in name is "Print_Area" | +| 0x08 | The built-in name is "Print_Titles" | +| 0x09 | The built-in name is "Recorder" | +| 0x0A | The built-in name is "Data_Form" | +| 0x0B | The built-in name is "Auto_Activate" | +| 0x0C | The built-in name is "Auto_Deactivate" | +| 0x0D | The built-in name is "Sheet_Title" | +| 0x0E | The built-in name is "\_FilterDatabase" | + +**unused (3 bytes):** Undefined and MUST be ignored. MUST exist if and only if **builtinIndex** is not equal to zero. + +**stDefName (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the defined name. MUST exist if and only if **builtinIndex** is equal to zero. + +### DucrConditionalNoLbl + +The **DucrConditionalNoLbl** structure specifies location information associated with the [Ducr](#ducr) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
tabidloc
...
+ +**tabid (2 bytes):** A [TabId](#tabid) that specifies the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing the affected [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106). + +**loc (4 bytes):** An [RRLoc](#rrloc) that specifies the location of the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) containing the affected expression. The **fQuotesOnLabel** and **fNoDollarOnLabel** fields in the RRLoc structure are undefined and MUST be ignored. + +### DwQsiFuture + +The **DwQsiFuture** structure specifies option flags for a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEFGHIreserved5reserved6
+ +**A - fPreserveFmt (1 bit):** A bit that specifies whether the user applied formatting is preserved. + +**B - fAutoFit (1 bit):** A bit that specifies whether columns be auto fit after a data [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060). + +**C - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**D - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**E - fExtDataList (1 bit):** A bit that specifies whether an [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) list is the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for the query table. + +**F - reserved3 (1 bit):** MUST be zero, and MUST be ignored. + +**G - fCreateQTList (1 bit):** A bit that specifies whether a query table list is to be created. + +**H - fDummyList (1 bit):** A bit that specifies whether a dummy query table list is created. + +**I - reserved4 (1 bit):** MUST be zero, and MUST be ignored. + +**reserved5 (7 bits):** MUST be zero, and MUST be ignored. + +**reserved6 (16 bits):** MUST be zero, and MUST be ignored. + +### DXFALC + +The **DXFALC** structure specifies the text alignment properties within a containing [DXFN](#dxfn) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
alcAalcvBtrotcIndentCDEunused
iIndent
+ +**alc (3 bits):** A [**HorizAlign**](#horizalign) that specifies the [**horizontal alignment**](#gt_f0e60ca8-51d5-4553-9126-3d89a4d08f90) of the text. + +**A - fWrap (1 bit):** A bit that specifies the text display when the text is wider than the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +| Value | Meaning | +|-------|----------------------------------------------| +| 0 | The text is truncated. | +| 1 | The text is wrapped into more than one line. | + +**alcv (3 bits):** A [**VertAlign**](#vertalign) that specifies the [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878) of the text. + +**B - fJustLast (1 bit):** A bit that specifies whether cell text is [**justify distributed**](#gt_11eced66-af2c-4391-8b45-87a60ad41483). If **fJustLast is** 1 the text is justify distributed and **alc** MUST be 0x7. + +**trot (8 bits):** An [XFPropTextRotation](#xfproptextrotation) that specifies the text rotation. + +**cIndent (4 bits):** An unsigned integer that specifies the absolute level of indentation. The absolute level of indentation will replace any previous indentation. MUST be ignored when **iIndent** is not 255. MUST be less than or equal to 15. + +**C - fShrinkToFit (1 bit):** A bit that specifies whether the character sizes in the text MUST be reduced so that the text fits in the cell. + +**D - fMergeCell (1 bit):** A bit that specifies that the cell MUST be merged. + +**E - iReadingOrder (2 bits):** A [**ReadingOrder**](#readingorder) that specifies the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361). If **fZeroInited** in the parent structure is zero, then it is undefined and MUST be ignored. + +**unused (8 bits):** Undefined and MUST be ignored. + +**iIndent (4 bytes):** A signed integer that specifies the relative level of indentation. The relative level of indentation will be added to any previous indentation. The value MUST be greater than or equal to -15 and less than or equal to 255. The value SHOULD[\<163\>](#Appendix_A_163) be greater than or equal to -15 and less than or equal to 15, or be equal to 255. The values -250 through 250 specify a relative indentation level, and the value 255 specifies the absence of a relative indentation level. + +### DXFBdr + +The **DXFBdr** structure specifies the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) of [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) borders in a containing [DXFN](#dxfn) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
dgLeftdgRightdgTopAicvLefticvRightBC
icvTopicvBottomicvDiagdgDiagunused
+ +**dgLeft (4 bits):** A [BorderStyle](#borderstyle) that specifies the grid [**line style**](#gt_a6d51057-258d-42cc-9920-6e08c10d2447) for the left [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) of the cell. + +**dgRight (4 bits):** A BorderStyle that specifies the grid line style for the right border of the cell. + +**dgTop (4 bits):** A BorderStyle that specifies the grid line style for the top border of the cell. + +**A - dgBottom (4 bits):** A BorderStyle that specifies the grid line style for the bottom border of the cell. + +**icvLeft (7 bits):** An [IcvXF](#icvxf) that specifies the color of the left border of the cell or unused. This value is unused and MUST be ignored if **dgLeft** is 0 or if the **glLeftNinch** field in the containing DXFN structure is 1. + +**icvRight (7 bits):** An IcvXF that specifies the color of the right border of the cell or unused. This value is unused and MUST be ignored if **dgRight** is 0 or if the **glRightNinch** field in the containing DXFN structure is 1. + +**B - bitDiagDown (1 bit):** A bit that specifies if the cell has a downward diagonal drawn. + +**C - bitDiagUp (1 bit):** A bit that specifies if the cell has an upward diagonal drawn. + +**icvTop (7 bits):** An IcvXF that specifies the color of the top border of the cell or unused. This value is unused and MUST be ignored if **dgTop** is 0 or if the **glTopNinch** field in the containing DXFN structure is 1. + +**icvBottom (7 bits):** An IcvXF that specifies the color of the bottom border of the cell or unused. This value is unused and MUST be ignored if **dgBottom** is 0 or if the **glBottomNinch** field in the containing DXFN structure is 1. + +**icvDiag (7 bits):** An IcvXF that specifies the color of the diagonals of the cell or unused. This value is unused and MUST be ignored if **dgDiag** is 0 or if the **glDiagDownNinch** and the **glDiagUpNinch** fields in the containing DXFN are both 1. + +**dgDiag (4 bits):** A BorderStyle that specifies the grid line style for the diagonals of the cell.. + +**unused (7 bits):** Undefined and MUST be ignored. + +### DXFFntD + +The **DXFFntD** structure specifies a [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) and its format attributes. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cchFontstFontName (variable)
...
unused1 (variable)
...
stxp (16 bytes)
...
...
icvFore
reserved
tsNinch
fSssNinch
fUlsNinch
fBlsNinch
unused2
ich
cch
iFnt
+ +**cchFont (1 byte):** An unsigned integer that specifies the number of characters of the font name string. + +**stFontName (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) that specifies the font name. MUST exist if and only if **cchFont** is greater than zero. The number of characters in the string is specified in **cchFont**. If **stFontName.fHighByte** equals 0x0, **cchFont** MUST be less than or equal to 62. If **stFontName.fHighByte** equals 0x1, **cchFont** MUST be less than or equal to 31. + +**unused1 (variable):** Undefined and MUST be ignored. The size of this field is 63 minus the size of the **stFontName** field. If the **stFontName** field doesn’t exist, the size of this field is 63. + +**stxp (16 bytes):** A [Stxp](#stxp) that specifies the font attributes. + +**icvFore (4 bytes):** An integer that specifies the color of the font. The value MUST be -1, 32767 or any of the valid values of the [IcvFont](#icvfont) structure. A value of -1 specifies that this value is ignored. A value of 32767 specifies that the color of the font is the default foreground text color. Any other value specifies the color of the font as specified in the IcvFont structure. + +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +**tsNinch (4 bytes):** A [Ts](#ts) structure that specifies how the value of **stxp.ts** is to be interpreted. If **tsNinch.ftsItalic** is set to 1 then the value of **stxp.ts.ftsItalic** MUST be ignored. If **tsNinch.ftsStrikeout** is set to 1 then the value of the **stxp.ts.ftsStrikeout** MUST be ignored. + +**fSssNinch (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the value of **stxp.sss** MUST be ignored. + +**fUlsNinch (4 bytes):** A Boolean that specifies whether the value of **stxp.uls** MUST be ignored. + +**fBlsNinch (4 bytes):** A Boolean that specifies whether the value of **stxp.bls** MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +**ich (4 bytes):** A signed integer that specifies the zero based index of the first character to which this font applies. MUST be greater than or equal to 0xFFFFFFFF. MUST be set to 0xFFFFFFFF when the font is to be updated. + +**cch (4 bytes):** A signed integer that specifies the number of characters to which this font applies. MUST be greater than or equal to **ich** field. MUST be set to 0xFFFFFFFF if the **ich** field is set to 0xFFFFFFFF. + +**iFnt (2 bytes):** An unsigned integer that specifies the font. If the value is 0 then the default font is used. If the value is greater than 0 then the font to be applied is determined by the font name specified in **stFontName**.  + +### DXFId + +The **DXFId** structure specifies a [DXF](#dxf) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
index
+ +**index (4 bytes):** An unsigned integer that specifies a zero-based index of a DXF record in the collection of DXF records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +### DXFN + +The **DXFN** structure specifies [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEFGHIJKLMNOPQRSTUVWXYZabcd
efgreserved2hdxfnum (variable)
...
dxffntd (variable)
...
dxfalc (optional)
...
dxfbdr (optional)
...
dxfpat (optional)
dxfprot (optional)
+ +**A - alchNinch (1 bit):** A bit that specifies whether the value of **dxfalc**.**alc** MUST be ignored. + +**B - alcvNinch (1 bit):** A bit that specifies whether the value of **dxfalc**.**alcv** MUST be ignored. + +**C - wrapNinch (1 bit):** A bit that specifies whether the value of **dxfalc.fWrap** MUST be ignored. + +**D - trotNinch (1 bit):** A bit that specifies whether the value of **dxfalc.trot** MUST be ignored. + +**E - kintoNinch (1 bit):** A bit that specifies whether the value of **dxfalc.fJustLast** MUST be ignored . + +**F - cIndentNinch (1 bit):** A bit that specifies whether the values of **dxfalc.cIndent** and **dxfalc.iIndent** MUST be ignored. + +**G - fShrinkNinch (1 bit):** A bit that specifies whether the value of **dxfalc.fShrinkToFit** MUST be ignored. + +**H - fMergeCellNinch (1 bit):** A bit that specifies whether the value of **dxfalc.fMergeCell** MUST be ignored. + +**I - lockedNinch (1 bit):** A bit that specifies whether the value of **dxfprot.fLocked** MUST be ignored. + +**J - hiddenNinch (1 bit):** A bit that specifies whether the value of **dxfprot.fHidden** MUST be ignored. + +**K - glLeftNinch (1 bit):** A bit that specifies whether the values of **dxfbdr.dgLeft** and **dxfbdr.icvLeft** MUST be ignored . + +**L - glRightNinch (1 bit):** A bit that specifies whether the values of **dxfbdr.dgRight** and **dxfbdr.icvRight** MUST be ignored. + +**M - glTopNinch (1 bit):** A bit that specifies whether the values of **dxfbdr.dgTop** and **dxfbdr.icvTop** MUST be ignored. + +**N - glBottomNinch (1 bit):** A bit that specifies whether the values of **dxfbdr.dgBottom** and **dxfbdr.icvBottom** MUST be ignored. + +**O - glDiagDownNinch (1 bit):** A bit that specifies whether the value of **dxfbdr.bitDiagDown** MUST be ignored. When both **glDiagDownNinch** and **glDiagUpNinch** are set to 1, the values of **dxfbdr.dgDiag** and **dxfbdr**.**icvDiag** MUST be ignored. + +**P - glDiagUpNinch (1 bit):** A bit that specifies whether the value of **dxfbdr.bitDiagUp** MUST be ignored. When both **glDiagDownNinch** and **glDiagUpNinch** are set to 1, the values of **dxfbdr.dgDiag** and **dxfbdr**.**icvDiag** MUST be ignored. + +**Q - flsNinch (1 bit):** A bit that specifies whether the value of **dxfpat.fls** MUST be ignored. + +**R - icvFNinch (1 bit):** A bit that specifies whether the value of **dxfpat.icvForeground** MUST be ignored. + +**S - icvBNinch (1 bit):** A bit that specifies whether the value of **dxfpat.icvBackground** MUST be ignored. + +**T - ifmtNinch (1 bit):** A bit that specifies whether the value of **dxfnum.ifmt** MUST be ignored. + +**U - fIfntNinch (1 bit):** A bit that specifies whether the value of **dxffntd.ifnt** MUST be ignored. + +**V - unused1 (1 bit):** Undefined and MUST be ignored. + +**W - reserved1 (3 bits):** MUST be zero and MUST be ignored. + +**X - ibitAtrNum (1 bit):** A bit that specifies whether number formatting information is part of this structure. + +**Y - ibitAtrFnt (1 bit):** A bit that specifies whether [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information is part of this structure. + +**Z - ibitAtrAlc (1 bit):** A bit that specifies whether alignment information is part of this structure. + +**a - ibitAtrBdr (1 bit):** A bit that specifies whether [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad) information is part of this structure. + +**b - ibitAtrPat (1 bit):** A bit that specifies whether pattern information is part of this structure. + +**c - ibitAtrProt (1 bit):** A bit that specifies whether rotation information is part of this structure. + +**d - iReadingOrderNinch (1 bit):** A bit that specifies whether the value of **dxfalc.iReadingOrder** MUST be ignored. + +**e - fIfmtUser (1 bit):** A bit that specifies that the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) used is a user-defined [**format string**](#gt_07085e26-506a-4b35-81ad-972464e277ff). When set to 1, **dxfnum** contains a format string. + +**f - unused2 (1 bit):** Undefined and MUST be ignored. + +**g - fNewBorder (1 bit):** A bit that specifies how the [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) formats apply to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +| Value | Description | +|----|----| +| 0 | Border formats apply to all cells in the range. | +| 1 | Border formats only apply to the [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) of the range. | + +For example, if the bit is set to 1 and there is a left border format, that left border format will only apply to the cells on the left edge of the range of cells. + +**reserved2 (12 bits):** MUST be zero and MUST be ignored. + +**h - fZeroInited (1 bit):** A bit that specifies whether the value of **dxfalc.iReadingOrder** MUST be taken into account. + +**dxfnum (variable):** A [DXFNum](#dxfnum) that specifies the number formatting. MUST exist if and only if **ibitAtrNum** is nonzero. + +**dxffntd (variable):** A [DXFFntD](#dxffntd) that specifies the font. MUST exist if and only if **ibitAtrFnt** is nonzero. + +**dxfalc (8 bytes):** A [DXFALC](#dxfalc) that specifies the text alignment properties. MUST exist if and only if **ibitAtrAlc** is nonzero. + +**dxfbdr (8 bytes):** A [DXFBdr](#dxfbdr) that specifies the border properties. MUST exist if and only if **ibitAtrBdr** is nonzero. + +**dxfpat (4 bytes):** A [DXFPat](#dxfpat) that specifies the pattern and colors. MUST exist if and only if **ibitAtrPat** is nonzero. + +**dxfprot (2 bytes):** A [DXFProt](#dxfprot) that specifies the [**protection**](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499) attributes. MUST exist if and only if **ibitAtrProt** is nonzero. + +### DXFN12 + +The **DXFN12** structure specifies [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6) and is an extension to [DXFN](#dxfn). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cbDxf
reserved (optional)dxfn (variable)
...
xfext (variable)
...
+ +**cbDxf (4 bytes):** An unsigned integer that specifies the size of the structure in bytes. If greater than zero, it MUST be the total byte count of **dxfn** and **xfext**. Otherwise it MUST be zero. + +**reserved (2 bytes):** MUST be zero and MUST be ignored. MUST be omitted when **cbDxf** is greater than zero. + +**dxfn (variable):** A DXFN that specifies part of the differential formatting. MUST be omitted if **cbDxf** is 0x00000000. + +**xfext (variable):** An [XFExtNoFRT](#xfextnofrt) that specifies extensions for the differential formatting. MUST be omitted if **cbDxf** is equal to the byte count of **dxfn**. + +### DXFN12List + +The **DXFN12List** structure specifies [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6) used by [table block-level formatting](#Section_0c7947ddc8874a69a5cbc14494d21034). This structure also specifies extensions to the [DXFN](#dxfn) formatting properties. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
dxfn (variable)
...
xfext (variable)
...
+ +**dxfn (variable):** A DXFN structure that specifies differential formatting used by table block-level formatting. + +**xfext (variable):** An [XFExtNoFRT](#xfextnofrt) structure that specifies the set of extensions to the differential formatting properties specified in **dxfn**. MUST exist if and only if the size of this structure is greater than the size of the **dxfn** field. + +### DXFN12NoCB + +The **DXFN12NoCB** structure specifies [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6) and is an extension to [DXFN](#dxfn). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
dxfn (variable)
...
xfext (variable)
...
+ +**dxfn (variable):** A DXFN that specifies part of the differential formatting. + +**xfext (variable):** An optional [XFExtNoFRT](#xfextnofrt) that specifies extensions for the differential formatting. + +### DXFNum + +The **DXFNum** structure specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) in a containing [DXFN](#dxfn) structure. Its type depends on the **fIfmtUser** field of DXFN + +| Value | Meaning | +|-------|---------------------------| +| 0 | [DXFNumIFmt](#dxfnumifmt) | +| 1 | [DXFNumUsr](#dxfnumusr) | + +### DXFNumIFmt + +The **DXFNumIFmt** structure specifies the number format in a containing [DXFN](#dxfn) structure when a format identifier is used. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
unusedifmt
+ +**unused (8 bits):** Undefined and MUST be ignored. + +**ifmt (8 bits):** An unsigned integer that specifies the identifier of the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) to use as specified in [IFmt](#ifmt). + +### DXFNumUsr + +The **DXFNumUsr** structure specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) in a containing [DXFN](#dxfn) structure when a [**format string**](#gt_07085e26-506a-4b35-81ad-972464e277ff) is used. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cbfmt (variable)
...
+ +**cb (2 bytes):** An unsigned integer that specifies the size of this structure, in bytes. + +**fmt (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the number format to use as specified in the **stFormat** field of [Format](#format). + +### DXFPat + +The **DXFPat** structure specifies the [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e) and color within a containing [DXFN](#dxfn) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
unused1flsicvForegroundicvBackgroundA
+ +**unused1 (10 bits):** Undefined and MUST be ignored. + +**fls (6 bits):** A [**FillPattern**](#fillpattern) that specifies the fill pattern. + +**icvForeground (7 bits):** An unsigned integer that specifies the color of the foreground of the cell. The value MUST be an [IcvXF](#icvxf) value. This value is unused and MUST be ignored if the **icvFNinch** field in the containing DXFN structure is 1. + +**icvBackground (7 bits):** An unsigned integer that specifies the color of the background of the cell. The value MUST be an IcvXF value. This value is unused and MUST be ignored if the **icvBNinch** field in the containing DXFN structure is 1. + +**A - unused2 (2 bits):** Undefined and MUST be ignored. + +### DXFProt + +The **DXFProt** structure specifies the protection attributes inside a containing [DXFN](#dxfn) structure. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ABreserved
+ +**A - fLocked (1 bit):** A bit that specifies if the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) content is locked when the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is protected. + +**B - fHidden (1 bit):** A bit that specifies if the cell content is hidden when the workbook is protected. + +**reserved (14 bits):** MUST be zero and MUST be ignored. + +### EnhancedProtection + +The **EnhancedProtection** structure specifies protection settings for [Shared Features](#Section_86882c8e8d6d46b3aafe006b9e1f18e2) of the Enhanced Protection type as specified by [SharedFeatureType](#sharedfeaturetype).ISFPROTECTION. These settings apply to a protected [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEFGHIJKLMNOreserved
+ +**A - iprotObjects (1 bit):** A bit that specifies whether [**linked objects**](#gt_cfc45e76-9219-4c47-9ef2-5832a172f795) or [**embedded objects**](#gt_708607be-8655-416e-93f3-b434e9ecbd56) can be edited. + +**B - iprotScenarios (1 bit):** A bit that specifies whether [**scenarios**](#gt_ee14f43c-19d8-467b-aa0b-e025635f6ba3) can be edited. + +**C - iprotFormatCells (1 bit):** A bit that specifies whether [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) can be formatted. + +**D - iprotFormatColumns (1 bit):** A bit that specifies whether columns can be formatted. + +**E - iprotFormatRows (1 bit):** A bit that specifies whether rows can be formatted. + +**F - iprotInsertColumns (1 bit):** A bit that specifies whether columns can be inserted. + +**G - iprotInsertRows (1 bit):** A bit that specifies whether rows can be inserted. + +**H - iprotInsertHyperlinks (1 bit):** A bit that specifies whether [**hyperlinks**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) can be inserted. + +**I - iprotDeleteColumns (1 bit):** A bit that specifies whether columns can be deleted. + +**J - iprotDeleteRows (1 bit):** A bit that specifies whether rows can be deleted. + +**K - iprotSelLockedCells (1 bit):** A bit that specifies whether locked cells can be selected. + +**L - iprotSort (1 bit):** A bit that specifies whether cells can be sorted. + +**M - iprotAutoFilter (1 bit):** A bit that specifies whether cells can be filtered. + +**N - iprotPivotTables (1 bit):** A bit that specifies whether [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) reports can be created or modified. + +**O - iprotSelUnlockedCells (1 bit):** A bit that specifies whether unlocked cells can be selected. + +**reserved (17 bits):** MUST be zero, and MUST be ignored. + +### ExternDdeLinkNoOper + +The **ExternDdeLinkNoOper** structure specifies the data for a [DDE data item](#Section_2492b742489e489f945187a703134708) in the [ExternName](#externname) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reserved
linkName (variable)
...
+ +**reserved (4 bytes):** MUST be 0 and MUST be ignored. + +**linkName (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) that specifies the DDE data item name. The value MUST be "StdDocumentName". + +### ExternDocName + +The **ExternDocName** structure specifies the data for an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2) in the [ExternName](#externname) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ixalsreserved
extName (variable)
...
nameDefinition (variable)
...
+ +**ixals (2 bytes):** If the external defined name specified by **extName** is a [**local name**](#gt_6f2787cc-ab35-4cc1-bebd-fb120864d320), this unsigned integer specifies a one-based index of an [XLUnicodestring](#xlunicodestring) in the **rgst** field of the preceding [SupBook](#supbook) record. The XLUnicodestring specifies the name of the sheet where the external defined name specified by **extName** is scoped. Otherwise this MUST be 0. The value MUST be less than or equal to the value of the **ctab** field in the preceding SupBook record. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**extName (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) that specifies the name of the external defined name. **extName.cch** MUST be less than or equal to 255. + +**nameDefinition (variable):** An [ExtNameParsedFormula](#extnameparsedformula) that specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) of the external defined name. + +### ExternOleDdeLink + +The **ExternOleDdeLink** structure specifies the data for an [OLE data item](#Section_11cff7c06cf34f8694bede7a72497e21) or a [DDE data item](#Section_2492b742489e489f945187a703134708) in the [ExternName](#externname) record. If the **fOleLink** field in the owned ExternName record is 1, the referenced item MUST be an OLE data item. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
lStgName
linkName (variable)
...
moper (variable)
...
+ +**lStgName (4 bytes):** An unsigned integer that specifies a [link storage](#Section_a05f262bbc9a44be88b4eba16b41ac6b) that specifies the linked [**OLE**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) object. This name of the link storage MUST be the concatenation of "LNK" and the eight byte hexadecimal representation of this value. The value MUST be 0 for a DDE data item. + +**linkName (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) that specifies the name of OLE data item or DDE data item. **linkName.cch** MUST be less than or equal to 255. + +**moper (variable):** An optional [MOper](#moper) that specifies current [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) values for the linked data. This field MUST exist if and only if + +(byte size of owning ExternName record – 6 – byte size of **linkName** \> 0). + +### ExtProp + +The **ExtProp** structure specifies an extension to a formatting property. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
extTypecb
extPropData (variable)
...
+ +**extType (2 bytes):** An unsigned integer that specifies the type of the extension. MUST be a value from the table as specified in the **extPropData** field. + +**cb (2 bytes):** An unsigned integer that specifies the size of this ExtProp structure. + +**extPropData (variable):** This field specifies the extension data. The size and data type of this field varies based on the property type as specified in **extType** as follows: + +| extType value | extPropData field Data and Meaning | +|----|----| +| 0x0004 | A [FullColorExt](#fullcolorext) that specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) interior [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a). | +| 0x0005 | A FullColorExt that specifies the cell interior [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c). | +| 0x0006 | An [XFExtGradient](#xfextgradient) that specifies a cell interior [**gradient fill**](#gt_35280309-5b22-4c17-be48-f06c37ffc685). | +| 0x0007 | A FullColorExt that specifies the top cell border color. | +| 0x0008 | A FullColorExt that specifies the bottom cell border color. | +| 0x0009 | A FullColorExt that specifies the left cell border color. | +| 0x000A | A FullColorExt that specifies the right cell border color. | +| 0x000B | A FullColorExt that specifies the diagonal cell border color. | +| 0x000D | A FullColorExt that specifies the cell text color. | +| 0x000E | A 2-byte unsigned integer that specifies a [**FontScheme**](#fontscheme). | +| 0x000F | A 2-byte unsigned integer that specifies the text [**indentation level**](#gt_2779d3df-3c50-44dc-9d2d-6996c4573aa9). MUST be less than or equal to 250. | + +### ExtRst + +The **ExtRst** structure specifies [**phonetic string**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77) data. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reservedcb
phs
rphssub (variable)
...
rgphruns (variable)
...
+ +**reserved (2 bytes):** MUST be 1, and MUST be ignored. + +**cb (2 bytes):** An unsigned integer that specifies the size, in bytes, of the phonetic string data. + +**phs (4 bytes):** A [Phs](#phs) that specifies the formatting information for the phonetic string. + +**rphssub (variable):** An [RPHSSub](#rphssub) that specifies the phonetic string. + +**rgphruns (variable):** An array of [PhRuns](#phruns). This specifies the [**phonetic text runs**](#gt_02ee536f-14c0-451a-9d66-111431897cac). Each PhRuns specifies a phonetic text run within **rphssub.st** that is displayed above a [**text run**](#gt_393612a7-9552-48b0-abf6-0371dbd6d553) in the **rgb** field of the [XLUnicodeRichExtendedString](#xlunicoderichextendedstring) that contains this structure. The first character of the phonetic text run is the character specified by the **ichFirst** field of PhRuns. The first character in the **rgb** field of the XLUnicodeRichExtendedString that contains this structure that the phonetic text run appears earlier is specified by the **ichMom** field of PhRuns. Each **ichMom** field of a PhRuns in the array MUST be less than the **ichMom** field of the subsequent PhRuns in the array. Each **ichFirst** field of a PhRuns in the array MUST be less than the **ichFirst** of the subsequent PhRuns in the array. The sum of the **cchMom** fields of all PhRuns in the array MUST be less than or equal to the number of characters in **rgb** field of the XLUnicodeRichExtendedString that contains this structure. The number of elements in this array is **rphssub.crun**. + +### FactoidData + +The **FactoidData** structure specifies information about a [**smart tag**](#gt_2f57a49a-d503-4605-8798-0e53bd637609). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABreservedpropertyBag (variable)
...
+ +**A - fDelete (1 bit):** A bit that specifies whether the smart tag is deleted. + +**B - fXMLBased (1 bit):** A bit that specifies whether the smart tag is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85)-based. For more information about XML-based smart tags, see [\[MSDN-OSTD\]](https://go.microsoft.com/fwlink/?LinkId=120036). + +**reserved (6 bits):** MUST be 0, and MUST be ignored. + +**propertyBag (variable):** A PropertyBag as defined in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.4.3 that specifies smart tag properties. Each entry in the PropertyBag is a pair of indexes into the **stringTable** field of the PropertyBagStore as defined in \[MS-OSHARED\] section 2.3.4.1 that specify the key/value pair representing a property of the smart tag. + +### Feat11CellStruct + +The **Feat11CellStruct** structure specifies a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
idxRow
idxField
+ +**idxRow (4 bytes):** An unsigned integer that specifies the row identifier of the row in the table. The row identifiers are stored in a table column with the **strName** of [Feat11FieldDataItem](#feat11fielddataitem) equal to "ID". The row identifier specified in this field MUST match a row identifier stored in the **LISTDATA** element of the [List Data](#Section_914f09bd8c944c099e8631dfe058f037) stream. It MUST also match a row identifier stored in the **LISTSCHEMA** element of the List Data stream, under the Field node, where the "name" attribute of the Field node is equal to "ID". + +**idxField (4 bytes):** An unsigned integer that specifies a column identifier. MUST be equal to the **idField** field of an item in the fielddata array of the containing [*TableFeatureType*](#tablefeaturetype) structure. + +### Feat11FdaAutoFilter + +The **Feat11FdaAutoFilter** structure specifies the definition of an automatically generated [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda), or [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cbAutoFilter
unusedrecAutoFilter (variable)
...
+ +**cbAutoFilter (4 bytes):** An unsigned integer that specifies the size, in bytes, of the **recAutoFilter** field. MUST be less than or equal to 2080 bytes. + +**unused (2 bytes):** Undefined and MUST be ignored. + +**recAutoFilter (variable):** An [AutoFilter](#autofilter) structure that specifies the filter that is applied to the [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) column. + +### Feat11FieldDataItem + +The **Feat11FieldDataItem** structure specifies a column of a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
idField
lfdt
lfxidt
ilta
cbFmtAgg
istnAgg
ABCDEFGHIJKunused2
cbFmtInsertRow
istnInsertRow
strFieldName (variable)
...
strCaption (variable)
...
dxfFmtAgg (variable)
...
dxfFmtInsertRow (variable)
...
AutoFilter (variable)
...
rgXmap (variable)
...
fmla (variable)
...
totalFmla (variable)
...
strTotal (variable)
...
wssInfo (variable)
...
qsif (optional)
dskHdrCache (variable)
...
+ +**idField (4 bytes):** An unsigned integer that specifies the identifier of the column. MUST be nonzero and MUST be unique within the **FieldData** array in the containing [TableFeatureType](#tablefeaturetype) structure. + +**lfdt (4 bytes):** An unsigned integer that specifies the column’s Web based data provider data type. If the **lt** field of the containing TableFeatureType structure is not set to 0x00000001, this field MUST be 0x00000000; otherwise it MUST be a value from the following table. For more details about the data types, see [\[MS-WSSTS\]](%5bMS-WSSTS%5d.pdf#Section_52b95801d55f4d63a1c3b4e857c43b31) section 2.3. + +| Value | Web Based Data Provider Data Type | +|------------|-----------------------------------------------------| +| 0x00000001 | Text | +| 0x00000002 | Number | +| 0x00000003 | Boolean | +| 0x00000004 | Date Time | +| 0x00000005 | Note | +| 0x00000006 | Currency | +| 0x00000007 | Lookup | +| 0x00000008 | Choice | +| 0x00000009 | [**URL**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) | +| 0x0000000A | Counter | +| 0x0000000B | Multiple Choices | + +**lfxidt (4 bytes):** An unsigned integer that specifies the column’s [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) data type. If the **lt** field of the containing TableFeatureType structure is not set to 0x00000002, this field MUST be 0x00000000; otherwise it MUST be a value from the following table. For more information about the data types, see [\[MSDN-SOM\]](https://go.microsoft.com/fwlink/?LinkID=156653&clcid=0x409). + +| Value | MS-XML Data Type | +|------------|-------------------------------------| +| 0x00001000 | SOMITEM_SCHEMA | +| 0x00001001 | SOMITEM_ATTRIBUTE | +| 0x00001002 | SOMITEM_ATTRIBUTEGROUP | +| 0x00001003 | SOMITEM_NOTATION | +| 0x00001100 | SOMITEM_IDENTITYCONSTRAINT | +| 0x00001101 | SOMITEM_KEY | +| 0x00001102 | SOMITEM_KEYREF | +| 0x00001103 | SOMITEM_UNIQUE | +| 0x00002000 | SOMITEM_ANYTYPE | +| 0x00002100 | SOMITEM_DATATYPE | +| 0x00002101 | SOMITEM_DATATYPE_ANYTYPE | +| 0x00002102 | SOMITEM_DATATYPE_ANYURI | +| 0x00002103 | SOMITEM_DATATYPE_BASE64BINARY | +| 0x00002104 | SOMITEM_DATATYPE_BOOLEAN | +| 0x00002105 | SOMITEM_DATATYPE_BYTE | +| 0x00002106 | SOMITEM_DATATYPE_DATE | +| 0x00002107 | SOMITEM_DATATYPE_DATETIME | +| 0x00002108 | SOMITEM_DATATYPE_DAY | +| 0x00002109 | SOMITEM_DATATYPE_DECIMAL | +| 0x0000210A | SOMITEM_DATATYPE_DOUBLE | +| 0x0000210B | SOMITEM_DATATYPE_DURATION | +| 0x0000210C | SOMITEM_DATATYPE_ENTITIES | +| 0x0000210D | SOMITEM_DATATYPE_ENTITY | +| 0x0000210E | SOMITEM_DATATYPE_FLOAT | +| 0x0000210F | SOMITEM_DATATYPE_HEXBINARY | +| 0x00002110 | SOMITEM_DATATYPE_ID | +| 0x00002111 | SOMITEM_DATATYPE_IDREF | +| 0x00002112 | SOMITEM_DATATYPE_IDREFS | +| 0x00002113 | SOMITEM_DATATYPE_INT | +| 0x00002114 | SOMITEM_DATATYPE_INTEGER | +| 0x00002115 | SOMITEM_DATATYPE_LANGUAGE | +| 0x00002116 | SOMITEM_DATATYPE_LONG | +| 0x00002117 | SOMITEM_DATATYPE_MONTH | +| 0x00002118 | SOMITEM_DATATYPE_MONTHDAY | +| 0x00002119 | SOMITEM_DATATYPE_NAME | +| 0x0000211A | SOMITEM_DATATYPE_NCNAME | +| 0x0000211B | SOMITEM_DATATYPE_NEGATIVEINTEGER | +| 0x0000211C | SOMITEM_DATATYPE_NMTOKEN | +| 0x0000211D | SOMITEM_DATATYPE_NMTOKENS | +| 0x0000211E | SOMITEM_DATATYPE_NONNEGATIVEINTEGER | +| 0x0000211F | SOMITEM_DATATYPE_NONPOSITIVEINTEGER | +| 0x00002120 | SOMITEM_DATATYPE_NORMALIZEDSTRING | +| 0x00002121 | SOMITEM_DATATYPE_NOTATION | +| 0x00002122 | SOMITEM_DATATYPE_POSITIVEINTEGER | +| 0x00002123 | SOMITEM_DATATYPE_QNAME | +| 0x00002124 | SOMITEM_DATATYPE_SHORT | +| 0x00002125 | SOMITEM_DATATYPE_STRING | +| 0x00002126 | SOMITEM_DATATYPE_TIME | +| 0x00002127 | SOMITEM_DATATYPE_TOKEN | +| 0x00002128 | SOMITEM_DATATYPE_UNSIGNEDBYTE | +| 0x00002129 | SOMITEM_DATATYPE_UNSIGNEDINT | +| 0x0000212A | SOMITEM_DATATYPE_UNSIGNEDLONG | +| 0x0000212B | SOMITEM_DATATYPE_UNSIGNEDSHORT | +| 0x0000212C | SOMITEM_DATATYPE_YEAR | +| 0x0000212D | SOMITEM_DATATYPE_YEARMONTH | +| 0x000021FF | SOMITEM_DATATYPE_ANYSIMPLETYPE | +| 0x00002200 | SOMITEM_SIMPLETYPE | +| 0x00002400 | SOMITEM_COMPLEXTYPE | +| 0x00004000 | SOMITEM_PARTICLE | +| 0x00004001 | SOMITEM_ANY | +| 0x00004002 | SOMITEM_ANYATTRIBUTE | +| 0x00004003 | SOMITEM_ELEMENT | +| 0x00004100 | SOMITEM_GROUP | +| 0x00004101 | SOMITEM_ALL | +| 0x00004102 | SOMITEM_CHOICE | +| 0x00004103 | SOMITEM_SEQUENCE | +| 0x00004104 | SOMITEM_EMPTYPARTICLE | +| 0x00000800 | SOMITEM_NULL | +| 0x00002800 | SOMITEM_NULL_TYPE | +| 0x00004801 | SOMITEM_NULL_ANY | +| 0x00004802 | SOMITEM_NULL_ANYATTRIBUTE | +| 0x00004803 | SOMITEM_NULL_ELEMENT | + +**ilta (4 bytes):** An unsigned integer that specifies the [**aggregation function**](#gt_f9b44a9d-68c4-4a28-b347-cce9eb5f8845) to use for the [**total row**](#gt_95e9bcf4-d644-4e96-9070-dbc80b4d1b28) of the column. MUST be a value from the following table: + +| Value | Aggregation Formula | +|----|----| +| 0x00000000 | No formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) | +| 0x00000001 | Average | +| 0x00000002 | Count | +| 0x00000003 | Count Numbers | +| 0x00000004 | Max | +| 0x00000005 | Min | +| 0x00000006 | Sum | +| 0x00000007 | Standard Deviation | +| 0x00000008 | Variance | +| 0x00000009 | Custom formula[\<164\>](#Appendix_A_164) | + +**cbFmtAgg (4 bytes):** An unsigned integer that specifies the size, in bytes, of the **dxfFmtAgg** field. + +**istnAgg (4 bytes):** An unsigned integer that specifies the zero-based index of the [Style](#style) record in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that is used for the total row of the column. If this value equals 0xFFFFFFFF, the total row of the column uses built-in [table styles](#Section_4ac7212b4aa74ece962526c58224ae80). + +**A - fAutoFilter (1 bit):** A bit that specifies whether the column has an [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). + +**B - fAutoFilterHidden (1 bit):** A bit that specifies whether the column has an AutoFilters that is not displayed. When this field is set to 1, **fAutoFilter** MUST be set to 1. + +**C - fLoadXmapi (1 bit):** A bit that specifies whether the **rgXmap** field is present. MUST be 0 if the **lt** field of the containing TableFeatureType structure is not equal to 0x00000002. + +**D - fLoadFmla (1 bit):** A bit that specifies whether the **fmla** field is present for a table whose [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is a Web based data provider list. MUST be 0 if the **lt** field of the containing TableFeatureType structure is not equal to 0x00000001. + +**E - unused1 (2 bits):** Undefined, and MUST be ignored. + +**F - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**G - fLoadTotalFmla (1 bit):** A bit that specifies whether the **totalFmla** field is present. SHOULD[\<165\>](#Appendix_A_165) be 1 if **ilta** is 0x00000009, MUST be 0 otherwise. + +**H - fLoadTotalArray (1 bit):** A bit that specifies whether the formula specified by **totalFmla** is an array formula. MUST be 0 when **fLoadTotalFmla** is 0. + +**I - fSaveStyleName (1 bit):** A bit that specifies whether the **dskHdrCache.strStyleName** field is present. + +**J - fLoadTotalStr (1 bit):** A bit that specifies whether the **strTotal** field is present. MUST be 0 when **ilta** is not 0x00000000. + +**K - fAutoCreateCalcCol (1 bit):** A bit that specifies whether the column has a calculated column formula. MUST be 0 if the **lt** field of the containing TableFeatureType structure is set to 0x00000001. + +**unused2 (20 bits):** Undefined, and MUST be ignored. + +**cbFmtInsertRow (4 bytes):** An unsigned integer that specifies the size, in bytes, of the **dxfFmtInsertRow** field. + +**istnInsertRow (4 bytes):** An unsigned integer that specifies the zero-based index of the Style record in the Globals Substream ABNF that is used for the [**insert row**](#gt_3b3c223b-83e0-4697-85eb-815af907b8a9) of the column. If this value equals 0xFFFFFFFF, the insert row of the column uses built-in table styles. + +**strFieldName (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the name of the column, as provided by the data source. MUST contain at least one character and less than or equal to 255 characters. MUST be unique within the **FieldData** array in the containing TableFeatureType structure if the **lt** field of the containing TableFeatureType structure is set to 0x00000001 or 0x00000003. + +**strCaption (variable):** An XLUnicodeString that specifies the caption of the column. MUST contain at least one character and less than or equal to 255 characters. MUST be unique within the **FieldData** array in the containing TableFeatureType structure. MUST be equal to the value within the header [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) at the location of the column title if the **crwHeader** field of the containing TableFeatureType structure is greater than 0. This field is present if and only if the **fSingleCell** field of the containing TableFeatureType structure is set to 0. MUST NOT contain the characters from the following table: + +| Invalid Characters | Unicode range | +|----|----| +| Lower control characters | 0x0000-0x0031 | +| Invalid Unicode surrogate pairs | High surrogate with a value of 0xD800 to 0xDBFF followed by a low surrogate with a value of 0xDC00 to 0xDFFF. | +| Reserved characters | 0xFFFE, 0xFFFF, 0xF00B | + +**dxfFmtAgg (variable):** A [DXFN12List](#dxfn12list) that specifies the formatting of the total row of the column, if different from the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) specified by **istnAgg** or built-in table styles. This field is present if and only if the **cbFmtAgg** field is greater than 0x00000000. + +**dxfFmtInsertRow (variable):** A DXFN12List that specifies the formatting of the insert row of the column, if different from the style specified by **istnInsertRow** or built-in table styles. This field is present if and only if the **cbFmtInsertRow** field is more than 0x00000000. + +**AutoFilter (variable):** A [Feat11FdaAutoFilter](#feat11fdaautofilter) that specifies the characteristics of the AutoFilter for the column. This field is present if and only if the **fAutoFilter** field of the containing TableFeatureType structure is set to 1. + +**rgXmap (variable):** A [Feat11XMap](#feat11xmap) structure that specifies the mapping to the column data within an XML data source. This field is present if and only if the **fLoadXmapi** bit is set to 1. + +**fmla (variable):** A [Feat11Fmla](#feat11fmla) structure that specifies the [**column formula**](#gt_7b63f871-4ee8-4516-94b7-4087034fd569) whose data source is a Web based data provider list. The specified formula applies to every row of the column, except the total row and the [**header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38). This field is present if and only if the **fLoadFmla** bit is set to 1. + +**totalFmla (variable):** A [Feat11TotalFmla](#feat11totalfmla) structure that specifies the formula to use for the total row of the column. This field is present if and only if the **fLoadTotalFmla** bit is set to 1. + +**strTotal (variable):** An XLUnicodeString structure that specifies the text to use for the total row of the column. MUST contain less than or equal to 32767 characters. This field is present if and only if the **fLoadTotalStr** bit is set to 1. + +**wssInfo (variable):** A [Feat11WSSListInfo](#feat11wsslistinfo) that specifies the relationship between the column and a Web based data provider list. This field is present if and only if the **lt** field of the containing TableFeatureType structure is set to 0x00000001. + +**qsif (4 bytes):** An unsigned integer that specifies the relationship between the column and its Microsoft Query data source. MUST be equal to the **idField** field of a [Qsif](#qsif) record within the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56). This field is present if and only if the **lt** field of the containing TableFeatureType structure is set to 0x00000003 (External data source). MUST be greater than zero and MUST be unique within the **FieldData** array in the containing TableFeatureType structure. + +**dskHdrCache (variable):** A [CachedDiskHeader](#cacheddiskheader) that specifies the column header formatting information. This field is present if and only if the **crwHeader** field of the containing TableFeatureType structure is set to 0x0000 and the **fSingleCell** field of the containing TableFeatureType structure is set to 0. + +### Feat11Fmla + +The **Feat11Fmla** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that is used as a [**column formula**](#gt_7b63f871-4ee8-4516-94b7-4087034fd569). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cbFmlargbFmla (variable)
...
+ +**cbFmla (2 bytes):** An unsigned integer that specifies the size, in bytes, of the **rgbFmla** field. + +**rgbFmla (variable):** A [ListParsedFormula](#listparsedformula) that specifies the [parsed expression](#Section_a795978bfa7845788e2dc07d78edae0e) of the column formula. + +### Feat11RgInvalidCells + +The **Feat11RgInvalidCells** structure specifies the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) linked to a Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) which could not be synchronized. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cCellInvalidrgCellInvalid (variable)
...
+ +**cCellInvalid (2 bytes):** An unsigned integer that specifies the number of items in the **rgCellInvalid** field. + +**rgCellInvalid (variable):** An array of [Feat11CellStruct](#feat11cellstruct) that specifies the cells that could not be synchronized with a Web-based data provider data source. + +### Feat11RgSharepointIdChange + +The **Feat11RgSharepointIdChange** structure specifies the identifier of modified rows in a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) linked to a Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). This information is used when synchronizing between the local copy of the table, and the Web-based data provider. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cIdrgId (variable)
...
+ +**cId (2 bytes):** An unsigned integer that specifies the number of elements in **rgId**. + +**rgId (variable):** An array of 4-byte unsigned integers that specifies identifiers of rows that were modified. The length of the array is specified by the **cId** field, and each entry of the array specifies the identifier of one row. The row identifier specified in this field MUST match a row identifier stored in the **LISTDATA** element of the [List Data](#Section_914f09bd8c944c099e8631dfe058f037) stream, as well as the row identifier stored in the column with a title "ID" in the table. + +### Feat11RgSharepointIdDel + +The **Feat11RgSharepointIdDel** structure specifies the identifier of deleted rows in a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) linked to a Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). This information is used when synchronizing between the local copy of the table, and the Web-based data provider. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cIdrgId (variable)
...
+ +**cId (2 bytes):** An unsigned integer that specifies the number of elements in **rgId**. + +**rgId (variable):** An array of 4-byte unsigned integers that specifies identifiers of rows that were deleted. The length of the array is specified by the **cId** field, and each entry of the array specifies the identifier of one row. The row identifier specified in this field MUST match a row identifier stored in the **LISTDATA** element of the [List Data](#Section_914f09bd8c944c099e8631dfe058f037) stream. + +### Feat11TotalFmla + +The **Feat11TotalFmla** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that can be used as a [**total row**](#gt_95e9bcf4-d644-4e96-9070-dbc80b4d1b28) formula[\<166\>](#Appendix_A_166). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgbFmlaTotal (variable)
...
+ +**rgbFmlaTotal (variable):** A [ListParsedFormula](#listparsedformula) or [ListParsedArrayFormula](#listparsedarrayformula) that specifies the [parsed expression](#Section_a795978bfa7845788e2dc07d78edae0e) of the total row formula. When the **fLoadTotalArray** field of the containing [Feat11FieldDataItem](#feat11fielddataitem) structure is set to 1, this field is a ListParsedArrayFormula; otherwise, it is a ListParsedFormula. + +### Feat11WSSListInfo + +The **Feat11WSSListInfo** structure specifies the relationship between a table column and a Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
LCID
cDec
ABCDEFGunused1
HIJKLMNObDefaultTypeunused2
rgbDV (variable)
...
strFormula (variable)
...
reserved
+ +**LCID (4 bytes):** An unsigned integer that specifies the [**language code identifier (LCID)**](#gt_c7f99c66-592f-4053-b62a-878c189653b6) of the source data. + +**cDec (4 bytes):** An unsigned integer that specifies the number of decimal places for a numeric column. + +**A - fPercent (1 bit):** A bit that specifies whether the numeric values in the column are displayed as percentages. + +**B - fDecSet (1 bit):** A bit that specifies whether the numeric values in the column are displayed with a fixed decimal point. The position of the decimal point is specified by the **cDec** field. + +**C - fDateOnly (1 bit):** A bit that specifies whether only the date part of date/time values is displayed. + +**D - fReadingOrder (2 bits):** An unsigned integer that specifies the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Reading order is determined by the application based on the reading order of the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) surrounding the table. | +| 0x1 | Reading order is [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067). | +| 0x2 | Reading order is [**right-to-left**](#gt_91359688-7863-4e88-b507-f57b3dada5ec). | + +**E - fRichText (1 bit):** A bit that specifies whether the column contains rich text. + +**F - fUnkRTFormatting (1 bit):** A bit that specifies whether the column contains unrecognized rich text formatting. + +**G - fAlertUnkRTFormatting (1 bit):** A bit that specifies whether the column contains unrecognized rich text formatting that requires notifying the user. + +**unused1 (24 bits):** Undefined and MUST be ignored. + +**H - fReadOnly (1 bit):** A bit that specifies whether the column is read only. + +**I - fRequired (1 bit):** A bit that specifies whether every item in this column has to contain data. + +**J - fMinSet (1 bit):** A bit that specifies whether a minimum numeric value for the column exists. The minimum value is stored in the [List Data](#Section_914f09bd8c944c099e8631dfe058f037) stream within the LISTSCHEMA element, under the Field node's Min attribute. + +**K - fMaxSet (1 bit):** A bit that specifies whether a maximum numeric value for the column exists. The maximum value is stored in the List Data stream within the LISTSCHEMA element, under the Field node's Max attribute. + +**L - fDefaultSet (1 bit):** A bit that specifies whether there is a default value for the column. + +**M - fDefaultDateToday (1 bit):** A bit that specifies whether the default value for the column is the current date. + +**N - fLoadFormula (1 bit):** A bit that specifies whether a validation formula exists for this column. The formula is specified by the **strFormula** field. + +**O - fAllowFillIn (1 bit):** A bit that specifies whether a choice field allows custom user entries. + +**bDefaultType (8 bits):** An unsigned integer that specifies the type of the **rgbDV** default value. This field MUST be ignored if **fDefaultSet** is not 0x1; otherwise, it MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------| +| 0x00 | There is no default value specified. | +| 0x01 | **rgbDV** is a string. | +| 0x02 | **rgbDV** is a Boolean. | +| 0x03 | **rgbDV** is a number. | + +**unused2 (16 bits):** Undefined, MUST be ignored. + +**rgbDV (variable):** A field of variable data type that specifies the default value for the column. The data type is specified in the **lfdt** field of the containing [Feat11FieldDataItem](#feat11fielddataitem) structure. MUST be one of the data types specified in the following table: + +| lfdt of the containing Feat11FieldDataItem | Data Type | rgbDV data type and meaning | +|----|----|----| +| 0x00000001 | Short Text | An [XLUnicodeString](#xlunicodestring) with a maximum length of 255 [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters. | +| 0x00000002 | Number | An Xnum (section [2.5.342](#xnum)). | +| 0x00000003 | Yes/No | A 32-bit Boolean (section [2.5.14](#boolean)). | +| 0x00000004 | Date time | A [DateAsNum](#dateasnum). | +| 0x00000005 | Invalid | **rgbDV** does not exist. | +| 0x00000006 | Currency | An Xnum. | +| 0x00000007 | Invalid | **rgbDV** does not exist. | +| 0x00000008 | Choice | An XLUnicodeString with a maximum length of 255 Unicode characters. | +| 0x00000009 | Invalid | **rgbDV** does not exist. | +| 0x0000000A | Invalid | **rgbDV** does not exist. | +| 0x0000000B | Multi-choice | An XLUnicodeString with a maximum length of 255 Unicode characters. | + +**strFormula (variable):** An XLUnicodeString that specifies the validation formula as defined by the Web based data provider. This field exists if and only if **fLoadFormula** is set to 0x1. + +**reserved (4 bytes):** MUST be 0x00000000, and MUST be ignored. + +### Feat11XMap + +The **Feat11XMap** structure specifies the mapping between a table column’s data and an XML [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iXmapMacrgXmap (variable)
...
+ +**iXmapMac (2 bytes):** An unsigned integer that specifies the number of items in the **rgXmap** array. MUST be less than or equal to 0x0001. + +**rgXmap (variable):** An array of [Feat11XMapEntry](#feat11xmapentry) that specifies the mapping between the current table column and an XML data source. The number of items in **rgXmap** MUST be equal to **iXmapMac**. + +### Feat11XMapEntry + +The **Feat11XMapEntry** structure specifies a mapping to an XML [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDreserved3
details (variable)
...
+ +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - fLoadXMap (1 bit):** MUST be 1, and MUST be ignored. + +**C - fCanBeSingle (1 bit):** A bit that specifies whether **details**.**rgbXPath** resolves to a single [**XML node**](#gt_76e94022-1e78-4323-b8ba-cf7776e6b8d4) or a collection of XML nodes. This field MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Specifies that **details**.**rgbXPath** resolves to a collection of XML nodes. | +| 1 | Specifies that **details**.**rgbXPath** resolves to a single XML node. | + +**D - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**reserved3 (28 bits):** MUST be zero, and MUST be ignored. + +**details (variable):** A [Feat11XMapEntry2](#feat11xmapentry2) that specifies the mapping between the data and the XML data source. + +### Feat11XMapEntry2 + +The **Feat11XMapEntry2** structure specifies the mapping to an [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
dwMapId
rgbXPath (variable)
...
+ +**dwMapId (4 bytes):** An unsigned integer that specifies the [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) associated with this [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) column. The value MUST equal the value of the **ID** attribute of a **Map** element contained within the **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)). + +**rgbXPath (variable):** An [XLUnicodeString](#xlunicodestring) that contains the [**XPath expression**](#gt_02004611-da4e-45c1-a960-d268be5bb72c) that specifies the mapped element in the XML schema specified by **dwMapId**. The length of this string MUST be less than 32000. + +### FeatFormulaErr2 + +The **FeatFormulaErr2** structure specifies formula evaluation information for a [Shared Feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2) of type ISFFEC2 as specified in [SharedFeatureType](#sharedfeaturetype). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
grffecIgnore
+ +**grffecIgnore (4 bytes):** A [FFErrorCheck](#fferrorcheck) that specifies the type of errors that will be ignored. + +### FeatProtection + +The **FeatProtection** structure specifies data for a [shared feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
Areserved
wPassword
stTitle (variable)
...
sdContainer (variable)
...
+ +**A - fSD (1 bit):** A bit that specifies whether this structure contains self-relative [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) data. For more information about self-relative security descriptors see [\[MSDN-ASRSD\]](https://go.microsoft.com/fwlink/?LinkId=119907). + +**reserved (31 bits):** MUST be zero, and MUST be ignored. + +**wPassword (4 bytes):** An unsigned integer that specifies the verifier for the password required to edit the referenced [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of a [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829) [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). A value of zero indicates that the password is empty. The algorithm to generate the password verifier is documented in the [password verifier algorithm](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4). + +**stTitle (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the title for this [**protection**](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499) feature. + +**sdContainer (variable):** An [SDContainer](#sdcontainer) that specifies security information that identifies who can edit the referenced ranges of a protected sheet without needing a password. + +### FeatSmartTag + +The **FeatSmartTag** structure specifies data for a [Shared Feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2) of type ISFFACTOID as described in [SharedFeatureType](#sharedfeaturetype). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hashValue
cSmartTagsrgFactoid (variable)
...
+ +**hashValue (4 bytes):** An unsigned integer that specifies a [**hash**](#gt_b7e2b611-0af5-4fec-8af2-3f9ce7bad205) value for the string representation of the content of a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). This hash value is used to detect cell changes with the purpose of validating, updating or removing the [**smart tags**](#gt_2f57a49a-d503-4605-8798-0e53bd637609) associated with the cell. If the string representation of the cell content is the empty string, **hashValue** MUST be 0; otherwise, **hashValue** MUST be computed using the following algorithm: + +424. SET hashValue to zero + + FOR each byteValue (1-byte unsigned integer) in the input string + + Bitwise shift hashValue to the left by 4 and add byteValue + + SET overflow (4-byte unsigned integer) to the bitwise AND of hashValue and 0xF0000000 + + IF overflow is not zero THEN + + SET the most significant 4 bits of hashValue to zero + + Bitwise shift overflow to the right by 24 + + SET hashValue to XOR of hashValue and overflow + + END IF + + END FOR + + IF hashValue is zero + + SET hashValue to 1 + + END IF + +**cSmartTags (1 byte):** An unsigned integer that specifies the number of items in the **rgFactoid** array. + +**rgFactoid (variable):** An array of [FactoidData](#factoiddata). Each element specifies data for a smart tag. + +### FFErrorCheck + +The **FFErrorCheck** structure specifies the types of error conditions that can be checked in a formula evaluation for a [Shared Feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEFGHreserved
+ +**A - ffecCalcError (1 bit):** A bit that specifies whether to check for calculation errors. + +**B - ffecEmptyCellRef (1 bit):** A bit that specifies whether to check for references to empty cells. + +**C - ffecNumStoredAsText (1 bit):** A bit that specifies whether to check the format of numeric values. + +**D - ffecInconsistRange (1 bit):** A bit that specifies whether to check formulas in the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of the shared feature with references to less than the entirety of a range containing continuous data. + +**E - ffecInconsistFmla (1 bit):** A bit that specifies whether to check formulas in the range of the shared feature that are inconsistent with formulas in neighboring cells. + +**F - ffecTextDateInsuff (1 bit):** A bit that specifies whether to check the format of date/time values. + +**G - ffecUnprotFmla (1 bit):** A bit that specifies whether to check for unprotected formulas. + +**H - ffecDataValidation (1 bit):** A bit that specifies whether to perform data validation. + +**reserved (24 bits):** MUST be zero, and MUST be ignored. + +### FillPattern + +The **FillPattern** enumeration specifies the [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e).[\<167\>](#Appendix_A_167) + +| Name | Value | Meaning | +|------------------|-------|------------------------------| +| **FLSNULL** | 0x00 | No fill pattern | +| **FLSSOLID** | 0x01 | Solid | +| **FLSMEDGRAY** | 0x02 | 50% gray | +| **FLSDKGRAY** | 0x03 | 75% gray | +| **FLSLTGRAY** | 0x04 | 25% gray | +| **FLSDKHOR** | 0x05 | Horizontal stripe | +| **FLSDKVER** | 0x06 | Vertical stripe | +| **FLSDKDOWN** | 0x07 | Reverse diagonal stripe | +| **FLSDKUP** | 0x08 | Diagonal stripe | +| **FLSDKGRID** | 0x09 | Diagonal crosshatch | +| **FLSDKTRELLIS** | 0x0A | Thick Diagonal crosshatch | +| **FLSLTHOR** | 0x0B | Thin horizontal stripe | +| **FLSLTVER** | 0x0C | Thin vertical stripe | +| **FLSLTDOWN** | 0x0D | Thin reverse diagonal stripe | +| **FLSLTUP** | 0x0E | Thin diagonal stripe | +| **FLSLTGRID** | 0x0F | Thin horizontal crosshatch | +| **FLSLTTRELLIS** | 0x10 | Thin diagonal crosshatch | +| **FLSGRAY125** | 0x11 | 12.5% gray | +| **FLSGRAY0625** | 0x12 | 6.25% gray | + +### FillStylePropertiesForShapePropsStreamChecksum + +The **FillStylePropertiesForShapePropsStreamChecksum** structure specifies the fill-style data used to compute the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the [ShapePropsStream](#shapepropsstream) record. + +The related [GelFrame](#gelframe) record referenced in the following field specifications is the GelFrame record that exists along with the ShapePropsStream record in one of the following sets of records. + +- A sequence of records that conforms to the [FRAME](#chart-sheet-substream) rule. + +- A sequence of records that conforms to the DROPBAR rule. + +- A sequence of records that conforms to the AXS rule if the **wObjContext** field in the ShapePropsStream record is equal to 0x0003. + +- A sequence of records that conforms to the SS rule. If multiple ShapePropsStream records exist in the set, then the ShapePropsStream record related to the GelFrame record MUST contain a **wObjContext** field value equal to 0x0001. If a single ShapePropsStream record exists in the set, it is related to the GelFrame record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
fillTypeOpid
fillType
fillColorOpid
fillColor
fillOpacityOpid
fillOpacity
fillBackColorOpid
fillBackColor
fillBackOpacityOpid
fillBackOpacity
fillCrModOpid
fillCrMod
fillBlipOpid
fillBlip
fillBlip_complex_md4uid (16 bytes)
...
...
fillBlipNameOpid
fillBlipName
fillBlipName_complex (variable)
...
fillBlipFlagsOpid
fillBlipFlags
fillWidthOpid
fillWidth
fillHeightOpid
fillHeight
fillAngleOpid
fillAngle
fillFocusOpid
fillFocus
fillToLeftOpid
fillToLeft
fillToTopOpid
fillToTop
fillToRightOpid
fillToRight
fillToBottomOpid
fillToBottom
fillRectLeftOpid
fillRectLeft
fillRectTopOpid
fillRectTop
fillRectRightOpid
fillRectRight
fillRectBottompOpid
fillRectBottom
fillDztypeOpid
fillDztype
fillShadePresetOpid
fillShadePreset
fillShadeColorsOpid
fillShadeColors
fillShadeColors_complex (variable)
...
fillOriginXOpid
fillOriginX
fillOriginYOpid
fillOriginY
fillShapeOriginXOpid
fillShapeOriginX
fillShapeOriginYOpid
fillShapeOriginY
fillShadeTypeOpid
fillShadeType
fillColorExtOpid
fillColorExt
reserved415Opid
reserved1
fillColorExtModOpid
fillColorExtMod
reserved417Opid
reserved2
fillBackColorExtOpid
fillBackColorExt
reserved419Opid
reserved3
fillBackColorExtModOpid
fillBackColorExtMod
reserved421Opid
reserved4
reserved422Opid
reserved5
reserved423Opid
reserved6
fillstyle_fFilledOpid
fillstyle_fFilled
fillstyle_ffillShapeOpid
fillstyle_ffillShape
fillstyle_ffillUseRectOpid
fillstyle_ffillUseRect
+ +**fillTypeOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillType property. MUST be 0x0180, which is the same value as the **opid.opid** field of the fillType property as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.3.7.1. + +**fillType (4 bytes):** An unsigned integer that specifies the fillType property. MUST equal the value specified by the **fillType** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillColorOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillColor property. MUST be 0x0181, which is the same value as the **opid.opid** field of the fillColor property as specified in \[MS-ODRAW\] section 2.3.7.2. + +**fillColor (4 bytes):** An unsigned integer that specifies the fillColor property. MUST equal the value specified by the **fillColor** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillOpacityOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillOpacity property. MUST be 0x0182, which is the same value as the **opid.opid** field of the fillOpacity property as specified in \[MS-ODRAW\] section 2.3.7.3. + +**fillOpacity (4 bytes):** An unsigned integer that specifies the fillOpacity property. MUST equal the value specified by the **fillOpacity** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillBackColorOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillBackColor property. MUST be 0x0183, which is the same value as the **opid.opid** field of the fillBackColor property as specified in \[MS-ODRAW\] section 2.3.7.4. + +**fillBackColor (4 bytes):** An unsigned integer that specifies the fillBackColor property. MUST equal the value specified by the **fillBackColor** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillBackOpacityOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillBackOpacity property. MUST be 0x0184, which is the same value as the **opid.opid** field of the fillBackOpacity property as specified in \[MS-ODRAW\] section 2.3.7.5. + +**fillBackOpacity (4 bytes):** An unsigned integer that specifies the fillBackOpacity property. MUST equal the value specified by the **fillBackOpacity** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillCrModOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillCrMod property. MUST be 0x0185, which is the same value as the **opid.opid** field of the fillCrMod property as specified in \[MS-ODRAW\] section 2.3.7.6. + +**fillCrMod (4 bytes):** An unsigned integer that specifies the fillCrMod property. MUST equal the value specified by the **fillCrMod** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillBlipOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillBlip property. MUST be 0x0186, which is the same value as the **opid.opid** field of the fillBlip property as specified in \[MS-ODRAW\] section 2.3.7.7. + +**fillBlip (4 bytes):** An unsigned integer that specifies the fillBlip property. MUST equal the value specified by the **fillBlip** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillBlip_complex_md4uid (16 bytes):** An MD4 digest, as specified in [\[RFC1320\]](https://go.microsoft.com/fwlink/?LinkId=90274), that MUST equal the value specified by the **fillBlip_complex.rgbUid1** field of the related GelFrame record. This field MUST be present when **fillBlip** is greater than zero. MUST NOT be present when **fillBlip** is zero. + +**fillBlipNameOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillBlipName property. MUST be 0x0187, which is the same value as the **opid.opid** field of the fillBlipName property as specified in \[MS-ODRAW\] section 2.3.7.9. + +**fillBlipName (4 bytes):** An unsigned integer that specifies the fillBlipName property. MUST equal the value specified by the **fillBlipName** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillBlipName_complex (variable):** A Unicode null-terminated string that MUST equal the value specified by the **fillBlipName_complex** field of the related GelFrame record. This field MUST be present when **fillBlipName** is greater than zero. MUST NOT be present when **fillBlipName** is zero. + +**fillBlipFlagsOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillBlipFlags property. MUST be 0x0188, which is the same value as the **opid.opid** field of the fillBlipFlags property as specified in \[MS-ODRAW\] section 2.3.7.11. + +**fillBlipFlags (4 bytes):** An unsigned integer that specifies the fillBlipFlags property. MUST equal the value specified by the **fillBlipFlags** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillWidthOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillWidth property. MUST be 0x0189, which is the same value as the **opid.opid** field of the fillWidth property as specified in \[MS-ODRAW\] section 2.3.7.12. + +**fillWidth (4 bytes):** An unsigned integer that specifies the fillWidth property. MUST equal the value specified by the **fillWidth** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillHeightOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillHeight property. MUST be 0x018A, which is the same value as the **opid.opid** field of the fillHeight property as specified in \[MS-ODRAW\] section 2.3.7.13. + +**fillHeight (4 bytes):** An unsigned integer that specifies the fillHeight property. MUST equal the value specified by the **fillHeight** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillAngleOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillAngle property. MUST be 0x018B, which is the same value as the **opid.opid** field of the fillAngle property as specified in \[MS-ODRAW\] section 2.3.7.14. + +**fillAngle (4 bytes):** An unsigned integer that specifies the fillAngle property. MUST equal the value specified by the **fillAngle** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillFocusOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillFocus property. MUST be 0x018C, which is the same value as the **opid.opid** field of the fillFocus property as specified in \[MS-ODRAW\] section 2.3.7.15. + +**fillFocus (4 bytes):** An unsigned integer that specifies the fillFocus property. MUST equal the value specified by the **fillFocus** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillToLeftOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillToLeft property. MUST be 0x018D, which is the same value as the **opid.opid** field of the fillToLeft property as specified in \[MS-ODRAW\] section 2.3.7.16. + +**fillToLeft (4 bytes):** An unsigned integer that specifies the fillToLeft property. MUST equal the value specified by the **fillToLeft** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillToTopOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillToTop property. MUST be 0x018E, which is the same value as the **opid.opid** field of the fillToTop property as specified in \[MS-ODRAW\] section 2.3.7.17. + +**fillToTop (4 bytes):** An unsigned integer that specifies the fillToTop property. MUST equal the value specified by the **fillToTop** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillToRightOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillToRight property. MUST be 0x018F, which is the same value as the **opid.opid** field of the fillToRight property as specified in \[MS-ODRAW\] section 2.3.7.18. + +**fillToRight (4 bytes):** An unsigned integer that specifies the fillToRight property. MUST equal the value specified by the **fillToRight** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillToBottomOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillToBottom property. MUST be 0x0190, which is the same value as the **opid.opid** field of the fillToBottom property as specified in \[MS-ODRAW\] section 2.3.7.19. + +**fillToBottom (4 bytes):** An unsigned integer that specifies the fillToBottom property. MUST equal the value specified by the **fillToBottom** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillRectLeftOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillRectLeft property. MUST be 0x0191, which is the same value as the **opid.opid** field of the fillRectLeft property as specified in \[MS-ODRAW\] section 2.3.7.20. + +**fillRectLeft (4 bytes):** An unsigned integer that specifies the fillRectLeft property. MUST equal the value specified by the **fillRectLeft** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillRectTopOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillRectTop property. MUST be 0x0192, which is the same value as the **opid.opid** field of the fillRectTop property as specified in \[MS-ODRAW\] section 2.3.7.21. + +**fillRectTop (4 bytes):** An unsigned integer that specifies the fillRectTop property. MUST equal the value specified by the **fillRectTop** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillRectRightOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillRectRight property. MUST be 0x0193, which is the same value as the **opid.opid** field of the fillRectRight property as specified in \[MS-ODRAW\] section 2.3.7.22. + +**fillRectRight (4 bytes):** An unsigned integer that specifies the fillRectRight property. MUST equal the value specified by the **fillRectRight** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillRectBottompOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillRectBottom property. MUST be 0x0194, which is the same value as the **opid.opid** field of the fillRectBottom property as specified in \[MS-ODRAW\] section 2.3.7.23. + +**fillRectBottom (4 bytes):** An unsigned integer that specifies the fillRectBottom property. MUST equal the value specified by the **fillRectbottom** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillDztypeOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillDztype property. MUST be 0x0195, which is the same value as the **opid.opid** field of the fillDztype property as specified in \[MS-ODRAW\] section 2.3.7.24. + +**fillDztype (4 bytes):** An unsigned integer that specifies the fillDztype property. MUST equal the value specified by the **fillDztype** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillShadePresetOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillShadePreset property. MUST be 0x0196, which is the same value as the **opid.opid** field of the fillShadePreset property as specified in \[MS-ODRAW\] section 2.3.7.25. + +**fillShadePreset (4 bytes):** An unsigned integer that specifies the fillShadePreset property. MUST equal the value specified by the **fillShadePreset** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillShadeColorsOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillShadeColors property. MUST be 0x0197, which is the same value as the **opid.opid** field of the fillShadeColors property as specified in \[MS-ODRAW\] section 2.3.7.26. + +**fillShadeColors (4 bytes):** An unsigned integer that specifies the number of bytes of data in the following **fillShadeColors_complex** field. + +**fillShadeColors_complex (variable):** An IMsoArray as specified in \[MS-ODRAW\] section 2.2.51 that specifies the fillShadeColors_complex property. This field MUST be present when **fillShadeColors** is greater than zero. MUST equal the value specified by the **fillShadeColors_complex** field of the related GelFrame record. MUST NOT be present when **fillShadeColors** is zero. + +**fillOriginXOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillOriginX property. MUST be 0x0198, which is the same value as the **opid.opid** field of the fillOriginX property as specified in \[MS-ODRAW\] section 2.3.7.28. + +**fillOriginX (4 bytes):** An unsigned integer that specifies the fillOriginX property. MUST equal the value specified by the **fillOriginX** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillOriginYOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillOriginY property. MUST be 0x0199, which is the same value as the **opid.opid** field of the fillOriginY property as specified in \[MS-ODRAW\] section 2.3.7.29. + +**fillOriginY (4 bytes):** An unsigned integer that specifies the fillOriginY property. MUST equal the value specified by the **fillOriginY** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillShapeOriginXOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillShapeOriginX property. MUST be 0x019A, which is the same value as the **opid.opid** field of the fillShapeOriginX property as specified in \[MS-ODRAW\] section 2.3.7.30. + +**fillShapeOriginX (4 bytes):** An unsigned integer that specifies the fillShapeOriginX property. MUST equal the value specified by the **fillShapeOriginX** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillShapeOriginYOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillShapeOriginY property. MUST be 0x019B, which is the same value as the **opid.opid** field of the fillShapeOriginY property as specified in \[MS-ODRAW\] section 2.3.7.31. + +**fillShapeOriginY (4 bytes):** An unsigned integer that specifies the fillShapeOriginY property. MUST equal the value specified by the **fillShapeOriginY** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillShadeTypeOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillShadeType property. MUST be 0x019C, which is the same value as the **opid.opid** field of the fillShadeType property as specified in \[MS-ODRAW\] section 2.3.7.32. + +**fillShadeType (4 bytes):** An unsigned integer that specifies the fillShadeType property. MUST equal the value specified by the **fillShadeType** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillColorExtOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillColorExt property. MUST be 0x019E, which is the same value as the **opid.opid** field of the fillColorExt property as specified in \[MS-ODRAW\] section 2.3.7.33. + +**fillColorExt (4 bytes):** An unsigned integer that specifies the fillColorExt property. MUST equal the value specified by the **fillColorExt** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**reserved415Opid (4 bytes):** An unsigned integer that specifies the identifier of the reserved415 property. MUST be 0x019F, which is the same value as the **opid.opid** field of the reserved415 property as specified in \[MS-ODRAW\] section 2.3.7.34. + +**reserved1 (4 bytes):** MUST be 0xFFFFFFFF. + +**fillColorExtModOpid (4 bytes):** An unsigned integer that specifies the identifier of fillColorExtMod property. MUST be 0x01A0, which is the same value as the **opid.opid** field of the fillColorExtMod property as specified in \[MS-ODRAW\] section 2.3.7.35. + +**fillColorExtMod (4 bytes):** An unsigned integer that specifies the fillColorExtMod property. MUST equal the value specified by the **fillColorExtMod** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**reserved417Opid (4 bytes):** An unsigned integer that specifies the identifier of the reserved417 property. MUST be 0x01A1, which is the same value as the **opid.opid** field of the reserved417 property as specified in \[MS-ODRAW\] section 2.3.7.36. + +**reserved2 (4 bytes):** MUST be 0x00000000. + +**fillBackColorExtOpid (4 bytes):** An unsigned integer that specifies the identifier of fillBackColorExt property. MUST be 0x01A2, which is the same value as the **opid.opid** field of the fillBackColorExt property as specified in \[MS-ODRAW\] section 2.3.7.37. + +**fillBackColorExt (4 bytes):** An unsigned integer that specifies the fillBackColorExt property. MUST equal the value specified by the **fillBackcolorExt** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**reserved419Opid (4 bytes):** An unsigned integer that specifies the identifier of the reserved419 property. MUST be 0x01A3, which is the same value as the **opid.opid** field of the reserved419 property as specified in \[MS-ODRAW\] section 2.3.7.38. + +**reserved3 (4 bytes):** MUST be 0xFFFFFFFF. + +**fillBackColorExtModOpid (4 bytes):** An unsigned integer that specifies the identifier of fillBackColorExtMod property. MUST be 0x01A4, which is the same value as the **opid.opid** field of the fillBackColorExtMod property as specified in \[MS-ODRAW\] section 2.3.7.39. + +**fillBackColorExtMod (4 bytes):** An unsigned integer that specifies the fillBackColorExtMod property. MUST equal the value specified by the **fillBackColorExtMod** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**reserved421Opid (4 bytes):** An unsigned integer that specifies the identifier of the reserved421 property. MUST be 0x01A5, which is the same value as the **opid.opid** field of the reserved421 property as specified in \[MS-ODRAW\] section 2.3.7.40. + +**reserved4 (4 bytes):** MUST be 0x00000000. + +**reserved422Opid (4 bytes):** An unsigned integer that specifies the identifier of the reserved422 property. MUST be 0x01A6, which is the same value as the **opid.opid** field of the reserved422 property as specified in \[MS-ODRAW\] section 2.3.7.41. + +**reserved5 (4 bytes):** MUST be 0xFFFFFFFF. + +**reserved423Opid (4 bytes):** An unsigned integer that specifies the identifier of the reserved423 property. MUST be 0x01A7, which is the same value as the **opid.opid** field of the reserved423 property as specified in \[MS-ODRAW\] section 2.3.7.42. + +**reserved6 (4 bytes):** MUST be 0xFFFFFFFF. + +**fillstyle_fFilledOpid (4 bytes):** An unsigned integer that specifies the identifier of the fFilled property. MUST be 0x01BB. + +**fillstyle_fFilled (4 bytes):** An unsigned integer that specifies the fFilled property. MUST equal the value specified by the **fFilled** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillstyle_ffillShapeOpid (4 bytes):** An unsigned integer that specifies the identifier of the ffillShape property. MUST be 0x01BD. + +**fillstyle_ffillShape (4 bytes):** An unsigned integer that specifies the ffillShape property. MUST equal the value specified by the **ffillShape** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillstyle_ffillUseRectOpid (4 bytes):** An unsigned integer that specifies the identifier of the ffillUseRect property. MUST be 0x01BE. + +**fillstyle_ffillUseRect (4 bytes):** An unsigned integer that specifies the ffillUseRect property. MUST equal the value specified by the **ffillUseRect** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +### FontIndex + +The **FontIndex** structure specifies a [Font](#font) record in the file. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ifnt
+ +**ifnt (2 bytes):** An unsigned integer. If this value is less than 4, then it specifies a zero-based index of a Font record in the collection of Font records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). If this value is greater than 4, then it specifies a one-based index of a Font record in the collection of Font records in the Globals Substream. MUST NOT equal 4, and MUST be less than or equal to 1022. SHOULD[\<168\>](#Appendix_A_168) be less than or equal to 510. + +The Font records in the Globals Substream are organized into two sections. The first section contains four Font records which MUST be present and MUST be ordered as follows[\<169\>](#Appendix_A_169): + +| Ifnt value | Meaning | +|------------|--------------------------------------------------------------| +| 0 | Default [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) | +| 1 | Default font, bold | +| 2 | Default font, italic | +| 3 | Default font, bold and italic | + +The second section, which is optional, contains Font records for any additional font formatting properties present in the file. For example, the 5th Font record in the file is referred to by **ifnt** value 5. + +### FontInfo + +The **FontInfo** structure specifies a [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) entry used by the [FrtFontList](#frtfontlist) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
Areservedifnt
+ +**A - fScaled (1 bit):** A bit that specifies whether the fonts are scaled. MUST be a value from the following table[\<170\>](#Appendix_A_170): + +| Value | Meaning | +|----|----| +| 0x0 | Font has fixed size | +| 0x1 | Font scales with [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)) in a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), or [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) | + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +**ifnt (2 bytes):** A [FontIndex](#fontindex) that specifies the font used by the FrtFontList record. + +### FontScheme + +The **FontScheme** enumeration specifies the [**font scheme**](#gt_d2cfdc52-4222-46a7-8c1e-fffdcadcb973) to which this [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) belongs. When a font is part of a theme as specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) part 1, section 14.2.7, the font is categorized as a [**major scheme**](#gt_62199344-845e-47bc-84c0-8261e3820666) or a [**minor scheme**](#gt_04094b39-b410-4e14-99a0-a78e88b283f6). + +| Name | Value | Meaning | +|----|----|----| +| **XFSNONE** | 0x00 | No font scheme | +| **XFSMAJOR** | 0x01 | Major scheme | +| **XFSMINOR** | 0x02 | Minor scheme | +| **XFSNIL** | 0xFF | [**Ninched**](#gt_111030f3-1e81-469e-9b6e-f42f501189b1) state | + +### FormatRun + +The **FormatRun** structure specifies formatting information for a [**text run**](#gt_393612a7-9552-48b0-abf6-0371dbd6d553). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ichifnt
+ +**ich (2 bytes):** An unsigned integer that specifies the zero-based index of the first character of the text that contains the text run. When this record is used in an array, this value MUST be in strictly increasing order. + +**ifnt (2 bytes):** A [FontIndex](#fontindex) structure that specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). If **ich** is equal to the length of the text, this record is undefined and MUST be ignored. + +### FormulaValue + +The **FormulaValue** structure specifies the current value of a formula. It can be a numeric value, a Boolean value, an error value, a string value, or a blank string value. If **fExprO** is not 0xFFFF, the 8 bytes of this structure specify an Xnum (section [2.5.342](#xnum)). If **fExprO** is 0xFFFF, this structure specifies a Boolean value, an error value, a string value, or a blank string value. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
byte1byte2byte3byte4
byte5byte6fExprO
+ +**byte1 (1 byte):** If **fExprO** is 0xFFFF, **byte1** is an unsigned integer that specifies the formula value type and MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | String value. The string value is stored in a [String](#string) record that immediately follows this record. | +| 0x01 | Boolean value. | +| 0x02 | Error value. | +| 0x03 | Blank string value. | + +If **fExprO** is not 0xFFFF, **byte1** specifies the first byte of the Xnum. + +**byte2 (1 byte):** If **fExprO** is 0xFFFF, **byte2** is undefined and MUST be ignored. If **fExprO** is not 0xFFFF, **byte2** specifies the second byte of the Xnum (section 2.5.342). + +**byte3 (1 byte):** The meaning of byte3 is specified in the following table: + +| Value | Meaning | +|----|----| +| **fExprO** is 0xFFFF and **byte1** is 0x00 | **byte3** is undefined and MUST be ignored. | +| **fExprO** is 0xFFFF and **byte1** is 0x01 | **byte3** specifies a Boolean value. | +| **fExprO** is 0xFFFF and **byte1** is 0x02 | **byte3** specifies a [BErr](#berr). | +| **fExprO** is 0xFFFF and **byte1** is 0x03 | **byte3** is undefined and MUST be ignored. | +| **fExprO** is not 0xFFFF | **byte3** specifies the third byte of the Xnum. | + +**byte4 (1 byte):** If **fExprO** is 0xFFFF, **byte4** is undefined and MUST be ignored. If **fExprO** is not 0xFFFF, **byte4** specifies the fourth byte of the Xnum. + +**byte5 (1 byte):** If **fExprO** is 0xFFFF, **byte5** is undefined and MUST be ignored. If **fExprO** is not 0xFFFF, **byte5** specifies the fifth byte of the Xnum. + +**byte6 (1 byte):** If **fExprO** is 0xFFFF, **byte6** is undefined and MUST be ignored. If **fExprO** is not 0xFFFF, **byte6** specifies the sixth byte of the Xnum. + +**fExprO (2 bytes):** If **fExprO** is 0xFFFF, this structure specifies a Boolean value, an error value, a string value, or a blank string value. If **fExprO** is not 0xFFFF, **fExprO** specifies the last two bytes of the Xnum. + +### FrtFlags + +The **FrtFlags** structure specifies flags used in [future record](#Section_b660b67822684414839ed1ae9a4e4e85) headers. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ABreserved
+ +**A - fFrtRef (1 bit):** A bit that specifies whether the containing record specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The containing record does not specify a range of cells. The containing record’s ref8.rwFirst, ref8.rwLast, ref8.colFirst, and ref8.colLast fields SHOULD[\<171\>](#Appendix_A_171) all be zero. | +| 1 | The containing record specifies a range of cells. | + +**B - fFrtAlert (1 bit):** A bit that specifies whether to alert the user of possible problems when saving the file without having recognized this record. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +### FrtHeader + +The **FrtHeader** structure specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) type header. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rtgrbitFrt
reserved
...
+ +**rt (2 bytes):** An unsigned integer that specifies the record type identifier. MUST be identical to the record type identifier of the containing record. + +**grbitFrt (2 bytes):** An [FrtFlags](#frtflags) that specifies attributes for this record. The value of **grbitFrt.fFrtRef** MUST be zero. The value of **grbitFrt.fFrtAlert** MUST be zero. + +**reserved (8 bytes):** MUST be zero, and MUST be ignored. + +### FrtHeaderOld + +The **FrtHeaderOld** structure specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) type header. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rtgrbitFrt
+ +**rt (2 bytes):** An unsigned integer that specifies the record type identifier. MUST be identical to the record type identifier of the containing record. + +**grbitFrt (2 bytes):** An [FrtFlags](#frtflags) that specifies attributes for this record. The value of **grbitFrt.fFrtRef** MUST be zero. The value of **grbitFrt.fFrtAlert** MUST be zero. + +### FrtRefHeader + +The **FrtRefHeader** structure specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) type header. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rtgrbitFrt
ref8
...
+ +**rt (2 bytes):** An unsigned integer that specifies the record type identifier. MUST be identical to the record type identifier of the containing record. + +**grbitFrt (2 bytes):** A [FrtFlags](#frtflags) that specifies attributes for this record. The value of **grbitFrt.fFrtAlert** MUST be zero. + +**ref8 (8 bytes):** A [Ref8](#ref8) that references the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with the containing record. If **grbitFrt.fFrtRef** is zero then **ref8.rwFirst** MUST be zero, **ref8.rwLast** MUST be zero, **ref8.colFirst** MUST be zero, and **ref8.colLast** MUST be zero. + +### FrtRefHeaderNoGrbit + +The **FrtRefHeaderNoGrbit** structure specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) type header. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rtref8
...
...
+ +**rt (2 bytes):** An unsigned integer that specifies the record type identifier. MUST be identical to the record type identifier of the containing record. + +**ref8 (8 bytes):** A [Ref8U](#ref8u) that references the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with the containing record. + +### FrtRefHeaderU + +The **FrtRefHeaderU** structure specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) type header. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rtgrbitFrt
ref8
...
+ +**rt (2 bytes):** An unsigned integer that specifies the record type identifier. MUST be identical to the record type identifier of the containing record. + +**grbitFrt (2 bytes):** A [FrtFlags](#frtflags) that specifies attributes for this record. The value of **grbitFrt.fFrtAlert** MUST be zero. + +**ref8 (8 bytes):** A [Ref8U](#ref8u) that references the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with the containing record. If **rt** is [Feature11](#feature11) (0x0872) or [Feature12](#feature12) (0x0878), this field MUST be ignored. + +### FtCbls + +The **FtCbls** structure appears as part of an [Obj](#obj) record that represents a checkbox or radio button. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftcb
unused1
unused2
unused3
+ +**ft (2 bytes):** Reserved. MUST be 0x000A. + +**cb (2 bytes):** Reserved. MUST be 0x000C. + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +**unused3 (4 bytes):** Undefined and MUST be ignored. + +### FtCblsData + +The **FtCblsData** structure specifies the properties of the checkbox or radio button [Obj](#obj) that contains this FtCblsData. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftcb
fCheckedaccel
reservedAunused
+ +**ft (2 bytes):** Reserved. MUST be 0x0012. + +**cb (2 bytes):** Reserved. MUST be 0x0008. + +**fChecked (2 bytes):** An unsigned integer that specifies the state of the checkbox or radio button control. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The control is in an unchecked state. | +| 0x0001 | The control is in a checked state. | +| 0x0002 | The control is in a mixed state. The **fChecked** field MUST NOT have this value if the **cmo.ot** field of the Obj record that contains this FtPioGrbit is not equal to 0x0B. | + +**accel (2 bytes):** An unsigned integer that specifies the [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) character of the control’s [**accelerator key**](#gt_d61b4a07-b6c1-4c08-9ebd-1d00b360f953). A value of 0x0000 specifies there is no accelerator associated with this control. This field MUST be ignored unless this structure is used in the [Dialog Sheet Substream](#Section_da37feb48b9a462d87772a5fddd4866e). + +**reserved (2 bytes):** Reserved. MUST be 0x0000. + +**A - fNo3d (1 bit):** A bit that specifies whether the control is expected to be displayed without three-dimensional effects. + +**unused (15 bits):** Undefined and MUST be ignored. + +### FtCf + +The **FtCf** structure specifies the clipboard format of the picture-type [Obj](#obj) record containing this FtCf. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftcb
cf
+ +**ft (2 bytes):** Reserved. MUST be 0x0007. + +**cb (2 bytes):** Reserved. MUST be 0x0002. + +**cf (2 bytes):** An unsigned integer that specifies the Windows clipboard format of the data associated with the picture. This field’s value MUST be in the following table: + +| Value | Format | +|----|----| +| 0x0002 | Specifies the format of the picture is an enhanced [**metafile**](#gt_ae5f028e-7e28-4a0b-bec6-2c87913f7db7). | +| 0x0009 | Specifies the format of the picture is a bitmap. | +| 0xFFFF | Specifies the picture is in an unspecified format that is neither and enhanced metafile nor a bitmap. | + +### FtCmo + +The **FtCmo** structure specifies the common properties of the [Obj](#obj) record that contains this FtCmo. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftcb
otid
ABCDEFGHIJKLMNOPunused8
...unused9
...unused10
...
+ +**ft (2 bytes):** Reserved. MUST be 0x15. + +**cb (2 bytes):** Reserved. MUST be 0x12. + +**ot (2 bytes):** An unsigned integer that specifies the type of object represented by the Obj record that contains this FtCmo. MUST be a value from the following table: + +| Value | Type of Object | +|--------|------------------| +| 0x0000 | Group | +| 0x0001 | Line | +| 0x0002 | Rectangle | +| 0x0003 | Oval | +| 0x0004 | Arc | +| 0x0005 | Chart | +| 0x0006 | Text | +| 0x0007 | Button | +| 0x0008 | Picture | +| 0x0009 | Polygon | +| 0x000B | Checkbox | +| 0x000C | Radio button | +| 0x000D | Edit box | +| 0x000E | Label | +| 0x000F | Dialog box | +| 0x0010 | Spin control | +| 0x0011 | Scrollbar | +| 0x0012 | List | +| 0x0013 | Group box | +| 0x0014 | Dropdown list | +| 0x0019 | Note | +| 0x001E | OfficeArt object | + +**id (2 bytes):** An unsigned integer that specifies the identifier of this object. This object identifier is used by other types to refer to this object. The value of **id** MUST be unique among all Obj records within the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), [Macro Sheet Substream](#Section_0dddd943f77a4fc2bf92868acb4587f7) ABNF and [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF. + +**A - fLocked (1 bit):** A bit that specifies whether this object is [**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81). + +**B - reserved (1 bit):** Reserved. MUST be 0. + +**C - fDefaultSize (1 bit):** A bit that specifies whether the application is expected to choose the object’s size. + +**D - fPublished (1 bit):** A bit that specifies whether this is a [chart](#chart-2) object that is expected to be [**published**](#gt_8ffc383a-d4f1-4515-a8b5-874d84ab2d2b) the next time the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing it is published[\<172\>](#Appendix_A_172). This bit is ignored if the **fPublishedBookItems** field of the [BookExt_Conditional12](#bookext_conditional12) structure is zero. + +**E - fPrint (1 bit):** A bit that specifies whether the image of this object is intended to be included when printed. + +**F - unused1 (1 bit):** Undefined and MUST be ignored. + +**G - unused2 (1 bit):** Undefined and MUST be ignored + +**H - fDisabled (1 bit):** A bit that specifies whether this object has been disabled. + +**I - fUIObj (1 bit):** A bit that specifies whether this is an auxiliary object that can only be automatically inserted by the application (as opposed to an object that can be inserted by a user). + +**J - fRecalcObj (1 bit):** A bit that specifies whether this object is expected to be updated on load to reflect the values in the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) associated with the object. This field MUST be ignored unless the **pictFmla.key** field of the containing Obj exists and **pictFmla.key.fmlaListFillRange.cbFmla** of the containing Obj is not equal to 0. + +**K - unused3 (1 bit):** Undefined and MUST be ignored. + +**L - unused4 (1 bit):** Undefined and MUST be ignored. + +**M - fRecalcObjAlways (1 bit):** A bit that specifies whether this object is expected to be updated whenever the value of a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the range associated with the object changes. This field MUST be ignored unless the **pictFmla.key** field of the containing Obj exists and **pictFmla.key.fmlaListFillRange.cbFmla** of the containing Obj is not equal to 0. + +**N - unused5 (1 bit):** Undefined and MUST be ignored. + +**O - unused6 (1 bit):** Undefined and MUST be ignored. + +**P - unused7 (1 bit):** Undefined and MUST be ignored. + +**unused8 (4 bytes):** Undefined and MUST be ignored. + +**unused9 (4 bytes):** Undefined and MUST be ignored. + +**unused10 (4 bytes):** Undefined and MUST be ignored. + +### FtEdoData + +This structure specifies the properties of the edit box [Obj](#obj) record that contains this FtEdoData. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftcb
ivtEditfMultiLine
fVScrollid
+ +**ft (2 bytes):** Reserved. MUST be 0x0010. + +**cb (2 bytes):** Reserved. MUST be 0x0008. + +**ivtEdit (2 bytes):** An unsigned integer that specifies what input [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) is expected to be performed by this edit box. MUST be a value from the following table: + +| Value | Strings accepted by validation | +|----|----| +| 0x0000 | Any string; no validation is expected. | +| 0x0001 | An integer. | +| 0x0002 | A number. | +| 0x0003 | A [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) reference. | +| 0x0004 | A formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). | + +**fMultiLine (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether this edit box supports multiple lines of text. MUST be a value from the following table: + +| Value | Meaning | +|--------|-------------------------------| +| 0x0000 | Only one line is supported. | +| 0x0001 | Multiple lines are supported. | + +**fVScroll (2 bytes):** A Boolean that specifies whether this edit box contains a vertical scrollbar. MUST be a value from the following table: + +| Value | Meaning | +|--------|--------------------------------------------| +| 0x0000 | Scrollbar is expected not to be displayed. | +| 0x0001 | Scrollbar is expected to be displayed. | + +**id (2 bytes):** An [ObjId](#objid) that specifies the associated list control. The associated list control is the control specified by the Obj record whose **cmo.id** field is equal to **id.id**. A value of **id.id** equal to 0 specifies that there is no list control associated with this edit box. + +### FtGboData + +The **FtGboData** structure specifies the properties of the group box [Obj](#obj) record that contains this FtGboData. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftcb
accelreserved
Aunused2
+ +**ft (2 bytes):** Reserved. MUST be 0x000F. + +**cb (2 bytes):** Reserved. MUST be 0x0006. + +**accel (2 bytes):** An unsigned integer that specifies the [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) character of the object’s [**accelerator key**](#gt_d61b4a07-b6c1-4c08-9ebd-1d00b360f953). A value of 0x0000 specifies there is no accelerator key associated with this object. This field MUST be ignored unless this object is in a [**dialog sheet**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8). + +**reserved (2 bytes):** Reserved. MUST be 0x0000. + +**A - fNo3d (1 bit):** A bit that specifies whether this control is expected to be displayed without three-dimensional effects. + +**unused2 (15 bits):** Undefined and MUST be ignored. + +### FtGmo + +The **FtGmo** structure appears in a group-type [Obj](#obj) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftcb
unused
+ +**ft (2 bytes):** Reserved. MUST be 0x0006. + +**cb (2 bytes):** Reserved. MUST be 0x0002 + +**unused (2 bytes):** Undefined and MUST be ignored. + +### FtLbsData + +The **FtLbsData** structure specifies the properties of a list or drop-down list [**embedded object**](#gt_708607be-8655-416e-93f3-b434e9ecbd56) in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftcbFContinued
fmla (variable)
...
cLinesiSel
ABCDEFGlctidEdit
dropData (variable)
...
rgLines (variable)
...
bsels (variable)
...
+ +**ft (2 bytes):** Reserved. MUST be 0x0013. + +**cbFContinued (2 bytes):** An unsigned integer that indirectly specifies whether some of the data in this structure appear in a subsequent [Continue](#continue) record. If **cbFContinued** is 0x0000, all of the fields in this structure except **ft** and **cbFContinued** MUST NOT exist. If this entire structure is contained within the same record, then **cbFContinued** MUST be greater than or equal to the size, in bytes, of this structure, not including the four bytes for the **ft** and **cbFContinued** fields. If part of this structure is in one or more subsequent Continue records, then the **cbFContinued** field MUST hold the value calculated according to the following formula: + +**cbFContinued** = size of the fields of this structure in the current record - 1. + +**fmla (variable):** An [ObjFmla](#objfmla) that specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) values that are the items in this list. + +**cLines (2 bytes):** An unsigned integer that specifies the number of items in the list. MUST be less than or equal to 0x7FFF. + +**iSel (2 bytes):** An unsigned integer that specifies the one-based index of the first selected item in this list. A value of 0x0000 specifies there is no currently [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) item. MUST be less than or equal to **cLines**. + +**A - fUseCB (1 bit):** A bit that specifies whether the **lct** field MUST be ignored. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------| +| 0 | The **lct** field MUST be ignored. | +| 1 | The **lct** field MUST NOT be ignored. | + +**B - fValidPlex (1 bit):** A bit that specifies whether the **rgLines** field exists. + +**C - fValidIds (1 bit):** A bit that specifies whether the **idEdit** field MUST be ignored. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------| +| 0 | The **idEdit** field MUST be ignored. | +| 1 | The **idEdit** field MUST NOT be ignored. | + +**D - fNo3d (1 bit):** A bit that specifies whether this control is displayed without 3-dimensional effects. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------------------------| +| 0 | The control is displayed with 3-dimentional effects. | +| 1 | The control is not displayed with 3-dimentional effects. | + +**E - wListSelType (2 bits):** An unsigned integer that specifies the type of [**selection**](#gt_8a241461-3c59-45fb-9094-b6692a0c27fe) behavior this list control is expected to support. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The list control is only allowed to have one selected item. | +| 1 | The list control is allowed to have multiple items selected by clicking on each item. | +| 2 | The list control is allowed to have multiple items selected by holding the CTRL key and clicking on each item. | + +**F - unused (1 bit):** Undefined and MUST be ignored. + +**G - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**lct (8 bits):** An unsigned integer that specifies the behavior class of this list. MUST be ignored if the **fUseCB** field is 0. Otherwise, MUST be a value from the following table: + +| Value | Expected behavior of the control | +|----|----| +| 0x00 | Regular sheet dropdown control (like a list box object). | +| 0x01 | [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) page field dropdown. | +| 0x03 | [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) dropdown. The lct field MUST NOT have this value unless this object is in a [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) or [**macro sheet**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491). | +| 0x05 | [**AutoComplete**](#gt_28a56cd0-e544-405c-8d41-b95ed015c0cc) dropdown. | +| 0x06 | [**Data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) list dropdown. The lct field MUST NOT have this value unless this object is in a worksheet or macro sheet. | +| 0x07 | PivotTable row or column field dropdown. | +| 0x09 | Dropdown for the Total Row of a table. | + +**idEdit (2 bytes):** An [ObjId](#objid) that specifies the edit box associated with this list. A value of **idEdit.id** equal to 0x0000 or a value of **fValidIds** equal to 0 specifies that there is no edit box associated with this list. + +**dropData (variable):** An optional [LbsDropData](#lbsdropdata) that specifies properties for this dropdown control. This field MUST exist if and only if the containing [Obj’s](#obj) **cmo.ot** is equal to 0x0014. + +**rgLines (variable):** An optional array of [XLUnicodeString](#xlunicodestring). Each string in this array specifies an item in the list. This array MUST exist if and only if the **fValidPlex** field is equal to 1. The number of elements in this array, if it exists, MUST be **cLines**. The **cch** field of each string in this array MUST be less than or equal to 0x00FF. If this array does not fit in the owning Obj record, Continue records are used. Each string in this array MUST be entirely contained within the same record. + +**bsels (variable):** An optional array of one-byte Booleans (section [2.5.14](#boolean)) that specifies which items in the list are part of a multiple selection. This array MUST exist if and only if the **wListSelType** field is not equal to 0. The number of elements in this array, if it exists, MUST be **cLines**. The nth byte in this array specifies whether the nth list item is part of the multiple selection. The value of each element MUST be taken from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------| +| 0x00 | List item is not part of the multiple selection. | +| 0x01 | List item is part of the multiple selection. | + +If this array does not fit in the current record, or would come within eight bytes of the end of the maximum allowable size of that record, Continue records are used. + +### FtMacro + +The **FtMacro** structure specifies an action associated with this control. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftfmla (variable)
...
+ +**ft (2 bytes):** Reserved. MUST be 0x0004. + +**fmla (variable):** An [ObjFmla](#objfmla) that specifies the name of a macro. The **fmla** field MUST refer to a name defined through an [Lbl](#lbl) whose **fProc** field is 1. + +### FtNts + +The **FtNts** structure specifies the properties of the note-type [Obj](#obj) record containing this FtNts. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftcb
guid (16 bytes)
...
...
fSharedNoteunused
...
+ +**ft (2 bytes):** Reserved. MUST be 0x000D. + +**cb (2 bytes):** Reserved. MUST be 0x0016. + +**guid (16 bytes):** A GUID as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that specifies the Globally Unique identifier of this [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d). + +**fSharedNote (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the comment is shared. MUST be a value from the following table: + +| Value of fSharedNote | Meaning | +|----------------------|------------| +| 0x0000 | Not shared | +| 0x0001 | Shared | + +**unused (4 bytes):** Undefined and MUST be ignored. + +### FtPictFmla + +The **FtPictFmla** structure specifies the location of the data associated with the picture [Obj](#obj) that contains this FtPictFmla. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftcb
fmla (variable)
...
lPosInCtlStm (optional)
cbBufInCtlStm (optional)
key (variable)
...
+ +**ft (2 bytes):** Reserved. MUST be 0x0009. + +**cb (2 bytes):** An unsigned integer that specifies the length, in bytes of this FtPictFmla, not including **ft** and **cb** fields. + +**fmla (variable):** An [ObjFmla](#objfmla) that specifies the location of the data for the object associated with the Obj record that contains this FtPictFmla. If the **pictFlags.fDde** field of the Obj record that contains this FtPictFmla is 1, **fmla** MUST refer to a name which is defined in an [ExternName](#externname) record whose **fOle** field is 1. If the **pictFlags.fCamera** field of the Obj record that contains this FtPictFmla is 1, **fmla** MUST refer to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). Otherwise, the **fmla.cce** field of this **fmla** MUST be 0x5 and the **fmla.rgce** field of this **fmla** MUST contain a [PtgTbl](#ptgtbl) followed by four bytes that are undefined and MUST be ignored. + +**lPosInCtlStm (4 bytes):** An optional unsigned integer whose meaning depends on the value of the **cmo.fPrstm** field of the Obj record that contains this FtPictFmla. This field MUST exist if and only if this structure’s **fmla.fmla.rgce** field starts with a PtgTbl. The following table explains the two possible meanings of **lPosInCtlStm**: + +| Value of cmo.fPrstm | Meaning of lPosInCtlStm | +|----|----| +| 0 | The object’s data MUST reside in an [embedding storage](#Section_b406ade0fb1c4512bff2b576fdfff545) whose name is the concatenation of "MBD" and the eight byte hexadecimal representation of **lPosInCtlStm’s** value**.** | +| 1 | **lPosInCtlStm** specifies the zero-based offset of this object’s data within the [control stream (Ctls)](#Section_ce07d64476c84d368badb6419bd152fe). | + +**cbBufInCtlStm (4 bytes):** An optional unsigned integer that specifies the size of this object’s data within the control stream. This field MUST exist if and only if the **pictFlags.fPrstm** field of the Obj record that contains this FtPictFmla equals 1. + +**key (variable):** An optional [PictFmlaKey](#pictfmlakey). MUST exist if and only if the **pictFlags.fCtl** field of the Obj record that contains this FtPictFmla equals 1. + +### FtPioGrbit + +The **FtPioGrbit** structure specifies Boolean properties of the picture [Obj](#obj) containing this FtPioGrbit. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftcb
ABCDEFGHIJunused2
+ +**ft (2 bytes):** Reserved. MUST be 0x0008. + +**cb (2 bytes):** Reserved. MUST be 0x0002. + +**A - fAutoPict (1 bit):** A bit that specifies whether the picture’s aspect ratio is preserved when rendered in different views ([**Normal view**](#gt_b3c343ae-05ca-4b91-9cc1-383ee3563990), [**Page Break Preview view**](#gt_a7342c25-b4fd-4c84-9922-ae9c4a92d180), [**Page Layout view**](#gt_c5ea3e6c-db72-4a85-b273-596e95a3841e) and printing). + +**B - fDde (1 bit):** A bit that specifies whether the **pictFmla** field of the Obj record that contains this FtPioGrbit specifies a [**DDE**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) reference. + +**C - fPrintCalc (1 bit):** A bit that specifies whether this object is expected to be updated on print to reflect the values in the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with the object. + +**D - fIcon (1 bit):** A bit that specifies whether the picture is displayed as an icon. + +**E - fCtl (1 bit):** A bit that specifies whether this object is an [**ActiveX control**](#gt_f3dcc35f-8f80-474e-ac39-106a23f059c2). It MUST NOT be the case that both **fCtl** and **fDde** are equal to 1. + +**F - fPrstm (1 bit):** A bit that specifies whether the object data are stored in an [embedding storage](#Section_b406ade0fb1c4512bff2b576fdfff545) or in the [controls stream (ctls)](#Section_ce07d64476c84d368badb6419bd152fe). See [FtPictFmla](#ftpictfmla)’s **lPosInCtlStm** and **cbBufInCtlStm** fields for more detail. + +| Value of fPrstm | Location of object data | +|-----------------|-----------------------------| +| 0 | An embedding storage. | +| 1 | The controls stream (ctls). | + +**G - unused1 (1 bit):** Undefined and MUST be ignored. + +**H - fCamera (1 bit):** A bit that specifies whether this is a [**camera picture**](#gt_ccb0da7f-aa4d-481c-b46c-e96c220869e1). + +**I - fDefaultSize (1 bit):** A bit that specifies whether this picture’s size has been explicitly set. The value of **fDefaultSize** MUST be taken from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------| +| 0 | This picture’s size has been explicitly set. | +| 1 | This picture’s size has not been explicitly set. | + +**J - fAutoLoad (1 bit):** A bit that specifies whether the [**OLE server**](#gt_8032f3a8-7274-45a4-aa01-5e7d8645f0c0) for the object is called to load the object’s data automatically when the parent [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is opened. + +**unused2 (6 bits):** Undefined and MUST be ignored. + +### FtRbo + +The **FtRbo** structure appears as part of an [Obj](#obj) record that represents a radio button. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftcb
unused1
unused2
+ +**ft (2 bytes):** Reserved. MUST be 0x000B. + +**cb (2 bytes):** Reserved. MUST be 0x0006. + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +### FtRboData + +The **FtRboData** structure specifies the properties of the radio button [Obj](#obj) containing this FtRboData. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftcb
idRadNextfFirstBtn
+ +**ft (2 bytes):** Reserved. MUST be 0x0011. + +**cb (2 bytes):** Reserved. MUST be 0x0004. + +**idRadNext (2 bytes):** An [ObjId](#objid) that specifies the next radio button in a group of radio buttons. A value of **idRadNext.id** equal to 0 or equal to the containing Obj’s **cmo.id** specifies there is no next radio button. + +**fFirstBtn (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether this is the first radio button in its group. MUST be a value from the following table: + +| Value | Meaning | +|--------|----------------------------------------------| +| 0x0000 | This is not the first radio button. | +| 0x0001 | This is the first radio button in the group. | + +### FtSbs + +The **FtSbs** structure specifies the properties of the scrollable control represented by the [Obj](#obj) record that contains this FtSbs. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftcb
unused1
iValiMin
iMaxdInc
dPagefHoriz
dxScrollABCDunused2
+ +**ft (2 bytes):** Reserved. MUST be 0x000C. + +**cb (2 bytes):** Reserved. MUST be 0x0014. + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +**iVal (2 bytes):** A signed integer that specifies the current value of the control. This value MUST be greater than or equal to **iMin**. This value MUST be less than or equal to **iMax**. + +**iMin (2 bytes):** A signed integer that specifies the minimum allowable value of the control. + +**iMax (2 bytes):** A signed integer that specifies the maximum allowable value of the control. This value MUST be greater than or equal to **iMin**. + +**dInc (2 bytes):** A signed integer that specifies the amount by which the control’s value is changed when the user clicks on one of the control’s minor increment regions. MUST be greater than or equal to 0x0000. + +**dPage (2 bytes):** A signed integer that specifies the amount by which the control’s value is changed when the user clicks on the scrollbar’s page up or page down region. MUST be greater than or equal to 0x0000. + +**fHoriz (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether this control scrolls horizontally or vertically. MUST be a value from the following table: + +| | | +|--------|----------------------| +| 0x0000 | Vertical scrolling | +| 0x0001 | Horizontal scrolling | + +**dxScroll (2 bytes):** A signed integer that specifies the width in pixels of the scrollbar. MUST be greater than or equal to 0x0000. + +**A - fDraw (1 bit):** A bit that specifies whether this control is expected to be displayed. + +**B - fDrawSliderOnly (1 bit):** A bit that specifies whether only the slider portion of this control is expected to be displayed. + +**C - fTrackElevator (1 bit):** A bit that specifies whether the control is expected to interactively track a mouse drag of the control’s scroll thumb (aka elevator). + +**D - fNo3d (1 bit):** A bit that specifies whether the control is expected to be displayed without three-dimensional effects. + +**unused2 (12 bits):** Undefined and MUST be ignored. + +### FullColorExt + +The **FullColorExt** structure specifies a color. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xclrTypenTintShade
xclrValue
unused
...
+ +**xclrType (2 bytes):** An [**XColorType**](#xcolortype) that specifies how the color information is stored. + +**nTintShade (2 bytes):** A signed integer that specifies the tint of the color. Positive values lighten the color, and negative values darken the color. + +**xclrValue (4 bytes):** An unsigned integer that specifies the color data. If **xclrType** equals 0x00 or 0x04, this value MUST be 0. If **xclrType** equals 0x01, this field contains an [IcvXF](#icvxf) that specifies a color in the color table. If **xclrType** equals 0x02, this field contains a [LongRGBA](#longrgba) that specifies an [**red-green-blue-alpha (RGBA)**](#gt_86add9f3-4083-49ce-a1b3-359595c14b65) value. If **xclrType** equals 0x03, this field contains a [ColorTheme](#colortheme) that specifies a theme color. + +**unused (8 bytes):** Undefined and MUST be ignored. + +### GradStop + +The **GradStop** structure specifies a [**gradient stop**](#gt_35b983af-d590-4f93-87cb-94786924511f) for a [**gradient fill**](#gt_35280309-5b22-4c17-be48-f06c37ffc685). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xclrTypexclrValue
...numPosition
...
...numTint
...
...
+ +**xclrType (2 bytes):** An [**XColorType**](#xcolortype) that specifies how the color information is stored. + +**xclrValue (4 bytes):** An unsigned integer that specifies the color data. If **xclrType** equals 0x00 or 0x04, this value MUST be 0. If **xclrType** equals 0x01, this field contains an [IcvXF](#icvxf) that specifies color in the color table. If **xclrType** equals 0x02, this field contains a [LongRGBA](#longrgba) that specifies an [**RGBA**](#gt_86add9f3-4083-49ce-a1b3-359595c14b65) value. If **xclrType** equals 0x03, this field contains a [ColorTheme](#colortheme) that specifies a theme color + +**numPosition (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the gradient stop position as the percentage of the gradient range. The gradient stop position is the position within the gradient range where this gradient stop’s color begins. MUST be greater than or equal to 0.0 and less than or equal to 1.0. + +**numTint (8 bytes):** An Xnum that specifies the tint of the color. MUST be greater than or equal to -1.0 and less than or equal to 1.0. Positive values lighten the color, and negative values darken the color. + +### HiddenMemberSet + +The **HiddenMemberSet** structure specifies [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) from a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) that are in the same level in an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cMemberName
rgMemberName (variable)
...
+ +**cMemberName (4 bytes):** An unsigned integer that specifies the number of elements in **rgMemberName**. + +**rgMemberName (variable):** An array of [XLUnicodeString](#xlunicodestring) structures. Each element specifies the name of a hidden OLAP member. MUST exist if and only if the value of **cMemberName** is greater than 0. + +### HideObjEnum + +The **HideObjEnum** enumeration specifies how [**ActiveX objects**](#gt_0d95e494-61b2-43bc-8818-51aa162d2018), [**OLE objects**](#gt_cdff9514-a3fb-4897-941d-4e99193a0096), and [**drawing objects**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) appear in a window that contains the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| Name | Value | Meaning | +|----|----|----| +| **SHOWALL** | 0x0000 | ActiveX objects, OLE objects, and drawing objects are displayed in the window that contains the workbook. | +| **SHOWPLACEHOLDER** | 0x0001 | Placeholders are displayed in place of ActiveX objects, OLE objects, and drawing objects in the window that contains the workbook. | +| **HIDEALL** | 0x0002 | ActiveX objects, OLE objects, and drawing objects are not displayed in the window that contains the workbook. | + +### HorizAlign + +The **HorizAlign** enumeration specifies the horizontal alignment. + +| Name | Value | Meaning | +|----|----|----| +| **ALCNIL** | 0xFF | Alignment not specified | +| **ALCGEN** | 0x00 | [**General alignment**](#gt_3ee6d1d4-830b-4dc2-b8be-751665f8045f) | +| **ALCLEFT** | 0x01 | Left alignment | +| **ALCCTR** | 0x02 | [**Centered alignment**](#gt_876925bf-49bc-4edb-a3fa-963f4cc8c0cc) | +| **ALCRIGHT** | 0x03 | Right alignment | +| **ALCFILL** | 0x04 | [**Fill alignment**](#gt_cfc4e171-6104-470e-9ebb-812afea17078) | +| **ALCJUST** | 0x05 | Justify alignment | +| **ALCCONTCTR** | 0x06 | [**Center-across-selection alignment**](#gt_ef7324bd-dac8-46e2-8df5-db44d8b925a8) | +| **ALCDIST** | 0x07 | Distributed alignment | + +### HorzBrk + +The **HorzBrk** structure specifies one horizontal [**page break**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rowcolStart
colEnd
+ +**row (2 bytes):** A [RwU](#rwu) that specifies the zero-based index of the first row below the page break. + +**colStart (2 bytes):** An unsigned integer that specifies the zero-based index of the first column on the page. MUST be less than or equal to 16383. + +**colEnd (2 bytes):** An unsigned integer that specifies the zero-based index of the last column on the page. The value MUST be greater than **colStart** and less than or equal to 16383. + +### Icv + +The **Icv** structure specifies a color in the color table. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
icv
+ +**icv (2 bytes):** An unsigned integer that specifies a color from the color table. The value MUST be one of the following values: a value greater than or equal to 0x000 and less than or equal to 0x0041, a value greater than or equal to 0x004D and less than or equal to 0x004F, 0x0051, or 0x7FFF. + +The values that are greater than or equal to 0x0000 and less than or equal to 0x0007 specify built-in color constants. This part of the color table is: + +| **icv value** | **Color description** | **Red value** | **Green value** | **Blue value** | +|----|----|----|----|----| +| 0x0000 | Black | 0 | 0 | 0 | +| 0x0001 | White | 255 | 255 | 255 | +| 0x0002 | Red | 255 | 0 | 0 | +| 0x0003 | Green | 0 | 255 | 0 | +| 0x0004 | Blue | 0 | 0 | 255 | +| 0x0005 | Yellow | 255 | 255 | 0 | +| 0x0006 | Magenta | 255 | 0 | 255 | +| 0x0007 | Cyan | 0 | 255 | 255 | + +The next 56 values in the table, the **icv** values greater than or equal to 0x0008 and less than or equal to 0x003F, specify the palette colors in the table. If a [Palette](#palette) record exists in this file, these **icv** values specify colors from the **rgColor** array in the Palette record. If no Palette record exists, these values specify colors in the default palette. The next 56 values in this part of the color table specify the following: + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ValueIf a palette record exists in this file:

Default

+

red value

+

(if no palette record in file)

Default

+

green value

+

(if no palette record in file)

Default

+

blue value

+

(if no palette record in file)

0x0008Field rgColor[0] of Palette000
0x0009Field rgColor[1] of Palette255255255
0x000AField rgColor[2] of Palette25500
0x000BField rgColor[3] of Palette02550
0x000CField rgColor[4] of Palette00255
0x000DField rgColor[5] of Palette2552550
0x000EField rgColor[6] of Palette2550255
0x000FField rgColor[7] of Palette0255255
0x0010Field rgColor[8] of Palette12800
0x0011Field rgColor[9] of Palette01280
0x0012Field rgColor[10] of Palette00128
0x0013Field rgColor[11] of Palette1281280
0x0014Field rgColor[12] of Palette1280128
0x0015Field rgColor[13] of Palette0128128
0x0016Field rgColor[14] of Palette192192192
0x0017Field rgColor[15] of Palette128128128
0x0018Field rgColor[16] of Palette153153255
0x0019Field rgColor[17] of Palette15351102
0x001AField rgColor[18] of Palette255255204
0x001BField rgColor[19] of Palette204255255
0x001CField rgColor[20] of Palette1020102
0x001DField rgColor[21] of Palette255128128
0x001EField rgColor[22] of Palette0102204
0x001FField rgColor[23] of Palette204204255
0x0020Field rgColor[24] of Palette00128
0x0021Field rgColor[25] of Palette2550255
0x0022Field rgColor[26] of Palette2552550
0x0023Field rgColor[27] of Palette0255255
0x0024Field rgColor[28] of Palette1280128
0x0025Field rgColor[29] of Palette12800
0x0026Field rgColor[30] of Palette0128128
0x0027Field rgColor[31] of Palette00255
0x0028Field rgColor[32] of Palette0204255
0x0029Field rgColor[33] of Palette204255255
0x002AField rgColor[34] of Palette204255204
0x002BField rgColor[35] of Palette255255153
0x002CField rgColor[36] of Palette153204255
0x002DField rgColor[37] of Palette255153204
0x002EField rgColor[38] of Palette204153255
0x002FField rgColor[39] of Palette255204153
0x0030Field rgColor[40] of Palette51102255
0x0031Field rgColor[41] of Palette51204204
0x0032Field rgColor[42] of Palette1532040
0x0033Field rgColor[43] of Palette2552040
0x0034Field rgColor[44] of Palette2551530
0x0035Field rgColor[45] of Palette2551020
0x0036Field rgColor[46] of Palette102102153
0x0037Field rgColor[47] of Palette150150150
0x0038Field rgColor[48] of Palette051102
0x0039Field rgColor[49] of Palette51153102
0x003AField rgColor[50] of Palette0510
0x003BField rgColor[51] of Palette51510
0x003CField rgColor[52] of Palette153510
0x003DField rgColor[53] of Palette15351102
0x003EField rgColor[54] of Palette5151153
0x003FField rgColor[55] of Palette515151
+ +The remaining values in the color table specify colors associated with application display settings as follows: + +| Value | Meaning | +|----|----| +| 0x0040 | Default foreground color. This is the window text color in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) display. | +| 0x0041 | Default background color. This is the window background color in the sheet display and is the default background color for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). | +| 0x004D | Default [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) foreground color. This is the window text color in the chart display. | +| 0x004E | Default chart background color. This is the window background color in the chart display. | +| 0x004F | Chart neutral color which is black, an RGB value of (0,0,0). | +| 0x0051 | [**ToolTip**](#gt_84d44447-feaf-41a4-bf12-004c0f080fc2) text color. This is the automatic [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) color for comments. | +| 0x7FFF | Font automatic color. This is the window text color. | + +### IcvChart + +The **IcvChart** structure specifies a color in the [Chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) color table. The Chart color table is a subset of the full color table. See [Icv](#icv) for more information about the colors in the Chart color table. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
icv
+ +**icv (2 bytes):** An Icv that specifies a color from the chart color table. This value MUST be greater than or equal to 0x0000 and less than or equal to 0x0041, or greater than or equal to 0x004D and less than or equal to 0x00004F. This value SHOULD NOT[\<173\>](#Appendix_A_173) be less than 0x0008. + +### IcvFont + +The **IcvFont** structure specifies a color that is used by [**fonts**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). The font colors are a subset of the full color table. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
icv
+ +**icv (2 bytes):** An [Icv](#icv) that specifies a font color. MUST be greater than or equal to 0x0008 and less than or equal to 0x003F or 0x0051 or 0x7FFF. + +### IcvXF + +The **IcvXF** structure specifies a color in the color table used by [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) formatting properties. + + +++++++++ + + + + + + + + + + + + + + + + +
0123456
icv
+ +**icv (7 bits):** An unsigned integer that specifies a formatting property color. The value MUST be 0x48, or an [Icv](#icv) with a value greater than or equal to 0x01 and less than or equal to 0x3F, the default foreground color (0x40), or the default background color (0x41). This value SHOULD NOT[\<174\>](#Appendix_A_174) be 0x48, or less than or equal to 0x07. + +### IFmt + +The **IFmt** structure specifies the identifier of a [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ifmt
+ +**ifmt (2 bytes):** An unsigned integer that specifies the identifier of a number format. The identifier specified by this field MUST be a valid built-in number format identifier or the identifier of a custom number format as specified using a [Format](#format) record. Custom number format identifiers MUST be greater than or equal to 0x00A4 and less than or equal to 0x0188, and SHOULD[\<175\>](#Appendix_A_175) be less than or equal to 0x017E. The built-in number formats are listed in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1: Fundamentals And Markup Language Reference, section 18.8.30. + +### InteriorColorPropertiesForShapePropsStreamChecksum + +The **InteriorColorPropertiesForShapePropsStreamChecksum** structure specifies the interior color data used to compute the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the [ShapePropsStream](#shapepropsstream) record. + +The related [AreaFormat](#areaformat) record referenced in the following field specifications is the AreaFormat record that exists along with the ShapePropsStream record in one of the following sets of records. + +- A sequence of records that conforms to the [FRAME](#chart-sheet-substream) rule. + +- A sequence of records that conforms to the DROPBAR rule. + +- A sequence of records that conforms to the AXS rule if the field **wObjContext** in the ShapePropsStream record is equal to 0x0003. + +- A sequence of records that conforms to the SS rule. + + + +- If the field **wObjContext** in the ShapePropsStream record is equal to 0x0001, then the **foregroundColor** and **backgroundColor** properties are obtained from the [MarkerFormat](#markerformat) record in the sequence of records that conforms to the SS rule instead. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
foregroundColor
backgroundColor
fls
+ +**foregroundColor (4 bytes):** A [LongRGB](#longrgb) that specifies the [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) of the [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e). MUST equal the value specified by the **rgbFore** field of the related AreaFormat or MarkerFormat records. + +**backgroundColor (4 bytes):** A LongRGB that specifies the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) of the fill pattern. MUST equal the value specified by the **rgbBack** field of the related AreaFormat or MarkerFormat records. + +**fls (1 byte):** An unsigned integer that specifies the type of the fill pattern. MUST equal the value specified by the **fls** field of the related AreaFormat record. + +### ISSTInf + +The **ISSTInf** structure is the array element used in the **rgISSTinf** field of the [ExtSST](#extsst) record. **ib** and **cbOffset** provide a way to access the first string in the set of strings specified by this structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ib
cbOffsetreserved
+ +**ib (4 bytes):** A FilePointer as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.5 that specifies the zero-based offset into the [workbook stream](#Section_f682f4b08c6b444e83f852d156f1e8ba) where the first string in the set of strings starts. + +**cbOffset (2 bytes):** An unsigned integer that specifies the zero-based offset into the [SST](#sst) or [Continue](#continue) record, in which the first string in the set of strings starts. MUST be less than **ib**. The size of the SST or Continue record is determined by reading the record header at the location specified by the following formula: + +**ib – cbOffset** + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +### IXFCell + +The **IXFCell** structure specifies the index of a [cell XF](#Section_518a740d71c640c8bb97e7df6915861a). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ixfe
+ +**ixfe (2 bytes):** An unsigned integer that specifies a zero-based index of a cell XF record in the collection of [XF](#xf) records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). Cell XF records are the subset of XF records with an **fStyle** field equal to 0. This value MUST be greater than or equal to 15, or equal to 0. The value 0 indicates that this value MUST be ignored. See [XFIndex](#xfindex) for more information about the organization of XF records in the file. + +### KPIProp + +The **KPIProp** enumeration specifies the types of [MDX KPI properties](#Section_db8664f2502b43d2aa88274035b52570). + +| Name | Value | Meaning | +|----|----|----| +| **KPIPROPVALUE** | 0x01 | Value. | +| **KPIPROPGOAL** | 0x02 | Goal. | +| **KPIPROPSTATUS** | 0x03 | Status. | +| **KPIPROPTREND** | 0x04 | Trend. | +| **KPIPROPWEIGHT** | 0x05 | Weight. | +| **KPIPROPCURRENTTIMEMEMBER** | 0x06 | Current time [**member (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11). | + +### KPISets + +The **KPISets** structure specifies icon sets. + +| Name | Value | Meaning | +|------------------------|------------|---------------------------| +| **KPINIL** | 0xFFFFFFFF | Sort by no-icon | +| **KPI3ARROWS** | 0x00000000 | Kpi3 Arrows set | +| **KPI3ARROWSGRAY** | 0x00000001 | Kpi3 Arrows Gray set | +| **KPI3FLAGS** | 0x00000002 | Kpi3 Flags set | +| **KPI3TRAFFICLIGHTS1** | 0x00000003 | Kpi3 Traffic Lights 1 set | +| **KPI3TRAFFICLIGHTS2** | 0x00000004 | Kpi3 Traffic Lights 2 set | +| **KPI3SIGNS** | 0x00000005 | Kpi3 Signs set | +| **KPI3SYMBOLS** | 0x00000006 | Kpi3 Symbols set | +| **KPI3SYMBOLS2** | 0x00000007 | Kpi3 Symbols 2 set | +| **KPI4ARROWS** | 0x00000008 | Kpi4 Arrows set | +| **KPI4ARROWSGRAY** | 0x00000009 | Kpi4 Arrows Gray set | +| **KPI4REDTOBLACK** | 0x0000000A | Kpi4 Red To Black set | +| **KPI4RATING** | 0x0000000B | Kpi4 Rating set | +| **KPI4TRAFFICLIGHTS** | 0x0000000C | Kpi4 Traffic Lights set | +| **KPI5ARROWS** | 0x0000000D | Kpi5 Arrows set | +| **KPI5ARROWSGRAY** | 0x0000000E | Kpi5 Arrows Gray set | +| **KPI5RATING** | 0x0000000F | Kpi5 Rating set | +| **KPI5QUARTERS** | 0x00000010 | Kpi5 Quarters set | + +### LbsDropData + +The **LbsDropData** structure specifies properties of the dropdown [Obj](#obj) that contains this LbsDropData. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCunused2cLine
dxMinstr (variable)
...
unused3 (optional)
+ +**A - wStyle (2 bits):** An unsigned integer that specifies the style of this dropdown. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------------------| +| 0 | Combo dropdown control | +| 1 | Combo Edit dropdown control | +| 2 | Simple dropdown control (just the dropdown button) | + +**B - unused1 (1 bit):** Undefined and MUST be ignored. + +**C - fFiltered (1 bit):** A bit that specifies whether the data displayed by the dropdown has been filtered in some way. + +**unused2 (12 bits):** Undefined and MUST be ignored. + +**cLine (2 bytes):** An unsigned integer that specifies the number of lines to be displayed in the dropdown. If there are more lines than that in the list, a scrollbar can appear. MUST be less than or equal to 0x7FFF. + +**dxMin (2 bytes):** An unsigned integer that specifies the smallest width in pixels allowed for the dropdown window. MUST be less than or equal to 0x7FFF. + +**str (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the current string value in the dropdown. + +**unused3 (1 byte):** Optional, undefined and MUST be ignored. This field MUST exist if and only if the size of **str** in bytes is an odd number. + +### LEMMode + +The **LEMMode** enumeration specifies the different edit modes for a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +| Name | Value | Meaning | +|----|----|----| +| **LEMNORMAL** | 0x00000000 | The table can be directly edited inline. | +| **LEMREFRESHCOPY** | 0x00000001 | The table is refreshed before editing is allowed because is it a copy of a table whose source is a Web based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list. | +| **LEMREFRESHCACHE** | 0x00000002 | The table is refreshed before editing is allowed because caching a user change failed. | +| **LEMREFRESHCACHEUNDO** | 0x00000003 | The table is refreshed before editing is allowed because undoing a cached user change failed. | +| **LEMREFRESHLOADED** | 0x00000004 | The table is refreshed before editing is allowed because on load the table source could not be re-connected. | +| **LEMREFRESHTEMPLATE** | 0x00000005 | The table is refreshed before editing is allowed because it was saved without having its data cached. | +| **LEMREFRESHREFRESH** | 0x00000006 | The table is refreshed before editing is allowed because a previous [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) failed. | +| **LEMNOINSROWSSPREQUIRED** | 0x00000007 | Rows cannot be inserted into this web based data provider list because there are hidden required columns. | +| **LEMNOINSROWSSPDOCLIB** | 0x00000008 | Rows cannot be inserted into this Web based data provider list because it is a [**document library**](#gt_d9f07822-aeb0-4642-ab51-95cb724fbf35). | +| **LEMREFRESHLOADDISCARDED** | 0x00000009 | The table is refreshed before editing is allowed because the user selected to discard cached changes upon loading. | +| **LEMREFRESHLOADHASHVALIDATION** | 0x0000000A | The table is refreshed before editing is allowed because the validation of the table's data area failed upon loading. | +| **LEMNOEDITSPMODVIEW** | 0x0000000B | Cannot allow the user to edit this table because of the type of moderated Web based data provider list it is. | + +### LinePropertiesForShapePropsStreamChecksum + +The **LinePropertiesForShapePropsStreamChecksum** record specifies the line properties data used to compute the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the [ShapePropsStream](#shapepropsstream) record. + +The related [LineFormat](#lineformat) record referenced in the following field specifications is the LineFormat record that exists along with the ShapePropsStream record in one of the following sets of records. + +- A set of records in a [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) but not in the sequence of records that conforms to the [LD](#chart-sheet-substream) rule or the sequence of records that conforms to the DROPBAR rule. + + + +- If more than one LineFormat and ShapePropsStream records exist in the set, then a pair of LineFormat and ShapePropsStream records are related when the chart element identified by the **ID** field of the [CrtLine](#crtline) record preceding the LineFormat record is the same chart element as the one identified by the **wObjContext** field of the ShapePropsStream record. + + + +- A sequence of records that conforms to the FRAME rule. + +- A sequence of records that conforms to the DROPBAR rule. + +- A sequence of records that conforms to the AXS rule. + + + +- If more than one LineFormat and ShapePropsStream records exist in the sequence of records, then a pair of LineFormat and ShapePropsStream records are related when the chart element identified by the **ID** field of the [AxisLine](#axisline) record preceding the LineFormat record is be the same chart element as the one identified by the **wObjContext** field of the ShapePropsStream record. + + + +- A sequence of records that conforms to the SS rule when the **wObjContext** field of the ShapePropsStream record is 0x0000. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
icvpatternthicknessAunused
color
+ +**icv (1 byte):** An [IcvChart](#icvchart) that specifies the [**palette color**](#gt_be899517-b752-44f1-8c38-2561d17a8a7f) value for the line. The color MUST match the color specified by **color** field. MUST equal the value specified by the **icv** field of the related LineFormat record. + +**pattern (1 byte):** An unsigned integer that specifies the pattern of the line. MUST equal the value specified by the **lns** field of the related LineFormat record. + +**thickness (1 byte):** A signed integer that specifies the thickness of the line. MUST equal the value specified by the **we** field of the related LineFormat record plus one. + +**A - fIsLineStyleAutomatic (1 bit):** A bit that specifies whether the line has default formatting. MUST contain the value specified by the **fAuto** field of the related LineFormat record. + +**unused (7 bits):** Unused and MUST be zero. + +**color (4 bytes):** A [LongRGB](#longrgb) that specifies the color of the line. The color MUST match the color specified by **icv**. MUST equal the value specified by the **rgb** field of the related LineFormat record. + +### List12BlockLevel + +The **List12BlockLevel** structure specifies default [**block-level formatting**](#gt_4ad37d18-8570-450e-8376-9606e8ff98b4) information for a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7), to be applied when the table expands. [Style](#style) gets applied before [DXFN12List](#dxfn12list) for each table region. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cbdxfHeader
istnHeader
cbdxfData
istnData
cbdxfAgg
istnAgg
cbdxfBorder
cbdxfHeaderBorder
cbdxfAggBorder
dxfHeader (variable)
...
dxfData (variable)
...
dxfAgg (variable)
...
dxfBorder (variable)
...
dxfHeaderBorder (variable)
...
dxfAggBorder (variable)
...
stHeader (variable)
...
stData (variable)
...
stAgg (variable)
...
+ +**cbdxfHeader (4 bytes):** A signed integer that specifies the byte count for **dxfHeader** field. MUST be greater than or equal to zero. + +**istnHeader (4 bytes):** A signed integer that specifies a zero-based index to a Style record in the collection of Style records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The referenced Style specifies the [cell style XF](#Section_3d5348ded9df4c31b1fd9f9377273152) used for the table’s [**header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38) [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). If the value is -1, no style is specified for the table’s header row cells. + +**cbdxfData (4 bytes):** A signed integer that specifies the byte count for **dxfData** field. MUST be greater than or equal to zero. + +**istnData (4 bytes):** A signed integer that specifies a zero-based index to a Style record in the collection of Style records in the Globals Substream. The referenced Style specifies the [cell style](#Section_f9425d3f127545be8389bf80f65b56b7) used for the table’s data cells. If the value is -1, no style is specified for the table’s data cells. + +**cbdxfAgg (4 bytes):** A signed integer that specifies the byte count for **dxfAgg** field. MUST be greater than or equal to zero. + +**istnAgg (4 bytes):** A signed integer that specifies a zero-based index to a Style record in the collection of Style records in the Globals Substream. The referenced Style specifies the cell style used for the table’s [**total row**](#gt_95e9bcf4-d644-4e96-9070-dbc80b4d1b28). If the value is -1, no style is specified for the table’s total row. + +**cbdxfBorder (4 bytes):** A signed integer that specifies the byte count for **dxfBorder** field. MUST be greater than or equal to zero. + +**cbdxfHeaderBorder (4 bytes):** A signed integer that specifies the byte count for **dxfHeaderBorder** field. MUST be greater than or equal to zero. + +**cbdxfAggBorder (4 bytes):** A signed integer that specifies the byte count for **dxfAggBorder** field. MUST be greater than or equal to zero. + +**dxfHeader (variable):** An optional DXFN12List that specifies the formatting for the table’s header row cells. MUST exist if and only if **cbdxfHeader** is nonzero. + +**dxfData (variable):** An optional DXFN12List that specifies the formatting for the table’s data cells. MUST exist if and only if **cbdxfData** is nonzero. + +**dxfAgg (variable):** An optional DXFN12List that specifies the formatting for the table’s total row. MUST exist if and only if **cbdxfAgg** is nonzero. + +**dxfBorder (variable):** An optional DXFN12 that specifies the formatting for the [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) of the table’s data cells. MUST exist if and only if **cbdxfBorder** is nonzero. + +**dxfHeaderBorder (variable):** An optional DXFN12List that specifies the formatting for the border of the table’s header row cells. MUST exist if and only if **cbdxfHeaderBorder** is nonzero. + +**dxfAggBorder (variable):** An optional DXFN12List that specifies the formatting for the border of the table’s total row. MUST exist if and only if **cbdxfAggBorder** is nonzero. + +**stHeader (variable):** An optional [XLUnicodeString](#xlunicodestring) that specifies the name of the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) for the table’s header row cells. MUST exist if and only if **istnHeader** is not equal to -1. MUST be equal to the name of the Style record specified by **istnHeader**. If the style is a user-defined style, **stHeader** MUST be equal to the **user** field of the Style record. + +**stData (variable):** An optional XLUnicodeString that specifies the name of the style for the table’s data cells. MUST exist if and only if **istnData** is not equal to -1. MUST be equal to the name of the Style record specified by **istnData**. If the style is a user-defined style, **stData** MUST be equal to the **user** field of the Style record. + +**stAgg (variable):** An optional XLUnicodeString that specifies the name of the style for the table’s total row. MUST exist if and only if **istnAgg** is not equal to -1. MUST be equal to the name of the Style record specified by **istnAgg**. If the style is a user-defined style, **stAgg** MUST be equal to the **user** field of the Style record. + +### List12DisplayName + +The **List12DisplayName** structure specifies the name and comment strings for the [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
stListName (variable)
...
stListComment (variable)
...
+ +**stListName (variable):** An [XLNameUnicodeString](#xlnameunicodestring) that specifies the table name. MUST be an empty string if the **rgbName** field of the [TableFeatureType](#tablefeaturetype) structure embedded in the [Feature11](#feature11) or [Feature12](#feature12) record that specifies the table is not empty. If the table name is not the same as the **rgbName** field of the TableFeatureType structure for this table, the table name is specified in **stListName** which is a case-insensitive unique name among all table names and [**defined names**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +**stListComment (variable):** An [XLUnicodeString](#xlunicodestring) that specifies a comment about the table. + +### List12TableStyleClientInfo + +The **List12TableStyleClientInfo** record specifies information about the style applied to a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEFunused2stListStyleName (variable)
...
+ +**A - fFirstColumn (1 bit):** A bit that specifies whether any [table style elements](#Section_84f2f67849214e8c83eb10d4fff7e935) (as specified by [TableStyleElement](#tablestyleelement)) with a **tseType** field equal to 0x00000003 will be applied. + +**B - fLastColumn (1 bit):** A bit that specifies whether any table style elements (as specified by TableStyleElement) with a **tseType** field equal to 0x00000004 will be applied. + +**C - fRowStripes (1 bit):** A bit that specifies whether any table style elements (as specified by TableStyleElement) with a **tseType** field equal to 0x00000005 or 0x00000006 will be applied. + +**D - fColumnStripes (1 bit):** A bit that specifies whether any table style elements (as specified by TableStyleElement) with a **tseType** field equal to 0x00000007 or 0x00000008 will be applied. + +**E - unused1 (2 bits):** Undefined and MUST be ignored. + +**F - fDefaultStyle (1 bit):** A bit that specifies whether the style whose name is specified by **stListStyleName** is the default [table style](#Section_4ac7212b4aa74ece962526c58224ae80). + +**unused2 (9 bits):** Undefined and MUST be ignored. + +**stListStyleName (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the name of the table style for the table. Length MUST be greater than zero and less than or equal to 255 characters. If the table style is a custom style, it is defined in a [TableStyle](#tablestyle) record that has **rgchName** equal to this value. + +### LongRGB + +The **LongRGB** structure specifies a color as a combination of red, green, and blue. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
redgreenbluereserved
+ +**red (1 byte):** An unsigned integer that specifies the relative intensity of red. + +**green (1 byte):** An unsigned integer that specifies the relative intensity of green. + +**blue (1 byte):** An unsigned integer that specifies the relative intensity of blue. + +**reserved (1 byte):** MUST be zero, and MUST be ignored. + +### LongRGBA + +The **LongRGBA** structure specifies a color as a combination of red, green, blue and alpha values. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
redgreenbluealpha
+ +**red (1 byte):** An unsigned integer that specifies the relative intensity of red. + +**green (1 byte):** An unsigned integer that specifies the relative intensity of green. + +**blue (1 byte):** An unsigned integer that specifies the relative intensity of blue. + +**alpha (1 byte):** An unsigned integer that specifies the alpha value. + +### LPWideString + +The **LPWideString** type specifies a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string which is prefixed by a length. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cchCharactersrgchData (variable)
...
+ +**cchCharacters (2 bytes):** An unsigned integer that specifies the number of characters. + +**rgchData (variable):** An array of Unicode characters that specifies the characters of the string.  The size of this array in bytes MUST equal the following formula: + +**cchCharacters** \* 2 + +### MDir + +The **MDir** structure specifies the [MDTInfoIndex](#mdtinfoindex) and the index of a specific [MDX metadata](#Section_0f7583182c0b4155bf75c7399f89305c) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
imdt
mdd
+ +**imdt (4 bytes):** An MDTInfoIndex that identifies the [MDTInfo](#mdtinfo) record. + +**mdd (4 bytes):** An unsigned integer that specifies the zero-based index of an MDX metadata record in the collection of MDX metadata records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The referenced record specifies a MDX metadata record corresponding to the record type specified by **imdt**. The MDX metadata records include [MDXTuple](#mdxtuple), [MDXSet](#mdxset), [MDXProp](#mdxprop) and [MDXKPI](#mdxkpi) records. + +### MDTInfoIndex + +The **MDTInfoIndex** structure specifies an index which identifies an [MDTInfo](#mdtinfo) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
index
+ +**index (4 bytes):** A signed integer that specifies the one-based index of an MDTInfo record in the collection of MDTInfo records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The value MUST be greater than 0 and less than or equal to the total number of the MDTInfo records in the file. + +### MDXStrIndex + +The **MDXStrIndex** structure specifies the index of an [MDXStr](#mdxstr) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
index
+ +**index (4 bytes):** A signed integer that specifies the zero-based index of an MDXStr record in the collection of MDXStr records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The value MUST be greater than or equal to 0 and less than the total number of the MDXStr records that have been read so far. + +### MOper + +The **MOper** structure specifies multiple operands of an [**OLE link**](#gt_63bdff5e-89bb-4e82-bc5d-ab1de245efff) or a [**DDE link**](#gt_0aa0fad9-afc1-4433-b772-2dc11e641721) for the [ExternOleDdeLink](#externoleddelink) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
colLastrowLastextOper (variable)
...
+ +**colLast (1 byte):** A [ColByteU](#colbyteu) that specifies the zero-based index of last column associated with the link. + +**rowLast (2 bytes):** A [RwU](#rwu) that specifies the zero-based index of last row associated with the link. + +**extOper (variable):** This array specifies current values for the linked data. Each [SerAr](#serar) specifies a cell value. The number of elements in the array is + +(**colLast** + 1) \* (**rowLast** + 1). + +If this array does not fit in the owning [ExternName](#externname) record, [Continue](#continue) records are used. Each SerAr MUST stay in the same record. + +### NilChartNum + +The **NilChartNum** structure specifies a non-numeric value (also known as "NaN" or "Not a Number") that is used in place of a numeric value. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
unused
typereserved
+ +**unused (4 bytes):** Undefined and MUST be ignored. + +**type (2 bytes):** An unsigned integer that specifies the interpretation of this value. This field is undefined and MUST be ignored, unless otherwise defined by the containing record. + +**reserved (2 bytes):** MUST be 0xFFFF and MUST be ignored. + +### NoteRR + +The **NoteRR** structure specifies a [revision record](#Section_d120a1ffd2e6488381a507236f1994b0) for a [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) associated with a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rrd (14 bytes)
...
...
...ABreserved1
rowcol
CDreserved3EFGHIguid (16 bytes)
...
...
...ichEnd
...cchNote
...stAuthor (variable)
...
unused2
+ +**rrd (14 bytes):** An [RRD](#rrd) that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). The **rrd.revt** MUST be equal to 0x000D. The **rrd.tabid** MUST NOT be 0xFFFF. + +**A - bitfDelNote (1 bit):** A bit that specifies whether the revision record deletes the comment. + +**B - bitfAddNote (1 bit):** A bit that specifies whether the revision record adds text to the comment. + +| Value | Meaning | +|----|----| +| 0 | Text has not been added to the comment. | +| 1 | A new comment is being added or additional text is being appended to an existing comment. | + +**reserved1 (14 bits):** MUST be 0 and MUST be ignored. + +**row (2 bytes):** A [RwU](#rwu) that specifies the row of the cell associated with the comment. + +**col (2 bytes):** A [ColU](#colu) that specifies the column of the cell associated with the comment. + +**C - reserved2 (1 bit):** MUST be 0 and MUST be ignored. + +**D - fShow (1 bit):** A bit that specifies whether the comment is shown. + +**reserved3 (5 bits):** MUST be 0 and MUST be ignored. + +**E - fRwHidden (1 bit):** A bit that specifies whether the row specified by **row** is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**F - fColHidden (1 bit):** A bit that specifies whether the column specified by **col** is hidden. + +**G - reserved4 (2 bits):** MUST be 0 and MUST be ignored. + +**H - unused1 (1 bit):** Unused and MUST be ignored. + +**I - reserved5 (4 bits):** MUST be 0 and MUST be ignored. + +**guid (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that identifies the comment, specified by a [NoteSh](#notesh) structure, which is modified by this revision record. The GUID for a comment is specified in the [Obj](#obj) record specified by the **idObj** field in the NoteSh structure. In the Obj record, the GUID is stored in the **nts.guid** field. If **bitfDelNote** is 1, this field MUST be zero. + +**ichEnd (4 bytes):** An unsigned integer that specified the length of the comment before the revision is made. + +**cchNote (4 bytes):** An unsigned integer that specifies the length of the string that was added to the comment in the revision record. The sum of **ichEnd** and **cchNote** MUST be less than or equal to 32767. + +**stAuthor (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the original author of the comment. The length MUST be greater than or equal to 1 and less than or equal to 54. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +### NoteSh + +The **NoteSh** structure specifies a [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) associated with a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rowcol
ABCDEFGreserved4idObj
stAuthor (variable)
...
unused2
+ +**row (2 bytes):** A [RW](#rw) that specifies the row of the cell to which this comment is associated. + +**col (2 bytes):** A [Col](#col) that specifies the column of the cell to which this comment is associated. + +**A - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**B - fShow (1 bit):** A bit that specifies whether the comment is shown at all times. + +**C - reserved2 (1 bit):** MUST be zero and MUST be ignored. + +**D - unused1 (1 bit):** Undefined and MUST be ignored. + +**E - reserved3 (3 bits):** MUST be zero and MUST be ignored. + +**F - fRwHidden (1 bit):** A bit that specifies whether the row specified by **row** is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**G - fColHidden (1 bit):** A bit that specifies whether the column specified by **col** is hidden. + +**reserved4 (7 bits):** MUST be zero and MUST be ignored. + +**idObj (2 bytes):** An [ObjId](#objid) that specifies the [Obj](#obj) record that specifies the comment text. + +**stAuthor (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the name of the comment author. String length MUST be greater than or equal to 1 and less than or equal to 54. + +**unused2 (1 byte):** Undefined and MUST be ignored. + +### ObjFmla + +The **ObjFmla** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in an [Obj](#obj) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cbFmlafmla (variable)
...
embedInfo (variable)
...
padding (variable)
...
+ +**cbFmla (2 bytes):** An unsigned integer that specifies the number of bytes in this ObjFmla, not counting the two bytes of the **cbFmla** field itself. This number MUST be even. + +**fmla (variable):** An optional [ObjectParsedFormula](#objectparsedformula) that specifies the formula. This field MUST exist if and only if **cbFmla** is greater than 0x0000. + +**embedInfo (variable):** An optional [PictFmlaEmbedInfo](#pictfmlaembedinfo). This field MUST exist if and only if the structure containing this ObjFmla is an [FtPictFmla](#ftpictfmla), the **fmla** field exists, and the **fmla.rgce** field starts with a [PtgTbl](#ptgtbl). + +**padding (variable):** An array of bytes whose size is given by: +**cbFmla** minus size of **fmla** minus size of **embedInfo**. + +It is possible for this array to be empty. The value of the elements in this array are undefined and MUST be ignored. + +### ObjId + +The **ObjId** structure specifies a reference to an [Obj](#obj). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
id
+ +**id (2 bytes):** An unsigned integer that specifies the value of the **cmo.id** field of an Obj in the same [**drawing**](#gt_4b4d1a42-c4a2-464d-ad16-d53b5c493fd3). A value of 0 specifies that this ObjId does not reference an Obj. + +### ObjLinkFmla + +The **ObjLinkFmla** structure specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) which contains a value that is linked to the control represented by the [Obj](#obj) record containing this ObjLinkFmla. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ftfmla (variable)
...
+ +**ft (2 bytes):** Reserved. MUST be 0x0014 if the **cmo.ot** of the containing Obj is equal to 0x0B or 0x0C. MUST be 0x000E if the **cmo.ot** field of the containing Obj is equal to 0x10, 0x11, 0x12, or 0x14. Note that this ObjLinkFmla MUST NOT exist if **cmo.ot** is any other value. + +**fmla (variable):** An [ObjFmla](#objfmla) that specifies the formula which specifies a range which contains a value that is linked to the state of the control. + +### ODBCType + +The **ODBCType** structure specifies an [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) data type identifier. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
wTypeSql
+ +**wTypeSql (2 bytes):** A signed integer that specifies an ODBC data type. The following are example data types supported by ODBC. For more information about ODBC, see [\[MSDN-OpenDBConnectivity\]](https://go.microsoft.com/fwlink/?LinkId=114655). + +| Value | SQL Type | Data Type | +|----|----|----| +| 0x0000 | SQL_TYPE_NULL | Undetermined type, [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) does not support typed data. Data type determined based on data content: date and time, decimal or text. | +| 0x0001 | SQL_CHAR | Fixed-length string of ANSI characters | +| 0x0003 | SQL_DECIMAL | Fixed-precision, Fixed-scale numbers | +| 0x0004 | SQL_INTEGER | 32-bit signed integer | +| 0x0005 | SQL_SMALLINT | 16-bit signed integer | +| 0x0006 | SQL_FLOAT | User-specified precision floating-point | +| 0x0007 | SQL_REAL | 7-digits precision floating-point | +| 0x0008 | SQL_DOUBLE | 15-digits precision floating-point | +| 0x000B | SQL_TIMESTAMP | Date and Time | +| 0x000C | SQL_VARCHAR | Variable-length string of ANSI characters | +| 0xFFF9 | SQL_BIT | Bit (1 or 0) | +| 0xFFFE | SQL_BINARY | Fixed-length binary data | + +### OfficeArtClientAnchorChart + +The **OfficeArtClientAnchorChart** structure specifies the anchor position of a [**drawing object**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) embedded in a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rh
...
ABCDEunusedlx1
...ly1
...lx2
...ly2
...
+ +**rh (8 bytes):** An OfficeArtRecordHeader as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.2.1 that specifies the header for this structure. **rh.recVer** MUST be 0x0. **rh.recInstance** MUST be 0x0. **rh.recType** MUST be 0xF010. **rh.recLen** MUST be 0x0012. + +**A - fMove (1 bit):** MUST be 0 and MUST be ignored. + +**B - fSize (1 bit):** A bit that specifies whether the drawing object resizes with the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The drawing object resizes with the chart area (section 2.2.3.17). | +| 0x1 | The drawing object does not resize with the chart area (section 2.2.3.17). | + +**C - reserved1 (1 bit):** MUST be 0 and MUST be ignored. + +**D - reserved2 (1 bit):** Undefined and MUST be ignored. + +**E - reserved3 (1 bit):** MUST be 0 and MUST be ignored. + +**unused (11 bits):** Undefined and MUST be ignored. + +**lx1 (4 bytes):** A signed integer that specifies the horizontal offset of the logical upper-left corner of the [**bounding rectangle**](#gt_e349a155-0fb9-4ba1-abd4-e363e21abcd1) of the drawing object, relative to the upper-left corner of the chart area (section 2.2.3.17) in [SPRC](#Section_d5fc728e68de4972905a975bcef8c82d). + +**ly1 (4 bytes):** A signed integer that specifies the vertical offset of the logical upper-left corner of the bounding rectangle of the drawing object, relative to the upper-left corner of the chart area (section 2.2.3.17) in SPRC. + +**lx2 (4 bytes):** A signed integer that specifies the horizontal offset of the logical bottom-right corner of the bounding rectangle of the drawing object, relative to the upper-left corner of the chart area (section 2.2.3.17) in SPRC. + +**ly2 (4 bytes):** A signed integer that specifies the vertical offset of the logical bottom-right corner of the bounding rectangle of the drawing object, relative to the upper-left corner of the chart area (section 2.2.3.17) in SPRC. + +### OfficeArtClientAnchorHF + +The **OfficeArtClientAnchorHF** structure specifies the [**dimension (2)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) information of a picture specified in a [HFPicture](#hfpicture) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rh
...
width
height
+ +**rh (8 bytes):** An OfficeArtRecordHeader as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) that specifies the header for this structure. The sub-fields of OfficeArtRecordHeader are further specified in the following table: + +| Field | Meaning | +|--------------------|-----------------| +| **rh.recVer** | MUST be 0x0. | +| **rh.recInstance** | MUST be 0x0. | +| **rh.recType** | MUST be 0xF010. | +| **rh.recLen** | MUST be 8. | + +**width (4 bytes):** A signed integer that specifies the width of the picture in pixels. This value MUST be greater than 0. + +**height (4 bytes):** A signed integer that specifies the height of the picture in pixels. This value MUST be greater than 0. + +### OfficeArtClientAnchorSheet + +The **OfficeArtClientAnchorSheet** structure specifies the anchor position of a [**drawing object**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) embedded in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rh
...
ABCDEunusedcolL
dxLrwT
dyTcolR
dxRrwB
dyB
+ +**rh (8 bytes):** An OfficeArtRecordHeader as defined in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) that specifies the header for this structure. The sub-fields of OfficeArtRecordHeader are further specified in the following table: + +| Field | Meaning | +|----|----| +| **rh.recVer** | MUST be 0x0. | +| **rh.recInstance** | MUST be 0x0. | +| **rh.recType** | MUST be 0xF010. | +| **rh.recLen** | An unsigned integer that specifies the number of bytes following the header. The value MUST be equal to 18. | + +**A - fMove (1 bit):** A bit that specifies whether the [**shape**](#gt_d0e38aa4-2c71-4a6f-b5e6-75766fa9409e) will be kept intact when the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) are moved. + +**B - fSize (1 bit):** A bit that specifies whether the shape will be kept intact when the cells are resized. If **fMove** is 1, the value MUST be 1. + +**C - reserved1 (1 bit):** MUST be 0 and MUST be ignored. + +**D - reserved2 (1 bit):** MUST be 0 and MUST be ignored + +**E - reserved3 (1 bit):** MUST be 0 and MUST be ignored. + +**unused (11 bits):** Undefined and MUST be ignored. + +**colL (2 bytes):** A [Col256U](#col256u) that specifies the column of the cell under the top left corner of the [**bounding rectangle**](#gt_e349a155-0fb9-4ba1-abd4-e363e21abcd1) of the shape. + +**dxL (2 bytes):** A signed integer that specifies the x coordinate of the top left corner of the bounding rectangle relative to the corner of the underlying cell. The value is expressed as 1024th’s of that cell’s width. + +**rwT (2 bytes):** A [RwU](#rwu) that specifies the row of the cell under the top left corner of the bounding rectangle of the shape. + +**dyT (2 bytes):** A signed integer that specifies the y coordinate of the top left corner of the bounding rectangle relative to the corner of the underlying cell. The value is expressed as 256th’s of that cell’s height. + +**colR (2 bytes):** A Col256U that specifies the column of the cell under the bottom right corner of the bounding rectangle of the shape. + +**dxR (2 bytes):** A signed integer that specifies the x coordinate of the bottom right corner of the bounding rectangle relative to the corner of the underlying cell. The value is expressed as 1024th’s of that cell’s width. + +**rwB (2 bytes):** A RwU that specifies the row of the cell under the bottom right corner of the bounding rectangle of the shape. + +**dyB (2 bytes):** A signed integer that specifies the y coordinate of the bottom right corner of the bounding rectangle relative to the corner of the underlying cell. The value is expressed as 256th’s of that cell’s height. + +### OfficeArtClientData + +The **OfficeArtClientData** structure specifies the client data of an [**drawing object**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac). MUST be the last structure of the **rgChildRec** field of the current [MsoDrawing](#msodrawing) record. And the next record MUST be [**Obj**](#obj), which contains the detailed data information about this drawing object. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rh
...
+ +**rh (8 bytes):** An OfficeArtRecordHeader as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.2.1 that specifies the header for this structure. The subfields of OfficeArtRecordHeader are further specified in the following table: + +| Field | Meaning | +|----|----| +| **rh.recVer** | MUST be 0x0. | +| **rh.recInstance** | MUST be 0x0. | +| **rh.recType** | MUST be 0xF011. | +| **rh.recLen** | An unsigned integer that specifies the number of bytes following the header. The value MUST be equal to 0. | + +### OfficeArtClientTextbox + +The **OfficeArtClientTextbox** structure specifies the client textbox of an [**drawing object**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac). MUST be the last structure of the **rgChildRec** field of the [MsoDrawing](#msodrawing) record. And the next record MUST be [**TxO**](#txo), which contains the detailed textbox information about this drawing object. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rh
...
+ +**rh (8 bytes):** An OfficeArtRecordHeader as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.2.1 that specifies the header for this structure. The subfields of OfficeArtRecordHeader are further specified in the following table: + +| Field | Meaning | +|----|----| +| **rh.recVer** | MUST be 0x0. | +| **rh.recInstance** | MUST be 0x0. | +| **rh.recType** | MUST be 0xF00D. | +| **rh.recLen** | An unsigned integer that specifies the number of bytes following the header. The value MUST be equal to 0. | + +### PaneType + +The **PaneType** enumeration specifies the different types of [**panes**](#gt_fa363a22-6c89-4829-86aa-09f939f40a54). + +| Name | Value | Meaning | +|---------------------|-------|---------------------------| +| **REVTPNNBOTRIGHT** | 0x00 | logical bottom-right pane | +| **REVTPNNTOPRIGHT** | 0x01 | logical top-right pane | +| **REVTPNNBOTLEFT** | 0x02 | logical bottom-left pane | +| **REVTPNNTOPLEFT** | 0x03 | logical top-left pane | + +### PARAMQRY_Fixed + +**PARAMQRY_Fixed** structure contains information about [**SQL**](#gt_37416b0f-ca5b-4fac-96e5-082eb80a3d84) query parameters. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
wTypeSqlpbtABunused2
grbitfVal
+ +**wTypeSql (2 bytes):** An [ODBCType](#odbctype) structure that specifies the SQL data type. + +**pbt (2 bits):** An unsigned integer that specifies the parameter type. MUST be a value from the following table: + +| Value | Meaning | +|------:|----------------------------------------------------------| +| 0 | Prompt. User is prompted for the value of the parameter. | +| 1 | Value. The parameter value is specified in the query. | +| 2 | Reference. The parameter value is specified in a cell. | + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - fNonDefaultName (1 bit):** A bit that specifies whether to use the default prompt if **pbt** is equal to 0. MUST be a value from the following table: + +| Value | Meaning | +|------:|--------------------------------------| +| 0 | User entered prompt is used | +| 1 | Application’s default prompt is used | + +**unused2 (12 bits):** Undefined and MUST be ignored. + +**grbit (2 bytes):** An unsigned integer that specifies the type of data that follows this structure as specified in the following table or the presence of a Boolean value in **fVal** if **pbt** equals 1**.** MUST be a value from the following table if **pbt** equals 1: + +| Value | Meaning | +|------:|---------------------------------------------------------| +| 0x001 | Xnum (section [2.5.342](#xnum)) | +| 0x002 | [SXString](#sxstring) | +| 0x004 | Boolean (section [2.5.14](#boolean)) value in **fVal.** | +| 0x800 | 4 byte unsigned integer | + +**fVal (2 bytes):** A Boolean that specifies value such that if **pbt** equals 1 and **grbit** equals 4. MUST be equal to 0 or 1 if **pbt** equals 1 and **grbit** equals 4. MUST be ignored if **pbt** is not equal to 1 or **grbit** is not equal to 4. + +### Parsed Expressions + +#### ArrayParsedFormula + +The **ArrayParsedFormula** structure specifies an array formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccergce (variable)
...
rgcb (variable)
...
+ +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula (section 2.2.2). MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgRefN](#ptgrefn), [PtgAreaN](#ptgarean), or [PtgSxName](#ptgsxname). + +**rgcb (variable):** An [RgbExtra](#rgbextra) that specifies ancillary data for the formula. + +#### BErr + +The **BErr** structure is a 1 byte unsigned integer that specifies an error. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------| +| 0x00 | \#NULL! | +| 0x07 | \#DIV/0! | +| 0x0F | \#VALUE! | +| 0x17 | \#REF! | +| 0x1D | \#NAME? | +| 0x24 | \#NUM! | +| 0x2A | \#N/A | + +#### CellParsedFormula + +The **CellParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) stored in a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccergce (variable)
...
rgcb (variable)
...
+ +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgRefN](#ptgrefn), [PtgAreaN](#ptgarean), or [PtgSxName](#ptgsxname). + +The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +**rgcb (variable):** An [RgbExtra](#rgbextra) that specifies ancillary data for the formula. + +#### Cetab + +The **Cetab** structure specifies a function that can be called from a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). The definition of each function specifies the function name and the valid sequence of arguments. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
cetab
+ +**cetab (2 bytes):** An unsigned integer that specifies the function to be called. MUST be a value from the following table: + +The elements [ref](#rgce) and val are specified in Rgce. + +| Value | Meaning | +|----|----| +| 0x0000 | BEEP | +| | beep-params = \[val\] | +| 0x0001 | OPEN | +| | open-params = \*17(val) | +| 0x0002 | OPEN.LINKS | +| | open-links-params = \*15(val) | +| 0x0003 | CLOSE.ALL | +| | This function takes no parameters | +| 0x0004 | SAVE | +| | This function takes no parameters | +| 0x0005 | SAVE.AS | +| | save-as-params = \*7(val) | +| 0x0006 | FILE.DELETE | +| | file-delete-params = \[val\] | +| 0x0007 | PAGE.SETUP | +| | page-setup-params = \*30(val) | +| 0x0008 | PRINT | +| | print-params = \*17(val) | +| 0x0009 | PRINTER.SETUP | +| | printer-setup-params = \[val\] | +| 0x000A | QUIT | +| | This function takes no parameters | +| 0x000B | NEW.WINDOW | +| | This function takes no parameters | +| 0x000C | ARRANGE.ALL | +| | arrange-All-params = \*4(val) | +| 0x000D | WINDOW.SIZE | +| | window-size-params = \*3(val) | +| 0x000E | WINDOW.MOVE | +| | window-move-params = \*3(val) | +| 0x000F | FULL | +| | full-params = \[val\] | +| 0x0010 | CLOSE | +| | close-params = \*2(val) | +| 0x0011 | RUN | +| | run-params = \[(ref / val), \[val\]\] | +| 0x0016 | SET.PRINT.AREA | +| | set-print-area-params = \[ref / val\] | +| 0x0017 | SET.PRINT.TITLES | +| | set-print-titles-params = \*2(ref / val) | +| 0x0018 | SET.PAGE.BREAK | +| | This function takes no parameters | +| 0x0019 | REMOVE.PAGE.BREAK | +| | remove-page-break-params = \*2(val) | +| 0x001A | FONT | +| | font-params = \*2(val) | +| 0x001B | DISPLAY | +| | display-params = \*9(val) | +| 0x001C | PROTECT.DOCUMENT | +| | protect-document-params = \*7(val) | +| 0x001D | PRECISION | +| | precision-params = \[val\] | +| 0x001E | A1.R1C1 | +| | a1-r1c1-params = \[val\] | +| 0x001F | CALCULATE.NOW | +| | This function takes no parameters | +| 0x0020 | CALCULATION | +| | calculation-params = \*11(val) | +| 0x0022 | DATA.FIND | +| | data-find-params = \[val\] | +| 0x0023 | EXTRACT | +| | extract-params = \[val\] | +| 0x0024 | DATA.DELETE | +| | This function takes no parameters | +| 0x0025 | SET.DATABASE | +| | This function takes no parameters | +| 0x0026 | SET.CRITERIA | +| | This function takes no parameters | +| 0x0027 | SORT | +| | sort-params = \[val, \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \*10(val)\]\]\]\]\]\]\] | +| 0x0028 | DATA.SERIES | +| | data-series-params = \*6(val) | +| 0x0029 | TABLE | +| | table-params = \*2(ref / val) | +| 0x002A | FORMAT.NUMBER | +| | format-number-params = \[val\] | +| 0x002B | ALIGNMENT | +| | alignment-params = \*10(val) | +| 0x002C | STYLE | +| | style-params = \*2(val) | +| 0x002D | BORDER | +| | border-params = \*27(val) | +| 0x002E | CELL.PROTECTION | +| | [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461)-protection-params = \*2(val) | +| 0x002F | COLUMN.WIDTH | +| | column-width-params = \[val, \*4(ref / val)\] | +| 0x0030 | UNDO | +| | This function takes no parameters | +| 0x0031 | CUT | +| | cut-params = \*2(ref / val) | +| 0x0032 | COPY | +| | copy-params = \*2(ref / val) | +| 0x0033 | PASTE | +| | paste-params = \[ref / val\] | +| 0x0034 | CLEAR | +| | clear-params = \[val\] | +| 0x0035 | PASTE.SPECIAL | +| | paste-special-params = \*7(val) | +| 0x0036 | EDIT.DELETE | +| | edit-delete-params = \[val\] | +| 0x0037 | INSERT | +| | insert-params = \*2(val) | +| 0x0038 | FILL.RIGHT | +| | This function takes no parameters | +| 0x0039 | FILL.DOWN | +| | This function takes no parameters | +| 0x003D | DEFINE.NAME | +| | define-name-params = \[val, \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[val\]\]\]\]\]\]\] | +| 0x003E | CREATE.NAMES | +| | create-names-params = \*4(val) | +| 0x003F | FORMULA.GOTO | +| | formula-goto-params = \[(ref / val), \[val\]\] | +| 0x0040 | FORMULA.FIND | +| | formula-find-params = \*12(val) | +| 0x0041 | SELECT.LAST.CELL | +| | This function takes no parameters | +| 0x0042 | SHOW.ACTIVE.CELL | +| | This function takes no parameters | +| 0x0043 | GALLERY.AREA | +| | gAllery-area-params = \*2(val) | +| 0x0044 | GALLERY.BAR | +| | gAllery-bar-params = \*2(val) | +| 0x0045 | GALLERY.COLUMN | +| | gAllery-column-params = \*2(val) | +| 0x0046 | GALLERY.LINE | +| | gAllery-line-params = \*2(val) | +| 0x0047 | GALLERY.PIE | +| | gAllery-pie-params = \*2(val) | +| 0x0048 | GALLERY.SCATTER | +| | gAllery-scatter-params = \*2(val) | +| 0x0049 | COMBINATION | +| | combination-params = \[val\] | +| 0x004A | PREFERRED | +| | This function takes no parameters | +| 0x004B | ADD.OVERLAY | +| | This function takes no parameters | +| 0x004C | GRIDLINES | +| | gridlines-params = \*7(val) | +| 0x004D | SET.PREFERRED | +| | set-preferred-params = \[val\] | +| 0x004E | AXES | +| | axes-params = \*6(val) | +| 0x004F | LEGEND | +| | legend-params = \[val\] | +| 0x0050 | ATTACH.TEXT | +| | attach-text-params = \*3(val) | +| 0x0051 | ADD.ARROW | +| | This function takes no parameters | +| 0x0052 | SELECT.CHART | +| | This function takes no parameters | +| 0x0053 | SELECT.PLOT.AREA | +| | This function takes no parameters | +| 0x0054 | PATTERNS | +| | patterns-params = \*13(val) | +| 0x0055 | MAIN.CHART | +| | main-chart-params = \*10(val) | +| 0x0056 | OVERLAY | +| | overlay-params = \*12(val) | +| 0x0057 | SCALE | +| | scale-params = \*10(val) | +| 0x0058 | FORMAT.LEGEND | +| | format-legend-params = \[val\] | +| 0x0059 | FORMAT.TEXT | +| | format-text-params = \*11(val) | +| 0x005A | EDIT.REPEAT | +| | This function takes no parameters | +| 0x005B | PARSE | +| | parse-params = \[val, \[ref / val\]\] | +| 0x005C | JUSTIFY | +| | This function takes no parameters | +| 0x005D | HIDE | +| | This function takes no parameters | +| 0x005E | UNHIDE | +| | unhide-params = \[val\] | +| 0x005F | WORKSPACE | +| | workspace-params = \*16(val) | +| 0x0060 | FORMULA | +| | formula-params = \[val, \[ref / val\]\] | +| 0x0061 | FORMULA.FILL | +| | formula-fill-params = \[val, \[ref / val\]\] | +| 0x0062 | FORMULA.ARRAY | +| | formula-array-params = \[val, \[ref / val\]\] | +| 0x0063 | DATA.FIND.NEXT | +| | This function takes no parameters | +| 0x0064 | DATA.FIND.PREV | +| | This function takes no parameters | +| 0x0065 | FORMULA.FIND.NEXT | +| | This function takes no parameters | +| 0x0066 | FORMULA.FIND.PREV | +| | This function takes no parameters | +| 0x0067 | ACTIVATE | +| | activate-params = \*2(val) | +| 0x0068 | ACTIVATE.NEXT | +| | activate-next-params = \[val\] | +| 0x0069 | ACTIVATE.PREV | +| | activate-prev-params = \[val\] | +| 0x006A | UNLOCKED.NEXT | +| | This function takes no parameters | +| 0x006B | UNLOCKED.PREV | +| | This function takes no parameters | +| 0x006C | COPY.PICTURE | +| | copy-picture-params = \*3(val) | +| 0x006D | SELECT | +| | select-params = \*2(ref / val) | +| 0x006E | DELETE.NAME | +| | delete-name-params = \[val\] | +| 0x006F | DELETE.FORMAT | +| | delete-format-params = \[val\] | +| 0x0070 | VLINE | +| | vline-params = \[val\] | +| 0x0071 | HLINE | +| | hline-params = \[val\] | +| 0x0072 | VPAGE | +| | vpage-params = \[val\] | +| 0x0073 | HPAGE | +| | hpage-params = \[val\] | +| 0x0074 | VSCROLL | +| | vscroll-params = \*2(val) | +| 0x0075 | HSCROLL | +| | hscroll-params = \*2(val) | +| 0x0076 | ALERT | +| | alert-params = \*3(val) | +| 0x0077 | NEW | +| | new-params = \*3(val) | +| 0x0078 | CANCEL.COPY | +| | cancel-copy-params = \[val\] | +| 0x0079 | SHOW.CLIPBOARD | +| | This function takes no parameters | +| 0x007A | MESSAGE | +| | message-params = \*2(val) | +| 0x007C | PASTE.LINK | +| | This function takes no parameters | +| 0x007D | APP.ACTIVATE | +| | app-activate-params = \*2(val) | +| 0x007E | DELETE.ARROW | +| | This function takes no parameters | +| 0x007F | ROW.HEIGHT | +| | row-height-params = \[val, \*3(ref / val)\] | +| 0x0080 | FORMAT.MOVE | +| | format-move-params = \[val, \*2(ref / val)\] | +| 0x0081 | FORMAT.SIZE | +| | format-size-params = \[val, \*2(ref / val)\] | +| 0x0082 | FORMULA.REPLACE | +| | formula-replace-params = \*11(val) | +| 0x0083 | SEND.KEYS | +| | send-keys-params = \*2(val) | +| 0x0084 | SELECT.SPECIAL | +| | select-special-params = \*3(val) | +| 0x0085 | APPLY.NAMES | +| | apply-names-params = \*7(val) | +| 0x0086 | REPLACE.FONT | +| | replace-font-params = \*10(val) | +| 0x0087 | FREEZE.PANES | +| | freeze-panes-params = \*3(val) | +| 0x0088 | SHOW.INFO | +| | show-info-params = \[val\] | +| 0x0089 | SPLIT | +| | split-params = \*2(val) | +| 0x008A | ON.WINDOW | +| | on-window-params = \*2(val) | +| 0x008B | ON.DATA | +| | on-data-params = \*2(val) | +| 0x008C | DISABLE.INPUT | +| | disable-input-params = \[val\] | +| 0x008E | OUTLINE | +| | outline-params = \*4(val) | +| 0x008F | LIST.NAMES | +| | This function takes no parameters | +| 0x0090 | FILE.CLOSE | +| | file-close-params = \*2(val) | +| 0x0091 | SAVE.WORKBOOK | +| | save-[**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe)-params = \*6(val) | +| 0x0092 | DATA.FORM | +| | This function takes no parameters | +| 0x0093 | COPY.CHART | +| | copy-chart-params = \[val\] | +| 0x0094 | ON.TIME | +| | on-time-params = \*4(val) | +| 0x0095 | WAIT | +| | wait-params = \[val\] | +| 0x0096 | FORMAT.FONT | +| | format-font-params = \*15(val) | +| 0x0097 | FILL.UP | +| | This function takes no parameters | +| 0x0098 | FILL.LEFT | +| | This function takes no parameters | +| 0x0099 | DELETE.OVERLAY | +| | This function takes no parameters | +| 0x009B | SHORT.MENUS | +| | short-menus-params = \[val\] | +| 0x009F | SET.UPDATE.STATUS | +| | set-update-status-params = \*3(val) | +| 0x00A1 | COLOR.PALETTE | +| | color-palette-params = \[val\] | +| 0x00A2 | DELETE.STYLE | +| | delete-style-params = \[val\] | +| 0x00A3 | WINDOW.RESTORE | +| | window-restore-params = \[val\] | +| 0x00A4 | WINDOW.MAXIMIZE | +| | window-maximize-params = \[val\] | +| 0x00A6 | CHANGE.LINK | +| | change-link-params = \*3(val) | +| 0x00A7 | CALCULATE.DOCUMENT | +| | This function takes no parameters | +| 0x00A8 | ON.KEY | +| | on-key-params = \*2(val) | +| 0x00A9 | APP.RESTORE | +| | This function takes no parameters | +| 0x00AA | APP.MOVE | +| | app-move-params = \*2(val) | +| 0x00AB | APP.SIZE | +| | app-size-params = \*2(val) | +| 0x00AC | APP.MINIMIZE | +| | This function takes no parameters | +| 0x00AD | APP.MAXIMIZE | +| | This function takes no parameters | +| 0x00AE | BRING.TO.FRONT | +| | This function takes no parameters | +| 0x00AF | SEND.TO.BACK | +| | This function takes no parameters | +| 0x00B9 | MAIN.CHART.TYPE | +| | main-chart-type-params = \[val\] | +| 0x00BA | OVERLAY.CHART.TYPE | +| | overlay-chart-type-params = \[val\] | +| 0x00BB | SELECT.END | +| | select-end-params = \[val\] | +| 0x00BC | OPEN.MAIL | +| | open-mail-params = \*2(val) | +| 0x00BD | SEND.MAIL | +| | send-mail-params = \[(ref / val), \*2(val)\] | +| 0x00BE | STANDARD.FONT | +| | standard-font-params = \*9(val) | +| 0x00BF | CONSOLIDATE | +| | consolidate-params = \*5(val) | +| 0x00C0 | SORT.SPECIAL | +| | sort-special-params = \[val, \[val, \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \*6(val)\]\]\]\]\]\]\]\] | +| 0x00C1 | GALLERY.3D.AREA | +| | gAllery-3d-area-params = \[val\] | +| 0x00C2 | GALLERY.3D.COLUMN | +| | gAllery-3d-column-params = \[val\] | +| 0x00C3 | GALLERY.3D.LINE | +| | gAllery-3d-line-params = \[val\] | +| 0x00C4 | GALLERY.3D.PIE | +| | gAllery-3d-pie-params = \[val\] | +| 0x00C5 | VIEW.3D | +| | view-3d-params = \*6(val) | +| 0x00C6 | GOAL.SEEK | +| | goal-seek-params = \*3(ref / val) | +| 0x00C7 | WORKGROUP | +| | workgroup-params = \[val\] | +| 0x00C8 | FILL.GROUP | +| | fill-group-params = \[val\] | +| 0x00C9 | UPDATE.LINK | +| | update-link-params = \*2(val) | +| 0x00CA | PROMOTE | +| | promote-params = \[val\] | +| 0x00CB | DEMOTE | +| | demote-params = \[val\] | +| 0x00CC | SHOW.DETAIL | +| | show-detail-params = \*4(val) | +| 0x00CE | UNGROUP | +| | This function takes no parameters | +| 0x00CF | OBJECT.PROPERTIES | +| | object-properties-params = \*2(val) | +| 0x00D0 | SAVE.NEW.OBJECT | +| | save-new-object-params = \[val\] | +| 0x00D1 | SHARE | +| | This function takes no parameters | +| 0x00D2 | SHARE.NAME | +| | share-name-params = \[val\] | +| 0x00D3 | DUPLICATE | +| | This function takes no parameters | +| 0x00D4 | APPLY.STYLE | +| | apply-style-params = \[val\] | +| 0x00D5 | ASSIGN.TO.OBJECT | +| | assign-to-object-params = \[ref / val\] | +| 0x00D6 | OBJECT.PROTECTION | +| | object-protection-params = \*2(val) | +| 0x00D7 | HIDE.OBJECT | +| | hide-object-params = \*2(val) | +| 0x00D8 | SET.EXTRACT | +| | This function takes no parameters | +| 0x00D9 | CREATE.PUBLISHER | +| | create-publisher-params = \*4(val) | +| 0x00DA | SUBSCRIBE.TO | +| | subscribe-to-params = \*2(val) | +| 0x00DB | ATTRIBUTES | +| | attributes-params = \*2(val) | +| 0x00DC | SHOW.TOOLBAR | +| | show-toolbar-params = \*10(val) | +| 0x00DE | PRINT.PREVIEW | +| | print-preview-params = \[val\] | +| 0x00DF | EDIT.COLOR | +| | edit-color-params = \*4(val) | +| 0x00E0 | SHOW.LEVELS | +| | show-levels-params = \*2(val) | +| 0x00E1 | FORMAT.MAIN | +| | format-main-params = \*14(val) | +| 0x00E2 | FORMAT.OVERLAY | +| | format-overlay-params = \*14(val) | +| 0x00E3 | ON.RECALC | +| | on-recalc-params = \*2(val) | +| 0x00E4 | EDIT.SERIES | +| | edit-series-params = \[val, \*6(ref / val)\] | +| 0x00E5 | DEFINE.STYLE | +| | define-style-params = \*14(val) | +| 0x00F0 | LINE.PRINT | +| | line-print-params = \*11(val) | +| 0x00F3 | ENTER.DATA | +| | enter-data-params = \[ref / val\] | +| 0x00F9 | GALLERY.RADAR | +| | gAllery-radar-params = \*2(val) | +| 0x00FA | MERGE.STYLES | +| | merge-styles-params = \[val\] | +| 0x00FB | EDITION.OPTIONS | +| | edition-options-params = \[val, \*6(ref / val)\] | +| 0x00FC | PASTE.PICTURE | +| | This function takes no parameters | +| 0x00FD | PASTE.PICTURE.LINK | +| | This function takes no parameters | +| 0x00FE | SPELLING | +| | spelling-params = \*6(val) | +| 0x0100 | ZOOM | +| | zoom-params = \[val\] | +| 0x0103 | INSERT.OBJECT | +| | insert-object-params = \[val, \[val, \[val, \[val, \[val, \[val, \[val, \[(ref / val), \[val, \[val, \[(ref / val), \*2(val)\]\]\]\]\]\]\]\]\]\]\] | +| 0x0104 | WINDOW.MINIMIZE | +| | window-minimize-params = \[val\] | +| 0x0109 | SOUND.NOTE | +| | sound-note-params = \[(ref / val), \*2(val)\] | +| 0x010A | SOUND.PLAY | +| | sound-play-params = \[(ref / val), \*2(val)\] | +| 0x010B | FORMAT.SHAPE | +| | format-shape-params = \[val, \[val, \[(ref / val), \*2(val)\]\]\] | +| 0x010C | EXTEND.POLYGON | +| | extend-polygon-params = \[val\] | +| 0x010D | FORMAT.AUTO | +| | format-auto-params = \*7(val) | +| 0x0110 | GALLERY.3D.BAR | +| | gAllery-3d-bar-params = \[val\] | +| 0x0111 | GALLERY.3D.SURFACE | +| | gAllery-3d-surface-params = \[val\] | +| 0x0112 | FILL.AUTO | +| | fill-auto-params = \[(ref / val), \[val\]\] | +| 0x0114 | CUSTOMIZE.TOOLBAR | +| | customize-toolbar-params = \[val\] | +| 0x0115 | ADD.TOOL | +| | add-tool-params = \*3(val) | +| 0x0116 | EDIT.OBJECT | +| | edit-object-params = \[val\] | +| 0x0117 | ON.DOUBLECLICK | +| | on-doubleclick-params = \*2(val) | +| 0x0118 | ON.ENTRY | +| | on-entry-params = \*2(val) | +| 0x0119 | WORKBOOK.ADD | +| | workbook-add-params = \*3(val) | +| 0x011A | WORKBOOK.MOVE | +| | workbook-move-params = \*3(val) | +| 0x011B | WORKBOOK.COPY | +| | workbook-copy-params = \*3(val) | +| 0x011C | WORKBOOK.OPTIONS | +| | workbook-options-params = \*3(val) | +| 0x011D | SAVE.WORKSPACE | +| | save-workspace-params = \[val\] | +| 0x0120 | CHART.WIZARD | +| | chart-wizard-params = \[val, \[(ref / val), \*12(val)\]\] | +| 0x0121 | DELETE.TOOL | +| | delete-tool-params = \*2(val) | +| 0x0122 | MOVE.TOOL | +| | move-tool-params = \*6(val) | +| 0x0123 | WORKBOOK.SELECT | +| | workbook-select-params = \*3(val) | +| 0x0124 | WORKBOOK.ACTIVATE | +| | workbook-activate-params = \*2(val) | +| 0x0125 | ASSIGN.TO.TOOL | +| | assign-to-tool-params = \[val, \[val, \[ref / val\]\]\] | +| 0x0127 | COPY.TOOL | +| | copy-tool-params = \*2(val) | +| 0x0128 | RESET.TOOL | +| | reset-tool-params = \*2(val) | +| 0x0129 | CONSTRAIN.NUMERIC | +| | constrain-numeric-params = \[val\] | +| 0x012A | PASTE.TOOL | +| | paste-tool-params = \*2(val) | +| 0x012E | WORKBOOK.NEW | +| | workbook-new-params = \*3(val) | +| 0x0131 | SCENARIO.CELLS | +| | scenario-cells-params = \[ref / val\] | +| 0x0132 | SCENARIO.DELETE | +| | scenario-delete-params = \[val\] | +| 0x0133 | SCENARIO.ADD | +| | scenario-add-params = \[val, \[val, \[(ref / val), \*3(val)\]\]\] | +| 0x0134 | SCENARIO.EDIT | +| | scenario-edit-params = \[val, \[val, \[val, \[(ref / val), \*3(val)\]\]\]\] | +| 0x0135 | SCENARIO.SHOW | +| | scenario-show-params = \[val\] | +| 0x0136 | SCENARIO.SHOW.NEXT | +| | This function takes no parameters | +| 0x0137 | SCENARIO.SUMMARY | +| | scenario-summary-params = \[(ref / val), \[val\]\] | +| 0x0138 | PIVOT.TABLE.WIZARD | +| | pivot-table-wizard-params = \[val, \[(ref / val), \[(ref / val), \*13(val)\]\]\] | +| 0x0139 | PIVOT.FIELD.PROPERTIES | +| | pivot-field-properties-params = \*7(val) | +| 0x013A | PIVOT.FIELD | +| | pivot-field-params = \*4(val) | +| 0x013B | PIVOT.ITEM | +| | pivot-item-params = \*4(val) | +| 0x013C | PIVOT.ADD.FIELDS | +| | pivot-add-fields-params = \*5(val) | +| 0x013E | OPTIONS.CALCULATION | +| | options-calculation-params = \*10(val) | +| 0x013F | OPTIONS.EDIT | +| | options-edit-params = \*11(val) | +| 0x0140 | OPTIONS.VIEW | +| | options-view-params = \*18(val) | +| 0x0141 | ADDIN.MANAGER | +| | addin-manager-params = \*3(val) | +| 0x0142 | MENU.EDITOR | +| | This function takes no parameters | +| 0x0143 | ATTACH.TOOLBARS | +| | This function takes no parameters | +| 0x0144 | VBAActivate | +| | vbaactivate-params = \*2(val) | +| 0x0145 | OPTIONS.CHART | +| | options-chart-params = \*3(val) | +| 0x0148 | VBA.INSERT.FILE | +| | vba-insert-file-params = \[val\] | +| 0x014A | VBA.PROCEDURE.DEFINITION | +| | This function takes no parameters | +| 0x0150 | ROUTING.SLIP | +| | routing-slip-params = \[(ref / val), \*5(val)\] | +| 0x0152 | ROUTE.DOCUMENT | +| | This function takes no parameters | +| 0x0153 | MAIL.LOGON | +| | mail-logon-params = \[(ref / val), \[(ref / val), \[val\]\]\] | +| 0x0156 | INSERT.PICTURE | +| | insert-picture-params = \*2(val) | +| 0x0157 | EDIT.TOOL | +| | edit-tool-params = \*2(val) | +| 0x0158 | GALLERY.DOUGHNUT | +| | gAllery-doughnut-params = \*2(val) | +| 0x015E | CHART.TREND | +| | chart-trend-params = \*8(val) | +| 0x0160 | PIVOT.ITEM.PROPERTIES | +| | pivot-item-properties-params = \*7(val) | +| 0x0162 | WORKBOOK.INSERT | +| | workbook-insert-params = \[val\] | +| 0x0163 | OPTIONS.TRANSITION | +| | options-transition-params = \*5(val) | +| 0x0164 | OPTIONS.GENERAL | +| | options-general-params = \*14(val) | +| 0x0172 | FILTER.ADVANCED | +| | filter-advanced-params = \[val, \[(ref / val), \[(ref / val), \[(ref / val), \[val\]\]\]\]\] | +| 0x0175 | MAIL.ADD.MAILER | +| | This function takes no parameters | +| 0x0176 | MAIL.DELETE.MAILER | +| | This function takes no parameters | +| 0x0177 | MAIL.REPLY | +| | This function takes no parameters | +| 0x0178 | MAIL.REPLY.ALL | +| | This function takes no parameters | +| 0x0179 | MAIL.FORWARD | +| | This function takes no parameters | +| 0x017A | MAIL.NEXT.LETTER | +| | This function takes no parameters | +| 0x017B | DATA.LABEL | +| | data-label-params = \*10(val) | +| 0x017C | INSERT.TITLE | +| | insert-title-params = \*5(val) | +| 0x017D | FONT.PROPERTIES | +| | font-properties-params = \*14(val) | +| 0x017E | MACRO.OPTIONS | +| | macro-options-params = \*10(val) | +| 0x017F | WORKBOOK.HIDE | +| | workbook-hide-params = \*2(val) | +| 0x0180 | WORKBOOK.UNHIDE | +| | workbook-unhide-params = \[val\] | +| 0x0181 | WORKBOOK.DELETE | +| | workbook-delete-params = \[val\] | +| 0x0182 | WORKBOOK.NAME | +| | workbook-name-params = \*2(val) | +| 0x0184 | GALLERY.CUSTOM | +| | gAllery-custom-params = \[val\] | +| 0x0186 | ADD.CHART.AUTOFORMAT | +| | add-chart-autoformat-params = \*2(val) | +| 0x0187 | DELETE.CHART.AUTOFORMAT | +| | delete-chart-autoformat-params = \[val\] | +| 0x0188 | CHART.ADD.DATA | +| | chart-add-data-params = \[val, \[(ref / val), \*4(val)\]\] | +| 0x0189 | AUTO.OUTLINE | +| | This function takes no parameters | +| 0x018A | TAB.ORDER | +| | This function takes no parameters | +| 0x018B | SHOW.DIALOG | +| | show-dialog-params = \[val\] | +| 0x018C | SELECT.ALL | +| | This function takes no parameters | +| 0x018D | UNGROUP.SHEETS | +| | This function takes no parameters | +| 0x018E | SUBTOTAL.CREATE | +| | subtotal-create-params = \*6(val) | +| 0x018F | SUBTOTAL.REMOVE | +| | This function takes no parameters | +| 0x0190 | RENAME.OBJECT | +| | rename-object-params = \[val\] | +| 0x019C | WORKBOOK.SCROLL | +| | workbook-scroll-params = \*2(val) | +| 0x019D | WORKBOOK.NEXT | +| | This function takes no parameters | +| 0x019E | WORKBOOK.PREV | +| | This function takes no parameters | +| 0x019F | WORKBOOK.TAB.SPLIT | +| | workbook-tab-split-params = \[val\] | +| 0x01A0 | FULL.SCREEN | +| | full-screen-params = \[val\] | +| 0x01A1 | WORKBOOK.PROTECT | +| | workbook-protect-params = \*3(val) | +| 0x01A4 | SCROLLBAR.PROPERTIES | +| | scrollbar-properties-params = \*7(val) | +| 0x01A5 | PIVOT.SHOW.PAGES | +| | pivot-show-pages-params = \*2(val) | +| 0x01A6 | TEXT.TO.COLUMNS | +| | text-to-columns-params = \[val, \[(ref / val), \*12(val)\]\] | +| 0x01A7 | FORMAT.CHARTTYPE | +| | format-charttype-params = \*4(val) | +| 0x01A8 | LINK.FORMAT | +| | This function takes no parameters | +| 0x01A9 | TRACER.DISPLAY | +| | tracer-display-params = \*2(val) | +| 0x01AE | TRACER.NAVIGATE | +| | tracer-navigate-params = \*3(val) | +| 0x01AF | TRACER.CLEAR | +| | This function takes no parameters | +| 0x01B0 | TRACER.ERROR | +| | This function takes no parameters | +| 0x01B1 | PIVOT.FIELD.GROUP | +| | pivot-field-group-params = \*4(val) | +| 0x01B2 | PIVOT.FIELD.UNGROUP | +| | This function takes no parameters | +| 0x01B3 | CHECKBOX.PROPERTIES | +| | checkbox-properties-params = \*5(val) | +| 0x01B4 | LABEL.PROPERTIES | +| | label-properties-params = \*3(val) | +| 0x01B5 | LISTBOX.PROPERTIES | +| | listbox-properties-params = \*5(val) | +| 0x01B6 | EDITBOX.PROPERTIES | +| | editbox-properties-params = \*4(val) | +| 0x01B7 | PIVOT.REFRESH | +| | pivot-refresh-params = \[val\] | +| 0x01B8 | LINK.COMBO | +| | link-combo-params = \[val\] | +| 0x01B9 | OPEN.TEXT | +| | open-text-params = \*17(val) | +| 0x01BA | HIDE.DIALOG | +| | hide-dialog-params = \[val\] | +| 0x01BB | SET.DIALOG.FOCUS | +| | set-dialog-focus-params = \[val\] | +| 0x01BC | ENABLE.OBJECT | +| | enable-object-params = \*2(val) | +| 0x01BD | PUSHBUTTON.PROPERTIES | +| | pushbutton-properties-params = \*6(val) | +| 0x01BE | SET.DIALOG.DEFAULT | +| | set-dialog-default-params = \[val\] | +| 0x01BF | FILTER | +| | filter-params = \*6(val) | +| 0x01C0 | FILTER.SHOW.ALL | +| | This function takes no parameters | +| 0x01C1 | CLEAR.OUTLINE | +| | This function takes no parameters | +| 0x01C2 | FUNCTION.WIZARD | +| | function-wizard-params = \[val\] | +| 0x01C3 | ADD.LIST.ITEM | +| | add-list-item-params = \*2(val) | +| 0x01C4 | SET.LIST.ITEM | +| | set-list-item-params = \*2(val) | +| 0x01C5 | REMOVE.LIST.ITEM | +| | remove-list-item-params = \*2(val) | +| 0x01C6 | SELECT.LIST.ITEM | +| | select-list-item-params = \*2(val) | +| 0x01C7 | SET.CONTROL.VALUE | +| | set-control-value-params = \[val\] | +| 0x01C8 | SAVE.COPY.AS | +| | save-copy-as-params = \[val\] | +| 0x01CA | OPTIONS.LISTS.ADD | +| | options-lists-add-params = \[val, \[ref / val\]\] | +| 0x01CB | OPTIONS.LISTS.DELETE | +| | options-lists-delete-params = \[val\] | +| 0x01CC | SERIES.AXES | +| | series-axes-params = \[val\] | +| 0x01CD | SERIES.X | +| | series-x-params = \[ref / val\] | +| 0x01CE | SERIES.Y | +| | series-y-params = \*2(ref / val) | +| 0x01CF | ERRORBAR.X | +| | errorbar-x-params = \[val, \[val, \[val, \[ref / val\]\]\]\] | +| 0x01D0 | ERRORBAR.Y | +| | errorbar-y-params = \[val, \[val, \[val, \[ref / val\]\]\]\] | +| 0x01D1 | FORMAT.CHART | +| | format-chart-params = \[(ref / val), \*17(val)\] | +| 0x01D2 | SERIES.ORDER | +| | series-order-params = \*3(val) | +| 0x01D3 | MAIL.LOGOFF | +| | This function takes no parameters | +| 0x01D4 | CLEAR.ROUTING.SLIP | +| | clear-routing-slip-params = \[val\] | +| 0x01D5 | APP.ACTIVATE.MICROSOFT | +| | app-activate-microsoft-params = \[val\] | +| 0x01D6 | MAIL.EDIT.MAILER | +| | mail-edit-mailer-params = \[val, \[(ref / val), \[(ref / val), \[(ref / val), \[val, \[ref / val\]\]\]\]\]\] | +| 0x01D7 | ON.SHEET | +| | on-sheet-params = \*3(val) | +| 0x01D8 | STANDARD.WIDTH | +| | standard-width-params = \[val\] | +| 0x01D9 | SCENARIO.MERGE | +| | scenario-merge-params = \[val\] | +| 0x01DA | SUMMARY.INFO | +| | summary-info-params = \*5(val) | +| 0x01DB | FIND.FILE | +| | This function takes no parameters | +| 0x01DC | ACTIVE.CELL.FONT | +| | active-cell-font-params = \*14(val) | +| 0x01DD | ENABLE.TIPWIZARD | +| | enable-tipwizard-params = \[val\] | +| 0x01DE | VBA.MAKE.ADDIN | +| | vba-make-addin-params = \[val\] | +| 0x01E0 | INSERTDATATABLE | +| | insertdatatable-params = \[val\] | +| 0x01E1 | WORKGROUP.OPTIONS | +| | This function takes no parameters | +| 0x01E2 | MAIL.SEND.MAILER | +| | mail-send-mailer-params = \*2(val) | +| 0x01E5 | AUTOCORRECT | +| | autocorrect-params = \*2(val) | +| 0x01E9 | POST.DOCUMENT | +| | post-document-params = \[val\] | +| 0x01EB | PICKLIST | +| | This function takes no parameters | +| 0x01ED | VIEW.SHOW | +| | view-show-params = \[val\] | +| 0x01EE | VIEW.DEFINE | +| | view-define-params = \*3(val) | +| 0x01EF | VIEW.DELETE | +| | view-delete-params = \[val\] | +| 0x01FD | SHEET.BACKGROUND | +| | sheet-background-params = \*2(val) | +| 0x01FE | INSERT.MAP.OBJECT | +| | This function takes no parameters | +| 0x01FF | OPTIONS.MENONO | +| | options-menono-params = \*5(val) | +| 0x0205 | MSOCHECKS | +| | This function takes no parameters | +| 0x0206 | NORMAL | +| | This function takes no parameters | +| 0x0207 | LAYOUT | +| | This function takes no parameters | +| 0x0208 | RM.PRINT.AREA | +| | rm-print-area-params = \[ref / val\] | +| 0x0209 | CLEAR.PRINT.AREA | +| | This function takes no parameters | +| 0x020A | ADD.PRINT.AREA | +| | This function takes no parameters | +| 0x020B | MOVE.BRK | +| | move-brk-params = \*4(val) | +| 0x0221 | HIDECURR.NOTE | +| | hidecurr-note-params = \[(ref / val), \[val\]\] | +| 0x0222 | HIDEALL.NOTES | +| | hideall-notes-params = \[val\] | +| 0x0223 | DELETE.NOTE | +| | delete-note-params = \[ref / val\] | +| 0x0224 | TRAVERSE.NOTES | +| | traverse-notes-params = \[(ref / val), \[val\]\] | +| 0x0225 | ACTIVATE.NOTES | +| | activate-notes-params = \[(ref / val), \[val\]\] | +| 0x026C | PROTECT.REVISIONS | +| | This function takes no parameters | +| 0x026D | UNPROTECT.REVISIONS | +| | This function takes no parameters | +| 0x0287 | OPTIONS.ME | +| | options-me-params = \[(ref / val), \*8(val)\] | +| 0x028D | WEB.PUBLISH | +| | web-publish-params = \*9(val) | +| 0x029B | NEWWEBQUERY | +| | newwebquery-params = \[val\] | +| 0x02A1 | PIVOT.TABLE.CHART | +| | pivot-table-chart-params = \[val, \[(ref / val), \[(ref / val), \*13(val)\]\]\] | +| 0x02F1 | OPTIONS.SAVE | +| | options-save-params = \*4(val) | +| 0x02F3 | OPTIONS.SPELL | +| | options-spell-params = \*12(val) | +| 0x0328 | HIDEALL.INKANNOTS | +| | hideall-inkannots-params = \[val\] | + +The following grammar is used in the Rgce structure definition: + +params-cetab = beep-params / open-params / open-links-params / save-as-params / + +file-delete-params / page-setup-params / print-params / + +printer-setup-params / + +arrange-all-params / window-size-params / window-move-params / + +full-params / close-params / run-params / + +set-print-area-params / set-print-titles-params / + +remove-page-break-params / font-params / display-params / + +protect-document-params / precision-params / a1-r1c1-params / calculation-params / data-find-params / + +extract-params / sort-params / data-series-params / + +table-params / format-number-params / alignment-params / + +style-params / border-params / cell-protection-params / + +column-width-params / cut-params / + +copy-params / paste-params / clear-params / + +paste-special-params / edit-delete-params / insert-params / define-name-params / + +create-names-params / formula-goto-params / formula-find-params / gallery-area-params / + +gallery-bar-params / gallery-column-params / gallery-line-params / + +gallery-pie-params / gallery-scatter-params / combination-params / gridlines-params / + +set-preferred-params / axes-params / legend-params / + +attach-text-params / patterns-params / main-chart-params / + +overlay-params / scale-params / format-legend-params / + +format-text-params / parse-params / unhide-params / + +workspace-params / formula-params / formula-fill-params / + +formula-array-params / activate-params / + +activate-next-params / activate-prev-params / copy-picture-params / select-params / + +delete-name-params / delete-format-params / vline-params / + +hline-params / vpage-params / hpage-params / + +vscroll-params / hscroll-params / alert-params / + +new-params / cancel-copy-params / + +message-params / app-activate-params / row-height-params / format-move-params / + +format-size-params / formula-replace-params / send-keys-params / + +select-special-params / apply-names-params / replace-font-params / + +freeze-panes-params / show-info-params / split-params / + +on-window-params / on-data-params / disable-input-params / + +outline-params / file-close-params / + +save-workbook-params / copy-chart-params / + +on-time-params / wait-params / format-font-params / + +short-menus-params / set-update-status-params / color-palette-params / + +delete-style-params / window-restore-params / window-maximize-params / + +change-link-params / on-key-params / app-move-params / app-size-params / main-chart-type-params / overlay-chart-type-params / + +select-end-params / open-mail-params / send-mail-params / + +standard-font-params / consolidate-params / sort-special-params / + +gAllery-3d-area-params / gAllery-3d-column-params / gAllery-3d-line-params / + +gallery-3d-pie-params / view-3d-params / goal-seek-params / + +workgroup-params / fill-group-params / update-link-params / + +promote-params / demote-params / show-detail-params / object-properties-params / save-new-object-params / share-name-params / + +apply-style-params / assign-to-object-params / object-protection-params / + +hide-object-params / create-publisher-params / + +subscribe-to-params / attributes-params / show-toolbar-params / + +print-preview-params / edit-color-params / show-levels-params / + +format-main-params / format-overlay-params / on-recalc-params / + +edit-series-params / define-style-params / line-print-params / + +enter-data-params / gallery-radar-params / merge-styles-params / + +edition-options-params / + +spelling-params / zoom-params / insert-object-params / + +window-minimize-params / + +sound-note-params / sound-play-params / format-shape-params / + +extend-polygon-params / format-auto-params / gallery-3d-bar-params / + +gallery-3d-surface-params / fill-auto-params / customize-toolbar-params / + +add-tool-params / edit-object-params / on-doubleclick-params / + +on-entry-params / workbook-add-params / workbook-move-params / + +workbook-copy-params / workbook-options-params / save-workspace-params / + +chart-wizard-params / delete-tool-params / move-tool-params / + +workbook-select-params / workbook-activate-params / assign-to-tool-params / + +copy-tool-params / reset-tool-params / constrain-numeric-params / + +paste-tool-params / placement-params / + +workbook-new-params / scenario-cells-params / scenario-delete-params / + +scenario-add-params / scenario-edit-params / scenario-show-params / scenario-summary-params / pivot-table-wizard-params / + +pivot-field-properties-params / pivot-field-params / pivot-item-params / + +pivot-add-fields-params / options-calculation-params / options-edit-params / + +options-view-params / addin-manager-params / vbaactivate-params / options-chart-params / + +vba-insert-file-params / routing-slip-params / mail-logon-params / insert-picture-params / + +edit-tool-params / gallery-doughnut-params / chart-trend-params / + +pivot-item-properties-params / workbook-insert-params / options-transition-params / + +options-general-params / filter-advanced-params / data-label-params / + +insert-title-params / font-properties-params / macro-options-params / + +workbook-hide-params / workbook-unhide-params / workbook-delete-params / + +workbook-name-params / gAllery-custom-params / add-chart-autoformat-params / + +delete-chart-autoformat-params / chart-add-data-params / show-dialog-params / subtotal-create-params / + +rename-object-params / workbook-scroll-params / workbook-tab-split-params / full-screen-params / + +workbook-protect-params / scrollbar-properties-params / pivot-show-pages-params / + +text-to-columns-params / format-charttype-params / + +tracer-display-params / tracer-navigate-params / pivot-field-group-params / + +checkbox-properties-params / label-properties-params / listbox-properties-params / + +editbox-properties-params / pivot-refresh-params / link-combo-params / + +open-text-params / hide-dialog-params / set-dialog-focus-params / + +enable-object-params / pushbutton-properties-params / set-dialog-default-params / + +filter-params / + +function-wizard-params / add-list-item-params / set-list-item-params / + +remove-list-item-params / select-list-item-params / set-control-value-params / + +save-copy-as-params / options-lists-add-params / options-lists-delete-params / + +series-axes-params / series-x-params / series-y-params / + +errorbar-x-params / errorbar-y-params / format-chart-params / + +series-order-params / clear-routing-slip-params / + +app-activate-microsoft-params / mail-edit-mailer-params / on-sheet-params / + +standard-width-params / scenario-merge-params / summary-info-params / active-cell-font-params / enable-tipwizard-params / + +vba-make-addin-params / insertdatatable-params / + +mail-send-mailer-params / autocorrect-params / post-document-params / view-show-params / view-define-params / + +view-delete-params / sheet-background-params / + +options-menono-params / rm-print-area-params / move-brk-params / hidecurr-note-params / + +hideall-notes-params / delete-note-params / traverse-notes-params / + +activate-notes-params / + +options-me-params / web-publish-params / newwebquery-params / + +pivot-table-chart-params / options-save-params / options-spell-params / + +hideall-inkannots-params + +#### CFParsedFormula + +The **CFParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccergce (variable)
...
+ +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg) structures for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), [PtgSxName](#ptgsxname), [PtgIsect](#ptgisect), [PtgUnion](#ptgunion), [PtgArray](#ptgarray), [PtgRef3d](#ptgref3d), [PtgArea3d](#ptgarea3d), [PtgRefErr3d](#ptgreferr3d), [PtgAreaErr3d](#ptgareaerr3d), [PtgNameX](#ptgnamex), [PtgMemArea](#ptgmemarea), or [PtgMemNoMem](#ptgmemnomem). A [PtgArea](#ptgarea) or a [PtgAreaN](#ptgarean) MUST NOT be the only Ptg structure in the sequence. + +The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +#### CFParsedFormulaNoCCE + +The **CFParsedFormulaNoCCE** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule, in a [CF](#cf) or [CF12](#cf12) record in which the size of the formula in bytes is specified. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgce (variable)
...
+ +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), [PtgSxName](#ptgsxname), [PtgIsect](#ptgisect), [PtgUnion](#ptgunion), [PtgArray](#ptgarray), [PtgRef3d](#ptgref3d), [PtgArea3d](#ptgarea3d), [PtgRefErr3d](#ptgreferr3d), [PtgAreaErr3d](#ptgareaerr3d), [PtgNameX](#ptgnamex), [PtgMemArea](#ptgmemarea), or [PtgMemNoMem](#ptgmemnomem). A [PtgArea](#ptgarea) or a [PtgAreaN](#ptgarean) MUST NOT be the only Ptg in the sequence. + +The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +#### CFVOParsedFormula + +The **CFVOParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) without [**relative references**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) that is used in a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccergce (variable)
...
+ +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), [PtgSxName](#ptgsxname), [PtgIsect](#ptgisect), [PtgUnion](#ptgunion), [PtgArray](#ptgarray), [PtgRef3d](#ptgref3d), [PtgArea3d](#ptgarea3d), [PtgRefErr3d](#ptgreferr3d), [PtgAreaErr3d](#ptgareaerr3d), [PtgNameX](#ptgnamex), [PtgMemArea](#ptgmemarea), or [PtgMemNoMem](#ptgmemnomem). A [PtgArea](#ptgarea) or a [PtgAreaN](#ptgarean) MUST NOT be the only Ptg in the sequence. + +If this field contains a [PtgRef](#ptgref), then the **loc.column.colRelative** and **loc.column.rowRelative** fields in the PtgRef MUST be 0. + +If this field contains a [PtgRefN](#ptgrefn), then the **loc.column.colRelative** and **loc.column.rowRelative** fields in the PtgRefN MUST be 0. + +If this field contains a PtgArea, then the **area.columnFirst.colRelative**, **area.columnFirst.rowRelative**, **area.columnLast.colRelative**, and **area.columnLast.rowRelative** fields in the PtgArea MUST be 0**.** + +If this field contains a PtgAreaN, then the **area.columnFirst.colRelative**, **area.columnFirst.rowRelative**, **area.columnLast.colRelative**, and **area.columnLast.rowRelative** fields in the PtgAreaN MUST be 0. + +The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +#### ChartParsedFormula + +The **ChartParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a chart. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccergce (variable)
...
+ +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST contain only the following Ptgs: [PtgParen](#ptgparen), [PtgUnion](#ptgunion), [PtgRef3d](#ptgref3d), [PtgRefErr3d](#ptgreferr3d), [PtgArea3d](#ptgarea3d), [PtgAreaErr3d](#ptgareaerr3d), [PtgNameX](#ptgnamex), or [PtgMemFunc](#ptgmemfunc). + +#### DVParsedFormula + +The **DVParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) rule. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cceunused
rgce (variable)
...
+ +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. + +**unused (2 bytes):** Undefined and MUST be ignored. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), [PtgSxName](#ptgsxname), [PtgIsect](#ptgisect), [PtgUnion](#ptgunion), [PtgArray](#ptgarray), [PtgRef3d](#ptgref3d), [PtgRefErr3d](#ptgreferr3d), [PtgNameX](#ptgnamex), [PtgMemArea](#ptgmemarea), or [PtgMemNoMem](#ptgmemnomem). + +If the [Dv](#dv) record that contains this **DVParsedFormula** in its Dv.**formula1** field has a Dv.**valType** not equal to 3, then the following MUST be true: + +- **rgce** MUST NOT contain a [PtgArea3d](#ptgarea3d) or a [PtgAreaErr3d](#ptgareaerr3d). + +- A [PtgArea](#ptgarea), a [PtgAreaErr](#ptgareaerr), or a [PtgAreaN](#ptgarean), MUST NOT be the only Ptg in **rgce**. + +- The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +If the Dv record that contains this **DVParsedFormula** in its Dv.**formula1** field has a Dv.**valType** equal to 3, then the following MUST be true: + +- If **rgce** contains a PtgArea3d or a PtgAreaErr3d then the PtgArea3d or PtgAreaErr3d MUST be the only Ptg in **rgce**. + +- The root node of the parse tree of this field MUST NOT be a VALUE_TYPE, as described in Rgce. + +If this **DVParsedFormula** is in Dv.**formula2** field, then the following MUST be true: + +- **rgce** MUST NOT contain a PtgArea3d or a PtgAreaErr3d. + +- A PtgArea, a PtgAreaErr, or a PtgAreaN, MUST NOT be the only Ptg in **rgce**. + +- The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +#### ExtNameParsedFormula + +The **ExtNameParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cbextPtg (optional)val (variable)
...
+ +**cb (2 bytes):** An unsigned integer that specifies the number of bytes in **extPtg** + the number of bytes in **val**. If the [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) that this external defined name specifies does not exist in its containing [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), this value MUST be 0, and **extPtg** and **val** MUST NOT exist. + +**extPtg (1 byte):** An unsigned integer that specifies the formula type of **val**. This field MUST exist if and only if **cb** is greater than 0. MUST be one of the values as specified in the table in the **val** field section. + +**val (variable):** An optional field that specifies the formula of an external defined name. If the formula cannot be represented correctly with one formula types allowed in this field, then this field MUST specify an [ExtPtgErr](#extptgerr) formula. This field MUST exist if and only if **cb** is greater than 0. The size and the type of the formula vary based on the value of **extPtg** as follows: + +| extPtg value | Val field Data and Meaning | +|--------------|-----------------------------------------------------------| +| 0x3A | Specifies an [ExtPtgRef3D](#extptgref3d) formula. | +| 0x3B | Specifies an [ExtPtgArea3D](#extptgarea3d) formula. | +| 0x3C | Specifies an [ExtPtgRefErr3D](#extptgreferr3d) formula. | +| 0x3D | Specifies an [ExtPtgAreaErr3D](#extptgareaerr3d) formula. | +| 0x1C | Specifies an ExtPtgErr formula. | + +#### ExtPtgArea3D + +The **ExtPtgArea3D** structure is a variation of [PtgArea3d](#ptgarea3d) that is used by formulas in an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2). It specifies a rectangular [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) range on one or more [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iTabs
area
...
+ +**iTabs (4 bytes):** An [ExtSheetPair](#extsheetpair) that specifies the sheet or sheets containing the range. + +**area (8 bytes):** A [RgceAreaRel](#rgcearearel) that specifies the location of the range of cells within a sheet. + +#### ExtPtgAreaErr3D + +The **ExtPtgAreaErr3D** structure is a variation of [PtgAreaErr3d](#ptgareaerr3d) that is used by formulas in an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2). It specifies an invalid reference to a regular range of cells on one or more [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iTabs
unused1
unused2
+ +**iTabs (4 bytes):** An [ExtSheetPair](#extsheetpair) that specifies the sheet or sheets containing the target of this reference. + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +#### ExtPtgErr + +The **ExtPtgErr** structure is a variation of [PtgErr](#ptgerr) that is used by formulas in an external defined name. It specifies an invalid [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) reference. + + ++++++++++ + + + + + + + + + + + + + + + + + +
01234567
err
+ +**err (1 byte):** A [BErr](#berr) that specifies the value of this error. The value MUST be 0x17. + +#### ExtPtgRef3D + +The **ExtPtgRef3D** structure is a variation of [PtgRef3d](#ptgref3d) that is used by formulas in an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2). It specifies the location of a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on one or more [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iTabs
loc
+ +**iTabs (4 bytes):** An [ExtSheetPair](#extsheetpair) that specifies the sheet or sheets containing the cell. + +**loc (4 bytes):** A [RgceLocRel](#rgcelocrel) that specifies the location of a cell within a sheet. + +#### ExtPtgRefErr3D + +The **ExtPtgRefErr3D** structure is a variation of [PtgRefErr3d](#ptgreferr3d) that is used by formulas in an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2). It specifies an invalid single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) reference on one or more [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iTabs
unused
+ +**iTabs (4 bytes):** An [ExtSheetPair](#extsheetpair) that specifies the sheet or sheets containing the target of this reference. + +**unused (4 bytes):** Undefined and MUST be ignored. + +#### ExtSheetPair + +The **ExtSheetPair** structure specifies a pair of [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the formulas of an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2). The sheets are in the [External Workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc) as specified by the preceding [SupBook](#supbook) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
itabFirstitabLast
+ +**itabFirst (2 bytes):** A signed integer that specifies the first sheet of a single or multi-sheet reference. It MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | Specifies that the first sheet of this reference could not be found. | +| \>=0 | This value specifies the zero-based index of an [XLUnicodeString](#xlunicodestring) in the **rgst** field of the preceding SupBook record. The XLUnicodeString specifies the name of the first referenced sheet within the supporting workbook. This value MUST be less than the value of the **ctab** field in the preceding SupBook record. | + +**itabLast (2 bytes):** A signed integer that specifies the last sheet of a single or multi-sheet reference. The value MUST be greater than or equal to **itabFirst** if it is not -1 and MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | Specifies that the last sheet of this reference could not be found. | +| \>=0 | This value specifies the zero-based index of an XLUnicodeString in the **rgst** field of the preceding SupBook record. The XLUnicodeString specifies the name of the last referenced sheet within the supporting workbook. This value MUST be less than the value of the **ctab** field in the preceding SupBook record. | + +#### Ftab + +The **Ftab** structure specifies a function which can be called from a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). The definition of each function specifies the function name and the valid sequence of arguments. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
iftab
+ +**iftab (2 bytes):** An unsigned integer that specifies the function to be called. MUST be a value from the following table: + +The elements [ref](#rgce) and val are specified in Rgce. + +| Value | Meaning | +|----|----| +| 0x0000 | COUNT | +| | count-params = (ref / val), \*29(ref / val) | +| 0x0001 | IF | +| | if-params = val, \*2(ref / val) | +| 0x0002 | ISNA | +| | isna-params = val | +| 0x0003 | ISERROR | +| | iserror-params = val | +| 0x0004 | SUM | +| | sum-params = (ref / val), \*29(ref / val) | +| 0x0005 | AVERAGE | +| | average-params = (ref / val), \*29(ref / val) | +| 0x0006 | MIN | +| | min-params = (ref / val), \*29(ref / val) | +| 0x0007 | MAX | +| | max-params = (ref / val), \*29(ref / val) | +| 0x0008 | ROW | +| | row-params = \[ref\] | +| 0x0009 | COLUMN | +| | column-params = \[ref\] | +| 0x000A | NA | +| | This function takes no parameters | +| 0x000B | NPV | +| | npv-params = val, (ref / val), \*28(ref / val) | +| 0x000C | STDEV | +| | stdev-params = (ref / val), \*29(ref / val) | +| 0x000D | DOLLAR | +| | dollar-params = val, \[val\] | +| 0x000E | FIXED | +| | fixed-params = val, \[val, \[val\]\] | +| 0x000F | SIN | +| | sin-params = val | +| 0x0010 | COS | +| | cos-params = val | +| 0x0011 | TAN | +| | tan-params = val | +| 0x0012 | ATAN | +| | atan-params = val | +| 0x0013 | PI | +| | This function takes no parameters | +| 0x0014 | SQRT | +| | sqrt-params = val | +| 0x0015 | EXP | +| | exp-params = val | +| 0x0016 | LN | +| | ln-params = val | +| 0x0017 | LOG10 | +| | log10-params = val | +| 0x0018 | ABS | +| | abs-params = val | +| 0x0019 | INT | +| | int-params = val | +| 0x001A | SIGN | +| | sign-params = val | +| 0x001B | ROUND | +| | round-params = val, val | +| 0x001C | LOOKUP | +| | lookup-params = val, (ref / val), \[ref / val\] | +| 0x001D | INDEX | +| | index-params = (ref / val), val, \*2(val) | +| 0x001E | REPT | +| | rept-params = val, val | +| 0x001F | MID | +| | mid-params = val, val, val | +| 0x0020 | LEN | +| | len-params = val | +| 0x0021 | VALUE | +| | value-params = val | +| 0x0022 | TRUE | +| | This function takes no parameters | +| 0x0023 | FALSE | +| | This function takes no parameters | +| 0x0024 | AND | +| | and-params = (ref / val), \*29(ref / val) | +| 0x0025 | OR | +| | or-params = (ref / val), \*29(ref / val) | +| 0x0026 | NOT | +| | not-params = val | +| 0x0027 | MOD | +| | mod-params = val, val | +| 0x0028 | DCOUNT | +| | dcount-params = ref, (ref / val), (ref / val) | +| 0x0029 | DSUM | +| | dsum-params = ref, (ref / val), (ref / val) | +| 0x002A | DAVERAGE | +| | daverage-params = ref, (ref / val), (ref / val) | +| 0x002B | DMIN | +| | dmin-params = ref, (ref / val), (ref / val) | +| 0x002C | DMAX | +| | dmax-params = ref, (ref / val), (ref / val) | +| 0x002D | DSTDEV | +| | dstdev-params = ref, (ref / val), (ref / val) | +| 0x002E | VAR | +| | var-params = (ref / val), \*29(ref / val) | +| 0x002F | DVAR | +| | dvar-params = ref, (ref / val), (ref / val) | +| 0x0030 | TEXT | +| | text-params = val, val | +| 0x0031 | LINEST | +| | linest-params = (ref / val), \[(ref / val), \*2(ref / val)\] | +| 0x0032 | TREND | +| | trend-params = (ref / val), \[(ref / val), \[(ref / val), \[ref / val\]\]\] | +| 0x0033 | LOGEST | +| | logest-params = (ref / val), \[(ref / val), \*2(ref / val)\] | +| 0x0034 | GROWTH | +| | growth-params = (ref / val), \[(ref / val), \[(ref / val), \[ref / val\]\]\] | +| 0x0035 | GOTO | +| | goto-params = ref | +| 0x0036 | HALT | +| | halt-params = \[val\] | +| 0x0037 | RETURN | +| | return-params = \[ref / val\] | +| 0x0038 | PV | +| | pv-params = val, val, val, \*2(val) | +| 0x0039 | FV | +| | fv-params = val, val, val, \*2(val) | +| 0x003A | NPER | +| | nper-params = val, val, val, \*2(val) | +| 0x003B | PMT | +| | pmt-params = val, val, val, \*2(val) | +| 0x003C | RATE | +| | rate-params = val, val, val, \*3(val) | +| 0x003D | MIRR | +| | mirr-params = (ref / val), val, val | +| 0x003E | IRR | +| | irr-params = (ref / val), \[val\] | +| 0x003F | RAND | +| | This function takes no parameters | +| 0x0040 | MATCH | +| | match-params = val, (ref / val), \[ref / val\] | +| 0x0041 | DATE | +| | date-params = val, val, val | +| 0x0042 | TIME | +| | time-params = val, val, val | +| 0x0043 | DAY | +| | day-params = val | +| 0x0044 | MONTH | +| | month-params = val | +| 0x0045 | YEAR | +| | year-params = val | +| 0x0046 | WEEKDAY | +| | weekday-params = val, \[val\] | +| 0x0047 | HOUR | +| | hour-params = val | +| 0x0048 | MINUTE | +| | minute-params = val | +| 0x0049 | SECOND | +| | second-params = val | +| 0x004A | NOW | +| | This function takes no parameters | +| 0x004B | AREAS | +| | areas-params = ref | +| 0x004C | ROWS | +| | rows-params = (ref / val) | +| 0x004D | COLUMNS | +| | columns-params = (ref / val) | +| 0x004E | OFFSET | +| | offset-params = ref, val, val, \*2(val) | +| 0x004F | ABSREF | +| | absref-params = val, ref | +| 0x0050 | RELREF | +| | relref-params = ref, ref | +| 0x0051 | ARGUMENT | +| | argument-params = \[val, \[(ref / val), \[ref\]\]\] | +| 0x0052 | SEARCH | +| | search-params = val, val, \[val\] | +| 0x0053 | TRANSPOSE | +| | transpose-params = val | +| 0x0054 | ERROR | +| | error-params = \[val, \[ref / val\]\] | +| 0x0055 | STEP | +| | This function takes no parameters | +| 0x0056 | TYPE | +| | type-params = val | +| 0x0057 | ECHO | +| | echo-params = \[val\] | +| 0x0058 | SET.NAME | +| | set-name-params = val, \[ref / val\] | +| 0x0059 | CALLER | +| | This function takes no parameters | +| 0x005A | DEREF | +| | deref-params = ref | +| 0x005B | WINDOWS | +| | windows-params = \[val, \[val\]\] | +| 0x005C | SERIES | +| | series-params = (ref / val), (ref / val), (ref / val), val, \[ref / val\] | +| 0x005D | DOCUMENTS | +| | documents-params = \[val, \[val\]\] | +| 0x005E | ACTIVE.CELL | +| | This function takes no parameters | +| 0x005F | SELECTION | +| | This function takes no parameters | +| 0x0060 | RESULT | +| | result-params = \[val\] | +| 0x0061 | ATAN2 | +| | atan2-params = val, val | +| 0x0062 | ASIN | +| | asin-params = val | +| 0x0063 | ACOS | +| | acos-params = val | +| 0x0064 | CHOOSE | +| | choose-params = val, (ref / val), \*28(ref / val) | +| 0x0065 | HLOOKUP | +| | hlookup-params = val, (ref / val), (ref / val), \[val\] | +| 0x0066 | VLOOKUP | +| | vlookup-params = val, (ref / val), (ref / val), \[val\] | +| 0x0067 | LINKS | +| | links-params = \[val, \[val\]\] | +| 0x0068 | INPUT | +| | input-params = val, \[val, \[val, \[val, \[val, \[val, \[val\]\]\]\]\]\] | +| 0x0069 | ISREF | +| | isref-params = (ref / val) | +| 0x006A | GET.FORMULA | +| | get-formula-params = (ref / val) | +| 0x006B | GET.NAME | +| | get-name-params = val, \[val\] | +| 0x006C | SET.VALUE | +| | set-value-params = ref, val | +| 0x006D | LOG | +| | log-params = val, \[val\] | +| 0x006E | EXEC | +| | exec-params = val, \[val, \*2(val)\] | +| 0x006F | CHAR | +| | char-params = val | +| 0x0070 | LOWER | +| | lower-params = val | +| 0x0071 | UPPER | +| | upper-params = val | +| 0x0072 | PROPER | +| | proper-params = val | +| 0x0073 | LEFT | +| | left-params = val, \[val\] | +| 0x0074 | RIGHT | +| | right-params = val, \[val\] | +| 0x0075 | EXACT | +| | exact-params = val, val | +| 0x0076 | TRIM | +| | trim-params = val | +| 0x0077 | REPLACE | +| | replace-params = val, val, val, val | +| 0x0078 | SUBSTITUTE | +| | substitute-params = val, val, val, \[val\] | +| 0x0079 | CODE | +| | code-params = val | +| 0x007A | NAMES | +| | names-params = \[val, \[val, \[val\]\]\] | +| 0x007B | DIRECTORY | +| | directory-params = \[val\] | +| 0x007C | FIND | +| | find-params = val, val, \[val\] | +| 0x007D | CELL | +| | cell-params = val, \[ref\] | +| 0x007E | ISERR | +| | iserr-params = val | +| 0x007F | ISTEXT | +| | istext-params = val | +| 0x0080 | ISNUMBER | +| | isnumber-params = val | +| 0x0081 | ISBLANK | +| | isblank-params = val | +| 0x0082 | T | +| | t-params = (ref / val) | +| 0x0083 | N | +| | n-params = (ref / val) | +| 0x0084 | FOPEN | +| | fopen-params = val, \[val\] | +| 0x0085 | FCLOSE | +| | fclose-params = val | +| 0x0086 | FSIZE | +| | fsize-params = val | +| 0x0087 | FREADLN | +| | freadln-params = val | +| 0x0088 | FREAD | +| | fread-params = val, val | +| 0x0089 | FWRITELN | +| | fwriteln-params = val, val | +| 0x008A | FWRITE | +| | fwrite-params = val, val | +| 0x008B | FPOS | +| | fpos-params = val, \[val\] | +| 0x008C | DATEVALUE | +| | datevalue-params = val | +| 0x008D | TIMEVALUE | +| | timevalue-params = val | +| 0x008E | SLN | +| | sln-params = val, val, val | +| 0x008F | SYD | +| | syd-params = val, val, val, val | +| 0x0090 | DDB | +| | ddb-params = val, val, val, val, \[val\] | +| 0x0091 | GET.DEF | +| | get-def-params = val, \[val, \[val\]\] | +| 0x0092 | REFTEXT | +| | reftext-params = ref, \[val\] | +| 0x0093 | TEXTREF | +| | textref-params = val, \[val\] | +| 0x0094 | INDIRECT | +| | indirect-params = val, \[val\] | +| 0x0095 | REGISTER | +| | register-params = val, \[val, \[val, \[val, \[val, \[val, \[val, \[val, \[val, \[val, \*20(val)\]\]\]\]\]\]\]\]\] | +| 0x0096 | CALL | +| | call-params = val, \[(ref / val), \*28(ref / val)\] | +| 0x0097 | ADD.BAR | +| | add-bar-params = \[val\] | +| 0x0098 | ADD.MENU | +| | add-menu-params = val, (ref / val), \[(ref / val), \[val\]\] | +| 0x0099 | ADD.COMMAND | +| | add-command-params = val, (ref / val), (ref / val), \[(ref / val), \[val\]\] | +| 0x009A | ENABLE.COMMAND | +| | enable-command-params = val, val, val, val, \[val\] | +| 0x009B | CHECK.COMMAND | +| | check-command-params = val, val, val, val, \[val\] | +| 0x009C | RENAME.COMMAND | +| | rename-command-params = val, val, val, val, \[val\] | +| 0x009D | SHOW.BAR | +| | show-bar-params = \[val\] | +| 0x009E | DELETE.MENU | +| | delete-menu-params = val, val, \[val\] | +| 0x009F | DELETE.COMMAND | +| | delete-command-params = val, val, val, \[val\] | +| 0x00A0 | GET.CHART.ITEM | +| | get-chart-item-params = val, \[val, \[val\]\] | +| 0x00A1 | DIALOG.BOX | +| | dialog-box-params = (ref / val) | +| 0x00A2 | CLEAN | +| | clean-params = val | +| 0x00A3 | MDETERM | +| | mdeterm-params = val | +| 0x00A4 | MINVERSE | +| | minverse-params = val | +| 0x00A5 | MMULT | +| | mmult-params = val, val | +| 0x00A6 | FILES | +| | files-params = \*2(val) | +| 0x00A7 | IPMT | +| | ipmt-params = val, val, val, val, \*2(val) | +| 0x00A8 | PPMT | +| | ppmt-params = val, val, val, val, \*2(val) | +| 0x00A9 | COUNTA | +| | counta-params = (ref / val), \*29(ref / val) | +| 0x00AA | CANCEL.KEY | +| | cancel-key-params = \[val, \[ref\]\] | +| 0x00AB | FOR | +| | for-params = val, val, val, \[val\] | +| 0x00AC | WHILE | +| | while-params = val | +| 0x00AD | BREAK | +| | This function takes no parameters | +| 0x00AE | NEXT | +| | This function takes no parameters | +| 0x00AF | INITIATE | +| | initiate-params = val, val | +| 0x00B0 | REQUEST | +| | request-params = val, val | +| 0x00B1 | POKE | +| | poke-params = val, (ref / val), (ref / val) | +| 0x00B2 | EXECUTE | +| | execute-params = val, val | +| 0x00B3 | TERMINATE | +| | terminate-params = val | +| 0x00B4 | RESTART | +| | restart-params = \[val\] | +| 0x00B5 | HELP | +| | help-params = \[val\] | +| 0x00B6 | GET.BAR | +| | get-bar-params = \*4(val) | +| 0x00B7 | PRODUCT | +| | product-params = (ref / val), \*29(ref / val) | +| 0x00B8 | FACT | +| | fact-params = val | +| 0x00B9 | GET.CELL | +| | get-cell-params = val, \[ref\] | +| 0x00BA | GET.WORKSPACE | +| | get-workspace-params = val | +| 0x00BB | GET.WINDOW | +| | get-window-params = val, \[val\] | +| 0x00BC | GET.DOCUMENT | +| | get-document-params = val, \[val\] | +| 0x00BD | DPRODUCT | +| | dproduct-params = ref, (ref / val), (ref / val) | +| 0x00BE | ISNONTEXT | +| | isnontext-params = val | +| 0x00BF | GET.NOTE | +| | get-note-params = \[(ref / val), \*2(val)\] | +| 0x00C0 | NOTE | +| | note-params = \[val, \[(ref / val), \*2(ref / val)\]\] | +| 0x00C1 | STDEVP | +| | stdevp-params = (ref / val), \*29(ref / val) | +| 0x00C2 | VARP | +| | varp-params = (ref / val), \*29(ref / val) | +| 0x00C3 | DSTDEVP | +| | dstdevp-params = ref, (ref / val), (ref / val) | +| 0x00C4 | DVARP | +| | dvarp-params = ref, (ref / val), (ref / val) | +| 0x00C5 | TRUNC | +| | trunc-params = val, \[val\] | +| 0x00C6 | ISLOGICAL | +| | islogical-params = val | +| 0x00C7 | DCOUNTA | +| | dcounta-params = ref, (ref / val), (ref / val) | +| 0x00C8 | DELETE.BAR | +| | delete-bar-params = val | +| 0x00C9 | UNREGISTER | +| | unregister-params = val | +| 0x00CC | USDOLLAR | +| | usdollar-params = val, \[val\] | +| 0x00CD | FINDB | +| | findb-params = val, val, \[val\] | +| 0x00CE | SEARCHB | +| | searchb-params = val, val, \[val\] | +| 0x00CF | REPLACEB | +| | replaceb-params = val, val, val, val | +| 0x00D0 | LEFTB | +| | leftb-params = val, \[val\] | +| 0x00D1 | RIGHTB | +| | rightb-params = val, \[val\] | +| 0x00D2 | MIDB | +| | midb-params = val, val, val | +| 0x00D3 | LENB | +| | lenb-params = val | +| 0x00D4 | ROUNDUP | +| | roundup-params = val, val | +| 0x00D5 | ROUNDDOWN | +| | rounddown-params = val, val | +| 0x00D6 | ASC | +| | asc-params = val | +| 0x00D7 | DBCS | +| | dbcs-params = val | +| 0x00D8 | RANK | +| | rank-params = val, ref, \[val\] | +| 0x00DB | ADDRESS | +| | address-params = val, val, \[val, \[val, \[val\]\]\] | +| 0x00DC | DAYS360 | +| | days360-params = val, val, \[val\] | +| 0x00DD | TODAY | +| | This function takes no parameters | +| 0x00DE | VDB | +| | vdb-params = val, val, val, val, val, \[val, \[val\]\] | +| 0x00DF | ELSE | +| | This function takes no parameters | +| 0x00E0 | ELSE.IF | +| | else-if-params = val | +| 0x00E1 | END.IF | +| | This function takes no parameters | +| 0x00E2 | FOR.CELL | +| | for-cell-params = val, \[(ref / val), \[ref / val\]\] | +| 0x00E3 | MEDIAN | +| | median-params = (ref / val), \*29(ref / val) | +| 0x00E4 | SUMPRODUCT | +| | sumproduct-params = val, \*29(val) | +| 0x00E5 | SINH | +| | sinh-params = val | +| 0x00E6 | COSH | +| | cosh-params = val | +| 0x00E7 | TANH | +| | tanh-params = val | +| 0x00E8 | ASINH | +| | asinh-params = val | +| 0x00E9 | ACOSH | +| | acosh-params = val | +| 0x00EA | ATANH | +| | atanh-params = val | +| 0x00EB | DGET | +| | dget-params = ref, (ref / val), (ref / val) | +| 0x00EC | CREATE.OBJECT | +| | create-object-params = val, (ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[ref / val\]\]\]\]\]\]\]\]\] | +| 0x00ED | VOLATILE | +| | volatile-params = \[val\] | +| 0x00EE | LAST.ERROR | +| | This function takes no parameters | +| 0x00EF | CUSTOM.UNDO | +| | custom-undo-params = \*2(val) | +| 0x00F0 | CUSTOM.REPEAT | +| | custom-repeat-params = \*3(val) | +| 0x00F1 | FORMULA.CONVERT | +| | formula-convert-params = val, (ref / val), \*3(ref / val) | +| 0x00F2 | GET.LINK.INFO | +| | get-link-info-params = val, val, \[val, \[val\]\] | +| 0x00F3 | TEXT.BOX | +| | text-box-params = val, \[val, \*2(val)\] | +| 0x00F4 | INFO | +| | info-params = val | +| 0x00F5 | GROUP | +| | This function takes no parameters | +| 0x00F6 | GET.OBJECT | +| | get-object-params = val, \[val, \*3(val)\] | +| 0x00F7 | DB | +| | db-params = val, val, val, val, \[val\] | +| 0x00F8 | PAUSE | +| | pause-params = \[val\] | +| 0x00FB | RESUME | +| | resume-params = \[val\] | +| 0x00FC | FREQUENCY | +| | frequency-params = (ref / val), (ref / val) | +| 0x00FD | ADD.TOOLBAR | +| | add-toolbar-params = \[val, \[val\]\] | +| 0x00FE | DELETE.TOOLBAR | +| | delete-toolbar-params = val | +| 0x00FF | User Defined Function | +| | user-defined-function-params = (ref / val), \[(ref / val), \*28(ref / val)\] | +| 0x0100 | RESET.TOOLBAR | +| | reset-toolbar-params = val | +| 0x0101 | EVALUATE | +| | evaluate-params = val | +| 0x0102 | GET.TOOLBAR | +| | get-toolbar-params = val, \[val\] | +| 0x0103 | GET.TOOL | +| | get-tool-params = val, \[val, \[val\]\] | +| 0x0104 | SPELLING.CHECK | +| | spelling-check-params = val, \[val, \[val\]\] | +| 0x0105 | ERROR.TYPE | +| | error-type-params = val | +| 0x0106 | APP.TITLE | +| | app-title-params = \[val\] | +| 0x0107 | WINDOW.TITLE | +| | window-title-params = \[val\] | +| 0x0108 | SAVE.TOOLBAR | +| | save-toolbar-params = \[val, \[val\]\] | +| 0x0109 | ENABLE.TOOL | +| | enable-tool-params = val, val, val | +| 0x010A | PRESS.TOOL | +| | press-tool-params = val, val, val | +| 0x010B | REGISTER.ID | +| | register-id-params = val, val, \[val\] | +| 0x010C | GET.WORKBOOK | +| | get-workbook-params = val, \[val\] | +| 0x010D | AVEDEV | +| | avedev-params = (ref / val), \*29(ref / val) | +| 0x010E | BETADIST | +| | betadist-params = val, val, val, \*2(val) | +| 0x010F | GAMMALN | +| | gammaln-params = val | +| 0x0110 | BETAINV | +| | betainv-params = val, val, val, \*2(val) | +| 0x0111 | BINOMDIST | +| | binomdist-params = val, val, val, val | +| 0x0112 | CHIDIST | +| | chidist-params = val, val | +| 0x0113 | CHIINV | +| | chiinv-params = val, val | +| 0x0114 | COMBIN | +| | combin-params = val, val | +| 0x0115 | CONFIDENCE | +| | confidence-params = val, val, val | +| 0x0116 | CRITBINOM | +| | critbinom-params = val, val, val | +| 0x0117 | EVEN | +| | even-params = val | +| 0x0118 | EXPONDIST | +| | expondist-params = val, val, val | +| 0x0119 | FDIST | +| | fdist-params = val, val, val | +| 0x011A | FINV | +| | finv-params = val, val, val | +| 0x011B | FISHER | +| | fisher-params = val | +| 0x011C | FISHERINV | +| | fisherinv-params = val | +| 0x011D | FLOOR | +| | floor-params = val, val | +| 0x011E | GAMMADIST | +| | gammadist-params = val, val, val, val | +| 0x011F | GAMMAINV | +| | gammainv-params = val, val, val | +| 0x0120 | CEILING | +| | ceiling-params = val, val | +| 0x0121 | HYPGEOMDIST | +| | hypgeomdist-params = val, val, val, val | +| 0x0122 | LOGNORMDIST | +| | lognormdist-params = val, val, val | +| 0x0123 | LOGINV | +| | loginv-params = val, val, val | +| 0x0124 | NEGBINOMDIST | +| | negbinomdist-params = val, val, val | +| 0x0125 | NORMDIST | +| | normdist-params = val, val, val, val | +| 0x0126 | NORMSDIST | +| | normsdist-params = val | +| 0x0127 | NORMINV | +| | norminv-params = val, val, val | +| 0x0128 | NORMSINV | +| | normsinv-params = val | +| 0x0129 | STANDARDIZE | +| | standardize-params = val, val, val | +| 0x012A | ODD | +| | odd-params = val | +| 0x012B | PERMUT | +| | permut-params = val, val | +| 0x012C | POISSON | +| | poisson-params = val, val, val | +| 0x012D | TDIST | +| | tdist-params = val, val, val | +| 0x012E | WEIBULL | +| | weibull-params = val, val, val, val | +| 0x012F | SUMXMY2 | +| | sumxmy2-params = val, val | +| 0x0130 | SUMX2MY2 | +| | sumx2my2-params = val, val | +| 0x0131 | SUMX2PY2 | +| | sumx2py2-params = val, val | +| 0x0132 | CHITEST | +| | chitest-params = val, val | +| 0x0133 | CORREL | +| | correl-params = val, val | +| 0x0134 | COVAR | +| | covar-params = val, val | +| 0x0135 | FORECAST | +| | forecast-params = val, val, val | +| 0x0136 | FTEST | +| | ftest-params = val, val | +| 0x0137 | INTERCEPT | +| | intercept-params = val, val | +| 0x0138 | PEARSON | +| | pearson-params = val, val | +| 0x0139 | RSQ | +| | rsq-params = val, val | +| 0x013A | STEYX | +| | steyx-params = val, val | +| 0x013B | SLOPE | +| | slope-params = val, val | +| 0x013C | TTEST | +| | ttest-params = val, val, val, val | +| 0x013D | PROB | +| | prob-params = val, val, val, \[val\] | +| 0x013E | DEVSQ | +| | devsq-params = (ref / val), \*29(ref / val) | +| 0x013F | GEOMEAN | +| | geomean-params = (ref / val), \*29(ref / val) | +| 0x0140 | HARMEAN | +| | harmean-params = (ref / val), \*29(ref / val) | +| 0x0141 | SUMSQ | +| | sumsq-params = (ref / val), \*29(ref / val) | +| 0x0142 | KURT | +| | kurt-params = (ref / val), \*29(ref / val) | +| 0x0143 | SKEW | +| | skew-params = (ref / val), \*29(ref / val) | +| 0x0144 | ZTEST | +| | ztest-params = (ref / val), val, \[val\] | +| 0x0145 | LARGE | +| | large-params = (ref / val), val | +| 0x0146 | SMALL | +| | small-params = (ref / val), val | +| 0x0147 | QUARTILE | +| | quartile-params = (ref / val), val | +| 0x0148 | PERCENTILE | +| | percentile-params = (ref / val), val | +| 0x0149 | PERCENTRANK | +| | percentrank-params = (ref / val), val, \[val\] | +| 0x014A | MODE | +| | mode-params = val, \*29(val) | +| 0x014B | TRIMMEAN | +| | trimmean-params = (ref / val), val | +| 0x014C | TINV | +| | tinv-params = val, val | +| 0x014E | MOVIE.COMMAND | +| | movie-command-params = val, val, val, \[val\] | +| 0x014F | GET.MOVIE | +| | get-movie-params = val, val, \[val\] | +| 0x0150 | CONCATENATE | +| | concatenate-params = val, \*29(val) | +| 0x0151 | POWER | +| | power-params = val, val | +| 0x0152 | PIVOT.ADD.DATA | +| | pivot-add-data-params = val, val, \[val, \[val, \[val, \[val, \*3(val)\]\]\]\] | +| 0x0153 | GET.PIVOT.TABLE | +| | get-pivot-table-params = val, \[val\] | +| 0x0154 | GET.PIVOT.FIELD | +| | get-pivot-field-params = val, \[val, \[val\]\] | +| 0x0155 | GET.PIVOT.ITEM | +| | get-pivot-item-params = val, \[val, \[val, \[val\]\]\] | +| 0x0156 | RADIANS | +| | radians-params = val | +| 0x0157 | DEGREES | +| | degrees-params = val | +| 0x0158 | SUBTOTAL | +| | subtotal-params = val, ref, \*28(ref) | +| 0x0159 | SUMIF | +| | sumif-params = ref, val, \[ref\] | +| 0x015A | COUNTIF | +| | countif-params = ref, val | +| 0x015B | COUNTBLANK | +| | countblank-params = ref | +| 0x015C | SCENARIO.GET | +| | scenario-get-params = val, \[val\] | +| 0x015D | OPTIONS.LISTS.GET | +| | options-lists-get-params = val | +| 0x015E | ISPMT | +| | ispmt-params = val, val, val, val | +| 0x015F | DATEDIF | +| | datedif-params = val, val, val | +| 0x0160 | DATESTRING | +| | datestring-params = val | +| 0x0161 | NUMBERSTRING | +| | numberstring-params = val, val | +| 0x0162 | ROMAN | +| | roman-params = val, \[val\] | +| 0x0163 | OPEN.DIALOG | +| | open-dialog-params = \[val, \[val, \[val, \[val\]\]\]\] | +| 0x0164 | SAVE.DIALOG | +| | save-dialog-params = \[val, \[val, \[val, \[val, \[val\]\]\]\]\] | +| 0x0165 | VIEW.GET | +| | view-get-params = val, \[val\] | +| 0x0166 | GETPIVOTDATA | +| | getpivotdata-params = (ref / val), (ref / val), \[val, \[val, \*13(val, val)\]\] | +| 0x0167 | HYPERLINK | +| | hyperlink-params = val, \[val\] | +| 0x0168 | PHONETIC | +| | phonetic-params = ref | +| 0x0169 | AVERAGEA | +| | averagea-params = (ref / val), \*29(ref / val) | +| 0x016A | MAXA | +| | maxa-params = (ref / val), \*29(ref / val) | +| 0x016B | MINA | +| | mina-params = (ref / val), \*29(ref / val) | +| 0x016C | STDEVPA | +| | stdevpa-params = (ref / val), \*29(ref / val) | +| 0x016D | VARPA | +| | varpa-params = (ref / val), \*29(ref / val) | +| 0x016E | STDEVA | +| | stdeva-params = (ref / val), \*29(ref / val) | +| 0x016F | VARA | +| | vara-params = (ref / val), \*29(ref / val) | +| 0x0170 | BAHTTEXT | +| | bahttext-params = val | +| 0x0171 | THAIDAYOFWEEK | +| | thaidayofweek-params = val | +| 0x0172 | THAIDIGIT | +| | thaidigit-params = val | +| 0x0173 | THAIMONTHOFYEAR | +| | thaimonthofyear-params = val | +| 0x0174 | THAINUMSOUND | +| | thainumsound-params = val | +| 0x0175 | THAINUMSTRING | +| | thainumstring-params = val | +| 0x0176 | THAISTRINGLENGTH | +| | thaistringlength-params = val | +| 0x0177 | ISTHAIDIGIT | +| | isthaidigit-params = val | +| 0x0178 | ROUNDBAHTDOWN | +| | roundbahtdown-params = val | +| 0x0179 | ROUNDBAHTUP | +| | roundbahtup-params = val | +| 0x017A | THAIYEAR | +| | thaiyear-params = val | +| 0x017B | RTD | +| | rtd-params = val, val, val, \*27(val) | + +The following grammar is used in the Rgce structure definition: + +params-fixed = isna-params / iserror-params / + +sin-params / cos-params / tan-params / + +atan-params / sqrt-params / + +exp-params / ln-params / log10-params / + +abs-params / int-params / sign-params / + +round-params / rept-params / mid-params / + +len-params / value-params / not-params / mod-params / + +dcount-params / dsum-params / daverage-params / + +dmin-params / dmax-params / dstdev-params / + +dvar-params / text-params / goto-params / + +mirr-params / date-params / + +time-params / day-params / month-params / + +year-params / hour-params / minute-params / + +second-params / areas-params / + +rows-params / columns-params / absref-params / + +relref-params / transpose-params / + +type-params / deref-params / atan2-params / + +asin-params / acos-params / isref-params / + +get-formula-params / set-value-params / char-params / + +lower-params / upper-params / proper-params / + +exact-params / trim-params / replace-params / + +code-params / iserr-params / istext-params / + +isnumber-params / isblank-params / t-params / + +n-params / fclose-params / fsize-params / + +freadln-params / fread-params / fwriteln-params / + +fwrite-params / datevalue-params / timevalue-params / + +sln-params / syd-params / dialog-box-params / + +clean-params / mdeterm-params / minverse-params / + +mmult-params / while-params / initiate-params / request-params / + +poke-params / execute-params / terminate-params / + +fact-params / get-workspace-params / dproduct-params / + +isnontext-params / dstdevp-params / dvarp-params / + +islogical-params / dcounta-params / delete-bar-params / + +unregister-params / replaceb-params / midb-params / + +lenb-params / roundup-params / rounddown-params / + +asc-params / dbcs-params / else-if-params / + +sinh-params / cosh-params / tanh-params / + +asinh-params / acosh-params / atanh-params / + +dget-params / info-params / frequency-params / delete-toolbar-params / + +reset-toolbar-params / evaluate-params / error-type-params / + +enable-tool-params / press-tool-params / gammaln-params / + +binomdist-params / chidist-params / chiinv-params / + +combin-params / confidence-params / critbinom-params / + +even-params / expondist-params / fdist-params / + +finv-params / fisher-params / fisherinv-params / + +floor-params / gammadist-params / gammainv-params / + +ceiling-params / hypgeomdist-params / lognormdist-params / + +loginv-params / negbinomdist-params / normdist-params / + +normsdist-params / norminv-params / normsinv-params / + +standardize-params / odd-params / permut-params / + +poisson-params / tdist-params / weibull-params / + +sumxmy2-params / sumx2my2-params / sumx2py2-params / + +chitest-params / correl-params / covar-params / + +forecast-params / ftest-params / intercept-params / + +pearson-params / rsq-params / steyx-params / + +slope-params / ttest-params / large-params / + +small-params / quartile-params / percentile-params / + +trimmean-params / tinv-params / power-params / + +radians-params / degrees-params / countif-params / + +countblank-params / options-lists-get-params / ispmt-params / + +datedif-params / datestring-params / numberstring-params / + +phonetic-params / bahttext-params / thaidayofweek-params / + +thaidigit-params / thaimonthofyear-params / thainumsound-params / + +thainumstring-params / thaistringlength-params / isthaidigit-params / + +roundbahtdown-params / roundbahtup-params / thaiyear-params + +params-variable = count-params / if-params / sum-params / + +average-params / min-params / max-params / + +row-params / column-params / npv-params / + +stdev-params / dollar-params / fixed-params / + +lookup-params / index-params / and-params / + +or-params / var-params / linest-params / + +trend-params / logest-params / growth-params / + +halt-params / return-params / pv-params / + +fv-params / nper-params / pmt-params / + +rate-params / irr-params / match-params / + +weekday-params / offset-params / argument-params / + +search-params / error-params / echo-params / + +set-name-params / windows-params / series-params / + +documents-params / result-params / choose-params / + +hlookup-params / vlookup-params / links-params / + +input-params / get-name-params / log-params / + +exec-params / left-params / right-params / + +substitute-params / names-params / directory-params / + +find-params / cell-params / fopen-params / + +fpos-params / ddb-params / get-def-params / + +reftext-params / textref-params / indirect-params / + +register-params / call-params / add-bar-params / + +add-menu-params / add-command-params / enable-command-params / + +check-command-params / rename-command-params / show-bar-params / + +delete-menu-params / delete-command-params / get-chart-item-params / + +files-params / ipmt-params / ppmt-params / + +counta-params / cancel-key-params / for-params / + +restart-params / help-params / get-bar-params / + +product-params / get-cell-params / get-window-params / + +get-document-params / get-note-params / note-params / + +stdevp-params / varp-params / trunc-params / + +usdollar-params / findb-params / searchb-params / + +leftb-params / rightb-params / rank-params / + +address-params / days360-params / vdb-params / + +for-cell-params / median-params / sumproduct-params / + +create-object-params / volatile-params / custom-undo-params / + +custom-repeat-params / formula-convert-params / get-link-info-params / + +text-box-params / get-object-params / db-params / + +pause-params / resume-params / add-toolbar-params / + +user-defined-function-params / get-toolbar-params / get-tool-params / + +spelling-check-params / app-title-params / window-title-params / + +save-toolbar-params / register-id-params / get-workbook-params / + +avedev-params / betadist-params / betainv-params / + +prob-params / devsq-params / geomean-params / + +harmean-params / sumsq-params / kurt-params / + +skew-params / ztest-params / percentrank-params / + +mode-params / movie-command-params / get-movie-params / + +concatenate-params / pivot-add-data-params / get-pivot-table-params / + +get-pivot-field-params / get-pivot-item-params / subtotal-params / + +sumif-params / scenario-get-params / roman-params / + +open-dialog-params / save-dialog-params / view-get-params / + +getpivotdata-params / hyperlink-params / averagea-params / + +maxa-params / mina-params / stdevpa-params / + +varpa-params / stdeva-params / vara-params / + +rtd-params + +#### Ilel + +The **Ilel** structure specifies a deleted label in use by a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b).[\<176\>](#Appendix_A_176) + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ilel
+ +**ilel (2 bytes):** An unsigned integer used to calculate the index into the collection of [Lel](#lel) records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The referenced Lel specifies the deleted label in use. MUST be a value from the following table. + +| Value | Meaning | +|----|----| +| 0 | Invalid index. The number of deleted labels is greater than 2047, the maximum size of the array of deleted labels. | +| 1 | Invalid index. | +| Greater than 1 and less than or equal to 2048 | The one-based index plus 1 of the Lel record. | + +#### ListParsedArrayFormula + +The **ListParsedArrayFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccergce (variable)
...
rgcb (variable)
...
+ +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), or [PtgSxName](#ptgsxname). + +**rgcb (variable):** An [RgbExtra](#rgbextra) that specifies ancillary data for the formula. + +#### ListParsedFormula + +The **ListParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccergce (variable)
...
+ +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), or [PtgSxName](#ptgsxname). + +#### NameParsedFormula + +The **NameParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgce (variable)
...
rgcb (variable)
...
+ +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), [PtgSxName](#ptgsxname), [PtgRef](#ptgref), [PtgRefN](#ptgrefn), [PtgRefErr](#ptgreferr), [PtgArea](#ptgarea), [PtgAreaN](#ptgarean), or [PtgAreaErr](#ptgareaerr). The size of **rgce** in bytes is specified by the **cce** field of the [Lbl](#lbl) record. + +**rgcb (variable):** An [RgbExtra](#rgbextra) that specifies ancillary data for the formula. + +#### ObjectParsedFormula + +The **ObjectParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used by an [**embedded object**](#gt_708607be-8655-416e-93f3-b434e9ecbd56). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cceAunused (optional)
...rgce (variable)
...
+ +**cce (15 bits):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**A - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**unused (4 bytes):** Undefined and MUST be ignored. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST contain one Ptg only, and this Ptg MUST be [PtgTbl](#ptgtbl), [PtgName](#ptgname), [PtgNameX](#ptgnamex), [PtgErr](#ptgerr), [PtgRef](#ptgref), [PtgRefErr](#ptgreferr), [PtgRef3d](#ptgref3d), [PtgRefErr3d](#ptgreferr3d), [PtgArea](#ptgarea), [PtgAreaErr](#ptgareaerr), [PtgArea3d](#ptgarea3d), or [PtgAreaErr3d](#ptgareaerr3d). + +#### ParameterParsedFormula + +The **ParameterParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) for a query parameter. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccergce (variable)
...
+ +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgArray](#ptgarray)[\<177\>](#Appendix_A_177), [PtgMemArea](#ptgmemarea), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), or [PtgSxName](#ptgsxname). + +The root node of the parse tree of this field MUST NOT be a VALUE_TYPE, as described in Rgce. + +#### PivotParsedFormula + +The **PivotParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccecSxName
rgce (variable)
...
+ +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. + +**cSxName (2 bytes):** An unsigned integer that specifies number of contiguous [SxName](#sxname) records that follow the [SxFmla](#sxfmla) record that contains this formula. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgUnion](#ptgunion), [PtgIsect](#ptgisect), [PtgRange](#ptgrange), [PtgArray](#ptgarray), [PtgAttrSpaceSemi](#ptgattrspacesemi), [PtgAttrSemi](#ptgattrsemi), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), [PtgRef](#ptgref), [PtgRefErr](#ptgreferr), [PtgRefN](#ptgrefn), [PtgArea](#ptgarea), [PtgAreaErr](#ptgareaerr), [PtgAreaN](#ptgarean), [PtgRef3d](#ptgref3d), [PtgArea3d](#ptgarea3d), [PtgRefErr3d](#ptgreferr3d), [PtgAreaErr3d](#ptgareaerr3d), [PtgName](#ptgname), [PtgNameX](#ptgnamex), [PtgMemArea](#ptgmemarea), [PtgMemErr](#ptgmemerr), [PtgMemNoMem](#ptgmemnomem), or [PtgMemFunc](#ptgmemfunc). + +If this field contains a [PtgFunc](#ptgfunc), then the **iftab** field of the PtgFunc MUST be less than 0x0028 or greater than 0x002D and MUST NOT be equal to 0x002F, 0x00BD, 0x00C3, 0x00C4, or 0x00C7. + +If this field contains a [PtgFuncVar](#ptgfuncvar), then the **fCeFunc** field of the PtgFuncVar MUST be 0 and the **tab** field of the PtgFuncVar MUST NOT be equal to 0x00FF or 0x0166. + +The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +#### Ptg + +The **Ptg** structure specifies a single element of a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). The value of the first byte determines which structure it represents and MUST be one of the values in the first column of the following table. If the value of the first byte is 0x18 or 0x19, then the second byte determines which structure it represents and MUST be one of the values in the second column of the following table. + +| First byte | Second byte | Ptg | +|------------|-------------|---------------------------------------| +| 0x01 | | [PtgExp](#ptgexp) | +| 0x02 | | [PtgTbl](#ptgtbl) | +| 0x03 | | [PtgAdd](#ptgadd) | +| 0x04 | | [PtgSub](#ptgsub) | +| 0x05 | | [PtgMul](#ptgmul) | +| 0x06 | | [PtgDiv](#ptgdiv) | +| 0x07 | | [PtgPower](#ptgpower) | +| 0x08 | | [PtgConcat](#ptgconcat) | +| 0x09 | | [PtgLt](#ptglt) | +| 0x0A | | [PtgLe](#ptgle) | +| 0x0B | | [PtgEq](#ptgeq) | +| 0x0C | | [PtgGe](#ptgge) | +| 0x0D | | [PtgGt](#ptggt) | +| 0x0E | | [PtgNe](#ptgne) | +| 0x0F | | [PtgIsect](#ptgisect) | +| 0x10 | | [PtgUnion](#ptgunion) | +| 0x11 | | [PtgRange](#ptgrange) | +| 0x12 | | [PtgUplus](#ptguplus) | +| 0x13 | | [PtgUminus](#ptguminus) | +| 0x14 | | [PtgPercent](#ptgpercent) | +| 0x15 | | [PtgParen](#ptgparen) | +| 0x16 | | [PtgMissArg](#ptgmissarg) | +| 0x17 | | [PtgStr](#ptgstr) | +| 0x18 | 0x01 | [PtgElfLel](#ptgelflel) | +| 0x18 | 0x02 | [PtgElfRw](#ptgelfrw) | +| 0x18 | 0x03 | [PtgElfCol](#ptgelfcol) | +| 0x18 | 0x06 | [PtgElfRwV](#ptgelfrwv) | +| 0x18 | 0x07 | [PtgElfColV](#ptgelfcolv) | +| 0x18 | 0x0A | [PtgElfRadical](#ptgelfradical) | +| 0x18 | 0x0B | [PtgElfRadicalS](#ptgelfradicals) | +| 0x18 | 0x0D | [PtgElfColS](#ptgelfcols) | +| 0x18 | 0x0F | [PtgElfColSV](#ptgelfcolsv) | +| 0x18 | 0x10 | [PtgElfRadicalLel](#ptgelfradicallel) | +| 0x18 | 0x1D | [PtgSxName](#ptgsxname) | +| 0x19 | 0x01 | [PtgAttrSemi](#ptgattrsemi) | +| 0x19 | 0x02 | [PtgAttrIf](#ptgattrif) | +| 0x19 | 0x04 | [PtgAttrChoose](#ptgattrchoose) | +| 0x19 | 0x08 | [PtgAttrGoto](#ptgattrgoto) | +| 0x19 | 0x10 | [PtgAttrSum](#ptgattrsum) | +| 0x19 | 0x20 | [PtgAttrBaxcel](#ptgattrbaxcel) | +| 0x19 | 0x21 | PtgAttrBaxcel | +| 0x19 | 0x40 | [PtgAttrSpace](#ptgattrspace) | +| 0x19 | 0x41 | [PtgAttrSpaceSemi](#ptgattrspacesemi) | +| 0x1C | | [PtgErr](#ptgerr) | +| 0x1D | | [PtgBool](#ptgbool) | +| 0x1E | | [PtgInt](#ptgint) | +| 0x1F | | [PtgNum](#ptgnum) | +| 0x20 | | [PtgArray](#ptgarray) | +| 0x21 | | [PtgFunc](#ptgfunc) | +| 0x22 | | [PtgFuncVar](#ptgfuncvar) | +| 0x23 | | [PtgName](#ptgname) | +| 0x24 | | [PtgRef](#ptgref) | +| 0x25 | | [PtgArea](#ptgarea) | +| 0x26 | | [PtgMemArea](#ptgmemarea) | +| 0x27 | | [PtgMemErr](#ptgmemerr) | +| 0x28 | | [PtgMemNoMem](#ptgmemnomem) | +| 0x29 | | [PtgMemFunc](#ptgmemfunc) | +| 0x2A | | [PtgRefErr](#ptgreferr) | +| 0x2B | | [PtgAreaErr](#ptgareaerr) | +| 0x2C | | [PtgRefN](#ptgrefn) | +| 0x2D | | [PtgAreaN](#ptgarean) | +| 0x39 | | [PtgNameX](#ptgnamex) | +| 0x3A | | [PtgRef3d](#ptgref3d) | +| 0x3B | | [PtgArea3d](#ptgarea3d) | +| 0x3C | | [PtgRefErr3d](#ptgreferr3d) | +| 0x3D | | [PtgAreaErr3d](#ptgareaerr3d) | +| 0x40 | | PtgArray | +| 0x41 | | PtgFunc | +| 0x42 | | PtgFuncVar | +| 0x43 | | PtgName | +| 0x44 | | PtgRef | +| 0x45 | | PtgArea | +| 0x46 | | PtgMemArea | +| 0x47 | | PtgMemErr | +| 0x48 | | PtgMemNoMem | +| 0x49 | | PtgMemFunc | +| 0x4A | | PtgRefErr | +| 0x4B | | PtgAreaErr | +| 0x4C | | PtgRefN | +| 0x4D | | PtgAreaN | +| 0x59 | | PtgNameX | +| 0x5A | | PtgRef3d | +| 0x5B | | PtgArea3d | +| 0x5C | | PtgRefErr3d | +| 0x5D | | PtgAreaErr3d | +| 0x60 | | PtgArray | +| 0x61 | | PtgFunc | +| 0x62 | | PtgFuncVar | +| 0x63 | | PtgName | +| 0x64 | | PtgRef | +| 0x65 | | PtgArea | +| 0x66 | | PtgMemArea | +| 0x67 | | PtgMemErr | +| 0x68 | | PtgMemNoMem | +| 0x69 | | PtgMemFunc | +| 0x6A | | PtgRefErr | +| 0x6B | | PtgAreaErr | +| 0x6C | | PtgRefN | +| 0x6D | | PtgAreaN | +| 0x79 | | PtgNameX | +| 0x7A | | PtgRef3d | +| 0x7B | | PtgArea3d | +| 0x7C | | PtgRefErr3d | +| 0x7D | | PtgAreaErr3d | +| | | | +| | | | + +#### PtgAdd + +The **PtgAdd** structure specifies a [binary-value-operator](#rgce) that adds the second expression in a binary-value-expression to the first. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x03. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgArea + +The **PtgArea** [operand](#rgce) specifies a reference to a rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABarea
...
...
+ +**ptg (5 bits):** Reserved. MUST be 0x05. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**area (8 bytes):** A [RgceArea](#rgcearea) that specifies the referenced range of cells. + +#### PtgArea3d + +The **PtgArea3d** [operand](#rgce) specifies a reference to the same rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on one or more [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). If the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing this structure is part of a revision as specified in the Formulas overview, then there MUST be a [RevExtern](#revextern) in the [RgbExtra](#rgbextra) corresponding to this PtgArea3d, which specifies those sheets. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABixtiarea
...
...
+ +**ptg (5 bits):** Reserved. MUST be 0x1B. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the required data type for the value of the [Ptg](#ptg) + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**ixti (2 bytes):** If the formula containing this structure is not part of a revision as specified in the Formulas overview, then this value is an [XtiIndex](#xtiindex) that specifies the [XTI](#xti) which specifies those sheets. Otherwise it is undefined and MUST be ignored. + +**area (8 bytes):** A value that specifies coordinates of the referenced range of cells. If this PtgArea3d is part of a [NameParsedFormula](#nameparsedformula) then this is an [RgceAreaRel](#rgcearearel) value. Otherwise it is an [RgceArea](#rgcearea) value. + +#### PtgAreaErr + +The **PtgAreaErr** [operand](#rgce) specifies an invalid reference to a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABunused1unused2
...unused3unused4
...
+ +**ptg (5 bits):** Reserved. MUST be 0x0B. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**unused3 (2 bytes):** Undefined and MUST be ignored. + +**unused4 (2 bytes):** Undefined and MUST be ignored. + +#### PtgAreaErr3d + +**PtgAreaErr3d** [operand](#rgce) specifies an invalid reference to the same rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on one or more [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). If the [formula](#Section_a795978bfa7845788e2dc07d78edae0e) (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing this structure is part of a revision as specified in the Formulas overview, then there MUST be a [RevExtern](#revextern) in the [RgbExtra](#rgbextra) corresponding to this PtgAreaErr3d, which specifies those sheets. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABixtiunused1
...unused2unused3
...unused4
+ +**ptg (5 bits):** Reserved. MUST be 0x1D. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the required data type for the value of the [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**ixti (2 bytes):** If the formula containing this structure is not part of a revision as specified in the Formulas overview, then this value is an [XtiIndex](#xtiindex) that specifies the [XTI](#xti) which specifies those sheets. Otherwise it is undefined and MUST be ignored. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**unused3 (2 bytes):** Undefined and MUST be ignored. + +**unused4 (2 bytes):** Undefined and MUST be ignored. + +#### PtgAreaN + +The **PtgAreaN** [operand](#rgce) specifies a reference to a rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) as an [RgceAreaRel](#rgcearearel). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABarea
...
...
+ +**ptg (5 bits):** Reserved. MUST be 0x0D. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**area (8 bytes):** An RgceAreaRel that specifies the referenced range. + +#### PtgArray + +The **PtgArray** [operand](#rgce) specifies an array of values. There MUST be a [PtgExtraArray](#ptgextraarray) in the [RgbExtra](#rgbextra) corresponding to this PtgArray. The correspondence between PtgArray and PtgExtraArray structures is specified in RgbExtra. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABunused1unused2
unused3
+ +**ptg (5 bits):** Reserved. MUST be 0x00. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for this array. MUST be 2 or 3. + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**unused1 (1 byte):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**unused3 (4 bytes):** Undefined and MUST be ignored. + +#### PtgAttrBaxcel + +The **PtgAttrBaxcel** structure specifies that the result of the [Rgce](#rgce) is to be assigned to a local variable used in a [**macro sheet**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABCDEunused
+ +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - bitSemi (1 bit):** A bit that specifies whether this Rgce is [**volatile**](#gt_9555fd9b-d7c2-4f56-b938-1c653d46626a). + +**C - reserved2 (4 bits):** MUST be zero, and MUST be ignored. + +**D - bitBaxcel (1 bit):** Reserved. MUST be 1. + +**E - reserved3 (2 bits):** MUST be zero, and MUST be ignored. + +**unused (2 bytes):** Undefined and MUST be ignored. + +#### PtgAttrChoose + +The **PtgAttrChoose** structure specifies a [control token](#Section_3701f8837bef4eacb0e05ecbf4a23cbd). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABCreserved3cOffset
rgOffset (variable)
...
+ +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - reserved2 (2 bits):** MUST be zero, and MUST be ignored. + +**C - bitChoose (1 bit):** Reserved. MUST be 1. + +**reserved3 (5 bits):** MUST be zero, and MUST be ignored. + +**cOffset (2 bytes):** An unsigned integer that specifies a value which is 1 less than the number of elements in **rgOffset.** + +**rgOffset (variable):** An array of 2-byte unsigned integers that specifies the byte offsets. + +#### PtgAttrGoto + +The **PtgAttrGoto** structure specifies a [control token](#Section_3701f8837bef4eacb0e05ecbf4a23cbd). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABCDoffset
+ +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - reserved2 (3 bits):** MUST be zero, and MUST be ignored. + +**C - bitGoto (1 bit):** If the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing this structure is not part of a [ArrayParsedFormula](#arrayparsedformula) then the bit is reserved and MUST be 1. If the formula containing this structure is part of an ArrayParsedFormula, then the bit is undefined and MUST be ignored. + +**D - reserved3 (4 bits):** MUST be zero, and MUST be ignored. + +**offset (2 bytes):** An unsigned integer that specifies a value 1 less than the byte offset. + +#### PtgAttrIf + +The **PtgAttrIf** structure specifies a [control token](#Section_3701f8837bef4eacb0e05ecbf4a23cbd). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABCreserved3offset
+ +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**C - bitIf (1 bit):** Reserved. MUST be 1 + +**reserved3 (6 bits):** MUST be zero, and MUST be ignored. + +**offset (2 bytes):** An unsigned integer that specifies the byte offset. + +#### PtgAttrSemi + +The **PtgAttrSemi** structure specifies that this [Rgce](#rgce) is [**volatile**](#gt_9555fd9b-d7c2-4f56-b938-1c653d46626a). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABreserved2unused
+ +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - bitSemi (1 bit):** Reserved. MUST be 1. + +**reserved2 (7 bits):** MUST be zero, and MUST be ignored. + +**unused (2 bytes):** Undefined and MUST be ignored. + +#### PtgAttrSpace + +The **PtgAttrSpace** [display token](#Section_44ae9bca374542a482095e7ded229789) specifies a number of space or carriage return characters that are displayed around the expression in a [display-precedence-expression](#rgce). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgAreserved2BCtype
+ +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**reserved2 (6 bits):** MUST be zero, and MUST be ignored. + +**B - bitSpace (1 bit):** Reserved. MUST be 1. + +**C - reserved3 (1 bit):** MUST be zero, and MUST be ignored. + +**type (2 bytes):** A [PtgAttrSpaceType](#ptgattrspacetype) that specifies a number of space or carriage return characters and the position of those characters + +#### PtgAttrSpaceSemi + +The **PtgAttrSpaceSemi** structure specifies a number of space or carriage return characters that are displayed around the expression in a [display-precedence-specifier](#rgce) and that the Rgce is [**volatile**](#gt_9555fd9b-d7c2-4f56-b938-1c653d46626a). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgAreserved2type
+ +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**reserved2 (1 byte):** Reserved. MUST be 0x41. + +**type (2 bytes):** A [PtgAttrSpaceType](#ptgattrspacetype) that specifies a number of space or carriage return characters and position of those characters + +#### PtgAttrSpaceType + +The **PtgAttrSpaceType** structure specifies the number of space or carriage return characters and position of those characters. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
typecch
+ +**type (1 byte):** An unsigned integer that specifies the character and position of the character. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | Specifies space characters before a [base-expression](#rgce). | +| 0x01 | Specifies carriage return characters before a base-expression. | +| 0x02 | Specifies space characters before the open parenthesis specified by [PtgParen](#ptgparen) in a display-precedence-specifier. | +| 0x03 | Specifies carriage return characters before the open parenthesis specified by PtgParen in a display-precedence-specifier. | +| 0x04 | Specifies space characters before the close parenthesis specified by PtgParen in a display-precedence-specifier. | +| 0x05 | Specifies carriage return characters before the close parenthesis specified by PtgParen in a display-precedence-specifier. | +| 0x06 | Specifies space characters before an expression. | + +**cch (1 byte):** An unsigned integer that specifies the number of characters. + +#### PtgAttrSum + +The **PtgAttrSum** structure specifies the sum of an expression as defined in [function-call](#rgce). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABCDunused
+ +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - reserved2 (4 bits):** MUST be zero, and MUST be ignored. + +**C - bitSum (1 bit):** Reserved. MUST be 1. + +**D - reserved3 (3 bits):** MUST be zero, and MUST be ignored. + +**unused (2 bytes):** Undefined and MUST be ignored. + +#### PtgBool + +The **PtgBool** [operand](#rgce) specifies a Boolean value. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ptgAboolean
+ +**ptg (7 bits):** Reserved. MUST be 0x1D. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**boolean (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies the value. + +#### PtgConcat + +The **PtgConcat** structure specifies a [binary-value-operator](#rgce) that appends the second expression in binary-value-expression to the first. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x08. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgDataType + +The **PtgDataType** enumeration specifies the data type of a [Ptg](#ptg). MUST be a value from the following table: + +| Name | Value | Meaning | +|----|----|----| +| **REFERENCE** | 0x1 | Specifies a reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). | +| **VALUE** | 0x2 | Specifies a single value of a simple type. The type can be a Boolean, a number, a string, or an error code. | +| **ARRAY** | 0x3 | Specifies an array of values. | + +#### PtgDiv + +The **PtgDiv** structure specifies a [binary-value-operator](#rgce) that divides the first expression in a binary-value-expression by the second. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x06. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgElfCol + +The **PtgElfCol** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [reference class](#Section_a8fde0d5759c437eb385169df8117372) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) within a column which is represented by a single-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgeptgloc
...
+ +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x03. + +**loc (4 bytes):** An [RgceElfLoc](#rgceelfloc) that specifies the location of the label. + +#### PtgElfColS + +The **PtgElfColS** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [reference class](#Section_a8fde0d5759c437eb385169df8117372) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) within a column that is identified by a multiple-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). There MUST be a [PtgExtraElf](#ptgextraelf) in the [RgbExtra](#rgbextra) corresponding to this PtgElfColS. The correspondence between PtgElfColS and PtgExtraElf structures is specified in RgbExtra. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgeptgunused
...
+ +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x0D. + +**unused (4 bytes):** Undefined and MUST be ignored. + +#### PtgElfColSV + +The **PtgElfColSV** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [value class](#Section_9a43cbef26504581af603ff0d876d82a) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) within a column that is identified by a multiple-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). There MUST be a [PtgExtraElf](#ptgextraelf) in the [RgbExtra](#rgbextra) corresponding to this PtgElfColSV. The correspondence between PtgElfColSV and PtgExtraElf structures is specified in RgbExtra. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgeptgunused
...
+ +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x0F. + +**unused (4 bytes):** Undefined and MUST be ignored. + +#### PtgElfColV + +The **PtgElfColV** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [value class](#Section_9a43cbef26504581af603ff0d876d82a) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) within a column which is represented by a single-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgeptgloc
...
+ +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x07. + +**loc (4 bytes):** An [RgceElfLoc](#rgceelfloc) that specifies the location of the label. + +#### PtgElfLel + +The **PtgElfLel** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) which is represented by a single-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5) or a multiple-cell natural language label that has been deleted. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgeptgilel
Areserved
+ +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x01. + +**ilel (2 bytes):** An [Ilel](#ilel) that specifies the deleted label. + +**A - fQuoted (1 bit):** A bit that specifies whether the occurrences of the label specified in **ilel** are surrounded by single quote characters in the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +#### PtgElfRadical + +The **PtgElfRadical** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [reference class](#Section_a8fde0d5759c437eb385169df8117372) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that is represented by a single-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). The range is specified by [PtgArea](#ptgarea) or [PtgAreaErr](#ptgareaerr) that follows this PtgElfRadical in the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). If this structure is followed in the formula by PtgArea, then one but not both of the following MUST be true: + +- The **area.rowFirst** field is equal to the **area.rowLast** field of PtgArea, and the **loc** field specifies a label location that is adjacent to the range specified by the **area** field of PtgArea. The **loc.row** field of this PtgElfRadical is equal to the **area.rowFirst** field of PtgArea + +- The **area.columnFirst** field is equal to the **area.columnLast** field of PtgArea, and the **loc** field specifies a label location that is adjacent to the range specified by the area field of PtgArea. The **loc**.**col** field of this PtgElfRadical is equal to the **area**.**columnFirst** field of PtgArea + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgeptgloc
...
+ +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x0A. + +**loc (4 bytes):** An [RgceElfLoc](#rgceelfloc) that specifies the location of the label. + +#### PtgElfRadicalLel + +The **PtgElfRadicalLel** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [reference class](#Section_a8fde0d5759c437eb385169df8117372) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) which is represented by a single-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5) or a multiple-cell natural language label that has been deleted. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgeptgilel
Areserved
+ +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x10. + +**ilel (2 bytes):** An [Ilel](#ilel) that specifies the deleted label. + +**A - fQuoted (1 bit):** A bit that specifies whether the occurrences of the label specified in **ilel** are surrounded by single quote characters in the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +#### PtgElfRadicalS + +The **PtgElfRadicalS** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [reference class](#Section_a8fde0d5759c437eb385169df8117372) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) which is represented by a multiple-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). The range is specified by the [PtgArea](#ptgarea) or [PtgAreaErr](#ptgareaerr) record which follows this PtgElfRadicalS in the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). There MUST be a [PtgExtraElf](#ptgextraelf) in the [RgbExtra](#rgbextra) corresponding to this PtgElfRadicalS. The correspondence between PtgElfRadicalS and PtgExtraElf structures is specified in RgbExtra. + +If this PtgElfRadicalS is followed in the formula (section 2.2.2) by PtgArea, then the **area.columnFirst** field and the **area.columnLast** field of the PtgArea MUST be equal. Additionally, the last element in the **array** field of the corresponding PtgExtraElf MUST specify a label location that is adjacent to the range specified by the **area** field of PtgArea. The **column**.**col** field of the last element in the **array** field of PtgExtraElf MUST also be equal to the **area**.**columnFirst** field of PtgArea. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgeptgunused
...
+ +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x0B. + +**unused (4 bytes):** Undefined and MUST be ignored. + +#### PtgElfRw + +The **PtgElfRw** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [reference class](#Section_a8fde0d5759c437eb385169df8117372) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) within a row which is represented by a single-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgeptgloc
...
+ +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x02. + +**loc (4 bytes):** An [RgceElfLoc](#rgceelfloc) that specifies the location of the label. + +#### PtgElfRwV + +The **PtgElfRwV** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [value class](#Section_9a43cbef26504581af603ff0d876d82a) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) within a row which is represented by a single-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgeptgloc
...
+ +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x06. + +**loc (4 bytes):** An [RgceElfLoc](#rgceelfloc) that specifies the location of the label. + +#### PtgEq + +The **PtgEq** structure specifies the comparison of whether the first [expression](#rgce) is equal to the second expression. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x0B. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgErr + +The **PtgErr** [operand](#rgce) specifies an error code. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ptgAerr
+ +**ptg (7 bits):** Reserved. MUST be 0x1C. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**err (1 byte):** A [BErr](#berr) that specifies the error code. + +#### PtgExp + +The **PtgExp** structure specifies that the containing [Rgce](#rgce) is part of an array formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) or shared formula and specifies the row and column of the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in which that formula exists. + +The **row** and **col** fields of this structure specify a cell on the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). There MUST be a [Formula](#formula) record where the **cell**.**rw** field of that record is equal to **row**, and **cell**.**col**.**col** field of that record is equal to **col**. + +That Formula record MUST be followed by either a [ShrFmla](#shrfmla) record or an [Array](#array) record. + +If that Formula record is followed by a ShrFmla, the **row** field of this structure MUST be greater than or equal to the **ref**.**rwFirst** field and less than or equal to the **ref**.**rwLast** field of the ShrFmla record, and the **col** field of this structure MUST be greater than or equal to the **ref**.**colFirst** field and less than or equal to the **ref**.**colLast** field of the ShrFmla record. + +If that Formula record is followed by an Array, the **row** field of this structure MUST be equal to the **ref**.**rwFirst** field of the Array record, and the **col** field of this structure MUST be equal to the **ref**.**colFirst** field of the Array record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgArowcol
...
+ +**ptg (7 bits):** Reserved. MUST be 0x01. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**row (2 bytes):** A [Rw](#rw) that specifies the row of the cell that contains the array formula or shared formula that the containing Rgce is a part of. + +**col (2 bytes):** A [Col](#col) that specifies the column of the cell that contains the array formula or shared formula that the containing Rgce is a part of. + +#### PtgExtraArray + +The **PtgExtraArray** structure specifies the values for the corresponding [PtgArray](#ptgarray) as specified in [RgbExtra](#rgbextra). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
colsrowsarray (variable)
...
+ +**cols (1 byte):** A [DColByteU](#dcolbyteu) that specifies one less than the number of columns in the array. + +**rows (2 bytes):** A [DRw](#drw) that specifies one less than the number of rows in the array. + +**array (variable):** An array of [SerAr](#serar) that specifies the values in row-major order. The number of elements MUST be equal to the product of **rows** and **cols**. + +#### PtgExtraElf + +The **PtgExtraElf** structure specifies a multiple-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5) used in a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b). The label is specified by a sequence of labels from the given array of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
countAB
array (variable)
...
+ +**count (30 bits):** An unsigned integer that specifies the number of elements in **array**. MUST be greater than 0. + +**A - reserved (1 bit):** MUST be zero, and MUST be ignored + +**B - fRel (1 bit):** A bit that specifies whether [**relative references**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) are used in the elements of **array**. + +**array (variable):** An array of [RgceElfLocExtra](#rgceelflocextra) elements that specifies the sequence of [**cell references**](#gt_4d15aeb2-3a7d-44d7-b8d1-8a441f1cc24f) that specifies the multiple-cell natural language label. The number of elements MUST be equal to **count**. + +#### PtgExtraMem + +The **PtgExtraMem** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that corresponds to a [PtgMemArea](#ptgmemarea) as specified in [RgbExtra](#rgbextra). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
countarray (variable)
...
+ +**count (2 bytes):** An unsigned integer that specifies the areas within the range. + +**array (variable):** An array of [Ref8U](#ref8u) that specifies the range. The number of elements MUST be equal to **count**. + +#### PtgFunc + +The **PtgFunc** structure specifies a call to a function with a fixed number of parameters, as defined in [function-call](#rgce). + + ++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123
ptgABiftab
+ +**ptg (5 bits):** Reserved. MUST be 0x01. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**iftab (2 bytes):** A [Ftab](#ftab) that specifies the function to be called. MUST specify a function with a fixed number of parameters. + +#### PtgFuncVar + +The **PtgFuncVar** structure specifies a call to a function with a variable number of parameters as defined in [function-call](#rgce). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABcparamstabC
+ +**ptg (5 bits):** Reserved. MUST be 0x02 + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be 0, MUST be ignored. + +**cparams (1 byte):** An unsigned integer that specifies the number of parameters. MUST be within the range defined for the function specified by **tab.** + +**tab (15 bits):** A structure that specifies the function to be called. If **fCeFunc** is 1, then this field specifies a [**Cetab**](#cetab) value. If **fCeFunc** is 0, then this field specifies a [**Ftab**](#ftab) value. + +**C - fCeFunc (1 bit):** A bit that specifies whether **tab** specifies a **Cetab** value or a **Ftab** value. + +#### PtgGe + +The **PtgGe** structure specifies a [binary-value-operator](#rgce) that compares whether the first expression in a binary-value-expression is greater than or equal to the second. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x0C. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgGt + +The **PtgGt** structure specifies a [binary-value-operator](#rgce) that compares whether the first expression in a binary-value-expression is greater than the second. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x0D. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgInt + +The **PtgInt** [operand](#rgce) specifies an unsigned integer value. + + ++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123
ptgAinteger
+ +**ptg (7 bits):** Reserved. MUST be 0x1E. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**integer (2 bytes):** An unsigned integer that specifies the value. + +#### PtgIsect + +The **PtgIsect** structure specifies a [binary-reference-operator](#rgce) that intersects the first expression in a binary-reference-expression with the second. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x0F. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgLe + +The **PtgLe** structure specifies a [binary-value-operator](#rgce) that compares whether the first expression in a binary-value-expression is less than or equal to the second. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x0A. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgLt + +The **PtgLt** structure specifies a [binary-value-operator](#rgce) that compares whether the first expression in a binary-value-expression is less than the second. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x09. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgMemArea + +The **PtgMemArea** [mem token](#Section_0e7857a5d73a4abaafdaaa3996f562fd) specifies that the result of a [binary-reference-expression](#rgce) in a mem-area-expression is a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). The [RgbExtra](#rgbextra) corresponding to this structure MUST contain a [PtgExtraMem](#ptgextramem) that specifies the range of cells. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABunused
...cce
+ +**ptg (5 bits):** Reserved. MUST be 0x06. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**unused (4 bytes):** Undefined and MUST be ignored. + +**cce (2 bytes):** An unsigned integer that specifies the count of bytes in the binary-reference-expression following this structure. + +#### PtgMemErr + +The **PtgMemErr** [mem token](#Section_0e7857a5d73a4abaafdaaa3996f562fd) specifies that the result of a [binary-reference-expression](#rgce) in a mem-area-expression is an error code. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABerrunused1unused2
...cce
+ +**ptg (5 bits):** Reserved. MUST be 0x07. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**err (1 byte):** A [BErr](#berr) that specifies the error code value. + +**unused1 (1 byte):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**cce (2 bytes):** An unsigned integer that specifies the count of bytes in the binary-reference-expression following this structure. + +#### PtgMemFunc + +The **PtgMemFunc** [mem token](#Section_0e7857a5d73a4abaafdaaa3996f562fd) specifies that the result of a [binary-reference-expression](#rgce) in a mem-area-expression is variable. + + ++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123
ptgABcce
+ +**ptg (5 bits):** Reserved. MUST be 0x09. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**cce (2 bytes):** An unsigned integer that specifies the count of bytes in the binary-reference-expression following this structure. + +#### PtgMemNoMem + +The **PtgMemNoMem** [mem token](#Section_0e7857a5d73a4abaafdaaa3996f562fd) specifies that the result of the [binary-reference-expression](#rgce) in a mem-area-expression failed to cache. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABunused
...cce
+ +**ptg (5 bits):** Reserved. MUST be 0x08. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**unused (4 bytes):** Undefined and MUST be ignored. + +**cce (2 bytes):** An unsigned integer that specifies the count of bytes in the binary-reference-expression following this structure. + +#### PtgMissArg + +The **PtgMissArg** [operand](#rgce) specifies a missing value. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x16. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgMul + +The **PtgMul** structure specifies a [binary-value-operator](#rgce) that multiplies the first and second expressions in a binary-value-expression. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x05. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgName + +The **PtgName** [operand](#rgce) specifies a reference to a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) in the same [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) as the containing Rgce. + +If the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing this structure is part of a revision as specified in the Formulas overview, then there MUST be a [RevNameTabid](#revnametabid) in the [RgbExtra](#rgbextra) corresponding to this PtgName, which specifies those defined name. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABnameindex
...
+ +**ptg (5 bits):** Reserved. MUST be 0x03. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the required data type for the value of the [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**nameindex (4 bytes):** If the formula containing this structure is part of a revision as specified in the Formulas overview, then this value is undefined and MUST be ignored. Otherwise it is an unsigned integer that specifies a one-based index of a [Lbl](#lbl) record in the collection of Lbl records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The referenced Lbl specifies the referenced defined name. MUST be greater than 0 and less than or equal to the number of Lbl records in the workbook. + +#### PtgNameX + +The **PtgNameX** structure specifies a reference to a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) in an [external workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc). + +If the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing this structure is part of a revision as specified in the Formulas overview, then there MUST be a [RevName](#revname) in the [RgbExtra](#rgbextra) corresponding to this PtgNameX that specifies the defined name. + +If the formula containing this structure is not part of a revision as specified in the Formulas overview (section 2.2.2), then the referenced defined name is specified by an [XtiIndex](#xtiindex). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABixtinameindex
...
+ +**ptg (5 bits):** Reserved. MUST be 0x19. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the required data type for the value of the [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**ixti (2 bytes):** If the formula containing this structure is not part of a revision as specified in the Formulas overview, this value is an XtiIndex that specifies the [XTI](#xti) that specifies the referenced defined name. + +If the formula containing this structure is part of a revision as specified in the Formulas overview, this value is undefined and MUST be ignored. + +**nameindex (4 bytes):** If the formula containing this structure is not part of a revision as specified in the Formulas overview, this value is an unsigned integer that specifies the one-based index of an [ExternName](#externname) record in the collection of ExternName records directly following the [SupBook](#supbook) record referenced by **ixti**. The referenced ExternName and its associated records specify the referenced defined name. + +If the formula containing this structure is part of a revision as specified in the Formulas overview, this value is undefined and MUST be ignored. + +#### PtgNe + +The **PtgNe** structure specifies a [binary-value-operator](#rgce) that compares whether the second expression in a binary-value-expression is not equal to the first. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x0E. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgNum + +The **PtgNum** [operand](#rgce) specifies a floating-point value. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgAvalue
...
...
+ +**ptg (7 bits):** Reserved. MUST be 0x1F + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**value (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the floating-point value. + +#### PtgParen + +The **PtgParen** [display token](#Section_44ae9bca374542a482095e7ded229789) specifies that parentheses are displayed around the expression in a [display-precedence-expression](#rgce). + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x15. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgPercent + +The **PtgPercent** structure specifies a [unary-operator](#rgce) which divides the expression in a unary-expression by 100. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x14. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgPower + +The **PtgPower** structure specifies a [binary-value-operator](#rgce) that raises the first expression in a binary-value-expression to the power of the second. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x07. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgRange + +The **PtgRange** structure specifies the range operation, where the minimum bounding rectangle of the first [expression](#rgce) and the second expression is generated. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x11. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgRef + +The **PtgRef** [operand](#rgce) specifies a reference to a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) as an [RgceLoc](#rgceloc). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABloc
...
+ +**ptg (5 bits):** Reserved. MUST be 0x04. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**loc (4 bytes):** A RgceLoc value that specifies the coordinates of the referenced cell. + +#### PtgRef3d + +The **PtgRef3d** [operand](#rgce) specifies a reference to a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on one or more [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +If the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing this structure is part of a revision as specified in the Formulas overview (section 2.2.2), then there MUST be a [RevExtern](#revextern) in the [RgbExtra](#rgbextra) corresponding to this PtgRef3d, which specifies those sheets. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABixtiloc
...
+ +**ptg (5 bits):** Reserved. MUST be 0x1A. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the required data type for the value of the [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**ixti (2 bytes):** If the formula containing this structure is not part of a revision as specified in the Formulas overview, then this value is an [XtiIndex](#xtiindex) that specifies the [XTI](#xti) which specifies those sheets. Otherwise it is undefined and MUST be ignored. + +**loc (4 bytes):** A value that specifies coordinates of the referenced cell. If this PtgRef3d is part of a [NameParsedFormula](#nameparsedformula) then this is a [RgceLocRel](#rgcelocrel) value. Otherwise it is a [RgceLoc](#rgceloc) value. + +#### PtgRefErr + +The **PtgRefErr** [operand](#rgce) specifies an invalid reference to a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABunused1unused2
...
+ +**ptg (5 bits):** Reserved. MUST be 0x0A. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +#### PtgRefErr3d + +The **PtgRefErr3d** [operand](#rgce) specifies an invalid reference to a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on one or more [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). If the [formula](#Section_a795978bfa7845788e2dc07d78edae0e) (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing this structure is part of a revision as specified in the Formulas overview (section 2.2.2), then there MUST be a [RevExtern](#revextern) in the [RgbExtra](#rgbextra) corresponding to this PtgRefErr3d, which specifies those sheets. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABixtiunused1
...unused2
+ +**ptg (5 bits):** Reserved. MUST be 0x1C. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the required data type for the value of the [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**ixti (2 bytes):** If the formula containing this structure is not part of a revision as specified in the Formulas overview (section 2.2.2), then this value is an [XtiIndex](#xtiindex) that specifies the [XTI](#xti) which specifies those sheets. Otherwise it is undefined and MUST be ignored. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +#### PtgRefN + +The **PtgRefN** [operand](#rgce) specifies a reference to a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) as an [RgceLocRel](#rgcelocrel). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgABloc
...
+ +**ptg (5 bits):** Reserved. MUST be 0x0C. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**loc (4 bytes):** An RgceLocRel that specifies the referenced cell. + +#### PtgStr + +The **PtgStr** operand specifies a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string value. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgAstring (variable)
...
+ +**ptg (7 bits):** Reserved. MUST be 0x17. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**string (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) value that specifies the string. + +#### PtgSub + +The **PtgSub** structure specifies a [binary-value operator](#rgce) that subtracts the second expression in a binary-value-expression from the first. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x04. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgSxName + +The **PtgSxName** structure specifies a reference to a [calculated field](#Section_4594f2ac815740b381142e77ba8efb7d) or a [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b) found in a [PivotParsedFormula](#pivotparsedformula). The [Rgce](#rgce) that contains this [Ptg](#ptg) MUST be part of the **formula** field of an [SxFmla](#sxfmla) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgAeptgsxIndex
...
+ +**ptg (7 bits):** Reserved. MUST be 0x18. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**eptg (1 byte):** Reserved. MUST be 0x1D. + +**sxIndex (4 bytes):** An unsigned integer that specifies the zero-based index of an [SxName](#sxname) record in the collection of SxName records following an SxFmla record. MUST be less than the value of **formula.cSxName** in the SxFmla record. + +#### PtgTbl + +The **PtgTbl** structure specifies that the [Rgce](#rgce) that contains this PtgTbl is part of a [**data table (1)**](#gt_9e13d7ee-50d6-40ae-8789-29ecafe24bd4) or an [ObjectParsedFormula](#objectparsedformula). + +If the Rgce is not part of an ObjectParsedFormula, then there MUST be a [Table](#table) record in the current part where the **ref**.**rwFirst** field in Table is equal to **row** and the **ref**.**colFirst** field in Table is equal to **col**. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ptgArowcol
...
+ +**ptg (7 bits):** Reserved. MUST be 0x02 + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**row (2 bytes):** An unsigned integer that specifies the first row of the data table (1). MUST be less than 65536. If the Rgce that contains this PtgTbl is part of an ObjectParsedFormula, this field is undefined and MUST be ignored. + +**col (2 bytes):** An unsigned integer that specifies the first column of the data table (1). MUST be less than 256. If the Rgce that contains this PtgTbl is part of an ObjectParsedFormula, this field is undefined and MUST be ignored. + +#### PtgUminus + +The **PtgUminus** structure specifies a [unary-operator](#rgce) which generates the additive inverse of a unary-expression. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x13. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgUnion + +The **PtgUnion** structure specifies a [binary-reference-operator](#rgce) that specifies a union of the first expression in a binary-reference-expression with the second. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x10. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgUplus + +The **PtgUplus** structure specifies a [unary-operator](#rgce) which leaves a unary-expression unchanged. + + ++++++++++ + + + + + + + + + + + + + + + + + + +
01234567
ptgA
+ +**ptg (7 bits):** Reserved. MUST be 0x12. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### RevExtern + +The **RevExtern** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) on a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) that is referenced by a [formula](#Section_a795978bfa7845788e2dc07d78edae0e) (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in a revision as specified in the Formulas overview (section 2.2.2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
book (variable)
...
itabFirst (variable)
...
itabLast (variable)
...
+ +**book (variable):** Specifies the workbook based on the value of the first byte, according to the following table: + +| Value | Meaning | +|----|----| +| 0x01 | Specifies the current workbook. This field is two bytes in size. The second byte MUST be 0x02. | +| Any value except 0x01 | This field is a [VirtualPath](#virtualpath) that specifies the workbook. | + +**itabFirst (variable):** A [RevItab](#revitab) that specifies the first sheet in the range. + +**itabLast (variable):** A RevItab that specifies the last sheet in the range. + +#### RevItab + +The **RevItab** structure specifies a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) referenced by a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in a revision as specified in the Formulas overview (section 2.2.2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
typetabid (optional)sheet (variable)
...
+ +**type (1 byte):** An unsigned integer that specifies the sheet. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | Specifies a sheet on the same workbook. The **tabid** field specifies the sheet. | +| 0x01 | Specifies a sheet on a different workbook. The **sheet** field specifies the sheet. | +| 0x02 | Specifies the same sheet specified by the preceding RevItab. | +| 0x03 | Specifies a missing sheet. | + +**tabid (2 bytes):** An unsigned integer that specifies a sheet identifier in the current workbook. MUST match a sheet identifier specified by [RRTabId](#rrtabid). This field MUST be present if and only if **type** is 0x00. + +**sheet (variable):** A [XLUnicodeString](#xlunicodestring) that specifies the sheet name. This field MUST be present if and only if **type** is 0x01. + +#### RevLblName + +The **RevLblName** structure specifies the name of a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) that is referenced by a formula in a revision as specified in the Formulas overview (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iBuiltinst (variable)
...
+ +**iBuiltin (1 byte):** An unsigned integer that specifies whether the defined name is a [**built-in name**](#gt_d40a51df-e96f-45ec-885d-6f936d172b39), and if so, which built-in name it is. The value MUST be from the following table: + +| Value | Meaning | +|-------|------------------------------| +| 0x00 | This is not a built-in name. | +| 0x01 | Consolidate_Area | +| 0x02 | Auto_Open | +| 0x03 | Auto_Close | +| 0x04 | Extract | +| 0x05 | Database | +| 0x06 | Criteria | +| 0x07 | Print_Area | +| 0x08 | Print_Titles | +| 0x09 | Recorder | +| 0x0A | Data_Form | +| 0x0B | Auto_Activate | +| 0x0C | Auto_Deactivate | +| 0x0D | Sheet_Title | +| 0x0E | \_FilterDatabase | + +**st (variable):** If **iBuiltin** is 0x00, then **st** is an [XLNameUnicodeString](#xlnameunicodestring) that specifies the name of the defined name. Otherwise, **st** is an [XLUnicodeString](#xlunicodestring) and the name of the defined name is specified as the concatenation of built-in name specified by **iBuiltin** and **st.** The concatenated string MUST match grammar specified for XLNameUnicodeString. + +#### RevName + +The **RevName** structure specifies a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) referenced by a [formula](#Section_a795978bfa7845788e2dc07d78edae0e) (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in a revision as specified in the Formulas overview (section 2.2.2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
book (variable)
...
fExternname (variable)
...
externName (variable)
...
+ +**book (variable):** Specifies the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) based on the value of the first byte, according to the following table: + +| Value | Meaning | +|----|----| +| 0x01 | Specifies the current workbook. This field is two bytes in size. The second byte MUST be 0x02. | +| Any value except 0x01 | This field is a [VirtualPath](#virtualpath) that specifies the workbook. | + +**fExtern (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether the defined name is defined in the current workbook. MUST be 0x00 if the first byte of **book** is 0x01, and 0x01 otherwise. + +**name (variable):** A [RevNameTabid](#revnametabid) that specifies the name and the scope of the defined name. This field MUST be present if and only if **fExtern** is 0x00. + +**externName (variable):** A [RevNamePly](#revnameply) that specifies the name and the scope of the defined name. This field MUST be present if and only if **fExtern** is 0x01. + +#### RevNamePly + +The **RevNamePly** structure specifies a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) in an [external workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc) that is referenced by a [formula](#Section_a795978bfa7845788e2dc07d78edae0e) (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in a revision as specified in the Formulas overview (section 2.2.2), and the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) on which it is defined. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
sheet (variable)
...
name (variable)
...
+ +**sheet (variable):** A [RevSheetName](#revsheetname) that specifies the sheet on which the defined name is defined. + +**name (variable):** A [RevLblName](#revlblname) that specifies the defined name. + +#### RevNameTabid + +The **RevNameTabid** structure specifies a non-external [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) that is referenced by a [formula](#Section_a795978bfa7845788e2dc07d78edae0e) (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in a revision as specified in the Formulas overview (section 2.2.2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
tabidname (variable)
...
+ +**tabid (2 bytes):** An unsigned integer that specifies the scope of the defined name. The value MUST be from the following table: + +| Value | Meaning | +|----|----| +| 0xFFFF | Specifies that the scope is the entire [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). | +| Greater than or equal to 1 and less than 0xFFFF | Specifies that the scope is a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) from the workbook. The value is a sheet identifier which MUST match a sheet identifier specified by [RRTabId](#rrtabid) in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). | + +**name (variable):** A [RevLblName](#revlblname) that specifies the name of the defined name. + +#### RevSheetName + +The **RevSheetName** structure specifies the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) or [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) on which a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) is defined, for a defined name that is referenced by a [formula](#Section_a795978bfa7845788e2dc07d78edae0e) (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in a revision as specified in the Formulas overview (section 2.2.2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
sheet (variable)
...
+ +**sheet (variable):** A [XLUnicodeString](#xlunicodestring) that specifies the name of the sheet. The length of the string MUST be less than or equal to 31 characters. This field specifies the entire workbook if the length of the string is zero. + +#### RgbExtra + +The **RgbExtra** structure specifies a set of structures, laid out sequentially in the file, that correspond to and MUST exist for certain [Ptg](#ptg)s in the [Rgce](#rgce). The order of the structures MUST be the same as the order of the Ptgs in the Rgce that they correspond to. + +The following Ptgs MUST have a corresponding structure in an RgbExtra. + +| Ptg | Required structure in an RgbExtra | +|-----------------------------------|-----------------------------------| +| [PtgArray](#ptgarray) | [PtgExtraArray](#ptgextraarray) | +| [PtgMemArea](#ptgmemarea) | [PtgExtraMem](#ptgextramem) | +| [PtgElfRadicalS](#ptgelfradicals) | [PtgExtraElf](#ptgextraelf) | +| [PtgElfColS](#ptgelfcols) | PtgExtraElf | +| [PtgElfColSV](#ptgelfcolsv) | PtgExtraElf | + +The following Ptgs MUST have a corresponding structure in an RgbExtra if and only if the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing that Ptg is part of a revision as specified in the Formulas overview (section 2.2.2). + +| Ptg | Required structure in an RgbExtra | +|-------------------------------|-----------------------------------| +| [PtgName](#ptgname) | [RevNameTabid](#revnametabid) | +| [PtgNameX](#ptgnamex) | [RevName](#revname) | +| [PtgRef3d](#ptgref3d) | [RevExtern](#revextern) | +| [PtgRefErr3d](#ptgreferr3d) | RevExtern | +| [PtgArea3d](#ptgarea3d) | RevExtern | +| [PtgAreaErr3d](#ptgareaerr3d) | RevExtern | + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgb (variable)
...
+ +**rgb (variable):** An array that contains the sequence of these structures. + +#### Rgce + +The **Rgce** structure specifies a set of [Ptg](#ptg)s, laid out sequentially in the file. + +The sequence of Ptgs MUST adhere to the following grammar. + +EXPRESSION_SIZE is the sum of the sizes of a contiguous set of Ptgs in bytes. + +The ACTUAL_PTG_SIZE of a Ptg is as follows: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PtgACTUAL_PTG_SIZE
PtgStr

1 + (stringsize + 1) * 2

+

where stringsize is the string.cch field of the PtgStr structure

PtgArray15
PtgRef7
PtgArea13
PtgRefErr7
PtgAreaErr13
PtgRefN7
PtgAreaN13
PtgRef3d9
PtgArea3d15
PtgRefErr3d9
PtgAreaErr3d16
Any other PtgSize of the Ptg in bytes
+ +The ACTUAL_EXPRESSION_SIZE of a contiguous set of Ptgs is the sum of ACTUAL_PTG_SIZEs of those Ptgs. The ACTUAL_EXPRESSION_SIZE of all Ptgs in an Rgce MUST be less than or equal to 1800. + +rgce = [PtgExp](#ptgexp) / [PtgTbl](#ptgtbl) / \[[PtgAttrBaxcel](#ptgattrbaxcel) / [PtgAttrSemi](#ptgattrsemi) / [PtgAttrSpaceSemi](#ptgattrspacesemi)\] expression + +expression = \*[PtgAttrSpace](#ptgattrspace) base-expression + +The value of the **type** field of each PtgAttrSpace in an expression MUST be 0, 1, or 6. + +base-expression = operand / unary-expression / binary-reference-expression / binary-value-expression / display-precedence-specifier / mem-area-expression / function-call + +operand = [PtgMissArg](#ptgmissarg) / PtgStr / [PtgErr](#ptgerr) / [PtgBool](#ptgbool) / [PtgInt](#ptgint) / [PtgNum](#ptgnum) / PtgArray / [PtgName](#ptgname) / PtgRef / PtgArea / PtgRefErr / PtgAreaErr / PtgRefN / PtgAreaN / [PtgNameX](#ptgnamex) / PtgRef3d / PtgArea3d / PtgRefErr3d / PtgAreaErr3d / [PtgElfLel](#ptgelflel) / [PtgElfRw](#ptgelfrw) / [PtgElfCol](#ptgelfcol) / [PtgElfRwV](#ptgelfrwv) / [PtgElfColV](#ptgelfcolv) / [PtgElfRadical](#ptgelfradical) PtgArea / PtgElfRadical PtgAreaErr / [PtgElfRadicalS](#ptgelfradicals) PtgArea / PtgElfRadicalS PtgAreaErr / [PtgElfColS](#ptgelfcols) / [PtgElfColSV](#ptgelfcolsv) / [PtgElfRadicalLel](#ptgelfradicallel) PtgArea / PtgElfRadicalLel PtgAreaErr / [PtgSxName](#ptgsxname) + +Each Ptg in this definition is an [operand token](#Section_011ec51c5e8742aea0a1f5ee242c1189). + +unary-expression = val unary-operator + +unary-operator = [PtgUplus](#ptguplus) / [PtgUminus](#ptguminus) / [PtgPercent](#ptgpercent) + +Each Ptg in this definition is an [operator token](#Section_0c6cc754f96f4061a9759d6eae97f8a3). + +binary-reference-expression = 2ref binary-reference-operator + +binary-reference-operator = [PtgIsect](#ptgisect) / [PtgUnion](#ptgunion) / [PtgRange](#ptgrange) + +Each Ptg in this definition is an operator token. + +binary-value-expression = 2val binary-value-operator + +binary-value-operator = [PtgAdd](#ptgadd) / [PtgSub](#ptgsub) / [PtgMul](#ptgmul) / [PtgDiv](#ptgdiv) / [PtgPower](#ptgpower) / [PtgConcat](#ptgconcat) / [PtgLt](#ptglt) / [PtgLe](#ptgle) / [PtgEq](#ptgeq) / [PtgGe](#ptgge) / [PtgGt](#ptggt) / [PtgNe](#ptgne) + +Each Ptg in this definition is an operator token. + +display-precedence-specifier = expression \[PtgAttrSpace\] [PtgParen](#ptgparen) + +The value of the **type** field of a PtgAttrSpace MUST be between 2 and 5 inclusive. + +PtgAttrSpace and PtgParen are [display tokens](#Section_44ae9bca374542a482095e7ded229789). + +mem-area-expression = mem-ptg binary-reference-expression + +The **cce** field in the Ptg of the mem-ptg rule MUST be equal to the EXPRESSION_SIZE of the Ptgs that comprise the binary-reference-expression. + +If mem-ptg is not [PtgMemFunc](#ptgmemfunc) then the expression elements in the binary-reference-expression MUST NOT contain any mem-ptg elements, [PtgFunc](#ptgfunc), [PtgFuncVar](#ptgfuncvar), PtgName, PtgNameX, PtgRef3d, PtgArea3d, PtgRefErr3d, or PtgAreaErr3d. + +mem-ptg = [PtgMemArea](#ptgmemarea) / [PtgMemErr](#ptgmemerr) / [PtgMemNoMem](#ptgmemnomem) / PtgMemFunc + +Each Ptg in this definition is a [mem token](#Section_0e7857a5d73a4abaafdaaa3996f562fd). + +function-call = if-expression / choose-expression / \[[params-fixed](#ftab)\] PtgFunc / params-variable PtgFuncVar / [params-cetab](#cetab) PtgFuncVar / expression [PtgAttrSum](#ptgattrsum) + +The params-fixed element MUST NOT be specified if PtgFunc specifies a function that takes no parameters. Otherwise, it MUST conform to the ABNF rule for the function specified by PtgFunc. + +if-expression = expression [PtgAttrIf](#ptgattrif) 1\*2(expression [PtgAttrGoto](#ptgattrgoto)) PtgFuncVar + +The value of the **offset** field in the PtgAttrIf MUST be equal to the EXPRESSION_SIZE of all Ptgs in the if-expression after the PtgAttrIf through the first PtgAttrGoto. + +The value of the **offset** field in each PtgAttrGoto MUST be equal to one less than the EXPRESSION_SIZE of all Ptgs remaining in the if-expression after that PtgAttrGoto. + +The value of the **fCeFunc** field of the PtgFuncVar MUST be zero. The value of the **tab** field of the PtgFuncVar MUST be 0x0001, which represents the IF function. + +choose-expression = expression [PtgAttrChoose](#ptgattrchoose) 1\*29(expression PtgAttrGoto) PtgFuncVar + +The value of the **cOffset** field in the PtgAttrChoose MUST be equal to the number of times the expression in the repeated sequence group appears. + +The first offset in the array of offsets in the **rgOffset** field in the PtgAttrChoose MUST be equal to four less than the size of the PtgAttrChoose in bytes. + +For the nth occurrence of the repeated sequence group, the (n+1)th offset in the array of offsets in the **rgOffset** field in the PtgAttrChoose MUST be equal to the EXPRESSION_SIZE of all Ptgs in the choose-expression after the PtgAttrChoose through the nth PtgAttrGoto. + +The value of the **offset** field in each PtgAttrGoto MUST equal one less than the EXPRESSION_SIZE of all Ptgs remaining in the choose-expression after that PtgAttrGoto. + +The value of the **fCeFunc** field of the PtgFuncVar MUST be zero. The value of the **tab** field of the PtgFuncVar MUST be 0x0064, which represents the CHOOSE function. + +val = expression + +Additional restrictions are specified under VALUE_TYPE. The params-fixed, params-variable and params-cetab rules also use val. + +ref = expression + +Additional restrictions are specified under VALUE_TYPE. The params-fixed, params-variable and params-cetab rules also use ref. + +If the value of the **useselfs** field of the [UsesELFs](#useselfs) record is zero then an Rgce MUST NOT contain PtgElfLel, PtgElfRw, PtgElfCol, PtgElfRwV, PtgElfColV, PtgElfRadical, PtgElfRadicalS, PtgElfColS, PtgElfColSV, and PtgElfRadicalLel. + +PtgElfLel, PtgElfRw, PtgElfCol, PtgElfRwV, PtgElfColV, PtgElfRadical, PtgElfRadicalS, PtgElfColS, PtgElfColSV, and PtgElfRadicalLel SHOULD NOT[\<178\>](#Appendix_A_178) be used. + +Additional restrictions on the contents of this structure are specified in terms of a parse tree. For this purpose, a parse tree is a means of organizing the components of an Rgce. Each node in the parse tree represents a Ptg or an ABNF rule described previously. Non-leaf nodes represent rules and have one child node for each element in the rule. Leaf nodes represent only a Ptg. + +For a leaf node in the parse tree, NESTING_DEPTH is the number of function-call nodes in the path from the root node to that leaf. + +For a node in the parse tree, OPERAND_COUNT is as follows: + +- The OPERAND_COUNT of each Ptg appearing in the operand rule definition is one. + +- The OPERAND_COUNT of all other Ptgs is zero. + +- The OPERAND_COUNT of a node that has n child nodes with nonzero OPERAND_COUNT is equal to the maximum, across all the n child nodes, of (n-1) plus the OPERAND_COUNT of the nth child that has nonzero OPERAND_COUNT. + +For a node in the parse tree, VALUE_TYPE is a state indicating that the node represents a single value of a simple type or an array of such values. A node that is not a VALUE_TYPE represents a reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). Elements in an expression MUST represent either values or references, based on the specific Ptgs used in the expression. The following rules specify how to traverse the parse tree from the bottom up and determine whether each node is a VALUE_TYPE, which determines whether the sequence of Ptgs comprising the formula correctly satisfies the requirements of each expression in the formula. A node is determined to be a VALUE_TYPE as follows: + +- Leaf nodes: + + + +- PtgMissArg, PtgStr, PtgSxName, PtgErr, PtgBool, PtgInt, PtgNum, PtgArray, PtgRefErr, PtgAreaErr, PtgRefErr3d, PtgAreaErr3d, PtgElfLel, PtgElfRwV, PtgElfColV, PtgElfColSV, PtgElfRadicalLel, PtgUplus, PtgUminus, PtgPercent, PtgAdd, PtgSub, PtgMul, PtgDiv, PtgPower, PtgConcat, PtgLt, PtgLe, PtgEq, PtgGe, PtgGt, and PtgNe leaf nodes are VALUE_TYPEs. + +- PtgName, PtgRef, PtgArea, PtgRefN, PtgAreaN, PtgNameX, PtgRef3d, PtgArea3d, PtgFunc, PtgFuncVar, PtgMemArea, PtgMemErr, PtgMemNoMem, and PtgMemFunc leaf nodes are VALUE_TYPEs if and only if the value of the **type** field is value or array. + +- All other leaf nodes are not VALUE_TYPEs. + + + +- Non-leaf nodes: + + + +- Any non-leaf node with a single child node MUST be a VALUE_TYPE if and only if the child node is a VALUE_TYPE. + +- Any non-leaf node with a mem-ptg, unary-operator, binary-value-operator, binary-reference-operator, PtgAttrSum, PtgFunc or PtgFuncVar child node is a VALUE_TYPE if and only if that child node is a VALUE_TYPE. Other child nodes are ignored for the purposes of determining whether the non-leaf node is a VALUE_TYPE. + +- Any non-leaf node corresponding to a val rule MUST be a VALUE_TYPE. + +- Any non-leaf node corresponding to a ref rule MUST NOT be a VALUE_TYPE. + +- Otherwise, a non-leaf node with an expression child node is a VALUE_TYPE if and only if that expression child node is a VALUE_TYPE. + +A parse tree for an Rgce MUST meet the following conditions: + +- The NESTING_DEPTH of each leaf node MUST NOT exceed 8. + +- The OPERAND_COUNT of the root node MUST NOT exceed 40. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
sequence (variable)
...
+ +**sequence (variable):** An array of Ptg that specifies the sequence of Ptgs. + +#### RgceArea + +The **RgceArea** structure specifies a reference to a rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) where [**relative references**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) are stored as coordinates. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rowFirstrowLast
columnFirstcolumnLast
+ +**rowFirst (2 bytes):** An [RwU](#rwu) that specifies the row number of the first row of the rectangular range of cells. + +**rowLast (2 bytes):** An RwU that specifies the row number of the last row of the rectangular range of cells. + +**columnFirst (2 bytes):** A [ColRelU](#colrelu) that specifies the column number of the first column of the rectangular range of cells and relative reference information. + +**columnLast (2 bytes):** A ColRelU that specifies the column number of the last column of the rectangular range of cells and relative reference information. + +#### RgceAreaRel + +The **RgceAreaRel** structure specifies a rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) where the relative portions of [**relative references**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) are specified as offsets from the cell in which the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) is evaluated. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rowFirstrowLast
columnFirstcolumnLast
+ +**rowFirst (2 bytes):** An [RwU](#rwu) that specifies information about the first row of the cell reference. If **columnFirst.rowRelative** is 0, then **rowFirst** specifies the first row coordinate of the cell reference. If **columnFirst.rowRelative** is 1, then **rowFirst** specifies the first row as an offset from the cell in which the formula is evaluated. + +**rowLast (2 bytes):** An RwU that specifies information about the last row of the cell reference. If **columnLast.rowRelative** is 0, then **rowLast** specifies the last row coordinate of the cell reference. If **columnLast.rowRelative** is 1, then **rowLast** specifies the last row as an offset from the cell in which the formula is evaluated. + +**columnFirst (2 bytes):** A [ColRelNegU](#colrelnegu) that specifies information about the first row and column in the range. If **columnFirst.colRelative** is 0, then **columnFirst.col** is an unsigned integer that specifies the first column coordinate of the cell reference and MUST be less than 256. If **columnFirst.colRelative** is 1, then **columnFirst.col** is a signed integer that specifies the first column as an offset from the cell in which the formula is evaluated. + +**columnLast (2 bytes):** A ColRelNegU that specifies information about the first row and column in the range. If **columnLast.colRelative** is 0, then **columnLast.col** is an unsigned integer that specifies the last column coordinate of the cell reference and MUST be less than 256. If **columnLast.colRelative** is 1, then **columnLast.col** is a signed integer that specifies the last column as an offset from the cell in which the formula is evaluated. + +#### RgceElfLoc + +The **RgceElfLoc** structure specifies a location of a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that contains a label used in a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) to refer to a contiguous [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells from the same row or column as the cell with the label. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rowcolumn
+ +**row (2 bytes):** An [RwU](#rwu) that specifies the zero-based row coordinate of the cell. + +**column (2 bytes):** A [ColElfU](#colelfu) that specifies the zero-based column coordinate of the cell and other information about the cell reference. + +#### RgceElfLocExtra + +The **RgceElfLocExtra** structure specifies a single [**cell reference**](#gt_4d15aeb2-3a7d-44d7-b8d1-8a441f1cc24f) which specifies a part of a multiple-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). The [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) is specified as the intersection of the given row and column. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rowcolumn
+ +**row (2 bytes):** An [RwU](#rwu) that specifies the row coordinate of the cell reference. + +**column (2 bytes):** A [ColRelU](#colrelu) that specifies the column coordinate of the cell reference. The values of **column.colRelative** and **column.rowRelative** MUST be ignored. + +#### RgceLoc + +The **RgceLoc** structure specifies a reference to a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) where [**relative references**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) are stored as coordinates. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rowcolumn
+ +**row (2 bytes):** An [RwU](#rwu) that specifies the row coordinate of the cell reference. + +**column (2 bytes):** A [ColRelU](#colrelu) that specifies the column coordinate of the cell reference and relative reference information. + +#### RgceLoc8 + +The **RgceLoc8** structure specifies a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) reference. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgceLoc
reserved
+ +**rgceLoc (4 bytes):** A [RgceLoc](#rgceloc) that specifies a single cell reference. + +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +#### RgceLocRel + +The **RgceLocRel** structure specifies a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) reference where the relative portions of [**relative references**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) are specified as offsets from the cell in which the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) is evaluated. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rowcolumn
+ +**row (2 bytes):** An [RwU](#rwu) that specifies information about the row of the cell reference. If **column.rowRelative** is 0, then **row** specifies the row coordinate of the cell reference. If **column.rowRelative** is 1, then **row** specifies the row as an offset from the cell in which the formula is evaluated. If the signed result of the offset is a row index less than 0x00000000 or greater than 0x0000FFFF, the value is adjusted by 0x00010000 so that it will result in a valid row index. + +**column (2 bytes):** A [ColRelNegU](#colrelnegu) that specifies information about the row and column. If **column.colRelative** is 0, then **column.col** is an unsigned integer that specifies the column coordinate of the cell reference and MUST be less than 256. If **column.colRelative** is 1, then **column.col** is a signed integer that specifies the column as an offset from the cell in which the formula is evaluated. If the signed result of the offset is a column index less than 0x0000 or greater than 0x00FF, the value is adjusted by 0x0100 so that it will result in a valid column index. + +#### SerAr + +The **SerAr** structure specifies a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) value within an array of values. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
blob (variable)
...
+ +**blob (variable):** A structure that specifies a cell value. MUST be one of the following structures: [SerNil](#sernil), [SerNum](#sernum), [SerStr](#serstr), [SerBool](#serbool), or [SerErr](#sererr). The structure is specified by the first byte, which is the reserved byte in each of those structures. + +#### SerBool + +The **SerBool** structure specifies a Boolean (section [2.5.14](#boolean)) value in an array of values. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reserved1freserved2unused1
...unused2
...
+ +**reserved1 (1 byte):** Reserved. MUST be 0x04. + +**f (1 byte):** A Boolean that specifies the value. + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +#### SerErr + +The **SerErr** structure specifies an error value in an array of values. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reserved1errreserved2unused1
...unused2
...
+ +**reserved1 (1 byte):** Reserved. MUST be 0x10. + +**err (1 byte):** A [BErr](#berr) that specifies the error code value. + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +#### SerNil + +The **SerNil** structure specifies a null value in an array of values. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reservedunused1
...unused2
...
+ +**reserved (1 byte):** MUST be zero, and MUST be ignored. + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +#### SerNum + +The **SerNum** structure specifies a numeric value in an array of values. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reservedxnum
...
...
+ +**reserved (1 byte):** Reserved. MUST be 0x01. + +**xnum (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the value. + +#### SerStr + +The **SerStr** structure specifies a string in an array of values. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reservedstring (variable)
...
+ +**reserved (1 byte):** Reserved. MUST be 0x02. + +**string (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the string. The length of the string MUST be less than 256 characters. + +#### SharedParsedFormula + +The **SharedParsedFormula** structure specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) for a shared formula. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ccergce (variable)
...
rgcb (variable)
...
+ +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgSxName](#ptgsxname), [PtgIsect](#ptgisect), [PtgUnion](#ptgunion), [PtgRange](#ptgrange), [PtgArray](#ptgarray), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), [PtgRefErr](#ptgreferr), [PtgAreaErr](#ptgareaerr), [PtgRef3d](#ptgref3d), [PtgArea3d](#ptgarea3d), [PtgRefErr3d](#ptgreferr3d), [PtgAreaErr3d](#ptgareaerr3d), [PtgNameX](#ptgnamex), [PtgMemArea](#ptgmemarea), [PtgMemErr](#ptgmemerr), [PtgMemNoMem](#ptgmemnomem), or [PtgMemFunc](#ptgmemfunc). + +If this field contains a [PtgRef](#ptgref), then the **loc.column.colRelative** and **loc.column.rowRelative** fields in the PtgRef MUST be 0. + +If this field contains a [PtgArea](#ptgarea), then the **area.columnFirst.colRelative**, **area.columnFirst.rowRelative**, **area.columnLast.colRelative**, and **area.columnLast.rowRelative** fields in the PtgArea MUST be 0. + +If this field contains a [PtgFuncVar](#ptgfuncvar) and the **fCeFunc** field of the PtgFuncVar is 0, then the **tab** field of PtgFuncVar MUST NOT be 0x017B. + +The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +**rgcb (variable):** An [RgbExtra](#rgbextra) that specifies ancillary data for the formula. + +#### XtiIndex + +**XtiIndex** is a 2-byte unsigned integer that specifies an [XTI](#xti) record. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0xFFFF | Specifies an invalid XTI. | +| Greater than or equal to zero and less than 0xFFFF | Specifies a zero-based index of an XTI structure in the array specified by the **rgXTI** field of the [ExternSheet](#externsheet) record. The value MUST be less than the **cXTI** field of the ExternSheet record. | + +### PBT + +The **PBT** structure specifies information about a parameter in a [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) that retrieves [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) for a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) or a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289). The values in this structure provide additional information about the related [ParamQry](#paramqry) record as specified by the **rgPbt** field in the [DBQueryExt](#dbqueryext) record that contains this structure. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
pbtABreserved
+ +**pbt (3 bits):** An unsigned integer that specifies the location of the parameter value. MUST be the same as the **pbt** field in the related ParamQry record as specified by the **rgPbt** field in the DBQueryExt record that contains this structure. MUST be a value from the following table: + +| Value | Meaning | +|---:|----| +| 0x0 | The user is prompted for the value of the parameter. | +| 0x1 | The parameter value is specified in the query. | +| 0x2 | The parameter value is specified in a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). | + +**A - fAutoRefresh (1 bit):** A bit that specifies whether the query refreshes when the parameter value changes. If **pbt** is not equal to 0x2 then this bit MUST be zero, and MUST be ignored. + +**B - fNeedRefresh (1 bit):** A bit that specifies that the parameter value changed and the query was not refreshed. MUST be 0 if **pbt** is not equal to 0x2. + +**reserved (11 bits):** MUST be zero, and MUST be ignored. + +### PhRuns + +The **PhRuns** structure specifies a [**phonetic text run**](#gt_02ee536f-14c0-451a-9d66-111431897cac) that is displayed above a [**text run**](#gt_393612a7-9552-48b0-abf6-0371dbd6d553). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ichFirstichMom
cchMom
+ +**ichFirst (2 bytes):** A signed integer that specifies the zero-based index of the first character of the phonetic text run in the **rphssub.st** field of the [ExtRst](#extrst) structure that contains this PhRuns structure. MUST be greater than or equal to 0. + +**ichMom (2 bytes):** A signed integer that specifies the zero-based index of the first character of the text run in the **rgb** field of the [XLUnicodeRichExtendedString](#xlunicoderichextendedstring) that contains the ExtRst that contains this PhRuns that corresponds to the phonetic text run specified in **ichFirst**. **ichMom** specifies the location where the text run which phonetic text run specified in **ichFirst** applies to begins. MUST be greater than or equal to 0. + +**cchMom (2 bytes):** A signed integer that specifies the count of characters in the text run specified in **ichMom**. MUST be greater than or equal to 0. + +### Phs + +The **Phs** structure specifies the formatting information for a [**phonetic string**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ifntABunused
+ +**ifnt (2 bytes):** A [FontIndex](#fontindex) structure that specifies the font. + +**A - phType (2 bits):** An unsigned integer that specifies the type of the phonetic information. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------------------| +| 0x0 | Use narrow Katakana characters as phonetic string. | +| 0x1 | Use wide Katakana characters as phonetic string. | +| 0x2 | Use Hiragana characters as phonetic string. | +| 0x3 | Use any type of characters as phonetic string. | + +**B - alcH (2 bits):** An unsigned integer that specifies the alignment of the phonetic string. MUST be a value from the following table: + +| Value | Alignment | +|-------|-----------------------| +| 0x0 | General alignment | +| 0x1 | Left aligned | +| 0x2 | Center aligned | +| 0x3 | Distributed alignment | + +**unused (12 bits):** Undefined and MUST be ignored. + +### PictFmlaEmbedInfo + +The **PictFmlaEmbedInfo** structure specifies information about the embedded control associated with the [Obj](#obj) record that contains the [ObjFmla](#objfmla) structure that contains this PictFmlaEmbedInfo. The embedded control can be an [**ActiveX control**](#gt_f3dcc35f-8f80-474e-ac39-106a23f059c2), an [**OLE object**](#gt_cdff9514-a3fb-4897-941d-4e99193a0096) or a [**camera picture**](#gt_ccb0da7f-aa4d-481c-b46c-e96c220869e1) control. The **pictFlags** field of this Obj record specifies the type of embedded control. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ttbcbClassreservedstrClass (variable)
...
+ +**ttb (1 byte):** Reserved. MUST be 0x03. + +**cbClass (1 byte):** An unsigned integer that specifies the length in bytes of the **strClass** field. + +**reserved (1 byte):** MUST be zero, and MUST be ignored. + +**strClass (variable):** An optional [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the class name of the embedded control associated with this Obj. This field MUST exist if and only if **cbClass** is nonzero. + +### PictFmlaKey + +The **PictFmlaKey** structure specifies the runtime [**license key**](#gt_555fdaf4-dd5e-4ccb-bf55-56a7ba7ff56d) of the object and specifies the reference to a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that is linked to the picture [Obj](#obj) that contains this PictFmlaKey. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cbKey
keyBuf (variable)
...
fmlaLinkedCell (variable)
...
fmlaListFillRange (variable)
...
+ +**cbKey (4 bytes):** An unsigned integer that specifies the number of bytes in the **keyBuf** string[\<179\>](#Appendix_A_179). + +**keyBuf (variable):** An array of **cbKey** that specifies the license key for the [**ActiveX control**](#gt_f3dcc35f-8f80-474e-ac39-106a23f059c2). This field is passed to a license-aware object creation method. + +**fmlaLinkedCell (variable):** An [ObjFmla](#objfmla) that specifies a reference to the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) where the value of the first cell is linked to the current selection in this picture control. An empty formula, where **fmlaLinkedCell.cbFmla** equals zero, specifies there is no such cell linked to this picture control. + +**fmlaListFillRange (variable):** An ObjFmla that specifies the range used to populate the content of this picture control. The **fmlaListFillRange.cbFmla** field MUST be 0 unless there is a bindable property (as specified in [\[MS-OAUT\]](%5bMS-OAUT%5d.pdf#Section_bbb05720f72445c78d17f83c3d1a3961) section [2.2.49.5.2](http://msdn.microsoft.com/en-us/library/ac18004e-7af7-4feb-8ae6-d42e7a14267c/)) in the typelib of the ActiveX control that equals the GUID {0C733A7C-2A1C-11CE-ADE5-00AA0044773D}. + +### PivotCompProp + +The **PivotCompProp** structure specifies the properties of a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) string comparison. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
fComparereserved1reserved2
...reserved3
+ +**fCompare (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies the type of string comparison. + +| Value | Meaning | +|----|----| +| 0x0000 | This is a wildcard pattern match. For the purposes of comparisons, the characters "?" and "\*" are used as wildcards. A "?" refers to any single character, and a "\*" refers to any number of characters. | +| 0x0001 | This is a simple string comparison. | + +**reserved1 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +### PositionMode + +The **PositionMode** structure specifies positioning mode for position information saved in a [Pos](#pos) record. + +| Name | Value | Meaning | +|----|----|----| +| **MDFX** | 0x0000 | Relative position to the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), in [**points**](#gt_d072e4da-7898-4227-8f25-9fe77db43571). | +| **MDABS** | 0x0001 | Absolute width and height in points. It can only be applied to the mdBotRt field of Pos. | +| **MDPARENT** | 0x0002 | Owner of Pos determines how to interpret the position data. | +| **MDKTH** | 0x0003 | Offset to default position, in 1/1000th of the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) size. | +| **MDCHART** | 0x0005 | Relative position to the chart, in [SPRC](#Section_d5fc728e68de4972905a975bcef8c82d). | + +### ReadingOrder + +The **ReadingOrder** enumeration specifies the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361). + +| Name | Value | Meaning | +|---------------------------|-------|-----------------------------| +| **READING_ORDER_CONTEXT** | 0x00 | Context reading order | +| **READING_ORDER_LTR** | 0x01 | Left-to-right reading order | +| **READING_ORDER_RTL** | 0x02 | Right-to-left reading order | + +### Ref + +The **Ref** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on a given [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwFirstrwLast
colFirstcolLast
+ +**rwFirst (2 bytes):** An unsigned integer that specifies the first zero-based row index in the range. MUST be greater than or equal to the **rwMic** field of the [Dimensions](#dimensions) record and MUST be less than the **rwMac** field of the Dimensions record. MUST be less than or equal to **rwLast**. + +**rwLast (2 bytes):** An unsigned integer that specifies the last zero-based row index in the range. MUST be greater than or equal to the **rwMic** field of the Dimensions record and MUST be less than the **rwMac** field of the Dimensions record. MUST be greater than or equal to **rwFirst**. + +**colFirst (1 byte):** A [ColByte](#colbyte) structure that specifies the first zero-based column index in the range. MUST be less than or equal to **colLast**. + +**colLast (1 byte):** A ColByte structure that specifies the last zero-based column index in the range. MUST be greater than or equal to **colFirst**. + +### Ref8 + +The **Ref8** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwFirstrwLast
colFirstcolLast
+ +**rwFirst (2 bytes):** A [Rwx](#rwx) structure that specifies the first row in the range. The field **rwFirst.rw** MUST be less than or equal to **rwLast.rw**. + +**rwLast (2 bytes):** A Rwx structure that specifies the last row in the range. The field **rwLast.rw** MUST be greater than or equal to **rwFirst.rw**. If **rwFirst.rw** is 0 and **rwLast.rw** is 0xFFFF, the specified range includes all the rows in the sheet. + +**colFirst (2 bytes):** A [Colx](#colx) structure that specifies the first column in the range. The field **colFirst.col** MUST be less than or equal to **colLast.col**. + +**colLast (2 bytes):** A Colx structure that specifies the last column in the range. The field **colLast.col** MUST be greater than or equal to **colFirst.col**. If **colFirst.col** is 0 and **colLast.col** is 0xFF, the specified range includes all the columns in the sheet. + +### Ref8U + +The **Ref8U** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwFirstrwLast
colFirstcolLast
+ +**rwFirst (2 bytes):** A [RwU](#rwu) structure that specifies the zero-based index of the first row in the range. The value MUST be less than or equal to **rwLast**. + +**rwLast (2 bytes):** A RwU structure that specifies the zero-based index of the last row in the range. The value MUST be greater than or equal to **rwFirst**. + +**colFirst (2 bytes):** A [ColU](#colu) structure that specifies the zero-based index of the first column in the range. The value MUST be less than or equal to **colLast**, and MUST be less than or equal to 0x00FF. + +**colLast (2 bytes):** A ColU structure that specifies the zero-based index of the last column in the range. The value MUST be greater than or equal to **colFirst**, and MUST be less than or equal to 0x00FF. + +### Ref8U2007 + +The **Ref8U2007** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwFirst
rwLast
colFirst
colLast
+ +**rwFirst (4 bytes):** An unsigned integer that specifies the zero-based index of the first row in the range. The value MUST be less than or equal to **rwLast** and MUST be less than or equal to 0xFFFF. + +**rwLast (4 bytes):** An unsigned integer that specifies the zero-based index of the last row in the range. The value MUST be greater than or equal to **rwFirst** and MUST be less than or equal to 0xFFFF. + +**colFirst (4 bytes):** An unsigned integer that specifies the zero-based index of the first column in the range. The value MUST be less than or equal to **colLast** and MUST be less than or equal to 0x00FF. + +**colLast (4 bytes):** An unsigned integer that specifies the zero-based index of the last column in the range. The value MUST be greater than or equal to **colFirst** and MUST be less than or equal to 0x00FF. + +### RefU + +The **RefU** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwFirstrwLast
colFirstcolLast
+ +**rwFirst (2 bytes):** A [RwU](#rwu) structure that specifies the first row in the range. The value MUST be less than or equal to **rwLast**. + +**rwLast (2 bytes):** A RwU structure that specifies the last row in the range. + +**colFirst (1 byte):** A [ColByteU](#colbyteu) structure that specifies the first column in the range. The value MUST be less than or equal to **colLast**. + +**colLast (1 byte):** A ColByteU structure that specifies the last column in the range. + +### RevisionType + +**RevisionType** is an integer that specifies the type of [revision record](#Section_9e91e8bce4f249b897d4741481349d1b). The value MUST be one of the following: + +| Name | Value | Meaning | +|----|----|----| +| **REVTINSRW** | 0x0000 | Insert Row. | +| **REVTINSCOL** | 0x0001 | Insert Column. | +| **REVTDELRW** | 0x0002 | Delete Row. | +| **REVTDELCOL** | 0x0003 | Delete Column. | +| **REVTMOVE** | 0x0004 | [**Cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) Move. | +| **REVTINSERTSH** | 0x0005 | Insert [**Sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). | +| **REVTSORT** | 0x0007 | Sort. | +| **REVTCHANGECELL** | 0x0008 | Cell Change. | +| **REVTRENSHEET** | 0x0009 | Rename Sheet. | +| **REVTDEFNAME** | 0x000A | [**Defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) Change. | +| **REVTFORMAT** | 0x000B | Format Revision. | +| **REVTAUTOFMT** | 0x000C | [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f) Revision. | +| **REVTNOTE** | 0x000D | [**Comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) Revision. | +| **REVTHEADER** | 0x0020 | Header (meta-data) Revision. | +| **REVTCONFLICT** | 0x0025 | Conflict. | +| **REVTADDVIEW** | 0x002B | [**Custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4) Add. | +| **REVTDELVIEW** | 0x002C | Custom view Delete. | +| **REVTTRASHQTFIELD** | 0x002E | [**Query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) field Removal. | + +### RFX + +The **RFX** structure specifies a range of cells on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwFirst
rwLast
colFirst
colLast
+ +**rwFirst (4 bytes):** A [Rw12](#rw12) that specifies the first row in the range. The value of **rwFirst.rw** MUST be less than or equal to **rwLast.rw**. + +**rwLast (4 bytes):** A Rw12 that specifies the last row in the range. The value of **rwLast.rw** MUST be greater than or equal to **rwFirst.rw**. + +**colFirst (4 bytes):** A [Col12](#col12) that specifies the first column in the range. The value of **colFirst.col** MUST be less than or equal to **colLast.col**. + +**colLast (4 bytes):** A Col12 that specifies the last column in the range. The value of **colLast.col** MUST be greater than or equal to **colFirst.col**. + +### RichTextStreamChecksumData + +The **RichTextStreamChecksumData** structure specifies the data used to compute the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the [RichTextStream](#richtextstream) record. This data can be obtained from [Text](#text) record, [FontX](#fontx) record, [Font](#font) record, [BRAI](#brai) record, and [ObjectLink](#objectlink) record associated with the RichTextStream record, as specified in RichTextStream. If no Text record is associated with the RichTextStream record, the Text record associated with the [DefaultText](#defaulttext) record MUST be used. If no Font record is associated with the RichTextStream record, the first Font record specified in the [global substream](#Section_ca4c174887294a93abb94602b3a01fb1) MUST be used. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
fibFontInformation (variable)
...
ABCbTextRotationDEFGHIJKLbSeriesIdentifier
MNObTextFormatStText (variable)
...
fibFontInformationArray (variable)
...
+ +**fibFontInformation (variable):** A [RichTextStreamChecksumFontInformation](#richtextstreamchecksumfontinformation) structure that specifies the default [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information to use for the rich text string. + +**A - fAutoSize (1 bit):** A bit that specifies whether the font size is automatic. MUST be equal to 1 if the value of the **iFont** field of the related FontX record is 0. Otherwise, MUST be equal to 0. If no FontX record is associated with the RichTextStream record, MUST be equal to 0. + +**B - fAutoColor (1 bit):** A bit that specifies whether the foreground text color is determined automatically. MUST be equal to the value of the **fAutoColor** field of the related Text record. + +**C - fAutoMode (1 bit):** A bit that specifies if the background color is determined automatically. MUST be equal to the value of the **fAutoMode** field of the related Text record. + +**bTextRotation (8 bits):** An unsigned integer that specifies the text rotation. MUST be equal to the value of the **trot** field of the related Text record. + +**D - fAutoRot (1 bit):** MUST be zero. + +**E - reserved1 (1 bit):** MUST be 1, and MUST be ignored. + +**F - iReadingOrder (2 bits):** An unsigned integer that specifies the text [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361). MUST be equal to the value of the **iReadingOrder** field of the related Text record. + +**G - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**H - fAttached (1 bit):** A bit that specifies whether the text position is absolute or attached. If the RichTextStream record is contained in the sequence of records that conforms to the [LD](#chart-sheet-substream) rule, this field MUST be 1. If the RichTextStream is not contained in the LD rule, and the **dlp** field of the associated Text record is set to 0xA, this field MUST be 1. Otherwise, it MUST be 0. + +**I - fUserPos (1 bit):** A bit that specifies whether the text position is automatic. If the value is 0, the text position is automatic. If the **dlp** field of the associated Text record is set to 0xA, this field MUST be 1. Otherwise, it MUST be 0. + +**J - bObjectType (4 bits):** An unsigned integer that specifies the object type. Based on the record the RichTextStream is associated with, the value MUST be from the following table: + +| Record associated with RichTextStream | Value | Meaning | +|----|----|----| +| [Chart](#chart-2) | 0x1 | Default text associated with the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). | +| [Axis](#axis-1) where **wType** is 0x0001 | 0x2 | [Attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a) of the value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) (or the vertical value axis) in the primary axis group. | +| Axis where **wType** is 0x0000 | 0x3 | Attached label of the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) axis (or the horizontal value axis) in the primary axis group. | +| [Series](#series-1) | 0x4 | Attached label of the [series](#Section_527ce4dfc9f84e50a314d4b07519593c). | +| [Legend](#legend-1) | 0x5 | Attached label of the [legend](#Section_1832229b7d1945f488d455e9c07466f0). | +| Axis where **wType** is 0x0003 | 0x7 | Attached label of the series axis. | +| Second Axis record where **wType** is 0x0001 | 0x8 | Attached label of the value axis (or the vertical value axis) in the secondary axis group. | +| Second Axis record where **wType** is 0x0000 | 0x9 | Attached label of the category axis (or the horizontal value axis) in the secondary axis group. | +| [DataTable](#dat) | 0xB | Attached label of the chart DataTable. | +| [YMult](#ymult) | 0xC | Attached label of the axis multiplier. | + +**K - fBuildable (1 bit):** A bit that specifies whether the text value of the Text record associated with the RichTextStream is automatically generated and unchanged. MUST be equal to the value of the **fAutoText** field of the related Text record. + +**L - reserved3 (1 bit):** MUST be zero, and MUST be ignored. + +**bSeriesIdentifier (8 bits):** An unsigned integer that specifies the zero-based index of the Series record of the current chart to which the attached label is attached. + +**M - reserved4 (2 bits):** MUST be 0x3, and MUST be ignored. + +**N - fReference (2 bits):** An unsigned integer that specifies the type of data that is being referenced. MUST be equal to the value of the **rt** field of the BRAI record associated with the RichTextStream. + +**O - stSource (4 bits):** An unsigned integer that specifies the part of the series, [trendline](#Section_61d74ebc36714d6dbdc0626db604530d), or [error bars](#Section_762a461d0a45474ebd7d5994bb294af2) the referenced data of the BRAI record associated with the RichTextStream specifies. MUST be equal to the value of the **id** field of the BRAI record associated with the RichTextStream. + +**bTextFormat (8 bits):** An [IFmt](#ifmt) that specifies the number formatting used for the data. MUST be equal to the value of the **ifmt** field of the BRAI record associated with the RichTextStream. + +**StText (variable):** An array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters that contains the text content of the rich text. This field only takes the text content into consideration and ignores the size and header fields of the text string. If the RichTextStream is associated with a BRAI record, the text value MUST correspond to the text value identified by the BRAI record. If the RichTextStream record is associated with an ObjectLink record, the text value MUST correspond to the text value identified by the ObjectLink record. + +**fibFontInformationArray (variable):** An array of [RichTextStreamChecksumFontInformationArrayItem](#richtextstreamchecksumfontinformationarrayitem) that specifies the formatting of the **StText** field. + +### RichTextStreamChecksumFontInformation + +The **RichTextStreamChecksumFontInformation** structure specifies the data used to compute the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the [RichTextStream](#richtextstream) record. This data can be obtained from [Text](#text) and [Font](#font) records associated with the RichTextStream record, as specified in RichTextStream. If no Text record is associated with the RichTextStream record, the Text record associated with the [DefaultText](#defaulttext) record MUST be used. If no Font record is associated with the RichTextStream record, the first Font record specified in the [global substream](#Section_ca4c174887294a93abb94602b3a01fb1) MUST be used. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
stFontName (variable)
...
dwFontHeight
ABCDEFGHIJKreserved1boldness
subscriptbUnderlinebFamily
bCharsetreserved2rgbFontColor
...dwDrawingMode
...
+ +**stFontName (variable):** An array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters that contains the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) name. MUST be the font name specified by the **fontName** field of the related Font record. + +**dwFontHeight (4 bytes):** An unsigned integer that specifies the font height. MUST equal the value specified by the **dyHeight** field of the related Font record. + +**A - fBold (1 bit):** A bit that specifies whether the font is bold. The value of this field MUST be 1 when the value of the **bls** field of the associated Font record is greater than 400. + +**B - fItalic (1 bit):** A bit that specifies whether the font is italic. MUST equal the value specified by the **fItalic** field of the related Font record. + +**C - fUnderline (1 bit):** A bit that specifies whether the font is single-underlined. The value of this field MUST be 1 when the value of the **uls** field of the associated Font record is not equal to 0x00. + +**D - fOutline (1 bit):** A bit that specifies whether the font has an [**outline effect**](#gt_4e818802-fdc1-4227-b32f-1a3cb0943de7) applied. MUST equal the value specified by the **fOutline** field of the related Font record. + +**E - fShadow (1 bit):** A bit that specifies whether the font has a [**shadow effect**](#gt_83056968-00f2-463b-abc6-607dbb242cbf) applied. MUST equal the value specified by the **fShadow** field of the related Font record. + +**F - fCondense (1 bit):** A bit that specifies whether the font is condensed. MUST equal the value specified by the **fCondense** field of the related Font record. + +**G - fExtend (1 bit):** A bit that specifies whether the font is extended. MUST equal the value specified by the **fExtend** field of the related Font record + +**H - fStrikeout (1 bit):** A bit that specifies whether the font has [**strikethrough formatting**](#gt_b16d9600-aebb-4a4f-bf14-c38e13c11c14) applied. MUST equal the value specified by the **fStrikeOut** field of the related Font record. + +**I - fRegular (1 bit):** A bit that specifies whether the font is a regular font. MUST equal 1. + +**J - fJon (1 bit):** A bit that specifies whether the font is too small to be displayed. MUST equal 1 if the font height in [**pixels**](#gt_fe932605-d3bc-442f-9239-594676bce6ba) is less than 6. + +**K - fDialogBox (1 bit):** A bit that specifies whether the font is used in the context of a dialog box. MUST equal 0. + +**reserved1 (5 bits):** MUST be zero, and MUST be ignored. + +**boldness (2 bytes):** An unsigned integer that specifies the font weight. MUST equal the value specified by the **bls** field of the related Font record. + +**subscript (2 bytes):** An unsigned integer that specifies whether superscript, subscript, or normal script is used. MUST equal the value specified by the **sss** field of the related Font record. + +**bUnderline (1 byte):** An unsigned integer that specifies the underline style. MUST equal the value specified by the **uls** field of the related Font record. + +**bFamily (1 byte):** An unsigned integer that specifies the [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2) of this font. MUST equal the value specified by the **bFamily** field of the related Font record. + +**bCharset (1 byte):** An unsigned integer that specifies the [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204). MUST equal the value specified by the **bCharSet** field of the related Font record. + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +**rgbFontColor (4 bytes):** A [LongRGB](#longrgb) that specifies the font color. MUST equal the color specified by the **icv** field of the related Font record. + +**dwDrawingMode (4 bytes):** An unsigned integer that specifies the display mode of the background of the text. MUST be equal to 0x0000010D when the **wBkgMode** field of the related Text record is equal to 0x0001; otherwise, it MUST be equal to 0x0000020D. + +### RichTextStreamChecksumFontInformationArrayItem + +The **RichTextStreamChecksumFontInformationArrayItem** structure specifies data used to compute the checksum of the [RichTextStream](#richtextstream) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iIndexfibFontInformation (variable)
...
+ +**iIndex (2 bytes):** An unsigned integer that specifies a zero-based index of the character within the **StText** field of the containing [RichTextStreamChecksumData](#richtextstreamchecksumdata) structure where the text formatting specified in **fibFontInformation** begins. + +**fibFontInformation (variable):** A [RichTextStreamChecksumFontInformation](#richtextstreamchecksumfontinformation) that specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) formatting of the text string starting at the **iIndex** character. + +### RkNumber + +The **RkNumber** structure specifies a numeric value. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABnum
+ +**A - fX100 (1 bit):** A bit that specifies whether **num** is the value of the RkNumber or 100 times the value of the RkNumber. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------------------| +| 0 | The value of RkNumber is the value of **num**. | +| 1 | The value of RkNumber is the value of **num** divided by 100. | + +**B - fInt (1 bit):** A bit that specifies the type of **num**. + +**num (30 bits):** A variable type field whose type and meaning is specified by the value of **fInt**, as defined in the following table: + +| Value of fInt | Type of num | +|----|----| +| 0 | **num** is the 30 most significant bits of a 64-bit binary floating-point number as defined in [\[IEEE754\]](https://go.microsoft.com/fwlink/?LinkId=89903). The remaining 34-bits of the floating-point number MUST be 0. | +| 1 | **num** is a signed integer. | + +### RkRec + +The **RkRec** structure contains the numeric data in an application-specific internal type for optimizing disk and memory space along with the corresponding [IXFCell](#ixfcell) to the style record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ixfeRK
...
+ +**ixfe (2 bytes):** An IXFCell that specifies the format of the numeric value. + +**RK (4 bytes):** An [RkNumber](#rknumber) that specifies the numeric value. + +### RPHSSub + +The **RPHSSub** structure specifies a [**phonetic string**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cruncch
st (variable)
...
+ +**crun (2 bytes):** An unsigned integer that specifies the number of [**phonetic text runs**](#gt_02ee536f-14c0-451a-9d66-111431897cac). MUST be less than or equal to 32767. If **crun** is zero, there is one phonetic text run. + +**cch (2 bytes):** An unsigned integer that specifies the number of characters in the phonetic string. MUST be less than or equal to 32767. + +**st (variable):** An [LPWideString](#lpwidestring) that specifies the phonetic string. The character count in the string MUST be **cch**. + +### RRD + +The **RRD** structure specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cbMemory
revid
revtABCDreserved
tabid
+ +**cbMemory (4 bytes):** An unsigned integer that specifies the size in bytes of the corresponding revision record structure in memory. This is different from the size of the structure written to the file. The value MUST be greater than or equal to 26. MUST be ignored if the current record is [RRDHead](#rrdhead). + +**revid (4 bytes):** A signed integer that specifies the revision identifier of the revision records. This identifier is used to keep track of the order of revision records. MUST be greater than or equal to 0. + +**revt (2 bytes):** A [RevisionType](#revisiontype) that specifies the type of revision record. + +**A - fAccepted (1 bit):** A bit that specifies whether this revision was reviewed and accepted. + +**B - fUndoAction (1 bit):** A bit that specifies whether the revision occurred because of an undo action. + +**C - unused (1 bit):** Undefined and MUST be ignored. + +**D - fDelAtEdgeOfSort (1 bit):** A bit that specifies whether the row or column that is being deleted is at the edge of a sorted [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). If the value is 1, the current record MUST be [RRDInsDel](#rrdinsdel) and **revt** MUST be equal to **REVTINSRW** or **REVTINSCOL** or **REVTDELRW** or **REVTDELCOL**. + +**reserved (12 bits):** MUST be zero, and MUST be ignored. + +**tabid (2 bytes):** A [TabId](#tabid) that specifies the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) where the revision occurred. If the value is 0xFFFF, this revision does not correspond to a specific sheet. + +### RRDDefNameFlags + +The **RRDDefNameFlags** structure specifies additional information for [RRDDefName](#rrddefname). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cceABfGrpchKey
CDEFGreserved
+ +**cce (2 bytes):** An unsigned integer that specifies the length of a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in RRDDefName. + +**A - fPli (1 bit):** A bit that specifies that one or more of the fields **stDescription**, **stHelpTopic**, **stCustomMenu**, **stStatusText**, **stDescriptionOld**, **stHelpTopicOld**, **stCustomMenuOld** or **stStatusTextOld** specified in the RRDDefName record MUST NOT be empty. + +**B - fFunc (1 bit):** A bit that specifies whether the RRDDefName record specifies a name that refers to a function. + +**fGrp (6 bits):** An unsigned integer that specifies the [**function category**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) for the [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). MUST be a value from the following table: + +| Value | Category | +|-------|---------------------------------------------------------------| +| 0 | All | +| 1 | Financial | +| 2 | Date Time | +| 3 | Math Trigonometry | +| 4 | Statistical | +| 5 | Lookup | +| 6 | Database | +| 7 | Text | +| 8 | Logical | +| 9 | Info | +| 10 | Commands | +| 11 | Customize | +| 12 | [**Macro**](#gt_cd2933d3-08d1-4931-bd5c-7ae0a668fe7c) Control | +| 13 | [**DDE**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) External | +| 14 | User Defined | + +**chKey (8 bits):** An unsigned integer that specifies the shortcut key. MUST have same restrictions as the **chKey** field from the [Lbl](#lbl) record. + +**C - fHidden (1 bit):** A bit that specifies whether the defined name is hidden. + +**D - fCustomMenu (1 bit):** A bit that specifies whether the **stCustomMenu** field from the RRDDefName record is not empty. + +**E - fDescription (1 bit):** A bit that specifies whether the **stDescription** field from the RRDDefName record is not empty. + +**F - fHelpTopic (1 bit):** A bit that specifies whether the **stHelpTopic** field from the RRDDefName record is not empty. + +**G - fStatusText (1 bit):** A bit that specifies whether the **stStatusText** field from the RRDDefName record is not empty. + +**reserved (11 bits):** MUST be zero, and MUST be ignored. + +### RRLoc + +The **RRLoc** structure specifies the location of a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwcol
+ +**rw (2 bytes):** A [RwU](#rwu) structure that specifies the zero-based index of the row. + +**col (2 bytes):** A [ColElfU](#colelfu) structure that specifies the zero-based index of the column and other information about this cell reference. + +### RTDEItem + +The **RTDEItem** structure specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with an [**RTD topic**](#gt_1b5b3428-25ab-4aa9-bbee-c1c147ece9de). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwcol
itab
+ +**rw (2 bytes):** A [Rw](#rw) structure that specifies the row index of the cell. + +**col (2 bytes):** A [Col](#col) structure that specifies the column index of the cell. + +**itab (2 bytes):** A [TabIndex](#tabindex) structure that specifies the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing the cell. + +### RTDOper + +The **RTDOper** structure specifies the variant data returned from an [**RTD server**](#gt_d4fc2cb5-c030-4ce4-9078-69627d562fc7) for [**real-time data (RTD)**](#gt_1e71aa16-cd0f-4271-b57d-1fd99d8740b6). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
grbit
rtdVt (variable)
...
+ +**grbit (4 bytes):** An unsigned integer that specifies the type of the variant data stored in **rtdVt**. MUST be a value from the following table: + +| Value | rtdVt Data Type | Meaning | +|----|----|----| +| 0x00000001 | Xnum | The returned variant is an Xnum (section [2.5.342](#xnum)). | +| 0x00000002 | [RTDOperStr](#rtdoperstr) | The returned variant is a RTDOperStr. MUST be less than 256 characters long. | +| 0x00000004 | Boolean | The returned variant is a 4-byte Boolean (section [2.5.14](#boolean)) value. | +| 0x00000010 | Signed integer | The returned variant is a 4-byte signed integer indicating an error code. | +| 0x00000800 | Signed integer | The returned variant is a 4-byte signed integer used for purposes other than an error code. | +| 0x00001000 | RTDOperStr | The returned variant is a RTDOperStr. MUST be greater than or equal to 256 characters long. | + +**rtdVt (variable):** A structure that contains the variant data. The meaning of the data depends on the specific RTD server. The type of the variant data is specified by **grbit**. + +### RTDOperStr + +The **RTDOperStr** structure specifies a string used in a [**real-time data (RTD)**](#gt_1e71aa16-cd0f-4271-b57d-1fd99d8740b6) variant data structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cchRTDOperStr
rgchRTDOperStr (variable)
...
+ +**cchRTDOperStr (4 bytes):** An unsigned integer that specifies the number of characters in **rgchRTDOperStr**. + +**rgchRTDOperStr (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) that specifies the string. + +### Run + +The **Run** structure specifies formatting information for a [**text run**](#gt_393612a7-9552-48b0-abf6-0371dbd6d553). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
formatRun
unused1unused2
+ +**formatRun (4 bytes):** A [FormatRun](#formatrun). It specifies the formatting information of this run. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +### Rw + +The **Rw** structure specifies the zero-based row index of a row in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
rw
+ +**rw (2 bytes):** An unsigned integer that specifies the zero-based row index of a row in the sheet that contains this structure. MUST be greater than or equal to the **rwMic** field of the [Dimensions](#dimensions) record of the sheet that contains this structure and MUST be less than the **rwMac** field of the Dimensions record of the sheet that contains this structure. + +### Rw12 + +The **Rw12** structure specifies the zero-based row index of a row in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rw
+ +**rw (4 bytes):** A signed integer that specifies a zero-based row index of the sheet. MUST be greater than or equal to zero and MUST be less than or equal to 0x0FFFFF. + +### RwLongU + +The **RwLongU** structure specifies the zero-based index of a row in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rw
+ +**rw (4 bytes):** An unsigned integer that specifies the zero-based index of a row in the sheet that contains this structure. MUST be less than or equal to 0x0000FFFF. + +### RwU + +The **RwU** structure specifies the zero-based index of a row in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
rw
+ +**rw (2 bytes):** An unsigned integer that specifies the zero-based index of a row in the sheet that contains this structure. + +### Rwx + +The **Rwx** structure specifies the zero-based row index of a row in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
rw
+ +**rw (2 bytes):** An unsigned integer that specifies the zero-based row index of a row in the sheet that contains this structure. MUST be 0, 0xFFFF, or greater than or equal to the **rwMic** field of the [Dimensions](#dimensions) record of the sheet that contains this structure and less than the **rwMac** field of the Dimensions record of the sheet that contains this structure. + +### Script + +The **Script** enumeration specifies the superscript or subscript style. + +| Name | Value | Meaning | +|--------------|--------|---------------| +| **SSSNONE** | 0x0000 | Normal script | +| **SSSSUPER** | 0x0001 | Superscript | +| **SSSSUB** | 0x0002 | Subscript | + +### SD_SetSortOrder + +The **SD_SetSortOrder** enumeration specifies the types of [MDX set metadata](#Section_84d4d0b542b6405ea07be3272dc517f8) sorting orders. + +| Name | Value | Meaning | +|----|----|----| +| **SSONONE** | 0x00 | No sorting order | +| **SSOASC** | 0x01 | Ascending order | +| **SSODESC** | 0x02 | Descending order | +| **SSOALPHAASC** | 0x03 | Ascending order by the caption | +| **SSOALPHADESC** | 0x04 | Descending order by the caption | +| **SSONATURALASC** | 0x05 | Ascending order by the natural order of the data, for example, by a key | +| **SSONATURALDESC** | 0x06 | Descending order by the natural order of the data, for example, by a key | + +### SDContainer + +The **SDContainer** structure specifies security information for a [FeatProtection](#featprotection) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cbSD
sd (variable)
...
+ +**cbSD (4 bytes):** An unsigned integer that specifies the size of the **sd** field in bytes. MUST be greater than 20. + +**sd (variable):** A [SecurityDescriptor](#securitydescriptor) that specifies the [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) data. + +### SecurityDescriptor + +A SECURITY_DESCRIPTOR structure, as defined in [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) section [2.4.6](http://msdn.microsoft.com/en-us/library/7d4dac05-9cef-4563-a058-f108abecce1d/), that specifies a [**relative security descriptor**](#gt_4a4a182d-a2d3-4cae-9a82-359ff9dc6b2c) that specifies security information associated with an object. For more information about relative security descriptors see [\[MSDN-ASRSD\]](https://go.microsoft.com/fwlink/?LinkId=119907). + +### ShapePropsStreamChecksumData + +The **ShapePropsStreamChecksumData** structure specifies the data used to compute the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the [ShapePropsStream](#shapepropsstream) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
linePropertiesForChecksum
...
interiorColorPropertiesForChecksum
...
...fillStylePropertiesForChecksum (variable)
...
+ +**linePropertiesForChecksum (8 bytes):** A [LinePropertiesForShapePropsStreamChecksum](#linepropertiesforshapepropsstreamchecksum) that specifies the line properties data used to compute the checksum of the ShapePropsStream record. + +This field MUST be present in the following scenarios: + +- When the ShapePropsStream record and [LineFormat](#lineformat) record exist in a [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) but not in a sequence of records that conforms to the [LD](#chart-sheet-substream) rule or a sequence of records that conforms to the DROPBAR rule; + +- When the ShapePropsStream record and LineFormat record exist in a sequence of records that conforms to the FRAME rule; + +- When the ShapePropsStream record and LineFormat record exist in a sequence of records that conforms to the DROPBAR rule; + +- When the ShapePropsStream record and LineFormat record exist in a sequence of records that conforms to the AXS rule; + +- When the ShapePropsStream record and LineFormat record exist in a sequence of records that conforms to the SS rule and the **wObjContext** field of the ShapePropsStream record is 0x0000; + +This field MUST NOT be present otherwise. + +**interiorColorPropertiesForChecksum (9 bytes):** An [InteriorColorPropertiesForShapePropsStreamChecksum](#interiorcolorpropertiesforshapepropsstreamchecksum) that specifies the interior color data used to compute the checksum of the ShapePropsStream record. This field MUST be present in the following scenarios: + +- When the ShapePropsStream record and [AreaFormat](#areaformat) record exist in sequence of records that conforms to the FRAME rule and the fAuto field of the AreaFormat record is 0x0 and the [GelFrame](#gelframe) record does not exist in the sequence of records; + +- When the ShapePropsStream record and AreaFormat record exist in a sequence of records that conforms to the DROPBAR rule and the fAuto field of the AreaFormat record is 0x0 and the GelFrame record does not exist in the sequence of records; + +- When the ShapePropsStream record and AreaFormat record exist in a sequence of records that conforms to the AXS rule and the **wObjContext** field of the ShapePropsStream record is 0x0003 and the fAuto field of the AreaFormat record is 0x0 and the GelFrame record does not exist in the sequence of records; + +- When the ShapePropsStream record and AreaFormat record exist in a sequence of records that conforms to the SS rule and the fAuto field of the AreaFormat record is 0x0 and the GelFrame record does not exist in the sequence of records and the **wObjContext** field of the ShapePropsStream record is 0x0000; + +- When the ShapePropsStream record, AreaFormat record, and [MarkerFormat](#markerformat) record exist in a sequence of records that conforms to the SS rule and the GelFrame record does not exist in the sequence of records and the **wObjContext** field of the ShapePropsStream record is 0x0001. + +This field MUST NOT be present otherwise. + +**fillStylePropertiesForChecksum (variable):** A [FillStylePropertiesForShapePropsStreamChecksum](#fillstylepropertiesforshapepropsstreamchecksum) that specifies the fill-style data used to compute the checksum of the ShapePropsStream record. This field MUST be present in the following scenarios: + +- When the ShapePropsStream record, AreaFormat record, and GelFrame record exist in a sequence of records that conforms to the FRAME rule and the fAuto field of the AreaFormat record is 0x0; + +- When the ShapePropsStream record, AreaFormat record, and GelFrame record exist in a sequence of records that conforms to the DROPBAR rule and the fAuto field of the AreaFormat record is 0x0; + +- When the ShapePropsStream record, AreaFormat record, and GelFrame record exist in a sequence of records that conforms to the AXS rule and the **wObjContext** field of the ShapePropsStream record is 0x0003 and the fAuto field of the AreaFormat record is 0x0; + +- When the ShapePropsStream record, AreaFormat record, and GelFrame record exist in a sequence of records that conforms to the SS rule and the fAuto field of the AreaFormat record is 0x0 and the **wObjContext** field of the ShapePropsStream record is 0x0000; + +- When the ShapePropsStream record, AreaFormat record, MarkerFormat record, and GelFrame record sequence of records that conforms to the SS rule and the fAuto field of the AreaFormat record is 0x0 and the **wObjContext** field of the ShapePropsStream record is 0x0001. + +This field MUST NOT be present otherwise. + +### SharedFeatureType + +The **SharedFeatureType** enumeration specifies the different types of [Shared Features](#Section_86882c8e8d6d46b3aafe006b9e1f18e2). + +| Name | Value | Meaning | +|----|----|----| +| **ISFPROTECTION** | 0x0002 | Specifies the enhanced protection type. A Shared Feature of this type is used to protect a [**shared workbook**](#gt_241c4cae-c49a-438a-87dc-c8fb2c871921) by restricting access to the areas of the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and to the available functionality. | +| **ISFFEC2** | 0x0003 | Specifies the ignored formula errors type. A Shared Feature of this type is used to specify the formula errors to be ignored. | +| **ISFFACTOID** | 0x0004 | Specifies the [**smart tag**](#gt_2f57a49a-d503-4605-8798-0e53bd637609) type. A Shared Feature of this type is used to recognize certain types of entries (for example, proper names, dates/times, financial symbols) and flag them for action. | +| **ISFLIST** | 0x0005 | Specifies the list type. A Shared Feature of this type is used to describe a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) within a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). | + +### SheetExtOptional + +The **SheetExtOptional** structure specifies [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) specific data including [**sheet tab**](#gt_3b131045-238c-4ce8-9c22-b6aac874c7c5) color and the [**published**](#gt_8ffc383a-d4f1-4515-a8b5-874d84ab2d2b) state of this sheet. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
icvPlain12ABreserved
color (16 bytes)
...
...
+ +**icvPlain12 (7 bits):** An unsigned integer that specifies the tab color of this sheet. If the tab has a color assigned to it, the value of this field MUST be greater than or equal to 0x08 and less than or equal to 0x3F, as specified in the color table for [Icv](#icv). If this value does not equal to **icvPlain** of the associated [SheetExt](#sheetext), the value of **icvPlain** takes precedence. If the tab has no color assigned to it, the value of this field MUST be 0x7F, and MUST be ignored. + +**A - fCondFmtCalc (1 bit):** A bit that specifies whether [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) formulas are evaluated. MUST be one of the following: + +| Value | Meaning | +|----|----| +| 0 | Conditional formatting formulas in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) are not evaluated. | +| 1 | Conditional formatting formulas in this workbook are evaluated. | + +**B - fNotPublished (1 bit):** A bit that specifies whether this sheet is published. MUST be ignored when this sheet is a [chart sheet](#chart-sheet-substream), [dialog sheet](#dialog-sheet-substream), or [macro sheet](#macro-sheet-substream). MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------| +| 0 | The sheet is published. | +| 1 | The sheet is not published. | + +**reserved (23 bits):** MUST be zero, and MUST be ignored. + +**color (16 bytes):** A [CFColor](#cfcolor) that specifies the tab color. Used only when the tab color was not modified by earlier versions of the application. + +### ShortDTR + +The **ShortDTR** structure specifies date and time. The **year**, **month**, and **day** values MUST be consistent with the Gregorian calendar. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
yearmonthday
hourminutesecondweekday
+ +**year (2 bytes):** An unsigned integer that specifies the year. MUST be greater than or equal to 1900 and less than or equal to 9999. + +**month (1 byte):** An unsigned integer that specifies the month. MUST be greater than or equal to 1 and less than or equal to 12. + +**day (1 byte):** An unsigned integer that specifies the day. MUST be greater than or equal to 1 and less than or equal to 31. + +**hour (1 byte):** An unsigned integer that specifies the hour. MUST be greater than or equal to 0 and less than or equal to 23. + +**minute (1 byte):** An unsigned integer that specifies the minute. MUST be greater than or equal to 0 and less than or equal to 59. + +**second (1 byte):** An unsigned integer that specifies the second. MUST be greater than or equal to 0 and less than or equal to 59. + +**weekday (1 byte):** An unsigned integer that specifies the weekday. The value MUST be one of the following: + +| Value | Meaning | +|-------|-------------------------------| +| 0 | The weekday is not specified. | +| 1 | Monday | +| 2 | Tuesday | +| 3 | Wednesday | +| 4 | Thursday | +| 5 | Friday | +| 6 | Saturday | +| 7 | Sunday | + +### ShortXLUnicodeString + +The **ShortXLUnicodeString** structure specifies a Unicode string. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cchAreservedrgb (variable)
...
+ +**cch (1 bytes):** An unsigned integer that specifies the count of characters in the string. + +**A - fHighByte (1 bit):** A bit that specifies whether the characters in **rgb** are double-byte characters. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | All the characters in the string have a high byte of 0x00 and only the low bytes are in **rgb**. | +| 0x1 | All the characters in the string are saved as double-byte characters in **rgb**. | + +**reserved (7 bits):** MUST be zero, and MUST be ignored. + +**rgb (variable):** An array of bytes that specifies the characters. If **fHighByte** is 0x0, the size of the array MUST be equal to the value of **cch**. If **fHighByte** is 0x1, the size of the array MUST be equal to the value of **cch\***2. + +### SLCO8 + +The **SLCO8** structure specifies a reference to a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a [SCENARIO](#scenario) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rwcol
+ +**rw (2 bytes):** A [RwU](#rwu) structure that specifies the zero-based index of the row of the cell. + +**col (2 bytes):** A [ColSlco8U](#colslco8u) structure that specifies the zero-based index of the column of the cell and other information about this cell reference. + +### SortCond12 + +The **SortCond12** structure specifies the sort conditions. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
AsortOnreservedrfx (16 bytes)
...
...
...condData (variable)
...
cchSt
stSslist (variable)
...
+ +**A - fSortDes (1 bit):** A bit that specifies whether to sort in descending order. + +**sortOn (4 bits):** An unsigned integer that specifies the kind of sort to perform. MUST be a value listed in the Sort On Value column in the table for **condData**. + +**reserved (11 bits):** MUST be zero, and MUST be ignored. + +**rfx (16 bytes):** An [RFX](#rfx) that specifies the sort range of cells on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**condData (variable):** A structure that specifies the conditional data information. The data type of this structure depends on the value of the **sortOn** field and MUST be a value from the following table: + +| Sort On Value | Data Type | +|---------------|---------------------------------| +| 0x0 | [CondDataValue](#conddatavalue) | +| 0x1 | CondDataValue | +| 0x2 | CondDataValue | +| 0x3 | [CFFlag](#cfflag) | + +**cchSt (4 bytes):** A signed integer that specifies the character count in **stSslist**. MUST be greater than or equal to zero. MUST be zero and ignored if **sortOn** is not equal to zero. + +**stSslist (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) that specifies the custom sort list string. It exists only if **cchSt** is greater than zero. + +### SortItem + +The **SortItem** structure specifies the sort mapping from the old row/column index (before sort action) to the new row/column index (after sort action). An array of these structures is contained within a [RRSort](#rrsort) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iNewIndex
iOldIndex
+ +**iNewIndex (4 bytes):** An unsigned integer that specifies the new zero-based index of row or column. If the **fCol** field of the RRSort record that contains this structure is zero, then this value is a zero-based row index and MUST be within the range of rows specified in the **ref8** field of the RRSort record that contains this structure. If the **fCol** field of the RRSort record that contains this structure is 1, then this value is a zero-based column index and MUST be within the range of columns specified in the **ref8** field of the RRSort record that contains this structure. + +**iOldIndex (4 bytes):** An unsigned integer that specifies the old zero-based index of row or column. If the **fCol** field of the RRSort record that contains this structure is zero, then this value is a zero-based row index and MUST be within the range of rows specified in the **ref8** field of the RRSort record that contains this structure. If the **fCol** field of the RRSort record that contains this structure is 1, then this value is a zero-based column index and MUST be within the range of columns specified in the **ref8** field of the RRSort record that contains this structure. + +### SourceType + +The **SourceType** enumeration specifies the source type for a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +| Name | Value | Meaning | +|----|----|----| +| **LTRANGE** | 0x00000000 | [**Range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) | +| **LTSHAREPOINT** | 0x00000001 | Read/write Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list | +| **LTXML** | 0x00000002 | [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) Mapper data | +| **LTEXTERNALDATA** | 0x00000003 | External [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) ([**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289))[\<180\>](#Appendix_A_180) | + +### SQElfFlags + +The **SQElfFlags** structure specifies additional undo data associated with a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cLocAB
+ +**cLoc (30 bits):** An unsigned integer that specifies the number of elements in the **rgloc** field of the [Duce](#duce) structure that contains this structure. MUST be greater than or equal to 0x000000002 and less than or equal to 0x3FFFFFFF. + +**A - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**B - fRel (1 bit):** A bit that specifies whether [**relative references**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) are used. + +### SqRef + +The **SqRef** structure specifies a sequence of [Ref8](#ref8) structures on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
crefrgrefs (variable)
...
+ +**cref (2 bytes):** An unsigned integer that specifies the number of elements in **rgrefs**. MUST be less than or equal to 0x2000. + +**rgrefs (variable):** An array of Ref8 structures. The number of elements in the array MUST be equal to **cref**. + +### SqRefU + +The **SqRefU** structure specifies a sequence of [Ref8U](#ref8u) structures on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
crefrgrefs (variable)
...
+ +**cref (2 bytes):** An unsigned integer that specifies the number of elements in **rgrefs**. MUST be less than or equal to 0x2000. + +**rgrefs (variable):** An array of Ref8U structures. The number of elements in the array MUST be equal to **cref**. + +### Stxp + +The **Stxp** structure specifies various formatting attributes of a [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
twpHeight
ts
blssss
ulsbFamilybCharSetunused
+ +**twpHeight (4 bytes):** A signed integer that specifies the height of the font in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382). This value MUST be -1, 0, or between 20 and 8191. This value SHOULD NOT[\<181\>](#Appendix_A_181) be 0. A value of -1 specifies that this field is to be ignored. + +**ts (4 bytes):** A [Ts](#ts) that specifies additional formatting attributes. + +**bls (2 bytes):** A signed integer that specifies the font weight. This value MUST be 0, or a value from the following table. The value SHOULD NOT[\<182\>](#Appendix_A_182) be 0. + +| Value | Description | +|--------|----------------------------------------------------| +| 0xFFFF | Indicates that this specification is to be ignored | +| 0x0190 | Normal font weight | +| 0x02BC | Bold font weight | + +**sss (2 bytes):** A signed integer that specifies whether the superscript or subscript or normal style of the font is used. MUST be set to a value from the following table: + +| Value | Description | +|--------|----------------------------------------------------| +| 0xFFFF | Indicates that this specification is to be ignored | +| 0x0000 | Normal script | +| 0x0001 | Superscript | +| 0x0002 | Subscript | + +**uls (1 byte):** An unsigned integer that specifies the underline style. The value MUST be one of the following: + +| Value | Description | +|-------|-------------------------------------------------------------------| +| 0x00 | No underline | +| 0x01 | Single | +| 0x02 | Double | +| 0x21 | [**single accounting**](#gt_7ad49c0f-e183-47b5-bdbd-c23a5a8315fc) | +| 0x22 | [**double accounting**](#gt_89f4f531-9a8b-419c-8f51-98ef409b7bdf) | +| 0xFF | Indicates that this specification is to be ignored | + +**bFamily (1 byte):** An unsigned integer that specifies the [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2), as defined by Windows API LOGFONT structure in [\[MSDN-FONTS\]](https://go.microsoft.com/fwlink/?LinkId=90008). MUST be greater than or equal to 0 or less than or equal to 5. + +**bCharSet (1 byte):** An unsigned integer that specifies the [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204), as defined by Windows API LOGFONT structure in \[MSDN-FONTS\]. + +**unused (1 byte):** Undefined and MUST be ignored. + +### StyleXF + +The **StyleXF** structure specifies formatting properties for a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
alcAalcVBtrotcIndentCDEunused
dgLeftdgRightdgTopFicvLefticvRightG
icvTopicvBottomicvDiagdgDiagHfls
icvForeicvBackI
+ +**alc (3 bits):** A [**HorizAlign**](#horizalign) that specifies the [**horizontal alignment**](#gt_f0e60ca8-51d5-4553-9126-3d89a4d08f90). + +**A - fWrap (1 bit):** A bit that specifies whether [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) text is wrapped. + +**alcV (3 bits):** A [**VertAlign**](#vertalign) that specifies the [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878). + +**B - fJustLast (1 bit):** A bit that specifies whether the justified or distributed alignment of the cell is used on the last line of text. (Setting this to 1 is typical for East Asian text but not typical in other contexts). If this field equals 1 then **alc** MUST equal 7. + +**trot (1 byte):** An [XFPropTextRotation](#xfproptextrotation) that specifies the text rotation. + +**cIndent (4 bits):** An unsigned integer that specifies the text [**indentation level**](#gt_2779d3df-3c50-44dc-9d2d-6996c4573aa9). MUST be less than or equal to 15. + +**C - fShrinkToFit (1 bit):** A bit that specifies whether a cell is [**shrink to fit**](#gt_4740d2ef-00d3-4a29-983c-b7b3a6aa01e0). + +**D - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**E - iReadOrder (2 bits):** A [**ReadingOrder**](#readingorder) that specifies the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361). + +**unused (1 byte):** Undefined and MUST be ignored. + +**dgLeft (4 bits):** A [BorderStyle](#borderstyle) that specifies the [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad). + +**dgRight (4 bits):** A BorderStyle that specifies the [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) border formatting. + +**dgTop (4 bits):** A BorderStyle that specifies the top border formatting. + +**F - dgBottom (4 bits):** A BorderStyle that specifies the bottom border formatting. + +**icvLeft (7 bits):** An unsigned integer that specifies the color of the logical left [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c). The value MUST be one of the values specified in the **icv** field in [IcvXF](#icvxf) or zero. A value of zero means the left border color is not specified. If this value is zero then **dgLeft** MUST also be zero. + +**icvRight (7 bits):** An unsigned integer that specifies the color of the logical right border. The value MUST be one of the values specified in the **icv** field in IcvXF or zero. A value of zero means the right border color is not specified. If this value is zero then **dgRight** MUST also be zero. + +**G - grbitDiag (2 bits):** An unsigned integer that specifies which diagonal borders are present (if any). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | No diagonal border | +| 0x1 | [**Diagonal-down**](#gt_494c0660-9ece-4dcc-b8d3-1a5616a57782) border | +| 0x2 | [**Diagonal-up**](#gt_d4878a4d-c65e-471d-b9fb-da7a5a5aa929) border | +| 0x3 | Both diagonal-down and diagonal-up | + +**icvTop (7 bits):** An unsigned integer that specifies the color of the top border. The value MUST be one of the values specified in the **icv** field in IcvXF or zero. A value of zero means the top border color was not specified. If this value is zero then **dgTop** MUST also be zero. + +**icvBottom (7 bits):** An unsigned integer that specifies the color of the bottom border. The value MUST be one of the values specified in the **icv** field in IcvXF or zero. A value of zero means the bottom border color was not specified. If this value is zero then **dgBottom** MUST also be zero. + +**icvDiag (7 bits):** An unsigned integer that specifies the color of the diagonal border. The value MUST be one of the values specified in the **icv** field in IcvXF or zero. A value of zero means the diagonal border color has not been specified. If this value is zero then **dgDiag** MUST also be zero. + +**dgDiag (4 bits):** A BorderStyle that specifies the diagonal border formatting. + +**H - reserved2 (1 bit):** MUST be zero and MUST be ignored. + +**fls (6 bits):** A [**FillPattern**](#fillpattern) that specifies the [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e). If this value is 1 which specifies a solid fill pattern only **icvFore** is rendered. + +**icvFore (7 bits):** An IcvXF that specifies the [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) of the fill pattern. + +**icvBack (7 bits):** An unsigned integer that specifies the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) of the fill pattern. The value MUST be an IcvXF value. + +**I - reserved3 (2 bits):** MUST be zero and MUST be ignored. + +### SXAddl_SXDEnd + +The **SXAddl_SXDEnd** record specifies the end of a sequence of [SXAddl](#sxaddl) records that specify information about a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...reserved
...
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr). The **sxd** field of SXAddlHdr MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +### SXAddl_SXDVerUpdInv + +The **SXAddl_SXDVerUpdInv** structure specifies the highest [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) for which records following this record are handled. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
hdr
...dwVersionInvalidatesreserved1
reserved2reserved3
+ +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr). The **sxd** field of SXAddlHdr MUST equal 0x01. + +**dwVersionInvalidates (1 byte):** An unsigned integer that specifies the highest data functionality level for which records following this record are handled. + +MUST be greater than or equal to 0 and less than or equal to 0xFF. If this value is equal to 0xFF, the data functionality level is not set. + +**reserved1 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +### SXAddl_SXString + +The SXAddl_SXString structure specifies a Unicode string segment. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
st (variable)
...
+ +**st (variable):** An [XLUnicodeStringSegmentedSXADDL](#xlunicodestringsegmentedsxaddl) that specifies a Unicode string segment. **st.cchTotal** MUST be less than or equal to 65535. + +### SXAddlHdr + +The **SXAddlHdr** structure specifies header information for an [SXAddl](#sxaddl) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
frtHeaderOld
sxcsxd
+ +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold). The **frtHeaderOld**.**rt** field MUST be 0x0864. + +**sxc (1 byte):** An unsigned integer that specifies the current class. See [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) for details. + +**sxd (1 byte):** An unsigned integer that specifies the type of record contained in the **data** field of the containing SXAddl record. See class for details. + +### SXAxis + +The **SXAxis** structure specifies the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) referred to by the containing record. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ABCDreserved
+ +**A - sxaxisRw (1 bit):** A bit that specifies whether this structure refers to the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +**B - sxaxisCol (1 bit):** A bit that specifies whether this structure refers to the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). + +**C - sxaxisPage (1 bit):** A bit that specifies whether this structure refers to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**D - sxaxisData (1 bit):** A bit that specifies whether this structure refers to the [value axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**reserved (12 bits):** MUST be zero, and MUST be ignored. + +### SXEZDoper + +The **SXEZDoper** structure specifies a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) data operation. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
vtsgrbitSignvtValue
...
...
+ +**vts (1 byte):** An unsigned integer that specifies the type of comparison used in the data operation. MUST be a value in the following table: + +| Value | Meaning | +|----|----| +| 0x00 | This SXEZDoper record is undefined and MUST be ignored. | +| 0x04 | This SXEZDoper specifies a numeric data operation. | +| 0x06 | This SXEZDoper specifies a string data operation. | +| 0x0C | This SXEZDoper specifies that all space characters are matched in the data operation. | +| 0x0E | This SXEZDoper specifies that all non-space characters are matched in the data operation. | + +**grbitSign (1 byte):** An unsigned integer that specifies the comparison operation between a database value and **vtValue**. MUST be one of the following values: + +| Value | Meaning | +|-------|-----------------------------------------------| +| 0x00 | No operation. The **vts** field MUST be zero. | +| 0x01 | Less than | +| 0x02 | Equal to | +| 0x03 | Less than or equal to | +| 0x04 | Greater than | +| 0x05 | Not equal to | +| 0x06 | Greater than or equal to | + +**vtValue (8 bytes):** A field with the type and meaning specified by the value of **vts**, as specified in the following table: + +| Value of vts | vtValue meaning | +|----|----| +| 0x00 | Undefined and MUST be ignored. | +| 0x04 | An Xnum (section [2.5.342](#xnum)) that specifies the numeric value used in the numeric data operation. | +| 0x06 | A [PivotCompProp](#pivotcompprop) that specifies the type of string comparison. | +| 0x0C | Undefined and MUST be ignored. | +| 0x0E | Undefined and MUST be ignored. | + +### SxFT + +The **SxFT** structure specifies the pivot filter types. + +| Name | Value | Meaning | +|----|----|----| +| **SXFTCOUNT** | 0x00000001 | Specifies the "count" filter. This is a [value filter](#Section_05a1c98e21cd4941979880f4bf301bb2). | +| **SXFTPERCENT** | 0x00000002 | Specifies the "percent" filter. This is a value filter. | +| **SXFTSUM** | 0x00000003 | Specifies the "sum" filter. This is a value filter. | +| **SXFTCAPTIONEQUALS** | 0x00000004 | Specifies the "equals" filter. This is a [label filter](#Section_f221b81b892c4b5c91722d4ed17c937c). | +| **SXFTCAPTIONDOESNOTEQUAL** | 0x00000005 | Specifies the "not equal" filter. This is a label filter. | +| **SXFTCAPTIONBEGINSWITH** | 0x00000006 | Specifies the "begins with" filter. This is a label filter. | +| **SXFTCAPTIONDOESNOTBEGINWITH** | 0x00000007 | Specifies the "does not begin with" filter. This is a label filter. | +| **SXFTCAPTIONENDSWITH** | 0x00000008 | Specifies the "ends with" filter. This is a label filter. | +| **SXFTCAPTIONDOESNOTENDWITH** | 0x00000009 | Specifies the "does not end with" filter. This is a label filter. | +| **SXFTCAPTIONCONTAINS** | 0x0000000A | Specifies the "contains" filter. This is a label filter. | +| **SXFTCAPTIONDOESNOTCONTAIN** | 0x0000000B | Specifies the "does not contain" filter. This is a label filter. | +| **SXFTCAPTIONISGREATERTHAN** | 0x0000000C | Specifies the "is greater than" filter. This is a label filter. | +| **SXFTCAPTIONISGREATERTHANOREQUALTO** | 0x0000000D | Specifies the "is greater than or equal to" filter. This is a label filter. | +| **SXFTCAPTIONISLESSTHAN** | 0x0000000E | Specifies the "is less than" filter for field captions. This is a label filter. | +| **SXFTCAPTIONISLESSTHANOREQUALTO** | 0x0000000F | Specifies the "is less than or equal to" filter. This is a label filter. | +| **SXFTCAPTIONISBETWEEN** | 0x00000010 | Specifies the "is between" filter. This is a label filter. | +| **SXFTCAPTIONISNOTBETWEEN** | 0x00000011 | Specifies the "is not between" filter. This is a label filter. | +| **SXFTVALUEEQUAL** | 0x00000012 | Specifies the "value equal" filter. This is a value filter. | +| **SXFTVALUENOTEQUAL** | 0x00000013 | Specifies the "value not equal" filter. This is a value filter. | +| **SXFTVALUEGREATERTHAN** | 0x00000014 | Specifies the "value greater than" filter. This is a value filter. | +| **SXFTVALUEGREATERTHANOREQUAL** | 0x00000015 | Specifies the "value greater than or equal to" filter. This is a value filter. | +| **SXFTVALUELESSTHAN** | 0x00000016 | Specifies the "value less than" filter. This is a value filter. | +| **SXFTVALUELESSTHANOREQUAL** | 0x00000017 | Specifies the "value less than or equal to" filter. This is a value filter. | +| **SXFTVALUEBETWEEN** | 0x00000018 | Specifies the "value between" filter. This is a value filter. | +| **SXFTVALUENOTBETWEEN** | 0x00000019 | Specifies the "value not between" filter. This is a value filter. | +| **SXFTDATEEQUALS** | 0x0000001A | Specifies the "equals" filter. This is a [date filter](#Section_2b9377c5055e4efcbcf587fb13c513bd). | +| **SXFTDATEOLDERTHAN** | 0x0000001B | Specifies the "older than" filter. This is a date filter. | +| **SXFTDATENEWERTHAN** | 0x0000001C | Specifies the "newer than" filter. This is a date filter. | +| **SXFTDATEBETWEEN** | 0x0000001D | Specifies the "between" filter. This is a date filter. | +| **SXFTDATETOMORROW** | 0x0000001E | Specifies the "tomorrow" filter. This is a date filter. | +| **SXFTDATETODAY** | 0x0000001F | Specifies the "today" filter. This is a date filter. | +| **SXFTDATEYESTERDAY** | 0x00000020 | Specifies the "yesterday" filter. This is a date filter. | +| **SXFTDATENEXTWEEK** | 0x00000021 | Specifies the "next week" filter. This is a date filter. | +| **SXFTDATETHISWEEK** | 0x00000022 | Specifies the "this week" filter. This is a date filter. | +| **SXFTDATELASTWEEK** | 0x00000023 | Specifies the "last week" filter. This is a date filter. | +| **SXFTDATENEXTMONTH** | 0x00000024 | Specifies the "next month" filter. This is a date filter. | +| **SXFTDATETHISMONTH** | 0x00000025 | Specifies the "this month" filter. This is a date filter. | +| **SXFTDATELASTMONTH** | 0x00000026 | Specifies the "last month" filter. This is a date filter. | +| **SXFTDATENEXTQUARTER** | 0x00000027 | Specifies the "next quarter" filter. This is a date filter. | +| **SXFTDATETHISQUARTER** | 0x00000028 | Specifies the "this quarter" filter. This is a date filter. | +| **SXFTDATELASTQUARTER** | 0x00000029 | Specifies the "last quarter" filter. This is a date filter. | +| **SXFTDATENEXTYEAR** | 0x0000002A | Specifies the "next year" filter. This is a date filter. | +| **SXFTDATETHISYEAR** | 0x0000002B | Specifies the "this year" filter. This is a date filter. | +| **SXFTDATELASTYEAR** | 0x0000002C | Specifies the "last year" filter. This is a date filter. | +| **SXFTDATEYEARTODATE** | 0x0000002D | Specifies the "year-to-date" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODQUARTER1** | 0x0000002E | Specifies the "first quarter" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODQUARTER2** | 0x0000002F | Specifies the "second quarter" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODQUARTER3** | 0x00000030 | Specifies the "third quarter" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODQUARTER4** | 0x00000031 | Specifies the "fourth quarter" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODJANUARY** | 0x00000032 | Specifies the "January" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODFEBRUARY** | 0x00000033 | Specifies the "February" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODMARCH** | 0x00000034 | Specifies the "March" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODAPRIL** | 0x00000035 | Specifies the "April" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODMAY** | 0x00000036 | Specifies the "May" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODJUNE** | 0x00000037 | Specifies the "June" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODJULY** | 0x00000038 | Specifies the "July" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODAUGUST** | 0x00000039 | Specifies the "August" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODSEPTEMBER** | 0x0000003A | Specifies the "September" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODOCTOBER** | 0x0000003B | Specifies the "October" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODNOVEMBER** | 0x0000003C | Specifies the "November" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODDECEMBER** | 0x0000003D | Specifies the "December" filter. This is a date filter. | +| **SXFTDATENOTEQUAL** | 0x0000003E | Specifies the "not equal" filter. This is a date filter. | +| **SXFTDATEOLDEROREQUAL** | 0x0000003F | Specifies the "older than or equal to" filter. This is a date filter. | +| **SXFTDATENEWEROREQUAL** | 0x00000040 | Specifies the "newer than or equal to" filter. This is a date filter. | +| **SXFTDATENOTBETWEEN** | 0x00000041 | Specifies the "not between" filter. This is a date filter. | + +### SxIvdCol + +The **SxIvdCol** structure specifies a reference to a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) or [data field](#Section_b4187a6caa2d4a9789bd26f394d67592) on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
col
+ +**col (2 bytes):** A signed integer that specifies a pivot field or data field for the column axis of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -2 | This value specifies that the data field is on the column axis. The **sxaxisCol** field of **sxaxis4Data** of the [SxView](#sxview) record of the PivotTable view MUST equal 1 and the **sxaxisData** field of **sxaxis4Data** of the SxView record of the PivotTable view MUST equal zero. | +| 0+ | This value specifies a pivot field index as specified in Pivot Fields**.** The pivot field index specifies a pivot field on the column axis of the PivotTable view. MUST be less than the **cDim** field of the SxView record of the PivotTable view. If the referenced pivot field is not a hidden field in an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) then the **sxaxisCol** field of [SXAxis](#sxaxis) of the [Sxvd](#sxvd) record of the pivot field MUST equal 1. | + +A pivot field is a hidden field if an [SXAddl_SXCField12_SXDVer12Info](#sxaddl_sxcfield12_sxdver12info) record exists for the pivot field, and the **fHiddenLvl** field of the SXAddl_SXCField12_SXDVer12Info record is 1. + +### SxIvdRw + +The **SxIvdRw** structure specifies a reference to a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) or [data field](#Section_b4187a6caa2d4a9789bd26f394d67592) on the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
rw
+ +**rw (2 bytes):** A signed integer that specifies a pivot field or data field for the row axis of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -2 | This value specifies that the data field is on the row axis. The **sxaxisRw** field of **sxaxis4Data** of [SxView](#sxview) record of the PivotTable view MUST equal 1 and the **sxaxisData** field of **sxaxis4Data** of the SxView record of the PivotTable view MUST equal zero. | +| 0+ | This value specifies a pivot field index as specified in Pivot Fields**.** The pivot field index specifies a pivot field on the row axis of the PivotTable view. MUST be less than the **cDim** field of the SxView record of the PivotTable view. If the referenced pivot field is not a hidden field in an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) then the **sxaxisRw** field of [SXAxis](#sxaxis) of the [Sxvd](#sxvd) record of the pivot field MUST equal 1. | + +A pivot field is a hidden field if an [SXAddl_SXCField12_SXDVer12Info](#sxaddl_sxcfield12_sxdver12info) record exists for the pivot field, and the **fHiddenLvl** field of the SXAddl_SXCField12_SXDVer12Info record is 1. + +### SXLIItem + +The **SXLIItem** structure specifies a [pivot line](#Section_76610990666f492791b6d2280f607464) in the [row area](#Section_5594c95e6819461e80706f4b4fdfa091) or [column area](#Section_03aced8c25864e83982a1e3551a563d6) of a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cSicitmTypeA
isxviMacBiDataCDEFGHI
rgisxvi (variable)
...
+ +**cSic (2 bytes):** A signed integer that specifies the count of [pivot item](#Section_58891cc5dd9b4293a97831070779524f) indexes in the beginning of the **rgisxvi** array that are identical to the same number of pivot item indexes in the beginning of the **rgisxvi** array of the previous SXLIItem structure in the **rgsxli** array of the preceding [SXLI](#sxli) record. The value MUST be greater than or equal to 0 and less than the **isxviMac** field. If the **fGrand** field equals 1, then this value MUST be 0. + +**itmType (15 bits):** An unsigned integer that specifies the type of this pivot line. MUST be a value from the following table: + +| Name | Value | Meaning | +|----------------|--------|----------------------------------------------------| +| ITMTYPEDATA | 0x0000 | A value in the data | +| ITMTYPEDEFAULT | 0x0001 | Automatic subtotal selection | +| ITMTYPESUM | 0x0002 | Sum of values in the data | +| ITMTYPECOUNTA | 0x0003 | Count of values in the data | +| ITMTYPECOUNT | 0x0004 | Count of numbers in the data | +| ITMTYPEAVERAGE | 0x0005 | Average of values in the data | +| ITMTYPEMAX | 0x0006 | Maximum value in the data | +| ITMTYPEMIN | 0x0007 | Minimum value in the data | +| ITMTYPEPRODUCT | 0x0008 | Product of values in the data | +| ITMTYPESTDEV | 0x0009 | Statistical standard deviation (estimate) | +| ITMTYPESTDEVP | 0x000A | Statistical standard deviation (entire population) | +| ITMTYPEVAR | 0x000B | Statistical variance (estimate) | +| ITMTYPEVARP | 0x000C | Statistical variance (entire population) | +| ITMTYPEGRAND | 0x000D | Grand total | +| ITMTYPEBLANK | 0x000E | Blank line | + +**A - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**isxviMac (2 bytes):** A signed integer that specifies the number of elements in the **rgisxvi** array that are displayed in this pivot line. MUST be greater than or equal to 0. If the **fGrand** field equals 1, then the value of this field MUST be 1. If the **fGrand** field equals zero and the preceding SXLI record contains row area pivot items, then this value MUST be less than or equal to the **cDimRw** field of the preceding [SxView](#sxview). If the **fGrand** field equals zero and the preceding SXLI record contains column area pivot items, then this value MUST be less than or equal to the **cDimCol** field of the preceding SxView. + +**B - fMultiDataName (1 bit):** A bit that specifies whether the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592) name is used for the total or the subtotal. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------------| +| 0 | The data field name is used for the total. | +| 1 | The data field name is used for the subtotal. | + +If the **fGrand** field equals 1 or the **fBlock** field equals 1, then this value MUST equal the value in the **fMultiDataOnAxis** field. If the **fGrand** and **fBlock** fields equal zero, the **fSbt** and **fMultiDataOnAxis** fields equal 1, and the **cSic** field is less than *iposData*, then this value MUST equal 1. Otherwise, this value MUST be 0. + +*iposData* is specified as follows: + +- If the preceding SXLI record contains row area pivot items, *iposData* equals the index of the [SxIvdRw](#sxivdrw) record in the **rgSxivd** array of the [SxIvd](#sxivd) containing SxIvdRw records where the **rw** field equals -2. If there is not an SxIvdRw record with the **rw** field equal to -2, *iposData* equals zero. + +- If the preceding SXLI record contains column area pivot items, *iposData* equals the index of the [SxIvdCol](#sxivdcol) record in the **rgSxivd** array of the SxIvd containing SxIvdCol records where the **col** field equals -2. If there is not an SxIvdCol record with the **col** field equal to -2, *iposData* equals zero. + +**iData (8 bits):** An unsigned integer that specifies a [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679) index as specified in Data Items, for an [SXDI](#sxdi) record specifying a data item used for a subtotal. This field MUST be 0 if the **cDimData** field of the preceding SxView record is 0 or if the **fGrand** field equals 1. If the **cDimData** field of the preceding SxView is greater than 0, then this value MUST be greater than or equal to 0 and less than the **cDimData** field of the preceding SxView record. If the **fMultiDataOnAxis** field equals 1 and the **itmType** field does not equal ITMTYPEBLANK and the **isxviMac** field is greater than *iposData* as specified in **fMultiDataName**, then the value of this field MUST equal the value of the element of the **rgisxvi** array in the position equal to *iposData* as specified in **fMultiDataName**. + +**C - fSbt (1 bit):** A bit that specifies whether this pivot line is a subtotal. This value MUST equal 1 if the **itmType** field is greater than or equal to ITMTYPEDEFAULT and the **itmType** field is less than or equal to ITMTYPEGRAND and the **fBlock** field equals 0. Otherwise, this value MUST be 0. + +**D - fBlock (1 bit):** A bit that specifies whether this pivot line is a block total. A block total is a total of a group of pivot items. For more details see [Grouping](#Section_63e07ed20a764cb08cf446aaf25464c2). If the **fGrand** field equals 0 and the **fBlock** field in the previous SXLIItem record equals 1, this value MUST be 1. + +**E - fGrand (1 bit):** A bit that specifies whether this pivot line is a [**grand total**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7). If the **fGrand** field in the previous SXLIItem record is 1, then this value MUST be 1. Otherwise, if the **itmType** field equals ITMTYPEGRAND this field MUST equal 1 and if the **itmType** field does not equal ITMTYPEGRAND this field MUST equal 0. + +**F - fMultiDataOnAxis (1 bit):** A bit that specifies whether a [pivot line entry](#Section_ecba812f4a31495ebeb46749e5897f2d) in this pivot line is a data item index. + +If the preceding SXLI record contains row area pivot items, the **cDimData** field of the preceding SxView record is greater than 1, the **sxaxis4Data**.**sxaxisRw** field of the preceding SxView equals 1 and **itmType** is not equal to ITMTYPEBLANK, then this value MUST be 1. Otherwise, this value MUST be 0. + +If the preceding SXLI record contains column area pivot items, the **cDimData** field of the preceding SxView record is greater than 1, the **sxaxis4Data.sxaxisCol** field of the preceding SxView equals 1 and **itmType** is not equal to ITMTYPEBLANK, then this value MUST be 1. Otherwise, this value MUST be 0. + +**G - unused1 (1 bit):** Undefined, and MUST be ignored. + +**H - unused2 (1 bit):** Undefined, and MUST be ignored. + +**I - reserved2 (1 bit):** MUST be zero and MUST be ignored. + +**rgisxvi (variable):** An array of 2-byte signed integers that specifies a pivot line entry. + +Each element of this array is either a pivot item index or a data item index. + +If **fGrand** is 1 or **itmType** is ITMTYPEBLANK then all elements of this field are undefined and MUST be ignored. Otherwise each element MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 to 0x7EF4 | This value specifies a data item index or pivot item index in the associated [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) as specified in Pivot Items. | +| 0x7FFF | This value specifies that there is no pivot item and that the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the pivot line is blank. | + +For more details see Pivot Line Entries and Pivot Lines. + +### SXPI_Item + +The **SXPI_Item** structure specifies information about a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) and its filtering on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
isxvdisxvi
idObj
+ +**isxvd (2 bytes):** A signed integer that specifies a pivot field index as specified by Pivot Fields. The referenced pivot field is specified to be on the page axis. MUST be greater than or equal to zero and less than the **cDim** field of the [SxView](#sxview) record of the PivotTable view. + +**isxvi (2 bytes):** A signed integer that specifies the [pivot item](#Section_58891cc5dd9b4293a97831070779524f) used for the page axis filtering. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 to 0x7FFC | This value specifies a pivot item index that specifies a pivot item in the pivot field specified by **isxvd**. The referenced pivot item specifies the page axis filtering for the pivot field. | +| 0x7FFD | This value specifies all pivot items, see page axis for filtering that applies. | + +For a non-[OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) the value MUST be 0x7FFD or greater than or equal to zero and less than the **cItm** field of the [Sxvd](#sxvd) record of the pivot field**.** Otherwise the value MUST be 0x7FFD. + +**idObj (2 bytes):** A signed integer that specifies the object identifier of the [Obj](#obj) record with the page item drop-down arrow. + +### SXVDEx_Opt + +The **SXVDEx_Opt** structure specifies an optional string in the [SXVDEx](#sxvdex) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cchSubNamereserved1
...reserved2
...stSubName (variable)
...
+ +**cchSubName (2 bytes):** An unsigned integer that specifies the length, in characters, of the [XLUnicodeStringNoCch](#xlunicodestringnocch) in the **stSubName** field. If the value is 0xFFFF then **stSubName** does not exist. The value MUST be 0xFFFF or greater than zero and less than or equal to 0x00FF. + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +**stSubName (variable):** An XLUnicodeStringNoCch that specifies the name of the aggregate function used to calculate this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5)’s subtotals. A "?" character within the string will be replaced by the **stName** field of [Sxvd](#sxvd) when displayed in the UI. The length is specified in **cchSubName**. + +### SXView9Save + +The **SXView9Save** structure specifies option flags for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABCDEreserved2reserved3
+ +**A - fNoStencil (1 bit):** A bit that specifies whether to disable the drawing of large drop zones for a [PivotTable view](#Section_a5f57198f2af40b2ba07e4b1836d73f3)that has no data fields. + +**B - fHideTotAnnotation (1 bit):** A bit that specifies whether, for an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) when the **fNotVisualTotals** field of the [SXAddl_SXCView_SXDVer12Info](#sxaddl_sxcview_sxdver10info) record of the PivotTable view is 0 or the SXAddl_SXCView_SXDVer12Info record is not present, an asterisk is not displayed next to the caption for subtotals and grand totals. + +**C - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**D - fIncludeEmptyRw (1 bit):** A bit that specifies whether empty rows from an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) be shown in the PivotTable view. + +**E - fIncludeEmptyCol (1 bit):** A bit that specifies whether empty columns from an OLAP data source is shown in the PivotTable view. + +**reserved2 (11 bits):** MUST be zero, and MUST be ignored. + +**reserved3 (16 bits):** MUST be zero, and MUST be ignored. + +### SXVIFlags + +**SXVIFlags** is a 2-byte structure which specifies properties for a [pivot item](#Section_58891cc5dd9b4293a97831070779524f). + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ABCDEFreserved2
+ +**A - fDrilledMember (1 bit):** A bit that specifies whether child elements of this node are collapsed, see [Collapsing](#Section_1c9375b4cc664783821f6b2b49bac169) for details. MUST be zero if the pivot items are from [**attribute hierarchies**](#gt_8f75d668-e8c6-4f42-ba44-d90604d3b9dc). MUST be zero if the **itmType** field of the [SXVI](#sxvi) record of the pivot item is not zero. + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fHasChildren (1 bit):** A bit that specifies whether the pivot item has child [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32). MUST be zero if the **itmType** field of the SXVI record of the pivot item is not zero. + +**D - fCollapsedMember (1 bit):** A bit that specifies whether the subnodes of this node are collapsed, see Collapsing for details. This value applies only to pivot items of attribute hierarchies. MUST be zero if the pivot items are from non-attribute hierarchies. + +**E - fHasChildrenEst (1 bit):** A bit that specifies whether **fHasChildren** is considered correct. + +**F - fOlapFilterSelected (1 bit):** A bit that specifies whether this pivot item is selected for [Olap Manual Filtering](#Section_bd4665ebb56a44e690b9ceaf7ec55389). + +**reserved2 (10 bits):** MUST be zero, and MUST be ignored. + +### TabId + +The **TabId** structure specifies the unique sheet identifier associated with the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). A sheet’s identifier is specified by the [RRTabId](#rrtabid) record, the order of the sheet identifiers in the RRTabId record matches the order of the [BoundSheet8](#boundsheet8) records as they appear in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). If the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) contains more than 4112 sheets then this record is not present and each sheet identifier is specified by the order in which the BoundSheet8 records appear in the Globals Substream, beginning with one. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
tabid
+ +**tabid (2 bytes):** An unsigned integer that specifies the unique sheet identifier associated with the sheet. MUST be greater than or equal to 0x0001 and less than or equal to 0xFFFE. + +### TabIndex + +The **TabIndex** structure specifies a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) index in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). A sheet index is the zero-based index into the collection of [BoundSheet8](#boundsheet8) records as they appear in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
itab
+ +**itab (2 bytes):** An unsigned integer that specifies the zero-based index into the collection of BoundSheet8 records as they appear in the Globals Substream. + +### TableFeatureType + +The **TableFeatureType** structure specifies the definition of a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) within a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +The table feature supports multiple [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) types. The data source is specified by the **lt** field. If the **lt** field is 0x00000001, the table's data source definition is cached within the [List Data](#Section_914f09bd8c944c099e8631dfe058f037) stream. If the **lt** field is 0x00000002, the table's data source schema is cached within the **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
lt
idList
crwHeader
crwTotals
idFieldNext
cbFSData
rupBuildunused1
ABCDEFGHIJKLMNOPverXLQRSTUreserved3
lPosStmCache
cbStmCache
cchStmCache
lem
rgbHashParam (16 bytes)
...
...
rgbName (variable)
...
cFieldDatacSPName (variable)
...
entryId (variable)
...
fieldData (variable)
...
idDeleted (variable)
...
idChanged (variable)
...
cellInvalid (variable)
...
+ +**lt (4 bytes):** A [**SourceType**](#sourcetype) that specifies the type of data source for the table. + +**idList (4 bytes):** An unsigned integer that specifies an identifier for the table. MUST be unique within the sheet. SHOULD[\<183\>](#Appendix_A_183) be unique within the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +**crwHeader (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the table has a [**header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38). If **fAutoFilter** is 1, the value MUST be 0x00000001. If **fSingleCell** is 1, the value MUST be 0x00000000. MUST be one of the following values: + +| Value | Meaning | +|------------|--------------------------| +| 0x00000000 | Table has no header row. | +| 0x00000001 | Table has a header row. | + +**crwTotals (4 bytes):** A Boolean that specifies whether there is a [**total row**](#gt_95e9bcf4-d644-4e96-9070-dbc80b4d1b28). If **fSingleCell** is 1, the value MUST be 0x00000000. MUST be one of the following values: + +| Value | Meaning | +|------------|-------------------------| +| 0x00000000 | Table has no total row. | +| 0x00000001 | Table has a total row. | + +**idFieldNext (4 bytes):** An unsigned integer that specifies the next unique identifier to use when assigning unique identifiers to the **fieldData.idField** field of the table. + +**cbFSData (4 bytes):** An unsigned integer that specifies the size, in bytes, of the fixed portion of this structure. The fixed portion starts at the **lt** field and ends at the **rgbHashParam** field. MUST be equal to 64. + +**rupBuild (2 bytes):** An unsigned integer that specifies the [**build number**](#gt_560a30e4-7009-48da-b1e8-68db9c458e95) of the application that wrote the structure. + +**unused1 (2 bytes):** Undefined, and MUST be ignored. + +**A - unused2 (1 bit):** Undefined, and MUST be ignored. + +**B - fAutoFilter (1 bit):** A bit that specifies whether the table has an [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). MUST be 1 when **fPersistAutoFilter** is 1. + +**C - fPersistAutoFilter (1 bit):** A bit that specifies whether the AutoFilter is preserved for this table after data [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) operations.[\<184\>](#Appendix_A_184) + +**D - fShowInsertRow (1 bit):** A bit that specifies whether the [**insert row**](#gt_3b3c223b-83e0-4697-85eb-815af907b8a9) is [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72). MUST be 1 if **fInsertRowInsCells** is 1. + +**E - fInsertRowInsCells (1 bit):** A bit that specifies whether rows below the table are shifted down because of the insert row being visible. + +**F - fLoadPldwIdDeleted (1 bit):** A bit that specifies whether the **idDeleted** field is present. MUST be zero if the **lt** field is not set to 0x00000001. + +**G - fShownTotalRow (1 bit):** A bit that specifies whether the total row was ever visible. + +**H - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**I - fNeedsCommit (1 bit):** A bit that specifies whether table modifications were not synchronized with the data source. MUST be zero if the **lt** field is not set to 0x00000001. + +**J - fSingleCell (1 bit):** A bit that specifies whether the table is limited to a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). The table cannot have header rows, total rows, or multiple columns. If **fSingleCell** equals 1, the **lt** field MUST be set to 0x00000002. + +**K - reserved2 (1 bit):** MUST be zero and MUST be ignored. + +**L - fApplyAutoFilter (1 bit):** A bit that specifies whether the AutoFilter is currently applied. MUST be 1 if the AutoFilter is currently applied[\<185\>](#Appendix_A_185). + +**M - fForceInsertToBeVis (1 bit):** A bit that specifies whether the insert row is forced to be visible because the table has no data. + +**N - fCompressedXml (1 bit):** A bit that specifies whether the cached data for this table in the List Data stream is compressed. MUST be zero if the **lt** field is not set to 0x00000001. + +**O - fLoadCSPName (1 bit):** A bit that specifies whether the **cSPName** field is present. MUST be zero if the **lt** field is not set to 0x00000001. + +**P - fLoadPldwIdChanged (1 bit):** A bit that specifies whether **idChanged** field is present. MUST be zero if the **lt** field is not set to 0x00000001. + +**verXL (4 bits):** An unsigned integer that specifies the application version under which the table was created. MUST be either 0xB or 0xC[\<186\>](#Appendix_A_186). + +**Q - fLoadEntryId (1 bit):** A bit that specifies whether the **entryId** field is present. + +**R - fLoadPllstclInvalid (1 bit):** A bit that specifies whether the **cellInvalid** field is present. MUST be zero if the **lt** field is not set to 0x00000001. + +**S - fGoodRupBld (1 bit):** A bit that specifies whether the **rupBuild** field is valid. + +**T - unused3 (1 bit):** Undefined, and MUST be ignored. + +**U - fPublished (1 bit):** A bit that specifies whether the table is [**published**](#gt_8ffc383a-d4f1-4515-a8b5-874d84ab2d2b). This bit is ignored if the **fPublishedBookItems** field of the [BookExt_Conditional12](#bookext_conditional12) structure is zero. + +**reserved3 (7 bits):** Undefined, and MUST be ignored. + +**lPosStmCache (4 bytes):** An unsigned integer that specifies the position of the cached data within the List Data stream. Undefined and MUST be ignored if the **lt** field is not set to 0x00000001. + +**cbStmCache (4 bytes):** An unsigned integer that specifies the size, in bytes, of the cached data within the List Data stream. Undefined and MUST be ignored if the **lt** field is not set to 0x00000001. + +**cchStmCache (4 bytes):** An unsigned integer that specifies the count of characters of the cached data within the List Data stream when the cached data is uncompressed. Undefined and MUST be ignored if the **lt** field is not set to 0x00000001. + +**lem (4 bytes):** A [**LEMMode**](#lemmode) enumeration that specifies the table edit mode. If **lt** is set to 0x00000000, 0x00000002 or 0x00000003, this field MUST be set to 0x00000000. + +**rgbHashParam (16 bytes):** An array of bytes that specifies round-trip information. SHOULD[\<187\>](#Appendix_A_187) be ignored and MUST be preserved if the **lt** field is set to 0x00000001. Undefined and MUST be ignored if the **lt** field is not set to 0x00000001. + +**rgbName (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the name of the table. MUST be unique per [workbook](#Section_f682f4b08c6b444e83f852d156f1e8ba), and case-sensitive in all locales. + +**cFieldData (2 bytes):** An unsigned integer that specifies the number of columns in the table. MUST be greater than or equal to 0x0001 and less than or equal to 0x0100. + +**cSPName (variable):** An XLUnicodeString that specifies the name of the [**cryptographic service provider**](#gt_1e9dc9e9-1ec2-43fa-80ac-caf013b9f3fc) used to specify **rgbHashParam**. This field is present only if **fLoadCSPName** is set to 1. + +**entryId (variable):** An XLUnicodeString that specifies a unique identifier for the table. The string equals the value of the **idList** field, represented in decimal format, without any leading zeros. It is used when **lt** equals 0x00000002 and ignored otherwise. This field is present only if **fLoadEntryId** is set to 1. + +**fieldData (variable):** An array of [Feat11FieldDataItem](#feat11fielddataitem) that contains the specification of the columns of the table. The number of items in this array is specified by the **cFieldData** field. + +**idDeleted (variable):** A [Feat11RgSharepointIdDel](#feat11rgsharepointiddel) structure that specifies the identifiers of deleted rows. This information is used when synchronizing with the Web based [**data provider’s**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) data source. This field is only present if the **fLoadPldwIdDeleted** field is set to 1. + +**idChanged (variable):** A [Feat11RgSharepointIdChange](#feat11rgsharepointidchange) structure that specifies the identifiers of the edited rows. This information is used when synchronizing with the Web based data provider’s data source. This field is only present if the **fLoadPldwIdChanged** field is set to 1. + +**cellInvalid (variable):** A [Feat11RgInvalidCells](#feat11rginvalidcells) structure that specifies the location of cells within the table that contain values that are invalid based on validation rules on the Web based data provider. This field is only present if the **fLoadPllstclInvalid** field is set to 1. + +### Tag_Fn_MDX + +The **Tag_Fn_MDX** enumeration specifies [**cube function**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3) types. + +| Name | Value | Meaning | +|---------------------------|-------|--------------------| +| **TFNCUBEMEMBER** | 0x01 | CUBEMEMBER | +| **TFNCUBEVALUE** | 0x02 | CUBEVALUE | +| **TFNCUBESET** | 0x03 | CUBESET | +| **TFNCUBESETCOUNT** | 0x04 | CUBESETCOUNT | +| **TFNCUBERANKEDMEMBER** | 0x05 | CUBERANKEDMEMBER | +| **TFNCUBEMEMBERPROPERTY** | 0x06 | CUBEMEMBERPROPERTY | +| **TFNCUBEKPIPROPERTY** | 0x07 | CUBEKPIPROPERTY | + +### TextPropsStreamChecksumData + +The **TextPropsStreamChecksumData** structure specifies the data used to compute the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the [TextPropsStream](#textpropsstream) record. This data can be obtained from [Font](#font) and [Text](#text) records associated with the TextPropsStream record, as specified in TextPropsStream. If no Font record is associated with the TextPropsStream record, the fields related to the Font record MUST be omitted from this structure and thus not used to compute the checksum. If no Text record is associated with the TextPropsStream record, the Text record associated with the [DefaultText](#defaulttext) record MUST be used instead. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
stFontName (variable)
...
dwFontHeight
ABCDEFGHIJKunused1boldness
subscriptbUnderlinebFamily
bCharsetunused2rgbFontColor
...dwDrawingMode
...bRotationdwHAlignment
...dwVAlignment
...bReadingOrder
+ +**stFontName (variable):** An array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters that specify the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) name. The size of the array MUST be equal to **fontName**.**cch\***2, where **fontName** is a field of the associated Font record. + +The value of this field MUST be equal to value of the **fontName**.**rgb** field of the associated Font record. + +**dwFontHeight (4 bytes):** An unsigned integer that specifies the font height. The value of this field MUST be equal to the value of the **dyHeight** field of the associated Font record. + +**A - fBold (1 bit):** A bit that specifies whether the font is bold. The value of this field MUST be 1 when the value of the **bls** field of the associated Font record is greater than 400. + +**B - fItalic (1 bit):** A bit that specifies whether the font is italic. The value of this field MUST be equal to the value of the **fItalic** field of the associated Font record. + +**C - fUnderline (1 bit):** A bit that specifies whether the font is single-underlined. The value of this field MUST be 1 when the value of the **uls** field of the associated Font record is not equal to 0x00. + +**D - fOutline (1 bit):** A bit that specifies whether the font has an [**outline effect**](#gt_4e818802-fdc1-4227-b32f-1a3cb0943de7) applied. The value of this field MUST be equal to the value of the **fOutline** field of the associated Font record. + +**E - fShadow (1 bit):** A bit that specifies whether the font has a [**shadow effect**](#gt_83056968-00f2-463b-abc6-607dbb242cbf) applied. The value of this field MUST be equal to the value of the **fShadow** field of the associated Font record. + +**F - fCondense (1 bit):** A bit that specifies whether the font is condensed. The value of this field MUST be equal to the value of the **fCondense** field of the associated Font record. + +**G - fExtend (1 bit):** A bit that specifies whether the font is extended. The value of this field MUST be equal to the value of the **fExtend** field of the associated Font record. + +**H - fStrikeout (1 bit):** A bit that specifies whether the font has strike-through effect applied. The value of this field MUST be equal to the value of the **fStrikeOut** field of the associated Font record. + +**I - fRegular (1 bit):** A bit that specifies whether the font is a regular font. The value of this field MUST be equal to 1. + +**J - fJon (1 bit):** A bit that specifies whether the font is too small to be displayed. MUST have a value of 1 if the font height in pixels is less than 6. + +**K - fDialogBox (1 bit):** A bit that specifies whether the font is used in the context of a dialog box. The value of this field MUST be equal to 0. + +**unused1 (5 bits):** MUST be zero, and MUST be ignored. + +**boldness (2 bytes):** An unsigned integer that specifies the font weight. The value of this field MUST be equal to the value of the **bls** field of the associated Font record. + +**subscript (2 bytes):** An unsigned integer that specifies whether superscript, subscript, or normal script is used. The value of this field MUST be equal to the value of the **sss** field of the associated Font record. + +**bUnderline (1 byte):** An unsigned integer that specifies the underline style. The value of this field MUST be equal to the value of the **uls** field of the associated Font record. + +**bFamily (1 byte):** An unsigned integer that specifies the [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2) of this font. The value of this field MUST be equal to the value of the **bFamily** field of the associated Font record. + +**bCharset (1 byte):** An unsigned integer that specifies the [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204). The value of this field MUST be equal to the value of the **bCharSet** field of the associated Font record. + +**unused2 (1 byte):** MUST be zero, and MUST be ignored. + +**rgbFontColor (4 bytes):** A [LongRGB](#longrgb) that specifies the font color. The value of this field MUST be equal to the value of the **icv** field of the associated Font record. + +**dwDrawingMode (4 bytes):** An unsigned integer that specifies the display mode of the background of the text. The value of this field MUST be equal to 0x0000010D when the **wBkgMode** field of the associated Text record is equal to 0x0001; otherwise, it MUST be equal to 0x0000020D. + +**bRotation (1 byte):** An unsigned integer that specifies the text rotation. The value of this field MUST be equal to the value of the **trot** field of the associated Text record. + +**dwHAlignment (4 bytes):** An unsigned integer that specifies the horizontal alignment of the text. The value of this field MUST equal to the value of the **at** field of the associated Text record. + +**dwVAlignment (4 bytes):** An unsigned integer that specifies the vertical alignment of the text. The value of this field MUST be equal to the value of the **vat** field of the associated Text record. + +**bReadingOrder (1 byte):** An unsigned integer that specifies the reading order of the text. The value of this field MUST be equal to the value of the **iReadingOrder** field of the associated Text record. + +### Top10FT + +The **Top10FT** enumeration specifies the [**top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9) type. + +| Name | Value | Meaning | +|--------------------|------------|---------| +| **TOP10FTUNKNOWN** | 0x00000000 | None | +| **TOP10FTCOUNT** | 0x00000001 | Count | +| **TOP10FTPERCENT** | 0x00000002 | Percent | +| **TOP10FTSUM** | 0x00000003 | Sum | + +### Ts + +The **Ts** structure specifies the italic and [**strikethrough formatting**](#gt_b16d9600-aebb-4a4f-bf14-c38e13c11c14) of a [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ABunused2Cunused3
+ +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - ftsItalic (1 bit):** A bit that specifies whether the text [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) is italic. + +**unused2 (5 bits):** Undefined and MUST be ignored. + +**C - ftsStrikeout (1 bit):** A bit that specifies whether the font has strikethrough formatting applied. + +**unused3 (24 bits):** Undefined and MUST be ignored. + +### TxOLastRun + +The **TxOLastRun** structure marks the end of the [**formatting run**](#gt_10031ac8-2a26-4200-beee-cd8d9420ca96) information in the [TxORuns](#txoruns) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cchTextunused1
unused2
+ +**cchText (2 bytes):** An unsigned integer that specifies the number of characters in the preceding [TxO](#txo) record. The value MUST be the count of characters specified in the **cchText** field of the preceding TxO record. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +### TxORuns + +The **TxORuns** structure specifies the [**formatting run**](#gt_10031ac8-2a26-4200-beee-cd8d9420ca96) information for the [TxO](#txo) record and zero or more [Continue](#continue) records immediately following. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgTxoRuns (variable)
...
lastRun
...
+ +**rgTxoRuns (variable):** An array of [Run](#run). Each Run specifies the formatting information for a [**text run**](#gt_393612a7-9552-48b0-abf6-0371dbd6d553). **formatRun.ich** MUST be less than or equal to **cchText** of the preceding TxO record. The number of elements in this array is as follows: + +(**cbRuns** of the preceding TxO record / 8 – 1). + +**lastRun (8 bytes):** A [TxOLastRun](#txolastrun) that marks the end of the text run. This field is only present in the last Continue record following the TxO record. [\<188\>](#Appendix_A_188) + +### TxtWf + +The **TxtWf** structure specifies a field in text to column. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
fieldType
fieldStart
+ +**fieldType (4 bytes):** An unsigned integer that specifies the format of the field. MUST be a value from the following table: + +| Value | Meaning | +|------------|------------------------------------| +| 0x00000000 | General | +| 0x00000001 | Text | +| 0x00000002 | Date in the order month, day, year | +| 0x00000003 | Date in the order day, month, year | +| 0x00000004 | Date in the order year, month, day | +| 0x00000005 | Date in the order month, year, day | +| 0x00000006 | Date in the order day, year, month | +| 0x00000007 | Date in the order year, day, month | +| 0x00000008 | Skip importing field | +| 0x00000009 | Taiwan era dates. | + +**fieldStart (4 bytes):** An unsigned integer that specifies the character position of the field. The offset is zero-based and MUST be greater than or equal to 0. + +### Underline + +The **Underline** enumeration specifies the underline style. + +| Name | Value | Meaning | +|----|----|----| +| **ULSNONE** | 0x0000 | No underline | +| **ULSSINGLE** | 0x0001 | Single | +| **ULSDOUBLE** | 0x0002 | Double | +| **ULSSINGLEACCOUNTANT** | 0x0021 | [**Single accounting**](#gt_7ad49c0f-e183-47b5-bdbd-c23a5a8315fc) | +| **ULSDOUBLEACCOUNTANT** | 0x0022 | [**Double accounting**](#gt_89f4f531-9a8b-419c-8f51-98ef409b7bdf) | + +### VertAlign + +The **VertAlign** enumeration specifies the vertical alignment. + +| Name | Value | Meaning | +|--------------|-------|-----------------------| +| **ALCVTOP** | 0x00 | Top alignment | +| **ALCVCTR** | 0x01 | Center alignment | +| **ALCVBOT** | 0x02 | Bottom alignment | +| **ALCVJUST** | 0x03 | Justify alignment | +| **ALCVDIST** | 0x04 | Distributed alignment | + +### VertBrk + +The **VertBrk** structure specifies one column [**page break**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
colrowStart
rowEnd
+ +**col (2 bytes):** A [ColU](#colu) that specifies the zero-based index of the first column to the right of the page break. + +**rowStart (2 bytes):** A [RwU](#rwu) that specifies the zero-based index of the first row on the page. + +**rowEnd (2 bytes):** A RwU that specifies the zero-based index of the last row on the page. The value MUST be greater than **rowStart**. + +### VirtualPath + +**VirtualPath** is a [XLUnicodeString](#xlunicodestring) that specifies a path, a workbook, and optionally a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +MUST be a string in the following grammar: + +437. virt-path = volume / unc-volume / rel-volume / transfer-protocol / startup / alt-startup / library / simple-file-path / ole-link + + ole-link = path-string %x0003 path-string + + simple-file-path = \[%x0001\] file-path + + startup = %x0001 %x0006 file-path + +This code specifies that the relative-path is relative to the [**startup directory**](#gt_801b8914-241f-4ce5-977d-81aebf73f03d). + +441. alt-startup = %x0001 %x0007 file-path + +This code specifies that the relative-path is relative to the [**alternate startup directory**](#gt_08e6e2f9-6030-4e53-a75f-ce61b18a5113). + +442. library = %x0001 %x0008 file-path + +This code specifies that the relative-path is relative to the [**library directory**](#gt_1cdac036-e397-49b5-8933-c0e8f054528a). + +443. transfer-protocol = %x0001 %x0005 count transfer-path + +This code specifies that the path is a [**transfer protocol**](#gt_627a8033-354c-4fd2-9356-bb232afbdb6a) path. The value of count MUST be equal to the number of characters following count in transfer-path. + +444. transfer-path = transfer-base-path / "\[" transfer-base-path "\]" sheet-name + + transfer-base-path = transfer-type "://" file-path + + transfer-type = "ftp" / "http" / "https" + + rel-volume = %x0001 %x0002 file-path + +This code specifies that the path is relative to the drive volume of the workbook that contains the path. + +448. volume = %x0001 %x0001 volume-character file-path + +This code specifies that the path is relative to a specific drive volume. The drive volume is specified in volume-character. + +449. unc-volume = %x0001 %x0001 %x0040 unc-path + +This code specifies that the path is relative to a [**UNC volume**](#gt_dbf563c5-fee0-44dc-b90e-d302db7bcd78). The computer name is specified in computer-name and the shared folder is specified in shared-folder. + +450. unc-path = unc-base-path / "\[" unc-base-path "\]" sheet-name + + unc-base-path = computer-name %x0003 shared-folder %x0003 relative-path + + volume-character = %x0041-%x005A / %x0061-%x007A + +This code specifies a drive volume. + +453. file-path = relative-path / "\[" relative-path "\]" sheet-name + + sheet-name = sheet-start-end-character \*sheet-character sheet-start-end-character / sheet-start-end-character + +This code specifies the name of the sheet within the workbook. + +455. sheet-start-end-character = %x0001-%xFFFF + +This code specifies a character which is a first or last character of sheet name. Such character MUST NOT include any character that matches invalid-sheet-start-end-character. + +456. invalid-sheet-start-end-character = %x0003 / "\*" / "?" / "’" / "\[" / "\]" / "\\ / ":" / "/" + + sheet-character = %x0001-%xFFFF + +This code specifies a sheet character. A sheet character MUST NOT include any character that matches invalid-sheet-character. + +458. invalid-sheet-character = %x0003 / "\*" / "?" / / "\[" / "\]" / "\\ / ":" / "/" + + relative-path = directory \*(%x0003 directory) + +This code specifies a sequence of subdirectories that comprise the path from the volume or directory. + +460. directory = path-string + +This code specifies a directory. + +461. computer-name = path-string + +This code specifies a computer name. + +462. shared-folder = path-string + +This code specifies a shared folder. + +463. path-string = 1\*path-character + + path-character = %x0020-%x0021 / %x0023-%x0029 / %x002B-%x002E / %x0030-%x0039 / %x003B / %x003D / %x0040-%x005B / %x005D-%x007B / %x007D-%xFFFF + +This code specifies a path character. + +count = %x00-%xFF + +### WebPubString + +The **WebPubString** structure specifies a string for Web publishing. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cchstr (variable)
...
pad (optional)
+ +**cch (2 bytes):** An unsigned integer that specifies the character count in the **str** field. MUST be greater than or equal to zero and less than or equal to 255. + +**str (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch). The character count in the string MUST be equal to the value of the **cch** field. + +**pad (1 byte):** Unused and MUST be ignored. This field exists if and only if the total number of bytes in the **str** field is an odd number. + +### XColorType + +The **XColorType** enumeration specifies the color reference types. It MUST be one of the following values: + +| Name | Value | Meaning | +|-----------------|------------|-----------------| +| **XCLRAUTO** | 0x00000000 | Automatic color | +| **XCLRINDEXED** | 0x00000001 | Indexed color | +| **XCLRRGB** | 0x00000002 | RGB color | +| **XCLRTHEMED** | 0x00000003 | Theme color | +| **XCLRNINCHED** | 0x00000004 | Color not set | + +### XFExtGradient + +The **XFExtGradient** structure specifies a gradient fill for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) interior. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
gradient (44 bytes)
...
...
cGradStops
rgGradStops (variable)
...
+ +**gradient (44 bytes):** An [XFPropGradient](#xfpropgradient) that specifies the gradient fill. + +**cGradStops (4 bytes):** An unsigned integer that specifies the number of items in **rgGradStops**. MUST be greater than or equal to 0 and less than or equal to 256. + +**rgGradStops (variable):** An array of [GradStop](#gradstop). Each array element specifies a gradient stop for this gradient fill. + +### XFExtNoFRT + +The **XFExtNoFRT** structure specifies a set of extensions to formatting properties. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reserved1reserved2
reserved3cexts
rgExt (variable)
...
+ +**reserved1 (2 bytes):** MUST be zero and MUST be ignored. + +**reserved2 (2 bytes):** MUST be equal to 0xFFFF and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero and MUST be ignored. + +**cexts (2 bytes):** An unsigned integer that specifies the number of elements in **rgExt.** + +**rgExt (variable):** An array of [ExtProp](#extprop). Each array element specifies an extension to a formatting property. The element count of this field MUST be equal to **cexts**. + +### XFIndex + +The **XFIndex** structure specifies the index of a [XF](#xf) record. + + ++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

12345
ixfe
+ +**ixfe (2 bytes):** An unsigned integer that specifies a zero-based index of a XF record in the collection of XF records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +The XF records in the file refer to both and [Cell Style XFs](#Section_3d5348ded9df4c31b1fd9f9377273152) and [Cell XFs](#Section_518a740d71c640c8bb97e7df6915861a). For more information, see [Styles](#Section_df39e66a8f994f41beeb4f5c8a1d2593). + +The XF records in the file can be divided into three sections. The first section contains the 16 built-in XF records that MUST exist and MUST be ordered as follows: + +| Index | XF specifies | fStyle value | +|-------|------------------------|--------------| +| 0 | Normal style | 1 | +| 1 | Row outline level 1 | 1 | +| 2 | Row outline level 2 | 1 | +| 3 | Row outline level 3 | 1 | +| 4 | Row outline level 4 | 1 | +| 5 | Row outline level 5 | 1 | +| 6 | Row outline level 6 | 1 | +| 7 | Row outline level 7 | 1 | +| 8 | Column outline level 1 | 1 | +| 9 | Column outline level 2 | 1 | +| 10 | Column outline level 3 | 1 | +| 11 | Column outline level 4 | 1 | +| 12 | Column outline level 5 | 1 | +| 13 | Column outline level 6 | 1 | +| 14 | Column outline level 7 | 1 | +| 15 | Default cell format | 0 | + +The second section contains XF records for both built-in and user-defined Cell Style XFs. These Cell Style XFs MUST be ordered alphabetically in the file based on their name. The name of the Cell Style XF is specified by the **user** field of the corresponding [Style](#style) record. The corresponding Style record is the one with an **ixfe** field that specifies the XF record of the Cell Style XF. Note that the ordering depends on the localized name of the style and the language of the application that last saved the file. + +For example, in a workbook created by a specific version of the application[\<189\>](#Appendix_A_189) with no user-defined [cell styles](#Section_f9425d3f127545be8389bf80f65b56b7) the remainder of the table is: + +| Index | Name of Style | fStyle value | +|-------|------------------|--------------| +| 16 | 20% - Accent1 | 1 | +| 17 | 20% - Accent2 | 1 | +| 18 | 20% - Accent3 | 1 | +| 19 | 20% - Accent4 | 1 | +| 20 | 20% - Accent5 | 1 | +| 21 | 20% - Accent6 | 1 | +| 22 | 40% - Accent1 | 1 | +| 23 | 40% - Accent2 | 1 | +| 24 | 40% - Accent3 | 1 | +| 25 | 40% - Accent4 | 1 | +| 26 | 40% - Accent5 | 1 | +| 27 | 40% - Accent6 | 1 | +| 28 | 60% - Accent1 | 1 | +| 29 | 60% - Accent2 | 1 | +| 30 | 60% - Accent3 | 1 | +| 31 | 60% - Accent4 | 1 | +| 32 | 60% - Accent5 | 1 | +| 33 | 60% - Accent6 | 1 | +| 34 | Accent1 | 1 | +| 35 | Accent2 | 1 | +| 36 | Accent3 | 1 | +| 37 | Accent4 | 1 | +| 38 | Accent5 | 1 | +| 39 | Accent6 | 1 | +| 40 | Bad | 1 | +| 41 | Calculation | 1 | +| 42 | Check Cell | 1 | +| 43 | Comma | 1 | +| 44 | Comma\[0\] | 1 | +| 45 | Currency | 1 | +| 46 | Currency\[0\] | 1 | +| 47 | Explanatory Text | 1 | +| 48 | Good | 1 | +| 49 | Heading 1 | 1 | +| 50 | Heading 2 | 1 | +| 51 | Heading 3 | 1 | +| 52 | Heading 4 | 1 | +| 53 | Input | 1 | +| 54 | Linked Cell | 1 | +| 55 | Neutral | 1 | +| 56 | Note | 1 | +| 57 | Output | 1 | +| 58 | Percent | 1 | +| 59 | Title | 1 | +| 60 | Total | 1 | +| 61 | Warning Text | 1 | + +The last section contains unordered XFs for any Cell XFs in the file. + +### XFProp + +The **XFProp** structure specifies a formatting property. Instances of this structure appear as elements in the **xfPropArray** field of an [XFProps](#xfprops) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xfPropTypecb
xfPropDataBlob (variable)
...
+ +**xfPropType (2 bytes):** An unsigned integer that specifies the type of the formatting property. MUST be greater than or equal to 0x0000 and less than or equal to 0x002C, and MUST NOT equal 0x0027 or 0x0028. See the table in **xfPropDataBlob** for more information about the meaning of this field. + +**cb (2 bytes):** An unsigned integer that specifies the size of this XFProp structure. + +**xfPropDataBlob (variable):** A field that specifies the formatting property data. The size and data type of this field varies based on the property type as specified in **xfPropType** as follows: + +| xfPropType value | xfPropDataBlob field Data and Meaning | +|----|----| +| 0x0000 | A [**FillPattern**](#fillpattern) that specifies the [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e). | +| 0x0001 | An [XFPropColor](#xfpropcolor) that specifies the foreground color. | +| 0x0002 | An XFPropColor that specifies the background color. | +| 0x0003 | An [XFPropGradient](#xfpropgradient) that specifies the [**gradient fill**](#gt_35280309-5b22-4c17-be48-f06c37ffc685). This is often followed in the same **xfPropArray** field of the XFProps structure by one or more XFProp structures with **xfPropType** equal to 0x0004, which provides additional specifications for the gradient fill. | +| 0x0004 | An [XFPropGradientStop](#xfpropgradientstop) that specifies a [**gradient stop**](#gt_35b983af-d590-4f93-87cb-94786924511f) for a preceding XFProp with **xfPropType** equal to 0x0003 in the same **xfPropArray** field in the XFProps structure. | +| 0x0005 | An XFPropColor that specifies the text color. | +| 0x0006 | An [XFPropBorder](#xfpropborder) that specifies the top border formatting. | +| 0x0007 | An XFPropBorder that specifies the bottom border formatting. | +| 0x0008 | An XFPropBorder that specifies the left border formatting. | +| 0x0009 | An XFPropBorder that specifies the right border formatting. | +| 0x000A | An XFPropBorder that specifies the diagonal border formatting. | +| 0x000B | An XFPropBorder that specifies the vertical border formatting. | +| 0x000C | An XFPropBorder that specifies the horizontal border formatting. | +| 0x000D | A 1-byte unsigned integer that specifies whether a [**diagonal-up**](#gt_d4878a4d-c65e-471d-b9fb-da7a5a5aa929) border is used. MUST be 0 or 1. The value of 1 means that a diagonal-up border is used. | +| 0x000E | A 1-byte unsigned integer that specifies whether a [**diagonal-down**](#gt_494c0660-9ece-4dcc-b8d3-1a5616a57782) border is used. MUST be 0 or 1. The value of 1 means that a diagonal-down border is used. | +| 0x000F | A [**HorizAlign**](#horizalign) that specifies the [**horizontal alignment**](#gt_f0e60ca8-51d5-4553-9126-3d89a4d08f90). | +| 0x0010 | A [**VertAlign**](#vertalign) that specifies the [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878). | +| 0x0011 | An [XFPropTextRotation](#xfproptextrotation) that specifies the text rotation. | +| 0x0012 | A 2-byte unsigned integer that specifies the absolute text [**indentation level**](#gt_2779d3df-3c50-44dc-9d2d-6996c4573aa9). MUST be less than or equal to 15. The absolute indentation level replaces any previous indentation. | +| 0x0013 | A [**ReadingOrder**](#readingorder) that specifies the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361). | +| 0x0014 | A 1-byte unsigned integer that specifies whether [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) text is wrapped. MUST be 0 or 1. The value of 1 means that the text is wrapped. | +| 0x0015 | A 1-byte unsigned integer that specifies whether cell text is [**justify distributed**](#gt_11eced66-af2c-4391-8b45-87a60ad41483). MUST be 0 or 1. The value of 1 means that the text is justify distributed. If this value is 1 then an XFProp with **xfPropType** equal to 0x000F MUST exist in this **xfPropArray** field of the XFProps structure and MUST equal 0x07. | +| 0x0016 | A 1-byte unsigned integer that specifies whether a cell is [**shrink to fit**](#gt_4740d2ef-00d3-4a29-983c-b7b3a6aa01e0). MUST be 0 or 1. The value of 1 means that the cell is shrink to fit. | +| 0x0017 | A 1-byte unsigned integer that specifies whether a cell is merged. MUST be 0 or 1. The value of 1 means that the cell is merged. | +| 0x0018 | An [LPWideString](#lpwidestring) that specifies the font name used by the cell data. MUST be less than or equal to 32 characters in length. | +| 0x0019 | A [**Bold**](#bold) that specifies the [**font face weight**](#gt_8fd5e2d4-bd9a-48f2-ba16-42d23697508c). | +| 0x001A | An [**Underline**](#underline) that specifies the underline style. | +| 0x001B | A [**Script**](#script) that specifies the superscript or subscript style. | +| 0x001C | A 1-byte unsigned integer that specifies whether text is italicized. MUST be 0 or 1. The value of 1 means that the text is italic. | +| 0x001D | A 1-byte unsigned integer that specifies whether text has [**strikethrough formatting**](#gt_b16d9600-aebb-4a4f-bf14-c38e13c11c14) applied. MUST be 0 or 1. The value of 1 means that the text has strikethrough formatting applied. | +| 0x001E | A 1-byte unsigned integer that specifies whether text has an outline style. MUST be 0 or 1. The value of 1 means that the text is outline style. | +| 0x001F | A 1-byte unsigned integer that specifies whether text has a shadow style. MUST be 0 or 1. The value of 1 means that the text is shadow style. | +| 0x0020 | A 1-byte unsigned integer that specifies whether text is condensed. MUST be 0 or 1. The value of 1 means that the text is condensed. | +| 0x0021 | A 1-byte unsigned integer that specifies whether text is extended. MUST be 0 or 1. The value of 1 means that the text is extended. | +| 0x0022 | A 1-byte unsigned integer that specifies a [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204). For more information about character sets, see the Windows API LOGFONT structure in [\[MSDN-FONTS\]](https://go.microsoft.com/fwlink/?LinkId=90008). | +| 0x0023 | A 1-byte unsigned integer that specifies a [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2). For more information about font families, see the Windows API LOGFONT structure in \[MSDN-FONTS\]. MUST be greater than or equal to 0 and less than or equal to 5. | +| 0x0024 | A 4-byte unsigned integer that specifies text size in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382). MUST be greater than or equal to 20 and less than or equal to 8191. | +| 0x0025 | A [**FontScheme**](#fontscheme) that specifies the [**font scheme**](#gt_d2cfdc52-4222-46a7-8c1e-fffdcadcb973) of a [**theme**](#gt_8b5eb4c0-949b-47d9-8b63-b9bda81d61b8) [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). | +| 0x0026 | A [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) as specified by the **stFormat** field of [Format](#format) that specifies the number [**format string**](#gt_07085e26-506a-4b35-81ad-972464e277ff). | +| 0x0029 | An [IFmt](#ifmt) that specifies a number format identifier. | +| 0x002A | A 2-byte signed integer that specifies the relative text indentation level. The relative indentation level is added to any previous indentation. The value MUST either be greater than or equal to -15 and less than or equal to 15, or it MUST be 255. Values -15 through 15 specify a relative indentation level, and the value 255 specifies the absence of a relative indentation level. | +| 0x002B | A 1-byte unsigned integer that specifies whether the [**locked protection**](#gt_10f1ec97-0464-49da-bf78-5339b9d3520c) property is set to true. MUST be 0 or 1. The value of 1 means that the property is set to true. | +| 0x002C | A 1-byte unsigned integer that specifies whether the [**hidden protection**](#gt_1b14d877-9a96-485f-8eb8-b2c26f3355cf) property is set to true. MUST be 0 or 1. The value of 1 means that the property is set to true. | + +### XFPropBorder + +The **XFPropBorder** structure specifies [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
color
...
dgBorder
+ +**color (8 bytes):** An [XFPropColor](#xfpropcolor) that specifies the border color. + +**dgBorder (2 bytes):** A [BorderStyle](#borderstyle) that specifies the border [**line style**](#gt_a6d51057-258d-42cc-9920-6e08c10d2447). + +### XFPropColor + +The **XFPropColor** structure specifies a color. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
AxclrTypeicvnTintShade
dwRgba
+ +**A - fValidRGBA (1 bit):** A bit that specifies whether the **xclrType, icv** and **nTintShade** fields were used to set the **dwRgba** field. MUST equal 1. + +**xclrType (7 bits):** An [**XColorType**](#xcolortype) that specifies how the color information is stored. + +**icv (1 byte):** An unsigned integer that specifies color information. If **xclrType** equals 0x01, this field MUST be one of the values specified in [IcvXF](#icvxf), or equal 0. If **xclrType** equals 0x03, this field MUST be one of the values specified in [ColorTheme](#colortheme). Otherwise this field is undefined and MUST be ignored. + +**nTintShade (2 bytes):** A signed integer that specifies the tint of the color. This value is mapped to the range -1.0 to 1.0. Positive values lighten the color, and negative values darken the color. MUST NOT equal -32768. + +**dwRgba (4 bytes):** A [LongRGBA](#longrgba) that specifies the color. + +### XFPropGradient + +The **XFPropGradient** structure specifies a [**gradient fill**](#gt_35280309-5b22-4c17-be48-f06c37ffc685). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
type
numDegree
...
numFillToLeft
...
numFillToRight
...
numFillToTop
...
numFillToBottom
...
+ +**type (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies the gradient type. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00000000 | [**Linear gradient**](#gt_66edee6e-7500-4703-853d-44f9cd16540a) | +| 0x00000001 | [**Rectangular gradient**](#gt_bc10f1e2-8a79-4d73-92ff-f4648d3f0ada) | + +**numDegree (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the gradient angle in degrees for a linear gradient. The gradient angle specifies the angle at which gradient strokes are drawn. + +**numFillToLeft (8 bytes):** An Xnum that specifies the left coordinate of the [**inner rectangle**](#gt_7f6fb91e-9a0b-42e8-93ff-751448f7f80f) for a rectangular gradient, where (0.0,0.0) is the upper-left hand corner of the inner rectangle. MUST be greater than or equal to 0.0 and less than or equal to 1.0. + +**numFillToRight (8 bytes):** An Xnum that specifies the right coordinate of the inner rectangle for a rectangular gradient, where (0.0,0.0) is the upper-left hand corner of the inner rectangle. MUST be greater than or equal to 0.0 and less than or equal to 1.0. + +**numFillToTop (8 bytes):** An Xnum that specifies the top coordinate of the inner rectangle for a rectangular gradient, where (0.0,0.0) is the upper-left hand corner of the inner rectangle. MUST be greater than or equal to 0.0 and less than or equal to 1.0. + +**numFillToBottom (8 bytes):** An Xnum that specifies the bottom coordinate of the inner rectangle for a rectangular gradient, where (0.0,0.0) is the upper-left hand corner of the inner rectangle. MUST be greater than or equal to 0.0 and less than or equal to 1.0. + +### XFPropGradientStop + +The **XFPropGradientStop** structure specifies a [**gradient stop**](#gt_35b983af-d590-4f93-87cb-94786924511f) for a [**gradient fill**](#gt_35280309-5b22-4c17-be48-f06c37ffc685). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
unusednumPosition
...
...color
...
...
+ +**unused (2 bytes):** Undefined and MUST be ignored. + +**numPosition (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the gradient stop position. The gradient stop position is the position within the gradient range where this gradient stop’s color begins. MUST be greater than or equal to 0.0 and less than or equal to 1.0. + +**color (8 bytes):** An [XFPropColor](#xfpropcolor) that specifies the gradient stop color. + +### XFProps + +This structure specifies an array of formatting properties. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
reservedcprops
xfPropArray (variable)
...
+ +**reserved (2 bytes):** MUST be zero and MUST be ignored. + +**cprops (2 bytes):** An unsigned integer that specifies the number of [XFProp](#xfprop) structures in **xfPropArray.** + +**xfPropArray (variable):** An array of XFProp. Each array element specifies a formatting property. The array of properties specifies the full set of formatting properties. If the array contains an XFProp with an **xfPropType** field equaling 0, the array MUST NOT contain any XFProp elements with **xfPropType** fields equaling 3 or 4. If the array contains an XFProp with an **xfPropType** field equaling 3 or 4, the array MUST NOT contain any XFProp elements with an **xfPropType** field equaling 0. + +### XFPropTextRotation + +The **XFPropTextRotation** structure specifies the text rotation. + + ++++++++++ + + + + + + + + + + + + + + + + + +
01234567
trot
+ +**trot (1 byte):** An unsigned integer that specifies the text rotation. MUST be a value from the following table: + +| Value | Meaning | +|--------------------------|-----------------------------------------------| +| 0x00 to 0x5A (0 to 90) | Text rotated counterclockwise 0 to 90 degrees | +| 0x5B to 0xB4 (91 to 180) | Text rotated clockwise 1 to 90 degrees | +| 0xFF (255) | Vertical text | + +### XLNameUnicodeString + +The **XLNameUnicodeString** structure specifies a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
name (variable)
...
+ +**name (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the name. The number of characters in the string, **name.cch,** MUST be greater than or equal to 1 and less than or equal to 255. + +This field MUST adhere to the following grammar: + +465. name = name-start-character, \*name-characters + + name-start-character = "\_" / "\\ / Unicode-character + + name-character = name-start-character / "." / "?" / 0x061F / Unicode-digit + +where: + +Unicode-character is any code point which is a character as defined by the Unicode character properties in chapter four of the [\[RFC2781\]](https://go.microsoft.com/fwlink/?LinkId=90380) + +Unicode-digit is any code point which is a digit as defined by the Unicode character properties in chapter four of the \[RFC2781\]. + +This field MUST NOT be equal to "TRUE" or "FALSE" using case-insensitive string comparison. This field MUST NOT be an [**R1C1**](#gt_c7769777-74d5-4020-b9e5-4cd863f70132) or [**A1**](#gt_950691d0-4b64-4e03-84ae-10d6c872bbdb) [**cell reference**](#gt_4d15aeb2-3a7d-44d7-b8d1-8a441f1cc24f). + +An R1C1 [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) reference is defined to be: + +470. R1C1-cell-reference= R1C1-row R1C1-column / R1C1-column R1C1-row + + R1C1-row = letter-r row-number + + letter-r = "R" / "r" + + R1C1-column = letter-c column-number + + letter-c = "C" / "c" + + column-number = 1-256 + + row-number = 1-65536 + +An A1 cell reference is defined as follows: + +482. A1-reference = A1-column A1-Row + + A1-row = row-number + + ; See definition of row-number in R1C1 cell reference grammar specified previously. + + A1-column = letter / letter-limited-one letter / letter-i letter-limited-two + + letter-limited-one = "A" / "B" / "C" / "D" / "E" / "F" / "G" / "H" / "a" / "b" / "c" / "d" / "e" / "f" / "g" / "h" + + letter-limited-two = letter-limited-one / "I" / "J" / "K" / "L" / "M" / "N" / "O" / "P" / "Q" / "R" / "S" / "T" / "U" / "V" / "i" / "j" / "k" / "l" / "m" / "n" / "o" / "p" / "q" / "r" / "s" / "t" / "u" / "v" + + letter-i = "I" / "i" + + letter = letter-limited-two / "W" / "X" / "Y" / "Z" / "w" / "x" / "y" / "z" + +### XlsFilter_Criteria + +The **XlsFilter_Criteria** structure specifies [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) criteria. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ezdoper1
...
...ezdoper2
...
...
djoin1
reserved
+ +**ezdoper1 (10 bytes):** An [SXEZDoper](#sxezdoper) structure that specifies the first filter operation. If the **ccriteria** field of the [SXAddl_SXCSXFilter12_SXDXlsFilter](#sxaddl_sxcsxfilter12_sxdxlsfilter) that contains this structure is zero, then **ezdoper1.vts** MUST be zero and **ezdoper1** MUST be ignored. If **ezdoper1.vts** equals 0x6, the following record MUST be [SXAddl_SXCSXFilter12_SXDXlsFilterValue1](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1). + +**ezdoper2 (10 bytes):** An SXEZDoper structure that specifies the second filter operation. If the **ccriteria** field of the SXAddl_SXCSXFilter12_SXDXlsFilter that contains this structure is not equal to 2, then **ezdoper2.vts** MUST be zero and **ezdoper2** MUST be ignored. If **ezdoper1.vts** is not 0x6 and **ezdoper2.vts** is 0x6, then the following record is [SXAddl_SXCSXFilter12_SXDXlsFilterValue2](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2). If both **ezdoper1.vts** and **ezdoper2.vts** are 0x6, then the following record is SXAddl_SXCSXFilter12_SXDXlsFilterValue1, and the next non- [Continue_SxaddlSxString](#continue_sxaddlsxstring) record after that is SXAddl_SXCSXFilter12_SXDXlsFilterValue2. + +**djoin1 (4 bytes):** A [**DJoin**](#djoin) that specifies the join operation between **ezdoper1** and **ezdoper2**. + +MUST be DJOINNULL if the **ccriteria** field of the SXAddl_SXCSXFilter12_SXDXlsFilter record is less than 2. + +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +### XlsFilter_Top10 + +The **XlsFilter_Top10** structure specifies filter information for a [**top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
top10ft
Areserved1numTopN
...
...reserved2 (14 bytes)
...
...
...
+ +**top10ft (4 bytes):** A [Top10FT](#top10ft) that specifies the top N filter type. + +**A - fTop (1 bit):** A bit that specifies whether the filter displays the top or bottom records. + +| Value | Meaning | +|-------|-----------------------------| +| 0 | Display the bottom records. | +| 1 | Display the top records. | + +**reserved1 (15 bits):** MUST be zero, and MUST be ignored. + +**numTopN (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the number or percentage of records to include. + +If **top10Ft** is TOP10FTPERCENT, **numTopN** specifies the percentage of records to include; otherwise **numTopN** specifies the number of records to include. + +If **top10ft** is TOP10FTPERCENT, **numTopN** MUST be greater than or equal to 0 and less than or equal to 100. + +If **top10ft** is TOP10FTSUM, **numTopN** MUST be greater than or equal to 0 and less than or equal to 2147483647. + +If **top10ft** is TOP10FTCOUNT, **numTopN** MUST be an integer greater than or equal to 0 and less than or equal to 2147483647. + +**reserved2 (14 bytes):** MUST be zero, and MUST be ignored. + +### XLUnicodeRichExtendedString + +The **XLUnicodeRichExtendedString** structure specifies a Unicode string, which can contain formatting information and [**phonetic string**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77) data. + +This structure’s non-variable fields MUST be specified in the same record. + +This structure’s variable fields can be extended with [Continue](#continue) records. A value from the table for **fHighByte** MUST be specified in the first byte of the **continue** field of the Continue record followed by the remaining portions of this structure’s variable fields. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cchABCDreserved2cRun (optional)
...cbExtRst (optional)
...rgb (variable)
…
rgRun (variable, optional)
…
ExtRst (variable, optional)
…
+ +**cch (2 bytes):** An unsigned integer that specifies the count of characters in the string. + +**A -** **fHighByte (1 bit):** A bit that specifies whether the characters in **rgb** are double-byte characters. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | All the characters in the string have a high byte of 0x00 and only the low bytes are in **rgb**. | +| 0x1 | All the characters in the string are saved as double-byte characters in **rgb**. | + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fExtSt (1 bit):** A bit that specifies whether the string contains phonetic string data. + +**D - fRichSt (1 bit):** A bit that specifies whether the string is a rich string and the string has at least two character formats applied. + +**reserved2 (4 bits):** MUST be zero, and MUST be ignored. + +**cRun (2 bytes):** An optional unsigned integer that specifies the number of elements in **rgRun**. MUST exist if and only if **fRichSt** is 0x1. + +**cbExtRst (4 bytes):** An optional signed integer that specifies the byte count of **ExtRst**. MUST exist if and only if **fExtSt** is 0x1. MUST be zero or greater. + +**rgb (variable):** An array of bytes that specifies the characters in the string. If **fHighByte** is 0x0, the size of the array is **cch**. If **fHighByte** is 0x1, the size of the array is **cch**\*2. If **fHighByte** is 0x1 and **rgb** is extended with a Continue record the break MUST occur at the double-byte character boundary. + +**rgRun (variable):** An optional array of [FormatRun](#formatrun) structures that specifies the formatting for each [**text run**](#gt_393612a7-9552-48b0-abf6-0371dbd6d553). The number of elements in the array is **cRun**. MUST exist if and only if **fRichSt** is 0x1. + +**ExtRst (variable):** An optional [ExtRst](#extrst) that specifies the phonetic string data. The size of this field is **cbExtRst**. MUST exist if and only if **fExtSt** is 0x1. + +### XLUnicodeString + +The **XLUnicodeString** structure specifies a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cchAreservedrgb (variable)
...
+ +**cch (2 bytes):** An unsigned integer that specifies the count of characters in the string. + +**A -** **fHighByte (1 bit):** A bit that specifies whether the characters in **rgb** are double-byte characters. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | All the characters in the string have a high byte of 0x00 and only the low bytes are in **rgb**. | +| 0x1 | All the characters in the string are saved as double-byte characters in **rgb**. | + +**reserved (7 bits):** MUST be zero, and MUST be ignored. + +**rgb (variable):** An array of bytes that specifies the characters. If **fHighByte** is 0x0, the size of the array MUST be equal to **cch**. If **fHighByte** is 0x1, the size of the array MUST be equal to **cch\***2. + +### XLUnicodeStringMin2 + +The **XLUnicodeStringMin2** structure specifies a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cchst (variable)
...
+ +**cch (2 bytes):** An unsigned integer that specifies the count of characters in the string. MUST be equal to the number of characters in **st**. + +**st (variable):** An optional [XLUnicodeStringNoCch](#xlunicodestringnocch) that specifies the string. MUST exist if and only if **cch** is greater than zero. + +### XLUnicodeStringNoCch + +The **XLUnicodeStringNoCch** structure specifies a Unicode string. When an XLUnicodeStringNoCch is used, the count of characters in the string MUST be specified in the structure that uses the XLUnicodeStringNoCch. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
Areservedrgb (variable)
...
+ +**A - fHighByte (1 bit):** A bit that specifies whether the characters in **rgb** are double-byte characters. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | All the characters in the string have a high byte of 0x00 and only the low bytes are in **rgb**. | +| 0x1 | All the characters in the string are saved as double-byte characters in **rgb**. | + +**reserved (7 bits):** MUST be zero, and MUST be ignored. + +**rgb (variable):** An array of bytes that specifies the characters. If **fHighByte** is 0x0, the size of the array MUST be equal to the count of characters in the string. If **fHighByte** is 0x1, the size of the array MUST be equal to 2 times the count of characters in the string. + +### XLUnicodeStringSegmented + +The **XLUnicodeStringSegmented** structure specifies a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string that is split into multiple string segments. If the count of characters in the string is greater than 512, the string is split into multiple string segments, each of which has a character count of 512 or less. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cchTotal
strings (variable)
...
+ +**cchTotal (4 bytes):** An unsigned integer that specifies the total count of characters in the string. MUST be less than 2147483644. + +**strings (variable):** An array of [XLUnicodeString](#xlunicodestring). Each element specifies a string segment. The **cch** field of each XLUnicodeString element MUST be less than or equal to 512 and greater than 0, and the sum of the **cch** fields of all XLUnicodeString elements MUST be equal to **cchTotal**. MUST exist if and only if **cchTotal** is greater than zero. + +### XLUnicodeStringSegmentedRTD + +The **XLUnicodeStringSegmentedRTD** structure specifies a Unicode string that contains a set of sub-strings. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cch
Areservedrgb (variable)
...
+ +**cch (4 bytes):** An unsigned integer that specifies the size of **rgb**. + +**A - fHighByte (1 bit):** A bit that specifies whether the characters in **rgb** are double-byte characters. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | All the characters in the string have a high byte of 0x00 and only the low bytes are in **rgb**. | +| 0x1 | All the characters in the string are saved as double-byte characters in **rgb**. | + +**reserved (7 bits):** MUST be zero, and MUST be ignored. + +**rgb (variable):** An array of bytes that specifies a set of sub-strings. If **fHighByte** is 0x0, the size of the array is **cch**. If **fHighByte** is 0x1, the size of the array is **cch\***2. Each sub-string begins with one or two bytes specifying the count of characters in the sub-string. The count is one byte in length if **fHighByte** is zero and two bytes in length if **fHighByte** is 1. The number of the sub-strings MUST be greater than 2 and less than 40. + +### XLUnicodeStringSegmentedSXAddl + +The **XLUnicodeStringSegmentedSXAddl** structure specifies a Unicode string segment. [SXAddl](#sxaddl) records use this structure to represent Unicode strings. If the count of characters in the string is greater than 255, the string is split into multiple segments. Each string segment has a character count of 255 or less, and each segment is stored in an SXAddl record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cchTotal
reservedstrings (variable)
...
+ +**cchTotal (4 bytes):** An unsigned integer that specifies the total count of characters in the string. If this is the first segment of a string, **cchTotal** MUST be greater than 0. If this is not the first segment of a string, **cchTotal** MUST be zero. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**string (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the string segment. The **cch** field of **string** MUST be less than or equal to 255 and greater than 0. + +### XmlTkBackWallThicknessFrt + +The **XmlTkBackWallThicknessFrt** structure specifies the thickness of the back wall of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) as a percentage of the depth of the 3-D [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). The back wall is the [**wall**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c) that is parallel to the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the back wall thickness is greater than 0. MUST only be specified if the chart contains a [Chart3d](#chart3d) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
wallThickness
...
+ +**wallThickness (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies the thickness of the back wall of the chart as a percentage of the depth of the 3-D plot area. The **wallThickness.dValue** MUST be greater than 0, and less than or equal to 100. The **wallThickness.xtHeader.xmlTkTag** field MUST be equal to 0x0035. + +### XmlTkBaseTimeUnitFrt + +The **XmlTkBaseTimeUnitFrt** structure specifies the value of the smallest unit of time used by the date [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fAutoBase** field of the corresponding [AxcExt](#axcext) record is set to 1 and the **fDateAxis** of the corresponding AxcExt record is equal to 1. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
baseUnit
...
+ +**baseUnit (6 bytes):** An [XmlTkToken](#xmltktoken) that specifies a value that can override the **duBase** field of the corresponding AxcExt record. The **baseUnit**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x005F. This field overrides the **duBase** field of the corresponding AxcExt record when the **fAutoBase** field of the AxcExt record is set to 1. The **baseUnit.dValue** MUST be a value from the following table: + +| Value | Meaning | +|--------|-----------------------------------| +| 0x0060 | Time value is measured in days. | +| 0x0061 | Time value is measured in months. | +| 0x0062 | Time value is measured in years. | + +### XmlTkBlob + +The **XmlTkBlob** structure specifies an array of bytes for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xtHeader
cbBlob
rgbBlob (variable)
...
+ +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x07. + +**cbBlob (4 bytes):** An unsigned integer that specifies the count of bytes of the **rgbBlob** field. + +**rgbBlob (variable):** An array of bytes for the **xmltkChain** field of the CrtMlFrt record. The size of this field, in bytes, is specified by the **cbBlob** field. + +### XmlTkBool + +The **XmlTkBool** structure specifies a Boolean (section [2.5.14](#boolean)) value for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xtHeader
dValueunused
+ +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x02. + +**dValue (1 byte):** A Boolean that specifies the value of this structure. + +**unused (1 byte):** Undefined, and MUST be ignored. + +### XmlTkChain + +The **XmlTkChain** structure specifies a chain of structures that specifies a group of additional properties or property overrides for a given [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) element, specified by the **xmltkParent** field. See meanings of the additional properties or property overrides in each token structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
recordVersionunusedxmltkParent
chainRecords (variable)
...
+ +**recordVersion (1 byte):** An unsigned integer that specifies the chain version. MUST be 0. + +**unused (1 byte):** Undefined, and MUST be ignored. + +**xmltkParent (2 bytes):** An unsigned integer that specifies the chart element targeted by the token structures in the chain. MUST be a value from the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ValueMeaning
0x0001

The record that contains this structure MUST be in a sequence of records that conforms to the DVAXIS rule. This sequence of records specifies the chart element targeted by the token structures in this chain.

+

The token structures in the chain specify scaling properties and MUST be one of the following: XmlTkMaxFrt, XmlTkMinFrt, XmlTkLogBaseFrt

0x0002

The record that contains this structure MUST be in a sequence of records that conforms to the CHARTSHEET or CHARTSHEETCONTENT rule. This sequence of records specifies the chart element targeted by the token structures in this chain.

+

The token structures in the chain specify chart space properties and MUST be one of the following: XmlTkStyle, XmlTkThemeOverride, XmlTkColorMappingOverride

0x0004

The record that contains this structure MUST be in a sequence of records that conforms to the IVAXIS rule and SERIESAXIS rule. This sequence of records specifies the chart element targeted by the token structures in this chain.

+

The token structures in the chain specify Axis properties and MUST be one of the following: XmlTkNoMultiLvlLbl, XmlTkTickLabelSkipFrt, XmlTkTickMarkSkipFrt, XmlTkMajorUnitFrt, XmlTkMinorUnitFrt, XmlTkTickLabelPositionFrt, XmlTkBaseTimeUnitFrt, XmlTkFormatCodeFrt, XmlTkMajorUnitTypeFrt, XmlTkMinorUnitTypeFrt

0x0005

The record that contains this structure MUST be in a sequence of records that conforms to the CHARTFORMATS rule and appears directly before the End record. This sequence of records specifies the chart element targeted by the token structures in this chain.

+

The token structures in the chain specify chart properties and MUST be one of the following: XmlTkShowDLblsOverMax, XmlTkBackWallThicknessFrt, XmlTkFloorThicknessFrt, XmlTkDispBlanksAsFrt, XmlTkStartSurface, XmlTkFormatCodeFrt, XmlTkSpb, XmlTkTpb, XmlTkEndSurface

0x000F

The CrtMlFrt record that contains this structure MUST be in a sequence of records that conforms to the LD rule. This sequence of records specifies the chart element targeted by the token structures in this chain.

+

The token structures in the chain specify Legend properties and MUST be: XmlTkOverlay

0x0013

The record that contains this structure MUST be in a sequence of records that conforms to the SS rule. This sequence of records specifies the chart element targeted by the token structures in this chain.

+

The token structures in the chain specify data marker properties and MUST be: XmlTkSymbolFrt

0x0016

The record that contains this structure MUST be in a sequence of records that conforms to the CHARTFORMATS rule and appears directly before the End record. This sequence of records specifies the chart element targeted by the token structures in this chain.

+

The token structures in the chain specify Plot area properties and MUST be: XmlTkPieComboFrom12Frt

0x0019

The record that contains this structure MUST be in a sequence of records that conforms to the ATTACHEDLABEL within the CHARTFORMATS rule. This sequence of records specifies the chart element targeted by the token structures in this chain.

+

The token structures in the chain specify Chart title properties and MUST be: XmlTkOverlay

0x0037

The record that contains this structure MUST be in a sequence of records that conformed to the CHARTFORMATS rule and appears directly before the End record. This sequence of records specifies the chart element targeted by the token structures in this chain.

+

The token structures in the chain specify View 3-D properties and MUST be one of the following: XmlTkRAngAxOffFrt, XmlTkPerspectiveFrt, XmlTkRotYFrt, XmlTkRotXFrt, XmlTkHeightPercent

+ +**chainRecords (variable):** A chain of structures that specifies the additional properties or property overrides for a given chart element, specified by the **xmltkParent** field. The token sequence [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) for each **xmltkParent** is specified according to the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
xmltkParentABNF
0x0001chainRecords = [XmlTkMaxFrt] [XmlTkMinFrt] [XmlTkLogBaseFrt]
0x0002chainRecords = [XmlTkStyle] [XmlTkThemeOverride] [XmlTkColorMappingOverride]
0x0004chainRecords = [XmlTkNoMultiLvlLbl] [XmlTkTickLabelSkipFrt] [XmlTkTickMarkSkipFrt] [XmlTkMajorUnitFrt] [XmlTkMinorUnitFrt] [XmlTkTickLabelPositionFrt] [XmlTkBaseTimeUnitFrt] [XmlTkFormatCodeFrt] [XmlTkMajorUnitTypeFrt] [XmlTkMinorUnitTypeFrt]
0x0005

chainRecords = [XmlTkShowDLblsOverMax] [XmlTkBackWallThicknessFrt] [XmlTkFloorThicknessFrt] [XmlTkDispBlanksAsFrt] [SURFACE]

+

SURFACE = XmlTkStartSurface [XmlTkFormatCodeFrt [XmlTkSpb]] [XmlTkTpb] XmlTkEndSurface

0x000FchainRecords = [XmlTkOverlay]
0x0013chainRecords = [XmlTkSymbolFrt]
0x0016chainRecords = [XmlTkPieComboFrom12Frt]
0x0019chainRecords = [XmlTkOverlay]
0x0037chainRecords = [XmlTkRAngAxOffFrt] [XmlTkPerspectiveFrt] [XmlTkRotYFrt] [XmlTkRotXFrt] [XmlTkHeightPercent]
+ +### XmlTkColorMappingOverride + +The **XmlTkColorMappingOverride** structure specifies the color mapping override for a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), stored as an **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)) as specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, section 19.3.1.7. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgThemeOverride (variable)
...
+ +**rgThemeOverride (variable):** An [XmlTkBlob](#xmltkblob) that specifies the color mapping override. The **rgThemeOverride.xtHeader.xmlTkTag** MUST be equal to 0x0034. The **XML stream** (section 2.1.7.22) is specified in \[ECMA-376\] Part 1, section 19.3.1.7, and compressed by the compression algorithm specified in [\[RFC1951\]](https://go.microsoft.com/fwlink/?LinkId=90302). + +### XmlTkDispBlanksAsFrt + +The **XmlTkDispBlanksAsFrt** structure specifies how blank data entries are represented. This structure MUST only be present if the current [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) does not support displaying blank entries. The following [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) types do not support blank entries: area chart group, pie chart group, line chart group with **fStacked** field of the [Line](#line) record equal to 1, bar of pie chart group, pie of pie chart group and doughnut chart group. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
blanksAs
...
+ +**blanksAs (6 bytes):** An [XmlTkToken](#xmltktoken) that specifies how blank data entries are represented on the current chart. The **blanksAs.xtHeader.xmlTkTag** field MUST be equal to 0x0066. This field overrides the **mdBlank** field of the [ShtProps](#shtprops) record that specifies the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). The **blanksAs.dValue** field MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0067 | Specifies that blank values are shown as a gap. | +| 0x0069 | Specifies that blank values are spanned with a line. The current chart group type MUST be area chart group or line chart group with **fStacked** field of the Line record equal to 1. | + +### XmlTkDouble + +The **XmlTkDouble** structure specifies an Xnum (section [2.5.342](#xnum)) value for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xtHeader
unused
dValue
...
+ +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x03. + +**unused (4 bytes):** Undefined, and MUST be ignored. + +**dValue (8 bytes):** An Xnum that specifies the value of this structure. + +### XmlTkDWord + +The **XmlTkDWord** structure specifies an integer value for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xtHeader
dValue
+ +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x04. + +**dValue (4 bytes):** A signed integer that specifies the value of this structure. + +### XmlTkEnd + +The **XmlTkEnd** structure specifies the end of a group of structures for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xtHeader
+ +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x01. + +### XmlTkEndSurface + +The **XmlTkEndSurface** structure specifies the end of a back wall definition. The back wall is the [**wall**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c) that is parallel to the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure defines additional properties for the back wall of the current [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). This structure MUST have a corresponding [XmlTkStartSurface](#xmltkstartsurface) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
endSurface
+ +**endSurface (4 bytes):** An [XmlTkEnd](#xmltkend) that specifies the end of a back wall definition. The **endSurface.xtHeader.xmlTkTag** field MUST be equal to the **startSurface.xtHeader.xmlTkTag** of the corresponding XmlTkStartSurface structure. + +### XmlTkFloorThicknessFrt + +The **XmlTkFloorThicknessFrt** structure specifies the thickness of the [**floor**](#gt_dc38c098-e0d3-4701-9656-5f2cf4d80f29) of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) as a percentage of the height of the 3-D [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). This structure MUST only be present if the floor thickness is greater than 0. MUST only be specified if the chart contains a [Chart3d](#chart3d) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
floorThickness
...
+ +**floorThickness (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies the thickness of the floor of the chart as a percentage of the height of the 3-D plot area. The **floorThickness.dValue** MUST be greater than 0, and less than or equal to 100. The **floorThickness.xtHeader.xmlTkTag** field MUST be equal to 0x0036. + +### XmlTkFormatCodeFrt + +The **XmlTkFormatCodeFrt** structure specifies the number formatting to use for the [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) labels on the date axis. This structure MUST only be present if the **fUnlinkedIfmt** field of the [BRAI](#brai) record that corresponds to the axis labels of the date axis is set to 0. This structure MUST only be present if the **fDateAxis** of the corresponding [AxcExt](#axcext) record is equal to 1. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
stFormat (variable)
...
+ +**stFormat (variable):** An [XmlTkString](#xmltkstring) that specifies the number formatting to use for the axis labels of the date axis. Details about the structure of [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) string are specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1: Fundamentals And Markup Language Reference, section 18.8.31. This field overrides the **ifmt** field of the corresponding BRAI record when the **fUnlinkedIfmt** field of the BRAI record is set to 0. The **stFormat.xtHeader.xmlTkTag** field MUST be equal to 0x0064. + +### XmlTkHeader + +The **XmlTkHeader** structure specifies the header of the [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) token data types. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
drTypeunusedxmlTkTag
+ +**drType (1 byte):** An unsigned integer that specifies the data type. MUST be specified by the containing structure. + +**unused (1 byte):** Undefined, and MUST be ignored. + +**xmlTkTag (2 bytes):** An unsigned integer that specifies the token identifier. MUST be specified by the containing structure. + +### XmlTkHeightPercent + +The **XmlTkHeightPercent** structure specifies the height of the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) as a percentage of its width. This record MUST NOT exist for a pie [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), and MUST only exist when a [Chart3d](#chart3d) record is present and the **f3DScaling** field of the Chart3d record is equal to 1. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
heightPercent (16 bytes)
...
...
+ +**heightPercent (16 bytes):** An [XmlTkDouble](#xmltkdouble) that specifies the height of the plot area as a percentage of its width. **heightPercent.dValue** MUST be greater than or equal to 5, MUST be less than the maximum value of Xnum , and SHOULD[\<190\>](#Appendix_A_190) be less than or equal to 500. This field overrides the **pcHeight** field of the Chart3d record in the [chart sheet](#chart-sheet-substream) substream. The **heightPercent.xtHeader.xmlTkTag** MUST be equal to 0x0065. + +### XmlTkLogBaseFrt + +The **XmlTkLogBaseFrt** structure specifies the logarithmic base of a logarithmic value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fLog** field of the corresponding [ValueRange](#valuerange) record is set to 1, and the logarithmic base is not 10. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
logScale (16 bytes)
...
...
+ +**logScale (16 bytes):** An [XmlTkDouble](#xmltkdouble) that specifies the logarithmic base of a logarithmic value axis. **logScale.dValue** MUST be greater than or equal to 2, and less than or equal to 1000. The **logScale**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x0000. This field overrides the base, 10, of the logarithmic value axis when the **fLog** field of the corresponding ValueRange record is set to 1. + +### XmlTkMajorUnitFrt + +The **XmlTkMajorUnitFrt** structure specifies the value of the interval at which the [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) are displayed on the date [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fAutoBase** field of the corresponding [AxcExt](#axcext) record is set to 1 and the **fDateAxis** field of the corresponding AxcExt record is equal to 1. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
majorUnit (16 bytes)
...
...
+ +**majorUnit (16 bytes):** An [XmlTkDouble](#xmltkdouble) that specifies a value that can override the **catMajor** field of the corresponding AxcExt record. The **majorUnit**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x0053. This field overrides the **catMajor** field of the corresponding AxcExt record when the **fAutoMajor** field of the AxcExt record is set to 1. + +### XmlTkMajorUnitTypeFrt + +The **XmlTkMajorUnitTypeFrt** structure specifies the value of the unit of time used by the interval at which the [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) are displayed on the date [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fAutoBase** field of the corresponding [AxcExt](#axcext) record is set to 1 and the **fDateAxis** of the corresponding AxcExt record is equal to 1. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
majorUnit
...
+ +**majorUnit (6 bytes):** An [XmlTkToken](#xmltktoken) that specifies a value that can override the **duMajor** field of the corresponding AxcExt record. The **majorUnit**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x006A. This field overrides the **duMajor** field of the corresponding AxcExt record when the **fAutoMajor** field of the AxcExt record is set to 1. The **majorUnit.dValue** MUST be a value from the following table: + +| Value | Meaning | +|--------|-----------------------------------| +| 0x0060 | Time value is measured in days. | +| 0x0061 | Time value is measured in months. | +| 0x0062 | Time value is measured in years. | + +### XmlTkMaxFrt + +The **XmlTkMaxFrt** structure specifies the maximum value on a logarithmic value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fAutoMax** field of the corresponding [ValueRange](#valuerange) record is set to 0, the **fLog** field of the corresponding ValueRange record is set to 1, and the logarithmic base is not 10. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
maxScale (16 bytes)
...
...
+ +**maxScale (16 bytes):** An [XmlTkDouble](#xmltkdouble) that specifies the maximum value on a logarithmic value axis. The **maxScale.dValue** MUST be greater than the value specified in the **minScale.dValue** field of the [XmlTkMinFrt](#xmltkminfrt) structure. The **maxScale**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x0055. This field overrides the **numMax** field of the associated ValueRange record when the **fLog** field of the ValueRange record is set to 1. + +### XmlTkMinFrt + +The **XmlTkMinFrt** structure specifies the minimum value on a logarithmic value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fAutoMin** field of the corresponding [ValueRange](#valuerange) record is set to 0, the **fLog** field of the corresponding ValueRange record is set to 1, and the logarithmic base is not 10. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
minScale (16 bytes)
...
...
+ +**minScale (16 bytes):** An [XmlTkDouble](#xmltkdouble) that specifies the minimum value on a logarithmic value axis. The **minScale.dValue** MUST be less than the value specified in the **maxScale.dValue** field of the [XmlTkMaxFrt](#xmltkmaxfrt) structure. The **minScale**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x0056. This field overrides the **numMin** field of the associated ValueRange record when the **fLog** field of the ValueRange record is set to 1. + +### XmlTkMinorUnitFrt + +The **XmlTkMinorUnitFrt** structure specifies the value of the interval at which the [**minor tick marks**](#gt_c2eb605a-6c5a-427e-8608-f16940de82a6) are displayed on the date [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fAutoBase** field of the corresponding [AxcExt](#axcext) record is set to 1 and the **fDateAxis** of the corresponding AxcExt record is equal to 1. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
minorUnit (16 bytes)
...
...
+ +**minorUnit (16 bytes):** An [XmlTkDouble](#xmltkdouble) that specifies a value that can override the **catMinor** field of the corresponding AxcExt record. The **minorUnit**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x0054. This field overrides the **catMinor** field of the corresponding AxcExt record when the **fAutoMinor** field of the AxcExt record is set to 1. + +### XmlTkMinorUnitTypeFrt + +The **XmlTkMinorUnitTypeFrt** structure specifies the value of the unit of time used by the interval at which the [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) are displayed on the date [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fAutoBase** field of the corresponding [AxcExt](#axcext) record is set to 1 and the **fDateAxis** of the corresponding AxcExt record is equal to 1. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
minorUnit
...
+ +**minorUnit (6 bytes):** An [XmlTkToken](#xmltktoken) that specifies a value that can override the **duMinor** field of the corresponding AxcExt record. The **minorUnit**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x006B. This field overrides the **duMinor** field of the corresponding AxcExt record when the **fAutoMinor** field of the AxcExt record is set to 1. The **minorUnit.dValue** MUST be a value from the following table: + +| Value | Meaning | +|--------|-----------------------------------| +| 0x0060 | Time value is measured in days. | +| 0x0061 | Time value is measured in months. | +| 0x0062 | Time value is measured in years. | + +### XmlTkNoMultiLvlLbl + +The **XmlTkNoMultiLvlLbl** structure specifies whether multi-level labeling is enabled for a [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
fNoMultiLvlLbl
...
+ +**fNoMultiLvlLbl (6 bytes):** An [XmlTkBool](#xmltkbool) that specifies whether single-level labeling is enabled for a category axis. The **fNoMultiLvlLbl**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x002E. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------------| +| 0 | Multi-level labeling is enabled for a category axis. | +| 1 | Single-level labeling is enabled for a category axis. | + +### XmlTkOverlay + +The **XmlTkOverlay** structure specifies whether the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) [legend](#Section_1832229b7d1945f488d455e9c07466f0) and title can overlap or can overlap other chart elements. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
fOverlay
...
+ +**fOverlay (6 bytes):** An [XmlTkBool](#xmltkbool) that specifies whether the chart legend or title can overlap or can overlap other chart elements. **fOverlay.dValue** MUST be 1. The **fOverlay**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x002F. + +### XmlTkPerspectiveFrt + +The **XmlTkPerspectiveFrt** structure specifies the angle of the field of view for the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). This structure MUST exist only for bar [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5) and pie chart groups, and MUST exist only when the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) contains a [Chart3d](#chart3d) record and the **fPerspective** field of the Chart3d record equal to 1. When the angle of the field of view is the default angle, 20, this structure MUST NOT be present. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
perspectiveAngle
...
+ +**perspectiveAngle (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies the angle of the field of view. The **perspectiveAngle.xtHeader.xmlTkTag** field MUST be 0x004D. The value of **perspectiveAngle.dValue** field MUST equal to two times the view angle and MUST be greater than or equal to 0 and less than or equal to 200. This field overrides the **pcDist** field of the Chart3d record in the [chart sheet](#chart-sheet-substream) substream. + +### XmlTkPieComboFrom12Frt + +The **XmlTkPieComboFrom12Frt** structure specifies whether the current [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) contains multiple [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5) and one of them is a pie chart group. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
fPieCombo
...
+ +**fPieCombo (6 bytes):** An [XmlTkBool](#xmltkbool) that specifies whether the current chart contains multiple chart groups and one of them is a pie chart group. **fPieCombo.dValue** MUST be 1. The **fPieCombo**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x005E. + +### XmlTkRAngAxOffFrt + +The **XmlTkRAngAxOffFrt** structure specifies whether the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) is rendered with a vanishing point, rather than rendered at right angles. This structure MUST only exist for a bar [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), and only when the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) contains a [Chart3d](#chart3d) record is present and the **fPerspective** field of the Chart3d record equal to 1. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
fRightAngAxOff
...
+ +**fRightAngAxOff (6 bytes):** An [XmlTkBool](#xmltkbool) that specifies whether the plot area is rendered with a vanishing point. This field corresponds to the **fPerspective** field of Chart3d record, and it MUST only be present when the **fPerspective** field of the Chart3d record in the [chart sheet](#chart-sheet-substream) substream is equal to 1. The **fRightAngAxOff.dValue** field MUST be equal to 0x01. The **fRightAngAxOff.xtHeader.xmlTkTag** field MUST be equal to 0x0050. + +### XmlTkRotXFrt + +The **XmlTkRotXFrt** structure specifies the clockwise rotation, in degrees, of the 3-D [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) around a horizontal line through the center of the 3-D plot area. It MUST only be present when the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) contains a [Chart3d](#chart3d), and as specified by the **fPerspective** field of the Chart3d record. This structure MUST only exist for a bar [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), and only when the rotation angle is less than 0 or greater than 44. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rotationX
...
+ +**rotationX (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies the rotation angle. The **rotationX.xtHeader.xmlTkTag** field MUST be 0x004E. The **rotationX.dValue** field MUST be either greater than or equal to -90 and less than 0, or greater than or equal to 45 and less than or equal to 90. It overrides the **anElev** field of the Chart3d record in the [chart sheet](#chart-sheet-substream) substream. + +### XmlTkRotYFrt + +The **XmlTkRotYFrt** structure specifies the clockwise rotation, in degrees, of the 3-D [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) around a vertical line through the center of the 3-D plot area. MUST exist only when the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) contains a [Chart3d](#chart3d) record, and as specified by the **fPerspective** field of the Chart3d record. This record MUST only exist for a bar [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), and only when the rotation angle is greater than 44. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rotationY
...
+ +**rotationY (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies the rotation angle. The **rotationY.xtHeader.xmlTkTag** field MUST be 0x004F. The **rotationY.dValue** field MUST be greater than or equal to 45, and less than or equal to 359. It overrides the **anRot** field of the Chart3d record [chart sheet](#chart-sheet-substream) substream. + +### XmlTkShowDLblsOverMax + +The **XmlTkShowDLblsOverMax** structure specifies whether [data labels](#Section_cac7f43a3af142f58ff2814c2870427f) with values over the maximum value of the value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) are displayed. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
fVDLOverMax
...
+ +**fVDLOverMax (6 bytes):** An [XmlTkBool](#xmltkbool) that specifies whether data labels with values over the maximum value of the value axis of the chart are displayed. The **fVDLOverMax**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x005B. + +### XmlTkSpb + +The **XmlTkSpb** structure specifies the shape formatting information of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) object, stored as an **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)) as defined in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, section 21.2.2.197. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
shapePropsStream (variable)
...
+ +**shapePropsStream (variable):** An [XmlTkBlob](#xmltkblob) that specifies the shape formatting information. The **shapePropsStream.xtHeader.xmlTkTag** MUST be equal to 0x001E. The **XML stream** (section 2.1.7.22) is defined in \[ECMA-376\] Part 1, section 21.2.2.197, and compressed by the compression algorithm specified in [\[RFC1951\]](https://go.microsoft.com/fwlink/?LinkId=90302). + +### XmlTkStart + +The **XmlTkStart** structure specifies the start of a group of structures for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xtHeader
+ +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x00. + +### XmlTkStartSurface + +The **XmlTkStartSurface** structure specifies the beginning of a back wall. The back wall definition applies to the current [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) back wall. The back wall is the [**wall**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c) that is parallel to the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST have a corresponding [XmlTkEndSurface](#xmltkendsurface) structure. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
startSurface
+ +**startSurface (4 bytes):** An [XmlTkStart](#xmltkstart) that specifies which surface is defined. The **startSurface.xtHeader.xmlTkTag** field MUST be equal to a value from the following table: + +| Value | Meaning | +|--------|---------------------------------| +| 0x0059 | The side wall is being defined. | + +### XmlTkString + +The **XmlTkString** structure specifies a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string value for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xtHeader
cchValue
rgbValue (variable)
...
+ +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x05. + +**cchValue (4 bytes):** An unsigned integer that specifies the count of characters of the **rgbValue** field. + +**rgbValue (variable):** An array of Unicode characters. The size of the array, in characters, is specified by the **cchValue** field. The size of the field, in bytes, MUST equal the result of the following formula: + +498. cchValue \* 2. + +### XmlTkStyle + +The **XmlTkStyle** structure specifies which built-in [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) is applied to the chart. This structure MUST only exist when a non-default chart style is used. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
chartStyle
...
+ +**chartStyle (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies a one-based index into the [Style](#style) record of the [Global substream](#Section_ca4c174887294a93abb94602b3a01fb1). MUST be greater than or equal to 1 and less than or equal to 48. MUST NOT be 2. The **chartStyle.xtHeader.xmlTkTag** MUST be equal to 0x0003. + +### XmlTkSymbolFrt + +The **XmlTkSymbolFrt** structure specifies which built-in marker [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) is applied to the [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) of the current line, scatter or radar [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
markerStyle
...
+ +**markerStyle (6 bytes):** An [XmlTkToken](#xmltktoken) that specifies the built-in marker style applied to the data markers of the current line, scatter or radar chart group. The **markerStyle.xtHeader.xmlTkTag** MUST be equal to 0x0022. It overrides the **imk** field of the [MarkerFormat](#markerformat) record when the **fAuto** field of the MarkerFormat record is set to 1. The **markerStyle.dValue** field MUST be equal to a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0023 | Specifies nothing shall be drawn at each [data point](#Section_9c986ad250d44fa1a157063ac5c971a0). | +| 0x0024 | Specifies a diamond shall be drawn at each data point. | +| 0x0025 | Specifies a square shall be drawn at each data point. | +| 0x0026 | Specifies a triangle shall be drawn at each data point. | +| 0x0027 | Specifies an X shall be drawn at each data point. | +| 0x0028 | Specifies a star shall be drawn at each data point. | +| 0x0029 | Specifies a dot shall be drawn at each data point. | +| 0x002A | Specifies a dash shall be drawn at each data point. | +| 0x002B | Specifies a circle shall be drawn at each data point. | +| 0x002C | Specifies a plus shall be drawn at each data point. | + +### XmlTkThemeOverride + +The **XmlTkThemeOverride** structure specifies theme definition override for a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), stored as an **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)) as defined in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, section 20.1.6.12. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
rgThemeOverride (variable)
...
+ +**rgThemeOverride (variable):** An [XmlTkBlob](#xmltkblob) that specifies the theme override. The **rgThemeOverride.xtHeader.xmlTkTag** MUST be equal to 0x0033. The **XML stream** (section 2.1.7.22) is defined in \[ECMA-376\] Part 1, section 20.1.6.12, and compressed by the compression algorithm specified in [\[RFC1951\]](https://go.microsoft.com/fwlink/?LinkId=90302). + +### XmlTkTickLabelPositionFrt + +The **XmlTkTickLabelPositionFrt** structure specifies that [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) labels on a series axis are center-aligned. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xmltkHigh
...
+ +**xmltkHigh (6 bytes):** An [XmlTkToken](#xmltktoken) that specifies that axis labels on a series axis are center-aligned. This is equivalent to the **vat** field of the corresponding [Text](#text) record being set to 0x02. The **xmltkHigh**.**dValue** MUST be set to 0x005D. The **xmltkHigh**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x005C. This value overrides the **vat** field of the corresponding Text record when the **vat** field of the Text record is not set to 0x02. + +### XmlTkTickLabelSkipFrt + +The **XmlTkTickLabelSkipFrt** structure specifies the interval of labels on the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) or series axis. This structure MUST only be present if the **catLabel** field of the corresponding [CatSerRange](#catserrange) record is not set to 1. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
nInterval
...
+ +**nInterval (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies the number of categories between axis labels on a category axis or series axis. The **nInterval**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x0051. It overrides the **catLabel** field of the corresponding CatSerRange record when the **catLabel** field of the CatSerRange record is not set to 1. + +### XmlTkTickMarkSkipFrt + +The **XmlTkTickMarkSkipFrt** structure specifies the number of [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) to skip on a [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) or a [series](#Section_527ce4dfc9f84e50a314d4b07519593c) axis. This structure MUST only be present if the **catMark** field of the corresponding [CatSerRange](#catserrange) record is not set to 1. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
nInterval
...
+ +**nInterval (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies the number of major tick marks to skip on a category axis or a series axis. The **nInterval**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x0052. It overrides the **catMark** field of the corresponding CatSerRange record when the **catMark** field of the CatSerRange record is not set to 1. + +### XmlTkToken + +The **XmlTkToken** structure specifies a constant value for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
xtHeader
dValue
+ +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x06. + +**dValue (2 bytes):** An unsigned integer that specifies the value of this structure. + +### XmlTkTpb + +The **XmlTkTpb** structure specifies text formatting information for the current chart [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) element, stored as an **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)), as specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, section 21.2.2.216. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
textPropsStream (variable)
...
+ +**textPropsStream (variable):** An [XmlTkBlob](#xmltkblob) that specifies the text formatting information. The **textPropsStream.xtHeader.xmlTkTag** MUST be equal to 0x0020. The **XML stream** (section 2.1.7.22) is specified in \[ECMA-376\] Part 1, section 21.2.2.216, and compressed by the compression algorithm specified in [\[RFC1951\]](https://go.microsoft.com/fwlink/?LinkId=90302). + +### Xnum + +**Xnum** is a 64-bit binary [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d) as specified in [\[IEEE754\]](https://go.microsoft.com/fwlink/?LinkId=89903). This value MUST NOT[\<191\>](#Appendix_A_191) be infinity, denormalized, not-a-number (NaN), nor negative zero. + +### XORObfuscation + +The **XORObfuscation** structure specifies the [**XOR obfuscation**](#gt_cbfd1a35-e8c9-4c5a-bc26-e618633d2f50). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
keyverificationBytes
+ +**key (2 bytes):** An unsigned integer that specifies the [**obfuscation key**](#gt_ae0e1916-4ac2-4c7e-9781-4fc8d8e63362). See [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083), 2.3.6.2 section, the first step of initializing XOR array where it describes the generation of 16-bit XorKey value. + +**verificationBytes (2 bytes):** An unsigned integer that specifies the password verification identifier. See [Password Verifier Algorithm](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4). + +### XTI + +The **XTI** structure specifies a [supporting link](#Section_cc5920ba01074d92bbdfc12ca986f31f) and scope information about that supporting link. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
iSupBookitabFirst
itabLast
+ +**iSupBook (2 bytes):** An unsigned integer that specifies the zero-based index of a [SupBook](#supbook) record in the collection of SupBook records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The referenced SupBook specifies the supporting link referenced by this structure. This value MUST be less than the number of SupBook records in this file. + +**itabFirst (2 bytes):** A signed integer that specifies the scope of the supporting link, and if a scope is specified, the first [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the scope of that supporting link. If the type of supporting link specified by the **cch** and **virtPath** fields of the SupBook record is same-sheet referencing, add-in referencing, DDE [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) referencing, or [**OLE**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) data source referencing, then no scope is specified and this value MUST be -2. Otherwise, this field MUST contain a value from the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + +
ValueMeaning
-2Workbook-level reference that applies to the entire workbook.
-1Sheet-level reference. The first sheet in the reference could not be found.
>= 0

Sheet-level reference. This specifies the first sheet in the reference.

+

If the supporting link type is unused or external workbook referencing, then this value specifies the zero-based index of an XLUnicodeString in the rgst field of the SupBook record specified in iSupBook. This XLUnicodeString specifies the name of the first sheet within the external workbook that is in scope. This sheet MUST be a worksheet or macro sheet.

+

If the supporting link type is self-referencing, then this value specifies the zero-based index of a BoundSheet8 record in the Globals Substream ABNF that specifies the first sheet within the scope of this reference. This sheet MUST be a worksheet or a macro sheet.

+ +**itabLast (2 bytes):** A signed integer that specifies the scope of the supporting link, and if a scope is specified, the last sheet in the scope of that supporting link. If the type of supporting link specified by the **cch** and **virtPath** fields of the SupBook record is same-sheet referencing, add-in referencing, [**DDE**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) data source referencing, or OLE data source referencing, then no scope is specified and this value MUST be -2. Otherwise, this field MUST contain a value from the following table: + + ++++ + + + + + + + + + + + + + + + + + + + + +
ValueMeaning
-2Workbook-level reference that applies to the entire workbook. MUST NOT be used if itabFirst is not equal to -2.
-1Sheet-level reference. The last sheet in the reference could not be found. SHOULD NOT<192> be used if itabFirst is equal to -2.
>= 0

Sheet-level reference. This specifies the last sheet in the reference. MUST NOT be used if itabFirst is equal to -2.

+

If the supporting link type is unused or referring to an external workbook, then this value specifies the zero-based index of an XLUnicodeString in the rgst field of the SupBook record specified in iSupBook. This XLUnicodeString specifies the name of the last sheet within the external workbook that is in scope. This sheet MUST be a worksheet or macro sheet.

+

If the supporting link type is self-referencing, then this value specifies the zero-based index of a BoundSheet8 record in the Globals Substream ABNF that specifies the last sheet within the scope of this reference. This sheet MUST be a worksheet or a macro sheet.

+ +## XCB Structures + +### CTBWRAPPER + +The **CTBWRAPPER** structure specifies a custom toolbar wrapper. This is the root record of the XCB binary stream where custom toolbars are stored. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
ctbSet (14 bytes)
...
...
...rCTB (variable)
...
+ +**ctbSet (14 bytes):** This is a structure of type [CTBS](#ctbs). + +**rCTB (variable):** Zero-based index array of [CTB](#ctb) structures. The number of elements in the array MUST be equal to **ctbSet.ctb**. + +### CTBS + +The **CTBS** record specifies the number of custom toolbars stored in the file and the number of available [**toolbar views**](#gt_c919b821-fb4f-4e0b-abd9-dc8b077f6e39). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
bSignaturebVersionreserved1
reserved2reserved3
ctbctbViews
ictbView
+ +**bSignature (1 byte):** An unsigned integer that specifies the toolbar set signature number. MUST be 0x01. + +**bVersion (1 byte):** An unsigned integer that specifies the toolbar set version number. MUST be 0x01. + +**reserved1 (2 bytes):** MUST be zero and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero and MUST be ignored. + +**ctb (2 bytes):** An unsigned integer that specifies the number of elements in the **rCTB** array of the [CTBWRAPPER](#ctbwrapper) structure that contains this structure. The value MUST be greater than 0x0000. + +**ctbViews (2 bytes):** An unsigned integer that specifies the number of available toolbar views. MUST be 0x0003. There are three view modes and therefore each toolbar has three available views. The view modes are shown in the following table: + +| View mode number | Meaning | +|:--:|----| +| 0 | [**Normal view**](#gt_b3c343ae-05ca-4b91-9cc1-383ee3563990) | +| 1 | [**Full screen view**](#gt_20327411-614f-448f-aa96-4c96726830eb) | +| 2 | [**Web-only view**](#gt_5016b55e-b39a-46e5-9701-472086ebed25)[\<193\>](#Appendix_A_193) | + +**ictbView (2 bytes):** An unsigned integer that specifies the view mode number that the application was in at the time the file was saved. MUST be equal to 0x0000 or 0x0001. + +### CTB + +The **CTB** record specifies a custom toolbar. + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
tb (variable)
...
rVisualData (60 bytes, optional)
...
...
ectbid
rTBC (variable)
...
+ +**tb (variable):** Structure of type TB, as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.1.6, that contains toolbar information. + +**rVisualData (60 bytes):** A zero-based index array of TBVisualData structures, specified in \[MS-OSHARED\] section 2.3.1.9. The number of elements in this array MUST be equal to the value of the **ctbViews** field of the [CTBS](#ctbs) structure contained by the [CTBWRAPPER](#ctbwrapper) structure that contains this structure. The index of each structure in the array corresponds to a view mode number. Refer to the following table for the meaning of each TBVisualData, specified in \[MS-OSHARED\] section 2.3.1.9, structure according to its position in this array: + +| Index of structure in array | Meaning of TBVisualData, specified in \[MS-OSHARED\] section 2.3.1.9, structure | +|:--:|----| +| 0 | Contains the visual information for this toolbar to be used when the application is in [**Normal view**](#gt_b3c343ae-05ca-4b91-9cc1-383ee3563990). | +| 1 | Contains the visual information for this toolbar to be used when the application is in [**Full screen view**](#gt_20327411-614f-448f-aa96-4c96726830eb). | +| 2 | Contains the visual information for this toolbar to be used when the application is in [**Web-only view**](#gt_5016b55e-b39a-46e5-9701-472086ebed25). | + +**ectbid (4 bytes):** A signed integer that specifies the application’s specific custom toolbar identifier. Value MUST be 0x00000FFF. + +**rTBC (variable):** Number of elements in the array MUST be equal to **tb.cCL**. + +### TBC + +The **TBC** record specifies a [**toolbar control**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
tbch (variable)
...
tbcCmd (optional)
tbcd (variable)
...
+ +**tbch (variable):** Structure of type TBCHeader, as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.1.10, that specifies toolbar control header information. + +**tbcCmd (4 bytes):** Structure of type [TBCCmd](#tbccmd). This field MUST only exist when **tbch.tcid** is not equal to 0x0001, 0x06CC (1740), 0x03D8 (984), 0x03EC (1004), or 0x1051 (4177), and the value of **tbch.tct** equals one of the values in the following table: + +| Value of tbch.tct | Meaning | +|----|----| +| 0x01 | Button control | +| 0x02 | Edit control | +| 0x03 | Dropdown control | +| 0x04 | ComboBox control | +| 0x06 | [**SplitDropDown control**](#gt_809470f7-7486-4a44-a50d-2489b32389af) | +| 0x07 | [**OCXDropDown control**](#gt_e139011b-a966-4495-9264-d923ecdfeb66) | +| 0x08 | [**GraphicDropDown control**](#gt_007e8308-eee4-4435-a1f8-e2b27e58f1ac) | +| 0x0A | [**Popup control**](#gt_a259e677-3d9d-47e4-87ba-590fd09734c8) | +| 0x0C | [**ButtonPopup control**](#gt_d638405a-d78b-4c5f-aed2-8616d98d3519) | +| 0x0D | [**SplitButtonPopup control**](#gt_1c046ab6-2530-4a41-8d19-03f92914beaf) | +| 0x0E | [**SplitButtonMRUPopup control**](#gt_01b548cd-095a-4517-a468-1771a038c392) | +| 0x0F | Label control | +| 0x15 | [**Pane control**](#gt_0b77cb34-c2be-4fbe-8f82-df82f7b02b07) | + +**tbcd (variable):** Structure of type TBCData, as specified in \[MS-OSHARED\] section 2.3.1.13, that specifies toolbar control data. MUST exist if **tbch.tct** is not equal to 0x16. MUST NOT exist if **tbch.tct** equals 0x16. + +### TBCCmd + +The **TBCCmd** record specifies a command identifier for a [**toolbar control**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d). + + ++++++++++++++++++++++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
0123456789

1

+

0

123456789

2

+

0

123456789

3

+

0

1
cmdIDABcmdTypeCreserved3
+ +**cmdID (2 bytes):** A signed integer that specifies the command identifier for this toolbar control. Value MUST be in one of the tables specified in sections 2.3, 2.4, 2.5, 2.6, 2.7, and 2.8 of [\[MS-CTXLS\]](%5bMS-CTXLS%5d.pdf#Section_b461dcd9933e471081bcdc1c74801b6b). + +**A - fHideDrawing (1 bit):** A bit that specifies whether the toolbar control is visible if it is disabled. A value of 1 specifies that the toolbar control is not visible if it is disabled. MUST only be used if **cmdType** equals 0x10 or 0x14. MUST be 0 if **cmdType** is not equal to 0x10 and is not equal to 0x14. + +**B - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**cmdType (5 bits):** An unsigned integer that specifies the command type for this toolbar control. Value MUST be in the following table: + +| **Value** | **Meaning** | +|----|:---| +| 0x00 | Toolbar control uses a toolbar control grid command identifier. Value of **cmdType** MUST be one of the values listed in \[MS-CTXLS\] section 2.8. | +| 0x01 | Toolbar control uses a toolbar control command identifier. Value of **cmdType** MUST be one of the values listed in \[MS-CTXLS\] section 2.4. | +| 0x02 | Toolbar control uses a general command identifier. Value of **cmdType** MUST be one of the values listed in \[MS-CTXLS\] section 2.3. | +| 0x03 | Toolbar control uses a menu toolbar control command identifier. Value of **cmdType** MUST be one of the values listed in \[MS-CTXLS\] section 2.5. | +| 0x05 | Toolbar control uses a toolbar command identifier. Value of **cmdType** MUST be one of the values listed in \[MS-CTXLS\] section 2.7. The value of the **tbch.tct** field of the [TBC](#tbc) structure that contains this structure MUST be equal to one of the following values: 0x0A, 0x0C, 0x0D, or 0x0E. | +| 0x07 | Toolbar control uses a menu toolbar command identifier. Value of **cmdType** MUST be one of the values listed in \[MS-CTXLS\] section 2.6. The value of the **tbch.tct** field of the TBC structure that contains this structure MUST be equal to one of the following values: 0x0A, 0x0C, 0x0D, or 0x0E. | +| 0x08 | Toolbar control command is determined by using the value of the **tbch.tcid** field of the TBC structure that contains this structure. | +| 0x10 | Toolbar control uses an MSODGCID specifying a drawing command, as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872). | +| 0x14 | Toolbar control uses an MSODGCID specifying a drawing command, as specified in \[MS-ODRAW\]. | + +**C - reserved2 (1 bit):** MUST be zero and MUST be ignored. + +**reserved3 (8 bits):** MUST be zero and MUST be ignored. + +## Algorithms + +### Application Data For VtHyperlink + +The following algorithm specifies how hyperlink properties ([\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.3.1.18) that are associated with a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells or shapes in a document construct their **dwApp** structure [**member (1)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) value. + +1. If the hyperlink is associated with a shape [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.3.2, the **dwApp** value MUST be 0xFFFFFFFF. + +2. Otherwise the hyperlink MUST be associated with a range of cells on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d), and the **dwApp** value is computed as follows: + +3. Set an unsigned 2-byte integer (wHLIndex) equal to the zero-based index of the [HLink](#hlink) structure or [HLinkTooltip](#hlinktooltip) structure in the sheet that the hyperlink is associated with. + +4. Set an unsigned 2-byte integer (wWSIndex) equal to the zero-based index of the sheet in the document on which this range of cells that the hyperlink is associated with is defined. + +5. The value of **dwApp** MUST be equal to the bitwise OR of wWSIndex shifted 16 bits to the high order and wHLIndex. + +> Example: dwApp = (wWSIndex \<\< 16) \| wHLIndex; + +# Structure Examples + +This section contains examples of some of the most commonly used data structures in MS-XLS files. The examples are meant to be a starting point for an implementer learning the file format. They are not meant to cover all records in the file format. + +The following conventions are followed for all of the examples, unless noted otherwise: + +- The order of the records, structures, and fields within the example match their corresponding order in the file format. + +- The examples begin with the first record relevant to the example and end with the last record relevant to the example. An example cannot be used as a complete and standalone MS-XLS file. + +- The examples are self-contained and contiguous; no records or structures are omitted in the middle of an example. + +- Undefined and ignored fields are not included in the field explanations. + +- Offsets for records and structures are omitted because these values can vary depending on how the files are created and what optional records applications choose to include in files. + +- In the structure diagrams for the examples, the types of arrays are meant for illustration only and can be disregarded. + +## Conditional Formatting + +This example shows conditional formatting applied to [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) A2 with a "between" condition to make the text red when the value is greater than or equal to 1.5, and less than or equal to 2.5. + +The first record in this example is a [CondFmt](#condfmt) record, which specifies beginning of a collection of [CF](#cf) records and defines the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells to which the conditional formatting rule applies. The CF record follows next in this example, defining that conditional formatting rule. + +
+ +

Figure 19: Conditional formatting in this example within a sheet

+
+ +### Conditional Formatting: CondFmt + +The first record in this example, [CondFmt](#condfmt), specifies beginning of a collection of [CF](#cf) records and defines the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) to which the conditional formatting rule applies. + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|-----------| +| 0016 | CondFmt **- CondFmt** | | +| 0002 | USHORT **- ccf** | 0x0001 | +| 1 bit | USHORT **- fToughRecalc** | 0x0 | +| 15 bits | USHORT **- nID** | 0x0000 | +| 0008 | [Ref8U](#ref8u) **- refBound** | | +| 0002 | [RwU](#rwu) **- rwFirst** | | +| 0002 | USHORT **- rw** | 0x0001 | +| 0002 | RwU **- rwLast** | | +| 0002 | USHORT **- rw** | 0x0001 | +| 0002 | [ColU](#colu) **- colFirst** | | +| 0002 | USHORT **- col** | 0x0000 | +| 0002 | ColU **- colLast** | | +| 0002 | USHORT **- col** | 0x0000 | +| 000A | [SqRefU](#sqrefu) **- sqref** | | +| 0002 | USHORT **- cref** | 0x0001 | +| 0008 | RgRef8U **- rgrefs** | | +| 0008 | Ref8U **- ref\[0\]** | | +| 0002 | RwU **- rwFirst** | | +| 0002 | USHORT **- rw** | 0x0001 | +| 0002 | RwU **- rwLast** | | +| 0002 | USHORT **- rw** | 0x0001 | +| 0002 | ColU **- colFirst** | | +| 0002 | USHORT **- col** | 0x0000 | +| 0002 | ColU **- colLast** | | +| 0002 | USHORT **- col** | 0x0000 | + +Figure 20: Structure of CondFmt + +**ccf:** 0x0001 specifies that there is one CF record in the collection that follows this record. + +**fToughRecalc:** 0x0 specifies that the appearance of the cell does not require significant processing. + +**nID:** 0x0000 specifies the identifier for this record. + +**refBound:** A Ref8U structure specifies the bounds of the set of cells to which the rules are applied. + +**refBound.rwFirst:** An RwU structure that specifies the index of the first row in the range. + +**refBound.rwFirst.rw:** 0x0001 specifies that the range starts in row two of the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +**refBound.rwLast:** A RwU structure that specifies index of the last row in the range. + +**refBound.rwLast.rw:** 0x0001 specifies that the range ends in row two of the worksheet. + +**refBound.colFirst:** A ColU structure that specifies the index of the first column in the range. + +**refBound.colFirst.col:** 0x0000 specifies that the range starts in column A of the worksheet. + +**refBound.colLast:** A ColU structure that specifies the index of the last column in the range. + +**refBound.colLast.col:** 0x0000 specifies that the range ends in column A of the worksheet. + +**sqref:** An SqRefU structure that specifies the cells to which the conditional formatting rules apply. + +**sqref.cref:** 0x0001 specifies that there is one Ref8U structure in **rgrefs**. + +**sqref.rgrefs.ref\[0\]:** This is the first Ref8U structure that specifies the range of cells on the sheet where the [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules apply. + +**sqref.rgrefs.ref\[0\].rwFirst.rw:** 0x0001 specifies the range starts in row two of the worksheet. + +**sqref.rgrefs.ref\[0\].rwLast.rw:** 0x0001 specifies the range ends in row two of the worksheet. + +**sqref.rgrefs.ref\[0\].colFirst.col:** 0x0000 specifies the range starts in column A of the worksheet. + +**sqref.rgrefs.ref\[0\].colLast.col:** 0x0000 specifies the range ends in column A of the worksheet. + +### Conditional Formatting: CF + +The next record in this example, [CF](#cf), specifies a conditional formatting rule. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0094 | CF **- Cf** | | +| 0001 | BYTE **- ct** | 0x01 | +| 0001 | BYTE **- cp** | 0x01 | +| 0002 | USHORT **- cce1** | 0x0009 | +| 0002 | USHORT **- cce2** | 0x0009 | +| 007C | [DXFN](#dxfn) **- rgbdxf** | | +| 1 bit | DWORD **- alchNinch** | 0x1 | +| 1 bit | DWORD **- alcvNinch** | 0x1 | +| 1 bit | DWORD **- wrapNinch** | 0x1 | +| 1 bit | DWORD **- trotNinch** | 0x1 | +| 1 bit | DWORD **- kintoNinch** | 0x1 | +| 1 bit | DWORD **- cIndentNinch** | 0x1 | +| 1 bit | DWORD **- fShrinkNinch** | 0x1 | +| 1 bit | DWORD **- fMergeCellNinch** | 0x1 | +| 1 bit | DWORD **- lockedNinch** | 0x1 | +| 1 bit | DWORD **- hiddenNinch** | 0x1 | +| 1 bit | DWORD **- glLeftNinch** | 0x1 | +| 1 bit | DWORD **- glRightNinch** | 0x1 | +| 1 bit | DWORD **- glTopNinch** | 0x1 | +| 1 bit | DWORD **- glBottomNinch** | 0x1 | +| 1 bit | DWORD **- glDiagDownNinch** | 0x1 | +| 1 bit | DWORD **- glDiagUpNinch** | 0x1 | +| 1 bit | DWORD **- flsNinch** | 0x1 | +| 1 bit | DWORD **- icvFNinch** | 0x1 | +| 1 bit | DWORD **- icvBNinch** | 0x1 | +| 1 bit | DWORD **- ifmtNinch** | 0x1 | +| 1 bit | DWORD **- fIfntNinch** | 0x1 | +| 1 bit | DWORD **- unused1** | 0x1 | +| 3 bits | DWORD **- reserved1** | 0x0 | +| 1 bit | DWORD **- ibitAtrNum** | 0x0 | +| 1 bit | DWORD **- ibitAtrFnt** | 0x1 | +| 1 bit | DWORD **- ibitAtrAlc** | 0x0 | +| 1 bit | DWORD **- ibitAtrBdr** | 0x0 | +| 1 bit | DWORD **- ibitAtrPat** | 0x0 | +| 1 bit | DWORD **- ibitAtrProt** | 0x0 | +| 1 bit | DWORD **- iReadingOrderNinch** | 0x0 | +| 1 bit | WORD **- fIfmtUser** | 0x0 | +| 1 bit | WORD **- unused2** | 0x1 | +| 1 bit | WORD **- fNewBorder** | 0x0 | +| 12 bits | WORD **- reserved2** | 0x000 | +| 1 bit | WORD **- fZeroInited** | 0x0 | +| 0076 | [DXFFntD](#dxffntd) **- dxffntd** | | +| 0001 | BYTE **- cchFont** | 0x00 | +| 003F | unused **- unused** | 0x000100010000000000E03F000000000000E03F0100630075006D0065006E007400200057007200690074006500720000000000000001040006DC00580303FF | +| 0010 | [Stxp](#stxp) **- stxp** | | +| 0004 | LONG **- twpHeight** | 0xFFFFFFFF | +| 0004 | [Ts](#ts) **- ts** | | +| 1 bit | DWORD **- unused1** | 0x0 | +| 1 bit | DWORD **- ftsItalic** | 0x0 | +| 5 bits | DWORD **- unused2** | 0x00 | +| 1 bit | DWORD **- ftsStrikeout** | 0x0 | +| 24 bits | DWORD **- unused3** | 0x000000 | +| 0002 | SHORT **- bls** | 0x0000 | +| 0002 | SHORT **- sss** | 0x0000 | +| 0001 | BYTE **- uls** | 0x00 | +| 0001 | BYTE **- bFamily** | 0x00 | +| 0001 | BYTE **- bCharSet** | 0x00 | +| 0001 | BYTE **- unused** | 0x00 | +| 0004 | LONG **- icvFore** | 0x0000000A | +| 0004 | LONG **- reserved** | 0x00000000 | +| 0004 | Ts **- tsNinch** | | +| 1 bit | DWORD **- unused1** | 0x0 | +| 1 bit | DWORD **- ftsItalic** | 0x1 | +| 5 bits | DWORD **- unused2** | 0x06 | +| 1 bit | DWORD **- ftsStrikeout** | 0x1 | +| 24 bits | DWORD **- unused3** | 0x000000 | +| 0004 | DWORD **- fSssNinch** | 0x00000001 | +| 0004 | DWORD **- fUlsNinch** | 0x00000001 | +| 0004 | DWORD **- fBlsNinch** | 0x00000001 | +| 0004 | DWORD **- unused2** | 0x00000001 | +| 0004 | LONG **- ich** | 0x00000000 | +| 0004 | LONG **- cch** | 0x7FFFFFFF | +| 0002 | [FontIndex](#fontindex) **- iFnt** | | +| 0002 | USHORT **- ifnt** | 0x0001 | +| 0009 | [CFParsedFormulaNoCCE](#cfparsedformulanocce) **- rgce1** | | +| 0009 | [Rgce](#rgce) **- rgce** | | +| 0009 | Ptg **- Ptg\[0\]** | | +| 0009 | [PtgNum](#ptgnum) **- PtgNum** | | +| 7 bits | BYTE **- ptg** | 0x1F | +| 1 bit | BYTE **- reserved0** | 0x0 | +| 0008 | Double **- value** | 0x3FF8000000000000 | +| 0009 | CFParsedFormulaNoCCE **- rgce2** | | +| 0009 | Rgce **- rgce** | | +| 0009 | Ptg **- Ptg\[0\]** | | +| 0009 | PtgNum **- PtgNum** | | +| 7 bits | BYTE **- ptg** | 0x1F | +| 1 bit | BYTE **- reserved0** | 0x0 | +| 0008 | Double **- value** | 0x4004000000000000 | + +Figure 21: Structure of Cf + +**ct:** 0x01 specifies that the [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule requires two inputs. The inputs, **rgce1** and **rgce2**, are evaluated with the comparison function specified in the **cp** field. If the result of the evaluation is TRUE, the conditional formatting rule is applied. + +**cp:** 0x01 specifies that the comparison function evaluates to TRUE if the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) value is greater than or equal to the value of the **rgce1** field and less than or equal to the value of the **rgce2** field. + +**cce1:** 0x0009 specifies that the size of the **rgce1** field is 9 bytes. + +**cce2:** 0x0009 specifies that the size of the **rgce2** field is 9 bytes. + +**rgbdxf:** A DXFN structure that specifies the formatting that is applied if the defined condition evaluates to TRUE. + +**rgbdxf.alchNinch:** 0x1 specifies that **rgbdxf.dxfalc.alc** is ignored. + +**rgbdxf.alcvNinch:** 0x1 specifies that **rgbdxf.dxfalc.alcv** is ignored. + +**rgbdxf.wrapNinch:** 0x1 specifies that **rgbdxf.dxfalc.fWrap** is ignored. + +**rgbdxf.trotNinch:** 0x1 specifies that **rgbdxf.dxfalc.trot** is ignored. + +**rgbdxf.kintoNinch:** 0x1 specifies that **rgbdxf.dxfalc.fJustLast** is ignored. + +**rgbdxf.cIndentNinch:** 0x1 specifies that **rgbdxf.dxfalc.cIndent** and **rgbdxf.dxfalc.iIndent** are ignored. + +**rgbdxf.fShrinkNinch:** 0x1 specifies that **rgbdxf.dxfalc.fShrinkToFit** is ignored. + +**rgbdxf.fMergeCellNinch:** 0x1 specifies that **rgbdxf.dxfalc.fMergeCell** is ignored. + +**rgbdxf.lockedNinch:** 0x1 specifies that **rgbdxf.dxfprot.fLocked** is ignored. + +**rgbdxf.hiddenNinch:** 0x1 specifies that **rgbdxf.dxfprot.fHidden** is ignored. + +**rgbdxf.glLeftNinch:** 0x1 specifies that **rgbdxf.dxfbdr.dgLeft** and **rgbdxf.dxfbdr.icvLeft** are ignored. + +**rgbdxf.glRightNinch:** 0x1 specifies that **rgbdxf.dxfbdr.dgRight** and **rgbdxf.dxfbdr.icvRight** are ignored. + +**rgbdxf.glTopNinch:** 0x1 specifies that the properties for the top [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) of the cell can be updated and that **rgbdxf.dxfbdr.dgTop** and **rgbdxf.dxfbdr.icvTop** are ignored. + +**rgbdxf.glBottomNinch:** 0x1 specifies that **rgbdxf.dxfbdr.dgBottom** and **rgbdxf.dxfbdr.icvBottom** are ignored. + +**rgbdxf.glDiagDownNinch:** 0x1 specifies that **rgbdxf.dxfbdr.bitDiagDown** is ignored. + +**rgbdxf.glDiagUpNinch:** 0x1 specifies that **rgbdxf.dxfbdr.bitDiagUp** is ignored. Because **rgbdxf.glDiagDownNinch** is also set to 0x1, **rgbdxf.dxfbdr.dgDiag** and **rgbdxf.dxfbdr.icvDiag** are ignored. + +**rgbdxf.flsNinch:** 0x1 specifies that **rgbdxf.dxfpat.fls** is ignored. + +**rgbdxf.icvFNinch:** 0x1 specifies that **rgbdxf.dxfpat.icvForeground** is ignored. + +**rgbdxf.icvBNinch:** 0x1 specifies that **rgbdxf.dxfpat.icvBackground** is ignored. + +**rgbdxf.ifmtNinch:** 0x1 specifies that **rgbdxf.dxfnum.ifmt** is ignored. + +**rgbdxf.fIfntNinch:** 0x1 specifies that **rgbdxf.dxffntd.ifnt** is ignored. + +**rgbdxf.ibitAtrNum:** 0x0 specifies that the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) is not part of this structure. + +**rgbdxf.ibitAtrFnt:** 0x1 specifies that [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information is a part of this structure. + +**rgbdxf.ibitAtrAlc:** 0x0 specifies that alignment information is not a part of this structure. + +**rgbdxf.ibitAtrBdr:** 0x0 specifies that [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad) information is not a part of this structure. + +**rgbdxf.ibitAtrPat:** 0x0 specifies that pattern information is not a part of this structure. + +**rgbdxf.ibitAtrProt:** 0x0 specifies that rotation information is not a part of this structure. + +**rgbdxf.iReadingOrderNinch:** 0x1 specifies that **rgbdxf.dxfalc.iReadingOrder** is ignored. + +**rgbdxf.fIfmtUser:** 0x0 specifies that the number format is not a user-defined [**format string**](#gt_07085e26-506a-4b35-81ad-972464e277ff). + +**rgbdxf.fNewBorder:** 0x0 specifies that the border formats apply to all cells in the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +**rgbdxf.fZeroInited:** 0x0 specifies that **rgbdxf.dxfalc.iReadingOrder** is undefined and not taken into account. + +**rgbdxf.dxffntd:** A DXFFntD structure that specifies the font information used for formatting. + +**rgbdxf.dxffntd.cchFont:** 0x00 specifies the number of characters in the font name string. + +**rgbdxf.dxffntd.stxp:** This specifies the formatting attributes of the font. + +**rgbdxf.dxffntd.stxp.twpHeight:** 0xFFFFFFFF specifies that this value is ignored. + +**rgbdxf.dxffntd.stxp.ts:** A Ts structure that specifies additional formatting attributes. + +**rgbdxf.dxffntd.stxp.ts.ftsItalic:** 0x1 is ignored because **rgbdxf.dxffntd.tsNinch.ftsItalic** is 0x1. + +**rgbdxf.dxffntd.stxp.ts.ftsStrikeout:** 0x0 is ignored because **rgbdxf.dxffntd.tsNinch.ftsStrikeout** is 0x1. + +**rgbdxf.dxffntd.stxp.bls:** 0x0000 specifies that the font is normal weight. + +**rgbdxf.dxffntd.stxp.sss:** 0x0000 specifies that the font is normal script. + +**rgbdxf.dxffntd.stxp.uls:** 0x00 specifies that the font is not underlined. + +**rgbdxf.dxffntd.stxp.bFamily:** 0x00 specifies the [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2). + +**rgbdxf.dxffntd.stxp.bCharSet:** 0x00 specifies the font [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204). + +**rgbdxf.dxffntd.icvFore:** 0x0000000A specifies that the font color is red. + +**rgbdxf.dxffntd.tsNinch:** A Ts structure that specifies how the value of **rgbdxf.dxffntd.stxp.ts** is interpreted. + +**rgbdxf.dxffntd.tsNinch.ftsItalic:** 0x1 specifies that the value of **rgbdxf.dxffntd.stxp.ts.ftsItalic** is ignored. + +**rgbdxf.dxffntd.tsNinch.ftsStrikeout:** 0x1 specifies that the value of **rgbdxf.dxffntd.stxp.ts. ftsStrikeout** is ignored. + +**rgbdxf.dxffntd.fSssNinch:** 0x00000001 specifies that **rgbdxf.dxffntd.stxp.sss** is ignored. + +**rgbdxf.dxffntd.fUlsNinch:** 0x00000001 specifies that **rgbdxf.dxffntd.stxp.uls** is ignored. + +**rgbdxf.dxffntd.fBlsNinch:** 0x00000001 specifies that **rgbdxf.dxffntd.stxp.bls** is ignored. + +**rgbdxf.dxffntd.ich:** 0x00000000 specifies that the font formatting is applied starting from the first character. + +**rgbdxf.dxffntd.cch:** 0x7FFFFFFF specifies that the font formatting applies to 2147483647 characters. + +**rgbdxf.dxffntd.iFnt:** 0x0001 is ignored because **rgbdxf.fIfntNinch** is 0x1. + +**rgce1:** A CFParsedFormulaNoCCE structure that specifies the first operand of the comparison. + +**rgce1.rgce:** An Rgce that specifies an array of [Ptgs](#ptg). + +**rgce1.rgce.Ptg\[0\]:** A Ptg that specifies a formula element. + +**rgce1.rgce.Ptg\[0\].PtgNum.ptg:** 0x1F specifies that this Ptg is a floating point value. + +**rgce1.rgce.Ptg\[0\].PtgNum.value:** 0x3FF8000000000000 specifies a numeric value of 1.5. + +**rgce2:** A CFParsedFormulaNoCCE structure that specifies the second operand of the comparison. + +**rgce2.rgce:** A Rgce structure that specifies an array of Ptgs. + +**rgce2.rgce.Ptg\[0\]:** A Ptg that specifies a formula element. + +**rgce2.rgce.Ptg\[0\].PtgNum.ptg:** 0x1F specifies that this Ptg is a floating point value. + +**rgce2.rgce.Ptg\[0\].PtgNum.value:** 0x4004000000000000 specifies a numeric value of 2.5. + +## Defined Name + +This example shows a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe)-level [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933), *MyName*, that points to the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) E4 on the second [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). A defined name is specified by a [Lbl](#lbl) record, which is a part of the [Globals Substream](#globals-substream) (not included in this example for brevity). This example includes the [ExternSheet](#externsheet) record referenced by the Lbl record, and the [SupBook](#supbook) record referenced by the ExternSheet record. + +
+ +

Figure 22: Defined name in this example within a sheet

+
+ +### Defined Name: Lbl + +The first record in this example, [Lbl](#lbl), stores the [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001C | Lbl **- Lbl** | | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fFunc** | 0x0 | +| 1 bit | USHORT **- fOB** | 0x0 | +| 1 bit | USHORT **- fProc** | 0x0 | +| 1 bit | USHORT **- fCalcExp** | 0x0 | +| 1 bit | USHORT **- fBuiltin** | 0x0 | +| 6 bits | USHORT **- fGrp** | 0x00 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fPublished** | 0x0 | +| 1 bit | USHORT **- fWorkbookParam** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0001 | BYTE **- chKey** | 0x00 | +| 0001 | BYTE **- cch** | 0x06 | +| 0002 | SHORT **- cce** | 0x0007 | +| 0002 | SHORT **- reserved3** | 0x0000 | +| 0002 | USHORT **- itab** | 0x0000 | +| 0001 | BYTE **- reserved4** | 0x00 | +| 0001 | BYTE **- reserved5** | 0x00 | +| 0001 | BYTE **- reserved6** | 0x00 | +| 0001 | BYTE **- reserved7** | 0x00 | +| 0007 | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- Name** | MyName | +| 0007 | [NameParsedFormula](#nameparsedformula) **- rgce** | | +| 0007 | [Ptg](#ptg) **- Ptg\[0\]** | | +| 0007 | [PtgRef3d](#ptgref3d) **- PtgRef3d** | | +| 5 bits | BYTE **- ptg** | 0x1A | +| 2 bits | [PtgDataType](#ptgdatatype) **- type** | 0x1 | +| 1 bit | BYTE **- reserved** | 0x0 | +| 0002 | USHORT **- ixti** | 0x0000 | +| 0004 | [RgceLoc](#rgceloc) **- loc** | | +| 0002 | [RwU](#rwu) **- row** | | +| 0002 | USHORT **- rw** | 0x0003 | +| 0002 | [ColRelU](#colrelu) **- column** | | +| 0002 | USHORT **- col** | 0x0004 | + +Figure 23: Structure of Lbl + +**fHidden:** 0x0 specifies that the defined name is visible in the list of defined names. + +**fFunc:** 0x0 specifies that the defined name does not represent an [**XLM**](#gt_11e8ff9f-bce2-4d8b-9ba2-11ac468f7c7b). + +**fOB:** 0x0 specifies that the defined name does not represent a [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) [**macro**](#gt_cd2933d3-08d1-4931-bd5c-7ae0a668fe7c). + +**fProc:** 0x0 specifies that the defined name does not represent a macro. + +**fCalcExp:** 0x0 specifies that the defined name does not represent a function that could return an array. + +**fBuiltin:** 0x0 specifies that the defined name does not represent a [**built-in name**](#gt_d40a51df-e96f-45ec-885d-6f936d172b39). + +**fGrp:** 0x00 specifies the [**function category**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) for the defined name is "All". + +**fPublished:** 0x0 specifies that this defined name is not [**published**](#gt_8ffc383a-d4f1-4515-a8b5-874d84ab2d2b). + +**fWorkbookParam:** 0x0 specifies that this defined name is not a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) parameter. + +**chKey:** 0x00 specifies there is no shortcut key for the macro represented by the defined name. + +**cch:** 0x06 specifies that there are six characters in the **Name** field. + +**cce:** 0x0007 specifies that the length of the **rgce** field is 7 bytes. + +**itab:** 0x0000 specifies that the defined name is not local to a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**Name:** *MyName* specifies the name of the defined name. + +**rgce:** A NameParsedFormula that specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that represents the defined name. + +**rgce.Ptg\[0\].PtgRef3d.ptg:** 0x1A specifies that this Ptg is of type PtgRef3d. + +**rgce.Ptg\[0\].PtgRef3d.type:** 0x1 specifies that this Ptg is a reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +**rgce.Ptg\[0\].PtgRef3d.ixti:** 0x0000 specifies that this range refers to the sheet specified by the first [XTI](#xti) element in the [ExternSheet](#externsheet) record. + +**rgce.Ptg\[0\].PtgRef3d.loc.row.rw:** 0x0003 specifies that the referenced [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) is in row four of the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +**rgce.Ptg\[0\].PtgRef3d.loc.column.col:** 0x0004 specifies that the referenced cell is in column E of the worksheet. + +### Defined Name: ExternSheet + +The next record in this example is an [ExternSheet](#externsheet) record. This record defines the set of [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that are referenced by this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). It is included in this example because the **ixti** field in the [Lbl](#lbl) record points to the [XTI](#xti) structure within this record. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------|-----------| +| 0008 | ExternSheet **- ExternSheet** | | +| 0002 | USHORT **- cXTI** | 0x0001 | +| 0006 | RgXTI **- rgXTI** | | +| 0006 | XTI **- xti\[0\]** | | +| 0002 | USHORT **- iSupBook** | 0x0000 | +| 0002 | SHORT **- itabFirst** | 0x0001 | +| 0002 | SHORT **- itabLast** | 0x0001 | + +Figure 24: Structure of ExternSheet + +**cXTI:** 0x0001 specifies that there is one XTI record in the **rgXTI** array. + +**rgXTI.xti\[0\].iSupBook:** 0x0000 specifies the reference to the first [SupBook](#supbook) record in the [global substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +**rgXTI.xti\[0\].itabFirst:** 0x0001 specifies that the first sheet referenced by the [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) is the second sheet in the workbook (Sheet2). The related [BoundSheet8](#boundsheet8) record is omitted for brevity. + +**rgXTI.xti\[0\].itabLast:** 0x0001 specifies that the last sheet referenced by the defined name is the second sheet in the workbook (Sheet2). + +### Defined Name: SupBook + +The next record in this example, [SupBook](#supbook), stores information about a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) that is referenced by this workbook. + +| **Size** | **Structure** | **Value** | +|----------|-----------------------|-----------| +| 0004 | SupBook **- SupBook** | | +| 0002 | USHORT **- ctab** | 0x0003 | +| 0002 | USHORT **- cch** | 0x0401 | + +Figure 25: Structure of SupBook + +**ctab:** 0x0003 specifies that there are three [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the referenced workbook. + +**cch:** 0x0401 specifies that this record defines a self-referencing [supporting link](#Section_cc5920ba01074d92bbdfc12ca986f31f). + +## Table + +This example shows the records that make up a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). The following figure shows a possible implementation of the table discussed in this example: + +
+ +

Figure 26: Table in this example within a sheet

+
+ +### Table: Feathdr11 + +The first record in this example is a [FeatHdr11](#feathdr11) record that appears in the [worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) (the worksheet substream is not included in this example for brevity). This record stores common information about all the tables on this [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001D | FeatHdr11 **- Feathdr11** | | +| 000C | [FrtHeader](#frtheader) **- frt** | | +| 0002 | USHORT **- rt** | 0x0871 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0008 | RESERVED **- reserved** | 0x0000000000000000 | +| 0002 | [SharedFeatureType](#sharedfeaturetype) **- isf** | 0x0005 | +| 0001 | BYTE **- reserved1** | 0x01 | +| 0004 | DWORD **- reserved2** | 0xFFFFFFFF | +| 0004 | DWORD **- reserved3** | 0xFFFFFFFF | +| 0004 | DWORD **- idListNext** | 0x00000002 | +| 0002 | USHORT **- reserved4** | 0x0000 | + +Figure 27: Structure of Feathdr11 + +**frt:** This structure specifies a future version record type FrtHeader. + +**frt.rt:** 0x0871 specifies that this record belongs to a record of type FeatHdr11. + +**frt.grbitFrt:** Stores attributes for this record. + +**frt.grbitFrt.fFrtRef:** 0x0000 specifies that this record does not specify a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +**frt.grbitFrt.fFrtAlert:** 0x0000 specifies not to alert the user of possible problems when saving the file as an earlier version of the file format. + +**isf:** 0x0005 specifies type Table. + +**idListNext:** 0x00000002 specifies the next identifier to try when assigning a unique identifier to a new [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +### Table: Feature11 + +The next record in this example, [Feature11](#feature11), specifies information about this [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) on this [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0116 | Feature11 **- Feature11** | | +| 000C | [FrtRefHeaderU](#frtrefheaderu) **- frtRefHeaderU** | | +| 0002 | USHORT **- rt** | 0x0872 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x1 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0008 | [Ref8U](#ref8u) **- ref8** | | +| 0002 | [RwU](#rwu) **- rwFirst** | | +| 0002 | USHORT **- rw** | 0x0003 | +| 0002 | RwU **- rwLast** | | +| 0002 | USHORT **- rw** | 0x0006 | +| 0002 | [ColU](#colu) **- colFirst** | | +| 0002 | USHORT **- col** | 0x0002 | +| 0002 | ColU **- colLast** | | +| 0002 | USHORT **- col** | 0x0004 | +| 0002 | USHORT **- isf** | 0x0005 | +| 0001 | BYTE **- reserved1** | 0x00 | +| 0004 | DWORD **- reserved2** | 0x00000000 | +| 0002 | USHORT **- cref2** | 0x0001 | +| 0004 | DWORD **- cbFeatData** | 0x00000000 | +| 0002 | USHORT **- reserved3** | 0x0000 | +| 0008 | REFS2 **- refs2** | | +| 0008 | Ref8U **- ref\[0\]** | | +| 0002 | RwU **- rwFirst** | | +| 0002 | USHORT **- rw** | 0x0003 | +| 0002 | RwU **- rwLast** | | +| 0002 | USHORT **- rw** | 0x0006 | +| 0002 | ColU **- colFirst** | | +| 0002 | USHORT **- col** | 0x0002 | +| 0002 | ColU **- colLast** | | +| 0002 | USHORT **- col** | 0x0004 | +| 00F3 | FeatUnion5 **- rgbFeat** | | +| 00F3 | [TableFeatureType](#tablefeaturetype) **- TableFeature** | | +| 0004 | [SourceType](#sourcetype) **- lt** | 0x00000000 | +| 0004 | DWORD **- idList** | 0x00000001 | +| 0004 | DWORD **- crwHeader** | 0x00000001 | +| 0004 | DWORD **- crwTotals** | 0x00000000 | +| 0004 | DWORD **- idFieldNext** | 0x00000004 | +| 0004 | ULONG **- cbFSData** | 0x00000040 | +| 0002 | USHORT **- rupBuild** | 0x0000 | +| 0002 | USHORT **- unused1** | 0x0000 | +| 1 bit | DWORD **- unused2** | 0x0 | +| 1 bit | DWORD **- fAutoFilter** | 0x1 | +| 1 bit | DWORD **- fPersistAutoFilter** | 0x1 | +| 1 bit | DWORD **- fShowInsertRow** | 0x0 | +| 1 bit | DWORD **- fInsertRowInsCells** | 0x0 | +| 1 bit | DWORD **- fLoadPldwIdDeleted** | 0x0 | +| 1 bit | DWORD **- fShownTotalRow** | 0x0 | +| 1 bit | DWORD **- reserved1** | 0x0 | +| 1 bit | DWORD **- fNeedsCommit** | 0x0 | +| 1 bit | DWORD **- fSingleCell** | 0x0 | +| 1 bit | DWORD **- reserved2** | 0x0 | +| 1 bit | DWORD **- fApplyAutoFilter** | 0x1 | +| 1 bit | DWORD **- fForceInsertToBeVis** | 0x0 | +| 1 bit | DWORD **- fCompressedXml** | 0x0 | +| 1 bit | DWORD **- fLoadCSPName** | 0x0 | +| 1 bit | DWORD **- fLoadPldwIdChanged** | 0x0 | +| 4 bits | DWORD **- verXL** | 0xB | +| 1 bit | DWORD **- fLoadEntryId** | 0x1 | +| 1 bit | DWORD **- fLoadPllstclInvalid** | 0x0 | +| 1 bit | DWORD **- fGoodRupBld** | 0x0 | +| 1 bit | DWORD **- unused3** | 0x0 | +| 1 bit | DWORD **- fPublished** | 0x0 | +| 7 bits | DWORD **- unused2** | 0x00 | +| 0004 | ULONG **- lPosStmCache** | 0x00000000 | +| 0004 | ULONG **- cbStmCache** | 0x00000000 | +| 0004 | ULONG **- cchStmCache** | 0x00000000 | +| 0004 | [LEMMode](#lemmode) **- lem** | 0x00000000 | +| 0010 | rgb **- rgbHashParam** | 0x00000000000000000000000000000000 | +| 0008 | [XLUnicodeString](#xlunicodestring) **- rgbName** | List1 | +| 0002 | USHORT **- cFieldData** | 0x0003 | +| 0004 | XLUnicodeString **- entryId** | 1 | +| 00A5 | Feat11FieldDataArray **- fieldData** | | +| 0035 | [Feat11FieldDataItem](#feat11fielddataitem) **- Feat11FieldDataItem\[0\]** | | +| 0004 | DWORD **- idField** | 0x00000001 | +| 0004 | DWORD **- lfdt** | 0x00000000 | +| 0004 | DWORD **- lfxidt** | 0x00000000 | +| 0004 | DWORD **- ilta** | 0x00000000 | +| 0004 | DWORD **- cbFmtAgg** | 0x00000000 | +| 0004 | DWORD **- istnAgg** | 0xFFFFFFFF | +| 1 bit | DWORD **- fAutoFilter** | 0x1 | +| 1 bit | DWORD **- fAutoFilterHidden** | 0x0 | +| 1 bit | DWORD **- fLoadXmapi** | 0x0 | +| 1 bit | DWORD **- fLoadFmla** | 0x0 | +| 2 bits | DWORD **- unused1** | 0x0 | +| 1 bit | DWORD **- reserved2** | 0x0 | +| 1 bit | DWORD **- fLoadTotalFmla** | 0x0 | +| 1 bit | DWORD **- fLoadTotalArray** | 0x0 | +| 1 bit | DWORD **- fSaveStyleName** | 0x0 | +| 1 bit | DWORD **- fLoadTotalStr** | 0x0 | +| 1 bit | DWORD **- fAutoCreateCalcCol** | 0x0 | +| 20 bits | DWORD **- unused2** | 0x00000 | +| 0004 | DWORD **- cbFmtInsertRow** | 0x00000000 | +| 0004 | DWORD **- istnInsertRow** | 0xFFFFFFFF | +| 0004 | XLUnicodeString **- strFieldName** | 1 | +| 0007 | XLUnicodeString **- strCaption** | Item | +| 0006 | [Feat11FdaAutoFilter](#feat11fdaautofilter) **- AutoFilter** | | +| 0004 | DWORD **- cbAutoFilter** | 0x00000000 | +| 0002 | USHORT **- unused** | 0x0001 | +| 0036 | Feat11FieldDataItem **- Feat11FieldDataItem\[1\]** | | +| 0004 | DWORD **- idField** | 0x00000002 | +| 0004 | DWORD **- lfdt** | 0x00000000 | +| 0004 | DWORD **- lfxidt** | 0x00000000 | +| 0004 | DWORD **- ilta** | 0x00000000 | +| 0004 | DWORD **- cbFmtAgg** | 0x00000000 | +| 0004 | DWORD **- istnAgg** | 0xFFFFFFFF | +| 1 bit | DWORD **- fAutoFilter** | 0x1 | +| 1 bit | DWORD **- fAutoFilterHidden** | 0x0 | +| 1 bit | DWORD **- fLoadXmapi** | 0x0 | +| 1 bit | DWORD **- fLoadFmla** | 0x0 | +| 2 bits | DWORD **- unused1** | 0x0 | +| 1 bit | DWORD **- fLoadCalcColArray** | 0x0 | +| 1 bit | DWORD **- fLoadTotalFmla** | 0x0 | +| 1 bit | DWORD **- fLoadTotalArray** | 0x0 | +| 1 bit | DWORD **- fSaveStyleName** | 0x0 | +| 1 bit | DWORD **- fLoadTotalStr** | 0x0 | +| 1 bit | DWORD **- fAutoCreateCalcCol** | 0x0 | +| 20 bits | DWORD **- unused2** | 0x00000 | +| 0004 | DWORD **- cbFmtInsertRow** | 0x00000000 | +| 0004 | DWORD **- istnInsertRow** | 0xFFFFFFFF | +| 0004 | XLUnicodeString **- strFieldName** | 2 | +| 0008 | XLUnicodeString **- strCaption** | Price | +| 0006 | Feat11FdaAutoFilter **- AutoFilter** | | +| 0004 | DWORD **- cbAutoFilter** | 0x00000000 | +| 0002 | USHORT **- unused** | 0x0002 | +| 003A | Feat11FieldDataItem **- Feat11FieldDataItem\[2\]** | | +| 0004 | DWORD **- idField** | 0x00000003 | +| 0004 | DWORD **- lfdt** | 0x00000000 | +| 0004 | DWORD **- lfxidt** | 0x00000000 | +| 0004 | DWORD **- ilta** | 0x00000000 | +| 0004 | DWORD **- cbFmtAgg** | 0x00000000 | +| 0004 | DWORD **- istnAgg** | 0xFFFFFFFF | +| 1 bit | DWORD **- fAutoFilter** | 0x1 | +| 1 bit | DWORD **- fAutoFilterHidden** | 0x0 | +| 1 bit | DWORD **- fLoadXmapi** | 0x0 | +| 1 bit | DWORD **- fLoadFmla** | 0x0 | +| 2 bits | DWORD **- unused1** | 0x0 | +| 1 bit | DWORD **- fLoadCalcColArray** | 0x0 | +| 1 bit | DWORD **- fLoadTotalFmla** | 0x0 | +| 1 bit | DWORD **- fLoadTotalArray** | 0x0 | +| 1 bit | DWORD **- fSaveStyleName** | 0x0 | +| 1 bit | DWORD **- fLoadTotalStr** | 0x0 | +| 1 bit | DWORD **- fAutoCreateCalcCol** | 0x0 | +| 20 bits | DWORD **- unused2** | 0x00000 | +| 0004 | DWORD **- cbFmtInsertRow** | 0x00000000 | +| 0004 | DWORD **- istnInsertRow** | 0xFFFFFFFF | +| 0004 | XLUnicodeString **- strFieldName** | 3 | +| 000C | XLUnicodeString **- strCaption** | Sales Tax | +| 0006 | Feat11FdaAutoFilter **- AutoFilter** | | +| 0004 | DWORD **- cbAutoFilter** | 0x00000000 | +| 0002 | USHORT **- unused** | 0x0003 | + +Figure 28: Structure of Feature11 + +**frtRefHeaderU:** This structure specifies a future version record type header. + +**frtRefHeaderU.rt:** 0x0872 specifies that this record belongs to a record of type Feature11. + +**frtRefHeaderU.grbitFrt:** Specifies attributes for this record. + +**frtRefHeaderU.grbitFrt.fFrtRef:** 0x1 specifies that the containing record specifies a range of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +**frtRefHeaderU.grbitFrt.fFrtAlert:** 0x0 specifies not to alert the user of possible problems when saving as an earlier version of the file format. + +**frtRefHeaderU.ref8:** Specifies a range of cells on the sheet. This refers to the range C4:E7. Because frt.rt is equal to 0x0872, this field is ignored. + +**frtRefHeaderU.ref8.rwFirst:** Specifies the first row in the Table range. + +**frtRefHeaderU.ref8.rwFirst.rw:** 0x0003 specifies the first row in the table on the sheet. This refers to row four of the sheet. + +**frtRefHeaderU.ref8.rwLast:** Specifies the last row in the table range. + +**frtRefHeaderU.ref8.rwLast.rw:** 0x0006 specifies the last row in the table on the sheet. This refers to row seven of the sheet. + +**frtRefHeaderU.ref8.colFirst:** Specifies the first column in the table range. + +**frtRefHeaderU.ref8.colFirst.col:** 0x0002 specifies the first column in the table on the sheet. This refers to column C of the sheet. + +**frtRefHeaderU.ref8.colLast:** Specifies the last column in the table range. + +**frtRefHeaderU.ref8.colLast.col:** 0x0004 specifies the last column in the table on the sheet. This refers to column E of the sheet. + +**isf:** 0x0005 specifies that the shared feature type is a table feature. + +**cref2:** 0x0001 specifies the count of Ref8U records within the **refs2** field. **refs2** contains one Ref8U record. + +**cbFeatData:** 0x00000000 specifies that the size of the **rgbFeat** field is calculated using the following formula: + +- Size of **rgbFeat** = record total size in bytes – size of **refs2** in bytes – 27 bytes + +- Size of **rgbFeat** = 278 bytes - 8 bytes - 27 bytes + +- Size of **rgbFeat** = 243 bytes + +**refs2:** Specifies the references to the ranges of cells within the sheet that are affected by the feature. + +**refs2.ref\[0\]:** The first Ref8U record in the array. It specifies the range C4:E7. This specifies the range of cells for the table. + +**refs2.ref\[0\].rwFirst.rw:** 0x0003 specifies that the first row of the range is row four. + +**refs2.ref\[0\].rwLast.rw:** 0x0006 specifies that the last row of the range is row seven. + +**refs2.ref\[0\].colFirst.col:** 0x0002 specifies that the first column of the range is column C. + +**refs2.ref\[0\].colLast.col:** 0x0004 specifies that the last column of the range is column E. + +**rgbFeat:** Specifies any of the possible features for this record. Contains a TableFeatureType record, as indicated by isf. + +**rgbFeat.TableFeature:** Specifies the definition of this table. + +**rgbFeat.TableFeature.lt:** 0x00000000 specifies the type of [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for the table is a range. + +**rgbFeat.TableFeature.idList:** 0x00000001 specifies the identifier for the table. + +**rgbFeat.TableFeature.crwHeader:** 0x00000001 specifies there is a row at the top of the table that is used as a [**header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38). + +**rgbFeat.TableFeature.crwTotals:** 0x00000000 specifies there is not a row at the bottom of the table that is used as a [**total row**](#gt_95e9bcf4-d644-4e96-9070-dbc80b4d1b28). + +**rgbFeat.TableFeature.idFieldNext:** 0x00000004 specifies the next unique identifier to try when assigning unique identifiers to columns of the table. + +**rgbFeat.TableFeature.cbFSData:** 0x00000040 specifies the size, in bytes, of the fixed portion of this TableFeatureType structure. + +**rgbFeat.TableFeature.rupBuild:** This value is not valid, as specified by **rgbFeat.TableFeature.fGoodRupBld**. + +**rgbFeat.TableFeature.fAutoFilter:** 0x1 specifies the table has [**AutoFilters**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). + +**rgbFeat.TableFeature.fPersistAutoFilter:** 0x1 specifies that the AutoFilter information is preserved for this table across data refresh operations. + +**rgbFeat.TableFeature.fShowInsertRow:** 0x0 specifies the [**insert row**](#gt_3b3c223b-83e0-4697-85eb-815af907b8a9) is not visible. + +**rgbFeat.TableFeature.fInsertRowInsCells:** 0x0 specifies rows are not shifted down because the insert row is not visible. + +**rgbFeat.TableFeature.fLoadPldwIdDeleted:** 0x0 specifies the **idDeleted** field is not present. + +**rgbFeat.TableFeature.fShownTotalRow:** 0x0 specifies the total row is not displayed at the bottom of the table. + +**rgbFeat.TableFeature.fNeedsCommit:** 0x0 specifies that only table modifications that are synchronized with the data source exist. + +**rgbFeat.TableFeature.fSingleCell:** 0x0 specifies the table is not limited to a single cell. + +**rgbFeat.TableFeature.fApplyAutoFilter:** 0x1 specifies that the AutoFilter is currently applied. + +**rgbFeat.TableFeature.fForceInsertToBeVis:** 0x0 specifies the insert row is not forced to be visible. + +**rgbFeat.TableFeature.fCompressedXml:** 0x0 specifies the XML data linked to the table is to be compressed. No XML data link is present. + +**rgbFeat.TableFeature.fLoadCSPName:** 0x0 specifies that the **CSPName** field is not present. + +**rgbFeat.TableFeature.fLoadPldwIdChanged:** 0x0 specifies that the **IdChanged** field is not present. + +**rgbFeat.TableFeature.verXL:** 0xB specifies the table was created using Microsoft Office Excel 2003. + +**rgbFeat.TableFeature.fLoadEntryId:** 0x1 specifies the **EntryId** field is present + +**rgbFeat.TableFeature.fLoadPllstclInvalid:** 0x0 specifies the **CellInvalid** field is not present + +**rgbFeat.TableFeature.fGoodRupBld:** 0x0 specifies the **rupBuild** field is not valid. + +**rgbFeat.TableFeature.fPublished:** 0x0 specifies the table was not published. + +**rgbFeat.TableFeature.lPosStmCache:** 0x00000000 specifies the cached data begins at position 0 in the [List Data stream](#Section_914f09bd8c944c099e8631dfe058f037). + +**rgbFeat.TableFeature.cbStmCache:** 0x00000000 specifies the size, in bytes, of the cached data within the List Data stream is 0. + +**rgbFeat.TableFeature.cchStmCache:** 0x00000000 specifies the count of characters of the cached data within the List Data stream when uncompressed is 0. + +**rgbFeat.TableFeature.lem:** 0x00000000 specifies the table can be directly edited inline. + +**rgbFeat.TableFeature.rgbHashParam:** The value of this field is required to be zeros because the **lt** field is not equal to 0x00000001. + +**rgbFeat.TableFeature.rgbName:** *List1* specifies the unique name of the table. + +**rgbFeat.TableFeature.cFieldData:** 0x0003 specifies the number of columns in the table. + +**rgbFeat.TableFeature.entryId:** 1 specifies the unique identifier for the table. This is ignored because the **lt** field is not equal to 0x00000002. + +**rgbFeat.TableFeature.fieldData:** An array of Feat11FieldDataItem that contains the definition of the columns of the table. The array contains three items as specified by the **cFieldData** field. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\]:** Specifies the definition of the first column of the table. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].idField:** 0x00000001 specifies the identifier of the column. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].lfdt:** 0x00000000 specifies that the table column is of the Web-based data provider data type. This value specifies that the field is unused. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].lfxidt:** 0x00000000 specifies the table column XML data type. This value specifies the field is unused. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].ilta:** 0x00000000 specifies the aggregation function to use for the column. This value specifies that no formula is used. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].cbFmtAgg:** 0x00000000 specifies that the **dxfFmtAgg** field does not exist. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].istnAgg:** 0xFFFFFFFF specifies the total row of the column uses the default style of the table. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fAutoFilter:** 0x1 specifies that this column has AutoFilters. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fAutoFilterHidden:** 0x0 specifies that this column has AutoFilters displayed. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fLoadXmapi:** 0x0 specifies the **rgXmap** field is not present. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fLoadFmla:** 0x0 specifies that the **fmla** field is not present. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fLoadTotalFmla:** 0x0 specifies that the **totalFmla** field is not present. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fLoadTotalArray:** 0x0 specifies that the formula specified by **totalFmla** is not an array formula. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fSaveStyleName:** 0x0 specifies that the **dskHdrCache.strStyleName** field is not present. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fLoadTotalStr:** 0x0 specifies the **strTotal** field is not present. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fAutoCreateCalcCol:** 0x0 specifies the column does not have a calculated column formula. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].cbFmtInsertRow:** 0x00000000 specifies that the **dxfFmtInsertRow** field does not exist. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].istnInsertRow:** 0xFFFFFFFF specifies the insert row of the column uses the default style of the table. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].strFieldName:** Specifies the name of the column, as provided by the data source. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].strCaption:** *Item* specifies the caption of the column. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].AutoFilter:** Specifies the characteristics of the AutoFilter for the column + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].AutoFilter.cbAutoFilter:** 0x00000000 specifies that the **recAutoFilter** field does not exist. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[1\]:** Specifies the definition of the second column of the table. The details of most of the fields within this structure are omitted here because they are the same as the fields in the first column **rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\]**. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[2\]:** Specifies the definition of the third column of the table. The details of most of the fields within this structure are omitted here because they are the same as the fields in the first column **rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\]**. + +## Filters + +This example shows how filters are applied to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) (C4:C8) on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) when the [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) is set to display items that are greater than 70. + +The first record in this example is the [FilterMode](#filtermode) record that appears in a [worksheet substream](#worksheet-substream) (the worksheet substream is not included in this example for brevity). This record specifies that the data in the containing sheet is filtered. + +Other records mentioned in this example are the [AutoFilterInfo](#autofilterinfo) record and [AutoFilter](#autofilter) record. They specify the properties of the AutoFilter and define the conditions that are used to filter the data. + +
+ +

Figure 29: AutoFilter in this example within a sheet

+
+ +### Filters: FilterMode + +The first record in this example, [FilterMode](#filtermode), specifies that the data in the containing [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) is filtered. + +| **Size** | **Structure** | +|----------|-----------------------------| +| 0000 | FilterMode **- FilterMode** | + +Figure 30: Structure of FilterMode + +### Filters: AutoFilterInfo + +The [AutoFilterInfo](#autofilterinfo) record specifies the number of columns that have [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) enabled and indicates the beginning of the collection of [AutoFilter](#autofilter) records. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------|-----------| +| 0002 | AutoFilterInfo **- AutoFilterInfo** | | +| 0002 | USHORT **- cEntries** | 0x0001 | + +Figure 31: Structure of AutoFilterInfo + +**cEntries:** 0x0001 specifies the number of filtered columns. + +### Filters: AutoFilter + +Next, the [AutoFilter](#autofilter) record specifies the criteria that are used to filter the data. + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------|--------------------| +| 0018 | AutoFilter **- AutoFilter** | | +| 0002 | USHORT **- iEntry** | 0x0000 | +| 2 bits | USHORT **- wJoin** | 0x0 | +| 1 bit | USHORT **- fSimple1** | 0x0 | +| 1 bit | USHORT **- fSimple2** | 0x0 | +| 1 bit | USHORT **- fTopN** | 0x0 | +| 1 bit | USHORT **- fTop** | 0x0 | +| 1 bit | USHORT **- fPercent** | 0x0 | +| 9 bits | USHORT **- wTopN** | 0x000 | +| 000A | [AFDOper](#afdoper) **- doper1** | | +| 0001 | BYTE **- vt** | 0x02 | +| 0001 | BYTE **- grbitSign** | 0x04 | +| 0008 | [AFDOperRk](#afdoperrk) **- vtValue** | | +| 0004 | [RkNumber](#rknumber) **- rk** | | +| 1 bit | ULONG **- fX100** | 0x0 | +| 1 bit | ULONG **- fInt** | 0x0 | +| 30 bits | ULONG **- num** | 0x10146000 | +| 0004 | DWORD **- unused1** | 0x00000000 | +| 000A | AFDOper **- doper2** | | +| 0001 | BYTE **- vt** | 0x00 | +| 0001 | BYTE **- grbitSign** | 0x00 | +| 0008 | BLOB **- vtValue** | 0x0000000000000000 | + +Figure 32: Structure of AutoFilter + +**iEntry:** 0x0000 specifies that this [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) applies to the first column in this [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**wJoin:** 0x0 specifies that filtering conditions specified in **doper1** and **doper2** conditions are joined by a logical AND operation when applying the AutoFilter. + +**fSimple1:** 0x0 specifies that an application-specific performance optimization cannot be used. + +**fSimple2:** 0x0 specifies that an application-specific performance optimization cannot be used. + +**fTopN:** 0x0 specifies that this AutoFilter is not a [**Top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9). + +**fTop:** 0x0 is ignored because **fTopN** is 0. + +**fPercent:** 0x0 is ignored because **fTopN** is 0. + +**wTopN:** 0x000 is ignored because **fTopN** is 0. + +**doper1:** An AFDOper that specifies the first AutoFilter condition. + +**doper1.vt:** 0x02 specifies that the type of comparison is numeric. + +**doper1.grbitSign:** 0x04 specifies that the comparison operation is GREATER THAN. + +**doper1.vtValue:** An AFDOperRk that specifies a numeric value. + +**doper1.vtValue.rk:** An RkNumber specifies a numeric value. + +**doper1.vtValue.rk.fX100:** 0x0 specifies that the value in the **doper1.vtValue.rk.num** field was not multiplied by 100 when it was saved. + +**doper1.vtValue.rk.fInt:** 0x0 specifies that the value in the **doper1.vtValue.rk.num** field is 30 most significant bits of a 64-bit binary floating-point number. + +**doper1.vtValue.rk.num:** 0x10146000 specifies the 30 most significant bits of a 64-bit binary floating-point number whose remaining bits are 0. That number is 70. + +**doper2:** An AFDOper that specifies the second AutoFilter condition. + +**doper2.vt:** 0x00 specifies that there is no second AutoFilter defined. + +**doper2.grbitSign:** 0x00 specifies that there is no second filter. + +**doper2.vtValue:** 0x0000000000000000 is ignored because **doper2.vt** is 0. + +## External References + +This example shows a workbook where the cell F5 contains an external reference to \[Book1.xls\]Sheet1!B3. The example workbook and Book1.xls are in the same folder, and the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) contents of Sheet1!B3 in the external workbook contains the string "External Cell". The following figure shows a possible implementation of the external reference discussed in this example: + +
+ +

Figure 33: External reference in this example a sheet

+
+ +### External References: Formula + +The first record in this example is the [Formula](#formula) record that appears in the [global substream](#Section_ca4c174887294a93abb94602b3a01fb1) (the global substream is not included in this example for brevity). This record specifies the formula for the cell F5. The formula is a reference to a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in an external [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +Other records mentioned in this example are [String](#string), [SupBook](#supbook), [XCT](#xct), [CRN](#crn) and [ExternSheet](#externsheet) records. These records specify the external referenced cell as well as the [external cell cache](#Section_b985d1a223f3483ebebdbd0e882d4c89) that stores the cached value of the cell. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------------------------|------------| +| 001D | Formula **- Formula** | | +| 0006 | [Cell](#cell) **- cell** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0004 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0005 | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x000F | +| 0008 | [FormulaValue](#formulavalue) **- val** | | +| 0001 | BYTE **- byte1** | 0x00 | +| 0001 | BYTE **- byte2** | 0x00 | +| 0001 | BYTE **- byte3** | 0xA0 | +| 0001 | BYTE **- byte4** | 0x00 | +| 0001 | BYTE **- byte5** | 0x9C | +| 0001 | BYTE **- byte6** | 0x01 | +| 0002 | USHORT **- fExprO** | 0xFFFF | +| 1 bit | USHORT **- fAlwaysCalc** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFill** | 0x0 | +| 1 bit | USHORT **- fShrFmla** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 1 bit | USHORT **- fClearErrors** | 0x0 | +| 10 bits | USHORT **- reserved3** | 0x000 | +| 0004 | ULONG **- unused** | 0xFCC412C8 | +| 0009 | [CellParsedFormula](#cellparsedformula) **- formula** | | +| 0002 | WORD **- cce** | 0x0007 | +| 0007 | [Rgce](#rgce) **- rgce** | | +| 0007 | [Ptg](#ptg) **- Ptg\[0\]** | | +| 0007 | [PtgRef3d](#ptgref3d) **- PtgRef3d** | | +| 5 bits | BYTE **- ptg** | 0x1A | +| 2 bits | [PtgDataType](#ptgdatatype) **- type** | 0x2 | +| 1 bit | BYTE **- reserved** | 0x0 | +| 0002 | USHORT **- ixti** | 0x0000 | +| 0004 | [RgceLoc](#rgceloc) **- loc** | | +| 0002 | [RwU](#rwu) **- row** | | +| 0002 | USHORT **- rw** | 0x0002 | +| 0002 | [ColRelU](#colrelu) **- column** | | +| 14 bits | USHORT **- col** | 0x0001 | +| 1 bit | USHORT **- colRelative** | 0x1 | +| 1 bit | USHORT **- rowRelative** | 0x1 | + +Figure 34: Structure of Formula + +**cell:** Specifies a cell in this [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that contains the external reference. The specified cell is F5. + +**cell.rw:** Specifies the row of this cell in this sheet. + +**cell.rw.rw:** 0x0004 specifies that the row of this cell is row 5. + +**cell.col:** Specifies the column of this cell in this sheet. + +**cell.col.col:** 0x0005 specifies that the column of this cell is column F. + +**cell.ixfe:** Specifies the formatting properties for this cell. + +**cell.ixfe.ixfe:** 0x000F specifies that the cell has the default cell format. + +**val:** Specifies the value to which the formula evaluated. This specifies the value stored in cell F5. + +**val.byte1:** 0x00 specifies that the value to which this formula is evaluated is a string value. The string value is stored in the String record following this record. + +**val.fExprO:** 0xFFFF specifies that the value to which this formula evaluated is a Boolean value, an error value, a string value, or a blank string value and that **val.byte2**, **val.byte3**, **val.byte4**, **val.byte5**, and **val.byte6** are ignored. **val.byte2**, **val.byte3**, **val.byte4**, **val.byte5**, and **val.byte6** are omitted from this example for brevity. + +**fAlwaysCalc:** 0x0 specifies that this cell value is not to be calculated during the next recalculation. + +**fFill:** 0x0 specifies that this cell has either a [**fill alignment**](#gt_cfc4e171-6104-470e-9ebb-812afea17078) or a [**center-across-selection alignment**](#gt_ef7324bd-dac8-46e2-8df5-db44d8b925a8). + +**fShrFmla:** 0x0 specifies that the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) is not part of a shared formula. + +**fClearErrors:** 0x0 specifies that the formula is not excluded from [**formula error checking**](#gt_c28d38d6-c6d1-4d06-89c2-29816f9c5b23). + +**formula:** Specifies the formula contained in the cell F5 in this sheet. + +**formula.cce:** 0x0007 specifies that the following **formula.rgce** field is 7 bytes. + +**formula.rgce:** Specifies the sequence of Ptgs structures. The sequence of Ptgs specify the formula. + +**formula.rgce.Ptg\[0\]:** The first and only Ptg structure in the sequence. Specifies that there is only one element in the formula. + +**formula.rgce.Ptg\[0\].PtgRef3d:** Specifies the PtgRef3d structure. Specifies that the formula is a reference to a single cell in a sheet. + +**formula.rgce.Ptg\[0\].PtgRef3d.ptg:** 0x1A specifies that this Ptg is a PtgRef3d structure. + +**formula.rgce.Ptg\[0\].PtgRef3d.type:** 0x2 specifies that the PtgRef3d data type is a single value. + +**formula.rgce.Ptg\[0\].PtgRef3d.ixti:** 0x0000 specifies the first [XTI](#xti) structure of the **rgXTI** array in the ExternSheet record. The first XTI of the **rgXTI** array specifies the Supbook record that specifies the target sheet that contains the referenced cell. This Supbook record is the third record in this example. The ExternSheet record is the seventh record in this example. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc:** Specifies the coordinates of the referenced cell. This field is a RgceLoc value because PtgRef3d is not part of a [NameParsedFormula](#nameparsedformula) structure. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.row:** Specifies the row of the referenced cell. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.row.rw:** 0x0002 specifies that the row of the referenced cell is row 3. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.column:** Specifies the column of the referenced cell. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.column.col:** 0x0001 specifies that the column of the referenced cell is column B. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.column.colRelative:** 0x1 specifies that the column is a [**relative reference**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac). + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.column.rowRelative:** 0x1 specifies that the row is a relative reference. + +### External References: String + +The next record in this example, [String](#string), specifies the Unicode string value to which the formula evaluated. + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------------------------|---------------| +| 0010 | String **- String** | | +| 0010 | [XLUnicodeString](#xlunicodestring) **- string** | External Cell | + +Figure 35: Structure of String + +**string:** *External Cell* is the Unicode string value. + +### External References: SupBook 1 + +The next record in this example, [Supbook](#supbook), specifies an external workbook referencing [supporting link](#Section_cc5920ba01074d92bbdfc12ca986f31f) and specifies the beginning of a collection of records that specifies the referenced cell (B3) in the [External Workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc) (*Book1.xls*). This record is the first SupBook record in the [global substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +The [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) of the referenced cell (*Book1.xls*) is specified in the Supbook record. The [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) of the referenced cell (*Sheet1*) is specified in the [XCT](#xct) record following this record. The referenced cell (B3) is specified in the [CRN](#crn) record following the XCT record. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 002A | SupBook **- SupBook** | | +| 0002 | USHORT **- ctab** | 0x0003 | +| 0002 | USHORT **- cch** | 0x000A | +| 000B | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- virtPath** | Book1.xls | +| 001B | [XLUnicodeString](#xlunicodestring) **- rgst** | | +| 0009 | XLUnicodeString **- rgst\[0\]** | Sheet1 | +| 0009 | XLUnicodeString **- rgst\[1\]** | Sheet2 | +| 0009 | XLUnicodeString **- rgst\[2\]** | Sheet3 | + +Figure 36: Structure of SupBook + +**ctab:** 0x0003 specifies that there are three sheets in the referenced workbook. + +**cch:** 0x000A specifies that there are 10 characters in **virtPath**. + +**virtPath:** *Book1.xls* specifies the encoded path of the referenced workbook. The length of the string is 10 characters, but the first character is an unprintable Unicode character with a value of 0x01. + +**rgst:** Specifies an array of three sheets contained within the referenced workbook. + +**rgst.rgst\[0\]:** *Sheet1* specifies the name of the first sheet in the referenced workbook. + +**rgst.rgst\[1\]:** *Sheet2* specifies the name of the second sheet in the referenced workbook. + +**rgst.rgst\[2\]:** *Sheet3* specifies the name of the third sheet in the referenced workbook. + +### External References: XCT + +The next record in this example, [XCT](#xct), specifies the beginning of an [external cell cache](#Section_b985d1a223f3483ebebdbd0e882d4c89) and specifies the beginning of a collection of [CRN](#crn) records. The collection of CRN records specifies the value of the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) (B3) in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) (*Sheet1*) in the external cell cache. + +| **Size** | **Structure** | **Value** | +|----------|-------------------|-----------| +| 0004 | XCT **- Xct** | | +| 0002 | SHORT **- ccrn** | 0x0001 | +| 0002 | USHORT **- itab** | 0x0000 | + +Figure 37: Structure of Xct + +**ccrn:** 0x0001 specifies that there is one CRN record immediately following this record. + +**itab:** 0x0000 specifies the first element in the **rgst** field of the [SupBook](#supbook) that specifies that the referenced cell is in the *Sheet1* sheet. + +### External References: CRN + +The next record in this example, [CRN](#crn), specifies the value of the referenced [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the [external cell cache](#Section_b985d1a223f3483ebebdbd0e882d4c89). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------|---------------| +| 0015 | CRN **- Crn** | | +| 0001 | [ColByteU](#colbyteu) **- colLast** | | +| 0001 | BYTE **- col** | 0x01 | +| 0001 | ColByteU **- colFirst** | | +| 0001 | BYTE **- col** | 0x01 | +| 0002 | [RwU](#rwu) **- row** | | +| 0002 | USHORT **- rw** | 0x0002 | +| 0011 | CRNOper **- crnOper** | | +| 0011 | [SerAr](#serar) **- crnOper\[0\]** | | +| 0001 | BYTE **- reserved** | 0x02 | +| 0010 | [SerStr](#serstr) **- string** | External Cell | + +Figure 38: Structure of Crn + +**colLast:** Specifies the column of the last cell that has a value in the external cell cache. + +**colLast.col:** 0x01 specifies that the column of the last cell is column B. + +**colFirst:** Specifies the column of the first cell that has a value in the external cell cache. + +**colFirst.col:** 0x01 specifies that the column of the first cell is column B. + +**row:** Specifies the row index of the cell that has a value in the external cell cache. + +**row.rw:** 0x0002 specifies that the row of the cell is row 3. + +**crnOper:** Specifies an array of cell values in the range specified by **colLast**, **colFirst** and **row**, which is B3. + +**crnOper.crnOper\[0\].string:** *External Cell* specifies the text referenced in cell B3. + +### External References: SupBook 2 + +The next record in this example, [SupBook](#supbook), specifies a self-referencing [supporting link](#Section_cc5920ba01074d92bbdfc12ca986f31f). The self-referencing supporting link is used when a cell in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) refers to a cell in a different [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the same workbook. In this example this record is not used. This is the second SupBook record in the [global substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------|-----------| +| 0004 | SupBook **- SupBook** | | +| 0002 | USHORT **- ctab** | 0x0003 | +| 0002 | USHORT **- cch** | 0x0401 | + +Figure 39: Structure of SupBook + +The **VirtPath** field and **rgst** field of this record are similar to the corresponding fields of the third record (SupBook) in this example and are omitted for brevity. + +**ctab:** 0x0003 specifies that there are three sheets in the referenced workbook. + +**cch:** 0x0401 specifies that this is self-referencing supporting link. + +### External References: ExternSheet + +The next record in this example, [ExternSheet](#externsheet), specifies a collection of [XTI](#xti) records that specify the [supporting link](#Section_cc5920ba01074d92bbdfc12ca986f31f) information. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------|-----------| +| 000E | ExternSheet **- ExtSheet** | | +| 0002 | USHORT **- cXTI** | 0x0002 | +| 000C | XTI **- rgXTI** | | +| 0006 | XTI **- xti\[0\]** | | +| 0002 | USHORT **- iSupBook** | 0x0000 | +| 0002 | SHORT **- itabFirst** | 0x0000 | +| 0002 | SHORT **- itabLast** | 0x0000 | +| 0006 | XTI **- xti\[1\]** | | +| 0002 | USHORT **- iSupBook** | 0x0001 | +| 0002 | SHORT **- itabFirst** | 0x0000 | +| 0002 | SHORT **- itabLast** | 0x0000 | + +Figure 40: Structure of ExtSheet + +**cXTI:** 0x0002 specifies that there are two elements in the **rgXTI** array. + +**rgXTI:** An array of XTI elements. The number of elements in the array is specified by the **cXTI** field. + +**rgXTI.xti\[0\]:** This is the first XTI element in the array. + +**rgXTI.xti\[0\].iSupBook:** 0x0000 specifies the reference to the first [SupBook](#supbook) record in the [global substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +**rgXTI.xti\[0\].itabFirst:** 0x0000 specifies that the supporting link has a sheet-level scope and specifies the first sheet, within the referenced [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), that is in scope. The first sheet in scope is *Sheet1*. + +**rgXTI.xti\[0\].itabLast:** 0x0000 specifies that the supporting link has a sheet-level scope and specifies the last sheet, within the referenced workbook, that is in scope. The last sheet in scope is *Sheet1*. + +**rgXTI.xti\[1\]:** This is the second XTI element in the array. (The details of the referenced XTI record are omitted for brevity.) + +**rgXTI.xti\[1\].iSupBook:** 0x0001 specifies the reference to the second SupBook record in the global substream. + +## Column Chart Object + +This example shows a column chart object on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). The set of records that specify the column chart exist in the [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11) of the file (the chart sheet substream is not included in this example for brevity). The column chart specified in this example has a single series with three control points. The following figure shows a possible implementation of the column chart discussed in this example: + +
+ +

Figure 41: Column chart in this example within a sheet

+
+ +### Column Chart Object: Chart + +The first record in this example is the [Chart](#chart-2) record. This record specifies the position and [**dimensions (2)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)). The position of the chart area is automatically calculated by the application and the dimension (2) of the chart is specified by the **dx** and **dy** fields. + +| **Size** | **Structure** | **Value** | +|----------|---------------------|------------| +| 0010 | Chart **- Chart** | | +| 0004 | FixedPoint **- x** | 0x00000000 | +| 0004 | FixedPoint **- y** | 0x00000000 | +| 0004 | FixedPoint **- dx** | 0x01493FD0 | +| 0004 | FixedPoint **- dy** | 0x00F0C000 | + +Figure 42: Structure of Chart + +**x:** The value of this field is ignored because the **fAutoPosition** field of the **Frame** record that follows this record equals 1. + +**y:** The value of this field is ignored because the **fAutoPosition** field of the **Frame** record that follows this record equals 1. + +**dx:** 0x01493FD0 specifies the width of the chart in [**points**](#gt_d072e4da-7898-4227-8f25-9fe77db43571). This field is a fixed point and the width is calculated using the following formula: + +> width of chart = 0149 + (3FD0 / 65536.0) = 329 + (16336 / 65536) + +**dy:** 0x00F0C000 specifies the height of the chart in points. This field is a fixed point and the height is calculated using the following formula: + +> height of chart = 00F0 + (C000 / 65536.0) = 240 + (49152 / 65536) + +The next record in this example, [Begin](#begin), specifies the beginning of a collection of records that specifies the chart area (section 2.2.3.17) of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +The next record in this example, [Scl](#scl), specifies the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) of the current view in the window used to display the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). The zoom level of the current view is equal to 1. + +The next record in this example, [PlotGrowth](#plotgrowth), specifies the scale factors for [**font scaling**](#gt_47254269-4165-4a8c-92a0-c920f732d0bd) in the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). + +(The details of the Begin record, the Scl record, and the PlotGrowth record are omitted from the example for brevity.) + +### Column Chart Object: Frame + +The next record in this example, [Frame](#frame), specifies the type, size, and position of the frame around the column chart. The size of the frame is stored in the [Chart](#chart-2) record and the position of the frame is automatically calculated by the application. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------|-----------| +| 0004 | Frame **- Frame** | | +| 0002 | USHORT **- frt** | 0x0000 | +| 1 bit | USHORT **- fAutoSize** | 0x0 | +| 1 bit | USHORT **- fAutoPosition** | 0x1 | +| 14 bits | USHORT **- reserved** | 0x0000 | + +Figure 43: Structure of Frame + +**frt:** 0x0000 specifies that the frame surrounding the chart element does not have a shadow. + +**fAutoSize:** 0x0000 specifies that the size of the frame is not automatically calculated. The width (**dx** field) and height (**dy** field) of the Chart record are used as the size of the frame. + +**fAutoPosition:** 0x0001 specifies that the position of the frame is automatically calculated by the application and the **x** and **y** fields of the Chart record are ignored. + +### Column Chart Object: LineFormat + +The next record in this example, [LineFormat](#lineformat), specifies the appearance of the lines of the frame. + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------|-----------| +| 000C | LineFormat **- LineFormat** | | +| 0004 | [LongRGB](#longrgb) **- rgb** | | +| 0001 | BYTE **- red** | 0x00 | +| 0001 | BYTE **- green** | 0x00 | +| 0001 | BYTE **- blue** | 0x00 | +| 0001 | BYTE **- reserved** | 0x00 | +| 0002 | USHORT **- lns** | 0x0000 | +| 0002 | SHORT **- we** | 0x0000 | +| 1 bit | USHORT **- fAuto** | 0x1 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fAxisOn** | 0x0 | +| 1 bit | USHORT **- fAutoCo** | 0x1 | +| 12 bits | USHORT **- reserved2** | 0x000 | +| 0002 | [IcvChart](#icvchart) **- icv** | | +| 0002 | USHORT **- icv** | 0x004D | + +Figure 44: Structure of LineFormat + +(Fields in this record that are ignored because **fAuto** is 0x1 are omitted for brevity.) + +**fAuto:** 0x1 specifies that the contents of the **lns**, **we**, **icv,** and **rgb** field are ignored and the defaults specified in the following table are used instead: + +| Attribute | Default Value | +|------------------------|-------------------| +| Line pattern (**lns**) | 0xFFFF (Hairline) | +| Line weight (**we**) | 0x0000 (Narrow) | +| Line color (**icv**) | 0x004D | +| Line color (**rgb**) | 0x004D | + +**fAxisOn:** 0x0000 specifies this field is ignored because the previous record is not an [AxisLine](#axisline) record with an **id** field equal to 0X0000, specifying the frame does not have any [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) lines. + +### Column Chart Object: AreaFormat + +The next record in this example, [AreaFormat](#areaformat), specifies the patterns and colors used in the filled area of the column chart. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------|-----------| +| 0010 | AreaFormat **- AreaFormat** | | +| 0004 | [LongRGB](#longrgb) **- rgbFore** | | +| 0001 | BYTE **- red** | 0xFF | +| 0001 | BYTE **- green** | 0xFF | +| 0001 | BYTE **- blue** | 0xFF | +| 0001 | BYTE **- reserved** | 0x00 | +| 0004 | LongRGB **- rgbBack** | | +| 0001 | BYTE **- red** | 0x00 | +| 0001 | BYTE **- green** | 0x00 | +| 0001 | BYTE **- blue** | 0x00 | +| 0001 | BYTE **- reserved** | 0x00 | +| 0002 | SHORT **- fls** | 0x0001 | +| 1 bit | WORD **- fAuto** | 0x1 | +| 1 bit | WORD **- fInvertNeg** | 0x0 | +| 14 bits | WORD **- reserved** | 0x0000 | +| 0002 | [IcvChart](#icvchart) **- icvFore** | | +| 0002 | USHORT **- icv** | 0x004E | +| 0002 | IcvChart **- icvBack** | | +| 0002 | USHORT **- icv** | 0x004D | + +Figure 45: Structure of AreaFormat + +(Fields in this record that are ignored because **fAuto** is 0x1 are omitted for brevity.) + +**fls:** 0x0001 specifies that the fill pattern is solid. + +**fAuto:** 0x1 specifies that the fill colors are automatically set by the application. + +The next record in this example, [End](#end), specifies the end of a collection of records that specifies the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)) of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). The details of End record are omitted from the example for brevity. + +### Column Chart Object: Series + +The next record in this example, [Series](#series-1), specifies a Series of this chart, the type of data it contains and the number of data fields that make up this series**.** The series of this column chart contains three textual [**categories**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) and three numerical values. In this example the series of this column chart is specified by the first Series record in the collection of Series records in the current [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11). + +| **Size** | **Structure** | **Value** | +|----------|------------------------|-----------| +| 000C | Series **- Series** | | +| 0002 | USHORT **- sdtX** | 0x0003 | +| 0002 | USHORT **- sdtY** | 0x0001 | +| 0002 | USHORT **- cValx** | 0x0003 | +| 0002 | USHORT **- cValy** | 0x0003 | +| 0002 | USHORT **- sdtBSize** | 0x0001 | +| 0002 | USHORT **- cValBSize** | 0x0000 | + +Figure 46: Structure of Series + +Fields in this record that are ignored because this [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is not of the type bubble chart group, are omitted for brevity. + +**sdtX:** 0x0003 specifies that the categories contain text information. + +**sdtY:** 0x0001 specifies that the values contain numeric information. + +**cValx:** 0x0003 specifies that the count of categories is 3. + +**cValy:** 0x0003 specifies that the count of values is 3. + +Records following this record, and before the next [BRAI](#brai) record, are omitted for brevity. + +### Column Chart Object: BRAI 1 + +The next record in this example, [BRAI](#brai), specifies a reference to [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that have values that specify the name of the series. + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------------------------|-----------| +| 000F | BRAI **- BRAI** | | +| 0001 | BYTE **- id** | 0x00 | +| 0001 | BYTE **- rt** | 0x02 | +| 1 bit | USHORT **- fUnlinkedIfmt** | 0x0 | +| 15 bits | USHORT **- reserved** | 0x0000 | +| 0002 | IFmt **- ifmt** | 0x0000 | +| 0009 | [ChartParsedFormula](#chartparsedformula) **- formula** | | +| 0002 | WORD **- cce** | 0x0007 | +| 0007 | [Rgce](#rgce) **- rgce** | | +| 0007 | [Ptg](#ptg) **- Ptg\[0\]** | | +| 0007 | [PtgRef3d](#ptgref3d) **- PtgRef3d** | | +| 5 bits | BYTE **- ptg** | 0x1A | +| 2 bits | [PtgDataType](#ptgdatatype) **- type** | 0x1 | +| 1 bit | BYTE **- reserved** | 0x0 | +| 0002 | USHORT **- ixti** | 0x0000 | +| 0004 | [RgceLoc](#rgceloc) **- loc** | | +| 0002 | [RwU](#rwu) **- row** | | +| 0002 | USHORT **- rw** | 0x0001 | +| 0002 | [ColRelU](#colrelu) **- column** | | +| 14 bits | USHORT **- col** | 0x0000 | +| 1 bit | USHORT **- colRelative** | 0x0 | +| 1 bit | USHORT **- rowRelative** | 0x0 | + +Figure 47: Structure of BRAI + +**id:** 0x00 specifies that the values of the referenced cells specify the name of the series. + +**rt:** 0x02 specifies that the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is values from a range of cells in a sheet specified by the **rgce** field. + +**fUnlinkedIfmt:** 0x0 specifies that the series name maintains the number formatting of the referenced data. + +**ifmt:** 0x0000 specifies that the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) for the name of the series is automatically determined by the application. + +**formula.cce:** 0x0007 specifies that the length of **rgce** is 7 bytes. + +**formula.rgce.Ptg\[0\].PtgRef3d:** This operand specifies a reference to a specific cell on one or more sheets. + +**formula.rgce.Ptg\[0\].PtgRef3d.ptg:** 0x1A specifies that this Ptg is of type PtgRef3d. + +**formula.rgce.Ptg\[0\].PtgRef3d.type:** 0x1 specifies that the value of the **ptg** field is a reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +**formula.rgce.Ptg\[0\].PtgRef3d.ixti:** 0x0000 specifies that the name of the series is found on the sheets referenced by the first [XTI](#xti) in the [ExternSheet](#externsheet) record. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc:** Specifies that the coordinates of the referenced cell for the name of the series refers to cell A2. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.row.rw:** 0x0001 specifies that the referenced cell is in row two. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.column.col:** 0x0000 specifies that the referenced cell is in column A. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.column.colRelative:** 0x0 specifies that the **col** field is an [**absolute reference**](#gt_cb0d7340-bfcf-4740-b77b-6616c2e4a542). + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.column.rowRelative:** 0x0 specifies that the **rw** field is an absolute reference. + +### Column Chart Object: SeriesText + +The next record in this example, [SeriesText](#seriestext), specifies the name of this [Series](#series-1). The name of this Series is *Customers*. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0016 | SeriesText **- SeriesText** | | +| 0002 | USHORT **- reserved** | 0x0000 | +| 0014 | [ShortXLUnicodeString](#shortxlunicodestring) **- stText** | Customers | + +Figure 48: Structure of SeriesText + +**stText:** *Customers* specifies name of the series. + +### Column Chart Object: BRAI 2 + +The next record in this example, [BRAI](#brai), specifies a reference to data in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that specifies the values of this series. The values for this series are stored in the range B2:D2. + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------------------------|-----------| +| 0013 | BRAI **- BRAI** | | +| 0001 | BYTE **- id** | 0x01 | +| 0001 | BYTE **- rt** | 0x02 | +| 1 bit | USHORT **- fUnlinkedIfmt** | 0x0 | +| 15 bits | USHORT **- reserved** | 0x0000 | +| 0002 | IFmt **- ifmt** | 0x0000 | +| 000D | [ChartParsedFormula](#chartparsedformula) **- formula** | | +| 0002 | WORD **- cce** | 0x000B | +| 000B | [Rgce](#rgce) **- rgce** | | +| 000B | [Ptg](#ptg) **- Ptg\[0\]** | | +| 000B | [PtgArea3d](#ptgarea3d) **- PtgArea3d** | | +| 5 bits | BYTE **- ptg** | 0x1B | +| 2 bits | [PtgDataType](#ptgdatatype) **- type** | 0x1 | +| 1 bit | BYTE **- reserved** | 0x0 | +| 0002 | USHORT **- ixti** | 0x0000 | +| 0008 | [RgceArea](#rgcearea) **- area** | | +| 0002 | [RwU](#rwu) **- rowFirst** | | +| 0002 | USHORT **- rw** | 0x0001 | +| 0002 | RwU **- rowLast** | | +| 0002 | USHORT **- rw** | 0x0001 | +| 0002 | [ColRelU](#colrelu) **- columnFirst** | | +| 14 bits | USHORT **- col** | 0x0001 | +| 1 bit | USHORT **- colRelative** | 0x0 | +| 1 bit | USHORT **- rowRelative** | 0x0 | +| 0002 | ColRelU **- columnLast** | | +| 14 bits | USHORT **- col** | 0x0003 | +| 1 bit | USHORT **- colRelative** | 0x0 | +| 1 bit | USHORT **- rowRelative** | 0x0 | + +Figure 49: Structure of BRAI + +**id:** 0x01 specifies that the referenced data specifies the values of the series. + +**rt:** 0x02 specifies that the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is values from a range of cells in a sheet specified by the **rgce** field. + +**fUnlinkedIfmt:** 0x0 specifies that the series maintains the number formatting of the referenced data. + +**ifmt:** 0x0000 specifies that the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) for the values of the series is automatically determined by the application. + +**formula.cce:** 0x000B specifies that the length of the **rgce** field is 11 bytes. + +**formula.rgce.Ptg\[0\].PtgArea3d:** This operand specifies a reference to the rectangular range of cells on the sheet. + +**formula.rgce.Ptg\[0\].PtgArea3d.ptg:** 0x1B specifies that this Ptg structure is of type PtgArea3d. + +**formula.rgce.Ptg\[0\].PtgArea3d.type:** 0x01 specifies that the value of the **ptg** field is a reference to a range. + +**formula.rgce.Ptg\[0\].PtgArea3d.ixti:** 0x0000 specifies the values of the series are found on the sheet referenced by the first [XTI](#xti) structure in the [ExternSheet](#externsheet) record. + +**formula.rgce.Ptg\[0\].PtgArea3d.area:** Specifies that the coordinates of the referenced rectangular range of cells for values of the series are in the range B2:D2. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.rowFirst.rw:** 0x0001 specifies that row two of the sheet is the first row of the rectangular range of cells. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.rowLast.rw:** 0x0001 specifies that row two of the sheet is the last row of the rectangular range of cells. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.columnFirst.col:** 0x0001 specifies that column B of the sheet is the first column of the rectangular range of cells. The details of this ColRelU are not included in this example for brevity. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.columnLast.col:** 0x0003 specifies that column D of the sheet is the last column of the rectangular range of cells. The details of this ColRelU are not included in this example for brevity. + +### Column Chart Object: BRAI 3 + +The next record in this example, [BRAI](#brai), specifies a reference to data in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that specifies the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) names of this series. The category names are stored in the range B1:D1. + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------------------------|-----------| +| 0013 | BRAI **- BRAI** | | +| 0001 | BYTE **- id** | 0x02 | +| 0001 | BYTE **- rt** | 0x02 | +| 0002 | USHORT **- fUnlinkedIfmt** | 0x0000 | +| 0002 | USHORT **- reserved** | 0x0000 | +| 0002 | IFmt **- ifmt** | 0x0000 | +| 000D | [ChartParsedFormula](#chartparsedformula) **- formula** | | +| 0002 | WORD **- cce** | 0x000B | +| 000B | [Rgce](#rgce) **- rgce** | | +| 000B | [Ptg](#ptg) **- Ptg\[0\]** | | +| 000B | [PtgArea3d](#ptgarea3d) **- PtgArea3d** | | +| 0001 | BYTE **- ptg** | 0x1B | +| 0001 | [PtgDataType](#ptgdatatype) **- type** | 0x01 | +| 0001 | BYTE **- reserved** | 0x00 | +| 0002 | USHORT **- ixti** | 0x0000 | +| 0008 | [RgceArea](#rgcearea) **- area** | | +| 0002 | [RwU](#rwu) **- rowFirst** | | +| 0002 | USHORT **- rw** | 0x0000 | +| 0002 | RwU **- rowLast** | | +| 0002 | USHORT **- rw** | 0x0000 | +| 0002 | [ColRelU](#colrelu) **- columnFirst** | | +| 14 bits | USHORT **- col** | 0x0001 | +| 1 bit | USHORT **- colRelative** | 0x0 | +| 1 bit | USHORT **- rowRelative** | 0x0 | +| 0002 | ColRelU **- columnLast** | | +| 14 bits | USHORT **- col** | 0x0003 | +| 1 bit | USHORT **- colRelative** | 0x0 | +| 1 bit | USHORT **- rowRelative** | 0x0 | + +Figure 50: Structure of BRAI + +**id:** 0x02 specifies that the referenced data specifies the category name of the series. + +**rt:** 0x02 specifies that the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is values from a range of cells in a sheet specified by the **rgce** field. + +**fUnlinkedIfmt:** 0x0000 specifies that the series maintains the number formatting of the referenced data. + +**ifmt:** 0x0000 specifies that the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) for the category names of the series is automatically determined by the application. + +**formula.cce:** 0x000B specifies that the length of the **rgce** field is 11 bytes. + +**formula.rgce.Ptg\[0\].PtgArea3d:** This operand specifies a reference to the rectangular range of cells on the sheet. + +**formula.rgce.Ptg\[0\].PtgArea3d.ptg:** 0x1B specifies that this Ptg structure is of type PtgArea3d. + +**formula.rgce.Ptg\[0\].PtgArea3d.type:** 0x01 specifies that the data type for the value of the **ptg** field is a reference to a range. + +**formula.rgce.Ptg\[0\].PtgArea3d.ixti:** 0x0000 specifies that the name of the category is found on the sheet referenced by the first [XTI](#xti) structure in the [ExternSheet](#externsheet) record. + +**formula.rgce.Ptg\[0\].PtgArea3d.area:** Specifies that the coordinates of the referenced rectangular range of cells for the names of categories are in the range B1:D1. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.rowFirst.rw:** 0x0000 specifies that the first row of the sheet is the first row of the rectangular range of cells. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.rowLast.rw:** 0x0000 specifies that the first row of the sheet is the last row of the rectangular range of cells. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.columnFirst.col:** 0x0001 specifies that the second column of the sheet is the first column of the rectangular range of cells. The details of this ColRelU structure are not included in this example for brevity. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.columnLast.col:** 0x0003 specifies that the fourth column of the sheet is the last column of the rectangular range of cells. The details of this ColRelU are not included in this example for brevity. + +(Records following this record, and before the next [DataFormat](#dataformat) record, are omitted for brevity.) + +### Column Chart Object: DataFormat + +The next record in this example, [DataFormat](#dataformat), specifies the series of this chart to which the formatting information applies. The formatting information is specified by the [Lineformat](#lineformat) record and [AreaFormat](#areaformat) record following this record. (The Lineformat and AreaFormat records are not included in this example for brevity.) + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------|-----------| +| 0008 | DataFormat **- DataFormat** | | +| 0002 | USHORT **- xi** | 0xFFFF | +| 0002 | USHORT **- yi** | 0x0000 | +| 0002 | SHORT **- iss** | 0x0000 | +| 15 bits | SHORT **- reserved** | 0x0000 | + +Figure 51: Structure of DataFormat + +**xi:** 0xFFFF specifies that the LineFormat record and AreaFormat record following this record specify the format of the series. + +**yi:** 0x0000 specifies that the series of this chart is specified by the first [Series](#series-1) record in the collection of Series records in the current [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11). + +**iss:** 0x0000 specifies the number of the series based on the ordering in the legend, which is zero. + +The next two records in this example, LineFormat and AreaFormat, specify the formatting information for the series. (The LineFormat record and AreaFormat record are similar to the LineFormat record and AreaFormat record defined earlier in the example and are omitted for brevity.) + +### Column Chart Object: SerToCrt + +The next record in this example, [SerToCrt](#sertocrt), specifies the chart that contains the series specified in this example. The [ChartFormat](#chartformat) record that specifies this chart is the first ChartFormat record in the [chart sheet subsream](#Section_732ff614d939416bb7c76d983471ff11). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|-----------| +| 0002 | SerToCrt **- SerToCrt** | | +| 0002 | USHORT **- id** | 0x0000 | + +Figure 52: Structure of SerToCrt + +**id:** 0x0000 specifies that the chart that contains the series in this example is specified by the first ChartFormat record in the collection of ChartFormat records in the current chart sheet substream. + +(Records following this record, and before the next [ShtProps](#shtprops) record, are omitted for brevity.) + +### Column Chart Object: ShtProps + +The next record in this example, [ShtProps](#shtprops), specifies the properties of this chart. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------------|-----------| +| 0004 | ShtProps **- ShtProps** | | +| 1 bit | USHORT **- fManSerAlloc** | 0x0 | +| 1 bit | USHORT **- fPlotVisOnly** | 0x1 | +| 1 bit | USHORT **- fNotSizeWith** | 0x0 | +| 1 bit | USHORT **- fManPlotArea** | 0x1 | +| 1 bit | USHORT **- fAlwaysAutoPlotArea** | 0x0 | +| 11 bits | USHORT **- reserved1** | 0x000 | +| 0001 | BYTE **- mdBlank** | 0x00 | +| 0001 | BYTE **- reserved2** | 0x00 | + +Figure 53: Structure of ShtProps + +**fManSerAlloc:** 0x0 specifies that the series is not automatically allocated for this chart. + +**fPlotVisOnly:** 0x1 specifies to plot only [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) cells on this chart. + +**fNotSizeWith:** 0x0 specifies not to size this chart with the window. + +**fAlwaysAutoPlotArea:** 0x0 specifies that the default [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) [**dimension (2)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) is used for this chart. + +**mdBlank:** 0x00 specifies that empty cells are not plotted on this chart. + +### Column Chart Object: DefaultText + +The next record in this example, [DefaultText](#defaulttext), specifies the text elements that are formatted using the information specified in the [Text](#text) record that follows this record. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------|-----------| +| 0002 | DefaultText **- DefaultText** | | +| 0002 | USHORT **- id** | 0x0002 | + +Figure 54: Structure of DefaultText + +**id:** 0x0002 specifies that the default formatting of all text in the chart that does not use scalable fonts is to be set by the Text record following this record. + +### Column Chart Object: Text + +The next record in this example, [Text](#text), specifies the position and appearance of text fields specified in the preceding [DefaultText](#defaulttext) record. + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------|------------| +| 0020 | Text **- Text** | | +| 0001 | BYTE **- at** | 0x02 | +| 0001 | BYTE **- vat** | 0x02 | +| 0002 | WORD **- wBkgMode** | 0x0001 | +| 0004 | [LongRGB](#longrgb) **- rgbText** | | +| 0001 | BYTE **- red** | 0x00 | +| 0001 | BYTE **- green** | 0x00 | +| 0001 | BYTE **- blue** | 0x00 | +| 0001 | BYTE **- reserved** | 0x00 | +| 0004 | LONG **- x** | 0xFFFFFFD1 | +| 0004 | LONG **- y** | 0xFFFFFFC0 | +| 0004 | LONG **- dx** | 0x00000000 | +| 0004 | LONG **- dy** | 0x00000000 | +| 1 bit | USHORT **- fAutoColor** | 0x1 | +| 1 bit | USHORT **- fShowKey** | 0x0 | +| 1 bit | USHORT **- fShowValue** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fAutoText** | 0x1 | +| 1 bit | USHORT **- fGenerated** | 0x1 | +| 1 bit | USHORT **- fDeleted** | 0x0 | +| 1 bit | USHORT **- fAutoMode** | 0x1 | +| 3 bits | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fShowLabelAndPerc** | 0x0 | +| 1 bit | USHORT **- fShowPercent** | 0x0 | +| 1 bit | USHORT **- fShowBubbleSizes** | 0x0 | +| 1 bit | USHORT **- fShowLabel** | 0x0 | +| 1 bit | USHORT **- reserved** | 0x0 | +| 0002 | [Icv](#icv) **- icvText** | | +| 0002 | USHORT **- icv** | 0x004D | +| 4 bits | USHORT **- dlp** | 0x0 | +| 10 bits | USHORT **- unused3** | 0x317 | +| 2 bits | USHORT **- iReadingOrder** | 0x0 | +| 0002 | USHORT **- trot** | 0x0000 | + +Figure 55: Structure of Text + +The position and size specified by the **x** field, **y** field, **dx** field, and **dy** field is ignored because this record is followed by a [Pos](#pos) record. The **fShowLabelAndPerc** field**, fShowPercent** field**, fShowBubbleSizes** field**, fShowLabel** field, and **dlp** field are ignored because this is a column chart. + +**at:** 0x02 specifies that the horizontal alignment of the text is center-alignment. + +**vat:** 0x02 specifies that the vertical alignment of the text is center-alignment. + +**wBkgMode:** 0x0001 specifies that the background of the text is transparent. + +**rgbText:** Specifies the color of the text. + +**fAutoColor:** 0x0001 specifies that the foreground color is determined automatically. + +**fAutoText:** 0x0001 specifies that the text value of the text field is automatically generated and has not been changed. + +**fGenerated:** 0x0001 specifies that the properties of the text field are automatically generated and was not changed. + +**fAutoMode:** 0x0001 specifies that the background color is determined automatically. + +**icvText:** Specifies a color in the color table. + +**icvText.icv:** 0x004D specifies that the default chart foreground color is used. + +**iReadingOrder:** 0x0000 specifies that the reading order is based on the context. + +**trot:** 0x0000 specifies that the text is not rotated. + +(Records following this record, and before the next [FontX](#fontx) record, are omitted for brevity.) + +### Column Chart Object: FontX + +The next record in this example, [FontX](#fontx), specifies the font used for text of this chart. + +| **Size** | **Structure** | **Value** | +|----------|--------------------|-----------| +| 0002 | FontX **- FontX** | | +| 0002 | USHORT **- iFont** | 0x0005 | + +Figure 56: Structure of FontX + +**iFont:** 0x0005 specifies that the referenced font is the fifth [Font](#font) record in the [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11). + +(Records following this record, and before the next [AxesUsed](#axesused) record, are omitted for brevity.) + +### Column Chart Object: AxesUsed + +The next record in this example, [AxesUsed](#axesused), specifies the number of [axis groups](#Section_578b739742624944b5a67ee6d4d3bb55) on the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|-----------| +| 0002 | AxesUsed **- AxesUsed** | | +| 0002 | USHORT **- cAxes** | 0x0001 | + +Figure 57: Structure of AxesUsed + +**cAxes:** 0x0001 specifies that this chart contains a single primary axis group. + +### Column Chart Object: AxisParent + +The next record in this example, [AxisParent](#axisparent), specifies the properties of an [axis group](#Section_578b739742624944b5a67ee6d4d3bb55) and specifies the beginning of a collection of records as defined by the [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11) that specifies an Axis Group. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0012 | AxisParent **- AxisParent** | | +| 0002 | SHORT **- iax** | 0x0000 | +| 0010 | Unused **- unused** | 5D 00 00 00 81 00 00 00 E6 0E 00 00 10 0D 00 00 | + +Figure 58: Structure of AxisParent + +**iax:** 0x0000 specifies that the Axis Group specified by the records following this record is primary. + +Records following this record, and before the next [Axis](#axis-1) record, are omitted for brevity. + +### Column Chart Object: Axis + +The next record in this example, [Axis](#axis-1), specifies properties of an [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) and specifies the beginning of a collection of records as defined by the [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11) that specifies the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) axis. + +| **Size** | **Structure** | **Value** | +|----------|-----------------------|------------| +| 0012 | Axis **- Axis** | | +| 0002 | WORD **- wType** | 0x0000 | +| 0004 | ULONG **- reserved1** | 0x00000000 | +| 0004 | ULONG **- reserved2** | 0x00000000 | +| 0004 | ULONG **- reserved3** | 0x00000000 | +| 0004 | ULONG **- reserved4** | 0x00000000 | + +Figure 59: Structure of Axis + +**wType:** 0x0000 specifies that the axis type is category axis. + +(Records following this record, and before the next [CatSerRange](#catserrange) record, are omitted for brevity.) + +### Column Chart Object: CatSerRange + +The next record in this example, [CatSerRange](#catserrange), specifies the properties of the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------|-----------| +| 0008 | CatSerRange **- CatSerRange** | | +| 0002 | SHORT **- catCross** | 0x0001 | +| 0002 | SHORT **- catLabel** | 0x0001 | +| 0002 | SHORT **- catMark** | 0x0001 | +| 1 bit | USHORT **- fBetween** | 0x1 | +| 1 bit | USHORT **- fMaxCross** | 0x0 | +| 1 bit | USHORT **- fReverse** | 0x0 | +| 13 bits | USHORT **- reserved** | 0x0000 | + +Figure 60: Structure of CatSerRange + +**catCross:** 0x0001 specifies the category axis is crossed by the value axis at the first category. + +**catLabel:** 0x0001 specifies that the number of categories between [**major tick mark**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) labels is 1. + +**catMark:** 0x0001 specifies that the number of categories between major tick marks is 1. + +**fBetween:** 0x0001 specifies that the value axis crosses the category axis between two major tick marks. + +**fMaxCross:** 0x0000 specifies that the value axis crosses the category axis at the category specified by the **catCross** field. + +**fReverse:** 0x0000 specifies that categories are displayed in order. + +### Column Chart Object: Tick + +The next record in this example, [Tick](#tick), specifies the properties of the [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) and [**minor tick marks**](#gt_c2eb605a-6c5a-427e-8608-f16940de82a6) associated with the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------|------------| +| 001E | Tick **- Tick** | | +| 0001 | BYTE **- tktMajor** | 0x02 | +| 0001 | BYTE **- tktMinor** | 0x00 | +| 0001 | BYTE **- tlt** | 0x03 | +| 0001 | BYTE **- wBkgMode** | 0x01 | +| 0004 | [LongRGB](#longrgb) **- rgb** | | +| 0001 | BYTE **- red** | 0x00 | +| 0001 | BYTE **- green** | 0x00 | +| 0001 | BYTE **- blue** | 0x00 | +| 0001 | BYTE **- reserved** | 0x00 | +| 0004 | LONG **- reserved1** | 0x00000000 | +| 0004 | LONG **- reserved2** | 0x00000000 | +| 0004 | LONG **- reserved3** | 0x00000000 | +| 0004 | LONG **- reserved4** | 0x00000000 | +| 1 bit | USHORT **- fAutoCo** | 0x1 | +| 1 bit | USHORT **- fAutoMode** | 0x1 | +| 3 bits | USHORT **- rot** | 0x0 | +| 1 bit | USHORT **- fAutoRot** | 0x1 | +| 8 bits | USHORT **- unused** | 0x00 | +| 2 bits | USHORT **- iReadingOrder** | 0x0 | +| 0002 | [IcvChart](#icvchart) **- icv** | | +| 0002 | USHORT **- icv** | 0x004D | +| 0002 | SHORT **- trot** | 0x0000 | + +Figure 61: Structure of Tick + +The **rgb** field is ignored because the **fAUtoCo** field is equal to 0x0001. The **wBkgMode** field is ignored because the **fAutoMode** field is equal to 0x0001. The **rot** field is ignored because the **fAutoRot** field is equal to 0x0001. + +**tktMajor:** 0x02 specifies that the location of the major tick marks is outside, which indicates that the major tick marks are drawn away from the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). + +**tktMinor:** 0x00 specifies that no minor tick marks are present on the axis. + +**tlt:** 0x03 specifies to place axis labels next to the axis. + +**fAutoCo:** 0x0001 specifies that the text uses an automatically selected foreground color, based on the display settings of the computer. + +**fAutoMode:** 0x0001 specifies that the background mode is set according to the [DefaultText](#defaulttext) settings of the chart + +**fAutoRot:** 0x0001 specifies that the text rotation of axis labels is determined automatically. + +**iReadingOrder:** 0x0000 specifies that the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361) of the axis label is determined by the application. + +**icv.icv:** 0x004D specifies that the foreground color is the default chart foreground color. This is the window text color in the chart display. + +**trot:** 0x0000 specifies that the axis label is not rotated. + +(Records following this record, and before the next [ChartFormat](#chartformat) record, are omitted for brevity.) The collection of records includes a collection of record beginning with the [Axis](#axis-1) record that specifies the value axis for this chart. + +### Column Chart Object: ChartFormat + +The next record in this example, [ChartFormat](#chartformat), specifies properties of this [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) and specifies the beginning of a collection of records as defined by the [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11). The collection of records specifies this chart group. In this example this record is the first ChartFormat record in the collection of ChartFormat records in the current chart sheet substream. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------|------------| +| 0014 | ChartFormat **- ChartFormat** | | +| 0004 | LONG **- Reserved1** | 0x00000000 | +| 0004 | LONG **- Reserved2** | 0x00000000 | +| 0004 | LONG **- Reserved3** | 0x00000000 | +| 0004 | LONG **- Reserved4** | 0x00000000 | +| 1 bit | WORD **- fVaried** | 0x0 | +| 15 bits | WORD **- Reserved5** | 0x0000 | +| 0002 | SHORT **- icrt** | 0x0000 | + +Figure 62: Structure of ChartFormat + +**fVaried:** 0x0000 specifies that the color of each data point does not vary. + +**icrt:** 0x0000 specifies that this chart group is at the bottom of the [**z-order**](#gt_5d059b23-337a-4ab8-82f5-e3789b2e7ae9). + +### Column Chart Object: Bar + +The next record in this example, [Bar](#bar), specifies the attributes of this [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|-----------| +| 0006 | Bar **- Bar** | | +| 0002 | SHORT **- pcOverlap** | 0x0000 | +| 0002 | USHORT **- pcGap** | 0x0096 | +| 1 bit | USHORT **- fTranspose** | 0x0 | +| 1 bit | USHORT **- fStacked** | 0x0 | +| 1 bit | USHORT **- f100** | 0x0 | +| 1 bit | USHORT **- fHasShadow** | 0x0 | +| 12 bits | USHORT **- reserved** | 0x000 | + +Figure 63: Structure of Bar + +**pcOverlap:** 0x0000 specifies that there is no overlap between data points. + +**pcGap:** 0x0096 specifies that the width of the gap between adjacent [**categories**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) is 150% of the data point width. It also specifies that the width of the gap between the categories and the left and right edges of the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) is 75% of the data point width. + +**fTranspose:** 0x0000 specifies that the data points and the value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) are vertical. + +**fStacked:** 0x0000 specifies that [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) in the same chart group are not stacked. + +**f100:** 0x0000 specifies that data points in the chart group are not displayed as a percentage of the sum of all data points in the chart group that share the same category. + +**fHasShadow:** 0x0000 specifies that none of the data points in the chart group has shadows. + +The remaining records following this record, are omitted for brevity. + +## Pie Chart Sheet + +This is an example of a 2D Pie [Chart Sheet](#Section_2c90d75bc92645aa8ff29d4483f51831). This example omits records previously covered in the [column chart object](#Section_f9e4245bb7b145a98f80c78edac371d4) example. + +
+ +

Figure 64: Pie Chart Sheet in this example within a sheet.

+
+ +### Pie Chart Sheet: PrintSize + +The first record in this example, [PrintSize](#printsize), specifies the printed size of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------|-----------| +| 0002 | PrintSize **- PrintSize** | | +| 0002 | WORD **- printSize** | 0x0003 | + +Figure 65: Structure of PrintSize + +**printSize:** 0x0003 specifies that the printed size of the chart is defined in the [Chart](#chart-2) record that follows this record. + +### Pie Chart Sheet: Chart + +The next record in this example, [Chart](#chart-2), specifies the beginning of the collection of records for the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), and specifies the position and size of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)). + +| **Size** | **Structure** | **Value** | +|----------|---------------------|------------| +| 0010 | Chart **- Chart** | | +| 0004 | FixedPoint **- x** | 0x00000000 | +| 0004 | FixedPoint **- y** | 0x00000000 | +| 0004 | FixedPoint **- dx** | 0x02AB0A30 | +| 0004 | FixedPoint **- dy** | 0x01D30A30 | + +Figure 66: Structure of Chart + +**x:** 0x00000000 specifies that the horizontal position of the upper-left corner of the chart is 0 [**points**](#gt_d072e4da-7898-4227-8f25-9fe77db43571). + +**y:** 0x00000000 specifies that the vertical position of the upper-left corner of the chart is 0 points. + +**dx:** 0x02AB0A30 specifies that the chart is 44763696 points wide. + +**dy:** 0x01D30A30 specifies that the chart is 30607920 points high. + +### Pie Chart Sheet: ShtProps + +The next record in this example, [ShtProps](#shtprops), specifies the [chart sheet](#Section_2c90d75bc92645aa8ff29d4483f51831) properties. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------------|-----------| +| 0004 | ShtProps **- ShtProps** | | +| 1 bit | USHORT **- fManSerAlloc** | 0x0 | +| 1 bit | USHORT **- fPlotVisOnly** | 0x1 | +| 1 bit | USHORT **- fNotSizeWith** | 0x1 | +| 1 bit | USHORT **- fManPlotArea** | 0x1 | +| 1 bit | USHORT **- fAlwaysAutoPlotArea** | 0x0 | +| 11 bits | USHORT **- reserved1** | 0x000 | +| 0001 | BYTE **- mdBlank** | 0x00 | +| 0001 | BYTE **- reserved2** | 0x00 | + +Figure 67: Structure of ShtProps + +**fManSerAlloc:** 0x0 specifies that the data [series](#Section_527ce4dfc9f84e50a314d4b07519593c) are not automatically allocated to the series of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +**fPlotVisOnly:** 0x1 specifies to plot [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) only. + +**fNotSizeWith:** 0x1 specifies not to size the chart with the window. + +**fManPlotArea:** This field is ignored because the **fAlwaysAutoPlotArea** value is 0x0. + +**fAlwaysAutoPlotArea:** 0x0 specifies that the default [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) size is used regardless of the [Pos](#pos) record information. + +**mdBlank:** 0x00 specifies that empty cells are not plotted. + +### Pie Chart Sheet: AxesUsed + +The next record in this example, [AxesUsed](#axesused), specifies the value [axes](#Section_4117f73aa0f348d89c0f65864918ffb3) used on the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|-----------| +| 0002 | AxesUsed **- AxesUsed** | | +| 0002 | USHORT **- cAxes** | 0x0001 | + +Figure 68: Structure of AxesUsed + +**cAxes:** 0x0001 specifies that a single primary value axis is present and used on the chart. + +### Pie Chart Sheet: AxisParent + +The next record in this example, [AxisParent](#axisparent), specifies properties of the one [axis group](#Section_578b739742624944b5a67ee6d4d3bb55) on the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) and specifies the beginning of the collection of records that specifies an axis group. + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------|-----------| +| 0012 | AxisParent **- AxisParent** | | +| 0002 | SHORT **- iax** | 0x0000 | +| 0010 | unused **- unused** | | + +Figure 69: Structure of AxisParent + +**iax:** 0x0000 specifies that this axis group is a primary axis group. + +### Pie Chart Sheet: ChartFormat + +The next record, [ChartFormat](#chartformat), specifies properties of a [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) and specifies the beginning of the collection of records that specifies further properties of that chart group. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------|------------| +| 0014 | ChartFormat **- ChartFormat** | | +| 0004 | LONG **- reserved1** | 0x00000000 | +| 0004 | LONG **- reserved2** | 0x00000000 | +| 0004 | LONG **- reserved3** | 0x00000000 | +| 0004 | LONG **- reserved4** | 0x00000000 | +| 1 bit | WORD **- fVaried** | 0x1 | +| 15 bits | WORD **- reserved5** | 0x0000 | +| 0002 | SHORT **- icrt** | 0x0000 | + +Figure 70: Structure of ChartFormat + +**fVaried:** 0x0001 specifies that the color for each [data point](#Section_9c986ad250d44fa1a157063ac5c971a0), or the color or type for each [**data marker**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) varies. + +**icrt:** 0x0000 specifies that the drawing order of the chart group relative to the other chart groups is the bottom of the [**z-order**](#gt_5d059b23-337a-4ab8-82f5-e3789b2e7ae9). + +### Pie Chart Sheet: Pie + +The next record in this example, [Pie](#pie), specifies that this is a pie [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), and specifies attributes of the chart group. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------|-----------| +| 0006 | Pie **- Pie** | | +| 0002 | USHORT **- anStart** | 0x0000 | +| 0002 | USHORT **- pcDonut** | 0x0000 | +| 1 bit | USHORT **- fHasShadow** | 0x0 | +| 1 bit | USHORT **- fShowLdrLines** | 0x1 | +| 14 bits | USHORT **- reserved** | 0x0000 | + +Figure 71: Structure of Pie + +**anStart:** 0x0000 specifies that the starting angle, calculated clockwise from the top of the circle, of the first [data point](#Section_9c986ad250d44fa1a157063ac5c971a0) is 0 degrees. + +**pcDonut:** 0x0000 specifies that the chart group is a pie chart group. + +**fHasShadow:** 0x0 specifies that zero data points in the chart group have shadows. + +**fShowLdrLines:** 0x1 specifies that the [**leader lines**](#gt_8b7c448e-82e3-4d22-a8ba-52e0a10b14fa) to the [data labels](#Section_cac7f43a3af142f58ff2814c2870427f) are shown. This value is ignored because zero data labels are present in this example. + +### Pie Chart Sheet: Legend + +The next record in this example, [Legend](#legend-1), specifies the location of the [legend](#Section_1832229b7d1945f488d455e9c07466f0) on the display and its overall size. The displayed legend contains all the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) on the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). The position and size information specified in this record is ignored, and the position and size information specified in the following [Pos](#pos) record is used. + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|------------| +| 0014 | Legend **- Legend** | | +| 0004 | ULONG **- x** | 0x00000E47 | +| 0004 | ULONG **- y** | 0x00000703 | +| 0004 | ULONG **- dx** | 0x00000147 | +| 0004 | ULONG **- dy** | 0x00000199 | +| 0001 | BYTE **- unused** | 0x03 | +| 0001 | BYTE **- wSpace** | 0x01 | +| 1 bit | WORD **- fAutoPosition** | 0x1 | +| 1 bit | WORD **- reserved1** | 0x1 | +| 1 bit | WORD **- fAutoPosX** | 0x1 | +| 1 bit | WORD **- fAutoPosY** | 0x1 | +| 1 bit | WORD **- fVert** | 0x1 | +| 1 bit | WORD **- fWasDataTable** | 0x0 | +| 10 bits | WORD **- reserved2** | 0x000 | + +Figure 72: Structure of Legend + +**wSpace:** 0x01 specifies that there are 40 [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382) between [**legend entries**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e). + +**fAutoPosition:** 0x1 specifies that the legend is automatically positioned. + +**fAutoPosX:** 0x1 specifies that the x-positioning of the legend is automatic. + +**fAutoPosY:** 0x1 specifies that the y-positioning of the legend is automatic. + +**fVert:** 0x1 specifies that the layout of the legend entries contain a single column of entries. + +**fWasDataTable:** 0x0 specifies that the chart is not displaying the chart [data table](#Section_69938f61d2e94da3af87e154edcb0d98). + +The next record in this example, [Begin](#begin), specifies the beginning of the collection of records that specifies the properties of the legend. + +The details of the Begin record have been omitted from the example for brevity. + +### Pie Chart Sheet: Pos + +The next record in this example, [Pos](#pos), specifies the size and position for the [Legend](#legend-1) of the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------------|-----------| +| 0014 | Pos **- Pos** | | +| 0002 | [PositionMode](#positionmode) **- mdTopLt** | 0x0005 | +| 0002 | PositionMode **- mdBotRt** | 0x0002 | +| 0002 | SHORT **- x1** | 0x0E47 | +| 0002 | SHORT **- unused1** | 0x0000 | +| 0002 | SHORT **- y1** | 0x0703 | +| 0002 | SHORT **- unused2** | 0x0000 | +| 0002 | SHORT **- x2** | 0x0000 | +| 0002 | SHORT **- unused3** | 0x0000 | +| 0002 | SHORT **- y2** | 0x0000 | +| 0002 | SHORT **- unused4** | 0x0000 | + +Figure 73: Structure of Pos + +Fields in this record that are ignored because **mdTopLt** is 0x0005 and **mdBotRt** is 0x0002 are omitted for brevity. + +**mdTopLt:** 0x0005 specifies that the horizontal offset of the upper-left corner for this Legend is relative to the upper-left corner of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)), measured in [SPRC](#Section_d5fc728e68de4972905a975bcef8c82d). + +**mdBotRt:** 0x0002, when combined with the **mdTopLt** value of 0x0005, specifies that the values of **x1** and **y1** specify the horizontal and vertical offsets of the upper-left corner of the Legend, relative to the upper-left corner of the chart area (section 2.2.3.17). + +**x1:** 0x0E47 specifies that the upper-left corner of the Legend is horizontally offset by 3655 SPRC from the upper-left corner of the chart area (section 2.2.3.17). + +**y1:** 0x0703 specifies that the upper-left corner of the Legend is vertically offset by 1795 SPRC from the upper-left corner of the chart area (section 2.2.3.17). + +### Pie Chart Sheet: Text + +The next record in this example, [Text](#text), specifies the position and appearance of text fields that appear on the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). The position and size information specified in this record are ignored because this record is followed by a [Pos](#pos) record. + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------|------------| +| 0020 | Text **- Text** | | +| 0001 | BYTE **- at** | 0x02 | +| 0001 | BYTE **- vat** | 0x02 | +| 0002 | WORD **- wBkgMode** | 0x0001 | +| 0004 | [LongRGB](#longrgb) **- rgbText** | | +| 0001 | BYTE **- red** | 0x00 | +| 0001 | BYTE **- green** | 0x00 | +| 0001 | BYTE **- blue** | 0x00 | +| 0001 | BYTE **- reserved** | 0x00 | +| 0004 | LONG **- x** | 0xFFFFFFEA | +| 0004 | LONG **- y** | 0xFFFFFF75 | +| 0004 | LONG **- dx** | 0x00000000 | +| 0004 | LONG **- dy** | 0x00000000 | +| 1 bit | USHORT **- fAutoColor** | 0x1 | +| 1 bit | USHORT **- fShowKey** | 0x0 | +| 1 bit | USHORT **- fShowValue** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fAutoText** | 0x1 | +| 1 bit | USHORT **- fGenerated** | 0x1 | +| 1 bit | USHORT **- fDeleted** | 0x0 | +| 1 bit | USHORT **- fAutoMode** | 0x1 | +| 3 bits | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fShowLabelAndPerc** | 0x0 | +| 1 bit | USHORT **- fShowPercent** | 0x0 | +| 1 bit | USHORT **- fShowBubbleSizes** | 0x0 | +| 1 bit | USHORT **- fShowLabel** | 0x0 | +| 1 bit | USHORT **- reserved** | 0x0 | +| 0002 | [Icv](#icv) **- icvText** | | +| 0002 | USHORT **- icv** | 0x004D | +| 4 bits | USHORT **- dlp** | 0x0 | +| 10 bits | USHORT **- unused3** | 0x069 | +| 2 bits | USHORT **- iReadingOrder** | 0x0 | +| 0002 | USHORT **- trot** | 0x0000 | + +Figure 74: Structure of Text + +**at:** 0x02 specifies that the horizontal alignment of the text fields that appear in the [Legend](#legend-1) record is center-aligned. + +**vat:** 0x02 specifies that the vertical alignment of the text fields that appear in the Legend record is center-aligned. + +**wBkgMode:** 0x0001 specifies that the background of the text is transparent. + +**rgbText:** A LongRGB structure that specifies the color of the text. + +**rgbText.red:** 0x00 specifies that the relative intensity of red is 0. + +**rgbText.green:** 0x00 specifies that the relative intensity of green is 0. + +**rgbText.blue:** 0x00 specifies that the relative intensity of blue is 0. + +**fAutoColor:** 0x0001 specifies that the foreground text color is determined automatically. + +**fShowKey:** This field is ignored because this [AttachedLabel](#Section_9ac44e58af9940f4a99ace470eff0f5a) is not a [data label](#Section_cac7f43a3af142f58ff2814c2870427f). + +**fShowValue:** This field is ignored because this AttachedLabel is not a data label. + +**fAutoText:** 0x0001 specifies that the text value of the text field is automatically generated and has not been changed. + +**fGenerated:** 0x0001 specifies that the properties of the text field are automatically generated and have not been changed. + +**fDeleted:** 0x0000 specifies that this text field, which is displayed by default, has been deleted by the user. + +**fAutoMode:** 0x0001 specifies that the background color is determined automatically. + +**fShowLabelAndPerc:** This field is ignored because this AttachedLabel is not a data label. + +**fShowPercent:** This field is ignored because this AttachedLabel is not a data label. + +**fShowBubbleSizes:** This field is ignored because this AttachedLabel is not a data label. + +**fShowLabel:** This field is ignored because this AttachedLabel is not a data label. + +**icvText:** An Icv structure that specifies the color of the text. + +**icvText.icv:** 0x004D specifies that the default chart foreground color is used. + +**dlp:** This field is ignored because this AttachedLabel is not a data label. + +**iReadingOrder:** 0x0000 specifies that the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361) of the text is determined by the application. + +**trot:** This field is ignored because this AttachedLabel is not a data label. + +The next record in this example, [Begin](#begin), specifies the beginning of the collection of records that specifies data labels on a [**graph object**](#gt_f4c97882-38e3-4b03-9f11-09ee6566da21). + +The details of the Begin record have been omitted from the example for brevity. + +### Pie Chart Sheet: BRAI + +The next record in this example, [BRAI](#brai), specifies a reference to data in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that is used by a [**legend entry**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------------------------|-----------| +| 0008 | BRAI **- BRAI** | | +| 0001 | BYTE **- id** | 0x00 | +| 0001 | BYTE **- rt** | 0x01 | +| 1 bit | USHORT **- fUnlinkedIfmt** | 0x0 | +| 15 bits | USHORT **- reserved** | 0x0000 | +| 0002 | IFmt **- ifmt** | 0x0000 | +| 0002 | [ChartParsedFormula](#chartparsedformula) **- formula** | | +| 0002 | WORD **- cce** | 0x0000 | + +Figure 75: Structure of BRAI + +**id:** 0x00 specifies that the referenced data is used for the text of a legend entry. + +**rt:** 0x01 specifies that the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is text or the value contained by the **rgce** field. + +**fUnlinkedIfmt:** 0x0 specifies that the data uses the same number formatting as the referenced data. + +**ifmt:** 0x0000 specifies that the identifier for [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) information is general (automatic). + +**formula:** A ChartParsedFormula that specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that specifies the referenced data. + +**formula.cce:** 0x0000 specifies that the length of **rgce** is 0 bytes. + +The next two records in this example are both [End](#end) records. The first End record specifies the end of the collection of records that specifies [data labels](#Section_cac7f43a3af142f58ff2814c2870427f) on a [**graph object**](#gt_f4c97882-38e3-4b03-9f11-09ee6566da21). The second End record specifies the end of the collection of records that specifies the [legend](#Section_1832229b7d1945f488d455e9c07466f0). + +The details of the End records have been omitted from the example for brevity. + +### Pie Chart Sheet: Window2 + +The next record in this example, [Window2](#window2), specifies attributes of the window used to display a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------|-----------| +| 000A | WINDOW2 **- Window2** | | +| 1 bit | USHORT **- fDspFmlaRt** | 0x0 | +| 1 bit | USHORT **- fDspGridRt** | 0x1 | +| 1 bit | USHORT **- fDspRwColRt** | 0x0 | +| 1 bit | USHORT **- fFrozenRt** | 0x0 | +| 1 bit | USHORT **- fDspZerosRt** | 0x0 | +| 1 bit | USHORT **- fDefaultHdr** | 0x0 | +| 1 bit | USHORT **- fRightToLeft** | 0x0 | +| 1 bit | USHORT **- fDspGuts** | 0x0 | +| 1 bit | USHORT **- fFrozenNoSplit** | 0x0 | +| 1 bit | USHORT **- fSelected** | 0x1 | +| 1 bit | USHORT **- fPaged** | 0x1 | +| 1 bit | USHORT **- fSLV** | 0x0 | +| 4 bits | USHORT **- reserved1** | 0x0 | +| 0002 | [RwU](#rwu) **- rwTop** | 0x0000 | +| 0002 | [ColU](#colu) **- colLeft** | 0x0000 | +| 0002 | [Icv](#icv) **- icvHdr** | 0x0000 | +| 0002 | USHORT **- reserved2** | 0x0000 | + +Figure 76: Structure of Window2 + +Fields in this record that are ignored because this Window2 record is contained in a [chart sheet](#Section_2c90d75bc92645aa8ff29d4483f51831) substream are omitted for brevity. + +**fSelected:** 0x1 specifies that the sheet tab of the chart sheet is selected. + +## Formatting + +In this example, [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) formatting and [**number formats**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) are applied to three cells in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d): + +Cell B3, containing 1.2345, is formatted with the built-in "0.00" number format. + +Cell B4, containing 1.2345, is formatted with the custom number format "0.00000". + +Cell B5, containing "1.2345", is formatted with a blue [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a), yellow [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c), and is bold. + +The following screenshot shows a possible implementation of the cells discussed in this example: + +
+ +

Figure 77: The formatting in this example within a sheet

+
+ +This example starts at the first [Font](#font) record in the [Workbook stream](#Section_f682f4b08c6b444e83f852d156f1e8ba) related to these cells and ends at the [Number](#number) record containing the value for the last cell. Other records in the Workbook stream or related substreams which are not related to this example are omitted for brevity. The substream of the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) related to this example contains five Font records, nine [Format](#format) records, 24 [XF](#xf) records, and three Number records. Of these, the example highlights the first and fifth Font record, the last Format record, the first, sixteenth, seventeenth, and eighteenth XF records, and all three Number records. Any other records in the substream are skipped in this example. + +Each Number record that specifies a cell with a [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d) corresponds to one of the three cells in this example. The Number record contains a [Cell](#cell) structure, which in turn contains an [IXFCell](#ixfcell) structure with an **ixfe** field containing the index to an XF record in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The XF record that specifies formatting properties for a cell contains a [FontIndex](#fontindex) structure and an [IFmt](#ifmt) structure. Those records contain indexes for a Font record and a Format record, respectively. The Font record specifies [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) and font formatting information, and the Format record specifies a number format. + +### Formatting: Font 1 + +The first record in the example, [Font](#font), specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) and font formatting information which is used by [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) B3 and B4. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001A | Font **- Font** | | +| 0002 | USHORT **- dyHeight** | 0x00C8 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fItalic** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fStrikeOut** | 0x0 | +| 1 bit | USHORT **- fOutline** | 0x0 | +| 1 bit | USHORT **- fShadow** | 0x0 | +| 1 bit | USHORT **- fCondense** | 0x0 | +| 1 bit | USHORT **- fExtend** | 0x0 | +| 8 bits | USHORT **- reserved** | 0x00 | +| 0002 | USHORT **- icv** | 0x7FFF | +| 0002 | USHORT **- bls** | 0x0190 | +| 0002 | USHORT **- sss** | 0x0000 | +| 0001 | BYTE **- uls** | 0x00 | +| 0001 | BYTE **- bFamily** | 0x00 | +| 0001 | BYTE **- bCharSet** | 0x00 | +| 0001 | BYTE **- unused3** | 0xDF | +| 000C | [ShortXLUnicodeString](#shortxlunicodestring) **- fontName** | Arial | + +Figure 78: Structure of Font + +**dyHeight:** 0x00C8 specifies the height of the font is 200 [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382). + +**fItalic:** 0x0 specifies that the font is not italicized. + +**fStrikeOut:** 0x0 specifies that the font does not have [**strikethrough formatting**](#gt_b16d9600-aebb-4a4f-bf14-c38e13c11c14) applied. + +**fOutline:** 0x0 specifies that the font is not an outline. + +**fShadow:** 0x0 specifies that the font does not have a shadow applied. + +**fCondense:** 0x0 specifies that the font is not condensed by compressing spacing between characters. + +**fExtend:** 0x0 specifies that the font is not extended by stretching spacing between characters. + +**icv:** 0x7FFF is an [Icv](#icv) value that specifies that the color of the font is the default [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a). + +**bls:** 0x0190 specifies that the font is normal weight. + +**sss:** 0x0000 specifies that the font is normal script. + +**uls:** 0x00 specifies that the font has no underline. + +**bFamily:** 0x00 specifies that the [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2) of the font is not applicable as detailed in the Windows API LOGFONT structure in [\[MSDN-FONTS\]](https://go.microsoft.com/fwlink/?LinkId=90008). + +**bCharSet:** 0x00 specifies that that this font belongs to the [**ANSI character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583). + +**fontName:** Arial specifies the name of the font. + +Records following this record, and before the fifth Font record, are omitted for brevity. + +### Formatting: Font 2 + +The next record in this example, [Font](#font), specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) and font formatting information which is used by [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) B5. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001A | Font **- Font** | | +| 0002 | USHORT **- dyHeight** | 0x00C8 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fItalic** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fStrikeOut** | 0x0 | +| 1 bit | USHORT **- fOutline** | 0x0 | +| 1 bit | USHORT **- fShadow** | 0x0 | +| 1 bit | USHORT **- fCondense** | 0x0 | +| 1 bit | USHORT **- fExtend** | 0x0 | +| 8 bits | USHORT **- reserved** | 0x00 | +| 0002 | USHORT **- icv** | 0x000C | +| 0002 | USHORT **- bls** | 0x02BC | +| 0002 | USHORT **- sss** | 0x0000 | +| 0001 | BYTE **- uls** | 0x00 | +| 0001 | BYTE **- bFamily** | 0x00 | +| 0001 | BYTE **- bCharSet** | 0x00 | +| 0001 | BYTE **- unused3** | 0xDF | +| 000C | [ShortXLUnicodeString](#shortxlunicodestring) **- fontName** | Arial | + +Figure 79: Structure of Font + +Fields in this record that are explained in previous records in this example have been omitted for brevity. + +**icv:** 0x000C is an [Icv](#icv) value that specifies that the color of the font is composed of an RGB value with a red value of 0, a green value of 0, and a blue value of 255, representing the color blue. + +**bls:** 0x02BC specifies that the font is bold. + +Records following this record, and before the ninth [Format](#format) record, are omitted for brevity. + +### Formatting: Format + +The next record in this example, [Format](#format), specifies the number format which is used by [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) B4. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------------------------------|-----------| +| 000C | Format **- Format** | | +| 0002 | [IFmt](#ifmt) **- ifmt** | 0x00A4 | +| 000A | [XLUnicodeString](#xlunicodestring) **- stFormat** | 0.00000 | + +Figure 80: Structure of Format + +**ifmt:** 0x00A4 specifies the identifier of the format string. + +**stFormat:** "0.00000" specifies the custom [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) string to be applied. + +### Formatting: XF 1 + +The next record in this example, [XF](#xf), specifies default formatting properties for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and is written out. It is not referenced in this example. + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------------------------|-----------| +| 0014 | XF **- XF** | | +| 0002 | FontIndex **- ifnt** | | +| 0002 | USHORT **- ifnt** | 0x0000 | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x0000 | +| 1 bit | USHORT **- fLocked** | 0x1 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fStyle** | 0x1 | +| 1 bit | USHORT **- f123Prefix** | 0x0 | +| 12 bits | USHORT **- ixfParent** | 0xFFF | +| 000E | [StyleXF](#stylexf) **- Data** | | +| 3 bits | BYTE **- alc** | 0x0 | +| 1 bit | BYTE **- fWrap** | 0x0 | +| 3 bits | BYTE **- alcV** | 0x2 | +| 1 bit | BYTE **- fJustLast** | 0x0 | +| 0001 | [XFPropTextRotation](#xfproptextrotation) **- trot** | | +| 0001 | BYTE **- trot** | 0x00 | +| 4 bits | BYTE **- cIndent** | 0x0 | +| 1 bit | BYTE **- fShrinkToFit** | 0x0 | +| 1 bit | BYTE **- reserved1** | 0x0 | +| 2 bits | BYTE **- iReadOrder** | 0x0 | +| 0001 | BYTE **- unused** | 0x00 | +| 4 bits | USHORT **- dgLeft** | 0x0 | +| 4 bits | USHORT **- dgRight** | 0x0 | +| 4 bits | USHORT **- dgTop** | 0x0 | +| 4 bits | USHORT **- dgBottom** | 0x0 | +| 7 bits | USHORT **- icvLeft** | 0x00 | +| 7 bits | USHORT **- icvRight** | 0x00 | +| 2 bits | USHORT **- grbitDiag** | 0x0 | +| 7 bits | ULONG **- icvTop** | 0x00 | +| 7 bits | ULONG **- icvBottom** | 0x00 | +| 7 bits | ULONG **- icvDiag** | 0x00 | +| 4 bits | ULONG **- dgDiag** | 0x0 | +| 1 bit | ULONG **- reserved2** | 0x0 | +| 6 bits | ULONG **- fls** | 0x00 | +| 7 bits | USHORT **- icvFore** | 0x40 | +| 7 bits | USHORT **- icvBack** | 0x41 | +| 2 bits | USHORT **- reserved3** | 0x0 | + +Figure 81: Structure of XF + +**ifnt:** Specifies formatting properties for the cell. + +**ifnt.ifnt:** 0x0000 specifies the [FontIndex](#fontindex) that specifies the cell uses the default [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). + +**ifmt:** Specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) and text formatting for the cell. + +**ifmt.ifmt:** 0x0000 specifies an IFmt that specifies general (automatic) formatting for the cell. + +**fLocked:** 0x1 specifies that the cell is set to be [**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81) for user editing when the worksheet is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829). + +**fHidden:** 0x0 specifies that the cell formula is not [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) when the worksheet is protected. + +**fStyle:** 0x1 specifies that this record specifies a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7). + +**f123Prefix:** 0x0 specifies that the text in the cell is not prefixed by a single quote mark. + +**ixfParent:** 0xFFF is the required value as **fStyle** is 0x1. + +**Data:** Specifies additional properties of this cell style. + +**Data.alc:** 0x0 specifies that the horizontal alignment of the cell is [**general alignment**](#gt_3ee6d1d4-830b-4dc2-b8be-751665f8045f). + +**Data.fWrap:** 0x0 specifies that the cell text is not line-wrapped within the cell. + +**Data.alcV:** 0x2 specifies that the cell has a bottom [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878). + +**Data.fJustLast:** 0x0 specifies that the cell text is not [**justify distributed**](#gt_11eced66-af2c-4391-8b45-87a60ad41483). + +**Data.trot:** Specifies the text rotation. + +**Data.trot.trot:** 0x00 specifies that the cell text is rotated counterclockwise 0 degrees. + +**Data.cIndent:** 0x0 specifies that the cell text is not indented. + +**Data.fShrinkToFit:** 0x0 specifies that the cell is not [**shrink to fit**](#gt_4740d2ef-00d3-4a29-983c-b7b3a6aa01e0). + +**Data.iReadOrder:** 0x0 specifies that the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361) of the cell is context reading order. + +**Data.dgLeft:** 0x0 specifies that the [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad) of the cell is no [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c). + +**Data.dgRight:** 0x0 specifies that the [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) border formatting of the cell is no border. + +**Data.dgTop:** 0x0 specifies that the top border formatting of the cell is no border. + +**Data.dgBottom:** 0x0 specifies that the bottom border formatting of the cell is no border. + +**Data.icvLeft:** 0x00 specifies that the color of the logical left border is not specified. + +**Data.icvRight:** 0x00 specifies that the color of the logical right border is not specified. + +**Data.grbitDiag:** 0x0 specifies that the cell does not have a diagonal border. + +**Data.icvTop:** 0x00 specifies that the color of the top border is not specified. + +**Data.icvBottom:** 0x00 specifies that the color of the bottom border is not specified. + +**Data.icvDiag:** 0x00 specifies that the color of the diagonal border is not specified. + +**Data.dgDiag:** 0x0 specifies that the diagonal border formatting of the cell is no border. + +**Data.fls:** 0x00 specifies that there is no [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e) for the cell. + +**Data.icvFore:** 0x40 specifies that the [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) of the fill pattern is the default foreground color. + +**Data.icvBack:** 0x41 specifies that the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) of the fill pattern is the default background color. + +Records following this record, and before the sixteenth XF record, are omitted for brevity. + +### Formatting: XF 2 + +The next record in this example, [XF](#xf), specifies formatting properties for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and is referenced by the [Number](#number) record for cell B3. + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------------------------|-----------| +| 0014 | XF **- XF** | | +| 0002 | FontIndex **- ifnt** | | +| 0002 | USHORT **- ifnt** | 0x0000 | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x0002 | +| 1 bit | USHORT **- fLocked** | 0x1 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fStyle** | 0x0 | +| 1 bit | USHORT **- f123Prefix** | 0x0 | +| 12 bits | USHORT **- ixfParent** | 0x000 | +| 000E | [CellXF](#cellxf) **- Data** | | +| 3 bits | BYTE **- alc** | 0x0 | +| 1 bit | BYTE **- fWrap** | 0x0 | +| 3 bits | BYTE **- alcV** | 0x2 | +| 1 bit | BYTE **- fJustLast** | 0x0 | +| 0001 | [XFPropTextRotation](#xfproptextrotation) **- trot** | | +| 0001 | BYTE **- trot** | 0x00 | +| 4 bits | BYTE **- cIndent** | 0x0 | +| 1 bit | BYTE **- fShrinkToFit** | 0x0 | +| 1 bit | BYTE **- reserved1** | 0x0 | +| 2 bits | BYTE **- iReadOrder** | 0x0 | +| 2 bits | BYTE **- reserved2** | 0x0 | +| 1 bit | BYTE **- fAtrNum** | 0x1 | +| 1 bit | BYTE **- fAtrFnt** | 0x0 | +| 1 bit | BYTE **- fAtrAlc** | 0x0 | +| 1 bit | BYTE **- fAtrBdr** | 0x0 | +| 1 bit | BYTE **- fAtrPat** | 0x0 | +| 1 bit | BYTE **- fAtrProt** | 0x0 | +| 4 bits | USHORT **- dgLeft** | 0x0 | +| 4 bits | USHORT **- dgRight** | 0x0 | +| 4 bits | USHORT **- dgTop** | 0x0 | +| 4 bits | USHORT **- dgBottom** | 0x0 | +| 7 bits | USHORT **- icvLeft** | 0x00 | +| 7 bits | USHORT **- ivcRight** | 0x00 | +| 2 bits | USHORT **- grbitDiag** | 0x0 | +| 7 bits | ULONG **- icvTop** | 0x00 | +| 7 bits | ULONG **- icvBottom** | 0x00 | +| 7 bits | ULONG **- icvDiag** | 0x00 | +| 4 bits | ULONG **- dgDiag** | 0x0 | +| 1 bit | ULONG **- fHasXFExt** | 0x0 | +| 6 bits | ULONG **- fls** | 0x00 | +| 7 bits | USHORT **- icvFore** | 0x40 | +| 7 bits | USHORT **- icvBack** | 0x41 | +| 1 bit | USHORT **- fsxButton** | 0x0 | +| 1 bit | USHORT **- reserved3** | 0x0 | + +Figure 82: Structure of XF + +Fields in this record that are explained in previous records in this example have been omitted for brevity. + +**ifmt:** Specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) and text formatting for the cell. + +**ifmt.ifmt:** 0x0002 specifies an IFmt value that specifies a number format with two decimals and no 1000s comma. + +**fStyle:** 0x0 specifies that the cell uses a cell format. + +**ixfParent:** 0x000 specifies that the cell inherits formatting properties from the first [cell style XF](#Section_3d5348ded9df4c31b1fd9f9377273152) record in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +**Data:** Specifies additional properties of the cell format. + +**Data.fAtrNum:** 0x1 specifies that the **ifmt** field of this XF record is not updated when the corresponding field of the XF record specified by the **ixfParent** field of this XF record is changed. + +**Data.fAtrFnt:** 0x0 specifies that the **ifnt** field of this XF record is updated when the corresponding field of the XF record specified by the **ixfParent** field of this XF record is changed. + +**Data.fAtrAlc:** 0x0 specifies that the **alc**, **fWrap**, **alcV**, **fJustLast**, **trot**, **cIndent**, **fShrinkToFit**, and **iReadOrder** fields are updated when the corresponding fields of the XF record specified by the **ixfParent** field of this XF record are changed. + +**Data.fAtrBdr:** 0x0 specifies that the **dgLeft**, **dgRight**, **dgTop**, **dgBottom**, **dgDiag**, **icvLeft**, **icvRight**, **grbitDiag**, **icvTop**, **icvBottom**, and **icvDiag** fields are updated when the corresponding fields of the XF record specified by the **ixfParent** field of this XF record are changed. + +**Data.fAtrPat:** 0x0 specifies that the **fls**, **icvFore**, and **icvBack** fields are updated when the corresponding fields of the XF record specified by the **ixfParent** field of this XF record are changed. + +**Data.fAtrProt:** 0x0 specifies that the **fLocked** and **fHidden** fields are updated when the corresponding fields of the XF record specified by the **ixfParent** field of this XF record are changed. + +**Data.fHasXFExt:** 0x0 specifies that the information in this XF will not be extended by an [XFExt](#xfext) record. + +**Data.fsxButton:** 0x0 specifies that the XF record is not attached to a pivot field drop-down button. + +### Formatting: XF 3 + +The next record in this example, [XF](#xf), specifies formatting properties for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) or a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7) and is referenced by the [Number](#number) record for cell B4. + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------------------------|-----------| +| 0014 | XF **- XF** | | +| 0002 | FontIndex **- ifnt** | | +| 0002 | USHORT **- ifnt** | 0x0000 | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x00A4 | +| 1 bit | USHORT **- fLocked** | 0x1 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fStyle** | 0x0 | +| 1 bit | USHORT **- f123Prefix** | 0x0 | +| 12 bits | USHORT **- ixfParent** | 0x000 | +| 000E | [CellXF](#cellxf) **- Data** | | +| 3 bits | BYTE **- alc** | 0x0 | +| 1 bit | BYTE **- fWrap** | 0x0 | +| 3 bits | BYTE **- alcV** | 0x2 | +| 1 bit | BYTE **- fJustLast** | 0x0 | +| 0001 | [XFPropTextRotation](#xfproptextrotation) **- trot** | | +| 0001 | BYTE **- trot** | 0x00 | +| 4 bits | BYTE **- cIndent** | 0x0 | +| 1 bit | BYTE **- fShrinkToFit** | 0x0 | +| 1 bit | BYTE **- reserved1** | 0x0 | +| 2 bits | BYTE **- iReadOrder** | 0x0 | +| 2 bits | BYTE **- reserved2** | 0x0 | +| 1 bit | BYTE **- fAtrNum** | 0x1 | +| 1 bit | BYTE **- fAtrFnt** | 0x0 | +| 1 bit | BYTE **- fAtrAlc** | 0x0 | +| 1 bit | BYTE **- fAtrBdr** | 0x0 | +| 1 bit | BYTE **- fAtrPat** | 0x0 | +| 1 bit | BYTE **- fAtrProt** | 0x0 | +| 4 bits | USHORT **- dgLeft** | 0x0 | +| 4 bits | USHORT **- dgRight** | 0x0 | +| 4 bits | USHORT **- dgTop** | 0x0 | +| 4 bits | USHORT **- dgBottom** | 0x0 | +| 7 bits | USHORT **- icvLeft** | 0x00 | +| 7 bits | USHORT **- ivcRight** | 0x00 | +| 2 bits | USHORT **- grbitDiag** | 0x0 | +| 7 bits | ULONG **- icvTop** | 0x00 | +| 7 bits | ULONG **- icvBottom** | 0x00 | +| 7 bits | ULONG **- icvDiag** | 0x00 | +| 4 bits | ULONG **- dgDiag** | 0x0 | +| 1 bit | ULONG **- fHasXFExt** | 0x0 | +| 6 bits | ULONG **- fls** | 0x00 | +| 7 bits | USHORT **- icvFore** | 0x40 | +| 7 bits | USHORT **- icvBack** | 0x41 | +| 1 bit | USHORT **- fsxButton** | 0x0 | +| 1 bit | USHORT **- reserved3** | 0x0 | + +Figure 83: Structure of XF + +Fields in this record that are explained in previous records in this example have been omitted for brevity. + +**ifmt:** Specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) and text formatting for the cell. + +**ifmt.ifmt:** 0x00A4 specifies the first user-defined [Format](#format) record illustrated previously. The formatting string specified by the referenced Format record is "0.00000". + +### Formatting: XF 4 + +The next record in this example, [XF](#xf), specifies formatting properties for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) or a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7) and is referenced by the [Number](#number) record for cell B5. + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------------------------|-----------| +| 0014 | XF **- XF** | | +| 0002 | FontIndex **- ifnt** | | +| 0002 | USHORT **- ifnt** | 0x0005 | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x0000 | +| 1 bit | USHORT **- fLocked** | 0x1 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fStyle** | 0x0 | +| 1 bit | USHORT **- f123Prefix** | 0x0 | +| 12 bits | USHORT **- ixfParent** | 0x000 | +| 000E | [CellXF](#cellxf) **- Data** | | +| 3 bits | BYTE **- alc** | 0x0 | +| 1 bit | BYTE **- fWrap** | 0x0 | +| 3 bits | BYTE **- alcV** | 0x2 | +| 1 bit | BYTE **- fJustLast** | 0x0 | +| 0001 | [XFPropTextRotation](#xfproptextrotation) **- trot** | | +| 0001 | BYTE **- trot** | 0x00 | +| 4 bits | BYTE **- cIndent** | 0x0 | +| 1 bit | BYTE **- fShrinkToFit** | 0x0 | +| 1 bit | BYTE **- reserved1** | 0x0 | +| 2 bits | BYTE **- iReadOrder** | 0x0 | +| 2 bits | BYTE **- reserved2** | 0x0 | +| 1 bit | BYTE **- fAtrNum** | 0x0 | +| 1 bit | BYTE **- fAtrFnt** | 0x1 | +| 1 bit | BYTE **- fAtrAlc** | 0x0 | +| 1 bit | BYTE **- fAtrBdr** | 0x0 | +| 1 bit | BYTE **- fAtrPat** | 0x1 | +| 1 bit | BYTE **- fAtrProt** | 0x0 | +| 4 bits | USHORT **- dgLeft** | 0x0 | +| 4 bits | USHORT **- dgRight** | 0x0 | +| 4 bits | USHORT **- dgTop** | 0x0 | +| 4 bits | USHORT **- dgBottom** | 0x0 | +| 7 bits | USHORT **- icvLeft** | 0x00 | +| 7 bits | USHORT **- ivcRight** | 0x00 | +| 2 bits | USHORT **- grbitDiag** | 0x0 | +| 7 bits | ULONG **- icvTop** | 0x00 | +| 7 bits | ULONG **- icvBottom** | 0x00 | +| 7 bits | ULONG **- icvDiag** | 0x00 | +| 4 bits | ULONG **- dgDiag** | 0x0 | +| 1 bit | ULONG **- fHasXFExt** | 0x0 | +| 6 bits | ULONG **- fls** | 0x01 | +| 7 bits | USHORT **- icvFore** | 0x0D | +| 7 bits | USHORT **- icvBack** | 0x40 | +| 1 bit | USHORT **- fsxButton** | 0x0 | +| 1 bit | USHORT **- reserved3** | 0x0 | + +Figure 84: Structure of XF + +Fields in this record that are explained in previous records in this example have been omitted for brevity. + +**ifnt:** Specifies formatting properties for the cell. + +**ifnt.ifnt:** 0x0005 specifies a [FontIndex](#fontindex) which specifies the first [Font](#font) record in the collection of Font records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). This Font record is illustrated previously. + +**Data:** Specifies additional properties of the cell format. + +**Data.fAtrNum:** 0x0 specifies that the **ifmt** field of this XF record is updated when the corresponding field of the XF record specified by the **ixfParent** field of this XF record is changed. + +**Data.fAtrFnt:** 0x1 specifies that the **ifnt** field of this XF record is not updated when the corresponding field of the XF record specified by the **ixfParent** field of the containing XF record is changed. + +**Data.fAtrPat:** 0x1 specifies that the **fls**, **icvFore**, and **icvBack** fields are not updated when the corresponding fields of the XF record specified by the **ixfParent** field of this XF record are changed. + +**Data.fls:** 0x01 specifies a solid [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e). Only **icvFore** is rendered. + +**Data.icvFore:** 0x0D specifies that the [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) of the fill pattern is field **rgColor**\[5\] of the [Palette](#palette) record in the file. If no Palette record exists, the default value is an RGB value with a red value of 255, a green value of 255, and a blue value of 0, representing the color yellow. + +**Data.icvBack:** 0x40 specifies that the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) of the fill pattern is the default foreground color. + +Records following this record, and before the next Number record, are omitted for brevity. + +### Formatting: Number 1 + +The next record in this example, [Number](#number), specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) B3, which contains a [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d). This record is the first in the set of Number records in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|------------------| +| 000E | Number **- Number** | | +| 0006 | [Cell](#cell) **- cell** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0002 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x0015 | +| 0008 | Double **- num** | 3FF3C083126E978D | + +Figure 85: Structure of Number + +**cell:** Specifies a cell in the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing a floating-point number. + +**cell.rw:** Specifies the row index of the cell. + +**cell.rw.rw:** 0x0002 specifies that the cell is in row 3. + +**cell.col:** Specifies the column index of the cell. + +**cell.col.col:** 0x0001 specifies that the cell is in column B. + +**cell.ixfe:** Specifies the [cell XF](#Section_518a740d71c640c8bb97e7df6915861a) record in the collection of [XF](#xf) records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +**cell.ixfe.ixfe:** 0x0015 specifies that the cell is formatted according to the first user-defined XF record in the Globals Substream. This XF is the second XF record in this example. + +**num:** 0x3FF3C083126E978D specifies a 64-bit IEEE-754 floating-point value of 1.2345 as the value of the cell. + +### Formatting: Number 2 + +The next record in this example, [Number](#number), specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) B4, which contains a [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|------------------| +| 000E | Number **- Number** | | +| 0006 | [Cell](#cell) **- cell** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0003 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x0016 | +| 0008 | Double **- num** | 3FF3C083126E978D | + +Figure 86: Structure of Number + +Fields in this record that are explained in previous records in this example have been omitted for brevity. + +**cell:** Specifies a cell in the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing a floating-point number. + +**cell.rw:** Specifies the row index of the cell. + +**cell.rw.rw:** 0x0003 specifies that the cell is in row 4. + +**cell.col:** Specifies the column index of the cell. + +**cell.col.col:** 0x0001 specifies that the cell is in column B. + +**cell.ixfe:** Specifies the [cell XF](#Section_518a740d71c640c8bb97e7df6915861a) record in the collection of [XF](#xf) records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +**cell.ixfe.ixfe:** 0x0016 specifies that the cell is formatted according to the second user-defined XF record in the Globals Substream. This XF is the third XF record in this example. + +### Formatting: Number 3 + +The next record in this example, [Number](#number), specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) B5, which contains a [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|------------------| +| 000E | Number **- Number** | | +| 0006 | [Cell](#cell) **- cell** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0004 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x0017 | +| 0008 | Double **- num** | 3FF3C083126E978D | + +Figure 87: Structure of Number + +Fields in this record that are explained in previous records in this example have been omitted for brevity. + +**cell:** Specifies a cell in the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing a floating-point number. + +**cell.rw:** Specifies the row index of the cell. + +**cell.rw.rw:** 0x0004 specifies that the cell is in row 5. + +**cell.col:** Specifies the column index of the cell. + +**cell.col.col:** 0x0001 specifies that the cell is in column B. + +**cell.ixfe:** Specifies the [cell XF](#Section_518a740d71c640c8bb97e7df6915861a) record in the collection of [XF](#xf) records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +**cell.ixfe.ixfe:** 0x0017 specifies that the cell is formatted according to the third user-defined XF record in the Globals Substream. This XF is the fourth XF record in this example. + +## Workbook + +This example shows a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) containing three [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d), named "Sheet1", "Sheet2" and "Sheet3". "Sheet1" contains the following cell content: + +- Cell B4 contains the string "Number". + +- Cell B5 contains the number 1. + +- Cell B6 contains the string "Formula". + +- Cell B7 contains the formula "=SQRT(B5\*2)". + +The workbook example can be broken into two parts. The first part of the example includes records found in the [Globals](#Section_ca4c174887294a93abb94602b3a01fb1) Substream. These records contain details about the entire workbook through examples of the following parent records: [BOF](#bof), [RRTabId](#rrtabid)**,** [BuiltInFnGroupCount](#builtinfngroupcount), [Window1](#window1), [HideObj](#hideobj), [Date1904](#date1904), [CalcPrecision](#calcprecision), [BookBool](#bookbool), [Font](#font), [Format](#format), [XF](#xf), [Style](#style), [BoundSheet8](#boundsheet8)**,** [Country](#country), [RecalcId](#recalcid), [SST](#sst)**,** [ExtSST](#extsst), [BookExt](#bookext), and [EOF](#eof). + +The second part of this example contains the [Worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream. These records contain details about the first sheet through examples of the following parent records: BOF**,** [Index](#index), [DefaultRowHeight](#defaultrowheight), [WsBool](#wsbool), [Setup](#setup), [DefColWidth](#defcolwidth), [Dimensions](#dimensions), [Row](#row), [LabelSst](#labelsst), [RK](#rk), [Formula](#formula), [DBCell](#dbcell), [Window2](#window2), [Selection](#selection), [PhoneticInfo](#phoneticinfo), and EOF. + +"Sheet2" and "Sheet3" are empty sheets and their record details are not documented in this example. + +
+ +

Figure 88: A sheet within a workbook

+
+ +### Workbook: BOF 1 + +This first [BOF](#bof) record begins the [Globals](#Section_ca4c174887294a93abb94602b3a01fb1) Substream and [Workbook](#Section_f682f4b08c6b444e83f852d156f1e8ba) stream and specifies global properties and data for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), as well as the [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in this example workbook. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------|-----------| +| 0014 | BOF **- BOF** | | +| 0002 | USHORT **- vers** | 0x0600 | +| 0002 | USHORT **- dt** | 0x0005 | +| 0002 | USHORT **- rupBuild** | 0x2013 | +| 0002 | USHORT **- rupYear** | 0x07CD | +| 1 bit | DWORD **- fWin** | 0x1 | +| 1 bit | DWORD **- fRisc** | 0x0 | +| 1 bit | DWORD **- fBeta** | 0x0 | +| 1 bit | DWORD **- fWinAny** | 0x0 | +| 1 bit | DWORD **- fMacAny** | 0x0 | +| 1 bit | DWORD **- fBetaAny** | 0x0 | +| 2 bits | DWORD **- unused1** | 0x3 | +| 1 bit | DWORD **- fRiscAny** | 0x0 | +| 1 bit | DWORD **- fOOM** | 0x0 | +| 1 bit | DWORD **- fGlJmp** | 0x0 | +| 2 bits | DWORD **- unused2** | 0x0 | +| 1 bit | DWORD **- fFontLimit** | 0x0 | +| 4 bits | DWORD **- verXLHigh** | 0x3 | +| 1 bit | DWORD **- unused3** | 0x0 | +| 13 bits | DWORD **- reserved1** | 0x0000 | +| 8 bits | DWORD **- verLowestBiff** | 0x06 | +| 4 bits | DWORD **- verLastXLSaved** | 0x3 | +| 20 bits | DWORD **- reserved2** | 0x00000 | + +Figure 89: Structure of BOF + +**vers:** 0x0600 specifies that the [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) version of the file is 1536. + +**dt:** 0x0005 specifies that the substream of records following this BOF record are part of the workbook stream. + +**rupBuild:** 0x2013 specifies that the version of the build is 8211. + +**rupYear:** 0x07CD specifies 1997 as the year when the file format version was first created. + +**fWin:** 0x1 specifies that the file was last edited on a Windows platform. + +**fRisc:** 0x0 specifies that the file was not last edited on a RISC platform. + +**fBeta:** 0x0 specifies that the file was not last edited by a [**beta**](#gt_b7cc0e52-196c-41e1-afa2-14da4352ac5d) version of the application. + +**fWinAny:** 0x0 specifies that the file has not been subsequently saved. + +**fMacAny:** 0x0 specifies that the file has never been edited on a Macintosh platform. + +**fBetaAny:** 0x0 specifies that the file has never been edited on a beta version of the application. + +**fRiscAny:** 0x0 specifies that the file has never been edited on a RISC platform. + +**fOOM:** 0x0 specifies that the file has never had an [**out-of-memory**](#gt_1607fcec-cc19-40a2-9a61-678f90f5943e) failure. + +**fGlJmp:** 0x0 specifies that the file has never had an out-of-memory failure during rendering. + +**fFontLimit:** 0x0 specifies that the file has never reached the 255 [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) limit. + +**verXLHigh:** 0x3 specifies that the file was not edited in any applications after Office Excel 2003. + +**verLowestBiff:** 0x06 specifies that the files are saved in BIFF version 6. + +**verLastXLSaved:** 0x3 specifies that the file was last saved by Office Excel 2003. + +Records following this record, and before the next [RRTabId](#rrtabid) record, are omitted for brevity. + +### Workbook: RRTabId + +This [RRTabId](#rrtabid) record specifies unique [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) identifiers, each of which is associated with a sheet in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------|-----------| +| 0006 | RRTabId **- RRTabId** | | +| 0006 | RgTabId **- rgtabid** | | +| 0002 | USHORT **- rgtabid\[0\]** | 0x0001 | +| 0002 | USHORT **- rgtabid\[1\]** | 0x0002 | +| 0002 | USHORT **- rgtabid\[2\]** | 0x0003 | + +Figure 90: Structure of RRTabId + +**rgtabid:** An array of elements of unique sheet identifiers. + +**rgtabid.rgtabid\[0\]:** 0x0001 specifies the first sheet identifier. + +**rgtabid.rgtabid\[1\]:** 0x0002 specifies the second sheet identifier. + +**rgtabid.rgtabid\[2\]:** 0x0003 specifies the third sheet identifier. + +### Workbook: BuiltInFnGroupCount + +This [BuiltInFnGroupCount](#builtinfngroupcount) record specifies information about the built-in [**function categories**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------------------|-----------| +| 0002 | BuiltInFnGroupCount **- BuiltinFnGroupCount** | | +| 0002 | USHORT **- count** | 0x000E | + +Figure 91: Structure of BuiltinFnGroupCount + +**count:** 0x000E specifies there are 14 built-in function categories in the workbook. + +Records following this record, and before the next [Window1](#window1) record, are omitted for brevity. + +### Workbook: Window1 + +This [Window1](#window1) record specifies attributes of the window used to display the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------|-----------| +| 0012 | Window1 **- Window1** | | +| 0002 | SHORT **- xWn** | 0x01E0 | +| 0002 | SHORT **- yWn** | 0x0069 | +| 0002 | SHORT **- dxWn** | 0x4E1B | +| 0002 | SHORT **- dyWn** | 0x3CE1 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fIconic** | 0x0 | +| 1 bit | USHORT **- fVeryHidden** | 0x0 | +| 1 bit | USHORT **- fDspHScroll** | 0x1 | +| 1 bit | USHORT **- fDspVScroll** | 0x1 | +| 1 bit | USHORT **- fBotAdornment** | 0x1 | +| 1 bit | USHORT **- fNoAFDateGroup** | 0x0 | +| 9 bits | USHORT **- reserved** | 0x000 | +| 0002 | [TabIndex](#tabindex) **- itabCur** | | +| 0002 | USHORT **- itab** | 0x0000 | +| 0002 | TabIndex **- itabFirst** | | +| 0002 | USHORT **- itab** | 0x0000 | +| 0002 | USHORT **- ctabSel** | 0x0001 | +| 0002 | USHORT **- wTabRatio** | 0x0258 | + +Figure 92: Structure of Window1 + +**xWn:** 0x01E0 specifies that the horizontal position of the window is 480 [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382) from the logical left edge of the [**client area**](#gt_623ea69b-ffdb-4751-8751-2cbf4cc11f08) of the window. + +**yWn:** 0x0069 specifies that the vertical position of the window is 105 twips from the top edge of the client area of the window. + +**dxWn:** 0x4E1B specifies that the width of the window is 19995 twips. + +**dyWn:** 0x3CE1 specifies that the height of the window 15585 twips. + +**fHidden:** 0x0000 specifies that the window is not [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**fIconic:** 0x0000 specifies that the window is not minimized. + +**fVeryHidden:** 0x0000 specifies that the window is not hidden. + +**fDspHScroll:** 0x0001 specifies that the horizontal scroll bar is displayed + +**fDspVScroll:** 0x0001 specifies that the vertical scroll bar is displayed. + +**fBotAdornment:** 0x0001 specifies that the [**sheet tabs**](#gt_3b131045-238c-4ce8-9c22-b6aac874c7c5) are displayed. + +**fNoAFDateGroup:** 0x0000 specifies that dates are grouped by year, month, and day in the [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) menu. + +**itabCur:** Specifies which sheet tab is [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595). + +**itabCur.itab:** 0x0000 specifies that the first sheet tab is selected. + +**itabFirst:** Specifies which is the first displayed sheet tab. + +**itabFirst.itab:** 0x0000 specifies that the first tab is the displayed sheet tab. + +**ctabSel:** 0x0001 specifies that one sheet tab is selected in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +**wTabRatio:** 0x0258 specifies that the ratio of the width of the sheet tabs to the width of the horizontal scroll bar is 0.6. + +Records following this record, and before the next [HideObj](#hideobj) record, are omitted for brevity. + +### Workbook: HideObj + +This [HideObj](#hideobj) record specifies how [**drawing objects**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) appear in a window that contains the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------------|-----------| +| 0002 | HideObj **- HideObj** | | +| 0002 | [HideObjEnum](#hideobjenum) **- hideObj** | 0x0000 | + +Figure 93: Structure of HideObj + +**hideObj:** 0x0000 specifies that all drawing objects in the window are shown. + +### Workbook: Date1904 + +This [Date1904](#date1904) record specifies whether the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) uses the 1904-based or the 1900-based [**date system**](#gt_cfc29c5e-eb23-4077-b6eb-492f20f5c87f). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------|-----------| +| 0002 | Date1904 **- Date1904** | | +| 0002 | SHORT **- f1904DateSystem** | 0x0000 | + +Figure 94: Structure of Date1904 + +**f1904DateSystem:** 0x0000 specifies that the workbook uses the 1900 date system. + +### Workbook: CalcPrecision + +This [CalcPrecision](#calcprecision) record specifies the calculation precision mode for the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|------------------------------|-----------| +| 0002 | CalcPrecision **- CalcPrec** | | +| 0002 | SHORT **- fFullPrec** | 0x0001 | + +Figure 95: Structure of CalcPrec + +**fFullPrec:** 0x0001 specifies that [**precision as displayed**](#gt_e2ff81a6-eb9a-4e49-a1d0-cd4483e2e9a6) mode is not [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595). + +Records following this record, and before the next [BookBool](#bookbool) record, are omitted for brevity. + +### Workbook: BookBool + +This [BookBool](#bookbool) record specifies some properties associated with the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------|-----------| +| 0002 | BookBool **- BookBool** | | +| 1 bit | USHORT **- fNoSaveSup** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fHasEnvelope** | 0x0 | +| 1 bit | USHORT **- fEnvelopeVisible** | 0x0 | +| 1 bit | USHORT **- fEnvelopeInitDone** | 0x0 | +| 2 bits | USHORT **- grUpdateLinks** | 0x0 | +| 1 bit | USHORT **- unused** | 0x0 | +| 1 bit | USHORT **- fHideBorderUnselLists** | 0x0 | +| 7 bits | USHORT **- reserved2** | 0x00 | + +Figure 96: Structure of BookBool + +**fNoSaveSup:** 0x0000 specifies that [**external link**](#gt_496fd743-2045-4c53-81b9-83fb90a7fab1) values are saved in the workbook. + +**fHasEnvelope:** 0x0000 specifies the workbook does not have an envelope. + +**fEnvelopeVisible:** 0x0000 specifies the envelope is not visible. + +**fEnvelopeInitDone:** 0x0000 specifies the envelope has not been initialized. + +**grUpdateLinks:** 0x0000 specifies the application prompts users to update external links in the workbook. + +**fHideBorderUnselLists:** 0x0000 specifies that borders of [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) that do not contain the active [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) are not [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +### Workbook: Font + +This [Font](#font) record specifies [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) formatting information and is the first of four in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001A | Font **- Font** | | +| 0002 | USHORT **- dyHeight** | 0x00C8 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fItalic** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fStrikeOut** | 0x0 | +| 1 bit | USHORT **- fOutline** | 0x0 | +| 1 bit | USHORT **- fShadow** | 0x0 | +| 1 bit | USHORT **- fCondense** | 0x0 | +| 1 bit | USHORT **- fExtend** | 0x0 | +| 8 bits | USHORT **- reserved** | 0x00 | +| 0002 | USHORT **- icv** | 0x7FFF | +| 0002 | USHORT **- bls** | 0x0190 | +| 0002 | USHORT **- sss** | 0x0000 | +| 0001 | BYTE **- uls** | 0x00 | +| 0001 | BYTE **- bFamily** | 0x00 | +| 0001 | BYTE **- bCharSet** | 0x00 | +| 0001 | BYTE **- unused3** | 0x57 | +| 000C | [ShortXLUnicodeString](#shortxlunicodestring) **- fontName** | Arial | + +Figure 97: Structure of Font + +**dyHeight:** 0x00C8 specifies that the height of the font is 200 [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382). + +**fItalic:** 0x0 specifies that the font is not italic. + +**fStrikeOut:** 0x0 specifies that the font does not have [**strikethrough formatting**](#gt_b16d9600-aebb-4a4f-bf14-c38e13c11c14) applied. + +**fOutline:** 0x0 specifies that the font does not have an [**outline effect**](#gt_4e818802-fdc1-4227-b32f-1a3cb0943de7). + +**fShadow:** 0x0 specifies that the font does not have a [**shadow effect**](#gt_83056968-00f2-463b-abc6-607dbb242cbf). + +**fCondense:** 0x0 specifies that the font is not condensed + +**fExtend:** 0x0 specifies that the font is not extended. + +**icv:** 0x7FFF specifies that the color of the font is automatic and matches the window text color. + +**bls:** 0x0190 specifies that the font weight is normal. + +**sss:** 0x0000 specifies that no superscript or subscript is used. + +**uls:** 0x00 specifies that the font does not have underlining. + +**bFamily:** 0x00 specifies that the [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2) of the font is not applicable as detailed in the Windows API LOGFONT structure in [\[MSDN-FONTS\]](https://go.microsoft.com/fwlink/?LinkId=90008). + +**bCharSet:** 0x00 specifies that this font belongs to the [**ANSI character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583). + +**fontName:** "Arial" specifies the name of the font. + +The three Font records following this record, and before the next [Format](#format) record, are omitted for brevity. + +### Workbook: Format + +This [Format](#format) record specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) applied to a number and is the first of eight in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|----------------------------------------------------|-----------| +| 001C | Format **- Format** | | +| 0002 | [IFmt](#ifmt) **- ifmt** | 0x0005 | +| 001A | [XLUnicodeString](#xlunicodestring) **- stFormat** | 0.00000 | + +Figure 98: Structure of Format + +**ifmt:** 0x0005 specifies the identifier for the formatting string. + +**stFormat:** "0.00000" specifies the custom number format string to be applied. + +The seven Format records following this record, and before the next [XF](#xf) record, are omitted for brevity. + +### Workbook: XF + +This [XF](#xf) record specifies formatting properties for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and is the first of 21 XF records in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------------------------|-----------| +| 0014 | XF **- Xf** | | +| 0002 | [FontIndex](#fontindex) **- ifnt** | | +| 0002 | USHORT **- ifnt** | 0x0000 | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x0000 | +| 1 bit | USHORT **- fLocked** | 0x1 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fStyle** | 0x1 | +| 1 bit | USHORT **- f123Prefix** | 0x0 | +| 12 bits | USHORT **- ixfParent** | 0xFFF | +| 0003 | [StyleXF](#stylexf) **- Data** | | +| 3 bits | BYTE **- alc** | 0x0 | +| 1 bit | BYTE **- fWrap** | 0x0 | +| 3 bits | BYTE **- alcV** | 0x2 | +| 1 bit | BYTE **- fJustLast** | 0x0 | +| 0001 | [XFPropTextRotation](#xfproptextrotation) **- trot** | | +| 0001 | BYTE **- trot** | 0x00 | +| 4 bits | BYTE **- cIndent** | 0x0 | +| 1 bit | BYTE **- fShrinkToFit** | 0x0 | +| 1 bit | BYTE **- reserved1** | 0x0 | +| 2 bits | BYTE **- iReadOrder** | 0x0 | +| 0001 | BYTE **- unused** | 0x00 | +| 4 bits | USHORT **- dgLeft** | 0x0 | +| 4 bits | USHORT **- dgRight** | 0x0 | +| 4 bits | USHORT **- dgTop** | 0x0 | +| 4 bits | USHORT **- dgBottom** | 0x0 | +| 7 bits | USHORT **- icvLeft** | 0x00 | +| 7 bits | USHORT **- ivcRight** | 0x00 | +| 2 bits | USHORT **- grbitDiag** | 0x0 | +| 7 bits | ULONG **- icvTop** | 0x00 | +| 7 bits | ULONG **- icvBottom** | 0x00 | +| 7 bits | ULONG **- icvDiag** | 0x00 | +| 4 bits | ULONG **- dgDiag** | 0x0 | +| 1 bit | ULONG **- reserved2** | 0x0 | +| 6 bits | ULONG **- fls** | 0x00 | +| 7 bits | USHORT **- icvFore** | 0x40 | +| 7 bits | USHORT **- icvBack** | 0x41 | +| 2 bits | USHORT **- reserved3** | 0x0 | + +Figure 99: Structure of Xf + +**ifnt:** A FontIndex that specifies a [Font](#font) record. + +**ifnt.ifnt:** 0x0000 specifies that the default [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) is used. + +**ifmt:** Specifies the identifier of a [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b). + +**ifmt.ifmt:** 0x0000 specifies that general (automatic) formatting is applied for the cell. + +**fLocked:** 0x1 specifies that this cell has [**locked protection**](#gt_10f1ec97-0464-49da-bf78-5339b9d3520c). Because this workbook example has no [Protect](#protect) record, this setting does not apply. + +**fHidden:** 0x0 specifies that this cell is not [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**fStyle:** 0x1 specifies that this record specifies a [cell style XF](#Section_3d5348ded9df4c31b1fd9f9377273152). + +**f123Prefix:** 0x0 specifies that prefix characters are not present in the cell. + +**ixfParent:** 0xFFF specifies that there is no inheritance from a cell style XF. + +**Data:** This structure specifies formatting properties for a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7). + +**Data.alc:** 0x0 specifies that [**horizontal alignment**](#gt_f0e60ca8-51d5-4553-9126-3d89a4d08f90) for the cell is [**general alignment**](#gt_3ee6d1d4-830b-4dc2-b8be-751665f8045f). + +**Data.fWrap:** 0x0 specifies that cell text is not wrapped. + +**Data.alcV:** 0x2 specifies that [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878) for the cell is bottom alignment. + +**Data.fJustLast:** 0x0 specifies that the cell text is not justified. + +**Data.trot:** This structure specifies rotation for the cell text. + +**Data.trot.trot:** 0x00 specifies zero degrees of rotation. + +**Data.cIndent:** 0x0 specifies that the text indent level is zero. + +**Data.fShrinkToFit:** 0x0 specifies that text is not [**shrink to fit**](#gt_4740d2ef-00d3-4a29-983c-b7b3a6aa01e0). + +**Data.iReadOrder:** 0x0 specifies that context [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361) is set. + +**Data.dgLeft:** 0x0 specifies that there is no [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) border. + +**Data.dgRight:** 0x0 specifies that there is no [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) border. + +**Data.dgTop:** 0x0 specifies that there is no top border. + +**Data.dgBottom:** 0x0 specifies that there is no bottom border. + +**Data.icvLeft:** 0x00 specifies that the logical left border color has not been set. + +**Data.ivcRight:** 0x00 specifies that the logical right border color has not been set. + +**Data.grbitDiag:** 0x0 specifies that there is no diagonal border. + +**Data.icvTop:** 0x00 specifies that the top border color has not been set. + +**Data.icvBottom:** 0x00 specifies that the bottom border color has not been set. + +**Data.icvDiag:** 0x00 specifies that the diagonal border color has not been set. + +**Data.dgDiag:** 0x0 specifies the line style for the diagonal border is set to no border. + +**Data.fls:** 0x00 specifies that there is no [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e). + +**Data.icvFore:** 0x40 specifies that the fill pattern uses the default [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) which is the window text color. + +**Data.icvBack:** 0x41 specifies that fill pattern uses the default [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) which is the default background color for a cell. + +The 20 XF records following this record, and before the next [Style](#style) record, are omitted for brevity. + +### Workbook: Style + +This [Style](#style) record specifies a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7) and is the first of six Style records in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) example . + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------------------|-----------| +| 0004 | Style **- Style** | | +| 12 bits | USHORT **- ixfe** | 0x010 | +| 3 bits | USHORT **- unused** | 0x0 | +| 1 bit | USHORT **- fBuiltIn** | 0x1 | +| 0002 | [BuiltInStyle](#builtinstyle) **- builtInData** | | +| 0001 | BYTE **- istyBuiltIn** | 0x03 | +| 0001 | BYTE **- iLevel** | 0xFF | + +Figure 100: Structure of Style + +Fields in this record that are ignored are omitted for brevity. + +**ixfe:** 0x010 specifies the index to the 16th [XF](#xf) record for which these properties apply; this XF record is omitted from this workbook example for brevity. + +**fBuiltIn:** 0x0001 specifies that this cell uses the built-in cell style. + +**builtInData:** Specifies an optional built-in cell style. + +**builtInData.istyBuiltIn:** 0x03 specifies that the comma cell style is applied. + +The records following this record, and before the next [BoundSheet8](#boundsheet8) record, are omitted for brevity. + +### Workbook: BoundSheet8 1 + +This [BoundSheet8](#boundsheet8) record specifies basic information about the first [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) example, including the sheet name, [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) state, and type of sheet. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 000E | BoundSheet8 **- BoundSheet8** | | +| 0004 | FilePointer **- lbPlyPos** | 0x000005CA | +| 2 bits | USHORT **- hsState** | 0x0 | +| 6 bits | USHORT **- unused** | 0x00 | +| 8 bits | USHORT **- dt** | 0x00 | +| 0008 | [ShortXLUnicodeString](#shortxlunicodestring) **- stName** | Sheet1 | + +Figure 101: Structure of BoundSheet8 + +**lbPlyPos:** 0x000005CA specifies the stream position of the start of the [BOF](#bof) record for the sheet associated with this BoundSheet8 record. This stream position is the start of the binary record, which begins with the two-byte record type and two-byte record size information. See the [record](#Section_170e90ce87d747589331dcf14cd72388) overview for more details. The [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream for this sheet is shown later in this workbook example. + +**hsState:** 0x0 specifies that the sheet is [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72). + +**dt:** 0x00 specifies that the sheet type is a [**Worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +**stName:** "Sheet1" specifies the case-insensitive name of the sheet. + +### Workbook: BoundSheet8 2 + +This record is the same as the previous [BoundSheet8](#boundsheet8) record example and specifies basic information about the second [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) example. The fields that contain the same values as the previous record are omitted for brevity. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 000E | BoundSheet8 **- BoundSheet8** | | +| 0004 | FilePointer **- lbPlyPos** | 0x00000785 | +| 2 bits | USHORT **- hsState** | 0x0 | +| 6 bits | USHORT **- unused** | 0x00 | +| 8 bits | USHORT **- dt** | 0x00 | +| 0008 | [ShortXLUnicodeString](#shortxlunicodestring) **- stName** | Sheet2 | + +Figure 102: Structure of BoundSheet8 + +**lbPlyPos:** 0x00000785 specifies the stream position of the start of the [BOF](#bof) record for the sheet associated with this BoundSheet8 record. The [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream for this sheet is omitted for brevity from the workbook example. + +**stName:** "Sheet2" specifies the unique name of the sheet, which is not case sensitive. + +### Workbook: BoundSheet8 3 + +This record is the same as the first [BoundSheet8](#boundsheet8) record example and specifies basic information about the third [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) example. The fields that contain the same values as the first BoundSheet8 record are omitted for brevity. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 000E | BoundSheet8 **- BoundSheet8** | | +| 0004 | FilePointer **- lbPlyPos** | 0x0000088C | +| 2 bits | USHORT **- hsState** | 0x0 | +| 6 bits | USHORT **- unused** | 0x00 | +| 8 bits | USHORT **- dt** | 0x00 | +| 0008 | [ShortXLUnicodeString](#shortxlunicodestring) **- stName** | Sheet3 | + +Figure 103: Structure of BoundSheet8 + +**lbPlyPos:** 0x0000088C specifies the stream position of the start of the [BOF](#bof) record for the sheet associated with this BoundSheet8 record. The [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream for this sheet is omitted for brevity from the workbook example. + +**stName:** "Sheet3" specifies the name of the sheet, which is not case sensitive. + +### Workbook: Country + +This [Country](#country) record specifies the [**locale**](#gt_7b78ebef-e35d-45ab-abfd-4121b60995de) information for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------|-----------| +| 0004 | Country **- Country** | | +| 0002 | USHORT **- iCountryDef** | 0x0001 | +| 0002 | USHORT **- iCountryWinIni** | 0x0001 | + +Figure 104: Structure of Country + +**iCountryDef:** 0x0001 specifies that the locale for the workbook is the United States. + +**iCountryWinIni:** 0x0001 specifies that the system [**regional setting**](#gt_ede60f7f-1131-4845-800b-b6848215e015) is United States. + +### Workbook: RecalcId + +This [RecalcId](#recalcid) record specifies the recalculation engine identifier of the recalculation engine that last performed a recalculation. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|------------| +| 0008 | RecalcId **- RecalcID** | | +| 0002 | USHORT **- rt** | 0x01C1 | +| 0002 | USHORT **- reserved** | 0x0000 | +| 0004 | DWORD **- dwBuild** | 0x0001BE22 | + +Figure 105: Structure of RecalcID + +**rt:** 0x01C1 specifies that the record identifier for this record is 449. + +**dwBuild:** 0x0001BE22 specifies the recalculation engine identifier of the recalculation engine that performed the last recalculation, which is 114210. + +### Workbook: SST + +This [SST](#sst) record specifies string constants. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001B | SST **- Sst** | | +| 0004 | LONG **- cstTotal** | 0x00000002 | +| 0004 | LONG **- cstUnique** | 0x00000002 | +| 0013 | XLUnicodeRichExtendedString\[\] **- rgb** | | +| 0009 | [XLUnicodeRichExtendedString](#xlunicoderichextendedstring) **- rgb\[0\]** | Number | +| 000A | XLUnicodeRichExtendedString **- rgb\[1\]** | Formula | + +Figure 106: Structure of Sst + +Fields in this record that are ignored because they are optional are omitted for brevity. + +**cstTotal:** 0x00000002 specifies that there are two references in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) to the strings in the shared string table. + +**cstUnique:** 0x00000002 specifies that there are two unique strings in the shared string table. + +**rgb:** Specifies an array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) strings. + +**rgb.rgb\[0\]:** "Number" is the first string in the shared string table. + +**rgb.rgb\[1\]:** "Formula" is the second string in the shared string table. + +### Workbook: ExtSST + +This [ExtSST](#extsst) record specifies the location of strings within the shared string table, specified in the previous [SST](#sst) record. + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------------|------------| +| 000A | ExtSST **- ExtSst** | | +| 0002 | USHORT **- dsst** | 0x0008 | +| 0008 | ISSTInf\[\] **- rgISSTInf** | | +| 0008 | [ISSTInf](#isstinf) **- rgISSTInf\[0\]** | | +| 0004 | FilePointer **- ib** | 0x0000058C | +| 0002 | UINT **- cbOffset** | 0x000C | +| 0002 | reserved **- reserved** | 0x0000 | + +Figure 107: Structure of ExtSst + +**dsst:** 0x0008 specifies the default value for this field as specified by the formula in the ExtSST record. + +**rgISSTInf:** Specifies the location of a set of strings within the SST record. + +**rgISSTInf.rgISSTInf\[0\].ib:** 0x0000058C specifies that the FilePointer as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.5 that specifies the zero-based offset into the [Workbook](#Section_f682f4b08c6b444e83f852d156f1e8ba) stream is 1420. + +**rgISSTInf.rgISSTInf\[0\].cbOffset:** 0x000C specifies that the zero-based offset into the SST record is 12. + +### Workbook: BookExt + +This [BookExt](#bookext) record specifies properties of the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0015 | BookExt **- BookExt** | | +| 000C | [FrtHeader](#frtheader) **- FrtHeader** | | +| 0002 | USHORT **- rt** | 0x0863 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0008 | reserved **- reserved** | 0x0000000000000000 | +| 0004 | DWORD **- cb** | 0x00000015 | +| 1 bit | DWORD **- fDontAutoRecover** | 0x0 | +| 1 bit | DWORD **- fHidePivotList** | 0x0 | +| 1 bit | DWORD **- fFilterPrivacy** | 0x0 | +| 1 bit | DWORD **- fEmbedFactoids** | 0x0 | +| 2 bits | DWORD **- mdFactoidDisplay** | 0x0 | +| 1 bit | DWORD **- fSavedDuringRecovery** | 0x0 | +| 1 bit | DWORD **- fCreatedViaMinimalSave** | 0x0 | +| 1 bit | DWORD **- fOpenedViaDataRecovery** | 0x0 | +| 1 bit | DWORD **- fOpenedViaSafeLoad** | 0x0 | +| 22 bits | DWORD **- reserved** | 0x000000 | +| 0001 | [BookExt_Conditional11](#bookext_conditional11) **- grbit1** | | +| 1 bit | BYTE **- fBuggedUserAboutSolution** | 0x0 | +| 1 bit | BYTE **- fShowInkAnnotation** | 0x1 | +| 6 bits | BYTE **- unused** | 0x00 | + +Figure 108: Structure of BookExt + +Fields in this record that are ignored because they have zero values are omitted for brevity. + +**FrtHeader:** This structure specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) header. + +**FrtHeader.rt:** 0x0863 is the required value for this field and specifies that this record is contained in a BookExt record. + +**FrtHeader.grbitFrt:** This structure specifies flags used in the future record header. + +**FrtHeader.grbitFrt.fFrtRef:** 0x0000 specifies that this **FrtHeader** does not specify a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +**FrtHeader.grbitFrt.fFrtAlert:** 0x0000 specifies that the user is not alerted of possible problems when saving this file without having recognized this record. + +**cb:** 0x00000015 specifies that the size of the record is 21 bytes. + +**fDontAutoRecover:** 0x0 specifies that [**AutoRecover**](#gt_082e4fd1-0461-4797-baa0-d2797f0ba555) is enabled for the workbook. + +**fHidePivotList:** 0x0 specifies that the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) field list is not [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) for this workbook. + +**fFilterPrivacy:** 0x0 specifies that personal information is not removed from the workbook on save. + +**fEmbedFactoids:** 0x0 specifies that [**smart tags**](#gt_2f57a49a-d503-4605-8798-0e53bd637609) are not embedded in this workbook on save. + +**mdFactoidDisplay:** 0x0 specifies that the workbook displays smart tags as [**smart tag actions buttons**](#gt_7c1f7dd0-048a-433e-a5ac-98b32121bcb9) and [**smart tag indicators**](#gt_62e83b67-c6c5-4a3e-8a09-2a5f0f39f65f). + +**fSavedDuringRecovery:** 0x0 specifies that the workbook was not saved during AutoRecover. + +**fCreatedViaMinimalSave:** 0x0 specifies the workbook was not created by a [**minimal save**](#gt_37ba5c27-ec42-4ccf-8122-86166df37c61) during [**data recovery**](#gt_667a7046-739a-4c24-9674-837d88e0031b). + +**fOpenedViaDataRecovery:** 0x0 specifies that the workbook was not opened as a result of data recovery. + +**fOpenedViaSafeLoad:** 0x0 specifies that the workbook was not opened in [**safe load**](#gt_78d75560-7171-4a5d-be0e-3b8c14bc62c4) mode. + +**grbit1:** Specifies additional workbook information. + +**grbit1.fBuggedUserAboutSolution:** 0x0 specifies that no warning is requested before loading a [**manifest**](#gt_d1a20cdc-cced-44de-a041-857fb9054856) that is a [**smart document**](#gt_cc9fe152-6a63-4555-91f1-1543ff84035d). + +**grbit1.fShowInkAnnotation:** 0x1 specifies that [**ink**](#gt_9fcdd1d5-3563-49b9-8a2e-bf696fb08fd0) [**comments**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) for the workbook are not displayed. + +### Workbook: EOF 1 + +This [EOF](#eof) record specifies the end of a collection of records as defined by [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +| **Size** | **Structure** | +|----------|---------------| +| 0000 | EOF **- EOF** | + +Figure 109: Structure of EOF + +### Workbook: BOF 2 + +This [BOF](#bof) record specifies the beginning of the [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream and specifies information about "Sheet1". + +| **Size** | **Structure** | **Value** | +|----------|----------------------------|-----------| +| 0014 | BOF **- BOF** | | +| 0002 | USHORT **- vers** | 0x0600 | +| 0002 | USHORT **- dt** | 0x0010 | +| 0002 | USHORT **- rupBuild** | 0x2013 | +| 0002 | USHORT **- rupYear** | 0x07CD | +| 1 bit | DWORD **- fWin** | 0x1 | +| 1 bit | DWORD **- fRisc** | 0x0 | +| 1 bit | DWORD **- fBeta** | 0x0 | +| 1 bit | DWORD **- fWinAny** | 0x0 | +| 1 bit | DWORD **- fMacAny** | 0x0 | +| 1 bit | DWORD **- fBetaAny** | 0x0 | +| 2 bits | DWORD **- unused1** | 0x3 | +| 1 bit | DWORD **- fRiscAny** | 0x0 | +| 1 bit | DWORD **- fOOM** | 0x0 | +| 1 bit | DWORD **- fGlJmp** | 0x0 | +| 2 bits | DWORD **- unused2** | 0x0 | +| 1 bit | DWORD **- fFontLimit** | 0x0 | +| 4 bits | DWORD **- verXLHigh** | 0x3 | +| 1 bit | DWORD **- unused3** | 0x0 | +| 13 bits | DWORD **- reserved1** | 0x0000 | +| 8 bits | DWORD **- verLowestBiff** | 0x06 | +| 4 bits | DWORD **- verLastXLSaved** | 0x3 | +| 20 bits | DWORD **- reserved2** | 0x00000 | + +Figure 110: Structure of BOF + +**vers:** 0x0600 specifies that the file uses [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) version 6. + +**dt:** 0x0010 specifies that the records following this BOF record are part of the worksheet substream. + +**rupBuild:** 0x2013 specifies that the version of the build is 8211. + +**rupYear:** 0x07CD specifies that 1997 was the year when the file format version was first created. + +**fWin:** 0x1 specifies that the file was last edited on a Windows platform. + +**fRisc:** 0x0 specifies that the file was not lasted edited on a RISC platform. + +**fBeta:** 0x0 specifies that the file was not last edited by a [**beta**](#gt_b7cc0e52-196c-41e1-afa2-14da4352ac5d) version of the application. + +**fWinAny:** 0x0 specifies that the file has not been subsequently saved. + +**fMacAny:** 0x0 specifies that the file has never been edited on a Macintosh platform. + +**fBetaAny:** 0x0 specifies that the file has never edited on a beta version of the application. + +**fRiscAny:** 0x0 specifies that the file has never been edited on a RISC platform. + +**fOOM:** 0x0 specifies that the file never had an [**out-of-memory**](#gt_1607fcec-cc19-40a2-9a61-678f90f5943e) failure. + +**fGlJmp:** 0x0 specifies that this file has never had an out-of-memory failure during rendering. + +**fFontLimit:** 0x0 specifies that the file has never reached the 255 [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) limit. + +**verXLHigh:** 0x3 specifies that the file was not edited in any applications after Office Excel 2003. + +**verLowestBiff:** 0x06 specifies that the file is saved in BIFF version 6. + +**verLastXLSaved:** 0x3 specifies that the file was last saved on Office Excel 2003. + +### Workbook: Index + +The next record is an [Index](#index) record that specifies row information and the file locations for all [DBCell](#dbcell) records corresponding to each row block in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). This record, combined with the DBCell records, is used to optimize the [lookup of cells](#Section_24bbaffdab88489e983f3c400c8a8559) in a [cell table](#Section_d690007dd25c4822a650b24c13288bb7). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------|------------| +| 0014 | Index **- Index** | | +| 0004 | ULONG **- reserved** | 0x00000000 | +| 0004 | [RwLongU](#rwlongu) **- rwMic** | | +| 0004 | ULONG **- rw** | 0x00000003 | +| 0004 | ULONG **- rwMac** | 0x00000007 | +| 0004 | FilePointer **- ibXF** | 0x00000686 | +| 0004 | RgibRw **- rgibRw** | | +| 0004 | FilePointer **- rgibRw\[0\]** | 0x0000073E | + +Figure 111: Structure of Index + +**rwMic:** Specifies the first row that has a cell with data. + +**rwMic.rw:** 0x00000003 specifies that row 4 is the first row with data or formatting. + +**rwMac:** 0x00000007 specifies that row 7 is the last row with data or formatting. This field value specifies the row after the last row that has data or formatting. + +**ibXF:** 0x00000686 specifies a FilePointer as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.5 that specifies the file position of the [DefColWidth](#defcolwidth) record in this sheet. + +**rgibRw.rgibRw\[0\]:** 0x0000073E specifies the file position of the DBCell record. This stream position is the start of the binary record, which begins with the two-byte record type and two-byte record size information. See the [record](#Section_170e90ce87d747589331dcf14cd72388) overview for more details. + +The records following this record, and before the next [DefaultRowHeight](#defaultrowheight) record, are omitted for brevity. + +### Workbook: DefaultRowHeight + +The next record is a [DefaultRowHeight](#defaultrowheight) record that specifies the height of all empty rows in the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------------|-----------| +| 0004 | DefaultRowHeight **- DefaultRowHeight** | | +| 1 bit | USHORT **- fUnsynced** | 0x0 | +| 1 bit | USHORT **- fDyZero** | 0x0 | +| 1 bit | USHORT **- fExAsc** | 0x0 | +| 1 bit | USHORT **- fExDsc** | 0x0 | +| 12 bits | USHORT **- reserved** | 0x000 | +| 0002 | SHORT **- miyRw** | 0x00FF | + +Figure 112: Structure of DefaultRowHeight + +**fUnsynced:** 0x0 specifies that default settings for the row height have not changed. + +**fDyZero:** 0x0 specifies that empty rows do not have a height of zero. + +**fExAsc:** 0x0 specifies that empty rows do not have a thick [**border style**](#gt_2baf659e-8e18-4f60-b3d0-ce0b8e1f2eab) applied to the top [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c). + +**fExDsc:** 0x0 specifies that empty rows do not have a thick border style applied to the bottom border. + +**miyRw:** 0x00FF specifies 255 [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382) as the default row height for empty rows. + +### Workbook: WsBool + +The next record is a [WsBool](#wsbool) record that specifies information about a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------|-----------| +| 0002 | WsBool **- WsBool** | | +| 1 bit | USHORT **- fShowAutoBreaks** | 0x1 | +| 3 bits | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fDialog** | 0x0 | +| 1 bit | USHORT **- fApplyStyles** | 0x0 | +| 1 bit | USHORT **- fRowSumsBelow** | 0x1 | +| 1 bit | USHORT **- fColSumsRight** | 0x1 | +| 1 bit | USHORT **- fFitToPage** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 2 bits | USHORT **- unused** | 0x1 | +| 1 bit | USHORT **- fSyncHoriz** | 0x0 | +| 1 bit | USHORT **- fSyncVert** | 0x0 | +| 1 bit | USHORT **- fAltExprEval** | 0x0 | +| 1 bit | USHORT **- fAltFormulaEntry** | 0x0 | + +Figure 113: Structure of WsBool + +**fShowAutoBreaks:** 0x0001 specifies that [**page breaks**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871) inserted automatically on the sheet are [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72). + +**fDialog:** 0x0000 specifies that the sheet is not a [**dialog sheet**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8). + +**fApplyStyles:** 0x0000 specifies not to apply styles in an [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) when an outline is applied. + +**fRowSumsBelow:** 0x0001 specifies that summary rows appear below an outline’s detail rows. + +**fColSumsRight:** 0x0001 specifies that summary columns appear on the left if the sheet is displayed [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067) or appear on the right if the sheet is displayed [**right-to-left**](#gt_91359688-7863-4e88-b507-f57b3dada5ec). + +**fFitToPage:** 0x0000 specifies that printable contents do not have to fit to a single page when the sheet is printed. + +**fSyncHoriz:** 0x0000 specifies that horizontal scrolling is not synchronized across multiple windows displaying this sheet. + +**fSyncVert:** 0x0000 specifies that vertical scrolling is not synchronized across multiple windows displaying this sheet. + +**fAltExprEval:** 0x0000 specifies that the sheet does not use [**transition formula evaluation**](#gt_47a54c6a-a541-44ae-a0a9-acf78ab8a331). + +**fAltFormulaEntry:** 0x0000 specifies that the sheet does not use [**transition formula entry**](#gt_fd2c615c-ad67-4b97-bde4-7827b37196eb). + +The records following this record, and before the next [Setup](#setup) record, are omitted for brevity. + +### Workbook: Setup + +The next record is a [Setup](#setup) record that specifies the page-format settings used to print the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|--------------------| +| 0022 | Setup **- Setup** | | +| 0002 | USHORT **- iPaperSize** | 0x0000 | +| 0002 | USHORT **- iScale** | 0x00FF | +| 0002 | SHORT **- iPageStart** | 0x0001 | +| 0002 | USHORT **- iFitWidth** | 0x0001 | +| 0002 | USHORT **- iFitHeight** | 0x0001 | +| 1 bit | BYTE **- fLeftToRight** | 0x0 | +| 1 bit | BYTE **- fPortrait** | 0x0 | +| 1 bit | BYTE **- fNoPls** | 0x1 | +| 1 bit | BYTE **- fNoColor** | 0x0 | +| 1 bit | BYTE **- fDraft** | 0x0 | +| 1 bit | BYTE **- fNotes** | 0x0 | +| 1 bit | BYTE **- fNoOrient** | 0x0 | +| 1 bit | BYTE **- fUsePage** | 0x0 | +| 1 bit | BYTE **- unused1** | 0x0 | +| 1 bit | BYTE **- fEndNotes** | 0x0 | +| 2 bits | BYTE **- iErrors** | 0x0 | +| 4 bits | BYTE **- unused2** | 0x0 | +| 0002 | USHORT **- iRes** | 0x0015 | +| 0002 | USHORT **- iVRes** | 0x0000 | +| 0008 | Double **- numHdr** | 0x3FE0000000000000 | +| 0008 | Double **- numFtr** | 0x3FE0000000000000 | +| 0002 | USHORT **- iCopies** | 0x3030 | + +Figure 114: Structure of Setup + +Fields in this record that are ignored because **fNoPls** is 1 are omitted for brevity. + +**iFitWidth:** 0x0001 specifies that the sheet width is fit to one page. + +**iFitHeight:** 0x0001 specifies that the sheet height is fit to one page. + +**fLeftToRight:** 0x00 specifies that the pages are printed in columns. + +**fNoPls:** 0x01 specifies that fields **iPaperSize**, **iScale**, **iRes**, **iVRes**, **iCopies, fNoOrient**, and **fPortrait** data are undefined and ignored. + +**fNoColor:** 0x00 specifies that the workbook is not printed in black and white. + +**fDraft:** 0x00 specifies that the workbook is not printed using draft quality. + +**fNotes:** 0x00 specifies that cell notes are not printed. The **fEndNotes** field is not included in this example for brevity. + +**fUsePage:** 0x00 specifies that no custom starting page number is being used to print. The **iPageStart** field is not included in this example for brevity. + +**iErrors:** 0x00 specifies that errors in the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) data are printed as displayed on the sheet. + +**numHdr:** 0x3FE0000000000000 specifies that the header margin is .5 inches. + +**numFtr:** 0x3FE0000000000000 specifies that the footer margin is .5 inches. + +### Workbook: DefColWidth + +The next record is a [DefColWidth](#defcolwidth) record that specifies the default column width of a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------|-----------| +| 0002 | DefColWidth **- DefColWidth** | | +| 0002 | USHORT **- cchdefColWidth** | 0x0008 | + +Figure 115: Structure of DefColWidth + +**cchdefColWidth:** 0x0008 specifies that the default width of the columns in the sheet is 8 characters. + +### Workbook: Dimensions + +The next record is a [Dimensions](#dimensions) record that specifies the minimum and maximum bounds of all [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on the sheet that contain data or formatting. + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------|------------| +| 000E | Dimensions **- Dimensions** | | +| 0004 | [RwLongU](#rwlongu) **- rwMic** | | +| 0004 | ULONG **- rw** | 0x00000003 | +| 0004 | ULONG **- rwMac** | 0x00000007 | +| 0002 | [ColU](#colu) **- colMic** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | USHORT **- colMac** | 0x0002 | +| 0002 | USHORT **- reserved** | 0x0000 | + +Figure 116: Structure of Dimensions + +**rwMic:** Specifies the first row in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that contains a cell with data or formatting. + +**rwMic.rw:** 0x00000003 specifies that the first row with data or formatting is row 4. + +**rwMac:** 0x00000007 specifies that that row 7 is the last row with data or formatting. This field value specifies the row after the last row that has data or formatting. + +**colMic:** Specifies the first column in the sheet that contains a cell with data or formatting. + +**colMic.col:** 0x0001 specifies that column B is the first column with data or formatting. + +**colMac:** 0x0002 specifies that column B is the last column with data or formatting. This field value specifies the column after the last column that has data or formatting. + +### Workbook: Row 1 + +This record is a [Row](#row) record that specifies a single row on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|------------------------|-----------| +| 0010 | Row **- Row** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0003 | +| 0002 | USHORT **- colMic** | 0x0001 | +| 0002 | USHORT **- colMac** | 0x0002 | +| 0002 | USHORT **- miyRw** | 0x00FF | +| 0002 | SHORT **- reserved1** | 0x0000 | +| 0002 | SHORT **- unused1** | 0x0000 | +| 3 bits | BYTE **- iOutLevel** | 0x0 | +| 1 bit | BYTE **- reserved2** | 0x0 | +| 1 bit | BYTE **- fCollapsed** | 0x0 | +| 1 bit | BYTE **- fDyZero** | 0x0 | +| 1 bit | BYTE **- fUnsynced** | 0x0 | +| 1 bit | BYTE **- fGhostDirty** | 0x0 | +| 0001 | BYTE **- reserved3** | 0x01 | +| 12 bits | SHORT **- ixfe_val** | 0x00F | +| 1 bit | SHORT **- fExAsc** | 0x0 | +| 1 bit | SHORT **- fExDes** | 0x0 | +| 1 bit | SHORT **- fPhonetic** | 0x0 | +| 1 bit | SHORT **- unused2** | 0x0 | + +Figure 117: Structure of Row + +**rw:** Specifies the row index. + +**rw.rw:** 0x0003 specifies that this record is for row 4. + +**colMic:** 0x0001 specifies that column B is the first column that contains a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) populated with data or formatting. + +**colMac:** 0x0002 specifies that column B is the last column that contains a cell populated with data or formatting. + +**miyRw:** 0x00FF specifies the row height as 255 [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382). + +**iOutLevel:** 0x00 specifies the row has no [**outline level**](#gt_a5cd5eff-ddeb-490b-bc71-f6256774e3c3). + +**fDyZero:** 0x00 specifies that the row is not [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**fUnsynced:** 0x00 specifies that the row height has not been manually set. + +**fGhostDirty:** 0x00 specifies that the row has not been formatted. + +**ixfe_val:** 0x000F specifies that this row uses the default formatting. + +**fExAsc:** 0x0000 specifies that no cell in the row has a thick top [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c). + +**fExDes:** 0x0000 specifies that no cell in the row has a thick bottom border. + +**fPhonetic:** 0x0000 specifies that [**phonetic guide**](#gt_f5ae2680-242d-4731-8f12-da90d5d7f09f) is not enabled for any cell in this row. + +### Workbook: Row 2 + +This record is another [Row](#row) record that specifies a single row on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|------------------------|-----------| +| 0010 | Row **- Row** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0004 | +| 0002 | USHORT **- colMic** | 0x0001 | +| 0002 | USHORT **- colMac** | 0x0002 | +| 0002 | USHORT **- miyRw** | 0x00FF | +| 0002 | SHORT **- reserved1** | 0x0000 | +| 0002 | SHORT **- unused1** | 0x0000 | +| 3 bits | BYTE **- iOutLevel** | 0x0 | +| 1 bit | BYTE **- reserved2** | 0x0 | +| 1 bit | BYTE **- fCollapsed** | 0x0 | +| 1 bit | BYTE **- fDyZero** | 0x0 | +| 1 bit | BYTE **- fUnsynced** | 0x0 | +| 1 bit | BYTE **- fGhostDirty** | 0x0 | +| 0001 | BYTE **- reserved3** | 0x01 | +| 12 bits | SHORT **- ixfe_val** | 0x00F | +| 1 bit | SHORT **- fExAsc** | 0x0 | +| 1 bit | SHORT **- fExDes** | 0x0 | +| 1 bit | SHORT **- fPhonetic** | 0x0 | +| 1 bit | SHORT **- unused2** | 0x0 | + +Figure 118: Structure of Row + +Fields in this record that are explained in previous records in this example are omitted for brevity. + +**rw.rw:** 0x0004 specifies that this record is for row 5. + +### Workbook: Row 3 + +This record is another [Row](#row) record that specifies a single row on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|------------------------|-----------| +| 0010 | Row **- Row** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0005 | +| 0002 | USHORT **- colMic** | 0x0001 | +| 0002 | USHORT **- colMac** | 0x0002 | +| 0002 | USHORT **- miyRw** | 0x00FF | +| 0002 | SHORT **- reserved1** | 0x0000 | +| 0002 | SHORT **- unused1** | 0x0000 | +| 3 bits | BYTE **- iOutLevel** | 0x0 | +| 1 bit | BYTE **- reserved2** | 0x0 | +| 1 bit | BYTE **- fCollapsed** | 0x0 | +| 1 bit | BYTE **- fDyZero** | 0x0 | +| 1 bit | BYTE **- fUnsynced** | 0x0 | +| 1 bit | BYTE **- fGhostDirty** | 0x0 | +| 0001 | BYTE **- reserved3** | 0x01 | +| 12 bits | SHORT **- ixfe_val** | 0x00F | +| 1 bit | SHORT **- fExAsc** | 0x0 | +| 1 bit | SHORT **- fExDes** | 0x0 | +| 1 bit | SHORT **- fPhonetic** | 0x0 | +| 1 bit | SHORT **- unused2** | 0x0 | + +Figure 119: Structure of Row + +Fields in this record that are explained in previous records in this example are omitted for brevity. + +**rw.rw:** 0x0005 specifies that this record is for row 6. + +### Workbook: Row 4 + +This record is another [Row](#row) record that specifies a single row on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|------------------------|-----------| +| 0010 | Row **- Row** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0006 | +| 0002 | USHORT **- colMic** | 0x0001 | +| 0002 | USHORT **- colMac** | 0x0002 | +| 0002 | USHORT **- miyRw** | 0x00FF | +| 0002 | SHORT **- reserved1** | 0x0000 | +| 0002 | SHORT **- unused1** | 0x0000 | +| 3 bits | BYTE **- iOutLevel** | 0x0 | +| 1 bit | BYTE **- reserved2** | 0x0 | +| 1 bit | BYTE **- fCollapsed** | 0x0 | +| 1 bit | BYTE **- fDyZero** | 0x0 | +| 1 bit | BYTE **- fUnsynced** | 0x0 | +| 1 bit | BYTE **- fGhostDirty** | 0x0 | +| 0001 | BYTE **- reserved3** | 0x01 | +| 12 bits | SHORT **- ixfe_val** | 0x00F | +| 1 bit | SHORT **- fExAsc** | 0x0 | +| 1 bit | SHORT **- fExDes** | 0x0 | +| 1 bit | SHORT **- fPhonetic** | 0x0 | +| 1 bit | SHORT **- unused2** | 0x0 | + +Figure 120: Structure of Row + +Fields in this record that are explained in previous records in this example are omitted for brevity. + +**rw.rw:** 0x0006 specifies that this record is for row 7. + +### Workbook: LabelSst 1 + +This record is a [LabelSst](#labelsst) record that specifies a string that is stored in a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) as a reference to the shared string table. + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|------------| +| 000A | LabelSst **- LabelSst** | | +| 0006 | [Cell](#cell) **- cell** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0003 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x000F | +| 0004 | ULONG **- isst** | 0x00000000 | + +Figure 121: Structure of LabelSst + +**cell:** Specifies a cell in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**cell.rw:** Specifies a row in the sheet. + +**cell.rw.rw:** 0x0003 specifies row 4. + +**cell.col:** Specifies a column in the sheet. + +**cell.col.col:** 0x0001 specifies column B. + +**cell.ixfe:** Specifies the index of a [cell XF](#Section_518a740d71c640c8bb97e7df6915861a) record that describes the formatting properties for the cell. + +**cell.ixfe.ixfe:** 0x000F specifies that this cell uses the default cell format. + +**isst:** 0x00000000 specifies that 0 is the zero-based index into the **rgb** field of [SST](#sst), which specifies that the text for this cell is "Number". + +### Workbook: RK + +This record is an [RK](#rk) record that specifies the numeric data contained in a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|------------| +| 000A | RK **- Rk** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0004 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0006 | [RkRec](#rkrec) **- rkrec** | | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x000F | +| 0004 | [RkNumber](#rknumber) **- RK** | | +| 1 bit | ULONG **- FX100** | 0x0 | +| 1 bit | ULONG **- FInt** | 0x0 | +| 30 bits | ULONG **- num** | 0x0FFC0000 | + +Figure 122: Structure of Rk + +**rw:** Specifies a row in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**rw.rw:** 0x0004 specifies row 5. + +**col:** Specifies a column in the sheet. + +**col.col:** 0x0001 specifies column B. + +**rkrec:** Specifies the numeric data for this cell. + +**rkrec.ixfe:** Specifies the index of a [cell XF](#Section_518a740d71c640c8bb97e7df6915861a) record that describes the formatting properties for the cell. + +**rkrec.ixfe.ixfe:** 0x000F specifies that this cell uses the default cell format. + +**rkrec.RK:** An RkNumber that specifies a numeric value. + +**rkrec.RK.FX100:** 0x0 specifies that the value in the **rkrec.RK.num** field was not multiplied by 100 when it was saved. + +**rkrec.RK.FInt:** 0x0 specifies that the value in the **rkrec.RK.num** field is the 30 most significant bits of a 64-bit binary floating-point number as defined in [\[IEEE754\]](https://go.microsoft.com/fwlink/?LinkId=89903). + +**rkrec.RK.num:** 0x0FFC0000 specifies the 30 most significant bits of a 64-bit binary floating-point number as defined in \[IEEE754\]. The remaining 34 bits are 0, which evaluates to a numeric value of 1. + +### Workbook: LabelSst 2 + +This record is a [LabelSst](#labelsst) record that specifies a string that is stored in a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) as a reference to the shared string table. + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|------------| +| 000A | LabelSst **- LabelSst** | | +| 0006 | [Cell](#cell) **- cell** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0005 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x000F | +| 0004 | ULONG **- isst** | 0x00000001 | + +Figure 123: Structure of LabelSst + +Fields in this record that are explained in previous records in this example are omitted for brevity. + +**cell.rw.rw:** 0x0005 specifies row 6. + +**isst:** 0x00000001 specifies that 1 is the zero-based index into the **rgb** field of [SST](#sst), which specifies that the text for this cell is "Formula". + +### Workbook: Formula + +This record is a [Formula](#formula) record that specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0022 | Formula **- Formula** | | +| 0006 | [Cell](#cell) **- cell** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0006 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x000F | +| 0008 | [FormulaValue](#formulavalue) **- val** | 0x3FF6A09E667F3BCD | +| 1 bit | USHORT **- fAlwaysCalc** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFill** | 0x0 | +| 1 bit | USHORT **- fShrFmla** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 1 bit | USHORT **- fClearErrors** | 0x0 | +| 10 bits | USHORT **- reserved3** | 0x000 | +| 0004 | DWORD **- chn** | 0xFCFC000C | +| 000E | [CellParsedFormula](#cellparsedformula) **- formula** | | +| 0002 | WORD **- cce** | 0x000C | +| 000C | [Rgce](#rgce) **- rgce** | | +| 0005 | [Ptg](#ptg) **- Ptg\[0\]** | | +| 0005 | [PtgRef](#ptgref) **- PtgRef** | | +| 5 bits | BYTE **- ptg** | 0x04 | +| 2 bits | BYTE **- type** | 0x2 | +| 1 bit | BYTE **- reserved** | 0x0 | +| 0004 | [RgceLoc](#rgceloc) **- loc** | | +| 0002 | [RwU](#rwu) **- row** | | +| 0002 | USHORT **- rw** | 0x0004 | +| 0002 | [ColRelU](#colrelu) **- column** | | +| 14 bits | USHORT **- col** | 0x0001 | +| 1 bit | USHORT **- colRelative** | 0x1 | +| 1 bit | USHORT **- rowRelative** | 0x1 | +| 0003 | Ptg **- Ptg\[1\]** | | +| 0003 | [PtgInt](#ptgint) **- PtgInt** | | +| 7 bits | BYTE **- ptg** | 0x1E | +| 1 bit | BYTE **- reserved0** | 0x0 | +| 0002 | WORD **- integer** | 0x0002 | +| 0001 | Ptg **- Ptg\[2\]** | | +| 0001 | [PtgMul](#ptgmul) **- PtgMul** | | +| 7 bits | BYTE **- ptg** | 0x05 | +| 1 bit | BYTE **- reserved0** | 0x0 | +| 0003 | Ptg **- Ptg\[3\]** | | +| 0003 | [PtgFunc](#ptgfunc) **- PtgFunc** | | +| 5 bits | BYTE **- ptg** | 0x01 | +| 2 bits | BYTE **- type** | 0x2 | +| 1 bit | BYTE **- reserved** | 0x0 | +| 0002 | [Ftab](#ftab) **- iftab** | | +| 0002 | WORD **- iftab** | 0x0014 | + +Figure 124: Structure of Formula + +**cell:** Specifies a cell on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**cell.rw:** Specifies the row of the cell. + +**cell.rw.rw:** 0x0006 specifies row 7. + +**cell.col:** Specifies the column of the cell. + +**cell.col.col:** 0x0001 specifies column B. + +**cell.ixfe:** Specifies the index of a [cell XF](#Section_518a740d71c640c8bb97e7df6915861a) record that describes the formatting properties for the cell. + +**cell.ixfe.ixfe:** 0x000F specifies that this cell uses the default cell format. + +**val:** 0x3FF6A09E667F3BCD specifies the floating-point value of 1.4142135623731, which is the value in the cell as a result of the last calculation. + +**fAlwaysCalc:** 0x0 specifies that the formula does not need to be recalculated. + +**fFill:** 0x0 specifies this cell does not have a [**fill alignment**](#gt_cfc4e171-6104-470e-9ebb-812afea17078) or a [**center-across-selection alignment**](#gt_ef7324bd-dac8-46e2-8df5-db44d8b925a8). + +**fShrFmla:** 0x0 specifies that the formula is not part of a shared formula. + +**fClearErrors:** 0x0 specifies that the formula is not excluded from [**formula error checking**](#gt_c28d38d6-c6d1-4d06-89c2-29816f9c5b23). + +**chn:** Specifies an application-specific cache. This is optionally used and can be ignored. + +**formula:** Specifies a formula. + +**formula.cce:** 0x000C specifies the length of **rgce** in bytes. + +**formula.rgce:** Specifies the sequence of Ptgs for the formula SQRT(B5\*2). + +**formula.rgce.Ptg\[0\]:** Specifies a single element of a formula. + +**formula.rgce.Ptg\[0\].PtgRef:** Specifies a reference to a single cell on the current sheet. + +**formula.rgce.Ptg\[0\].PtgRef.ptg:** 0x04 specifies that this Ptg is a PtgRef. + +**formula.rgce.Ptg\[0\].PtgRef.type:** 0x2 specifies that this PtgRef uses a value data type. + +**formula.rgce.Ptg\[0\].PtgRef.loc:** Specifies the cell referenced by this Ptg. + +**formula.rgce.Ptg\[0\].PtgRef.loc.row:** Specifies the row of the referenced cell. + +**formula.rgce.Ptg\[0\].PtgRef.loc.row.rw:** 0x0004 specifies that the referenced cell is in row 5. + +**formula.rgce.Ptg\[0\].PtgRef.loc.column:** Specifies the column of the referenced cell. + +**formula.rgce.Ptg\[0\].PtgRef.loc.column.col:** 0x0001 specifies that the referenced cell is in column B. + +**formula.rgce.Ptg\[0\].PtgRef.loc.column.colRelative:** 0x1 specifies that the column reference is a [**relative reference**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac). + +**formula.rgce.Ptg\[0\].PtgRef.loc.column.rowRelative:** 0x1 specifies that the row reference is a relative reference. + +**formula.rgce.Ptg\[1\]:** Specifies a single element of a formula. + +**formula.rgce.Ptg\[1\].PtgInt:** Specifies an integer value. + +**formula.rgce.Ptg\[1\].PtgInt.ptg:** 0x1E specifies that this is a PtgInt. + +**formula.rgce.Ptg\[1\].PtgInt.integer:** 0x0002 specifies that the value is 2. + +**formula.rgce.Ptg\[2\]:** Specifies a single element of a formula. + +**formula.rgce.Ptg\[2\].PtgMul:** Specifies a binary-value-operator that multiplies the first and second expressions in a binary-value-expression. + +**formula.rgce.Ptg\[2\].PtgMul.ptg:** 0x05 specifies that this Ptg is a PtgMul. + +**formula.rgce.Ptg\[3\]:** Specifies a single element of a formula. + +**formula.rgce.Ptg\[3\].PtgFunc:** Specifies a mathematical function. + +**formula.rgce.Ptg\[3\].PtgFunc.ptg:** 0x01 specifies that this is a PtgFunc. + +**formula.rgce.Ptg\[3\].PtgFunc.type:** 0x2 specifies that this Ptg uses a value data type. + +**formula.rgce.Ptg\[3\].PtgFunc.iftab:** Specifies the function to be called for this Ptg. + +**formula.rgce.Ptg\[3\].PtgFunc.iftab.iftab:** 0x0014 specifies that SQRT is the function to be called. + +### Workbook: DBCell + +This record is a [DBCell](#dbcell) record that specifies the location of the first row and the first cell record in each row of the current row block in the [workbook stream](#Section_f682f4b08c6b444e83f852d156f1e8ba). + +| **Size** | **Structure** | **Value** | +|----------|------------------------|------------| +| 000C | DBCell **- DbCell** | | +| 0004 | ULONG **- dbRtrw** | 0x000000A0 | +| 0008 | Rgdb **- rgdb** | | +| 0002 | USHORT **- rgdb\[0\]** | 0x003C | +| 0002 | USHORT **- rgdb\[1\]** | 0x000E | +| 0002 | USHORT **- rgdb\[2\]** | 0x000E | +| 0002 | USHORT **- rgdb\[3\]** | 0x000E | + +Figure 125: Structure of DbCell + +**dbRtrw:** 0x000000A0 specifies the offset from the file position of this record to the file position of the first row record. + +**rgdb:** Specifies the file offset to the first cell record in each row. + +**rgdb.rgdb\[0\]:** 0x003C specifies the file offset in bytes to the first record that specifies a [CELL](#common-productions) in each row that is a part of this row block. The starting position of this offset is specified relative to the file position of the end of the first [Row](#row) record in the row block + +**rgdb.rgdb\[1\]:** 0x000E specifies the file offset in bytes to the first record that specifies a CELL in each row that is a part of this row block. The offset is specified relative to the file position of the CELL record specified by the previous element in this array. + +**rgdb.rgdb\[2\]:** 0x000E specifies the file offset in bytes to the first record that specifies a CELL in each row that is a part of this row block. The offset is specified relative to the file position of the CELL record specified by the previous element in this array. + +**rgdb.rgdb\[3\]:** 0x000E specifies the file offset in bytes to the first record that specifies a CELL in each row that is a part of this row block. The offset is specified relative to the file position of the CELL record specified by the previous element in this array. + +### Workbook: Window2 + +This record is a [Window2](#window2) record that specifies attributes of the window used to display the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------|-----------| +| 0012 | Window2 **- Window2** | | +| 1 bit | USHORT **- fDspFmlaRt** | 0x0 | +| 1 bit | USHORT **- fDspGridRt** | 0x1 | +| 1 bit | USHORT **- fDspRwColRt** | 0x1 | +| 1 bit | USHORT **- fFrozenRt** | 0x0 | +| 1 bit | USHORT **- fDspZerosRt** | 0x1 | +| 1 bit | USHORT **- fDefaultHdr** | 0x1 | +| 1 bit | USHORT **- fRightToLeft** | 0x0 | +| 1 bit | USHORT **- fDspGuts** | 0x1 | +| 1 bit | USHORT **- fFrozenNoSplit** | 0x0 | +| 1 bit | USHORT **- fSelected** | 0x1 | +| 1 bit | USHORT **- fPaged** | 0x1 | +| 1 bit | USHORT **- fSLV** | 0x0 | +| 4 bits | USHORT **- reserved1** | 0x0 | +| 0002 | [RwU](#rwu) **- rwTop** | | +| 0002 | USHORT **- rw** | 0x0000 | +| 0002 | [ColU](#colu) **- colLeft** | | +| 0002 | USHORT **- col** | 0x0000 | +| 0002 | [Icv](#icv) **- icvHdr** | | +| 0002 | USHORT **- icv** | 0x0040 | +| 0002 | USHORT **- reserved2** | 0x0000 | +| 0002 | USHORT **- wScaleSLV** | 0x0000 | +| 0002 | USHORT **- wScaleNormal** | 0x0000 | +| 0002 | USHORT **- unused** | 0x0000 | +| 0002 | USHORT **- reserved3** | 0x0000 | + +Figure 126: Structure of Window2 + +**fDspFmlaRt:** 0x0 specifies that this window displays values. + +**fDspGridRt:** 0x1 specifies that this window displays [**gridlines**](#gt_82f8a326-64b0-4506-a18e-930f7c2c95b9). + +**fDspRwColRt:** 0x1 specifies that this window displays row headings and column headings. + +**fFrozenRt:** 0x0 specifies that the panes in the window are not [**frozen**](#gt_1e984b7c-9760-4832-88c8-798e30f845db). The **fFrozenNoSplit** field is not included in this example for brevity. + +**fDspZerosRt:** 0x1 specifies that this window displays each [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that has a value of zero as a zero. + +**fDefaultHdr:** 0x1 specifies that the gridlines of this window are drawn in the default [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) of the window. + +**fRightToLeft:** 0x0 specifies that the text is displayed [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067). + +**fDspGuts:** 0x1 specifies that this window displays the [**outline state**](#gt_595fa0de-0130-489d-ba83-fbba78917310). + +**fSelected:** 0x1 specifies that the [**sheet tab**](#gt_3b131045-238c-4ce8-9c22-b6aac874c7c5) is [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595). + +**fPaged:** 0x1 specifies that the sheet is currently being displayed in the window. + +**fSLV:** 0x0 specifies that the sheet is not in [**Page Break Preview view**](#gt_a7342c25-b4fd-4c84-9922-ae9c4a92d180). + +**rwTop.rw:** 0x0000 specifies row 1 as the first visible row on the sheet. + +**colLeft.col:** 0x0000 specifies column 1 as the first visible column on the sheet. + +**icvHdr.icv:** 0x0040 specifies that the gridlines of this window are drawn in the default foreground color of the window. + +**wScaleSLV:** 0x0000 specifies that the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) in the Page Break Preview view is the default zoom level. + +**wScaleNormal:** 0x0000 specifies that the zoom level in the [**Normal view**](#gt_b3c343ae-05ca-4b91-9cc1-383ee3563990) is the default zoom level. + +### Workbook: Selection + +This record is a [Selection](#selection) record that specifies the [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------------|-----------| +| 000F | Selection **- Selection** | | +| 0001 | [PaneType](#panetype) **- pnn** | 0x03 | +| 0002 | [RwU](#rwu) **- rwAct** | | +| 0002 | USHORT **- rw** | 0x0007 | +| 0002 | [ColU](#colu) **- colAct** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | USHORT **- irefAct** | 0x0000 | +| 0002 | USHORT **- cref** | 0x0001 | +| 0006 | [SqRefU](#sqrefu) **- rgref** | | +| 0006 | [RefU](#refu) **- rgref\[0\]** | | +| 0002 | RwU **- rwFirst** | | +| 0002 | USHORT **- rw** | 0x0007 | +| 0002 | RwU **- rwLast** | | +| 0002 | USHORT **- rw** | 0x0007 | +| 0001 | [ColByteU](#colbyteu) **- colFirst** | | +| 0001 | BYTE **- col** | 0x01 | +| 0001 | ColByteU **- colLast** | | +| 0001 | BYTE **- col** | 0x01 | + +Figure 127: Structure of Selection + +**pnn:** 0x03 specifies that a top left pane is the [**active pane**](#gt_33f49274-001d-40a3-bcca-f54a93906c29). + +**rwAct:** An RwU that specifies the row number of the [**active cell**](#gt_2c0759a5-6721-422b-8cb9-f4bb09e07c84). + +**rwAct.rw:** 0x0007 specifies that row 8 contains the active cell. + +**colAct:** A ColU that specifies the column number of the active cell. + +**colAct.col:** 0x0001 specifies that column B contains the active cell. + +**irefAct:** 0x0000 specifies an index into the **rgref** array that specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells that contain the active cell. + +**cref:** 0x0001 specifies that there is 1 range of cells in the **rgref** array of this record. + +**rgref:** An array of RefU that specifies ranges of selected cells in the sheet. + +**rgref.rgref\[0\]:** Specifies a range of cells on the sheet. + +**rgref.rgref\[0\].rwFirst:** An RwU that specifies the first row in the range. + +**rgref.rgref\[0\].rwFirst.rw:** 0x0007 specifies that row 8 is the first row in the range. + +**rgref.rgref\[0\].rwLast:** Specifies the last row in the range. + +**rgref.rgref\[0\].rwLast.rw:** 0x0007 specifies that row 8 is the last row in the range. + +**rgref.rgref\[0\].colFirst:** A ColByteU that specifies the first column in the range. + +**rgref.rgref\[0\].colFirst.col:** 0x01 specifies that column B is the first column in the range. + +**rgref.rgref\[0\].colLast:** A ColByteU that specifies the last column in the range. + +**rgref.rgref\[0\].colLast.col:** 0x01 specifies that column B is the last column in the range. + +### Workbook: PhoneticInfo + +This record is a [PhoneticInfo](#phoneticinfo) record that specifies the default format for [**phonetic strings**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77) and the [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that have [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) phonetic strings. + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------|-----------| +| 0006 | PhoneticInfo **- PhoneticInfo** | | +| 0004 | [Phs](#phs) **- phs** | | +| 0002 | [FontIndex](#fontindex) **- ifnt** | | +| 0002 | USHORT **- ifnt** | 0x0000 | +| 2 bits | USHORT **- phType** | 0x3 | +| 2 bits | USHORT **- alcH** | 0x1 | +| 12 bits | USHORT **- unused** | 0x003 | +| 0002 | [SqRef](#sqref) **- sqref** | | +| 0002 | USHORT **- cref** | 0x0000 | + +Figure 128: Structure of PhoneticInfo + +**phs:** A Phs structure that specifies the default format for phonetic string on the sheet. + +**phs.ifnt:** A FontIndex structure that specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) for the string. + +**phs.ifnt.ifnt:** 0x0000 specifies that the default font is used. + +**phs.phType:** 0x0003 specifies that phonetic string can use any type of characters. + +**phs.alcH:** 0x0001 specifies that left alignment is used in the phonetic string. + +**sqref:** A SqRef structure that specifies the ranges of cells on the sheet that have visible phonetic strings. + +**sqref.cref:** 0x0000 specifies the number of elements in **rgrefs**. The **rgrefs** field is not included in this example for brevity. + +### Workbook: EOF 2 + +This record is an [EOF](#eof) record which specifies the end of a collection of records for this [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream. + +| **Size** | **Structure** | +|----------|---------------| +| 0000 | EOF **- EOF** | + +Figure 129: Structure of EOF + +The remaining records in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) example, two Worksheet substreams, are omitted for brevity. + +## PivotTable + +This example shows a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) and associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) within a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The PivotTable uses a range of cells (A1:E45) in the "Source Data" [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) as its [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). A CustomerName field and ProductName field are added to the [row area](#Section_5594c95e6819461e80706f4b4fdfa091), a Quantity field to the [data area](#Section_237a24905c614931923f7ee856f23c72), and an OrderDate field to the [page area](#Section_f10ef7d86c044d35a5830d6f2ce92063) of this PivotTable. Two dates are selected in the [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) for the OrderDate field; the other dates are filtered out from page area. This example addresses important PivotTable records, and those records that are relevant to different parts of the PivotTable from the [Workbook stream](#Section_f682f4b08c6b444e83f852d156f1e8ba) and [Pivot Cache Storage stream](#Section_c5fb3f663ef64308ae3de59244159687). + +The following figure shows a possible implementation of the PivotTable discussed in this example. + +
+ +

Figure 130: Example PivotTable within a sheet

+
+ +### PivotTable: SXStreamID + +The first record, an [SXStreamID](#sxstreamid), specifies the stream in the [PivotCache storage](#Section_c5fb3f663ef64308ae3de59244159687) that contains the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) for this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------|-----------| +| 0002 | SXStreamID **- SxStreamID** | | +| 0002 | USHORT **- idstm** | 0x0001 | + +Figure 131: Structure of SxStreamID + +**idstm:** 0x0001 specifies the identifier of the stream in the PivotCache storage that contains the PivotCache for this PivotTable. The stream identifier is a four-character string representation of the hexadecimal value. In this case the stream identifier is "0001". + +### PivotTable: SXVS + +The next record, an [SXVS](#sxvs), specifies that the type of [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) used for this [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +| **Size** | **Structure** | **Value** | +|----------|-------------------|-----------| +| 0002 | SXVS **- SXVS** | | +| 0002 | USHORT **- sxvs** | 0x0001 | + +Figure 132: Structure of SXVS + +**sxvs:** 0x0001 specifies that the source data for this PivotTable is a range. The [DConRef](#dconref) record that follows this record specifies the range. + +### PivotTable: DConRef + +The next record, a [DConRef](#dconref), specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) that is the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) for this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0016 | DConRef **- DConRef** | | +| 0006 | [RefU](#refu) **- ref** | | +| 0002 | [RwU](#rwu) **- rwFirst** | | +| 0002 | USHORT **- rw** | 0x0000 | +| 0002 | RwU **- rwLast** | | +| 0002 | USHORT **- rw** | 0x002C | +| 0001 | [ColByteU](#colbyteu) **- colFirst** | | +| 0001 | BYTE **- col** | 0x00 | +| 0001 | ColByteU **- colLast** | | +| 0001 | BYTE **- col** | 0x04 | +| 0002 | USHORT **- cchFile** | 0x000C | +| 000D | [DConFile](#dconfile) **- stFile** | | +| 000D | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- stFile** | Source Data | +| 0001 | unused **- unused** | 0x00 | + +Figure 133: Structure of DConRef + +**ref:** A RefU structure that specifies the range of the source data for this PivotTable in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) specified by **stFile**. + +**ref.rwFirst:** An RwU structure that specifies the first row in the range of the source data for this PivotTable. + +**ref.rwFirst.rw:** 0x0000 specifies that the range of the source data for this PivotTable begins in row 1 of the sheet specified by **stFile**. + +**ref.rwLast:** An RwU structure that specifies the last row in the range of the source data for this PivotTable. + +**ref.rwLast.rw:** 0x002C specifies that the range of the source data for this PivotTable ends in row 45 of the sheet specified by **stFile.** + +**ref.colFirst:** A ColByteU structure that specifies the first column in the range of the source data for this PivotTable. + +**ref.colFirst.col:** 0x00 specifies that the range of the source data for this PivotTable begins in the column A of the sheet specified by **stFile.** + +**ref.colLast:** A ColByteU structure that specifies the last column in the range of the source data for this PivotTable. + +**ref.colLast.col:** 0x04 specifies that the range of the source data for this PivotTable ends in column E of the sheet specified by **stFile**. + +**cchFile:** 0x000C specifies that **stFile** is 12 characters in length. + +**stFile:** A DConFile structure that specifies the name of the worksheet that contains the range of the source data for this PivotTable. + +**stFile.stFile:** A string, "Source Data", that specifies the name of the worksheet that contains the range of the source data for this PivotTable. + +### PivotTable: SXAddl 1 + +The next record, [SXAddl](#sxaddl), specifies additional information for this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 000C | [SXAddl_SXCCache_SXDId](#sxaddl_sxccache_sxdid) **- SXAddl** | | +| 0006 | [SXAddlHdr](#sxaddlhdr) **- hdr** | | +| 0004 | [FrtHeaderOld](#frtheaderold) **- frtHeaderOld** | | +| 0002 | USHORT **- rt** | 0x0864 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0001 | BYTE **- sxc** | 0x03 | +| 0001 | BYTE **- sxd** | 0x00 | +| 0004 | ULONG **- idCache** | 0x00000001 | +| 0002 | USHORT **- reserved** | 0x0000 | + +Figure 134: Structure of SXAddl + +**hdr:** An SXAddlHdr structure that specifies header information for this SXAddl record. + +**hdr.frtHeaderOld:** A structure that specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) type header. + +**hdr.frtHeaderOld.rt:** 0x0864 specifies the record type identifier for this record. + +**hdr.frtHeaderOld.grbitFrt:** A structure that specifies flags for **hdr.FrtHeaderOld**. + +**hdr.frtHeaderOld.grbitFrt.fFrtRef:** 0x0 specifies that this record does not specify a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +**hdr.frtHeaderOld.grbitFrt.fFrtAlert:** 0x0 specifies that the application does not alert the user about possible problems if the file is saved without the record being recognized. + +**hdr.sxc:** 0x03 specifies the current [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) as an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + +**hdr.sxd:** 0x00 specifies the type of record contained in the **data** field of the containing SXAddl record. This value specifies that the type of this SXAddl record is SXAddl_SXCCache_SXDId. + +**idCache:** 0x00000001 specifies the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) stream that is associated with this SxcCache class. + +### PivotTable: SXAddl 2 + +The next record, [SXAddl](#sxaddl), specifies additional information for this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001C | [SXAddl_SXCCache_SXDVer10Info](#sxaddl_sxccache_sxdver10info) **- SXAddl** | | +| 0006 | [SXAddlHdr](#sxaddlhdr) **- hdr** | | +| 0004 | [FrtHeaderOld](#frtheaderold) **- frtHeaderOld** | | +| 0002 | USHORT **- rt** | 0x0864 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0001 | BYTE **- sxc** | 0x03 | +| 0001 | BYTE **- sxd** | 0x02 | +| 0006 | reserved **- reserved1** | 0x000000000000 | +| 0004 | LONG **- citmGhostMax** | 0xFFFFFFFF | +| 0001 | BYTE **- bVerCacheLastRefresh** | 0x02 | +| 0001 | BYTE **- bVerCacheRefreshableMin** | 0x00 | +| 0008 | [DateAsNum](#dateasnum) **- numDateCopy** | | +| 0008 | Double **- dateNum** | 0x40E355907CBEB8CE | +| 0002 | USHORT **- reserved2** | 0x0000 | + +Figure 135: Structure of SXAddl + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**hdr:** An SXAddlHdr structure that specifies header information for this SXAddl record. + +**hdr.sxc:** 0x03 specifies the current [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) as an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + +**hdr.sxd:** 0x02 specifies the type of record contained in the **data** field of the containing SXAddl record. See class for more information. This value specifies that the type of this SXAddl record is SXAddl_SXCCache_SXDVer10Info. + +**citmGhostMax:** 0xFFFFFFFF specifies that the number of unused [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) to allow before discarding those that are unused is not determined by the file; instead, the application optimizes the number of unused cache items at run time. + +**bVerCacheLastRefresh:** 0x02 specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) with which the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) was last refreshed. + +**bVerCacheRefreshableMin:** 0x00 specifies the lowest data functionality level with which the application is allowed to [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) the PivotCache. + +**numDateCopy:** Specifies the date and time when the PivotCache was last refreshed. + +**numDateCopy.dateNum:** 0x40E355907CBEB8CE specifies a DateAsNum structure which indicates that this PivotCache was last refreshed on May 28th, 2008 at 12:21PM. + +### PivotTable: SXAddl 3 + +The next record in this example, [SXAddl](#sxaddl), specifies additional information for this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 000C | [SXAddl_SXCCache_SXDEnd](#sxaddl_sxccache_sxdend) **- SXAddl** | | +| 0006 | [SXAddlHdr](#sxaddlhdr) **- hdr** | | +| 0004 | [FrtHeaderOld](#frtheaderold) **- frtHeaderOld** | | +| 0002 | USHORT **- rt** | 0x0864 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0001 | BYTE **- sxc** | 0x03 | +| 0001 | BYTE **- sxd** | 0xFF | +| 0006 | reserved **- reserved** | 0x000000000000 | + +Figure 136: Structure of SXAddl + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**hdr:** An SXAddlHdr structure that specifies header information for this SXAddl record. + +**hdr.sxc:** 0x03 specifies the current [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) as an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + +**hdr.sxd:** 0xFF specifies the type of record contained in the **data** field of the containing SXAddl record. See class for more information. This value specifies that the type of this SXAddl record is SXAddl_SXCCache_SXDEnd. + +### PivotTable: SxView + +The next record in this example, [SxView](#sxview), specifies the top-level [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) information for this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0042 | SxView **- SxView** | | +| 0008 | [Ref8U](#ref8u) **- ref** | | +| 0002 | [RwU](#rwu) **- rwFirst** | | +| 0002 | USHORT **- rw** | 0x0002 | +| 0002 | RwU **- rwLast** | | +| 0002 | USHORT **- rw** | 0x000A | +| 0002 | [ColU](#colu) **- colFirst** | | +| 0002 | USHORT **- col** | 0x0000 | +| 0002 | ColU **- colLast** | | +| 0002 | USHORT **- col** | 0x0002 | +| 0002 | RwU **- rwFirstHead** | | +| 0002 | USHORT **- rw** | 0x0004 | +| 0002 | RwU **- rwFirstData** | | +| 0002 | USHORT **- rw** | 0x0004 | +| 0002 | ColU **- colFirstData** | | +| 0002 | USHORT **- col** | 0x0002 | +| 0002 | SHORT **- iCache** | 0x0000 | +| 0002 | SHORT **- reserved** | 0x0000 | +| 0002 | [SXAxis](#sxaxis) **- sxaxis4Data** | | +| 1 bit | USHORT **- sxaxisRw** | 0x1 | +| 1 bit | USHORT **- sxaxisCol** | 0x0 | +| 1 bit | USHORT **- sxaxisPage** | 0x0 | +| 1 bit | USHORT **- sxaxisData** | 0x0 | +| 12 bits | USHORT **- reserved** | 0x000 | +| 0002 | SHORT **- ipos4Data** | 0xFFFF | +| 0002 | SHORT **- cDim** | 0x0005 | +| 0002 | SHORT **- cDimRw** | 0x0002 | +| 0002 | SHORT **- cDimCol** | 0x0000 | +| 0002 | SHORT **- cDimPg** | 0x0001 | +| 0002 | SHORT **- cDimData** | 0x0001 | +| 0002 | USHORT **- cRw** | 0x0007 | +| 0002 | USHORT **- cCol** | 0x0001 | +| 1 bit | USHORT **- fRwGrand** | 0x1 | +| 1 bit | USHORT **- fColGrand** | 0x1 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fAutoFormat** | 0x1 | +| 1 bit | USHORT **- fAtrNum** | 0x0 | +| 1 bit | USHORT **- fAtrFnt** | 0x0 | +| 1 bit | USHORT **- fAtrAlc** | 0x0 | +| 1 bit | USHORT **- fAtrBdr** | 0x0 | +| 1 bit | USHORT **- fAtrPat** | 0x0 | +| 1 bit | USHORT **- fAtrProc** | 0x1 | +| 6 bits | USHORT **- unused2** | 0x00 | +| 0002 | [AutoFmt8](#autofmt8) **- itblAutoFmt** | 0x0001 | +| 0002 | USHORT **- cchTableName** | 0x0010 | +| 0002 | USHORT **- cchDataName** | 0x0004 | +| 0011 | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- stTable** | OrdersPivotTable | +| 0005 | XLUnicodeStringNoCch **- stData** | Data | + +Figure 137: Structure of SxView + +**ref:** A structure that specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) (A2:C11) that specifies the location of the PivotTable view. + +**ref.rwFirst:** A structure that specifies the first row in the range. + +**ref.rwFirst.rw:** 0x0002 specifies the third row (row 3) in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**ref.rwLast:** A structure that specifies the last row in the range. + +**ref.rwLast.rw:** 0x000A specifies the eleventh row (row 11) in the sheet. + +**ref.colFirst:** A structure that specifies the first column in the range. + +**ref.colFirst.col:** 0x0000 specifies the first column (column A) in the sheet. + +**ref.colLast:** A structure that specifies the last column in the range. + +**ref.colLast.col:** 0x0002 specifies the third column (column C) in the sheet. + +**rwFirstHead:** A structure that specifies the first PivotTable [**header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38). + +**rwFirstHead.rw:** 0x0004 specifies the fifth row (row 5) in the sheet. + +**rwFirstData:** A structure that specifies the first row that contains PivotTable data. + +**rwFirstData.rw:** 0x0004 specifies the fifth row (row 5) in the sheet. + +**colFirstData:** A structure that specifies the first column that contains PivotTable data. + +**colFirstData.col:** 0x0002 specifies the third column (column C) in the sheet. + +**iCache:** 0x0000 specifies the index of the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) for this PivotTable, which is the first stream in the \_SX_DB_CUR storage. + +**sxaxis4Data:** A structure that specifies the default axis for data fields. Only the **sxaxisRow** and **sxaxisCol** bits of the structure are shown, as the rest of the bits are 0. + +**sxaxis4Data.sxaxisRw:** 0x1 specifies that the [row axis](#Section_3f46e7207706400cba9473cb829f869a) is the default axis for data fields. + +**sxaxis4Data.sxaxisCol:** 0x0 is required in this field because **sxaxisRw** is 0x1. + +**sxaxis4Data.sxaxisPage:** 0x0 is required in this field because **sxaxisRw** is 0x1. + +**sxaxis4Data.sxaxisData:** 0x0 is required in this field because **sxaxisRw** is 0x1. + +**ipos4Data:** 0xFFFF (-1) specifies that the data field is in the default position. + +**cDim:** 0x0005 specifies that there are five fields in the database. + +**cDimRw:** 0x0002 specifies that there are two fields on the row axis. + +**cDimCol:** 0x0000 specifies that there are no fields on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). + +**cDimPg:** 0x0001 specifies that there is one field on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**cDimData:** 0x0001 specifies that there is one field on the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**cRw:** 0x0007 specifies that there are seven [pivot lines](#Section_76610990666f492791b6d2280f607464) in the [row area](#Section_5594c95e6819461e80706f4b4fdfa091) of this PivotTable view. + +**cCol:** 0x0001 specifies that there is one pivot line in the [column area](#Section_03aced8c25864e83982a1e3551a563d6) of this PivotTable view. + +**fRwGrand:** 0x1 specifies that this PivotTable view contains [**grand totals**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7) for rows. + +**fColGrand:** 0x1 specifies that this PivotTable view contains grand totals for columns. + +**fAutoFormat:** 0x1 specifies that this PivotTable has [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f) applied. + +**fAtrNum:** 0x0 specifies that this PivotTable does not have AutoFormat applied for numbers. + +**fAtrFnt:** 0x0 specifies that this PivotTable does not have AutoFormat applied for fonts. + +**fAtrAlc:** 0x0 specifies that this PivotTable does not have AutoFormat applied for alignment. + +**fAtrBdr:** 0x0 specifies that this PivotTable does not have AutoFormat applied for [**borders**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c). + +**fAtrPat:** 0x0 specifies that this PivotTable does not have AutoFormat applied for patterns. + +**fAtrProc:** 0x1 specifies that this PivotTable has AutoFormat applied for width and height. + +**itblAutoFmt:** XL8_ITBLCLASSIC1 specifies that this PivotTable is using the "Classic" style of AutoFormat. + +**cchTableName:** 0x0010 specifies that the string in **stTable** has 16 characters. + +**cchDataName:** 0x0004 specifies that the string in **stData** has four characters. + +**stTable:** Specifies that the name of this PivotTable view is "OrdersPivotTable". + +**stData:** Specifies that the name of the data [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) is "Data". + +### PivotTable: Sxvd 1 + +The next record in this example, [Sxvd](#sxvd), specifies the first [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) ("CustomerName") in the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|-----------| +| 000A | Sxvd **- Sxvd** | | +| 0002 | [SXAxis](#sxaxis) **- sxaxis** | | +| 1 bit | USHORT **- sxaxisRw** | 0x1 | +| 1 bit | USHORT **- sxaxisCol** | 0x0 | +| 1 bit | USHORT **- sxaxisPage** | 0x0 | +| 1 bit | USHORT **- sxaxisData** | 0x0 | +| 12 bits | USHORT **- reserved** | 0x000 | +| 0002 | USHORT **- cSub** | 0x0001 | +| 1 bit | USHORT **- fDefault** | 0x1 | +| 1 bit | USHORT **- fSum** | 0x0 | +| 1 bit | USHORT **- fCounta** | 0x0 | +| 1 bit | USHORT **- fAverage** | 0x0 | +| 1 bit | USHORT **- fMax** | 0x0 | +| 1 bit | USHORT **- fMin** | 0x0 | +| 1 bit | USHORT **- fProduct** | 0x0 | +| 1 bit | USHORT **- fCount** | 0x0 | +| 1 bit | USHORT **- fStdev** | 0x0 | +| 1 bit | USHORT **- fStdevp** | 0x0 | +| 1 bit | USHORT **- fVariance** | 0x0 | +| 1 bit | USHORT **- fVariancep** | 0x0 | +| 4 bits | USHORT **- reserved** | 0x0 | +| 0002 | SHORT **- cItm** | 0x0006 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 138: Structure of Sxvd + +**sxaxis:** Specifies the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) to which this pivot field belongs. + +**sxaxis.sxaxisRw:** 0x1 specifies that this pivot field refers to the row axis. + +**sxaxis.sxaxisCol:** 0x0 specifies that this pivot field does not refer to the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). + +**sxaxis.sxaxisPage:** 0x0 specifies that this pivot field does not refer to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**sxaxis.sxaxisData:** 0x0 specifies that this pivot field does not refer to the [value axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**cSub:** 0x0001 specifies that one subtotal [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) is used for this pivot field. + +**fDefault:** 0x1 specifies that the default subtotal function is applied. + +**fSum:** 0x0 specifies that the **sum** subtotal function is not displayed. + +**fCounta:** 0x0 specifies that the **count** subtotal function is not displayed. + +**fAverage:** 0x0 specifies that the **average** subtotal function is not displayed. + +**fMax:** 0x0 specifies that the **max** subtotal function is not displayed. + +**fMin:** 0x0 specifies that the **min** subtotal function is not displayed. + +**fProduct:** 0x0 specifies that the **sum** subtotal function is not displayed. + +**fCount:** 0x0 specifies that the **count numbers** subtotal function is not displayed. + +**fStdev:** 0x0 specifies that the **standard deviation** subtotal function is not displayed. + +**fStdevp:** 0x0 specifies that the **standard deviation population** subtotal function is not displayed. + +**fVariance:** 0x0 specifies that the **variance** subtotal function is not displayed. + +**fVariancep:** 0x0 specifies that the **variance population** subtotal function is not displayed. + +**cItm:** 0x0006 specifies that there are six [pivot items](#Section_58891cc5dd9b4293a97831070779524f) for this pivot field. + +**cchName:** 0xFFFF specifies that the caption of this pivot field is NULL, which means that the name is inherited from the associated [cache field](#Section_6497eb794042445780e75959c9f0583c) instead. + +### PivotTable: SXVI 1 + +The next record in this example, [SXVI](#sxvi), specifies the first [pivot item](#Section_58891cc5dd9b4293a97831070779524f) ("Antonio Moreno Taquería") of this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) ("CustomerName"). This item is filtered out and not visible in the PivotTable report. + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|-----------| +| 0008 | SXVI **- SXVI** | | +| 0002 | SHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fHideDetail** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFormula** | 0x0 | +| 1 bit | USHORT **- fMissing** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 0002 | SHORT **- iCache** | 0x0001 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 139: Structure of SXVI + +**itmType:** 0x0000 specifies that the pivot item is a regular data value. + +**fHidden:** 0x0 specifies that the pivot item is not hidden. + +**fHideDetail:** 0x0 specifies that the pivot item is not collapsed (see [Collapsing](#Section_1c9375b4cc664783821f6b2b49bac169)). + +**fFormula:** 0x0 specifies that the pivot item is not a [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b). + +**fMissing:** 0x0 specifies that the pivot item exists in the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + +**iCache:** This field specifies a [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in the [cache field](#Section_6497eb794042445780e75959c9f0583c) that is associated with this pivot field ("CustomerName"). The index 0x01 specifies the second [SXString](#sxstring) ("Antonio Moreno Taquería") in the collection following the [SXFDB](#sxfdb) with **stFieldName**="CustomerName". + +**cchName:** 0xFFFF specifies that this pivot item does not have a caption. + +### PivotTable: SXVI 2 + +The next record in this example, [SXVI](#sxvi), specifies the [pivot item](#Section_58891cc5dd9b4293a97831070779524f) "Island Trading" in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|-----------| +| 0008 | SXVI **- SXVI** | | +| 0002 | SHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fHideDetail** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFormula** | 0x0 | +| 1 bit | USHORT **- fMissing** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 0002 | SHORT **- iCache** | 0x0003 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 140: Structure of SXVI + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**itmType:** 0x0000 specifies that this pivot item is a regular data value. + +**fHidden:** 0x0 specifies that this pivot item is not hidden. + +**fHideDetail:** 0x0 specifies that this pivot item is not collapsed (see [Collapsing](#Section_1c9375b4cc664783821f6b2b49bac169)). + +**fFormula:** 0x0 specifies that this pivot item is not a [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b). + +**fMissing:** 0x0 specifies that this pivot item exists in the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + +**iCache:** The index 0x03 specifies the fourth [SXString](#sxstring) ("Island Trading") in the collection following the [SXFDB](#sxfdb) with **stFieldName**="CustomerName". + +### PivotTable: SXVI 3 + +The next record in this example, [SXVI](#sxvi), specifies the [pivot item](#Section_58891cc5dd9b4293a97831070779524f) "Richter Supermarkt" in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|-----------| +| 0008 | SXVI **- SXVI** | | +| 0002 | SHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fHideDetail** | 0x1 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFormula** | 0x0 | +| 1 bit | USHORT **- fMissing** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 0002 | SHORT **- iCache** | 0x0002 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 141: Structure of SXVI + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fHideDetail:** 0x1 specifies that the pivot item is collapsed (see [Collapsing](#Section_1c9375b4cc664783821f6b2b49bac169)). + +### PivotTable: SXVI 4 + +The next record in this example, [SXVI](#sxvi), specifies the Total row in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|-----------| +| 0008 | SXVI **- SXVI** | | +| 0002 | SHORT **- itmType** | 0x0001 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fHideDetail** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFormula** | 0x0 | +| 1 bit | USHORT **- fMissing** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 0002 | SHORT **- iCache** | 0xFFFF | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 142: Structure of SXVI + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**itmType:** 0x0001 specifies that the [pivot item](#Section_58891cc5dd9b4293a97831070779524f) is a subtotal. + +**iCache:** 0xFFFF specifies that the pivot item does not refer to any [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0). + +### PivotTable: SXVDEx 1 + +The next record in this example, [SXVDEx](#sxvdex), specifies the extended information about this ("CustomerName") [pivot field](#Section_1edf7f2294084945b2de56526c14fca5). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------------|------------| +| 0014 | SXVDEx **- SXVDEx** | | +| 1 bit | USHORT **- fShowAllItems** | 0x0 | +| 1 bit | USHORT **- fDragToRow** | 0x1 | +| 1 bit | USHORT **- fDragToColumn** | 0x1 | +| 1 bit | USHORT **- fDragToPage** | 0x1 | +| 1 bit | USHORT **- fDragToHide** | 0x1 | +| 1 bit | USHORT **- fNotDragToData** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 1 bit | USHORT **- fAutoSort** | 0x0 | +| 1 bit | USHORT **- fAscendSort** | 0x1 | +| 1 bit | USHORT **- fAutoShow** | 0x0 | +| 1 bit | USHORT **- fTopAutoShow** | 0x1 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 1 bit | USHORT **- fPageBreaksBetweenItems** | 0x0 | +| 1 bit | USHORT **- fHideNewItems** | 0x0 | +| 5 bits | USHORT **- reserved3** | 0x00 | +| 1 bit | USHORT **- fOutline** | 0x0 | +| 1 bit | USHORT **- fInsertBlankRow** | 0x0 | +| 1 bit | USHORT **- fSubtotalAtTop** | 0x0 | +| 8 bits | USHORT **- citmAutoShow** | 0x0A | +| 0002 | SHORT **- isxdiAutoSort** | 0xFFFF | +| 0002 | SHORT **- isxdiAutoShow** | 0xFFFF | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x0000 | +| 000A | [SXVDEx_Opt](#sxvdex_opt) **- subName** | | +| 0002 | USHORT **- cchSubName** | 0xFFFF | +| 0004 | ULONG **- reserved1** | 0x00000000 | +| 0004 | ULONG **- reserved2** | 0x00000000 | + +Figure 143: Structure of SXVDEx + +**fShowAllItems:** 0x0 specifies that all [pivot items](#Section_58891cc5dd9b4293a97831070779524f) in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) are not displayed. + +**fDragToRow:** 0x1 specifies that the pivot field can be dragged to the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +**fDragToColumn:** 0x1 specifies that the pivot field can be placed on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). + +**fDragToPage:** 0x1 specifies that the pivot field can be dragged to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**fDragToHide:** 0x1 specifies that the pivot field can be removed from the PivotTable view. + +**fNotDragToData:** 0x0 specifies that the pivot field can be dragged to the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**fServerBased:** 0x0 is required because the corresponding [cache field](#Section_6497eb794042445780e75959c9f0583c) is not server-based. + +**fAutoSort:** 0x0 specifies that AutoSort is not enabled for this pivot field. + +**fAscendSort:** 0x1 specifies that AutoSort order is set to ascending, and if AutoSort is enabled, this pivot field is sorted in ascending order. + +**fAutoShow:** 0x0 specifies that [**AutoShow**](#gt_42126923-0aed-4547-8761-95a0ce2badde) is not enabled on this pivot field. + +**fTopAutoShow:** 0x1 specifies that AutoShow is set to show top 10 values rather than bottom 10 values. If AutoShow is enabled, this PivotTable view uses top 10 values for AutoShow (filter). + +**fCalculatedField:** 0x0 specifies that this pivot field is not a [calculated field](#Section_4594f2ac815740b381142e77ba8efb7d). + +**fPageBreaksBetweenItems:** 0x0 specifies that a [**page break**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871) is not set between different pivot items in the PivotTable view during printing. + +**fHideNewItems:** 0x0 specifies that new pivot items that are added to the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) are displayed automatically in the PivotTable view when the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) is refreshed. + +**fOutline:** 0x0 specifies that this pivot field is not displayed in [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) format. + +**fInsertBlankRow:** 0x0 specifies that a blank line is not inserted between different pivot items in the PivotTable view. + +**fSubtotalAtTop:** 0x0 specifies that subtotals are displayed at the bottom of the list of pivot items for this pivot field. + +**citmAutoShow:** 0x0A specifies that 10 pivot items are set to display for the top *n* AutoShow (filter). + +**isxdiAutoSort:** 0xFFFF specifies that AutoSort uses current [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679). + +**isxdiAutoShow:** 0xFFFF specifies that AutoShow is not enabled for this pivot field. + +**subName:** Specifies the name of the aggregate [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) used to calculate this pivot field's subtotals. + +**subName.cchSubName:** 0xFFFF specifies that there is no aggregate function to use. + +### PivotTable: Sxvd 2 + +The next record in this example, [Sxvd](#sxvd), specifies the pageField ("OrderDate") of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|-----------| +| 000A | Sxvd **- Sxvd** | | +| 0002 | [SXAxis](#sxaxis) **- sxaxis** | | +| 1 bit | USHORT **- sxaxisRw** | 0x0 | +| 1 bit | USHORT **- sxaxisCol** | 0x0 | +| 1 bit | USHORT **- sxaxisPage** | 0x1 | +| 1 bit | USHORT **- sxaxisData** | 0x0 | +| 12 bits | USHORT **- reserved** | 0x000 | +| 0002 | USHORT **- cSub** | 0x0001 | +| 1 bit | USHORT **- fDefault** | 0x1 | +| 1 bit | USHORT **- fSum** | 0x0 | +| 1 bit | USHORT **- fCounta** | 0x0 | +| 1 bit | USHORT **- fAverage** | 0x0 | +| 1 bit | USHORT **- fMax** | 0x0 | +| 1 bit | USHORT **- fMin** | 0x0 | +| 1 bit | USHORT **- fProduct** | 0x0 | +| 1 bit | USHORT **- fCount** | 0x0 | +| 1 bit | USHORT **- fStdev** | 0x0 | +| 1 bit | USHORT **- fStdevp** | 0x0 | +| 1 bit | USHORT **- fVariance** | 0x0 | +| 1 bit | USHORT **- fVariancep** | 0x0 | +| 4 bits | USHORT **- reserved** | 0x0 | +| 0002 | SHORT **- cItm** | 0x0015 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 144: Structure of Sxvd + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**sxaxis:** This field specifies the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) upon which this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) exists. + +**sxaxis.sxaxisRw:** 0x0 specifies that this pivot field does not refer to the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +**sxaxis.sxaxisCol:** 0x0 specifies that this pivot field does not refer to the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). + +**sxaxis.sxaxisPage:** 0x1 specifies that this pivot field refers to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**sxaxis.sxaxisData:** 0x0 specifies that this pivot field does not refer to the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**cItm:** 0x0015 specifies that this pivot field contains 21 [pivot items](#Section_58891cc5dd9b4293a97831070779524f). + +### PivotTable: SXVI 5 + +The next record in this example, [SXVI](#sxvi), specifies the first [pivot item](#Section_58891cc5dd9b4293a97831070779524f) (5/6/1997) of this page field ("OrderDate"). This pivot item is filtered out and not displayed in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|-----------| +| 0008 | SXVI **- SXVI** | | +| 0002 | SHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- fHidden** | 0x1 | +| 1 bit | USHORT **- fHideDetail** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFormula** | 0x0 | +| 1 bit | USHORT **- fMissing** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 0002 | SHORT **- iCache** | 0x0000 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 145: Structure of SXVI + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fHidden:** 0x1 specifies that this pivot item is hidden (filtered out). + +### PivotTable: SXVI 6 + +The next record in this example, [SXVI](#sxvi), specifies the second [pivot item](#Section_58891cc5dd9b4293a97831070779524f) (11/28/1997) of this page field ("OrderDate"). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|-----------| +| 0008 | SXVI **- SXVI** | | +| 0002 | SHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- fHidden** | 0x1 | +| 1 bit | USHORT **- fHideDetail** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFormula** | 0x0 | +| 1 bit | USHORT **- fMissing** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 0002 | SHORT **- iCache** | 0x000F | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 146: Structure of SXVI + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fHidden:** 0x1 specifies that the pivot item is hidden. Because this pivot item is one of the items showing in the filter in the [page area](#Section_f10ef7d86c044d35a5830d6f2ce92063) but is not actually displayed in the report, it is marked as hidden. + +### PivotTable: SXVI 7 + +The next record in this example, [SXVI](#sxvi), specifies the third [pivot item](#Section_58891cc5dd9b4293a97831070779524f) (12/23/1997) of this page field ("OrderDate"). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|-----------| +| 0008 | SXVI **- SXVI** | | +| 0002 | SHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fHideDetail** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFormula** | 0x0 | +| 1 bit | USHORT **- fMissing** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 0002 | SHORT **- iCache** | 0x0010 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 147: Structure of SXVI + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fHidden:** 0x0 specifies that the pivot item is not hidden. + +### PivotTable: SXVDEx 2 + +The next record in this example, [SXVDEx](#sxvdex), specifies extended information about this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) ("OrderDate"). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------------|------------| +| 0014 | SXVDEx **- SXVDEx** | | +| 1 bit | USHORT **- fShowAllItems** | 0x0 | +| 1 bit | USHORT **- fDragToRow** | 0x1 | +| 1 bit | USHORT **- fDragToColumn** | 0x1 | +| 1 bit | USHORT **- fDragToPage** | 0x1 | +| 1 bit | USHORT **- fDragToHide** | 0x1 | +| 1 bit | USHORT **- fNotDragToData** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 1 bit | USHORT **- fAutoSort** | 0x0 | +| 1 bit | USHORT **- fAscendSort** | 0x1 | +| 1 bit | USHORT **- fAutoShow** | 0x0 | +| 1 bit | USHORT **- fTopAutoShow** | 0x1 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 1 bit | USHORT **- fPageBreaksBetweenItems** | 0x0 | +| 1 bit | USHORT **- fHideNewItems** | 0x0 | +| 5 bits | USHORT **- reserved3** | 0x00 | +| 1 bit | USHORT **- fOutline** | 0x0 | +| 1 bit | USHORT **- fInsertBlankRow** | 0x0 | +| 1 bit | USHORT **- fSubtotalAtTop** | 0x0 | +| 8 bits | USHORT **- citmAutoShow** | 0x0A | +| 0002 | SHORT **- isxdiAutoSort** | 0xFFFF | +| 0002 | SHORT **- isxdiAutoShow** | 0xFFFF | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x000E | +| 000A | [SXVDEx_Opt](#sxvdex_opt) **- subName** | | +| 0002 | USHORT **- cchSubName** | 0xFFFF | +| 0004 | ULONG **- reserved1** | 0x00000000 | +| 0004 | ULONG **- reserved2** | 0x00000000 | + +Figure 148: Structure of SXVDEx + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**ifmt:** Specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) of this pivot field. + +**ifmt.ifmt:** 0x000E specifies that the format of this [pivot item](#Section_58891cc5dd9b4293a97831070779524f) is the built-in format **mm-dd-yy**. + +### PivotTable: Sxvd 3 + +The next record in this example, [Sxvd](#sxvd), specifies the second field in the [row axis](#Section_3f46e7207706400cba9473cb829f869a), "ProductName". + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|-----------| +| 000A | Sxvd **- Sxvd** | | +| 0002 | [SXAxis](#sxaxis) **- sxaxis** | | +| 1 bit | USHORT **- sxaxisRw** | 0x1 | +| 1 bit | USHORT **- sxaxisCol** | 0x0 | +| 1 bit | USHORT **- sxaxisPage** | 0x0 | +| 1 bit | USHORT **- sxaxisData** | 0x0 | +| 12 bits | USHORT **- reserved** | 0x000 | +| 0002 | USHORT **- cSub** | 0x0001 | +| 1 bit | USHORT **- fDefault** | 0x1 | +| 1 bit | USHORT **- fSum** | 0x0 | +| 1 bit | USHORT **- fCounta** | 0x0 | +| 1 bit | USHORT **- fAverage** | 0x0 | +| 1 bit | USHORT **- fMax** | 0x0 | +| 1 bit | USHORT **- fMin** | 0x0 | +| 1 bit | USHORT **- fProduct** | 0x0 | +| 1 bit | USHORT **- fCount** | 0x0 | +| 1 bit | USHORT **- fStdev** | 0x0 | +| 1 bit | USHORT **- fStdevp** | 0x0 | +| 1 bit | USHORT **- fVariance** | 0x0 | +| 1 bit | USHORT **- fVariancep** | 0x0 | +| 4 bits | USHORT **- reserved** | 0x0 | +| 0002 | SHORT **- cItm** | 0x0007 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 149: Structure of Sxvd + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**cItm:** 0x0007 specifies that this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) has seven [pivot items](#Section_58891cc5dd9b4293a97831070779524f). + +### PivotTable: Sxvd 4 + +The next record in this example, [Sxvd](#sxvd), specifies the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) "UnitPrice", which is not in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|-----------| +| 000A | Sxvd **- Sxvd** | | +| 0002 | [SXAxis](#sxaxis) **- sxaxis** | | +| 1 bit | USHORT **- sxaxisRw** | 0x0 | +| 1 bit | USHORT **- sxaxisCol** | 0x0 | +| 1 bit | USHORT **- sxaxisPage** | 0x0 | +| 1 bit | USHORT **- sxaxisData** | 0x0 | +| 12 bits | USHORT **- reserved** | 0x000 | +| 0002 | USHORT **- cSub** | 0x0001 | +| 1 bit | USHORT **- fDefault** | 0x1 | +| 1 bit | USHORT **- fSum** | 0x0 | +| 1 bit | USHORT **- fCounta** | 0x0 | +| 1 bit | USHORT **- fAverage** | 0x0 | +| 1 bit | USHORT **- fMax** | 0x0 | +| 1 bit | USHORT **- fMin** | 0x0 | +| 1 bit | USHORT **- fProduct** | 0x0 | +| 1 bit | USHORT **- fCount** | 0x0 | +| 1 bit | USHORT **- fStdev** | 0x0 | +| 1 bit | USHORT **- fStdevp** | 0x0 | +| 1 bit | USHORT **- fVariance** | 0x0 | +| 1 bit | USHORT **- fVariancep** | 0x0 | +| 4 bits | USHORT **- reserved** | 0x0 | +| 0002 | SHORT **- cItm** | 0x0000 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 150: Structure of Sxvd + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**sxaxis:** Specifies the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) axis that this pivot field belongs to. + +**sxaxis.sxaxisRw:** 0x0 specifies that this pivot field does not refer to the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +**sxaxis.sxaxisCol:** 0x0 specifies that this pivot field does not refer to the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). + +**sxaxis.sxaxisPage:** 0x0 specifies that this pivot field does not refer to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**sxaxis.sxaxisData:** 0x0 specifies that this pivot field does not refer to the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**fDefault:** 0x1 specifies that the default subtotal is applied. + +**cItm: cItm:** 0x0000 specifies that there are no [pivot items](#Section_58891cc5dd9b4293a97831070779524f) for this pivot field. This is because this pivot field is a numeric field, and cache items do not need to be stored for numeric fields. + +Records following this record, and before the next [SXVDEx](#sxvdex) record, are omitted for brevity. + +### PivotTable: SXVDEx 3 + +The next record in this example, [SXVDEx](#sxvdex), specifies extended information about this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) ("UnitPrice"). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------------|------------| +| 0014 | SXVDEx **- SXVDEx** | | +| 1 bit | USHORT **- fShowAllItems** | 0x0 | +| 1 bit | USHORT **- fDragToRow** | 0x1 | +| 1 bit | USHORT **- fDragToColumn** | 0x1 | +| 1 bit | USHORT **- fDragToPage** | 0x1 | +| 1 bit | USHORT **- fDragToHide** | 0x1 | +| 1 bit | USHORT **- fNotDragToData** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 1 bit | USHORT **- fAutoSort** | 0x0 | +| 1 bit | USHORT **- fAscendSort** | 0x1 | +| 1 bit | USHORT **- fAutoShow** | 0x0 | +| 1 bit | USHORT **- fTopAutoShow** | 0x1 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 1 bit | USHORT **- fPageBreaksBetweenItems** | 0x0 | +| 1 bit | USHORT **- fHideNewItems** | 0x0 | +| 5 bits | USHORT **- reserved3** | 0x00 | +| 1 bit | USHORT **- fOutline** | 0x0 | +| 1 bit | USHORT **- fInsertBlankRow** | 0x0 | +| 1 bit | USHORT **- fSubtotalAtTop** | 0x0 | +| 8 bits | USHORT **- citmAutoShow** | 0x0A | +| 0002 | SHORT **- isxdiAutoSort** | 0xFFFF | +| 0002 | SHORT **- isxdiAutoShow** | 0xFFFF | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x002C | +| 000A | [SXVDEx_Opt](#sxvdex_opt) **- subName** | | +| 0002 | USHORT **- cchSubName** | 0xFFFF | +| 0004 | ULONG **- reserved1** | 0x00000000 | +| 0004 | ULONG **- reserved2** | 0x00000000 | + +Figure 151: Structure of SXVDEx + +**fShowAllItems:** 0x0 specifies that [pivot items](#Section_58891cc5dd9b4293a97831070779524f) that do not currently exist in the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) are not displayed. + +**fDragToRow:** 0x1 specifies that this pivot field can be placed on the [row axis](#Section_3f46e7207706400cba9473cb829f869a) of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +**fDragToColumn:** 0x1 specifies that this pivot field can be placed on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) of this PivotTable view. + +**fDragToPage:** 0x1 specifies that this pivot field can be dragged to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of this PivotTable view. + +**fDragToHide:** 0x1 specifies that this pivot field can be removed from the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) view. + +**fNotDragToData:** 0x0 specifies that this pivot field can be placed on the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060) of this PivotTable view. + +**fCalculatedField:** 0x0 specifies that this pivot field is not a calculated field. + +**fOutline:** 0x0 specifies that this pivot field is not displayed in [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) format. + +**ifmt:** Specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) of this pivot field. + +**ifmt.ifmt:** 0x002C specifies that this field has the **\_(\$\* \#,##0.00\_);\_(\$\* (#,##0.00);\_(\$\* "-"??\_);\_(@\_)** number format applied. + +### PivotTable: Sxvd 5 + +The next record in this example, [Sxvd](#sxvd), specifies the data field ("Quantity") in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|-----------| +| 000A | Sxvd **- Sxvd** | | +| 0002 | [SXAxis](#sxaxis) **- sxaxis** | | +| 1 bit | USHORT **- sxaxisRw** | 0x0 | +| 1 bit | USHORT **- sxaxisCol** | 0x0 | +| 1 bit | USHORT **- sxaxisPage** | 0x0 | +| 1 bit | USHORT **- sxaxisData** | 0x1 | +| 12 bits | USHORT **- reserved** | 0x000 | +| 0002 | USHORT **- cSub** | 0x0001 | +| 1 bit | USHORT **- fDefault** | 0x1 | +| 1 bit | USHORT **- fSum** | 0x0 | +| 1 bit | USHORT **- fCounta** | 0x0 | +| 1 bit | USHORT **- fAverage** | 0x0 | +| 1 bit | USHORT **- fMax** | 0x0 | +| 1 bit | USHORT **- fMin** | 0x0 | +| 1 bit | USHORT **- fProduct** | 0x0 | +| 1 bit | USHORT **- fCount** | 0x0 | +| 1 bit | USHORT **- fStdev** | 0x0 | +| 1 bit | USHORT **- fStdevp** | 0x0 | +| 1 bit | USHORT **- fVariance** | 0x0 | +| 1 bit | USHORT **- fVariancep** | 0x0 | +| 4 bits | USHORT **- reserved** | 0x0 | +| 0002 | SHORT **- cItm** | 0x0000 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 152: Structure of Sxvd + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**sxaxis:** This field specifies the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) that this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) is on. + +**sxaxis.sxaxisRw:** 0x0 specifies that this pivot field does not refer to the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +**sxaxis.sxaxisCol:** 0x0 specifies that this pivot field does not refer to the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). + +**sxaxis.sxaxisPage:** 0x0 specifies that this pivot field does not refer to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**sxaxis.sxaxisData:** 0x1 specifies that this pivot field refers to the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**cItm:** 0x0000 specifies that there are no [pivot items](#Section_58891cc5dd9b4293a97831070779524f) for this pivot field. This is because this pivot field is a numeric field, and cache items do not need to be stored for numeric fields. + +Records following this record, and before the next [SXVDEx](#sxvdex) record, are omitted for brevity. + +### PivotTable: SXVDEx 4 + +The next record in this example, [SXVDEx](#sxvdex), specifies the extended information about this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) ("Quantity"). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------------|------------| +| 0014 | SXVDEx **- SXVDEx** | | +| 1 bit | USHORT **- fShowAllItems** | 0x0 | +| 1 bit | USHORT **- fDragToRow** | 0x1 | +| 1 bit | USHORT **- fDragToColumn** | 0x1 | +| 1 bit | USHORT **- fDragToPage** | 0x1 | +| 1 bit | USHORT **- fDragToHide** | 0x1 | +| 1 bit | USHORT **- fNotDragToData** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 1 bit | USHORT **- fAutoSort** | 0x0 | +| 1 bit | USHORT **- fAscendSort** | 0x1 | +| 1 bit | USHORT **- fAutoShow** | 0x0 | +| 1 bit | USHORT **- fTopAutoShow** | 0x1 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 1 bit | USHORT **- fPageBreaksBetweenItems** | 0x0 | +| 1 bit | USHORT **- fHideNewItems** | 0x0 | +| 5 bits | USHORT **- reserved3** | 0x00 | +| 1 bit | USHORT **- fOutline** | 0x0 | +| 1 bit | USHORT **- fInsertBlankRow** | 0x0 | +| 1 bit | USHORT **- fSubtotalAtTop** | 0x0 | +| 8 bits | USHORT **- citmAutoShow** | 0x0A | +| 0002 | SHORT **- isxdiAutoSort** | 0xFFFF | +| 0002 | SHORT **- isxdiAutoShow** | 0xFFFF | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x0000 | +| 000A | [SXVDEx_Opt](#sxvdex_opt) **- subName** | | +| 0002 | USHORT **- cchSubName** | 0xFFFF | +| 0004 | ULONG **- reserved1** | 0x00000000 | +| 0004 | ULONG **- reserved2** | 0x00000000 | + +Figure 153: Structure of SXVDEx + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**ifmt:** A field that specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) of this pivot field. + +**ifmt.ifmt:** 0x0000 specifies that the General number format is applied. + +### PivotTable: SxIvd + +The next record in this example, [SxIvd](#sxivd), specifies an array of references to [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5) on the [row axis](#Section_3f46e7207706400cba9473cb829f869a). Because **cDimRw** is 2 and **cDimCol** is 0 for the parent [SxView](#sxview), this contains an array of rows. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------------------|-----------| +| 0004 | SxIvd **- Sxivd** | | +| 0004 | rgSxivd **- rgSxivd** | | +| 0002 | [SxIvdRw](#sxivdrw) **- SxIvdRw\[0\]** | | +| 0002 | SHORT **- rw** | 0x0000 | +| 0002 | SxIvdRw **- SxIvdRw\[1\]** | | +| 0002 | SHORT **- rw** | 0x0002 | + +Figure 154: Structure of Sxivd + +**rgSxivd:** A field that specifies an array of references to pivot fields. + +**rgSxivd.SxIvdRw\[0\]:** A field that specifies a reference to a pivot field on the row axis. + +**rgSxivd.SxIvdRw\[0\].rw:** 0x0000 specifies the first pivot field. + +**rgSxivd.SxIvdRw\[1\]:** A field that specifies a reference to a pivot field on the row axis. + +**rgSxivd.SxIvdRw\[1\].rw:** 0x0002 specifies the third pivot field. + +### PivotTable: SXPI + +The next record in this example, [SXPI](#sxpi), specifies an array of [SXPI_Item](#sxpi_item) (information about the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) page item) structures that specify the [pivot items](#Section_58891cc5dd9b4293a97831070779524f) on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of this PivotTable. There is one item in the array because the **cDimPg** field of the [SxView](#sxview) record for the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) is 1. + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|-----------| +| 0006 | SXPI **- SXPI** | | +| 0006 | SXPI_Item **- rgsxpi** | | +| 0006 | SXPI_Item **- SXPI_Item\[0\]** | | +| 0002 | SHORT **- isxvd** | 0x0001 | +| 0002 | SHORT **- isxvi** | 0x7FFD | +| 0002 | SHORT **- idObj** | 0x0001 | + +Figure 155: Structure of SXPI + +**rgsxpi:** Specifies an array of page item information or SXPI_Item Structures. + +**rgsxpi.SXPI_Item\[0\]:** Specifies the first item in the [page area](#Section_f10ef7d86c044d35a5830d6f2ce92063). + +**rgsxpi.SXPI_Item\[0\].isxvd:** 0x0001 specifies the second [pivot field](#Section_1edf7f2294084945b2de56526c14fca5), "OrderDate". + +**rgsxpi.SXPI_Item\[0\].isxvi:** 0x7FFD specifies that all pivot items are used by the "OrderDate" pivot field. + +**rgsxpi.SXPI_Item\[0\].idObj:** 0x001 which specifies the object identifier of the [Obj](#obj) record with the page item drop-down arrow. + +### PivotTable: SXDI + +The next record in this example, [SXDI](#sxdi), specifies the [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679) "Quantity" for this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001E | SXDI **- SXDI** | | +| 0002 | SHORT **- isxvdData** | 0x0004 | +| 0002 | SHORT **- iiftab** | 0x0000 | +| 0002 | SHORT **- df** | 0x0000 | +| 0002 | SHORT **- isxvd** | 0x0000 | +| 0002 | SHORT **- isxvi** | 0x0000 | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x0000 | +| 0002 | USHORT **- cchName** | 0x000F | +| 0010 | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- stName** | Sum Of Quantity | + +Figure 156: Structure of SXDI + +**isxvdData:** A field that specifies a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) in the form of an index in the collection of pivot fields specified by [SXFDB](#sxfdb). The value 0x04 specifies the fifth pivot field, "Quantity". + +**iiftab:** 0x0000 specifies the "Sum of values" **aggregation** [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d). + +**df:** 0x0000 specifies that this data item is to be displayed as its raw value with no calculation applied. + +**isxvd:** 0x0000 is required because **df** is 0x0000. + +**isxvi:** 0x0000 is required because **df** is 0x0000. + +**cchName:** 0x000F specifies that the length of this data item is 15 characters. + +**stName:** "Sum Of Quantity" specifies the name of this data item. + +### PivotTable: SXLI 1 + +Because the **cRw** and **cCol** fields of the [SxView](#sxview) record are greater than zero, this example contains two [SXLI](#sxli) records. This first SXLI specifies the [pivot lines](#Section_76610990666f492791b6d2280f607464) for the [row area](#Section_5594c95e6819461e80706f4b4fdfa091). + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------|-----------| +| 0054 | SXLI **- SXLI** | | +| 0054 | [SXLIItem](#sxliitem) **- rgsxli** | | +| 000C | SXLIItem **- SXLIItem\[0\]** | | +| 0002 | SHORT **- cSic** | 0x0000 | +| 15 bits | USHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0002 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x0 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x0 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0004 | SHORT **- rgisxvi** | | +| 0002 | SHORT **- isxvi\[0\]** | 0x0002 | +| 0002 | SHORT **- isxvi\[1\]** | 0x0002 | +| 000C | SXLIItem **- SXLIItem\[1\]** | | +| 0002 | SHORT **- cSic** | 0x0000 | +| 15 bits | USHORT **- itmType** | 0x0001 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0001 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x1 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x0 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0004 | SHORT **- rgisxvi** | | +| 0002 | SHORT **- isxvi\[0\]** | 0x0002 | +| 0002 | SHORT **- isxvi\[1\]** | 0x0002 | +| 000C | SXLIItem **- SXLIItem\[2\]** | | +| 0002 | SHORT **- cSic** | 0x0000 | +| 15 bits | USHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0002 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x0 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x0 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0004 | SHORT **- rgisxvi** | | +| 0002 | SHORT **- isxvi\[0\]** | 0x0003 | +| 0002 | SHORT **- isxvi\[1\]** | 0x0000 | +| 000C | SXLIItem **- SXLIItem\[3\]** | | +| 0002 | SHORT **- cSic** | 0x0001 | +| 15 bits | USHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0002 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x0 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x0 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0004 | SHORT **- rgisxvi** | | +| 0002 | SHORT **- isxvi\[0\]** | 0x0003 | +| 0002 | SHORT **- isxvi\[1\]** | 0x0003 | +| 000C | SXLIItem **- SXLIItem\[4\]** | | +| 0002 | SHORT **- cSic** | 0x0000 | +| 15 bits | USHORT **- itmType** | 0x0001 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0001 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x1 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x0 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0004 | SHORT **- rgisxvi** | | +| 0002 | SHORT **- isxvi\[0\]** | 0x0003 | +| 0002 | SHORT **- isxvi\[1\]** | 0x0003 | +| 000C | SXLIItem **- SXLIItem\[5\]** | | +| 0002 | SHORT **- cSic** | 0x0000 | +| 15 bits | USHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0001 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x0 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x0 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x1 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0004 | SHORT **- rgisxvi** | | +| 0002 | SHORT **- isxvi\[0\]** | 0x0004 | +| 0002 | SHORT **- isxvi\[1\]** | 0x7FFF | +| 000C | SXLIItem **- SXLIItem\[6\]** | | +| 0002 | SHORT **- cSic** | 0x0000 | +| 15 bits | USHORT **- itmType** | 0x000D | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0001 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x1 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x1 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0004 | SHORT **- rgisxvi** | | +| 0002 | SHORT **- isxvi\[0\]** | 0x0000 | +| 0002 | SHORT **- isxvi\[1\]** | 0x0000 | + +Figure 157: Structure of SXLI + +Fields that appear in several SXLIItem structures with the same values are omitted for brevity. + +**rgsxli:** A field that contains an array of SXLIItem structures, which specify the pivot lines present in this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +**rgsxli.SXLIItem\[0\]:** Specifies the first pivot line and its [pivot items](#Section_58891cc5dd9b4293a97831070779524f) in the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +**rgsxli.SXLIItem\[0\].cSic:** 0x0000 specifies that no pivot items in the **rgisxvi** array are identical to the first pivot items in the previous pivot line item in this record. + +**rgsxli.SXLIItem\[0\].itmType:** 0x0000 specifies that the pivot item is a regular data value. + +**rgsxli.SXLIItem\[0\].isxviMac:** 0x0002 specifies that this pivot line contains two pivot items. + +**rgsxli.SXLIItem\[0\].fMultiDataName:** 0x0 specifies that the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592) name is used for the total. + +**rgsxli.SXLIItem\[0\].iData:** 0x00 specifies that the data item for this line item is "Quantity" (the only data item in this PivotTable). + +**rgsxli.SXLIItem\[0\].fSbt:** 0x0 specifies that this pivot item does not represent a subtotal. + +**rgsxli.SXLIItem\[0\].fBlock:** 0x0 specifies that this pivot item is not a block total. + +**rgsxli.SXLIItem\[0\].fGrand:** 0x0 specifies that this pivot item is not a [**grand total**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7). + +**rgsxli.SXLIItem\[0\].fMultiDataOnAxis:** 0x0 specifies that this pivot line does not contain multiple data fields. + +**rgsxli.SXLIItem\[0\].rgisxvi:** Specifies [pivot line entries](#Section_ecba812f4a31495ebeb46749e5897f2d) for this pivot line. + +**rgsxli.SXLIItem\[0\].rgisxvi.isxvi\[0\]:** A field that specifies a pivot item index, because the [SxIvd](#sxivd) record with the same index, **rgSxivd.SxIvdRw\[0\]**, specifies a pivot item index. 0x0002 specifies the third pivot item ([SXVI](#sxvi)) within this [Sxvd](#sxvd) ("CustomerName") record. The referenced pivot item contains an index which refers to the fourth cache item ([SXString](#sxstring)) of the corresponding [cache field](#Section_6497eb794042445780e75959c9f0583c) ("CustomerName"). The fourth [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) within this cache field is "Island Trading". + +**rgsxli.SXLIItem\[0\].rgisxvi.isxvi\[1\]:** A field that specifies a pivot item index, because the SxIvd record with the same index, **rgSxivd.SxIvdRw\[1\]**, specifies a pivot item index. 0x0002 specifies the third pivot item (SXVI) within this Sxvd ("ProductName"). The referenced pivot item contains an index which refers to the fourth cache item (SXString) of the corresponding cache field ("ProductName "). The fourth cache item within this cache field is "Ipoh Coffee". + +**rgsxli.SXLIItem\[1\]:** Specifies the second pivot line and its pivot items in the row axis. + +**rgsxli.SXLIItem\[1\].itmType:** 0x0001 specifies that the pivot item is a subtotal. + +**rgsxli.SXLIItem\[1\].isxviMac:** 0x0001 specifies that this pivot line contains one item. + +**rgsxli.SXLIItem\[1\].fSbt:** 0x1 specifies that this item is a subtotal. + +**rgsxli.SXLIItem\[2\]:** Specifies the third pivot line and its pivot items in the row axis. + +**rgsxli.SXLIItem\[2\].rgisxvi:** Specifies pivot line entries for this pivot line. + +**rgsxli.SXLIItem\[2\].rgisxvi.isxvi\[0\]:** A field that specifies a pivot item index, because the SxIvd record with the same index, **rgSxivd.SxIvdRw\[0\]**, specifies a pivot item index. 0x0003 specifies the fourth pivot item (SXVI) within this Sxvd ("CustomerName"). The referenced pivot item contains an index which refers to the fifth cache item (SXString) of the corresponding cache field ("CustomerName"). The first cache item within this cache field is "Königlich Essen". + +**rgsxli.SXLIItem\[2\].rgisxvi.isxvi\[1\]:** A field that specifies a pivot item index, because the SxIvd record with the same index, **rgSxivd.SxIvdRw\[1\]**, specifies a pivot item index. 0x0000 specifies the first pivot item (SXVI) within this Sxvd ("ProductName") record. The referenced pivot item contains an index which refers to the first cache item (SXString) of the corresponding cache field ("ProductName"). The first cache item within this cache field is "Geitost". + +**rgsxli.SXLIItem\[3\]:** Specifies the fourth pivot line and its pivot items in the row axis. + +**rgsxli.SXLIItem\[3\].cSic:** 0x0001 specifies that one pivot item in the **rgisxvi** array is identical to the first pivot item in the previous pivot line item in this record. + +**rgsxli.SXLIItem\[3\].rgisxvi:** Specifies pivot line entries for this pivot line. + +**rgsxli.SXLIItem\[3\].rgisxvi.isxvi\[0\]:** A field that specifies a pivot item index, because the SxIvd record with the same index, **rgSxivd.SxIvdRw\[0\]**, specifies a pivot item index. 0x0003 specifies the fourth pivot item (SXVI) within this Sxvd ("CustomerName") record. The referenced pivot item contains an index which refers to the fifth cache item (SXString) of the corresponding cache field ("CustomerName"). The fifth cache item within this cache field is "Königlich Essen". + +**rgsxli.SXLIItem\[3\].rgisxvi.isxvi\[1\]:** A field that specifies a pivot item index, because the SxIvd record with the same index, **rgSxivd.SxIvdRw\[1\]**, specifies a pivot item index. 0x0003 specifies the fourth pivot item (SXVI) within this Sxvd ("ProductName") record. The referenced pivot item contains an index which refers to the third cache item (SXString) of the corresponding cache field ("ProductName"). The third cache item within this cache field is "Perth Pasties". + +The next pivot line is similar to the earlier subtotal pivot line and is not described here. + +**rgsxli.SXLIItem\[5\]:** Specifies the sixth pivot line and its pivot items in the row axis. + +**rgsxli.SXLIItem\[5\].rgisxvi:** Specifies pivot line entries for this pivot line. + +**rgsxli.SXLIItem\[5\].rgisxvi.isxvi\[0\]:** A field that specifies a pivot item index, because the SxIvd record with the same index, **rgSxivd.SxIvdRw\[0\]**, specifies a pivot item index. 0x0004 specifies the fourth pivot item (SXVI) within this Sxvd ("CustomerName") record. The referenced pivot item contains an index which refers to the third cache item (SXString) of the corresponding cache field ("ProductName"). The third cache item within this cache field is "Richter Supermarkt". + +**rgsxli.SXLIItem\[5\].rgisxvi.isxvi\[1\]:** 0x7FFF specifies that there is no pivot item in this position and the cell is blank. + +**rgsxli.SXLIItem\[6\]:** Specifies the seventh pivot line and its pivot items in the row axis. + +**rgsxli.SXLIItem\[6\].itmType:** 0x000D specifies that the pivot item is a grand total. + +**rgsxli.SXLIItem\[6\].fGrand:** 0x1 specifies that this pivot item is a grand total. + +**rgsxli.SXLIItem\[6\].rgisxvi:** Specifies pivot line entries for this pivot line. + +**rgsxli.SXLIItem\[6\].rgisxvi.isxvi\[0\]:** This field has the value 0x0000 because this pivot item is a grand total (**fGrand**=1). + +**rgsxli.SXLIItem\[6\].rgisxvi.isxvi\[1\]:** This field has the value 0x0000 because this pivot item is a grand total (**fGrand**=1). + +### PivotTable: SXLI 2 + +This second [SXLI](#sxli) record specifies the [pivot line](#Section_76610990666f492791b6d2280f607464) item structures for the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). The size of this array (one item) is determined by the **cCol** field of the [SxView](#sxview) record. + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------|-----------| +| 0008 | SXLI **- SXLI** | | +| 0008 | [SXLIItem](#sxliitem) **- rgsxli** | | +| 0008 | SXLIItem **- SXLI_Item\[0\]** | | +| 0002 | SHORT **- cSic** | 0x0000 | +| 15 bits | USHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0000 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x0 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x0 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | + +Figure 158: Structure of SXLI + +All values of this record are 0 because there is no field or any item in column axis. Because of this, none of the fields are described in this section. + +### PivotTable: SXEx + +The next record in this example, [SXEx](#sxex), specifies additional properties of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------|-----------| +| 0018 | SXEx **- Sxex** | | +| 0002 | USHORT **- csxformat** | 0x0000 | +| 0002 | USHORT **- cchErrorString** | 0xFFFF | +| 0002 | USHORT **- cchNullString** | 0xFFFF | +| 0002 | USHORT **- cchTag** | 0xFFFF | +| 0002 | USHORT **- csxselect** | 0x0000 | +| 0002 | [DRw](#drw) **- crwPage** | | +| 0002 | USHORT **- drw** | 0x0001 | +| 0002 | [DCol](#dcol) **- ccolPage** | | +| 0002 | USHORT **- dcol** | 0x0001 | +| 1 bit | USHORT **- fAcrossPageLay** | 0x0 | +| 8 bits | USHORT **- cWrapPage** | 0x00 | +| 1 bit | USHORT **- unused** | 0x1 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 5 bits | USHORT **- reserved2** | 0x00 | +| 1 bit | USHORT **- fEnableWizard** | 0x1 | +| 1 bit | USHORT **- fEnableDrilldown** | 0x1 | +| 1 bit | USHORT **- fEnableFieldDialog** | 0x1 | +| 1 bit | USHORT **- fPreserveFormatting** | 0x1 | +| 1 bit | USHORT **- fMergeLabels** | 0x0 | +| 1 bit | USHORT **- fDisplayErrorString** | 0x0 | +| 1 bit | USHORT **- fDisplayNullString** | 0x1 | +| 1 bit | USHORT **- fSubtotalHiddenPageItems** | 0x0 | +| 8 bits | USHORT **- reserved3** | 0x00 | +| 0002 | USHORT **- cchPageFieldStyle** | 0xFFFF | +| 0002 | USHORT **- cchTableStyle** | 0xFFFF | +| 0002 | USHORT **- cchVacateStyle** | 0xFFFF | + +Figure 159: Structure of Sxex + +**csxformat:** 0x0000 specifies that no [SxFormat](#sxformat) records follow this record. + +**cchErrorString:** 0xFFFF specifies that a custom string displayed in [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that contain errors does not exist. + +**cchNullString:** 0xFFFF specifies that a custom string displayed in cells that contain NULL values does not exist. + +**cchTag:** 0xFFFF specifies that a custom string saved with this PivotTable view does not exist. + +**csxselect:** 0x0000 specifies that no [SxSelect](#sxselect) records follow this record. + +**crwPage:** Specifies the number of rows in the [page area](#Section_f10ef7d86c044d35a5830d6f2ce92063) of the PivotTable view. + +**crwPage.drw:** 0x0001 specifies that this PivotTable view contains one row on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**ccolPage:** Specifies the number of columns in the page area in the PivotTable view. + +**ccolPage.dcol:** 0x0001 specifies that this PivotTable view contains one column on the page axis. + +**fAcrossPageLay:** 0x0 specifies that multiple [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5) on the page axis will be displayed in the page area from the top to the bottom first, as fields are added, before moving to another column. + +**cWrapPage:** 0x00 specifies that pivot fields in the page area do not wrap, as specified by **fAcrossPageLay**. + +**fEnableWizard:** 0x1 specifies that the application displays a user interface to interact with the PivotTable view. + +**fEnableDrilldown:** 0x1 specifies that details can be shown for cells in the [data area](#Section_237a24905c614931923f7ee856f23c72). + +**fEnableFieldDialog:** 0x1 specifies that a user interface for setting properties of a pivot field can be displayed. + +**fPreserveFormatting:** 0x1 specifies that formatting is preserved when the PivotTable view is recalculated. + +**fMergeLabels:** 0x0 specifies that empty cells adjacent to the cells displaying [pivot item](#Section_58891cc5dd9b4293a97831070779524f) captions of pivot fields on the [row axis](#Section_3f46e7207706400cba9473cb829f869a) and [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) of this PivotTable view are not merged into a single cell. + +**fDisplayErrorString:** 0x0 specifies that the PivotTable view does not display a custom error string in cells that contain errors. + +**fDisplayNullString:** 0x1 specifies that the PivotTable view displays a custom string in cells that contain NULL values. + +**fSubtotalHiddenPageItems:** 0x0 specifies that hidden pivot items, as specified by [SXVI](#sxvi) records with the **fHidden** field equal to 1, of a pivot field on the page axis with the **isxvi** field of the corresponding [SXPI_Item](#sxpi_item) structure equal to 0x7FFD, are filtered out when calculating the PivotTable view. + +**cchPageFieldStyle:** 0xFFFF specifies that no [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) is applied in the page area of the PivotTable view. + +**cchTableStyle:** 0xFFFF specifies that no style is applied in the [body](#Section_7f7d9d76a55041d9ae9f0d8539cc09f8) of the PivotTable view. + +**cchVacateStyle:** 0xFFFF specifies that no style is applied to cells that become empty when the PivotTable view is recalculated. + +### PivotTable: QsiSXTag + +The next record in this example, [QsiSXTag](#qsisxtag), specifies the name and [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) information for this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------------------------|------------------| +| 0025 | QsiSXTag **- QsiSxTag** | | +| 0004 | [FrtHeaderOld](#frtheaderold) **- frtHeader** | | +| 0002 | USHORT **- rt** | 0x0802 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0002 | SHORT **- fSx** | 0x0001 | +| 1 bit | USHORT **- fEnableRefresh** | 0x1 | +| 1 bit | USHORT **- fInvalid** | 0x0 | +| 1 bit | USHORT **- fTensorEx** | 0x0 | +| 13 bits | USHORT **- reserved1** | 0x0000 | +| 0004 | [SXView9Save](#sxview9save) **- dwQsiFuture** | | +| 1 bit | USHORT **- fNoStencil** | 0x0 | +| 1 bit | USHORT **- fHideTotAnnotation** | 0x1 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fIncludeEmptyRw** | 0x0 | +| 1 bit | USHORT **- fIncludeEmptyCol** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 16 bits | USHORT **- reserved3** | 0x0000 | +| 0001 | BYTE **- verSxLastUpdated** | 0x02 | +| 0001 | BYTE **- verSxUpdatableMin** | 0x00 | +| 0001 | BYTE **- obCchName** | 0x10 | +| 0001 | BYTE **- reserved2** | 0x00 | +| 0013 | [XLUnicodeString](#xlunicodestring) **- stName** | OrdersPivotTable | +| 0002 | USHORT **- unused** | 0x0100 | + +Figure 160: Structure of QsiSxTag + +**frtHeader:** A structure that specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) type header. + +**frtHeader.rt:** 0x0802 specifies the record type identifier and is required. + +**frtHeader.grbitFrt:** 0x00 specifies a constant value of 0x00. + +**fSx:** 0x0001 specifies that this record relates to a PivotTable. + +**fEnableRefresh:** 0x1 specifies that the PivotTable is to be refreshed with data from an external [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + +**fInvalid:** 0x0 specifies that the PivotTable needs to be refreshed. + +**fTensorEx:** 0x0 specifies that the PivotTable is not an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) report. + +**dwQsiFuture:** Specifies additional option flags for a PivotTable. + +**dwQsiFuture.fNoStencil:** 0x0 specifies that the drawing of large drop zones is enabled for this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37)that has no data fields. + +**dwQsiFuture.fHideTotAnnotation:** 0x1 specifies that annotation for the total in this [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) is hidden. + +**dwQsiFuture.fIncludeEmptyRw:** 0x0 specifies that empty rows from an OLAP data source are not shown in this PivotTable view. + +**dwQsiFuture.fIncludeEmptyCol:** 0x0 specifies that empty columns from an OLAP data source are not shown in this PivotTable view. + +**verSxLastUpdated:** 0x02 specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) that this PivotTable was last refreshed with. + +**verSxUpdatableMin:** 0x00 specifies the minimum version of the application that can refresh this PivotTable. + +**stName:** "OrdersPivotTable" specifies the name of this PivotTable. + +### PivotTable: SXViewEx9 + +QsiSXTag The next record in this example, [SXViewEx9](#sxviewex9), specifies extensions to the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------------------|--------------| +| 0011 | SXViewEx9 **- Sxviewex9** | | +| 0002 | USHORT **- rt** | 0x0810 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved2** | 0x0000 | +| 0004 | ULONG **- reserved3** | 0x00000000 | +| 1 bit | ULONG **- reserved4** | 0x0 | +| 1 bit | ULONG **- fPrintTitles** | 0x0 | +| 1 bit | ULONG **- fLineMode** | 0x0 | +| 2 bits | ULONG **- reserved5** | 0x0 | +| 1 bit | ULONG **- fRepeatItemsOnEachPrintedPage** | 0x1 | +| 26 bits | ULONG **- reserved6** | 0x0000000 | +| 0002 | [AutoFmt8](#autofmt8) **- itblAutoFmt** | 0x0001 | +| 0003 | [XLUnicodeString](#xlunicodestring) **- chGrand** | empty string | + +Figure 161: Structure of Sxviewex9 + +**rt:** 0x0810 specifies a constant record type identifier. + +**fFrtAlert:** 0x0000 specifies that features of this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) are supported in earlier versions of the [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517). + +**fPrintTitles:** 0x00000000 specifies that print titles for the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) are not set based on the PivotTable report. + +**fLineMode:** 0x00000000 specifies that no [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) is in outline mode. See [subtotaling](#Section_427438d9b8e34a5c8b678f158fbf680f) for more information. + +**fRepeatItemsOnEachPrintedPage:** 0x00000001 specifies that [pivot item](#Section_58891cc5dd9b4293a97831070779524f) captions on the [row axis](#Section_3f46e7207706400cba9473cb829f869a) will be repeated at the top of each printed page for pivot fields in tabular form. + +**itblAutoFmt:** 0x0001 specifies the PivotTable [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f). A value of 0x001 specifies XL8_ITBLCLASSIC1 or the **Classic 1** AutoFormat style. + +### PivotTable: SxAddl 4 + +The next record in this example, [SxAddl](#sxaddl), specifies additional information for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) and [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001F | [SXAddl_SXCView_SXDId](#sxaddl_sxcview_sxdid) **- SXAddl** | | +| 0006 | [SXAddlHdr](#sxaddlhdr) **- hdr** | | +| 0004 | [FrtHeaderOld](#frtheaderold) **- frtHeaderOld** | | +| 0002 | USHORT **- rt** | 0x0864 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0001 | BYTE **- sxc** | 0x00 | +| 0001 | BYTE **- sxd** | 0x00 | +| 0019 | SXAddl_SXString **- stName** | | +| 0019 | [XLUnicodeStringSegmentedSXAddl](#xlunicodestringsegmentedsxaddl) **- stName** | OrdersPivotTable | + +Figure 162: Structure of SXAddl + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**hdr:** An SXAddlHdr structure that specifies header information for this SXAddl record. + +**hdr.sxc:** 0x00 specifies the current [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) as an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +**hdr.sxd:** 0x00 specifies the type of record contained in the **data** field of the containing SXAddl record. This value specifies that the type of this SXAddl record is [SXAddl_SXCCache_SXDId](#sxaddl_sxccache_sxdid). + +**stName.stName:** "OrdersPivotTable" specifies the name of the PivotTable View. + +### PivotTable: SxAddl 5 + +The next record in this example, [SxAddl](#sxaddl), specifies additional information for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) and [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 000C | [SXAddl_SXCView_SXDVer10Info](#sxaddl_sxcview_sxdver10info) **- SXAddl** | | +| 0006 | [SXAddlHdr](#sxaddlhdr) **- hdr** | | +| 0004 | [FrtHeaderOld](#frtheaderold) **- frtHeaderOld** | | +| 0002 | USHORT **- rt** | 0x0864 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0001 | BYTE **- sxc** | 0x00 | +| 0001 | BYTE **- sxd** | 0x02 | +| 8 bits | ULONG **- bVerSxMacro** | 0x01 | +| 1 bit | ULONG **- fDisplayImmediateItems** | 0x1 | +| 1 bit | ULONG **- fEnableDataEd** | 0x0 | +| 1 bit | ULONG **- fDisableFList** | 0x0 | +| 1 bit | ULONG **- fReenterOnLoadOnce** | 0x0 | +| 1 bit | ULONG **- fNotViewCalculatedMembers** | 0x0 | +| 1 bit | ULONG **- fNotVisualTotals** | 0x0 | +| 1 bit | ULONG **- fPageMultipleItemLabel** | 0x1 | +| 1 bit | ULONG **- fTensorFillCv** | 0x0 | +| 1 bit | ULONG **- fHideDDData** | 0x0 | +| 3 bits | ULONG **- reserved1** | 0x0 | +| 12 bits | ULONG **- unused** | 0x000 | +| 0002 | USHORT **- reserved2** | 0x0000 | + +Figure 163: Structure of SXAddl + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**hdr:** An SXAddlHdr structure that specifies header information for this SXAddl record. + +**hdr.sxc:** 0x00 specifies the current [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) as an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +**hdr.sxd:** 0x02 specifies the type of record contained in the **data** field of the containing SXAddl record. See class for more information. This value specifies that the type of this SXAddl record is SXAddl_SXCView_SXDVer10Info. + +**bVerSxMacro:** 0x01 specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) with which this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) was created. + +**fDisplayImmediateItems:** 0x1 specifies that [pivot items](#Section_58891cc5dd9b4293a97831070779524f) are displayed in the PivotTable view even when there is no [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) on the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**fEnableDataEd:** 0x0 specifies the user is not allowed to change values in the data axis of the PivotTable view. + +**fDisableFList:** 0x0 specifies the [**PivotTable field list**](#gt_1760fb56-0c97-4c0d-a077-38338baa7577) is enabled. + +**fReenterOnLoadOnce:** 0x0 specifies that this PivotTable view will not [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) the next time the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is opened. + +**fPageMultipleItemLabel:** 0x1 specifies that [OLAP calculated members](#Section_e67071408ab5499ca7bab1d8eca85058) are [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) in the PivotTable view. + +### PivotTable: SxAddl 6 + +The next record in this example, [SxAddl](#sxaddl), specifies additional information for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) and [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). In this record, the **data.hdr.sxd** field specifies that this is the last record of an **SxAddl** record collection. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 000C | [SXAddl_SXCView_SXDEnd](#sxaddl_sxcview_sxdend) **- SXAddl** | | +| 0006 | [SXAddlHdr](#sxaddlhdr) **- hdr** | | +| 0004 | [FrtHeaderOld](#frtheaderold) **- frtHeaderOld** | | +| 0002 | USHORT **- rt** | 0x0864 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0001 | BYTE **- sxc** | 0x00 | +| 0001 | BYTE **- sxd** | 0xFF | +| 0006 | reserved **- reserved** | 0x000000000000 | + +Figure 164: Structure of SXAddl + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**hdr:** An SXAddlHdr structure that specifies header information for this SXAddl record. + +**hdr.sxc:** 0x00 specifies the current [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) as an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +**hdr.sxd:** 0xFF specifies the type of record contained in the **data** field of the containing SXAddl record. See class for more information. This value specifies that the type of this SXAddl record is SXAddl_SXCView_SXDEnd. + +### PivotTable: SXDB + +The next record in this example, [SXDB](#sxdb), specifies some of the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) properties for the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) in this example. This SXDB record marks the beginning of the set of records in the stream associated with this PivotTable that appear in the [Pivot Cache storage](#Section_c5fb3f663ef64308ae3de59244159687) (\_SX_DB_CUR). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001F | SXDB **- SXDB** | | +| 0004 | LONG **- crdbdb** | 0x0000002C | +| 0002 | USHORT **- idstm** | 0x0001 | +| 1 bit | USHORT **- fSaveData** | 0x1 | +| 1 bit | USHORT **- fInvalid** | 0x0 | +| 1 bit | USHORT **- fRefreshOnLoad** | 0x0 | +| 1 bit | USHORT **- fOptimizeCache** | 0x0 | +| 1 bit | USHORT **- fBackgroundQuery** | 0x0 | +| 1 bit | USHORT **- fEnableRefresh** | 0x1 | +| 10 bits | USHORT **- unused1** | 0x000 | +| 0002 | SHORT **- unused2** | 0x0666 | +| 0002 | SHORT **- cfdbdb** | 0x0005 | +| 0002 | SHORT **- cfdbTot** | 0x0005 | +| 0002 | SHORT **- crdbUsed** | 0x0006 | +| 0002 | USHORT **- vsType** | 0x0001 | +| 0002 | USHORT **- cchWho** | 0x000A | +| 000B | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- rgb** | John Smith | + +Figure 165: Structure of SXDB + +**crdbdb:** 0x0000002C specifies that there are a total of 44 records in the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) of this PivotCache. + +**idstm:** 0x0001 specifies the identifier of the stream in the PivotCache storage that contains the PivotCache for this PivotTable. The stream identifier is a four-character string representation of the hexadecimal value. In this case the stream identifier is "0001". This field is equal to the **idstm** field of [SXStreamID](#sxstreamid). + +**fSaveData:** 0x1 specifies that [cache records](#Section_fe6e4ca0a9b646a4898124e4b61a770a) exist for this PivotCache. + +**fInvalid:** 0x0 specifies that the cache does not need to be refreshed before the next recalculation. + +**fRefreshOnLoad:** 0x0 specifies that the PivotCache is not refreshed on load. + +**fOptimizeCache:** 0x0 specifies that the cache is not optimized for reduced memory usage. + +**fBackgroundQuery:** 0x0 specifies that a [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) of the PivotCache is performed synchronously. + +**fEnableRefresh:** 0x1 specifies that the PivotCache refresh is enabled. + +**cfdbdb:** 0x0005 specifies that there are five base [cache fields](#Section_6497eb794042445780e75959c9f0583c) in the source data. + +**cfdbTot:** 0x0005 specifies that there are a sum total of five base, grouped, and calculated fields in the cache. The value of this field is the same as the **cfdbdb** field because there are no grouped or calculated fields. + +**crdbUsed:** 0x0006 specifies that there are six records in use from the source data in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) as a result of the filtering in the [page area](#Section_f10ef7d86c044d35a5830d6f2ce92063). + +**vsType:** 0x0001 specifies that the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) range. + +**cchWho:** 0x000A specifies the length (10) of the following **rgb** string. + +**rgb:** "John Smith" specifies the name of the user who last refreshed the PivotTable. + +### PivotTable: SXDBEx + +The next record in this example, [SXDBEx](#sxdbex), specifies additional [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) properties. + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------|--------------------| +| 000C | SXDBEx **- SXDBEx** | | +| 0008 | [DateAsNum](#dateasnum) **- numDate** | | +| 0008 | [Xnum](#xnum) **- dateNum** | 0x40E355907CBEB8CE | +| 0004 | DWORD **- cSxFormula** | 0x00000000 | + +Figure 166: Structure of SXDBEx + +**numDate:** A DateAsNum structure that specifies the PivotCache was last refreshed on 5/28/2008. + +**numDate.dateNum:** 0x40E355907CBEB8CE specifies the numeric value 39596.515227662035, which represents the date (5/28/2008 12:21:56 PM) that the PivotCache was last refreshed. + +**cSxFormula:** 0x00000000 specifies that there are no [SXFormula](#sxformula) records for this PivotCache. + +### PivotTable: SXFDB 1 + +The next records in this example are a series of [SXFDB](#sxfdb) and related records that specify the [cache fields](#Section_6497eb794042445780e75959c9f0583c) and their contents. This first SXFDB record specifies details of the CustomerName cache field in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). In this example, this cache field is displayed in the [row axis](#Section_3f46e7207706400cba9473cb829f869a) of the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001D | SXFDB **- SXFDB** | | +| 1 bit | USHORT **- fAllAtoms** | 0x1 | +| 1 bit | USHORT **- fSomeUnhashed** | 0x0 | +| 1 bit | USHORT **- fUsed** | 0x0 | +| 1 bit | USHORT **- fHasParent** | 0x0 | +| 1 bit | USHORT **- fRangeGroup** | 0x0 | +| 1 bit | USHORT **- fNumField** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fTextEtcField** | 0x1 | +| 1 bit | USHORT **- fnumMinMaxValid** | 0x0 | +| 1 bit | USHORT **- fShortIitms** | 0x0 | +| 1 bit | USHORT **- fNonDates** | 0x1 | +| 1 bit | USHORT **- fDateInField** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- fCantGetUniqueItems** | 0x0 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 0002 | SHORT **- ifdbParent** | 0x0000 | +| 0002 | SHORT **- ifdbBase** | 0x0000 | +| 0002 | SHORT **- citmUnq** | 0x0005 | +| 0002 | SHORT **- csxoper** | 0x0000 | +| 0002 | SHORT **- cisxoper** | 0x0000 | +| 0002 | SHORT **- catm** | 0x0005 | +| 000F | [XLUnicodeString](#xlunicodestring) **- stFieldName** | CustomerName | + +Figure 167: Structure of SXFDB + +Fields in this record that are ignored because **fHasParent** is 0 are omitted for brevity. + +**fAllAtoms:** 0x1 specifies that the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) for this cache field is cached. It is cached because the CustomerName cache field is displayed in the PivotTable as the first row field. + +**fSomeUnhashed:** 0x0 specifies that all source data is cached in the PivotCache. + +**fUsed:** 0x0 specifies that no calculated cache fields are used in the PivotTable. + +**fHasParent:** 0x0 specifies that this cache field does not have a parent cache field. + +**fRangeGroup:** 0x0 specifies that this cache field is not grouped by range grouping, as specified in [Grouping](#Section_63e07ed20a764cb08cf446aaf25464c2). + +**fNumField:** 0x0 specifies that the [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in this cache field do not contain numeric data. + +**fTextEtcField:** 0x1 specifies that the cache items in this cache field contain text values. + +**fnumMinMaxValid:** 0x0 specifies that a valid minimum or maximum value is not computed for this cache field. + +**fShortIitms:** 0x0 specifies that this cache field does not contain more than 255 cache items. + +**fNonDates:** 0x1 specifies that the cache items in this cache field contain values that are neither time nor date values. + +**fDateInField:** 0x0 specifies that none of the cache items in this cache field contain a time or date value. + +**fServerBased:** 0x0 specifies that this cache field is not a server-based field, as specified in Source Data. + +**fCantGetUniqueItems:** 0x0 specifies that it is possible to retrieve a list of unique items for this cache field. + +**fCalculatedField:** 0x0 specifies that this record is not a [calculated field](#Section_4594f2ac815740b381142e77ba8efb7d). + +**csxoper:** 0x0000 specifies that there are zero cache item values in this cache field that are based on [**child**](#gt_bc38f35b-d253-4f8f-8dcc-095e3a211ae0) cache fields. + +**cisxoper:** 0x0000 specifies that there are zero values in the child cache fields of this cache field. + +**catm:** 0x0005 specifies that there are five items in the cache item collection for this cache field. + +**stFieldName:** "CustomerName" specifies the name of this cache field. + +The following record, [SXFDBType](#sxfdbtype), is not included in this example because the **sxvs** field of the [SXVS](#sxvs) record in this example is 1. + +### PivotTable: SXString 1 + +After the [cache field](#Section_6497eb794042445780e75959c9f0583c) is specified, a series of records follow it that specify the [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in the CustomerName cache field. In this example, the next record is an [SXString](#sxstring) record, which specifies a string cache item. This cache item is not displayed in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001A | SXString **- SXString** | | +| 0002 | USHORT **- cch** | 0x0017 | +| 0018 | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- segment** | Great Lakes Food Market | + +Figure 168: Structure of SXString + +**cch:** 0x0017 specifies the length (23) of the cache item string. + +**segment:** "Great Lakes Food Market" specifies the value of the cache item. + +### PivotTable: SXString 2 + +The next record in this example, [SXString](#sxstring), specifies a string [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in the CustomerName [cache field](#Section_6497eb794042445780e75959c9f0583c). This cache item does not appear in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001A | SXString **- SxString** | | +| 0002 | USHORT **- cch** | 0x0017 | +| 0018 | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- segment** | Antonio Moreno Taquería | + +Figure 169: Structure of SxString + +**cch:** 0x0017 specifies the length (23) of the cache item string. + +**segment:** "Antonio Moreno Taquería" specifies the value of the cache item. + +This record is followed by 1 additional SXString record that is omitted for brevity. + +### PivotTable: SXString 3 + +The next record in this example, [SXString](#sxstring), specifies a string [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in the CustomerName [cache field](#Section_6497eb794042445780e75959c9f0583c). This record is included in this example because it is displayed in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0011 | SXString **- SXString** | | +| 0002 | USHORT **- cch** | 0x000E | +| 000F | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- segment** | Island Trading | + +Figure 170: Structure of SXString + +**cch:** 0x000E specifies the length (14) of the cache item string. + +**segment:** "Island Trading" specifies the value of the cache item. + +Records following this record, and before the next [SXFDB](#sxfdb) record, are omitted for brevity. + +### PivotTable: SXFDB 2 + +The next record in this example, [SXFDB](#sxfdb), specifies the OrderDate [cache field](#Section_6497eb794042445780e75959c9f0583c) in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). This cache field is displayed in the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------------------------|-----------| +| 001A | SXFDB **- SXFDB** | | +| 1 bit | USHORT **- fAllAtoms** | 0x1 | +| 1 bit | USHORT **- fSomeUnhashed** | 0x0 | +| 1 bit | USHORT **- fUsed** | 0x0 | +| 1 bit | USHORT **- fHasParent** | 0x0 | +| 1 bit | USHORT **- fRangeGroup** | 0x0 | +| 1 bit | USHORT **- fNumField** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fTextEtcField** | 0x0 | +| 1 bit | USHORT **- fnumMinMaxValid** | 0x1 | +| 1 bit | USHORT **- fShortIitms** | 0x0 | +| 1 bit | USHORT **- fNonDates** | 0x0 | +| 1 bit | USHORT **- fDateInField** | 0x1 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- fCantGetUniqueItems** | 0x0 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 0002 | SHORT **- ifdbParent** | 0x0000 | +| 0002 | SHORT **- ifdbBase** | 0x0000 | +| 0002 | SHORT **- citmUnq** | 0x0014 | +| 0002 | SHORT **- csxoper** | 0x0000 | +| 0002 | SHORT **- cisxoper** | 0x0000 | +| 0002 | SHORT **- catm** | 0x0014 | +| 000C | [XLUnicodeString](#xlunicodestring) **- stFieldName** | OrderDate | + +Figure 171: Structure of SXFDB + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fAllAtoms:** 0x1 specifies that the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) for this cache field is cached. It is cached because the OrderDate cache field is displayed in the PivotTable as the first page field. + +**fNonDates:** 0x0 specifies that the [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in this cache field are date or time values. + +**fDateInField:** 0x1 specifies that at least one cache item in this cache field is a date or time value. + +**catm:** 0x0014 specifies that there are 20 items in the cache item collection for this cache field. + +**stFieldName:** "OrderDate" specifies the name of the cache field. + +Records following this record, and before the next [SXDtr](#sxdtr) record, are omitted for brevity. + +### PivotTable: SXDtr 1 + +The next record in this example, [SXDtr](#sxdtr), specifies a date [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in the OrderDate [cache field](#Section_6497eb794042445780e75959c9f0583c). This cache item is filtered out in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|-------------------|-----------| +| 0008 | SXDtr **- SXDtr** | | +| 0002 | USHORT **- yr** | 0x07CD | +| 0002 | USHORT **- mon** | 0x0005 | +| 0001 | BYTE **- dom** | 0x06 | +| 0001 | BYTE **- hr** | 0x00 | +| 0001 | BYTE **- min** | 0x00 | +| 0001 | BYTE **- sec** | 0x00 | + +Figure 172: Structure of SXDtr + +**yr:** 0x07CD specifies the year value (1997) of the cache item. + +**mon:** 0x0005 specifies the month value (5) of the cache item. + +**dom:** 0x06 specifies the day of the month value (6) of the cache item. + +**hr:** 0x00 specifies the hour value (0) of the cache item. + +**min:** 0x00 specifies the minute value (0) of the cache item. + +**sec:** 0x00 specifies the second value (0) of the cache item. + +This record is followed by 15 additional SXDtr records that are omitted for brevity. + +### PivotTable: SXDtr 2 + +The next record in this example, [SXDtr](#sxdtr), specifies a date [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in the OrderDate page field that is not filtered in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|-------------------|-----------| +| 0008 | SXDtr **- SXDtr** | | +| 0002 | USHORT **- yr** | 0x07CD | +| 0002 | USHORT **- mon** | 0x000C | +| 0001 | BYTE **- dom** | 0x17 | +| 0001 | BYTE **- hr** | 0x00 | +| 0001 | BYTE **- min** | 0x00 | +| 0001 | BYTE **- sec** | 0x00 | + +Figure 173: Structure of SXDtr + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**yr:** 0x07CD specifies the year value (1997) of the cache item. + +**mon:** 0x000C specifies the month value (12) of the cache item. + +**dom:** 0x17 specifies the day of the month value (23) of the cache item. + +Records following this record, and before the next [SXFDB](#sxfdb) record, are omitted for brevity. + +### PivotTable: SXFDB 3 + +The next record in this example, [SXFDB](#sxfdb), specifies the ProductName [cache field](#Section_6497eb794042445780e75959c9f0583c) in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). This cache field is displayed in the [row axis](#Section_3f46e7207706400cba9473cb829f869a) of the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------------------------|-------------| +| 001C | SXFDB **- SXFDB** | | +| 1 bit | USHORT **- fAllAtoms** | 0x1 | +| 1 bit | USHORT **- fSomeUnhashed** | 0x0 | +| 1 bit | USHORT **- fUsed** | 0x0 | +| 1 bit | USHORT **- fHasParent** | 0x0 | +| 1 bit | USHORT **- fRangeGroup** | 0x0 | +| 1 bit | USHORT **- fNumField** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fTextEtcField** | 0x1 | +| 1 bit | USHORT **- fnumMinMaxValid** | 0x0 | +| 1 bit | USHORT **- fShortIitms** | 0x0 | +| 1 bit | USHORT **- fNonDates** | 0x1 | +| 1 bit | USHORT **- fDateInField** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- fCantGetUniqueItems** | 0x0 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 0002 | SHORT **- ifdbParent** | 0x0000 | +| 0002 | SHORT **- ifdbBase** | 0x0000 | +| 0002 | SHORT **- citmUnq** | 0x0006 | +| 0002 | SHORT **- csxoper** | 0x0000 | +| 0002 | SHORT **- cisxoper** | 0x0000 | +| 0002 | SHORT **- catm** | 0x0006 | +| 000E | [XLUnicodeString](#xlunicodestring) **- stFieldName** | ProductName | + +Figure 174: Structure of SXFDB + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fAllAtoms:** 0x1 specifies that the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) for this cache field is cached. It is cached because the ProductName cache field is displayed in the PivotTable as the first row field. + +**fNumField:** 0x0 specifies that the [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in this cache field do not contain numeric data. + +**fTextEtcField:** 0x1 specifies that the cache items in this cache field contain text values. + +**catm:** 0x0006 specifies that there are six items in the cache item collection for this cache field. The number of items in the cache field was affected in this case by the filtering on the page field. + +**stFieldName:** "ProductName" specifies the name of the cache field. + +Records following this record, and before the next SXFDB record, are omitted for brevity. + +### PivotTable: SXFDB 4 + +The next record in this example, [SXFDB](#sxfdb), specifies the UnitPrice [cache field](#Section_6497eb794042445780e75959c9f0583c) in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). This cache field does not appear on any [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) in the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------------------------|-----------| +| 001A | SXFDB **- SXFDB** | | +| 1 bit | USHORT **- fAllAtoms** | 0x1 | +| 1 bit | USHORT **- fSomeUnhashed** | 0x0 | +| 1 bit | USHORT **- fUsed** | 0x0 | +| 1 bit | USHORT **- fHasParent** | 0x0 | +| 1 bit | USHORT **- fRangeGroup** | 0x0 | +| 1 bit | USHORT **- fNumField** | 0x1 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fTextEtcField** | 0x0 | +| 1 bit | USHORT **- fnumMinMaxValid** | 0x1 | +| 1 bit | USHORT **- fShortIitms** | 0x0 | +| 1 bit | USHORT **- fNonDates** | 0x1 | +| 1 bit | USHORT **- fDateInField** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- fCantGetUniqueItems** | 0x0 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 0002 | SHORT **- ifdbParent** | 0x0000 | +| 0002 | SHORT **- ifdbBase** | 0x0000 | +| 0002 | SHORT **- citmUnq** | 0x0007 | +| 0002 | SHORT **- csxoper** | 0x0000 | +| 0002 | SHORT **- cisxoper** | 0x0000 | +| 0002 | SHORT **- catm** | 0x0007 | +| 000C | [XLUnicodeString](#xlunicodestring) **- stFieldName** | UnitPrice | + +Figure 175: Structure of SXFDB + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fAllAtoms:** 0x1 specifies that the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) for this cache field is cached. Though this cache field is not displayed on any areas of the PivotTable, its source data is cached because it was displayed in the PivotTable at some point. + +**fNumField:** 0x1 specifies that the [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in this cache field contain numeric data. + +**catm:** 0x0007 specifies that there are seven items in the cache item collection for this cache field. + +**stFieldName:** "UnitPrice" specifies the name of the cache field. + +Records following this record, and before the next [SXNum](#sxnum) record, are omitted for brevity. + +### PivotTable: SXNum 1 + +The next record in this example, [SXNum](#sxnum), specifies a [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d) [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in the UnitPrice [cache field](#Section_6497eb794042445780e75959c9f0583c) that is not in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|--------------------| +| 0008 | SXNum **- SXNum** | | +| 0008 | [Xnum](#xnum) **- num** | 0x4004000000000000 | + +Figure 176: Structure of SXNum + +**num:** 0x4004000000000000 specifies the cache item's numeric value is 2.5. + +Records following this record, and before the next [SXFDB](#sxfdb) record, are omitted for brevity. + +### PivotTable: SXFDB 5 + +The next record in this example, [SXFDB](#sxfdb), specifies the Quantity [cache field](#Section_6497eb794042445780e75959c9f0583c) in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). This cache field appears in the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060) of the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------------------------|-----------| +| 0019 | SXFDB **- SXFDB** | | +| 1 bit | USHORT **- fAllAtoms** | 0x0 | +| 1 bit | USHORT **- fSomeUnhashed** | 0x1 | +| 1 bit | USHORT **- fUsed** | 0x0 | +| 1 bit | USHORT **- fHasParent** | 0x0 | +| 1 bit | USHORT **- fRangeGroup** | 0x0 | +| 1 bit | USHORT **- fNumField** | 0x1 | +| 1 bit | USHORT **- unused1** | 0x1 | +| 1 bit | USHORT **- fTextEtcField** | 0x0 | +| 1 bit | USHORT **- fnumMinMaxValid** | 0x1 | +| 1 bit | USHORT **- fShortIitms** | 0x0 | +| 1 bit | USHORT **- fNonDates** | 0x1 | +| 1 bit | USHORT **- fDateInField** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- fCantGetUniqueItems** | 0x0 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 0002 | SHORT **- ifdbParent** | 0x0000 | +| 0002 | SHORT **- ifdbBase** | 0x0000 | +| 0002 | SHORT **- citmUnq** | 0x001E | +| 0002 | SHORT **- csxoper** | 0x0000 | +| 0002 | SHORT **- cisxoper** | 0x0000 | +| 0002 | SHORT **- catm** | 0x0000 | +| 000B | [XLUnicodeString](#xlunicodestring) **- stFieldName** | Quantity | + +Figure 177: Structure of SXFDB + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fAllAtoms:** 0x0 specifies that the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) for this cache field is not cached. Though this cache field is displayed in the PivotTable, its source data is not cached because the cache field is displayed in the [data area](#Section_237a24905c614931923f7ee856f23c72). + +**fNumField:** 0x1 specifies that the [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in this cache field contain numeric data. + +**catm:** 0x0000 is 0 because **fAllAtoms** is 0. + +**stFieldName:** "Quantity" specifies the name of this cache field. + +Records following this record, and before the next [SXDBB](#sxdbb) record, are omitted for brevity. + +### PivotTable: SXDBB 1 + +The next records in this example are a series of [SXDBB](#sxdbb) and [SXNum](#sxnum) records that specify the [cache records](#Section_fe6e4ca0a9b646a4898124e4b61a770a) for this [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). This first SXDBB specifies the first cache record. + +| **Size** | **Structure** | **Value** | +|----------|----------------------|-----------| +| 0004 | SXDBB **- SXDBB** | | +| 0004 | rgb **- blob** | | +| 0001 | BYTE **- blob\[0\]** | 0x00 | +| 0001 | BYTE **- blob\[1\]** | 0x00 | +| 0001 | BYTE **- blob\[2\]** | 0x00 | +| 0001 | BYTE **- blob\[3\]** | 0x00 | + +Figure 178: Structure of SXDBB + +**blob.blob\[0\]:** 0x00 specifies the index of the first [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) (Great Lakes Food Market) within the collection of cache items of the first [cache field](#Section_6497eb794042445780e75959c9f0583c) (CustomerName). + +**blob.blob\[1\]:** 0x00 specifies the index of the first cache item (5/6/1997) within the collection of cache items of the second cache field (OrderDate). + +**blob.blob\[2\]:** 0x00 specifies the index of the first cache item (Geitost) within the collection of cache items of the third cache field (ProductName). + +**blob.blob\[3\]:** 0x00 specifies the index of the first cache item (2.5) within the collection of cache items of the fourth cache field (UnitPrice). + +### PivotTable: SXNum 2 + +The next record in this example, [SXNum](#sxnum), specifies the [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d) value for the Quantity [cache field](#Section_6497eb794042445780e75959c9f0583c) in the [cache record](#Section_fe6e4ca0a9b646a4898124e4b61a770a) specified by the previous [SXDBB](#sxdbb). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|--------------------| +| 0008 | SXNum **- SXNum** | | +| 0008 | [Xnum](#xnum) **- num** | 0x4020000000000000 | + +Figure 179: Structure of SXNum + +**num:** 0x4020000000000000 specifies that the floating-point number value of this [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) is 8. + +This record is followed by 35 additional pairs of SXDBB and SXNum records that are omitted for brevity. + +### PivotTable: SXDBB 2 + +The next record in this example, [SXDBB](#sxdbb), specifies a [cache record](#Section_fe6e4ca0a9b646a4898124e4b61a770a) that is displayed within the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|----------------------|-----------| +| 0004 | SXDBB **- SXDBB** | | +| 0004 | rgb **- blob** | | +| 0001 | BYTE **- blob\[0\]** | 0x04 | +| 0001 | BYTE **- blob\[1\]** | 0x11 | +| 0001 | BYTE **- blob\[2\]** | 0x00 | +| 0001 | BYTE **- blob\[3\]** | 0x00 | + +Figure 180: Structure of SXDBB + +**blob.blob\[0\]:** 0x04 specifies the index of the fifth [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) (Königlich Essen) within the collection of cache items of the first [cache field](#Section_6497eb794042445780e75959c9f0583c) (CustomerName). + +**blob.blob\[1\]:** 0x11 specifies the index of the eighteenth cache item (12/26/1997) within the collection of cache items of the second cache field (OrderDate). + +**blob.blob\[2\]:** 0x00 specifies the index of the first cache item (Geitost) within the collection of cache items of the third cache field (ProductName). + +**blob.blob\[3\]:** 0x00 specifies the index of the seventh cache item (2.5) within the collection of cache items of the fourth cache field (UnitPrice). + +### PivotTable: SXNum 3 + +The next record in this example, [SXNum](#sxnum), specifies the [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d) value for the Quantity [cache field](#Section_6497eb794042445780e75959c9f0583c) in the [cache record](#Section_fe6e4ca0a9b646a4898124e4b61a770a) specified by the previous [SXDBB](#sxdbb). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|--------------------| +| 0008 | SXNum **- SXNum** | | +| 0008 | [Xnum](#xnum) **- num** | 0x4037000000000000 | + +Figure 181: Structure of SXNum + +**num:** 0x4037000000000000 specifies that the floating-point number value of this [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) is 23. + +Records following this record, and before the next [EOF](#eof) record, are omitted for brevity. + +### PivotTable: EOF + +The next record in this example, [EOF](#eof), specifies the end of the collection of records for this [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + +| **Size** | **Structure** | +|----------|---------------| +| 0000 | EOF **- EOF** | + +Figure 182: Structure of EOF + +# Security Considerations + +The password verifier features available in the file format (see [Password Verifier Algorithm](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4)) are used to prevent accidental modification, rather than being used as security features. It is possible to remove the passwords by removing the records containing the verifier values. + +The translation of passwords from a double-byte [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string to a new character string in the ANSI code page of the current system converts any Unicode character that cannot be mapped to the ANSI code page of the current system to the 0x3F character in that code page (as described in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) part 4, 15.3.3). Replacing these characters with 0x3F when the [**hash**](#gt_b7e2b611-0af5-4fec-8af2-3f9ce7bad205) is verified will generate positive hash value matches. In certain locales this can be a significant portion of the everyday [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204). + +When a file in this format is saved with obfuscation or encryption (see [Encryption](#Section_0f2ea0a19fc8468d97aa9d333b72d106)), there are two primary security considerations. First, only certain storages and [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) are encoded during encryption (see Encryption). Second, for the records that are encrypted, the record type and size are not encrypted in the [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) streams. Therefore, the list of records present in the file can be read from the file without actually decrypting it. Further security considerations regarding the file encryption algorithms are described in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 4.1.3. + +# Appendix A: Product Behavior + +The information in this specification is applicable to the following Microsoft products or supplemental software. References to product versions include updates to those products. + +- Microsoft Excel 97 + +- Microsoft Excel 2000 + +- Microsoft Excel 2002 + +- Microsoft Office Excel 2003 + +- Microsoft Office Excel 2007 + +- Microsoft Excel 2010 + +- Microsoft Excel 2013 + +- Microsoft Excel 2016 + +- Microsoft Excel 2019 + +- Microsoft Excel 2021 + +- Microsoft Excel LTSC 2024 + +Exceptions, if any, are noted in this section. If an update version, service pack or Knowledge Base (KB) number appears with a product name, the behavior changed in that update. The new behavior also applies to subsequent updates unless otherwise specified. If a product edition appears with the product version, behavior is different in that product edition. + +Unless otherwise specified, any statement of optional behavior in this specification that is prescribed using the terms "SHOULD" or "SHOULD NOT" implies product behavior in accordance with the SHOULD or SHOULD NOT prescription. Unless otherwise specified, the term "MAY" implies that the product does not follow the prescription. + +[\<1\> Section 2.1.7.15](#Appendix_A_Target_1): Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 can write, load, and process the Signatures Stream in a file. Excel 97, Excel 2000 can load a file with a Signatures Stream but ignores it. + +[\<2\> Section 2.1.7.20.1](#Appendix_A_Target_2): When saving unsupported **future records** (section [2.1.6](#Section_b660b67822684414839ed1ae9a4e4e85)), Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 will write those records at the end of the **substream** (section [2.1.3](#Section_5e380e95a9f54dfdb6d9c6998a9772f8)) in which they were encountered during load, in the order in which they were encountered. + +[\<3\> Section 2.1.7.20.2](#Appendix_A_Target_3): When saving unsupported **future records** (section 2.1.6), Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 will write those records at the end of the **substream** (section 2.1.3) in which they were encountered during load, in the order in which they were encountered. + +[\<4\> Section 2.1.7.20.2](#Appendix_A_Target_4): If a **Continue** record (section [2.4.58](#continue)) is needed in the **MSODRAWING** rule (section [2.1.7.20.2](#Section_da37feb48b9a462d87772a5fddd4866e)), Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 can write out an **MsoDrawing** record (section [2.4.170](#msodrawing)) instead of the first **Continue** record (section 2.4.58). + +[\<5\> Section 2.1.7.20.3](#Appendix_A_Target_5): When saving unsupported **future records** (section 2.1.6), Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 will write those records at the end of the **substream** (section 2.1.3) in which they were encountered during load, in the order in which they were encountered. + +[\<6\> Section 2.1.7.20.3](#Appendix_A_Target_6): If a **Continue** record (section 2.4.58) is needed in the **MSODRAWINGGROUP** rule, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 can write out an **MsoDrawingGroup** record (section [2.4.171](#msodrawinggroup)) instead of the first **Continue** record (section 2.4.58). + +[\<7\> Section 2.1.7.20.4](#Appendix_A_Target_7): When saving unsupported **future records** (section 2.1.6), Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 will write those records at the end of the **substream** (section 2.1.3) in which they were encountered during load, in the order in which they were encountered. + +[\<8\> Section 2.1.7.20.5](#Appendix_A_Target_8): When saving unsupported **future records** (section 2.1.6), Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 will write those records at the end of the **substream** (section 2.1.3) in which they were encountered during load, in the order in which they were encountered. + +[\<9\> Section 2.1.7.20.6](#Appendix_A_Target_9): When saving unsupported **future records** (section 2.1.6), Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 will write those records at the end of the **substream** (section 2.1.3) in which they were encountered during load, in the order in which they were encountered. + +[\<10\> Section 2.1.7.20.6](#Appendix_A_Target_10): Office Excel 2007, Excel 2010, and Excel 2013 can save out a CELLTABLE without a **Row** record (section [2.4.221](#row)). + +[\<11\> Section 2.1.7.20.6](#Appendix_A_Target_11): If a **Continue** record (section 2.4.58) is needed in the **MSODRAWING** rule (section 2.1.7.20.2), Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 can write out an **MsoDrawing** record (section 2.4.170) instead of the first **Continue** record. + +[\<12\> Section 2.1.7.21](#Appendix_A_Target_12): Only Office Excel 2007 and Excel 2010 can write the **XML Signatures storage**. Only Office Excel 2007 and Excel 2010 can load and process a file with a **XML Signatures storage**; Excel 97, Excel 2000, Excel 2002, Office Excel 2003 can load a file with a **XML Signatures storage** but ignore it. + +[\<13\> Section 2.2.3.11](#Appendix_A_Target_13): Graph Component for Excel 97, Graph Component for Excel 2000, Graph Component for Excel 2002, Graph Component for Office Excel 2003, Graph Component for Office Excel 2007, and Graph Component for Excel 2010 can create files that do not conform to these rules. + +[\<14\> Section 2.2.3.11](#Appendix_A_Target_14): Graph Component for Excel 97, Graph Component for Excel 2000, Graph Component for Excel 2002, Graph Component for Office Excel 2003, Graph Component for Office Excel 2007, and Graph Component for Excel 2010 can create files that do not conform to these rules. + +[\<15\> Section 2.2.3.11](#Appendix_A_Target_15): Graph Component for Excel 97, Graph Component for Excel 2000, Graph Component for Excel 2002, Graph Component for Office Excel 2003, Graph Component for Office Excel 2007, and Graph Component for Excel 2010 can create files that do not conform to these rules. + +[\<16\> Section 2.2.3.11](#Appendix_A_Target_16): Graph Component for Excel 97, Graph Component for Excel 2000, Graph Component for Excel 2002, Graph Component for Office Excel 2003, Graph Component for Office Excel 2007, and Graph Component for Excel 2010 can create files that do not conform to these rules. + +[\<17\> Section 2.2.3.11](#Appendix_A_Target_17): Graph Component for Excel 97, Graph Component for Excel 2000, Graph Component for Excel 2002, Graph Component for Office Excel 2003, Graph Component for Office Excel 2007, and Graph Component for Excel 2010 can create files that do not conform to these rules. + +[\<18\> Section 2.2.4.3](#Appendix_A_Target_18): Office Excel 2007 and Excel 2010 save metadata records when cells contain formulas referencing [**cube functions**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3). However, this metadata does not remain associated with the cells and is only recorded for the purpose of load and calculation optimization. + +[\<19\> Section 2.2.9](#Appendix_A_Target_19): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 warn the user when they enter passwords that contain characters other than alphanumeric characters or punctuation symbols. + +[\<20\> Section 2.2.10](#Appendix_A_Target_20): In Excel 97, Excel 2000, Excel 2002, and Office Excel 2003 the maximum password length is 15 characters. In Office Excel 2007 and Excel 2010 the maximum password length is 255 characters. + +[\<21\> Section 2.2.10](#Appendix_A_Target_21): Only Excel 2002 and Office Excel 2003 will save files with XOR obfuscation. + +[\<22\> Section 2.2.10](#Appendix_A_Target_22): Only Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 will load and save files with RC4 CryptoAPI encryption. + +[\<23\> Section 2.4.3](#Appendix_A_Target_23): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 write a value for this field but ignore it on load. + +[\<24\> Section 2.4.3](#Appendix_A_Target_24): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 write a value for this field but ignore it on load. + +[\<25\> Section 2.4.9](#Appendix_A_Target_25): When the base unit is not days, and the data is near the base value of the [**date system**](#gt_cfc29c5e-eb23-4077-b6eb-492f20f5c87f) specified by the **Date1904 record** (section [2.4.77](#date1904)), **catMin** value can underflow and get saved as a large number. + +[\<26\> Section 2.4.9](#Appendix_A_Target_26): When the base unit is not days, and the data is near the maximum value of the date system specified by the **Date1904 record** (section 2.4.77), **catMax** value can overflow and get saved as a small number. + +[\<27\> Section 2.4.21](#Appendix_A_Target_27): Excel 97 writes 0x07CC for **rupYear**. + +[\<28\> Section 2.4.21](#Appendix_A_Target_28): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 set the value to 0 on creation, and change it to 1 in subsequent loading and saving. + +[\<29\> Section 2.4.21](#Appendix_A_Target_29): This happens only for Excel 97. + +[\<30\> Section 2.4.21](#Appendix_A_Target_30): Excel 97. + +[\<31\> Section 2.4.21](#Appendix_A_Target_31): Excel 2000. + +[\<32\> Section 2.4.21](#Appendix_A_Target_32): Excel 2002. + +[\<33\> Section 2.4.21](#Appendix_A_Target_33): Office Excel 2003. + +[\<34\> Section 2.4.21](#Appendix_A_Target_34): Office Excel 2007. + +[\<35\> Section 2.4.21](#Appendix_A_Target_35): Excel 2010 + +[\<36\> Section 2.4.21](#Appendix_A_Target_36): Excel 2013 + +[\<37\> Section 2.4.21](#Appendix_A_Target_37): Excel 97. + +[\<38\> Section 2.4.21](#Appendix_A_Target_38): Excel 2000. + +[\<39\> Section 2.4.21](#Appendix_A_Target_39): Excel 2002. + +[\<40\> Section 2.4.21](#Appendix_A_Target_40): Office Excel 2003. + +[\<41\> Section 2.4.21](#Appendix_A_Target_41): Office Excel 2007. + +[\<42\> Section 2.4.21](#Appendix_A_Target_42): Excel 2010. + +[\<43\> Section 2.4.21](#Appendix_A_Target_43): Excel 2013 + +[\<44\> Section 2.4.22](#Appendix_A_Target_44): Office Excel 2003, Office Excel 2007, and Excel 2010 will prompt the user in this case. + +[\<45\> Section 2.4.22](#Appendix_A_Target_45): This behavior does not apply to Office Excel 2007 and Excel 2010. + +[\<46\> Section 2.4.30](#Appendix_A_Target_46): Specifies either Excel 97, Excel 2000, Excel 2002, or Office Excel 2003. + +[\<47\> Section 2.4.30](#Appendix_A_Target_47): Specifies either Office Excel 2007 or Excel 2010. + +[\<48\> Section 2.4.45](#Appendix_A_Target_48): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 save negative values, but at load time the negative values are corrected to 0. + +[\<49\> Section 2.4.45](#Appendix_A_Target_49): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 save negative values, but at load time the negative values are corrected to 0. + +[\<50\> Section 2.4.45](#Appendix_A_Target_50): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 save negative values, but at load time the negative values are corrected to 0. + +[\<51\> Section 2.4.45](#Appendix_A_Target_51): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 save negative values, but at load time the negative values are corrected to 0. + +[\<52\> Section 2.4.46](#Appendix_A_Target_52): Office Excel 2007 and Excel 2010 can save values greater than or equal to 0 and less than or equal to 200. In Office Excel 2007 and Excel 2010 the view angle is determined by dividing this value by a factor of 2. + +[\<53\> Section 2.4.46](#Appendix_A_Target_53): Office Excel 2007 and Excel 2010 can save values less than 5. + +[\<54\> Section 2.4.46](#Appendix_A_Target_54): Office Excel 2007 and Excel 2010 can save values greater than 500. + +[\<55\> Section 2.4.46](#Appendix_A_Target_55): Office Excel 2007 and Excel 2010 ignores this bit and will set it back to zero if the file is resaved. + +[\<56\> Section 2.4.49](#Appendix_A_Target_56): Excel 2000 + +[\<57\> Section 2.4.49](#Appendix_A_Target_57): Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, or Excel 2013 + +[\<58\> Section 2.4.49](#Appendix_A_Target_58): Office Excel 2007 + +[\<59\> Section 2.4.49](#Appendix_A_Target_59): Excel 97 + +[\<60\> Section 2.4.49](#Appendix_A_Target_60): Excel 97 + +[\<61\> Section 2.4.49](#Appendix_A_Target_61): Excel 2000 + +[\<62\> Section 2.4.49](#Appendix_A_Target_62): Excel 2002, Office Excel 2003 + +[\<63\> Section 2.4.49](#Appendix_A_Target_63): Office Excel 2007 + +[\<64\> Section 2.4.49](#Appendix_A_Target_64): Excel 2010 + +[\<65\> Section 2.4.49](#Appendix_A_Target_65): Excel 2013 + +[\<66\> Section 2.4.49](#Appendix_A_Target_66): Excel 2000 + +[\<67\> Section 2.4.49](#Appendix_A_Target_67): Excel 2002, Office Excel 2003 + +[\<68\> Section 2.4.49](#Appendix_A_Target_68): Office Excel 2007 + +[\<69\> Section 2.4.49](#Appendix_A_Target_69): Excel 2010 + +[\<70\> Section 2.4.49](#Appendix_A_Target_70): Excel 2013 + +[\<71\> Section 2.4.54](#Appendix_A_Target_71): Specifies Office Excel 2007, or Excel 2010. + +[\<72\> Section 2.4.54](#Appendix_A_Target_72): Specifies Office Excel 2003, Excel 2002, Excel 2000, or Excel 97. + +[\<73\> Section 2.4.54](#Appendix_A_Target_73): Specifies Office Excel 2003, Excel 2002, Excel 2000, or Excel 97. + +[\<74\> Section 2.4.54](#Appendix_A_Target_74): Specifies Office Excel 2003, Excel 2002, Excel 2000, or Excel 97. + +[\<75\> Section 2.4.74](#Appendix_A_Target_75): Office Excel 2007 and Excel 2010 can save values greater than 254. + +[\<76\> Section 2.4.74](#Appendix_A_Target_76): Though the maximum zero-based series number is 254, Office Excel 2007 and Excel 2010 can save values greater than 254. + +[\<77\> Section 2.4.91](#Appendix_A_Target_77): This structure is not loaded or saved by Office Excel 2007 and Excel 2010. + +[\<78\> Section 2.4.97](#Appendix_A_Target_78): Office Excel 2003 , Excel 2002, Excel 2000, and Excel 97 can save out 0 for this field. In these cases, if the **xfprops** field specifies a solid fill pattern as part of the formatting properties, the pattern's color is stored in the background color instead of the foreground color. + +[\<79\> Section 2.4.102](#Appendix_A_Target_79): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 write out this record on save. + +[\<80\> Section 2.4.102](#Appendix_A_Target_80): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 do not ignore this record. + +[\<81\> Section 2.4.104](#Appendix_A_Target_81): Specifies Excel 97. + +[\<82\> Section 2.4.105](#Appendix_A_Target_82): Specifies Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, or Excel 2010. + +[\<83\> Section 2.4.107](#Appendix_A_Target_83): Excel 97 can saves out a different number of elements. + +[\<84\> Section 2.4.109](#Appendix_A_Target_84): This record is ignored in Office Excel 2007, and Excel 2010. + +[\<85\> Section 2.4.110](#Appendix_A_Target_85): This record is ignored in Office Excel 2007 and Excel 2010. + +[\<86\> Section 2.4.117](#Appendix_A_Target_86): This value is 0x0001 for files created using Office Excel 2007 and Excel 2010. + +[\<87\> Section 2.4.122](#Appendix_A_Target_87): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save out 0 for certain [**fonts**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). + +[\<88\> Section 2.4.122](#Appendix_A_Target_88): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can also write out the value 0 to specify a black font, or the value 72 to specify the automatic color for a control. + +[\<89\> Section 2.4.122](#Appendix_A_Target_89): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can also write out values 0 and 100 through 1000 (inclusive). + +[\<90\> Section 2.4.122](#Appendix_A_Target_90): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save values greater than 5. + +[\<91\> Section 2.4.126](#Appendix_A_Target_91): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 save values of 383 to 392. + +[\<92\> Section 2.4.129](#Appendix_A_Target_92): Specifies Excel 2000. + +[\<93\> Section 2.4.129](#Appendix_A_Target_93): Specifies Excel 2002. + +[\<94\> Section 2.4.131](#Appendix_A_Target_94): If two consecutive GelFrame records appear, the second GelFrame is a continuation of the first. + +[\<95\> Section 2.4.131](#Appendix_A_Target_95): Excel 97 does not save OPT2. + +[\<96\> Section 2.4.133](#Appendix_A_Target_96): Office Excel 2007 and Excel 2010 uses this [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) to determine if the [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) project needs to be recompiled on load by comparing the GUID in the file to the GUID built into the application. If the value is 0x0, the VBA project needs to be recompiled on load. + +[\<97\> Section 2.4.150](#Appendix_A_Target_97): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save any value from 0 to 0xFF. + +[\<98\> Section 2.4.154](#Appendix_A_Target_98): This structure is not loaded or saved by Office Excel 2007 and Excel 2010 + +[\<99\> Section 2.4.159](#Appendix_A_Target_99): This structure is not loaded or saved by Office Excel 2007 and Excel 2010. + +[\<100\> Section 2.4.191](#Appendix_A_Target_100): If the value of the **wPassword** field of the [Password](#password) record in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) is not 0x0000, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 encrypt the document as specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083), section 2.3. If an encryption password is not specified or the workbook or sheet is only protected, the document is encrypted with the default password of "\x56\x65\x6C\x76\x65\x74\x53\x77\x65\x61\x74\x73\x68\x6F\x70". + +[\<101\> Section 2.4.196](#Appendix_A_Target_101): Excel 97 and Excel 2000 do not save this field as part of the record. + +[\<102\> Section 2.4.196](#Appendix_A_Target_102): Excel 97 and Excel 2000 do not save this field as part of the record. + +[\<103\> Section 2.4.196](#Appendix_A_Target_103): Excel 97 and Excel 2000 do not save this field as part of the record. + +[\<104\> Section 2.4.206](#Appendix_A_Target_104): If the value of the **protPwdRev** field of the [Prot4RevPass](#prot4revpass) record is not 0x0000, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 encrypt the document as specified in \[MS-OFFCRYPTO\], section 2.3. If an encryption password is not specified or the workbook or sheet is only protected, the document is encrypted with the default password of "\x56\x65\x6C\x76\x65\x74\x53\x77\x65\x61\x74\x73\x68\x6F\x70". + +[\<105\> Section 2.4.208](#Appendix_A_Target_105): In the case of Excel 97 this bit specifies whether the [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) adjusts column width after refresh. If this bit is set to 1 and the **fPreserveFmt** field in the corresponding **dwQsiFuture** field of the [QsiSXTag](#qsisxtag) is set to 1 then the column width is not adjusted after refresh. + +[\<106\> Section 2.4.210](#Appendix_A_Target_106): Excel 97 + +[\<107\> Section 2.4.210](#Appendix_A_Target_107): Excel 2000 + +[\<108\> Section 2.4.210](#Appendix_A_Target_108): Excel 2002 + +[\<109\> Section 2.4.210](#Appendix_A_Target_109): Office Excel 2003 + +[\<110\> Section 2.4.210](#Appendix_A_Target_110): Office Excel 2007 + +[\<111\> Section 2.4.210](#Appendix_A_Target_111): Excel 2010 + +[\<112\> Section 2.4.210](#Appendix_A_Target_112): Excel 2013 + +[\<113\> Section 2.4.216](#Appendix_A_Target_113): This structure is not loaded or saved by Office Excel 2007 or Excel 2010. + +[\<114\> Section 2.4.218](#Appendix_A_Target_114): This record was introduced in Office Excel 2007 as a future record type. Consequently, it is preserved in [**BIFF8**](#gt_e60b71bb-c66c-4a44-ab07-0f9f20ee3dd5) format, but ignored by Office Excel 2003, Excel 2002, Excel 2000, and Excel 97. + +[\<115\> Section 2.4.241](#Appendix_A_Target_115): If the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) contains more than 4112 [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d), then Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save a file in which any record that references a sheet identifier can reference the wrong sheet. + +[\<116\> Section 2.4.248](#Appendix_A_Target_116): Office Excel 2007 and Excel 2010 will save at most 512 RefU in the rgref array of a Selection record. Office Excel 2003, Excel 2002, Excel 2000, and Excel 97 will save at most 1025 RefU in the rgref array of a Selection record. + +[\<117\> Section 2.4.258](#Appendix_A_Target_117): This record was introduced in Office Excel 2007 as a Future Record Type. Consequently, it is preserved in BIFF8 format, but ignored by Office Excel 2003, Excel 2002, Excel 2000, and Excel 97. + +[\<118\> Section 2.4.258](#Appendix_A_Target_118): This [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) stream is ignored by Office Excel 2003, Excel 2002, Excel 2000, and Excel 97. + +[\<119\> Section 2.4.259](#Appendix_A_Target_119): Saved only by Office Excel 2007 and Excel 2010. + +[\<120\> Section 2.4.267](#Appendix_A_Target_120): Excel 97 + +[\<121\> Section 2.4.267](#Appendix_A_Target_121): Excel 2000 + +[\<122\> Section 2.4.267](#Appendix_A_Target_122): Excel 2002 + +[\<123\> Section 2.4.267](#Appendix_A_Target_123): Office Excel 2003 + +[\<124\> Section 2.4.267](#Appendix_A_Target_124): Office Excel 2007 + +[\<125\> Section 2.4.267](#Appendix_A_Target_125): Excel 2010 + +[\<126\> Section 2.4.267](#Appendix_A_Target_126): Excel 2013 + +[\<127\> Section 2.4.269](#Appendix_A_Target_127): Excel 2010, Office Excel 2007, Office Excel 2003, Excel 2002, Excel 2000, and Excel 97 save out an [XLUnicodeString](#xlunicodestring) structure with 0 characters. + +[\<128\> Section 2.4.273.9](#Appendix_A_Target_128): Excel 2000 has a maximum value of 8000. Excel 2002 and Office Excel 2003 have a maximum value of 32500. Values greater than these are treated as these maximums by these applications. + +[\<129\> Section 2.4.273.108](#Appendix_A_Target_129): In certain circumstances Office Excel 2003, Excel 2002, and Excel 2000 can save out a higher value. + +[\<130\> Section 2.4.281](#Appendix_A_Target_130): Office Excel 2007 and Excel 2010 can save out **wbe** with a value of 0x2B + +[\<131\> Section 2.4.310](#Appendix_A_Target_131): Excel 97 does not create this field and ignores it if present. + +[\<132\> Section 2.4.324](#Appendix_A_Target_132): Excel can write numbers larger than 4000 due to rounding while editing small charts. + +[\<133\> Section 2.4.324](#Appendix_A_Target_133): Excel can write numbers larger than 4000 due to rounding while editing small charts. + +[\<134\> Section 2.4.324](#Appendix_A_Target_134): Excel can write numbers larger than 4000 due to rounding while editing small charts. + +[\<135\> Section 2.4.324](#Appendix_A_Target_135): Excel can write numbers larger than 4000 due to rounding while editing small charts. + +[\<136\> Section 2.4.325](#Appendix_A_Target_136): This record was introduced in Office Excel 2007 as a Future Record Type. Consequently, it is preserved in BIFF8 format, but ignored by Office Excel 2003, Excel 2002, Excel 2000, and Excel 97. + +[\<137\> Section 2.4.326](#Appendix_A_Target_137): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save value 123820, which also indicates default [**theme**](#gt_8b5eb4c0-949b-47d9-8b63-b9bda81d61b8). + +[\<138\> Section 2.4.329](#Appendix_A_Target_138): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 also use the value "2" to specify justify low alignment. Justify low occurs when Arabic kashida justification is applied to the text. Justify low lengthens kashidas slightly. + +[\<139\> Section 2.4.329](#Appendix_A_Target_139): Justified alignment is not supported in Office Excel 2007 and Excel 2010 and is treated as middle alignment. + +[\<140\> Section 2.4.329](#Appendix_A_Target_140): Excel 97 – East Asian version, Excel 2000 – East Asian version, Excel 2002 – East Asian version, Office Excel 2003 – East Asian version, or Office Excel 2007 – East Asian version, or Excel 2010 – East Asian version. + +[\<141\> Section 2.4.335](#Appendix_A_Target_141): Excel 97, Excel 2000, Excel 2002, and Office Excel 2003 do not set this bit to 1. + +[\<142\> Section 2.4.337](#Appendix_A_Target_142): Excel 97, Excel 2000, Excel 2002, and Office Excel 2003 can save out a value of 0x0001, indicating that natural language formulas are enabled. This feature is deprecated in Office Excel 2007 and Excel 2010. + +[\<143\> Section 2.4.344](#Appendix_A_Target_143): Stream does not exist in Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, or Excel 2010. + +[\<144\> Section 2.4.346](#Appendix_A_Target_144): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 truncate **wScaleSLV** into a byte when saving. + +[\<145\> Section 2.4.346](#Appendix_A_Target_145): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 truncate **wScaleNormal** into a byte when saving. + +[\<146\> Section 2.4.353](#Appendix_A_Target_146): If the Transition Navigation Keys option is turned on, the set of prefix characters is single quote, double quote, caret, and backslash, which indicate left-alignment, right-alignment, center-alignment, and fill alignment, respectively. If the Transition Navigation Keys option is turned off, the only possible prefix character is single quote, which has no alignment significance but indicates (like all prefix characters) that the cell contents are to be treated as a string literal. + +[\<147\> Section 2.4.353](#Appendix_A_Target_147): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save 0 in this field when **fStyle** equals 1. + +[\<148\> Section 2.5.4](#Appendix_A_Target_148): Can be 0 if **year** is equal to 1900 and **month** is equal to 1 and the calendar is Gregorian. + +[\<149\> Section 2.5.9](#Appendix_A_Target_149): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save XL8_ITBLJAPAN2, XL8_ITBLJAPAN3, XL8_ITBLJAPAN4, and XL8_ITBLNONE_JPN as 0x0000, 0x0001, 0x0002, and 0x0003. In this case, values 0x0000 through 0x0010 are saved as 0x0004 through 0x0014. + +[\<150\> Section 2.5.10](#Appendix_A_Target_150): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save bBoolErr with an error value instead of a Boolean value when fError is 0x00. + +[\<151\> Section 2.5.16](#Appendix_A_Target_151): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 save out 0xFF. + +[\<152\> Section 2.5.20](#Appendix_A_Target_152): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 also save out 0 to specify a black background. + +[\<153\> Section 2.5.21](#Appendix_A_Target_153): The Alpha channel value in the [LongRGBA](#longrgba) structure is ignored and set to 0xFF (opaque). + +[\<154\> Section 2.5.27](#Appendix_A_Target_154): If Office Excel 2007 or Excel 2010 save different values for **cp** in the [CFEx](#cfex) and [CF](#cf) records, then the value in CFEx takes precedence over the value in CF. + +[\<155\> Section 2.5.32](#Appendix_A_Target_155): Office Excel 2007 and Excel 2010 will not apply any coloring to a cell when its CFVO value falls outside of the range of the interpolation curve and **fClamp** is not set. + +[\<156\> Section 2.5.60](#Appendix_A_Target_156): Specifies Excel 97. + +[\<157\> Section 2.5.60](#Appendix_A_Target_157): Specifies Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, or Excel 2010. + +[\<158\> Section 2.5.60](#Appendix_A_Target_158): Specifies Excel 97. + +[\<159\> Section 2.5.60](#Appendix_A_Target_159): Specifies Excel 2000. + +[\<160\> Section 2.5.63](#Appendix_A_Target_160): The following table shows the maximum [data functionality levels](#Section_2bcedd76ef064e6084c718ea55042ed6) that different application versions support: + +| Value | Maximum data functionality level for | +|-------|--------------------------------------| +| 0 | Excel 97 and Excel 2000 | +| 1 | Excel 2002 and Office Excel 2003 | +| 3 | Office Excel 2007 | +| 4 | Excel 2010 | + +[\<161\> Section 2.5.63](#Appendix_A_Target_161): In Excel 97, Excel 2000, Excel 2002, and Office Excel 2003, the values of some data functionality level fields might not reflect the correct data functionality level. + +[\<162\> Section 2.5.65](#Appendix_A_Target_162): In the 1900 date system, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 treat the year 1900 as though it was a leap year. That is, the value 59 corresponds to February 28, and the value 61 corresponds to March 1, allowing the (non-existent) date February 29 to have the value 60. + +[\<163\> Section 2.5.91](#Appendix_A_Target_163): Office Excel 2007 and Excel 2010 can saves a value greater than 15 and less than 255. + +[\<164\> Section 2.5.113](#Appendix_A_Target_164): This value is only possible in the context of a [Feature12](#feature12) record, and cannot be written by Office Excel 2003. + +[\<165\> Section 2.5.113](#Appendix_A_Target_165): Office Excel 2003 does not save the **totalFmla** field; **fLoadTotalFmla** is 0. + +[\<166\> Section 2.5.118](#Appendix_A_Target_166): This structure only exists in the context of a Feature12 record, and cannot be written by Office Excel 2003. + +[\<167\> Section 2.5.127](#Appendix_A_Target_167): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can write out values 0x13 through 0x24. + +[\<168\> Section 2.5.129](#Appendix_A_Target_168): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save out values 511 through 1022. + +[\<169\> Section 2.5.129](#Appendix_A_Target_169): These 4 default structures are saved out as identical [Font](#font) structures. They are placeholders for their respective font formatting properties. + +[\<170\> Section 2.5.130](#Appendix_A_Target_170): This value is ignored in Office Excel 2007 and Excel 2010. + +[\<171\> Section 2.5.134](#Appendix_A_Target_171): The [Feature11](#feature11) and Feature12 records set the **ref8.rwFirst**, **ref8.rwLast**, **ref8.colFirst**, and **ref8.colLast** fields even if **fFrtRef** is 0. + +[\<172\> Section 2.5.143](#Appendix_A_Target_172): Excel 97, Excel 2000, Excel 2002, and Office Excel 2003 all write out a value of 0 for this field and ignore it on load. + +[\<173\> Section 2.5.162](#Appendix_A_Target_173): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can write out [Icv](#icv) values 0x0000 and 0x0001. Office Excel 2007 and Excel 2010 can also writes out Icv values that are greater than or equal to 0x0002 and less than or equal to 0x0007. + +[\<174\> Section 2.5.164](#Appendix_A_Target_174): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can writes out Icv values greater than or equal to 0x01 and less than or equal to 0x07, or the value 0x48, which specifies the system color for text in windows. + +[\<175\> Section 2.5.165](#Appendix_A_Target_175): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can write values greater than or equal to 0x017F and less than or equal to 0x0188, but they will not be loaded. + +[\<176\> Section 2.5.198.18](#Appendix_A_Target_176): In Office Excel 2007 and Excel 2010, [**natural language formulas**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) are transformed into [**A1**](#gt_950691d0-4b64-4e03-84ae-10d6c872bbdb) references. + +[\<177\> Section 2.5.198.23](#Appendix_A_Target_177): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can write out an **rgce** which contain [PtgArray](#ptgarray). + +[\<178\> Section 2.5.198.104](#Appendix_A_Target_178): Excel 97, Excel 2000, Excel 2002 and Office Excel 2003 write out these [Ptg](#ptg)s. Office Excel 2007 and Excel 2010 convert these Ptgs to equivalent [PtgArea](#ptgarea)s or [PtgAreaErr](#ptgareaerr)s on load and never introduces these Ptgs. + +[\<179\> Section 2.5.203](#Appendix_A_Target_179): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 expect the **cbKey** field in the **PictFmlaKey** structure to be an even value. + +[\<180\> Section 2.5.244](#Appendix_A_Target_180): ltExternalData is only read and saved by Office Excel 2007 and Excel 2010. + +[\<181\> Section 2.5.248](#Appendix_A_Target_181): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save out 0 for certain fonts. + +[\<182\> Section 2.5.248](#Appendix_A_Target_182): Office Excel 2003, Office Excel 2007, and Excel 2010 can also write out 0. + +[\<183\> Section 2.5.266](#Appendix_A_Target_183): Office Excel 2003 has unique table identifiers per sheet rather than per workbook. On load, Office Excel 2007 and Excel 2010 reassigns new identifiers if identical ones exist within a same workbook. + +[\<184\> Section 2.5.266](#Appendix_A_Target_184): Set to 0x1 in case of Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for [**worksheets**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) created using Office Excel 2003. + +[\<185\> Section 2.5.266](#Appendix_A_Target_185): Office Excel 2007 and Excel 2010 will only write out the value of 1 for this field. + +[\<186\> Section 2.5.266](#Appendix_A_Target_186): Office Excel 2003 saves 0xB, Office Excel 2007 saves 0xC, Excel 2010 saves 0xE. + +[\<187\> Section 2.5.266](#Appendix_A_Target_187): Office Excel 2003, Office Excel 2007, and Excel 2010 do not ignore this field. + +[\<188\> Section 2.5.272](#Appendix_A_Target_188): For files last saved in East Asian versions of the application, **lastRun** can be a [Run](#run) instead of a [TxoLastRun](#txolastrun). + +[\<189\> Section 2.5.282](#Appendix_A_Target_189): Specifies Office Excel 2007. + +[\<190\> Section 2.5.314](#Appendix_A_Target_190): Office Excel 2007 and Excel 2010 can save values larger than 500. + +[\<191\> Section 2.5.342](#Appendix_A_Target_191): Under certain circumstances, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 persist these values. + +[\<192\> Section 2.5.344](#Appendix_A_Target_192): Office Excel 2003, Office Excel 2007, and Excel 2010 can save a value of -1 on the **itabLast** field for either a workbook-level or a sheet-level reference to an [external workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc) if an [**Information Rights Management (IRM)**](#gt_ff35237a-a497-42aa-b0d5-7a0116328759) authorization failure occurred during a refresh of that workbook's data. + +[\<193\> Section 2.6.2](#Appendix_A_Target_193): Web-only view is only used by Excel 97, Excel 2000, Excel 2002, and Office Excel 2003. + +# Change Tracking + +This section identifies changes that were made to this document since the last release. Changes are classified as Major, Minor, or None. + +The revision class **Major** means that the technical content in the document was significantly revised. Major changes affect protocol interoperability or implementation. Examples of major changes are: + +- A document revision that incorporates changes to interoperability requirements. + +- A document revision that captures changes to protocol functionality. + +The revision class **Minor** means that the meaning of the technical content was clarified. Minor changes do not affect protocol interoperability or implementation. Examples of minor changes are updates to clarify ambiguity at the sentence, paragraph, or table level. + +The revision class **None** means that no new technical changes were introduced. Minor editorial and formatting changes may have been made, but the relevant technical content is identical to the last released version. + +The changes made to this document are listed in the following table. For more information, please contact . + +| Section | Description | Revision class | +|----|----|----| +| [2.2.5.4.7.2](#Section_bd4665ebb56a44e690b9ceaf7ec55389) OLAP Manual Filters | Formatted the member glossary. | Minor | +| [2.2.6.3](#Section_4ac7212b4aa74ece962526c58224ae80) Table Styles | Updated '\[ECMA-376\] part 4, 3.8.40' to '\[ECMA-376\] part 1, 18.8.40'. | Minor | +| [2.2.9](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4) Password Verifier Algorithm | Updated '\[ECMA-376\] part 4, 3.2.29' to '\[ECMA-376\] Part 4, 15.3.3'. | Minor | +| [2.2.10](#Section_0f2ea0a19fc8468d97aa9d333b72d106) Encryption (Password to Open) | Updated '\[ECMA-376\] part 4, 3.2.29' to '\[ECMA-376\] Part 4, 15.3.3'. | Minor | +| [2.4.117](#filepass) FilePass | Updated 'For more information' to 'For more details'. | Minor | +| [2.4.126](#format) Format | Updated '\[ECMA-376\] Part 4: Markup Language Reference, section 3.8.31' to 'ECMA-376\] Part 1: Fundamentals And Markup Language Reference, section 18.8.31'. | Minor | +| [2.4.182](#objectlink) ObjectLink | Formatted the category glossary. | Minor | +| [2.4.193](#picf) PicF | Formatted the dimension glossary. | Minor | +| [2.4.218](#richtextstream) RichTextStream | Updated '\[ECMA-376\] Part 4, section 5.7.2.217' to '\[ECMA-376\] Part 1, section 21.2.2.216'. | Minor | +| [2.4.223](#rrdchgcell) RRDChgCell | Updated '\[ECMA-376\] Part 4: Markup Language Reference, section 3.8.31' to 'ECMA-376\] Part 1: Fundamentals And Markup Language Reference, section 18.8.31'. | Minor | +| [2.4.258](#shapepropsstream) ShapePropsStream | Updated '\[ECMA-376\] Part 4, section 5.7.2.198' to '\[ECMA-376\] Part 1, section 21.2.2.197'. | Minor | +| [2.4.266](#startblock) StartBlock | Formatted the category glossary. | Minor | +| [2.4.325](#textpropsstream) TextPropsStream | Updated '\[ECMA-376\] Part 4, section 5.7.2.217' to '\[ECMA-376\] Part 1, section 21.2.2.216'. | Minor | +| [2.5.16](#builtinstyle) BuiltInStyle | Updated '\[ECMA-376\] Part 4: Markup Language Reference, section 3.8.7' to '\[ECMA-376\] Part 1: Fundamentals And Markup Language Reference, section 8.8.7'. | Minor | +| [2.5.113](#feat11fielddataitem) Feat11FieldDataItem | Updated 'For more information' to 'For more details'. | Minor | +| [2.5.165](#ifmt) IFmt | Updated '\[ECMA-376\] Part 4: Markup Language Reference, section 3.8.30' to '\[ECMA-376\] Part 1: Fundamentals And Markup Language Reference, section 18.8.30'. | Minor | +| [2.5.192](#officeartclientanchorhf) OfficeArtClientAnchorHF | Formatted the dimension glossary. | Minor | +| [2.5.305](#xmltkcolormappingoverride) XmlTkColorMappingOverride | Updated '\[ECMA-376\] Part 4, section 4.4.1.7' to '\[ECMA-376\] Part 1, section 19.3.1.7'. | Minor | +| [2.5.312](#xmltkformatcodefrt) XmlTkFormatCodeFrt | Updated '\[ECMA-376\] Part 4: Markup Language Reference, section 3.8.31' to 'ECMA-376\] Part 1: Fundamentals And Markup Language Reference, section 18.8.31'. | Minor | +| [2.5.330](#xmltkspb) XmlTkSpb | Updated '\[ECMA-376\] Part 4, section 5.7.2.198' to '\[ECMA-376\] Part 1, section 21.2.2.197'. | Minor | +| [2.5.336](#xmltkthemeoverride) XmlTkThemeOverride | Updated '\[ECMA-376\] Part 4, section 5.1.8.12' to '\[ECMA-376\] Part 1, section 20.1.6.12'. | Minor | +| [2.5.341](#xmltktpb) XmlTkTpb | Updated '\[ECMA-376\] Part 4, section 5.7.2.217' to '\[ECMA-376\] Part 1, section 21.2.2.216'. | Minor | +| [2.7.1](#Section_9b5f0e3c743b4680b0aa2ac80730c325) Application Data For VtHyperlink | Updated 'shape \[MS-ODRAW\] section 2.2.31' to 'shape \[MS-ODRAW\] section 2.3.2'. | Minor | +| [3.6.1](#Section_4be49154bbba4fc58611c4c0e2d4df43) Column Chart Object: Chart | Formatted the dimension glossary. | Minor | +| [3.6.12](#Section_7dbf98b4b476424b8ac4e4ce4b97e955) Column Chart Object: ShtProps | Formatted the dimension glossary. | Minor | +| [3.6.19](#Section_af132675460a4d5890ba0c37bdbed3fe) Column Chart Object: CatSerRange | Formatted the category glossary. | Minor | +| [4](#Section_6df63a1fecd54d13801ea5321aa39caa) Security Considerations | Updated '\[ECMA-376\] part 4, 3.2.29' to '\[ECMA-376\] Part 4, 15.3.3'. | Minor | + +# Index + +A + +[AddinUdf](#addinudf) 588 + +[ADO recordset connections](#ado-recordset-connections) 164 + +[AF12CellIcon](#af12cellicon) 588 + +[AF12Criteria](#af12criteria) 589 + +[AF12DateInfo](#af12dateinfo) 589 + +[AFDOper](#afdoper) 590 + +[AFDOperBoolErr](#afdoperboolerr) 591 + +[AFDOperRk](#afdoperrk) 592 + +[AFDOperStr](#afdoperstr) 592 + +Algorithms + +[Application data for VtHyperlink](#application-data-for-vthyperlink) 924 + +[AlRuns](#alruns) 192 + +[Applicability](#applicability-statement) 55 + +[Application data for VtHyperlink](#application-data-for-vthyperlink) 924 + +[Area](#area) 192 + +[AreaFormat](#areaformat) 193 + +[Array](#array) 198 + +[ArrayParsedFormula](#arrayparsedformula) 725 + +[Attached label](#attached-label) 103 + +[AttachedLabel](#attachedlabel) 199 + +[AutoFilter](#autofilter) 200 + +[AutoFilter12](#autofilter12) 202 + +[AutoFilterInfo](#autofilterinfo) 205 + +[AutoFmt8](#autofmt8) 593 + +[AxcExt](#axcext) 205 + +[AxesUsed](#axesused) 208 + +Axis ([section 2.2.3.6](#axis) 89, [section 2.4.11](#axis-1) 208) + +[axis group](#axis-group) 87 + +[AxisLine](#axisline) 209 + +[AxisParent](#axisparent) 210 + +B + +[Backup](#backup) 210 + +[Bar](#bar) 210 + +[BCUsrs](#bcusrs) 211 + +[Begin](#begin) 211 + +[BErr](#berr) 725 + +[Bes](#bes) 594 + +[BigName](#bigname) 212 + +[BkHim](#bkhim) 212 + +[Blank](#blank) 213 + +[BOF](#bof) 213 + +[Bold](#bold) 595 + +[BookBool](#bookbool) 215 + +[BookExt](#bookext) 216 + +[BookExt_Conditional11](#bookext_conditional11) 595 + +[BookExt_Conditional12](#bookext_conditional12) 595 + +[Boolean](#boolean) 596 + +[BoolErr](#boolerr) 217 + +[BopPop](#boppop) 217 + +[BopPopCustom](#boppopcustom) 219 + +[BorderStyle](#borderstyle) 596 + +[BottomMargin](#bottommargin) 220 + +[BoundSheet8](#boundsheet8) 221 + +[BRAI](#brai) 222 + +[BuiltInFnGroupCount](#builtinfngroupcount) 223 + +[BuiltInStyle](#builtinstyle) 597 + +[Byte ordering](#stream-byte-ordering) 54 + +C + +[CachedDiskHeader](#cacheddiskheader) 597 + +[CalcCount](#calccount) 224 + +[CalcDelta](#calcdelta) 224 + +[CalcIter](#calciter) 224 + +[CalcMode](#calcmode) 224 + +[CalcPrecision](#calcprecision) 225 + +[CalcRefMode](#calcrefmode) 225 + +[CalcSaveRecalc](#calcsaverecalc) 225 + +[CatLab](#catlab) 226 + +[CatSerRange](#catserrange) 226 + +[CbUsr](#cbusr) 228 + +[Cch255](#cch255) 598 + +[Cell](#cell) 598 + +[Cell metadata](#cell-metadata) 105 + +[Cell table](#cell-table) 80 + +[retrieval of last-calculated cell values without loading cell table](#retrieval-of-last-calculated-cell-values-without-loading-cell-table) 81 + +[CellParsedFormula](#cellparsedformula) 726 + +[CellWatch](#cellwatch) 228 + +[CellXF](#cellxf) 598 + +[Cetab](#cetab) 726 + +[CF](#cf) 229 + +[CF12](#cf12) 230 + +[CFColor](#cfcolor) 602 + +[CFDatabar](#cfdatabar) 602 + +[CFEx](#cfex) 233 + +[CFExAveragesTemplateParams](#cfexaveragestemplateparams) 604 + +[CFExDateTemplateParams](#cfexdatetemplateparams) 604 + +[CFExDefaultTemplateParams](#cfexdefaulttemplateparams) 605 + +[CFExFilterParams](#cfexfilterparams) 605 + +[CFExNonCF12](#cfexnoncf12) 606 + +[CFExTemplateParams](#cfextemplateparams) 608 + +[CFExTextTemplateParams](#cfextexttemplateparams) 609 + +[CFFilter](#cffilter) 609 + +[CFFlag](#cfflag) 610 + +[CFGradient](#cfgradient) 611 + +[CFGradientInterpItem](#cfgradientinterpitem) 611 + +[CFGradientItem](#cfgradientitem) 612 + +[CFMStateItem](#cfmstateitem) 613 + +[CFMultistate](#cfmultistate) 613 + +[CFParsedFormula](#cfparsedformula) 755 + +[CFParsedFormulaNoCCE](#cfparsedformulanocce) 755 + +[CFrtId](#cfrtid) 614 + +[CFT](#cft) 615 + +[CFVO](#cfvo) 616 + +[CFVOParsedFormula](#cfvoparsedformula) 755 + +[Change cells revision](#change-cells-revision) 169 + +[Change tracking](#change-tracking) 1096 + +Chart ([section 2.1.6.1](#chart) 59, [section 2.2.3.3](#chart-1) 86, [section 2.4.45](#chart-2) 234) + +[Chart data cache](#chart-data-cache) 85 + +[Chart group](#chart-group) 91 + +[Chart sheet](#chart-sheet) 84 + +[Chart3d](#chart3d) 235 + +[Chart3DBarShape](#chart3dbarshape) 237 + +[ChartFormat](#chartformat) 237 + +[ChartFrtInfo](#chartfrtinfo) 238 + +[ChartNumNillable](#chartnumnillable) 617 + +[ChartParsedFormula](#chartparsedformula) 756 + +[Charts](#charts) 83 + +[attached label](#attached-label) 103 + +[axis](#axis) 89 + +[axis group](#axis-group) 87 + +[chart](#chart-1) 86 + +[chart data cache](#chart-data-cache) 85 + +[chart group](#chart-group) 91 + +[chart sheet](#chart-sheet) 84 + +[data label](#data-label) 95 + +[data point](#data-point) 95 + +[data table](#data-table) 102 + +[error bar](#error-bar) 101 + +[legend](#legend) 92 + +[pivot chart](#pivot-chart) 87 + +[series](#series) 94 + +[SPRC](#sprc) 104 + +[trendline](#trendline) 101 + +[ClrtClient](#clrtclient) 239 + +[CodeName](#codename) 240 + +[CodePage](#codepage) 240 + +[Col](#col) 617 + +[Col_NegativeOne](#col_negativeone) 617 + +[Col12](#col12) 618 + +[Col256U](#col256u) 618 + +[ColByte](#colbyte) 618 + +[ColByteU](#colbyteu) 619 + +[ColElfU](#colelfu) 619 + +[ColInfo](#colinfo) 241 + +[Collection of records](#collection-of-records) 58 + +[ColorICV](#coloricv) 619 + +[ColorTheme](#colortheme) 620 + +[ColRelNegU](#colrelnegu) 620 + +[ColRelU](#colrelu) 621 + +[ColSlco8U](#colslco8u) 621 + +[ColU](#colu) 621 + +[Column Chart Object example](#column-chart-object) 956 + +[Column chart object: AreaFormat example](#column-chart-object-areaformat) 959 + +[Column chart object: AxesUsed example](#column-chart-object-axesused) 969 + +[Column chart object: Axis example](#column-chart-object-axis) 970 + +[Column chart object: AxisParent example](#column-chart-object-axisparent) 970 + +[Column chart object: Bar example](#column-chart-object-bar) 973 + +[Column chart object: BRAI 1 example](#column-chart-object-brai-1) 960 + +[Column chart object: BRAI 2 example](#column-chart-object-brai-2) 962 + +[Column chart object: BRAI 3 example](#column-chart-object-brai-3) 964 + +[Column chart object: CatSerRange example](#column-chart-object-catserrange) 970 + +[Column chart object: Chart example](#column-chart-object-chart) 957 + +[Column chart object: ChartFormat example](#column-chart-object-chartformat) 972 + +[Column chart object: DataFormat example](#column-chart-object-dataformat) 966 + +[Column chart object: DefaultText example](#column-chart-object-defaulttext) 967 + +[Column chart object: FontX example](#column-chart-object-fontx) 969 + +[Column chart object: Frame example](#column-chart-object-frame) 957 + +[Column chart object: LineFormat example](#column-chart-object-lineformat) 958 + +[Column chart object: Series example](#column-chart-object-series) 960 + +[Column chart object: SeriesText example](#column-chart-object-seriestext) 962 + +[Column chart object: SerToCrt example](#column-chart-object-sertocrt) 966 + +[Column chart object: ShtProps example](#column-chart-object-shtprops) 966 + +[Column chart object: Text example](#column-chart-object-text) 967 + +[Column chart object: Tick example](#column-chart-object-tick) 971 + +[Colx](#colx) 622 + +[Compat12](#compat12) 242 + +[Component object stream](#component-object-stream-001compobj) 59 + +[Compound file](#compound-file) 57 + +[CompressPictures](#compresspictures) 242 + +[Conceptual overview](#conceptual-overview) 80 + +[cell table](#cell-table) 80 + +[charts](#charts) 83 + +[encryption (password to open)](#encryption-password-to-open) 165 + +[external connections](#external-connections) 163 + +[external references](#external-references) 161 + +[formulas](#formulas) 81 + +[metadata](#metadata) 104 + +[password verifier algorithm](#password-verifier-algorithm) 164 + +[PivotTables](#pivottables) 107 + +[shared feature](#shared-feature) 169 + +[shared workbooks](#shared-workbooks) 166 + +[styles](#styles) 158 + +[CondDataValue](#conddatavalue) 622 + +[CondFmt](#condfmt) 243 + +[CondFmt12](#condfmt12) 243 + +[CondFmtStructure](#condfmtstructure) 622 + +[Conditional Formatting example](#conditional-formatting-1) 925 + +[Conditional formatting: CF example](#conditional-formatting-cf) 927 + +[Conditional formatting: CondFmt example](#conditional-formatting-condfmt) 925 + +[Connection files](#external-connection-files) 163 + +[Connection name](#connection-name) 163 + +[ConnGrbitDbt](#conngrbitdbt) 623 + +[ConnGrbitDbtAdo](#conngrbitdbtado) 623 + +[ConnGrbitDbtOledb](#conngrbitdbtoledb) 624 + +[ConnGrbitDbtWeb](#conngrbitdbtweb) 625 + +[Continue](#continue) 244 + +[Continue_SxaddlSxString](#continue_sxaddlsxstring) 432 + +[ContinueBigName](#continuebigname) 244 + +[ContinueFrt](#continuefrt) 245 + +[ContinueFrt11](#continuefrt11) 245 + +[ContinueFrt12](#continuefrt12) 246 + +[Control stream](#control-stream-ctls) 60 + +[Control tokens](#control-tokens) 83 + +[ControlInfo](#controlinfo) 626 + +[Country](#country) 246 + +[CrErr](#crerr) 248 + +[CRN](#crn) 248 + +[CrtLayout12](#crtlayout12) 249 + +[CrtLayout12A](#crtlayout12a) 251 + +[CrtLayout12Mode](#crtlayout12mode) 626 + +[CrtLine](#crtline) 253 + +[CrtLink](#crtlink) 254 + +[CrtMlFrt](#crtmlfrt) 254 + +[CrtMlFrtContinue](#crtmlfrtcontinue) 255 + +[CTB](#ctb) 921 + +[CTBS](#ctbs) 920 + +[CTBWRAPPER](#ctbwrapper) 920 + +[CUsr](#cusr) 255 + +D + +[DAO recordset connections](#dao-recordset-connections) 164 + +[Dat](#dat) 255 + +[data functionality level](#data-functionality-level) 118 + +[Data label](#data-label) 95 + +[Data point](#data-point) 95 + +[Data spaces storage](#data-spaces-storage-006dataspaces) 60 + +[Data table](#data-table) 102 + +[DataFormat](#dataformat) 256 + +[DataFunctionalityLevel](#datafunctionalitylevel) 627 + +DataLabExt ([section 2.4.75](#datalabext) 256, [section 2.4.76](#datalabextcontents) 257) + +[DataSourceType](#datasourcetype) 627 + +[Date1904](#date1904) 258 + +[DateAsNum](#dateasnum) 627 + +[DateUnit](#dateunit) 627 + +[DBCell](#dbcell) 258 + +[DbOrParamQry](#dborparamqry) 259 + +[DbQuery](#dbquery) 259 + +[DbQueryExt](#dbqueryext) 261 + +[DCol](#dcol) 628 + +[DColByteU](#dcolbyteu) 628 + +[DCon](#dcon) 263 + +[DConBin](#dconbin) 265 + +[DConFile](#dconfile) 628 + +[DConn](#dconn) 266 + +[DConName](#dconname) 271 + +[DConnConnectionOleDb](#dconnconnectionoledb) 629 + +[DConnConnectionWeb](#dconnconnectionweb) 630 + +[DConnId](#dconnid) 630 + +[DConnParamBinding](#dconnparambinding) 631 + +[DConnParamBindingValByte](#dconnparambindingvalbyte) 631 + +[DConnParamBindingValInt](#dconnparambindingvalint) 631 + +[DConnParamBindingValString](#dconnparambindingvalstring) 631 + +[DConnParamBindingValType](#dconnparambindingvaltype) 632 + +[DConnParameter](#dconnparameter) 632 + +[DConnStringSequence](#dconnstringsequence) 633 + +[DConnUnicodeStringSegmented](#dconnunicodestringsegmented) 633 + +[DConRef](#dconref) 272 + +[DDE data item](#dde-data-item) 162 + +[DDE data source](#dde-data-source) 162 + +[DefaultRowHeight](#defaultrowheight) 273 + +[DefaultText](#defaulttext) 273 + +[DefColWidth](#defcolwidth) 274 + +[Defined Name example](#defined-name) 934 + +[Defined name: ExternSheet example](#defined-name-externsheet) 936 + +[Defined name: Lbl example](#defined-name-lbl) 934 + +[Defined name: SupBook example](#defined-name-supbook) 937 + +Details + +[AddinUdf structure](#addinudf) 588 + +[AF12CellIcon structure](#af12cellicon) 588 + +[AF12Criteria structure](#af12criteria) 589 + +[AF12DateInfo structure](#af12dateinfo) 589 + +[AFDOper structure](#afdoper) 590 + +[AFDOperBoolErr structure](#afdoperboolerr) 591 + +[AFDOperRk structure](#afdoperrk) 592 + +[AFDOperStr structure](#afdoperstr) 592 + +[AlRuns record](#alruns) 192 + +[Application data for VtHyperlink algorithm](#application-data-for-vthyperlink) 924 + +[Area record](#area) 192 + +[AreaFormat record](#areaformat) 193 + +[Array record](#array) 198 + +[ArrayParsedFormula structure](#arrayparsedformula) 725 + +[AttachedLabel record](#attachedlabel) 199 + +[AutoFilter record](#autofilter) 200 + +[AutoFilter12 record](#autofilter12) 202 + +[AutoFilterInfo record](#autofilterinfo) 205 + +[AutoFmt8 structure](#autofmt8) 593 + +[AxcExt record](#axcext) 205 + +[AxesUsed record](#axesused) 208 + +[Axis record](#axis-1) 208 + +[AxisLine record](#axisline) 209 + +[AxisParent record](#axisparent) 210 + +[Backup record](#backup) 210 + +[Bar record](#bar) 210 + +[BCUsrs record](#bcusrs) 211 + +[Begin record](#begin) 211 + +[BErr structure](#berr) 725 + +[Bes structure](#bes) 594 + +[BigName record](#bigname) 212 + +[BkHim record](#bkhim) 212 + +[Blank record](#blank) 213 + +[BOF record](#bof) 213 + +[Bold structure](#bold) 595 + +[BookBool record](#bookbool) 215 + +[BookExt record](#bookext) 216 + +[BookExt_Conditional11 structure](#bookext_conditional11) 595 + +[BookExt_Conditional12 structure](#bookext_conditional12) 595 + +[Boolean structure](#boolean) 596 + +[BoolErr record](#boolerr) 217 + +[BopPop record](#boppop) 217 + +[BopPopCustom record](#boppopcustom) 219 + +[BorderStyle structure](#borderstyle) 596 + +[BottomMargin record](#bottommargin) 220 + +[BoundSheet8 record](#boundsheet8) 221 + +[BRAI record](#brai) 222 + +[BuiltInFnGroupCount record](#builtinfngroupcount) 223 + +[BuiltInStyle structure](#builtinstyle) 597 + +[CachedDiskHeader structure](#cacheddiskheader) 597 + +[CalcCount record](#calccount) 224 + +[CalcDelta record](#calcdelta) 224 + +[CalcIter record](#calciter) 224 + +[CalcMode record](#calcmode) 224 + +[CalcPrecision record](#calcprecision) 225 + +[CalcRefMode record](#calcrefmode) 225 + +[CalcSaveRecalc record](#calcsaverecalc) 225 + +[CatLab record](#catlab) 226 + +[CatSerRange record](#catserrange) 226 + +[CbUsr record](#cbusr) 228 + +[Cch255 structure](#cch255) 598 + +[Cell structure](#cell) 598 + +[CellParsedFormula structure](#cellparsedformula) 726 + +[CellWatch record](#cellwatch) 228 + +[CellXF structure](#cellxf) 598 + +[Cetab structure](#cetab) 726 + +[CF record](#cf) 229 + +[CF12 record](#cf12) 230 + +[CFColor structure](#cfcolor) 602 + +[CFDatabar structure](#cfdatabar) 602 + +[CFEx record](#cfex) 233 + +[CFExAveragesTemplateParams structure](#cfexaveragestemplateparams) 604 + +[CFExDateTemplateParams structure](#cfexdatetemplateparams) 604 + +[CFExDefaultTemplateParams structure](#cfexdefaulttemplateparams) 605 + +[CFExFilterParams structure](#cfexfilterparams) 605 + +[CFExNonCF12 structure](#cfexnoncf12) 606 + +[CFExTemplateParams structure](#cfextemplateparams) 608 + +[CFExTextTemplateParams structure](#cfextexttemplateparams) 609 + +[CFFilter structure](#cffilter) 609 + +[CFFlag structure](#cfflag) 610 + +[CFGradient structure](#cfgradient) 611 + +[CFGradientInterpItem structure](#cfgradientinterpitem) 611 + +[CFGradientItem structure](#cfgradientitem) 612 + +[CFMStateItem structure](#cfmstateitem) 613 + +[CFMultistate structure](#cfmultistate) 613 + +[CFParsedFormula structure](#cfparsedformula) 755 + +[CFParsedFormulaNoCCE structure](#cfparsedformulanocce) 755 + +[CFrtId structure](#cfrtid) 614 + +[CFT structure](#cft) 615 + +[CFVO structure](#cfvo) 616 + +[CFVOParsedFormula structure](#cfvoparsedformula) 755 + +[Chart record](#chart-2) 234 + +[Chart3d record](#chart3d) 235 + +[Chart3DBarShape record](#chart3dbarshape) 237 + +[ChartFormat record](#chartformat) 237 + +[ChartFrtInfo record](#chartfrtinfo) 238 + +[ChartNumNillable structure](#chartnumnillable) 617 + +[ChartParsedFormula structure](#chartparsedformula) 756 + +[ClrtClient record](#clrtclient) 239 + +[CodeName record](#codename) 240 + +[CodePage record](#codepage) 240 + +[Col structure](#col) 617 + +[Col_NegativeOne structure](#col_negativeone) 617 + +[Col12 structure](#col12) 618 + +[Col256U structure](#col256u) 618 + +[ColByte structure](#colbyte) 618 + +[ColByteU structure](#colbyteu) 619 + +[ColElfU structure](#colelfu) 619 + +[ColInfo record](#colinfo) 241 + +[ColorICV structure](#coloricv) 619 + +[ColorTheme structure](#colortheme) 620 + +[ColRelNegU structure](#colrelnegu) 620 + +[ColRelU structure](#colrelu) 621 + +[ColSlco8U structure](#colslco8u) 621 + +[ColU structure](#colu) 621 + +[Colx structure](#colx) 622 + +[Compat12 record](#compat12) 242 + +[component object stream](#component-object-stream-001compobj) 59 + +[CompressPictures record](#compresspictures) 242 + +[CondDataValue structure](#conddatavalue) 622 + +[CondFmt record](#condfmt) 243 + +[CondFmt12 record](#condfmt12) 243 + +[CondFmtStructure structure](#condfmtstructure) 622 + +[ConnGrbitDbt structure](#conngrbitdbt) 623 + +[ConnGrbitDbtAdo structure](#conngrbitdbtado) 623 + +[ConnGrbitDbtOledb structure](#conngrbitdbtoledb) 624 + +[ConnGrbitDbtWeb structure](#conngrbitdbtweb) 625 + +[Continue record](#continue) 244 + +[Continue_SxaddlSxString record](#continue_sxaddlsxstring) 432 + +[ContinueBigName record](#continuebigname) 244 + +[ContinueFrt record](#continuefrt) 245 + +[ContinueFrt11 record](#continuefrt11) 245 + +[ContinueFrt12 record](#continuefrt12) 246 + +[control stream](#control-stream-ctls) 60 + +[ControlInfo structure](#controlinfo) 626 + +[Country record](#country) 246 + +[CrErr record](#crerr) 248 + +[CRN record](#crn) 248 + +[CrtLayout12 record](#crtlayout12) 249 + +[CrtLayout12A record](#crtlayout12a) 251 + +[CrtLayout12Mode structure](#crtlayout12mode) 626 + +[CrtLine record](#crtline) 253 + +[CrtLink record](#crtlink) 254 + +[CrtMlFrt record](#crtmlfrt) 254 + +[CrtMlFrtContinue record](#crtmlfrtcontinue) 255 + +[CTB XCB structure](#ctb) 921 + +[CTBS XCB structure](#ctbs) 920 + +[CTBWRAPPER XCB structure](#ctbwrapper) 920 + +[CUsr record](#cusr) 255 + +[Dat record](#dat) 255 + +[data spaces storage](#data-spaces-storage-006dataspaces) 60 + +[DataFormat record](#dataformat) 256 + +[DataFunctionalityLevel structure](#datafunctionalitylevel) 627 + +DataLabExt record ([section 2.4.75](#datalabext) 256, [section 2.4.76](#datalabextcontents) 257) + +[DataSourceType structure](#datasourcetype) 627 + +[Date1904 record](#date1904) 258 + +[DateAsNum structure](#dateasnum) 627 + +[DateUnit structure](#dateunit) 627 + +[DBCell record](#dbcell) 258 + +[DbOrParamQry record](#dborparamqry) 259 + +[DbQuery record](#dbquery) 259 + +[DbQueryExt record](#dbqueryext) 261 + +[DCol structure](#dcol) 628 + +[DColByteU structure](#dcolbyteu) 628 + +[DCon record](#dcon) 263 + +[DConBin record](#dconbin) 265 + +[DConFile structure](#dconfile) 628 + +[DConn record](#dconn) 266 + +[DConName record](#dconname) 271 + +[DConnConnectionOleDb structure](#dconnconnectionoledb) 629 + +[DConnConnectionWeb structure](#dconnconnectionweb) 630 + +[DConnId structure](#dconnid) 630 + +[DConnParamBinding structure](#dconnparambinding) 631 + +[DConnParamBindingValByte structure](#dconnparambindingvalbyte) 631 + +[DConnParamBindingValInt structure](#dconnparambindingvalint) 631 + +[DConnParamBindingValString structure](#dconnparambindingvalstring) 631 + +[DConnParamBindingValType structure](#dconnparambindingvaltype) 632 + +[DConnParameter structure](#dconnparameter) 632 + +[DConnStringSequence structure](#dconnstringsequence) 633 + +[DConnUnicodeStringSegmented structure](#dconnunicodestringsegmented) 633 + +[DConRef record](#dconref) 272 + +[DefaultRowHeight record](#defaultrowheight) 273 + +[DefaultText record](#defaulttext) 273 + +[DefColWidth record](#defcolwidth) 274 + +[Dimensions record](#dimensions) 274 + +[DJoin structure](#djoin) 634 + +[DocRoute record](#docroute) 275 + +[document summary information stream](#document-summary-information-stream-005documentsummaryinformation) 60 + +[DropBar record](#dropbar) 277 + +[DropDownObjIds record](#dropdownobjids) 278 + +[DRw structure](#drw) 634 + +[DRwByteU structure](#drwbyteu) 634 + +[DSF record](#dsf) 278 + +[Duce structure](#duce) 634 + +[DuceRadical structure](#duceradical) 635 + +[DuceStacked structure](#ducestacked) 636 + +[Ducr structure](#ducr) 636 + +[DucrConditionalLbl structure](#ducrconditionallbl) 637 + +[DucrConditionalNoLbl structure](#ducrconditionalnolbl) 638 + +[Dv record](#dv) 278 + +[DVal record](#dval) 281 + +[DVParsedFormula structure](#dvparsedformula) 756 + +[DwQsiFuture structure](#dwqsifuture) 638 + +[DXF record](#dxf) 282 + +[DXFALC structure](#dxfalc) 639 + +[DXFBdr structure](#dxfbdr) 640 + +[DXFFntD structure](#dxffntd) 641 + +[DXFId structure](#dxfid) 642 + +[DXFN structure](#dxfn) 642 + +[DXFN12 structure](#dxfn12) 645 + +[DXFN12List structure](#dxfn12list) 646 + +[DXFN12NoCB structure](#dxfn12nocb) 646 + +[DXFNum structure](#dxfnum) 646 + +[DXFNumIFmt structure](#dxfnumifmt) 647 + +[DXFNumUsr structure](#dxfnumusr) 647 + +[DXFPat structure](#dxfpat) 647 + +[DXFProt structure](#dxfprot) 648 + +[DxGCol record](#dxgcol) 283 + +[embedding storage](#embedding-storage-mbd...) 60 + +[encryption stream](#encryption-stream-encryption) 60 + +[End record](#end) 283 + +[EndBlock record](#endblock) 283 + +[EndObject record](#endobject) 285 + +[EnhancedProtection structure](#enhancedprotection) 648 + +[EntExU2 record](#entexu2) 286 + +[EOF record](#eof) 286 + +[Excel9File record](#excel9file) 286 + +[ExternDdeLinkNoOper structure](#externddelinknooper) 649 + +[ExternDocName structure](#externdocname) 649 + +[ExternName record](#externname) 286 + +[ExternOleDdeLink structure](#externoleddelink) 650 + +[ExternSheet record](#externsheet) 288 + +[ExtNameParsedFormula structure](#extnameparsedformula) 757 + +[ExtProp structure](#extprop) 650 + +[ExtPtgArea3D structure](#extptgarea3d) 758 + +[ExtPtgAreaErr3D structure](#extptgareaerr3d) 758 + +[ExtPtgErr structure](#extptgerr) 758 + +[ExtPtgRef3D structure](#extptgref3d) 759 + +[ExtPtgRefErr3D structure](#extptgreferr3d) 759 + +[ExtRst structure](#extrst) 651 + +[ExtSheetPair structure](#extsheetpair) 759 + +[ExtSST record](#extsst) 289 + +[ExtString record](#extstring) 289 + +[FactoidData structure](#factoiddata) 652 + +[Fbi record](#fbi) 290 + +[Fbi2 record](#fbi2) 291 + +[Feat record](#feat) 292 + +[Feat11CellStruct structure](#feat11cellstruct) 652 + +[Feat11FdaAutoFilter structure](#feat11fdaautofilter) 652 + +[Feat11FieldDataItem structure](#feat11fielddataitem) 653 + +[Feat11Fmla structure](#feat11fmla) 660 + +[Feat11RgInvalidCells structure](#feat11rginvalidcells) 660 + +[Feat11RgSharepointIdChange structure](#feat11rgsharepointidchange) 660 + +[Feat11RgSharepointIdDel structure](#feat11rgsharepointiddel) 661 + +[Feat11TotalFmla structure](#feat11totalfmla) 661 + +[Feat11WSSListInfo structure](#feat11wsslistinfo) 661 + +[Feat11XMap structure](#feat11xmap) 664 + +[Feat11XMapEntry structure](#feat11xmapentry) 664 + +[Feat11XMapEntry2 structure](#feat11xmapentry2) 665 + +[FeatFormulaErr2 structure](#featformulaerr2) 665 + +[FeatHdr record](#feathdr) 293 + +[FeatHdr11 record](#feathdr11) 294 + +[FeatProtection structure](#featprotection) 665 + +[FeatSmartTag structure](#featsmarttag) 666 + +[Feature11 record](#feature11) 294 + +[Feature12 record](#feature12) 296 + +[FFErrorCheck structure](#fferrorcheck) 667 + +[FileLock record](#filelock) 296 + +[FilePass record](#filepass) 297 + +[FileSharing record](#filesharing) 298 + +[FillPattern structure](#fillpattern) 667 + +[FillStylePropertiesForShapePropsStreamChecksum structure](#fillstylepropertiesforshapepropsstreamchecksum) 668 + +[FilterMode record](#filtermode) 298 + +[FnGroupName record](#fngroupname) 298 + +[FnGrp12 record](#fngrp12) 298 + +[Font record](#font) 299 + +[FontIndex structure](#fontindex) 678 + +[FontInfo structure](#fontinfo) 678 + +[FontScheme structure](#fontscheme) 679 + +[FontX record](#fontx) 301 + +[Footer record](#footer) 302 + +[ForceFullCalculation record](#forcefullcalculation) 302 + +[Format record](#format) 303 + +[FormatRun structure](#formatrun) 679 + +[Formula record](#formula) 310 + +[FormulaValue structure](#formulavalue) 679 + +[Frame record](#frame) 311 + +[FrtFlags structure](#frtflags) 680 + +[FrtFontList record](#frtfontlist) 312 + +[FrtHeader structure](#frtheader) 681 + +[FrtHeaderOld structure](#frtheaderold) 681 + +[FrtRefHeader structure](#frtrefheader) 681 + +[FrtRefHeaderNoGrbit structure](#frtrefheadernogrbit) 682 + +[FrtRefHeaderU structure](#frtrefheaderu) 682 + +[FrtWrapper record](#frtwrapper) 312 + +[Ftab structure](#ftab) 760 + +[FtCbls structure](#ftcbls) 683 + +[FtCblsData structure](#ftcblsdata) 683 + +[FtCf structure](#ftcf) 684 + +[FtCmo structure](#ftcmo) 684 + +[FtEdoData structure](#ftedodata) 687 + +[FtGboData structure](#ftgbodata) 688 + +[FtGmo structure](#ftgmo) 688 + +[FtLbsData structure](#ftlbsdata) 689 + +[FtMacro structure](#ftmacro) 691 + +[FtNts structure](#ftnts) 692 + +[FtPictFmla structure](#ftpictfmla) 692 + +[FtPioGrbit structure](#ftpiogrbit) 693 + +[FtRbo structure](#ftrbo) 695 + +[FtSbs structure](#ftsbs) 696 + +[FullColorExt structure](#fullcolorext) 697 + +[GelFrame record](#gelframe) 313 + +[GradStop structure](#gradstop) 697 + +[GridSet record](#gridset) 315 + +[GUIDTypeLib record](#guidtypelib) 315 + +[Guts record](#guts) 315 + +[HCenter record](#hcenter) 316 + +[Header record](#header) 316 + +[HeaderFooter record](#headerfooter) 320 + +[HFPicture record](#hfpicture) 321 + +[HiddenMemberSet structure](#hiddenmemberset) 698 + +[HideObj record](#hideobj) 323 + +[HideObjEnum structure](#hideobjenum) 698 + +[HLink record](#hlink) 323 + +[HLinkTooltip record](#hlinktooltip) 323 + +[HorizAlign structure](#horizalign) 699 + +[HorizontalPageBreaks record](#horizontalpagebreaks) 324 + +[HorzBrk structure](#horzbrk) 699 + +[Icv structure](#icv) 699 + +[IcvChart structure](#icvchart) 703 + +[IcvFont structure](#icvfont) 703 + +[IcvXF structure](#icvxf) 703 + +[IFmt structure](#ifmt) 703 + +[IFmtRecord record](#ifmtrecord) 324 + +[Ilel structure](#ilel) 787 + +[Index record](#index) 324 + +[InterfaceEnd record](#interfaceend) 325 + +[InterfaceHdr record](#interfacehdr) 325 + +[InteriorColorPropertiesForShapePropsStreamChecksum structure](#interiorcolorpropertiesforshapepropsstreamchecksum) 704 + +[Intl record](#intl) 325 + +[ISSTInf structure](#isstinf) 705 + +[IXFCell structure](#ixfcell) 705 + +[KPIProp structure](#kpiprop) 705 + +[KPISets structure](#kpisets) 706 + +[Label record](#label) 326 + +[LabelSst record](#labelsst) 326 + +[Lbl record](#lbl) 326 + +[LbsDropData structure](#lbsdropdata) 706 + +[LeftMargin record](#leftmargin) 329 + +[Legend record](#legend-1) 329 + +[LegendException record](#legendexception) 330 + +[Lel record](#lel) 331 + +[LEMMode structure](#lemmode) 707 + +[Line record](#line) 331 + +[LineFormat record](#lineformat) 332 + +[LinePropertiesForShapePropsStreamChecksum structure](#linepropertiesforshapepropsstreamchecksum) 708 + +[link storage](#link-storage-lnk...) 60 + +[list data stream](#list-data-stream-list-data) 61 + +[List12 record](#list12) 333 + +[List12BlockLevel structure](#list12blocklevel) 709 + +[List12DisplayName structure](#list12displayname) 711 + +[List12TableStyleClientInfo structure](#list12tablestyleclientinfo) 712 + +[ListParsedArrayFormula structure](#listparsedarrayformula) 788 + +[ListParsedFormula structure](#listparsedformula) 788 + +[LongRGB structure](#longrgb) 712 + +[LongRGBA structure](#longrgba) 713 + +[LPr record](#lpr) 334 + +[LPWideString structure](#lpwidestring) 713 + +[LRng record](#lrng) 335 + +[MarkerFormat record](#markerformat) 335 + +[MDB record](#mdb) 337 + +[MDir structure](#mdir) 713 + +[MDTInfo record](#mdtinfo) 337 + +[MDTInfoIndex structure](#mdtinfoindex) 714 + +[MDXKPI record](#mdxkpi) 339 + +[MDXProp record](#mdxprop) 340 + +[MDXSet record](#mdxset) 340 + +[MDXStr record](#mdxstr) 341 + +[MDXStrIndex structure](#mdxstrindex) 714 + +[MDXTuple record](#mdxtuple) 342 + +[MergeCells record](#mergecells) 342 + +[Mms record](#mms) 343 + +[MOper structure](#moper) 714 + +[MsoDrawing record](#msodrawing) 343 + +[MsoDrawingGroup record](#msodrawinggroup) 343 + +[MsoDrawingSelection record](#msodrawingselection) 344 + +[MTRSettings record](#mtrsettings) 344 + +[MulBlank record](#mulblank) 345 + +[MulRk record](#mulrk) 345 + +[NameCmt record](#namecmt) 346 + +[NameFnGrp12 record](#namefngrp12) 347 + +[NameParsedFormula structure](#nameparsedformula) 788 + +[NamePublish record](#namepublish) 348 + +[NilChartNum structure](#nilchartnum) 715 + +[Note record](#note) 348 + +[NoteRR structure](#noterr) 715 + +[NoteSh structure](#notesh) 716 + +[Number record](#number) 349 + +[Obj record](#obj) 349 + +[ObjectLink record](#objectlink) 352 + +[ObjectParsedFormula structure](#objectparsedformula) 789 + +ObjFmla structure ([section 2.5.187](#objfmla) 717, [section 2.5.188](#objid) 718) + +[ObjLinkFmla structure](#objlinkfmla) 718 + +[ObjProtect record](#objprotect) 352 + +[ObNoMacros record](#obnomacros) 353 + +[ObProj record](#obproj) 353 + +[ODBCType structure](#odbctype) 719 + +[Office data store storage](#office-data-store-storage-msodatastore) 65 + +[Office toolbars stream](#office-toolbars-stream-xcb) 65 + +[OfficeArtClientAnchorChart structure](#officeartclientanchorchart) 719 + +[OfficeArtClientAnchorHF structure](#officeartclientanchorhf) 720 + +[OfficeArtClientAnchorSheet structure](#officeartclientanchorsheet) 721 + +[OfficeArtClientData structure](#officeartclientdata) 722 + +[OfficeArtClientTextbox structure](#officeartclienttextbox) 723 + +[OLE stream](#ole-stream-001ole) 66 + +[OleDbConn record](#oledbconn) 353 + +[OleObjectSize record](#oleobjectsize) 354 + +[Palette record](#palette) 354 + +[Pane record](#pane) 354 + +[PaneType structure](#panetype) 723 + +[ParameterParsedFormula structure](#parameterparsedformula) 789 + +[ParamQry record](#paramqry) 355 + +[PARAMQRY_Fixed structure](#paramqry_fixed) 724 + +[Password record](#password) 355 + +[PBT structure](#pbt) 833 + +[PhoneticInfo record](#phoneticinfo) 356 + +[PhRuns structure](#phruns) 834 + +[Phs structure](#phs) 834 + +[PicF record](#picf) 356 + +[PictFmlaEmbedInfo structure](#pictfmlaembedinfo) 835 + +[PictFmlaKey structure](#pictfmlakey) 835 + +[Pie record](#pie) 357 + +[PieFormat record](#pieformat) 358 + +[pivot cache storage](#pivot-cache-storage-_sx_db_cur) 66 + +[PivotChartBits record](#pivotchartbits) 358 + +[PivotCompProp structure](#pivotcompprop) 836 + +[PivotParsedFormula structure](#pivotparsedformula) 790 + +[PlotArea record](#plotarea) 359 + +[PlotGrowth record](#plotgrowth) 359 + +[Pls record](#pls) 359 + +[PLV record](#plv) 360 + +[Pos record](#pos) 360 + +[PositionMode structure](#positionmode) 836 + +[PrintGrid record](#printgrid) 362 + +[PrintRowCol record](#printrowcol) 362 + +[PrintSize record](#printsize) 363 + +[Prot4Rev record](#prot4rev) 363 + +[Prot4RevPass record](#prot4revpass) 364 + +[Protect record](#protect) 364 + +[protected content stream](#protected-content-stream-009drmcontent) 66 + +[Ptg structure](#ptg) 790 + +[PtgAdd structure](#ptgadd) 793 + +[PtgArea structure](#ptgarea) 793 + +[PtgArea3d structure](#ptgarea3d) 794 + +[PtgAreaErr structure](#ptgareaerr) 794 + +PtgAreaErr3d structure ([section 2.5.198.30](#ptgareaerr3d) 795, [section 2.5.198.31](#ptgarean) 795) + +[PtgArray structure](#ptgarray) 796 + +[PtgAttrBaxcel structure](#ptgattrbaxcel) 796 + +[PtgAttrChoose structure](#ptgattrchoose) 797 + +[PtgAttrGoto structure](#ptgattrgoto) 797 + +[PtgAttrIf structure](#ptgattrif) 798 + +[PtgAttrSemi structure](#ptgattrsemi) 798 + +[PtgAttrSpace structure](#ptgattrspace) 798 + +[PtgAttrSpaceSemi structure](#ptgattrspacesemi) 799 + +[PtgAttrSpaceType structure](#ptgattrspacetype) 799 + +[PtgAttrSum structure](#ptgattrsum) 800 + +[PtgBool structure](#ptgbool) 800 + +[PtgConcat structure](#ptgconcat) 800 + +[PtgDataType structure](#ptgdatatype) 800 + +[PtgDiv structure](#ptgdiv) 801 + +[PtgElfCol structure](#ptgelfcol) 801 + +[PtgElfColS structure](#ptgelfcols) 801 + +[PtgElfColSV structure](#ptgelfcolsv) 802 + +[PtgElfColV structure](#ptgelfcolv) 802 + +[PtgElfLel structure](#ptgelflel) 802 + +[PtgElfRadical structure](#ptgelfradical) 803 + +[PtgElfRadicalLel structure](#ptgelfradicallel) 803 + +[PtgElfRadicalS structure](#ptgelfradicals) 804 + +[PtgElfRw structure](#ptgelfrw) 804 + +[PtgElfRwV structure](#ptgelfrwv) 805 + +[PtgEq structure](#ptgeq) 805 + +[PtgErr structure](#ptgerr) 805 + +[PtgExp structure](#ptgexp) 805 + +[PtgExtraArray structure](#ptgextraarray) 806 + +[PtgExtraElf structure](#ptgextraelf) 806 + +[PtgExtraMem structure](#ptgextramem) 807 + +[PtgFunc structure](#ptgfunc) 807 + +[PtgFuncVar structure](#ptgfuncvar) 807 + +[PtgGe structure](#ptgge) 808 + +[PtgGt structure](#ptggt) 808 + +[PtgInt structure](#ptgint) 808 + +[PtgIsect structure](#ptgisect) 809 + +[PtgLe structure](#ptgle) 809 + +[PtgLt structure](#ptglt) 809 + +[PtgMemArea structure](#ptgmemarea) 809 + +[PtgMemErr structure](#ptgmemerr) 810 + +[PtgMemFunc structure](#ptgmemfunc) 810 + +[PtgMemNoMem structure](#ptgmemnomem) 811 + +[PtgMissArg structure](#ptgmissarg) 811 + +[PtgMul structure](#ptgmul) 811 + +[PtgName structure](#ptgname) 812 + +[PtgNameX structure](#ptgnamex) 812 + +[PtgNe structure](#ptgne) 813 + +[PtgNum structure](#ptgnum) 813 + +[PtgParen structure](#ptgparen) 813 + +[PtgPercent structure](#ptgpercent) 814 + +[PtgPower structure](#ptgpower) 814 + +[PtgRange structure](#ptgrange) 814 + +[PtgRef structure](#ptgref) 814 + +[PtgRef3d structure](#ptgref3d) 815 + +[PtgRefErr structure](#ptgreferr) 815 + +[PtgRefErr3d structure](#ptgreferr3d) 816 + +[PtgRefN structure](#ptgrefn) 816 + +[PtgStr structure](#ptgstr) 816 + +[PtgSub structure](#ptgsub) 817 + +[PtgSxName structure](#ptgsxname) 817 + +[PtgTbl structure](#ptgtbl) 817 + +[PtgUminus structure](#ptguminus) 818 + +[PtgUnion structure](#ptgunion) 818 + +[PtgUplus structure](#ptguplus) 818 + +[Qsi record](#qsi) 364 + +[Qsif record](#qsif) 367 + +[Qsir record](#qsir) 368 + +[QsiSXTag record](#qsisxtag) 370 + +[Radar record](#radar) 372 + +[RadarArea record](#radararea) 372 + +[ReadingOrder structure](#readingorder) 836 + +[RealTimeData record](#realtimedata) 373 + +[RecalcId record](#recalcid) 374 + +[RecipName record](#recipname) 374 + +[Ref structure](#ref) 837 + +[Ref8 structure](#ref8) 837 + +[Ref8U structure](#ref8u) 838 + +[Ref8U2007 structure](#ref8u2007) 838 + +[RefreshAll record](#refreshall) 375 + +[RefU structure](#refu) 839 + +[RevExtern structure](#revextern) 819 + +[revision stream](#revision-stream-revision-log) 66 + +[RevisionType structure](#revisiontype) 839 + +[RevItab structure](#revitab) 819 + +[RevLblName structure](#revlblname) 820 + +[RevName structure](#revname) 821 + +[RevNamePly structure](#revnameply) 822 + +[RevNameTabid structure](#revnametabid) 822 + +[RevSheetName structure](#revsheetname) 822 + +[RFX structure](#rfx) 840 + +[RgbExtra structure](#rgbextra) 823 + +[Rgce structure](#rgce) 824 + +[RgceArea structure](#rgcearea) 827 + +[RgceAreaRel structure](#rgcearearel) 828 + +[RgceElfLoc structure](#rgceelfloc) 828 + +[RgceElfLocExtra structure](#rgceelflocextra) 829 + +[RgceLoc structure](#rgceloc) 829 + +[RgceLoc8 structure](#rgceloc8) 829 + +[RgceLocRel structure](#rgcelocrel) 829 + +[RichTextStream record](#richtextstream) 375 + +[RichTextStreamChecksumData structure](#richtextstreamchecksumdata) 840 + +[RichTextStreamChecksumFontInformation structure](#richtextstreamchecksumfontinformation) 842 + +[RichTextStreamChecksumFontInformationArrayItem structure](#richtextstreamchecksumfontinformationarrayitem) 844 + +[RightMargin record](#rightmargin) 377 + +[RK record](#rk) 377 + +[RkNumber structure](#rknumber) 844 + +[RkRec structure](#rkrec) 845 + +[Row record](#row) 378 + +[RPHSSub structure](#rphssub) 845 + +[RRAutoFmt record](#rrautofmt) 379 + +[RRD structure](#rrd) 846 + +[RRDChgCell record](#rrdchgcell) 380 + +[RRDConflict record](#rrdconflict) 384 + +[RRDDefName record](#rrddefname) 385 + +[RRDDefNameFlags structure](#rrddefnameflags) 846 + +[RRDHead record](#rrdhead) 387 + +[RRDInfo record](#rrdinfo) 389 + +[RRDInsDel record](#rrdinsdel) 390 + +[RRDInsDelBegin record](#rrdinsdelbegin) 391 + +[RRDInsDelEnd record](#rrdinsdelend) 391 + +[RRDMove record](#rrdmove) 391 + +[RRDMoveBegin record](#rrdmovebegin) 392 + +[RRDMoveEnd record](#rrdmoveend) 392 + +[RRDRenSheet record](#rrdrensheet) 392 + +[RRDRstEtxp record](#rrdrstetxp) 393 + +[RRDTQSIF record](#rrdtqsif) 394 + +[RRDUserView record](#rrduserview) 395 + +[RRFormat record](#rrformat) 396 + +[RRInsertSh record](#rrinsertsh) 396 + +[RRLoc structure](#rrloc) 848 + +[RRSort record](#rrsort) 397 + +[RRTabId record](#rrtabid) 398 + +[RTDEItem structure](#rtdeitem) 848 + +[RTDOper structure](#rtdoper) 848 + +[RTDOperStr structure](#rtdoperstr) 849 + +[Run structure](#run) 849 + +[Rw structure](#rw) 849 + +[Rw12 structure](#rw12) 850 + +[RwLongU structure](#rwlongu) 850 + +[RwU structure](#rwu) 850 + +[Rwx structure](#rwx) 850 + +[SBaseRef record](#sbaseref) 398 + +[Scatter record](#scatter) 399 + +[SCENARIO record](#scenario) 400 + +[ScenarioProtect record](#scenarioprotect) 401 + +[ScenMan record](#scenman) 401 + +[Scl record](#scl) 402 + +[Script structure](#script) 851 + +[SD_SetSortOrder structure](#sd_setsortorder) 851 + +[SDContainer structure](#sdcontainer) 851 + +[SecurityDescriptor structure](#securitydescriptor) 852 + +[Selection record](#selection) 402 + +[SerAr structure](#serar) 830 + +[SerAuxErrBar record](#serauxerrbar) 403 + +[SerAuxTrend record](#serauxtrend) 404 + +[SerBool structure](#serbool) 830 + +[SerErr structure](#sererr) 831 + +[SerFmt record](#serfmt) 405 + +[Series record](#series-1) 406 + +[SeriesList record](#serieslist) 407 + +[SeriesText record](#seriestext) 407 + +[SerNil structure](#sernil) 831 + +[SerNum structure](#sernum) 831 + +[SerParent record](#serparent) 407 + +[SerStr structure](#serstr) 832 + +[SerToCrt record](#sertocrt) 408 + +[Setup record](#setup) 408 + +[ShapePropsStream record](#shapepropsstream) 413 + +[ShapePropsStreamChecksumData structure](#shapepropsstreamchecksumdata) 852 + +[SharedFeatureType structure](#sharedfeaturetype) 853 + +[SharedParsedFormula structure](#sharedparsedformula) 832 + +[SheetExt record](#sheetext) 414 + +[SheetExtOptional structure](#sheetextoptional) 854 + +[ShortDTR structure](#shortdtr) 855 + +[ShortXLUnicodeString structure](#shortxlunicodestring) 855 + +[ShrFmla record](#shrfmla) 415 + +[ShtProps record](#shtprops) 415 + +[signatures stream](#signatures-stream-_signatures) 67 + +[SIIndex record](#siindex) 416 + +[SLCO8 structure](#slco8) 856 + +[Sort record](#sort) 417 + +[SortCond12 structure](#sortcond12) 856 + +[SortData record](#sortdata) 418 + +[SortItem structure](#sortitem) 857 + +[SourceType structure](#sourcetype) 858 + +[SQElfFlags structure](#sqelfflags) 858 + +[SqRef structure](#sqref) 858 + +[SqRefU structure](#sqrefu) 859 + +[SST record](#sst) 420 + +[StartBlock record](#startblock) 421 + +[StartObject record](#startobject) 426 + +[String record](#string) 427 + +[structure](#ftrbodata) 695 + +[Stxp structure](#stxp) 859 + +[Style record](#style) 427 + +[StyleExt record](#styleext) 428 + +[StyleXF structure](#stylexf) 860 + +[summary information stream](#summary-information-stream-005summaryinformation) 67 + +[SupBook record](#supbook) 429 + +[Surf record](#surf) 431 + +[SXAddl record](#sxaddl) 432 + +[SXAddl_SXCAutoSort_SXDEnd record](#sxaddl_sxcautosort_sxdend) 433 + +[SXAddl_SXCAutoSort_SXDId record](#sxaddl_sxcautosort_sxdid) 433 + +[SXAddl_SXCCache_SXDEnd record](#sxaddl_sxccache_sxdend) 434 + +[SXAddl_SXCCache_SXDId record](#sxaddl_sxccache_sxdid) 434 + +[SXAddl_SXCCache_SXDInfo12 record](#sxaddl_sxccache_sxdinfo12) 434 + +[SXAddl_SXCCache_SXDInvRefreshReal record](#sxaddl_sxccache_sxdinvrefreshreal) 435 + +[SXAddl_SXCCache_SXDVer10Info record](#sxaddl_sxccache_sxdver10info) 435 + +[SXAddl_SXCCache_SXDVerSXMacro record](#sxaddl_sxccache_sxdversxmacro) 436 + +[SXAddl_SXCCache_SXDVerUpdInv record](#sxaddl_sxccache_sxdverupdinv) 437 + +[SXAddl_SXCCacheField_SXDCaption record](#sxaddl_sxccachefield_sxdcaption) 437 + +[SXAddl_SXCCacheField_SXDEnd record](#sxaddl_sxccachefield_sxdend) 437 + +[SXAddl_SXCCacheField_SXDId record](#sxaddl_sxccachefield_sxdid) 438 + +[SXAddl_SXCCacheField_SXDIfdbMempropMap record](#sxaddl_sxccachefield_sxdifdbmempropmap) 438 + +[SXAddl_SXCCacheField_SXDIfdbMpMapCount record](#sxaddl_sxccachefield_sxdifdbmpmapcount) 439 + +[SXAddl_SXCCacheField_SXDProperty record](#sxaddl_sxccachefield_sxdproperty) 439 + +[SXAddl_SXCCacheField_SXDPropName record](#sxaddl_sxccachefield_sxdpropname) 440 + +[SXAddl_SXCCacheField_SXDSxrmitmCount record](#sxaddl_sxccachefield_sxdsxrmitmcount) 440 + +[SXAddl_SXCCacheItem_SXDEnd record](#sxaddl_sxccacheitem_sxdend) 441 + +[SXAddl_SXCCacheItem_SXDId record](#sxaddl_sxccacheitem_sxdid) 441 + +[SXAddl_SXCCacheItem_SXDItmMpMapCount record](#sxaddl_sxccacheitem_sxditmmpmapcount) 441 + +[SXAddl_SXCCacheItem_SXDItmMpropMap record](#sxaddl_sxccacheitem_sxditmmpropmap) 442 + +[SXAddl_SXCCacheItem_SXDSxrmitmDisp record](#sxaddl_sxccacheitem_sxdsxrmitmdisp) 442 + +[SXAddl_SXCField_SXDEnd record](#sxaddl_sxcfield_sxdend) 443 + +[SXAddl_SXCField_SXDId record](#sxaddl_sxcfield_sxdid) 443 + +[SXAddl_SXCField_SXDVer10Info record](#sxaddl_sxcfield_sxdver10info) 443 + +[SXAddl_SXCField12_SXDAutoshow record](#sxaddl_sxcfield12_sxdautoshow) 444 + +[SXAddl_SXCField12_SXDEnd record](#sxaddl_sxcfield12_sxdend) 444 + +[SXAddl_SXCField12_SXDId record](#sxaddl_sxcfield12_sxdid) 445 + +[SXAddl_SXCField12_SXDISXTH record](#sxaddl_sxcfield12_sxdisxth) 445 + +[SXAddl_SXCField12_SXDMemberCaption record](#sxaddl_sxcfield12_sxdmembercaption) 446 + +[SXAddl_SXCField12_SXDVer12Info record](#sxaddl_sxcfield12_sxdver12info) 446 + +[SXAddl_SXCField12_SXDVerUpdInv record](#sxaddl_sxcfield12_sxdverupdinv) 447 + +[SXAddl_SXCGroup_SXDEnd record](#sxaddl_sxcgroup_sxdend) 447 + +[SXAddl_SXCGroup_SXDGrpInfo record](#sxaddl_sxcgroup_sxdgrpinfo) 448 + +[SXAddl_SXCGroup_SXDId record](#sxaddl_sxcgroup_sxdid) 449 + +[SXAddl_SXCGroup_SXDMember record](#sxaddl_sxcgroup_sxdmember) 449 + +[SXAddl_SXCGrpLevel_SXDEnd record](#sxaddl_sxcgrplevel_sxdend) 450 + +[SXAddl_SXCGrpLevel_SXDGrpLevelInfo record](#sxaddl_sxcgrplevel_sxdgrplevelinfo) 450 + +[SXAddl_SXCGrpLevel_SXDId record](#sxaddl_sxcgrplevel_sxdid) 451 + +[SXAddl_SXCHierarchy_SXDDisplayFolder record](#sxaddl_sxchierarchy_sxddisplayfolder) 451 + +[SXAddl_SXCHierarchy_SXDEnd record](#sxaddl_sxchierarchy_sxdend) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember record](#sxaddl_sxchierarchy_sxdfiltermember) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember12 record](#sxaddl_sxchierarchy_sxdfiltermember12) 453 + +[SXAddl_SXCHierarchy_SXDIconSet record](#sxaddl_sxchierarchy_sxdiconset) 454 + +[SXAddl_SXCHierarchy_SXDId record](#sxaddl_sxchierarchy_sxdid) 454 + +[SXAddl_SXCHierarchy_SXDInfo12 record](#sxaddl_sxchierarchy_sxdinfo12) 455 + +[SXAddl_SXCHierarchy_SXDKPIGoal record](#sxaddl_sxchierarchy_sxdkpigoal) 456 + +[SXAddl_SXCHierarchy_SXDKPIStatus record](#sxaddl_sxchierarchy_sxdkpistatus) 456 + +[SXAddl_SXCHierarchy_SXDKPITime record](#sxaddl_sxchierarchy_sxdkpitime) 456 + +[SXAddl_SXCHierarchy_SXDKPITrend record](#sxaddl_sxchierarchy_sxdkpitrend) 457 + +[SXAddl_SXCHierarchy_SXDKPIValue record](#sxaddl_sxchierarchy_sxdkpivalue) 457 + +[SXAddl_SXCHierarchy_SXDKPIWeight record](#sxaddl_sxchierarchy_sxdkpiweight) 458 + +[SXAddl_SXCHierarchy_SXDMeasureGrp record](#sxaddl_sxchierarchy_sxdmeasuregrp) 458 + +[SXAddl_SXCHierarchy_SXDParentKPI record](#sxaddl_sxchierarchy_sxdparentkpi) 459 + +[SXAddl_SXCHierarchy_SXDProperty record](#sxaddl_sxchierarchy_sxdproperty) 459 + +[SXAddl_SXCHierarchy_SXDSXSetParentUnique record](#sxaddl_sxchierarchy_sxdsxsetparentunique) 461 + +[SXAddl_SXCHierarchy_SXDUserCaption record](#sxaddl_sxchierarchy_sxdusercaption) 461 + +[SXAddl_SXCHierarchy_SXDVerUpdInv record](#sxaddl_sxchierarchy_sxdverupdinv) 461 + +[SXAddl_SXCQsi_SXDEnd record](#sxaddl_sxcqsi_sxdend) 462 + +[SXAddl_SXCQsi_SXDId record](#sxaddl_sxcqsi_sxdid) 462 + +[SXAddl_SXCQuery_SXDEnd record](#sxaddl_sxcquery_sxdend) 462 + +[SXAddl_SXCQuery_SXDReconnCond record](#sxaddl_sxcquery_sxdreconncond) 463 + +[SXAddl_SXCQuery_SXDSrcConnFile record](#sxaddl_sxcquery_sxdsrcconnfile) 464 + +[SXAddl_SXCQuery_SXDSrcDataFile record](#sxaddl_sxcquery_sxdsrcdatafile) 464 + +[SXAddl_SXCQuery_SXDXMLSource record](#sxaddl_sxcquery_sxdxmlsource) 464 + +[SXAddl_SXCSXCondFmt_SXDEnd record](#sxaddl_sxcsxcondfmt_sxdend) 465 + +[SXAddl_SXCSXCondFmt_SXDSXCondFmt record](#sxaddl_sxcsxcondfmt_sxdsxcondfmt) 465 + +[SXAddl_SXCSXCondFmts_SXDEnd record](#sxaddl_sxcsxcondfmts_sxdend) 466 + +[SXAddl_SXCSXCondFmts_SXDId record](#sxaddl_sxcsxcondfmts_sxdid) 467 + +[SXAddl_SXCSXDH_SXDEnd record](#sxaddl_sxcsxdh_sxdend) 467 + +[SXAddl_SXCSXDH_SXDId record](#sxaddl_sxcsxdh_sxdid) 468 + +[SXAddl_SXCSXDH_SXDSxdh record](#sxaddl_sxcsxdh_sxdsxdh) 468 + +[SXAddl_SXCSXfilt_SXDEnd record](#sxaddl_sxcsxfilt_sxdend) 469 + +[SXAddl_SXCSXfilt_SXDId record](#sxaddl_sxcsxfilt_sxdid) 470 + +[SXAddl_SXCSXfilt_SXDSXfilt record](#sxaddl_sxcsxfilt_sxdsxfilt) 470 + +[SXAddl_SXCSXfilt_SXDSXItm record](#sxaddl_sxcsxfilt_sxdsxitm) 471 + +[SXAddl_SXCSXFilter12_SXDCaption record](#sxaddl_sxcsxfilter12_sxdcaption) 472 + +[SXAddl_SXCSXFilter12_SXDEnd record](#sxaddl_sxcsxfilter12_sxdend) 473 + +[SXAddl_SXCSXFilter12_SXDId record](#sxaddl_sxcsxfilter12_sxdid) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilter record](#sxaddl_sxcsxfilter12_sxdsxfilter) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilterDesc record](#sxaddl_sxcsxfilter12_sxdsxfilterdesc) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue1 record](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue2 record](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2) 475 + +[SXAddl_SXCSXFilter12_SXDXlsFilter record](#sxaddl_sxcsxfilter12_sxdxlsfilter) 476 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue1 record](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1) 476 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue2 record](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2) 477 + +[SXAddl_SXCSXFilters12_SXDEnd record](#sxaddl_sxcsxfilters12_sxdend) 477 + +[SXAddl_SXCSXFilters12_SXDId record](#sxaddl_sxcsxfilters12_sxdid) 478 + +[SXAddl_SXCSXMg_SXDEnd record](#sxaddl_sxcsxmg_sxdend) 478 + +[SXAddl_SXCSXMg_SXDId record](#sxaddl_sxcsxmg_sxdid) 478 + +[SXAddl_SXCSXMg_SXDUserCaption record](#sxaddl_sxcsxmg_sxdusercaption) 479 + +[SXAddl_SXCSXMgs_SXDEnd record](#sxaddl_sxcsxmgs_sxdend) 479 + +[SXAddl_SXCSXMgs_SXDId record](#sxaddl_sxcsxmgs_sxdid) 479 + +[SXAddl_SXCSXMgs_SXDMGrpSXDHMap record](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap) 480 + +[SXAddl_SXCSXrule_SXDEnd record](#sxaddl_sxcsxrule_sxdend) 481 + +[SXAddl_SXCSXrule_SXDId record](#sxaddl_sxcsxrule_sxdid) 481 + +[SXAddl_SXCSXrule_SXDSXrule record](#sxaddl_sxcsxrule_sxdsxrule) 481 + +[SXAddl_SXCView_SXDCalcMember record](#sxaddl_sxcview_sxdcalcmember) 484 + +[SXAddl_SXCView_SXDCalcMemString record](#sxaddl_sxcview_sxdcalcmemstring) 486 + +[SXAddl_SXCView_SXDCompactColHdr record](#sxaddl_sxcview_sxdcompactcolhdr) 486 + +[SXAddl_SXCView_SXDCompactRwHdr record](#sxaddl_sxcview_sxdcompactrwhdr) 487 + +[SXAddl_SXCView_SXDEnd record](#sxaddl_sxcview_sxdend) 487 + +[SXAddl_SXCView_SXDId record](#sxaddl_sxcview_sxdid) 488 + +[SXAddl_SXCView_SXDSXPIIvmb record](#sxaddl_sxcview_sxdsxpiivmb) 488 + +[SXAddl_SXCView_SXDTableStyleClient record](#sxaddl_sxcview_sxdtablestyleclient) 489 + +[SXAddl_SXCView_SXDVer10Info record](#sxaddl_sxcview_sxdver10info) 489 + +[SXAddl_SXCView_SXDVer12Info record](#sxaddl_sxcview_sxdver12info) 491 + +[SXAddl_SXCView_SXDVerUpdInv record](#sxaddl_sxcview_sxdverupdinv) 493 + +[SxAddl_SXDEnd structure](#sxaddl_sxdend) 862 + +[SxAddl_SXDVerUpdInv structure](#sxaddl_sxdverupdinv) 862 + +[SxAddl_SXString structure](#sxaddl_sxstring) 862 + +[SXAddlHdr structure](#sxaddlhdr) 863 + +[SXAxis structure](#sxaxis) 863 + +[SxBool record](#sxbool) 494 + +[SXDB record](#sxdb) 494 + +[SXDBB record](#sxdbb) 495 + +[SXDBEx record](#sxdbex) 495 + +[SXDI record](#sxdi) 496 + +[SXDtr record](#sxdtr) 498 + +[SxDXF record](#sxdxf) 498 + +[SxErr record](#sxerr) 499 + +[SXEx record](#sxex) 499 + +[SXEZDoper structure](#sxezdoper) 863 + +[SXFDB record](#sxfdb) 502 + +[SXFDBType record](#sxfdbtype) 505 + +[SxFilt record](#sxfilt) 505 + +[SxFmla record](#sxfmla) 506 + +[SxFormat record](#sxformat) 507 + +[SxFormula record](#sxformula) 507 + +[SxFT structure](#sxft) 864 + +[SxInt record](#sxint) 507 + +[SxIsxoper record](#sxisxoper) 508 + +[SxItm record](#sxitm) 508 + +[SxIvd record](#sxivd) 509 + +[SxIvdCol structure](#sxivdcol) 868 + +[SxIvdRw structure](#sxivdrw) 868 + +[SXLI record](#sxli) 510 + +[SXLIItem structure](#sxliitem) 868 + +[SxName record](#sxname) 510 + +[SxNil record](#sxnil) 511 + +[SXNum record](#sxnum) 511 + +[SXPair record](#sxpair) 511 + +[SXPI record](#sxpi) 512 + +[SXPI_Item structure](#sxpi_item) 871 + +[SXPIEx record](#sxpiex) 513 + +[SXRng record](#sxrng) 513 + +[SxRule record](#sxrule) 515 + +[SxSelect record](#sxselect) 517 + +[SXStreamID record](#sxstreamid) 519 + +[SXString record](#sxstring) 519 + +[SXTbl record](#sxtbl) 519 + +[SxTbpg record](#sxtbpg) 520 + +[SXTBRGIITM record](#sxtbrgiitm) 521 + +[SXTH record](#sxth) 521 + +[Sxvd record](#sxvd) 524 + +[SXVDEx record](#sxvdex) 528 + +[SXVDEx_Opt structure](#sxvdex_opt) 871 + +[SXVDTEx record](#sxvdtex) 531 + +[SXVI record](#sxvi) 532 + +[SxView record](#sxview) 534 + +[SxView9Save structure](#sxview9save) 872 + +[SxViewEx record](#sxviewex) 536 + +[SxViewEx9 record](#sxviewex9) 537 + +[SxViewLink record](#sxviewlink) 538 + +[SXVIFlags structure](#sxviflags) 872 + +[SXVS record](#sxvs) 539 + +[Sync record](#sync) 539 + +[TabId structure](#tabid) 873 + +[TabIndex structure](#tabindex) 873 + +[Table record](#table) 539 + +[TableFeatureType structure](#tablefeaturetype) 873 + +[TableStyle record](#tablestyle) 541 + +[TableStyleElement record](#tablestyleelement) 542 + +[TableStyles record](#tablestyles) 545 + +[Tag_Fn_MDX structure](#tag_fn_mdx) 877 + +[TBC XCB structure](#tbc) 922 + +[TBCCmd XCB structure](#tbccmd) 923 + +[Template record](#template) 546 + +[Text record](#text) 546 + +[TextPropsStream record](#textpropsstream) 551 + +[TextPropsStreamChecksumData structure](#textpropsstreamchecksumdata) 878 + +[Theme record](#theme) 553 + +[Tick record](#tick) 553 + +[Top10FT structure](#top10ft) 880 + +[TopMargin record](#topmargin) 556 + +[Ts structure](#ts) 880 + +[TxO record](#txo) 557 + +[TxOLastRun structure](#txolastrun) 880 + +[TxORuns structure](#txoruns) 881 + +[TxtQry record](#txtqry) 559 + +[TxtWf structure](#txtwf) 881 + +[Uncalced record](#uncalced) 561 + +[Underline structure](#underline) 882 + +[Units record](#units) 561 + +[user names stream](#user-names-stream-user-names) 68 + +[UserBView record](#userbview) 561 + +[UserSViewBegin record](#usersviewbegin) 565 + +[UserSViewBegin_Chart record](#usersviewbegin_chart) 568 + +[UserSViewEnd record](#usersviewend) 570 + +[UsesELFs record](#useselfs) 570 + +[UsrChk record](#usrchk) 570 + +[UsrExcl record](#usrexcl) 571 + +[UsrInfo record](#usrinfo) 572 + +[ValueRange record](#valuerange) 572 + +[VBA storage](#vba-storage-_vba_project_cur) 68 + +[VCenter record](#vcenter) 575 + +[VertAlign structure](#vertalign) 882 + +[VertBrk structure](#vertbrk) 882 + +[VerticalPageBreaks record](#verticalpagebreaks) 575 + +[viewer content stream](#viewer-content-stream-009drmviewercontent) 68 + +[VirtualPath structure](#virtualpath) 882 + +[WebPub record](#webpub) 575 + +[WebPubString structure](#webpubstring) 884 + +[Window1 record](#window1) 578 + +[Window2 record](#window2) 579 + +[WinProtect record](#winprotect) 581 + +[WOpt record](#wopt) 582 + +[workbook stream](#workbook-stream-workbook) 68 + +[WriteAccess record](#writeaccess) 583 + +[WriteProtect record](#writeprotect) 584 + +[WsBool record](#wsbool) 584 + +[XColorType structure](#xcolortype) 885 + +[XCT record](#xct) 585 + +[XF record](#xf) 585 + +[XFCRC record](#xfcrc) 586 + +[XFExt record](#xfext) 586 + +[XFExtGradient structure](#xfextgradient) 885 + +[XFExtNoFRT structure](#xfextnofrt) 886 + +[XFIndex structure](#xfindex) 886 + +[XFProp structure](#xfprop) 888 + +[XFPropBorder structure](#xfpropborder) 890 + +[XFPropColor structure](#xfpropcolor) 890 + +[XFPropGradient structure](#xfpropgradient) 891 + +[XFPropGradientStop structure](#xfpropgradientstop) 892 + +[XFProps structure](#xfprops) 892 + +[XFPropTextRotation structure](#xfproptextrotation) 893 + +[XLNameUnicodeString structure](#xlnameunicodestring) 893 + +[XlsFilter_Criteria structure](#xlsfilter_criteria) 894 + +[XlsFilter_Top10 structure](#xlsfilter_top10) 895 + +[XLUnicodeRichExtendedString structure](#xlunicoderichextendedstring) 896 + +[XLUnicodeString structure](#xlunicodestring) 897 + +[XLUnicodeStringMin2 structure](#xlunicodestringmin2) 898 + +[XLUnicodeStringNoCch structure](#xlunicodestringnocch) 898 + +[XLUnicodeStringSegmented structure](#xlunicodestringsegmented) 898 + +[XLUnicodeStringSegmentedRTD structure](#xlunicodestringsegmentedrtd) 899 + +[XLUnicodeStringSegmentedSXAddl structure](#xlunicodestringsegmentedsxaddl) 899 + +[XML signatures storage](#xml-signatures-storage-_xmlsignatures) 76 + +[XML stream](#xml-stream-xml) 76 + +[XmlTkBackWallThicknessFrt structure](#xmltkbackwallthicknessfrt) 900 + +[XmlTkBaseTimeUnitFrt structure](#xmltkbasetimeunitfrt) 900 + +[XmlTkBlob structure](#xmltkblob) 901 + +[XmlTkBool structure](#xmltkbool) 901 + +[XmlTkChain structure](#xmltkchain) 902 + +[XmlTkColorMappingOverride structure](#xmltkcolormappingoverride) 904 + +[XmlTkDispBlanksAsFrt structure](#xmltkdispblanksasfrt) 904 + +[XmlTkDouble structure](#xmltkdouble) 905 + +[XmlTkDWord structure](#xmltkdword) 905 + +[XmlTkEnd structure](#xmltkend) 906 + +[XmlTkEndSurface structure](#xmltkendsurface) 906 + +[XmlTkFloorThicknessFrt structure](#xmltkfloorthicknessfrt) 906 + +[XmlTkFormatCodeFrt structure](#xmltkformatcodefrt) 907 + +[XmlTkHeader structure](#xmltkheader) 907 + +[XmlTkHeightPercent structure](#xmltkheightpercent) 907 + +[XmlTkLogBaseFrt structure](#xmltklogbasefrt) 908 + +[XmlTkMajorUnitFrt structure](#xmltkmajorunitfrt) 908 + +[XmlTkMajorUnitTypeFrt structure](#xmltkmajorunittypefrt) 908 + +[XmlTkMaxFrt structure](#xmltkmaxfrt) 909 + +[XmlTkMinFrt structure](#xmltkminfrt) 909 + +[XmlTkMinorUnitFrt structure](#xmltkminorunitfrt) 910 + +[XmlTkMinorUnitTypeFrt structure](#xmltkminorunittypefrt) 910 + +[XmlTkNoMultiLvlLbl structure](#xmltknomultilvllbl) 911 + +[XmlTkOverlay structure](#xmltkoverlay) 911 + +[XmlTkPerspectiveFrt structure](#xmltkperspectivefrt) 912 + +[XmlTkPieComboFrom12Frt structure](#xmltkpiecombofrom12frt) 912 + +[XmlTkRAngAxOffFrt structure](#xmltkrangaxofffrt) 912 + +[XmlTkRotXFrt structure](#xmltkrotxfrt) 913 + +[XmlTkRotYFrt structure](#xmltkrotyfrt) 913 + +[XmlTkShowDLblsOverMax structure](#xmltkshowdlblsovermax) 913 + +[XmlTkSpb structure](#xmltkspb) 914 + +[XmlTkStart structure](#xmltkstart) 914 + +[XmlTkStartSurface structure](#xmltkstartsurface) 914 + +[XmlTkString structure](#xmltkstring) 915 + +[XmlTkStyle structure](#xmltkstyle) 915 + +[XmlTkSymbolFrt structure](#xmltksymbolfrt) 915 + +[XmlTkThemeOverride structure](#xmltkthemeoverride) 916 + +[XmlTkTickLabelPositionFrt structure](#xmltkticklabelpositionfrt) 916 + +[XmlTkTickLabelSkipFrt structure](#xmltkticklabelskipfrt) 917 + +[XmlTkTickMarkSkipFrt structure](#xmltktickmarkskipfrt) 917 + +[XmlTkToken structure](#xmltktoken) 917 + +[XmlTkTpb structure](#xmltktpb) 918 + +[Xnum structure](#xnum) 918 + +[XORObfuscation structure](#xorobfuscation) 918 + +[XTI structure](#xti) 918 + +[XtiIndexstructure](#xtiindex) 833 + +[YMult record](#ymult) 587 + +[Differential formatting (DXFs)](#differential-formatting-dxfs) 159 + +[Dimensions](#dimensions) 274 + +[Display tokens](#display-tokens) 83 + +[DJoin](#djoin) 634 + +[DocRoute](#docroute) 275 + +[Document summary information stream](#document-summary-information-stream-005documentsummaryinformation) 60 + +[DropBar](#dropbar) 277 + +[DropDownObjIds](#dropdownobjids) 278 + +[DRw](#drw) 634 + +[DRwByteU](#drwbyteu) 634 + +[DSF](#dsf) 278 + +[Duce](#duce) 634 + +[DuceRadical](#duceradical) 635 + +[DuceStacked](#ducestacked) 636 + +[Ducr](#ducr) 636 + +[DucrConditionalLbl](#ducrconditionallbl) 637 + +[DucrConditionalNoLbl](#ducrconditionalnolbl) 638 + +[Dv](#dv) 278 + +[DVal](#dval) 281 + +[DVParsedFormula](#dvparsedformula) 756 + +[DwQsiFuture](#dwqsifuture) 638 + +[DXF](#dxf) 282 + +[DXFALC](#dxfalc) 639 + +[DXFBdr](#dxfbdr) 640 + +[DXFFntD](#dxffntd) 641 + +[DXFId](#dxfid) 642 + +[DXFN](#dxfn) 642 + +[DXFN12](#dxfn12) 645 + +[DXFN12List](#dxfn12list) 646 + +[DXFN12NoCB](#dxfn12nocb) 646 + +[DXFNum](#dxfnum) 646 + +[DXFNumIFmt](#dxfnumifmt) 647 + +[DXFNumUsr](#dxfnumusr) 647 + +[DXFPat](#dxfpat) 647 + +[DXFProt](#dxfprot) 648 + +[DXFs (differential formatting)](#differential-formatting-dxfs) 159 + +[DxGCol](#dxgcol) 283 + +E + +[Embedding storage](#embedding-storage-mbd...) 60 + +[Encryption (password to open)](#encryption-password-to-open) 165 + +[Encryption stream](#encryption-stream-encryption) 60 + +[End](#end) 283 + +[EndBlock](#endblock) 283 + +[EndObject](#endobject) 285 + +[EnhancedProtection](#enhancedprotection) 648 + +[EntExU2](#entexu2) 286 + +[EOF](#eof) 286 + +[Error bar](#error-bar) 101 + +[Examples](#structure-examples) 925 + +[Column Chart Object](#column-chart-object) 956 + +[column chart object: AreaFormat](#column-chart-object-areaformat) 959 + +[column chart object: AxesUsed](#column-chart-object-axesused) 969 + +[column chart object: Axis](#column-chart-object-axis) 970 + +[column chart object: AxisParent](#column-chart-object-axisparent) 970 + +[column chart object: Bar](#column-chart-object-bar) 973 + +[column chart object: BRAI 1](#column-chart-object-brai-1) 960 + +[column chart object: BRAI 2](#column-chart-object-brai-2) 962 + +[column chart object: BRAI 3](#column-chart-object-brai-3) 964 + +[column chart object: CatSerRange](#column-chart-object-catserrange) 970 + +[column chart object: Chart](#column-chart-object-chart) 957 + +[column chart object: ChartFormat](#column-chart-object-chartformat) 972 + +[column chart object: DataFormat](#column-chart-object-dataformat) 966 + +[column chart object: DefaultText](#column-chart-object-defaulttext) 967 + +[column chart object: FontX](#column-chart-object-fontx) 969 + +[column chart object: Frame](#column-chart-object-frame) 957 + +[column chart object: LineFormat](#column-chart-object-lineformat) 958 + +[column chart object: Series](#column-chart-object-series) 960 + +[column chart object: SeriesText](#column-chart-object-seriestext) 962 + +[column chart object: SerToCrt](#column-chart-object-sertocrt) 966 + +[column chart object: ShtProps](#column-chart-object-shtprops) 966 + +[column chart object: Text](#column-chart-object-text) 967 + +[column chart object: Tick](#column-chart-object-tick) 971 + +[Conditional Formatting](#conditional-formatting-1) 925 + +[conditional formatting: CF](#conditional-formatting-cf) 927 + +[conditional formatting: CondFmt](#conditional-formatting-condfmt) 925 + +[Defined Name](#defined-name) 934 + +[defined name: ExternSheet](#defined-name-externsheet) 936 + +[defined name: Lbl](#defined-name-lbl) 934 + +[defined name: SupBook](#defined-name-supbook) 937 + +[External References](#external-references-1) 949 + +[external references: CRN](#external-references-crn) 954 + +[external references: ExternSheet](#external-references-externsheet) 955 + +[external references: Formula](#external-references-formula) 950 + +[external references: String](#external-references-string) 952 + +[external references: SupBook 1](#external-references-supbook-1) 953 + +[external references: SupBook 2](#external-references-supbook-2) 955 + +[external references: XCT](#external-references-xct) 953 + +[Filters](#filters) 947 + +[filters: AutoFilter](#filters-autofilter) 948 + +[filters: AutoFilterInfo](#filters-autofilterinfo) 948 + +[filters: FilterMode](#filters-filtermode) 947 + +[Formatting](#formatting) 982 + +[formatting: Font 1](#formatting-font-1) 983 + +[formatting: Font 2](#formatting-font-2) 984 + +[formatting: Format](#formatting-format) 985 + +[formatting: Number 1](#formatting-number-1) 994 + +[formatting: Number 2](#formatting-number-2) 995 + +[formatting: Number 3](#formatting-number-3) 996 + +[formatting: XF 1](#formatting-xf-1) 986 + +[formatting: XF 2](#formatting-xf-2) 988 + +[formatting: XF 3](#formatting-xf-3) 990 + +[formatting: XF 4](#formatting-xf-4) 992 + +[Pie Chart Sheet](#pie-chart-sheet) 974 + +[pie chart sheet: AxesUsed](#pie-chart-sheet-axesused) 975 + +[pie chart sheet: AxisParent](#pie-chart-sheet-axisparent) 976 + +[pie chart sheet: BRAI](#pie-chart-sheet-brai) 981 + +[pie chart sheet: Chart](#pie-chart-sheet-chart) 974 + +[pie chart sheet: ChartFormat](#pie-chart-sheet-chartformat) 976 + +[pie chart sheet: Legend](#pie-chart-sheet-legend) 977 + +[pie chart sheet: Pie](#pie-chart-sheet-pie) 976 + +[pie chart sheet: Pos](#pie-chart-sheet-pos) 978 + +[pie chart sheet: PrintSize](#pie-chart-sheet-printsize) 974 + +[pie chart sheet: ShtProps](#pie-chart-sheet-shtprops) 975 + +[pie chart sheet: Text](#pie-chart-sheet-text) 979 + +[pie chart sheet: Window2](#pie-chart-sheet-window2) 981 + +[PivotTable](#pivottable-1) 1031 + +[PivotTable: DConRef](#pivottable-dconref) 1033 + +[PivotTable: EOF](#pivottable-eof) 1084 + +[PivotTable: QsiSXTag](#pivottable-qsisxtag) 1066 + +[PivotTable: SXAddl 1](#pivottable-sxaddl-1) 1034 + +[PivotTable: SXAddl 2](#pivottable-sxaddl-2) 1035 + +[PivotTable: SXAddl 3](#pivottable-sxaddl-3) 1036 + +[PivotTable: SxAddl 4](#pivottable-sxaddl-4) 1068 + +[PivotTable: SxAddl 5](#pivottable-sxaddl-5) 1069 + +[PivotTable: SxAddl 6](#pivottable-sxaddl-6) 1071 + +[PivotTable: SXDB](#pivottable-sxdb) 1071 + +[PivotTable: SXDBB 1](#pivottable-sxdbb-1) 1082 + +[PivotTable: SXDBB 2](#pivottable-sxdbb-2) 1083 + +[PivotTable: SXDBEx](#pivottable-sxdbex) 1073 + +[PivotTable: SXDI](#pivottable-sxdi) 1057 + +[PivotTable: SXDtr 1](#pivottable-sxdtr-1) 1077 + +[PivotTable: SXDtr 2](#pivottable-sxdtr-2) 1077 + +[PivotTable: SXEx](#pivottable-sxex) 1064 + +[PivotTable: SXFDB 1](#pivottable-sxfdb-1) 1073 + +[PivotTable: SXFDB 2](#pivottable-sxfdb-2) 1076 + +[PivotTable: SXFDB 3](#pivottable-sxfdb-3) 1078 + +[PivotTable: SXFDB 4](#pivottable-sxfdb-4) 1079 + +[PivotTable: SXFDB 5](#pivottable-sxfdb-5) 1081 + +[PivotTable: SxIvd](#pivottable-sxivd) 1056 + +[PivotTable: SXLI 1](#pivottable-sxli-1) 1057 + +[PivotTable: SXLI 2](#pivottable-sxli-2) 1063 + +[PivotTable: SXNum 1](#pivottable-sxnum-1) 1080 + +[PivotTable: SXNum 2](#pivottable-sxnum-2) 1082 + +[PivotTable: SXNum 3](#pivottable-sxnum-3) 1083 + +[PivotTable: SXPI](#pivottable-sxpi) 1056 + +[PivotTable: SXStreamID](#pivottable-sxstreamid) 1032 + +[PivotTable: SXString 1](#pivottable-sxstring-1) 1075 + +[PivotTable: SXString 2](#pivottable-sxstring-2) 1075 + +[PivotTable: SXString 3](#pivottable-sxstring-3) 1075 + +[PivotTable: Sxvd 1](#pivottable-sxvd-1) 1040 + +[PivotTable: Sxvd 2](#pivottable-sxvd-2) 1045 + +[PivotTable: Sxvd 3](#pivottable-sxvd-3) 1049 + +[PivotTable: Sxvd 4](#pivottable-sxvd-4) 1050 + +[PivotTable: Sxvd 5](#pivottable-sxvd-5) 1053 + +[PivotTable: SXVDEx 1](#pivottable-sxvdex-1) 1044 + +[PivotTable: SXVDEx 2](#pivottable-sxvdex-2) 1048 + +[PivotTable: SXVDEx 3](#pivottable-sxvdex-3) 1052 + +[PivotTable: SXVDEx 4](#pivottable-sxvdex-4) 1054 + +[PivotTable: SXVI 1](#pivottable-sxvi-1) 1041 + +[PivotTable: SXVI 2](#pivottable-sxvi-2) 1042 + +[PivotTable: SXVI 3](#pivottable-sxvi-3) 1042 + +[PivotTable: SXVI 4](#pivottable-sxvi-4) 1043 + +[PivotTable: SXVI 5](#pivottable-sxvi-5) 1047 + +[PivotTable: SXVI 6](#pivottable-sxvi-6) 1047 + +[PivotTable: SXVI 7](#pivottable-sxvi-7) 1048 + +[PivotTable: SxView](#pivottable-sxview) 1036 + +[PivotTable: SXViewEx9](#pivottable-sxviewex9) 1068 + +[PivotTable: SXVS](#pivottable-sxvs) 1032 + +[Table](#table-1) 937 + +[table: Feathdr11](#table-feathdr11) 937 + +[table: Feature11](#table-feature11) 938 + +[Workbook](#workbook) 996 + +[workbook: BOF 1](#workbook-bof-1) 997 + +[workbook: BookBool](#workbook-bookbool) 1001 + +[workbook: BookExt](#workbook-bookext) 1010 + +[workbook: BoundSheet8 1](#workbook-boundsheet8-1) 1007 + +[workbook: BoundSheet8 2](#workbook-boundsheet8-2) 1007 + +[workbook: BoundSheet8 3](#workbook-boundsheet8-3) 1008 + +[workbook: BuiltInFnGroupCount](#workbook-builtinfngroupcount) 999 + +[workbook: CalcPrecision](#workbook-calcprecision) 1001 + +[workbook: Country](#workbook-country) 1008 + +[workbook: Date1904](#workbook-date1904) 1001 + +[workbook: DBCell](#workbook-dbcell) 1027 + +[workbook: DefaultRowHeight](#workbook-defaultrowheight) 1014 + +[workbook: DefColWidth](#workbook-defcolwidth) 1017 + +[workbook: Dimensions](#workbook-dimensions) 1017 + +[workbook: EOF 1](#workbook-eof-1) 1012 + +workbook: EOF 2 ([section 3.9.22](#workbook-bof-2) 1012, [section 3.9.41](#workbook-eof-2) 1031) + +[workbook: ExtSST](#workbook-extsst) 1009 + +[workbook: Font](#workbook-font) 1002 + +[workbook: Format](#workbook-format) 1003 + +[workbook: Formula](#workbook-formula) 1024 + +[workbook: HideObj](#workbook-hideobj) 1001 + +[workbook: Index](#workbook-index) 1013 + +[workbook: LabelSst 1](#workbook-labelsst-1) 1021 + +[workbook: LabelSst 2](#workbook-labelsst-2) 1023 + +[workbook: PhoneticInfo](#workbook-phoneticinfo) 1030 + +[workbook: RecalcId](#workbook-recalcid) 1009 + +[workbook: RK](#workbook-rk) 1022 + +[workbook: Row 1](#workbook-row-1) 1018 + +[workbook: Row 2](#workbook-row-2) 1019 + +[workbook: Row 3](#workbook-row-3) 1020 + +[workbook: Row 4](#workbook-row-4) 1020 + +[workbook: RRTabId](#workbook-rrtabid) 998 + +[workbook: Selection](#workbook-selection) 1029 + +[workbook: Setup](#workbook-setup) 1015 + +[workbook: SST](#workbook-sst) 1009 + +[workbook: Style](#workbook-style) 1006 + +[workbook: Window1](#workbook-window1) 999 + +[workbook: Window2](#workbook-window2) 1027 + +[workbook: WsBool](#workbook-wsbool) 1014 + +[workbook: XF](#workbook-xf) 1004 + +[Excel9File](#excel9file) 286 + +[External cell cache](#external-cell-cache) 162 + +[External connections](#external-connections) 163 + +[ADO recordset connections](#ado-recordset-connections) 164 + +[connection files](#external-connection-files) 163 + +[connection name](#connection-name) 163 + +[DAO recordset connections](#dao-recordset-connections) 164 + +[ODBC connections](#odbc-connections) 164 + +[OLE DB connections](#ole-db-connections) 163 + +[text import connections](#text-import-connections) 164 + +[web connections](#web-connections) 164 + +[External defined name](#external-defined-name) 162 + +[External reference consumers](#external-reference-consumers) 161 + +[External references](#external-references) 161 + +[DDE data item](#dde-data-item) 162 + +[DDE data source](#dde-data-source) 162 + +[external cell cache](#external-cell-cache) 162 + +[external defined name](#external-defined-name) 162 + +[external reference consumers](#external-reference-consumers) 161 + +[external workbook](#external-workbook) 162 + +[OLE data item](#ole-data-item) 162 + +[OLE data source](#ole-data-source) 162 + +[supporting link](#supporting-link) 161 + +[External References example](#external-references-1) 949 + +[External references: CRN example](#external-references-crn) 954 + +[External references: ExternSheet example](#external-references-externsheet) 955 + +[External references: Formula example](#external-references-formula) 950 + +[External references: String example](#external-references-string) 952 + +[External references: SupBook 1 example](#external-references-supbook-1) 953 + +[External references: SupBook 2 example](#external-references-supbook-2) 955 + +[External references: XCT example](#external-references-xct) 953 + +[External workbook](#external-workbook) 162 + +[ExternDdeLinkNoOper](#externddelinknooper) 649 + +[ExternDocName](#externdocname) 649 + +[ExternName](#externname) 286 + +[ExternOleDdeLink](#externoleddelink) 650 + +[ExternSheet](#externsheet) 288 + +[ExtNameParsedFormula](#extnameparsedformula) 757 + +[ExtProp](#extprop) 650 + +[ExtPtgArea3D](#extptgarea3d) 758 + +[ExtPtgAreaErr3D](#extptgareaerr3d) 758 + +[ExtPtgErr](#extptgerr) 758 + +[ExtPtgRef3D](#extptgref3d) 759 + +[ExtPtgRefErr3D](#extptgreferr3d) 759 + +[ExtRst](#extrst) 651 + +[ExtSheetPair](#extsheetpair) 759 + +[ExtSST](#extsst) 289 + +[ExtString](#extstring) 289 + +F + +[FactoidData](#factoiddata) 652 + +[Fbi](#fbi) 290 + +[Fbi2](#fbi2) 291 + +[Feat](#feat) 292 + +[Feat11CellStruct](#feat11cellstruct) 652 + +[Feat11FdaAutoFilter](#feat11fdaautofilter) 652 + +[Feat11FieldDataItem](#feat11fielddataitem) 653 + +[Feat11Fmla](#feat11fmla) 660 + +[Feat11RgInvalidCells](#feat11rginvalidcells) 660 + +[Feat11RgSharepointIdChange](#feat11rgsharepointidchange) 660 + +[Feat11RgSharepointIdDel](#feat11rgsharepointiddel) 661 + +[Feat11TotalFmla](#feat11totalfmla) 661 + +[Feat11WSSListInfo](#feat11wsslistinfo) 661 + +[Feat11XMap](#feat11xmap) 664 + +[Feat11XMapEntry](#feat11xmapentry) 664 + +[Feat11XMapEntry2](#feat11xmapentry2) 665 + +[FeatFormulaErr2](#featformulaerr2) 665 + +[FeatHdr](#feathdr) 293 + +[FeatHdr11](#feathdr11) 294 + +[FeatProtection](#featprotection) 665 + +[FeatSmartTag](#featsmarttag) 666 + +[Feature11](#feature11) 294 + +[Feature12](#feature12) 296 + +[FFErrorCheck](#fferrorcheck) 667 + +[Fields - vendor-extensible](#vendor-extensible-fields) 56 + +File storage + +[data spaces](#data-spaces-storage-006dataspaces) 60 + +[embedding](#embedding-storage-mbd...) 60 + +[link](#link-storage-lnk...) 60 + +[Office data store](#office-data-store-storage-msodatastore) 65 + +[pivot cache](#pivot-cache-storage-_sx_db_cur) 66 + +[VBA](#vba-storage-_vba_project_cur) 68 + +[XML signatures](#xml-signatures-storage-_xmlsignatures) 76 + +File streams + +[component object](#component-object-stream-001compobj) 59 + +[control](#control-stream-ctls) 60 + +[document summary information](#document-summary-information-stream-005documentsummaryinformation) 60 + +[encryption](#encryption-stream-encryption) 60 + +[list data](#list-data-stream-list-data) 61 + +[Office toolbars](#office-toolbars-stream-xcb) 65 + +[OLE](#ole-stream-001ole) 66 + +[protected content](#protected-content-stream-009drmcontent) 66 + +[revision](#revision-stream-revision-log) 66 + +[signatures](#signatures-stream-_signatures) 67 + +[summary information](#summary-information-stream-005summaryinformation) 67 + +[user names](#user-names-stream-user-names) 68 + +[viewer content](#viewer-content-stream-009drmviewercontent) 68 + +[workbook](#workbook-stream-workbook) 68 + +[XML](#xml-stream-xml) 76 + +[File structure](#file-structure) 57 + +[collection of records](#collection-of-records) 58 + +[compound file](#compound-file) 57 + +[future record](#future-record) 58 + +[record](#record) 57 + +[storages](#storages-and-streams) 59 + +[stream](#stream) 57 + +[streams](#storages-and-streams) 59 + +[substream](#substream) 57 + +[FileLock](#filelock) 296 + +[FilePass](#filepass) 297 + +[FileSharing](#filesharing) 298 + +[FillPattern](#fillpattern) 667 + +[FillStylePropertiesForShapePropsStreamChecksum](#fillstylepropertiesforshapepropsstreamchecksum) 668 + +[FilterMode](#filtermode) 298 + +[Filters example](#filters) 947 + +[Filters: AutoFilter example](#filters-autofilter) 948 + +[Filters: AutoFilterInfo example](#filters-autofilterinfo) 948 + +[Filters: FilterMode example](#filters-filtermode) 947 + +[FnGroupName](#fngroupname) 298 + +[FnGrp12](#fngrp12) 298 + +[Font](#font) 299 + +[FontIndex](#fontindex) 678 + +[FontInfo](#fontinfo) 678 + +[FontScheme](#fontscheme) 679 + +[FontX](#fontx) 301 + +[Footer](#footer) 302 + +[ForceFullCalculation](#forcefullcalculation) 302 + +[Format](#format) 303 + +[Format conflicts](#format-conflicts) 160 + +[FormatRun](#formatrun) 679 + +[Formatting example](#formatting) 982 + +[Formatting: Font 1 example](#formatting-font-1) 983 + +[Formatting: Font 2 example](#formatting-font-2) 984 + +[Formatting: Format example](#formatting-format) 985 + +[Formatting: Number 1 example](#formatting-number-1) 994 + +[Formatting: Number 2 example](#formatting-number-2) 995 + +[Formatting: Number 3 example](#formatting-number-3) 996 + +[Formatting: XF 1 example](#formatting-xf-1) 986 + +[Formatting: XF 2 example](#formatting-xf-2) 988 + +[Formatting: XF 3 example](#formatting-xf-3) 990 + +[Formatting: XF 4 example](#formatting-xf-4) 992 + +[Formula](#formula) 310 + +[Formula elements](#formula-elements) 83 + +[Formulas](#formulas) 81 + +[control tokens](#control-tokens) 83 + +[display tokens](#display-tokens) 83 + +[Formula elements](#formula-elements) 83 + +[Mem tokens](#mem-tokens) 83 + +[operand tokens](#operand-tokens) 82 + +[operator tokens](#operator-tokens) 82 + +[FormulaValue](#formulavalue) 679 + +[Frame](#frame) 311 + +[FrtFlags](#frtflags) 680 + +[FrtFontList](#frtfontlist) 312 + +[FrtHeader](#frtheader) 681 + +[FrtHeaderOld](#frtheaderold) 681 + +[FrtRefHeader](#frtrefheader) 681 + +[FrtRefHeaderNoGrbit](#frtrefheadernogrbit) 682 + +[FrtRefHeaderU](#frtrefheaderu) 682 + +[FrtWrapper](#frtwrapper) 312 + +[Ftab](#ftab) 760 + +[FtCbls](#ftcbls) 683 + +[FtCblsData](#ftcblsdata) 683 + +[FtCf](#ftcf) 684 + +[FtCmo](#ftcmo) 684 + +[FtEdoData](#ftedodata) 687 + +[FtGboData](#ftgbodata) 688 + +[FtGmo](#ftgmo) 688 + +[FtLbsData](#ftlbsdata) 689 + +[FtMacro](#ftmacro) 691 + +[FtNts](#ftnts) 692 + +[FtPictFmla](#ftpictfmla) 692 + +[FtPioGrbit](#ftpiogrbit) 693 + +[FtRbo](#ftrbo) 695 + +[FtSbs](#ftsbs) 696 + +[FullColorExt](#fullcolorext) 697 + +[Future record](#future-record) 58 + +[chart](#chart) 59 + +[PivotTable](#pivottable) 59 + +G + +[GelFrame](#gelframe) 313 + +[Glossary](#glossary) 29 + +[GradStop](#gradstop) 697 + +[GridSet](#gridset) 315 + +[GUIDTypeLib](#guidtypelib) 315 + +[Guts](#guts) 315 + +H + +[HCenter](#hcenter) 316 + +[Header](#header) 316 + +[HeaderFooter](#headerfooter) 320 + +[HFPicture](#hfpicture) 321 + +[HiddenMemberSet](#hiddenmemberset) 698 + +[HideObj](#hideobj) 323 + +[HideObjEnum](#hideobjenum) 698 + +[HLink](#hlink) 323 + +[HLinkTooltip](#hlinktooltip) 323 + +[HorizAlign](#horizalign) 699 + +[HorizontalPageBreaks](#horizontalpagebreaks) 324 + +[HorzBrk](#horzbrk) 699 + +I + +[Icv](#icv) 699 + +[IcvChart](#icvchart) 703 + +[IcvFont](#icvfont) 703 + +[IcvXF](#icvxf) 703 + +[IFmt](#ifmt) 703 + +[IFmtRecord](#ifmtrecord) 324 + +[Ilel](#ilel) 787 + +[Implementer - security considerations](#security-considerations) 1085 + +[Implementer – security considerations](#security-considerations) 1085 + +[Index](#index) 324 + +[Informative references](#informative-references) 53 + +[Insertion/deletion of rows/columns revision](#insertion-deletion-of-rows-columns-revision) 168 + +[InterfaceEnd](#interfaceend) 325 + +[InterfaceHdr](#interfacehdr) 325 + +[InteriorColorPropertiesForShapePropsStreamChecksum](#interiorcolorpropertiesforshapepropsstreamchecksum) 704 + +[Intl](#intl) 325 + +[Introduction](#introduction) 29 + +[ISSTInf](#isstinf) 705 + +[IXFCell](#ixfcell) 705 + +K + +[KPIProp](#kpiprop) 705 + +[KPISets](#kpisets) 706 + +L + +[Label](#label) 326 + +[LabelSst](#labelsst) 326 + +[Lbl](#lbl) 326 + +[LbsDropData](#lbsdropdata) 706 + +[LeftMargin](#leftmargin) 329 + +Legend ([section 2.2.3.8](#legend) 92, [section 2.4.152](#legend-1) 329) + +[LegendException](#legendexception) 330 + +[Lel](#lel) 331 + +[LEMMode](#lemmode) 707 + +[Line](#line) 331 + +[LineFormat](#lineformat) 332 + +[LinePropertiesForShapePropsStreamChecksum](#linepropertiesforshapepropsstreamchecksum) 708 + +[Link storage](#link-storage-lnk...) 60 + +[List data stream](#list-data-stream-list-data) 61 + +[List12](#list12) 333 + +[List12BlockLevel](#list12blocklevel) 709 + +[List12DisplayName](#list12displayname) 711 + +[List12TableStyleClientInfo](#list12tablestyleclientinfo) 712 + +[ListParsedArrayFormula](#listparsedarrayformula) 788 + +[ListParsedFormula](#listparsedformula) 788 + +[Localization](#versioning-and-localization) 55 + +[LongRGB](#longrgb) 712 + +[LongRGBA](#longrgba) 713 + +[LPr](#lpr) 334 + +[LPWideString](#lpwidestring) 713 + +[LRng](#lrng) 335 + +M + +[MarkerFormat](#markerformat) 335 + +[MDB](#mdb) 337 + +[MDir](#mdir) 713 + +[MDTInfo](#mdtinfo) 337 + +[MDTInfoIndex](#mdtinfoindex) 714 + +[MDX metadata](#mdx-metadata) 106 + +[MDXKPI](#mdxkpi) 339 + +[MDXProp](#mdxprop) 340 + +[MDXSet](#mdxset) 340 + +[MDXStr](#mdxstr) 341 + +[MDXStrIndex](#mdxstrindex) 714 + +[MDXTuple](#mdxtuple) 342 + +[Mem tokens](#mem-tokens) 83 + +[MergeCells](#mergecells) 342 + +[Metadata](#metadata) 104 + +[cell metadata](#cell-metadata) 105 + +[MDX metadata](#mdx-metadata) 106 + +[Metadata block](#metadata-block) 106 + +[metadata types](#metadata-types) 105 + +[value metadata](#value-metadata) 105 + +[Metadata block](#metadata-block) 106 + +[Metadata types](#metadata-types) 105 + +[Mms](#mms) 343 + +[MOper](#moper) 714 + +[Move cells revision](#move-cells-revision) 169 + +[MsoDrawing](#msodrawing) 343 + +[MsoDrawingGroup](#msodrawinggroup) 343 + +[MsoDrawingSelection](#msodrawingselection) 344 + +[MTRSettings](#mtrsettings) 344 + +[MulBlank](#mulblank) 345 + +[MulRk](#mulrk) 345 + +N + +[NameCmt](#namecmt) 346 + +[NameFnGrp12](#namefngrp12) 347 + +[NameParsedFormula](#nameparsedformula) 788 + +[NamePublish](#namepublish) 348 + +[NilChartNum](#nilchartnum) 715 + +[Normative references](#normative-references) 52 + +[Note](#note) 348 + +[NoteRR](#noterr) 715 + +[NoteSh](#notesh) 716 + +[Number](#number) 349 + +O + +[Obj](#obj) 349 + +[ObjectLink](#objectlink) 352 + +[ObjectParsedFormula](#objectparsedformula) 789 + +ObjFmla ([section 2.5.187](#objfmla) 717, [section 2.5.188](#objid) 718) + +[ObjLinkFmla](#objlinkfmla) 718 + +[ObjProtect](#objprotect) 352 + +[ObNoMacros](#obnomacros) 353 + +[ObProj](#obproj) 353 + +[ODBC connections](#odbc-connections) 164 + +[ODBCType](#odbctype) 719 + +[Office data store storage](#office-data-store-storage-msodatastore) 65 + +[Office toolbars stream](#office-toolbars-stream-xcb) 65 + +[OfficeArtClientAnchorChart](#officeartclientanchorchart) 719 + +[OfficeArtClientAnchorHF](#officeartclientanchorhf) 720 + +[OfficeArtClientAnchorSheet](#officeartclientanchorsheet) 721 + +[OfficeArtClientData](#officeartclientdata) 722 + +[OfficeArtClientTextbox](#officeartclienttextbox) 723 + +[OLE data item](#ole-data-item) 162 + +[OLE data source](#ole-data-source) 162 + +[OLE DB connections](#ole-db-connections) 163 + +[OLE stream](#ole-stream-001ole) 66 + +[OleDbConn](#oledbconn) 353 + +[OleObjectSize](#oleobjectsize) 354 + +[Operand tokens](#operand-tokens) 82 + +[Operator tokens](#operator-tokens) 82 + +[Organization of this documentation](#organization-of-this-documentation) 54 + +Overview + +[byte ordering](#stream-byte-ordering) 54 + +[organization of this documentation](#organization-of-this-documentation) 54 + +[Overview (synopsis)](#overview) 53 + +P + +[Palette](#palette) 354 + +[Pane](#pane) 354 + +[PaneType](#panetype) 723 + +[ParameterParsedFormula](#parameterparsedformula) 789 + +[ParamQry](#paramqry) 355 + +[PARAMQRY_Fixed](#paramqry_fixed) 724 + +Parsed expressions + +[ArrayParsedFormula](#arrayparsedformula) 725 + +[BErr](#berr) 725 + +[CellParsedFormula](#cellparsedformula) 726 + +[Cetab](#cetab) 726 + +[CFParsedFormula](#cfparsedformula) 755 + +[CFParsedFormulaNoCCE](#cfparsedformulanocce) 755 + +[CFVOParsedFormula](#cfvoparsedformula) 755 + +[ChartParsedFormula](#chartparsedformula) 756 + +[DVParsedFormula](#dvparsedformula) 756 + +[ExtNameParsedFormula](#extnameparsedformula) 757 + +[ExtPtgArea3D](#extptgarea3d) 758 + +[ExtPtgAreaErr3D](#extptgareaerr3d) 758 + +[ExtPtgErr](#extptgerr) 758 + +[ExtPtgRef3D](#extptgref3d) 759 + +[ExtPtgRefErr3D](#extptgreferr3d) 759 + +[ExtSheetPair structure](#extsheetpair) 759 + +[Ftab](#ftab) 760 + +[Ilel](#ilel) 787 + +[ListParsedArrayFormula](#listparsedarrayformula) 788 + +[ListParsedFormula](#listparsedformula) 788 + +[NameParsedFormula](#nameparsedformula) 788 + +[ObjectParsedFormula](#objectparsedformula) 789 + +[ParameterParsedFormula](#parameterparsedformula) 789 + +[PivotParsedFormula](#pivotparsedformula) 790 + +[Ptg](#ptg) 790 + +[PtgAdd](#ptgadd) 793 + +[PtgArea](#ptgarea) 793 + +[PtgArea3d](#ptgarea3d) 794 + +[PtgAreaErr](#ptgareaerr) 794 + +PtgAreaErr3d ([section 2.5.198.30](#ptgareaerr3d) 795, [section 2.5.198.31](#ptgarean) 795) + +[PtgArray](#ptgarray) 796 + +[PtgAttrBaxcel](#ptgattrbaxcel) 796 + +[PtgAttrChoose](#ptgattrchoose) 797 + +[PtgAttrGoto](#ptgattrgoto) 797 + +[PtgAttrIf structure](#ptgattrif) 798 + +[PtgAttrSemi](#ptgattrsemi) 798 + +[PtgAttrSpace](#ptgattrspace) 798 + +[PtgAttrSpaceSemi](#ptgattrspacesemi) 799 + +[PtgAttrSpaceType](#ptgattrspacetype) 799 + +[PtgAttrSum](#ptgattrsum) 800 + +[PtgBool](#ptgbool) 800 + +[PtgConcat](#ptgconcat) 800 + +[PtgDataType](#ptgdatatype) 800 + +[PtgDiv](#ptgdiv) 801 + +[PtgElfCol](#ptgelfcol) 801 + +[PtgElfColS](#ptgelfcols) 801 + +[PtgElfColSV](#ptgelfcolsv) 802 + +[PtgElfColV](#ptgelfcolv) 802 + +[PtgElfLel](#ptgelflel) 802 + +[PtgElfRadical](#ptgelfradical) 803 + +[PtgElfRadicalLel](#ptgelfradicallel) 803 + +[PtgElfRadicalS](#ptgelfradicals) 804 + +[PtgElfRw](#ptgelfrw) 804 + +[PtgElfRwV](#ptgelfrwv) 805 + +[PtgEq](#ptgeq) 805 + +[PtgErr](#ptgerr) 805 + +[PtgExp](#ptgexp) 805 + +[PtgExtraArray](#ptgextraarray) 806 + +[PtgExtraElf](#ptgextraelf) 806 + +[PtgExtraMem](#ptgextramem) 807 + +[PtgFunc](#ptgfunc) 807 + +[PtgFuncVar](#ptgfuncvar) 807 + +[PtgGe](#ptgge) 808 + +[PtgGt](#ptggt) 808 + +[PtgInt](#ptgint) 808 + +[PtgIsect](#ptgisect) 809 + +[PtgLe](#ptgle) 809 + +[PtgLt](#ptglt) 809 + +[PtgMemArea](#ptgmemarea) 809 + +[PtgMemErr](#ptgmemerr) 810 + +[PtgMemFunc](#ptgmemfunc) 810 + +[PtgMemNoMem](#ptgmemnomem) 811 + +[PtgMissArg](#ptgmissarg) 811 + +[PtgMul](#ptgmul) 811 + +[PtgName](#ptgname) 812 + +[PtgNameX](#ptgnamex) 812 + +[PtgNe](#ptgne) 813 + +[PtgNum](#ptgnum) 813 + +[PtgParen](#ptgparen) 813 + +[PtgPercent](#ptgpercent) 814 + +[PtgPower](#ptgpower) 814 + +[PtgRange](#ptgrange) 814 + +[PtgRef](#ptgref) 814 + +[PtgRef3d](#ptgref3d) 815 + +[PtgRefErr](#ptgreferr) 815 + +[PtgRefErr3d](#ptgreferr3d) 816 + +[PtgRefN](#ptgrefn) 816 + +[PtgStr](#ptgstr) 816 + +[PtgSub](#ptgsub) 817 + +[PtgSxName](#ptgsxname) 817 + +[PtgTbl](#ptgtbl) 817 + +[PtgUminus](#ptguminus) 818 + +[PtgUnion](#ptgunion) 818 + +[PtgUplus](#ptguplus) 818 + +[RevExtern](#revextern) 819 + +[RevItab](#revitab) 819 + +[RevLblName](#revlblname) 820 + +[RevName](#revname) 821 + +[RevNamePly](#revnameply) 822 + +[RevNameTabid](#revnametabid) 822 + +[RevSheetName](#revsheetname) 822 + +[RgbExtra](#rgbextra) 823 + +[Rgce](#rgce) 824 + +[RgceArea](#rgcearea) 827 + +[RgceAreaRel](#rgcearearel) 828 + +[RgceElfLoc](#rgceelfloc) 828 + +[RgceElfLocExtra](#rgceelflocextra) 829 + +[RgceLoc](#rgceloc) 829 + +[RgceLoc8](#rgceloc8) 829 + +[RgceLocRel](#rgcelocrel) 829 + +[SerAr](#serar) 830 + +[SerBool](#serbool) 830 + +[SerErr](#sererr) 831 + +[SerNil](#sernil) 831 + +[SerNum](#sernum) 831 + +[SerStr](#serstr) 832 + +[SharedParsedFormula](#sharedparsedformula) 832 + +[XtiIndex](#xtiindex) 833 + +[Password](#password) 355 + +[password verifier algorithm](#password-verifier-algorithm) 164 + +[PBT](#pbt) 833 + +[PhoneticInfo](#phoneticinfo) 356 + +[PhRuns](#phruns) 834 + +[Phs](#phs) 834 + +[PicF](#picf) 356 + +[PictFmlaEmbedInfo](#pictfmlaembedinfo) 835 + +[PictFmlaKey](#pictfmlakey) 835 + +[Pie](#pie) 357 + +[Pie Chart Sheet example](#pie-chart-sheet) 974 + +[Pie chart sheet: AxesUsed example](#pie-chart-sheet-axesused) 975 + +[Pie chart sheet: AxisParent example](#pie-chart-sheet-axisparent) 976 + +[Pie chart sheet: BRAI example](#pie-chart-sheet-brai) 981 + +[Pie chart sheet: Chart example](#pie-chart-sheet-chart) 974 + +[Pie chart sheet: ChartFormat example](#pie-chart-sheet-chartformat) 976 + +[Pie chart sheet: Legend example](#pie-chart-sheet-legend) 977 + +[Pie chart sheet: Pie example](#pie-chart-sheet-pie) 976 + +[Pie chart sheet: Pos example](#pie-chart-sheet-pos) 978 + +[Pie chart sheet: PrintSize example](#pie-chart-sheet-printsize) 974 + +[Pie chart sheet: ShtProps example](#pie-chart-sheet-shtprops) 975 + +[Pie chart sheet: Text example](#pie-chart-sheet-text) 979 + +[Pie chart sheet: Window2 example](#pie-chart-sheet-window2) 981 + +[PieFormat](#pieformat) 358 + +[Pivot cache storage](#pivot-cache-storage-_sx_db_cur) 66 + +[Pivot chart](#pivot-chart) 87 + +[PivotCache](#pivotcache) 118 + +[PivotChartBits](#pivotchartbits) 358 + +[PivotCompProp](#pivotcompprop) 836 + +[PivotParsedFormula](#pivotparsedformula) 790 + +[PivotTable](#pivottable) 59 + +[PivotTable example](#pivottable-1) 1031 + +[PivotTable records](#pivottable-records) 108 + +[PivotTable view](#pivottable-view) 135 + +[PivotTable: DConRef example](#pivottable-dconref) 1033 + +[PivotTable: EOF example](#pivottable-eof) 1084 + +[PivotTable: QsiSXTag example](#pivottable-qsisxtag) 1066 + +[PivotTable: SXAddl 1 example](#pivottable-sxaddl-1) 1034 + +[PivotTable: SXAddl 2 example](#pivottable-sxaddl-2) 1035 + +[PivotTable: SXAddl 3 example](#pivottable-sxaddl-3) 1036 + +[PivotTable: SxAddl 4 example](#pivottable-sxaddl-4) 1068 + +[PivotTable: SxAddl 5 example](#pivottable-sxaddl-5) 1069 + +[PivotTable: SxAddl 6 example](#pivottable-sxaddl-6) 1071 + +[PivotTable: SXDB example](#pivottable-sxdb) 1071 + +[PivotTable: SXDBB 1 example](#pivottable-sxdbb-1) 1082 + +[PivotTable: SXDBB 2 example](#pivottable-sxdbb-2) 1083 + +[PivotTable: SXDBEx example](#pivottable-sxdbex) 1073 + +[PivotTable: SXDI example](#pivottable-sxdi) 1057 + +[PivotTable: SXDtr 1 example](#pivottable-sxdtr-1) 1077 + +[PivotTable: SXDtr 2 example](#pivottable-sxdtr-2) 1077 + +[PivotTable: SXEx example](#pivottable-sxex) 1064 + +[PivotTable: SXFDB 1 example](#pivottable-sxfdb-1) 1073 + +[PivotTable: SXFDB 2 example](#pivottable-sxfdb-2) 1076 + +[PivotTable: SXFDB 3 example](#pivottable-sxfdb-3) 1078 + +[PivotTable: SXFDB 4 example](#pivottable-sxfdb-4) 1079 + +[PivotTable: SXFDB 5 example](#pivottable-sxfdb-5) 1081 + +[PivotTable: SxIvd example](#pivottable-sxivd) 1056 + +[PivotTable: SXLI 1 example](#pivottable-sxli-1) 1057 + +[PivotTable: SXLI 2 example](#pivottable-sxli-2) 1063 + +[PivotTable: SXNum 1 example](#pivottable-sxnum-1) 1080 + +[PivotTable: SXNum 2 example](#pivottable-sxnum-2) 1082 + +[PivotTable: SXNum 3 example](#pivottable-sxnum-3) 1083 + +[PivotTable: SXPI example](#pivottable-sxpi) 1056 + +[PivotTable: SXStreamID example](#pivottable-sxstreamid) 1032 + +[PivotTable: SXString 1 example](#pivottable-sxstring-1) 1075 + +[PivotTable: SXString 3 example](#pivottable-sxstring-3) 1075 + +[PivotTable: SXString21 example](#pivottable-sxstring-2) 1075 + +[PivotTable: Sxvd 1 example](#pivottable-sxvd-1) 1040 + +[PivotTable: Sxvd 2 example](#pivottable-sxvd-2) 1045 + +[PivotTable: Sxvd 3 example](#pivottable-sxvd-3) 1049 + +[PivotTable: Sxvd 4 example](#pivottable-sxvd-4) 1050 + +[PivotTable: Sxvd 5 example](#pivottable-sxvd-5) 1053 + +[PivotTable: SXVDEx 1 example](#pivottable-sxvdex-1) 1044 + +[PivotTable: SXVDEx 2 example](#pivottable-sxvdex-2) 1048 + +[PivotTable: SXVDEx 3 example](#pivottable-sxvdex-3) 1052 + +[PivotTable: SXVDEx 4 example](#pivottable-sxvdex-4) 1054 + +[PivotTable: SXVI 1 example](#pivottable-sxvi-1) 1041 + +[PivotTable: SXVI 2 example](#pivottable-sxvi-2) 1042 + +[PivotTable: SXVI 3 example](#pivottable-sxvi-3) 1042 + +[PivotTable: SXVI 4 example](#pivottable-sxvi-4) 1043 + +[PivotTable: SXVI 5 example](#pivottable-sxvi-5) 1047 + +[PivotTable: SXVI 6 example](#pivottable-sxvi-6) 1047 + +[PivotTable: SXVI 7 example](#pivottable-sxvi-7) 1048 + +[PivotTable: SxView example](#pivottable-sxview) 1036 + +[PivotTable: SXViewEx9 example](#pivottable-sxviewex9) 1068 + +[PivotTable: SXVS example](#pivottable-sxvs) 1032 + +[PivotTables](#pivottables) 107 + +[data functionality level](#data-functionality-level) 118 + +[PivotCache](#pivotcache) 118 + +[PivotTable records](#pivottable-records) 108 + +[PivotTable view](#pivottable-view) 135 + +[PlotArea](#plotarea) 359 + +[PlotGrowth](#plotgrowth) 359 + +[Pls](#pls) 359 + +[PLV](#plv) 360 + +[Pos](#pos) 360 + +[PositionMode](#positionmode) 836 + +[PrintGrid](#printgrid) 362 + +[PrintRowCol](#printrowcol) 362 + +[PrintSize](#printsize) 363 + +[Product behavior](#appendix-a-product-behavior) 1086 + +[Prot4Rev](#prot4rev) 363 + +[Prot4RevPass](#prot4revpass) 364 + +[Protect](#protect) 364 + +[Protected content stream](#protected-content-stream-009drmcontent) 66 + +[Ptg](#ptg) 790 + +[PtgAdd](#ptgadd) 793 + +[PtgArea](#ptgarea) 793 + +[PtgArea3d](#ptgarea3d) 794 + +[PtgAreaErr](#ptgareaerr) 794 + +PtgAreaErr3d ([section 2.5.198.30](#ptgareaerr3d) 795, [section 2.5.198.31](#ptgarean) 795) + +[PtgArray](#ptgarray) 796 + +[PtgAttrBaxcel](#ptgattrbaxcel) 796 + +[PtgAttrChoose](#ptgattrchoose) 797 + +[PtgAttrGoto](#ptgattrgoto) 797 + +[PtgAttrIf](#ptgattrif) 798 + +[PtgAttrSemi](#ptgattrsemi) 798 + +[PtgAttrSpace](#ptgattrspace) 798 + +[PtgAttrSpaceSemi](#ptgattrspacesemi) 799 + +[PtgAttrSpaceType](#ptgattrspacetype) 799 + +[PtgAttrSum](#ptgattrsum) 800 + +[PtgBool](#ptgbool) 800 + +[PtgConcat](#ptgconcat) 800 + +[PtgDataType](#ptgdatatype) 800 + +[PtgDiv](#ptgdiv) 801 + +[PtgElfCol](#ptgelfcol) 801 + +[PtgElfColS](#ptgelfcols) 801 + +[PtgElfColSV](#ptgelfcolsv) 802 + +[PtgElfColV](#ptgelfcolv) 802 + +[PtgElfLel](#ptgelflel) 802 + +[PtgElfRadical](#ptgelfradical) 803 + +[PtgElfRadicalLel](#ptgelfradicallel) 803 + +[PtgElfRadicalS](#ptgelfradicals) 804 + +[PtgElfRw](#ptgelfrw) 804 + +[PtgElfRwV](#ptgelfrwv) 805 + +[PtgEq](#ptgeq) 805 + +[PtgErr](#ptgerr) 805 + +[PtgExp](#ptgexp) 805 + +[PtgExtraArray](#ptgextraarray) 806 + +[PtgExtraElf](#ptgextraelf) 806 + +[PtgExtraMem](#ptgextramem) 807 + +[PtgFunc](#ptgfunc) 807 + +[PtgFuncVar](#ptgfuncvar) 807 + +[PtgGe](#ptgge) 808 + +[PtgGt](#ptggt) 808 + +[PtgInt](#ptgint) 808 + +[PtgIsect](#ptgisect) 809 + +[PtgLe](#ptgle) 809 + +[PtgLt](#ptglt) 809 + +[PtgMemArea](#ptgmemarea) 809 + +[PtgMemErr](#ptgmemerr) 810 + +[PtgMemFunc](#ptgmemfunc) 810 + +[PtgMemNoMem](#ptgmemnomem) 811 + +[PtgMissArg](#ptgmissarg) 811 + +[PtgMul](#ptgmul) 811 + +[PtgName](#ptgname) 812 + +[PtgNameX](#ptgnamex) 812 + +[PtgNe](#ptgne) 813 + +[PtgNum](#ptgnum) 813 + +[PtgParen](#ptgparen) 813 + +[PtgPercent](#ptgpercent) 814 + +[PtgPower](#ptgpower) 814 + +[PtgRange](#ptgrange) 814 + +[PtgRef](#ptgref) 814 + +[PtgRef3d](#ptgref3d) 815 + +[PtgRefErr](#ptgreferr) 815 + +[PtgRefErr3d](#ptgreferr3d) 816 + +[PtgRefN](#ptgrefn) 816 + +[PtgStr](#ptgstr) 816 + +[PtgSub](#ptgsub) 817 + +[PtgSxName](#ptgsxname) 817 + +[PtgTbl](#ptgtbl) 817 + +[PtgUminus](#ptguminus) 818 + +[PtgUnion](#ptgunion) 818 + +[PtgUplus](#ptguplus) 818 + +Q + +[Qsi](#qsi) 364 + +[Qsif](#qsif) 367 + +[Qsir](#qsir) 368 + +[QsiSXTag](#qsisxtag) 370 + +R + +[Radar](#radar) 372 + +[RadarArea](#radararea) 372 + +[ReadingOrder](#readingorder) 836 + +[RealTimeData](#realtimedata) 373 + +[RecalcId](#recalcid) 374 + +[RecipName](#recipname) 374 + +[Record](#record) 57 + +[Record enumeration](#record-enumeration) 169 + +[by name](#by-name) 170 + +[by number](#by-number) 181 + +Records + +[AlRuns](#alruns) 192 + +[Area](#area) 192 + +[AreaFormat](#areaformat) 193 + +[Array](#array) 198 + +[AttachedLabel](#attachedlabel) 199 + +[AutoFilter](#autofilter) 200 + +[AutoFilter12](#autofilter12) 202 + +[AutoFilterInfo](#autofilterinfo) 205 + +[AxcExt](#axcext) 205 + +[AxesUsed](#axesused) 208 + +[Axis](#axis-1) 208 + +[AxisLine](#axisline) 209 + +[AxisParent](#axisparent) 210 + +[Backup](#backup) 210 + +[Bar](#bar) 210 + +[BCUsrs](#bcusrs) 211 + +[Begin](#begin) 211 + +[BigName](#bigname) 212 + +[BkHim](#bkhim) 212 + +[Blank](#blank) 213 + +[BOF](#bof) 213 + +[BookBool](#bookbool) 215 + +[BookExt](#bookext) 216 + +[BoolErr](#boolerr) 217 + +[BopPop](#boppop) 217 + +[BopPopCustom](#boppopcustom) 219 + +[BottomMargin](#bottommargin) 220 + +[BoundSheet8](#boundsheet8) 221 + +[BRAI](#brai) 222 + +[BuiltInFnGroupCount](#builtinfngroupcount) 223 + +[CalcCount](#calccount) 224 + +[CalcDelta](#calcdelta) 224 + +[CalcIter](#calciter) 224 + +[CalcMode](#calcmode) 224 + +[CalcPrecision](#calcprecision) 225 + +[CalcRefMode](#calcrefmode) 225 + +[CalcSaveRecalc](#calcsaverecalc) 225 + +[CatLab](#catlab) 226 + +[CatSerRange](#catserrange) 226 + +[CbUsr](#cbusr) 228 + +[CellWatch](#cellwatch) 228 + +[CF](#cf) 229 + +[CF12](#cf12) 230 + +[CFEx](#cfex) 233 + +[Chart](#chart-2) 234 + +[Chart3d](#chart3d) 235 + +[Chart3DBarShape](#chart3dbarshape) 237 + +[ChartFormat](#chartformat) 237 + +[ChartFrtInfo](#chartfrtinfo) 238 + +[ClrtClient](#clrtclient) 239 + +[CodeName](#codename) 240 + +[CodePage](#codepage) 240 + +[ColInfo](#colinfo) 241 + +[Compat12](#compat12) 242 + +[CompressPictures](#compresspictures) 242 + +[CondFmt](#condfmt) 243 + +[CondFmt12](#condfmt12) 243 + +[Continue](#continue) 244 + +[Continue_SxaddlSxString](#continue_sxaddlsxstring) 432 + +[ContinueBigName](#continuebigname) 244 + +[ContinueFrt](#continuefrt) 245 + +[ContinueFrt11](#continuefrt11) 245 + +[ContinueFrt12](#continuefrt12) 246 + +[Country](#country) 246 + +[CrErr](#crerr) 248 + +[CRN](#crn) 248 + +[CrtLayout12](#crtlayout12) 249 + +[CrtLayout12A](#crtlayout12a) 251 + +[CrtLine](#crtline) 253 + +[CrtLink](#crtlink) 254 + +[CrtMlFrt](#crtmlfrt) 254 + +[CrtMlFrtContinue](#crtmlfrtcontinue) 255 + +[CUsr](#cusr) 255 + +[Dat](#dat) 255 + +[DataFormat](#dataformat) 256 + +[DataLabExt](#datalabext) 256 + +[DataLabExtContents](#datalabextcontents) 257 + +[Date1904](#date1904) 258 + +[DBCell](#dbcell) 258 + +[DbOrParamQry](#dborparamqry) 259 + +[DbQuery](#dbquery) 259 + +[DbQueryExt](#dbqueryext) 261 + +[DCon](#dcon) 263 + +[DConBin](#dconbin) 265 + +[DConn](#dconn) 266 + +[DConName](#dconname) 271 + +[DConRef](#dconref) 272 + +[DefaultRowHeight](#defaultrowheight) 273 + +[DefaultText](#defaulttext) 273 + +[DefColWidth](#defcolwidth) 274 + +[Dimensions](#dimensions) 274 + +[DocRoute](#docroute) 275 + +[DropBar](#dropbar) 277 + +[DropDownObjIds](#dropdownobjids) 278 + +[DSF](#dsf) 278 + +[Dv](#dv) 278 + +[DVal](#dval) 281 + +[DXF](#dxf) 282 + +[DxGCol](#dxgcol) 283 + +[End](#end) 283 + +[EndBlock](#endblock) 283 + +[EndObject](#endobject) 285 + +[EntExU2](#entexu2) 286 + +[EOF](#eof) 286 + +[Excel9File](#excel9file) 286 + +[ExternName](#externname) 286 + +[ExternSheet](#externsheet) 288 + +[ExtSST](#extsst) 289 + +[ExtString](#extstring) 289 + +[Fbi](#fbi) 290 + +[Fbi2](#fbi2) 291 + +[Feat](#feat) 292 + +[FeatHdr](#feathdr) 293 + +[FeatHdr11](#feathdr11) 294 + +[Feature11](#feature11) 294 + +[Feature12](#feature12) 296 + +[FileLock](#filelock) 296 + +[FilePass](#filepass) 297 + +[FileSharing](#filesharing) 298 + +[FilterMode](#filtermode) 298 + +[FnGroupName](#fngroupname) 298 + +[FnGrp12](#fngrp12) 298 + +[Font](#font) 299 + +[FontX](#fontx) 301 + +[Footer](#footer) 302 + +[ForceFullCalculation](#forcefullcalculation) 302 + +[Format](#format) 303 + +[Formula](#formula) 310 + +[Frame](#frame) 311 + +[FrtFontList](#frtfontlist) 312 + +[FrtWrapper](#frtwrapper) 312 + +[GelFrame](#gelframe) 313 + +[GridSet](#gridset) 315 + +[GUIDTypeLib](#guidtypelib) 315 + +[Guts](#guts) 315 + +[HCenter](#hcenter) 316 + +[Header](#header) 316 + +[HeaderFooter](#headerfooter) 320 + +[HFPicture](#hfpicture) 321 + +[HideObj](#hideobj) 323 + +[HLink](#hlink) 323 + +[HLinkTooltip](#hlinktooltip) 323 + +[HorizontalPageBreaks](#horizontalpagebreaks) 324 + +[IFmtRecord](#ifmtrecord) 324 + +[Index](#index) 324 + +[InterfaceEnd](#interfaceend) 325 + +[InterfaceHdr](#interfacehdr) 325 + +[Intl](#intl) 325 + +[Label](#label) 326 + +[LabelSst](#labelsst) 326 + +[Lbl](#lbl) 326 + +[LeftMargin](#leftmargin) 329 + +[Legend](#legend-1) 329 + +[LegendException](#legendexception) 330 + +[Lel](#lel) 331 + +[Line](#line) 331 + +[LineFormat](#lineformat) 332 + +[List12](#list12) 333 + +[LPr](#lpr) 334 + +[LRng](#lrng) 335 + +[MarkerFormat](#markerformat) 335 + +[MDB](#mdb) 337 + +[MDTInfo](#mdtinfo) 337 + +[MDXKPI](#mdxkpi) 339 + +[MDXProp](#mdxprop) 340 + +[MDXSet](#mdxset) 340 + +[MDXStr](#mdxstr) 341 + +[MDXTuple](#mdxtuple) 342 + +[MergeCells](#mergecells) 342 + +[Mms](#mms) 343 + +[MsoDrawing](#msodrawing) 343 + +[MsoDrawingGroup](#msodrawinggroup) 343 + +[MsoDrawingSelection](#msodrawingselection) 344 + +[MTRSettings](#mtrsettings) 344 + +[MulBlank](#mulblank) 345 + +[MulRk](#mulrk) 345 + +[NameCmt](#namecmt) 346 + +[NameFnGrp12](#namefngrp12) 347 + +[NamePublish](#namepublish) 348 + +[Note](#note) 348 + +[Number](#number) 349 + +[Obj](#obj) 349 + +[ObjectLink](#objectlink) 352 + +[ObjProtect](#objprotect) 352 + +[ObNoMacros](#obnomacros) 353 + +[ObProj](#obproj) 353 + +[OleDbConn](#oledbconn) 353 + +[OleObjectSize](#oleobjectsize) 354 + +[Palette](#palette) 354 + +[Pane](#pane) 354 + +[ParamQry](#paramqry) 355 + +[Password](#password) 355 + +[PhoneticInfo](#phoneticinfo) 356 + +[PicF](#picf) 356 + +[Pie](#pie) 357 + +[PieFormat](#pieformat) 358 + +[PivotChartBits](#pivotchartbits) 358 + +[PlotArea](#plotarea) 359 + +[PlotGrowth](#plotgrowth) 359 + +[Pls](#pls) 359 + +[PLV](#plv) 360 + +[Pos](#pos) 360 + +[PrintGrid](#printgrid) 362 + +[PrintRowCol](#printrowcol) 362 + +[PrintSize](#printsize) 363 + +[Prot4Rev](#prot4rev) 363 + +[Prot4RevPass](#prot4revpass) 364 + +[Protect](#protect) 364 + +[Qsi](#qsi) 364 + +[Qsif](#qsif) 367 + +[Qsir](#qsir) 368 + +[QsiSXTag](#qsisxtag) 370 + +[Radar](#radar) 372 + +[RadarArea](#radararea) 372 + +[RealTimeData](#realtimedata) 373 + +[RecalcId](#recalcid) 374 + +[RecipName](#recipname) 374 + +[RefreshAll](#refreshall) 375 + +[RichTextStream](#richtextstream) 375 + +[RightMargin](#rightmargin) 377 + +[RK](#rk) 377 + +[Row](#row) 378 + +[RRAutoFmt](#rrautofmt) 379 + +[RRDChgCell](#rrdchgcell) 380 + +[RRDConflict](#rrdconflict) 384 + +[RRDDefName](#rrddefname) 385 + +[RRDHead](#rrdhead) 387 + +[RRDInfo](#rrdinfo) 389 + +[RRDInsDel](#rrdinsdel) 390 + +[RRDInsDelBegin](#rrdinsdelbegin) 391 + +[RRDInsDelEnd](#rrdinsdelend) 391 + +[RRDMove](#rrdmove) 391 + +[RRDMoveBegin](#rrdmovebegin) 392 + +[RRDMoveEnd](#rrdmoveend) 392 + +[RRDRenSheet](#rrdrensheet) 392 + +[RRDRstEtxp](#rrdrstetxp) 393 + +[RRDTQSIF](#rrdtqsif) 394 + +[RRDUserView](#rrduserview) 395 + +[RRFormat](#rrformat) 396 + +[RRInsertSh](#rrinsertsh) 396 + +[RRSort](#rrsort) 397 + +[RRTabId](#rrtabid) 398 + +[SBaseRef](#sbaseref) 398 + +[Scatter](#scatter) 399 + +[SCENARIO](#scenario) 400 + +[ScenarioProtect](#scenarioprotect) 401 + +[ScenMan](#scenman) 401 + +[Scl](#scl) 402 + +[Selection](#selection) 402 + +[SerAuxErrBar](#serauxerrbar) 403 + +[SerAuxTrend](#serauxtrend) 404 + +[SerFmt](#serfmt) 405 + +[Series](#series-1) 406 + +[SeriesList](#serieslist) 407 + +[SeriesText](#seriestext) 407 + +[SerParent](#serparent) 407 + +[SerToCrt](#sertocrt) 408 + +[Setup](#setup) 408 + +[ShapePropsStream](#shapepropsstream) 413 + +[SheetExt](#sheetext) 414 + +[ShrFmla](#shrfmla) 415 + +[ShtProps](#shtprops) 415 + +[SIIndex](#siindex) 416 + +[Sort](#sort) 417 + +[SortData](#sortdata) 418 + +[SST](#sst) 420 + +[StartBlock](#startblock) 421 + +[StartObject](#startobject) 426 + +[String](#string) 427 + +[Style](#style) 427 + +[StyleExt](#styleext) 428 + +[SupBook](#supbook) 429 + +[Surf](#surf) 431 + +[SXAddl](#sxaddl) 432 + +[SXAddl_SXCAutoSort_SXDEnd](#sxaddl_sxcautosort_sxdend) 433 + +[SXAddl_SXCAutoSort_SXDId](#sxaddl_sxcautosort_sxdid) 433 + +[SXAddl_SXCCache_SXDEnd](#sxaddl_sxccache_sxdend) 434 + +[SXAddl_SXCCache_SXDId](#sxaddl_sxccache_sxdid) 434 + +[SXAddl_SXCCache_SXDInfo12](#sxaddl_sxccache_sxdinfo12) 434 + +[SXAddl_SXCCache_SXDInvRefreshReal](#sxaddl_sxccache_sxdinvrefreshreal) 435 + +[SXAddl_SXCCache_SXDVer10Info](#sxaddl_sxccache_sxdver10info) 435 + +[SXAddl_SXCCache_SXDVerSXMacro](#sxaddl_sxccache_sxdversxmacro) 436 + +[SXAddl_SXCCache_SXDVerUpdInv](#sxaddl_sxccache_sxdverupdinv) 437 + +[SXAddl_SXCCacheField_SXDCaption](#sxaddl_sxccachefield_sxdcaption) 437 + +[SXAddl_SXCCacheField_SXDEnd](#sxaddl_sxccachefield_sxdend) 437 + +[SXAddl_SXCCacheField_SXDId](#sxaddl_sxccachefield_sxdid) 438 + +[SXAddl_SXCCacheField_SXDIfdbMempropMap](#sxaddl_sxccachefield_sxdifdbmempropmap) 438 + +[SXAddl_SXCCacheField_SXDIfdbMpMapCount](#sxaddl_sxccachefield_sxdifdbmpmapcount) 439 + +[SXAddl_SXCCacheField_SXDProperty](#sxaddl_sxccachefield_sxdproperty) 439 + +[SXAddl_SXCCacheField_SXDPropName](#sxaddl_sxccachefield_sxdpropname) 440 + +[SXAddl_SXCCacheField_SXDSxrmitmCount](#sxaddl_sxccachefield_sxdsxrmitmcount) 440 + +[SXAddl_SXCCacheItem_SXDEnd](#sxaddl_sxccacheitem_sxdend) 441 + +[SXAddl_SXCCacheItem_SXDId](#sxaddl_sxccacheitem_sxdid) 441 + +[SXAddl_SXCCacheItem_SXDItmMpMapCount](#sxaddl_sxccacheitem_sxditmmpmapcount) 441 + +[SXAddl_SXCCacheItem_SXDItmMpropMap](#sxaddl_sxccacheitem_sxditmmpropmap) 442 + +[SXAddl_SXCCacheItem_SXDSxrmitmDisp](#sxaddl_sxccacheitem_sxdsxrmitmdisp) 442 + +[SXAddl_SXCField_SXDEnd](#sxaddl_sxcfield_sxdend) 443 + +[SXAddl_SXCField_SXDId](#sxaddl_sxcfield_sxdid) 443 + +[SXAddl_SXCField_SXDVer10Info](#sxaddl_sxcfield_sxdver10info) 443 + +[SXAddl_SXCField12_SXDAutoshow](#sxaddl_sxcfield12_sxdautoshow) 444 + +[SXAddl_SXCField12_SXDEnd](#sxaddl_sxcfield12_sxdend) 444 + +[SXAddl_SXCField12_SXDId](#sxaddl_sxcfield12_sxdid) 445 + +[SXAddl_SXCField12_SXDISXTH](#sxaddl_sxcfield12_sxdisxth) 445 + +[SXAddl_SXCField12_SXDMemberCaption](#sxaddl_sxcfield12_sxdmembercaption) 446 + +[SXAddl_SXCField12_SXDVer12Info](#sxaddl_sxcfield12_sxdver12info) 446 + +[SXAddl_SXCField12_SXDVerUpdInv](#sxaddl_sxcfield12_sxdverupdinv) 447 + +[SXAddl_SXCGroup_SXDEnd](#sxaddl_sxcgroup_sxdend) 447 + +[SXAddl_SXCGroup_SXDGrpInfo](#sxaddl_sxcgroup_sxdgrpinfo) 448 + +[SXAddl_SXCGroup_SXDId](#sxaddl_sxcgroup_sxdid) 449 + +[SXAddl_SXCGroup_SXDMember](#sxaddl_sxcgroup_sxdmember) 449 + +[SXAddl_SXCGrpLevel_SXDEnd](#sxaddl_sxcgrplevel_sxdend) 450 + +[SXAddl_SXCGrpLevel_SXDGrpLevelInfo](#sxaddl_sxcgrplevel_sxdgrplevelinfo) 450 + +[SXAddl_SXCGrpLevel_SXDId](#sxaddl_sxcgrplevel_sxdid) 451 + +[SXAddl_SXCHierarchy_SXDDisplayFolder](#sxaddl_sxchierarchy_sxddisplayfolder) 451 + +[SXAddl_SXCHierarchy_SXDEnd](#sxaddl_sxchierarchy_sxdend) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember](#sxaddl_sxchierarchy_sxdfiltermember) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember12](#sxaddl_sxchierarchy_sxdfiltermember12) 453 + +[SXAddl_SXCHierarchy_SXDIconSet](#sxaddl_sxchierarchy_sxdiconset) 454 + +[SXAddl_SXCHierarchy_SXDId](#sxaddl_sxchierarchy_sxdid) 454 + +[SXAddl_SXCHierarchy_SXDInfo12](#sxaddl_sxchierarchy_sxdinfo12) 455 + +[SXAddl_SXCHierarchy_SXDKPIGoal](#sxaddl_sxchierarchy_sxdkpigoal) 456 + +[SXAddl_SXCHierarchy_SXDKPIStatus](#sxaddl_sxchierarchy_sxdkpistatus) 456 + +[SXAddl_SXCHierarchy_SXDKPITime](#sxaddl_sxchierarchy_sxdkpitime) 456 + +[SXAddl_SXCHierarchy_SXDKPITrend](#sxaddl_sxchierarchy_sxdkpitrend) 457 + +[SXAddl_SXCHierarchy_SXDKPIValue](#sxaddl_sxchierarchy_sxdkpivalue) 457 + +[SXAddl_SXCHierarchy_SXDKPIWeight](#sxaddl_sxchierarchy_sxdkpiweight) 458 + +[SXAddl_SXCHierarchy_SXDMeasureGrp](#sxaddl_sxchierarchy_sxdmeasuregrp) 458 + +[SXAddl_SXCHierarchy_SXDParentKPI](#sxaddl_sxchierarchy_sxdparentkpi) 459 + +[SXAddl_SXCHierarchy_SXDProperty](#sxaddl_sxchierarchy_sxdproperty) 459 + +[SXAddl_SXCHierarchy_SXDSXSetParentUnique](#sxaddl_sxchierarchy_sxdsxsetparentunique) 461 + +[SXAddl_SXCHierarchy_SXDUserCaption](#sxaddl_sxchierarchy_sxdusercaption) 461 + +[SXAddl_SXCHierarchy_SXDVerUpdInv](#sxaddl_sxchierarchy_sxdverupdinv) 461 + +[SXAddl_SXCQsi_SXDEnd](#sxaddl_sxcqsi_sxdend) 462 + +[SXAddl_SXCQsi_SXDId](#sxaddl_sxcqsi_sxdid) 462 + +[SXAddl_SXCQuery_SXDEnd](#sxaddl_sxcquery_sxdend) 462 + +[SXAddl_SXCQuery_SXDReconnCond](#sxaddl_sxcquery_sxdreconncond) 463 + +[SXAddl_SXCQuery_SXDSrcConnFile](#sxaddl_sxcquery_sxdsrcconnfile) 464 + +[SXAddl_SXCQuery_SXDSrcDataFile](#sxaddl_sxcquery_sxdsrcdatafile) 464 + +[SXAddl_SXCQuery_SXDXMLSource](#sxaddl_sxcquery_sxdxmlsource) 464 + +[SXAddl_SXCSXCondFmt_SXDEnd](#sxaddl_sxcsxcondfmt_sxdend) 465 + +[SXAddl_SXCSXCondFmt_SXDSXCondFmt](#sxaddl_sxcsxcondfmt_sxdsxcondfmt) 465 + +[SXAddl_SXCSXCondFmts_SXDEnd](#sxaddl_sxcsxcondfmts_sxdend) 466 + +[SXAddl_SXCSXCondFmts_SXDId](#sxaddl_sxcsxcondfmts_sxdid) 467 + +[SXAddl_SXCSXDH_SXDEnd](#sxaddl_sxcsxdh_sxdend) 467 + +[SXAddl_SXCSXDH_SXDId](#sxaddl_sxcsxdh_sxdid) 468 + +[SXAddl_SXCSXDH_SXDSxdh](#sxaddl_sxcsxdh_sxdsxdh) 468 + +[SXAddl_SXCSXfilt_SXDEnd](#sxaddl_sxcsxfilt_sxdend) 469 + +[SXAddl_SXCSXfilt_SXDId](#sxaddl_sxcsxfilt_sxdid) 470 + +[SXAddl_SXCSXfilt_SXDSXfilt](#sxaddl_sxcsxfilt_sxdsxfilt) 470 + +[SXAddl_SXCSXfilt_SXDSXItm](#sxaddl_sxcsxfilt_sxdsxitm) 471 + +[SXAddl_SXCSXFilter12_SXDCaption](#sxaddl_sxcsxfilter12_sxdcaption) 472 + +[SXAddl_SXCSXFilter12_SXDEnd](#sxaddl_sxcsxfilter12_sxdend) 473 + +[SXAddl_SXCSXFilter12_SXDId](#sxaddl_sxcsxfilter12_sxdid) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilter](#sxaddl_sxcsxfilter12_sxdsxfilter) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilterDesc](#sxaddl_sxcsxfilter12_sxdsxfilterdesc) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue1](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue2](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2) 475 + +[SXAddl_SXCSXFilter12_SXDXlsFilter](#sxaddl_sxcsxfilter12_sxdxlsfilter) 476 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue1](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1) 476 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue2](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2) 477 + +[SXAddl_SXCSXFilters12_SXDEnd](#sxaddl_sxcsxfilters12_sxdend) 477 + +[SXAddl_SXCSXFilters12_SXDId](#sxaddl_sxcsxfilters12_sxdid) 478 + +[SXAddl_SXCSXMg_SXDEnd](#sxaddl_sxcsxmg_sxdend) 478 + +[SXAddl_SXCSXMg_SXDId](#sxaddl_sxcsxmg_sxdid) 478 + +[SXAddl_SXCSXMg_SXDUserCaption](#sxaddl_sxcsxmg_sxdusercaption) 479 + +[SXAddl_SXCSXMgs_SXDEnd](#sxaddl_sxcsxmgs_sxdend) 479 + +[SXAddl_SXCSXMgs_SXDId](#sxaddl_sxcsxmgs_sxdid) 479 + +[SXAddl_SXCSXMgs_SXDMGrpSXDHMap](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap) 480 + +[SXAddl_SXCSXrule_SXDEnd](#sxaddl_sxcsxrule_sxdend) 481 + +[SXAddl_SXCSXrule_SXDId](#sxaddl_sxcsxrule_sxdid) 481 + +[SXAddl_SXCSXrule_SXDSXrule](#sxaddl_sxcsxrule_sxdsxrule) 481 + +[SXAddl_SXCView_SXDCalcMember](#sxaddl_sxcview_sxdcalcmember) 484 + +[SXAddl_SXCView_SXDCalcMemString](#sxaddl_sxcview_sxdcalcmemstring) 486 + +[SXAddl_SXCView_SXDCompactColHdr](#sxaddl_sxcview_sxdcompactcolhdr) 486 + +[SXAddl_SXCView_SXDCompactRwHdr](#sxaddl_sxcview_sxdcompactrwhdr) 487 + +[SXAddl_SXCView_SXDEnd](#sxaddl_sxcview_sxdend) 487 + +[SXAddl_SXCView_SXDId](#sxaddl_sxcview_sxdid) 488 + +[SXAddl_SXCView_SXDSXPIIvmb](#sxaddl_sxcview_sxdsxpiivmb) 488 + +[SXAddl_SXCView_SXDTableStyleClient](#sxaddl_sxcview_sxdtablestyleclient) 489 + +[SXAddl_SXCView_SXDVer10Info](#sxaddl_sxcview_sxdver10info) 489 + +[SXAddl_SXCView_SXDVer12Info](#sxaddl_sxcview_sxdver12info) 491 + +[SXAddl_SXCView_SXDVerUpdInv](#sxaddl_sxcview_sxdverupdinv) 493 + +[SxBool](#sxbool) 494 + +[SXDB](#sxdb) 494 + +[SXDBB](#sxdbb) 495 + +[SXDBEx](#sxdbex) 495 + +[SXDI](#sxdi) 496 + +[SXDtr](#sxdtr) 498 + +[SxDXF](#sxdxf) 498 + +[SxErr](#sxerr) 499 + +[SXEx](#sxex) 499 + +[SXFDB](#sxfdb) 502 + +[SXFDBType](#sxfdbtype) 505 + +[SxFilt](#sxfilt) 505 + +[SxFmla](#sxfmla) 506 + +[SxFormat](#sxformat) 507 + +[SxFormula](#sxformula) 507 + +[SxInt](#sxint) 507 + +[SxIsxoper](#sxisxoper) 508 + +[SxItm](#sxitm) 508 + +[SxIvd](#sxivd) 509 + +[SXLI](#sxli) 510 + +[SxName](#sxname) 510 + +[SxNil](#sxnil) 511 + +[SXNum](#sxnum) 511 + +[SXPair](#sxpair) 511 + +[SXPI](#sxpi) 512 + +[SXPIEx](#sxpiex) 513 + +[SXRng](#sxrng) 513 + +[SxRule](#sxrule) 515 + +[SxSelect](#sxselect) 517 + +[SXStreamID](#sxstreamid) 519 + +[SXString](#sxstring) 519 + +[SXTbl](#sxtbl) 519 + +[SxTbpg](#sxtbpg) 520 + +[SXTBRGIITM](#sxtbrgiitm) 521 + +[SXTH](#sxth) 521 + +[Sxvd](#sxvd) 524 + +[SXVDEx](#sxvdex) 528 + +[SXVDTEx](#sxvdtex) 531 + +[SXVI](#sxvi) 532 + +[SxView](#sxview) 534 + +[SxViewEx](#sxviewex) 536 + +[SxViewEx9](#sxviewex9) 537 + +[SxViewLink](#sxviewlink) 538 + +[SXVS](#sxvs) 539 + +[Sync](#sync) 539 + +[Table](#table) 539 + +[TableStyle](#tablestyle) 541 + +[TableStyleElement](#tablestyleelement) 542 + +[TableStyles](#tablestyles) 545 + +[Template](#template) 546 + +[Text](#text) 546 + +[TextPropsStream](#textpropsstream) 551 + +[Theme](#theme) 553 + +[Tick](#tick) 553 + +[TopMargin](#topmargin) 556 + +[TxO](#txo) 557 + +[TxtQry](#txtqry) 559 + +[Uncalced](#uncalced) 561 + +[Units](#units) 561 + +[UserBView](#userbview) 561 + +[UserSViewBegin](#usersviewbegin) 565 + +[UserSViewBegin_Chart](#usersviewbegin_chart) 568 + +[UserSViewEnd](#usersviewend) 570 + +[UsesELFs](#useselfs) 570 + +[UsrChk](#usrchk) 570 + +[UsrExcl](#usrexcl) 571 + +[UsrInfo](#usrinfo) 572 + +[ValueRange](#valuerange) 572 + +[VCenter](#vcenter) 575 + +[VerticalPageBreaks](#verticalpagebreaks) 575 + +[WebPub](#webpub) 575 + +[Window1](#window1) 578 + +[Window2](#window2) 579 + +[WinProtect](#winprotect) 581 + +[WOpt](#wopt) 582 + +[WriteAccess](#writeaccess) 583 + +[WriteProtect](#writeprotect) 584 + +[WsBool](#wsbool) 584 + +[XCT](#xct) 585 + +[XF](#xf) 585 + +[XFCRC](#xfcrc) 586 + +[XFExt](#xfext) 586 + +[YMult](#ymult) 587 + +[Ref](#ref) 837 + +[Ref8](#ref8) 837 + +[Ref8U](#ref8u) 838 + +[Ref8U2007](#ref8u2007) 838 + +[References](#references) 52 + +[informative](#informative-references) 53 + +[normative](#normative-references) 52 + +[RefreshAll](#refreshall) 375 + +[RefU](#refu) 839 + +[Relationship to protocols and other structures](#relationship-to-protocols-and-other-structures) 55 + +[RevExtern](#revextern) 819 + +[Revision logs](#revision-logs) 168 + +[Revision records](#revision-records) 168 + +[Revision stream](#revision-stream-revision-log) 66 + +[RevisionType](#revisiontype) 839 + +[RevItab](#revitab) 819 + +[RevLblName](#revlblname) 820 + +[RevName](#revname) 821 + +[RevNamePly](#revnameply) 822 + +[RevNameTabid](#revnametabid) 822 + +[RevSheetName](#revsheetname) 822 + +[RFX](#rfx) 840 + +[RgbExtra](#rgbextra) 823 + +[Rgce](#rgce) 824 + +[RgceArea](#rgcearea) 827 + +[RgceAreaRel](#rgcearearel) 828 + +[RgceElfLoc](#rgceelfloc) 828 + +[RgceElfLocExtra](#rgceelflocextra) 829 + +[RgceLoc](#rgceloc) 829 + +[RgceLoc8](#rgceloc8) 829 + +[RgceLocRel](#rgcelocrel) 829 + +[RichTextStream](#richtextstream) 375 + +[RichTextStreamChecksumData](#richtextstreamchecksumdata) 840 + +[RichTextStreamChecksumFontInformation](#richtextstreamchecksumfontinformation) 842 + +[RichTextStreamChecksumFontInformationArrayItem](#richtextstreamchecksumfontinformationarrayitem) 844 + +[RightMargin](#rightmargin) 377 + +[RK](#rk) 377 + +[RkNumber](#rknumber) 844 + +[RkRec](#rkrec) 845 + +[Row](#row) 378 + +[RPHSSub](#rphssub) 845 + +[RRAutoFmt](#rrautofmt) 379 + +[RRD](#rrd) 846 + +[RRDChgCell](#rrdchgcell) 380 + +[RRDConflict](#rrdconflict) 384 + +[RRDDefName](#rrddefname) 385 + +[RRDDefNameFlags](#rrddefnameflags) 846 + +[RRDHead](#rrdhead) 387 + +[RRDInfo](#rrdinfo) 389 + +[RRDInsDel](#rrdinsdel) 390 + +[RRDInsDelBegin](#rrdinsdelbegin) 391 + +[RRDInsDelEnd](#rrdinsdelend) 391 + +[RRDMove](#rrdmove) 391 + +[RRDMoveBegin](#rrdmovebegin) 392 + +[RRDMoveEnd](#rrdmoveend) 392 + +[RRDRenSheet](#rrdrensheet) 392 + +[RRDRstEtxp](#rrdrstetxp) 393 + +[RRDTQSIF](#rrdtqsif) 394 + +[RRDUserView](#rrduserview) 395 + +[RRFormat](#rrformat) 396 + +[RRInsertSh](#rrinsertsh) 396 + +[RRLoc](#rrloc) 848 + +[RRSort](#rrsort) 397 + +[RRTabId](#rrtabid) 398 + +[RTDEItem](#rtdeitem) 848 + +[RTDOper](#rtdoper) 848 + +[RTDOperStr](#rtdoperstr) 849 + +[Run](#run) 849 + +[Rw](#rw) 849 + +[Rw12](#rw12) 850 + +[RwLongU](#rwlongu) 850 + +[RwU](#rwu) 850 + +[Rwx](#rwx) 850 + +S + +[SBaseRef](#sbaseref) 398 + +[Scatter](#scatter) 399 + +[SCENARIO](#scenario) 400 + +[ScenarioProtect](#scenarioprotect) 401 + +[ScenMan](#scenman) 401 + +[Scl](#scl) 402 + +[Script](#script) 851 + +[SD_SetSortOrder](#sd_setsortorder) 851 + +[SDContainer](#sdcontainer) 851 + +[Security - implementer considerations](#security-considerations) 1085 + +[Security – implementer considerations](#security-considerations) 1085 + +Security considerations + +[encryption (password to open)](#encryption-password-to-open) 165 + +[password verifier algorithm](#password-verifier-algorithm) 164 + +[SecurityDescriptor](#securitydescriptor) 852 + +[Selection](#selection) 402 + +[SerAr](#serar) 830 + +[SerAuxErrBar](#serauxerrbar) 403 + +[SerAuxTrend](#serauxtrend) 404 + +[SerBool](#serbool) 830 + +[SerErr](#sererr) 831 + +[SerFmt](#serfmt) 405 + +Series ([section 2.2.3.9](#series) 94, [section 2.4.252](#series-1) 406) + +[SeriesList](#serieslist) 407 + +[SeriesText](#seriestext) 407 + +[SerNil](#sernil) 831 + +[SerNum](#sernum) 831 + +[SerParent](#serparent) 407 + +[SerStr](#serstr) 832 + +[SerToCrt](#sertocrt) 408 + +[Setup](#setup) 408 + +[ShapePropsStream](#shapepropsstream) 413 + +[ShapePropsStreamChecksumData](#shapepropsstreamchecksumdata) 852 + +[Shared feature](#shared-feature) 169 + +[Shared workbooks](#shared-workbooks) 166 + +[change cells revision](#change-cells-revision) 169 + +[insertion/deletion of rows/columns revision](#insertion-deletion-of-rows-columns-revision) 168 + +[move cells revision](#move-cells-revision) 169 + +[revision logs](#revision-logs) 168 + +[revision records](#revision-records) 168 + +[sort map](#sort-map) 169 + +[user log](#user-log) 168 + +[SharedFeatureType](#sharedfeaturetype) 853 + +[SharedParsedFormula](#sharedparsedformula) 832 + +[SheetExt](#sheetext) 414 + +[SheetExtOptional](#sheetextoptional) 854 + +[ShortDTR](#shortdtr) 855 + +[ShortXLUnicodeString](#shortxlunicodestring) 855 + +[ShrFmla](#shrfmla) 415 + +[ShtProps](#shtprops) 415 + +[Signatures stream](#signatures-stream-_signatures) 67 + +[SIIndex](#siindex) 416 + +[SLCO8](#slco8) 856 + +[Sort](#sort) 417 + +[sort map](#sort-map) 169 + +[SortCond12](#sortcond12) 856 + +[SortData](#sortdata) 418 + +[SortItem](#sortitem) 857 + +[SourceType](#sourcetype) 858 + +[SPRC](#sprc) 104 + +[SQElfFlags](#sqelfflags) 858 + +[SqRef](#sqref) 858 + +[SqRefU](#sqrefu) 859 + +[SST](#sst) 420 + +[StartBlock](#startblock) 421 + +[StartObject](#startobject) 426 + +[Storages](#storages-and-streams) 59 + +[Stream](#stream) 57 + +[Streams](#storages-and-streams) 59 + +[document summary information](#document-summary-information-stream-005documentsummaryinformation) 60 + +[String](#string) 427 + +Structures + +[AddinUdf](#addinudf) 588 + +[AF12CellIcon](#af12cellicon) 588 + +[AF12Criteria](#af12criteria) 589 + +[AF12DateInfo](#af12dateinfo) 589 + +[AFDOper](#afdoper) 590 + +[AFDOperBoolErr](#afdoperboolerr) 591 + +[AFDOperRk](#afdoperrk) 592 + +[AFDOperStr](#afdoperstr) 592 + +[ArrayParsedFormula](#arrayparsedformula) 725 + +[AutoFmt8](#autofmt8) 593 + +[BErr](#berr) 725 + +[Bes](#bes) 594 + +[Bold](#bold) 595 + +[BookExt_Conditional11](#bookext_conditional11) 595 + +[BookExt_Conditional12](#bookext_conditional12) 595 + +[Boolean](#boolean) 596 + +[BorderStyle](#borderstyle) 596 + +[BuiltInStyle](#builtinstyle) 597 + +[CachedDiskHeader](#cacheddiskheader) 597 + +[Cch255](#cch255) 598 + +[Cell](#cell) 598 + +[CellParsedFormula](#cellparsedformula) 726 + +[CellXF](#cellxf) 598 + +[Cetab](#cetab) 726 + +[CFColor](#cfcolor) 602 + +[CFDatabar](#cfdatabar) 602 + +[CFExAveragesTemplateParams](#cfexaveragestemplateparams) 604 + +[CFExDateTemplateParams](#cfexdatetemplateparams) 604 + +[CFExDefaultTemplateParams](#cfexdefaulttemplateparams) 605 + +[CFExFilterParams](#cfexfilterparams) 605 + +[CFExNonCF12](#cfexnoncf12) 606 + +[CFExTemplateParams](#cfextemplateparams) 608 + +[CFExTextTemplateParams](#cfextexttemplateparams) 609 + +[CFFilter](#cffilter) 609 + +[CFFlag](#cfflag) 610 + +[CFGradient](#cfgradient) 611 + +[CFGradientInterpItem](#cfgradientinterpitem) 611 + +[CFGradientItem](#cfgradientitem) 612 + +[CFMStateItem](#cfmstateitem) 613 + +[CFMultistate](#cfmultistate) 613 + +[CFParsedFormula](#cfparsedformula) 755 + +[CFParsedFormulaNoCCE](#cfparsedformulanocce) 755 + +[CFrtId](#cfrtid) 614 + +[CFT](#cft) 615 + +[CFVO](#cfvo) 616 + +[CFVOParsedFormula](#cfvoparsedformula) 755 + +[ChartNumNillable](#chartnumnillable) 617 + +[ChartParsedFormula](#chartparsedformula) 756 + +[Col](#col) 617 + +[Col_NegativeOne](#col_negativeone) 617 + +[Col12](#col12) 618 + +[Col256U](#col256u) 618 + +[ColByte](#colbyte) 618 + +[ColByteU](#colbyteu) 619 + +[ColElfU](#colelfu) 619 + +[ColorICV](#coloricv) 619 + +[ColorTheme](#colortheme) 620 + +[ColRelNegU](#colrelnegu) 620 + +[ColRelU](#colrelu) 621 + +[ColSlco8U](#colslco8u) 621 + +[ColU](#colu) 621 + +[Colx](#colx) 622 + +[conceptual overview](#conceptual-overview) 80 + +[CondDataValue](#conddatavalue) 622 + +[CondFmtStructure](#condfmtstructure) 622 + +[ConnGrbitDbt](#conngrbitdbt) 623 + +[ConnGrbitDbtAdo](#conngrbitdbtado) 623 + +[ConnGrbitDbtOledb](#conngrbitdbtoledb) 624 + +[ConnGrbitDbtWeb](#conngrbitdbtweb) 625 + +[ControlInfo](#controlinfo) 626 + +[CrtLayout12Mode](#crtlayout12mode) 626 + +[DataFunctionalityLevel](#datafunctionalitylevel) 627 + +[DataSourceType](#datasourcetype) 627 + +[DateAsNum](#dateasnum) 627 + +[DateUnit](#dateunit) 627 + +[DCol](#dcol) 628 + +[DColByteU](#dcolbyteu) 628 + +[DConFile](#dconfile) 628 + +[DConnConnectionOleDb](#dconnconnectionoledb) 629 + +[DConnConnectionWeb](#dconnconnectionweb) 630 + +[DConnId](#dconnid) 630 + +[DConnParamBinding](#dconnparambinding) 631 + +[DConnParamBindingValByte](#dconnparambindingvalbyte) 631 + +[DConnParamBindingValInt](#dconnparambindingvalint) 631 + +[DConnParamBindingValString](#dconnparambindingvalstring) 631 + +[DConnParamBindingValType](#dconnparambindingvaltype) 632 + +[DConnParameter](#dconnparameter) 632 + +[DConnStringSequence](#dconnstringsequence) 633 + +[DConnUnicodeStringSegmented](#dconnunicodestringsegmented) 633 + +[DJoin](#djoin) 634 + +[DRw](#drw) 634 + +[DRwByteU](#drwbyteu) 634 + +[Duce](#duce) 634 + +[DuceRadical](#duceradical) 635 + +[DuceStacked](#ducestacked) 636 + +[Ducr](#ducr) 636 + +[DucrConditionalLbl](#ducrconditionallbl) 637 + +[DucrConditionalNoLbl](#ducrconditionalnolbl) 638 + +[DVParsedFormula](#dvparsedformula) 756 + +[DwQsiFuture](#dwqsifuture) 638 + +[DXFALC](#dxfalc) 639 + +[DXFBdr](#dxfbdr) 640 + +[DXFFntD](#dxffntd) 641 + +[DXFId](#dxfid) 642 + +[DXFN](#dxfn) 642 + +[DXFN12](#dxfn12) 645 + +[DXFN12List](#dxfn12list) 646 + +[DXFN12NoCB](#dxfn12nocb) 646 + +[DXFNum](#dxfnum) 646 + +[DXFNumIFmt](#dxfnumifmt) 647 + +[DXFNumUsr](#dxfnumusr) 647 + +[DXFPat](#dxfpat) 647 + +[DXFProt](#dxfprot) 648 + +[EnhancedProtection](#enhancedprotection) 648 + +[ExternDdeLinkNoOper](#externddelinknooper) 649 + +[ExternDocName](#externdocname) 649 + +[ExternOleDdeLink](#externoleddelink) 650 + +[ExtNameParsedFormula](#extnameparsedformula) 757 + +[ExtProp](#extprop) 650 + +[ExtPtgArea3D](#extptgarea3d) 758 + +[ExtPtgAreaErr3D](#extptgareaerr3d) 758 + +[ExtPtgErr](#extptgerr) 758 + +[ExtPtgRef3D](#extptgref3d) 759 + +[ExtPtgRefErr3D](#extptgreferr3d) 759 + +[ExtRst](#extrst) 651 + +[ExtSheetPair](#extsheetpair) 759 + +[FactoidData](#factoiddata) 652 + +[Feat11CellStruct](#feat11cellstruct) 652 + +[Feat11FdaAutoFilter](#feat11fdaautofilter) 652 + +[Feat11FieldDataItem](#feat11fielddataitem) 653 + +[Feat11Fmla](#feat11fmla) 660 + +[Feat11RgInvalidCells](#feat11rginvalidcells) 660 + +[Feat11RgSharepointIdChange](#feat11rgsharepointidchange) 660 + +[Feat11RgSharepointIdDel](#feat11rgsharepointiddel) 661 + +[Feat11TotalFmla](#feat11totalfmla) 661 + +[Feat11WSSListInfo](#feat11wsslistinfo) 661 + +[Feat11XMap](#feat11xmap) 664 + +[Feat11XMapEntry](#feat11xmapentry) 664 + +[Feat11XMapEntry2](#feat11xmapentry2) 665 + +[FeatFormulaErr2](#featformulaerr2) 665 + +[FeatProtection](#featprotection) 665 + +[FeatSmartTag](#featsmarttag) 666 + +[FFErrorCheck](#fferrorcheck) 667 + +[file structure](#file-structure) 57 + +[FillPattern](#fillpattern) 667 + +[FillStylePropertiesForShapePropsStreamChecksum](#fillstylepropertiesforshapepropsstreamchecksum) 668 + +[FontIndex](#fontindex) 678 + +[FontInfo](#fontinfo) 678 + +[FontScheme](#fontscheme) 679 + +[FormatRun](#formatrun) 679 + +[FormulaValue](#formulavalue) 679 + +[FrtFlags](#frtflags) 680 + +[FrtHeader](#frtheader) 681 + +[FrtHeaderOld](#frtheaderold) 681 + +[FrtRefHeader](#frtrefheader) 681 + +[FrtRefHeaderNoGrbit](#frtrefheadernogrbit) 682 + +[FrtRefHeaderU](#frtrefheaderu) 682 + +[Ftab](#ftab) 760 + +[FtCbls](#ftcbls) 683 + +[FtCblsData](#ftcblsdata) 683 + +[FtCf](#ftcf) 684 + +[FtCmo](#ftcmo) 684 + +[FtEdoData](#ftedodata) 687 + +[FtGboData](#ftgbodata) 688 + +[FtGmo](#ftgmo) 688 + +[FtLbsData](#ftlbsdata) 689 + +[FtMacro](#ftmacro) 691 + +[FtNts](#ftnts) 692 + +[FtPictFmla](#ftpictfmla) 692 + +[FtPioGrbit](#ftpiogrbit) 693 + +[FtRbo](#ftrbo) 695 + +[FtRboData](#ftrbodata) 695 + +[FtSbs](#ftsbs) 696 + +[FullColorExt](#fullcolorext) 697 + +[GradStop](#gradstop) 697 + +[HiddenMemberSet](#hiddenmemberset) 698 + +[HideObjEnum](#hideobjenum) 698 + +[HorizAlign](#horizalign) 699 + +[HorzBrk](#horzbrk) 699 + +[Icv](#icv) 699 + +[IcvChart](#icvchart) 703 + +[IcvFont](#icvfont) 703 + +[IcvXF](#icvxf) 703 + +[IFmt](#ifmt) 703 + +[Ilel](#ilel) 787 + +[InteriorColorPropertiesForShapePropsStreamChecksum](#interiorcolorpropertiesforshapepropsstreamchecksum) 704 + +[ISSTInf](#isstinf) 705 + +[IXFCell](#ixfcell) 705 + +[KPIProp](#kpiprop) 705 + +[KPISets](#kpisets) 706 + +[LbsDropData](#lbsdropdata) 706 + +[LEMMode](#lemmode) 707 + +[LinePropertiesForShapePropsStreamChecksum](#linepropertiesforshapepropsstreamchecksum) 708 + +[List12BlockLevel](#list12blocklevel) 709 + +[List12DisplayName](#list12displayname) 711 + +[List12TableStyleClientInfo](#list12tablestyleclientinfo) 712 + +[ListParsedArrayFormula](#listparsedarrayformula) 788 + +[ListParsedFormula](#listparsedformula) 788 + +[LongRGB](#longrgb) 712 + +[LongRGBA](#longrgba) 713 + +[LPWideString](#lpwidestring) 713 + +[MDir](#mdir) 713 + +[MDTInfoIndex](#mdtinfoindex) 714 + +[MDXStrIndex](#mdxstrindex) 714 + +[MOper](#moper) 714 + +[NameParsedFormula](#nameparsedformula) 788 + +[NilChartNum](#nilchartnum) 715 + +[NoteRR](#noterr) 715 + +[NoteSh](#notesh) 716 + +[ObjectParsedFormula](#objectparsedformula) 789 + +ObjFmla ([section 2.5.187](#objfmla) 717, [section 2.5.188](#objid) 718) + +[ObjLinkFmla](#objlinkfmla) 718 + +[ODBCType](#odbctype) 719 + +[OfficeArtClientAnchorChart](#officeartclientanchorchart) 719 + +[OfficeArtClientAnchorHF](#officeartclientanchorhf) 720 + +[OfficeArtClientAnchorSheet](#officeartclientanchorsheet) 721 + +[OfficeArtClientData](#officeartclientdata) 722 + +[OfficeArtClientTextbox](#officeartclienttextbox) 723 + +[PaneType](#panetype) 723 + +[ParameterParsedFormula](#parameterparsedformula) 789 + +[PARAMQRY_Fixed](#paramqry_fixed) 724 + +[PBT](#pbt) 833 + +[PhRuns](#phruns) 834 + +[Phs](#phs) 834 + +[PictFmlaEmbedInfo](#pictfmlaembedinfo) 835 + +[PictFmlaKey](#pictfmlakey) 835 + +[PivotCompProp](#pivotcompprop) 836 + +[PivotParsedFormula](#pivotparsedformula) 790 + +[PositionMode](#positionmode) 836 + +[Ptg](#ptg) 790 + +[PtgAdd](#ptgadd) 793 + +[PtgArea](#ptgarea) 793 + +[PtgArea3d](#ptgarea3d) 794 + +[PtgAreaErr](#ptgareaerr) 794 + +[PtgAreaErr3d](#ptgareaerr3d) 795 + +[PtgAreaN](#ptgarean) 795 + +[PtgArray](#ptgarray) 796 + +[PtgAttrBaxcel](#ptgattrbaxcel) 796 + +[PtgAttrChoose](#ptgattrchoose) 797 + +[PtgAttrGoto](#ptgattrgoto) 797 + +[PtgAttrIf](#ptgattrif) 798 + +[PtgAttrSemi](#ptgattrsemi) 798 + +[PtgAttrSpace](#ptgattrspace) 798 + +[PtgAttrSpaceSemi](#ptgattrspacesemi) 799 + +[PtgAttrSpaceType](#ptgattrspacetype) 799 + +[PtgAttrSum](#ptgattrsum) 800 + +[PtgBool](#ptgbool) 800 + +[PtgConcat](#ptgconcat) 800 + +[PtgDataType](#ptgdatatype) 800 + +[PtgDiv](#ptgdiv) 801 + +[PtgElfCol](#ptgelfcol) 801 + +[PtgElfColS](#ptgelfcols) 801 + +[PtgElfColSV](#ptgelfcolsv) 802 + +[PtgElfColV](#ptgelfcolv) 802 + +[PtgElfLel](#ptgelflel) 802 + +[PtgElfRadical](#ptgelfradical) 803 + +[PtgElfRadicalLel](#ptgelfradicallel) 803 + +[PtgElfRadicalS](#ptgelfradicals) 804 + +[PtgElfRw](#ptgelfrw) 804 + +[PtgElfRwV](#ptgelfrwv) 805 + +[PtgEq](#ptgeq) 805 + +[PtgErr](#ptgerr) 805 + +[PtgExp](#ptgexp) 805 + +[PtgExtraArray](#ptgextraarray) 806 + +[PtgExtraElf](#ptgextraelf) 806 + +[PtgExtraMem](#ptgextramem) 807 + +[PtgFunc](#ptgfunc) 807 + +[PtgFuncVar](#ptgfuncvar) 807 + +[PtgGe](#ptgge) 808 + +[PtgGt](#ptggt) 808 + +[PtgInt](#ptgint) 808 + +[PtgIsect](#ptgisect) 809 + +[PtgLe](#ptgle) 809 + +[PtgLt](#ptglt) 809 + +[PtgMemArea](#ptgmemarea) 809 + +[PtgMemErr](#ptgmemerr) 810 + +[PtgMemFunc](#ptgmemfunc) 810 + +[PtgMemNoMem](#ptgmemnomem) 811 + +[PtgMissArg](#ptgmissarg) 811 + +[PtgMul](#ptgmul) 811 + +[PtgName](#ptgname) 812 + +[PtgNameX](#ptgnamex) 812 + +[PtgNe](#ptgne) 813 + +[PtgNum](#ptgnum) 813 + +[PtgParen](#ptgparen) 813 + +[PtgPercent](#ptgpercent) 814 + +[PtgPower](#ptgpower) 814 + +[PtgRange](#ptgrange) 814 + +[PtgRef](#ptgref) 814 + +[PtgRef3d](#ptgref3d) 815 + +[PtgRefErr](#ptgreferr) 815 + +[PtgRefErr3d](#ptgreferr3d) 816 + +[PtgRefN](#ptgrefn) 816 + +[PtgStr](#ptgstr) 816 + +[PtgSub](#ptgsub) 817 + +[PtgSxName](#ptgsxname) 817 + +[PtgTbl](#ptgtbl) 817 + +[PtgUminus](#ptguminus) 818 + +[PtgUnion](#ptgunion) 818 + +[PtgUplus](#ptguplus) 818 + +[ReadingOrder](#readingorder) 836 + +[record enumeration](#record-enumeration) 169 + +[Ref](#ref) 837 + +[Ref8](#ref8) 837 + +[Ref8U](#ref8u) 838 + +[Ref8U2007](#ref8u2007) 838 + +[RefU](#refu) 839 + +[RevExtern](#revextern) 819 + +[RevisionType](#revisiontype) 839 + +[RevItab](#revitab) 819 + +[RevLblName](#revlblname) 820 + +[RevName](#revname) 821 + +[RevNamePly](#revnameply) 822 + +[RevNameTabid](#revnametabid) 822 + +[RevSheetName](#revsheetname) 822 + +[RFX](#rfx) 840 + +[RgbExtra](#rgbextra) 823 + +[Rgce](#rgce) 824 + +[RgceArea](#rgcearea) 827 + +[RgceAreaRel](#rgcearearel) 828 + +[RgceElfLoc](#rgceelfloc) 828 + +[RgceElfLocExtra](#rgceelflocextra) 829 + +[RgceLoc](#rgceloc) 829 + +[RgceLoc8](#rgceloc8) 829 + +[RgceLocRel](#rgcelocrel) 829 + +[RichTextStreamChecksumData](#richtextstreamchecksumdata) 840 + +[RichTextStreamChecksumFontInformation](#richtextstreamchecksumfontinformation) 842 + +[RichTextStreamChecksumFontInformationArrayItem](#richtextstreamchecksumfontinformationarrayitem) 844 + +[RkNumber](#rknumber) 844 + +[RkRec](#rkrec) 845 + +[RPHSSub](#rphssub) 845 + +[RRD](#rrd) 846 + +[RRDDefNameFlags](#rrddefnameflags) 846 + +[RRLoc](#rrloc) 848 + +[RTDEItem](#rtdeitem) 848 + +[RTDOper](#rtdoper) 848 + +[RTDOperStr](#rtdoperstr) 849 + +[Run](#run) 849 + +[Rw](#rw) 849 + +[Rw12](#rw12) 850 + +[RwLongU](#rwlongu) 850 + +[RwU](#rwu) 850 + +[Rwx](#rwx) 850 + +[Script](#script) 851 + +[SD_SetSortOrder](#sd_setsortorder) 851 + +[SDContainer](#sdcontainer) 851 + +[SecurityDescriptor](#securitydescriptor) 852 + +[SerAr](#serar) 830 + +[SerBool](#serbool) 830 + +[SerErr](#sererr) 831 + +[SerNil](#sernil) 831 + +[SerNum](#sernum) 831 + +[SerStr](#serstr) 832 + +[ShapePropsStreamChecksumData](#shapepropsstreamchecksumdata) 852 + +[SharedFeatureType](#sharedfeaturetype) 853 + +[SharedParsedFormula](#sharedparsedformula) 832 + +[SheetExtOptional](#sheetextoptional) 854 + +[ShortDTR](#shortdtr) 855 + +[ShortXLUnicodeString](#shortxlunicodestring) 855 + +[SLCO8](#slco8) 856 + +[SortCond12](#sortcond12) 856 + +[SortItem](#sortitem) 857 + +[SourceType](#sourcetype) 858 + +[SQElfFlags](#sqelfflags) 858 + +[SqRef](#sqref) 858 + +[SqRefU](#sqrefu) 859 + +[Stxp](#stxp) 859 + +[StyleXF](#stylexf) 860 + +[SxAddl_SXDEnd](#sxaddl_sxdend) 862 + +[SxAddl_SXDVerUpdInv](#sxaddl_sxdverupdinv) 862 + +[SxAddl_SXString](#sxaddl_sxstring) 862 + +[SXAddlHdr](#sxaddlhdr) 863 + +[SXAxis](#sxaxis) 863 + +[SXEZDoper](#sxezdoper) 863 + +[SxFT](#sxft) 864 + +[SxIvdCol](#sxivdcol) 868 + +[SxIvdRw](#sxivdrw) 868 + +[SXLIItem](#sxliitem) 868 + +[SXPI_Item](#sxpi_item) 871 + +[SXVDEx_Opt](#sxvdex_opt) 871 + +[SxView9Save](#sxview9save) 872 + +[SXVIFlags](#sxviflags) 872 + +[TabId](#tabid) 873 + +[TabIndex](#tabindex) 873 + +[TableFeatureType](#tablefeaturetype) 873 + +[Tag_Fn_MDX](#tag_fn_mdx) 877 + +[TextPropsStreamChecksumData](#textpropsstreamchecksumdata) 878 + +[Top10FT](#top10ft) 880 + +[Ts](#ts) 880 + +[TxOLastRun](#txolastrun) 880 + +[TxORuns](#txoruns) 881 + +[TxtWf](#txtwf) 881 + +[Underline](#underline) 882 + +[VertAlign](#vertalign) 882 + +[VertBrk](#vertbrk) 882 + +[VirtualPath](#virtualpath) 882 + +[WebPubString](#webpubstring) 884 + +[XColorType](#xcolortype) 885 + +[XFExtGradient](#xfextgradient) 885 + +[XFExtNoFRT](#xfextnofrt) 886 + +[XFIndex](#xfindex) 886 + +[XFProp](#xfprop) 888 + +[XFPropBorder](#xfpropborder) 890 + +[XFPropColor](#xfpropcolor) 890 + +[XFPropGradient](#xfpropgradient) 891 + +[XFPropGradientStop](#xfpropgradientstop) 892 + +[XFProps](#xfprops) 892 + +[XFPropTextRotation](#xfproptextrotation) 893 + +[XLNameUnicodeString](#xlnameunicodestring) 893 + +[XlsFilter_Criteria](#xlsfilter_criteria) 894 + +[XlsFilter_Top10](#xlsfilter_top10) 895 + +[XLUnicodeRichExtendedString](#xlunicoderichextendedstring) 896 + +[XLUnicodeString](#xlunicodestring) 897 + +[XLUnicodeStringMin2](#xlunicodestringmin2) 898 + +[XLUnicodeStringNoCch](#xlunicodestringnocch) 898 + +[XLUnicodeStringSegmented](#xlunicodestringsegmented) 898 + +[XLUnicodeStringSegmentedRTD](#xlunicodestringsegmentedrtd) 899 + +[XLUnicodeStringSegmentedSXAddl](#xlunicodestringsegmentedsxaddl) 899 + +[XmlTkBackWallThicknessFrt](#xmltkbackwallthicknessfrt) 900 + +[XmlTkBaseTimeUnitFrt](#xmltkbasetimeunitfrt) 900 + +[XmlTkBlob](#xmltkblob) 901 + +[XmlTkBool](#xmltkbool) 901 + +[XmlTkChain](#xmltkchain) 902 + +[XmlTkColorMappingOverride](#xmltkcolormappingoverride) 904 + +[XmlTkDispBlanksAsFrt](#xmltkdispblanksasfrt) 904 + +[XmlTkDouble](#xmltkdouble) 905 + +[XmlTkDWord](#xmltkdword) 905 + +[XmlTkEnd](#xmltkend) 906 + +[XmlTkEndSurface](#xmltkendsurface) 906 + +[XmlTkFloorThicknessFrt](#xmltkfloorthicknessfrt) 906 + +[XmlTkFormatCodeFrt](#xmltkformatcodefrt) 907 + +[XmlTkHeader](#xmltkheader) 907 + +[XmlTkHeightPercent](#xmltkheightpercent) 907 + +[XmlTkLogBaseFrt](#xmltklogbasefrt) 908 + +[XmlTkMajorUnitFrt](#xmltkmajorunitfrt) 908 + +[XmlTkMajorUnitTypeFrt](#xmltkmajorunittypefrt) 908 + +[XmlTkMaxFrt](#xmltkmaxfrt) 909 + +[XmlTkMinFrt](#xmltkminfrt) 909 + +[XmlTkMinorUnitFrt](#xmltkminorunitfrt) 910 + +[XmlTkMinorUnitTypeFrt](#xmltkminorunittypefrt) 910 + +[XmlTkNoMultiLvlLbl](#xmltknomultilvllbl) 911 + +[XmlTkOverlay](#xmltkoverlay) 911 + +[XmlTkPerspectiveFrt](#xmltkperspectivefrt) 912 + +[XmlTkPieComboFrom12Frt](#xmltkpiecombofrom12frt) 912 + +[XmlTkRAngAxOffFrt](#xmltkrangaxofffrt) 912 + +[XmlTkRotXFrt](#xmltkrotxfrt) 913 + +[XmlTkRotYFrt](#xmltkrotyfrt) 913 + +[XmlTkShowDLblsOverMax](#xmltkshowdlblsovermax) 913 + +[XmlTkSpb](#xmltkspb) 914 + +[XmlTkStart](#xmltkstart) 914 + +[XmlTkStartSurface](#xmltkstartsurface) 914 + +[XmlTkString](#xmltkstring) 915 + +[XmlTkStyle](#xmltkstyle) 915 + +[XmlTkSymbolFrt](#xmltksymbolfrt) 915 + +[XmlTkThemeOverride](#xmltkthemeoverride) 916 + +[XmlTkTickLabelPositionFrt](#xmltkticklabelpositionfrt) 916 + +[XmlTkTickLabelSkipFrt](#xmltkticklabelskipfrt) 917 + +[XmlTkTickMarkSkipFrt](#xmltktickmarkskipfrt) 917 + +[XmlTkToken](#xmltktoken) 917 + +[XmlTkTpb](#xmltktpb) 918 + +[Xnum](#xnum) 918 + +[XORObfuscation](#xorobfuscation) 918 + +[XTI](#xti) 918 + +[XtiIndex](#xtiindex) 833 + +[Stxp](#stxp) 859 + +[Style](#style) 427 + +[StyleExt](#styleext) 428 + +[Styles](#styles) 158 + +[differential formatting (DXFs)](#differential-formatting-dxfs) 159 + +[format conflicts](#format-conflicts) 160 + +[table styles](#table-styles) 160 + +[XFs](#xfs) 158 + +[StyleXF](#stylexf) 860 + +[Substream](#substream) 57 + +[Summary information stream](#summary-information-stream-005summaryinformation) 67 + +[SupBook](#supbook) 429 + +[Supporting link](#supporting-link) 161 + +[Surf](#surf) 431 + +[SXAddl](#sxaddl) 432 + +SxAddl records ([section 2.4.273.29](#sxaddl_sxcfield12_sxdend) 444, [section 2.4.273.86](#sxaddl_sxcsxfilter12_sxdxlsfilter) 476) + +[Continue_SxaddlSxString](#continue_sxaddlsxstring) 432 + +[SXAddl](#sxaddl) 432 + +[SXAddl_SXCAutoSort_SXDEnd](#sxaddl_sxcautosort_sxdend) 433 + +[SXAddl_SXCAutoSort_SXDId](#sxaddl_sxcautosort_sxdid) 433 + +[SXAddl_SXCCache_SXDEnd](#sxaddl_sxccache_sxdend) 434 + +[SXAddl_SXCCache_SXDId](#sxaddl_sxccache_sxdid) 434 + +[SXAddl_SXCCache_SXDInfo12](#sxaddl_sxccache_sxdinfo12) 434 + +[SXAddl_SXCCache_SXDInvRefreshReal](#sxaddl_sxccache_sxdinvrefreshreal) 435 + +[SXAddl_SXCCache_SXDVer10Info](#sxaddl_sxccache_sxdver10info) 435 + +[SXAddl_SXCCache_SXDVerSXMacro](#sxaddl_sxccache_sxdversxmacro) 436 + +[SXAddl_SXCCache_SXDVerUpdInv](#sxaddl_sxccache_sxdverupdinv) 437 + +[SXAddl_SXCCacheField_SXDCaption](#sxaddl_sxccachefield_sxdcaption) 437 + +[SXAddl_SXCCacheField_SXDEnd](#sxaddl_sxccachefield_sxdend) 437 + +[SXAddl_SXCCacheField_SXDId](#sxaddl_sxccachefield_sxdid) 438 + +[SXAddl_SXCCacheField_SXDIfdbMempropMap](#sxaddl_sxccachefield_sxdifdbmempropmap) 438 + +[SXAddl_SXCCacheField_SXDIfdbMpMapCount](#sxaddl_sxccachefield_sxdifdbmpmapcount) 439 + +[SXAddl_SXCCacheField_SXDProperty](#sxaddl_sxccachefield_sxdproperty) 439 + +[SXAddl_SXCCacheField_SXDPropName](#sxaddl_sxccachefield_sxdpropname) 440 + +[SXAddl_SXCCacheField_SXDSxrmitmCount](#sxaddl_sxccachefield_sxdsxrmitmcount) 440 + +[SXAddl_SXCCacheItem_SXDEnd](#sxaddl_sxccacheitem_sxdend) 441 + +[SXAddl_SXCCacheItem_SXDId](#sxaddl_sxccacheitem_sxdid) 441 + +[SXAddl_SXCCacheItem_SXDItmMpMapCount](#sxaddl_sxccacheitem_sxditmmpmapcount) 441 + +[SXAddl_SXCCacheItem_SXDItmMpropMap](#sxaddl_sxccacheitem_sxditmmpropmap) 442 + +[SXAddl_SXCCacheItem_SXDSxrmitmDisp](#sxaddl_sxccacheitem_sxdsxrmitmdisp) 442 + +[SXAddl_SXCField_SXDEnd](#sxaddl_sxcfield_sxdend) 443 + +[SXAddl_SXCField_SXDId](#sxaddl_sxcfield_sxdid) 443 + +[SXAddl_SXCField_SXDVer10Info](#sxaddl_sxcfield_sxdver10info) 443 + +[SXAddl_SXCField12_SXDAutoshow](#sxaddl_sxcfield12_sxdautoshow) 444 + +[SXAddl_SXCField12_SXDId](#sxaddl_sxcfield12_sxdid) 445 + +[SXAddl_SXCField12_SXDISXTH](#sxaddl_sxcfield12_sxdisxth) 445 + +[SXAddl_SXCField12_SXDMemberCaption](#sxaddl_sxcfield12_sxdmembercaption) 446 + +[SXAddl_SXCField12_SXDVer12Info](#sxaddl_sxcfield12_sxdver12info) 446 + +[SXAddl_SXCField12_SXDVerUpdInv](#sxaddl_sxcfield12_sxdverupdinv) 447 + +[SXAddl_SXCGroup_SXDEnd](#sxaddl_sxcgroup_sxdend) 447 + +[SXAddl_SXCGroup_SXDGrpInfo](#sxaddl_sxcgroup_sxdgrpinfo) 448 + +[SXAddl_SXCGroup_SXDId](#sxaddl_sxcgroup_sxdid) 449 + +[SXAddl_SXCGroup_SXDMember](#sxaddl_sxcgroup_sxdmember) 449 + +[SXAddl_SXCGrpLevel_SXDEnd](#sxaddl_sxcgrplevel_sxdend) 450 + +[SXAddl_SXCGrpLevel_SXDGrpLevelInfo](#sxaddl_sxcgrplevel_sxdgrplevelinfo) 450 + +[SXAddl_SXCGrpLevel_SXDId](#sxaddl_sxcgrplevel_sxdid) 451 + +[SXAddl_SXCHierarchy_SXDDisplayFolder](#sxaddl_sxchierarchy_sxddisplayfolder) 451 + +[SXAddl_SXCHierarchy_SXDEnd](#sxaddl_sxchierarchy_sxdend) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember](#sxaddl_sxchierarchy_sxdfiltermember) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember12](#sxaddl_sxchierarchy_sxdfiltermember12) 453 + +[SXAddl_SXCHierarchy_SXDIconSet](#sxaddl_sxchierarchy_sxdiconset) 454 + +[SXAddl_SXCHierarchy_SXDId](#sxaddl_sxchierarchy_sxdid) 454 + +[SXAddl_SXCHierarchy_SXDInfo12](#sxaddl_sxchierarchy_sxdinfo12) 455 + +[SXAddl_SXCHierarchy_SXDKPIGoal](#sxaddl_sxchierarchy_sxdkpigoal) 456 + +[SXAddl_SXCHierarchy_SXDKPIStatus](#sxaddl_sxchierarchy_sxdkpistatus) 456 + +[SXAddl_SXCHierarchy_SXDKPITime](#sxaddl_sxchierarchy_sxdkpitime) 456 + +[SXAddl_SXCHierarchy_SXDKPITrend](#sxaddl_sxchierarchy_sxdkpitrend) 457 + +[SXAddl_SXCHierarchy_SXDKPIValue](#sxaddl_sxchierarchy_sxdkpivalue) 457 + +[SXAddl_SXCHierarchy_SXDKPIWeight](#sxaddl_sxchierarchy_sxdkpiweight) 458 + +[SXAddl_SXCHierarchy_SXDMeasureGrp](#sxaddl_sxchierarchy_sxdmeasuregrp) 458 + +[SXAddl_SXCHierarchy_SXDParentKPI](#sxaddl_sxchierarchy_sxdparentkpi) 459 + +[SXAddl_SXCHierarchy_SXDProperty](#sxaddl_sxchierarchy_sxdproperty) 459 + +[SXAddl_SXCHierarchy_SXDSXSetParentUnique](#sxaddl_sxchierarchy_sxdsxsetparentunique) 461 + +[SXAddl_SXCHierarchy_SXDUserCaption](#sxaddl_sxchierarchy_sxdusercaption) 461 + +[SXAddl_SXCHierarchy_SXDVerUpdInv](#sxaddl_sxchierarchy_sxdverupdinv) 461 + +[SXAddl_SXCQsi_SXDEnd](#sxaddl_sxcqsi_sxdend) 462 + +[SXAddl_SXCQsi_SXDId](#sxaddl_sxcqsi_sxdid) 462 + +[SXAddl_SXCQuery_SXDEnd](#sxaddl_sxcquery_sxdend) 462 + +[SXAddl_SXCQuery_SXDReconnCond](#sxaddl_sxcquery_sxdreconncond) 463 + +[SXAddl_SXCQuery_SXDSrcConnFile](#sxaddl_sxcquery_sxdsrcconnfile) 464 + +[SXAddl_SXCQuery_SXDSrcDataFile](#sxaddl_sxcquery_sxdsrcdatafile) 464 + +[SXAddl_SXCQuery_SXDXMLSource](#sxaddl_sxcquery_sxdxmlsource) 464 + +[SXAddl_SXCSXCondFmt_SXDEnd](#sxaddl_sxcsxcondfmt_sxdend) 465 + +[SXAddl_SXCSXCondFmt_SXDSXCondFmt](#sxaddl_sxcsxcondfmt_sxdsxcondfmt) 465 + +[SXAddl_SXCSXCondFmts_SXDEnd](#sxaddl_sxcsxcondfmts_sxdend) 466 + +[SXAddl_SXCSXCondFmts_SXDId](#sxaddl_sxcsxcondfmts_sxdid) 467 + +[SXAddl_SXCSXDH_SXDEnd](#sxaddl_sxcsxdh_sxdend) 467 + +[SXAddl_SXCSXDH_SXDId](#sxaddl_sxcsxdh_sxdid) 468 + +[SXAddl_SXCSXDH_SXDSxdh](#sxaddl_sxcsxdh_sxdsxdh) 468 + +[SXAddl_SXCSXfilt_SXDEnd](#sxaddl_sxcsxfilt_sxdend) 469 + +[SXAddl_SXCSXfilt_SXDId](#sxaddl_sxcsxfilt_sxdid) 470 + +[SXAddl_SXCSXfilt_SXDSXfilt](#sxaddl_sxcsxfilt_sxdsxfilt) 470 + +[SXAddl_SXCSXfilt_SXDSXItm](#sxaddl_sxcsxfilt_sxdsxitm) 471 + +[SXAddl_SXCSXFilter12_SXDCaption](#sxaddl_sxcsxfilter12_sxdcaption) 472 + +[SXAddl_SXCSXFilter12_SXDEnd](#sxaddl_sxcsxfilter12_sxdend) 473 + +[SXAddl_SXCSXFilter12_SXDId](#sxaddl_sxcsxfilter12_sxdid) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilter](#sxaddl_sxcsxfilter12_sxdsxfilter) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilterDesc](#sxaddl_sxcsxfilter12_sxdsxfilterdesc) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue1](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue2](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2) 475 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue1](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1) 476 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue2](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2) 477 + +[SXAddl_SXCSXFilters12_SXDEnd](#sxaddl_sxcsxfilters12_sxdend) 477 + +[SXAddl_SXCSXFilters12_SXDId](#sxaddl_sxcsxfilters12_sxdid) 478 + +[SXAddl_SXCSXMg_SXDEnd](#sxaddl_sxcsxmg_sxdend) 478 + +[SXAddl_SXCSXMg_SXDId](#sxaddl_sxcsxmg_sxdid) 478 + +[SXAddl_SXCSXMg_SXDUserCaption](#sxaddl_sxcsxmg_sxdusercaption) 479 + +[SXAddl_SXCSXMgs_SXDEnd](#sxaddl_sxcsxmgs_sxdend) 479 + +[SXAddl_SXCSXMgs_SXDId](#sxaddl_sxcsxmgs_sxdid) 479 + +[SXAddl_SXCSXMgs_SXDMGrpSXDHMap](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap) 480 + +[SXAddl_SXCSXrule_SXDEnd](#sxaddl_sxcsxrule_sxdend) 481 + +[SXAddl_SXCSXrule_SXDId](#sxaddl_sxcsxrule_sxdid) 481 + +[SXAddl_SXCSXrule_SXDSXrule](#sxaddl_sxcsxrule_sxdsxrule) 481 + +[SXAddl_SXCView_SXDCalcMember](#sxaddl_sxcview_sxdcalcmember) 484 + +[SXAddl_SXCView_SXDCalcMemString](#sxaddl_sxcview_sxdcalcmemstring) 486 + +[SXAddl_SXCView_SXDCompactColHdr](#sxaddl_sxcview_sxdcompactcolhdr) 486 + +[SXAddl_SXCView_SXDCompactRwHdr](#sxaddl_sxcview_sxdcompactrwhdr) 487 + +[SXAddl_SXCView_SXDEnd](#sxaddl_sxcview_sxdend) 487 + +[SXAddl_SXCView_SXDId](#sxaddl_sxcview_sxdid) 488 + +[SXAddl_SXCView_SXDSXPIIvmb](#sxaddl_sxcview_sxdsxpiivmb) 488 + +[SXAddl_SXCView_SXDTableStyleClient](#sxaddl_sxcview_sxdtablestyleclient) 489 + +[SXAddl_SXCView_SXDVer10Info](#sxaddl_sxcview_sxdver10info) 489 + +[SXAddl_SXCView_SXDVer12Info](#sxaddl_sxcview_sxdver12info) 491 + +[SXAddl_SXCView_SXDVerUpdInv](#sxaddl_sxcview_sxdverupdinv) 493 + +[SXAddl_SXCAutoSort_SXDEnd](#sxaddl_sxcautosort_sxdend) 433 + +[SXAddl_SXCAutoSort_SXDId](#sxaddl_sxcautosort_sxdid) 433 + +[SXAddl_SXCCache_SXDEnd](#sxaddl_sxccache_sxdend) 434 + +[SXAddl_SXCCache_SXDId](#sxaddl_sxccache_sxdid) 434 + +[SXAddl_SXCCache_SXDInfo12](#sxaddl_sxccache_sxdinfo12) 434 + +[SXAddl_SXCCache_SXDInvRefreshReal](#sxaddl_sxccache_sxdinvrefreshreal) 435 + +[SXAddl_SXCCache_SXDVer10Info](#sxaddl_sxccache_sxdver10info) 435 + +[SXAddl_SXCCache_SXDVerSXMacro](#sxaddl_sxccache_sxdversxmacro) 436 + +[SXAddl_SXCCache_SXDVerUpdInv](#sxaddl_sxccache_sxdverupdinv) 437 + +[SXAddl_SXCCacheField_SXDCaption](#sxaddl_sxccachefield_sxdcaption) 437 + +[SXAddl_SXCCacheField_SXDEnd](#sxaddl_sxccachefield_sxdend) 437 + +[SXAddl_SXCCacheField_SXDId](#sxaddl_sxccachefield_sxdid) 438 + +[SXAddl_SXCCacheField_SXDIfdbMempropMap](#sxaddl_sxccachefield_sxdifdbmempropmap) 438 + +[SXAddl_SXCCacheField_SXDIfdbMpMapCount](#sxaddl_sxccachefield_sxdifdbmpmapcount) 439 + +[SXAddl_SXCCacheField_SXDProperty](#sxaddl_sxccachefield_sxdproperty) 439 + +[SXAddl_SXCCacheField_SXDPropName](#sxaddl_sxccachefield_sxdpropname) 440 + +[SXAddl_SXCCacheField_SXDSxrmitmCount](#sxaddl_sxccachefield_sxdsxrmitmcount) 440 + +[SXAddl_SXCCacheItem_SXDEnd](#sxaddl_sxccacheitem_sxdend) 441 + +[SXAddl_SXCCacheItem_SXDId](#sxaddl_sxccacheitem_sxdid) 441 + +[SXAddl_SXCCacheItem_SXDItmMpMapCount](#sxaddl_sxccacheitem_sxditmmpmapcount) 441 + +[SXAddl_SXCCacheItem_SXDItmMpropMap](#sxaddl_sxccacheitem_sxditmmpropmap) 442 + +[SXAddl_SXCCacheItem_SXDSxrmitmDisp](#sxaddl_sxccacheitem_sxdsxrmitmdisp) 442 + +[SXAddl_SXCField_SXDEnd](#sxaddl_sxcfield_sxdend) 443 + +[SXAddl_SXCField_SXDId](#sxaddl_sxcfield_sxdid) 443 + +[SXAddl_SXCField_SXDVer10Info](#sxaddl_sxcfield_sxdver10info) 443 + +[SXAddl_SXCField12_SXDAutoshow](#sxaddl_sxcfield12_sxdautoshow) 444 + +[SXAddl_SXCField12_SXDEnd](#sxaddl_sxcfield12_sxdend) 444 + +[SXAddl_SXCField12_SXDId](#sxaddl_sxcfield12_sxdid) 445 + +[SXAddl_SXCField12_SXDISXTH](#sxaddl_sxcfield12_sxdisxth) 445 + +[SXAddl_SXCField12_SXDMemberCaption](#sxaddl_sxcfield12_sxdmembercaption) 446 + +[SXAddl_SXCField12_SXDVer12Info](#sxaddl_sxcfield12_sxdver12info) 446 + +[SXAddl_SXCField12_SXDVerUpdInv](#sxaddl_sxcfield12_sxdverupdinv) 447 + +[SXAddl_SXCGroup_SXDEnd](#sxaddl_sxcgroup_sxdend) 447 + +[SXAddl_SXCGroup_SXDGrpInfo](#sxaddl_sxcgroup_sxdgrpinfo) 448 + +[SXAddl_SXCGroup_SXDId](#sxaddl_sxcgroup_sxdid) 449 + +[SXAddl_SXCGroup_SXDMember](#sxaddl_sxcgroup_sxdmember) 449 + +[SXAddl_SXCGrpLevel_SXDEnd](#sxaddl_sxcgrplevel_sxdend) 450 + +[SXAddl_SXCGrpLevel_SXDGrpLevelInfo](#sxaddl_sxcgrplevel_sxdgrplevelinfo) 450 + +[SXAddl_SXCGrpLevel_SXDId](#sxaddl_sxcgrplevel_sxdid) 451 + +[SXAddl_SXCHierarchy_SXDDisplayFolder](#sxaddl_sxchierarchy_sxddisplayfolder) 451 + +[SXAddl_SXCHierarchy_SXDEnd](#sxaddl_sxchierarchy_sxdend) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember](#sxaddl_sxchierarchy_sxdfiltermember) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember12](#sxaddl_sxchierarchy_sxdfiltermember12) 453 + +[SXAddl_SXCHierarchy_SXDIconSet](#sxaddl_sxchierarchy_sxdiconset) 454 + +[SXAddl_SXCHierarchy_SXDId](#sxaddl_sxchierarchy_sxdid) 454 + +[SXAddl_SXCHierarchy_SXDInfo12](#sxaddl_sxchierarchy_sxdinfo12) 455 + +[SXAddl_SXCHierarchy_SXDKPIGoal](#sxaddl_sxchierarchy_sxdkpigoal) 456 + +[SXAddl_SXCHierarchy_SXDKPIStatus](#sxaddl_sxchierarchy_sxdkpistatus) 456 + +[SXAddl_SXCHierarchy_SXDKPITime](#sxaddl_sxchierarchy_sxdkpitime) 456 + +[SXAddl_SXCHierarchy_SXDKPITrend](#sxaddl_sxchierarchy_sxdkpitrend) 457 + +[SXAddl_SXCHierarchy_SXDKPIValue](#sxaddl_sxchierarchy_sxdkpivalue) 457 + +[SXAddl_SXCHierarchy_SXDKPIWeight](#sxaddl_sxchierarchy_sxdkpiweight) 458 + +[SXAddl_SXCHierarchy_SXDMeasureGrp](#sxaddl_sxchierarchy_sxdmeasuregrp) 458 + +[SXAddl_SXCHierarchy_SXDParentKPI](#sxaddl_sxchierarchy_sxdparentkpi) 459 + +[SXAddl_SXCHierarchy_SXDProperty](#sxaddl_sxchierarchy_sxdproperty) 459 + +[SXAddl_SXCHierarchy_SXDSXSetParentUnique](#sxaddl_sxchierarchy_sxdsxsetparentunique) 461 + +[SXAddl_SXCHierarchy_SXDUserCaption](#sxaddl_sxchierarchy_sxdusercaption) 461 + +[SXAddl_SXCHierarchy_SXDVerUpdInv](#sxaddl_sxchierarchy_sxdverupdinv) 461 + +[SXAddl_SXCQsi_SXDEnd](#sxaddl_sxcqsi_sxdend) 462 + +[SXAddl_SXCQsi_SXDId](#sxaddl_sxcqsi_sxdid) 462 + +[SXAddl_SXCQuery_SXDEnd](#sxaddl_sxcquery_sxdend) 462 + +[SXAddl_SXCQuery_SXDReconnCond](#sxaddl_sxcquery_sxdreconncond) 463 + +[SXAddl_SXCQuery_SXDSrcConnFile](#sxaddl_sxcquery_sxdsrcconnfile) 464 + +[SXAddl_SXCQuery_SXDSrcDataFile](#sxaddl_sxcquery_sxdsrcdatafile) 464 + +[SXAddl_SXCQuery_SXDXMLSource](#sxaddl_sxcquery_sxdxmlsource) 464 + +[SXAddl_SXCSXCondFmt_SXDEnd](#sxaddl_sxcsxcondfmt_sxdend) 465 + +[SXAddl_SXCSXCondFmt_SXDSXCondFmt](#sxaddl_sxcsxcondfmt_sxdsxcondfmt) 465 + +[SXAddl_SXCSXCondFmts_SXDEnd](#sxaddl_sxcsxcondfmts_sxdend) 466 + +[SXAddl_SXCSXCondFmts_SXDId](#sxaddl_sxcsxcondfmts_sxdid) 467 + +[SXAddl_SXCSXDH_SXDEnd](#sxaddl_sxcsxdh_sxdend) 467 + +[SXAddl_SXCSXDH_SXDId](#sxaddl_sxcsxdh_sxdid) 468 + +[SXAddl_SXCSXDH_SXDSxdh](#sxaddl_sxcsxdh_sxdsxdh) 468 + +[SXAddl_SXCSXfilt_SXDEnd](#sxaddl_sxcsxfilt_sxdend) 469 + +[SXAddl_SXCSXfilt_SXDId](#sxaddl_sxcsxfilt_sxdid) 470 + +[SXAddl_SXCSXfilt_SXDSXfilt](#sxaddl_sxcsxfilt_sxdsxfilt) 470 + +[SXAddl_SXCSXfilt_SXDSXItm](#sxaddl_sxcsxfilt_sxdsxitm) 471 + +[SXAddl_SXCSXFilter12_SXDCaption](#sxaddl_sxcsxfilter12_sxdcaption) 472 + +[SXAddl_SXCSXFilter12_SXDEnd](#sxaddl_sxcsxfilter12_sxdend) 473 + +[SXAddl_SXCSXFilter12_SXDId](#sxaddl_sxcsxfilter12_sxdid) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilter](#sxaddl_sxcsxfilter12_sxdsxfilter) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilterDesc](#sxaddl_sxcsxfilter12_sxdsxfilterdesc) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue1](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue2](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2) 475 + +[SXAddl_SXCSXFilter12_SXDXlsFilter](#sxaddl_sxcsxfilter12_sxdxlsfilter) 476 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue1](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1) 476 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue2](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2) 477 + +[SXAddl_SXCSXFilters12_SXDEnd](#sxaddl_sxcsxfilters12_sxdend) 477 + +[SXAddl_SXCSXFilters12_SXDId](#sxaddl_sxcsxfilters12_sxdid) 478 + +[SXAddl_SXCSXMg_SXDEnd](#sxaddl_sxcsxmg_sxdend) 478 + +[SXAddl_SXCSXMg_SXDId](#sxaddl_sxcsxmg_sxdid) 478 + +[SXAddl_SXCSXMg_SXDUserCaption](#sxaddl_sxcsxmg_sxdusercaption) 479 + +[SXAddl_SXCSXMgs_SXDEnd](#sxaddl_sxcsxmgs_sxdend) 479 + +[SXAddl_SXCSXMgs_SXDId](#sxaddl_sxcsxmgs_sxdid) 479 + +[SXAddl_SXCSXMgs_SXDMGrpSXDHMap](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap) 480 + +[SXAddl_SXCSXrule_SXDEnd](#sxaddl_sxcsxrule_sxdend) 481 + +[SXAddl_SXCSXrule_SXDId](#sxaddl_sxcsxrule_sxdid) 481 + +[SXAddl_SXCSXrule_SXDSXrule](#sxaddl_sxcsxrule_sxdsxrule) 481 + +[SXAddl_SXCView_SXDCalcMember](#sxaddl_sxcview_sxdcalcmember) 484 + +[SXAddl_SXCView_SXDCalcMemString](#sxaddl_sxcview_sxdcalcmemstring) 486 + +[SXAddl_SXCView_SXDCompactColHdr](#sxaddl_sxcview_sxdcompactcolhdr) 486 + +[SXAddl_SXCView_SXDCompactRwHdr](#sxaddl_sxcview_sxdcompactrwhdr) 487 + +[SXAddl_SXCView_SXDEnd](#sxaddl_sxcview_sxdend) 487 + +[SXAddl_SXCView_SXDId](#sxaddl_sxcview_sxdid) 488 + +[SXAddl_SXCView_SXDSXPIIvmb](#sxaddl_sxcview_sxdsxpiivmb) 488 + +[SXAddl_SXCView_SXDTableStyleClient](#sxaddl_sxcview_sxdtablestyleclient) 489 + +[SXAddl_SXCView_SXDVer10Info](#sxaddl_sxcview_sxdver10info) 489 + +[SXAddl_SXCView_SXDVer12Info](#sxaddl_sxcview_sxdver12info) 491 + +[SXAddl_SXCView_SXDVerUpdInv](#sxaddl_sxcview_sxdverupdinv) 493 + +[SxAddl_SXDEnd](#sxaddl_sxdend) 862 + +[SxAddl_SXDVerUpdInv](#sxaddl_sxdverupdinv) 862 + +[SxAddl_SXString](#sxaddl_sxstring) 862 + +[SXAddlHdr](#sxaddlhdr) 863 + +[SXAxis](#sxaxis) 863 + +[SxBool](#sxbool) 494 + +[SXDB](#sxdb) 494 + +[SXDBB](#sxdbb) 495 + +[SXDBEx](#sxdbex) 495 + +[SXDI](#sxdi) 496 + +[SXDtr](#sxdtr) 498 + +[SxDXF](#sxdxf) 498 + +[SxErr](#sxerr) 499 + +[SXEx](#sxex) 499 + +[SXEZDoper](#sxezdoper) 863 + +[SXFDB](#sxfdb) 502 + +[SXFDBType](#sxfdbtype) 505 + +[SxFilt](#sxfilt) 505 + +[SxFmla](#sxfmla) 506 + +[SxFormat](#sxformat) 507 + +[SxFormula](#sxformula) 507 + +[SxFT](#sxft) 864 + +[SxInt](#sxint) 507 + +[SxIsxoper](#sxisxoper) 508 + +[SxItm](#sxitm) 508 + +[SxIvd](#sxivd) 509 + +[SxIvdCol](#sxivdcol) 868 + +[SxIvdRw](#sxivdrw) 868 + +[SXLI](#sxli) 510 + +[SXLIItem](#sxliitem) 868 + +[SxName](#sxname) 510 + +[SxNil](#sxnil) 511 + +[SXNum](#sxnum) 511 + +[SXPair](#sxpair) 511 + +[SXPI](#sxpi) 512 + +[SXPI_Item](#sxpi_item) 871 + +[SXPIEx](#sxpiex) 513 + +[SXRng](#sxrng) 513 + +[SxRule](#sxrule) 515 + +[SxSelect](#sxselect) 517 + +[SXStreamID](#sxstreamid) 519 + +[SXString](#sxstring) 519 + +[SXTbl](#sxtbl) 519 + +[SxTbpg](#sxtbpg) 520 + +[SXTBRGIITM](#sxtbrgiitm) 521 + +[SXTH](#sxth) 521 + +[Sxvd](#sxvd) 524 + +[SXVDEx](#sxvdex) 528 + +[SXVDEx_Opt](#sxvdex_opt) 871 + +[SXVDTEx](#sxvdtex) 531 + +[SXVI](#sxvi) 532 + +[SxView](#sxview) 534 + +[SxView9Save](#sxview9save) 872 + +[SxViewEx](#sxviewex) 536 + +[SxViewEx9](#sxviewex9) 537 + +[SxViewLink](#sxviewlink) 538 + +[SXVIFlags](#sxviflags) 872 + +[SXVS](#sxvs) 539 + +[Sync](#sync) 539 + +T + +[TabId](#tabid) 873 + +[TabIndex](#tabindex) 873 + +[Table](#table) 539 + +[Table example](#table-1) 937 + +[Table styles](#table-styles) 160 + +[Table: Feathdr11 example](#table-feathdr11) 937 + +[Table: Feature11 example](#table-feature11) 938 + +[TableFeatureType](#tablefeaturetype) 873 + +[TableStyle](#tablestyle) 541 + +[TableStyleElement](#tablestyleelement) 542 + +[TableStyles](#tablestyles) 545 + +[Tag_Fn_MDX](#tag_fn_mdx) 877 + +[TBC](#tbc) 922 + +[TBCCmd](#tbccmd) 923 + +[Template](#template) 546 + +[Text](#text) 546 + +[Text import connections](#text-import-connections) 164 + +[TextPropsStream](#textpropsstream) 551 + +[TextPropsStreamChecksumData](#textpropsstreamchecksumdata) 878 + +[Theme](#theme) 553 + +[Tick](#tick) 553 + +Tokens + +[control](#control-tokens) 83 + +[display](#display-tokens) 83 + +[mem](#mem-tokens) 83 + +[operand](#operand-tokens) 82 + +[operator](#operator-tokens) 82 + +[Top10FT](#top10ft) 880 + +[TopMargin](#topmargin) 556 + +[Tracking changes](#change-tracking) 1096 + +[Trendline](#trendline) 101 + +[Ts](#ts) 880 + +[TxO](#txo) 557 + +[TxOLastRun](#txolastrun) 880 + +[TxORuns](#txoruns) 881 + +[TxtQry](#txtqry) 559 + +[TxtWf](#txtwf) 881 + +U + +[Uncalced](#uncalced) 561 + +[Underline](#underline) 882 + +[Units](#units) 561 + +[User log](#user-log) 168 + +[User names stream](#user-names-stream-user-names) 68 + +[UserBView](#userbview) 561 + +[UserSViewBegin](#usersviewbegin) 565 + +[UserSViewBegin_Chart](#usersviewbegin_chart) 568 + +[UserSViewEnd](#usersviewend) 570 + +[UsesELFs](#useselfs) 570 + +[UsrChk](#usrchk) 570 + +[UsrExcl](#usrexcl) 571 + +[UsrInfo](#usrinfo) 572 + +V + +[Value metadata](#value-metadata) 105 + +[ValueRange](#valuerange) 572 + +[VBA storage](#vba-storage-_vba_project_cur) 68 + +[VCenter](#vcenter) 575 + +[Vendor-extensible fields](#vendor-extensible-fields) 56 + +[Versioning](#versioning-and-localization) 55 + +[VertAlign](#vertalign) 882 + +[VertBrk](#vertbrk) 882 + +[VerticalPageBreaks](#verticalpagebreaks) 575 + +[Viewer content stream](#viewer-content-stream-009drmviewercontent) 68 + +[VirtualPath](#virtualpath) 882 + +W + +[Web connections](#web-connections) 164 + +[WebPub](#webpub) 575 + +[WebPubString](#webpubstring) 884 + +[Window1](#window1) 578 + +[Window2](#window2) 579 + +[WinProtect](#winprotect) 581 + +[WOpt](#wopt) 582 + +[Workbook example](#workbook) 996 + +[Workbook stream](#workbook-stream-workbook) 68 + +[Workbook: BOF 1 example](#workbook-bof-1) 997 + +[Workbook: BookBool example](#workbook-bookbool) 1001 + +[Workbook: BookExt example](#workbook-bookext) 1010 + +[Workbook: BoundSheet8 1 example](#workbook-boundsheet8-1) 1007 + +[Workbook: BoundSheet8 2 example](#workbook-boundsheet8-2) 1007 + +[Workbook: BoundSheet8 3 example](#workbook-boundsheet8-3) 1008 + +[Workbook: BuiltInFnGroupCount example](#workbook-builtinfngroupcount) 999 + +[Workbook: CalcPrecision example](#workbook-calcprecision) 1001 + +[Workbook: Country example](#workbook-country) 1008 + +[Workbook: Date1904 example](#workbook-date1904) 1001 + +[Workbook: DBCell example](#workbook-dbcell) 1027 + +[Workbook: DefaultRowHeight example](#workbook-defaultrowheight) 1014 + +[Workbook: DefColWidth example](#workbook-defcolwidth) 1017 + +[Workbook: Dimensions example](#workbook-dimensions) 1017 + +[Workbook: EOF 1 example](#workbook-eof-1) 1012 + +Workbook: EOF 2 example ([section 3.9.22](#workbook-bof-2) 1012, [section 3.9.41](#workbook-eof-2) 1031) + +[Workbook: ExtSST example](#workbook-extsst) 1009 + +[Workbook: Font example](#workbook-font) 1002 + +[Workbook: Format example](#workbook-format) 1003 + +[Workbook: Formula example](#workbook-formula) 1024 + +[Workbook: HideObj example](#workbook-hideobj) 1001 + +[Workbook: Index example](#workbook-index) 1013 + +[Workbook: LabelSst 1 example](#workbook-labelsst-1) 1021 + +[Workbook: LabelSst 2 example](#workbook-labelsst-2) 1023 + +[Workbook: PhoneticInfo example](#workbook-phoneticinfo) 1030 + +[Workbook: RecalcId example](#workbook-recalcid) 1009 + +[Workbook: RK example](#workbook-rk) 1022 + +[Workbook: Row 1 example](#workbook-row-1) 1018 + +[Workbook: Row 2 example](#workbook-row-2) 1019 + +[Workbook: Row 3 example](#workbook-row-3) 1020 + +[Workbook: Row 4 example](#workbook-row-4) 1020 + +[Workbook: RRTabId example](#workbook-rrtabid) 998 + +[Workbook: Selection example](#workbook-selection) 1029 + +[Workbook: Setup example](#workbook-setup) 1015 + +[Workbook: SST example](#workbook-sst) 1009 + +[Workbook: Style example](#workbook-style) 1006 + +[Workbook: Window1 example](#workbook-window1) 999 + +[Workbook: Window2 example](#workbook-window2) 1027 + +[Workbook: WsBool example](#workbook-wsbool) 1014 + +[Workbook: XF example](#workbook-xf) 1004 + +[WriteAccess](#writeaccess) 583 + +[WriteProtect](#writeprotect) 584 + +[WsBool](#wsbool) 584 + +X + +XCB structures + +[CTB](#ctb) 921 + +[CTBS](#ctbs) 920 + +[CTBWRAPPER](#ctbwrapper) 920 + +[TBC](#tbc) 922 + +[TBCCmd](#tbccmd) 923 + +[XColorType](#xcolortype) 885 + +[XCT](#xct) 585 + +[XF](#xf) 585 + +[XFCRC](#xfcrc) 586 + +[XFExt](#xfext) 586 + +[XFExtGradient](#xfextgradient) 885 + +[XFExtNoFRT](#xfextnofrt) 886 + +[XFIndex](#xfindex) 886 + +[XFProp](#xfprop) 888 + +[XFPropBorder](#xfpropborder) 890 + +[XFPropColor](#xfpropcolor) 890 + +[XFPropGradient](#xfpropgradient) 891 + +[XFPropGradientStop](#xfpropgradientstop) 892 + +[XFProps](#xfprops) 892 + +[XFPropTextRotation](#xfproptextrotation) 893 + +[XFs](#xfs) 158 + +[XLNameUnicodeString](#xlnameunicodestring) 893 + +[XlsFilter_Criteria](#xlsfilter_criteria) 894 + +[XlsFilter_Top10](#xlsfilter_top10) 895 + +[XLUnicodeRichExtendedString](#xlunicoderichextendedstring) 896 + +[XLUnicodeString](#xlunicodestring) 897 + +[XLUnicodeStringMin2](#xlunicodestringmin2) 898 + +[XLUnicodeStringNoCch](#xlunicodestringnocch) 898 + +[XLUnicodeStringSegmented](#xlunicodestringsegmented) 898 + +[XLUnicodeStringSegmentedRTD](#xlunicodestringsegmentedrtd) 899 + +[XLUnicodeStringSegmentedSXAddl](#xlunicodestringsegmentedsxaddl) 899 + +[XML signatures storage](#xml-signatures-storage-_xmlsignatures) 76 + +[XML stream](#xml-stream-xml) 76 + +[XmlTkBackWallThicknessFrt](#xmltkbackwallthicknessfrt) 900 + +[XmlTkBaseTimeUnitFrt](#xmltkbasetimeunitfrt) 900 + +[XmlTkBlob](#xmltkblob) 901 + +[XmlTkBool](#xmltkbool) 901 + +[XmlTkChain](#xmltkchain) 902 + +[XmlTkColorMappingOverride](#xmltkcolormappingoverride) 904 + +[XmlTkDispBlanksAsFrt](#xmltkdispblanksasfrt) 904 + +[XmlTkDouble](#xmltkdouble) 905 + +[XmlTkDWord](#xmltkdword) 905 + +[XmlTkEnd](#xmltkend) 906 + +[XmlTkEndSurface](#xmltkendsurface) 906 + +[XmlTkFloorThicknessFrt](#xmltkfloorthicknessfrt) 906 + +[XmlTkFormatCodeFrt](#xmltkformatcodefrt) 907 + +[XmlTkHeader](#xmltkheader) 907 + +[XmlTkHeightPercent](#xmltkheightpercent) 907 + +[XmlTkLogBaseFrt](#xmltklogbasefrt) 908 + +[XmlTkMajorUnitFrt](#xmltkmajorunitfrt) 908 + +[XmlTkMajorUnitTypeFrt](#xmltkmajorunittypefrt) 908 + +[XmlTkMaxFrt](#xmltkmaxfrt) 909 + +[XmlTkMinFrt](#xmltkminfrt) 909 + +[XmlTkMinorUnitFrt](#xmltkminorunitfrt) 910 + +[XmlTkMinorUnitTypeFrt](#xmltkminorunittypefrt) 910 + +[XmlTkNoMultiLvlLbl](#xmltknomultilvllbl) 911 + +[XmlTkOverlay](#xmltkoverlay) 911 + +[XmlTkPerspectiveFrt](#xmltkperspectivefrt) 912 + +[XmlTkPieComboFrom12Frt](#xmltkpiecombofrom12frt) 912 + +[XmlTkRAngAxOffFrt](#xmltkrangaxofffrt) 912 + +[XmlTkRotXFrt](#xmltkrotxfrt) 913 + +[XmlTkRotYFrt](#xmltkrotyfrt) 913 + +[XmlTkShowDLblsOverMax](#xmltkshowdlblsovermax) 913 + +[XmlTkSpb](#xmltkspb) 914 + +[XmlTkStart](#xmltkstart) 914 + +[XmlTkStartSurface](#xmltkstartsurface) 914 + +[XmlTkString](#xmltkstring) 915 + +[XmlTkStyle](#xmltkstyle) 915 + +[XmlTkSymbolFrt](#xmltksymbolfrt) 915 + +[XmlTkThemeOverride](#xmltkthemeoverride) 916 + +[XmlTkTickLabelPositionFrt](#xmltkticklabelpositionfrt) 916 + +[XmlTkTickLabelSkipFrt](#xmltkticklabelskipfrt) 917 + +[XmlTkTickMarkSkipFrt](#xmltktickmarkskipfrt) 917 + +[XmlTkToken](#xmltktoken) 917 + +[XmlTkTpb](#xmltktpb) 918 + +[Xnum](#xnum) 918 + +[XORObfuscation](#xorobfuscation) 918 + +[XTI](#xti) 918 + +[XtiIndex](#xtiindex) 833 + +Y + +[YMult](#ymult) 587 diff --git a/docs/standards/xls/ms-xls.docx b/docs/standards/xls/ms-xls.docx new file mode 100644 index 0000000..ce1248c Binary files /dev/null and b/docs/standards/xls/ms-xls.docx differ diff --git a/docs/standards/xls/ms-xls.md b/docs/standards/xls/ms-xls.md new file mode 100644 index 0000000..6f92b10 --- /dev/null +++ b/docs/standards/xls/ms-xls.md @@ -0,0 +1,45657 @@ +**\[MS-XLS\]:** + +**Excel Binary File Format (.xls) Structure** + +Intellectual Property Rights Notice for Open Specifications Documentation + +- **Technical Documentation.** Microsoft publishes Open Specifications documentation (“this documentation”) for protocols, file formats, data portability, computer languages, and standards support. Additionally, overview documents cover inter-protocol relationships and interactions. + +- **Copyrights**. This documentation is covered by Microsoft copyrights. Regardless of any other terms that are contained in the terms of use for the Microsoft website that hosts this documentation, you can make copies of it in order to develop implementations of the technologies that are described in this documentation and can distribute portions of it in your implementations that use these technologies or in your documentation as necessary to properly document the implementation. You can also distribute in your implementation, with or without modification, any schemas, IDLs, or code samples that are included in the documentation. This permission also applies to any documents that are referenced in the Open Specifications documentation. + +- **No Trade Secrets**. Microsoft does not claim any trade secret rights in this documentation. + +- **Patents**. Microsoft has patents that might cover your implementations of the technologies described in the Open Specifications documentation. Neither this notice nor Microsoft's delivery of this documentation grants any licenses under those patents or any other Microsoft patents. However, a given Open Specifications document might be covered by the Microsoft [Open Specifications Promise](https://go.microsoft.com/fwlink/?LinkId=214445) or the [Microsoft Community Promise](https://go.microsoft.com/fwlink/?LinkId=214448). If you would prefer a written license, or if the technologies described in this documentation are not covered by the Open Specifications Promise or Community Promise, as applicable, patent licenses are available by contacting . + +- **License Programs**. To see all of the protocols in scope under a specific license program and the associated patents, visit the [Patent Map](https://aka.ms/AA9ufj8). + +- **Trademarks**. The names of companies and products contained in this documentation might be covered by trademarks or similar intellectual property rights. This notice does not grant any licenses under those rights. For a list of Microsoft trademarks, visit [www.microsoft.com/trademarks](https://www.microsoft.com/trademarks). + +- **Fictitious Names**. The example companies, organizations, products, domain names, email addresses, logos, people, places, and events that are depicted in this documentation are fictitious. No association with any real company, organization, product, domain name, email address, logo, person, place, or event is intended or should be inferred. + +**Reservation of Rights**. All other rights are reserved, and this notice does not grant any rights other than as specifically described above, whether by implication, estoppel, or otherwise. + +**Tools**. The Open Specifications documentation does not require the use of Microsoft programming tools or programming environments in order for you to develop an implementation. If you have access to Microsoft programming tools and environments, you are free to take advantage of them. Certain Open Specifications documents are intended for use in conjunction with publicly available standards specifications and network programming art and, as such, assume that the reader either is familiar with the aforementioned material or has immediate access to it. + +**Support.** For questions and support, please contact . + +**Revision Summary** + +| Date | Revision History | Revision Class | Comments | +|----|----|----|----| +| 6/27/2008 | 1.0 | New | First release | +| 8/15/2008 | 1.01 | Minor | Revised and edited the technical content | +| 10/6/2008 | 1.02 | Minor | Revised and edited the technical content | +| 1/16/2009 | 1.03 | Minor | Updated the Intellectual Property Rights Notice | +| 7/13/2009 | 1.04 | Major | Changes made for template compliance | +| 8/28/2009 | 1.05 | Editorial | Revised and edited the technical content | +| 11/6/2009 | 1.06 | Editorial | Revised and edited the technical content | +| 2/19/2010 | 2.0 | Major | Updated and revised the technical content | +| 3/31/2010 | 2.01 | Editorial | Revised and edited the technical content | +| 4/30/2010 | 2.02 | Editorial | Revised and edited the technical content | +| 6/7/2010 | 2.03 | Minor | Updated the technical content | +| 6/29/2010 | 2.04 | Editorial | Changed language and formatting in the technical content. | +| 7/23/2010 | 2.04 | None | No changes to the meaning, language, or formatting of the technical content. | +| 9/27/2010 | 2.05 | Minor | Clarified the meaning of the technical content. | +| 11/15/2010 | 2.05 | None | No changes to the meaning, language, or formatting of the technical content. | +| 12/17/2010 | 2.05 | None | No changes to the meaning, language, or formatting of the technical content. | +| 3/18/2011 | 2.05 | None | No changes to the meaning, language, or formatting of the technical content. | +| 6/10/2011 | 2.05 | None | No changes to the meaning, language, or formatting of the technical content. | +| 1/20/2012 | 2.6 | Minor | Clarified the meaning of the technical content. | +| 4/11/2012 | 2.6 | None | No changes to the meaning, language, or formatting of the technical content. | +| 7/16/2012 | 2.6 | None | No changes to the meaning, language, or formatting of the technical content. | +| 10/8/2012 | 2.7 | Minor | Clarified the meaning of the technical content. | +| 2/11/2013 | 2.7 | None | No changes to the meaning, language, or formatting of the technical content. | +| 7/30/2013 | 2.8 | Minor | Clarified the meaning of the technical content. | +| 11/18/2013 | 2.8 | None | No changes to the meaning, language, or formatting of the technical content. | +| 2/10/2014 | 2.8 | None | No changes to the meaning, language, or formatting of the technical content. | +| 4/30/2014 | 3.0 | Major | Significantly changed the technical content. | +| 7/31/2014 | 3.1 | Minor | Clarified the meaning of the technical content. | +| 10/30/2014 | 3.2 | Minor | Clarified the meaning of the technical content. | +| 3/16/2015 | 4.0 | Major | Significantly changed the technical content. | +| 9/4/2015 | 4.1 | Minor | Clarified the meaning of the technical content. | +| 7/15/2016 | 4.2 | Minor | Clarified the meaning of the technical content. | +| 8/23/2016 | 4.2 | None | No changes to the meaning, language, or formatting of the technical content. | +| 9/14/2016 | 4.2 | None | No changes to the meaning, language, or formatting of the technical content. | +| 10/17/2016 | 5.0 | Major | Significantly changed the technical content. | +| 6/20/2017 | 6.0 | Major | Significantly changed the technical content. | +| 9/19/2017 | 6.1 | Minor | Clarified the meaning of the technical content. | +| 12/12/2017 | 6.1 | None | No changes to the meaning, language, or formatting of the technical content. | +| 4/27/2018 | 7.0 | Major | Significantly changed the technical content. | +| 8/28/2018 | 8.0 | Major | Significantly changed the technical content. | +| 12/11/2018 | 8.0 | None | No changes to the meaning, language, or formatting of the technical content. | +| 3/19/2019 | 8.0 | None | No changes to the meaning, language, or formatting of the technical content. | +| 6/18/2019 | 8.0 | None | No changes to the meaning, language, or formatting of the technical content. | +| 4/22/2021 | 9.0 | Major | Significantly changed the technical content. | +| 8/17/2021 | 10.0 | Major | Significantly changed the technical content. | +| 11/16/2021 | 10.1 | Minor | Clarified the meaning of the technical content. | +| 2/15/2022 | 10.2 | Minor | Clarified the meaning of the technical content. | +| 5/17/2022 | 10.3 | Minor | Clarified the meaning of the technical content. | +| 8/16/2022 | 10.4 | Minor | Clarified the meaning of the technical content. | +| 11/15/2022 | 10.5 | Minor | Clarified the meaning of the technical content. | +| 2/21/2023 | 10.6 | Minor | Clarified the meaning of the technical content. | +| 5/16/2023 | 10.7 | Minor | Clarified the meaning of the technical content. | +| 4/16/2024 | 11.0 | Major | Significantly changed the technical content. | +| 8/20/2024 | 12.0 | Major | Significantly changed the technical content. | +| 5/20/2025 | 12.1 | Minor | Clarified the meaning of the technical content. | +| 8/19/2025 | 12.2 | Minor | Clarified the meaning of the technical content. | + +Table of Contents + +[1 Introduction [29](#introduction)](#introduction) + +[1.1 Glossary [29](#glossary)](#glossary) + +[1.2 References [52](#references)](#references) + +[1.2.1 Normative References [52](#normative-references)](#normative-references) + +[1.2.2 Informative References [53](#informative-references)](#informative-references) + +[1.3 Overview [53](#overview)](#overview) + +[1.3.1 stream Byte Ordering [54](#stream-byte-ordering)](#stream-byte-ordering) + +[1.3.2 Organization of This Documentation [54](#organization-of-this-documentation)](#organization-of-this-documentation) + +[1.4 Relationship to Protocols and Other Structures [55](#relationship-to-protocols-and-other-structures)](#relationship-to-protocols-and-other-structures) + +[1.5 Applicability Statement [55](#applicability-statement)](#applicability-statement) + +[1.6 Versioning and Localization [55](#versioning-and-localization)](#versioning-and-localization) + +[1.7 Vendor-Extensible Fields [56](#vendor-extensible-fields)](#vendor-extensible-fields) + +[2 Structures [57](#structures)](#structures) + +[2.1 File Structure [57](#file-structure)](#file-structure) + +[2.1.1 Compound File [57](#compound-file)](#compound-file) + +[2.1.2 Stream [57](#stream)](#stream) + +[2.1.3 Substream [57](#substream)](#substream) + +[2.1.4 Record [57](#record)](#record) + +[2.1.5 Collection of Records [58](#collection-of-records)](#collection-of-records) + +[2.1.6 Future Record [58](#future-record)](#future-record) + +[2.1.6.1 Chart [59](#chart)](#chart) + +[2.1.6.2 PivotTable [59](#pivottable)](#pivottable) + +[2.1.7 Storages and Streams [59](#storages-and-streams)](#storages-and-streams) + +[2.1.7.1 Component Object Stream (\001CompObj) [59](#component-object-stream-001compobj)](#component-object-stream-001compobj) + +[2.1.7.2 Control Stream (Ctls) [60](#control-stream-ctls)](#control-stream-ctls) + +[2.1.7.3 Data Spaces Storage (\006DataSpaces) [60](#data-spaces-storage-006dataspaces)](#data-spaces-storage-006dataspaces) + +[2.1.7.4 Document Summary Information Stream (\005DocumentSummaryInformation) [60](#document-summary-information-stream-005documentsummaryinformation)](#document-summary-information-stream-005documentsummaryinformation) + +[2.1.7.5 Embedding Storage (MBD...) [60](#embedding-storage-mbd...)](#embedding-storage-mbd...) + +[2.1.7.6 Encryption Stream (encryption) [60](#encryption-stream-encryption)](#encryption-stream-encryption) + +[2.1.7.7 Link Storage (LNK...) [60](#link-storage-lnk...)](#link-storage-lnk...) + +[2.1.7.8 List Data Stream (List Data) [61](#list-data-stream-list-data)](#list-data-stream-list-data) + +[2.1.7.8.1 Attributes [62](#attributes)](#attributes) + +[2.1.7.8.2 Elements [62](#elements)](#elements) + +[2.1.7.8.2.1 LISTNAME [63](#listname)](#listname) + +[2.1.7.8.2.2 VIEWGUID [63](#viewguid)](#viewguid) + +[2.1.7.8.2.3 LISTWEB [63](#listweb)](#listweb) + +[2.1.7.8.2.4 ROOTFOLDER [63](#rootfolder)](#rootfolder) + +[2.1.7.8.2.5 LISTSCHEMA [63](#listschema)](#listschema) + +[2.1.7.8.2.6 VIEWSCHEMA [64](#viewschema)](#viewschema) + +[2.1.7.8.2.7 LISTDATA [64](#listdata)](#listdata) + +[2.1.7.8.2.8 UPDATE [64](#update)](#update) + +[2.1.7.8.2.9 LISTDATAFTR [65](#listdataftr)](#listdataftr) + +[2.1.7.9 Office Data Store Storage (MsoDataStore) [65](#office-data-store-storage-msodatastore)](#office-data-store-storage-msodatastore) + +[2.1.7.10 Office Toolbars Stream (XCB) [65](#office-toolbars-stream-xcb)](#office-toolbars-stream-xcb) + +[2.1.7.11 OLE Stream (\001Ole) [66](#ole-stream-001ole)](#ole-stream-001ole) + +[2.1.7.12 Pivot Cache Storage (\_SX_DB_CUR) [66](#pivot-cache-storage-_sx_db_cur)](#pivot-cache-storage-_sx_db_cur) + +[2.1.7.13 Protected Content Stream (\009DRMContent) [66](#protected-content-stream-009drmcontent)](#protected-content-stream-009drmcontent) + +[2.1.7.14 Revision Stream (Revision Log) [66](#revision-stream-revision-log)](#revision-stream-revision-log) + +[2.1.7.15 Signatures Stream (\_signatures) [67](#signatures-stream-_signatures)](#signatures-stream-_signatures) + +[2.1.7.16 Summary Information Stream (\005SummaryInformation) [67](#summary-information-stream-005summaryinformation)](#summary-information-stream-005summaryinformation) + +[2.1.7.17 User Names Stream (User Names) [68](#user-names-stream-user-names)](#user-names-stream-user-names) + +[2.1.7.18 VBA Storage (\_VBA_PROJECT_CUR) [68](#vba-storage-_vba_project_cur)](#vba-storage-_vba_project_cur) + +[2.1.7.19 Viewer Content Stream (\009DRMViewerContent) [68](#viewer-content-stream-009drmviewercontent)](#viewer-content-stream-009drmviewercontent) + +[2.1.7.20 Workbook Stream (Workbook) [68](#workbook-stream-workbook)](#workbook-stream-workbook) + +[2.1.7.20.1 Chart Sheet Substream [68](#chart-sheet-substream)](#chart-sheet-substream) + +[2.1.7.20.2 Dialog Sheet Substream [70](#dialog-sheet-substream)](#dialog-sheet-substream) + +[2.1.7.20.3 Globals Substream [70](#globals-substream)](#globals-substream) + +[2.1.7.20.4 Macro Sheet Substream [72](#macro-sheet-substream)](#macro-sheet-substream) + +[2.1.7.20.5 Worksheet Substream [72](#worksheet-substream)](#worksheet-substream) + +[2.1.7.20.6 Common Productions [74](#common-productions)](#common-productions) + +[2.1.7.21 XML Signatures Storage (\_xmlsignatures) [76](#xml-signatures-storage-_xmlsignatures)](#xml-signatures-storage-_xmlsignatures) + +[2.1.7.22 XML Stream (XML) [76](#xml-stream-xml)](#xml-stream-xml) + +[2.1.7.22.1 Elements [77](#elements-1)](#elements-1) + +[2.1.7.22.1.1 MapInfo [78](#mapinfo)](#mapinfo) + +[2.1.7.22.1.2 Schema [78](#schema)](#schema) + +[2.1.7.22.1.3 Map [78](#map)](#map) + +[2.1.7.22.1.4 DataBinding [79](#databinding)](#databinding) + +[2.1.7.22.2 Simple Types [79](#simple-types)](#simple-types) + +[2.1.7.22.2.1 ST_DataBindingLoadMode [79](#st_databindingloadmode)](#st_databindingloadmode) + +[2.1.7.22.2.2 ST_XmlMapBoolean [80](#st_xmlmapboolean)](#st_xmlmapboolean) + +[2.1.7.22.2.3 ST_XmlMapId [80](#st_xmlmapid)](#st_xmlmapid) + +[2.1.7.22.2.4 ST_XmlString65535 [80](#st_xmlstring65535)](#st_xmlstring65535) + +[2.1.7.22.2.5 ST_XmlString256 [80](#st_xmlstring256)](#st_xmlstring256) + +[2.2 Conceptual Overview [80](#conceptual-overview)](#conceptual-overview) + +[2.2.1 Cell Table [80](#cell-table)](#cell-table) + +[2.2.1.1 Retrieval of Last-Calculated Cell Values Without Loading Cell Table [81](#retrieval-of-last-calculated-cell-values-without-loading-cell-table)](#retrieval-of-last-calculated-cell-values-without-loading-cell-table) + +[2.2.2 Formulas [81](#formulas)](#formulas) + +[2.2.2.1 Operator Tokens [82](#operator-tokens)](#operator-tokens) + +[2.2.2.2 Operand Tokens [82](#operand-tokens)](#operand-tokens) + +[2.2.2.2.1 Value Class [82](#value-class)](#value-class) + +[2.2.2.2.2 Reference Class [83](#reference-class)](#reference-class) + +[2.2.2.3 Control Tokens [83](#control-tokens)](#control-tokens) + +[2.2.2.4 Display Tokens [83](#display-tokens)](#display-tokens) + +[2.2.2.5 Mem Tokens [83](#mem-tokens)](#mem-tokens) + +[2.2.2.6 Formula Elements [83](#formula-elements)](#formula-elements) + +[2.2.3 Charts [83](#charts)](#charts) + +[2.2.3.1 Chart Sheet [84](#chart-sheet)](#chart-sheet) + +[2.2.3.2 Chart Data Cache [85](#chart-data-cache)](#chart-data-cache) + +[2.2.3.3 Chart [86](#chart-1)](#chart-1) + +[2.2.3.4 Pivot Chart [87](#pivot-chart)](#pivot-chart) + +[2.2.3.5 Axis Group [87](#axis-group)](#axis-group) + +[2.2.3.6 Axis [89](#axis)](#axis) + +[2.2.3.7 Chart Group [91](#chart-group)](#chart-group) + +[2.2.3.8 Legend [92](#legend)](#legend) + +[2.2.3.9 Series [94](#series)](#series) + +[2.2.3.10 Data Point [95](#data-point)](#data-point) + +[2.2.3.11 Data Label [95](#data-label)](#data-label) + +[2.2.3.12 Trendline [101](#trendline)](#trendline) + +[2.2.3.13 Error Bar [101](#error-bar)](#error-bar) + +[2.2.3.14 Data Table [102](#data-table)](#data-table) + +[2.2.3.15 Attached Label [103](#attached-label)](#attached-label) + +[2.2.3.16 SPRC [104](#sprc)](#sprc) + +[2.2.3.17 Chart Area [104](#chart-area)](#chart-area) + +[2.2.4 Metadata [104](#metadata)](#metadata) + +[2.2.4.1 Metadata Types [105](#metadata-types)](#metadata-types) + +[2.2.4.2 Cell Metadata [105](#cell-metadata)](#cell-metadata) + +[2.2.4.3 Value Metadata [105](#value-metadata)](#value-metadata) + +[2.2.4.4 Metadata Block [106](#metadata-block)](#metadata-block) + +[2.2.4.5 MDX Metadata [106](#mdx-metadata)](#mdx-metadata) + +[2.2.4.5.1 MDX Tuple Metadata [107](#mdx-tuple-metadata)](#mdx-tuple-metadata) + +[2.2.4.5.2 MDX Set Metadata [107](#mdx-set-metadata)](#mdx-set-metadata) + +[2.2.4.5.3 MDX Member Property Metadata [107](#mdx-member-property-metadata)](#mdx-member-property-metadata) + +[2.2.4.5.4 MDX KPI Metadata [107](#mdx-kpi-metadata)](#mdx-kpi-metadata) + +[2.2.5 PivotTables [107](#pivottables)](#pivottables) + +[2.2.5.1 PivotTable Records [108](#pivottable-records)](#pivottable-records) + +[2.2.5.1.1 Usage of SXAddl Records [108](#usage-of-sxaddl-records)](#usage-of-sxaddl-records) + +[2.2.5.1.1.1 Class [108](#class)](#class) + +[2.2.5.1.1.1.1 SxcView Class [109](#sxcview-class)](#sxcview-class) + +[2.2.5.1.1.1.2 SxcField Class [110](#sxcfield-class)](#sxcfield-class) + +[2.2.5.1.1.1.3 SxcHierarchy Class [110](#sxchierarchy-class)](#sxchierarchy-class) + +[2.2.5.1.1.1.4 SxcCache Class [111](#sxccache-class)](#sxccache-class) + +[2.2.5.1.1.1.5 SxcCacheField Class [112](#sxccachefield-class)](#sxccachefield-class) + +[2.2.5.1.1.1.6 SxcQsi Class [112](#sxcqsi-class)](#sxcqsi-class) + +[2.2.5.1.1.1.7 SxcQuery Class [113](#sxcquery-class)](#sxcquery-class) + +[2.2.5.1.1.1.8 SxcGrpLevel Class [113](#sxcgrplevel-class)](#sxcgrplevel-class) + +[2.2.5.1.1.1.9 SxcGroup Class [113](#sxcgroup-class)](#sxcgroup-class) + +[2.2.5.1.1.1.10 SxcCacheItem Class [114](#sxccacheitem-class)](#sxccacheitem-class) + +[2.2.5.1.1.1.11 SxcSXrule Class [114](#sxcsxrule-class)](#sxcsxrule-class) + +[2.2.5.1.1.1.12 SxcSXfilt Class [115](#sxcsxfilt-class)](#sxcsxfilt-class) + +[2.2.5.1.1.1.13 SxcSXDH Class [115](#sxcsxdh-class)](#sxcsxdh-class) + +[2.2.5.1.1.1.14 SxcAutoSort Class [115](#sxcautosort-class)](#sxcautosort-class) + +[2.2.5.1.1.1.15 SxcSXMgs Class [116](#sxcsxmgs-class)](#sxcsxmgs-class) + +[2.2.5.1.1.1.16 SxcSXMg Class [116](#sxcsxmg-class)](#sxcsxmg-class) + +[2.2.5.1.1.1.17 SxcField12 Class [116](#sxcfield12-class)](#sxcfield12-class) + +[2.2.5.1.1.1.18 SxcSXCondFmts Class [117](#sxcsxcondfmts-class)](#sxcsxcondfmts-class) + +[2.2.5.1.1.1.19 SxcSXCondFmt Class [117](#sxcsxcondfmt-class)](#sxcsxcondfmt-class) + +[2.2.5.1.1.1.20 SxcSXFilters12 Class [117](#sxcsxfilters12-class)](#sxcsxfilters12-class) + +[2.2.5.1.1.1.21 SxcSXFilter12 Class [118](#sxcsxfilter12-class)](#sxcsxfilter12-class) + +[2.2.5.2 Data Functionality Level [118](#data-functionality-level)](#data-functionality-level) + +[2.2.5.3 PivotCache [118](#pivotcache)](#pivotcache) + +[2.2.5.3.1 PivotCache Functionality Level [119](#pivotcache-functionality-level)](#pivotcache-functionality-level) + +[2.2.5.3.2 Source Data [119](#source-data)](#source-data) + +[2.2.5.3.2.1 Multiple Consolidation Ranges [120](#multiple-consolidation-ranges)](#multiple-consolidation-ranges) + +[2.2.5.3.3 Associated PivotTable views [122](#associated-pivottable-views)](#associated-pivottable-views) + +[2.2.5.3.4 OLAP PivotCache [122](#olap-pivotcache)](#olap-pivotcache) + +[2.2.5.3.4.1 OLAP Data Model [122](#olap-data-model)](#olap-data-model) + +[2.2.5.3.5 Cache Fields [123](#cache-fields)](#cache-fields) + +[2.2.5.3.6 Cache Items [124](#cache-items)](#cache-items) + +[2.2.5.3.7 Grouping [126](#grouping)](#grouping) + +[2.2.5.3.8 Calculated Fields [132](#calculated-fields)](#calculated-fields) + +[2.2.5.3.9 Calculated Items [133](#calculated-items)](#calculated-items) + +[2.2.5.3.10 OLAP Grouping [133](#olap-grouping)](#olap-grouping) + +[2.2.5.3.11 OLAP Calculated Members [133](#olap-calculated-members)](#olap-calculated-members) + +[2.2.5.3.12 Cache Records [134](#cache-records)](#cache-records) + +[2.2.5.4 PivotTable View [135](#pivottable-view)](#pivottable-view) + +[2.2.5.4.1 Associated PivotCache [135](#associated-pivotcache)](#associated-pivotcache) + +[2.2.5.4.2 OLAP PivotTable view [135](#olap-pivottable-view)](#olap-pivottable-view) + +[2.2.5.4.3 Pivot Fields [135](#pivot-fields)](#pivot-fields) + +[2.2.5.4.3.1 Pivot Field Sorting [136](#pivot-field-sorting)](#pivot-field-sorting) + +[2.2.5.4.4 Pivot Items [137](#pivot-items)](#pivot-items) + +[2.2.5.4.5 Pivot Hierarchies [137](#pivot-hierarchies)](#pivot-hierarchies) + +[2.2.5.4.5.1 Association of Pivot Hierarchies and Pivot Fields and Cache Fields [138](#association-of-pivot-hierarchies-and-pivot-fields-and-cache-fields)](#association-of-pivot-hierarchies-and-pivot-fields-and-cache-fields) + +[2.2.5.4.5.2 Measures [139](#measures)](#measures) + +[2.2.5.4.5.3 KPIs [139](#kpis)](#kpis) + +[2.2.5.4.5.4 Named Sets [139](#named-sets)](#named-sets) + +[2.2.5.4.6 Member Properties [139](#member-properties)](#member-properties) + +[2.2.5.4.7 Manual Filters [140](#manual-filters)](#manual-filters) + +[2.2.5.4.7.1 Non-OLAP Manual Filters [140](#non-olap-manual-filters)](#non-olap-manual-filters) + +[2.2.5.4.7.2 OLAP Manual Filters [140](#olap-manual-filters)](#olap-manual-filters) + +[2.2.5.4.8 Filtering by Criteria [141](#filtering-by-criteria)](#filtering-by-criteria) + +[2.2.5.4.8.1 Advanced Filters [141](#advanced-filters)](#advanced-filters) + +[2.2.5.4.8.1.1 Label Filters [142](#label-filters)](#label-filters) + +[2.2.5.4.8.1.2 Date Filters [142](#date-filters)](#date-filters) + +[2.2.5.4.8.1.3 Value Filters [143](#value-filters)](#value-filters) + +[2.2.5.4.8.2 Simple Filters [143](#simple-filters)](#simple-filters) + +[2.2.5.4.9 PivotTable Axes [143](#pivottable-axes)](#pivottable-axes) + +[2.2.5.4.9.1 Page Axis [143](#page-axis)](#page-axis) + +[2.2.5.4.9.1.1 Non-OLAP Page Filtering [144](#non-olap-page-filtering)](#non-olap-page-filtering) + +[2.2.5.4.9.1.2 OLAP Page Filtering [144](#olap-page-filtering)](#olap-page-filtering) + +[2.2.5.4.9.2 Row Axis [145](#row-axis)](#row-axis) + +[2.2.5.4.9.3 Column Axis [146](#column-axis)](#column-axis) + +[2.2.5.4.9.4 Nesting [146](#nesting)](#nesting) + +[2.2.5.4.9.4.1 Collapsing [147](#collapsing)](#collapsing) + +[2.2.5.4.9.4.2 Subtotalling [148](#subtotalling)](#subtotalling) + +[2.2.5.4.9.5 Data Axis [150](#data-axis)](#data-axis) + +[2.2.5.4.9.5.1 Data Items [150](#data-items)](#data-items) + +[2.2.5.4.9.5.2 Data Field [150](#data-field)](#data-field) + +[2.2.5.4.10 PivotTable Layout [150](#pivottable-layout)](#pivottable-layout) + +[2.2.5.4.10.1 Location and Body [151](#location-and-body)](#location-and-body) + +[2.2.5.4.10.1.1 Row Area [153](#row-area)](#row-area) + +[2.2.5.4.10.1.2 Column Area [154](#column-area)](#column-area) + +[2.2.5.4.10.1.3 Page Area [154](#page-area)](#page-area) + +[2.2.5.4.10.1.4 Data Area [155](#data-area)](#data-area) + +[2.2.5.4.10.2 Truncation [155](#truncation)](#truncation) + +[2.2.5.4.10.3 Pivot Lines [155](#pivot-lines)](#pivot-lines) + +[2.2.5.4.10.4 Pivot Line Entries [156](#pivot-line-entries)](#pivot-line-entries) + +[2.2.5.4.11 PivotTable Rules [157](#pivottable-rules)](#pivottable-rules) + +[2.2.6 Styles [158](#styles)](#styles) + +[2.2.6.1 XFs [158](#xfs)](#xfs) + +[2.2.6.1.1 Cell XFs [158](#cell-xfs)](#cell-xfs) + +[2.2.6.1.2 Cell Styles [158](#cell-styles)](#cell-styles) + +[2.2.6.1.2.1 Cell Style XFs [159](#cell-style-xfs)](#cell-style-xfs) + +[2.2.6.1.2.2 Normal Style [159](#normal-style)](#normal-style) + +[2.2.6.2 Differential Formatting (DXFs) [159](#differential-formatting-dxfs)](#differential-formatting-dxfs) + +[2.2.6.2.1 Conditional Formatting [159](#conditional-formatting)](#conditional-formatting) + +[2.2.6.2.2 Table Style Elements [160](#table-style-elements)](#table-style-elements) + +[2.2.6.2.3 Table Block-Level Formatting [160](#table-block-level-formatting)](#table-block-level-formatting) + +[2.2.6.2.4 PivotTable Areas [160](#pivottable-areas)](#pivottable-areas) + +[2.2.6.2.5 Sorting and Filtering [160](#sorting-and-filtering)](#sorting-and-filtering) + +[2.2.6.3 Table Styles [160](#table-styles)](#table-styles) + +[2.2.6.4 Format Conflicts [160](#format-conflicts)](#format-conflicts) + +[2.2.7 External References [161](#external-references)](#external-references) + +[2.2.7.1 External Reference Consumers [161](#external-reference-consumers)](#external-reference-consumers) + +[2.2.7.2 Supporting Link [161](#supporting-link)](#supporting-link) + +[2.2.7.3 External Workbook [162](#external-workbook)](#external-workbook) + +[2.2.7.4 External Defined Name [162](#external-defined-name)](#external-defined-name) + +[2.2.7.5 External Cell Cache [162](#external-cell-cache)](#external-cell-cache) + +[2.2.7.6 DDE Data Source [162](#dde-data-source)](#dde-data-source) + +[2.2.7.7 DDE Data Item [162](#dde-data-item)](#dde-data-item) + +[2.2.7.8 OLE Data Source [162](#ole-data-source)](#ole-data-source) + +[2.2.7.9 OLE Data Item [162](#ole-data-item)](#ole-data-item) + +[2.2.8 External Connections [163](#external-connections)](#external-connections) + +[2.2.8.1 Connection Name [163](#connection-name)](#connection-name) + +[2.2.8.2 External Connection Files [163](#external-connection-files)](#external-connection-files) + +[2.2.8.3 OLE DB Connections [163](#ole-db-connections)](#ole-db-connections) + +[2.2.8.3.1 OLAP Connections [163](#olap-connections)](#olap-connections) + +[2.2.8.4 ODBC Connections [164](#odbc-connections)](#odbc-connections) + +[2.2.8.5 Web Connections [164](#web-connections)](#web-connections) + +[2.2.8.6 Text Import Connections [164](#text-import-connections)](#text-import-connections) + +[2.2.8.7 ADO Recordset Connections [164](#ado-recordset-connections)](#ado-recordset-connections) + +[2.2.8.8 DAO Recordset Connections [164](#dao-recordset-connections)](#dao-recordset-connections) + +[2.2.9 Password Verifier Algorithm [164](#password-verifier-algorithm)](#password-verifier-algorithm) + +[2.2.10 Encryption (Password to Open) [165](#encryption-password-to-open)](#encryption-password-to-open) + +[2.2.11 Shared Workbooks [166](#shared-workbooks)](#shared-workbooks) + +[2.2.11.1 User Log [168](#user-log)](#user-log) + +[2.2.11.2 Revision Logs [168](#revision-logs)](#revision-logs) + +[2.2.11.3 Revision Records [168](#revision-records)](#revision-records) + +[2.2.11.4 Insertion / Deletion of Rows / Columns Revision [168](#insertion-deletion-of-rows-columns-revision)](#insertion-deletion-of-rows-columns-revision) + +[2.2.11.5 Move Cells Revision [169](#move-cells-revision)](#move-cells-revision) + +[2.2.11.6 Change Cells Revision [169](#change-cells-revision)](#change-cells-revision) + +[2.2.11.7 Sort Map [169](#sort-map)](#sort-map) + +[2.2.12 Shared Feature [169](#shared-feature)](#shared-feature) + +[2.3 Record Enumeration [169](#record-enumeration)](#record-enumeration) + +[2.3.1 By Name [170](#by-name)](#by-name) + +[2.3.2 By Number [181](#by-number)](#by-number) + +[2.4 Records [192](#records)](#records) + +[2.4.1 AlRuns [192](#alruns)](#alruns) + +[2.4.2 Area [192](#area)](#area) + +[2.4.3 AreaFormat [193](#areaformat)](#areaformat) + +[2.4.4 Array [198](#array)](#array) + +[2.4.5 AttachedLabel [199](#attachedlabel)](#attachedlabel) + +[2.4.6 AutoFilter [200](#autofilter)](#autofilter) + +[2.4.7 AutoFilter12 [202](#autofilter12)](#autofilter12) + +[2.4.8 AutoFilterInfo [205](#autofilterinfo)](#autofilterinfo) + +[2.4.9 AxcExt [205](#axcext)](#axcext) + +[2.4.10 AxesUsed [208](#axesused)](#axesused) + +[2.4.11 Axis [208](#axis-1)](#axis-1) + +[2.4.12 AxisLine [209](#axisline)](#axisline) + +[2.4.13 AxisParent [210](#axisparent)](#axisparent) + +[2.4.14 Backup [210](#backup)](#backup) + +[2.4.15 Bar [210](#bar)](#bar) + +[2.4.16 BCUsrs [211](#bcusrs)](#bcusrs) + +[2.4.17 Begin [211](#begin)](#begin) + +[2.4.18 BigName [212](#bigname)](#bigname) + +[2.4.19 BkHim [212](#bkhim)](#bkhim) + +[2.4.20 Blank [213](#blank)](#blank) + +[2.4.21 BOF [213](#bof)](#bof) + +[2.4.22 BookBool [215](#bookbool)](#bookbool) + +[2.4.23 BookExt [216](#bookext)](#bookext) + +[2.4.24 BoolErr [217](#boolerr)](#boolerr) + +[2.4.25 BopPop [217](#boppop)](#boppop) + +[2.4.26 BopPopCustom [219](#boppopcustom)](#boppopcustom) + +[2.4.27 BottomMargin [220](#bottommargin)](#bottommargin) + +[2.4.28 BoundSheet8 [221](#boundsheet8)](#boundsheet8) + +[2.4.29 BRAI [222](#brai)](#brai) + +[2.4.30 BuiltInFnGroupCount [223](#builtinfngroupcount)](#builtinfngroupcount) + +[2.4.31 CalcCount [224](#calccount)](#calccount) + +[2.4.32 CalcDelta [224](#calcdelta)](#calcdelta) + +[2.4.33 CalcIter [224](#calciter)](#calciter) + +[2.4.34 CalcMode [224](#calcmode)](#calcmode) + +[2.4.35 CalcPrecision [225](#calcprecision)](#calcprecision) + +[2.4.36 CalcRefMode [225](#calcrefmode)](#calcrefmode) + +[2.4.37 CalcSaveRecalc [225](#calcsaverecalc)](#calcsaverecalc) + +[2.4.38 CatLab [226](#catlab)](#catlab) + +[2.4.39 CatSerRange [226](#catserrange)](#catserrange) + +[2.4.40 CbUsr [228](#cbusr)](#cbusr) + +[2.4.41 CellWatch [228](#cellwatch)](#cellwatch) + +[2.4.42 CF [229](#cf)](#cf) + +[2.4.43 CF12 [230](#cf12)](#cf12) + +[2.4.44 CFEx [233](#cfex)](#cfex) + +[2.4.45 Chart [234](#chart-2)](#chart-2) + +[2.4.46 Chart3d [235](#chart3d)](#chart3d) + +[2.4.47 Chart3DBarShape [237](#chart3dbarshape)](#chart3dbarshape) + +[2.4.48 ChartFormat [237](#chartformat)](#chartformat) + +[2.4.49 ChartFrtInfo [238](#chartfrtinfo)](#chartfrtinfo) + +[2.4.50 ClrtClient [239](#clrtclient)](#clrtclient) + +[2.4.51 CodeName [240](#codename)](#codename) + +[2.4.52 CodePage [240](#codepage)](#codepage) + +[2.4.53 ColInfo [241](#colinfo)](#colinfo) + +[2.4.54 Compat12 [242](#compat12)](#compat12) + +[2.4.55 CompressPictures [242](#compresspictures)](#compresspictures) + +[2.4.56 CondFmt [243](#condfmt)](#condfmt) + +[2.4.57 CondFmt12 [243](#condfmt12)](#condfmt12) + +[2.4.58 Continue [244](#continue)](#continue) + +[2.4.59 ContinueBigName [244](#continuebigname)](#continuebigname) + +[2.4.60 ContinueFrt [245](#continuefrt)](#continuefrt) + +[2.4.61 ContinueFrt11 [245](#continuefrt11)](#continuefrt11) + +[2.4.62 ContinueFrt12 [246](#continuefrt12)](#continuefrt12) + +[2.4.63 Country [246](#country)](#country) + +[2.4.64 CrErr [248](#crerr)](#crerr) + +[2.4.65 CRN [248](#crn)](#crn) + +[2.4.66 CrtLayout12 [249](#crtlayout12)](#crtlayout12) + +[2.4.67 CrtLayout12A [251](#crtlayout12a)](#crtlayout12a) + +[2.4.68 CrtLine [253](#crtline)](#crtline) + +[2.4.69 CrtLink [254](#crtlink)](#crtlink) + +[2.4.70 CrtMlFrt [254](#crtmlfrt)](#crtmlfrt) + +[2.4.71 CrtMlFrtContinue [255](#crtmlfrtcontinue)](#crtmlfrtcontinue) + +[2.4.72 CUsr [255](#cusr)](#cusr) + +[2.4.73 Dat [255](#dat)](#dat) + +[2.4.74 DataFormat [256](#dataformat)](#dataformat) + +[2.4.75 DataLabExt [256](#datalabext)](#datalabext) + +[2.4.76 DataLabExtContents [257](#datalabextcontents)](#datalabextcontents) + +[2.4.77 Date1904 [258](#date1904)](#date1904) + +[2.4.78 DBCell [258](#dbcell)](#dbcell) + +[2.4.79 DbOrParamQry [259](#dborparamqry)](#dborparamqry) + +[2.4.80 DbQuery [259](#dbquery)](#dbquery) + +[2.4.81 DBQueryExt [261](#dbqueryext)](#dbqueryext) + +[2.4.82 DCon [263](#dcon)](#dcon) + +[2.4.83 DConBin [265](#dconbin)](#dconbin) + +[2.4.84 DConn [266](#dconn)](#dconn) + +[2.4.85 DConName [271](#dconname)](#dconname) + +[2.4.86 DConRef [272](#dconref)](#dconref) + +[2.4.87 DefaultRowHeight [273](#defaultrowheight)](#defaultrowheight) + +[2.4.88 DefaultText [273](#defaulttext)](#defaulttext) + +[2.4.89 DefColWidth [274](#defcolwidth)](#defcolwidth) + +[2.4.90 Dimensions [274](#dimensions)](#dimensions) + +[2.4.91 DocRoute [275](#docroute)](#docroute) + +[2.4.92 DropBar [277](#dropbar)](#dropbar) + +[2.4.93 DropDownObjIds [278](#dropdownobjids)](#dropdownobjids) + +[2.4.94 DSF [278](#dsf)](#dsf) + +[2.4.95 Dv [278](#dv)](#dv) + +[2.4.96 DVal [281](#dval)](#dval) + +[2.4.97 DXF [282](#dxf)](#dxf) + +[2.4.98 DxGCol [283](#dxgcol)](#dxgcol) + +[2.4.99 End [283](#end)](#end) + +[2.4.100 EndBlock [283](#endblock)](#endblock) + +[2.4.101 EndObject [285](#endobject)](#endobject) + +[2.4.102 EntExU2 [286](#entexu2)](#entexu2) + +[2.4.103 EOF [286](#eof)](#eof) + +[2.4.104 Excel9File [286](#excel9file)](#excel9file) + +[2.4.105 ExternName [286](#externname)](#externname) + +[2.4.106 ExternSheet [288](#externsheet)](#externsheet) + +[2.4.107 ExtSST [289](#extsst)](#extsst) + +[2.4.108 ExtString [289](#extstring)](#extstring) + +[2.4.109 Fbi [290](#fbi)](#fbi) + +[2.4.110 Fbi2 [291](#fbi2)](#fbi2) + +[2.4.111 Feat [292](#feat)](#feat) + +[2.4.112 FeatHdr [293](#feathdr)](#feathdr) + +[2.4.113 FeatHdr11 [294](#feathdr11)](#feathdr11) + +[2.4.114 Feature11 [294](#feature11)](#feature11) + +[2.4.115 Feature12 [296](#feature12)](#feature12) + +[2.4.116 FileLock [296](#filelock)](#filelock) + +[2.4.117 FilePass [297](#filepass)](#filepass) + +[2.4.118 FileSharing [298](#filesharing)](#filesharing) + +[2.4.119 FilterMode [298](#filtermode)](#filtermode) + +[2.4.120 FnGroupName [298](#fngroupname)](#fngroupname) + +[2.4.121 FnGrp12 [298](#fngrp12)](#fngrp12) + +[2.4.122 Font [299](#font)](#font) + +[2.4.123 FontX [301](#fontx)](#fontx) + +[2.4.124 Footer [302](#footer)](#footer) + +[2.4.125 ForceFullCalculation [302](#forcefullcalculation)](#forcefullcalculation) + +[2.4.126 Format [303](#format)](#format) + +[2.4.127 Formula [310](#formula)](#formula) + +[2.4.128 Frame [311](#frame)](#frame) + +[2.4.129 FrtFontList [312](#frtfontlist)](#frtfontlist) + +[2.4.130 FrtWrapper [312](#frtwrapper)](#frtwrapper) + +[2.4.131 GelFrame [313](#gelframe)](#gelframe) + +[2.4.132 GridSet [315](#gridset)](#gridset) + +[2.4.133 GUIDTypeLib [315](#guidtypelib)](#guidtypelib) + +[2.4.134 Guts [315](#guts)](#guts) + +[2.4.135 HCenter [316](#hcenter)](#hcenter) + +[2.4.136 Header [316](#header)](#header) + +[2.4.137 HeaderFooter [320](#headerfooter)](#headerfooter) + +[2.4.138 HFPicture [321](#hfpicture)](#hfpicture) + +[2.4.139 HideObj [323](#hideobj)](#hideobj) + +[2.4.140 HLink [323](#hlink)](#hlink) + +[2.4.141 HLinkTooltip [323](#hlinktooltip)](#hlinktooltip) + +[2.4.142 HorizontalPageBreaks [324](#horizontalpagebreaks)](#horizontalpagebreaks) + +[2.4.143 IFmtRecord [324](#ifmtrecord)](#ifmtrecord) + +[2.4.144 Index [324](#index)](#index) + +[2.4.145 InterfaceEnd [325](#interfaceend)](#interfaceend) + +[2.4.146 InterfaceHdr [325](#interfacehdr)](#interfacehdr) + +[2.4.147 Intl [325](#intl)](#intl) + +[2.4.148 Label [326](#label)](#label) + +[2.4.149 LabelSst [326](#labelsst)](#labelsst) + +[2.4.150 Lbl [326](#lbl)](#lbl) + +[2.4.151 LeftMargin [329](#leftmargin)](#leftmargin) + +[2.4.152 Legend [329](#legend-1)](#legend-1) + +[2.4.153 LegendException [330](#legendexception)](#legendexception) + +[2.4.154 Lel [331](#lel)](#lel) + +[2.4.155 Line [331](#line)](#line) + +[2.4.156 LineFormat [332](#lineformat)](#lineformat) + +[2.4.157 List12 [333](#list12)](#list12) + +[2.4.158 LPr [334](#lpr)](#lpr) + +[2.4.159 LRng [335](#lrng)](#lrng) + +[2.4.160 MarkerFormat [335](#markerformat)](#markerformat) + +[2.4.161 MDB [337](#mdb)](#mdb) + +[2.4.162 MDTInfo [337](#mdtinfo)](#mdtinfo) + +[2.4.163 MDXKPI [339](#mdxkpi)](#mdxkpi) + +[2.4.164 MDXProp [340](#mdxprop)](#mdxprop) + +[2.4.165 MDXSet [340](#mdxset)](#mdxset) + +[2.4.166 MDXStr [341](#mdxstr)](#mdxstr) + +[2.4.167 MDXTuple [342](#mdxtuple)](#mdxtuple) + +[2.4.168 MergeCells [342](#mergecells)](#mergecells) + +[2.4.169 Mms [343](#mms)](#mms) + +[2.4.170 MsoDrawing [343](#msodrawing)](#msodrawing) + +[2.4.171 MsoDrawingGroup [343](#msodrawinggroup)](#msodrawinggroup) + +[2.4.172 MsoDrawingSelection [344](#msodrawingselection)](#msodrawingselection) + +[2.4.173 MTRSettings [344](#mtrsettings)](#mtrsettings) + +[2.4.174 MulBlank [345](#mulblank)](#mulblank) + +[2.4.175 MulRk [345](#mulrk)](#mulrk) + +[2.4.176 NameCmt [346](#namecmt)](#namecmt) + +[2.4.177 NameFnGrp12 [347](#namefngrp12)](#namefngrp12) + +[2.4.178 NamePublish [348](#namepublish)](#namepublish) + +[2.4.179 Note [348](#note)](#note) + +[2.4.180 Number [349](#number)](#number) + +[2.4.181 Obj [349](#obj)](#obj) + +[2.4.182 ObjectLink [352](#objectlink)](#objectlink) + +[2.4.183 ObjProtect [352](#objprotect)](#objprotect) + +[2.4.184 ObNoMacros [353](#obnomacros)](#obnomacros) + +[2.4.185 ObProj [353](#obproj)](#obproj) + +[2.4.186 OleDbConn [353](#oledbconn)](#oledbconn) + +[2.4.187 OleObjectSize [354](#oleobjectsize)](#oleobjectsize) + +[2.4.188 Palette [354](#palette)](#palette) + +[2.4.189 Pane [354](#pane)](#pane) + +[2.4.190 ParamQry [355](#paramqry)](#paramqry) + +[2.4.191 Password [355](#password)](#password) + +[2.4.192 PhoneticInfo [356](#phoneticinfo)](#phoneticinfo) + +[2.4.193 PicF [356](#picf)](#picf) + +[2.4.194 Pie [357](#pie)](#pie) + +[2.4.195 PieFormat [358](#pieformat)](#pieformat) + +[2.4.196 PivotChartBits [358](#pivotchartbits)](#pivotchartbits) + +[2.4.197 PlotArea [359](#plotarea)](#plotarea) + +[2.4.198 PlotGrowth [359](#plotgrowth)](#plotgrowth) + +[2.4.199 Pls [359](#pls)](#pls) + +[2.4.200 PLV [360](#plv)](#plv) + +[2.4.201 Pos [360](#pos)](#pos) + +[2.4.202 PrintGrid [362](#printgrid)](#printgrid) + +[2.4.203 PrintRowCol [362](#printrowcol)](#printrowcol) + +[2.4.204 PrintSize [363](#printsize)](#printsize) + +[2.4.205 Prot4Rev [363](#prot4rev)](#prot4rev) + +[2.4.206 Prot4RevPass [364](#prot4revpass)](#prot4revpass) + +[2.4.207 Protect [364](#protect)](#protect) + +[2.4.208 Qsi [364](#qsi)](#qsi) + +[2.4.209 Qsif [367](#qsif)](#qsif) + +[2.4.210 Qsir [368](#qsir)](#qsir) + +[2.4.211 QsiSXTag [370](#qsisxtag)](#qsisxtag) + +[2.4.212 Radar [372](#radar)](#radar) + +[2.4.213 RadarArea [372](#radararea)](#radararea) + +[2.4.214 RealTimeData [373](#realtimedata)](#realtimedata) + +[2.4.215 RecalcId [374](#recalcid)](#recalcid) + +[2.4.216 RecipName [374](#recipname)](#recipname) + +[2.4.217 RefreshAll [375](#refreshall)](#refreshall) + +[2.4.218 RichTextStream [375](#richtextstream)](#richtextstream) + +[2.4.219 RightMargin [377](#rightmargin)](#rightmargin) + +[2.4.220 RK [377](#rk)](#rk) + +[2.4.221 Row [378](#row)](#row) + +[2.4.222 RRAutoFmt [379](#rrautofmt)](#rrautofmt) + +[2.4.223 RRDChgCell [380](#rrdchgcell)](#rrdchgcell) + +[2.4.224 RRDConflict [384](#rrdconflict)](#rrdconflict) + +[2.4.225 RRDDefName [385](#rrddefname)](#rrddefname) + +[2.4.226 RRDHead [387](#rrdhead)](#rrdhead) + +[2.4.227 RRDInfo [389](#rrdinfo)](#rrdinfo) + +[2.4.228 RRDInsDel [390](#rrdinsdel)](#rrdinsdel) + +[2.4.229 RRDInsDelBegin [391](#rrdinsdelbegin)](#rrdinsdelbegin) + +[2.4.230 RRDInsDelEnd [391](#rrdinsdelend)](#rrdinsdelend) + +[2.4.231 RRDMove [391](#rrdmove)](#rrdmove) + +[2.4.232 RRDMoveBegin [392](#rrdmovebegin)](#rrdmovebegin) + +[2.4.233 RRDMoveEnd [392](#rrdmoveend)](#rrdmoveend) + +[2.4.234 RRDRenSheet [392](#rrdrensheet)](#rrdrensheet) + +[2.4.235 RRDRstEtxp [393](#rrdrstetxp)](#rrdrstetxp) + +[2.4.236 RRDTQSIF [394](#rrdtqsif)](#rrdtqsif) + +[2.4.237 RRDUserView [395](#rrduserview)](#rrduserview) + +[2.4.238 RRFormat [396](#rrformat)](#rrformat) + +[2.4.239 RRInsertSh [396](#rrinsertsh)](#rrinsertsh) + +[2.4.240 RRSort [397](#rrsort)](#rrsort) + +[2.4.241 RRTabId [398](#rrtabid)](#rrtabid) + +[2.4.242 SBaseRef [398](#sbaseref)](#sbaseref) + +[2.4.243 Scatter [399](#scatter)](#scatter) + +[2.4.244 SCENARIO [400](#scenario)](#scenario) + +[2.4.245 ScenarioProtect [401](#scenarioprotect)](#scenarioprotect) + +[2.4.246 ScenMan [401](#scenman)](#scenman) + +[2.4.247 Scl [402](#scl)](#scl) + +[2.4.248 Selection [402](#selection)](#selection) + +[2.4.249 SerAuxErrBar [403](#serauxerrbar)](#serauxerrbar) + +[2.4.250 SerAuxTrend [404](#serauxtrend)](#serauxtrend) + +[2.4.251 SerFmt [405](#serfmt)](#serfmt) + +[2.4.252 Series [406](#series-1)](#series-1) + +[2.4.253 SeriesList [407](#serieslist)](#serieslist) + +[2.4.254 SeriesText [407](#seriestext)](#seriestext) + +[2.4.255 SerParent [407](#serparent)](#serparent) + +[2.4.256 SerToCrt [408](#sertocrt)](#sertocrt) + +[2.4.257 Setup [408](#setup)](#setup) + +[2.4.258 ShapePropsStream [413](#shapepropsstream)](#shapepropsstream) + +[2.4.259 SheetExt [414](#sheetext)](#sheetext) + +[2.4.260 ShrFmla [415](#shrfmla)](#shrfmla) + +[2.4.261 ShtProps [415](#shtprops)](#shtprops) + +[2.4.262 SIIndex [416](#siindex)](#siindex) + +[2.4.263 Sort [417](#sort)](#sort) + +[2.4.264 SortData [418](#sortdata)](#sortdata) + +[2.4.265 SST [420](#sst)](#sst) + +[2.4.266 StartBlock [421](#startblock)](#startblock) + +[2.4.267 StartObject [426](#startobject)](#startobject) + +[2.4.268 String [427](#string)](#string) + +[2.4.269 Style [427](#style)](#style) + +[2.4.270 StyleExt [428](#styleext)](#styleext) + +[2.4.271 SupBook [429](#supbook)](#supbook) + +[2.4.272 Surf [431](#surf)](#surf) + +[2.4.273 SXAddl Records [432](#sxaddl-records)](#sxaddl-records) + +[2.4.273.1 Continue_SxaddlSxString [432](#continue_sxaddlsxstring)](#continue_sxaddlsxstring) + +[2.4.273.2 SXAddl [432](#sxaddl)](#sxaddl) + +[2.4.273.3 SXAddl_SXCAutoSort_SXDEnd [433](#sxaddl_sxcautosort_sxdend)](#sxaddl_sxcautosort_sxdend) + +[2.4.273.4 SXAddl_SXCAutoSort_SXDId [433](#sxaddl_sxcautosort_sxdid)](#sxaddl_sxcautosort_sxdid) + +[2.4.273.5 SXAddl_SXCCache_SXDEnd [434](#sxaddl_sxccache_sxdend)](#sxaddl_sxccache_sxdend) + +[2.4.273.6 SXAddl_SXCCache_SXDId [434](#sxaddl_sxccache_sxdid)](#sxaddl_sxccache_sxdid) + +[2.4.273.7 SXAddl_SXCCache_SXDInfo12 [434](#sxaddl_sxccache_sxdinfo12)](#sxaddl_sxccache_sxdinfo12) + +[2.4.273.8 SXAddl_SXCCache_SXDInvRefreshReal [435](#sxaddl_sxccache_sxdinvrefreshreal)](#sxaddl_sxccache_sxdinvrefreshreal) + +[2.4.273.9 SXAddl_SXCCache_SXDVer10Info [435](#sxaddl_sxccache_sxdver10info)](#sxaddl_sxccache_sxdver10info) + +[2.4.273.10 SXAddl_SXCCache_SXDVerSXMacro [436](#sxaddl_sxccache_sxdversxmacro)](#sxaddl_sxccache_sxdversxmacro) + +[2.4.273.11 SXAddl_SXCCache_SXDVerUpdInv [437](#sxaddl_sxccache_sxdverupdinv)](#sxaddl_sxccache_sxdverupdinv) + +[2.4.273.12 SXAddl_SXCCacheField_SXDCaption [437](#sxaddl_sxccachefield_sxdcaption)](#sxaddl_sxccachefield_sxdcaption) + +[2.4.273.13 SXAddl_SXCCacheField_SXDEnd [437](#sxaddl_sxccachefield_sxdend)](#sxaddl_sxccachefield_sxdend) + +[2.4.273.14 SXAddl_SXCCacheField_SXDId [438](#sxaddl_sxccachefield_sxdid)](#sxaddl_sxccachefield_sxdid) + +[2.4.273.15 SXAddl_SXCCacheField_SXDIfdbMempropMap [438](#sxaddl_sxccachefield_sxdifdbmempropmap)](#sxaddl_sxccachefield_sxdifdbmempropmap) + +[2.4.273.16 SXAddl_SXCCacheField_SXDIfdbMpMapCount [439](#sxaddl_sxccachefield_sxdifdbmpmapcount)](#sxaddl_sxccachefield_sxdifdbmpmapcount) + +[2.4.273.17 SXAddl_SXCCacheField_SXDProperty [439](#sxaddl_sxccachefield_sxdproperty)](#sxaddl_sxccachefield_sxdproperty) + +[2.4.273.18 SXAddl_SXCCacheField_SXDPropName [440](#sxaddl_sxccachefield_sxdpropname)](#sxaddl_sxccachefield_sxdpropname) + +[2.4.273.19 SXAddl_SXCCacheField_SXDSxrmitmCount [440](#sxaddl_sxccachefield_sxdsxrmitmcount)](#sxaddl_sxccachefield_sxdsxrmitmcount) + +[2.4.273.20 SXAddl_SXCCacheItem_SXDEnd [441](#sxaddl_sxccacheitem_sxdend)](#sxaddl_sxccacheitem_sxdend) + +[2.4.273.21 SXAddl_SXCCacheItem_SXDId [441](#sxaddl_sxccacheitem_sxdid)](#sxaddl_sxccacheitem_sxdid) + +[2.4.273.22 SXAddl_SXCCacheItem_SXDItmMpMapCount [441](#sxaddl_sxccacheitem_sxditmmpmapcount)](#sxaddl_sxccacheitem_sxditmmpmapcount) + +[2.4.273.23 SXAddl_SXCCacheItem_SXDItmMpropMap [442](#sxaddl_sxccacheitem_sxditmmpropmap)](#sxaddl_sxccacheitem_sxditmmpropmap) + +[2.4.273.24 SXAddl_SXCCacheItem_SXDSxrmitmDisp [442](#sxaddl_sxccacheitem_sxdsxrmitmdisp)](#sxaddl_sxccacheitem_sxdsxrmitmdisp) + +[2.4.273.25 SXAddl_SXCField_SXDEnd [443](#sxaddl_sxcfield_sxdend)](#sxaddl_sxcfield_sxdend) + +[2.4.273.26 SXAddl_SXCField_SXDId [443](#sxaddl_sxcfield_sxdid)](#sxaddl_sxcfield_sxdid) + +[2.4.273.27 SXAddl_SXCField_SXDVer10Info [443](#sxaddl_sxcfield_sxdver10info)](#sxaddl_sxcfield_sxdver10info) + +[2.4.273.28 SXAddl_SXCField12_SXDAutoshow [444](#sxaddl_sxcfield12_sxdautoshow)](#sxaddl_sxcfield12_sxdautoshow) + +[2.4.273.29 SXAddl_SXCField12_SXDEnd [444](#sxaddl_sxcfield12_sxdend)](#sxaddl_sxcfield12_sxdend) + +[2.4.273.30 SXAddl_SXCField12_SXDId [445](#sxaddl_sxcfield12_sxdid)](#sxaddl_sxcfield12_sxdid) + +[2.4.273.31 SXAddl_SXCField12_SXDISXTH [445](#sxaddl_sxcfield12_sxdisxth)](#sxaddl_sxcfield12_sxdisxth) + +[2.4.273.32 SXAddl_SXCField12_SXDMemberCaption [446](#sxaddl_sxcfield12_sxdmembercaption)](#sxaddl_sxcfield12_sxdmembercaption) + +[2.4.273.33 SXAddl_SXCField12_SXDVer12Info [446](#sxaddl_sxcfield12_sxdver12info)](#sxaddl_sxcfield12_sxdver12info) + +[2.4.273.34 SXAddl_SXCField12_SXDVerUpdInv [447](#sxaddl_sxcfield12_sxdverupdinv)](#sxaddl_sxcfield12_sxdverupdinv) + +[2.4.273.35 SXAddl_SXCGroup_SXDEnd [447](#sxaddl_sxcgroup_sxdend)](#sxaddl_sxcgroup_sxdend) + +[2.4.273.36 SXAddl_SXCGroup_SXDGrpInfo [448](#sxaddl_sxcgroup_sxdgrpinfo)](#sxaddl_sxcgroup_sxdgrpinfo) + +[2.4.273.37 SXAddl_SXCGroup_SXDId [449](#sxaddl_sxcgroup_sxdid)](#sxaddl_sxcgroup_sxdid) + +[2.4.273.38 SXAddl_SXCGroup_SXDMember [449](#sxaddl_sxcgroup_sxdmember)](#sxaddl_sxcgroup_sxdmember) + +[2.4.273.39 SXAddl_SXCGrpLevel_SXDEnd [450](#sxaddl_sxcgrplevel_sxdend)](#sxaddl_sxcgrplevel_sxdend) + +[2.4.273.40 SXAddl_SXCGrpLevel_SXDGrpLevelInfo [450](#sxaddl_sxcgrplevel_sxdgrplevelinfo)](#sxaddl_sxcgrplevel_sxdgrplevelinfo) + +[2.4.273.41 SXAddl_SXCGrpLevel_SXDId [451](#sxaddl_sxcgrplevel_sxdid)](#sxaddl_sxcgrplevel_sxdid) + +[2.4.273.42 SXAddl_SXCHierarchy_SXDDisplayFolder [451](#sxaddl_sxchierarchy_sxddisplayfolder)](#sxaddl_sxchierarchy_sxddisplayfolder) + +[2.4.273.43 SXAddl_SXCHierarchy_SXDEnd [452](#sxaddl_sxchierarchy_sxdend)](#sxaddl_sxchierarchy_sxdend) + +[2.4.273.44 SXAddl_SXCHierarchy_SXDFilterMember [452](#sxaddl_sxchierarchy_sxdfiltermember)](#sxaddl_sxchierarchy_sxdfiltermember) + +[2.4.273.45 SXAddl_SXCHierarchy_SXDFilterMember12 [453](#sxaddl_sxchierarchy_sxdfiltermember12)](#sxaddl_sxchierarchy_sxdfiltermember12) + +[2.4.273.46 SXAddl_SXCHierarchy_SXDIconSet [454](#sxaddl_sxchierarchy_sxdiconset)](#sxaddl_sxchierarchy_sxdiconset) + +[2.4.273.47 SXAddl_SXCHierarchy_SXDId [454](#sxaddl_sxchierarchy_sxdid)](#sxaddl_sxchierarchy_sxdid) + +[2.4.273.48 SXAddl_SXCHierarchy_SXDInfo12 [455](#sxaddl_sxchierarchy_sxdinfo12)](#sxaddl_sxchierarchy_sxdinfo12) + +[2.4.273.49 SXAddl_SXCHierarchy_SXDKPIGoal [456](#sxaddl_sxchierarchy_sxdkpigoal)](#sxaddl_sxchierarchy_sxdkpigoal) + +[2.4.273.50 SXAddl_SXCHierarchy_SXDKPIStatus [456](#sxaddl_sxchierarchy_sxdkpistatus)](#sxaddl_sxchierarchy_sxdkpistatus) + +[2.4.273.51 SXAddl_SXCHierarchy_SXDKPITime [456](#sxaddl_sxchierarchy_sxdkpitime)](#sxaddl_sxchierarchy_sxdkpitime) + +[2.4.273.52 SXAddl_SXCHierarchy_SXDKPITrend [457](#sxaddl_sxchierarchy_sxdkpitrend)](#sxaddl_sxchierarchy_sxdkpitrend) + +[2.4.273.53 SXAddl_SXCHierarchy_SXDKPIValue [457](#sxaddl_sxchierarchy_sxdkpivalue)](#sxaddl_sxchierarchy_sxdkpivalue) + +[2.4.273.54 SXAddl_SXCHierarchy_SXDKPIWeight [458](#sxaddl_sxchierarchy_sxdkpiweight)](#sxaddl_sxchierarchy_sxdkpiweight) + +[2.4.273.55 SXAddl_SXCHierarchy_SXDMeasureGrp [458](#sxaddl_sxchierarchy_sxdmeasuregrp)](#sxaddl_sxchierarchy_sxdmeasuregrp) + +[2.4.273.56 SXAddl_SXCHierarchy_SXDParentKPI [459](#sxaddl_sxchierarchy_sxdparentkpi)](#sxaddl_sxchierarchy_sxdparentkpi) + +[2.4.273.57 SXAddl_SXCHierarchy_SXDProperty [459](#sxaddl_sxchierarchy_sxdproperty)](#sxaddl_sxchierarchy_sxdproperty) + +[2.4.273.58 SXAddl_SXCHierarchy_SXDSXSetParentUnique [461](#sxaddl_sxchierarchy_sxdsxsetparentunique)](#sxaddl_sxchierarchy_sxdsxsetparentunique) + +[2.4.273.59 SXAddl_SXCHierarchy_SXDUserCaption [461](#sxaddl_sxchierarchy_sxdusercaption)](#sxaddl_sxchierarchy_sxdusercaption) + +[2.4.273.60 SXAddl_SXCHierarchy_SXDVerUpdInv [461](#sxaddl_sxchierarchy_sxdverupdinv)](#sxaddl_sxchierarchy_sxdverupdinv) + +[2.4.273.61 SXAddl_SXCQsi_SXDEnd [462](#sxaddl_sxcqsi_sxdend)](#sxaddl_sxcqsi_sxdend) + +[2.4.273.62 SXAddl_SXCQsi_SXDId [462](#sxaddl_sxcqsi_sxdid)](#sxaddl_sxcqsi_sxdid) + +[2.4.273.63 SXAddl_SXCQuery_SXDEnd [462](#sxaddl_sxcquery_sxdend)](#sxaddl_sxcquery_sxdend) + +[2.4.273.64 SXAddl_SXCQuery_SXDReconnCond [463](#sxaddl_sxcquery_sxdreconncond)](#sxaddl_sxcquery_sxdreconncond) + +[2.4.273.65 SXAddl_SXCQuery_SXDSrcConnFile [464](#sxaddl_sxcquery_sxdsrcconnfile)](#sxaddl_sxcquery_sxdsrcconnfile) + +[2.4.273.66 SXAddl_SXCQuery_SXDSrcDataFile [464](#sxaddl_sxcquery_sxdsrcdatafile)](#sxaddl_sxcquery_sxdsrcdatafile) + +[2.4.273.67 SXAddl_SXCQuery_SXDXMLSource [464](#sxaddl_sxcquery_sxdxmlsource)](#sxaddl_sxcquery_sxdxmlsource) + +[2.4.273.68 SXAddl_SXCSXCondFmt_SXDEnd [465](#sxaddl_sxcsxcondfmt_sxdend)](#sxaddl_sxcsxcondfmt_sxdend) + +[2.4.273.69 SXAddl_SXCSXCondFmt_SXDSXCondFmt [465](#sxaddl_sxcsxcondfmt_sxdsxcondfmt)](#sxaddl_sxcsxcondfmt_sxdsxcondfmt) + +[2.4.273.70 SXAddl_SXCSXCondFmts_SXDEnd [466](#sxaddl_sxcsxcondfmts_sxdend)](#sxaddl_sxcsxcondfmts_sxdend) + +[2.4.273.71 SXAddl_SXCSXCondFmts_SXDId [467](#sxaddl_sxcsxcondfmts_sxdid)](#sxaddl_sxcsxcondfmts_sxdid) + +[2.4.273.72 SXAddl_SXCSXDH_SXDEnd [467](#sxaddl_sxcsxdh_sxdend)](#sxaddl_sxcsxdh_sxdend) + +[2.4.273.73 SXAddl_SXCSXDH_SXDId [468](#sxaddl_sxcsxdh_sxdid)](#sxaddl_sxcsxdh_sxdid) + +[2.4.273.74 SXAddl_SXCSXDH_SXDSxdh [468](#sxaddl_sxcsxdh_sxdsxdh)](#sxaddl_sxcsxdh_sxdsxdh) + +[2.4.273.75 SXAddl_SXCSXfilt_SXDEnd [469](#sxaddl_sxcsxfilt_sxdend)](#sxaddl_sxcsxfilt_sxdend) + +[2.4.273.76 SXAddl_SXCSXfilt_SXDId [470](#sxaddl_sxcsxfilt_sxdid)](#sxaddl_sxcsxfilt_sxdid) + +[2.4.273.77 SXAddl_SXCSXfilt_SXDSXfilt [470](#sxaddl_sxcsxfilt_sxdsxfilt)](#sxaddl_sxcsxfilt_sxdsxfilt) + +[2.4.273.78 SXAddl_SXCSXfilt_SXDSXItm [471](#sxaddl_sxcsxfilt_sxdsxitm)](#sxaddl_sxcsxfilt_sxdsxitm) + +[2.4.273.79 SXAddl_SXCSXFilter12_SXDCaption [472](#sxaddl_sxcsxfilter12_sxdcaption)](#sxaddl_sxcsxfilter12_sxdcaption) + +[2.4.273.80 SXAddl_SXCSXFilter12_SXDEnd [473](#sxaddl_sxcsxfilter12_sxdend)](#sxaddl_sxcsxfilter12_sxdend) + +[2.4.273.81 SXAddl_SXCSXFilter12_SXDId [473](#sxaddl_sxcsxfilter12_sxdid)](#sxaddl_sxcsxfilter12_sxdid) + +[2.4.273.82 SXAddl_SXCSXFilter12_SXDSXFilter [473](#sxaddl_sxcsxfilter12_sxdsxfilter)](#sxaddl_sxcsxfilter12_sxdsxfilter) + +[2.4.273.83 SXAddl_SXCSXFilter12_SXDSXFilterDesc [475](#sxaddl_sxcsxfilter12_sxdsxfilterdesc)](#sxaddl_sxcsxfilter12_sxdsxfilterdesc) + +[2.4.273.84 SXAddl_SXCSXFilter12_SXDSXFilterValue1 [475](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1)](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1) + +[2.4.273.85 SXAddl_SXCSXFilter12_SXDSXFilterValue2 [475](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2)](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2) + +[2.4.273.86 SXAddl_SXCSXFilter12_SXDXlsFilter [476](#sxaddl_sxcsxfilter12_sxdxlsfilter)](#sxaddl_sxcsxfilter12_sxdxlsfilter) + +[2.4.273.87 SXAddl_SXCSXFilter12_SXDXlsFilterValue1 [476](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1)](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1) + +[2.4.273.88 SXAddl_SXCSXFilter12_SXDXlsFilterValue2 [477](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2)](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2) + +[2.4.273.89 SXAddl_SXCSXFilters12_SXDEnd [477](#sxaddl_sxcsxfilters12_sxdend)](#sxaddl_sxcsxfilters12_sxdend) + +[2.4.273.90 SXAddl_SXCSXFilters12_SXDId [478](#sxaddl_sxcsxfilters12_sxdid)](#sxaddl_sxcsxfilters12_sxdid) + +[2.4.273.91 SXAddl_SXCSXMg_SXDEnd [478](#sxaddl_sxcsxmg_sxdend)](#sxaddl_sxcsxmg_sxdend) + +[2.4.273.92 SXAddl_SXCSXMg_SXDId [478](#sxaddl_sxcsxmg_sxdid)](#sxaddl_sxcsxmg_sxdid) + +[2.4.273.93 SXAddl_SXCSXMg_SXDUserCaption [479](#sxaddl_sxcsxmg_sxdusercaption)](#sxaddl_sxcsxmg_sxdusercaption) + +[2.4.273.94 SXAddl_SXCSXMgs_SXDEnd [479](#sxaddl_sxcsxmgs_sxdend)](#sxaddl_sxcsxmgs_sxdend) + +[2.4.273.95 SXAddl_SXCSXMgs_SXDId [479](#sxaddl_sxcsxmgs_sxdid)](#sxaddl_sxcsxmgs_sxdid) + +[2.4.273.96 SXAddl_SXCSXMgs_SXDMGrpSXDHMap [480](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap)](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap) + +[2.4.273.97 SXAddl_SXCSXrule_SXDEnd [481](#sxaddl_sxcsxrule_sxdend)](#sxaddl_sxcsxrule_sxdend) + +[2.4.273.98 SXAddl_SXCSXrule_SXDId [481](#sxaddl_sxcsxrule_sxdid)](#sxaddl_sxcsxrule_sxdid) + +[2.4.273.99 SXAddl_SXCSXrule_SXDSXrule [481](#sxaddl_sxcsxrule_sxdsxrule)](#sxaddl_sxcsxrule_sxdsxrule) + +[2.4.273.100 SXAddl_SXCView_SXDCalcMember [484](#sxaddl_sxcview_sxdcalcmember)](#sxaddl_sxcview_sxdcalcmember) + +[2.4.273.101 SXAddl_SXCView_SXDCalcMemString [486](#sxaddl_sxcview_sxdcalcmemstring)](#sxaddl_sxcview_sxdcalcmemstring) + +[2.4.273.102 SXAddl_SXCView_SXDCompactColHdr [486](#sxaddl_sxcview_sxdcompactcolhdr)](#sxaddl_sxcview_sxdcompactcolhdr) + +[2.4.273.103 SXAddl_SXCView_SXDCompactRwHdr [487](#sxaddl_sxcview_sxdcompactrwhdr)](#sxaddl_sxcview_sxdcompactrwhdr) + +[2.4.273.104 SXAddl_SXCView_SXDEnd [487](#sxaddl_sxcview_sxdend)](#sxaddl_sxcview_sxdend) + +[2.4.273.105 SXAddl_SXCView_SXDId [488](#sxaddl_sxcview_sxdid)](#sxaddl_sxcview_sxdid) + +[2.4.273.106 SXAddl_SXCView_SXDSXPIIvmb [488](#sxaddl_sxcview_sxdsxpiivmb)](#sxaddl_sxcview_sxdsxpiivmb) + +[2.4.273.107 SXAddl_SXCView_SXDTableStyleClient [489](#sxaddl_sxcview_sxdtablestyleclient)](#sxaddl_sxcview_sxdtablestyleclient) + +[2.4.273.108 SXAddl_SXCView_SXDVer10Info [489](#sxaddl_sxcview_sxdver10info)](#sxaddl_sxcview_sxdver10info) + +[2.4.273.109 SXAddl_SXCView_SXDVer12Info [491](#sxaddl_sxcview_sxdver12info)](#sxaddl_sxcview_sxdver12info) + +[2.4.273.110 SXAddl_SXCView_SXDVerUpdInv [493](#sxaddl_sxcview_sxdverupdinv)](#sxaddl_sxcview_sxdverupdinv) + +[2.4.274 SxBool [494](#sxbool)](#sxbool) + +[2.4.275 SXDB [494](#sxdb)](#sxdb) + +[2.4.276 SXDBB [495](#sxdbb)](#sxdbb) + +[2.4.277 SXDBEx [495](#sxdbex)](#sxdbex) + +[2.4.278 SXDI [496](#sxdi)](#sxdi) + +[2.4.279 SXDtr [498](#sxdtr)](#sxdtr) + +[2.4.280 SxDXF [498](#sxdxf)](#sxdxf) + +[2.4.281 SxErr [499](#sxerr)](#sxerr) + +[2.4.282 SXEx [499](#sxex)](#sxex) + +[2.4.283 SXFDB [502](#sxfdb)](#sxfdb) + +[2.4.284 SXFDBType [505](#sxfdbtype)](#sxfdbtype) + +[2.4.285 SxFilt [505](#sxfilt)](#sxfilt) + +[2.4.286 SxFmla [506](#sxfmla)](#sxfmla) + +[2.4.287 SxFormat [507](#sxformat)](#sxformat) + +[2.4.288 SXFormula [507](#sxformula)](#sxformula) + +[2.4.289 SXInt [507](#sxint)](#sxint) + +[2.4.290 SxIsxoper [508](#sxisxoper)](#sxisxoper) + +[2.4.291 SxItm [508](#sxitm)](#sxitm) + +[2.4.292 SxIvd [509](#sxivd)](#sxivd) + +[2.4.293 SXLI [510](#sxli)](#sxli) + +[2.4.294 SxName [510](#sxname)](#sxname) + +[2.4.295 SxNil [511](#sxnil)](#sxnil) + +[2.4.296 SXNum [511](#sxnum)](#sxnum) + +[2.4.297 SXPair [511](#sxpair)](#sxpair) + +[2.4.298 SXPI [512](#sxpi)](#sxpi) + +[2.4.299 SXPIEx [513](#sxpiex)](#sxpiex) + +[2.4.300 SXRng [513](#sxrng)](#sxrng) + +[2.4.301 SxRule [515](#sxrule)](#sxrule) + +[2.4.302 SxSelect [517](#sxselect)](#sxselect) + +[2.4.303 SXStreamID [519](#sxstreamid)](#sxstreamid) + +[2.4.304 SXString [519](#sxstring)](#sxstring) + +[2.4.305 SXTbl [519](#sxtbl)](#sxtbl) + +[2.4.306 SxTbpg [520](#sxtbpg)](#sxtbpg) + +[2.4.307 SXTBRGIITM [521](#sxtbrgiitm)](#sxtbrgiitm) + +[2.4.308 SXTH [521](#sxth)](#sxth) + +[2.4.309 Sxvd [524](#sxvd)](#sxvd) + +[2.4.310 SXVDEx [528](#sxvdex)](#sxvdex) + +[2.4.311 SXVDTEx [531](#sxvdtex)](#sxvdtex) + +[2.4.312 SXVI [532](#sxvi)](#sxvi) + +[2.4.313 SxView [534](#sxview)](#sxview) + +[2.4.314 SXViewEx [536](#sxviewex)](#sxviewex) + +[2.4.315 SXViewEx9 [537](#sxviewex9)](#sxviewex9) + +[2.4.316 SXViewLink [538](#sxviewlink)](#sxviewlink) + +[2.4.317 SXVS [539](#sxvs)](#sxvs) + +[2.4.318 Sync [539](#sync)](#sync) + +[2.4.319 Table [539](#table)](#table) + +[2.4.320 TableStyle [541](#tablestyle)](#tablestyle) + +[2.4.321 TableStyleElement [542](#tablestyleelement)](#tablestyleelement) + +[2.4.322 TableStyles [545](#tablestyles)](#tablestyles) + +[2.4.323 Template [546](#template)](#template) + +[2.4.324 Text [546](#text)](#text) + +[2.4.325 TextPropsStream [551](#textpropsstream)](#textpropsstream) + +[2.4.326 Theme [553](#theme)](#theme) + +[2.4.327 Tick [553](#tick)](#tick) + +[2.4.328 TopMargin [556](#topmargin)](#topmargin) + +[2.4.329 TxO [557](#txo)](#txo) + +[2.4.330 TxtQry [559](#txtqry)](#txtqry) + +[2.4.331 Uncalced [561](#uncalced)](#uncalced) + +[2.4.332 Units [561](#units)](#units) + +[2.4.333 UserBView [561](#userbview)](#userbview) + +[2.4.334 UserSViewBegin [565](#usersviewbegin)](#usersviewbegin) + +[2.4.335 UserSViewBegin_Chart [568](#usersviewbegin_chart)](#usersviewbegin_chart) + +[2.4.336 UserSViewEnd [570](#usersviewend)](#usersviewend) + +[2.4.337 UsesELFs [570](#useselfs)](#useselfs) + +[2.4.338 UsrChk [570](#usrchk)](#usrchk) + +[2.4.339 UsrExcl [571](#usrexcl)](#usrexcl) + +[2.4.340 UsrInfo [572](#usrinfo)](#usrinfo) + +[2.4.341 ValueRange [572](#valuerange)](#valuerange) + +[2.4.342 VCenter [575](#vcenter)](#vcenter) + +[2.4.343 VerticalPageBreaks [575](#verticalpagebreaks)](#verticalpagebreaks) + +[2.4.344 WebPub [575](#webpub)](#webpub) + +[2.4.345 Window1 [578](#window1)](#window1) + +[2.4.346 Window2 [579](#window2)](#window2) + +[2.4.347 WinProtect [581](#winprotect)](#winprotect) + +[2.4.348 WOpt [582](#wopt)](#wopt) + +[2.4.349 WriteAccess [583](#writeaccess)](#writeaccess) + +[2.4.350 WriteProtect [584](#writeprotect)](#writeprotect) + +[2.4.351 WsBool [584](#wsbool)](#wsbool) + +[2.4.352 XCT [585](#xct)](#xct) + +[2.4.353 XF [585](#xf)](#xf) + +[2.4.354 XFCRC [586](#xfcrc)](#xfcrc) + +[2.4.355 XFExt [586](#xfext)](#xfext) + +[2.4.356 YMult [587](#ymult)](#ymult) + +[2.5 Structures [588](#structures-1)](#structures-1) + +[2.5.1 AddinUdf [588](#addinudf)](#addinudf) + +[2.5.2 AF12CellIcon [588](#af12cellicon)](#af12cellicon) + +[2.5.3 AF12Criteria [589](#af12criteria)](#af12criteria) + +[2.5.4 AF12DateInfo [589](#af12dateinfo)](#af12dateinfo) + +[2.5.5 AFDOper [590](#afdoper)](#afdoper) + +[2.5.6 AFDOperBoolErr [591](#afdoperboolerr)](#afdoperboolerr) + +[2.5.7 AFDOperRk [592](#afdoperrk)](#afdoperrk) + +[2.5.8 AFDOperStr [592](#afdoperstr)](#afdoperstr) + +[2.5.9 AutoFmt8 [593](#autofmt8)](#autofmt8) + +[2.5.10 Bes [594](#bes)](#bes) + +[2.5.11 Bold [595](#bold)](#bold) + +[2.5.12 BookExt_Conditional11 [595](#bookext_conditional11)](#bookext_conditional11) + +[2.5.13 BookExt_Conditional12 [595](#bookext_conditional12)](#bookext_conditional12) + +[2.5.14 Boolean [596](#boolean)](#boolean) + +[2.5.15 BorderStyle [596](#borderstyle)](#borderstyle) + +[2.5.16 BuiltInStyle [597](#builtinstyle)](#builtinstyle) + +[2.5.17 CachedDiskHeader [597](#cacheddiskheader)](#cacheddiskheader) + +[2.5.18 Cch255 [598](#cch255)](#cch255) + +[2.5.19 Cell [598](#cell)](#cell) + +[2.5.20 CellXF [598](#cellxf)](#cellxf) + +[2.5.21 CFColor [602](#cfcolor)](#cfcolor) + +[2.5.22 CFDatabar [602](#cfdatabar)](#cfdatabar) + +[2.5.23 CFExAveragesTemplateParams [604](#cfexaveragestemplateparams)](#cfexaveragestemplateparams) + +[2.5.24 CFExDateTemplateParams [604](#cfexdatetemplateparams)](#cfexdatetemplateparams) + +[2.5.25 CFExDefaultTemplateParams [605](#cfexdefaulttemplateparams)](#cfexdefaulttemplateparams) + +[2.5.26 CFExFilterParams [605](#cfexfilterparams)](#cfexfilterparams) + +[2.5.27 CFExNonCF12 [606](#cfexnoncf12)](#cfexnoncf12) + +[2.5.28 CFExTemplateParams [608](#cfextemplateparams)](#cfextemplateparams) + +[2.5.29 CFExTextTemplateParams [609](#cfextexttemplateparams)](#cfextexttemplateparams) + +[2.5.30 CFFilter [609](#cffilter)](#cffilter) + +[2.5.31 CFFlag [610](#cfflag)](#cfflag) + +[2.5.32 CFGradient [611](#cfgradient)](#cfgradient) + +[2.5.33 CFGradientInterpItem [611](#cfgradientinterpitem)](#cfgradientinterpitem) + +[2.5.34 CFGradientItem [612](#cfgradientitem)](#cfgradientitem) + +[2.5.35 CFMStateItem [613](#cfmstateitem)](#cfmstateitem) + +[2.5.36 CFMultistate [613](#cfmultistate)](#cfmultistate) + +[2.5.37 CFrtId [614](#cfrtid)](#cfrtid) + +[2.5.38 CFT [615](#cft)](#cft) + +[2.5.39 CFVO [616](#cfvo)](#cfvo) + +[2.5.40 ChartNumNillable [617](#chartnumnillable)](#chartnumnillable) + +[2.5.41 Col [617](#col)](#col) + +[2.5.42 Col_NegativeOne [617](#col_negativeone)](#col_negativeone) + +[2.5.43 Col12 [618](#col12)](#col12) + +[2.5.44 Col256U [618](#col256u)](#col256u) + +[2.5.45 ColByte [618](#colbyte)](#colbyte) + +[2.5.46 ColByteU [619](#colbyteu)](#colbyteu) + +[2.5.47 ColElfU [619](#colelfu)](#colelfu) + +[2.5.48 ColorICV [619](#coloricv)](#coloricv) + +[2.5.49 ColorTheme [620](#colortheme)](#colortheme) + +[2.5.50 ColRelNegU [620](#colrelnegu)](#colrelnegu) + +[2.5.51 ColRelU [621](#colrelu)](#colrelu) + +[2.5.52 ColSlco8U [621](#colslco8u)](#colslco8u) + +[2.5.53 ColU [621](#colu)](#colu) + +[2.5.54 Colx [622](#colx)](#colx) + +[2.5.55 CondDataValue [622](#conddatavalue)](#conddatavalue) + +[2.5.56 CondFmtStructure [622](#condfmtstructure)](#condfmtstructure) + +[2.5.57 ConnGrbitDbt [623](#conngrbitdbt)](#conngrbitdbt) + +[2.5.58 ConnGrbitDbtAdo [623](#conngrbitdbtado)](#conngrbitdbtado) + +[2.5.59 ConnGrbitDbtOledb [624](#conngrbitdbtoledb)](#conngrbitdbtoledb) + +[2.5.60 ConnGrbitDbtWeb [625](#conngrbitdbtweb)](#conngrbitdbtweb) + +[2.5.61 ControlInfo [626](#controlinfo)](#controlinfo) + +[2.5.62 CrtLayout12Mode [626](#crtlayout12mode)](#crtlayout12mode) + +[2.5.63 DataFunctionalityLevel [627](#datafunctionalitylevel)](#datafunctionalitylevel) + +[2.5.64 DataSourceType [627](#datasourcetype)](#datasourcetype) + +[2.5.65 DateAsNum [627](#dateasnum)](#dateasnum) + +[2.5.66 DateUnit [627](#dateunit)](#dateunit) + +[2.5.67 DCol [628](#dcol)](#dcol) + +[2.5.68 DColByteU [628](#dcolbyteu)](#dcolbyteu) + +[2.5.69 DConFile [628](#dconfile)](#dconfile) + +[2.5.70 DConnConnectionOleDb [629](#dconnconnectionoledb)](#dconnconnectionoledb) + +[2.5.71 DConnConnectionWeb [630](#dconnconnectionweb)](#dconnconnectionweb) + +[2.5.72 DConnId [630](#dconnid)](#dconnid) + +[2.5.73 DConnParamBinding [631](#dconnparambinding)](#dconnparambinding) + +[2.5.74 DConnParamBindingValByte [631](#dconnparambindingvalbyte)](#dconnparambindingvalbyte) + +[2.5.75 DConnParamBindingValInt [631](#dconnparambindingvalint)](#dconnparambindingvalint) + +[2.5.76 DConnParamBindingValString [631](#dconnparambindingvalstring)](#dconnparambindingvalstring) + +[2.5.77 DConnParamBindingValType [632](#dconnparambindingvaltype)](#dconnparambindingvaltype) + +[2.5.78 DConnParameter [632](#dconnparameter)](#dconnparameter) + +[2.5.79 DConnStringSequence [633](#dconnstringsequence)](#dconnstringsequence) + +[2.5.80 DConnUnicodeStringSegmented [633](#dconnunicodestringsegmented)](#dconnunicodestringsegmented) + +[2.5.81 DJoin [634](#djoin)](#djoin) + +[2.5.82 DRw [634](#drw)](#drw) + +[2.5.83 DRwByteU [634](#drwbyteu)](#drwbyteu) + +[2.5.84 Duce [634](#duce)](#duce) + +[2.5.85 DuceRadical [635](#duceradical)](#duceradical) + +[2.5.86 DuceStacked [636](#ducestacked)](#ducestacked) + +[2.5.87 Ducr [636](#ducr)](#ducr) + +[2.5.88 DucrConditionalLbl [637](#ducrconditionallbl)](#ducrconditionallbl) + +[2.5.89 DucrConditionalNoLbl [638](#ducrconditionalnolbl)](#ducrconditionalnolbl) + +[2.5.90 DwQsiFuture [638](#dwqsifuture)](#dwqsifuture) + +[2.5.91 DXFALC [639](#dxfalc)](#dxfalc) + +[2.5.92 DXFBdr [640](#dxfbdr)](#dxfbdr) + +[2.5.93 DXFFntD [641](#dxffntd)](#dxffntd) + +[2.5.94 DXFId [642](#dxfid)](#dxfid) + +[2.5.95 DXFN [642](#dxfn)](#dxfn) + +[2.5.96 DXFN12 [645](#dxfn12)](#dxfn12) + +[2.5.97 DXFN12List [646](#dxfn12list)](#dxfn12list) + +[2.5.98 DXFN12NoCB [646](#dxfn12nocb)](#dxfn12nocb) + +[2.5.99 DXFNum [646](#dxfnum)](#dxfnum) + +[2.5.100 DXFNumIFmt [647](#dxfnumifmt)](#dxfnumifmt) + +[2.5.101 DXFNumUsr [647](#dxfnumusr)](#dxfnumusr) + +[2.5.102 DXFPat [647](#dxfpat)](#dxfpat) + +[2.5.103 DXFProt [648](#dxfprot)](#dxfprot) + +[2.5.104 EnhancedProtection [648](#enhancedprotection)](#enhancedprotection) + +[2.5.105 ExternDdeLinkNoOper [649](#externddelinknooper)](#externddelinknooper) + +[2.5.106 ExternDocName [649](#externdocname)](#externdocname) + +[2.5.107 ExternOleDdeLink [650](#externoleddelink)](#externoleddelink) + +[2.5.108 ExtProp [650](#extprop)](#extprop) + +[2.5.109 ExtRst [651](#extrst)](#extrst) + +[2.5.110 FactoidData [652](#factoiddata)](#factoiddata) + +[2.5.111 Feat11CellStruct [652](#feat11cellstruct)](#feat11cellstruct) + +[2.5.112 Feat11FdaAutoFilter [652](#feat11fdaautofilter)](#feat11fdaautofilter) + +[2.5.113 Feat11FieldDataItem [653](#feat11fielddataitem)](#feat11fielddataitem) + +[2.5.114 Feat11Fmla [660](#feat11fmla)](#feat11fmla) + +[2.5.115 Feat11RgInvalidCells [660](#feat11rginvalidcells)](#feat11rginvalidcells) + +[2.5.116 Feat11RgSharepointIdChange [660](#feat11rgsharepointidchange)](#feat11rgsharepointidchange) + +[2.5.117 Feat11RgSharepointIdDel [661](#feat11rgsharepointiddel)](#feat11rgsharepointiddel) + +[2.5.118 Feat11TotalFmla [661](#feat11totalfmla)](#feat11totalfmla) + +[2.5.119 Feat11WSSListInfo [661](#feat11wsslistinfo)](#feat11wsslistinfo) + +[2.5.120 Feat11XMap [664](#feat11xmap)](#feat11xmap) + +[2.5.121 Feat11XMapEntry [664](#feat11xmapentry)](#feat11xmapentry) + +[2.5.122 Feat11XMapEntry2 [665](#feat11xmapentry2)](#feat11xmapentry2) + +[2.5.123 FeatFormulaErr2 [665](#featformulaerr2)](#featformulaerr2) + +[2.5.124 FeatProtection [665](#featprotection)](#featprotection) + +[2.5.125 FeatSmartTag [666](#featsmarttag)](#featsmarttag) + +[2.5.126 FFErrorCheck [667](#fferrorcheck)](#fferrorcheck) + +[2.5.127 FillPattern [667](#fillpattern)](#fillpattern) + +[2.5.128 FillStylePropertiesForShapePropsStreamChecksum [668](#fillstylepropertiesforshapepropsstreamchecksum)](#fillstylepropertiesforshapepropsstreamchecksum) + +[2.5.129 FontIndex [678](#fontindex)](#fontindex) + +[2.5.130 FontInfo [678](#fontinfo)](#fontinfo) + +[2.5.131 FontScheme [679](#fontscheme)](#fontscheme) + +[2.5.132 FormatRun [679](#formatrun)](#formatrun) + +[2.5.133 FormulaValue [679](#formulavalue)](#formulavalue) + +[2.5.134 FrtFlags [680](#frtflags)](#frtflags) + +[2.5.135 FrtHeader [681](#frtheader)](#frtheader) + +[2.5.136 FrtHeaderOld [681](#frtheaderold)](#frtheaderold) + +[2.5.137 FrtRefHeader [681](#frtrefheader)](#frtrefheader) + +[2.5.138 FrtRefHeaderNoGrbit [682](#frtrefheadernogrbit)](#frtrefheadernogrbit) + +[2.5.139 FrtRefHeaderU [682](#frtrefheaderu)](#frtrefheaderu) + +[2.5.140 FtCbls [683](#ftcbls)](#ftcbls) + +[2.5.141 FtCblsData [683](#ftcblsdata)](#ftcblsdata) + +[2.5.142 FtCf [684](#ftcf)](#ftcf) + +[2.5.143 FtCmo [684](#ftcmo)](#ftcmo) + +[2.5.144 FtEdoData [687](#ftedodata)](#ftedodata) + +[2.5.145 FtGboData [688](#ftgbodata)](#ftgbodata) + +[2.5.146 FtGmo [688](#ftgmo)](#ftgmo) + +[2.5.147 FtLbsData [689](#ftlbsdata)](#ftlbsdata) + +[2.5.148 FtMacro [691](#ftmacro)](#ftmacro) + +[2.5.149 FtNts [692](#ftnts)](#ftnts) + +[2.5.150 FtPictFmla [692](#ftpictfmla)](#ftpictfmla) + +[2.5.151 FtPioGrbit [693](#ftpiogrbit)](#ftpiogrbit) + +[2.5.152 FtRbo [695](#ftrbo)](#ftrbo) + +[2.5.153 FtRboData [695](#ftrbodata)](#ftrbodata) + +[2.5.154 FtSbs [696](#ftsbs)](#ftsbs) + +[2.5.155 FullColorExt [697](#fullcolorext)](#fullcolorext) + +[2.5.156 GradStop [697](#gradstop)](#gradstop) + +[2.5.157 HiddenMemberSet [698](#hiddenmemberset)](#hiddenmemberset) + +[2.5.158 HideObjEnum [698](#hideobjenum)](#hideobjenum) + +[2.5.159 HorizAlign [699](#horizalign)](#horizalign) + +[2.5.160 HorzBrk [699](#horzbrk)](#horzbrk) + +[2.5.161 Icv [699](#icv)](#icv) + +[2.5.162 IcvChart [703](#icvchart)](#icvchart) + +[2.5.163 IcvFont [703](#icvfont)](#icvfont) + +[2.5.164 IcvXF [703](#icvxf)](#icvxf) + +[2.5.165 IFmt [703](#ifmt)](#ifmt) + +[2.5.166 InteriorColorPropertiesForShapePropsStreamChecksum [704](#interiorcolorpropertiesforshapepropsstreamchecksum)](#interiorcolorpropertiesforshapepropsstreamchecksum) + +[2.5.167 ISSTInf [705](#isstinf)](#isstinf) + +[2.5.168 IXFCell [705](#ixfcell)](#ixfcell) + +[2.5.169 KPIProp [705](#kpiprop)](#kpiprop) + +[2.5.170 KPISets [706](#kpisets)](#kpisets) + +[2.5.171 LbsDropData [706](#lbsdropdata)](#lbsdropdata) + +[2.5.172 LEMMode [707](#lemmode)](#lemmode) + +[2.5.173 LinePropertiesForShapePropsStreamChecksum [708](#linepropertiesforshapepropsstreamchecksum)](#linepropertiesforshapepropsstreamchecksum) + +[2.5.174 List12BlockLevel [709](#list12blocklevel)](#list12blocklevel) + +[2.5.175 List12DisplayName [711](#list12displayname)](#list12displayname) + +[2.5.176 List12TableStyleClientInfo [712](#list12tablestyleclientinfo)](#list12tablestyleclientinfo) + +[2.5.177 LongRGB [712](#longrgb)](#longrgb) + +[2.5.178 LongRGBA [713](#longrgba)](#longrgba) + +[2.5.179 LPWideString [713](#lpwidestring)](#lpwidestring) + +[2.5.180 MDir [713](#mdir)](#mdir) + +[2.5.181 MDTInfoIndex [714](#mdtinfoindex)](#mdtinfoindex) + +[2.5.182 MDXStrIndex [714](#mdxstrindex)](#mdxstrindex) + +[2.5.183 MOper [714](#moper)](#moper) + +[2.5.184 NilChartNum [715](#nilchartnum)](#nilchartnum) + +[2.5.185 NoteRR [715](#noterr)](#noterr) + +[2.5.186 NoteSh [716](#notesh)](#notesh) + +[2.5.187 ObjFmla [717](#objfmla)](#objfmla) + +[2.5.188 ObjId [718](#objid)](#objid) + +[2.5.189 ObjLinkFmla [718](#objlinkfmla)](#objlinkfmla) + +[2.5.190 ODBCType [719](#odbctype)](#odbctype) + +[2.5.191 OfficeArtClientAnchorChart [719](#officeartclientanchorchart)](#officeartclientanchorchart) + +[2.5.192 OfficeArtClientAnchorHF [720](#officeartclientanchorhf)](#officeartclientanchorhf) + +[2.5.193 OfficeArtClientAnchorSheet [721](#officeartclientanchorsheet)](#officeartclientanchorsheet) + +[2.5.194 OfficeArtClientData [722](#officeartclientdata)](#officeartclientdata) + +[2.5.195 OfficeArtClientTextbox [723](#officeartclienttextbox)](#officeartclienttextbox) + +[2.5.196 PaneType [723](#panetype)](#panetype) + +[2.5.197 PARAMQRY_Fixed [724](#paramqry_fixed)](#paramqry_fixed) + +[2.5.198 Parsed Expressions [725](#parsed-expressions)](#parsed-expressions) + +[2.5.198.1 ArrayParsedFormula [725](#arrayparsedformula)](#arrayparsedformula) + +[2.5.198.2 BErr [725](#berr)](#berr) + +[2.5.198.3 CellParsedFormula [726](#cellparsedformula)](#cellparsedformula) + +[2.5.198.4 Cetab [726](#cetab)](#cetab) + +[2.5.198.5 CFParsedFormula [755](#cfparsedformula)](#cfparsedformula) + +[2.5.198.6 CFParsedFormulaNoCCE [755](#cfparsedformulanocce)](#cfparsedformulanocce) + +[2.5.198.7 CFVOParsedFormula [755](#cfvoparsedformula)](#cfvoparsedformula) + +[2.5.198.8 ChartParsedFormula [756](#chartparsedformula)](#chartparsedformula) + +[2.5.198.9 DVParsedFormula [756](#dvparsedformula)](#dvparsedformula) + +[2.5.198.10 ExtNameParsedFormula [757](#extnameparsedformula)](#extnameparsedformula) + +[2.5.198.11 ExtPtgArea3D [758](#extptgarea3d)](#extptgarea3d) + +[2.5.198.12 ExtPtgAreaErr3D [758](#extptgareaerr3d)](#extptgareaerr3d) + +[2.5.198.13 ExtPtgErr [758](#extptgerr)](#extptgerr) + +[2.5.198.14 ExtPtgRef3D [759](#extptgref3d)](#extptgref3d) + +[2.5.198.15 ExtPtgRefErr3D [759](#extptgreferr3d)](#extptgreferr3d) + +[2.5.198.16 ExtSheetPair [759](#extsheetpair)](#extsheetpair) + +[2.5.198.17 Ftab [760](#ftab)](#ftab) + +[2.5.198.18 Ilel [787](#ilel)](#ilel) + +[2.5.198.19 ListParsedArrayFormula [788](#listparsedarrayformula)](#listparsedarrayformula) + +[2.5.198.20 ListParsedFormula [788](#listparsedformula)](#listparsedformula) + +[2.5.198.21 NameParsedFormula [788](#nameparsedformula)](#nameparsedformula) + +[2.5.198.22 ObjectParsedFormula [789](#objectparsedformula)](#objectparsedformula) + +[2.5.198.23 ParameterParsedFormula [789](#parameterparsedformula)](#parameterparsedformula) + +[2.5.198.24 PivotParsedFormula [790](#pivotparsedformula)](#pivotparsedformula) + +[2.5.198.25 Ptg [790](#ptg)](#ptg) + +[2.5.198.26 PtgAdd [793](#ptgadd)](#ptgadd) + +[2.5.198.27 PtgArea [793](#ptgarea)](#ptgarea) + +[2.5.198.28 PtgArea3d [794](#ptgarea3d)](#ptgarea3d) + +[2.5.198.29 PtgAreaErr [794](#ptgareaerr)](#ptgareaerr) + +[2.5.198.30 PtgAreaErr3d [795](#ptgareaerr3d)](#ptgareaerr3d) + +[2.5.198.31 PtgAreaN [795](#ptgarean)](#ptgarean) + +[2.5.198.32 PtgArray [796](#ptgarray)](#ptgarray) + +[2.5.198.33 PtgAttrBaxcel [796](#ptgattrbaxcel)](#ptgattrbaxcel) + +[2.5.198.34 PtgAttrChoose [797](#ptgattrchoose)](#ptgattrchoose) + +[2.5.198.35 PtgAttrGoto [797](#ptgattrgoto)](#ptgattrgoto) + +[2.5.198.36 PtgAttrIf [798](#ptgattrif)](#ptgattrif) + +[2.5.198.37 PtgAttrSemi [798](#ptgattrsemi)](#ptgattrsemi) + +[2.5.198.38 PtgAttrSpace [798](#ptgattrspace)](#ptgattrspace) + +[2.5.198.39 PtgAttrSpaceSemi [799](#ptgattrspacesemi)](#ptgattrspacesemi) + +[2.5.198.40 PtgAttrSpaceType [799](#ptgattrspacetype)](#ptgattrspacetype) + +[2.5.198.41 PtgAttrSum [800](#ptgattrsum)](#ptgattrsum) + +[2.5.198.42 PtgBool [800](#ptgbool)](#ptgbool) + +[2.5.198.43 PtgConcat [800](#ptgconcat)](#ptgconcat) + +[2.5.198.44 PtgDataType [800](#ptgdatatype)](#ptgdatatype) + +[2.5.198.45 PtgDiv [801](#ptgdiv)](#ptgdiv) + +[2.5.198.46 PtgElfCol [801](#ptgelfcol)](#ptgelfcol) + +[2.5.198.47 PtgElfColS [801](#ptgelfcols)](#ptgelfcols) + +[2.5.198.48 PtgElfColSV [802](#ptgelfcolsv)](#ptgelfcolsv) + +[2.5.198.49 PtgElfColV [802](#ptgelfcolv)](#ptgelfcolv) + +[2.5.198.50 PtgElfLel [802](#ptgelflel)](#ptgelflel) + +[2.5.198.51 PtgElfRadical [803](#ptgelfradical)](#ptgelfradical) + +[2.5.198.52 PtgElfRadicalLel [803](#ptgelfradicallel)](#ptgelfradicallel) + +[2.5.198.53 PtgElfRadicalS [804](#ptgelfradicals)](#ptgelfradicals) + +[2.5.198.54 PtgElfRw [804](#ptgelfrw)](#ptgelfrw) + +[2.5.198.55 PtgElfRwV [805](#ptgelfrwv)](#ptgelfrwv) + +[2.5.198.56 PtgEq [805](#ptgeq)](#ptgeq) + +[2.5.198.57 PtgErr [805](#ptgerr)](#ptgerr) + +[2.5.198.58 PtgExp [805](#ptgexp)](#ptgexp) + +[2.5.198.59 PtgExtraArray [806](#ptgextraarray)](#ptgextraarray) + +[2.5.198.60 PtgExtraElf [806](#ptgextraelf)](#ptgextraelf) + +[2.5.198.61 PtgExtraMem [807](#ptgextramem)](#ptgextramem) + +[2.5.198.62 PtgFunc [807](#ptgfunc)](#ptgfunc) + +[2.5.198.63 PtgFuncVar [807](#ptgfuncvar)](#ptgfuncvar) + +[2.5.198.64 PtgGe [808](#ptgge)](#ptgge) + +[2.5.198.65 PtgGt [808](#ptggt)](#ptggt) + +[2.5.198.66 PtgInt [808](#ptgint)](#ptgint) + +[2.5.198.67 PtgIsect [809](#ptgisect)](#ptgisect) + +[2.5.198.68 PtgLe [809](#ptgle)](#ptgle) + +[2.5.198.69 PtgLt [809](#ptglt)](#ptglt) + +[2.5.198.70 PtgMemArea [809](#ptgmemarea)](#ptgmemarea) + +[2.5.198.71 PtgMemErr [810](#ptgmemerr)](#ptgmemerr) + +[2.5.198.72 PtgMemFunc [810](#ptgmemfunc)](#ptgmemfunc) + +[2.5.198.73 PtgMemNoMem [811](#ptgmemnomem)](#ptgmemnomem) + +[2.5.198.74 PtgMissArg [811](#ptgmissarg)](#ptgmissarg) + +[2.5.198.75 PtgMul [811](#ptgmul)](#ptgmul) + +[2.5.198.76 PtgName [812](#ptgname)](#ptgname) + +[2.5.198.77 PtgNameX [812](#ptgnamex)](#ptgnamex) + +[2.5.198.78 PtgNe [813](#ptgne)](#ptgne) + +[2.5.198.79 PtgNum [813](#ptgnum)](#ptgnum) + +[2.5.198.80 PtgParen [813](#ptgparen)](#ptgparen) + +[2.5.198.81 PtgPercent [814](#ptgpercent)](#ptgpercent) + +[2.5.198.82 PtgPower [814](#ptgpower)](#ptgpower) + +[2.5.198.83 PtgRange [814](#ptgrange)](#ptgrange) + +[2.5.198.84 PtgRef [814](#ptgref)](#ptgref) + +[2.5.198.85 PtgRef3d [815](#ptgref3d)](#ptgref3d) + +[2.5.198.86 PtgRefErr [815](#ptgreferr)](#ptgreferr) + +[2.5.198.87 PtgRefErr3d [816](#ptgreferr3d)](#ptgreferr3d) + +[2.5.198.88 PtgRefN [816](#ptgrefn)](#ptgrefn) + +[2.5.198.89 PtgStr [816](#ptgstr)](#ptgstr) + +[2.5.198.90 PtgSub [817](#ptgsub)](#ptgsub) + +[2.5.198.91 PtgSxName [817](#ptgsxname)](#ptgsxname) + +[2.5.198.92 PtgTbl [817](#ptgtbl)](#ptgtbl) + +[2.5.198.93 PtgUminus [818](#ptguminus)](#ptguminus) + +[2.5.198.94 PtgUnion [818](#ptgunion)](#ptgunion) + +[2.5.198.95 PtgUplus [818](#ptguplus)](#ptguplus) + +[2.5.198.96 RevExtern [819](#revextern)](#revextern) + +[2.5.198.97 RevItab [819](#revitab)](#revitab) + +[2.5.198.98 RevLblName [820](#revlblname)](#revlblname) + +[2.5.198.99 RevName [821](#revname)](#revname) + +[2.5.198.100 RevNamePly [822](#revnameply)](#revnameply) + +[2.5.198.101 RevNameTabid [822](#revnametabid)](#revnametabid) + +[2.5.198.102 RevSheetName [822](#revsheetname)](#revsheetname) + +[2.5.198.103 RgbExtra [823](#rgbextra)](#rgbextra) + +[2.5.198.104 Rgce [824](#rgce)](#rgce) + +[2.5.198.105 RgceArea [827](#rgcearea)](#rgcearea) + +[2.5.198.106 RgceAreaRel [828](#rgcearearel)](#rgcearearel) + +[2.5.198.107 RgceElfLoc [828](#rgceelfloc)](#rgceelfloc) + +[2.5.198.108 RgceElfLocExtra [829](#rgceelflocextra)](#rgceelflocextra) + +[2.5.198.109 RgceLoc [829](#rgceloc)](#rgceloc) + +[2.5.198.110 RgceLoc8 [829](#rgceloc8)](#rgceloc8) + +[2.5.198.111 RgceLocRel [829](#rgcelocrel)](#rgcelocrel) + +[2.5.198.112 SerAr [830](#serar)](#serar) + +[2.5.198.113 SerBool [830](#serbool)](#serbool) + +[2.5.198.114 SerErr [831](#sererr)](#sererr) + +[2.5.198.115 SerNil [831](#sernil)](#sernil) + +[2.5.198.116 SerNum [831](#sernum)](#sernum) + +[2.5.198.117 SerStr [832](#serstr)](#serstr) + +[2.5.198.118 SharedParsedFormula [832](#sharedparsedformula)](#sharedparsedformula) + +[2.5.198.119 XtiIndex [833](#xtiindex)](#xtiindex) + +[2.5.199 PBT [833](#pbt)](#pbt) + +[2.5.200 PhRuns [834](#phruns)](#phruns) + +[2.5.201 Phs [834](#phs)](#phs) + +[2.5.202 PictFmlaEmbedInfo [835](#pictfmlaembedinfo)](#pictfmlaembedinfo) + +[2.5.203 PictFmlaKey [835](#pictfmlakey)](#pictfmlakey) + +[2.5.204 PivotCompProp [836](#pivotcompprop)](#pivotcompprop) + +[2.5.205 PositionMode [836](#positionmode)](#positionmode) + +[2.5.206 ReadingOrder [836](#readingorder)](#readingorder) + +[2.5.207 Ref [837](#ref)](#ref) + +[2.5.208 Ref8 [837](#ref8)](#ref8) + +[2.5.209 Ref8U [838](#ref8u)](#ref8u) + +[2.5.210 Ref8U2007 [838](#ref8u2007)](#ref8u2007) + +[2.5.211 RefU [839](#refu)](#refu) + +[2.5.212 RevisionType [839](#revisiontype)](#revisiontype) + +[2.5.213 RFX [840](#rfx)](#rfx) + +[2.5.214 RichTextStreamChecksumData [840](#richtextstreamchecksumdata)](#richtextstreamchecksumdata) + +[2.5.215 RichTextStreamChecksumFontInformation [842](#richtextstreamchecksumfontinformation)](#richtextstreamchecksumfontinformation) + +[2.5.216 RichTextStreamChecksumFontInformationArrayItem [844](#richtextstreamchecksumfontinformationarrayitem)](#richtextstreamchecksumfontinformationarrayitem) + +[2.5.217 RkNumber [844](#rknumber)](#rknumber) + +[2.5.218 RkRec [845](#rkrec)](#rkrec) + +[2.5.219 RPHSSub [845](#rphssub)](#rphssub) + +[2.5.220 RRD [846](#rrd)](#rrd) + +[2.5.221 RRDDefNameFlags [846](#rrddefnameflags)](#rrddefnameflags) + +[2.5.222 RRLoc [848](#rrloc)](#rrloc) + +[2.5.223 RTDEItem [848](#rtdeitem)](#rtdeitem) + +[2.5.224 RTDOper [848](#rtdoper)](#rtdoper) + +[2.5.225 RTDOperStr [849](#rtdoperstr)](#rtdoperstr) + +[2.5.226 Run [849](#run)](#run) + +[2.5.227 Rw [849](#rw)](#rw) + +[2.5.228 Rw12 [850](#rw12)](#rw12) + +[2.5.229 RwLongU [850](#rwlongu)](#rwlongu) + +[2.5.230 RwU [850](#rwu)](#rwu) + +[2.5.231 Rwx [850](#rwx)](#rwx) + +[2.5.232 Script [851](#script)](#script) + +[2.5.233 SD_SetSortOrder [851](#sd_setsortorder)](#sd_setsortorder) + +[2.5.234 SDContainer [851](#sdcontainer)](#sdcontainer) + +[2.5.235 SecurityDescriptor [852](#securitydescriptor)](#securitydescriptor) + +[2.5.236 ShapePropsStreamChecksumData [852](#shapepropsstreamchecksumdata)](#shapepropsstreamchecksumdata) + +[2.5.237 SharedFeatureType [853](#sharedfeaturetype)](#sharedfeaturetype) + +[2.5.238 SheetExtOptional [854](#sheetextoptional)](#sheetextoptional) + +[2.5.239 ShortDTR [855](#shortdtr)](#shortdtr) + +[2.5.240 ShortXLUnicodeString [855](#shortxlunicodestring)](#shortxlunicodestring) + +[2.5.241 SLCO8 [856](#slco8)](#slco8) + +[2.5.242 SortCond12 [856](#sortcond12)](#sortcond12) + +[2.5.243 SortItem [857](#sortitem)](#sortitem) + +[2.5.244 SourceType [858](#sourcetype)](#sourcetype) + +[2.5.245 SQElfFlags [858](#sqelfflags)](#sqelfflags) + +[2.5.246 SqRef [858](#sqref)](#sqref) + +[2.5.247 SqRefU [859](#sqrefu)](#sqrefu) + +[2.5.248 Stxp [859](#stxp)](#stxp) + +[2.5.249 StyleXF [860](#stylexf)](#stylexf) + +[2.5.250 SXAddl_SXDEnd [862](#sxaddl_sxdend)](#sxaddl_sxdend) + +[2.5.251 SXAddl_SXDVerUpdInv [862](#sxaddl_sxdverupdinv)](#sxaddl_sxdverupdinv) + +[2.5.252 SXAddl_SXString [862](#sxaddl_sxstring)](#sxaddl_sxstring) + +[2.5.253 SXAddlHdr [863](#sxaddlhdr)](#sxaddlhdr) + +[2.5.254 SXAxis [863](#sxaxis)](#sxaxis) + +[2.5.255 SXEZDoper [863](#sxezdoper)](#sxezdoper) + +[2.5.256 SxFT [864](#sxft)](#sxft) + +[2.5.257 SxIvdCol [868](#sxivdcol)](#sxivdcol) + +[2.5.258 SxIvdRw [868](#sxivdrw)](#sxivdrw) + +[2.5.259 SXLIItem [868](#sxliitem)](#sxliitem) + +[2.5.260 SXPI_Item [871](#sxpi_item)](#sxpi_item) + +[2.5.261 SXVDEx_Opt [871](#sxvdex_opt)](#sxvdex_opt) + +[2.5.262 SXView9Save [872](#sxview9save)](#sxview9save) + +[2.5.263 SXVIFlags [872](#sxviflags)](#sxviflags) + +[2.5.264 TabId [873](#tabid)](#tabid) + +[2.5.265 TabIndex [873](#tabindex)](#tabindex) + +[2.5.266 TableFeatureType [873](#tablefeaturetype)](#tablefeaturetype) + +[2.5.267 Tag_Fn_MDX [877](#tag_fn_mdx)](#tag_fn_mdx) + +[2.5.268 TextPropsStreamChecksumData [878](#textpropsstreamchecksumdata)](#textpropsstreamchecksumdata) + +[2.5.269 Top10FT [880](#top10ft)](#top10ft) + +[2.5.270 Ts [880](#ts)](#ts) + +[2.5.271 TxOLastRun [880](#txolastrun)](#txolastrun) + +[2.5.272 TxORuns [881](#txoruns)](#txoruns) + +[2.5.273 TxtWf [881](#txtwf)](#txtwf) + +[2.5.274 Underline [882](#underline)](#underline) + +[2.5.275 VertAlign [882](#vertalign)](#vertalign) + +[2.5.276 VertBrk [882](#vertbrk)](#vertbrk) + +[2.5.277 VirtualPath [882](#virtualpath)](#virtualpath) + +[2.5.278 WebPubString [884](#webpubstring)](#webpubstring) + +[2.5.279 XColorType [885](#xcolortype)](#xcolortype) + +[2.5.280 XFExtGradient [885](#xfextgradient)](#xfextgradient) + +[2.5.281 XFExtNoFRT [886](#xfextnofrt)](#xfextnofrt) + +[2.5.282 XFIndex [886](#xfindex)](#xfindex) + +[2.5.283 XFProp [888](#xfprop)](#xfprop) + +[2.5.284 XFPropBorder [890](#xfpropborder)](#xfpropborder) + +[2.5.285 XFPropColor [890](#xfpropcolor)](#xfpropcolor) + +[2.5.286 XFPropGradient [891](#xfpropgradient)](#xfpropgradient) + +[2.5.287 XFPropGradientStop [892](#xfpropgradientstop)](#xfpropgradientstop) + +[2.5.288 XFProps [892](#xfprops)](#xfprops) + +[2.5.289 XFPropTextRotation [893](#xfproptextrotation)](#xfproptextrotation) + +[2.5.290 XLNameUnicodeString [893](#xlnameunicodestring)](#xlnameunicodestring) + +[2.5.291 XlsFilter_Criteria [894](#xlsfilter_criteria)](#xlsfilter_criteria) + +[2.5.292 XlsFilter_Top10 [895](#xlsfilter_top10)](#xlsfilter_top10) + +[2.5.293 XLUnicodeRichExtendedString [896](#xlunicoderichextendedstring)](#xlunicoderichextendedstring) + +[2.5.294 XLUnicodeString [897](#xlunicodestring)](#xlunicodestring) + +[2.5.295 XLUnicodeStringMin2 [898](#xlunicodestringmin2)](#xlunicodestringmin2) + +[2.5.296 XLUnicodeStringNoCch [898](#xlunicodestringnocch)](#xlunicodestringnocch) + +[2.5.297 XLUnicodeStringSegmented [898](#xlunicodestringsegmented)](#xlunicodestringsegmented) + +[2.5.298 XLUnicodeStringSegmentedRTD [899](#xlunicodestringsegmentedrtd)](#xlunicodestringsegmentedrtd) + +[2.5.299 XLUnicodeStringSegmentedSXAddl [899](#xlunicodestringsegmentedsxaddl)](#xlunicodestringsegmentedsxaddl) + +[2.5.300 XmlTkBackWallThicknessFrt [900](#xmltkbackwallthicknessfrt)](#xmltkbackwallthicknessfrt) + +[2.5.301 XmlTkBaseTimeUnitFrt [900](#xmltkbasetimeunitfrt)](#xmltkbasetimeunitfrt) + +[2.5.302 XmlTkBlob [901](#xmltkblob)](#xmltkblob) + +[2.5.303 XmlTkBool [901](#xmltkbool)](#xmltkbool) + +[2.5.304 XmlTkChain [902](#xmltkchain)](#xmltkchain) + +[2.5.305 XmlTkColorMappingOverride [904](#xmltkcolormappingoverride)](#xmltkcolormappingoverride) + +[2.5.306 XmlTkDispBlanksAsFrt [904](#xmltkdispblanksasfrt)](#xmltkdispblanksasfrt) + +[2.5.307 XmlTkDouble [905](#xmltkdouble)](#xmltkdouble) + +[2.5.308 XmlTkDWord [905](#xmltkdword)](#xmltkdword) + +[2.5.309 XmlTkEnd [906](#xmltkend)](#xmltkend) + +[2.5.310 XmlTkEndSurface [906](#xmltkendsurface)](#xmltkendsurface) + +[2.5.311 XmlTkFloorThicknessFrt [906](#xmltkfloorthicknessfrt)](#xmltkfloorthicknessfrt) + +[2.5.312 XmlTkFormatCodeFrt [907](#xmltkformatcodefrt)](#xmltkformatcodefrt) + +[2.5.313 XmlTkHeader [907](#xmltkheader)](#xmltkheader) + +[2.5.314 XmlTkHeightPercent [907](#xmltkheightpercent)](#xmltkheightpercent) + +[2.5.315 XmlTkLogBaseFrt [908](#xmltklogbasefrt)](#xmltklogbasefrt) + +[2.5.316 XmlTkMajorUnitFrt [908](#xmltkmajorunitfrt)](#xmltkmajorunitfrt) + +[2.5.317 XmlTkMajorUnitTypeFrt [908](#xmltkmajorunittypefrt)](#xmltkmajorunittypefrt) + +[2.5.318 XmlTkMaxFrt [909](#xmltkmaxfrt)](#xmltkmaxfrt) + +[2.5.319 XmlTkMinFrt [909](#xmltkminfrt)](#xmltkminfrt) + +[2.5.320 XmlTkMinorUnitFrt [910](#xmltkminorunitfrt)](#xmltkminorunitfrt) + +[2.5.321 XmlTkMinorUnitTypeFrt [910](#xmltkminorunittypefrt)](#xmltkminorunittypefrt) + +[2.5.322 XmlTkNoMultiLvlLbl [911](#xmltknomultilvllbl)](#xmltknomultilvllbl) + +[2.5.323 XmlTkOverlay [911](#xmltkoverlay)](#xmltkoverlay) + +[2.5.324 XmlTkPerspectiveFrt [912](#xmltkperspectivefrt)](#xmltkperspectivefrt) + +[2.5.325 XmlTkPieComboFrom12Frt [912](#xmltkpiecombofrom12frt)](#xmltkpiecombofrom12frt) + +[2.5.326 XmlTkRAngAxOffFrt [912](#xmltkrangaxofffrt)](#xmltkrangaxofffrt) + +[2.5.327 XmlTkRotXFrt [913](#xmltkrotxfrt)](#xmltkrotxfrt) + +[2.5.328 XmlTkRotYFrt [913](#xmltkrotyfrt)](#xmltkrotyfrt) + +[2.5.329 XmlTkShowDLblsOverMax [913](#xmltkshowdlblsovermax)](#xmltkshowdlblsovermax) + +[2.5.330 XmlTkSpb [914](#xmltkspb)](#xmltkspb) + +[2.5.331 XmlTkStart [914](#xmltkstart)](#xmltkstart) + +[2.5.332 XmlTkStartSurface [914](#xmltkstartsurface)](#xmltkstartsurface) + +[2.5.333 XmlTkString [915](#xmltkstring)](#xmltkstring) + +[2.5.334 XmlTkStyle [915](#xmltkstyle)](#xmltkstyle) + +[2.5.335 XmlTkSymbolFrt [915](#xmltksymbolfrt)](#xmltksymbolfrt) + +[2.5.336 XmlTkThemeOverride [916](#xmltkthemeoverride)](#xmltkthemeoverride) + +[2.5.337 XmlTkTickLabelPositionFrt [916](#xmltkticklabelpositionfrt)](#xmltkticklabelpositionfrt) + +[2.5.338 XmlTkTickLabelSkipFrt [917](#xmltkticklabelskipfrt)](#xmltkticklabelskipfrt) + +[2.5.339 XmlTkTickMarkSkipFrt [917](#xmltktickmarkskipfrt)](#xmltktickmarkskipfrt) + +[2.5.340 XmlTkToken [917](#xmltktoken)](#xmltktoken) + +[2.5.341 XmlTkTpb [918](#xmltktpb)](#xmltktpb) + +[2.5.342 Xnum [918](#xnum)](#xnum) + +[2.5.343 XORObfuscation [918](#xorobfuscation)](#xorobfuscation) + +[2.5.344 XTI [918](#xti)](#xti) + +[2.6 XCB Structures [920](#xcb-structures)](#xcb-structures) + +[2.6.1 CTBWRAPPER [920](#ctbwrapper)](#ctbwrapper) + +[2.6.2 CTBS [920](#ctbs)](#ctbs) + +[2.6.3 CTB [921](#ctb)](#ctb) + +[2.6.4 TBC [922](#tbc)](#tbc) + +[2.6.5 TBCCmd [923](#tbccmd)](#tbccmd) + +[2.7 Algorithms [924](#algorithms)](#algorithms) + +[2.7.1 Application Data For VtHyperlink [924](#application-data-for-vthyperlink)](#application-data-for-vthyperlink) + +[3 Structure Examples [925](#structure-examples)](#structure-examples) + +[3.1 Conditional Formatting [925](#conditional-formatting-1)](#conditional-formatting-1) + +[3.1.1 Conditional Formatting: CondFmt [925](#conditional-formatting-condfmt)](#conditional-formatting-condfmt) + +[3.1.2 Conditional Formatting: CF [927](#conditional-formatting-cf)](#conditional-formatting-cf) + +[3.2 Defined Name [934](#defined-name)](#defined-name) + +[3.2.1 Defined Name: Lbl [934](#defined-name-lbl)](#defined-name-lbl) + +[3.2.2 Defined Name: ExternSheet [936](#defined-name-externsheet)](#defined-name-externsheet) + +[3.2.3 Defined Name: SupBook [937](#defined-name-supbook)](#defined-name-supbook) + +[3.3 Table [937](#table-1)](#table-1) + +[3.3.1 Table: Feathdr11 [937](#table-feathdr11)](#table-feathdr11) + +[3.3.2 Table: Feature11 [938](#table-feature11)](#table-feature11) + +[3.4 Filters [947](#filters)](#filters) + +[3.4.1 Filters: FilterMode [947](#filters-filtermode)](#filters-filtermode) + +[3.4.2 Filters: AutoFilterInfo [948](#filters-autofilterinfo)](#filters-autofilterinfo) + +[3.4.3 Filters: AutoFilter [948](#filters-autofilter)](#filters-autofilter) + +[3.5 External References [949](#external-references-1)](#external-references-1) + +[3.5.1 External References: Formula [950](#external-references-formula)](#external-references-formula) + +[3.5.2 External References: String [952](#external-references-string)](#external-references-string) + +[3.5.3 External References: SupBook 1 [953](#external-references-supbook-1)](#external-references-supbook-1) + +[3.5.4 External References: XCT [953](#external-references-xct)](#external-references-xct) + +[3.5.5 External References: CRN [954](#external-references-crn)](#external-references-crn) + +[3.5.6 External References: SupBook 2 [955](#external-references-supbook-2)](#external-references-supbook-2) + +[3.5.7 External References: ExternSheet [955](#external-references-externsheet)](#external-references-externsheet) + +[3.6 Column Chart Object [956](#column-chart-object)](#column-chart-object) + +[3.6.1 Column Chart Object: Chart [957](#column-chart-object-chart)](#column-chart-object-chart) + +[3.6.2 Column Chart Object: Frame [957](#column-chart-object-frame)](#column-chart-object-frame) + +[3.6.3 Column Chart Object: LineFormat [958](#column-chart-object-lineformat)](#column-chart-object-lineformat) + +[3.6.4 Column Chart Object: AreaFormat [959](#column-chart-object-areaformat)](#column-chart-object-areaformat) + +[3.6.5 Column Chart Object: Series [960](#column-chart-object-series)](#column-chart-object-series) + +[3.6.6 Column Chart Object: BRAI 1 [960](#column-chart-object-brai-1)](#column-chart-object-brai-1) + +[3.6.7 Column Chart Object: SeriesText [962](#column-chart-object-seriestext)](#column-chart-object-seriestext) + +[3.6.8 Column Chart Object: BRAI 2 [962](#column-chart-object-brai-2)](#column-chart-object-brai-2) + +[3.6.9 Column Chart Object: BRAI 3 [964](#column-chart-object-brai-3)](#column-chart-object-brai-3) + +[3.6.10 Column Chart Object: DataFormat [966](#column-chart-object-dataformat)](#column-chart-object-dataformat) + +[3.6.11 Column Chart Object: SerToCrt [966](#column-chart-object-sertocrt)](#column-chart-object-sertocrt) + +[3.6.12 Column Chart Object: ShtProps [966](#column-chart-object-shtprops)](#column-chart-object-shtprops) + +[3.6.13 Column Chart Object: DefaultText [967](#column-chart-object-defaulttext)](#column-chart-object-defaulttext) + +[3.6.14 Column Chart Object: Text [967](#column-chart-object-text)](#column-chart-object-text) + +[3.6.15 Column Chart Object: FontX [969](#column-chart-object-fontx)](#column-chart-object-fontx) + +[3.6.16 Column Chart Object: AxesUsed [969](#column-chart-object-axesused)](#column-chart-object-axesused) + +[3.6.17 Column Chart Object: AxisParent [970](#column-chart-object-axisparent)](#column-chart-object-axisparent) + +[3.6.18 Column Chart Object: Axis [970](#column-chart-object-axis)](#column-chart-object-axis) + +[3.6.19 Column Chart Object: CatSerRange [970](#column-chart-object-catserrange)](#column-chart-object-catserrange) + +[3.6.20 Column Chart Object: Tick [971](#column-chart-object-tick)](#column-chart-object-tick) + +[3.6.21 Column Chart Object: ChartFormat [972](#column-chart-object-chartformat)](#column-chart-object-chartformat) + +[3.6.22 Column Chart Object: Bar [973](#column-chart-object-bar)](#column-chart-object-bar) + +[3.7 Pie Chart Sheet [974](#pie-chart-sheet)](#pie-chart-sheet) + +[3.7.1 Pie Chart Sheet: PrintSize [974](#pie-chart-sheet-printsize)](#pie-chart-sheet-printsize) + +[3.7.2 Pie Chart Sheet: Chart [974](#pie-chart-sheet-chart)](#pie-chart-sheet-chart) + +[3.7.3 Pie Chart Sheet: ShtProps [975](#pie-chart-sheet-shtprops)](#pie-chart-sheet-shtprops) + +[3.7.4 Pie Chart Sheet: AxesUsed [975](#pie-chart-sheet-axesused)](#pie-chart-sheet-axesused) + +[3.7.5 Pie Chart Sheet: AxisParent [976](#pie-chart-sheet-axisparent)](#pie-chart-sheet-axisparent) + +[3.7.6 Pie Chart Sheet: ChartFormat [976](#pie-chart-sheet-chartformat)](#pie-chart-sheet-chartformat) + +[3.7.7 Pie Chart Sheet: Pie [976](#pie-chart-sheet-pie)](#pie-chart-sheet-pie) + +[3.7.8 Pie Chart Sheet: Legend [977](#pie-chart-sheet-legend)](#pie-chart-sheet-legend) + +[3.7.9 Pie Chart Sheet: Pos [978](#pie-chart-sheet-pos)](#pie-chart-sheet-pos) + +[3.7.10 Pie Chart Sheet: Text [979](#pie-chart-sheet-text)](#pie-chart-sheet-text) + +[3.7.11 Pie Chart Sheet: BRAI [981](#pie-chart-sheet-brai)](#pie-chart-sheet-brai) + +[3.7.12 Pie Chart Sheet: Window2 [981](#pie-chart-sheet-window2)](#pie-chart-sheet-window2) + +[3.8 Formatting [982](#formatting)](#formatting) + +[3.8.1 Formatting: Font 1 [983](#formatting-font-1)](#formatting-font-1) + +[3.8.2 Formatting: Font 2 [984](#formatting-font-2)](#formatting-font-2) + +[3.8.3 Formatting: Format [985](#formatting-format)](#formatting-format) + +[3.8.4 Formatting: XF 1 [986](#formatting-xf-1)](#formatting-xf-1) + +[3.8.5 Formatting: XF 2 [988](#formatting-xf-2)](#formatting-xf-2) + +[3.8.6 Formatting: XF 3 [990](#formatting-xf-3)](#formatting-xf-3) + +[3.8.7 Formatting: XF 4 [992](#formatting-xf-4)](#formatting-xf-4) + +[3.8.8 Formatting: Number 1 [994](#formatting-number-1)](#formatting-number-1) + +[3.8.9 Formatting: Number 2 [995](#formatting-number-2)](#formatting-number-2) + +[3.8.10 Formatting: Number 3 [996](#formatting-number-3)](#formatting-number-3) + +[3.9 Workbook [996](#workbook)](#workbook) + +[3.9.1 Workbook: BOF 1 [997](#workbook-bof-1)](#workbook-bof-1) + +[3.9.2 Workbook: RRTabId [998](#workbook-rrtabid)](#workbook-rrtabid) + +[3.9.3 Workbook: BuiltInFnGroupCount [999](#workbook-builtinfngroupcount)](#workbook-builtinfngroupcount) + +[3.9.4 Workbook: Window1 [999](#workbook-window1)](#workbook-window1) + +[3.9.5 Workbook: HideObj [1001](#workbook-hideobj)](#workbook-hideobj) + +[3.9.6 Workbook: Date1904 [1001](#workbook-date1904)](#workbook-date1904) + +[3.9.7 Workbook: CalcPrecision [1001](#workbook-calcprecision)](#workbook-calcprecision) + +[3.9.8 Workbook: BookBool [1001](#workbook-bookbool)](#workbook-bookbool) + +[3.9.9 Workbook: Font [1002](#workbook-font)](#workbook-font) + +[3.9.10 Workbook: Format [1003](#workbook-format)](#workbook-format) + +[3.9.11 Workbook: XF [1004](#workbook-xf)](#workbook-xf) + +[3.9.12 Workbook: Style [1006](#workbook-style)](#workbook-style) + +[3.9.13 Workbook: BoundSheet8 1 [1007](#workbook-boundsheet8-1)](#workbook-boundsheet8-1) + +[3.9.14 Workbook: BoundSheet8 2 [1007](#workbook-boundsheet8-2)](#workbook-boundsheet8-2) + +[3.9.15 Workbook: BoundSheet8 3 [1008](#workbook-boundsheet8-3)](#workbook-boundsheet8-3) + +[3.9.16 Workbook: Country [1008](#workbook-country)](#workbook-country) + +[3.9.17 Workbook: RecalcId [1009](#workbook-recalcid)](#workbook-recalcid) + +[3.9.18 Workbook: SST [1009](#workbook-sst)](#workbook-sst) + +[3.9.19 Workbook: ExtSST [1009](#workbook-extsst)](#workbook-extsst) + +[3.9.20 Workbook: BookExt [1010](#workbook-bookext)](#workbook-bookext) + +[3.9.21 Workbook: EOF 1 [1012](#workbook-eof-1)](#workbook-eof-1) + +[3.9.22 Workbook: BOF 2 [1012](#workbook-bof-2)](#workbook-bof-2) + +[3.9.23 Workbook: Index [1013](#workbook-index)](#workbook-index) + +[3.9.24 Workbook: DefaultRowHeight [1014](#workbook-defaultrowheight)](#workbook-defaultrowheight) + +[3.9.25 Workbook: WsBool [1014](#workbook-wsbool)](#workbook-wsbool) + +[3.9.26 Workbook: Setup [1015](#workbook-setup)](#workbook-setup) + +[3.9.27 Workbook: DefColWidth [1017](#workbook-defcolwidth)](#workbook-defcolwidth) + +[3.9.28 Workbook: Dimensions [1017](#workbook-dimensions)](#workbook-dimensions) + +[3.9.29 Workbook: Row 1 [1018](#workbook-row-1)](#workbook-row-1) + +[3.9.30 Workbook: Row 2 [1019](#workbook-row-2)](#workbook-row-2) + +[3.9.31 Workbook: Row 3 [1020](#workbook-row-3)](#workbook-row-3) + +[3.9.32 Workbook: Row 4 [1020](#workbook-row-4)](#workbook-row-4) + +[3.9.33 Workbook: LabelSst 1 [1021](#workbook-labelsst-1)](#workbook-labelsst-1) + +[3.9.34 Workbook: RK [1022](#workbook-rk)](#workbook-rk) + +[3.9.35 Workbook: LabelSst 2 [1023](#workbook-labelsst-2)](#workbook-labelsst-2) + +[3.9.36 Workbook: Formula [1024](#workbook-formula)](#workbook-formula) + +[3.9.37 Workbook: DBCell [1027](#workbook-dbcell)](#workbook-dbcell) + +[3.9.38 Workbook: Window2 [1027](#workbook-window2)](#workbook-window2) + +[3.9.39 Workbook: Selection [1029](#workbook-selection)](#workbook-selection) + +[3.9.40 Workbook: PhoneticInfo [1030](#workbook-phoneticinfo)](#workbook-phoneticinfo) + +[3.9.41 Workbook: EOF 2 [1031](#workbook-eof-2)](#workbook-eof-2) + +[3.10 PivotTable [1031](#pivottable-1)](#pivottable-1) + +[3.10.1 PivotTable: SXStreamID [1032](#pivottable-sxstreamid)](#pivottable-sxstreamid) + +[3.10.2 PivotTable: SXVS [1032](#pivottable-sxvs)](#pivottable-sxvs) + +[3.10.3 PivotTable: DConRef [1033](#pivottable-dconref)](#pivottable-dconref) + +[3.10.4 PivotTable: SXAddl 1 [1034](#pivottable-sxaddl-1)](#pivottable-sxaddl-1) + +[3.10.5 PivotTable: SXAddl 2 [1035](#pivottable-sxaddl-2)](#pivottable-sxaddl-2) + +[3.10.6 PivotTable: SXAddl 3 [1036](#pivottable-sxaddl-3)](#pivottable-sxaddl-3) + +[3.10.7 PivotTable: SxView [1036](#pivottable-sxview)](#pivottable-sxview) + +[3.10.8 PivotTable: Sxvd 1 [1040](#pivottable-sxvd-1)](#pivottable-sxvd-1) + +[3.10.9 PivotTable: SXVI 1 [1041](#pivottable-sxvi-1)](#pivottable-sxvi-1) + +[3.10.10 PivotTable: SXVI 2 [1042](#pivottable-sxvi-2)](#pivottable-sxvi-2) + +[3.10.11 PivotTable: SXVI 3 [1042](#pivottable-sxvi-3)](#pivottable-sxvi-3) + +[3.10.12 PivotTable: SXVI 4 [1043](#pivottable-sxvi-4)](#pivottable-sxvi-4) + +[3.10.13 PivotTable: SXVDEx 1 [1044](#pivottable-sxvdex-1)](#pivottable-sxvdex-1) + +[3.10.14 PivotTable: Sxvd 2 [1045](#pivottable-sxvd-2)](#pivottable-sxvd-2) + +[3.10.15 PivotTable: SXVI 5 [1047](#pivottable-sxvi-5)](#pivottable-sxvi-5) + +[3.10.16 PivotTable: SXVI 6 [1047](#pivottable-sxvi-6)](#pivottable-sxvi-6) + +[3.10.17 PivotTable: SXVI 7 [1048](#pivottable-sxvi-7)](#pivottable-sxvi-7) + +[3.10.18 PivotTable: SXVDEx 2 [1048](#pivottable-sxvdex-2)](#pivottable-sxvdex-2) + +[3.10.19 PivotTable: Sxvd 3 [1049](#pivottable-sxvd-3)](#pivottable-sxvd-3) + +[3.10.20 PivotTable: Sxvd 4 [1050](#pivottable-sxvd-4)](#pivottable-sxvd-4) + +[3.10.21 PivotTable: SXVDEx 3 [1052](#pivottable-sxvdex-3)](#pivottable-sxvdex-3) + +[3.10.22 PivotTable: Sxvd 5 [1053](#pivottable-sxvd-5)](#pivottable-sxvd-5) + +[3.10.23 PivotTable: SXVDEx 4 [1054](#pivottable-sxvdex-4)](#pivottable-sxvdex-4) + +[3.10.24 PivotTable: SxIvd [1056](#pivottable-sxivd)](#pivottable-sxivd) + +[3.10.25 PivotTable: SXPI [1056](#pivottable-sxpi)](#pivottable-sxpi) + +[3.10.26 PivotTable: SXDI [1057](#pivottable-sxdi)](#pivottable-sxdi) + +[3.10.27 PivotTable: SXLI 1 [1057](#pivottable-sxli-1)](#pivottable-sxli-1) + +[3.10.28 PivotTable: SXLI 2 [1063](#pivottable-sxli-2)](#pivottable-sxli-2) + +[3.10.29 PivotTable: SXEx [1064](#pivottable-sxex)](#pivottable-sxex) + +[3.10.30 PivotTable: QsiSXTag [1066](#pivottable-qsisxtag)](#pivottable-qsisxtag) + +[3.10.31 PivotTable: SXViewEx9 [1068](#pivottable-sxviewex9)](#pivottable-sxviewex9) + +[3.10.32 PivotTable: SxAddl 4 [1068](#pivottable-sxaddl-4)](#pivottable-sxaddl-4) + +[3.10.33 PivotTable: SxAddl 5 [1069](#pivottable-sxaddl-5)](#pivottable-sxaddl-5) + +[3.10.34 PivotTable: SxAddl 6 [1071](#pivottable-sxaddl-6)](#pivottable-sxaddl-6) + +[3.10.35 PivotTable: SXDB [1071](#pivottable-sxdb)](#pivottable-sxdb) + +[3.10.36 PivotTable: SXDBEx [1073](#pivottable-sxdbex)](#pivottable-sxdbex) + +[3.10.37 PivotTable: SXFDB 1 [1073](#pivottable-sxfdb-1)](#pivottable-sxfdb-1) + +[3.10.38 PivotTable: SXString 1 [1075](#pivottable-sxstring-1)](#pivottable-sxstring-1) + +[3.10.39 PivotTable: SXString 2 [1075](#pivottable-sxstring-2)](#pivottable-sxstring-2) + +[3.10.40 PivotTable: SXString 3 [1075](#pivottable-sxstring-3)](#pivottable-sxstring-3) + +[3.10.41 PivotTable: SXFDB 2 [1076](#pivottable-sxfdb-2)](#pivottable-sxfdb-2) + +[3.10.42 PivotTable: SXDtr 1 [1077](#pivottable-sxdtr-1)](#pivottable-sxdtr-1) + +[3.10.43 PivotTable: SXDtr 2 [1077](#pivottable-sxdtr-2)](#pivottable-sxdtr-2) + +[3.10.44 PivotTable: SXFDB 3 [1078](#pivottable-sxfdb-3)](#pivottable-sxfdb-3) + +[3.10.45 PivotTable: SXFDB 4 [1079](#pivottable-sxfdb-4)](#pivottable-sxfdb-4) + +[3.10.46 PivotTable: SXNum 1 [1080](#pivottable-sxnum-1)](#pivottable-sxnum-1) + +[3.10.47 PivotTable: SXFDB 5 [1081](#pivottable-sxfdb-5)](#pivottable-sxfdb-5) + +[3.10.48 PivotTable: SXDBB 1 [1082](#pivottable-sxdbb-1)](#pivottable-sxdbb-1) + +[3.10.49 PivotTable: SXNum 2 [1082](#pivottable-sxnum-2)](#pivottable-sxnum-2) + +[3.10.50 PivotTable: SXDBB 2 [1083](#pivottable-sxdbb-2)](#pivottable-sxdbb-2) + +[3.10.51 PivotTable: SXNum 3 [1083](#pivottable-sxnum-3)](#pivottable-sxnum-3) + +[3.10.52 PivotTable: EOF [1084](#pivottable-eof)](#pivottable-eof) + +[4 Security Considerations [1085](#security-considerations)](#security-considerations) + +[5 Appendix A: Product Behavior [1086](#appendix-a-product-behavior)](#appendix-a-product-behavior) + +[6 Change Tracking [1096](#change-tracking)](#change-tracking) + +[7 Index [1098](#index-1)](#index-1) + +# Introduction + +The Excel Binary File Format (.xls) Structure specifies the Excel Binary File Format (.xls). The Excel Binary File Format (.xls) is a collection of records and structures that specify [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) content, which can include unstructured or semi-structured tables of numbers, text, or both numbers and text, formulas, external data connections, charts, and images. Workbook content is typically organized in a grid based layout, and often includes numeric data, structured data, and formulas. + +Sections 1.7 and 2 of this specification are normative. All other sections and examples in this specification are informative. + +## Glossary + +This document uses the following terms: + +> **3-D Phong shading**: A shading algorithm that is used to apply shading to 3-D charts. The algorithm interpolates color between points on the surface of a chart to give a smooth 3-D appearance. +> +> **A1**: A [**reference style**](#gt_71d7e4ad-d6b6-49d9-b247-e2ebba1469e9) in which each column is identified sequentially from left-to-right with a letter or series of letters in alphabetical order. Column headings are ordered A-Z, then AA-AZ, BA-BZ... ZA-ZZ, AAA-AAZ, and so forth. Each row is numbered sequentially from the top down. +> +> **absolute reference**: A reference to a fixed location on a [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). An absolute reference always refers to the same range, even if the formula that contains it is moved or copied to a new location. +> +> **accelerator key**: Any combination of keys that are pressed simultaneously to run a command. +> +> **active cell**: The cell that is currently selected in a worksheet. +> +> **active pane**: The pane that currently has focus or contains the current selection or object. +> +> **active sheet**: The sheet that is currently selected. +> +> **ActiveX control**: A reusable software control, such as a check box or button, that uses ActiveX technology and provides options to users or runs macros or scripts that automate a task. See also [**ActiveX object**](#gt_0d95e494-61b2-43bc-8818-51aa162d2018). +> +> **ActiveX Data Objects (ADO)**: A data access interface that connects to, retrieves, manipulates, and updates data in [**Object Linking and Embedding (OLE)**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) database-compliant data sources. +> +> **ActiveX object**: An object that is supplied by a component that supports automation. +> +> **add-in**: Supplemental functionality that is provided by an external application or macro to extend the capabilities of an application. +> +> **add-in function**: A worksheet function that is provided by an [**add-in**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6), instead of being built-in. +> +> **advanced filter**: An extended filter option that enables users to specify complex filter criteria and a destination range for the filter results. +> +> **aggregation function**: A function, such as sum or average, that appears in the total row of a table and is used to summarize data. +> +> **ALL**: See OLAP All member. +> +> **alternate startup directory**: A secondary location that stores files to be opened by an application when the application starts. +> +> **American National Standards Institute (ANSI) character set**: A [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204) defined by a [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38) approved by the American National Standards Institute (ANSI). The term "ANSI" as used to signify Windows code pages is a historical reference and a misnomer that persists in the Windows community. The source of this misnomer stems from the fact that the Windows code page 1252 was originally based on an ANSI draft, which became International Organization for Standardization (ISO) Standard 8859-1 [\[ISO/IEC-8859-1\]](https://go.microsoft.com/fwlink/?LinkId=90689). In Windows, the ANSI character set can be any of the following code pages: 1252, 1250, 1251, 1253, 1254, 1255, 1256, 1257, 1258, 874, 932, 936, 949, or 950. For example, "ANSI application" is usually a reference to a non-[**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) or code-page-based application. Therefore, "ANSI character set" is often misused to refer to one of the character sets defined by a Windows code page that can be used as an active system code page; for example, character sets defined by code page 1252 or character sets defined by code page 950. Windows is now based on Unicode, so the use of ANSI character sets is strongly discouraged unless they are used to interoperate with legacy applications or legacy data. +> +> **ASCII**: The American Standard Code for Information Interchange (ASCII) is an 8-bit character-encoding scheme based on the English alphabet. ASCII codes represent text in computers, communications equipment, and other devices that work with text. ASCII refers to a single 8-bit ASCII character or an array of 8-bit ASCII characters with the high bit of each character set to zero. +> +> **attribute hierarchy**: A single-level [**hierarchy**](#gt_a07fc05d-cdb0-442c-984a-dd3589b9f682) that uses only an attribute or a column from a source, back-end relational database as its hierarchy. An attribute hierarchy typically has the same name as the attribute and is always associated with the attribute on which it is based. An all-level member can optionally be enabled for an attribute hierarchy. See also OLAP hierarchy. +> +> **Augmented Backus-Naur Form (ABNF)**: A modified version of Backus-Naur Form (BNF), commonly used by Internet specifications. ABNF notation balances compactness and simplicity with reasonable representational power. ABNF differs from standard BNF in its definitions and uses of naming rules, repetition, alternatives, order-independence, and value ranges. For more information, see [\[RFC5234\]](https://go.microsoft.com/fwlink/?LinkId=123096). +> +> **AutoComplete**: A feature that suggests text automatically based on the first few characters that a user types. +> +> **AutoFilter**: A mechanism that can be used to filter tabular data based on user-defined criteria such as values, strings, and formatting. +> +> **AutoFormat**: A built-in set of complementary formatting options that can be applied to ranges of cells and other objects in a document. +> +> **AutoRecover**: A feature that recovers document and application states in the event of a hardware or software failure. +> +> **AutoShow**: A filter option that enables users to display a specified number of the top- or bottom-most items within a PivotTable field. +> +> **background color**: A color against which characters, patterns, and graphics are displayed. See also [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a). +> +> **beta**: A pre-released version of a product that is sent to customers and partners for evaluation and feedback. +> +> **BIFF12**: A binary file format that is used to save workbooks in Microsoft Office Excel 2007 and Microsoft Excel 2010. +> +> **BIFF2**: A binary file format that is used by default to save worksheets in Microsoft Excel 2.1. +> +> **BIFF3**: A binary file format that is used by default to save worksheets in Microsoft Excel 3.0 for Windows. +> +> **BIFF4**: A binary file format that is used by default to save worksheets in Microsoft Excel 4.0 for Windows. +> +> **BIFF5**: A binary file format that is used by default to save workbooks in Microsoft Excel 5.0 for Windows and Microsoft Excel for Windows 95. +> +> **BIFF8**: A binary file format that is used to save workbooks in Microsoft Office Excel 2003 and earlier versions of Microsoft Excel. +> +> **big-endian**: Multiple-byte values that are byte-ordered with the most significant byte stored in the memory location with the lowest address. +> +> **Binary Interchange File Format (BIFF)**: The binary file formats that are used to save Excel workbooks. +> +> **block-level formatting**: A type of formatting that can be applied to a field or column in a table. It is applied to all existing records and automatically to new records. +> +> **border**: A line that can be applied to the outer edge of a cell, shape, object, or chart element. A border can be variously formatted for style, color, and thickness. +> +> **border formatting**: A set of properties that, as a whole, specify the appearance of a border, such as color, line style, and thickness. +> +> **border style**: See [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad). +> +> **bounding rectangle**: A frame that encompasses an object. A bounding rectangle is not rotated and, therefore, always aligns along the x and y axes. +> +> **Briefcase**: A system folder in Windows that is used to share and synchronize files between computers. +> +> **bubble size**: A value that represents the diameter of a bubble in a bubble chart. +> +> **build identifier**: An integer that identifies a build. +> +> **build number**: A part of a sequential numbering system that is used to differentiate one version of a software product from another. +> +> **built-in name**: A member of the group of defined names that are reserved for specific functionality. +> +> **ButtonPopup control**: A type of Button control that displays a menu of related commands when activated. +> +> **calculation mode**: A setting that determines whether the formulas in a worksheet are recalculated automatically or manually. See also automatic calculation mode and manual calculation mode. +> +> **camera picture**: An image of a range of cells that is generated by using the camera tool. The image can be linked such that when the data in the source range changes, the image is updated automatically. +> +> **caption**: One or more characters that can be used as a label for display purposes or as an identifier. +> +> **cascading style sheet (CSS)**: An extension to [**HTML**](#gt_549c4960-e8be-4c24-bc2b-b86530f1c1bf) that enables authors and users of HTML documents to attach style sheets to those documents, as described in [\[CSS-LEVEL1\]](https://go.microsoft.com/fwlink/?LinkId=99527) and [\[CSS-LEVEL2\]](https://go.microsoft.com/fwlink/?LinkId=114090). A style sheet includes typographical information about the appearance of a page, including the font for text on the page. +> +> **category**: A subdivision of items into useful groups such as geographical regions. For example, categories that represent geographical regions could be North, South, East, and West. +> +> **category label**: A label that appears on the horizontal (x) axis of a chart and identifies the categories of the source data. +> +> **cell**: A box that is formed by the intersection of a row and a column in a worksheet or a table. A cell can contain numbers, strings, and formulas, and various formats can be applied to that data. +> +> **cell reference**: A set of coordinates that a cell occupies on a worksheet. For example, "B3" is the reference of a cell that appears at the intersection of column "B" and row "3". +> +> **cell value**: The text or numeric content of a cell, or the results of a formula. A cell value does not include a formula expression, cell formatting, or other metadata. +> +> **center-across-selection alignment**: A formatting setting that centers cell content horizontally within a selected range of cells. +> +> **centered alignment**: A formatting setting that specifies how content is positioned within the horizontal, vertical, or both horizontal and vertical space within a cell, object, or page. When centered, content is equidistant from the edges of the cell, object, or page. +> +> **character set**: A mapping between the characters of a written language and the values that are used to represent those characters to a computer. +> +> **chart area**: A region in a chart object that is used to position chart elements, render axes, and plot data. +> +> **chart sheet**: A single logical container that is used to create and store charts in a workbook. +> +> **checksum**: A value that is the summation of a byte stream. By comparing the checksums computed from a data item at two different times, one can quickly assess whether the data items are identical. +> +> **child**: An object that is immediately below the current object in a hierarchy. +> +> **class identifier (CLSID)**: A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) that identifies a software component; for instance, a DCOM object class or a COM class. +> +> **class module**: A module that contains the definition for a new object. Each instance of a class creates a new object, and procedures that are defined in the module become properties and methods of the object. +> +> **client area**: In an application, the display area that is used to create data, such as drawing or typing functions. The client area does not include toolbars, menus, or status bars. +> +> **code page**: An ordered set of characters of a specific script in which a numerical index (code-point value) is associated with each character. Code pages are a means of providing support for [**character sets**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204) and keyboard layouts used in different countries. Devices such as the display and keyboard can be configured to use a specific code page and to switch from one code page (such as the United States) to another (such as Portugal) at the user's request. +> +> **collapsed outline state**: A state in which the content that is nested within an outline is not displayed. +> +> **color palette**: A collection of colors that is available to format text, shapes, cells, and chart elements. +> +> **color scale**: A specific range of colors that is used to give additional meaning to data by assigning certain values to colors in the spectrum. +> +> **color scheme**: A table of color values that enables colors to be referenced by an index value in the table instead of a color value. See also [**color palette**](#gt_05879d13-b9e0-4333-b96d-63cc3433997e). +> +> **column formula**: A formula that is used in a calculated column. +> +> **column outline**: A nested grouping of columns in a worksheet. +> +> **comment**: An annotation that is associated with a cell, text, or other object to provide context-specific information or reviewer feedback. +> +> **compact axis**: A state in which PivotTable members from different levels in a hierarchy are displayed in a single column. +> +> **Component Object Model (COM)**: An object-oriented programming model that defines how objects interact within a single process or between processes. In [**COM**](#gt_ef2ebebc-1760-407a-9ace-af48f9050e02), clients have access to an object through interfaces implemented on the object. For more information, see [\[MS-DCOM\]](%5bMS-DCOM%5d.pdf#Section_4a893f3dbd2948cd9f43d9777a4415b0). +> +> **conditional formatting**: A mechanism that changes the appearance of a user interface element based on the evaluation of a rule or expression. +> +> **connection string**: A series of arguments, delimited by a semicolon, that defines the location of a database and how to connect to it. +> +> **consolidation range**: A range of source data that is used in a data consolidation process. +> +> **cryptographic service provider**: An independent software module that performs authentication, encoding, and encryption services that Windows-based applications access through the CryptoAPI. +> +> **cube**: A set of data that is organized and summarized into a multidimensional structure that is defined by a set of [**dimensions (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) and [**measures**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998). +> +> **cube function**: A function that is used to extract and display Online Analytical Processing (OLAP) data sets and values. +> +> **custom color palette**: A set of user-defined colors that is available for formatting. +> +> **custom filter**: A filter that contains preconfigured expressions in which users can optionally enter a string to filter data. +> +> **custom list**: A user-defined list or enumeration that can be used to sort data in a worksheet. +> +> **custom rollup**: An aggregation calculation that is customized for a dimension level, dimension member, or measure. A custom rollup contains a custom formula or operator, overrides the aggregate functions of a cube's measures, and is defined on a hierarchy. +> +> **custom view**: A collection of display and print settings that users can name and save. Users can switch between custom views to change settings quickly. +> +> **Data Access Objects (DAO)**: A programming interface that can be used to access and manipulate database objects. +> +> **data bar**: A graphical representation of cell content as a bar graph. +> +> **data consolidation**: The process of combining tabular data from various worksheets into a single list. +> +> **data marker**: A customizable symbol or shape that identifies a data point on a line, scatter, or radar chart. A data marker can be formatted with various sizes and colors. +> +> **data provider**: A known data source that is specific to a target type and that provides data to a collector type. +> +> **data recovery**: A process in which files are repaired through error correction or restored from backup media. +> +> **data region**: A region of a table that encompasses the range of cells that contains the table records. A data region does not include the [**header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38), insert row, or total row of a table. +> +> **data source**: A database, web service, disk, file, or other collection of information from which data is queried or submitted. Supported data sources vary based on application and data provider. +> +> **data table**: (1) A range of cells that is designated to perform what-if analysis for formulas, based on various input values. +> +> \(2\) A grid that can be added to some charts and contains the numeric data that is plotted in the chart. +> +> **data validation**: The process of testing the accuracy of data; a set of rules that specify the type and range of data that users can enter. +> +> **date system**: A method of calculating calendar dates and times. +> +> **DDE link**: A connection between a [**Dynamic Data Exchange (DDE)**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) source document and a destination document. +> +> **DDE server**: An application that responds to a [**Dynamic Data Exchange (DDE)**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) request from a DDE client application. +> +> **DDE topic**: A general classification of information about a [**Dynamic Data Exchange (DDE)**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) server within which multiple, specific data items related to the topic can be exchanged. +> +> **defined name**: A word or string of characters in a formula that represents a cell, range of cells, formula, or constant value. +> +> **descending order**: A sort order in which text strings are arranged in reverse alphabetical order, numerical values are arranged from largest to smallest, and dates and times are arranged from newest to oldest. +> +> **diagonal-down**: A cell [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad) that displays a line diagonally from the top left corner of a cell to the bottom right corner. +> +> **diagonal-up**: A cell [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad) that displays a line diagonally from the bottom left corner of a cell to the top right corner. +> +> **dialog sheet**: A single logical container that is used to create a custom dialog box. +> +> **dimension**: (1) A structural attribute of a cube, which is an organized hierarchy of categories (levels) that describe data in a fact table. These categories typically describe a similar set of members upon which the user bases an analysis. +> +> \(2\) A categorization of data in rows or columns in an Excel worksheet. +> +> **display folder**: A folder into which attributes, measures, calculated members, and key performance indicators can be organized to facilitate browsing. +> +> **display units**: An axis-formatting option that determines how numeric units are displayed on a value axis. +> +> **distributed alignment**: A formatting setting that spreads text evenly, both vertically and horizontally, between the edges of a cell, object, or page. Distributed alignment is used primarily with East Asian languages. See also [**justify distributed**](#gt_11eced66-af2c-4391-8b45-87a60ad41483). +> +> **document library**: A type of list that is a container for documents and folders. +> +> **double accounting**: An underline style that places two lines beneath the formatted text. Double accounting is frequently used to indicate totals. +> +> **down bar**: See [**up-down bar**](#gt_54f291c2-81aa-41b6-8831-88d180a09ea0). +> +> **drawing**: A collection of drawing objects, such as shapes, curves, or WordArt, that are viewed together as a single image. +> +> **drawing group**: A collection of images that are designated by the user as a single group of images and manipulated as a single [**drawing object**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac). +> +> **drawing object**: A shape, curve, line, WordArt, or other type of graphical object that can be inserted into a document. +> +> **drillthrough**: A query that is used to retrieve individual records that were used to calculate an aggregate value. +> +> **drop lines**: A set of supplemental lines on an area chart or a line chart. Drop lines increase the legibility of a chart by connecting each data point in a series to the category axis. +> +> **Dynamic Data Exchange (DDE)**: An inter-process communication method that is featured in Windows. DDE allows two or more applications that are running simultaneously to exchange data and commands. +> +> **embedded object**: An object that is created by using one application and is hosted in a document that was created by using another application. Embedding an object, rather than inserting or pasting it, ensures that the object retains its original format. Users can double-click an embedded object and edit it with the toolbars and menus from the application that was used to create it. See also [**Object Linking and Embedding (OLE)**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c). +> +> **Excel Linked Library (XLL)**: A Dynamic Link Library (DLL) that is authored to function as an [**add-in**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6) for Microsoft Excel. +> +> **Excel macro (XLM)**: A programming language that provides development capability in Microsoft Excel. XLM was superseded by Microsoft Visual Basic for Applications (VBA). +> +> **expand/collapse button**: A user interface control that is used to determine which hierarchical level is displayed in an outline, or in row and column groupings. +> +> **expression**: A combination of operators, symbols, constants, literal values, functions, names of fields or columns, controls, and properties that evaluates to a single value. +> +> **external data**: Data that is stored in a repository outside a workbook. +> +> **external link**: A reference to a cell, range, defined name, or other object in another worksheet or workbook. +> +> **fill**: A color, pattern, or other attribute that is used to format the background of a cell, shape, or chart element. See also [**fill color**](#gt_ed1c5310-a27a-4576-883a-f9f3e18ba20a) and [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e). +> +> **fill alignment**: A setting that repeats a cell value to fill the horizontal space of a cell. If the cell value exceeds the horizontal width of the cell, the value is truncated. +> +> **fill color**: A color that is used to fill the background of a cell, shape, or chart element. +> +> **fill pattern**: A repetitive design that users can add to the background of a cell, shape, or chart element. +> +> **filter**: A mechanism by which a set of data is scoped to display only those entries that meet specified logical criteria. +> +> **filtering state**: A setting that indicates whether a filter value or filter date value is included as part of the criteria that is used to define the filter for an [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). +> +> **fit to page**: A printing option that scales a document to print on a specified number of pages. +> +> **floating-point number**: A number that is represented by a mantissa and an exponent according to a given base. The mantissa is typically a value between "0" and "1". To find the value of a floating-point number, the base is raised to the power of the exponent, and the mantissa is multiplied by the result. +> +> **floor**: An extension of the horizontal axis, or the area created by the inclusion of the z axis, in a 3-D chart to create a three-dimensional effect. See also [**wall**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c). +> +> **folder**: A file system construct. File systems organize a volume's data by providing a hierarchy of objects, which are referred to as folders or directories, that contain files and can also contain other folders. +> +> **followed hyperlink**: A hyperlink that has been activated by a user. +> +> **font**: An object that defines the graphic design, or formatting, of a collection of numbers, symbols, and letters. A font specifies the style (such as bold and strikeout), size, family (a typeface such as Times New Roman), and other qualities to describe how the collection is drawn. +> +> **font face weight**: A value that specifies the thickness of a font. +> +> **font family**: A set of fonts that all have common stroke width and serif characteristics. For example, Times Roman and Times Roman Italic are members of the same font family. +> +> **font scaling**: A process of resizing a proportionally-spaced font. +> +> **font scheme**: A combination of complementary fonts in a [**theme**](#gt_8b5eb4c0-949b-47d9-8b63-b9bda81d61b8). +> +> **forecast**: The process of projecting values forward or backward in a series, based on trends in existing data. +> +> **foreground color**: A color that is used to display text, patterns, and other objects that appear in front of or on top of the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c). +> +> **form**: A structured document with controls and spaces that are reserved for entering and displaying information. Forms can contain special coding for actions such as submitting and querying data. +> +> **format string**: A string that contains the number formatting information to apply to data, such as decimal position, percentage indicator, or currency symbol. +> +> **formatting run**: A set of formatting properties that are applied to a [**text run**](#gt_393612a7-9552-48b0-abf6-0371dbd6d553). +> +> **formula bar**: A user interface element that appears at the top of a worksheet and is used to display and edit cell content. +> +> **formula error checking**: A mechanism that identifies invalid worksheet data, formulas, or formatting and then proposes corrections. +> +> **friendly name**: A name for a user or object that can be read and understood easily by a human. +> +> **frozen**: See [**frozen panes**](#gt_28507dfc-4443-4a02-a18c-27b5db006946). +> +> **frozen panes**: Portions of a worksheet that remain static and do not scroll when the worksheet is displayed in split pane view. See also [**split pane**](#gt_03a3359c-d8a8-4988-ace6-369a2ae4ff82). +> +> **full screen view**: A document view that expands the display of a document to fill the computer screen. The view hides menus, toolbars, and taskbars. +> +> **function**: A code module that takes a value as input, performs an operation, and returns the results to a worksheet. +> +> **function category**: A group of worksheet functions that are part of the same broad usage area, such as Finance or Statistical. A function category can be built-in or user-defined. +> +> **general alignment**: A default formatting setting for the horizontal alignment of cell content in a worksheet. Text is positioned to the left and numbers are positioned to the right. +> +> **globally unique identifier (GUID)**: A term used interchangeably with universally unique identifier (UUID) in Microsoft protocol technical documents (TDs). Interchanging the usage of these terms does not imply or require a specific algorithm or mechanism to generate the value. Specifically, the use of this term does not imply or require that the algorithms described in [\[RFC4122\]](https://go.microsoft.com/fwlink/?LinkId=90460) or [\[C706\]](https://go.microsoft.com/fwlink/?LinkId=89824) have to be used for generating the GUID. See also universally unique identifier (UUID). +> +> **gradient fill**: A type of fill that applies gradient formatting to the background of a cell or an object. +> +> **gradient stop**: A marker on a gradient spectrum that denotes where a specific color is introduced in gradient formatting. +> +> **grand total**: An aggregation of all of the field subtotals in a PivotTable report. +> +> **graph object**: An object that represents a chart and the datasheet that contains the data for that chart. +> +> **GraphicDropDown control**: A type of DropDown control that can display custom graphics in a list of options. +> +> **gridline**: A line that is drawn on a worksheet or table for use as a visual aid to distinguish between cells. +> +> **gutter**: An area above a column heading and to the left of a row heading. A gutter typically displays outline symbols that are used to expand and collapse groups of cells. +> +> **hash**: A fixed-size result that is obtained by applying a one-way mathematical function, which is sometimes referred to as a hash algorithm, to an arbitrary amount of data. If the input data changes, the hash also changes. The hash can be used in many operations, including authentication and digital signing. +> +> **header row**: A row in a table, typically the first row, that contains labels for columns in the table. +> +> **hidden**: A condition of an object that prevents it from being displayed in rendered output. +> +> **hidden cell**: A cell that does not appear in a worksheet view because it is contained within a [**hidden row**](#gt_3833addc-1f77-4c64-856c-c1b967fdaa75) or a [**hidden column**](#gt_ea5c8135-254e-407c-999b-5cf39e709164). +> +> **hidden column**: A column that does not appear in a worksheet view because its width is set to 0 (zero). A column can be hidden if an outline is collapsed. +> +> **hidden protection**: A cell protection property that prevents formulas, but not values, from appearing in a cell when a worksheet is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829). +> +> **hidden row**: A row that does not appear in a worksheet view because its height is set to "0" (zero). A row can be hidden if the data is filtered or an outline is collapsed. +> +> **hierarchy**: A logical tree structure that organizes the members of a dimension such that each member has one parent member and zero or more child members. +> +> **high-low lines**: Supplemental lines that are added to a line chart and connect the maximum data points of one series with the minimum data points of another series for each [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1). High-low lines are typically used on stock charts. +> +> **horizontal alignment**: A formatting setting that specifies how content is positioned within the horizontal space of a cell, object, or page. Content can be aligned along the left or right edge, or distributed evenly across the horizontal space. +> +> **hyperlink**: A relationship between two anchors, as described in [\[RFC1866\]](https://go.microsoft.com/fwlink/?LinkId=90296). +> +> **Hypertext Markup Language (HTML)**: An application of the Standard Generalized Markup Language (SGML) that uses tags to mark elements in a document, as described in [\[HTML\]](https://go.microsoft.com/fwlink/?LinkId=89880). +> +> **icon**: A graphical image used to supplement alphanumeric text in the visual identification of an object on a computer monitor. [**Icons**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) are typically small, relative to the size of the area on which they are displayed. +> +> **icon set**: A collection of icons that can be used to comment and classify data into categories. +> +> **indentation level**: A measure of the distance between the position of content that is in a cell and the logical left side of the cell. An indentation level is equal to three spaces. +> +> **Information Rights Management (IRM)**: A technology that provides persistent protection to digital data by using encryption, certificates, and authentication. Authorized recipients or users acquire a license to gain access to the protected files according to the rights or business rules that are set by the content owner. +> +> **ink**: A process of entering text in handwritten form. Instead of converting handwritten text to typed text, ink is converted to an object and displayed exactly as it was written. +> +> **inner rectangle**: In a cell that is formatted with a rectangular gradient, a rectangle that is formed by the leftmost, rightmost, topmost, and bottommost lines of pixels in which the initial color of the gradient is completely dissipated. See also [**rectangular gradient**](#gt_bc10f1e2-8a79-4d73-92ff-f4648d3f0ada). +> +> **input cell**: A cell in which each input value from a data table is substituted. +> +> **input language**: A pairing of input language and input method. The pairing determines what language is currently being entered and how. The input language is usually determined by the keyboard language that is currently active in the operating system. Users can install keyboard layouts and Input Method Editors (IMEs) for several languages, and then switch between them at appropriate times to indicate the input language. +> +> **Input Method Editor (IME)**: An application that is used to enter characters in written Asian languages by using a standard 101-key keyboard. An IME consists of both an engine that converts keystrokes into phonetic and ideographic characters and a dictionary of commonly used ideographic words. +> +> **insert row**: A placeholder row at the bottom of a table. It is used to enter new records. +> +> **international macro sheet**: A macro sheet that displays English function names and operates with U.S. English locale settings, regardless of product locale, user locale, or system locale. +> +> **iterative calculation**: A [**calculation mode**](#gt_f02f81e1-8eda-4ec3-88e9-c2c483ff47ee) in which calculations are performed until a specific numeric condition is met or a maximum number of iterations is reached. +> +> **justify distributed**: A special, distributed-alignment setting that evenly distributes the last line of text in a cell. The setting is primarily used for East Asian languages. See also [**distributed alignment**](#gt_dae18ea5-2a98-4e10-9570-7f4ac695c6b8). +> +> **key performance indicator (KPI)**: A predefined measure that is used to track performance against a strategic goal, objective, plan, initiative, or business process. A visual cue is frequently used to communicate performance against the measure. +> +> **language code identifier (LCID)**: A 32-bit number that identifies the user interface human language dialect or variation that is supported by an application or a client computer. +> +> **leader line**: A line that connects a data label to its corresponding data point. The primary purpose of a leader line is to increase legibility. +> +> **left-to-right**: A reading order in which characters in words are read from left to right, and words are read from left to right in sentences. +> +> **legend entry**: An item in a chart legend that identifies a single series or [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1). +> +> **legend key**: A symbol that is associated with a legend entry. +> +> **library directory**: A directory in which Microsoft Excel [**add-ins**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6) are installed. +> +> **license key**: An array of bytes that enables access to a control according to the usage policies for that control. +> +> **line style**: A style, including width and dash type, that is applied to and alters the appearance of a line or [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c). +> +> **linear gradient**: A type of gradient fill in which the color of a cell or other object gradually changes horizontally, vertically, or diagonally from one edge of the object to the other. +> +> **linked object**: An object that is inserted into a document and continues to exist in a separate source file. If the object in the source file changes, the object in the document is updated automatically to reflect those changes. +> +> **list**: A container within a SharePoint site that stores list items. A list has a customizable schema that is composed of one or more fields. +> +> **list view**: A named collection of settings for querying and displaying items in a SharePoint list. There are two types of views: Personal, which can be used only by the user who created the view; and Public, which can be used by all users who have permission to access to the site. +> +> **little-endian**: Multiple-byte values that are byte-ordered with the least significant byte stored in the memory location with the lowest address. +> +> **local name**: A defined name whose scope is limited to a specific sheet instead of the entire workbook. +> +> **locale**: A collection of rules and data that are specific to a language and a geographical area. A locale can include information about sorting rules, date and time formatting, numeric and monetary conventions, and character classification. +> +> **localization**: The process of adapting an application or documentation, including text and non-text elements, to meet the language, cultural, and political expectations and requirements of a specific geographic country or region. +> +> **locked**: The condition of a cell, worksheet, or other object that restricts edits or modifications to it by users. +> +> **locked protection**: A cell-protection property that restricts the editing of cell content when a worksheet is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829). +> +> **logical left**: A position that is relative to the language orientation of a document. Logical left means left, except in a right-to-left language where it means right. Also referred to as leading edge. +> +> **logical right**: A position that is relative to the language orientation of a document. Logical right means right, except in a right-to-left language where it means left. Also referred to as trailing edge. +> +> **logical top-left**: A position that is relative to the language orientation of a document. Logical top-left is the upper-left corner of a range or object when in left-to-right mode. It is the upper-right corner when in right-to-left mode. +> +> **logical top-right**: A position that is relative to the language orientation of a document. Logical top-right is the upper-right corner of a range or object when in left-to-right mode. It is the upper-left corner when in right-to-left mode. +> +> **long file name**: A folder or file name that is longer than the 8.3 file name standard, which permits as many as eight characters followed by a period and a file name extension of three characters. +> +> **macro**: A set of instructions that are recorded or written, and then typically saved to a file. When a macro is run, all of the instructions are performed automatically. +> +> **macro sheet**: A single, logical container that is used to store and run Excel 4.0 macro formulas. +> +> **major gridline**: A horizontal or vertical line that is in the plot area of a chart and corresponds to the major scaling unit on an axis. +> +> **major scheme**: A font scheme that is used for primary text elements, such as headings and titles, in a [**theme**](#gt_8b5eb4c0-949b-47d9-8b63-b9bda81d61b8). +> +> **major tick mark**: A tick mark that corresponds to a major scaling unit on an axis. +> +> **Mandarin phonetic symbols**: A phonetic system for transcribing Chinese through the use of an alphabet that includes characters for all possible sounds in the spoken Mandarin language. +> +> **manifest**: A file that stores metadata about an expansion pack, such as the name of the expansion pack, the files and resources that are included in the expansion pack, and the dependencies that it has on other files and components. +> +> **MD5**: A one-way, 128-bit hashing scheme that was developed by RSA Data Security, Inc., as described in [\[RFC1321\]](https://go.microsoft.com/fwlink/?LinkId=90275). +> +> **MDX unique name**: A unique identifier for a multidimensional expression (MDX) member or value in a given Online Analytical Processing (OLAP) cube, for example "\[Customer\].\[Customer Geography\].\[Country\].&\[Australia\]". +> +> **measure**: In a cube, a set of values that are typically numeric and are based on a column in the fact table of the cube. Measures are the central values that are aggregated and analyzed. +> +> **measure group**: A collection of related [**measures**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) in a [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7) that derive from a single fact table, typically in a data source view. +> +> **member**: (1) An identity that belongs to a shared space. +> +> \(2\) See [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32). +> +> **member property**: An attribute on a data item within a specific dimension in an Online Analytical Processing (OLAP) database. +> +> **merge conflict**: A problem that occurs if two users are editing the same cell or other type of object in a workbook while changes are being merged in a shared workbook. +> +> **merged cell**: A single cell that is created by combining two or more adjacent cells. +> +> **messaging system service provider**: A business that supplies email and other messaging services to individuals, businesses, and other organizations. +> +> **metafile**: A file that stores an image as graphical objects, such as lines, circles, and polygons, instead of pixels. A metafile preserves an image more accurately than pixels when an image is resized. +> +> **Microsoft Office Web Components**: A set of controls that can be used to create data analysis and reporting solutions. +> +> **minimal save**: A process that saves only critical workbook data to disk when errors are detected during a file save operation. +> +> **minor gridline**: A horizontal or vertical line that is in the plot area of a chart and corresponds to the minor scaling unit on an axis. +> +> **minor scheme**: A font scheme that is used for secondary text elements, such as body text, in a [**theme**](#gt_8b5eb4c0-949b-47d9-8b63-b9bda81d61b8). +> +> **minor tick mark**: A tick mark that corresponds to a minor scaling unit on an axis. +> +> **module**: A collection of routines and data structures that performs a specific task or implements a specific abstract data type. Modules usually consist of two parts, a module header and a module body. A module header is a set of name/value attribute pairs that specify the linguistic characteristics of the module. A module body is the VBA source code, a set of declarations followed by procedures. VBA supports two types of modules, procedural modules and class modules. +> +> **moving average**: A type of trendline that is calculated based on the most recent period of data points in a series. +> +> **Multidimensional Expressions (MDX)**: A syntax that is used for defining multidimensional objects, and for querying and manipulating multidimensional data. +> +> **named range**: See [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). +> +> **narrow katakana**: A non-cursive [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204) that is used to write non-Japanese words phonetically in Japanese. Narrow katakana characters are represented with a single byte. Also referred to as half-width katakana. +> +> **natural language formula**: A syntax for referring to tabular data in formulas by using column and row labels instead of cell references. +> +> **natural language label**: A value of a cell or cells that identifies a range in a natural language formula. A label is typically the same as a column or row header in tabular data. +> +> **ninched**: A condition in which a group of selected cells or objects do not share a specific property. For example, if a selection has three cells and only two of the cells share the same color formatting, the color formatting of the selection is in a ninched state. +> +> **non-contiguous range**: A selected [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that includes non-adjacent cells. +> +> **Normal view**: A document view that displays text formatting and a simplified page layout of a document. The Normal view hides some layout elements such as the header and footer. Referred to as Draft view in Microsoft Office Word 2007 and Microsoft Word 2010. +> +> **number format**: A property of a cell or other type of object that determines how numerical data is displayed or interpreted. For example, a currency number format affixes the proper currency symbol to the number. +> +> **obfuscation key**: A secret shared key combined with a cryptographic hash function that is intended to prevent a reversal of an encoding process. See also [**XOR obfuscation**](#gt_cbfd1a35-e8c9-4c5a-bc26-e618633d2f50). +> +> **Object Linking and Embedding (OLE)**: A technology for transferring and sharing information between applications by inserting a file or part of a file into a compound document. The inserted file can be either embedded or linked. See also [**embedded object**](#gt_708607be-8655-416e-93f3-b434e9ecbd56) and [**linked object**](#gt_cfc45e76-9219-4c47-9ef2-5832a172f795). +> +> **object model**: A collection of object-oriented APIs that represent data structures and are designed to promote software interoperability. +> +> **OCXDropDown control**: A type of DropDown control that displays a list of the ActiveX controls that are available within that application. +> +> **Office data connection (ODC) file**: A file that stores information about a connection to a data source, such as an Access database, worksheet, or text file. This file facilitates data source administration. +> +> **OLAP calculated member**: An [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) whose value is calculated at run time. +> +> **OLAP cube**: A data structure that aggregates [**Online Analytical Processing (OLAP)**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) measures by [**OLAP levels**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) and [**OLAP hierarchies**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c). An OLAP cube combines several OLAP hierarchies, such as time, geography, and product lines, with OLAP measures, such as sales or inventory figures. +> +> **OLAP hierarchy**: An [**attribute hierarchy**](#gt_8f75d668-e8c6-4f42-ba44-d90604d3b9dc) or a user-defined hierarchy in a data structure. By default, each dimension attribute has an attribute hierarchy. A user-defined hierarchy is a set of related attribute hierarchies that is used to facilitate browsing an [**OLAP cube**](#gt_11427e13-37ed-49dd-8f0d-5f2b21f7aa4c). +> +> **OLAP KPI**: See [**key performance indicator (KPI)**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8). +> +> **OLAP level**: Within an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c), a set of data that is organized into a lower or higher level of detail, such as Year, Quarter, Month, and Day levels in a Time hierarchy. +> +> **OLAP measure**: A set of numeric values in an [**OLAP cube**](#gt_11427e13-37ed-49dd-8f0d-5f2b21f7aa4c) that is used in aggregation and analysis. +> +> **OLAP measure group**: A collection of related [**OLAP measures**](#gt_7431c051-4564-4476-ad00-39c66f169118) in an [**OLAP cube**](#gt_11427e13-37ed-49dd-8f0d-5f2b21f7aa4c). An OLAP cube can contain multiple measure groups. +> +> **OLAP member**: An item that is in an [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168). For example, a Canada member in a Country level of a Geography hierarchy. +> +> **OLAP member property**: A relationship between two [**OLAP hierarchies**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c), such as a Population member property of a Country member. +> +> **OLAP named set**: A collection of [**OLAP tuples**](#gt_3a1a687f-d28b-485b-96a0-ba0b7eb4119e) that have the same dimensionality. Also referred to as OLAP set. +> +> **OLAP set**: A collection of [**OLAP tuples**](#gt_3a1a687f-d28b-485b-96a0-ba0b7eb4119e) with the same dimensionality. Also referred to as OLAP named set. +> +> **OLAP tuple**: An ordered collection of members that are from different dimensions of an [**OLAP cube**](#gt_11427e13-37ed-49dd-8f0d-5f2b21f7aa4c). A single member is a special case of a tuple. +> +> **OLE compound file**: A form of structured storage, as described in [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b). A compound file allows independent storages and streams to exist within a single file. +> +> **OLE DB**: A set of interfaces that are based on the Component Object Model (COM) programming model and expose data from a variety of sources. These interfaces support the amount of Database Management System (DBMS) functionality that is appropriate for a data store and they enable a data store to share data. +> +> **OLE link**: A connection between an [**Object Linking and Embedding (OLE)**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) object and its OLE server. See also [**DDE link**](#gt_0aa0fad9-afc1-4433-b772-2dc11e641721). +> +> **OLE object**: An object that supports the [**Object Linking and Embedding (OLE)**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) protocol. +> +> **OLE server**: An application or DLL that supplies a linked or embedded OLE object to another application. +> +> **OLE2**: See [**Object Linking and Embedding (OLE)**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c). +> +> **one-variable data table**: A data table that consists of only one input cell, which is either a row input cell or a column input cell. +> +> **Online Analytical Processing (OLAP)**: A technology that uses multidimensional structures to provide access to data for analysis. The source data for OLAP is stored in data warehouses in a relational database. See also [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7). +> +> **Open Database Connectivity (ODBC)**: A standard software API method for accessing data that is stored in a variety of proprietary personal computer, minicomputer, and mainframe databases. It is an implementation of [\[ISO/IEC9075-3:2008\]](https://go.microsoft.com/fwlink/?LinkId=223900) and provides extensions to that standard. +> +> **outline**: A nested grouping of rows or columns that are in a worksheet. +> +> **outline effect**: A formatting effect in which a line is placed around the edge of a shape or around each character in a text string. +> +> **outline level**: The number of levels that a task is indented from the top level of an outline; the order associated with an outline. +> +> **outline state**: A setting that specifies whether an outline is currently outline expanded or outline collapsed. +> +> **out-of-memory**: A state of a computer or application when it halts because all of the available volatile memory has been allocated and none is currently available for reallocation. +> +> **page break**: A divider that breaks a worksheet into separate pages for printing. Page breaks are inserted automatically based on the paper size, margin settings, scaling options, and the positions of any page breaks that are inserted manually. +> +> **Page Break Preview view**: A worksheet view that displays the areas to be printed and the locations of page breaks. +> +> **Page Layout view**: A sheet view that displays a sheet as it would appear on a printed page, including margins, header and footer elements, and pagination. +> +> **palette color**: A specific color among those that are available on the active color palette. +> +> **pane**: A portion of a software window that has a distinct function and is bounded by and separated from other portions of the window by vertical or horizontal bars. +> +> **Pane control**: A type of toolbar control that hosts a window within itself. The hosted window is not constrained by the layout and control type options of a basic toolbar or a menu toolbar. +> +> **parameterized query**: A query that contains parameters. It applies to Open Database Connectivity (ODBC) and web queries. For example, a web query that retrieves stock quotes from a webpage can prompt users for a parameter, such as a stock symbol. +> +> **phonetic guide**: A set of supplemental phonetic symbols that appears above text in Japanese and other East Asian languages. A phonetic guide is displayed automatically and can be edited by the user. +> +> **phonetic information**: A series of characters that appear above text in a cell and provide information that helps users pronounce the text. +> +> **phonetic string**: A series of characters that appear above a string and provide information that helps users pronounce the string. Phonetic strings are typically used in East Asian languages. +> +> **phonetic text run**: A series of characters that are within a [**phonetic string**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77). +> +> **PivotChart filter pane**: A user interface element that displays a list of active fields in a PivotChart view and is used to apply filters to those fields. +> +> **PivotTable field list**: A user interface element that displays a list of all of the fields in a PivotTable report. It can be used to populate a PivotTable report and to manipulate the fields. +> +> **pixel**: A discrete unit of display on a computer display device. +> +> **placeholder**: A character or symbol that is used in place of an actual value, text, or object. The actual value that the placeholder represents is unknown or unavailable at the current time, or is not displayed for security reasons. +> +> **plot area**: A portion of a chart area that contains the plotted data and axes. +> +> **point**: A unit of measurement for fonts and spacing. A point is equal to 1/72 of an inch. +> +> **Popup control**: A built-in or custom control on a menu bar or toolbar that displays a menu of related commands when clicked. +> +> **post method**: A method of submitting form data in the header of an HTTP request. +> +> **precision as displayed**: A calculation setting that permanently changes stored values in cells from full precision (15 digits) to the currently displayed format, including the number of decimal places. +> +> **primary pie**: The main chart in a bar of pie or pie of pie chart. A primary pie chart has one pie slice (data point) that is a grouping of data points. +> +> **print area**: A collection of one or more ranges of cells that are designated to be printed. If a worksheet includes a print area, only the content inside the print area is printed. +> +> **print settings**: The settings that specify how a file is printed in a specific print job, such as duplex or landscape orientation. Printer settings are settings that can differ from printer to printer but apply to every print job of a given printer. Print settings are values that typically vary between print jobs. +> +> **print titles**: The rows or columns that appear on each page when a page is printed. Print titles are typically used to print column headers above tabular data that spans several printed pages. +> +> **ProgID**: An identifier that is used by the Windows registry to uniquely identify an object and is in the form OLEServerName.ObjectName, for example, "Excel.Sheet" or "PowerPoint.Slide." +> +> **property stream**: A series of object properties that is used in processes such as checksum calculations. +> +> **protected**: A property that is applied manually to a file or a portion of a file, with or without a password, and that helps prevent users from accidentally or deliberately changing, moving, or deleting data. +> +> **protection**: A mechanism that helps restrict users from making unwanted changes to the data or structure of a workbook. +> +> **published**: A condition of portions of a workbook that are marked as being available to the user when that workbook is processed by a protocol server. +> +> **published item**: A specific named object that is in a published workbook. +> +> **query**: A formalized instruction to a data source to either extract data or perform a specified action. A query can be in the form of a query expression, a method-based query, or a combination of the two. The data source can be in different forms, such as a relational database, XML document, or in-memory object. See also search query. +> +> **query table**: A two-dimensional table that presents data from an external data source. +> +> **R1C1**: A [**reference style**](#gt_71d7e4ad-d6b6-49d9-b247-e2ebba1469e9) in which each row and each column has a numeric heading that is numbered sequentially from top to bottom and left to right, respectively. "R" stands for row and "C" stands for column. +> +> **range**: An addressable region that is in a workbook. A range typically consists of zero or more cells and represents a single, contiguous rectangle of cells on a single sheet. +> +> **reading order**: The positioning of characters in words and the positioning of words in sentences. This can be left-to-right or right-to-left. +> +> **read-only recommended**: A file sharing property that displays an alert when a file is being opened. The text of the alert recommends that the user open the file with read-only permission. +> +> **real-time data (RTD)**: Data that is pushed into a worksheet from an [**RTD server**](#gt_d4fc2cb5-c030-4ce4-9078-69627d562fc7) and is updated continually. Real-time data is frequently used to track stock prices or inventory levels in real time. +> +> **recalculate**: The process of computing a value in a workbook by initiating a calculation repeatedly. +> +> **reconnect condition**: A condition that specifies whether to connect to a database again after a connection expires. +> +> **rectangular gradient**: A type of gradient fill in which the color of a cell or other object gradually changes with each successive inner rectangle of pixels. +> +> **red-green-blue-alpha (RGBA)**: A color model that describes color information in terms of the red (R), green (G), blue (B), and alpha (A) intensities that comprise a color. +> +> **reference style**: A system that is used in formulas to specify cells or ranges of cells. A reference style specifies a cell in a two-dimensional table by identifying the row and column that contain that cell or range of cells. +> +> **refresh**: A process that retrieves values from a data source and populates a workbook with those values. +> +> **regional settings**: See locale settings. +> +> **relative reference**: A reference to a location on a sheet that is relative to the cell that contains the reference. A relative reference can be stored as a cell reference or as an offset. +> +> **relative security descriptor**: A security descriptor that contains all associated security information in a contiguous block of memory. +> +> **result cell**: A cell that contains the results of the calculation of changing cells in a scenario. +> +> **revision**: A change in a document, file, or other object. +> +> **revision history**: A list of data that describes document updates, such as when and by whom a document was modified. +> +> **revision record**: Any of the records in the revision stream of a [**shared workbook**](#gt_241c4cae-c49a-438a-87dc-c8fb2c871921) that stores user edits to the workbook and other tracked information. +> +> **right-to-left**: A reading and display order that is optimized for right-to-left languages. +> +> **routing slip**: Information that specifies how a document is to be distributed from a document originator and processed by one or more recipients. It also specifies subject and message body text that is associated with the document routing process and routing status or workflow information. +> +> **routing stage**: The current status of a document with a routing slip. +> +> **row outline**: A mechanism for grouping and nesting the rows in a worksheet. +> +> **RTD server**: A Component Object Model (COM) Automation server that is used by the real-time data (RTD) function to retrieve data in real time. The RTD server can exist as an ActiveX DLL or as an executable (.exe) file that runs on the same local computer or on a remote server. +> +> **RTD topic**: A discrete combination of parameters that is used to request data from a real-time data (RTD) server. +> +> **ruler**: A user interface element that enables users to adjust page margins and to measure and align objects in a document. +> +> **safe load**: A process of loading a file in which additional error checking is performed and various corruption patterns in the file are detected and repaired. +> +> **scenario**: A named set of input values (changing cells) that can be substituted in a worksheet model. +> +> **Scenario Manager**: A process for creating and managing different sets of input values for calculation models in a worksheet. +> +> **secondary bar/pie**: A secondary chart in a bar of pie or pie of pie chart that displays the detailed data of the grouped data point in the primary pie chart. The secondary bar/pie chart takes the form of a stacked bar chart or a pie chart that is connected to the primary pie chart with series lines. +> +> **security descriptor**: A data structure containing the security information associated with a securable object. A [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) identifies an object's owner by its security identifier (SID). If access control is configured for the object, its [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) contains a discretionary access control list (DACL) with SIDs for the security principals who are allowed or denied access. Applications use this structure to set and query an object's security status. The [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) is used to guard access to an object as well as to control which type of auditing takes place when the object is accessed. The [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) format is specified in [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) section 2.4.6; a string representation of [**security descriptors**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350), called SDDL, is specified in \[MS-DTYP\] section 2.5.1. +> +> **selected**: The condition of a set of items that has focus in a workbook. +> +> **selection**: An item or set of items, such as cells, shapes, objects, and chart elements, that has focus in a document. +> +> **series line**: A supplemental line on a stacked column, stacked bar, pie of pie, or bar of pie chart that connects each data point in a series with the next data point to increase legibility. +> +> **server name**: The name of a server, as specified in the operating system settings for that server. +> +> **shade**: A color that is mixed with black. A 10-percent shade is one part of the original color and nine parts black. +> +> **shadow effect**: A formatting effect that makes a font or object appear to be elevated from the page or screen surface, and therefore casts a shadow. +> +> **shape**: A collection of qualifiers, such as names, and quantifiers, such as coordinates, that is used to represent a geometric object. A shape can be contained in a document, file structure, run-time structure, or other medium. +> +> **shared workbook**: A workbook that is configured to enable multiple users on a network to view and make changes to it at the same time. Each user who saves the workbook sees the changes that are made by other users. +> +> **sheet**: (1) A part of an Excel workbook. There are four types of sheets: [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615), [**macro sheet**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491), [**dialog sheet**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8), and [**chart sheet**](#gt_da561b7b-c629-4cd8-bfaa-6e62471d9e83). Multiple sheets are stored together within a workbook. +> +> \(2\) A worksheet. The term sheet frequently refers to a worksheet because worksheets are the most common type of sheet. +> +> **sheet stream**: See [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) and document stream. +> +> **sheet tab**: A control that is used to select a sheet. +> +> **sheet view**: A collection of display settings, such as which cells are shown, and the zoom level for a sheet window. +> +> **shrink to fit**: The process of adjusting the font size of text in a cell to fit the current height and width of the cell. +> +> **single accounting**: An underline style that places one line beneath the text. Single accounting can be used to indicate subtotals. +> +> **single sign-on (SSO) identifier**: A string that represents the definition of user credentials that permit a user to access a network. See also single sign-on (SSO). +> +> **smart document**: A file that is programmed to assist the user as the user creates or updates the document. Several types of files, such as forms and templates, can also function as smart documents. +> +> **smart tag**: A feature that adds the ability to recognize and label specific data types, such as people's names, within a document and displays an action button that enables users to perform common tasks for that data type. +> +> **smart tag actions button**: A user interface control that displays a menu of actions that are associated with a specific smart tag. +> +> **smart tag indicator**: A triangular symbol that appears in the bottom right corner of a cell and indicates that the cell contains a smart tag. +> +> **sort**: A process that arranges cells in ascending or descending order, based on cell content. +> +> **sort condition**: A condition that determines how to sort cells in a range. +> +> **sort order**: A specific arrangement of cells that is based on cell content. The order can be ascending or descending. +> +> **sort range**: A range of cells that will be or has been sorted. +> +> **source data**: The data that is used as the basis for charts, PivotTable reports, and other data visualization features. +> +> **split pane**: A pane that consists of two or more discrete areas of a window. Each area displays content and scrolls independently from other areas of the window. See also [**frozen panes**](#gt_28507dfc-4443-4a02-a18c-27b5db006946). +> +> **SplitButtonMRUPopup control**: A type of [**SplitButtonPopup control**](#gt_1c046ab6-2530-4a41-8d19-03f92914beaf) whose icon changes to reflect the command that the user most recently selected from the menu that is displayed by that button. +> +> **SplitButtonPopup control**: A type of Button control that performs an action when clicked, and can also display a menu of related commands when the user clicks a drop-down arrow that appears on the button. +> +> **SplitDropDown control**: A type of Button control that performs a default action when clicked, and can also expand to display a list of other possible actions when the user clicks a drop-down arrow that appears on the button. +> +> **startup directory**: The directory from which an application opens data files when the application starts. +> +> **storage**: An element of a compound file that is a unit of containment for one or more storages and streams, analogous to directories in a file system, as described in \[MS-CFB\]. +> +> **stream**: An element of a compound file, as described in \[MS-CFB\]. A stream contains a sequence of bytes that can be read from or written to by an application, and they can exist only in storages. +> +> **strikethrough formatting**: A formatting option in which characters are crossed out by horizontal line. +> +> **stripe band**: One or more adjacent columns or rows that are in a table and have the same stripe formatting. +> +> **stroke order**: A sort order that arranges items in a sort range according to the number of strokes that is used to write each glyph. Stroke order is used when sorting text that is written in some East Asian languages. +> +> **Structured Query Language (SQL)**: A database query and programming language that is widely used for accessing, querying, updating, and managing data in relational database systems. +> +> **style**: A set of formatting options that is applied to text, tables, charts, and other objects in a document. +> +> **subtotal column**: A column that uses a summary or subtotal function to display the total of detail items in a PivotTable field. +> +> **table**: A list that is defined in a workbook. +> +> **template**: A file that contains pre-defined formatting including layout, text and graphics. It serves as the basis for new documents that have a similar look or purpose. See also form template (Microsoft InfoPath) and site template (SharePoint Products and Technologies). +> +> **text importation**: A process that incorporates textual data into a workbook, either by opening a text file or through an external link. +> +> **text query**: A query that is used to import data from text files. +> +> **text run**: A string of characters that represents a discrete span of text with the same formatting properties. +> +> **text style**: A formatting option, such as bold or italic, that can be applied to a font. +> +> **theme**: A set of unified design elements, such as colors, fonts, graphics, and styles, that define the appearance of a website, document, or data visualization. +> +> **time hierarchy**: A specialized Online Analytical Processing (OLAP) hierarchy that can be organized into lower and higher levels of detail, such as Year, Quarter, Month, and Day. +> +> **toolbar control**: An object that appears on a toolbar and enables user interaction or input, typically to initiate an action, display information, or set values. +> +> **toolbar view**: A visual state of a toolbar that depends on the current state of the application. Valid toolbar views are docked, floating, and not visible. +> +> **tooltip**: A window displaying text that is created when the mouse is moved over a window or notification icon. +> +> **top N filter**: A filter that matches the top or bottom N items or N% of items in a specified column. +> +> **total row**: A row in a list or table that provides a selection of aggregate functions that are useful for working with numerical data. +> +> **transfer protocol**: A protocol that governs the transfer of files, Internet messages, and webpages between networked computers. On the Open Systems Interconnection (OSI) Basic Reference Model, these are application layer protocols. Examples of transfer protocols are Hypertext Transfer Protocol (HTTP), Simple Mail Transfer Protocol (SMTP), and File Transfer Protocol (FTP). +> +> **transition formula entry**: A worksheet option that enables users to enter formulas that use IBM Lotus 1-2-3 syntax. +> +> **transition formula evaluation**: A setting that enables formulas in a worksheet to be calculated in a manner that is consistent with IBM Lotus 1-2-3. +> +> **trendline**: A line that is added to a chart to show the trend of multiple data points in a series. A trendline is used to facilitate regression analysis. +> +> **tuple**: An ordered grouping of members from different dimensions or hierarchies. A single member is a special case of a tuple and can be used as an expression. Every hierarchy does not have to be represented in a tuple. +> +> **twip**: A unit of measurement that is used in typesetting and desktop publishing. It equals one-twentieth of a printer's point, or 1/1440 of an inch. +> +> **two-variable data table**: A data table that consists of two input cells, a row input cell and a column input cell. +> +> **type library**: A binary file that describes the methods, properties, and data structure of a component. +> +> **UNC volume**: A storage device that is accessible by network protocols and addressed in the standard Universal Naming Convention format, for example, "\\Server Name\Share Name". +> +> **unfrozen pane**: A portion of a worksheet that continues to scroll and function normally in split pane view. See also [**frozen pane**](#gt_28507dfc-4443-4a02-a18c-27b5db006946). +> +> **Unicode**: A character encoding standard developed by the Unicode Consortium that represents almost all of the written languages of the world. The [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) standard [\[UNICODE5.0.0/2007\]](https://go.microsoft.com/fwlink/?LinkId=154659) provides three forms (UTF-8, UTF-16, and UTF-32) and seven schemes (UTF-8, UTF-16, UTF-16 BE, UTF-16 LE, UTF-32, UTF-32 LE, and UTF-32 BE). +> +> **Uniform Resource Identifier (URI)**: A string that identifies a resource. The URI is an addressing mechanism defined in Internet Engineering Task Force (IETF) Uniform Resource Identifier (URI): Generic Syntax [\[RFC3986\]](https://go.microsoft.com/fwlink/?LinkId=90453). +> +> **Uniform Resource Locator (URL)**: A string of characters in a standardized format that identifies a document or resource on the World Wide Web. The format is as specified in [\[RFC1738\]](https://go.microsoft.com/fwlink/?LinkId=90287). +> +> **up bar**: See [**up-down bar**](#gt_54f291c2-81aa-41b6-8831-88d180a09ea0). +> +> **up-down bar**: A vertical bar that highlights the difference between data points in a line chart that contains more than one data series. +> +> **user name**: A unique name that identifies a specific user account. The user name of an account is unique among the other group names and user names within its own domain or workgroup. +> +> **user-defined function (UDF)**: A function that is coded in a VBA module, macro sheet, [**add-in**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6), or [**Excel Linked Library (XLL)**](#gt_3d6e3f45-91e7-46d5-871c-0b2fde20b5f5). A UDF can be used in formulas to return values to a worksheet, similar to built-in functions. +> +> **VBA project**: A collection of the modules, class modules, and user forms that are needed to create an application. Modules, class modules, and user forms can be imported into and exported from a project. +> +> **Vector Markup Language (VML)**: A system of marking up or tagging two-dimensional vector graphics for publication on the World Wide Web. VML graphics are scalable and editable, and typically require less disk space and less time to download. +> +> **vertical alignment**: A formatting setting that specifies how content is positioned within the vertical space of a cell, object, or page. Content can be aligned along the top or bottom edge, or distributed evenly across the vertical space. +> +> **visible**: A condition of an object that allows it to be displayed in rendered output. +> +> **Visual Basic for Applications (VBA)**: A macro-based programming language that derives from Microsoft Visual Basic and can be used to customize and extend an application. Unlike Visual Basic, VBA code and macros can be run only from within a host application that supports VBA. +> +> **volatile**: A condition of a formula in which the formula is calculated every time the workbook is calculated. This is unlike a non-volatile formula, which is calculated only when dependent values are changed. +> +> **wall**: An extension of the background of a 3-D chart to create a three-dimensional effect. See also [**floor**](#gt_dc38c098-e0d3-4701-9656-5f2cf4d80f29). +> +> **watched cell**: A cell whose value is monitored in a separate window while formulas that are associated with the cell are calculated. +> +> **web query**: An external data connection that retrieves a table from a website and inserts table data into a workbook. +> +> **web-only view**: A view of a workbook from within a web browser. +> +> **wide katakana**: A non-cursive [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204) that is used to write non-Japanese words phonetically in Japanese. Wide katakana characters are represented with two bytes. +> +> **window state**: The current positioning state of a window. Windows can be maximized or minimized, or the window size can be customized by the user. +> +> **workbook**: A container for a collection of [**sheets (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). +> +> **workbook parameter**: A single cell that is designated to receive input from users. +> +> **worksheet**: A single logical container for a set of tabular data and other objects in a workbook. +> +> **write reservation**: A field or condition that is set on a document, workbook, or presentation to help prevent users from modifying it. +> +> **XML**: The Extensible Markup Language, as described in [\[XML1.0\]](https://go.microsoft.com/fwlink/?LinkId=90599). +> +> **XML map**: A feature that is used to import data from databases and applications and to map XML elements and attributes from the associated [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) to cells in a worksheet. The revised [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) data can then be exported for interaction with other databases and applications. +> +> **XML namespace**: A collection of names that is used to identify elements, types, and attributes in XML documents identified in a URI reference \[RFC3986\]. A combination of XML namespace and local name allows XML documents to use elements, types, and attributes that have the same names but come from different sources. For more information, see [\[XMLNS-2ED\]](https://go.microsoft.com/fwlink/?LinkId=90602). +> +> **XML node**: The smallest unit of a valid, complete structure in an XML document. For example, a node can represent an element, an attribute, or a text string. +> +> **XML Path Language (XPath)**: A language used to create expressions that can address parts of an XML document, manipulate strings, numbers, and Booleans, and can match a set of nodes in the document, as specified in \[XPATH\]. XPath models an XML document as a tree of nodes of different types, including element, attribute, and text. XPath expressions can identify the nodes in an XML document based on their type, name, and values, as well as the relationship of a node to other nodes in the document. +> +> **XML schema**: A description of a type of XML document that is typically expressed in terms of constraints on the structure and content of documents of that type, in addition to the basic syntax constraints that are imposed by [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) itself. An XML schema provides a view of a document type at a relatively high level of abstraction. +> +> **XML schema definition (XSD)**: The World Wide Web Consortium (W3C) standard language that is used in defining XML schemas. Schemas are useful for enforcing structure and constraining the types of data that can be used validly within other XML documents. XML schema definition refers to the fully specified and currently recommended standard for use in authoring [**XML schemas**](#gt_bd0ce6f9-c350-4900-827e-951265294067). +> +> **XOR obfuscation**: A type of file encryption that helps protect private data by using an exclusive or bitwise operation. This is done by adding a mathematical expression that prevents a simple reverse-engineering process. +> +> **XPath expression**: An expression that searches an71 XML document and can extract and manipulate data in elements or attributes within that document. +> +> **zoom level**: The degree to which a portion of an image, document, or other screen object is made to appear closer or farther away relative to its default appearance. This value is usually expressed as a percentage of the default appearance. +> +> **z-order**: The rendering order of an object on a z axis. +> +> **MAY, SHOULD, MUST, SHOULD NOT, MUST NOT:** These terms (in all caps) are used as defined in [\[RFC2119\]](https://go.microsoft.com/fwlink/?LinkId=90317). All statements of optional behavior use either MAY, SHOULD, or SHOULD NOT. + +## References + +Links to a document in the Microsoft Open Specifications library point to the correct section in the most recently published version of the referenced document. However, because individual documents in the library are not updated at the same time, the section numbers in the documents may not match. You can confirm the correct section numbering by checking the [Errata](https://go.microsoft.com/fwlink/?linkid=850906). + +### Normative References + +We conduct frequent surveys of the normative references to assure their continued availability. If you have any issue with finding a normative reference, please contact . We will assist you in finding the relevant information. + +\[CODEPG\] Microsoft Corporation, "Code Pages", [https://learn.microsoft.com/en-us/globalization/encoding/code-pages](https://go.microsoft.com/fwlink/?LinkId=89840) + +\[DEVMODE\] Microsoft Corporation, "DEVMODE structure", [http://msdn.microsoft.com/en-us/library/dd183565(VS.85).aspx](https://go.microsoft.com/fwlink/?LinkId=89844) + +\[ECMA-376\] ECMA International, "Office Open XML File Formats", [https://www.ecma-international.org/publications-and-standards/standards/ecma-376/](https://go.microsoft.com/fwlink/?LinkId=200054) + +\[IEEE754\] IEEE, "IEEE Standard for Binary Floating-Point Arithmetic", IEEE 754-1985, October 1985, [http://ieeexplore.ieee.org/servlet/opac?punumber=2355](https://go.microsoft.com/fwlink/?LinkId=89903) + +\[MS-CFB\] Microsoft Corporation, "[Compound File Binary File Format](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b)". + +\[MS-CTXLS\] Microsoft Corporation, "[Excel Custom Toolbar Binary File Format](%5bMS-CTXLS%5d.pdf#Section_b461dcd9933e471081bcdc1c74801b6b)". + +\[MS-DTYP\] Microsoft Corporation, "[Windows Data Types](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2)". + +\[MS-LISTSWS\] Microsoft Corporation, "[Lists Web Service Protocol](%5bMS-LISTSWS%5d.pdf#Section_30b364cc38374e839ce81963292e2ee5)". + +\[MS-OAUT\] Microsoft Corporation, "[OLE Automation Protocol](%5bMS-OAUT%5d.pdf#Section_bbb05720f72445c78d17f83c3d1a3961)". + +\[MS-ODRAW\] Microsoft Corporation, "[Office Drawing Binary File Format](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872)". + +\[MS-OFFCRYPTO\] Microsoft Corporation, "[Office Document Cryptography Structure](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083)". + +\[MS-OLEDS\] Microsoft Corporation, "[Object Linking and Embedding (OLE) Data Structures](%5bMS-OLEDS%5d.pdf#Section_85583d21c1cf4afea35fd6701c5fbb6f)". + +\[MS-OSHARED\] Microsoft Corporation, "[Office Common Data Types and Objects Structures](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d)". + +\[MS-OVBA\] Microsoft Corporation, "[Office VBA File Format Structure](%5bMS-OVBA%5d.pdf#Section_575462babf6741909facc275523c75fc)". + +\[MS-PRSTFR\] Microsoft Corporation, "[ADO XML Persistence Format](%5bMS-PRSTFR%5d.pdf#Section_7e50a09b3cf44bd9ae0c3eccddabe363)". + +\[MS-VIEWSS\] Microsoft Corporation, "[Views Web Service Protocol](%5bMS-VIEWSS%5d.pdf#Section_84e77d68e69244ba9e4e1d08abcb2d99)". + +\[MS-WSSTS\] Microsoft Corporation, "[Windows SharePoint Services](%5bMS-WSSTS%5d.pdf#Section_52b95801d55f4d63a1c3b4e857c43b31)". + +\[RFC1320\] Rivest, R., "The MD4 Message-Digest Algorithm", RFC 1320, April 1992, [https://www.rfc-editor.org/info/rfc1320](https://go.microsoft.com/fwlink/?LinkId=90274) + +\[RFC1321\] Rivest, R., "The MD5 Message-Digest Algorithm", RFC 1321, April 1992, [https://www.rfc-editor.org/info/rfc1321](https://go.microsoft.com/fwlink/?LinkId=90275) + +\[RFC1951\] Deutsch, P., "DEFLATE Compressed Data Format Specification version 1.3", RFC 1951, May 1996, [https://www.rfc-editor.org/info/rfc1951](https://go.microsoft.com/fwlink/?LinkId=90302) + +\[RFC2119\] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997, [https://www.rfc-editor.org/info/rfc2119](https://go.microsoft.com/fwlink/?LinkId=90317) + +\[RFC2781\] Hoffman, P., and Yergeau, F., "UTF-16, an encoding of ISO 10646", RFC 2781, February 2000, [https://www.rfc-editor.org/info/rfc2781](https://go.microsoft.com/fwlink/?LinkId=90380) + +\[RFC3986\] Berners-Lee, T., Fielding, R., and Masinter, L., "Uniform Resource Identifier (URI): Generic Syntax", STD 66, RFC 3986, January 2005, [https://www.rfc-editor.org/info/rfc3986](https://go.microsoft.com/fwlink/?LinkId=90453) + +\[RFC5234\] Crocker, D., Ed., and Overell, P., "Augmented BNF for Syntax Specifications: ABNF", STD 68, RFC 5234, January 2008, [https://www.rfc-editor.org/info/rfc5234](https://go.microsoft.com/fwlink/?LinkId=123096) + +\[SCHNEIER\] Schneier, B., "Applied Cryptography, Second Edition", John Wiley and Sons, 1996, ISBN: 0471117099. + +\[XMLDSig\] Bartel, M., Boyer, J., Fox, B., et al., "XML-Signature Syntax and Processing", W3C Recommendation, February 2002, [http://www.w3.org/TR/2002/REC-xmldsig-core-20020212/](https://go.microsoft.com/fwlink/?LinkId=130861) + +\[XMLNS\] Bray, T., Hollander, D., Layman, A., et al., Eds., "Namespaces in XML 1.0 (Third Edition)", W3C Recommendation, December 2009, [https://www.w3.org/TR/2009/REC-xml-names-20091208/](https://go.microsoft.com/fwlink/?LinkId=191840) + +\[XMLSCHEMA1/2\] Thompson, H., Beech, D., Maloney, M., and Mendelsohn, N., Eds., "XML Schema Part 1: Structures Second Edition", W3C Recommendation, October 2004, [https://www.w3.org/TR/2004/REC-xmlschema-1-20041028/](https://go.microsoft.com/fwlink/?LinkId=90607) + +\[XMLSCHEMA2/2\] Biron, P., and Malhotra, A., Eds., "XML Schema Part 2: Datatypes Second Edition", W3C Recommendation, October 2004, [https://www.w3.org/TR/2004/REC-xmlschema-2-20041028/](https://go.microsoft.com/fwlink/?LinkId=90609) + +### Informative References + +\[MSDN-ASRSD\] Microsoft Corporation, "Absolute and Self-Relative Security Descriptors", [http://msdn.microsoft.com/en-us/library/aa374807.aspx](https://go.microsoft.com/fwlink/?LinkId=119907) + +\[MSDN-BMP\] Microsoft Corporation, "Types of Bitmaps", [http://msdn.microsoft.com/en-us/library/ms536393.aspx](https://go.microsoft.com/fwlink/?LinkId=89960) + +\[MSDN-FONTS\] Microsoft Corporation, "About Fonts", [http://msdn.microsoft.com/en-us/library/dd162470(VS.85).aspx](https://go.microsoft.com/fwlink/?LinkId=90008) + +\[MSDN-OpenDBConnectivity\] Microsoft Corporation, "Microsoft Open Database Connectivity (ODBC)", [http://msdn.microsoft.com/en-us/library/ms710252.aspx](https://go.microsoft.com/fwlink/?LinkId=114655) + +\[MSDN-OSTD\] Microsoft Corporation, "Overview of Smart Tag Development \[Office 2003 SDK Documentation\]", [http://msdn.microsoft.com/en-us/library/aa169328.aspx](https://go.microsoft.com/fwlink/?LinkId=120036) + +\[MSDN-SOM\] Microsoft Corporation, "SOM Reference", [http://msdn.microsoft.com/en-us/library/ms754618(VS.85).aspx](https://go.microsoft.com/fwlink/?LinkID=156653&clcid=0x409) + +## Overview + +This document specifies [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) data contained in a compound file as described in [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b). The data is stored in the compound file by using storages, **streams** (section [2.1.2](#Section_f67ac5edb0a74b2c9b7a28933eeaac7e)), and **substreams** (section [2.1.3](#Section_5e380e95a9f54dfdb6d9c6998a9772f8)) that contain information about the content and structure of a workbook, including workbook data such as [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) definitions. Some storages, **streams**, and **substreams** store information by using binary **records** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)). The binary **record** (section 2.1.4) structure and content are specified in this document. Each binary **record** contains its record type, information about the record size, and zero or more type-specific fields depending on the record type, which is specified in section [2.3](#Section_7c84e174e96f45e0b23fa5e81f8b5def). Type-specific fields contain information further specifying the workbook data. Specifications of the fields for a given record type can be found in section [2.4](#Section_6fba03830d7a4c7aafe9642ff70cbd36). + +See the **File Structure** section (section [2.1](#Section_2e6147d9e8ad48b09ff7bbfc51ca950d)) for a more detailed overview of specific file architecture and content. + +### stream Byte Ordering + +Some computer architectures number bytes in a binary word from left to right, which is referred to as [**big-endian**](#gt_6f6f9e8e-5966-4727-8527-7e02fb864e7e). This documentation uses big-endian bit diagrams. Other architectures number the bytes in a binary word from right to left, which is referred to as [**little-endian**](#gt_079478cb-f4c5-4ce5-b72b-2144da5d2ce7). The underlying file format enumerations, objects, and records are little-endian. + +Using big-endian and little-endian methods, the number 0x12345678 would be stored as shown in the following table: + +| Byte order | Byte 0 | Byte 1 | Byte 2 | Byte 3 | +|---------------|--------|--------|--------|--------| +| Big-endian | 0x12 | 0x34 | 0x56 | 0x78 | +| Little-endian | 0x78 | 0x56 | 0x34 | 0x12 | + +Unless otherwise specified, all data in files of the type specified by this document are stored in little-endian format. + +### Organization of This Documentation + +Section [2](#Section_c227d7656ccf411a84f4198592b6f843) of this document is arranged with overviews of higher-level concepts being followed by more detailed concepts. Section [2.1](#Section_2e6147d9e8ad48b09ff7bbfc51ca950d) and section [2.2](#Section_492295cd134443929aa9717534c9d475), in particular, specify higher-level concepts that are required to understand the remainder of the document, and are read before reading the remainder of section 2. + +Section 2.1 specifies the structures and concepts that are used to organize and structure the file itself. Subsection [2.1.7](#Section_e1ea0a148d2c469b8875272091ea5aa9) further specifies the valid storages, **streams** (section [2.1.2](#Section_f67ac5edb0a74b2c9b7a28933eeaac7e)), and **substreams** (section [2.1.3](#Section_5e380e95a9f54dfdb6d9c6998a9772f8)) allowed within files of the type specified by this document. + +Section 2.2 specifies higher-level concepts that are normatively described for use in later sections of this document. + +Section [2.3](#Section_7c84e174e96f45e0b23fa5e81f8b5def) specifies the record name associated with a given record type. For more information about record types, see section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388). These associations are listed by record name as well as by record type. + +Section [2.4](#Section_6fba03830d7a4c7aafe9642ff70cbd36) specifies the details of individual records. + +Section [2.5](#Section_67410b0bfca64019ae2da53f9d392e03) specifies the details of structures used by records and other structures. + +Section [3](#Section_ff0abdfb49934cfd99d476cb2d3b2cde) provides specific examples intended to illustrate the concepts, records, and structures of this file format. + +Section [4](#Section_6df63a1fecd54d13801ea5321aa39caa) discusses encryption, obfuscation and other security issues relating to files of the type specified by this document. + +Section 5 is a list of version-specific behaviors. It is not intended to be read alone, but rather to be understood in the context of specifications in section 2. Specifications in section 2 provide links to the relevant items in Section 5. + +## Relationship to Protocols and Other Structures + +The Excel Binary File Format is an [**OLE compound file**](#gt_b39d4d3a-2d16-4bab-b9fd-ba8e1f16e6a4) as described in [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b). It is dependent on the structures defined in the following references: + +- [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) for the persistence of custom [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) mappings. + +- [\[MS-CTXLS\]](%5bMS-CTXLS%5d.pdf#Section_b461dcd9933e471081bcdc1c74801b6b) for command bar tables. + +- [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) for the persistence format for [**shapes**](#gt_d0e38aa4-2c71-4a6f-b5e6-75766fa9409e). + +- [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) for the persistence format for document signing, information rights management, document encryption and obfuscation. + +- [\[MS-OVBA\]](%5bMS-OVBA%5d.pdf#Section_575462babf6741909facc275523c75fc) for the persistence format for a [**VBA project**](#gt_980e3334-2874-4425-a73a-f2235cec1e1e). + +- [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) for the persistence format for additional common structures. + +## Applicability Statement + +This document specifies a persistence format for [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) content and templates, which can include unstructured or semi-structured tables of numbers, text, or both numbers and text, formulas, external data connections, charts and images. This persistence format is applicable for persistence of documents with a grid-based layout, including those with numeric data, structured data, and formulas. + +This persistence format is applicable for use as a stand-alone document, and for containment within other documents as an embedded object as described in [\[MS-OLEDS\]](%5bMS-OLEDS%5d.pdf#Section_85583d21c1cf4afea35fd6701c5fbb6f). + +This persistence format provides interoperability with applications that create or read documents conforming to this structure. + +## Versioning and Localization + +This document covers versioning issues in the following areas: + +**Structure Versions:** There is only one version of the Excel Binary File Format (.xls) Structure Specification. + +**Localization:** The following records and structures contain fields that specify locale-dependent meaning: + +- **Header** (section [2.4.136](#header)) + +- **Footer** (section [2.4.124](#footer)) + +- **Format** (section [2.4.126](#format)) + +- **CodeName** (section [2.4.51](#codename)) + +- **Font** (section [2.4.122](#font)) + +The Security Considerations section (section [4](#Section_6df63a1fecd54d13801ea5321aa39caa)), the **Password Verifier Algorithm** section (section [2.2.9](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4)), the Encryption (Password to Open) section (section [2.2.10](#Section_0f2ea0a19fc8468d97aa9d333b72d106)), and the **Macro Sheet Substream** section (section [2.1.7.20.4](#Section_0dddd943f77a4fc2bf92868acb4587f7)) also specify processes and data that are locale-dependent. See each record, structure, and section description for more information. + +## Vendor-Extensible Fields + +This persistence format can be extended by storing information in [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) and storages not specified in section [2](#Section_c227d7656ccf411a84f4198592b6f843). Implementations are not required to preserve or remove additional streams or storages when modifying an existing document. + +# Structures + +## File Structure + +This section specifies the overall structure of a file that conforms to this specification. + +A file of the type specified by this document is an [**OLE compound file**](#gt_b39d4d3a-2d16-4bab-b9fd-ba8e1f16e6a4). A **compound file** (section [2.1.1](#Section_b91df1c96bfa4ab482187bb0d73624ca)) contains storages, **streams** (section [2.1.2](#Section_f67ac5edb0a74b2c9b7a28933eeaac7e)), and **substreams** (section [2.1.3](#Section_5e380e95a9f54dfdb6d9c6998a9772f8)). Each **stream** or **substream** contains a series of binary **records** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)). Each binary **record** contains zero or more structured fields that contain the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) data. + +### Compound File + +A file of the type specified by this document MUST be an [**OLE compound file**](#gt_b39d4d3a-2d16-4bab-b9fd-ba8e1f16e6a4) as specified in [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b). + +### Stream + +A file of the type specified by this document consists of storages and [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) as specified in [\[MS-CFB\]](%5bMS-CFB%5d.pdf#Section_53989ce47b054f8d829bd08d6148375b). Each binary stream or **substream** (section [2.1.3](#Section_5e380e95a9f54dfdb6d9c6998a9772f8)) that contains [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) data MUST be written as a series of binary **records** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)) as specified in section [2.1.7](#Section_e1ea0a148d2c469b8875272091ea5aa9). + +The valid storages, streams, and **substreams** in a file of the type specified by this document are specified in section 2.1.7. + +A workbook MUST contain the **workbook** stream (section [2.1.7.20](#Section_f682f4b08c6b444e83f852d156f1e8ba)), with at least one [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) **substream** (**Worksheet Substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)), **Chart Sheet Substream** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)), **Macro Sheet Substream** (section [2.1.7.20.4](#Section_0dddd943f77a4fc2bf92868acb4587f7)), or **Dialog Sheet Substream** (section [2.1.7.20.2](#Section_da37feb48b9a462d87772a5fddd4866e))) that follows the **Globals Substream** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). + +This document uses [**Augmented Backus-Naur Form (ABNF)**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) as specified in [\[RFC5234\]](https://go.microsoft.com/fwlink/?LinkId=123096) to specify the **record** sequence for **streams** and **substreams** that contain binary **records**. + +### Substream + +The **workbook** stream (section [2.1.7.20](#Section_f682f4b08c6b444e83f852d156f1e8ba)) contains substreams that specify global properties and data for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and specify the [**sheets (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that constitute the workbook. The beginning of each substream is marked by a **BOF** record (section [2.4.21](#bof)) that has a **dt** field that specifies the type of the substream. The end of each substream is marked by an **EOF record** (section [2.4.103](#eof)). + +For more information about these substreams, see section 2.1.7.20 and subsections. + +### Record + +A record is the basic building block used to store information about features in a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). Each binary record is a variable-length sequence of bytes. A binary record consists of three components: a record type, a record size, and the record data that is specific to that record type. + +The record type is a two-byte unsigned integer that specifies what type of information is specified by the record and how the structure of the record data specific to this record is ordered and structured. Record type values MUST be a value from the **Record** Enumeration (section [2.3](#Section_7c84e174e96f45e0b23fa5e81f8b5def)) or the record MUST make use of the **future record** architecture (section [2.1.6](#Section_b660b67822684414839ed1ae9a4e4e85)). + +The record size is a two-byte unsigned integer that specifies the count of bytes that specifies the total size of the record data. The record size MUST be greater than or equal to 0 and MUST be less than or equal to 8224. + +The record data component contains fields that correspond to a particular record type and comprise the remainder of the record. The order and structure of the fields for a given record type listed in section 2.3 are specified in the corresponding section for that record type in section [2.4](#Section_6fba03830d7a4c7aafe9642ff70cbd36). The size of the record data component MUST be equal to the record size. Fields in the record data component can contain simple values, arrays of values, structures of several fields, arrays of fields, and arrays of structures. + +If the total number of bytes to be written for a given record data component is greater than 8224, a collection of **Continue** (section [2.4.58](#continue)), **ContinueFrt** (section [2.4.60](#continuefrt)), **ContinueFrt11** (section [2.4.61](#continuefrt11)), or **ContinueFrt12** (section [2.4.62](#continuefrt12)) records, as specified in the respective [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) for that record, is used to contain the remaining record data. In general, the first 8224 bytes of data is contained in the record data component of the given record and the remaining data is divided into blocks of 8224 bytes and contained in the subsequent collection of **Continue** (section 2.4.58), **ContinueFrt** (section 2.4.60), **ContinueFrt11** (section 2.4.61), or **ContinueFrt12** records, until all the data is written. See specific record definitions for exceptions. **ContinueBigName** (section [2.4.59](#continuebigname)) and **CrtMlFrtContinue** (section [2.4.71](#crtmlfrtcontinue)) are special cases that only apply to a single record type. + +### Collection of Records + +A collection of **records** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)) is a series of related **records** that are treated as a single set. **Records** in a collection do not have to share the same **record** type. A collection of **records** can further contain other collections of **records**. The beginning of a collection of **records** is sometimes indicated by a different type of **record**, as specified in the **record** sequence [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) where the rule that contains that **record** is specified. Similarly the end of a collection of **records** is sometimes indicated by a different type of **record**, as specified by the **record** sequence ABNF where the rule that contains that **record** is specified. Each **record** or collection within the collection can be referred to by index, and the index count starts over for each collection. + +In this document, **record** A precedes **record** B when **record** A is the last **record** of that type to appear before **record** B, in the **stream** (section [2.1.2](#Section_f67ac5edb0a74b2c9b7a28933eeaac7e)) or **substream** (section [2.1.3](#Section_5e380e95a9f54dfdb6d9c6998a9772f8)) that contains those **records**. + +In this document, **record** B follows **record** A when **record** A is the last **record** of that type to appear before **record** B, in the **stream** or **substream** that contains those **records**. + +### Future Record + +The future record architecture enables an application that does not support certain **records** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)) to open and save the file while ignoring but preserving those **records** in the file. **Records** that contain an **FRTHeader** (section [2.5.135](#frtheader)), **FrtHeaderOld** (section [2.5.136](#frtheaderold)), **FrtRefHeader** (section [2.5.137](#frtrefheader)), **FrtRefHeaderNoGrbit** (section [2.5.138](#frtrefheadernogrbit)). or **FrtRefHeaderU** (section [2.5.139](#frtrefheaderu)) structure, as specified in this document, are future records and can be treated as such by an application that implements the future record architecture. Future **records** that are not supported by an application can be cached on load and persisted on save, enabling the data to be retained in the file for an application that does support those **records**. When loading and caching these unsupported **records**, an application can process [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) references associated with the unsupported **records** as specified in the **FRTHeader**, **FrtHeaderOld**, **FrtRefHeader**, **FrtRefHeaderNoGrbit**, or **FrtRefHeaderU** structures. The application can adjust these range references as [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) are inserted, deleted or moved in the [**sheets (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) to preserve the correctness and validity of these range references associated with the unsupported **records** when saving the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) along with the unsupported **records**. + +For an in-depth discussion of how these structures relate to each other, read the specification for each structure in section [2.5](#Section_67410b0bfca64019ae2da53f9d392e03). + +#### Chart + +There are three types of **future records** (section [2.1.6](#Section_b660b67822684414839ed1ae9a4e4e85)) that can appear in the **Chart Sheet Substream** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)). + +The first type of **future record** is specific to a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) and is stored by using the **future record** architecture as specified in the Future Record section (section 2.1.6). Specifically, these **future records** that are specific to **charts** have a record type that MUST be greater than or equal to 2048 and MUST be less than or equal to 2303, as specified in section [2.3](#Section_7c84e174e96f45e0b23fa5e81f8b5def). These **future records** MUST exist in the collection of **records** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)) specified by the **StartBlock** records (section [2.4.266](#startblock)) and **EndBlock** records (section [2.4.100](#endblock)), unless they exist in the collection of **records** specified by the **StartObject** records (section [2.4.267](#startobject)) and **EndObject** records (section [2.4.101](#endobject)). The **StartBlock** records (section 2.4.266) and **EndBlock** records themselves MUST NOT appear in the collection of **records** specified by the **StartObject** records and **EndObject records**. Furthermore, a **ChartFrtInfo** record (section [2.4.49](#chartfrtinfo)) MUST precede the first **future record** that is specific to a **chart** in a **Chart Sheet Substream**. + +The second type of **future record** is stored by wrapping otherwise non-**future records** in the **FrtWrapper** record (section [2.4.130](#frtwrapper)), as specified in section 2.4.130. These **records** MUST be written in their entirety (the record type, record size and record data components, as specified in section 2.1.4) in the **wrappedRecord** field of the **FrtWrapper record**. These MUST exist in the collection of **records** specified by the **StartObject** records and **EndObject** records. + +The third type of **future record** is any other **future record** that is stored by using the **future record** architecture as specified in section 2.1.6, not belonging to the first two types. + +See the respective **record definitions** (section [2.4](#Section_6fba03830d7a4c7aafe9642ff70cbd36)) for details on how these **records** are written relative to other **future records** in the **Chart Sheet Substream**. + +#### PivotTable + +**PivotTables** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) implement the future record architecture as specified in section [2.1.6](#Section_b660b67822684414839ed1ae9a4e4e85). There are multiple classes of PivotTable records (section [2.2.5.1](#Section_ae3481143a7a4952baab4a7010a581c6)) represented using the **SXAddl record** (section [2.4.273.2](#sxaddl)). Each **record** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)) in a class specifies a different piece of information for the part of the **PivotTable** (section 2.2.5) to which the **SXAddl record** applies. For more information about how the **SXAddl record** is used, read section [2.2.5.1.1](#Section_db61fa8bdb7b4e1c99615c2f3ed1c369). + +### Storages and Streams + +This section specifies the [**storages**](#gt_63525252-3f66-4459-9b64-5b77f57b2f84), [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) and substreams of the Excel Binary File Format (.xls) file. Refer to section [2.1](#Section_2e6147d9e8ad48b09ff7bbfc51ca950d) for an understanding of storages, **streams**, and **substreams**. + +If the stream is in **[Binary Interchange File Format (BIFF)](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517)** format, the record sequence is specified using [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) grammar. + +#### Component Object Stream (\001CompObj) + +The Component Object Stream is specified in [\[MS-OLEDS\]](%5bMS-OLEDS%5d.pdf#Section_85583d21c1cf4afea35fd6701c5fbb6f) section [2.3.8](http://msdn.microsoft.com/en-us/library/142e0420-2f74-4ed9-829b-0b3d5a684d01/). + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "*\001*CompObj", where *\001* is the character with the value 0x01, not the string literal "\001". + +A file MUST contain at most one **Component O**bject **S**tream. + +#### Control Stream (Ctls) + +An instance of the **Control Stream** specifies the [**OLE objects**](#gt_cdff9514-a3fb-4897-941d-4e99193a0096) and [**ActiveX controls**](#gt_f3dcc35f-8f80-474e-ac39-106a23f059c2) that use stream-based persistence. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "Ctls". A file MUST contain at most one **Control S**tream. An object persisted in this stream MUST have a corresponding **Obj** record (section [2.4.181](#obj)) in a **worksheet substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) with a **cmo.ot** field that equals 8 and a **pictFlags.fPrstm** field that equals 1. The **pictFmla.lPosInCtlStm** and **pictFmla.cbBufInCtlStm** fields of the **Obj** record specify the location of the object data associated with that **Obj** record. + +#### Data Spaces Storage (\006DataSpaces) + +The Data Spaces Storage is specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.1. + +The name of this [**storage**](#gt_63525252-3f66-4459-9b64-5b77f57b2f84) MUST be "*\006*DataSpaces", where *\006* is the character with the value 0x06, not the string literal "\006". A file MUST contain at most one **Data Spaces Storage**. + +#### Document Summary Information Stream (\005DocumentSummaryInformation) + +The Document Summary Information Stream is specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.3.2.2. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "\005DocumentSummaryInformation", where \005 is the character with the value 0x05, not the string literal "\005". A file MUST contain at most one Document Summary **Information S**tream. + +#### Embedding Storage (MBD...) + +An instance of the **Embedding Storage** specifies an embedded [**OLE object**](#gt_cdff9514-a3fb-4897-941d-4e99193a0096) or an [**ActiveX control**](#gt_f3dcc35f-8f80-474e-ac39-106a23f059c2) that uses [**storage**](#gt_63525252-3f66-4459-9b64-5b77f57b2f84)-based persistence. + +The name of this storage MUST be "MBD" followed by eight hexadecimal digits uniquely identifying the [**embedded object**](#gt_708607be-8655-416e-93f3-b434e9ecbd56). An object persisted in an **Embedding Storage** MUST have a corresponding **Obj** (section [2.4.181](#obj)) in a **worksheet substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)), **macro sheet substream** (section [2.1.7.20.4](#Section_0dddd943f77a4fc2bf92868acb4587f7)), or **dialog sheet substream** (section [2.1.7.20.2](#Section_da37feb48b9a462d87772a5fddd4866e)) with a **cmo.ot** field that equals 8, a **pictFlags.fPrstm** field that equals 0, and a **pictFlags.fDde** field that equals 0. The **pictFmla.lPosInCtlStm** field of the **Obj** record specifies the name of the **Embedding Storage** that is associated with that **Obj** record. + +#### Encryption Stream (encryption) + +The Encryption Stream is specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.3.5.4**.** + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "encryption". A file MUST contain at most one **Encryption S**tream. + +#### Link Storage (LNK...) + +An instance of the **Link Storage** specifies a linked [**OLE object**](#gt_cdff9514-a3fb-4897-941d-4e99193a0096) and any default data or presentation caching established for it. + +The name of this storage MUST be "LNK" followed by eight hexadecimal digits uniquely identifying the [**linked object**](#gt_cfc45e76-9219-4c47-9ef2-5832a172f795). An object persisted in a **Link Storage** MUST have a corresponding **Obj** (section [2.4.181](#obj)) in a **worksheet substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)), **macro sheet substream** (section [2.1.7.20.4](#Section_0dddd943f77a4fc2bf92868acb4587f7)), or **dialog sheet substream** (section [2.1.7.20.2](#Section_da37feb48b9a462d87772a5fddd4866e)) with a **cmo.ot** field that equals 8, a **pictFlags.fPrstm** field that equals 0, and a **pictFlags.fDde** field that equals 1. Additionally, the **pictFmla.fmla** field of the **Obj** record (section 2.4.181) specifies a formula that refers to an **ExternName** (section [2.4.105](#externname)) with a **body** field of type **ExternOleDdeLink** (section [2.5.107](#externoleddelink)) with a **lStgName** field that specifies the name of the **Link Storage** that is associated with that **Obj** record. + +#### List Data Stream (List Data) + +The List **Data S**tream specifies one or more Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) definitions. Each data source definition is related to a Web-based data provider list. + +The name of the [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "List Data". A file MUST contain at most one List **Data S**tream. Each data source definition is related to a **Feature11** record (section [2.4.114](#feature11)) or **Feature12** record (section [2.4.115](#feature12)). The **lPosStmCache**, **cbStmCache** and **cchStmCache** fields of the **TableFeatureType** structure (section [2.5.266](#tablefeaturetype)) specify the relationship between the **Feature11** record or **Feature12** record and the **List Data S**tream. + +Each data source definition is specified as a compressed stream. The compression algorithm is specified in [\[RFC1951\]](https://go.microsoft.com/fwlink/?LinkId=90302). The stream is specified by the following [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067): + +1. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +##### Attributes + +The following table specifies the attributes that can be used in the LIST element: + +| Attribute | Description | +|----|----| +| Version | Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) server version from which the data was retrieved. MUST be less than or equal to 20 characters. | + +##### Elements + +The following table specifies the [**XML schema definition (XSD)**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae) elements that are specific to the LIST element: + +| Element | Description | +|----|----| +| **LISTNAME** (section [2.1.7.8.2.1](#Section_a2ce9676a4ff4916ad76f0288b8f28af)) | Display name or [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1), as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2), of a Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list. | +| **VIEWGUID** (section [2.1.7.8.2.2](#Section_0befe177e146420c83b2e950e89f7d70)) | GUID, as specified by \[MS-DTYP\], of a Web-based data provider [**list view**](#gt_1b49f76a-a3f7-4c2b-935e-2f764eafec71). | +| **LISTWEB** (section [2.1.7.8.2.3](#Section_273b3f763d40405ea77ec4c8fb67f006)) | [**Uniform Resource Identifier (URI)**](#gt_e18af8e8-01d7-4f91-8a1e-0fb21b191f95) of the Web-based data provider server from which the list was retrieved. | +| **ROOTFOLDER** (section [2.1.7.8.2.4](#Section_11af3867410f4d9f8ffc1b5d44b5434e)) | Path on the Web-based data provider server where the list is located. | +| **LISTSCHEMA** (section [2.1.7.8.2.5](#Section_922df830ac614fd7a8d97c8fb691fe45)) | [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) of the fields of the Web-based data provider list. | +| **VIEWSCHEMA** (section [2.1.7.8.2.6](#Section_2a2fb860f7ab4feab2f211e70d764f9e)) | XML schema of the Web-based data provider list view. | +| **LISTDATA** (section [2.1.7.8.2.7](#Section_03cb982d548044a1862edf25298d2df4)) | Specifies the data of the list. | +| **UPDATE** (section [2.1.7.8.2.8](#Section_8ee49ab1475b4c879e058aed4399920a)) | Specifies the inserted, deleted, and updated fields that were modified from the original [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) . | +| **LISTDATAFTR** (section [2.1.7.8.2.9](#Section_0c02ed6322d8426285ac6c626174896d)) | Validation footer used to validate the integrity of the data within the [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) . | + +###### LISTNAME + +The **LISTNAME** element specifies a list on the Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) server. It MUST be the display name or the [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1), as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2), of a [**list**](#gt_04ce231e-214c-44fd-b7ba-7cc19eee79bf). The **LISTNAME** element is specified as follows: + +68. \ + +###### VIEWGUID + +The **VIEWGUID** element specifies a list view on the server. It MUST be the [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1), as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2), of a list view. The **VIEWGUID** element is specified as follows: + +69. \ + +When the **VIEWGUID** element is not present or the value of the **VIEWGUID** element is empty, the current [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) definition within the **List Data Stream** (section [2.1.7.8](#Section_914f09bd8c944c099e8631dfe058f037)) MUST retrieve data from the default list view of the list on the server. + +###### LISTWEB + +The **LISTWEB** element specifies, as a [**URI**](#gt_e18af8e8-01d7-4f91-8a1e-0fb21b191f95), the name of the Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) server from which the list data was retrieved. MUST be a valid URI, as specified by [\[RFC3986\]](https://go.microsoft.com/fwlink/?LinkId=90453). The **LISTWEB** element is specified as follows: + +70. \ + +###### ROOTFOLDER + +The **ROOTFOLDER** element specifies the path from the **LISTWEB** [**URI**](#gt_e18af8e8-01d7-4f91-8a1e-0fb21b191f95) where the Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list from which the data was retrieved is located. When concatenated to the end of the **LISTWEB** field value, the result MUST be a valid URI, as specified by [\[RFC3986\]](https://go.microsoft.com/fwlink/?LinkId=90453). The **ROOTFOLDER** element is specified as follows: + +71. \ + +###### LISTSCHEMA + +The **LISTSCHEMA** element specifies the fields of the Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list from which the data was retrieved, along with additional information. The additional information includes [**regional settings**](#gt_ede60f7f-1131-4845-800b-b6848215e015) and whether attachments are enabled. The **LISTSCHEMA** element is specified as follows: + +72. \ + + \ + + \ + + \ + + \ + + \ + + \ + +The **LISTSCHEMA** element is further specified in [\[MS-LISTSWS\]](%5bMS-LISTSWS%5d.pdf#Section_30b364cc38374e839ce81963292e2ee5) section 2.2.4.12. + +###### VIEWSCHEMA + +The **VIEWSCHEMA** element specifies the list view of the Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list from which the data was retrieved. The **VIEWSCHEMA** element is specified as follows: + +79. \ + + \ + + \ + + \ + + \ + + \ + + \ + +The **VIEWSCHEMA** element is further specified in [\[MS-VIEWSS\]](%5bMS-VIEWSS%5d.pdf#Section_84e77d68e69244ba9e4e1d08abcb2d99) section 2.2. + +###### LISTDATA + +The **LISTDATA** element specifies the data retrieved from the Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list. The **LISTDATA** element is specified as follows: + +86. \ + + \ + + \ + + \ + + \ + + \ + + \ + +The referenced **rs:data** type is specified in [\[MS-PRSTFR\]](%5bMS-PRSTFR%5d.pdf#Section_7e50a09b3cf44bd9ae0c3eccddabe363) section 2.2. Additional information and examples is also specified in [\[MS-LISTSWS\]](%5bMS-LISTSWS%5d.pdf#Section_30b364cc38374e839ce81963292e2ee5) section 3.1.4.21.2.2. + +###### UPDATE + +The **UPDATE** element specifies the inserted, deleted, and updated fields that were modified from the data specified in **LISTDATA** (section [2.1.7.8.2.7](#Section_03cb982d548044a1862edf25298d2df4)). The definition of the **UPDATE** element is as follows: + +93. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +The **UPDATE** element is a parent element, which contains 3 optional child elements: **Inserts**, **Updates** and **Deletes**. **Inserts** specifies rows that were added locally, and are not synchronized with the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). **Updates** specifies rows that were modified locally, and that are not synchronized with the data source. **Deletes** specifies rows that were deleted locally, and that are not synchronized with the data source. The referenced **rs:data** type for each of the elements is specified in [\[MS-PRSTFR\]](%5bMS-PRSTFR%5d.pdf#Section_7e50a09b3cf44bd9ae0c3eccddabe363) section 2.2. Additional information and examples is also specified in [\[MS-LISTSWS\]](%5bMS-LISTSWS%5d.pdf#Section_30b364cc38374e839ce81963292e2ee5) section 3.1.4.21.2.2. + +###### LISTDATAFTR + +The **LISTDATAFTR** element specifies elements used to validate the integrity of the data within the [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6). It contains a sequence of signed integers which specify the [**MD5**](#gt_1535fdac-8d46-4605-96af-252907c4a593) [**hash**](#gt_b7e2b611-0af5-4fec-8af2-3f9ce7bad205) of each **rs:data** within the stream. The definition of the **LISTDATAFTR** element is a follows: + +120. \ + +The signed integers specified in the string data MUST be separated by the ";#" separator. There MUST be an MD5 hash, as specified by [\[RFC1321\]](https://go.microsoft.com/fwlink/?LinkId=90275), for the **LISTDATA** element, the **UPDATE.Inserts** element, the **UPDATE.Updates** element and the **UPDATE.Deletes** element. The MD5 hash MUST appear in the following order: **LISTDATA** element, the **UPDATE.Inserts** element, the **UPDATE.Updates** element and the **UPDATE.Deletes** element. If an element is not present in the stream, the corresponding MD5 hash MUST NOT be present. + +#### Office Data Store Storage (MsoDataStore) + +The **Office Data Store Storage** is specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.6. + +The name of this storage MUST be "MsoDataStore". A file MUST contain at most one **Office Data Store S**torage. + +#### Office Toolbars Stream (XCB) + +The **Office Toolbars Stream** specifies the custom toolbars attached to the file. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "XCB". A file MUST contain at most one **Office Toolbars S**tream. This stream MUST only contain a single **CTBWRAPPER** structure (section [2.6.1](#ctbwrapper)). + +Parts of this stream are specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.1. Refer to \[MS-OSHARED\] section 1.3 for a diagram that illustrates an example of the XCB binary stream with its toolbar customization structures. + +Following is the record sequence [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) for the XCB binary stream: + +121. XCB = CTBWRAPPER + + CTBWRAPPER = CTBS 1\*CTB + +For more information about the **CTBWRAPPER** structure, see section 2.6.1. For more information about the **CTBS** structure, see section [2.6.2](#ctbs). For more information about the **CTB** structure, see section [2.6.3](#ctb). + +#### OLE Stream (\001Ole) + +The OLE Stream is specified in [\[MS-OLEDS\]](%5bMS-OLEDS%5d.pdf#Section_85583d21c1cf4afea35fd6701c5fbb6f) section [2.3.3](http://msdn.microsoft.com/en-us/library/e0dc105e-77f1-4072-a938-9aa516dc43e9/). + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "*\001*Ole", where *\001* is the character with the value 0x01, not the string literal "\001". + +A file MUST contain at most one **OLE Stream**. + +#### Pivot Cache Storage (\_SX_DB_CUR) + +The **Pivot Cache Storage** specifies zero or more streams, each of which specify a **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) for a **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). The name of each [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be unique within the storage, and the name MUST be a four digit hexadecimal number stored as text. + +The name of this storage MUST be "\_SX_DB_CUR". A file MUST contain at most one **Pivot Cache Storage**. + +The number of **FDB** rules that occur MUST be equal to the value of **cfdbTot** in the **SXDB record** (section [2.4.275](#sxdb)). + +Record sequence [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) for each stream: + +PIVOTCACHE = SXDB [SXDBEx](#sxdbex) \*SXFORMULA \*FDB \*DBB [EOF](#eof) + +FDB = [SXFDB](#sxfdb) [SXFDBType](#sxfdbtype) \[SXFMLA / (\*GRPSXOPER \[SXRANGE / \*([SxIsxoper](#sxisxoper) \*[Continue](#continue))\])\] \*SRCSXOPER + +DBB = \[[SXDBB](#sxdbb)\] \*SXOPER + +SXFORMULA = SXFMLA PIVOTRULE [SXFormula](#sxformula) + +SXFMLA = [SxFmla](#sxfmla) \*([SxName](#sxname) \*[SXPair](#sxpair)) + +GRPSXOPER = SXOPER + +SRCSXOPER = SXOPER + +SXOPER = [SxNil](#sxnil) / [SXNum](#sxnum) / [SxBool](#sxbool) / [SxErr](#sxerr) / [SXString](#sxstring) / [SXDtr](#sxdtr) + +SXRANGE = [SXRng](#sxrng) (3SXNum / (2SXDtr [SXInt](#sxint))) + +#### Protected Content Stream (\009DRMContent) + +The **Protected Content Stream** is specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.2.10. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "*\009*DRMContent", where *\009* is the character with the value 0x09, not the string literal "\009". A file MUST contain at most one **Protected Content S**tream. + +#### Revision Stream (Revision Log) + +An instance of the **Revision Stream** specifies the **revision logs** (section [2.2.11.2](#Section_2cbd26e86f7e4195ada414c8b7e595b8)) and **revision records** (section [2.2.11.3](#Section_9e91e8bce4f249b897d4741481349d1b)) for a **shared workbook** (section [2.2.11](#Section_e45a62c4490f4304a09668908b57dacc)). + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "Revision Log". A file MUST contain at most one **Revision Stream**. The **Revision Stream** MUST exist if the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is a **shared workbook** (section 2.2.11). + +Record sequence [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf): + +REVISION = [RRDInfo](#rrdinfo) [FileLock](#filelock) [UsrExcl](#usrexcl) \*(HEADER \*(RENSHEET / INSDEL / CONFLICT / INSDELSH / CHGCELL / MOVE / FORMAT / AUTOFMT / DEFNAME / VIEW / NOTE / TRASHQTFIELD)) [EOF](#eof) + +HEADER = [RRDHead](#rrdhead) [RRTabId](#rrtabid) + +RENSHEET = [RRDRenSheet](#rrdrensheet) + +INSDEL = INS / DEL + +INS = [RRDInsDel](#rrdinsdel) \*(CHGCELL / FORMAT) + +DEL = [RRDInsDelBegin](#rrdinsdelbegin) RRDInsDel \*(CHGCELL / FORMAT) [RRDInsDelEnd](#rrdinsdelend) + +CONFLICT = [RRDConflict](#rrdconflict) + +INSDELSH = [RRInsertSh](#rrinsertsh) + +CHGCELL = [RRDChgCell](#rrdchgcell) \*[Continue](#continue) \*[RRDRstEtxp](#rrdrstetxp) + +MOVE = [RRDMoveBegin](#rrdmovebegin) [RRDMove](#rrdmove) \*(CHGCELL / FORMAT) [RRDMoveEnd](#rrdmoveend) + +FORMAT = [RRFormat](#rrformat) + +AUTOFMT = [RRAutoFmt](#rrautofmt) + +DEFNAME = [RRDDefName](#rrddefname) + +VIEW = [RRDUserView](#rrduserview) + +NOTE = [Note](#note) + +TRASHQTFIELD = [RRDTQSIF](#rrdtqsif) + +#### Signatures Stream (\_signatures) + +The **Signatures Stream** is specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.5.1. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "\_signatures". A file MUST contain at most one **Signatures S**tream[\<1\>](#Appendix_A_1). + +When generating the **Signature** value, as specified in \[MS-OFFCRYPTO\] section 2.5.1.5, the record data, as specified in section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388), of the **WriteAccess record** (section [2.4.349](#writeaccess)) in the **Globals Substream** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) is skipped. + +#### Summary Information Stream (\005SummaryInformation) + +The **Summary Information Stream** is specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.3.2.1. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "*\005*SummaryInformation", where *\005* is the character with the value 0x05, not the string literal "\005". A file MUST contain at most one Summary **Information S**tream. + +#### User Names Stream (User Names) + +The **User Names Stream** specifies a **user log** (section [2.2.11.1](#Section_df0e3725a65f459daa1c011679c5b904)) for a **shared workbook** (section [2.2.11](#Section_e45a62c4490f4304a09668908b57dacc)). + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "User Names". The presence of the **User Names Stream** indicates the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is a **shared workbook** (section 2.2.11). A file MUST contain at most one **User Names Stream**. + +Record sequence [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf): + +USERNAMES = [CUsr](#cusr) [UsrChk](#usrchk) [CbUsr](#cbusr) [BCUsrs](#bcusrs) \*[UsrInfo](#usrinfo) + +#### VBA Storage (\_VBA_PROJECT_CUR) + +The **VBA Storage** is specified in [\[MS-OVBA\]](%5bMS-OVBA%5d.pdf#Section_575462babf6741909facc275523c75fc). + +The name of this storage MUST be "\_VBA_PROJECT_CUR". A file MUST contain at most one **VBA S**torage. + +#### Viewer Content Stream (\009DRMViewerContent) + +The **Viewer Content Stream** is specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.2.11. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "*\009*DRMViewerContent", where *\009* is the character with the value 0x09, not the string literal "\009". A file MUST contain at most one **Viewer Content S**tream. + +#### Workbook Stream (Workbook) + +The **Workbook Stream** specifies global properties and data for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), as well as the [**sheets (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that constitute a workbook. + +The name of this [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) MUST be "Workbook". A file MUST contain exactly one **Workbook Stream**, which consists of several substreams. There MUST be exactly one **substream** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)), and the **substream** MUST be the first substream to appear in the **Workbook Stream**, which MUST be followed by one or more of the following substreams: + +- **Chart Sheet Substream** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) + +- **Dialog Sheet Substream** (section [2.1.7.20.2](#Section_da37feb48b9a462d87772a5fddd4866e)) + +- **Macro Sheet Substream** (section [2.1.7.20.4](#Section_0dddd943f77a4fc2bf92868acb4587f7)) + +- **Worksheet Substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) + +##### Chart Sheet Substream + +The **Chart Sheet Substream** specifies either a separate [**chart sheet**](#gt_da561b7b-c629-4cd8-bfaa-6e62471d9e83) that contains a single chart, or an **embedded** chart **object** (section [2.2.3.1](#Section_2c90d75bc92645aa8ff29d4483f51831)) contained within a **worksheet** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) or **macro sheet** (section [2.1.7.20.4](#Section_0dddd943f77a4fc2bf92868acb4587f7)). + +If a record in the [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) grammar for this substream is one of the following: **Font** (section [2.4.122](#font)), **Continue** (section [2.4.58](#continue)), **LineFormat** (section [2.4.156](#lineformat)), **AreaFormat** (section [2.4.3](#areaformat)), **SeriesText** (section [2.4.254](#seriestext)), **DefaultText** (section [2.4.88](#defaulttext)), **Text** (section [2.4.324](#text)), **FontX** (section [2.4.123](#fontx)), **ObjectLink** (section [2.4.182](#objectlink)), **Frame** (section [2.4.128](#frame)), **Begin** (section [2.4.17](#begin)), **End** (section [2.4.99](#end)), **PicF** (section [2.4.193](#picf)), **Pos** (section [2.4.201](#pos)), **AlRuns** (section [2.4.1](#alruns)), **BRAI** (section [2.4.29](#brai)), **Fbi** (section [2.4.109](#fbi)), or **GelFrame** (section [2.4.131](#gelframe)), and is in a collection specified by **StartObject** (section [2.4.267](#startobject)) and **EndObject** (section [2.4.101](#endobject)), that record MUST be replaced by an **FrtWrapper** record (section [2.4.130](#frtwrapper)) and the **wrappedRecord** field of that **FrtWrapper** record MUST specify the record that is replaced. **StartBlock** record (section [2.4.266](#startblock)) and **EndBlock** record (section [2.4.100](#endblock)) pairs and **ChartFrtInfo** (section [2.4.49](#chartfrtinfo)) are omitted from the ABNF grammar. See section [2.1.6.1](#Section_0d96d51a09bd44ddbb691541de053776) and the respective record specifications for more information. + +Record sequence[\<2\>](#Appendix_A_2) ABNF: + +CHARTSHEETCONTENT = \[[WriteProtect](#writeprotect)\] \[[SheetExt](#sheetext)\] \[[WebPub](#webpub)\] \*[HFPicture](#hfpicture) PAGESETUP [PrintSize](#printsize) \[[HeaderFooter](#headerfooter)\] \[BACKGROUND\] \*Fbi \*[Fbi2](#fbi2) \[[ClrtClient](#clrtclient)\] \[PROTECTION\] \[[Palette](#palette)\] \[[SXViewLink](#sxviewlink)\] \[[PivotChartBits](#pivotchartbits)\] \[[SBaseRef](#sbaseref)\] \[[MsoDrawingGroup](#msodrawinggroup)\] OBJECTS [Units](#units) CHARTFOMATS SERIESDATA \*WINDOW \*CUSTOMVIEW \[[CodeName](#codename)\] \[CRTMLFRT\] [EOF](#eof) + +CHARTSHEET = [BOF](#bof) CHARTSHEETCONTENT + +CHARTFOMATS = [Chart](#chart-2) Begin \*2FONTLIST [Scl](#scl) [PlotGrowth](#plotgrowth) \[FRAME\] \*SERIESFORMAT \*SS [ShtProps](#shtprops) \*2DFTTEXT [AxesUsed](#axesused) 1\*2AXISPARENT \[[CrtLayout12A](#crtlayout12a)\] \[DAT\] \*ATTACHEDLABEL \[CRTMLFRT\] \*(\[[DataLabExt](#datalabext) StartObject\] ATTACHEDLABEL \[EndObject\]) \[TEXTPROPS\] \*2CRTMLFRT End + +FONTLIST = [FrtFontList](#frtfontlist) StartObject \*(Font \[Fbi\]) EndObject + +AXISPARENT = [AxisParent](#axisparent) Begin Pos \[AXES\] 1\*4CRT End + +SERIESDATA = [Dimensions](#dimensions) 3([SIIndex](#siindex) \*([Number](#number) / [BoolErr](#boolerr) / [Blank](#blank) / [Label](#label))) + +AXES = \[IVAXIS DVAXIS \[SERIESAXIS\] / DVAXIS DVAXIS\] \*3ATTACHEDLABEL \[[PlotArea](#plotarea) FRAME\] + +IVAXIS = [Axis](#axis-1) Begin \[[CatSerRange](#catserrange)\] [AxcExt](#axcext) \[[CatLab](#catlab)\] AXS \[CRTMLFRT\] End + +DVAXIS = Axis Begin \[[ValueRange](#valuerange)\] \[AXM\] AXS \[CRTMLFRT\] End + +SERIESAXIS = Axis Begin \[CatSerRange\] AXS \[CRTMLFRT\] End + +CRT = [ChartFormat](#chartformat) Begin ([Bar](#bar) / [Line](#line) / ([BopPop](#boppop) \[[BopPopCustom](#boppopcustom)\]) / [Pie](#pie) / [Area](#area) / [Scatter](#scatter) / [Radar](#radar) / [RadarArea](#radararea) / [Surf](#surf)) [CrtLink](#crtlink) \[[SeriesList](#serieslist)\] \[[Chart3d](#chart3d)\] \[LD\] \[2DROPBAR\] \*4([CrtLine](#crtline) LineFormat) \*2DFTTEXT \[[DataLabExtContents](#datalabextcontents)\] \[SS\] \*4SHAPEPROPS End + +LD = [Legend](#legend-1) Begin Pos ATTACHEDLABEL \[FRAME\] \[[CrtLayout12](#crtlayout12)\] \[TEXTPROPS\] \[CRTMLFRT\] End + +SERIESFORMAT = [Series](#series-1) Begin 4AI \*SS ([SerToCrt](#sertocrt) / ([SerParent](#serparent) ([SerAuxTrend](#serauxtrend) / [SerAuxErrBar](#serauxerrbar)))) \*([LegendException](#legendexception) \[Begin ATTACHEDLABEL \[TEXTPROPS\] End\]) End + +FRAME = Frame Begin LineFormat AreaFormat \[GELFRAME\] \[SHAPEPROPS\] End + +AI = BRAI \[SeriesText\] + +ATTACHEDLABEL = Text Begin Pos \[FontX\] \[AlRuns\] AI \[FRAME\] \[ObjectLink\] \[DataLabExtContents\] \[CrtLayout12\] \[TEXTPROPS\] \[CRTMLFRT\] End + +SS = [DataFormat](#dataformat) Begin \[[Chart3DBarShape](#chart3dbarshape)\] \[LineFormat AreaFormat [PieFormat](#pieformat)\] \[[SerFmt](#serfmt)\] \[GELFRAME\] \[[MarkerFormat](#markerformat)\] \[[AttachedLabel](#attachedlabel)\] \*2SHAPEPROPS \[CRTMLFRT\] End + +SHAPEPROPS = [ShapePropsStream](#shapepropsstream) \*[ContinueFrt12](#continuefrt12) + +TEXTPROPS = ([RichTextStream](#richtextstream) / [TextPropsStream](#textpropsstream)) \*ContinueFrt12 + +AXS = \[[IFmtRecord](#ifmtrecord)\] \[[Tick](#tick)\] \[FontX\] \*4([AxisLine](#axisline) LineFormat) \[AreaFormat\] \[GELFRAME\] \*4SHAPEPROPS \[TextPropsStream \*ContinueFrt12\] + +DFTTEXT = \[DataLabExt StartObject\] DefaultText ATTACHEDLABEL \[EndObject\] + +DROPBAR = [DropBar](#dropbar) Begin LineFormat AreaFormat \[GELFRAME\] \[SHAPEPROPS\] End + +AXM = [YMult](#ymult) StartObject ATTACHEDLABEL EndObject + +DAT = [Dat](#dat) Begin LD End + +GELFRAME = 1\*2GelFrame \*Continue \[PICF\] + +PICF = Begin PicF End + +CRTMLFRT = [CrtMlFrt](#crtmlfrt) \*[CrtMlFrtContinue](#crtmlfrtcontinue) + +For ABNF rules not listed here, see section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082). Within the sequence of records specified by the **CUSTOMVIEW** rule (section 2.1.7.20.6) specified in section 2.1.7.20.6, the **Selection** (section [2.4.248](#selection)), **HorizontalPageBreaks** (section [2.4.142](#horizontalpagebreaks)), and **VerticalPageBreaks** (section [2.4.343](#verticalpagebreaks)) records MUST NOT be present. + +##### Dialog Sheet Substream + +The **Dialog Sheet Substream** specifies a [**dialog sheet**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8). + +Record sequence[\<3\>](#Appendix_A_3)[\<4\>](#Appendix_A_4) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf): + +DIALOGSHEETCONTENT = \[[Uncalced](#uncalced)\] [Index](#index) GLOBALS PAGESETUP \[[HeaderFooter](#headerfooter)\] \*BIGNAME \[DIALOGPROTECTION\] [DefColWidth](#defcolwidth) [Dimensions](#dimensions) OBJECTS \*[HFPicture](#hfpicture) \*[Note](#note) 1\*DIALOGWINDOW \*DIALOGCUSTOMVIEW \[[CodeName](#codename)\] \[[SheetExt](#sheetext)\] \*RECORD12 [EOF](#eof) + +DIALOGSHEET = [BOF](#bof) DIALOGSHEETCONTENT + +DIALOGPROTECTION = \[[Protect](#protect)\] \[[Password](#password)\] + +DIALOGWINDOW = [Window2](#window2) \[[Pane](#pane)\] \*[Selection](#selection) + +DIALOGCUSTOMVIEW = [UserSViewBegin](#usersviewbegin) \*Selection \[[HorizontalPageBreaks](#horizontalpagebreaks)\] \[[VerticalPageBreaks](#verticalpagebreaks)\] \[[Header](#header)\] \[[Footer](#footer)\] \[[HCenter](#hcenter)\] \[[VCenter](#vcenter)\] \[[LeftMargin](#leftmargin)\] \[[RightMargin](#rightmargin)\] \[[TopMargin](#topmargin)\] \[[BottomMargin](#bottommargin)\] \[[Pls](#pls)\] \[[Setup](#setup)\] \[[PrintSize](#printsize)\] \[HeaderFooter\] [UserSViewEnd](#usersviewend) + +OBJECTS = \*(MSODRAWING \*(TEXTOBJECT / OBJ)) \[[MsoDrawingSelection](#msodrawingselection)\] + +MSODRAWING = [MsoDrawing](#msodrawing) \*[Continue](#continue) + +OBJ = [Obj](#obj) \*Continue + +TEXTOBJECT = [TxO](#txo) \*Continue + +For ABNF rules not listed here, see section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082). + +##### Globals Substream + +The **Globals Substream** specifies global properties and data in a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +There MUST be exactly one **Globals Substream** in a **Workbook Stream** (section [2.1.7.20](#Section_f682f4b08c6b444e83f852d156f1e8ba)), and the **Globals Substream** MUST be the first substream in the **Workbook Stream**. + +Record sequence[\<5\>](#Appendix_A_5)[\<6\>](#Appendix_A_6) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf): + +WORKBOOKCONTENT = \[[WriteProtect](#writeprotect)\] \[[FilePass](#filepass)\] \[[Template](#template)\] INTERFACE [WriteAccess](#writeaccess) \[[FileSharing](#filesharing)\] [CodePage](#codepage) \*2047[Lel](#lel) [DSF](#dsf) \[[Excel9File](#excel9file)\] [RRTabId](#rrtabid) \[[ObProj](#obproj)\] \[[ObNoMacros](#obnomacros)\] \[[CodeName](#codename)\] \[FNGROUPS\] \*[Lbl](#lbl) \[[OleObjectSize](#oleobjectsize)\] PROTECTION 1\*[Window1](#window1) [Backup](#backup) [HideObj](#hideobj) [Date1904](#date1904) [CalcPrecision](#calcprecision) [RefreshAll](#refreshall) [BookBool](#bookbool) FORMATTING \*(PIVOTCACHEDEFINITION) \[DOCROUTE\] \*[UserBView](#userbview) [UsesELFs](#useselfs) 1\*BUNDLESHEET METADATA \[[MTRSettings](#mtrsettings)\] \[[ForceFullCalculation](#forcefullcalculation)\] [Country](#country) \*SUPBOOK \*LBL \*RTD \[[RecalcId](#recalcid)\] \*[HFPicture](#hfpicture) \*MSODRAWINGGROUP \[SHAREDSTRINGS\] [ExtSST](#extsst) \*[WebPub](#webpub) \[[WOpt](#wopt)\] \[[CrErr](#crerr)\] \[[BookExt](#bookext)\] \*[FeatHdr](#feathdr) \*[DConn](#dconn) \[THEME\] \[[CompressPictures](#compresspictures)\] \[[Compat12](#compat12)\] \[[GUIDTypeLib](#guidtypelib)\] [EOF](#eof) + +WORKBOOK = [BOF](#bof) WORKBOOKCONTENT + +INTERFACE = [InterfaceHdr](#interfacehdr) [Mms](#mms) [InterfaceEnd](#interfaceend) + +FNGROUPS = [BuiltInFnGroupCount](#builtinfngroupcount) \*[FnGroupName](#fngroupname) \*[FnGrp12](#fngrp12) + +PROTECTION = [WinProtect](#winprotect) [Protect](#protect) [Password](#password) [Prot4Rev](#prot4rev) [Prot4RevPass](#prot4revpass) + +FORMATTING = 1\*510[Font](#font) 8\*218[Format](#format) XFS \*[DXF](#dxf) STYLES \[TABLESTYLES\] \[[Palette](#palette)\] \[[ClrtClient](#clrtclient)\] + +XFS = 16\*[XF](#xf) \[[XFCRC](#xfcrc) 16\*4050[XFExt](#xfext)\] + +STYLES = 1\*([Style](#style) \[[StyleExt](#styleext)\]) + +TABLESTYLES = [TableStyles](#tablestyles) \*([TableStyle](#tablestyle) \*28[TableStyleElement](#tablestyleelement)) + +PIVOTCACHEDEFINITION = [SXStreamID](#sxstreamid) [SXVS](#sxvs) \[SXSRC\] \[SXADDLCACHE\] + +SXSRC = DREF / SXTBL / DBQUERY + +DREF = [DConName](#dconname) / [DConBin](#dconbin) / [DConRef](#dconref) + +SXTBL = [SXTbl](#sxtbl) \*DREF \*[SxTbpg](#sxtbpg) \*([SXTBRGIITM](#sxtbrgiitm) \*[SXString](#sxstring)) + +DBQUERY = [DbOrParamQry](#dborparamqry) \[1\*SXString \[DbOrParamQry \*(SXString DbOrParamQry)\]\] \*SXString + +DOCROUTE = [DocRoute](#docroute) 1\*65535[RecipName](#recipname) + +BUNDLESHEET = [BoundSheet8](#boundsheet8) + +METADATA = \*MDTINFO \*MDXSTR \*(MDXTUPLESET / [MDXProp](#mdxprop) / [MDXKPI](#mdxkpi)) \*MDBLOCK + +MDTINFO = [MDTInfo](#mdtinfo) \*[ContinueFrt12](#continuefrt12) + +MDXSTR = [MDXStr](#mdxstr) \*ContinueFrt12 + +MDXTUPLESET = ([MDXTuple](#mdxtuple) / [MDXSet](#mdxset)) \*ContinueFrt12 + +MDBLOCK = [MDB](#mdb) \*ContinueFrt12 + +SUPBOOK = [SupBook](#supbook) \[\*[ExternName](#externname) \*([XCT](#xct) \*[CRN](#crn))\] \[[ExternSheet](#externsheet)\] \*[Continue](#continue) + +LBL = Lbl \[[NameCmt](#namecmt)\] \[[NameFnGrp12](#namefngrp12)\] \[[NamePublish](#namepublish)\] + +RTD = [RealTimeData](#realtimedata) \*[ContinueFrt](#continuefrt) + +MSODRAWINGGROUP = [MsoDrawingGroup](#msodrawinggroup) \*Continue + +SHAREDSTRINGS = [SST](#sst) \*Continue + +THEME = [Theme](#theme) \*ContinueFrt12 + +SXADDLCACHE = [SXAddl_SXCCache_SXDId](#sxaddl_sxccache_sxdid) [SXAddl_SXCCache_SXDVer10Info](#sxaddl_sxccache_sxdver10info) \[[SXAddl_SXCCache_SXDVerSXMacro](#sxaddl_sxccache_sxdversxmacro)\] \[SXADDLCACHE12\] \[SXADDLDBQUERY\] \*UNKNOWNFRT [SXAddl_SXCCache_SXDEnd](#sxaddl_sxccache_sxdend) + +SXADDLCACHE12 = [SXAddl_SXCCache_SXDVerUpdInv](#sxaddl_sxccache_sxdverupdinv) [SXAddl_SXCCache_SXDInfo12](#sxaddl_sxccache_sxdinfo12) [SXAddl_SXCCache_SXDInvRefreshReal](#sxaddl_sxccache_sxdinvrefreshreal) \*SXADDLCACHEFIELD \[SXADDLSXDH\] \[SXADDLSXMGS\] SXAddl_SXCCache_SXDVerUpdInv + +SXADDLSXDH = [SXAddl_SXCSXDH_SXDId](#sxaddl_sxcsxdh_sxdid) \*[SXAddl_SXCSXDH_SXDSxdh](#sxaddl_sxcsxdh_sxdsxdh) [SXAddl_SXCSXDH_SXDEnd](#sxaddl_sxcsxdh_sxdend) + +SXADDLSXMGS = [SXAddl_SXCSXMgs_SXDId](#sxaddl_sxcsxmgs_sxdid) \*SXADDLSXMG \*[SXAddl_SXCSXMgs_SXDMGrpSXDHMap](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap) \*UNKNOWNFRT [SXAddl_SXCSXMgs_SXDEnd](#sxaddl_sxcsxmgs_sxdend) + +SXADDLSXMG = [SXAddl_SXCSXMg_SXDId](#sxaddl_sxcsxmg_sxdid) \*[Continue_SxaddlSxString](#continue_sxaddlsxstring) \[[SXAddl_SXCSXMg_SXDUserCaption](#sxaddl_sxcsxmg_sxdusercaption) \*Continue_SxaddlSxString\] \*UNKNOWNFRT [SXAddl_SXCSXMg_SXDEnd](#sxaddl_sxcsxmg_sxdend) + +SXADDLCACHEFIELD = [SXAddl_SXCCacheField_SXDId](#sxaddl_sxccachefield_sxdid) \*Continue_SxaddlSxString \[[SXAddl_SXCCacheField_SXDCaption](#sxaddl_sxccachefield_sxdcaption) \*Continue_SxaddlSxString\] \[[SXAddl_SXCCacheField_SXDProperty](#sxaddl_sxccachefield_sxdproperty) \[[SXAddl_SXCCacheField_SXDPropName](#sxaddl_sxccachefield_sxdpropname) \*Continue_SxaddlSxString\]\] \[[SXAddl_SXCCacheField_SXDIfdbMpMapCount](#sxaddl_sxccachefield_sxdifdbmpmapcount) [SXAddl_SXCCacheField_SXDIfdbMempropMap](#sxaddl_sxccachefield_sxdifdbmempropmap)\] \[[SXAddl_SXCCacheField_SXDSxrmitmCount](#sxaddl_sxccachefield_sxdsxrmitmcount) \*SXADDLCACHEITEM [SXAddl_SXCCacheItem_SXDEnd](#sxaddl_sxccacheitem_sxdend)\] [SXAddl_SXCCacheField_SXDEnd](#sxaddl_sxccachefield_sxdend) + +SXADDLCACHEITEM = [SXAddl_SXCCacheItem_SXDId](#sxaddl_sxccacheitem_sxdid) \[[SXAddl_SXCCacheItem_SXDSxrmitmDisp](#sxaddl_sxccacheitem_sxdsxrmitmdisp) \*Continue_SxaddlSxString\] \*([SXAddl_SXCCacheItem_SXDItmMpMapCount](#sxaddl_sxccacheitem_sxditmmpmapcount) [SXAddl_SXCCacheItem_SXDItmMpropMap](#sxaddl_sxccacheitem_sxditmmpropmap)) + +##### Macro Sheet Substream + +The **Macro Sheet Substream** specifies a [**macro sheet**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491). This substream specifies an [**international macro sheet**](#gt_17a6eea5-8094-4056-84fd-8d97fbf0c865) if the **Intl** record (section [2.4.147](#intl)) is present. + +Record sequence[\<7\>](#Appendix_A_7) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf): + +MACROSHEETCONTENT = \[[Uncalced](#uncalced)\] [Index](#index) \[Intl\] GLOBALS PAGESETUP \[[HeaderFooter](#headerfooter)\] \[BACKGROUND\] \*BIGNAME \[PROTECTION\] COLUMNS MACROSORTANDFILTER [Dimensions](#dimensions) \[CELLTABLE\] OBJECTS \*[HFPicture](#hfpicture) \*[Note](#note) \[DCON\] 1\*WINDOW \*CUSTOMVIEW \*2SORT \[[DxGCol](#dxgcol)\] \[PHONETICINFO\] \[[CodeName](#codename)\] \*[CellWatch](#cellwatch) \[[SheetExt](#sheetext)\] \*FEAT \*RECORD12 [EOF](#eof) + +MACROSHEET = [BOF](#bof) MACROSHEETCONTENT + +MACROSORTANDFILTER = \[[Sort](#sort)\] \[SORTDATA12\] \[[DropDownObjIds](#dropdownobjids)\] \[AUTOFILTER\] + +For ABNF rules not listed here, see section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082). **Table** (section [2.4.319](#table)) MUST NOT appear under this substream. + +##### Worksheet Substream + +The **Worksheet Substream** specifies a [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +Record sequence[\<8\>](#Appendix_A_8) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf): + +WORKSHEETCONTENT = \[[Uncalced](#uncalced)\] [Index](#index) GLOBALS PAGESETUP \[[HeaderFooter](#headerfooter)\] \[BACKGROUND\] \*BIGNAME \[PROTECTION\] COLUMNS \[SCENARIOS\] SORTANDFILTER [Dimensions](#dimensions) \[CELLTABLE\] OBJECTS \*[HFPicture](#hfpicture) \*[Note](#note) \*PIVOTVIEW \[DCON\] 1\*WINDOW \*CUSTOMVIEW \*2SORT \[[DxGCol](#dxgcol)\] \*[MergeCells](#mergecells) \[[LRng](#lrng)\] \*QUERYTABLE \[PHONETICINFO\] CONDFMTS \*HLINK \[DVAL\] \[[CodeName](#codename)\] \*[WebPub](#webpub) \*[CellWatch](#cellwatch) \[[SheetExt](#sheetext)\] \*FEAT \*FEAT11 \*RECORD12 [EOF](#eof) + +WORKSHEET = [BOF](#bof) WORKSHEETCONTENT + +SCENARIOS = [ScenMan](#scenman) \*([SCENARIO](#scenario) \*[Continue](#continue)) + +SORTANDFILTER = \[[Sort](#sort)\] \[SORTDATA12\] \[[FilterMode](#filtermode)\] \[[DropDownObjIds](#dropdownobjids)\] \[AUTOFILTER\] + +PIVOTVIEW = PIVOTCORE \[PIVOTFRT\] + +PIVOTCORE = [SxView](#sxview) \*PIVOTVD \*2PIVOTIVD \[PIVOTPI\] \*[SXDI](#sxdi) \*PIVOTLI PIVOTEX + +PIVOTFRT = PIVOTFRT9 \[PIVOTADDL\] + +PIVOTFRT9 = [QsiSXTag](#qsisxtag) \[DBQUERYEXT\] \[PIVOTVIEWEX\] [SXViewEx9](#sxviewex9) + +PIVOTVD = [Sxvd](#sxvd) \*[SXVI](#sxvi) [SXVDEx](#sxvdex) + +PIVOTIVD = [SxIvd](#sxivd) \*Continue + +PIVOTPI = [SXPI](#sxpi) \*Continue + +PIVOTLI = [SXLI](#sxli) \*Continue + +PIVOTEX = [SXEx](#sxex) \*PIVOTSELECT \*PIVOTFORMAT + +PIVOTSELECT = [SxSelect](#sxselect) PIVOTRULE + +PIVOTFORMAT = [SxFormat](#sxformat) PIVOTRULE \[[SxDXF](#sxdxf)\] + +PIVOTVIEWEX = [SXViewEx](#sxviewex) \*PIVOTTH \*[SXPIEx](#sxpiex) \*PIVOTVDTEX + +PIVOTTH = [SXTH](#sxth) \*[ContinueFrt](#continuefrt) + +PIVOTVDTEX = [SXVDTEx](#sxvdtex) \*ContinueFrt + +QUERYTABLE = [Qsi](#qsi) DBQUERY QsiSXTag DBQUERYEXT \[SXADDLQSI\] \[QSIR\] \[SORTDATA12\] + +SXADDLQSI = [SXAddl_SXCQsi_SXDId](#sxaddl_sxcqsi_sxdid) SXADDLDBQUERY \*UNKNOWNFRT [SXAddl_SXCQsi_SXDEnd](#sxaddl_sxcqsi_sxdend) + +QSIR = [Qsir](#qsir) \*[Qsif](#qsif) + +DBQUERY = [DbOrParamQry](#dborparamqry) \[1\*[SXString](#sxstring) \[DbOrParamQry \*(SXString DbOrParamQry)\]\] \*SXString + +DBQUERYEXT = [DBQueryExt](#dbqueryext) \[[ExtString](#extstring)\] \*4\[[OleDbConn](#oledbconn) \*ExtString\] \[[TxtQry](#txtqry) \*ExtString\] + +CONDFMTS = \*(CONDFMT / CONDFMT12) \*([CFEx](#cfex) \[[CF12](#cf12)\]) + +CONDFMT = [CondFmt](#condfmt) 1\*3[CF](#cf) + +CONDFMT12 = [CondFmt12](#condfmt12) 1\*CF12 + +HLINK = [HLink](#hlink) \[[HLinkTooltip](#hlinktooltip)\] + +DVAL = [DVal](#dval) \*65534[Dv](#dv) + +PIVOTADDL = [SXAddl_SXCView_SXDId](#sxaddl_sxcview_sxdid) \*[Continue_SxaddlSxString](#continue_sxaddlsxstring) \[[SXAddl_SXCView_SXDVer10Info](#sxaddl_sxcview_sxdver10info)\] \[[SXAddl_SXCView_SXDVer12Info](#sxaddl_sxcview_sxdver12info)\] \*SXADDLCALCMEMBER \*SXADDLHIERARCHY \*SXADDLFIELD \*UNKNOWNFRT \[[SXAddl_SXCView_SXDTableStyleClient](#sxaddl_sxcview_sxdtablestyleclient)\] \[[SXAddl_SXCView_SXDCompactRwHdr](#sxaddl_sxcview_sxdcompactrwhdr) \*Continue_SxaddlSxString\] \[[SXAddl_SXCView_SXDCompactColHdr](#sxaddl_sxcview_sxdcompactcolhdr) \*Continue_SxaddlSxString\] \[[SXAddl_SXCView_SXDVerUpdInv](#sxaddl_sxcview_sxdverupdinv)\] \[SXADDLCONDFMTS\] \[SXADDLSXFILTERS12\] \*SXAddl_SXCView_SXDVerUpdInv \*[SXAddl_SXCView_SXDSXPIIvmb](#sxaddl_sxcview_sxdsxpiivmb) \[SXAddl_SXCView_SXDVerUpdInv\] [SXAddl_SXCView_SXDEnd](#sxaddl_sxcview_sxdend) + +SXADDLCALCMEMBER = ([SXAddl_SXCView_SXDCalcMember](#sxaddl_sxcview_sxdcalcmember) \[[SXAddl_SXCView_SXDCalcMemString](#sxaddl_sxcview_sxdcalcmemstring) \*Continue_SxaddlSxString\]) + +SXADDLCONDFMTS = [SXAddl_SXCSXCondFmts_SXDId](#sxaddl_sxcsxcondfmts_sxdid) \*SXADDLCONDFMT [SXAddl_SXCSXCondFmts_SXDEnd](#sxaddl_sxcsxcondfmts_sxdend) + +SXADDLCONDFMT = [SXAddl_SXCSXCondFmt_SXDSXCondFmt](#sxaddl_sxcsxcondfmt_sxdsxcondfmt) \*SXADDLSXRULE [SXAddl_SXCSXCondFmt_SXDEnd](#sxaddl_sxcsxcondfmt_sxdend) + +SXADDLAUTOSORT = [SXAddl_SXCAutoSort_SXDId](#sxaddl_sxcautosort_sxdid) SXADDLSXRULE [SXAddl_SXCAutoSort_SXDEnd](#sxaddl_sxcautosort_sxdend) + +SXADDLSXRULE = [SXAddl_SXCSXrule_SXDId](#sxaddl_sxcsxrule_sxdid) [SXAddl_SXCSXrule_SXDSXrule](#sxaddl_sxcsxrule_sxdsxrule) \*SXADDLSXFILT [SXAddl_SXCSXrule_SXDEnd](#sxaddl_sxcsxrule_sxdend) + +SXADDLSXFILT = [SXAddl_SXCSXfilt_SXDId](#sxaddl_sxcsxfilt_sxdid) [SXAddl_SXCSXfilt_SXDSXfilt](#sxaddl_sxcsxfilt_sxdsxfilt) \[[SXAddl_SXCSXfilt_SXDSXItm](#sxaddl_sxcsxfilt_sxdsxitm)\] [SXAddl_SXCSXfilt_SXDEnd](#sxaddl_sxcsxfilt_sxdend) + +SXADDLSXFILTERS12 = [SXAddl_SXCSXFilters12_SXDId](#sxaddl_sxcsxfilters12_sxdid) \*SXADDLSXFILTER12 [SXAddl_SXCSXFilters12_SXDEnd](#sxaddl_sxcsxfilters12_sxdend) + +SXADDLSXFILTER12 = [SXAddl_SXCSXFilter12_SXDId](#sxaddl_sxcsxfilter12_sxdid) [SXAddl_SXCSXFilter12_SXDSXFilter](#sxaddl_sxcsxfilter12_sxdsxfilter) \[[SXAddl_SXCSXFilter12_SXDCaption](#sxaddl_sxcsxfilter12_sxdcaption) \*Continue_SxaddlSxString\] \[[SXAddl_SXCSXFilter12_SXDSXFilterDesc](#sxaddl_sxcsxfilter12_sxdsxfilterdesc) \*Continue_SxaddlSxString\] \[[SXAddl_SXCSXFilter12_SXDSXFilterValue1](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1) \*Continue_SxaddlSxString\] \[[SXAddl_SXCSXFilter12_SXDSXFilterValue2](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2) \*Continue_SxaddlSxString\] [SXAddl_SXCSXFilter12_SXDXlsFilter](#sxaddl_sxcsxfilter12_sxdxlsfilter) \[[SXAddl_SXCSXFilter12_SXDXlsFilterValue1](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1) \*Continue_SxaddlSxString\] \[[SXAddl_SXCSXFilter12_SXDXlsFilterValue2](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2) \*Continue_SxaddlSxString\] [SXAddl_SXCSXFilter12_SXDEnd](#sxaddl_sxcsxfilter12_sxdend) + +SXADDLFIELD = \[[SXAddl_SXCField_SXDId](#sxaddl_sxcfield_sxdid) \*Continue_SxaddlSxString [SXAddl_SXCField_SXDVer10Info](#sxaddl_sxcfield_sxdver10info) [SXAddl_SXCField_SXDEnd](#sxaddl_sxcfield_sxdend)\] \[SXADDLFIELD12\] + +SXADDLFIELD12 = [SXAddl_SXCField12_SXDId](#sxaddl_sxcfield12_sxdid) \*Continue_SxaddlSxString [SXAddl_SXCField12_SXDVer12Info](#sxaddl_sxcfield12_sxdver12info) [SXAddl_SXCField12_SXDVerUpdInv](#sxaddl_sxcfield12_sxdverupdinv) \[[SXAddl_SXCField12_SXDMemberCaption](#sxaddl_sxcfield12_sxdmembercaption) \*Continue_SxaddlSxString\] \[[SXAddl_SXCField12_SXDAutoshow](#sxaddl_sxcfield12_sxdautoshow)\] \[[SXAddl_SXCField12_SXDISXTH](#sxaddl_sxcfield12_sxdisxth)\] \[SXADDLAUTOSORT\] SXAddl_SXCField12_SXDVerUpdInv \*UNKNOWNFRT [SXAddl_SXCField12_SXDEnd](#sxaddl_sxcfield12_sxdend) + +SXADDLHIERARCHY = [SXAddl_SXCHierarchy_SXDId](#sxaddl_sxchierarchy_sxdid) \*Continue_SxaddlSxString \*[SXAddl_SXCHierarchy_SXDProperty](#sxaddl_sxchierarchy_sxdproperty) \*SXADDLGRPLEVEL \[[SXAddl_SXCHierarchy_SXDVerUpdInv](#sxaddl_sxchierarchy_sxdverupdinv)\] \*[SXAddl_SXCHierarchy_SXDFilterMember](#sxaddl_sxchierarchy_sxdfiltermember) \[SXAddl_SXCHierarchy_SXDVerUpdInv\] \[[SXAddl_SXCHierarchy_SXDSXSetParentUnique](#sxaddl_sxchierarchy_sxdsxsetparentunique) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDIconSet](#sxaddl_sxchierarchy_sxdiconset)\] \[[SXAddl_SXCHierarchy_SXDUserCaption](#sxaddl_sxchierarchy_sxdusercaption) \*Continue_SxaddlSxString\] \*UNKNOWNFRT \[SXAddl_SXCHierarchy_SXDVerUpdInv\] \*[SXAddl_SXCHierarchy_SXDFilterMember12](#sxaddl_sxchierarchy_sxdfiltermember12) \[SXAddl_SXCHierarchy_SXDVerUpdInv\] \[[SXAddl_SXCHierarchy_SXDInfo12](#sxaddl_sxchierarchy_sxdinfo12)\] \[[SXAddl_SXCHierarchy_SXDDisplayFolder](#sxaddl_sxchierarchy_sxddisplayfolder) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDMeasureGrp](#sxaddl_sxchierarchy_sxdmeasuregrp) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDParentKPI](#sxaddl_sxchierarchy_sxdparentkpi) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDKPIValue](#sxaddl_sxchierarchy_sxdkpivalue) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDKPIGoal](#sxaddl_sxchierarchy_sxdkpigoal) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDKPIStatus](#sxaddl_sxchierarchy_sxdkpistatus) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDKPITrend](#sxaddl_sxchierarchy_sxdkpitrend) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDKPIWeight](#sxaddl_sxchierarchy_sxdkpiweight) \*Continue_SxaddlSxString\] \[[SXAddl_SXCHierarchy_SXDKPITime](#sxaddl_sxchierarchy_sxdkpitime) \*Continue_SxaddlSxString\] [SXAddl_SXCHierarchy_SXDEnd](#sxaddl_sxchierarchy_sxdend) + +SXADDLGRPLEVEL = [SXAddl_SXCGrpLevel_SXDId](#sxaddl_sxcgrplevel_sxdid) \*Continue_SxaddlSxString [SXAddl_SXCGrpLevel_SXDGrpLevelInfo](#sxaddl_sxcgrplevel_sxdgrplevelinfo) \*SXADDLGROUP \*UNKNOWNFRT [SXAddl_SXCGrpLevel_SXDEnd](#sxaddl_sxcgrplevel_sxdend) + +SXADDLGROUP = [SXAddl_SXCGroup_SXDId](#sxaddl_sxcgroup_sxdid) \*Continue_SxaddlSxString [SXAddl_SXCGroup_SXDGrpInfo](#sxaddl_sxcgroup_sxdgrpinfo) \*[SXAddl_SXCGroup_SXDMember](#sxaddl_sxcgroup_sxdmember) \*UNKNOWNFRT [SXAddl_SXCGroup_SXDEnd](#sxaddl_sxcgroup_sxdend) + +For ABNF rules not listed here, see the [Common Productions](#Section_a1b3d8b4744241fd9c57bbd2a6394082) section. + +##### Common Productions + +Record sequence fragments that are common to multiple substreams are specified here. If a fragment cannot be found under its part, look for it in this record sequence[\<9\>](#Appendix_A_9)[\<10\>](#Appendix_A_10)[\<11\>](#Appendix_A_11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf): + +GLOBALS = [CalcMode](#calcmode) [CalcCount](#calccount) [CalcRefMode](#calcrefmode) [CalcIter](#calciter) [CalcDelta](#calcdelta) [CalcSaveRecalc](#calcsaverecalc) [PrintRowCol](#printrowcol) [PrintGrid](#printgrid) [GridSet](#gridset) [Guts](#guts) [DefaultRowHeight](#defaultrowheight) [WsBool](#wsbool) \[[Sync](#sync)\] \[[LPr](#lpr)\] \[[HorizontalPageBreaks](#horizontalpagebreaks)\] \[[VerticalPageBreaks](#verticalpagebreaks)\] + +PAGESETUP = [Header](#header) [Footer](#footer) [HCenter](#hcenter) [VCenter](#vcenter) \[[LeftMargin](#leftmargin)\] \[[RightMargin](#rightmargin)\] \[[TopMargin](#topmargin)\] \[[BottomMargin](#bottommargin)\] \[[Pls](#pls) \*[Continue](#continue)\] [Setup](#setup) + +BACKGROUND = [BkHim](#bkhim) \*Continue + +BIGNAME = [BigName](#bigname) \*[ContinueBigName](#continuebigname) + +PROTECTION = \[[Protect](#protect)\] \[[ScenarioProtect](#scenarioprotect)\] \[[ObjProtect](#objprotect)\] \[[Password](#password)\] + +COLUMNS = [DefColWidth](#defcolwidth) \*255[ColInfo](#colinfo) + +AUTOFILTER = [AutoFilterInfo](#autofilterinfo) \*([AutoFilter](#autofilter) / ([AutoFilter12](#autofilter12) \*[ContinueFrt12](#continuefrt12))) \*SORTDATA12 + +CELLTABLE = 1\*(1\*[Row](#row) \*CELL 1\*[DBCell](#dbcell)) \*[EntExU2](#entexu2) + +CELL = FORMULA / [Blank](#blank) / [MulBlank](#mulblank) / [RK](#rk) / [MulRk](#mulrk) / [BoolErr](#boolerr) / [Number](#number) / [LabelSst](#labelsst) + +FORMULA = \[[Uncalced](#uncalced)\] [Formula](#formula) \[[Array](#array) / [Table](#table) / [ShrFmla](#shrfmla) / SUB\] \[[String](#string) \*Continue\] + +PHONETICINFO = [PhoneticInfo](#phoneticinfo) \*Continue + +OBJECTS = \*(MSODRAWING \*(TEXTOBJECT / OBJ)) \[[MsoDrawingSelection](#msodrawingselection)\] + +MSODRAWING = [MsoDrawing](#msodrawing) \*Continue + +OBJ = [Obj](#obj) \*Continue \*CHART + +CHART = CHARTSHEET \*Continue + +TEXTOBJECT = [TxO](#txo) \*Continue + +DCON = [DCon](#dcon) \*([DConName](#dconname) / [DConBin](#dconbin) / [DConRef](#dconref)) + +WINDOW = [Window2](#window2) \[[PLV](#plv)\] \[[Scl](#scl)\] \[[Pane](#pane)\] \*[Selection](#selection) + +CUSTOMVIEW = [UserSViewBegin](#usersviewbegin) \*Selection \[HorizontalPageBreaks\] \[VerticalPageBreaks\] \[Header\] \[Footer\] \[HCenter\] \[VCenter\] \[LeftMargin\] \[RightMargin\] \[TopMargin\] \[BottomMargin\] \[Pls\] \[Setup\] \[[PrintSize](#printsize)\] \[[HeaderFooter](#headerfooter)\] \[AUTOFILTER\] [UserSViewEnd](#usersviewend) + +SORT = [RRSort](#rrsort) \*Continue + +SORTDATA12 = [SortData](#sortdata) \*ContinueFrt12 + +PIVOTRULE = [SxRule](#sxrule) \*PRFILTER + +PRFILTER = [SxFilt](#sxfilt) \[[SxItm](#sxitm) \*Continue\] + +FEAT = [FeatHdr](#feathdr) \*([Feat](#feat) \*[ContinueFrt](#continuefrt)) + +FEAT11 = [FeatHdr11](#feathdr11) \*(([Feature11](#feature11) / [Feature12](#feature12)) \*[ContinueFrt11](#continuefrt11) \*[List12](#list12) \[AutoFilter12 \*ContinueFrt12\] \*List12 \[SORTDATA12\]) + +RECORD12 = HeaderFooter + +SXADDLDBQUERY = \[[SXAddl_SXCQuery_SXDXMLSource](#sxaddl_sxcquery_sxdxmlsource) \*[Continue_SxaddlSxString](#continue_sxaddlsxstring)\] \[[SXAddl_SXCQuery_SXDSrcDataFile](#sxaddl_sxcquery_sxdsrcdatafile) \*Continue_SxaddlSxString\] \[[SXAddl_SXCQuery_SXDSrcConnFile](#sxaddl_sxcquery_sxdsrcconnfile) \*Continue_SxaddlSxString\] \[[SXAddl_SXCQuery_SXDReconnCond](#sxaddl_sxcquery_sxdreconncond)\] [SXAddl_SXCQuery_SXDEnd](#sxaddl_sxcquery_sxdend) + +UNKNOWNFRT = [SXAddl](#sxaddl) + +#### XML Signatures Storage (\_xmlsignatures) + +The **XML Signatures Storage** is specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.5.2. + +The name of this storage MUST be "\_xmlsignatures". A file MUST contain at most one **XML Signatures S**torage[\<12\>](#Appendix_A_12). + +When generating the **DigestValue**, as specified in [\[XMLDSig\]](https://go.microsoft.com/fwlink/?LinkId=130861) section 4.3.3.6, the record data, as specified in the **Record** section (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)), in the **WriteAccess record** (section [2.4.349](#writeaccess)) in the **Globals Substream** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) is skipped. + +#### XML Stream (XML) + +The XML **S**tream specifies one or more [**XML maps**](#gt_01b93f1f-ca62-4216-82d5-b6154e925c9f). + +The name of the stream MUST be "XML". A file MUST contain at most one XML **S**tream. + +The syntax of the structures contained in this part uses [**XML schema definition (XSD)**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this stream is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) as specified by the following [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067): + +123. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +##### Elements + +The following table specifies the [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae) elements that are specific to the **XML Stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)): + +| Element | Description | +|----|----| +| **MapInfo** (section [2.1.7.22.1.1](#Section_a7ea1bde730c4ef3bc9379f78f793aab)) | This element specifies a container for all of the [**XML schemas**](#gt_bd0ce6f9-c350-4900-827e-951265294067) and [**XML maps**](#gt_01b93f1f-ca62-4216-82d5-b6154e925c9f) attached to workbook. | +| **Schema** (section [2.1.7.22.1.2](#Section_085d058b1173411ead93fddbd822f781)) | This element specifies an XML schema associated with an XML map. | +| **Map** (section [2.1.7.22.1.3](#Section_82224f3b936a44cbbec1b0992d1a1281)) | This element specifies an XML map and the behaviors expected during [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) operations. | +| **DataBinding** (section [2.1.7.22.1.4](#Section_53d6d872ee4849689d06365efeb5b416)) | This element specifies a connection to an [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) file [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) that is used when the XML map is refreshed. | + +###### MapInfo + +The **MapInfo element** specifies a container for all of the [**XML schemas**](#gt_bd0ce6f9-c350-4900-827e-951265294067) and [**XML maps**](#gt_01b93f1f-ca62-4216-82d5-b6154e925c9f) attached to workbook. + +**SelectionNamespaces:** An **ST_Xstring65535** (section [2.1.7.22.2.4](#Section_5e49634084e34b73af72f38e0ab2a29a)) that specifies the [**XML namespace**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) for use in [**XPath**](#gt_9ec9a242-d5db-4c3b-8aeb-61708ee75045) expressions. + +###### Schema + +The **Schema element** specifies an [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) associated with an [**XML map**](#gt_01b93f1f-ca62-4216-82d5-b6154e925c9f). The contents of this element MUST be an [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +**ID:** An **ST_Xstring65535** that specifies the unique name for this attached XML schema. + +**Namespace:** An **ST_Xstring65535** that specifies the [**XML namespace**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) used by the XML schema. + +**SchemaRef:** An **ST_Xstring65535** that specifies the other **Schema elements** in this parent **MapInfo element** (section [2.1.7.22.1.1](#Section_a7ea1bde730c4ef3bc9379f78f793aab)) that contain XML schemas that the XML schema for this **Schema element** is dependent on. The value MUST specify the dependent **Schema** elements by **ID** in a space-delimited list. The **SchemaRef** attribute MUST be absent or the value MUST be empty if there are no dependencies. + +###### Map + +The **Map element** specifies an [**XML map**](#gt_01b93f1f-ca62-4216-82d5-b6154e925c9f) and the behaviors expected during [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) operations. + +**Append:** An **ST_XmlMapBoolean** (section [2.1.7.22.2.2](#Section_67ff54e278704f6f8994eb2432722d8e)) that specifies whether [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) data overwrites or is appended to the [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) or [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells associated with the XML map on refresh. + +**AutoFit:** An **ST_XmlMapBoolean** that specifies whether columns are resized to fit the XML data after a refresh operation. + +**ID:** An **ST_XmlMapId** (section [2.1.7.22.2.3](#Section_f5c694496137446f8e60c2d6454482ef)) that specifies the identifier of the XML map. + +**Name:** An **ST_Xstring256** (section [2.1.7.22.2.5](#Section_6e4faeb05d3649918607f6165a328d56)) that specifies the name of the XML map. **Name** MUST be unique for each **Map**. + +**PreserveFormat:** An **ST_XmlMapBoolean** that specifies whether [**number formats**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) in the [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) are preserved during refresh or whether the number formats specified by the [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) are used. + +**PreserveSortAFlayout:** An **ST_XmlMapBoolean** that specifies whether to reapply the [**filtering state**](#gt_23b8e882-6774-4028-924c-74fffbb370f8) of the table after a refresh. + +**RootElement:** An **ST_Xstring65535** (section [2.1.7.22.2.4](#Section_5e49634084e34b73af72f38e0ab2a29a)) that specifies the name of the root XML element. + +**SchemaID:** An **ST_Xstring65535** that specifies the name of the XML schema used for the XML map. **SchemaID** MUST equal the **ID** attribute of a **Schema** element (section [2.1.7.22.1.2](#Section_085d058b1173411ead93fddbd822f781)) contained within the parent **MapInfo** element (section [2.1.7.22.1.1](#Section_a7ea1bde730c4ef3bc9379f78f793aab)). + +**ShowImportExportValidationErrors:** An **ST_XmlMapBoolean** that specifies whether validation errors are displayed during refresh or data export. + +###### DataBinding + +The **DataBinding element** specifies a connection to an [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) file [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) that is used when the [**XML map**](#gt_01b93f1f-ca62-4216-82d5-b6154e925c9f) is refreshed. + +**DataBindingLoadMode:** An **ST_DataBindingLoadMode** (section [2.1.7.22.2.1](#Section_7c8660087ce84de883e29a0404a6fc0c)) that specifies the method for loading XML data. + +**DataBindingName:** An **ST_Xstring65535** that specifies the name for this connection. **DataBindingName** MUST be unique for each **DataBinding** element. + +**FileBinding:** An **ST_Xstring65535** that specifies the XML file data source used for [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060). **FileBinding** MUST NOT be "true" or "false". + +**FileBindingName:** An **ST_Xstring65535** that specifies the name for the XML file data source. **FileBindingName** MUST be unique for each **DataBinding** element. + +##### Simple Types + +The following table specifies the [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae) simple types that are specific to the **XML Stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)): + +| Element | Description | +|----|----| +| **ST_DataBindingLoadMode** (section [2.1.7.22.2.1](#Section_7c8660087ce84de883e29a0404a6fc0c)) | This simple type specifies the method for loading [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) data related to a **DataBinding** element (section [2.1.7.22.1.4](#Section_53d6d872ee4849689d06365efeb5b416)). | +| **ST_XmlMapBoolean** (section [2.1.7.22.2.2](#Section_67ff54e278704f6f8994eb2432722d8e)) | This simple type specifies Boolean values. | +| **ST_XmlMapId** (section [2.1.7.22.2.3](#Section_f5c694496137446f8e60c2d6454482ef)) | This simple type is an integral value that specifies the identifier of an **XML map** (section [2.1.7.22.1.3](#Section_82224f3b936a44cbbec1b0992d1a1281)) in the **XML Stream** (section 2.1.7.22). | +| **ST_Xstring65535** (section [2.1.7.22.2.4](#Section_5e49634084e34b73af72f38e0ab2a29a)) | This simple type is a string that MUST NOT exceed 65,535 [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters. | +| **ST_Xstring256** (section [2.1.7.22.2.5](#Section_6e4faeb05d3649918607f6165a328d56)) | This simple type is a string that MUST NOT exceed 256 Unicode characters. | + +###### ST_DataBindingLoadMode + +The **ST_DataBindingLoadMode** simple type specifies the method for loading [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) data related to a **DataBinding** element (section [2.1.7.22.1.4](#Section_53d6d872ee4849689d06365efeb5b416)). + +The following are possible enumeration values for this type: + +| **Enumeration Value** | **Description** | +|-----------------------|-----------------| +| 0 | None. | +| 1 | Normal. | +| 2 | Delay Load. | +| 3 | Asynchronous. | +| 4 | Object Model. | + +###### ST_XmlMapBoolean + +The **ST_XmlMapBoolean** simple type defines **Boolean** values (section [2.5.14](#boolean)). + +The following are possible enumeration values for this type: + +| **Enumeration Value** | **Description** | +|-----------------------|----------------------| +| false | False Boolean value. | +| true | True Boolean value. | + +###### ST_XmlMapId + +The **ST_XmlMapId** simple type is an integral value that specifies the identifier of an **XML map** (section [2.1.7.22.1.3](#Section_82224f3b936a44cbbec1b0992d1a1281)) in the **XML Stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)). **ST_XmlMapId** MUST be greater than or equal to 1 and less than or equal to 2147483647. + +###### ST_XmlString65535 + +The **ST_XmlString65535** simple type is a string that MUST NOT exceed 65,535 [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters. + +###### ST_XmlString256 + +The **ST_XmlString256** simple type is a string that MUST NOT exceed 256 [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters. + +## Conceptual Overview + +This section specifies how higher-level features of the file format are represented by combinations of records. + +### Cell Table + +Text, formulas, and numerical data within [**workbooks**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) are primarily stored in the cells that make up **worksheets** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) and **macro sheets** (section [2.1.7.20.4](#Section_0dddd943f77a4fc2bf92868acb4587f7)). Cells are the fundamental building blocks that contain data, formulas, and formatting to form the workbook. The data structure associated with the grid of cells is called the **cell table**. + +The cell table is stored in the sequence of records that conform to the **CELLTABLE** rule (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)) within the Common Productions [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The cell table consists of a series of row blocks. From the first row containing data to the last row containing data, every 32 consecutive rows, including blank rows, comprise a row block. + +The number of row blocks in a [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) is specified by the following algorithm that uses fields from the **Dimensions** record (section [2.4.90](#dimensions)): + +213. if ((rwMac –rwMic) % 32 == 0) + + number of row blocks = (rwMac –rwMic) / 32 + + else + + number of row blocks = (rwMac –rwMic) / 32 + 1 + +Within each row block, a **Row** record (section [2.4.221](#row)) is saved for each row that contains data or row formatting. For each such row, every [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that contains data or individual cell formatting is represented by a record. Formatting information for a cell can be derived from individual cell formatting, row formatting, column formatting, or the default cell format as specified by the **XFIndex** structure (section [2.5.282](#xfindex)). The order of precedence for formatting is individual cell formatting with the highest precedence, followed by row formatting, and then column formatting, and then the default cell format. Cells that do not contain data and do not contain individual formatting are not saved. + +Cells are specified by any of the records specified in the **CELL** rule (section 2.1.7.20.6). Multiple cells can be represented by one record—for example, a **MulBlank** record (section [2.4.174](#mulblank)) specifies a series of blank cells. Note that blank cells are only included when they contain individual cell formatting. Rows are saved in increasing order, and cells are saved in row-major order. + +The order of the records that comprise a row block begins with a series of **Row** records (a maximum of 32 such records), followed by the records representing the cells, followed by the **DBCell** record (section [2.4.78](#dbcell)). A cell in the cell table is referred to by its row and column indexes, which are zero-based. The maximum row index is 65535. The maximum column index is 255. + +The bounding box of the non-empty cells is stored in the **Dimensions** record. Information that applies to each column is specified in the **COLUMNS** collection (section 2.1.7.20.6). + +#### Retrieval of Last-Calculated Cell Values Without Loading Cell Table + +The only way to retrieve formulas, formats and other cell data is to read the cell table normally as defined earlier. However, in certain situations (for example when resolving external references to values) it is beneficial to retrieve only the last calculated value from a cell, without actually loading the cell table. To improve the performance of a random read access to the values in the **cell table** (section [2.2.1](#Section_d690007dd25c4822a650b24c13288bb7)), [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) provides **Index** (section [2.4.144](#index)) and **DBCell** (section [2.4.78](#dbcell)) records. To find a particular [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) value, an application can perform the following: + +1. Read **Index** records to find one such that the cell row is greater or equal to **rwMic** and less than **rwMac**. + +2. Compute the data offset of the required **DBCell** record according to the description of the **Index** record. + +3. Read the **DBCell** record (section 2.4.78) in the obtained position, and compute the data offset of the cell row according to the following: + + 1. The file position of the first non-empty **Row** (section [2.4.221](#row)) in a row block is equal to the file position of the **DBCell** record ─the **dbRtrw** field of **DBCell** record. + + 2. The file position of the first **CELL** record (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)) for the first non-empty **Row** (section 2.4.221) is equal to the file position of the second **Row** record (the end of the first **Row** record) + **rgdb\[0\]**. Other non-empty **CELL** records for the first row follow this first **CELL** record. + + 3. The file position of the first **CELL** record for the second non-empty **Row** is equal to the file position of the first **CELL** record for the first **Row** + **rgdb\[1\]**. Other non-empty **CELL** records for the 2^(nd) row follow this first **CELL** record. + + 4. The file position for the first **CELL** record for the third non-empty **Row** is equal to the file position of the first **CELL** record for the second **Row** + **rgdb\[2\]**. + +4. Read cell table data starting from the previously computed position. + +Note that if the **Row** of the **CELL** record is known, it is possible to calculate the file position of the first **CELL** record of that **Row** first, and then get all the following **CELL** records without going through the first **Row**, the second **Row**, and so on. + +### Formulas + +A formula is sequence of values, cell references, names, functions, or operators in a cell that together produce a new value. **Formulas** are stored in a tokenized representation known as "parsed expressions." In this section, formula is a synonym for parsed expression. A parsed expression is converted into a textual formula at runtime for display and user editing. Cell formulas are specified by the **Formula** record (section [2.4.127](#formula)). Array formulas are specified by the **Array** record (section [2.4.4](#array)). Shared formulas are specified by the **ShrFmla** record (section [2.4.260](#shrfmla)). + +**Formulas** that are part of a [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) as specified in the Shared Workbooks overview (section [2.2.11](#Section_e45a62c4490f4304a09668908b57dacc)) are specified by the **pe**.**rgce** field or the **peOld**.**rgce** field of the **RRDDefName** record (section [2.4.225](#rrddefname)), or by the **xpe**.**rgce** field or the **xpeOld**.**rgce** field of the **RRDChgCell** record (section [2.4.223](#rrdchgcell)). + +A parsed [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) contains a sequence of parse tokens, each of which is either an **operand** token (section [2.2.2.2](#Section_011ec51c5e8742aea0a1f5ee242c1189)), an **operator** token (section [2.2.2.1](#Section_0c6cc754f96f4061a9759d6eae97f8a3)), a **control** token (section [2.2.2.3](#Section_3701f8837bef4eacb0e05ecbf4a23cbd)), a **display** token (section [2.2.2.4](#Section_44ae9bca374542a482095e7ded229789)), or a **mem** token (section [2.2.2.5](#Section_0e7857a5d73a4abaafdaaa3996f562fd)). All tokens are stored as Parse Things (**Ptg** (section [2.5.198.25](#ptg))). + +With the exception of **control** tokens (section 2.2.2.3), **display** tokens (section 2.2.2.4), and **mem** tokens (section 2.2.2.5) that are described in subsequent sections, parsed expressions are stored in **Rgce** (section [2.5.198.104](#rgce)) using Reverse-Polish notation. Reverse-Polish notation is a logical system for the specification of mathematical formulas in which operands are followed by operators. Inside an **Rgce,** the operands and operators are represented by an array of **Ptg** structures (section 2.5.198.25) of variable lengths. The first one or two bytes of a **Ptg** structure (section 2.5.198.25) contain the token type that determines which specific **Ptg** type (section 2.5.198.25) the **Ptg** is, as specified in the **Ptg** structure The remainder of the structure varies according to the token type. + +Evaluation of a formula specified in Reverse-Polish notation is usually based around an evaluation stack. The expression is parsed from beginning to end, and operands are pushed onto the stack as they are encountered. When operators are encountered, the required number of operands is popped from the stack and the result of the operation is pushed back onto the stack. Evaluation begins with an empty stack, and when the evaluation is finished, there will be exactly one value left on the stack. The value is the result of the evaluation. Subsequent subsections refer to a stack as described by this model. + +#### Operator Tokens + +**Unary Operator Tokens** + +**Unary Operator** Tokens specify operations that are performed on the previous element in the grammar specified by **Rgce** (section [2.5.198.104](#rgce)). For example, **PtgPercent** (section [2.5.198.81](#ptgpercent)) divides the last expression on the stack by 100. + +**Binary Operator Tokens** + +**Binary Operator T**okens specify operations that are performed on the previous two elements in the grammar specified by **Rgce**. For example, **PtgIsect** (section [2.5.198.67](#ptgisect)), which intersects the topmost two expressions on the stack. + +#### Operand Tokens + +**Operand** Tokens represent values and references that are used by operators and functions. Operands fall into one of two classes, **reference class** (section [2.2.2.2.2](#Section_a8fde0d5759c437eb385169df8117372)), or **value class** (section [2.2.2.2.1](#Section_9a43cbef26504581af603ff0d876d82a)), depending on what result type the formula expects from the operand. + +##### Value Class + +**Value Class** is the most common type of operand, and represents a single value or array of values. When **Ptg records** (section [2.5.198.25](#ptg)) with reference contents are used by an operator that requires **Value Class** operands, the **Ptg records** can be stored as **Value Class** operands rather than **reference class** (section [2.2.2.2.2](#Section_a8fde0d5759c437eb385169df8117372)) operands. For example, in a formula where the contents of A1 is added to the integer value 1, the value of [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) A1 is pushed onto the stack as a **Value Class** operand **PtgRef** (section [2.5.198.84](#ptgref)) because the subsequent **PtgAdd** operator (section [2.5.198.26](#ptgadd)) requires **Value Class** operands. Arrays are stored in a similar fashion. For example, when adding the array of values {1,2,3,4,5,6}, the values are stored in a **PtgArray** operand (section [2.5.198.32](#ptgarray)). + +##### Reference Class + +When operands are stored as **R**eference **Class** operands, any references contained in the operand are not de-referenced and do not return the underlying value or values. They are pushed onto the stack in reference form. + +#### Control Tokens + +Control Tokens do not perform operations or push values onto the stack. Conditional **C**ontrol Tokens (**PtgAttrIf** (section [2.5.198.36](#ptgattrif)), **PtgAttrChoose** (section [2.5.198.34](#ptgattrchoose)), and **PtgAttrGoto** (section [2.5.198.35](#ptgattrgoto))) are used at runtime to prescribe short-circuit evaluation inside conditional functions and can be ignored when converting parsed expressions into textual formulas. + +#### Display Tokens + +**Display** Tokens, like **C**ontrol Tokens (section [2.2.2.3](#Section_3701f8837bef4eacb0e05ecbf4a23cbd)), do not perform operations or push values onto the stack. **Display** Tokens (**PtgParen** (section [2.5.198.80](#ptgparen) and **PtgAttrSpace** (section [2.5.198.38](#ptgattrspace))) are used at runtime to represent parentheses and space characters in a formula when parsed expressions are converted into textual formulas. **Display** Tokens do not affect the order of operations of the formula. + +#### Mem Tokens + +**Mem** Tokens have two purposes: they cache the results of **reference class expressions** (section [2.2.2.2.2](#Section_a8fde0d5759c437eb385169df8117372)) and they can return the results of **reference class expressions** (section 2.2.2.2.2) as **value class expressions** (section [2.2.2.2.1](#Section_9a43cbef26504581af603ff0d876d82a)). **Mem** Tokens act on **binary-reference-expressions** (section [2.5.198.104](#rgce)) that follow them it in a **mem-area-expression** (section 2.5.198.104). + +#### Formula Elements + +Some **Ptg** records (section [2.5.198.25](#ptg)) require extra data that is not stored in the **Rgce** (section [2.5.198.104](#rgce)). When an **Rgce**contains one or more of these **Ptg** records, the containing formula structure includes an **RgbExtra** (section [2.5.198.103](#rgbextra)) containing the data for those **Ptg** records. The size of these components is specified by the **RgbExtra** structures. The **Ptg** records do not contain an offset into the **RgbExtra** for their data. The **Ptg** records that require a corresponding structure in **RgbExtra** are specified in section 2.5.198.103. + +### Charts + +The following diagram identifies the major aspects of the file format representation of a chart. + +![High-level structure of a chart](media/image1.bin "High-level structure of a chart") + +Figure 1: High-level structure of a chart + +The **chart sheet** (section [2.2.3.1](#Section_2c90d75bc92645aa8ff29d4483f51831)) specifies a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)), a graphic that displays data or the relationships between sets of data in a visual form, and a **chart data cache** (section [2.2.3.2](#Section_e21d24e4e71f4fdc81077f0d6a6efa6a)), a local copy of the data that is used if the **chart** data is missing or if links to external [**data sources**](#gt_e091613c-6901-4874-b9b2-27273ead1075) are broken. The **chart** specifies one or two **axis groups** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)), a set of **axes** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)) the **chart** data is plotted against, and the set of **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)), **trendlines** (section [2.2.3.12](#Section_61d74ebc36714d6dbdc0626db604530d)), and **error bars** (section [2.2.3.13](#Section_762a461d0a45474ebd7d5994bb294af2)) specified in the **chart**. Each **axis groups** specifies one to four **chart groups** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) that specify the type of visualization used to display the data. Each **series**, **trendline**, and **error bar** specifies a **chart group** it is associated with. + +#### Chart Sheet + +A **chart sheet** is a set of data and the **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) that displays the data. There are two types of **chart sheets**: embedded **chart sheets**, and chart sheets that are not embedded. + +A **chart sheet** that is not embedded is a separate [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) that is intended to display a **chart**. An embedded **chart sheet** is the logical container for a **chart** displayed on a [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +A **chart sheet** is specified by the **chart sheet substream** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)). + +The **chart sheet substream** for an embedded **chart sheet** is contained within a **worksheet substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). A chart sheet that is not embedded is specified by a **chart sheet substream** that is not contained in another substream. + +The following records and rules specify the significant parts of a **chart sheet**: + +- The **SheetExt** record (section [2.4.259](#sheetext)) specifies properties of the sheet (1) containing the **chart**. If the **chart sheet** is embedded, the **SheetExt** record MUST NOT exist. + +- The **WebPub** record (section [2.4.344](#webpub)) specifies properties of a **chart sheet** that has been published to the web. + +- The sequences of records that conform to the **PAGESETUP** rule (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)) and **BACKGROUND** rule (section 2.1.7.20.6) and the **HFPicture** (section [2.4.138](#hfpicture)), **PrintSize** (section [2.4.204](#printsize)), and **HeaderFooter** (section [2.4.137](#headerfooter)) records specify information about how the **chart** is printed. + +- The **Fbi** (section [2.4.109](#fbi)) and **Fbi2** (section [2.4.110](#fbi2)) records specify properties used for [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) scaling on the **chart**. + +- The **Palette** (section [2.4.188](#palette)) and **ClrtClient** (section [2.4.50](#clrtclient)) records specify properties of the [**color palettes**](#gt_05879d13-b9e0-4333-b96d-63cc3433997e) used in the **chart sheet**. + +- The sequence of records that conforms to the **PROTECTION** rule (section 2.1.7.20.6) and the **WriteProtect** record (section [2.4.350](#writeprotect)) specify [**protection**](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499) settings for the **chart**. If the chart sheet is embedded, the **WriteProtect** record MUST NOT exist. + +- The **SXViewLink** (section [2.4.316](#sxviewlink)), **PivotChartBits** (section [2.4.196](#pivotchartbits)), and **SBaseRef** (section [2.4.242](#sbaseref)) records specify the **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) that is the data source for this **chart**. If the **chart** is not a **Pivot Chart** (section [2.2.3.4](#Section_bed5fbd356f54997bb54b49f04e734b7)) these records MUST be ignored. + +- The sequence of records that conforms to the **OBJECTS** rule (section 2.1.7.20.6) and the **MsoDrawingGroup** record (section [2.4.171](#msodrawinggroup)) specify the drawing objects on the **chart** + +- The sequence of records that conforms to the **CHARTFOMATS** rule (section 2.1.7.20.6) specifies the **chart** that is contained in the **chart sheet**. + +- The sequence of records that conforms to the **SERIESDATA** rule (section 2.1.7.20.6) specifies the **chart data cache** (section [2.2.3.2](#Section_e21d24e4e71f4fdc81077f0d6a6efa6a)). + +- The sequences of records that conform to the **WINDOW** rule (section 2.1.7.20.6) and **CUSTOMVIEW** rule (section 2.1.7.20.6) specify the sheet (1) that contains the **chart**. If the **chart sheet** is not embedded, at least one sequence of records that conform to the **WINDOW** rule MUST exist. If the **chart sheet** is embedded, a sequence of records that conforms to the **WINDOW** rule and **CUSTOMVIEW** rule MUST NOT exist. + +- The sequence of records that conforms to the **CRTMLFRT** rule (section 2.1.7.20.6) specifies **future records** (section [2.1.6](#Section_b660b67822684414839ed1ae9a4e4e85)) for the **chart sheet**. + +#### Chart Data Cache + +A **chart data cache** is a local copy of the data for a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). The **chart data cache** is used if data is missing or if links to external [**data sources**](#gt_e091613c-6901-4874-b9b2-27273ead1075) are broken. + +A **chart data cache** is specified by a sequence of records that conforms to the **SERIESDATA** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +The following records and rules specify the significant parts of a **chart data cache**: + +- The **Dimensions** record (section [2.4.90](#dimensions)) specifies the cells that contain data used by this **chart**. + +- The **SIIndex** record (section [2.4.262](#siindex)) specifies the beginning of a sequence of records that contains a cache of the data for the sequence of records that conforms to a specific **AI** rule (section 2.1.7.20.1) in the **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) and **error bars** (section [2.2.3.13](#Section_762a461d0a45474ebd7d5994bb294af2)). The relationship between the **series** and the chart data cache is specified as follows: + +  + +- The first **SIIndex** record in the **chart sheet substream**, which MUST contain a **numIndex** field equal to 0x0001, corresponds to the second sequence of records that conforms to the **AI** rule. + +- The second **SIIndex** record in the **chart sheet substream**, which MUST contain a **numIndex** field equal to 0x0002, corresponds to the third sequence of records that conforms to the **AI** rule. + +- The third **SIIndex** record in the **chart sheet substream**, which MUST contain a **numIndex** field equal to 0x0003, corresponds to the fourth sequence of records that conforms to the **AI** rule. + +  + +- The **Number** (section [2.4.180](#number)), **BoolErr** (section [2.4.24](#boolerr)), **Blank** (section [2.4.20](#blank)), and **Label** (section [2.4.148](#label)) records each specify an individual value stored in the cache. Each column in the cache corresponds to a **series** or **error bar**, where the zero-based index of the column, specified by the **cell.col** field in the **Number**, **BoolErr**, **Blank**, or **Label** records, equals the zero-based index of the **Series** record (section [2.4.252](#series-1)) in the collection of **Series** records that corresponds to the **series** or **error bar**. + +The following restrictions apply to the **chart data cache**: + +- The **chart data cache** MUST contain data that corresponds to a sequence of records that conforms to the **AI** rule in a **series** if the corresponding data is not specified in the **chart** or on the same [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) as the **chart**. + +- The **chart data cache** MUST NOT contain data that corresponds to a sequence of records that conforms to the **AI** rule in a **series** if the corresponding data is specified in the **chart** or on the same sheet (1) as the **chart**. + +- The **chart data cache** MUST NOT contain data that corresponds to the third or fourth sequence of records that conforms to the **AI** rule in an **error bar**. + +- If the **ebsrc** field of the **SerAuxErrBar** record (section [2.4.249](#serauxerrbar)) in an **error bar** equals 0x04, the **chart data cache** MUST contain data that corresponds to the second sequence of records that conforms to the **AI** rule in the **error bar**. + +- If the **ebsrc** field of the **SerAuxErrBar** record in an error bar does not equal 0x04, the **chart data cache** MUST NOT contain data that corresponds to the second sequence of records that conforms to the **AI** rule in the **error bar**. + +- The **chart data cache** MUST NOT contain data that corresponds to a **trendline** (section [2.2.3.12](#Section_61d74ebc36714d6dbdc0626db604530d)). + +#### Chart + +A **chart** is a graphic that displays data or the relationships between sets of data in a visual form. A **chart** element is an item within the chart such as an **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)), **legend** (section [2.2.3.8](#Section_1832229b7d1945f488d455e9c07466f0)), **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)), **data point** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)), **data label** (section [2.2.3.11](#Section_cac7f43a3af142f58ff2814c2870427f)), **trendline** (section [2.2.3.12](#Section_61d74ebc36714d6dbdc0626db604530d)), **error bar** (section [2.2.3.13](#Section_762a461d0a45474ebd7d5994bb294af2)), or **data table** (section [2.2.3.14](#Section_69938f61d2e94da3af87e154edcb0d98)). + +A **chart data cache** (section [2.2.3.2](#Section_e21d24e4e71f4fdc81077f0d6a6efa6a)) is specified by a sequence of records that conforms to the **CHARTFOMATS** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +A **chart** can contain the following records and rules that specify the parts of the **chart**: + +- The **Chart** record (section [2.4.45](#chart-2)) specifies the position and size of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)) for a non-embedded chart. + +- The sequence of records that conforms to the **FONTLIST** rule (section 2.1.7.20.1) specifies [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information for the **chart**. + +- The **Scl** record (section [2.4.247](#scl)) specifies the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) of the current view in the window used to display the **chart**. + +- The **PlotGrowth** record (section [2.4.198](#plotgrowth)) specifies font scaling for the text on the **chart**. + +- The sequence of records that conforms to the **FRAME** rule (section 2.1.7.20.1) specifies formatting of the chart area (section 2.2.3.17). + +- The sequence of records that conforms to the **SERIESFORMAT** rule (section 2.1.7.20.1) specifies the **series**, **trendlines**, and **error** on the **chart**. + +- The sequences of records that conform to the **SS** rule (section 2.1.7.20.1) specify properties of the **data labels**, **series**, **data points**, **trendlines**, and **error bars** on the **chart**. These records MUST NOT exist if the **chart sheet substream** contains a **Series** record (section [2.4.252](#series-1)). See the **data label** overview for additional restrictions on these collections of records. + +- The sequences of records that conform to the **DFTTEXT** rule (section 2.1.7.20.1) and **TEXTPROPS** rule (section 2.1.7.20.1) specify default properties of the text in the **chart**. The **DataLabExt** (section [2.4.75](#datalabext)), **StartObject** (section [2.4.267](#startobject)), and **EndObject** (section [2.4.101](#endobject)) records MUST NOT exist in these sequences of records that conform to the **DFTTEXT** rule (section 2.1.7.20.1). + +- The **AxesUsed** record (section [2.4.10](#axesused)) and the sequence of records that conforms to the **AXISPARENT** rule (section 2.1.7.20.1) specify the **axis groups** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)) of the **chart**. + +- The **CrtLayout12A** record (section [2.4.67](#crtlayout12a)) specifies layout information for the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). + +- The sequence of records that conforms to the **DAT** rule (section 2.1.7.20.1) specifies the **data table** for the **chart**. + +- The sequence of records that conforms to the **ATTACHEDLABEL** rule (section 2.1.7.20.1) specifies the chart title. This sequence of records MUST have an **ObjectLink** record (section [2.4.182](#objectlink)) where the **wLinkObj** field has a value of 0x0001. + +- The sequence of records that conforms to the **ATTACHEDLABEL** rule and is preceded by the optional **DataLabExt** record specifies properties of series and data point **data labels**. This sequence of records MUST have an **ObjectLink** record where the **wLinkObj** field has a value of 0x0004. See the **data label** overview for additional information and restrictions on this collection of records. + +- The sequence of records that conforms to the **CRTMLFRT** rule (section 2.1.7.20.1) specifies **future records** (section [2.1.6](#Section_b660b67822684414839ed1ae9a4e4e85)) for the **chart**. + +#### Pivot Chart + +A **Pivot Chart** is a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) that uses a **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) as a [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). The **SXViewLink** (section [2.4.316](#sxviewlink)), **PivotChartBits** (section [2.4.196](#pivotchartbits)), and **SBaseRef** (section [2.4.242](#sbaseref)) records in the **chart sheet** (section [2.2.3.1](#Section_2c90d75bc92645aa8ff29d4483f51831)) specify the **PivotTable**. + +#### Axis Group + +An **axis group** is a set of **axes** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)) that specify a coordinate system, a set of **chart groups** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) that are plotted using these **axes** and the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) that defines where the **axes** are rendered on the **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). + +An **axis group** is specified by a sequence of records that conforms to the **AXISPARENT** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +The following records and rules define the significant parts of an **axis group**: + +- The **AxisParent** record (section [2.4.13](#axisparent)) specifies if the **axis group** is the primary axis group or the secondary axis group on a **chart**. Often the **axes** of the primary **axis group** are displayed to the left and bottom sides of the plot area, while **axes** of the secondary **axis group** are displayed on the right and top sides of the plot area. + +- The **Pos** record (section [2.4.201](#pos)) specifies the position and size of the outer plot area. The outer plot area is the [**bounding rectangle**](#gt_e349a155-0fb9-4ba1-abd4-e363e21abcd1) that includes the **axis** labels, the **axis** titles, and **data table** (section [2.2.3.14](#Section_69938f61d2e94da3af87e154edcb0d98)) of the **chart**. This record MUST be ignored on a secondary **axis group**. + +- The sequences of records that conform to the **IVAXIS** (section 2.1.7.20.1), **DVAXIS** (section 2.1.7.20.1), and **SERIESAXIS** (section 2.1.7.20.1) rules in the collection of records that conform to the **AXES** rule (section 2.1.7.20.1) specify the **axes** of the **axis group**. + +- The sequences of records that conform to the **ATTACHEDLABEL** rule (section 2.1.7.20.1) in the sequence of records that conform to the **AXES** rule specify the **axis** titles of the **axis group**. Each **attached label** (section [2.2.3.15](#Section_9ac44e58af9940f4a99ace470eff0f5a)) MUST contain an **ObjectLink** record (section [2.4.182](#objectlink)) that conforms to the following requirements: + + - The **wLinkObj** field MUST equal to 0x0002, 0x0003, or 0x0007, indicating which **axis** the **axis** title is associated. + + - The **wLinkObj** field MUST specify an **axis** defined in the current **axis group**. + + - The **wLinkObj** field MUST be unique among the other **attached labels** that represent **axis** titles in the same **axis group**. + +- The **PlotArea** record (section [2.4.197](#plotarea)) and the sequence of records that conforms to the **FRAME** rule (section 2.1.7.20.1) in the sequence of records that conform to the **AXES** rule specify the properties of the inner plot area. The inner plot area is the rectangle bounded by the chart **axes**. The **PlotArea** record (section 2.4.197) MUST NOT exist on a secondary **axis group**. + +- The sequences of records that conform to the **CRT** rule (section 2.1.7.20.1) specify the **chart groups** of the **axis group**. + +Because there are many different ways to represent data visually, each representation has specific requirements about the layout of the data and the way it is plotted. This results in restrictions on the combinations of **chart group** types that can be plotted on the same **axis group**, and the combinations of **chart group** types that can be plotted in the same **chart**. + +A **chart** MUST contain one of the following: + +- A single **axis group** that contains a single **chart group** that contains a **Chart3d** record (section [2.4.46](#chart3d)). + +- One or two **axis groups** that each contain a single bubble **chart group**. + +- One or two **axis groups** that each conform to one of the following restrictions on **chart group** type combinations: + + - Zero or one of each of the following **chart group** types: area, column, line, and scatter. + + - Zero or one of each of the following **chart group** types: bar of pie, doughnut, pie, and pie of pie. + + - A single bar **chart group**. + + - A single filled radar **chart group**. + + - A single radar **chart group**. + +In addition to the restrictions on the combinations of **chart group** types that can be plotted on the same **axis group** or **chart**, there are additional restrictions on the **axes** of the **axis group** based on the **chart groups** of the axis group. + +The following restrictions apply to the **axes** of an **axis group**: + +- The **axis group** MUST NOT contain any **axes** if the **axis group** contains a bar of pie, doughnut, pie, or pie of pie **chart group**. + +- The **axis group** MUST contain a [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) or date **axis** if the axis group contains an area, bar, column, filled radar, line, radar, or surface **chart group**. + +- The **axis group** MUST contain an area, bar, column, filled radar, line, radar, or surface **chart group** if the axis group contains a category or date **axis**. + +- The **axis group** MUST contain two value **axes** if and only if all **chart groups** are of type bubble or scatter. + +- The **axis group** MUST contain a series **axis** if and only if the **chart group** attached to the **axis group** is one of the following: + + - An area **chart group** with the **fStacked** field of the **Area** record (section [2.4.2](#area)) equal to 0. + + - A column **chart group** with the **fStacked** field of the **Bar** record (section [2.4.15](#bar)) equal to 0 and the **fCluster** field of the **Chart3d** record equal to 0. + + - A line **chart group** with field **fStacked** of the **Line** record (section [2.4.155](#line)) equal to 0. + + - A surface **chart group**. + +  + +- The **chart group** on the **axis group** MUST contain a **Chart3d** record if the **axis group** contains a series **axis**. + +#### Axis + +An **axis** is a line that borders the **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) and provides a frame of reference for measurement. In addition to the **axis** line and its properties, the **axis** also specifies all parts of the **chart** that are associated with the **axis** line, such as the **axis** labels, [**major gridlines**](#gt_2803347c-6396-46a5-9ede-6bef1149b013), [**minor gridlines**](#gt_49980976-6314-43ad-ad51-8d3e55ef4b59), and the [**walls**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c) and [**floor**](#gt_dc38c098-e0d3-4701-9656-5f2cf4d80f29) of the **chart**. + +An **axis** is specified by a sequence of records that conforms to either the **IVAXIS** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)), **DVAXIS** (section 2.1.7.20.1), or **SERIESAXIS** (section 2.1.7.20.1) rules specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +An **axis** has a type as defined by the following table: + +| Type | Specified By | Description | +|----|----|----| +| Category | A sequence of records that conform to the **IVAXIS** that contains an **AxcExt** record (section [2.4.9](#axcext)) with field **fDateAxis** equal to 0. | A [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) **axis** displays a set of category labels that are evenly distributed along the **axis** in a given order. A category axis displays arbitrary text values such as "Qtr1", "Qtr2", and "Qtr3", and cannot display scaled numerical values. | +| Date | A sequence of records that conform to the **IVAXIS** rule that contains an **AxcExt** record with field **fDateAxis** equal to 1. | A date **axis** displays scaled date or time values and can display **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) located at uneven intervals. | +| Series | A sequence of records that conform to the **SERIESAXIS** rule. | A series **axis** displays a set of **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) names that are evenly distributed along the axis. When this **axis** is used, the **data points** of each **series** are plotted in a 3-dimensional space. The **data points** of a single **series** are plotted on a plane identified by the corresponding **series** name on this **axis**. | +| Value | A sequence of records that conform to the **DVAXIS** rule. | A value **axis** displays scaled numeric values. The bubble and scatter **chart groups** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)), which can contain two value axes, distinguish the value **axes** by specifying the **axis** orientation, either horizontal or vertical. | + +The following records and rules define the significant parts of an axis: + +- The **CatSerRange (**section [2.4.39](#catserrange)**)** and **ValueRange** (section [2.4.341](#valuerange)) records specify the scaling properties of the **axis**, the crossing location of the other **axis** in the **axis group** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)), and the direction of the **axis**. + +- The **AxcExt** record specifies if an **axis** is of type category or date and specifies properties of a date **axis**. + +- The **CatLab** record (section [2.4.38](#catlab)) specifies additional properties of the **axis** labels. + +- The **IFmtRecord** record (section [2.4.143](#ifmtrecord)) in the sequence of records that conform to the **AXS** rule (section 2.1.7.20.1) specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) of the **axis** labels. + +- The **Tick** record (section [2.4.327](#tick)) in the sequence of records that conform to the **AXS** rule specifies properties of the **axis** labels, and specifies the [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) and [**minor tick marks**](#gt_c2eb605a-6c5a-427e-8608-f16940de82a6) of the **axis**. + +- The **FontX** record (section [2.4.123](#fontx)) and the sequence of records that conforms to the **TEXTPROPS** rule (section 2.1.7.20.1), in the collection of records that conform to the **AXS** rule, specify the font properties of the **axis** labels. + +- The **AxisLine** (section [2.4.12](#axisline)) and **LineFormat** (section [2.4.156](#lineformat)) record pairs and the sequences of records that conform to the **SHAPEPROPS** rule (section 2.1.7.20.1), in the sequence of records that conform to the **AXS** rule, specify the **axis** line, major gridlines and minor gridlines of the **axis**, and the [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) lines of the walls and floor of the **chart**. The omission of the **AxisLine** and **LineFormat** record pair specifying the axis line results in the **axis** line having default line format properties. The omission of other **AxisLine** and **LineFormat** record pairs results in the corresponding **chart** element being omitted from the **chart**. + +- The **AreaFormat** record (section [2.4.3](#areaformat)) and the collection of records that conform to the **GELFRAME** rule (section 2.1.7.20.1) in the sequence of records that conform to the **AXS** rule specifies the fill format for the walls and floor of the **chart**. If the **wType** field of the **Axis** record (section [2.4.11](#axis-1)) in the **axis** equals 0x0000, these records apply to the walls of the **chart**. If the **wType** field of the **Axis** record in the **axis** equals 0x0001, these records apply to the floor of the **chart**. If the **wType** field of the **Axis** record in the axis equals 0x0002, these records MUST NOT exist. If the **chart sheet substream** does not contain a **Chart3d** record (section [2.4.46](#chart3d)), these records MUST NOT exist. + +- The sequence of records that conforms to the **AXM** rule (section 2.1.7.20.1) specifies the [**display units**](#gt_7d807b62-cff1-4e03-a73f-840844345b83) and the display units label of a value **axis**. + +#### Chart Group + +A **chart group** is a set of one or more **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) that visually represent data in a similar manner and are plotted using the same coordinate system. A **chart group** also includes all parts of the **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) that are associated with the set of **series** and the chart group can specify default properties for the **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) and **data labels** (section [2.2.3.11](#Section_cac7f43a3af142f58ff2814c2870427f)) associated with the **series**. + +Basic **charts** have a single **chart group** because they contain one or more **series** of a single type and all **data points** are plotted using the same coordinates. Complex **charts**, such as combination **charts** that contain multiple **series** of different types or multiple **series** of similar type that are plotted using different sets of **axes** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)), contain multiple **chart groups**. + +A **chart group** specifies a collection of **series** of a common type that share an **axis group** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)) and specifies the **chart** elements that are common to the collection of **series**. + +A **chart group** is specified by a sequence of records that conforms to the **CRT** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +A **chart group** has a type as defined by the following table: + +| Type | Specified By | Description | +|----|----|----| +| Area | A **chart group** that contains an **Area** record (section [2.4.2](#area)). | A **chart group** type in which the **data points** of a **series** are plotted in a line and the region between the line and the horizontal **axis** is filled. | +| Bar | A **chart group** that contains a **Bar** record (section [2.4.15](#bar)) with field **fTranspose** equal to 1. | A **chart group** type in which the **data points** in a **series** are represented as horizontal bars. | +| Bar of pie | A **chart group** that contains a **BopPop** record (section [2.4.25](#boppop)) with field **pst** equal to 0x02. | A **chart group** type that plots **data points** as segments in a circle or bar, where the bar displays the details of the data called out from a single segment of the circle. | +| Bubble | A **chart group** that contains a **Scatter** record (section [2.4.243](#scatter)) with field **fBubbles** equal to 1. | A **chart group** type that is a variation on a scatter chart group type in which the **data points** are represented as bubbles. A bubble chart group type compares three variables. The third variable determines the size of the **data point**. | +| Column | A **chart group** that contains a Bar record (section 2.4.15) with field **fTranspose** equal to 0. | A **chart group** type in which the **data points** in a **series** are represented as vertical bars. | +| Doughnut | A **chart group** that contains a **Pie** record (section [2.4.194](#pie)) with field **pcDonut** not equal to 0x0000. | A **chart group** type in which multiple **series** are represented as concentric rings and the **data points** are represented as segments of the ring. | +| Filled radar | A **chart group** that contains a **RadarArea** record (section [2.4.213](#radararea)). | A **chart group** type that is a variation on a radar group type in which the **data points** in a **series** are connected by a line and the area enclosed by the line is filled. | +| Line | A **chart group** that contains a **Line** record (section [2.4.155](#line)). | A **chart group** type in which **data points** in a **series** are connected by a line. | +| Pie | A **chart group** that contains a **Pie** record (section 2.4.194) with field **pcDonut** equal to 0x0000. | A **chart group** type that plots **data points** as segments (or slices) of a circle. | +| Pie of pie | A **chart group** that contains a **BopPop** record (section 2.4.25) with field **pst** equal to 0x01. | A **chart group** type that plots **data points** as segments (or slices) of two circles, where the secondary circle displays the details of the data called out from a single segment of the primary circle. | +| Radar | A **chart group** that contains a **RadarArea** record (section 2.4.213). | A **chart group** type in which each **data point** in a **series** is plotted along a separate **axis** that starts at the center of the **chart** and extends outward. | +| Scatter | A **chart group** that contains a **Scatter** record (section 2.4.243) with field **fBubbles** equal to 0. | A **chart group** type that displays quantitative values on both horizontal and vertical **axes** to represent two variables as a single **data point**. | +| Surface | A **chart group** that contains a **Surf** record (section [2.4.272](#surf)). | A **chart group** type that shows a three dimensional surface that connects a set of **data points**. | + +The following records and rules define the significant parts of a chart group: + +- The **SeriesList** record (section [2.4.253](#serieslist)) specifies the **series** of the **chart**. This record MUST NOT exist in the first **chart group** in the **chart sheet substream**. This record MUST exist when not in the first **chart group** in the **chart sheet substream**. + +- The **Chart3d** record (section [2.4.46](#chart3d)) specifies that the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c), **axis group** (section 2.2.3.5), and **chart group** are rendered in a 3-D scene, rather than a 2-D scene, and specifies properties of the 3-D scene. If this record exists in the **chart sheet substream**, the **chart sheet substream** MUST have exactly one **chart group**. This record MUST NOT exist in a bar of pie, bubble, doughnut, filled radar, pie of pie, radar, or scatter **chart group**. + +- The sequence of records that conforms to the **LD** rule (section 2.1.7.20.1) specifies the **legend** (section [2.2.3.8](#Section_1832229b7d1945f488d455e9c07466f0)) on the **chart**. The sequence of records that conforms to the **LD** rule (section 2.1.7.20.1) MUST NOT exist in a **chart group** that is not the first **chart group** in the **chart sheet substream**. + +- The sequences of records that conform to the **DROPBAR** rule (section 2.1.7.20.1) specify the [**up-down bars**](#gt_54f291c2-81aa-41b6-8831-88d180a09ea0) on the **chart group**. + +- The **CrtLine** (section [2.4.68](#crtline)) **LineFormat** (section [2.4.156](#lineformat)) record pairs and the sequences of records that conform to the **SHAPEPROPS** rule (section 2.1.7.20.1) specify the [**drop lines**](#gt_e8c745bf-646c-4acd-8b5e-5314fa4965fa), [**high-low lines**](#gt_56aec928-ddcc-4415-9d08-5d1dd3982bbc), [**series lines**](#gt_bda50b03-68fa-49f9-bd9e-d0dc289ac88a), and [**leader lines**](#gt_8b7c448e-82e3-4d22-a8ba-52e0a10b14fa) for the **chart**. + +- The sequences of records that conform to the **DFTTEXT** rule (section 2.1.7.20.1), the **DataLabExtContents** record (section [2.4.76](#datalabextcontents)), and the sequence of records that conforms to the **SS** rule (section 2.1.7.20.1) specify the **data label** and **data point** formatting for the **chart group**. Refer to the **data label** overview for details on the **chart group** **data label**. + +#### Legend + +A **legend** identifies different groupings of information about the **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). A **legend** consists of a set of [**legend entries**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e). Each legend entry, which consists of a [**legend key**](#gt_6981bc96-6d51-425c-9550-63c5b8b08e54) and a text label, identifies either the **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) in the **chart**, the **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) and [**trendlines**](#gt_d5df9e9f-4c24-41e9-a015-44bd67d1a67c) in the **chart**, or the bands on a surface **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)). + +A **legend** is specified by a sequence of records that conforms to an **LD** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) in a **chart group** as specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +A **legend** on a **chart** can contain three types of content: + +- A **legend** can contain legend entries for each of the **series** and trendlines in the **chart**: + + - Each legend entry represents a single **series** or trendline. + + - The legend keys contain the same formatting as the corresponding **series** or trendline. + + - The **legend** text labels contain the name of the corresponding **series** or trendline. + + - This type of **legend** is used when the **chart group** type is not surface and one of the following conditions is satisfied: + + - The **chart** has more than one included **series**. + + - The **chart** has a single included **series**, no **data point** formatting exceptions on the included **series**, and either contains a trendline or contains a **ChartFormat** record (section [2.4.48](#chartformat)) associated with the included **series** that has the **fVaried** field equal to 0 or ignored. + +- A **legend** can contain legend entries for each **data point** in the **chart**: + + - Each legend entry represents a single **data point** on the **chart**. + + - The legend keys contain the same formatting as the corresponding **data point**. + + - The **legend** text labels contain the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) name or horizontal value of the corresponding **data point**. + + - This type of **legend** is used when the **chart group** type is not surface and the conditions for a **legend** that contains legend entries for each of the **series** and trendlines in the **chart** are not satisfied. + +- A **legend** can contain legend entries for each band on a surface **chart group** (which is formatted into different bands based on the value of the surface at any given **data point** in space): + + - Each legend entry represents a single band that represents a range of values on a surface **chart group**. + + - The legend keys contain the same formatting as the corresponding band. + + - The **legend** text labels contain the value range of the corresponding band. + + - This type of **legend** is used when the chart contains a surface **chart group**. + +The following records and rules define the significant parts of a **legend**: + +- The **Legend** record (section [2.4.152](#legend-1)) specifies the layout of the legend and specifies if the **legend** is automatically positioned. + +- The **Pos** record (section [2.4.201](#pos)), **CrtLayout12** record (section [2.4.66](#crtlayout12)), and the sequence of records that conforms to the **CRTMLFRT** rule (section 2.1.7.20.1), specify the position of the **legend**. + +- The sequences of records that conform to the **ATTACHEDLABEL** (section 2.1.7.20.1) and **TEXTPROPS** (section 2.1.7.20.1) rules specify the default text formatting for the legend entries. The **Pos** record of the **attached label** (section [2.2.3.15](#Section_9ac44e58af9940f4a99ace470eff0f5a)) MUST be ignored. The **ObjectLink** record (section [2.4.182](#objectlink)) of the attached label MUST NOT exist. A **series** can specify formatting exceptions for individual legend entries. + +  + +- The sequence of records that conforms to the **FRAME** rule (section 2.1.7.20.1) specifies the fill and [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad) properties of the **legend**. + +#### Series + +A **series** is of a set of related **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) that are plotted in a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). In addition to specifying the **data points** of the **series** and the formatting properties of the **data points**, a **series** can also specify a series name and properties of the **data label** (section [2.2.3.11](#Section_cac7f43a3af142f58ff2814c2870427f)) and [**legend entries**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e) that are associated with the **series**. + +A **series** is defined by a sequence of records that conforms to the **SERIESFORMAT** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that contains a **SerToCrt** record (section [2.4.256](#sertocrt)). + +A **series** can either be of type included or excluded. Included **series** are **series** that are shown in the **chart**. Excluded **series** are not shown in the **chart**, but exist as **series** in the file. A **series** is an excluded **series** if both of the following conditions are satisfied: + +- The **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) type of the **series** is bar of pie, pie, or pie of pie. + +- The **series** is not the first **series** in the **chart sheet substream** to be on the **chart group** and contain in the second sequence of records that conform to the **AI** rule (section 2.1.7.20.1) a **BRAI** record (section [2.4.29](#brai)) that contains an **ifmt** field that specifies a **formula** (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that equals to a row or column that is not excluded from the **chart sheet**. + +This occurs when the **chart group** is of type bar of pie, pie, or pie of pie, and the **chart sheet** contains multiple **series**, because these **chart group** types will only display the first **series** of data on the **chart**. + +All other **series** are included **series**. + +The following records and rules define the significant parts of a **series**: + +The **Series** record (section [2.4.252](#series-1)) specifies the type and size of the data in the **series**. + +- The four sequences of records that conform to the **AI** rule specify **formulas**. The meaning of the **formulas** are specified as follows: + + 1. In the first sequence, the value of the **formula** specifies the name of the **series**. The **SeriesText** record (section [2.4.254](#seriestext)) specifies a cache of the name of the **series**. + + 2. In the second sequence, the value of the **formula** specifies: + + - A set of coordinates along the vertical value **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)) if the series is in a bubble or scatter **chart group**. + + - A set of coordinates along the value **axis** if the series is in any other **chart group** type. + + 3. In the third sequence, the value of the **formula** specifies: + + - A set of coordinates along a horizontal value **axis** if the **series** is in a bubble or scatter **chart group**. + + - A set of [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) **axis** labels that are distributed evenly along the category **axis** based on their order in the set or a set of dates along a date **axis** is in any other **chart group** type. + + 4. In the fourth sequence of records, the value of the **formula** specifies a set of scalar values used in a bubble **chart group** to define the size of the bubbles. + +- The sequence of records that conform to the **SS** rule (section 2.1.7.20.1) specify the **data point** and **data label** properties for a **series** or individual **data points** of the **series**. If formatting is not specified for an individual **data point**, the **data point** inherits the formatting of the series. If formatting is not specified for the **series**, the **series** inherits the formatting of the **chart group** that contains the **series**. The **yi** field of the **DataFormat** record (section [2.4.74](#dataformat)) MUST specify the zero-based index of the **Series** record associated with this **series** in the collection of all **Series** records in the current **chart sheet substream** that contains the **series**. Refer to the **data label** overview for an explanation of the **data label** and the conditions on this collection of records. + +- The **SerToCrt** record (section 2.4.256) specifies the **chart group** that contains the current **series**. + +- The **LegendException** record (section [2.4.153](#legendexception)) specifies a legend entry in the **legend** (section [2.2.3.8](#Section_1832229b7d1945f488d455e9c07466f0)) that corresponds to the **series**. If the **LegendException** record (section 2.4.153) specifies that the legend entry has non-default formatting, then the **attached label** (section [2.2.3.15](#Section_9ac44e58af9940f4a99ace470eff0f5a)) and the sequence of records that conforms to the **TEXTPROPS** rule (section 2.1.7.20.1) that follow the **LegendException** (section 2.4.153) and **Begin** (section [2.4.17](#begin)) records specify the custom formatting of the legend entry. If the **fLabel** field of **LegendException** equals 0, the **attached label** MUST NOT exist. + +#### Data Point + +A **data point** is a value plotted in a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) and visually displayed as shapes, such as bars, columns and markers, as specified by the **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) type of the **chart**. + +A **data point** consists of a set of three values located on the same index of the second to fourth sequences of records that conform to the **AI** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) contained in the **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) of the **data point**. For example, the set of three values for a **data point** in a bubble **chart group** consists of a coordinate of the **data point** along the vertical value **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)), the coordinate of the **data point** along the horizontal value **axis**, and the scalar value that defines the [**bubble size**](#gt_3a0cf938-5b61-4460-bdbb-3540d84d4180) of the **data point**. + +#### Data Label + +A **data label** is a label on a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) that is associated with a **data point** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)), or associated with a **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) on an area or filled radar **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)). A **data label** contains information about the associated **data point**, such as the description of the **data point**, a [**legend key**](#gt_6981bc96-6d51-425c-9550-63c5b8b08e54), or custom text. + +**Inheritance** + +For any given **data point**, there is an order of inheritance that determines the contents of a **data label** associated with the **data point**: + +- **Data labels** can be specified for a **chart group**, specifying the default setting for the **data labels** associated with the **data points** on the **chart group**. + +- **Data labels** can be specified for a **series**, specifying the default setting for the **data labels** associated with the **data points** of the **series**. This type of **data label** overrides the **data label** properties specified on the **chart group** for the **data labels** associated with the **data points** in a given **series**. + +- **Data labels** can be specified for a **data point**, specifying the settings for a **data label** associated with a particular **data point**. This type of **data label** overrides the **data label** properties specified on the **chart group** and **series** for the **data labels** associated with a given **data point**. + +**Records** + +The set of records that specifies a **data label**, and the requirements that exist on these records, differ if the **data label** is specified for a **chart group**, **series**, or **data point**. The set of records that represent a **data label** are as follows: + +- For a **chart group**, properties of a data label are specified by the following collections of records that are specified in the **chart group**: + + 1. The sequence of records that conforms to the **DFTTEXT** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)). + + 2. The **DataLabExtContents** record (section [2.4.76](#datalabextcontents)) that is not contained in the sequence of records that conforms to the **LD** rule (section 2.1.7.20.1) or the sequence of records that conforms to the **DFTTEXT** rule. + + 3. The **AttachedLabel** record (section [2.4.5](#attachedlabel)) that is contained in the sequence of records that conforms to the **SS** rule (section 2.1.7.20.1). + +- For a **series** or **data point**, properties of a data label are specified by the following collections of records that are specified in the **chart**: + + 1. The **attached label** (section [2.2.3.15](#Section_9ac44e58af9940f4a99ace470eff0f5a)) that corresponds to the **series** or **data point**. The **attached label** that corresponds to a **series** or **data point** appears in the **chart sheet substream** (section 2.1.7.20.1) after the **axis group** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)) and is specified by the following properties of the **attached label**: + + 1. The **wLinkObj** field of the **ObjectLink** record (section [2.4.182](#objectlink)) equals 0x0004. + + 2. The **wLinkVar1** field of the **ObjectLink** record equals the index to the corresponding **series**. + + 3. The **wLinkVar2** field of the **ObjectLink** record equals the index to the corresponding **data point** or equals 0xFFFF for a corresponding **series**. + + 2. The **AttachedLabel** record (section 2.4.5) that corresponds to the **series** or **data point**. The **AttachedLabel** record that corresponds to a **series** or **data point** appears in the sequence of records that conforms to the **SS** rule that has the following properties: + + 1. The **yi** field of the **DataFormat** record (section [2.4.74](#dataformat)) equals the index to the corresponding **series**. + + 2. The **xi** field of the **DataFormat** record equals the index to the corresponding **data point** or equals 0xFFFF for a corresponding **series**. + +**Overrides** + +Some properties of the records that specify the contents of a **data label** can overlap and conflict. For the information that overlaps between these records, there is a set of rules that specifies the relationships between these records and specifies the fields that need to be ignored in conflict situations. + +In general, properties of the **DataLabExtContents** record (section 2.4.76) of the **data label** override properties of the **Text** record (section [2.4.324](#text)) of the of the **data label**, which overrides the properties of the **AttachedLabel** record of the **data label**. Details of the relationships between individual fields are specified in the records. + +The following section provides an explanation of how to interpret the **data label** and when the different records that specify the **data label** are relevant to the **data label**. + +On a **data label** associated with a **chart group**: + +- When the **chart group** has a data label, the following algorithm determines the **data label** contents. Once the set of records that represents the **data label** has been established, the data label information that overlaps across records is respected on the **DataLabExtContents** record and ignored on the **Text** and **AttachedLabel** records of the **data label**. In this algorithm, [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) rules are used to specify the sequence of records that conform to the rule. In this algorithm, "DFTTEXT with id" specifies the sequence of records that conforms to the **DFTTEXT** rule that contains a **DefaultText** record (section [2.4.88](#defaulttext)) with and **id** field equal to the value specified. + +217. //Define variables + + X equals a DataLabExtContents record + + Y equals a DataLabExtContents record + + SS equals an to AttachedLabel record + + SWAP equals a boolean + + //Initialize SWAP + + SET SWAP equal to FALSE + + //Initialize SS + + SET SS equal to AttachedLabel record in the sequence of records that conforms to + + the SS rule + + //Initialize X + + IF DFTTEXT with id field equal to 0 exists + + IF DFTTEXT with id field equals to 0 has a DataLabExtContents record + + SET X equal to DataLabExtContents record in DFTTEXT with id field equal to + + 0 + + ELSE + + IF chart group type equals area or filled radar + + SET field fSerName of X equal to field fShowLabel of Text record in + + DFTTEXT with id field equal to 0 + + SET field fCatName of X equal to 0 + + ELSE + + SET field fCatName of X equal to field fShowLabel of Text record in + + DFTTEXT with id field equal to 0 + + SET field fSerName of X equal to 0 + + END IF + + SET field fValue of X equal to field fShowValue of Text record in DFTTEXT + + with id field equal to 0 + + SET field fPercent of X equal to field (fShowPercent OR fShowLabelAndPerc) + + of Text record in DFTTEXT with id field equal to 0 + + SET field fBubSizes of X equal to field fShowBubbleSizes of Text record in + + DFTTEXT with id field equal to 0 + + SET field RgchSet of X equal to NULL + + END IF + + ELSE + + SET field fCatName of X equal 1 + + SET fields fSerName, fValue, fPercent, fBubSizes of X equal to 0 + + SET field RgchSet of X equal to NULL + + END IF + + //Initialize Y + + IF DFTTEXT with id field equal to 1 exists + + IF DFTTEXT with id field equals to 1 has a DataLabExtContents record + + SET Y equal to DataLabExtContents record in DFTTEXT with id field equal to + + 1 + + ELSE + + IF chart group type equals area or filled radar + + SET field fSerName of Y equal to field (fShowLabel OR + + fShowLabelAndPerc)of Text record in DFTTEXT with id field equal to + + 1 + + SET field fCatName of Y equal to 0 + + ELSE + + SET field fCatName of Y equal to field (fShowLabel OR + + fShowLabelAndPerc) of Text record in DFTTEXT with id field equal to + + 1 + + SET field fSerName of Y equal to 0 + + END IF + + SET field fValue of Y equal to field fShowValue of Text record in DFTTEXT + + with id field equal to 1 + + SET field fPercent of Y equal to field (fShowPercent OR fShowLabelAndPerc) + + of Text record in DFTTEXT with id field equal to 1 + + SET field fBubSizes of Y equal to field fShowBubbleSizes of Text record in + + DFTTEXT with id field equal to 1 + + SET field RgchSet of X equal to NULL + + END IF + + ELSE + + SET field fValue of Y equal to 1 + + SET fields fCatName, fSerName, fPercent, fBubSizes of Y equal to 0 + + SET field RgchSet of X equal to NULL + + END IF + + //Modify X, Y, and SS + + IF (field fCatName of X equals 1) AND (fields fSerName, fValue, fPercent, AND + + fBubSizes of X equal 0) + + IF (field fShowValue of SS equals 1) AND (fields fShowPercent, + + fShowLabelAndPerc, fShowLabel, fShowBubbleSizes, AND fShowSeriesName of + + SS equal 0) + + IF (field fValue of Y equals 1) AND (fields fSerName, fCatName, + + fPercent, OR fBubSizes of Y equal 1) + + SET SWAP equals to TRUE + + SET field fValue of X equal to 1 + + SET fields fSerName, fCatName, fPercent, AND fBubSizes of X equal + + to 0 + + SET field fShowValue of SS equal to field fValue of Y + + SET field fShowPercent of SS equal to field fSPercent of Y + + SET field fShowLabel of SS equal to field fCatName of Y + + SET field fShowBubbleSizes of SS equal to field fBubSizes of Y + + SET field fShowSeriesName of SS equal to field fSerName of Y + + END IF + + ELSE + + IF ((field fShowPercent of SS equals 1) AND (field fShowBubbleSizes of + + SS equals 0)) OR ((field fShowPercent of SS equals 0) AND (field + + fShowBubbleSizes of SS equals 1)) AND (fields fShowLabelAndPerc, + + fShowLabel, fShowValue, AND fShowSeriesName of SS equal 0) + + SET SWAP equals to TRUE + + SET field fValue of X equal to 1 + + SET fields fSerName, fCatName, fPercent, AND fBubSizes of X equal + + to 0 + + SET field fShowValue of SS equal to field fValue of Y + + SET field fShowPercent of SS equal to field fSPercent of Y + + SET field fShowLabel of SS equal to field fCatName of Y + + SET field fShowBubbleSizes of SS equal to field fBubSizes of Y + + SET field fShowSeriesName of SS equal to field fSerName of Y + + ELSE + + IF (field fShowLabel of SS equals 1) AND (fields fShowPercent, + + fShowLabelAndPerc, fShowValue, fShowBubbleSizes, AND + + fShowSeriesName of SS equal 0) + + IF chart group type equals area or filled radar + + SET field fSerName of X equal to 1 + + SET fields fCatName, fValue, fPercent, AND fBubSizes equal + + to 0 + + SET field fShowValue of SS to 1 + + SET fields fShowPercent, fShowLabelAndPerc, fShowLabel, + + fShowBubbleSize, and fShowSeriesName of SS to 0 + + END IF + + SET field fValue of Y equals to 1 + + SET fields fSerName, fCatName, fPercent, AND fBubSizes of Y + + equal to 0 + + ELSE + + IF fields fShowLabel, fShowPercent, fShowLabelAndPerc, + + fShowValue, fShowBubbleSizes, AND fShowSeriesName of SS + + equal 0 + + IF chart group type equals area or filled radar + + SET fields fShowLabel of SS to 1 + + SET fields fShowPercent, fShowLabelAndPerc, fShowValue, + + fShowBubbleSize, and fShowSeriesName of SS to 0 + + END IF + + SET field fValue of Y equals to 1 + + SET fields fSerName, fCatName, fPercent, AND fBubSizes of Y + + equal to 0 + + END IF + + END IF + + END IF + + END IF + + ELSE + + IF (field fValue of Y equals 1) AND (fields fSerName, fCatName, fPercent, + + AND fBubSizes of Y equal 0) + + IF fields fShowLabel, fShowPercent, fShowLabelAndPerc, fShowValue, + + fShowBubbleSizes, AND fShowSeriesName of SS equal 0 + + IF (chart group type equals area or filled radar) AND (field + + fSerName of X equals 1) AND (fields fCatName, fValue, fPercent, + + AND fBubSizes of X equal 0) + + SET field fShowSeriesName of SS to 1 + + SET fields fShowPercent, fShowLabelAndPerc, fShowValue, + + fShowBubbleSize, and fShowLabel of SS to 0 + + ELSE + + SET field fCatName of X equals to 1 + + SET fields fSerName, fValue, fPercent, AND fBubSizes of X equal + + to 0 + + END IF + + ELSE + + IF (field fShowValue of SS equals 1) AND (fields fShowLabel, + + fShowPercent, fShowLabelAndPerc, fShowBubbleSizes, AND + + fShowSeriesName of SS equal 0) + + SET field fCatName of X equals to 1 + + SET fields fSerName, fValue, fPercent, AND fBubSizes of X equal + + to 0 + + ELSE + + SET field fShowValue of SS equal to field fValue of X + + SET field fShowPercent of SS equal to field fSPercent of X + + SET field fShowLabel of SS equal to field fCatName of X + + SET field fShowBubbleSizes of SS equal to field fBubSizes of X + + SET field fShowSeriesName of SS equal to field fSerName of X + + END IF + + END IF + + END IF + + END IF + + //Determine if X or Y is used + + IF (field fShowValue of SS equals 1) AND (fields fShowLabel, fShowPercent, + + fShowLabelAndPerc, fShowBubbleSizes, AND fShowSeriesName of SS equal 0) + + IF (SWAP equals FALSE) + + IF DFTTEXT with id field equal to 1 exists + + SET the data label equal to DFTTEXT with id field equal to 1 + + ELSE + + SET the data label equal to the default formatting properties + + END IF + + SET the DataLabExtContents record of the data label equal to Y + + ELSE + + IF DFTTEXT with id field equal to 0 exists + + SET the data label equal to DFTTEXT with id field equal to 0 + + ELSE + + SET the data label equal to the default formatting properties + + END IF + + SET the DataLabExtContents record of the data label equal to X + + END IF + + ELSE + + IF (SWAP equals FALSE) + + IF DFTTEXT with id field equal to 0 exists + + SET the data label equal to DFTTEXT with id field equal to 0 + + ELSE + + SET the data label equal to the default formatting properties + + END IF + + SET the DataLabExtContents record of the data label equal to X + + ELSE + + IF DFTTEXT with id field equal to 1 exists + + SET the data label equal to DFTTEXT with id field equal to 1 + + ELSE + + SET the data label equal to the default formatting properties + + END IF + + SET the DataLabExtContents record of the data label equal to Y + + END IF + + END IF + +On a **data label** associated with a **series** or **data point**: + +- The **attached label** specifies an exception on the **data label** and indicates that the current **data label** differs from the **data label** inherited from the **chart group** for a **series**, or from the **chart group** and **series** for a **data point**. The **attached label** of the **data label** contains a **Text** record and can contain a **DataLabExtContents** record. + +- On a **data label** associated with a **data point**, when the **attached label** exists and contains a **BRAI** record (section [2.4.29](#brai)) with field **formula** not equal to 0x0000, the **formula** field specifies the contents of the **data label**. + +- On a **data label** associated with a **data point**, when the **attached label** exists and contains a **SeriesText** record (section [2.4.254](#seriestext)) and a **BRAI** record with field **formula** equal to 0x0000, the **SeriesText** record specifies the contents of the **data label**. + +- When the **attached label** exists and contains a **DataLabExtContents** record, the **data label** information specified by the **DataLabExtContents** record that overlaps across records is respected, and the information contained in the **Text** and **AttachedLabel** records of the **data label** that overlaps is ignored. + +- When the **attached label** exists and does not contain a **DataLabExtContents** record, the **data label** specified by the **Text** record that overlaps across records is respected, and the information contained in the **AttachedLabel** record of the **data label** that overlaps is ignored. + +- When the **data label** does not specify an **attached label**, the **AttachedLabel** record of the **data label** specifies the content properties of the **data label**. + +**Restrictions** + +The following requirements and restrictions exist on different parts of the collections of records that represent the **data label**. + +If the **chart group** contains a **data label**: + +- The **chart group** SHOULD[\<13\>](#Appendix_A_13) contain two sequences of records that conform to the **DFTTEXT** rule that have the same records with the same field values. + +- If the **chart group** contains a **DataLabExtContents** record, the **DataLabExtContents** record in the sequences of records that conform to the **DFTTEXT** rule on the chart group and the **DataLabExtContents** record that is not specified in the sequences of records that conform to the **DFTTEXT** rule on the chart group SHOULD[\<14\>](#Appendix_A_14) contain the same field values. + +- If the **chart group** contains a sequence of records that conforms to the **DFTTEXT** rule the following restrictions apply: + + - The **fShowValue** field of the **AttachedLabel** record SHOULD[\<15\>](#Appendix_A_15) equal the **fShowValue** field of the **Text** record in the sequence of records that conforms to the **DFTTEXT** rule. + + - The **fShowPercent** field of the **AttachedLabel** record SHOULD[\<16\>](#Appendix_A_16) equal the **fShowPercent** field of the **Text** record in the sequence of records that conforms to the **DFTTEXT** rule. + + - The **fShowLabelAndPerc** field of the **AttachedLabel** record SHOULD[\<17\>](#Appendix_A_17) equal the **fShowLabelAndPerc** field of the **Text** record in the sequence of records that conforms to the **DFTTEXT** rule. + +#### Trendline + +A **trendline** is a straight or curved line that graphically represents the general trend of the **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) of a **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)). In addition to specifying the data and formatting properties of the line, the **trendline** name and the **trendline** label can also be specified in the **trendline**. + +A trendline is defined by a sequence of records that conforms to the **SERIESFORMAT** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that contains a **SerAuxTrend** record (section [2.4.250](#serauxtrend)). + +The following records and rules define the significant parts of a **trendline**: + +- The **SeriesText** record (section [2.4.254](#seriestext)) in the first sequence of records that conforms to the **AI rule** (section 2.1.7.20.1) specifies a custom **trendline** name to display in the **legend** (section [2.2.3.8](#Section_1832229b7d1945f488d455e9c07466f0)). + +- The sequence of records that conforms to the **SS** rule (section 2.1.7.20.1) specifies the formatting properties of the **trendline**. The **yi** field of the **DataFormat** record (section [2.4.74](#dataformat)) MUST specify the zero-based index of the **Series** record (section [2.4.252](#series-1)) associated with this **trendline** in the collection of all **Series** records in the current **chart sheet substream**. Each **trendline** MUST contain zero or one sequences of records that conform to the **SS** rule. + +- The **SerParent** record (section [2.4.255](#serparent)) specifies the **series** associated with the **trendline**. + +- The **SerAuxTrend** record specifies properties of the **trendline**, such as the **trendline** type and the number of periods to [**forecast**](#gt_0a5478cf-8836-4a9a-a663-7684366646a3) forward and backward, and specifies properties of the content of the **trendline** label. + +- The **LegendException** record (section [2.4.153](#legendexception)) specifies the formatting of the [**legend entry**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e) in the **legend** (section 2.2.3.8) that corresponds to the **trendline**. This record is specified if the legend entry has been deleted or does not use the default formatting of the **legend**. When the legend entry has non-default formatting, the **attached label** (section [2.2.3.15](#Section_9ac44e58af9940f4a99ace470eff0f5a)) that follows the **LegendException** record and **Begin** records (section [2.4.17](#begin)) specifies the custom formatting of the legend entry. + +The following restrictions apply to a **trendline**: + +- All fields except the **cValx** and **cValy** fields in the **Series** record (section 2.4.252) MUST be ignored. The **cValy** and **cValx** fields in the **Series** records MUST be greater than 0. + +- The **BRAI** records (section [2.4.29](#brai)) in the sequence of records that conforms to the **AI** rule (section 2.1.7.20.1) MUST be ignored and the **ifmt** field of the **BRAI** records MUST equal 0x0000. + +#### Error Bar + +An **error bar** is a set of lines displayed on a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) that indicates a range of uncertainty in the measurement of each **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) in a **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)). + +An **error bar** is specified by a sequence of records that conforms to the **SERIESFORMAT** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that contains a **SerAuxErrBar** record (section [2.4.249](#serauxerrbar)). + +The following records and rules define the significant parts of an **error bar**: + +- The sequence of records that conforms to the **SS** rule (section 2.1.7.20.1) specifies the formatting properties of the **error bar**. The **yi** field of the **DataFormat** record (section [2.4.74](#dataformat)) MUST specify the zero-based index of the **Series** record (section [2.4.252](#series-1)) associated with this **error bar** in the collection of all **Series** record in the current **chart sheet substream**. Each **error bar** MUST contain zero or one sequences of records that conform to the **SS** rule. + +- The **SerParent** record (section [2.4.255](#serparent)) specifies the **series** associated with the **error bar**. + +- The **SerAuxErrBar** record specifies properties of the **error bar**, including the direction and type of the **error bar**. + +The following restrictions apply to **error bars**: + +- All fields except the **cValx** and **cValy** fields in the **Series** record MUST be ignored. + +- The **cValx** field MUST equal the **cValx** field of the **Series** record in the associated **series** specified by the **SerParent** record. + +- If the **ebsrc** field of the **SerAuxErrBar** record equals 0x04 and the **sertm** field of the **SerAuxErrBar** equals 0x01 or 0x02, the **cValx** field MUST equal the number of values represented by the **formula** field of the second **BRAI** record (section [2.4.29](#brai)) in the sequence of records that conforms to the **AI** rule (section 2.1.7.20.1). + +- If the **ebsrc** field of the **SerAuxErrBar** record equals 0x04 and the **sertm** field of the **SerAuxErrBar** equals 0x03 or 0x04, the **cValy** field MUST equal the number of values represented by the **formula** field of the second **BRAI** record in the sequence of records that conforms to the **AI** rule. + +- If the **ebsrc** field of the **SerAuxErrBar** record does not equal 0x04, the **cValy** field MUST equal the **cValy** field of the **Series** record in the associated **series** specified by the **SerParent** record. + +- The **BRAI** records in the first, third, and fourth sequences of records that conform to the **AI** rule MUST be ignored and the **ifmt** field of the **BRAI** records MUST equal 0x0000. + +- If the **ebsrc** field of the **SerAuxErrBar** record equals 0x04, the **ifmt** field of the **BRAI** records contained in the second collection of records that conform to the **AI** rule specifies a **Formula** (section [2.4.127](#formula)) that specifies custom values of the **error bar**. + +- If the **ebsrc** field of the **SerAuxErrBar** record equals 0x04, the **BRAI** records in the second sequence of records that conforms to the **AI** rule MUST be ignored and the **ifmt** field of the **BRAI** records MUST equal 0x0000. + +- The **LegendException** record (section [2.4.153](#legendexception)) in the **chart sheet substream** MUST NOT exist. + +#### Data Table + +A [**data table (2)**](#gt_9e13d7ee-50d6-40ae-8789-29ecafe24bd4) is a table on a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)) that contains a row for each **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) and lists the values of each **data point** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) on the **chart**. + +A data table (2) is specified by a sequence of records that conforms to a **DAT** rule (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) as specified by the **chart sheet substream** (section 2.1.7.20.1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +The following records and rules define the significant parts of a data table (2): + +- The **Dat** record (section [2.4.73](#dat)) specifies if the data table (2) shows [**legend keys**](#gt_6981bc96-6d51-425c-9550-63c5b8b08e54) next to the name of the **series** and specifies which data table (2) borders are displayed. + +- The sequences of records that conform to the **ATTACHEDLABEL** (section 2.1.7.20.1) and **TEXTPROPS** (section 2.1.7.20.1) rules in the sequence of records that conforms to the **LD** rule (section 2.1.7.20.1) specify the text formatting for the data table (2). The **Pos** record (section [2.4.201](#pos)) of the **attached label** (section [2.2.3.15](#Section_9ac44e58af9940f4a99ace470eff0f5a)) MUST be ignored. The **ObjectLink** record (section [2.4.182](#objectlink)) of the **attached label** MUST NOT exist. + +- The sequence of records that conforms to the **FRAME** rule (section 2.1.7.20.1) in the sequence of records that conforms to the **LD** rule specifies the formatting properties of the data table (2). + +The following restrictions apply to the collection of records that represents a data table (2): + +- The **fWasDataTable** field of the **Legend** record (section [2.4.152](#legend-1)) in the sequence of records that conforms to the **LD** rule MUST equal 1. + +- The **Pos** record in the sequence of records that conforms to the **LD** rule MUST be ignored. A data table (2) is automatically positioned. + +- The **CrtLayout12** record (section [2.4.66](#crtlayout12)) and the sequence of records that conforms to the **CRTMLFRT** rule (section 2.1.7.20.1), in the sequence of records that conforms to the **LD** rule, MUST NOT exist in a data table (2). + +A data table (2) is not displayed on a **chart** if the **chart** contains a bar of pie, bubble, doughnut, filled radar, pie, pie of pie, radar, or scatter **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)). + +#### Attached Label + +An **attached label** is a generic text element that is used on a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). An **attached label** can specify properties of an **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)) title, **chart** title, **data label** (section [2.2.3.11](#Section_cac7f43a3af142f58ff2814c2870427f)), **data table** (section [2.2.3.14](#Section_69938f61d2e94da3af87e154edcb0d98)), [**display units**](#gt_7d807b62-cff1-4e03-a73f-840844345b83) label, **legend** (section [2.2.3.8](#Section_1832229b7d1945f488d455e9c07466f0)), [**legend entry**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e), **trendline** (section [2.2.3.12](#Section_61d74ebc36714d6dbdc0626db604530d)) label, or the default text properties of the entire **chart**. + +The location of the **attached label** in the **chart sheet substream** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) and the properties of the **ObjectLink** record (section [2.4.182](#objectlink)) of the **attached label** specify the **chart** element to which the **attached label** applies. Refer to the **conceptual overviews** (section [2.2.3](#Section_3e15a76353f14118a8f45f4e42a981c2)) for explanation of the meaning of the **attached label** in each context that it is used. + +An **attached label** is specified by a collection of records that conforms to an **ATTACHEDLABEL** rule (section 2.1.7.20.1) as specified by the **chart sheet substream** (section 2.1.7.20.1) ABNF. + +- The **Text** record (section [2.4.324](#text)) and the collection of records that conforms to the **TEXTPROPS** rule (section 2.1.7.20.1) specify properties of the text in the **attached label**. These properties include text options such as text rotation and reading order. On **attached labels** that represent **data labels**, the **Text** record also specifies content and layout properties of the **data labels**. + +- The **Pos** (section [2.4.201](#pos)) and **CrtLayout12** (section [2.4.66](#crtlayout12)) records specify the position of the **attached label** on the **chart**. The **Pos** record MUST be ignored if the **attached label** represents the **data labels** on a **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)) or **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)), a **data table**, the default text of the **chart**, or a [**legend key**](#gt_6981bc96-6d51-425c-9550-63c5b8b08e54). + +- The **FontX** (section [2.4.123](#fontx)) and **AlRuns** (section [2.4.1](#alruns)) records specify the font and rich text formatting properties of the **attached label**. + +- The collection of records that conforms to the **AI** rule (section 2.1.7.20.1) specifies custom text of the **attached label**. + +- The collection of records that conforms to the **FRAME** rule (section 2.1.7.20.1) specifies the fill and border properties of the **attached label**. + +- The **ObjectLink** record specifies the **chart** element the **attached label** applies to. + +- The **DataLabExtContents** record (section [2.4.76](#datalabextcontents)) specifies additional **data label** properties on **attached labels** that represent a **data label**. Refer to the **data label** overview for the conditions when this record can be written. This record MUST NOT exist unless the **attached label** specifies properties of a **data label**. An **attached label** specifies properties of a **data label** if the **wLinkObj** field of the **ObjectLink** record is equal to 0x0004 or the attached label is in the collection of records that conforms to the **DFTTEXT** rule (section 2.1.7.20.1) in a **chart group**. + +- The collection of records that conforms to the **CRTMLFRT rule** (section 2.1.7.20.1) specifies **future records** (section [2.1.6](#Section_b660b67822684414839ed1ae9a4e4e85)) for the **attached label**. + +#### SPRC + +A **SPRC** is a unit of measurement that is 1/4000th of the height or width of the **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). If the field is being used to specify a width or horizontal distance, the **SPRC** is 1/4000th of the width of the **chart**. If the field is being used to specify a height or vertical distance, the **SPRC** is 1/4000th of the height of the **chart**. + +#### Chart Area + +For non-embedded **charts**, the size of the area is specified by the **Chart** record (section [2.4.45](#chart-2)) in points. For embedded **charts**, the **chart** is treated as a drawing and its size is calculated from the **OfficeArtClientAnchorSheet** record (section [2.5.193](#officeartclientanchorsheet)) that is contained in the **MsoDrawing** (section [2.4.170](#msodrawing)) preceding the **chart** stream. The **chart area** calculation is as follows: + +1\. Get **chart area width in pixels** + +**chart area width in pixels** = (dx field of **Chart** record - 8) \* DPI of the display device / 72 for non-embedded **charts**. + +**chart area width in pixels** is calculated from individual cell widths/heights that anchor the **chart** as indicated by **OfficeArtClientAnchorSheet** (section 2.5.193) for embedded charts. + +If the **frt** field of the **Frame** record (section [2.4.128](#frame)) following the **Chart** record (section 2.4.45) is 0x0004 and the **chart** is not embedded, add the shadow size: + +**chart area width in pixels** -= 2 \* line width of the display device in pixels + +2\. Get **chart area height in pixels** + +**chart area height in pixels** = (dy field of **Chart** record - 8) \* DPI of the display device / 72 for non-embedded **charts**. + +**chart area height in pixels** is calculated from individual cell widths/heights that anchor the **chart** as indicated by **OfficeArtClientAnchorSheet** (section 2.5.193) for embedded charts. + +If the **frt** field of the **Frame** record (section 2.4.128) following the **Chart** record (section 2.4.45) is 0x0004 and the **chart** is not embedded, add the shadow size: + +**chart area height in pixels** -= 2 \* line height of the display device in pixels + +### Metadata + +**Metadata** is additional data associated with a particular [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) or its content. **Metadata** is recorded in [**BIFF8**](#gt_e60b71bb-c66c-4a44-ab07-0f9f20ee3dd5) for future extensibility purpose only. + +![Metadata](media/image2.bin "Metadata") + +Figure 2: Metadata + +The following sections define terms used in this diagram. + +#### Metadata Types + +The architecture of the metadata allows for multiple types of metadata. + +Each type of metadata has an associated collection of metadata records, a unique name, and a set of predefined properties. Those properties describe whether the metadata remains associated with the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) or its content during runtime operations (for example, insert, shift, copy/paste, merge, or unmerge operations), as well as whether the metadata is **cell metadata** (section [2.2.4.2](#Section_c925f5199fe14b6ab01807fa18351e68)) or **value metadata** (section [2.2.4.3](#Section_e78bf5ba22754bad8e6cf4f59644efa6)). + +A metadata type is represented by an **MDTInfo** record (section [2.4.162](#mdtinfo)). + +#### Cell Metadata + +**Cell metadata** is metadata associated with a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) itself. **Cell metadata** is not represented in [**BIFF8**](#gt_e60b71bb-c66c-4a44-ab07-0f9f20ee3dd5) format. + +#### Value Metadata + +**Value metadata** is metadata associated with the value of a particular [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). **Value metadata** is associated with a cell through a **formula** (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing a single special function, \_xlfn.COMPOUNDVALUE, whose single mandatory argument references a **metadata block** record (section [2.2.4.4](#Section_9fd157237cbe4334b4d10f23e3ed706c))[\<18\>](#Appendix_A_18). + +The only **value metadata** type represented in [**BIFF8**](#gt_e60b71bb-c66c-4a44-ab07-0f9f20ee3dd5) is **MDX metadata** (section [2.2.4.5](#Section_0f7583182c0b4155bf75c7399f89305c)). + +#### Metadata Block + +Cells are associated with actual metadata values using a metadata mapping table known as a **metadata block**. A **metadata block** contains a collection of indexes to metadata records, along with the corresponding **metadata types** (section [2.2.4.1](#Section_bbefb91d7be44ea69e2e707bae2c69ab)). + +A **metadata block** is represented by an **MDB record** (section [2.4.161](#mdb)). + +#### MDX Metadata + +The only type of metadata used is [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) metadata. + +The **MDTInfo** record (section [2.4.162](#mdtinfo)) that specifies the **metadata type** (section [2.2.4.1](#Section_bbefb91d7be44ea69e2e707bae2c69ab)) for MDX metadata MUST have the following values: + +| Field | Value | +|--------------------------|:-------:| +| **fGhostRow** | 0 | +| **fGhostCol** | 0 | +| **fEdit** | 0 | +| **fDelete** | 0 | +| **fCopy** | 1 | +| **fPasteAll** | 1 | +| **fPasteFormulas** | 0 | +| **fPasteValues** | 1 | +| **fPasteFormats** | 0 | +| **fPasteComments** | 0 | +| **fPasteDataValidation** | 0 | +| **fPasteBorders** | 0 | +| **fPasteColWidths** | 0 | +| **fPasteNumberFormats** | 0 | +| **fMerge** | 1 | +| **fSplitFirst** | 1 | +| **fSplitAll** | 0 | +| **fRowColShift** | 1 | +| **fClearAll** | 0 | +| **fClearFormats** | 1 | +| **fClearContents** | 0 | +| **fClearComments** | 1 | +| **fAssign** | 1 | +| **fCoerce** | 1 | +| **fAdjust** | 0 | +| **fCellMeta** | 0 | +| **stName** | "XLMDX" | + +An MDX metadata record references the connection name and the [**cube function**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3) used or referenced in a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +There are four types of MDX metadata records: **MDX tuple metadata** (section [2.2.4.5.1](#Section_277444ebcca34128b302b39de79eeb41)), **MDX set metadata** (section [2.2.4.5.2](#Section_84d4d0b542b6405ea07be3272dc517f8)), **MDX member property metadata** (section [2.2.4.5.3](#Section_722f7e05ca3e4a20b30fbbed1a597e88)), and **MDX KPI metadata (**section [2.2.4.5.4](#Section_db8664f2502b43d2aa88274035b52570)**)**. + +##### MDX Tuple Metadata + +An [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**tuple**](#gt_e64f7e8a-c55b-47dc-9c6e-2afe5f13d448) is the intersection between two or more [**members (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) from different [**dimensions (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c). + +MDX tuple metadata is used by [**cube functions**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3) returning a member (2) or a value. + +MDX tuple metadata is represented by an **MDXTuple** record (section [2.4.167](#mdxtuple)). + +##### MDX Set Metadata + +An [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) set is an ordered collection of [**members (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) within the same [**dimension (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c). + +MDX set metadata is used by [**cube functions**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3) returning a set or the number of items in a set. + +MDX set metadata is represented by an **MDXSet** record (section [2.4.165](#mdxset)). + +##### MDX Member Property Metadata + +An [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**member property**](#gt_c7ddc1fa-c564-42c5-b755-aed72a0cb000) represents the property value of a [**member (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11). + +MDX member property metadata references a member (2) name and a property name. + +MDX member property metadata is represented by an **MDXProp** record (section [2.4.164](#mdxprop)). + +##### MDX KPI Metadata + +An [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**key performance indicator (KPI)**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) represents the KPI property value of a KPI [**member (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11). + +MDX KPI metadata references a KPI name, a KPI property, and a member (2) name. + +MDX KPI metadata is represented by an **MDXKPI** record (section [2.4.163](#mdxkpi)). + +### PivotTables + +A PivotTable is a mechanism for summarizing **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) to get an overview of the distribution of that data. In a PivotTable, applicable columns of the **source data** become fields that can be used to summarize data. + +When the **source data** of the **PivotTable** is [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) **source data**, [**OLAP hierarchies**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) and some other OLAP entities become fields in the PivotTable. + +A PivotTable has two major parts, a **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) and a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). These parts are described in the following sections. There can be multiple **PivotTable views** based on a single non-**OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)). An **OLAP PivotCache** MUST have exactly one **associated PivotTable view** (section [2.2.5.3.3](#Section_855483943345473bb926de5189fd664d)). + +The values produced by a PivotTable are placed in cells of a [**sheet (2)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and these cells make up a PivotTable report. + +The PivotTable structures are not needed to obtain values from a **PivotTable** report because those values are available in the sheet (2) cells. The structures are needed for the following purposes: + +- To show extra information related to a PivotTable report in an application, such as sort and filter information. + +- To recalculate a **PivotTable view**, to incorporate changes such as sorting and filtering made to it, and to update the corresponding **PivotTable** report accordingly. + +- To refresh a **PivotCache**, to incorporate changes made to the **source data**, and then recalculate any **PivotTable views** associated with the **PivotCache** and to update the corresponding **PivotTable** reports accordingly. + +#### PivotTable Records + +For general information about records see section [2.1](#Section_2e6147d9e8ad48b09ff7bbfc51ca950d). **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) uses records from the **Worksheet Substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)), the **Globals Substream** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)), and the [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) in the **Pivot Cache Storage (\_SX_DB_CUR)** (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)). + +Concepts specified for **PivotTables** can have multiple sequences of records specifying them. The sequences can be in different streams or substreams. In these cases additional information is specified for the concept in the **PIVOTFRT9** rule (section 2.1.7.20.5) or by **SXAddl** records (section [2.4.273.2](#sxaddl)). See the individual records, the **QsiSXTag** record (section [2.4.211](#qsisxtag)) and section [2.2.5.1.1](#Section_db61fa8bdb7b4e1c99615c2f3ed1c369) for more information about how the additional information is connected to the concept. + +##### Usage of SXAddl Records + +The **SXAddl** records (section [2.4.273.2](#sxaddl)) is a record used for storing additional **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)), **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) or [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) information of a variety of types. + +**SXAddl** records have an **hdr** field of type **SXAddlHdr** (section [2.5.253](#sxaddlhdr)) that specifies the current **class** (section [2.2.5.1.1.1](#Section_3450b26af2b247dd982c6b9eb2d448b0)) and the full type of record, see section 2.2.5.1.1.1 for details. The full record type specifies the meaning of the **data** field of the **SXAddl** record. + +###### Class + +All **SXAddl** records (section [2.4.273.2](#sxaddl)) are grouped into classes. Each **SXAddl** record has a current class. An **SXAddl** record can be in other classes as well. The different classes and their specifications follow. + +Unless the value of the **hdr.sxc** field of **SXAddl** is 0x09 and the value of the **hdr.sxd** field of **SXAddl** is 0xFF, the **hdr.sxc** field of the **SXAddl** record specifies the current class and MUST be a value from the following table: + +| Name | Value | Current Class | +|----|----|----| +| sxcView | 0x00 | **SxcView** class (section [2.2.5.1.1.1.1](#Section_a17d6dc32db74ec4b3cbeded2b7126c3)) | +| sxcField | 0x01 | **SxcField** class (section [2.2.5.1.1.1.2](#Section_51de615365d949198b2a537779e0a9f7)) | +| sxcHierarchy | 0x02 | **SxcHierarchy** class (section [2.2.5.1.1.1.3](#Section_6167aeb40d774815b3218d3f117c438d)) | +| sxcCache | 0x03 | **SxcCache** class (section [2.2.5.1.1.1.4](#Section_1681856cae2d4f64b8cc40d2702754e7)) | +| sxcCacheField | 0x04 | **SxcCacheField** class (section [2.2.5.1.1.1.5](#Section_102acda2fb58485d9a40a37d0a219103)) | +| sxcQsi | 0x05 | **SxcQsi** class (section [2.2.5.1.1.1.6](#Section_953f8be387154b688af387eef7855f27)) | +| sxcQuery | 0x06 | **SxcQuery** class (section [2.2.5.1.1.1.7](#Section_78ae192deccb4971bc9b33e46f7ab527)) | +| sxcGrpLevel | 0x07 | **SxcGrpLevel** class (section [2.2.5.1.1.1.8](#Section_86689e7b9d264225b6be580f86cea53e)) | +| sxcGroup | 0x08 | **SxcGroup** class (section [2.2.5.1.1.1.9](#Section_664bdb47dfb148b69cbd2d9b6bc48600)) | +| sxcCacheItem | 0x09 | **SxcCacheItem** class (section [2.2.5.1.1.1.10](#Section_23b4298b5a8e4357b2c07c2ea90d91c5)) | +| sxcSxrule | 0x0C | **SxcSXRule** class (section [2.2.5.1.1.1.11](#Section_dd12edef6e8747379bed6f4ceff33127)) | +| sxcSxfilt | 0x0D | **SxcSXFilt** class (section [2.2.5.1.1.1.12](#Section_22611924dd5649078c7ab385cd2ccdc0)) | +| sxcSxdh | 0x10 | **SxcSXDH** class (section [2.2.5.1.1.1.13](#Section_284c3ab876c54d36961f1e0006764807)) | +| sxcAutoSort | 0x12 | **SxcAutoSort** class (section [2.2.5.1.1.1.14](#Section_212512d2c740431f838b7ec651364e2f)) | +| sxcSxmgs | 0x13 | **SxcSXMgs** class (section [2.2.5.1.1.1.15](#Section_7081e96f74c24e339021305d28e3da1a)) | +| sxcSxmg | 0x14 | **SxcSXMg** class (section [2.2.5.1.1.1.16](#Section_7a80fae6884c401f8ecab68064099425)) | +| sxcField12 | 0x17 | **SxcField12** class (section [2.2.5.1.1.1.17](#Section_4bd42ced53544e2ea2665ea9f7787a85)) | +| sxcSxcondfmts | 0x1A | **SxcSXCondFmts** class (section [2.2.5.1.1.1.18](#Section_fdd787b53b0e43f888b9c86cb063a54f)) | +| sxcSxcondfmt | 0x1B | **SxcSXCondFmt** class (section [2.2.5.1.1.1.19](#Section_59cc4e9903ad43f395985be87afdcc92)) | +| sxcSxfilters12 | 0x1C | **SxcSXFilters12** class (section [2.2.5.1.1.1.20](#Section_38fb61e517e742219ea43f1e5a665bc2)) | +| sxcSxfilter12 | 0x1D | **SxcSXFilter12** class (section [2.2.5.1.1.1.21](#Section_9b54e335ef8846d28d19dfbfe2078154)) | + +The current **class** and the **hdr.sxd** field of **SXAddl** specify the full type of the record, see the individual **classes** for details. + +If the value of the **hdr.sxc** field of **SXAddl** is 0x09 and the value of the **hdr.sxd** field of **SXAddl** is 0xFF, then the current **class** is specified by **SxcCacheField** class and the full record type is **SXAddl_SXCCacheItem_SXDEnd** (section [2.4.273.20](#sxaddl_sxccacheitem_sxdend)). + +**Classes** can be nested inside other **classes** in a hierarchical manner as specified by the **Globals Substream** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) [**Augmented Backus-Naur Form (ABNF)**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), **Worksheet Substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) ABNF, and **Common Productions** (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)) ABNF. Properties from the outer **classes** apply to the inner **classes** unless otherwise specified. Records in **classes** nested inside other **classes**, are [**members (1)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) of both the inner and outer **classes**, but their current **class** is given by the value of their **hdr.sxc** field. For example, **SXAddl_SXCHierarchy_SXDProperty** (section [2.4.273.57](#sxaddl_sxchierarchy_sxdproperty)) is a member (1) of the **SxcView** class and the **SxcHierarchy** class and its current **class** is the **SxcHierarchy** class. + +####### SxcView Class + +The **SxcView** class specifies additional information for a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +The **SxcView** class is specified by the sequence of records specified by the **PIVOTADDL** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The **PivotTable view** that the **SxcView** class specifies information for is specified by the **stName** field of the **SXAddl_SXCView_SXDId** record (section [2.4.273.105](#sxaddl_sxcview_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCVIEW (0x00), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCView_SXDId** | +| sxdVerUpdInv | 0x01 | **SXAddl_SXCView_SXDVerUpdInv** (section [2.4.273.110](#sxaddl_sxcview_sxdverupdinv)) | +| sxdVer10Info | 0x02 | **SXAddl_SXCView_SXDVer10Info** (section [2.4.273.108](#sxaddl_sxcview_sxdver10info)) | +| sxdCalcMember | 0x03 | **SXAddl_SXCView_SXDCalcMember** (section [2.4.273.100](#sxaddl_sxcview_sxdcalcmember)) | +| sxdCalcMemString | 0x0A | **SXAddl_SXCView_SXDCalcMemString** (section [2.4.273.101](#sxaddl_sxcview_sxdcalcmemstring)) | +| sxdVer12Info | 0x19 | **SXAddl_SXCView_SXDVer12Info** (section [2.4.273.109](#sxaddl_sxcview_sxdver12info)) | +| sxdTableStyleClient | 0x1E | **SXAddl_SXCView_SXDTableStyleClient** (section [2.4.273.107](#sxaddl_sxcview_sxdtablestyleclient)) | +| sxdCompactRwHdr | 0x21 | **SXAddl_SXCView_SXDCompactRwHdr** (section [2.4.273.103](#sxaddl_sxcview_sxdcompactrwhdr)) | +| sxdCompactColHdr | 0x22 | **SXAddl_SXCView_SXDCompactColHdr** (section [2.4.273.102](#sxaddl_sxcview_sxdcompactcolhdr)) | +| sxdSxpiIvmb | 0x26 | **SXAddl_SXCView_SXDSXPIIvmb** (section [2.4.273.106](#sxaddl_sxcview_sxdsxpiivmb)) | +| sxdEnd | 0xFF | **SXAddl_SXCView_SXDEnd** (section [2.4.273.104](#sxaddl_sxcview_sxdend)) | + +####### SxcField Class + +The **SxcField** class specifies additional information for a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). + +The **SxcField** class is specified by the sequence of records specified by the **SXADDLFIELD** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The **pivot field** that the **SxcField** class specifies information for is specified by the **stName** field of the **SXAddl_SXCField SXDId** record (section [2.4.273.26](#sxaddl_sxcfield_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCFIELD (0x01), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCField SXDId** | +| sxdVer10Info | 0x02 | **SXAddl_SXCField_SXDVer10Info** (section [2.4.273.27](#sxaddl_sxcfield_sxdver10info)) | +| sxdEnd | 0xFF | **SXAddl_SXCField_SXDEnd** (section [2.4.273.25](#sxaddl_sxcfield_sxdend)) | + +####### SxcHierarchy Class + +The **SxcHierarchy** class specifies additional information for a **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)). + +The **SxcHierarchy** class is specified by the sequence of records specified by the **SXADDLHIERARCHY** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The **pivot hierarchy** (section 2.2.5.4.5) that the **SxcHierarchy** class specifies information for is specified by the **stHierUnq** field of the **SXAddl_SXCHierarchy_SXDId** record (section [2.4.273.47](#sxaddl_sxchierarchy_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals sxcHierarchy (0x02), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCHierarchy_SXDId** | +| sxdVerUpdInv | 0x01 | **SXAddl_SXCHierarchy_SXDVerUpdInv** (section [2.4.273.60](#sxaddl_sxchierarchy_sxdverupdinv)) | +| sxdProperty | 0x05 | **SXAddl_SXCHierarchy_SXDProperty** (section [2.4.273.57](#sxaddl_sxchierarchy_sxdproperty)) | +| sxdFilterMember | 0x09 | **SXAddl_SXCHierarchy_SXDFilterMember** (section [2.4.273.44](#sxaddl_sxchierarchy_sxdfiltermember)) | +| sxdSxSetParentUnique | 0x1D | **SXAddl_SXCHierarchy_SXDSXSetParentUnique** (section [2.4.273.58](#sxaddl_sxchierarchy_sxdsxsetparentunique)) | +| sxdUserCaption | 0x1F | **SXAddl_SXCHierarchy_SXDUserCaption** (section [2.4.273.59](#sxaddl_sxchierarchy_sxdusercaption)) | +| sxdIconset | 0x20 | **SXAddl_SXCHierarchy_SXDIconSet** (section [2.4.273.46](#sxaddl_sxchierarchy_sxdiconset)) | +| sxdMeasureGrp | 0x24 | **SXAddl_SXCHierarchy_SXDMeasureGrp** (section [2.4.273.55](#sxaddl_sxchierarchy_sxdmeasuregrp)) | +| sxdDisplayFolder | 0x25 | **SXAddl_SXCHierarchy_SXDDisplayFolder** (section [2.4.273.42](#sxaddl_sxchierarchy_sxddisplayfolder)) | +| sxdParentKPI | 0x26 | **SXAddl_SXCHierarchy_SXDParentKPI** (section [2.4.273.56](#sxaddl_sxchierarchy_sxdparentkpi)) | +| sxdKPIValue | 0x27 | **SXAddl_SXCHierarchy_SXDKPIValue** (section [2.4.273.53](#sxaddl_sxchierarchy_sxdkpivalue)) | +| sxdKPIGoal | 0x28 | **SXAddl_SXCHierarchy_SXDKPIGoal** (section [2.4.273.49](#sxaddl_sxchierarchy_sxdkpigoal)) | +| sxdKPIStatus | 0x29 | **SXAddl_SXCHierarchy_SXDKPIStatus** (section [2.4.273.50](#sxaddl_sxchierarchy_sxdkpistatus)) | +| sxdKPITrend | 0x2A | **SXAddl_SXCHierarchy_SXDKPITrend** (section [2.4.273.52](#sxaddl_sxchierarchy_sxdkpitrend)) | +| sxdKPIWeight | 0x2B | **SXAddl_SXCHierarchy_SXDKPIWeight** (section [2.4.273.54](#sxaddl_sxchierarchy_sxdkpiweight)) | +| sxdKPITime | 0x2C | **SXAddl_SXCHierarchy_sxdKPITime** (section [2.4.273.51](#sxaddl_sxchierarchy_sxdkpitime)) | +| sxdFilterMember12 | 0x3F | **SXAddl_SXCHierarchy_sxdFilterMember12** (section [2.4.273.45](#sxaddl_sxchierarchy_sxdfiltermember12)) | +| sxdInfo12 | 0x41 | **SXAddl_SXCHierarchy_SXDInfo12** (section [2.4.273.48](#sxaddl_sxchierarchy_sxdinfo12)) | +| sxdEnd | 0xFF | **SXAddl_SXCHierarchy_SXDEnd** (section [2.4.273.43](#sxaddl_sxchierarchy_sxdend)) | + +####### SxcCache Class + +The **SxcCache** class specifies additional information for a **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)). + +The **SxcCache** class is specified by the sequence of records specified by the **SXADDLCACHE** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The **PivotCache** that the **SxcCache** class specifies information for is specified by the **idCache** field of the **SXAddl_SXCCache_SXDId** record (section [2.4.273.6](#sxaddl_sxccache_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCCACHE (0x03), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| SxdId | 0x00 | **SXAddl_SXCCache_SXDId** | +| SxdVerUpdInv | 0x01 | **SXAddl_SXCCache_SXDVerUpdInv** (section [2.4.273.11](#sxaddl_sxccache_sxdverupdinv)) | +| SxdVer10Info | 0x02 | **SXAddl_SXCCache_SXDVer10Info** (section [2.4.273.9](#sxaddl_sxccache_sxdver10info)) | +| SxdVerSxMacro | 0x18 | **SXAddl_SXCCache_SXDVerSXMacro (**section [2.4.273.10](#sxaddl_sxccache_sxdversxmacro)**)** | +| SxdInvRefreshReal | 0x34 | **SXAddl_SXCCache_SXDInvRefreshReal** (section [2.4.273.8](#sxaddl_sxccache_sxdinvrefreshreal)) | +| SxdInfo12 | 0x41 | **SXAddl_SXCCache_SXDInfo12** (section [2.4.273.7](#sxaddl_sxccache_sxdinfo12)) | +| sxdEnd | 0xFF | **SXAddl_SXCCache_SXDEnd** (section [2.4.273.5](#sxaddl_sxccache_sxdend)) | + +####### SxcCacheField Class + +The **SxcCacheField** class specifies additional information for a **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)). + +The **SxcCacheField** class is specified by the sequence of records specified by the **SXADDLCACHEFIELD** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). + +The **cache field** that the **SxcCacheField** class specifies information for is specified by the **stSourceName** field of the **SXAddl_SXCCacheField_SXDId** record (section [2.4.273.14](#sxaddl_sxccachefield_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCCACHEFIELD (0x04), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCCacheField_SXDId** | +| sxdProperty | 0x05 | **SXAddl_SXCCacheField_SXDProperty** (section [2.4.273.17](#sxaddl_sxccachefield_sxdproperty)) | +| sxdSxrmitmCount | 0x2D | **SXAddl_SXCCacheField_SXDSxrmitmCount** (section [2.4.273.19](#sxaddl_sxccachefield_sxdsxrmitmcount)) | +| sxdCaption | 0x2F | **SXAddl_SXCCacheField_SXDCaption** (section [2.4.273.12](#sxaddl_sxccachefield_sxdcaption)) | +| sxdIfdbMempropMap | 0x30 | **SXAddl_SXCCacheField_SXDIfdbMempropMap** (section [2.4.273.15](#sxaddl_sxccachefield_sxdifdbmempropmap)) | +| sxdIfdbMpMapCount | 0x31 | **SXAddl_SXCCacheField_SXDIfdbMpMapCount** (section [2.4.273.16](#sxaddl_sxccachefield_sxdifdbmpmapcount)) | +| sxdPropName | 0x40 | **SXAddl_SXCCacheField_SXDPropName** (section [2.4.273.18](#sxaddl_sxccachefield_sxdpropname)) | +| sxdEnd | 0xFF | **SXAddl_SXCCacheField_SXDEnd** (section [2.4.273.13](#sxaddl_sxccachefield_sxdend)) | + +Additionally, **SXAddl_SXCCacheItem_SXDEnd** has a current class of **SxcCacheField** class, as specified in section [2.2.5.1.1.1](#Section_3450b26af2b247dd982c6b9eb2d448b0). + +####### SxcQsi Class + +The **SxcQsi** class specifies additional information for a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289). + +The **SxcQsi** class is specified by the sequence of records specified by the **SXADDLQSI** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The query table that the **SxcQsi** class specifies information for is specified by **stName** field of the **SXAddl_SXCQsi_SXDId** record (section [2.4.273.62](#sxaddl_sxcqsi_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCQSI (0x05), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCQsi_SXDId** | +| sxdEnd | 0xFF | **SXAddl_SXCQsi_SXDEnd** (section [2.4.273.61](#sxaddl_sxcqsi_sxdend)) | + +####### SxcQuery Class + +The **SxcQuery** class specifies additional information for an **external connection** (section [2.2.8](#Section_69df8d03b6fd45cda0a09b026e50a3d9)). + +The **SxcQuery** class is specified by the sequence of records specified by the **SXADDLDBQUERY** rule (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)). + +The **external connection** (section 2.2.8) the **SxcQuery** class specifies information for is specified by the **stURL** field of the **SXAddl_SXCQuery_SXDXMLSource** record (section [2.4.273.67](#sxaddl_sxcquery_sxdxmlsource)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCQUERY (0x06), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdXMLSource | 0x04 | **SXAddl_SXCQuery_SXDXMLSource** | +| sxdScrDataFile | 0x05 | **SXAddl_SXCQuery_SXDSrcDataFile** (section [2.4.273.66](#sxaddl_sxcquery_sxdsrcdatafile)) | +| sxdSrcConnFile | 0x06 | **SXAddl_SXCQuery_SXDSrcConnFile** (section [2.4.273.65](#sxaddl_sxcquery_sxdsrcconnfile)) | +| sxdReconnCond | 0x07 | **SXAddl_SXCQuery_SXDReconnCond** (section [2.4.273.64](#sxaddl_sxcquery_sxdreconncond)) | +| sxdEnd | 0xFF | **SXAddl_SXCQuery_SXDEnd** (section [2.4.273.63](#sxaddl_sxcquery_sxdend)) | + +####### SxcGrpLevel Class + +The **SxcGrpLevel** class specifies information for an **OLAP group level** (section [2.2.5.3.10](#Section_1e04807706d14d4f961ecacb50a12a3d)). + +The **SxcGrpLevel** class is specified by the sequence of records specified by the **SXADDLGRPLEVEL** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The **OLAP group level** the **SxcGrpLevel** class specifies information for is specified by the **stUnique** field of the **SXAddl_SXCGrpLevel_SXDId** record (section [2.4.273.41](#sxaddl_sxcgrplevel_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCGRPLEVEL (0x07), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCGrpLevel_SXDId** | +| sxdGrpLevelnfo | 0x06 | **SXAddl_SXCGrpLevel_SXDGrpLevelInfo** (section [2.4.273.40](#sxaddl_sxcgrplevel_sxdgrplevelinfo)) | +| sxdEnd | 0xFF | **SXAddl_SXCGrpLevel_SXDEnd** (section [2.4.273.39](#sxaddl_sxcgrplevel_sxdend)) | + +####### SxcGroup Class + +The **SxcGroup** class specifies information for an **OLAP grouping** (section [2.2.5.3.10](#Section_1e04807706d14d4f961ecacb50a12a3d)). + +The **SxcGroup** class is specified by the sequence of records specified by the **SXADDLGROUP** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The **OLAP grouping** the **SxcGroup** class specifies information for is specified by the **stName** field of the **SXAddl_SXCGroup_SXDId** record (section [2.4.273.37](#sxaddl_sxcgroup_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCGROUP (0x08), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCGroup_SXDId** | +| sxdGrpInfo | 0x07 | **SXAddl_SXCGroup_SXDGrpInfo** (section [2.4.273.36](#sxaddl_sxcgroup_sxdgrpinfo)) | +| sxdMember | 0x08 | **SXAddl_SXCGroup_SXDMember** (section [2.4.273.38](#sxaddl_sxcgroup_sxdmember)) | +| sxdEnd | 0xFF | **SXAddl_SXCGroup_SXDEnd** (section [2.4.273.35](#sxaddl_sxcgroup_sxdend)) | + +####### SxcCacheItem Class + +The **SxcCacheItem** class specifies additional information for a **cache item** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)). + +The **SxcCacheItem** class is specified by the sequence of records specified by the **SXADDLCACHEITEM** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). + +The **cache item** that the **SxcCacheItem** class specifies information for is specified by the **dwItem** field of the **SXAddl_SXCCacheItem_SXDId** record (section [2.4.273.21](#sxaddl_sxccacheitem_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCCACHEITEM (0x09), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCCacheItem_SXDId** | +| sxdSxrmitmDisp | 0x2E | **SXAddl_SXCCacheItem_SXDSxrmitmDisp** (section [2.4.273.24](#sxaddl_sxccacheitem_sxdsxrmitmdisp)) | +| sxdItmMpropMap | 0x32 | **SXAddl_SXCCacheItem_SXDItmMpropMap** (section [2.4.273.23](#sxaddl_sxccacheitem_sxditmmpropmap)) | +| sxdItmMpMapCount | 0x33 | **SxAddl_SXCCacheItem_SXDItmMpMapCount** (section [2.4.273.22](#sxaddl_sxccacheitem_sxditmmpmapcount)) | +| sxdEnd | 0xFF | **SXAddl_SXCCacheItem_SXDEnd** (section [2.4.273.20](#sxaddl_sxccacheitem_sxdend)) | + +**SXAddl_SXCCacheItem_SXDEnd** is a part of the **SxcCacheField** class (section [2.2.5.1.1.1.5](#Section_102acda2fb58485d9a40a37d0a219103)) and is not a [**member (1)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) of the **SxcCacheItem** class. **SXAddl_SXCCacheItem_SXDEnd** specifies the end of a collection of **SxcCacheItem** classes. + +####### SxcSXrule Class + +The **SxcSXrule** class specifies a **PivotTable** rule (section [2.2.5.4.11](#Section_ce60432dda944422929fcf3f6a0a206f)). + +The **SxcSXrule class** is specified by the sequence of records specified by the **SXADDLSXRULE** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCRULE (0x0C), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXrule_SXDId** (section [2.4.273.98](#sxaddl_sxcsxrule_sxdid)) | +| sxdSxrule | 0x13 | **SXAddl_SXCSXrule_SXDSXrule** (section [2.4.273.99](#sxaddl_sxcsxrule_sxdsxrule)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXrule_SXDEnd** (section [2.4.273.97](#sxaddl_sxcsxrule_sxdend)) | + +####### SxcSXfilt Class + +The **SxcSXfilt** class specifies information for a **PivotTable rule filter** (section [2.2.5.4.11](#Section_ce60432dda944422929fcf3f6a0a206f)). + +The **SxcSXfilt** class is specified by the sequence of records specified by the **SXADDLSXFILT** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXFILT (0x0D), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXfilt_SXDId** (section [2.4.273.76](#sxaddl_sxcsxfilt_sxdid)) | +| sxdSxfilt | 0x14 | **SXAddl_SXCSXfilt_SXDSXfilt** (section [2.4.273.77](#sxaddl_sxcsxfilt_sxdsxfilt)) | +| sxdSxitm | 0x15 | **SXAddl_SXCSXfilt_SXDSXItm** (section [2.4.273.78](#sxaddl_sxcsxfilt_sxdsxitm)) | +| sxDEnd | 0xFF | **SXAddl_SXCSXfilt_SXDEnd** (section [2.4.273.75](#sxaddl_sxcsxfilt_sxdend)) | + +####### SxcSXDH Class + +The **SxcSXDH** class specifies the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**dimensions (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) for **pivot hierarchies** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) in the **associated PivotTable view** (section [2.2.5.3.3](#Section_855483943345473bb926de5189fd664d)) of the **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)). MUST NOT be present if the **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) is a non- **OLAP PivotCache**. + +The **SxcSXDH** class is specified by the sequence of records specified by the **SXADDLSXDH** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXDH (0x10), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXDH_SXDId** (section [2.4.273.73](#sxaddl_sxcsxdh_sxdid)) | +| sxdSxdh | 0x1A | **SXAddl_SXCSXDH_SXDSxdh** (section [2.4.273.74](#sxaddl_sxcsxdh_sxdsxdh)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXDH_SXDEnd** (section [2.4.273.72](#sxaddl_sxcsxdh_sxdend)) | + +####### SxcAutoSort Class + +The **SxcAutoSort** class specifies **pivot field sorting** (section [2.2.5.4.3.1](#Section_6a008d4253834e13a1d06d8ee5d93b76)) information for a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). + +The **SxcAutoSort** class is specified by the sequence of records specified by the **SXADDLAUTOSORT** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCAUTOSORT (0x12), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCAutoSort_SXDId** (section [2.4.273.4](#sxaddl_sxcautosort_sxdid)) | +| sxdEnd | 0xFF | **SXAddl_SXCAutoSort_SXDEnd** (section [2.4.273.3](#sxaddl_sxcautosort_sxdend)) | + +####### SxcSXMgs Class + +The **SxcSXMgs** class specifies [**OLAP measure groups**](#gt_a14d2b2b-03ca-40e2-a237-3d1a53f87261). + +The **SxcSXMgs** class is specified by the sequence of records specified by the **SXADDLSXMGS** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXMGS (0x13), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXMgs_SXDId** (section [2.4.273.95](#sxaddl_sxcsxmgs_sxdid)) | +| sxdMgrpSxdhMap | 0x23 | **SXAddl_SXCSXMgs_SXDMGrpSXDHMap** (section [2.4.273.96](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXMgs_SXDEnd** (section [2.4.273.94](#sxaddl_sxcsxmgs_sxdend)) | + +####### SxcSXMg Class + +The **SxcSXMg** class specifies information for an [**OLAP measure group**](#gt_a14d2b2b-03ca-40e2-a237-3d1a53f87261). + +The **SxcSXMg** class is specified by the sequence of records specified by the **SXADDLSXMG** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). + +The OLAP measure group that the **SxcSXMg** class specifies information for is specified by the **stName** field of the **SXAddl_SXCSXMg_SXDId** record (section [2.4.273.92](#sxaddl_sxcsxmg_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXMG (0x14), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXMg_SXDId** | +| sxdUserCaption | 0x1F | **SXAddl_SXCSXMg_SXDUserCaption** (section [2.4.273.93](#sxaddl_sxcsxmg_sxdusercaption)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXMg_SXDEnd** (section [2.4.273.91](#sxaddl_sxcsxmg_sxdend)) | + +####### SxcField12 Class + +The **SxcField12** class specifies additional information for a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). + +The **SxcField12** class is specified by the sequence of records specified by the **SXADDLFIELD12** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +The **pivot field** that the **SxcField12** class specifies information for is specified by **stName** field of the **SXAddl_SXCField12_SXDId** record (section [2.4.273.30](#sxaddl_sxcfield12_sxdid)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCFIELD12 (0x17), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCField12_SXDId** | +| sxdVerUpdInv | 0x01 | **SXAddl_SXCField12_SXDVerUpdInv** (section [2.4.273.34](#sxaddl_sxcfield12_sxdverupdinv)) | +| sxdMemberCaption | 0x11 | **SXAddl_SXCField12_SXDMemberCaption** (section [2.4.273.32](#sxaddl_sxcfield12_sxdmembercaption)) | +| sxdVer12Info | 0x19 | **SXAddl_SXCField12_SXDVer12Info** (section [2.4.273.33](#sxaddl_sxcfield12_sxdver12info)) | +| sxdIsxth | 0x1C | **SXAddl_SXCField12_SXDISXTH** (section [2.4.273.31](#sxaddl_sxcfield12_sxdisxth)) | +| sxdAutoshow | 0x37 | **SXAddl_SXCField12_SXDAutoshow** (section [2.4.273.28](#sxaddl_sxcfield12_sxdautoshow)) | +| sxdEnd | 0xFF | **SXAddl_SXCField12_SXDEnd** (section [2.4.273.29](#sxaddl_sxcfield12_sxdend)) | + +####### SxcSXCondFmts Class + +The **SxcSXCondFmts** class specifies information for **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules. + +The **SxcSXCondFmts** class is specified by the sequence of records specified by the **SXADDLCONDFMTS** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXCONDFMTS (0x1A), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXCondFmts_SXDId** (section [2.4.273.71](#sxaddl_sxcsxcondfmts_sxdid)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXCondFmts_SXDEnd** (section [2.4.273.70](#sxaddl_sxcsxcondfmts_sxdend)) | + +####### SxcSXCondFmt Class + +The **SxcSXCondFmt** class specifies information for a **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule. + +The **SxcSXCondFmt** class is specified by the sequence of records specified by the **SXADDLCONDFMT** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXCONDFMT (0x1B), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdSxcondfmt | 0x35 | **SXAddl_SXCSXCondFmt_SXDSXCondFmt** (section [2.4.273.69](#sxaddl_sxcsxcondfmt_sxdsxcondfmt)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXCondFmt_SXDEnd** (section [2.4.273.68](#sxaddl_sxcsxcondfmt_sxdend)) | + +####### SxcSXFilters12 Class + +The **SxcSXFilters12** class specifies **advanced filters** (section [2.2.5.4.8.1](#Section_d490d0634e074f0093389812040ebdff)). + +The **SxcSXFilters12** class is specified by the sequence of records specified by the **SXADDLSXFILTERS12** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXFILTERS12 (0x1C), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXFilters12_SXDId** (section [2.4.273.90](#sxaddl_sxcsxfilters12_sxdid)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXFilters12_SXDEnd** (section [2.4.273.89](#sxaddl_sxcsxfilters12_sxdend)) | + +####### SxcSXFilter12 Class + +The **SxcSXFilter12** class specifies an **advanced filters** (section [2.2.5.4.8.1](#Section_d490d0634e074f0093389812040ebdff)). + +The **SxcSXFilter12** class is specified by the sequence of records specified by the **SXADDLSXFILTER12** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +If the **hdr.sxc** field of an **SXAddl** record (section [2.4.273.2](#sxaddl)) equals SXCSXFILTER12 (0x1D), then the **hdr.sxd** field of the **SXAddl** record MUST be a value from the following table which specifies the full record type: + +| Name | Value | Full record type | +|----|----|----| +| sxdId | 0x00 | **SXAddl_SXCSXFilter12_SXDId** (section [2.4.273.81](#sxaddl_sxcsxfilter12_sxdid)) | +| sxdCaption | 0x2F | **SXAddl_SXCSXFilter12_SXDCaption** (section [2.4.273.79](#sxaddl_sxcsxfilter12_sxdcaption)) | +| sxdSxfilter | 0x38 | **SXAddl_SXCSXFilter12_SXDSXFilter** (section [2.4.273.82](#sxaddl_sxcsxfilter12_sxdsxfilter)) | +| sxdSxfilterDesc | 0x39 | **SXAddl_SXCSXFilter12_SXDSXFilterDesc** (section [2.4.273.83](#sxaddl_sxcsxfilter12_sxdsxfilterdesc)) | +| sxdSxfilterValue1 | 0x3A | **SXAddl_SXCSXFilter12_SXDSXFilterValue1** (section [2.4.273.84](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1)) | +| sxdSxfilterValue2 | 0x3B | **SXAddl_SXCSXFilter12_SXDSXFilterValue2** (section [2.4.273.85](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2)) | +| sxdXlsFilter | 0x3C | **SXAddl_SXCSXFilter12_SXDXlsFilter** (section [2.4.273.86](#sxaddl_sxcsxfilter12_sxdxlsfilter)) | +| sxdXlsfilterValue1 | 0x3D | **SXAddl_SXCSXFilter12_SXDSXFilterValue1** (section [2.4.273.87](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1)) | +| sxdXlsfilterValue2 | 0x3E | **SXAddl_SXCSXFilter12_SXDXlsFilterValue2** (section [2.4.273.88](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2)) | +| sxdEnd | 0xFF | **SXAddl_SXCSXFilter12_SXDEnd** (section [2.4.273.80](#sxaddl_sxcsxfilter12_sxdend)) | + +#### Data Functionality Level + +A **data functionality level** is a number that represents a set of features and run-time behaviors in the following areas related to data manipulation and display: **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)), [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289), and **external connections** (section [2.2.8](#Section_69df8d03b6fd45cda0a09b026e50a3d9)). + +See section [2.2.5.3.1](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) for specific details about the **data functionality level** of a **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)). + +#### PivotCache + +The **PivotCache** is a set of structures that contains information about the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) being summarized in the **PivotTable views** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) using that **PivotCache**. The information includes **source data** organization, data types, and the values. A PivotCache is specified by the records conforming to the following rules: + +| Rule | Notes | +|----|----| +| **PIVOTCACHE** (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)) | This is in a stream as specified in section 2.1.7.12. | +| **PIVOTCACHEDEFINITION** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) | The **SXStreamID** record (section [2.4.303](#sxstreamid)) specifies the associated stream in section 2.1.7.12. | +| **PIVOTFRT9** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) | If an **associated PivotTable view** (section [2.2.5.3.3](#Section_855483943345473bb926de5189fd664d)) is specified by the **QsiSXTag** record (section [2.4.211](#qsisxtag)), then **PivotCache** properties specified in this rule apply to this **PivotCache**. | + +##### PivotCache Functionality Level + +The **PivotCache functionality level** is the **data functionality level** (section [2.2.5.2](#Section_2bcedd76ef064e6084c718ea55042ed6)) associated with a **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)). The **PivotCache functionality level** is used in specification of restrictions for the **PivotCache** and **associated PivotTable views** (section [2.2.5.3.3](#Section_855483943345473bb926de5189fd664d)). It is specified as follows: + +- If an **SXAddl_SXCCache_SXDVerSXMacro** record (section [2.4.273.10](#sxaddl_sxccache_sxdversxmacro)) exists, then the value of the **dwVer** field of the **SXAddl_SXCCache_SXDVerSXMacro** specifies the **PivotCache functionality level**. + +- If an **SXAddl_SXCCache_SXDVerSXMacro** record does not exist and an **SXAddl_SXCView_SXDVer10Info** record (section [2.4.273.108](#sxaddl_sxcview_sxdver10info)) exists for an **associated PivotTable views**, then the value of the **bVerSxMacro** field of the **SXAddl_SXCView_SXDVer10Info** record specifies the **PivotCache functionality level**, except if that value is greater than or equal to 3, in which case the **PivotCache functionality level** is specified to be 1. + +- If an **SXAddl_SXCCache_SXDVerSXMacro** record does not exist and an **SXAddl_SXCView_SXDVer10Info** record does not exist for an **associated PivotTable views**, then the **PivotCache functionality level** is specified to be 0. + +##### Source Data + +A **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) can be based on four different types of **source data**. The type of **source data** is specified by the **sxvs** field of the **SXVS** record (section [2.4.317](#sxvs)). + +When the **source data** type is SHEET as specified by **SXVS**, the data is read from the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) specified by a **DConRef** (section [2.4.86](#dconref)), **DConName** (section [2.4.85](#dconname)), or **DConBin** (section [2.4.83](#dconbin)) record. If the range is a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7), then the **PivotCache** will have one **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) for each column of the table using the column header captions for **cache field** names, and the [**data region**](#gt_6abb146e-d02e-45aa-a034-b25b23b0dd48) values of the table are used as **source data** values, specified by **cache records** (section [2.2.5.3.12](#Section_fe6e4ca0a9b646a4898124e4b61a770a)). Otherwise the **PivotCache** has one **cache field** for each column of the range, using the values in the first row of the range for **cache field** names, and all other rows are used as **source data** values, specified by **cache records**. + +When the **source data** type is SCENARIO as specified by **SXVS**, no new **source data** is available for the **PivotCache** and the **PivotCache** cannot be refreshed. A snapshot of the **source data** might be available in the **cache records**. + +When the **source data** type is EXTERNAL, as specified by **SXVS**, the **source data** is read from an external [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). There is an associated **external connection** (section [2.2.8](#Section_69df8d03b6fd45cda0a09b026e50a3d9)) that is used to obtain data from the external data source. The **external connection** is specified by the sequence of records that conforms to the **DBQUERY** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) in the sequence of records that conforms to the **PIVOTCACHEDEFINITION** rule (section 2.1.7.20.3) and the combination of other records as specified in section 2.2.8. For a non-**OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)), the **source data** is a rectangular table and the **PivotCache** (section 2.2.5.3) has one **cache field** for each column of the table using the column header captions for **cache field** names, and the rows of the table are used as **source data** values, specified by **cache records**. + +If the source data is external and the external connection is an **OLAP Connection** (section [2.2.8.3.1](#Section_068796f9e5154dab8e69f9a7b52aaa9a)) then the **PivotCache** MUST be an **OLAP PivotCache**. For an **OLAP PivotCache**, the **source data** is handled by the data provider specified by the associated **OLAP Connection** and the **PivotCache** MUST NOT have **cache records**. + +When the **source data** type is CONSOLIDATION as specified by **SXVS**, the **source data** is read from one or more ranges. For more details, see the section [2.2.5.3.2.1](#Section_2535c296b76b4728b52c72fbabaf3047). + +When a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) is on the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)) of the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)), the **pivot field** is a server-based page field if the **fServerBased** field of the **SXVDEx** record (section [2.4.310](#sxvdex)) is equal to 1 and the **fServerBased** field of the associated **SXFDB** record (section [2.4.283](#sxfdb)) is equal to 1. A server-based page field is a **pivot field** on the **page axis** that causes the query that is used to retrieve **source data** for populating the **PivotCache** to be parameterized. The query is parameterized according to the page filter criteria, as specified in section 2.2.5.4.9.1. This feature can only be used for an [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) **PivotCache**. + +###### Multiple Consolidation Ranges + +A **multiple** consolidation ranges **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) is used for summarizing multiple [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that contain [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0) in cross-tab format. A **multiple consolidation ranges** **PivotCache** is a collection of ranges and page information that is specified by the sequence of records that conforms to the **SXTBL** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). Each range is specified by one of the **DConName** (section [2.4.85](#dconname)), **DConBin** (section [2.4.83](#dconbin)), or **DConRef** (section [2.4.86](#dconref)) records. + +The following figure shows an example of a range in cross-tab format. The first column of the range contains names of sales people ("George" and "Allan"). The first row in the range contains product groups ("Cars" and "Bikes"). The remaining [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the range contain numeric values representing how many products in a certain product group were sold by each sales person. + +![Example of a range in cross-tab format](media/image3.bin "Example of a range in cross-tab format") + +Figure 3: Example of a range in cross-tab format + +A **multiple** consolidation ranges **PivotCache** is used to summarize multiple cross-tab ranges as shown in the following figure, which shows eight cross-tab ranges. + +![Example of eight ranges in cross-tab format](media/image4.bin "Example of eight ranges in cross-tab format") + +Figure 4: Example of eight ranges in cross-tab format + +The values in the first column of each range are used to create a **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) with a default name specified by the application. Each **cache item** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)) of this **cache field** corresponds to one of the values in the first column of the range, eliminating duplicates. This **cache field** is the first **cache field** in the collection of sequences of records that conform to the **FDB** rule (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)) in the sequence of records that conforms to the **PIVOTCACHE** rule. + +The values in the first row of each range are used to create a **cache field** with a default name specified by the application. Each **cache item** of this **cache field** corresponds to one of the values in the first row of the range, eliminating duplicates. This **cache field** is the second **cache field** in the collection of **FDB** rules (section 2.1.7.12) in the **PIVOTCACHE** rule (section 2.1.7.12). + +The values in all other cells of each range are used to create a **cache field** with a default name specified by the application. Each **cache item** of this **cache field** corresponds to one of the values in the other cells of the range, eliminating duplicates. This **cache field** is the third **cache field** in the collection of **FDB** rules in **PIVOTCACHE** rule. + +A **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) associated with the **multiple** consolidation ranges **PivotCache** is added on creation. The **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) corresponding to the **cache fields** described previously are added to the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)), **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)), and **data axis** (section [2.2.5.4.9.5](#Section_4c5c2daa289746e1854b0ce04209f060)), respectively. + +Up to four additional **cache fields** can optionally exist with default names specified by the application. The corresponding **pivot fields** are added to the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)) of the **PivotTable view** on creation, enabling the user to summarize data from all or a subset of the ranges. The ranges to be summarized in the **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) are selected by adding a **manual filter** (section [2.2.5.4.7](#Section_b0b282651e334c86ad030f5693c1d1e4)) to one or more of these **pivot fields** on the **page axis**. The number of optional **cache fields** created is user-defined and is equal to the **cPages** field of the **SXTbl** record (section [2.4.305](#sxtbl)). Each optional **cache field** corresponds to an **SXTBRGIITM** record. + +The first **SXTBRGIITM** record (section [2.4.307](#sxtbrgiitm)) in the **SXTBL** collection (section 2.1.7.20.3) corresponds to the fourth **cache field** in the collection of **FDB** rules. Each **cache item** of this **cache field** corresponds to the **SXString** record (section [2.4.304](#sxstring)) in the collection of **SXString** records directly following this **SXTBRGIITM** record. + +The second **SXTBRGIITM** record in the **SXTBL** collection corresponds to the fifth **cache field** in the collection of **FDB** rules. Each **cache item** of this **cache field** corresponds to the **SXString** record in the collection of **SXString** records directly following this **SXTBRGIITM** record. + +The third **SXTBRGIITM** record in the **SXTBL** collection corresponds to the sixth **cache field** in the collection of **FDB** rules. Each **cache item** of this **cache field** corresponds to the **SXString** record in the collection of **SXString** records directly following this **SXTBRGIITM** record. + +The fourth **SXTBRGIITM** record in the **SXTBL** collection corresponds to the seventh **cache field** in the collection of **FDB** rules. Each **cache item** of this **cache field** corresponds to the **SXString** record in the collection of **SXString** records directly following this **SXTBRGIITM** record. + +The following figure shows a multiple consolidation ranges **PivotTable** report (section 2.2.5) with two **pivot fields** on the **page axis**. The **PivotTable** report is based on the eight ranges in the figure titled **Example of eight ranges in cross-tab format** and summarizes the values from all the ranges because no **manual filter** (section 2.2.5.4.7) has been applied to any of the **pivot fields** on the **page axis**. + +![Multiple consolidation ranges PivotTable](media/image5.bin "Multiple consolidation ranges PivotTable") + +Figure 5: Multiple consolidation ranges PivotTable + +The **rgiitem** field of the **SxTbpg** record (section [2.4.306](#sxtbpg)) specifies the relationship between each range and the **SXString** records that follow each **SXTBRGIITM** record. + +##### Associated PivotTable views + +The set of **PivotTable views** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) that share an **associated PivotCache** (section [2.2.5.4.1](#Section_6f60301b107346d3b7ad0041566272a4)) are specified to be the **associated PivotTable views** of that **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)). + +A **PivotCache** MUST have at least one associated PivotTable view, and an **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) MUST have exactly one **associated PivotTable view**. + +##### OLAP PivotCache + +A **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) is specified to be an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) PivotCache if it has an **associated PivotTable view** (section [2.2.5.3.3](#Section_855483943345473bb926de5189fd664d)) that is an **OLAP PivotTable view** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)). + +An OLAP PivotCache MUST have exactly one **associated PivotTable view**. + +###### OLAP Data Model + +This section provides background information about the underlying data model for [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) entities. + +The principal unit of scope is an [**OLAP cube**](#gt_11427e13-37ed-49dd-8f0d-5f2b21f7aa4c). See section [2.2.8](#Section_69df8d03b6fd45cda0a09b026e50a3d9) for information about how an OLAP cube is accessed. Items within an OLAP cube can be addressed by an [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) string. Within an OLAP cube, there are [**OLAP hierarchies**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c), [**OLAP measures**](#gt_7431c051-4564-4476-ad00-39c66f169118) and [**OLAP sets**](#gt_bae9ed13-bcae-417e-a59c-d07f85116049). + +An OLAP hierarchy consists of one or more [**OLAP levels**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) and [**OLAP member properties**](#gt_b39deb4c-b405-40a9-90ed-1ba07e39ed9f). An OLAP level consists of one or more [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32). An OLAP member is an atomic unit of data, for example customer "Jim Smith", or a grouping of data, for example "customers in the city of Chicago". OLAP levels contain OLAP members of similar type within an OLAP hierarchy. OLAP members can have parent and child [**members (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) in OLAP levels above and below them, for example "Jim Smith" might be a child of "customers in the city of Chicago". An OLAP member property can be associated with a single OLAP level or all OLAP levels of an OLAP hierarchy, for example a "Mayor" OLAP member property might be associated with a "City" OLAP level. + +An [**OLAP tuple**](#gt_3a1a687f-d28b-485b-96a0-ba0b7eb4119e) is a way of combining multiple OLAP members to reference a particular point in an OLAP cube, for example "customers in the city of Chicago" and "2008" references data in the OLAP cube corresponding to the year 2008 and customers in Chicago. + +An OLAP measure is a value that is available in the OLAP cube. Usually it is numeric, "Sales" and "Head Count" are typical examples of OLAP measures. An OLAP measure is an OLAP member in a measures OLAP hierarchy. For a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)), OLAP measures are stored differently from other OLAP members in this file format. + +An OLAP tuple including an OLAP measure can be used to get a value, for example "customers in the city of Chicago", "2008" and "sales" might reference the value \$659,000. + +An [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28) is a collection of OLAP tuples. OLAP named sets are typically used for specific analytical needs that require custom logic, for example an OLAP named set might be defined as the OLAP tuples corresponding to "the top 10 customers by month and sales". + +##### Cache Fields + +A **cache field** represents an entity by which data can be summarized. + +Consider a **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) based on the following **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)): + +| Country | Product | Date | Sales | +|---------|---------|-----------|-------| +| USA | Bicycle | 6/5/2007 | 500 | +| USA | Car | 8/3/2007 | 20000 | +| Canada | Bicycle | 9/2/2007 | 300 | +| Canada | Car | 10/5/2007 | 35000 | + +In this example, four **cache fields** exist in the **PivotCache**. Each **cache field** corresponds to one of the columns in the **source data**: Country, Product, Date, and Sales. + +The sequence of records that conforms to the **FDB** rule (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)), and optionally the **SXADDLCACHEFIELD** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)), specify a **cache field**. A **cache field** is contained in a **PivotCache**. + +A cache field index is a zero-based index of an **FDB** rule in the **PIVOTCACHE** rule (section 2.1.7.12). + +A **cache** field typically corresponds to a **source data entity**. However, **grouping** (section [2.2.5.3.7](#Section_63e07ed20a764cb08cf446aaf25464c2)) **cache fields** and **cache fields** representing **calculated fields** (section [2.2.5.3.8](#Section_4594f2ac815740b381142e77ba8efb7d)) do not correspond to **source data entities** (section 2.2.5.3.2). Such **cache fields** are fully specified by information in the **PivotCache**. + +The cfdbdb field of the **SXDB** record (section [2.4.275](#sxdb)) specifies the number of **cache fields** that correspond to **source data entities**. If the cache field index of an **SXFDB** record (section [2.4.283](#sxfdb)) is less than cfdbdb, the cache field corresponds to a **source data entity**. Otherwise, the cache field does not correspond to a **source data entity**. A non- **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) MUST have one or more **cache fields** corresponding to **source data columns**. An **OLAP PivotCache** MUST NOT have **cache fields** that do not correspond to **source data entities**. + +In a non- **OLAP PivotCache**, a cache field typically corresponds to one column in the **source data** and contains information about that column. The **cache** field name is specified by the **stFieldName** field of the **SXFDB** record. The **cache** field name of a cache field corresponding to a **source data column** is derived from the name of that column in the **source data** and is used to associate the **cache** field with that **source data column**. + +All **cache field** names MUST be unique, when using a case-insensitive comparison, within the associated **PivotCache**. + +In an **OLAP PivotCache** each **cache field** can be associated with a **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)). For more information, see section [2.2.5.4.5.1](#Section_01a66b9be4a24396b55c28d6207fd28f). + +##### Cache Items + +**Cache items** represent specific instances of the entities represented by **cache fields** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)). For example, an instance of a Country **cache field** might be the USA **cache item**. Having a USA **cache item** in the Country **cache field** enables **PivotTable views** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) associated with the **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) to display data by USA. + +Each cache item specifies its value and a type. In some cases, a **cache item** can have additional information associated with it. + +A **cache item** is contained in a **cache field**. A **cache field** can have zero **cache items** if the **cache field** is not in use in the **PivotTable view**. + +For a **cache field** that corresponds to **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)), a collection of cache items is specified by a collection of sequences of records that conform to the **SRCSXOPER** rule (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)), with each cache item being specified by a sequence of records that conforms to the **SXOPER** rule (section 2.1.7.12), which optionally has a sequence of records that conforms to the **SXADDLCACHEITEM** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) associated with it. The sequence of records that conforms to the **SXOPER** rule specifies the value of the cache item. + +For **grouping** (section [2.2.5.3.7](#Section_63e07ed20a764cb08cf446aaf25464c2)) **cache fields**, the collection of cache items is specified by a collection of sequences of records that conform to the **GRPSXOPER** rule (section 2.1.7.12) with each cache item being specified by an **SXOPER** rule. + +**Calculated fields** (section [2.2.5.3.8](#Section_4594f2ac815740b381142e77ba8efb7d)) do not contain **cache items**. + +A **cache item** index can be used to reference a **cache item** within the **cache field**. Referencing a **cache** item by index requires an implicit or explicit reference to that **cache field** because a **cache item** collection is associated with a specific **cache field**. A **cache field** can be referenced by a **cache field** index, as specified in section 2.2.5.3.5. + +If a collection of **GRPSXOPER** rules exists in the cache field, a **cache item** index is a zero-based index into the collection of **GRPSXOPER** rules. Otherwise, a **cache item** index is a zero-based index into the collection of **SRCSXOPER** rules. + +There can be multiple entries of **source data** that have the same combination of value and type for a **cache field**. Each **cache item** within a **cache field** MUST have a unique combination of value and type. + +If there is one or more references by index to **cache** items of a particular **cache field**, that **cache field** MUST have a **cache items** collection. A **grouping** **cache field** MUST have a collection of **cache items** associated with it. + +A **cache** item collection can contain unused **cache items**. + +Unused **cache items** are values that did not exist in the **source data** when the **PivotCache** was last refreshed but existed when the **PivotCache** was refreshed previously. The **PivotCache** can retain such unused **cache items** to preserve information associated with them to reapply that information if the value corresponding to the **cache item** is added back to the **source data** at some later point in time. + +For an **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)), a **cache field** associated with an [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118) MUST NOT have a **cache** item collection. + +For an **OLAP PivotCache**, a **cache item** with a string value specifies the unique name of an [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32), unless the **cache field** is a **member property** (section [2.2.5.4.6](#Section_e5db3a66677f43db8fb038584797c95f)) **cache field**. + +An example of **cache items** and their association with **source data** is provided here. + +Consider a **PivotCache** based on the following **source data** table: + +| Country | Product | Date | Sales | +|---------|---------|-----------|-------| +| USA | Bicycle | 6/5/2007 | 500 | +| USA | Car | 8/3/2007 | 20000 | +| Canada | Bicycle | 9/2/2007 | 500 | +| Canada | Car | 10/5/2007 | 35000 | + +Four **cache fields** exist, each corresponding to one of the columns: Country, Product, Date, and Sales. Each of the four **cache fields** can have **cache items** corresponding to the unique values in the **source data columns** as illustrated in the following tables: + +| Cache items for the Country cache field | +|-----------------------------------------| +| Canada | +| USA | + +| Cache items for the Product cache field | +|-----------------------------------------| +| Bicycle | +| Car | + +| Cache items for the Date cache field | +|--------------------------------------| +| 6/5/2007 | +| 8/3/2007 | +| 9/2/2007 | +| 10/5/2007 | + +| Cache items for the Sales cache field | +|---------------------------------------| +| 500 | +| 20000 | +| 500 | +| 35000 | + +##### Grouping + +**Grouping** is used to combine a set of **cache items** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)), typically ones that are related in some logical way. There are three different types of **grouping**: numeric grouping, date grouping, and discrete grouping. Numeric grouping combines numeric **cache items** into ranges of values. Date grouping combines date **cache items** into date ranges. Discrete grouping combines specifically selected **cache items** into groups. + +The **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) that contains the **cache items** that are to be grouped is called the base **cache field**. The resultant **cache field** that contains the groups of **cache items** is called the parent grouping **cache field**. Each group of **cache items** in the base **cache field** is associated with a single **cache item** in the parent grouping **cache field**. Often **cache items** in parent grouping **cache fields** can be further grouped, creating a hierarchy of parent grouping **cache fields**. The base **cache field** is at the lowest level of the hierarchy. + +Numeric grouping is specified by records in the **PivotCache Storage part** (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)) that conform to the **GRPSXOPER** (section 2.1.7.12) and **SXRANGE** (section 2.1.7.12) rules. + +For numeric grouping, there is only one **cache field** associated with the grouping and it serves as both the parent grouping **cache field** and the base **cache field**. The numeric grouping is specified by the **fRangeGroup** and **fNumField** fields of the **SXFDB** record (section [2.4.283](#sxfdb)) associated with the **cache field** being equal to 1. The **fHasParent** field of the **SXFDB** record MUST be 0. + +The **cache items** that specify the groups are specified by **SXString** records (section [2.4.304](#sxstring)) that follow the **SXFDB** record. The grouping criteria is specified by the **SxRng** record (section [2.4.300](#sxrng)) that follows the **SXFDB** record. The **iByType** field of the **SxRng** record MUST be 0. For more details, see section 2.4.300. + +Date grouping is specified by records in the **PivotCache Storage part** that conform to the **GRPSXOPER** and **SXRANGE** rules. + +For date grouping, there can be up to seven levels of grouping hierarchy. The grouping level for a **cache field** is specified by the **iByType** field of the **SxRng** record that follows the **SXFDB** record which specifies that **cache field**. The **cache field** with the lowest **iByType** value has the finest level of detail, the **cache field** with the next lowest **iByType** value has the next finest level of detail, and so on. Each **cache field** in the hierarchy MUST have an **SxRng** record with a unique **iByType** value. + +The **cache field** corresponding to the finest level of detail of date information included serves as both a parent grouping **cache field** and the base **cache field**. Other parent grouping **cache fields** specify additional levels in the hierarchy. The date grouping is specified by the **fRangeGroup** and **fNumField** fields of the **SXFDB** record associated with the **cache field** being equal to 1 and 0 respectively for all **cache fields** in the grouping. The **ifdbBase** field of each **SXFDB** record associated with the date grouping, except for the **SXFDB** record corresponding to the base **cache field**, MUST specify a **cache field** index to the **SXFDB** record corresponding to the lowest level of the hierarchy. + +The **cache items** that specify the groups are specified by **SXString** record that follow the **SXFDB** record for the parent grouping **cache fields**. The grouping criteria is specified by the **SxRng** record that follows the **SXFDB** record. The **iByType** field of the **SxRng** record MUST be greater than or equal to 1 (Seconds) and less than or equal to 7 (Years). For more details, see section 2.4.300. + +Discrete grouping is specified by the **GRPSXOPER** rule, the **SxIsxoper** record (section [2.4.290](#sxisxoper)), and the **Continue** records (section [2.4.58](#continue)) in the **PivotCache Storage part**. + +For discrete grouping, a hierarchy of parent grouping **cache fields** can exist, where each parent grouping **cache field** combines the **cache items** of the **cache field** at the next lower level. The discrete grouping is specified by the **fRangeGroup** field of the **SXFDB** record associated with the **cache field** being equal to 0 and the **csxoper** field of the **SXFDB** record being greater than 0. The **ifdbBase** field of the **SXFDB** record specifies a **cache field** index to the base **cache field** at the lowest level of the grouping hierarchy. The **ifdbParent** field of the **SXFDB** record specifies a **cache field** index to the parent grouping **cache field** at the next higher level of the hierarchy. If there is no higher level, then the **fHasParent** field of the **SXFDB** record MUST be 0 and **ifdbParent** MUST be ignored. + +The **cache items** that specify the groups are specified by records that conform to the **GRPSXOPER** rule following the **SXFDB** record. The mapping between the **cache items** in the lower level **cache field** and the **cache items** in the parent grouping **cache field** is specified by the **SxIsxoper** record following the **SXFDB** record for the parent grouping **cache field**. The **rgSxIsxoper** field in the **SxIsxoper** record contains an array element for each **cache item** in the lower level **cache field**. The value of the array element is the index of the **cache item** in the parent grouping **cache field** that the **cache item** in the lower level **cache field** is grouped by. For more details, see section 2.4.290. + +The following paragraphs explain the three different types of grouping and provide examples of them. + +Numeric grouping combines numeric **cache items** into ranges of values. For example, consider the following PivotTable report where the number of people, represented by "Count of Name", of a certain age are listed. + +![PivotTable report with ages](media/image6.bin "PivotTable report with ages") + +Figure 6: PivotTable report with ages + +Analysis of specific ages might not be particularly meaningful. Instead, looking at age groups can be more interesting. The following **PivotTable** report (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) illustrates numeric grouping applied to the "Age" **cache field**. In this example, the numeric grouping is set to start at 0, end at 100, and have groups of 20 years. + +![PivotTable report with age groups](media/image7.bin "PivotTable report with age groups") + +Figure 7: PivotTable report with age groups + +Date grouping is similar to numeric grouping and is used to group **cache items** into date ranges. + +One to seven parent grouping **cache fields** can exist when date grouping is applied to a **cache field**, each corresponding to a different level of detail of date and time information. The **cache field**, to which the date grouping is originally applied, is included in the set of parent grouping **cache fields** and is considered the base **cache field** of the parent grouping **cache fields**. For date grouping, the base **cache field** represents the finest level of detail of date and time information. The following levels of detail of date information are available, each corresponding to one **cache field**: + +- Seconds + +- Minutes + +- Hours + +- Days + +- Months + +- Quarters + +- Years + +For example, consider the following **PivotTable** report where the number of sales is listed for each individual date. + +![PivotTable report with dates](media/image8.bin "PivotTable report with dates") + +Figure 8: PivotTable report with dates + +This information can be too detailed for some analytical purposes. With date grouping, a more useful higher level summary can be created. The following PivotTable report illustrates the result of applying date grouping to the "Date" **cache field** and including two levels of grouping ("Years" and "Quarters"). In this example, the "Quarters" **cache field** represents the finest level of date information included and is therefore the base **cache field** for this date grouping. The "Years" **cache field** is a parent grouping **cache field** with the "Quarters" **cache field** as its base **cache field**. The items "\<1/1/2007" in the two **cache fields** represent dates before 1/1/2007, where the start date is specified by the first **SXNum** record (section [2.4.296](#sxnum)) following the **SxRng** record. The items "\>12/13/2008" in the two **cache fields** represent dates after 12/13/2008, where the end date is specified by the second **SXNum** record following the **SxRng** record. + +![PivotTable report with date groups](media/image9.bin "PivotTable report with date groups") + +Figure 9: PivotTable report with date groups + +Discrete grouping combines specifically selected **cache items** into groups. When discrete grouping is applied to a **cache field**, a separate parent grouping **cache field** is created and the **cache field** that the grouping is applied to will become the base **cache field** for that parent grouping **cache field**. Multiple parent grouping **cache fields** can exist for one base **cache field**, forming a hierarchy of parent grouping **cache fields**. A parent grouping **cache field** higher in the hierarchy is considered the parent of the **cache field** just below it in the hierarchy. For a parent grouping **cache field**, each **cache item** in the **cache items** collection represents one group. + +For example, consider the following **PivotTable** report listing sales by state in the Unites States. + +![PivotTable report with state names](media/image10.bin "PivotTable report with state names") + +Figure 10: PivotTable report with state names + +Discrete grouping can be used to group sets of states, for example, into geographical areas. The following PivotTable report illustrates the result of applying six groups ("Group1" through "Group6") to the **cache field** representing states. The **cache field** representing states is considered the base **cache field** for the discrete grouping in this example. Each group in the example, represented by a **cache item** in the parent grouping **cache field**, combines states in the same geographical area. + +![PivotTable report with state groups](media/image11.bin "PivotTable report with state groups") + +Figure 11: PivotTable report with state groups + +##### Calculated Fields + +**Calculated fields** allow users to add calculations to a **PivotTable** report (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). For example, if a **PivotTable** report contains values for sales and cost by products, but no profit values, a **calculated field** with the formula "=sales-cost" can be added so that profit values are calculated and can be analyzed in the **PivotTable** report. + +A calculated field is a **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) and does not correspond to a column in the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)). The values for a **calculated field** are calculated based on the formula specified for the **calculated field**. A **calculated field** is specified by the **fCalculatedField** field of the **SXFDB** record (section [2.4.283](#sxfdb)) being equal to 1. The formula is specified by the **SXFormula** record (section [2.4.288](#sxformula)) following the **SXFDB** record. + +A **pivot field** associated with a calculated field MUST NOT appear on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)), **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)), or **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)) of a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +An **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) MUST NOT have **calculated fields**. + +##### Calculated Items + +**Calculated items** allow users to add a **cache item** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)) that does not exist in the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) to a **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)). For example, consider a **PivotTable** report (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) displaying sales for the four quarters of 2007. If there are **source data** rows for sales in 2008, a **calculated item** can be used to add an additional **cache item** as a calculated item that calculates the projected sales for the first quarter of the year 2008 as being 25% higher than the sales for the fourth quarter of 2007. The following figure illustrates a **PivotTable** report with such a **calculated item** (2008 Q1 projected). + +![PivotTable report with a calculated item](media/image12.bin "PivotTable report with a calculated item") + +Figure 12: PivotTable report with a calculated item + +The values for a **calculated item** are calculated based on the formula specified for the **calculated** item. + +The sequence of records that conform to the **SXFORMULA** rule (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)) specifies one calculation for a specific **calculated item**. Each **calculated item** can have multiple calculations associated with it and in that case, there are multiple sequences of records that conform to the **SXFORMULA** rule corresponding to the same **calculated item**. The **calculated item** that a calculation is associated with is specified by the sequence of records that conform to the **PIVOTRULE** rule (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)) in the **SXFORMULA** rule. The **PIVOTRULE** rule can also specify additional scoping information. For example, if one calculation for a calculated item named "2008 Q1 projected" only applies to the "Cars" product group, the **PIVOTRULE** rule will specify the **cache field** corresponding to "product group" and the **cache item** corresponding to "Cars". + +An **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) MUST NOT have **calculated items**. + +##### OLAP Grouping + +Grouping in an **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) is the associating of multiple [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) that belong to the same [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) and have the same OLAP member parent. When OLAP members in a particular OLAP level are grouped, a parent grouping OLAP level exists. Each group is represented in the parent grouping OLAP level by one parent grouping OLAP member, and one or more child OLAP members in the OLAP level that the grouping is applied to. + +A parent grouping OLAP level is specified by the sequence of records that conform to the **SXADDLGRPLEVEL** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +A parent grouping OLAP member is specified by the sequence of records that conform to the **SXADDLGROUP** rule (section 2.1.7.20.5). + +##### OLAP Calculated Members + +A calculated [**member (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) is specified by the sequence of records that conform to the **SXADDLCALCMEMBER** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) and is used to create an [**OLAP calculated member**](#gt_16cb1b2a-a915-42c1-81ef-fcf221adb0fe) or an [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28) with an associated user-specified [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) for a custom calculation. + +If the **fLongFormula** field of the **SXAddl_SXCView_SXDCalcMember** record (section [2.4.273.100](#sxaddl_sxcview_sxdcalcmember)) is equal to one, then the **stMDXFormula** field of the **SXAddl_SXCView_SXDCalcMemString** record (section [2.4.273.101](#sxaddl_sxcview_sxdcalcmemstring)) specifies the user-specified MDX expression. If the **fLongFormula** field of the **SXAddl_SXCView_SXDCalcMember** record is equal to zero, then the **stMDXFormula** field of the **SXAddl_SXCView_SXDCalcMember** record specifies the MDX expression. + +The **fSet** field of the **SXAddl_SXCView_SXDCalcMember** record specifies whether the associated calculated member (2) creates an OLAP named set or an OLAP calculated member. + +If the user-specified MDX expression associated with a calculated member (2) defines an [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118), then this calculated member (2) is associated with a measure **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) as specified in section [2.2.5.4.5.2](#Section_4308b88c7f1e42bcb3dd8a1387b69c51). + +If the user-specified MDX expression associated with a calculated member (2) specifies an [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) in an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) other than the OLAP measure hierarchy, then this calculated member (2) can only be associated with a **cache item** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)). + +If a calculated member (2) specifies an OLAP named set, then this calculated member (2) is associated with a named set **pivot hierarchy** as specified in section [2.2.5.4.5.4](#Section_c7f4e861a4e846b28279670fc6edcf6f). + +##### Cache Records + +**Cache records**, as defined by the **Pivot Cache Storage** (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687)), represent a copy of the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) for a **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) and allow for **PivotTable views** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) using a **PivotCache** to be recalculated without retrieving the **source data**. + +Each **cache** record specifies values for one row of **source data**. Each value in a **cache** record is associated with a corresponding **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)). **Cache records** are specified by the sequence of records that conform to the **DBB** rule (section 2.1.7.12). The count of **cache records** MUST be equal to the **crdbdb** field of the **SXDB** record (section [2.4.275](#sxdb)). The **SXDBB** record (section [2.4.276](#sxdbb)) specifies an array of **cache item** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)) indexes for the **cache fields** for which the **fAllAtoms** field of the **SXFDB** record (section [2.4.283](#sxfdb)) is equal to 1. The values for the remaining **cache fields** that correspond to **source data** columns are specified by the sequence of records that conform to the **SXOPER** rule (section 2.1.7.12), with each record specifying a value. For each **cache** record, the number of records in the sequence of records that conforms to the **SXOPER** rule (section 2.1.7.12) MUST be the same as the count of **cache fields**, corresponding to **source data** columns, for which the **fAllAtoms** field of the **SXFDB** record is equal to 0. + +The **cache records** in a **PivotCache** can be invalid, in which case the **cache records** MUST be ignored. The validity of the **cache records** is determined from the **SXAddl_SXCCache_SXDInvRefreshReal** record (section [2.4.273.8](#sxaddl_sxccache_sxdinvrefreshreal)), if one is present and associated with this **PivotCache**, the **QsiSXTag** record (section [2.4.211](#qsisxtag)), if one is present and associated with this **PivotCache**, and the **SXDB** record. If the **SXAddl_SXCCache_SXDInvRefreshReal** record is present, then the **cache records** are not valid if the **fInvalid** field of the **SXAddl_SXCCache_SXDInvRefreshReal** record is 1 and valid if that field is 0. Otherwise, if the **QsiSXTag** record is present, then the **cache records** are not valid if the **fInvalid** field of the **QsiSXTag** record is 1 and valid if that field is 0. Otherwise, the **cache records** are not valid if the **fInvalid** field of the **SXDB** record is 1 and valid if that field is 0. + +An **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) MUST NOT have **cache records**. **Cache records** are optional for a non- **OLAP PivotCache**. + +#### PivotTable View + +A PivotTable view is a set of structures that specify layout, filtering, and other properties. These properties are used to produce a **PivotTable** report (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) based on data from the associated **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)). + +A **PivotTable view** is specified by the sequence of records that conform to the **PIVOTVIEW** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +Functionality specified by a **PivotTable view** includes: + +- The arrangement of **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)), **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)), or both to produce a **PivotTable** report. + +- Using **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) on the **data axis** (section [2.2.5.4.9.5](#Section_4c5c2daa289746e1854b0ce04209f060)) to show summarized result values in the **PivotTable** report. + +- Filtering the data in the **PivotTable** report by performing manual filtering (section [2.2.5.4.7](#Section_b0b282651e334c86ad030f5693c1d1e4)), filtering by criteria (section [2.2.5.4.8](#Section_5b29f1fa92f74d018648957cea96c4c2)), or filtering in the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)). + +- Determining the **PivotTable layout** (section [2.2.5.4.10](#Section_2f81b5b422d546778ec53c5dc1ad80d4)). + +- Formatting the entire **PivotTable** report with a **table style** (section [2.4.320](#tablestyle)). See the **SXAddl_SXCView_SXDTableStyleClient** report (section [2.4.273.107](#sxaddl_sxcview_sxdtablestyleclient)) for details. Alternatively, for an [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f), see section [2.4.313](#sxview) and section [2.4.315](#sxviewex9) for details. + +- Formatting an area of the **PivotTable** report in a way that logically tracks changes in the **PivotTable** report. For details, see the record specifications for records specified by the **PIVOTFORMAT** rule (section 2.1.7.20.5). + +- [**Conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) an area of the **PivotTable** report in a way that logically tracks changes in the **PivotTable** report and performs calculations based the fact that the area is in a **PivotTable** report. For details, see the record specifications for records specified by the **SXADDLCONDFMT** rule (section 2.1.7.20.5). + +- Sorting **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) of **pivot fields** (section 2.2.5.4.3) within the **PivotTable** report. For details, see section [2.2.5.4.3.1](#Section_6a008d4253834e13a1d06d8ee5d93b76). + +##### Associated PivotCache + +A **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) is associated with the **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) specified by the **iCache** field of the **SxView** record (section [2.4.313](#sxview)). **iCache** is a zero-based index of a sequence of records that conform to the **PIVOTCACHEDEFINITION** rule (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) in the sequence of records that conform to the **WORKBOOKCONTENT** rule (section 2.1.7.20.3). + +Each **PivotTable view** MUST be associated with exactly one **PivotCache**. A non- **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) MUST be associated with one or more **PivotTable views**. An **OLAP PivotCache** MUST be associated with exactly one **PivotTable view**. + +##### OLAP PivotTable view + +A **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) is specified to be an **OLAP PivotTable view** if a **QsiSXTag** record (section [2.4.211](#qsisxtag)) exists for the **PivotTable view** and the **fTensorEx** bit of the **QsiSXTag** record is 1. Otherwise, the **PivotTable view** is specified to be a non-**OLAP PivotTable view**. An **OLAP PivotTable view** has an **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)) as its associated **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)). + +##### Pivot Fields + +A **pivot field** corresponds to a **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)). A **pivot field** specifies display information of the data in the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +A **pivot field** is specified by a sequence of records that conforms to the **PIVOTVD** rule (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) and optionally the **PIVOTVDTEX** (section 2.1.7.20.5) and **SXADDLFIELD** (section 2.1.7.20.5) rules. The **PIVOTVDTEX** rule specifies additional properties for **OLAP PivotTable** views (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)), and the **SXADDLFIELD** rule (section 2.1.7.20.5) specifies additional version specific properties. A pivot field is contained in the **PivotTable view**. A **PivotTable view** contains a collection of **pivot fields** which is specified by the sequence of records that conforms to the **PIVOTVIEW** rule (section 2.1.7.20.5). + +A pivot field index, which identifies a pivot field, is specified as the zero-based index of a **PIVOTVD** rule in the collection specified by a **PIVOTVIEW** rule. + +Each **pivot field** is associated with the **cache field** with a **cache field** index equal to the **pivot field** index of this **pivot field**. For more details, see section 2.2.5.3.5. The number of pivot fields in the sequence of records that conforms to a **PIVOTCORE** rule (section 2.1.7.20.5) MUST be equal to the number of **cache fields** in the **associated PivotCache** (section [2.2.5.4.1](#Section_6f60301b107346d3b7ad0041566272a4)) for the **PivotTable view**. + +A **PivotTable view** is used to create a **PivotTable** report (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). This can include information about **pivot fields** placed on **PivotTable axes** (section [2.2.5.4.9](#Section_89db73685e8e4324b592af85e4559e6c)) and **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) referring to **pivot fields**. + +A **pivot field** can have **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)). A **pivot field** can describe information such as **pivot field sorting** (section [2.2.5.4.3.1](#Section_6a008d4253834e13a1d06d8ee5d93b76)) and **subtotaling** (section [2.2.5.4.9.4.2](#Section_427438d9b8e34a5c8b678f158fbf680f)) settings. + +The following figure shows a **PivotTable** report with three pivot fields displaying Sales by Country and Fiscal Year. + +![PivotTable report with three pivot fields: Sales, Country, and Fiscal Year](media/image13.bin "PivotTable report with three pivot fields: Sales, Country, and Fiscal Year") + +Figure 13: PivotTable report with three pivot fields: Sales, Country, and Fiscal Year + +###### Pivot Field Sorting + +A **Pivot Field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) has a [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7) specified if the **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) is recalculated and the **Pivot Field** (section 2.2.5.4.3) is on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)) or **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)). + +A **Pivot Field** is sorted depending on the setting of the **fAutoSort** field of **SXVDEx** (section [2.4.310](#sxvdex)). + +If the **fAutoSort** field of **SXVDEx** is equal to 0, then the sort order is specified depending on the value of the **fTensorSort** field of **SXVDTEx** record (section [2.4.311](#sxvdtex)) of the **Pivot Field**. + +| fTensorSort field of SXVDTEx | Meaning | +|----|----| +| 0 or **SXVDTEx** record not present | The order is determined by the order of the **SXVI** records (section [2.4.312](#sxvi)) for this **Pivot Field**. | +| 1 | The order is determined by the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). Only valid for an **OLAP PivotTable view** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)). | + +If the **fAutoSort** field of **SXVDEx** is equal to 1, then sorting is in ascending or descending order according to the **fAscendSort** field of **SXVDEx**. What is sorted depends on the following: + +| SxcAutoSort class of pivot field presence | isxdiAutoSort field of SXVDEx | Meaning | +|----|----|----| +| Not Present | Greater than or equal to 0 | Sorting is based on the values in the cells in the **PivotTable data area** (section [2.2.5.4.10.1.4](#Section_237a24905c614931923f7ee856f23c72)) that are specified by the **data item** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) referenced by the **isxdiAutoSort** field of **SXVDEx**. | +| Not Present | -1 | Sorting is based on the values of the **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) themselves. | +| Present | | Sorting is either based on the values in the cells in the **PivotTable data area** or on the values of **member properties** (section [2.2.5.4.6](#Section_e5db3a66677f43db8fb038584797c95f)) associated with this **pivot field** as specified by the **SxcSXRule** class (section [2.2.5.1.1.1.11](#Section_dd12edef6e8747379bed6f4ceff33127)) in the **SxcAutoSort** class (section [2.2.5.1.1.1.14](#Section_212512d2c740431f838b7ec651364e2f)). | + +##### Pivot Items + +**Pivot items** represent specific instances of the entities represented by **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). Each **pivot item** specifies its display properties. For example, it can contain the user defined caption for the **pivot item** or information about whether this **pivot item** is hidden or not. + +A **pivot item** specifies view properties of a **cache item** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)) or of an aggregation value associated with a **pivot fields** (section 2.2.5.4.3). + +A pivot item is specified by an **SXVI** record (section [2.4.312](#sxvi)) in a sequence of records that conforms to the **PIVOTVD rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)), and optionally an **SXVIFlags structure** (section [2.5.263](#sxviflags)) specified by an element in the array specified by the **rgsxvi** field of the **SXVDTEx** record (section [2.4.311](#sxvdtex)). The **SXVIFlags structure** (section 2.5.263) specifies additional properties for **OLAP PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)). + +If the **itmType** field of **SXVI** (section 2.4.312) is 0x0000, then this **pivot item** is associated with the **cache item** (section 2.2.5.3.6) specified by the iCache field of the **SXVI** record (section 2.4.312). Each **pivot item** that is associated with a **cache item** (section 2.2.5.3.6) MUST be associated with a different **cache item** (section 2.2.5.3.6) than the other **pivot items** in the collection. If the **itmType** field of this **SXVI** record (section 2.4.312) is not 0x0000, then this **pivot item** MUST NOT have an associated **cache item** (section 2.2.5.3.6). + +The number of **pivot items** where the **itmType** field of the **SXVI** record (section 2.4.312) of the **pivot item** is 0x0000 MUST equal zero or the number of **cache items** (section 2.2.5.3.6) in the **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) of the **pivot fields** (section 2.2.5.4.3). + +A pivot item can be referenced by a pivot item index. A pivot item index is a zero-based index of **SXVI** records (section 2.4.312) in a **PIVOTVD rule** (section 2.1.7.20.5). Note that unlike pivot field index and cache field index, **pivot item** index and cache item index are not necessarily equal. + +##### Pivot Hierarchies + +A **pivot hierarchy** is specified to be contained by a **PivotTable axis** (section [2.2.5.4.9](#Section_89db73685e8e4324b592af85e4559e6c)) when all **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) associated with that pivot hierarchy are placed on that **PivotTable axis** (section 2.2.5.4.9). **Pivot fields** (section 2.2.5.4.3) MUST NOT be placed on a **PivotTable axis** (section 2.2.5.4.9) different from the pivot axis that any other **pivot field** (section 2.2.5.4.3) associated with the same pivot hierarchy is placed on. Additional restrictions can apply, as specified by the **SXTH rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) and the PivotTable Axes section. + +A **pivot hierarchy** corresponds to one of the following entities in the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) associated with an **OLAP PivotCache** (section [2.2.5.3.4](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b)): + +- [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) + +- [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118) + +- [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28) + +- OLAP [**key performance indicator (KPI)**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) + +A **pivot hierarchy** is associated with an OLAP hierarchy in the **source data** (section 2.2.5.3.2). A pivot hierarchy is specified by the sequence of records that conform to the **PIVOTTH rule** (section 2.1.7.20.5) and, optionally, the **SXADDLHIERARCHY rule** (section 2.1.7.20.5). + +Pivot hierarchies MUST NOT exist if the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) is a non- **OLAP PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)). At least one **p**ivot hierarchy MUST exist if the **PivotTable view** (section 2.2.5.4) is an **OLAP PivotTable views** (section 2.2.5.4.2). + +A **pivot hierarchy** specifies OLAP hierarchy information and has one or more associated **pivot fields** (section 2.2.5.4.3) associated with [**OLAP levels**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of the OLAP hierarchy, an OLAP named set, an [**OLAP KPI**](#gt_d49d8fc7-18d5-4e3d-b6ab-547944dba3ca), or an OLAP measure. + +A pivot hierarchy can be referenced by pivot hierarchy index. A pivot hierarchy index is the zero-based index of a **PIVOTTH rule** (section 2.1.7.20.5) in the associated **PIVOTVIEW rule** (section 2.1.7.20.5). + +A pivot hierarchy is associated with an OLAP object as specified in the following table: + +| fMeasure field of SXTH | fSet field of SXTH | fKPI field of SXTH | Meaning | +|------------------------|--------------------|--------------------|----------------| +| 0 | 0 | 0 | OLAP hierarchy | +| 0 | 1 | 0 | OLAP named set | +| 0 | 0 | 1 | OLAP KPI | +| 1 | 0 | 0 | OLAP measure | + +###### Association of Pivot Hierarchies and Pivot Fields and Cache Fields + +A **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) is associated with the **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) specified by either the **isxth** field of the **SXVDTEx record** (section [2.4.311](#sxvdtex)) of that **pivot field** (section 2.2.5.4.3), or the **isxth** field of the **SXAddl_SXCField12_SXDISXTH record** (section [2.4.273.31](#sxaddl_sxcfield12_sxdisxth)) of that **pivot field** (section 2.2.5.4.3). + +If a **pivot field** (section 2.2.5.4.3) has an **SXAddl_SXCField12_SXDISXTH record** (section 2.4.273.31), the **isxth** field of the **SXVDTEx record** (section 2.4.311) MUST be -1 and the association is specified by **isxth** field of the **SXAddl_SXCField12_SXDISXTH record** (section 2.4.273.31). + +A **pivot hierarchy** (section 2.2.5.4.5) associated with a **pivot field** (section 2.2.5.4.3) is associated with the **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) the **pivot field** (section 2.2.5.4.3) is associated. + +If a **pivot hierarchy** (section 2.2.5.4.5) is on the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)) or **data axis** (section [2.2.5.4.9.5](#Section_4c5c2daa289746e1854b0ce04209f060)), the **isxvd** field of **SXTH** (section [2.4.308](#sxth)) is a reference to an associated **pivot field** (section 2.2.5.4.3). + +If the **pivot hierarchy** (section 2.2.5.4.5) is not a **measure** (section [2.2.5.4.5.2](#Section_4308b88c7f1e42bcb3dd8a1387b69c51)), **named set** (section [2.2.5.4.5.4](#Section_c7f4e861a4e846b28279670fc6edcf6f)), **KPI** (section [2.2.5.4.5.3](#Section_239d9d6560154f06a8359f2868568a33)), there can be more than one **pivot field** (section 2.2.5.4.3) associated with it and each array elements in the **rgisxvd** field of **SXTH** (section 2.4.308) is a reference to the associated **pivot field** (section 2.2.5.4.3) for the **pivot hierarchy** (section 2.2.5.4.5) level. + +If a **pivot field** (section 2.2.5.4.3) has an **SXAddl_SXCField12_SXDISXTH record** (section 2.4.273.31) **sxaxis.sxaxisData**, **sxaxis.sxaxisRw**, **sxaxis.sxaxisCol** and **sxaxis.sxaxisPage** fields of the **Sxvd record** (section [2.4.309](#sxvd)) of the **pivot field** (section 2.2.5.4.3) MUST be 0. + +If a **pivot hierarchy** (section 2.2.5.4.5) is a **measure** (section 2.2.5.4.5.2), **named set** (section 2.2.5.4.5.4), or **KPI** (section 2.2.5.4.5.3), there can be no more than one **pivot field** (section 2.2.5.4.3) associated with it. + +###### Measures + +A measure pivot hierarchy is a pivot hierarchy that is associated with an [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118). The **fMeasure** field of the **SXTH** (section [2.4.308](#sxth)) specifies if a pivot hierarchy is a **measure** pivot hierarchy. An OLAP measure MUST NOT have more than one **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) associated with it. A **measure** pivot hierarchy MUST NOT be located on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)), **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)), or **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)). + +###### KPIs + +A [**key performance indicator (KPI)**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) is a **pivot hierarchy** (section 2.2.5.4.5) that is associated with an [**OLAP KPI**](#gt_d49d8fc7-18d5-4e3d-b6ab-547944dba3ca). A **KPI** **pivot hierarchy** (section 2.2.5.4.5) includes the four main components of an OLAP KPI; value, goal, status and trend. The **fKPI** field of the **SXTH record** (section [2.4.308](#sxth)) specifies if a pivot hierarchy is a KPI **pivot hierarchy** (section 2.2.5.4.5). + +###### Named Sets + +A **named set** **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) is a **pivot hierarchy** (section 2.2.5.4.5) that is associated with an [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28). The **fSet** field of the **SXTH record** (section [2.4.308](#sxth)) specifies if a **pivot hierarchy** (section 2.2.5.4.5) is a **named set** **pivot hierarchy** (section 2.2.5.4.5). An OLAP named set MUST NOT have more than one **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) associated with it. A **named set** **pivot hierarchy** (section 2.2.5.4.5) MUST NOT be located on the **data axis** (section [2.2.5.4.9.5](#Section_4c5c2daa289746e1854b0ce04209f060)) or **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)). + +##### Member Properties + +A **member property** is the **PivotTable** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) representation of an [**OLAP member property**](#gt_b39deb4c-b405-40a9-90ed-1ba07e39ed9f). **Member properties** can have properties that are associated with the **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) and a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +A **member property** is specified by the **SXAddl_SXCHierarchy_SXDProperty record** (section [2.4.273.57](#sxaddl_sxchierarchy_sxdproperty)) in the sequence of records that conform to the **SXADDLHIERARCHY rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). A **member property** is contained in a **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)). + +A **member property** is associated with one OLAP member property of the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) specified by the **pivot hierarchy** (section 2.2.5.4.5) of the **member property**. + +A **member property** can be associated with a **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)) and a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). If there is a **cache field** (section 2.2.5.3.5) with an **stFieldName** field of the [SXFDB](#sxfdb) record equal to the **stProperty** field of the **SXAddl_SXCHierarchy_SXDProperty record** (section 2.4.273.57), then this specifies that the **member property** is associated with that **cache field** (section 2.2.5.3.5), and the **cache field** (section 2.2.5.3.5) is specified to be a **member property** **cache field** (section 2.2.5.3.5). The associated **pivot field** (section 2.2.5.4.3) of a **member property** **cache field** (section 2.2.5.3.5) is specified to be a **member property** **pivot field** (section 2.2.5.4.3). + +It is not required that a **member property** is associated with any **cache field** (section 2.2.5.3.5) or **pivot field** (section 2.2.5.4.3). If there is no **cache field** (section 2.2.5.3.5) with a **stFieldName** field of the **SXFDB record** (section 2.4.283) equal to the **stProperty** field of the **SXAddl_SXCHierarchy_SXDProperty record** (section 2.4.273.57), then this specifies that the **member property** is not associated with any **cache field** (section 2.2.5.3.5) or **pivot field** (section 2.2.5.4.3). Such a **member property** does not participate in the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)) or **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)). + +A **member property** **pivot field** (section 2.2.5.4.3) can be shown only in the **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)) or **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)) of a **PivotTable view** (section 2.2.5.4). A **member property** **pivot field** (section 2.2.5.4.3) can only be shown after the last visible level of the corresponding **pivot hierarchy** (section 2.2.5.4.5). The order of **member property** fields shown in the **PivotTable view** (section 2.2.5.4) is the same as the order of **SXAddl_SXCHierarchy_SXDProperty records** (section 2.4.273.57) in the corresponding **pivot hierarchy** (section 2.2.5.4.5). + +##### Manual Filters + +A manual filter enables specific **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) or [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) associated with **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) to be shown or hidden in the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). **Manual filtering** affects calculations when **pivot fields** (section 2.2.5.4.3) that have **manual filters** are located on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)), **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)), or **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)). The **pivot items** (section 2.2.5.4.4) that are hidden for such **pivot fields** (section 2.2.5.4.3) are not included when calculating values for the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +At least one **SXVI record** (section [2.4.312](#sxvi)) following an **Sxvd record** (section [2.4.309](#sxvd)) MUST have the **fHidden** field equal to 0x0. + +Details about manual **filtering** for **pivot fields** (section 2.2.5.4.3) on the **page axis** (section 2.2.5.4.9.1) are covered in the Page Axis section. + +###### Non-OLAP Manual Filters + +For non-**OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)), the state of the **manual filter** (section [2.2.5.4.7](#Section_b0b282651e334c86ad030f5693c1d1e4)) on a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) can be determined by the value of the **fHidden** field of the **SXVI records** (section [2.4.312](#sxvi)) directly following the corresponding **Sxvd record** (section [2.4.309](#sxvd)). This field specifies whether the corresponding **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) is shown or hidden in the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). + +For non-[**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) **PivotTable** (section 2.2.5) with **PivotCache functionality level** (section [2.2.5.3.1](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8)) greater than or equal to 3, the **fFilterInclusive** field of the **SXAddl_SXCField12_SXDVer12Info record** (section [2.4.273.33](#sxaddl_sxcfield12_sxdver12info)) specifies whether new **pivot items** (section 2.2.5.4.4) in the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) are shown or hidden by default when the **PivotTable report** (section 2.2.5) is refreshed in addition to the **pivot items** (section 2.2.5.4.4) that are already shown in the **PivotTable report** (section 2.2.5) as the result of an applied **manual filter** (section 2.2.5.4.7). + +###### OLAP Manual Filters + +For **OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)), **manual filtering** (section [2.2.5.4.7](#Section_b0b282651e334c86ad030f5693c1d1e4)) operates on **pivot hierarchies** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)). **OLAP manual filtering** uses filtering lists to determine what filtering to apply. The **OLAP manual filtering** operation depends on the **PivotCache Functionality Level** (section [2.2.5.3.1](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8)) of the **associated PivotCache** (section [2.2.5.4.1](#Section_6f60301b107346d3b7ad0041566272a4)) of the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +The list of excluded [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) is specified by the **rgHiddenMemberSets** field of the **SXTH record** (section [2.4.308](#sxth)). If the **fFilterInclusive** field of the **SXTH record** (section 2.4.308) of the **pivot hierarchy** (section 2.2.5.4.5) is equal to 0x1, the list of excluded OLAP members MUST be empty. + +The list of included OLAP members is specified by a collection of **SXAddl_SXCHierarchy_SXDFilterMember12 records** (section [2.4.273.45](#sxaddl_sxchierarchy_sxdfiltermember12)) of the **pivot hierarchy** (section 2.2.5.4.5). If the **PivotCache Functionality Level** (section 2.2.5.3.1) of the **associated PivotCache** (section 2.2.5.4.1) of the **PivotTable view** (section 2.2.5.4) is less than 3, the selected **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) list MUST be empty. If the **fFilterInclusive** field of the **SXTH record** (section 2.4.308) of the **pivot hierarchy** (section 2.2.5.4.5) is equal to 0x0, the list of included OLAP members MUST be empty. + +The selected **pivot items** (section 2.2.5.4.4) list is specified to be the list of **pivot items** (section 2.2.5.4.4), with the **fOlapFilterSelected** field of the **SXVIFlags structure** (section [2.5.263](#sxviflags)) that corresponds to each **pivot item** (section 2.2.5.4.4) equal to 0x1, in the **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) associated with the **pivot hierarchy** (section 2.2.5.4.5). If the **PivotCache Functionality Level** (section 2.2.5.3.1) of the **associated PivotCache** (section 2.2.5.4.1) of the **PivotTable view** (section 2.2.5.4) is less than 3, the selected **pivot items** (section 2.2.5.4.4) list MUST be empty. + +If all of the lists of excluded OLAP members, included OLAP members and the selected **pivot items** (section 2.2.5.4.4) are empty, then no **manual filtering** (section 2.2.5.4.7) is specified for the **pivot hierarchy** (section 2.2.5.4.5). Otherwise, the value of the **fFilterInclusive** field of the **SXTH record** (section 2.4.308) of the **pivot hierarchy** (section 2.2.5.4.5) determines how the lists are used. + +If the **fFilterInclusive** field of the **SXTH record** (section 2.4.308) of the **pivot hierarchy** (section 2.2.5.4.5) is equal to 0x1, the [**members (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) of the included OLAP members list and their ascendants and descendants are included in the **manual filter** (section 2.2.5.4.7). The **pivot items** (section 2.2.5.4.4) in the selected **pivot items** (section 2.2.5.4.4) list, and their ascendants and descendants are also included in the **manual filter** (section 2.2.5.4.7). New OLAP members in the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) will be excluded by default when the **PivotTable view** (section 2.2.5.4) is refreshed. + +If the **fFilterInclusive** field of the **SXTH record** (section 2.4.308) of the **pivot hierarchy** (section 2.2.5.4.5) is equal to 0x0, the members (2) of the excluded OLAP members list and their descendants are excluded in the **manual filter** (section 2.2.5.4.7). The **pivot items** (section 2.2.5.4.4) in the selected **pivot items** (section 2.2.5.4.4) list and their descendants are also excluded in the **manual filter** (section 2.2.5.4.7). New OLAP members in the **source data** (section 2.2.5.3.2) will be included by default when the **PivotTable view** (section 2.2.5.4) is refreshed. + +The filtering lists do not include OLAP members which are parent or child members (1) of other OLAP members in the lists. + +##### Filtering by Criteria + +**Filtering by criteria** is the ability to conditionally show **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) of **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) based on user-defined criteria. For example, a criteria [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) might be defined to show all products that sold for more than \$30,000. + +###### Advanced Filters + +An **advanced filter** specifies a user-defined criterion that is used to determine the **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) of a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) that are included when calculating values for the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) and that are displayed in the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). + +Only **advanced filters** that are associated with **pivot fields** (section 2.2.5.4.3) that are located on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)) or the **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)) are applied when the **PivotTable view** (section 2.2.5.4) is calculated. + +An **advanced filter** is specified by the [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154) section. The **isxvd** field of the **SXAddl_SXCSXFilter12_SXDSXFilter record** (section [2.4.273.82](#sxaddl_sxcsxfilter12_sxdsxfilter)) specifies the **pivot field** (section 2.2.5.4.3) associated with the **a**dvanced filter. + +**Advanced filters** MUST NOT be applied to **pivot fields** (section 2.2.5.4.3) of a **PivotTable view** (section 2.2.5.4) if the **PivotCache functionality level** (section [2.2.5.3.1](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8)) of the **associated PivotCache** (section [2.2.5.4.1](#Section_6f60301b107346d3b7ad0041566272a4)) is less than 3. **Advanced filters** MUST NOT be applied to an **OLAP** **PivotTable view** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)) with a value of 0 for the **fSrvSupportSubquery** field of the **SXAddl_SXCCache_SXDInfo12 record** (section [2.4.273.7](#sxaddl_sxccache_sxdinfo12)) of the **associated PivotCache** (section 2.2.5.4.1). + +There are three types of **advanced filters**: **label filter** (section [2.2.5.4.8.1.1](#Section_f221b81b892c4b5c91722d4ed17c937c)), **date filter** (section [2.2.5.4.8.1.2](#Section_2b9377c5055e4efcbcf587fb13c513bd)), and **value filter** (section [2.2.5.4.8.1.3](#Section_05a1c98e21cd4941979880f4bf301bb2)). + +A **pivot field** (section 2.2.5.4.3) MUST NOT have more than one associated **advanced filter** of the same type. + +####### Label Filters + +A **label filter** specifies a criterion that is applied to **pivot item** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) captions to determine which **pivot items** (section 2.2.5.4.4) are included in the calculation of values for the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) and displayed in the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). + +A **label filter** is specified by an **SXAddl_SXCSXFilter12_SXDSXFilter record** (section [2.4.273.82](#sxaddl_sxcsxfilter12_sxdsxfilter)) with the **sxft** field equal to a value in the range 0x00000004 through 0x00000011. + +**Label filters** are applied before any **value filters** (section [2.2.5.4.8.1.3](#Section_05a1c98e21cd4941979880f4bf301bb2)), but the order of **label filters** is not specified. + +If a caption is specified, the **label filter** is applied to the **stName** field in the **SXVI records** (section [2.4.312](#sxvi)) associated with the **pivot items** (section 2.2.5.4.4). If captions are not specified for the **pivot items** (section 2.2.5.4.4), the **label filter** is applied to the values of the **cache items** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)) associated with these **pivot items** (section 2.2.5.4.4). + +A **label filter** can be applied to **member properties** (section [2.2.5.4.6](#Section_e5db3a66677f43db8fb038584797c95f)). The **isxvdMProp** field of the **SXAddl_SXCSXFilter12_SXDSXFilter record** (section 2.4.273.82) specifies the **member property** (section 2.2.5.4.6) on which this **label filter** is applied. + +####### Date Filters + +A **date filter** specifies a criterion that is applied to date type **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) of a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). A **date filter** determines which **pivot items** (section 2.2.5.4.4) are included in the calculation of the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) and are displayed in the **PivotTable view** (section 2.2.5.4) report. + +**Date filters** are specified by **SXAddl_SXCSXFilter12_SXDSXFilter records** (section [2.4.273.82](#sxaddl_sxcsxfilter12_sxdsxfilter)) with the **sxft** field in the range from 0x0000001A through 0x00000041. + +For non-**OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)), a **date filter** can be applied if and only if the **SXFDB record** (section [2.4.283](#sxfdb)) associated with the corresponding **pivot field** (section 2.2.5.4.3) has the **fDateInField** field equal to 0x1, and the **fNonDates** field is equal to 0. For **OLAP** **PivotTable views** (section 2.2.5.4.2), a date filter can be applied if the **fTimeHierarchy** field of the **SXTH record** (section [2.4.308](#sxth)) that specifies the **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) is equal to 1. + +**Date filters** are applied before **value filters** (section [2.2.5.4.8.1.3](#Section_05a1c98e21cd4941979880f4bf301bb2)) and in no specific order. + +####### Value Filters + +A **value filter** specifies a criterion that is applied to values of a **data item** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) for **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) of the **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) that the **value filter** is applied to. The **value filter** determines which **pivot items** (section 2.2.5.4.4) are included when calculating values for the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) and displayed in the **PivotTable view** (section 2.2.5.4) report. + +A **value filter** is specified by the **SXAddl_SXCSXFilter12_SXDSXFilter records** (section [2.4.273.82](#sxaddl_sxcsxfilter12_sxdsxfilter)) with the **sxft** field equal to a value in one of the following the ranges: from 0x00000001 through 0x00000003 or from 0x00000012 through 0x00000019. + +**Value filters** are applied after **manual filters** (section [2.2.5.4.7](#Section_b0b282651e334c86ad030f5693c1d1e4)), **date filters** (section [2.2.5.4.8.1.2](#Section_2b9377c5055e4efcbcf587fb13c513bd)) and **label filters** (section [2.2.5.4.8.1.1](#Section_f221b81b892c4b5c91722d4ed17c937c)) are applied. **Value filters** are applied in the order in which they are specified in the [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154) section. **Value filtering** takes previous filtering into account when evaluating filters. + +###### Simple Filters + +A **simple filter** is a [**top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9) which is also known as [**AutoShow**](#gt_42126923-0aed-4547-8761-95a0ce2badde). The **fAutoShow** field of the **SXVDEx record** (section [2.4.310](#sxvdex)) specifies whether a **simple filter** is applied for a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). The **fTopAutoShow** field of the **SXVDEx record** (section 2.4.310) specifies whether a **simple filter** applies to the top or bottom *n* items. The **citmAutoShow** field of the **SXVDEx record** (section 2.4.310) specifies the number of **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) displayed. + +**Simple filters** MUST only be applied to **pivot fields** (section 2.2.5.4.3) of a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) with **data functionality level** (section [2.2.5.2](#Section_2bcedd76ef064e6084c718ea55042ed6)) less than or equal to 2, or to **pivot fields** (section 2.2.5.4.3) of an **OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)) with the **fSrvSupportSubquery** field of the **SXAddl_SXCCache_SXDInfo12 record** (section [2.4.273.7](#sxaddl_sxccache_sxdinfo12)) of the corresponding **PivotCache** (section [2.2.5.3](#Section_a8496208d8334015938a56a0e97f9f0e)) equal to zero. + +##### PivotTable Axes + +A **PivotTable axis** is the set of **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) or **pivot hierarchies** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) in a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) used to populate an area of the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). The placement and positions of **pivot fields** (section 2.2.5.4.3) on the axes are used to determine the **PivotTable Layout** (section [2.2.5.4.10](#Section_2f81b5b422d546778ec53c5dc1ad80d4)). The four axes of a **PivotTable view** (section 2.2.5.4) are the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)), the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)), the **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)), and the **data axis** (section [2.2.5.4.9.5](#Section_4c5c2daa289746e1854b0ce04209f060)). For non- **OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)), a **pivot field** (section 2.2.5.4.3) MUST NOT appear more than once on the **PivotTable view** (section 2.2.5.4), with the exception of the **data axis** (section 2.2.5.4.9.5). For non-**OLAP** **PivotTable views** (section 2.2.5.4.2), a **pivot field** (section 2.2.5.4.3) can be placed one or more times on the **data axis** (section 2.2.5.4.9.5) independently of whether it was placed on any other axis. For **OLAP** **PivotTable views** (section 2.2.5.4.2), a **pivot field** (section 2.2.5.4.3) MUST NOT be placed more than once on any axis. For both [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) and non-**OLAP** **PivotTable views** (section 2.2.5.4.2), **pivot fields** (section 2.2.5.4.3) do not have to be placed on any **PivotTable axis**. + +###### Page Axis + +The **page axis** contains the **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) or **pivot hierarchies** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) that populate the **page area** (section [2.2.5.4.10.1.3](#Section_f10ef7d86c044d35a5830d6f2ce92063)) of the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)), as specified by **PivotTable Layout** (section [2.2.5.4.10](#Section_2f81b5b422d546778ec53c5dc1ad80d4)), and that are intended for use as [**filters**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). These **pivot fields** (section 2.2.5.4.3) and **pivot hierarchies** (section 2.2.5.4.5) do not affect the layout of the other areas of the **PivotTable report** (section 2.2.5), but rather filter the data used by the entire **PivotTable view** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)). + +The **page axis** is specified by the sequence of records that conform to the **PIVOTPI rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) and optionally by the collection of **SXPIEx records** (section [2.4.299](#sxpiex)) in the sequence of records that conform to the **PIVOTVIEWEX rule** (section 2.1.7.20.5). For non-**OLAP** **PivotTable views** (section 2.2.5.4.2), the **SXPI_Item structure** (section [2.5.260](#sxpi_item)) specified by each array element of the **rgsxpi** field of the **SXPI record** (section [2.4.298](#sxpi)) specifies one **pivot field** (section 2.2.5.4.3) on the page axis. For **OLAP** **PivotTable views** (section 2.2.5.4.2), each **SXPIEx record** (section 2.4.299) specifies one **pivot hierarchy** (section 2.2.5.4.5) on the **page axis**. The order of the **pivot fields** (section 2.2.5.4.3) and **pivot hierarchies** (section 2.2.5.4.5) in these collections for the non-[**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) and OLAP cases specifies the order in which the **pivot fields** (section 2.2.5.4.3) and **pivot hierarchies** (section 2.2.5.4.5) appear on the **page axis**. + +For non-**OLAP** **PivotTable views** (section 2.2.5.4.2), the **isxvd** field of the **SXPI_Item structure** (section 2.5.260) specifies the associated **pivot field** (section 2.2.5.4.3). For **OLAP** **PivotTable views** (section 2.2.5.4.2), the **isxth** field of the **SXPIEx record** (section 2.4.299) specifies the associated **pivot hierarchy** (section 2.2.5.4.5). + +####### Non-OLAP Page Filtering + +A non-**OLAP** **PivotTable view** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)) can be filtered to not include some **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) from the **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) on the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)). The **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) only includes values specified by **cache items** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)) that are associated with **pivot items** (section 2.2.5.4.4) that are filtered in. + +The following table specifies how the filtering of **pivot items** (section 2.2.5.4.4) of a **pivot field** (section 2.2.5.4.3) is specified. + +In the following table, the first column is the value of the **rgsxpi**.**isxvi** field of the **SXPI record** (section [2.4.298](#sxpi)), and the second column is the value of the **fSubtotalHiddenPageItems** field of the **SXEx record** (section [2.4.282](#sxex)). + +| Value of rgsxpi.isxvi | Value of fSubtotalHiddenPageItems | Filtering Behavior | +|----|----|----| +| Not 0x7FFD | Any | Specifies that the **rgsxpi**.**isxvi** field of the **SXPI record** (section 2.4.298) specifies a **pivot item** (section 2.2.5.4.4) index, as specified by the Pivot Items section, of the one **pivot item** (section 2.2.5.4.4) of a **pivot field** (section 2.2.5.4.3) that is filtered in. | +| 0x7FFD | 0 | Specifies that **pivot items** (section 2.2.5.4.4) are filtered in if and only if the **fHidden** field of the corresponding **SXVI records (**section [2.4.312](#sxvi)**)** is equal to 0. However, all **pivot items** (section 2.2.5.4.4) are factored into the subtotal. | +| 0x7FFD | 1 | Specifies that **pivot items** (section 2.2.5.4.4) are filtered in if and only if the **fHidden** field of the corresponding **SXVI records (**section 2.4.312**)** is equal to zero. Only **pivot items** (section 2.2.5.4.4) that are filtered in are factored into the subtotal. | + +####### OLAP Page Filtering + +In an **OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)) the filtering on the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)) is specified using the **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) that the **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) is associated with, as specified in the [Association of Pivot Hierarchies and Pivot Fields and Cache Fields](#Section_01a66b9be4a24396b55c28d6207fd28f) section. + +If the value of the **fEnableMultiplePageItems** field of the **SXTH record** (section [2.4.308](#sxth)) of the **pivot hierarchy** (section 2.2.5.4.5) is 0, the **stUnique** field of the **SXPIEx record** (section [2.4.299](#sxpiex)) specifies an [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) to filter by. + +If the value of the **fEnableMultiplePageItems** field of the **SXTH record** (section 2.4.308) of the **pivot hierarchy** (section 2.2.5.4.5) is 1, then the specification depends on the **PivotCache Functionality Level** (section [2.2.5.3.1](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8)) of the **associated PivotCache** (section [2.2.5.4.1](#Section_6f60301b107346d3b7ad0041566272a4)) of the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)), as specified in the following table: + +| PivotCache Functionality Level | Filtering Behavior | +|----|----| +| Less than 3 | Specifies that the **SXAddl_SXCHierarchy_SXDFilterMember records** (section [2.4.273.44](#sxaddl_sxchierarchy_sxdfiltermember)) of the **pivot hierarchy** (section 2.2.5.4.5) specify the OLAP members to filter by. | +| Greater than or equal to 3 | Specifies that the filtering is applied as specified by **Manual Filters** (section [2.2.5.4.7](#Section_b0b282651e334c86ad030f5693c1d1e4)) and **OLAP Manual Filters** (section [2.2.5.4.7.2](#Section_bd4665ebb56a44e690b9ceaf7ec55389)) for this **pivot hierarchy** (section 2.2.5.4.5). | + +###### Row Axis + +The **row axis** contains the **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) and an optional **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)) used to populate the **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)) of the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)), as specified by the [PivotTable Layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4) section. + +The **pivot fields** (section 2.2.5.4.3) on the **row axis** are specified by the first **SxIvd record** (section [2.4.292](#sxivd)) in the sequence of records that conform to the **PIVOTCORE rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) as defined by the Worksheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), which specifies an array of **SxIvdRw structures** (section [2.5.258](#sxivdrw)). The order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) are referenced from the **SxIvd record** (section 2.4.292) specifies the order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) display on the row axis. The order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) display on the row axis corresponds to the order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) are placed in the **row area** (section 2.2.5.4.10.1.1) of the **PivotTable report** (section 2.2.5). + +For adjacent **SxIvdRw structures** (section 2.5.258) in the **rgSxivd** field of the **SxIvd record** (section 2.4.292), the **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) that the first **SxIvdRw references** (section 2.5.258) is defined to be an outer field with respect to the **pivot field** (section 2.2.5.4.3) or the **data field** (section 2.2.5.4.9.5.2) that the second **SxIvdRw references** (section 2.5.258). The **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) that the second **SxIvdRw references** (section 2.5.258) is defined to be an inner field with respect to the **pivot field** (section 2.2.5.4.3) or the **data field** (section 2.2.5.4.9.5.2) that the first **SxIvdRw references** (section 2.5.258). + +For [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) **PivotTables** (section 2.2.5), all **SxIvdRw records** (section 2.5.258) in the **rgSxivd** field of the **SxIvd record** (section 2.4.292) that reference **pivot fields** (section 2.2.5.4.3) that are associated with the same **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) MUST be adjacent. **Pivot fields** (section 2.2.5.4.3) associated with **member properties** (section [2.2.5.4.6](#Section_e5db3a66677f43db8fb038584797c95f)) of the **pivot hierarchy** (section 2.2.5.4.5) MUST be located on the row axis after other types of **pivot fields** (section 2.2.5.4.3) associated with the same **pivot hierarchy** (section 2.2.5.4.5). **Pivot fields** (section 2.2.5.4.3) not associated with **member properties** (section 2.2.5.4.6) of the **pivot hierarchy** (section 2.2.5.4.5) MUST appear on the row axis in an order such that the zero-based ordinal of the [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of each **pivot field** (section 2.2.5.4.3) associated with the same **pivot hierarchy** (section 2.2.5.4.5) is ascending. The zero-based ordinal of the OLAP level of a **pivot field** (section 2.2.5.4.3) is specified by the **isxtl** field of the **SXVDTEx record** (section [2.4.311](#sxvdtex)). + +For OLAP **PivotTables** (section 2.2.5), the **SXTH record** (section [2.4.308](#sxth)) specifies information about a **pivot hierarchy** (section 2.2.5.4.5), including which axis the **pivot hierarchy** (section 2.2.5.4.5) is on. + +See the [Nesting](#Section_7268e3daa5474b95a707fdcfc9f68c64) section for more information. + +###### Column Axis + +The column axis contains the **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) and an optional **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)) used to populate the **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)) of the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)), as specified by the [PivotTable Layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4) section. + +The **pivot fields** (section 2.2.5.4.3) on the row axis are specified by the second **SxIvd record** (section [2.4.292](#sxivd)) in the sequence of records that conform to the **PIVOTCORE rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) as defined by the Worksheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), which specifies an array of **SxIvdCol structures** (section [2.5.257](#sxivdcol)). + +The order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) are referenced from the **SxIvd record** (section 2.4.292) specifies the order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) display on the column axis. The order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) display on the column axis corresponds to the order that the **pivot fields** (section 2.2.5.4.3) and the optional **data field** (section 2.2.5.4.9.5.2) are placed in the **column area** (section 2.2.5.4.10.1.2) of the **PivotTable report** (section 2.2.5). + +For adjacent **SxIvdCol structures** (section 2.5.257) in the **rgSxivd** field of the **SxIvd record** (section 2.4.292), the **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) that the first **SxIvdCol references** (section 2.5.257)is defined to be an outer field with respect to the **pivot field** (section 2.2.5.4.3) or the **data field** (section 2.2.5.4.9.5.2) that the second **SxIvdCol references** (section 2.5.257). The **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) that the second **SxIvdCol references** (section 2.5.257) is defined to be an inner field with respect to the **pivot field** (section 2.2.5.4.3) or the **data field** (section 2.2.5.4.9.5.2) that the first **SxIvdCol references** (section 2.5.257). + +For [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) **PivotTables** (section 2.2.5), all **SxIvdCol structures** (section 2.5.257) in the **rgSxivd** field of the **SxIvd record** (section 2.4.292) that reference **pivot fields** (section 2.2.5.4.3) that are associated with the same **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) MUST be adjacent. **Pivot fields** (section 2.2.5.4.3) associated with **member properties** (section [2.2.5.4.6](#Section_e5db3a66677f43db8fb038584797c95f)) of the **pivot hierarchy** (section 2.2.5.4.5) MUST be located on the column axis after other types of **pivot fields** (section 2.2.5.4.3) associated with the same **pivot hierarchy** (section 2.2.5.4.5). **Pivot fields** (section 2.2.5.4.3) not associated with **member properties** (section 2.2.5.4.6) of the **pivot hierarchy** (section 2.2.5.4.5) MUST appear on the column axis in an order such that the zero-based ordinal of the [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of each **pivot field** (section 2.2.5.4.3) associated with the same **pivot hierarchy** (section 2.2.5.4.5) is ascending. The zero-based ordinal of the OLAP level of a **pivot field** (section 2.2.5.4.3) is specified by the **isxtl** field of the **SXVDTEx record** (section [2.4.311](#sxvdtex)). + +For OLAP **PivotTables** (section 2.2.5), the **SXTH record** (section [2.4.308](#sxth)) specifies information about a **pivot hierarchy** (section 2.2.5.4.5), including which axis the **pivot hierarchy** (section 2.2.5.4.5) is on. + +See the [Nesting](#Section_7268e3daa5474b95a707fdcfc9f68c64) section for more information. + +###### Nesting + +This section applies to both the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)) and **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)) unless otherwise specified. Within this section, axis means the **row axis** (section 2.2.5.4.9.2) or the **column axis** (section 2.2.5.4.9.3) as appropriate; fields means **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)), the **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)), or both on the axis; area means the in **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)) and **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)) as appropriate; items means **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) or **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) as appropriate. + +The axes specify an order that the fields are represented in the areas, see the [PivotTable layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4) section for more information about the areas. **Pivot lines** (section [2.2.5.4.10.3](#Section_76610990666f492791b6d2280f607464)) within the areas have references to items. Usually a **pivot line** (section 2.2.5.4.10.3) including an item of an outer field only includes items in the inner fields that exist with the item of the outer field in the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)), subject to the filtering on the PivotTable view. Usually all the instances of an item in the area are grouped together, with grouping on the outer fields taking precedence over grouping on the inner fields. This process is called **nesting**. + +A nested item group is specified to be the contiguous set of **pivot lines** (section 2.2.5.4.10.3) that have the same item in an outer field. + +The following example shows nested item groups for Country, State and City. + +| Country | State | City | +|---------|-----------|-------------| +| USA | Illinois | Chicago | +| USA | Illinois | Springfield | +| USA | Louisiana | New Orleans | +| USA | Louisiana | Baton Rouge | +| Mexico | Jalisco | Guadalajara | + +The first two lines are a nested item group for Illinois. The next two lines are a nested item group for Louisiana. The first four lines are a nested item group for USA. The last line is both a nested item group for Jalisco and Mexico. Note that often in a **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) the repeated item labels will be omitted. + +For an [**OLAP PivotTable view**](#Section_bbdb91f53cc644e4a812d5e06c977f6f) (section 2.2.5.4.2), nesting can be the result of either: + +- Items in the inner field that are in a different **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)), or, + +- Items in an inner pivot field that is associated with the same **pivot hierarchy** (section 2.2.5.4.5) and that are child OLAP members. + +####### Collapsing + +Settings in the file format can specify that a **pivot item** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) of an outer **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)), rather than having inner nested **pivot items** (section 2.2.5.4.4) of inner **pivot fields** (section 2.2.5.4.3), is collapsed. Usually when a **pivot item** (section 2.2.5.4.4) on an outer **pivot field** (section 2.2.5.4.3) is collapsed, it does not have a nested **pivot item** (section 2.2.5.4.4) group and when it appears in a **pivot line** (section [2.2.5.4.10.3](#Section_76610990666f492791b6d2280f607464)), the **pivot items** (section 2.2.5.4.4) of the inner **pivot fields** (section 2.2.5.4.3) for the collapsed **pivot item** (section 2.2.5.4.4) do not appear in the **pivot line** (section 2.2.5.4.10.3). + +If Illinois and Mexico were collapsed in the preceding table, the result might look like the following table. + +| Country | State | City | +|---------|-----------|-------------| +| USA | Illinois | | +| USA | Louisiana | New Orleans | +| USA | Louisiana | Baton Rouge | +| Mexico | | | + +For a non-**OLAP** **PivotTable view** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)), the collapsed state is specified by the **fHideDetail** field of the **SXVI record** (section [2.4.312](#sxvi)). + +For an **OLAP** **PivotTable views**(section 2.2.5.4.2), there are two types of collapsing: child **collapsing** and [**attribute hierarchy**](#gt_8f75d668-e8c6-4f42-ba44-d90604d3b9dc) **collapsing**. + +Child **collapsing** is when the child **pivot items** (section 2.2.5.4.4), corresponding to child [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32), of a **pivot item** (section 2.2.5.4.4) corresponding to a parent OLAP member in an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) are not shown. + +If a **pivot field** (section 2.2.5.4.3) is the first **pivot field** (section 2.2.5.4.3) of the **pivot hierarchy** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) on the axis then the **fDrilledLevel** field of the **SXVDTEx record** (section [2.4.311](#sxvdtex)) **pivot field** (section 2.2.5.4.3) MUST be 1. + +If a **pivot field** (section 2.2.5.4.3) is not the first **pivot field** (section 2.2.5.4.3) of the **pivot hierarchy** (section 2.2.5.4.5) on the axis and if the **fDrilledLevel** field of the **SXVDTEx record** (section 2.4.311)of the **pivot field** (section 2.2.5.4.3) is 1, then there is no child collapsing for the preceding **pivot field** (section 2.2.5.4.3) of the **pivot hierarchy** (section 2.2.5.4.5) on the axis and the **fDrilledMember** field of the **SXVIFlags structure** (section [2.5.263](#sxviflags)) for the **pivot items** (section 2.2.5.4.4) of the preceding **pivot field** (section 2.2.5.4.3) of the **pivot hierarchy** (section 2.2.5.4.5) on the axis MUST be 0. If a **pivot field** (section 2.2.5.4.3) is followed by another **pivot field** (section 2.2.5.4.3) of the same **pivot hierarchy** (section 2.2.5.4.5) on the axis, and the **fDrilledLevel** field of the **SXVDTEx record** (section 2.4.311) of the inner **pivot field** (section 2.2.5.4.3) is equal to 0 and the **fDrilledMember** field of the **SXVIFlags structure** (section 2.5.263) of the **pivot item** (section 2.2.5.4.4) of the outer **pivot field** (section 2.2.5.4.3) is 0, then the **pivot item** (section 2.2.5.4.4) associated with the **SXVIFlags structure** (section 2.5.263) is collapsed using child **collapsing**. + +Attribute hierarchy **collapsing** only occurs when a **pivot field** (section 2.2.5.4.3) is associated with a **pivot hierarchy** (section 2.2.5.4.5) that is an attribute hierarchy and the **pivot field** (section 2.2.5.4.3) immediately following that outer **pivot field** (section 2.2.5.4.3) is associated with a different **pivot hierarchy** (section 2.2.5.4.5) that is an attribute hierarchy. In that case, if a **pivot item** (section 2.2.5.4.4) is attribute hierarchy collapsed, **pivot items** (section 2.2.5.4.4), corresponding to OLAP members, will not be shown for the inner **pivot field** (section 2.2.5.4.3). The attribute hierarchy collapsed state of a **pivot item** (section 2.2.5.4.4) is specified by the **fCollapsedMember** flag of the **SXVIFlags structure** (section 2.5.263). The **fItemsDrilledByDefault** flag of the **SXVDTEx record** (section 2.4.311) provides a default value for **pivot items** (section 2.2.5.4.4) in the **pivot field** (section 2.2.5.4.3). + +For an **OLAP** **PivotTable view** (section 2.2.5.4.2), there can be **pivot items** (section 2.2.5.4.4) for an inner **pivot field** (section 2.2.5.4.3) on the **pivot line** (section 2.2.5.4.10.3) if either the outer **pivot field** (section 2.2.5.4.3) is collapsed and the inner **pivot field** (section 2.2.5.4.3) and outer **pivot field** (section 2.2.5.4.3) are in different **pivot hierarchies** (section 2.2.5.4.5) and attribute hierarchy **collapsing** is not being used or if the **pivot items** (section 2.2.5.4.4) are **member properties** (section [2.2.5.4.6](#Section_e5db3a66677f43db8fb038584797c95f)). + +####### Subtotalling + +A nested item group, as specified in the [Nesting](#Section_7268e3daa5474b95a707fdcfc9f68c64) section, can have summaries of the values for the items in the nested item group, called subtotals. A subtotal is typically an aggregation such as a sum, count or average of the values of the items. + +The creation of subtotals is specified by the **fDefault**, **fSum**, **fCounta**, **fAverage**, **fMax**, **fMin**, **fProduct**, **fCount**, **fStdev**, **fStdevp**, **fVariance** and **fVariancep** fields of the **Sxvd record** (section [2.4.309](#sxvd)) of the **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)). If none of the fields are equal to 1, then no subtotals exist for the **pivot field** (section 2.2.5.4.3). If the **fDefault** field is equal to 1 the subtotal calculation for each item is done according to the [**aggregation functions**](#gt_f9b44a9d-68c4-4a28-b347-cce9eb5f8845) of the **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) on the **data axis** (section [2.2.5.4.9.5](#Section_4c5c2daa289746e1854b0ce04209f060)), as specified by the **iiftab** field of the **SXDI record** (section [2.4.278](#sxdi)) for each **data item** (section 2.2.5.4.9.5.1). + +For example, the subtotal is calculated as the sum of the relevant values of the nested item group for a **data item** (section 2.2.5.4.9.5.1) with a sum aggregation function and subtotal is calculated as the average of the relevant values of the nested item group for a **data item** (section 2.2.5.4.9.5.1) with an average aggregation function. + +The other subtotal fields are called custom subtotals because they override the **data item** (section 2.2.5.4.9.5.1) aggregation function when calculating subtotals. + +In some cases, such as for certain **OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)), the **source data** (section [2.2.5.3.2](#Section_e65bff19ea464f3b9798d8d2db9202b4)) is not able to provide a requested subtotal. + +The **fOutline** field of the **SXVDEx record** (section [2.4.310](#sxvdex)) specifies that an extra **pivot line** (section [2.2.5.4.10.3](#Section_76610990666f492791b6d2280f607464)) is added at the logical top of the nested item groups if the **pivot field** (section 2.2.5.4.3) is on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)). This **pivot line** (section 2.2.5.4.10.3) contains the item and any items of **member properties** (section [2.2.5.4.6](#Section_e5db3a66677f43db8fb038584797c95f)) **pivot fields** (section 2.2.5.4.3), if they are shown, but no other items for inner **pivot fields** (section 2.2.5.4.3) of this **pivot field** (section 2.2.5.4.3). + +The **fOutlineData** field of the **SXAddl_SXCView_SXDVer12Info record** (section [2.4.273.109](#sxaddl_sxcview_sxdver12info)) specifies that an extra **pivot line** (section 2.2.5.4.10.3) is added at the logical top of the nested item groups if the **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)) is on the **row axis** (section 2.2.5.4.9.2). This **pivot line** (section 2.2.5.4.10.3) contains the **data item** (section 2.2.5.4.9.5.1), but no other items for inner **pivot fields** (section 2.2.5.4.3) of this **data field** (section 2.2.5.4.9.5.2). + +If the **fDefault** field of the **Sxvd record** (section 2.4.309) of the **pivot field** (section 2.2.5.4.3) is equal to 1, the **fOutline** field of the **SXVDEx record** (section 2.4.310) of the **pivot field** (section 2.2.5.4.3) is equal to 1, the **pivot field** (section 2.2.5.4.3) is on the **row axis** (section 2.2.5.4.9.2), and the **data field** (section 2.2.5.4.9.5.2) is not placed inner of the **pivot field** (section 2.2.5.4.3) on the **row axis** (section 2.2.5.4.9.2), then the following is specified for the **fSubtotalAtTop** field of the **SXVDEx record** (section 2.4.310) of the **pivot field** (section 2.2.5.4.3): + +| Value of fSubtotalAtTop | Meaning | +|----|----| +| 0x0 | Specifies that subtotal **pivot lines** (section 2.2.5.4.10.3) are added at the bottom of the nested item groups. See the **subName.stSubName** field of the **SXVDEx record** (section 2.4.310) for details of the label used. | +| 0x1 | Specifies that the **pivot lines** (section 2.2.5.4.10.3) added as specified by the **fOutline** flag of the **SXVDEx record** (section 2.4.310) being equal to 1 are used for displaying the subtotals in the **data area** (section [2.2.5.4.10.1.4](#Section_237a24905c614931923f7ee856f23c72)). | + +In the following figure, the Category, Subcategory, and Product columns represent **pivot fields** (section 2.2.5.4.3) on the **row axis** (section 2.2.5.4.9.2) and the Color column represents a **member properties** (section 2.2.5.4.6) **pivot field** (section 2.2.5.4.3) associated with the Product **pivot field** (section 2.2.5.4.3). Subtotals are displayed at the logical top of the nested item groups for Clothing, Caps, and Gloves. + +![PivotTable report with Category and Subcategory pivot fields with fOutline and fSubtotalAtTop fields of the SXVDEx record equal to 1](media/image14.bin "PivotTable report with Category and Subcategory pivot fields with fOutline and fSubtotalAtTop fields of the SXVDEx record equal to 1") + +Figure 14: PivotTable report with Category and Subcategory pivot fields with fOutline and fSubtotalAtTop fields of the SXVDEx record equal to 1 + +###### Data Axis + +The **data axis** contains the **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) values that are used to populate the **data area** (section [2.2.5.4.10.1.4](#Section_237a24905c614931923f7ee856f23c72)) of the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) as specified by the [PivotTable Layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4) section. The **data axis** also specifies additional information related to summarizing and presenting the values as specified by the [Data Items](#Section_b51aa7b309b34aa78cb4964ad24d1679) section. The **data axis** is specified by the collection of **SXDI records** (section [2.4.278](#sxdi)) that conform to the **PIVOTCORE rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) as defined by the Worksheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +####### Data Items + +A **data item** is a **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) placed on the **data axis** (section [2.2.5.4.9.5](#Section_4c5c2daa289746e1854b0ce04209f060)). Each **data item** is specified by an **SXDI record** (section [2.4.278](#sxdi)). + +The **isxvdData** field of the **SXDI record** (section 2.4.278) specifies a reference to the **pivot field** (section 2.2.5.4.3) that is associated with a **data item**. It also specifies additional information that is used to produce or present summarized values. + +A **data item** can be referenced by a data item index, which is the zero-based index of an **SXDI record** (section 2.4.278) in the sequence of records that conforms to the **PIVOTCORE rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) as defined by the Worksheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +####### Data Field + +The **data field** is a conceptual field that represents all **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) and enables them to be referenced as a single object. The **data field** is intended to enable all **data items** (section 2.2.5.4.9.5.1) to be placed on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)) or **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)). + +If the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) has more than one **data item** (section 2.2.5.4.9.5.1), then the **data field** MUST be located on either the **row axis** (section 2.2.5.4.9.2) as specified by the **rgSxivd** field of the first **SxIvd record** (section [2.4.292](#sxivd)), or the **column axis** (section 2.2.5.4.9.3) as specified by the **rgSxivd** field of the second **SxIvd record** (section 2.4.292). + +##### PivotTable Layout + +The **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) in the [**sheet (2)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) has four main areas: the **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)), the **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)), the **data area** (section [2.2.5.4.10.1.4](#Section_237a24905c614931923f7ee856f23c72)), and the **page area** (section [2.2.5.4.10.1.3](#Section_f10ef7d86c044d35a5830d6f2ce92063)). + +![PivotTable report illustrating the four different areas](media/image15.bin "PivotTable report illustrating the four different areas") + +Figure 15: PivotTable report illustrating the four different areas + +All the records described here MUST exist in the same **worksheet substream** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). + +###### Location and Body + +The **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)) is located immediately above the **data area** (section [2.2.5.4.10.1.4](#Section_237a24905c614931923f7ee856f23c72)). The [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the **column area** (section 2.2.5.4.10.1.2) containing the **pivot item** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) [**caption**](#gt_81d81412-1575-4084-ba61-742de406b418) or **data item** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)) caption to the farthest [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) is in the same column as the [**logical top-left**](#gt_88b25c47-61c2-44de-abb0-12ea3348a412) cell of the **data area** (section 2.2.5.4.10.1.4). + +The **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)) is located immediately to the logical left of the **data area** (section 2.2.5.4.10.1.4). The cell in the **row area** (section 2.2.5.4.10.1.1) containing the top-most **pivot item** (section 2.2.5.4.4) caption or **data item** (section 2.2.5.4.9.5.1) caption is in the same row as the logical top-left cell of the **data area** (section 2.2.5.4.10.1.4). + +The **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) body is the rectangular area defined by the union of the **row area** (section 2.2.5.4.10.1.1), **column area** (section 2.2.5.4.10.1.2), and **data area** (section 2.2.5.4.10.1.4). + +The **page area** (section [2.2.5.4.10.1.3](#Section_f10ef7d86c044d35a5830d6f2ce92063)), if it is not empty, is located above the **PivotTable report** (section 2.2.5) body. There is one row between the top-most cell of the **PivotTable report** (section 2.2.5) body and the bottom-most cell of the **page area** (section 2.2.5.4.10.1.3). + +The **PivotTable report** (section 2.2.5) is a [**non-contiguous range**](#gt_3c4e66c6-ccfd-405c-ad82-5d30098d09d6) containing the union of the **PivotTable report** (section 2.2.5) body and the **page area** (section 2.2.5.4.10.1.3). + +An [SxView](#sxview) record and the **SXEx record** (section [2.4.282](#sxex)) specify details about the location of the **PivotTable report** (section 2.2.5) in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and the sizes of the areas of the **PivotTable report** (section 2.2.5) as specified by the following. All fields are of the **SxView record** (section 2.4.313) unless otherwise specified. + +The **column area** (section 2.2.5.4.10.1.2) of the **PivotTable report** (section 2.2.5) is specified to be the following range of cells: + +| Column Area | Row or Column Index | +|----------------------|---------------------| +| Top row | **ref.rwFirst** | +| Bottom row | **rwFirstData** – 1 | +| Logical left column | **colFirstData** | +| Logical right column | **ref.colLast** | + +If **colFirstData** is greater than **ref**.**colLast**, the **column area** (section 2.2.5.4.10.1.2) does not exist for this **PivotTable report** (section 2.2.5). + +The **row area** (section 2.2.5.4.10.1.1) of the **PivotTable report** (section 2.2.5) is specified to be the following range of cells: + +| Row Area | Row or Column Index | +|----------------------|----------------------| +| Top row | **rwFirstData** | +| Bottom row | **ref.rwLast** | +| Logical left column | **ref.colFirst** | +| Logical right column | **colFirstData** – 1 | + +If **colFirstData** – 1 is less than **ref.colFirst**, the **row area** (section 2.2.5.4.10.1.1) does not exist for this **PivotTable report** (section 2.2.5). + +The **data area** (section 2.2.5.4.10.1.4) of the **PivotTable report** (section 2.2.5) is specified to be the following range of cells: + +| Data Area | Row or Column Index | +|----------------------|---------------------| +| Top row | **rwFirstData** | +| Bottom row | **ref.rwLast** | +| Logical left column | **colFirstData** | +| Logical right column | **ref.colLast** | + +If the **row area** (section 2.2.5.4.10.1.1) or the **column area** (section 2.2.5.4.10.1.2) does not exist for this **PivotTable report** (section 2.2.5), the **data area** (section 2.2.5.4.10.1.4) does not exist for this **PivotTable report** (section 2.2.5). + +The **page area** (section 2.2.5.4.10.1.3) of the **PivotTable report** (section 2.2.5) is specified to be the following range of cells. The **cRwPage** field and the **cColPage** field are of the **SXEx record** (section 2.4.282): + +| Page Area | Row or Column Index | +|----------------------|-------------------------------------| +| Top row | **ref.rwFirst** – **cRwPage** – 1 | +| Bottom row | **ref.rwFirst** – 2 | +| Logical left column | **ref.colFirst** | +| Logical right column | **ref.colFirst** + **cColPage** – 1 | + +If the **cRwPage** field of the **SXEx record** (section 2.4.282) is equal to 0 and the **fNewDropZones** field of the **SXAddl_SXCView_SXDVer12Info record** (section [2.4.273.109](#sxaddl_sxcview_sxdver12info)) is equal to 1 the **page area** (section 2.2.5.4.10.1.3) does not exist for this **PivotTable report** (section 2.2.5). + +If the **cRwPage** field is equal to 0 and the **fNewDropZones** field is equal to 0, then the **page area** (section 2.2.5.4.10.1.3) of the **PivotTable report** (section 2.2.5) is specified to be the following [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells: + +| Page Area | Row or Column Index | +|----------------------|---------------------| +| Top row | **ref.rwFirst** - 2 | +| Bottom row | **ref.rwFirst** - 2 | +| Logical left column | **ref.colFirst** | +| Logical right column | **ref.colLast** | + +####### Row Area + +The **row area** contains **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)), the optional **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)), or both that are placed on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)), along with associated **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) and **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)). The first row of the **row area** can contain **pivot field** (section 2.2.5.4.3) captions, **data field** (section 2.2.5.4.9.5.2) captions, or both as specified by the **fNoHeaders** field of the **SXAddl_SXCView_SXDVer12Info record** (section [2.4.273.109](#sxaddl_sxcview_sxdver12info)). If the **fNoHeaders** field of the **SXAddl_SXCView_SXDVer12Info record** (section 2.4.273.109) is equal to 0 or the **SXAddl_SXCView_SXDVer12Info record** (section 2.4.273.109) is not present, the **pivot field** (section 2.2.5.4.3) and **data field** (section 2.2.5.4.9.5.2) captions are located above their **pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1). + +**Pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) of the **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) that has a position of 0 on the **row axis** (section 2.2.5.4.9.2) are placed in the first column of the **row area**. For every other **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) on the **row axis** (section 2.2.5.4.9.2), placement of **pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) are calculated as follows: + +- If the previous **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) is not in [**compact axis**](#gt_87303118-9ef7-437d-914a-2ad9964b5e81) mode, then **pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) of the current **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) are placed in the next column of the **row area**. **Pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) are grouped by the parent **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1), which is the **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1) on the immediate [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d). To achieve this, **pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) of the parent **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) can be repeated multiple times. In this case, when **pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) are repeated, the caption is not necessarily displayed in every [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that contains a **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1). For more details, see the [Pivot Lines](#Section_76610990666f492791b6d2280f607464) section. + +- If the previous **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) is in compact axis mode, then the **pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) of the current **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) are placed in the same column as **pivot items** (section 2.2.5.4.4) of the previous **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2). **Pivot items** (section 2.2.5.4.4) or **data items** (section 2.2.5.4.9.5.1) are grouped by the parent **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1) and placed immediately under the parent **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1). + +For the **data field** (section 2.2.5.4.9.5.2), if the **fCompactData** field and the **fOutlineData** field of the **SXAddl_SXCView_SXDVer12Info record** (section 2.4.273.109) are equal to 1, this specifies that the **data field** (section 2.2.5.4.9.5.2) is in compact axis mode. If the **SXAddl_SXCView_SXDVer12Info** (section 2.4.273.109) is not present, the **data field** (section 2.2.5.4.9.5.2) is not in compact axis mode. + +For **pivot fields** (section 2.2.5.4.3), if the **fCompact** flag on the **SXAddl_SXCField12_SXDVer12Info record** (section [2.4.273.33](#sxaddl_sxcfield12_sxdver12info)) is equal to 1 and **fOutline** field of the [SXVDEx](#sxvdex) record is equal to 1, this specifies that the **pivot field** (section 2.2.5.4.3) is in compact axis mode. If the **SXAddl_SXCField12_SXDVer12Info record** (section 2.4.273.33) is not present, the **pivot field** (section 2.2.5.4.3) is not in compact axis mode. + +The **row area** can have special entries at the end for [**grand totals**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7). If there are no **pivot fields** (section 2.2.5.4.3) and no **data field** (section 2.2.5.4.9.5.2) on the **row axis** (section 2.2.5.4.9.2), then the **row area** is empty. + +####### Column Area + +The **column area** contains **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)), the optional **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)), or both placed on the **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)), along with associated **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) or **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)). The first row of the **column area** can contain **pivot field** (section 2.2.5.4.3) captions, **data field** (section 2.2.5.4.9.5.2) captions, or both as specified by the **fNoHeaders** field of the **SXAddl_SXCView_SXDVer12Info record** (section [2.4.273.109](#sxaddl_sxcview_sxdver12info)). + +If the **fNoHeaders** field of the **SXAddl_SXCView_SXDVer12Info record** (section 2.4.273.109) is equal to 0, and no **pivot fields** (section 2.2.5.4.3) are in [**compact axis**](#gt_87303118-9ef7-437d-914a-2ad9964b5e81) mode, and the **data field** (section 2.2.5.4.9.5.2) is not in compact axis mode, then the **pivot field** (section 2.2.5.4.3) and **data field** (section 2.2.5.4.9.5.2) captions are placed sequentially in [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) of the first row of the **column area** according to their placement on the **column axis** (section 2.2.5.4.9.3). + +If the **fNoHeaders** field of the **SXAddl_SXCView_SXDVer12Info record** (section 2.4.273.109) is equal to 0, and any **pivot field** (section 2.2.5.4.3) is in compact axis mode or the **data field** (section 2.2.5.4.9.5.2) is in compact axis mode, the **pivot field** (section 2.2.5.4.3) and **data field** (section 2.2.5.4.9.5.2) captions are placed in the top [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) cell of the **column area**. + +For the **data field** (section 2.2.5.4.9.5.2), if the **fCompactData** field and the **fOutlineData** field of the **SXAddl_SXCView_SXDVer12Info record** (section 2.4.273.109) are equal to 1, this specifies that the **data field** (section 2.2.5.4.9.5.2) is in compact axis mode. If the **SXAddl_SXCView_SXDVer12Info record** (section 2.4.273.109) is not present, the **data field** (section 2.2.5.4.9.5.2) is not in compact axis mode. + +For **pivot fields** (section 2.2.5.4.3), if the **fCompact** flag on the **SXAddl_SXCField12_SXDVer12Info record** (section [2.4.273.33](#sxaddl_sxcfield12_sxdver12info)) is equal to 1 and **fOutline** field of the [SXVDEx](#sxvdex) record is equal to 1, this specifies that the **pivot field** (section 2.2.5.4.3) is in compact axis mode. If the **SXAddl_SXCField12_SXDVer12Info record** (section 2.4.273.33) is not present, the **pivot field** (section 2.2.5.4.3) is not in compact axis mode. + +The second row in the **column area** contains **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1) labels for the **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) placed first on the **column axis** (section 2.2.5.4.9.3), and each subsequent row contains the **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1) labels for **pivot fields** (section 2.2.5.4.3) or **data fields** (section 2.2.5.4.9.5.2) that occur later on the **column axis** (section 2.2.5.4.9.3). The row containing **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1) labels for the **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) at position *n* is row (*n* +1) of the **column area**. + +If the **fNoHeaders** field is equal to 1, the **pivot field** (section 2.2.5.4.3) and **data field** (section 2.2.5.4.9.5.2) captions are not displayed. The row containing **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1) labels for the **pivot field** (section 2.2.5.4.3) or **data field** (section 2.2.5.4.9.5.2) at position *n* on the **column axis** (section 2.2.5.4.9.3) is row *n* of the **column area**. + +The **column area** can have special entries at the end for [**grand totals**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7). + +####### Page Area + +The **page area** contains **pivot fields** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) that are placed on the **page axis** (section [2.2.5.4.9.1](#Section_ff63f3d9274542878e6e11120ecf30b7)) for non-**OLAP** **PivotTable views** (section [2.2.5.4.2](#Section_bbdb91f53cc644e4a812d5e06c977f6f)) and **pivot hierarchies** (section [2.2.5.4.5](#Section_54818c671590494084e0c3ff8b433c33)) that are placed on the **page axis** (section 2.2.5.4.9.1) for **OLAP** **PivotTable views** (section 2.2.5.4.2). For each **pivot field** (section 2.2.5.4.3) or **pivot hierarchy** (section 2.2.5.4.5) on the **page axis** (section 2.2.5.4.9.1), the page area contains a caption and information about the current filtering associated with the **pivot field** (section 2.2.5.4.3) or **pivot hierarchy** (section 2.2.5.4.5) in the next [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) at the [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7). The relative position of pairs of caption and filtering information is specified by the **SxView record** (section [2.4.313](#sxview)) and the **SXEx record** (section [2.4.282](#sxex)). For more details, see the [Location and Body](#Section_7f7d9d76a55041d9ae9f0d8539cc09f8) section. + +####### Data Area + +The **data area** contains summarized values for the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). [**Cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the **data area** contain summarized values for associated **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)). The summarized value in a cell is restricted by all the **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)) in the **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)) that are located in the same column, by all the **pivot items** (section 2.2.5.4.4) in the **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)) that are located in the same row, and by any page filter applied, as specified in the [Page Axis](#Section_ff63f3d9274542878e6e11120ecf30b7) section. + +If the **row area** (section 2.2.5.4.10.1.1) has a [**grand total**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7), then the value in that row is not restricted by **pivot items** (section 2.2.5.4.4) from the **row area** (section 2.2.5.4.10.1.1). If the **column area** (section 2.2.5.4.10.1.2) has a grand total, then the value in that column is not restricted by **pivot items** (section 2.2.5.4.4) from the **column area** (section 2.2.5.4.10.1.2). If the **PivotTable view** (section 2.2.5.4) has more than one **data item** (section 2.2.5.4.9.5.1), then the associated **data item** (section 2.2.5.4.9.5.1) is the one that is located in the same column in the **column area** (section 2.2.5.4.10.1.2) or the same row in the **row area** (section 2.2.5.4.10.1.1) as the cell with the summarized value. + +If a **PivotTable view** (section 2.2.5.4) has zero **data items** (section 2.2.5.4.9.5.1) then the **data area** is empty. + +###### Truncation + +When a **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)) does not fit within the boundaries of the [**sheet (2)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) it is truncated from the [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) and the bottom. It is truncated such that a part of the **PivotTable report** (section 2.2.5) is displayed within the sheet boundaries. + +###### Pivot Lines + +A **pivot line** specifies a collection of **pivot line entries** (section [2.2.5.4.10.4](#Section_ecba812f4a31495ebeb46749e5897f2d)) for a single row or column in the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). + +A **pivot line** in the **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)) is the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) defined by the intersection of: + +- A column. + +- A set of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the **column area** (section 2.2.5.4.10.1.2). These are cells that contain **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)), **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)), blank cells, or a [**grand total**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7). + +A **pivot line** in the **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)) is the range defined by the intersection of: + +- A row. + +- A set of cells in the **row area** (section 2.2.5.4.10.1.1). These are cells that contain **pivot items** (section 2.2.5.4.4), **data items** (section 2.2.5.4.9.5.1), blank cells, or a grand total. + +A **pivot line** is specified by a sequence of records that conforms to the **PIVOTLI rule** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)). If either the **cRw** field or the **cCol** field of the associated **SxView record** (section [2.4.313](#sxview)) is greater than 0, then two **PIVOTLI rules** (section 2.1.7.20.5) MUST exist in the sequence of records that conforms to the **PIVOTCORE rule** (section 2.1.7.20.5), otherwise a **PIVOTLI rule** (section 2.1.7.20.5) MUST NOT exist in the **PIVOTCORE rule** (section 2.1.7.20.5). + +If **PIVOTLI rules** (section 2.1.7.20.5) for a **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)) exist, the first **PIVOTLI rule** (section 2.1.7.20.5) specifies the collection of **pivot lines** for the **row area** (section 2.2.5.4.10.1.1). The order of the **SXLIItem structures** (section [2.5.259](#sxliitem)) in the **rgsxli** field of the **SXLI record** (section [2.4.293](#sxli)) specifies the top to bottom order of the **pivot lines** of the **row area** (section 2.2.5.4.10.1.1). + +If **PIVOTLI rules** (section 2.1.7.20.5) for a **PivotTable view** (section 2.2.5.4) exist, the second **PIVOTLI rule** (section 2.1.7.20.5) specifies the collection of **pivot lines** for the **column area** (section 2.2.5.4.10.1.2). The order of the **SXLIItem structures** (section 2.5.259) in the **rgsxli** field of the **SXLI record** (section 2.4.293) specifies the [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) to [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) order of the **pivot lines** of the **column area** (section 2.2.5.4.10.1.2). + +Each individual **pivot line** is specified by an **SXLIItem structure** (section 2.5.259) in the **rgsxli** field of the associated **SXLI record** (section 2.4.293). Each **pivot line** contains a number of **pivot line entries** (section 2.2.5.4.10.4). **Pivot line entries** (section 2.2.5.4.10.4) are specified by the **rgisxvi** field of the **SXLIItem structure** (section 2.5.259). + +The first **pivot line** in the **row area** (section 2.2.5.4.10.1.1) or the **column area** (section 2.2.5.4.10.1.2) MUST have a **cSic** field of its associated **SXLIItem structure** (section 2.5.259) equal to 0. + +The following shows an example of a **PivotTable report** (section 2.2.5) and the pivot lines corresponding to each row in the **row area** (section 2.2.5.4.10.1.1). + +![PivotTable and a table illustrating each pivot line](media/image16.bin "PivotTable and a table illustrating each pivot line") + +Figure 16: PivotTable and a table illustrating each pivot line + +###### Pivot Line Entries + +**Pivot line entries** specify references to the **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)), **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)), or blank items of a **pivot line** (section [2.2.5.4.10.3](#Section_76610990666f492791b6d2280f607464)). **Pivot line entries** are specified by the records that conform to the **PIVOTLI rules** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) in the **PIVOTCORE rule** (section 2.1.7.20.5). A **pivot line entry** is an element in the array specified by the **rgisxvi** field of the **SXLIItem structure** (section [2.5.259](#sxliitem)). + +All **pivot line entries** that have an index less than the value specified by the **cSic** field of the **SXLIItem structure** (section 2.5.259) of a given **pivot line** (section 2.2.5.4.10.3) are identical to those of the **pivot line** (section 2.2.5.4.10.3) preceding the given **pivot line** (section 2.2.5.4.10.3). + +For the purposes of the rest of this section, *n* specifies a position of the **pivot line entry** of a given **pivot line** (section 2.2.5.4.10.3). + +If the value of *n* is less than the **cSic** field of the **SXLIItem structure** (section 2.5.259) of a given **pivot line** (section 2.2.5.4.10.3), then the **pivot line entry** at position *n* is identical to the corresponding **pivot line entry** of the **pivot line** (section 2.2.5.4.10.3) preceding the given **pivot line** (section 2.2.5.4.10.3). + +If the value of *n* is greater than or equal to the **cSic** field of the **SXLIItem structure** (section 2.5.259) of a given **pivot line** (section 2.2.5.4.10.3), then the value of *n* is equal to the sum of the **cSic** field of the **SXLIItem structure** (section 2.5.259) and the current index in the **rgisxvi** field of the **SXLIItem structure** (section 2.5.259) of the given **pivot line** (section 2.2.5.4.10.3). + +If a **pivot line entry** is in a **pivot line** (section 2.2.5.4.10.3) in the **row area** (section [2.2.5.4.10.1.1](#Section_5594c95e6819461e80706f4b4fdfa091)), each **pivot line entry** at a position *n* specifies a **pivot item** (section 2.2.5.4.4) index of a **pivot item** (section 2.2.5.4.4) in the *n*th **pivot field** (section [2.2.5.4.3](#Section_1edf7f2294084945b2de56526c14fca5)) on the **row axis** (section [2.2.5.4.9.2](#Section_3f46e7207706400cba9473cb829f869a)) or specifies a **data item** (section 2.2.5.4.9.5.1) index, if the *n*th field of the **row axis** (section 2.2.5.4.9.2) is the **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)). + +If a **pivot line entry** is in a **pivot line** (section 2.2.5.4.10.3) in the **column area** (section [2.2.5.4.10.1.2](#Section_03aced8c25864e83982a1e3551a563d6)), each pivot line entry at a position *n* specifies the **pivot item** (section 2.2.5.4.4) index of a **pivot item** (section 2.2.5.4.4) in the *n*th **pivot field** (section 2.2.5.4.3) on the **column axis** (section [2.2.5.4.9.3](#Section_00d9d88b8fa74bf08446584bf651677f)) or specifies a **data item** (section 2.2.5.4.9.5.1) index, if the *n*th field on the **column area** (section 2.2.5.4.10.1.2) is the **data field** (section 2.2.5.4.9.5.2). + +If the *n*th **pivot field** (section 2.2.5.4.3) on the **row axis** (section 2.2.5.4.9.2) or **column axis** (section 2.2.5.4.9.3) is the **data field** (section 2.2.5.4.9.5.2), the **pivot line entry** is a **data items** (section 2.2.5.4.9.5.1) index, as specified by the Data Items section. + +**Pivot items** (section 2.2.5.4.4) are specified sequentially from [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) to [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) for row **pivot lines** (section 2.2.5.4.10.3), and from top to bottom for column **pivot lines** (section 2.2.5.4.10.3). + +A value of 0x7FFF is used to specify the absence of a **pivot item** (section 2.2.5.4.4) or **data item** (section 2.2.5.4.9.5.1). + +##### PivotTable Rules + +A **PivotTable rule** is used to specify [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the **PivotTable report** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). A **PivotTable rule** is specified by the sequence of records that conform to the **PIVOTRULE rule** (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)) or by an **SxcSXRule class** (section [2.2.5.1.1.1.11](#Section_dd12edef6e8747379bed6f4ceff33127)). Each **PivotTable rule** has references to specific area of a **PivotTable report** (section 2.2.5), [**pivot fields**](#Section_1edf7f2294084945b2de56526c14fca5) (section 2.2.5.4.3), **pivot items** (section [2.2.5.4.4](#Section_58891cc5dd9b4293a97831070779524f)), **data items** (section [2.2.5.4.9.5.1](#Section_b51aa7b309b34aa78cb4964ad24d1679)), or **cache items** (section [2.2.5.3.6](#Section_bdf43e0d59a04111aec09b0a6d3882a0)). These references are used to determine the ranges of cells in the **PivotTable report** (section 2.2.5). The various areas of the **PivotTable report** (section 2.2.5) specified in the [Location and Body](#Section_7f7d9d76a55041d9ae9f0d8539cc09f8) section and the **pivot lines** (section [2.2.5.4.10.3](#Section_76610990666f492791b6d2280f607464)) can be used in this determination. + +The **SxRule** (section [2.4.301](#sxrule)) or **SXAddl_SXCSXrule_SXDSXrule** (section [2.4.273.99](#sxaddl_sxcsxrule_sxdsxrule)) records specify information for a **PivotTable rule**, including restrictions such as what areas of the **PivotTable report** (section 2.2.5) the **PivotTable rule** applies to. In the case of the **SxRule record** (section 2.4.301) the fCacheBased field specifies whether the **PivotTable rule** specifies **cache items** (section 2.2.5.3.6) instead of **pivot items** (section 2.2.5.4.4). + +A **PivotTable rule** can have PivotTable rule filters. A PivotTable rule filter is specified by the sequence of records that conform to a **PRFILTER rule** (section 2.1.7.20.6) or an **SxcSXFilt class** (section [2.2.5.1.1.1.12](#Section_22611924dd5649078c7ab385cd2ccdc0)). A PivotTable rule filter specifies a set of **pivot items** (section 2.2.5.4.4), **data items** (section 2.2.5.4.9.5.1), or **cache items** (section 2.2.5.3.6) for an individual **pivot field** (section 2.2.5.4.3), **data field** (section [2.2.5.4.9.5.2](#Section_b4187a6caa2d4a9789bd26f394d67592)), or **cache field** (section [2.2.5.3.5](#Section_6497eb794042445780e75959c9f0583c)). + +Ranges of cells that are associated, in the **PivotTable report** (section 2.2.5), with any **pivot item** (section 2.2.5.4.4), **data item** (section 2.2.5.4.9.5.1), or **cache item** (section 2.2.5.3.6) from a PivotTable rule filter and that meet other restrictions as specified by the **SxFilt** (section [2.4.285](#sxfilt)) or **SXAddl_SXCSXfilt_SXDSXfilt** (section [2.4.273.77](#sxaddl_sxcsxfilt_sxdsxfilt)) record are associated with the PivotTable rule filter. Ranges of cells that are associated with every PivotTable rule filter of the PivotTable **rule** and that meet other restrictions of the **PivotTable rule** are the ranges of cells specified by the **PivotTable rule**. + +A range of cells is associated with a particular **cache item** (section 2.2.5.3.6) if it is associated with the **pivot item** (section 2.2.5.4.4) that has an association with that **cache item** (section 2.2.5.3.6). + +### Styles + +This overview describes how formatting and protection information for [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) is specified. + +Cell formatting is composed of several sets of properties: + +- [**Font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) properties (bold, italic, font color, font size, etc…) + +- [**Fill**](#gt_215c1c51-d5ef-46af-8596-d7ef63c1fe89) properties ([**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a), [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c), pattern, gradient, etc…) + +- Alignment properties (left, center, right alignment, etc…) + +- [**Border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) properties (left, right, top, bottom, thick or thin, color, etc…) + +- Number formatting properties (date, time, number of decimal places, etc…) + +- [**Protection**](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499) properties ([**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81), [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd), etc…) + +These properties, as a whole, describe how a particular cell is displayed and printed. + +There are two types of objects that contain formatting properties. They are **XFs** (section [2.2.6.1](#Section_4fe94af3cd05427ab32d1f27a85c412a)) and **DXFs** (section [2.2.6.2](#Section_f0b6070c31f54d3dbcb719612da8b8f6)). In general, **XFs** (section 2.2.6.1) describe the formatting directly associated with a cell, and **DXFs** (section 2.2.6.2) describe additional formatting properties that can be applied to one or more cells. + +#### XFs + +**XFs** specify formatting for [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and **cell styles** (section [2.2.6.1.2](#Section_f9425d3f127545be8389bf80f65b56b7)). **XFs** are specified by records in the **XFS collection** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)). This collection contains **XF** (section [2.4.353](#xf)) and **XFExt** (section [2.4.355](#xfext)) records, which specify formatting properties. + +##### Cell XFs + +A **cell XF** is specified by an **XF** record (section [2.4.353](#xf)) (and an optional **XFExt record** (section [2.4.355](#xfext))) where the **fStyle** field of the **XF** record (section 2.4.353) equals 0. Each [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) MUST reference a **cell XF**. These records specify the complete set of formatting properties for the cells that reference them. + +##### Cell Styles + +**Cell styles** specify a set of formatting properties that can be associated with one or more [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). **Cell styles** provide two benefits: + +- The set of formatting properties in a **cell style** can be applied to one or more cells in a single operation. + +- After a **cell style** is applied to a cell, subsequent changes to the formatting properties in the **cell style** can be propagated to the cell automatically. + +For example, if it is desired that multiple cells in a [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) share a common set of formatting properties, like bold [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) with a blue [**fill**](#gt_215c1c51-d5ef-46af-8596-d7ef63c1fe89), then **cell styles** make it convenient to apply this set of formatting, and potentially modify the set later. + +Supporting information for a **cell style** is specified in a **Style** record (section [2.4.269](#style)) (and optional **StyleExt** record (section [2.4.270](#styleext))). This information includes a [**friendly name**](#gt_3dafc161-8c9d-406a-8cbd-c61e7f925eea) for the **cell style** and an index to the **cell style XF** (section [2.2.6.1.2.1](#Section_3d5348ded9df4c31b1fd9f9377273152)) that specifies the formatting for the **cell style**. + +###### Cell Style XFs + +A **cell style XF** is specified by an **XF** record (section [2.4.353](#xf)) (and an optional **XFExt record** (section [2.4.355](#xfext))) where the **fStyle** field of the **XF** record (section 2.4.353) equals 1. Each [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) MUST reference a **cell XF** (section [2.2.6.1.1](#Section_518a740d71c640c8bb97e7df6915861a)), and each **cell XF** (section 2.2.6.1.1) MUST reference a **cell style XF** with the **ixfParent** field. + +###### Normal Style + +At least one **cell style** (section [2.2.6.1.2](#Section_f9425d3f127545be8389bf80f65b56b7)) MUST be included in the **STYLES collection** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)) and this **cell style** (section 2.2.6.1.2) is called the **Normal style**. The **Normal style** MUST reference the first **XF** record (section [2.4.353](#xf)) in the **XFS collection** (section 2.1.7.20.3), and this **XF** record (section 2.4.353) MUST be a **cell style XF** (section [2.2.6.1.2.1](#Section_3d5348ded9df4c31b1fd9f9377273152)), where the **fStyle** field equals 1. + +The **Normal style**, being the only required **cell style** (section 2.2.6.1.2), ensures that all [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) have a **cell style** (section 2.2.6.1.2) to reference. The **Normal style** also provides a convenient object in which to store default cell formatting properties for an entire [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), because all cells will typically reference the **Normal style** by default, until they are modified to reference a different **cell style** (section 2.2.6.1.2). + +#### Differential Formatting (DXFs) + +Like **XFs** (section [2.2.6.1](#Section_4fe94af3cd05427ab32d1f27a85c412a)), **DXFs** define a set of formatting properties. Unlike **XFs** (section 2.2.6.1), **DXFs** can define any number of formatting properties, from just one to all of them. + +**DXFs** provide a way for features to reference a set of formatting properties. How those properties are used depends on the feature. The subsections that follow describe each of these features and how they use **DXFs**. + +**DXFs** can be specified in several different ways. The following records and structures specify a **DXF**: + +- **DXF** (section [2.4.97](#dxf)) + +- **DXFN** (section [2.5.95](#dxfn)) + +- **DXFN12** (section [2.5.96](#dxfn12)) + +- **DXFN12List** (section [2.5.97](#dxfn12list)) + +- **DXFN12NoCB** (section [2.5.98](#dxfn12nocb)) + +**DXF records** (section 2.4.97) are saved into a collection as specified by [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) and referenced with a **DXFId** (section [2.5.94](#dxfid)). + +The remaining structures are saved within containing records, such as **CF** (section [2.4.42](#cf)) and **SxDXF** (section [2.4.280](#sxdxf)). **DXFN12** (section 2.5.96), **DXFN12List** (section 2.5.97), and **DXFN12NoCB** (section 2.5.98) are extensions of the **DXFN structure** (section 2.5.95). + +##### Conditional Formatting + +Some [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules, as specified by the records in the **CONDFMT collection** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)), reference a **DXF** (section [2.2.6.2](#Section_f0b6070c31f54d3dbcb719612da8b8f6)). That **DXF** (section 2.2.6.2) describes additional formatting applied to [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the bounds of the rule, if the rule’s condition is TRUE for those cells. + +##### Table Style Elements + +**Table style elements**, as specified by **TableStyleElement** (section [2.4.321](#tablestyleelement)), can reference a **DXF** (section [2.2.6.2](#Section_f0b6070c31f54d3dbcb719612da8b8f6)). That **DXF** (section 2.2.6.2) describes additional formatting applied to [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the bounds of the **table style element**. + +##### Table Block-Level Formatting + +**Table block-level formatting**, as specified by **List12BlockLevel** (section [2.5.174](#list12blocklevel)), can reference one or more **DXFs** (section [2.2.6.2](#Section_f0b6070c31f54d3dbcb719612da8b8f6)). These **DXFs** (section 2.2.6.2) represent formatting that can be applied to the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the appropriate regions of the [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +##### PivotTable Areas + +A **PivotTable format** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)), as specified by an **SxFormat** record (section [2.4.287](#sxformat)), can specify a **DXF** (section [2.2.6.2](#Section_f0b6070c31f54d3dbcb719612da8b8f6)). This **DXF** (section 2.2.6.2) represents formatting that can be applied to the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the appropriate area of the **PivotTable view** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +##### Sorting and Filtering + +Sorting, as specified by **SortCond12** (section [2.5.242](#sortcond12)), and filtering, as specified by **AutoFilter12** (section [2.4.7](#autofilter12))**,** can include formatting properties as part of their criteria. These properties are stored as **DXFs** (section [2.2.6.2](#Section_f0b6070c31f54d3dbcb719612da8b8f6)). For example, a [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) criteria that is "filter only [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) with red [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) color" will reference a **DXF** (section 2.2.6.2) with the property "font color = red". + +#### Table Styles + +**Table styles** specify additional formatting for [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) inside [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) or **PivotTable views** (section [2.2.5.4](#Section_09410dfbaac84a719ecf177ffba12c37)). + +Tables can specify an applied **table style** with the **List12TableStyleClientInfo** record (section [2.5.176](#list12tablestyleclientinfo)). **PivotTable views** (section 2.2.5.4) specify an applied **table style** with the **SXAddl_SXCView_SXDTableStyleClient** record (section [2.4.273.107](#sxaddl_sxcview_sxdtablestyleclient)). These two records reference a **table style** by name with the **stListStyleName** and **stName** fields, respectively. + +**Table styles** are either built-in or custom. Built-in **table styles** are specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) part 1, 18.8.40. Custom **table styles** used in a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) are specified in the collection of records beginning with **TableStyles** (section [2.4.322](#tablestyles)). + +A **table style** consists of a collection of **table style elements** (section [2.2.6.2.2](#Section_84f2f67849214e8c83eb10d4fff7e935)). For custom **table styles**, these elements are specified by the collection of **TableStyleElement** records (section [2.4.321](#tablestyleelement)) following the **TableStyle** record (section [2.4.320](#tablestyle)). + +Each **table style element** (section 2.2.6.2.2) specifies the formatting to be applied to cells in a particular region of the table or **PivotTable view** (section 2.2.5.4). These regions are specified by the possible values of the **tseType** field of the **TableStyleElement** record (section 2.4.321). + +#### Format Conflicts + +As described previously, the formatting to be displayed or printed for a particular [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) can be specified in several independent records. It is up to the application to resolve conflicting formatting properties for a particular cell. + +As an example, say a cell has a **conditional format** (section [2.2.6.2.1](#Section_abb828767c9c4377858fb1a6be7fe8f9)) applied and also falls within the bounds of a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) with a **table style** (section [2.2.6.3](#Section_4ac7212b4aa74ece962526c58224ae80)). Furthermore, say the **cell XF** (section [2.2.6.1.1](#Section_518a740d71c640c8bb97e7df6915861a)), **conditional format** (section 2.2.6.2.1) and **table style element** (section [2.2.6.2.2](#Section_84f2f67849214e8c83eb10d4fff7e935)) all specify a different [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) color. It is up to the application to decide the appropriate font color to use in this situation. + +### External References + +The **external references** infrastructure exists to support **formulas** (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) which reference [**data sources**](#gt_e091613c-6901-4874-b9b2-27273ead1075) outside the scope of the [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) on which the **formula** (section 2.2.2) resides. These sources could be other sheets (1) in the same [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), data in another workbook, [**DDE**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) links or [**Object Linking and Embedding (OLE)**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) links. A workbook that uses **external references** contains a collection of **XTI records** (section [2.5.344](#xti)) that in turn reference **SupBook records** (section [2.4.271](#supbook)) that specify the source of the data. + +#### External Reference Consumers + +Within the formula, only certain **formula elements** (section [2.2.2.6](#Section_9f95ff16743f4882bbb4242d6e560069)) can contain external references. These specific **formula elements** (section 2.2.2.6) contain an **XtiIndex structure** (section [2.5.198.119](#xtiindex)) specifying an **XTI** (section [2.5.344](#xti)), which in turn specifies the location and type of the external reference data. Only the following **Ptg structures** (section [2.5.198.25](#ptg)) can be **external r**eference **consumers**: + +- **PtgRef3d** (section [2.5.198.85](#ptgref3d)) + +- **PtgRefErr3d** (section [2.5.198.87](#ptgreferr3d)) + +- **PtgArea3d** (section [2.5.198.28](#ptgarea3d)) + +- **PtgAreaErr3d** (section [2.5.198.30](#ptgareaerr3d)) + +- **PtgNameX** (section [2.5.198.77](#ptgnamex)) + +#### Supporting Link + +Each **formula element** (section [2.2.2.6](#Section_9f95ff16743f4882bbb4242d6e560069)) which references external data refers to a **XTI** (section [2.5.344](#xti)). The **XTI** (section 2.5.344) references a **SupBook record** (section [2.4.271](#supbook)) that specifies the type of **supporting link** and, in certain cases, specifies additional data about the **supporting link**. + +There are several types of **supporting links**. The type of the **supporting link** used is specified by the **cch** and **virtPath** fields of the **SupBook record** (section 2.4.271). **Supporting link** types are specified in the following table: + +[TABLE] + +#### External Workbook + +An external workbook link is a reference to a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) other than the one in which the source **formula** (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) resides. It contains the referencing [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106), and data relating to that expression. This data includes the workbook location, [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) names, **external defined names** (section [2.2.7.4](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2)), and an **external cell cache** (section [2.2.7.5](#Section_b985d1a223f3483ebebdbd0e882d4c89)) for referenced cells in that workbook. + +#### External Defined Name + +An external defined name is a reference to a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) in an **external workbook** (section [2.2.7.3](#Section_c8bd9cdbb0784622a3bffb87f35a36cc)). The records specifying the external defined name will provide the name, scope, and **formula** (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) of the defined name on that [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The restrictions on the types of **formulas** (section 2.2.2) supported in **external defined names** are described in **ExtNameParsedFormula** (section [2.5.198.10](#extnameparsedformula)). + +#### External Cell Cache + +To allow external cell references to be calculated without opening the referenced [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), an **external** cell **cache** is stored in the file which contains cached values for cells in a [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in an **external workbook** (section [2.2.7.3](#Section_c8bd9cdbb0784622a3bffb87f35a36cc)). The **external** cell **cache** contains [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) values of the specific cells that are referenced in that sheet (1). The beginning of an **external** cell **cache** is specified by the **XCT** record (section [2.4.352](#xct)). + +The **external** cell **cache** is composed of a collection of sequences of cells that correspond to cells in the source sheet (1). Each cell sequence is specified by a **CRN** record (section [2.4.65](#crn)). + +#### DDE Data Source + +A **DDE data source** specifies information about the [**DDE server**](#gt_aa46dc6a-247b-459b-8acd-af7550514fee) and [**DDE topic**](#gt_c1335a84-baa7-4fc6-904c-cccdbf74bc2a) name of a [**Dynamic Data Exchange (DDE)**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) connection. A **DDE data source** is specified by the **SupBook record** (section [2.4.271](#supbook)). + +#### DDE Data Item + +A **DDE data i**tem specifies the name and properties of a [**DDE**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) item. It also contains cached values from the most recent DDE data update. A **DDE data** item is specified by the **ExternName** record (section [2.4.105](#externname)). + +#### OLE Data Source + +An **OLE data source** specifies information about an [**OLE2**](#gt_0b0e3a28-4780-4123-9bfd-f933b01d64a4) data connection. It specifies the path to the OLE2 [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) file and the [**ProgID**](#gt_06b2ae3d-4106-49f3-9ca0-e2bcd649e75a) of the application handler. An **OLE data source** is specified by the **SupBook record** (section [2.4.271](#supbook)). + +#### OLE Data Item + +An **OLE data i**tem specifies the name and properties of a connection to an [**OLE2**](#gt_0b0e3a28-4780-4123-9bfd-f933b01d64a4) data object. Unlike **DDE Data Sources** (section [2.2.7.6](#Section_b11538fba8244cc3bf8834a1cf5f3559)), **OLE Data Sources** (section [2.2.7.8](#Section_2318e95632614d72a28e412392b8c919)) do not store cached data returned by OLE2 data objects. An **OLE data** item is specified by the **ExternName** record (section [2.4.105](#externname)). + +### External Connections + +A [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) often pulls in data from external [**data sources**](#gt_e091613c-6901-4874-b9b2-27273ead1075), such as a database or an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7). An **external connection** represents a link between a workbook and a particular external data source. It contains properties about the way that the application establishes the connection to the data source and retrieves the data, such as the type of [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) ([**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31), [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e), and so on), a [**server name**](#gt_854f54be-1a9d-40d2-82e5-55cf9e48e2c2), security information, and a command to execute on the server. In addition, the **external connection** contains details about the way the connection is used in the workbook, such as how often to refresh the data. + +A data connection object contains **external connection** information for an external data source that a workbook uses. Data connection objects are independent of the constructs in the workbook that display data, such as [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) or **PivotTables** (section [2.2.5](#Section_a5f57198f2af40b2ba07e4b1836d73f3)). + +A connection definition can be established in an **external connection** file for easier sharing and reuse, but this overview describes the representation for external data connections that are directly embedded within a workbook file. This embedded representation is required whenever external data is used, and ensures portability of the document and continued operation of the external query in the most cases. + +An **external** connection is specified by a combination of the records defined in **DBQUERY_WORKBOOK** (section [2.1.7.20.3](#Section_ca4c174887294a93abb94602b3a01fb1)), **DBQUERY_WORKSHEET** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)), **DBQUERYEXT** (section 2.1.7.20.5) and **SXADDLDBQUERY** (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)), and the **DConn** record (section [2.4.84](#dconn)). + +If an **external** connection is not used by any workbook object, it is represented only by a **DConn** record (section 2.4.84) and the **fStandAlone** field of the **DConn** record (section 2.4.84) is set to 1. + +#### Connection Name + +Each external connection has a unique name, which can be used by the application as a user-friendly name for the connection, for example, for UI purposes. The **c**onnection **name** is specified by the **rgchConnectionName** field of the **DConn** record (section [2.4.84](#dconn)). + +#### External Connection Files + +An **external connection** file specifies an external connection in a separate file (external to the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe)). An **external connection** file enables managing connection information separately from a specific workbook and sharing it among multiple workbooks. It is used for creating a new data connection in a workbook or for restoring a lost connection. The **stSourceConnectionFile** field of the **SXAddl_SXCQuery_SXDSrcConnFile record** (section [2.4.273.65](#sxaddl_sxcquery_sxdsrcconnfile)) and the **rgchSourceConnectionFile** field of the **DConn** record (section [2.4.84](#dconn)) specify a path to an external connection file. + +#### OLE DB Connections + +An **OLE DB connection** is a connection to an [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). An external connection is an **OLE DB connection** if the **dbt** field of the **DbQuery** record (section [2.4.80](#dbquery)) is 0x5, the **dbt** field of the **DBQueryExt** record (section [2.4.81](#dbqueryext)) is **DBT_OLEDB** (section [2.5.64](#datasourcetype)), and the **dbt** field of the **DConn** record (section [2.4.84](#dconn)) is **DBT_OLEDB** (section 2.5.64). + +##### OLAP Connections + +An **OLAP connection** is a connection to an [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) for [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). An OLE DB connection is an **OLAP connection** if the **dbost** field of the **ConnGrbitDbtOledb** structure (section [2.5.59](#conngrbitdbtoledb)) is 0x1. + +#### ODBC Connections + +An **ODBC connection** is a connection to an [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). An external connection is an **ODBC connection** if the **dbt** field of the **DbQuery** record (section [2.4.80](#dbquery)) is 0x1, the **dbt** field of the **DBQueryExt** record (section [2.4.81](#dbqueryext)) is **DBT_ODBC** (section [2.5.64](#datasourcetype)), and the **dbt** field of the **DConn** record (section [2.4.84](#dconn)) is **DBT_ODBC** (section 2.5.64). For more information about ODBC, see [\[MSDN-OpenDBConnectivity\]](https://go.microsoft.com/fwlink/?LinkId=114655). + +#### Web Connections + +A **Web connection** pulls the content of a Web page, or part of a Web page (an [**HTML**](#gt_549c4960-e8be-4c24-bc2b-b86530f1c1bf) table), into the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). An external connection is a **Web** connection if the **dbt** field of the **DbQuery** record (section [2.4.80](#dbquery)) is 0x4, the **dbt** field of the **DBQueryExt** record (section [2.4.81](#dbqueryext)) is **DBT_WEB** (section [2.5.64](#datasourcetype)), and the **dbt** field of the **DConn** record (section [2.4.84](#dconn)) is **DBT_WEB** (section 2.5.64). + +#### Text Import Connections + +A **text import connection** pulls in data from a structured text file into the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). An external connection is a **text import connection** if the **dbt** field of the **DbQuery** record (section [2.4.80](#dbquery)) is 0x6, the **dbt** field of the **DBQueryExt** record (section [2.4.81](#dbqueryext)) is **DBT_TXT** (section [2.5.64](#datasourcetype)), and the **dbt** field of the **DConn** record (section [2.4.84](#dconn)) is **DBT_TXT** (section 2.5.64). + +#### ADO Recordset Connections + +An [**ADO**](#gt_3477d72a-874b-4a2a-b6a9-1431c128df49) recordset pulls in data from a set of records in an ADO [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). An external connection is an **ADO recordset connection** if the **dbt** field of the **DbQuery** record (section [2.4.80](#dbquery)) is 0x7, the **dbt** field of the **DBQueryExt** record (section [2.4.81](#dbqueryext)) is **DBT_ADO** (section [2.5.64](#datasourcetype)), and the **dbt** field of the **DConn** record (section [2.4.84](#dconn)) is **DBT_ADO** (section 2.5.64). + +Note: For this type of connection, the file format does not contain sufficient information for establishing the connection and fetching a recordset. Data is provided to the application through another mechanism, for example by script code using an [**object model**](#gt_91bed4f8-fc06-4d55-b040-7a84c42e4973). + +#### DAO Recordset Connections + +A DAO recordset pulls in data from a set of records in a DAO [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). An external connection is a **DAO recordset connection** if the **dbt** field of the **DbQuery** record (section [2.4.80](#dbquery)) is 0x2, the **dbt** field of the **DBQueryExt** record (section [2.4.81](#dbqueryext)) is **DBT_DAO** (section [2.5.64](#datasourcetype)), and the **dbt** field of the **DConn** record (section [2.4.84](#dconn)) is **DBT_DAO** (section 2.5.64). + +Note: For this type of connection, the file format does not contain sufficient information for establishing the connection and fetching a recordset. Data is provided to the application through another mechanism, for example by script code using an [**object model**](#gt_91bed4f8-fc06-4d55-b040-7a84c42e4973). + +### Password Verifier Algorithm + +Several records (**Password** (section [2.4.191](#password)), **FileSharing** (section [2.4.118](#filesharing)), **Prot4RevPass** (section [2.4.206](#prot4revpass)), **FeatProtection** (section [2.5.124](#featprotection)), and **FilePass** (section [2.4.117](#filepass))) use a password verifier to provide a locking and unlocking system for viewing or editing parts of the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). This password verifier is used to prevent accidental editing, and is not designed to be used as a security feature. The verifier value is calculated in two stages. First, the provided [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) password string is converted to a new character string in the [**American National Standards Institute (ANSI) character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583) code page of the current system using the algorithm specified in the **revisionsPassword** attribute in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) part 4, 15.3.3. Second, this string is input into the [**XOR obfuscation**](#gt_cbfd1a35-e8c9-4c5a-bc26-e618633d2f50) algorithm specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083), 2.3.7.1, Binary Document Password Verifier Derivation Method 1 to produce a 16-bit password verifier value. + +See the [Security Considerations](#Section_6df63a1fecd54d13801ea5321aa39caa) section for information about security concerns related to the use of this algorithm for password verification in this file format.[\<19\>](#Appendix_A_19) + +### Encryption (Password to Open) + +[**Workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) files can contain sensitive information that needs to be protected. A file can be protected by **encrypting** it using a password[\<20\>](#Appendix_A_20). Once a file is **encrypted**, the data can only be accessed by decrypting the file using the same password. + +If a file in this format is saved with **encryption** it MUST be saved with [**XOR obfuscation**](#gt_cbfd1a35-e8c9-4c5a-bc26-e618633d2f50)[\<21\>](#Appendix_A_21) as specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.3.7, or RC4 **encryption** as specified in \[MS-OFFCRYPTO\] section 2.3.6, or one of a number of RC4 CryptoAPI **encryption**[\<22\>](#Appendix_A_22) algorithms as specified in \[MS-OFFCRYPTO\] section 2.3.5. The specific obfuscation or **encryption** method being used, and the associated obfuscation or **encryption** information, is specified in the **FilePass** record (section [2.4.117](#filepass)). + +If RC4 CryptoAPI **encryption** is used, certain storages and [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) are stored in the **Encryption Stream** (section [2.1.7.6](#Section_3ff73530461c45079b669e18aba3124e)) as specified in \[MS-OFFCRYPTO\] section 2.3.5.3. See the following table for details. + +| Storage/Stream | XOR obfuscation or RC4 encryption | RC4 CryptoAPI encryption | +|----|----|----| +| **Component Object Stream** (section [2.1.7.1](#Section_0259345a59e34ab0b489a467b7c19498)) | Not encrypted | Not encrypted. | +| **Control Stream** (section [2.1.7.2](#Section_ce07d64476c84d368badb6419bd152fe)) | Not encrypted | Encrypted in **encryption stream** (section 2.1.7.6). | +| **Data Spaces Storage** (section [2.1.7.3](#Section_2d2a5085fa014807b232f39878b399ce)) | Not encrypted | Not encrypted. | +| **Document Summary Information Stream** (section [2.1.7.4](#Section_a9dabd4a684845a689f40ce0caa11c75)) | Not encrypted | Encrypted in **encryption stream** (section 2.1.7.6) if and only if flag is set \*\* | +| **Embedding Storage** (section [2.1.7.5](#Section_b406ade0fb1c4512bff2b576fdfff545)) | Not encrypted | Encrypted in **encryption stream** (section 2.1.7.6). | +| **Link Storage** (section [2.1.7.7](#Section_a05f262bbc9a44be88b4eba16b41ac6b)) | Not encrypted | Encrypted in **encryption stream** (section 2.1.7.6). | +| **List Data Stream** (section [2.1.7.8](#Section_914f09bd8c944c099e8631dfe058f037)) | Not encrypted | Encrypted in **encryption stream** (section 2.1.7.6). | +| **Office Data Store Storage** (section [2.1.7.9](#Section_ab70c85c1750466f8887c2f343ae4b4f)) | Not encrypted | Not encrypted. | +| **Office Toolbars Stream** (section [2.1.7.10](#Section_3c0ad5b8a61e486c802e282c02c1897a)) | Not encrypted | Not encrypted. | +| **OLE Stream** (section [2.1.7.11](#Section_77f7aefa1bd44d0a970b809503c38bee)) | Not encrypted | Not encrypted. | +| **Pivot Cache Storage** (section [2.1.7.12](#Section_c5fb3f663ef64308ae3de59244159687))\* | Encrypted | Encrypted. | +| **Protected Content Stream** (section [2.1.7.13](#Section_a1671bd186fc480a885152d714a5cc02)) | Not encrypted | Not encrypted. | +| **Revision Stream** (section [2.1.7.14](#Section_d120a1ffd2e6488381a507236f1994b0))\* | Encrypted | Encrypted. | +| **Signatures Stream** (section [2.1.7.15](#Section_23a8b9bf5ae447a7ad42a9aa7d84f75b)) | Not encrypted | Not encrypted. | +| **Summary Information Stream** (section [2.1.7.16](#Section_d604544ba58044ad99d6ca20855a9036)) | Not encrypted | Encrypted in **encryption stream** (section 2.1.7.6) if and only if flag is set \*\* | +| **User Names Stream** (section [2.1.7.17](#Section_1b98bc4df7c640a088dba99426635acd))\* | Not encrypted | Not encrypted. | +| **VBA Storage** (section [2.1.7.18](#Section_27d93f33eaa941d49ec07f2a69d8ff5f)) | Not encrypted | Not encrypted. | +| **Viewer Content Stream** (section [2.1.7.19](#Section_120ab19d71cd43a3be1b88828891cc6a)) | Not encrypted | Not encrypted | +| **Workbook Stream** (section [2.1.7.20](#Section_f682f4b08c6b444e83f852d156f1e8ba))\* | Encrypted | Encrypted. | +| **XML Signatures Storage** (section [2.1.7.21](#Section_f8e1068d19e04fe890720dbb4ff75de7)) | Not encrypted | Not encrypted. | +| **XML Stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)) | Not encrypted | Encrypted in **encryption stream** (section 2.1.7.6) | + +> \* The indicated items specify either streams that contain [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) records as specified in **Record** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)) or storages that contain streams that contain BIFF records as specified in **Record** (section 2.1.4). When obfuscating or **encrypting** BIFF records in these streams the record type and record size components MUST NOT be obfuscated or encrypted. In addition the following records MUST NOT be obfuscated or **encrypted**: **BOF** (section [2.4.21](#bof)), **FilePass** (section 2.4.117), **UsrExcl** (section [2.4.339](#usrexcl)), **FileLock** (section [2.4.116](#filelock)), **InterfaceHdr** (section [2.4.146](#interfacehdr)), **RRDInfo** (section [2.4.227](#rrdinfo)), and **RRDHead** (section [2.4.226](#rrdhead)). Additionally, the **lbPlyPos** field of the **BoundSheet8 record** (section [2.4.28](#boundsheet8)) MUST NOT be **encrypted**. +> +> \*\* The indicated streams for the indicated **encryption** method MUST be **encrypted** if and only if the 0x08 bit of **EncryptionHeader.flags** is equal to 0. **EncryptionHeader.flags** is specified in \[MS-OFFCRYPTO\] section 2.3.5.1. + +For XOR obfuscation, the obfuscation key is generated as specified in the [Password Verifier Algorithm](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4) section. The algorithm for XOR obfuscation is specified in \[MS-OFFCRYPTO\] section 2.3.7. The [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) password string is converted to a new character string in the ANSI code page of the current system using the algorithm specified in the **revisionsPassword** attribute in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) part 4, 15.3.3. The new string is then provided as input into the XOR obfuscation array initialization as specified in \[MS-OFFCRYPTO\] section 2.3.7.2. The initialized array is then used by the algorithm specified in \[MS-OFFCRYPTO\] section 2.3.7.3 to obfuscate the file data. + +For RC4 **encryption** and RC4 CryptoAPI **encryption**, the Unicode password string is used to generate the **encryption** key as specified in \[MS-OFFCRYPTO\] section 2.3.6.2 or \[MS-OFFCRYPTO\] section 2.3.5.2 depending on the RC4 algorithm used. The record data is then **encrypted** by the specific RC4 algorithm in 1024-byte blocks. The block number is set to zero at the beginning of every BIFF record stream, and incremented by one at each 1024-byte boundary. Bytes to be encrypted are passed into the RC4 **encryption** function and then written to the stream. For unencrypted records and the record headers consisting of the record type and record size, a byte buffer of all zeros, of the same size as the section of unencrypted bytes, is passed into the RC4 **encryption** function. The results are then ignored and the unencrypted bytes are written to the stream. + +See the [Security Considerations](#Section_6df63a1fecd54d13801ea5321aa39caa) section for information about security concerns relating to file **encryption** for this file format. + +### Shared Workbooks + +The **shared workbook** infrastructure is used to enable multiple users to make changes to a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) at the same time as well as track changes that certain users make. A **shared workbook** contains a collection of users that currently have the document open and a set of **revision logs** (section [2.2.11.2](#Section_2cbd26e86f7e4195ada414c8b7e595b8)) that contain the changes that users have made to the workbook. Each of these logs has a corresponding revision header associated with it and contains either a set of **revision records** (section [2.2.11.3](#Section_9e91e8bce4f249b897d4741481349d1b)) that have been made to the **shared workbook** because it has been shared or no **revision records** (section 2.2.11.3). A workbook is a **shared workbook** if and only if the **user names stream** (section [2.1.7.17](#Section_1b98bc4df7c640a088dba99426635acd)) exists. + +![Structure of shared workbooks](media/image17.bin "Structure of shared workbooks") + +Figure 17: Structure of shared workbooks + +The following sections define terms used in this diagram. + +#### User Log + +The **user log** contains the set of users who currently have the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) open. The **iCount** field of **CUsr** (section [2.4.72](#cusr)) specifies the number of **UsrInfo records** (section [2.4.340](#usrinfo)) that this section contains. Each **UsrInfo** record (section 2.4.340) corresponds to a user that currently has the workbook open. The **guid** field of the **UsrInfo maps** (section 2.4.340) to the **guid** field of **RRDHead** (section [2.4.226](#rrdhead)) that specifies which **revision log** (section [2.2.11.2](#Section_2cbd26e86f7e4195ada414c8b7e595b8)) the user is currently synchronized to. + +#### Revision Logs + +The revision **logs** section contains a set of revision **logs**. Each revision **log** contains various **revision records** (section [2.2.11.3](#Section_9e91e8bce4f249b897d4741481349d1b)) that a single user has made to a **shared workbook** (section [2.2.11](#Section_e45a62c4490f4304a09668908b57dacc)) or a user action. Each revision **log** has a revision header (**RRDHead** (section [2.4.226](#rrdhead))) and a tab identifier map (**RRTabId** (section [2.4.241](#rrtabid))) that describes general information. The **stUserName** field of **RRDHead** (section 2.4.226)is the name of the user who made changes or performed an action for that particular log. If the revision **log** is meant to describe user changes (and not a user action), it will also contain other revision **log** content that will describe all the changes made by that user. This **revision log** [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) also contains general information about the **shared workbook** (section 2.2.11) in **RRDInfo** (section [2.4.227](#rrdinfo)), **FileLock** (section [2.4.116](#filelock)), and **UsrExcl** (section [2.4.339](#usrexcl)). + +#### Revision Records + +A **revision record** describes changes, or revisions, that a single user has made to a **shared workbook** (section [2.2.11](#Section_e45a62c4490f4304a09668908b57dacc)). The following changes can be recorded by the **shared workbook** (section 2.2.11): + +- Inserting or deleting a row or column (**RRDInsDel** (section [2.4.228](#rrdinsdel))) + +- Moving a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) (**RRDMove** (section [2.4.231](#rrdmove))) + +- Changing a cell (**RRDChgCell** (section [2.4.223](#rrdchgcell))) + +- Adding or removing a [**custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4) (**RRDUserView** (section [2.4.237](#rrduserview))) + +- Renaming an existing [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) (**RRDRenSheet** (section [2.4.234](#rrdrensheet))) + +- Inserting a new sheet (1) (**RRInsertSh** (section [2.4.239](#rrinsertsh))) + +- Changing a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) (**RRDDefName** ()section [2.4.225](#rrddefname)) + +- Changing a [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) (**Note** (section [2.4.179](#note))) + +- Conflict resolution from previous conflicting changes (**RRDConflict** (section [2.4.224](#rrdconflict))) + +- Removing a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) (**RRDTQSIF** (section [2.4.236](#rrdtqsif))) + +- Changing the format (**RRFormat** (section [2.4.238](#rrformat))) + +- Changing the [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f) information for a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) (**RRAutoFmt** (section [2.4.222](#rrautofmt))) + +#### Insertion / Deletion of Rows / Columns Revision + +This revision corresponds to an insertion or deletion of a row or column. In between **RRDInsDel** (section [2.4.228](#rrdinsdel)) and **RRDInsDelEnd** (section [2.4.230](#rrdinsdelend)), any number of **RRFormat** (section [2.4.238](#rrformat)) and **RRDChgCell records** (section [2.4.223](#rrdchgcell)) can appear as well as the other records associated with **RRDChgCell** (section 2.4.223) (**RRDRstEtxp** (section [2.4.235](#rrdrstetxp))). These records describe the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and format changes as a result of inserting or deleting the row or column. + +#### Move Cells Revision + +This revision corresponds to moving a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). In between **RRDMove** (section [2.4.231](#rrdmove)) and **RRDMoveEnd** (section [2.4.233](#rrdmoveend)), any number of **RRFormat** (section [2.4.238](#rrformat)) and **RRDChgCell records** (section [2.4.223](#rrdchgcell)) can appear as well as the other records associated with **RRDChgCell** (section 2.4.223) (**RRDRstEtxp** (section [2.4.235](#rrdrstetxp))). These records describe the cell and format changes as a result of moving a range of cells. + +#### Change Cells Revision + +This revision (**RRDChgCell** (section [2.4.223](#rrdchgcell))) corresponds to a change or edit of a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). It can be followed by any number of **RRDRstEtxp records** (section [2.4.235](#rrdrstetxp)). These specify [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information for the [**formatting run**](#gt_10031ac8-2a26-4200-beee-cd8d9420ca96) as specified in **RRDChgCell** (section 2.4.223). + +#### Sort Map + +The **Sort Map** contains changes to sorting done on the [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) level in a **shared workbook** (section [2.2.11](#Section_e45a62c4490f4304a09668908b57dacc)). Each sheet (1) can have a **Sort Map**. The **Sort Map** is made of up to two sorts (**RRSort** (section [2.4.240](#rrsort))). One specifies sheet (1) level sort changes in rows followed by sheet (1) level sort changes in columns. If there are no changes in sort for rows or columns, the sort map does not exist for rows or columns respectively. + +### Shared Feature + +A **shared feature** is a mechanism that enables different application features to share a common set of record types. For an enumeration of the types of **shared features**, see **SharedFeatureType** (section [2.5.237](#sharedfeaturetype)). For each type of **shared feature** the required records vary. All **shared features** use the following: + +- Common information stored in a **FeatHdr** (section [2.4.112](#feathdr)) or **FeatHdr11** (section [2.4.113](#feathdr11)) record. There MUST be one **FeatHdr** (section 2.4.112) or **FeatHdr11** (section 2.4.113) record for each type of **shared feature** used in one of the **Workbook substreams** (section [2.1.7.20](#Section_f682f4b08c6b444e83f852d156f1e8ba)). + +- Instance specific feature data stored in a **Feat** (section [2.4.111](#feat)), **Feature11** (section [2.4.114](#feature11)), or **Feature12** (section [2.4.115](#feature12)) record. There MUST be one or more **Feat** (section 2.4.111), **Feature11** (section 2.4.114), or **Feature12** (section 2.4.115) records for each instance of a **shared feature**. + +Some **shared features** require other feature-specific records. See **FEAT** (section [2.1.7.20.6](#Section_a1b3d8b4744241fd9c57bbd2a6394082)) and **FEAT11** (section 2.1.7.20.6) records for additional records used for **shared features**. + +## Record Enumeration + +This section specifies the record name associated with a given record type value. For more information about record types, see the section on **Records** (section [2.1.4](#Section_170e90ce87d747589331dcf14cd72388)). + +These associations between record name and record type are listed by record name as well as by record type. + +The type-specific meaning and fields for each record type are specified in the subsection of the **Records section** (section [2.4](#Section_6fba03830d7a4c7aafe9642ff70cbd36)) corresponding to the record name. + +### By Name + +| Name | Record type (number) | +|----|---:| +| **AlRuns** (section [2.4.1](#alruns)) | 4176 | +| **Area** (section [2.4.2](#area)) | 4122 | +| **AreaFormat** (section [2.4.3](#areaformat)) | 4106 | +| **Array** (section [2.4.4](#array)) | 545 | +| **AttachedLabel** (section [2.4.5](#attachedlabel)) | 4108 | +| **AutoFilter** (section [2.4.6](#autofilter)) | 158 | +| **AutoFilter12** (section [2.4.7](#autofilter12)) | 2174 | +| **AutoFilterInfo** (section [2.4.8](#autofilterinfo)) | 157 | +| **AxcExt** (section [2.4.9](#axcext)) | 4194 | +| **AxesUsed** (section [2.4.10](#axesused)) | 4166 | +| **Axis** (section [2.4.11](#axis-1)) | 4125 | +| **AxisLine** (section [2.4.12](#axisline)) | 4129 | +| **AxisParent** (section [2.4.13](#axisparent)) | 4161 | +| **Backup** (section [2.4.14](#backup)) | 64 | +| **Bar** (section [2.4.15](#bar)) | 4119 | +| **BCUsrs** (section [2.4.16](#bcusrs)) | 407 | +| **Begin** (section [2.4.17](#begin)) | 4147 | +| **BigName** (section [2.4.18](#bigname)) | 1048 | +| **BkHim** (section [2.4.19](#bkhim)) | 233 | +| **Blank** (section [2.4.20](#blank)) | 513 | +| **BOF** (section [2.4.21](#bof)) | 2057 | +| **BookBool** (section [2.4.22](#bookbool)) | 218 | +| **BookExt** (section [2.4.23](#bookext)) | 2147 | +| **BoolErr** (section [2.4.24](#boolerr)) | 517 | +| **BopPop** (section [2.4.25](#boppop)) | 4193 | +| **BopPopCustom** (section [2.4.26](#boppopcustom)) | 4199 | +| **BottomMargin** (section [2.4.27](#bottommargin)) | 41 | +| **BoundSheet8** (section [2.4.28](#boundsheet8)) | 133 | +| **BRAI** (section [2.4.29](#brai)) | 4177 | +| **BuiltInFnGroupCount** (section [2.4.30](#builtinfngroupcount)) | 156 | +| **CalcCount** (section [2.4.31](#calccount)) | 12 | +| **CalcDelta** (section [2.4.32](#calcdelta)) | 16 | +| **CalcIter** (section [2.4.33](#calciter)) | 17 | +| **CalcMode** (section [2.4.34](#calcmode)) | 13 | +| **CalcPrecision** (section [2.4.35](#calcprecision)) | 14 | +| **CalcRefMode** (section [2.4.36](#calcrefmode)) | 15 | +| **CalcSaveRecalc** (section [2.4.37](#calcsaverecalc)) | 95 | +| **CatLab** (section [2.4.38](#catlab)) | 2134 | +| **CatSerRange** (section [2.4.39](#catserrange)) | 4128 | +| **CbUsr** (section [2.4.40](#cbusr)) | 402 | +| **CellWatch** (section [2.4.41](#cellwatch)) | 2156 | +| **CF** (section [2.4.42](#cf)) | 433 | +| **CF12** (section [2.4.43](#cf12)) | 2170 | +| **CFEx** (section [2.4.44](#cfex)) | 2171 | +| **Chart** (section [2.4.45](#chart-2)) | 4098 | +| **Chart3d** (section [2.4.46](#chart3d)) | 4154 | +| **Chart3DBarShape** (section [2.4.47](#chart3dbarshape)) | 4191 | +| **ChartFormat** (section [2.4.48](#chartformat)) | 4116 | +| **ChartFrtInfo** (section [2.4.49](#chartfrtinfo)) | 2128 | +| **ClrtClient** (section [2.4.50](#clrtclient)) | 4188 | +| **CodeName** (section [2.4.51](#codename)) | 442 | +| **CodePage** (section [2.4.52](#codepage)) | 66 | +| **ColInfo** (section [2.4.53](#colinfo)) | 125 | +| **Compat12** (section [2.4.54](#compat12)) | 2188 | +| **CompressPictures** (section [2.4.55](#compresspictures)) | 2203 | +| **CondFmt** (section [2.4.56](#condfmt)) | 432 | +| **CondFmt12** (section [2.4.57](#condfmt12)) | 2169 | +| **Continue** (section [2.4.58](#continue)) | 60 | +| **ContinueBigName** (section [2.4.59](#continuebigname)) | 1084 | +| **ContinueFrt** (section [2.4.60](#continuefrt)) | 2066 | +| **ContinueFrt11** (section [2.4.61](#continuefrt11)) | 2165 | +| **ContinueFrt12** (section [2.4.62](#continuefrt12)) | 2175 | +| **Country** (section [2.4.63](#country)) | 140 | +| **CrErr** (section [2.4.64](#crerr)) | 2149 | +| **CRN** (section [2.4.65](#crn)) | 90 | +| **CrtLayout12** (section [2.4.66](#crtlayout12)) | 2205 | +| **CrtLayout12A** (section [2.4.67](#crtlayout12a)) | 2215 | +| **CrtLine** (section [2.4.68](#crtline)) | 4124 | +| **CrtLink** (section [2.4.69](#crtlink)) | 4130 | +| **CrtMlFrt** (section [2.4.70](#crtmlfrt)) | 2206 | +| **CrtMlFrtContinue** (section [2.4.71](#crtmlfrtcontinue)) | 2207 | +| **CUsr** (section [2.4.72](#cusr)) | 401 | +| **Dat** (section [2.4.73](#dat)) | 4195 | +| **DataFormat** (section [2.4.74](#dataformat)) | 4102 | +| **DataLabExt** (section [2.4.75](#datalabext)) | 2154 | +| **DataLabExtContents** (section [2.4.76](#datalabextcontents)) | 2155 | +| **Date1904** (section [2.4.77](#date1904)) | 34 | +| **DBCell** (section [2.4.78](#dbcell)) | 215 | +| **DbOrParamQry** (section [2.4.79](#dborparamqry)) | 220 | +| **DBQueryExt** (section [2.4.81](#dbqueryext)) | 2051 | +| **DCon** (section [2.4.82](#dcon)) | 80 | +| **DconBin** (section [2.4.83](#dconbin)) | 437 | +| **DConn** (section [2.4.84](#dconn)) | 2166 | +| **DConName** (section [2.4.85](#dconname)) | 82 | +| **DConRef** (section [2.4.86](#dconref)) | 81 | +| **DefaultRowHeight** (section [2.4.87](#defaultrowheight)) | 549 | +| **DefaultText** (section [2.4.88](#defaulttext)) | 4132 | +| **DefColWidth** (section [2.4.89](#defcolwidth)) | 85 | +| **Dimensions** (section [2.4.90](#dimensions)) | 512 | +| **DocRoute** (section [2.4.91](#docroute)) | 184 | +| **DropBar** (section [2.4.92](#dropbar)) | 4157 | +| **DropDownObjIds** (section [2.4.93](#dropdownobjids)) | 2164 | +| **DSF** (section [2.4.94](#dsf)) | 353 | +| **Dv** (section [2.4.95](#dv)) | 446 | +| **DVal** (section [2.4.96](#dval)) | 434 | +| **DXF** (section [2.4.97](#dxf)) | 2189 | +| **DxGCol** (section [2.4.98](#dxgcol)) | 153 | +| **End** (section [2.4.99](#end)) | 4148 | +| **EndBlock** (section [2.4.100](#endblock)) | 2131 | +| **EndObject** (section [2.4.101](#endobject)) | 2133 | +| **EntExU2** (section [2.4.102](#entexu2)) | 450 | +| **EOF** (section [2.4.103](#eof)) | 10 | +| **Excel9File** (section [2.4.104](#excel9file)) | 448 | +| **ExternName** (section [2.4.105](#externname)) | 35 | +| **ExternSheet** (section [2.4.106](#externsheet)) | 23 | +| **ExtSST** (section [2.4.107](#extsst)) | 255 | +| **ExtString** (section [2.4.108](#extstring)) | 2052 | +| **Fbi** (section [2.4.109](#fbi)) | 4192 | +| **Fbi2** (section [2.4.110](#fbi2)) | 4200 | +| **Feat** (section [2.4.111](#feat)) | 2152 | +| **FeatHdr** (section [2.4.112](#feathdr)) | 2151 | +| **FeatHdr11** (section [2.4.113](#feathdr11)) | 2161 | +| **Feature11** (section [2.4.114](#feature11)) | 2162 | +| **Feature12** (section [2.4.115](#feature12)) | 2168 | +| **FileLock** (section [2.4.116](#filelock)) | 405 | +| **FilePass** (section [2.4.117](#filepass)) | 47 | +| **FileSharing** (section [2.4.118](#filesharing)) | 91 | +| **FilterMode** (section [2.4.119](#filtermode)) | 155 | +| **FnGroupName** (section [2.4.120](#fngroupname)) | 154 | +| **FnGrp12** (section [2.4.121](#fngrp12)) | 2200 | +| **Font** (section [2.4.122](#font)) | 49 | +| **FontX** (section [2.4.123](#fontx)) | 4134 | +| **Footer** (section [2.4.124](#footer)) | 21 | +| **ForceFullCalculation** (section [2.4.125](#forcefullcalculation)) | 2211 | +| **Format** (section [2.4.126](#format)) | 1054 | +| **Formula** (section [2.4.127](#formula)) | 6 | +| **Frame** (section [2.4.128](#frame)) | 4146 | +| **FrtFontList** (section [2.4.129](#frtfontlist)) | 2138 | +| **FrtWrapper** (section [2.4.130](#frtwrapper)) | 2129 | +| **GelFrame** (section [2.4.131](#gelframe)) | 4198 | +| **GridSet** (section [2.4.132](#gridset)) | 130 | +| **GUIDTypeLib** (section [2.4.133](#guidtypelib)) | 2199 | +| **Guts** (section [2.4.134](#guts)) | 128 | +| **HCenter** (section [2.4.135](#hcenter)) | 131 | +| **Header** (section [2.4.136](#header)) | 20 | +| **HeaderFooter** (section [2.4.137](#headerfooter)) | 2204 | +| **HFPicture** (section [2.4.138](#hfpicture)) | 2150 | +| **HideObj** (section [2.4.139](#hideobj)) | 141 | +| **HLink** (section [2.4.140](#hlink)) | 440 | +| **HLinkTooltip** (section [2.4.141](#hlinktooltip)) | 2048 | +| **HorizontalPageBreaks** (section [2.4.142](#horizontalpagebreaks)) | 27 | +| **IFmtRecord** (section [2.4.143](#ifmtrecord)) | 4174 | +| **Index** (section [2.4.144](#index)) | 523 | +| **InterfaceEnd** (section [2.4.145](#interfaceend)) | 226 | +| **InterfaceHdr** (section [2.4.146](#interfacehdr)) | 225 | +| **Intl** (section [2.4.147](#intl)) | 97 | +| **Label** (section [2.4.148](#label)) | 516 | +| **LabelSst** (section [2.4.149](#labelsst)) | 253 | +| **Lbl** (section [2.4.150](#lbl)) | 24 | +| **LeftMargin** (section [2.4.151](#leftmargin)) | 38 | +| **Legend** (section [2.4.152](#legend-1)) | 4117 | +| **LegendException** (section [2.4.153](#legendexception)) | 4163 | +| **Lel** (section [2.4.154](#lel)) | 441 | +| **Line** (section [2.4.155](#line)) | 4120 | +| **LineFormat** (section [2.4.156](#lineformat)) | 4103 | +| **List12** (section [2.4.157](#list12)) | 2167 | +| **LPr** (section [2.4.158](#lpr)) | 152 | +| **LRng** (section [2.4.159](#lrng)) | 351 | +| **MarkerFormat** (section [2.4.160](#markerformat)) | 4105 | +| **MDB** (section [2.4.161](#mdb)) | 2186 | +| **MDTInfo** (section [2.4.162](#mdtinfo)) | 2180 | +| **MDXKPI** (section [2.4.163](#mdxkpi)) | 2185 | +| **MDXProp** (section [2.4.164](#mdxprop)) | 2184 | +| **MDXSet** (section [2.4.165](#mdxset)) | 2183 | +| **MDXStr** (section [2.4.166](#mdxstr)) | 2181 | +| **MDXTuple** (section [2.4.167](#mdxtuple)) | 2182 | +| **MergeCells** (section [2.4.168](#mergecells)) | 229 | +| **Mms** (section [2.4.169](#mms)) | 193 | +| **MsoDrawing** (section [2.4.170](#msodrawing)) | 236 | +| **MsoDrawingGroup** (section [2.4.171](#msodrawinggroup)) | 235 | +| **MsoDrawingSelection** (section [2.4.172](#msodrawingselection)) | 237 | +| **MTRSettings** (section [2.4.173](#mtrsettings)) | 2202 | +| **MulBlank** (section [2.4.174](#mulblank)) | 190 | +| **MulRk** (section [2.4.175](#mulrk)) | 189 | +| **NameCmt** (section [2.4.176](#namecmt)) | 2196 | +| **NameFnGrp12** (section [2.4.177](#namefngrp12)) | 2201 | +| **NamePublish** (section [2.4.178](#namepublish)) | 2195 | +| **Note** (section [2.4.179](#note)) | 28 | +| **Number** (section [2.4.180](#number)) | 515 | +| **Obj** (section [2.4.181](#obj)) | 93 | +| **ObjectLink** (section [2.4.182](#objectlink)) | 4135 | +| **ObjProtect** (section [2.4.183](#objprotect)) | 99 | +| **ObNoMacros** (section [2.4.184](#obnomacros)) | 445 | +| **ObProj** (section [2.4.185](#obproj)) | 211 | +| **OleDbConn** (section [2.4.186](#oledbconn)) | 2058 | +| **OleObjectSize** (section [2.4.187](#oleobjectsize)) | 222 | +| **Palette** (section [2.4.188](#palette)) | 146 | +| **Pane** (section [2.4.189](#pane)) | 65 | +| **Password** (section [2.4.191](#password)) | 19 | +| **PhoneticInfo** (section [2.4.192](#phoneticinfo)) | 239 | +| **PicF** (section [2.4.193](#picf)) | 4156 | +| **Pie** (section [2.4.194](#pie)) | 4121 | +| **PieFormat** (section [2.4.195](#pieformat)) | 4107 | +| **PivotChartBits** (section [2.4.196](#pivotchartbits)) | 2137 | +| **PlotArea** (section [2.4.197](#plotarea)) | 4149 | +| **PlotGrowth** (section [2.4.198](#plotgrowth)) | 4196 | +| **Pls** (section [2.4.199](#pls)) | 77 | +| **PLV** (section [2.4.200](#plv)) | 2187 | +| **Pos** (section [2.4.201](#pos)) | 4175 | +| **PrintGrid** (section [2.4.202](#printgrid)) | 43 | +| **PrintRowCol** (section [2.4.203](#printrowcol)) | 42 | +| **PrintSize** (section [2.4.204](#printsize)) | 51 | +| **Prot4Rev** (section [2.4.205](#prot4rev)) | 431 | +| **Prot4RevPass** (section [2.4.206](#prot4revpass)) | 444 | +| **Protect** (section [2.4.207](#protect)) | 18 | +| **Qsi** (section [2.4.208](#qsi)) | 429 | +| **Qsif** (section [2.4.209](#qsif)) | 2055 | +| **Qsir** (section [2.4.210](#qsir)) | 2054 | +| **QsiSXTag** (section [2.4.211](#qsisxtag)) | 2050 | +| **Radar** (section [2.4.212](#radar)) | 4158 | +| **RadarArea** (section [2.4.213](#radararea)) | 4160 | +| **RealTimeData** (section [2.4.214](#realtimedata)) | 2067 | +| **RecalcId** (section [2.4.215](#recalcid)) | 449 | +| **RecipName** (section [2.4.216](#recipname)) | 185 | +| **RefreshAll** (section [2.4.217](#refreshall)) | 439 | +| **RichTextStream** (section [2.4.218](#richtextstream)) | 2214 | +| **RightMargin** (section [2.4.219](#rightmargin)) | 39 | +| **RK** (section [2.4.220](#rk)) | 638 | +| **Row** (section [2.4.221](#row)) | 520 | +| **RRAutoFmt** (section [2.4.222](#rrautofmt)) | 331 | +| **RRDChgCell** (section [2.4.223](#rrdchgcell)) | 315 | +| **RRDConflict** (section [2.4.224](#rrdconflict)) | 338 | +| **RRDDefName** (section [2.4.225](#rrddefname)) | 339 | +| **RRDHead** (section [2.4.226](#rrdhead)) | 312 | +| **RRDInfo** (section [2.4.227](#rrdinfo)) | 406 | +| **RRDInsDel** (section [2.4.228](#rrdinsdel)) | 311 | +| **RRDInsDelBegin** (section [2.4.229](#rrdinsdelbegin)) | 336 | +| **RRDInsDelEnd** (section [2.4.230](#rrdinsdelend)) | 337 | +| **RRDMove** (section [2.4.231](#rrdmove)) | 320 | +| **RRDMoveBegin** (section [2.4.232](#rrdmovebegin)) | 334 | +| **RRDMoveEnd** (section [2.4.233](#rrdmoveend)) | 335 | +| **RRDRenSheet** (section [2.4.234](#rrdrensheet)) | 318 | +| **RRDRstEtxp** (section [2.4.235](#rrdrstetxp)) | 340 | +| **RRDTQSIF** (section [2.4.236](#rrdtqsif)) | 2056 | +| **RRDUserView** (section [2.4.237](#rrduserview)) | 428 | +| **RRFormat** (section [2.4.238](#rrformat)) | 330 | +| **RRInsertSh** (section [2.4.239](#rrinsertsh)) | 333 | +| **RRSort** (section [2.4.240](#rrsort)) | 319 | +| **RRTabId** (section [2.4.241](#rrtabid)) | 317 | +| **SBaseRef** (section [2.4.242](#sbaseref)) | 4168 | +| **Scatter** (section [2.4.243](#scatter)) | 4123 | +| **SCENARIO** (section [2.4.244](#scenario)) | 175 | +| **ScenarioProtect** (section [2.4.245](#scenarioprotect)) | 221 | +| **ScenMan** (section [2.4.246](#scenman)) | 174 | +| **Scl** (section [2.4.247](#scl)) | 160 | +| **Selection** (section [2.4.248](#selection)) | 29 | +| **SerAuxErrBar** (section [2.4.249](#serauxerrbar)) | 4187 | +| **SerAuxTrend** (section [2.4.250](#serauxtrend)) | 4171 | +| **SerFmt** (section [2.4.251](#serfmt)) | 4189 | +| **Series** (section [2.4.252](#series-1)) | 4099 | +| **SeriesList** (section [2.4.253](#serieslist)) | 4118 | +| **SeriesText** (section [2.4.254](#seriestext)) | 4109 | +| **SerParent** (section [2.4.255](#serparent)) | 4170 | +| **SerToCrt** (section [2.4.256](#sertocrt)) | 4165 | +| **Setup** (section [2.4.257](#setup)) | 161 | +| **ShapePropsStream** (section [2.4.258](#shapepropsstream)) | 2212 | +| **SheetExt** (section [2.4.259](#sheetext)) | 2146 | +| **ShrFmla** (section [2.4.260](#shrfmla)) | 1212 | +| **ShtProps** (section [2.4.261](#shtprops)) | 4164 | +| **SIIndex** (section [2.4.262](#siindex)) | 4197 | +| **Sort** (section [2.4.263](#sort)) | 144 | +| **SortData** (section [2.4.264](#sortdata)) | 2197 | +| **SST** (section [2.4.265](#sst)) | 252 | +| **StartBlock** (section [2.4.266](#startblock)) | 2130 | +| **StartObject** (section [2.4.267](#startobject)) | 2132 | +| **String** (section [2.4.268](#string)) | 519 | +| **Style** (section [2.4.269](#style)) | 659 | +| **StyleExt** (section [2.4.270](#styleext)) | 2194 | +| **SupBook** (section [2.4.271](#supbook)) | 430 | +| **Surf** (section [2.4.272](#surf)) | 4159 | +| **SXAddl** (section [2.4.273](#Section_3b2dcb9451544f03b24e37a77e48a20e)) | 2148 | +| **SxBool** (section [2.4.274](#sxbool)) | 202 | +| **SXDB** (section [2.4.275](#sxdb)) | 198 | +| **SXDBB** (section [2.4.276](#sxdbb)) | 200 | +| **SXDBEx** (section [2.4.277](#sxdbex)) | 290 | +| **SXDI** (section [2.4.278](#sxdi)) | 197 | +| **SXDtr** (section [2.4.279](#sxdtr)) | 206 | +| **SxDXF** (section [2.4.280](#sxdxf)) | 244 | +| **SxErr** (section [2.4.281](#sxerr)) | 203 | +| **SXEx** (section [2.4.282](#sxex)) | 241 | +| **SXFDB** (section [2.4.283](#sxfdb)) | 199 | +| **SXFDBType** (section [2.4.284](#sxfdbtype)) | 443 | +| **SxFilt** (section [2.4.285](#sxfilt)) | 242 | +| **SxFmla** (section [2.4.286](#sxfmla)) | 249 | +| **SxFormat** (section [2.4.287](#sxformat)) | 251 | +| **SXFormula** (section [2.4.288](#sxformula)) | 259 | +| **SXInt** (section [2.4.289](#sxint)) | 204 | +| **SxIsxoper** (section [2.4.290](#sxisxoper)) | 217 | +| **SxItm** (section [2.4.291](#sxitm)) | 245 | +| **SxIvd** (section [2.4.292](#sxivd)) | 180 | +| **SXLI** (section [2.4.293](#sxli)) | 181 | +| **SxName** (section [2.4.294](#sxname)) | 246 | +| **SxNil** (section [2.4.295](#sxnil)) | 207 | +| **SXNum** (section [2.4.296](#sxnum)) | 201 | +| **SXPair** (section [2.4.297](#sxpair)) | 248 | +| **SXPI** (section [2.4.298](#sxpi)) | 182 | +| **SXPIEx** (section [2.4.299](#sxpiex)) | 2062 | +| **SXRng** (section [2.4.300](#sxrng)) | 216 | +| **SxRule** (section [2.4.301](#sxrule)) | 240 | +| **SxSelect** (section [2.4.302](#sxselect)) | 247 | +| **SXStreamID** (section [2.4.303](#sxstreamid)) | 213 | +| **SXString** (section [2.4.304](#sxstring)) | 205 | +| **SXTbl** (section [2.4.305](#sxtbl)) | 208 | +| **SxTbpg** (section [2.4.306](#sxtbpg)) | 210 | +| **SXTBRGIITM** (section [2.4.307](#sxtbrgiitm)) | 209 | +| **SXTH** (section [2.4.308](#sxth)) | 2061 | +| **Sxvd** (section [2.4.309](#sxvd)) | 177 | +| **SXVDEx** (section [2.4.310](#sxvdex)) | 256 | +| **SXVDTEx** (section [2.4.311](#sxvdtex)) | 2063 | +| **SXVI** (section [2.4.312](#sxvi)) | 178 | +| **SxView** (section [2.4.313](#sxview)) | 176 | +| **SXViewEx** (section [2.4.314](#sxviewex)) | 2060 | +| **SXViewEx9** (section [2.4.315](#sxviewex9)) | 2064 | +| **SXViewLink** (section [2.4.316](#sxviewlink)) | 2136 | +| **SXVS** (section [2.4.317](#sxvs)) | 227 | +| **Sync** (section [2.4.318](#sync)) | 151 | +| **Table** (section [2.4.319](#table)) | 566 | +| **TableStyle** (section [2.4.320](#tablestyle)) | 2191 | +| **TableStyleElement** (section [2.4.321](#tablestyleelement)) | 2192 | +| **TableStyles** (section [2.4.322](#tablestyles)) | 2190 | +| **Template** (section [2.4.323](#template)) | 96 | +| **Text** (section [2.4.324](#text)) | 4133 | +| **TextPropsStream** (section [2.4.325](#textpropsstream)) | 2213 | +| **Theme** (section [2.4.326](#theme)) | 2198 | +| **Tick** (section [2.4.327](#tick)) | 4126 | +| **TopMargin** (section [2.4.328](#topmargin)) | 40 | +| **TxO** (section [2.4.329](#txo)) | 438 | +| **TxtQry** (section [2.4.330](#txtqry)) | 2053 | +| **Uncalced**(section [2.4.331](#uncalced)) | 94 | +| **Units** (section [2.4.332](#units)) | 4097 | +| **UserBView** (section [2.4.333](#userbview)) | 425 | +| **UserSViewBegin** (section [2.4.334](#usersviewbegin)) | 426 | +| **UserSViewBegin_Chart** (section [2.4.335](#usersviewbegin_chart)) | 426 | +| **UserSViewEnd** (section [2.4.336](#usersviewend)) | 427 | +| **UsesELFs** (section [2.4.337](#useselfs)) | 352 | +| **UsrChk** (section [2.4.338](#usrchk)) | 408 | +| **UsrExcl** (section [2.4.339](#usrexcl)) | 404 | +| **UsrInfo** (section [2.4.340](#usrinfo)) | 403 | +| **ValueRange** (section [2.4.341](#valuerange)) | 4127 | +| **VCenter** (section [2.4.342](#vcenter)) | 132 | +| **VerticalPageBreaks** (section [2.4.343](#verticalpagebreaks)) | 26 | +| **WebPub** (section [2.4.344](#webpub)) | 2049 | +| **Window1** (section [2.4.345](#window1)) | 61 | +| **Window2** (section [2.4.346](#window2)) | 574 | +| **WinProtect** (section [2.4.347](#winprotect)) | 25 | +| **WOpt** (section [2.4.348](#wopt)) | 2059 | +| **WriteAccess** (section [2.4.349](#writeaccess)) | 92 | +| **WriteProtect** (section [2.4.350](#writeprotect)) | 134 | +| **WsBool** (section [2.4.351](#wsbool)) | 129 | +| **XCT** (section [2.4.352](#xct)) | 89 | +| **XF** (section [2.4.353](#xf)) | 224 | +| **XFCRC** (section [2.4.354](#xfcrc)) | 2172 | +| **XFExt** (section [2.4.355](#xfext)) | 2173 | +| **YMult** (section [2.4.356](#ymult)) | 2135 | + +### By Number + +| Name | Record type (number) | +|----|---:| +| **Formula** (section [2.4.127](#formula)) | 6 | +| **EOF** (section [2.4.103](#eof)) | 10 | +| **CalcCount** (section [2.4.31](#calccount)) | 12 | +| **CalcMode** (section [2.4.34](#calcmode)) | 13 | +| **CalcPrecision** (section [2.4.35](#calcprecision)) | 14 | +| **CalcRefMode** (section [2.4.36](#calcrefmode)) | 15 | +| **CalcDelta** (section [2.4.32](#calcdelta)) | 16 | +| **CalcIter** (section [2.4.33](#calciter)) | 17 | +| **Protect** (section [2.4.207](#protect)) | 18 | +| **Password** (section [2.4.191](#password)) | 19 | +| **Header** (section [2.4.136](#header)) | 20 | +| **Footer** (section [2.4.124](#footer)) | 21 | +| **ExternSheet** (section [2.4.106](#externsheet)) | 23 | +| **Lbl** (section [2.4.150](#lbl)) | 24 | +| **WinProtect** (section [2.4.347](#winprotect)) | 25 | +| **VerticalPageBreaks** (section [2.4.343](#verticalpagebreaks)) | 26 | +| **HorizontalPageBreaks** (section [2.4.142](#horizontalpagebreaks)) | 27 | +| **Note** (section [2.4.179](#note)) | 28 | +| **Selection** (section [2.4.248](#selection)) | 29 | +| **Date1904** (section [2.4.77](#date1904)) | 34 | +| **ExternName** (section [2.4.105](#externname)) | 35 | +| **LeftMargin** (section [2.4.151](#leftmargin)) | 38 | +| **RightMargin** (section [2.4.219](#rightmargin)) | 39 | +| **TopMargin** (section [2.4.328](#topmargin)) | 40 | +| **BottomMargin** (section [2.4.27](#bottommargin)) | 41 | +| **PrintRowCol** (section [2.4.203](#printrowcol)) | 42 | +| **PrintGrid** (section [2.4.202](#printgrid)) | 43 | +| **FilePass** (section [2.4.117](#filepass)) | 47 | +| **Font** (section [2.4.122](#font)) | 49 | +| **PrintSize** (section [2.4.204](#printsize)) | 51 | +| **Continue** (section [2.4.58](#continue)) | 60 | +| **Window1** (section [2.4.345](#window1)) | 61 | +| **Backup** (section [2.4.14](#backup)) | 64 | +| **Pane** (section [2.4.189](#pane)) | 65 | +| **CodePage** (section [2.4.52](#codepage)) | 66 | +| **Pls** (section [2.4.199](#pls)) | 77 | +| **DCon** (section [2.4.82](#dcon)) | 80 | +| **DConRef** (section [2.4.86](#dconref)) | 81 | +| **DConName** (section [2.4.85](#dconname)) | 82 | +| **DefColWidth** (section [2.4.89](#defcolwidth)) | 85 | +| **XCT** (section [2.4.352](#xct)) | 89 | +| **CRN** (section [2.4.65](#crn)) | 90 | +| **FileSharing** (section [2.4.118](#filesharing)) | 91 | +| **WriteAccess** (section [2.4.349](#writeaccess)) | 92 | +| **Obj** (section [2.4.181](#obj)) | 93 | +| **Uncalced** (section [2.4.331](#uncalced)) | 94 | +| **CalcSaveRecalc** (section [2.4.37](#calcsaverecalc)) | 95 | +| **Template** (section [2.4.323](#template)) | 96 | +| **Intl** (section [2.4.147](#intl)) | 97 | +| **ObjProtect** (section [2.4.183](#objprotect)) | 99 | +| **ColInfo** (section [2.4.53](#colinfo)) | 125 | +| **Guts** (section [2.4.134](#guts)) | 128 | +| **WsBool** (section [2.4.351](#wsbool)) | 129 | +| **GridSet** (section [2.4.132](#gridset)) | 130 | +| **HCenter** (section [2.4.135](#hcenter)) | 131 | +| **VCenter** (section [2.4.342](#vcenter)) | 132 | +| **BoundSheet8** (section [2.4.28](#boundsheet8)) | 133 | +| **WriteProtect** (section [2.4.350](#writeprotect)) | 134 | +| **Country** (section [2.4.63](#country)) | 140 | +| **HideObj** (section [2.4.139](#hideobj)) | 141 | +| **Sort** (section [2.4.263](#sort)) | 144 | +| **Palette** (section [2.4.188](#palette)) | 146 | +| **Sync** (section [2.4.318](#sync)) | 151 | +| **LPr** (section [2.4.158](#lpr)) | 152 | +| **DxGCol** (section [2.4.98](#dxgcol)) | 153 | +| **FnGroupName** (section [2.4.120](#fngroupname)) | 154 | +| **FilterMode** (section [2.4.119](#filtermode)) | 155 | +| **BuiltInFnGroupCount** (section [2.4.30](#builtinfngroupcount)) | 156 | +| **AutoFilterInfo** (section [2.4.8](#autofilterinfo)) | 157 | +| **AutoFilter** (section [2.4.6](#autofilter)) | 158 | +| **Scl** (section [2.4.247](#scl)) | 160 | +| **Setup** (section [2.4.257](#setup)) | 161 | +| **ScenMan** (section [2.4.246](#scenman)) | 174 | +| **SCENARIO** (section [2.4.244](#scenario)) | 175 | +| **SxView** (section [2.4.313](#sxview)) | 176 | +| **Sxvd** (section [2.4.309](#sxvd)) | 177 | +| **SXVI** (section [2.4.312](#sxvi)) | 178 | +| **SxIvd** (section [2.4.292](#sxivd)) | 180 | +| **SXLI** (section [2.4.293](#sxli)) | 181 | +| **SXPI** (section [2.4.298](#sxpi)) | 182 | +| **DocRoute** (section [2.4.91](#docroute)) | 184 | +| **RecipName** (section [2.4.216](#recipname)) | 185 | +| **MulRk** (section [2.4.175](#mulrk)) | 189 | +| **MulBlank** (section [2.4.174](#mulblank)) | 190 | +| **Mms** (section [2.4.169](#mms)) | 193 | +| **SXDI** (section [2.4.278](#sxdi)) | 197 | +| **SXDB** (section [2.4.275](#sxdb)) | 198 | +| **SXFDB** (section [2.4.283](#sxfdb)) | 199 | +| **SXDBB** (section [2.4.276](#sxdbb)) | 200 | +| **SXNum** (section [2.4.296](#sxnum)) | 201 | +| **SxBool** (section [2.4.274](#sxbool)) | 202 | +| **SxErr** (section [2.4.281](#sxerr)) | 203 | +| **SXInt** (section [2.4.289](#sxint)) | 204 | +| **SXString** (section [2.4.304](#sxstring)) | 205 | +| **SXDtr** (section [2.4.279](#sxdtr)) | 206 | +| **SxNil** (section [2.4.295](#sxnil)) | 207 | +| **SXTbl** (section [2.4.305](#sxtbl)) | 208 | +| **SXTBRGIITM** (section [2.4.307](#sxtbrgiitm)) | 209 | +| **SxTbpg** (section [2.4.306](#sxtbpg)) | 210 | +| **ObProj** (section [2.4.185](#obproj)) | 211 | +| **SXStreamID** (section [2.4.303](#sxstreamid)) | 213 | +| **DBCell** (section [2.4.78](#dbcell)) | 215 | +| **SXRng** (section [2.4.300](#sxrng)) | 216 | +| **SxIsxoper** (section [2.4.290](#sxisxoper)) | 217 | +| **BookBool** (section [2.4.22](#bookbool)) | 218 | +| **DbOrParamQry** (section [2.4.79](#dborparamqry)) | 220 | +| **ScenarioProtect** (section [2.4.245](#scenarioprotect)) | 221 | +| **OleObjectSize** (section [2.4.187](#oleobjectsize)) | 222 | +| **XF** (section [2.4.353](#xf)) | 224 | +| **InterfaceHdr** (section [2.4.146](#interfacehdr)) | 225 | +| **InterfaceEnd** (section [2.4.145](#interfaceend)) | 226 | +| **SXVS** (section [2.4.317](#sxvs)) | 227 | +| **MergeCells** (section [2.4.168](#mergecells)) | 229 | +| **BkHim** (section [2.4.19](#bkhim)) | 233 | +| **MsoDrawingGroup** (section [2.4.171](#msodrawinggroup)) | 235 | +| **MsoDrawing** (section [2.4.170](#msodrawing)) | 236 | +| **MsoDrawingSelection** (section [2.4.172](#msodrawingselection)) | 237 | +| **PhoneticInfo** (section [2.4.192](#phoneticinfo)) | 239 | +| **SxRule** (section [2.4.301](#sxrule)) | 240 | +| **SXEx** (section [2.4.282](#sxex)) | 241 | +| **SxFilt** (section [2.4.285](#sxfilt)) | 242 | +| **SxDXF** (section [2.4.280](#sxdxf)) | 244 | +| **SxItm** (section [2.4.291](#sxitm)) | 245 | +| **SxName** (section [2.4.294](#sxname)) | 246 | +| **SxSelect** (section [2.4.302](#sxselect)) | 247 | +| **SXPair** (section [2.4.297](#sxpair)) | 248 | +| **SxFmla** (section [2.4.286](#sxfmla)) | 249 | +| **SxFormat** (section [2.4.287](#sxformat)) | 251 | +| **SST** (section [2.4.265](#sst)) | 252 | +| **LabelSst** (section [2.4.149](#labelsst)) | 253 | +| **ExtSST** (section [2.4.107](#extsst)) | 255 | +| **SXVDEx** (section [2.4.310](#sxvdex)) | 256 | +| **SXFormula** (section [2.4.288](#sxformula)) | 259 | +| **SXDBEx** (section [2.4.277](#sxdbex)) | 290 | +| **RRDInsDel** (section [2.4.228](#rrdinsdel)) | 311 | +| **RRDHead** (section [2.4.226](#rrdhead)) | 312 | +| **RRDChgCell** (section [2.4.223](#rrdchgcell)) | 315 | +| **RRTabId** (section [2.4.241](#rrtabid)) | 317 | +| **RRDRenSheet** (section [2.4.234](#rrdrensheet)) | 318 | +| **RRSort** (section [2.4.240](#rrsort)) | 319 | +| **RRDMove** (section [2.4.231](#rrdmove)) | 320 | +| **RRFormat** (section [2.4.238](#rrformat)) | 330 | +| **RRAutoFmt** (section [2.4.222](#rrautofmt)) | 331 | +| **RRInsertSh** (section [2.4.239](#rrinsertsh)) | 333 | +| **RRDMoveBegin** (section [2.4.232](#rrdmovebegin)) | 334 | +| **RRDMoveEnd** (section [2.4.233](#rrdmoveend)) | 335 | +| **RRDInsDelBegin** (section [2.4.229](#rrdinsdelbegin)) | 336 | +| **RRDInsDelEnd** (section [2.4.230](#rrdinsdelend)) | 337 | +| **RRDConflict** (section [2.4.224](#rrdconflict)) | 338 | +| **RRDDefName** (section [2.4.225](#rrddefname)) | 339 | +| **RRDRstEtxp** (section [2.4.235](#rrdrstetxp)) | 340 | +| **LRng** (section [2.4.159](#lrng)) | 351 | +| **UsesELFs** (section [2.4.337](#useselfs)) | 352 | +| **DSF** (section [2.4.94](#dsf)) | 353 | +| **CUsr** (section [2.4.72](#cusr)) | 401 | +| **CbUsr** (section [2.4.40](#cbusr)) | 402 | +| **UsrInfo** (section [2.4.340](#usrinfo)) | 403 | +| **UsrExcl** (section [2.4.339](#usrexcl)) | 404 | +| **FileLock** (section [2.4.116](#filelock)) | 405 | +| **RRDInfo** (section [2.4.227](#rrdinfo)) | 406 | +| **BCUsrs** (section [2.4.16](#bcusrs)) | 407 | +| **UsrChk** (section [2.4.338](#usrchk)) | 408 | +| **UserBView** (section [2.4.333](#userbview)) | 425 | +| **UserSViewBegin** (section [2.4.334](#usersviewbegin)) | 426 | +| **UserSViewBegin_Chart** (section [2.4.335](#usersviewbegin_chart)) | 426 | +| **UserSViewEnd** (section [2.4.336](#usersviewend)) | 427 | +| **RRDUserView** (section [2.4.237](#rrduserview)) | 428 | +| **Qsi** (section [2.4.208](#qsi)) | 429 | +| **SupBook** (section [2.4.271](#supbook)) | 430 | +| **Prot4Rev** (section [2.4.205](#prot4rev)) | 431 | +| **CondFmt** (section [2.4.56](#condfmt)) | 432 | +| **CF** (section [2.4.42](#cf)) | 433 | +| **DVal** (section [2.4.96](#dval)) | 434 | +| **DConBin** (section [2.4.83](#dconbin)) | 437 | +| **TxO** (section [2.4.329](#txo)) | 438 | +| **RefreshAll** (section [2.4.217](#refreshall)) | 439 | +| **HLink** (section [2.4.140](#hlink)) | 440 | +| **Lel** (section [2.4.154](#lel)) | 441 | +| **CodeName** (section [2.4.51](#codename)) | 442 | +| **SXFDBType** (section [2.4.284](#sxfdbtype)) | 443 | +| **Prot4RevPass** (section [2.4.206](#prot4revpass)) | 444 | +| **ObNoMacros** (section [2.4.184](#obnomacros)) | 445 | +| **Dv** (section [2.4.95](#dv)) | 446 | +| **Excel9File** (section [2.4.104](#excel9file)) | 448 | +| **RecalcId** (section [2.4.215](#recalcid)) | 449 | +| **EntExU2** (section [2.4.102](#entexu2)) | 450 | +| **Dimensions** (section [2.4.90](#dimensions)) | 512 | +| **Blank** (section [2.4.20](#blank)) | 513 | +| **Number** (section [2.4.180](#number)) | 515 | +| **Label** (section [2.4.148](#label)) | 516 | +| **BoolErr** (section [2.4.24](#boolerr)) | 517 | +| **String** (section [2.4.268](#string)) | 519 | +| **Row** (section [2.4.221](#row)) | 520 | +| **Index** (section [2.4.144](#index)) | 523 | +| **Array** (section [2.4.4](#array)) | 545 | +| **DefaultRowHeight** (section [2.4.87](#defaultrowheight)) | 549 | +| **Table** (section [2.4.319](#table)) | 566 | +| **Window2** (section [2.4.346](#window2)) | 574 | +| **RK** (section [2.4.220](#rk)) | 638 | +| **Style** (section [2.4.269](#style)) | 659 | +| **BigName** (section [2.4.18](#bigname)) | 1048 | +| **Format** (section [2.4.126](#format)) | 1054 | +| **ContinueBigName** (section [2.4.59](#continuebigname)) | 1084 | +| **ShrFmla** (section [2.4.260](#shrfmla)) | 1212 | +| **HLinkTooltip** (section [2.4.141](#hlinktooltip)) | 2048 | +| **WebPub** (section [2.4.344](#webpub)) | 2049 | +| **QsiSXTag** (section [2.4.211](#qsisxtag)) | 2050 | +| **DBQueryExt** (section [2.4.81](#dbqueryext)) | 2051 | +| **ExtString** (section [2.4.108](#extstring)) | 2052 | +| **TxtQry** (section [2.4.330](#txtqry)) | 2053 | +| **Qsir** (section [2.4.210](#qsir)) | 2054 | +| **Qsif** (section [2.4.209](#qsif)) | 2055 | +| **RRDTQSIF** (section [2.4.236](#rrdtqsif)) | 2056 | +| **BOF** (section [2.4.21](#bof)) | 2057 | +| **OleDbConn** (section [2.4.186](#oledbconn)) | 2058 | +| **WOpt** (section [2.4.348](#wopt)) | 2059 | +| **SXViewEx** (section [2.4.314](#sxviewex)) | 2060 | +| **SXTH** (section [2.4.308](#sxth)) | 2061 | +| **SXPIEx** (section [2.4.299](#sxpiex)) | 2062 | +| **SXVDTEx** (section [2.4.311](#sxvdtex)) | 2063 | +| **SXViewEx9** (section [2.4.315](#sxviewex9)) | 2064 | +| **ContinueFrt** (section [2.4.60](#continuefrt)) | 2066 | +| **RealTimeData** (section [2.4.214](#realtimedata)) | 2067 | +| **ChartFrtInfo** (section [2.4.49](#chartfrtinfo)) | 2128 | +| **FrtWrapper** (section [2.4.130](#frtwrapper)) | 2129 | +| **StartBlock** (section [2.4.266](#startblock)) | 2130 | +| **EndBlock** (section [2.4.100](#endblock)) | 2131 | +| **StartObject** (section [2.4.267](#startobject)) | 2132 | +| **EndObject** (section [2.4.101](#endobject)) | 2133 | +| **CatLab** (section [2.4.38](#catlab)) | 2134 | +| **YMult** (section [2.4.356](#ymult)) | 2135 | +| **SXViewLink** (section [2.4.316](#sxviewlink)) | 2136 | +| **PivotChartBits** (section [2.4.196](#pivotchartbits)) | 2137 | +| **FrtFontList** (section [2.4.129](#frtfontlist)) | 2138 | +| **SheetExt** (section [2.4.259](#sheetext)) | 2146 | +| **BookExt** (section [2.4.23](#bookext)) | 2147 | +| **SXAddl** (section [2.4.273.2](#sxaddl)) | 2148 | +| **CrErr** (section [2.4.64](#crerr)) | 2149 | +| **HFPicture** (section [2.4.138](#hfpicture)) | 2150 | +| **FeatHdr** (section [2.4.112](#feathdr)) | 2151 | +| **Feat** (section [2.4.111](#feat)) | 2152 | +| **DataLabExt** (section [2.4.75](#datalabext)) | 2154 | +| **DataLabExtContents** (section [2.4.76](#datalabextcontents)) | 2155 | +| **CellWatch** (section [2.4.41](#cellwatch)) | 2156 | +| **FeatHdr11** (section [2.4.113](#feathdr11)) | 2161 | +| **Feature11** (section [2.4.114](#feature11)) | 2162 | +| **DropDownObjIds** (section [2.4.93](#dropdownobjids)) | 2164 | +| **ContinueFrt11** (section [2.4.61](#continuefrt11)) | 2165 | +| **DConn** (section [2.4.84](#dconn)) | 2166 | +| **List12** (section [2.4.157](#list12)) | 2167 | +| **Feature12** (section [2.4.115](#feature12)) | 2168 | +| **CondFmt12** (section [2.4.57](#condfmt12)) | 2169 | +| **CF12** (section [2.4.43](#cf12)) | 2170 | +| **CFEx** (section [2.4.44](#cfex)) | 2171 | +| **XFCRC** (section [2.4.354](#xfcrc)) | 2172 | +| **XFExt** (section [2.4.355](#xfext)) | 2173 | +| **AutoFilter12** (section [2.4.7](#autofilter12)) | 2174 | +| **ContinueFrt12** (section [2.4.62](#continuefrt12)) | 2175 | +| **MDTInfo** (section [2.4.162](#mdtinfo)) | 2180 | +| **MDXStr** (section [2.4.166](#mdxstr)) | 2181 | +| **MDXTuple** (section [2.4.167](#mdxtuple)) | 2182 | +| **MDXSet** (section [2.4.165](#mdxset)) | 2183 | +| **MDXProp** (section [2.4.164](#mdxprop)) | 2184 | +| **MDXKPI** (section [2.4.163](#mdxkpi)) | 2185 | +| **MDB** (section [2.4.161](#mdb)) | 2186 | +| **PLV** (section [2.4.200](#plv)) | 2187 | +| **Compat12** (section [2.4.54](#compat12)) | 2188 | +| **DXF** (section [2.4.97](#dxf)) | 2189 | +| **TableStyles** (section [2.4.322](#tablestyles)) | 2190 | +| **TableStyle** (section [2.4.320](#tablestyle)) | 2191 | +| **TableStyleElement** (section [2.4.321](#tablestyleelement)) | 2192 | +| **StyleExt** (section [2.4.270](#styleext)) | 2194 | +| **NamePublish** (section [2.4.178](#namepublish)) | 2195 | +| **NameCmt** (section [2.4.176](#namecmt)) | 2196 | +| **SortData** (section [2.4.264](#sortdata)) | 2197 | +| **Theme** (section [2.4.326](#theme)) | 2198 | +| **GUIDTypeLib** (section [2.4.133](#guidtypelib)) | 2199 | +| **FnGrp12** (section [2.4.121](#fngrp12)) | 2200 | +| **NameFnGrp12** (section [2.4.177](#namefngrp12)) | 2201 | +| **MTRSettings** (section [2.4.173](#mtrsettings)) | 2202 | +| **CompressPictures** (section [2.4.55](#compresspictures)) | 2203 | +| **HeaderFooter** (section [2.4.137](#headerfooter)) | 2204 | +| **CrtLayout12** (section [2.4.66](#crtlayout12)) | 2205 | +| **CrtMlFrt** (section [2.4.70](#crtmlfrt)) | 2206 | +| **CrtMlFrtContinue** (section [2.4.71](#crtmlfrtcontinue)) | 2207 | +| **ForceFullCalculation** (section [2.4.125](#forcefullcalculation)) | 2211 | +| **ShapePropsStream** (section [2.4.258](#shapepropsstream)) | 2212 | +| **TextPropsStream** (section [2.4.325](#textpropsstream)) | 2213 | +| **RichTextStream** (section [2.4.218](#richtextstream)) | 2214 | +| **CrtLayout12A** (section [2.4.67](#crtlayout12a)) | 2215 | +| **Units** (section [2.4.332](#units)) | 4097 | +| **Chart** (section [2.4.45](#chart-2)) | 4098 | +| **Series** (section [2.4.252](#series-1)) | 4099 | +| **DataFormat** (section [2.4.74](#dataformat)) | 4102 | +| **LineFormat** (section [2.4.156](#lineformat)) | 4103 | +| **MarkerFormat** (section [2.4.160](#markerformat)) | 4105 | +| **AreaFormat** (section [2.4.3](#areaformat)) | 4106 | +| **PieFormat** (section [2.4.195](#pieformat)) | 4107 | +| **AttachedLabel** (section [2.4.5](#attachedlabel)) | 4108 | +| **SeriesText** (section [2.4.254](#seriestext)) | 4109 | +| **ChartFormat** (section [2.4.48](#chartformat)) | 4116 | +| **Legend** (section [2.4.152](#legend-1)) | 4117 | +| **SeriesList** (section [2.4.253](#serieslist)) | 4118 | +| **Bar** (section [2.4.15](#bar)) | 4119 | +| **Line** (section [2.4.155](#line)) | 4120 | +| **Pie** (section [2.4.194](#pie)) | 4121 | +| **Area** (section [2.4.2](#area)) | 4122 | +| **Scatter** (section [2.4.243](#scatter)) | 4123 | +| **CrtLine** (section [2.4.68](#crtline)) | 4124 | +| **Axis** (section [2.4.11](#axis-1)) | 4125 | +| **Tick** (section [2.4.327](#tick)) | 4126 | +| **ValueRange** (section [2.4.341](#valuerange)) | 4127 | +| **CatSerRange** (section [2.4.39](#catserrange)) | 4128 | +| **AxisLine** (section [2.4.12](#axisline)) | 4129 | +| **CrtLink** (section [2.4.69](#crtlink)) | 4130 | +| **DefaultText** (section [2.4.88](#defaulttext)) | 4132 | +| **Text** (section [2.4.324](#text)) | 4133 | +| **FontX** (section [2.4.123](#fontx)) | 4134 | +| **ObjectLink** (section [2.4.182](#objectlink)) | 4135 | +| **Frame** (section [2.4.128](#frame)) | 4146 | +| **Begin** (section [2.4.17](#begin)) | 4147 | +| **End** (section [2.4.99](#end)) | 4148 | +| **PlotArea** (section [2.4.197](#plotarea)) | 4149 | +| **Chart3d** (section [2.4.46](#chart3d)) | 4154 | +| **PicF** (section [2.4.193](#picf)) | 4156 | +| **DropBar** (section [2.4.92](#dropbar)) | 4157 | +| **Radar** (section [2.4.212](#radar)) | 4158 | +| **Surf** (section [2.4.272](#surf)) | 4159 | +| **RadarArea** (section [2.4.213](#radararea)) | 4160 | +| **AxisParent** (section [2.4.13](#axisparent)) | 4161 | +| **LegendException** section [2.4.153](#legendexception)() | 4163 | +| **ShtProps** (section [2.4.261](#shtprops)) | 4164 | +| **SerToCrt** (section [2.4.256](#sertocrt)) | 4165 | +| **AxesUsed** (section [2.4.10](#axesused)) | 4166 | +| **SBaseRef** (section [2.4.242](#sbaseref)) | 4168 | +| **SerParent** (section [2.4.255](#serparent)) | 4170 | +| **SerAuxTrend** (section [2.4.250](#serauxtrend)) | 4171 | +| **IFmtRecord** (section [2.4.143](#ifmtrecord)) | 4174 | +| **Pos** (section [2.4.201](#pos)) | 4175 | +| **AlRuns** (section [2.4.1](#alruns)) | 4176 | +| **BRAI** (section [2.4.29](#brai)) | 4177 | +| **SerAuxErrBar** (section [2.4.249](#serauxerrbar)) | 4187 | +| **ClrtClient** (section [2.4.50](#clrtclient)) | 4188 | +| **SerFmt** (section [2.4.251](#serfmt)) | 4189 | +| **Chart3DBarShape** (section [2.4.47](#chart3dbarshape)) | 4191 | +| **Fbi** (section [2.4.109](#fbi)) | 4192 | +| **BopPop** (section [2.4.25](#boppop)) | 4193 | +| **AxcExt** (section [2.4.9](#axcext)) | 4194 | +| **Dat** (section [2.4.73](#dat)) | 4195 | +| **PlotGrowth** (section [2.4.198](#plotgrowth)) | 4196 | +| **SIIndex** (section [2.4.262](#siindex)) | 4197 | +| **GelFrame** (section [2.4.131](#gelframe)) | 4198 | +| **BopPopCustom** (section [2.4.26](#boppopcustom)) | 4199 | +| **Fbi2** (section [2.4.110](#fbi2)) | 4200 | + +## Records + +### AlRuns + +The **AlRuns** record specifies Rich Text Formatting within **chart titles** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)), **trendline** (section [2.2.3.12](#Section_61d74ebc36714d6dbdc0626db604530d)), and **data labels** (section [2.2.3.11](#Section_cac7f43a3af142f58ff2814c2870427f)). + +[TABLE] + +**cRuns (2 bytes):** An unsigned integer that specifies the number of Rich Text Format runs. MUST be greater than or equal to 3 and less than or equal to 256. + +**rgRuns (variable):** An array of **FormatRun structures** (section [2.5.132](#formatrun)) that specifies the Rich Text Format runs. The number of elements in the array MUST be equal to **cRuns**. + +### Area + +The **Area** record specifies that the **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) is an area **chart group** (section 2.2.3.7) and specifies the **chart group** (section 2.2.3.7) attributes. + +[TABLE] + +**A - fStacked (1 bit):** A bit that specifies whether the **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) in the **chart group** (section 2.2.3.7) that share the same [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) are stacked. + +**B - f100 (1 bit):** A bit that specifies whether the **data points** (section 2.2.3.10) in the **chart group** (section 2.2.3.7) are displayed as a percentage of the sum of all **data points** (section 2.2.3.10) in the **chart group** (section 2.2.3.7) that share the same category. MUST be 0 if **fStacked** is 0. + +**C - fHasShadow (1 bit):** A bit that specifies whether one or more **data points** (section 2.2.3.10) in the **chart group** (section 2.2.3.7) has shadows. + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +### AreaFormat + +The **AreaFormat** record specifies the patterns and colors used in a filled region of a **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). If this record is not present in the sequence of records that conforms to the **SS rule** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) of the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), the patterns and colors used are specified by the default values of the fields of this record. + +[TABLE] + +**rgbFore (4 bytes):** A **LongRGB structure** (section [2.5.177](#longrgb)) that specifies the [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) of the [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e).[\<23\>](#Appendix_A_23) The default value of this field is automatically selected from the next available color in the **chart** (section 2.2.3.3) color table. + +**rgbBack (4 bytes):** A **LongRGB structure** (section 2.5.177) that specifies the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) of the fill pattern.[\<24\>](#Appendix_A_24) The default value of this field is 0xFFFFFF. + +**fls (2 bytes):** An unsigned integer that specifies the type of fill pattern. If **fls** is neither 0x0000 nor 0x0001, this record MUST be immediately followed by a corresponding **GelFrame** record (section [2.4.131](#gelframe)) that specifies the fill pattern. The fillType as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.3.7.1 of the **OPT1** field of the corresponding **GelFrame** record (section 2.4.131) MUST be **msofillPattern** as specified in \[MS-ODRAW\] section 2.4.11. The default value of this field is 0x0001. **fls** MUST be a value from the following table: + +[TABLE] + +**A - fAuto (1 bit):** A bit that specifies whether the fill colors are automatically set. If **fls is equal to** 0x1 formatting is automatic. The default value of this field is 1. + +**B - fInvertNeg (1 bit):** A bit that specifies whether the foreground and background are swapped when the data value of the filled area is negative. This field MUST be ignored if the formatting is not being applied to a **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) on a bar or column **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)). The default value of this field is 0. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +**icvFore (2 bytes):** An **IcvChart structure** (section [2.5.162](#icvchart)) that specifies the foreground color of the fill pattern. The default value of this field is automatically selected from the next available color in the **chart** (section 2.2.3.3) color table. + +**icvBack (2 bytes):** An **IcvChart structure** (section 2.5.162) that specifies the background color of the fill pattern. The default value of this field is 0x0009. + +### Array + +The **Array** record specifies an array **formula** (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) for a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that performs calculations on one or more sets of values, and then returns either a single result or multiple results across a continuous range of cells. This record is preceded by a single **Formula** record (section [2.4.127](#formula)) that defines the first cell in the range that uses this array **formula** (section 2.2.2). Other **Formula** records (section 2.4.127) that use this array **formula** (section 2.2.2) follow later in the file, not necessarily in a contiguous sequence. **Formula** records (section 2.4.127) that use this array **formula** (section 2.2.2) MUST have a **cell** field that is within the range specified in the **ref** field of this record and MUST have their **formula** begin with **PtgExp** (section [2.5.198.58](#ptgexp)). Also, each cell specified in the **ref** field MUST have a **Formula** (section 2.4.127) that uses this array **formula** (section 2.2.2). + +[TABLE] + +**ref (6 bytes):** A **Ref structure** (section [2.5.207](#ref)) that specifies the range of the array **formula** (section 2.2.2). + +**A - fAlwaysCalc (1 bit):** A bit that specifies whether the array **formula** (section 2.2.2) needs to be calculated during the next recalculation. + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +**unused (4 bytes):** Undefined and MUST be ignored. + +**formula (variable):** An **ArrayParsedFormula structure** (section [2.5.198.1](#arrayparsedformula)) that specifies the array **formula** (section 2.2.2). + +### AttachedLabel + +The **AttachedLabel** record specifies properties of a **data label** (section [2.2.3.11](#Section_cac7f43a3af142f58ff2814c2870427f)) on a **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)), **series** (section [2.2.3.9](#Section_527ce4dfc9f84e50a314d4b07519593c)), or **data point** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)). Refer to the **data label** (section 2.2.3.11) overview for additional information about how this record is used and when this record is ignored. + +[TABLE] + +**A - fShowValue (1 bit):** A bit that specifies whether the value, or the vertical value on bubble or scatter **chart groups** (section 2.2.3.7), is displayed in the **data label** (section 2.2.3.11). + +This value MUST be 0 if this record is in a **chart group** (section 2.2.3.7) and either **fShowLabelAndPerc** or **fShowPercent** is equal to 1. + +**B - fShowPercent (1 bit):** A bit that specifies whether the value, represented as a percentage of the sum of the values of the **series** (section 2.2.3.9) the **data label** (section 2.2.3.11) is associated with, is displayed in the **data label** (section 2.2.3.11). + +MUST equal 0 if the **chart group** (section 2.2.3.7) type of the corresponding **chart group** (section 2.2.3.7), **series** (section 2.2.3.9), or **data point** (section 2.2.3.10), is not bar of pie, doughnut, pie, or pie of pie **chart group** (section 2.2.3.7). + +If this record is contained in a **chart group** (section 2.2.3.7) and **fShowLabelAndPerc** is equal to 1 then this field MUST equal 1. + +**C - fShowLabelAndPerc (1 bit):** A bit that specifies whether the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) name and value, represented as a percentage of the sum of the values of the **series** (section 2.2.3.9) the **data label** (section 2.2.3.11) is associated with, are displayed in the **data label** (section 2.2.3.11). + +MUST equal 0 if the **chart group** (section 2.2.3.7) type of the corresponding **chart group** (section 2.2.3.7), **series** (section 2.2.3.9), or **data point** (section 2.2.3.10), is not bar of pie, doughnut, pie, or pie of pie **chart group** (section 2.2.3.7). + +**D - unused (1 bit):** Undefined and MUST be ignored. + +**E - fShowLabel (1 bit):** A bit that specifies whether the category, or the horizontal value on bubble or scatter **chart groups** (section 2.2.3.7), is displayed in the **data label** (section 2.2.3.11) on a non-area **chart group** (section 2.2.3.7), or the **series** (section 2.2.3.9) name is displayed in the **data label** (section 2.2.3.11) on an area **chart group** (section 2.2.3.7). + +This field MUST equal 0 if this record is contained in a **chart group** (section 2.2.3.7) and one of the following conditions is satisfied: + +- The **fShowValue** field is equal to 1. + +- The **fShowLabelAndPerc** field is equal to 0 and the **fShowPercent** field is equal to 1. + +**F - fShowBubbleSizes (1 bit):** A bit that specifies whether the [**bubble size**](#gt_3a0cf938-5b61-4460-bdbb-3540d84d4180) is displayed in the **data label** (section 2.2.3.11). + +MUST equal 0 if the **chart group** (section 2.2.3.7) type of the corresponding **chart group** (section 2.2.3.7), **series** (section 2.2.3.9), or **data point** (section 2.2.3.10) is not bubble **chart group** (section 2.2.3.7). + +If the current record is contained in a **chart group** (section 2.2.3.7) and **fShowPercent**, **fShowValue**, or **fShowLabel** equal 1, this field MUST equal 0. + +**G - fShowSeriesName (1 bit):** A bit that specifies whether the **data label** (section 2.2.3.11) contains the name of the **series** (section 2.2.3.9). + +If the current record is contained in a **chart group** (section 2.2.3.7) and **fShowLabelAndPerc**, **fShowPercent**, **fShowValue**, **fShowValue**, **fShowLabel**, or **fShowBubbleSizes** equal 1 then this MUST equal to 0. + +**reserved (9 bits):** MUST be zero, and MUST be ignored. + +### AutoFilter + +The **AutoFilter** record specifies an [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). An **Lbl record** (section [2.4.150](#lbl)) where the **Name** field has a value of 0x0D (\_FilterDatabase) MUST exist for the current [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). The **rgce.rgce** field of the **Lbl record** (section 2.4.150) MUST consist of a single **PtgArea3d operand** (section [2.5.198.28](#ptgarea3d)).) + +[TABLE] + +**iEntry (2 bytes):** An unsigned integer that specifies the sheet (1) column that this AutoFilter applies to. The column index is determined by the following formula: + +((the **area.columnFirst** field of the **PtgArea3d** (section 2.5.198.28) in the **rgce.rgce** field of the **Lbl record** (section 2.4.150) where the **Name** field is equal to 0x0D (\_FilterDatabase) and the **Lbl record** (section 2.4.150) is for the current sheet (1)) + **iEntry**). + +The value of **iEntry** MUST be less than the **cEntries** field of the proceeding **AutoFilterInfo** record (section [2.4.8](#autofilterinfo)). + +**A - wJoin (2 bits):** A **Boolean** (section [2.5.14](#boolean)) that specifies whether **doper1** and **doper2** are combined using a logical AND operation or a logical OR operation. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | **doper1** and **doper2** are combined using a logical AND operation. | +| 1 | **doper1** and **doper2** are combined using a logical OR operation. | + +If **fTopN** is 1, **wJoin** is undefined and MUST be ignored. + +**B - fSimple1 (1 bit):** A bit that specifies whether an application-specific performance optimization can be used to compute this AutoFilter. MUST be 1 if and only if **doper1.vt** is 0x06 and **doper1.vtValue** is not a regular expression string, or **doper1.vt** is 0x0C, or **doper1.vt** is 0x0E. If **fTopN** is 1, **fSimple1** is undefined and MUST be ignored. + +**C - fSimple2 (1 bit):** A bit that specifies whether an application-specific performance optimization can be used to compute this AutoFilter. MUST be 1 if and only if **doper2.vt** is 0x06 and **doper2.vtValue** is not a regular expression string, or **doper2.vt** is 0x0C, or **doper2.vt** is 0x0E. If **fTopN** is 1, **fSimple2** is undefined and MUST be ignored. + +**D - fTopN (1 bit):** A bit that specifies whether the AutoFilter is a [**Top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9). + +**E - fTop (1 bit):** A bit that specifies whether the Top N filter selects the bottom items or the top items. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------| +| 0 | Top N filter selects the bottom items. | +| 1 | Top N filter selects the top items. | + +If **fTopN** is 0, **fTop** is undefined and MUST be ignored. + +**F - fPercent (1 bit):** A bit that specifies whether the Top N filter selects a count of items or a percent of items. MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------------| +| 0 | Top N filter selects a count of items. | +| 1 | Top N filter selects a percent of items. | + +If **fTopN** is 0, **fPercent** is undefined and MUST be ignored. + +**wTopN (9 bits):** An unsigned integer that specifies the number of Top N filter items to show. If **fTopN** is 0, **wTopN** MUST be ignored. If **fTopN** is 1, **wTopN** MUST be greater than or equal to 1 and less than or equal to 500. + +**doper1 (10 bytes):** An **AFDOper structure** (section [2.5.5](#afdoper)) that specifies the first AutoFilter condition. If **fTopN** is 1, **doper1** is undefined and MUST be ignored. + +**doper2 (10 bytes):** An **AFDOper structure** (section 2.5.5) that specifies the second AutoFilter condition. If **fTopN** is 1, **doper2** is undefined and MUST be ignored. + +**str1 (variable):** An optional **XLUnicodeStringNoCch structure** (section [2.5.296](#xlunicodestringnocch)) that specifies the string comparison constant for **doper1**. MUST exist if and only if **doper1.vt** is equal to 0x06. The length MUST be equal to **doper1.vtValue.cch**. + +**str2 (variable):** An optional **XLUnicodeStringNoCch structure** (section 2.5.296) that specifies the string comparison constant for **doper2**. MUST exist if and only if **doper2.vt** is equal to 0x06. The length MUST be equal to **doper2.vtValue.cch**. + +### AutoFilter12 + +The **AutoFilter12** record specifies [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) properties. + +[TABLE] + +**frtRefHeader (12 bytes):** An **FrtRefHeader structure** (section [2.5.137](#frtrefheader)). The **frtRefHeader.rt** MUST be 0x087E. **frtRefHeader.grbitFrt.fFrtRef** MUST be 0x1. The **frtRefHeader.ref8** field MUST refer to the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with this record. + +**iEntry (2 bytes):** An unsigned integer that specifies the [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) column that this AutoFilter applies to. The column index is determined by the following formula: + +**frtRefHeader**.**ref8**.**colFirst** + **iEntry**. + +The value of **iEntry** MUST be less than or equal to 255. + +**fHideArrow (4 bytes):** A **Boolean** (section [2.5.14](#boolean)) that specifies whether the user interface used to display AutoFilter settings is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**ft (4 bytes):** An unsigned integer that specifies the [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) type. MUST be one of the values in the table specified in **rgb.** + +**cft (4 bytes):** An unsigned integer that specifies the [**custom filter**](#gt_8593ee2f-c2dd-4793-a684-45fe40c840d2) type. MUST be one of the values in the following table: + +| Value | Meaning | +|----|----| +| 0x00000000 | No custom filter | +| 0x00000001 | The custom filter displays items that are above average. | +| 0x00000002 | The custom filter displays items that are below average. | +| 0x00000008 | The custom filter displays items that are from tomorrow. | +| 0x00000009 | The custom filter displays items that are from today. | +| 0x0000000A | The custom filter displays items that are from yesterday. | +| 0x0000000B | The custom filter displays items that are from next week. | +| 0x0000000C | The custom filter displays items that are from this week. | +| 0x0000000D | The custom filter displays items that are from last week | +| 0x0000000E | The custom filter displays items that are from next month. | +| 0x0000000F | The custom filter displays items that are from this month. | +| 0x00000010 | The custom filter displays items that are from last month. | +| 0x00000011 | The custom filter displays items that are from next quarter. | +| 0x00000012 | The custom filter displays items that are from this quarter. | +| 0x00000013 | The custom filter displays items that are from last quarter. | +| 0x00000014 | The custom filter displays items that are from next year. | +| 0x00000015 | The custom filter displays items that are from this year. | +| 0x00000016 | The custom filter displays items that are from last year. | +| 0x00000017 | The custom filter displays items that are from year-to-date. | +| 0x00000018 | The custom filter displays items that are from the 1^(st) quarter. | +| 0x00000019 | The custom filter displays items that are from the 2^(nd) quarter. | +| 0x0000001A | The custom filter displays items that are from the 3^(rd) quarter. | +| 0x0000001B | The custom filter displays items that are from the 4^(th) quarter. | +| 0x0000001C | The custom filter displays items that are from the 1^(st) month. | +| 0x0000001D | The custom filter displays items that are from the 2^(nd) month. | +| 0x0000001E | The custom filter displays items that are from the 3^(rd) month. | +| 0x0000001F | The custom filter displays items that are from the 4^(th) month. | +| 0x00000020 | The custom filter displays items that are from the 5^(th) month. | +| 0x00000021 | The custom filter displays items that are from the 6^(th) month. | +| 0x00000022 | The custom filter displays items that are from the 7^(th) month. | +| 0x00000023 | The custom filter displays items that are from the 8^(th) month. | +| 0x00000024 | The custom filter displays items that are from the 9^(th) month. | +| 0x00000025 | The custom filter displays items that are from the 10^(th) month. | +| 0x00000026 | The custom filter displays items that are from the 11^(th) month. | +| 0x00000027 | The custom filter displays items that are from the 12^(th) month. | + +**cCriteria (4 bytes):** An unsigned integer that specifies the number of items in **rgCriteria**. MUST be ignored if **ft** is nonzero. + +**cDateGroupings (4 bytes):** An unsigned integer that specifies the number of items in **rgDateGroupings**. MUST be ignored if **ft** is nonzero. + +**A - reserved1 (3 bits):** MUST be zero, and MUST be ignored. + +**B - fWorksheetAutoFilter (1 bit):** A bit that specifies whether this filter is a sheet (1) AutoFilter. A sheet (1) AutoFilter filters items in the sheet specified by the **Worksheet part** (section [2.1.7.20.5](#Section_f41c06f2905749a18c3fa4a4d211fc56)) that contains this record. MUST be 1 if and only if **idList** is equal to 0xFFFFFFFF. + +**unused1 (12 bits):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +**idList (4 bytes):** An unsigned integer that specifies the [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) with items that are filtered by this AutoFilter. MUST either be equal to the **idList** field of the associated **TableFeatureType structure** (section [2.5.266](#tablefeaturetype)) or MUST be 0xFFFFFFFF if this filter is a sheet (1) AutoFilter. + +**guidSview (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that specifies the associated **UserSViewBegin** record (section [2.4.334](#usersviewbegin)). MUST be 0, or MUST be equal to the **guid** field of the preceding **UserSViewBegin** record (section 2.4.334). + +**rgb (variable):** A variable type field whose type and meaning is specified by the value of **ft**, as defined in the following table: + +| Value of ft | Type of rgb | +|----|----| +| 0x00000000 | **rgb** does not exist. Either **cCriteria** or **cDateGroupings** MUST be greater than zero. | +| 0x00000001 | **rgb** is a **DXFN12NoCB structure** (section [2.5.98](#dxfn12nocb)) that specifies the cell color to use for the filter. | +| 0x00000002 | **rgb** is a **DXFN12NoCB structure** (section 2.5.98) that specifies the cell [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) to use for the filter. | +| 0x00000003 | **rgb** is an **AF12CellIcon structure** (section [2.5.2](#af12cellicon)) that specifies the cell [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) to use for the filter. | + +**rgCriteria (variable):** An optional array of **AF12Criteria structures** (section [2.5.3](#af12criteria)). The length of the array MUST be equal to **cCriteria**. MUST exist if and only if **ft** is zero and **cCriteria** is nonzero. Each element of the array MUST be specified in a separate **ContinueFrt12** record (section [2.4.62](#continuefrt12)). + +**rgDateGroupings (variable):** An optional array of **AF12DateInfo structures** (section [2.5.4](#af12dateinfo)). The length of the array MUST be equal to **cDateGroupings**. MUST exist if and only if **ft** is zero and **cDateGroupings** is nonzero. Each element of the array MUST be specified in a separate **ContinueFrt12** record (section 2.4.62). + +### AutoFilterInfo + +The **AutoFilterInfo** record specifies the number of columns that have [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) enabled and specifies the beginning of a collection of records as defined by the [Macro Sheet Substream](#Section_0dddd943f77a4fc2bf92868acb4587f7) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) and [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF. The collection of records specifies AutoFilter information and data used for sorting a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +[TABLE] + +**cEntries (2 bytes):** An unsigned integer that specifies the number of columns that have AutoFilter enabled. MUST be greater than or equal to 1 and less than or equal to 256. + +### AxcExt + +The **AxcExt** record specifies additional extension properties of a date **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)), along with a **CatSerRange record** (section [2.4.39](#catserrange)). + +[TABLE] + +**catMin (2 bytes):** An unsigned integer that specifies the minimum date, as a date in the [**date system**](#gt_cfc29c5e-eb23-4077-b6eb-492f20f5c87f) specified by the **Date1904 record** (section [2.4.77](#date1904)), in the units defined by **duBase**. SHOULD[\<25\>](#Appendix_A_25) be less than or equal to **catMax**. If **fAutoMin** is set to 1, MUST be ignored. If **fDateAxis** is set to 0, MUST be ignored. + +**catMax (2 bytes):** An unsigned integer that specifies the maximum date, as a date in the date system specified by the **Date1904 record** (section 2.4.77), in the units defined by **duBase**. SHOULD[\<26\>](#Appendix_A_26) be greater than or equal to **catMin**. If **fAutoMax** is set to 1, MUST be ignored. If **fDateAxis** is set to 0, MUST be ignored. + +**catMajor (2 bytes):** An unsigned integer that specifies the interval at which the [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) are displayed on the **axis** (section 2.2.3.6), in the unit defined by **duMajor**. MUST be greater than or equal to **catMinor** when **duMajor** is equal to **duMinor**. If **fAutoMajor** is set to 1, MUST be ignored. If **fDateAxis** is set to 0, MUST be ignored. + +**duMajor (2 bytes):** A **DateUnit enumeration** (section [2.5.66](#dateunit)) that specifies the unit of time to use for **catMajor** when the **axis** (section 2.2.3.6) is a date **axis** (section 2.2.3.6). If **fDateAxis** is set to 0, MUST be ignored. + +**catMinor (2 bytes):** An unsigned integer that specifies the interval at which the [**minor tick marks**](#gt_c2eb605a-6c5a-427e-8608-f16940de82a6) are displayed on the **axis** (section 2.2.3.6), in a unit defined by **duMinor**. MUST be less than or equal to **catMajor** when **duMajor** is equal to **duMinor**. If **fAutoMinor** is set to 1, MUST be ignored. If **fDateAxis** is set to 0, MUST be ignored. + +**duMinor (2 bytes):** A **DateUnit enumeration** (section 2.5.66) that specifies the unit of time to use for **catMinor** when the **axis** (section 2.2.3.6) is a date **axis** (section 2.2.3.6). If **fDateAxis** is set to 0, MUST be ignored. + +**duBase (2 bytes):** A **DateUnit enumeration** (section 2.5.66) that specifies the smallest unit of time used by the **axis** (section 2.2.3.6). If **fAutoBase** is set to 1, this field MUST be ignored. If **fDateAxis** is set to 0, MUST be ignored. + +**catCrossDate (2 bytes):** An unsigned integer that specifies at which date, as a date in the date system specified by the **Date1904 record** (section 2.4.77), in the units defined by **duBase**, the value **axis** (section 2.2.3.6) crosses this **axis** (section 2.2.3.6). If **fDateAxis** is set to 0, MUST be ignored. If **fAutoCross** is set to 1, MUST be ignored. + +**A - fAutoMin (1 bit):** A bit that specifies whether **catMin** is calculated automatically. If **fDateAxis** is set to 0, MUST be ignored. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **catMin** is used and **catMin** is not calculated automatically. | +| 1 | **catMin** is calculated such that the minimum **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) value can be displayed. | + +**B - fAutoMax (1 bit):** A bit that specifies whether **catMax** is calculated automatically. If **fDateAxis** is set to 0, then **fAutoMax** MUST be ignored. If the value of the **fMaxCross** field in the **CatSerRange** (section 2.4.39) record is 1, then **fAutoMax** MUST be ignored. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **catMax** is used and **catMax** is not calculated automatically. | +| 1 | **catMax** is calculated such that the minimum **data points** (section 2.2.3.10) value can be displayed. | + +**C - fAutoMajor (1 bit):** A bit that specifies whether **catMajor** is calculated automatically. If **fDateAxis** is set to 0, MUST be ignored. + +| Value | Meaning | +|----|----| +| 0 | The value specified by **catMajor** is used and **catMajor** is not calculated automatically. | +| 1 | **catMajor** is calculated automatically. | + +**D - fAutoMinor (1 bit):** A bit that specifies whether **catMinor** is calculated automatically. If **fDateAxis** is set to 0, MUST be ignored. + +| Value | Meaning | +|----|----| +| 0 | The value specified by **catMinor** is used and **catMinor** is not calculated automatically. | +| 1 | **catMinor** is calculated automatically. | + +**E - fDateAxis (1 bit):** A bit that specifies whether the **axis** (section 2.2.3.6) is a date **axis** (section 2.2.3.6). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The **axis** (section 2.2.3.6) is not a date **axis** (section 2.2.3.6). | +| 1 | The **axis** (section 2.2.3.6) is a date **axis** (section 2.2.3.6). | + +**F - fAutoBase (1 bit):** A bit that specifies whether the units of the date **axis** (section 2.2.3.6) are chosen automatically. If **fDateAxis** is set to 0, MUST be ignored. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **duBase** is used and **duBase** is not computed automatically. | +| 1 | **duBase** is calculated automatically. | + +**G - fAutoCross (1 bit):** A bit that specifies whether **catCrossDate** is calculated automatically. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **catCrossDate** is used and **catCrossDate** is not calculated automatically. | +| 1 | **catCrossDate** is calculated automatically such that it can be displayed. | + +**H - fAutoDate (1 bit):** A bit that specifies whether the **axis** (section 2.2.3.6) type is detected automatically. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The **axis** (section 2.2.3.6) will stay as specified by the **fDateAxis** field. | +| 1 | The **axis** (section 2.2.3.6) will automatically become a date **axis** (section 2.2.3.6) when the data it is related to contains date values. Otherwise, the **axis** (section 2.2.3.6) will be a [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) **axis** (section 2.2.3.6). | + +**reserved (8 bits):** MUST be zero, and MUST be ignored. + +### AxesUsed + +The **AxesUsed** record specifies the number of **axis groups** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)) on the **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). + +[TABLE] + +**cAxes (2 bytes):** An unsigned integer that specifies the number of **axis groups** (section 2.2.3.5) on the **chart** (section 2.2.3.3). MUST be a value from the following table: + +| Value | Axis present | +|----|----| +| 0x0001 | A single primary **axis group** (section 2.2.3.5) is present. | +| 0x0002 | Both a primary **axis group** (section 2.2.3.5) and a secondary **axis group** (section 2.2.3.5) are present. | + +If no **chart groups** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) are present on the **chart** (section 2.2.3.3), MUST be 0x0001. If the **chart sheet substream** (section [2.1.7.20.1](#Section_732ff614d939416bb7c76d983471ff11)) contains a **Chart3d record** (section [2.4.46](#chart3d)), MUST be 0x0001. + +### Axis + +The **Axis** record specifies properties of an **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)) and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that specifies an **axis** (section 2.2.3.6). + +[TABLE] + +**wType (2 bytes):** An unsigned integer that specifies the type of **axis** (section 2.2.3.6). The value MUST be 0x0000 if the record is the first **axis** (section 2.2.3.6) in the **axis group** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)). The value MUST be 0x0001 if the record is the second **axis** (section 2.2.3.6) in the **axis group** (section 2.2.3.5). The value MUST be 0x0002 if the record is the third **axis** (section 2.2.3.6) in the **axis group** (section 2.2.3.5). MUST be a value from the following table: + +| Value | Axis type | +|----|----| +| 0x0000 | **Axis** (section 2.2.3.6) type is a horizontal value **axis** (section 2.2.3.6) for a scatter **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) or a bubble **chart group** (section 2.2.3.7), or [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) **axis** (section 2.2.3.6) for all other **chart group** (section 2.2.3.7) types. | +| 0x0001 | **Axis** (section 2.2.3.6) type is a vertical value **axis** (section 2.2.3.6) for a scatter **chart group** (section 2.2.3.7) or a bubble **chart group** (section 2.2.3.7), or value **axis** (section 2.2.3.6) for all other **chart group** (section 2.2.3.7) types. | +| 0x0002 | **Axis** (section 2.2.3.6) type is a series **axis** (section 2.2.3.6). | + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved3 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved4 (4 bytes):** MUST be zero, and MUST be ignored. + +### AxisLine + +The **AxisLine** record specifies which part of the **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)) is specified by the **LineFormat** record (section [2.4.156](#lineformat)) that follows. + +[TABLE] + +**id (2 bytes):** An unsigned integer that specifies which part of the **axis** (section 2.2.3.6) is defined by the **LineFormat** record (section 2.4.156) that follows be unique among all other **id** field values in AxisLine records in the current **axis** (section 2.2.3.6). MUST be greater than the **id** field values in preceding AxisLine records in the current **axis** (section 2.2.3.6). MUST be a value from the following table: + +| Value | Part of the axis defined | +|----|----| +| 0x0000 | The **axis** (section 2.2.3.6) line itself. | +| 0x0001 | The [**major gridlines**](#gt_2803347c-6396-46a5-9ede-6bef1149b013) along the **axis** (section 2.2.3.6). | +| 0x0002 | The [**minor gridlines**](#gt_49980976-6314-43ad-ad51-8d3e55ef4b59) along the **axis** (section 2.2.3.6). | +| 0x0003 | The [**walls**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c) or [**floor**](#gt_dc38c098-e0d3-4701-9656-5f2cf4d80f29) of a 3-D **chart** (section [2.2.3.3](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c)). | + +In the case where **id** is set to 0x0003, this record MUST be preceded by an **Axis** record (section [2.4.11](#axis-1)) with the **wType** set to a value from the following table: + +| Value of wType | Formatted object | +|----------------|-------------------------------------------------| +| 0x0000 | The walls of a 3-D **chart** (section 2.2.3.3). | +| 0x0001 | The floor of a 3-D **chart** (section 2.2.3.3). | + +### AxisParent + +The **AxisParent** record specifies properties of an **axis group** (section [2.2.3.5](#Section_578b739742624944b5a67ee6d4d3bb55)) and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that specifies an **axis group** (section 2.2.3.5). + +[TABLE] + +**iax (2 bytes):** A **Boolean** (section [2.5.14](#boolean)) that specifies whether the **axis group** (section 2.2.3.5) is primary or secondary. MUST be a value from the following table. This field MUST equal 0 when in the first **AxisParent record** in the Chart Sheet Substream ABNF. This field MUST equal 1 when in the second **AxisParent record** in the Chart Sheet Substream ABNF. + +| Value | Meaning | +|--------|------------------------------------------------| +| 0x0000 | **Axis group** (section 2.2.3.5) is primary. | +| 0x0001 | **Axis group** (section 2.2.3.5) is secondary. | + +**unused (16 bytes):** Undefined and MUST be ignored. + +### Backup + +The **Backup** record specifies whether to save a backup copy of the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +[TABLE] + +**fBackup (2 bytes):** A **Boolean** (section [2.5.14](#boolean)) that specifies whether to save a backup file. The value 1 means that a backup copy of the workbook is saved when the workbook is saved. + +### Bar + +The **Bar** record specifies that the **chart group** (section [2.2.3.7](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) is a bar **chart group** (section 2.2.3.7) or a column **chart group** (section 2.2.3.7), and specifies the **chart group** (section 2.2.3.7) attributes. + +[TABLE] + +**pcOverlap (2 bytes):** A signed integer that specifies the overlap between **data points** (section [2.2.3.10](#Section_9c986ad250d44fa1a157063ac5c971a0)) in the same [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) as a percentage of the **data points** (section 2.2.3.10) width. MUST be greater than or equal to -100 and less than or equal to 100. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -100 to -1 | Size of the separation between **data points** (section 2.2.3.10). | +| 0 | No overlap. | +| 1 to 100 | Size of the overlap between **data points** (section 2.2.3.10). | + +**pcGap (2 bytes):** An unsigned integer that specifies the width of the gap between the categories and the left and right edges of the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) as a percentage of the **data point** (section 2.2.3.10) width divided by 2. It also specifies the width of the gap between adjacent categories as a percentage of the **data point** (section 2.2.3.10) width. MUST be less than or equal to 500. + +**A - fTranspose (1 bit):** A bit that specifies whether the **data points** (section 2.2.3.10) and value **axis** (section [2.2.3.6](#Section_4117f73aa0f348d89c0f65864918ffb3)) are horizontal (for a bar **chart group** (section 2.2.3.7)) or vertical (for a column **chart group** (section 2.2.3.7)). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | **Data points** (section 2.2.3.10) and value **axis** (section 2.2.3.6) are vertical. | +| 1 | **Data points** (section 2.2.3.10) and value **axis** (section 2.2.3.6) are horizontal. | + +**B - fStacked (1 bit):** A bit that specifies whether the **data points** (section 2.2.3.10) in the **chart group** (section 2.2.3.7) that share the same category are stacked. + +**C - f100 (1 bit):** A bit that specifies whether the **data points** (section 2.2.3.10) in the **chart group** (section 2.2.3.7) are displayed as a percentage of the sum of all **data points** (section 2.2.3.10) in the **chart group** (section 2.2.3.7) that share the same category. MUST be 0 if **fStacked** is 0. + +**D - fHasShadow (1 bit):** A bit that specifies whether one or more **data points** (section 2.2.3.10) in the **chart group** (section 2.2.3.7) has shadows. + +**reserved (12 bits):** MUST be zero, and MUST be ignored. + +### BCUsrs + +The **BCUsrs** record specifies the beginning of a collection of **UsrInfo records** (section [2.4.340](#usrinfo)) as defined the [user names](#Section_1b98bc4df7c640a088dba99426635acd) stream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of **UsrInfo records** (section 2.4.340) specifies information about a user who currently has the **shared workbook** (section [2.2.11](#Section_e45a62c4490f4304a09668908b57dacc)) open. + +[TABLE] + +**iCount (2 bytes):** An unsigned integer that specifies the number of users of an operating system [**Briefcase**](#gt_f95e9f06-66e9-4128-bd17-f8b60e41ef31) who have the current [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) open. + +### Begin + +The **Begin** record specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies properties of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +### BigName + +The **BigName** record specifies a name/value pair of arbitrary user-defined data that is associated with the current [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**reserved (2 bytes):** MUST be 0x1000, and MUST be ignored. + +**lcbData (4 bytes):** A signed integer that specifies the byte count for **rgbData**. MUST be greater than or equal to zero. + +**cbName (1 byte):** An unsigned integer that specifies the byte count for **rgbName**. + +**rgbName (variable):** An array of ANSI characters whose length is specified by **cbName** that specifies the name of the custom property. + +**rgbData (variable):** An array of bytes that specifies the value of the custom property. It can continue with the [ContinueBigName](#continuebigname) records. + +### BkHim + +The **BkHim** record specifies image data for a [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) background. + +[TABLE] + +**cf (2 bytes):** A signed integer that specifies the image format. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0009 | Bitmap format. The image data is stored in a bitmap format as described in [\[MSDN-BMP\]](https://go.microsoft.com/fwlink/?LinkId=89960). | +| 0x000E | Native format. The image data is stored in the native format of another application and cannot be directly processed. | + +**reserved (2 bytes):** MUST be 0x0001, and MUST be ignored. + +**lcb (4 bytes):** A signed integer that specifies the size of **imageBlob** in bytes. MUST be greater than or equal to 1. + +**imageBlob (variable):** An array of bytes that specifies the image data for the given format. + +### Blank + +The **Blank** record specifies an empty [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) with no formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) or value. + +[TABLE] + +**cell (6 bytes):** A [Cell](#cell) structure that specifies the cell. + +### BOF + +The **BOF** record specifies the beginning of the individual substreams as specified by the [workbook](#Section_f682f4b08c6b444e83f852d156f1e8ba) section. It also specifies history information for the substreams. + +[TABLE] + +**vers (2 bytes):** An unsigned integer that specifies the [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) version of the file. The value MUST be 0x0600. + +**dt (2 bytes):** An unsigned integer that specifies the document type of the substream of records following this record. For more information about the layout of the sub-streams in the workbook stream see [File Structure](#Section_2e6147d9e8ad48b09ff7bbfc51ca950d). MUST be a value from the following table: + +[TABLE] + +**rupBuild (2 bytes):** An unsigned integer that specifies the [**build identifier**](#gt_0748643f-8a66-42ea-959a-3acd533eedc5). + +**rupYear (2 bytes):** An unsigned integer that specifies the year when this BIFF version was first created. The value MUST be 0x07CC[\<27\>](#Appendix_A_27) or 0x07CD. + +**A - fWin (1 bit):** A bit that specifies whether this file was last edited on a Windows platform. The value MUST be 1. + +**B - fRisc (1 bit):** A bit that specifies whether the file was last edited on a Reduced Instruction Set Computing (RISC) platform. The value MUST be 0. + +**C - fBeta (1 bit):** A bit that specifies whether this file was last edited by a [**beta**](#gt_b7cc0e52-196c-41e1-afa2-14da4352ac5d) version of the application. The value MUST be 0. + +**D - fWinAny (1 bit):** A bit that specifies whether this file has ever been edited on a Windows platform. The value SHOULD[\<28\>](#Appendix_A_28) be 1. + +**E - fMacAny (1 bit):** A bit that specifies whether this file has ever been edited on a Macintosh platform. The value MUST be 0. + +**F - fBetaAny (1 bit):** A bit that specifies whether this file has ever been edited by a beta version of the application. The value MUST be 0. + +**G - unused1 (2 bits):** Undefined and MUST be ignored. + +**H - fRiscAny (1 bit):** A bit that specifies whether this file has ever been edited on a RISC platform. The value MUST be 0. + +**I - fOOM (1 bit):** A bit that specifies whether this file had an [**out-of-memory**](#gt_1607fcec-cc19-40a2-9a61-678f90f5943e) failure. + +**J - fGlJmp (1 bit):** A bit that specifies whether this file had an out-of-memory failure during rendering. + +**K - unused2 (2 bits):** Undefined, and MUST be ignored. + +**L - fFontLimit (1 bit):** A bit that specified that whether this file hit the 255 [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) limit[\<29\>](#Appendix_A_29). + +**M - verXLHigh (4 bits):** An unsigned integer that specifies the highest version of the application that once saved this file. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies the highest version of the application that has ever saved this file. [\<30\>](#Appendix_A_30) | +| 0x1 | Specifies the highest version of the application that has ever saved this file. [\<31\>](#Appendix_A_31) | +| 0x2 | Specifies the highest version of the application that has ever saved this file. [\<32\>](#Appendix_A_32) | +| 0x3 | Specifies the highest version of the application that has ever saved this file. [\<33\>](#Appendix_A_33) | +| 0x4 | Specifies the highest version of the application that has ever saved this file. [\<34\>](#Appendix_A_34) | +| 0x6 | Specifies the highest version of the application that has ever saved this file. [\<35\>](#Appendix_A_35) | +| 0x7 | Specifies the highest version of the application that has ever saved this file. [\<36\>](#Appendix_A_36) | + +**N - unused3 (1 bit):** Undefined, and MUST be ignored. + +**reserved1 (13 bits):** MUST be zero, and MUST be ignored. + +**verLowestBiff (8 bits):** An unsigned integer that specifies the BIFF version saved. The value MUST be 6. + +**O - verLastXLSaved (4 bits):** An unsigned integer that specifies the application that saved this file most recently. The value MUST be the value of field **verXLHigh** or less. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies the highest version of the application that has ever saved this file. [\<37\>](#Appendix_A_37) | +| 0x1 | Specifies the highest version of the application that has ever saved this file.[\<38\>](#Appendix_A_38) | +| 0x2 | Specifies the highest version of the application that has ever saved this file.[\<39\>](#Appendix_A_39) | +| 0x3 | Specifies the highest version of the application that has ever saved this file. [\<40\>](#Appendix_A_40) | +| 0x4 | Specifies the highest version of the application that has ever saved this file.[\<41\>](#Appendix_A_41) | +| 0x6 | Specifies the highest version of the application that has ever saved this file.[\<42\>](#Appendix_A_42) | +| 0x7 | Specifies the highest version of the application that has ever saved this file.[\<43\>](#Appendix_A_43) | + +**reserved2 (20 bits):** MUST be zero, and MUST be ignored. + +### BookBool + +The **BookBool** record specifies some of the properties associated with a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +[TABLE] + +**A - fNoSaveSup (1 bit):** A bit that specifies that [**external link**](#gt_496fd743-2045-4c53-81b9-83fb90a7fab1) values are saved in the workbook. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------| +| 0 | External link values are saved. | +| 1 | External link values are not saved. | + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fHasEnvelope (1 bit):** A bit that specifies whether the workbook has an envelope as a result of sending the workbook to a mail recipient. If **fEnvelopeVisible** is 1 or **fEnvelopeInitDone** is 1, then this bit MUST be 1. + +**D - fEnvelopeVisible (1 bit):** A bit that specifies whether the envelope is [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72). + +**E - fEnvelopeInitDone (1 bit):** A bit that specifies whether the envelope has been initialized. + +**F - grUpdateLinks (2 bits):** An unsigned integer that specifies when the application updates external links in the workbook. The value MUST be one of the following: + +| Value | Meaning | +|----|----| +| 0 | Prompt user to update. | +| 1 | Do not update, and do not prompt user. | +| 2 | Silently update external links. The application can choose to prompt the user because of security concerns[\<44\>](#Appendix_A_44). | + +**G - unused (1 bit):** Undefined and MUST be ignored. + +**H - fHideBorderUnselLists (1 bit):** A bit that specifies whether to hide borders of [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) that do not contain the [**active cell**](#gt_2c0759a5-6721-422b-8cb9-f4bb09e07c84)[\<45\>](#Appendix_A_45). + +**reserved2 (7 bits):** MUST be zero, and MUST be ignored. + +### BookExt + +The **BookExt** record specifies properties of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) file. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0863. + +**cb (4 bytes):** An unsigned integer that specifies the size of the record in bytes. + +**A - fDontAutoRecover (1 bit):** A bit that specifies whether [**AutoRecover**](#gt_082e4fd1-0461-4797-baa0-d2797f0ba555) is disabled for the workbook. + +**B - fHidePivotList (1 bit):** A bit that specifies whether the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) field list is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) for this workbook. + +**C - fFilterPrivacy (1 bit):** A bit that specifies whether personal information is removed from this workbook on save. + +**D - fEmbedFactoids (1 bit):** A bit that specifies whether [**smart tags**](#gt_2f57a49a-d503-4605-8798-0e53bd637609) are embedded in this workbook on save. + +**E - mdFactoidDisplay (2 bits):** A bit that specifies how smart tags are displayed in the workbook. The value MUST be one of the following: + +| Value | Meaning | +|----|----| +| 0x00 | The application will display the [**smart tag actions button**](#gt_7c1f7dd0-048a-433e-a5ac-98b32121bcb9) and the [**smart tag indicator**](#gt_62e83b67-c6c5-4a3e-8a09-2a5f0f39f65f). | +| 0x01 | The application will display the smart tag actions button only. The smart tag indicators will not be displayed. | +| 0x02 | The application will not display the smart tag actions button or the smart tag indicator. | + +**F - fSavedDuringRecovery (1 bit):** A bit that specifies whether the workbook was saved during AutoRecover. + +**G - fCreatedViaMinimalSave (1 bit):** A bit that specifies whether the workbook was created by a [**minimal save**](#gt_37ba5c27-ec42-4ccf-8122-86166df37c61) during [**data recovery**](#gt_667a7046-739a-4c24-9674-837d88e0031b). + +**H - fOpenedViaDataRecovery (1 bit):** A bit that specifies whether the workbook was opened by means of data recovery. + +**I - fOpenedViaSafeLoad (1 bit):** A bit that specifies whether the workbook was opened in [**safe load**](#gt_78d75560-7171-4a5d-be0e-3b8c14bc62c4) mode. + +**reserved (22 bits):** MUST be zero, and MUST be ignored. + +**grbit1 (1 byte):** A [BookExt_Conditional11](#bookext_conditional11) structure that specifies additional workbook-specific information. This structure MUST exist when **cb** is greater than 20. + +**grbit2 (1 byte):** A [BookExt_Conditional12](#bookext_conditional12) structure that specifies additional workbook-specific information. This structure MUST exist when **cb** is greater than 21. + +### BoolErr + +The **BoolErr** record specifies a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that contains either a Boolean value or an error value. + +[TABLE] + +**cell (6 bytes):** A [Cell](#cell) structure that specifies the cell. + +**bes (2 bytes):** A [Bes](#bes) structure that specifies a Boolean or an error value. + +### BopPop + +The **BopPop** record specifies that the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is a bar of pie chart group or a pie of pie chart group and specifies the chart group attributes. + +[TABLE] + +**pst (1 byte):** An unsigned integer that specifies whether this chart group is a bar of pie chart group or a pie of pie chart group. MUST be a value from the following table: + +| Value | Subtype | +|-------|------------------------| +| 0x01 | Pie of pie chart group | +| 0x02 | Bar of pie chart group | + +**fAutoSplit (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether the split point of the chart group is determined automatically. If the value is 1, when a bar of pie chart group or pie of pie chart group is initially created the [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) from the [**primary pie**](#gt_e2300016-b59d-4384-9b70-c000523747e0) are selected and inserted into the [**secondary bar/pie**](#gt_e452a278-4e13-44c6-9f1b-db3c93841bc6) automatically. + +**split (2 bytes):** An unsigned integer that specifies what determines the split between the primary pie and the secondary bar/pie. MUST be ignored if **fAutoSplit** is set to 1. MUST be a value from the following table: + +| Value | Type of split | Meaning | +|----|----|----| +| 0x0000 | Position | The data is split based on the position of the data point in the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) as specified by **iSplitPos**. | +| 0x0001 | Value | The data is split based on a threshold value as specified by **numSplitValue**. | +| 0x0002 | Percent | The data is split based on a percentage threshold and the data point values represented as a percentage as specified by **pcSplitPercent**. | +| 0x0003 | Custom | The data is split as arranged by the user. Custom split is specified in a following [BopPopCustom](#boppopcustom) record. | + +**iSplitPos (2 bytes):** A signed integer that specifies how many data points are contained in the secondary bar/pie. Data points are contained in the secondary bar/pie starting from the end of the series. For example, if the value is 2, the last 2 data points in the series are contained in the secondary bar/pie. MUST be a value greater than or equal to 0 and less than or equal to 32000. If the value is more than the number of data points in the series, the entire series will be in the secondary bar/pie, except for the first data point. If **split** is not set to 0x0000 or **fAutoSplit** is set to 1, this value MUST be ignored. + +**pcSplitPercent (2 bytes):** A signed integer that specifies the percentage below which each data point is contained in the secondary bar/pie as opposed to the primary pie. The percentage value of a data point is calculated using the following formula: + +(value of the data point x 100) / sum of all data points in the series + +If **split** is not set to 0x0002 or if **fAutoSplit** is set to 1, this value MUST be ignored + +**pcPie2Size (2 bytes):** A signed integer that specifies the size of the secondary bar/pie as a percentage of the size of the primary pie. MUST be a value greater than or equal to 5 and less than or equal to 200. + +**pcGap (2 bytes):** A signed integer that specifies the distance between the primary pie and the secondary bar/pie. The distance is specified as a percentage of the average width of the primary pie and secondary bar/pie. MUST be a value greater than or equal to 0 and less than or equal to 500, where 0 is 0% of the average width of the primary pie and the secondary bar/pie, and 500 is 250% of the average width of the primary pie and the secondary bar/pie. + +**numSplitValue (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the split when the **split** field is set to 0x0001. The value of this field specifies the threshold that selects which data points of the primary pie move to the secondary bar/pie. The secondary bar/pie contains any data points with a value less than the value of this field. If **split** is not set to 0x0001 or if **fAutoSplit** is set to 1, this value MUST be ignored. + +**A - fHasShadow (1 bit):** A bit that specifies whether one or more data points in the chart group have shadows. + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +### BopPopCustom + +The **BopPopCustom** record specifies which [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) in the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) are contained in the [**secondary bar/pie**](#gt_e452a278-4e13-44c6-9f1b-db3c93841bc6) instead of the [**primary pie**](#gt_e2300016-b59d-4384-9b70-c000523747e0). MUST follow a [BopPop](#boppop) record that has its **split** field set to Custom (0x0003). + +[TABLE] + +**cxi (2 bytes):** An unsigned integer that specifies to the number of data points in the series plus one. MUST be less than 32000. + +**rggrbit (variable):** A sequence of bits that specifies whether each data point in the series is contained in the primary pie or the secondary bar/pie. For each data point a corresponding bit specifies whether a data point is contained in the secondary bar/pie or primary pie as specified in the following table: + +| Value | **Meaning** | +|-------|---------------------------------------------------| +| 0 | Data point is contained in the primary pie. | +| 1 | Data point is contained in the secondary bar/pie. | + +The size of this field, in bytes, is calculated using the following formula: + +size of **rggrbit** in bytes = 1+floor(**cxi** / 8) + +The padding of this field, in bits, is calculated using the following formula: + +padding = size of **rggrbit** in bits - **cxi** + +The position of each bit in the sequence corresponds to the position of each data point in the series arranged as follows: + +- Any padding is placed in the most significant bits of the first byte. The next most significant bit of the first byte corresponds to the first data point in the series. If there are any more unused bits in the first byte, the next most significant bit corresponds to the second data point in the series. This pattern continues until there are no remaining unused bits in the first byte. + +- The most significant bit of the next byte corresponds to the next data point in the series. The next most significant bit contains the next data point in the series. This pattern continues for each byte in the sequence. + +- The least significant bit of the final byte is an additional bit that specifies whether the secondary bar/pie does not contain data points. If the value of the additional bit is 1, the value of every other bit MUST be 0. + +The following figure demonstrates this order: + +[TABLE] + +[TABLE] + +### BottomMargin + +The **BottomMargin** record specifies the bottom margin of the current [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**num (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the bottom margin of the current sheet (1) in inches. The value MUST be greater than or equal to 0 and less than or equal to 49. + +### BoundSheet8 + +The **BoundSheet8** record specifies basic information about a [**sheet (1)**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d), including the sheet (1) name, [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) state, and type of sheet (1). + +[TABLE] + +**lbPlyPos (4 bytes):** A FilePointer as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.5 that specifies the stream position of the start of the [BOF](#bof) record for the sheet (1). + +**A - hsState (2 bits):** An unsigned integer that specifies the hidden state of the sheet (1). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | [**Visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) | +| 0x01 | Hidden | +| 0x02 | Very Hidden; the sheet (1) is hidden and cannot be displayed using the user interface. | + +**unused (6 bits):** Undefined and MUST be ignored. + +**dt (8 bits):** An unsigned integer that specifies the sheet (1) type. MUST be a value from the following table: + +[TABLE] + +**stName (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) structure that specifies the unique case-insensitive name of the sheet (1). The character count of this string, **stName.cch,** MUST be greater than or equal to 1 and less than or equal to 31. The string MUST NOT contain the any of the following characters: + +- 0x0000 + +- 0x0003 + +- colon (:) + +- backslash (\\ + +- asterisk (\*) + +- question mark (?) + +- forward slash (/) + +- opening square bracket (\[) + +- closing square bracket (\]) + +The string MUST NOT begin or end with the single quote (') character. + +### BRAI + +The **BRAI** record specifies a reference to data in a sheet that is used by a part of a [series](#Section_527ce4dfc9f84e50a314d4b07519593c), [**legend entry**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e), [trendline](#Section_61d74ebc36714d6dbdc0626db604530d) or [error bars](#Section_762a461d0a45474ebd7d5994bb294af2). + +[TABLE] + +**id (1 byte):** An unsigned integer that specifies the part of the series, trendline, or error bars the referenced data specifies. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | Referenced data specifies the series, legend entry, or trendline name. Error bars name MUST be empty. | +| 0x01 | Referenced data specifies the values or horizontal values on bubble and scatter [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5) of the series and error bars. | +| 0x02 | Referenced data specifies the [**categories**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) or vertical values on bubble and scatter chart groups of the series and error bars. | +| 0x03 | Referenced data specifies the [**bubble size**](#gt_3a0cf938-5b61-4460-bdbb-3540d84d4180) values of the series. | + +**rt (1 byte):** An unsigned integer that specifies the type of data that is being referenced. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | The [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is a category name, series name or bubble size that was automatically generated. | +| 0x01 | The data source is the text or value as specified by the **formula** field. | +| 0x02 | The data source is the value from a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells in a sheet specified by the **formula** field. | + +**A - fUnlinkedIfmt (1 bit):** A bit that specifies whether the part of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) specified by the **id** field uses number formatting from the referenced data. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The data uses the number formatting of the referenced data. | +| 0x1 | The data uses the custom number formatting specified in the **ifmt** field. | + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +**ifmt (2 bytes):** An [IFmt](#ifmt) structure that specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) to use for the data. + +**formula (variable):** A [ChartParsedFormula](#chartparsedformula) structure that specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that specifies the reference. + +### BuiltInFnGroupCount + +The **BuiltInFnGroupCount** record specifies the beginning of a collection of records as defined by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies information about the built-in [**function categories**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +[TABLE] + +**count (2 bytes):** An unsigned integer that specifies the number of built-in function categories in the workbook. The sum of **count,** the count of **FnGroupName** (section [2.4.120](#fngroupname)) records and the count of **FnGrp12** (section [2.4.121](#fngrp12)) records in the current workbook MUST be less than or equal to 256. The user-defined function categories include those defined in **FnGroupName** records and **FnGrp12** records. The value MUST be one of the following: + +[TABLE] + +### CalcCount + +The **CalcCount** record specifies the iteration count for a calculation in [**iterative calculation**](#gt_82aafd33-4105-4e36-a897-987cc03d8386) mode. + +[TABLE] + +**cIter (2 bytes):** A signed integer that specifies the maximum number of iterations that can occur for a calculation in iterative calculation mode. MUST be greater than or equal to one and less than or equal to 32767. + +### CalcDelta + +The **CalcDelta** record specifies the minimum value change required for [**iterative calculation**](#gt_82aafd33-4105-4e36-a897-987cc03d8386) to continue. + +[TABLE] + +**numDelta (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the amount of change in value for a given [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) from the previously calculated value for that cell that MUST exist for the iteration to continue. The value MUST be greater than or equal to 0. + +### CalcIter + +The **CalcIter** record specifies the state of [**iterative calculation**](#gt_82aafd33-4105-4e36-a897-987cc03d8386). + +[TABLE] + +**vfIter (2 bytes):** A **Boolean** (section [2.5.14](#boolean)) that specifies whether to enable iterative calculation. + +If the value is 0, iterative calculation is disabled. If the value is 1, iterative calculation is enabled. + +### CalcMode + +The **CalcMode** record specifies the [**calculation mode**](#gt_f02f81e1-8eda-4ec3-88e9-c2c483ff47ee) for the workbook. + +[TABLE] + +**fAutoRecalc (2 bytes):** A signed integer that specifies whether the calculation mode is automatic or manual. + +The value MUST be one of the following: + +| Value | Meaning | +|-------|------------------------------| +| 0 | Manual | +| 1 | Automatic | +| 2 | Automatic, except for tables | + +### CalcPrecision + +The **CalcPrecision** record specifies the calculation precision mode for the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +[TABLE] + +**fFullPrec (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the [**precision as displayed**](#gt_e2ff81a6-eb9a-4e49-a1d0-cd4483e2e9a6) mode is [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595). + +If the value is 0, the precision as displayed mode is selected. If the value is 1, the precision as displayed mode is not selected. + +### CalcRefMode + +The **CalcRefMode** record specifies the [**reference style**](#gt_71d7e4ad-d6b6-49d9-b247-e2ebba1469e9) for the workbook. + +[TABLE] + +**fRefA1 (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies the reference style for all formulas. + +If the value is 0, the mode is [**R1C1**](#gt_c7769777-74d5-4020-b9e5-4cd863f70132). If the value is 1, the mode is [**A1**](#gt_950691d0-4b64-4e03-84ae-10d6c872bbdb). + +### CalcSaveRecalc + +The **CalcSaveRecalc** record specifies the recalculation behavior. + +[TABLE] + +**fSaveRecalc (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether to [**recalculate**](#gt_74366612-1dc4-4e8f-8e1a-d833b829f0c3) the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) before it is saved, when in manual [**calculation mode**](#gt_f02f81e1-8eda-4ec3-88e9-c2c483ff47ee). If the value is 0, the workbook is not recalculated before it is saved. If the value is 1, the workbook is recalculated before it is saved. + +### CatLab + +The **CatLab** record specifies the attributes of the [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) label. + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0856. + +**wOffset (2 bytes):** An unsigned integer that specifies the distance between the axis and axis label. It contains the offset as a percentage of the default distance. The default distance is equal to 1/3 the height of the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) calculated in pixels. MUST be a value greater than or equal to 0 (0%) and less than or equal to 1000 (1000%). + +**at (2 bytes):** An unsigned integer that specifies the alignment of the axis label. MUST be a value from the following table: + +| Value | Alignment | +|----|----| +| 0x0001 | Top-aligned if the **trot** field of the [Text](#text) record of the axis is not equal to 0. Left-aligned if the **iReadingOrder** field of the Text record of the axis specifies [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067) [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361); otherwise, right-aligned. | +| 0x0002 | Center-alignment | +| 0x0003 | Bottom-aligned if the **trot** field of the Text record of the axis is not equal to 0. Right-aligned if the **iReadingOrder** field of the Text record of the axis specifies left-to-right reading order; otherwise, left-aligned. | + +**A - cAutoCatLabelReal (1 bit):** A bit that specifies whether the number of [**categories**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) between axis labels is set to the default value. MUST be a value from the following table: + +| Value | Description | +|----|----| +| 0 | The value is set to **catLabel** field as specified by [CatSerRange](#catserrange) record. | +| 1 | The value is set to the default value. The number of category labels is automatically calculated by the application based on the data in the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). | + +**unused (15 bits):** Undefined, and MUST be ignored. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +### CatSerRange + +The **CatSerRange** record specifies the properties of a [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3), a date axis, or a [series](#Section_527ce4dfc9f84e50a314d4b07519593c) axis. + +[TABLE] + +**catCross (2 bytes):** A signed integer that specifies where the value axis crosses this axis, based on the following table. If **fMaxCross** is set to 1, the value this field MUST be ignored. + +[TABLE] + +**catLabel (2 bytes):** A signed integer that specifies the interval between axis labels on this axis. MUST be greater than or equal to 1 and less than or equal to 31999. MUST be ignored for a date axis. + +**catMark (2 bytes):** A signed integer that specifies the interval at which [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) and [**minor tick marks**](#gt_c2eb605a-6c5a-427e-8608-f16940de82a6) are displayed on the axis. Major tick marks and minor tick marks that would have been visible are hidden unless they are located at a multiple of this field. MUST be greater than or equal to 1, and less than or equal to 31999. MUST be ignored for a date axis. + +**A - fBetween (1 bit):** A bit that specifies whether the value axis crosses this axis between major tick marks. MUST be a value from to following table: + +| Value | Meaning | +|-------|------------------------------------------------------------| +| 0 | The value axis crosses this axis on a major tick mark. | +| 1 | The value axis crosses this axis between major tick marks. | + +**B - fMaxCross (1 bit):** A bit that specifies whether the value axis crosses this axis at the last category, the last series, or the maximum date. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value axis crosses this axis at the value specified by **catCross**. | +| 1 | The value axis crosses this axis at the last category, the last series, or the maximum date. | + +**C - fReverse (1 bit):** A bit that specifies whether the axis is displayed in reverse order. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------| +| 0 | The axis is displayed in order. | +| 1 | The axis is display in reverse order. | + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +### CbUsr + +The **CbUsr** record specifies the size of each [UsrInfo](#usrinfo) record stored as part of a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + +[TABLE] + +**rgCbUsr (512 bytes):** An array of 2-byte unsigned integers. Each element in the array specifies the byte count for the UsrInfo record whose index in the collection of UsrInfo records following CbUsr corresponds to the index of the element. Array elements with a zero-based index greater than or equal to the count of users specified in the **iCount** field in [CUsr](#cusr) MUST be zero and MUST be ignored. + +### CellWatch + +The **CellWatch** record specifies a reference to a [**watched cell**](#gt_d385eaa5-d238-4320-8ac4-f1a55becdb68). + +[TABLE] + +**frtRefHeaderU (12 bytes):** An [FrtRefHeaderU](#frtrefheaderu) structure that specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) to be watched. The **frtRefHeaderU.rt** field MUST be 0x086C. The **frtRefHeaderU.grbitFrt.fFrtRef** MUST be 1. The **frtRefHeaderU.ref8** specifies the cell. + +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +### CF + +The **CF** record specifies a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule. + +[TABLE] + +**ct (1 byte):** An unsigned integer that specifies the type of condition. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x01 | Apply the conditional formatting when the comparison [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) specified by **cp** applied to the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) value, **rgce1** and **rgce2**, evaluates to TRUE. | +| 0x02 | Apply the conditional formatting when the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) specified by **rgce1** evaluates to TRUE. | + +**cp (1 byte):** An unsigned integer that specifies the comparison function used when **ct** is equal to 0x01. In the following table, *v* represents the cell value, and *v1* and *v2* represent the results of evaluating the formulas specified by **rgce1** and **rgce2**. The value of this field MUST be a value from the following table: + +[TABLE] + +**cce1 (2 bytes):** An unsigned integer that specifies the size of **rgce1** in bytes. MUST be less than or equal to 16409. + +**cce2 (2 bytes):** An unsigned integer that specifies the size of **rgce2** in bytes. MUST be zero when **ct** is equal to 0x02. MUST be zero when **ct** is equal to 0x01 and **cp** is greater than 0x02. MUST be less than or equal to 16409. + +**rgbdxf (variable):** A [DXFN](#dxfn) structure that specifies the formatting to apply to a cell that fulfills the condition. + +**rgce1 (variable):** A [CFParsedFormulaNoCCE](#cfparsedformulanocce) structure that specifies the first formula. If **ct** is equal to 0x01, this field is the first operand of the comparison. If **ct** is equal to 0x02, this formula is used to determine if the conditional formatting is applied. The size of **rgce1** in bytes MUST be equal to **cce1**. + +**rgce2 (variable):** A CFParsedFormulaNoCCE structure that specifies the formula that is the second operand of the comparison if **ct** is equal to 0x01 and **cp** is either equal to 0x01 or 0x02. The size of **rgce2** in bytes MUST be equal to **cce2**. + +### CF12 + +The **CF12** record specifies a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule. + +All CF12 records MUST follow a [CondFmt12](#condfmt12) record, another CF12 record, or a [CFEx](#cfex) record. + +[TABLE] + +**frtRefHeader (12 bytes):** An [FrtRefHeader](#frtrefheader). The **frtRefHeader.rt** field MUST be 0x087A. The **frtRefHeader.grbitFrt.fFrtRef** field MUST be zero. All of the fields of the **frtRefHeader.ref8** structure MUST be zero and MUST be ignored. + +**ct (1 byte):** An unsigned integer that specifies the type of condition. This field determines the type of the **rgbCT** field as specified in the following table. MUST be a value from the following table: + +[TABLE] + +**cp (1 byte):** An unsigned integer that specifies the comparison [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) used when **ct** is equal to 0x01. In the following table, *v* represents the cell value, and *v1* and *v2* represent the results of evaluating **rgce1** and **rgce2**. The value of this field MUST be a value from the following table: + +[TABLE] + +**cce1 (2 bytes):** An unsigned integer that specifies the size of **rgce1** in bytes. MUST be zero unless **ct** is equal to 0x01 or 0x02. MUST be less than or equal to 16409. + +**cce2 (2 bytes):** An unsigned integer that specifies the size of **rgce2** in bytes. MUST be zero unless **ct** is equal to 0x01 and **cp** is equal to 0x01 or 0x02. MUST be less than or equal to 16409. + +**dxf (variable):** A [DXFN12](#dxfn12) that specifies the formatting to apply to a cell that fulfills the condition. If **ct** is equal to 0x03, 0x04 or 0x06, then **dxf.cbDxf** MUST be equal to 0x00000000. + +**rgce1 (variable):** A [CFParsedFormulaNoCCE](#cfparsedformulanocce) that specifies the formula used to evaluate the first operand in a comparison when **ct** is 0x01. If **ct** is 0x02 **rgce1** MUST be a Boolean function. + +**rgce2 (variable):** A CFParsedFormulaNoCCE that specifies the formula used to evaluate the second operand of the comparison when **ct** is 0x01 and **cp** is either 0x01 or 0x02. + +**fmlaActive (variable):** A [CFParsedFormula](#cfparsedformula) that specifies the formula that specifies an activity condition for the color scale, data bar and icon set formatting rule types. If **ct** is equal to 0x03, 0x04 or 0x06, then the conditional formatting is applied if **fmlaActive** evaluates to TRUE. + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - fStopIfTrue (1 bit):** A bit that specifies whether, when a cell fulfills the condition corresponding to this rule, the lower priority conditional formatting rules that apply to this cell are evaluated. MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x0 | Evaluate lower priority conditional formatting rules that apply to this cell | +| 0x1 | If the cell fulfills the condition corresponding to this rule, do not evaluate lower priority conditional formatting rules that apply to this cell | + +MUST be zero when **ct** is equal to 0x03, 0x04 or 0x06. + +**C - reserved1 (2 bits):** MUST be zero and MUST be ignored. + +**D - unused2 (1 bit):** Undefined and MUST be ignored. + +**E - reserved2 (3 bits):** MUST be zero and MUST be ignored. + +**ipriority (2 bytes):** An unsigned integer that specifies the priority of the rule. Rules that apply to the same cell are evaluated in increasing order of **ipriority**. MUST be unique across all CF12 records and [CFExNonCF12](#cfexnoncf12) structures in the [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream. + +**icfTemplate (2 bytes):** An unsigned integer that specifies the [**template**](#gt_159ca22f-c24d-4c6d-b08a-3d4c4c923953) from which the rule was created. MUST be a value from the following table: + +| Value | Meaning | +|--------|---------------------------| +| 0x0000 | Cell value | +| 0x0001 | Formula | +| 0x0002 | Color scale formatting | +| 0x0003 | Data bar formatting | +| 0x0004 | Icon set formatting | +| 0x0005 | Filter | +| 0x0007 | Unique values | +| 0x0008 | Contains text | +| 0x0009 | Contains blanks | +| 0x000A | Contains no blanks | +| 0x000B | Contains errors | +| 0x000C | Contains no errors | +| 0x000F | Today | +| 0x0010 | Tomorrow | +| 0x0011 | Yesterday | +| 0x0012 | Last 7 days | +| 0x0013 | Last month | +| 0x0014 | Next month | +| 0x0015 | This week | +| 0x0016 | Next week | +| 0x0017 | Last week | +| 0x0018 | This month | +| 0x0019 | Above average | +| 0x001A | Below Average | +| 0x001B | Duplicate values | +| 0x001D | Above or equal to average | +| 0x001E | Below or equal to average | + +**cbTemplateParm (1 byte):** An unsigned integer that specifies the size of the **rgbTemplateParms** field in bytes. MUST be 16. + +**rgbTemplateParms (16 bytes):** A [CFExTemplateParams](#cfextemplateparams) that specifies the parameters for the rule. + +**rgbCT (variable):** A field that specifies the parameters of this rule. The type of **rgbCT** depends on the value of **ct**. + +### CFEx + +The **CFEx** record extends a [CondFmt](#condfmt). + +[TABLE] + +**frtRefHeaderU (12 bytes):** An [FrtRefHeaderU](#frtrefheaderu) structure. The **frtRefHeaderU.rt** field MUST be 0x087B. The **frtRefHeaderU.grbitFrt.fFrtRef** MUST be 1. The **frtRefHeaderU.ref8** MUST be equal to the **sqref** field of the associated CondFmt record specified by **nID**. + +**fIsCF12 (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies what type of rule this record extends. MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x00000000 | This record extends a rule specified by a [CF](#cf) record and MUST NOT be followed by a [CF12](#cf12) record. | +| 0x00000001 | This record extends a rule specified by a CF12 record and MUST be followed by the CF12 record it extends. | + +**nID (2 bytes):** An unsigned integer that specifies which CondFmt record is being extended. It MUST be equal to the **nID** field of one of the CondFmt records in the [Worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream. + +**rgbContent (variable):** A [CFExNonCF12](#cfexnoncf12) structure that specifies the extensions to an existing CF record. MUST be omitted when **fIsCF12** is not equal to 0x00. + +### Chart + +The **Chart** record specifies the position and size of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)) and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). The position information MUST be ignored if the chart is embedded in a sheet. + +[TABLE] + +**x (4 bytes):** A FixedPoint as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.6 that specifies the horizontal position of the upper-left corner of the chart in [**points**](#gt_d072e4da-7898-4227-8f25-9fe77db43571). SHOULD[\<48\>](#Appendix_A_48) be greater than or equal to zero. + +**y (4 bytes):** A FixedPoint as specified in \[MS-OSHARED\] section 2.2.1.6 that specifies the vertical position of the upper-left corner of the chart in points. SHOULD[\<49\>](#Appendix_A_49) be greater than or equal to zero. + +**dx (4 bytes):** A FixedPoint as specified in \[MS-OSHARED\] section 2.2.1.6 that specifies the width in points. SHOULD[\<50\>](#Appendix_A_50) be greater than or equal to zero. + +**dy (4 bytes):** A FixedPoint as specified in \[MS-OSHARED\] section 2.2.1.6 that specifies the height in points. SHOULD[\<51\>](#Appendix_A_51) be greater than or equal to zero. + +### Chart3d + +The **Chart3d** record specifies that the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) of the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is rendered in a 3-D scene and also specifies the attributes of the 3-D plot area. The preceding chart group type MUST be of type bar, pie, line, area, or surface. + +[TABLE] + +**anRot (2 bytes):** A signed integer that specifies the clockwise rotation, in degrees, of the 3-D plot area around a vertical line through the center of the 3-D plot area. MUST be greater than or equal to 0 and MUST be less than or equal to 360. If chart group type is bar and the value of field **fTranspose** in the record [Bar](#bar) is 1, then MUST be less than or equal to 44. + +**anElev (2 bytes):** A signed integer that specifies the rotation, in degrees, of the 3-D plot area around a horizontal line through the center of the 3-D plot area. MUST be greater than or equal to -90 and MUST be less than or equal to 90. If the chart group type is bar and the value of field **fTranspose** in the record Bar is 1, or the chart group type is pie then MUST be greater than or equal to 0. If the chart group type is bar and the value of field **fTranspose** in the record Bar is 1, then the value MUST be less than or equal to 44. + +**pcDist (2 bytes):** A signed integer that specifies the field of view angle for the 3-D plot area. MUST be greater than or equal to zero and less than 200. SHOULD[\<52\>](#Appendix_A_52) be less than or equal to 100. + +**pcHeight (2 bytes):** If **fNotPieChart** is 0, then this is an unsigned integer that specifies the thickness of the pie for a pie chart group. If **fNotPieChart** is 1, then this is a signed integer that specifies the height of the 3-D plot area as a percentage of its width. SHOULD[\<53\>](#Appendix_A_53) be greater than or equal to 5, MUST be less than 65535 and SHOULD[\<54\>](#Appendix_A_54) be less than or equal to 500. + +**pcDepth (2 bytes):** A signed integer that specifies the depth of the 3-D plot area as a percentage of its width. MUST be greater than or equal to 1 and less than or equal to 2000. + +**pcGap (2 bytes):** An unsigned integer that specifies the width of the gap between the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) and the front and back edges of the 3-D plot area as a percentage of the [data point](#Section_9c986ad250d44fa1a157063ac5c971a0) depth divided by 2. If **fCluster** is not 1 and chart group type is not a bar then **pcGap** also specifies distance between adjacent series as a percentage of the data point depth. MUST be less than or equal to 500. + +**A - fPerspective (1 bit):** A bit that specifies whether the 3-D plot area is rendered with a vanishing point. If **fNotPieChart** is 0 the value MUST be 0. If **fNotPieChart** is 1 then the value MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------------------------| +| 0 | No vanishing point applied. | +| 1 | Perspective vanishing point applied based on value of **pcDist.** | + +**B - fCluster (1 bit):** A bit that specifies whether data points are clustered together in a bar chart group. If chart group type is not bar or pie, value MUST be ignored. If chart group type is pie, value MUST be 0. If chart group type is bar, then the value MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------| +| 0 | Data points are not clustered. | +| 1 | Data points are clustered. | + +**C - f3DScaling (1 bit):** A bit that specifies whether the height of the 3-D plot area is automatically determined. If **fNotPieChart** is 0 then this MUST be 0. If **fNotPieChart** is 1 then the value MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value of **pcHeight** is used to determine the height of the 3-D plot area | +| 1 | The height of the 3-D plot area is automatically determined | + +**D - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**E - fNotPieChart (1 bit):** A bit that specifies whether the chart group type is pie. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------| +| 0 | Chart group type MUST be pie. | +| 1 | Chart group type MUST NOT be pie. | + +**F - fWalls2D (1 bit):** A bit that specifies whether the [**walls**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c) are rendered in 2-D[\<55\>](#Appendix_A_55). If **fPerspective** is 1 then this MUST be ignored. If the chart group type is not bar, area or pie this MUST be ignored. If the chart group is of type bar and **fCluster** is 0, then this MUST be ignored. If the chart group type is pie this MUST be 0 and MUST be ignored. If the chart group type is bar or area, then the value MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Chart walls and [**floor**](#gt_dc38c098-e0d3-4701-9656-5f2cf4d80f29) are rendered in 3D. | +| 1 | Chart walls are rendered in 2D and the chart floor is not rendered. | + +**reserved2 (10 bits):** MUST be zero, and MUST be ignored. + +### Chart3DBarShape + +The **Chart3DBarShape** record specifies the shape of the [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) in a bar or column [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). This record is only used for a bar or column chart group and MUST be ignored for all other chart groups. This record MUST be ignored if the current substream does not contain a [Chart3d](#chart3d) record. + +[TABLE] + +**riser (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies the shape of the base of the data points in a bar or column chart group. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------| +| 0x00 | The base of the data point is a rectangle. | +| 0x01 | The base of the data point is an ellipse. | + +**taper (1 byte):** An unsigned integer that specifies how the data points in a bar or column chart group taper from base to tip. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | The data points of the bar or column chart group do not taper. The shape at the maximum value of the data point is the same as the shape at the base. | +| 0x01 | The data points of the bar or column chart group taper to a point at the maximum value of each data point. | +| 0x02 | The data points of the bar or column chart group taper towards a projected point at the position of the maximum value of all of the data points in the chart group, but are clipped at the value of each data point. | + +### ChartFormat + +The **ChartFormat** record specifies properties of a [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a chart group. + +[TABLE] + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved3 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved4 (4 bytes):** MUST be zero, and MUST be ignored. + +**A - fVaried (1 bit):** A bit that specifies whether the color for each [data point](#Section_9c986ad250d44fa1a157063ac5c971a0) and the color and type for each [**data marker**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) varies. If the chart group has multiple [series](#Section_527ce4dfc9f84e50a314d4b07519593c), or the chart group has one series and the type is either a surface, stock, or area chart group, then this field MUST be ignored, and the data points do not vary. For all other chart group types, if the chart group has one series, then a value of 0x1 specifies that the data points vary. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The color for each data point and the color and type for each data marker does not vary. | +| 0x1 | The color for data points or the color or type for data markers varies. | + +**reserved5 (15 bits):** MUST be zero, and MUST be ignored. + +**icrt (2 bytes):** An unsigned integer that specifies the drawing order of the chart group relative to the other chart groups, where 0x0000 is the bottom of the [**z-order**](#gt_5d059b23-337a-4ab8-82f5-e3789b2e7ae9). This value MUST be unique for each instance of this record and MUST be less than or equal to 0x0009. + +### ChartFrtInfo + +The **ChartFrtInfo** record specifies the versions of the application that originally created and last saved the file, and the [Future Record](#Section_b660b67822684414839ed1ae9a4e4e85) identifiers that are used in the file. This property was introduced by a version of the application[\<56\>](#Appendix_A_56) as a Future Record for a [chart](#Section_0d96d51a09bd44ddbb691541de053776). + +In a file written by some versions of the application [\<57\>](#Appendix_A_57), this record appears before the end of the [Chart](#chart-2) record block and before any other Future Record in the record stream. This record does not exist in a file created by certain versions of the application[\<58\>](#Appendix_A_58), but appears after the [End](#end) record of the Chart record block in a file updated by other versions of the application[\<59\>](#Appendix_A_59), in which case the **verWriter** field MUST be a certain version of the application[\<60\>](#Appendix_A_60) regardless of the actual value in the record. + +If a [CrtMlFrt](#crtmlfrt) record exists in a sequence of records that conforms to the [CRTMLFRT](#chart-sheet-substream) rule of the chart sheet substream, then this record MUST immediately precede the sequence of records that conforms to the [PAGESETUP](#common-productions) rule for the chart sheet substream. Otherwise, it MUST immediately precede the first chart-specific future record, which is a [record](#Section_170e90ce87d747589331dcf14cd72388) that has a record number greater than or equal to 2048 and less than or equal to 2303 according to [Record Enumeration](#Section_7c84e174e96f45e0b23fa5e81f8b5def). + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0850. + +**verOriginator (1 byte):** An unsigned integer that specifies the application version that originally created the file. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------------------------| +| 0x9 | Specifies the application version[\<61\>](#Appendix_A_61) | +| 0xA | Specifies the application version[\<62\>](#Appendix_A_62) | +| 0xC | Specifies the application version[\<63\>](#Appendix_A_63) | +| 0xE | Specifies the application version[\<64\>](#Appendix_A_64) | +| 0xF | Specifies the application version[\<65\>](#Appendix_A_65) | + +**verWriter (1 byte):** An unsigned integer that specifies the application version that last saved the file. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------------------------| +| 0x9 | Specifies the application version[\<66\>](#Appendix_A_66) | +| 0xA | Specifies the application version[\<67\>](#Appendix_A_67) | +| 0xC | Specifies the application version[\<68\>](#Appendix_A_68) | +| 0xE | Specifies the application version[\<69\>](#Appendix_A_69) | +| 0xF | Specifies the application version[\<70\>](#Appendix_A_70) | + +**cCFRTID (2 bytes):** An unsigned integer that specifies the number of elements in **rgCFRTID**. The value depends on the value in **verWriter**. It MUST be 0x1 if **verWriter** is 0x9; 0x3 if **verWriter** is 0xA; 0x4 if **verWriter** is 0xC or 0xE. + +**rgCFRTID (variable):** An array of [CFrtId](#cfrtid) structures. This field specifies the range of Future Record Type identifiers used in the chart. The range of values is determined by the value of **verWriter** as specified in the following table: + +[TABLE] + +### ClrtClient + +The **ClrtClient** record specifies a [**custom color palette**](#gt_c24c2bf1-b41b-4eae-92a5-fe10cca57e2e) for a chart. + +[TABLE] + +**ccv (2 bytes):** A signed integer that specifies the number of colors in the **rgColor** array. The value MUST be 3. + +**rgColor (variable):** An array of [LongRGB](#longrgb) structures. The array specifies the colors of the [**color palette**](#gt_05879d13-b9e0-4333-b96d-63cc3433997e). The elements MUST contain the following values: + +| Index | Element | Value | +|----|----|----| +| 0 | [**Foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) | This value MUST be equal to the system window text color. | +| 1 | [**Background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) | This value MUST be equal to the system window color. | +| 2 | Neutral color | This value MUST be black. | + +### CodeName + +The **CodeName** record specifies the name of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) object, a sheet object in the [**VBA project**](#gt_980e3334-2874-4425-a73a-f2235cec1e1e) located in this file. If this record is in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1), the name is for the workbook object. If this record is in a [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11), the name is for the [**chart sheet**](#gt_da561b7b-c629-4cd8-bfaa-6e62471d9e83) object representing the sheet. If this record is in a [Macro Sheet Substream](#macro-sheet-substream), the name is for the [**macro sheet**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491) object representing the sheet. If this record is in a [Dialog Sheet Substream](#dialog-sheet-substream), the name is for the [**dialog sheet**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8) object representing the sheet. If this record is in a [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56), the name is for the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) object representing the sheet. + +[TABLE] + +**codeName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the name used to identify the workbook object or sheet object in the VBA project embedded in this file. The value of **codename.cch** MUST be less than or equal to 31. + +If this string is not empty, it MUST contain only the characters that can be mapped from [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) to a multiple-byte [**ANSI character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583) specified by the system [**locale**](#gt_7b78ebef-e35d-45ab-abfd-4121b60995de). If the system locale is Chinese, Japanese, or Korean, then the full-width characters in the resulting ANSI string are further mapped to corresponding half-width characters where applicable. + +In the resulting ANSI string, the first character MUST be a letter, a single-byte character with a code greater than 0x7F, or multiple-byte character. The subsequent characters in the resulting ANSI string MUST be a digit, an underscore, a single-byte character with a code greater that 0x7F, or a multiple-byte character. + +If the system locale is Japanese, the original Unicode string MUST NOT contain a character with a code equal to 0xFFE3. + +### CodePage + +The **CodePage** record specifies [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38) information for the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +[TABLE] + +**cv (2 bytes):** An unsigned integer that specifies the workbook’s code page. The value MUST be one of the code page values specified in [\[CODEPG\]](https://go.microsoft.com/fwlink/?LinkId=89840) or the special value 1200, which means that the workbook is [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8). + +### ColInfo + +The **ColInfo** record specifies the column formatting for a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of columns. + +[TABLE] + +**colFirst (2 bytes):** A [Col256U](#col256u) structure that specifies the first formatted column. + +**colLast (2 bytes):** A Col256U structure that specifies the last formatted column. The value MUST be greater than or equal to **colFirst**. + +**coldx (2 bytes):** An unsigned integer that specifies the column width in units of 1/256^(th) of a character width. Character width is defined as the maximum digit width of the numbers 0, 1, 2, … 9 as rendered in the [Normal style](#Section_d039c65186dc4d9da6ee1cb8c1088f20)’s [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). + +**ixfe (2 bytes):** An [IXFCell](#ixfcell) structure that specifies the default format for the column cells. + +**A - fHidden (1 bit):** A bit that specifies whether the column range defined by **colFirst** and **colLast** is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**B - fUserSet (1 bit):** A bit that specifies that the column width was either manually set by the user or is different from the default column width as specified by [DefColWidth](#defcolwidth). If the value is 1, the column width was manually set or is different from DefColWidth. + +**C - fBestFit (1 bit):** A bit that specifies whether the column range defined by **colFirst** and **colLast** is set to "best fit." "Best fit" implies that the column width resizes based on the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) contents, and that the column width does not equal the default column width as specified by DefColWidth. + +**D - fPhonetic (1 bit):** A bit that specifies whether [**phonetic information**](#gt_b60c7bf3-21f1-481f-806f-812461e98742) is displayed by default for the column range defined by **colFirst** and **colLast**. + +**E - reserved1 (4 bits):** MUST be zero, and MUST be ignored. + +**F - iOutLevel (3 bits):** An unsigned integer that specifies the [**outline level**](#gt_a5cd5eff-ddeb-490b-bc71-f6256774e3c3) of the column range defined by **colFirst** and **colLast**. + +**G - unused1 (1 bit):** Undefined and MUST be ignored. + +**H - fCollapsed (1 bit):** A bit that specifies whether the column range defined by **colFirst** and **colLast** is in a [**collapsed outline state**](#gt_37d20510-d4a0-4fa6-9ff1-83d99d8f9262). + +**I - reserved2 (3 bits):** MUST be zero, and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +### Compat12 + +The **Compat12** record specifies whether to check for compatibility with earlier application versions when saving the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) from a version of the application[\<71\>](#Appendix_A_71) to the binary formats of other versions of the application[\<72\>](#Appendix_A_72). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x088C. + +**fNoCompatChk (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether to check compatibility with earlier versions when saving the workbook. The value MUST be one of the following: + +| Value | Meaning | +|----|----| +| 0x0000 | When saving the workbook to a binary format of a version of the application[\<73\>](#Appendix_A_73), the user is given the message that some newer features could be lost during the save and prompted to continue or cancel the save. | +| 0x0001 | When saving the workbook to a binary format of a version of the application[\<74\>](#Appendix_A_74), the user is given no message or prompt before the workbook is saved. | + +### CompressPictures + +The **CompressPictures** record specifies a recommendation for picture compression when saving. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x89B. + +**fAutoCompressPictures (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether picture compression is recommended. MUST be a value from the following table: + +| Value | Meaning | +|------------|---------------------------------| +| 0x00000000 | Compression is not recommended. | +| 0x00000001 | Compression is recommended. | + +### CondFmt + +The **CondFmt** record specifies [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules that are associated with a set of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +This record specifies the beginning of a collection of [CF](#cf) records as defined in the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of CF records specifies conditional formatting rules. + +[TABLE] + +**ccf (2 bytes):** An unsigned integer that specifies the count of CF records that follow this record. MUST be greater than or equal to 0x0001, and less than or equal to 0x0003. + +**A - fToughRecalc (1 bit):** A bit that specifies that the appearance of the cell requires significant processing. This information can be used to optimize the redraw of conditional formatting when data values change. + +For example, an application could determine that a conditional formatting rule that contains certain functions or a conditional formatting rule that takes more than a predetermined amount of time to calculate designates that the conditional formatting requires significant processing, and could set this bit to 1. + +**nID (15 bits):** An unsigned integer that identifies this record. The [CFEx](#cfex) record uses this identifier to specify which CondFmt it extends. + +**refBound (8 bytes):** A [Ref8U](#ref8u) structure that specifies the bounds of the set of cells to which the conditional formatting rules apply. The set of cells that this field represents MUST include all of the cells represented by the **sqref** field. + +**sqref (variable):** A [SqRefU](#sqrefu) structure that specifies the cells to which the conditional formatting rules apply. **sqref.cref** MUST be greater than zero and less than or equal to 1026. + +### CondFmt12 + +The **CondFmt12** record specifies [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules that are associated with a set of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461), when all the rules are specified using [CF12](#cf12) records. + +This record specifies the beginning of a collection of CF12 records as defined in the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +This record MUST be followed by the number of CF12 records specified by **mainCF.ccf** + +[TABLE] + +**frtRefHeaderU (12 bytes):** An [FrtRefHeaderU](#frtrefheaderu) structure. The **frtRefHeaderU.rt** field MUST be 0x0879. The **frtRefHeaderU.grbitFrt.fFrtRef** field MUST be 1. Each field of the **frtRefHeaderU.ref8** structure MUST be equal to the corresponding field of the **mainCF.refBound** structure. + +**mainCF (variable):** A [CondFmtStructure](#condfmtstructure) structure that specifies properties of a set of conditional formatting rules. + +### Continue + +The **Continue** record specifies a continuation of the data in a preceding record. Records with data longer than 8,224 bytes MUST be split into several records. The first section of the data appears in the base record and subsequent sections appear in one or more **Continue** records that appear after the base record. Records with data shorter than 8,225 bytes can also store data in the base record and following **Continue** records. For example, the size of [TxO](#txo) record is less than 8,225 bytes, but it is followed by **Continue** records that store the string data and [**formatting runs**](#gt_10031ac8-2a26-4200-beee-cd8d9420ca96). + +[TABLE] + +**continue (variable):** A binary stream that specifies the structure data. The number of bytes in this stream MUST be less than 8225. + +### ContinueBigName + +The **ContinueBigName** record specifies a continuation of the data in a preceding [BigName](#bigname) record. + +[TABLE] + +**continue (variable):** A binary stream that specifies the structure data. The number of bytes in this stream MUST be less than 8225. + +### ContinueFrt + +The **ContinueFrt** record specifies a continuation of the data in a preceding [Future Record Type](#Section_b660b67822684414839ed1ae9a4e4e85) record that has data longer than 8,224 bytes. Such records are split into several records. The first section of the data appears in the base record and subsequent sections appear in one or more **ContinueFrt** records that appear after the base record. How the data is split varies for different types of records. The base record can have data size shorter than 8,224 bytes after splitting. [SXTH](#sxth) is such an example. The preceding base record MUST contain an [FrtHeaderOld](#frtheaderold) or an [FrtHeader](#frtheader) field. + +[TABLE] + +**frtHeaderOld (4 bytes):** An FrtHeaderOld structure. The **frtHeaderOld**.**rt** field MUST be 0x0812. + +**rgb (variable):** A binary stream that specifies the record data. The number of bytes in this stream MUST be less than 8,221. + +### ContinueFrt11 + +The **ContinueFrt11** record specifies a continuation of the data in a preceding [Future Record Type](#Section_b660b67822684414839ed1ae9a4e4e85) record that has data longer than 8,224 bytes. Such records are split into several records. The first section of the data appears in the base record and subsequent sections appear in one or more **ContinueFrt11** records that appear after the base record. The preceding base record MUST contain a [FrtRefHeaderU](#frtrefheaderu) field. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0875. + +**rgb (variable):** A binary stream that specifies the record data. The number of bytes in this stream MUST be less than 8,213. + +### ContinueFrt12 + +The **ContinueFrt12** record specifies a continuation of the data in a preceding [Future Record Type](#Section_b660b67822684414839ed1ae9a4e4e85) record that has data longer than 8,224 bytes. Such records are split into several records. The first section of the data appears in the base record and subsequent sections appear in one or more **ContinueFrt12** records that appear after the base record. The preceding base record MUST contain a [FrtRefHeader](#frtrefheader) or a [FrtHeader](#frtheader) field. + +[TABLE] + +**frtRefHeader (12 bytes):** An FrtRefHeader structure. The **frtRefHeader.rt** field MUST be 0x087F. If **frtRefHeader.grbitFrt.fFrtRef** is 1 then the **frtRefHeader.ref8** MUST refer to the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells associated with this record. If **frtRefHeader.grbitFrt.fFrtRef** is 0 then all of the fields of the **frtRefHeader.ref8** structure MUST be zero and MUST be ignored. + +**rgb (variable):** A binary stream that specifies the record data. The number of bytes in this stream MUST be less than 8,213. + +### Country + +The **Country** record specifies [**locale**](#gt_7b78ebef-e35d-45ab-abfd-4121b60995de) information for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +[TABLE] + +**iCountryDef (2 bytes):** An unsigned integer that specifies the country/region code determined by the locale in effect when the workbook was saved. MUST be greater than or equal to 1 and less than or equal to 981 and MUST be a value from the table in **iCountryWinIni**. + +**iCountryWinIni (2 bytes):** An unsigned integer that specifies the system [**regional settings**](#gt_ede60f7f-1131-4845-800b-b6848215e015) country/region code in effect when the workbook was saved. MUST greater than or equal to 1 and less than or equal to 981 and MUST be a value from the table of Country/Region codes in this section. + +Country/Region codes are defined as follows: + +| Code | Country/Region | +|------|------------------------------| +| 1 | United States | +| 2 | Canada | +| 3 | Latin America, except Brazil | +| 7 | Russia | +| 20 | Egypt | +| 30 | Greece | +| 31 | Netherlands | +| 32 | Belgium | +| 33 | France | +| 34 | Spain | +| 36 | Hungary | +| 39 | Italy | +| 41 | Switzerland | +| 43 | Austria | +| 44 | United Kingdom | +| 45 | Denmark | +| 46 | Sweden | +| 47 | Norway | +| 48 | Poland | +| 49 | Germany | +| 52 | Mexico | +| 55 | Brazil | +| 61 | Australia | +| 64 | New Zealand | +| 66 | Thailand | +| 81 | Japan | +| 82 | Korea | +| 84 | Viet Nam | +| 86 | People’s Republic of China | +| 90 | Turkey | +| 213 | Algeria | +| 216 | Morocco | +| 218 | Libya | +| 351 | Portugal | +| 354 | Iceland | +| 358 | Finland | +| 420 | Czech Republic | +| 886 | Taiwan | +| 961 | Lebanon | +| 962 | Jordan | +| 963 | Syria | +| 964 | Iraq | +| 965 | Kuwait | +| 966 | Saudi Arabia | +| 971 | United Arab Emirates | +| 972 | Israel | +| 974 | Qatar | +| 981 | Iran | + +### CrErr + +The **CrErr** record specifies the errors detected during crash recovery of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0865. + +**cb (4 bytes):** An unsigned integer that specifies the fixed size of this record. MUST be set to 0x0013. + +**cch (2 bytes):** An unsigned integer that specifies the number of characters in the crash recovery error message stored in the **rgch** field. MUST be greater than zero. + +**rgch (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the localized text of a crash recovery error message. If the **cch** field is greater than 8211 this record MUST be followed by one or more [Continue](#continue) records, which specify the continuation of the crash recovery error message. If the text is extended with Continue records a value from the table for **rgch.fHighByte** MUST be specified in the first byte of the **continue** field of the Continue record followed by the remaining portions of the text. + +### CRN + +The **CRN** record specifies the values of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a sheet in an [external cell cache](#Section_b985d1a223f3483ebebdbd0e882d4c89). + +[TABLE] + +**colLast (1 byte):** A [ColByteU](#colbyteu) structure that specifies the zero-based column index of the last cell whose value is contained within this record. MUST be greater than or equal to the value of **colFirst**. + +**colFirst (1 byte):** A ColByteU structure that specifies the zero-based column index of the first cell whose value is contained within this record. MUST be less than or equal to the value of **colLast**. + +**row (2 bytes):** A [RwU](#rwu) structure that specifies the zero-based row index of the cells whose values are contained within this record. + +**crnOper (variable):** An array of [SerAr](#serar) structures that specifies the cell values for the cells in the row starting at **colFirst**. The number of elements in this array MUST equal the following formula: + +**colLast** - **colFirst** + 1 + +### CrtLayout12 + +The **CrtLayout12** record specifies the layout information for [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a), when contained in the sequence of records that conforms to the [ATTACHEDLABEL](#chart-sheet-substream) rule, or [legend](#Section_1832229b7d1945f488d455e9c07466f0), when contained in the sequence of records that conforms to the LD rule. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x089D. + +**dwCheckSum (4 bytes):** An unsigned integer that specifies the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the values in the order as follows, if the checksum is incorrect, the layout information specified in this record MUST be ignored. + +[TABLE] + +The checksum is calculated using the following algorithm: + +> FUNCTION SimpleCheckSum values +> +> SET dwChecksum to 0x0000 +> +> FOR each value in values +> +> SET dwChecksum TO (dwChecksum XOR value) +> +> RETURN dwChecksum + +The width and height of legend in pixels are calculated with the following steps: + +1. Get [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) width in pixels as indicated by section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d) "Chart Area" + +2. Get chart area height in pixels as indicated by section 2.2.3.17 "Chart Area" + +3. Compute legend size in pixels + +legend width in pixels = **dx** field of Legend / 4000 \* chart area width in pixels + +legend height in pixels = **dy** field of Legend / 4000 \* chart area height in pixels + +**A - unused (1 bit):** Undefined and MUST be ignored. + +**B - autolayouttype (4 bits):** An unsigned integer that specifies the automatic layout type of the legend. MUST be ignored when this record is in the sequence of records that conforms to the ATTACHEDLABEL rule. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------| +| 0x0 | Align to the bottom | +| 0x1 | Align to top right corner | +| 0x2 | Align to the top | +| 0x3 | Align to the right | +| 0x4 | Align to the left | + +**reserved1 (11 bits):** MUST be zero, and MUST be ignored. + +**wXMode (2 bytes):** A [CrtLayout12Mode](#crtlayout12mode) structure that specifies the meaning of **x**. + +**wYMode (2 bytes):** A CrtLayout12Mode structure that specifies the meaning of **y**. + +**wWidthMode (2 bytes):** A CrtLayout12Mode structure that specifies the meaning of **dx**. + +**wHeightMode (2 bytes):** A CrtLayout12Mode structure that specifies the meaning of **dy**. + +**x (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies a horizontal offset. The meaning is determined by **wXMode**. + +**y (8 bytes):** An Xnum value that specifies a vertical offset. The meaning is determined by **wYMode**. + +**dx (8 bytes):** An Xnum value that specifies a width or an horizontal offset. The meaning is determined by **wWidthMode**. + +**dy (8 bytes):** An Xnum value that specifies a height or an vertical offset. The meaning is determined by **wHeightMode**. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +### CrtLayout12A + +The **CrtLayout12A** record specifies layout information for a [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtheader.rt** field MUST be 0x08A7. + +**dwCheckSum (4 bytes):** An unsigned integer that specifies the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c). MUST be a value from the following table: + +| **fManPlotArea** field **of ShtProps** | **fAlwaysAutoPlotArea** field **of ShtProps** | **dwCheckSum** | +|----|----|----| +| 0x0 | 0x0 | 0x00000001 | +| 0x0 | 0x1 | 0x00000000 | +| 0x1 | 0x0 | 0x00000000 | +| 0x1 | 0x1 | 0x00000001 | + +**A - fLayoutTargetInner (1 bit):** A bit that specifies the type of plot area for the layout target. + +| Value | Meaning | +|----|----| +| 0x0 | Outer plot area - The bounding rectangle that includes the [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) labels, axis titles, [**data table (2)**](#gt_9e13d7ee-50d6-40ae-8789-29ecafe24bd4) and plot area of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). | +| 0x1 | Inner plot area – The rectangle bounded by the chart axes. | + +**reserved1 (15 bits):** MUST be zero, and MUST be ignored. + +**xTL (2 bytes):** A signed integer that specifies the horizontal offset of the plot area’s upper-left corner, relative to the upper-left corner of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)), in [SPRC](#Section_d5fc728e68de4972905a975bcef8c82d). + +**yTL (2 bytes):** A signed integer that specifies the vertical offset of the plot area’s upper-left corner, relative to the upper-left corner of the chart area (section 2.2.3.17), in SPRC. + +**xBR (2 bytes):** A signed integer that specifies the width of the plot area, in SPRC. + +**yBR (2 bytes):** A signed integer that specifies the height of the plot area, in SPRC. + +**wXMode (2 bytes):** A [CrtLayout12Mode](#crtlayout12mode) structure that specifies the meaning of **x**. + +**wYMode (2 bytes):** A CrtLayout12Mode structure that specifies the meaning of **y**. + +**wWidthMode (2 bytes):** A CrtLayout12Mode structure that specifies the meaning of **dx**. + +**wHeightMode (2 bytes):** A CrtLayout12Mode structure that specifies the meaning of **dy**. + +**x (8 bytes):** An Xnum (section [2.5.342](#xnum))value that specifies a horizontal offset. The meaning is determined by **wXMode**. + +**y (8 bytes):** An Xnum value that specifies a vertical offset. The meaning is determined by **wYMode**. + +**dx (8 bytes):** An Xnum value that specifies a width or a horizontal offset. The meaning is determined by **wWidthMode**. + +**dy (8 bytes):** An Xnum value that specifies a height or a vertical offset. The meaning is determined by **wHeightMode**. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +### CrtLine + +The **CrtLine** record specifies the presence of [**drop lines**](#gt_e8c745bf-646c-4acd-8b5e-5314fa4965fa), [**high-low lines**](#gt_56aec928-ddcc-4415-9d08-5d1dd3982bbc), [**series lines**](#gt_bda50b03-68fa-49f9-bd9e-d0dc289ac88a) or [**leader lines**](#gt_8b7c448e-82e3-4d22-a8ba-52e0a10b14fa) on the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). This record is followed by a [LineFormat](#lineformat) record which specifies the format of the lines. + +[TABLE] + +**id (2 bytes):** An unsigned integer that specifies the type of line that is present on the chart group. This field value MUST be unique among the other **id** field values in CrtLine records in the current chart group. This field MUST be greater than the **id** field values in preceding CrtLine records in the current chart group. MUST be a value from the following table: + +| Value | Type of Line | +|----|----| +| 0x0000 | Drop lines below the [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) of line, area, and stock chart groups. | +| 0x0001 | High-low lines around the data points of line and stock chart groups. | +| 0x0002 | Series lines connecting data points of stacked column and bar chart groups, and the [**primary pie**](#gt_e2300016-b59d-4384-9b70-c000523747e0) to the [**secondary bar/pie**](#gt_e452a278-4e13-44c6-9f1b-db3c93841bc6) of bar of pie and pie of pie chart groups. | +| 0x0003 | Leader lines with non-default formatting connecting [data labels](#Section_cac7f43a3af142f58ff2814c2870427f) to the data point of pie and pie of pie chart groups. | + +### CrtLink + +The **CrtLink** record is written but unused. + +[TABLE] + +**unused (10 bytes):** Undefined and MUST be ignored. + +### CrtMlFrt + +The **CrtMlFrt** record specifies additional properties for [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) elements, as specified by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). These properties complement the record to which they correspond, and are stored as a structure chain defined in [XmlTkChain](#xmltkchain). An application can ignore this record without loss of functionality, except for the additional properties. If this record is longer than 8224 bytes, it MUST be split into several records. The first section of the data appears in this record and subsequent sections appear in one or more [CrtMlFrtContinue](#crtmlfrtcontinue) records that follow this record. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x089E. + +**cb (4 bytes):** An unsigned integer that specifies the size, in bytes, of the XmlTkChain structure starting in the **xmltkChain** field, including the data contained in the optional CrtMlFrtContinue records. MUST be less than or equal to 0x7FFFFFEB. + +**xmltkChain (variable):** An XmlTkChain structure that specifies a chain of structures. The size of the XmlTkChain is specified by the **cb** field. + +**unused (4 bytes):** Undefined, and MUST be ignored. + +### CrtMlFrtContinue + +The **CrtMlFrtContinue** record specifies additional data for a [CrtMlFrt](#crtmlfrt) record, as specified in the CrtMlFrt record. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x089F. + +**xmltkChain (variable):** An array of bytes that contains the continuation of the **xmltkChain** field of the CrtMlFrt record associated with this record. If the length of this record is greater than 8224 bytes, additional CrtMlFrtContinue records follow. + +### CUsr + +The **CUsr** record specifies the number of unique users that have this [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc) open. + +[TABLE] + +**iCount (2 bytes):** An unsigned integer that specifies the number of unique users that have this shared workbook open. MUST be greater than or equal to 0 and less than or equal to 255. + +### Dat + +The **Dat** record specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies the options of the [data table](#Section_69938f61d2e94da3af87e154edcb0d98) which can be displayed within a [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)). + +[TABLE] + +**A - fHasBordHorz (1 bit):** A bit that specifies whether horizontal [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) [**borders**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) are displayed within the data table. + +**B - fHasBordVert (1 bit):** A bit that specifies whether vertical cell borders are displayed within the data table. + +**C - fHasBordOutline (1 bit):** A bit that specifies whether an outside [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) is displayed around the data table. + +**D - fShowSeriesKey (1 bit):** A bit that specifies whether the [**legend key**](#gt_6981bc96-6d51-425c-9550-63c5b8b08e54) is displayed next to the name of the [series](#Section_527ce4dfc9f84e50a314d4b07519593c). If the value is 1, the legend key symbols are displayed next to the name of the series. + +**reserved (12 bits):** MUST be zero, and MUST be ignored. + +### DataFormat + +The **DataFormat** record specifies the [data point](#Section_9c986ad250d44fa1a157063ac5c971a0) or [series](#Section_527ce4dfc9f84e50a314d4b07519593c) that the formatting information that follows applies to and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). This collection of records specifies formatting properties for the data point or series. + +[TABLE] + +**xi (2 bytes):** An unsigned integer that specifies the zero-based index of the data point within the series specified by **yi**. If this value is 0xFFFF, the formatting information that follows applies to the series. Otherwise, the formatting information that follows applies to a data point. This value MUST be less than or equal to 31999. This value MUST be less than or equal to 3999 for a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) that contains a [Chart3d](#chart3d) record. This value MUST be 0xFFFF if the formatting information in this record is applied to a [trendline](#Section_61d74ebc36714d6dbdc0626db604530d) or [error bar](#Section_762a461d0a45474ebd7d5994bb294af2). + +**yi (2 bytes):** An unsigned integer that specifies the zero-based index of a [Series](#series-1) record in the collection of Series records in this chart sheet substream. SHOULD[\<75\>](#Appendix_A_75) be less than or equal to 254. + +**iss (2 bytes):** An unsigned integer that specifies properties of the data series, trendline or error bar, depending on the type of records in sequence of records that conforms to the SERIESFORMAT rule that contains the sequence of records that conforms to the SS rule that contains this record. + +- If the SERIESFORMAT rule does not contain a [SerAuxTrend](#serauxtrend) or [SerAuxErrBar](#serauxerrbar) record, then this field specifies the plot order of the data series. If the series order was changed, this field can be different from **yi**. SHOULD[\<76\>](#Appendix_A_76) be less than or equal to the number of series in the chart. MUST be unique among **iss** values for all instances of this record contained in the SERIESFORMAT rule that does not contain a SerAuxTrend or SerAuxErrBar record. + +- If the SERIESFORMAT rule contains a SerAuxTrend record on the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), then this field specifies the trendline number for the series. + +- If the SERIESFORMAT rule contains a SerAuxErrBar record on the chart group, then this field specifies a zero-based index into a Series record in the collection of Series records in the current chart sheet substream for which the error bar applies to. + +**A - fXL4iss (1 bit):** MUST be zero, and MUST be ignored. + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +### DataLabExt + +The **DataLabExt** record specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection specifies an extended [data label](#Section_cac7f43a3af142f58ff2814c2870427f). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x086A. + +### DataLabExtContents + +The **DataLabExtContents** record specifies the contents of an extended [data label](#Section_cac7f43a3af142f58ff2814c2870427f). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x086B. + +**A - fSerName (1 bit):** A bit that specifies whether the name of the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) is displayed in the extended data label. + +**B - fCatName (1 bit):** A bit that specifies whether the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) name, or the horizontal value on bubble or scatter [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5), is displayed in the extended data label. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Neither of the data values are displayed in the extended data label. | +| 1 | If bubble or scatter chart group, the horizontal value is displayed in the extended data label. Otherwise, the category name is displayed in the extended data label. | + +**C - fValue (1 bit):** A bit that specifies whether the data value, or the vertical value on bubble or scatter chart groups, is displayed in the extended data label. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Neither of the data values are displayed in the data label. | +| 1 | If bubble or scatter chart group, the vertical value is displayed in the extended data label. Otherwise, the data value is displayed in the extended data label. | + +**D - fPercent (1 bit):** A bit that specifies whether the value of the corresponding [data point](#Section_9c986ad250d44fa1a157063ac5c971a0), represented as a percentage of the sum of the values of the series the data label is associated with, is displayed in the extended data label. + +MUST equal 0 if the chart group type of the corresponding chart group, series, or data point is not a bar of pie, doughnut, pie, or pie of pie chart group. + +**E - fBubSizes (1 bit):** A bit that specifies whether the [**bubble size**](#gt_3a0cf938-5b61-4460-bdbb-3540d84d4180) is displayed in the data label. + +MUST equal 0 if the chart group type of the corresponding chart group, series, or data point is not a bubble chart group. + +**reserved (11 bits):** MUST be zero, and MUST be ignored. + +**rgchSep (variable):** A case-sensitive [XLUnicodeStringMin2](#xlunicodestringmin2) structure that specifies the string that is inserted between every data value to form the extended data label. For example, if **fCatName** and **fValue** are set to 1, the labels will look like "*Category Name*\<*value of* **rgchSep**\>*Data Value*". The length of the string is contained in the **cch** field of the XLUnicodeStringMin2 structure. + +### Date1904 + +The **Date1904** record specifies the [**date system**](#gt_cfc29c5e-eb23-4077-b6eb-492f20f5c87f) that the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) uses. + +[TABLE] + +**f1904DateSystem (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies the date system used in this workbook. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The workbook uses the 1900 date system. The first date of the 1900 date system is 00:00:00 on January 1, 1900, specified by a serial value of 1. | +| 0x0001 | The workbook uses the 1904 date system. The first date of the 1904 date system is 00:00:00 on January 1, 1904, specified by a serial value of 0. | + +### DBCell + +The **DBCell** record specifies a row block, which is a series of up to 32 consecutive rows. + +**DBCell**, combined with the [Index](#index) record, is used to optimize the [lookup of cells](#Section_24bbaffdab88489e983f3c400c8a8559) in a [cell table](#Section_d690007dd25c4822a650b24c13288bb7). + +[TABLE] + +**dbRtrw (4 bytes):** An unsigned integer that specifies the offset in bytes from the starting file position of this record to the file position of the first [Row](#row) record. If the value is 0, the referenced row block does not contain any rows that contain cells that have data. + +**rgdb (variable):** An array of 2-byte unsigned integers that specify the file offset in bytes to the first record that specifies a [CELL](#common-productions) in each row that is a part of this row block. For the first array element, the starting position of the file offset is specified relative to the file position of the end of the first Row record in the row block. For all other elements, the file offset is specified relative to the file position of the CELL record specified by the previous element in this array. The number of elements in the array MUST be less than or equal to 32. + +### DbOrParamQry + +The **DbOrParamQry** record specifies a [DbQuery](#dbquery) or [ParamQry](#paramqry) record depending on the record that precedes this record. + +[TABLE] + +**rgb (variable):** A variable type field that specifies a DbQuery or ParamQry record depending on the record that precedes this record as specified by the following table: + +| Preceding Record | Record Type | +|-------------------------------|-------------| +| [SXString](#sxstring) | ParamQry | +| DbOrParamQry of type ParamQry | ParamQry | +| Any other record | DbQuery | + +### DbQuery + +The **DbQuery** record specifies information about an [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9). This record is followed by [SXString](#sxstring) and [ParamQry](#paramqry) records that specify the strings and parameters. The records MUST be in the following order: + +- If and only if **fSql** equals 1, zero or more SXString records as specified by **cstQuery**. + +- If and only if **fOdbcConn** equals 1, zero or more SXString records as specified by **cstOdbcConn**. + +- If and only if **fWeb** equals 1, zero or more SXString records as specified by **cstQuery**. + +- If and only if **fWeb** equals 1, zero or more SXString records as specified by **cstWebPost**. + +- Zero or more SXString and ParamQry pairs as specified by **cparams**. + +- If and only if **fSqlSav** equals 1, zero or more SXString records as specified by **cstSQLSav**. + +[TABLE] + +**dbt (3 bits):** An unsigned integer that specifies the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) type. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------------------| +| 0x1 | [ODBC data source](#Section_a8c9314e9f904738a482e97aa5ec2383) | +| 0x2 | [DAO record set](#Section_fee470a1ff184493a4dab8168e34dd58) | +| 0x4 | [Web query](#Section_f9e7fd044675413a949b2ffdb6c30324) | +| 0x5 | [OLE DB database](#Section_78e87a5485b44714ba6b90d19c098138) | +| 0x6 | [Text query](#Section_d6c94f8620c84fefac836217c00b307b) | +| 0x7 | [ADO query](#Section_d6796128906c4687a63d985bff2364d1) | + +**A - fOdbcConn (1 bit):** A bit that specifies whether the data source type is [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e). MUST be 1 if **dbt** is equal to 0x1. + +**B - fSql (1 bit):** A bit that specifies whether there is a database command string. MUST be 0 if **fWeb** is 1. If the value of **dbt** is 5 see the **grbitDbt** field of the [DBQueryExt](#dbqueryext) record for details on what the database command string specifies. Otherwise the database command string specifies an [**Structured Query Language (SQL)**](#gt_37416b0f-ca5b-4fac-96e5-082eb80a3d84) [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) string. The database command string is contained by zero or more SXString records following this record, as specified by **cstQuery**. + +**C - fSqlSav (1 bit):** A bit that specifies whether there is a SQL query string for server-based fields. For more information about server-based fields see the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) section. If and only if **fSqlSav** equals 1, the SQL query string for server-based fields is contained by zero or more SXString records following this record, as specified by **cstSQLSav**. + +**D - fWeb (1 bit):** A bit that specifies whether there is a [**Uniform Resource Locator (URL)**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) for a [**Web query**](#gt_7f21a511-63e5-43a2-ad46-235ce53af5f2). MUST be 1 if **dbt** is equal to 0x4. The URL is the command string contained in zero or more SXString records following this record, as specified by **cstQuery**. + +**E - fSavePwd (1 bit):** A bit that specifies whether the password is saved with the ODBC [**connection string**](#gt_03a9d0ca-2f10-4f3d-b910-052714a96f7d) specified by SXString records following this record. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------------------------| +| 0 | Password is removed from the ODBC connection string. | +| 1 | Password is not removed from the ODBC connection string. | + +MUST be ignored if **dbt** is not equal to 0x1. + +**F - fTablesOnlyHTML (1 bit):** A bit that specifies whether Web queries only works on HTML tables. + +**unused (7 bits):** Undefined and MUST be ignored. + +**cparams (2 bytes):** A signed integer that specifies the number of SQL parameters. Each parameter consists of an SXString record followed by a ParamQry record. The SXString record specifies the name of the parameter and the ParamQry record specifies the query parameters. MUST be greater than or equal to zero. + +**cstQuery (2 bytes):** A signed integer that specifies the number of SXString records that contain the command string, see **fWeb** and **fSql** for more details. Each SXString record specifies up to 255 characters of the complete command string. MUST be greater than or equal to zero. + +**cstWebPost (2 bytes):** A signed integer that specifies the number of SXString records that contain the Web query statement. Each SXString record specifies up to 255 characters of the complete query statement. MUST be greater than or equal to zero. MUST be 0 if **fWeb** is equal to 0. + +**cstSQLSav (2 bytes):** A signed integer that specifies the number of SXString records that contain the SQL statement for server-based fields. For more information about server-based fields see the source data section. Each SXString record specifies up to 255 characters of the complete SQL statement. MUST be greater than or equal to zero. MUST be 0 if **fSqlSav** is equal to 0. + +**cstOdbcConn (2 bytes):** A signed integer that specifies the number of SXString records that contain the ODBC connection string. Each SXString record specifies up to 255 characters of the complete connection string. MUST be greater than or equal to zero. MUST be 0 if **fOdbcConn** is equal to 0. + +### DBQueryExt + +The **DBQueryExt** record specifies information about an [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9). This record specifies the beginning of a collection of records as specified by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection specifies more information about the external connection. See the [QsiSXTag](#qsisxtag) record for details about how the [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) or [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) for the external connection is determined. The records of the collection MUST be in the following order: + +- The first record MUST be an [ExtString](#extstring) record that specifies the comma-delimited list of [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) names to import, if and only if **fTableNames** is equal to 1. + +- The next record MUST be a [TxtQry](#txtqry) record, if and only if **fTxtWiz** is equal to 1. + +- The next record or records MUST be zero or more [OleDbConn](#oledbconn) records as specified by **coledb**. + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0803. + +**dbt (2 bytes):** A [DataSourceType](#datasourcetype) enumeration that specifies the database source. + +**A - fMaintain (1 bit):** A bit that specifies whether the connection with the database remains open once established. + +**B - fNewQuery (1 bit):** A bit that specifies whether the connection was not refreshed. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------| +| 0 | Connection was refreshed one or more times | +| 1 | Connection was not refreshed | + +**C - fImportXmlSource (1 bit):** A bit that specifies whether the underlying [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) source or the Web page table is imported. MUST be ignored if **dbt** is not equal to 0x0004. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------| +| 0 | Web page table is imported | +| 1 | XML source is imported | + +**D - fSPListSrc (1 bit):** A bit that specifies if the external connection is using the Web based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). + +**E - fSPListReinitCache (1 bit):** A bit that specifies whether the Web based data is reinitialized rather than refreshed. MUST be ignored if **fSPListSrc** is equal to 0. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Web based data is refreshed. | +| 1 | Web based data is reinitialized by reconnecting to the Web based data provider. | + +**F - unused (2 bits):** Undefined and MUST be ignored. + +**G - fSrcIsXml (1 bit):** A bit that specifies whether the external connection source is XML. + +**reserved1 (8 bits):** MUST be zero, and MUST be ignored. + +**grbitDbt (variable):** A [ConnGrbitDbt](#conngrbitdbt) structure that specifies external connection properties specific to **dbt.** + +**H - fTxtWiz (1 bit):** A bit that specifies whether this is a [**text query**](#gt_c636d3ce-a120-4acf-91ac-40b3ec79593a). If the value is equal to 1, this record MUST be followed by a TxtQry record. + +**I - fTableNames (1 bit):** A bit that specifies whether the tables to import are specified in the ExtString record that follows this record. + +**J - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**reserved3 (13 bits):** MUST be zero, and MUST be ignored. + +**bVerDbqueryEdit (1 byte):** A [DataFunctionalityLevel](#datafunctionalitylevel) value that specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) the external connection was last edited with. + +**bVerDbqueryRefreshed (1 byte):** A DataFunctionalityLevel value that specifies the data functionality level the external connection was last refreshed with. MUST be ignored if **fNewQuery** is equal to 1. + +**bVerDbqueryRefreshableMin (1 byte):** A DataFunctionalityLevel value that specifies the minimum data functionality level that the application is required to support refreshing the external connection. MUST be ignored if **fNewQuery** is equal to 1. + +**reserved4 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved5 (2 bytes):** MUST be zero, and MUST be ignored. + +**coledb (2 bytes):** An unsigned integer that specifies the count of OleDbConn records that follow this record. MUST be zero if **dbt** is not equal to DBT_OLEDB. + +**cstFuture (2 bytes):** An unsigned integer that specifies the count of bytes in **rgbFutureBytes**. + +**wRefreshInterval (2 bytes):** An unsigned integer that specifies the number of minutes to wait between automatic refreshes of the external connection. The value MUST be greater than or equal to 0. A value of 0 specifies that the timed [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) is off. + +**wHtmlFmt (2 bytes):** An unsigned integer that specifies the HTML formatting to apply to the imported data for a [**Web query**](#gt_7f21a511-63e5-43a2-ad46-235ce53af5f2). MUST be ignored if **dbt** is not equal to 0x0004. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0001 | No formatting is applied | +| 0x0002 | Rich text formatting only | +| 0x0003 | Full HTML formatting, including [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) formatting | + +**cwParamFlags (2 bytes):** An unsigned integer that specifies the count of [PBT](#pbt) items in **rgPbt.** + +**rgPbt (variable):** An array of PBT items, each of which specifies information about the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) parameters. The PBT items in the array specify information about same query parameters as the collection of [ParamQry](#paramqry) records of the external connection. The nth PBT item in this array corresponds to the nth ParamQry record within the collection. + +**rgbFutureBytes (variable):** Information from future versions. The byte count MUST be equal to **cstFuture**. + +### DCon + +The **DCon** record specifies the [**data consolidation**](#gt_ede978bb-cef1-4f8c-b56a-7129cb228738) settings of the associated [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and specifies the beginning of a collection of records as defined by the [Macro Sheet Substream](#Section_0dddd943f77a4fc2bf92868acb4587f7) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) and [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF. The collection of records specifies the [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0) [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). Data consolidation settings can exist in a sheet that does not have a data consolidation range. + +[TABLE] + +**iiftab (2 bytes):** An unsigned integer that specifies the [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) used to aggregate the source data. MUST be a value from the following table: + +| Value | Function Name | Meaning | +|----|----|----| +| 0x0000 | Average | The average (arithmetic mean). | +| 0x0001 | Count Numbers | The count of the numeric values. | +| 0x0002 | Count | The count of data values. | +| 0x0003 | Maximum | The largest value. | +| 0x0004 | Minimum | The smallest value. | +| 0x0005 | Product | The product of the values. | +| 0x0006 | Standard Deviation | An estimate of the standard deviation of a population, where the sample is a subset of the entire population. | +| 0x0007 | Standard Deviation Population | The standard deviation based on the entire population. | +| 0x0008 | Sum | The summation of the numeric values. | +| 0x0009 | Variance | An estimate of the variance of a population, where the sample is a subset of the entire population. | +| 0x000A | Variance Population | The variance of a population, where the population is all of the data to be summarized. | + +**fLeftCat (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies how to identify rows for data consolidation. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | Data consolidation is based on the position of the row in the source data ranges. | +| 0x0001 | Data consolidation is based on row labels from the leftmost column of the source data ranges. String comparison is case independent and the consolidated data contains a row for each unique row label. The unique row labels appear in the first column in the [**consolidation range**](#gt_0b4c0b1d-2421-4ac6-aa61-ffb82e6a3bc1), if it exists. | + +**fTopCat (2 bytes):** A Boolean that specifies how to identify columns for data consolidation. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | Data consolidation is based on the position of the column in the source data ranges. | +| 0x0001 | Data consolidation is based on column labels from the top row of the source data ranges. String comparison is case independent and the consolidated data contains a column for each unique column label. The unique column labels appear in the top row of the consolidation range, if it exists. | + +**fLinkConsole (2 bytes):** A Boolean that specifies whether data consolidation will create references to the source data. MUST be a value from the following table: + +| Value | Meaning | +|--------|------------------------------------------------| +| 0x0000 | References are not created to the source data. | +| 0x0001 | References are created to the source data. | + +### DConBin + +The **DConBin** record specifies a built-in [**named range**](#gt_042582ea-4050-4e5c-a2df-ae39706a19b6) that is a [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) or a data source for the [**data consolidation**](#gt_ede978bb-cef1-4f8c-b56a-7129cb228738) settings of the associated [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**nBuiltin (1 byte):** An unsigned integer that specifies the built-in [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) for the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). MUST be a value from the following table: + +| **Value** | **Meaning** | +|-----------|--------------------| +| 0x00 | "Consolidate_Area" | +| 0x01 | "Auto_Open" | +| 0x02 | "Auto_Close" | +| 0x03 | "Extract" | +| 0x04 | "Database" | +| 0x05 | "Criteria" | +| 0x06 | "Print_Area" | +| 0x07 | "Print_Titles" | +| 0x08 | "Recorder" | +| 0x09 | "Data_Form" | +| 0x0A | "Auto_Activate" | +| 0x0B | "Auto_Deactivate" | +| 0x0C | "Sheet_Title" | +| 0x0D | "\_FilterDatabase" | + +**reserved1 (2 bytes):** MUST be zero and MUST be ignored. + +**reserved2 (1 byte):** MUST be zero and MUST be ignored. + +**cchFile (2 bytes):** An unsigned integer that specifies the character count of **stFile.** MUST be 0x0000, or greater than or equal to 0x0002. A value of 0x0000 specifies that the built-in defined name specified in **nBuiltin** has a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) scope and is contained in this file. + +**stFile (variable):** An [DConFile](#dconfile) structure that specifies the workbook or workbook and sheet that contains the range specified in **nBuiltin.** This field MUST exist if and only if the value of **cchFile** is greater than zero. If the built-in defined name has workbook scope this field specifies the workbook file that contains the built-in defined name and its associated range. If the built-in defined name has a sheet–level scope this field specifies both the sheet name and the workbook file that contains the built-in defined name and its associated range. + +**unused (variable):** An array of bytes that is unused and MUST be ignored. MUST exist if and only if **cchFile** is greater than 0 and **stFile** specifies a self-reference (the value of **stFile.stFile.rgb**\[0\] is 2). If the value **stFile.stFile.fHighByte** is 0 the size of this array is 1. If the value of **stFile.stFile.fHighByte** is 1 the size of this array is 2. + +### DConn + +The **DConn** record specifies information for a single data connection. + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold). The **frtHeaderOld.rt** field MUST be 0x0876. + +**dbt (2 bytes):** A [DataSourceType](#datasourcetype) that specifies the type of this data connection. + +**A - fSavePwd (1 bit):** A bit that specifies whether a password is saved for this data connection. This field MUST be ignored if **dbt** is not equal to 0x0001 or 0x0005. + +**B - fTablesOnlyHtml (1 bit):** A bit that specifies whether web queries retrieve data from HTML tables only. MUST be ignored if **dbt** is not equal to 0x0004. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------| +| 0x0 | Web queries retrieve data from the entire page. | +| 0x1 | Web queries retrieve data from HTML tables only. | + +**C - fTableNames (1 bit):** A bit that specifies whether there are any HTML tables saved for this data connection. MUST be ignored if **dbt** is not equal to 0x0004. Value MUST equal 1 if **fTablesOnlyHtml** is equal to 1. + +**D - fDeleted (1 bit):** A bit that specifies whether the data connection associated with the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) has been deleted. + +**E - fStandAlone (1 bit):** A bit that specifies whether the data connection is used by the workbook. + +**F - fAlwaysUseConnectionFile (1 bit):** A bit that specifies whether the data connection information in the connection file is used when the data is refreshed. This field MUST be ignored if **dbt** is not equal to 0x0001 or 0x0005. + +**G - fBackgroundQuery (1 bit):** A bit that specifies whether the data connection is refreshed asynchronously. + +**H - fRefreshOnLoad (1 bit):** A bit that specifies whether the data connection is refreshed after the file is loaded. + +**I - fSaveData (1 bit):** A bit that specifies if the data for the data connection is persisted in the workbook. + +**unused1 (7 bits):** Undefined and MUST be ignored. + +**cParams (2 bytes):** An unsigned integer that specifies the number of parameters for a [**parameterized query**](#gt_c68a3a26-317d-4a1d-9eff-c2630b53067c). The value MUST equal 0 if **fStandAlone** equals 0. + +**reserved1 (2 bytes):** MUST be zero and MUST be ignored. + +**J - fMaintain (1 bit):** A bit that specifies whether the data connection remains open once it is established. + +**K - fNewQuery (1 bit):** A bit that specifies whether the data connection has been refreshed. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------| +| 0 | Connection has been refreshed one or more times | +| 1 | Connection has not yet been refreshed | + +**L - fImportXmlSource (1 bit):** A bit that specifies whether the underlying [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) source or the Web page table has been imported. MUST be ignored if **dbt** is not equal to 0x0004. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------| +| 0 | Web page table has been imported | +| 1 | XML source has been imported | + +**M - fSPListSrc (1 bit):** A bit that specifies whether the query is using a Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). MUST be ignored if **dbt** is not equal to 0x0005. + +**N - fSPListReinitCache (1 bit):** A bit that specifies whether the Web based data is reinitialized rather than refreshed. MUST be ignored if **dbt** is not equal to 0x0005. MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------------------------------| +| 0 | List is refreshed | +| 1 | List is reinitialized by reconnecting to the data provider | + +**O - unused2 (2 bits):** Undefined and MUST be ignored. + +**P - fSrcIsXml (1 bit):** A bit that specifies whether the query source is XML. MUST be ignored if **dbt** is not equal to 0x0004. + +**reserved2 (8 bits):** MUST be zero and MUST be ignored. + +**grbitDbt (variable):** A [ConnGrbitDbt](#conngrbitdbt) that specifies the query flags. + +**bVerDbqueryEdit (1 byte):** A [DataFunctionalityLevel](#datafunctionalitylevel) that specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) was last edited with. + +**bVerDbqueryRefreshed (1 byte):** A DataFunctionalityLevel that specifies the data functionality level the query was last refreshed with. + +**bVerDbqueryRefreshableMin (1 byte):** A DataFunctionalityLevel that specifies the minimum data functionality level that the application is required to support to [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) the query. + +**wRefreshInterval (2 bytes):** An unsigned integer that specifies the number of minutes to wait between automatic refreshes of the query. The value MUST be greater than or equal 0. + +**wHtmlFmt (2 bytes):** An unsigned integer that specifies the HTML formatting to apply to the imported data for a [**Web query**](#gt_7f21a511-63e5-43a2-ad46-235ce53af5f2). MUST be ignored if **dbt** is not equal to 0x0004. MUST be a value from the following table: + +| Value | Meaning | +|--------|---------------------------| +| 0x0001 | None | +| 0x0002 | Rich text formatting only | +| 0x0003 | Full HTML formatting | + +**rcc (4 bytes):** An unsigned integer that specifies the reconnection method. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00000000 | Reconnection method is determined by the application. | +| 0x00000001 | Reconnect. When the data connection is refreshed, the updated connection information is retrieved if it is available. This information is used instead of the persisted connection information. | +| 0x00000002 | Never reconnect. Updated connection information is never used even if the information is available and the existing connection information is invalid. | + +**credMethod (1 byte):** An unsigned integer that specifies the credentials used during reconnection. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------| +| 0x00 | Integrated authentication | +| 0x01 | Use no credentials | +| 0x02 | Use stored credentials | +| 0x03 | Prompt for credentials | + +**reserved3 (1 byte):** MUST be zero and MUST be ignored. + +**rgchSourceDataFile (variable):** A [DConnUnicodeStringSegmented](#dconnunicodestringsegmented) that specifies the database file to use if the existing [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) connection fails. MUST be ignored if **dbt** does not equal 0x0005. + +**rgchSourceConnectionFile (variable):** A DConnUnicodeStringSegmented that specifies the [**Office data connection (ODC) file**](#gt_e6fb952a-b6b6-40af-ad1b-ea6cf97da509) to use if the existing connection fails. + +**rgchConnectionName (variable):** A DConnUnicodeStringSegmented that specifies the name of the data connection associated with the workbook. + +**rgchConnectionDesc (variable):** A DConnUnicodeStringSegmented that specifies the description of the data connection associated with the workbook. + +**rgchSSOApplicationID (variable):** A DConnUnicodeStringSegmented that specifies the [**single sign-on (SSO) identifier**](#gt_aef76345-0a1f-4bcd-8700-ef5022a57cd1) string. MUST be ignored if **dbt** does not equal 0x0001 or 0x0005. + +**tableNames (variable):** A DConnUnicodeStringSegmented that specifies the list of [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) names as a comma-separated list. This field only exists when **fTableNames** is equal to 1. The total number of characters MUST be less than or equal to 255. + +**params (variable):** An array of [DConnParameter](#dconnparameter) that specifies the parameters of a parameterized query. The size of the array is determined by **cParams**. MUST NOT exist if **fStandAlone** is equal to 0. + +**connection (variable):** A variable type field. The data type and meaning vary depending on the value of **dbt**. + +| Value of dbt | Meaning | +|----|----| +| 1 | **connection** is a DConnUnicodeStringSegmented that specifies the [**connection string**](#gt_03a9d0ca-2f10-4f3d-b910-052714a96f7d). If field **fStandAlone** is 0, then connection.**st.cch** MUST be 0. | +| 4 | **connection** is a [DConnConnectionWeb](#dconnconnectionweb) that specifies the connection information for a Web query. | +| 5 | **connection** is a [DConnConnectionOleDb](#dconnconnectionoledb) that specifies the connection information for an OLE DB connection string. | +| 6 | **connection** is a [TxtQry](#txtqry) that specifies information for a [**text query**](#gt_c636d3ce-a120-4acf-91ac-40b3ec79593a). | +| Any other value | **connection** does not exist. | + +**rgbSQL (variable):** A [DConnStringSequence](#dconnstringsequence) that specifies the database command. For an OLE DB [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075), the meaning of the **dbost** field of [ConnGrbitDbtOledb](#conngrbitdbtoledb) determines the meaning of this field. For an [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) data source, this string specifies the [**SQL**](#gt_37416b0f-ca5b-4fac-96e5-082eb80a3d84) statement. MUST be ignored if **dbt** does not equal 0x0001 or 0x0005. + +**rgbSQLSav (variable):** A DConnStringSequence that specifies the original, non-parameterized SQL statement for an ODBC data source. MUST be ignored if **dbt** does not equal 0x0001. + +**rgbEditWebPage (variable):** A DConnStringSequence that specifies the [**URL**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) for the Web query edit query dialog. MUST be ignored if **dbt** does not equal 0x0004. + +**id (variable):** A [DConnId](#dconnid) that specifies the object that this connection is associated with. + +### DConName + +The **DConName** record specifies a [**named range**](#gt_042582ea-4050-4e5c-a2df-ae39706a19b6) that is a [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) or a data source for the [**data consolidation**](#gt_ede978bb-cef1-4f8c-b56a-7129cb228738) settings of the associated [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). The [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) is specified as a reference to an [external workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc) or a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). If the named range is in an external workbook, this record specifies the path to the external workbook. If the named range has a defined name that has a sheet-level scope, this record also specifies the name of the sheet that contains the range. + +[TABLE] + +**stName (variable):** An [XLNameUnicodeString](#xlnameunicodestring) structure that specifies a defined name for the source range. + +**cchFile (2 bytes):** An unsigned integer that specifies the character count of **stFile**. MUST be 0x0000, or greater than or equal to 0x0002. A value of 0x0000 specifies that the defined name in **stName** has a workbook scope and is contained in this file. + +**stFile (variable):** A [DConFile](#dconfile) structure that specifies the workbook, or workbook and sheet, that contains the range specified in **stName.** This field exists only if the value of **cchFile** is greater than zero. If the defined name in **stName** has workbook scope, this field specifies the workbook file that contains the defined name and its associated range. If the defined name in **stName** has a sheet-level scope, this field specifies both the sheet name and the workbook that contains the defined name and its associated range. + +**unused (variable):** An array of bytes that is unused and MUST be ignored. MUST exist if and only if **cchFile** is greater than 0 and **stFile** specifies a self-reference (the value of **stFile.stFile.rgb**\[0\] is 2). If the value **stFile.stFile.fHighByte** is 0, the size of this array is 1. If the value of **stFile.stFile.fHighByte** is 1, the size of this array is 2. + +### DConRef + +The **DConRef** record specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) or in an [external workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc) that is a [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) or a data source for the [**data consolidation**](#gt_ede978bb-cef1-4f8c-b56a-7129cb228738) settings of the associated [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). If the range specified is in an external workbook this record also specifies the path to the external workbook. + +[TABLE] + +**ref (6 bytes):** A [RefU](#refu) structure that specifies the range. If this record is part of an [SXTBL](#globals-substream) production as specified in the Globals Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) and this field has a **rwFirst** equal to 0 and a **rwLast** equal to 16383, this reference specifies all rows within the columns specified by **colFirst** and **colLast**. + +**cchFile (2 bytes):** An unsigned integer that specifies the count of characters in **stFile**. MUST be greater than or equal to 0x0002. + +**stFile (variable):** A [DConFile](#dconfile) structure that specifies the workbook and sheet that contains the range specified in the **ref** field. + +**unused (variable):** An array of bytes that is unused and MUST be ignored. MUST exist if and only if **stFile** specifies a self reference (the value of **stFile.stFile.rgb**\[0\] is 2). If the value **stFile.stFile.fHighByte** is 0 the size of this array is 1. If the value of **stFile.stFile.fHighByte** is 1 the size of this array is 2. + +### DefaultRowHeight + +The **DefaultRowHeight** record specifies the height of all empty rows in the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). An empty row is a row that only contains [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) without data or formatting. + +[TABLE] + +**A - fUnsynced (1 bit):** A bit that specifies whether the default settings for the row height have been changed. + +**B - fDyZero (1 bit):** A bit that specifies whether empty rows have a height of zero. + +**C - fExAsc (1 bit):** A bit that specifies whether all empty rows have a thick [**border style**](#gt_2baf659e-8e18-4f60-b3d0-ce0b8e1f2eab) applied to the top [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) (as specified in field **fExAsc** of record [Row](#row)). + +**D - fExDsc (1 bit):** A bit that specifies whether all empty rows have a thick border style applied to the bottom border (as specified in field **fExDes** of record Row). + +**reserved (12 bits):** MUST be zero, and MUST be ignored. + +**miyRw (2 bytes):** A signed integer that specifies the default row height, in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382), for empty rows. MUST exist if and only if **fDyZero** is 0. MUST be greater than or equal to 1 and less than or equal to 8179. + +**miyRwHidden (2 bytes):** A signed integer that specifies the default row height, in twips, to apply to a [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) row when unhidden. MUST exist if and only if **fDyZero** is 1. MUST be greater than or equal to 0 and less than or equal to 8179. + +### DefaultText + +The **DefaultText** record specifies the text elements that are formatted using the information specified by the [Text](#text) record immediately following this record. + +[TABLE] + +**id (2 bytes):** An unsigned integer that specifies the text elements that are formatted using the position and appearance information specified by the Text record immediately following this record. MUST be a value from the following table. + +If this record is in a sequence of records that conforms to the [CRT](#chart-sheet-substream) rule as specified by the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), then this field MUST be 0x0000 or 0x0001. If this record is not in a sequence of records that conforms to the CRT rule as specified by the Chart Sheet Substream ABNF, then this field MUST be 0x0002 or 0x0003. + +| Value | Meaning | +|----|----| +| 0x0000 | Format all Text records in the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) where **fShowPercent** is equal to 0 or **fShowValue** is equal to 0. | +| 0x0001 | Format all Text records in the chart group where **fShowPercent** is equal to 1 or **fShowValue** is equal to 1. | +| 0x0002 | Format all Text records in the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) where the value of **fScaled** of the associated [FontInfo](#fontinfo) structure is equal to 0. | +| 0x0003 | Format all Text records in the chart where the value of **fScaled** of the associated FontInfo structure is equal to 1. | + +### DefColWidth + +The **DefColWidth** record specifies the default column width of a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and specifies the beginning of a collection of [ColInfo](#colinfo) records as defined by the [Macro Sheet Substream](#Section_0dddd943f77a4fc2bf92868acb4587f7) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) and [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF. The collection of ColInfo records specifies the column formatting for a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of columns. + +[TABLE] + +**cchdefColWidth (2 bytes):** An unsigned integer that specifies the default width, in number of characters, of the columns in the sheet. MUST be less than or equal to 255. + +### Dimensions + +The **Dimensions** record specifies the used [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). It specifies the row and column bounds of used [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the sheet. Used cells include all cells with formulas (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) or data. Used cells also include all cells with formatting applied directly to the cell. Cells can also be formatted by default row or column formatting. If a row has default formatting then the used range includes that row in its row bounds, but does not affect the used range column bounds, unless the used range would otherwise be empty, in which case the column bounds are set to include the first column. If a column has default formatting then the used range includes that column in its column bounds, but does not affect the used range row bounds, unless the used range would otherwise be empty, in which case the row bounds are set to include the first row. + +[TABLE] + +**rwMic (4 bytes):** A [RwLongU](#rwlongu) structure that specifies the first row in the sheet that contains a used cell. + +**rwMac (4 bytes):** An unsigned integer that specifies the zero-based index of the row after the last row in the sheet that contains a used cell. MUST be less than or equal to 0x00010000. If this value is 0x00000000, no cells on the sheet are used cells. + +**colMic (2 bytes):** A [ColU](#colu) structure that specifies the first column in the sheet that contains a used cell. + +**colMac (2 bytes):** An unsigned integer that specifies the zero-based index of the column after the last column in the sheet that contains a used cell. MUST be less than or equal to 0x0100. If this value is 0x0000, no cells on the sheet are used cells. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +### DocRoute + +The **DocRoute** record specifies the document routing information for a [**routing slip**](#gt_8cedfe36-260c-416e-aeab-7fee4bdef9c3)[\<77\>](#Appendix_A_77) that is used to send a document in an e-mail message and specifies the beginning of a collection of [RecipName](#recipname) records as defined by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of RecipName records specifies the recipients of the routing slip. + +[TABLE] + +**iStage (2 bytes):** An unsigned integer that specifies the [**routing stage**](#gt_8a637321-ad73-45ee-bfdb-9de9c12fc505) of the slip. This value MUST be less than or equal to the **cRecip** field +1. + +**cRecip (2 bytes):** An unsigned integer that specifies the number of recipients. MUST equal the actual number of RecipName records that follow this record. + +**delOption (2 bytes):** An unsigned integer that specifies the delivery option. MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------| +| 0x00 | Deliver to one recipient at a time | +| 0x01 | Deliver to all recipients at once | + +**A - fRouted (1 bit):** A bit that specifies whether the document has been routed. + +**B - fReturnOrig (1 bit):** A bit that specifies whether the document is returned to the originator after being routed to the last recipient. + +**C - fTrackStatus (1 bit):** A bit that specifies whether a status message is sent to the originator after the document is routed. + +**D - fCustomType (1 bit):** A bit that specifies whether there is a custom message type defined by **szCustType**. + +**E - unused1 (3 bits):** Undefined and MUST be ignored. + +**F - fSaveRouteInfo (1 bit):** A bit that specifies whether the routing information is saved with the document. MUST equal 1. + +**unused2 (8 bits):** Undefined and MUST be ignored. + +**cchSubject (2 bytes):** An unsigned integer that specifies the count of characters in the **szSubject** field string. MUST be less than or equal to 256. + +**cchMessage (2 bytes):** An unsigned integer that specifies the count of characters in the **szMessage** field string. MUST be less than or equal to 256. + +**cchRouteID (2 bytes):** An unsigned integer that specifies the count of characters in the **szRouteID** field string. MUST be less than or equal to 256. + +**cchCustType (2 bytes):** An unsigned integer that specifies the count of characters in the **szCustType** field string. MUST be less than or equal to 256. MUST equal 0 if the **fCustomType** field equals 0. + +**cchBookTitle (2 bytes):** An unsigned integer that specifies the count of characters in the **szBookTitle** field string. MUST be less than or equal to 256. + +**cchOrg (2 bytes):** An unsigned integer that specifies the count of characters in the **szOrg** field string. MUST be less than or equal to 256. + +**ulEIDSize (4 bytes):** An unsigned integer that specifies the count of characters in the **rgchSSAddr** field string. When combined with the values of **cchSubject**, **cchMessage**, **cchRouteID**, **cchCustType**, **cchBookTitle**, and **cchOrg** fields, the value MUST be less than or equal to 8202. + +**szSubject (variable):** A NULL terminated array of ANSI characters that specifies the subject of the routed document. The length of the string MUST be specified by the **cchSubject** field. The field MUST NOT exist if the **cchSubject** field is 0. + +**szMessage (variable):** A NULL terminated array of ANSI characters that specifies the message of the routed document. The length of the string MUST be specified by the **cchMessage** field. The field MUST NOT exist if the **cchMessage** field is 0. + +**szRouteID (variable):** A NULL terminated array of ANSI characters that specifies the name of the routing identifier. The length of the string MUST be specified by the **cchRouteID** field. The field MUST NOT exist if the **cchRouteID** field is 0. + +**szCustType (variable):** A NULL terminated array of ANSI characters that specifies a custom message. The length of the string MUST be specified by the **cchCustType** field. The field MUST NOT exist if the field **cchCustType** is 0. + +**szBookTitle (variable):** A NULL terminated array of ANSI characters that specifies the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) title. The length of the string MUST be specified by the **cchBookTitle** field. The field MUST NOT exist if the **cchBookTitle** field is 0. + +**szOrg (variable):** A NULL terminated array of ANSI characters that specifies the originator’s [**friendly name**](#gt_3dafc161-8c9d-406a-8cbd-c61e7f925eea). The length of the string MUST be specified by the **cchOrg** field. The field MUST NOT exist if the **cchOrg** field is 0. + +**rgchSSAddr (variable):** A NULL terminated array of ANSI characters that specifies the identifier used by the [**messaging system service provider**](#gt_ff288e35-3b60-4a5e-99d6-faa6afa8009a) to identify the originator’s e-mail address. The length of the string MUST be specified by the **ulEIDSize** field. The field MUST NOT exist if the **ulEIDSize** field is 0. + +### DropBar + +The **DropBar** record specifies the attributes of the [**up bars**](#gt_24acb31a-39aa-4a44-829b-c18e1767a4ac) or the [**down bars**](#gt_d8bcbdc9-46a4-44e5-b184-40c565e4dd07) between multiple [series](#Section_527ce4dfc9f84e50a314d4b07519593c) of a line [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The first of these collections in the line chart group specifies the attributes of the up bars.  The second specifies the attributes of the down bars.  If this record exists, then the chart group type MUST be line and the field **cSer** in the record [SeriesList](#serieslist) MUST be greater than 1. + +[TABLE] + +**pcGap (2 bytes):** A signed integer that specifies the width of the gap between the up bars or the down bars. MUST be a value between 0 and 500. The width of the gap in [SPRCs](#Section_d5fc728e68de4972905a975bcef8c82d) can be calculated by the following formula: + +Width of the gap in SPRCs = 1 + **pcGap** + +### DropDownObjIds + +The **DropDownObjIds** record specifies the object identifiers that can be reused by the application when creating the dropdown objects for the [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) at runtime in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0874. + +**cidObj (2 bytes):** An unsigned integer that specifies the count of the object identifiers in **rgidObj**. + +**rgidObj (variable):** An array of 2-byte unsigned integers that specifies the object identifiers that can be reused by the application when creating the dropdown objects for the AutoFilter at runtime in a sheet. These object identifiers MUST NOT equal an existing [ObjId](#objid) structure in the [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream. + +### DSF + +The **DSF** record is reserved and MUST be ignored. + +[TABLE] + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +### Dv + +The **Dv** record specifies a single set of [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) criteria defined for a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) on this [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**valType (4 bits):** An unsigned integer that specifies the type of data validation.  MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that the data validation allows any type of value and does not check for a type or range of values. | +| 0x1 | Specifies that the data validation checks for and allows whole number values satisfying the given condition. | +| 0x2 | Specifies that the data validation checks for and allows decimal values satisfying the given condition. | +| 0x3 | Specifies that the data validation checks for and allows a value that matches one in a list of values. | +| 0x4 | Specifies that the data validation checks for and allows date values satisfying the given condition. | +| 0x5 | Specifies that the data validation checks for and allows time values satisfying the given condition. | +| 0x6 | Specifies that the data validation checks for and allows text values whose length satisfies the given condition. | +| 0x7 | Specifies that the data validation uses a custom formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) to check the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) value. | + +**A - errStyle (3 bits):** An unsigned integer that specifies the style of error alert to be used in the error message which is shown if the **fShowErrorMsg** bit is set to 1.  MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that the data validation error style uses a stop [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) in the error alert. | +| 0x1 | Specifies that the data validation error style uses a warning icon in the error alert. | +| 0x2 | Specifies that the data validation error style uses an information icon in the error alert | + +**B - fStrLookup (1 bit):** A bit that specifies whether a list of valid inputs was specified for data validation. MUST be ignored if **valType** is not equal to 3. + +**C - fAllowBlank (1 bit):** A bit that specifies whether the data validation treats empty or blank entries as valid. + +**D - fSuppressCombo (1 bit):** A bit that specifies whether to suppress the display of the in-cell drop-down when the cell is [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595). MUST be ignored if **valType** is not equal to 3. + +**mdImeMode (8 bits):** An unsigned integer that specifies the [**Input Method Editor (IME)**](#gt_19d3dd70-8d6a-4847-9827-ebbde6b1a9b7) mode enforced by this data validation. This value is only used when the [**input language**](#gt_223b5207-0d94-4cc1-891d-3c74349d606a) is one of the following languages: + +- Chinese Simplified (Locale identifier = 2052) + +- Chinese Traditional (Locale identifier = 1028) + +- Japanese (Locale identifier = 1041) + +- Korean  (Locale identifier = 1042) + +The input for the cell can be restricted to specific sets of characters, as specified by the value of **mdImeMode**. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------------------------------| +| 0x00 | No Control | +| 0x01 | On | +| 0x02 | Off (English) | +| 0x04 | Hiragana | +| 0x05 | [**wide katakana**](#gt_49e3662b-e146-4c32-a815-eaac74a92000) | +| 0x06 | [**narrow katakana**](#gt_514e674e-2e44-41d8-9c31-ee11c825b669) | +| 0x07 | Full-width alphanumeric | +| 0x08 | Half-width alphanumeric | +| 0x09 | Full-width hangul | +| 0x0A | Half-width hangul | + +**E - fShowInputMsg (1 bit):** A bit that specifies whether to show an input prompt when the cell is selected. + +**F - fShowErrorMsg (1 bit):** A bit that specifies whether to display an error message when the data validation fails. + +**G - typOperator (4 bits):** An unsigned integer that specifies the relational operator used with this data validation.  If **valType** is equal to 0, 3 or 7, the value of the **typOperator** field is undefined and MUST be ignored.  MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------| +| 0x0 | Between | +| 0x1 | Not Between | +| 0x2 | Equals | +| 0x3 | Not Equals | +| 0x4 | Greater Than | +| 0x5 | Less Than | +| 0x6 | Greater Than or Equal To | +| 0x7 | Less Than or Equal To | + +**reserved (8 bits):** MUST be zero, and MUST be ignored. + +**PromptTitle (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the title of the input prompt that is displayed when the cell is selected. The number of characters in this string MUST be less than or equal to 32. + +**ErrorTitle (variable):** An XLUnicodeString structure that specifies the title of the error that is displayed when the cell value entered fails the data validation criteria. The number of characters in this string MUST be less than or equal to 32. + +**Prompt (variable):** An XLUnicodeString structure that specifies the message shown in the input prompt that is displayed when the cell is selected. The number of characters in this string MUST be less than or equal to 255. + +**Error (variable):** An XLUnicodeString structure that specifies the error message that is displayed when the cell value entered fails the data validation criteria. The number of characters in this string MUST be less than or equal to 225. + +**formula1 (variable):** A [DVParsedFormula](#dvparsedformula) structure that specifies the first formula (section 2.2.2) used in data validation. + +If **valType** is equal to 0, this formula MUST be ignored and **formula1.cce** MUST be zero. + +If **valType** is not one of 0, 3, or 7 and **typOperator** is equal to 0 or 1, this formula is used as the lesser of two bounding values and **formula1.cce** MUST be greater than or equal to 1. + +Otherwise, this formula is the only formula for those cases, and **formula1.cce** MUST be greater than or equal to 1. + +**formula2 (variable):** A DVParsedFormula structure that specifies the second formula used in data validation. + +If **typOperator** is greater than or equal to 2 or **valType** is equal to 0, 3 or 7, this formula MUST be ignored and **formula2.cce** MUST be zero. + +Otherwise, this formula is used as the greater of two bounding values and **formula2.cce** MUST be greater than or equal to 1. + +**sqref (variable):** A [SqRefU](#sqrefu) structure that specifies all the ranges over which data validation is applied. The value of **sqref.cref** MUST be greater than 0 and less than or equal to 432. + +### DVal + +The **DVal** record specifies [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) information that is common to all cells in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that have data validation applied and specifies the beginning of a collection of [Dv](#dv) records as defined by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of Dv records specifies data validation criteria for individual [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) in the sheet. + +[TABLE] + +**A - fWnClosed (1 bit):** A bit that specifies whether the window used for input is closed. + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - unused (1 bit):** Undefined and MUST be ignored. + +**reserved2 (13 bits):** MUST be zero, and MUST be ignored. + +**xLeft (4 bytes):** An unsigned integer that specifies the X-coordinate of the top left corner of the window used for input relative to the window used to display the sheet, in pixels. MUST be less than or equal to 65535. + +**yTop (4 bytes):** An unsigned integer that specifies the Y-coordinate of the top left corner of the window used for input relative to the window used to display the sheet, in pixels. MUST be less than or equal to 65535. + +**idObj (4 bytes):** A signed integer that specifies a reference to an [Obj](#obj) that represents the drop-down button displayed if a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) with a drop-down button is the [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) cell at the time the file is saved. The value of this field specifies the value of the **cmo.id** field of the associated Obj record. MUST be greater than 0 and less than or equal to 32767 if the drop-down button is displayed. MUST be -1 if there is no drop-down button being displayed in the selected cell at the time the file is saved. + +**idvMac (4 bytes):** An unsigned integer that specifies the number of Dv records that follow this record. MUST be greater than or equal to 0 and less than or equal to 65534. There MUST be exactly that many Dv records following this record. + +### DXF + +The **DXF** record specifies a [differential format](#Section_f0b6070c31f54d3dbcb719612da8b8f6). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 2189. + +**A - unused1 (1 bit):** Undefined and MUST be ignored.[\<78\>](#Appendix_A_78) + +**B - fNewBorder (1 bit):** A bit that specifies whether it is possible to specify internal [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad) in **xfprops**. Internal border formatting is formatting that applies to borders that lie between a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that internal border formatting cannot be used in **xfprops**. | +| 0x1 | Specifies that internal border formatting can be used in **xfprops**. | + +**C - unused2 (1 bit):** Undefined and MUST be ignored. + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +**xfprops (variable):** An [XFProps](#xfprops) structure that specifies the formatting properties. + +### DxGCol + +The **DxGCol** record specifies the default column width for all [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) columns that do not have a column width explicitly specified. If an explicit column width was specified for a column, it is stored in a [ColInfo](#colinfo) record. + +[TABLE] + +**dxgCol (2 bytes):** An unsigned integer that specifies the default column width. For the purposes of this field specification, a standard digit is defined to be the widest digit in the [Normal style](#Section_d039c65186dc4d9da6ee1cb8c1088f20) [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). The default column width is measured in the number of standard digits that fit in the column multiplied by 256 and rounded down. The value MUST be less than or equal to 65535 or be equal to 0xFFFFFFFF. If the value is 0xFFFFFFFF, this value MUST be ignored. + +### End + +The **End** record specifies the end of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies properties of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +### EndBlock + +The **EndBlock** record specifies the end of a collection of records. [Future records](#Section_b660b67822684414839ed1ae9a4e4e85) contained in this collection specify saved features to allow applications that do not support the feature to preserve the information. This record MUST have an associated [StartBlock](#startblock) record. StartBlock and EndBlock pairs can be nested. Up to 100 levels of blocks can be nested. + +EndBlock records MUST be written according to the following rules: + +- If there exists a StartBlock record with **iObjectKind** equal to 0x0000 without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the [End](#end) record of the current [Axis Group](#Section_578b739742624944b5a67ee6d4d3bb55). + +- If there exists a StartBlock record with **iObjectKind** equal to 0x0002 without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current [AttachedLabel](#Section_9ac44e58af9940f4a99ace470eff0f5a). + +- If there exists a StartBlock record with **iObjectKind** equal to 0x0004 without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current [Axis](#Section_4117f73aa0f348d89c0f65864918ffb3). + +- If there exists a StartBlock record with **iObjectKind** equal to 0x0005 without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). + +- If there exists a StartBlock record with **iObjectKind** equal to 0x0006 without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the sequence of records containing the StartBlock and conforming to the [DAT](#chart-sheet-substream) rule. + +- If there exists a StartBlock record with **iObjectKind** equal to 0x0007 without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the sequence of records containing the StartBlock and conforming to the FRAME rule. + +- If there exists a StartBlock record with **iObjectKind** equal to 0x0009 without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current [Legend](#Section_1832229b7d1945f488d455e9c07466f0). + +- If there exists a StartBlock record with **iObjectKind** equal to 0x000A without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current [Begin](#begin) and End collection that exists immediately after [LegendException](#legendexception) in the sequence of records conforming to the SERIESFORMAT rule. + +- If there exists a StartBlock record with **iObjectKind** equal to 0x000C without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current [Series](#Section_527ce4dfc9f84e50a314d4b07519593c). + +- If there exists a StartBlock record with **iObjectKind** equal to 0x000D without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current [Sheet](#Section_2c90d75bc92645aa8ff29d4483f51831). + +- If there exists a StartBlock record with **iObjectKind** equal to 0x000E without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the current SS production. + +- If there exists a StartBlock record with **iObjectKind** equal to 0x000F without a matching EndBlock, then a matching EndBlock record MUST exist immediately before the End record of the sequence of records containing the StartBlock and conforming to the DROPBAR rule. + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0853. + +**iObjectKind (2 bytes):** An unsigned integer that specifies the type of object that is encompassed by the block. MUST equal the **iObjectKind** field of the associated StartBlock record. MUST be a value from the following table: + +| Value | Object Type | +|--------|---------------------------| +| 0x0000 | Axis Group | +| 0x0002 | AttachedLabel | +| 0x0004 | Axis | +| 0x0005 | chart group | +| 0x0006 | [Dat](#dat) | +| 0x0007 | Frame | +| 0x0009 | Legend | +| 0x000A | LegendException | +| 0x000C | Series | +| 0x000D | Sheet | +| 0x000E | [DataFormat](#dataformat) | +| 0x000F | DropBar | + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**unused3 (2 bytes):** Undefined and MUST be ignored. + +### EndObject + +The **EndObject** record specifies properties of an [Future Record Type (FRT)](#Section_b660b67822684414839ed1ae9a4e4e85) as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a feature saved as an FRT such that an application not supporting the feature can preserve it. This record MUST have an associated [StartObject](#startobject) record. StartObject and EndObject pairs can be nested. Up to 100 levels of blocks can be nested. + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0855. + +**iObjectKind (2 bytes):** An unsigned integer that specifies the type of object that is encompassed by the block. MUST equal the **iObjectKind** field of the associated StartObject record. MUST be a value from the following table: + +| Value | Object Type | +|--------|-----------------------------| +| 0x0010 | [YMult](#ymult) | +| 0x0011 | [FrtFontList](#frtfontlist) | +| 0x0012 | [DataLabExt](#datalabext) | + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**unused3 (2 bytes):** Undefined and MUST be ignored. + +### EntExU2 + +The **EntExU2** record specifies an application-specific cache of information. SHOULD NOT[\<79\>](#Appendix_A_79) be written, and SHOULD[\<80\>](#Appendix_A_80) be ignored. + +[TABLE] + +**rgb (variable):** An array of bytes that specifies an application-specific cache of information. This cache exists for performance reasons only, and can be rebuilt based on information stored elsewhere in the file without affecting calculation results. + +### EOF + +The **EOF** record specifies the end of a collection of records as defined by [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF, [Dialog Sheet Substream](#Section_da37feb48b9a462d87772a5fddd4866e) ABNF, [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) ABNF, [macro sheet](#Section_0dddd943f77a4fc2bf92868acb4587f7) substream ABNF, [revision](#revision-stream-revision-log) stream ABNF, and [pivot cache](#Section_c5fb3f663ef64308ae3de59244159687) storage ABNF. + +### Excel9File + +The **Excel9File** record is optional and is unused. It doesn’t exist on files that were last saved in a specific version of the application[\<81\>](#Appendix_A_81). + +### ExternName + +The **ExternName** record specifies an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2), a User Defined Function ([**UDF**](#gt_5068e37f-372c-41df-9357-1072e12ed970)) reference on a [**XLL**](#gt_3d6e3f45-91e7-46d5-871c-0b2fde20b5f5) or [**COM**](#gt_ef2ebebc-1760-407a-9ace-af48f9050e02) [**add-in**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6), a [DDE data item](#Section_2492b742489e489f945187a703134708) or an [OLE data item](#Section_11cff7c06cf34f8694bede7a72497e21), depending on the value of the **virtPath** field in the preceding [SupBook](#supbook) record. If the **cch** field in the preceding SupBook record is 0x3A01, then this record specifies a UDF reference. Otherwise if the **virtPath** field in the preceding SupBook record conforms to the ole-link rule specified in the [VirtualPath](#virtualpath) ABNF, then this record specifies a DDE data item or an OLE data item. Otherwise, this record specifies an external defined name. + +[TABLE] + +**A - fBuiltIn (1 bit):** A bit that specifies whether this record specifies a user-defined or built-in external defined name. The value MUST be 0 if this record specifies a DDE data item, an OLE data item or a UDF reference on a XLL or COM add-in. Otherwise, MUST be one of the following: + +| Value | Meaning | +|-------|--------------------------------------------| +| 0 | The external defined name is user-defined. | +| 1 | The external defined name is built-in. | + +**B - fWantAdvise (1 bit):** A bit that specifies whether this record is an automatic DDE data item or OLE data item. MUST be one of the following: + +| Value | Meaning | +|----|----| +| 0 | The record is an external defined name, a manual DDE data item, a manual OLE data item or a UDF reference on a XLL or COM add-in. | +| 1 | The record is either an automatic DDE data item or an automatic OLE data item. | + +**C - fWantPict (1 bit):** A bit that specifies whether this record's linked data uses a picture format. The value MUST be 0 if this record specifies an external defined name or a UDF reference on a XLL or COM add-in. + +**D - fOle (1 bit):** A bit that, together with the value of **fOleLink**, specifies the structure of **body**. The value MUST be 0 if this record is an external defined name, an OLE data item or a UDF reference on a XLL or COM add-in. If this value is 1, **fOleLink** MUST be 0. + +**E - fOleLink (1 bit):** A bit that, together with the value of **fOle**, specifies the structure of **body**. The value MUST be 0 if this record is an external defined name or a UDF reference on a XLL or COM add-in. If this value is 1, **fOle** MUST be 0 and this record specifies an OLE data item. + +**cf (10 bits):** A signed integer that specifies the type of the cached clipboard format for a DDE data item or an OLE data item. The value MUST be 0 if this record is an external defined name or a UDF reference on a XLL or COM add-in. The value MUST be one of the values in the following table: + +| Value | Meaning | +|----|----| +| -1 | There is no cached clipboard format. | +| 0 | This record is an external defined name or the cached clipboard format is text. For the text format, each line ends with a carriage return/linefeed (CR-LF) combination. A null character signals the end of the data. | +| 2 | Cached clipboard format is Enhanced Metafile. | +| 5 | Cached clipboard format is CSV (comma-delimited). | +| 6 | Cached clipboard format is Microsoft Symbolic Link (SYLK). SYLK is a format used to exchange data between applications. | +| 7 | Cached clipboard format is rich text (RTF). | +| 8 | Cached clipboard format is [**BIFF8**](#gt_e60b71bb-c66c-4a44-ab07-0f9f20ee3dd5). | +| 9 | Cached clipboard format is Bitmap. | +| 16 | Cached clipboard format is a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) created using a specific application[\<82\>](#Appendix_A_82). | +| 20 | Cached clipboard format is [**BIFF3**](#gt_3b9d80df-ea32-495e-b43b-fa8a6d942ab9). | +| 30 | Cached clipboard format is [**BIFF4**](#gt_d99263f5-d806-4c42-9923-00c72054162a). | +| 36 | Cached clipboard format is Metafile Picture Format. | +| 44 | Cached clipboard format is [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) text. Each line ends with a carriage return/linefeed (CR-LF) combination. A null character signals the end of the data. | +| 63 | Cached clipboard format is [**BIFF12**](#gt_3da41ba7-d5ae-4b62-b410-e36e20650d0d). | + +**F - fIcon (1 bit):** A bit that specifies whether linked data is displayed as an [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870). The value MUST be 0 if this record is an external defined name, a DDE data item or a UDF reference on a XLL or COM add-in. + +**body (variable):** A variable type field whose type and meaning is dictated by the values of **fOle** and **fOleLink**, as specified in the following table: + +[TABLE] + +### ExternSheet + +The **ExternSheet** record specifies a collection of [XTI](#xti) structures. + +[TABLE] + +**cXTI (2 bytes):** An unsigned integer that specifies the number of elements in the **rgXTI** array. + +**rgXTI (variable):** An array of XTI structures. The number of elements in this array MUST be **cXTI**. + +### ExtSST + +The **ExtSST** record specifies the location of sets of strings within the shared string table, specified in the [SST](#sst) record. This record is used to perform a quick lookup of a string within the shared string table, given the string’s index into the table (as specified in [LabelSst](#labelsst)). To do that, first use the string’s index and the value of **dsst** to find the set the string is in, then use the corresponding element in **rgISSTInf** to find the beginning of that set, and finally search incrementally forward in that set to locate the string. + +[TABLE] + +**dsst (2 bytes):** An unsigned integer that specifies the number of strings in each set specified by [ISSTInf](#isstinf). Number of strings in each set except the last set MUST be equal to the value specified by the following formula: + +max(((SST.**cstUnique** / 128) + 1),8) + +Number of strings in the last set MUST be less than or equal to the value specified by the following formula: + +max(((SST.**cstUnique** / 128) + 1),8) + +**rgISSTInf (variable):** An array of ISSTInf structures. Each array element specifies the location of a set of strings within the SST record. The number of elements is determined by first evaluating the following formula[\<83\>](#Appendix_A_83): + +(SST.**cstUnique** mod **ExtSST**.**dsst**) + +If the result of the previous formula is equal to 0, then the number of elements MUST be equal to the value as specified by the following formula: + +(SST.**cstUnique** / **ExtSST**.**dsst**) + +Otherwise, the number of elements MUST be equal to the value as specified by the following formula: + +(SST.**cstUnique** / **ExtSST**.**dsst**) + 1 + +### ExtString + +The **ExtString** record specifies the [**connection string**](#gt_03a9d0ca-2f10-4f3d-b910-052714a96f7d) for a [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) that retrieves [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e). + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 2052. + +**string (variable):** A [XLUnicodeString](#xlunicodestring) structure that specifies the connection string. + +**unused1 (variable):** Undefined and MUST be ignored. MUST exist if and only if the value of the following formula is less than 12 bytes: + +size of **string** + size of **frtHeaderOld** + +The size of this field, in bytes, is calculated using the following formula: + +12 – (size of **string** + size of **frtHeaderOld**) + +### Fbi + +The **Fbi** record specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information at the time the scalable font is added to the chart.[\<84\>](#Appendix_A_84) + +If the scaled font size matches the font size of the [Font](#font) record (as specified by **ifnt** and Font.**dyHeight**), then that Font record is used to render the scaled fonts. If the scaled font size doesn't match the size of the Font record (as specified by **ifnt**), then a new Font record is added to the font table and the following [**font scaling**](#gt_47254269-4165-4a8c-92a0-c920f732d0bd) algorithm is used to determine the scaled font size: + +1. Start with the current chart area in dots or pixels at 96 DPI. Convert this size to Twips by multiplying width and height by 1440 Twips per inch / 96 dots per inch. Call this dmix and dmiy respectively. + +2. If the scale basis **scab** is [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c), then apply the plot area scaling factors PlotGrowth.**dxPlotGrowth**/65536 and PlotGrowth.**dyPlotGrowth**/65536 to dmix and dmiy respectively. + +3. Determine the scaled height basis by multiplying **twpHeightBasis** by dmix / **dmixBasis**; name this twpX. + +4. Multiply **twpHeightBasis** by dmiy / **dmiyBasis**; call this twpY. + +5. Take the smaller of twpX and twpY and name this twpNew. If this value is less than 10, set it equal to 10. + +6. Round this value to the nearest quarter [**point**](#gt_d072e4da-7898-4227-8f25-9fe77db43571). + +7. If the value of **twpHeightBasis** is between 160 (inclusive) and 240 (inclusive), and the value of twpNew is between 120 (inclusive) and 160, make twpNew equal to 160. If the value of Fbi.**twpHeightBasis** is between 160 (inclusive) and 240 (inclusive), and value of twpNew is between 240 and 280 (inclusive), make twpNew equal to 240. + +8. twpNew is the new scaled font size. If the **dyHeight** field of the Font record (as specified by Fbi.**ifnt**) is the same as the value of twpNew, then load that Font record for the scaled font. If it isn't the same, twpNew is the new scaled font size and a new Font record is added to the font table. + +[TABLE] + +**dmixBasis (2 bytes):** An unsigned integer that specifies the font width, in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382), when the font was first applied. MUST be greater than or equal to 0 and less than or equal to 0x7FFF. + +**dmiyBasis (2 bytes):** An unsigned integer that specifies the font height, in twips, when the font was first applied. MUST be greater than or equal to 0 and less than or equal to 0x7FFF. + +**twpHeightBasis (2 bytes):** An unsigned integer that specifies the default font height in twips. MUST be greater than or equal to 20 and less than or equal to 8180. + +**scab (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies the scale to use. The value MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x0000 | Scale by [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) | +| 0x0001 | Scale by plot area | + +**ifnt (2 bytes):** A [FontIndex](#fontindex) structure that specifies the font. MUST be used when **ifnt** is less than or equal to 255. + +### Fbi2 + +The **Fbi2** record specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information at the time the scalable font is added to the chart.[\<85\>](#Appendix_A_85) + +[TABLE] + +**dmixBasis (2 bytes):** An unsigned integer that specifies the font width, in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382), when the font was first applied. MUST be greater than or equal to 0 and less than or equal to 0x7FFF. + +**dmiyBasis (2 bytes):** An unsigned integer that specifies the font height, in twips, when the font was first applied. MUST be greater than or equal to 0 and less than or equal to 0x7FFF + +**twpHeightBasis (2 bytes):** An unsigned integer that specifies the default font height in twips. MUST be greater than or equal to 20 and less than or equal to 8180. + +**scab (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies the scale to use. The value MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x0000 | Scale by [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)) | +| 0x0001 | Scale by [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) | + +**ifnt (2 bytes):** A [FontIndex](#fontindex) structure that specifies the font. MUST be used when **ifnt** is greater than 255. + +### Feat + +The **Feat** record specifies [Shared Feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2) data. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. **frtHeader.rt** MUST be 0x0868. + +**isf (2 bytes):** A [SharedFeatureType](#sharedfeaturetype) enumeration that specifies the type of Shared Feature data stored in the **rgbFeat** field. MUST NOT be ISFLIST. + +**reserved1 (1 byte):** Reserved and MUST be zero. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +**cref (2 bytes):** An unsigned integer that specifies the number of elements in the **refs** field. + +**cbFeatData (4 bytes):** An unsigned integer whose meaning is determined by the value of **isf**. If **isf** is ISFFEC2, this field specifies the size in bytes of Shared Feature data that is stored in the **rgbFeat** field. Otherwise, this field MUST be zero and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**refs (variable):** An array of [Ref8U](#ref8u) structures. Specifies the [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) referenced by the Shared Feature. The number of elements in the array is specified by **cref**. + +**rgbFeat (variable):** A variable type field that specifies Shared Feature data. The type is dictated by the value of **isf**, as specified in the following table: + +| Value of isf | Meaning | +|---------------|-----------------------------------------------------------| +| ISFPROTECTION | Value is a [FeatProtection](#featprotection) structure. | +| ISFFEC2 | Value is a [FeatFormulaErr2](#featformulaerr2) structure. | +| ISFFACTOID | Value is a [FeatSmartTag](#featsmarttag) structure. | + +### FeatHdr + +The **FeatHdr** record specifies common information for [Shared Features](#Section_86882c8e8d6d46b3aafe006b9e1f18e2) and specifies the beginning of a collection of records as defined by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), [macro sheet](#Section_0dddd943f77a4fc2bf92868acb4587f7) substream ABNF and [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream ABNF. The collection of records specifies Shared Feature data. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** MUST be 0x0867. + +**isf (2 bytes):** A [SharedFeatureType](#sharedfeaturetype) enumeration that specifies the type of Shared Feature. MUST be ISFPROTECTION, ISFFEC2 or ISFFACTOID. + +**reserved (1 byte):** Reserved and MUST be 1. + +**cbHdrData (4 bytes):** An unsigned integer that specifies whether **rgbHdrData** exists. MUST be a value from the following table: + +| Value | Meaning | +|------------|--------------------------------| +| 0x00000000 | **rgbHdrData** MUST NOT exist. | +| 0xFFFFFFFF | **rgbHdrData** MUST exist. | + +**rgbHdrData (variable):** A variable type field containing data whose type and meaning is dictated by the value of the **isf** field of this record and the value of the **dt** field of the [BOF](#bof) record preceding this record, as specified in the following table: + +[TABLE] + +### FeatHdr11 + +The **FeatHdr11** record specifies common information for all [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and specifies the beginning of a collection as specified by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies table information, [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) information and data used for sorting a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader). The **frtHeader.rt** field MUST be 0x0871. + +**isf (2 bytes):** A [SharedFeatureType](#sharedfeaturetype) enumeration that specifies the type of [Shared Feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2). MUST be ISFLIST. + +**reserved1 (1 byte):** Reserved and MUST be 1. + +**reserved2 (4 bytes):** MUST be 0xFFFFFFFF and MUST be ignored. + +**reserved3 (4 bytes):** MUST be 0xFFFFFFFF and MUST be ignored. + +**idListNext (4 bytes):** An unsigned integer that specifies the next identifier to try when assigning a unique identifier to a new table. + +**reserved4 (2 bytes):** MUST be zero, and MUST be ignored. + +### Feature11 + +The **Feature11** record specifies specific [shared feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2) data. The only shared feature type stored in this record is a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) in a [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56). + +**feature (variable):** A [TableFeatureType](#tablefeaturetype) structure. + +If this record is not a [Feature12](#feature12) record, then these rules apply: + +- The **feature.frtRefHeaderU**.**rt** field MUST be 0x0872. + +- **lt** of the embedded TableFeatureType MUST NOT be LTEXTERNALDATA. + +- If **crwHeader** of the embedded TableFeatureType is zero then and **fSingleCell** of the embedded TableFeatureType MUST be zero. + +- **fLoadTotalFmla** and **fLoadTotalStr** of all embedded [Feat11FieldDataItem](#feat11fielddataitem) MUST be zero. + +[TABLE] + +**frtRefHeaderU (12 bytes):** An [FrtRefHeaderU](#frtrefheaderu). The **frtRefHeaderU.rt** field MUST be 0x0872. The **frtRefHeaderU.ref8** MUST refer to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells associated with this record. + +**isf (2 bytes):** A [SharedFeatureType](#sharedfeaturetype) enumeration that specifies the type of Shared Feature data stored in the **rgbFeat** field. MUST be ISFLIST. + +**reserved1 (1 byte):** Reserved and MUST be zero. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +**cref2 (2 bytes):** An unsigned integer that specifies the count of [Ref8U](#ref8u) records within the **refs2** field. + +**cbFeatData (4 bytes):** An unsigned integer that specifies the size in bytes of the **rgbFeat** variable-size field. If the value is 0x0000, the size of the **rgbFeat** field is calculated by the following formula: + +size of **rgbFeat** = total size of record in bytes – size of **refs2** in bytes – 27 bytes + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**refs2 (variable):** An array of Ref8U structures that specifies references to ranges of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the worksheet associated with the feature. The count of records within this field is specified by the **cref2** field. + +**rgbFeat (variable):** A variable-size structure that contains feature specific data. The size of the structure is specified by the **cbFeatData** field. This field MUST contain a TableFeatureType structure. + +### Feature12 + +The **Feature12** record specifies [shared feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2) data that is used to describe a table in a [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56). This record is used to encapsulate a table that has properties not supported by the [Feature11](#feature11) record. + +[TABLE] + +**feature (variable):** A Feature11 record with additional properties enabled. The **feature.frtRefHeaderU**.**rt** field MUST be 0x0878. + +On or more of these additional properties MUST be present in a Feature12 record: + +- **lt** of the embedded [TableFeatureType](#tablefeaturetype) structure is LTEXTERNALDATA. + +- **crwHeader** and **fSingleCell** of the embedded TableFeatureType structure are zero. + +- An embedded [Feat11FieldDataItem](#feat11fielddataitem) structure has **fLoadTotalFmla** or **fLoadTotalStr** equal to 1. + +### FileLock + +The **FileLock** record specifies that the [**shared workbook**](#gt_241c4cae-c49a-438a-87dc-c8fb2c871921) was [**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81) by a particular user. + +[TABLE] + +**lPurpose (4 bytes):** An unsigned integer that specifies the purpose of the file lock. MUST be one of the following: + +| Value | Meaning | +|----|----| +| 0x00000000 | The shared workbook is not locked. | +| 0x00010001 | The shared workbook is locked for writing or releasing user information. | +| 0x00010002 | The shared workbook is locked for merging two revisions. | +| 0x00010004 | The shared workbook is locked to make it exclusive. | +| 0x00010008 | The shared workbook is locked to be deleted or renamed. | + +**stUsrName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the [**user name**](#gt_c298446e-09d2-470d-a70f-5249dafa15c6). The string length MUST be less than or equal to 52. + +**unused (variable):** Undefined and MUST be ignored. This size of this field in bytes is specified by the following formula: + +size = 158 - (byte count of **stUsrName**) + +### FilePass + +The **FilePass** record specifies the encryption algorithm used to encrypt the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and the structure that is used to verify the password provided when attempting to open the workbook. If this record exists, the workbook MUST be encrypted. Refer to the [Encryption (Password to Open)](#Section_0f2ea0a19fc8468d97aa9d333b72d106) overview to understand the details of workbook files that have been encrypted. + +[TABLE] + +**wEncryptionType (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies the encryption type. MUST be a value from the following table:[\<86\>](#Appendix_A_86) + +| Value of wEncryptionType | Meaning | +|----|----| +| 0x0000 | [**XOR obfuscation**](#gt_cbfd1a35-e8c9-4c5a-bc26-e618633d2f50) | +| 0x0001 | RC4 encryption. For more details about RC4 encryption, see \[SCHNEIER\] section 17.1 | + +**encryptionInfo (variable):** A variable type field. The type and meaning of this field is dictated by the value of **wEncryptionType.** If **wEncryptionType** is equal to 0x0000, this field is an [XORObfuscation](#xorobfuscation) structure. If **wEncryptionType** is equal to 0x0001, this field is an RC4 encryption header structure as specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083), 2.3.5.1 or \[MS-OFFCRYPTO\], 2.3.6.1 depending on the value of the first two bytes. The first two bytes of the RC4 encryption header structure MUST be a value from the following table: + +[TABLE] + +### FileSharing + +The **FileSharing** record specifies file sharing options. + +[TABLE] + +**fReadOnlyRec (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the [**read-only recommended**](#gt_720d1791-fa2b-4ee8-a1ef-11139a085dc2) option is selected for this file. If the value is 1, the read-only recommended is selected for this file. + +**wResPass (2 bytes):** An unsigned integer that specifies the password verifier for [**write reservation**](#gt_7bfb4760-386d-41b0-8c74-6faa53221628). If the value is 0, there is no write reservation password. The algorithm is specified in [Password Verifier Algorithm](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4). + +**iNoResPass (2 bytes):** An unsigned integer that specifies that there is no write reservation password. This field exists if and only if **wResPass** is 0. The value MUST be 0. + +**stUNUsername (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the [**user name**](#gt_c298446e-09d2-470d-a70f-5249dafa15c6) that added the write reservation password. This field exists if and only if **wResPass** is not 0. The value of **stUNUsername.cch** MUST be less than or equal to 54. + +### FilterMode + +The **FilterMode** record specifies that the containing [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) data was filtered. If this record exists one or more [AutoFilter](#autofilter) or [AutoFilter12](#autofilter12) records MUST exist within the containing sheet. + +### FnGroupName + +The **FnGroupName** record specifies a user-defined [**function category**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) in the current [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +[TABLE] + +**rgch (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the function category name. MUST be less than or equal to 32 characters in length. The value of this field MUST NOT equal any of the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) names specified by FnGroupName and [FnGrp12](#fngrp12). + +### FnGrp12 + +The **FnGrp12** record specifies the name of a user-defined [**function category**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) in the current [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The user-defined function categories include the function categories defined in both [FnGroupName](#fngroupname) records and FnGrp12 records. The sum of the built-in function categories as specified by [BuiltInFnGroupCount](#builtinfngroupcount) and the user defined function categories in the current workbook MUST be less than or equal to 256. This record specifies the name of a function category after the 32^(nd) function category. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0898. + +**astFnGrp (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the name of the function category. The length of this string MUST be less than or equal to 32 characters. The value of this field MUST NOT equal any of the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) names specified by FnGrp12 and FnGroupName. + +### Font + +The **Font** record specifies a [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) and font formatting information. + +[TABLE] + +**dyHeight (2 bytes):** An unsigned integer that specifies the height of the font in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382). SHOULD[\<87\>](#Appendix_A_87) be greater than or equal to 20 and less than or equal to 8191. MUST be greater than or equal to 20 and less than or equal to 8191, or 0. + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - fItalic (1 bit):** A bit that specifies whether the font is italic. + +**C - unused2 (1 bit):** Undefined and MUST be ignored. MUST be 1 when **uls** is greater than 0x00. + +**D - fStrikeOut (1 bit):** A bit that specifies whether the font has [**strikethrough formatting**](#gt_b16d9600-aebb-4a4f-bf14-c38e13c11c14) applied. + +**E - fOutline (1 bit):** A bit that specifies whether the font has an [**outline effect**](#gt_4e818802-fdc1-4227-b32f-1a3cb0943de7) applied. + +**F - fShadow (1 bit):** A bit that specifies whether the font has a [**shadow effect**](#gt_83056968-00f2-463b-abc6-607dbb242cbf) applied. + +**G - fCondense (1 bit):** A bit that specifies whether the font is condensed. + +**H - fExtend (1 bit):** A bit that specifies whether the font is extended. + +**reserved (8 bits):** MUST be zero, and MUST be ignored. + +**icv (2 bytes):** An unsigned integer that specifies the color of the font. The value SHOULD[\<88\>](#Appendix_A_88) be an [IcvFont](#icvfont) value. The value MUST be an IcvFont value, or 0. + +**bls (2 bytes):** An unsigned integer that specifies the font weight. The value SHOULD[\<89\>](#Appendix_A_89) be a value from the following table. This value MUST be 0, or greater than or equal to 100 and less than or equal to 1000. + +| Value | Meaning | +|-------|--------------------| +| 400 | Normal font weight | +| 700 | Bold font weight | + +**sss (2 bytes):** An unsigned integer that specifies whether superscript, subscript, or normal script is used. The value MUST be one of the following: + +| Value | Meaning | +|--------|---------------| +| 0x0000 | Normal script | +| 0x0001 | Superscript | +| 0x0002 | Subscript | + +**uls (1 byte):** An unsigned integer that specifies the underline [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633). The value MUST be one of the following: + +| Value | Meaning | +|-------|-------------------------------------------------------------------| +| 0x00 | No underline | +| 0x01 | Single underline | +| 0x02 | Double underline | +| 0x21 | [**Single accounting**](#gt_7ad49c0f-e183-47b5-bdbd-c23a5a8315fc) | +| 0x22 | [**Double accounting**](#gt_89f4f531-9a8b-419c-8f51-98ef409b7bdf) | + +**bFamily (1 byte):** An unsigned integer that specifies the [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2) this font belongs to. MUST be a value from the following table:[\<90\>](#Appendix_A_90) + +| Value | Meaning | +|-------|----------------| +| 0x00 | Not applicable | +| 0x01 | Roman | +| 0x02 | Swiss | +| 0x03 | Modern | +| 0x04 | Script | +| 0x05 | Decorative | + +For more information about font family, see the Windows API LOGFONT structure in [\[MSDN-FONTS\]](https://go.microsoft.com/fwlink/?LinkId=90008). + +**bCharSet (1 byte):** An unsigned integer that specifies the [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204). MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------| +| 0x00 | ANSI_CHARSET | +| 0x01 | DEFAULT_CHARSET | +| 0x02 | SYMBOL_CHARSET | +| 0x4D | MAC_CHARSET | +| 0x80 | SHIFTJIS_CHARSET | +| 0x81 | HANGEUL_CHARSET | +| 0x81 | HANGUL_CHARSET | +| 0x82 | JOHAB_CHARSET | +| 0x86 | GB2312_CHARSET | +| 0x88 | CHINESEBIG5_CHARSET | +| 0xA1 | GREEK_CHARSET | +| 0xA2 | TURKISH_CHARSET | +| 0xA3 | VIETNAMESE_CHARSET | +| 0xB1 | HEBREW_CHARSET | +| 0xB2 | ARABIC_CHARSET | +| 0xBA | BALTIC_CHARSET | +| 0xCC | RUSSIAN_CHARSET | +| 0xDD | THAI_CHARSET | +| 0xEE | EASTEUROPE_CHARSET | +| 0xFF | OEM_CHARSET | + +For more information about character set, see the Windows API LOGFONT structure in \[MSDN-FONTS\]. + +**unused3 (1 byte):** Undefined and MUST be ignored. + +**fontName (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) structure that specifies the name of this font. String length MUST be greater than or equal to 1 and less than or equal to 31. The **fontName.fHighByte** field MUST equal 1. MUST NOT contain any null characters. + +### FontX + +The **FontX** record specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) for a given text element. The [Font](#font) record referenced by **iFont** can exist in this [chart sheet](#Section_732ff614d939416bb7c76d983471ff11) substream or the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +[TABLE] + +**iFont (2 bytes):** An unsigned integer that specifies the font to use for subsequent records. This font can either be the default font of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), part of the collection of Font records following the [FrtFontList](#frtfontlist) record, or part of the collection of Font records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). If **iFont** is 0x0000, this record specifies the default font of the chart. If **iFont** is less than or equal to the number of Font records in the Globals Substream, **iFont** is a one-based index to a Font record in the Globals Substream. Otherwise **iFont** is a one-based index into the collection of Font records in this chart sheet substream where the index is equal to **iFont** – n, where n is the number of Font records in the Globals Substream. + +### Footer + +The **Footer** record specifies the footer text of the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) when printed. + +[TABLE] + +**ast (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the footer text for the current sheet. It is optional and exists only if the record size is not zero. The footer text appears at the bottom of every page when printed. The length of the text MUST be less than or equal to 255. The footer text can contain special commands, for example a placeholder for the page number, current date or text formatting attributes, as specified in the [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) grammar for special commands as specified in [Header](#header). + +### ForceFullCalculation + +The **ForceFullCalculation** record specifies the value of the forced [**calculation mode**](#gt_f02f81e1-8eda-4ec3-88e9-c2c483ff47ee) for this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader). The **frtHeader.rt** field MUST be 0x08A3. + +**fNoDeps (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether all cells in the workbook are calculated or not. MUST be one of the following: + +| Value | Meaning | +|----|----| +| 0 | Dependencies are respected and only formulas (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that depend on cells that changed in the workbook are calculated. | +| 1 | Dependencies are ignored and all [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) formulas in this workbook fully calculate every time a calculation is triggered. | + +### Format + +The **Format** record specifies a [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b). + +[TABLE] + +**ifmt (2 bytes):** An [IFmt](#ifmt) structure that specifies the identifier of the [**format string**](#gt_07085e26-506a-4b35-81ad-972464e277ff) specified by **stFormat**. The value of **ifmt.ifmt** SHOULD[\<91\>](#Appendix_A_91) be a value within one of the following ranges. The value of **ifmt.ifmt** MUST be a value within one of the following ranges or within 383 to 392. + +- 5 to 8 + +- 23 to 26 + +- 41 to 44 + +- 63 to 66 + +- 164 to 382 + +**stFormat (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the format string for this number format. The format string indicates how to format the numeric value of the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). The length of this field MUST be greater than or equal to 1 character and less than or equal to 255 characters. For more information about how format strings are interpreted, see [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1: Fundamentals And Markup Language Reference, section 18.8.31. + +For a string to be considered a valid format string, it MUST be well-formed according to the following [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) specification. + +**ABNF Grammar for number** format strings + +These definitions are for en-US [**locale**](#gt_7b78ebef-e35d-45ab-abfd-4121b60995de). International consideration as specified in \[ECMA-376\] Part 1: Fundamentals And Markup Language Reference, section 18.8.31 MUST be accounted for and the ABNF MUST be modified accordingly for specific international number formats. + +The following rules are not expressed in the ABNF grammar, but apply to the grammar: + +1. In the following ABNF specification, the following tokens in the first table that follows can occur 0 or more times anywhere in the grammar, as long as they do not break apart the elements in the second table that follows: + +| Token | +|---------------------| +| LITERAL-STRING | +| LITERAL-CHAR-REPEAT | +| LITERAL-CHAR-SPACE | + +| Elements | +|-------------------| +| INTL\* | +| LITERAL\* | +| NFDateTimeToken | +| NFPartExponential | +| NFPartCond | +| NFPartLocaleID | +| NFPartColor | +| NFPartIntNum | +| NFPartStrColor | + +| Elements | +|-------------------| +| INTL\* | +| LITERAL\* | +| NFDateTimeToken | +| NFPartExponential | +| NFPartCond | +| NFPartLocaleID | +| NFPartColor | +| NFPartIntNum | +| NFPartStrColor | + +2. The following token MUST occur 0 or 1 times in each section as defined in \[ECMA-376\] Part 1: Fundamentals And Markup Language Reference, section 18.8.31. + +NFPartLocaleID + +NFAbsTimeToken MUST occur 0 or 1 times in NFDateTime. + +An absolute time token, such as NFPartAbsHour, MUST NOT coexist with a non-absolute equivalent token, such as NFPartHour, in NFDateTime. + +Following is the ABNF grammar for number format strings. + +All = (\[NFPartColor\] NFPartCond NFGeneral) / NFAnyNoCond / (NFAnyNoText ASCII-SEMICOLON NFAny) / (NFAnyNoText ASCII-SEMICOLON NFAnyNoText ASCII-SEMICOLON NFAnyNoCond) / (NFAnyNoText ASCII-SEMICOLON NFAnyNoText ASCII-SEMICOLON NFAnyNoTextNoCond ASCII-SEMICOLON \[NFText / NFGeneral\]) + +NFAny = \[NFPartColor\] ((\[NFPartCond\] NFNumber) / NFText / (\[NFPartCond\] NFFraction) / (\[NFPartCond\] \[NFDateTime\] \[NFGeneral\] \[NFDateTime\])) + +NFAnyNoText = \[NFPartColor\] \[NFPartCond\] (NFNumber / NFFraction / (\[NFDateTime\] \[NFGeneral\] \[NFDateTime\])) + +NFAnyNoCond = \[NFPartColor\] (NFNumber / NFText / NFFraction / (\[NFDateTime\] \[NFGeneral\] \[NFDateTime\])) + +NFAnyNoTextNoCond = \[NFPartColor\] (NFNumber / NFFraction / (\[NFDateTime\] \[NFGeneral\] \[NFDateTime\])) + +NFGeneral = INTL-NUMFMT-GENERAL + +NFNumber = NFPartNum \[NFPartExponential NFPartNum\] \*INTL-CHAR-NUMGRP-SEP \*INTL-AMPM + +NFDateTimeToken = NFPartYear / NFPartMonth / NFPartDay / NFPartHour / NFPartMinute / NFPartSecond / NFAbsTimeToken + +NFAbsTimeToken = NFPartAbsHour / NFPartAbsSecond / NFPartAbsMinute + +NFDateTime = \*INTL-AMPM (1\*(NFDateTimeToken) \*(NFDateTimeToken / NFPartSubSecond / INTL-CHAR-DATE-SEP / INTL-CHAR-TIME-SEP / INTL-AMPM)) + +NFText = (1\*ASCII-COMMERCIAL-AT \*(ASCII-COMMERCIAL-AT / INTL-AMPM)) / (\*(ASCII-COMMERCIAL-AT / INTL-AMPM) 1\*ASCII-COMMERCIAL-AT) + +NFFraction = NFPartFraction ASCII-SOLIDUS NFPartFraction \[NFPartNum\] \*INTL-AMPM + +NFPartNum = 1\*NFPartNumToken2 \*(NFPartNumToken2 / ASCII-PERCENT-SIGN)) / (\*(NFPartNumToken2 / ASCII-PERCENT-SIGN) 1\*NFPartNumToken2) + +NFPartExponential = ASCII-CAPITAL-LETTER-E NFPartSign + +NFPartYear = 2(ASCII-SMALL-LETTER-Y) / 4(ASCII-SMALL-LETTER-Y) + +NFPartMonth = 1\*5(ASCII-SMALL-LETTER-M) + +NFPartDay = 1\*4(ASCII-SMALL-LETTER-D) + +NFPartHour = 1\*2(ASCII-SMALL-LETTER-H) + +NFPartAbsHour = ASCII-LEFT-SQUARE-BRACKET 1\*ASCII-SMALL-LETTER-H ASCII-RIGHT-SQUARE-BRACKET + +NFPartMinute = 1\*2(ASCII-SMALL-LETTER-M) + +NFPartAbsMinute = ASCII-LEFT-SQUARE-BRACKET 1\*ASCII-SMALL-LETTER-M ASCII-RIGHT-SQUARE-BRACKET + +NFPartSecond = 1\*2(ASCII-SMALL-LETTER-S) + +NFPartAbsSecond = ASCII-LEFT-SQUARE-BRACKET 1\*ASCII-SMALL-LETTER-S ASCII-RIGHT-SQUARE-BRACKET + +NFPartSubSecond = INTL-CHAR-DECIMAL-SEP 1\*3ASCII-DIGIT-ZERO + +NFPartCond = ASCII-LEFT-SQUARE-BRACKET NFPartCompOper NFPartCondNum ASCII-RIGHT-SQUARE-BRACKET + +NFPartCompOper = (ASCII-LESS-THAN-SIGN \[ASCII-EQUALS-SIGN / ASCII-GREATER-THAN-SIGN\]) / ASCII-EQUALS-SIGN / (ASCII-GREATER-THAN-SIGN \[ASCII-EQUALS-SIGN\]) + +NFPartLocaleID = ASCII-LEFT-SQUARE-BRACKET ASCII-DOLLAR-SIGN 1\*UTF16-ANY \[ASCII-HYPHEN-MINUS 3\*8ASCII-DIGIT-HEXADECIMAL\] ASCII-RIGHT-SQUARE-BRACKET + +NFPartCondNum = \[ASCII-HYPHEN-MINUS\] NFPartIntNum \[INTL-CHAR-DECIMAL-SEP NFPartIntNum\] \[NFPartExponential NFPartIntNum\] + +NFPartSign = ASCII-PLUS-SIGN / ASCII-HYPHEN-MINUS + +NFPartColor = ASCII-LEFT-SQUARE-BRACKET INTL-COLOR / (NFPartStrColor NFPart1To56) ASCII-RIGHT-SQUARE-BRACKET + +NFPart1To56 = NFPartNumber1To9 / NFPartNumber1To4 ASCII-DIGIT / ASCII-DIGIT-FIVE (ASCII-DIGIT-ZERO / NFPartNumber1To6) + +NFPartIntNum = 1\*ASCII-DIGIT + +NFPartNumToken1 = ASCII-NUMBER-SIGN / ASCII-QUESTION-MARK / ASCII-DIGIT-ZERO + +NFPartNumToken2 = NFPartNumToken1 / INTL-CHAR-DECIMAL-SEP / INTL-CHAR-NUMGRP-SEP + +NFPartFraction = (1\*NFPartIntNum \*(NFPartIntNum / ASCII-PERCENT-SIGN)) / (\*(NFPartIntNum / ASCII-PERCENT-SIGN) 1\*NFPartIntNum) / (1\*NFPartNumToken1 \*(NFPartNumToken1 / ASCII-PERCENT-SIGN)) / (\*(NFPartNumToken1 / ASCII-PERCENT-SIGN) 1\*NFPartNumToken1) + +NFPartNumber1To4 = ASCII-DIGIT-ONE / ASCII-DIGIT-TWO / ASCII-DIGIT-THREE / ASCII-DIGIT-FOUR + +NFPartNumber1To6 = NFPartNumber1To4 / ASCII-DIGIT-FIVE / ASCII-DIGIT-SIX + +NFPartNumber1To9 = NFPartNumber1To6 / ASCII-DIGIT-SEVEN / ASCII-DIGIT-EIGHT / ASCII-DIGIT-NINE + +NFPartStrColor = ASCII-CAPITAL-LETTER-C ASCII-SMALL-LETTER-O ASCII-SMALL-LETTER-L ASCII-SMALL-LETTER-O ASCII-SMALL-LETTER-R + +LITERAL-CHAR = ASCII-REVERSE-SOLIDUS UTF16-ANY + +LITERAL-CHAR-REPEAT = ASCII-ASTERISK UTF16-ANY + +LITERAL-STRING = (ASCII-QUOTATION-MARK 1\*UTF16-ANY-WITHOUT-QUOTE ASCII-QUOTATION-MARK) / 1\*LITERAL-CHAR + +UTF16-ANY-WITHOUT-QUOTE = %x0000-0021 / %x0023-FFFF + +LITERAL-CHAR-SPACE = ASCII-LOW-LINE UTF16-ANY + +INTL-CHAR-DECIMAL-SEP = ASCII-FULL-STOP + +INTL-CHAR-NUMGRP-SEP = ASCII-COMMA + +INTL-CHAR-DATE-SEP = ASCII-SOLIDUS + +INTL-CHAR-TIME-SEP = ASCII-COLON + +INTL-COLOR = (ASCII-CAPITAL-LETTER-B ASCII-SMALL-LETTER-L ASCII-SMALL-LETTER-A ASCII-SMALL-LETTER-C ASCII-SMALL-LETTER-K) / (ASCII-CAPITAL-LETTER-B ASCII-SMALL-LETTER-L ASCII-SMALL-LETTER-U ASCII-SMALL-LETTER-E) / (ASCII-CAPITAL-LETTER-C ASCII-SMALL-LETTER-Y ASCII-SMALL-LETTER-A ASCII-SMALL-LETTER-N) / (ASCII-CAPITAL-LETTER-G ASCII-SMALL-LETTER-R ASCII-SMALL-LETTER-E ASCII-SMALL-LETTER-E ASCII-SMALL-LETTER-N) / (ASCII-CAPITAL-LETTER-M ASCII-SMALL-LETTER-A ASCII-SMALL-LETTER-G ASCII-SMALL-LETTER-E ASCII-SMALL-LETTER-N ASCII-SMALL-LETTER-T ASCII-SMALL-LETTER-A) / (ASCII-CAPITAL-LETTER-R ASCII-SMALL-LETTER-E ASCII-SMALL-LETTER-D ) / (ASCII-CAPITAL-LETTER-W ASCII-SMALL-LETTER-H ASCII-SMALL-LETTER-I ASCII-SMALL-LETTER-T ASCII-SMALL-LETTER-E) / (ASCII-CAPITAL-LETTER-Y ASCII-SMALL-LETTER-E ASCII-SMALL-LETTER-L ASCII-SMALL-LETTER-L ASCII-SMALL-LETTER-O ASCII-SMALL-LETTER-W) + +INTL-NUMFMT-GENERAL = ASCII-CAPITAL-LETTER-G ASCII-SMALL-LETTER-E ASCII-SMALL-LETTER-N ASCII-SMALL-LETTER-E ASCII-SMALL-LETTER-R ASCII-SMALL-LETTER-A ASCII-SMALL-LETTER-L + +INTL-AMPM = (ASCII-CAPITAL-LETTER-A ASCII-CAPITAL-LETTER-M ASCII-SOLIDUS ASCII-CAPITAL-LETTER-P ASCII-CAPITAL-LETTER-M) / "A/P" + +UTF16-ANY = %x0000-FFFF + +ASCII-SPACE = %x20 + +ASCII-EXCLAMATION-MARK = %x21 + +ASCII-QUOTATION-MARK = %x22 + +ASCII-NUMBER-SIGN = %x23 + +ASCII-DOLLAR-SIGN = %x24 + +ASCII-PERCENT-SIGN = %x25 + +ASCII-AMPERSAND = %x26 + +ASCII-APOSTROPHE = %x27 + +ASCII-LEFT-PARENTHESIS = %x28 + +ASCII-RIGHT-PARENTHESIS = %x29 + +ASCII-ASTERISK = %x2A + +ASCII-PLUS-SIGN = %x2B + +ASCII-COMMA = %x2C + +ASCII-HYPHEN-MINUS = %x2D + +ASCII-FULL-STOP = %x2E + +ASCII-SOLIDUS = %x2F + +ASCII-DIGIT-ZERO = %x30 + +ASCII-DIGIT-ONE = %x31 + +ASCII-DIGIT-TWO = %x32 + +ASCII-DIGIT-THREE = %x33 + +ASCII-DIGIT-FOUR = %x34 + +ASCII-DIGIT-FIVE = %x35 + +ASCII-DIGIT-SIX = %x36 + +ASCII-DIGIT-SEVEN = %x37 + +ASCII-DIGIT-EIGHT = %x38 + +ASCII-DIGIT-NINE = %x39 + +ASCII-COLON = %x3A + +ASCII-SEMICOLON = %x3B + +ASCII-LESS-THAN-SIGN = %x3C + +ASCII-EQUALS-SIGN = %x3D + +ASCII-GREATER-THAN-SIGN = %x3E + +ASCII-QUESTION-MARK = %x3F + +ASCII-COMMERCIAL-AT = %x40 + +ASCII-CAPITAL-LETTER-A = %x41 + +ASCII-CAPITAL-LETTER-B = %x42 + +ASCII-CAPITAL-LETTER-C = %x43 + +ASCII-CAPITAL-LETTER-D = %x44 + +ASCII-CAPITAL-LETTER-E = %x45 + +ASCII-CAPITAL-LETTER-F = %x46 + +ASCII-CAPITAL-LETTER-G = %x47 + +ASCII-CAPITAL-LETTER-H = %x48 + +ASCII-CAPITAL-LETTER-I = %x49 + +ASCII-CAPITAL-LETTER-J = %x4A + +ASCII-CAPITAL-LETTER-K = %x4B + +ASCII-CAPITAL-LETTER-L = %x4C + +ASCII-CAPITAL-LETTER-M = %x4D + +ASCII-CAPITAL-LETTER-N = %x4E + +ASCII-CAPITAL-LETTER-O = %x4F + +ASCII-CAPITAL-LETTER-P = %x50 + +ASCII-CAPITAL-LETTER-Q = %x51 + +ASCII-CAPITAL-LETTER-R = %x52 + +ASCII-CAPITAL-LETTER-S = %x53 + +ASCII-CAPITAL-LETTER-T = %x54 + +ASCII-CAPITAL-LETTER-U = %x55 + +ASCII-CAPITAL-LETTER-V = %x56 + +ASCII-CAPITAL-LETTER-W = %x57 + +ASCII-CAPITAL-LETTER-X = %x58 + +ASCII-CAPITAL-LETTER-Y = %x59 + +ASCII-CAPITAL-LETTER-Z = %x5A + +ASCII-LEFT-SQUARE-BRACKET = %x5B + +ASCII-REVERSE-SOLIDUS = %x5C + +ASCII-RIGHT-SQUARE-BRACKET = %x5D + +ASCII-CIRCUMFLEX-ACCENT = %x5E + +ASCII-LOW-LINE = %x5F + +ASCII-GRAVE-ACCENT = %x60 + +ASCII-SMALL-LETTER-A = %x61 + +ASCII-SMALL-LETTER-B = %x62 + +ASCII-SMALL-LETTER-C = %x63 + +ASCII-SMALL-LETTER-D = %x64 + +ASCII-SMALL-LETTER-E = %x65 + +ASCII-SMALL-LETTER-F = %x66 + +ASCII-SMALL-LETTER-G = %x67 + +ASCII-SMALL-LETTER-H = %x68 + +ASCII-SMALL-LETTER-I = %x69 + +ASCII-SMALL-LETTER-J = %x6A + +ASCII-SMALL-LETTER-K = %x6B + +ASCII-SMALL-LETTER-L = %x6C + +ASCII-SMALL-LETTER-M = %x6D + +ASCII-SMALL-LETTER-N = %x6E + +ASCII-SMALL-LETTER-O = %x6F + +ASCII-SMALL-LETTER-P = %x70 + +ASCII-SMALL-LETTER-Q = %x71 + +ASCII-SMALL-LETTER-R = %x72 + +ASCII-SMALL-LETTER-S = %x73 + +ASCII-SMALL-LETTER-T = %x74 + +ASCII-SMALL-LETTER-U = %x75 + +ASCII-SMALL-LETTER-V = %x76 + +ASCII-SMALL-LETTER-W = %x77 + +ASCII-SMALL-LETTER-X = %x78 + +ASCII-SMALL-LETTER-Y = %x79 + +ASCII-SMALL-LETTER-Z = %x7A + +ASCII-LEFT-CURLY-BRACKET = %x7B + +ASCII-VERTICAL-LINE = %x7C + +ASCII-RIGHT-CURLY-BRACKET = %x7D + +ASCII-TILDE = %x7E + +ASCII-DELETE = %x7F + +ASCII-CRLF = %x0d.0a + +ASCII-DIGIT = ASCII-DIGIT-ZERO / ASCII-DIGIT-ONE / ASCII-DIGIT-TWO / ASCII-DIGIT-THREE / ASCII-DIGIT-FOUR / ASCII-DIGIT-FIVE / ASCII-DIGIT-SIX / ASCII-DIGIT-SEVEN / ASCII-DIGIT-EIGHT / ASCII-DIGIT-NINE + +ASCII-DIGIT-HEXADECIMAL = ASCII-DIGIT / ASCII-SMALL-LETTER-A / ASCII-SMALL-LETTER-B / ASCII-SMALL-LETTER-C / ASCII-SMALL-LETTER-D / ASCII-SMALL-LETTER-E / ASCII-SMALL-LETTER-F / ASCII-CAPITAL-LETTER-A / ASCII-CAPITAL-LETTER-B / ASCII-CAPITAL-LETTER-C / ASCII-CAPITAL-LETTER-D / ASCII-CAPITAL-LETTER-E / ASCII-CAPITAL-LETTER-F + +### Formula + +The **Formula** record specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +[TABLE] + +**cell (6 bytes):** A [Cell](#cell) structure that specifies a cell on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**val (8 bytes):** A [FormulaValue](#formulavalue) structure that specifies the value of the formula. + +**A - fAlwaysCalc (1 bit):** A bit that specifies whether the formula needs to be calculated during the next recalculation. + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fFill (1 bit):** A bit that specifies whether the cell has a [**fill alignment**](#gt_cfc4e171-6104-470e-9ebb-812afea17078) or a [**center-across-selection alignment**](#gt_ef7324bd-dac8-46e2-8df5-db44d8b925a8). + +| Value | Meaning | +|----|----| +| 0 | Cell does not have a fill alignment or a center-across-selection alignment. | +| 1 | Cell has either a fill alignment or a center-across-selection alignment. | + +**D - fShrFmla (1 bit):** A bit that specifies whether the formula is part of a shared formula as defined in [ShrFmla](#shrfmla). If this formula is part of a shared formula, **formula**.**rgce** MUST begin with a [PtgExp](#ptgexp) structure. + +**E - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**F - fClearErrors (1 bit):** A bit that specifies whether the formula is excluded from [**formula error checking**](#gt_c28d38d6-c6d1-4d06-89c2-29816f9c5b23). + +**reserved3 (10 bits):** MUST be zero, and MUST be ignored. + +**chn (4 bytes):** A field that specifies an application-specific cache of information. This cache exists for performance reasons only, and can be rebuilt based on information stored elsewhere in the file without affecting calculation results. + +**formula (variable):** A [CellParsedFormula](#cellparsedformula) structure that specifies the formula. + +### Frame + +The **Frame** record specifies the type, size and position of the frame around a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) element as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). A chart element’s frame is specified by the Frame record following it. + +[TABLE] + +**frt (2 bytes):** An unsigned integer that specifies the type of frame to be drawn. MUST be a value from the following table: + +| Value | Frame Type | +|--------|------------------------------------------------------| +| 0x0000 | A frame surrounding the chart element. | +| 0x0004 | A frame with a shadow surrounding the chart element. | + +**A - fAutoSize (1 bit):** A bit that specifies if the size of the frame is automatically calculated. If the value is 1, the size of the frame is automatically calculated. In this case, the width and height specified by the chart element are ignored and the size of the frame is calculated automatically. If the value is 0, the width and height specified by the chart element are used as the size of the frame. + +**B - fAutoPosition (1 bit):** A bit that specifies if the position of the frame is automatically calculated. If the value is 1, the position of the frame is automatically calculated. In this case, the (x, y) specified by the chart element are ignored, and the position of the frame is automatically calculated. If the value is 0, the (x, y) location specified by the chart element are used as the position of the frame. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +### FrtFontList + +The **FrtFontList** record specifies [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information used on the chart and specifies the beginning of a collection of [Font](#font) records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x085A. + +**verExcel (1 byte):** An unsigned integer that specifies the application version where new [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) elements were introduced that use the font information specified by **rgFontInfo**. MUST be a value from the following table and MUST be equal to iObjectInstance1 of the [StartObject](#startobject) record that immediately follows this record as defined by the Chart Sheet Substream ABNF: + +| Value | Meaning | +|----|----| +| 0x09 | This record pertains to new objects introduced in an application version[\<92\>](#Appendix_A_92). **rgFontInfo** specifies the font information that is used by [**display units**](#gt_7d807b62-cff1-4e03-a73f-840844345b83) labels specified by [YMult](#ymult). | +| 0x0A | This record pertains to new objects introduced in an application version[\<93\>](#Appendix_A_93). **rgFontInfo** specifies the font information that is used by extended [data label](#Section_cac7f43a3af142f58ff2814c2870427f) specified by [DataLabExt](#datalabext). | + +**reserved (1 byte):** MUST be zero, and MUST be ignored. + +**cFont (2 bytes):** An unsigned integer that specifies the number of items in **rgFontInfo**. + +**rgFontInfo (variable):** An array of [FontInfo](#fontinfo) structures that specify the font information. The number of elements in this array MUST be equal to the value specified in **cFont**. + +### FrtWrapper + +The **FrtWrapper** record wraps around a non-Future Record Type ([FRT](#Section_b660b67822684414839ed1ae9a4e4e85)) record and converts it into an FRT record. + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** MUST be 0x0851. + +**wrappedRecord (variable):** A [Font](#font), [Continue](#continue), [LineFormat](#lineformat), [AreaFormat](#areaformat), [SeriesText](#seriestext), [DefaultText](#defaulttext), [Text](#text), [FontX](#fontx), [ObjectLink](#objectlink), [Frame](#frame), [Begin](#begin), [End](#end), [PicF](#picf), [Pos](#pos), [AlRuns](#alruns), [BRAI](#brai), [Fbi](#fbi), or [GelFrame](#gelframe) that specifies the record being wrapped. These records MUST be wrapped in this FrtWrapper if they are part of a collection defined by [StartObject](#startobject) and [EndObject](#endobject). These records appear according to their record name and not as FrtWrapper in the [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) specified in [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11). + +**frtWrapperPadding (variable):** An array of bytes that is used to pad **FrtWrapper**. Each element MUST be zero and MUST be ignored. This field MUST be present if and only if the size of the **wrappedRecord** is less than 8 bytes. If present, the size of **frtWrapperPadding** MUST be specified by the following formula: + +8 bytes – (size of **wrappedRecord**) + +The size of the padded **FrtWrapper** MUST be no less than the size of the [FrtHeader](#frtheader) structure (12 bytes). + +### GelFrame + +The **GelFrame** record specifies the properties of a [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e) for parts of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). The record consists of an OfficeArtFOPT, as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.2.9, and an OfficeArtTertiaryFOPT, as specified in \[MS-ODRAW\] section 2.2.11, that both contain properties for the fill pattern applied.[\<94\>](#Appendix_A_94) + +[TABLE] + +**OPT1 (variable):** An OfficeArtFOPT, as specified in \[MS-ODRAW\] section 2.2.9, specifies the primary properties of the fill pattern. MUST only contain the subset of OfficeArtFOPT properties specified in the following list: + +- fillType, as specified in \[MS-ODRAW\] section 2.3.7.1 + +- fillColor, as specified in \[MS-ODRAW\] section 2.3.7.2 + +- fillOpacity, as specified in \[MS-ODRAW\] section 2.3.7.3 + +- fillBackColor, as specified in \[MS-ODRAW\] section 2.3.7.4 + +- fillBackOpacity, as specified in \[MS-ODRAW\] section 2.3.7.5 + +- fillCrMod, as specified in \[MS-ODRAW\] section 2.3.7.6 + +- fillBlip_complex, as specified in \[MS-ODRAW\] section 2.3.7.8 + +- fillBlipName_complex, as specified in \[MS-ODRAW\] section 2.3.7.10 + +- fillBlipFlags, as specified in \[MS-ODRAW\] section 2.3.7.11 + +- fillWidth, as specified in \[MS-ODRAW\] section 2.3.7.12 + +- fillHeight, as specified in \[MS-ODRAW\] section 2.3.7.13 + +- fillAngle, as specified in \[MS-ODRAW\] section 2.3.7.14 + +- fillFocus, as specified in \[MS-ODRAW\] section 2.3.7.15 + +- fillToLeft, as specified in \[MS-ODRAW\] section 2.3.7.16 + +- fillToTop, as specified in \[MS-ODRAW\] section 2.3.7.17 + +- fillToRight, as specified in \[MS-ODRAW\] section 2.3.7.18 + +- fillToBottom, as specified in \[MS-ODRAW\] section 2.3.7.19 + +- fillRectLeft, as specified in \[MS-ODRAW\] section 2.3.7.20 + +- fillRectTop, as specified in \[MS-ODRAW\] section 2.3.7.21 + +- fillRectRight, as specified in \[MS-ODRAW\] section 2.3.7.22 + +- fillRectBottom, as specified in \[MS-ODRAW\] section 2.3.7.23 + +- fillDztype, as specified in \[MS-ODRAW\] section 2.3.7.24 + +- fillShadePreset, as specified in \[MS-ODRAW\] section 2.3.7.25 + +- fillShadeColors_complex, as specified in \[MS-ODRAW\] section 2.3.7.27 + +- fillOriginX, as specified in \[MS-ODRAW\] section 2.3.7.28 + +- fillOriginY, as specified in \[MS-ODRAW\] section 2.3.7.29 + +- fillShapeOriginX, as specified in \[MS-ODRAW\] section 2.3.7.30 + +- fillShapeOriginY, as specified in \[MS-ODRAW\] section 2.3.7.31 + +- fillShadeType, as specified in \[MS-ODRAW\] section 2.3.7.32 + +- fFilled, as specified in \[MS-ODRAW\] section 2.3.7.43 + +- fHitTestFill, as specified in \[MS-ODRAW\] section 2.3.7.43 + +- fillShape, as specified in \[MS-ODRAW\] section 2.3.7.43 + +- fillUseRect, as specified in \[MS-ODRAW\] section 2.3.7.43 + +- fNoFillHitTest, as specified in \[MS-ODRAW\] section 2.3.7.43 + +**OPT2 (variable):** An OfficeArtTertiaryFOPT, as specified in \[MS-ODRAW\] section 2.2.11 specifies the additional properties of the fill pattern. MUST only contain the subset of OfficeArtTertiaryFOPT properties specified in the following list[\<95\>](#Appendix_A_95): + +- fillColorExt, as specified in \[MS-ODRAW\] section 2.3.7.33 + +- fillColorExtMod, as specified in \[MS-ODRAW\] section 2.3.7.35 + +- fillBackColorExt, as specified in \[MS-ODRAW\] section 2.3.7.37 + +- fillBackColorExtMod, as specified in \[MS-ODRAW\] section 2.3.7.39 + +- fRecolorFillAsPicture, as specified in \[MS-ODRAW\] section 2.3.7.43 + +- fUseShapeAnchor, as specified in \[MS-ODRAW\] section 2.3.7.43 + +### GridSet + +The **GridSet** record specifies a reserved value. + +[TABLE] + +**gridset (2 bytes):** Reserved, and MUST be 1. + +### GUIDTypeLib + +The **GUIDTypeLib** record specifies the [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that uniquely identifies the [**type library**](#gt_c7033bd7-d429-4131-8bc4-f5007b7ef3fa) of the application that wrote the [**Visual Basic for Applications (VBA)**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) project in the file. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0897. + +**guid (16 bytes):** A GUID as specified by \[MS-DTYP\] that uniquely identifies the type library of the application that wrote the VBA project. The value SHOULD[\<96\>](#Appendix_A_96) be 0x0. + +### Guts + +The **Guts** record specifies the maximum [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) levels for row and column [**gutters**](#gt_d38255f8-dca6-4e1c-be9d-71691a6ab4e5). + +[TABLE] + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**iLevelRwMac (2 bytes):** An unsigned integer that specifies the maximum [**outline level**](#gt_a5cd5eff-ddeb-490b-bc71-f6256774e3c3) for the row gutter. The value MUST be one of the values specified in the following table. + +**iLevelColMac (2 bytes):** An unsigned integer that specifies the maximum outline level for the column gutter. The value MUST be one of the values specified in the following table. + +| Value | Maximum outline level | +|--------|-----------------------| +| 0x0000 | 0 | +| 0x0002 | 1 | +| 0x0003 | 2 | +| 0x0004 | 3 | +| 0x0005 | 4 | +| 0x0006 | 5 | +| 0x0007 | 6 | +| 0x0008 | 7 | + +### HCenter + +The **HCenter** record specifies whether the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) is to be centered horizontally when printed. + +[TABLE] + +**hcenter (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the sheet is to be centered between [LeftMargin](#leftmargin) and [RightMargin](#rightmargin) when printed. + +### Header + +The **Header** record specifies the header text of the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) when printed. + +[TABLE] + +**ast (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the header text for the current sheet. It is optional and exists only if the record size is not zero. The text appears at the top of every page when printed. The length of the text MUST be less than or equal to 255. The header text can contain special commands, for example a [**placeholder**](#gt_25caffec-4e4b-4192-a04d-edcd14f0ec5f) for the page number, current date or text formatting attributes. Special commands are represented by single letter with a leading ampersand ("&"). The following [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) lists the possible commands and how they are used: + +**ABNF Grammar for Header and Footer Strings** + +headerfooter = \*(left / pagenum / pagetotal / fontsize / strikethrough / superscript / subscript / center / date / time / filepath / picture / underline / doubleunderline / right / bookpath / sheetname / fontname / fonttype / font / bold / italic / ampersand / emptytoken / UNICHAR) + +UNICHAR = %x0020-FFFF + +> This code specifies [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters, starting with the space character (%x0020). + +DIGIT = %x0030-0039 + +> This code specifies a digit between 0 and 9. + +HEXALPHA = %x0041-0046 / %x0061-0066 + +> This code specifies a character between A and F or between a and f. + +DQUOTE = %x0022 + +> This code specifies a double quotation mark. + +left = "&L" + +> This code specifies the beginning of the left section. There are three header and footer sections: left, center, and right. When two or more of this section marker exist, the contents from all markers are concatenated, in the order of appearance, and placed into the left section. + +pagenum = "&P" + +> This code specifies the current page number. + +pagetotal = "&N" 0\*1(("-" / "+") \*DIGIT) + +> This code specifies the total number of pages. + +fontsize = "&" 1\*3DIGIT + +> This code specifies the text [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) size, where font size is measured in points. + +strikethrough = "&S" + +> This code specifies whether the strikethrough [**text style**](#gt_7df49f57-34f0-4063-9c66-8e32767d9562) is on or off. The first occurrence of this code MUST turn the strikethrough text style on, and the second occurrence MUST turn it off. + +superscript = "&X" + +> This code specifies whether the superscript text style is on or off. The first occurrence of this code MUST turn the superscript text style on, and the second occurrence MUST turn it off. The superscript and subscript codes MUST NOT both be on at same time. If both codes occur in the string, the code that occurs first is applied and the other is ignored. + +subscript = "&Y" + +> This code specifies whether the subscript text style is on or off. The first occurrence of this code MUST turn the subscript text style on, and the second occurrence MUST turn it off. The superscript and subscript codes MUST NOT both be on at same time. If both codes occur in the string, the code that occurs first is applied and the other is ignored. + +center = "&C" + +> This code specifies the beginning of the center section. When two or more of this section marker exist, the contents from all markers are concatenated, in the order of appearance, and placed into the center section. + +date = "&D" + +> This code specifies a date. + +time = "&T" + +> This code specifies a time. + +picture = "&G" + +> This code specifies a picture. + +underline = "&U" + +> This code specifies whether the single underline text style is on or off. The first occurrence of this code MUST turn the underline text style on, and the second occurrence MUST turn it off. + +doubleunderline = "&E" + +> This code specifies whether the double underline text style is on or off. The first occurrence of this code MUST turn the double underline text style on, and the second occurrence MUST turn it off. + +right = "&R" + +> This code specifies the beginning of the right section. When two or more of this section marker exist, the contents from all markers are concatenated, in the order of appearance, and placed into the right section. + +bookpath = "&Z" + +> This code specifies a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) file path. + +bookname = "&F" + +> This code specifies a workbook file name. + +sheetname = "&A" + +> This code specifies a sheet name. + +fontname = (1\*UNICHAR / "-") + +> This code specifies the text font name. When the font name is a hyphen, no font is specified. This can be a localized string. + +fonttype = ("italic" / "bold" / "regular" / "italic bold" / "bold italic") + +> This code specifies the text font type. This can be a localized string. + +font = "&" DQUOTE fontname , fonttype DQUOTE + +> This code specifies the text font. + +bold = "&B" + +> This code specifies whether the bold text style is on or off. The first occurrence of this code MUST turn the bold text style on, and the second occurrence MUST turn it off. + +italic = "&I" + +> This code specifies whether the italic text style is on or off. The first occurrence of this code MUST turn the italic text style on, and the second occurrence MUST turn it off. + +ampersand = "&&" + +> This code specifies an ampersand character. + +emptytoken = "&" \*1UNICHAR + +> This code specifies an unidentified token. If just "&" appears, or if there is a UNICHAR specified after "&" and it is not one of the UNICHAR characters listed in the preceding rules, then the token is interpreted as empty and nothing is rendered in the header or footer text. + +### HeaderFooter + +The **HeaderFooter** record specifies the even page header and footer text, and the first page header and footer text of the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x089C. + +**guidSView (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that specifies the current [**sheet view**](#gt_353fb2f1-8556-4d04-8fa8-f38da52d7ecc). If it is zero it means the current sheet. Otherwise, this field MUST match the **guid** field of the preceding [UserSViewBegin](#usersviewbegin) record. + +**A - fHFDiffOddEven (1 bit):** A bit that specifies whether the odd and even pages use a different header and footer. If the value is 1, the [Header](#header) and [Footer](#footer) records specify the odd page header and footer, and **strHeaderEven** and **strFooterEven** specify the even page header and footer. + +**B - fHFDiffFirst (1 bit):** A bit that specifies whether the first page uses a different header and footer from the rest of the pages. If the value is 1, the Header and Footer records specify the header and footer of the rest of the pages, and **strHeaderFirst** and **strFooterFirst** specify the first page header and footer. + +**C - fHFScaleWithDoc (1 bit):** A bit that specifies whether the header and footer is scaled with the sheet. + +**D - fHFAlignMargins (1 bit):** A bit that specifies whether the left and right edges of the header and footer are lined up with the left and right margins of the sheet. + +**unused (12 bits):** Undefined, and MUST be ignored. + +**cchHeaderEven (2 bytes):** An unsigned integer that specifies the number of characters in **strHeaderEven**. MUST be less than or equal to 255. The value MUST be zero if **fHFDiffOddEven** is zero. + +**cchFooterEven (2 bytes):** An unsigned integer that specifies the number of characters in **strFooterEven**. MUST be less than or equal to 255. The value MUST be zero if **fHFDiffOddEven** is zero. + +**cchHeaderFirst (2 bytes):** An unsigned integer that specifies the number of characters in **strHeaderFirst**. MUST be less than or equal to 255. The value MUST be zero if **fHFDiffFirst** is zero. + +**cchFooterFirst (2 bytes):** An unsigned integer that specifies the number of characters in **strFooterFirst**. MUST be less than or equal to 255. The value MUST be zero if **fHFDiffFirst** is zero. + +**strHeaderEven (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the header text on the even pages. The number of characters in the string MUST be equal to **cchHeaderEven**. The string can contain special commands, for example a [**placeholder**](#gt_25caffec-4e4b-4192-a04d-edcd14f0ec5f) for the page number, current date or text formatting attributes. Refer to Header for more details about the string format. + +**strFooterEven (variable):** An XLUnicodeString structure that specifies the footer text on the even pages. The number of characters in the string MUST be equal to **cchFooterEven**. The string can contain special commands, for example a placeholder for the page number, current date or text formatting attributes. Refer to Header for more details about the string format. + +**strHeaderFirst (variable):** An XLUnicodeString structure that specifies the header text on the first page. The number of characters in the string MUST be equal to **cchHeaderFirst**. The string can contain special commands, for example a placeholder for the page number, current date or text formatting attributes. Refer to Header for more details about the string format. + +**strFooterFirst (variable):** An XLUnicodeString structure that specifies the footer text on the first page. The number of characters in the string MUST be equal to **cchFooterFirst**. The string can contain special commands, for example a placeholder for the page number, current date or text formatting attributes. Refer to Header for more details about the string format. + +### HFPicture + +The **HFPicture** record specifies a picture used by a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) header or footer. The picture MUST be specified in either an **OfficeArtDgContainer** or **OfficeArtDggContainer** record as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872). The picture can be continued across multiple HFPicture records. The **OfficeArtClientAnchor** structure mentioned in \[MS-ODRAW\] refers to [OfficeArtClientAnchorHF](#officeartclientanchorhf). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0866. + +**A - fIsDrawing (1 bit):** A bit that specifies whether **rgDrawing** is an **OfficeArtDgContainer** record as specified in \[MS-ODRAW\]. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | **rgDrawing** is an **OfficeArtDggContainer** record as specified in \[MS-ODRAW\] and **fIsDrawingGroup** MUST be 1. | +| 1 | **rgDrawing** is an **OfficeArtDgContainer** record as specified in \[MS-ODRAW\] and **fIsDrawingGroup** MUST be 0. | + +**B - fIsDrawingGroup (1 bit):** A bit that specifies whether **rgDrawing** is an **OfficeArtDggContainer** record as specified in \[MS-ODRAW\]. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | **rgDrawing** is an **OfficeArtDgContainer** record as specified in \[MS-ODRAW\] and **fIsDrawing** MUST be 1. | +| 1 | **rgDrawing** is an **OfficeArtDggContainer** record as specified in \[MS-ODRAW\] and **fIsDrawing** MUST be 0. | + +**C - fContinue (1 bit):** A bit that specifies whether this record is continuing the previous HFPicture record. The value 0 means it is the first HFPicture record. + +**unused (5 bits):** Undefined and MUST be ignored. + +**reserved (1 byte):** MUST be zero, and MUST be ignored. + +**rgDrawing (variable):** The meaning of this field is specified in the following table. + +| Value of fIsDrawing | Meaning of rgDrawing | +|----|----| +| 0 | This is an **OfficeArtDggContainer** as specified in \[MS-ODRAW\] that specifies the [**drawing group**](#gt_329c715f-dc26-4866-a759-0d622aa92e92) of this picture. | +| 1 | This is an **OfficeArtDgContainer** as specified in \[MS-ODRAW\] that specifies the [**drawing object**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) of this picture | + +### HideObj + +The **HideObj** record specifies how [**ActiveX objects**](#gt_0d95e494-61b2-43bc-8818-51aa162d2018), [**OLE objects**](#gt_cdff9514-a3fb-4897-941d-4e99193a0096), and [**drawing objects**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) appear in a window that contains the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +[TABLE] + +**hideObj (2 bytes):** A [**HideObjEnum**](#hideobjenum) enumeration that specifies how ActiveX objects, OLE objects, and drawing objects appear in a window that contains the workbook. + +### HLink + +The **HLink** record specifies a [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) associated with a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +[TABLE] + +**ref8 (8 bytes):** A [Ref8U](#ref8u) structure that specifies the range of cells containing the hyperlink. + +**hlinkClsid (16 bytes):** A [**class identifier (CLSID)**](#gt_e433c806-6cb6-46a2-bb95-523df8818c99) that specifies the [**COM**](#gt_ef2ebebc-1760-407a-9ace-af48f9050e02) component which saved the Hyperlink Object (as defined by [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.7.1) in **hyperlink**. + +**hyperlink (variable):** A Hyperlink Object (as defined by \[MS-OSHARED\] section 2.3.7.1) that specifies the hyperlink and hyperlink-related information. + +### HLinkTooltip + +The **HLinkTooltip** record specifies the [**hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) [**ToolTip**](#gt_84d44447-feaf-41a4-bf12-004c0f080fc2) associated with a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells. + +[TABLE] + +**frtRefHeaderNoGrbit (10 bytes):** An [FrtRefHeaderNoGrbit](#frtrefheadernogrbit) structure. The **frtRefHeaderNoGrbit.rt** field MUST be 0x0800. The **frtRefHeaderNoGrbit.ref8** field MUST match a [Ref8U](#ref8u) field from an existing [HLink](#hlink) record. + +**wzTooltip (variable):** An array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters that specifies the ToolTip string. String length MUST be greater than or equal to 2 and less than or equal to 256 (inclusive of null terminator) and the string MUST be null-terminated. + +### HorizontalPageBreaks + +The **HorizontalPageBreaks** record specifies a list of explicit row [**page breaks**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871). + +[TABLE] + +**cbrk (2 bytes):** An unsigned integer that specifies the number of page breaks. The value MUST be less than or equal to 1026. + +**rgbrk (variable):** An array of [**HorzBrk**](#horzbrk) structure that specifies all of the page breaks. The array MUST be sorted first by **rgbrk.row**, and then by **rgbrk.ColStart.** Two page breaks MUST NOT overlap. The number of **HorzBrk** structures MUST equal the value of **cbrk**. + +### IFmtRecord + +The **IFmtRecord** record specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) to use for the text on an [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). + +[TABLE] + +**ifmt (2 bytes):** An [IFmt](#ifmt) structure that specifies the number format identifier. + +### Index + +The **Index** record specifies row information and the file locations for all [DBCell](#dbcell) records corresponding to each row block in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). This record, combined with the DBCell records, is used to optimize the [lookup of cells](#Section_24bbaffdab88489e983f3c400c8a8559) in a [cell table](#Section_d690007dd25c4822a650b24c13288bb7). + +[TABLE] + +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +**rwMic (4 bytes):** A [RwLongU](#rwlongu) structure that specifies the first row that has at least one [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) with data in current sheet. MUST be 0 if there are no rows that have at least one cell with data. + +**rwMac (4 bytes):** An unsigned integer that specifies one plus the zero-based index of the last row that has at least one cell with data in the sheet. MUST be 0 if there are no rows that have at least one cell with data. If not 0, MUST be greater than **rwMic**. + +**ibXF (4 bytes):** A FilePointer as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.5 that specifies the file position of the [DefColWidth](#defcolwidth) record in the current sheet. + +**rgibRw (variable):** An array of FilePointer. Each FilePointer as specified in \[MS-OSHARED\] section 2.2.1.5 specifies the file position of each referenced DBCell record. If the positions of DBCell records are not correct, there is no optimized method to do cell lookup and this can cause performance issues. The number of elements in the array MUST be equal to the number of row blocks in this sheet. + +### InterfaceEnd + +The **InterfaceEnd** record specifies the end of a collection of records as defined by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies information about the user interface. + +### InterfaceHdr + +The **InterfaceHdr** record specifies the [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38) of the user interface and specifies the beginning of a collection of records as defined by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies information about the user interface. + +[TABLE] + +**codePage (2 bytes):** An unsigned integer that specifies the code page. + +MUST be 0x04B0, which specifies [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8). + +### Intl + +The **Intl** record specifies that the [**macro sheet**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491) is an [**international macro sheet**](#gt_17a6eea5-8094-4056-84fd-8d97fbf0c865). + +[TABLE] + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +### Label + +The **Label** record specifies a label on the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) for each [series](#Section_527ce4dfc9f84e50a314d4b07519593c). + +[TABLE] + +**cell (6 bytes):** A [Cell](#cell) structure that specifies the row and column of the label and the index of the label’s format. + +**st (variable):** A [XLUnicodeString](#xlunicodestring) structure that contains the text of the label. + +### LabelSst + +The **LabelSst** record specifies a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that contains a string. + +[TABLE] + +**cell (6 bytes):** A [Cell](#cell) structure that specifies the cell containing the string from the shared string table. + +**isst (4 bytes):** An unsigned integer that specifies the zero-based index of an element in the array of [XLUnicodeRichExtendedString](#xlunicoderichextendedstring) structure in the **rgb** field of the [SST](#sst) record in this [Workbook Stream](#Section_f682f4b08c6b444e83f852d156f1e8ba) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that specifies the string contained in the cell. MUST be greater than or equal to zero and less than the number of elements in the **rgb** field of the SST record. + +### Lbl + +The **Lbl** record specifies a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + +[TABLE] + +**A - fHidden (1 bit):** A bit that specifies whether the defined name is not [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) in the list of defined names. + +**B - fFunc (1 bit):** A bit that specifies whether the defined name represents an [**Excel macro (XLM)**](#gt_11e8ff9f-bce2-4d8b-9ba2-11ac468f7c7b). If this bit is 1, **fProc** MUST also be 1. + +**C - fOB (1 bit):** A bit that specifies whether the defined name represents a [**Visual Basic for Applications (VBA)**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) [**macro**](#gt_cd2933d3-08d1-4931-bd5c-7ae0a668fe7c). If this bit is 1, the **fProc** MUST also be 1. + +**D - fProc (1 bit):** A bit that specifies whether the defined name represents a macro. + +**E - fCalcExp (1 bit):** A bit that specifies whether **rgce** contains a call to a function that can return an array. + +**F - fBuiltin (1 bit):** A bit that specifies whether the defined name represents a [**built-in name**](#gt_d40a51df-e96f-45ec-885d-6f936d172b39). + +**fGrp (6 bits):** An unsigned integer that specifies the [**function category**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) for the defined name. MUST be less than or equal to 31. The values 17 to 31 are user-defined. User-defined values are specified in the [FnGroupName](#fngroupname) record. The values 0 to 16 are defined as specified in the following table: + +| Value | Category | +|-------|--------------------------------------------------------------| +| 0 | All | +| 1 | Financial | +| 2 | Date Time | +| 3 | Math Trigonometry | +| 4 | Statistical | +| 5 | Lookup | +| 6 | Database | +| 7 | Text | +| 8 | Logical | +| 9 | Info | +| 10 | Commands | +| 11 | Customize | +| 12 | Macro Control | +| 13 | [**DDE**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) External | +| 14 | User Defined | +| 15 | Engineering | +| 16 | [**Cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7) | + +**G - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**H - fPublished (1 bit):** A bit that specifies whether the defined name is [**published**](#gt_8ffc383a-d4f1-4515-a8b5-874d84ab2d2b). This bit is ignored if the **fPublishedBookItems** field of the [BookExt_Conditional12](#bookext_conditional12) structure is 0. + +**I - fWorkbookParam (1 bit):** A bit that specifies whether the defined name is a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) parameter. + +**J - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**chKey (1 byte):** The unsigned integer value of the [**ASCII**](#gt_79fa85ca-ac61-467c-b819-e97dc1a7a599) character that specifies the shortcut key for the macro represented by the defined name. MUST be 0 (no shortcut key) if **fFunc** is 1 or if **fProc** is 0. Otherwise MUST[\<97\>](#Appendix_A_97) be greater than or equal to 0x41 and less than or equal to 0x5A, or greater than or equal to 0x61 and less than or equal to 0x7A. + +**cch (1 byte):** An unsigned integer that specifies the number of characters in **Name**. MUST be greater than or equal to zero. + +**cce (2 bytes):** An unsigned integer that specifies length of **rgce** in bytes. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**itab (2 bytes):** An unsigned integer that specifies if the defined name is a [**local name**](#gt_6f2787cc-ab35-4cc1-bebd-fb120864d320), and if so, which [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) it is on. If **itab** is not 0, the defined name is a local name and the value MUST be a one-based index to the collection of [BoundSheet8](#boundsheet8) records as they appear in the Globals Substream. + +**reserved4 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved5 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved6 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved7 (1 byte):** MUST be zero, and MUST be ignored. + +**Name (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name for the defined name. If **fBuiltin** is 0, this field MUST satisfy the same restrictions as the **name** field of the [XLNameUnicodeString](#xlnameunicodestring) structure. If **fBuiltin** is 1, this field is for a built-in name. Each built-in name has a zero-based index value associated with it. A built-in name or its index value MUST be used for this field. The built-in names are defined in the following table: + +| Values | Names | +|--------|------------------| +| 0x00 | Consolidate_Area | +| 0x01 | Auto_Open | +| 0x02 | Auto_Close | +| 0x03 | Extract | +| 0x04 | Database | +| 0x05 | Criteria | +| 0x06 | Print_Area | +| 0x07 | Print_Titles | +| 0x08 | Recorder | +| 0x09 | Data_Form | +| 0x0A | Auto_Activate | +| 0x0B | Auto_Deactivate | +| 0x0C | Sheet_Title | +| 0x0D | \_FilterDatabase | + +**rgce (variable):** A [NameParsedFormula](#nameparsedformula) structure that specifies the **formula** for the **defined name**. + +### LeftMargin + +The **LeftMargin** record specifies the left margin of the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**num (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the left margin of the current sheet in inches. The value MUST be greater than or equal to 0 and less than or equal to 49. + +### Legend + +The **Legend** record specifies properties of a [legend](#Section_1832229b7d1945f488d455e9c07466f0), and specifies the beginning of a collection of records defined by [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a legend. The absence of this collection of records implies that a legend does not exist on the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +[TABLE] + +**x (4 bytes):** An unsigned integer that specifies the x-position, in [SPRC](#Section_d5fc728e68de4972905a975bcef8c82d), of the upper-left corner of the [**bounding rectangle**](#gt_e349a155-0fb9-4ba1-abd4-e363e21abcd1) of the legend. MUST be ignored and the **x1** field from the following [Pos](#pos) record MUST be used instead. + +**y (4 bytes):** An unsigned integer that specifies the y-position, in SPRC, of the upper-left corner of the bounding rectangle of the legend. MUST be ignored and the **y1** field from the following Pos record MUST be used instead. + +**dx (4 bytes):** An unsigned integer that specifies the width, in SPRC, of the bounding rectangle of the legend. MUST be ignored and the **x2** field from the following Pos record MUST be used instead. + +**dy (4 bytes):** An unsigned integer that specifies the height, in SPRC, of the bounding rectangle of the legend. MUST be ignored and the **y2** field from the following Pos record MUST be used instead. + +**unused (1 byte):** Undefined and MUST be ignored. + +**wSpace (1 byte):** An unsigned integer that specifies the space between [**legend entries**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e). MUST be 0x01, which represents 40 [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382) between legend entries. + +**A - fAutoPosition (1 bit):** A bit that specifies whether the legend is automatically positioned. If this field is 0x1, then **fAutoPosX** MUST be 0x1 and **fAutoPosY** MUST be 0x1. + +**B - reserved1 (1 bit):** MUST be 1, and MUST be ignored. + +**C - fAutoPosX (1 bit):** A bit that specifies whether the x-positioning of the legend is automatic. + +**D - fAutoPosY (1 bit):** A bit that specifies whether the y-positioning of the legend is automatic. + +**E - fVert (1 bit):** A bit that specifies the layout of the legend entries. MUST equal 0x1 if **fWasDataTable** is equal to 0x1. MUST be a value from the following table: + +| **Value** | **Meaning** | +|----|----| +| 0x0 | The legend contains multiple columns of legend entries, or the size of the legend was manually changed from the default size. | +| 0x1 | The legend contains a single column of legend entries. | + +**F - fWasDataTable (1 bit):** A bit that specifies whether the legend is shown in a [data table](#Section_69938f61d2e94da3af87e154edcb0d98). + +**reserved2 (10 bits):** MUST be zero, and MUST be ignored. + +### LegendException + +The **LegendException** record specifies information about a [**legend entry**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e) which was changed from the default legend entry settings, and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies legend entry formatting. On a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) where the [legend](#Section_1832229b7d1945f488d455e9c07466f0) contains legend entries for the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) and [trendlines](#Section_61d74ebc36714d6dbdc0626db604530d), as defined in the legend overview, there MUST be zero instances or one instance of this record in the sequence of records that conform to the SERIESFORMAT rule. + +[TABLE] + +**iss (2 bytes):** An unsigned integer that specifies the legend entry. This field has different interpretations depending on the content of the legend in the chart. The legend overview specifies the types of content the legend can contain, as follows: + +- In a chart where the legend contains legend entries for the series and trendlines, this field MUST be 0xFFFF. This record specifies the legend entry of the series or trendline that contains this record. + +- In a chart where the legend contains legend entries for each [data point](#Section_9c986ad250d44fa1a157063ac5c971a0) in the chart, this field specifies the zero-based index of a legend entry in the legend, where 0x0000 is the legend entry for the first data point in the series. + +- In a chart with a surface [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), this field specifies the zero-based index of a legend entry in the legend, where 0x0000 is the legend entry for the lowest band of the surface chart group. + +**A - fDeleted (1 bit):** A bit that specifies whether the legend entry specified by **iss** was deleted. + +**B - fLabel (1 bit):** A bit that specifies whether the legend entry specified by **iss** was formatted. If this field is 1, there MUST be a sequence of records that conform to the ATTACHEDLABEL rule in the Chart Sheet Substream ABNF following this record. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +### Lel + +The **Lel** record specifies that a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) was lost because of the deletion of a supporting label[\<98\>](#Appendix_A_98). + +[TABLE] + +**stFormulaName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the name of the deleted label. The number of characters MUST be less than 252. + +### Line + +The **Line** record specifies that the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is a line chart group, and specifies the chart group attributes. + +[TABLE] + +**A - fStacked (1 bit):** A bit that specifies whether the [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) in the chart group that share the same [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) are stacked. + +**B - f100 (1 bit):** A bit that specifies whether the data points in the chart group are displayed as a percentage of the sum of all data points in the chart group that share the same category. MUST be 0 if **fStacked** is 0. + +**C - fHasShadow (1 bit):** A bit that specifies whether one or more [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) in the chart group has shadows. + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +### LineFormat + +The **LineFormat** record specifies the appearance of a line. + +[TABLE] + +**rgb (4 bytes):** A [LongRGB](#longrgb) structure that specifies the color of the line. The color MUST match the color specified by **icv**. + +**lns (2 bytes):** An unsigned integer that specifies the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) of the line. MUST be a value from the following table: + +| Value | Meaning | +|--------|---------------------| +| 0x0000 | Solid | +| 0x0001 | Dash | +| 0x0002 | Dot | +| 0x0003 | Dash-dot | +| 0x0004 | Dash dot-dot | +| 0x0005 | None | +| 0x0006 | Dark gray pattern | +| 0x0007 | Medium gray pattern | +| 0x0008 | Light gray pattern | + +When the value of this field is 0x0005 (None), the values of **we** and **icv** MUST be set to the values specified in the following table: + +| Attribute | Default Value | +|-------------------------|-------------------| +| Line thickness (**we**) | 0xFFFF (Hairline) | +| Line color (**icv**) | 0x004D | + +**we (2 bytes):** A signed integer that specifies the thickness of the line. MUST be a value from the following table: + +| Value | Meaning | +|-------------|-----------------| +| 0xFFFF (-1) | Hairline | +| 0x0000 | Narrow (single) | +| 0x0001 | Medium (double) | +| 0x0002 | Wide (triple) | + +**A - fAuto (1 bit):** A bit that specifies whether the line has default formatting. + +If the value of **fAuto** is 0, the line has formatting as specified by **lns**, **we**, and **icv**. + +If the value of **fAuto** is 1, **lns**, **we**, **icv**, and **rgb** MUST be ignored and default values are used as specified in the following table: + +| Attribute | Default Value | +|-------------------------|------------------------------------------| +| Line pattern (**lns**) | 0xFFFF (Hairline) | +| Line thickness (**we**) | 0x0000 (Narrow) | +| Line color (**icv**) | 0x004D | +| Line color (**rgb**) | Match the default color used for **icv** | + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fAxisOn (1 bit):** A bit that specifies whether the [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) line is displayed. + +If the previous record is [AxisLine](#axisline) and the value of the **id** field of the AxisLine record is equal to 0x0000, this field MUST be a value from the following table: + +| fAxisOn | Lns | Meaning | +|---------|-------------------------------|---------------------------------| +| 0 | 0x0005 | The axis line is not displayed. | +| 0 | Any legal value except 0x0005 | The axis line is displayed. | +| 1 | Any legal value | The axis line is displayed. | + +If the previous record is not AxisLine and the value of the **id** field of the AxisLine record is equal to 0x0000, this field MUST be zero, and MUST be ignored. + +**D - fAutoCo (1 bit):** A bit that specifies whether **icv** is equal to 0x004D. If the value is 1, **icv** MUST equal 0x004D. If the value is 0, **icv** MUST NOT equal 0x004D. + +**reserved2 (12 bits):** MUST be zero, and MUST be ignored. + +**icv (2 bytes):** An [IcvChart](#icvchart) structure that specifies the color of the line. The color MUST match the color specified by **rgb**. + +### List12 + +The **List12** record specifies the additional formatting information for a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). These records immediately follow a [Feature11](#feature11) or [Feature12](#feature12) record, and specify additional formatting information for the table specified by the Feature11 or Feature12 record. This record is a [future record type](#Section_b660b67822684414839ed1ae9a4e4e85) record. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0877. + +**lsd (2 bytes):** An unsigned integer that specifies the type of data contained in the **rgb** field. + +MUST be a value specified in the table listed under **rgb**. + +**idList (4 bytes):** An unsigned integer that identifies the associated table for which this record specifies additional formatting. MUST NOT be zero. MUST be equal to the **idList** field of the [TableFeatureType](#tablefeaturetype) structure embedded in the associated Feature11 or Feature12 record. + +**rgb (variable):** A structure whose type and meaning are specified by the value of **lsd**, as specified in the following table: + +| Value of lsd | Meaning of rgb | +|----|----| +| 0x0000 | **rgb** is a [List12BlockLevel](#list12blocklevel) structure that specifies the [table block-level formatting](#Section_0c7947ddc8874a69a5cbc14494d21034). | +| 0x0001 | **rgb** is a [List12TableStyleClientInfo](#list12tablestyleclientinfo) structure that specifies the [table style](#Section_4ac7212b4aa74ece962526c58224ae80). | +| 0x0002 | **rgb** is a [List12DisplayName](#list12displayname) structure that specifies the display name. | + +### LPr + +The **LPr** record specifies a record that is unused. + +[TABLE] + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - unused2 (1 bit):** Undefined and MUST be ignored. + +**C - unused3 (1 bit):** Undefined and MUST be ignored. + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +**unused4 (2 bytes):** Undefined and MUST be ignored. + +**unused5 (2 bytes):** Undefined and MUST be ignored. + +**unused6 (2 bytes):** Undefined and MUST be ignored. + +**unused7 (2 bytes):** Undefined and MUST be ignored. + +**unused8 (2 bytes):** Undefined and MUST be ignored. + +**unused9 (variable):** Undefined and MUST be ignored. + +### LRng + +The **LRng** record specifies a label [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) for [**natural language formulas**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b)[\<99\>](#Appendix_A_99). + +[TABLE] + +**crefRw (2 bytes):** An unsigned integer that specifies the number of row label ranges. When added to the value of **crefCol**, the value MUST be less than 1028. + +**refRow (variable):** An array of [Ref8U](#ref8u) structures. The array specifies the row label ranges. The size of the array is specified by **crefRw**. + +**crefCol (2 bytes):** An unsigned integer that specifies the number of column label ranges. When added to the value of **crefRw**, the value MUST be less than 1028. + +**refCol (variable):** An array of Ref8U structures. The array specifies the column label ranges. The size of the array is specified by **crefCol**. + +### MarkerFormat + +The **MarkerFormat** record specifies the color, size, and shape of the associated [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) that appear on line, radar, and scatter [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5). The associated data markers are specified by the preceding [DataFormat](#dataformat) record. If this record is not present in the sequence of records that conforms to the [SS](#chart-sheet-substream) rule of the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), then the color, size, and shape of the associated data markers are specified by the default values of the fields of this record. + +[TABLE] + +**rgbFore (4 bytes):** A [LongRGB](#longrgb) structure that specifies the [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) color of the data marker. The color MUST match the color specified by **icvFore**. The default value of this field is automatically selected from the next available color in the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) color table. + +**rgbBack (4 bytes):** A LongRGB structure that specifies the interior color of the data marker. The color MUST match the color specified by **icvBack**. The default value of this field is the same as the default value for **rgbFore** only when the default **imk** is 0x0001, 0x0002, 0x0003, or 0x0008. Otherwise, the default value is 0xFFFFFF. + +**imk (2 bytes):** An unsigned integer that specifies the type of data marker. The default value for this field is automatically selected from the list of data marker types and cannot be 0x0000. MUST be a value from the following table: + +| Value | Meaning | +|--------|----------------------------------| +| 0x0000 | No marker. | +| 0x0001 | Square markers. | +| 0x0002 | Diamond-shaped markers. | +| 0x0003 | Triangular markers. | +| 0x0004 | Square markers with an X. | +| 0x0005 | Square markers with an asterisk. | +| 0x0006 | Short bar markers. | +| 0x0007 | Long bar markers. | +| 0x0008 | Circular markers. | +| 0x0009 | Square markers with a plus sign. | + +**A - fAuto (1 bit):** A bit that specifies whether the data marker is automatically generated. The default value for this field is 1. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The data marker is not automatically generated. | +| 0x1 | The data marker type, size, and color are automatically generated and the values are set accordingly in this record. | + +**B - reserved1 (3 bits):** MUST be zero, and MUST be ignored. + +**C - fNotShowInt (1 bit):** A bit that specifies whether to show the data marker interior. The default value for this field is 0. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------| +| 0x0 | The data marker interior is shown. | +| 0x1 | The data marker interior is not shown. | + +**D - fNotShowBrd (1 bit):** A bit that specifies whether to show the data marker border. The default value for this field is 0. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------| +| 0x0 | The data marker border is shown. | +| 0x1 | The data marker border is not shown. | + +**reserved2 (10 bits):** MUST be zero, and MUST be ignored. + +**icvFore (2 bytes):** An [IcvChart](#icvchart) structure that specifies the border color of the data marker. The color MUST match the color specified by **rgbFore**. The default value of this field is automatically set to match the color specified by **rgbFore**. + +**icvBack (2 bytes):** An IcvChart structure that specifies the interior color of the data marker. The color MUST match the color specified by **rgbBack**. The default value of this field is automatically set to match the color specified by **rgbBack**. + +**miSize (4 bytes):** An unsigned integer that specifies the size in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382) of the data marker. MUST be greater than or equal to 40 and less than or equal to 1440. The default value for this field is 100. + +### MDB + +The **MDB** record specifies a unique set of [MDX metadata](#Section_0f7583182c0b4155bf75c7399f89305c) type/value pairs that are shared among all [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) that reference [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) metadata. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x88A. + +**rgmdir (variable):** An array of [MDir](#mdir) structures that specifies a block of [metadata](#Section_c2df6678f9ab4f71a17b1dfa8b9ac76a) records. + +### MDTInfo + +The **MDTInfo** record specifies the information about a single type of [metadata](#Section_c2df6678f9ab4f71a17b1dfa8b9ac76a). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0884. + +**A - fGhostRow (1 bit):** A bit that specifies whether the metadata is applied to all [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in newly inserted rows. + +**B - fGhostCol (1 bit):** A bit that specifies whether the metadata is applied to all cells in newly inserted columns. + +**C - fEdit (1 bit):** A bit that specifies whether the metadata is preserved when the cell is edited. + +**D - fDelete (1 bit):** A bit that specifies whether the metadata is preserved when the cell's value is deleted. + +**E - fCopy (1 bit):** A bit that specifies whether the metadata is copied when the cell is copied. MUST be 1 if one or more of the values of **fPasteAll**, **fPasteFormulas**, **fPasteValues**, **fPasteFormats**, **fPasteComments**, **fPasteDataValidation**, **fPasteBorders**, **fPasteColWidths**, or **fPasteNumberFormats** is 1. + +**F - fPasteAll (1 bit):** A bit that specifies whether the metadata is pasted when all formulas, values, formatting, comments, and [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) rules are pasted from the previously copied cell. + +**G - fPasteFormulas (1 bit):** A bit that specifies whether the metadata is pasted when only formulas are pasted from the previously copied cell. + +**H - fPasteValues (1 bit):** A bit that specifies whether the metadata is pasted when only values are pasted from the previously copied cell. + +**I - fPasteFormats (1 bit):** A bit that specifies whether the metadata is pasted when only formatting is pasted from the previously copied cell. + +**J - fPasteComments (1 bit):** A bit that specifies whether the metadata is pasted when only comments are pasted from the previously copied cell. + +**K - fPasteDataValidation (1 bit):** A bit that specifies whether the metadata is pasted when only data validation rules are pasted from the previously copied cell. + +**L - fPasteBorders (1 bit):** A bit that specifies whether the metadata is pasted when only borders are pasted from the previously copied cell. + +**M - fPasteColWidths (1 bit):** A bit that specifies whether the metadata is pasted when only column widths are pasted from the previously copied cell. + +**N - fPasteNumberFormats (1 bit):** A bit that specifies whether the metadata is pasted when only number formatting is pasted from the previously copied cell. + +**O - fMerge (1 bit):** A bit that specifies whether the metadata is preserved after cells are merged. If the value of this bit is 1, and the cell has the smallest row and column number of the cells that are being merged, the metadata is preserved. + +**P - fSplitFirst (1 bit):** A bit that specifies whether, when a cell is split, the metadata is copied to the cell with the smallest row and column number. If **fSplitAll** is set to 1, **fSplitAll** takes precedence. + +**Q - fSplitAll (1 bit):** A bit that specifies whether, when a cell is split, the metadata is copied to all the resulting cells. If the value is 1, the value of **fSplitFirst** MUST be ignored. + +**R - fRowColShift (1 bit):** A bit that specifies whether the metadata is preserved when the cell is shifted because of row or column deletion or insertion. + +**S - fClearAll (1 bit):** A bit that specifies whether the metadata is preserved when the contents, formatting, and comments of the cell are cleared. + +**T - fClearFormats (1 bit):** A bit that specifies whether the metadata is preserved when the formatting of the cell is cleared. + +**U - fClearContents (1 bit):** A bit that specifies whether the metadata is preserved when the contents of the cell is cleared. + +**V - fClearComments (1 bit):** A bit that specifies whether the metadata is preserved when the comments of the cell are cleared. + +**W - fAssign (1 bit):** A bit that specifies whether the metadata is preserved when the cell's value is changed by formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) assignment. + +**unused1 (5 bits):** Undefined and MUST be ignored. + +**X - fCoerce (1 bit):** A bit that specifies whether the metadata is preserved when the cell's value is coerced to a different type. + +**Y - fAdjust (1 bit):** A bit that specifies whether the metadata is updated when the cell's location is changed. + +**Z - fCellMeta (1 bit):** A bit that specifies whether this metadata type is [cell metadata](#Section_c925f5199fe14b6ab01807fa18351e68) or [value metadata](#Section_e78bf5ba22754bad8e6cf4f59644efa6). MUST be 0 from the following table: + +| Value | Meaning | +|-------|-----------------------------| +| 0 | Metadata is value metadata. | +| 1 | Metadata is cell metadata. | + +**a - unused2 (1 bit):** Undefined and MUST be ignored. + +**stName (variable):** An [LPWideString](#lpwidestring) type that specifies the name of the metadata type. + +### MDXKPI + +The **MDXKPI** record specifies [MDX KPI metadata](#Section_db8664f2502b43d2aa88274035b52570). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x889. + +**istrConnName (4 bytes):** An [MDXStrIndex](#mdxstrindex) structure that specifies the index of the connection name string. + +**tfnSrc (1 byte):** A [Tag_Fn_MDX](#tag_fn_mdx) enumeration that specifies the type of [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) that generated the metadata. The value MUST be **TFNCUBEKPIPROPERTY**. + +**kpiprop (1 byte):** A [KPIProp](#kpiprop) enumeration that specifies the KPI type. + +**istrKPIName (4 bytes):** An MDXStrIndex structure that specifies the index of the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) string. + +**istrMbrKPI (4 bytes):** An MDXStrIndex structure that specifies the index of the key performance indicator name string. + +### MDXProp + +The **MDXProp** record specifies [member property MDX metadata](#Section_722f7e05ca3e4a20b30fbbed1a597e88). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x888. + +**istrConnName (4 bytes):** An [MDXStrIndex](#mdxstrindex) structure that specifies the index of the connection name string. + +**tfnSrc (1 byte):** A [Tag_Fn_MDX](#tag_fn_mdx) enumeration that specifies the type of [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) that generated the metadata. The value MUST be **TFNCUBEMEMBERPROPERTY**. + +**istrMbr (4 bytes):** An MDXStrIndex structure that specifies the index of the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) string. + +**istrProp (4 bytes):** An MDXStrIndex structure that specifies the index of the property name string. + +### MDXSet + +The **MDXSet** record specifies [MDX set metadata](#Section_84d4d0b542b6405ea07be3272dc517f8). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x887. + +**istrConnName (4 bytes):** An [MDXStrIndex](#mdxstrindex) structure that specifies the index of the connection name string. + +**tfnSrc (1 byte):** A [Tag_Fn_MDX](#tag_fn_mdx) enumeration that specifies the type of [**cube function**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3) that generated the metadata. The value MUST be equal to **TFNCUBESET** or **TFNCUBESETCOUNT**. + +**sso (1 byte):** An [SD_SetSortOrder](#sd_setsortorder) enumeration that specifies the set [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7). + +**istrSetDef (4 bytes):** An MDXStrIndex structure that specifies the index of the set definition string. + +**cistr (4 bytes):** A signed integer that specifies the number of [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) strings. The value MUST be greater than or equal to 0, and less than or equal to the total number of [MDXStr](#mdxstr) records in the file. + +**rgistr (variable):** An array of MDXStrIndex structures that specifies the indexes of the MDX unique name strings. The number of the elements in the array MUST be equal to the value of **cistr**. + +### MDXStr + +The **MDXStr** record specifies a shared text string used by records specifying [MDX metadata](#Section_0f7583182c0b4155bf75c7399f89305c). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x885. + +**st (variable):** An [LPWideString](#lpwidestring) type that specifies the content of the string. + +### MDXTuple + +The **MDXTuple** record specifies [MDX tuple metadata](#Section_277444ebcca34128b302b39de79eeb41). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x886. + +**istrConnName (4 bytes):** An [MDXStrIndex](#mdxstrindex) structure that specifies the index of the connection name string. + +**tfnSrc (1 byte):** A [Tag_Fn_MDX](#tag_fn_mdx) enumeration that specifies the type of [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) that generated the metadata. The value MUST be equal to **TFNCUBEMEMBER**, **TFNCUBEVALUE**, or **TFNCUBERANKEDMEMBER**. + +**cistr (4 bytes):** A signed integer that specifies the number of [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) strings. The value MUST be greater than or equal to 0, and less than or equal to the total number of [MDXStr](#mdxstr) records in the file. + +**rgistr (variable):** An array of MDXStrIndex structures that specifies the indexes of the MDX unique name strings. The number of the elements in the array MUST be equal to the value of **cistr.** + +### MergeCells + +The **MergeCells** record specifies [**merged cells**](#gt_75cf70e2-3993-471f-9589-b70d384588f2) in the document. If the count of the merged cells in the document is greater than 1026, the file will contain multiple adjacent **MergeCells** records. + +[TABLE] + +**cmcs (2 bytes):** An unsigned integer that specifies the count of [Ref8](#ref8) structures. MUST be less than or equal to 1026. + +**rgref (variable):** An array of Ref8 structures. Each array element specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that are merged into a single merged cell. These ranges MUST NOT overlap. MUST contain the number of elements specified by **cmcs.** + +### Mms + +The **Mms** record is reserved and MUST be ignored. + +[TABLE] + +**reserved1 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +### MsoDrawing + +The **MsoDrawing** record specifies a [**drawing**](#gt_4b4d1a42-c4a2-464d-ad16-d53b5c493fd3). If this record is in the [Worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56), [Macro Sheet](#Section_0dddd943f77a4fc2bf92868acb4587f7), or [Dialog Sheet](#Section_da37feb48b9a462d87772a5fddd4866e) substream, the **OfficeArtClientAnchor** structure mentioned in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) refers to the [OfficeArtClientAnchorSheet](#officeartclientanchorsheet) structure. If this record appears in the [Chart Sheet](#Section_732ff614d939416bb7c76d983471ff11) substream, the **OfficeArtClientAnchor** structure mentioned in \[MS-ODRAW\] refers to the [OfficeArtClientAnchorChart](#officeartclientanchorchart) structure. + +[TABLE] + +**rgChildRec (variable):** An **OfficeArtDgContainer** structure as specified in \[MS-ODRAW\] that specifies the drawing. If the **rgChildRec** has a **shape** structure in it as specified in \[MS-ODRAW\] and that **shape** has a **clientData** record in it as specified in \[MS-ODRAW\], then the next record following this record MUST be an [Obj](#obj). The size of the **clientData** record does not include the size of the following Obj record. If the **rgChildRec** has a **shape** structure in it as specified in \[MS-ODRAW\] and that **shape** has a **clientTextbox** record in it as specified in \[MS-ODRAW\], then the next record following this record MUST be a [TxO](#txo). The size of the **clientTextbox** record does not include the size of this TxO record. + +### MsoDrawingGroup + +The **MsoDrawingGroup** record specifies a group of [**drawing objects**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac). + +[TABLE] + +**rgChildRec (variable):** An **OfficeArtDggContainer** as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) that specifies the group of drawing objects. + +### MsoDrawingSelection + +The **MsoDrawingSelection** record specifies [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) [**drawing objects**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) and the drawing objects in focus on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**selection (variable):** An **OfficeArtFDGSL** structure as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.2.33 that specifies the selected drawing objects. + +### MTRSettings + +The **MTRSettings** record specifies multithreaded calculation settings. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x089A. + +**fMTREnabled (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the multithreaded calculation is enabled. MUST be a value from the following table: + +| Value | Meaning | +|------------|----------------------------------------| +| 0x00000000 | Multithreaded calculation is disabled. | +| 0x00000001 | Multithreaded calculation is enabled. | + +**fUserSetThreadCount (4 bytes):** A Boolean that specifies whether the thread count was manually specified by the user. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00000000 | The thread count **cUserThreadCount** was not manually specified by the user. | +| 0x00000001 | The thread count **cUserThreadCount** was manually specified by the user. | + +**cUserThreadCount (4 bytes):** A signed integer that specifies the count of calculation threads. MUST be greater than or equal to 0x00000001 and MUST be less than or equal to 0x00000400. If **fMTREnabled** is 0x00000000 or **fUserSetThreadCount** is 0x00000000, the value of this field MUST be ignored. + +### MulBlank + +The **MulBlank** record specifies a [series](#Section_527ce4dfc9f84e50a314d4b07519593c) of blank [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) row. This record can store up to 256 [IXFCell](#ixfcell) structures. + +[TABLE] + +**rw (2 bytes):** An [Rw](#rw) structure that specifies a row containing the blank cells. + +**colFirst (2 bytes):** A [Col](#col) structure that specifies the first column in the series of blank cells within the sheet. The value of **colFirst.col** MUST be less than or equal to 254. + +**rgixfe (variable):** An array of IXFCell structures. Each element of this array contains an IXFCell structure corresponding to a blank cell in the series. The number of entries in the array MUST be equal to the value given by the following formula: + +Number of entries in **rgixfe** = (**colLast.col** – **colFirst.col** +1) + +**colLast (2 bytes):** A Col structure that specifies the last column in the series of blank cells within the sheet. This **colLast.col** value MUST be greater than **colFirst.col** value. + +### MulRk + +The **MulRk** record specifies a [series](#Section_527ce4dfc9f84e50a314d4b07519593c) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) with numeric data in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) row. This record can store up to 256 [RkRec](#rkrec) structures. + +[TABLE] + +**rw (2 bytes):** An [Rw](#rw) structure that specifies the row containing the cells with numeric data. + +**colFirst (2 bytes):** A [Col](#col) structure that specifies the first column in the series of numeric cells within the sheet. The value of **colFirst.col** MUST be less than or equal to 254. + +**rgrkrec (variable):** An array of RkRec structures. Each element in the array specifies an RkRec in the row. The number of entries in the array MUST be equal to the value given by the following formula: + +Number of entries in **rgrkrec** = (**colLast.col** – **colFirst.col** +1) + +**colLast (2 bytes):** A Col structure that specifies the last column in the set of numeric cells within the sheet. This **colLast.col** value MUST be greater than the **colFirst.col** value. + +### NameCmt + +The **NameCmt** record specifies a [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) associated with a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0894. + +**cchName (2 bytes):** An unsigned integer that specifies the number of characters in the **name**. The value MUST be less than or equal to 0x00FF. + +**cchComment (2 bytes):** An unsigned integer that specifies the number of characters in the **comment**. The value MUST be less than or equal to 0x00FF. + +**name (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the defined name; **cchName** specifies the number of characters in this string. This string MUST satisfy the formatting restrictions specified in the [XLNameUnicodeString](#xlnameunicodestring) structure. This string MUST also satisfy the following formatting restriction based on the **fBuiltin** field in the preceding [Lbl](#lbl) record: + +| Value of fBuiltIn field in the preceding Lbl record | Restrictions on this field | +|----|----| +| 0 | The string in this field MUST be the same string (using case-insensitive comparison) as the string in the **name** field of the preceding Lbl record. | +| 1 | The string in this field MUST be the defined name associated with the [**built-in name**](#gt_d40a51df-e96f-45ec-885d-6f936d172b39) number that appears in the **name** field in the preceding Lbl record. | + +**comment (variable):** An XLUnicodeStringNoCch structure that specifies the comment; **cchComment** specifies the number of characters in this string. + +### NameFnGrp12 + +The **NameFnGrp12** record specifies the name of a [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) in a [**function category**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) that is specified in an [**FnGrp12**](#fngrp12) record. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0899. + +**cachName (2 bytes):** An unsigned integer that specifies the number of characters in the name of the function. The value MUST be greater than or equal to 1 and less than or equal to 255. + +**fgrp (2 bytes):** An unsigned integer that specifies the zero-based index of the function category that this function belongs to. This value minus 32 specifies the zero-based index of an FnGrp12 record in the collection of FnGrp12 records, as specified by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). MUST be greater than or equal to 32 and less than or equal to 255. + +**rgach (variable):** An [XLNameUnicodeString](#xlnameunicodestring) structure that specifies the name of the function. The length MUST be equal to **cachName**. + +### NamePublish + +The **NamePublish** record specifies information about a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0893. + +**A - fPublished (1 bit):** A bit that specifies whether the defined name is published to a server. This bit is ignored if the **fPublishedBookItems** field of the [BookExt_Conditional12](#bookext_conditional12) structure is 0. + +**B - fWorkbookParam (1 bit):** A bit that specifies whether the defined name is a [**workbook parameter**](#gt_be16812d-eaff-41db-83cc-d145e61e8ef6). + +**unused (14 bits):** Undefined and MUST be ignored. + +**strName (variable):** An [XLNameUnicodeString](#xlnameunicodestring) structure that specifies the defined name. + +### Note + +The **Note** record specifies a [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) associated with a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) or revision information about a comment associated with a cell. + +[TABLE] + +**body (variable):** A variable type field. The data type and meaning of this field is determined by the stream that contains this record, as specified in the following table: + +[TABLE] + +### Number + +The **Number** record specifies a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that contains a [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d). + +[TABLE] + +**cell (6 bytes):** A [Cell](#cell) structure that specifies the cell. + +**num (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the cell value. + +If this record appears in a [SERIESDATA](#chart-sheet-substream) record collection, and this record specifies a cell in the [chart data cache](#Section_e21d24e4e71f4fdc81077f0d6a6efa6a) that specifies data for an [error bar](#Section_762a461d0a45474ebd7d5994bb294af2) [series](#Section_527ce4dfc9f84e50a314d4b07519593c), then this field is a [ChartNumNillable](#chartnumnillable) value. If a ChartNumNillable is used, a blank cell is specified by a [NilChartNum](#nilchartnum) structure that has a **type** field with a value of 0x0000, and a cell with a \#N/A error is specified by a NilChartNum that has a **type** field with a value of 0x0100. + +### Obj + +The **Obj** record specifies the properties of an object in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**cmo (22 bytes):** An [FtCmo](#ftcmo) structure that specifies the common properties of this object. + +**gmo (6 bytes):** An optional [FtGmo](#ftgmo) structure that specifies the properties of this group object. This field MUST exist if and only if **cmo.ot** is equal to 0x00. + +**pictFormat (6 bytes):** An optional [FtCf](#ftcf) structure that specifies the format of this picture object. This field MUST exist if and only if **cmo.ot** is equal to 0x08. + +**pictFlags (6 bytes):** An optional [FtPioGrbit](#ftpiogrbit) structure that specifies additional properties of this picture object. This field MUST exist if and only if **cmo.ot** is equal to 0x08. + +**cbls (16 bytes):** An optional [FtCbls](#ftcbls) structure that represents a check box or radio button. This field MUST exist if and only if **cmo.ot** is equal to 0x0B or 0x0C. + +**rbo (10 bytes):** An optional [FtRbo](#ftrbo) structure that represents a radio button. This field MUST exist if and only if **cmo.ot** is equal to 0x0C. + +**sbs (24 bytes):** An optional [FtSbs](#ftsbs) structure that specifies the properties of this spin control, scrollbar, list, or drop-down list object. This field MUST exist if and only if **cmo.ot** is equal to 0x10, 0x11, 0x12, or 0x14. + +**nts (26 bytes):** An optional [FtNts](#ftnts) structure that specifies the properties of this [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) object. This field MUST exist if and only if **cmo.ot** is equal to 0x19. + +**macro (variable):** An optional [FtMacro](#ftmacro) structure that specifies the action associated with this object. + +**pictFmla (variable):** An optional [FtPictFmla](#ftpictfmla) structure that specifies the location of the data associated with this picture object. This field MUST NOT exist unless **cmo.ot** is equal to 0x08. + +**linkFmla (variable):** An optional [ObjLinkFmla](#objlinkfmla) structure that specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that has a value linked to this object. This field MUST NOT exist unless **cmo.ot** is equal to 0x0B, 0x0C, 0x10, 0x11, 0x12, or 0x14. The value of **linkFmla.ft** MUST equal 0x14 if **cmo.ot** is equal to 0x0B or 0x0C. Otherwise, **linkFmla.ft** MUST equal 0x0E. + +**checkBox (12 bytes):** An optional [FtCblsData](#ftcblsdata) structure that specifies the properties of this check box or radio button object. This field MUST exist if and only if **cmo.ot** is equal to 0x0B or 0x0C. + +**radioButton (8 bytes):** An optional [FtRboData](#ftrbodata) structure that specifies additional properties of this radio button object. This field MUST exist if and only if **cmo.ot** is equal to 0x0C. + +**edit (12 bytes):** An optional [FtEdoData](#ftedodata) structure that specifies the properties of this edit box object. This field MUST exist if and only if **cmo.ot** is equal to 0x0D. + +**list (variable):** An optional [FtLbsData](#ftlbsdata) structure that specifies the properties of this list box or drop-down object. This field MUST exist if and only if **cmo.ot** is equal to 0x12 or 0x14. + +**gbo (10 bytes):** An optional [FtGboData](#ftgbodata) structure that specifies the properties of this group box object. This field MUST exist if and only if **cmo.ot** is equal to 0x13. + +**reserved (4 bytes):** Optional. MUST be 0, and MUST be ignored. This field MUST exist if and only if **cmo.ot** does not equal 0x12 or 0x14. + +### ObjectLink + +The **ObjectLink** record specifies an object on a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), or the entire chart, to which the [Text](#text) record is linked. + +[TABLE] + +**wLinkObj (2 bytes):** An unsigned integer that specifies the object that the Text record is linked to. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0001 | Entire chart. | +| 0x0002 | Value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3), or vertical value axis on bubble and scatter [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5) | +| 0x0003 | [**Category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) axis, or horizontal value axis on bubble and scatter chart groups. | +| 0x0004 | [Series](#Section_527ce4dfc9f84e50a314d4b07519593c) or [data points](#Section_9c986ad250d44fa1a157063ac5c971a0). | +| 0x0007 | Series axis. | +| 0x000C | [**Display units**](#gt_7d807b62-cff1-4e03-a73f-840844345b83) labels of an axis. | + +**wLinkVar1 (2 bytes):** An unsigned integer that specifies the zero-based index into a [Series](#series-1) record in the collection of Series records in the current Chart Sheet substream. Each referenced Series record specifies a series for the chart group to which the Text record is linked. When the **wLinkObj** field is 4, MUST be less than or equal to 254. When the **wLinkObj** field is not 4, MUST be zero, and MUST be ignored. + +**wLinkVar2 (2 bytes):** An unsigned integer that specifies the zero-based index into the category within the series specified by **wLinkVar1**, to which the Text record is linked. When the **wLinkObj** field is 4, if the Text record is linked to a series instead of a single data point, the value MUST be 0xFFFF; if the Text record is linked to a data point, the value MUST be less than or equal to 31999. When the **wLinkObj** field is not 4, MUST be zero, and MUST be ignored. + +### ObjProtect + +The **ObjProtect** record specifies the [**protection**](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499) state of the objects on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). This record exists if the sheet is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829) and the objects on the sheet are protected. + +[TABLE] + +**fLockObj (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies that the objects are protected. MUST be 0x0001. + +### ObNoMacros + +The existence of the **ObNoMacros** record specifies that an [ObProj](#obproj) record exists in the file, and that there are no [**forms**](#gt_c7858bfa-d4d2-48a7-ac9c-d2e90fbe3590), [**modules**](#gt_3f7df968-a51b-4dea-9f2c-4cf6ce65ccc1), or [**class modules**](#gt_25ca6ee7-698a-45cc-9e3c-8be094d77324) in the [**VBA project**](#gt_980e3334-2874-4425-a73a-f2235cec1e1e) located in the [VBA storage](#Section_27d93f33eaa941d49ec07f2a69d8ff5f) stream. + +### ObProj + +The existence of the **ObProj** record specifies that there is a [**VBA project**](#gt_980e3334-2874-4425-a73a-f2235cec1e1e) in the file. This project is located in the [VBA storage](#Section_27d93f33eaa941d49ec07f2a69d8ff5f) stream. + +### OleDbConn + +The **OleDbConn** record specifies the connection information for an [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) [**connection string**](#gt_03a9d0ca-2f10-4f3d-b910-052714a96f7d), and specifies the beginning of a collection of [ExtString](#extstring) records as defined by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of ExtString records specifies the connection string for a [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) that retrieves [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e). + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x080A. + +**A - fPasswd (1 bit):** A bit that specifies whether the connection password is present in the connection string. A value of 1 specifies that the password was stripped from the connection string. + +**B - fLocal (1 bit):** A bit that specifies whether the connection string is the main connection string or an alternate connection string. See [ConnGrbitDbtOledb](#conngrbitdbtoledb) for more information. + +**reserved1 (14 bits):** MUST be zero, and MUST be ignored. + +**cst (2 bytes):** An unsigned integer that specifies the number of ExtString records that follow this record. MUST be greater than 0. If the value is 1, the connection string is specified by ExtString.**string**. If the value is greater than 1, the connection string is determined by concatenating each of the ExtString.**string** fields of the ExtString records that follow. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +### OleObjectSize + +The **OleObjectSize** record specifies the visible [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) when this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is displayed as an [**embedded object**](#gt_708607be-8655-416e-93f3-b434e9ecbd56) in another document. + +[TABLE] + +**unused (2 bytes):** Undefined and MUST be ignored. + +**ref (6 bytes):** A [RefU](#refu) structure that specifies the visible range of cells, if the workbook is an embedded object and the [**active sheet**](#gt_767d2df7-5efd-40a1-9e58-4b6a597cc389) is a [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615), a [**macro sheet**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491), or a [**dialog sheet**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8) as specified by the **itabCur** field of a [Window1](#window1) record. Otherwise, **ref** is undefined and MUST be ignored. + +### Palette + +The **Palette** record specifies a [**custom color palette**](#gt_c24c2bf1-b41b-4eae-92a5-fe10cca57e2e). + +[TABLE] + +**ccv (2 bytes):** A signed integer that specifies the number of colors in the **rgColor** array. The value MUST be 56. + +**rgColor (variable):** An array of [LongRGB](#longrgb) structures that specifies the colors of the [**color palette**](#gt_05879d13-b9e0-4333-b96d-63cc3433997e). The number of items in the array MUST be equal to the value specified in the **ccv** field. + +### Pane + +The **Pane** record specifies the position of [**frozen**](#gt_1e984b7c-9760-4832-88c8-798e30f845db) [**panes**](#gt_fa363a22-6c89-4829-86aa-09f939f40a54) or unfrozen panes in the window used to display the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**x (2 bytes):** An unsigned integer that specifies the horizontal position of the split in the pane. If the value of **fFrozenRt** in the preceding [Window2](#window2) record is 1, the value of **x** is measured in cells and MUST be less than or equal to 255. If the value of **fFrozenRt** in the preceding Window2 is 0, the value of **x** is measured in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382), and MUST be less than or equal to 32767. + +**y (2 bytes):** An unsigned integer that specifies the vertical position of the split in the pane. If the value of **fFrozenRt** in the preceding Window2 record is 1, the value of **y** is measured in cells. If the value of **fFrozenRt** in the preceding Window2 is 0, the value of **y** is measured in twips, and MUST be less than or equal to 32767. + +**rwTop (2 bytes):** An [RwU](#rwu) structure that specifies the topmost [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) row in the bottom pane. + +**colLeft (2 bytes):** A [ColU](#colu) structure that specifies the first visible [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) column in the [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) pane. + +**pnnAcct (1 byte):** A [PaneType](#panetype) enumeration that specifies the active pane. + +**reserved (1 byte):** MUST be zero, and MUST be ignored. + +### ParamQry + +The **ParamQry** record specifies the parameters for a [**parameterized query**](#gt_c68a3a26-317d-4a1d-9eff-c2630b53067c). + +[TABLE] + +**fixed (8 bytes):** A [PARAMQRY_Fixed](#paramqry_fixed) structure that specifies the type information of the parameters. + +**rgb (variable):** Variable type field that specifies a parameter for a parameterized query. The data type and meaning are specified in the following table: + +| Value of fixed.pbt | Value of fixed.grbit | Meaning | +|----|----|----| +| 0 | Any | **rgb** is an [SXString](#sxstring) followed by an unused byte. | +| 1 | 0x001 | **rgb** is an Xnum (section [2.5.342](#xnum)). | +| 1 | 0x002 | **rgb** is an SXString followed by an unused byte. | +| 1 | 0x800 | **rgb** is a 4-byte signed integer. | +| 2 | Any | **rgb** is an [FMSER_param](#parameterparsedformula) that specifies the cell reference containing the parameter. | + +### Password + +The **Password** record specifies the password verifier for the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) or [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). If this record exists in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1), then it is a password for the workbook. If this record exists in a [worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56), [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11), [macro sheet substream](#Section_0dddd943f77a4fc2bf92868acb4587f7), or [dialog sheet substream](#Section_da37feb48b9a462d87772a5fddd4866e), then it is a password for only that sheet. This record MUST exist for the workbook. A sheet has a password if and only if this record exists. + +[TABLE] + +**wPassword (2 bytes):** An unsigned integer that specifies the password verifier[\<100\>](#Appendix_A_100). See [Password Verifier Algorithm](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4) for more information. If the password is for a sheet, MUST NOT equal 0x0000. If **wPassword** is 0x0000 it means the workbook has no password. + +### PhoneticInfo + +The **PhoneticInfo** record specifies the default format for [**phonetic strings**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77) and the [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that have phonetic strings that are [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72). + +[TABLE] + +**phs (4 bytes):** A [Phs](#phs) structure that specifies the default format for phonetic strings on the sheet. When a phonetic string is entered into a cell that does not already contain a phonetic string, the default format is applied to the phonetic string. + +**sqref (variable):** An [SqRef](#sqref) structure that specifies the ranges of cells on the sheet that have phonetic strings that are visible. + +### PicF + +The **PicF** record specifies the layout of a picture that is attached to a picture-filled chart element. + +[TABLE] + +**ptyp (2 bytes):** An unsigned integer that specifies the picture layout. If this record is not located in the sequence of records that conform to the [SS](#chart-sheet-substream) rule, as specified by the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), then this field MUST be 0x0001. If this record is located in the sequence of records that conform to the SS rule, then this field MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0001 | Stretched. The picture is scaled to fit within the [**dimensions (2)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) of the filled areas of the chart element. | +| 0x0002 | Stacked. The pictures in the [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) are stacked on top of each other in the direction of the value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). | +| 0x0003 | Stacked and scaled. The pictures in the data points are stacked next to or on top of each other, and each picture is scaled to fit in the number of units on the value axis as specified by **numScale**. | + +**unused (2 bytes):** Undefined and MUST be ignored. + +**reserved1 (9 bits):** MUST be zero, and MUST be ignored. + +**A - fTopBottom (1 bit):** A bit that specifies whether the picture covers the top and bottom fill areas of the data points. The top and bottom fill areas of the data points are parallel to the [**floor**](#gt_dc38c098-e0d3-4701-9656-5f2cf4d80f29) in a 3-D [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). If a [Chart3d](#chart3d) record does not exist in the chart sheet substream, or if this record is not in an SS rule or if this record is in an SS rule that contains a [Chart3DBarShape](#chart3dbarshape) record with the **riser** field equal to 0x01, this field MUST be 1. + +**B - fBackFront (1 bit):** A bit that specifies whether the picture covers the front and back fill areas of the data points on a bar or column [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). If a Chart3d record does not exist in the chart sheet substream, or if this record is not in an SS rule or if this record is in an SS rule that contains a Chart3DBarShape record with the **riser** field equal to 0x01, this field MUST be 1. + +**C - fSide (1 bit):** A bit that specifies whether the picture covers the side fill areas of the data points on a bar or column chart group. If a Chart3d record does not exist in the chart sheet substream, or if this record is not in an SS rule or if this record is in an SS rule that contains a Chart3DBarShape record with the **riser** field equal to 0x01, this field MUST be 1. + +**D - reserved2 (4 bits):** MUST be zero, and MUST be ignored. + +**numScale (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the number of units on the value axis in which to fit the entire picture. The picture is scaled to fit within this number of units. If the value of **ptyp** is not 0x0003, this field is undefined and MUST be ignored. + +### Pie + +The **Pie** record specifies that the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is a pie chart group or a doughnut chart group, and specifies the chart group attributes. + +[TABLE] + +**anStart (2 bytes):** An unsigned integer that specifies the starting angle of the first [data point](#Section_9c986ad250d44fa1a157063ac5c971a0), clockwise from the top of the circle. MUST be less than or equal to 360. + +**pcDonut (2 bytes):** An unsigned integer that specifies the size of the center hole in a doughnut chart group as a percentage of the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) size. MUST be a value from the following table: + +| Value | Meaning | +|----------|-----------------------| +| 0 | Pie chart group. | +| 10 to 90 | Doughnut chart group. | + +**A - fHasShadow (1 bit):** A bit that specifies whether one data point or more data points in the chart group have shadows. + +**B - fShowLdrLines (1 bit):** A bit that specifies whether the [**leader lines**](#gt_8b7c448e-82e3-4d22-a8ba-52e0a10b14fa) to the [data labels](#Section_cac7f43a3af142f58ff2814c2870427f) are shown. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +### PieFormat + +The **PieFormat** record specifies the distance of a [data point](#Section_9c986ad250d44fa1a157063ac5c971a0) or data points in a [series](#Section_527ce4dfc9f84e50a314d4b07519593c) from the center of one of the following: + +- The [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) for a doughnut or pie [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). + +- The [**primary pie**](#gt_e2300016-b59d-4384-9b70-c000523747e0) in a pie of pie or bar of pie chart group. + +- The [**secondary bar/pie**](#gt_e452a278-4e13-44c6-9f1b-db3c93841bc6) of a pie of pie chart group. + +The data point or data points in a series are specified by the sequence of records that conforms to the [SS](#chart-sheet-substream) rule in the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that contains this record. + +MUST NOT exist on chart group types other than pie, doughnut, bar of pie, or pie of pie. MUST NOT exist if the chart group type is doughnut and the series is not the outermost series. MUST NOT exist on the data points on the secondary bar/pie of a bar of pie chart group. + +[TABLE] + +**pcExplode (2 bytes):** A signed integer that specifies the distance of a data point or data points in a series from the center of one of the following: + +- The plot area for a doughnut or pie chart group. + +- The primary pie in a pie of pie or bar of pie chart group. + +- The secondary bar/pie of a pie of pie chart group. + +The value of this field specifies the distance as a percentage. If this value is 0, then the data point or data points in a series is as close to the center as possible for the particular chart group type. If this value is 100, then the data point is at the edge of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)). If this value is greater than 100, such that the data point is beyond the edge of the chart area, then all the data points in the chart group are scaled down to fit inside the chart area such that the data point with the highest **pcExplode** value is at the edge of the chart area . + +MUST be greater than or equal to 0. + +### PivotChartBits + +The **PivotChartBits** record specifies the flags applicable to a [Pivot Chart](#Section_bed5fbd356f54997bb54b49f04e734b7). + +[TABLE] + +**rt (2 bytes):** An unsigned integer that specifies the [FRT](#Section_b660b67822684414839ed1ae9a4e4e85) record type. MUST be 0x0859. + +**unused1 (2 bytes):** Undefined, and MUST be ignored. + +**A - fGXHide (1 bit):** A bit that specifies whether to hide the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) captions in the Pivot Chart. + +**unused2 (15 bits):** Undefined, and MUST be ignored. + +**reserved1 (2 bytes):** This field SHOULD[\<101\>](#Appendix_A_101) exist. If this field exists, this value MUST be 0x0000, and MUST be ignored. + +**reserved2 (2 bytes):** This field SHOULD[\<102\>](#Appendix_A_102) exist. If this field exists, this value MUST be 0x0000, and MUST be ignored. + +**reserved3 (2 bytes):** This field SHOULD[\<103\>](#Appendix_A_103) exist. If this field exists, this value MUST be 0x0000, and MUST be ignored. + +### PlotArea + +The **PlotArea** record is empty, specifying that the [Frame](#frame) record that immediately follows this record specifies properties of the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). + +### PlotGrowth + +The **PlotGrowth** record specifies the scale factors to use when calculating the [**font scaling**](#gt_47254269-4165-4a8c-92a0-c920f732d0bd) information for a [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) in the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). If no [Fbi](#fbi) record exists in the [chart sheet](#Section_2c90d75bc92645aa8ff29d4483f51831) where **scab** is 0x0001, this record is unused and MUST be ignored. Otherwise, the values from each Fbi record where **scab** is 0x0001 are used in conjunction with values in this record to render the scaled fonts in the plot area. + +[TABLE] + +**dxPlotGrowth (4 bytes):** A **FixedPoint** as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.6 that specifies the horizontal growth (in [**points**](#gt_d072e4da-7898-4227-8f25-9fe77db43571)) of the plot area for font scaling. + +**dyPlotGrowth (4 bytes):** A **FixedPoint** as specified in \[MS-OSHARED\] section 2.2.1.6 that specifies the vertical growth (in points) of the plot area for font scaling. + +### Pls + +The **Pls** record specifies printer settings and the printer driver information. + +[TABLE] + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**rgb (variable):** A **DEVMODE** structure, as defined in [\[DEVMODE\]](https://go.microsoft.com/fwlink/?LinkId=89844), which specifies the printer settings. The size of this field is equal to the size of the current record and all of the following [Continue](#continue) records, excluding the record's heading and **reserved** field. + +### PLV + +The **PLV** record specifies the settings of a [**Page Layout view**](#gt_c5ea3e6c-db72-4a85-b273-596e95a3841e) for a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x088B. + +**wScalePLV (2 bytes):** An unsigned integer that specifies zoom scale as a percentage for the Page Layout view of the current sheet. For example, if the value is 107, then the zoom scale is 107%. The value 0 means that the zoom scale is not set. If the value is nonzero, it MUST be greater than or equal to 10 and less than or equal to 400. + +**A - fPageLayoutView (1 bit):** A bit that specifies whether the sheet is in the Page Layout view. If the **fSLV** in [**Window2**](#window2) record is 1 for this sheet, it MUST be 0. + +**B - fRulerVisible (1 bit):** A bit that specifies whether the application displays the [**ruler**](#gt_03895998-6780-4615-8795-0fda97bd6379). + +**C - fWhitespaceHidden (1 bit):** A bit that specifies whether the margins between pages are [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) in the Page Layout view. + +**unused (13 bits):** Undefined, and MUST be ignored. + +### Pos + +The **Pos** record specifies the size and position for a [legend](#Section_1832229b7d1945f488d455e9c07466f0), an [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a), or the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c), as specified by the primary [axis group](#Section_578b739742624944b5a67ee6d4d3bb55). This record MUST be ignored for the plot area when the **fManPlotArea** field of [ShtProps](#shtprops) in the associated [chart sheet](#chart-sheet-substream) substream is set to 1. + +[TABLE] + +**mdTopLt (2 bytes):** A [PositionMode](#positionmode) structure that specifies the positioning mode for the upper-left corner of a legend, an attached label, or the plot area. The valid combinations of **mdTopLt** and **mdBotRt** and the meaning of **x1**, **y1**, **x2**, **y2** are specified in the **Valid Combinations of mdTopLt and mdBotRt by Type** table. + +**mdBotRt (2 bytes):** A PositionMode structure that specifies the positioning mode for the lower-right corner of a legend, an attached label, or the plot area. The valid combinations of **mdTopLt** and **mdBotRt** and the meaning of **x1**, **y1**, **x2**, **y2** are specified in the following table. + +[TABLE] + +The following table shows the meaning of x1 and y1 as specified by the type of attached label. + +[TABLE] + +**x1 (2 bytes):** A signed integer that specifies a position. The meaning is specified in the earlier table showing the valid combinations **mdTopLt** and **mdBotRt** by type. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**y1 (2 bytes):** A signed integer that specifies a position. The meaning is specified in the earlier table showing the valid combinations **mdTopLt** and **mdBotRt** by type. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**x2 (2 bytes):** A signed integer that specifies a width. The meaning is specified in the earlier table showing the valid combinations **mdTopLt** and **mdBotRt** by type. + +**unused3 (2 bytes):** Undefined and MUST be ignored. + +**y2 (2 bytes):** A signed integer that specifies a height. The meaning is specified in the earlier table showing the valid combinations **mdTopLt** and **mdBotRt** by type. + +**unused4 (2 bytes):** Undefined and MUST be ignored. + +### PrintGrid + +The **PrintGrid** record specifies whether the [**gridlines**](#gt_82f8a326-64b0-4506-a18e-930f7c2c95b9) are printed. + +[TABLE] + +**A - fPrintGrid (1 bit):** A bit that specifies whether the gridlines are printed. + +**unused (15 bits):** Undefined, and MUST be ignored. + +### PrintRowCol + +The **PrintRowCol** record specifies whether the row and column headers are printed. + +[TABLE] + +**printRwCol (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the row and column headers are printed. MUST be a value from the following table: + +| **Value** | **Meaning** | +|:----------|:----------------------------------------| +| 0x0000 | Row and column headers are not printed. | +| 0x0001 | Row and column headers are not printed. | + +### PrintSize + +The **PrintSize** record specifies the printed size of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). This record affects the charts printed only on their own page. + +[TABLE] + +**printSize (2 bytes):** An unsigned integer that specifies the printed size of the chart. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The record is part of a [UserSViewBegin](#usersviewbegin) block and the [**print settings**](#gt_6ef7745e-6602-4ff5-a8b0-9b9fd9f95b4a) are unchanged from the defaults specified in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). | +| 0x0001 | The chart is resized to fill the entire page regardless of the original chart proportions, within page margins. | +| 0x0002 | The chart is resized proportionally to fill the entire page, within page margins. | +| 0x0003 | The printed size of the chart is defined in the [Chart](#chart-2) record. | + +### Prot4Rev + +The **Prot4Rev** record specifies whether removal of the [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc)'s [revision logs](#Section_2cbd26e86f7e4195ada414c8b7e595b8) is disallowed. + +[TABLE] + +**fRevLock (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether removal of the shared workbook's revision logs is disallowed. The value MUST be one of the values specified in the following table: + +| Value | Meaning | +|--------|---------------------------------------------------------------| +| 0x0000 | Removal of the shared workbook's revision logs is allowed. | +| 0x0001 | Removal of the shared workbook's revision logs is disallowed. | + +### Prot4RevPass + +The **Prot4RevPass** record specifies the password verifier that is required to change the value of the **fRevLock** field of the [Prot4Rev](#prot4rev) record that immediately precedes this record. + +[TABLE] + +**protPwdRev (2 bytes):** An unsigned integer that specifies the password verifier that is required to change the value of the **fRevLock** field of the Prot4Rev record that immediately precedes this record[\<104\>](#Appendix_A_104). The algorithm to generate the password verifier is documented in the [password verifier algorithm](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4). If the value is 0, there is no password. MUST be 0 if the **fRevLock** field of Prot4Rev is 0x0000. + +### Protect + +The **Protect** record specifies the [**protection**](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499) state for the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) or [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). If this record exists in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1), then the protection state specified in this record applies to the workbook. If this record exists in a [worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56), [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11), [macro sheet substream](#Section_0dddd943f77a4fc2bf92868acb4587f7), or [dialog sheet substream](#Section_da37feb48b9a462d87772a5fddd4866e), then the protection state specified in this record applies to only that sheet. This record MUST exist for the workbook. For a sheet, the sheet is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829) if and only if this record exists. + +[TABLE] + +**fLock (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the sheet or workbook is protected. For a sheet, **fLock** MUST be 0x0001, and it means the sheet is protected. For the workbook, it MUST be a value from the following table: + +| Value | Meaning | +|--------|--------------------------------| +| 0x0000 | The workbook is not protected. | +| 0x0001 | The workbook is protected. | + +### Qsi + +The **Qsi** record specifies properties for a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289), and specifies the beginning of a collection of records as defined by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies additional information for the query table. + +[TABLE] + +**A - fTitles (1 bit):** A bit that specifies whether the first row of the query table contains column titles. + +**B - fRowNums (1 bit):** A bit that specifies whether the first column of the query table displays row numbers. + +**C - fDisableRefresh (1 bit):** A bit that specifies whether the query table can be refreshed. + +| Value | Meaning | +|-------|--------------------------------------| +| 0 | The query table can be refreshed. | +| 1 | The query table cannot be refreshed. | + +**D - fAsync (1 bit):** A bit that specifies whether the query table refreshes data asynchronously. MUST be set to 1 if **fNewAsync** field is set to1. + +**E - fNewAsync (1 bit):** A bit that specifies whether data has been refreshed for this query table. MUST be set to 0 if **fAsync** field is set to 0. + +| Value | Meaning | +|----|----| +| 0 | The first background data [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) was finished at the time the file was saved. | +| 1 | The first background data refresh was not finished at the time the file was saved. | + +**F - fAutoRefresh (1 bit):** A bit that specifies whether the query table refreshes its data automatically when the document is opened. + +**G - fShrink (1 bit):** A bit that specifies the behavior when dealing with a variable number of rows of data in the query table between refresh operations. If **fOverwrite** is 1, this value MUST be 0. MUST be one of the following. + +| Value | Meaning | +|----|----| +| 0 | Unused [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) are to be cleared. | +| 1 | Unused cells are to be deleted | + +**H - fFill (1 bit):** A bit that specifies whether formulas in columns adjacent to the query table are filled down whenever the query table is refreshed. + +**I - fAutoFormat (1 bit):** A bit that is unused and SHOULD be set to zero[\<105\>](#Appendix_A_105). + +**J - fSaveData (1 bit):** A bit that specifies whether the query table preserves all of its data in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) when the document is saved. MUST be one of the following: + +| Value | Meaning | +|:-----:|-------------------------------------------| +| 0x0 | Data in the query table will not be saved | +| 0x1 | Data in the query table will be saved | + +**K - fDisableEdit (1 bit):** A bit that specifies whether the content used with this query table is editable. + +| Value | Meaning | +|-------|-------------------------------------------------------------------| +| 0 | Content is editable | +| 1 | Content is [**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81) | + +**L - unused1 (2 bits):** Undefined and MUST be ignored. + +**M - fOverwrite (1 bit):** A bit that specifies the behavior when dealing with a variable number of rows of data in the query table between refresh operations. If **fShrink** is 1, this value MUST be 0. MUST be one of the following. + +| Value | Meaning | +|-------|---------------------------------------| +| 0 | Insert new cells for new data | +| 1 | Overwrite existing cells for new data | + +**N - unused2 (2 bits):** Undefined and MUST be ignored. + +**itblAutoFmt (2 bytes):** An [AutoFmt8](#autofmt8) that specifies the [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f) to be applied to the query table. MUST be less than or equal to 0x0014. + +**O - fibitAtrNum (1 bit):** A bit that specifies whether numeric cell data is formatted according to the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) specified in **itblAutoFmt** field. + +**P - fibitAtrFnt (1 bit):** A bit that specifies whether cell text is formatted according to the style specified in **itblAutoFmt** field. + +**Q - fibitAtrAlc (1 bit):** A bit that specifies whether cell text alignment is set according to the style specified in **itblAutoFmt** field. + +**R - fibitAtrBdr (1 bit):** A bit that specifies whether [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) is set according to the style specified in **itblAutoFmt** field. + +**S - fibitAtrPat (1 bit):** A bit that specifies whether the pattern is formatted according to the style specified in **itblAutoFmt** field. + +**T - fibitAtrProt (1 bit):** A bit that specifies whether the cell is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829) according to the style specified in **itblAutoFmt** field. + +**unused3 (10 bits):** Undefined and MUST be ignored. + +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +**rgchName (variable):** A [XLUnicodeString](#xlunicodestring) string that specifies the name of the query table. The number of characters in this array MUST be less than 0x00FF. Within this [workbook](#Section_f682f4b08c6b444e83f852d156f1e8ba), there MUST be a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) as specified by an [Lbl](#lbl) record with its **fHidden** field equal to 1 and its **Name** field matching this field’s value and the **rgce** field only containing a [PtgArea3d](#ptgarea3d) referencing the range of cells for the query table fields. Spaces within **rgchName** are converted to underscores for the purposes of this comparison. + +**unused4 (2 bytes):** Undefined and MUST be ignored. + +### Qsif + +The **Qsif** record specifies the properties for a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) field. One Qsif record is stored for each query table field. + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0807. + +**A - fUserIns (1 bit):** A bit that specifies whether this column was inserted into the query table. + +| Value | Meaning | +|----|----| +| 0 | The column is from the [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) source. | +| 1 | The column was inserted into the query table and is not from the external data source. | + +**B - fFillDown (1 bit):** A bit that specifies whether the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in this query table field is filled down on data [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060). + +**C - fSortDes (1 bit):** A bit that specifies whether this query table field is sorted in [**descending order**](#gt_f6de77a5-8743-4d03-813a-fa5e4d7c9fe8) if it is included as part of a [**sort range**](#gt_9d8dbd94-ffa2-47fc-a60b-3ffdad40d90e). + +**iSortKey (8 bits):** An unsigned integer that specifies the position of this query table field in the sort range. MUST be a value from the following table: + +| Value | Axis Description | +|----|----| +| 0 | This query table field does not contain [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880) criteria. | +| 1 | This query table field contains sort criteria for the first sort key as specified in the [Sort](#sort) record. | +| 2 | This query table field contains sort criteria for the second sort key as specified in the Sort record. | +| 3 | This query table field contains sort criteria for the third sort key as specified in the Sort record. | + +**D - fRowNums (1 bit):** A bit that specifies whether this query table field contains the row numbers for the data from the external data source. + +**E - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**F - fSorted (1 bit):** A bit that specifies whether this query table field is part of a sort range. + +**G - reserved2 (2 bits):** MUST be zero, and MUST be ignored. + +**H - fClipped (1 bit):** A bit that specifies whether this query table field is currently outside the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) bounds as specified in the [cell table](#Section_d690007dd25c4822a650b24c13288bb7). If the **fUserIns** field is set to 1, this field MUST be set to 0. + +**reserved3 (15 bits):** MUST be zero, and MUST be ignored. + +**idField (4 bytes):** An unsigned integer that specifies a unique identifier of this query table field in the query table. MUST be greater than or equal to 0x0001 and less than or equal to 0xFFFF. + +**idList (4 bytes):** An optional unsigned integer that specifies the value corresponding to the **idList** field of the [TableFeatureType](#tablefeaturetype) structure that is linked with this query table. This field exists only if the **verLastXLSaved** field of the [BOF](#bof) records is greater than or equal to 0x4. + +**rgbTitle (variable):** An [XLUnicodeString](#xlunicodestring) string that specifies the name of the query table field. The length of the query table field MUST less than or equal to 0x00FF. + +### Qsir + +The **Qsir** record specifies the properties related to the formatting of a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289), and specifies the beginning of a collection of [Qsif](#qsif) records as defined by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of Qsif records specifies properties for a query table field. + +One Qsir record is stored for each query table + +[TABLE] + +**frtRefHeaderU (12 bytes):** An [FrtRefHeaderU](#frtrefheaderu) structure. The **frtRefHeaderU.rt** field MUST be 0x0806. The **frtRefHeaderU.grbitFrt.fFrtRef** field MUST be 1 and the **frtRefHeaderU.ref8** field MUST refer to the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with this record. + +**cbQsirSaved (2 bytes):** An unsigned integer that specifies the number of bytes in the Qsir record excluding the **frtRefHeaderU** , **cbQsirSaved**, and **cbQsifSaved** fields. + +**cbQsifSaved (2 bytes):** An unsigned integer that specifies the size in bytes of each Qsif record that follows this Qsir record. This value MUST be less than the difference between the size in bytes for the Qsif record and the size in bytes of the **frtHeaderOld** field in the same record. + +**A - fPersist (1 bit):** A bit that specifies whether sorting, filtering, and layout is preserved for this query table after data [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) operations. + +**B - fPersistSort (1 bit):** A bit that specifies whether the sorting is preserved for this query table after data refresh operations. MUST be equal to **fPersist**. + +**C - fPersistAutoFilter (1 bit):** A bit that specifies whether [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) is preserved for this query table after data refresh operations. MUST be equal to **fPersist**. + +**reserved1 (16 bits):** MUST be zero, and MUST be ignored. + +**D - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**E - fSorted (1 bit):** A bit that specifies whether a [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880) was applied for this query table. + +**F - fCaseSensSort (1 bit):** A bit that specifies whether the sort on the query table is case-sensitive. + +**G - fHdrRowSort (1 bit):** A bit that specifies whether the query table sort accounted for a [**header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38). + +**H - fidWrapped (1 bit):** A bit that specifies whether the **idFieldNext** field value has exceeded its upper-bound value (0xFFFF). + +**I - reserved3 (1 bit):** MUST be zero, and MUST be ignored. + +**J - fTitlesOld (1 bit):** A bit that specifies whether the query table had titles the last time it was refreshed. + +**wVerBeforeRefreshAlert (5 bits):** An unsigned integer that specifies the oldest version of the application that is expected to correctly refresh the data in the query table without any errors. MUST be less than or equal to 0x000C. The application version is a value specified in the following table: + +| Value | Application Version | +|--------|--------------------------------------------------------------| +| 0x0008 | Specifies the application version.[\<106\>](#Appendix_A_106) | +| 0x0009 | Specifies the application version.[\<107\>](#Appendix_A_107) | +| 0x000A | Specifies the application version.[\<108\>](#Appendix_A_108) | +| 0x000B | Specifies the application version.[\<109\>](#Appendix_A_109) | +| 0x000C | Specifies the application version.[\<110\>](#Appendix_A_110) | +| 0x000E | Specifies the application version.[\<111\>](#Appendix_A_111) | +| 0x000F | Specifies the application version.[\<112\>](#Appendix_A_112) | + +**K - reserved4 (1 bit):** MUST be zero, and MUST be ignored. + +**iSortCustom (4 bytes):** An unsigned integer that specifies the zero-based index of the [**custom list**](#gt_92d2bb3a-2615-4bf8-b87f-887302d4c40c) that specifies the [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7). The set of custom lists is based on the current user's environment. + +**cQsif (4 bytes):** An unsigned integer that specifies the count of Qsif records that immediately follow this Qsir record. + +**cpstDeleted (4 bytes):** An unsigned integer that specifies the number of elements in the **rgbTitle** array. + +**idFieldNext (4 bytes):** An unsigned integer that specifies the next unique number available for assignment to a newly created Qsif record. MUST be greater than or equal to 0x0001 and less than or equal to 0xFFFF. + +**ccolExtraLeft (2 bytes):** A [DCol](#dcol) structure that specifies the number of columns that do not contain [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) that are included at the beginning of the query table by resizing. When a sort is applied to the query table, they are also applied to these columns. + +**ccolExtraRight (2 bytes):** A DCol structure that specifies the number of columns that do not contain external data that are included at the end of the query table by resizing. When a sort is applied to the query table, they are also applied to these columns. + +**idList (4 bytes):** An optional unsigned integer that specifies the value corresponding to the **idList** field of the [TableFeatureType](#tablefeaturetype) structure that is linked with this query table. This field exists only if the **verLastXLSaved** field of the [BOF](#bof) record is greater than or equal to 0x3. + +**rgbTitle (variable):** An array of [XLUnicodeString](#xlunicodestring) structures. This array specifies the names of the database fields in the database [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) that are not included in the query table. The number of elements in this array MUST be equal to the value of the **cpstDeleted** field. The count of characters in each name MUST be greater than or equal to 0x0001 and less than or equal to 0x00FF. + +### QsiSXTag + +The **QsiSXTag** record specifies the name and [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) information for a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) or a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), and specifies the beginning of a collection of records as defined by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies additional information for a query table or a PivotTable view. + +If **fSx** is 0 and **stName** is equal to the **rgchName** field of a [Qsi](#qsi) record in this worksheet substream, then this collection of records applies to the query table that the Qsi record is associated with. If **fSx** is 1 and **stName** is equal to the **stName** field of an [SxView](#sxview) record in this worksheet substream, then this collection of records applies to the PivotTable view that the SxView record is associated with and its [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4). Otherwise, this collection of records MUST be ignored. + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0802. + +**fSx (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether this record relates to a PivotTable view or a query table. + +| Value | Meaning | +|--------|----------------------------------------------------------| +| 0x0000 | Specifies that this record relates to a query table. | +| 0x0001 | Specifies that this record relates to a PivotTable view. | + +**A - fEnableRefresh (1 bit):** A bit that specifies whether refresh of the PivotTable view or query table is enabled. MUST be 0 if **fSx** is 1 and the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated PivotCache is greater than or equal to 3. + +| Value | Value of fSx | Meaning | +|----|----|----| +| 0 | 0 | Whether refresh of the query table is enabled is specified by the fDisableRefresh field of the associated Qsi record. | +| 0 | 1 | Whether refresh of the associated PivotCache is enabled is specified by the fEnableRefresh field in the [SXDB](#sxdb) record of the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). | +| 1 | 0 | Specifies that refresh of the query table is enabled. | +| 1 | 1 | Specifies that refresh of the associated PivotCache is enabled. | + +**B - fInvalid (1 bit):** A bit that specifies the invalid state of the [cache records](#Section_fe6e4ca0a9b646a4898124e4b61a770a) of the associated PivotCache; see Cache Records for more information. MUST be 1 if **fSx** is 1 and the PivotCache functionality level of the associated PivotCache is greater than or equal to 3. + +**C - fTensorEx (1 bit):** A bit that specifies whether the PivotTable view is an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f). MUST be equal to 0 if fSx is 0. + +**reserved1 (13 bits):** MUST be zero, and MUST be ignored. + +**dwQsiFuture (4 bytes):** This structure specifies additional option flags for a query table or a PivotTable view depending on the value of the **fSx** field. + +| Value of fSx Field | Type of dwQsiFuture | +|--------------------|-----------------------------| +| 0x0000 | [DwQsiFuture](#dwqsifuture) | +| 0x0001 | [SXView9Save](#sxview9save) | + +**verSxLastUpdated (1 byte):** A [DataFunctionalityLevel](#datafunctionalitylevel) value that specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) that the PivotTable view was last refreshed with. MUST be 0 if this record relates to a query table. + +**verSxUpdatableMin (1 byte):** A DataFunctionalityLevel value that specifies the minimum version of the application that can recalculate the PivotTable view. MUST be 0x00 or 0x03. MUST be 0 if this record is for a query table. MUST be 3 if the PivotCache functionality level of the associated PivotCache is 3. + +**obCchName (1 byte):** MUST be 0x10, and MUST be ignored. + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +**stName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the query table or PivotTable view name. + +**unused (2 bytes):** Undefined and MUST be ignored. + +### Radar + +The **Radar** record specifies that the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is a radar chart group and specifies the chart group attributes. + +[TABLE] + +**A - fRdrAxLab (1 bit):** A bit that specifies whether [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) labels are displayed. + +**B - fHasShadow (1 bit):** A bit that specifies whether one or more [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) in the chart group has shadows. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +**unused (2 bytes):** Undefined and MUST be ignored. + +### RadarArea + +The **RadarArea** record specifies that the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is a filled radar chart group and specifies the chart group attributes. + +[TABLE] + +**A - fRdrAxLab (1 bit):** A bit that specifies whether [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) labels are displayed. + +**B - fHasShadow (1 bit):** A bit that specifies whether the [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) in the chart group have shadows. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +**unused (2 bytes):** Undefined and MUST be ignored. + +### RealTimeData + +The **RealTimeData** record specifies the [**real-time data (RTD)**](#gt_1e71aa16-cd0f-4271-b57d-1fd99d8740b6) information for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +There is one RealTimeData record for each [**RTD topic**](#gt_1b5b3428-25ab-4aa9-bbee-c1c147ece9de) in the workbook. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0813. + +**ichSamePrefix (4 bytes):** An unsigned integer that specifies the number of leading characters in common with the **stTopic** string in the previous RealTimeData record. MUST be 0 if there is no prefix in common or if this is the first RealTimeData record. + +**stTopic (variable):** An [XLUnicodeStringSegmentedRTD](#xlunicodestringsegmentedrtd) structure that specifies the string for the RTD topic specified by this record. The string can be stored in a compressed or uncompressed format. When **ichSamePrefix** is greater than 0, this string does not include any leading characters that are in common with the **stTopic** string in the previous RealTimeData record. The first substring specifies the [**ProgID**](#gt_06b2ae3d-4106-49f3-9ca0-e2bcd649e75a) of the [**RTD server**](#gt_d4fc2cb5-c030-4ce4-9078-69627d562fc7). The second substring specifies the [**server name**](#gt_854f54be-1a9d-40d2-82e5-55cf9e48e2c2) that the RTD server is running on or, if this substring is empty, specifies that the RTD server is running locally. The rest of the substrings are combined to form a unique RTD topic. + +**rtdOper (variable):** An [RTDOper](#rtdoper) structure that specifies the data returned by the RTD server. + +**rgRTDE (variable):** An array of [RTDEItem](#rtdeitem) structures that specifies the set of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with the RTD topic. The length of the array is specified by the following formula: + +Array length = (size of this record and associated [ContinueFrt](#continuefrt) records - 16 - size of **stTopic** – size of **rtdOper**) / 6 + +### RecalcId + +The **RecalcId** record specifies the identifier of the recalculation engine that performed the last recalculation. + +[TABLE] + +**rt (2 bytes):** An unsigned integer that specifies the record identifier. MUST be 449. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**dwBuild (4 bytes):** An unsigned integer that specifies the identifier of the recalculation engine that performed the last recalculation. If the value is less than the recalculation engine identifier associated with the application, the application will [**recalculate**](#gt_74366612-1dc4-4e8f-8e1a-d833b829f0c3) the results of all formulas on this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) immediately after loading the file. + +### RecipName + +The **RecipName** record specifies information about a recipient of a [**routing slip**](#gt_8cedfe36-260c-416e-aeab-7fee4bdef9c3)[\<113\>](#Appendix_A_113). + +[TABLE] + +**cchRecip (2 bytes):** An unsigned integer that specifies the count of characters in the **szFriendly** field string. MUST be less than or equal to 256. + +**ulEIDSize (4 bytes):** An unsigned integer that specifies the count of characters in the **rgchSSAddr** field string. + +**szFriendly (variable):** A NULL-terminated array of ANSI characters that specifies the recipient's [**friendly name**](#gt_3dafc161-8c9d-406a-8cbd-c61e7f925eea). The length of the string MUST be specified by the **cchRecip** field. + +**rgchSSAddr (variable):** An array of ANSI characters whose length is specified by the **ulEIDSize** field that specifies the identifier used by the [**messaging system service provider**](#gt_ff288e35-3b60-4a5e-99d6-faa6afa8009a) to identify the recipient. + +### RefreshAll + +The **RefreshAll** record specifies whether [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) ranges, [PivotTables](#Section_a5f57198f2af40b2ba07e4b1836d73f3) and [**XML maps**](#gt_01b93f1f-ca62-4216-82d5-b6154e925c9f) will be refreshed on [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) load. + +[TABLE] + +**refreshAll (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether to force [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) of external data ranges, PivotTables and XML maps on workbook load. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0001 | Force refresh of external data ranges, PivotTables and XML maps on workbook load. | +| 0x0000 | Do not force refresh of external data ranges, PivotTables and XML maps on workbook load. | + +MUST be 0x0000 if workbook is not a [**template**](#gt_159ca22f-c24d-4c6d-b08a-3d4c4c923953). + +### RichTextStream + +The **RichTextStream** record specifies additional text properties for the text in the entire [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), text in the current [legend](#Section_1832229b7d1945f488d455e9c07466f0), text in the current [**legend entry**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e), or text in the [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a). These text properties are a superset of the properties stored in the [Text](#text), [Font](#font), [FontX](#fontx), [BRAI](#brai), and [ObjectLink](#objectlink) records based on the following table, as specified by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). In each case, the associated Font record is specified by the associated FontX record. [\<114\>](#Appendix_A_114) + +[TABLE] + +These Rich Text Format properties are stored in the **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)) specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, section 21.2.2.216. + +An application can choose to ignore this record without loss of functionality, but will lose access to the additional Rich Text Format properties. If an application chooses to implement this record, the application MUST implement the validation [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) specified by the **dwCheckSum** field. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x08A6. + +**dwCheckSum (4 bytes):** An unsigned integer that specifies the checksum of the attributes of the Rich Text Format properties related to this record. The algorithm used to calculate the checksum is specified by [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.4.3.2. The checksum MUST be calculated from every property of the [**property stream**](#gt_dbd8bc67-1371-445e-af6a-dfa5eeef670c), taken as an array of bytes as specified by the [RichTextStreamChecksumData](#richtextstreamchecksumdata) structure. + +The information required to build the memory stream can be gathered from the Text, FontX, Font, BRAI, and ObjectLink records associated with this record, as previously specified. + +When reading this record, the checksum is calculated as previously specified and compared to the **dwCheckSum** value stored in this record. If the calculated checksum does not match the **dwCheckSum** data, the application MUST assume that the **XML stream** (section 2.1.7.22) is out of date, and the data from the associated records MUST be used instead of the data specified by the **XML stream** (section 2.1.7.22). + +**cb (4 bytes):** An unsigned integer that specifies the size of the **rgb** field. This field MUST contain the exact length in bytes of the **rgb** field. + +**rgb (variable):** An array of ANSI characters that contains the [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) representation of the text formatting properties, as defined in \[ECMA-376\] Part 1, section 21.2.2.216. The length of this field is specified by the **cb** field. + +### RightMargin + +The **RightMargin** record specifies the right margin of the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**num (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the right margin of the current sheet in inches. The value MUST be greater than or equal to 0 and less than or equal to 49. + +### RK + +The **RK** record specifies the numeric data contained in a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +[TABLE] + +**rw (2 bytes):** An [Rw](#rw) structure that specifies a row index. + +**col (2 bytes):** A [Col](#col) structure that specifies a column index. + +**rkrec (6 bytes):** An [RkRec](#rkrec) structure that specifies the numeric data for a single cell. + +### Row + +The **Row** record specifies a single row on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rw (2 bytes):** An [Rw](#rw) structure that specifies the row index. + +**colMic (2 bytes):** An unsigned integer that specifies the zero-based index of the first column that contains a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) populated with data or formatting in the current row. MUST be less than or equal to 255. + +**colMac (2 bytes):** An unsigned integer that specifies the one-based index of the last column that contains a cell populated with data or formatting in the current row. MUST be less than or equal to 256. If **colMac** is equal to **colMic**, this record specifies a row with no [CELL](#common-productions) records. + +**miyRw (2 bytes):** An unsigned integer that specifies the row height in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382). If **fDyZero** is 1, the row is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) and the value of **miyRw** specifies the original row height. MUST be greater than or equal to 2 and MUST be less than or equal to 8192. + +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**A - iOutLevel (3 bits):** An unsigned integer that specifies the [**outline level**](#gt_a5cd5eff-ddeb-490b-bc71-f6256774e3c3) of the row. + +**B - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fCollapsed (1 bit):** A bit that specifies whether the rows that are one level of outlining deeper than the current row are included in the [**collapsed outline state**](#gt_37d20510-d4a0-4fa6-9ff1-83d99d8f9262). + +**D - fDyZero (1 bit):** A bit that specifies whether the row is hidden. + +**E - fUnsynced (1 bit):** A bit that specifies whether the row height was manually set. + +**F - fGhostDirty (1 bit):** A bit that specifies whether the row was formatted. + +**reserved3 (1 byte):** MUST be 1, and MUST be ignored. + +**ixfe_val (12 bits):** An unsigned integer that specifies an [XF](#xf) record for the row formatting. See [IXFCell](#ixfcell) for more information. If **fGhostDirty** is 0, **ixfe_val** is undefined and MUST be ignored. + +**G - fExAsc (1 bit):** A bit that specifies whether any cell in the row has a thick top [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c), or any cell in the row directly above the current row has a thick bottom border. Thick borders are specified by the following enumeration values from [BorderStyle](#borderstyle): **THICK** and **DOUBLE**. + +**H - fExDes (1 bit):** A bit that specifies whether any cell in the row has a medium or thick bottom border, or any cell in the row directly below the current row has a medium or thick top border. Thick borders are previously specified. Medium borders are specified by the following enumeration values from BorderStyle: **MEDIUM**, **MEDIUMDASHED**, **MEDIUMDASHDOT**, **MEDIUMDASHDOTDOT**, and **SLANTDASHDOT**. + +**I - fPhonetic (1 bit):** A bit that specifies whether the [**phonetic guide**](#gt_f5ae2680-242d-4731-8f12-da90d5d7f09f) feature is enabled for any cell in this row. + +**J - unused2 (1 bit):** Undefined and MUST be ignored. + +### RRAutoFmt + +The **RRAutoFmt** record specifies the changes caused by [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f) actions in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + +[TABLE] + +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a shared workbook. The **rrd.revid** MUST be 0 because this is a [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) that cannot be reviewed. The **rrd.revt** MUST be equal to 0x000C. The **rrd.tabid** MUST NOT be 0xFFFF because this revision corresponds to a specific [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**ref8 (8 bytes):** A [Ref8U](#ref8u) structure that specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells affected by AutoFormat changes. + +**itbl (2 bytes):** An [AutoFmt8](#autofmt8) structure that specifies which AutoFormat was applied. + +**A - fApplyNumberFormats (1 bit):** A bit that specifies whether the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) properties contained in the AutoFormat specified by **itbl** were applied. + +**B - fApplyFontFormats (1 bit):** A bit that specifies whether the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) properties contained in the AutoFormat specified by **itbl** were applied. + +**C - fApplyAlignmentFormats (1 bit):** A bit that specifies whether the text alignment properties contained in the AutoFormat specified by **itbl** were applied. + +**D - fApplyBorderFormats (1 bit):** A bit that specifies whether the [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) properties contained in the AutoFormat specified by **itbl** were applied. + +**E - fApplyPatternFormats (1 bit):** A bit that specifies whether the color pattern properties contained in the AutoFormat specified by **itbl** were applied. + +**F - fApplyWidthHeightFormats (1 bit):** A bit that specifies whether the width or height properties contained in the AutoFormat specified by **itbl** were applied. + +**reserved (10 bits):** MUST be zero, and MUST be ignored. + +### RRDChgCell + +The **RRDChgCell** record specifies a [change cells revision](#Section_5184d2e269654093971afeb70ff736cb). + +[TABLE] + +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). Because this [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) corresponds to a specific [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d), **rrd**.**revt** MUST be 0x0008, **rrd**.**fDelAtEdgeOfSort** MUST be 0x0000, **rrd**.**revid** MUST be greater than or equal to 0, and **rrd**.**tabid** MUST NOT be 0xFFFF. + +**vt (3 bits):** An unsigned integer that specifies the type of the new [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) contents. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | New cell is blank. | +| 0x1 | New cell contains an [RkNumber](#rknumber) value. | +| 0x2 | New cell contains an Xnum (section [2.5.342](#xnum)) value. | +| 0x3 | New cell contains an [XLUnicodeRichExtendedString](#xlunicoderichextendedstring) value. | +| 0x4 | New cell contains a [Bes](#bes) value. | +| 0x5 | New cell contains a [CellParsedFormula](#cellparsedformula) value. | + +**vtOld (3 bits):** An unsigned integer that specifies the type of the old cell contents. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------------| +| 0x0 | Old cell is blank. | +| 0x1 | Old cell contains an RkNumber value. | +| 0x2 | Old cell contains an Xnum value. | +| 0x3 | Old cell contains an XLUnicodeRichExtendedString value. | +| 0x4 | Old cell contains a Bes value. | +| 0x5 | Old cell contains a CellParsedFormula value. | + +**A - f123Prefix (1 bit):** A bit that specifies whether prefix characters are present in the cell. Possible prefix characters include single quotation mark (0x27), double quotation mark (0x22), caret (0x5E), and backslash (0x5C). + +**B - unused (1 bit):** Undefined and MUST be ignored. + +**C - fOldFmt (1 bit):** A bit that specifies whether there is old formatting information available for this cell. If **fOldFmt** is 0x1 and **fOldFmtNull** is 0x0, **dxfOld** MUST exist. + +**D - fOldFmtNull (1 bit):** A bit that specifies whether the old formatting information is empty. This value MUST be ignored if **fOldFmt** is 0. If **fOldFmt** is 0x1 and **fOldFmtNull** is 0x0, **dxfOld** MUST exist. If **fOldFmt** is 0x1 and **fOldFmtNull** is 0x1, old formatting information is available for the cell, but the old formatting information is not written to disk and **dxfOld** MUST NOT exist. + +**E - fXfDxf (1 bit):** A bit that specifies that the affected cells will have their format reset to the format defined by the current [cell style](#Section_f9425d3f127545be8389bf80f65b56b7) before applying any format from **dxf**, if present. + +**F - fStyXfDxf (1 bit):** A bit that specifies that the format of the cell will be cleared before applying any format from **dxf**, if present. + +**G - fDxf (1 bit):** A bit that specifies whether there was a formatting change for this cell. If **fDxf** is 0x1 and **fDxfNull** is 0x0, **dxf** MUST exist. + +**H - fDxfNull (1 bit):** A bit that specifies whether the new formatting information is empty. This value MUST be ignored if **fDxf** is 0. If **fDxf** is 0x1 and **fDxfNull** is 0x0, **dxf** MUST exist. If **fDxf** is 0x1 and **fDxfNull** is 0x1, this means that there was a formatting change for this cell, but the **dxf** describing the formatting change MUST NOT exist. + +**I - reserved1 (2 bits):** MUST be zero, and MUST be ignored. + +**ifmtDisp (8 bits):** An unsigned integer that specifies the identifier of the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) to use to display the new cell contents. MUST be a value from the following table. For more information about how [**format strings**](#gt_07085e26-506a-4b35-81ad-972464e277ff) are interpreted, see [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1: Fundamentals And Markup Language Reference, section 18.8.31. + +| Value | Description | Positive Value Format | Negative Value Format | Zero Format | +|----|----|---:|---:|---:| +| 0x0000 | Automatic | 0 | -0 | 0 | +| 0x0004 | Number, two decimal places, use the 1000 separator (,) | \#,##0.00 | -#,##0.00 | 0.00 | +| 0x000B | Currency, two decimal places, use parentheses for negative values | \$#,##0.00 | (\$#,##0.00) | \$0.00 | +| 0x000D | Percentage, zero decimal places | 0% | -0% | 0% | +| 0x000E | Percentage, two decimal places | 0.00% | -0.00% | 0.00% | +| 0x000F | Scientific | 0.00E+00 | -0.00E+00 | 0.00E+00 | +| 0x0010 | Engineering | \##0.0E+0 | -##0.0E+0 | 0.0E+0 | +| 0x0011 | Fraction, up to one digit numerator and denominator | \# ?/? | -# ?/? | 0 | +| 0x0012 | Fraction, up to two digit numerator and denominator | \# ??/?? | -# ??/?? | 0 | +| 0x0013 | Date (MM-DD-YY) | mm-dd-yy | mm-dd-yy | | +| 0x0015 | Date (DD-MMM) | d-mmm | d-mmm | | +| 0x0017 | Time (H:MM AM/PM) | h:mm AM/PM | h:mm AM/PM | | +| 0x001B | Date/Time, 24 hour format (M/D/YY H:MM) | m/d/yy h:mm | m/d/yy h:mm | | +| 0x0022 | Accounting (currency with decimal point aligned, and centered minus-sign for 0-value), two decimal places, use currency symbol | \_(\$\* \#,##0.00\_) | \_(\$\* \#,##0.00) | \_(\$\* "-" ??\_) | + +**J - fPhShow (1 bit):** A bit that specifies whether the new cell contains a [**phonetic string**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77). + +**K - fPhShowOld (1 bit):** A bit that specifies whether the old cell contains a phonetic string. + +**L - fEOLFmlaUpdate (1 bit):** A bit that specifies whether the new cell contents were changed because of an adjustment to the formula. + +**reserved2 (5 bits):** MUST be zero, and MUST be ignored. + +**loc (4 bytes):** An [RgceLoc](#rgceloc) structure that specifies the location of the cell change revision. + +**cbOldVal (4 bytes):** An unsigned integer that specifies the size of the old cell contents. If **cbOldVal** is greater than 0, the old cell contents immediately follow the **cetxpRst** field, then it is followed by the new cell contents. MUST be a value from the following table based on the value of **vtOld**: + +| vtOld | cbOldVal | +|----|----| +| 0x0 | MUST be 0x00000000. | +| 0x1 | MUST be 0x00000004. | +| 0x2 | MUST be 0x00000008. | +| 0x3 | MUST be equal to the size of the old XLUnicodeRichExtendedString. The size is calculated assuming all characters are double-byte characters. That is, if XLUnicodeRichExtendedString.**fHighByte** is 1, the calculation is made by using the size of XLUnicodeRichExtendedString. | +| 0x4 | MUST be 0x00000002. | +| 0x5 | MUST be greater than or equal to 0x00000018. | + +**cetxpRst (2 bytes):** An unsigned integer that specifies the number of [RRDRstEtxp](#rrdrstetxp) records that follow this record. + +**dxfOld (variable):** A [DXFN](#dxfn) structure that specifies the [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6) for the old cell contents. This field MUST exist if **fOldFmt** is 0x1 and **fOldFmtNull** is 0x0. + +**dxf (variable):** A DXFN structure that specifies the differential formatting for the new cell contents. This field MUST exist if **fDxf** is 0x1 and **fDxfNull** is 0x0. + +**rkOld (4 bytes):** An RkNumber structure that specifies the old cell contents. This field MUST exist if and only if **cbOldVal** is greater than 0 and **vtOld** is 0x1. + +**numOld (8 bytes):** An Xnum value that specifies the old cell contents. This field MUST exist if and only if **cbOldVal** is greater than 0 and **vtOld** is 0x2. + +**stOld (variable):** An XLUnicodeRichExtendedString structure that specifies the old cell contents. This field MUST exist if and only if **cbOldVal** is greater than 0 and **vtOld** is 0x3. + +**besOld (2 bytes):** A Bes structure that specifies the old cell contents. This field MUST exist if and only if **cbOldVal** is greater than 0 and **vtOld** is 0x4. + +**xpeOld (variable):** A CellParsedFormula structure that specifies the old cell contents. This field MUST exist if and only if **cbOldVal** is greater than 0 and **vtOld** is 0x5. + +**rk (4 bytes):** An RkNumber value that specifies the new cell contents. This field MUST exist if and only if **vt** is 0x1. + +**num (8 bytes):** An Xnum value that specifies the new cell contents. This field MUST exist if and only if **vt** is 0x2. + +**st (variable):** An XLUnicodeRichExtendedString structure that specifies the new cell contents. This field MUST exist if and only if **vt** is 0x3. + +**bes (2 bytes):** A Bes structure that specifies the new cell contents. This field MUST exist if and only if **vt** is 0x4. + +**xpe (variable):** A CellParsedFormula structure that specifies the new cell contents. This field MUST exist if and only if **vt** is 0x5. + +### RRDConflict + +The **RRDConflict** record specifies the resolution of a conflict between the revisions of two uses'. + +[TABLE] + +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). The **rrd.revid** MUST be greater than 0. The **rrd.revid** identifies the [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) that won the conflict. The **rrd.revt** MUST be equal to [**revtConflict**](#revisiontype). + +### RRDDefName + +The **RRDDefName** record specifies a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) revision. + +[TABLE] + +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). The **revt** field of the RRD structure MUST be 0x000A or 0x0022. The **fDelAtEdgeOfSort** field of the RRD structure MUST be 0x0000. The **revid** field of the RRD structure MUST be greater than or equal to 0. + +**tabidLocal (2 bytes):** A [TabId](#tabid) structure that specifies the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing the defined name. A value of 0xFFFF specifies that the defined name is not a [**local name**](#gt_6f2787cc-ab35-4cc1-bebd-fb120864d320). + +**fViewName (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether the defined name belongs to a [**custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4). MUST be a value from the following table: + +| **Value** | **Meaning** | +|-----------|----------------------------------------------------| +| 0x00 | The defined name does not belong to a custom view. | +| 0x01 | The defined name belongs to a custom view. | + +**reserved (1 byte):** MUST be zero, and MUST be ignored. + +**grbit (6 bytes):** An [RRDDefNameFlags](#rrddefnameflags) structure that specifies data for the new defined name. + +**grbitOld (6 bytes):** An RRDDefNameFlags structure that specifies data for the old defined name. + +**builtinIndex (1 byte):** An unsigned integer that specifies the identifier of a built-in name. MUST be a value from the following table: + +| Identifier | Built-in Name | +|------------|---------------------| +| 0x00 | Not a built-in name | +| 0x01 | "Consolidate_Area" | +| 0x02 | "Auto_Open" | +| 0x03 | "Auto_Close" | +| 0x04 | "Extract" | +| 0x05 | "Database" | +| 0x09 | "Recorder" | +| 0x0A | "Data_Form" | +| 0x0B | "Auto_Activate" | +| 0x0C | "Auto_Deactivate" | +| 0x0D | "Sheet_Title" | + +**unused (3 bytes):** Optional, undefined, and MUST be ignored. MUST exist if and only if **builtinIndex** is not equal to 0. + +**stDefName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the defined name. MUST exist if and only if **builtinIndex** is equal to 0. MUST be less than or equal to 255 characters. MUST begin with a letter or underscore character. + +**pe (variable):** A [NameParsedFormula](#nameparsedformula) structure that specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) of the new defined name. The length of the formula in bytes is specified by **grbit**.**cce**. + +**stCustomMenu (variable):** An XLUnicodeString structure that specifies the new custom menu text. + +**stDescription (variable):** An XLUnicodeString structure that specifies the new description text. + +**stHelpTopic (variable):** An XLUnicodeString structure that specifies the new help text. + +**stStatusText (variable):** An XLUnicodeString structure that specifies the new status bar text. + +**peOld (variable):** A NameParsedFormula structure that specifies the formula of the old defined name. The length of the formula in bytes is specified by **grbitOld**.**cce**. + +**stCustomMenuOld (variable):** An XLUnicodeString structure that specifies the old custom menu text. + +**stDescriptionOld (variable):** An XLUnicodeString structure that specifies the old description text. + +**stHelpTopicOld (variable):** An XLUnicodeString structure that specifies the old help text. + +**stStatusTextOld (variable):** An XLUnicodeString structure that specifies the old status bar text. + +### RRDHead + +The **RRDHead** record specifies metadata about a set of revisions that a user has made in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + +[TABLE] + +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a shared workbook. The **rrd.revt** MUST be equal to 0x0020. The **rrd.cbMemory** MUST be equal to 0xFFFFFFFF and MUST be ignored. The **rrd.revid** MUST be 0 because this is a [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) that cannot be reviewed. + +**guid (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that specifies a unique identifier for this set of revisions. + +**wFileCodePage (2 bytes):** An unsigned integer that specifies the [**sheet's**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38). The value MUST be one of the code page values specified in [\[CODEPG\]](https://go.microsoft.com/fwlink/?LinkId=89840) or the special value 1200, which means that the sheet is [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8). + +**cchUser (2 bytes):** An unsigned integer that specifies the number of characters in **stUser** that are used to specify the name of the user who made this set of revisions. Characters in **stUser** that are to the right of these used characters are ignored. The value of **cchUser** MUST be less than or equal to 54. + +**stUser (114 bytes):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of the user who made this set of revisions. + +**sddtr (8 bytes):** A [ShortDTR](#shortdtr) structure that specifies the date and time when the user saved this set of revisions. + +**tabidMac (2 bytes):** A signed integer that specifies the next available sheet identifier in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The value MUST be greater than or equal to -1. Each sheet identifier is specified by the order in which the [BoundSheet8](#boundsheet8) records appear in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +### RRDInfo + +The **RRDInfo** record specifies information about a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + +[TABLE] + +**wXLVer (2 bytes):** An unsigned integer that specifies the major [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) version that was last used to save a shared workbook. + +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +**A - fssShared (1 bit):** A bit that specifies whether this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is a shared workbook. If this value is 1, **fssExclusive** MUST be equal to 0. + +**B - fssDiskHasRev (1 bit):** A bit that specifies whether the [**revision history**](#gt_3ff09b0f-14fb-44b7-bfc7-675c39a2da1e) on disk contains revisions. If this value is 1, **fssRevTrack** MUST be equal to 1. + +**C - fssRevHist (1 bit):** A bit that specifies whether revisions are automatically deleted. If this value is 1, **fssRevTrack** MUST be equal to 1. MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------------| +| 0 | Revisions are not automatically deleted. | +| 1 | Revisions are automatically deleted. | + +**D - fssRevTrack (1 bit):** A bit that specifies whether the revisions are being tracked. If this value is 1, **fssShared** MUST be equal to 1. + +**E - fssExclusive (1 bit):** A bit that specifies whether this workbook is in exclusive mode. Exclusive mode means the workbook was shared when revisions were made, but it is no longer shared. If this value is 1, **fssShared** MUST be equal to 0. + +**reserved2 (11 bits):** MUST be zero, and MUST be ignored. + +**guid (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that specifies the last set of revisions. MUST be 0, or MUST match the GUID for the most recent header. + +**guidRoot (16 bytes):** A GUID as specified by \[MS-DTYP\] that specifies the last set of revisions that was saved to the file. MUST be 0, or MUST match the GUID for one of the [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) headers. + +**revid (4 bytes):** A signed integer that specifies the current revision number of this shared workbook. This identifier is used to track the order of [revision records](#Section_9e91e8bce4f249b897d4741481349d1b). MUST be greater than or equal to 0. + +**version (4 bytes):** An unsigned integer that specifies the current version of this shared workbook. + +**F - fNoRevHist (1 bit):** A bit that specifies whether this workbook preserves revision history. If this value is 1, **wRevHistoryInterval** MUST be equal to 0 and **fssShared** MUST be equal to 1. If this value is 0, **wRevHistoryInterval** MUST be greater than or equal to 1. + +**G - fProtRev (1 bit):** A bit that specifies whether the revision history is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829) for this shared workbook. If this value is 1, **fssShared** MUST be equal to 1. + +**reserved3 (14 bits):** MUST be zero, and MUST be ignored. + +**wRevHistoryInterval (2 bytes):** An unsigned integer that specifies the number of days for which the revision history is stored for this workbook. MUST be less than or equal to 0x7FFF. If **fssExclusive** is equal to 1, this field MUST be ignored. + +### RRDInsDel + +The **RRDInsDel** record specifies the [insertion / deletion of rows / columns revision](#Section_6241f2cd16874b319cab2ff269a8e892) changes, and specifies the beginning of a collection of records as defined by the [Revision Stream](#Section_d120a1ffd2e6488381a507236f1994b0) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies insertions and deletions in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + +[TABLE] + +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a shared workbook. The **rrd.revid** field MUST be greater than 0. The **rrd.tabid** field MUST NOT be 0xFFFF. The **rrd.revt** field MUST be greater than or equal to 0 and less than or equal to 3. + +**A - fEndOfList (1 bit):** A bit that specifies that a row was inserted at the bottom of the filled cells [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). This field has meaning only if the **rrd.revt** field of this record is [REVTINSRW](#revisiontype). MUST be 1 if data was inserted at the bottom of the filled cells range. MUST be 0 if data was inserted or deleted in any other place. + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +**refn (8 bytes):** A [Ref8U](#ref8u) structure that specifies the range of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) affected by the insertion or deletion action. + +**cUcr (4 bytes):** An unsigned integer that specifies the number of items in **rgDucr**. + +**rgDucr (variable):** An array of [Ducr](#ducr) structures that specifies undo data to apply to an [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) for which the [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) was rejected. + +### RRDInsDelBegin + +The **RRDInsDelBegin** record specifies the beginning of a collection of records as defined by the [Revision Stream](#Section_d120a1ffd2e6488381a507236f1994b0) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a set of [Insertion / Deletion of Rows / Columns Revision](#Section_6241f2cd16874b319cab2ff269a8e892) changes. + +### RRDInsDelEnd + +The **RRDInsDelEnd** record specifies the end of a collection of records as defined by the [Revision Stream](#Section_d120a1ffd2e6488381a507236f1994b0) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a set of [Insertion / Deletion of Rows / Columns Revision](#Section_6241f2cd16874b319cab2ff269a8e892) changes. + +### RRDMove + +The **RRDMove** record represents [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information about the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that have moved. + +[TABLE] + +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the revision record information used to track changes in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). The **rrd.revid** MUST be greater than 0. The **rrd.revt** MUST be equal to 0x0004. The **rrd.tabid** MUST NOT be 0xFFFF because this [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) corresponds to a specific [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**refSrc (8 bytes):** A [Ref8U](#ref8u) structure that specifies the original location of the range of cells that moved. + +**refDst (8 bytes):** A Ref8U structure that specifies the new location of the range of cells that moved. + +**tabidSrc (2 bytes):** A [TabId](#tabid) structure that specifies the sheet on which **refSrc** resides. + +**cUcr (4 bytes):** An unsigned integer that specifies the number of elements in **rgDucr**. + +**rgDucr (variable):** An array of [Ducr](#ducr) structures that specifies undo data that will have to be applied to an [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) if the revision is rejected. + +### RRDMoveBegin + +The **RRDMoveBegin** record specifies the beginning of a collection of records as defined by the [Revision Stream](#Section_d120a1ffd2e6488381a507236f1994b0) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies moved [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +### RRDMoveEnd + +The **RRDMoveEnd** record specifies the end of a collection of records as defined by the [Revision Stream](#Section_d120a1ffd2e6488381a507236f1994b0) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies moved [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +### RRDRenSheet + +The **RRDRenSheet** record specifies the old and new name of a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) after renaming the sheet in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + +[TABLE] + +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a shared workbook. The **rrd.revid** MUST be greater than 0. The **rrd.revt** MUST be equal to 0x0009. The **rrd.tabid** MUST NOT be 0xFFFF. + +**cchOldName (2 bytes):** An unsigned integer that specifies the number of characters in **stOldName** that are used to specify the name of the old sheet. Characters in **stOldName** that are to the right of these used characters are ignored. If **stOldName.fHighByte** is 0, the value MUST be less than or equal to 227. If **stOldName.fHighByte** is 1, the value MUST be less than or equal to 127. + +**stOldName (255 bytes):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of the old sheet. + +**cchNewName (2 bytes):** An unsigned integer that specifies the number of characters in **stNewName** that are used to specify the name of the new sheet. Characters in **stNewName** that are to the right of these used characters are ignored. If **stNewName.fHighByte** is 0, the value MUST be less than or equal to 227. If **stNewName.fHighByte** is 1, the value MUST be less than or equal to 127. + +**stNewName (255 bytes):** An XLUnicodeStringNoCch structure that specifies the name of the new sheet. + +### RRDRstEtxp + +The **RRDRstEtxp** record specifies [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information for a [**formatting run**](#gt_10031ac8-2a26-4200-beee-cd8d9420ca96). Instances of this record MUST be preceded by an [RRDChgCell](#rrdchgcell) record that specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) containing the formatting run. + +[TABLE] + +**iFnt (2 bytes):** An unsigned integer that specifies the zero-based index of this record in the set of RRDRstEtxp records that have a common preceding RRDChgCell record. MUST be greater than or equal to zero and less than the **cetxpRst** field of the preceding RRDChgCell record. + +**cchFontName (1 byte):** An unsigned integer that specifies the count of double-byte [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters in **stFontName**. MUST be less than or equal to 0x1F. + +**fFullStr (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies that **stFontName** contains double-byte Unicode characters. MUST be 0x01 if **cchFontName** is greater than 0. If **cchFontName** is 0, the value of **fFullStr** is undefined and MUST be ignored. + +**stFontName (62 bytes):** A fixed length array of Unicode characters that specifies the name of the font. Characters whose position in this array is greater than **cchFontName** are undefined and MUST be ignored. + +**stxp (16 bytes):** An [Stxp](#stxp) structure that specifies the font attributes. + +**icvFore (2 bytes):** An [Icv](#icv) structure that specifies the [**color palette**](#gt_05879d13-b9e0-4333-b96d-63cc3433997e) value for the font. + +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +### RRDTQSIF + +The **RRDTQSIF** record specifies the [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) field that has been removed in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + +[TABLE] + +**rt (2 bytes):** An unsigned integer that specifies the RRDTQSIF record type. The value MUST be 0x0808. + +**grbitfrt (2 bytes):** MUST be 0x0001, and MUST be ignored. + +**ref (variable):** An [Ref8U](#ref8u) or [Ref8U2007](#ref8u2007) that specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of the query table from which the field was removed. If the value of the **wXLVer** field of the [RRDInfo](#rrdinfo) record in this [revision log](#Section_2cbd26e86f7e4195ada414c8b7e595b8) as specified by the [Revision Stream (Revision Log)](#revision-stream-revision-log) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) is equal to 12, Ref8U2007 is used. Otherwise, Ref8U is used. + +**rrd (14 bytes):** An [RRD](#rrd) that specifies the properties of this [**revision record**](#gt_8a81af64-18af-4ccf-8bf6-1a26d77f257f). The value of **rrd.revid** MUST be 0x0. The value of **rrd.revt** MUST be 0x2E. The value of **rrd.fDelAtEdgeofSort** MUST be 0x0. + +**idField (4 bytes):** An unsigned integer that specifies the identity of this field in the query table. The value MUST be unique among **idField** fields of all RRDTQSIF records in the query table and all [Qsif](#qsif) records in the query table. MUST be greater than 0x00000000 and less than 0x0000FFFF. + +### RRDUserView + +The **RRDUserView** record specifies the changes caused by a [**custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4) [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + +[TABLE] + +**rrd (14 bytes):** An [RRD](#rrd) that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a shared workbook. The **rrd.revid** MUST be 0 because this is a revision that cannot be reviewed The **rrd.revt** MUST be equal to 0x002B or 0x002C. The **rrd.tabid** MUST be 0xFFFF because this revision does not correspond to a specific [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**guid (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that specifies the custom view in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) whose revision caused the changes specified in this record. MUST be globally unique. The value of this field MUST be equal to one of the **guid** fields of the [UserSViewBegin](#usersviewbegin) collection in the sheet. + +### RRFormat + +The **RRFormat** record specifies a formatting change that was applied to a [**shared workbook**](#gt_241c4cae-c49a-438a-87dc-c8fb2c871921). If the change information is too large for a single RRFormat record, it is split into multiple RRFormat records. This record cannot be continued with [Continue](#continue) records. + +[TABLE] + +**rrd (14 bytes):** An [RRD](#rrd) that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). The RRD structure MUST conform to the restrictions specified in the following table: + +| Value | Restriction | +|---------------|---------------------| +| **rrd.revt** | MUST be 0x000B. | +| **rrd.revid** | MUST be 0x0. | +| **rrd.tabid** | MUST NOT be 0xFFFF. | + +**A - fXfDxf (1 bit):** A bit that specifies that the affected [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) need to have their format reset to the format specified by the current [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) before applying any format from **dxfn**, if present. + +**B - fXfDxfNull (1 bit):** A bit that specifies whether **dxfn** exists. + +**C - fStyXfDxf (1 bit):** A bit that specifies that the format of the cells need to be cleared before applying any format from **dxfn**, if present. + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +**sqref (variable):** An [SqRefU](#sqrefu) structure that specifies the location or locations on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) affected by the formatting changes specified by this record. + +**dxfn (variable):** A [DXFN](#dxfn) structure that specifies the new cell formatting. MUST exist if and only if fXfDxfNull is 0. + +### RRInsertSh + +The **RRInsertSh** record specifies the changes caused by inserting a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + +[TABLE] + +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a shared workbook. The **rrd.revid** MUST be greater than 0 because this is a reviewable [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e). The **rrd.revt** MUST be equal to 0x0005. The **rrd.tabid** MUST NOT be 0xFFFF because this revision corresponds to a specific sheet. + +**itabPos (2 bytes):** A [TabIndex](#tabindex) structure that specifies the position of the new sheet in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**cch (2 bytes):** An unsigned integer that specifies the number of characters in **stName** that are used to specify the name of the new sheet. Characters in **stName** that are to the right of these used characters are ignored. If **stName.fHighByte** is 0, the value MUST be less than or equal to 227. If **stName.fHighByte** is 1, the value MUST be less than or equal to 127. + +**stName (256 bytes):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of the new sheet. + +### RRSort + +The **RRSort** record specifies the changes caused by [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880) actions in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + +[TABLE] + +**rrd (14 bytes):** An [RRD](#rrd) structure that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a shared workbook. The **rrd.revt** MUST be equal to 0x0007. The **rrd.tabid** MUST NOT be 0xFFFF because this [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) corresponds to a specific [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**ref8 (8 bytes):** A [Ref8U](#ref8u) structure that specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells affected by sort actions. If the value of **fCol** is 0, the range of rows MUST be within the valid range of the number of rows on the sheet as defined in the used range specified by the [Dimensions](#dimensions) record. If the value of **fCol** is 1, the range of columns MUST be within the valid range of the number of columns on the sheet as defined in the used range specified by the Dimensions record. + +**A - fCol (1 bit):** A bit that specifies whether sorting is performed on the columns. + +| Value | Meaning | +|-------|----------------------------------| +| 0 | The rows have been reordered. | +| 1 | The columns have been reordered. | + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +**cbSort (4 bytes):** An unsigned integer that specifies the size of **rgSortMap** in bytes. + +**rgSortMap (variable):** An array of [SortItem](#sortitem) structures. The size MUST be equal to **cbSort**. + +### RRTabId + +The **RRTabId** record specifies an array of unique [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) identifiers, each of which is associated with a sheet in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The order of the sheet identifiers in the array matches the order of the [BoundSheet8](#boundsheet8) records as they appear in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). If the workbook contains more than 4112 sheets, then this record is not present and each sheet identifier is specified by the order in which the BoundSheet8 records appear in the Globals Substream, beginning with 1.[\<115\>](#Appendix_A_115) + +[TABLE] + +**rgtabid (variable):** An array of 2-byte unsigned integers. Each element of this array is a unique sheet identifier, which is associated with a sheet in the workbook. The order of the sheet identifiers in the array matches the order in which the BoundSheet8 records appear in the Globals Substream. + +### SBaseRef + +The **SBaseRef** record specifies the location of a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) referenced by a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +[TABLE] + +**ref (8 bytes):** A [Ref8U](#ref8u) structure that specifies the location of a PivotTable view referenced by a chart. + +### Scatter + +The **Scatter** record specifies that the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is a scatter chart group or a bubble chart group, and specifies the chart group attributes. + +[TABLE] + +**pcBubbleSizeRatio (2 bytes):** An unsigned integer that specifies the size of the [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) as a percentage of their default size. A value of 100 shows all the data points in their default size, as determined by the application. MUST be greater than or equal to 0 and less than or equal to 300. MUST be ignored if the **fBubbles** field is 0. + +**wBubbleSize (2 bytes):** An unsigned integer that specifies how the default size of the data points represents the value. MUST be ignored if the **fBubbles** field is 0. MUST be a value from the following table: + +| Value | Meaning | +|--------|---------------------------------------------------| +| 0x0001 | The area of the data point represents the value. | +| 0x0002 | The width of the data point represents the value. | + +**A - fBubbles (1 bit):** A bit that specifies whether this chart group is a scatter chart group or bubble chart group. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------| +| 0 | Scatter chart group | +| 1 | Bubble chart group | + +**B - fShowNegBubbles (1 bit):** A bit that specifies whether data points with negative values in the chart group are shown on the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). MUST be ignored if the **fBubbles** field is 0. + +**C - fHasShadow (1 bit):** A bit that specifies whether one or more [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) in a scatter chart group or data points in a bubble chart group have shadows. + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +### SCENARIO + +The **SCENARIO** record specifies a [**scenario**](#gt_ee14f43c-19d8-467b-aa0b-e025635f6ba3). + +[TABLE] + +**cref (2 bytes):** An unsigned integer that specifies the number of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the scenario. MUST be greater than zero and less than or equal to 32. + +**fLocked (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether the scenario can be modified if the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829). It MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | The user can change the scenario. | +| 0x01 | When the workbook is protected, the user cannot change the scenario. | + +**fHidden (1 byte):** A Boolean that specifies whether the scenario is to be [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) from the user if the workbook is protected. It MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | The scenario is never hidden | +| 0x01 | When the workbook is protected, the scenario is hidden from the user. | + +**cchName (1 byte):** An unsigned integer that specifies the character count in the field **rgchName**. + +**cchComment (1 byte):** An unsigned integer that specifies the character count in the field **rgchComment**. + +**cchNameUser (1 byte):** An unsigned integer that specifies the character count in the field **rgchNameUser**. + +**rgchName (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of the scenario. + +**rgchNameUser (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the name of the user who created the scenario. The character count MUST be less than or equal to 52. MUST be omitted if **cchNameUser** is 0. + +**rgchComment (variable):** An XLUnicodeString structure that specifies a [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) associated with the scenario. MUST be omitted if **cchComment** is 0. + +**rgSLC (variable):** An array of [SLCO8](#slco8) structures. Each element of the array specifies one cell that is changed by the scenario. Its element count MUST be **cref**. + +**rgst (variable):** An array of XLUnicodeString structures. Each element of the array specifies the value associated to a cell by the scenario. Its element count MUST be **cref**. + +**unused (variable):** Undefined and MUST be ignored. The size of this field in bytes MUST be 2\***cref**. + +### ScenarioProtect + +The **ScenarioProtect** record specifies the [**protection**](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499) state for [**scenarios**](#gt_ee14f43c-19d8-467b-aa0b-e025635f6ba3) in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). Scenarios are defined in the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF. + +[TABLE] + +**fScenProtect (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the scenarios in the sheet are [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829). MUST be a value from the following table: + +| Value | Meaning | +|--------|------------------------------| +| 0x0000 | Scenarios are not protected. | +| 0x0001 | Scenarios are protected. | + +### ScenMan + +The **ScenMan** record specifies the state of the [**Scenario Manager**](#gt_66a30626-8b99-48f5-9488-7706735454e7) for the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +This record also specifies the beginning of a collection of [Scenario](#scenario) records as defined by the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of Scenario records specifies individual scenarios. + +[TABLE] + +**csct (2 bytes):** A signed integer that specifies the total number of [**scenarios**](#gt_ee14f43c-19d8-467b-aa0b-e025635f6ba3) in the sheet. MUST be equal to the number of Scenario records in the Worksheet substream and MUST be greater than or equal to 0. + +**isctCur (2 bytes):** A signed integer that specifies the zero-based index of the Scenario in this Worksheet substream that is currently [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) in the Scenario Manager. If **csct** is greater than 0, then **isctCur** MUST be greater than or equal to –1 and MUST be less than the number of Scenario records in the Worksheet substream. The value -1 means that no scenario is currently selected. + +**isctShown (2 bytes):** A signed integer that specifies the zero-based index of the Scenario in this Worksheet substream that specifies the scenario that is currently applied in the sheet associated with this record. If **csct** is greater than 0, then **isctShown** MUST be greater than or equal to –1 and MUST be less than the number of Scenario records in the Worksheet substream. The value –1 means that no scenario is currently shown. + +**irefResult (2 bytes):** A signed integer that specifies the number of [**result cells**](#gt_353bd534-530f-4478-b618-271b85cab0b8) that are referenced in the field **rgref**. MUST be greater than or equal to 0 and less than or equal to 32. + +**rgref (variable):** An array of [Ref8U](#ref8u) structures. Each element specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells in the current sheet. These cells contain the results that are to be compared across scenarios. Its count MUST be equal to **irefResult**. + +### Scl + +The **Scl** record specifies the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) of the current view in the window used to display the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) as a fraction given by the following formula: + +Fraction = **nscl** / **dscl** + +The fraction MUST be greater than or equal to 1/10 and less than or equal to 4. + +This record MUST exist if the zoom level of the current view is not equal to 1. + +[TABLE] + +**nscl (2 bytes):** A signed integer that specifies the numerator of the fraction. The value MUST be greater than or equal to 1. + +**dscl (2 bytes):** A signed integer that specifies the denominator of the fraction. The value MUST be greater than or equal to 1. + +### Selection + +The **Selection** record specifies [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). There can be multiple contiguous Selection records that have the same **pnn** value to specify all selected cells within a sheet[\<116\>](#Appendix_A_116). If this is the case, the values of **rwAct**, **colAct**, and **irefAct** MUST be the same across all the contiguous Selection records that have the same **pnn** value. + +[TABLE] + +**pnn (1 byte):** A [PaneType](#panetype) enumeration that specifies the [**active pane**](#gt_33f49274-001d-40a3-bcca-f54a93906c29). + +**rwAct (2 bytes):** An [RwU](#rwu) structure that specifies the zero-based row number of the [**active cell**](#gt_2c0759a5-6721-422b-8cb9-f4bb09e07c84). + +**colAct (2 bytes):** A [ColU](#colu) structure that specifies the zero-based column number of the active cell. + +**irefAct (2 bytes):** A signed integer that specifies the zero-based index to the [RefU](#refu) structure in **rgref** that contains the active cell. MUST be greater than or equal to 0. If this record is one of multiple contiguous Selection records, this value is the index to the RefU structure across the aggregation of **rgref** arrays of all Selection records. + +**cref (2 bytes):** An unsigned integer that specifies the number of RefU structures in the **rgref** array of this record. + +**rgref (variable):** An array of RefU structures that specifies ranges of selected cells in the sheet. The number of RefU structures in this array MUST be less than or equal to 1369. + +### SerAuxErrBar + +The **SerAuxErrBar** record specifies properties of an [error bar](#Section_762a461d0a45474ebd7d5994bb294af2). + +[TABLE] + +**sertm (1 byte):** An unsigned integer that specifies the direction of the error bars. MUST be a value from the following table. + +| Value | Meaning | +|-------|---------------------------------------------------| +| 0x01 | Error bars are horizontal in the plus direction. | +| 0x02 | Error bars are horizontal in the minus direction. | +| 0x03 | Error bars are vertical in the plus direction. | +| 0x04 | Error bars are vertical in the minus direction. | + +**ebsrc (1 byte):** An unsigned integer that specifies the error amount type of the error bars. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x01 | Percentage | +| 0x02 | Fixed value | +| 0x03 | Standard deviation | +| 0x04 | Custom values (array of values or [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99)) | +| 0x05 | Standard error | + +If the **cce** field of the [ChartParsedFormula](#chartparsedformula) record contained in the **formula** field of the closest preceding [BRAI](#brai) record with **id** field equal to 0x0001 is 0x0000, then the error bars value source is an array of values. Each value in this array MUST be stored in a [Number](#number) record in the [SERIESDATA](#chart-sheet-substream) part of the Chart Sheet substream as specified in the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The **cell.col** field of each Number record MUST store the zero-based position index of the closest preceding [Series](#series-1) record, as it is calculated across all Series records in the current [Chart Sheet](#Section_2c90d75bc92645aa8ff29d4483f51831) substream. The **cell.rw** field MUST store the zero-based index of this value in the array. + +Otherwise, the value source is a range. The closest preceding BRAI record with the **id** field equal to 0x0001 specifies a link to the [Rgce](#rgce) structure that describes this range. + +**fTeeTop (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether the error bars are T-shaped. + +**reserved (1 byte):** MUST be 0x01 and MUST be ignored. + +**numValue (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the fixed value, percentage, or number of standard deviations for the error bars. If **ebsrc** is equal to 0x05 or 0x04, MUST be ignored. + +**cnum (2 bytes):** An unsigned integer that specifies the number of value or cell references used for custom error bars when **ebsrc** is equal to 0x04. This value MUST be ignored if **ebsrc** does not equal 0x04. + +If the value source is an array of values, this value MUST equal the count of Number records whose **cell.col** field stores the zero-based index of the closest preceding Series record in the collection of Series records in the current chart sheet substream. + +If the value source is a range, this value MUST equal the count of cell references of the range as specified in the **rgce** field of the ChartParsedFormula contained in the **formula** field of the closest preceding BRAI record that has an **id** field equal to 0x0001. + +### SerAuxTrend + +The **SerAuxTrend** record specifies a [trendline](#Section_61d74ebc36714d6dbdc0626db604530d). + +[TABLE] + +**regt (1 byte):** An unsigned integer that specifies the type of trendline. The value MUST be one of the following values: + +| Value | Meaning | +|-------|----------------------------------------------------------------| +| 0x00 | Polynomial | +| 0x01 | Exponential | +| 0x02 | Logarithmic | +| 0x03 | Power | +| 0x04 | [**Moving average**](#gt_4b582231-b8d5-4dea-bda8-83c6f83b05e6) | + +**ordUser (1 byte):** An unsigned integer that specifies the polynomial order or moving average period. MUST be greater than or equal to 0x02 and less than or equal to 0x06 if **regt** is equal to 0x00; MUST be greater than or equal to 0x02 and less than or equal to the value of the **cValx** field of the [Series](#series-1) record specified by the preceding [SerParent](#serparent) record minus one if **regt** is equal to 0x04. MUST be ignored for trendlines of all other types. + +**numIntercept (8 bytes):** A [ChartNumNillable](#chartnumnillable) structure that specifies where the trendline intersects the value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) or vertical axis on bubble and scatter [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5). If no intercept is specified, this ChartNumNillable structure MUST specify a [NilChartNum](#nilchartnum) structure, and the value of the **type** field in the NilChartNum structure MUST be 0x0100. + +**fEquation (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether the trendline equation is displayed in the trendline label. MUST be ignored if **regt** is equal to 0x04. MUST be ignored if the [chart sheet](#Section_732ff614d939416bb7c76d983471ff11) substream contains an [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a) with an [ObjectLink](#objectlink) record that contains both a **wLinkObj** field equal to 0x0004 and a **wLinkVar1** field equal to the zero-based index into a Series record in the collection of Series records in the current chart sheet substream that represents this trendline , and the attached label contains a [SeriesText](#seriestext) record. + +**fRSquared (1 byte):** A Boolean that specifies whether the R-squared value is displayed in the trendline label. MUST be ignored if **regt** is equal to 0x04. MUST be ignored if the chart sheet substream contains an attached label with an ObjectLink record that contains both a **wLinkObj** field equal to 0x0004 and a **wLinkVar1** field equal to the zero-based index into a Series record in the collection of Series records in the current chart sheet substream that represents this trendline, and the attached label contains a SeriesText record. + +**numForecast (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the number of periods to [**forecast**](#gt_0a5478cf-8836-4a9a-a663-7684366646a3) forward. + +**numBackcast (8 bytes):** An Xnum that specifies the number of periods to forecast backward. + +### SerFmt + +The **SerFmt** record specifies properties of the associated [data points](#Section_9c986ad250d44fa1a157063ac5c971a0), [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b), or lines of the [series](#Section_527ce4dfc9f84e50a314d4b07519593c).  The associated data points, data markers, or lines of the series are specified by the preceding [DataFormat](#dataformat) record. If this record is not present in the sequence of records that conforms to the [SS](#chart-sheet-substream) rule of the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), then the properties of the associated data points, data markers, or lines of the series are specified by the default values of the fields of this record. + +[TABLE] + +**A - fSmoothedLine (1 bit):** A bit that specifies whether the lines of the series are displayed with a smooth line effect on a scatter, radar, and line [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). The default value of this field is 0. + +**B - f3DBubbles (1 bit):** A bit that specifies whether the data points of a bubble chart group are displayed with a 3-D effect.  MUST be ignored for all other chart groups. The default value of this field is 0. + +**C - fArShadow (1 bit):** A bit that specifies whether the data markers are displayed with a shadow on bubble, scatter, radar, stock, and line chart groups. The default value of this field is 0. + +**reserved (13 bits):** MUST be zero, and MUST be ignored. + +### Series + +The **Series** record specifies properties of the data for a [series](#Section_527ce4dfc9f84e50a314d4b07519593c), a [trendline](#Section_61d74ebc36714d6dbdc0626db604530d), or [error bars](#Section_762a461d0a45474ebd7d5994bb294af2), and specifies the beginning of a collection of records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a series, a trendline, or error bars. + +[TABLE] + +**sdtX (2 bytes):** An unsigned integer that specifies the type of data in [**categories**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1), or horizontal values on bubble and scatter [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5), in the series. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0001 | The series contains categories, or horizontal values on bubble and scatter chart groups, with numeric information. | +| 0x0003 | The series contains categories, or horizontal values on bubble and scatter chart groups, with text information. | + +**sdtY (2 bytes):** An unsigned integer that specifies that the values or vertical values on bubble and scatter chart groups, in the series contain numeric information. It MUST be 0x0001 and MUST be ignored. + +**cValx (2 bytes):** An unsigned integer that specifies the count of categories, or horizontal values on bubble and scatter chart groups, in the series. The value MUST be less than or equal to 32767. + +**cValy (2 bytes):** An unsigned integer that specifies the count of values, or vertical values on bubble and scatter chart groups, in the series. The value MUST be less than or equal to 32767. + +**sdtBSize (2 bytes):** An unsigned integer that specifies that the [**bubble size**](#gt_3a0cf938-5b61-4460-bdbb-3540d84d4180) values in the series contain numeric information. The value MUST be 0x0001, and MUST be ignored. + +**cValBSize (2 bytes):** An unsigned integer that specifies the count of bubble size values in the series. The value MUST be less than or equal to 32767. + +### SeriesList + +The **SeriesList** record specifies the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) for the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +[TABLE] + +**cser (2 bytes):** An unsigned integer that specifies the count of series indexes in the **rgiser** field. + +**rgiser (variable):** An array of 2-byte unsigned integers, each of which specifies a one-based index of a [Series](#series-1) record in the collection of Series records in the current [chart sheet](#Section_732ff614d939416bb7c76d983471ff11) substream. Each referenced Series specifies a series for the chart. + +### SeriesText + +The **SeriesText** record specifies the text for a [series](#Section_527ce4dfc9f84e50a314d4b07519593c), [trendline](#Section_61d74ebc36714d6dbdc0626db604530d) name, trendline label, [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) title or [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) title. + +[TABLE] + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**stText (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) that specifies the text string. + +### SerParent + +The **SerParent** record specifies the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) to which the current [trendline](#Section_61d74ebc36714d6dbdc0626db604530d) or [error bar](#Section_762a461d0a45474ebd7d5994bb294af2) corresponds. + +[TABLE] + +**series (2 bytes):** An unsigned integer that specifies the one-based index of a [Series](#series-1) record in the collection of Series records in the current [chart sheet](#Section_2c90d75bc92645aa8ff29d4483f51831) substream. The referenced Series record specifies the series associated with the current trendline or error bar. The value MUST be greater than or equal to 0x0001 and less than or equal to 0x0FE. + +### SerToCrt + +The **SerToCrt** record specifies the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) for the current [series](#Section_527ce4dfc9f84e50a314d4b07519593c). + +[TABLE] + +**id (2 bytes):** An unsigned integer that specifies the zero-based index of a [ChartFormat](#chartformat) record in the collection of ChartFormat records in the current [chart sheet](#Section_2c90d75bc92645aa8ff29d4483f51831) substream. The referenced ChartFormat record specifies the chart group that contains the current series. + +### Setup + +The **Setup** record specifies the page format settings used to print the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**iPaperSize (2 bytes):** An unsigned integer that specifies the paper size. Refer to the following table for values. The value 0, or values greater than or equal to 256, specify custom printer paper sizes. Values between 118 and 255 are reserved for future use. If **fNoPls** is 1, this value is undefined and MUST be ignored. + +| Value | Meaning | +|-------|-----------------------------------------------| +| 1 | US Letter 8 1/2 x 11 in | +| 2 | US Letter Small 8 1/2 x 11 in | +| 3 | US Tabloid 11 x 17 in | +| 4 | US Ledger 17 x 11 in | +| 5 | US Legal 8 1/2 x 14 in | +| 6 | US Statement 5 1/2 x 8 1/2 in | +| 7 | US Executive 7 1/4 x 10 1/2 in | +| 8 | A3 297 x 420 mm | +| 9 | A4 210 x 297 mm | +| 10 | A4 Small 210 x 297 mm | +| 11 | A5 148 x 210 mm | +| 12 | B4 (JIS) 250 x 354 | +| 13 | B5 (JIS) 182 x 257 mm | +| 14 | Folio 8 1/2 x 13 in | +| 15 | Quarto 215 x 275 mm | +| 16 | 10 x 14 in | +| 17 | 11 x 17 in | +| 18 | US Note 8 1/2 x 11 in | +| 19 | US Envelope \#9 3 7/8 x 8 7/8 | +| 20 | US Envelope \#10 4 1/8 x 9 1/2 | +| 21 | US Envelope \#11 4 1/2 x 10 3/8 | +| 22 | US Envelope \#12 4 \276 x 11 | +| 23 | US Envelope \#14 5 x 11 1/2 | +| 24 | C size sheet | +| 25 | D size sheet | +| 26 | E size sheet | +| 27 | Envelope DL 110 x 220mm | +| 28 | Envelope C5 162 x 229 mm | +| 29 | Envelope C3 324 x 458 mm | +| 30 | Envelope C4 229 x 324 mm | +| 31 | Envelope C6 114 x 162 mm | +| 32 | Envelope C65 114 x 229 mm | +| 33 | Envelope B4 250 x 353 mm | +| 34 | Envelope B5 176 x 250 mm | +| 35 | Envelope B6 176 x 125 mm | +| 36 | Envelope 110 x 230 mm | +| 37 | US Envelope Monarch 3.875 x 7.5 in | +| 38 | 6 3/4 US Envelope 3 5/8 x 6 1/2 in | +| 39 | US Std Fanfold 14 7/8 x 11 in | +| 40 | German Std Fanfold 8 1/2 x 12 in | +| 41 | German Legal Fanfold 8 1/2 x 13 in | +| 42 | B4 (ISO) 250 x 353 mm | +| 43 | Japanese Postcard 100 x 148 mm | +| 44 | 9 x 11 in | +| 45 | 10 x 11 in | +| 46 | 15 x 11 in | +| 47 | Envelope Invite 220 x 220 mm | +| 48 | RESERVED--DO NOT USE | +| 49 | RESERVED--DO NOT USE | +| 50 | US Letter Extra 9 \275 x 12 in | +| 51 | US Legal Extra 9 \275 x 15 in | +| 52 | US Tabloid Extra 11.69 x 18 in | +| 53 | A4 Extra 9.27 x 12.69 in | +| 54 | Letter Transverse 8 \275 x 11 in | +| 55 | A4 Transverse 210 x 297 mm | +| 56 | Letter Extra Transverse 9\275 x 12 in | +| 57 | SuperA/SuperA/A4 227 x 356 mm | +| 58 | SuperB/SuperB/A3 305 x 487 mm | +| 59 | US Letter Plus 8.5 x 12.69 in | +| 60 | A4 Plus 210 x 330 mm | +| 61 | A5 Transverse 148 x 210 mm | +| 62 | B5 (JIS) Transverse 182 x 257 mm | +| 63 | A3 Extra 322 x 445 mm | +| 64 | A5 Extra 174 x 235 mm | +| 65 | B5 (ISO) Extra 201 x 276 mm | +| 66 | A2 420 x 594 mm | +| 67 | A3 Transverse 297 x 420 mm | +| 68 | A3 Extra Transverse 322 x 445 mm | +| 69 | Japanese Double Postcard 200 x 148 mm | +| 70 | A6 105 x 148 mm | +| 71 | Japanese Envelope Kaku \#2 | +| 72 | Japanese Envelope Kaku \#3 | +| 73 | Japanese Envelope Chou \#3 | +| 74 | Japanese Envelope Chou \#4 | +| 75 | Letter Rotated 11 x 8 1/2 11 in | +| 76 | A3 Rotated 420 x 297 mm | +| 77 | A4 Rotated 297 x 210 mm | +| 78 | A5 Rotated 210 x 148 mm | +| 79 | B4 (JIS) Rotated 364 x 257 mm | +| 80 | B5 (JIS) Rotated 257 x 182 mm | +| 81 | Japanese Postcard Rotated 148 x 100 mm | +| 82 | Double Japanese Postcard Rotated 148 x 200 mm | +| 83 | A6 Rotated 148 x 105 mm | +| 84 | Japanese Envelope Kaku \#2 Rotated | +| 85 | Japanese Envelope Kaku \#3 Rotated | +| 86 | Japanese Envelope Chou \#3 Rotated | +| 87 | Japanese Envelope Chou \#4 Rotated | +| 88 | B6 (JIS) 128 x 182 mm | +| 89 | B6 (JIS) Rotated 182 x 128 mm | +| 90 | 12 x 11 in | +| 91 | Japanese Envelope You \#4 | +| 92 | Japanese Envelope You \#4 Rotated | +| 93 | PRC 16K 146 x 215 mm | +| 94 | PRC 32K 97 x 151 mm | +| 95 | PRC 32K(Big) 97 x 151 mm | +| 96 | PRC Envelope \#1 102 x 165 mm | +| 97 | PRC Envelope \#2 102 x 176 mm | +| 98 | PRC Envelope \#3 125 x 176 mm | +| 99 | PRC Envelope \#4 110 x 208 mm | +| 100 | PRC Envelope \#5 110 x 220 mm | +| 101 | PRC Envelope \#6 120 x 230 mm | +| 102 | PRC Envelope \#7 160 x 230 mm | +| 103 | PRC Envelope \#8 120 x 309 mm | +| 104 | PRC Envelope \#9 229 x 324 mm | +| 105 | PRC Envelope \#10 324 x 458 mm | +| 106 | PRC 16K Rotated | +| 107 | PRC 32K Rotated | +| 108 | PRC 32K(Big) Rotated | +| 109 | PRC Envelope \#1 Rotated 165 x 102 mm | +| 110 | PRC Envelope \#2 Rotated 176 x 102 mm | +| 111 | PRC Envelope \#3 Rotated 176 x 125 mm | +| 112 | PRC Envelope \#4 Rotated 208 x 110 mm | +| 113 | PRC Envelope \#5 Rotated 220 x 110 mm | +| 114 | PRC Envelope \#6 Rotated 230 x 120 mm | +| 115 | PRC Envelope \#7 Rotated 230 x 160 mm | +| 116 | PRC Envelope \#8 Rotated 309 x 120 mm | +| 117 | PRC Envelope \#9 Rotated 324 x 229 mm | +| 118 | PRC Envelope \#10 Rotated 458 x 324 mm | + +**iScale (2 bytes):** An unsigned integer that specifies the scaling factor for printing as a percentage. For example, if the value is 107 then the scaling factor is 107%. If **fNoPls** is 1, this value is undefined and MUST be ignored. + +**iPageStart (2 bytes):** A signed integer that specifies the starting page number. If **fUsePage** is 0, MUST be ignored. + +**iFitWidth (2 bytes):** An unsigned integer that specifies the number of pages the sheet width is fit to. MUST be less than or equal to 32767. The value 0 means use as many pages as necessary to print the columns in the sheet. + +**iFitHeight (2 bytes):** An unsigned integer that specifies the number of pages the sheet height is fit to. MUST be less than or equal to 32767. The value 0 means use as many pages as necessary to print the rows of the sheet. + +**A - fLeftToRight (1 bit):** A bit that specifies the order that multiple pages are sent to the printer for a single sheet. + +| Value | Meaning | +|-------|---------------------------------------------------------------| +| 0 | Pages are printed top-to-bottom first and then left-to-right. | +| 1 | Pages are printed left-to-right first and then top-to-bottom. | + +**B - fPortrait (1 bit):** A bit that specifies whether to print using portrait mode or landscape mode. If **fNoPls** is 1, the value is undefined and MUST be ignored. If **fNoOrient** is 1, the value is undefined and MUST be ignored. + +| Value | Meaning | +|-------|-----------------------------------------| +| 0 | Pages are printed using landscape mode. | +| 1 | Pages are printed using portrait mode. | + +**C - fNoPls (1 bit):** A bit that specifies whether the **iPaperSize**, **iScale**, **iRes**, **iVRes**, **iCopies**, **fNoOrient**, and **fPortrait** data are undefined and ignored. If the value is 1, they are undefined and ignored. + +**D - fNoColor (1 bit):** A bit that specifies whether the document is printed in black and white. + +**E - fDraft (1 bit):** A bit that specifies whether the document is printed using draft quality. + +**F - fNotes (1 bit):** A bit that specifies whether [**comments**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) are printed. + +**G - fNoOrient (1 bit):** A bit that specifies whether the paper orientation is set. + +| Value | Meaning | +|-------|---------------------------------------------------------------| +| 0 | Paper orientation is specified by the value of **fPortrait**. | +| 1 | Pages are printed using portrait mode. | + +**H - fUsePage (1 bit):** A bit that specifies whether a custom starting page number is used to print. If the value is 1, the custom starting page number specified by the value of **iPageStart** is used. + +**I - unused1 (1 bit):** Undefined and MUST be ignored. + +**J - fEndNotes (1 bit):** A bit that specifies whether the comments are printed at the end of the sheet. If **fNotes** is 0, the value MUST be ignored. + +| Value | Meaning | +|-------|-------------------------------------------------| +| 0 | Comments are printed as displayed on the sheet. | +| 1 | Comments are printed at the end of the sheet. | + +**K - iErrors (2 bits):** An unsigned integer that specifies how to handle errors in the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) data. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------| +| 0 | Print errors as displayed on the sheet. | +| 1 | Print errors as blank. | +| 2 | Print errors as dashes ("--"). | +| 3 | Print errors as "#N/A". | + +**L - reserved (4 bits):** MUST be zero, and MUST be ignored. + +**iRes (2 bytes):** An unsigned integer that specifies the print resolution in dots per inch (DPI). If **fNoPls** is 1, this value is undefined and MUST be ignored. + +**iVRes (2 bytes):** An unsigned integer that specifies the vertical print resolution in DPI. If **fNoPls** is 1, this value is undefined and MUST be ignored. + +**numHdr (8 bytes):** An Xnum (section [2.5.342](#xnum)) value that specifies the header margin in inches. The value MUST be greater than or equal to 0 and less than 49. + +**numFtr (8 bytes):** An Xnum value that specifies the footer margin in inches. The value MUST be greater than or equal to 0 and less than 49. + +**iCopies (2 bytes):** An unsigned integer that specifies the number of copies to print. If **fNoPls** is 1, this value is undefined and MUST be ignored. + +### ShapePropsStream + +The **ShapePropsStream** record specifies the [**shape**](#gt_d0e38aa4-2c71-4a6f-b5e6-75766fa9409e) formatting properties for [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) elements. These shape formatting properties are a superset of the properties stored in the [LineFormat](#lineformat), [AreaFormat](#areaformat), [MarkerFormat](#markerformat), and [GelFrame](#gelframe) records. They are stored in the **rgb** field, which is an **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)), as defined in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, section 21.2.2.197.[\<117\>](#Appendix_A_117) + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field of the field MUST be 0x08A4. + +**wObjContext (2 bytes):** An unsigned integer that specifies the chart element that the shape formatting properties in this record apply to. + +If this record is in a sequence of records that specifies an [AXS](#chart-sheet-substream) rule, then it MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The shape properties in this record apply to the [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). | +| 0x0001 | The shape properties in this record apply to the [**major gridlines**](#gt_2803347c-6396-46a5-9ede-6bef1149b013) of the axis. | +| 0x0002 | The shape properties in this record apply to the [**minor gridlines**](#gt_49980976-6314-43ad-ad51-8d3e55ef4b59) of the axis. | +| 0x0003 | The shape properties in this record apply to the three-dimensional surfaces of the [**walls**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c) or [**floor**](#gt_dc38c098-e0d3-4701-9656-5f2cf4d80f29). | + +If this record precedes an [End](#end) record matched by a [Begin](#begin) record in a sequence of records that conforms to the CRT rule, then this field MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The shape properties in this record apply to the [**drop lines**](#gt_e8c745bf-646c-4acd-8b5e-5314fa4965fa) of the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). | +| 0x0001 | The shape properties in this record apply to the [**high-low lines**](#gt_56aec928-ddcc-4415-9d08-5d1dd3982bbc) of the chart group. | +| 0x0002 | The shape properties in this record apply to the [**leader lines**](#gt_8b7c448e-82e3-4d22-a8ba-52e0a10b14fa) of the chart group. | +| 0x0003 | The shape properties in this record apply to the [**series lines**](#gt_bda50b03-68fa-49f9-bd9e-d0dc289ac88a) of the chart group. | + +If this record is in a sequence of records that conforms to the SS rule, then this field MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The shape properties in this record apply to the [series](#Section_527ce4dfc9f84e50a314d4b07519593c), [data points](#Section_9c986ad250d44fa1a157063ac5c971a0), [error bars](#Section_762a461d0a45474ebd7d5994bb294af2), or [trendlines](#Section_61d74ebc36714d6dbdc0626db604530d) specified by the [DataFormat](#dataformat) record. | +| 0x0001 | The shape properties in this record apply to the [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) specified by the DataFormat record. | + +If this record is in a sequence of records that conforms to the FRAME rule, then it MUST be 0x0000, which means the shape properties apply to the current [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)), [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c), [legend](#Section_1832229b7d1945f488d455e9c07466f0), or [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a). + +If this record is in a sequence of records that conforms to the DROPBAR rule as specified by the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), then it MUST be 0x0000, which means the shape properties apply to [**up bar**](#gt_24acb31a-39aa-4a44-829b-c18e1767a4ac) or [**down bar**](#gt_d8bcbdc9-46a4-44e5-b184-40c565e4dd07) formatting. + +**unused (2 bytes):** Undefined and MUST be ignored. + +**dwChecksum (4 bytes):** An unsigned integer that specifies the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the shape formatting properties related to this record. The algorithm used to calculate the checksum is defined by [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.4.3.2. The checksum MUST be calculated by using every property of the [**property stream**](#gt_dbd8bc67-1371-445e-af6a-dfa5eeef670c), as a stream of bytes as specified by the [ShapePropsStreamChecksumData](#shapepropsstreamchecksumdata) structure. + +The information required to build the stream of bytes can be gathered from the LineFormat, AreaFormat, MarkerFormat, and GelFrame records associated with this record, as specified by [LinePropertiesForShapePropsStreamChecksum](#linepropertiesforshapepropsstreamchecksum), [InteriorColorPropertiesForShapePropsStreamChecksum](#interiorcolorpropertiesforshapepropsstreamchecksum), and [FillStylePropertiesForShapePropsStreamChecksum](#fillstylepropertiesforshapepropsstreamchecksum). + +When reading this record, the checksum is calculated as previously specified and compared to the **dwChecksum** value stored in this record. If the calculated checksum does not match the **dwChecksum** value, the application MUST assume that the XML stream is out of date, and the data from the LineFormat, AreaFormat, MarkerFormat, and GelFrame records MUST be used instead of the data specified by the **XML stream** (section 2.1.7.22). + +**cb (4 bytes):** An unsigned integer that specifies the length of the character array in the **rgb** field. + +**rgb (variable):** An array of ANSI characters whose length is specified by **cb** that contains the XML representation of the shape formatting properties as defined in \[ECMA-376\] Part 1, section 21.2.2.197.[\<118\>](#Appendix_A_118) + +### SheetExt + +The **SheetExt** record specifies [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) properties, including [**sheet tab**](#gt_3b131045-238c-4ce8-9c22-b6aac874c7c5) color and additional optional information specified by using the [SheetExtOptional](#sheetextoptional) structure. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0862. + +**cb (4 bytes):** An unsigned integer that specifies the size of this record in bytes. + +**icvPlain (7 bits):** An unsigned integer that specifies the tab color of this sheet. If the tab has a color assigned to it, the value of this field MUST be greater than or equal to 0x08 and less than or equal to 0x3F, as specified in the color table for the [Icv](#icv) structure. If the tab has no color assigned to it, the value of this field MUST be 0x7F, and MUST be ignored. + +**reserved (25 bits):** MUST be zero, and MUST be ignored. + +**sheetExtOptional (20 bytes):** A SheetExtOptional structure that specifies optional[\<119\>](#Appendix_A_119) fields. Exists if and only if the value of **cb** is 0x00000028. + +### ShrFmla + +The **ShrFmla** record specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that is shared across multiple [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). This record specifies a file size optimization. It is used with the [Formula](#formula) record to compress the amount of storage required for the formula. This record is preceded by a single Formula record that specifies the first cell in the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that uses this shared formula. Other Formula records that use this shared formula follow later in the file, not necessarily in a contiguous sequence. Formula records that use this shared formula have the Formula.**fShrFmla** bit set, and a Formula.**cell** that is within the range specified in the **ref** field of this record. + +[TABLE] + +**ref (6 bytes):** A [RefU](#refu) structure that specifies the range of cells that use this shared formula. Cells in this range do not have to use the shared formula. + +**reserved (8 bits):** MUST be zero, and MUST be ignored. + +**cUse (8 bits):** An unsigned integer that specifies the number of cells that use this shared formula. + +**formula (variable):** A [SharedParsedFormula](#sharedparsedformula) structure that specifies the shared formula. + +### ShtProps + +The **ShtProps** record specifies properties of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +[TABLE] + +**A - fManSerAlloc (1 bit):** A bit that specifies whether [series](#Section_527ce4dfc9f84e50a314d4b07519593c) are automatically allocated for the chart. + +**B - fPlotVisOnly (1 bit):** A bit that specifies whether to plot [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) cells only. + +**C - fNotSizeWith (1 bit):** A bit that specifies whether to size the chart with the window. + +**D - fManPlotArea (1 bit):** If **fAlwaysAutoPlotArea** is 1, then this field MUST be 1. If **fAlwaysAutoPlotArea** is 0, then this field MUST be ignored. + +**E - fAlwaysAutoPlotArea (1 bit):** A bit that specifies whether the default [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) [**dimension (2)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) is used. + +| Value | Meaning | +|----|----| +| 0 | Use the default plot area dimension (2) regardless of the [Pos](#pos) record information. | +| 1 | Use the plot area dimension (2) of the Pos record; and **fManPlotArea** MUST be 1. | + +**reserved1 (11 bits):** MUST be zero, and MUST be ignored. + +**mdBlank (1 byte):** An unsigned integer that specifies how the empty cells are plotted be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------------| +| 0x00 | Empty cells are not plotted. | +| 0x01 | Empty cells are plotted as zero. | +| 0x02 | Empty cells are plotted as interpolated. | + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +### SIIndex + +The **SIIndex** record is part of a group of records which specify the data of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). This particular record indicates the type of data contained in the [Number](#number) records following it. + +[TABLE] + +**numIndex (2 bytes):** An unsigned integer that specifies the type of the data records contained by the Number records following it. MUST be a value from the following table: + +| Value | Number Records Following It Contain | +|----|----| +| 0x0001 | [Series](#Section_527ce4dfc9f84e50a314d4b07519593c) values or vertical values (for scatter or bubble [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5)) | +| 0x0002 | [**Category labels**](#gt_f357eb23-3045-4017-87d0-3946b2980a72) or horizontal values (for scatter or bubble chart groups) | +| 0x0003 | [**Bubble sizes**](#gt_3a0cf938-5b61-4460-bdbb-3540d84d4180) | + +### Sort + +The **Sort** record specifies the information used to [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880) values contained in a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +[TABLE] + +**A - fCol (1 bit):** A bit that specifies whether to sort by columns or rows. MUST be one of the values from the following table: + +| Value | Meaning | +|----|----| +| 0 | Sort rows from top to bottom. | +| 1 | Sort columns from [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) to right. | + +**B - fKey1Dsc (1 bit):** A bit that specifies whether **stKey1** sorts in [**descending order**](#gt_f6de77a5-8743-4d03-813a-fa5e4d7c9fe8). MUST be one of the values from the following table: + +| Value | Meaning | +|-------|---------------------------| +| 0 | Sort in ascending order. | +| 1 | Sort in descending order. | + +**C - fKey2Dsc (1 bit):** A bit that specifies whether **stKey2** sorts in descending order. MUST be one of the values from the following table: + +| Value | Meaning | +|-------|---------------------------| +| 0 | Sort in ascending order. | +| 1 | Sort in descending order. | + +**D - fKey3Dsc (1 bit):** A bit that specifies whether **stKey3** sorts in descending order. MUST be one of the values from the following table: + +| Value | Meaning | +|-------|---------------------------| +| 0 | Sort in ascending order. | +| 1 | Sort in descending order. | + +**E - fCaseSensitive (1 bit):** A bit that specifies whether the sort is case-sensitive. MUST be one of the values from the following table: + +| Value | Meaning | +|-------|---------------------------------| +| 0 | The sort is not case-sensitive. | +| 1 | The sort is case-sensitive. | + +**iOrder (5 bits):** A signed integer that specifies the zero-based index of the [**custom list**](#gt_92d2bb3a-2615-4bf8-b87f-887302d4c40c) that specifies the [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7). The set of custom lists is based on the current user's environment. + +**F - fAltMethod (1 bit):** A bit that specifies whether to use [**phonetic information**](#gt_b60c7bf3-21f1-481f-806f-812461e98742) when sorting. MUST be one of the values from the following table: + +| Value | Meaning | +|-------|-----------------------------------------------| +| 0 | Do not use phonetic information when sorting. | +| 1 | Use phonetic information when sorting. | + +**reserved1 (5 bits):** MUST be zero, and MUST be ignored. + +**cchKey1 (1 byte):** An unsigned integer that specifies the length of **stKey1**. + +**cchKey2 (1 byte):** An unsigned integer that specifies the length of **stKey2**. + +**cchKey3 (1 byte):** An unsigned integer that specifies the length of **stKey3**. + +**stKey1 (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the string for the first sort key. MUST exist if and only if **cchKey1** is greater than 0. + +**stKey2 (variable):** An XLUnicodeStringNoCch structure that specifies the string for the second sort key. MUST exist if and only if **cchKey2** is greater than 0. + +**stKey3 (variable):** An XLUnicodeStringNoCch structure that specifies the string for the third sort key. MUST exist if and only if **cchKey3** is greater than 0. + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +### SortData + +The **SortData** record specifies data used for sorting a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0895. + +**A - fCol (1 bit):** A bit that specifies whether to [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880) by columns or rows. MUST be one of the values from the following table: + +| Value | Meaning | +|-------|------------------| +| 0x0 | Sort by rows. | +| 0x1 | Sort by columns. | + +**B - fCaseSensitive (1 bit):** A bit that specifies whether to use a case-sensitive sorting method. MUST be one of the values from the following table: + +| Value | Meaning | +|-------|---------------------------------| +| 0x0 | The sort is not case-sensitive. | +| 0x1 | The sort is case-sensitive. | + +**C - fAltMethod (1 bit):** A bit that specifies whether to use a sorting method other than character order, such as [**stroke order**](#gt_6d6a1f46-4502-44ab-ba14-07b78c9f0a54) or [**Mandarin phonetic symbols**](#gt_1c4c06fb-6eaf-4c13-a975-f014e49a5f3a). MUST be one of the values from the following table: + +| Value | Meaning | +|-------|----------------------------------------------------| +| 0x0 | The sort uses character order. | +| 0x1 | The sort uses a method other than character order. | + +**sfp (3 bits):** An unsigned integer that specifies the type of the object that contains the sort field. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The sort field is contained in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). | +| 0x1 | The sort field is contained in a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). | +| 0x2 | The sort field is contained in an [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). | +| 0x3 | The sort field is contained in a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289). | + +**unused (10 bits):** Undefined and MUST be ignored. + +**rfx (16 bytes):** An [RFX](#rfx) structure that specifies the range to sort. + +**cconditions (4 bytes):** An unsigned integer that specifies the count of [**sort conditions**](#gt_198a56e7-6045-43cf-8acd-793eab3647c1). This record MUST be followed by one [ContinueFrt12](#continuefrt12) record for each sort condition. + +**idParent (4 bytes):** An unsigned integer that specifies the identifier of the object that contains the sort field, if the **sfp** field is 0x1 or 0x3. If the **sfp** field is equal to 0x1, the value of this field MUST be equal to the **idList** field of the associated [TableFeatureType](#tablefeaturetype). If the **sfp** field is equal to 0x3, the value of this field MUST be equal to the zero-based index of the associated query table ([Qsi](#qsi)) in the Qsi records in the current substream. If the **sfp** field is equal to 0x0 or 0x2, this is undefined and MUST be ignored. + +**sortCond12Array (variable):** An array of [SortCond12](#sortcond12) structures that specifies the sort conditions. + +### SST + +The **SST** record specifies string constants. + +Each string constant in this record has one or more references in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), with the goal of improving performance in opening and saving the file. The [LabelSst](#labelsst) record specifies how to make a reference to a string in this record. + +[TABLE] + +**cstTotal (4 bytes):** A signed integer that specifies the total number of references in the workbook to the strings in the shared string table. MUST be greater than or equal to 0. + +**cstUnique (4 bytes):** A signed integer that specifies the number of unique strings in the shared string table. MUST be greater than or equal to 0. + +**rgb (variable):** An array of [XLUnicodeRichExtendedString](#xlunicoderichextendedstring) structures. Records in this array are unique. + +### StartBlock + +The **StartBlock** record specifies the beginning of a collection of records. [Future records](#Section_b660b67822684414839ed1ae9a4e4e85) contained in this collection specify saved features to allow applications that do not support the feature to preserve the information. This record MUST have a matching [EndBlock](#endblock) record. StartBlock and EndBlock pairs can be nested. Up to 100 levels of blocks can be nested. + +Prior to writing a [chart-specific future record](#Section_0d96d51a09bd44ddbb691541de053776), which is a [record](#Section_170e90ce87d747589331dcf14cd72388) with a record number greater than or equal to 2048 and less than or equal to 2303, according to [Record Enumeration](#Section_7c84e174e96f45e0b23fa5e81f8b5def), StartBlock records MUST be written according to the following rules: + +- A StartBlock record MUST NOT be written if the record is preceded by a [StartObject](#startobject) record but not preceded by the matching [EndObject](#endobject) record. That is, StartBlock and EndBlock pairs MUST NOT belong to any collection defined by StartObject and EndObject. + +- If there does not exist a StartBlock record with **iObjectKind** equal to 0x000D without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x000D MUST be written. + +- If the chart-specific future record exists in the sequence of records that conforms to the [DAT](#chart-sheet-substream) rule, and there does not exist a StartBlock record with **iObjectKind** equal to 0x0006 without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x0006 MUST be written. If a StartBlock record is written because of rule number 2, then this StartBlock record MUST be written immediately after that record. + +- If the chart-specific future record is in a [series](#Section_527ce4dfc9f84e50a314d4b07519593c), and there does not exist a StartBlock record with **iObjectKind** equal to 0x000C without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x000C and **iObjectInstance1** equal to the number of series prior to this series in the current [Sheet](#Section_2c90d75bc92645aa8ff29d4483f51831) MUST be written. If any StartBlock records are written because of rule number 2 or 3, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record exists in the sequence of records that conforms to the SS rule, and there does not exist a StartBlock record with **iObjectKind** equal to 0x000E without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x000E, **iObjectContext** equal to the **yi** field of the [DataFormat](#dataformat) record in the current SS rule, and **iObjectInstance1** equal to the **xi** field of the DataFormat record in the current SS rule MUST be written. If any StartBlock records are written because of rule number 2, 3, or 4, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record is in a series, and is part of a collection defined by a [Begin](#begin) and [End](#end) pair written immediately after a [LegendException](#legendexception) record, and there does not exist a StartBlock record with **iObjectKind** equal to 0x000A without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x000A and **iObjectInstance1** equal to the **iss** field of the LegendException record in the series MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, or 5, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record is in an [axis group](#Section_578b739742624944b5a67ee6d4d3bb55). and there does not exist a StartBlock record with **iObjectKind** equal to 0x0000 without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x0000 and **iObjectInstance1** equal to the **iax** field of the [AxisParent](#axisparent) record of the axis group MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, or 6, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record is in a [Chart Group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), and there does not exist a StartBlock record with **iObjectKind** equal to 0x0005 without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x0005 and **iObjectInstance1** equal to the **iax** field of the AxisParent record of the axis group MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, or 7, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record is in an [axis](#Section_4117f73aa0f348d89c0f65864918ffb3), and there does not exist a StartBlock record with **iObjectKind** equal to 0x0004 without a matching EndBlock record, then: + +  + +- If the chart-specific future record exists in the sequence of records that conforms to the IVAXIS rule, then a corresponding StartBlock record with **iObjectKind** equal to 0x0004 and **iObjectInstance1** equal to 0x0000 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, or 8, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record exists in the sequence of records that conforms to the SERIESAXIS rule, then a corresponding StartBlock record with **iObjectKind** equal to 0x0004 and **iObjectInstance1** equal to 0x0002 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, or 8, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record exists in the sequence of records that conforms to the DVAXIS rule, and **wType** of the [Axis](#axis-1) record in the sequence of records that conforms to the DVAXIS rule is equal to 0, then a corresponding StartBlock record with **iObjectKind** equal to 0x0004 and **iObjectInstance1** equal to 0x0001 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, or 8, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record exists in the sequence of records that conforms to the DVAXIS rule, and **wType** of the Axis record in the sequence of records that conforms to the DVAXIS rule is equal to 1, then a corresponding StartBlock record with **iObjectKind** equal to 0x0004 and **iObjectInstance1** equal to 0x0003 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, or 8, then this StartBlock record MUST be written immediately after those records. + +  + +- If the chart-specific future record exists in the sequence of records that conforms to the DROPBAR rule, and there does not exist a StartBlock record with **iObjectKind** equal to 0x000F without a matching EndBlock record, then a corresponding StartBlock record with **iObjectKind** equal to 0x000F and **iObjectInstance1** equal to one less than the number of [DropBar](#dropbar) records written prior to the chart-specific future record in the current Chart Group MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, or 9, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record is in a [legend](#Section_1832229b7d1945f488d455e9c07466f0) and there does not exist a StartBlock record with **iObjectKind** equal to 0x0009 without a matching EndBlock record, then: + +  + +- If the chart-specific future record is in a chart group, then a corresponding StartBlock record with **iObjectKind** equal to 0x0009 and **iObjectContext** equal to 0x0001 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, or 10, then this StartBlock record MUST be written immediately after those records. + +- If the chart-specific future record is not in a chart group, then a corresponding StartBlock record with **iObjectKind** equal to 0x0009 and **iObjectContext** equal to 0x0000 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, or 10, then this StartBlock record MUST be written immediately after those records. + +  + +- If the chart-specific future record is in an [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a), and there does not exist a StartBlock record with **iObjectKind** equal to 0x0002 without a matching EndBlock record, then: + +  + +- If the chart-specific future record exists in the sequence of records that conforms to the DFTTEXT rule of a chart group, and the **id** field of the [DefaultText](#defaulttext) record in the sequence of records that conforms to the DFTTEXT rule is greater than or equal to 0x0002, then a corresponding StartBlock record with **iObjectKind** equal to 0x0002, **iObjectContext** equal to 0x0002, and **iObjectInstance1** equal to 0xFFFF MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, 10, or 11, then this StartBlock record MUST be written immediately after those records. Else, + +- If the chart-specific future record exists in the sequence of records that conforms to the DFTTEXT rule of a chart group, then a corresponding StartBlock record with **iObjectKind** equal to 0x0002, **iObjectContext** equal to 0x0002, and **iObjectInstance1** equal to the **id** field of the DefaultText record in the sequence of records that conforms to the DFTTEXT rule MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, 10, or 11, then this StartBlock record MUST be written immediately after those records. Else, + +- If the **wLinkVar1** of the [ObjectLink](#objectlink) record of the attached label is equal to 0x0003, then a corresponding StartBlock record with **iObjectKind** equal to 0x0002, **iObjectContext** equal to 0x0004 and **iObjectInstance1** equal to 0x0000 MUST be written. If any StartBlock records are written because of rules number 2, 3, 4, 5, 6, 7, 8, 9, 10 or 11, then this StartBlock record MUST be written immediately after those records. Else, + +- If the **wLinkVar1** of the ObjectLink record of the attached label is equal to 0x0002, then a corresponding StartBlock record with **iObjectKind** equal to 0x0002, **iObjectContext** equal to 0x0004 and **iObjectInstance1** equal to 0x0001 MUST be written. If any StartBlock records are written because of rules number 2, 3, 4, 5, 6, 7, 8, 9, 10 or 11, then this StartBlock record MUST be written immediately after those records. Else, + +- If the **wLinkVar1** of the ObjectLink record of the attached label is equal to 0x0007, then a corresponding StartBlock record with **iObjectKind** equal to 0x0002, **iObjectContext** equal to 0x0004, and **iObjectInstance1** equal to 0x0002 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, 10, or 11, then this StartBlock record MUST be written immediately after those records. Else, + +- If the chart-specific future record is in the first attached label of a chart sheet, then a corresponding StartBlock record with **iObjectKind** equal to 0x0002 and **iObjectContext** equal to 0x0000 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, 10, or 11, then this StartBlock record MUST be written immediately after those records. Else, + +- If the chart-specific future record is not in the first attached label of a chart sheet, then a corresponding StartBlock record with **iObjectKind** equal to 0x0002 and **iObjectContext** equal to 0x0005, **iObjectInstance1** equal to **wLinkVar1** of the ObjectLink record of the attached label and **iObjectInstance2** equal to **wLinkVar2** of the ObjectLink record of the attached label MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, 10, or 11, then this StartBlock record MUST be written immediately after those records. + +  + +- If the chart-specific future record exists in the sequence of records that conforms to the FRAME rule, and there does not exist a StartBlock record with **iObjectKind** equal to 0x0007 without a matching EndBlock record, then: + +  + +- If the chart-specific future record is in an attached label or legend, then a corresponding StartBlock record with **iObjectKind** equal to 0x0007, **iObjectContext** equal to 0x0000, and **iObjectInstance1** equal to 0x0000 MUST be written. If any StartBlock records are written because of rules number 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12, then this StartBlock record MUST be written immediately after those records. Else, + +- If the chart-specific future record exists in the sequence of records that conforms to the AXES rule, then a corresponding StartBlock record with **iObjectKind** equal to 0x0007, **iObjectContext** equal to 0x0001, and **iObjectInstance1** equal to 0x0000 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12, then this StartBlock record MUST be written immediately after those records. Else, + +- If the chart-specific future record is in a Sheet, then a corresponding StartBlock record with **iObjectKind** equal to 0x0007, **iObjectContext** equal to 0x0002, and **iObjectInstance1** equal to 0x0000 MUST be written. If any StartBlock records are written because of rule number 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12, then this StartBlock record MUST be written immediately after those records. + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0852. + +**iObjectKind (2 bytes):** An unsigned integer that specifies the type of object that is encompassed by the block. MUST be a value from the following table: + +| Value | Object Type | +|--------|------------------------| +| 0x0000 | Axis group | +| 0x0002 | Attached label record | +| 0x0004 | Axis | +| 0x0005 | Chart group | +| 0x0006 | [Dat](#dat) record | +| 0x0007 | Frame | +| 0x0009 | Legend | +| 0x000A | LegendException record | +| 0x000C | Series | +| 0x000D | Sheet | +| 0x000E | DataFormat record | +| 0x000F | DropBar record | + +**iObjectContext (2 bytes):** An unsigned integer that specifies the context of the object. This value further specifies the object specified in **iObjectKind**. MUST be a value from the following table: + +[TABLE] + +**iObjectInstance1 (2 bytes):** An unsigned integer that specifies additional information about the context of the object, together with **iObjectContext**, **iObjectInstance2,** and **iObjectKind**. This field MUST equal one of the values specified in the previous [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) under the **iObjectContext** field. + +**iObjectInstance2 (2 bytes):** An unsigned integer that specifies more information about the object context, together with **iObjectContext**, **iObjectInstance1**, and **iObjectKind.** This field MUST equal one of the values specified in the previous table under the **iObjectContext** field. + +### StartObject + +The **StartObject** record specifies the beginning of a collection of [Future Record Type](#Section_b660b67822684414839ed1ae9a4e4e85) records as defined by the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a feature saved as a Future Record Type such that an application that does not support the feature can preserve it. This record MUST have a matching [EndObject](#endobject) record. StartObject and EndObject pairs can be nested. Up to 100 levels of blocks can be nested. + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0854. + +**iObjectKind (2 bytes):** An unsigned integer that specifies the kind of object that is encompassed by the block. MUST be a value from the following table: + +[TABLE] + +**iObjectContext (2 bytes):** An unsigned integer that specifies the object context. MUST be 0x0000. + +**iObjectInstance1 (2 bytes):** An unsigned integer that specifies additional information about the context of the object, together with **iObjectContext**, **iObjectInstance2**, and **iObjectKind**. This field MUST equal 0x0000 if **iObjectKind** is equal to 0x0010 or 0x0012. MUST be a value from the following table if **iObjectKind** is equal to 0x0011: + +| iObjectInstance1 | Application Version | +|----|----| +| 0x0008 | Specifies the application version.[\<120\>](#Appendix_A_120) | +| 0x0009 | Specifies the application version.[\<121\>](#Appendix_A_121) | +| 0x000A | Specifies the application version.[\<122\>](#Appendix_A_122) | +| 0x000B | Specifies the application version.[\<123\>](#Appendix_A_123) | +| 0x000C | Specifies the application version.[\<124\>](#Appendix_A_124) | +| 0x000E | Specifies the application version.[\<125\>](#Appendix_A_125) | +| 0x000F | Specifies the application version.[\<126\>](#Appendix_A_126) | + +**iObjectInstance2 (2 bytes):** An unsigned integer that specifies more information about the object context, together with **iObjectContext**, **iObjectInstance1** and **iObjectKind.** This field MUST equal 0x0000. + +### String + +The **String** record specifies the string value of a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). + +[TABLE] + +**string (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the string value of a formula (section 2.2.2). The value of **string.cch** MUST be less than or equal to 32767. + +### Style + +The **Style** record specifies a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7). + +[TABLE] + +**ixfe (12 bits):** An unsigned integer that specifies the zero-based index of the [cell style XF](#Section_3d5348ded9df4c31b1fd9f9377273152) in the collection of [XF](#xf) records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). See [XFIndex](#xfindex) for more information about the organization of XF records in the file. + +**A - unused (3 bits):** Undefined and MUST be ignored. + +**B - fBuiltIn (1 bit):** A bit that specifies whether the cell style is built-in. + +**builtInData (2 bytes):** An optional [BuiltInStyle](#builtinstyle) structure that specifies the built-in cell style properties. MUST exist if and only if **fBuiltIn** is 1. The value of **builtInData.istyBuiltIn** MUST be less than or equal to 0x09. + +**user (variable):** An optional [XLUnicodeString](#xlunicodestring) structure that specifies the name of the user-defined cell style. MUST exist if and only if **fBuiltIn** is 0. The number of characters in this string SHOULD be greater than or equal to 1 and MUST be less than or equal to 255.[\<127\>](#Appendix_A_127) + +### StyleExt + +The **StyleExt** record specifies additional information for a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7). + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0892. + +**A - fBuiltIn (1 bit):** A bit that specifies if this is a built-in cell style. If the value is 1, this is a built-in cell style. This value MUST match the **fBuiltIn** field of the preceding [Style](#style) record. + +**B - fHidden (1 bit):** A bit that specifies whether the cell style is not displayed in the user interface. + +**C - fCustom (1 bit):** A bit that specifies whether the built-in cell style was modified by the user and thus has a custom definition. If this field is equal to 1, then **fBuiltIn** MUST equal 1. + +**reserved (5 bits):** MUST be zero and MUST be ignored. + +**iCategory (1 byte):** An unsigned integer that specifies which [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) that this style belongs to. MUST be one of the values from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------------------------| +| 0x00 | Custom style | +| 0x01 | Good, bad, neutral style | +| 0x02 | Data model style | +| 0x03 | Title and heading style | +| 0x04 | Themed cell style | +| 0x05 | [**Number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) style | + +**builtInData (2 bytes):** A [BuiltInStyle](#builtinstyle) structure that specifies the built-in cell style properties. If **fBuiltIn** is 0, this field MUST be 0xFFFF and MUST be ignored. If **fBuiltIn** is 1, this field MUST match the **builtInData** field of the preceding Style record. + +**stName (variable):** An [LPWideString](#lpwidestring) structure that specifies the name of the style to extend. MUST be less than or equal to 255 characters in length. If **fBuiltIn** is 0, the name specified by this field MUST match the name specified by the **user** field of the preceding Style record. + +**xfProps (variable):** An [XFProps](#xfprops) structure that specifies the formatting properties. + +### SupBook + +The **SupBook** record specifies a [supporting link](#Section_cc5920ba01074d92bbdfc12ca986f31f) and specifies the beginning of a collection of records as defined by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies the contents of an [external workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc), [DDE data source](#Section_b11538fba8244cc3bf8834a1cf5f3559), or [OLE data source](#Section_2318e95632614d72a28e412392b8c919). + +[TABLE] + +**ctab (2 bytes):** An undefined field, a reserved field, or an unsigned integer that specifies the number of [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in a referenced external workbook. The type and meaning of this field is dependent on the type of supporting link specified by the **cch** and **virtPath** fields, and is defined in the following table: + +[TABLE] + +**cch (2 bytes):** An unsigned integer that specifies a type of supporting link or specifies the length of the string in **virtPath**. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0401 | This record specifies a self-referencing supporting link. | +| 0x3A01 | This record specifies an add-in referencing type of supporting link. The names of all [**add-in functions**](#gt_19f0478a-919a-4951-b8c0-f9900a1ddd3e) implemented by [**XLL**](#gt_3d6e3f45-91e7-46d5-871c-0b2fde20b5f5), or [**COM**](#gt_ef2ebebc-1760-407a-9ace-af48f9050e02) automation [**add-ins**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6) that are referenced by formulas in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), MUST be specified in the [ExternName](#externname) records that follow this record. | +| 0x0001 to 0x00ff (inclusive) | The type of supporting link specified by this record is specified by **virtPath**. This value is the count of characters in **virtPath**. | + +**virtPath (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the type of supporting link and, if applicable, the target of that supporting link. This field MUST exist if and only if the value of **cch** is between 0x0001 and 0x00ff (inclusive). The length of the string in this field MUST be equal to **cch**. The contents of this field MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| A single character of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) value 0x20 (SPACE) | This record specifies an unused supporting link. This supporting link MUST NOT be used by any [external reference consumers](#Section_70b28c8b29cb4aff89f5d6023c28fbf6). | +| A single character of Unicode value 0x00 (NULL) | This record specifies a same-sheet referencing type of supporting link. | +| A string that conforms to the OLE-link rule, as specified in [VirtualPath](#virtualpath) | This record specifies a DDE data source referencing or an OLE data source referencing type of supporting link. The value of this field specifies the target of the supporting link. | +| A string that conforms to the virt-path rule, but does not conform to the ole-link rule, as specified in VirtualPath | This record specifies an external workbook referencing type of supporting link. The value of this field specifies the path and file name of the external workbook. | + +**rgst (variable):** An array of [XLUnicodeString](#xlunicodestring) structures that specify sheet names in the external workbook. This field MUST exist if and only if the supporting link type specified by **cch** and **virtPath** is external workbook referencing or unused. If this field exists, the number of elements in this array MUST be equal to **ctab.** The contents and meaning of this array are defined in the following table: + +| Type of supporting link | rgst value | +|----|----| +| External workbook referencing | An array of XLUnicodeString structures that specify the sheet names in the external workbook. Each element in this array MUST conform to the restrictions set on the **stName** field of the [BoundSheet8](#boundsheet8) record. | +| Unused | An array of XLUnicodeString structures that provide placeholders for any [XTI](#xti) references to sheets in this unused supporting link. Each element in this array MUST be a string that contains a single character of Unicode value 0x20 (SPACE). | + +### Surf + +The **Surf** record specifies that the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is a surface chart group and specifies the chart group attributes. + +[TABLE] + +**A - fFillSurface (1 bit):** A bit that specifies whether the surface chart group is wireframe or has a [**fill**](#gt_215c1c51-d5ef-46af-8596-d7ef63c1fe89). MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------| +| 0 | Surface chart group is wireframe. | +| 1 | Surface chart group has a fill. | + +**B - f3DPhongShade (1 bit):** A bit that specifies whether [**3-D Phong shading**](#gt_f97b18d4-bf3e-4e80-bd1c-4f58aba7c43b) is displayed. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +### SXAddl Records + +#### Continue_SxaddlSxString + +The **Continue_SxaddlSxString** record specifies a continuation of the [SXAddl_SXString](#sxaddl_sxstring) in the preceding [SXAddl](#sxaddl) record. If the string specified by the SXAddl_SXString is longer than 255 characters, the first 255 characters of the string exist in the SXAddl_SXString in the preceding SXAddl record. Subsequent 255 character segments exist in one or more Continue_SxaddlSxString records that exist after the SXAddl record. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of the **hdr.sxc** field MUST equal the value of the **hdr.sxc** field of the preceding SXAddl record and the **hdr.sxd** field MUST equal the value of the **hdr.sxd** field of the preceding SXAddl record. + +**stContinue (variable):** An SXAddl_SXString structure that specifies the next segment of the string. + +#### SXAddl + +The **SXAddl** record specifies additional information for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e), or [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289). The current [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) and full type of this record are specified by the **hdr** field which determines the contents of the **data** field. See [Usage of SXAddl records](#Section_db61fa8bdb7b4e1c99615c2f3ed1c369) for more information. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure that specifies header information for an SXAddl record. + +**data (variable):** A variable-size field that contains data specific to the full record type of the SXAddl record. + +#### SXAddl_SXCAutoSort_SXDEnd + +The **SXAddl_SXCAutoSort_SXDEnd** record specifies the end of an [SXCAutoSort class](#Section_212512d2c740431f838b7ec651364e2f). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x12 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCAutoSort_SXDId + +The **SXAddl_SXCAutoSort_SXDId** record specifies information for [pivot field sorting](#Section_6a008d4253834e13a1d06d8ee5d93b76) for an [SXCAutoSort class](#Section_212512d2c740431f838b7ec651364e2f). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x12 and the value of **hdr.sxd** MUST equal 0x00. + +**A - fAscendSort (1 bit):** A bit that specifies whether the [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7) is ascending or descending. The value MUST be one of the values from the following table: + +| Value | Description | +|-------|---------------------------| +| 0 | Sort order is descending. | +| 1 | Sort order is ascending. | + +**reserved1 (31 bits):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCache_SXDEnd + +The **SXAddl_SXCCache_SXDEnd** record specifies the end of an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x03 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCache_SXDId + +The **SXAddl_SXCCache_SXDId** record specifies how an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7) is associated with other records for a [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x03 and the value of **hdr.sxd** MUST equal 0x00. + +> **idCache (4 bytes):** An unsigned integer that specifies the PivotCache [**stream**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) associated with this SxcCache class. MUST be equal to the **idStm** field of the [SXStreamID](#sxstreamid) record of the PivotCache stream associated with this SxcCache class. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCache_SXDInfo12 + +The **SXAddl_SXCCache_SXDInfo12** record specifies information for a [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) for an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x03 and the value of **hdr.sxd** MUST equal 0x41. + +**A - fSheetData (1 bit):** MUST be zero, and MUST be ignored. + +**B - fSrvSupportAttribDrill (1 bit):** A bit that specifies whether the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) of the PivotCache supports attribute drilldown. MUST be ignored if the data source is not [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f). + +**C - fSrvSupportSubQuery (1 bit):** A bit that specifies whether the data source of the PivotCache supports the MDX SUBSELECT statement. MUST be ignored if the data source is not OLAP. + +**reserved1 (29 bits):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCache_SXDInvRefreshReal + +The **SXAddl_SXCCache_SXDInvRefreshReal** record specifies properties related to [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) for an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x03 and the value of **hdr.sxd** MUST equal 0x34. + +**A - fEnableRefresh (1 bit):** A bit that specifies whether refresh is enabled for the PivotCache. + +**B - fInvalid (1 bit):** A bit that specifies whether the [cache records](#Section_fe6e4ca0a9b646a4898124e4b61a770a) are not valid. If the value is 1, the cache records MUST be ignored. See cache record for more information. + +**reserved1 (30 bits):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCache_SXDVer10Info + +The **SXAddl_SXCCache_SXDVer10Info** record specifies information for a [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) for an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x03 and the value of **hdr.sxd** MUST equal 0x02. + +**reserved1 (6 bytes):** MUST be zero, and MUST be ignored. + +**citmGhostMax (4 bytes):** A signed integer that specifies the number of unused [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) to allow before discarding unused cache items. MUST[\<128\>](#Appendix_A_128) be greater than or equal to -1 and less than or equal to 1048576. If this value is -1, the number of unused cache items retained by the application is optimized to balance memory usage on the system and future usage of cache items. + +**bVerCacheLastRefresh (1 byte):** A [DataFunctionalityLevel](#datafunctionalitylevel) type that specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) that the PivotCache was last refreshed with. MUST be 0xFF or one of the values of the DataFunctionalityLevel type. If this value is equal to 0xFF, the data functionality level is not set. + +**bVerCacheRefreshableMin (1 byte):** A DataFunctionalityLevel type that specifies the lowest data functionality level the application is allowed to [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) the PivotCache with. MUST be 0xFF or one of the values of the DataFunctionalityLevel type. If this value is equal to 0xFF, the data functionality level is not set. + +**numDateCopy (8 bytes):** A [DateAsNum](#dateasnum) structure that specifies the date and time when the PivotCache was last refreshed. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCache_SXDVerSXMacro + +The **SXAddl_SXCCache_SXDVerSXMacro** record specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) of the application that created the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) for an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x03 and the value of **hdr.sxd** MUST equal 0x18. + +**dwVer (1 byte):** A [DataFunctionalityLevel](#datafunctionalitylevel) type that specifies the data functionality level that the PivotCache was created with. + +**reserved1 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCache_SXDVerUpdInv + +The **SXAddl_SXCCache_SXDVerUpdInv** record specifies the record-handling behavior for following records of the [SXCCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + +[TABLE] + +**data (12 bytes):** An [SXAddl_SXDVerUpdInv](#sxaddl_sxdverupdinv) structure. The value of **data.hdr.sxc** MUST equal 0x03 and the value of **data.hdr.sxd** MUST equal 0x01. The value of **data.dwVersionInvalidates** MUST equal 0x0002 or 0x00FF. + +If the value of **data.dwVersionInvalidates** is not 0x00FF and is greater than or equal to the value of the **bVerCacheLastRefresh** field of the [SXAddl_SXCCache_SXDVer10Info](#sxaddl_sxccache_sxdver10info) record of this SXCCache class, the following records of this SXCCache class (including nested classes or until another SXAddl_SXCCache_SXDVerUpdInv record is encountered) MUST be ignored. + +#### SXAddl_SXCCacheField_SXDCaption + +The **SXAddl_SXCCacheField_SXDCaption** record specifies the caption of a [cache field](#Section_6497eb794042445780e75959c9f0583c) for an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). This record exists only if this is an [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b) and the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than 2. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0x2F. + +**stCaption (variable):** A [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the caption of the cache field. The number of characters in the string MUST be less than or equal to 255. + +#### SXAddl_SXCCacheField_SXDEnd + +The **SXAddl_SXCCacheField_SXDEnd** record specifies the end of an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCacheField_SXDId + +The **SXAddl_SXCCacheField_SXDId** record specifies how an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103) is associated with other records for a [cache field](#Section_6497eb794042445780e75959c9f0583c). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0x00. + +**stSourceName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the cache field to which this SxcCacheField class applies. The number of characters in the string MUST be less than or equal to 255. The corresponding [SXFDB](#sxfdb) record is the SXFDB record with its **stFieldName** field equal to the value of this field. If there exists no such SXFDB record, then this SxcCacheField class MUST be ignored. + +#### SXAddl_SXCCacheField_SXDIfdbMempropMap + +The **SXAddl_SXCCacheField_SXDIfdbMempropMap** record specifies the indexes of the [member properties](#Section_e5db3a66677f43db8fb038584797c95f) for the [cache field](#Section_6497eb794042445780e75959c9f0583c) for an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). This record exists only if this is an [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b) and the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than 2. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0x30. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +**rgMap (variable):** An array of 2-byte unsigned integers. The array MUST NOT be empty. Each element in the array specifies a cache field index, as specified by Cache Fields. The referenced cache field is associated with a member property as specified in member properties. The **isxtl** field of the [SXVDTEx](#sxvdtex) record of the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) associated with the referenced cache field MUST be equal to 0x00007FFF or equal to **isxtl** of the SXVDTEx record of the pivot field associated with this cache field. The **ihdb** field of the [SXAddl_SXCCacheField_SXDProperty](#sxaddl_sxccachefield_sxdproperty) record associated with the referenced cache field MUST be equal to the **isxth** field of SXVDTEx record of the pivot field associated with this cache field. The size of the array MUST be equal to the **ifdbMemProp** field in the [SXAddl_SXCCacheField_SXDIfdbMpMapCount](#sxaddl_sxccachefield_sxdifdbmpmapcount) record in this [SXAddl](#sxaddl) collection. The value of each element in the array MUST be less than the number of cache fields in this [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) as specified by the cfdbdb field of the [SXDB](#sxdb) record for this PivotCache. + +#### SXAddl_SXCCacheField_SXDIfdbMpMapCount + +The **SXAddl_SXCCacheField_SXDIfdbMpMapCount** record specifies the number of [member properties](#Section_e5db3a66677f43db8fb038584797c95f) for the [cache field](#Section_6497eb794042445780e75959c9f0583c), for an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). This record exists only if this is an [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b) and the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than 2. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0x31. + +**ifdbMemProp (4 bytes):** An unsigned integer that specifies the number of elements in the array specified by the **rgMap** field of the [SXAddl_SXCCacheField_SXDIfdbMempropMap](#sxaddl_sxccachefield_sxdifdbmempropmap) record that follows this record. MUST be greater than 0 and less than the number of cache fields in this [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCacheField_SXDProperty + +> The **SXAddl_SXCCacheField_SXDProperty** record specifies the hierarchy information of the [cache field](#Section_6497eb794042445780e75959c9f0583c) for an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). This record exists only if this is an [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b), the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than 2, and this cache field is associated with a [member property](#Section_e5db3a66677f43db8fb038584797c95f). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0x05. + +**ihdb (4 bytes):** An unsigned integer that specifies a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) index. The pivot hierarchy index specifies which pivot hierarchy this cache field is part of. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCacheField_SXDPropName + +The **SXAddl_SXCCacheField_SXDPropName** record specifies the name of a [member property](#Section_e5db3a66677f43db8fb038584797c95f) of the associated [cache field](#Section_6497eb794042445780e75959c9f0583c) for an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). This record exists only if this is an [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b), the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than 2, and this cache field is associated with a member property. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0x40. + +**stPropName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the member property associated with this cache field. The length of the string MUST be greater than 0 and less than 32768. + +#### SXAddl_SXCCacheField_SXDSxrmitmCount + +The **SXAddl_SXCCacheField_SXDSxrmitmCount** record specifies the number of [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) records in this [cache field](#Section_6497eb794042445780e75959c9f0583c) for an [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). This record exists only if this is an [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b) and the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than 2. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x04 and the value of **hdr.sxd** MUST equal 0x2D. + +**citm (4 bytes):** An unsigned integer that specifies the number of cache item records. The value MUST be greater than or equal to 0 and less than or equal to 1048576. The number of [SXADDLCACHEITEM](#globals-substream) collections that follows this record MUST match this value. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCacheItem_SXDEnd + +The **SXAddl_SXCCacheItem_SXDEnd** record specifies the end of a collection of [SxcCacheItem classes](#Section_23b4298b5a8e4357b2c07c2ea90d91c5) for the [SxcCacheField class](#Section_102acda2fb58485d9a40a37d0a219103). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x09 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCacheItem_SXDId + +The **SXAddl_SXCCacheItem_SXDId** record specifies how an [SxcCacheItem class](#Section_23b4298b5a8e4357b2c07c2ea90d91c5) is associated with other records for a [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0). The records of this class exist if and only if this is an [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b), the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than or equal to 3, the **fAllAtoms** field of the [SXFDB](#sxfdb) record of this [cache field](#Section_6497eb794042445780e75959c9f0583c) is equal to 1, and the **catm** field of that SXFDB record is greater than 0. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x09 and the value of **hdr.sxd** MUST equal 0x00. + +**dwItem (4 bytes):** An unsigned integer that specifies the cache item index that this SxcCacheItem class applies to. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCacheItem_SXDItmMpMapCount + +The **SXAddl_SXCCacheItem_SXDItmMpMapCount** record specifies the number of [member property](#Section_e5db3a66677f43db8fb038584797c95f) mappings for this [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0), for an [SxcCacheItem class](#Section_23b4298b5a8e4357b2c07c2ea90d91c5). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x09 and the value of **hdr.sxd** MUST equal 0x33. + +**cMemProps (4 bytes):** An unsigned integer that specifies the number of member property mappings for this cache item. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCCacheItem_SXDItmMpropMap + +The **SXAddl_SXCCacheItem_SXDItmMpropMap** record specifies the mapping of the [member properties](#Section_e5db3a66677f43db8fb038584797c95f) for this [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0), for an [SxcCacheItem class](#Section_23b4298b5a8e4357b2c07c2ea90d91c5). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x09 and the value of **hdr.sxd** MUST equal 0x32. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +**rgMemProps (variable):** An array of 4-byte signed integers. Each element of this array specifies a cache item index, as specified by Cache Items, in the [cache field](#Section_6497eb794042445780e75959c9f0583c) associated with that element. For a given element, the associated cache field is the cache field specified by the element with the same index in the **rgMap** array of the preceding [SXAddl_SXCCacheField_SXDIfdbMempropMap](#sxaddl_sxccachefield_sxdifdbmempropmap) record. Each referenced cache item specifies a member property value. + +A value of -1 specifies no cache item. Each element in this array MUST be greater than or equal to -1. + +#### SXAddl_SXCCacheItem_SXDSxrmitmDisp + +The **SXAddl_SXCCacheItem_SXDSxrmitmDisp** record specifies the display name of this [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) for an [SxcCacheItem class](#Section_23b4298b5a8e4357b2c07c2ea90d91c5). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x09 and the value of **hdr.sxd** MUST equal 0x2E. + +**stDisplay (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the display name of this cache item. + +#### SXAddl_SXCField_SXDEnd + +The **SXAddl_SXCField_SXDEnd** record specifies the end of an [SxcField class](#Section_51de615365d949198b2a537779e0a9f7). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x01 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCField_SXDId + +The **SXAddl_SXCField_SXDId** record specifies how an [SxcField class](#Section_51de615365d949198b2a537779e0a9f7) is associated with other records for a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x01 and the value of **hdr.sxd** MUST equal 0x00. + +**stName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the pivot field to which this SxcField class applies. The corresponding [SXFDB](#sxfdb) record, of the associated [cache field](#Section_6497eb794042445780e75959c9f0583c) of this pivot field, is the SXFDB record with its **stFieldName** field equal to the value of this field. If there exists no such SXFDB record, then this SxcField class MUST be ignored. + +#### SXAddl_SXCField_SXDVer10Info + +The **SXAddl_SXCField_SXDVer10Info** record specifies additional properties of the [PivotTable fields](#Section_1edf7f2294084945b2de56526c14fca5) for an [SxcField class](#Section_51de615365d949198b2a537779e0a9f7). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x01 and the value of **hdr.sxd** MUST equal 0x02. + +**A - fHideDD (1 bit):** A bit that specifies whether the per pivot field drop-down user interface is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) for the pivot field. + +**reserved1 (31 bits):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCField12_SXDAutoshow + +The **SXAddl_SXCField12_SXDAutoshow** record specifies the number of items for [simple filters](#Section_d662b8d1d1234fc5bac05fd76cdf0ff0) in the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) for an [SXCField12 class](#Section_4bd42ced53544e2ea2665ea9f7787a85). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x17 and the value of **hdr.sxd** MUST equal 0x37. + +**citmAutoShow (4 bytes):** An unsigned integer that specifies the number of items for simple filters. The value MUST be greater than or equal to 1 and less than or equal to 0x7FFFFFFF. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCField12_SXDEnd + +The **SXAddl_SXCField12_SXDEnd** record specifies the end of an [SXCField12 class](#Section_4bd42ced53544e2ea2665ea9f7787a85). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x17 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCField12_SXDId + +The **SXAddl_SXCField12_SXDId** record specifies how this [SXCField12 class](#Section_4bd42ced53544e2ea2665ea9f7787a85) is associated with other records for a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x17 and the value of **hdr.sxd** MUST equal 0x00. + +**stName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the pivot field to which this SXCField12 class applies. The corresponding [SXFDB](#sxfdb) record, of the associated [cache field](#Section_6497eb794042445780e75959c9f0583c) of this pivot field, is the SXFDB record with its **stFieldName** field equal to the value of this field. If there exists no such SXFDB record, then this SXCField12 class MUST be ignored. + +#### SXAddl_SXCField12_SXDISXTH + +The **SXAddl_SXCField12_SXDISXTH** record specifies a particular [Pivot Hierarchy](#Section_54818c671590494084e0c3ff8b433c33) to which this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) is associated for an [SXCField12 class](#Section_4bd42ced53544e2ea2665ea9f7787a85). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x17 and the value of **hdr.sxd** MUST equal 0x1C. + +**isxth (4 bytes):** An unsigned integer that specifies a pivot hierarchy index that specifies the pivot hierarchy to which this pivot field is associated. See [Association of Pivot Hierarchies and Pivot Fields and Cache Fields](#Section_01a66b9be4a24396b55c28d6207fd28f) for more information. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCField12_SXDMemberCaption + +The **SXAddl_SXCField12_SXDMemberCaption** record specifies the name of the [member property](#Section_e5db3a66677f43db8fb038584797c95f) used as a caption for the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5), for an [SXCField12 class](#Section_4bd42ced53544e2ea2665ea9f7787a85). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x17 and the value of **hdr.sxd** MUST equal 0x11. + +**stMemberPropertyCaptionUnique (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the unique name of the member property used as a caption for the pivot field. MUST be ignored if the value of **fUseMemPropCaption** in [SXAddl_SXCField12_SXDVer12Info](#sxaddl_sxcfield12_sxdver12info) is not equal to 1. + +#### SXAddl_SXCField12_SXDVer12Info + +The **SXAddl_SXCField12_SXDVer12Info** record specifies additional properties of a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) for an [SXCField12 class](#Section_4bd42ced53544e2ea2665ea9f7787a85). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x17 and the value of **hdr.sxd** MUST equal 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - fHiddenLvl (1 bit):** A bit that specifies whether the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) pivot field is a [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) level. The value is ignored if it is not an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f). + +**C - fUseMemPropCaption (1 bit):** A bit that specifies whether the [member property](#Section_e5db3a66677f43db8fb038584797c95f) is used as a caption for the pivot field. If it is set and there is a [SXAddl_SXCField12_SXDMemberCaption](#sxaddl_sxcfield12_sxdmembercaption) record in this SXCField12 class, then the value from the member property specified by SXAddl_SXCField12_SXDMemberCaption is used as captions for the [pivot items](#Section_58891cc5dd9b4293a97831070779524f) of this pivot field. + +**D - fCompact (1 bit):** A bit that specifies where the next pivot field is displayed in the [PivotTable layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4). + +| Value | Meaning | +|----|----| +| 0x0 | The pivot field is displayed in the next column on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). | +| 0x1 | The pivot field is displayed in the same column on the sheet. | + +**E - fNotAutoSortDft (1 bit):** A bit that specifies whether, during the next sort operation that is done on this pivot field, the pivot items are sorted or whether the sort condition is remembered and reapplied on subsequent recalculation of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). A value of 1 specifies that pivot items are to be sorted. + +**F - fFilterInclusive (1 bit):** A bit that specifies whether any [manual filter](#Section_b0b282651e334c86ad030f5693c1d1e4) applied to this pivot field specifies pivot items that are included or excluded. If this pivot field is associated with a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), this value MUST equal the **fFilterInclusive** field on the [SXTH](#sxth) record that specifies the pivot hierarchy that this pivot field is associated with. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Any manual filter applied to this pivot field specifies pivot items that are excluded. | +| 0x1 | Any manual filter applied to this pivot field specifies pivot items that are included. | + +**reserved2 (26 bits):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCField12_SXDVerUpdInv + +The **SXAddl_SXCField12_SXDVerUpdInv** record specifies the record handling behavior for following records of the [SXCField12 class](#Section_4bd42ced53544e2ea2665ea9f7787a85). + +[TABLE] + +**data (12 bytes):** An [SXAddl_SXDVerUpdInv](#sxaddl_sxdverupdinv) structure. The value of **data.hdr.sxc** MUST equal 0x17 and the value of **data.hdr.sxd** MUST equal 0x01. The value of **data.dwVersionInvalidates** MUST equal 0x0002 or 0x00FF. + +If the value of **data.dwVersionInvalidates** is not equal to 0x00FF and is greater than or equal to the value of the **VerSxLastUpdated** field of the [QsiSXTag](#qsisxtag) record of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), the following records of this SXCField12 class, including nested classes or until another SXAddl_SXCField12_SXDVerUpdInv record is encountered, MUST be ignored. + +#### SXAddl_SXCGroup_SXDEnd + +The **SXAddl_SXCGroup_SXDEnd** record specifies the end of an [SxcGroup class](#Section_664bdb47dfb148b69cbd2d9b6bc48600). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x08 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCGroup_SXDGrpInfo + +The **SXAddl_SXCGroup_SXDGrpInfo** record specifies information about an [OLAP grouping](#Section_1e04807706d14d4f961ecacb50a12a3d) for an [SxcGroup class](#Section_664bdb47dfb148b69cbd2d9b6bc48600). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x08 and the value of **hdr.sxd** MUST equal 0x07. + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - reserved1 (2 bits):** MUST be zero, and MUST be ignored. + +**C - unused2 (1 bit):** Undefined and MUST be ignored. + +**D - fHasNoParent (1 bit):** A bit that specifies whether the **stParentUniqueName** field does not exist. + +**reserved2 (27 bits):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**stUniqueName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the fully qualified unique name of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) group. The length of this field MUST be less than or equal to 255 characters. + +**stCaption (variable):** An XLUnicodeString structure that specifies the caption (display name) of the OLAP group. The length of this field MUST be less than or equal to 255 characters. + +**stParentUniqueName (variable):** An optional XLUnicodeString structure that specifies an [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32), which is the parent of the [**members (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) of this group in the OLAP [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7). This field exists if and only if the value of **fHasNoParent** is zero. The length of this field MUST be less than or equal to 255 characters. + +**iGroupNum (4 bytes):** A signed integer that specifies a unique identifier for this OLAP group within the OLAP grouping level containing it. MUST be greater than zero. + +#### SXAddl_SXCGroup_SXDId + +The **SXAddl_SXCGroup_SXDId** record specifies information about an [OLAP grouping](#Section_1e04807706d14d4f961ecacb50a12a3d) for an [SxcGroup class](#Section_664bdb47dfb148b69cbd2d9b6bc48600). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x08 and the value of **hdr.sxd** MUST equal 0x00. + +**stName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) group. MUST contain less than or equal to 255 characters. + +#### SXAddl_SXCGroup_SXDMember + +The **SXAddl_SXCGroup_SXDMember** record specifies an [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) or the name of a group in the subsequent [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) that is part of this [OLAP grouping](#Section_1e04807706d14d4f961ecacb50a12a3d) for an [SxcGroup class](#Section_664bdb47dfb148b69cbd2d9b6bc48600). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x08 and the value of **hdr.sxd** MUST equal 0x08. + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - fGroup (1 bit):** A bit that specifies whether this record specifies the name of a group in the subsequent OLAP level. + +| Value | Meaning | +|----|----| +| 0 | This record specifies an OLAP member. | +| 1 | This record specifies the name of a group in the subsequent OLAP level. | + +**C - unused2 (1 bit):** Undefined and MUST be ignored. + +**reserved1 (29 bits):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +**stUnique (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of an OLAP member or the name of a group in the subsequent OLAP level. If the value of **fGroup** is 0, this is an MDX unique name of an OLAP member. If the value of **fGroup** is 1, this is a group name and it MUST match the **stName** field in one of the [SXAddl_SXCGroup_SXDId](#sxaddl_sxcgroup_sxdid) records for the subsequent OLAP level. The length of this field MUST be less than or equal to 255 characters. + +#### SXAddl_SXCGrpLevel_SXDEnd + +The **SXAddl_SXCGrpLevel_SXDEnd** record specifies the end of an [SxcGrpLevel class](#Section_86689e7b9d264225b6be580f86cea53e). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x07 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCGrpLevel_SXDGrpLevelInfo + +The **SXAddl_SXCGrpLevel_SXDGrpLevelInfo** record specifies information about an [OLAP group](#Section_1e04807706d14d4f961ecacb50a12a3d) for an [SxcGrpLevel class](#Section_86689e7b9d264225b6be580f86cea53e). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x08 and the value of **hdr.sxd** MUST equal 0x06. + +**A - fGroupLevel (1 bit):** A bit that specifies whether this is a user-defined group level. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The record specifies a group level that corresponds to the source [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7) level. | +| 1 | The record specifies a user-defined group level. | + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fCustomRollup (1 bit):** A bit that specifies whether the OLAP group level has [**custom rollup**](#gt_2748adff-afd3-4c5d-8095-ec69348c0a89). + +**reserved2 (29 bits):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**stLevelName (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the display name of the OLAP group level. The length of this field MUST be less than or equal to 255 characters. + +#### SXAddl_SXCGrpLevel_SXDId + +The **SXAddl_SXCGrpLevel_SXDId** record specifies information about an [OLAP group](#Section_1e04807706d14d4f961ecacb50a12a3d), for an [SxcGrpLevel class](#Section_86689e7b9d264225b6be580f86cea53e). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x07 and the value of **hdr.sxd** MUST equal 0x00. + +**stUnique (variable):** An [SXAddl_SXString](#sxaddl_sxstring) that specifies the unique name of the OLAP group level. + +#### SXAddl_SXCHierarchy_SXDDisplayFolder + +The **SXAddl_SXCHierarchy_SXDDisplayFolder** record specifies the name for the [**display folder**](#gt_6571ebdb-265a-40a1-807b-2aac2b5697d8) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) for an [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x25. + +**stDisplayFolder (variable):** An [SXAddl_SXString](#sxaddl_sxstring) that specifies the name of the pivot hierarchy display folder. + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 65535 characters. + +#### SXAddl_SXCHierarchy_SXDEnd + +The **SXAddl_SXCHierarchy_SXDEnd** record specifies the end of an [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCHierarchy_SXDFilterMember + +The **SXAddl_SXCHierarchy_SXDFilterMember** record specifies [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) used in [OLAP page filtering](#Section_e04e871619234e2db02a270894d6be73) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) for an [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4) is greater than or equal to 3. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x09. + +**A - reserved1 (1 bit):** MUST be 1 and MUST be ignored. + +**B - fMultFiltHavePlex (1 bit):** A bit that specifies whether multiple OLAP members in this pivot hierarchy are selected in the OLAP page filtering. If the value of this field is 0, **cItems** and **rgStPageItems** MUST be ignored. + +**reserved2 (30 bits):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**cItems (2 bytes):** An unsigned integer that specifies the number of elements in **rgStPageItems**. MUST be greater than 0 if **fMultFiltHavePlex** is 1. + +**rgStPageItems (variable):** An array of [XLUnicodeString](#xlunicodestring). Each element specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of an OLAP member selected in the OLAP page filtering. The number of elements in the array is specified by **cItems**. The length of each element MUST be greater than zero characters and less than or equal to 255 characters. + +#### SXAddl_SXCHierarchy_SXDFilterMember12 + +The **SXAddl_SXCHierarchy_SXDFilterMember12** record specifies an [OLAP manual filter](#Section_bd4665ebb56a44e690b9ceaf7ec55389) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4) is less than 3. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x3F. + +**isxtl (4 bytes):** An unsigned integer that specifies the zero-based ordinal of the [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) in the pivot hierarchy that the OLAP manual filter applies to. MUST be greater than or equal to 0. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**cItems (2 bytes):** An unsigned integer that specifies the number of items in **rgStMembers**. + +**rgStMembers (variable):** An array of [XLUnicodeString](#xlunicodestring). Each element specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of an [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) selected in the OLAP manual filter. The number of elements in the array is specified by **cItems**. The length of each element MUST be greater than zero characters and less than or equal to 255 characters. + +#### SXAddl_SXCHierarchy_SXDIconSet + +The **SXAddl_SXCHierarchy_SXDIconSet** record specifies the [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for an [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x20. + +**dwIconset (4 bytes):** An unsigned integer that specifies the icon set. + +MUST be a value from the following table: + +| Value | Meaning | +|--------|------------------------| +| 0x0000 | Default | +| 0x0001 | 3-arrow ascending | +| 0x0002 | 3-arrow descending | +| 0x0003 | 5-arrow ascending | +| 0x0004 | 5-arrow descending | +| 0x0005 | 5-arrow gray ascending | +| 0x0006 | Traffic lights | +| 0x0007 | Traffic lights 2 | +| 0x0008 | Quarters ascending | +| 0x0009 | Quarters descending | +| 0x000A | Signs | +| 0x000B | Symbols | + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCHierarchy_SXDId + +The **SXAddl_SXCHierarchy_SXDId** record specifies how an [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d) is associated with other records for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x00. + +**stHierUnq (variable):** An [SXAddl_SXString](#sxaddl_sxstring) that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the corresponding pivot hierarchy to which this SxcHierarchy class applies. The corresponding [SXTH](#sxth), of the pivot hierarchy in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), is the SXTH record with its **stUnique** field equal to the value of this field. + +If there exists no such SXTH record, then this SxcHierarchy class MUST be ignored. + +The length of this field MUST be greater than zero characters and less than or equal to 255 characters. + +#### SXAddl_SXCHierarchy_SXDInfo12 + +The **SXAddl_SXCHierarchy_SXDInfo12** record specifies additional properties for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for an [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x41. + +**A - fUnbalancedRealKnown (1 bit):** A bit that specifies whether **fUnbalancedReal** is valid. MUST be 0 if the pivot hierarchy is grouped. + +**B - fUnbalancedReal (1 bit):** A bit that specifies whether the pivot hierarchy is balanced or unbalanced. If the value is 1 and **fUnbalancedRealKnown** is 1, the pivot hierarchy is unbalanced. If the value is 0 and **fUnbalancedRealKnown** is 1, the pivot hierarchy is balanced. If **fUnbalancedRealKnown** is 0 the value is undefined. + +**C - fUnbalancedGroupKnown (1 bit):** A bit that specifies whether **fUnbalancedGroup** is valid. MUST be 0 if the pivot hierarchy is not grouped. + +**D - fUnbalancedGroup (1 bit):** A bit that specifies whether the [OLAP group](#Section_1e04807706d14d4f961ecacb50a12a3d) pivot hierarchy is balanced or unbalanced. If the value is 1 and **fUnbalancedGroupKnown** is 1, the pivot hierarchy is unbalanced. If the value is 0 and **fUnbalancedGroupKnown** is 1, the pivot hierarchy is balanced. If **fUnbalancedGroupKnown** is 0 the value is undefined. + +**E - fHidden (1 bit):** A bit that specifies whether the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) corresponding to this pivot hierarchy is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**reserved1 (27 bits):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCHierarchy_SXDKPIGoal + +The **SXAddl_SXCHierarchy_SXDKPIGoal** record specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**KPI**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) goal [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x28. + +**stKPIGoal (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the MDX unique name of the KPI goal measure. + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 32767 characters. + +#### SXAddl_SXCHierarchy_SXDKPIStatus + +The **SXAddl_SXCHierarchy_SXDKPIStatus** record specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**KPI**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) status [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x29. + +**stKPIStatus (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the MDX unique name of the KPI status measure. + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 32767 characters. + +#### SXAddl_SXCHierarchy_SXDKPITime + +The **SXAddl_SXCHierarchy_SXDKPITime** record specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**KPI**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) time [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x2C. + +**stKPITime (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the MDX unique name of the KPI time [**Multidimensional Expressions (MDX)**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f). + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 32767 characters. + +#### SXAddl_SXCHierarchy_SXDKPITrend + +The **SXAddl_SXCHierarchy_SXDKPITrend** record specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**KPI**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) trend [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x2A. + +**stKPITrend (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the MDX unique name of the KPI trend measure. + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 32767 characters. + +#### SXAddl_SXCHierarchy_SXDKPIValue + +The **SXAddl_SXCHierarchy_SXDKPIValue** record specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**KPI**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) value [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x27. + +**stKPIValue (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the MDX unique name of the KPI value measure. + +The length of this field MUST be greater than zero characters and less than or equal to 32767 characters. + +#### SXAddl_SXCHierarchy_SXDKPIWeight + +The **SXAddl_SXCHierarchy_SXDKPIWeight** record specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**KPI**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) weight [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x2B. + +**stKPIWeight (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the MDX unique name of the KPI weight [**Multidimensional Expressions (MDX)**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f). + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 32767 characters. + +#### SXAddl_SXCHierarchy_SXDMeasureGrp + +The **SXAddl_SXCHierarchy_SXDMeasureGrp** record specifies the name of the [**OLAP measure group**](#gt_a14d2b2b-03ca-40e2-a237-3d1a53f87261) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x24. + +**stMeasureGroup (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the OLAP measure group. + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 65535 characters. + +#### SXAddl_SXCHierarchy_SXDParentKPI + +The **SXAddl_SXCHierarchy_SXDParentKPI** record specifies the name of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) parent [**KPI**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record MUST NOT exist if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x26. + +**stParentKPI (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the parent KPI. + +The length of this field MUST be greater than or equal to zero characters and less than or equal to 65535 characters. + +#### SXAddl_SXCHierarchy_SXDProperty + +The **SXAddl_SXCHierarchy_SXDProperty** record specifies a [member property](#Section_e5db3a66677f43db8fb038584797c95f) of a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). The member property is displayed if the [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) is recalculated and the pivot hierarchy is either on the [row axis](#Section_3f46e7207706400cba9473cb829f869a) as specified by the **sxaxis.sxaxisRw** field of [SXTH](#sxth) or on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) as specified by the **sxaxis.sxaxisCol** field of SXTH. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x05. + +**A - fDisplayInReport (1 bit):** A bit that specifies whether this member property is displayed in the row axis or in the column axis, if this member property is associated with a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5). + +**B - fDisplayInTip (1 bit):** A bit that specifies whether this member property is displayed in a [**ToolTip**](#gt_84d44447-feaf-41a4-bf12-004c0f080fc2). + +**C - fDisplayInCaption (1 bit):** A bit that specifies whether this member property is used as a caption for [pivot items](#Section_58891cc5dd9b4293a97831070779524f) in the pivot field that is in this pivot hierarchy and is specified by the [SXVDTex](#sxvdtex) record with an isxtl field equal to the value of the isxtl field of this record. MUST be 0 if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is less than 3. + +**reserved1 (29 bits):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +**cchProperty (2 bytes):** An unsigned integer that specifies the length in characters of **stProperty**. + +The value MUST be greater than or equal to five characters and less than or equal to 255 characters. + +**stProperty (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of this member property. If a [cache field](#Section_6497eb794042445780e75959c9f0583c) has a matching value in the **stFieldName** field of [SXFDB](#sxfdb), then the cache field is a member property cache field and is associated with this pivot hierarchy. + +The length is specified in **cchProperty**. + +**cchLevelUnq (2 bytes):** An unsigned integer that specifies the length in characters of the [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) MDX unique name of the cache pivot hierarchy in **stProperty**. The OLAP level MDX unique name comes before the member property name in **stProperty**. For example, if the value for **stProperty** equals "\[Store\].\[Store Name\].\[Store Manager\]", then **cchLevelUnq** equals 20. This refers to "\[Store\].\[Store Name\]". + +If the PivotCache functionality level of the [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4) is 3, then this value is undefined and MUST be ignored. + +**ichPropName (2 bytes):** An unsigned integer that specifies the zero-based index of the character where the property name portion begins in **stProperty**. For example, if the value for **stProperty** equals "\[Store\].\[Store Name\].\[Store Manager\]", **ichPropName** equals 22. This refers to the starting character of "Store Manager". + +If the PivotCache functionality level of the associated PivotCache is 3, then this value is undefined and MUST be ignored. + +**cchPropName (2 bytes):** An unsigned integer that specifies the length in characters of the name portion of **stProperty**. For example, if the value for **stProperty** equals "\[Store\].\[Store Name\].\[Store Manager\]", **cchPropName** equals 13. This refers to the length of "Store Manager". + +If the PivotCache functionality level of the associated PivotCache is 3, then this value is undefined and MUST be ignored. + +**isxtl (2 bytes):** A signed integer that specifies the zero-based index of the OLAP level in the pivot hierarchy that this property applies to. The value MUST be greater than or equal to -1. + +#### SXAddl_SXCHierarchy_SXDSXSetParentUnique + +The **SXAddl_SXCHierarchy_SXDSXSetParentUnique** record specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the parent [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) for an [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). This record exists only if this pivot hierarchy is a [named set](#Section_c7f4e861a4e846b28279670fc6edcf6f). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x1D. + +**stHierUnique (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the MDX unique name of the parent pivot hierarchy. The length of this field MUST be greater than zero characters and less than or equal to 32767 characters. + +#### SXAddl_SXCHierarchy_SXDUserCaption + +The **SXAddl_SXCHierarchy_SXDUserCaption** record specifies the user-defined caption for a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33), for a [SxcHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x02 and the value of **hdr.sxd** MUST equal 0x1F. + +**stCaption (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the user-defined caption of this pivot hierarchy. The length of this field MUST be greater than zero characters and less than or equal to 255 characters. + +#### SXAddl_SXCHierarchy_SXDVerUpdInv + +The **SXAddl_SXCHierarchy_SXDVerUpdInv** record specifies the record-handling behavior for records of the [SXCHierarchy class](#Section_6167aeb40d774815b3218d3f117c438d). + +[TABLE] + +**data (12 bytes):** An [SXAddl_SXDVerUpdInv](#sxaddl_sxdverupdinv). The value of **data.hdr.sxc** MUST equal 0x02 and the value of **data.hdr.sxd** MUST equal 0x01. + +If the value of **data.dwVersionInvalidates** is not 0x00FF and is greater than or equal to the value of the **VerSxLastUpdated** field of the [QsiSXTag](#qsisxtag) record of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), then all the records and nested records of this SXCHierarchy class MUST be ignored until another SXAddl_SXCHierarchy_SXDVerUpdInv record is encountered. + +#### SXAddl_SXCQsi_SXDEnd + +The **SXAddl_SXCQsi_SXDEnd** record specifies the end of a [SxcQsi class](#Section_953f8be387154b688af387eef7855f27). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x05 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCQsi_SXDId + +The **SXAddl_SXCQsi_SXDId** record specifies how a [SxcQsi class](#Section_953f8be387154b688af387eef7855f27) is associated with other records for a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x05 and the value of **hdr.sxd** MUST equal 0x00. + +**stName (variable):** A [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the query table. If the **stName** field equals the **rgchName** field of a [Qsi](#qsi) record in this [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream, then this SxcQsi class applies to the query table that the Qsi record is associated with. Otherwise, this SxcQsi class MUST be ignored. + +#### SXAddl_SXCQuery_SXDEnd + +The **SXAddl_SXCQuery_SXDEnd** record specifies the end of a [SxcQuery class](#Section_78ae192deccb4971bc9b33e46f7ab527). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x07 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCQuery_SXDReconnCond + +The **SXAddl_SXCQuery_SXDReconnCond** record specifies the [**reconnect condition**](#gt_4a37eb9c-89fb-4159-a709-e8180672a287) for an [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9), for a [SxcQuery class](#Section_78ae192deccb4971bc9b33e46f7ab527). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x06 and the value of **hdr.sxd** MUST equal 0x07. + +**rccDBQuery (4 bytes):** An unsigned integer that specifies the reconnect condition for the database [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2). MUST be a value from the following table: + +| Value | Reconnect condition | +|----|----| +| 0x00000000 | Retrieve external connection information as required. When [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) is refreshed from the external connection, use the existing external connection information; if the external data [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) from the external connection fails, then retrieve updated external connection information, if available, from the [external connection file](#Section_6b0123b3be2248e19f57249f87425640). | +| 0x00000001 | Retrieve external connection information. When external data is refreshed from the external connection, retrieve updated external connection information from the external connection file, if available, and use that instead of the existing external connection information. In this case, the external data refresh fails if the external connection file is unavailable. | +| 0x0000000 | Never retrieve external connection information. Never get updated external connection information from the external connection file even if it is available and even if the existing external connection information is not valid. | + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCQuery_SXDSrcConnFile + +The **SXAddl_SXCQuery_SXDSrcConnFile** record specifies the [external connection file](#Section_6b0123b3be2248e19f57249f87425640) for an [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9), for a [SxcQuery class](#Section_78ae192deccb4971bc9b33e46f7ab527). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x06 and the value of **hdr.sxd** MUST equal 0x06. + +**stSourceConnectionFile (variable):** An [SXAddl_SXString](#sxaddl_sxstring) that specifies the external connection file for the database [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2). The total count of characters of the string MUST be less than or equal to 65535. + +#### SXAddl_SXCQuery_SXDSrcDataFile + +The **SXAddl_SXCQuery_SXDSrcDataFile** record specifies the [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0) file for an [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9), for a [SxcQuery class](#Section_78ae192deccb4971bc9b33e46f7ab527). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x06 and the value of **hdr.sxd** MUST equal 0x05. + +**stSourceDataFile (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the source data file for the database [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2). The total count of characters of the string MUST be less than or equal to 65535. + +#### SXAddl_SXCQuery_SXDXMLSource + +The **SXAddl_SXCQuery_SXDXMLSource** record specifies the [**Uniform Resource Locator (URL)**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1), used to display an edit dialog for an [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9), for a [SxcQuery class](#Section_78ae192deccb4971bc9b33e46f7ab527). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure The value of **hdr.sxc** MUST equal 0x06 and the value of **hdr.sxd** MUST equal 0x04. + +**stURL (variable):** An [XLUnicodeStringSegmentedSXAddl](#xlunicodestringsegmentedsxaddl) that specifies the URL used to display an edit dialog. + +#### SXAddl_SXCSXCondFmt_SXDEnd + +The **SXAddl_SXCSXCondFmt_SXDEnd** record specifies the end of a [SXCSXCondFmt class](#Section_59cc4e9903ad43f395985be87afdcc92). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1B and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXCondFmt_SXDSXCondFmt + +The **SXAddl_SXCSXCondFmt_SXDSXCondFmt** record specifies information for a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule, for a [SXCSXCondFmt class](#Section_59cc4e9903ad43f395985be87afdcc92). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1B and the value of **hdr.sxd** MUST equal 0x35. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +**sxcondfmtScope (4 bytes):** An unsigned integer that specifies the scope of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) conditional formatting. MUST be a value from the following table: + +| Name | Value | Description | +|----|----|----| +| SXCONDFMTSELECTIONSCOPE | 0x00000000 | This conditional formatting is applied to the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461), as specified by the [SXCSXrule classes](#Section_dd12edef6e8747379bed6f4ceff33127) contained in this SXCSXCondFmt class. | +| SXCONDFMTDATASCOPE | 0x00000001 | This conditional formatting is applied to all cells that display values for the [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679), as specified by the SXCSXrule class contained in this SXCSXCondFmt class. | +| SXCONDFMTFIELDSCOPE | 0x00000002 | This conditional formatting is applied to all cells that display values for the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) intersections, as specified by the SXCSXrule class contained in this SXCSXCondFmt class. | + +The value MUST be SXCONDFMTFIELDSCOPE if the value of **sxcondfmtType** is SXCONDFMTTOP10R or SXCONDFMTTOP10C. + +If the value is SXCONDFMTDATASCOPE or SXCONDFMTFIELDSCOPE, there MUST be only one SXCSXrule class contained in this SXCSXCondFmt class. + +**sxcondfmtType (4 bytes):** An unsigned integer that specifies the type of this PivotTable view conditional formatting. MUST be one of the values from following table: + +| Name | Value | Description | +|----|----|----| +| SXCONDFMTTOP10NIL | 0x00000000 | Top N or Bottom N conditional formatting is not evaluated. | +| SXCONDFMTTOP10A | 0x00000001 | Top N or Bottom N conditional formatting is evaluated across the entire scope [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). | +| SXCONDFMTTOP10R | 0x00000002 | Top N or Bottom N conditional formatting is evaluated for each row. | +| SXCONDFMTTOP10C | 0x00000003 | Top N or Bottom N conditional formatting is evaluated for each column. | + +The value MUST be equal to SXCONDFMTTOP10NIL or SXCONDFMTTOP10A if the value of **sxcondfmtScope** is SXCONDFMTSELECTIONSCOPE or SXCONDFMTDATASCOPE. + +**ipriority (4 bytes):** An unsigned integer that specifies the priority of the PivotTable view conditional formatting. It is used to locate the conditional formatting rule by matching the **ipriority** field of either [CF12](#cf12) or the **rgbContent** field which is a [CFExNonCF12](#cfexnoncf12) structure in [CFEx](#cfex). MUST be greater than or equal to 1. + +**csxrule (4 bytes):** An unsigned integer that specifies the number of SXCSXrule classes contained in this SXCSXCondFmt class. The SXCSXrule classes specify the area that the conditional formatting is applied to. + +#### SXAddl_SXCSXCondFmts_SXDEnd + +The **SXAddl_SXCSXCondFmts_SXDEnd** record specifies the end of a [SXCSXCondFmts class](#Section_fdd787b53b0e43f888b9c86cb063a54f). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1A and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXCondFmts_SXDId + +The **SXAddl_SXCSXCondFmts_SXDId** record specifies information for [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) [conditional formatting](#Section_abb828767c9c4377858fb1a6be7fe8f9) rules, for a [SXCSXCondFmts class](#Section_fdd787b53b0e43f888b9c86cb063a54f). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1A and the value of **hdr.sxd** MUST equal 0x00. + +**cSxcondfmt (4 bytes):** A signed integer that specifies the number of [SXCSXCondFmt class](#Section_59cc4e9903ad43f395985be87afdcc92) instances that follow this record. MUST be greater than 0. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXDH_SXDEnd + +The **SXAddl_SXCSXDH_SXDEnd** record specifies the end of an [SXCSXDH class](#Section_284c3ab876c54d36961f1e0006764807). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x10 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXDH_SXDId + +The **SXAddl_SXCSXDH_SXDId** record specifies information for an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**dimension (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) for a [SXCSXDH class](#Section_284c3ab876c54d36961f1e0006764807). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x10 and the value of **hdr.sxd** MUST equal 0x00. + +**dwCount (4 bytes):** An unsigned integer that specifies the number of [SXAddl](#sxaddl) records of type [SXADDL_SXCSXDH_SXDSXDH](#sxaddl_sxcsxdh_sxdsxdh) that follow this record. The count MUST be greater than zero and less than 0xFFFFFFFF. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXDH_SXDSxdh + +The **SXAddl_SXCSXDH_SXDSxdh** record specifies a mapping between an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**dimension (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) and a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) for a [SXCSXDH class](#Section_284c3ab876c54d36961f1e0006764807). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x10 and the value of **hdr.sxd** MUST equal 0x1A. + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +**isxth (4 bytes):** A signed integer that specifies a reference to a pivot hierarchy. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -2 | This value specifies the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592). | +| 0+ | A pivot hierarchy index, as specified in Pivot Hierarchies, that specifies a pivot hierarchy in the [associated PivotTable view](#Section_855483943345473bb926de5189fd664d) of the [OLAP PivotCache](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b). | + +The value MUST be -2 or greater than or equal to zero and less than the number of pivot hierarchy in the associated PivotTable view of the OLAP PivotCache. + +**cchDimensionName (2 bytes):** An unsigned integer that specifies the length, in characters, of the [XLUnicodeStringNoCch](#xlunicodestringnocch) in the **stDimensionName** field. MUST be greater than zero and less than or equal to 0x00FF. + +**cchDimensionUnique (2 bytes):** An unsigned integer that specifies the length, in characters, of the XLUnicodeStringNoCch in the **stDimensionUnique** field. MUST be greater than zero and less than or equal to 0x00FF. + +**cchDimensionCaption (2 bytes):** An unsigned integer that specifies the length, in characters, of the XLUnicodeStringNoCch in the **stDimensionCaption** field. MUST be greater than zero and less than or equal to 0x00FF. + +**stDimensionName (variable):** An XLUnicodeStringNoCch that specifies the name of the OLAP dimension (1). The length is specified in **cchDimensionName**. + +**stDimensionUnique (variable):** An XLUnicodeStringNoCch that specifies the fully qualified unique name of the [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7) dimension (1). The length is specified in **cchDimensionUnique**. + +**stDimensionCaption (variable):** An XLUnicodeStringNoCch that specifies the caption of the OLAP dimension (1). The length is specified in **cchDimensionCaption**. + +#### SXAddl_SXCSXfilt_SXDEnd + +The **SXAddl_SXCSXfilt_SXDEnd** record specifies the end of an [SXCSXfilt class](#Section_22611924dd5649078c7ab385cd2ccdc0). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x0D and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXfilt_SXDId + +The **SXAddl_SXCSXfilt_SXDId** record specifies information for a [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f) filter, for an [SXCSXfilt class](#Section_22611924dd5649078c7ab385cd2ccdc0). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x0D and the value of **hdr.sxd** MUST equal 0x00. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXfilt_SXDSXfilt + +The **SXAddl_SXCSXfilt_SXDSXfilt** record specifies information for a [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f) filter, for an [SXCSXfilt class](#Section_22611924dd5649078c7ab385cd2ccdc0). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x0D and the value of **hdr.sxd** MUST equal 0x14. + +**reserved1 (6 bytes):** MUST be zero, and MUST be ignored. + +**A - sxaxisRw (1 bit):** A bit that specifies whether the [row axis](#Section_3f46e7207706400cba9473cb829f869a) is being referred to. + +MUST be zero if the value of **sxaxisCol** is 1 or the value of **sxaxisPage** is 1 or the value of **sxaxisData** is 1. + +**B - sxaxisCol (1 bit):** A bit that specifies whether the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) is being referred to. + +MUST be zero if the value of **sxaxisRw** is 1 or the value of **sxaxisPage** is 1 or the value of **sxaxisData** is 1. + +**C - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**D - sxaxisData (1 bit):** A bit that specifies whether the [value axis](#Section_4c5c2daa289746e1854b0ce04209f060) is being referred to. + +MUST be zero if the value of **sxaxisRw** is 1 or the value of **sxaxisCol** is 1 or the value of **sxaxisPage** is 1. + +**E - fSelected (1 bit):** A bit that specifies whether the header of the [Pivot Field](#Section_1edf7f2294084945b2de56526c14fca5) is included in the PivotTable rule filters. + +**F - reserved3 (1 bit):** MUST be zero, and MUST be ignored. + +**G - reserved4 (1 bit):** MUST be zero, and MUST be ignored. + +**reserved5 (9 bits):** MUST be zero, and MUST be ignored. + +**grbitSbt (2 bytes):** A signed integer that specifies the subtotals for this PivotTable rule filter. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------| +| 0 | No subtotals are displayed. | +| 1 | Data value subtotals are displayed. | + +**iDim (4 bytes):** A signed integer that specifies the position of the Pivot Field within the axis specified by **sxaxisRw**, **sxaxisCol**, **sxaxisPage**, or **sxaxisData**. MUST be greater than or equal to -1 and less than or equal to 0x0000001F. + +**isxvd (4 bytes):** A signed integer that specifies the Pivot Field that this PivotTable rule filter refers to. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -2 | This PivotTable rule filter refers to the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592). | +| -1 | This PivotTable rule filter does not refer to a pivot field | +| 0 to 255 | This value specifies a pivot field index, as specified in Pivot Fields. The pivot field index specifies which pivot field this PivotTable rule filter refers to. | + +If the value is greater than or equal to zero, MUST be less than the number of pivot fields in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +**cisxvi (4 bytes):** An unsigned integer that specifies the count of [pivot item](#Section_58891cc5dd9b4293a97831070779524f) indexes in the [SXAddl_SXCSXfilt_SXDSXItm](#sxaddl_sxcsxfilt_sxdsxitm) record that follows this record. MUST be greater than or equal to zero. If **isxvd** is -1, MUST be 0. + +#### SXAddl_SXCSXfilt_SXDSXItm + +The **SXAddl_SXCSXfilt_SXDSXItm** record specifies an array of [pivot item](#Section_58891cc5dd9b4293a97831070779524f) records of a [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f) filter for an [SXCSXfilt class](#Section_22611924dd5649078c7ab385cd2ccdc0). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x0D and the value of **hdr.sxd** MUST equal 0x15. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +**rgIsxvi (variable):** An array of 2-byte unsigned integers. Each element specifies the pivot item or [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679) index in the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) or [data field](#Section_b4187a6caa2d4a9789bd26f394d67592) specified by the **isxvd** field of the preceding [SXAddl_SXCSXfilt_SXDSXfilt](#sxaddl_sxcsxfilt_sxdsxfilt) record. See PivotTable rule for more information about the references that are used. + +The number of items in the array MUST equal the **cisxvi** field of the preceding SXAddl_SXCSXfilt_SXDSXfilt record. + +The value of each element in **rgIsxvi** MUST be in sorted order such that **rgIsxvi**\[item\] is less than **rgIsxvi**\[item+1\] where item is between 0 and the number of elements in **rgIsxvi** – 2. + +If the value of the **isxvd** field of the preceding SXAddl_SXCSXfilt_SXDSXfilt record is greater than or equal to zero, each item in this array MUST be 0x7FFF (isxviNULL) or greater than or equal to zero plus the number of pivot items in the pivot field specified by the **isxvd** field of the preceding SXAddl_SXCSXfilt_SXDSXfilt record. + +If the value of the **isxvd** field of the preceding SXAddl_SXCSXfilt_SXDSXfilt record is less than zero, each item in this array MUST be greater than or equal to zero and less than the number of data items in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +#### SXAddl_SXCSXFilter12_SXDCaption + +The **SXAddl_SXCSXFilter12_SXDCaption** record specifies the name of the [advanced filter](#Section_d490d0634e074f0093389812040ebdff) for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x2F. + +**stName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). + +#### SXAddl_SXCSXFilter12_SXDEnd + +The **SXAddl_SXCSXFilter12_SXDEnd** record specifies the end of an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXFilter12_SXDId + +The **SXAddl_SXCSXFilter12_SXDId** record specifies information for an [advanced filter](#Section_d490d0634e074f0093389812040ebdff), for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x00. + +**dwFilterid (4 bytes):** An unsigned integer that specifies the unique identifier of this [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXFilter12_SXDSXFilter + +The **SXAddl_SXCSXFilter12_SXDSXFilter** record specifies the [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) information of an [advanced filter](#Section_d490d0634e074f0093389812040ebdff) for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x38. + +**reserved1 (4 bytes):** MUST be zero and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero and MUST be ignored. + +**isxvd (4 bytes):** An unsigned integer that specifies a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) index as specified in pivot fields. The pivot field index specifies which pivot field this filter applies to. The value MUST be less than the **cDim** field of the [SxView](#sxview) record of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +**isxvdMProp (4 bytes):** A signed integer that specifies the [member property](#Section_e5db3a66677f43db8fb038584797c95f) pivot field on which this advanced filter is based. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | This advanced filter is not defined on a [**member property**](#gt_c7ddc1fa-c564-42c5-b755-aed72a0cb000). | +| Greater than or equal to zero | This value specifies a pivot field index as specified in pivot fields. The pivot field index specifies which pivot field this advanced filter is based on. | + +> This value MUST be -1 and MUST be ignored if the value of the **sxft** field is less than 0x00000004 or greater than 0x00000011. The value MUST be greater than or equal to -1 and less than the value of the **cDim** field of the SxView record of this PivotTable view. + +**sxft (4 bytes):** A [SxFT](#sxft) structure that specifies the advanced filter type. If the value is equal to SXFTCOUNT, SXFTPERCENT, or SXFTSUM, the **cft** field in [SXAddl_SXCSXFilter12_SXDXlsFilter](#sxaddl_sxcsxfilter12_sxdxlsfilter) MUST be equal to CFTTOP10. + +**unused (4 bytes):** Undefined and MUST be ignored. + +**isxdiMeasure (4 bytes):** A signed integer that specifies a [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679) index of the data item on which this advanced filter is based. If this is an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) then isxdiMeasure MUST be -1, if this is a [value filter](#Section_05a1c98e21cd4941979880f4bf301bb2) then isxdiMeasure MUST be greater than or equal to zero and less than the number of [SXDI](#sxdi) records in this PivotTable view. Otherwise isxdiMeasure MUST be 0. + +**isxthMeasure (4 bytes):** A signed integer that specifies a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) index of the [measure](#Section_4308b88c7f1e42bcb3dd8a1387b69c51) pivot hierarchy on which this advanced filter applies. If this is a non-OLAP PivotTable view then isxthMeasure MUST be -1. If this is a value filter then **isxthMeasure** MUST be greater than or equal to zero and less than the number of [SXTH](#sxth) records in this PivotTable view. Otherwise isxthMeasure MUST be 0. + +#### SXAddl_SXCSXFilter12_SXDSXFilterDesc + +The **SXAddl_SXCSXFilter12_SXDSXFilterDesc** record specifies the description of an [advanced filter](#Section_d490d0634e074f0093389812040ebdff) for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x39. + +**stDescription (variable):** A [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the description of the [[PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37)](#Section_a5f57198f2af40b2ba07e4b1836d73f3) [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). + +#### SXAddl_SXCSXFilter12_SXDSXFilterValue1 + +The **SXAddl_SXCSXFilter12_SXDSXFilterValue1** record specifies the first value used by the [label filter](#Section_f221b81b892c4b5c91722d4ed17c937c) for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). This record MUST NOT exist if the value of the **sxft** field of the preceding [SXAddl_SXCSXFilter12_SXDSXFilter](#sxaddl_sxcsxfilter12_sxdsxfilter) record is less than 0x00000004 or greater than 0x00000011. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x3A. + +**stValue (variable):** A [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the first value used by the label filter. + +#### SXAddl_SXCSXFilter12_SXDSXFilterValue2 + +The **SXAddl_SXCSXFilter12_SXDSXFilterValue2** record specifies the second value used by the [label filter](#Section_f221b81b892c4b5c91722d4ed17c937c) for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). This record MUST NOT exist if the value of the **sxft** field of the preceding [SXAddl_SXCSXFilter12_SXDSXFilter](#sxaddl_sxcsxfilter12_sxdsxfilter) record is less than 0x00000004 or greater than 0x00000011. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x3B. + +**stValue (variable):** A [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the second value used by the label filter. + +#### SXAddl_SXCSXFilter12_SXDXlsFilter + +The **SXAddl_SXCSXFilter12_SXDXlsFilter** record specifies information for an [advanced filter](#Section_d490d0634e074f0093389812040ebdff), for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x3C. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +**cft (4 bytes):** A [**CFT**](#cft) enumeration that specifies the [**custom filter**](#gt_8593ee2f-c2dd-4793-a684-45fe40c840d2) type. If the **sxft** field in [SXAddl_SXCSXFilter12_SXDSXFilter](#sxaddl_sxcsxfilter12_sxdsxfilter) is equal to SXFTCOUNT, SXFTPERCENT, or SXFTSUM, this value MUST be CFTTOP10. + +**ccriteria (4 bytes):** A signed integer that specifies the number of criteria. MUST be greater than or equal to zero and less than or equal to 2. + +**data (28 bytes):** A 28-byte structure that contains the [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) data. + +If **cft** equals CFTTOP10 this is an [XlsFilter_Top10](#xlsfilter_top10) structure, otherwise this is an [XlsFilter_Criteria](#xlsfilter_criteria) structure. + +#### SXAddl_SXCSXFilter12_SXDXlsFilterValue1 + +The **SXAddl_SXCSXFilter12_SXDXlsFilterValue1** record specifies the first value of an [advanced filter](#Section_d490d0634e074f0093389812040ebdff) for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x3D. + +**stValue (variable):** A [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the first value string of the [SXAddl_SXCSXFilter12_SXDXlsFilter](#sxaddl_sxcsxfilter12_sxdxlsfilter) [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). + +#### SXAddl_SXCSXFilter12_SXDXlsFilterValue2 + +The **SXAddl_SXCSXFilter12_SXDXlsFilterValue2** record specifies the second value of an [advanced filter](#Section_d490d0634e074f0093389812040ebdff) for an [SXCSXFilter12 class](#Section_9b54e335ef8846d28d19dfbfe2078154). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1D and the value of **hdr.sxd** MUST equal 0x3E. + +**stValue (variable):** A [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the second value of the [SXAddl_SXCSXFilter12_SXDXlsFilter](#sxaddl_sxcsxfilter12_sxdxlsfilter) [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). + +#### SXAddl_SXCSXFilters12_SXDEnd + +The **SXAddl_SXCSXFilters12_SXDEnd** record specifies the end of an [SXCSXFilters12 class](#Section_38fb61e517e742219ea43f1e5a665bc2). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1C and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXFilters12_SXDId + +The **SXAddl_SXCSXFilters12_SXDId** record specifies information for [advanced filters](#Section_d490d0634e074f0093389812040ebdff), for an [SXCSXFilters12 class](#Section_38fb61e517e742219ea43f1e5a665bc2). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x1C and the value of **hdr.sxd** MUST equal 0x00. + +**cSxfilter12 (4 bytes):** An unsigned integer that specifies the count of PivotTable advanced filters in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXMg_SXDEnd + +The **SXAddl_SXCSXMg_SXDEnd** record specifies the end of an [SXCSXMg class](#Section_7a80fae6884c401f8ecab68064099425). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x14 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXMg_SXDId + +The **SXAddl_SXCSXMg_SXDId** record specifies information for an [**OLAP measure group**](#gt_a14d2b2b-03ca-40e2-a237-3d1a53f87261), for an [SXCSXMg class](#Section_7a80fae6884c401f8ecab68064099425). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x14 and the value of **hdr.sxd** MUST equal 0x00. + +**stName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the name of the OLAP measure group. + +#### SXAddl_SXCSXMg_SXDUserCaption + +The **SXAddl_SXCSXMg_SXDUserCaption** record specifies the display name for the [**OLAP measure group**](#gt_a14d2b2b-03ca-40e2-a237-3d1a53f87261) specified in this [SXAddl](#sxaddl) record collection. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x14 and the value of **hdr.sxd** MUST equal 0x1F. + +**stUserCaption (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the display name of the OLAP measure group. + +#### SXAddl_SXCSXMgs_SXDEnd + +The **SXAddl_SXCSXMgs_SXDEnd** record specifies the end of an [SxcSXMgs class](#Section_7081e96f74c24e339021305d28e3da1a). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x13 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXMgs_SXDId + +The **SXAddl_SXCSXMgs_SXDId** record specifies information for an [**OLAP measure group**](#gt_a14d2b2b-03ca-40e2-a237-3d1a53f87261) collection, for an [SxcSXMgs class](#Section_7081e96f74c24e339021305d28e3da1a). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x13 and the value of **hdr.sxd** MUST equal 0x00. + +**cmgs (4 bytes):** An unsigned integer that specifies the number of OLAP measure groups in the OLAP measure group collection. MUST be equal to the number of [SXCSXMg classes](#Section_7a80fae6884c401f8ecab68064099425) that are nested inside this SxcSXMgs class. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**cmaps (4 bytes):** An unsigned integer that specifies the number of mappings between OLAP measure groups and [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**dimensions (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) in the OLAP measure group collection. Each mapping is defined by an [SXAddl_SXCSXMgs_SXDMGrpSXDHMap](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap) record. This value MUST be equal to the number of SXAddl_SXCSXMgs_SXDMGrpSXDHMap records that follow this record. + +#### SXAddl_SXCSXMgs_SXDMGrpSXDHMap + +The **SXAddl_SXCSXMgs_SXDMGrpSXDHMap** record specifies a mapping between an [**OLAP measure group**](#gt_a14d2b2b-03ca-40e2-a237-3d1a53f87261) and an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**dimension (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) for an [SxcSXMgs class](#Section_7081e96f74c24e339021305d28e3da1a). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x13 and the value of **hdr.sxd** MUST equal 0x23. + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +**iKey (4 bytes):** An unsigned integer that specifies a zero-based index of an [SXCSXMg class](#Section_7a80fae6884c401f8ecab68064099425) in the collection of SXCSXMg classes. The [SXAddl_SXCSXMg_SXDId](#sxaddl_sxcsxmg_sxdid) record of the referenced SXCSXMg class specifies an OLAP measure group in the [**measure group**](#gt_1f51f60a-8a0f-4b0d-9e7e-80cbd596e164) collection. MUST be less than the value of the **cmgs** field of the [SXAddl_SXCSXMgs_SXDId](#sxaddl_sxcsxmgs_sxdid) record of this SxcSXMgs class. + +**iVal (4 bytes):** An unsigned integer that specifies a zero-based index of the [SXAddl_SXCSXDH_SXDSxdh](#sxaddl_sxcsxdh_sxdsxdh) record in the collection of SXAddl_SXCSXDH_SXDSxdh records in the [SXCSXDH class](#Section_284c3ab876c54d36961f1e0006764807) of the containing [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7) of this record. The referenced record specifies an OLAP dimension (1). MUST be less than the value of the **dwCount** field of the [SXAddl_SXCSXDH_SXDId](#sxaddl_sxcsxdh_sxdid) record of the SXCSXDH class. + +#### SXAddl_SXCSXrule_SXDEnd + +The **SXAddl_SXCSXrule_SXDEnd** record specifies the end of an [SXCSXrule class](#Section_dd12edef6e8747379bed6f4ceff33127). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x0C and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXrule_SXDId + +The **SXAddl_SXCSXrule_SXDId** record specifies information for a [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f), for the [SXCSXrule class](#Section_dd12edef6e8747379bed6f4ceff33127). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x0C and the value of **hdr.sxd** MUST equal 0x00. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCSXrule_SXDSXrule + +The **SXAddl_SXCSXrule_SXDSXrule** record specifies information for a [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f), for an [SXCSXrule class](#Section_dd12edef6e8747379bed6f4ceff33127). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x0C and the value of **hdr.sxd** MUST equal 0x13. + +**reserved1 (6 bytes):** MUST be zero, and MUST be ignored. + +**A - reserved2 (4 bits):** MUST be zero, and MUST be ignored. + +**sxrtype (4 bits):** An unsigned integer that specifies the area of the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) specified by this PivotTable rule. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | This rule applies to no area. | +| 0x1 | This rule applies to [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the [row area](#Section_5594c95e6819461e80706f4b4fdfa091), [column area](#Section_03aced8c25864e83982a1e3551a563d6), or [data area](#Section_237a24905c614931923f7ee856f23c72) of the PivotTable report. | +| 0x2 | This rule applies to the data area of the PivotTable report. | +| 0x3 | This rule applies to the entire PivotTable report. | +| 0x4 | This rule applies to the blank cells at the [**logical top-left**](#gt_88b25c47-61c2-44de-abb0-12ea3348a412) of the PivotTable report. | +| 0x5 | This rule applies to a button shown next to a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) in the PivotTable report. | +| 0x6 | This rule applies to the blank cells at the [**logical top-right**](#gt_90beae65-f411-4252-9b4b-6b539f263415) of the PivotTable report. | + +If the value of **isxvd** is not -1, MUST be 0x1 or 0x2 or 0x5. + +**B - fPart (1 bit):** A bit that specifies whether only a portion of the [PivotTable area](#Section_c3139d36c8934b57a44df7b7c13556e5) is included in this rule. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The entire PivotTable area is included in the rule. The **irwFirst**, **irwLast**, **icolFirst**, and **icolLast** fields are undefined and MUST be ignored. | +| 0x1 | A portion of the PivotTable area is included in the rule. The **irwFirst, irwLast, icolFirst,** and **icolLast** fields hold the relative offset into the PivotTable area included in this rule. | + +**C - fDataOnly (1 bit):** A bit that specifies whether only the cells in the data area are included in this PivotTable rule. If **fLabelOnly** is 1 then **fDataOnly** MUST be 0. If **sxrtype** is 0x2, the value of this field value MUST be 1. + +**D - fLabelOnly (1 bit):** A bit that specifies whether only cells in the [page area](#Section_f10ef7d86c044d35a5830d6f2ce92063), row area, or column area are included in this PivotTable rule. If **fDataOnly** is 1 then **fLabelOnly** MUST be 0. If **sxrtype** is 0x5 or 0x6, this value MUST be 1. + +**E - fGrandRw (1 bit):** A bit that specifies whether cells in the [**grand total**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7) row are included in this PivotTable rule. + +**F - fGrandCol (1 bit):** A bit that specifies whether cells in the grand total column are included in this PivotTable rule. + +**G - fGrandRwSav (1 bit):** A bit that specifies whether cells in the grand total row are included in this PivotTable rule. MUST be equal to **fGrandRw**. + +**H - reserved3 (1 bit):** MUST be zero, and MUST be ignored. + +**I - fGrandColSav (1 bit):** A bit that specifies whether cells in the grand total column are included in this PivotTable rule. MUST be equal to **fGrandCol**. + +**J - fFuzzy (1 bit):** A bit that specifies whether the [pivot items](#Section_58891cc5dd9b4293a97831070779524f) of the pivot field specified by this rule are treated as subtotals for the purposes of formatting when the pivot field is displayed in outline mode. + +**reserved4 (15 bits):** MUST be zero, and MUST be ignored. + +**K - unused1 (1 bit):** Undefined, MUST be ignored. + +**L - fLineMode (1 bit):** A bit that specifies whether the area of the PivotTable report specified by this PivotTable rule is displayed in outline mode. + +**M - unused2 (1 bit):** Undefined, MUST be ignored. + +**N - unused3 (1 bit):** Undefined, MUST be ignored. + +**O - reserved5 (1 bit):** MUST be zero, and MUST be ignored. + +**P - fDrillOnly (1 bit):** A bit that specifies the [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7) of the PivotTable rule filters specified by **csxfilt**. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | PivotTable rule filters are sorted by Pivot Field index as specified in Pivot Fields. | +| 0x1 | PivotTable rule filters are sorted by position. | + +**reserved6 (10 bits):** MUST be zero, and MUST be ignored. + +**irwFirst (1 byte):** A [DRwByteU](#drwbyteu) structure that specifies the difference between the index of the first row of the range of cells included in this rule and the index of the first row of the PivotTable. + +**irwLast (1 byte):** A DRwByteU structure that specifies the difference between the index of the last row of the range of cells included in this rule and the index of the first row of the PivotTable. If **fPart** is 1, MUST be greater than or equal to **irwFirst**. + +**icolFirst (1 byte):** A [DColByteU](#dcolbyteu) structure that specifies the difference between the index of the first column of the range of cells included in this rule and the index of the first column of the PivotTable. + +**icolLast (1 byte):** A DColByteU structure that specifies the difference between the index of the last column of the range of cells included in this rule and the index of the first column of the PivotTable. If **fPart** is 1, MUST be greater than or equal to **icolFirst**. + +**csxfilt (4 bytes):** An unsigned integer that specifies the number of [SXAddl_SXCSXfilt_SXDId](#sxaddl_sxcsxfilt_sxdid) records following this record. MUST be greater than or equal to 0. If **sxrtype** is not 0x1 or 0x2, this value MUST be 0. + +**iDim (4 bytes):** An signed integer that specifies the position of the pivot field within the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) for this PivotTable rule. If **isxvd** is 0xFFFFFFFE or 0xFFFFFFFF this field MUST be ignored. If **isxvd** is between 0x00000000 and 0x000000FF, then the value of **iDim** depends on the value of certain fields in the **sxaxis** structure in **isxvd**. The following table shows the values that **iDim** MUST have given certain values of the specified fields of **isxvd.sxaxis**. + +| Value | Meaning | +|----|----| +| **isxvd.sxaxis.sxaxisRw** is 1 | The value of **iDim** MUST be greater than 0 and less than the number of pivot fields on the [row axis](#Section_3f46e7207706400cba9473cb829f869a). | +| **isxvd.sxaxis.sxaxisCol** is 1 | The value of **iDim** MUST be greater than 0 and less than the number of pivot fields on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). | +| **isxvd.sxaxis.sxaxisPage** is 1 | The value of **iDim** MUST be greater than 0 and less than the number of pivot fields on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). | +| **isxvd.sxaxis.sxaxisData** is 1 | The value of **iDim** MUST be greater than 0 and less than the number of pivot fields on the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060) | + +**isxvd (4 bytes):** A signed integer that specifies the pivot field this rule refers to. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0xFFFFFFFE | This rule refers to the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592). | +| 0xFFFFFFFF | This rule does not refer to a pivot field. | +| 0x0000000 to 0x000000FF | This value specifies a pivot field index as specified in Pivot Fields. The pivot field index specifies which pivot field this rule refers to. | + +MUST be greater than or equal to 0xFFFFFFFE and less than or equal to 0x000000FF. If the value is greater than or equal to 0x00000000, MUST be less than the value of the **cDim** field of the preceding [SxView](#sxview). + +#### SXAddl_SXCView_SXDCalcMember + +The **SXAddl_SXCView_SXDCalcMember** record specifies [OLAP calculated members](#Section_e67071408ab5499ca7bab1d8eca85058) properties for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x03. + +**A - fParentUnique (1 bit):** A bit that specifies whether **stParentUnique** exists. If the value is 1, **stParentUnique** exists. If **fSet** is 1, this field MUST be zero. + +**B - fMemberName (1 bit):** A bit that specifies whether **stMemberName** exists. If the value is 1, **stMemberName** exists. If **fSet** is 1, this field MUST be zero; otherwise, this field MUST be 1. + +**C - fSourceHier (1 bit):** A bit that specifies whether **stSourceHierarchy** exists. If the value is 1, **stSourceHierarchy** exists. If **fSet** is 1, this field MUST be zero; otherwise, this field MUST be 1. + +**D - fLongFormula (1 bit):** A bit that specifies whether the length of the user-specified [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) that defines the calculation is greater than 255 characters. + +MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Length of the user-specified MDX expression is less than or equal to 255 characters and **stMDXFormula** contains the MDX. | +| 1 | Length of the user-specified MDX expression is greater than 255 characters and the user-specified MDX expression is written to a subsequent [SXAddl_SXCView_SXDCalcMemString](#sxaddl_sxcview_sxdcalcmemstring) record. | + +**E - reserved1 (4 bits):** MUST be zero, and MUST be ignored. + +**F - fSet (1 bit):** A bit that specifies whether this calculation is for an [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28). + +**reserved2 (23 bits):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**stName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of this OLAP calculated member. The length of this field MUST be greater than 0 characters and less than or equal to 255 characters. + +**stMDXFormula (variable):** An XLUnicodeString structure that specifies the user-specified MDX expression for this OLAP calculated member. If **fLongFormula** is 1, this field does not exist. If **fLongFormula** is 0, the length of this field MUST be greater than 0 characters and less than or equal to 255 characters. + +**stMemberName (variable):** An XLUnicodeString structure that specifies the name of this OLAP calculated member. If **fMemberName** is 0, this field does not exist. If **fMemberName** is 1, the length of this field MUST be less than or equal to 255 characters. + +**stSourceHierarchy (variable):** An XLUnicodeString structure that specifies the MDX unique name of the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) that this OLAP calculated member is associated with. If **fSourceHier** is zero this field does not exist. If **fSourceHier** is 1 then the length of this field MUST be less than or equal to 255 characters. + +**stParentUnique (variable):** An XLUnicodeString structure that specifies the MDX unique name of the parent [**member (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) that this OLAP calculated member is associated with. If **fParentUnique** is zero this field does not exist. If **fParentUnique** is 1 then the length of this field MUST be less than or equal to 255 characters. + +**wSolveOrder (4 bytes):** An unsigned integer that specifies the calculation order when there are multiple OLAP calculated members. The calculation order goes from lowest **wSolveOrder** value to highest. If the value is zero the calculation order is determined by the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). + +#### SXAddl_SXCView_SXDCalcMemString + +The **SXAddl_SXCView_SXDCalcMemString** record specifies a user-specified [**MDX**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) for an [OLAP calculated member](#Section_e67071408ab5499ca7bab1d8eca85058), for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). The other properties of the OLAP calculated member are specified in the preceding [SXAddl_SXCView_SXDCalcMember](#sxaddl_sxcview_sxdcalcmember) record. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x0A. + +**stMDXFormula (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the user-specified MDX expression. The length of this field MUST be greater than zero. If the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4) of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) is less than 3, the length of this field MUST be less than 2048 characters; otherwise, the length MUST be less than 32767 characters. + +#### SXAddl_SXCView_SXDCompactColHdr + +The **SXAddl_SXCView_SXDCompactColHdr** record specifies the [column area](#Section_03aced8c25864e83982a1e3551a563d6) caption string used in the compact [PivotTable layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4) for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x22. + +**stHeader (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the caption displayed in the column area of the compact PivotTable layout. The length MUST be less than or equal to 255 characters. + +#### SXAddl_SXCView_SXDCompactRwHdr + +The **SXAddl_SXCView_SXDCompactRwHdr** record specifies the [row area](#Section_5594c95e6819461e80706f4b4fdfa091) caption string used in the compact [PivotTable layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4) for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x21. + +**stHeader (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the caption displayed in the row area of the compact PivotTable layout. The length MUST be less than or equal to 255 characters. + +#### SXAddl_SXCView_SXDEnd + +The **SXAddl_SXCView_SXDEnd** record specifies the end of an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCView_SXDId + +The **SXAddl_SXCView_SXDId** record specifies how an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3) is associated with other records for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x00. + +**stName (variable):** An [SXAddl_SXString](#sxaddl_sxstring) structure that specifies the [PivotTable view](#Section_a5f57198f2af40b2ba07e4b1836d73f3) that this SxcView class applies to. The corresponding [SxView](#sxview) record of this PivotTable view is the SxView record, in this [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56), with its **stTable** field equal to the value of this field. If there exists no such SxView record then this SxcView class MUST be ignored. + +#### SXAddl_SXCView_SXDSXPIIvmb + +The **SXAddl_SXCView_SXDSXPIIvmb** record specifies a mapping between [value metadata](#Section_e78bf5ba22754bad8e6cf4f59644efa6) and a field on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x36. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +**isxpi (4 bytes):** An unsigned integer that specifies the index of the entry on the page axis. MUST be greater than or equal to zero and less than the value of the **cDimPg** field of the [SxView](#sxview) record of the PivotTable view. + +**ivmb (4 bytes):** An unsigned integer that specifies the zero-based index of the [MDB](#mdb) record in the sequence of records that conforms to the [MDBLOCK](#globals-substream) rule. The referenced MDB specifies the value metadata. MUST be greater than or equal to zero and less than the count of MDB records. + +#### SXAddl_SXCView_SXDTableStyleClient + +The **SXAddl_SXCView_SXDTableStyleClient** record specifies [table style](#Section_4ac7212b4aa74ece962526c58224ae80) properties for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x1E. + +**reserved1 (6 bytes):** MUST be zero, and MUST be ignored. + +**A - unused (1 bit):** Undefined and MUST be ignored. + +**B - fLastColumn (1 bit):** A bit that specifies whether any [table style elements](#Section_84f2f67849214e8c83eb10d4fff7e935) (as specified by [TableStyleElement](#tablestyleelement)) with a **tseType** field equal to 0x00000004 are applied to the [PivotTable view](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +**C - fRowStrips (1 bit):** A bit that specifies whether any table style elements (as specified by TableStyleElement) with a **tseType** field equal to 0x00000005 or 0x00000006 are applied to the PivotTable view. + +**D - fColumnStrips (1 bit):** A bit that specifies whether any table style elements (as specified by TableStyleElement) with a **tseType** field equal to 0x00000007 or 0x00000008 are applied to the PivotTable view. + +**E - fRowHeaders (1 bit):** A bit that specifies whether any table style elements (as specified by TableStyleElement) with a **tseType** field equal to 0x00000003, 0x00000017, 0x00000018, or 0x00000019 are applied to the PivotTable view. + +**F - fColumnHeaders (1 bit):** A bit that specifies whether any table style elements (as specified by TableStyleElement) with a **tseType** field equal to 0x00000001, 0x00000014, 0x00000015, or 0x00000016 are applied to the PivotTable view. + +**G - fDefaultStyle (1 bit):** A bit that specifies whether to apply the default [TableStyle](#tablestyle) to the PivotTable view. + +**reserved2 (9 bits):** MUST be zero, and MUST be ignored. + +**stName (variable):** An [LPWideString](#lpwidestring) structure that specifies the name of the TableStyle applied to the PivotTable view. The length MUST be greater than zero and less than or equal to 255 characters. + +#### SXAddl_SXCView_SXDVer10Info + +The **SXAddl_SXCView_SXDVer10Info** record specifies information about a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x02. + +**bVerSxMacro (1 byte):** A [DataFunctionalityLevel](#datafunctionalitylevel) structure that specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) that this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) was created with. SHOULD[\<129\>](#Appendix_A_129) be less than 3 if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4) is less than 3. MUST be greater than or equal to 3 if the PivotCache functionality level of the associated PivotCache is greater than or equal to 3. + +**A - fDisplayImmediateItems (1 bit):** A bit that specifies whether [pivot items](#Section_58891cc5dd9b4293a97831070779524f) are displayed in the PivotTable view even when there is no [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) on the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). If **bVerSxMacro** is greater than or equal to 3 then this value MUST be 1. + +**B - fEnableDataEd (1 bit):** A bit that specifies whether the user is allowed to change values in the data axis of the PivotTable view. + +**C - fDisableFList (1 bit):** A bit that specifies whether the [**PivotTable field list**](#gt_1760fb56-0c97-4c0d-a077-38338baa7577) is disabled. + +**D - fReenterOnLoadOnce (1 bit):** A bit that specifies whether the PivotTable view is recalculated the next time the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is opened. + +**E - fNotViewCalculatedMembers (1 bit):** A bit that specifies whether [**OLAP calculated members**](#gt_16cb1b2a-a915-42c1-81ef-fcf221adb0fe) are [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) in the PivotTable view. + +MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------| +| 0 | OLAP calculated members are not hidden. | +| 1 | OLAP calculated members are hidden. | + +MUST be ignored if the PivotTable view is a non-[OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f). + +**F - fNotVisualTotals (1 bit):** A bit that specifies whether [**grand totals**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7) and subtotals in an OLAP PivotTable view include the values of hidden [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32). + +MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------------------------| +| 0 | Hidden OLAP members are not included in grand totals and subtotals. | +| 1 | Hidden OLAP members are included in grand totals and subtotals. | + +MUST be ignored if the PivotTable view is a non-OLAP PivotTable view. + +**G - fPageMultipleItemLabel (1 bit):** A bit that specifies what text is displayed in a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the page area when a non-[**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) has one or more hidden pivot items. + +MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Show text indicating that all items are displayed. | +| 1 | If the data source has one or more hidden pivot items, show text indicating that not all items are displayed, otherwise show text indicating that all items are displayed. | + +MUST be ignored if the PivotTable view is an OLAP PivotTable view. + +**H - fTensorFillCv (1 bit):** A bit that specifies whether the [**fill color**](#gt_ed1c5310-a27a-4576-883a-f9f3e18ba20a) retrieved from the OLAP data source is used in the PivotTable view. + +MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The fill color from the OLAP data source is not used. | +| 1 | If the data source is OLAP and the fill color is available from the OLAP data source, then the fill color is used. | + +MUST be ignored if the PivotTable view is a non-OLAP PivotTable view. + +**I - fHideDDData (1 bit):** A bit that specifies whether the control for selecting the pivot items to be displayed in the PivotTable view is hidden. + +**J - reserved1 (3 bits):** MUST be zero, and MUST be ignored. + +**unused (12 bits):** Undefined, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCView_SXDVer12Info + +The **SXAddl_SXCView_SXDVer12Info** record specifies information for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), for an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr) structure. The value of **hdr.sxc** MUST equal 0x00 and the value of **hdr.sxd** MUST equal 0x19. + +**A - fDefaultCompact (1 bit):** A bit that specifies whether new [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5) added to the [PivotTable view](#Section_a5f57198f2af40b2ba07e4b1836d73f3) are in [**compact axis**](#gt_87303118-9ef7-437d-914a-2ad9964b5e81) mode by default. + +**B - fDefaultOutline (1 bit):** A bit that specifies whether new pivot fields added to the PivotTable view are displayed in outline format by default. + +**C - fOutlineData (1 bit):** A bit that specifies whether the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592) is displayed in outline format. See [Subtotalling](#Section_427438d9b8e34a5c8b678f158fbf680f) for more information. + +**D - fCompactData (1 bit):** A bit that specifies whether the data field is displayed in compact axis mode. See [PivotTable Layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4) for more information. + +**E - fNewDropZones (1 bit):** A bit that specifies whether the application allows dragging within the [**PivotTable field list**](#gt_1760fb56-0c97-4c0d-a077-38338baa7577). + +**F - fPublished (1 bit):** A bit that specifies whether this PivotTable is marked as having already been [**published**](#gt_8ffc383a-d4f1-4515-a8b5-874d84ab2d2b) to a server-based application. This bit is ignored if the **fPublishedBookItems** field of the [BookExt_Conditional12](#bookext_conditional12) structure is zero. + +**G - fTurnOffImmersive (1 bit):** A bit that specifies whether a user interface for manipulating PivotTable options is displayed. + +MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | A user interface for manipulating PivotTable options is displayed. | +| 1 | A user interface for manipulating PivotTable options is not displayed. | + +**H - fSingleFilterPerField (1 bit):** A bit that specifies whether this PivotTable can have multiple [**filters**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) per field. + +MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------------------------------| +| 0 | The PivotTable can have many filters per field. | +| 1 | The PivotTable can have a maximum of one filter per field. | + +**I - fNonDefaultSortInFlist (1 bit):** A bit that specifies whether PivotTable fields are sorted in the PivotTable field list. + +MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------------------------------| +| 0 | PivotTable fields are not sorted in the PivotTable field list. | +| 1 | PivotTable fields are sorted in the PivotTable field list. | + +**J - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**K - fDontUseCustomLists (1 bit):** A bit that specifies whether to use [**custom lists**](#gt_92d2bb3a-2615-4bf8-b87f-887302d4c40c) when sorting the PivotTable. + +MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------------| +| 0 | Custom lists are used when sorting the PivotTable. | +| 1 | Custom lists are not used when sorting the PivotTable. | + +**reserved2 (9 bits):** MUST be zero, and MUST be ignored. + +**L - fHideDrillIndicators (1 bit):** A bit that specifies whether the [**expand/collapse buttons**](#gt_6b6cf48b-35ae-4101-86b4-c5d63aca70a6) are [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) in the PivotTable view. + +**M - fPrintDrillIndicators (1 bit):** A bit that specifies whether the expand/collapse buttons are printed. + +**N - fMemPropsInTips (1 bit):** A bit that specifies whether [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) properties are displayed in [**ToolTips**](#gt_84d44447-feaf-41a4-bf12-004c0f080fc2). + +**O - fNoPivotTips (1 bit):** A bit that specifies whether ToolTips are displayed on cells in the PivotTable view. + +MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------------------| +| 0 | ToolTips are displayed on cells in the PivotTable view. | +| 1 | ToolTips are not displayed on cells in the PivotTable view. | + +**cIndentInc (7 bits):** An unsigned integer that specifies the number of characters to indent row labels by when compact axis mode is used. See PivotTable Layout for more information. + +**P - fNoHeaders (1 bit):** A bit that specifies whether field captions are displayed in the PivotTable layout. + +MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------------------------------| +| 0 | Field captions are displayed in the PivotTable layout. | +| 1 | Field captions are not displayed in the PivotTable layout. | + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +#### SXAddl_SXCView_SXDVerUpdInv + +The **SXAddl_SXCView_SXDVerUpdInv** record specifies the record-handling behavior for following records of the [SXCView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +[TABLE] + +**data (12 bytes):** An [SXAddl_SXDVerUpdInv](#sxaddl_sxdverupdinv) structure. The value of **data.hdr.sxc** MUST equal 0x00 and the value of **data.hdr.sxd** MUST equal 0x01. The value of **data.dwVersionInvalidates** MUST equal 0x0002 or 0x00FF. + +If the value of **data.dwVersionInvalidates** is not 0x00FF and is greater than or equal to the value of the **VerSxLastUpdated** field of the [QsiSXTag](#qsisxtag) record of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), the following records of this SXCView class, including nested classes or until another SXAddl_SXCView_SXDVerUpdInv record is encountered, MUST be ignored. + +### SxBool + +The **SxBool** record specifies a Boolean [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) or value. + +[TABLE] + +**bool (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies the record value. + +### SXDB + +The **SXDB** record specifies [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) properties. + +[TABLE] + +**crdbdb (4 bytes):** A signed integer that specifies the number of [cache records](#Section_fe6e4ca0a9b646a4898124e4b61a770a) for this PivotCache. MUST be greater than or equal to 0. MUST be 0 for [OLAP PivotCaches](#Section_fb16dbf9cbe543b1aaa3f970c5107e7b). MUST be ignored if **fSaveData** is 0. + +**idstm (2 bytes):** An unsigned integer that specifies the stream that contains the data for this PivotCache. MUST be equal to the value of the **idstm** field of the [SXStreamID](#sxstreamid) record that specifies the PivotCache stream that contains this record. + +**A - fSaveData (1 bit):** A bit that specifies whether cache records exist. MUST be 0 for OLAP PivotCaches. + +**B - fInvalid (1 bit):** A bit that specifies whether the cache records are in the not-valid state. MUST be equal to 1 if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is greater than or equal to 3. MUST be equal to 1 for OLAP PivotCaches. See cache records for more information. + +**C - fRefreshOnLoad (1 bit):** A bit that specifies whether the PivotCache is refreshed on load. + +**D - fOptimizeCache (1 bit):** A bit that specifies whether optimization is applied to the PivotCache to reduce memory usage. MUST be 0 and MUST be ignored for a non-[**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) PivotCache. + +**E - fBackgroundQuery (1 bit):** A bit that specifies whether the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) used to [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) the PivotCache is executed asynchronously. MUST be ignored if **vsType** not equals 0x0002. + +**F - fEnableRefresh (1 bit):** A bit that specifies whether refresh of the PivotCache is enabled. MUST be equal to 0 if the PivotCache functionality level is greater than or equal to 3. MUST be equal to 0 for OLAP PivotCaches. + +**unused1 (10 bits):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**cfdbdb (2 bytes):** A signed integer that specifies the number of [cache fields](#Section_6497eb794042445780e75959c9f0583c) that corresponds to the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4). MUST be greater than or equal to 0. + +**cfdbTot (2 bytes):** A signed integer that specifies the number of cache fields in the PivotCache. MUST be greater than or equal to 0. + +**crdbUsed (2 bytes):** An unsigned integer that specifies the number of records used to calculate the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) report. Records excluded by [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) filtering are not included in this value. MUST be 0 for OLAP PivotCaches. + +**vsType (2 bytes):** An unsigned integer that specifies the type of source data. MUST be equal to the value of the **sxvs** field of the [SXVS](#sxvs) record that follows the SXStreamID record that specifies the PivotCache stream that contains this record. + +**cchWho (2 bytes):** An unsigned integer that specifies the number of characters in **rgb**. MUST be equal to 0xFFFF, or MUST be greater than or equal to 1 and less than or equal to 0x00FF. + +**rgb (variable):** An optional [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of the user who last refreshed the PivotCache. MUST exist if and only if the value of **cchWho** is not equal to 0xFFFF.  If this field exists, the length MUST equal **cchWho**. The length of this value MUST be less than 256 characters. The name is an application-specific setting that is not necessarily related to the [User Names Stream](#Section_1b98bc4df7c640a088dba99426635acd) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +### SXDBB + +The **SXDBB** record specifies the values of all the [cache fields](#Section_6497eb794042445780e75959c9f0583c) that have a **fAllAtoms** field of the [SXFDB](#sxfdb) record equal to 1 and that correspond to [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) entities, as specified by cache fields, for a single [cache record](#Section_fe6e4ca0a9b646a4898124e4b61a770a). + +[TABLE] + +**blob (variable):** An array of 1-byte and 2-byte unsigned integers that specifies indexes to [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) of cache fields that correspond to source data entities, as specified by cache fields, that have an **fAllAtoms** field of the SXFDB record equal to 1. The order of the indexes specified in the array corresponds to the order of the cache fields as they appear in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). Each unsigned integer specifies a zero-based index of a record in the sequence of records that conforms to the [SRCSXOPER](#pivot-cache-storage-_sx_db_cur) rule of the associated cache field. The referenced record from the SRCSXOPER rule specifies a cache item that specifies a value for the associated cache field. If the **fShortIitms** field of an SXFDB record of the cache field equals 1, the index value for this cache field is stored in this field in two bytes; otherwise, the index value is stored in this field in a single byte. + +### SXDBEx + +The **SXDBEx** record specifies additional [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) properties. + +[TABLE] + +**numDate (8 bytes):** A [DateAsNum](#dateasnum) structure that specifies the date and time on which the PivotCache was created or last refreshed. + +**cSxFormula (4 bytes):** An unsigned integer that specifies the count of [SXFormula](#sxformula) records for this cache. + +### SXDI + +The **SXDI** record specifies a [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679) for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +[TABLE] + +**isxvdData (2 bytes):** A signed integer that specifies a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) index as specified in Pivot Fields. + +If the PivotTable view is a non-[OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f), the values in the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) associated with the associated [cache field](#Section_6497eb794042445780e75959c9f0583c) of the referenced pivot field are aggregated as specified in this record. + +If the PivotTable view is an OLAP PivotTable view, the associated [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) of the referenced pivot field specifies the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) for this data item and the **iiftab** field is ignored. See [Association of Pivot Hierarchies and Pivot Fields and Cache Fields](#Section_01a66b9be4a24396b55c28d6207fd28f) to determine the associated pivot hierarchy. + +MUST be greater than or equal to zero and less than the value of the **cDim** field of the preceding [SxView](#sxview) record. + +The value of the **sxaxis.sxaxisData** field of the [Sxvd](#sxvd) record of the referenced pivot field MUST be 1. + +**iiftab (2 bytes):** A signed integer that specifies the [**aggregation function**](#gt_f9b44a9d-68c4-4a28-b347-cce9eb5f8845). + +MUST be a value from the following table: + +| Value | Meaning | +|--------|---------------------------------------------| +| 0x0000 | Sum of values | +| 0x0001 | Count of values | +| 0x0002 | Average of values | +| 0x0003 | Max of values | +| 0x0004 | Min of values | +| 0x0005 | Product of values | +| 0x0006 | Count of numbers | +| 0x0007 | Statistical standard deviation (sample) | +| 0x0008 | Statistical standard deviation (population) | +| 0x0009 | Statistical variance (sample) | +| 0x000A | Statistical variance (population) | + +**df (2 bytes):** A signed integer that specifies the calculation used to display the value of this data item. + +MUST be a value from the following table: + +[TABLE] + +**isxvd (2 bytes):** A signed integer that specifies a pivot field index as specified in Pivot Fields. The referenced pivot field is used in calculations as specified by the **df** field. + +If **df** is 0x0001, 0x0002, 0x0003, or 0x0004 then the value of **isxvd** MUST be greater than or equal to zero and less than the value of the **cDim** field in the preceding SxView record. Otherwise, the value of **isxvd** is undefined and MUST be ignored. + +**isxvi (2 bytes):** A signed integer that specifies the pivot item used by **df**. + +If **df** is 0x0001, 0x0002, or 0x0003 then the value of this field MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 to 0x7EFE | A pivot item index, as specified by Pivot Items, that specifies a pivot item in the pivot field specified by **isxvd**. MUST be less than the **cItm** field of the Sxvd record of the pivot field specified by **isxvd**. | +| 0x7FFB | The previous pivot item in the pivot field specified by **isxvd**. | +| 0x7FFC | The next pivot item in the pivot field specified by **isxvd.** | + +Otherwise, the value is undefined and MUST be ignored. + +**ifmt (2 bytes):** An [IFmt](#ifmt) structure that specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) for this item. + +**cchName (2 bytes):** An unsigned integer that specifies the length, in characters, of the [XLUnicodeStringNoCch](#xlunicodestringnocch) structure in the **stName** field. If the value is 0xFFFF then **stName** does not exist. Otherwise, the value MUST be greater than zero and less than or equal to 0x00FF. + +MUST NOT be 0xFFFF when the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is less than 3, or for non-OLAP PivotTable view . + +**stName (variable):** An XLUnicodeStringNoCch structure that specifies the name of this data item. A value that is not NULL specifies that this string is used to override the name in the corresponding cache field. + +MUST NOT exist if **cchName** is 0xFFFF. Otherwise, MUST exist and the length MUST equal **cchName**. + +If this string is not NULL and the PivotTable view is a non-OLAP PivotTable view, this field MUST be unique within all SXDI records in this [PivotTable view](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +### SXDtr + +The **SXDtr** record specifies a [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) or a value in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) that is an instance in time, expressed as a date and time of day. + +[TABLE] + +**yr (2 bytes):** An unsigned integer that specifies the year component of the date. MUST be greater than or equal to 1900 and MUST be less than or equal to 9999. If **dom** is 0, **yr** MUST be 1900. + +**mon (2 bytes):** An unsigned integer that specifies the month component of the date. MUST be greater than or equal to 1, and MUST be less than or equal to 12. If **dom** is equal to 0, **mon** MUST be equal to 1. + +**dom (1 byte):** An unsigned integer that specifies the day of month component of the date. MUST be greater than or equal to 0 and MUST be less than or equal to 31. + +**hr (1 byte):** An unsigned integer that specifies the hour component of the time of day. MUST be less than or equal to 23. + +**min (1 byte):** An unsigned integer that specifies the minute component of the time of day. MUST be less than or equal to 59. + +**sec (1 byte):** An unsigned integer that specifies the second component of the time of day. MUST be less than or equal to 59. + +### SxDXF + +The **SxDXF** record specifies [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6) applied to a [PivotTable area](#Section_c3139d36c8934b57a44df7b7c13556e5). + +[TABLE] + +**dxf (variable):** A [DXFN12NoCB](#dxfn12nocb) structure that specifies the differential formatting. + +### SxErr + +The **SxErr** record specifies an error [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) or value. + +[TABLE] + +**wbe (2 bytes):** An unsigned integer that specifies the error record value. MUST be a value from the following table**[\<130\>](#Appendix_A_130):** + +| Value | Meaning | +|-------|----------| +| 0x00 | \#NULL! | +| 0x07 | \#DIV/0! | +| 0x0F | \#VALUE! | +| 0x17 | \#REF! | +| 0x1D | \#NAME? | +| 0x24 | \#NUM! | +| 0x2A | \#N/A | + +### SXEx + +The **SXEx** record specifies additional properties of a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) and specifies the beginning of a collection of records as defined by the [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies [**selection**](#gt_8a241461-3c59-45fb-9094-b6692a0c27fe) and formatting properties for the PivotTable view. + +[TABLE] + +**csxformat (2 bytes):** An unsigned integer that specifies the number of [SxFormat](#sxformat) records that follow this record. MUST be less than or equal to 0xFFFF. + +**cchErrorString (2 bytes):** An unsigned integer that specifies the length, in characters, of the [XLUnicodeStringNoCch](#xlunicodestringnocch) structure in the **stError** field. If the value is 0xFFFF, then **stError** does not exist. MUST be 0xFFFF or MUST be greater than zero and less than or equal to 0x00FF. + +**cchNullString (2 bytes):** An unsigned integer that specifies the length, in characters, of the XLUnicodeStringNoCch structure in the **stDisplayNull** field. If the value is 0xFFFF, then **stDisplayNull** does not exist. MUST be 0xFFFF or MUST be greater than zero and less than or equal to 0x00FF. + +**cchTag (2 bytes):** An unsigned integer that specifies the length, in characters, of the XLUnicodeStringNoCch structure in the **stTag** field. If the value is 0xFFFF, then **stTag** does not exist. MUST be 0xFFFF or MUST be greater than zero and less than or equal to 0x00FF. + +**csxselect (2 bytes):** An unsigned integer that specifies the number of [SxSelect](#sxselect) records that follow this record. MUST be less than or equal to 0xFFFF. + +**crwPage (2 bytes):** A [DRw](#drw) structure that specifies the number of rows in the page area (see [Location and Body](#Section_7f7d9d76a55041d9ae9f0d8539cc09f8)) of the PivotTable view. + +**ccolPage (2 bytes):** A [DCol](#dcol) structure that specifies the number of columns in the page area (see Location and Body) of the PivotTable view. + +**A - fAcrossPageLay (1 bit):** A bit that specifies how [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5) are laid out in the page area (see Location and Body) when there are multiple pivot fields on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Pivot fields are displayed in the page area from the top to the bottom first, as fields are added, before moving to another column. | +| 0x1 | Pivot fields are displayed in the page area from left to right first, as fields are added, before moving to another row. | + +**cWrapPage (8 bits):** An unsigned integer that specifies the number of pivot fields in the page area (see Location and Body) to display before moving to another row or column, as specified by **fAcrossPageLay**. + +MUST be less than or equal to 0xFF. A value of 0 means that no wrap is allowed. + +**B - unused (1 bit):** Undefined and MUST be ignored. + +**C - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**reserved2 (5 bits):** MUST be zero and MUST be ignored. + +**D - fEnableWizard (1 bit):** A bit that specifies whether a wizard user interface is displayed to work with the PivotTable view. + +**E - fEnableDrilldown (1 bit):** A bit that specifies whether details can be shown for [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the data area, as specified by [PivotTable Layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4). + +**F - fEnableFieldDialog (1 bit):** A bit that specifies whether a user interface for setting properties of a pivot field can be displayed. + +**G - fPreserveFormatting (1 bit):** A bit that specifies whether formatting is preserved when the PivotTable view is recalculated. + +If the value is 1, **csxformat** MUST be 0 and there MUST be no SxFormat records following this record. + +**H - fMergeLabels (1 bit):** A bit that specifies whether empty cells adjacent to the cells displaying [pivot item](#Section_58891cc5dd9b4293a97831070779524f) captions of pivot fields on the [row axis](#Section_3f46e7207706400cba9473cb829f869a) and [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) of the PivotTable view are merged into a single cell with center-aligned text. + +**I - fDisplayErrorString (1 bit):** A bit that specifies whether the PivotTable view displays the custom error string **stError** in cells that contain errors. + +**J - fDisplayNullString (1 bit):** A bit that specifies whether the PivotTable view displays the custom string **stDisplayNull** in cells that contain NULL values. + +**K - fSubtotalHiddenPageItems (1 bit):** A bit that specifies whether hidden pivot items, as specified by [SXVI](#sxvi) records with the **fHidden** field equal to 1, of a pivot field on the page axis with the **isxvi** field of the corresponding [SXPI_Item](#sxpi_item) structure equal to 0x7FFD are filtered out when calculating the PivotTable view. + +MUST be 0 for non-[**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data sources**](#gt_e091613c-6901-4874-b9b2-27273ead1075) if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) is 3. + +**reserved3 (8 bits):** MUST be zero and MUST be ignored. + +**cchPageFieldStyle (2 bytes):** An unsigned integer that specifies the length, in characters, of the XLUnicodeStringNoCch structure in the **stPageFieldStyle** field. If the value is 0xFFFF, then **stPageFieldStyle** does not exist. + +MUST be 0xFFFF or MUST be greater than zero and less than or equal to 0x00FF. + +**cchTableStyle (2 bytes):** An unsigned integer that specifies the length, in characters, of the XLUnicodeStringNoCch structure in the **stTableStyle** field. If the value is 0xFFFF, then **stTableStyle** does not exist. + +MUST be 0xFFFF or MUST be greater than zero and less than or equal to 0x00FF. + +**cchVacateStyle (2 bytes):** An unsigned integer that specifies the length, in characters, of the XLUnicodeStringNoCch structure in the **stVacateStyle** field. If the value is 0xFFFF, then **stVacateStyle** does not exist. + +MUST be 0xFFFF or MUST be greater than zero and less than or equal to 0x00FF. + +**stError (variable):** An XLUnicodeStringNoCch structure that specifies a custom string displayed in cells that contain errors when the value of **fDisplayErrorString** is 1. The length is specified in **cchErrorString**. + +This field is optional and MUST NOT exist if **cchErrorString** is 0xFFFF. + +**stDisplayNull (variable):** An XLUnicodeStringNoCch structure that specifies a custom string displayed in cells that contain NULL values when **fDisplayNullString** is 1. The length is specified in **cchNullString**. + +This field is optional and MUST NOT exist if **cchNullString** is 0xFFFF. + +**stTag (variable):** An XLUnicodeStringNoCch structure that specifies a custom string saved with the PivotTable view. The length is specified in **cchTag**. + +This field is optional and MUST NOT exist if **cchTag** is 0xFFFF. + +**stPageFieldStyle (variable):** An XLUnicodeStringNoCch structure that specifies the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) used in the page area (see Location and Body) of the PivotTable view. The style is specified by the [StyleExt](#styleext) record with its **stName** field equal to this field's value. If **cchPageFieldStyle** is 0xFFFF or less than 1, no style is applied. The length is specified in **cchPageFieldStyle**. + +This field is optional and MUST NOT exist if **cchPageFieldStyle** is 0xFFFF. + +**stTableStyle (variable):** An XLUnicodeStringNoCch structure that specifies the style used in the body of the PivotTable view. The style is specified by the StyleExt record with its **stName** field equal to this field's value. If **cchTableStyle** is 0xFFFF or less than 1, no style is applied. The length is specified in **cchTableStyle**. + +This field is optional and MUST NOT exist if **cchTableStyle** is 0xFFFF. + +**stVacateStyle (variable):** An XLUnicodeStringNoCch structure that specifies the style applied to cells that become empty when the PivotTable view is recalculated. The style is specified by the StyleExt record with its **stName** field equal to this field's value. If **cchVacateStyle** is 0xFFFF or less than 1, no style is applied. The length is specified in **cchVacateStyle**. + +This field is optional and MUST NOT exist if **cchVacateStyle** is 0xFFFF. + +### SXFDB + +The **SXFDB** record specifies properties for a [cache field](#Section_6497eb794042445780e75959c9f0583c) within a [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + +[TABLE] + +**A - fAllAtoms (1 bit):** A bit that specifies whether this cache field has a collection of [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0). If **fSomeUnhashed** is equal to 1, this value MUST be equal to 0. + +**B - fSomeUnhashed (1 bit):** Undefined, and MUST be ignored. If the **fAllAtoms** field is equal to 1, MUST be equal to 0. + +**C - fUsed (1 bit):** Undefined, and MUST be ignored. + +**D - fHasParent (1 bit):** A bit that specifies whether **ifdbParent** specifies a reference to a parent grouping cache field. For more information, see [Grouping](#Section_63e07ed20a764cb08cf446aaf25464c2). If the **fCalculatedField** field is equal to 1, then this field MUST be equal to 0. + +**E - fRangeGroup (1 bit):** A bit that specifies whether this cache field is grouped by using numeric grouping or date grouping, as specified by Grouping. If this field is equal to 1, then this record MUST be followed by a sequence of [SXString](#sxstring) records, as specified by the [GRPSXOPER](#pivot-cache-storage-_sx_db_cur) rule. The quantity of SXString records is specified by **csxoper**. If this field is equal to 1, then this record MUST be followed by a sequence of records that conforms to the SXRANGE rule that specifies the grouping properties for the ranges of values. + +**F - fNumField (1 bit):** A bit that specifies whether the cache items in this cache field contain at least one numeric cache item, as specified by [SXNum](#sxnum). If **fDateInField** is equal to 1, this field MUST be equal to 0. + +**G - unused1 (1 bit):** Undefined and MUST be ignored. + +**H - fTextEtcField (1 bit):** A bit that specifies whether the cache items contain text data. If **fNumField** is 1, this field MUST be ignored. + +**I - fnumMinMaxValid (1 bit):** A bit that specifies whether a valid minimum or maximum value can be computed for the cache field. MUST be equal to 1 if **fDateInField** or **fNumField** is equal to 1. + +**J - fShortIitms (1 bit):** A bit that specifies whether there are more than 255 cache items in this cache field. If **catm** is greater than 255, this value MUST be equal to 1; otherwise it MUST be 0. + +**K - fNonDates (1 bit):** A bit that specifies whether the cache items in this cache field contain values that are not time or date values. If this cache field is a grouping cache field, as specified by Grouping, then this field MUST be ignored. Otherwise, if **fDateInField** is equal to 1, then this field MUST be 0. + +**L - fDateInField (1 bit):** A bit that specifies whether the cache items in this cache field contain at least one time or date cache item, as specified by [SXDtr](#sxdtr). If **fNonDates** is equal to 1, then this field MUST be equal to 0. + +**M - unused2 (1 bit):** Undefined and MUST be ignored. + +**N - fServerBased (1 bit):** A bit that specifies whether this cache field is a server-based page field when the corresponding [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) is on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37), as specified in [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4). + +This value applies only to an [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) PivotCache. MUST NOT be equal to 1 if **fCantGetUniqueItems** is equal to 1. If **fCantGetUniqueItems** is equal to 1, then the [ODBC connection](#Section_a8c9314e9f904738a482e97aa5ec2383) cannot provide a list of unique items for the cache field. + +> MUST be 0 for a cache field in a non-ODBC PivotCache. + +**O - fCantGetUniqueItems (1 bit):** A bit that specifies whether a list of unique values for the cache field was not available while refreshing the source data. This field applies only to a PivotCache that uses ODBC source data and is intended to be used in conjunction with optimization features. For example, the application can optimize memory usage when populating PivotCache records if it has a list of unique values for a cache field before all the records are retrieved from the ODBC connection. Or, the application can determine the appropriate setting of **fServerBased** based on this value. + +MUST be 0 for fields in a non-ODBC PivotCache. + +**P - fCalculatedField (1 bit):** A bit that specifies whether this field is a [calculated field](#Section_4594f2ac815740b381142e77ba8efb7d). The formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) of the calculated field is stored in a directly following [SXFormula](#sxformula) record. If **fHasParent** is equal to 1, this field MUST be equal to 0. + +**ifdbParent (2 bytes):** An unsigned integer that specifies the cache field index, as specified by Cache Fields, of the grouping cache field for this cache field. MUST be greater than or equal to 0x0000 and less than the **cfdbTot** field of the [SXDB](#sxdb) record of this PivotCache. If **fHasParent** is equal to 0, then this field MUST be ignored. If **fHasParent** is equal to 1, and **fRangeGroup** is equal to 1, and the **iByType** field of the [SXRng](#sxrng) record of this cache field is greater than 0, then the **fRangeGroup** of the SXFDB record of the cache field specified by **ifdbParent** MUST be 1 and the **iByType** field of the SXRng record of the cache field specified by **ifdbParent** MUST be greater than the **iByType** field of the SXRng record of this cache field. + +**ifdbBase (2 bytes):** An unsigned integer that specifies the cache field index, as specified by Cache Fields, of the base cache field, as specified by Grouping, for the cache field specified by this record. MUST be greater than or equal to 0x0000 and less than the value of the **cfdbdb** field of the SXDB record of this PivotCache. If the cache field specified by this record is not a grouping cache field, then this field MUST be ignored. + +**citmUnq (2 bytes):** Undefined and MUST be ignored. + +**csxoper (2 bytes):** An unsigned integer that specifies the number of cache items in this cache field when this cache field is a grouping cache field, as specified by Grouping. There MUST be an equivalent number of sequences of records that conform to the GRPSXOPER rule following this record that specify the cache items. If the **fRangeGroup** field and the **fCalculatedField** field are equal to 0 and this cache field corresponds to a source data entity, this field MUST be equal to 0. If the **fRangeGroup** field is equal to 1, this value MUST be greater than or equal to 1. + +**cisxoper (2 bytes):** An unsigned integer that specifies the number of cache items in the base cache field that are grouped by this cache field. There MUST be an equivalent number of [SxIsxoper](#sxisxoper) records following this record that specify which cache item in this cache field groups each of the cache items in the base cache field. For more information, see Grouping. + +**catm (2 bytes):** An unsigned integer that specifies the number of cache items in the collection sequences of records that conform to the SRCSXOPER rule in this cache field. If **fAllAtoms** is 0, then this field MUST be equal to 0x0000. If this cache field corresponds to source data entities then there MUST be an equal number of SRCSXOPER rules in this cache field. + +**stFieldName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the name of the cache field. MUST be less than or equal to 255 characters long. + +### SXFDBType + +The **SXFDBType** record specifies the type of data contained in this [cache field](#Section_6497eb794042445780e75959c9f0583c). + +[TABLE] + +**wTypeSql (2 bytes):** An [ODBCType](#odbctype) structure that specifies the [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) data type as returned by the ODBC provider of the data in this cache field. + +### SxFilt + +The **SxFilt** record specifies information for a [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f) filter. + +See [SxRule](#sxrule) for more information about [PivotTable views](#Section_09410dfbaac84a719ecf177ffba12c37) that this record applies to. + +[TABLE] + +**A - sxaxisRw (1 bit):** A bit that specifies whether this [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) refers to the [row axis](#Section_3f46e7207706400cba9473cb829f869a). MUST be zero if **sxaxisCol** is 1, if **sxaxisPage** is 1, or if **sxaxisData** is 1. + +**B - sxaxisCol (1 bit):** A bit that specifies whether this filter refers to the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). MUST be zero if **sxaxisRw** is 1, if **sxaxisPage** is 1, or if **sxaxisData** is 1. + +**C - sxaxisPage (1 bit):** A bit that specifies whether this filter refers to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). MUST be zero if **sxaxisRw** is 1, if **sxaxisCol** is 1, or if **sxaxisData** is 1. + +**D - sxaxisData (1 bit):** A bit that specifies whether this filter refers to the [value axis](#Section_4c5c2daa289746e1854b0ce04209f060). MUST be zero if **sxaxisRw** is 1, if **sxaxisCol** is 1, or if **sxaxisPage** is 1. + +**E - reserved1 (2 bits):** MUST be zero, and MUST be ignored. + +**iDim (10 bits):** A signed integer that specifies the zero-based position of the [PivotTable field](#Section_1edf7f2294084945b2de56526c14fca5) within the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) specified by **sxAxis**. MUST be greater than or equal to 0 and less than or equal to 31. + +**isxvd (10 bits):** A signed integer that specifies the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592), pivot field, or [cache field](#Section_6497eb794042445780e75959c9f0583c) that this filter refers to. MUST be greater than or equal to 0 and less than or equal to 255 or equal to -2. MUST be a value from the following table: + +| Value | Value of the fCacheBased field of the preceding SxRule record | Meaning | +|----|----|----| +| -2 | MUST be 0 | Specifies that this rule refers to the data field. | +| A value greater than or equal to zero | 0 | Specifies a pivot field index as specified by pivot fields. The pivot field index specifies which pivot field is referenced by this filter. | +| A value greater than or equal to zero | 1 | Specifies a cache field index as specified by cache fields. The cache field index specifies which cache field is referenced by this filter. | + +**F - fSelected (1 bit):** A bit that specifies whether the header of the PivotTable field this filter refers to is included in the PivotTable rule that this record belongs to. + +**G - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**H - reserved3 (4 bits):** MUST be zero, and MUST be ignored. + +**grbitSbt (2 bytes):** A signed integer that specifies the set of subtotals used in this filter. MUST be one of the following bits, or a combination of the following bits. DEFAULT MUST be combined only with DATA, BLANK, or both. + +| Bits | Meaning | +|--------|---------| +| 0x0001 | DATA | +| 0x0002 | DEFAULT | +| 0x0004 | SUM | +| 0x0008 | COUNTA | +| 0x0010 | AVERAGE | +| 0x0020 | MAX | +| 0x0040 | MIN | +| 0x0080 | PRODUCT | +| 0x0100 | COUNT | +| 0x0200 | STDEV | +| 0x0400 | STDEVP | +| 0x0800 | VAR | +| 0x1000 | VARP | +| 0x4000 | BLANK | + +**cisxvi (2 bytes):** An unsigned integer that specifies the number of indexes in the [SxItm](#sxitm) record that follows this record. + +### SxFmla + +The **SxFmla** record specifies a [PivotParsedFormula](#pivotparsedformula) and specifies the beginning of a collection of records as defined by the [pivot cache](#Section_c5fb3f663ef64308ae3de59244159687) storage [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) [calculated field](#Section_4594f2ac815740b381142e77ba8efb7d) or [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b) formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). + +[TABLE] + +**formula (variable):** A PivotParsedFormula structure that specifies the formula. + +### SxFormat + +The **SxFormat** record specifies the beginning of a collection of records as defined by the [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies the [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6) and specifies a [PivotRule](#Section_ce60432dda944422929fcf3f6a0a206f) that specifies the area of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) to apply the formatting to. + +[TABLE] + +**rlType (4 bits):** A Boolean (section [2.5.14](#boolean)) that specifies whether formatting was applied to the PivotTable view. MUST be a value from the following table: + +| Value | Description | +|--------|-----------------------------| +| 0x0000 | The formatting was cleared. | +| 0x0001 | The formatting was applied. | + +**reserved (12 bits):** MUST be zero, and MUST be ignored + +**cbData (2 bytes):** An unsigned integer that specifies the number of bytes in the [SxDXF](#sxdxf) record that follows this record. MUST be zero if **rlType** is zero. If this field is zero then zero SxDXF records MUST follow this record. + +### SXFormula + +The **SXFormula** record specifies the [cache field](#Section_6497eb794042445780e75959c9f0583c) that a [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b) formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) applies to. The calculated item formula is stored in the last [SxFmla](#sxfmla) record preceding this record. + +[TABLE] + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**ifdb (2 bytes):** A signed integer that specifies the cache field index as specified in Cache Fields. The cache field index specifies which cache field the calculated item formula applies to. MUST be greater than or equal to -1. If the value is -1, the calculated item formula applies to all cache fields. If the cache field is a source field, the value MUST be equal to the value of **isxvd** in the last [SxRule](#sxrule) record preceding this record. + +### SXInt + +The **SXInt** record specifies a number in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + +[TABLE] + +**num (2 bytes):** A signed integer that specifies a number in the PivotCache. + +### SxIsxoper + +The **SxIsxoper** record specifies the mapping between [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in a [cache field](#Section_6497eb794042445780e75959c9f0583c) and cache items in a grouping cache field for discrete grouping, as specified by [Grouping](#Section_63e07ed20a764cb08cf446aaf25464c2). The grouping cache field is specified by the [SXFDB](#sxfdb) record preceding this record. The value of the **fRangeGroup** field of the SXFDB record MUST be 0 and the value of the **csxoper** field of the SXFDB record MUST be greater than 0. This record immediately follows the collection of records that specifies cache item values for the SXFDB record as defined in the [PivotCache Storage](#Section_c5fb3f663ef64308ae3de59244159687) part [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +[TABLE] + +**rgSxIsxoper (variable):** An array of 2-byte unsigned integers. Each element of the array corresponds to a cache item in the cache field being grouped by the grouping cache field. The value of each element specifies the index of the cache item, as specified by Cache Items, in the grouping cache field that the cache item in the cache field is grouped under. + +The count of elements in the array MUST be equal to the value of the **cisxoper** field of the SXFDB record preceding this record and is identical to the number of cache items in the cache field being grouped. The value of each element MUST be less than the total number of cache items in the grouping cache field. + +### SxItm + +The **SxItm** record specifies references to [pivot items](#Section_58891cc5dd9b4293a97831070779524f), [data items](#Section_b51aa7b309b34aa78cb4964ad24d1679), or [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) as part of a [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f) filter. + +If this record exists, the **cisxvi** field of the preceding [SxFilt](#sxfilt) MUST be greater than 0. + +See [SxRule](#sxrule) for more information about [PivotTable views](#Section_09410dfbaac84a719ecf177ffba12c37) that this record applies to. + +[TABLE] + +**rgisxvi (variable):** An array of 2-byte unsigned integers that specifies pivot items, data item, or cache items associated with [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) included in the PivotTable rule. The array MUST be sorted in ascending order. The size of the array MUST be equal to the value of the **cisxvi** field of the preceding SxFilt record. Each unsigned 2-byte integer in the array MUST be less than or equal to 32500, or equal to 32767. The value 32767 specifies that there is no associated pivot item, data item, or cache item with the index. For more information, see PivotTable Rules. The meaning of this field is specified in the following table: + +[TABLE] + +### SxIvd + +The **SxIvd** record specifies an array of [SxIvdRw](#sxivdrw) or [SxIvdCol](#sxivdcol). + +An array of SxIvdRw specifies all items for the [row axis](#Section_3f46e7207706400cba9473cb829f869a) of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). An array of SxIvdCol specifies all items on [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) of the PivotTable view. + +Two or fewer records of this type appear in the file depending on the values of the **cDimRw** and **cDimCol** fields of the [SxView](#sxview) record of the PivotTable view. + +If the **cDimRw** and **cDimCol** fields of the SxView record are both greater than zero, then two records of this type appear in the file for the PivotTable view. The first record is an array of SxIvdRw and the second record is an array of SxIvdCol. + +If the value of the **cDimRw** field of the SxView record is greater than zero and the value of the **cDimCol** field of the SxView record is equal to zero, then only one record of this type appears in the file for the PivotTable view and it is an array of SxIvdRw. + +If the value of the **cDimCol** field of the SxView record is greater than zero and the value of the **cDimRw** field of the SxView record is equal to zero, then only one record of this type appears in the file for the PivotTable view and it is an array of SxIvdCol. + +[TABLE] + +**rgSxivd (variable):** An array of SxIvdRw or SxIvdCol items. + +If this is an array of SxIvdRw, the count of elements in the array MUST equal the value of the **cDimRw** field of the SxView record. + +If this is an array of SxIvdCol, the count of elements in the array MUST equal the value of the **cDimCol** field of the SxView record. + +### SXLI + +The **SXLI** record specifies [pivot lines](#Section_76610990666f492791b6d2280f607464) for the [row area](#Section_5594c95e6819461e80706f4b4fdfa091) or [column area](#Section_03aced8c25864e83982a1e3551a563d6) of a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +[TABLE] + +**rgsxli (variable):** An array of [SXLIItem](#sxliitem). + +Zero or two records of this type appear in the file for each PivotTable view depending on the values of the **cRw** and **cCol** fields of the associated [SxView](#sxview) record. + +If the value of either of the **cRw** or **cCol** fields of the associated SxView is greater than zero, then two records of this type MUST exist in the file for the associated SxView. The first record contains row area pivot lines and the second record contains column area pivot lines. + +The count of SXLIItem structures in **rgsxli**, which are row area pivot lines, MUST equal the **cRw** field of SxView. + +The count of SXLIItem structures in **rgsxli**, which are column area pivot lines, MUST equal the **cCol** field of SxView. + +The associated SxView record is the SxView record of the PivotTable view. + +### SxName + +The **SxName** record specifies information used for a [calculated field](#Section_4594f2ac815740b381142e77ba8efb7d) or [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b) and that specifies the beginning of a collection of records as specified by the [pivot cache](#Section_c5fb3f663ef64308ae3de59244159687) storage [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf).  When used for a calculated field, this record specifies the index of a [cache field](#Section_6497eb794042445780e75959c9f0583c) used in a calculated field formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)).  When used for a calculated item, this record is followed by a collection of [SxPair](#sxpair) records that specify a [pivot item](#Section_58891cc5dd9b4293a97831070779524f) used in a calculated item formula (section 2.2.2). + +[TABLE] + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - fErrName (1 bit):** A bit that specifies whether this record is not valid. MUST be set to 1 if **ifdb** field is set to -1. + +**unused2 (14 bits):** Undefined and MUST be ignored. + +**ifdb (2 bytes):** A signed integer that specifies a cache field index. The cache field index specifies a cache field used in a calculated field formula. MUST be greater than or equal to -1. MUST be set to -1 if **csxpair** is greater than 0. MUST be set to -1 when the calculated field formula cannot be computed because the cache field used in the formula is removed. + +**ifn (2 bytes):** A signed integer that MUST be set to -1. + +**csxpair (2 bytes):** An unsigned integer that specifies the count of contiguous SXPair records that follow this record. MUST be less than or equal to 1. MUST be equal to 0 if and only if this record is in a calculated field. + +### SxNil + +The **SxNil** record specifies an empty [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) or value. + +### SXNum + +The **SXNum** record specifies a numeric [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) or value. + +[TABLE] + +**num (8 bytes):** An Xnum (section [2.5.342](#xnum)) structure that specifies the numeric record value. + +### SXPair + +The **SXPair** record specifies a reference to a [pivot item](#Section_58891cc5dd9b4293a97831070779524f) used to compute the value of a [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b) in a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +[TABLE] + +**isxvd (2 bytes):** An unsigned integer that specifies a [cache field](#Section_6497eb794042445780e75959c9f0583c) index. This index specifies a cache field that contains the [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) associated with the pivot item specified by **iCache**. + +**iCache (2 bytes):** A signed integer that specifies a pivot item of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) associated with this record as specified by [Associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4). This pivot item is used in a calculated item formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). If more than one PivotTable view is associated with this record, **iCache** specifies a pivot item for each such PivotTable view. + +If the value of **fPhysical** is 0, **iCache** is a cache item index and specifies the pivot item associated with that cache item. + +Otherwise, if the value of **fRelative** is 0 or if no pivot item in the visible item collection has a pivot item index smaller than the pivot item index of the current pivot item, **iCache** is a visible item index. Otherwise, the pivot item specified by **iCache** is the pivot item whose visible item index equals the value of **iCache** + 1 + the largest visible item index whose associated pivot item has a pivot item index smaller than the pivot item index of the current pivot item. If this value is less than 0 or greater than or equal to the number of elements in the visible item collection, no pivot item is specified. + +The current pivot item is the pivot item in the current [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) that corresponds to the calculated item that contains this record. + +The current pivot field is the pivot field of the PivotTable view associated with the cache field specified by **isxvd**. + +The visible item collection is the ordered collection of all pivot items specified by the sequence of records that conforms to the [PIVOTVD](#worksheet-substream) rule associated with the current pivot field that satisfy the following criteria: + +- The value of the **fHidden** field of the [SXVI](#sxvi) record associated with the pivot item is 0. + +- The value of the **fMissing** field of the SXVI record associated with the pivot item is 0 or the value of the **fShowAllItems** field of the SXVI record associated with the current pivot field is 1. + +- The value of the **itmType** field of the SXVI record associated with the pivot item is 0. + +A visible item index is specified to be the zero-based index of a pivot item in the visible item collection. + +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +**A - fFormula (1 bit):** A bit that specifies whether the item is a calculated item. If **fPhysical** is 1, it MUST have the same value as the **fFormula** field of the SXVI record corresponding to the pivot item specified by **iCache**. + +**B - reserved2 (2 bits):** MUST be zero, and MUST be ignored. + +**C - fPhysical (1 bit):** A bit that specifies whether **iCache** specifies a cache item index. + +| Value | Meaning | +|-------|-------------------------------------------------| +| 0 | **iCache** specifies a cache item index. | +| 1 | **iCache** does not specify a cache item index. | + +**D - fRelative (1 bit):** A bit that specifies whether the item is referred to by relative position rather than absolute position. If **fPhysical** is 0, **fRelative** MUST be 0 and MUST be ignored. If **fPhysical** is 1, **fRelative** MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------------------| +| 0 | Absolute position. | +| 1 | Position relative to the calculated item referring this item. | + +**reserved3 (11 bits):** MUST be zero, and MUST be ignored. + +### SXPI + +The **SXPI** record specifies the [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5) and information about filtering on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +MUST exist if and only if the value of the **cDimPg** field of the [SxView](#sxview) record of the PivotTable view is greater than zero. + +[TABLE] + +**rgsxpi (variable):** An array of [SXPI_Item](#sxpi_item)s that specifies the pivot fields and information about filtering on the page axis of a PivotTable view. The number of array elements MUST equal the value of the **cDimPg** field of the SxView record of the PivotTable view. + +### SXPIEx + +The **SXPIEx** record specifies [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) extensions to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). The number of SXPIEx records MUST equal the number of array elements in the **rgsxpi** field of the [SXPI](#sxpi) record. Each SXPIEx record corresponds to the [SXPI_Item](#sxpi_item) at the same position in the **rgsxpi** field of the SXPI record. + +For more information, see [OLAP Page Filtering](#Section_e04e871619234e2db02a270894d6be73). + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x080E. + +**isxth (4 bytes):** An unsigned integer that specifies a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) index, as specified in Pivot Hierarchies, of the pivot hierarchy associated with this entry on the page axis. The **sxaxis.sxaxisPage** field of the [SXTH](#sxth) record of the pivot hierarchy MUST be 1. + +**stUnique (variable):** A [XLUnicodeString](#xlunicodestring) structure that specifies the unique name of the [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) that is used for filtering. The length of the string MUST be less than or equal to 255. + +**stDisplay (variable):** A XLUnicodeString structure that specifies the caption of this OLAP member. The length of the string MUST be less than or equal to 255. + +### SXRng + +The **SXRng** record specifies properties for numeric grouping or date grouping of [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in a grouping [cache field](#Section_6497eb794042445780e75959c9f0583c), as specified by [Grouping](#Section_63e07ed20a764cb08cf446aaf25464c2). The values of the **fRangeGroup** and **fCalculatedField** fields of the [SXFDB](#sxfdb) record of this cache field MUST be 1 and 0, respectively. + +[TABLE] + +**A - fAutoStart (1 bit):** A bit that specifies whether the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) is used to set the starting range value. + +| Value | Meaning | +|----|----| +| 0 | The starting range value is not recalculated from the source data on the next refresh. | +| 1 | The starting range value is recalculated from the source data on the next refresh. | + +**B - fAutoEnd (1 bit):** A bit that specifies whether the source data is used to set the ending range value. + +| Value | Meaning | +|----|----| +| 0 | The ending range value is not recalculated from the source data on the next refresh. | +| 1 | The ending range value is recalculated from the source data on the next refresh. | + +**C - iByType (3 bits):** An unsigned integer that specifies the grouping criteria. + +If the value of the **fNumField** field of the SXFDB record of this cache field is 1, **iByType** specifies numeric grouping, as specified by Grouping. In this case, **iByType** MUST be 0 and this record MUST be followed by three [SXNum](#sxnum) records specifying the starting number, the ending number, and the interval size, respectively. Additionally, the ending number MUST be greater than or equal to the starting number. + +If the value of the **fNumField** field of the SXFDB record of this cache field is 0, **iByType** specifies date grouping, as specified by Grouping. In this case, **iByType** MUST be greater than 0. Additionally, this record MUST be followed by two [SXDtr](#sxdtr) records followed by one [SXInt](#sxint) record specifying the starting date/time, the ending date/time, and the interval size, respectively. The ending date/time MUST be greater than or equal to the starting date/time. If this cache field corresponds to source data entities, the collection of sequences of records that conform to the [SRCSXOPER](#pivot-cache-storage-_sx_db_cur) rule in this cache field MUST contain only SXDtr and [SxNil](#sxnil) records. + +**iByType** MUST be a value from the following table: + +| Value | Meaning | Restriction on the value of the catm field of the SXFDB record of this cache field, dictated by the value of iByType. | +|----|----|----| +| 0 | Group by numeric value. | No restriction. | +| 1 | Group by seconds. | MUST be 62. | +| 2 | Group by minutes. | MUST be 62. | +| 3 | Group by hours. | MUST be 26. | +| 4 | Group by days. | MUST be 368. | +| 5 | Group by months. | MUST be 14. | +| 6 | Group by quarters. | MUST be 6. | +| 7 | Group by years. | No restriction. | + +**unused (11 bits):** Undefined and MUST be ignored. + +### SxRule + +The **SxRule** record specifies areas or parts of a one or more [PivotTable views](#Section_09410dfbaac84a719ecf177ffba12c37), as specified in [PivotTable rules](#Section_ce60432dda944422929fcf3f6a0a206f), and that specifies the beginning of a collection of [SxFilt](#sxfilt) records as specified by the [Common Productions](#Section_a1b3d8b4744241fd9c57bbd2a6394082) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). Each SxFilt record specifies an individual area or part of the PivotTable view. + +If this record occurs as part of the specification of a PivotTable view, references (in this record and in the collection) to [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5), the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592), and [pivot items](#Section_58891cc5dd9b4293a97831070779524f) are instances of those entities in the context of the PivotTable view. + +If this record occurs as part of the specification of a [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e), references (in this record and the collection) to PivotTable view, pivot fields, the data field, and pivot items are instances of those entities in the context of all the [associated PivotTable views](#Section_855483943345473bb926de5189fd664d) of the PivotCache. + +[TABLE] + +**iDim (8 bits):** An unsigned integer that specifies the zero-based position of the pivot field specified by **isxvd** within the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c). MUST be greater than or equal to 0 and less than or equal to 255. + +**isxvd (8 bits):** An unsigned integer that specifies the data field, pivot field, or [cache field](#Section_6497eb794042445780e75959c9f0583c) that this rule refers to. MUST be equal to 0xFF if this record is followed by any SxFilt records. MUST be a value from the following table: + +| Value | Value of fCacheBased | Meaning | +|----|----|----| +| 0 to 0xFD | 0 | Specifies a pivot field index, as specified by pivot fields, to the pivot field that this rule refers to. | +| 0 to 0xFD | 1 | Specifies a cache field index, as specified by cache fields, to the cache field that this rule refers to. | +| 0xFE | MUST be 0 | Specifies that this rule refers to the data field. | +| 0xFF | 0 | Specifies that the rule is followed by zero or more SxFilt records, which specify the pivot fields that this rule refers to. | +| 0xFF | 1 | Specifies that the rule is followed by zero or more SxFilt records, which specify the cache fields that this rule refers to. | + +**A - sxaxisRw (1 bit):** A bit that specifies whether the [row axis](#Section_3f46e7207706400cba9473cb829f869a) is referenced by this record. + +MUST be zero if **sxaxisCol** is 1, **sxaxisPage** is 1, or **sxaxisData** is 1. + +**B - sxaxisCol (1 bit):** A bit that specifies whether the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) is referenced by this record. + +MUST be zero if **sxaxisRw** is 1, **sxaxisPage** is 1, or **sxaxisData** is 1. + +**C - sxaxisPage (1 bit):** A bit that specifies whether the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) is referenced by this record. + +MUST be zero if **sxaxisRw** is 1, **sxaxisCol** is 1, or **sxaxisData** is 1. + +**D - sxaxisData (1 bit):** A bit that specifies whether the [value axis](#Section_4c5c2daa289746e1854b0ce04209f060) is referenced by this record. + +MUST be zero if **sxaxisRw** is 1, **sxaxisCol** is 1, or **sxaxisPage** is 1. + +**sxrType (4 bits):** An unsigned integer that specifies the PivotTable view area that this rule refers to. MUST be a value from the following table: + +[TABLE] + +This rule is followed by SxFilt records if and only if that value of **sxrType** is equal to 0x1 or 0x2. + +**E - fPart (1 bit):** A bit that specifies whether only a portion of the PivotTable view area is included in this rule. If the value equals 1, **irwFirst, irwLast, icolFirst,** and **icolLast** hold the relative location in the PivotTable view area included in this rule. + +**F - fDataOnly (1 bit):** A bit that specifies whether only the data cells of the PivotTable view are included in this rule. MUST be 0 if **fLabelOnly** is equal to 1. + +**G - fLabelOnly (1 bit):** A bit that specifies whether only the labels of the PivotTable view are included in this rule. MUST be 1 if **sxrType** is equal to 0x5 or 0x6. MUST be 0 if **fDataOnly** is equal to 1. + +**H - fGrandRw (1 bit):** A bit that specifies whether the grand total row is included in this rule. + +**I - fGrandCol (1 bit):** A bit that specifies whether the grand total column is included in this rule. + +**J - fGrandRwSav (1 bit):** A bit that specifies whether the grand total row was included in this PivotTable rule when the PivotTable rule was created. + +**K - fCacheBased (1 bit):** A bit that specifies whether **isxvd** specifies a cache field in the PivotCache, or a pivot field or the data field in a PivotTable view. + +| Value | Meaning | +|----|----| +| 0 | **isxvd** specifies a pivot field or the data field in a PivotTable view. | +| 1 | **isxvd** specifies a cache field in the PivotCache. | + +**L - fGrandColSav (1 bit):** A bit that specifies whether the grand total column was included in this PivotTable rule when the PivotTable rule was created. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**csxFilt (2 bytes):** An unsigned integer that specifies the number of SxFilt records following this record. MUST be zero if **sxrType** is neither 0x1 nor 0x2. + +**irwFirst (1 byte):** An optional unsigned integer that specifies the offset of the first row, from the first cell in the PivotTable view area to the first cell in the partial area included in this rule. MUST be less than or equal to 255. This field MUST NOT exist if **fPart** is equal to 0. + +**irwLast (1 byte):** An optional unsigned integer that specifies the offset of the last row, from the first cell in the PivotTable view area to the last cell in the partial area included in this rule. MUST be greater than or equal to **irwFirst** and less than or equal to 255. This field MUST NOT exist if **fPart** is equal to 0. + +**icolFirst (1 byte):** An optional unsigned integer that specifies the offset of the first column, from the first cell in the PivotTable view area to the first cell in the partial area included in this rule. MUST be less than or equal to 255. This field MUST NOT exist if **fPart** is equal to 0. + +**icolLast (1 byte):** An optional unsigned integer that specifies the offset of the last column, from the first cell in the PivotTable view area to the last cell in the partial area included in this rule. MUST be greater than or equal to **icolFirst** and less than or equal to 255. This field MUST NOT exist if **fPart** is equal to 0. + +### SxSelect + +The **SxSelect** record specifies information about [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) report for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). The selection is stored in the [PivotTable rule](#Section_ce60432dda944422929fcf3f6a0a206f) following this record. + +[TABLE] + +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +**pnn (1 byte):** A [**PaneType**](#panetype) structure that specifies the [**active pane**](#gt_33f49274-001d-40a3-bcca-f54a93906c29). + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +**sxaxisAct (2 bytes):** An [SXAxis](#sxaxis) structure that specifies the [PivotTable Axis](#Section_89db73685e8e4324b592af85e4559e6c) of the PivotTable [**selection**](#gt_8a241461-3c59-45fb-9094-b6692a0c27fe). + +The value of the **sxaxisData** field of SXAxis MUST be zero. + +**iDimAct (2 bytes):** An unsigned integer that specifies the zero-based field position of the field that is selected within the PivotTable Axis. + +**iLiStart (2 bytes):** An unsigned integer that specifies the zero-based position of the [PivotTable line](#Section_76610990666f492791b6d2280f607464) where the selection operation started. MUST be greater than or equal to the **iLiMin** field and less than or equal to the **iLiMax** field. + +**iLiAct (2 bytes):** An unsigned integer that specifies the zero-based position of the PivotTable line that was most recently included in the selection. MUST be greater than or equal to zero and less than or equal to the **iLiMax** field. + +**iLiMin (2 bytes):** An unsigned integer that specifies the zero-based position of the minimum PivotTable line that could be included in the selection. MUST be greater than or equal to zero and less than or equal to the **iLiMax** field. + +**iLiMax (2 bytes):** An unsigned integer that specifies the zero-based position of the maximum PivotTable line that could be included in the selection. MUST be greater than or equal to zero. MUST be greater than or equal to the **iLiMin** field. + +**rwClick (2 bytes):** An [RwU](#rwu) structure that specifies the row of the cell where the user last clicked for the PivotTable selection. + +**colClick (2 bytes):** A [ColU](#colu) structure that specifies the column of the cell where the user last clicked for the PivotTable selection. + +**rwClickPrev (2 bytes):** An RwU structure that specifies the row of the cell previously clicked by the user on the PivotTable selection. + +**colClickPrev (2 bytes):** A ColU structure that specifies the column of the cell previously clicked on the PivotTable selection. + +**cClick (5 bits):** An unsigned integer that specifies the number of clicks made by the user to refine the current PivotTable selection. + +**A - fLabelOnly (1 bit):** A bit that specifies that only cells in the [row area](#Section_5594c95e6819461e80706f4b4fdfa091), [column area](#Section_03aced8c25864e83982a1e3551a563d6), or [page area](#Section_f10ef7d86c044d35a5830d6f2ce92063) are selected. + +**B - fDataOnly (1 bit):** A bit that specifies that only cells in the [data area](#Section_237a24905c614931923f7ee856f23c72) are selected. + +**C - fToggleDataHeader (1 bit):** A bit that specifies whether the PivotTable selection toggle is enabled. The selection toggle enables a method for the user to select values, labels, or both values and labels. + +**D - fSelectionClick (1 bit):** A bit that specifies whether any selections on the PivotTable were refined by the user. + +**E - fExtendable (1 bit):** A bit that specifies whether an additional PivotTable line can be added to the current selection. + +**unused (6 bits):** Undefined and MUST be ignored. + +### SXStreamID + +The **SXStreamID** record specifies a stream in the [PivotCache storage](#Section_c5fb3f663ef64308ae3de59244159687). + +[TABLE] + +**idStm (2 bytes):** An unsigned integer that specifies a stream in the PivotCache storage. The stream specified is the one that has its name equal to the hexadecimal representation of this field. The four-digit hexadecimal string representation of this field, where each hexadecimal letter digit is a capital letter, MUST be equal to the name of a stream in the PivotCache storage. + +### SXString + +The **SXString** record specifies a segment of a string that contains information about a [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) or an [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9). When this record occurs in a sequence of records that conforms to the [SRCSXOPER](#pivot-cache-storage-_sx_db_cur) rule or the GRPSXOPER rule, then it specifies a [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) with a string value. + +[TABLE] + +**cch (2 bytes):** An unsigned integer that specifies the length, in characters, of the [XLUnicodeStringNoCch](#xlunicodestringnocch) structure in the **segment** field. If **cch** is 0xFFFF, **segment** MUST NOT exist. + +**segment (variable):** An XLUnicodeStringNoCch structure that specifies a segment of the string. This exists only if the value of the **cch** field is different than 0xFFFF. + +### SXTbl + +The **SXTbl** record stores information about [multiple consolidation ranges](#Section_2535c296b76b4728b52c72fbabaf3047). + +[TABLE] + +**cdref (2 bytes):** An unsigned integer that specifies the number of multiple consolidation ranges used as [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) for the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). MUST be equal to the number of [DConRef](#dconref), [DConBin](#dconbin), or [DConName](#dconname) records that follow this record. + +**csxtbpg (2 bytes):** An unsigned integer that specifies the number of [SxTbpg](#sxtbpg) records that follow this record. MUST be equal to **cdref**. + +**cPages (15 bits):** An unsigned integer that specifies the number of optional [cache fields](#Section_6497eb794042445780e75959c9f0583c) in the PivotCache, as specified by Multiple Consolidation Ranges. MUST be less than or equal to 0x0004. + +**A - fAutoPage (1 bit):** A bit that specifies whether there is one automatically created cache field with [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) qualifying each source data [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of the multiple consolidation ranges PivotCache. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The cache fields that qualify the source data ranges are not automatically created. | +| 1 | There is one automatically created cache field with cache items qualifying each source data range of the multiple consolidation ranges PivotCache. Each cache item qualifies one source data range. | + +### SxTbpg + +The **SxTbpg** record specifies properties of [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) for a [multiple consolidation ranges](#Section_2535c296b76b4728b52c72fbabaf3047) [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). There MUST be one SxTbpg record for each source data range. The order of the SxTbpg records corresponds to the order of the [DREF](#globals-substream) records that precede this record. + +[TABLE] + +**rgiitem (variable):** An array of signed 2-byte integers that associates [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) with the range associated with this record. Each element in this array is associated with a [cache field](#Section_6497eb794042445780e75959c9f0583c), as specified in the multiple consolidation ranges overview. + +The number of elements in this array MUST be equal to the value of the **cPages** field of the preceding [SXTbl](#sxtbl) record and MUST be equal to the number of [SXTBRGIITM](#sxtbrgiitm) records that follow this record. The *n^(th)* element in this array is associated with the *n^(th)* SXTBRGIITM record that follows this record. + +Each element in this array MUST be less than the value of the **cItems** field of the associated SXTBRGIITM. Each element in this array MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | Specifies that a blank cache item is used. | +| Greater than or equal to zero | Specifies the zero-based index of an [SXString](#sxstring) record in the collection of SXString records directly following the associated SXTBRGIITM record. | + +### SXTBRGIITM + +The **SXTBRGIITM** record specifies the beginning of a collection of [SXString](#sxstring) records as specified by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of SXString records specifies the values corresponding to the [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) for an optional [cache field](#Section_6497eb794042445780e75959c9f0583c) in a [multiple consolidation ranges](#Section_2535c296b76b4728b52c72fbabaf3047) [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + +[TABLE] + +**cItems (2 bytes):** An unsigned integer that specifies the number of SXString records that follow this record. MUST be less than or equal to 65534. + +### SXTH + +The **SXTH** record specifies properties of a [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33). + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x080D. + +**A - fMeasure (1 bit):** A bit that specifies whether this pivot hierarchy is an [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118), which means it can be placed only on the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**B - unused1 (1 bit):** Undefined and MUST be ignored. + +**C - fOutlineMode (1 bit):** A bit that specifies whether the [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5) representing the levels of this pivot hierarchy have the **fOutline** field of the [SXVDEx](#sxvdex) record set to 1 when the pivot fields are first created. See [Subtotalling](#Section_427438d9b8e34a5c8b678f158fbf680f) for more information. + +**D - fEnableMultiplePageItems (1 bit):** A bit that specifies whether multiple [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) can be selected when the pivot hierarchy is on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +**E - fSubtotalAtTop (1 bit):** A bit that specifies whether the pivot fields representing the levels of this pivot hierarchy have the **fSubtotalAtTop** field of the SXVDEx record set to 1 when the pivot fields are first created. See Subtotalling for more information. + +**F - fSet (1 bit):** A bit that specifies whether this pivot hierarchy is an [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28). MUST be 0 if **fMeasure** is 1. + +**G - fDontShowFList (1 bit):** A bit that specifies whether this pivot hierarchy is hidden in the list of pivot fields that can be added to or removed from the PivotTable view. + +**H - fAttributeHierarchy (1 bit):** A bit that specifies whether this pivot hierarchy is an [**attribute hierarchy**](#gt_8f75d668-e8c6-4f42-ba44-d90604d3b9dc). + +**I - fTimeHierarchy (1 bit):** A bit that specifies whether this pivot hierarchy is a [**time hierarchy**](#gt_1c5d8e4b-5628-41ec-aa9f-95f243e2bed5). + +**J - fFilterInclusive (1 bit):** A bit that specifies whether [manual filters](#Section_b0b282651e334c86ad030f5693c1d1e4) applied to this pivot hierarchy are inclusive or exclusive. MUST be a value from the following table: + +| **Value** | **Meaning** | +|----|----| +| 0 | OLAP members specified in the manual filter are excluded from the PivotTable view along with their descendants. | +| 1 | OLAP members specified in the manual filter are included from the PivotTable view along with their ascendants and descendants. | + +For more information, see [OLAP Manual Filters](#Section_bd4665ebb56a44e690b9ceaf7ec55389). + +**K - unused2 (1 bit):** Undefined and MUST be ignored. + +**L - fKeyAttributeHierarchy (1 bit):** A bit that specifies whether this pivot hierarchy is the key attribute hierarchy in the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**dimension (1)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c). + +**M - fKPI (1 bit):** A bit that specifies whether this pivot hierarchy is a [**key performance indicator (KPI)**](#gt_1d2666f5-ffca-4053-868a-0cd4434ce5a8) [**hierarchy**](#gt_a07fc05d-cdb0-442c-984a-dd3589b9f682). + +**unused3 (19 bits):** Undefined and MUST be ignored. + +**sxaxis (2 bytes):** An [SXAxis](#sxaxis) structure that specifies the axis or axes this pivot hierarchy is present on. For more information, see [PivotTable Axes](#Section_89db73685e8e4324b592af85e4559e6c). + +- If **sxaxis.sxaxisData** is 1, then **sxaxis.sxaxisRw**, **sxaxis.sxaxisCol**, and **sxaxis.sxaxisPage** MUST be zero. + +- If **sxaxis.sxaxisRw** is 1, then **sxaxis.sxaxisCol** and **sxaxis.sxaxisPage** MUST be zero. + +- If **sxaxis.sxaxisCol** is 1, **sxaxis.sxaxisPage** MUST be zero. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**isxvd (4 bytes):** A signed integer that specifies a pivot field index as specified by Pivot Fields. The pivot field index specifies the associated pivot field for this pivot hierarchy. + +If the value of **sxaxis.sxaxisPage** is 1 or the value of **sxaxis.sxaxisData** is 1, then the value of this field MUST be greater than or equal to 0 and MUST be less than the value of the **cDim** field of the [SxView](#sxview) record of the PivotTable view, and the value of **cisxvd** MUST be 0. Also, the **sxaxis** field of the [Sxvd](#sxvd) record of the referenced pivot field MUST be equal to the **sxaxis** field of this record. + +If both **sxaxis.sxaxisPage** and **sxaxis.sxaxisData** are equal to 0, the value of this field MUST be ignored. + +**csxvdXl (4 bytes):** A signed integer that specifies the number of pivot fields in the PivotTable view on PivotTable axes for this pivot hierarchy. MUST be greater than or equal to 0. + +If **sxaxis.sxaxisPage** is 1 or **sxaxis.sxaxisData** is 1, then the value of this field MUST be 1. + +If **sxaxis.sxaxisPage** is 0, **sxaxis.sxaxisData** is 0, **sxaxis.sxaxisRw** is 0 and **sxaxis.sxaxisCol** is 0, the value of this field MUST be 0. + +If **sxaxis.sxaxisRw** is 1 or **sxaxis.sxaxisCol** is 1, the restrictions on the value of this field vary depending on the value of the **stAll** string, as specified in the following table: + +| stAll | Value of csxvdXl | +|-----------|------------------------------------------| +| Empty | MUST be equal to the value of **cisxvd** | +| Not empty | MUST be equal to **cisxvd** – 1 | + +**N - fDragToRow (1 bit):** A bit that specifies whether this pivot hierarchy can be placed on the [row axis](#Section_3f46e7207706400cba9473cb829f869a) of the PivotTable view. MUST be 0 if **fMeasure** is 1. + +**O - fDragToColumn (1 bit):** A bit that specifies whether this pivot hierarchy can be placed on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) of the PivotTable view. MUST be 0 if **fMeasure** is 1. + +**P - fDragToPage (1 bit):** A bit that specifies whether this pivot hierarchy can be placed on the page axis of the PivotTable view. MUST be 0 if **fMeasure** is 1. + +**Q - fDragToData (1 bit):** A bit that specifies whether this pivot hierarchy can be placed on the data axis of the PivotTable view. + +**R - fDragToHide (1 bit):** A bit that specifies whether this pivot hierarchy can be removed from the PivotTable view. + +**unused4 (11 bits):** Undefined and MUST be ignored. + +**stUnique (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of this pivot hierarchy. The length of the string MUST be greater than zero and less than or equal to 255. + +**stDisplay (variable):** An XLUnicodeString structure that specifies the display name of this pivot hierarchy. The length of the string MUST be greater than zero and less than or equal to 255. + +**stDefault (variable):** An XLUnicodeString structure that specifies the MDX unique name of the default [**member (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) of this pivot hierarchy. The length of the string MUST be less than or equal to 255. + +**stAll (variable):** An XLUnicodeString structure that specifies the unique name of the [**ALL**](#gt_cffb889a-4468-44be-9817-24bbac1adfe3) member (2) of this pivot hierarchy. The length of the string MUST be less than or equal to 255. A length of zero specifies that there is no ALL member (2) of this pivot hierarchy. + +**stDimension (variable):** An XLUnicodeString structure that specifies the unique name of the OLAP dimension (1) to which this pivot hierarchy belongs, unless the length of the string is zero. The length of the string MUST be less than or equal to 255. If **fMeasure** is 1, the length of the string MUST be zero. + +**cisxvd (4 bytes):** An unsigned integer that specifies the number of elements in **rgisxvd**. MUST be zero If **sxaxis.sxaxisRw** is 0 and **sxaxis.sxaxisCol** is 0. + +**rgisxvd (variable):** An array of 4-byte signed integers that specify the pivot fields associated with this pivot hierarchy. Each array element MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | No pivot field is referenced. | +| Greater than or equal to zero | A pivot field index, as specified by pivot fields, that specifies a pivot field that is associated with this pivot hierarchy. The referenced pivot field MUST have an **sxaxis** field equal to the value of the **sxaxis** field of this record. | + +This field is arranged such that the *n*^(th) element in the array is a reference to the Sxvd record that has a related [SXVDTEx](#sxvdtex) record that has a value of *n* for its **isxtl** field. If there is no such SXVDTEx for the *n*^(th) element, the value of the *n*^(th) element MUST be equal to -1. + +**cHiddenMemberSets (4 bytes):** An unsigned integer that specifies the deepest one-based level in the pivot hierarchy that has OLAP members [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) from the PivotTable view. If the value of **cisxvd** is greater than 0, then the value of this field also specifies the number of elements in **rgHiddenMemberSets**. If the value of **fFilterInclusive** is 1, then the value of this field MUST be 0. + +**rgHiddenMemberSets (variable):** An array of [HiddenMemberSet](#hiddenmemberset) structures that specifies which of the OLAP members in the pivot hierarchy are hidden from the PivotTable view through manual filtering at each level of the pivot hierarchy. The index of each member (2) in the array corresponds to a level in the pivot hierarchy, beginning with index 0. MUST exist if and only if **cHiddenMemberSets** is greater than 0 and **cisxvd** is greater than 0. + +### Sxvd + +The **Sxvd** record specifies [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) properties and that specifies the beginning of a collection of records as defined in the [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). This collection of records specifies details for a pivot field. + +[TABLE] + +**sxaxis (2 bytes):** An [SXAxis](#sxaxis) structure that specifies the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) that this pivot field is on. If the **sxaxis.sxaxisData** field equals 1, there MUST be a corresponding [SXDI](#sxdi) record with an **isxvd** field that specifies this Sxvd record. + +**cSub (2 bytes):** An unsigned integer that specifies the number of subtotal functions used for this pivot field. MUST equal the count of subtotal fields of this record whose value is 1. The subtotal fields of this record are **fDefault**, **fSum**, **fCounta**, **fAverage**, **fMax**, **fMin**, **fProduct**, **fCount**, **fStdev**, **fStdevp**, **fVariance**, and **fVariancep**. For more information, see [Subtotalling](#Section_427438d9b8e34a5c8b678f158fbf680f). + +**A - fDefault (1 bit):** A bit that specifies whether the default subtotal [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) is applied. The default subtotal is separately determined for each [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679). If the **fDefault** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one [SXVI](#sxvi) record with the **itmType** field of the SXVI record equal to 1. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------------| +| 0 | The default subtotal function is not applied. | +| 1 | The default subtotal function is applied. | + +**B - fSum (1 bit):** A bit that specifies whether the sum subtotal function is displayed. If the **fDefault** field equals 1, this value MUST be 0. If the **fSum** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 2. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------| +| 0 | The sum subtotal function is not displayed. | +| 1 | The sum subtotal function is displayed. | + +**C - fCounta (1 bit):** A bit that specifies whether the count subtotal function is displayed. If the **fDefault** field equals 1, this value MUST be 0. If the **fCounta** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 3. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------------| +| 0 | The count subtotal function is not displayed. | +| 1 | The count subtotal function is displayed. | + +**D - fAverage (1 bit):** A bit that specifies whether the average subtotal function is displayed. If the **fDefault** field equals 1, this value MUST be 0. If the **fAverage** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 4. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------| +| 0 | The average subtotal function is not displayed. | +| 1 | The average subtotal function is displayed. | + +**E - fMax (1 bit):** A bit that specifies whether the max subtotal function is displayed. If the **fDefault** field equals 1, this value MUST be 0. If the **fMax** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 5. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------| +| 0 | The max subtotal function is not displayed. | +| 1 | The max subtotal function is displayed. | + +**F - fMin (1 bit):** A bit that specifies whether the min subtotal function is displayed. If the **fDefault** field equals 1, this value MUST be 0. If the **fMin** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 6. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------| +| 0 | The min subtotal function is not displayed. | +| 1 | The min subtotal function is displayed. | + +**G - fProduct (1 bit):** A bit that specifies whether the product subtotal function is displayed. If the **fDefault** field is 1, this value MUST be 0. If the **fProduct** field is 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 7. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------| +| 0 | The product subtotal function is not displayed. | +| 1 | The product subtotal function is displayed. | + +**H - fCount (1 bit):** A bit that specifies whether the count numbers subtotal function is displayed. If the **fDefault** field is 1, this value MUST be 0. If the **fCount** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 8. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------------| +| 0 | The count numbers subtotal function is not displayed. | +| 1 | The count numbers subtotal function is displayed. | + +**I - fStdev (1 bit):** A bit that specifies whether the standard deviation subtotal function is displayed. If the **fDefault** field is 1, this value MUST be 0. If the **fStdev** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 9. MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------------------------------| +| 0 | The standard deviation subtotal function is not displayed. | +| 1 | The standard deviation subtotal function is displayed. | + +**J - fStdevp (1 bit):** A bit that specifies whether the standard deviation population subtotal function is displayed. If the **fDefault** field equals 1, this value MUST be 0. If the **fStdevp** field equals 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 10. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The standard deviation population subtotal function is not displayed. | +| 1 | The standard deviation population subtotal function is displayed. | + +**K - fVariance (1 bit):** A bit that specifies whether the variance subtotal function is displayed. If the **fDefault** field is 1, this value MUST be 0. If the **fVariance** field is 1 and the **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 11. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------| +| 0 | The variance subtotal function is not displayed. | +| 1 | The variance subtotal function is displayed. | + +**L - fVariancep (1 bit):** A bit that specifies whether the variance population subtotal function is displayed. If the **fDefault** field is 1, the value MUST be 0. If the **fVariancep** field equals 1 and **sxaxis**.**sxaxisRw** field equals 1 or if the **sxaxis**.**sxaxisCol** field equals 1 or if the **sxaxis**.**sxaxisPage** field equals 1, there MUST be one SXVI record with the **itmType** field of the SXVI record equal to 12. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------------------| +| 0 | The variance population subtotal function is not displayed. | +| 1 | The variance population subtotal function is displayed. | + +**M - reserved (4 bits):** MUST be zero, and MUST be ignored. + +**cItm (2 bytes):** A signed integer that specifies the number of [pivot items](#Section_58891cc5dd9b4293a97831070779524f) for this pivot field. This value MUST match the number of SXVI records following this record and MUST be less than or equal to the following formula: + +32500 + the **cSub** field + +**cchName (2 bytes):** An unsigned integer that specifies the length, in characters, of the **stName** field. If the value is 0xFFFF then **stName** is NULL. The value MUST be 0xFFFF or greater than zero and less than or equal to 255. + +**stName (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the caption of this pivot field. A non-NULL value specifies that this string is used to override the **stFieldName** field in [SXFDB](#sxfdb) record from the associated [cache field](#Section_6497eb794042445780e75959c9f0583c), as specified in pivot fields. The length is specified in **cchName**. This field exists only if the value of **cchName** is not 0xFFFF. If this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) is not an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) and this string is non-NULL, then **stName** MUST be unique within all Sxvd records in this PivotTable view. + +### SXVDEx + +The **SXVDEx** record specifies extended [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) properties. + +[TABLE] + +**A - fShowAllItems (1 bit):** A bit that specifies whether to show all [pivot items](#Section_58891cc5dd9b4293a97831070779524f) for this pivot field, including pivot items that do not currently exist in the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4). The value MUST be 0 for an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f). MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------| +| 0x0 | Specifies that all pivot items are not displayed. | +| 0x1 | Specifies that all pivot items are displayed. | + +**B - fDragToRow (1 bit):** A bit that specifies whether this pivot field can be placed on the [row axis](#Section_3f46e7207706400cba9473cb829f869a). This value MUST be ignored for an OLAP PivotTable view. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that the user is prevented from placing this pivot field on the row axis. | +| 0x1 | Specifies that the user is not prevented from placing this pivot field on the row axis. | + +**C - fDragToColumn (1 bit):** A bit that specifies whether this pivot field can be placed on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). This value MUST be ignored for an OLAP PivotTable view. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that the user is prevented from placing this pivot field on the column axis. | +| 0x1 | Specifies that the user is not prevented from placing this pivot field on the column axis. | + +**D - fDragToPage (1 bit):** A bit that specifies whether this pivot field can be placed on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). This value MUST be ignored for an OLAP PivotTable view. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that the user is prevented from placing this pivot field on the page axis. | +| 0x1 | Specifies that the user is not prevented from placing this pivot field on the page axis. | + +**E - fDragToHide (1 bit):** A bit that specifies whether this pivot field can be removed from the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). This value MUST be ignored for an OLAP PivotTable view. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that the user is prevented from removing this pivot field from the PivotTable view. | +| 0x1 | Specifies that the user is not prevented from removing this pivot field from the PivotTable view. | + +**F - fNotDragToData (1 bit):** A bit that specifies whether this pivot field can be placed on the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). This value MUST be ignored for an OLAP PivotTable view. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Specifies that the user is not prevented from placing this pivot field on the data axis. | +| 0x1 | Specifies that the user is prevented from placing this pivot field on the data axis. | + +**G - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**H - fServerBased (1 bit):** A bit that specifies whether this pivot field is server-based when on the page axis. For more information, see Source Data. A value of 1 specifies that this pivot field is a server-based pivot field. + +MUST be 1 if and only if the value of the **fServerBased** field of the [SXFDB](#sxfdb) record of the associated [cache field](#Section_6497eb794042445780e75959c9f0583c) of this pivot field is 1. + +**I - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**J - fAutoSort (1 bit):** A bit that specifies whether AutoSort will be applied to this pivot field. For more information, see [Pivot Field Sorting](#Section_6a008d4253834e13a1d06d8ee5d93b76). + +**K - fAscendSort (1 bit):** A bit that specifies whether any AutoSort applied to this pivot field will [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880) in ascending order. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------| +| 0x0 | Sort in descending order. | +| 0x1 | Sort in ascending order. | + +**L - fAutoShow (1 bit):** A bit that specifies whether an [**AutoShow**](#gt_42126923-0aed-4547-8761-95a0ce2badde) [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) is applied to this pivot field. For more information, see [Simple Filters](#Section_d662b8d1d1234fc5bac05fd76cdf0ff0). + +**M - fTopAutoShow (1 bit):** A bit that specifies whether any AutoShow filter applied to this pivot field shows the top-ranked or bottom-ranked values. For more information, see Simple Filters. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Any AutoShow filter applied to this pivot field shows the bottom-ranked values. | +| 0x1 | Any AutoShow filter applied to this pivot field shows the top-ranked values. | + +**N - fCalculatedField (1 bit):** A bit that specifies whether this pivot field is a [calculated field](#Section_4594f2ac815740b381142e77ba8efb7d). A value of 1 specifies that this pivot field is a calculated field. + +MUST be 1 if and only if the value of the **fCalculatedField** field of the SXFDB record of the cache field associated with this pivot field is 1. + +**O - fPageBreaksBetweenItems (1 bit):** A bit that specifies whether a [**page break**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871) is inserted after each pivot item when the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) is printed. + +**P - fHideNewItems (1 bit):** A bit that specifies whether new pivot items that appear after a [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) are [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) by default. This value MUST be equal to 0 for a non-OLAP PivotTable view. + +| Value | Meaning | +|-------|----------------------------------------| +| 0x0 | New pivot items are shown by default. | +| 0x1 | New pivot items are hidden by default. | + +**reserved3 (5 bits):** MUST be zero, and MUST be ignored. + +**Q - fOutline (1 bit):** A bit that specifies whether this pivot field is in [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) form. For more information, see [PivotTable layout](#Section_2f81b5b422d546778ec53c5dc1ad80d4). + +**R - fInsertBlankRow (1 bit):** A bit that specifies whether to insert a blank row after each pivot item. + +**S - fSubtotalAtTop (1 bit):** A bit that specifies whether subtotals are displayed at the top of the group when the **fOutline** field is equal to 1. For more information, see PivotTable layout. + +**citmAutoShow (8 bits):** An unsigned integer that specifies the number of pivot items to show when the **fAutoShow** field is equal to 1. The value MUST be greater than or equal to 1 and less than or equal to 255. + +**isxdiAutoSort (2 bytes):** A signed integer that specifies the [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679) that AutoSort uses when the **fAutoSort** field is equal to 1. If the value of the **fAutoSort** field is one, the value MUST be greater than or equal to zero and less than the count of [SXDI](#sxdi) records. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | Specifies that the values of the pivot items themselves are used. | +| Greater than or equal to zero | Specifies a data item index, as specified in Data Items, of the data item that is used. | + +**isxdiAutoShow (2 bytes):** A signed integer that specifies the data item that AutoShow ranks by when the **fAutoShow** field is equal to 1. For more information, see Simple Filters. If the value of the **fAutoShow** field is 1, this value MUST be greater than or equal to zero and less than the count of SXDI records. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | AutoShow is not enabled for this pivot field. | +| Greater than or equal to zero | Specifies a data item index, as specified in Data Items, of the data item that is used. | + +**ifmt (2 bytes):** An [IFmt](#ifmt) structure that specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) of this pivot field. + +**subName (variable):** An optional [SXVDEx_Opt](#sxvdex_opt) structure that specifies the name of the aggregate [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) used to calculate this pivot field's subtotals. SHOULD[\<131\>](#Appendix_A_131) be present. + +### SXVDTEx + +The **SXVDTEx** record specifies [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) extensions to a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5). This record MUST NOT exist if this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) is a non-[OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f). + +The pivot field associated with this record is the pivot field with an index that equals the index of this SXVDTEx record in the collection of SXVDTEx records of this PivotTable view. + +The count of SXVDTEx records MUST equal the count of pivot fields in the OLAP PivotTable view. + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x080F. + +**A - fTensorSort (1 bit):** A bit that specifies whether the [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7) is determined by the OLAP [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0). See [Pivot Field Sorting](#Section_6a008d4253834e13a1d06d8ee5d93b76) for more information. + +**B - fDrilledLevel (1 bit):** A bit that specifies whether all [pivot items](#Section_58891cc5dd9b4293a97831070779524f) in this pivot field are expanded. See [Collapsing](#Section_1c9375b4cc664783821f6b2b49bac169) for more information. + +**C - fItemsDrilledByDefault (1 bit):** A bit that specifies whether this [**attribute hierarchy**](#gt_8f75d668-e8c6-4f42-ba44-d90604d3b9dc) is expanded by default. See Collapsing for more information. + +**D - fMemPropDisplayInReport (1 bit):** A bit that specifies whether this [member property](#Section_e5db3a66677f43db8fb038584797c95f) pivot field is displayed in the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) report. See [row axis](#Section_3f46e7207706400cba9473cb829f869a) or [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) for more information. MUST be 0 if the [PivotCache functionality level](#Section_e0fe44b1caf64739bf8fe51a96cd5ba8) of the [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4) is less than 3. MUST be ignored if this pivot field is not a member property pivot field. + +**E - fMemPropDisplayInTip (1 bit):** A bit that specifies whether this member property pivot field is displayed in a [**ToolTip**](#gt_84d44447-feaf-41a4-bf12-004c0f080fc2). MUST be 0 if the PivotCache functionality level of the associated PivotCache is less than 3. MUST be ignored if this pivot field is not a member property pivot field. + +**F - fMemPropDisplayInCaption (1 bit):** A bit that specifies whether to display member property captions from this pivot field, for a pivot field of the associated OLAP levels and associated [pivot hierarchy](#Section_54818c671590494084e0c3ff8b433c33) as this pivot field, instead of the pivot item captions. The pivot field for which to display captions has an [SXAddl_SXCField12_SXDMemberCaption](#sxaddl_sxcfield12_sxdmembercaption) record. MUST be 0 if the PivotCache functionality level of the associated PivotCache is less than 3. MUST be ignored if this pivot field is not a member property pivot field. + +**reserved (10 bits):** MUST be zero, and MUST be ignored. + +**isxth (2 bytes):** A signed integer that specifies the pivot hierarchy that this pivot field is associated with. See [Association of Pivot Hierarchies and Pivot Fields and Cache Fields](#Section_01a66b9be4a24396b55c28d6207fd28f) for more information. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | This pivot field is not part of a pivot hierarchy. | +| Greater than or equal to zero | This specifies a pivot hierarchy index, as specified in Pivot Hierarchies, that specifies a pivot hierarchy. | + +MUST be greater than or equal to -1 and less than the **csxth** field of the [SXViewEx](#sxviewex) record of the PivotTable view. + +**isxtl (4 bytes):** A signed integer that specifies the zero-based index of the OLAP level associated with the pivot hierarchy. If **isxth** specifies a pivot hierarchy that is not an OLAP [**Hierarchy**](#gt_a07fc05d-cdb0-442c-984a-dd3589b9f682), this value MUST be ignored. + +**csxvi (4 bytes):** A signed integer that specifies the number of items in the array specified by **rgsxvi**. MUST equal the count of pivot items in this pivot field. + +**rgsxvi (variable):** An array of [SXVIFlags](#sxviflags) that specifies additional properties for the pivot items in this pivot field. Each SXVIFlags in the **rgsxvi** array specifies additional properties of the pivot item with a pivot item index equal to the index of the SXVIFlags element in the **rgsxvi** array. + +The number of elements in this array MUST equal **csxvi**. + +### SXVI + +The **SXVI** record specifies information about a [pivot item](#Section_58891cc5dd9b4293a97831070779524f). + +[TABLE] + +**itmType (2 bytes):** A signed integer that specifies the pivot item type. The value MUST be one of the following values: + +| Value | Name | Meaning | +|----|----|----| +| 0x0000 | itmtypeData | A data value | +| 0x0001 | itmtypeDEFAULT | Default subtotal for the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) | +| 0x0002 | itmtypeSUM | Sum of values in the pivot field | +| 0x0003 | itmtypeCOUNTA | Count of values in the pivot field | +| 0x0004 | itmtypeAVERAGE | Average of values in the pivot field | +| 0x0005 | itmtypeMAX | Max of values in the pivot field | +| 0x0006 | itmtypeMIN | Min of values in the pivot field | +| 0x0007 | itmtypePRODUCT | Product of values in the pivot field | +| 0x0008 | itmtypeCOUNT | Count of numbers in the pivot field | +| 0x0009 | itmtypeSTDEV | Statistical standard deviation (estimate) of the pivot field | +| 0x000A | itmtypeSTDEVP | Statistical standard deviation (entire population) of the pivot field | +| 0x000B | itmtypeVAR | Statistical variance (estimate) of the pivot field | +| 0x000C | itmtypeVARP | Statistical variance (entire population) of the pivot field | + +**A - fHidden (1 bit):** A bit that specifies whether this pivot item is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). For more information, see [Manual Filtering](#Section_b0b282651e334c86ad030f5693c1d1e4). + +MUST be zero if **itmType** is not itmtypeData. MUST be zero for [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f). + +**B - fHideDetail (1 bit):** A bit that specifies whether the pivot item detail is collapsed. + +MUST be zero for OLAP PivotTable view. + +**C - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**D - fFormula (1 bit):** A bit that specifies whether this pivot item is a [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b). + +This field MUST be zero if any of the following apply: + +- **itmType** is not zero. + +- This item is in an OLAP PivotTable view. + +- The **sxaxisPage** field of **sxaxis** in the [Sxvd](#sxvd) record of the pivot field equals 1 (the associated Sxvd is the last Sxvd record before this record in the stream). + +- The **fCalculatedField** field in the [SXVDEx](#sxvdex) record of the pivot field equals 1. + +- There is not an associated [SXFDB](#sxfdb) record in the [associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4). + +- The **fRangeGroup** field of the SXFDB record, of the associated [cache field](#Section_6497eb794042445780e75959c9f0583c) of the pivot field, equals 1. + +- The **fCalculatedField** field of the SXFDB record, of the associated cache field of the pivot field, equals 1. + +**E - fMissing (1 bit):** A bit that specifies if this pivot item does not exist in the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + +MUST be zero if **itmType** is not zero. MUST be zero for OLAP PivotTable view. + +**reserved2 (11 bits):** MUST be zero, and MUST be ignored. + +**iCache (2 bytes):** A signed integer that specifies a reference to a [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | No cache item is referenced. | +| 0+ | A cache item index in the cache field associated with the pivot field, as specified by Cache Items. | + +If **itmType** is not zero, a reference to a cache item is not specified and this value MUST be -1. Otherwise, this value MUST be greater than or equal to 0. + +**cchName (2 bytes):** An unsigned integer that specifies the length of the **stName** string. If the value is 0xFFFF then **stName** is NULL. Otherwise, the value MUST be less than or equal to 254. + +**stName (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of this pivot item. If not NULL, this is used as the caption of the pivot item instead of the value in the cache item specified by **iCache**. The length of this field is specified in **cchName**. This field exists only if **cchName** is not 0xFFFF. If this is in a non-OLAP PivotTable view and this string is not NULL, it MUST be unique within all SXVI records in associated with the pivot field. + +### SxView + +The **SxView** record specifies [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) information and that specifies the beginning of a collection of records as defined by the [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection specifies the remainder of the PivotTable view. + +[TABLE] + +**ref (8 bytes):** A [Ref8U](#ref8u) structure that specifies the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) report body. For more information, see [Location and Body](#Section_7f7d9d76a55041d9ae9f0d8539cc09f8). + +**rwFirstHead (2 bytes):** An [RwU](#rwu) structure that specifies the first row of the [row area](#Section_5594c95e6819461e80706f4b4fdfa091). MUST be 1 if none of the axes are assigned in this PivotTable view. Otherwise, the value MUST be greater than or equal to **ref.rwFirst**. + +**rwFirstData (2 bytes):** An RwU structure that specifies the first row of the [data area](#Section_237a24905c614931923f7ee856f23c72). MUST be 1 if none of the axes are assigned in this PivotTable view. Otherwise, it MUST be equal to the value as specified by the following formula: + +**rwFirstData** = **rwFirstHead** + **cDimCol** + +**colFirstData (2 bytes):** A [ColU](#colu) structure that specifies the first column of the data area. It MUST be 1 if none of the axes are assigned in this PivotTable view. Otherwise, the value MUST be greater than or equal to **ref.colFirst,** and if the value of **cDimCol** or **cDimData** is not zero, it MUST be less than or equal to **ref.colLast**. + +**iCache (2 bytes):** A signed integer that specifies the zero-based index of an [SXStreamID](#sxstreamid) record in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). See [Associated PivotCache](#Section_6f60301b107346d3b7ad0041566272a4) for more information. MUST be greater than or equal to zero and less than the number of SXStreamID records in the Globals Substream. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**sxaxis4Data (2 bytes):** An [SXAxis](#sxaxis) structure that specifies the default axis for the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592). Either the **sxaxis4Data.sxaxisRw** field MUST be 1 or the **sxaxis4Data.sxaxisCol** field MUST be 1. The **sxaxis4Data.sxaxisPage** field MUST be 0 and the **sxaxis4Data.sxaxisData** field MUST be 0. + +**ipos4Data (2 bytes):** A signed integer that specifies the row or column position for the data field in the PivotTable view. The **sxaxis4Data** field specifies whether this is a row or column position. MUST be greater than or equal to -1 and less than or equal to 0x7FFF. A value of -1 specifies the default position. + +**cDim (2 bytes):** A signed integer that specifies the number of [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5) in the PivotTable view. MUST equal the number of [Sxvd](#sxvd) records following this record. MUST equal the number of fields in the associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) specified by **iCache**. + +**cDimRw (2 bytes):** An unsigned integer that specifies the number of fields on the row axis of the PivotTable view. MUST be less than or equal to 0x7FFF. MUST equal the number of array elements in the [SxIvd](#sxivd) record in this PivotTable view that contain row items. + +**cDimCol (2 bytes):** An unsigned integer that specifies the number of fields on the column axis of the PivotTable view. MUST be less than or equal to 0x7FFF. MUST equal the number of array elements in the SxIvd record in this PivotTable view that contain column items. + +**cDimPg (2 bytes):** An unsigned integer that specifies the number of page fields in the PivotTable view. MUST be less than or equal to 0x7FFF. MUST equal the number of array elements in the [SXPI](#sxpi) record in this PivotTable view. + +**cDimData (2 bytes):** A signed integer that specifies the number of data fields in the PivotTable view. MUST be greater than or equal to zero and less than or equal to 0x7FFF. MUST equal the number of [SXDI](#sxdi) records in this PivotTable view. + +**cRw (2 bytes):** An unsigned integer that specifies the number of [pivot lines](#Section_76610990666f492791b6d2280f607464) in the row area of the PivotTable view. MUST be less than or equal to 0x7FFF. MUST equal the number of array elements in the first [SXLI](#sxli) record in this PivotTable view. + +**cCol (2 bytes):** An unsigned integer that specifies the number of pivot lines in the [column area](#Section_03aced8c25864e83982a1e3551a563d6) of the PivotTable view. MUST equal the number of array elements in the second SXLI record in this PivotTable view. + +**A - fRwGrand (1 bit):** A bit that specifies whether the PivotTable contains grand totals for rows. MUST be 0 if none of the axes have been assigned in this PivotTable view. + +**B - fColGrand (1 bit):** A bit that specifies whether the PivotTable contains grand totals for columns. MUST be 1 if none of the axes are assigned in this PivotTable view. + +**C - unused1 (1 bit):** Undefined and MUST be ignored. + +**D - fAutoFormat (1 bit):** A bit that specifies whether the PivotTable has [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f) applied. + +**E - fAtrNum (1 bit):** A bit that specifies whether the PivotTable has number AutoFormat applied. + +**F - fAtrFnt (1 bit):** A bit that specifies whether the PivotTable has [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) AutoFormat applied. + +**G - fAtrAlc (1 bit):** A bit that specifies whether the PivotTable has alignment AutoFormat applied. + +**H - fAtrBdr (1 bit):** A bit that specifies whether the PivotTable has [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) AutoFormat applied. + +**I - fAtrPat (1 bit):** A bit that specifies whether the PivotTable has pattern AutoFormat applied. + +**J - fAtrProc (1 bit):** A bit that specifies whether the PivotTable has width/height AutoFormat applied. + +**unused2 (6 bits):** Undefined and MUST be ignored. + +**itblAutoFmt (2 bytes):** An [AutoFmt8](#autofmt8) structure that specifies the PivotTable AutoFormat. If the value of **itblAutoFmt** in the associated [SXViewEx9](#sxviewex9) record is not 1, this field is overridden by the value of **itblAutoFmt** in the associated SXViewEx9. + +**cchTableName (2 bytes):** An unsigned integer that specifies the length, in characters, of **stTable**. MUST be greater than or equal to zero and less than or equal to 0x00FF. + +**cchDataName (2 bytes):** An unsigned integer that specifies the length, in characters of **stData**. MUST be greater than zero and less than or equal to 0x00FE. + +**stTable (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of the PivotTable. The length of this field is specified by **cchTableName**. + +**stData (variable):** An XLUnicodeStringNoCch structure that specifies the name of the data field. The length of this field is specified by **cchDataName**. + +### SXViewEx + +The **SXViewEx** record specifies the beginning of a collection of records as specified in the [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies details about an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f). + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The value of the **frtHeaderOld.rt** field MUST be 0x80C. + +**csxth (4 bytes):** A signed integer that specifies the number of [SXTH](#sxth) records following this record. MUST be greater than or equal to 1. + +**csxpi (4 bytes):** A signed integer that specifies the number of [SXPIEx](#sxpiex) records following the SXTH records. MUST be greater than or equal to zero. + +**csxvdtex (4 bytes):** A signed integer that specifies the number of [SXVDTEx](#sxvdtex) records following the SXPIEx records. MUST be greater than or equal to zero. + +**cbFuture (4 bytes):** An unsigned integer that specifies the count of bytes in **rgbFuture**. MUST be greater than or equal to zero and less than or equal to 1024. MUST be equal to the byte count of **rgbFuture**. + +**rgbFuture (variable):** Information from future versions. The byte count MUST equal **cbFuture**. + +### SXViewEx9 + +The **SXViewEx9** record specifies extensions to the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +[TABLE] + +**rt (2 bytes):** An unsigned integer that specifies the record type identifier. The value MUST be 0x0810. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - fFrtAlert (1 bit):** A bit that specifies whether features of this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) are not supported in earlier versions of the [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517). + +An application can alert the user of possible problems when saving as an earlier version of the BIFF. + +**reserved2 (14 bits):** MUST be zero, and MUST be ignored. + +**reserved3 (4 bytes):** MUST be zero, and MUST be ignored. + +**C - reserved4 (1 bit):** MUST be zero, and MUST be ignored. + +**D - fPrintTitles (1 bit):** A bit that specifies whether the print titles for the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) are set based on the PivotTable report. The row print titles are set to the pivot item captions on the column axis and the column print titles are set to the pivot item captions on the row axis. + +**E - fLineMode (1 bit):** A bit that specifies whether any [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) is in outline mode. See [Subtotalling](#Section_427438d9b8e34a5c8b678f158fbf680f) for more information. + +**F - reserved5 (2 bits):** MUST be zero, and MUST be ignored. + +**G - fRepeatItemsOnEachPrintedPage (1 bit):** A bit that specifies whether [pivot item](#Section_58891cc5dd9b4293a97831070779524f) captions on the [row axis](#Section_3f46e7207706400cba9473cb829f869a) are repeated on each printed page for pivot fields in tabular form. + +**reserved6 (26 bits):** MUST be zero, and MUST be ignored. + +**itblAutoFmt (2 bytes):** An [AutoFmt8](#autofmt8) structure that specifies the PivotTable [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f). If the value of this field is not 1, this field overrides the **itblAutoFmt** field in the previous [SxView](#sxview) record. + +**chGrand (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies a user-entered caption to display for grand totals when the PivotTable is recalculated. The length MUST be less than or equal to 255 characters. + +### SXViewLink + +The **SXViewLink** record specifies the name of the source [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) associated with a [Pivot Chart](#Section_bed5fbd356f54997bb54b49f04e734b7). + +[TABLE] + +**rt (2 bytes):** An unsigned integer. MUST be 0x0858. + +**unused (2 bytes):** Undefined, and MUST be ignored. + +**reserved (2 bytes):** MUST be zero and MUST be ignored. + +**cch (1 byte):** An unsigned integer that specifies the count of characters of the **stPivotTable** field. + +**stPivotTable (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) non-null-terminated, case-sensitive [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string that specifies the name of the PivotTable view associated with the Pivot Chart. The size of this field in bytes MUST be **cch**. + +### SXVS + +The **SXVS** record specifies the type of [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) used for a [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). This record is followed by a sequence of records that specify additional information about the source data. + +[TABLE] + +**sxvs (2 bytes):** An unsigned integer that specifies the type of source data used for the PivotCache. The types of records that follow this record are dictated by the value of this field. MUST be a value from the following table: + +| **Name** | **Value** | **Meaning** | +|----|----|----| +| SHEET | 0x0001 | Specifies that the source data is a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). This record MUST be followed by a [DConRef](#dconref) record that specifies a simple range, or a [DConName](#dconname) record that specifies a [**named range**](#gt_042582ea-4050-4e5c-a2df-ae39706a19b6), or a [DConBin](#dconbin) record that specifies a built-in named range. | +| EXTERNAL | 0x0002 | Specifies that external source data is used. This record MUST be followed by a sequence of records beginning with a [DbQuery](#dbquery) record that specifies connection and query information that is used to retrieve [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e). | +| CONSOLIDATION | 0x0004 | Specifies that [multiple consolidation ranges](#Section_2535c296b76b4728b52c72fbabaf3047) are used as the source data. This record MUST be followed by a sequence of records beginning with an [SXTbl](#sxtbl) record that specifies information about the multiple consolidation ranges. | +| SCENARIO | 0x0010 | The source data is populated from a temporary internal structure. In this case there is no additional source data information because the raw data does not exist as a permanent structure and the logic to produce it is application-dependent. | + +### Sync + +When multiple windows are used to view a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) with synchronous scrolling enabled, the **Sync** record specifies the coordinates of the top-left visible [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) of all windows. + +[TABLE] + +**rw (2 bytes):** A [RwU](#rwu) structure that specifies the row for the top-left [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) cell of all windows. + +**col (2 bytes):** A [ColU](#colu) structure that specifies the column for the top-left visible cell of all windows. + +### Table + +The **Table** record specifies a [**data table (1)**](#gt_9e13d7ee-50d6-40ae-8789-29ecafe24bd4). This record is preceded by a single [Formula](#formula) record that defines the first [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the data table (1). Other Formula records that represent the rest of cells in the data table (1) follow later in the file, not necessarily in a contiguous sequence. Formula records that define the cells in the data table (1) MUST have the cell field that is within the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) specified in the **ref** field of this record and MUST have their formula begin with [PtgTbl](#ptgtbl). Also, each cell specified in the **ref** field MUST have a Formula that is part of this table. + +[TABLE] + +**ref (6 bytes):** A [Ref](#ref) structure that specifies the range of the data table (1). The value of **ref.rwFirst.rw** MUST be greater than or equal to 1. The value of **ref.colFirst.col** MUST be greater than or equal to 1. + +**A - fAlwaysCalc (1 bit):** A bit that specifies whether this data table (1) is recalculated as part of the next recalculation. + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fRw (1 bit):** A bit that specifies whether the [**input cell**](#gt_55b5bfbd-5f13-48d0-92e4-68d0c499b318) of a [**one-variable data table**](#gt_52eadba5-3428-4b54-bb99-e26cbd17c924) is a row input cell or a column input cell. If the value is 1, the input cell for a one-variable data table is a row input cell. + +If the value of the **fTbl2** field is 1, the value of **fRw** is undefined and MUST be ignored. + +**D - fTbl2 (1 bit):** A bit that specifies whether the data table (1) is a [**two-variable data table**](#gt_f699cf35-15b3-4efe-af97-391bda3016b0) or a one-variable data table. If the value is 1, the data table (1) is a two-variable data table. + +**E - fDeleted1 (1 bit):** A bit that specifies whether the cell referenced in the input cell specified by the **rwInpRw** and **colInpRw** fields is deleted. + +**F - fDeleted2 (1 bit):** A bit that specifies whether the cell referenced in the input cell specified by the **rwInpCol** and **colInpCol** fields is deleted. + +**reserved2 (10 bits):** MUST be zero, and MUST be ignored. + +**rwInpRw (2 bytes):** A [RwU](#rwu) structure that specifies either the row of a row input cell or the row of a column input cell. If the value of the **fTbl2** field is 0 and the value of the **fRw** field is 0, the value of **rwInpRw** specifies the row of a column input cell; for any other combination of the **fTbl2** and **fRw** fields, **rwInpRw** specifies the row of a row input cell. If the value of **fDeleted** field is 1, the value of **rwInpRw** MUST be 65535. + +If **fTbl2** is 1, the following statement (1) holds. + +If **fTbl2** is 0, exactly one of these statements holds: + +- **rwInpRw** and **colInpRw** MUST specify a cell outside the bounds specified by **ref.rwFirst** – 1, **ref.rwLast**, **ref.colFirst** – 1, and **ref.colLast**. + +- **rwInpRw** and **colInpRw** MUST be equal to **ref.rwFirst** -1 and **ref.colFirst** – 1, respectively. + +**colInpRw (2 bytes):** A [Col_NegativeOne](#col_negativeone) structure that specifies either the column of a row input cell or the column of a column input cell. If the value of the **fTbl2** field is 0 and the value of **fRw** field is 0, the value of **colInpRw** specifies the column of the column input cell; for any other combination of the **fTbl2** and **fRw** fields, **colInpRw** specifies the column of a row input cell. If the value of the **fDeleted** field is 1, the value of **colInpRw** MUST be -1. If the value of the **fDeleted** field is 0, the value of **colInpRw** MUST be greater than or equal to 0. + +**rwInpCol (2 bytes):** A RwU structure that specifies the row of the column input cell. The restrictions on the value of **rwInpCol** are dictated by the value of the **fTbl2** field and the value of the **fDeleted2** field, as specified in the following table: + +| fTbl2 | fDeleted2 | rwInpCol | +|----|----|----| +| 1 | 1 | The value MUST be 65535. | +| 1 | 0 | If the **colInpCol** is a value between **ref.colFirst** – 1 and **ref.colLast** inclusive, **rwInpCol** MUST NOT be a value between **ref.rwFirst** – 1 and **ref.rwLast** inclusive. | +| 0 | 1 or 0 | Undefined and MUST be ignored. | + +**colInpCol (2 bytes):** A Col_NegativeOne structure that specifies the column of the column input cell. The restrictions on the value of **colInpCol** are dictated by the value of the **fTbl2** field and the value of the **fDeleted2** field, as specified in the following table: + +[TABLE] + +### TableStyle + +The **TableStyle** record specifies a user-defined [table style](#Section_4ac7212b4aa74ece962526c58224ae80) and the beginning of a collection of [TableStyleElement](#tablestyleelement) records as specified by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of TableStyleElement records specifies the properties of the table style. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x088F. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - fIsPivot (1 bit):** A bit that specifies whether the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) can be applied to [PivotTable views](#Section_09410dfbaac84a719ecf177ffba12c37). + +**C - fIsTable (1 bit):** A bit that specifies whether the style can be applied to [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +**reserved2 (13 bits):** MUST be zero, and MUST be ignored. + +**ctse (4 bytes):** An unsigned integer that specifies the count of TableStyleElement records to follow this record. MUST be less than or equal to 28. + +**cchName (2 bytes):** An unsigned integer that specifies the count of characters in the **rgchName** field. This value MUST be less than or equal to 255 and greater than or equal to 1. + +**rgchName (variable):** An array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters whose length is specified by **cchName** that specifies the style name. + +### TableStyleElement + +The **TableStyleElement** record specifies formatting for one element of a [table style](#Section_4ac7212b4aa74ece962526c58224ae80). Each table style element specifies the formatting to apply to a particular area of a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) or [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) when the table style is applied. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x0890. + +**tseType (4 bytes):** An unsigned integer that specifies the area of the table or [PivotTable view](#Section_a5f57198f2af40b2ba07e4b1836d73f3)to which the formatting is applied. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00000000 | Whole table. If this table style is applied to a PivotTable view, this formatting type also applies to page field captions and page item captions. | +| 0x00000001 | [**Header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38). If this table style is applied to a PivotTable view, this formatting type applies to the collection of rows above the [**data region**](#gt_6abb146e-d02e-45aa-a034-b25b23b0dd48). See *S* in the PivotTable Style Diagram. | +| 0x00000002 | [**Total row**](#gt_95e9bcf4-d644-4e96-9070-dbc80b4d1b28). If this table style is applied to a PivotTable view, this formatting type applies to the [**grand total**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7) row. See *N* in the PivotTable Style Diagram. | +| 0x00000003 | First column. If this table style is applied to a PivotTable view, this formatting type applies to the row label area, which can span multiple columns. See *R* in the PivotTable Style Diagram. | +| 0x00000004 | Last column. If this table style is applied to a PivotTable view, this formatting type applies to the grand total column. See *A* in the PivotTable Style Diagram. | +| 0x00000005 | Row [**stripe band**](#gt_8c31265f-bec6-4a86-90cf-6139819a34d1) 1 | +| 0x00000006 | Row stripe band 2 | +| 0x00000007 | Column stripe band 1 | +| 0x00000008 | Column stripe band 2 | +| 0x00000009 | First [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) of Header row. If this table style is applied to a PivotTable view, this formatting type applies to cells contained in area intersected by the header row and first column. | +| 0x0000000A | Last cell of header row. MUST be ignored if this table style is applied to a PivotTable view. | +| 0x0000000B | First cell of Total row. MUST be ignored if this table style is applied to a PivotTable view. | +| 0x0000000C | Last cell of Total row. MUST be ignored if this table style is applied to a PivotTable view. | +| 0x0000000D | Outermost [**subtotal columns**](#gt_1916aca3-9be3-4739-b439-b4c77e8dc40c) in a PivotTable view, specified by the columns displaying subtotals for the first [Sxvd](#sxvd) record in the [PIVOTVD](#worksheet-substream) collection where the **sxaxis** field of the Sxvd record specifies the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). See *B* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x0000000E | Alternating even subtotal columns in a PivotTable view, specified by the columns displaying subtotals for Sxvd records for which the zero-based index in the PIVOTVD collection is an odd number, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the column axis. See *C* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x0000000F | Alternating odd subtotal columns in a PivotTable view, specified by the columns displaying subtotals for Sxvd records for which the zero-based index in the PIVOTVD collection is an even number greater than zero, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the column axis. See *D* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000010 | Outermost subtotal rows in a PivotTable view, specified by the rows displaying subtotals for the first Sxvd record in the PIVOTVD collection where the **sxaxis** field of the Sxvd record specifies the [row axis](#Section_3f46e7207706400cba9473cb829f869a). See *M* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000011 | Alternating even subtotal rows in a PivotTable view, specified by the rows displaying subtotals for Sxvd records for which the zero-based index in the PIVOTVD collection is an odd number, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the row axis. See *K* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000012 | Alternating odd subtotal rows in a PivotTable view, specified by the rows displaying subtotals for Sxvd records for which the zero-based index in the PIVOTVD collection is an even number greater than zero, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the row axis. See *J* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000013 | Empty rows after each subtotal row. See *L* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000014 | Outermost column subheadings in a PivotTable view, specified by the columns displaying [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) captions for the first Sxvd record in the PIVOTVD collection where the **sxaxis** field of the Sxvd record specifies the column axis. See *O* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000015 | Alternating even column subheadings in a PivotTable view, specified by the column columns displaying pivot field captions for Sxvd records for which the zero-based index in the PIVOTVD collection is an odd number, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the column axis. See *P* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000016 | Alternating odd column subheadings in a PivotTable view, specified by the columns displaying pivot field captions for Sxvd records for which the zero-based index in the PIVOTVD collection is an even number greater than zero, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the column axis. See *Q* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000017 | Outermost row subheadings in a PivotTable view, specified by the rows displaying pivot field captions for the first Sxvd record in the PIVOTVD collection where the **sxaxis** field of the Sxvd record specifies the row axis. See *G* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000018 | Alternating even row subheadings in a PivotTable view, specified by the rows displaying pivot field captions for Sxvd records for which the zero-based index in the PIVOTVD collection is an odd number, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the row axis. See *H* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x00000019 | Alternating odd row subheadings in a PivotTable view, specified by the rows displaying pivot field captions for Sxvd records for which the zero-based index in the PIVOTVD collection is an even number greater than zero, omitting Sxvd records where the **sxaxis** field of the Sxvd record does not specify the row axis. See *I* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x0000001A | Page field captions in a PivotTable view, specified by the cells displaying pivot field captions for the Sxvd records in the PIVOTVD collection where the **sxaxis** field of the Sxvd record specifies the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). See *F* in the PivotTable Style Diagram. Used only for PivotTables. | +| 0x0000001B | Page item captions in a PivotTable view, specified by the cells displaying [pivot item](#Section_58891cc5dd9b4293a97831070779524f) captions for the Sxvd records in the PIVOTVD collection where the **sxaxis** field of the Sxvd record specifies the page axis. See *E* in the PivotTable Style Diagram. Used only for PivotTables. | + +![PivotTable-style diagram](media/image65.bin "PivotTable-style diagram") + +Figure 18: PivotTable-style diagram + +**size (4 bytes):** An unsigned integer that specifies the number of rows or columns to include in a single stripe band. MUST be ignored when the value of **tseType** does not equal 0x00000005, 0x00000006, 0x00000007, or 0x00000008. MUST be greater than or equal to 1 and less than or equal to 9. + +**index (4 bytes):** A [DXFId](#dxfid) structure that specifies the [DXF](#dxf) record that contains the [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6) properties for this element. + +### TableStyles + +The **TableStyles** record specifies the default [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) and [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) [table styles](#Section_4ac7212b4aa74ece962526c58224ae80) and specifies the beginning of a collection of [TableStyle](#tablestyle) records as defined by the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of TableStyle records specifies user-defined table styles. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x088E. + +**cts (4 bytes):** An unsigned integer that specifies the total number of table styles in this document. This is the sum of the standard built-in table styles and all of the custom table styles. This value MUST be greater than or equal to 144 (the number of built-in table styles). + +**cchDefTableStyle (2 bytes):** An unsigned integer that specifies the count of characters in the **rgchDefTableStyle** field. This value MUST be less than or equal to 255. + +**cchDefPivotStyle (2 bytes):** An unsigned integer that specifies the count of characters in the **rgchDefPivotStyle** field. This value MUST be less than or equal to 255. + +**rgchDefTableStyle (variable):** An array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters whose length is specified by **cchDefTableStyle** that specifies the name of the default table style. + +**rgchDefPivotStyle (variable):** An array of Unicode characters whose length is specified by **cchDefPivotStyle** that specifies the name of the default PivotTable [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633). + +### Template + +The **Template** record is an empty record that specifies whether the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is a [**template**](#gt_159ca22f-c24d-4c6d-b08a-3d4c4c923953). If this record is present, the workbook is a template. + +### Text + +The **Text** record specifies the properties of an [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a) and specifies the beginning of a collection of records as defined by the [chart sheet](#Section_732ff614d939416bb7c76d983471ff11) substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). This collection of records specifies an attached label. + +The **fShowKey**, **fShowValue**, **fShowLabelAndPerc**, **fShowPercent**, **fShowBubbleSizes**, and **fShowLabel** fields MUST equal 0 and MUST be ignored if the current attached label does not contain an [ObjectLink](#objectlink) record that satisfies the following conditions: + +- The **wLinkObj** field of the ObjectLink record equals 0x0004. + +- The **wLinkVar1** field of the ObjectLink record references a [series](#Section_527ce4dfc9f84e50a314d4b07519593c). + +[TABLE] + +**at (1 byte):** An unsigned integer that specifies the [**horizontal alignment**](#gt_f0e60ca8-51d5-4553-9126-3d89a4d08f90) of the text. MUST be a value from the following table: + +| Value | Alignment | +|----|----| +| 0x01 | Left-alignment if **iReadingOrder** specifies [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067) [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361); otherwise, right-alignment | +| 0x02 | Center-alignment | +| 0x03 | Right-alignment if **iReadingOrder** specifies left-to-right reading order; otherwise, left-alignment | +| 0x04 | Justify-alignment | +| 0x07 | [**Distributed alignment**](#gt_dae18ea5-2a98-4e10-9570-7f4ac695c6b8) | + +**vat (1 byte):** An unsigned integer that specifies the [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878) of the text. MUST be a value from the following table: + +| Value | Alignment | +|-------|-----------------------| +| 0x01 | Top-alignment | +| 0x02 | Center-alignment | +| 0x03 | Bottom-alignment | +| 0x04 | Justify-alignment | +| 0x07 | Distributed alignment | + +**wBkgMode (2 bytes):** An unsigned integer that specifies the display mode of the background of the text. MUST be a value from the following table: + +| Value | Background Mode | +|--------|------------------------| +| 0x0001 | Transparent background | +| 0x0002 | Opaque background | + +**rgbText (4 bytes):** A [LongRGB](#longrgb) structure that specifies the color of the text. + +**x (4 bytes):** A signed integer that specifies the horizontal position of the text, relative to the upper-left of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)) in [SPRC](#Section_d5fc728e68de4972905a975bcef8c82d). This value MUST be ignored when this record is preceded by a [DefaultText](#defaulttext) record or when it is followed by a [Pos](#pos) record; otherwise MUST be greater than or equal to 0 and less than or equal to 32767. SHOULD[\<132\>](#Appendix_A_132) be less than or equal to 4000. + +**y (4 bytes):** A signed integer that specifies the vertical position of the text, relative to the upper-left of the chart area (section 2.2.3.17) in SPRC. This value MUST be ignored when this record is preceded by a DefaultText record or when it is followed by a Pos record; otherwise MUST be greater than or equal to 0 and less than or equal to 32767. SHOULD[\<133\>](#Appendix_A_133) be less than or equal to 4000. + +**dx (4 bytes):** A signed integer that specifies the horizontal size of the text, relative to the chart area (section 2.2.3.17) in SPRC. This value MUST be ignored when this record is followed by a Pos record; otherwise MUST be greater than or equal to 0 and less than or equal to 32767. SHOULD[\<134\>](#Appendix_A_134) be less than or equal to 4000. + +**dy (4 bytes):** A signed integer that specifies the vertical size of the text, relative to the chart area (section 2.2.3.17) in SPRC. This value MUST be ignored when this record is followed by a Pos record; otherwise MUST be greater than or equal to 0 and less than or equal to 32767. SHOULD[\<135\>](#Appendix_A_135) be less than or equal to 4000. + +**A - fAutoColor (1 bit):** A bit that specifies whether the foreground text color is determined automatically. + +**B - fShowKey (1 bit):** A bit that specifies whether the text is attached to a [**legend key**](#gt_6981bc96-6d51-425c-9550-63c5b8b08e54). + +**C - fShowValue (1 bit):** A bit that specifies whether the value, or the vertical value on bubble or scatter [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5), is displayed in the [data label](#Section_cac7f43a3af142f58ff2814c2870427f). + +If the current attached label contains a [DataLabExtContents](#datalabextcontents) record and the **fPercent** field of the DataLabExtContents record equals 0, this field MUST equal the **fValue** field of the DataLabExtContents record. + +If the current attached label does not contain a DataLabExtContents record and **fShowLabelAndPerc** equals 1, this field MUST equal 0. + +This field MUST equal 0 if the current attached label does not contain a DataLabExtContents record and one or more of the following conditions are satisfied: + +- The **fShowLabelAndPerc** field equals 1. + +- The **fShowPercent** field equals 1. + +**D - unused1 (1 bit):** Undefined and MUST be ignored. + +**E - fAutoText (1 bit):** A bit that specifies whether the text value of this text field is automatically generated and unchanged. + +**F - fGenerated (1 bit):** A bit that specifies whether the properties of this text field are automatically generated and unchanged. + +**G - fDeleted (1 bit):** A bit that specifies whether this data label was deleted by the user. + +**H - fAutoMode (1 bit):** A bit that specifies whether the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) is determined automatically. + +**I - unused2 (3 bits):** Undefined and MUST be ignored. + +**J - fShowLabelAndPerc (1 bit):** A bit that specifies whether the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) name and the value, represented as a percentage of the sum of the values of the series the data label is associated with, are displayed in the data label. + +MUST equal 0 if the chart group type of the corresponding chart group, series, or [data point](#Section_9c986ad250d44fa1a157063ac5c971a0), is not a bar of pie, doughnut, pie, or pie of pie chart group. + +This field MUST equal 1 if the current attached label contains a DataLabExtContents record and both of the following conditions are satisfied: + +- The **fCatName** and **fPercent** fields of the DataLabExtContents record equal 1. + +- The **fSerName**, **fValue**, and **fBubSizes** fields of the DataLabExtContents record equal 0. + +This field MUST equal 0 if the current attached label contains a DataLabExtContents record and one or more of the following conditions is satisfied: + +- The **fCatName** or **fPercent** fields of the DataLabExtContents record equal 0. + +- The **fSerName**, **fValue**, or **fBubSizes** fields of the DataLabExtContents record equal 1. + +MUST be ignored if **fAutoText** equals 0. + +**K - fShowPercent (1 bit):** A bit that specifies whether the value, represented as a percentage of the sum of the values of the series the data label is associated with, is displayed in the data label. + +MUST equal 0 if the chart group type of the corresponding chart group, series, or data point is not a bar of pie, doughnut, pie, or pie of pie chart group. + +If the current attached label contains a DataLabExtContents record, this field MUST equal the value of the **fPercent** field of the DataLabExtContents record. + +If the current attached label does not contain a DataLabExtContents record and **fShowLabelAndPerc** equals 1, this field MUST equal 1. + +MUST be ignored if **fAutoText** equals 0. + +**L - fShowBubbleSizes (1 bit):** A bit that specifies whether the [**bubble size**](#gt_3a0cf938-5b61-4460-bdbb-3540d84d4180) is displayed in the data label. + +MUST equal 0 if the chart group type of the corresponding chart group, series, or data point is not a bubble chart group. + +If the current attached label contains a DataLabExtContents record and the **fPercent**, **fValue**, and **fCatName** fields of the DataLabExtContents record equal 0, this field MUST equal the **fBubSizes** field of the DataLabExtContents record. + +If the current attached label contains a DataLabExtContents record and the **fPercent, fValue,** or **fCatName** fields of the DataLabExtContents record equal 1, this field MUST equal 0. + +If the current attached label does not contain a DataLabExtContents record and **fShowPercent**, **fShowValue**, or **fShowLabel** equal 1, this field MUST equal 0. + +MUST be ignored if **fAutoText** equals 0. + +**M - fShowLabel (1 bit):** A bit that specifies whether the category, or the horizontal value on bubble or scatter chart groups, is displayed in the data label on a non-area chart group, or the series name is displayed in the data label on an area chart group. + +This field MUST equal the **fCatNameLabel** field of the DataLabExtContents record if the current attached label contains a DataLabExtContents record, the chart group is non-area, and both of the following conditions are satisfied: + +- The **fValue** field of the DataLabExtContents record equals 0. + +- The **fShowLabelAndPerc** field equals 1 or the **fPercent** field equals 0. + +This field MUST equal the **fCatNameLabel** field of the DataLabExtContents record if the current attached label contains a DataLabExtContents record, the chart group is area or filled radar, and the following condition is satisfied: + +- The **fValue** field of the DataLabExtContents record equals 0. + +If the current attached label contains a DataLabExtContents record and the **fValue** field of the DataLabExtContents record equals 1, this field MUST equal 0. + +This field MUST equal 0 if the current attached label does not contain a DataLabExtContents record and one of the following conditions is satisfied: + +- The **fShowValue** field equals 1. + +- The **fShowLabelAndPerc** field equals 0 and the **fShowPercent** field equals 1. + +MUST be ignored if **fAutoText** equals 0. + +**N - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**icvText (2 bytes):** An [Icv](#icv) structure that specifies the color of the text. + +**dlp (4 bits):** An unsigned integer that specifies the data label positioning of the text, relative to the [**graph object**](#gt_f4c97882-38e3-4b03-9f11-09ee6566da21) item the text is attached to. For all data label text fields, MUST be a value from the following table: + +| Data label position | Value | Value for chart group type | +|----|----|----| +| Auto | 0x0 | Pie chart group | +| Right | 0x0 | Line, Bubble, or Scatter chart group | +| Outside | 0x0 | Bar or Column chart group with **fStacked** equal to 0 | +| Center | 0x0 | Bar or Column chart group with **fStacked** equal to 1 | +| Outside End | 0x1 | Bar, Column, or Pie chart group | +| Inside End | 0x2 | Bar, Column, or Pie chart group | +| Center | 0x3 | Bar, Column, Line, Bubble, Scatter, or Pie chart group | +| Inside Base | 0x4 | Bar or Column chart group | +| Above | 0x5 | Line, Bubble, or Scatter chart group | +| Below | 0x6 | Line, Bubble, or Scatter chart group | +| Left | 0x7 | Line, Bubble, or Scatter chart group | +| Right | 0x8 | Line, Bubble, or Scatter chart group | +| Auto | 0x9 | Pie chart group | +| Moved by user | 0xA | All | + +For all non-data label text fields, it MUST be 0x0. + +**unused3 (10 bits):** Undefined and MUST be ignored. + +**O - iReadingOrder (2 bits):** An unsigned integer that specifies the reading order of the text. MUST be a value from the following table: + +| Value | Reading order | +|----|----| +| 0x0 | The reading order is equal to the **iReadingOrder** value of the Text record immediately following the closest preceding [Chart](#chart-2), [DataFormat](#dataformat), [Legend](#legend-1), [Series](#series-1), or [YMult](#ymult) record where **iReadingOrder** is not equal to 0x0. If no such preceding record exists, the DefaultText settings of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) are used. If the DefaultText settings also specify 0x0, the reading order is determined by the application. | +| 0x1 | Left-to-right | +| 0x2 | [**Right-to-left**](#gt_91359688-7863-4e88-b507-f57b3dada5ec) | + +**trot (2 bytes):** An unsigned integer that specifies the text rotation. MUST be a value from the following table: + +| Value | Angle description | +|-----------|-----------------------------------------------------------------| +| 0 to 90 | Text rotated 0 to 90 degrees counter-clockwise | +| 91 to 180 | Text rotated 1 to 90 degrees clockwise (angle is **trot** – 90) | +| 255 | Text top-to-bottom with letters upright | + +### TextPropsStream + +The **TextPropsStream** record specifies additional text properties for the text in the entire [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), text in the current [legend](#Section_1832229b7d1945f488d455e9c07466f0), text in the current [**legend entry**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e), text in the [attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a), or the [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) labels of the current axis. These text properties are a superset of the properties stored in the associated [Text](#text) and [Font](#font) records based on the following table, as specified by [Chart Sheet substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). In each case, the associated Font record is specified by the associated [FontX](#fontx) record.[\<136\>](#Appendix_A_136) + +| Rule containing the TextPropsStream record | Meaning | +|----|----| +| CHARTFORMATS | Specifies additional Rich Text Format properties for the text of the entire chart. The associated Text and FontX records are contained in the attached label that is contained in the first sequence of records that conforms to the DFTTEXT rule in the chart and that is not contained in the [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). | +| LD | Specifies additional Rich Text Format properties for text in the current legend. The associated Text and FontX records are contained in the sequence of records that conforms to the ATTACHEDLABEL rule that is contained in the collection of records conforming to the LD rule. | +| SERIESFORMAT | Specifies additional Rich Text Format properties for the current legend entry. The associated Text and FontX records are contained in the sequence of records that conforms to the ATTACHEDLABEL rule that immediately precedes this record contained in the sequence of records that conforms to the SERIESFORMAT rule. | +| ATTACHEDLABEL | Specifies additional Rich Text Format properties for the text in the attached label. The associated Text and FontX records are contained in the sequence of records that conforms to the ATTACHEDLABEL rule. | +| AXS | Specifies additional Rich Text Format properties for the axis labels of the current axis. The associated Text and FontX records are contained in the sequence of records that conforms to the AXS rule. | + +These text properties are stored in the **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)), as specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, section 21.2.2.216. + +An application can choose to ignore this record without loss of functionality, except for the additional text properties. If an application chooses to implement this record, the application MUST implement the validation [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) specified by the **dwChecksum** field. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x08A5. + +**dwChecksum (4 bytes):** An unsigned integer that specifies the checksum of the text properties attributes related to this record. The algorithm used to calculate the checksum is specified by [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.4.3.2. The checksum MUST be calculated from every property of the [**property stream**](#gt_dbd8bc67-1371-445e-af6a-dfa5eeef670c), taken as an array of bytes as specified by the [TextPropsStreamChecksumData](#textpropsstreamchecksumdata) structure. + +The information required to build the memory stream can be gathered from the Text and Font records associated with this record, as previously specified. + +When reading this record, the checksum is calculated as previously specified and compared to the **dwChecksum** value stored in this record. If the calculated checksum does not match the **dwChecksum** data, the application MUST assume that the **XML stream** (section 2.1.7.22) is out of date, and the data from the associated Text and Font records MUST be used instead of the data specified by the **XML stream** (section 2.1.7.22). + +**cb (4 bytes):** An unsigned integer that specifies the size of the **rgb** field. This field MUST contain the exact length in bytes of the **rgb** field. + +**rgb (variable):** An array of ANSI characters that contains the [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) representation of the text formatting properties, as defined in \[ECMA-376\] Part 1, section 21.2.2.216. The length of this field is specified by the **cb** field. + +### Theme + +The **Theme** record specifies the [**theme**](#gt_8b5eb4c0-949b-47d9-8b63-b9bda81d61b8) in use in the document. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The value of the **frtHeader.rt** field MUST be 2198. + +**dwThemeVersion (4 bytes):** An unsigned integer that specifies the theme type. SHOULD be a value from the following table[\<137\>](#Appendix_A_137): + +| Value | Meaning | +|--------|---------------| +| 0 | Custom theme | +| 124226 | Default theme | + +**rgb (variable):** An optional byte stream that specifies the theme contents (as defined in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, Section 14.2.7). MUST exist if **dwThemeVersion** equals 0. + +### Tick + +The **Tick** record specifies the attributes of the [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) labels, [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb), and [**minor tick marks**](#gt_c2eb605a-6c5a-427e-8608-f16940de82a6) associated with an axis. + +[TABLE] + +**tktMajor (1 byte):** An unsigned integer that specifies the location of major tick marks. MUST be a value from the following table: + +| Value | Tick mark location | +|----|----| +| 0x0000 | None. No major tick marks are drawn on the axis. | +| 0x0001 | Inside. Major tick marks are drawn toward the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). | +| 0x0002 | Outside. Major tick marks are drawn away from the plot area. | +| 0x0003 | Crossing. Major tick marks are drawn evenly on both sides of the axis. | + +**tktMinor (1 byte):** An unsigned integer that specifies the location of minor tick marks. MUST be a value from the following table: + +| Value | Tick mark location | +|----|----| +| 0x0000 | None. No minor tick marks are present on the axis. | +| 0x0001 | Inside. Minor tick marks are drawn toward the plot area. | +| 0x0002 | Outside. Minor tick marks are drawn away from the plot area. | +| 0x0003 | Crossing. Minor tick marks are drawn evenly on both sides of the axis. | + +**tlt (1 byte):** An unsigned integer that specifies the location of axis labels. MUST be a value from the following table: + +| Value | Tick mark label location | +|----|----| +| 0x0000 | None. No axis labels are present on the axis. | +| 0x0001 | Low. Axis labels are drawn to the left of the plot area for a vertical axis or below the plot area for a horizontal axis for all [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) types except radar. Axis labels for radar chart group types will be drawn as if the value was 0x0003. | +| 0x0002 | High. Axis labels are drawn to the right of the plot area for a vertical axis or above the plot area for a horizontal axis for all chart group types except radar. Axis labels for radar chart group types will be drawn as if the value was 0x0003. | +| 0x0003 | Next to Axis. Axis labels are drawn next to the axis. | + +**wBkgMode (1 byte):** An unsigned integer that specifies the display mode of the background of the text of the axis labels. MUST be ignored if the value of **fAutoCo** is 1. MUST be a value from the following table: + +| Value | Background Mode | +|----|----| +| 0x0001 | Transparent background | +| 0x0002 | Opaque background. The background color will match the **rgbBack** field in the associated [AreaFormat](#areaformat) record as specified by the [AXS](#chart-sheet-substream) rule in the Chart Sheet Substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). | + +**rgb (4 bytes):** A [LongRGB](#longrgb) structure that specifies the color of the text for the axis labels. MUST be ignored if **fAutoCo** is 1. + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved3 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved4 (4 bytes):** MUST be zero, and MUST be ignored. + +**A - fAutoCo (1 bit):** A bit that specifies if the foreground text color of the axis labels is determined automatically. + +| Value | Meaning | +|----|----| +| 0 | The text uses the color specified by **rgb**. | +| 1 | The text uses an automatically selected foreground color, based on the computer’s display settings. | + +. + +**B - fAutoMode (1 bit):** A bit that specifies if the background color of the axis label is determined automatically. + +| Value | Meaning | +|----|----| +| 0 | The background color is specified by **wBkgMode**. | +| 1 | The background color is set according to the [DefaultText](#defaulttext) settings of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). | + +. + +**rot (3 bits):** An unsigned integer that specifies text rotation of the axis labels. MUST be a value from the following table: + +| Value | Text Rotation | +|-------|---------------------------------------------------------------------| +| 0x0 | Text is drawn with the rotation specified by the value of **trot**. | +| 0x1 | Text is drawn stacked, top-to-bottom, with the letters upright. | +| 0x2 | Text is drawn rotated at 90 degrees counterclockwise. | +| 0x3 | Text is drawn rotated at 90 degrees clockwise. | + +**C - fAutoRot (1 bit):** A bit that specifies whether the text rotation of the axis label is determined automatically. + +| Value | Meaning | +|----|----| +| 0 | The axis labels do not rotate automatically, and follow the rotation specified by **rot** and **trot**. | +| 1 | The axis labels rotate as the location of the axis changes and the value of the **rot** and **trot** fields MUST be ignored. | + +. + +**unused (8 bits):** Undefined, and MUST be ignored. + +**D - iReadingOrder (2 bits):** An unsigned integer that specifies the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361) of the axis labels. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The reading order is equal to the **iReadingOrder** value of the [Text](#text) record immediately following the closest preceding [Chart](#chart-2), [DataFormat](#dataformat), [Legend](#legend-1), [Series](#series-1) or [YMult](#ymult) record where **iReadingOrder** is not equal to 0x0. If no such preceding record exists, the DefaultText settings of the chart is used. If the DefaultText settings also specify 0x0, the reading order is determined by the Application. | +| 0x1 | [**Left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067) | +| 0x2 | [**Right-to-left**](#gt_91359688-7863-4e88-b507-f57b3dada5ec) | + +**icv (2 bytes):** An [Icv](#icv) that specifies the color of the text. The color MUST be the same as **rgb**. + +**trot (2 bytes):** An unsigned integer that specifies the axis label’s text rotation. MUST be a value from the following table: + +| Value | Meaning | +|-----------|-----------------------------------------------------------------| +| 0 to 90 | Text rotated 0 to 90 degrees counterclockwise | +| 91 to 180 | Text rotated 1 to 90 degrees clockwise (angle is **trot** – 90) | +| 255 | Text top-to-bottom with letters upright | + +### TopMargin + +The **TopMargin** record specifies the top margin of the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**num (8 bytes):** An Xnum (section [2.5.342](#xnum)) structure that specifies the top margin of the current sheet in inches. The value MUST be greater than or equal to 0 and less than or equal to 49. + +### TxO + +The **TxO** record specifies the text in a text box or a [**form**](#gt_c7858bfa-d4d2-48a7-ac9c-d2e90fbe3590) control. This record can be followed by a collection of [Continue](#continue) records that specifies additional feature data to complete this record, as follows: + +- If the value of the **cchText** field is not zero, this record does not fully specify the text. The rest of the data that MUST be specified is the text string and the [**formatting runs**](#gt_10031ac8-2a26-4200-beee-cd8d9420ca96) information. That data is specified in two sets of following Continue records: + +  + +- **Text String Specification**: The first set of Continue records specifies the text string. Each of these Continue records contains an [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies part of the string. The total number of characters in all XLUnicodeStringNoCch MUST be **cchText**. + +- Formatting Run **Specification**: The second set of Continue records specifies formatting runs. These Continue records contain a [TxORuns](#txoruns) structure. If the size of the TxORuns structure is longer than 8,224 bytes, it is split across multiple Continue records. + +[TABLE] + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - hAlignment (3 bits):** An unsigned integer that specifies the [**horizontal alignment**](#gt_f0e60ca8-51d5-4553-9126-3d89a4d08f90). The value MUST be one of the values in the following table: + +| Value | Meaning | +|----|----| +| 1 | Specifies left alignment. | +| 2[\<138\>](#Appendix_A_138) | Specifies centered alignment. | +| 3 | Specifies right alignment. | +| 4 | Specifies justify alignment. | +| 7 | Specifies [**justify distributed**](#gt_11eced66-af2c-4391-8b45-87a60ad41483) alignment. | + +**C - vAlignment (3 bits):** An unsigned integer that specifies the [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878). The value MUST be one of the values in the following table: + +| Value | Meaning | +|-------|-----------------------------------------------------------| +| 1 | Specifies top alignment. | +| 2 | Specifies middle alignment. | +| 3 | Specifies bottom alignment. | +| 4 | Specifies justify alignment[^(\<139\>)](#Appendix_A_139). | +| 7 | Specifies justify distributed alignment. | + +**D - reserved2 (2 bits):** MUST be zero, and MUST be ignored. + +**E - fLockText (1 bit):** A bit that specifies whether the text is [**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81). + +**F - reserved3 (4 bits):** MUST be zero, and MUST be ignored. + +**G - fJustLast (1 bit):** A bit that specifies whether the justify alignment or justify distributed alignment is used on the last line of the text in specific versions of the application[\<140\>](#Appendix_A_140). + +**H - fSecretEdit (1 bit):** A bit that specifies whether this is a text box used for typing passwords and hiding the actual characters being typed by the user. + +**rot (2 bytes):** An unsigned integer that specifies the orientation of the text within the object boundary. The value MUST be one of the values in the following table: + +| Value | Meaning | +|-------|-------------------------------------------------| +| 0 | Specifies no rotation. | +| 1 | Specifies stacked or vertical orientation. | +| 2 | Specifies 90-degree counter-clockwise rotation. | +| 3 | Specifies 90-degree clockwise rotation. | + +**reserved4 (2 bytes):** MUST be zero and MUST be ignored. This field MUST exist if and only if the value of **cmo.ot** in the preceding [Obj](#obj) record is not 0, 5, 7, 11, 12 or 14. + +**reserved5 (4 bytes):** MUST be zero and MUST be ignored. This field MUST exist if and only if the value of **cmo.ot** in the preceding Obj record is not 0, 5, 7, 11, 12 or 14. + +**controlInfo (6 bytes):** An optional [ControlInfo](#controlinfo) structure that specifies the properties for some form controls. The field MUST exist if and only if the value of **cmo.ot** in the preceding Obj record is 0, 5, 7, 11, 12, or 14. + +**cchText (2 bytes):** An unsigned integer that specifies the number of characters in the text string contained in the Continue records immediately following this record. + +**cbRuns (2 bytes):** An unsigned integer that specifies the number of bytes of formatting run information in the TxORuns structure contained in the Continue records following this record. If **cchText** is 0, this value MUST be 0. Otherwise, the value MUST be greater than or equal to 16 and MUST be a multiple of 8. + +**ifntEmpty (2 bytes):** A [FontIndex](#fontindex) structure that specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) when the value of **cchText** is 0. + +**fmla (variable):** An [ObjFmla](#objfmla) structure that specifies the [parsed expression](#Section_a795978bfa7845788e2dc07d78edae0e) of the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) for the text. + +### TxtQry + +The **TxtQry** record specifies information for a [**text query**](#gt_c636d3ce-a120-4acf-91ac-40b3ec79593a) and that specifies the beginning of a collection of [ExtString](#extstring) records, as defined by the [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of ExtString records specifies the [**connection string**](#gt_03a9d0ca-2f10-4f3d-b910-052714a96f7d) for a [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) that retrieves [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e). + +[TABLE] + +**rt (2 bytes):** An unsigned integer that specifies the record type. MUST be 0x0805. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**A - fFile (1 bit):** A bit that specifies that the query was generated from an import text file action. MUST be 1. + +**B - fDelimited (1 bit):** A bit that specifies whether the data is delimited. MUST be a value from the following table: + +| Value | Meaning | +|-------|------------------------------------| +| 0x0 | The data fields are of fixed size. | +| 0x1 | The data is delimited. | + +**C - iCpid (2 bits):** An unsigned integer that specifies the [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38) used for the origin of the file. This value is unused when the value of the **fUseNewiCpid** field is equal to 1 and the value of the **iCpidNew** field is greater than 2. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------| +| 0x0 | Macintosh | +| 0x1 | Windows (ANSI) | +| 0x2 | MS-DOS (PC-8) | + +**D - fPromptForFile (1 bit):** A bit that specifies whether a file name is prompted for on [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060). MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------| +| 0x0 | Saved file location is used during refresh | +| 0x1 | Prompt for file name on refresh | + +**iCpidNew (10 bits):** An unsigned integer that specifies application-specific code page information that can be used to optimize [**text importation**](#gt_82f6fb9c-cd59-46ec-ba3e-e7dacfc5c830) and can be ignored. + +**E - fUseNewiCpid (1 bit):** A bit that specifies whether the **iCpidNew** value is used for specifying the code page instead of the **iCpid** value. + +**unused1 (16 bits):** Undefined and MUST be ignored. + +**rowStartAt (4 bytes):** A signed integer that specifies the row in the source file where the query begins. + +**F - fTab (1 bit):** A bit that specifies whether the tab character is treated as a column delimiter. + +**G - fSpace (1 bit):** A bit that specifies whether the space character is treated as a column delimiter. + +**H - fComma (1 bit):** A bit that specifies whether the comma character is treated as a field delimiter. + +**I - fSemiColon (1 bit):** A bit that specifies whether the semi-colon character is treated as a column delimiter. + +**J - fCustom (1 bit):** A bit that specifies whether the custom character defined in the **chCustom** field is treated as a column delimiter. + +**K - fConsecutive (1 bit):** A bit that specifies whether consecutive delimiters are treated as one delimiter. + +**L - iTextDelm (2 bits):** An unsigned integer that specifies a text delimiter. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------| +| 0x0 | Quotation mark | +| 0x1 | Apostrophe | +| 0x2 | No text delimiter | + +**chCustom (16 bits):** An unsigned integer that specifies the custom delimiter [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) character. This value is used if the **fCustom** value equals 1. + +**unused2 (8 bits):** Undefined and MUST be ignored. + +**itwf (4 bytes):** A signed integer that specifies the number of fields in each row of data. MUST be greater than 0 and less than or equal to 256. + +**chDecimal (1 byte):** An unsigned integer that specifies the decimal separator. MUST be a character from the [**ANSI character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583). + +**chThousSep (1 byte):** An unsigned integer that specifies the thousands separator. MUST be a character from the ANSI character set. + +**rgtxtwf (variable):** An array of [TxtWf](#txtwf) that specifies the text to column fields. The size of the array is determined by the **itwf** value. The array MUST NOT be empty. + +**rgchFile (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the name of the text file that is the source of the query. + +### Uncalced + +The **Uncalced** record specifies that formulas (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) were pending recalculation when the file was saved. + +[TABLE] + +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +### Units + +The **Units** record MUST be zero, and MUST be ignored. + +[TABLE] + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +### UserBView + +The **UserBView** record specifies the general [**custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4) settings that apply to a whole [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). There are accompanying [UserSViewBegin](#usersviewbegin) records that specify individual custom view settings of each [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). The set of this record and the accompanying UserSViewBegin records share the same [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1). + +[TABLE] + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +**tabId (2 bytes):** A [TabId](#tabid) structure that specifies the [**active sheet**](#gt_767d2df7-5efd-40a1-9e58-4b6a597cc389) in this custom view. If the value of the **fInvalidTabId** field is 1, the value of **tabId** is undefined and MUST be ignored. + +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +**guid (16 bytes):** A GUID as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that specifies the identity of the custom view. + +**x (4 bytes):** A signed integer that specifies the horizontal position of the workbook window, in [**pixels**](#gt_fe932605-d3bc-442f-9239-594676bce6ba). + +**y (4 bytes):** A signed integer that specifies the vertical position of the workbook window, in pixels. + +**dx (4 bytes):** A signed integer that specifies the width of the workbook window, in pixels. MUST be greater than or equal to 0. + +**dy (4 bytes):** A signed integer that specifies the height of the workbook window, in pixels. MUST be greater than or equal to 0. + +**wTabRatio (2 bytes):** An unsigned integer that specifies the ratio of the window area used to display [**sheet tabs**](#gt_3b131045-238c-4ce8-9c22-b6aac874c7c5) and the window area used to display the horizontal scroll bar. The value of **wTabRatio** MUST be greater than or equal to zero and less than or equal to 1000. A value of 0 specifies that only the horizontal scroll bar is displayed. A value of 1000 specifies that only sheet tabs are displayed. + +**A - fDspFmlaBar (1 bit):** A bit that specifies whether a [**formula bar**](#gt_1292cd97-b42c-415b-b71f-739f1f842c53) is displayed. + +**B - fDspStatus (1 bit):** A bit that specifies whether a status bar is displayed. + +**C - mdNoteDisp (2 bits):** An unsigned integer that specifies whether to show [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) and visual cue on each cell that has a comment. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------------------| +| 0x0 | Comment and visual cue are off for each cell with a comment. | +| 0x1 | A visual cue that indicates the cell has a comment. | +| 0x2 | Comment and visual cue are on for each cell with a comment. | + +**D - fDspHScroll (1 bit):** A bit that specifies whether a horizontal scroll bar is displayed. + +**E - fDspVScroll (1 bit):** A bit that specifies whether a vertical scroll bar is displayed. + +**F - fBotAdornment (1 bit):** A bit that specifies whether sheet tabs are displayed. + +**G - fZoom (1 bit):** A bit that specifies whether the workbook window is maximized. The value of **fIconic** and the value of **fZoom** MUST NOT both be 1. + +**H - fHideObj (2 bits):** A [**HideObjEnum**](#hideobjenum) structure that specifies how [**ActiveX objects**](#gt_0d95e494-61b2-43bc-8818-51aa162d2018), [**OLE objects**](#gt_cdff9514-a3fb-4897-941d-4e99193a0096), and [**drawing objects**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) appear in the workbook Window. + +**I - fPrintIncl (1 bit):** A bit that specifies whether the custom view includes the [**print settings**](#gt_6ef7745e-6602-4ff5-a8b0-9b9fd9f95b4a) of the workbook. MUST be a value from the following table: + +[TABLE] + +**J - fRowColIncl (1 bit):** A bit that specifies whether the custom view includes the [**hidden rows**](#gt_3833addc-1f77-4c64-856c-c1b967fdaa75), [**hidden columns**](#gt_ea5c8135-254e-407c-999b-5cf39e709164), and [**filters**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) for the workbook. MUST be a value from the following table: + +[TABLE] + +**K - fInvalidTabId (1 bit):** A bit that specifies whether the **tabId** field is ignored. + +**L - fTimedUpdate (1 bit):** A bit that specifies whether updates associated with linked or [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) are coordinated. If the value of the **fPersonalView** field is 0, the value of **fTimedUpdate** MUST be 0. + +**M - fAllMemChanges (1 bit):** A bit that specifies whether the changes being saved have priority in a [**merge conflict**](#gt_7854bf7f-3ead-4a20-9686-77d75fd6cefa). If the value of the **fTimedUpdate** field is 0, the value of **fAllMemChanges** is undefined and MUST be ignored. + +**N - fOnlySync (1 bit):** A bit that specifies whether the automatic update merges the current changes into a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc) or whether the automatic update merges and also saves the changes. If the value of the **fPersonalView** field is 0, the value of **fOnlySync** MUST be 0. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**O - fPersonalView (1 bit):** A bit that specifies whether the custom view is the personal view of a shared workbook. MUST be 0 if this is not a shared workbook. + +**P - fIconic (1 bit):** A bit that specifies whether the workbook window is minimized. The value of **fIconic** and the value of **fZoom** MUST NOT both be 1. + +**unused3 (14 bits):** Undefined and MUST be ignored. + +**wMergeInterval (2 bytes):** An unsigned integer that specifies the time interval, in minutes, between automatic merges of a shared workbook. The restrictions on the value of **wMergeInterval** are dictated by the value of the **fPersonalView** field and the value of the **fTimedUpdate** field, as specified in the following table: + +| fPersonalView | fTimedUpdate | wMergeInterval | +|----|----|----| +| 1 | 1 | MUST be greater than or equal to 5 and less than or equal to 1440. | +| 1 | 0 | Undefined and MUST be ignored. | +| 0 | 0 | MUST be 65535. | + +**st (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the name of the custom view. + +### UserSViewBegin + +The **UserSViewBegin** record specifies [**custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4) settings for the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and specifies the beginning of a collection of records as defined by the [Chart Sheet substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), [Dialog Sheet substream](#Section_da37feb48b9a462d87772a5fddd4866e) ABNF, [Macro Sheet substream](#Section_0dddd943f77a4fc2bf92868acb4587f7) ABNF, and [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF. The collection of records specifies custom view settings for the current sheet. There is an associated [UserBView](#userbview) record, specified by the **guid** field, that specifies custom view settings that apply to the whole [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). If the current sheet is a [**chart sheet**](#gt_da561b7b-c629-4cd8-bfaa-6e62471d9e83), the [UserSViewBegin_Chart](#usersviewbegin_chart) version of this record MUST be used. + +[TABLE] + +**guid (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1), as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2), that specifies the association with a UserBView. MUST equal the value of the **guid** field of the UserBView. + +**iTabid (2 bytes):** A [TabId](#tabid) structure that specifies the sheet of this custom view. + +**reserved1 (2 bytes):** MUST be zero, and MUST be ignored. + +**wScale (4 bytes):** An unsigned integer that specifies the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) of the window used to display the sheet. MUST be greater than or equal to 10 and less than or equal to 400. + +**icvHdr (2 bytes):** An [Icv](#icv) structure that specifies the color of the [**gridlines**](#gt_82f8a326-64b0-4506-a18e-930f7c2c95b9) displayed in the view. MUST be less than or equal to 64. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +**pnnSel (1 byte):** A [**PaneType**](#panetype) structure that specifies the [**active pane**](#gt_33f49274-001d-40a3-bcca-f54a93906c29). + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +**reserved4 (1 byte):** MUST be zero, and MUST be ignored. + +**A - fShowBrks (1 bit):** A bit that specifies whether [**page breaks**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871) are displayed. + +**B - fDspFmlaSv (1 bit):** A bit that specifies whether the window used to display the sheet displays formulas or values. MUST be 0 for [**dialog sheets**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8). MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------------| +| 0x0 | The window used to display the sheet displays values. | +| 0x1 | The window used to display the sheet displays formulas. | + +**C - fDspGridSv (1 bit):** A bit that specifies whether the window used to display the sheet displays gridlines. + +**D - fDspRwColSv (1 bit):** A bit that specifies whether the window used to display the sheet displays row and column headings. MUST be 0 for dialog sheets. + +**E - fDspGutsSv (1 bit):** A bit that specifies whether outline symbols are displayed. MUST be 0 for dialog sheets. MUST be 1 for [**macro sheets**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491). + +**F - fDspZerosSv (1 bit):** A bit that specifies whether the window used to display the sheet displays zero values or suppresses display of zero values. MUST be 0 for dialog sheets. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The window used to display the sheet displays zero values. | +| 1 | The window used to display the sheet suppresses display of zero values. | + +**G - fHorizontal (1 bit):** A bit that specifies whether the sheet is centered between the horizontal margins when printed. + +**H - fVertical (1 bit):** A bit that specifies whether the sheet is centered between the vertical margins when printed. + +**I - fPrintRwCol (1 bit):** A bit that specifies whether to print the row and column headings. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fPrintIncl** field value of 0. + +**J - fPrintGrid (1 bit):** A bit that specifies whether to print the gridlines. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equals to the **guid** of this record has the **fPrintIncl** field value of 0. + +**K - fFitToPage (1 bit):** A bit that specifies whether the [**fit to page**](#gt_5245d03e-06db-43aa-9752-60a624fc6338) option is enabled. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fPrintIncl** field value of 0. + +**L - fPrintArea (1 bit):** A bit that specifies whether there is at least one [**print area**](#gt_5832abeb-7b03-49db-8cf0-512745131ff5) on the sheet. If the value of **fOnePrintArea** is 1, the value of **fPrintArea** MUST be 1. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fPrintIncl** field value of 0. + +Additionally, if **fPrintArea** is 1, there MUST exist an [Lbl](#lbl) record for the print area as specified in the description for the **fPrintIncl** field in UserBView. + +**M - fOnePrintArea (1 bit):** A bit that specifies whether there is only one print area on the sheet. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fPrintIncl** field value of 0. + +Additionally, if **fOnePrintArea** is 1, there MUST exist an Lbl record for the print area as specified in the description for the **fPrintIncl** field in UserBView. + +**N - fFilterMode (1 bit):** A bit that specifies whether there are [**hidden cells**](#gt_cde68c21-0bab-4e40-8b24-5954ff12fae2) because of filtering. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fRowColIncl** field value of 0. + +Additionally, if **fFilterMode** is 1, there MUST exist an Lbl record for the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) being filtered as specified in the description for the **fRowColIncl** field in UserBView. There can exist an Lbl record for the range containing [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) criteria as specified in the description for the fRowColIncl field in UserBView. + +**O - fEzFilter (1 bit):** A bit that specifies whether the [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) icon is shown on the sheet. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fRowColIncl** field value of 0. + +Additionally, if **fEzFilter** is 1, there MUST exist an Lbl record for the range being filtered as specified in the description for the **fRowColIncl** field in UserBView. There can exist an Lbl record for the range containing filter criteria as specified in the description for the fRowColIncl field in UserBView. + +**P - fFrozen (1 bit):** A bit that specifies whether the [**panes**](#gt_fa363a22-6c89-4829-86aa-09f939f40a54) in the window used to display the sheet are [**frozen**](#gt_1e984b7c-9760-4832-88c8-798e30f845db). If the value of **fFrozenNoSplit** is 1, the value of **fFrozen** MUST be 1. + +**Q - fFrozenNoSplit (1 bit):** A bit that specifies whether the panes in the window used to display the sheet are [**frozen panes**](#gt_28507dfc-4443-4a02-a18c-27b5db006946) but are not [**split panes**](#gt_03a3359c-d8a8-4988-ace6-369a2ae4ff82). + +**R - fSplitV (1 bit):** A bit that specifies whether the window used to display the sheet is split vertically. + +**S - fSplitH (1 bit):** A bit that specifies whether the window used to display the sheet is split horizontally. + +**T - fHiddenRw (2 bits):** An unsigned integer that specifies the state of [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) rows, excluding the filtered rows. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Indicates a [**hidden row**](#gt_3833addc-1f77-4c64-856c-c1b967fdaa75) is present. | +| 0x1 | Indicates a hidden row is not present. | + +MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fRowColIncl** field value of 0. + +Additionally, if **fHiddenRw** is 1, there MUST exist an Lbl record for the hidden rows as specified in the description for the **fRowColIncl** field in UserBView. + +**U - fHiddenCol (1 bit):** A bit that specifies whether there is at least one [**hidden column**](#gt_ea5c8135-254e-407c-999b-5cf39e709164) in the sheet. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fRowColIncl** field value of 0. + +Additionally, if **fHiddenRw** is 1, there MUST exist an Lbl record for the hidden columns as specified in the description for the **fRowColIncl** field in UserBView. + +**V - unused1 (3 bits):** Undefined and MUST be ignored. + +**W - fFilterUnique (1 bit):** A bit that specifies whether the sheet has the [**advanced filter**](#gt_31065343-5514-44e3-884d-9b16ddd36176) enabled and is displaying only unique rows. MUST be 0 for dialog sheets. MUST be 0 if the UserBView record with **guid** field value equal to the **guid** of this record has the **fRowColIncl** field value of 0. + +Additionally, if **fFilterUnique** is 1, there MUST exist an Lbl record for the range being filtered as specified in the description for the **fRowColIncl** field in UserBView. There can exist an Lbl record for the range containing filter criteria as specified in the description for the fRowColIncl field in UserBView. + +**X - fSheetLayoutView (1 bit):** A bit that specifies whether the sheet is in the [**Page Break Preview view**](#gt_a7342c25-b4fd-4c84-9922-ae9c4a92d180). Only one of this value or the value of **fPageLayoutView** can be 1. If both values are 0, the custom view is in the [**Normal view**](#gt_b3c343ae-05ca-4b91-9cc1-383ee3563990). MUST be 0 for dialog sheets and macro sheets. + +**Y - fPageLayoutView (1 bit):** A bit that specifies whether the sheet is in the [**Page Layout view**](#gt_c5ea3e6c-db72-4a85-b273-596e95a3841e). MUST be 0 for dialog sheets and macro sheets. + +**Z - unused2 (1 bit):** Undefined and MUST be ignored. + +**a - fRuler (1 bit):** A bit that specifies whether the [**ruler**](#gt_03895998-6780-4615-8795-0fda97bd6379) is displayed. + +**b - reserved5 (2 bits):** MUST be zero, and MUST be ignored. + +**ref8TopLeft (8 bytes):** A [Ref8U](#ref8u) structure that specifies the [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) area of the [**logical top-left**](#gt_88b25c47-61c2-44de-abb0-12ea3348a412) pane. + +**operNumX (8 bytes):** A [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d) that specifies the left-to-right position of the start of the split pane expressed as a column number. The value MUST be greater than or equal to 0. The sum of this value and the value of **ref8TopLeft**.**colFirst** MUST be less than or equal to 256. + +**operNumY (8 bytes):** A floating-point number that specifies the top-to-bottom position of the start of the split pane expressed as a row number. The value MUST be greater than or equal to 0. The sum of this value and the value of **ref8TopLeft**.**rowFirst** MUST be less than or equal to 65536. + +**colRPane (2 bytes):** An unsigned integer that specifies the first visible column of the [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) pane. MUST be 65535 or less than or equal to 255. If the value of the **fSplitV** field is 1, the value of **colRPane** MUST be 65535. If the value of the **fSplitV** field is 0, the value of **colRPane** MUST be less than or equal to 255. + +**rwBPane (2 bytes):** An unsigned integer that specifies the first visible row of the bottom pane. If the value of the **fSplitH** field is 1, the value of **rwBPane** MUST be 65535. + +### UserSViewBegin_Chart + +The **UserSViewBegin_Chart** record specifies [**custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4) settings for the current [**chart sheet**](#gt_da561b7b-c629-4cd8-bfaa-6e62471d9e83) and that specifies the beginning of a collection of records as defined by the [Chart Sheet substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies custom view settings for the current chart sheet. There is an associated [UserBView](#userbview) record, specified by the **guid** field, that specifies custom view settings that apply to the whole [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +[TABLE] + +**guid (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1), as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2), that specifies the association with a UserBView. MUST equal the value of the **guid** field of the UserBView record. + +**iTabid (4 bytes):** A [TabId](#tabid) structure that specifies the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) of this custom view. + +**wScale (4 bytes):** An unsigned integer that specifies the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) of the window used to display the sheet. MUST be greater than or equal to 10 and less than or equal to 400. + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +**reserved2 (22 bits):** MUST be zero, and MUST be ignored. + +**A - hsState (2 bits):** An unsigned integer that specifies the [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) state of the chart sheet. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The chart sheet is [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72). | +| 0x1 | The chart sheet is hidden. | +| 0x2 | Very Hidden; the sheet is hidden and cannot be displayed using the user interface. | + +**reserved3 (6 bits):** MUST be zero, and MUST be ignored. + +**B - fZoomToFit (1 bit):** A bit that specifies whether the zoom level is set to "Zoom to Fit Selection". SHOULD[\<141\>](#Appendix_A_141) be 1 if the current zoom level specified by the **wScale** field fits the current [**selection**](#gt_8a241461-3c59-45fb-9094-b6692a0c27fe). + +**C - reserved4 (1 bit):** MUST be zero, and MUST be ignored. + +**unused2 (8 bytes):** Undefined and MUST be ignored. + +**unused3 (8 bytes):** Undefined and MUST be ignored. + +**unused4 (8 bytes):** Undefined and MUST be ignored. + +**unused5 (2 bytes):** Undefined and MUST be ignored. + +**unused6 (2 bytes):** Undefined and MUST be ignored. + +### UserSViewEnd + +The **UserSViewEnd** record specifies the end of a collection of records, as defined by the [common productions](#Section_a1b3d8b4744241fd9c57bbd2a6394082) substream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) and the [Dialog Sheet substream](#Section_da37feb48b9a462d87772a5fddd4866e) ABNF. The collection of records specifies a collection of [**custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4) records. + +[TABLE] + +**reserved (2 bytes):** MUST be 1, and MUST be ignored. + +### UsesELFs + +The **UsesELFs** record specifies whether the file supports [**natural language formulas**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b). + +[TABLE] + +**useselfs (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the file supports natural language formulas. The value SHOULD[\<142\>](#Appendix_A_142) be 0x0000. + +### UsrChk + +The **UsrChk** record specifies the version information for the last user who opened the [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + +[TABLE] + +**version (2 bytes):** An unsigned integer that specifies the [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) version that was used by the last user to open the shared workbook. The value MUST be a value from the following table: + +| Value | Meaning | +|--------|-------------------------------------------------------| +| 0x0200 | [**BIFF2**](#gt_c0c2618b-ae39-4e3d-9615-4b71d8fb888a) | +| 0x0300 | [**BIFF3**](#gt_3b9d80df-ea32-495e-b43b-fa8a6d942ab9) | +| 0x0400 | [**BIFF4**](#gt_d99263f5-d806-4c42-9923-00c72054162a) | +| 0x0500 | [**BIFF5**](#gt_1448958e-abe8-40f3-9d71-40500c3cf9a3) | +| 0x0600 | [**BIFF8**](#gt_e60b71bb-c66c-4a44-ab07-0f9f20ee3dd5) | + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +### UsrExcl + +The **UsrExcl** record specifies whether a user has acquired an exclusive lock on the [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc) and that specifies the beginning of a collection of records as defined by the [revision](#Section_d120a1ffd2e6488381a507236f1994b0) stream [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies properties for a shared workbook. + +[TABLE] + +**fExclusive (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the user has an exclusive lock on the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The value MUST be a value from the following table: + +| Value | Meaning | +|------------|-----------------------------------------------------------| +| 0x00000000 | The user does not have an exclusive lock on the workbook. | +| 0x00000001 | The user has an exclusive lock on the workbook. | + +**sdtr (8 bytes):** A [ShortDTR](#shortdtr) structure that specifies the date and time when **fExclusive** was set to 0x00000001. + +**cchUser (2 bytes):** An unsigned integer that specifies the number of characters in **stUser** that are used to specify the name of the user who has [**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81) the workbook. Characters in **stUser** that are to the right of these used characters are ignored. MUST be less than or equal to 0x0036. + +**stUser (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the name of the user who has locked the workbook. The count of characters MUST be 147. + +### UsrInfo + +The **UsrInfo** record specifies information about a user who currently has the [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc) open. + +[TABLE] + +**lUsrId (4 bytes):** A signed integer that specifies a unique user identifier for this user. + +**guid (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1), as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2), that specifies the last set of revisions synced to by this user. + +**shortdtr (8 bytes):** A [ShortDTR](#shortdtr) structure that specifies the date and time this user opened the shared workbook. + +**stUserName (variable):** A [XLUnicodeString](#xlunicodestring) structure that specifies the name of this user. The number of characters in this string MUST be greater than or equal to 1 and less than or equal to 54. + +**unused (1 byte):** Undefined and MUST be ignored. + +### ValueRange + +The **ValueRange** record specifies the properties of a value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). + +[TABLE] + +**numMin (8 bytes):** An Xnum (section [2.5.342](#xnum)) structure that specifies the minimum value of the value axis. MUST be less than the value of **numMax**. If the value of **fAutoMin** is 1, this field MUST be ignored. + +**numMax (8 bytes):** An Xnum structure that specifies the maximum value of the value axis. MUST be greater than the value of **numMin**. If the value of **fAutoMax** is 1, this field MUST be ignored. + +**numMajor (8 bytes):** An Xnum structure that specifies the interval at which [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) and [**major gridlines**](#gt_2803347c-6396-46a5-9ede-6bef1149b013) are displayed. MUST be greater than or equal to the value of **numMinor**. If the value of **fAutoMajor** is 1, this field MUST be ignored. + +**numMinor (8 bytes):** An Xnum structure that specifies the interval at which [**minor tick marks**](#gt_c2eb605a-6c5a-427e-8608-f16940de82a6) and [**minor gridlines**](#gt_49980976-6314-43ad-ad51-8d3e55ef4b59) are displayed. MUST be greater than or equal to zero. If the value of **fAutoMinor** is 1, this field MUST be ignored. + +**numCross (8 bytes):** An Xnum structure that specifies at which value the other axes in the [axis group](#Section_578b739742624944b5a67ee6d4d3bb55) cross this value axis. If the value of **fAutoCross** is 1, this field MUST be ignored. + +**A - fAutoMin (1 bit):** A bit that specifies whether **numMin** is calculated automatically. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **numMin** is used as the minimum value of the value axis. | +| 1 | **numMin** is calculated such that the [data point](#Section_9c986ad250d44fa1a157063ac5c971a0) with the minimum value can be displayed in the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). | + +**B - fAutoMax (1 bit):** A bit that specifies whether **numMax** is calculated automatically. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **numMax** is used as the maximum value of the value axis. | +| 1 | **numMax** is calculated such that the data point with the maximum value can be displayed in the plot area. | + +**C - fAutoMajor (1 bit):** A bit that specifies whether **numMajor** is calculated automatically. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **numMajor** is used as the interval at which major tick marks and major gridlines are displayed. | +| 1 | **numMajor** is calculated automatically. | + +**D - fAutoMinor (1 bit):** A bit that specifies whether **numMinor** is calculated automatically. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **numMinor** is used as the interval at which minor tick marks and minor gridlines are displayed. | +| 1 | **numMinor** is calculated automatically. | + +**E - fAutoCross (1 bit):** A bit that specifies whether **numCross** is calculated automatically. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The value specified by **numCross** is used as the point at which the other axes in the axis group cross this value axis. | +| 1 | **numCross** is calculated so that the crossing point is displayed in the plot area. | + +**F - fLog (1 bit):** A bit that specifies whether the value axis has a logarithmic scale. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The scale of the value axis is linear. | +| 1 | The scale of the value axis is logarithmic. The default base of the logarithmic scale is 10, unless a [CrtMlFrt](#crtmlfrt) record follows this record, specifying the base in a [XmlTkLogBaseFrt](#xmltklogbasefrt) structure. | + +**G - fReversed (1 bit):** A bit that specifies whether the values on the value axis are displayed in reverse order. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Values are displayed from smallest-to-largest, from left-to-right, or from bottom-to-top, respectively, depending on the orientation of the axis. | +| 1 | The values are displayed in reverse order, meaning largest-to-smallest, from left-to-right, or from bottom-to-top, respectively. | + +**H - fMaxCross (1 bit):** A bit that specifies whether the other axes in the axis group cross this value axis at the maximum value. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The other axes in the axis group cross this value axis at the value specified by **numCross**. | +| 1 | The other axes in the axis group cross the value axis at the maximum value. If **fMaxCross** is 1, then both **fAutoCross** and **numCross** MUST be ignored. | + +**unused (8 bits):** Undefined and MUST be ignored. + +### VCenter + +The **VCenter** record specifies whether the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) is centered vertically when printed. + +[TABLE] + +**vcenter (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the sheet is centered between [TopMargin](#topmargin) and [BottomMargin](#bottommargin) when printed. + +### VerticalPageBreaks + +The **VerticalPageBreaks** record specifies a list of all explicit column [**page breaks**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871) in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**cbrk (2 bytes):** An unsigned integer that specifies the number of page breaks. The value MUST be less than or equal to 255. + +**rgbrk (variable):** An array of [VertBrk](#vertbrk) that specifies all of the page breaks. The array MUST be sorted first by the **col** value and then by the **RowStart** value in each VertBrk. Two page breaks MUST NOT overlap. The number of VertBrk MUST equal the value of **cbrk**. + +### WebPub + +The **WebPub** record specifies the information for a single [**published**](#gt_8ffc383a-d4f1-4515-a8b5-874d84ab2d2b) Web page. + +[TABLE] + +**frtRefHeaderU (12 bytes):** An [FrtRefHeaderU](#frtrefheaderu) structure. If the value of **tws** is 4, then **frtRefHeaderU.ref8** specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells associated with this record and **frtRefHeaderU.grbitFrt.fFrtRef** MUST be 1. If the value of **tws** is not 4, then **frtRefHeaderU.grbigFrt.fFrtRef** MUST be zero. + +**tws (1 byte):** An unsigned integer that specifies the type of Web source that was published. It MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0xFF | The source is undefined. | +| 0x00 | [**Workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) | +| 0x01 | Entire [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) | +| 0x02 | [**Print area**](#gt_5832abeb-7b03-49db-8cf0-512745131ff5) | +| 0x03 | [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) range | +| 0x04 | Range of cells | +| 0x05 | Chart | +| 0x06 | [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) report | +| 0x07 | [**Query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) ([**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) range) | +| 0x08 | [**Named range**](#gt_042582ea-4050-4e5c-a2df-ae39706a19b6) | + +**twd (1 byte):** An unsigned integer that specifies the type of Web page created and whether the item is static or interactive. It MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------| +| 0x00 | Non-interactive page, only for viewing | +| 0x01 | Uses workbook functionality | +| 0x02 | Uses PivotTable functionality | +| 0x03 | Uses chart functionality | + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - fAutoRepublish (1 bit):** This bit specifies whether to republish the Web page when it is saved. + +**C - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**D - fMhtml (1 bit):** This bit specifies whether the file is published as a single Web page or as a Web page with references to other files. + +**reserved2 (12 bits):** MUST be zero and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**nStyleId (4 bytes):** An unsigned integer that specifies the unique identifier for this published content. + +**cb (4 bytes):** An unsigned integer that specifies the size of the data that follows in this record according to the following formula: + +size of **srcName** + size of **stFileDest** + size of **stDivId** + size of **stTitle** + size of **crtID** + size of **frtRGB** + size of **unused3** + +The value MUST be greater than 0. + +**srcName (variable):** A [WebPubString](#webpubstring) structure that specifies the named range to be published. The field MUST exist if and only if the value of **tws** is greater than 4. The character count in the string MUST be less than or equal to 255. + +**stFileDest (variable):** A WebPubString structure that specifies the [**URL**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) or the path to the location of the published page. The character count in the string MUST be less than or equal to 255. + +**stDivId (variable):** A WebPubString structure that specifies the destination bookmark of the published page. The character count in the string MUST be less than or equal to 255. + +**stTitle (variable):** A WebPubString structure that specifies the title of the [**published item**](#gt_14dfffe3-13a6-4c5f-b1d8-22e1e241634f). + +**crtID (4 bytes):** An MSOSPID structure, as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872), that specifies the published chart object. This field MUST exist if and only if **tws** equals 5. + +**frtRgb (variable):** A binary stream that specifies the bytes reserved for future use. The size of this field in bytes is calculated according to the following formula: + +size of this record – 30 – size of **srcName** – size of **stFileDest** – size of **stDivId** – size of **stTitle** – size of **crtID**[**\<143\>**](#Appendix_A_143) + +**unused3 (2 bytes):** Undefined and MUST be ignored. + +### Window1 + +The **Window1** record specifies attributes of a window used to display a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) (called "the window" within this record definition). For each Window1 record in the Globals Substream there MUST be an associated [Window2](#window2) record in each [chart sheet](#Section_732ff614d939416bb7c76d983471ff11), [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56), [macro sheet](#Section_0dddd943f77a4fc2bf92868acb4587f7), and [dialog sheet](#Section_da37feb48b9a462d87772a5fddd4866e) substream that exists in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The Window2 record in a given substream associated with a given Window1 record is the Window2 record whose ordinal position in the collection of Window2 records in the containing substream is equal to the ordinal position of the given Window1 record in the collection of Window1 records in the [Globals Substream](#globals-substream). Each Window2 record specifies extended properties of the associated Window1 record. + +[TABLE] + +**xWn (2 bytes):** A signed integer that specifies the horizontal position, in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382), of the window. The value is relative to the [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) edge of the [**client area**](#gt_623ea69b-ffdb-4751-8751-2cbf4cc11f08) of the window. + +**yWn (2 bytes):** A signed integer that specifies the vertical position, in twips, of the window. The value is relative to the top edge of the client area of the window. + +**dxWn (2 bytes):** A signed integer that specifies the width, in twips, of the window. MUST be greater than or equal to 1. + +**dyWn (2 bytes):** A signed integer that specifies the height, in twips, of the window. MUST be greater than or equal to 1. + +**A - fHidden (1 bit):** A bit that specifies whether the window is in the list of [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) windows. + +**B - fIconic (1 bit):** A bit that specifies whether the window is minimized. + +**C - fVeryHidden (1 bit):** A bit that specifies whether the window has the properties of **fHidden** and that also specifies that the user cannot see that the window is in the list of hidden windows. + +**D - fDspHScroll (1 bit):** A bit that specifies whether a horizontal scroll bar is displayed. + +**E - fDspVScroll (1 bit):** A bit that specifies whether a vertical scroll bar is displayed. + +**F - fBotAdornment (1 bit):** A bit that specifies whether [**sheet tabs**](#gt_3b131045-238c-4ce8-9c22-b6aac874c7c5) are displayed. + +**G - fNoAFDateGroup (1 bit):** A bit that specifies whether dates are grouped hierarchically in the [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) menu or listed chronologically in the AutoFilter menu. + +| Value | Meaning | +|-------|------------------------------------------------------------------| +| 0 | Dates are grouped by year, month and day in the AutoFilter menu. | +| 1 | Dates are listed chronologically in the AutoFilter menu. | + +**reserved (9 bits):** MUST be zero, and MUST be ignored. + +**itabCur (2 bytes):** A [TabIndex](#tabindex) structure that specifies the [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) sheet tab. + +**itabFirst (2 bytes):** A TabIndex structure that specifies the first displayed sheet tab. + +**ctabSel (2 bytes):** An unsigned integer that specifies the number of sheet tabs that are selected. The value MUST be less than or equal to the number of sheets in the workbook. Each [**sheet stream**](#gt_ed6406c5-331a-443d-a472-3666215c18fd) in the [workbook stream](#Section_f682f4b08c6b444e83f852d156f1e8ba) specifies a sheet. + +**wTabRatio (2 bytes):** An unsigned integer that specifies the ratio of the width of the sheet tabs to the width of the horizontal scroll bar, multiplied by 1000. MUST be less than or equal to 1000. + +### Window2 + +The **Window2** record specifies attributes of the window used to display a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and that specifies the beginning of a collection of records as defined by the [Chart Sheet substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), [Macro Sheet substream](#Section_0dddd943f77a4fc2bf92868acb4587f7) ABNF, and [Worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF. The collection of records specifies the settings of a [**Page Layout view**](#gt_c5ea3e6c-db72-4a85-b273-596e95a3841e) for a sheet, the zoom of the current view, the position of either [**frozen panes**](#gt_28507dfc-4443-4a02-a18c-27b5db006946) or [**unfrozen panes**](#gt_172b6800-45a6-4d45-938b-0f21abf83672), and the [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the sheet. When this record is contained in a macro sheet substream or a worksheet substream, it has a length of 18 bytes. When this record is contained in a chart sheet substream, it has a length of 10 bytes (which are the first 10 bytes of the original 18-byte record) and only the **fSelected** field is used. This record specifies extended properties of an associated [Window1](#window1) record, and that association is specified in Window1. + +[TABLE] + +**A - fDspFmlaRt (1 bit):** A bit that specifies whether the window displays formulas (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) or values. If the value is 1, the window displays formulas (section 2.2.2). This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**B - fDspGridRt (1 bit):** A bit that specifies whether the window displays [**gridlines**](#gt_82f8a326-64b0-4506-a18e-930f7c2c95b9). + +| Value | Meaning | +|-------|----------------------------------------| +| 0 | The window does not display gridlines. | +| 1 | The window displays gridlines. | + +This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**C - fDspRwColRt (1 bit):** A bit that specifies whether the window displays row headings and column headings. + +| Value | Meaning | +|-------|---------------------------------------------------------------| +| 0 | The window does not display row headings and column headings. | +| 1 | The window displays row headings and column headings. | + +This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**D - fFrozenRt (1 bit):** A bit that specifies whether the panes in the window are [**frozen**](#gt_1e984b7c-9760-4832-88c8-798e30f845db). The value MUST be 0 if either the value of **colLeft** is 255 or the value of **rwTop** is 65535. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**E - fDspZerosRt (1 bit):** A bit that specifies whether the window displays zero values. + +| Value | Meaning | +|-------|----------------------------------------------------------------| +| 0 | The window displays cells that have a value of zero as blank. | +| 1 | The window displays cells that have a value of zero as a zero. | + +This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**F - fDefaultHdr (1 bit):** A bit that specifies whether the gridlines of the window are drawn in the window's default [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) or in the color specified by the value of **icvHdr**. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +| Value | Meaning | +|----|----| +| 0 | Gridlines of the window are drawn in the color specified by the value of **icvHdr**. | +| 1 | Gridlines of the window are drawn in the default foreground color of the window. | + +**G - fRightToLeft (1 bit):** A bit that specifies whether the text is displayed in [**right-to-left**](#gt_91359688-7863-4e88-b507-f57b3dada5ec) mode in the window. + +| Value | Meaning | +|----|----| +| 0 | The text is displayed in [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067) mode. | +| 1 | The text is displayed in right-to-left mode. | + +This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**H - fDspGuts (1 bit):** A bit that specifies whether the window displays the [**outline state**](#gt_595fa0de-0130-489d-ba83-fbba78917310). This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**I - fFrozenNoSplit (1 bit):** A bit that specifies whether the panes in the window are frozen without [**pane**](#gt_fa363a22-6c89-4829-86aa-09f939f40a54) splits or frozen with pane splits. If the value of **fFrozenRt** is 0, the value of **fFrozenNoSplit** MUST be 0. + +| Value | Meaning | +|-------|---------------------------------------------------------| +| 0 | The panes in the window are frozen with pane splits. | +| 1 | The panes in the window are frozen without pane splits. | + +This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**J - fSelected (1 bit):** A bit that specifies whether the [**sheet tab**](#gt_3b131045-238c-4ce8-9c22-b6aac874c7c5) is selected. + +**K - fPaged (1 bit):** A bit that specifies whether the sheet is currently being displayed in the window. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**L - fSLV (1 bit):** A bit that specifies whether the sheet is in [**Page Break Preview view**](#gt_a7342c25-b4fd-4c84-9922-ae9c4a92d180). This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**M - reserved1 (4 bits):** MUST be zero, and MUST be ignored. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**rwTop (2 bytes):** A [RwU](#rwu) structure that specifies a zero-based row index of the first [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) row of the sheet. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**colLeft (2 bytes):** A [ColU](#colu) structure that specifies a zero-based column index of the [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d)-most visible column. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**icvHdr (2 bytes):** An [Icv](#icv) structure that specifies the color of the gridlines. MUST be less than or equal to 64. MUST be 64 if and only if the value of **fDefaultHdr** is 1. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. This field is undefined and MUST be ignored if this record is contained in a chart sheet substream. + +**wScaleSLV (2 bytes):** An unsigned integer that specifies the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) in the Page Break Preview view. If the value of **fSLV** is 1 and this record has an associated [Scl](#scl) as specified in the ABNF in [Common Productions](#Section_a1b3d8b4744241fd9c57bbd2a6394082), the value of **wScaleSLV** is undefined and MUST be ignored. MUST[\<144\>](#Appendix_A_144) be either 0 or greater than or equal to 10 and less than or equal to 400. A value of 0 specifies the default zoom level. This field MUST NOT exist if this record is contained in a chart sheet substream. + +**wScaleNormal (2 bytes):** An unsigned integer that specifies the zoom level in the [**Normal view**](#gt_b3c343ae-05ca-4b91-9cc1-383ee3563990). If the value of **fSLV** is 0 and the value of the **fPageLayoutView** field of the [PLV](#plv), as specified in the ABNF in Common Productions, is 0 and this record has an associated Scl, then the value of **wScaleNormal** is undefined and MUST be ignored. MUST[\<145\>](#Appendix_A_145) be either 0 or greater than or equal to 10 and less than or equal to 400. A value of 0 specifies the default zoom level. This field MUST NOT exist if this record is contained in a chart sheet substream. + +**unused (2 bytes):** Undefined and MUST be ignored. This field MUST NOT exist if this record is contained in a chart sheet substream. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. This field MUST NOT exist if this record is contained in a chart sheet substream. + +### WinProtect + +The **WinProtect** record specifies whether the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) windows can be resized or moved and whether the [**window state**](#gt_b470d08f-cbdd-49db-a2e0-08bb9a04d503) can be changed. + +[TABLE] + +**fLockWn (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the windows can be resized or moved and whether the window state can be changed. It MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The workbook windows can be resized or moved and the window state can be changed. | +| 0x0001 | The workbook windows cannot be resized or moved and the window state cannot be changed. | + +### WOpt + +The **WOpt** record specifies options for saving as a Web page. + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The value of the **frtHeaderOld.rt** field MUST be 0x080B. + +**A - fRelyOnCSS (1 bit):** A bit that specifies whether [**cascading style sheets (CSS)**](#gt_22155692-26b0-4146-9737-ef43f4b31305) is used for [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) formatting when viewing the saved file in a Web browser. + +**B - fOrganizeInFolder (1 bit):** A bit that specifies whether all supporting files, such as background textures and graphics, are organized in a separate [**folder**](#gt_6afebb3e-5358-4ab8-b0fc-fcc8de47fcc1) when saving this file as a Web page. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------------------------| +| 0 | All supporting files are saved in the same folder as the Web page. | +| 1 | All supporting files are organized in a separate folder. | + +**C - fUseLongFileNames (1 bit):** A bit that specifies whether [**long file names**](#gt_7d480c8b-0dfe-4c54-8d8d-5e8718a8c638) are used when saving this file as a Web page. + +**D - fDownloadComponents (1 bit):** A bit that specifies whether the necessary [**Microsoft Office Web Components**](#gt_c362a2c8-f385-404c-8967-3143d111bb97) are downloaded if they are not installed when viewing the saved file in a Web browser. + +**E - fRelyOnVML (1 bit):** A bit that specifies whether the application uses [**VML**](#gt_eb6b7893-b656-4b91-8fab-51fd1cf28a38) to display graphics in a Web browser. + +**F - fAllowPNG (1 bit):** A bit that specifies whether Portable Network Graphics (PNG) format is allowed as an image format when saving this file as a Web page. + +**reserved1 (10 bits):** MUST be zero, and MUST be ignored. + +**screenSize (1 byte):** A **WebScreenSizeEnum**, as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.4, that specifies the ideal minimum screen size of the target monitor used to view the saved file in a Web browser. + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +**dwPixelsPerInch (4 bytes):** An unsigned integer that specifies the density, in pixels per inch, of graphics images and [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) cells when saving this file as a Web page. The value MUST be greater than or equal to 19 and less than or equal to 480. + +**uiCodePage (4 bytes):** An unsigned integer that specifies the [**code page**](#gt_210637d9-9634-4652-a935-ded3cd434f38). The value MUST be one of the code page values specified in [\[CODEPG\]](https://go.microsoft.com/fwlink/?LinkId=89840), to be used by the Web browser when viewing the saved file. + +**rgbLocationOfComponents (variable):** An [LPWideString](#lpwidestring) structure that specifies the [**URL**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) or the file path to the location from which authorized users can download Microsoft Office Web Components when viewing the saved file as a Web page. The value of **rgbLocationOfComponents.cch** MUST be less than or equal to 2083. + +**rgbFuture (variable):** A binary stream that specifies the bytes reserved for future use. The size of this field in bytes is calculated according to the following formula: + +size of this record – 16 – size of **rgbLocationOfComponents** + +### WriteAccess + +The **WriteAccess** record specifies the name of the user who last created, opened, or modified the file. + +[TABLE] + +**userName (variable):** An [XLUnicodeString](#xlunicodestring) structure that specifies the [**user name**](#gt_c298446e-09d2-470d-a70f-5249dafa15c6). The value of **userName.cch** MUST be less than or equal to 54. If the value of **userName.rgb** is equal to "\0x20\0x20" no user name is specified. + +**unused (variable):** Undefined and MUST be ignored. The size of this field in bytes + +MUST be equal to the value of the following formula: (112 – number of bytes of **userName**). + +### WriteProtect + +The existence of the **WriteProtect** record specifies that the file is write-[**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829). + +### WsBool + +The **WsBool** record specifies information about a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**A - fShowAutoBreaks (1 bit):** A bit that specifies whether [**page breaks**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871) inserted automatically are [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) on the sheet. + +**B - reserved1 (3 bits):** MUST be zero, and MUST be ignored. + +**C - fDialog (1 bit):** A bit that specifies whether the sheet is a [**dialog sheet**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8). + +**D - fApplyStyles (1 bit):** A bit that specifies whether to apply styles in an [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) when an outline is applied. + +**E - fRowSumsBelow (1 bit):** A bit that specifies whether summary rows appear below an outline's detail rows. + +**F - fColSumsRight (1 bit):** A bit that specifies whether summary columns appear to the right or left of an outline's detail columns. Valid values are specified in the following table: + +| Value | Meaning | +|----|----| +| 0 | The summary columns appear to the right, if the sheet is displayed [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067), or appear to the left, if the sheet is displayed [**right-to-left**](#gt_91359688-7863-4e88-b507-f57b3dada5ec). | +| 1 | The summary columns appear to the left, if the sheet is displayed left-to-right, or appear to the right, if the sheet is displayed right-to-left. | + +**G - fFitToPage (1 bit):** A bit that specifies whether to fit the printable contents to a single page when printing this sheet. + +**H - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**I - unused (2 bits):** Undefined and MUST be ignored. + +**J - fSyncHoriz (1 bit):** A bit that specifies whether horizontal scrolling is synchronized across multiple windows displaying this sheet. + +**K - fSyncVert (1 bit):** A bit that specifies whether vertical scrolling is synchronized across multiple windows displaying this sheet. + +**L - fAltExprEval (1 bit):** A bit that specifies whether the sheet uses [**transition formula evaluation**](#gt_47a54c6a-a541-44ae-a0a9-acf78ab8a331). + +**M - fAltFormulaEntry (1 bit):** A bit that specifies whether the sheet uses [**transition formula entry**](#gt_fd2c615c-ad67-4b97-bde4-7827b37196eb). + +### XCT + +The **XCT** record specifies the beginning of an [external cell cache](#Section_b985d1a223f3483ebebdbd0e882d4c89) and that specifies the beginning of a collection of [CRN](#crn) records as defined in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of CRN records specifies the values of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the external cell cache. + +[TABLE] + +**ccrn (2 bytes):** A signed integer of which the absolute value specifies the number of CRN records immediately following this record. A value less than zero specifies that the most recent [SupBook](#supbook) preceding this record contains a link that is not valid. + +**itab (2 bytes):** An unsigned integer that specifies a zero-based index into the **rgst** array of the most recent instance of a SupBook preceding this record in the file. The element of the **rgst** array specified by this field contains the name of the sheet that contains the cached cells. The value of **itab** MUST be less than the value of the **ctab** field of the most recent instance of SupBook. + +### XF + +The **XF** record specifies formatting properties for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) or a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7). + +[TABLE] + +**ifnt (2 bytes):** A [FontIndex](#fontindex) structure that specifies a [Font](#font) record. + +**ifmt (2 bytes):** An [IFmt](#ifmt) structure that specifies a [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) identifier. + +**A - fLocked (1 bit):** A bit that specifies whether the [**locked protection**](#gt_10f1ec97-0464-49da-bf78-5339b9d3520c) property is set to true. + +**B - fHidden (1 bit):** A bit that specifies whether the [**hidden protection**](#gt_1b14d877-9a96-485f-8eb8-b2c26f3355cf) property is set to true. + +**C - fStyle (1 bit):** A bit that specifies whether this record specifies a [cell XF](#Section_518a740d71c640c8bb97e7df6915861a) or a [cell style XF](#Section_3d5348ded9df4c31b1fd9f9377273152). If the value is 1, this record specifies a cell style XF. + +**D - f123Prefix (1 bit):** A bit that specifies whether prefix characters are present in the cell. The possible prefix characters are single quote (0x27), double quote (0x22), caret (0x5E), and backslash (0x5C).[\<146\>](#Appendix_A_146) If **fStyle** equals 1, this field MUST equal 0. + +**ixfParent (12 bits):** An unsigned integer that specifies the zero-based index of a cell style XF record in the collection of XF records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) that this cell format inherits properties from. Cell style XF records are the subset of XF records with an **fStyle** field equal to 1. See [XFIndex](#xfindex) for more information about the organization of XF records in the file. + +If **fStyle** equals 1, this field SHOULD equal 0xFFF, indicating there is no inheritance from a cell style XF. [\<147\>](#Appendix_A_147) + +**Data (variable):** If the value of **fStyle** equals 0, this field contains a [CellXF](#cellxf) that specifies additional properties of the cell XF. If the value of **fStyle** equals 1, this field contains a [StyleXF](#stylexf) that specifies additional properties of the cell style XF. + +### XFCRC + +The **XFCRC** record specifies the number of [XF](#xf) records contained in this file and that contains a [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the data in those records. This record MUST exist if and only if there are [XFExt](#xfext) records in the file. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x87C. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**cxfs (2 bytes):** An unsigned integer that specifies the number of XF records in this file. MUST be greater than or equal to 16 and less than or equal to 4050. + +**crc (4 bytes):** An unsigned integer that specifies a checksum, as specified by [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.4.3, of the data portion of the XF records. This checksum is used to detect whether the XF records in the file were modified by an application that does not support the formatting feature extensions in XFExt records. + +### XFExt + +The **XFExt** record specifies a set of formatting property extensions to an [XF](#xf) record in this file. + +[TABLE] + +**frtHeader (12 bytes):** An [FrtHeader](#frtheader) structure. The **frtHeader.rt** field MUST be 0x087D. + +**reserved1 (2 bytes):** MUST be zero and MUST be ignored. + +**ixfe (2 bytes):** An [XFIndex](#xfindex) structure that specifies the XF record in the file that this record extends. MUST be less than or equal to 4050. + +**reserved2 (2 bytes):** MUST be zero and MUST be ignored. + +**cexts (2 bytes):** An unsigned integer that specifies the number of elements in **rgExt.** + +**rgExt (variable):** An array of [ExtProp](#extprop). Each array element specifies a formatting property extension. + +### YMult + +The **YMult** record specifies properties of the value multiplier for a value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) and that specifies the beginning of a collection of records as defined by the [Chart Sheet substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The collection of records specifies a [**display units**](#gt_7d807b62-cff1-4e03-a73f-840844345b83) label. + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold) structure. The **frtHeaderOld.rt** field MUST be 0x0857. + +**axmid (2 bytes):** A signed integer that specifies the axis multiplier type. MUST be a value from the following table: + +| Value | Multiplier type | +|----|----| +| 0xFFFF (-1) | Custom multiplier, multiplier value MUST be stored in **numLabelMultiplier** | +| 0x0000 | Values on axis are multiplied by 1.0 | +| 0x0001 | Values on axis are multiplied by 100.0 | +| 0x0002 | Values on axis are multiplied by 1000.0 | +| 0x0003 | Values on axis are multiplied by 10,000.0 | +| 0x0004 | Values on axis are multiplied by 100,000.0 | +| 0x0005 | Values on axis are multiplied by 1,000,000.0 | +| 0x0006 | Values on axis are multiplied by 10,000,000.0 | +| 0x0007 | Values on axis are multiplied by 100,000,000.0 | +| 0x0008 | Values on axis are multiplied by 1,000,000,000.0 | +| 0x0009 | Values on axis are multiplied by 1,000,000,000,000.0 | + +**numLabelMultiplier (8 bytes):** An Xnum (section [2.5.342](#xnum)) structure that specifies a custom multiplier. The value on the axis are multiplied by the value of this field. MUST be greater than 0.0. If **axmid** is set to a value other than 0xFFFF, this field is ignored. + +**A - reserved1 (1 bit):** MUST be 1, and MUST be ignored. + +**B - fAutoShowMultiplier (1 bit):** A bit that specifies whether the display units label is displayed. + +**C - fBeingEditted (1 bit):** A bit that specifies whether the display units label is currently being edited. + +**reserved2 (13 bits):** MUST be zero, and MUST be ignored. + +## Structures + +### AddinUdf + +The **AddinUdf** structure specifies the data for a [**UDF**](#gt_5068e37f-372c-41df-9357-1072e12ed970) reference on an [**XLL**](#gt_3d6e3f45-91e7-46d5-871c-0b2fde20b5f5) or [**COM**](#gt_ef2ebebc-1760-407a-9ace-af48f9050e02) [**add-in**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6) in the [ExternName](#externname) record. + +[TABLE] + +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +**udfName (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) that specifies the name of the referenced UDF. **udfName.cch** MUST be less than or equal to 255. For COM [**add-in functions**](#gt_19f0478a-919a-4951-b8c0-f9900a1ddd3e) only, it also specifies the [**ProgID**](#gt_06b2ae3d-4106-49f3-9ca0-e2bcd649e75a) of the COM object that implements the add-in function (XLL add-in functions do not have their implementing libraries uniquely specified). + +**cb (2 bytes):** An unsigned integer that specifies the size of **unused** in bytes. + +**unused (variable):** Undefined and MUST be ignored. The size of this field in bytes is specified by **cb**. + +### AF12CellIcon + +The **AF12CellIcon** structure specifies the [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) for an advanced [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) comparison. + +[TABLE] + +**iIconSet (4 bytes):** An unsigned integer that specifies the [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9) number. MUST be a value as specified in [KPISets](#kpisets). + +**iIcon (4 bytes):** An unsigned integer that specifies the icon number within the icon set. MUST be a value as specified in the following table: + +| iIconSet value | Valid iIcon values | +|----|----| +| KPINIL (no icon) | 0xFFFFFFFF | +| KPI3ARROWS | 0x00000000, 0x00000001, or 0x00000002 | +| KPI3ARROWSGRAY | 0x00000000, 0x00000001, or 0x00000002 | +| KPI3FLAGS | 0x00000000, 0x00000001, or 0x00000002 | +| KPI3TRAFFICLIGHTS1 | 0x00000000, 0x00000001, or 0x00000002 | +| KPI3TRAFFICLIGHTS2 | 0x00000000, 0x00000001, or 0x00000002 | +| KPI3SIGNS | 0x00000000, 0x00000001, or 0x00000002 | +| KPI3SYMBOLS | 0x00000000, 0x00000001, or 0x00000002 | +| KPI3SYMBOLS2 | 0x00000000, 0x00000001, or 0x00000002 | +| KPI4ARROWS | 0x00000000, 0x00000001, 0x00000002, or 0x00000003 | +| KPI4ARROWSGRAY | 0x00000000, 0x00000001, 0x00000002, or 0x00000003 | +| KPI4REDTOBLACK | 0x00000000, 0x00000001, 0x00000002, or 0x00000003 | +| KPI4RATING | 0x00000000, 0x00000001, 0x00000002, or 0x00000003 | +| KPI4TRAFFICLIGHTS | 0x00000000, 0x00000001, 0x00000002, or 0x00000003 | +| KPI5ARROWS | 0x00000000, 0x00000001, 0x00000002, 0x00000003, or 0x00000004 | +| KPI5ARROWSGRAY | 0x00000000, 0x00000001, 0x00000002, 0x00000003, or 0x00000004 | +| KPI5RATING | 0x00000000, 0x00000001, 0x00000002, 0x00000003, or 0x00000004 | +| KPI5QUARTERS | 0x00000000, 0x00000001, 0x00000002, 0x00000003, or 0x00000004 | + +### AF12Criteria + +The **AF12Criteria** structure specifies the criteria for an advanced [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) comparison. + +[TABLE] + +**doper (10 bytes):** An [AFDOper](#afdoper) that specifies the comparison condition. + +**str (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) that specifies the string value to use for the comparison. MUST exist if and only if **doper.vt** equals 0x06. The length MUST be equal to **doper.vtValue.cch**. + +### AF12DateInfo + +The **AF12DateInfo** structure specifies the date and time for an advanced [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) comparison. + +[TABLE] + +**year (2 bytes):** An unsigned integer that specifies the year. + +**month (2 bytes):** An unsigned integer that specifies the month. MUST be greater than or equal to 1 and less than or equal to 12. + +**day (4 bytes):** An unsigned integer that specifies the day of the month. MUST be greater than or equal to 1[\<148\>](#Appendix_A_148) and less than or equal to 31. + +**hour (2 bytes):** An unsigned integer that specifies the hour. MUST be greater than or equal to 0 and less than or equal to 23. + +**minute (2 bytes):** An unsigned integer that specifies the minute. MUST be greater than or equal to 0 and less than or equal to 59. + +**second (2 bytes):** An unsigned integer that specifies the second. MUST be greater than or equal to 0 and less than or equal to 59. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**nodeType (4 bytes):** An unsigned integer that specifies the date and time to filter on. MUST be one of the values from the table: + +| Value | Meaning | +|----|----| +| 0x00000000 | [**Filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) on **year** field. | +| 0x00000001 | Filter on **year** and **month** fields. | +| 0x00000002 | Filter on **year, month,** and **day** fields. | +| 0x00000003 | Filter on **year, month, day,** and **hour** fields. | +| 0x00000004 | Filter on **year, month, day, hour,** and **minute** fields. | +| 0x00000005 | Filter on **year, month, day, hour, minute,** and **second** fields. | + +### AFDOper + +The **AFDOper** structure specifies an [AutoFilter](#autofilter) data operation. + +[TABLE] + +**vt (1 byte):** An unsigned integer that specifies the type of comparison. MUST be a value as specified in the table listed under **vtValue**. If this structure is part of an [AutoFilter12](#autofilter12) record, the value of **vt** MUST NOT be 0x02. + +**grbitSign (1 byte):** An unsigned integer that specifies the comparison operation between a [**cell value**](#gt_4d48a886-7f1d-4d41-a668-54f7f2f1a966) and **vtValue**. MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x01 | [**Cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) value is displayed if it is less than the value specified in **vtValue.** | +| 0x02 | Cell value is displayed if it is equal to the value specified in **vtValue**. | +| 0x03 | Cell value is displayed if it is less than or equal to the value specified in **vtValue**. | +| 0x04 | Cell value is displayed if it is greater than the value specified in **vtValue.** | +| 0x05 | Cell value is displayed if it is not equal to the value specified in **vtValue.** | +| 0x06 | Cell value is displayed if it is greater than or equal to the value specified in **vtValue.** | + +If **vt** is equal to 0x00, this field is undefined and MUST be ignored. + +**vtValue (8 bytes):** A variable type field whose type and meaning is dictated by the value of **vt**, as specified in the following table: + +| Value of vt | Meaning of vtValue | +|----|----| +| 0x00 | **vtValue** is 8 bytes which are undefined and MUST be ignored. | +| 0x02 | **vtValue** is an [AFDOperRk](#afdoperrk) that specifies a numeric value. MUST exist if and only if this structure is part of an AutoFilter record. | +| 0x04 | **vtValue** is an Xnum (section [2.5.342](#xnum)) that specifies a numeric value. | +| 0x06 | **vtValue** is an [AFDOperStr](#afdoperstr) that specifies a string value. | +| 0x08 | **vtValue** is an [AFDOperBoolErr](#afdoperboolerr) that specifies a Boolean or error value. | +| 0x0C | All blanks are matched. **vtValue** is 8 bytes which are reserved, MUST be 0, and MUST be ignored. | +| 0x0E | All non-blanks are matched. **vtValue** is 8 bytes which are reserved, MUST be 0, and MUST be ignored. | + +### AFDOperBoolErr + +The **AFDOperBoolErr** structure specifies a Boolean or error value for an [AutoFilter](#autofilter) comparison. + +[TABLE] + +**bes (2 bytes):** A [Bes](#bes) that specifies the Boolean or error value. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +### AFDOperRk + +The **AFDOperRk** structure specifies a numeric value for an [AutoFilter](#autofilter) comparison. + +[TABLE] + +**rk (4 bytes):** An [RkNumber](#rknumber) that specifies a numeric value. + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +### AFDOperStr + +The **AFDOperStr** structure specifies a string value for an [AutoFilter](#autofilter) comparison. The string location is specified by the record or structure that contains this structure. + +A question mark character (‘?’) in the string specifies a matching condition on any single character. An asterisk character (‘\*’) in the string specifies a matching condition on a sequence of zero or more characters. + +[TABLE] + +**unused1 (4 bytes):** Undefined and MUST be ignored. MUST exist if and only if this structure is part of an AutoFilter, a [Feature11](#feature11) or a [Feature12](#feature12) record. + +**cch (1 byte):** An unsigned integer that specifies the number of characters in the string. MUST be greater than or equal to 1. + +**fCompare (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether the string comparison contains question mark or asterisk characters. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | String comparison contains question mark or asterisk characters. | +| 1 | String comparison does not contain question mark or asterisk characters. | + +**reserved1 (1 byte):** MUST be zero, and MUST be ignored. + +**unused2 (1 byte):** Undefined and MUST be ignored. + +**unused3 (4 bytes):** Undefined and MUST be ignored. MUST exist if and only if this structure is part of an [AutoFilter12](#autofilter12). + +### AutoFmt8 + +The **AutoFmt8** enumeration specifies the following auto formatting styles[\<149\>](#Appendix_A_149). + +| Name | Value | Meaning | +|-------------------------|--------|-----------------| +| **XL8_ITBLSIMPLE** | 0x0000 | Simple | +| **XL8_ITBLCLASSIC1** | 0x0001 | Classic 1 | +| **XL8_ITBLCLASSIC2** | 0x0002 | Classic 2 | +| **XL8_ITBLCLASSIC3** | 0x0003 | Classic 3 | +| **XL8_ITBLACCOUNTING1** | 0x0004 | Accounting 1 | +| **XL8_ITBLACCOUNTING2** | 0x0005 | Accounting 2 | +| **XL8_ITBLACCOUNTING3** | 0x0006 | Accounting 3 | +| **XL8_ITBLACCOUNTING4** | 0x0007 | Accounting 4 | +| **XL8_ITBLCOLORFUL1** | 0x0008 | Colorful 1 | +| **XL8_ITBLCOLORFUL2** | 0x0009 | Colorful 2 | +| **XL8_ITBLCOLORFUL3** | 0x000A | Colorful 3 | +| **XL8_ITBLLIST1** | 0x000B | List 1 | +| **XL8_ITBLLIST2** | 0x000C | List 2 | +| **XL8_ITBLLIST3** | 0x000D | List 3 | +| **XL8_ITBL3DEFFECTS1** | 0x000E | 3Deffects 1 | +| **XL8_ITBL3DEFFECTS2** | 0x000F | 3Deffects 2 | +| **XL8_ITBLNONE_GEN** | 0x0010 | None | +| **XL8_ITBLJAPAN2** | 0x0011 | Japan 2 | +| **XL8_ITBLJAPAN3** | 0x0012 | Japan 3 | +| **XL8_ITBLJAPAN4** | 0x0013 | Japan 4 | +| **XL8_ITBLNONE_JPN** | 0x0014 | Japan None | +| **XL8_ITBLREPORT1** | 0x1000 | Report 1 | +| **XL8_ITBLREPORT2** | 0x1001 | Report 2 | +| **XL8_ITBLREPORT3** | 0x1002 | Report 3 | +| **XL8_ITBLREPORT4** | 0x1003 | Report 4 | +| **XL8_ITBLREPORT5** | 0x1004 | Report 5 | +| **XL8_ITBLREPORT6** | 0x1005 | Report 6 | +| **XL8_ITBLREPORT7** | 0x1006 | Report 7 | +| **XL8_ITBLREPORT8** | 0x1007 | Report 8 | +| **XL8_ITBLREPORT9** | 0x1008 | Report 9 | +| **XL8_ITBLREPORT10** | 0x1009 | Report 10 | +| **XL8_ITBLTABLE1** | 0x100A | Table 1 | +| **XL8_ITBLTABLE2** | 0x100B | Table 2 | +| **XL8_ITBLTABLE3** | 0x100C | Table 3 | +| **XL8_ITBLTABLE4** | 0x100D | Table 4 | +| **XL8_ITBLTABLE5** | 0x100E | Table 5 | +| **XL8_ITBLTABLE6** | 0x100F | Table 6 | +| **XL8_ITBLTABLE7** | 0x1010 | Table 7 | +| **XL8_ITBLTABLE8** | 0x1011 | Table 8 | +| **XL8_ITBLTABLE9** | 0x1012 | Table 9 | +| **XL8_ITBLTABLE10** | 0x1013 | Table 10 | +| **XL8_ITBLPTCLASSIC** | 0x1014 | Table PTClassic | +| **XL8_ITBLPTNONE** | 0x1015 | None | + +### Bes + +The **Bes** structure specifies either a Boolean (section [2.5.14](#boolean)) value or an error value. **bBoolErr** specifies the value and **fError** specifies the value’s type. + +[TABLE] + +**bBoolErr (1 byte):** An unsigned integer that specifies either a Boolean value or an error value, depending on the value of **fError**. + +A Boolean value MUST be a value from the following table: + +| Value | Meaning | +|-------|---------| +| 0x00 | False | +| 0x01 | True | + +An error value MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------| +| 0x00 | \#NULL! | +| 0x07 | \#DIV/0! | +| 0x0F | \#VALUE! | +| 0x17 | \#REF! | +| 0x1D | \#NAME? | +| 0x24 | \#NUM! | +| 0x2A | \#N/A | +| 0x2B | \#GETTING_DATA | + +**fError (1 byte):** A Boolean that specifies whether **bBoolErr** contains an error code or a Boolean value. MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------------------------| +| 0x00 | bBoolErr SHOULD[\<150\>](#Appendix_A_150) contain a Boolean value. | +| 0x01 | bBoolErr contains an error value. | + +### Bold + +The **Bold** enumeration specifies the [**font face weight**](#gt_8fd5e2d4-bd9a-48f2-ba16-42d23697508c). + +| Name | Value | Meaning | +|---------------|--------|--------------------| +| **BLSNORMAL** | 0x0190 | Normal font weight | +| **BLSBOLD** | 0x02BC | Bold font weight | + +### BookExt_Conditional11 + +The **BookExt_Conditional11** structure specifies two properties of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +[TABLE] + +**A - fBuggedUserAboutSolution (1 bit):** A bit that specifies whether a warning is requested before loading a [**manifest**](#gt_d1a20cdc-cced-44de-a041-857fb9054856) that is a [**smart document**](#gt_cc9fe152-6a63-4555-91f1-1543ff84035d). + +**B - fShowInkAnnotation (1 bit):** A bit that specifies whether [**ink**](#gt_9fcdd1d5-3563-49b9-8a2e-bf696fb08fd0) [**comments**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) are visible in this workbook. + +**unused (6 bits):** Undefined and MUST be ignored. + +### BookExt_Conditional12 + +The **BookExt_Conditional12** structure specifies [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) related information. + +[TABLE] + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - fPublishedBookItems (1 bit):** A bit that specifies whether only specific [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) items, including [**defined names**](#gt_5bb97b28-4adc-48ec-b544-02542753a933), [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7), [chart](#chart-2) object and [PivotTables](#Section_a5f57198f2af40b2ba07e4b1836d73f3), are shown when the workbook is published to a server. + +[TABLE] + +**C - fShowPivotChartFilter (1 bit):** A bit that specifies whether to show the [**PivotChart filter pane**](#gt_90f8a2d5-5501-4b3c-9186-f59b26b97f16). + +**reserved2 (5 bits):** MUST be zero, and MUST be ignored. + +### Boolean + +An unsigned integer greater than 1 bit in size that specifies a Boolean value. MUST be a value from the following table. All other bits in the field MUST be 0. + +| Value | Meaning | +|-------|---------------------| +| 0x0 | Boolean value FALSE | +| 0x1 | Boolean value TRUE | + +### BorderStyle + +The **BorderStyle** enumeration specifies the border line [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633). + +| Name | Value | Meaning | +|----|----|----| +| **NONE** | 0x0000 | No [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) | +| **THIN** | 0x0001 | Thin line | +| **MEDIUM** | 0x0002 | Medium line | +| **DASHED** | 0x0003 | Dashed line | +| **DOTTED** | 0x0004 | Dotted line | +| **THICK** | 0x0005 | Thick line | +| **DOUBLE** | 0x0006 | Double line | +| **HAIR** | 0x0007 | Hairline | +| **MEDIUMDASHED** | 0x0008 | Medium dashed line | +| **DASHDOT** | 0x0009 | Dash-dot line | +| **MEDIUMDASHDOT** | 0x000A | Medium dash-dot line | +| **DASHDOTDOT** | 0x000B | Dash-dot-dot line | +| **MEDIUMDASHDOTDOT** | 0x000C | Medium dash-dot-dot line | +| **SLANTDASHDOT** | 0x000D | Slanted dash-dot-dot line | + +### BuiltInStyle + +The **BuiltInStyle** structure specifies the type of a built**-**in [cell style](#Section_f9425d3f127545be8389bf80f65b56b7). For [**row outline**](#gt_b5d24145-1614-4e62-b4dd-96f1af5e76fe) and [**column outline**](#gt_56df9ab8-ed36-41fc-9522-4d23740e0901) types this structure also specifies the [**outline level**](#gt_a5cd5eff-ddeb-490b-bc71-f6256774e3c3) of the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633). + +[TABLE] + +**istyBuiltIn (1 byte):** An unsigned integer that specifies the type of the built-in cell style. SHOULD be a value from the list of built in cell styles specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1: Fundamentals And Markup Language Reference, section 18.8.7.[\<151\>](#Appendix_A_151) + +**iLevel (1 byte):** An unsigned integer that specifies the depth level of row/column automatic outlining. If **istyBuiltIn** equals 0x01 or 0x02, this value MUST be one of the following: + +| Value | Meaning | +|-------|--------------------| +| 0x00 | Outline level is 1 | +| 0x01 | Outline level is 2 | +| 0x02 | Outline level is 3 | +| 0x03 | Outline level is 4 | +| 0x04 | Outline level is 5 | +| 0x05 | Outline level is 6 | +| 0x06 | Outline level is 7 | + +Otherwise, this value MUST be 0xFF and MUST be ignored. + +### CachedDiskHeader + +The **CachedDiskHeader** structure specifies the formatting information of a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) column heading. + +[TABLE] + +**cbdxfHdrDisk (4 bytes):** An unsigned integer that specifies the size, in bytes, of the **rgHdrDisk** field. + +**rgHdrDisk (variable):** A [DXFN12List](#dxfn12list) structure that specifies the formatting of the column heading. + +**strStyleName (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the name of the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) to use for the column heading. The name of the style MUST equal the **user** field of a [Style](#style) record in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), or the name of a built-in style, as specified by the [BuiltInStyle](#builtinstyle) record. This field is present only if the **fSaveStyleName** field of the containing [Feat11FieldDataItem](#feat11fielddataitem) structure is set to 0x1. + +If present, the formatting as specified by **strStyleName** is applied first, before the formatting as specified by **rgHdrDisk** is applied. + +### Cch255 + +A 2 byte unsigned integer that specifies a string size in characters. + +The value 0xFFFF specifies that the string is NULL. + +The value MUST be 0xFFFF or less than or equal to 0x00FF. + +### Cell + +The **Cell** structure specifies a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rw (2 bytes):** An [Rw](#rw) that specifies the row. + +**col (2 bytes):** A [Col](#col) that specifies the column. + +**ixfe (2 bytes):** An [IXFCell](#ixfcell) that specifies the [XF](#xf) record. + +### CellXF + +This structure specifies formatting properties for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +[TABLE] + +**alc (3 bits):** A [**HorizAlign**](#horizalign) that specifies the [**horizontal alignment**](#gt_f0e60ca8-51d5-4553-9126-3d89a4d08f90). + +**A - fWrap (1 bit):** A bit that specifies whether the cell text is wrapped. + +**alcV (3 bits):** A [**VertAlign**](#vertalign) that specifies the [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878). + +**B - fJustLast (1 bit):** A bit that specifies whether the justified or distributed alignment of the cell is used on the last line of text (setting this to 1 is typical for East Asian text but not typical in other contexts). If this field equals 1, then **alc** MUST equal 7. + +**trot (1 byte):** An [XFPropTextRotation](#xfproptextrotation) that specifies the text rotation. + +**cIndent (4 bits):** An unsigned integer that specifies the text [**indentation level**](#gt_2779d3df-3c50-44dc-9d2d-6996c4573aa9). MUST be less than or equal to 15. + +**C - fShrinkToFit (1 bit):** A bit that specifies whether the cell is [**shrink to fit**](#gt_4740d2ef-00d3-4a29-983c-b7b3a6aa01e0). + +**D - reserved1 (1 bit):** MUST be 0, and MUST be ignored. + +**E - iReadOrder (2 bits):** A [**ReadingOrder**](#readingorder) that specifies the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361). + +**F - reserved2 (2 bits):** MUST be 0, and MUST be ignored. + +**G - fAtrNum (1 bit):** A bit that specifies that if the **ifmt** field of the [XF](#xf) record specified by the **ixfParent** field of the containing XF record is updated, the corresponding field of the containing XF record will not be set to the same value. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The **ifmt** field of the containing XF record is updated when the corresponding field of the XF record specified by the **ixfParent** field of the containing XF record is changed. | +| 0x1 | The **ifmt** field of the containing XF record is not updated when the corresponding field of the XF record specified by the **ixfParent** field of the containing XF record is changed. | + +**H - fAtrFnt (1 bit):** A bit that specifies that if the **ifnt** field of the XF record specified by the **ixfParent** field of the containing XF record is updated, the corresponding field of the containing XF record will not be set to the same value. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The **ifnt** field of the containing XF record is updated when the corresponding field of the XF record specified by the **ixfParent** field of the containing XF record is changed. | +| 0x1 | The **ifnt** field of the containing XF record is not updated when the corresponding field of the XF record specified by the **ixfParent** field of the containing XF record is changed. | + +**I - fAtrAlc (1 bit):** A bit that specifies that if the **alc** field, or the **fWrap** field, or the alcV field, or the fJustLast field, or the trot field, or the cIndent field, or the fShrinkToFit field or the iReadOrder field of the XF record specified by the **ixfParent** field of the containing XF record is updated, the corresponding fields of this structure will not be set to the same values. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The **alc**, **fWrap**, alcV, fJustLast, trot, cIndent, fShrinkToFit, iReadOrder fields are updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | +| 0x1 | The **alc**, **fWrap**, alcV, fJustLast, trot, cIndent, fShrinkToFit, iReadOrder fields are not updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | + +**J - fAtrBdr (1 bit):** A bit that specifies that if the **dgLeft** field, or the **dgRight** field, or the **dgTop** field, or the **dgBottom** field, or the **dgDiag** field, or the **icvLeft** field, or the **icvRight** field, or the **grbitDiag** field, or the **icvTop** field, or the **icvBottom** field, or the **icvDiag** field of the XF record specified by the **ixfParent** field of the containing XF record is updated, the corresponding fields of this structure will not be set to the same values. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The **dgLeft**, **dgRight**, **dgTop**, **dgBottom**, **dgDiag**, **icvLeft**, **icvRight**, **grbitDiag**, **icvTop**, **icvBottom**, **icvDiag** fields are updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | +| 0x1 | The **dgLeft**, **dgRight**, **dgTop**, **dgBottom**, **dgDiag**, **icvLeft**, **icvRight**, **grbitDiag**, **icvTop**, **icvBottom**, **icvDiag** fields are not updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | + +**K - fAtrPat (1 bit):** A bit that specifies that if the **fls** field, the **icvFore** field, or the **icvBack** field of the XF record specified by the **ixfParent** field of the containing XF record is updated, the corresponding fields of this structure will not be set to the same values. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The **fls**, **icvFore**, and **icvBack** fields are updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | +| 0x1 | The **fls**, **icvFore**, and **icvBack** fields are not updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | + +**L - fAtrProt (1 bit):** A bit that specifies that if the **fLocked** field or the **fHidden** field of the XF record specified by the **ixfParent** field of the containing XF record is updated, the corresponding fields of the containing XF record will not be set to the same values. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The **fLocked** and **fHidden** fields of the containing XF record are updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | +| 0x1 | The **fLocked** and **fHidden** fields of the containing XF record are not updated when the corresponding fields of the XF record specified by the **ixfParent** field of the containing XF record are changed. | + +**dgLeft (4 bits):** A [BorderStyle](#borderstyle) that specifies the [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad). + +**dgRight (4 bits):** A BorderStyle that specifies the [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) border formatting. + +**dgTop (4 bits):** A BorderStyle that specifies the top border formatting. + +**M - dgBottom (4 bits):** A BorderStyle that specifies the bottom border formatting. + +**icvLeft (7 bits):** An unsigned integer that specifies the color of the logical left [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c). The value MUST be one of the values specified in [IcvXF](#icvxf) or 0. A value of 0 means the logical left border color has not been specified. If this value is 0, then **dgLeft** MUST also be 0. + +**icvRight (7 bits):** An unsigned integer that specifies the color of the logical right border. The value MUST be one of the values specified in IcvXF or 0. A value of 0 means the logical right border color has not been specified. If this value is 0, then **dgRight** MUST also be 0. + +**N - grbitDiag (2 bits):** An unsigned integer that specifies which diagonal borders are present (if any). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | No diagonal border | +| 0x1 | [**Diagonal-down**](#gt_494c0660-9ece-4dcc-b8d3-1a5616a57782) border | +| 0x2 | [**Diagonal-up**](#gt_d4878a4d-c65e-471d-b9fb-da7a5a5aa929) border | +| 0x3 | Both diagonal-down and diagonal-up | + +**icvTop (7 bits):** An unsigned integer that specifies the color of the top border. The value MUST be one of the values specified in IcvXF or 0. A value of 0 means the top border color has not been specified. If this value is 0, then **dgTop** MUST also be 0. + +**icvBottom (7 bits):** An unsigned integer that specifies the color of the bottom border. The value MUST be one of the values specified in IcvXF or 0. A value of 0 means the bottom border color has not been specified. If this value is 0 then **dgBottom** MUST also be 0. + +**icvDiag (7 bits):** An unsigned integer that specifies the color of the diagonal border. The value MUST be one of the values specified in IcvXF or 0. A value of 0 means the diagonal border color has not been specified. If this value is 0 then **dgDiag** MUST also be 0. + +**dgDiag (4 bits):** A BorderStyle that specifies the diagonal border formatting. + +**O - fHasXFExt (1 bit):** A bit that specifies whether an [XFExt](#xfext) will extend the information in this XF. + +**fls (6 bits):** A [**FillPattern**](#fillpattern) that specifies the [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e). If this value is 1, which specifies a solid fill pattern, then only **icvFore** is rendered. + +**icvFore (7 bits):** An IcvXF that specifies the [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) of the fill pattern. + +**icvBack (7 bits):** An unsigned integer that specifies the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) of the fill pattern. The value SHOULD[\<152\>](#Appendix_A_152) be an IcvXF value. + +**P - fsxButton (1 bit):** A bit that specifies whether the XF record is attached to a pivot field drop-down button. + +**Q - reserved3 (1 bit):** MUST be 0 and MUST be ignored. + +### CFColor + +The **CFColor** structure specifies a color in [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) records or in a [SheetExt](#sheetext) record. + +[TABLE] + +**xclrType (4 bytes):** An [**XColorType**](#xcolortype) that specifies the type of color reference. MUST be different from XCLRNINCHED. MUST be different from XCLRAUTO unless it is contained in a SheetExt record. + +**xclrValue (4 bytes):** A structure that specifies the color value. The type of structure depends on the color reference type specified by **xclrType** and MUST be a structure from the following table: + +| Value of xclrType | Type | +|-------------------|-------------------------------------------------| +| XCLRAUTO | Ignored | +| XCLRINDEXED | [ColorICV](#coloricv) | +| XCLRRGB | [LongRGBA](#longrgba)[\<153\>](#Appendix_A_153) | +| XCLRTHEMED | [ColorTheme](#colortheme) | + +**numTint (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the tint and [**shade**](#gt_46cefc61-d599-4408-bd6c-9c3dec0c1db4) value to be applied to the color. MUST be greater than or equal to -1.0 and less than or equal to 1.0 + +### CFDatabar + +The **CFDatabar** structure specifies the parameters of a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule that uses [**data bar**](#gt_d8d5ab5a-ebee-45a3-bd11-2a5779bb54ed) formatting. + +[TABLE] + +**unused (2 bytes):** Undefined and MUST be ignored. + +**reserved1 (1 byte):** MUST be zero and MUST be ignored. + +**A - fRightToLeft (1 bit):** A bit that specifies whether the data bars are drawn starting from the right of the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). MUST be a value from the following table: + +| **Value** | **Meaning** | +|:----------|:--------------------------------------------------------| +| 0x0 | Data bars are drawn starting from the left of the cell | +| 0x1 | Data bars are drawn starting from the right of the cell | + +**B - fShowValue (1 bit):** A bit that specifies whether the numerical value of the cell appears in the cell along with the data bar. + +**reserved2 (6 bits):** MUST be zero and MUST be ignored. + +**iPercentMin (1 byte):** An unsigned integer that specifies the length of a data bar, as a percentage of the cell width, that is applied to cells with values equal to the [CFVO](#cfvo) value specified by **cfvoDB1**. MUST be less than or equal to 100. + +**iPercentMax (1 byte):** An unsigned integer that specifies the length of a data bar, as a percentage of the cell width, that is applied to cells with values equal to the CFVO value specified by **cfvoDB2**. MUST be greater than **iPercentMin** and less than or equal to 100. + +**color (16 bytes):** A [CFColor](#cfcolor) structure that specifies the color of the data bar. + +**cfvoDB1 (variable):** A CFVO that specifies the maximum [**cell value**](#gt_4d48a886-7f1d-4d41-a668-54f7f2f1a966) that will be represented with a minimum width data bar. All cell values that are less than or equal to the CFVO value specified by this field are represented with a data bar of **iPercentMin** percent of the cell width. + +**cfvoDB2 (variable):** A CFVO that specifies the minimum cell value that will be represented with a maximum width data bar. All cell values that are greater than or equal to the CFVO value specified by this field are represented with a data bar of **iPercentMax** percent of the cell width. + +### CFExAveragesTemplateParams + +This structure specifies the parameters for an above or below average [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule in a containing [CF12](#cf12) record or [CFExNonCF12](#cfexnoncf12) structure. + +[TABLE] + +**iParam (2 bytes):** An unsigned integer that specifies the number of standard deviations above or below the average for the rule. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The threshold is not offset by a multiple of the standard deviation. | +| 0x0001 | The threshold is offset by 1 standard deviation. | +| 0x0002 | The threshold is offset by 2 standard deviations. | + +**reserved (14 bytes):** MUST be zero and MUST be ignored. + +### CFExDateTemplateParams + +The **CFExDateTemplateParams** structure specifies parameters for the date-related [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules specified by a [CF12](#cf12) record or [CFExNonCF12](#cfexnoncf12) structure. + +[TABLE] + +**dateOp (2 bytes):** An unsigned integer that specifies the type of date comparison. The value of this field MUST be equal to the value that corresponds to the **icfTemplate** field in the containing CF12 record or CFExNonCF12 structure, according to the following table: + +| Value of icfTemplate | Value of this field | +|----------------------|---------------------| +| 15 | 0 | +| 16 | 6 | +| 17 | 1 | +| 18 | 2 | +| 19 | 5 | +| 20 | 8 | +| 21 | 3 | +| 22 | 7 | +| 23 | 4 | +| 24 | 9 | + +**reserved (14 bytes):** MUST be zero and MUST be ignored. + +### CFExDefaultTemplateParams + +This structure specifies that there are no parameters for extensions to [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules specified by [CFEx](#cfex). + +[TABLE] + +**unused (16 bytes):** Undefined and MUST be ignored. + +### CFExFilterParams + +The **CFExFilterParams** structure specifies parameters for a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule of type [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). + +[TABLE] + +**A - fTop (1 bit):** A bit that specifies whether the top or bottom items are displayed with the conditional formatting. MUST be one of the following values: + +| Value | Meaning | +|-------|------------------------------------------------------------| +| 0x0 | Bottom items are displayed with the conditional formatting | +| 0x1 | Top items are displayed with the conditional formatting | + +**B - fPercent (1 bit):** A bit that specifies whether a percentage of the top or bottom items are displayed with the conditional formatting, or whether a set number of the top or bottom items are displayed with the conditional formatting. MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x0 | A set number of top or bottom items, specified by **iParam,** are displayed with the conditional formatting. | +| 0x1 | A percentage of top or bottom items, specified by **iParam,** are displayed with the conditional formatting | + +**reserved1 (6 bits):** MUST be zero and MUST be ignored. + +**iParam (2 bytes):** An unsigned integer that specifies how many values are displayed with the conditional formatting. If **fPercent** equals 1 then this field represents a percent and MUST be less than or equal to 100. Otherwise, this field represents a set number of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and MUST be less than or equal to 1000. + +**reserved2 (13 bytes):** MUST be zero and MUST be ignored. + +### CFExNonCF12 + +The **CFExNonCF12** structure specifies properties that extend a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule that is specified by a [CF](#cf) record. + +[TABLE] + +**icf (2 bytes):** An unsigned integer that specifies a zero-based index of a CF record in the collection of CF records directly following the [CondFmt](#condfmt) record that is referenced by the parent [CFEx](#cfex) record with the **nID** field. The referenced CF specifies the conditional formatting rule to be extended. + +**cp (1 byte):** An unsigned integer that specifies the type of comparison operation to use when the **ct** field of the CF record referenced by the **icf** field of this structure is equal to 0x01. MUST be zero when the **ct** field of the CF record is not equal to 1. SHOULD[\<154\>](#Appendix_A_154) be equal to the **cp** field in the referenced CF record. + +In the following table, *v* represents the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) value, and *v1* and *v2* represent the results of evaluating the formulas specified by **rgce1** and **rgce2** fields of the referenced CF record specified by icf. The value of this field MUST be a value from the following table: + +[TABLE] + +**icfTemplate (1 byte):** An unsigned integer that specifies the template from which the rule was created. MUST be the least significant byte of one of the valid values specified for the **icfTemplate** field in the [CF12](#cf12) record. + +**ipriority (2 bytes):** An unsigned integer that specifies the priority of the rule. Rules that apply to the same cell are evaluated in increasing order of **ipriority**. MUST be unique across all CF12 records and CFExNonCF12 structures in the [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream. + +**A - fActive (1 bit):** A bit that specifies whether the rule is active. If set to zero, the rule will be ignored. + +**B - fStopIfTrue (1 bit):** A bit that specifies whether, when a cell fulfills the condition corresponding to this rule, the lower priority conditional formatting rules that apply to this cell are evaluated. MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x0 | Evaluate lower priority conditional formatting rules that apply to this cell | +| 0x1 | If the cell fulfills the condition corresponding to this rule, do not evaluate lower priority conditional formatting rules that apply to this cell | + +**C - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**D - unused (1 bit):** Undefined and MUST be ignored. + +**E - reserved2 (4 bits):** MUST be zero and MUST be ignored. + +**fHasDXF (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether cell formatting data is part of this record extension. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------| +| 0x00 | No formatting data in this record extension. | +| 0x01 | Formatting data is part of this record extension. | + +**dxf (variable):** A [DXFN12](#dxfn12) structure that specifies the format to use for cells that satisfy the condition. MUST NOT be present when **fHasDXF** is zero. + +**cbTemplateParm (1 byte):** An unsigned integer that specifies the size of the **rgbTemplateParms** field in bytes. MUST be equal to 16. + +**rgbTemplateParms (16 bytes):** A [CFExTemplateParams](#cfextemplateparams) that specifies parameters for the rule specified by this structure. + +### CFExTemplateParams + +The **CFExTemplateParams** structure specifies parameters for [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules of type [CF12](#cf12) or [CFExNonCF12](#cfexnoncf12). The type of this structure depends on the **icfTemplate** field in the containing structure as specified in the following table: + +| Value of icfTemplate | Type of CFExTemplateParams | +|----|----| +| 0x05 | [CFExFilterParams](#cfexfilterparams) | +| 0x08 | [CFExTextTemplateParams](#cfextexttemplateparams) | +| 0x0F | [CFExDateTemplateParams](#cfexdatetemplateparams) | +| 0x10 | CFExDateTemplateParams | +| 0x11 | CFExDateTemplateParams | +| 0x12 | CFExDateTemplateParams | +| 0x13 | CFExDateTemplateParams | +| 0x14 | CFExDateTemplateParams | +| 0x15 | CFExDateTemplateParams | +| 0x16 | CFExDateTemplateParams | +| 0x17 | CFExDateTemplateParams | +| 0x18 | CFExDateTemplateParams | +| 0x19 | [CFExAveragesTemplateParams](#cfexaveragestemplateparams) | +| 0x1A | CFExAveragesTemplateParams | +| 0x1D | CFExAveragesTemplateParams | +| 0x1E | CFExAveragesTemplateParams | +| other | [CFExDefaultTemplateParams](#cfexdefaulttemplateparams) | + +### CFExTextTemplateParams + +The **CFExTextTemplateParams** structure specifies parameters for text-related [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules as specified by a [CF12](#cf12) record or [CFExNonCF12](#cfexnoncf12) structure. + +[TABLE] + +**ctp (2 bytes):** An unsigned integer that specifies the type of text rule. MUST be a value from the following table: + +| Value | Meaning | +|--------|-----------------------| +| 0x0000 | Text contains | +| 0x0001 | Text does not contain | +| 0x0002 | Text begins with | +| 0x0003 | Text ends with | + +**reserved (14 bytes):** MUST be zero and MUST be ignored. + +### CFFilter + +The **CFFilter** structure specifies the parameters of a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule of type [**top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9). + +[TABLE] + +**cbFilter (2 bytes):** An unsigned integer that specifies the size of the structure in bytes, excluding the **cbFilter** field itself. + +**reserved1 (1 byte):** MUST be zero and MUST be ignored. + +**A - fTop (1 bit):** A bit that specifies whether the top or bottom items are displayed with the conditional formatting. MUST be one of the following values: + +| Value | Meaning | +|-------|------------------------------------------------------------| +| 0x0 | Bottom items are displayed with the conditional formatting | +| 0x1 | Top items are displayed with the conditional formatting | + +**B - fPercent (1 bit):** A bit that specifies whether a percentage of top or bottom items are displayed with the conditional formatting, or a set number of top or bottom items are displayed with the conditional formatting. MUST be one of the following values: + +| Value | Meaning | +|----|----| +| 0x0 | Top or bottom **iParam** items are displayed with the conditional formatting. | +| 0x1 | Top or bottom **iParam** percent of items are displayed with the conditional formatting | + +**reserved2 (6 bits):** MUST be zero and MUST be ignored. + +**iParam (2 bytes):** An unsigned integer that specifies how many values are displayed with the conditional formatting. If **fPercent** is set to 1 then this field represents a percent and MUST be less than or equal to 100, otherwise this field is a number of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and MUST be less than or equal to 1000. + +### CFFlag + +The **CFFlag** structure specifies the conditional format flag information. + +[TABLE] + +**iIconSet (4 bytes):** A [KPISets](#kpisets) that identifies an [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9). + +**iIcon (4 bytes):** A signed integer that specifies an [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) in the set. The value of this field changes the [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7) for custom sorts that are based on icon sets. + +MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------| +| -1 | No icon | +| 0 | First icon in the icon set | +| 1 | Second icon in the icon set | +| 2 | Third icon in the icon set | +| 3 | Fourth icon in the icon set | +| 4 | Fifth icon in the icon set | + +### CFGradient + +The **CFGradient** structure specifies the parameters of a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule that uses [**color scale**](#gt_11144129-6c0d-4ad5-ba59-59439c4747db) formatting. Color scale formatting maps [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) values to colors through the following process: + +1. An interpolation curve maps cell values to values between 0 and 1. The first and last control points, as specified in **rgInterp**, specify the cell values that map to 0 and 1 respectively. + +2. A gradient curve maps values between 0 and 1 to colors. + +Both curves are determined by two or three control points, with linear interpolation between those points. + +[TABLE] + +**unused (2 bytes):** Undefined and MUST be ignored. + +**reserved1 (1 byte):** MUST be zero and MUST be ignored. + +**cInterpCurve (1 byte):** An unsigned integer that specifies the number of control points in the interpolation curve. It MUST be 0x2 or 0x3. + +**cGradientCurve (1 byte):** An unsigned integer that specifies the number of control points in the gradient curve. It MUST be equal to **cInterpCurve**. + +**A - fClamp (1 bit):** A bit that specifies that the cell values are not used when they are out of the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of the interpolation curve. The minimum or the maximum of the interpolation curve is used instead of the cell value. The value SHOULD[\<155\>](#Appendix_A_155) be 1. + +**B - fBackground (1 bit):** A bit that specifies that the color scale formatting applies to the background of the cells. It MUST be 1. + +**reserved2 (6 bits):** MUST be zero and MUST be ignored. + +**rgInterp (variable):** An array of [CFGradientInterpItem](#cfgradientinterpitem). Each element is a control point of the interpolation curve. Its element count MUST be **cInterpCurve**. + +**rgCurve (variable):** An array of [CFGradientItem](#cfgradientitem). Each element is a control point of the gradient curve. Its element count MUST be **cGradientCurve**. + +### CFGradientInterpItem + +The **CFGradientInterpItem** structure specifies one control point in the interpolation curve. The interpolation curve maps [**cell values**](#gt_4d48a886-7f1d-4d41-a668-54f7f2f1a966) to colors for a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule using [**color scale**](#gt_11144129-6c0d-4ad5-ba59-59439c4747db) formatting. The color is specified as the numerical value associated with the color in the corresponding **CFGradient.rgCurve** array of the containing [CFGradient](#cfgradient) structure. + +[TABLE] + +**cfvoInterp (variable):** A [CFVO](#cfvo) structure that specifies the cell value associated with the numerical value specified in **numDomain**. + +**numDomain (8 bytes):** An Xnum (section [2.5.342](#xnum)) structure that specifies the numerical value of this control point. MUST be equal to 0.0 if the structure is the first item in the **rgbCT.rgInterp** array of the containing [CF12](#cf12) record. MUST be equal to 1.0 if this structure is the last item in the **rgbCT.rgInterp** array of the containing CF12 record. MUST be equal to 0.5 if this structure is the second item in the **rgbCT.rgInterp** array of the containing CF12 record and **rgbCT.cInterpCurve** field of the containing CF12 record is equal to 0x03. + +### CFGradientItem + +The **CFGradientItem** structure specifies one control point in the gradient curve. The gradient curve specifies a [**color scale**](#gt_11144129-6c0d-4ad5-ba59-59439c4747db) used in [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) and maps numerical values to colors. + +[TABLE] + +**numGrange (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the numerical value of the control point. MUST be equal to 0.0 if this structure is the first element in the **rgbCT.rgCurve** array of the containing [CF12](#cf12) record. MUST be equal to 1.0 if this structure is the last element in the **rgbCT.rgCurve** array of the containing CF12 record. MUST be equal to 0.5 if this structure is the second element in the **rgbCT.rgCurve** array of the containing CF12 record and the **rgbCT.cInterpCurve** field of the containing CF12 record is equal to 0x03. + +**color (16 bytes):** A [CFColor](#cfcolor) that specifies the color associated with the numerical value specified in **numGrange**. + +### CFMStateItem + +The **CFMStateItem** structure specifies the threshold value associated with an [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) for a [CFMultistate](#cfmultistate) [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule. + +[TABLE] + +**cfvo (variable):** A [CFVO](#cfvo) that specifies the threshold value. + +**fEqual (1 byte):** A Boolean (section [2.5.14](#boolean)) that MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | [**Cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) values that are equal to the threshold value do not pass the threshold | +| 0x01 | Cell values that are equal to the threshold value pass the threshold. | + +**unused (4 bytes):** Undefined and MUST be ignored. + +### CFMultistate + +The **CFMultistate** structure specifies the parameters for a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule that represents [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) values with icons from an [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9). + +[TABLE] + +**unused (2 bytes):** Undefined and MUST be ignored. + +**reserved1 (1 byte):** MUST be zero and MUST be ignored. + +**cStates (1 byte):** An unsigned integer that specifies the number of items in the icon set. MUST be the value from the following table: + +| Value of iIconSet | Value of cStates | +|--------------------------------|------------------| +| Between 0x00 and 0x07 included | 0x03 | +| Between 0x08 and 0x0C included | 0x04 | +| Between 0x0D and 0x10 included | 0x05 | + +**iIconSet (1 byte):** An unsigned integer that specifies the icon set that represents the cell values. MUST be the value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | ![3 colored arrows. Green pointing up, yellow pointing right, red pointing down](media/image66.bin "3 colored arrows.") | +| 0x01 | ![3 gray arrows. One pointing up, one pointing right, one pointing down](media/image67.bin "3 gray arrows.") | +| 0x02 | ![3 colored flags. One green, one yellow, one red](media/image68.bin "3 colored flags.") | +| 0x03 | ![3 round traffic lights. One green, one yellow, one red.](media/image69.bin "3 round traffic lights") | +| 0x04 | ![3 colored signs. One green circle, one yellow triangle, one red diamond](media/image70.bin "3 colored signs.") | +| 0x05 | ![3 round traffic lights with black rectangle borders. One green, one yellow, one red.](media/image71.bin "3 round traffic lights with black rectangle borders") | +| 0x06 | ![3 colored symbols. One green circle with check mark in center, one yellow circle with exclamation poin in center, one red circle with X in center](media/image72.bin "3 colored symbols.") | +| 0x07 | ![3 colored symbols. One green check mark, one yellow exclamation point, one red X](media/image73.bin "3 colored symbols.") | +| 0x08 | ![4 colored arrows. Green arrow pointing up. Yellow arrow pointing upwards at 45 degree angle. One yellow arrow pointing downwards at 45 degree angle. One red arrow pointing down.](media/image74.bin "4 colored arrows.") | +| 0x09 | ![4 gray arrows. Aarrow pointing up. Arrow pointing upwards at 45 degree angle. Arrow pointing downwards at 45 degree angle. Arrow pointing down.](media/image75.bin "4 gray arrows. ") | +| 0x0A | ![Four circles red to black. Bright red circle. faded red circle. Faded gray circle. Black circle](media/image76.bin "Four circles red to black") | +| 0x0B | ![4 sets of 4 vertical bars. Each bar in set is taller than the previous, angling upwards from left to right. First set has first bar filled in, rest are grey. Second set has first 2 bars filled in, rest are grey. Third set has first 3 bars filled in, last is gray. Fourth set has all 4 bars filled in.](media/image77.bin "4 sets of 4 vertical bars.") | +| 0x0C | ![4 round traffic lights. One green, one yellow, one red, one black](media/image78.bin "4 round traffic lights.") | +| 0x0D | ![5 colored arrows. One green arrow pointing up. One yellow arrow pointing upwards at 45 degree angle. One yellow arrow pointing right. One yellow arrow pointing downwards at 45 degree angle. One red arrow pointing down.](media/image79.bin "5 colored arrows") | +| 0x0E | ![5 gray arrows. One arrow pointing up. One arow pointing upwards at 45 degree angle. One arrow pointing right. One arrow pointing downwards at 45 degree angle. One arrow pointing down.](media/image80.bin "One arrow pointing up. One arow pointing upwards at 45 degree angle. One ") | +| 0x0F | ![5 sets of 5 vertical bars for rating. Each bar in set is taller than the previous, angling upwards from left to right. First set has all 5 bars filled in. Second set has first 4 bars filled in, the last is grey. Third set has first 2 bars filled in, rest are gray. Fourth set has 0 bars filled in.](media/image81.bin "5 sets of 5 vertical bars for rating.") | +| 0x10 | ![5 circles divided into quarters. First circle has all 4 quarters filled in black. Second ircle has 3 quarters filled in black. Third circle has 2 quarters filled in black. Fourth circle has 1 quarter filled in black. Fifth circle has 0 quarters filled in black.](media/image82.bin "5 circles divided into quarters. ") | + +**A - fIconOnly (1 bit):** A bit that specifies whether only the [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) will be displayed in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and that the cell value will be [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**B - reserved2 (1 bit):** MUST be zero and MUST be ignored. + +**C - fReverse (1 bit):** A bit that specifies whether the order of the icons in the set is reversed. + +**reserved3 (5 bits):** MUST be zero and MUST be ignored. + +**rgStates (variable):** An array of [CFMStateItem](#cfmstateitem). Each element specifies a threshold for the respective icon in the set, below which cell values are represented by the next icon in the set. The element count MUST be equal to **cStates**. + +### CFrtId + +The **CFrtId** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [Future Record Type](#Section_b660b67822684414839ed1ae9a4e4e85) identifier values. + +[TABLE] + +**rtFirst (2 bytes):** An unsigned integer that specifies the first Future Record Type in the range. The value MUST be less than or equal to **rtLast**. + +**rtLast (2 bytes):** An unsigned integer that specifies the last Future Record Type in the range. + +### CFT + +The **CFT** enumeration specifies [**custom filter**](#gt_8593ee2f-c2dd-4793-a684-45fe40c840d2) types. + +| Name | Value | Meaning | +|----|----|----| +| **CFTNIL** | 0x00000000 | None | +| **CFTTOP10** | 0x00000003 | [**Top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9) | +| **CFTEQUALDATE** | 0x00000004 | Equal to date | +| **CFTBEFORE** | 0x00000005 | Before | +| **CFTAFTER** | 0x00000006 | After | +| **CFTBETWEENDATE** | 0x00000007 | Between dates | +| **CFTTOMORROW** | 0x00000008 | Tomorrow | +| **CFTTODAY** | 0x00000009 | Today | +| **CFTYESTERDAY** | 0x0000000A | Yesterday | +| **CFTNEXTWEEK** | 0x0000000B | Next week | +| **CFTTHISWEEK** | 0x0000000C | This week | +| **CFTLASTWEEK** | 0x0000000D | Last week | +| **CFTNEXTMONTH** | 0x0000000E | Next month | +| **CFTTHISMONTH** | 0x0000000F | This month | +| **CFTLASTMONTH** | 0x00000010 | Last month | +| **CFTNEXTQUARTER** | 0x00000011 | Next quarter | +| **CFTTHISQUARTER** | 0x00000012 | This quarter | +| **CFTLASTQUARTER** | 0x00000013 | Last quarter | +| **CFTNEXTYEAR** | 0x00000014 | Next year | +| **CFTTHISYEAR** | 0x00000015 | This year | +| **CFTLASTYEAR** | 0x00000016 | Last year | +| **CFTYEARTODATE** | 0x00000017 | Year to date | +| **CFTQ1** | 0x00000018 | First quarter | +| **CFTQ2** | 0x00000019 | Second quarter | +| **CFTQ3** | 0x0000001A | Third quarter | +| **CFTQ4** | 0x0000001B | Fourth quarter | +| **CFTM1** | 0x0000001C | January | +| **CFTM2** | 0x0000001D | February | +| **CFTM3** | 0x0000001E | March | +| **CFTM4** | 0x0000001F | April | +| **CFTM5** | 0x00000020 | May | +| **CFTM6** | 0x00000021 | June | +| **CFTM7** | 0x00000022 | July | +| **CFTM8** | 0x00000023 | August | +| **CFTM9** | 0x00000024 | September | +| **CFTM10** | 0x00000025 | October | +| **CFTM11** | 0x00000026 | November | +| **CFTM12** | 0x00000027 | December | +| **CFTNOTEQUALDATE** | 0x00000028 | Does not equal date | +| **CFTBEFOREOREQUAL** | 0x00000029 | Equal or earlier date | +| **CFTAFTEROREQUAL** | 0x0000002A | Equal or later date | +| **CFTNOTBETWEENDATE** | 0x0000002B | Not between two dates | + +### CFVO + +The **CFVO** structure specifies a Conditional Formatting Value Object (CFVO) that specifies how to calculate a value from the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells that a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule applies to. + +The value this structure specifies how to calculate is referred to as a CFVO value in other records. + +[TABLE] + +**cfvoType (1 byte):** An unsigned integer that specifies how the CFVO value is determined. In the following table, X represents a parameter value. If **fmla.cce** is greater than zero, then X is the result of evaluating **fmla,** otherwise, X is **numValue.** **cfvoType** MUST be one of the following values: + +[TABLE] + +**fmla (variable):** A [CFVOParsedFormula](#cfvoparsedformula) that specifies the formula used to calculate the CFVO value. If **cfvoType** is 0x07, then **fmla.cce** MUST be greater than zero. + +**numValue (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies a static value used to calculate the CFVO value. MUST be omitted if **fmla.cce** is greater than zero, or if **cfvoType** is equal to 0x02 or 0x03. MUST be greater than 0.0 and less than 100.0 if **cfvoType** is either 0x04 or 0x05 + +### ChartNumNillable + +**ChartNumNillable** is an 8-byte union that specifies a floating-point value, or a non-numeric value defined by the containing record. The type and meaning of the union contents are determined by the most significant 2 bytes, and is defined in the following table: + +| Value of most significant 2 bytes | Type and meaning of union contents | +|----|----| +| 0xFFFF | A [NilChartNum](#nilchartnum) that specifies a non-numeric value, as defined by the containing record. | +| Any other value. | An Xnum (section [2.5.342](#xnum)) that specifies a floating-point value. | + +### Col + +The **Col** structure specifies the zero-based column index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**col (2 bytes):** An unsigned integer that specifies the zero-based column index of the column in the sheet that contains this structure. MUST be greater than or equal to the **colMic** field of the [Dimensions](#dimensions) record of the sheet that contains this structure and MUST be less than the **colMac** field of the Dimensions record of the sheet that contains this structure. MUST be less than or equal to 0x00FF. + +### Col_NegativeOne + +The **Col_NegativeOne** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**col (2 bytes):** A signed integer that specifies the zero-based index of a column in the sheet that contains this structure. The value 0xFFFF specifies a null column index. MUST be greater than or equal to 0xFFFF and less than or equal to 0x00FF. + +### Col12 + +The **Col12** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**col (4 bytes):** A signed integer that specifies a zero-based index of the sheet. MUST be greater than or equal to zero, and MUST be less than or equal to 0x3FFF. + +### Col256U + +The **Col256U** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**col (2 bytes):** An unsigned integer that specifies the zero-based index of a column in the sheet that contains this structure. MUST be less than or equal to 0x0100. The value 0x0100 specifies that the formatting in the containing record also specifies the default column formatting. If additional columns become [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) at the extreme right of the column [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) because of column deletion, those columns have this default formatting applied. + +### ColByte + +The **ColByte** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**col (1 byte):** An unsigned integer that specifies the zero-based index of the column in the sheet that contains this structure. MUST be greater than or equal to the **colMic** field of the [Dimensions](#dimensions) record of the sheet that contains this structure and MUST be less than the **colMac** field of the Dimensions record of the sheet that contains this structure. + +### ColByteU + +The **ColByteU** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**col (1 byte):** An unsigned integer that specifies the zero-based index of a column in the sheet that contains this structure. + +### ColElfU + +The **ColElfU** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and [**relative reference**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) information for this column index and a corresponding row index. + +[TABLE] + +**col (14 bits):** An unsigned integer that specifies the zero-based index of a column in the sheet that contains this structure. MUST be less than or equal to 0x00FF. + +**A - fQuoted (1 bit):** A bit that specifies if the label occurrences in the [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) are surrounded by single quote characters. + +**B - fRelative (1 bit):** A bit that specifies whether a corresponding row index from the containing structure and **column** are relative or absolute. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | A corresponding row index from the containing structure and **column** are absolute coordinates and are specified by a fixed position in a sheet. | +| 0x1 | A corresponding row index from the containing structure and **column** are relative coordinates and are specified by their position in relation to the current row or current column. | + +### ColorICV + +The **ColorICV** structure specifies a color in the color table. + +This structure differs from the [IcvXF](#icvxf) structure in size (4 bytes versus 7 bits), and the validity of the values 0x40 and 0x41. + +[TABLE] + +**iCV (4 bytes):** An unsigned integer that specifies a color in the color table. The value MUST be an IcvXF value. The value MUST NOT be 0x00000040 or 0x00000041. + +### ColorTheme + +The **ColorTheme** structure specifies a color from the document’s [**theme**](#gt_8b5eb4c0-949b-47d9-8b63-b9bda81d61b8). + +[TABLE] + +**iCV (4 bytes):** An unsigned integer that specifies one of the colors defined in the [**color scheme**](#gt_b0feeac6-f711-4ed7-b8c6-3a490734a9e5) of the document’s [Theme](#theme) record. MUST be one of the following values: + +| Value | Color from the color scheme | +|----|----| +| 0x00000000 | Dark 1 | +| 0x00000001 | Light 1 | +| 0x00000002 | Dark 2 | +| 0x00000003 | Light 2 | +| 0x00000004 | Accent 1 | +| 0x00000005 | Accent 2 | +| 0x00000006 | Accent 3 | +| 0x00000007 | Accent 4 | +| 0x00000008 | Accent 5 | +| 0x00000009 | Accent 6 | +| 0x0000000A | [**Hyperlink**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) | +| 0x0000000B | [**Followed hyperlink**](#gt_7ddfa06d-f75c-47d3-b7b7-8a3a4aa47975) | + +If this structure is contained in a [CF12](#cf12) record, the value MUST be different from 0x0000000B. + +### ColRelNegU + +The **ColRelNegU** structure specifies the zero-based column index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) offset information for this column index and a corresponding row index. + +[TABLE] + +**col (14 bits):** A signed integer that specifies the zero-based column index or offset of a column in the sheet that contains this structure. MUST be greater than or equal to -255 be less than or equal to 255. + +**A - colRelative (1 bit):** A bit that specifies whether **col** is an offset. + +**B - rowRelative (1 bit):** bit that specifies whether a row index corresponding to **col** in the structure containing this structure is an offset. + +### ColRelU + +The **ColRelU** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and [**relative reference**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) information for this column index and a corresponding row index. + +[TABLE] + +**col (14 bits):** An unsigned integer that specifies the zero-based index of a column in the sheet that contains this structure. MUST be less than or equal to 0x00FF. + +**A - colRelative (1 bit):** A bit that specifies whether **col** is a relative reference. + +**B - rowRelative (1 bit):** A bit that specifies whether a row index corresponding to **col** in the structure containing this structure is a relative reference. + +### ColSlco8U + +The **ColSlco8U** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) and information about whether a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) has been deleted. + +[TABLE] + +**col (14 bits):** An unsigned integer that specifies the zero-based index of a column in the sheet that contains this structure. MUST be less than or equal to 0x00FF. + +**A - fDeleted (1 bit):** A bit that specifies whether the cell that is referenced by the containing structure, has been deleted. When set to 1, the [**cell reference**](#gt_4d15aeb2-3a7d-44d7-b8d1-8a441f1cc24f) of the containing structure MUST be ignored. + +**B - unused (1 bit):** Undefined and MUST be ignored. + +### ColU + +The **ColU** structure specifies the zero-based index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**col (2 bytes):** An unsigned integer that specifies the zero-based index of a column in the sheet that contains this structure. MUST be less than or equal to 0x00FF. + +### Colx + +The **Colx** structure specifies the zero-based column index of a column in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**col (2 bytes):** An unsigned integer that specifies the zero-based column index of a column in the sheet. The value MUST be 0, 0xFF or be greater than or equal to the **colMic** field of the [Dimensions](#dimensions) record of the sheet that contains this structure and less than the **colMac** field of the Dimensions record of the sheet that contains this structure. + +### CondDataValue + +The **CondDataValue** structure specifies the conditional data information. + +[TABLE] + +**condDataValue (4 bytes):** An unsigned integer that specifies a conditional data value. If [SortCond12](#sortcond12).**sortOn** is 0x1 or 0x2, it specifies the zero-based index of a [DXF](#dxf) record in the collection of DXF records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The referenced DXF specifies the formatting. If SortCond12.**sortOn** is 0x0, this MUST be zero, and MUST be ignored. + +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +### CondFmtStructure + +The **CondFmtStructure** structure specifies [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules that are associated with a set of cells in a containing [CondFmt12](#condfmt12) record. + +[TABLE] + +**ccf (2 bytes):** An unsigned integer that specifies the count of [CF12](#cf12) records that follow the containing record. MUST be greater than or equal to 0x0001. + +**A - fToughRecalc (1 bit):** A bit that specifies that the appearance of the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) requires significant processing. This information can be used to optimize the redraw of conditional formatting when data values change. + +For example, an application could determine that a conditional formatting rule that contains certain functions or a conditional formatting rule that takes more than a predetermined amount of time to calculate designates that the conditional formatting requires significant processing, and could set this bit to 1. + +**nID (15 bits):** An unsigned integer that identifies this record. + +**refBound (8 bytes):** A [Ref8U](#ref8u) structure that specifies bounds of the set of cells to which the rules are applied. The set of cells that it represents MUST include all of the cells represented by field **sqref**. + +**sqref (variable):** A [SqRefU](#sqrefu) structure that specifies the cells to which the conditional formatting rules apply. **sqref.cref** MUST be greater than zero and less than or equal to 1026. + +### ConnGrbitDbt + +The **ConnGrbitDbt** structure is a 2 byte variable-type structure that specifies [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9) properties for the containing record. Its meaning depends on the value of the **dbt** field of the containing record. + +| Value | Meaning | +|----|----| +| 4 | A [ConnGrbitDbtWeb](#conngrbitdbtweb) that specifies the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) flags for a Web data connection. | +| 5 | A [ConnGrbitDbtOledb](#conngrbitdbtoledb) that specifies the query flags for an [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) data connection. | +| 7 | A [ConnGrbitDbtAdo](#conngrbitdbtado) that specifies the query flags for an [**ADO**](#gt_3477d72a-874b-4a2a-b6a9-1431c128df49) data connection. | +| Any other value | A 2 byte unsigned integer. Unused and MUST be 0. | + +### ConnGrbitDbtAdo + +The **ConnGrbitDbtAdo** structure specifies the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) flags for an [**ADO**](#gt_3477d72a-874b-4a2a-b6a9-1431c128df49) data connection. + +[TABLE] + +**reserved1 (8 bits):** MUST be zero and MUST be ignored. + +**A - fAdoRefreshable (1 bit):** A bit that specifies if the ADO query can be refreshed. + +**reserved2 (7 bits):** MUST be zero and MUST be ignored. + +### ConnGrbitDbtOledb + +The **ConnGrbitDbtOledb** structure specifies the [external connection](#Section_69df8d03b6fd45cda0a09b026e50a3d9) properties for an [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) data connection. + +[TABLE] + +**dbost (3 bits):** An unsigned integer that specifies the OLE DB command type. This field applies to the database command strings that are saved with the parent records. MUST be a value from the following table: + +| Name | Value | Meaning | +|----|----|----| +| CMDNULL | 0x0 | The string is not specified. | +| CMDCUBE | 0x1 | The string specifies the name of a [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7) within an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) database, see also [OLAP Connections](#Section_068796f9e5154dab8e69f9a7b52aaa9a). | +| CMDSQL | 0x2 | The string specifies an [**SQL**](#gt_37416b0f-ca5b-4fac-96e5-082eb80a3d84) statement. | +| CMDTABLE | 0x3 | The string specifies a database table name. | +| CMDDEFALT | 0x4 | The string specifies a statement in the default language of the database. | +| CMDSPLIST | 0x5 | The string specifies a list from a Web-based data provider. | + +**A - fLocalConn (1 bit):** A bit that specifies which connection string to use for this external connection. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Uses the main connection string, as specified by a value of 0 in the **fLocal** field in [OleDbConn](#oledbconn), or by a value of 0 or 1 in the **rgIOleDbValid** of a [DConnConnectionOleDb](#dconnconnectionoledb). | +| 0x1 | Uses the alternate connection string, as specified by a value of 1 in the **fLocal** field in OleDbConn, or by a value of 2 or 3 in the **rgIOleDbValid** of a DConnConnectionOleDb. | + +**B - fNoRefreshCube (1 bit):** A bit that specifies whether any local cache of data from the OLAP [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is to be flushed when the a refresh is done. The value zero specifies any local cache of data from the OLAP data source is to be flushed when the a refresh is done. MUST be zero and MUST be ignored if the **dbost** field does not equal 0x1. + +**C - fUseOfficeLcid (1 bit):** A bit that specifies whether the user’s [**locale**](#gt_7b78ebef-e35d-45ab-abfd-4121b60995de) information is provided to the OLAP data source for retrieval of translated data and errors. MUST be zero and MUST be ignored if the **dbost** field does not equal 0x1. + +**D - fSrvFmtNum (1 bit):** A bit that specifies whether to apply OLAP data source number formatting to the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). MUST be zero and MUST be ignored if the **dbost** field does not equal 0x1. + +**E - fSrvFmtBack (1 bit):** A bit that specifies whether to apply OLAP data source [**fill**](#gt_215c1c51-d5ef-46af-8596-d7ef63c1fe89) colors to the PivotTable. MUST be zero and MUST be ignored if the **dbost** field does not equal 0x1. + +**F - fSrvFmtFore (1 bit):** A bit that specifies whether to apply OLAP data source [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) colors to the PivotTable. MUST be zero and MUST be ignored if the **dbost** field does not equal 0x1. + +**G - fSrvFmtFlags (1 bit):** A bit that specifies whether to apply OLAP data source font formatting to the PivotTable. MUST be zero and MUST be ignored if the **dbost** field does not equal 0x1. + +**H - fSupportsLangCellProp (1 bit):** A bit that specifies whether the user’s locale information is provided to the OLAP data source to support [**member (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) [**localization**](#gt_c26ef2a9-60ae-4cba-a409-5202571f152c). MUST be zero and MUST be ignored if the **dbost** field does not equal 0x1. + +**I - fSrvSupportsClientCube (1 bit):** A bit that specifies that the server supports local embedded data storage. + +**J - reserved (4 bits):** MUST be zero and MUST be ignored. + +### ConnGrbitDbtWeb + +The **ConnGrbitDbtWeb** structure specifies the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) flags for a Web data connection. + +[TABLE] + +**A - fParsePreFormatted (1 bit):** A bit that specifies how text enclosed in \ tags is handled. + +| Value | Meaning | +|----|----| +| 0x0 | Each row of text enclosed in \ tags will be imported as a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). | +| 0x1 | The text is parsed as tables. | + +**B - fConsecDelim (1 bit):** A bit that specifies how consecutive delimiters are treated. + +| Value | Meaning | +|-------|----------------------------------------------------------------| +| 0x0 | Each consecutive delimiter is treated as a separate delimiter. | +| 0x1 | Consecutive delimiters is treated as a single delimiter. | + +**C - fSameSettings (1 bit):** A bit that specifies how tables inside \ blocks are parsed. + +| Value | Meaning | +|----|----| +| 0x0 | Each [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) is parsed separately. | +| 0x1 | All tables are parsed with the same width settings as the first row of the first table. | + +**D - fXL97Format (1 bit):** A bit that specifies whether the query was created by a specific version of the application[\<156\>](#Appendix_A_156). + +| Value | Meaning | +|----|----| +| 0x0 | The query was created by specific versions of the application[\<157\>](#Appendix_A_157). | +| 0x1 | The query was created by a specific version of the application[\<158\>](#Appendix_A_158). | + +**E - fNoDateRecog (1 bit):** A bit that specifies how dates are imported. + +| Value | Meaning | +|-------|--------------------------------------------| +| 0x0 | Dates are imported as values of type date. | +| 0x1 | Dates are imported as text. | + +**F - fRefreshedInXl9 (1 bit):** A bit that specifies whether the query was refreshed in a specific version of the application[\<159\>](#Appendix_A_159). + +**reserved (10 bits):** MUST be zero and MUST be ignored. + +### ControlInfo + +The **ControlInfo** structure specifies the properties of some [**form**](#gt_c7858bfa-d4d2-48a7-ac9c-d2e90fbe3590) control in a [Dialog Sheet](#Section_da37feb48b9a462d87772a5fddd4866e). The control MUST be a group, radio button, label, button or checkbox. + +[TABLE] + +**A - fDefault (1 bit):** A bit that specifies whether this control dismisses the Dialog Sheet and performs the default behavior. If the control is not a button, the value MUST be 0. + +**B - fHelp (1 bit):** A bit that specifies whether this control is intended to load context-sensitive help for the Dialog Sheet. If the control is not a button, the value MUST be 0. + +**C - fCancel (1 bit):** A bit that specifies whether this control dismisses the Dialog Sheet and take no action. If the control is not a button, the value MUST be 0. + +**D - fDismiss (1 bit):** A bit that specifies whether this control dismisses the Dialog Sheet. If the control is not a button, the value MUST be 0. + +**reserved1 (12 bits):** MUST be zero and MUST be ignored. + +**accel1 (2 bytes):** A signed integer that specifies the [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) character of the control’s [**accelerator key**](#gt_d61b4a07-b6c1-4c08-9ebd-1d00b360f953). The value MUST be greater than or equal to 0x0000. A value of 0x0000 specifies there is no accelerator associated with this control. + +**reserved2 (2 bytes):** Reserved. MUST be 0x0000. + +### CrtLayout12Mode + +The **CrtLayout12Mode** record specifies a layout mode. Each layout mode specifies a different meaning of the **x**, **y**, **dx**, and **dy** fields of [CrtLayout12](#crtlayout12) and [CrtLayout12A](#crtlayout12a). + +| Name | Value | Meaning | +|----|----|----| +| **L12MAUTO** | 0x0000 | Position and [**dimension (2)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) are determined by the application. **x**, **y**, **dx** and **dy** MUST be ignored. | +| **L12MFACTOR** | 0x0001 | **x** and **y** specify the offset of the top left corner, relative to its default position, as a fraction of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)). MUST be greater than or equal to -1.0 and MUST be less than or equal to 1.0. **dx** and **dy** specify the width and height, as a fraction of the chart area, MUST be greater than or equal to 0.0, and MUST be less than or equal to 1.0. | +| **L12MEDGE** | 0x0002 | **x** and **y** specify the offset of the upper-left corner; **dx** and **dy** specify the offset of the bottom-right corner. **x**, **y**, **dx** and **dy** are specified relative to the upper-left corner of the chart area (section 2.2.3.17) as a fraction of the chart area. **x**, **y**, **dx** and **dy** MUST be greater than or equal to 0.0, and MUST be less than or equal to 1.0. | + +### DataFunctionalityLevel + +The **DataFunctionalityLevel** is a 1 byte unsigned integer that specifies a [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6)[\<160\>](#Appendix_A_160). SHOULD[\<161\>](#Appendix_A_161) be 0, 1, or 3. MUST be greater than or equal to 0 and less than or equal to 254. + +### DataSourceType + +The **DataSourceType** enumeration specifies the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) types. + +| Name | Value | Meaning | +|----|----|----| +| **DBT_ODBC** | 0x0001 | [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e)-based source | +| **DBT_DAO** | 0x0002 | [**DAO**](#gt_0aa33fda-1d81-4d7a-aa7a-aae64b50674f)-based source | +| **DBT_WEB** | 0x0004 | [**Web query**](#gt_7f21a511-63e5-43a2-ad46-235ce53af5f2) | +| **DBT_OLEDB** | 0x0005 | [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31)-based source | +| **DBT_TXT** | 0x0006 | Text-based source created via [**text query**](#gt_c636d3ce-a120-4acf-91ac-40b3ec79593a) | +| **DBT_ADO** | 0x0007 | [**ADO**](#gt_3477d72a-874b-4a2a-b6a9-1431c128df49) record set | + +### DateAsNum + +The **DateAsNum** structure specifies a date and time value stored as an Xnum (section [2.5.342](#xnum)). + +[TABLE] + +**dateNum (8 bytes):** An Xnum that specifies a date and time value. The value uses the double-precision floating point number in the Xnum structure as follows: The integer part of the number specifies the date as a number of days from a base date[\<162\>](#Appendix_A_162), and the fractional part specifies the time of day as a fraction of a 24-hour day. The base date for the number of days is determined by the [**date system**](#gt_cfc29c5e-eb23-4077-b6eb-492f20f5c87f) used in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), as specified by the [Date1904](#date1904) record in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1), according to the following table: + +| Date system | Meaning | +|----|----| +| 1900 | A value of 1 to **dateNum** specifies 00:00:00 on January 1, 1900. | +| 1904 | A value of 0 to **dateNum** specifies 00:00:00 on January 1, 1904. | + +### DateUnit + +The **DateUnit** enumeration specifies the unit of measurement of a date value. + +| Name | Value | Meaning | +|--------------|--------|-----------------------------------| +| **DUDAYS** | 0x0000 | Time value is measured in days. | +| **DUMONTHS** | 0x0001 | Time value is measured in months. | +| **DUYEARS** | 0x0002 | Time value is measured in years. | + +### DCol + +The **DCol** structure specifies a count of column indexes in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**dcol (2 bytes):** An unsigned integer that specifies the count of column indexes in a sheet. + +### DColByteU + +The **DColByteU** structure specifies a count or difference of column indexes in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**dcol (1 byte):** An unsigned integer that specifies the count of column indexes in a sheet. + +### DConFile + +The **DConFile** structure specifies the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) file or workbook file and [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that contain a [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). This structure is used by the [DConBin](#dconbin), [DConRef](#dconref) and [DConName](#dconname) records. + +[TABLE] + +**stFile (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) that specifies the workbook file or workbook file and sheet that contain the range specified in the DConBin, DConRef or DConName record. + +> MUST be a string that conforms to the following ABNF grammar: + +dcon-file = external-virt-path / self-reference + +external-virt-path = volume / unc-volume / rel-volume  / transfer-protocol / startup / alt-startup / library /  simple-file-path-dcon + +simple-file-path-dcon = %x0001 file-path   + +self-reference = %x0002 sheet-name + +> See [VirtualPath](#virtualpath) for the definition of the volume, unc-volume, rel-volume, transfer-protocol, startup, alt-startup, library, file-path and sheet-name rules used in the [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) grammar.  Note that the volume, unc-volume, rel-volume, transfer-protocol, startup, alt-startup, library, and file-path rules specify that an optional sheet name can be included.   +> +> If this structure is contained in a DConName or DConBin record and the [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) has a workbook scope, then this string MUST satisfy the external-virt-path rule and MUST NOT specify a sheet name.  Otherwise a sheet name MUST be specified. + +### DConnConnectionOleDb + +The **DConnConnectionOleDb** structure specifies data connection properties of an [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) data connection. + +[TABLE] + +**nDrillthroughRows (4 bytes):** An unsigned integer that specifies the maximum number of rows that the application will retrieve during a [**drillthrough**](#gt_e5a4d8db-0d30-4977-9cab-fb66457f0ff7) operation on a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) based on this data connection. + +**cOleDb (2 bytes):** An unsigned integer that specifies the number of [**connection strings**](#gt_03a9d0ca-2f10-4f3d-b910-052714a96f7d) associated with the OLE DB connection specified in **rgConn**. MUST be less than or equal to 4. MUST be equal to 0 if the **fStandAlone** field of the associated [DConn](#dconn) of structure is 0. + +**rgIOleDbValid (variable):** An array of 2-byte unsigned integers that specify the type of connection strings in **rgConn.** The size of the array MUST be equal to **cOleDb**. Each element of the array MUST be unique within **rgIOleDbValid**. Each element of the array MUST be from the following table: + +| Value | Meaning of string in rgConn | +|----|----| +| 0 | The main connection string of the connection. This element MUST exist. | +| 1 | The variant of the main connection string that has the password removed. | +| 2 | The connection string to the local [**cube**](#gt_a0c8d97b-322c-4117-8525-37e5f26751e7) file. | +| 3 | The variant of the connection string to the local cube file that has the password removed. | + +**rgIOleDbInvalid (variable):** Undefined and MUST be ignored. The size of the field, in bytes, MUST equal the value specified by the following formula: + +2 \* (4 – **cOleDb**) + +**unused (2 bytes):** Undefined and MUST be ignored. + +**rgConn (variable):** An array of [DConnUnicodeStringSegmented](#dconnunicodestringsegmented). The array specifies the connection strings associated with the OLE DB connection that correspond to the elements in **rgIOleDbValid**. The number of elements in the array MUST be equal to **cOleDb**. This field MUST NOT exist if **cOleDb** equals 0. The meaning of each item in **rgConn** is defined by the item with a matching index in **rgIOleDbValid** as defined in the table under **rgIOleDbValid.** + +### DConnConnectionWeb + +The **DConnConnectionWeb** structure specifies data connection properties of [**Web query**](#gt_7f21a511-63e5-43a2-ad46-235ce53af5f2) data connections. + +[TABLE] + +**rgbURL (variable):** A [DConnStringSequence](#dconnstringsequence) that specifies the URL for a Web query. + +**rgbWebPost (variable):** A DConnStringSequence that specifies the **[post method](#gt_ab84d1e3-1d4d-4085-a25e-f05593820d67)** for a Web query. + +### DConnId + +The **DConnId** structure specifies the identifier of the object that a connection is associated with. + +[TABLE] + +**bType (1 byte):** An unsigned integer that specifies the identifier type. MUST be a value as specified in the table listed under field **data**. + +**data (variable):** A variable field that specifies the identifier of the object whose type and meaning are dictated by the value of field **bType**, as specified in the following table: + +| bType Value | Meaning | +|----|----| +| 0 | This field does not exist. There is no associated object. | +| 1 | A [DConnUnicodeStringSegmented](#dconnunicodestringsegmented) that specifies the name of a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289). | +| 2 | An [SXStreamID](#sxstreamid) that specifies the stream in the [PivotCache storage](#Section_c5fb3f663ef64308ae3de59244159687). | + +### DConnParamBinding + +The **DConnParamBinding** structure that specifies a parameter’s binding value based on field **pbt** of structure [DConnParameter](#dconnparameter). + +| Value | Meaning | +|----|----| +| 0 | A [DConnUnicodeStringSegmented](#dconnunicodestringsegmented) that specifies the parameter prompt. | +| 1 | A [DConnParamBindingValType](#dconnparambindingvaltype) structure that specifies the parameter value as defined in the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2). | + +### DConnParamBindingValByte + +The **DConnParamBindingValByte** structure specifies the parameter binding. + +[TABLE] + +**fVal (8 bits):** An unsigned integer that specifies the binding Boolean value. + +**reserved1 (24 bits):** MUST be zero and MUST be ignored. + +**reserved2 (4 bytes):** MUST be zero and MUST be ignored. + +### DConnParamBindingValInt + +The **DConnParamBindingValInt** structure specifies the parameter binding. + +[TABLE] + +**val (4 bytes):** An unsigned integer that specifies the binding value. + +**reserved (4 bytes):** MUST be zero and MUST be ignored. + +### DConnParamBindingValString + +The **DConnParamBindingValString** structure specifies properties for a data connection parameter that has a string data type. + +[TABLE] + +**reserved (8 bytes):** MUST be zero and MUST be ignored. + +**rgchBindingValueStr (variable):** A [DConnUnicodeStringSegmented](#dconnunicodestringsegmented) that specifies the value for a data connection parameter. + +### DConnParamBindingValType + +The **DConnParamBindingValType** structure specifies properties for a data connection parameter. + +[TABLE] + +**wBindingValueGrbit (2 bytes):** An unsigned integer that specifies the data type of the parameter. MUST be a value from the table as specified in the **rgbBindingValue** field. + +**rgbBindingValue (variable):** A variable type field whose type and meaning are specified by the value of **wBindingValueGrbit** as specified in the following table: + +| wBindingValueGrbit Value | Meaning | +|----|----| +| 0x0001 | An Xnum (section [2.5.342](#xnum)) that specifies the value for a parameter that has a numeric data type. | +| 0x0002 | A [DConnParamBindingValString](#dconnparambindingvalstring) that specifies the value for a parameter that has a string data type. | +| 0x0004 | A [DConnParamBindingValByte](#dconnparambindingvalbyte) that specifies the value for a parameter that has a Boolean data type. | +| 0x0800 | A [DConnParamBindingValInt](#dconnparambindingvalint) that specifies the value for a parameter that has an integer data type. | + +### DConnParameter + +The **DConnParameter** structure specifies a parameter of a [**parameterized query**](#gt_c68a3a26-317d-4a1d-9eff-c2630b53067c). + +[TABLE] + +**rgchName (variable):** A [DConnUnicodeStringSegmented](#dconnunicodestringsegmented) that specifies the name of the parameter. + +**pbt (3 bits):** An unsigned integer that specifies the parameter type. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Prompt. User is prompted for the value of the parameter. | +| 0x1 | Value. The parameter value is specified in the [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2). | + +**reserved (13 bits):** MUST be zero and MUST be ignored. + +**wTypeSql (2 bytes):** An [ODBCType](#odbctype) structure that specifies the [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) data type as returned by the ODBC provider of the data. This signed integer specifies the [**SQL**](#gt_37416b0f-ca5b-4fac-96e5-082eb80a3d84) data type. + +**A - fDefaultName (1 bit):** A bit that specifies whether a default name has been assigned by the application to the parameter. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------------------| +| 0x0 | The user specified a name for the parameter. | +| 0x1 | The application specified a name for the parameter. | + +**unused (15 bits):** Undefined and MUST be ignored. + +**paramBinding (variable):** A [DConnParamBinding](#dconnparambinding) structure that specifies the parameter’s bindings. + +### DConnStringSequence + +The **DConnStringSequence** structure specifies a sequence of strings. + +[TABLE] + +**cst (2 bytes):** An unsigned integer that specifies the number of strings in the **rgString** array. + +**rgString (variable):** An array of [DConnUnicodeStringSegmented](#dconnunicodestringsegmented) that specifies a segmented [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string. + +### DConnUnicodeStringSegmented + +The **DConnUnicodeStringSegmented** structure specifies a segmented Unicode string. + +[TABLE] + +**st (variable):** An [XLUnicodeStringSegmented](#xlunicodestringsegmented) that specifies a segmented Unicode string. + +### DJoin + +The **DJoin** enumeration specifies the join type for two data operations. + +| Name | Value | Meaning | +|---------------|------------|---------| +| **DJOINNULL** | 0x00000000 | None | +| **DJOINAND** | 0x00000001 | And | +| **DJOINOR** | 0x00000002 | Or | + +### DRw + +The **DRw** structure specifies a count of row indexes in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**drw (2 bytes):** An unsigned integer that specifies the count or difference of row indexes in a sheet. + +### DRwByteU + +The **DRwByteU** structure specifies a count of row indexes in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**drw (1 byte):** An unsigned integer that specifies the count or difference of row indexes in a sheet. + +### Duce + +The **Duce** structure specifies additional undo data that is applied to an [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) that uses a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) if the [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) is rejected. + +[TABLE] + +**duceStacked (4 bytes):** A [DuceStacked](#ducestacked) that specifies additional undo data used for the natural language formula. + +**duceRadical (9 bytes):** A [DuceRadical](#duceradical) that specifies additional undo data used for the natural language formula. If **eptg** does not specify that this natural language formula is an ElfRadical, then this field is undefined and MUST be ignored. + +**eptg (1 byte):** An unsigned integer that specifies the type of natural language formula. **eptg** MUST equal the second byte of the [Ptg](#ptg) specified by the **ptg** field of the [Ducr](#ducr) that contains this structure. The type of the natural language formula is either ElfStacked or ElfRadical, neither or both. + +**eptg** MUST be a value from the following table. + +| Value | ElfStacked | ElfRadical | +|-------|------------|------------| +| 0x02 | No | No | +| 0x03 | No | No | +| 0x06 | No | No | +| 0x07 | No | No | +| 0x0A | No | Yes | +| 0x0B | Yes | Yes | +| 0x0D | Yes | No | +| 0x0F | Yes | No | + +ElfStacked: A natural language formula is considered to be stacked if more than one [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) is used for the label.ElfRadical: A natural language formula is considered to be radical if the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) refers to more than one cell. + +**rgloc (variable):** An array of [RRLoc](#rrloc) structures. The number of elements is specified by the **cLoc** field of **duceStacked**. MUST exist if and only if the type of the natural language formula as specified by **eptg** is ElfStacked. The **fNoDollarOnLabel** field of each RRLoc structure in the array is undefined and MUST be ignored. + +### DuceRadical + +The **DuceRadical** structure specifies additional undo data associated with a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b). + +[TABLE] + +**refRadical (8 bytes):** A [Ref8U](#ref8u) that specifies the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) referenced by the natural language formula. MUST exist if and only if **ptgRadical** is a [PtgArea](#ptgarea). + +**unused (8 bytes):** An array of 1-byte signed integers. Undefined and MUST be ignored. MUST exist if and only if **ptgRadical** is equal to [PtgAreaErr](#ptgareaerr). + +**ptgRadical (1 byte):** An unsigned integer that specifies the next [Ptg](#ptg) in the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) associated with this natural language formula. MUST either by a PtgArea or a PtgAreaErr. + +### DuceStacked + +The type and meaning of the **DuceStacked** structure are specified by the type of the **eptg** field of the [Duce](#duce) structure that contains this structure, as specified in the following table: + +| Value | Meaning | +|----|----| +| 1 | This structure specifies an [SQElfFlags](#sqelfflags) that specifies additional undo data associated with the [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b). | +| 0 | This structure specifies an [RRLoc](#rrloc) that specifies the location affected by the natural language formula. | + +### Ducr + +The **Ducr** structure specifies undo data that is applied to an [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106) that was affected by an [insertion / deletion of rows / columns revision](#Section_6241f2cd16874b319cab2ff269a8e892) or a [move cells revision](#Section_a04c9efd436f48a59adff4752a2411ba) if the [**revision**](#gt_b799ab69-7abc-447e-b9f8-10cb8fd7016e) is rejected. + +[TABLE] + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**iptg (2 bytes):** An unsigned integer that specifies a zero-based index of a [Ptg](#ptg) structure in the array specified by the [Rgce](#rgce) structure associated with the affected expression. The referenced Ptg specifies which Ptg is affected by the revision. + +**ptg (1 byte):** The Ptg before the revision action occurred. + +**A - fLbl (1 bit):** A bit that specifies whether the affected expression is contained in a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + +**B - fUseSh2 (1 bit):** A bit that specifies whether the affected expression is on a different [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). MUST be zero for [RRDInsDel](#rrdinsdel). + +**reserved2 (6 bits):** MUST be zero, and MUST be ignored. + +**duce (variable):** A [Duce](#duce) that specifies additional undo data that is used for a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b). MUST exist if and only if **ptg** is equal to 0x18. + +**duceRadical (8 bytes):** A variable type field with the type and meaning determined by the value of **ptg**, as specified in the following table. MUST exist if and only if **ptg** is not equal to 0x18. + +| ptg Value | Type | +|----|----| +| [PtgRef](#ptgref) | A [RgceLoc8](#rgceloc8) that specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) reference originally contained by the expression. | +| [PtgRef3d](#ptgref3d) | A RgceLoc8 that specifies the cell reference originally contained by the expression. | +| [PtgArea](#ptgarea) | A [RgceArea](#rgcearea) that specifies a reference to a rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells originally contained by the expression. | +| [PtgArea3d](#ptgarea3d) | A RgceArea that specifies a reference to a rectangular range of cells originally contained by the expression. | +| All other values | MUST be zero, and MUST be ignored. | + +**ducr_cond_1 (variable):** A [DucrConditionalLbl](#ducrconditionallbl) that specifies defined name information associated with the affected expression. MUST exist if and only if **fLbl** equals 1. + +**ducr_cond_2 (6 bytes):** A [DucrConditionalNoLbl](#ducrconditionalnolbl) that specifies location information associated with the affected expression. MUST exist if and only if **fLbl** equals 0. + +### DucrConditionalLbl + +The **DucrConditionalLbl** structure specifies information associated with the [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) in the [Ducr](#ducr) structure. + +[TABLE] + +**tabid (2 bytes):** A [TabId](#tabid) that specifies the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing the defined name. A value of 0xFFFF specifies that the defined name is not associated with the sheet. + +**builtinIndex (1 byte):** An unsigned integer that specifies the identifier of a [**built-in name**](#gt_d40a51df-e96f-45ec-885d-6f936d172b39). MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------| +| 0x00 | Not a built-in name | +| 0x01 | The built-in name is "Consolidate_Area" | +| 0x02 | The built-in name is "Auto_Open" | +| 0x03 | The built-in name is "Auto_Close" | +| 0x04 | The built-in name is "Extract" | +| 0x05 | The built-in name is "Database" | +| 0x06 | The built-in name is "Criteria" | +| 0x07 | The built-in name is "Print_Area" | +| 0x08 | The built-in name is "Print_Titles" | +| 0x09 | The built-in name is "Recorder" | +| 0x0A | The built-in name is "Data_Form" | +| 0x0B | The built-in name is "Auto_Activate" | +| 0x0C | The built-in name is "Auto_Deactivate" | +| 0x0D | The built-in name is "Sheet_Title" | +| 0x0E | The built-in name is "\_FilterDatabase" | + +**unused (3 bytes):** Undefined and MUST be ignored. MUST exist if and only if **builtinIndex** is not equal to zero. + +**stDefName (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the defined name. MUST exist if and only if **builtinIndex** is equal to zero. + +### DucrConditionalNoLbl + +The **DucrConditionalNoLbl** structure specifies location information associated with the [Ducr](#ducr) structure. + +[TABLE] + +**tabid (2 bytes):** A [TabId](#tabid) that specifies the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing the affected [**expression**](#gt_6d43b116-acad-45af-aea5-a8e7240a1106). + +**loc (4 bytes):** An [RRLoc](#rrloc) that specifies the location of the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) containing the affected expression. The **fQuotesOnLabel** and **fNoDollarOnLabel** fields in the RRLoc structure are undefined and MUST be ignored. + +### DwQsiFuture + +The **DwQsiFuture** structure specifies option flags for a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289). + +[TABLE] + +**A - fPreserveFmt (1 bit):** A bit that specifies whether the user applied formatting is preserved. + +**B - fAutoFit (1 bit):** A bit that specifies whether columns be auto fit after a data [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060). + +**C - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**D - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**E - fExtDataList (1 bit):** A bit that specifies whether an [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) list is the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for the query table. + +**F - reserved3 (1 bit):** MUST be zero, and MUST be ignored. + +**G - fCreateQTList (1 bit):** A bit that specifies whether a query table list is to be created. + +**H - fDummyList (1 bit):** A bit that specifies whether a dummy query table list is created. + +**I - reserved4 (1 bit):** MUST be zero, and MUST be ignored. + +**reserved5 (7 bits):** MUST be zero, and MUST be ignored. + +**reserved6 (16 bits):** MUST be zero, and MUST be ignored. + +### DXFALC + +The **DXFALC** structure specifies the text alignment properties within a containing [DXFN](#dxfn) structure. + +[TABLE] + +**alc (3 bits):** A [**HorizAlign**](#horizalign) that specifies the [**horizontal alignment**](#gt_f0e60ca8-51d5-4553-9126-3d89a4d08f90) of the text. + +**A - fWrap (1 bit):** A bit that specifies the text display when the text is wider than the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +| Value | Meaning | +|-------|----------------------------------------------| +| 0 | The text is truncated. | +| 1 | The text is wrapped into more than one line. | + +**alcv (3 bits):** A [**VertAlign**](#vertalign) that specifies the [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878) of the text. + +**B - fJustLast (1 bit):** A bit that specifies whether cell text is [**justify distributed**](#gt_11eced66-af2c-4391-8b45-87a60ad41483). If **fJustLast is** 1 the text is justify distributed and **alc** MUST be 0x7. + +**trot (8 bits):** An [XFPropTextRotation](#xfproptextrotation) that specifies the text rotation. + +**cIndent (4 bits):** An unsigned integer that specifies the absolute level of indentation. The absolute level of indentation will replace any previous indentation. MUST be ignored when **iIndent** is not 255. MUST be less than or equal to 15. + +**C - fShrinkToFit (1 bit):** A bit that specifies whether the character sizes in the text MUST be reduced so that the text fits in the cell. + +**D - fMergeCell (1 bit):** A bit that specifies that the cell MUST be merged. + +**E - iReadingOrder (2 bits):** A [**ReadingOrder**](#readingorder) that specifies the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361). If **fZeroInited** in the parent structure is zero, then it is undefined and MUST be ignored. + +**unused (8 bits):** Undefined and MUST be ignored. + +**iIndent (4 bytes):** A signed integer that specifies the relative level of indentation. The relative level of indentation will be added to any previous indentation. The value MUST be greater than or equal to -15 and less than or equal to 255. The value SHOULD[\<163\>](#Appendix_A_163) be greater than or equal to -15 and less than or equal to 15, or be equal to 255. The values -250 through 250 specify a relative indentation level, and the value 255 specifies the absence of a relative indentation level. + +### DXFBdr + +The **DXFBdr** structure specifies the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) of [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) borders in a containing [DXFN](#dxfn) structure. + +[TABLE] + +**dgLeft (4 bits):** A [BorderStyle](#borderstyle) that specifies the grid [**line style**](#gt_a6d51057-258d-42cc-9920-6e08c10d2447) for the left [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) of the cell. + +**dgRight (4 bits):** A BorderStyle that specifies the grid line style for the right border of the cell. + +**dgTop (4 bits):** A BorderStyle that specifies the grid line style for the top border of the cell. + +**A - dgBottom (4 bits):** A BorderStyle that specifies the grid line style for the bottom border of the cell. + +**icvLeft (7 bits):** An [IcvXF](#icvxf) that specifies the color of the left border of the cell or unused. This value is unused and MUST be ignored if **dgLeft** is 0 or if the **glLeftNinch** field in the containing DXFN structure is 1. + +**icvRight (7 bits):** An IcvXF that specifies the color of the right border of the cell or unused. This value is unused and MUST be ignored if **dgRight** is 0 or if the **glRightNinch** field in the containing DXFN structure is 1. + +**B - bitDiagDown (1 bit):** A bit that specifies if the cell has a downward diagonal drawn. + +**C - bitDiagUp (1 bit):** A bit that specifies if the cell has an upward diagonal drawn. + +**icvTop (7 bits):** An IcvXF that specifies the color of the top border of the cell or unused. This value is unused and MUST be ignored if **dgTop** is 0 or if the **glTopNinch** field in the containing DXFN structure is 1. + +**icvBottom (7 bits):** An IcvXF that specifies the color of the bottom border of the cell or unused. This value is unused and MUST be ignored if **dgBottom** is 0 or if the **glBottomNinch** field in the containing DXFN structure is 1. + +**icvDiag (7 bits):** An IcvXF that specifies the color of the diagonals of the cell or unused. This value is unused and MUST be ignored if **dgDiag** is 0 or if the **glDiagDownNinch** and the **glDiagUpNinch** fields in the containing DXFN are both 1. + +**dgDiag (4 bits):** A BorderStyle that specifies the grid line style for the diagonals of the cell.. + +**unused (7 bits):** Undefined and MUST be ignored. + +### DXFFntD + +The **DXFFntD** structure specifies a [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) and its format attributes. + +[TABLE] + +**cchFont (1 byte):** An unsigned integer that specifies the number of characters of the font name string. + +**stFontName (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) that specifies the font name. MUST exist if and only if **cchFont** is greater than zero. The number of characters in the string is specified in **cchFont**. If **stFontName.fHighByte** equals 0x0, **cchFont** MUST be less than or equal to 62. If **stFontName.fHighByte** equals 0x1, **cchFont** MUST be less than or equal to 31. + +**unused1 (variable):** Undefined and MUST be ignored. The size of this field is 63 minus the size of the **stFontName** field. If the **stFontName** field doesn’t exist, the size of this field is 63. + +**stxp (16 bytes):** A [Stxp](#stxp) that specifies the font attributes. + +**icvFore (4 bytes):** An integer that specifies the color of the font. The value MUST be -1, 32767 or any of the valid values of the [IcvFont](#icvfont) structure. A value of -1 specifies that this value is ignored. A value of 32767 specifies that the color of the font is the default foreground text color. Any other value specifies the color of the font as specified in the IcvFont structure. + +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +**tsNinch (4 bytes):** A [Ts](#ts) structure that specifies how the value of **stxp.ts** is to be interpreted. If **tsNinch.ftsItalic** is set to 1 then the value of **stxp.ts.ftsItalic** MUST be ignored. If **tsNinch.ftsStrikeout** is set to 1 then the value of the **stxp.ts.ftsStrikeout** MUST be ignored. + +**fSssNinch (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the value of **stxp.sss** MUST be ignored. + +**fUlsNinch (4 bytes):** A Boolean that specifies whether the value of **stxp.uls** MUST be ignored. + +**fBlsNinch (4 bytes):** A Boolean that specifies whether the value of **stxp.bls** MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +**ich (4 bytes):** A signed integer that specifies the zero based index of the first character to which this font applies. MUST be greater than or equal to 0xFFFFFFFF. MUST be set to 0xFFFFFFFF when the font is to be updated. + +**cch (4 bytes):** A signed integer that specifies the number of characters to which this font applies. MUST be greater than or equal to **ich** field. MUST be set to 0xFFFFFFFF if the **ich** field is set to 0xFFFFFFFF. + +**iFnt (2 bytes):** An unsigned integer that specifies the font. If the value is 0 then the default font is used. If the value is greater than 0 then the font to be applied is determined by the font name specified in **stFontName**.  + +### DXFId + +The **DXFId** structure specifies a [DXF](#dxf) structure. + +[TABLE] + +**index (4 bytes):** An unsigned integer that specifies a zero-based index of a DXF record in the collection of DXF records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +### DXFN + +The **DXFN** structure specifies [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6). + +[TABLE] + +**A - alchNinch (1 bit):** A bit that specifies whether the value of **dxfalc**.**alc** MUST be ignored. + +**B - alcvNinch (1 bit):** A bit that specifies whether the value of **dxfalc**.**alcv** MUST be ignored. + +**C - wrapNinch (1 bit):** A bit that specifies whether the value of **dxfalc.fWrap** MUST be ignored. + +**D - trotNinch (1 bit):** A bit that specifies whether the value of **dxfalc.trot** MUST be ignored. + +**E - kintoNinch (1 bit):** A bit that specifies whether the value of **dxfalc.fJustLast** MUST be ignored . + +**F - cIndentNinch (1 bit):** A bit that specifies whether the values of **dxfalc.cIndent** and **dxfalc.iIndent** MUST be ignored. + +**G - fShrinkNinch (1 bit):** A bit that specifies whether the value of **dxfalc.fShrinkToFit** MUST be ignored. + +**H - fMergeCellNinch (1 bit):** A bit that specifies whether the value of **dxfalc.fMergeCell** MUST be ignored. + +**I - lockedNinch (1 bit):** A bit that specifies whether the value of **dxfprot.fLocked** MUST be ignored. + +**J - hiddenNinch (1 bit):** A bit that specifies whether the value of **dxfprot.fHidden** MUST be ignored. + +**K - glLeftNinch (1 bit):** A bit that specifies whether the values of **dxfbdr.dgLeft** and **dxfbdr.icvLeft** MUST be ignored . + +**L - glRightNinch (1 bit):** A bit that specifies whether the values of **dxfbdr.dgRight** and **dxfbdr.icvRight** MUST be ignored. + +**M - glTopNinch (1 bit):** A bit that specifies whether the values of **dxfbdr.dgTop** and **dxfbdr.icvTop** MUST be ignored. + +**N - glBottomNinch (1 bit):** A bit that specifies whether the values of **dxfbdr.dgBottom** and **dxfbdr.icvBottom** MUST be ignored. + +**O - glDiagDownNinch (1 bit):** A bit that specifies whether the value of **dxfbdr.bitDiagDown** MUST be ignored. When both **glDiagDownNinch** and **glDiagUpNinch** are set to 1, the values of **dxfbdr.dgDiag** and **dxfbdr**.**icvDiag** MUST be ignored. + +**P - glDiagUpNinch (1 bit):** A bit that specifies whether the value of **dxfbdr.bitDiagUp** MUST be ignored. When both **glDiagDownNinch** and **glDiagUpNinch** are set to 1, the values of **dxfbdr.dgDiag** and **dxfbdr**.**icvDiag** MUST be ignored. + +**Q - flsNinch (1 bit):** A bit that specifies whether the value of **dxfpat.fls** MUST be ignored. + +**R - icvFNinch (1 bit):** A bit that specifies whether the value of **dxfpat.icvForeground** MUST be ignored. + +**S - icvBNinch (1 bit):** A bit that specifies whether the value of **dxfpat.icvBackground** MUST be ignored. + +**T - ifmtNinch (1 bit):** A bit that specifies whether the value of **dxfnum.ifmt** MUST be ignored. + +**U - fIfntNinch (1 bit):** A bit that specifies whether the value of **dxffntd.ifnt** MUST be ignored. + +**V - unused1 (1 bit):** Undefined and MUST be ignored. + +**W - reserved1 (3 bits):** MUST be zero and MUST be ignored. + +**X - ibitAtrNum (1 bit):** A bit that specifies whether number formatting information is part of this structure. + +**Y - ibitAtrFnt (1 bit):** A bit that specifies whether [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information is part of this structure. + +**Z - ibitAtrAlc (1 bit):** A bit that specifies whether alignment information is part of this structure. + +**a - ibitAtrBdr (1 bit):** A bit that specifies whether [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad) information is part of this structure. + +**b - ibitAtrPat (1 bit):** A bit that specifies whether pattern information is part of this structure. + +**c - ibitAtrProt (1 bit):** A bit that specifies whether rotation information is part of this structure. + +**d - iReadingOrderNinch (1 bit):** A bit that specifies whether the value of **dxfalc.iReadingOrder** MUST be ignored. + +**e - fIfmtUser (1 bit):** A bit that specifies that the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) used is a user-defined [**format string**](#gt_07085e26-506a-4b35-81ad-972464e277ff). When set to 1, **dxfnum** contains a format string. + +**f - unused2 (1 bit):** Undefined and MUST be ignored. + +**g - fNewBorder (1 bit):** A bit that specifies how the [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) formats apply to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +| Value | Description | +|----|----| +| 0 | Border formats apply to all cells in the range. | +| 1 | Border formats only apply to the [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) of the range. | + +For example, if the bit is set to 1 and there is a left border format, that left border format will only apply to the cells on the left edge of the range of cells. + +**reserved2 (12 bits):** MUST be zero and MUST be ignored. + +**h - fZeroInited (1 bit):** A bit that specifies whether the value of **dxfalc.iReadingOrder** MUST be taken into account. + +**dxfnum (variable):** A [DXFNum](#dxfnum) that specifies the number formatting. MUST exist if and only if **ibitAtrNum** is nonzero. + +**dxffntd (variable):** A [DXFFntD](#dxffntd) that specifies the font. MUST exist if and only if **ibitAtrFnt** is nonzero. + +**dxfalc (8 bytes):** A [DXFALC](#dxfalc) that specifies the text alignment properties. MUST exist if and only if **ibitAtrAlc** is nonzero. + +**dxfbdr (8 bytes):** A [DXFBdr](#dxfbdr) that specifies the border properties. MUST exist if and only if **ibitAtrBdr** is nonzero. + +**dxfpat (4 bytes):** A [DXFPat](#dxfpat) that specifies the pattern and colors. MUST exist if and only if **ibitAtrPat** is nonzero. + +**dxfprot (2 bytes):** A [DXFProt](#dxfprot) that specifies the [**protection**](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499) attributes. MUST exist if and only if **ibitAtrProt** is nonzero. + +### DXFN12 + +The **DXFN12** structure specifies [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6) and is an extension to [DXFN](#dxfn). + +[TABLE] + +**cbDxf (4 bytes):** An unsigned integer that specifies the size of the structure in bytes. If greater than zero, it MUST be the total byte count of **dxfn** and **xfext**. Otherwise it MUST be zero. + +**reserved (2 bytes):** MUST be zero and MUST be ignored. MUST be omitted when **cbDxf** is greater than zero. + +**dxfn (variable):** A DXFN that specifies part of the differential formatting. MUST be omitted if **cbDxf** is 0x00000000. + +**xfext (variable):** An [XFExtNoFRT](#xfextnofrt) that specifies extensions for the differential formatting. MUST be omitted if **cbDxf** is equal to the byte count of **dxfn**. + +### DXFN12List + +The **DXFN12List** structure specifies [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6) used by [table block-level formatting](#Section_0c7947ddc8874a69a5cbc14494d21034). This structure also specifies extensions to the [DXFN](#dxfn) formatting properties. + +[TABLE] + +**dxfn (variable):** A DXFN structure that specifies differential formatting used by table block-level formatting. + +**xfext (variable):** An [XFExtNoFRT](#xfextnofrt) structure that specifies the set of extensions to the differential formatting properties specified in **dxfn**. MUST exist if and only if the size of this structure is greater than the size of the **dxfn** field. + +### DXFN12NoCB + +The **DXFN12NoCB** structure specifies [differential formatting](#Section_f0b6070c31f54d3dbcb719612da8b8f6) and is an extension to [DXFN](#dxfn). + +[TABLE] + +**dxfn (variable):** A DXFN that specifies part of the differential formatting. + +**xfext (variable):** An optional [XFExtNoFRT](#xfextnofrt) that specifies extensions for the differential formatting. + +### DXFNum + +The **DXFNum** structure specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) in a containing [DXFN](#dxfn) structure. Its type depends on the **fIfmtUser** field of DXFN + +| Value | Meaning | +|-------|---------------------------| +| 0 | [DXFNumIFmt](#dxfnumifmt) | +| 1 | [DXFNumUsr](#dxfnumusr) | + +### DXFNumIFmt + +The **DXFNumIFmt** structure specifies the number format in a containing [DXFN](#dxfn) structure when a format identifier is used. + +[TABLE] + +**unused (8 bits):** Undefined and MUST be ignored. + +**ifmt (8 bits):** An unsigned integer that specifies the identifier of the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) to use as specified in [IFmt](#ifmt). + +### DXFNumUsr + +The **DXFNumUsr** structure specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) in a containing [DXFN](#dxfn) structure when a [**format string**](#gt_07085e26-506a-4b35-81ad-972464e277ff) is used. + +[TABLE] + +**cb (2 bytes):** An unsigned integer that specifies the size of this structure, in bytes. + +**fmt (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the number format to use as specified in the **stFormat** field of [Format](#format). + +### DXFPat + +The **DXFPat** structure specifies the [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e) and color within a containing [DXFN](#dxfn) structure. + +[TABLE] + +**unused1 (10 bits):** Undefined and MUST be ignored. + +**fls (6 bits):** A [**FillPattern**](#fillpattern) that specifies the fill pattern. + +**icvForeground (7 bits):** An unsigned integer that specifies the color of the foreground of the cell. The value MUST be an [IcvXF](#icvxf) value. This value is unused and MUST be ignored if the **icvFNinch** field in the containing DXFN structure is 1. + +**icvBackground (7 bits):** An unsigned integer that specifies the color of the background of the cell. The value MUST be an IcvXF value. This value is unused and MUST be ignored if the **icvBNinch** field in the containing DXFN structure is 1. + +**A - unused2 (2 bits):** Undefined and MUST be ignored. + +### DXFProt + +The **DXFProt** structure specifies the protection attributes inside a containing [DXFN](#dxfn) structure. + +[TABLE] + +**A - fLocked (1 bit):** A bit that specifies if the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) content is locked when the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is protected. + +**B - fHidden (1 bit):** A bit that specifies if the cell content is hidden when the workbook is protected. + +**reserved (14 bits):** MUST be zero and MUST be ignored. + +### EnhancedProtection + +The **EnhancedProtection** structure specifies protection settings for [Shared Features](#Section_86882c8e8d6d46b3aafe006b9e1f18e2) of the Enhanced Protection type as specified by [SharedFeatureType](#sharedfeaturetype).ISFPROTECTION. These settings apply to a protected [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**A - iprotObjects (1 bit):** A bit that specifies whether [**linked objects**](#gt_cfc45e76-9219-4c47-9ef2-5832a172f795) or [**embedded objects**](#gt_708607be-8655-416e-93f3-b434e9ecbd56) can be edited. + +**B - iprotScenarios (1 bit):** A bit that specifies whether [**scenarios**](#gt_ee14f43c-19d8-467b-aa0b-e025635f6ba3) can be edited. + +**C - iprotFormatCells (1 bit):** A bit that specifies whether [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) can be formatted. + +**D - iprotFormatColumns (1 bit):** A bit that specifies whether columns can be formatted. + +**E - iprotFormatRows (1 bit):** A bit that specifies whether rows can be formatted. + +**F - iprotInsertColumns (1 bit):** A bit that specifies whether columns can be inserted. + +**G - iprotInsertRows (1 bit):** A bit that specifies whether rows can be inserted. + +**H - iprotInsertHyperlinks (1 bit):** A bit that specifies whether [**hyperlinks**](#gt_dbe6a2d4-1841-4b4a-a9f6-562c6df7897e) can be inserted. + +**I - iprotDeleteColumns (1 bit):** A bit that specifies whether columns can be deleted. + +**J - iprotDeleteRows (1 bit):** A bit that specifies whether rows can be deleted. + +**K - iprotSelLockedCells (1 bit):** A bit that specifies whether locked cells can be selected. + +**L - iprotSort (1 bit):** A bit that specifies whether cells can be sorted. + +**M - iprotAutoFilter (1 bit):** A bit that specifies whether cells can be filtered. + +**N - iprotPivotTables (1 bit):** A bit that specifies whether [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) reports can be created or modified. + +**O - iprotSelUnlockedCells (1 bit):** A bit that specifies whether unlocked cells can be selected. + +**reserved (17 bits):** MUST be zero, and MUST be ignored. + +### ExternDdeLinkNoOper + +The **ExternDdeLinkNoOper** structure specifies the data for a [DDE data item](#Section_2492b742489e489f945187a703134708) in the [ExternName](#externname) record. + +[TABLE] + +**reserved (4 bytes):** MUST be 0 and MUST be ignored. + +**linkName (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) that specifies the DDE data item name. The value MUST be "StdDocumentName". + +### ExternDocName + +The **ExternDocName** structure specifies the data for an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2) in the [ExternName](#externname) record. + +[TABLE] + +**ixals (2 bytes):** If the external defined name specified by **extName** is a [**local name**](#gt_6f2787cc-ab35-4cc1-bebd-fb120864d320), this unsigned integer specifies a one-based index of an [XLUnicodestring](#xlunicodestring) in the **rgst** field of the preceding [SupBook](#supbook) record. The XLUnicodestring specifies the name of the sheet where the external defined name specified by **extName** is scoped. Otherwise this MUST be 0. The value MUST be less than or equal to the value of the **ctab** field in the preceding SupBook record. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**extName (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) that specifies the name of the external defined name. **extName.cch** MUST be less than or equal to 255. + +**nameDefinition (variable):** An [ExtNameParsedFormula](#extnameparsedformula) that specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) of the external defined name. + +### ExternOleDdeLink + +The **ExternOleDdeLink** structure specifies the data for an [OLE data item](#Section_11cff7c06cf34f8694bede7a72497e21) or a [DDE data item](#Section_2492b742489e489f945187a703134708) in the [ExternName](#externname) record. If the **fOleLink** field in the owned ExternName record is 1, the referenced item MUST be an OLE data item. + +[TABLE] + +**lStgName (4 bytes):** An unsigned integer that specifies a [link storage](#Section_a05f262bbc9a44be88b4eba16b41ac6b) that specifies the linked [**OLE**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) object. This name of the link storage MUST be the concatenation of "LNK" and the eight byte hexadecimal representation of this value. The value MUST be 0 for a DDE data item. + +**linkName (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) that specifies the name of OLE data item or DDE data item. **linkName.cch** MUST be less than or equal to 255. + +**moper (variable):** An optional [MOper](#moper) that specifies current [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) values for the linked data. This field MUST exist if and only if + +(byte size of owning ExternName record – 6 – byte size of **linkName** \> 0). + +### ExtProp + +The **ExtProp** structure specifies an extension to a formatting property. + +[TABLE] + +**extType (2 bytes):** An unsigned integer that specifies the type of the extension. MUST be a value from the table as specified in the **extPropData** field. + +**cb (2 bytes):** An unsigned integer that specifies the size of this ExtProp structure. + +**extPropData (variable):** This field specifies the extension data. The size and data type of this field varies based on the property type as specified in **extType** as follows: + +| extType value | extPropData field Data and Meaning | +|----|----| +| 0x0004 | A [FullColorExt](#fullcolorext) that specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) interior [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a). | +| 0x0005 | A FullColorExt that specifies the cell interior [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c). | +| 0x0006 | An [XFExtGradient](#xfextgradient) that specifies a cell interior [**gradient fill**](#gt_35280309-5b22-4c17-be48-f06c37ffc685). | +| 0x0007 | A FullColorExt that specifies the top cell border color. | +| 0x0008 | A FullColorExt that specifies the bottom cell border color. | +| 0x0009 | A FullColorExt that specifies the left cell border color. | +| 0x000A | A FullColorExt that specifies the right cell border color. | +| 0x000B | A FullColorExt that specifies the diagonal cell border color. | +| 0x000D | A FullColorExt that specifies the cell text color. | +| 0x000E | A 2-byte unsigned integer that specifies a [**FontScheme**](#fontscheme). | +| 0x000F | A 2-byte unsigned integer that specifies the text [**indentation level**](#gt_2779d3df-3c50-44dc-9d2d-6996c4573aa9). MUST be less than or equal to 250. | + +### ExtRst + +The **ExtRst** structure specifies [**phonetic string**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77) data. + +[TABLE] + +**reserved (2 bytes):** MUST be 1, and MUST be ignored. + +**cb (2 bytes):** An unsigned integer that specifies the size, in bytes, of the phonetic string data. + +**phs (4 bytes):** A [Phs](#phs) that specifies the formatting information for the phonetic string. + +**rphssub (variable):** An [RPHSSub](#rphssub) that specifies the phonetic string. + +**rgphruns (variable):** An array of [PhRuns](#phruns). This specifies the [**phonetic text runs**](#gt_02ee536f-14c0-451a-9d66-111431897cac). Each PhRuns specifies a phonetic text run within **rphssub.st** that is displayed above a [**text run**](#gt_393612a7-9552-48b0-abf6-0371dbd6d553) in the **rgb** field of the [XLUnicodeRichExtendedString](#xlunicoderichextendedstring) that contains this structure. The first character of the phonetic text run is the character specified by the **ichFirst** field of PhRuns. The first character in the **rgb** field of the XLUnicodeRichExtendedString that contains this structure that the phonetic text run appears earlier is specified by the **ichMom** field of PhRuns. Each **ichMom** field of a PhRuns in the array MUST be less than the **ichMom** field of the subsequent PhRuns in the array. Each **ichFirst** field of a PhRuns in the array MUST be less than the **ichFirst** of the subsequent PhRuns in the array. The sum of the **cchMom** fields of all PhRuns in the array MUST be less than or equal to the number of characters in **rgb** field of the XLUnicodeRichExtendedString that contains this structure. The number of elements in this array is **rphssub.crun**. + +### FactoidData + +The **FactoidData** structure specifies information about a [**smart tag**](#gt_2f57a49a-d503-4605-8798-0e53bd637609). + +[TABLE] + +**A - fDelete (1 bit):** A bit that specifies whether the smart tag is deleted. + +**B - fXMLBased (1 bit):** A bit that specifies whether the smart tag is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85)-based. For more information about XML-based smart tags, see [\[MSDN-OSTD\]](https://go.microsoft.com/fwlink/?LinkId=120036). + +**reserved (6 bits):** MUST be 0, and MUST be ignored. + +**propertyBag (variable):** A PropertyBag as defined in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.4.3 that specifies smart tag properties. Each entry in the PropertyBag is a pair of indexes into the **stringTable** field of the PropertyBagStore as defined in \[MS-OSHARED\] section 2.3.4.1 that specify the key/value pair representing a property of the smart tag. + +### Feat11CellStruct + +The **Feat11CellStruct** structure specifies a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +[TABLE] + +**idxRow (4 bytes):** An unsigned integer that specifies the row identifier of the row in the table. The row identifiers are stored in a table column with the **strName** of [Feat11FieldDataItem](#feat11fielddataitem) equal to "ID". The row identifier specified in this field MUST match a row identifier stored in the **LISTDATA** element of the [List Data](#Section_914f09bd8c944c099e8631dfe058f037) stream. It MUST also match a row identifier stored in the **LISTSCHEMA** element of the List Data stream, under the Field node, where the "name" attribute of the Field node is equal to "ID". + +**idxField (4 bytes):** An unsigned integer that specifies a column identifier. MUST be equal to the **idField** field of an item in the fielddata array of the containing [*TableFeatureType*](#tablefeaturetype) structure. + +### Feat11FdaAutoFilter + +The **Feat11FdaAutoFilter** structure specifies the definition of an automatically generated [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda), or [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). + +[TABLE] + +**cbAutoFilter (4 bytes):** An unsigned integer that specifies the size, in bytes, of the **recAutoFilter** field. MUST be less than or equal to 2080 bytes. + +**unused (2 bytes):** Undefined and MUST be ignored. + +**recAutoFilter (variable):** An [AutoFilter](#autofilter) structure that specifies the filter that is applied to the [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) column. + +### Feat11FieldDataItem + +The **Feat11FieldDataItem** structure specifies a column of a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +[TABLE] + +**idField (4 bytes):** An unsigned integer that specifies the identifier of the column. MUST be nonzero and MUST be unique within the **FieldData** array in the containing [TableFeatureType](#tablefeaturetype) structure. + +**lfdt (4 bytes):** An unsigned integer that specifies the column’s Web based data provider data type. If the **lt** field of the containing TableFeatureType structure is not set to 0x00000001, this field MUST be 0x00000000; otherwise it MUST be a value from the following table. For more details about the data types, see [\[MS-WSSTS\]](%5bMS-WSSTS%5d.pdf#Section_52b95801d55f4d63a1c3b4e857c43b31) section 2.3. + +| Value | Web Based Data Provider Data Type | +|------------|-----------------------------------------------------| +| 0x00000001 | Text | +| 0x00000002 | Number | +| 0x00000003 | Boolean | +| 0x00000004 | Date Time | +| 0x00000005 | Note | +| 0x00000006 | Currency | +| 0x00000007 | Lookup | +| 0x00000008 | Choice | +| 0x00000009 | [**URL**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) | +| 0x0000000A | Counter | +| 0x0000000B | Multiple Choices | + +**lfxidt (4 bytes):** An unsigned integer that specifies the column’s [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) data type. If the **lt** field of the containing TableFeatureType structure is not set to 0x00000002, this field MUST be 0x00000000; otherwise it MUST be a value from the following table. For more information about the data types, see [\[MSDN-SOM\]](https://go.microsoft.com/fwlink/?LinkID=156653&clcid=0x409). + +| Value | MS-XML Data Type | +|------------|-------------------------------------| +| 0x00001000 | SOMITEM_SCHEMA | +| 0x00001001 | SOMITEM_ATTRIBUTE | +| 0x00001002 | SOMITEM_ATTRIBUTEGROUP | +| 0x00001003 | SOMITEM_NOTATION | +| 0x00001100 | SOMITEM_IDENTITYCONSTRAINT | +| 0x00001101 | SOMITEM_KEY | +| 0x00001102 | SOMITEM_KEYREF | +| 0x00001103 | SOMITEM_UNIQUE | +| 0x00002000 | SOMITEM_ANYTYPE | +| 0x00002100 | SOMITEM_DATATYPE | +| 0x00002101 | SOMITEM_DATATYPE_ANYTYPE | +| 0x00002102 | SOMITEM_DATATYPE_ANYURI | +| 0x00002103 | SOMITEM_DATATYPE_BASE64BINARY | +| 0x00002104 | SOMITEM_DATATYPE_BOOLEAN | +| 0x00002105 | SOMITEM_DATATYPE_BYTE | +| 0x00002106 | SOMITEM_DATATYPE_DATE | +| 0x00002107 | SOMITEM_DATATYPE_DATETIME | +| 0x00002108 | SOMITEM_DATATYPE_DAY | +| 0x00002109 | SOMITEM_DATATYPE_DECIMAL | +| 0x0000210A | SOMITEM_DATATYPE_DOUBLE | +| 0x0000210B | SOMITEM_DATATYPE_DURATION | +| 0x0000210C | SOMITEM_DATATYPE_ENTITIES | +| 0x0000210D | SOMITEM_DATATYPE_ENTITY | +| 0x0000210E | SOMITEM_DATATYPE_FLOAT | +| 0x0000210F | SOMITEM_DATATYPE_HEXBINARY | +| 0x00002110 | SOMITEM_DATATYPE_ID | +| 0x00002111 | SOMITEM_DATATYPE_IDREF | +| 0x00002112 | SOMITEM_DATATYPE_IDREFS | +| 0x00002113 | SOMITEM_DATATYPE_INT | +| 0x00002114 | SOMITEM_DATATYPE_INTEGER | +| 0x00002115 | SOMITEM_DATATYPE_LANGUAGE | +| 0x00002116 | SOMITEM_DATATYPE_LONG | +| 0x00002117 | SOMITEM_DATATYPE_MONTH | +| 0x00002118 | SOMITEM_DATATYPE_MONTHDAY | +| 0x00002119 | SOMITEM_DATATYPE_NAME | +| 0x0000211A | SOMITEM_DATATYPE_NCNAME | +| 0x0000211B | SOMITEM_DATATYPE_NEGATIVEINTEGER | +| 0x0000211C | SOMITEM_DATATYPE_NMTOKEN | +| 0x0000211D | SOMITEM_DATATYPE_NMTOKENS | +| 0x0000211E | SOMITEM_DATATYPE_NONNEGATIVEINTEGER | +| 0x0000211F | SOMITEM_DATATYPE_NONPOSITIVEINTEGER | +| 0x00002120 | SOMITEM_DATATYPE_NORMALIZEDSTRING | +| 0x00002121 | SOMITEM_DATATYPE_NOTATION | +| 0x00002122 | SOMITEM_DATATYPE_POSITIVEINTEGER | +| 0x00002123 | SOMITEM_DATATYPE_QNAME | +| 0x00002124 | SOMITEM_DATATYPE_SHORT | +| 0x00002125 | SOMITEM_DATATYPE_STRING | +| 0x00002126 | SOMITEM_DATATYPE_TIME | +| 0x00002127 | SOMITEM_DATATYPE_TOKEN | +| 0x00002128 | SOMITEM_DATATYPE_UNSIGNEDBYTE | +| 0x00002129 | SOMITEM_DATATYPE_UNSIGNEDINT | +| 0x0000212A | SOMITEM_DATATYPE_UNSIGNEDLONG | +| 0x0000212B | SOMITEM_DATATYPE_UNSIGNEDSHORT | +| 0x0000212C | SOMITEM_DATATYPE_YEAR | +| 0x0000212D | SOMITEM_DATATYPE_YEARMONTH | +| 0x000021FF | SOMITEM_DATATYPE_ANYSIMPLETYPE | +| 0x00002200 | SOMITEM_SIMPLETYPE | +| 0x00002400 | SOMITEM_COMPLEXTYPE | +| 0x00004000 | SOMITEM_PARTICLE | +| 0x00004001 | SOMITEM_ANY | +| 0x00004002 | SOMITEM_ANYATTRIBUTE | +| 0x00004003 | SOMITEM_ELEMENT | +| 0x00004100 | SOMITEM_GROUP | +| 0x00004101 | SOMITEM_ALL | +| 0x00004102 | SOMITEM_CHOICE | +| 0x00004103 | SOMITEM_SEQUENCE | +| 0x00004104 | SOMITEM_EMPTYPARTICLE | +| 0x00000800 | SOMITEM_NULL | +| 0x00002800 | SOMITEM_NULL_TYPE | +| 0x00004801 | SOMITEM_NULL_ANY | +| 0x00004802 | SOMITEM_NULL_ANYATTRIBUTE | +| 0x00004803 | SOMITEM_NULL_ELEMENT | + +**ilta (4 bytes):** An unsigned integer that specifies the [**aggregation function**](#gt_f9b44a9d-68c4-4a28-b347-cce9eb5f8845) to use for the [**total row**](#gt_95e9bcf4-d644-4e96-9070-dbc80b4d1b28) of the column. MUST be a value from the following table: + +| Value | Aggregation Formula | +|----|----| +| 0x00000000 | No formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) | +| 0x00000001 | Average | +| 0x00000002 | Count | +| 0x00000003 | Count Numbers | +| 0x00000004 | Max | +| 0x00000005 | Min | +| 0x00000006 | Sum | +| 0x00000007 | Standard Deviation | +| 0x00000008 | Variance | +| 0x00000009 | Custom formula[\<164\>](#Appendix_A_164) | + +**cbFmtAgg (4 bytes):** An unsigned integer that specifies the size, in bytes, of the **dxfFmtAgg** field. + +**istnAgg (4 bytes):** An unsigned integer that specifies the zero-based index of the [Style](#style) record in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) that is used for the total row of the column. If this value equals 0xFFFFFFFF, the total row of the column uses built-in [table styles](#Section_4ac7212b4aa74ece962526c58224ae80). + +**A - fAutoFilter (1 bit):** A bit that specifies whether the column has an [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). + +**B - fAutoFilterHidden (1 bit):** A bit that specifies whether the column has an AutoFilters that is not displayed. When this field is set to 1, **fAutoFilter** MUST be set to 1. + +**C - fLoadXmapi (1 bit):** A bit that specifies whether the **rgXmap** field is present. MUST be 0 if the **lt** field of the containing TableFeatureType structure is not equal to 0x00000002. + +**D - fLoadFmla (1 bit):** A bit that specifies whether the **fmla** field is present for a table whose [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is a Web based data provider list. MUST be 0 if the **lt** field of the containing TableFeatureType structure is not equal to 0x00000001. + +**E - unused1 (2 bits):** Undefined, and MUST be ignored. + +**F - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**G - fLoadTotalFmla (1 bit):** A bit that specifies whether the **totalFmla** field is present. SHOULD[\<165\>](#Appendix_A_165) be 1 if **ilta** is 0x00000009, MUST be 0 otherwise. + +**H - fLoadTotalArray (1 bit):** A bit that specifies whether the formula specified by **totalFmla** is an array formula. MUST be 0 when **fLoadTotalFmla** is 0. + +**I - fSaveStyleName (1 bit):** A bit that specifies whether the **dskHdrCache.strStyleName** field is present. + +**J - fLoadTotalStr (1 bit):** A bit that specifies whether the **strTotal** field is present. MUST be 0 when **ilta** is not 0x00000000. + +**K - fAutoCreateCalcCol (1 bit):** A bit that specifies whether the column has a calculated column formula. MUST be 0 if the **lt** field of the containing TableFeatureType structure is set to 0x00000001. + +**unused2 (20 bits):** Undefined, and MUST be ignored. + +**cbFmtInsertRow (4 bytes):** An unsigned integer that specifies the size, in bytes, of the **dxfFmtInsertRow** field. + +**istnInsertRow (4 bytes):** An unsigned integer that specifies the zero-based index of the Style record in the Globals Substream ABNF that is used for the [**insert row**](#gt_3b3c223b-83e0-4697-85eb-815af907b8a9) of the column. If this value equals 0xFFFFFFFF, the insert row of the column uses built-in table styles. + +**strFieldName (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the name of the column, as provided by the data source. MUST contain at least one character and less than or equal to 255 characters. MUST be unique within the **FieldData** array in the containing TableFeatureType structure if the **lt** field of the containing TableFeatureType structure is set to 0x00000001 or 0x00000003. + +**strCaption (variable):** An XLUnicodeString that specifies the caption of the column. MUST contain at least one character and less than or equal to 255 characters. MUST be unique within the **FieldData** array in the containing TableFeatureType structure. MUST be equal to the value within the header [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) at the location of the column title if the **crwHeader** field of the containing TableFeatureType structure is greater than 0. This field is present if and only if the **fSingleCell** field of the containing TableFeatureType structure is set to 0. MUST NOT contain the characters from the following table: + +| Invalid Characters | Unicode range | +|----|----| +| Lower control characters | 0x0000-0x0031 | +| Invalid Unicode surrogate pairs | High surrogate with a value of 0xD800 to 0xDBFF followed by a low surrogate with a value of 0xDC00 to 0xDFFF. | +| Reserved characters | 0xFFFE, 0xFFFF, 0xF00B | + +**dxfFmtAgg (variable):** A [DXFN12List](#dxfn12list) that specifies the formatting of the total row of the column, if different from the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) specified by **istnAgg** or built-in table styles. This field is present if and only if the **cbFmtAgg** field is greater than 0x00000000. + +**dxfFmtInsertRow (variable):** A DXFN12List that specifies the formatting of the insert row of the column, if different from the style specified by **istnInsertRow** or built-in table styles. This field is present if and only if the **cbFmtInsertRow** field is more than 0x00000000. + +**AutoFilter (variable):** A [Feat11FdaAutoFilter](#feat11fdaautofilter) that specifies the characteristics of the AutoFilter for the column. This field is present if and only if the **fAutoFilter** field of the containing TableFeatureType structure is set to 1. + +**rgXmap (variable):** A [Feat11XMap](#feat11xmap) structure that specifies the mapping to the column data within an XML data source. This field is present if and only if the **fLoadXmapi** bit is set to 1. + +**fmla (variable):** A [Feat11Fmla](#feat11fmla) structure that specifies the [**column formula**](#gt_7b63f871-4ee8-4516-94b7-4087034fd569) whose data source is a Web based data provider list. The specified formula applies to every row of the column, except the total row and the [**header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38). This field is present if and only if the **fLoadFmla** bit is set to 1. + +**totalFmla (variable):** A [Feat11TotalFmla](#feat11totalfmla) structure that specifies the formula to use for the total row of the column. This field is present if and only if the **fLoadTotalFmla** bit is set to 1. + +**strTotal (variable):** An XLUnicodeString structure that specifies the text to use for the total row of the column. MUST contain less than or equal to 32767 characters. This field is present if and only if the **fLoadTotalStr** bit is set to 1. + +**wssInfo (variable):** A [Feat11WSSListInfo](#feat11wsslistinfo) that specifies the relationship between the column and a Web based data provider list. This field is present if and only if the **lt** field of the containing TableFeatureType structure is set to 0x00000001. + +**qsif (4 bytes):** An unsigned integer that specifies the relationship between the column and its Microsoft Query data source. MUST be equal to the **idField** field of a [Qsif](#qsif) record within the [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56). This field is present if and only if the **lt** field of the containing TableFeatureType structure is set to 0x00000003 (External data source). MUST be greater than zero and MUST be unique within the **FieldData** array in the containing TableFeatureType structure. + +**dskHdrCache (variable):** A [CachedDiskHeader](#cacheddiskheader) that specifies the column header formatting information. This field is present if and only if the **crwHeader** field of the containing TableFeatureType structure is set to 0x0000 and the **fSingleCell** field of the containing TableFeatureType structure is set to 0. + +### Feat11Fmla + +The **Feat11Fmla** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that is used as a [**column formula**](#gt_7b63f871-4ee8-4516-94b7-4087034fd569). + +[TABLE] + +**cbFmla (2 bytes):** An unsigned integer that specifies the size, in bytes, of the **rgbFmla** field. + +**rgbFmla (variable):** A [ListParsedFormula](#listparsedformula) that specifies the [parsed expression](#Section_a795978bfa7845788e2dc07d78edae0e) of the column formula. + +### Feat11RgInvalidCells + +The **Feat11RgInvalidCells** structure specifies the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) linked to a Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) which could not be synchronized. + +[TABLE] + +**cCellInvalid (2 bytes):** An unsigned integer that specifies the number of items in the **rgCellInvalid** field. + +**rgCellInvalid (variable):** An array of [Feat11CellStruct](#feat11cellstruct) that specifies the cells that could not be synchronized with a Web-based data provider data source. + +### Feat11RgSharepointIdChange + +The **Feat11RgSharepointIdChange** structure specifies the identifier of modified rows in a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) linked to a Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). This information is used when synchronizing between the local copy of the table, and the Web-based data provider. + +[TABLE] + +**cId (2 bytes):** An unsigned integer that specifies the number of elements in **rgId**. + +**rgId (variable):** An array of 4-byte unsigned integers that specifies identifiers of rows that were modified. The length of the array is specified by the **cId** field, and each entry of the array specifies the identifier of one row. The row identifier specified in this field MUST match a row identifier stored in the **LISTDATA** element of the [List Data](#Section_914f09bd8c944c099e8631dfe058f037) stream, as well as the row identifier stored in the column with a title "ID" in the table. + +### Feat11RgSharepointIdDel + +The **Feat11RgSharepointIdDel** structure specifies the identifier of deleted rows in a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) linked to a Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). This information is used when synchronizing between the local copy of the table, and the Web-based data provider. + +[TABLE] + +**cId (2 bytes):** An unsigned integer that specifies the number of elements in **rgId**. + +**rgId (variable):** An array of 4-byte unsigned integers that specifies identifiers of rows that were deleted. The length of the array is specified by the **cId** field, and each entry of the array specifies the identifier of one row. The row identifier specified in this field MUST match a row identifier stored in the **LISTDATA** element of the [List Data](#Section_914f09bd8c944c099e8631dfe058f037) stream. + +### Feat11TotalFmla + +The **Feat11TotalFmla** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that can be used as a [**total row**](#gt_95e9bcf4-d644-4e96-9070-dbc80b4d1b28) formula[\<166\>](#Appendix_A_166). + +[TABLE] + +**rgbFmlaTotal (variable):** A [ListParsedFormula](#listparsedformula) or [ListParsedArrayFormula](#listparsedarrayformula) that specifies the [parsed expression](#Section_a795978bfa7845788e2dc07d78edae0e) of the total row formula. When the **fLoadTotalArray** field of the containing [Feat11FieldDataItem](#feat11fielddataitem) structure is set to 1, this field is a ListParsedArrayFormula; otherwise, it is a ListParsedFormula. + +### Feat11WSSListInfo + +The **Feat11WSSListInfo** structure specifies the relationship between a table column and a Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list. + +[TABLE] + +**LCID (4 bytes):** An unsigned integer that specifies the [**language code identifier (LCID)**](#gt_c7f99c66-592f-4053-b62a-878c189653b6) of the source data. + +**cDec (4 bytes):** An unsigned integer that specifies the number of decimal places for a numeric column. + +**A - fPercent (1 bit):** A bit that specifies whether the numeric values in the column are displayed as percentages. + +**B - fDecSet (1 bit):** A bit that specifies whether the numeric values in the column are displayed with a fixed decimal point. The position of the decimal point is specified by the **cDec** field. + +**C - fDateOnly (1 bit):** A bit that specifies whether only the date part of date/time values is displayed. + +**D - fReadingOrder (2 bits):** An unsigned integer that specifies the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | Reading order is determined by the application based on the reading order of the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) surrounding the table. | +| 0x1 | Reading order is [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067). | +| 0x2 | Reading order is [**right-to-left**](#gt_91359688-7863-4e88-b507-f57b3dada5ec). | + +**E - fRichText (1 bit):** A bit that specifies whether the column contains rich text. + +**F - fUnkRTFormatting (1 bit):** A bit that specifies whether the column contains unrecognized rich text formatting. + +**G - fAlertUnkRTFormatting (1 bit):** A bit that specifies whether the column contains unrecognized rich text formatting that requires notifying the user. + +**unused1 (24 bits):** Undefined and MUST be ignored. + +**H - fReadOnly (1 bit):** A bit that specifies whether the column is read only. + +**I - fRequired (1 bit):** A bit that specifies whether every item in this column has to contain data. + +**J - fMinSet (1 bit):** A bit that specifies whether a minimum numeric value for the column exists. The minimum value is stored in the [List Data](#Section_914f09bd8c944c099e8631dfe058f037) stream within the LISTSCHEMA element, under the Field node's Min attribute. + +**K - fMaxSet (1 bit):** A bit that specifies whether a maximum numeric value for the column exists. The maximum value is stored in the List Data stream within the LISTSCHEMA element, under the Field node's Max attribute. + +**L - fDefaultSet (1 bit):** A bit that specifies whether there is a default value for the column. + +**M - fDefaultDateToday (1 bit):** A bit that specifies whether the default value for the column is the current date. + +**N - fLoadFormula (1 bit):** A bit that specifies whether a validation formula exists for this column. The formula is specified by the **strFormula** field. + +**O - fAllowFillIn (1 bit):** A bit that specifies whether a choice field allows custom user entries. + +**bDefaultType (8 bits):** An unsigned integer that specifies the type of the **rgbDV** default value. This field MUST be ignored if **fDefaultSet** is not 0x1; otherwise, it MUST be a value from the following table: + +| Value | Meaning | +|-------|--------------------------------------| +| 0x00 | There is no default value specified. | +| 0x01 | **rgbDV** is a string. | +| 0x02 | **rgbDV** is a Boolean. | +| 0x03 | **rgbDV** is a number. | + +**unused2 (16 bits):** Undefined, MUST be ignored. + +**rgbDV (variable):** A field of variable data type that specifies the default value for the column. The data type is specified in the **lfdt** field of the containing [Feat11FieldDataItem](#feat11fielddataitem) structure. MUST be one of the data types specified in the following table: + +| lfdt of the containing Feat11FieldDataItem | Data Type | rgbDV data type and meaning | +|----|----|----| +| 0x00000001 | Short Text | An [XLUnicodeString](#xlunicodestring) with a maximum length of 255 [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters. | +| 0x00000002 | Number | An Xnum (section [2.5.342](#xnum)). | +| 0x00000003 | Yes/No | A 32-bit Boolean (section [2.5.14](#boolean)). | +| 0x00000004 | Date time | A [DateAsNum](#dateasnum). | +| 0x00000005 | Invalid | **rgbDV** does not exist. | +| 0x00000006 | Currency | An Xnum. | +| 0x00000007 | Invalid | **rgbDV** does not exist. | +| 0x00000008 | Choice | An XLUnicodeString with a maximum length of 255 Unicode characters. | +| 0x00000009 | Invalid | **rgbDV** does not exist. | +| 0x0000000A | Invalid | **rgbDV** does not exist. | +| 0x0000000B | Multi-choice | An XLUnicodeString with a maximum length of 255 Unicode characters. | + +**strFormula (variable):** An XLUnicodeString that specifies the validation formula as defined by the Web based data provider. This field exists if and only if **fLoadFormula** is set to 0x1. + +**reserved (4 bytes):** MUST be 0x00000000, and MUST be ignored. + +### Feat11XMap + +The **Feat11XMap** structure specifies the mapping between a table column’s data and an XML [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + +[TABLE] + +**iXmapMac (2 bytes):** An unsigned integer that specifies the number of items in the **rgXmap** array. MUST be less than or equal to 0x0001. + +**rgXmap (variable):** An array of [Feat11XMapEntry](#feat11xmapentry) that specifies the mapping between the current table column and an XML data source. The number of items in **rgXmap** MUST be equal to **iXmapMac**. + +### Feat11XMapEntry + +The **Feat11XMapEntry** structure specifies a mapping to an XML [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + +[TABLE] + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - fLoadXMap (1 bit):** MUST be 1, and MUST be ignored. + +**C - fCanBeSingle (1 bit):** A bit that specifies whether **details**.**rgbXPath** resolves to a single [**XML node**](#gt_76e94022-1e78-4323-b8ba-cf7776e6b8d4) or a collection of XML nodes. This field MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | Specifies that **details**.**rgbXPath** resolves to a collection of XML nodes. | +| 1 | Specifies that **details**.**rgbXPath** resolves to a single XML node. | + +**D - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**reserved3 (28 bits):** MUST be zero, and MUST be ignored. + +**details (variable):** A [Feat11XMapEntry2](#feat11xmapentry2) that specifies the mapping between the data and the XML data source. + +### Feat11XMapEntry2 + +The **Feat11XMapEntry2** structure specifies the mapping to an [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + +[TABLE] + +**dwMapId (4 bytes):** An unsigned integer that specifies the [**XML schema**](#gt_bd0ce6f9-c350-4900-827e-951265294067) associated with this [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) column. The value MUST equal the value of the **ID** attribute of a **Map** element contained within the **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)). + +**rgbXPath (variable):** An [XLUnicodeString](#xlunicodestring) that contains the [**XPath expression**](#gt_02004611-da4e-45c1-a960-d268be5bb72c) that specifies the mapped element in the XML schema specified by **dwMapId**. The length of this string MUST be less than 32000. + +### FeatFormulaErr2 + +The **FeatFormulaErr2** structure specifies formula evaluation information for a [Shared Feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2) of type ISFFEC2 as specified in [SharedFeatureType](#sharedfeaturetype). + +[TABLE] + +**grffecIgnore (4 bytes):** A [FFErrorCheck](#fferrorcheck) that specifies the type of errors that will be ignored. + +### FeatProtection + +The **FeatProtection** structure specifies data for a [shared feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2). + +[TABLE] + +**A - fSD (1 bit):** A bit that specifies whether this structure contains self-relative [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) data. For more information about self-relative security descriptors see [\[MSDN-ASRSD\]](https://go.microsoft.com/fwlink/?LinkId=119907). + +**reserved (31 bits):** MUST be zero, and MUST be ignored. + +**wPassword (4 bytes):** An unsigned integer that specifies the verifier for the password required to edit the referenced [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of a [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829) [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). A value of zero indicates that the password is empty. The algorithm to generate the password verifier is documented in the [password verifier algorithm](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4). + +**stTitle (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the title for this [**protection**](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499) feature. + +**sdContainer (variable):** An [SDContainer](#sdcontainer) that specifies security information that identifies who can edit the referenced ranges of a protected sheet without needing a password. + +### FeatSmartTag + +The **FeatSmartTag** structure specifies data for a [Shared Feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2) of type ISFFACTOID as described in [SharedFeatureType](#sharedfeaturetype). + +[TABLE] + +**hashValue (4 bytes):** An unsigned integer that specifies a [**hash**](#gt_b7e2b611-0af5-4fec-8af2-3f9ce7bad205) value for the string representation of the content of a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). This hash value is used to detect cell changes with the purpose of validating, updating or removing the [**smart tags**](#gt_2f57a49a-d503-4605-8798-0e53bd637609) associated with the cell. If the string representation of the cell content is the empty string, **hashValue** MUST be 0; otherwise, **hashValue** MUST be computed using the following algorithm: + +424. SET hashValue to zero + + FOR each byteValue (1-byte unsigned integer) in the input string + + Bitwise shift hashValue to the left by 4 and add byteValue + + SET overflow (4-byte unsigned integer) to the bitwise AND of hashValue and 0xF0000000 + + IF overflow is not zero THEN + + SET the most significant 4 bits of hashValue to zero + + Bitwise shift overflow to the right by 24 + + SET hashValue to XOR of hashValue and overflow + + END IF + + END FOR + + IF hashValue is zero + + SET hashValue to 1 + + END IF + +**cSmartTags (1 byte):** An unsigned integer that specifies the number of items in the **rgFactoid** array. + +**rgFactoid (variable):** An array of [FactoidData](#factoiddata). Each element specifies data for a smart tag. + +### FFErrorCheck + +The **FFErrorCheck** structure specifies the types of error conditions that can be checked in a formula evaluation for a [Shared Feature](#Section_86882c8e8d6d46b3aafe006b9e1f18e2). + +[TABLE] + +**A - ffecCalcError (1 bit):** A bit that specifies whether to check for calculation errors. + +**B - ffecEmptyCellRef (1 bit):** A bit that specifies whether to check for references to empty cells. + +**C - ffecNumStoredAsText (1 bit):** A bit that specifies whether to check the format of numeric values. + +**D - ffecInconsistRange (1 bit):** A bit that specifies whether to check formulas in the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of the shared feature with references to less than the entirety of a range containing continuous data. + +**E - ffecInconsistFmla (1 bit):** A bit that specifies whether to check formulas in the range of the shared feature that are inconsistent with formulas in neighboring cells. + +**F - ffecTextDateInsuff (1 bit):** A bit that specifies whether to check the format of date/time values. + +**G - ffecUnprotFmla (1 bit):** A bit that specifies whether to check for unprotected formulas. + +**H - ffecDataValidation (1 bit):** A bit that specifies whether to perform data validation. + +**reserved (24 bits):** MUST be zero, and MUST be ignored. + +### FillPattern + +The **FillPattern** enumeration specifies the [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e).[\<167\>](#Appendix_A_167) + +| Name | Value | Meaning | +|------------------|-------|------------------------------| +| **FLSNULL** | 0x00 | No fill pattern | +| **FLSSOLID** | 0x01 | Solid | +| **FLSMEDGRAY** | 0x02 | 50% gray | +| **FLSDKGRAY** | 0x03 | 75% gray | +| **FLSLTGRAY** | 0x04 | 25% gray | +| **FLSDKHOR** | 0x05 | Horizontal stripe | +| **FLSDKVER** | 0x06 | Vertical stripe | +| **FLSDKDOWN** | 0x07 | Reverse diagonal stripe | +| **FLSDKUP** | 0x08 | Diagonal stripe | +| **FLSDKGRID** | 0x09 | Diagonal crosshatch | +| **FLSDKTRELLIS** | 0x0A | Thick Diagonal crosshatch | +| **FLSLTHOR** | 0x0B | Thin horizontal stripe | +| **FLSLTVER** | 0x0C | Thin vertical stripe | +| **FLSLTDOWN** | 0x0D | Thin reverse diagonal stripe | +| **FLSLTUP** | 0x0E | Thin diagonal stripe | +| **FLSLTGRID** | 0x0F | Thin horizontal crosshatch | +| **FLSLTTRELLIS** | 0x10 | Thin diagonal crosshatch | +| **FLSGRAY125** | 0x11 | 12.5% gray | +| **FLSGRAY0625** | 0x12 | 6.25% gray | + +### FillStylePropertiesForShapePropsStreamChecksum + +The **FillStylePropertiesForShapePropsStreamChecksum** structure specifies the fill-style data used to compute the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the [ShapePropsStream](#shapepropsstream) record. + +The related [GelFrame](#gelframe) record referenced in the following field specifications is the GelFrame record that exists along with the ShapePropsStream record in one of the following sets of records. + +- A sequence of records that conforms to the [FRAME](#chart-sheet-substream) rule. + +- A sequence of records that conforms to the DROPBAR rule. + +- A sequence of records that conforms to the AXS rule if the **wObjContext** field in the ShapePropsStream record is equal to 0x0003. + +- A sequence of records that conforms to the SS rule. If multiple ShapePropsStream records exist in the set, then the ShapePropsStream record related to the GelFrame record MUST contain a **wObjContext** field value equal to 0x0001. If a single ShapePropsStream record exists in the set, it is related to the GelFrame record. + +[TABLE] + +**fillTypeOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillType property. MUST be 0x0180, which is the same value as the **opid.opid** field of the fillType property as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.3.7.1. + +**fillType (4 bytes):** An unsigned integer that specifies the fillType property. MUST equal the value specified by the **fillType** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillColorOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillColor property. MUST be 0x0181, which is the same value as the **opid.opid** field of the fillColor property as specified in \[MS-ODRAW\] section 2.3.7.2. + +**fillColor (4 bytes):** An unsigned integer that specifies the fillColor property. MUST equal the value specified by the **fillColor** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillOpacityOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillOpacity property. MUST be 0x0182, which is the same value as the **opid.opid** field of the fillOpacity property as specified in \[MS-ODRAW\] section 2.3.7.3. + +**fillOpacity (4 bytes):** An unsigned integer that specifies the fillOpacity property. MUST equal the value specified by the **fillOpacity** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillBackColorOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillBackColor property. MUST be 0x0183, which is the same value as the **opid.opid** field of the fillBackColor property as specified in \[MS-ODRAW\] section 2.3.7.4. + +**fillBackColor (4 bytes):** An unsigned integer that specifies the fillBackColor property. MUST equal the value specified by the **fillBackColor** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillBackOpacityOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillBackOpacity property. MUST be 0x0184, which is the same value as the **opid.opid** field of the fillBackOpacity property as specified in \[MS-ODRAW\] section 2.3.7.5. + +**fillBackOpacity (4 bytes):** An unsigned integer that specifies the fillBackOpacity property. MUST equal the value specified by the **fillBackOpacity** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillCrModOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillCrMod property. MUST be 0x0185, which is the same value as the **opid.opid** field of the fillCrMod property as specified in \[MS-ODRAW\] section 2.3.7.6. + +**fillCrMod (4 bytes):** An unsigned integer that specifies the fillCrMod property. MUST equal the value specified by the **fillCrMod** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillBlipOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillBlip property. MUST be 0x0186, which is the same value as the **opid.opid** field of the fillBlip property as specified in \[MS-ODRAW\] section 2.3.7.7. + +**fillBlip (4 bytes):** An unsigned integer that specifies the fillBlip property. MUST equal the value specified by the **fillBlip** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillBlip_complex_md4uid (16 bytes):** An MD4 digest, as specified in [\[RFC1320\]](https://go.microsoft.com/fwlink/?LinkId=90274), that MUST equal the value specified by the **fillBlip_complex.rgbUid1** field of the related GelFrame record. This field MUST be present when **fillBlip** is greater than zero. MUST NOT be present when **fillBlip** is zero. + +**fillBlipNameOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillBlipName property. MUST be 0x0187, which is the same value as the **opid.opid** field of the fillBlipName property as specified in \[MS-ODRAW\] section 2.3.7.9. + +**fillBlipName (4 bytes):** An unsigned integer that specifies the fillBlipName property. MUST equal the value specified by the **fillBlipName** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillBlipName_complex (variable):** A Unicode null-terminated string that MUST equal the value specified by the **fillBlipName_complex** field of the related GelFrame record. This field MUST be present when **fillBlipName** is greater than zero. MUST NOT be present when **fillBlipName** is zero. + +**fillBlipFlagsOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillBlipFlags property. MUST be 0x0188, which is the same value as the **opid.opid** field of the fillBlipFlags property as specified in \[MS-ODRAW\] section 2.3.7.11. + +**fillBlipFlags (4 bytes):** An unsigned integer that specifies the fillBlipFlags property. MUST equal the value specified by the **fillBlipFlags** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillWidthOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillWidth property. MUST be 0x0189, which is the same value as the **opid.opid** field of the fillWidth property as specified in \[MS-ODRAW\] section 2.3.7.12. + +**fillWidth (4 bytes):** An unsigned integer that specifies the fillWidth property. MUST equal the value specified by the **fillWidth** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillHeightOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillHeight property. MUST be 0x018A, which is the same value as the **opid.opid** field of the fillHeight property as specified in \[MS-ODRAW\] section 2.3.7.13. + +**fillHeight (4 bytes):** An unsigned integer that specifies the fillHeight property. MUST equal the value specified by the **fillHeight** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillAngleOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillAngle property. MUST be 0x018B, which is the same value as the **opid.opid** field of the fillAngle property as specified in \[MS-ODRAW\] section 2.3.7.14. + +**fillAngle (4 bytes):** An unsigned integer that specifies the fillAngle property. MUST equal the value specified by the **fillAngle** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillFocusOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillFocus property. MUST be 0x018C, which is the same value as the **opid.opid** field of the fillFocus property as specified in \[MS-ODRAW\] section 2.3.7.15. + +**fillFocus (4 bytes):** An unsigned integer that specifies the fillFocus property. MUST equal the value specified by the **fillFocus** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillToLeftOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillToLeft property. MUST be 0x018D, which is the same value as the **opid.opid** field of the fillToLeft property as specified in \[MS-ODRAW\] section 2.3.7.16. + +**fillToLeft (4 bytes):** An unsigned integer that specifies the fillToLeft property. MUST equal the value specified by the **fillToLeft** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillToTopOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillToTop property. MUST be 0x018E, which is the same value as the **opid.opid** field of the fillToTop property as specified in \[MS-ODRAW\] section 2.3.7.17. + +**fillToTop (4 bytes):** An unsigned integer that specifies the fillToTop property. MUST equal the value specified by the **fillToTop** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillToRightOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillToRight property. MUST be 0x018F, which is the same value as the **opid.opid** field of the fillToRight property as specified in \[MS-ODRAW\] section 2.3.7.18. + +**fillToRight (4 bytes):** An unsigned integer that specifies the fillToRight property. MUST equal the value specified by the **fillToRight** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillToBottomOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillToBottom property. MUST be 0x0190, which is the same value as the **opid.opid** field of the fillToBottom property as specified in \[MS-ODRAW\] section 2.3.7.19. + +**fillToBottom (4 bytes):** An unsigned integer that specifies the fillToBottom property. MUST equal the value specified by the **fillToBottom** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillRectLeftOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillRectLeft property. MUST be 0x0191, which is the same value as the **opid.opid** field of the fillRectLeft property as specified in \[MS-ODRAW\] section 2.3.7.20. + +**fillRectLeft (4 bytes):** An unsigned integer that specifies the fillRectLeft property. MUST equal the value specified by the **fillRectLeft** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillRectTopOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillRectTop property. MUST be 0x0192, which is the same value as the **opid.opid** field of the fillRectTop property as specified in \[MS-ODRAW\] section 2.3.7.21. + +**fillRectTop (4 bytes):** An unsigned integer that specifies the fillRectTop property. MUST equal the value specified by the **fillRectTop** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillRectRightOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillRectRight property. MUST be 0x0193, which is the same value as the **opid.opid** field of the fillRectRight property as specified in \[MS-ODRAW\] section 2.3.7.22. + +**fillRectRight (4 bytes):** An unsigned integer that specifies the fillRectRight property. MUST equal the value specified by the **fillRectRight** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillRectBottompOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillRectBottom property. MUST be 0x0194, which is the same value as the **opid.opid** field of the fillRectBottom property as specified in \[MS-ODRAW\] section 2.3.7.23. + +**fillRectBottom (4 bytes):** An unsigned integer that specifies the fillRectBottom property. MUST equal the value specified by the **fillRectbottom** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillDztypeOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillDztype property. MUST be 0x0195, which is the same value as the **opid.opid** field of the fillDztype property as specified in \[MS-ODRAW\] section 2.3.7.24. + +**fillDztype (4 bytes):** An unsigned integer that specifies the fillDztype property. MUST equal the value specified by the **fillDztype** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillShadePresetOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillShadePreset property. MUST be 0x0196, which is the same value as the **opid.opid** field of the fillShadePreset property as specified in \[MS-ODRAW\] section 2.3.7.25. + +**fillShadePreset (4 bytes):** An unsigned integer that specifies the fillShadePreset property. MUST equal the value specified by the **fillShadePreset** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillShadeColorsOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillShadeColors property. MUST be 0x0197, which is the same value as the **opid.opid** field of the fillShadeColors property as specified in \[MS-ODRAW\] section 2.3.7.26. + +**fillShadeColors (4 bytes):** An unsigned integer that specifies the number of bytes of data in the following **fillShadeColors_complex** field. + +**fillShadeColors_complex (variable):** An IMsoArray as specified in \[MS-ODRAW\] section 2.2.51 that specifies the fillShadeColors_complex property. This field MUST be present when **fillShadeColors** is greater than zero. MUST equal the value specified by the **fillShadeColors_complex** field of the related GelFrame record. MUST NOT be present when **fillShadeColors** is zero. + +**fillOriginXOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillOriginX property. MUST be 0x0198, which is the same value as the **opid.opid** field of the fillOriginX property as specified in \[MS-ODRAW\] section 2.3.7.28. + +**fillOriginX (4 bytes):** An unsigned integer that specifies the fillOriginX property. MUST equal the value specified by the **fillOriginX** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillOriginYOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillOriginY property. MUST be 0x0199, which is the same value as the **opid.opid** field of the fillOriginY property as specified in \[MS-ODRAW\] section 2.3.7.29. + +**fillOriginY (4 bytes):** An unsigned integer that specifies the fillOriginY property. MUST equal the value specified by the **fillOriginY** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillShapeOriginXOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillShapeOriginX property. MUST be 0x019A, which is the same value as the **opid.opid** field of the fillShapeOriginX property as specified in \[MS-ODRAW\] section 2.3.7.30. + +**fillShapeOriginX (4 bytes):** An unsigned integer that specifies the fillShapeOriginX property. MUST equal the value specified by the **fillShapeOriginX** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillShapeOriginYOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillShapeOriginY property. MUST be 0x019B, which is the same value as the **opid.opid** field of the fillShapeOriginY property as specified in \[MS-ODRAW\] section 2.3.7.31. + +**fillShapeOriginY (4 bytes):** An unsigned integer that specifies the fillShapeOriginY property. MUST equal the value specified by the **fillShapeOriginY** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillShadeTypeOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillShadeType property. MUST be 0x019C, which is the same value as the **opid.opid** field of the fillShadeType property as specified in \[MS-ODRAW\] section 2.3.7.32. + +**fillShadeType (4 bytes):** An unsigned integer that specifies the fillShadeType property. MUST equal the value specified by the **fillShadeType** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillColorExtOpid (4 bytes):** An unsigned integer that specifies the identifier of the fillColorExt property. MUST be 0x019E, which is the same value as the **opid.opid** field of the fillColorExt property as specified in \[MS-ODRAW\] section 2.3.7.33. + +**fillColorExt (4 bytes):** An unsigned integer that specifies the fillColorExt property. MUST equal the value specified by the **fillColorExt** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**reserved415Opid (4 bytes):** An unsigned integer that specifies the identifier of the reserved415 property. MUST be 0x019F, which is the same value as the **opid.opid** field of the reserved415 property as specified in \[MS-ODRAW\] section 2.3.7.34. + +**reserved1 (4 bytes):** MUST be 0xFFFFFFFF. + +**fillColorExtModOpid (4 bytes):** An unsigned integer that specifies the identifier of fillColorExtMod property. MUST be 0x01A0, which is the same value as the **opid.opid** field of the fillColorExtMod property as specified in \[MS-ODRAW\] section 2.3.7.35. + +**fillColorExtMod (4 bytes):** An unsigned integer that specifies the fillColorExtMod property. MUST equal the value specified by the **fillColorExtMod** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**reserved417Opid (4 bytes):** An unsigned integer that specifies the identifier of the reserved417 property. MUST be 0x01A1, which is the same value as the **opid.opid** field of the reserved417 property as specified in \[MS-ODRAW\] section 2.3.7.36. + +**reserved2 (4 bytes):** MUST be 0x00000000. + +**fillBackColorExtOpid (4 bytes):** An unsigned integer that specifies the identifier of fillBackColorExt property. MUST be 0x01A2, which is the same value as the **opid.opid** field of the fillBackColorExt property as specified in \[MS-ODRAW\] section 2.3.7.37. + +**fillBackColorExt (4 bytes):** An unsigned integer that specifies the fillBackColorExt property. MUST equal the value specified by the **fillBackcolorExt** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**reserved419Opid (4 bytes):** An unsigned integer that specifies the identifier of the reserved419 property. MUST be 0x01A3, which is the same value as the **opid.opid** field of the reserved419 property as specified in \[MS-ODRAW\] section 2.3.7.38. + +**reserved3 (4 bytes):** MUST be 0xFFFFFFFF. + +**fillBackColorExtModOpid (4 bytes):** An unsigned integer that specifies the identifier of fillBackColorExtMod property. MUST be 0x01A4, which is the same value as the **opid.opid** field of the fillBackColorExtMod property as specified in \[MS-ODRAW\] section 2.3.7.39. + +**fillBackColorExtMod (4 bytes):** An unsigned integer that specifies the fillBackColorExtMod property. MUST equal the value specified by the **fillBackColorExtMod** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**reserved421Opid (4 bytes):** An unsigned integer that specifies the identifier of the reserved421 property. MUST be 0x01A5, which is the same value as the **opid.opid** field of the reserved421 property as specified in \[MS-ODRAW\] section 2.3.7.40. + +**reserved4 (4 bytes):** MUST be 0x00000000. + +**reserved422Opid (4 bytes):** An unsigned integer that specifies the identifier of the reserved422 property. MUST be 0x01A6, which is the same value as the **opid.opid** field of the reserved422 property as specified in \[MS-ODRAW\] section 2.3.7.41. + +**reserved5 (4 bytes):** MUST be 0xFFFFFFFF. + +**reserved423Opid (4 bytes):** An unsigned integer that specifies the identifier of the reserved423 property. MUST be 0x01A7, which is the same value as the **opid.opid** field of the reserved423 property as specified in \[MS-ODRAW\] section 2.3.7.42. + +**reserved6 (4 bytes):** MUST be 0xFFFFFFFF. + +**fillstyle_fFilledOpid (4 bytes):** An unsigned integer that specifies the identifier of the fFilled property. MUST be 0x01BB. + +**fillstyle_fFilled (4 bytes):** An unsigned integer that specifies the fFilled property. MUST equal the value specified by the **fFilled** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillstyle_ffillShapeOpid (4 bytes):** An unsigned integer that specifies the identifier of the ffillShape property. MUST be 0x01BD. + +**fillstyle_ffillShape (4 bytes):** An unsigned integer that specifies the ffillShape property. MUST equal the value specified by the **ffillShape** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +**fillstyle_ffillUseRectOpid (4 bytes):** An unsigned integer that specifies the identifier of the ffillUseRect property. MUST be 0x01BE. + +**fillstyle_ffillUseRect (4 bytes):** An unsigned integer that specifies the ffillUseRect property. MUST equal the value specified by the **ffillUseRect** field of the related GelFrame record or the default value if the field is not present in the GelFrame record. + +### FontIndex + +The **FontIndex** structure specifies a [Font](#font) record in the file. + +[TABLE] + +**ifnt (2 bytes):** An unsigned integer. If this value is less than 4, then it specifies a zero-based index of a Font record in the collection of Font records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). If this value is greater than 4, then it specifies a one-based index of a Font record in the collection of Font records in the Globals Substream. MUST NOT equal 4, and MUST be less than or equal to 1022. SHOULD[\<168\>](#Appendix_A_168) be less than or equal to 510. + +The Font records in the Globals Substream are organized into two sections. The first section contains four Font records which MUST be present and MUST be ordered as follows[\<169\>](#Appendix_A_169): + +| Ifnt value | Meaning | +|------------|--------------------------------------------------------------| +| 0 | Default [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) | +| 1 | Default font, bold | +| 2 | Default font, italic | +| 3 | Default font, bold and italic | + +The second section, which is optional, contains Font records for any additional font formatting properties present in the file. For example, the 5^(th) Font record in the file is referred to by **ifnt** value 5. + +### FontInfo + +The **FontInfo** structure specifies a [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) entry used by the [FrtFontList](#frtfontlist) record. + +[TABLE] + +**A - fScaled (1 bit):** A bit that specifies whether the fonts are scaled. MUST be a value from the following table[\<170\>](#Appendix_A_170): + +| Value | Meaning | +|----|----| +| 0x0 | Font has fixed size | +| 0x1 | Font scales with [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)) in a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), or [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) | + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +**ifnt (2 bytes):** A [FontIndex](#fontindex) that specifies the font used by the FrtFontList record. + +### FontScheme + +The **FontScheme** enumeration specifies the [**font scheme**](#gt_d2cfdc52-4222-46a7-8c1e-fffdcadcb973) to which this [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) belongs. When a font is part of a theme as specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) part 1, section 14.2.7, the font is categorized as a [**major scheme**](#gt_62199344-845e-47bc-84c0-8261e3820666) or a [**minor scheme**](#gt_04094b39-b410-4e14-99a0-a78e88b283f6). + +| Name | Value | Meaning | +|----|----|----| +| **XFSNONE** | 0x00 | No font scheme | +| **XFSMAJOR** | 0x01 | Major scheme | +| **XFSMINOR** | 0x02 | Minor scheme | +| **XFSNIL** | 0xFF | [**Ninched**](#gt_111030f3-1e81-469e-9b6e-f42f501189b1) state | + +### FormatRun + +The **FormatRun** structure specifies formatting information for a [**text run**](#gt_393612a7-9552-48b0-abf6-0371dbd6d553). + +[TABLE] + +**ich (2 bytes):** An unsigned integer that specifies the zero-based index of the first character of the text that contains the text run. When this record is used in an array, this value MUST be in strictly increasing order. + +**ifnt (2 bytes):** A [FontIndex](#fontindex) structure that specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). If **ich** is equal to the length of the text, this record is undefined and MUST be ignored. + +### FormulaValue + +The **FormulaValue** structure specifies the current value of a formula. It can be a numeric value, a Boolean value, an error value, a string value, or a blank string value. If **fExprO** is not 0xFFFF, the 8 bytes of this structure specify an Xnum (section [2.5.342](#xnum)). If **fExprO** is 0xFFFF, this structure specifies a Boolean value, an error value, a string value, or a blank string value. + +[TABLE] + +**byte1 (1 byte):** If **fExprO** is 0xFFFF, **byte1** is an unsigned integer that specifies the formula value type and MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | String value. The string value is stored in a [String](#string) record that immediately follows this record. | +| 0x01 | Boolean value. | +| 0x02 | Error value. | +| 0x03 | Blank string value. | + +If **fExprO** is not 0xFFFF, **byte1** specifies the first byte of the Xnum. + +**byte2 (1 byte):** If **fExprO** is 0xFFFF, **byte2** is undefined and MUST be ignored. If **fExprO** is not 0xFFFF, **byte2** specifies the second byte of the Xnum (section 2.5.342). + +**byte3 (1 byte):** The meaning of byte3 is specified in the following table: + +| Value | Meaning | +|----|----| +| **fExprO** is 0xFFFF and **byte1** is 0x00 | **byte3** is undefined and MUST be ignored. | +| **fExprO** is 0xFFFF and **byte1** is 0x01 | **byte3** specifies a Boolean value. | +| **fExprO** is 0xFFFF and **byte1** is 0x02 | **byte3** specifies a [BErr](#berr). | +| **fExprO** is 0xFFFF and **byte1** is 0x03 | **byte3** is undefined and MUST be ignored. | +| **fExprO** is not 0xFFFF | **byte3** specifies the third byte of the Xnum. | + +**byte4 (1 byte):** If **fExprO** is 0xFFFF, **byte4** is undefined and MUST be ignored. If **fExprO** is not 0xFFFF, **byte4** specifies the fourth byte of the Xnum. + +**byte5 (1 byte):** If **fExprO** is 0xFFFF, **byte5** is undefined and MUST be ignored. If **fExprO** is not 0xFFFF, **byte5** specifies the fifth byte of the Xnum. + +**byte6 (1 byte):** If **fExprO** is 0xFFFF, **byte6** is undefined and MUST be ignored. If **fExprO** is not 0xFFFF, **byte6** specifies the sixth byte of the Xnum. + +**fExprO (2 bytes):** If **fExprO** is 0xFFFF, this structure specifies a Boolean value, an error value, a string value, or a blank string value. If **fExprO** is not 0xFFFF, **fExprO** specifies the last two bytes of the Xnum. + +### FrtFlags + +The **FrtFlags** structure specifies flags used in [future record](#Section_b660b67822684414839ed1ae9a4e4e85) headers. + +[TABLE] + +**A - fFrtRef (1 bit):** A bit that specifies whether the containing record specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The containing record does not specify a range of cells. The containing record’s ref8.rwFirst, ref8.rwLast, ref8.colFirst, and ref8.colLast fields SHOULD[\<171\>](#Appendix_A_171) all be zero. | +| 1 | The containing record specifies a range of cells. | + +**B - fFrtAlert (1 bit):** A bit that specifies whether to alert the user of possible problems when saving the file without having recognized this record. + +**reserved (14 bits):** MUST be zero, and MUST be ignored. + +### FrtHeader + +The **FrtHeader** structure specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) type header. + +[TABLE] + +**rt (2 bytes):** An unsigned integer that specifies the record type identifier. MUST be identical to the record type identifier of the containing record. + +**grbitFrt (2 bytes):** An [FrtFlags](#frtflags) that specifies attributes for this record. The value of **grbitFrt.fFrtRef** MUST be zero. The value of **grbitFrt.fFrtAlert** MUST be zero. + +**reserved (8 bytes):** MUST be zero, and MUST be ignored. + +### FrtHeaderOld + +The **FrtHeaderOld** structure specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) type header. + +[TABLE] + +**rt (2 bytes):** An unsigned integer that specifies the record type identifier. MUST be identical to the record type identifier of the containing record. + +**grbitFrt (2 bytes):** An [FrtFlags](#frtflags) that specifies attributes for this record. The value of **grbitFrt.fFrtRef** MUST be zero. The value of **grbitFrt.fFrtAlert** MUST be zero. + +### FrtRefHeader + +The **FrtRefHeader** structure specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) type header. + +[TABLE] + +**rt (2 bytes):** An unsigned integer that specifies the record type identifier. MUST be identical to the record type identifier of the containing record. + +**grbitFrt (2 bytes):** A [FrtFlags](#frtflags) that specifies attributes for this record. The value of **grbitFrt.fFrtAlert** MUST be zero. + +**ref8 (8 bytes):** A [Ref8](#ref8) that references the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with the containing record. If **grbitFrt.fFrtRef** is zero then **ref8.rwFirst** MUST be zero, **ref8.rwLast** MUST be zero, **ref8.colFirst** MUST be zero, and **ref8.colLast** MUST be zero. + +### FrtRefHeaderNoGrbit + +The **FrtRefHeaderNoGrbit** structure specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) type header. + +[TABLE] + +**rt (2 bytes):** An unsigned integer that specifies the record type identifier. MUST be identical to the record type identifier of the containing record. + +**ref8 (8 bytes):** A [Ref8U](#ref8u) that references the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with the containing record. + +### FrtRefHeaderU + +The **FrtRefHeaderU** structure specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) type header. + +[TABLE] + +**rt (2 bytes):** An unsigned integer that specifies the record type identifier. MUST be identical to the record type identifier of the containing record. + +**grbitFrt (2 bytes):** A [FrtFlags](#frtflags) that specifies attributes for this record. The value of **grbitFrt.fFrtAlert** MUST be zero. + +**ref8 (8 bytes):** A [Ref8U](#ref8u) that references the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with the containing record. If **rt** is [Feature11](#feature11) (0x0872) or [Feature12](#feature12) (0x0878), this field MUST be ignored. + +### FtCbls + +The **FtCbls** structure appears as part of an [Obj](#obj) record that represents a checkbox or radio button. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x000A. + +**cb (2 bytes):** Reserved. MUST be 0x000C. + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +**unused3 (4 bytes):** Undefined and MUST be ignored. + +### FtCblsData + +The **FtCblsData** structure specifies the properties of the checkbox or radio button [Obj](#obj) that contains this FtCblsData. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x0012. + +**cb (2 bytes):** Reserved. MUST be 0x0008. + +**fChecked (2 bytes):** An unsigned integer that specifies the state of the checkbox or radio button control. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 | The control is in an unchecked state. | +| 0x0001 | The control is in a checked state. | +| 0x0002 | The control is in a mixed state. The **fChecked** field MUST NOT have this value if the **cmo.ot** field of the Obj record that contains this FtPioGrbit is not equal to 0x0B. | + +**accel (2 bytes):** An unsigned integer that specifies the [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) character of the control’s [**accelerator key**](#gt_d61b4a07-b6c1-4c08-9ebd-1d00b360f953). A value of 0x0000 specifies there is no accelerator associated with this control. This field MUST be ignored unless this structure is used in the [Dialog Sheet Substream](#Section_da37feb48b9a462d87772a5fddd4866e). + +**reserved (2 bytes):** Reserved. MUST be 0x0000. + +**A - fNo3d (1 bit):** A bit that specifies whether the control is expected to be displayed without three-dimensional effects. + +**unused (15 bits):** Undefined and MUST be ignored. + +### FtCf + +The **FtCf** structure specifies the clipboard format of the picture-type [Obj](#obj) record containing this FtCf. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x0007. + +**cb (2 bytes):** Reserved. MUST be 0x0002. + +**cf (2 bytes):** An unsigned integer that specifies the Windows clipboard format of the data associated with the picture. This field’s value MUST be in the following table: + +| Value | Format | +|----|----| +| 0x0002 | Specifies the format of the picture is an enhanced [**metafile**](#gt_ae5f028e-7e28-4a0b-bec6-2c87913f7db7). | +| 0x0009 | Specifies the format of the picture is a bitmap. | +| 0xFFFF | Specifies the picture is in an unspecified format that is neither and enhanced metafile nor a bitmap. | + +### FtCmo + +The **FtCmo** structure specifies the common properties of the [Obj](#obj) record that contains this FtCmo. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x15. + +**cb (2 bytes):** Reserved. MUST be 0x12. + +**ot (2 bytes):** An unsigned integer that specifies the type of object represented by the Obj record that contains this FtCmo. MUST be a value from the following table: + +| Value | Type of Object | +|--------|------------------| +| 0x0000 | Group | +| 0x0001 | Line | +| 0x0002 | Rectangle | +| 0x0003 | Oval | +| 0x0004 | Arc | +| 0x0005 | Chart | +| 0x0006 | Text | +| 0x0007 | Button | +| 0x0008 | Picture | +| 0x0009 | Polygon | +| 0x000B | Checkbox | +| 0x000C | Radio button | +| 0x000D | Edit box | +| 0x000E | Label | +| 0x000F | Dialog box | +| 0x0010 | Spin control | +| 0x0011 | Scrollbar | +| 0x0012 | List | +| 0x0013 | Group box | +| 0x0014 | Dropdown list | +| 0x0019 | Note | +| 0x001E | OfficeArt object | + +**id (2 bytes):** An unsigned integer that specifies the identifier of this object. This object identifier is used by other types to refer to this object. The value of **id** MUST be unique among all Obj records within the [Chart Sheet Substream](#Section_732ff614d939416bb7c76d983471ff11) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf), [Macro Sheet Substream](#Section_0dddd943f77a4fc2bf92868acb4587f7) ABNF and [Worksheet Substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) ABNF. + +**A - fLocked (1 bit):** A bit that specifies whether this object is [**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81). + +**B - reserved (1 bit):** Reserved. MUST be 0. + +**C - fDefaultSize (1 bit):** A bit that specifies whether the application is expected to choose the object’s size. + +**D - fPublished (1 bit):** A bit that specifies whether this is a [chart](#chart-2) object that is expected to be [**published**](#gt_8ffc383a-d4f1-4515-a8b5-874d84ab2d2b) the next time the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing it is published[\<172\>](#Appendix_A_172). This bit is ignored if the **fPublishedBookItems** field of the [BookExt_Conditional12](#bookext_conditional12) structure is zero. + +**E - fPrint (1 bit):** A bit that specifies whether the image of this object is intended to be included when printed. + +**F - unused1 (1 bit):** Undefined and MUST be ignored. + +**G - unused2 (1 bit):** Undefined and MUST be ignored + +**H - fDisabled (1 bit):** A bit that specifies whether this object has been disabled. + +**I - fUIObj (1 bit):** A bit that specifies whether this is an auxiliary object that can only be automatically inserted by the application (as opposed to an object that can be inserted by a user). + +**J - fRecalcObj (1 bit):** A bit that specifies whether this object is expected to be updated on load to reflect the values in the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) associated with the object. This field MUST be ignored unless the **pictFmla.key** field of the containing Obj exists and **pictFmla.key.fmlaListFillRange.cbFmla** of the containing Obj is not equal to 0. + +**K - unused3 (1 bit):** Undefined and MUST be ignored. + +**L - unused4 (1 bit):** Undefined and MUST be ignored. + +**M - fRecalcObjAlways (1 bit):** A bit that specifies whether this object is expected to be updated whenever the value of a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the range associated with the object changes. This field MUST be ignored unless the **pictFmla.key** field of the containing Obj exists and **pictFmla.key.fmlaListFillRange.cbFmla** of the containing Obj is not equal to 0. + +**N - unused5 (1 bit):** Undefined and MUST be ignored. + +**O - unused6 (1 bit):** Undefined and MUST be ignored. + +**P - unused7 (1 bit):** Undefined and MUST be ignored. + +**unused8 (4 bytes):** Undefined and MUST be ignored. + +**unused9 (4 bytes):** Undefined and MUST be ignored. + +**unused10 (4 bytes):** Undefined and MUST be ignored. + +### FtEdoData + +This structure specifies the properties of the edit box [Obj](#obj) record that contains this FtEdoData. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x0010. + +**cb (2 bytes):** Reserved. MUST be 0x0008. + +**ivtEdit (2 bytes):** An unsigned integer that specifies what input [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) is expected to be performed by this edit box. MUST be a value from the following table: + +| Value | Strings accepted by validation | +|----|----| +| 0x0000 | Any string; no validation is expected. | +| 0x0001 | An integer. | +| 0x0002 | A number. | +| 0x0003 | A [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) reference. | +| 0x0004 | A formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). | + +**fMultiLine (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether this edit box supports multiple lines of text. MUST be a value from the following table: + +| Value | Meaning | +|--------|-------------------------------| +| 0x0000 | Only one line is supported. | +| 0x0001 | Multiple lines are supported. | + +**fVScroll (2 bytes):** A Boolean that specifies whether this edit box contains a vertical scrollbar. MUST be a value from the following table: + +| Value | Meaning | +|--------|--------------------------------------------| +| 0x0000 | Scrollbar is expected not to be displayed. | +| 0x0001 | Scrollbar is expected to be displayed. | + +**id (2 bytes):** An [ObjId](#objid) that specifies the associated list control. The associated list control is the control specified by the Obj record whose **cmo.id** field is equal to **id.id**. A value of **id.id** equal to 0 specifies that there is no list control associated with this edit box. + +### FtGboData + +The **FtGboData** structure specifies the properties of the group box [Obj](#obj) record that contains this FtGboData. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x000F. + +**cb (2 bytes):** Reserved. MUST be 0x0006. + +**accel (2 bytes):** An unsigned integer that specifies the [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) character of the object’s [**accelerator key**](#gt_d61b4a07-b6c1-4c08-9ebd-1d00b360f953). A value of 0x0000 specifies there is no accelerator key associated with this object. This field MUST be ignored unless this object is in a [**dialog sheet**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8). + +**reserved (2 bytes):** Reserved. MUST be 0x0000. + +**A - fNo3d (1 bit):** A bit that specifies whether this control is expected to be displayed without three-dimensional effects. + +**unused2 (15 bits):** Undefined and MUST be ignored. + +### FtGmo + +The **FtGmo** structure appears in a group-type [Obj](#obj) record. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x0006. + +**cb (2 bytes):** Reserved. MUST be 0x0002 + +**unused (2 bytes):** Undefined and MUST be ignored. + +### FtLbsData + +The **FtLbsData** structure specifies the properties of a list or drop-down list [**embedded object**](#gt_708607be-8655-416e-93f3-b434e9ecbd56) in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x0013. + +**cbFContinued (2 bytes):** An unsigned integer that indirectly specifies whether some of the data in this structure appear in a subsequent [Continue](#continue) record. If **cbFContinued** is 0x0000, all of the fields in this structure except **ft** and **cbFContinued** MUST NOT exist. If this entire structure is contained within the same record, then **cbFContinued** MUST be greater than or equal to the size, in bytes, of this structure, not including the four bytes for the **ft** and **cbFContinued** fields. If part of this structure is in one or more subsequent Continue records, then the **cbFContinued** field MUST hold the value calculated according to the following formula: + +**cbFContinued** = size of the fields of this structure in the current record - 1. + +**fmla (variable):** An [ObjFmla](#objfmla) that specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) values that are the items in this list. + +**cLines (2 bytes):** An unsigned integer that specifies the number of items in the list. MUST be less than or equal to 0x7FFF. + +**iSel (2 bytes):** An unsigned integer that specifies the one-based index of the first selected item in this list. A value of 0x0000 specifies there is no currently [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) item. MUST be less than or equal to **cLines**. + +**A - fUseCB (1 bit):** A bit that specifies whether the **lct** field MUST be ignored. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------| +| 0 | The **lct** field MUST be ignored. | +| 1 | The **lct** field MUST NOT be ignored. | + +**B - fValidPlex (1 bit):** A bit that specifies whether the **rgLines** field exists. + +**C - fValidIds (1 bit):** A bit that specifies whether the **idEdit** field MUST be ignored. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------| +| 0 | The **idEdit** field MUST be ignored. | +| 1 | The **idEdit** field MUST NOT be ignored. | + +**D - fNo3d (1 bit):** A bit that specifies whether this control is displayed without 3-dimensional effects. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------------------------| +| 0 | The control is displayed with 3-dimentional effects. | +| 1 | The control is not displayed with 3-dimentional effects. | + +**E - wListSelType (2 bits):** An unsigned integer that specifies the type of [**selection**](#gt_8a241461-3c59-45fb-9094-b6692a0c27fe) behavior this list control is expected to support. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0 | The list control is only allowed to have one selected item. | +| 1 | The list control is allowed to have multiple items selected by clicking on each item. | +| 2 | The list control is allowed to have multiple items selected by holding the CTRL key and clicking on each item. | + +**F - unused (1 bit):** Undefined and MUST be ignored. + +**G - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**lct (8 bits):** An unsigned integer that specifies the behavior class of this list. MUST be ignored if the **fUseCB** field is 0. Otherwise, MUST be a value from the following table: + +| Value | Expected behavior of the control | +|----|----| +| 0x00 | Regular sheet dropdown control (like a list box object). | +| 0x01 | [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) page field dropdown. | +| 0x03 | [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) dropdown. The lct field MUST NOT have this value unless this object is in a [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) or [**macro sheet**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491). | +| 0x05 | [**AutoComplete**](#gt_28a56cd0-e544-405c-8d41-b95ed015c0cc) dropdown. | +| 0x06 | [**Data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) list dropdown. The lct field MUST NOT have this value unless this object is in a worksheet or macro sheet. | +| 0x07 | PivotTable row or column field dropdown. | +| 0x09 | Dropdown for the Total Row of a table. | + +**idEdit (2 bytes):** An [ObjId](#objid) that specifies the edit box associated with this list. A value of **idEdit.id** equal to 0x0000 or a value of **fValidIds** equal to 0 specifies that there is no edit box associated with this list. + +**dropData (variable):** An optional [LbsDropData](#lbsdropdata) that specifies properties for this dropdown control. This field MUST exist if and only if the containing [Obj’s](#obj) **cmo.ot** is equal to 0x0014. + +**rgLines (variable):** An optional array of [XLUnicodeString](#xlunicodestring). Each string in this array specifies an item in the list. This array MUST exist if and only if the **fValidPlex** field is equal to 1. The number of elements in this array, if it exists, MUST be **cLines**. The **cch** field of each string in this array MUST be less than or equal to 0x00FF. If this array does not fit in the owning Obj record, Continue records are used. Each string in this array MUST be entirely contained within the same record. + +**bsels (variable):** An optional array of one-byte Booleans (section [2.5.14](#boolean)) that specifies which items in the list are part of a multiple selection. This array MUST exist if and only if the **wListSelType** field is not equal to 0. The number of elements in this array, if it exists, MUST be **cLines**. The nth byte in this array specifies whether the nth list item is part of the multiple selection. The value of each element MUST be taken from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------| +| 0x00 | List item is not part of the multiple selection. | +| 0x01 | List item is part of the multiple selection. | + +If this array does not fit in the current record, or would come within eight bytes of the end of the maximum allowable size of that record, Continue records are used. + +### FtMacro + +The **FtMacro** structure specifies an action associated with this control. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x0004. + +**fmla (variable):** An [ObjFmla](#objfmla) that specifies the name of a macro. The **fmla** field MUST refer to a name defined through an [Lbl](#lbl) whose **fProc** field is 1. + +### FtNts + +The **FtNts** structure specifies the properties of the note-type [Obj](#obj) record containing this FtNts. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x000D. + +**cb (2 bytes):** Reserved. MUST be 0x0016. + +**guid (16 bytes):** A GUID as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that specifies the Globally Unique identifier of this [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d). + +**fSharedNote (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the comment is shared. MUST be a value from the following table: + +| Value of fSharedNote | Meaning | +|----------------------|------------| +| 0x0000 | Not shared | +| 0x0001 | Shared | + +**unused (4 bytes):** Undefined and MUST be ignored. + +### FtPictFmla + +The **FtPictFmla** structure specifies the location of the data associated with the picture [Obj](#obj) that contains this FtPictFmla. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x0009. + +**cb (2 bytes):** An unsigned integer that specifies the length, in bytes of this FtPictFmla, not including **ft** and **cb** fields. + +**fmla (variable):** An [ObjFmla](#objfmla) that specifies the location of the data for the object associated with the Obj record that contains this FtPictFmla. If the **pictFlags.fDde** field of the Obj record that contains this FtPictFmla is 1, **fmla** MUST refer to a name which is defined in an [ExternName](#externname) record whose **fOle** field is 1. If the **pictFlags.fCamera** field of the Obj record that contains this FtPictFmla is 1, **fmla** MUST refer to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). Otherwise, the **fmla.cce** field of this **fmla** MUST be 0x5 and the **fmla.rgce** field of this **fmla** MUST contain a [PtgTbl](#ptgtbl) followed by four bytes that are undefined and MUST be ignored. + +**lPosInCtlStm (4 bytes):** An optional unsigned integer whose meaning depends on the value of the **cmo.fPrstm** field of the Obj record that contains this FtPictFmla. This field MUST exist if and only if this structure’s **fmla.fmla.rgce** field starts with a PtgTbl. The following table explains the two possible meanings of **lPosInCtlStm**: + +| Value of cmo.fPrstm | Meaning of lPosInCtlStm | +|----|----| +| 0 | The object’s data MUST reside in an [embedding storage](#Section_b406ade0fb1c4512bff2b576fdfff545) whose name is the concatenation of "MBD" and the eight byte hexadecimal representation of **lPosInCtlStm’s** value**.** | +| 1 | **lPosInCtlStm** specifies the zero-based offset of this object’s data within the [control stream (Ctls)](#Section_ce07d64476c84d368badb6419bd152fe). | + +**cbBufInCtlStm (4 bytes):** An optional unsigned integer that specifies the size of this object’s data within the control stream. This field MUST exist if and only if the **pictFlags.fPrstm** field of the Obj record that contains this FtPictFmla equals 1. + +**key (variable):** An optional [PictFmlaKey](#pictfmlakey). MUST exist if and only if the **pictFlags.fCtl** field of the Obj record that contains this FtPictFmla equals 1. + +### FtPioGrbit + +The **FtPioGrbit** structure specifies Boolean properties of the picture [Obj](#obj) containing this FtPioGrbit. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x0008. + +**cb (2 bytes):** Reserved. MUST be 0x0002. + +**A - fAutoPict (1 bit):** A bit that specifies whether the picture’s aspect ratio is preserved when rendered in different views ([**Normal view**](#gt_b3c343ae-05ca-4b91-9cc1-383ee3563990), [**Page Break Preview view**](#gt_a7342c25-b4fd-4c84-9922-ae9c4a92d180), [**Page Layout view**](#gt_c5ea3e6c-db72-4a85-b273-596e95a3841e) and printing). + +**B - fDde (1 bit):** A bit that specifies whether the **pictFmla** field of the Obj record that contains this FtPioGrbit specifies a [**DDE**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) reference. + +**C - fPrintCalc (1 bit):** A bit that specifies whether this object is expected to be updated on print to reflect the values in the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with the object. + +**D - fIcon (1 bit):** A bit that specifies whether the picture is displayed as an icon. + +**E - fCtl (1 bit):** A bit that specifies whether this object is an [**ActiveX control**](#gt_f3dcc35f-8f80-474e-ac39-106a23f059c2). It MUST NOT be the case that both **fCtl** and **fDde** are equal to 1. + +**F - fPrstm (1 bit):** A bit that specifies whether the object data are stored in an [embedding storage](#Section_b406ade0fb1c4512bff2b576fdfff545) or in the [controls stream (ctls)](#Section_ce07d64476c84d368badb6419bd152fe). See [FtPictFmla](#ftpictfmla)’s **lPosInCtlStm** and **cbBufInCtlStm** fields for more detail. + +| Value of fPrstm | Location of object data | +|-----------------|-----------------------------| +| 0 | An embedding storage. | +| 1 | The controls stream (ctls). | + +**G - unused1 (1 bit):** Undefined and MUST be ignored. + +**H - fCamera (1 bit):** A bit that specifies whether this is a [**camera picture**](#gt_ccb0da7f-aa4d-481c-b46c-e96c220869e1). + +**I - fDefaultSize (1 bit):** A bit that specifies whether this picture’s size has been explicitly set. The value of **fDefaultSize** MUST be taken from the following table: + +| Value | Meaning | +|-------|--------------------------------------------------| +| 0 | This picture’s size has been explicitly set. | +| 1 | This picture’s size has not been explicitly set. | + +**J - fAutoLoad (1 bit):** A bit that specifies whether the [**OLE server**](#gt_8032f3a8-7274-45a4-aa01-5e7d8645f0c0) for the object is called to load the object’s data automatically when the parent [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is opened. + +**unused2 (6 bits):** Undefined and MUST be ignored. + +### FtRbo + +The **FtRbo** structure appears as part of an [Obj](#obj) record that represents a radio button. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x000B. + +**cb (2 bytes):** Reserved. MUST be 0x0006. + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +### FtRboData + +The **FtRboData** structure specifies the properties of the radio button [Obj](#obj) containing this FtRboData. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x0011. + +**cb (2 bytes):** Reserved. MUST be 0x0004. + +**idRadNext (2 bytes):** An [ObjId](#objid) that specifies the next radio button in a group of radio buttons. A value of **idRadNext.id** equal to 0 or equal to the containing Obj’s **cmo.id** specifies there is no next radio button. + +**fFirstBtn (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether this is the first radio button in its group. MUST be a value from the following table: + +| Value | Meaning | +|--------|----------------------------------------------| +| 0x0000 | This is not the first radio button. | +| 0x0001 | This is the first radio button in the group. | + +### FtSbs + +The **FtSbs** structure specifies the properties of the scrollable control represented by the [Obj](#obj) record that contains this FtSbs. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x000C. + +**cb (2 bytes):** Reserved. MUST be 0x0014. + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +**iVal (2 bytes):** A signed integer that specifies the current value of the control. This value MUST be greater than or equal to **iMin**. This value MUST be less than or equal to **iMax**. + +**iMin (2 bytes):** A signed integer that specifies the minimum allowable value of the control. + +**iMax (2 bytes):** A signed integer that specifies the maximum allowable value of the control. This value MUST be greater than or equal to **iMin**. + +**dInc (2 bytes):** A signed integer that specifies the amount by which the control’s value is changed when the user clicks on one of the control’s minor increment regions. MUST be greater than or equal to 0x0000. + +**dPage (2 bytes):** A signed integer that specifies the amount by which the control’s value is changed when the user clicks on the scrollbar’s page up or page down region. MUST be greater than or equal to 0x0000. + +**fHoriz (2 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether this control scrolls horizontally or vertically. MUST be a value from the following table: + +| | | +|--------|----------------------| +| 0x0000 | Vertical scrolling | +| 0x0001 | Horizontal scrolling | + +**dxScroll (2 bytes):** A signed integer that specifies the width in pixels of the scrollbar. MUST be greater than or equal to 0x0000. + +**A - fDraw (1 bit):** A bit that specifies whether this control is expected to be displayed. + +**B - fDrawSliderOnly (1 bit):** A bit that specifies whether only the slider portion of this control is expected to be displayed. + +**C - fTrackElevator (1 bit):** A bit that specifies whether the control is expected to interactively track a mouse drag of the control’s scroll thumb (aka elevator). + +**D - fNo3d (1 bit):** A bit that specifies whether the control is expected to be displayed without three-dimensional effects. + +**unused2 (12 bits):** Undefined and MUST be ignored. + +### FullColorExt + +The **FullColorExt** structure specifies a color. + +[TABLE] + +**xclrType (2 bytes):** An [**XColorType**](#xcolortype) that specifies how the color information is stored. + +**nTintShade (2 bytes):** A signed integer that specifies the tint of the color. Positive values lighten the color, and negative values darken the color. + +**xclrValue (4 bytes):** An unsigned integer that specifies the color data. If **xclrType** equals 0x00 or 0x04, this value MUST be 0. If **xclrType** equals 0x01, this field contains an [IcvXF](#icvxf) that specifies a color in the color table. If **xclrType** equals 0x02, this field contains a [LongRGBA](#longrgba) that specifies an [**red-green-blue-alpha (RGBA)**](#gt_86add9f3-4083-49ce-a1b3-359595c14b65) value. If **xclrType** equals 0x03, this field contains a [ColorTheme](#colortheme) that specifies a theme color. + +**unused (8 bytes):** Undefined and MUST be ignored. + +### GradStop + +The **GradStop** structure specifies a [**gradient stop**](#gt_35b983af-d590-4f93-87cb-94786924511f) for a [**gradient fill**](#gt_35280309-5b22-4c17-be48-f06c37ffc685). + +[TABLE] + +**xclrType (2 bytes):** An [**XColorType**](#xcolortype) that specifies how the color information is stored. + +**xclrValue (4 bytes):** An unsigned integer that specifies the color data. If **xclrType** equals 0x00 or 0x04, this value MUST be 0. If **xclrType** equals 0x01, this field contains an [IcvXF](#icvxf) that specifies color in the color table. If **xclrType** equals 0x02, this field contains a [LongRGBA](#longrgba) that specifies an [**RGBA**](#gt_86add9f3-4083-49ce-a1b3-359595c14b65) value. If **xclrType** equals 0x03, this field contains a [ColorTheme](#colortheme) that specifies a theme color + +**numPosition (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the gradient stop position as the percentage of the gradient range. The gradient stop position is the position within the gradient range where this gradient stop’s color begins. MUST be greater than or equal to 0.0 and less than or equal to 1.0. + +**numTint (8 bytes):** An Xnum that specifies the tint of the color. MUST be greater than or equal to -1.0 and less than or equal to 1.0. Positive values lighten the color, and negative values darken the color. + +### HiddenMemberSet + +The **HiddenMemberSet** structure specifies [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) from a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) that are in the same level in an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c). + +[TABLE] + +**cMemberName (4 bytes):** An unsigned integer that specifies the number of elements in **rgMemberName**. + +**rgMemberName (variable):** An array of [XLUnicodeString](#xlunicodestring) structures. Each element specifies the name of a hidden OLAP member. MUST exist if and only if the value of **cMemberName** is greater than 0. + +### HideObjEnum + +The **HideObjEnum** enumeration specifies how [**ActiveX objects**](#gt_0d95e494-61b2-43bc-8818-51aa162d2018), [**OLE objects**](#gt_cdff9514-a3fb-4897-941d-4e99193a0096), and [**drawing objects**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) appear in a window that contains the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| Name | Value | Meaning | +|----|----|----| +| **SHOWALL** | 0x0000 | ActiveX objects, OLE objects, and drawing objects are displayed in the window that contains the workbook. | +| **SHOWPLACEHOLDER** | 0x0001 | Placeholders are displayed in place of ActiveX objects, OLE objects, and drawing objects in the window that contains the workbook. | +| **HIDEALL** | 0x0002 | ActiveX objects, OLE objects, and drawing objects are not displayed in the window that contains the workbook. | + +### HorizAlign + +The **HorizAlign** enumeration specifies the horizontal alignment. + +| Name | Value | Meaning | +|----|----|----| +| **ALCNIL** | 0xFF | Alignment not specified | +| **ALCGEN** | 0x00 | [**General alignment**](#gt_3ee6d1d4-830b-4dc2-b8be-751665f8045f) | +| **ALCLEFT** | 0x01 | Left alignment | +| **ALCCTR** | 0x02 | [**Centered alignment**](#gt_876925bf-49bc-4edb-a3fa-963f4cc8c0cc) | +| **ALCRIGHT** | 0x03 | Right alignment | +| **ALCFILL** | 0x04 | [**Fill alignment**](#gt_cfc4e171-6104-470e-9ebb-812afea17078) | +| **ALCJUST** | 0x05 | Justify alignment | +| **ALCCONTCTR** | 0x06 | [**Center-across-selection alignment**](#gt_ef7324bd-dac8-46e2-8df5-db44d8b925a8) | +| **ALCDIST** | 0x07 | Distributed alignment | + +### HorzBrk + +The **HorzBrk** structure specifies one horizontal [**page break**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871). + +[TABLE] + +**row (2 bytes):** A [RwU](#rwu) that specifies the zero-based index of the first row below the page break. + +**colStart (2 bytes):** An unsigned integer that specifies the zero-based index of the first column on the page. MUST be less than or equal to 16383. + +**colEnd (2 bytes):** An unsigned integer that specifies the zero-based index of the last column on the page. The value MUST be greater than **colStart** and less than or equal to 16383. + +### Icv + +The **Icv** structure specifies a color in the color table. + +[TABLE] + +**icv (2 bytes):** An unsigned integer that specifies a color from the color table. The value MUST be one of the following values: a value greater than or equal to 0x000 and less than or equal to 0x0041, a value greater than or equal to 0x004D and less than or equal to 0x004F, 0x0051, or 0x7FFF. + +The values that are greater than or equal to 0x0000 and less than or equal to 0x0007 specify built-in color constants. This part of the color table is: + +| **icv value** | **Color description** | **Red value** | **Green value** | **Blue value** | +|----|----|----|----|----| +| 0x0000 | Black | 0 | 0 | 0 | +| 0x0001 | White | 255 | 255 | 255 | +| 0x0002 | Red | 255 | 0 | 0 | +| 0x0003 | Green | 0 | 255 | 0 | +| 0x0004 | Blue | 0 | 0 | 255 | +| 0x0005 | Yellow | 255 | 255 | 0 | +| 0x0006 | Magenta | 255 | 0 | 255 | +| 0x0007 | Cyan | 0 | 255 | 255 | + +The next 56 values in the table, the **icv** values greater than or equal to 0x0008 and less than or equal to 0x003F, specify the palette colors in the table. If a [Palette](#palette) record exists in this file, these **icv** values specify colors from the **rgColor** array in the Palette record. If no Palette record exists, these values specify colors in the default palette. The next 56 values in this part of the color table specify the following: + +[TABLE] + +The remaining values in the color table specify colors associated with application display settings as follows: + +| Value | Meaning | +|----|----| +| 0x0040 | Default foreground color. This is the window text color in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) display. | +| 0x0041 | Default background color. This is the window background color in the sheet display and is the default background color for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). | +| 0x004D | Default [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) foreground color. This is the window text color in the chart display. | +| 0x004E | Default chart background color. This is the window background color in the chart display. | +| 0x004F | Chart neutral color which is black, an RGB value of (0,0,0). | +| 0x0051 | [**ToolTip**](#gt_84d44447-feaf-41a4-bf12-004c0f080fc2) text color. This is the automatic [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) color for comments. | +| 0x7FFF | Font automatic color. This is the window text color. | + +### IcvChart + +The **IcvChart** structure specifies a color in the [Chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) color table. The Chart color table is a subset of the full color table. See [Icv](#icv) for more information about the colors in the Chart color table. + +[TABLE] + +**icv (2 bytes):** An Icv that specifies a color from the chart color table. This value MUST be greater than or equal to 0x0000 and less than or equal to 0x0041, or greater than or equal to 0x004D and less than or equal to 0x00004F. This value SHOULD NOT[\<173\>](#Appendix_A_173) be less than 0x0008. + +### IcvFont + +The **IcvFont** structure specifies a color that is used by [**fonts**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). The font colors are a subset of the full color table. + +[TABLE] + +**icv (2 bytes):** An [Icv](#icv) that specifies a font color. MUST be greater than or equal to 0x0008 and less than or equal to 0x003F or 0x0051 or 0x7FFF. + +### IcvXF + +The **IcvXF** structure specifies a color in the color table used by [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) formatting properties. + +[TABLE] + +**icv (7 bits):** An unsigned integer that specifies a formatting property color. The value MUST be 0x48, or an [Icv](#icv) with a value greater than or equal to 0x01 and less than or equal to 0x3F, the default foreground color (0x40), or the default background color (0x41). This value SHOULD NOT[\<174\>](#Appendix_A_174) be 0x48, or less than or equal to 0x07. + +### IFmt + +The **IFmt** structure specifies the identifier of a [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b). + +[TABLE] + +**ifmt (2 bytes):** An unsigned integer that specifies the identifier of a number format. The identifier specified by this field MUST be a valid built-in number format identifier or the identifier of a custom number format as specified using a [Format](#format) record. Custom number format identifiers MUST be greater than or equal to 0x00A4 and less than or equal to 0x0188, and SHOULD[\<175\>](#Appendix_A_175) be less than or equal to 0x017E. The built-in number formats are listed in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1: Fundamentals And Markup Language Reference, section 18.8.30. + +### InteriorColorPropertiesForShapePropsStreamChecksum + +The **InteriorColorPropertiesForShapePropsStreamChecksum** structure specifies the interior color data used to compute the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the [ShapePropsStream](#shapepropsstream) record. + +The related [AreaFormat](#areaformat) record referenced in the following field specifications is the AreaFormat record that exists along with the ShapePropsStream record in one of the following sets of records. + +- A sequence of records that conforms to the [FRAME](#chart-sheet-substream) rule. + +- A sequence of records that conforms to the DROPBAR rule. + +- A sequence of records that conforms to the AXS rule if the field **wObjContext** in the ShapePropsStream record is equal to 0x0003. + +- A sequence of records that conforms to the SS rule. + +  + +- If the field **wObjContext** in the ShapePropsStream record is equal to 0x0001, then the **foregroundColor** and **backgroundColor** properties are obtained from the [MarkerFormat](#markerformat) record in the sequence of records that conforms to the SS rule instead. + +[TABLE] + +**foregroundColor (4 bytes):** A [LongRGB](#longrgb) that specifies the [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) of the [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e). MUST equal the value specified by the **rgbFore** field of the related AreaFormat or MarkerFormat records. + +**backgroundColor (4 bytes):** A LongRGB that specifies the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) of the fill pattern. MUST equal the value specified by the **rgbBack** field of the related AreaFormat or MarkerFormat records. + +**fls (1 byte):** An unsigned integer that specifies the type of the fill pattern. MUST equal the value specified by the **fls** field of the related AreaFormat record. + +### ISSTInf + +The **ISSTInf** structure is the array element used in the **rgISSTinf** field of the [ExtSST](#extsst) record. **ib** and **cbOffset** provide a way to access the first string in the set of strings specified by this structure. + +[TABLE] + +**ib (4 bytes):** A FilePointer as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.5 that specifies the zero-based offset into the [workbook stream](#Section_f682f4b08c6b444e83f852d156f1e8ba) where the first string in the set of strings starts. + +**cbOffset (2 bytes):** An unsigned integer that specifies the zero-based offset into the [SST](#sst) or [Continue](#continue) record, in which the first string in the set of strings starts. MUST be less than **ib**. The size of the SST or Continue record is determined by reading the record header at the location specified by the following formula: + +**ib – cbOffset** + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +### IXFCell + +The **IXFCell** structure specifies the index of a [cell XF](#Section_518a740d71c640c8bb97e7df6915861a). + +[TABLE] + +**ixfe (2 bytes):** An unsigned integer that specifies a zero-based index of a cell XF record in the collection of [XF](#xf) records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). Cell XF records are the subset of XF records with an **fStyle** field equal to 0. This value MUST be greater than or equal to 15, or equal to 0. The value 0 indicates that this value MUST be ignored. See [XFIndex](#xfindex) for more information about the organization of XF records in the file. + +### KPIProp + +The **KPIProp** enumeration specifies the types of [MDX KPI properties](#Section_db8664f2502b43d2aa88274035b52570). + +| Name | Value | Meaning | +|----|----|----| +| **KPIPROPVALUE** | 0x01 | Value. | +| **KPIPROPGOAL** | 0x02 | Goal. | +| **KPIPROPSTATUS** | 0x03 | Status. | +| **KPIPROPTREND** | 0x04 | Trend. | +| **KPIPROPWEIGHT** | 0x05 | Weight. | +| **KPIPROPCURRENTTIMEMEMBER** | 0x06 | Current time [**member (2)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11). | + +### KPISets + +The **KPISets** structure specifies icon sets. + +| Name | Value | Meaning | +|------------------------|------------|---------------------------| +| **KPINIL** | 0xFFFFFFFF | Sort by no-icon | +| **KPI3ARROWS** | 0x00000000 | Kpi3 Arrows set | +| **KPI3ARROWSGRAY** | 0x00000001 | Kpi3 Arrows Gray set | +| **KPI3FLAGS** | 0x00000002 | Kpi3 Flags set | +| **KPI3TRAFFICLIGHTS1** | 0x00000003 | Kpi3 Traffic Lights 1 set | +| **KPI3TRAFFICLIGHTS2** | 0x00000004 | Kpi3 Traffic Lights 2 set | +| **KPI3SIGNS** | 0x00000005 | Kpi3 Signs set | +| **KPI3SYMBOLS** | 0x00000006 | Kpi3 Symbols set | +| **KPI3SYMBOLS2** | 0x00000007 | Kpi3 Symbols 2 set | +| **KPI4ARROWS** | 0x00000008 | Kpi4 Arrows set | +| **KPI4ARROWSGRAY** | 0x00000009 | Kpi4 Arrows Gray set | +| **KPI4REDTOBLACK** | 0x0000000A | Kpi4 Red To Black set | +| **KPI4RATING** | 0x0000000B | Kpi4 Rating set | +| **KPI4TRAFFICLIGHTS** | 0x0000000C | Kpi4 Traffic Lights set | +| **KPI5ARROWS** | 0x0000000D | Kpi5 Arrows set | +| **KPI5ARROWSGRAY** | 0x0000000E | Kpi5 Arrows Gray set | +| **KPI5RATING** | 0x0000000F | Kpi5 Rating set | +| **KPI5QUARTERS** | 0x00000010 | Kpi5 Quarters set | + +### LbsDropData + +The **LbsDropData** structure specifies properties of the dropdown [Obj](#obj) that contains this LbsDropData. + +[TABLE] + +**A - wStyle (2 bits):** An unsigned integer that specifies the style of this dropdown. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------------------| +| 0 | Combo dropdown control | +| 1 | Combo Edit dropdown control | +| 2 | Simple dropdown control (just the dropdown button) | + +**B - unused1 (1 bit):** Undefined and MUST be ignored. + +**C - fFiltered (1 bit):** A bit that specifies whether the data displayed by the dropdown has been filtered in some way. + +**unused2 (12 bits):** Undefined and MUST be ignored. + +**cLine (2 bytes):** An unsigned integer that specifies the number of lines to be displayed in the dropdown. If there are more lines than that in the list, a scrollbar can appear. MUST be less than or equal to 0x7FFF. + +**dxMin (2 bytes):** An unsigned integer that specifies the smallest width in pixels allowed for the dropdown window. MUST be less than or equal to 0x7FFF. + +**str (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the current string value in the dropdown. + +**unused3 (1 byte):** Optional, undefined and MUST be ignored. This field MUST exist if and only if the size of **str** in bytes is an odd number. + +### LEMMode + +The **LEMMode** enumeration specifies the different edit modes for a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +| Name | Value | Meaning | +|----|----|----| +| **LEMNORMAL** | 0x00000000 | The table can be directly edited inline. | +| **LEMREFRESHCOPY** | 0x00000001 | The table is refreshed before editing is allowed because is it a copy of a table whose source is a Web based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list. | +| **LEMREFRESHCACHE** | 0x00000002 | The table is refreshed before editing is allowed because caching a user change failed. | +| **LEMREFRESHCACHEUNDO** | 0x00000003 | The table is refreshed before editing is allowed because undoing a cached user change failed. | +| **LEMREFRESHLOADED** | 0x00000004 | The table is refreshed before editing is allowed because on load the table source could not be re-connected. | +| **LEMREFRESHTEMPLATE** | 0x00000005 | The table is refreshed before editing is allowed because it was saved without having its data cached. | +| **LEMREFRESHREFRESH** | 0x00000006 | The table is refreshed before editing is allowed because a previous [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) failed. | +| **LEMNOINSROWSSPREQUIRED** | 0x00000007 | Rows cannot be inserted into this web based data provider list because there are hidden required columns. | +| **LEMNOINSROWSSPDOCLIB** | 0x00000008 | Rows cannot be inserted into this Web based data provider list because it is a [**document library**](#gt_d9f07822-aeb0-4642-ab51-95cb724fbf35). | +| **LEMREFRESHLOADDISCARDED** | 0x00000009 | The table is refreshed before editing is allowed because the user selected to discard cached changes upon loading. | +| **LEMREFRESHLOADHASHVALIDATION** | 0x0000000A | The table is refreshed before editing is allowed because the validation of the table's data area failed upon loading. | +| **LEMNOEDITSPMODVIEW** | 0x0000000B | Cannot allow the user to edit this table because of the type of moderated Web based data provider list it is. | + +### LinePropertiesForShapePropsStreamChecksum + +The **LinePropertiesForShapePropsStreamChecksum** record specifies the line properties data used to compute the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the [ShapePropsStream](#shapepropsstream) record. + +The related [LineFormat](#lineformat) record referenced in the following field specifications is the LineFormat record that exists along with the ShapePropsStream record in one of the following sets of records. + +- A set of records in a [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) but not in the sequence of records that conforms to the [LD](#chart-sheet-substream) rule or the sequence of records that conforms to the DROPBAR rule. + +  + +- If more than one LineFormat and ShapePropsStream records exist in the set, then a pair of LineFormat and ShapePropsStream records are related when the chart element identified by the **ID** field of the [CrtLine](#crtline) record preceding the LineFormat record is the same chart element as the one identified by the **wObjContext** field of the ShapePropsStream record. + +  + +- A sequence of records that conforms to the FRAME rule. + +- A sequence of records that conforms to the DROPBAR rule. + +- A sequence of records that conforms to the AXS rule. + +  + +- If more than one LineFormat and ShapePropsStream records exist in the sequence of records, then a pair of LineFormat and ShapePropsStream records are related when the chart element identified by the **ID** field of the [AxisLine](#axisline) record preceding the LineFormat record is be the same chart element as the one identified by the **wObjContext** field of the ShapePropsStream record. + +  + +- A sequence of records that conforms to the SS rule when the **wObjContext** field of the ShapePropsStream record is 0x0000. + +[TABLE] + +**icv (1 byte):** An [IcvChart](#icvchart) that specifies the [**palette color**](#gt_be899517-b752-44f1-8c38-2561d17a8a7f) value for the line. The color MUST match the color specified by **color** field. MUST equal the value specified by the **icv** field of the related LineFormat record. + +**pattern (1 byte):** An unsigned integer that specifies the pattern of the line. MUST equal the value specified by the **lns** field of the related LineFormat record. + +**thickness (1 byte):** A signed integer that specifies the thickness of the line. MUST equal the value specified by the **we** field of the related LineFormat record plus one. + +**A - fIsLineStyleAutomatic (1 bit):** A bit that specifies whether the line has default formatting. MUST contain the value specified by the **fAuto** field of the related LineFormat record. + +**unused (7 bits):** Unused and MUST be zero. + +**color (4 bytes):** A [LongRGB](#longrgb) that specifies the color of the line. The color MUST match the color specified by **icv**. MUST equal the value specified by the **rgb** field of the related LineFormat record. + +### List12BlockLevel + +The **List12BlockLevel** structure specifies default [**block-level formatting**](#gt_4ad37d18-8570-450e-8376-9606e8ff98b4) information for a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7), to be applied when the table expands. [Style](#style) gets applied before [DXFN12List](#dxfn12list) for each table region. + +[TABLE] + +**cbdxfHeader (4 bytes):** A signed integer that specifies the byte count for **dxfHeader** field. MUST be greater than or equal to zero. + +**istnHeader (4 bytes):** A signed integer that specifies a zero-based index to a Style record in the collection of Style records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The referenced Style specifies the [cell style XF](#Section_3d5348ded9df4c31b1fd9f9377273152) used for the table’s [**header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38) [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). If the value is -1, no style is specified for the table’s header row cells. + +**cbdxfData (4 bytes):** A signed integer that specifies the byte count for **dxfData** field. MUST be greater than or equal to zero. + +**istnData (4 bytes):** A signed integer that specifies a zero-based index to a Style record in the collection of Style records in the Globals Substream. The referenced Style specifies the [cell style](#Section_f9425d3f127545be8389bf80f65b56b7) used for the table’s data cells. If the value is -1, no style is specified for the table’s data cells. + +**cbdxfAgg (4 bytes):** A signed integer that specifies the byte count for **dxfAgg** field. MUST be greater than or equal to zero. + +**istnAgg (4 bytes):** A signed integer that specifies a zero-based index to a Style record in the collection of Style records in the Globals Substream. The referenced Style specifies the cell style used for the table’s [**total row**](#gt_95e9bcf4-d644-4e96-9070-dbc80b4d1b28). If the value is -1, no style is specified for the table’s total row. + +**cbdxfBorder (4 bytes):** A signed integer that specifies the byte count for **dxfBorder** field. MUST be greater than or equal to zero. + +**cbdxfHeaderBorder (4 bytes):** A signed integer that specifies the byte count for **dxfHeaderBorder** field. MUST be greater than or equal to zero. + +**cbdxfAggBorder (4 bytes):** A signed integer that specifies the byte count for **dxfAggBorder** field. MUST be greater than or equal to zero. + +**dxfHeader (variable):** An optional DXFN12List that specifies the formatting for the table’s header row cells. MUST exist if and only if **cbdxfHeader** is nonzero. + +**dxfData (variable):** An optional DXFN12List that specifies the formatting for the table’s data cells. MUST exist if and only if **cbdxfData** is nonzero. + +**dxfAgg (variable):** An optional DXFN12List that specifies the formatting for the table’s total row. MUST exist if and only if **cbdxfAgg** is nonzero. + +**dxfBorder (variable):** An optional DXFN12 that specifies the formatting for the [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) of the table’s data cells. MUST exist if and only if **cbdxfBorder** is nonzero. + +**dxfHeaderBorder (variable):** An optional DXFN12List that specifies the formatting for the border of the table’s header row cells. MUST exist if and only if **cbdxfHeaderBorder** is nonzero. + +**dxfAggBorder (variable):** An optional DXFN12List that specifies the formatting for the border of the table’s total row. MUST exist if and only if **cbdxfAggBorder** is nonzero. + +**stHeader (variable):** An optional [XLUnicodeString](#xlunicodestring) that specifies the name of the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) for the table’s header row cells. MUST exist if and only if **istnHeader** is not equal to -1. MUST be equal to the name of the Style record specified by **istnHeader**. If the style is a user-defined style, **stHeader** MUST be equal to the **user** field of the Style record. + +**stData (variable):** An optional XLUnicodeString that specifies the name of the style for the table’s data cells. MUST exist if and only if **istnData** is not equal to -1. MUST be equal to the name of the Style record specified by **istnData**. If the style is a user-defined style, **stData** MUST be equal to the **user** field of the Style record. + +**stAgg (variable):** An optional XLUnicodeString that specifies the name of the style for the table’s total row. MUST exist if and only if **istnAgg** is not equal to -1. MUST be equal to the name of the Style record specified by **istnAgg**. If the style is a user-defined style, **stAgg** MUST be equal to the **user** field of the Style record. + +### List12DisplayName + +The **List12DisplayName** structure specifies the name and comment strings for the [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +[TABLE] + +**stListName (variable):** An [XLNameUnicodeString](#xlnameunicodestring) that specifies the table name. MUST be an empty string if the **rgbName** field of the [TableFeatureType](#tablefeaturetype) structure embedded in the [Feature11](#feature11) or [Feature12](#feature12) record that specifies the table is not empty. If the table name is not the same as the **rgbName** field of the TableFeatureType structure for this table, the table name is specified in **stListName** which is a case-insensitive unique name among all table names and [**defined names**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +**stListComment (variable):** An [XLUnicodeString](#xlunicodestring) that specifies a comment about the table. + +### List12TableStyleClientInfo + +The **List12TableStyleClientInfo** record specifies information about the style applied to a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +[TABLE] + +**A - fFirstColumn (1 bit):** A bit that specifies whether any [table style elements](#Section_84f2f67849214e8c83eb10d4fff7e935) (as specified by [TableStyleElement](#tablestyleelement)) with a **tseType** field equal to 0x00000003 will be applied. + +**B - fLastColumn (1 bit):** A bit that specifies whether any table style elements (as specified by TableStyleElement) with a **tseType** field equal to 0x00000004 will be applied. + +**C - fRowStripes (1 bit):** A bit that specifies whether any table style elements (as specified by TableStyleElement) with a **tseType** field equal to 0x00000005 or 0x00000006 will be applied. + +**D - fColumnStripes (1 bit):** A bit that specifies whether any table style elements (as specified by TableStyleElement) with a **tseType** field equal to 0x00000007 or 0x00000008 will be applied. + +**E - unused1 (2 bits):** Undefined and MUST be ignored. + +**F - fDefaultStyle (1 bit):** A bit that specifies whether the style whose name is specified by **stListStyleName** is the default [table style](#Section_4ac7212b4aa74ece962526c58224ae80). + +**unused2 (9 bits):** Undefined and MUST be ignored. + +**stListStyleName (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the name of the table style for the table. Length MUST be greater than zero and less than or equal to 255 characters. If the table style is a custom style, it is defined in a [TableStyle](#tablestyle) record that has **rgchName** equal to this value. + +### LongRGB + +The **LongRGB** structure specifies a color as a combination of red, green, and blue. + +[TABLE] + +**red (1 byte):** An unsigned integer that specifies the relative intensity of red. + +**green (1 byte):** An unsigned integer that specifies the relative intensity of green. + +**blue (1 byte):** An unsigned integer that specifies the relative intensity of blue. + +**reserved (1 byte):** MUST be zero, and MUST be ignored. + +### LongRGBA + +The **LongRGBA** structure specifies a color as a combination of red, green, blue and alpha values. + +[TABLE] + +**red (1 byte):** An unsigned integer that specifies the relative intensity of red. + +**green (1 byte):** An unsigned integer that specifies the relative intensity of green. + +**blue (1 byte):** An unsigned integer that specifies the relative intensity of blue. + +**alpha (1 byte):** An unsigned integer that specifies the alpha value. + +### LPWideString + +The **LPWideString** type specifies a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string which is prefixed by a length. + +[TABLE] + +**cchCharacters (2 bytes):** An unsigned integer that specifies the number of characters. + +**rgchData (variable):** An array of Unicode characters that specifies the characters of the string.  The size of this array in bytes MUST equal the following formula: + +**cchCharacters** \* 2 + +### MDir + +The **MDir** structure specifies the [MDTInfoIndex](#mdtinfoindex) and the index of a specific [MDX metadata](#Section_0f7583182c0b4155bf75c7399f89305c) record. + +[TABLE] + +**imdt (4 bytes):** An MDTInfoIndex that identifies the [MDTInfo](#mdtinfo) record. + +**mdd (4 bytes):** An unsigned integer that specifies the zero-based index of an MDX metadata record in the collection of MDX metadata records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The referenced record specifies a MDX metadata record corresponding to the record type specified by **imdt**. The MDX metadata records include [MDXTuple](#mdxtuple), [MDXSet](#mdxset), [MDXProp](#mdxprop) and [MDXKPI](#mdxkpi) records. + +### MDTInfoIndex + +The **MDTInfoIndex** structure specifies an index which identifies an [MDTInfo](#mdtinfo) record. + +[TABLE] + +**index (4 bytes):** A signed integer that specifies the one-based index of an MDTInfo record in the collection of MDTInfo records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The value MUST be greater than 0 and less than or equal to the total number of the MDTInfo records in the file. + +### MDXStrIndex + +The **MDXStrIndex** structure specifies the index of an [MDXStr](#mdxstr) record. + +[TABLE] + +**index (4 bytes):** A signed integer that specifies the zero-based index of an MDXStr record in the collection of MDXStr records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The value MUST be greater than or equal to 0 and less than the total number of the MDXStr records that have been read so far. + +### MOper + +The **MOper** structure specifies multiple operands of an [**OLE link**](#gt_63bdff5e-89bb-4e82-bc5d-ab1de245efff) or a [**DDE link**](#gt_0aa0fad9-afc1-4433-b772-2dc11e641721) for the [ExternOleDdeLink](#externoleddelink) structure. + +[TABLE] + +**colLast (1 byte):** A [ColByteU](#colbyteu) that specifies the zero-based index of last column associated with the link. + +**rowLast (2 bytes):** A [RwU](#rwu) that specifies the zero-based index of last row associated with the link. + +**extOper (variable):** This array specifies current values for the linked data. Each [SerAr](#serar) specifies a cell value. The number of elements in the array is + +(**colLast** + 1) \* (**rowLast** + 1). + +If this array does not fit in the owning [ExternName](#externname) record, [Continue](#continue) records are used. Each SerAr MUST stay in the same record. + +### NilChartNum + +The **NilChartNum** structure specifies a non-numeric value (also known as "NaN" or "Not a Number") that is used in place of a numeric value. + +[TABLE] + +**unused (4 bytes):** Undefined and MUST be ignored. + +**type (2 bytes):** An unsigned integer that specifies the interpretation of this value. This field is undefined and MUST be ignored, unless otherwise defined by the containing record. + +**reserved (2 bytes):** MUST be 0xFFFF and MUST be ignored. + +### NoteRR + +The **NoteRR** structure specifies a [revision record](#Section_d120a1ffd2e6488381a507236f1994b0) for a [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) associated with a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +[TABLE] + +**rrd (14 bytes):** An [RRD](#rrd) that specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). The **rrd.revt** MUST be equal to 0x000D. The **rrd.tabid** MUST NOT be 0xFFFF. + +**A - bitfDelNote (1 bit):** A bit that specifies whether the revision record deletes the comment. + +**B - bitfAddNote (1 bit):** A bit that specifies whether the revision record adds text to the comment. + +| Value | Meaning | +|----|----| +| 0 | Text has not been added to the comment. | +| 1 | A new comment is being added or additional text is being appended to an existing comment. | + +**reserved1 (14 bits):** MUST be 0 and MUST be ignored. + +**row (2 bytes):** A [RwU](#rwu) that specifies the row of the cell associated with the comment. + +**col (2 bytes):** A [ColU](#colu) that specifies the column of the cell associated with the comment. + +**C - reserved2 (1 bit):** MUST be 0 and MUST be ignored. + +**D - fShow (1 bit):** A bit that specifies whether the comment is shown. + +**reserved3 (5 bits):** MUST be 0 and MUST be ignored. + +**E - fRwHidden (1 bit):** A bit that specifies whether the row specified by **row** is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**F - fColHidden (1 bit):** A bit that specifies whether the column specified by **col** is hidden. + +**G - reserved4 (2 bits):** MUST be 0 and MUST be ignored. + +**H - unused1 (1 bit):** Unused and MUST be ignored. + +**I - reserved5 (4 bits):** MUST be 0 and MUST be ignored. + +**guid (16 bytes):** A [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) as specified by [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) that identifies the comment, specified by a [NoteSh](#notesh) structure, which is modified by this revision record. The GUID for a comment is specified in the [Obj](#obj) record specified by the **idObj** field in the NoteSh structure. In the Obj record, the GUID is stored in the **nts.guid** field. If **bitfDelNote** is 1, this field MUST be zero. + +**ichEnd (4 bytes):** An unsigned integer that specified the length of the comment before the revision is made. + +**cchNote (4 bytes):** An unsigned integer that specifies the length of the string that was added to the comment in the revision record. The sum of **ichEnd** and **cchNote** MUST be less than or equal to 32767. + +**stAuthor (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the original author of the comment. The length MUST be greater than or equal to 1 and less than or equal to 54. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +### NoteSh + +The **NoteSh** structure specifies a [**comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) associated with a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +[TABLE] + +**row (2 bytes):** A [RW](#rw) that specifies the row of the cell to which this comment is associated. + +**col (2 bytes):** A [Col](#col) that specifies the column of the cell to which this comment is associated. + +**A - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**B - fShow (1 bit):** A bit that specifies whether the comment is shown at all times. + +**C - reserved2 (1 bit):** MUST be zero and MUST be ignored. + +**D - unused1 (1 bit):** Undefined and MUST be ignored. + +**E - reserved3 (3 bits):** MUST be zero and MUST be ignored. + +**F - fRwHidden (1 bit):** A bit that specifies whether the row specified by **row** is [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**G - fColHidden (1 bit):** A bit that specifies whether the column specified by **col** is hidden. + +**reserved4 (7 bits):** MUST be zero and MUST be ignored. + +**idObj (2 bytes):** An [ObjId](#objid) that specifies the [Obj](#obj) record that specifies the comment text. + +**stAuthor (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the name of the comment author. String length MUST be greater than or equal to 1 and less than or equal to 54. + +**unused2 (1 byte):** Undefined and MUST be ignored. + +### ObjFmla + +The **ObjFmla** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in an [Obj](#obj) record. + +[TABLE] + +**cbFmla (2 bytes):** An unsigned integer that specifies the number of bytes in this ObjFmla, not counting the two bytes of the **cbFmla** field itself. This number MUST be even. + +**fmla (variable):** An optional [ObjectParsedFormula](#objectparsedformula) that specifies the formula. This field MUST exist if and only if **cbFmla** is greater than 0x0000. + +**embedInfo (variable):** An optional [PictFmlaEmbedInfo](#pictfmlaembedinfo). This field MUST exist if and only if the structure containing this ObjFmla is an [FtPictFmla](#ftpictfmla), the **fmla** field exists, and the **fmla.rgce** field starts with a [PtgTbl](#ptgtbl). + +**padding (variable):** An array of bytes whose size is given by: +**cbFmla** minus size of **fmla** minus size of **embedInfo**. + +It is possible for this array to be empty. The value of the elements in this array are undefined and MUST be ignored. + +### ObjId + +The **ObjId** structure specifies a reference to an [Obj](#obj). + +[TABLE] + +**id (2 bytes):** An unsigned integer that specifies the value of the **cmo.id** field of an Obj in the same [**drawing**](#gt_4b4d1a42-c4a2-464d-ad16-d53b5c493fd3). A value of 0 specifies that this ObjId does not reference an Obj. + +### ObjLinkFmla + +The **ObjLinkFmla** structure specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) which contains a value that is linked to the control represented by the [Obj](#obj) record containing this ObjLinkFmla. + +[TABLE] + +**ft (2 bytes):** Reserved. MUST be 0x0014 if the **cmo.ot** of the containing Obj is equal to 0x0B or 0x0C. MUST be 0x000E if the **cmo.ot** field of the containing Obj is equal to 0x10, 0x11, 0x12, or 0x14. Note that this ObjLinkFmla MUST NOT exist if **cmo.ot** is any other value. + +**fmla (variable):** An [ObjFmla](#objfmla) that specifies the formula which specifies a range which contains a value that is linked to the state of the control. + +### ODBCType + +The **ODBCType** structure specifies an [**ODBC**](#gt_7883fa02-8dc0-4154-894f-fe3a7bff153e) data type identifier. + +[TABLE] + +**wTypeSql (2 bytes):** A signed integer that specifies an ODBC data type. The following are example data types supported by ODBC. For more information about ODBC, see [\[MSDN-OpenDBConnectivity\]](https://go.microsoft.com/fwlink/?LinkId=114655). + +| Value | SQL Type | Data Type | +|----|----|----| +| 0x0000 | SQL_TYPE_NULL | Undetermined type, [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) does not support typed data. Data type determined based on data content: date and time, decimal or text. | +| 0x0001 | SQL_CHAR | Fixed-length string of ANSI characters | +| 0x0003 | SQL_DECIMAL | Fixed-precision, Fixed-scale numbers | +| 0x0004 | SQL_INTEGER | 32-bit signed integer | +| 0x0005 | SQL_SMALLINT | 16-bit signed integer | +| 0x0006 | SQL_FLOAT | User-specified precision floating-point | +| 0x0007 | SQL_REAL | 7-digits precision floating-point | +| 0x0008 | SQL_DOUBLE | 15-digits precision floating-point | +| 0x000B | SQL_TIMESTAMP | Date and Time | +| 0x000C | SQL_VARCHAR | Variable-length string of ANSI characters | +| 0xFFF9 | SQL_BIT | Bit (1 or 0) | +| 0xFFFE | SQL_BINARY | Fixed-length binary data | + +### OfficeArtClientAnchorChart + +The **OfficeArtClientAnchorChart** structure specifies the anchor position of a [**drawing object**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) embedded in a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +[TABLE] + +**rh (8 bytes):** An OfficeArtRecordHeader as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.2.1 that specifies the header for this structure. **rh.recVer** MUST be 0x0. **rh.recInstance** MUST be 0x0. **rh.recType** MUST be 0xF010. **rh.recLen** MUST be 0x0012. + +**A - fMove (1 bit):** MUST be 0 and MUST be ignored. + +**B - fSize (1 bit):** A bit that specifies whether the drawing object resizes with the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | The drawing object resizes with the chart area (section 2.2.3.17). | +| 0x1 | The drawing object does not resize with the chart area (section 2.2.3.17). | + +**C - reserved1 (1 bit):** MUST be 0 and MUST be ignored. + +**D - reserved2 (1 bit):** Undefined and MUST be ignored. + +**E - reserved3 (1 bit):** MUST be 0 and MUST be ignored. + +**unused (11 bits):** Undefined and MUST be ignored. + +**lx1 (4 bytes):** A signed integer that specifies the horizontal offset of the logical upper-left corner of the [**bounding rectangle**](#gt_e349a155-0fb9-4ba1-abd4-e363e21abcd1) of the drawing object, relative to the upper-left corner of the chart area (section 2.2.3.17) in [SPRC](#Section_d5fc728e68de4972905a975bcef8c82d). + +**ly1 (4 bytes):** A signed integer that specifies the vertical offset of the logical upper-left corner of the bounding rectangle of the drawing object, relative to the upper-left corner of the chart area (section 2.2.3.17) in SPRC. + +**lx2 (4 bytes):** A signed integer that specifies the horizontal offset of the logical bottom-right corner of the bounding rectangle of the drawing object, relative to the upper-left corner of the chart area (section 2.2.3.17) in SPRC. + +**ly2 (4 bytes):** A signed integer that specifies the vertical offset of the logical bottom-right corner of the bounding rectangle of the drawing object, relative to the upper-left corner of the chart area (section 2.2.3.17) in SPRC. + +### OfficeArtClientAnchorHF + +The **OfficeArtClientAnchorHF** structure specifies the [**dimension (2)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) information of a picture specified in a [HFPicture](#hfpicture) record. + +[TABLE] + +**rh (8 bytes):** An OfficeArtRecordHeader as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) that specifies the header for this structure. The sub-fields of OfficeArtRecordHeader are further specified in the following table: + +| Field | Meaning | +|--------------------|-----------------| +| **rh.recVer** | MUST be 0x0. | +| **rh.recInstance** | MUST be 0x0. | +| **rh.recType** | MUST be 0xF010. | +| **rh.recLen** | MUST be 8. | + +**width (4 bytes):** A signed integer that specifies the width of the picture in pixels. This value MUST be greater than 0. + +**height (4 bytes):** A signed integer that specifies the height of the picture in pixels. This value MUST be greater than 0. + +### OfficeArtClientAnchorSheet + +The **OfficeArtClientAnchorSheet** structure specifies the anchor position of a [**drawing object**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) embedded in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rh (8 bytes):** An OfficeArtRecordHeader as defined in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) that specifies the header for this structure. The sub-fields of OfficeArtRecordHeader are further specified in the following table: + +| Field | Meaning | +|----|----| +| **rh.recVer** | MUST be 0x0. | +| **rh.recInstance** | MUST be 0x0. | +| **rh.recType** | MUST be 0xF010. | +| **rh.recLen** | An unsigned integer that specifies the number of bytes following the header. The value MUST be equal to 18. | + +**A - fMove (1 bit):** A bit that specifies whether the [**shape**](#gt_d0e38aa4-2c71-4a6f-b5e6-75766fa9409e) will be kept intact when the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) are moved. + +**B - fSize (1 bit):** A bit that specifies whether the shape will be kept intact when the cells are resized. If **fMove** is 1, the value MUST be 1. + +**C - reserved1 (1 bit):** MUST be 0 and MUST be ignored. + +**D - reserved2 (1 bit):** MUST be 0 and MUST be ignored + +**E - reserved3 (1 bit):** MUST be 0 and MUST be ignored. + +**unused (11 bits):** Undefined and MUST be ignored. + +**colL (2 bytes):** A [Col256U](#col256u) that specifies the column of the cell under the top left corner of the [**bounding rectangle**](#gt_e349a155-0fb9-4ba1-abd4-e363e21abcd1) of the shape. + +**dxL (2 bytes):** A signed integer that specifies the x coordinate of the top left corner of the bounding rectangle relative to the corner of the underlying cell. The value is expressed as 1024th’s of that cell’s width. + +**rwT (2 bytes):** A [RwU](#rwu) that specifies the row of the cell under the top left corner of the bounding rectangle of the shape. + +**dyT (2 bytes):** A signed integer that specifies the y coordinate of the top left corner of the bounding rectangle relative to the corner of the underlying cell. The value is expressed as 256th’s of that cell’s height. + +**colR (2 bytes):** A Col256U that specifies the column of the cell under the bottom right corner of the bounding rectangle of the shape. + +**dxR (2 bytes):** A signed integer that specifies the x coordinate of the bottom right corner of the bounding rectangle relative to the corner of the underlying cell. The value is expressed as 1024th’s of that cell’s width. + +**rwB (2 bytes):** A RwU that specifies the row of the cell under the bottom right corner of the bounding rectangle of the shape. + +**dyB (2 bytes):** A signed integer that specifies the y coordinate of the bottom right corner of the bounding rectangle relative to the corner of the underlying cell. The value is expressed as 256th’s of that cell’s height. + +### OfficeArtClientData + +The **OfficeArtClientData** structure specifies the client data of an [**drawing object**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac). MUST be the last structure of the **rgChildRec** field of the current [MsoDrawing](#msodrawing) record. And the next record MUST be [**Obj**](#obj), which contains the detailed data information about this drawing object. + +[TABLE] + +**rh (8 bytes):** An OfficeArtRecordHeader as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.2.1 that specifies the header for this structure. The subfields of OfficeArtRecordHeader are further specified in the following table: + +| Field | Meaning | +|----|----| +| **rh.recVer** | MUST be 0x0. | +| **rh.recInstance** | MUST be 0x0. | +| **rh.recType** | MUST be 0xF011. | +| **rh.recLen** | An unsigned integer that specifies the number of bytes following the header. The value MUST be equal to 0. | + +### OfficeArtClientTextbox + +The **OfficeArtClientTextbox** structure specifies the client textbox of an [**drawing object**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac). MUST be the last structure of the **rgChildRec** field of the [MsoDrawing](#msodrawing) record. And the next record MUST be [**TxO**](#txo), which contains the detailed textbox information about this drawing object. + +[TABLE] + +**rh (8 bytes):** An OfficeArtRecordHeader as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.2.1 that specifies the header for this structure. The subfields of OfficeArtRecordHeader are further specified in the following table: + +| Field | Meaning | +|----|----| +| **rh.recVer** | MUST be 0x0. | +| **rh.recInstance** | MUST be 0x0. | +| **rh.recType** | MUST be 0xF00D. | +| **rh.recLen** | An unsigned integer that specifies the number of bytes following the header. The value MUST be equal to 0. | + +### PaneType + +The **PaneType** enumeration specifies the different types of [**panes**](#gt_fa363a22-6c89-4829-86aa-09f939f40a54). + +| Name | Value | Meaning | +|---------------------|-------|---------------------------| +| **REVTPNNBOTRIGHT** | 0x00 | logical bottom-right pane | +| **REVTPNNTOPRIGHT** | 0x01 | logical top-right pane | +| **REVTPNNBOTLEFT** | 0x02 | logical bottom-left pane | +| **REVTPNNTOPLEFT** | 0x03 | logical top-left pane | + +### PARAMQRY_Fixed + +**PARAMQRY_Fixed** structure contains information about [**SQL**](#gt_37416b0f-ca5b-4fac-96e5-082eb80a3d84) query parameters. + +[TABLE] + +**wTypeSql (2 bytes):** An [ODBCType](#odbctype) structure that specifies the SQL data type. + +**pbt (2 bits):** An unsigned integer that specifies the parameter type. MUST be a value from the following table: + +| Value | Meaning | +|------:|----------------------------------------------------------| +| 0 | Prompt. User is prompted for the value of the parameter. | +| 1 | Value. The parameter value is specified in the query. | +| 2 | Reference. The parameter value is specified in a cell. | + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - fNonDefaultName (1 bit):** A bit that specifies whether to use the default prompt if **pbt** is equal to 0. MUST be a value from the following table: + +| Value | Meaning | +|------:|--------------------------------------| +| 0 | User entered prompt is used | +| 1 | Application’s default prompt is used | + +**unused2 (12 bits):** Undefined and MUST be ignored. + +**grbit (2 bytes):** An unsigned integer that specifies the type of data that follows this structure as specified in the following table or the presence of a Boolean value in **fVal** if **pbt** equals 1**.** MUST be a value from the following table if **pbt** equals 1: + +| Value | Meaning | +|------:|---------------------------------------------------------| +| 0x001 | Xnum (section [2.5.342](#xnum)) | +| 0x002 | [SXString](#sxstring) | +| 0x004 | Boolean (section [2.5.14](#boolean)) value in **fVal.** | +| 0x800 | 4 byte unsigned integer | + +**fVal (2 bytes):** A Boolean that specifies value such that if **pbt** equals 1 and **grbit** equals 4. MUST be equal to 0 or 1 if **pbt** equals 1 and **grbit** equals 4. MUST be ignored if **pbt** is not equal to 1 or **grbit** is not equal to 4. + +### Parsed Expressions + +#### ArrayParsedFormula + +The **ArrayParsedFormula** structure specifies an array formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). + +[TABLE] + +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula (section 2.2.2). MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgRefN](#ptgrefn), [PtgAreaN](#ptgarean), or [PtgSxName](#ptgsxname). + +**rgcb (variable):** An [RgbExtra](#rgbextra) that specifies ancillary data for the formula. + +#### BErr + +The **BErr** structure is a 1 byte unsigned integer that specifies an error. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------| +| 0x00 | \#NULL! | +| 0x07 | \#DIV/0! | +| 0x0F | \#VALUE! | +| 0x17 | \#REF! | +| 0x1D | \#NAME? | +| 0x24 | \#NUM! | +| 0x2A | \#N/A | + +#### CellParsedFormula + +The **CellParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) stored in a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +[TABLE] + +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgRefN](#ptgrefn), [PtgAreaN](#ptgarean), or [PtgSxName](#ptgsxname). + +The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +**rgcb (variable):** An [RgbExtra](#rgbextra) that specifies ancillary data for the formula. + +#### Cetab + +The **Cetab** structure specifies a function that can be called from a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). The definition of each function specifies the function name and the valid sequence of arguments. + +[TABLE] + +**cetab (2 bytes):** An unsigned integer that specifies the function to be called. MUST be a value from the following table: + +The elements [ref](#rgce) and val are specified in Rgce. + +| Value | Meaning | +|----|----| +| 0x0000 | BEEP | +| | beep-params = \[val\] | +| 0x0001 | OPEN | +| | open-params = \*17(val) | +| 0x0002 | OPEN.LINKS | +| | open-links-params = \*15(val) | +| 0x0003 | CLOSE.ALL | +| | This function takes no parameters | +| 0x0004 | SAVE | +| | This function takes no parameters | +| 0x0005 | SAVE.AS | +| | save-as-params = \*7(val) | +| 0x0006 | FILE.DELETE | +| | file-delete-params = \[val\] | +| 0x0007 | PAGE.SETUP | +| | page-setup-params = \*30(val) | +| 0x0008 | PRINT | +| | print-params = \*17(val) | +| 0x0009 | PRINTER.SETUP | +| | printer-setup-params = \[val\] | +| 0x000A | QUIT | +| | This function takes no parameters | +| 0x000B | NEW.WINDOW | +| | This function takes no parameters | +| 0x000C | ARRANGE.ALL | +| | arrange-All-params = \*4(val) | +| 0x000D | WINDOW.SIZE | +| | window-size-params = \*3(val) | +| 0x000E | WINDOW.MOVE | +| | window-move-params = \*3(val) | +| 0x000F | FULL | +| | full-params = \[val\] | +| 0x0010 | CLOSE | +| | close-params = \*2(val) | +| 0x0011 | RUN | +| | run-params = \[(ref / val), \[val\]\] | +| 0x0016 | SET.PRINT.AREA | +| | set-print-area-params = \[ref / val\] | +| 0x0017 | SET.PRINT.TITLES | +| | set-print-titles-params = \*2(ref / val) | +| 0x0018 | SET.PAGE.BREAK | +| | This function takes no parameters | +| 0x0019 | REMOVE.PAGE.BREAK | +| | remove-page-break-params = \*2(val) | +| 0x001A | FONT | +| | font-params = \*2(val) | +| 0x001B | DISPLAY | +| | display-params = \*9(val) | +| 0x001C | PROTECT.DOCUMENT | +| | protect-document-params = \*7(val) | +| 0x001D | PRECISION | +| | precision-params = \[val\] | +| 0x001E | A1.R1C1 | +| | a1-r1c1-params = \[val\] | +| 0x001F | CALCULATE.NOW | +| | This function takes no parameters | +| 0x0020 | CALCULATION | +| | calculation-params = \*11(val) | +| 0x0022 | DATA.FIND | +| | data-find-params = \[val\] | +| 0x0023 | EXTRACT | +| | extract-params = \[val\] | +| 0x0024 | DATA.DELETE | +| | This function takes no parameters | +| 0x0025 | SET.DATABASE | +| | This function takes no parameters | +| 0x0026 | SET.CRITERIA | +| | This function takes no parameters | +| 0x0027 | SORT | +| | sort-params = \[val, \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \*10(val)\]\]\]\]\]\]\] | +| 0x0028 | DATA.SERIES | +| | data-series-params = \*6(val) | +| 0x0029 | TABLE | +| | table-params = \*2(ref / val) | +| 0x002A | FORMAT.NUMBER | +| | format-number-params = \[val\] | +| 0x002B | ALIGNMENT | +| | alignment-params = \*10(val) | +| 0x002C | STYLE | +| | style-params = \*2(val) | +| 0x002D | BORDER | +| | border-params = \*27(val) | +| 0x002E | CELL.PROTECTION | +| | [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461)-protection-params = \*2(val) | +| 0x002F | COLUMN.WIDTH | +| | column-width-params = \[val, \*4(ref / val)\] | +| 0x0030 | UNDO | +| | This function takes no parameters | +| 0x0031 | CUT | +| | cut-params = \*2(ref / val) | +| 0x0032 | COPY | +| | copy-params = \*2(ref / val) | +| 0x0033 | PASTE | +| | paste-params = \[ref / val\] | +| 0x0034 | CLEAR | +| | clear-params = \[val\] | +| 0x0035 | PASTE.SPECIAL | +| | paste-special-params = \*7(val) | +| 0x0036 | EDIT.DELETE | +| | edit-delete-params = \[val\] | +| 0x0037 | INSERT | +| | insert-params = \*2(val) | +| 0x0038 | FILL.RIGHT | +| | This function takes no parameters | +| 0x0039 | FILL.DOWN | +| | This function takes no parameters | +| 0x003D | DEFINE.NAME | +| | define-name-params = \[val, \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[val\]\]\]\]\]\]\] | +| 0x003E | CREATE.NAMES | +| | create-names-params = \*4(val) | +| 0x003F | FORMULA.GOTO | +| | formula-goto-params = \[(ref / val), \[val\]\] | +| 0x0040 | FORMULA.FIND | +| | formula-find-params = \*12(val) | +| 0x0041 | SELECT.LAST.CELL | +| | This function takes no parameters | +| 0x0042 | SHOW.ACTIVE.CELL | +| | This function takes no parameters | +| 0x0043 | GALLERY.AREA | +| | gAllery-area-params = \*2(val) | +| 0x0044 | GALLERY.BAR | +| | gAllery-bar-params = \*2(val) | +| 0x0045 | GALLERY.COLUMN | +| | gAllery-column-params = \*2(val) | +| 0x0046 | GALLERY.LINE | +| | gAllery-line-params = \*2(val) | +| 0x0047 | GALLERY.PIE | +| | gAllery-pie-params = \*2(val) | +| 0x0048 | GALLERY.SCATTER | +| | gAllery-scatter-params = \*2(val) | +| 0x0049 | COMBINATION | +| | combination-params = \[val\] | +| 0x004A | PREFERRED | +| | This function takes no parameters | +| 0x004B | ADD.OVERLAY | +| | This function takes no parameters | +| 0x004C | GRIDLINES | +| | gridlines-params = \*7(val) | +| 0x004D | SET.PREFERRED | +| | set-preferred-params = \[val\] | +| 0x004E | AXES | +| | axes-params = \*6(val) | +| 0x004F | LEGEND | +| | legend-params = \[val\] | +| 0x0050 | ATTACH.TEXT | +| | attach-text-params = \*3(val) | +| 0x0051 | ADD.ARROW | +| | This function takes no parameters | +| 0x0052 | SELECT.CHART | +| | This function takes no parameters | +| 0x0053 | SELECT.PLOT.AREA | +| | This function takes no parameters | +| 0x0054 | PATTERNS | +| | patterns-params = \*13(val) | +| 0x0055 | MAIN.CHART | +| | main-chart-params = \*10(val) | +| 0x0056 | OVERLAY | +| | overlay-params = \*12(val) | +| 0x0057 | SCALE | +| | scale-params = \*10(val) | +| 0x0058 | FORMAT.LEGEND | +| | format-legend-params = \[val\] | +| 0x0059 | FORMAT.TEXT | +| | format-text-params = \*11(val) | +| 0x005A | EDIT.REPEAT | +| | This function takes no parameters | +| 0x005B | PARSE | +| | parse-params = \[val, \[ref / val\]\] | +| 0x005C | JUSTIFY | +| | This function takes no parameters | +| 0x005D | HIDE | +| | This function takes no parameters | +| 0x005E | UNHIDE | +| | unhide-params = \[val\] | +| 0x005F | WORKSPACE | +| | workspace-params = \*16(val) | +| 0x0060 | FORMULA | +| | formula-params = \[val, \[ref / val\]\] | +| 0x0061 | FORMULA.FILL | +| | formula-fill-params = \[val, \[ref / val\]\] | +| 0x0062 | FORMULA.ARRAY | +| | formula-array-params = \[val, \[ref / val\]\] | +| 0x0063 | DATA.FIND.NEXT | +| | This function takes no parameters | +| 0x0064 | DATA.FIND.PREV | +| | This function takes no parameters | +| 0x0065 | FORMULA.FIND.NEXT | +| | This function takes no parameters | +| 0x0066 | FORMULA.FIND.PREV | +| | This function takes no parameters | +| 0x0067 | ACTIVATE | +| | activate-params = \*2(val) | +| 0x0068 | ACTIVATE.NEXT | +| | activate-next-params = \[val\] | +| 0x0069 | ACTIVATE.PREV | +| | activate-prev-params = \[val\] | +| 0x006A | UNLOCKED.NEXT | +| | This function takes no parameters | +| 0x006B | UNLOCKED.PREV | +| | This function takes no parameters | +| 0x006C | COPY.PICTURE | +| | copy-picture-params = \*3(val) | +| 0x006D | SELECT | +| | select-params = \*2(ref / val) | +| 0x006E | DELETE.NAME | +| | delete-name-params = \[val\] | +| 0x006F | DELETE.FORMAT | +| | delete-format-params = \[val\] | +| 0x0070 | VLINE | +| | vline-params = \[val\] | +| 0x0071 | HLINE | +| | hline-params = \[val\] | +| 0x0072 | VPAGE | +| | vpage-params = \[val\] | +| 0x0073 | HPAGE | +| | hpage-params = \[val\] | +| 0x0074 | VSCROLL | +| | vscroll-params = \*2(val) | +| 0x0075 | HSCROLL | +| | hscroll-params = \*2(val) | +| 0x0076 | ALERT | +| | alert-params = \*3(val) | +| 0x0077 | NEW | +| | new-params = \*3(val) | +| 0x0078 | CANCEL.COPY | +| | cancel-copy-params = \[val\] | +| 0x0079 | SHOW.CLIPBOARD | +| | This function takes no parameters | +| 0x007A | MESSAGE | +| | message-params = \*2(val) | +| 0x007C | PASTE.LINK | +| | This function takes no parameters | +| 0x007D | APP.ACTIVATE | +| | app-activate-params = \*2(val) | +| 0x007E | DELETE.ARROW | +| | This function takes no parameters | +| 0x007F | ROW.HEIGHT | +| | row-height-params = \[val, \*3(ref / val)\] | +| 0x0080 | FORMAT.MOVE | +| | format-move-params = \[val, \*2(ref / val)\] | +| 0x0081 | FORMAT.SIZE | +| | format-size-params = \[val, \*2(ref / val)\] | +| 0x0082 | FORMULA.REPLACE | +| | formula-replace-params = \*11(val) | +| 0x0083 | SEND.KEYS | +| | send-keys-params = \*2(val) | +| 0x0084 | SELECT.SPECIAL | +| | select-special-params = \*3(val) | +| 0x0085 | APPLY.NAMES | +| | apply-names-params = \*7(val) | +| 0x0086 | REPLACE.FONT | +| | replace-font-params = \*10(val) | +| 0x0087 | FREEZE.PANES | +| | freeze-panes-params = \*3(val) | +| 0x0088 | SHOW.INFO | +| | show-info-params = \[val\] | +| 0x0089 | SPLIT | +| | split-params = \*2(val) | +| 0x008A | ON.WINDOW | +| | on-window-params = \*2(val) | +| 0x008B | ON.DATA | +| | on-data-params = \*2(val) | +| 0x008C | DISABLE.INPUT | +| | disable-input-params = \[val\] | +| 0x008E | OUTLINE | +| | outline-params = \*4(val) | +| 0x008F | LIST.NAMES | +| | This function takes no parameters | +| 0x0090 | FILE.CLOSE | +| | file-close-params = \*2(val) | +| 0x0091 | SAVE.WORKBOOK | +| | save-[**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe)-params = \*6(val) | +| 0x0092 | DATA.FORM | +| | This function takes no parameters | +| 0x0093 | COPY.CHART | +| | copy-chart-params = \[val\] | +| 0x0094 | ON.TIME | +| | on-time-params = \*4(val) | +| 0x0095 | WAIT | +| | wait-params = \[val\] | +| 0x0096 | FORMAT.FONT | +| | format-font-params = \*15(val) | +| 0x0097 | FILL.UP | +| | This function takes no parameters | +| 0x0098 | FILL.LEFT | +| | This function takes no parameters | +| 0x0099 | DELETE.OVERLAY | +| | This function takes no parameters | +| 0x009B | SHORT.MENUS | +| | short-menus-params = \[val\] | +| 0x009F | SET.UPDATE.STATUS | +| | set-update-status-params = \*3(val) | +| 0x00A1 | COLOR.PALETTE | +| | color-palette-params = \[val\] | +| 0x00A2 | DELETE.STYLE | +| | delete-style-params = \[val\] | +| 0x00A3 | WINDOW.RESTORE | +| | window-restore-params = \[val\] | +| 0x00A4 | WINDOW.MAXIMIZE | +| | window-maximize-params = \[val\] | +| 0x00A6 | CHANGE.LINK | +| | change-link-params = \*3(val) | +| 0x00A7 | CALCULATE.DOCUMENT | +| | This function takes no parameters | +| 0x00A8 | ON.KEY | +| | on-key-params = \*2(val) | +| 0x00A9 | APP.RESTORE | +| | This function takes no parameters | +| 0x00AA | APP.MOVE | +| | app-move-params = \*2(val) | +| 0x00AB | APP.SIZE | +| | app-size-params = \*2(val) | +| 0x00AC | APP.MINIMIZE | +| | This function takes no parameters | +| 0x00AD | APP.MAXIMIZE | +| | This function takes no parameters | +| 0x00AE | BRING.TO.FRONT | +| | This function takes no parameters | +| 0x00AF | SEND.TO.BACK | +| | This function takes no parameters | +| 0x00B9 | MAIN.CHART.TYPE | +| | main-chart-type-params = \[val\] | +| 0x00BA | OVERLAY.CHART.TYPE | +| | overlay-chart-type-params = \[val\] | +| 0x00BB | SELECT.END | +| | select-end-params = \[val\] | +| 0x00BC | OPEN.MAIL | +| | open-mail-params = \*2(val) | +| 0x00BD | SEND.MAIL | +| | send-mail-params = \[(ref / val), \*2(val)\] | +| 0x00BE | STANDARD.FONT | +| | standard-font-params = \*9(val) | +| 0x00BF | CONSOLIDATE | +| | consolidate-params = \*5(val) | +| 0x00C0 | SORT.SPECIAL | +| | sort-special-params = \[val, \[val, \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \*6(val)\]\]\]\]\]\]\]\] | +| 0x00C1 | GALLERY.3D.AREA | +| | gAllery-3d-area-params = \[val\] | +| 0x00C2 | GALLERY.3D.COLUMN | +| | gAllery-3d-column-params = \[val\] | +| 0x00C3 | GALLERY.3D.LINE | +| | gAllery-3d-line-params = \[val\] | +| 0x00C4 | GALLERY.3D.PIE | +| | gAllery-3d-pie-params = \[val\] | +| 0x00C5 | VIEW.3D | +| | view-3d-params = \*6(val) | +| 0x00C6 | GOAL.SEEK | +| | goal-seek-params = \*3(ref / val) | +| 0x00C7 | WORKGROUP | +| | workgroup-params = \[val\] | +| 0x00C8 | FILL.GROUP | +| | fill-group-params = \[val\] | +| 0x00C9 | UPDATE.LINK | +| | update-link-params = \*2(val) | +| 0x00CA | PROMOTE | +| | promote-params = \[val\] | +| 0x00CB | DEMOTE | +| | demote-params = \[val\] | +| 0x00CC | SHOW.DETAIL | +| | show-detail-params = \*4(val) | +| 0x00CE | UNGROUP | +| | This function takes no parameters | +| 0x00CF | OBJECT.PROPERTIES | +| | object-properties-params = \*2(val) | +| 0x00D0 | SAVE.NEW.OBJECT | +| | save-new-object-params = \[val\] | +| 0x00D1 | SHARE | +| | This function takes no parameters | +| 0x00D2 | SHARE.NAME | +| | share-name-params = \[val\] | +| 0x00D3 | DUPLICATE | +| | This function takes no parameters | +| 0x00D4 | APPLY.STYLE | +| | apply-style-params = \[val\] | +| 0x00D5 | ASSIGN.TO.OBJECT | +| | assign-to-object-params = \[ref / val\] | +| 0x00D6 | OBJECT.PROTECTION | +| | object-protection-params = \*2(val) | +| 0x00D7 | HIDE.OBJECT | +| | hide-object-params = \*2(val) | +| 0x00D8 | SET.EXTRACT | +| | This function takes no parameters | +| 0x00D9 | CREATE.PUBLISHER | +| | create-publisher-params = \*4(val) | +| 0x00DA | SUBSCRIBE.TO | +| | subscribe-to-params = \*2(val) | +| 0x00DB | ATTRIBUTES | +| | attributes-params = \*2(val) | +| 0x00DC | SHOW.TOOLBAR | +| | show-toolbar-params = \*10(val) | +| 0x00DE | PRINT.PREVIEW | +| | print-preview-params = \[val\] | +| 0x00DF | EDIT.COLOR | +| | edit-color-params = \*4(val) | +| 0x00E0 | SHOW.LEVELS | +| | show-levels-params = \*2(val) | +| 0x00E1 | FORMAT.MAIN | +| | format-main-params = \*14(val) | +| 0x00E2 | FORMAT.OVERLAY | +| | format-overlay-params = \*14(val) | +| 0x00E3 | ON.RECALC | +| | on-recalc-params = \*2(val) | +| 0x00E4 | EDIT.SERIES | +| | edit-series-params = \[val, \*6(ref / val)\] | +| 0x00E5 | DEFINE.STYLE | +| | define-style-params = \*14(val) | +| 0x00F0 | LINE.PRINT | +| | line-print-params = \*11(val) | +| 0x00F3 | ENTER.DATA | +| | enter-data-params = \[ref / val\] | +| 0x00F9 | GALLERY.RADAR | +| | gAllery-radar-params = \*2(val) | +| 0x00FA | MERGE.STYLES | +| | merge-styles-params = \[val\] | +| 0x00FB | EDITION.OPTIONS | +| | edition-options-params = \[val, \*6(ref / val)\] | +| 0x00FC | PASTE.PICTURE | +| | This function takes no parameters | +| 0x00FD | PASTE.PICTURE.LINK | +| | This function takes no parameters | +| 0x00FE | SPELLING | +| | spelling-params = \*6(val) | +| 0x0100 | ZOOM | +| | zoom-params = \[val\] | +| 0x0103 | INSERT.OBJECT | +| | insert-object-params = \[val, \[val, \[val, \[val, \[val, \[val, \[val, \[(ref / val), \[val, \[val, \[(ref / val), \*2(val)\]\]\]\]\]\]\]\]\]\]\] | +| 0x0104 | WINDOW.MINIMIZE | +| | window-minimize-params = \[val\] | +| 0x0109 | SOUND.NOTE | +| | sound-note-params = \[(ref / val), \*2(val)\] | +| 0x010A | SOUND.PLAY | +| | sound-play-params = \[(ref / val), \*2(val)\] | +| 0x010B | FORMAT.SHAPE | +| | format-shape-params = \[val, \[val, \[(ref / val), \*2(val)\]\]\] | +| 0x010C | EXTEND.POLYGON | +| | extend-polygon-params = \[val\] | +| 0x010D | FORMAT.AUTO | +| | format-auto-params = \*7(val) | +| 0x0110 | GALLERY.3D.BAR | +| | gAllery-3d-bar-params = \[val\] | +| 0x0111 | GALLERY.3D.SURFACE | +| | gAllery-3d-surface-params = \[val\] | +| 0x0112 | FILL.AUTO | +| | fill-auto-params = \[(ref / val), \[val\]\] | +| 0x0114 | CUSTOMIZE.TOOLBAR | +| | customize-toolbar-params = \[val\] | +| 0x0115 | ADD.TOOL | +| | add-tool-params = \*3(val) | +| 0x0116 | EDIT.OBJECT | +| | edit-object-params = \[val\] | +| 0x0117 | ON.DOUBLECLICK | +| | on-doubleclick-params = \*2(val) | +| 0x0118 | ON.ENTRY | +| | on-entry-params = \*2(val) | +| 0x0119 | WORKBOOK.ADD | +| | workbook-add-params = \*3(val) | +| 0x011A | WORKBOOK.MOVE | +| | workbook-move-params = \*3(val) | +| 0x011B | WORKBOOK.COPY | +| | workbook-copy-params = \*3(val) | +| 0x011C | WORKBOOK.OPTIONS | +| | workbook-options-params = \*3(val) | +| 0x011D | SAVE.WORKSPACE | +| | save-workspace-params = \[val\] | +| 0x0120 | CHART.WIZARD | +| | chart-wizard-params = \[val, \[(ref / val), \*12(val)\]\] | +| 0x0121 | DELETE.TOOL | +| | delete-tool-params = \*2(val) | +| 0x0122 | MOVE.TOOL | +| | move-tool-params = \*6(val) | +| 0x0123 | WORKBOOK.SELECT | +| | workbook-select-params = \*3(val) | +| 0x0124 | WORKBOOK.ACTIVATE | +| | workbook-activate-params = \*2(val) | +| 0x0125 | ASSIGN.TO.TOOL | +| | assign-to-tool-params = \[val, \[val, \[ref / val\]\]\] | +| 0x0127 | COPY.TOOL | +| | copy-tool-params = \*2(val) | +| 0x0128 | RESET.TOOL | +| | reset-tool-params = \*2(val) | +| 0x0129 | CONSTRAIN.NUMERIC | +| | constrain-numeric-params = \[val\] | +| 0x012A | PASTE.TOOL | +| | paste-tool-params = \*2(val) | +| 0x012E | WORKBOOK.NEW | +| | workbook-new-params = \*3(val) | +| 0x0131 | SCENARIO.CELLS | +| | scenario-cells-params = \[ref / val\] | +| 0x0132 | SCENARIO.DELETE | +| | scenario-delete-params = \[val\] | +| 0x0133 | SCENARIO.ADD | +| | scenario-add-params = \[val, \[val, \[(ref / val), \*3(val)\]\]\] | +| 0x0134 | SCENARIO.EDIT | +| | scenario-edit-params = \[val, \[val, \[val, \[(ref / val), \*3(val)\]\]\]\] | +| 0x0135 | SCENARIO.SHOW | +| | scenario-show-params = \[val\] | +| 0x0136 | SCENARIO.SHOW.NEXT | +| | This function takes no parameters | +| 0x0137 | SCENARIO.SUMMARY | +| | scenario-summary-params = \[(ref / val), \[val\]\] | +| 0x0138 | PIVOT.TABLE.WIZARD | +| | pivot-table-wizard-params = \[val, \[(ref / val), \[(ref / val), \*13(val)\]\]\] | +| 0x0139 | PIVOT.FIELD.PROPERTIES | +| | pivot-field-properties-params = \*7(val) | +| 0x013A | PIVOT.FIELD | +| | pivot-field-params = \*4(val) | +| 0x013B | PIVOT.ITEM | +| | pivot-item-params = \*4(val) | +| 0x013C | PIVOT.ADD.FIELDS | +| | pivot-add-fields-params = \*5(val) | +| 0x013E | OPTIONS.CALCULATION | +| | options-calculation-params = \*10(val) | +| 0x013F | OPTIONS.EDIT | +| | options-edit-params = \*11(val) | +| 0x0140 | OPTIONS.VIEW | +| | options-view-params = \*18(val) | +| 0x0141 | ADDIN.MANAGER | +| | addin-manager-params = \*3(val) | +| 0x0142 | MENU.EDITOR | +| | This function takes no parameters | +| 0x0143 | ATTACH.TOOLBARS | +| | This function takes no parameters | +| 0x0144 | VBAActivate | +| | vbaactivate-params = \*2(val) | +| 0x0145 | OPTIONS.CHART | +| | options-chart-params = \*3(val) | +| 0x0148 | VBA.INSERT.FILE | +| | vba-insert-file-params = \[val\] | +| 0x014A | VBA.PROCEDURE.DEFINITION | +| | This function takes no parameters | +| 0x0150 | ROUTING.SLIP | +| | routing-slip-params = \[(ref / val), \*5(val)\] | +| 0x0152 | ROUTE.DOCUMENT | +| | This function takes no parameters | +| 0x0153 | MAIL.LOGON | +| | mail-logon-params = \[(ref / val), \[(ref / val), \[val\]\]\] | +| 0x0156 | INSERT.PICTURE | +| | insert-picture-params = \*2(val) | +| 0x0157 | EDIT.TOOL | +| | edit-tool-params = \*2(val) | +| 0x0158 | GALLERY.DOUGHNUT | +| | gAllery-doughnut-params = \*2(val) | +| 0x015E | CHART.TREND | +| | chart-trend-params = \*8(val) | +| 0x0160 | PIVOT.ITEM.PROPERTIES | +| | pivot-item-properties-params = \*7(val) | +| 0x0162 | WORKBOOK.INSERT | +| | workbook-insert-params = \[val\] | +| 0x0163 | OPTIONS.TRANSITION | +| | options-transition-params = \*5(val) | +| 0x0164 | OPTIONS.GENERAL | +| | options-general-params = \*14(val) | +| 0x0172 | FILTER.ADVANCED | +| | filter-advanced-params = \[val, \[(ref / val), \[(ref / val), \[(ref / val), \[val\]\]\]\]\] | +| 0x0175 | MAIL.ADD.MAILER | +| | This function takes no parameters | +| 0x0176 | MAIL.DELETE.MAILER | +| | This function takes no parameters | +| 0x0177 | MAIL.REPLY | +| | This function takes no parameters | +| 0x0178 | MAIL.REPLY.ALL | +| | This function takes no parameters | +| 0x0179 | MAIL.FORWARD | +| | This function takes no parameters | +| 0x017A | MAIL.NEXT.LETTER | +| | This function takes no parameters | +| 0x017B | DATA.LABEL | +| | data-label-params = \*10(val) | +| 0x017C | INSERT.TITLE | +| | insert-title-params = \*5(val) | +| 0x017D | FONT.PROPERTIES | +| | font-properties-params = \*14(val) | +| 0x017E | MACRO.OPTIONS | +| | macro-options-params = \*10(val) | +| 0x017F | WORKBOOK.HIDE | +| | workbook-hide-params = \*2(val) | +| 0x0180 | WORKBOOK.UNHIDE | +| | workbook-unhide-params = \[val\] | +| 0x0181 | WORKBOOK.DELETE | +| | workbook-delete-params = \[val\] | +| 0x0182 | WORKBOOK.NAME | +| | workbook-name-params = \*2(val) | +| 0x0184 | GALLERY.CUSTOM | +| | gAllery-custom-params = \[val\] | +| 0x0186 | ADD.CHART.AUTOFORMAT | +| | add-chart-autoformat-params = \*2(val) | +| 0x0187 | DELETE.CHART.AUTOFORMAT | +| | delete-chart-autoformat-params = \[val\] | +| 0x0188 | CHART.ADD.DATA | +| | chart-add-data-params = \[val, \[(ref / val), \*4(val)\]\] | +| 0x0189 | AUTO.OUTLINE | +| | This function takes no parameters | +| 0x018A | TAB.ORDER | +| | This function takes no parameters | +| 0x018B | SHOW.DIALOG | +| | show-dialog-params = \[val\] | +| 0x018C | SELECT.ALL | +| | This function takes no parameters | +| 0x018D | UNGROUP.SHEETS | +| | This function takes no parameters | +| 0x018E | SUBTOTAL.CREATE | +| | subtotal-create-params = \*6(val) | +| 0x018F | SUBTOTAL.REMOVE | +| | This function takes no parameters | +| 0x0190 | RENAME.OBJECT | +| | rename-object-params = \[val\] | +| 0x019C | WORKBOOK.SCROLL | +| | workbook-scroll-params = \*2(val) | +| 0x019D | WORKBOOK.NEXT | +| | This function takes no parameters | +| 0x019E | WORKBOOK.PREV | +| | This function takes no parameters | +| 0x019F | WORKBOOK.TAB.SPLIT | +| | workbook-tab-split-params = \[val\] | +| 0x01A0 | FULL.SCREEN | +| | full-screen-params = \[val\] | +| 0x01A1 | WORKBOOK.PROTECT | +| | workbook-protect-params = \*3(val) | +| 0x01A4 | SCROLLBAR.PROPERTIES | +| | scrollbar-properties-params = \*7(val) | +| 0x01A5 | PIVOT.SHOW.PAGES | +| | pivot-show-pages-params = \*2(val) | +| 0x01A6 | TEXT.TO.COLUMNS | +| | text-to-columns-params = \[val, \[(ref / val), \*12(val)\]\] | +| 0x01A7 | FORMAT.CHARTTYPE | +| | format-charttype-params = \*4(val) | +| 0x01A8 | LINK.FORMAT | +| | This function takes no parameters | +| 0x01A9 | TRACER.DISPLAY | +| | tracer-display-params = \*2(val) | +| 0x01AE | TRACER.NAVIGATE | +| | tracer-navigate-params = \*3(val) | +| 0x01AF | TRACER.CLEAR | +| | This function takes no parameters | +| 0x01B0 | TRACER.ERROR | +| | This function takes no parameters | +| 0x01B1 | PIVOT.FIELD.GROUP | +| | pivot-field-group-params = \*4(val) | +| 0x01B2 | PIVOT.FIELD.UNGROUP | +| | This function takes no parameters | +| 0x01B3 | CHECKBOX.PROPERTIES | +| | checkbox-properties-params = \*5(val) | +| 0x01B4 | LABEL.PROPERTIES | +| | label-properties-params = \*3(val) | +| 0x01B5 | LISTBOX.PROPERTIES | +| | listbox-properties-params = \*5(val) | +| 0x01B6 | EDITBOX.PROPERTIES | +| | editbox-properties-params = \*4(val) | +| 0x01B7 | PIVOT.REFRESH | +| | pivot-refresh-params = \[val\] | +| 0x01B8 | LINK.COMBO | +| | link-combo-params = \[val\] | +| 0x01B9 | OPEN.TEXT | +| | open-text-params = \*17(val) | +| 0x01BA | HIDE.DIALOG | +| | hide-dialog-params = \[val\] | +| 0x01BB | SET.DIALOG.FOCUS | +| | set-dialog-focus-params = \[val\] | +| 0x01BC | ENABLE.OBJECT | +| | enable-object-params = \*2(val) | +| 0x01BD | PUSHBUTTON.PROPERTIES | +| | pushbutton-properties-params = \*6(val) | +| 0x01BE | SET.DIALOG.DEFAULT | +| | set-dialog-default-params = \[val\] | +| 0x01BF | FILTER | +| | filter-params = \*6(val) | +| 0x01C0 | FILTER.SHOW.ALL | +| | This function takes no parameters | +| 0x01C1 | CLEAR.OUTLINE | +| | This function takes no parameters | +| 0x01C2 | FUNCTION.WIZARD | +| | function-wizard-params = \[val\] | +| 0x01C3 | ADD.LIST.ITEM | +| | add-list-item-params = \*2(val) | +| 0x01C4 | SET.LIST.ITEM | +| | set-list-item-params = \*2(val) | +| 0x01C5 | REMOVE.LIST.ITEM | +| | remove-list-item-params = \*2(val) | +| 0x01C6 | SELECT.LIST.ITEM | +| | select-list-item-params = \*2(val) | +| 0x01C7 | SET.CONTROL.VALUE | +| | set-control-value-params = \[val\] | +| 0x01C8 | SAVE.COPY.AS | +| | save-copy-as-params = \[val\] | +| 0x01CA | OPTIONS.LISTS.ADD | +| | options-lists-add-params = \[val, \[ref / val\]\] | +| 0x01CB | OPTIONS.LISTS.DELETE | +| | options-lists-delete-params = \[val\] | +| 0x01CC | SERIES.AXES | +| | series-axes-params = \[val\] | +| 0x01CD | SERIES.X | +| | series-x-params = \[ref / val\] | +| 0x01CE | SERIES.Y | +| | series-y-params = \*2(ref / val) | +| 0x01CF | ERRORBAR.X | +| | errorbar-x-params = \[val, \[val, \[val, \[ref / val\]\]\]\] | +| 0x01D0 | ERRORBAR.Y | +| | errorbar-y-params = \[val, \[val, \[val, \[ref / val\]\]\]\] | +| 0x01D1 | FORMAT.CHART | +| | format-chart-params = \[(ref / val), \*17(val)\] | +| 0x01D2 | SERIES.ORDER | +| | series-order-params = \*3(val) | +| 0x01D3 | MAIL.LOGOFF | +| | This function takes no parameters | +| 0x01D4 | CLEAR.ROUTING.SLIP | +| | clear-routing-slip-params = \[val\] | +| 0x01D5 | APP.ACTIVATE.MICROSOFT | +| | app-activate-microsoft-params = \[val\] | +| 0x01D6 | MAIL.EDIT.MAILER | +| | mail-edit-mailer-params = \[val, \[(ref / val), \[(ref / val), \[(ref / val), \[val, \[ref / val\]\]\]\]\]\] | +| 0x01D7 | ON.SHEET | +| | on-sheet-params = \*3(val) | +| 0x01D8 | STANDARD.WIDTH | +| | standard-width-params = \[val\] | +| 0x01D9 | SCENARIO.MERGE | +| | scenario-merge-params = \[val\] | +| 0x01DA | SUMMARY.INFO | +| | summary-info-params = \*5(val) | +| 0x01DB | FIND.FILE | +| | This function takes no parameters | +| 0x01DC | ACTIVE.CELL.FONT | +| | active-cell-font-params = \*14(val) | +| 0x01DD | ENABLE.TIPWIZARD | +| | enable-tipwizard-params = \[val\] | +| 0x01DE | VBA.MAKE.ADDIN | +| | vba-make-addin-params = \[val\] | +| 0x01E0 | INSERTDATATABLE | +| | insertdatatable-params = \[val\] | +| 0x01E1 | WORKGROUP.OPTIONS | +| | This function takes no parameters | +| 0x01E2 | MAIL.SEND.MAILER | +| | mail-send-mailer-params = \*2(val) | +| 0x01E5 | AUTOCORRECT | +| | autocorrect-params = \*2(val) | +| 0x01E9 | POST.DOCUMENT | +| | post-document-params = \[val\] | +| 0x01EB | PICKLIST | +| | This function takes no parameters | +| 0x01ED | VIEW.SHOW | +| | view-show-params = \[val\] | +| 0x01EE | VIEW.DEFINE | +| | view-define-params = \*3(val) | +| 0x01EF | VIEW.DELETE | +| | view-delete-params = \[val\] | +| 0x01FD | SHEET.BACKGROUND | +| | sheet-background-params = \*2(val) | +| 0x01FE | INSERT.MAP.OBJECT | +| | This function takes no parameters | +| 0x01FF | OPTIONS.MENONO | +| | options-menono-params = \*5(val) | +| 0x0205 | MSOCHECKS | +| | This function takes no parameters | +| 0x0206 | NORMAL | +| | This function takes no parameters | +| 0x0207 | LAYOUT | +| | This function takes no parameters | +| 0x0208 | RM.PRINT.AREA | +| | rm-print-area-params = \[ref / val\] | +| 0x0209 | CLEAR.PRINT.AREA | +| | This function takes no parameters | +| 0x020A | ADD.PRINT.AREA | +| | This function takes no parameters | +| 0x020B | MOVE.BRK | +| | move-brk-params = \*4(val) | +| 0x0221 | HIDECURR.NOTE | +| | hidecurr-note-params = \[(ref / val), \[val\]\] | +| 0x0222 | HIDEALL.NOTES | +| | hideall-notes-params = \[val\] | +| 0x0223 | DELETE.NOTE | +| | delete-note-params = \[ref / val\] | +| 0x0224 | TRAVERSE.NOTES | +| | traverse-notes-params = \[(ref / val), \[val\]\] | +| 0x0225 | ACTIVATE.NOTES | +| | activate-notes-params = \[(ref / val), \[val\]\] | +| 0x026C | PROTECT.REVISIONS | +| | This function takes no parameters | +| 0x026D | UNPROTECT.REVISIONS | +| | This function takes no parameters | +| 0x0287 | OPTIONS.ME | +| | options-me-params = \[(ref / val), \*8(val)\] | +| 0x028D | WEB.PUBLISH | +| | web-publish-params = \*9(val) | +| 0x029B | NEWWEBQUERY | +| | newwebquery-params = \[val\] | +| 0x02A1 | PIVOT.TABLE.CHART | +| | pivot-table-chart-params = \[val, \[(ref / val), \[(ref / val), \*13(val)\]\]\] | +| 0x02F1 | OPTIONS.SAVE | +| | options-save-params = \*4(val) | +| 0x02F3 | OPTIONS.SPELL | +| | options-spell-params = \*12(val) | +| 0x0328 | HIDEALL.INKANNOTS | +| | hideall-inkannots-params = \[val\] | + +The following grammar is used in the Rgce structure definition: + +params-cetab = beep-params / open-params / open-links-params / save-as-params / + +file-delete-params / page-setup-params / print-params / + +printer-setup-params / + +arrange-all-params / window-size-params / window-move-params / + +full-params / close-params / run-params / + +set-print-area-params / set-print-titles-params / + +remove-page-break-params / font-params / display-params / + +protect-document-params / precision-params / a1-r1c1-params / calculation-params / data-find-params / + +extract-params / sort-params / data-series-params / + +table-params / format-number-params / alignment-params / + +style-params / border-params / cell-protection-params / + +column-width-params / cut-params / + +copy-params / paste-params / clear-params / + +paste-special-params / edit-delete-params / insert-params / define-name-params / + +create-names-params / formula-goto-params / formula-find-params / gallery-area-params / + +gallery-bar-params / gallery-column-params / gallery-line-params / + +gallery-pie-params / gallery-scatter-params / combination-params / gridlines-params / + +set-preferred-params / axes-params / legend-params / + +attach-text-params / patterns-params / main-chart-params / + +overlay-params / scale-params / format-legend-params / + +format-text-params / parse-params / unhide-params / + +workspace-params / formula-params / formula-fill-params / + +formula-array-params / activate-params / + +activate-next-params / activate-prev-params / copy-picture-params / select-params / + +delete-name-params / delete-format-params / vline-params / + +hline-params / vpage-params / hpage-params / + +vscroll-params / hscroll-params / alert-params / + +new-params / cancel-copy-params / + +message-params / app-activate-params / row-height-params / format-move-params / + +format-size-params / formula-replace-params / send-keys-params / + +select-special-params / apply-names-params / replace-font-params / + +freeze-panes-params / show-info-params / split-params / + +on-window-params / on-data-params / disable-input-params / + +outline-params / file-close-params / + +save-workbook-params / copy-chart-params / + +on-time-params / wait-params / format-font-params / + +short-menus-params / set-update-status-params / color-palette-params / + +delete-style-params / window-restore-params / window-maximize-params / + +change-link-params / on-key-params / app-move-params / app-size-params / main-chart-type-params / overlay-chart-type-params / + +select-end-params / open-mail-params / send-mail-params / + +standard-font-params / consolidate-params / sort-special-params / + +gAllery-3d-area-params / gAllery-3d-column-params / gAllery-3d-line-params / + +gallery-3d-pie-params / view-3d-params / goal-seek-params / + +workgroup-params / fill-group-params / update-link-params / + +promote-params / demote-params / show-detail-params / object-properties-params / save-new-object-params / share-name-params / + +apply-style-params / assign-to-object-params / object-protection-params / + +hide-object-params / create-publisher-params / + +subscribe-to-params / attributes-params / show-toolbar-params / + +print-preview-params / edit-color-params / show-levels-params / + +format-main-params / format-overlay-params / on-recalc-params / + +edit-series-params / define-style-params / line-print-params / + +enter-data-params / gallery-radar-params / merge-styles-params / + +edition-options-params / + +spelling-params / zoom-params / insert-object-params / + +window-minimize-params / + +sound-note-params / sound-play-params / format-shape-params / + +extend-polygon-params / format-auto-params / gallery-3d-bar-params / + +gallery-3d-surface-params / fill-auto-params / customize-toolbar-params / + +add-tool-params / edit-object-params / on-doubleclick-params / + +on-entry-params / workbook-add-params / workbook-move-params / + +workbook-copy-params / workbook-options-params / save-workspace-params / + +chart-wizard-params / delete-tool-params / move-tool-params / + +workbook-select-params / workbook-activate-params / assign-to-tool-params / + +copy-tool-params / reset-tool-params / constrain-numeric-params / + +paste-tool-params / placement-params / + +workbook-new-params / scenario-cells-params / scenario-delete-params / + +scenario-add-params / scenario-edit-params / scenario-show-params / scenario-summary-params / pivot-table-wizard-params / + +pivot-field-properties-params / pivot-field-params / pivot-item-params / + +pivot-add-fields-params / options-calculation-params / options-edit-params / + +options-view-params / addin-manager-params / vbaactivate-params / options-chart-params / + +vba-insert-file-params / routing-slip-params / mail-logon-params / insert-picture-params / + +edit-tool-params / gallery-doughnut-params / chart-trend-params / + +pivot-item-properties-params / workbook-insert-params / options-transition-params / + +options-general-params / filter-advanced-params / data-label-params / + +insert-title-params / font-properties-params / macro-options-params / + +workbook-hide-params / workbook-unhide-params / workbook-delete-params / + +workbook-name-params / gAllery-custom-params / add-chart-autoformat-params / + +delete-chart-autoformat-params / chart-add-data-params / show-dialog-params / subtotal-create-params / + +rename-object-params / workbook-scroll-params / workbook-tab-split-params / full-screen-params / + +workbook-protect-params / scrollbar-properties-params / pivot-show-pages-params / + +text-to-columns-params / format-charttype-params / + +tracer-display-params / tracer-navigate-params / pivot-field-group-params / + +checkbox-properties-params / label-properties-params / listbox-properties-params / + +editbox-properties-params / pivot-refresh-params / link-combo-params / + +open-text-params / hide-dialog-params / set-dialog-focus-params / + +enable-object-params / pushbutton-properties-params / set-dialog-default-params / + +filter-params / + +function-wizard-params / add-list-item-params / set-list-item-params / + +remove-list-item-params / select-list-item-params / set-control-value-params / + +save-copy-as-params / options-lists-add-params / options-lists-delete-params / + +series-axes-params / series-x-params / series-y-params / + +errorbar-x-params / errorbar-y-params / format-chart-params / + +series-order-params / clear-routing-slip-params / + +app-activate-microsoft-params / mail-edit-mailer-params / on-sheet-params / + +standard-width-params / scenario-merge-params / summary-info-params / active-cell-font-params / enable-tipwizard-params / + +vba-make-addin-params / insertdatatable-params / + +mail-send-mailer-params / autocorrect-params / post-document-params / view-show-params / view-define-params / + +view-delete-params / sheet-background-params / + +options-menono-params / rm-print-area-params / move-brk-params / hidecurr-note-params / + +hideall-notes-params / delete-note-params / traverse-notes-params / + +activate-notes-params / + +options-me-params / web-publish-params / newwebquery-params / + +pivot-table-chart-params / options-save-params / options-spell-params / + +hideall-inkannots-params + +#### CFParsedFormula + +The **CFParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule. + +[TABLE] + +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg) structures for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), [PtgSxName](#ptgsxname), [PtgIsect](#ptgisect), [PtgUnion](#ptgunion), [PtgArray](#ptgarray), [PtgRef3d](#ptgref3d), [PtgArea3d](#ptgarea3d), [PtgRefErr3d](#ptgreferr3d), [PtgAreaErr3d](#ptgareaerr3d), [PtgNameX](#ptgnamex), [PtgMemArea](#ptgmemarea), or [PtgMemNoMem](#ptgmemnomem). A [PtgArea](#ptgarea) or a [PtgAreaN](#ptgarean) MUST NOT be the only Ptg structure in the sequence. + +The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +#### CFParsedFormulaNoCCE + +The **CFParsedFormulaNoCCE** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule, in a [CF](#cf) or [CF12](#cf12) record in which the size of the formula in bytes is specified. + +[TABLE] + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), [PtgSxName](#ptgsxname), [PtgIsect](#ptgisect), [PtgUnion](#ptgunion), [PtgArray](#ptgarray), [PtgRef3d](#ptgref3d), [PtgArea3d](#ptgarea3d), [PtgRefErr3d](#ptgreferr3d), [PtgAreaErr3d](#ptgareaerr3d), [PtgNameX](#ptgnamex), [PtgMemArea](#ptgmemarea), or [PtgMemNoMem](#ptgmemnomem). A [PtgArea](#ptgarea) or a [PtgAreaN](#ptgarean) MUST NOT be the only Ptg in the sequence. + +The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +#### CFVOParsedFormula + +The **CFVOParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) without [**relative references**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) that is used in a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule. + +[TABLE] + +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), [PtgSxName](#ptgsxname), [PtgIsect](#ptgisect), [PtgUnion](#ptgunion), [PtgArray](#ptgarray), [PtgRef3d](#ptgref3d), [PtgArea3d](#ptgarea3d), [PtgRefErr3d](#ptgreferr3d), [PtgAreaErr3d](#ptgareaerr3d), [PtgNameX](#ptgnamex), [PtgMemArea](#ptgmemarea), or [PtgMemNoMem](#ptgmemnomem). A [PtgArea](#ptgarea) or a [PtgAreaN](#ptgarean) MUST NOT be the only Ptg in the sequence. + +If this field contains a [PtgRef](#ptgref), then the **loc.column.colRelative** and **loc.column.rowRelative** fields in the PtgRef MUST be 0. + +If this field contains a [PtgRefN](#ptgrefn), then the **loc.column.colRelative** and **loc.column.rowRelative** fields in the PtgRefN MUST be 0. + +If this field contains a PtgArea, then the **area.columnFirst.colRelative**, **area.columnFirst.rowRelative**, **area.columnLast.colRelative**, and **area.columnLast.rowRelative** fields in the PtgArea MUST be 0**.** + +If this field contains a PtgAreaN, then the **area.columnFirst.colRelative**, **area.columnFirst.rowRelative**, **area.columnLast.colRelative**, and **area.columnLast.rowRelative** fields in the PtgAreaN MUST be 0. + +The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +#### ChartParsedFormula + +The **ChartParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a chart. + +[TABLE] + +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST contain only the following Ptgs: [PtgParen](#ptgparen), [PtgUnion](#ptgunion), [PtgRef3d](#ptgref3d), [PtgRefErr3d](#ptgreferr3d), [PtgArea3d](#ptgarea3d), [PtgAreaErr3d](#ptgareaerr3d), [PtgNameX](#ptgnamex), or [PtgMemFunc](#ptgmemfunc). + +#### DVParsedFormula + +The **DVParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) rule. + +[TABLE] + +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. + +**unused (2 bytes):** Undefined and MUST be ignored. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), [PtgSxName](#ptgsxname), [PtgIsect](#ptgisect), [PtgUnion](#ptgunion), [PtgArray](#ptgarray), [PtgRef3d](#ptgref3d), [PtgRefErr3d](#ptgreferr3d), [PtgNameX](#ptgnamex), [PtgMemArea](#ptgmemarea), or [PtgMemNoMem](#ptgmemnomem). + +If the [Dv](#dv) record that contains this **DVParsedFormula** in its Dv.**formula1** field has a Dv.**valType** not equal to 3, then the following MUST be true: + +- **rgce** MUST NOT contain a [PtgArea3d](#ptgarea3d) or a [PtgAreaErr3d](#ptgareaerr3d). + +- A [PtgArea](#ptgarea), a [PtgAreaErr](#ptgareaerr), or a [PtgAreaN](#ptgarean), MUST NOT be the only Ptg in **rgce**. + +- The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +If the Dv record that contains this **DVParsedFormula** in its Dv.**formula1** field has a Dv.**valType** equal to 3, then the following MUST be true: + +- If **rgce** contains a PtgArea3d or a PtgAreaErr3d then the PtgArea3d or PtgAreaErr3d MUST be the only Ptg in **rgce**. + +- The root node of the parse tree of this field MUST NOT be a VALUE_TYPE, as described in Rgce. + +If this **DVParsedFormula** is in Dv.**formula2** field, then the following MUST be true: + +- **rgce** MUST NOT contain a PtgArea3d or a PtgAreaErr3d. + +- A PtgArea, a PtgAreaErr, or a PtgAreaN, MUST NOT be the only Ptg in **rgce**. + +- The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +#### ExtNameParsedFormula + +The **ExtNameParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2). + +[TABLE] + +**cb (2 bytes):** An unsigned integer that specifies the number of bytes in **extPtg** + the number of bytes in **val**. If the [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) that this external defined name specifies does not exist in its containing [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), this value MUST be 0, and **extPtg** and **val** MUST NOT exist. + +**extPtg (1 byte):** An unsigned integer that specifies the formula type of **val**. This field MUST exist if and only if **cb** is greater than 0. MUST be one of the values as specified in the table in the **val** field section. + +**val (variable):** An optional field that specifies the formula of an external defined name. If the formula cannot be represented correctly with one formula types allowed in this field, then this field MUST specify an [ExtPtgErr](#extptgerr) formula. This field MUST exist if and only if **cb** is greater than 0. The size and the type of the formula vary based on the value of **extPtg** as follows: + +| extPtg value | Val field Data and Meaning | +|--------------|-----------------------------------------------------------| +| 0x3A | Specifies an [ExtPtgRef3D](#extptgref3d) formula. | +| 0x3B | Specifies an [ExtPtgArea3D](#extptgarea3d) formula. | +| 0x3C | Specifies an [ExtPtgRefErr3D](#extptgreferr3d) formula. | +| 0x3D | Specifies an [ExtPtgAreaErr3D](#extptgareaerr3d) formula. | +| 0x1C | Specifies an ExtPtgErr formula. | + +#### ExtPtgArea3D + +The **ExtPtgArea3D** structure is a variation of [PtgArea3d](#ptgarea3d) that is used by formulas in an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2). It specifies a rectangular [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) range on one or more [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**iTabs (4 bytes):** An [ExtSheetPair](#extsheetpair) that specifies the sheet or sheets containing the range. + +**area (8 bytes):** A [RgceAreaRel](#rgcearearel) that specifies the location of the range of cells within a sheet. + +#### ExtPtgAreaErr3D + +The **ExtPtgAreaErr3D** structure is a variation of [PtgAreaErr3d](#ptgareaerr3d) that is used by formulas in an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2). It specifies an invalid reference to a regular range of cells on one or more [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**iTabs (4 bytes):** An [ExtSheetPair](#extsheetpair) that specifies the sheet or sheets containing the target of this reference. + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +#### ExtPtgErr + +The **ExtPtgErr** structure is a variation of [PtgErr](#ptgerr) that is used by formulas in an external defined name. It specifies an invalid [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) reference. + +[TABLE] + +**err (1 byte):** A [BErr](#berr) that specifies the value of this error. The value MUST be 0x17. + +#### ExtPtgRef3D + +The **ExtPtgRef3D** structure is a variation of [PtgRef3d](#ptgref3d) that is used by formulas in an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2). It specifies the location of a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on one or more [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**iTabs (4 bytes):** An [ExtSheetPair](#extsheetpair) that specifies the sheet or sheets containing the cell. + +**loc (4 bytes):** A [RgceLocRel](#rgcelocrel) that specifies the location of a cell within a sheet. + +#### ExtPtgRefErr3D + +The **ExtPtgRefErr3D** structure is a variation of [PtgRefErr3d](#ptgreferr3d) that is used by formulas in an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2). It specifies an invalid single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) reference on one or more [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**iTabs (4 bytes):** An [ExtSheetPair](#extsheetpair) that specifies the sheet or sheets containing the target of this reference. + +**unused (4 bytes):** Undefined and MUST be ignored. + +#### ExtSheetPair + +The **ExtSheetPair** structure specifies a pair of [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the formulas of an [external defined name](#Section_3a459d7b05f54d7a9e0d0d62c5b2fbb2). The sheets are in the [External Workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc) as specified by the preceding [SupBook](#supbook) record. + +[TABLE] + +**itabFirst (2 bytes):** A signed integer that specifies the first sheet of a single or multi-sheet reference. It MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | Specifies that the first sheet of this reference could not be found. | +| \>=0 | This value specifies the zero-based index of an [XLUnicodeString](#xlunicodestring) in the **rgst** field of the preceding SupBook record. The XLUnicodeString specifies the name of the first referenced sheet within the supporting workbook. This value MUST be less than the value of the **ctab** field in the preceding SupBook record. | + +**itabLast (2 bytes):** A signed integer that specifies the last sheet of a single or multi-sheet reference. The value MUST be greater than or equal to **itabFirst** if it is not -1 and MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -1 | Specifies that the last sheet of this reference could not be found. | +| \>=0 | This value specifies the zero-based index of an XLUnicodeString in the **rgst** field of the preceding SupBook record. The XLUnicodeString specifies the name of the last referenced sheet within the supporting workbook. This value MUST be less than the value of the **ctab** field in the preceding SupBook record. | + +#### Ftab + +The **Ftab** structure specifies a function which can be called from a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). The definition of each function specifies the function name and the valid sequence of arguments. + +[TABLE] + +**iftab (2 bytes):** An unsigned integer that specifies the function to be called. MUST be a value from the following table: + +The elements [ref](#rgce) and val are specified in Rgce. + +| Value | Meaning | +|----|----| +| 0x0000 | COUNT | +| | count-params = (ref / val), \*29(ref / val) | +| 0x0001 | IF | +| | if-params = val, \*2(ref / val) | +| 0x0002 | ISNA | +| | isna-params = val | +| 0x0003 | ISERROR | +| | iserror-params = val | +| 0x0004 | SUM | +| | sum-params = (ref / val), \*29(ref / val) | +| 0x0005 | AVERAGE | +| | average-params = (ref / val), \*29(ref / val) | +| 0x0006 | MIN | +| | min-params = (ref / val), \*29(ref / val) | +| 0x0007 | MAX | +| | max-params = (ref / val), \*29(ref / val) | +| 0x0008 | ROW | +| | row-params = \[ref\] | +| 0x0009 | COLUMN | +| | column-params = \[ref\] | +| 0x000A | NA | +| | This function takes no parameters | +| 0x000B | NPV | +| | npv-params = val, (ref / val), \*28(ref / val) | +| 0x000C | STDEV | +| | stdev-params = (ref / val), \*29(ref / val) | +| 0x000D | DOLLAR | +| | dollar-params = val, \[val\] | +| 0x000E | FIXED | +| | fixed-params = val, \[val, \[val\]\] | +| 0x000F | SIN | +| | sin-params = val | +| 0x0010 | COS | +| | cos-params = val | +| 0x0011 | TAN | +| | tan-params = val | +| 0x0012 | ATAN | +| | atan-params = val | +| 0x0013 | PI | +| | This function takes no parameters | +| 0x0014 | SQRT | +| | sqrt-params = val | +| 0x0015 | EXP | +| | exp-params = val | +| 0x0016 | LN | +| | ln-params = val | +| 0x0017 | LOG10 | +| | log10-params = val | +| 0x0018 | ABS | +| | abs-params = val | +| 0x0019 | INT | +| | int-params = val | +| 0x001A | SIGN | +| | sign-params = val | +| 0x001B | ROUND | +| | round-params = val, val | +| 0x001C | LOOKUP | +| | lookup-params = val, (ref / val), \[ref / val\] | +| 0x001D | INDEX | +| | index-params = (ref / val), val, \*2(val) | +| 0x001E | REPT | +| | rept-params = val, val | +| 0x001F | MID | +| | mid-params = val, val, val | +| 0x0020 | LEN | +| | len-params = val | +| 0x0021 | VALUE | +| | value-params = val | +| 0x0022 | TRUE | +| | This function takes no parameters | +| 0x0023 | FALSE | +| | This function takes no parameters | +| 0x0024 | AND | +| | and-params = (ref / val), \*29(ref / val) | +| 0x0025 | OR | +| | or-params = (ref / val), \*29(ref / val) | +| 0x0026 | NOT | +| | not-params = val | +| 0x0027 | MOD | +| | mod-params = val, val | +| 0x0028 | DCOUNT | +| | dcount-params = ref, (ref / val), (ref / val) | +| 0x0029 | DSUM | +| | dsum-params = ref, (ref / val), (ref / val) | +| 0x002A | DAVERAGE | +| | daverage-params = ref, (ref / val), (ref / val) | +| 0x002B | DMIN | +| | dmin-params = ref, (ref / val), (ref / val) | +| 0x002C | DMAX | +| | dmax-params = ref, (ref / val), (ref / val) | +| 0x002D | DSTDEV | +| | dstdev-params = ref, (ref / val), (ref / val) | +| 0x002E | VAR | +| | var-params = (ref / val), \*29(ref / val) | +| 0x002F | DVAR | +| | dvar-params = ref, (ref / val), (ref / val) | +| 0x0030 | TEXT | +| | text-params = val, val | +| 0x0031 | LINEST | +| | linest-params = (ref / val), \[(ref / val), \*2(ref / val)\] | +| 0x0032 | TREND | +| | trend-params = (ref / val), \[(ref / val), \[(ref / val), \[ref / val\]\]\] | +| 0x0033 | LOGEST | +| | logest-params = (ref / val), \[(ref / val), \*2(ref / val)\] | +| 0x0034 | GROWTH | +| | growth-params = (ref / val), \[(ref / val), \[(ref / val), \[ref / val\]\]\] | +| 0x0035 | GOTO | +| | goto-params = ref | +| 0x0036 | HALT | +| | halt-params = \[val\] | +| 0x0037 | RETURN | +| | return-params = \[ref / val\] | +| 0x0038 | PV | +| | pv-params = val, val, val, \*2(val) | +| 0x0039 | FV | +| | fv-params = val, val, val, \*2(val) | +| 0x003A | NPER | +| | nper-params = val, val, val, \*2(val) | +| 0x003B | PMT | +| | pmt-params = val, val, val, \*2(val) | +| 0x003C | RATE | +| | rate-params = val, val, val, \*3(val) | +| 0x003D | MIRR | +| | mirr-params = (ref / val), val, val | +| 0x003E | IRR | +| | irr-params = (ref / val), \[val\] | +| 0x003F | RAND | +| | This function takes no parameters | +| 0x0040 | MATCH | +| | match-params = val, (ref / val), \[ref / val\] | +| 0x0041 | DATE | +| | date-params = val, val, val | +| 0x0042 | TIME | +| | time-params = val, val, val | +| 0x0043 | DAY | +| | day-params = val | +| 0x0044 | MONTH | +| | month-params = val | +| 0x0045 | YEAR | +| | year-params = val | +| 0x0046 | WEEKDAY | +| | weekday-params = val, \[val\] | +| 0x0047 | HOUR | +| | hour-params = val | +| 0x0048 | MINUTE | +| | minute-params = val | +| 0x0049 | SECOND | +| | second-params = val | +| 0x004A | NOW | +| | This function takes no parameters | +| 0x004B | AREAS | +| | areas-params = ref | +| 0x004C | ROWS | +| | rows-params = (ref / val) | +| 0x004D | COLUMNS | +| | columns-params = (ref / val) | +| 0x004E | OFFSET | +| | offset-params = ref, val, val, \*2(val) | +| 0x004F | ABSREF | +| | absref-params = val, ref | +| 0x0050 | RELREF | +| | relref-params = ref, ref | +| 0x0051 | ARGUMENT | +| | argument-params = \[val, \[(ref / val), \[ref\]\]\] | +| 0x0052 | SEARCH | +| | search-params = val, val, \[val\] | +| 0x0053 | TRANSPOSE | +| | transpose-params = val | +| 0x0054 | ERROR | +| | error-params = \[val, \[ref / val\]\] | +| 0x0055 | STEP | +| | This function takes no parameters | +| 0x0056 | TYPE | +| | type-params = val | +| 0x0057 | ECHO | +| | echo-params = \[val\] | +| 0x0058 | SET.NAME | +| | set-name-params = val, \[ref / val\] | +| 0x0059 | CALLER | +| | This function takes no parameters | +| 0x005A | DEREF | +| | deref-params = ref | +| 0x005B | WINDOWS | +| | windows-params = \[val, \[val\]\] | +| 0x005C | SERIES | +| | series-params = (ref / val), (ref / val), (ref / val), val, \[ref / val\] | +| 0x005D | DOCUMENTS | +| | documents-params = \[val, \[val\]\] | +| 0x005E | ACTIVE.CELL | +| | This function takes no parameters | +| 0x005F | SELECTION | +| | This function takes no parameters | +| 0x0060 | RESULT | +| | result-params = \[val\] | +| 0x0061 | ATAN2 | +| | atan2-params = val, val | +| 0x0062 | ASIN | +| | asin-params = val | +| 0x0063 | ACOS | +| | acos-params = val | +| 0x0064 | CHOOSE | +| | choose-params = val, (ref / val), \*28(ref / val) | +| 0x0065 | HLOOKUP | +| | hlookup-params = val, (ref / val), (ref / val), \[val\] | +| 0x0066 | VLOOKUP | +| | vlookup-params = val, (ref / val), (ref / val), \[val\] | +| 0x0067 | LINKS | +| | links-params = \[val, \[val\]\] | +| 0x0068 | INPUT | +| | input-params = val, \[val, \[val, \[val, \[val, \[val, \[val\]\]\]\]\]\] | +| 0x0069 | ISREF | +| | isref-params = (ref / val) | +| 0x006A | GET.FORMULA | +| | get-formula-params = (ref / val) | +| 0x006B | GET.NAME | +| | get-name-params = val, \[val\] | +| 0x006C | SET.VALUE | +| | set-value-params = ref, val | +| 0x006D | LOG | +| | log-params = val, \[val\] | +| 0x006E | EXEC | +| | exec-params = val, \[val, \*2(val)\] | +| 0x006F | CHAR | +| | char-params = val | +| 0x0070 | LOWER | +| | lower-params = val | +| 0x0071 | UPPER | +| | upper-params = val | +| 0x0072 | PROPER | +| | proper-params = val | +| 0x0073 | LEFT | +| | left-params = val, \[val\] | +| 0x0074 | RIGHT | +| | right-params = val, \[val\] | +| 0x0075 | EXACT | +| | exact-params = val, val | +| 0x0076 | TRIM | +| | trim-params = val | +| 0x0077 | REPLACE | +| | replace-params = val, val, val, val | +| 0x0078 | SUBSTITUTE | +| | substitute-params = val, val, val, \[val\] | +| 0x0079 | CODE | +| | code-params = val | +| 0x007A | NAMES | +| | names-params = \[val, \[val, \[val\]\]\] | +| 0x007B | DIRECTORY | +| | directory-params = \[val\] | +| 0x007C | FIND | +| | find-params = val, val, \[val\] | +| 0x007D | CELL | +| | cell-params = val, \[ref\] | +| 0x007E | ISERR | +| | iserr-params = val | +| 0x007F | ISTEXT | +| | istext-params = val | +| 0x0080 | ISNUMBER | +| | isnumber-params = val | +| 0x0081 | ISBLANK | +| | isblank-params = val | +| 0x0082 | T | +| | t-params = (ref / val) | +| 0x0083 | N | +| | n-params = (ref / val) | +| 0x0084 | FOPEN | +| | fopen-params = val, \[val\] | +| 0x0085 | FCLOSE | +| | fclose-params = val | +| 0x0086 | FSIZE | +| | fsize-params = val | +| 0x0087 | FREADLN | +| | freadln-params = val | +| 0x0088 | FREAD | +| | fread-params = val, val | +| 0x0089 | FWRITELN | +| | fwriteln-params = val, val | +| 0x008A | FWRITE | +| | fwrite-params = val, val | +| 0x008B | FPOS | +| | fpos-params = val, \[val\] | +| 0x008C | DATEVALUE | +| | datevalue-params = val | +| 0x008D | TIMEVALUE | +| | timevalue-params = val | +| 0x008E | SLN | +| | sln-params = val, val, val | +| 0x008F | SYD | +| | syd-params = val, val, val, val | +| 0x0090 | DDB | +| | ddb-params = val, val, val, val, \[val\] | +| 0x0091 | GET.DEF | +| | get-def-params = val, \[val, \[val\]\] | +| 0x0092 | REFTEXT | +| | reftext-params = ref, \[val\] | +| 0x0093 | TEXTREF | +| | textref-params = val, \[val\] | +| 0x0094 | INDIRECT | +| | indirect-params = val, \[val\] | +| 0x0095 | REGISTER | +| | register-params = val, \[val, \[val, \[val, \[val, \[val, \[val, \[val, \[val, \[val, \*20(val)\]\]\]\]\]\]\]\]\] | +| 0x0096 | CALL | +| | call-params = val, \[(ref / val), \*28(ref / val)\] | +| 0x0097 | ADD.BAR | +| | add-bar-params = \[val\] | +| 0x0098 | ADD.MENU | +| | add-menu-params = val, (ref / val), \[(ref / val), \[val\]\] | +| 0x0099 | ADD.COMMAND | +| | add-command-params = val, (ref / val), (ref / val), \[(ref / val), \[val\]\] | +| 0x009A | ENABLE.COMMAND | +| | enable-command-params = val, val, val, val, \[val\] | +| 0x009B | CHECK.COMMAND | +| | check-command-params = val, val, val, val, \[val\] | +| 0x009C | RENAME.COMMAND | +| | rename-command-params = val, val, val, val, \[val\] | +| 0x009D | SHOW.BAR | +| | show-bar-params = \[val\] | +| 0x009E | DELETE.MENU | +| | delete-menu-params = val, val, \[val\] | +| 0x009F | DELETE.COMMAND | +| | delete-command-params = val, val, val, \[val\] | +| 0x00A0 | GET.CHART.ITEM | +| | get-chart-item-params = val, \[val, \[val\]\] | +| 0x00A1 | DIALOG.BOX | +| | dialog-box-params = (ref / val) | +| 0x00A2 | CLEAN | +| | clean-params = val | +| 0x00A3 | MDETERM | +| | mdeterm-params = val | +| 0x00A4 | MINVERSE | +| | minverse-params = val | +| 0x00A5 | MMULT | +| | mmult-params = val, val | +| 0x00A6 | FILES | +| | files-params = \*2(val) | +| 0x00A7 | IPMT | +| | ipmt-params = val, val, val, val, \*2(val) | +| 0x00A8 | PPMT | +| | ppmt-params = val, val, val, val, \*2(val) | +| 0x00A9 | COUNTA | +| | counta-params = (ref / val), \*29(ref / val) | +| 0x00AA | CANCEL.KEY | +| | cancel-key-params = \[val, \[ref\]\] | +| 0x00AB | FOR | +| | for-params = val, val, val, \[val\] | +| 0x00AC | WHILE | +| | while-params = val | +| 0x00AD | BREAK | +| | This function takes no parameters | +| 0x00AE | NEXT | +| | This function takes no parameters | +| 0x00AF | INITIATE | +| | initiate-params = val, val | +| 0x00B0 | REQUEST | +| | request-params = val, val | +| 0x00B1 | POKE | +| | poke-params = val, (ref / val), (ref / val) | +| 0x00B2 | EXECUTE | +| | execute-params = val, val | +| 0x00B3 | TERMINATE | +| | terminate-params = val | +| 0x00B4 | RESTART | +| | restart-params = \[val\] | +| 0x00B5 | HELP | +| | help-params = \[val\] | +| 0x00B6 | GET.BAR | +| | get-bar-params = \*4(val) | +| 0x00B7 | PRODUCT | +| | product-params = (ref / val), \*29(ref / val) | +| 0x00B8 | FACT | +| | fact-params = val | +| 0x00B9 | GET.CELL | +| | get-cell-params = val, \[ref\] | +| 0x00BA | GET.WORKSPACE | +| | get-workspace-params = val | +| 0x00BB | GET.WINDOW | +| | get-window-params = val, \[val\] | +| 0x00BC | GET.DOCUMENT | +| | get-document-params = val, \[val\] | +| 0x00BD | DPRODUCT | +| | dproduct-params = ref, (ref / val), (ref / val) | +| 0x00BE | ISNONTEXT | +| | isnontext-params = val | +| 0x00BF | GET.NOTE | +| | get-note-params = \[(ref / val), \*2(val)\] | +| 0x00C0 | NOTE | +| | note-params = \[val, \[(ref / val), \*2(ref / val)\]\] | +| 0x00C1 | STDEVP | +| | stdevp-params = (ref / val), \*29(ref / val) | +| 0x00C2 | VARP | +| | varp-params = (ref / val), \*29(ref / val) | +| 0x00C3 | DSTDEVP | +| | dstdevp-params = ref, (ref / val), (ref / val) | +| 0x00C4 | DVARP | +| | dvarp-params = ref, (ref / val), (ref / val) | +| 0x00C5 | TRUNC | +| | trunc-params = val, \[val\] | +| 0x00C6 | ISLOGICAL | +| | islogical-params = val | +| 0x00C7 | DCOUNTA | +| | dcounta-params = ref, (ref / val), (ref / val) | +| 0x00C8 | DELETE.BAR | +| | delete-bar-params = val | +| 0x00C9 | UNREGISTER | +| | unregister-params = val | +| 0x00CC | USDOLLAR | +| | usdollar-params = val, \[val\] | +| 0x00CD | FINDB | +| | findb-params = val, val, \[val\] | +| 0x00CE | SEARCHB | +| | searchb-params = val, val, \[val\] | +| 0x00CF | REPLACEB | +| | replaceb-params = val, val, val, val | +| 0x00D0 | LEFTB | +| | leftb-params = val, \[val\] | +| 0x00D1 | RIGHTB | +| | rightb-params = val, \[val\] | +| 0x00D2 | MIDB | +| | midb-params = val, val, val | +| 0x00D3 | LENB | +| | lenb-params = val | +| 0x00D4 | ROUNDUP | +| | roundup-params = val, val | +| 0x00D5 | ROUNDDOWN | +| | rounddown-params = val, val | +| 0x00D6 | ASC | +| | asc-params = val | +| 0x00D7 | DBCS | +| | dbcs-params = val | +| 0x00D8 | RANK | +| | rank-params = val, ref, \[val\] | +| 0x00DB | ADDRESS | +| | address-params = val, val, \[val, \[val, \[val\]\]\] | +| 0x00DC | DAYS360 | +| | days360-params = val, val, \[val\] | +| 0x00DD | TODAY | +| | This function takes no parameters | +| 0x00DE | VDB | +| | vdb-params = val, val, val, val, val, \[val, \[val\]\] | +| 0x00DF | ELSE | +| | This function takes no parameters | +| 0x00E0 | ELSE.IF | +| | else-if-params = val | +| 0x00E1 | END.IF | +| | This function takes no parameters | +| 0x00E2 | FOR.CELL | +| | for-cell-params = val, \[(ref / val), \[ref / val\]\] | +| 0x00E3 | MEDIAN | +| | median-params = (ref / val), \*29(ref / val) | +| 0x00E4 | SUMPRODUCT | +| | sumproduct-params = val, \*29(val) | +| 0x00E5 | SINH | +| | sinh-params = val | +| 0x00E6 | COSH | +| | cosh-params = val | +| 0x00E7 | TANH | +| | tanh-params = val | +| 0x00E8 | ASINH | +| | asinh-params = val | +| 0x00E9 | ACOSH | +| | acosh-params = val | +| 0x00EA | ATANH | +| | atanh-params = val | +| 0x00EB | DGET | +| | dget-params = ref, (ref / val), (ref / val) | +| 0x00EC | CREATE.OBJECT | +| | create-object-params = val, (ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[(ref / val), \[ref / val\]\]\]\]\]\]\]\]\] | +| 0x00ED | VOLATILE | +| | volatile-params = \[val\] | +| 0x00EE | LAST.ERROR | +| | This function takes no parameters | +| 0x00EF | CUSTOM.UNDO | +| | custom-undo-params = \*2(val) | +| 0x00F0 | CUSTOM.REPEAT | +| | custom-repeat-params = \*3(val) | +| 0x00F1 | FORMULA.CONVERT | +| | formula-convert-params = val, (ref / val), \*3(ref / val) | +| 0x00F2 | GET.LINK.INFO | +| | get-link-info-params = val, val, \[val, \[val\]\] | +| 0x00F3 | TEXT.BOX | +| | text-box-params = val, \[val, \*2(val)\] | +| 0x00F4 | INFO | +| | info-params = val | +| 0x00F5 | GROUP | +| | This function takes no parameters | +| 0x00F6 | GET.OBJECT | +| | get-object-params = val, \[val, \*3(val)\] | +| 0x00F7 | DB | +| | db-params = val, val, val, val, \[val\] | +| 0x00F8 | PAUSE | +| | pause-params = \[val\] | +| 0x00FB | RESUME | +| | resume-params = \[val\] | +| 0x00FC | FREQUENCY | +| | frequency-params = (ref / val), (ref / val) | +| 0x00FD | ADD.TOOLBAR | +| | add-toolbar-params = \[val, \[val\]\] | +| 0x00FE | DELETE.TOOLBAR | +| | delete-toolbar-params = val | +| 0x00FF | User Defined Function | +| | user-defined-function-params = (ref / val), \[(ref / val), \*28(ref / val)\] | +| 0x0100 | RESET.TOOLBAR | +| | reset-toolbar-params = val | +| 0x0101 | EVALUATE | +| | evaluate-params = val | +| 0x0102 | GET.TOOLBAR | +| | get-toolbar-params = val, \[val\] | +| 0x0103 | GET.TOOL | +| | get-tool-params = val, \[val, \[val\]\] | +| 0x0104 | SPELLING.CHECK | +| | spelling-check-params = val, \[val, \[val\]\] | +| 0x0105 | ERROR.TYPE | +| | error-type-params = val | +| 0x0106 | APP.TITLE | +| | app-title-params = \[val\] | +| 0x0107 | WINDOW.TITLE | +| | window-title-params = \[val\] | +| 0x0108 | SAVE.TOOLBAR | +| | save-toolbar-params = \[val, \[val\]\] | +| 0x0109 | ENABLE.TOOL | +| | enable-tool-params = val, val, val | +| 0x010A | PRESS.TOOL | +| | press-tool-params = val, val, val | +| 0x010B | REGISTER.ID | +| | register-id-params = val, val, \[val\] | +| 0x010C | GET.WORKBOOK | +| | get-workbook-params = val, \[val\] | +| 0x010D | AVEDEV | +| | avedev-params = (ref / val), \*29(ref / val) | +| 0x010E | BETADIST | +| | betadist-params = val, val, val, \*2(val) | +| 0x010F | GAMMALN | +| | gammaln-params = val | +| 0x0110 | BETAINV | +| | betainv-params = val, val, val, \*2(val) | +| 0x0111 | BINOMDIST | +| | binomdist-params = val, val, val, val | +| 0x0112 | CHIDIST | +| | chidist-params = val, val | +| 0x0113 | CHIINV | +| | chiinv-params = val, val | +| 0x0114 | COMBIN | +| | combin-params = val, val | +| 0x0115 | CONFIDENCE | +| | confidence-params = val, val, val | +| 0x0116 | CRITBINOM | +| | critbinom-params = val, val, val | +| 0x0117 | EVEN | +| | even-params = val | +| 0x0118 | EXPONDIST | +| | expondist-params = val, val, val | +| 0x0119 | FDIST | +| | fdist-params = val, val, val | +| 0x011A | FINV | +| | finv-params = val, val, val | +| 0x011B | FISHER | +| | fisher-params = val | +| 0x011C | FISHERINV | +| | fisherinv-params = val | +| 0x011D | FLOOR | +| | floor-params = val, val | +| 0x011E | GAMMADIST | +| | gammadist-params = val, val, val, val | +| 0x011F | GAMMAINV | +| | gammainv-params = val, val, val | +| 0x0120 | CEILING | +| | ceiling-params = val, val | +| 0x0121 | HYPGEOMDIST | +| | hypgeomdist-params = val, val, val, val | +| 0x0122 | LOGNORMDIST | +| | lognormdist-params = val, val, val | +| 0x0123 | LOGINV | +| | loginv-params = val, val, val | +| 0x0124 | NEGBINOMDIST | +| | negbinomdist-params = val, val, val | +| 0x0125 | NORMDIST | +| | normdist-params = val, val, val, val | +| 0x0126 | NORMSDIST | +| | normsdist-params = val | +| 0x0127 | NORMINV | +| | norminv-params = val, val, val | +| 0x0128 | NORMSINV | +| | normsinv-params = val | +| 0x0129 | STANDARDIZE | +| | standardize-params = val, val, val | +| 0x012A | ODD | +| | odd-params = val | +| 0x012B | PERMUT | +| | permut-params = val, val | +| 0x012C | POISSON | +| | poisson-params = val, val, val | +| 0x012D | TDIST | +| | tdist-params = val, val, val | +| 0x012E | WEIBULL | +| | weibull-params = val, val, val, val | +| 0x012F | SUMXMY2 | +| | sumxmy2-params = val, val | +| 0x0130 | SUMX2MY2 | +| | sumx2my2-params = val, val | +| 0x0131 | SUMX2PY2 | +| | sumx2py2-params = val, val | +| 0x0132 | CHITEST | +| | chitest-params = val, val | +| 0x0133 | CORREL | +| | correl-params = val, val | +| 0x0134 | COVAR | +| | covar-params = val, val | +| 0x0135 | FORECAST | +| | forecast-params = val, val, val | +| 0x0136 | FTEST | +| | ftest-params = val, val | +| 0x0137 | INTERCEPT | +| | intercept-params = val, val | +| 0x0138 | PEARSON | +| | pearson-params = val, val | +| 0x0139 | RSQ | +| | rsq-params = val, val | +| 0x013A | STEYX | +| | steyx-params = val, val | +| 0x013B | SLOPE | +| | slope-params = val, val | +| 0x013C | TTEST | +| | ttest-params = val, val, val, val | +| 0x013D | PROB | +| | prob-params = val, val, val, \[val\] | +| 0x013E | DEVSQ | +| | devsq-params = (ref / val), \*29(ref / val) | +| 0x013F | GEOMEAN | +| | geomean-params = (ref / val), \*29(ref / val) | +| 0x0140 | HARMEAN | +| | harmean-params = (ref / val), \*29(ref / val) | +| 0x0141 | SUMSQ | +| | sumsq-params = (ref / val), \*29(ref / val) | +| 0x0142 | KURT | +| | kurt-params = (ref / val), \*29(ref / val) | +| 0x0143 | SKEW | +| | skew-params = (ref / val), \*29(ref / val) | +| 0x0144 | ZTEST | +| | ztest-params = (ref / val), val, \[val\] | +| 0x0145 | LARGE | +| | large-params = (ref / val), val | +| 0x0146 | SMALL | +| | small-params = (ref / val), val | +| 0x0147 | QUARTILE | +| | quartile-params = (ref / val), val | +| 0x0148 | PERCENTILE | +| | percentile-params = (ref / val), val | +| 0x0149 | PERCENTRANK | +| | percentrank-params = (ref / val), val, \[val\] | +| 0x014A | MODE | +| | mode-params = val, \*29(val) | +| 0x014B | TRIMMEAN | +| | trimmean-params = (ref / val), val | +| 0x014C | TINV | +| | tinv-params = val, val | +| 0x014E | MOVIE.COMMAND | +| | movie-command-params = val, val, val, \[val\] | +| 0x014F | GET.MOVIE | +| | get-movie-params = val, val, \[val\] | +| 0x0150 | CONCATENATE | +| | concatenate-params = val, \*29(val) | +| 0x0151 | POWER | +| | power-params = val, val | +| 0x0152 | PIVOT.ADD.DATA | +| | pivot-add-data-params = val, val, \[val, \[val, \[val, \[val, \*3(val)\]\]\]\] | +| 0x0153 | GET.PIVOT.TABLE | +| | get-pivot-table-params = val, \[val\] | +| 0x0154 | GET.PIVOT.FIELD | +| | get-pivot-field-params = val, \[val, \[val\]\] | +| 0x0155 | GET.PIVOT.ITEM | +| | get-pivot-item-params = val, \[val, \[val, \[val\]\]\] | +| 0x0156 | RADIANS | +| | radians-params = val | +| 0x0157 | DEGREES | +| | degrees-params = val | +| 0x0158 | SUBTOTAL | +| | subtotal-params = val, ref, \*28(ref) | +| 0x0159 | SUMIF | +| | sumif-params = ref, val, \[ref\] | +| 0x015A | COUNTIF | +| | countif-params = ref, val | +| 0x015B | COUNTBLANK | +| | countblank-params = ref | +| 0x015C | SCENARIO.GET | +| | scenario-get-params = val, \[val\] | +| 0x015D | OPTIONS.LISTS.GET | +| | options-lists-get-params = val | +| 0x015E | ISPMT | +| | ispmt-params = val, val, val, val | +| 0x015F | DATEDIF | +| | datedif-params = val, val, val | +| 0x0160 | DATESTRING | +| | datestring-params = val | +| 0x0161 | NUMBERSTRING | +| | numberstring-params = val, val | +| 0x0162 | ROMAN | +| | roman-params = val, \[val\] | +| 0x0163 | OPEN.DIALOG | +| | open-dialog-params = \[val, \[val, \[val, \[val\]\]\]\] | +| 0x0164 | SAVE.DIALOG | +| | save-dialog-params = \[val, \[val, \[val, \[val, \[val\]\]\]\]\] | +| 0x0165 | VIEW.GET | +| | view-get-params = val, \[val\] | +| 0x0166 | GETPIVOTDATA | +| | getpivotdata-params = (ref / val), (ref / val), \[val, \[val, \*13(val, val)\]\] | +| 0x0167 | HYPERLINK | +| | hyperlink-params = val, \[val\] | +| 0x0168 | PHONETIC | +| | phonetic-params = ref | +| 0x0169 | AVERAGEA | +| | averagea-params = (ref / val), \*29(ref / val) | +| 0x016A | MAXA | +| | maxa-params = (ref / val), \*29(ref / val) | +| 0x016B | MINA | +| | mina-params = (ref / val), \*29(ref / val) | +| 0x016C | STDEVPA | +| | stdevpa-params = (ref / val), \*29(ref / val) | +| 0x016D | VARPA | +| | varpa-params = (ref / val), \*29(ref / val) | +| 0x016E | STDEVA | +| | stdeva-params = (ref / val), \*29(ref / val) | +| 0x016F | VARA | +| | vara-params = (ref / val), \*29(ref / val) | +| 0x0170 | BAHTTEXT | +| | bahttext-params = val | +| 0x0171 | THAIDAYOFWEEK | +| | thaidayofweek-params = val | +| 0x0172 | THAIDIGIT | +| | thaidigit-params = val | +| 0x0173 | THAIMONTHOFYEAR | +| | thaimonthofyear-params = val | +| 0x0174 | THAINUMSOUND | +| | thainumsound-params = val | +| 0x0175 | THAINUMSTRING | +| | thainumstring-params = val | +| 0x0176 | THAISTRINGLENGTH | +| | thaistringlength-params = val | +| 0x0177 | ISTHAIDIGIT | +| | isthaidigit-params = val | +| 0x0178 | ROUNDBAHTDOWN | +| | roundbahtdown-params = val | +| 0x0179 | ROUNDBAHTUP | +| | roundbahtup-params = val | +| 0x017A | THAIYEAR | +| | thaiyear-params = val | +| 0x017B | RTD | +| | rtd-params = val, val, val, \*27(val) | + +The following grammar is used in the Rgce structure definition: + +params-fixed = isna-params / iserror-params / + +sin-params / cos-params / tan-params / + +atan-params / sqrt-params / + +exp-params / ln-params / log10-params / + +abs-params / int-params / sign-params / + +round-params / rept-params / mid-params / + +len-params / value-params / not-params / mod-params / + +dcount-params / dsum-params / daverage-params / + +dmin-params / dmax-params / dstdev-params / + +dvar-params / text-params / goto-params / + +mirr-params / date-params / + +time-params / day-params / month-params / + +year-params / hour-params / minute-params / + +second-params / areas-params / + +rows-params / columns-params / absref-params / + +relref-params / transpose-params / + +type-params / deref-params / atan2-params / + +asin-params / acos-params / isref-params / + +get-formula-params / set-value-params / char-params / + +lower-params / upper-params / proper-params / + +exact-params / trim-params / replace-params / + +code-params / iserr-params / istext-params / + +isnumber-params / isblank-params / t-params / + +n-params / fclose-params / fsize-params / + +freadln-params / fread-params / fwriteln-params / + +fwrite-params / datevalue-params / timevalue-params / + +sln-params / syd-params / dialog-box-params / + +clean-params / mdeterm-params / minverse-params / + +mmult-params / while-params / initiate-params / request-params / + +poke-params / execute-params / terminate-params / + +fact-params / get-workspace-params / dproduct-params / + +isnontext-params / dstdevp-params / dvarp-params / + +islogical-params / dcounta-params / delete-bar-params / + +unregister-params / replaceb-params / midb-params / + +lenb-params / roundup-params / rounddown-params / + +asc-params / dbcs-params / else-if-params / + +sinh-params / cosh-params / tanh-params / + +asinh-params / acosh-params / atanh-params / + +dget-params / info-params / frequency-params / delete-toolbar-params / + +reset-toolbar-params / evaluate-params / error-type-params / + +enable-tool-params / press-tool-params / gammaln-params / + +binomdist-params / chidist-params / chiinv-params / + +combin-params / confidence-params / critbinom-params / + +even-params / expondist-params / fdist-params / + +finv-params / fisher-params / fisherinv-params / + +floor-params / gammadist-params / gammainv-params / + +ceiling-params / hypgeomdist-params / lognormdist-params / + +loginv-params / negbinomdist-params / normdist-params / + +normsdist-params / norminv-params / normsinv-params / + +standardize-params / odd-params / permut-params / + +poisson-params / tdist-params / weibull-params / + +sumxmy2-params / sumx2my2-params / sumx2py2-params / + +chitest-params / correl-params / covar-params / + +forecast-params / ftest-params / intercept-params / + +pearson-params / rsq-params / steyx-params / + +slope-params / ttest-params / large-params / + +small-params / quartile-params / percentile-params / + +trimmean-params / tinv-params / power-params / + +radians-params / degrees-params / countif-params / + +countblank-params / options-lists-get-params / ispmt-params / + +datedif-params / datestring-params / numberstring-params / + +phonetic-params / bahttext-params / thaidayofweek-params / + +thaidigit-params / thaimonthofyear-params / thainumsound-params / + +thainumstring-params / thaistringlength-params / isthaidigit-params / + +roundbahtdown-params / roundbahtup-params / thaiyear-params + +params-variable = count-params / if-params / sum-params / + +average-params / min-params / max-params / + +row-params / column-params / npv-params / + +stdev-params / dollar-params / fixed-params / + +lookup-params / index-params / and-params / + +or-params / var-params / linest-params / + +trend-params / logest-params / growth-params / + +halt-params / return-params / pv-params / + +fv-params / nper-params / pmt-params / + +rate-params / irr-params / match-params / + +weekday-params / offset-params / argument-params / + +search-params / error-params / echo-params / + +set-name-params / windows-params / series-params / + +documents-params / result-params / choose-params / + +hlookup-params / vlookup-params / links-params / + +input-params / get-name-params / log-params / + +exec-params / left-params / right-params / + +substitute-params / names-params / directory-params / + +find-params / cell-params / fopen-params / + +fpos-params / ddb-params / get-def-params / + +reftext-params / textref-params / indirect-params / + +register-params / call-params / add-bar-params / + +add-menu-params / add-command-params / enable-command-params / + +check-command-params / rename-command-params / show-bar-params / + +delete-menu-params / delete-command-params / get-chart-item-params / + +files-params / ipmt-params / ppmt-params / + +counta-params / cancel-key-params / for-params / + +restart-params / help-params / get-bar-params / + +product-params / get-cell-params / get-window-params / + +get-document-params / get-note-params / note-params / + +stdevp-params / varp-params / trunc-params / + +usdollar-params / findb-params / searchb-params / + +leftb-params / rightb-params / rank-params / + +address-params / days360-params / vdb-params / + +for-cell-params / median-params / sumproduct-params / + +create-object-params / volatile-params / custom-undo-params / + +custom-repeat-params / formula-convert-params / get-link-info-params / + +text-box-params / get-object-params / db-params / + +pause-params / resume-params / add-toolbar-params / + +user-defined-function-params / get-toolbar-params / get-tool-params / + +spelling-check-params / app-title-params / window-title-params / + +save-toolbar-params / register-id-params / get-workbook-params / + +avedev-params / betadist-params / betainv-params / + +prob-params / devsq-params / geomean-params / + +harmean-params / sumsq-params / kurt-params / + +skew-params / ztest-params / percentrank-params / + +mode-params / movie-command-params / get-movie-params / + +concatenate-params / pivot-add-data-params / get-pivot-table-params / + +get-pivot-field-params / get-pivot-item-params / subtotal-params / + +sumif-params / scenario-get-params / roman-params / + +open-dialog-params / save-dialog-params / view-get-params / + +getpivotdata-params / hyperlink-params / averagea-params / + +maxa-params / mina-params / stdevpa-params / + +varpa-params / stdeva-params / vara-params / + +rtd-params + +#### Ilel + +The **Ilel** structure specifies a deleted label in use by a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b).[\<176\>](#Appendix_A_176) + +[TABLE] + +**ilel (2 bytes):** An unsigned integer used to calculate the index into the collection of [Lel](#lel) records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The referenced Lel specifies the deleted label in use. MUST be a value from the following table. + +| Value | Meaning | +|----|----| +| 0 | Invalid index. The number of deleted labels is greater than 2047, the maximum size of the array of deleted labels. | +| 1 | Invalid index. | +| Greater than 1 and less than or equal to 2048 | The one-based index plus 1 of the Lel record. | + +#### ListParsedArrayFormula + +The **ListParsedArrayFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +[TABLE] + +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), or [PtgSxName](#ptgsxname). + +**rgcb (variable):** An [RgbExtra](#rgbextra) that specifies ancillary data for the formula. + +#### ListParsedFormula + +The **ListParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +[TABLE] + +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), or [PtgSxName](#ptgsxname). + +#### NameParsedFormula + +The **NameParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + +[TABLE] + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), [PtgSxName](#ptgsxname), [PtgRef](#ptgref), [PtgRefN](#ptgrefn), [PtgRefErr](#ptgreferr), [PtgArea](#ptgarea), [PtgAreaN](#ptgarean), or [PtgAreaErr](#ptgareaerr). The size of **rgce** in bytes is specified by the **cce** field of the [Lbl](#lbl) record. + +**rgcb (variable):** An [RgbExtra](#rgbextra) that specifies ancillary data for the formula. + +#### ObjectParsedFormula + +The **ObjectParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used by an [**embedded object**](#gt_708607be-8655-416e-93f3-b434e9ecbd56). + +[TABLE] + +**cce (15 bits):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**A - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**unused (4 bytes):** Undefined and MUST be ignored. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST contain one Ptg only, and this Ptg MUST be [PtgTbl](#ptgtbl), [PtgName](#ptgname), [PtgNameX](#ptgnamex), [PtgErr](#ptgerr), [PtgRef](#ptgref), [PtgRefErr](#ptgreferr), [PtgRef3d](#ptgref3d), [PtgRefErr3d](#ptgreferr3d), [PtgArea](#ptgarea), [PtgAreaErr](#ptgareaerr), [PtgArea3d](#ptgarea3d), or [PtgAreaErr3d](#ptgareaerr3d). + +#### ParameterParsedFormula + +The **ParameterParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) for a query parameter. + +[TABLE] + +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgArray](#ptgarray)[\<177\>](#Appendix_A_177), [PtgMemArea](#ptgmemarea), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), or [PtgSxName](#ptgsxname). + +The root node of the parse tree of this field MUST NOT be a VALUE_TYPE, as described in Rgce. + +#### PivotParsedFormula + +The **PivotParsedFormula** structure specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) used in a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +[TABLE] + +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. + +**cSxName (2 bytes):** An unsigned integer that specifies number of contiguous [SxName](#sxname) records that follow the [SxFmla](#sxfmla) record that contains this formula. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgUnion](#ptgunion), [PtgIsect](#ptgisect), [PtgRange](#ptgrange), [PtgArray](#ptgarray), [PtgAttrSpaceSemi](#ptgattrspacesemi), [PtgAttrSemi](#ptgattrsemi), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), [PtgRef](#ptgref), [PtgRefErr](#ptgreferr), [PtgRefN](#ptgrefn), [PtgArea](#ptgarea), [PtgAreaErr](#ptgareaerr), [PtgAreaN](#ptgarean), [PtgRef3d](#ptgref3d), [PtgArea3d](#ptgarea3d), [PtgRefErr3d](#ptgreferr3d), [PtgAreaErr3d](#ptgareaerr3d), [PtgName](#ptgname), [PtgNameX](#ptgnamex), [PtgMemArea](#ptgmemarea), [PtgMemErr](#ptgmemerr), [PtgMemNoMem](#ptgmemnomem), or [PtgMemFunc](#ptgmemfunc). + +If this field contains a [PtgFunc](#ptgfunc), then the **iftab** field of the PtgFunc MUST be less than 0x0028 or greater than 0x002D and MUST NOT be equal to 0x002F, 0x00BD, 0x00C3, 0x00C4, or 0x00C7. + +If this field contains a [PtgFuncVar](#ptgfuncvar), then the **fCeFunc** field of the PtgFuncVar MUST be 0 and the **tab** field of the PtgFuncVar MUST NOT be equal to 0x00FF or 0x0166. + +The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +#### Ptg + +The **Ptg** structure specifies a single element of a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). The value of the first byte determines which structure it represents and MUST be one of the values in the first column of the following table. If the value of the first byte is 0x18 or 0x19, then the second byte determines which structure it represents and MUST be one of the values in the second column of the following table. + +| First byte | Second byte | Ptg | +|------------|-------------|---------------------------------------| +| 0x01 | | [PtgExp](#ptgexp) | +| 0x02 | | [PtgTbl](#ptgtbl) | +| 0x03 | | [PtgAdd](#ptgadd) | +| 0x04 | | [PtgSub](#ptgsub) | +| 0x05 | | [PtgMul](#ptgmul) | +| 0x06 | | [PtgDiv](#ptgdiv) | +| 0x07 | | [PtgPower](#ptgpower) | +| 0x08 | | [PtgConcat](#ptgconcat) | +| 0x09 | | [PtgLt](#ptglt) | +| 0x0A | | [PtgLe](#ptgle) | +| 0x0B | | [PtgEq](#ptgeq) | +| 0x0C | | [PtgGe](#ptgge) | +| 0x0D | | [PtgGt](#ptggt) | +| 0x0E | | [PtgNe](#ptgne) | +| 0x0F | | [PtgIsect](#ptgisect) | +| 0x10 | | [PtgUnion](#ptgunion) | +| 0x11 | | [PtgRange](#ptgrange) | +| 0x12 | | [PtgUplus](#ptguplus) | +| 0x13 | | [PtgUminus](#ptguminus) | +| 0x14 | | [PtgPercent](#ptgpercent) | +| 0x15 | | [PtgParen](#ptgparen) | +| 0x16 | | [PtgMissArg](#ptgmissarg) | +| 0x17 | | [PtgStr](#ptgstr) | +| 0x18 | 0x01 | [PtgElfLel](#ptgelflel) | +| 0x18 | 0x02 | [PtgElfRw](#ptgelfrw) | +| 0x18 | 0x03 | [PtgElfCol](#ptgelfcol) | +| 0x18 | 0x06 | [PtgElfRwV](#ptgelfrwv) | +| 0x18 | 0x07 | [PtgElfColV](#ptgelfcolv) | +| 0x18 | 0x0A | [PtgElfRadical](#ptgelfradical) | +| 0x18 | 0x0B | [PtgElfRadicalS](#ptgelfradicals) | +| 0x18 | 0x0D | [PtgElfColS](#ptgelfcols) | +| 0x18 | 0x0F | [PtgElfColSV](#ptgelfcolsv) | +| 0x18 | 0x10 | [PtgElfRadicalLel](#ptgelfradicallel) | +| 0x18 | 0x1D | [PtgSxName](#ptgsxname) | +| 0x19 | 0x01 | [PtgAttrSemi](#ptgattrsemi) | +| 0x19 | 0x02 | [PtgAttrIf](#ptgattrif) | +| 0x19 | 0x04 | [PtgAttrChoose](#ptgattrchoose) | +| 0x19 | 0x08 | [PtgAttrGoto](#ptgattrgoto) | +| 0x19 | 0x10 | [PtgAttrSum](#ptgattrsum) | +| 0x19 | 0x20 | [PtgAttrBaxcel](#ptgattrbaxcel) | +| 0x19 | 0x21 | PtgAttrBaxcel | +| 0x19 | 0x40 | [PtgAttrSpace](#ptgattrspace) | +| 0x19 | 0x41 | [PtgAttrSpaceSemi](#ptgattrspacesemi) | +| 0x1C | | [PtgErr](#ptgerr) | +| 0x1D | | [PtgBool](#ptgbool) | +| 0x1E | | [PtgInt](#ptgint) | +| 0x1F | | [PtgNum](#ptgnum) | +| 0x20 | | [PtgArray](#ptgarray) | +| 0x21 | | [PtgFunc](#ptgfunc) | +| 0x22 | | [PtgFuncVar](#ptgfuncvar) | +| 0x23 | | [PtgName](#ptgname) | +| 0x24 | | [PtgRef](#ptgref) | +| 0x25 | | [PtgArea](#ptgarea) | +| 0x26 | | [PtgMemArea](#ptgmemarea) | +| 0x27 | | [PtgMemErr](#ptgmemerr) | +| 0x28 | | [PtgMemNoMem](#ptgmemnomem) | +| 0x29 | | [PtgMemFunc](#ptgmemfunc) | +| 0x2A | | [PtgRefErr](#ptgreferr) | +| 0x2B | | [PtgAreaErr](#ptgareaerr) | +| 0x2C | | [PtgRefN](#ptgrefn) | +| 0x2D | | [PtgAreaN](#ptgarean) | +| 0x39 | | [PtgNameX](#ptgnamex) | +| 0x3A | | [PtgRef3d](#ptgref3d) | +| 0x3B | | [PtgArea3d](#ptgarea3d) | +| 0x3C | | [PtgRefErr3d](#ptgreferr3d) | +| 0x3D | | [PtgAreaErr3d](#ptgareaerr3d) | +| 0x40 | | PtgArray | +| 0x41 | | PtgFunc | +| 0x42 | | PtgFuncVar | +| 0x43 | | PtgName | +| 0x44 | | PtgRef | +| 0x45 | | PtgArea | +| 0x46 | | PtgMemArea | +| 0x47 | | PtgMemErr | +| 0x48 | | PtgMemNoMem | +| 0x49 | | PtgMemFunc | +| 0x4A | | PtgRefErr | +| 0x4B | | PtgAreaErr | +| 0x4C | | PtgRefN | +| 0x4D | | PtgAreaN | +| 0x59 | | PtgNameX | +| 0x5A | | PtgRef3d | +| 0x5B | | PtgArea3d | +| 0x5C | | PtgRefErr3d | +| 0x5D | | PtgAreaErr3d | +| 0x60 | | PtgArray | +| 0x61 | | PtgFunc | +| 0x62 | | PtgFuncVar | +| 0x63 | | PtgName | +| 0x64 | | PtgRef | +| 0x65 | | PtgArea | +| 0x66 | | PtgMemArea | +| 0x67 | | PtgMemErr | +| 0x68 | | PtgMemNoMem | +| 0x69 | | PtgMemFunc | +| 0x6A | | PtgRefErr | +| 0x6B | | PtgAreaErr | +| 0x6C | | PtgRefN | +| 0x6D | | PtgAreaN | +| 0x79 | | PtgNameX | +| 0x7A | | PtgRef3d | +| 0x7B | | PtgArea3d | +| 0x7C | | PtgRefErr3d | +| 0x7D | | PtgAreaErr3d | +| | | | +| | | | + +#### PtgAdd + +The **PtgAdd** structure specifies a [binary-value-operator](#rgce) that adds the second expression in a binary-value-expression to the first. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x03. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgArea + +The **PtgArea** [operand](#rgce) specifies a reference to a rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x05. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**area (8 bytes):** A [RgceArea](#rgcearea) that specifies the referenced range of cells. + +#### PtgArea3d + +The **PtgArea3d** [operand](#rgce) specifies a reference to the same rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on one or more [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). If the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing this structure is part of a revision as specified in the Formulas overview, then there MUST be a [RevExtern](#revextern) in the [RgbExtra](#rgbextra) corresponding to this PtgArea3d, which specifies those sheets. + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x1B. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the required data type for the value of the [Ptg](#ptg) + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**ixti (2 bytes):** If the formula containing this structure is not part of a revision as specified in the Formulas overview, then this value is an [XtiIndex](#xtiindex) that specifies the [XTI](#xti) which specifies those sheets. Otherwise it is undefined and MUST be ignored. + +**area (8 bytes):** A value that specifies coordinates of the referenced range of cells. If this PtgArea3d is part of a [NameParsedFormula](#nameparsedformula) then this is an [RgceAreaRel](#rgcearearel) value. Otherwise it is an [RgceArea](#rgcearea) value. + +#### PtgAreaErr + +The **PtgAreaErr** [operand](#rgce) specifies an invalid reference to a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x0B. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**unused3 (2 bytes):** Undefined and MUST be ignored. + +**unused4 (2 bytes):** Undefined and MUST be ignored. + +#### PtgAreaErr3d + +**PtgAreaErr3d** [operand](#rgce) specifies an invalid reference to the same rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on one or more [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). If the [formula](#Section_a795978bfa7845788e2dc07d78edae0e) (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing this structure is part of a revision as specified in the Formulas overview, then there MUST be a [RevExtern](#revextern) in the [RgbExtra](#rgbextra) corresponding to this PtgAreaErr3d, which specifies those sheets. + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x1D. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the required data type for the value of the [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**ixti (2 bytes):** If the formula containing this structure is not part of a revision as specified in the Formulas overview, then this value is an [XtiIndex](#xtiindex) that specifies the [XTI](#xti) which specifies those sheets. Otherwise it is undefined and MUST be ignored. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**unused3 (2 bytes):** Undefined and MUST be ignored. + +**unused4 (2 bytes):** Undefined and MUST be ignored. + +#### PtgAreaN + +The **PtgAreaN** [operand](#rgce) specifies a reference to a rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) as an [RgceAreaRel](#rgcearearel). + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x0D. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**area (8 bytes):** An RgceAreaRel that specifies the referenced range. + +#### PtgArray + +The **PtgArray** [operand](#rgce) specifies an array of values. There MUST be a [PtgExtraArray](#ptgextraarray) in the [RgbExtra](#rgbextra) corresponding to this PtgArray. The correspondence between PtgArray and PtgExtraArray structures is specified in RgbExtra. + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x00. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for this array. MUST be 2 or 3. + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**unused1 (1 byte):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**unused3 (4 bytes):** Undefined and MUST be ignored. + +#### PtgAttrBaxcel + +The **PtgAttrBaxcel** structure specifies that the result of the [Rgce](#rgce) is to be assigned to a local variable used in a [**macro sheet**](#gt_410f5dd1-4217-4d31-ab16-48271bd25491). + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - bitSemi (1 bit):** A bit that specifies whether this Rgce is [**volatile**](#gt_9555fd9b-d7c2-4f56-b938-1c653d46626a). + +**C - reserved2 (4 bits):** MUST be zero, and MUST be ignored. + +**D - bitBaxcel (1 bit):** Reserved. MUST be 1. + +**E - reserved3 (2 bits):** MUST be zero, and MUST be ignored. + +**unused (2 bytes):** Undefined and MUST be ignored. + +#### PtgAttrChoose + +The **PtgAttrChoose** structure specifies a [control token](#Section_3701f8837bef4eacb0e05ecbf4a23cbd). + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - reserved2 (2 bits):** MUST be zero, and MUST be ignored. + +**C - bitChoose (1 bit):** Reserved. MUST be 1. + +**reserved3 (5 bits):** MUST be zero, and MUST be ignored. + +**cOffset (2 bytes):** An unsigned integer that specifies a value which is 1 less than the number of elements in **rgOffset.** + +**rgOffset (variable):** An array of 2-byte unsigned integers that specifies the byte offsets. + +#### PtgAttrGoto + +The **PtgAttrGoto** structure specifies a [control token](#Section_3701f8837bef4eacb0e05ecbf4a23cbd). + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - reserved2 (3 bits):** MUST be zero, and MUST be ignored. + +**C - bitGoto (1 bit):** If the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing this structure is not part of a [ArrayParsedFormula](#arrayparsedformula) then the bit is reserved and MUST be 1. If the formula containing this structure is part of an ArrayParsedFormula, then the bit is undefined and MUST be ignored. + +**D - reserved3 (4 bits):** MUST be zero, and MUST be ignored. + +**offset (2 bytes):** An unsigned integer that specifies a value 1 less than the byte offset. + +#### PtgAttrIf + +The **PtgAttrIf** structure specifies a [control token](#Section_3701f8837bef4eacb0e05ecbf4a23cbd). + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**C - bitIf (1 bit):** Reserved. MUST be 1 + +**reserved3 (6 bits):** MUST be zero, and MUST be ignored. + +**offset (2 bytes):** An unsigned integer that specifies the byte offset. + +#### PtgAttrSemi + +The **PtgAttrSemi** structure specifies that this [Rgce](#rgce) is [**volatile**](#gt_9555fd9b-d7c2-4f56-b938-1c653d46626a). + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - bitSemi (1 bit):** Reserved. MUST be 1. + +**reserved2 (7 bits):** MUST be zero, and MUST be ignored. + +**unused (2 bytes):** Undefined and MUST be ignored. + +#### PtgAttrSpace + +The **PtgAttrSpace** [display token](#Section_44ae9bca374542a482095e7ded229789) specifies a number of space or carriage return characters that are displayed around the expression in a [display-precedence-expression](#rgce). + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**reserved2 (6 bits):** MUST be zero, and MUST be ignored. + +**B - bitSpace (1 bit):** Reserved. MUST be 1. + +**C - reserved3 (1 bit):** MUST be zero, and MUST be ignored. + +**type (2 bytes):** A [PtgAttrSpaceType](#ptgattrspacetype) that specifies a number of space or carriage return characters and the position of those characters + +#### PtgAttrSpaceSemi + +The **PtgAttrSpaceSemi** structure specifies a number of space or carriage return characters that are displayed around the expression in a [display-precedence-specifier](#rgce) and that the Rgce is [**volatile**](#gt_9555fd9b-d7c2-4f56-b938-1c653d46626a). + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**reserved2 (1 byte):** Reserved. MUST be 0x41. + +**type (2 bytes):** A [PtgAttrSpaceType](#ptgattrspacetype) that specifies a number of space or carriage return characters and position of those characters + +#### PtgAttrSpaceType + +The **PtgAttrSpaceType** structure specifies the number of space or carriage return characters and position of those characters. + +[TABLE] + +**type (1 byte):** An unsigned integer that specifies the character and position of the character. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | Specifies space characters before a [base-expression](#rgce). | +| 0x01 | Specifies carriage return characters before a base-expression. | +| 0x02 | Specifies space characters before the open parenthesis specified by [PtgParen](#ptgparen) in a display-precedence-specifier. | +| 0x03 | Specifies carriage return characters before the open parenthesis specified by PtgParen in a display-precedence-specifier. | +| 0x04 | Specifies space characters before the close parenthesis specified by PtgParen in a display-precedence-specifier. | +| 0x05 | Specifies carriage return characters before the close parenthesis specified by PtgParen in a display-precedence-specifier. | +| 0x06 | Specifies space characters before an expression. | + +**cch (1 byte):** An unsigned integer that specifies the number of characters. + +#### PtgAttrSum + +The **PtgAttrSum** structure specifies the sum of an expression as defined in [function-call](#rgce). + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x19. + +**A - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**B - reserved2 (4 bits):** MUST be zero, and MUST be ignored. + +**C - bitSum (1 bit):** Reserved. MUST be 1. + +**D - reserved3 (3 bits):** MUST be zero, and MUST be ignored. + +**unused (2 bytes):** Undefined and MUST be ignored. + +#### PtgBool + +The **PtgBool** [operand](#rgce) specifies a Boolean value. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x1D. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**boolean (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies the value. + +#### PtgConcat + +The **PtgConcat** structure specifies a [binary-value-operator](#rgce) that appends the second expression in binary-value-expression to the first. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x08. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgDataType + +The **PtgDataType** enumeration specifies the data type of a [Ptg](#ptg). MUST be a value from the following table: + +| Name | Value | Meaning | +|----|----|----| +| **REFERENCE** | 0x1 | Specifies a reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). | +| **VALUE** | 0x2 | Specifies a single value of a simple type. The type can be a Boolean, a number, a string, or an error code. | +| **ARRAY** | 0x3 | Specifies an array of values. | + +#### PtgDiv + +The **PtgDiv** structure specifies a [binary-value-operator](#rgce) that divides the first expression in a binary-value-expression by the second. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x06. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgElfCol + +The **PtgElfCol** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [reference class](#Section_a8fde0d5759c437eb385169df8117372) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) within a column which is represented by a single-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). + +[TABLE] + +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x03. + +**loc (4 bytes):** An [RgceElfLoc](#rgceelfloc) that specifies the location of the label. + +#### PtgElfColS + +The **PtgElfColS** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [reference class](#Section_a8fde0d5759c437eb385169df8117372) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) within a column that is identified by a multiple-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). There MUST be a [PtgExtraElf](#ptgextraelf) in the [RgbExtra](#rgbextra) corresponding to this PtgElfColS. The correspondence between PtgElfColS and PtgExtraElf structures is specified in RgbExtra. + +[TABLE] + +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x0D. + +**unused (4 bytes):** Undefined and MUST be ignored. + +#### PtgElfColSV + +The **PtgElfColSV** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [value class](#Section_9a43cbef26504581af603ff0d876d82a) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) within a column that is identified by a multiple-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). There MUST be a [PtgExtraElf](#ptgextraelf) in the [RgbExtra](#rgbextra) corresponding to this PtgElfColSV. The correspondence between PtgElfColSV and PtgExtraElf structures is specified in RgbExtra. + +[TABLE] + +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x0F. + +**unused (4 bytes):** Undefined and MUST be ignored. + +#### PtgElfColV + +The **PtgElfColV** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [value class](#Section_9a43cbef26504581af603ff0d876d82a) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) within a column which is represented by a single-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). + +[TABLE] + +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x07. + +**loc (4 bytes):** An [RgceElfLoc](#rgceelfloc) that specifies the location of the label. + +#### PtgElfLel + +The **PtgElfLel** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) which is represented by a single-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5) or a multiple-cell natural language label that has been deleted. + +[TABLE] + +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x01. + +**ilel (2 bytes):** An [Ilel](#ilel) that specifies the deleted label. + +**A - fQuoted (1 bit):** A bit that specifies whether the occurrences of the label specified in **ilel** are surrounded by single quote characters in the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +#### PtgElfRadical + +The **PtgElfRadical** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [reference class](#Section_a8fde0d5759c437eb385169df8117372) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that is represented by a single-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). The range is specified by [PtgArea](#ptgarea) or [PtgAreaErr](#ptgareaerr) that follows this PtgElfRadical in the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). If this structure is followed in the formula by PtgArea, then one but not both of the following MUST be true: + +- The **area.rowFirst** field is equal to the **area.rowLast** field of PtgArea, and the **loc** field specifies a label location that is adjacent to the range specified by the **area** field of PtgArea. The **loc.row** field of this PtgElfRadical is equal to the **area.rowFirst** field of PtgArea + +- The **area.columnFirst** field is equal to the **area.columnLast** field of PtgArea, and the **loc** field specifies a label location that is adjacent to the range specified by the area field of PtgArea. The **loc**.**col** field of this PtgElfRadical is equal to the **area**.**columnFirst** field of PtgArea + +[TABLE] + +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x0A. + +**loc (4 bytes):** An [RgceElfLoc](#rgceelfloc) that specifies the location of the label. + +#### PtgElfRadicalLel + +The **PtgElfRadicalLel** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [reference class](#Section_a8fde0d5759c437eb385169df8117372) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) which is represented by a single-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5) or a multiple-cell natural language label that has been deleted. + +[TABLE] + +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x10. + +**ilel (2 bytes):** An [Ilel](#ilel) that specifies the deleted label. + +**A - fQuoted (1 bit):** A bit that specifies whether the occurrences of the label specified in **ilel** are surrounded by single quote characters in the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). + +**reserved (15 bits):** MUST be zero, and MUST be ignored. + +#### PtgElfRadicalS + +The **PtgElfRadicalS** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [reference class](#Section_a8fde0d5759c437eb385169df8117372) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) which is represented by a multiple-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). The range is specified by the [PtgArea](#ptgarea) or [PtgAreaErr](#ptgareaerr) record which follows this PtgElfRadicalS in the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). There MUST be a [PtgExtraElf](#ptgextraelf) in the [RgbExtra](#rgbextra) corresponding to this PtgElfRadicalS. The correspondence between PtgElfRadicalS and PtgExtraElf structures is specified in RgbExtra. + +If this PtgElfRadicalS is followed in the formula (section 2.2.2) by PtgArea, then the **area.columnFirst** field and the **area.columnLast** field of the PtgArea MUST be equal. Additionally, the last element in the **array** field of the corresponding PtgExtraElf MUST specify a label location that is adjacent to the range specified by the **area** field of PtgArea. The **column**.**col** field of the last element in the **array** field of PtgExtraElf MUST also be equal to the **area**.**columnFirst** field of PtgArea. + +[TABLE] + +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x0B. + +**unused (4 bytes):** Undefined and MUST be ignored. + +#### PtgElfRw + +The **PtgElfRw** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [reference class](#Section_a8fde0d5759c437eb385169df8117372) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) within a row which is represented by a single-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). + +[TABLE] + +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x02. + +**loc (4 bytes):** An [RgceElfLoc](#rgceelfloc) that specifies the location of the label. + +#### PtgElfRwV + +The **PtgElfRwV** [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) [operand](#rgce) specifies a [value class](#Section_9a43cbef26504581af603ff0d876d82a) reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) within a row which is represented by a single-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). + +[TABLE] + +**ptg (1 byte):** Reserved. MUST be 0x18. + +**eptg (1 byte):** Reserved. MUST be 0x06. + +**loc (4 bytes):** An [RgceElfLoc](#rgceelfloc) that specifies the location of the label. + +#### PtgEq + +The **PtgEq** structure specifies the comparison of whether the first [expression](#rgce) is equal to the second expression. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x0B. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgErr + +The **PtgErr** [operand](#rgce) specifies an error code. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x1C. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**err (1 byte):** A [BErr](#berr) that specifies the error code. + +#### PtgExp + +The **PtgExp** structure specifies that the containing [Rgce](#rgce) is part of an array formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) or shared formula and specifies the row and column of the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in which that formula exists. + +The **row** and **col** fields of this structure specify a cell on the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). There MUST be a [Formula](#formula) record where the **cell**.**rw** field of that record is equal to **row**, and **cell**.**col**.**col** field of that record is equal to **col**. + +That Formula record MUST be followed by either a [ShrFmla](#shrfmla) record or an [Array](#array) record. + +If that Formula record is followed by a ShrFmla, the **row** field of this structure MUST be greater than or equal to the **ref**.**rwFirst** field and less than or equal to the **ref**.**rwLast** field of the ShrFmla record, and the **col** field of this structure MUST be greater than or equal to the **ref**.**colFirst** field and less than or equal to the **ref**.**colLast** field of the ShrFmla record. + +If that Formula record is followed by an Array, the **row** field of this structure MUST be equal to the **ref**.**rwFirst** field of the Array record, and the **col** field of this structure MUST be equal to the **ref**.**colFirst** field of the Array record. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x01. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**row (2 bytes):** A [Rw](#rw) that specifies the row of the cell that contains the array formula or shared formula that the containing Rgce is a part of. + +**col (2 bytes):** A [Col](#col) that specifies the column of the cell that contains the array formula or shared formula that the containing Rgce is a part of. + +#### PtgExtraArray + +The **PtgExtraArray** structure specifies the values for the corresponding [PtgArray](#ptgarray) as specified in [RgbExtra](#rgbextra). + +[TABLE] + +**cols (1 byte):** A [DColByteU](#dcolbyteu) that specifies one less than the number of columns in the array. + +**rows (2 bytes):** A [DRw](#drw) that specifies one less than the number of rows in the array. + +**array (variable):** An array of [SerAr](#serar) that specifies the values in row-major order. The number of elements MUST be equal to the product of **rows** and **cols**. + +#### PtgExtraElf + +The **PtgExtraElf** structure specifies a multiple-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5) used in a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b). The label is specified by a sequence of labels from the given array of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +[TABLE] + +**count (30 bits):** An unsigned integer that specifies the number of elements in **array**. MUST be greater than 0. + +**A - reserved (1 bit):** MUST be zero, and MUST be ignored + +**B - fRel (1 bit):** A bit that specifies whether [**relative references**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) are used in the elements of **array**. + +**array (variable):** An array of [RgceElfLocExtra](#rgceelflocextra) elements that specifies the sequence of [**cell references**](#gt_4d15aeb2-3a7d-44d7-b8d1-8a441f1cc24f) that specifies the multiple-cell natural language label. The number of elements MUST be equal to **count**. + +#### PtgExtraMem + +The **PtgExtraMem** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that corresponds to a [PtgMemArea](#ptgmemarea) as specified in [RgbExtra](#rgbextra). + +[TABLE] + +**count (2 bytes):** An unsigned integer that specifies the areas within the range. + +**array (variable):** An array of [Ref8U](#ref8u) that specifies the range. The number of elements MUST be equal to **count**. + +#### PtgFunc + +The **PtgFunc** structure specifies a call to a function with a fixed number of parameters, as defined in [function-call](#rgce). + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x01. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**iftab (2 bytes):** A [Ftab](#ftab) that specifies the function to be called. MUST specify a function with a fixed number of parameters. + +#### PtgFuncVar + +The **PtgFuncVar** structure specifies a call to a function with a variable number of parameters as defined in [function-call](#rgce). + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x02 + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be 0, MUST be ignored. + +**cparams (1 byte):** An unsigned integer that specifies the number of parameters. MUST be within the range defined for the function specified by **tab.** + +**tab (15 bits):** A structure that specifies the function to be called. If **fCeFunc** is 1, then this field specifies a [**Cetab**](#cetab) value. If **fCeFunc** is 0, then this field specifies a [**Ftab**](#ftab) value. + +**C - fCeFunc (1 bit):** A bit that specifies whether **tab** specifies a **Cetab** value or a **Ftab** value. + +#### PtgGe + +The **PtgGe** structure specifies a [binary-value-operator](#rgce) that compares whether the first expression in a binary-value-expression is greater than or equal to the second. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x0C. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgGt + +The **PtgGt** structure specifies a [binary-value-operator](#rgce) that compares whether the first expression in a binary-value-expression is greater than the second. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x0D. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgInt + +The **PtgInt** [operand](#rgce) specifies an unsigned integer value. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x1E. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**integer (2 bytes):** An unsigned integer that specifies the value. + +#### PtgIsect + +The **PtgIsect** structure specifies a [binary-reference-operator](#rgce) that intersects the first expression in a binary-reference-expression with the second. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x0F. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgLe + +The **PtgLe** structure specifies a [binary-value-operator](#rgce) that compares whether the first expression in a binary-value-expression is less than or equal to the second. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x0A. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgLt + +The **PtgLt** structure specifies a [binary-value-operator](#rgce) that compares whether the first expression in a binary-value-expression is less than the second. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x09. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgMemArea + +The **PtgMemArea** [mem token](#Section_0e7857a5d73a4abaafdaaa3996f562fd) specifies that the result of a [binary-reference-expression](#rgce) in a mem-area-expression is a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). The [RgbExtra](#rgbextra) corresponding to this structure MUST contain a [PtgExtraMem](#ptgextramem) that specifies the range of cells. + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x06. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**unused (4 bytes):** Undefined and MUST be ignored. + +**cce (2 bytes):** An unsigned integer that specifies the count of bytes in the binary-reference-expression following this structure. + +#### PtgMemErr + +The **PtgMemErr** [mem token](#Section_0e7857a5d73a4abaafdaaa3996f562fd) specifies that the result of a [binary-reference-expression](#rgce) in a mem-area-expression is an error code. + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x07. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**err (1 byte):** A [BErr](#berr) that specifies the error code value. + +**unused1 (1 byte):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +**cce (2 bytes):** An unsigned integer that specifies the count of bytes in the binary-reference-expression following this structure. + +#### PtgMemFunc + +The **PtgMemFunc** [mem token](#Section_0e7857a5d73a4abaafdaaa3996f562fd) specifies that the result of a [binary-reference-expression](#rgce) in a mem-area-expression is variable. + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x09. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**cce (2 bytes):** An unsigned integer that specifies the count of bytes in the binary-reference-expression following this structure. + +#### PtgMemNoMem + +The **PtgMemNoMem** [mem token](#Section_0e7857a5d73a4abaafdaaa3996f562fd) specifies that the result of the [binary-reference-expression](#rgce) in a mem-area-expression failed to cache. + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x08. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**unused (4 bytes):** Undefined and MUST be ignored. + +**cce (2 bytes):** An unsigned integer that specifies the count of bytes in the binary-reference-expression following this structure. + +#### PtgMissArg + +The **PtgMissArg** [operand](#rgce) specifies a missing value. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x16. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgMul + +The **PtgMul** structure specifies a [binary-value-operator](#rgce) that multiplies the first and second expressions in a binary-value-expression. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x05. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgName + +The **PtgName** [operand](#rgce) specifies a reference to a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) in the same [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) as the containing Rgce. + +If the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing this structure is part of a revision as specified in the Formulas overview, then there MUST be a [RevNameTabid](#revnametabid) in the [RgbExtra](#rgbextra) corresponding to this PtgName, which specifies those defined name. + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x03. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the required data type for the value of the [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**nameindex (4 bytes):** If the formula containing this structure is part of a revision as specified in the Formulas overview, then this value is undefined and MUST be ignored. Otherwise it is an unsigned integer that specifies a one-based index of a [Lbl](#lbl) record in the collection of Lbl records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The referenced Lbl specifies the referenced defined name. MUST be greater than 0 and less than or equal to the number of Lbl records in the workbook. + +#### PtgNameX + +The **PtgNameX** structure specifies a reference to a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) in an [external workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc). + +If the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing this structure is part of a revision as specified in the Formulas overview, then there MUST be a [RevName](#revname) in the [RgbExtra](#rgbextra) corresponding to this PtgNameX that specifies the defined name. + +If the formula containing this structure is not part of a revision as specified in the Formulas overview (section 2.2.2), then the referenced defined name is specified by an [XtiIndex](#xtiindex). + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x19. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the required data type for the value of the [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**ixti (2 bytes):** If the formula containing this structure is not part of a revision as specified in the Formulas overview, this value is an XtiIndex that specifies the [XTI](#xti) that specifies the referenced defined name. + +If the formula containing this structure is part of a revision as specified in the Formulas overview, this value is undefined and MUST be ignored. + +**nameindex (4 bytes):** If the formula containing this structure is not part of a revision as specified in the Formulas overview, this value is an unsigned integer that specifies the one-based index of an [ExternName](#externname) record in the collection of ExternName records directly following the [SupBook](#supbook) record referenced by **ixti**. The referenced ExternName and its associated records specify the referenced defined name. + +If the formula containing this structure is part of a revision as specified in the Formulas overview, this value is undefined and MUST be ignored. + +#### PtgNe + +The **PtgNe** structure specifies a [binary-value-operator](#rgce) that compares whether the second expression in a binary-value-expression is not equal to the first. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x0E. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgNum + +The **PtgNum** [operand](#rgce) specifies a floating-point value. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x1F + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**value (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the floating-point value. + +#### PtgParen + +The **PtgParen** [display token](#Section_44ae9bca374542a482095e7ded229789) specifies that parentheses are displayed around the expression in a [display-precedence-expression](#rgce). + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x15. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgPercent + +The **PtgPercent** structure specifies a [unary-operator](#rgce) which divides the expression in a unary-expression by 100. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x14. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgPower + +The **PtgPower** structure specifies a [binary-value-operator](#rgce) that raises the first expression in a binary-value-expression to the power of the second. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x07. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgRange + +The **PtgRange** structure specifies the range operation, where the minimum bounding rectangle of the first [expression](#rgce) and the second expression is generated. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x11. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgRef + +The **PtgRef** [operand](#rgce) specifies a reference to a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) as an [RgceLoc](#rgceloc). + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x04. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**loc (4 bytes):** A RgceLoc value that specifies the coordinates of the referenced cell. + +#### PtgRef3d + +The **PtgRef3d** [operand](#rgce) specifies a reference to a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on one or more [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +If the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing this structure is part of a revision as specified in the Formulas overview (section 2.2.2), then there MUST be a [RevExtern](#revextern) in the [RgbExtra](#rgbextra) corresponding to this PtgRef3d, which specifies those sheets. + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x1A. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the required data type for the value of the [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**ixti (2 bytes):** If the formula containing this structure is not part of a revision as specified in the Formulas overview, then this value is an [XtiIndex](#xtiindex) that specifies the [XTI](#xti) which specifies those sheets. Otherwise it is undefined and MUST be ignored. + +**loc (4 bytes):** A value that specifies coordinates of the referenced cell. If this PtgRef3d is part of a [NameParsedFormula](#nameparsedformula) then this is a [RgceLocRel](#rgcelocrel) value. Otherwise it is a [RgceLoc](#rgceloc) value. + +#### PtgRefErr + +The **PtgRefErr** [operand](#rgce) specifies an invalid reference to a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x0A. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +#### PtgRefErr3d + +The **PtgRefErr3d** [operand](#rgce) specifies an invalid reference to a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on one or more [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). If the [formula](#Section_a795978bfa7845788e2dc07d78edae0e) (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing this structure is part of a revision as specified in the Formulas overview (section 2.2.2), then there MUST be a [RevExtern](#revextern) in the [RgbExtra](#rgbextra) corresponding to this PtgRefErr3d, which specifies those sheets. + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x1C. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the required data type for the value of the [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**ixti (2 bytes):** If the formula containing this structure is not part of a revision as specified in the Formulas overview (section 2.2.2), then this value is an [XtiIndex](#xtiindex) that specifies the [XTI](#xti) which specifies those sheets. Otherwise it is undefined and MUST be ignored. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +#### PtgRefN + +The **PtgRefN** [operand](#rgce) specifies a reference to a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) as an [RgceLocRel](#rgcelocrel). + +[TABLE] + +**ptg (5 bits):** Reserved. MUST be 0x0C. + +**A - type (2 bits):** A [PtgDataType](#ptgdatatype) that specifies the data type for the value of this [Ptg](#ptg). + +**B - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**loc (4 bytes):** An RgceLocRel that specifies the referenced cell. + +#### PtgStr + +The **PtgStr** operand specifies a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string value. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x17. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**string (variable):** A [ShortXLUnicodeString](#shortxlunicodestring) value that specifies the string. + +#### PtgSub + +The **PtgSub** structure specifies a [binary-value operator](#rgce) that subtracts the second expression in a binary-value-expression from the first. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x04. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgSxName + +The **PtgSxName** structure specifies a reference to a [calculated field](#Section_4594f2ac815740b381142e77ba8efb7d) or a [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b) found in a [PivotParsedFormula](#pivotparsedformula). The [Rgce](#rgce) that contains this [Ptg](#ptg) MUST be part of the **formula** field of an [SxFmla](#sxfmla) record. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x18. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**eptg (1 byte):** Reserved. MUST be 0x1D. + +**sxIndex (4 bytes):** An unsigned integer that specifies the zero-based index of an [SxName](#sxname) record in the collection of SxName records following an SxFmla record. MUST be less than the value of **formula.cSxName** in the SxFmla record. + +#### PtgTbl + +The **PtgTbl** structure specifies that the [Rgce](#rgce) that contains this PtgTbl is part of a [**data table (1)**](#gt_9e13d7ee-50d6-40ae-8789-29ecafe24bd4) or an [ObjectParsedFormula](#objectparsedformula). + +If the Rgce is not part of an ObjectParsedFormula, then there MUST be a [Table](#table) record in the current part where the **ref**.**rwFirst** field in Table is equal to **row** and the **ref**.**colFirst** field in Table is equal to **col**. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x02 + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +**row (2 bytes):** An unsigned integer that specifies the first row of the data table (1). MUST be less than 65536. If the Rgce that contains this PtgTbl is part of an ObjectParsedFormula, this field is undefined and MUST be ignored. + +**col (2 bytes):** An unsigned integer that specifies the first column of the data table (1). MUST be less than 256. If the Rgce that contains this PtgTbl is part of an ObjectParsedFormula, this field is undefined and MUST be ignored. + +#### PtgUminus + +The **PtgUminus** structure specifies a [unary-operator](#rgce) which generates the additive inverse of a unary-expression. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x13. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgUnion + +The **PtgUnion** structure specifies a [binary-reference-operator](#rgce) that specifies a union of the first expression in a binary-reference-expression with the second. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x10. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### PtgUplus + +The **PtgUplus** structure specifies a [unary-operator](#rgce) which leaves a unary-expression unchanged. + +[TABLE] + +**ptg (7 bits):** Reserved. MUST be 0x12. + +**A - reserved0 (1 bit):** MUST be zero, and MUST be ignored. + +#### RevExtern + +The **RevExtern** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) on a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) that is referenced by a [formula](#Section_a795978bfa7845788e2dc07d78edae0e) (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in a revision as specified in the Formulas overview (section 2.2.2). + +[TABLE] + +**book (variable):** Specifies the workbook based on the value of the first byte, according to the following table: + +| Value | Meaning | +|----|----| +| 0x01 | Specifies the current workbook. This field is two bytes in size. The second byte MUST be 0x02. | +| Any value except 0x01 | This field is a [VirtualPath](#virtualpath) that specifies the workbook. | + +**itabFirst (variable):** A [RevItab](#revitab) that specifies the first sheet in the range. + +**itabLast (variable):** A RevItab that specifies the last sheet in the range. + +#### RevItab + +The **RevItab** structure specifies a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) referenced by a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in a revision as specified in the Formulas overview (section 2.2.2). + +[TABLE] + +**type (1 byte):** An unsigned integer that specifies the sheet. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00 | Specifies a sheet on the same workbook. The **tabid** field specifies the sheet. | +| 0x01 | Specifies a sheet on a different workbook. The **sheet** field specifies the sheet. | +| 0x02 | Specifies the same sheet specified by the preceding RevItab. | +| 0x03 | Specifies a missing sheet. | + +**tabid (2 bytes):** An unsigned integer that specifies a sheet identifier in the current workbook. MUST match a sheet identifier specified by [RRTabId](#rrtabid). This field MUST be present if and only if **type** is 0x00. + +**sheet (variable):** A [XLUnicodeString](#xlunicodestring) that specifies the sheet name. This field MUST be present if and only if **type** is 0x01. + +#### RevLblName + +The **RevLblName** structure specifies the name of a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) that is referenced by a formula in a revision as specified in the Formulas overview (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)). + +[TABLE] + +**iBuiltin (1 byte):** An unsigned integer that specifies whether the defined name is a [**built-in name**](#gt_d40a51df-e96f-45ec-885d-6f936d172b39), and if so, which built-in name it is. The value MUST be from the following table: + +| Value | Meaning | +|-------|------------------------------| +| 0x00 | This is not a built-in name. | +| 0x01 | Consolidate_Area | +| 0x02 | Auto_Open | +| 0x03 | Auto_Close | +| 0x04 | Extract | +| 0x05 | Database | +| 0x06 | Criteria | +| 0x07 | Print_Area | +| 0x08 | Print_Titles | +| 0x09 | Recorder | +| 0x0A | Data_Form | +| 0x0B | Auto_Activate | +| 0x0C | Auto_Deactivate | +| 0x0D | Sheet_Title | +| 0x0E | \_FilterDatabase | + +**st (variable):** If **iBuiltin** is 0x00, then **st** is an [XLNameUnicodeString](#xlnameunicodestring) that specifies the name of the defined name. Otherwise, **st** is an [XLUnicodeString](#xlunicodestring) and the name of the defined name is specified as the concatenation of built-in name specified by **iBuiltin** and **st.** The concatenated string MUST match grammar specified for XLNameUnicodeString. + +#### RevName + +The **RevName** structure specifies a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) referenced by a [formula](#Section_a795978bfa7845788e2dc07d78edae0e) (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in a revision as specified in the Formulas overview (section 2.2.2). + +[TABLE] + +**book (variable):** Specifies the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) based on the value of the first byte, according to the following table: + +| Value | Meaning | +|----|----| +| 0x01 | Specifies the current workbook. This field is two bytes in size. The second byte MUST be 0x02. | +| Any value except 0x01 | This field is a [VirtualPath](#virtualpath) that specifies the workbook. | + +**fExtern (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies whether the defined name is defined in the current workbook. MUST be 0x00 if the first byte of **book** is 0x01, and 0x01 otherwise. + +**name (variable):** A [RevNameTabid](#revnametabid) that specifies the name and the scope of the defined name. This field MUST be present if and only if **fExtern** is 0x00. + +**externName (variable):** A [RevNamePly](#revnameply) that specifies the name and the scope of the defined name. This field MUST be present if and only if **fExtern** is 0x01. + +#### RevNamePly + +The **RevNamePly** structure specifies a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) in an [external workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc) that is referenced by a [formula](#Section_a795978bfa7845788e2dc07d78edae0e) (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in a revision as specified in the Formulas overview (section 2.2.2), and the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) on which it is defined. + +[TABLE] + +**sheet (variable):** A [RevSheetName](#revsheetname) that specifies the sheet on which the defined name is defined. + +**name (variable):** A [RevLblName](#revlblname) that specifies the defined name. + +#### RevNameTabid + +The **RevNameTabid** structure specifies a non-external [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) that is referenced by a [formula](#Section_a795978bfa7845788e2dc07d78edae0e) (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in a revision as specified in the Formulas overview (section 2.2.2). + +[TABLE] + +**tabid (2 bytes):** An unsigned integer that specifies the scope of the defined name. The value MUST be from the following table: + +| Value | Meaning | +|----|----| +| 0xFFFF | Specifies that the scope is the entire [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). | +| Greater than or equal to 1 and less than 0xFFFF | Specifies that the scope is a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) from the workbook. The value is a sheet identifier which MUST match a sheet identifier specified by [RRTabId](#rrtabid) in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). | + +**name (variable):** A [RevLblName](#revlblname) that specifies the name of the defined name. + +#### RevSheetName + +The **RevSheetName** structure specifies the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) or [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) on which a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) is defined, for a defined name that is referenced by a [formula](#Section_a795978bfa7845788e2dc07d78edae0e) (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in a revision as specified in the Formulas overview (section 2.2.2). + +[TABLE] + +**sheet (variable):** A [XLUnicodeString](#xlunicodestring) that specifies the name of the sheet. The length of the string MUST be less than or equal to 31 characters. This field specifies the entire workbook if the length of the string is zero. + +#### RgbExtra + +The **RgbExtra** structure specifies a set of structures, laid out sequentially in the file, that correspond to and MUST exist for certain [Ptg](#ptg)s in the [Rgce](#rgce). The order of the structures MUST be the same as the order of the Ptgs in the Rgce that they correspond to. + +The following Ptgs MUST have a corresponding structure in an RgbExtra. + +| Ptg | Required structure in an RgbExtra | +|-----------------------------------|-----------------------------------| +| [PtgArray](#ptgarray) | [PtgExtraArray](#ptgextraarray) | +| [PtgMemArea](#ptgmemarea) | [PtgExtraMem](#ptgextramem) | +| [PtgElfRadicalS](#ptgelfradicals) | [PtgExtraElf](#ptgextraelf) | +| [PtgElfColS](#ptgelfcols) | PtgExtraElf | +| [PtgElfColSV](#ptgelfcolsv) | PtgExtraElf | + +The following Ptgs MUST have a corresponding structure in an RgbExtra if and only if the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) containing that Ptg is part of a revision as specified in the Formulas overview (section 2.2.2). + +| Ptg | Required structure in an RgbExtra | +|-------------------------------|-----------------------------------| +| [PtgName](#ptgname) | [RevNameTabid](#revnametabid) | +| [PtgNameX](#ptgnamex) | [RevName](#revname) | +| [PtgRef3d](#ptgref3d) | [RevExtern](#revextern) | +| [PtgRefErr3d](#ptgreferr3d) | RevExtern | +| [PtgArea3d](#ptgarea3d) | RevExtern | +| [PtgAreaErr3d](#ptgareaerr3d) | RevExtern | + +[TABLE] + +**rgb (variable):** An array that contains the sequence of these structures. + +#### Rgce + +The **Rgce** structure specifies a set of [Ptg](#ptg)s, laid out sequentially in the file. + +The sequence of Ptgs MUST adhere to the following grammar. + +EXPRESSION_SIZE is the sum of the sizes of a contiguous set of Ptgs in bytes. + +The ACTUAL_PTG_SIZE of a Ptg is as follows: + +[TABLE] + +The ACTUAL_EXPRESSION_SIZE of a contiguous set of Ptgs is the sum of ACTUAL_PTG_SIZEs of those Ptgs. The ACTUAL_EXPRESSION_SIZE of all Ptgs in an Rgce MUST be less than or equal to 1800. + +rgce = [PtgExp](#ptgexp) / [PtgTbl](#ptgtbl) / \[[PtgAttrBaxcel](#ptgattrbaxcel) / [PtgAttrSemi](#ptgattrsemi) / [PtgAttrSpaceSemi](#ptgattrspacesemi)\] expression + +expression = \*[PtgAttrSpace](#ptgattrspace) base-expression + +The value of the **type** field of each PtgAttrSpace in an expression MUST be 0, 1, or 6. + +base-expression = operand / unary-expression / binary-reference-expression / binary-value-expression / display-precedence-specifier / mem-area-expression / function-call + +operand = [PtgMissArg](#ptgmissarg) / PtgStr / [PtgErr](#ptgerr) / [PtgBool](#ptgbool) / [PtgInt](#ptgint) / [PtgNum](#ptgnum) / PtgArray / [PtgName](#ptgname) / PtgRef / PtgArea / PtgRefErr / PtgAreaErr / PtgRefN / PtgAreaN / [PtgNameX](#ptgnamex) / PtgRef3d / PtgArea3d / PtgRefErr3d / PtgAreaErr3d / [PtgElfLel](#ptgelflel) / [PtgElfRw](#ptgelfrw) / [PtgElfCol](#ptgelfcol) / [PtgElfRwV](#ptgelfrwv) / [PtgElfColV](#ptgelfcolv) / [PtgElfRadical](#ptgelfradical) PtgArea / PtgElfRadical PtgAreaErr / [PtgElfRadicalS](#ptgelfradicals) PtgArea / PtgElfRadicalS PtgAreaErr / [PtgElfColS](#ptgelfcols) / [PtgElfColSV](#ptgelfcolsv) / [PtgElfRadicalLel](#ptgelfradicallel) PtgArea / PtgElfRadicalLel PtgAreaErr / [PtgSxName](#ptgsxname) + +Each Ptg in this definition is an [operand token](#Section_011ec51c5e8742aea0a1f5ee242c1189). + +unary-expression = val unary-operator + +unary-operator = [PtgUplus](#ptguplus) / [PtgUminus](#ptguminus) / [PtgPercent](#ptgpercent) + +Each Ptg in this definition is an [operator token](#Section_0c6cc754f96f4061a9759d6eae97f8a3). + +binary-reference-expression = 2ref binary-reference-operator + +binary-reference-operator = [PtgIsect](#ptgisect) / [PtgUnion](#ptgunion) / [PtgRange](#ptgrange) + +Each Ptg in this definition is an operator token. + +binary-value-expression = 2val binary-value-operator + +binary-value-operator = [PtgAdd](#ptgadd) / [PtgSub](#ptgsub) / [PtgMul](#ptgmul) / [PtgDiv](#ptgdiv) / [PtgPower](#ptgpower) / [PtgConcat](#ptgconcat) / [PtgLt](#ptglt) / [PtgLe](#ptgle) / [PtgEq](#ptgeq) / [PtgGe](#ptgge) / [PtgGt](#ptggt) / [PtgNe](#ptgne) + +Each Ptg in this definition is an operator token. + +display-precedence-specifier = expression \[PtgAttrSpace\] [PtgParen](#ptgparen) + +The value of the **type** field of a PtgAttrSpace MUST be between 2 and 5 inclusive. + +PtgAttrSpace and PtgParen are [display tokens](#Section_44ae9bca374542a482095e7ded229789). + +mem-area-expression = mem-ptg binary-reference-expression + +The **cce** field in the Ptg of the mem-ptg rule MUST be equal to the EXPRESSION_SIZE of the Ptgs that comprise the binary-reference-expression. + +If mem-ptg is not [PtgMemFunc](#ptgmemfunc) then the expression elements in the binary-reference-expression MUST NOT contain any mem-ptg elements, [PtgFunc](#ptgfunc), [PtgFuncVar](#ptgfuncvar), PtgName, PtgNameX, PtgRef3d, PtgArea3d, PtgRefErr3d, or PtgAreaErr3d. + +mem-ptg = [PtgMemArea](#ptgmemarea) / [PtgMemErr](#ptgmemerr) / [PtgMemNoMem](#ptgmemnomem) / PtgMemFunc + +Each Ptg in this definition is a [mem token](#Section_0e7857a5d73a4abaafdaaa3996f562fd). + +function-call = if-expression / choose-expression / \[[params-fixed](#ftab)\] PtgFunc / params-variable PtgFuncVar / [params-cetab](#cetab) PtgFuncVar / expression [PtgAttrSum](#ptgattrsum) + +The params-fixed element MUST NOT be specified if PtgFunc specifies a function that takes no parameters. Otherwise, it MUST conform to the ABNF rule for the function specified by PtgFunc. + +if-expression = expression [PtgAttrIf](#ptgattrif) 1\*2(expression [PtgAttrGoto](#ptgattrgoto)) PtgFuncVar + +The value of the **offset** field in the PtgAttrIf MUST be equal to the EXPRESSION_SIZE of all Ptgs in the if-expression after the PtgAttrIf through the first PtgAttrGoto. + +The value of the **offset** field in each PtgAttrGoto MUST be equal to one less than the EXPRESSION_SIZE of all Ptgs remaining in the if-expression after that PtgAttrGoto. + +The value of the **fCeFunc** field of the PtgFuncVar MUST be zero. The value of the **tab** field of the PtgFuncVar MUST be 0x0001, which represents the IF function. + +choose-expression = expression [PtgAttrChoose](#ptgattrchoose) 1\*29(expression PtgAttrGoto) PtgFuncVar + +The value of the **cOffset** field in the PtgAttrChoose MUST be equal to the number of times the expression in the repeated sequence group appears. + +The first offset in the array of offsets in the **rgOffset** field in the PtgAttrChoose MUST be equal to four less than the size of the PtgAttrChoose in bytes. + +For the n^(th) occurrence of the repeated sequence group, the (n+1)^(th) offset in the array of offsets in the **rgOffset** field in the PtgAttrChoose MUST be equal to the EXPRESSION_SIZE of all Ptgs in the choose-expression after the PtgAttrChoose through the n^(th) PtgAttrGoto. + +The value of the **offset** field in each PtgAttrGoto MUST equal one less than the EXPRESSION_SIZE of all Ptgs remaining in the choose-expression after that PtgAttrGoto. + +The value of the **fCeFunc** field of the PtgFuncVar MUST be zero. The value of the **tab** field of the PtgFuncVar MUST be 0x0064, which represents the CHOOSE function. + +val = expression + +Additional restrictions are specified under VALUE_TYPE. The params-fixed, params-variable and params-cetab rules also use val. + +ref = expression + +Additional restrictions are specified under VALUE_TYPE. The params-fixed, params-variable and params-cetab rules also use ref. + +If the value of the **useselfs** field of the [UsesELFs](#useselfs) record is zero then an Rgce MUST NOT contain PtgElfLel, PtgElfRw, PtgElfCol, PtgElfRwV, PtgElfColV, PtgElfRadical, PtgElfRadicalS, PtgElfColS, PtgElfColSV, and PtgElfRadicalLel. + +PtgElfLel, PtgElfRw, PtgElfCol, PtgElfRwV, PtgElfColV, PtgElfRadical, PtgElfRadicalS, PtgElfColS, PtgElfColSV, and PtgElfRadicalLel SHOULD NOT[\<178\>](#Appendix_A_178) be used. + +Additional restrictions on the contents of this structure are specified in terms of a parse tree. For this purpose, a parse tree is a means of organizing the components of an Rgce. Each node in the parse tree represents a Ptg or an ABNF rule described previously. Non-leaf nodes represent rules and have one child node for each element in the rule. Leaf nodes represent only a Ptg. + +For a leaf node in the parse tree, NESTING_DEPTH is the number of function-call nodes in the path from the root node to that leaf. + +For a node in the parse tree, OPERAND_COUNT is as follows: + +- The OPERAND_COUNT of each Ptg appearing in the operand rule definition is one. + +- The OPERAND_COUNT of all other Ptgs is zero. + +- The OPERAND_COUNT of a node that has n child nodes with nonzero OPERAND_COUNT is equal to the maximum, across all the n child nodes, of (n-1) plus the OPERAND_COUNT of the n^(th) child that has nonzero OPERAND_COUNT. + +For a node in the parse tree, VALUE_TYPE is a state indicating that the node represents a single value of a simple type or an array of such values. A node that is not a VALUE_TYPE represents a reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). Elements in an expression MUST represent either values or references, based on the specific Ptgs used in the expression. The following rules specify how to traverse the parse tree from the bottom up and determine whether each node is a VALUE_TYPE, which determines whether the sequence of Ptgs comprising the formula correctly satisfies the requirements of each expression in the formula. A node is determined to be a VALUE_TYPE as follows: + +- Leaf nodes: + +  + +- PtgMissArg, PtgStr, PtgSxName, PtgErr, PtgBool, PtgInt, PtgNum, PtgArray, PtgRefErr, PtgAreaErr, PtgRefErr3d, PtgAreaErr3d, PtgElfLel, PtgElfRwV, PtgElfColV, PtgElfColSV, PtgElfRadicalLel, PtgUplus, PtgUminus, PtgPercent, PtgAdd, PtgSub, PtgMul, PtgDiv, PtgPower, PtgConcat, PtgLt, PtgLe, PtgEq, PtgGe, PtgGt, and PtgNe leaf nodes are VALUE_TYPEs. + +- PtgName, PtgRef, PtgArea, PtgRefN, PtgAreaN, PtgNameX, PtgRef3d, PtgArea3d, PtgFunc, PtgFuncVar, PtgMemArea, PtgMemErr, PtgMemNoMem, and PtgMemFunc leaf nodes are VALUE_TYPEs if and only if the value of the **type** field is value or array. + +- All other leaf nodes are not VALUE_TYPEs. + +  + +- Non-leaf nodes: + +  + +- Any non-leaf node with a single child node MUST be a VALUE_TYPE if and only if the child node is a VALUE_TYPE. + +- Any non-leaf node with a mem-ptg, unary-operator, binary-value-operator, binary-reference-operator, PtgAttrSum, PtgFunc or PtgFuncVar child node is a VALUE_TYPE if and only if that child node is a VALUE_TYPE. Other child nodes are ignored for the purposes of determining whether the non-leaf node is a VALUE_TYPE. + +- Any non-leaf node corresponding to a val rule MUST be a VALUE_TYPE. + +- Any non-leaf node corresponding to a ref rule MUST NOT be a VALUE_TYPE. + +- Otherwise, a non-leaf node with an expression child node is a VALUE_TYPE if and only if that expression child node is a VALUE_TYPE. + +A parse tree for an Rgce MUST meet the following conditions: + +- The NESTING_DEPTH of each leaf node MUST NOT exceed 8. + +- The OPERAND_COUNT of the root node MUST NOT exceed 40. + +[TABLE] + +**sequence (variable):** An array of Ptg that specifies the sequence of Ptgs. + +#### RgceArea + +The **RgceArea** structure specifies a reference to a rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) where [**relative references**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) are stored as coordinates. + +[TABLE] + +**rowFirst (2 bytes):** An [RwU](#rwu) that specifies the row number of the first row of the rectangular range of cells. + +**rowLast (2 bytes):** An RwU that specifies the row number of the last row of the rectangular range of cells. + +**columnFirst (2 bytes):** A [ColRelU](#colrelu) that specifies the column number of the first column of the rectangular range of cells and relative reference information. + +**columnLast (2 bytes):** A ColRelU that specifies the column number of the last column of the rectangular range of cells and relative reference information. + +#### RgceAreaRel + +The **RgceAreaRel** structure specifies a rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) where the relative portions of [**relative references**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) are specified as offsets from the cell in which the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) is evaluated. + +[TABLE] + +**rowFirst (2 bytes):** An [RwU](#rwu) that specifies information about the first row of the cell reference. If **columnFirst.rowRelative** is 0, then **rowFirst** specifies the first row coordinate of the cell reference. If **columnFirst.rowRelative** is 1, then **rowFirst** specifies the first row as an offset from the cell in which the formula is evaluated. + +**rowLast (2 bytes):** An RwU that specifies information about the last row of the cell reference. If **columnLast.rowRelative** is 0, then **rowLast** specifies the last row coordinate of the cell reference. If **columnLast.rowRelative** is 1, then **rowLast** specifies the last row as an offset from the cell in which the formula is evaluated. + +**columnFirst (2 bytes):** A [ColRelNegU](#colrelnegu) that specifies information about the first row and column in the range. If **columnFirst.colRelative** is 0, then **columnFirst.col** is an unsigned integer that specifies the first column coordinate of the cell reference and MUST be less than 256. If **columnFirst.colRelative** is 1, then **columnFirst.col** is a signed integer that specifies the first column as an offset from the cell in which the formula is evaluated. + +**columnLast (2 bytes):** A ColRelNegU that specifies information about the first row and column in the range. If **columnLast.colRelative** is 0, then **columnLast.col** is an unsigned integer that specifies the last column coordinate of the cell reference and MUST be less than 256. If **columnLast.colRelative** is 1, then **columnLast.col** is a signed integer that specifies the last column as an offset from the cell in which the formula is evaluated. + +#### RgceElfLoc + +The **RgceElfLoc** structure specifies a location of a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that contains a label used in a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) to refer to a contiguous [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells from the same row or column as the cell with the label. + +[TABLE] + +**row (2 bytes):** An [RwU](#rwu) that specifies the zero-based row coordinate of the cell. + +**column (2 bytes):** A [ColElfU](#colelfu) that specifies the zero-based column coordinate of the cell and other information about the cell reference. + +#### RgceElfLocExtra + +The **RgceElfLocExtra** structure specifies a single [**cell reference**](#gt_4d15aeb2-3a7d-44d7-b8d1-8a441f1cc24f) which specifies a part of a multiple-cell [**natural language label**](#gt_d93dd658-a3e7-4048-bbe0-788fae7887d5). The [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) is specified as the intersection of the given row and column. + +[TABLE] + +**row (2 bytes):** An [RwU](#rwu) that specifies the row coordinate of the cell reference. + +**column (2 bytes):** A [ColRelU](#colrelu) that specifies the column coordinate of the cell reference. The values of **column.colRelative** and **column.rowRelative** MUST be ignored. + +#### RgceLoc + +The **RgceLoc** structure specifies a reference to a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) where [**relative references**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) are stored as coordinates. + +[TABLE] + +**row (2 bytes):** An [RwU](#rwu) that specifies the row coordinate of the cell reference. + +**column (2 bytes):** A [ColRelU](#colrelu) that specifies the column coordinate of the cell reference and relative reference information. + +#### RgceLoc8 + +The **RgceLoc8** structure specifies a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) reference. + +[TABLE] + +**rgceLoc (4 bytes):** A [RgceLoc](#rgceloc) that specifies a single cell reference. + +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +#### RgceLocRel + +The **RgceLocRel** structure specifies a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) reference where the relative portions of [**relative references**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) are specified as offsets from the cell in which the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) is evaluated. + +[TABLE] + +**row (2 bytes):** An [RwU](#rwu) that specifies information about the row of the cell reference. If **column.rowRelative** is 0, then **row** specifies the row coordinate of the cell reference. If **column.rowRelative** is 1, then **row** specifies the row as an offset from the cell in which the formula is evaluated. If the signed result of the offset is a row index less than 0x00000000 or greater than 0x0000FFFF, the value is adjusted by 0x00010000 so that it will result in a valid row index. + +**column (2 bytes):** A [ColRelNegU](#colrelnegu) that specifies information about the row and column. If **column.colRelative** is 0, then **column.col** is an unsigned integer that specifies the column coordinate of the cell reference and MUST be less than 256. If **column.colRelative** is 1, then **column.col** is a signed integer that specifies the column as an offset from the cell in which the formula is evaluated. If the signed result of the offset is a column index less than 0x0000 or greater than 0x00FF, the value is adjusted by 0x0100 so that it will result in a valid column index. + +#### SerAr + +The **SerAr** structure specifies a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) value within an array of values. + +[TABLE] + +**blob (variable):** A structure that specifies a cell value. MUST be one of the following structures: [SerNil](#sernil), [SerNum](#sernum), [SerStr](#serstr), [SerBool](#serbool), or [SerErr](#sererr). The structure is specified by the first byte, which is the reserved byte in each of those structures. + +#### SerBool + +The **SerBool** structure specifies a Boolean (section [2.5.14](#boolean)) value in an array of values. + +[TABLE] + +**reserved1 (1 byte):** Reserved. MUST be 0x04. + +**f (1 byte):** A Boolean that specifies the value. + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +#### SerErr + +The **SerErr** structure specifies an error value in an array of values. + +[TABLE] + +**reserved1 (1 byte):** Reserved. MUST be 0x10. + +**err (1 byte):** A [BErr](#berr) that specifies the error code value. + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +#### SerNil + +The **SerNil** structure specifies a null value in an array of values. + +[TABLE] + +**reserved (1 byte):** MUST be zero, and MUST be ignored. + +**unused1 (4 bytes):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +#### SerNum + +The **SerNum** structure specifies a numeric value in an array of values. + +[TABLE] + +**reserved (1 byte):** Reserved. MUST be 0x01. + +**xnum (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the value. + +#### SerStr + +The **SerStr** structure specifies a string in an array of values. + +[TABLE] + +**reserved (1 byte):** Reserved. MUST be 0x02. + +**string (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the string. The length of the string MUST be less than 256 characters. + +#### SharedParsedFormula + +The **SharedParsedFormula** structure specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) for a shared formula. + +[TABLE] + +**cce (2 bytes):** An unsigned integer that specifies the length of **rgce** in bytes. MUST be greater than 0. + +**rgce (variable):** An [Rgce](#rgce) that specifies the sequence of [Ptg](#ptg)s for the formula. MUST NOT contain [PtgExp](#ptgexp), [PtgTbl](#ptgtbl), [PtgSxName](#ptgsxname), [PtgIsect](#ptgisect), [PtgUnion](#ptgunion), [PtgRange](#ptgrange), [PtgArray](#ptgarray), [PtgElfLel](#ptgelflel), [PtgElfRw](#ptgelfrw), [PtgElfCol](#ptgelfcol), [PtgElfRwV](#ptgelfrwv), [PtgElfColV](#ptgelfcolv), [PtgElfRadical](#ptgelfradical), [PtgElfRadicalS](#ptgelfradicals), [PtgElfColS](#ptgelfcols), [PtgElfColSV](#ptgelfcolsv), [PtgElfRadicalLel](#ptgelfradicallel), [PtgRefErr](#ptgreferr), [PtgAreaErr](#ptgareaerr), [PtgRef3d](#ptgref3d), [PtgArea3d](#ptgarea3d), [PtgRefErr3d](#ptgreferr3d), [PtgAreaErr3d](#ptgareaerr3d), [PtgNameX](#ptgnamex), [PtgMemArea](#ptgmemarea), [PtgMemErr](#ptgmemerr), [PtgMemNoMem](#ptgmemnomem), or [PtgMemFunc](#ptgmemfunc). + +If this field contains a [PtgRef](#ptgref), then the **loc.column.colRelative** and **loc.column.rowRelative** fields in the PtgRef MUST be 0. + +If this field contains a [PtgArea](#ptgarea), then the **area.columnFirst.colRelative**, **area.columnFirst.rowRelative**, **area.columnLast.colRelative**, and **area.columnLast.rowRelative** fields in the PtgArea MUST be 0. + +If this field contains a [PtgFuncVar](#ptgfuncvar) and the **fCeFunc** field of the PtgFuncVar is 0, then the **tab** field of PtgFuncVar MUST NOT be 0x017B. + +The root node of the parse tree of this field MUST be a VALUE_TYPE, as described in Rgce. + +**rgcb (variable):** An [RgbExtra](#rgbextra) that specifies ancillary data for the formula. + +#### XtiIndex + +**XtiIndex** is a 2-byte unsigned integer that specifies an [XTI](#xti) record. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0xFFFF | Specifies an invalid XTI. | +| Greater than or equal to zero and less than 0xFFFF | Specifies a zero-based index of an XTI structure in the array specified by the **rgXTI** field of the [ExternSheet](#externsheet) record. The value MUST be less than the **cXTI** field of the ExternSheet record. | + +### PBT + +The **PBT** structure specifies information about a parameter in a [**query**](#gt_37fbc661-f744-48fa-9d8e-f34513cab9c2) that retrieves [**external data**](#gt_6eba82a0-dd74-46f6-90cc-3cf1b298d69e) for a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) or a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289). The values in this structure provide additional information about the related [ParamQry](#paramqry) record as specified by the **rgPbt** field in the [DBQueryExt](#dbqueryext) record that contains this structure. + +[TABLE] + +**pbt (3 bits):** An unsigned integer that specifies the location of the parameter value. MUST be the same as the **pbt** field in the related ParamQry record as specified by the **rgPbt** field in the DBQueryExt record that contains this structure. MUST be a value from the following table: + +| Value | Meaning | +|---:|----| +| 0x0 | The user is prompted for the value of the parameter. | +| 0x1 | The parameter value is specified in the query. | +| 0x2 | The parameter value is specified in a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). | + +**A - fAutoRefresh (1 bit):** A bit that specifies whether the query refreshes when the parameter value changes. If **pbt** is not equal to 0x2 then this bit MUST be zero, and MUST be ignored. + +**B - fNeedRefresh (1 bit):** A bit that specifies that the parameter value changed and the query was not refreshed. MUST be 0 if **pbt** is not equal to 0x2. + +**reserved (11 bits):** MUST be zero, and MUST be ignored. + +### PhRuns + +The **PhRuns** structure specifies a [**phonetic text run**](#gt_02ee536f-14c0-451a-9d66-111431897cac) that is displayed above a [**text run**](#gt_393612a7-9552-48b0-abf6-0371dbd6d553). + +[TABLE] + +**ichFirst (2 bytes):** A signed integer that specifies the zero-based index of the first character of the phonetic text run in the **rphssub.st** field of the [ExtRst](#extrst) structure that contains this PhRuns structure. MUST be greater than or equal to 0. + +**ichMom (2 bytes):** A signed integer that specifies the zero-based index of the first character of the text run in the **rgb** field of the [XLUnicodeRichExtendedString](#xlunicoderichextendedstring) that contains the ExtRst that contains this PhRuns that corresponds to the phonetic text run specified in **ichFirst**. **ichMom** specifies the location where the text run which phonetic text run specified in **ichFirst** applies to begins. MUST be greater than or equal to 0. + +**cchMom (2 bytes):** A signed integer that specifies the count of characters in the text run specified in **ichMom**. MUST be greater than or equal to 0. + +### Phs + +The **Phs** structure specifies the formatting information for a [**phonetic string**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77). + +[TABLE] + +**ifnt (2 bytes):** A [FontIndex](#fontindex) structure that specifies the font. + +**A - phType (2 bits):** An unsigned integer that specifies the type of the phonetic information. MUST be a value from the following table: + +| Value | Meaning | +|-------|----------------------------------------------------| +| 0x0 | Use narrow Katakana characters as phonetic string. | +| 0x1 | Use wide Katakana characters as phonetic string. | +| 0x2 | Use Hiragana characters as phonetic string. | +| 0x3 | Use any type of characters as phonetic string. | + +**B - alcH (2 bits):** An unsigned integer that specifies the alignment of the phonetic string. MUST be a value from the following table: + +| Value | Alignment | +|-------|-----------------------| +| 0x0 | General alignment | +| 0x1 | Left aligned | +| 0x2 | Center aligned | +| 0x3 | Distributed alignment | + +**unused (12 bits):** Undefined and MUST be ignored. + +### PictFmlaEmbedInfo + +The **PictFmlaEmbedInfo** structure specifies information about the embedded control associated with the [Obj](#obj) record that contains the [ObjFmla](#objfmla) structure that contains this PictFmlaEmbedInfo. The embedded control can be an [**ActiveX control**](#gt_f3dcc35f-8f80-474e-ac39-106a23f059c2), an [**OLE object**](#gt_cdff9514-a3fb-4897-941d-4e99193a0096) or a [**camera picture**](#gt_ccb0da7f-aa4d-481c-b46c-e96c220869e1) control. The **pictFlags** field of this Obj record specifies the type of embedded control. + +[TABLE] + +**ttb (1 byte):** Reserved. MUST be 0x03. + +**cbClass (1 byte):** An unsigned integer that specifies the length in bytes of the **strClass** field. + +**reserved (1 byte):** MUST be zero, and MUST be ignored. + +**strClass (variable):** An optional [XLUnicodeStringNoCch](#xlunicodestringnocch) structure that specifies the class name of the embedded control associated with this Obj. This field MUST exist if and only if **cbClass** is nonzero. + +### PictFmlaKey + +The **PictFmlaKey** structure specifies the runtime [**license key**](#gt_555fdaf4-dd5e-4ccb-bf55-56a7ba7ff56d) of the object and specifies the reference to a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that is linked to the picture [Obj](#obj) that contains this PictFmlaKey. + +[TABLE] + +**cbKey (4 bytes):** An unsigned integer that specifies the number of bytes in the **keyBuf** string[\<179\>](#Appendix_A_179). + +**keyBuf (variable):** An array of **cbKey** that specifies the license key for the [**ActiveX control**](#gt_f3dcc35f-8f80-474e-ac39-106a23f059c2). This field is passed to a license-aware object creation method. + +**fmlaLinkedCell (variable):** An [ObjFmla](#objfmla) that specifies a reference to the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) where the value of the first cell is linked to the current selection in this picture control. An empty formula, where **fmlaLinkedCell.cbFmla** equals zero, specifies there is no such cell linked to this picture control. + +**fmlaListFillRange (variable):** An ObjFmla that specifies the range used to populate the content of this picture control. The **fmlaListFillRange.cbFmla** field MUST be 0 unless there is a bindable property (as specified in [\[MS-OAUT\]](%5bMS-OAUT%5d.pdf#Section_bbb05720f72445c78d17f83c3d1a3961) section [2.2.49.5.2](http://msdn.microsoft.com/en-us/library/ac18004e-7af7-4feb-8ae6-d42e7a14267c/)) in the typelib of the ActiveX control that equals the GUID {0C733A7C-2A1C-11CE-ADE5-00AA0044773D}. + +### PivotCompProp + +The **PivotCompProp** structure specifies the properties of a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) string comparison. + +[TABLE] + +**fCompare (1 byte):** A Boolean (section [2.5.14](#boolean)) that specifies the type of string comparison. + +| Value | Meaning | +|----|----| +| 0x0000 | This is a wildcard pattern match. For the purposes of comparisons, the characters "?" and "\*" are used as wildcards. A "?" refers to any single character, and a "\*" refers to any number of characters. | +| 0x0001 | This is a simple string comparison. | + +**reserved1 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +### PositionMode + +The **PositionMode** structure specifies positioning mode for position information saved in a [Pos](#pos) record. + +| Name | Value | Meaning | +|----|----|----| +| **MDFX** | 0x0000 | Relative position to the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), in [**points**](#gt_d072e4da-7898-4227-8f25-9fe77db43571). | +| **MDABS** | 0x0001 | Absolute width and height in points. It can only be applied to the mdBotRt field of Pos. | +| **MDPARENT** | 0x0002 | Owner of Pos determines how to interpret the position data. | +| **MDKTH** | 0x0003 | Offset to default position, in 1/1000^(th) of the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) size. | +| **MDCHART** | 0x0005 | Relative position to the chart, in [SPRC](#Section_d5fc728e68de4972905a975bcef8c82d). | + +### ReadingOrder + +The **ReadingOrder** enumeration specifies the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361). + +| Name | Value | Meaning | +|---------------------------|-------|-----------------------------| +| **READING_ORDER_CONTEXT** | 0x00 | Context reading order | +| **READING_ORDER_LTR** | 0x01 | Left-to-right reading order | +| **READING_ORDER_RTL** | 0x02 | Right-to-left reading order | + +### Ref + +The **Ref** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on a given [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rwFirst (2 bytes):** An unsigned integer that specifies the first zero-based row index in the range. MUST be greater than or equal to the **rwMic** field of the [Dimensions](#dimensions) record and MUST be less than the **rwMac** field of the Dimensions record. MUST be less than or equal to **rwLast**. + +**rwLast (2 bytes):** An unsigned integer that specifies the last zero-based row index in the range. MUST be greater than or equal to the **rwMic** field of the Dimensions record and MUST be less than the **rwMac** field of the Dimensions record. MUST be greater than or equal to **rwFirst**. + +**colFirst (1 byte):** A [ColByte](#colbyte) structure that specifies the first zero-based column index in the range. MUST be less than or equal to **colLast**. + +**colLast (1 byte):** A ColByte structure that specifies the last zero-based column index in the range. MUST be greater than or equal to **colFirst**. + +### Ref8 + +The **Ref8** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rwFirst (2 bytes):** A [Rwx](#rwx) structure that specifies the first row in the range. The field **rwFirst.rw** MUST be less than or equal to **rwLast.rw**. + +**rwLast (2 bytes):** A Rwx structure that specifies the last row in the range. The field **rwLast.rw** MUST be greater than or equal to **rwFirst.rw**. If **rwFirst.rw** is 0 and **rwLast.rw** is 0xFFFF, the specified range includes all the rows in the sheet. + +**colFirst (2 bytes):** A [Colx](#colx) structure that specifies the first column in the range. The field **colFirst.col** MUST be less than or equal to **colLast.col**. + +**colLast (2 bytes):** A Colx structure that specifies the last column in the range. The field **colLast.col** MUST be greater than or equal to **colFirst.col**. If **colFirst.col** is 0 and **colLast.col** is 0xFF, the specified range includes all the columns in the sheet. + +### Ref8U + +The **Ref8U** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rwFirst (2 bytes):** A [RwU](#rwu) structure that specifies the zero-based index of the first row in the range. The value MUST be less than or equal to **rwLast**. + +**rwLast (2 bytes):** A RwU structure that specifies the zero-based index of the last row in the range. The value MUST be greater than or equal to **rwFirst**. + +**colFirst (2 bytes):** A [ColU](#colu) structure that specifies the zero-based index of the first column in the range. The value MUST be less than or equal to **colLast**, and MUST be less than or equal to 0x00FF. + +**colLast (2 bytes):** A ColU structure that specifies the zero-based index of the last column in the range. The value MUST be greater than or equal to **colFirst**, and MUST be less than or equal to 0x00FF. + +### Ref8U2007 + +The **Ref8U2007** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rwFirst (4 bytes):** An unsigned integer that specifies the zero-based index of the first row in the range. The value MUST be less than or equal to **rwLast** and MUST be less than or equal to 0xFFFF. + +**rwLast (4 bytes):** An unsigned integer that specifies the zero-based index of the last row in the range. The value MUST be greater than or equal to **rwFirst** and MUST be less than or equal to 0xFFFF. + +**colFirst (4 bytes):** An unsigned integer that specifies the zero-based index of the first column in the range. The value MUST be less than or equal to **colLast** and MUST be less than or equal to 0x00FF. + +**colLast (4 bytes):** An unsigned integer that specifies the zero-based index of the last column in the range. The value MUST be greater than or equal to **colFirst** and MUST be less than or equal to 0x00FF. + +### RefU + +The **RefU** structure specifies a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rwFirst (2 bytes):** A [RwU](#rwu) structure that specifies the first row in the range. The value MUST be less than or equal to **rwLast**. + +**rwLast (2 bytes):** A RwU structure that specifies the last row in the range. + +**colFirst (1 byte):** A [ColByteU](#colbyteu) structure that specifies the first column in the range. The value MUST be less than or equal to **colLast**. + +**colLast (1 byte):** A ColByteU structure that specifies the last column in the range. + +### RevisionType + +**RevisionType** is an integer that specifies the type of [revision record](#Section_9e91e8bce4f249b897d4741481349d1b). The value MUST be one of the following: + +| Name | Value | Meaning | +|----|----|----| +| **REVTINSRW** | 0x0000 | Insert Row. | +| **REVTINSCOL** | 0x0001 | Insert Column. | +| **REVTDELRW** | 0x0002 | Delete Row. | +| **REVTDELCOL** | 0x0003 | Delete Column. | +| **REVTMOVE** | 0x0004 | [**Cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) Move. | +| **REVTINSERTSH** | 0x0005 | Insert [**Sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). | +| **REVTSORT** | 0x0007 | Sort. | +| **REVTCHANGECELL** | 0x0008 | Cell Change. | +| **REVTRENSHEET** | 0x0009 | Rename Sheet. | +| **REVTDEFNAME** | 0x000A | [**Defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) Change. | +| **REVTFORMAT** | 0x000B | Format Revision. | +| **REVTAUTOFMT** | 0x000C | [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f) Revision. | +| **REVTNOTE** | 0x000D | [**Comment**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) Revision. | +| **REVTHEADER** | 0x0020 | Header (meta-data) Revision. | +| **REVTCONFLICT** | 0x0025 | Conflict. | +| **REVTADDVIEW** | 0x002B | [**Custom view**](#gt_2370d0f5-2cbd-4ded-8572-ef25f6e25cf4) Add. | +| **REVTDELVIEW** | 0x002C | Custom view Delete. | +| **REVTTRASHQTFIELD** | 0x002E | [**Query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) field Removal. | + +### RFX + +The **RFX** structure specifies a range of cells on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rwFirst (4 bytes):** A [Rw12](#rw12) that specifies the first row in the range. The value of **rwFirst.rw** MUST be less than or equal to **rwLast.rw**. + +**rwLast (4 bytes):** A Rw12 that specifies the last row in the range. The value of **rwLast.rw** MUST be greater than or equal to **rwFirst.rw**. + +**colFirst (4 bytes):** A [Col12](#col12) that specifies the first column in the range. The value of **colFirst.col** MUST be less than or equal to **colLast.col**. + +**colLast (4 bytes):** A Col12 that specifies the last column in the range. The value of **colLast.col** MUST be greater than or equal to **colFirst.col**. + +### RichTextStreamChecksumData + +The **RichTextStreamChecksumData** structure specifies the data used to compute the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the [RichTextStream](#richtextstream) record. This data can be obtained from [Text](#text) record, [FontX](#fontx) record, [Font](#font) record, [BRAI](#brai) record, and [ObjectLink](#objectlink) record associated with the RichTextStream record, as specified in RichTextStream. If no Text record is associated with the RichTextStream record, the Text record associated with the [DefaultText](#defaulttext) record MUST be used. If no Font record is associated with the RichTextStream record, the first Font record specified in the [global substream](#Section_ca4c174887294a93abb94602b3a01fb1) MUST be used. + +[TABLE] + +**fibFontInformation (variable):** A [RichTextStreamChecksumFontInformation](#richtextstreamchecksumfontinformation) structure that specifies the default [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information to use for the rich text string. + +**A - fAutoSize (1 bit):** A bit that specifies whether the font size is automatic. MUST be equal to 1 if the value of the **iFont** field of the related FontX record is 0. Otherwise, MUST be equal to 0. If no FontX record is associated with the RichTextStream record, MUST be equal to 0. + +**B - fAutoColor (1 bit):** A bit that specifies whether the foreground text color is determined automatically. MUST be equal to the value of the **fAutoColor** field of the related Text record. + +**C - fAutoMode (1 bit):** A bit that specifies if the background color is determined automatically. MUST be equal to the value of the **fAutoMode** field of the related Text record. + +**bTextRotation (8 bits):** An unsigned integer that specifies the text rotation. MUST be equal to the value of the **trot** field of the related Text record. + +**D - fAutoRot (1 bit):** MUST be zero. + +**E - reserved1 (1 bit):** MUST be 1, and MUST be ignored. + +**F - iReadingOrder (2 bits):** An unsigned integer that specifies the text [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361). MUST be equal to the value of the **iReadingOrder** field of the related Text record. + +**G - reserved2 (1 bit):** MUST be zero, and MUST be ignored. + +**H - fAttached (1 bit):** A bit that specifies whether the text position is absolute or attached. If the RichTextStream record is contained in the sequence of records that conforms to the [LD](#chart-sheet-substream) rule, this field MUST be 1. If the RichTextStream is not contained in the LD rule, and the **dlp** field of the associated Text record is set to 0xA, this field MUST be 1. Otherwise, it MUST be 0. + +**I - fUserPos (1 bit):** A bit that specifies whether the text position is automatic. If the value is 0, the text position is automatic. If the **dlp** field of the associated Text record is set to 0xA, this field MUST be 1. Otherwise, it MUST be 0. + +**J - bObjectType (4 bits):** An unsigned integer that specifies the object type. Based on the record the RichTextStream is associated with, the value MUST be from the following table: + +| Record associated with RichTextStream | Value | Meaning | +|----|----|----| +| [Chart](#chart-2) | 0x1 | Default text associated with the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). | +| [Axis](#axis-1) where **wType** is 0x0001 | 0x2 | [Attached label](#Section_9ac44e58af9940f4a99ace470eff0f5a) of the value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) (or the vertical value axis) in the primary axis group. | +| Axis where **wType** is 0x0000 | 0x3 | Attached label of the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) axis (or the horizontal value axis) in the primary axis group. | +| [Series](#series-1) | 0x4 | Attached label of the [series](#Section_527ce4dfc9f84e50a314d4b07519593c). | +| [Legend](#legend-1) | 0x5 | Attached label of the [legend](#Section_1832229b7d1945f488d455e9c07466f0). | +| Axis where **wType** is 0x0003 | 0x7 | Attached label of the series axis. | +| Second Axis record where **wType** is 0x0001 | 0x8 | Attached label of the value axis (or the vertical value axis) in the secondary axis group. | +| Second Axis record where **wType** is 0x0000 | 0x9 | Attached label of the category axis (or the horizontal value axis) in the secondary axis group. | +| [DataTable](#dat) | 0xB | Attached label of the chart DataTable. | +| [YMult](#ymult) | 0xC | Attached label of the axis multiplier. | + +**K - fBuildable (1 bit):** A bit that specifies whether the text value of the Text record associated with the RichTextStream is automatically generated and unchanged. MUST be equal to the value of the **fAutoText** field of the related Text record. + +**L - reserved3 (1 bit):** MUST be zero, and MUST be ignored. + +**bSeriesIdentifier (8 bits):** An unsigned integer that specifies the zero-based index of the Series record of the current chart to which the attached label is attached. + +**M - reserved4 (2 bits):** MUST be 0x3, and MUST be ignored. + +**N - fReference (2 bits):** An unsigned integer that specifies the type of data that is being referenced. MUST be equal to the value of the **rt** field of the BRAI record associated with the RichTextStream. + +**O - stSource (4 bits):** An unsigned integer that specifies the part of the series, [trendline](#Section_61d74ebc36714d6dbdc0626db604530d), or [error bars](#Section_762a461d0a45474ebd7d5994bb294af2) the referenced data of the BRAI record associated with the RichTextStream specifies. MUST be equal to the value of the **id** field of the BRAI record associated with the RichTextStream. + +**bTextFormat (8 bits):** An [IFmt](#ifmt) that specifies the number formatting used for the data. MUST be equal to the value of the **ifmt** field of the BRAI record associated with the RichTextStream. + +**StText (variable):** An array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters that contains the text content of the rich text. This field only takes the text content into consideration and ignores the size and header fields of the text string. If the RichTextStream is associated with a BRAI record, the text value MUST correspond to the text value identified by the BRAI record. If the RichTextStream record is associated with an ObjectLink record, the text value MUST correspond to the text value identified by the ObjectLink record. + +**fibFontInformationArray (variable):** An array of [RichTextStreamChecksumFontInformationArrayItem](#richtextstreamchecksumfontinformationarrayitem) that specifies the formatting of the **StText** field. + +### RichTextStreamChecksumFontInformation + +The **RichTextStreamChecksumFontInformation** structure specifies the data used to compute the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the [RichTextStream](#richtextstream) record. This data can be obtained from [Text](#text) and [Font](#font) records associated with the RichTextStream record, as specified in RichTextStream. If no Text record is associated with the RichTextStream record, the Text record associated with the [DefaultText](#defaulttext) record MUST be used. If no Font record is associated with the RichTextStream record, the first Font record specified in the [global substream](#Section_ca4c174887294a93abb94602b3a01fb1) MUST be used. + +[TABLE] + +**stFontName (variable):** An array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters that contains the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) name. MUST be the font name specified by the **fontName** field of the related Font record. + +**dwFontHeight (4 bytes):** An unsigned integer that specifies the font height. MUST equal the value specified by the **dyHeight** field of the related Font record. + +**A - fBold (1 bit):** A bit that specifies whether the font is bold. The value of this field MUST be 1 when the value of the **bls** field of the associated Font record is greater than 400. + +**B - fItalic (1 bit):** A bit that specifies whether the font is italic. MUST equal the value specified by the **fItalic** field of the related Font record. + +**C - fUnderline (1 bit):** A bit that specifies whether the font is single-underlined. The value of this field MUST be 1 when the value of the **uls** field of the associated Font record is not equal to 0x00. + +**D - fOutline (1 bit):** A bit that specifies whether the font has an [**outline effect**](#gt_4e818802-fdc1-4227-b32f-1a3cb0943de7) applied. MUST equal the value specified by the **fOutline** field of the related Font record. + +**E - fShadow (1 bit):** A bit that specifies whether the font has a [**shadow effect**](#gt_83056968-00f2-463b-abc6-607dbb242cbf) applied. MUST equal the value specified by the **fShadow** field of the related Font record. + +**F - fCondense (1 bit):** A bit that specifies whether the font is condensed. MUST equal the value specified by the **fCondense** field of the related Font record. + +**G - fExtend (1 bit):** A bit that specifies whether the font is extended. MUST equal the value specified by the **fExtend** field of the related Font record + +**H - fStrikeout (1 bit):** A bit that specifies whether the font has [**strikethrough formatting**](#gt_b16d9600-aebb-4a4f-bf14-c38e13c11c14) applied. MUST equal the value specified by the **fStrikeOut** field of the related Font record. + +**I - fRegular (1 bit):** A bit that specifies whether the font is a regular font. MUST equal 1. + +**J - fJon (1 bit):** A bit that specifies whether the font is too small to be displayed. MUST equal 1 if the font height in [**pixels**](#gt_fe932605-d3bc-442f-9239-594676bce6ba) is less than 6. + +**K - fDialogBox (1 bit):** A bit that specifies whether the font is used in the context of a dialog box. MUST equal 0. + +**reserved1 (5 bits):** MUST be zero, and MUST be ignored. + +**boldness (2 bytes):** An unsigned integer that specifies the font weight. MUST equal the value specified by the **bls** field of the related Font record. + +**subscript (2 bytes):** An unsigned integer that specifies whether superscript, subscript, or normal script is used. MUST equal the value specified by the **sss** field of the related Font record. + +**bUnderline (1 byte):** An unsigned integer that specifies the underline style. MUST equal the value specified by the **uls** field of the related Font record. + +**bFamily (1 byte):** An unsigned integer that specifies the [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2) of this font. MUST equal the value specified by the **bFamily** field of the related Font record. + +**bCharset (1 byte):** An unsigned integer that specifies the [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204). MUST equal the value specified by the **bCharSet** field of the related Font record. + +**reserved2 (1 byte):** MUST be zero, and MUST be ignored. + +**rgbFontColor (4 bytes):** A [LongRGB](#longrgb) that specifies the font color. MUST equal the color specified by the **icv** field of the related Font record. + +**dwDrawingMode (4 bytes):** An unsigned integer that specifies the display mode of the background of the text. MUST be equal to 0x0000010D when the **wBkgMode** field of the related Text record is equal to 0x0001; otherwise, it MUST be equal to 0x0000020D. + +### RichTextStreamChecksumFontInformationArrayItem + +The **RichTextStreamChecksumFontInformationArrayItem** structure specifies data used to compute the checksum of the [RichTextStream](#richtextstream) record. + +[TABLE] + +**iIndex (2 bytes):** An unsigned integer that specifies a zero-based index of the character within the **StText** field of the containing [RichTextStreamChecksumData](#richtextstreamchecksumdata) structure where the text formatting specified in **fibFontInformation** begins. + +**fibFontInformation (variable):** A [RichTextStreamChecksumFontInformation](#richtextstreamchecksumfontinformation) that specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) formatting of the text string starting at the **iIndex** character. + +### RkNumber + +The **RkNumber** structure specifies a numeric value. + +[TABLE] + +**A - fX100 (1 bit):** A bit that specifies whether **num** is the value of the RkNumber or 100 times the value of the RkNumber. MUST be a value from the following table: + +| Value | Meaning | +|-------|---------------------------------------------------------------| +| 0 | The value of RkNumber is the value of **num**. | +| 1 | The value of RkNumber is the value of **num** divided by 100. | + +**B - fInt (1 bit):** A bit that specifies the type of **num**. + +**num (30 bits):** A variable type field whose type and meaning is specified by the value of **fInt**, as defined in the following table: + +| Value of fInt | Type of num | +|----|----| +| 0 | **num** is the 30 most significant bits of a 64-bit binary floating-point number as defined in [\[IEEE754\]](https://go.microsoft.com/fwlink/?LinkId=89903). The remaining 34-bits of the floating-point number MUST be 0. | +| 1 | **num** is a signed integer. | + +### RkRec + +The **RkRec** structure contains the numeric data in an application-specific internal type for optimizing disk and memory space along with the corresponding [IXFCell](#ixfcell) to the style record. + +[TABLE] + +**ixfe (2 bytes):** An IXFCell that specifies the format of the numeric value. + +**RK (4 bytes):** An [RkNumber](#rknumber) that specifies the numeric value. + +### RPHSSub + +The **RPHSSub** structure specifies a [**phonetic string**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77). + +[TABLE] + +**crun (2 bytes):** An unsigned integer that specifies the number of [**phonetic text runs**](#gt_02ee536f-14c0-451a-9d66-111431897cac). MUST be less than or equal to 32767. If **crun** is zero, there is one phonetic text run. + +**cch (2 bytes):** An unsigned integer that specifies the number of characters in the phonetic string. MUST be less than or equal to 32767. + +**st (variable):** An [LPWideString](#lpwidestring) that specifies the phonetic string. The character count in the string MUST be **cch**. + +### RRD + +The **RRD** structure specifies the [revision record](#Section_9e91e8bce4f249b897d4741481349d1b) information used to track changes in a [shared workbook](#Section_e45a62c4490f4304a09668908b57dacc). + +[TABLE] + +**cbMemory (4 bytes):** An unsigned integer that specifies the size in bytes of the corresponding revision record structure in memory. This is different from the size of the structure written to the file. The value MUST be greater than or equal to 26. MUST be ignored if the current record is [RRDHead](#rrdhead). + +**revid (4 bytes):** A signed integer that specifies the revision identifier of the revision records. This identifier is used to keep track of the order of revision records. MUST be greater than or equal to 0. + +**revt (2 bytes):** A [RevisionType](#revisiontype) that specifies the type of revision record. + +**A - fAccepted (1 bit):** A bit that specifies whether this revision was reviewed and accepted. + +**B - fUndoAction (1 bit):** A bit that specifies whether the revision occurred because of an undo action. + +**C - unused (1 bit):** Undefined and MUST be ignored. + +**D - fDelAtEdgeOfSort (1 bit):** A bit that specifies whether the row or column that is being deleted is at the edge of a sorted [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). If the value is 1, the current record MUST be [RRDInsDel](#rrdinsdel) and **revt** MUST be equal to **REVTINSRW** or **REVTINSCOL** or **REVTDELRW** or **REVTDELCOL**. + +**reserved (12 bits):** MUST be zero, and MUST be ignored. + +**tabid (2 bytes):** A [TabId](#tabid) that specifies the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) where the revision occurred. If the value is 0xFFFF, this revision does not correspond to a specific sheet. + +### RRDDefNameFlags + +The **RRDDefNameFlags** structure specifies additional information for [RRDDefName](#rrddefname). + +[TABLE] + +**cce (2 bytes):** An unsigned integer that specifies the length of a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) in RRDDefName. + +**A - fPli (1 bit):** A bit that specifies that one or more of the fields **stDescription**, **stHelpTopic**, **stCustomMenu**, **stStatusText**, **stDescriptionOld**, **stHelpTopicOld**, **stCustomMenuOld** or **stStatusTextOld** specified in the RRDDefName record MUST NOT be empty. + +**B - fFunc (1 bit):** A bit that specifies whether the RRDDefName record specifies a name that refers to a function. + +**fGrp (6 bits):** An unsigned integer that specifies the [**function category**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) for the [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). MUST be a value from the following table: + +| Value | Category | +|-------|---------------------------------------------------------------| +| 0 | All | +| 1 | Financial | +| 2 | Date Time | +| 3 | Math Trigonometry | +| 4 | Statistical | +| 5 | Lookup | +| 6 | Database | +| 7 | Text | +| 8 | Logical | +| 9 | Info | +| 10 | Commands | +| 11 | Customize | +| 12 | [**Macro**](#gt_cd2933d3-08d1-4931-bd5c-7ae0a668fe7c) Control | +| 13 | [**DDE**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) External | +| 14 | User Defined | + +**chKey (8 bits):** An unsigned integer that specifies the shortcut key. MUST have same restrictions as the **chKey** field from the [Lbl](#lbl) record. + +**C - fHidden (1 bit):** A bit that specifies whether the defined name is hidden. + +**D - fCustomMenu (1 bit):** A bit that specifies whether the **stCustomMenu** field from the RRDDefName record is not empty. + +**E - fDescription (1 bit):** A bit that specifies whether the **stDescription** field from the RRDDefName record is not empty. + +**F - fHelpTopic (1 bit):** A bit that specifies whether the **stHelpTopic** field from the RRDDefName record is not empty. + +**G - fStatusText (1 bit):** A bit that specifies whether the **stStatusText** field from the RRDDefName record is not empty. + +**reserved (11 bits):** MUST be zero, and MUST be ignored. + +### RRLoc + +The **RRLoc** structure specifies the location of a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rw (2 bytes):** A [RwU](#rwu) structure that specifies the zero-based index of the row. + +**col (2 bytes):** A [ColElfU](#colelfu) structure that specifies the zero-based index of the column and other information about this cell reference. + +### RTDEItem + +The **RTDEItem** structure specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) associated with an [**RTD topic**](#gt_1b5b3428-25ab-4aa9-bbee-c1c147ece9de). + +[TABLE] + +**rw (2 bytes):** A [Rw](#rw) structure that specifies the row index of the cell. + +**col (2 bytes):** A [Col](#col) structure that specifies the column index of the cell. + +**itab (2 bytes):** A [TabIndex](#tabindex) structure that specifies the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing the cell. + +### RTDOper + +The **RTDOper** structure specifies the variant data returned from an [**RTD server**](#gt_d4fc2cb5-c030-4ce4-9078-69627d562fc7) for [**real-time data (RTD)**](#gt_1e71aa16-cd0f-4271-b57d-1fd99d8740b6). + +[TABLE] + +**grbit (4 bytes):** An unsigned integer that specifies the type of the variant data stored in **rtdVt**. MUST be a value from the following table: + +| Value | rtdVt Data Type | Meaning | +|----|----|----| +| 0x00000001 | Xnum | The returned variant is an Xnum (section [2.5.342](#xnum)). | +| 0x00000002 | [RTDOperStr](#rtdoperstr) | The returned variant is a RTDOperStr. MUST be less than 256 characters long. | +| 0x00000004 | Boolean | The returned variant is a 4-byte Boolean (section [2.5.14](#boolean)) value. | +| 0x00000010 | Signed integer | The returned variant is a 4-byte signed integer indicating an error code. | +| 0x00000800 | Signed integer | The returned variant is a 4-byte signed integer used for purposes other than an error code. | +| 0x00001000 | RTDOperStr | The returned variant is a RTDOperStr. MUST be greater than or equal to 256 characters long. | + +**rtdVt (variable):** A structure that contains the variant data. The meaning of the data depends on the specific RTD server. The type of the variant data is specified by **grbit**. + +### RTDOperStr + +The **RTDOperStr** structure specifies a string used in a [**real-time data (RTD)**](#gt_1e71aa16-cd0f-4271-b57d-1fd99d8740b6) variant data structure. + +[TABLE] + +**cchRTDOperStr (4 bytes):** An unsigned integer that specifies the number of characters in **rgchRTDOperStr**. + +**rgchRTDOperStr (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) that specifies the string. + +### Run + +The **Run** structure specifies formatting information for a [**text run**](#gt_393612a7-9552-48b0-abf6-0371dbd6d553). + +[TABLE] + +**formatRun (4 bytes):** A [FormatRun](#formatrun). It specifies the formatting information of this run. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (2 bytes):** Undefined and MUST be ignored. + +### Rw + +The **Rw** structure specifies the zero-based row index of a row in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rw (2 bytes):** An unsigned integer that specifies the zero-based row index of a row in the sheet that contains this structure. MUST be greater than or equal to the **rwMic** field of the [Dimensions](#dimensions) record of the sheet that contains this structure and MUST be less than the **rwMac** field of the Dimensions record of the sheet that contains this structure. + +### Rw12 + +The **Rw12** structure specifies the zero-based row index of a row in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rw (4 bytes):** A signed integer that specifies a zero-based row index of the sheet. MUST be greater than or equal to zero and MUST be less than or equal to 0x0FFFFF. + +### RwLongU + +The **RwLongU** structure specifies the zero-based index of a row in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rw (4 bytes):** An unsigned integer that specifies the zero-based index of a row in the sheet that contains this structure. MUST be less than or equal to 0x0000FFFF. + +### RwU + +The **RwU** structure specifies the zero-based index of a row in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rw (2 bytes):** An unsigned integer that specifies the zero-based index of a row in the sheet that contains this structure. + +### Rwx + +The **Rwx** structure specifies the zero-based row index of a row in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**rw (2 bytes):** An unsigned integer that specifies the zero-based row index of a row in the sheet that contains this structure. MUST be 0, 0xFFFF, or greater than or equal to the **rwMic** field of the [Dimensions](#dimensions) record of the sheet that contains this structure and less than the **rwMac** field of the Dimensions record of the sheet that contains this structure. + +### Script + +The **Script** enumeration specifies the superscript or subscript style. + +| Name | Value | Meaning | +|--------------|--------|---------------| +| **SSSNONE** | 0x0000 | Normal script | +| **SSSSUPER** | 0x0001 | Superscript | +| **SSSSUB** | 0x0002 | Subscript | + +### SD_SetSortOrder + +The **SD_SetSortOrder** enumeration specifies the types of [MDX set metadata](#Section_84d4d0b542b6405ea07be3272dc517f8) sorting orders. + +| Name | Value | Meaning | +|----|----|----| +| **SSONONE** | 0x00 | No sorting order | +| **SSOASC** | 0x01 | Ascending order | +| **SSODESC** | 0x02 | Descending order | +| **SSOALPHAASC** | 0x03 | Ascending order by the caption | +| **SSOALPHADESC** | 0x04 | Descending order by the caption | +| **SSONATURALASC** | 0x05 | Ascending order by the natural order of the data, for example, by a key | +| **SSONATURALDESC** | 0x06 | Descending order by the natural order of the data, for example, by a key | + +### SDContainer + +The **SDContainer** structure specifies security information for a [FeatProtection](#featprotection) record. + +[TABLE] + +**cbSD (4 bytes):** An unsigned integer that specifies the size of the **sd** field in bytes. MUST be greater than 20. + +**sd (variable):** A [SecurityDescriptor](#securitydescriptor) that specifies the [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) data. + +### SecurityDescriptor + +A SECURITY_DESCRIPTOR structure, as defined in [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) section [2.4.6](http://msdn.microsoft.com/en-us/library/7d4dac05-9cef-4563-a058-f108abecce1d/), that specifies a [**relative security descriptor**](#gt_4a4a182d-a2d3-4cae-9a82-359ff9dc6b2c) that specifies security information associated with an object. For more information about relative security descriptors see [\[MSDN-ASRSD\]](https://go.microsoft.com/fwlink/?LinkId=119907). + +### ShapePropsStreamChecksumData + +The **ShapePropsStreamChecksumData** structure specifies the data used to compute the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the [ShapePropsStream](#shapepropsstream) record. + +[TABLE] + +**linePropertiesForChecksum (8 bytes):** A [LinePropertiesForShapePropsStreamChecksum](#linepropertiesforshapepropsstreamchecksum) that specifies the line properties data used to compute the checksum of the ShapePropsStream record. + +This field MUST be present in the following scenarios: + +- When the ShapePropsStream record and [LineFormat](#lineformat) record exist in a [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) but not in a sequence of records that conforms to the [LD](#chart-sheet-substream) rule or a sequence of records that conforms to the DROPBAR rule; + +- When the ShapePropsStream record and LineFormat record exist in a sequence of records that conforms to the FRAME rule; + +- When the ShapePropsStream record and LineFormat record exist in a sequence of records that conforms to the DROPBAR rule; + +- When the ShapePropsStream record and LineFormat record exist in a sequence of records that conforms to the AXS rule; + +- When the ShapePropsStream record and LineFormat record exist in a sequence of records that conforms to the SS rule and the **wObjContext** field of the ShapePropsStream record is 0x0000; + +This field MUST NOT be present otherwise. + +**interiorColorPropertiesForChecksum (9 bytes):** An [InteriorColorPropertiesForShapePropsStreamChecksum](#interiorcolorpropertiesforshapepropsstreamchecksum) that specifies the interior color data used to compute the checksum of the ShapePropsStream record. This field MUST be present in the following scenarios: + +- When the ShapePropsStream record and [AreaFormat](#areaformat) record exist in sequence of records that conforms to the FRAME rule and the fAuto field of the AreaFormat record is 0x0 and the [GelFrame](#gelframe) record does not exist in the sequence of records; + +- When the ShapePropsStream record and AreaFormat record exist in a sequence of records that conforms to the DROPBAR rule and the fAuto field of the AreaFormat record is 0x0 and the GelFrame record does not exist in the sequence of records; + +- When the ShapePropsStream record and AreaFormat record exist in a sequence of records that conforms to the AXS rule and the **wObjContext** field of the ShapePropsStream record is 0x0003 and the fAuto field of the AreaFormat record is 0x0 and the GelFrame record does not exist in the sequence of records; + +- When the ShapePropsStream record and AreaFormat record exist in a sequence of records that conforms to the SS rule and the fAuto field of the AreaFormat record is 0x0 and the GelFrame record does not exist in the sequence of records and the **wObjContext** field of the ShapePropsStream record is 0x0000; + +- When the ShapePropsStream record, AreaFormat record, and [MarkerFormat](#markerformat) record exist in a sequence of records that conforms to the SS rule and the GelFrame record does not exist in the sequence of records and the **wObjContext** field of the ShapePropsStream record is 0x0001. + +This field MUST NOT be present otherwise. + +**fillStylePropertiesForChecksum (variable):** A [FillStylePropertiesForShapePropsStreamChecksum](#fillstylepropertiesforshapepropsstreamchecksum) that specifies the fill-style data used to compute the checksum of the ShapePropsStream record. This field MUST be present in the following scenarios: + +- When the ShapePropsStream record, AreaFormat record, and GelFrame record exist in a sequence of records that conforms to the FRAME rule and the fAuto field of the AreaFormat record is 0x0; + +- When the ShapePropsStream record, AreaFormat record, and GelFrame record exist in a sequence of records that conforms to the DROPBAR rule and the fAuto field of the AreaFormat record is 0x0; + +- When the ShapePropsStream record, AreaFormat record, and GelFrame record exist in a sequence of records that conforms to the AXS rule and the **wObjContext** field of the ShapePropsStream record is 0x0003 and the fAuto field of the AreaFormat record is 0x0; + +- When the ShapePropsStream record, AreaFormat record, and GelFrame record exist in a sequence of records that conforms to the SS rule and the fAuto field of the AreaFormat record is 0x0 and the **wObjContext** field of the ShapePropsStream record is 0x0000; + +- When the ShapePropsStream record, AreaFormat record, MarkerFormat record, and GelFrame record sequence of records that conforms to the SS rule and the fAuto field of the AreaFormat record is 0x0 and the **wObjContext** field of the ShapePropsStream record is 0x0001. + +This field MUST NOT be present otherwise. + +### SharedFeatureType + +The **SharedFeatureType** enumeration specifies the different types of [Shared Features](#Section_86882c8e8d6d46b3aafe006b9e1f18e2). + +| Name | Value | Meaning | +|----|----|----| +| **ISFPROTECTION** | 0x0002 | Specifies the enhanced protection type. A Shared Feature of this type is used to protect a [**shared workbook**](#gt_241c4cae-c49a-438a-87dc-c8fb2c871921) by restricting access to the areas of the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and to the available functionality. | +| **ISFFEC2** | 0x0003 | Specifies the ignored formula errors type. A Shared Feature of this type is used to specify the formula errors to be ignored. | +| **ISFFACTOID** | 0x0004 | Specifies the [**smart tag**](#gt_2f57a49a-d503-4605-8798-0e53bd637609) type. A Shared Feature of this type is used to recognize certain types of entries (for example, proper names, dates/times, financial symbols) and flag them for action. | +| **ISFLIST** | 0x0005 | Specifies the list type. A Shared Feature of this type is used to describe a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) within a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). | + +### SheetExtOptional + +The **SheetExtOptional** structure specifies [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) specific data including [**sheet tab**](#gt_3b131045-238c-4ce8-9c22-b6aac874c7c5) color and the [**published**](#gt_8ffc383a-d4f1-4515-a8b5-874d84ab2d2b) state of this sheet. + +[TABLE] + +**icvPlain12 (7 bits):** An unsigned integer that specifies the tab color of this sheet. If the tab has a color assigned to it, the value of this field MUST be greater than or equal to 0x08 and less than or equal to 0x3F, as specified in the color table for [Icv](#icv). If this value does not equal to **icvPlain** of the associated [SheetExt](#sheetext), the value of **icvPlain** takes precedence. If the tab has no color assigned to it, the value of this field MUST be 0x7F, and MUST be ignored. + +**A - fCondFmtCalc (1 bit):** A bit that specifies whether [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) formulas are evaluated. MUST be one of the following: + +| Value | Meaning | +|----|----| +| 0 | Conditional formatting formulas in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) are not evaluated. | +| 1 | Conditional formatting formulas in this workbook are evaluated. | + +**B - fNotPublished (1 bit):** A bit that specifies whether this sheet is published. MUST be ignored when this sheet is a [chart sheet](#chart-sheet-substream), [dialog sheet](#dialog-sheet-substream), or [macro sheet](#macro-sheet-substream). MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------| +| 0 | The sheet is published. | +| 1 | The sheet is not published. | + +**reserved (23 bits):** MUST be zero, and MUST be ignored. + +**color (16 bytes):** A [CFColor](#cfcolor) that specifies the tab color. Used only when the tab color was not modified by earlier versions of the application. + +### ShortDTR + +The **ShortDTR** structure specifies date and time. The **year**, **month**, and **day** values MUST be consistent with the Gregorian calendar. + +[TABLE] + +**year (2 bytes):** An unsigned integer that specifies the year. MUST be greater than or equal to 1900 and less than or equal to 9999. + +**month (1 byte):** An unsigned integer that specifies the month. MUST be greater than or equal to 1 and less than or equal to 12. + +**day (1 byte):** An unsigned integer that specifies the day. MUST be greater than or equal to 1 and less than or equal to 31. + +**hour (1 byte):** An unsigned integer that specifies the hour. MUST be greater than or equal to 0 and less than or equal to 23. + +**minute (1 byte):** An unsigned integer that specifies the minute. MUST be greater than or equal to 0 and less than or equal to 59. + +**second (1 byte):** An unsigned integer that specifies the second. MUST be greater than or equal to 0 and less than or equal to 59. + +**weekday (1 byte):** An unsigned integer that specifies the weekday. The value MUST be one of the following: + +| Value | Meaning | +|-------|-------------------------------| +| 0 | The weekday is not specified. | +| 1 | Monday | +| 2 | Tuesday | +| 3 | Wednesday | +| 4 | Thursday | +| 5 | Friday | +| 6 | Saturday | +| 7 | Sunday | + +### ShortXLUnicodeString + +The **ShortXLUnicodeString** structure specifies a Unicode string. + +[TABLE] + +**cch (1 bytes):** An unsigned integer that specifies the count of characters in the string. + +**A - fHighByte (1 bit):** A bit that specifies whether the characters in **rgb** are double-byte characters. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | All the characters in the string have a high byte of 0x00 and only the low bytes are in **rgb**. | +| 0x1 | All the characters in the string are saved as double-byte characters in **rgb**. | + +**reserved (7 bits):** MUST be zero, and MUST be ignored. + +**rgb (variable):** An array of bytes that specifies the characters. If **fHighByte** is 0x0, the size of the array MUST be equal to the value of **cch**. If **fHighByte** is 0x1, the size of the array MUST be equal to the value of **cch\***2. + +### SLCO8 + +The **SLCO8** structure specifies a reference to a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a [SCENARIO](#scenario) record. + +[TABLE] + +**rw (2 bytes):** A [RwU](#rwu) structure that specifies the zero-based index of the row of the cell. + +**col (2 bytes):** A [ColSlco8U](#colslco8u) structure that specifies the zero-based index of the column of the cell and other information about this cell reference. + +### SortCond12 + +The **SortCond12** structure specifies the sort conditions. + +[TABLE] + +**A - fSortDes (1 bit):** A bit that specifies whether to sort in descending order. + +**sortOn (4 bits):** An unsigned integer that specifies the kind of sort to perform. MUST be a value listed in the Sort On Value column in the table for **condData**. + +**reserved (11 bits):** MUST be zero, and MUST be ignored. + +**rfx (16 bytes):** An [RFX](#rfx) that specifies the sort range of cells on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**condData (variable):** A structure that specifies the conditional data information. The data type of this structure depends on the value of the **sortOn** field and MUST be a value from the following table: + +| Sort On Value | Data Type | +|---------------|---------------------------------| +| 0x0 | [CondDataValue](#conddatavalue) | +| 0x1 | CondDataValue | +| 0x2 | CondDataValue | +| 0x3 | [CFFlag](#cfflag) | + +**cchSt (4 bytes):** A signed integer that specifies the character count in **stSslist**. MUST be greater than or equal to zero. MUST be zero and ignored if **sortOn** is not equal to zero. + +**stSslist (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch) that specifies the custom sort list string. It exists only if **cchSt** is greater than zero. + +### SortItem + +The **SortItem** structure specifies the sort mapping from the old row/column index (before sort action) to the new row/column index (after sort action). An array of these structures is contained within a [RRSort](#rrsort) record. + +[TABLE] + +**iNewIndex (4 bytes):** An unsigned integer that specifies the new zero-based index of row or column. If the **fCol** field of the RRSort record that contains this structure is zero, then this value is a zero-based row index and MUST be within the range of rows specified in the **ref8** field of the RRSort record that contains this structure. If the **fCol** field of the RRSort record that contains this structure is 1, then this value is a zero-based column index and MUST be within the range of columns specified in the **ref8** field of the RRSort record that contains this structure. + +**iOldIndex (4 bytes):** An unsigned integer that specifies the old zero-based index of row or column. If the **fCol** field of the RRSort record that contains this structure is zero, then this value is a zero-based row index and MUST be within the range of rows specified in the **ref8** field of the RRSort record that contains this structure. If the **fCol** field of the RRSort record that contains this structure is 1, then this value is a zero-based column index and MUST be within the range of columns specified in the **ref8** field of the RRSort record that contains this structure. + +### SourceType + +The **SourceType** enumeration specifies the source type for a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +| Name | Value | Meaning | +|----|----|----| +| **LTRANGE** | 0x00000000 | [**Range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) | +| **LTSHAREPOINT** | 0x00000001 | Read/write Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list | +| **LTXML** | 0x00000002 | [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) Mapper data | +| **LTEXTERNALDATA** | 0x00000003 | External [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) ([**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289))[\<180\>](#Appendix_A_180) | + +### SQElfFlags + +The **SQElfFlags** structure specifies additional undo data associated with a [**natural language formula**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b). + +[TABLE] + +**cLoc (30 bits):** An unsigned integer that specifies the number of elements in the **rgloc** field of the [Duce](#duce) structure that contains this structure. MUST be greater than or equal to 0x000000002 and less than or equal to 0x3FFFFFFF. + +**A - reserved (1 bit):** MUST be zero, and MUST be ignored. + +**B - fRel (1 bit):** A bit that specifies whether [**relative references**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac) are used. + +### SqRef + +The **SqRef** structure specifies a sequence of [Ref8](#ref8) structures on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**cref (2 bytes):** An unsigned integer that specifies the number of elements in **rgrefs**. MUST be less than or equal to 0x2000. + +**rgrefs (variable):** An array of Ref8 structures. The number of elements in the array MUST be equal to **cref**. + +### SqRefU + +The **SqRefU** structure specifies a sequence of [Ref8U](#ref8u) structures on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +[TABLE] + +**cref (2 bytes):** An unsigned integer that specifies the number of elements in **rgrefs**. MUST be less than or equal to 0x2000. + +**rgrefs (variable):** An array of Ref8U structures. The number of elements in the array MUST be equal to **cref**. + +### Stxp + +The **Stxp** structure specifies various formatting attributes of a [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). + +[TABLE] + +**twpHeight (4 bytes):** A signed integer that specifies the height of the font in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382). This value MUST be -1, 0, or between 20 and 8191. This value SHOULD NOT[\<181\>](#Appendix_A_181) be 0. A value of -1 specifies that this field is to be ignored. + +**ts (4 bytes):** A [Ts](#ts) that specifies additional formatting attributes. + +**bls (2 bytes):** A signed integer that specifies the font weight. This value MUST be 0, or a value from the following table. The value SHOULD NOT[\<182\>](#Appendix_A_182) be 0. + +| Value | Description | +|--------|----------------------------------------------------| +| 0xFFFF | Indicates that this specification is to be ignored | +| 0x0190 | Normal font weight | +| 0x02BC | Bold font weight | + +**sss (2 bytes):** A signed integer that specifies whether the superscript or subscript or normal style of the font is used. MUST be set to a value from the following table: + +| Value | Description | +|--------|----------------------------------------------------| +| 0xFFFF | Indicates that this specification is to be ignored | +| 0x0000 | Normal script | +| 0x0001 | Superscript | +| 0x0002 | Subscript | + +**uls (1 byte):** An unsigned integer that specifies the underline style. The value MUST be one of the following: + +| Value | Description | +|-------|-------------------------------------------------------------------| +| 0x00 | No underline | +| 0x01 | Single | +| 0x02 | Double | +| 0x21 | [**single accounting**](#gt_7ad49c0f-e183-47b5-bdbd-c23a5a8315fc) | +| 0x22 | [**double accounting**](#gt_89f4f531-9a8b-419c-8f51-98ef409b7bdf) | +| 0xFF | Indicates that this specification is to be ignored | + +**bFamily (1 byte):** An unsigned integer that specifies the [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2), as defined by Windows API LOGFONT structure in [\[MSDN-FONTS\]](https://go.microsoft.com/fwlink/?LinkId=90008). MUST be greater than or equal to 0 or less than or equal to 5. + +**bCharSet (1 byte):** An unsigned integer that specifies the [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204), as defined by Windows API LOGFONT structure in \[MSDN-FONTS\]. + +**unused (1 byte):** Undefined and MUST be ignored. + +### StyleXF + +The **StyleXF** structure specifies formatting properties for a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7). + +[TABLE] + +**alc (3 bits):** A [**HorizAlign**](#horizalign) that specifies the [**horizontal alignment**](#gt_f0e60ca8-51d5-4553-9126-3d89a4d08f90). + +**A - fWrap (1 bit):** A bit that specifies whether [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) text is wrapped. + +**alcV (3 bits):** A [**VertAlign**](#vertalign) that specifies the [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878). + +**B - fJustLast (1 bit):** A bit that specifies whether the justified or distributed alignment of the cell is used on the last line of text. (Setting this to 1 is typical for East Asian text but not typical in other contexts). If this field equals 1 then **alc** MUST equal 7. + +**trot (1 byte):** An [XFPropTextRotation](#xfproptextrotation) that specifies the text rotation. + +**cIndent (4 bits):** An unsigned integer that specifies the text [**indentation level**](#gt_2779d3df-3c50-44dc-9d2d-6996c4573aa9). MUST be less than or equal to 15. + +**C - fShrinkToFit (1 bit):** A bit that specifies whether a cell is [**shrink to fit**](#gt_4740d2ef-00d3-4a29-983c-b7b3a6aa01e0). + +**D - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**E - iReadOrder (2 bits):** A [**ReadingOrder**](#readingorder) that specifies the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361). + +**unused (1 byte):** Undefined and MUST be ignored. + +**dgLeft (4 bits):** A [BorderStyle](#borderstyle) that specifies the [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad). + +**dgRight (4 bits):** A BorderStyle that specifies the [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) border formatting. + +**dgTop (4 bits):** A BorderStyle that specifies the top border formatting. + +**F - dgBottom (4 bits):** A BorderStyle that specifies the bottom border formatting. + +**icvLeft (7 bits):** An unsigned integer that specifies the color of the logical left [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c). The value MUST be one of the values specified in the **icv** field in [IcvXF](#icvxf) or zero. A value of zero means the left border color is not specified. If this value is zero then **dgLeft** MUST also be zero. + +**icvRight (7 bits):** An unsigned integer that specifies the color of the logical right border. The value MUST be one of the values specified in the **icv** field in IcvXF or zero. A value of zero means the right border color is not specified. If this value is zero then **dgRight** MUST also be zero. + +**G - grbitDiag (2 bits):** An unsigned integer that specifies which diagonal borders are present (if any). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | No diagonal border | +| 0x1 | [**Diagonal-down**](#gt_494c0660-9ece-4dcc-b8d3-1a5616a57782) border | +| 0x2 | [**Diagonal-up**](#gt_d4878a4d-c65e-471d-b9fb-da7a5a5aa929) border | +| 0x3 | Both diagonal-down and diagonal-up | + +**icvTop (7 bits):** An unsigned integer that specifies the color of the top border. The value MUST be one of the values specified in the **icv** field in IcvXF or zero. A value of zero means the top border color was not specified. If this value is zero then **dgTop** MUST also be zero. + +**icvBottom (7 bits):** An unsigned integer that specifies the color of the bottom border. The value MUST be one of the values specified in the **icv** field in IcvXF or zero. A value of zero means the bottom border color was not specified. If this value is zero then **dgBottom** MUST also be zero. + +**icvDiag (7 bits):** An unsigned integer that specifies the color of the diagonal border. The value MUST be one of the values specified in the **icv** field in IcvXF or zero. A value of zero means the diagonal border color has not been specified. If this value is zero then **dgDiag** MUST also be zero. + +**dgDiag (4 bits):** A BorderStyle that specifies the diagonal border formatting. + +**H - reserved2 (1 bit):** MUST be zero and MUST be ignored. + +**fls (6 bits):** A [**FillPattern**](#fillpattern) that specifies the [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e). If this value is 1 which specifies a solid fill pattern only **icvFore** is rendered. + +**icvFore (7 bits):** An IcvXF that specifies the [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) of the fill pattern. + +**icvBack (7 bits):** An unsigned integer that specifies the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) of the fill pattern. The value MUST be an IcvXF value. + +**I - reserved3 (2 bits):** MUST be zero and MUST be ignored. + +### SXAddl_SXDEnd + +The **SXAddl_SXDEnd** record specifies the end of a sequence of [SXAddl](#sxaddl) records that specify information about a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr). The **sxd** field of SXAddlHdr MUST equal 0xFF. + +**reserved (6 bytes):** MUST be zero, and MUST be ignored. + +### SXAddl_SXDVerUpdInv + +The **SXAddl_SXDVerUpdInv** structure specifies the highest [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) for which records following this record are handled. + +[TABLE] + +**hdr (6 bytes):** An [SXAddlHdr](#sxaddlhdr). The **sxd** field of SXAddlHdr MUST equal 0x01. + +**dwVersionInvalidates (1 byte):** An unsigned integer that specifies the highest data functionality level for which records following this record are handled. + +MUST be greater than or equal to 0 and less than or equal to 0xFF. If this value is equal to 0xFF, the data functionality level is not set. + +**reserved1 (1 byte):** MUST be zero, and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero, and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero, and MUST be ignored. + +### SXAddl_SXString + +The SXAddl_SXString structure specifies a Unicode string segment. + +[TABLE] + +**st (variable):** An [XLUnicodeStringSegmentedSXADDL](#xlunicodestringsegmentedsxaddl) that specifies a Unicode string segment. **st.cchTotal** MUST be less than or equal to 65535. + +### SXAddlHdr + +The **SXAddlHdr** structure specifies header information for an [SXAddl](#sxaddl) record. + +[TABLE] + +**frtHeaderOld (4 bytes):** An [FrtHeaderOld](#frtheaderold). The **frtHeaderOld**.**rt** field MUST be 0x0864. + +**sxc (1 byte):** An unsigned integer that specifies the current class. See [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) for details. + +**sxd (1 byte):** An unsigned integer that specifies the type of record contained in the **data** field of the containing SXAddl record. See class for details. + +### SXAxis + +The **SXAxis** structure specifies the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) referred to by the containing record. + +[TABLE] + +**A - sxaxisRw (1 bit):** A bit that specifies whether this structure refers to the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +**B - sxaxisCol (1 bit):** A bit that specifies whether this structure refers to the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). + +**C - sxaxisPage (1 bit):** A bit that specifies whether this structure refers to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**D - sxaxisData (1 bit):** A bit that specifies whether this structure refers to the [value axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**reserved (12 bits):** MUST be zero, and MUST be ignored. + +### SXEZDoper + +The **SXEZDoper** structure specifies a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) data operation. + +[TABLE] + +**vts (1 byte):** An unsigned integer that specifies the type of comparison used in the data operation. MUST be a value in the following table: + +| Value | Meaning | +|----|----| +| 0x00 | This SXEZDoper record is undefined and MUST be ignored. | +| 0x04 | This SXEZDoper specifies a numeric data operation. | +| 0x06 | This SXEZDoper specifies a string data operation. | +| 0x0C | This SXEZDoper specifies that all space characters are matched in the data operation. | +| 0x0E | This SXEZDoper specifies that all non-space characters are matched in the data operation. | + +**grbitSign (1 byte):** An unsigned integer that specifies the comparison operation between a database value and **vtValue**. MUST be one of the following values: + +| Value | Meaning | +|-------|-----------------------------------------------| +| 0x00 | No operation. The **vts** field MUST be zero. | +| 0x01 | Less than | +| 0x02 | Equal to | +| 0x03 | Less than or equal to | +| 0x04 | Greater than | +| 0x05 | Not equal to | +| 0x06 | Greater than or equal to | + +**vtValue (8 bytes):** A field with the type and meaning specified by the value of **vts**, as specified in the following table: + +| Value of vts | vtValue meaning | +|----|----| +| 0x00 | Undefined and MUST be ignored. | +| 0x04 | An Xnum (section [2.5.342](#xnum)) that specifies the numeric value used in the numeric data operation. | +| 0x06 | A [PivotCompProp](#pivotcompprop) that specifies the type of string comparison. | +| 0x0C | Undefined and MUST be ignored. | +| 0x0E | Undefined and MUST be ignored. | + +### SxFT + +The **SxFT** structure specifies the pivot filter types. + +| Name | Value | Meaning | +|----|----|----| +| **SXFTCOUNT** | 0x00000001 | Specifies the "count" filter. This is a [value filter](#Section_05a1c98e21cd4941979880f4bf301bb2). | +| **SXFTPERCENT** | 0x00000002 | Specifies the "percent" filter. This is a value filter. | +| **SXFTSUM** | 0x00000003 | Specifies the "sum" filter. This is a value filter. | +| **SXFTCAPTIONEQUALS** | 0x00000004 | Specifies the "equals" filter. This is a [label filter](#Section_f221b81b892c4b5c91722d4ed17c937c). | +| **SXFTCAPTIONDOESNOTEQUAL** | 0x00000005 | Specifies the "not equal" filter. This is a label filter. | +| **SXFTCAPTIONBEGINSWITH** | 0x00000006 | Specifies the "begins with" filter. This is a label filter. | +| **SXFTCAPTIONDOESNOTBEGINWITH** | 0x00000007 | Specifies the "does not begin with" filter. This is a label filter. | +| **SXFTCAPTIONENDSWITH** | 0x00000008 | Specifies the "ends with" filter. This is a label filter. | +| **SXFTCAPTIONDOESNOTENDWITH** | 0x00000009 | Specifies the "does not end with" filter. This is a label filter. | +| **SXFTCAPTIONCONTAINS** | 0x0000000A | Specifies the "contains" filter. This is a label filter. | +| **SXFTCAPTIONDOESNOTCONTAIN** | 0x0000000B | Specifies the "does not contain" filter. This is a label filter. | +| **SXFTCAPTIONISGREATERTHAN** | 0x0000000C | Specifies the "is greater than" filter. This is a label filter. | +| **SXFTCAPTIONISGREATERTHANOREQUALTO** | 0x0000000D | Specifies the "is greater than or equal to" filter. This is a label filter. | +| **SXFTCAPTIONISLESSTHAN** | 0x0000000E | Specifies the "is less than" filter for field captions. This is a label filter. | +| **SXFTCAPTIONISLESSTHANOREQUALTO** | 0x0000000F | Specifies the "is less than or equal to" filter. This is a label filter. | +| **SXFTCAPTIONISBETWEEN** | 0x00000010 | Specifies the "is between" filter. This is a label filter. | +| **SXFTCAPTIONISNOTBETWEEN** | 0x00000011 | Specifies the "is not between" filter. This is a label filter. | +| **SXFTVALUEEQUAL** | 0x00000012 | Specifies the "value equal" filter. This is a value filter. | +| **SXFTVALUENOTEQUAL** | 0x00000013 | Specifies the "value not equal" filter. This is a value filter. | +| **SXFTVALUEGREATERTHAN** | 0x00000014 | Specifies the "value greater than" filter. This is a value filter. | +| **SXFTVALUEGREATERTHANOREQUAL** | 0x00000015 | Specifies the "value greater than or equal to" filter. This is a value filter. | +| **SXFTVALUELESSTHAN** | 0x00000016 | Specifies the "value less than" filter. This is a value filter. | +| **SXFTVALUELESSTHANOREQUAL** | 0x00000017 | Specifies the "value less than or equal to" filter. This is a value filter. | +| **SXFTVALUEBETWEEN** | 0x00000018 | Specifies the "value between" filter. This is a value filter. | +| **SXFTVALUENOTBETWEEN** | 0x00000019 | Specifies the "value not between" filter. This is a value filter. | +| **SXFTDATEEQUALS** | 0x0000001A | Specifies the "equals" filter. This is a [date filter](#Section_2b9377c5055e4efcbcf587fb13c513bd). | +| **SXFTDATEOLDERTHAN** | 0x0000001B | Specifies the "older than" filter. This is a date filter. | +| **SXFTDATENEWERTHAN** | 0x0000001C | Specifies the "newer than" filter. This is a date filter. | +| **SXFTDATEBETWEEN** | 0x0000001D | Specifies the "between" filter. This is a date filter. | +| **SXFTDATETOMORROW** | 0x0000001E | Specifies the "tomorrow" filter. This is a date filter. | +| **SXFTDATETODAY** | 0x0000001F | Specifies the "today" filter. This is a date filter. | +| **SXFTDATEYESTERDAY** | 0x00000020 | Specifies the "yesterday" filter. This is a date filter. | +| **SXFTDATENEXTWEEK** | 0x00000021 | Specifies the "next week" filter. This is a date filter. | +| **SXFTDATETHISWEEK** | 0x00000022 | Specifies the "this week" filter. This is a date filter. | +| **SXFTDATELASTWEEK** | 0x00000023 | Specifies the "last week" filter. This is a date filter. | +| **SXFTDATENEXTMONTH** | 0x00000024 | Specifies the "next month" filter. This is a date filter. | +| **SXFTDATETHISMONTH** | 0x00000025 | Specifies the "this month" filter. This is a date filter. | +| **SXFTDATELASTMONTH** | 0x00000026 | Specifies the "last month" filter. This is a date filter. | +| **SXFTDATENEXTQUARTER** | 0x00000027 | Specifies the "next quarter" filter. This is a date filter. | +| **SXFTDATETHISQUARTER** | 0x00000028 | Specifies the "this quarter" filter. This is a date filter. | +| **SXFTDATELASTQUARTER** | 0x00000029 | Specifies the "last quarter" filter. This is a date filter. | +| **SXFTDATENEXTYEAR** | 0x0000002A | Specifies the "next year" filter. This is a date filter. | +| **SXFTDATETHISYEAR** | 0x0000002B | Specifies the "this year" filter. This is a date filter. | +| **SXFTDATELASTYEAR** | 0x0000002C | Specifies the "last year" filter. This is a date filter. | +| **SXFTDATEYEARTODATE** | 0x0000002D | Specifies the "year-to-date" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODQUARTER1** | 0x0000002E | Specifies the "first quarter" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODQUARTER2** | 0x0000002F | Specifies the "second quarter" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODQUARTER3** | 0x00000030 | Specifies the "third quarter" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODQUARTER4** | 0x00000031 | Specifies the "fourth quarter" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODJANUARY** | 0x00000032 | Specifies the "January" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODFEBRUARY** | 0x00000033 | Specifies the "February" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODMARCH** | 0x00000034 | Specifies the "March" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODAPRIL** | 0x00000035 | Specifies the "April" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODMAY** | 0x00000036 | Specifies the "May" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODJUNE** | 0x00000037 | Specifies the "June" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODJULY** | 0x00000038 | Specifies the "July" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODAUGUST** | 0x00000039 | Specifies the "August" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODSEPTEMBER** | 0x0000003A | Specifies the "September" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODOCTOBER** | 0x0000003B | Specifies the "October" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODNOVEMBER** | 0x0000003C | Specifies the "November" filter. This is a date filter. | +| **SXFTDATEALLDATESINPERIODDECEMBER** | 0x0000003D | Specifies the "December" filter. This is a date filter. | +| **SXFTDATENOTEQUAL** | 0x0000003E | Specifies the "not equal" filter. This is a date filter. | +| **SXFTDATEOLDEROREQUAL** | 0x0000003F | Specifies the "older than or equal to" filter. This is a date filter. | +| **SXFTDATENEWEROREQUAL** | 0x00000040 | Specifies the "newer than or equal to" filter. This is a date filter. | +| **SXFTDATENOTBETWEEN** | 0x00000041 | Specifies the "not between" filter. This is a date filter. | + +### SxIvdCol + +The **SxIvdCol** structure specifies a reference to a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) or [data field](#Section_b4187a6caa2d4a9789bd26f394d67592) on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) + +[TABLE] + +**col (2 bytes):** A signed integer that specifies a pivot field or data field for the column axis of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -2 | This value specifies that the data field is on the column axis. The **sxaxisCol** field of **sxaxis4Data** of the [SxView](#sxview) record of the PivotTable view MUST equal 1 and the **sxaxisData** field of **sxaxis4Data** of the SxView record of the PivotTable view MUST equal zero. | +| 0+ | This value specifies a pivot field index as specified in Pivot Fields**.** The pivot field index specifies a pivot field on the column axis of the PivotTable view. MUST be less than the **cDim** field of the SxView record of the PivotTable view. If the referenced pivot field is not a hidden field in an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) then the **sxaxisCol** field of [SXAxis](#sxaxis) of the [Sxvd](#sxvd) record of the pivot field MUST equal 1. | + +A pivot field is a hidden field if an [SXAddl_SXCField12_SXDVer12Info](#sxaddl_sxcfield12_sxdver12info) record exists for the pivot field, and the **fHiddenLvl** field of the SXAddl_SXCField12_SXDVer12Info record is 1. + +### SxIvdRw + +The **SxIvdRw** structure specifies a reference to a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) or [data field](#Section_b4187a6caa2d4a9789bd26f394d67592) on the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +[TABLE] + +**rw (2 bytes):** A signed integer that specifies a pivot field or data field for the row axis of the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| -2 | This value specifies that the data field is on the row axis. The **sxaxisRw** field of **sxaxis4Data** of [SxView](#sxview) record of the PivotTable view MUST equal 1 and the **sxaxisData** field of **sxaxis4Data** of the SxView record of the PivotTable view MUST equal zero. | +| 0+ | This value specifies a pivot field index as specified in Pivot Fields**.** The pivot field index specifies a pivot field on the row axis of the PivotTable view. MUST be less than the **cDim** field of the SxView record of the PivotTable view. If the referenced pivot field is not a hidden field in an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) then the **sxaxisRw** field of [SXAxis](#sxaxis) of the [Sxvd](#sxvd) record of the pivot field MUST equal 1. | + +A pivot field is a hidden field if an [SXAddl_SXCField12_SXDVer12Info](#sxaddl_sxcfield12_sxdver12info) record exists for the pivot field, and the **fHiddenLvl** field of the SXAddl_SXCField12_SXDVer12Info record is 1. + +### SXLIItem + +The **SXLIItem** structure specifies a [pivot line](#Section_76610990666f492791b6d2280f607464) in the [row area](#Section_5594c95e6819461e80706f4b4fdfa091) or [column area](#Section_03aced8c25864e83982a1e3551a563d6) of a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +[TABLE] + +**cSic (2 bytes):** A signed integer that specifies the count of [pivot item](#Section_58891cc5dd9b4293a97831070779524f) indexes in the beginning of the **rgisxvi** array that are identical to the same number of pivot item indexes in the beginning of the **rgisxvi** array of the previous SXLIItem structure in the **rgsxli** array of the preceding [SXLI](#sxli) record. The value MUST be greater than or equal to 0 and less than the **isxviMac** field. If the **fGrand** field equals 1, then this value MUST be 0. + +**itmType (15 bits):** An unsigned integer that specifies the type of this pivot line. MUST be a value from the following table: + +| Name | Value | Meaning | +|----------------|--------|----------------------------------------------------| +| ITMTYPEDATA | 0x0000 | A value in the data | +| ITMTYPEDEFAULT | 0x0001 | Automatic subtotal selection | +| ITMTYPESUM | 0x0002 | Sum of values in the data | +| ITMTYPECOUNTA | 0x0003 | Count of values in the data | +| ITMTYPECOUNT | 0x0004 | Count of numbers in the data | +| ITMTYPEAVERAGE | 0x0005 | Average of values in the data | +| ITMTYPEMAX | 0x0006 | Maximum value in the data | +| ITMTYPEMIN | 0x0007 | Minimum value in the data | +| ITMTYPEPRODUCT | 0x0008 | Product of values in the data | +| ITMTYPESTDEV | 0x0009 | Statistical standard deviation (estimate) | +| ITMTYPESTDEVP | 0x000A | Statistical standard deviation (entire population) | +| ITMTYPEVAR | 0x000B | Statistical variance (estimate) | +| ITMTYPEVARP | 0x000C | Statistical variance (entire population) | +| ITMTYPEGRAND | 0x000D | Grand total | +| ITMTYPEBLANK | 0x000E | Blank line | + +**A - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**isxviMac (2 bytes):** A signed integer that specifies the number of elements in the **rgisxvi** array that are displayed in this pivot line. MUST be greater than or equal to 0. If the **fGrand** field equals 1, then the value of this field MUST be 1. If the **fGrand** field equals zero and the preceding SXLI record contains row area pivot items, then this value MUST be less than or equal to the **cDimRw** field of the preceding [SxView](#sxview). If the **fGrand** field equals zero and the preceding SXLI record contains column area pivot items, then this value MUST be less than or equal to the **cDimCol** field of the preceding SxView. + +**B - fMultiDataName (1 bit):** A bit that specifies whether the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592) name is used for the total or the subtotal. MUST be a value from the following table: + +| Value | Meaning | +|-------|-----------------------------------------------| +| 0 | The data field name is used for the total. | +| 1 | The data field name is used for the subtotal. | + +If the **fGrand** field equals 1 or the **fBlock** field equals 1, then this value MUST equal the value in the **fMultiDataOnAxis** field. If the **fGrand** and **fBlock** fields equal zero, the **fSbt** and **fMultiDataOnAxis** fields equal 1, and the **cSic** field is less than *iposData*, then this value MUST equal 1. Otherwise, this value MUST be 0. + +*iposData* is specified as follows: + +- If the preceding SXLI record contains row area pivot items, *iposData* equals the index of the [SxIvdRw](#sxivdrw) record in the **rgSxivd** array of the [SxIvd](#sxivd) containing SxIvdRw records where the **rw** field equals -2. If there is not an SxIvdRw record with the **rw** field equal to -2, *iposData* equals zero. + +- If the preceding SXLI record contains column area pivot items, *iposData* equals the index of the [SxIvdCol](#sxivdcol) record in the **rgSxivd** array of the SxIvd containing SxIvdCol records where the **col** field equals -2. If there is not an SxIvdCol record with the **col** field equal to -2, *iposData* equals zero. + +**iData (8 bits):** An unsigned integer that specifies a [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679) index as specified in Data Items, for an [SXDI](#sxdi) record specifying a data item used for a subtotal. This field MUST be 0 if the **cDimData** field of the preceding SxView record is 0 or if the **fGrand** field equals 1. If the **cDimData** field of the preceding SxView is greater than 0, then this value MUST be greater than or equal to 0 and less than the **cDimData** field of the preceding SxView record. If the **fMultiDataOnAxis** field equals 1 and the **itmType** field does not equal ITMTYPEBLANK and the **isxviMac** field is greater than *iposData* as specified in **fMultiDataName**, then the value of this field MUST equal the value of the element of the **rgisxvi** array in the position equal to *iposData* as specified in **fMultiDataName**. + +**C - fSbt (1 bit):** A bit that specifies whether this pivot line is a subtotal. This value MUST equal 1 if the **itmType** field is greater than or equal to ITMTYPEDEFAULT and the **itmType** field is less than or equal to ITMTYPEGRAND and the **fBlock** field equals 0. Otherwise, this value MUST be 0. + +**D - fBlock (1 bit):** A bit that specifies whether this pivot line is a block total. A block total is a total of a group of pivot items. For more details see [Grouping](#Section_63e07ed20a764cb08cf446aaf25464c2). If the **fGrand** field equals 0 and the **fBlock** field in the previous SXLIItem record equals 1, this value MUST be 1. + +**E - fGrand (1 bit):** A bit that specifies whether this pivot line is a [**grand total**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7). If the **fGrand** field in the previous SXLIItem record is 1, then this value MUST be 1. Otherwise, if the **itmType** field equals ITMTYPEGRAND this field MUST equal 1 and if the **itmType** field does not equal ITMTYPEGRAND this field MUST equal 0. + +**F - fMultiDataOnAxis (1 bit):** A bit that specifies whether a [pivot line entry](#Section_ecba812f4a31495ebeb46749e5897f2d) in this pivot line is a data item index. + +If the preceding SXLI record contains row area pivot items, the **cDimData** field of the preceding SxView record is greater than 1, the **sxaxis4Data**.**sxaxisRw** field of the preceding SxView equals 1 and **itmType** is not equal to ITMTYPEBLANK, then this value MUST be 1. Otherwise, this value MUST be 0. + +If the preceding SXLI record contains column area pivot items, the **cDimData** field of the preceding SxView record is greater than 1, the **sxaxis4Data.sxaxisCol** field of the preceding SxView equals 1 and **itmType** is not equal to ITMTYPEBLANK, then this value MUST be 1. Otherwise, this value MUST be 0. + +**G - unused1 (1 bit):** Undefined, and MUST be ignored. + +**H - unused2 (1 bit):** Undefined, and MUST be ignored. + +**I - reserved2 (1 bit):** MUST be zero and MUST be ignored. + +**rgisxvi (variable):** An array of 2-byte signed integers that specifies a pivot line entry. + +Each element of this array is either a pivot item index or a data item index. + +If **fGrand** is 1 or **itmType** is ITMTYPEBLANK then all elements of this field are undefined and MUST be ignored. Otherwise each element MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 to 0x7EF4 | This value specifies a data item index or pivot item index in the associated [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) as specified in Pivot Items. | +| 0x7FFF | This value specifies that there is no pivot item and that the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the pivot line is blank. | + +For more details see Pivot Line Entries and Pivot Lines. + +### SXPI_Item + +The **SXPI_Item** structure specifies information about a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) and its filtering on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +[TABLE] + +**isxvd (2 bytes):** A signed integer that specifies a pivot field index as specified by Pivot Fields. The referenced pivot field is specified to be on the page axis. MUST be greater than or equal to zero and less than the **cDim** field of the [SxView](#sxview) record of the PivotTable view. + +**isxvi (2 bytes):** A signed integer that specifies the [pivot item](#Section_58891cc5dd9b4293a97831070779524f) used for the page axis filtering. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0000 to 0x7FFC | This value specifies a pivot item index that specifies a pivot item in the pivot field specified by **isxvd**. The referenced pivot item specifies the page axis filtering for the pivot field. | +| 0x7FFD | This value specifies all pivot items, see page axis for filtering that applies. | + +For a non-[OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) the value MUST be 0x7FFD or greater than or equal to zero and less than the **cItm** field of the [Sxvd](#sxvd) record of the pivot field**.** Otherwise the value MUST be 0x7FFD. + +**idObj (2 bytes):** A signed integer that specifies the object identifier of the [Obj](#obj) record with the page item drop-down arrow. + +### SXVDEx_Opt + +The **SXVDEx_Opt** structure specifies an optional string in the [SXVDEx](#sxvdex) record. + +[TABLE] + +**cchSubName (2 bytes):** An unsigned integer that specifies the length, in characters, of the [XLUnicodeStringNoCch](#xlunicodestringnocch) in the **stSubName** field. If the value is 0xFFFF then **stSubName** does not exist. The value MUST be 0xFFFF or greater than zero and less than or equal to 0x00FF. + +**reserved1 (4 bytes):** MUST be zero, and MUST be ignored. + +**reserved2 (4 bytes):** MUST be zero, and MUST be ignored. + +**stSubName (variable):** An XLUnicodeStringNoCch that specifies the name of the aggregate function used to calculate this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5)’s subtotals. A "?" character within the string will be replaced by the **stName** field of [Sxvd](#sxvd) when displayed in the UI. The length is specified in **cchSubName**. + +### SXView9Save + +The **SXView9Save** structure specifies option flags for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +[TABLE] + +**A - fNoStencil (1 bit):** A bit that specifies whether to disable the drawing of large drop zones for a [PivotTable view](#Section_a5f57198f2af40b2ba07e4b1836d73f3)that has no data fields. + +**B - fHideTotAnnotation (1 bit):** A bit that specifies whether, for an [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) when the **fNotVisualTotals** field of the [SXAddl_SXCView_SXDVer12Info](#sxaddl_sxcview_sxdver10info) record of the PivotTable view is 0 or the SXAddl_SXCView_SXDVer12Info record is not present, an asterisk is not displayed next to the caption for subtotals and grand totals. + +**C - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**D - fIncludeEmptyRw (1 bit):** A bit that specifies whether empty rows from an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) be shown in the PivotTable view. + +**E - fIncludeEmptyCol (1 bit):** A bit that specifies whether empty columns from an OLAP data source is shown in the PivotTable view. + +**reserved2 (11 bits):** MUST be zero, and MUST be ignored. + +**reserved3 (16 bits):** MUST be zero, and MUST be ignored. + +### SXVIFlags + +**SXVIFlags** is a 2-byte structure which specifies properties for a [pivot item](#Section_58891cc5dd9b4293a97831070779524f). + +[TABLE] + +**A - fDrilledMember (1 bit):** A bit that specifies whether child elements of this node are collapsed, see [Collapsing](#Section_1c9375b4cc664783821f6b2b49bac169) for details. MUST be zero if the pivot items are from [**attribute hierarchies**](#gt_8f75d668-e8c6-4f42-ba44-d90604d3b9dc). MUST be zero if the **itmType** field of the [SXVI](#sxvi) record of the pivot item is not zero. + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fHasChildren (1 bit):** A bit that specifies whether the pivot item has child [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32). MUST be zero if the **itmType** field of the SXVI record of the pivot item is not zero. + +**D - fCollapsedMember (1 bit):** A bit that specifies whether the subnodes of this node are collapsed, see Collapsing for details. This value applies only to pivot items of attribute hierarchies. MUST be zero if the pivot items are from non-attribute hierarchies. + +**E - fHasChildrenEst (1 bit):** A bit that specifies whether **fHasChildren** is considered correct. + +**F - fOlapFilterSelected (1 bit):** A bit that specifies whether this pivot item is selected for [Olap Manual Filtering](#Section_bd4665ebb56a44e690b9ceaf7ec55389). + +**reserved2 (10 bits):** MUST be zero, and MUST be ignored. + +### TabId + +The **TabId** structure specifies the unique sheet identifier associated with the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). A sheet’s identifier is specified by the [RRTabId](#rrtabid) record, the order of the sheet identifiers in the RRTabId record matches the order of the [BoundSheet8](#boundsheet8) records as they appear in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). If the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) contains more than 4112 sheets then this record is not present and each sheet identifier is specified by the order in which the BoundSheet8 records appear in the Globals Substream, beginning with one. + +[TABLE] + +**tabid (2 bytes):** An unsigned integer that specifies the unique sheet identifier associated with the sheet. MUST be greater than or equal to 0x0001 and less than or equal to 0xFFFE. + +### TabIndex + +The **TabIndex** structure specifies a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) index in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). A sheet index is the zero-based index into the collection of [BoundSheet8](#boundsheet8) records as they appear in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) + +[TABLE] + +**itab (2 bytes):** An unsigned integer that specifies the zero-based index into the collection of BoundSheet8 records as they appear in the Globals Substream. + +### TableFeatureType + +The **TableFeatureType** structure specifies the definition of a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) within a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +The table feature supports multiple [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) types. The data source is specified by the **lt** field. If the **lt** field is 0x00000001, the table's data source definition is cached within the [List Data](#Section_914f09bd8c944c099e8631dfe058f037) stream. If the **lt** field is 0x00000002, the table's data source schema is cached within the **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)). + +[TABLE] + +**lt (4 bytes):** A [**SourceType**](#sourcetype) that specifies the type of data source for the table. + +**idList (4 bytes):** An unsigned integer that specifies an identifier for the table. MUST be unique within the sheet. SHOULD[\<183\>](#Appendix_A_183) be unique within the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +**crwHeader (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies whether the table has a [**header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38). If **fAutoFilter** is 1, the value MUST be 0x00000001. If **fSingleCell** is 1, the value MUST be 0x00000000. MUST be one of the following values: + +| Value | Meaning | +|------------|--------------------------| +| 0x00000000 | Table has no header row. | +| 0x00000001 | Table has a header row. | + +**crwTotals (4 bytes):** A Boolean that specifies whether there is a [**total row**](#gt_95e9bcf4-d644-4e96-9070-dbc80b4d1b28). If **fSingleCell** is 1, the value MUST be 0x00000000. MUST be one of the following values: + +| Value | Meaning | +|------------|-------------------------| +| 0x00000000 | Table has no total row. | +| 0x00000001 | Table has a total row. | + +**idFieldNext (4 bytes):** An unsigned integer that specifies the next unique identifier to use when assigning unique identifiers to the **fieldData.idField** field of the table. + +**cbFSData (4 bytes):** An unsigned integer that specifies the size, in bytes, of the fixed portion of this structure. The fixed portion starts at the **lt** field and ends at the **rgbHashParam** field. MUST be equal to 64. + +**rupBuild (2 bytes):** An unsigned integer that specifies the [**build number**](#gt_560a30e4-7009-48da-b1e8-68db9c458e95) of the application that wrote the structure. + +**unused1 (2 bytes):** Undefined, and MUST be ignored. + +**A - unused2 (1 bit):** Undefined, and MUST be ignored. + +**B - fAutoFilter (1 bit):** A bit that specifies whether the table has an [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). MUST be 1 when **fPersistAutoFilter** is 1. + +**C - fPersistAutoFilter (1 bit):** A bit that specifies whether the AutoFilter is preserved for this table after data [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) operations.[\<184\>](#Appendix_A_184) + +**D - fShowInsertRow (1 bit):** A bit that specifies whether the [**insert row**](#gt_3b3c223b-83e0-4697-85eb-815af907b8a9) is [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72). MUST be 1 if **fInsertRowInsCells** is 1. + +**E - fInsertRowInsCells (1 bit):** A bit that specifies whether rows below the table are shifted down because of the insert row being visible. + +**F - fLoadPldwIdDeleted (1 bit):** A bit that specifies whether the **idDeleted** field is present. MUST be zero if the **lt** field is not set to 0x00000001. + +**G - fShownTotalRow (1 bit):** A bit that specifies whether the total row was ever visible. + +**H - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**I - fNeedsCommit (1 bit):** A bit that specifies whether table modifications were not synchronized with the data source. MUST be zero if the **lt** field is not set to 0x00000001. + +**J - fSingleCell (1 bit):** A bit that specifies whether the table is limited to a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). The table cannot have header rows, total rows, or multiple columns. If **fSingleCell** equals 1, the **lt** field MUST be set to 0x00000002. + +**K - reserved2 (1 bit):** MUST be zero and MUST be ignored. + +**L - fApplyAutoFilter (1 bit):** A bit that specifies whether the AutoFilter is currently applied. MUST be 1 if the AutoFilter is currently applied[\<185\>](#Appendix_A_185). + +**M - fForceInsertToBeVis (1 bit):** A bit that specifies whether the insert row is forced to be visible because the table has no data. + +**N - fCompressedXml (1 bit):** A bit that specifies whether the cached data for this table in the List Data stream is compressed. MUST be zero if the **lt** field is not set to 0x00000001. + +**O - fLoadCSPName (1 bit):** A bit that specifies whether the **cSPName** field is present. MUST be zero if the **lt** field is not set to 0x00000001. + +**P - fLoadPldwIdChanged (1 bit):** A bit that specifies whether **idChanged** field is present. MUST be zero if the **lt** field is not set to 0x00000001. + +**verXL (4 bits):** An unsigned integer that specifies the application version under which the table was created. MUST be either 0xB or 0xC[\<186\>](#Appendix_A_186). + +**Q - fLoadEntryId (1 bit):** A bit that specifies whether the **entryId** field is present. + +**R - fLoadPllstclInvalid (1 bit):** A bit that specifies whether the **cellInvalid** field is present. MUST be zero if the **lt** field is not set to 0x00000001. + +**S - fGoodRupBld (1 bit):** A bit that specifies whether the **rupBuild** field is valid. + +**T - unused3 (1 bit):** Undefined, and MUST be ignored. + +**U - fPublished (1 bit):** A bit that specifies whether the table is [**published**](#gt_8ffc383a-d4f1-4515-a8b5-874d84ab2d2b). This bit is ignored if the **fPublishedBookItems** field of the [BookExt_Conditional12](#bookext_conditional12) structure is zero. + +**reserved3 (7 bits):** Undefined, and MUST be ignored. + +**lPosStmCache (4 bytes):** An unsigned integer that specifies the position of the cached data within the List Data stream. Undefined and MUST be ignored if the **lt** field is not set to 0x00000001. + +**cbStmCache (4 bytes):** An unsigned integer that specifies the size, in bytes, of the cached data within the List Data stream. Undefined and MUST be ignored if the **lt** field is not set to 0x00000001. + +**cchStmCache (4 bytes):** An unsigned integer that specifies the count of characters of the cached data within the List Data stream when the cached data is uncompressed. Undefined and MUST be ignored if the **lt** field is not set to 0x00000001. + +**lem (4 bytes):** A [**LEMMode**](#lemmode) enumeration that specifies the table edit mode. If **lt** is set to 0x00000000, 0x00000002 or 0x00000003, this field MUST be set to 0x00000000. + +**rgbHashParam (16 bytes):** An array of bytes that specifies round-trip information. SHOULD[\<187\>](#Appendix_A_187) be ignored and MUST be preserved if the **lt** field is set to 0x00000001. Undefined and MUST be ignored if the **lt** field is not set to 0x00000001. + +**rgbName (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the name of the table. MUST be unique per [workbook](#Section_f682f4b08c6b444e83f852d156f1e8ba), and case-sensitive in all locales. + +**cFieldData (2 bytes):** An unsigned integer that specifies the number of columns in the table. MUST be greater than or equal to 0x0001 and less than or equal to 0x0100. + +**cSPName (variable):** An XLUnicodeString that specifies the name of the [**cryptographic service provider**](#gt_1e9dc9e9-1ec2-43fa-80ac-caf013b9f3fc) used to specify **rgbHashParam**. This field is present only if **fLoadCSPName** is set to 1. + +**entryId (variable):** An XLUnicodeString that specifies a unique identifier for the table. The string equals the value of the **idList** field, represented in decimal format, without any leading zeros. It is used when **lt** equals 0x00000002 and ignored otherwise. This field is present only if **fLoadEntryId** is set to 1. + +**fieldData (variable):** An array of [Feat11FieldDataItem](#feat11fielddataitem) that contains the specification of the columns of the table. The number of items in this array is specified by the **cFieldData** field. + +**idDeleted (variable):** A [Feat11RgSharepointIdDel](#feat11rgsharepointiddel) structure that specifies the identifiers of deleted rows. This information is used when synchronizing with the Web based [**data provider’s**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) data source. This field is only present if the **fLoadPldwIdDeleted** field is set to 1. + +**idChanged (variable):** A [Feat11RgSharepointIdChange](#feat11rgsharepointidchange) structure that specifies the identifiers of the edited rows. This information is used when synchronizing with the Web based data provider’s data source. This field is only present if the **fLoadPldwIdChanged** field is set to 1. + +**cellInvalid (variable):** A [Feat11RgInvalidCells](#feat11rginvalidcells) structure that specifies the location of cells within the table that contain values that are invalid based on validation rules on the Web based data provider. This field is only present if the **fLoadPllstclInvalid** field is set to 1. + +### Tag_Fn_MDX + +The **Tag_Fn_MDX** enumeration specifies [**cube function**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3) types. + +| Name | Value | Meaning | +|---------------------------|-------|--------------------| +| **TFNCUBEMEMBER** | 0x01 | CUBEMEMBER | +| **TFNCUBEVALUE** | 0x02 | CUBEVALUE | +| **TFNCUBESET** | 0x03 | CUBESET | +| **TFNCUBESETCOUNT** | 0x04 | CUBESETCOUNT | +| **TFNCUBERANKEDMEMBER** | 0x05 | CUBERANKEDMEMBER | +| **TFNCUBEMEMBERPROPERTY** | 0x06 | CUBEMEMBERPROPERTY | +| **TFNCUBEKPIPROPERTY** | 0x07 | CUBEKPIPROPERTY | + +### TextPropsStreamChecksumData + +The **TextPropsStreamChecksumData** structure specifies the data used to compute the [**checksum**](#gt_fa444149-ef93-4512-a278-2e756295630c) of the [TextPropsStream](#textpropsstream) record. This data can be obtained from [Font](#font) and [Text](#text) records associated with the TextPropsStream record, as specified in TextPropsStream. If no Font record is associated with the TextPropsStream record, the fields related to the Font record MUST be omitted from this structure and thus not used to compute the checksum. If no Text record is associated with the TextPropsStream record, the Text record associated with the [DefaultText](#defaulttext) record MUST be used instead. + +[TABLE] + +**stFontName (variable):** An array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) characters that specify the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) name. The size of the array MUST be equal to **fontName**.**cch\***2, where **fontName** is a field of the associated Font record. + +The value of this field MUST be equal to value of the **fontName**.**rgb** field of the associated Font record. + +**dwFontHeight (4 bytes):** An unsigned integer that specifies the font height. The value of this field MUST be equal to the value of the **dyHeight** field of the associated Font record. + +**A - fBold (1 bit):** A bit that specifies whether the font is bold. The value of this field MUST be 1 when the value of the **bls** field of the associated Font record is greater than 400. + +**B - fItalic (1 bit):** A bit that specifies whether the font is italic. The value of this field MUST be equal to the value of the **fItalic** field of the associated Font record. + +**C - fUnderline (1 bit):** A bit that specifies whether the font is single-underlined. The value of this field MUST be 1 when the value of the **uls** field of the associated Font record is not equal to 0x00. + +**D - fOutline (1 bit):** A bit that specifies whether the font has an [**outline effect**](#gt_4e818802-fdc1-4227-b32f-1a3cb0943de7) applied. The value of this field MUST be equal to the value of the **fOutline** field of the associated Font record. + +**E - fShadow (1 bit):** A bit that specifies whether the font has a [**shadow effect**](#gt_83056968-00f2-463b-abc6-607dbb242cbf) applied. The value of this field MUST be equal to the value of the **fShadow** field of the associated Font record. + +**F - fCondense (1 bit):** A bit that specifies whether the font is condensed. The value of this field MUST be equal to the value of the **fCondense** field of the associated Font record. + +**G - fExtend (1 bit):** A bit that specifies whether the font is extended. The value of this field MUST be equal to the value of the **fExtend** field of the associated Font record. + +**H - fStrikeout (1 bit):** A bit that specifies whether the font has strike-through effect applied. The value of this field MUST be equal to the value of the **fStrikeOut** field of the associated Font record. + +**I - fRegular (1 bit):** A bit that specifies whether the font is a regular font. The value of this field MUST be equal to 1. + +**J - fJon (1 bit):** A bit that specifies whether the font is too small to be displayed. MUST have a value of 1 if the font height in pixels is less than 6. + +**K - fDialogBox (1 bit):** A bit that specifies whether the font is used in the context of a dialog box. The value of this field MUST be equal to 0. + +**unused1 (5 bits):** MUST be zero, and MUST be ignored. + +**boldness (2 bytes):** An unsigned integer that specifies the font weight. The value of this field MUST be equal to the value of the **bls** field of the associated Font record. + +**subscript (2 bytes):** An unsigned integer that specifies whether superscript, subscript, or normal script is used. The value of this field MUST be equal to the value of the **sss** field of the associated Font record. + +**bUnderline (1 byte):** An unsigned integer that specifies the underline style. The value of this field MUST be equal to the value of the **uls** field of the associated Font record. + +**bFamily (1 byte):** An unsigned integer that specifies the [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2) of this font. The value of this field MUST be equal to the value of the **bFamily** field of the associated Font record. + +**bCharset (1 byte):** An unsigned integer that specifies the [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204). The value of this field MUST be equal to the value of the **bCharSet** field of the associated Font record. + +**unused2 (1 byte):** MUST be zero, and MUST be ignored. + +**rgbFontColor (4 bytes):** A [LongRGB](#longrgb) that specifies the font color. The value of this field MUST be equal to the value of the **icv** field of the associated Font record. + +**dwDrawingMode (4 bytes):** An unsigned integer that specifies the display mode of the background of the text. The value of this field MUST be equal to 0x0000010D when the **wBkgMode** field of the associated Text record is equal to 0x0001; otherwise, it MUST be equal to 0x0000020D. + +**bRotation (1 byte):** An unsigned integer that specifies the text rotation. The value of this field MUST be equal to the value of the **trot** field of the associated Text record. + +**dwHAlignment (4 bytes):** An unsigned integer that specifies the horizontal alignment of the text. The value of this field MUST equal to the value of the **at** field of the associated Text record. + +**dwVAlignment (4 bytes):** An unsigned integer that specifies the vertical alignment of the text. The value of this field MUST be equal to the value of the **vat** field of the associated Text record. + +**bReadingOrder (1 byte):** An unsigned integer that specifies the reading order of the text. The value of this field MUST be equal to the value of the **iReadingOrder** field of the associated Text record. + +### Top10FT + +The **Top10FT** enumeration specifies the [**top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9) type. + +| Name | Value | Meaning | +|--------------------|------------|---------| +| **TOP10FTUNKNOWN** | 0x00000000 | None | +| **TOP10FTCOUNT** | 0x00000001 | Count | +| **TOP10FTPERCENT** | 0x00000002 | Percent | +| **TOP10FTSUM** | 0x00000003 | Sum | + +### Ts + +The **Ts** structure specifies the italic and [**strikethrough formatting**](#gt_b16d9600-aebb-4a4f-bf14-c38e13c11c14) of a [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). + +[TABLE] + +**A - unused1 (1 bit):** Undefined and MUST be ignored. + +**B - ftsItalic (1 bit):** A bit that specifies whether the text [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) is italic. + +**unused2 (5 bits):** Undefined and MUST be ignored. + +**C - ftsStrikeout (1 bit):** A bit that specifies whether the font has strikethrough formatting applied. + +**unused3 (24 bits):** Undefined and MUST be ignored. + +### TxOLastRun + +The **TxOLastRun** structure marks the end of the [**formatting run**](#gt_10031ac8-2a26-4200-beee-cd8d9420ca96) information in the [TxORuns](#txoruns) structure. + +[TABLE] + +**cchText (2 bytes):** An unsigned integer that specifies the number of characters in the preceding [TxO](#txo) record. The value MUST be the count of characters specified in the **cchText** field of the preceding TxO record. + +**unused1 (2 bytes):** Undefined and MUST be ignored. + +**unused2 (4 bytes):** Undefined and MUST be ignored. + +### TxORuns + +The **TxORuns** structure specifies the [**formatting run**](#gt_10031ac8-2a26-4200-beee-cd8d9420ca96) information for the [TxO](#txo) record and zero or more [Continue](#continue) records immediately following. + +[TABLE] + +**rgTxoRuns (variable):** An array of [Run](#run). Each Run specifies the formatting information for a [**text run**](#gt_393612a7-9552-48b0-abf6-0371dbd6d553). **formatRun.ich** MUST be less than or equal to **cchText** of the preceding TxO record. The number of elements in this array is as follows: + +(**cbRuns** of the preceding TxO record / 8 – 1). + +**lastRun (8 bytes):** A [TxOLastRun](#txolastrun) that marks the end of the text run. This field is only present in the last Continue record following the TxO record. [\<188\>](#Appendix_A_188) + +### TxtWf + +The **TxtWf** structure specifies a field in text to column. + +[TABLE] + +**fieldType (4 bytes):** An unsigned integer that specifies the format of the field. MUST be a value from the following table: + +| Value | Meaning | +|------------|------------------------------------| +| 0x00000000 | General | +| 0x00000001 | Text | +| 0x00000002 | Date in the order month, day, year | +| 0x00000003 | Date in the order day, month, year | +| 0x00000004 | Date in the order year, month, day | +| 0x00000005 | Date in the order month, year, day | +| 0x00000006 | Date in the order day, year, month | +| 0x00000007 | Date in the order year, day, month | +| 0x00000008 | Skip importing field | +| 0x00000009 | Taiwan era dates. | + +**fieldStart (4 bytes):** An unsigned integer that specifies the character position of the field. The offset is zero-based and MUST be greater than or equal to 0. + +### Underline + +The **Underline** enumeration specifies the underline style. + +| Name | Value | Meaning | +|----|----|----| +| **ULSNONE** | 0x0000 | No underline | +| **ULSSINGLE** | 0x0001 | Single | +| **ULSDOUBLE** | 0x0002 | Double | +| **ULSSINGLEACCOUNTANT** | 0x0021 | [**Single accounting**](#gt_7ad49c0f-e183-47b5-bdbd-c23a5a8315fc) | +| **ULSDOUBLEACCOUNTANT** | 0x0022 | [**Double accounting**](#gt_89f4f531-9a8b-419c-8f51-98ef409b7bdf) | + +### VertAlign + +The **VertAlign** enumeration specifies the vertical alignment. + +| Name | Value | Meaning | +|--------------|-------|-----------------------| +| **ALCVTOP** | 0x00 | Top alignment | +| **ALCVCTR** | 0x01 | Center alignment | +| **ALCVBOT** | 0x02 | Bottom alignment | +| **ALCVJUST** | 0x03 | Justify alignment | +| **ALCVDIST** | 0x04 | Distributed alignment | + +### VertBrk + +The **VertBrk** structure specifies one column [**page break**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871). + +[TABLE] + +**col (2 bytes):** A [ColU](#colu) that specifies the zero-based index of the first column to the right of the page break. + +**rowStart (2 bytes):** A [RwU](#rwu) that specifies the zero-based index of the first row on the page. + +**rowEnd (2 bytes):** A RwU that specifies the zero-based index of the last row on the page. The value MUST be greater than **rowStart**. + +### VirtualPath + +**VirtualPath** is a [XLUnicodeString](#xlunicodestring) that specifies a path, a workbook, and optionally a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +MUST be a string in the following grammar: + +437. virt-path = volume / unc-volume / rel-volume / transfer-protocol / startup / alt-startup / library / simple-file-path / ole-link + + ole-link = path-string %x0003 path-string + + simple-file-path = \[%x0001\] file-path + + startup = %x0001 %x0006 file-path + +This code specifies that the relative-path is relative to the [**startup directory**](#gt_801b8914-241f-4ce5-977d-81aebf73f03d). + +441. alt-startup = %x0001 %x0007 file-path + +This code specifies that the relative-path is relative to the [**alternate startup directory**](#gt_08e6e2f9-6030-4e53-a75f-ce61b18a5113). + +442. library = %x0001 %x0008 file-path + +This code specifies that the relative-path is relative to the [**library directory**](#gt_1cdac036-e397-49b5-8933-c0e8f054528a). + +443. transfer-protocol = %x0001 %x0005 count transfer-path + +This code specifies that the path is a [**transfer protocol**](#gt_627a8033-354c-4fd2-9356-bb232afbdb6a) path. The value of count MUST be equal to the number of characters following count in transfer-path. + +444. transfer-path = transfer-base-path / "\[" transfer-base-path "\]" sheet-name + + transfer-base-path = transfer-type "://" file-path + + transfer-type = "ftp" / "http" / "https" + + rel-volume = %x0001 %x0002 file-path + +This code specifies that the path is relative to the drive volume of the workbook that contains the path. + +448. volume = %x0001 %x0001 volume-character file-path + +This code specifies that the path is relative to a specific drive volume. The drive volume is specified in volume-character. + +449. unc-volume = %x0001 %x0001 %x0040 unc-path + +This code specifies that the path is relative to a [**UNC volume**](#gt_dbf563c5-fee0-44dc-b90e-d302db7bcd78). The computer name is specified in computer-name and the shared folder is specified in shared-folder. + +450. unc-path = unc-base-path / "\[" unc-base-path "\]" sheet-name + + unc-base-path = computer-name %x0003 shared-folder %x0003 relative-path + + volume-character = %x0041-%x005A / %x0061-%x007A + +This code specifies a drive volume. + +453. file-path = relative-path / "\[" relative-path "\]" sheet-name + + sheet-name = sheet-start-end-character \*sheet-character sheet-start-end-character / sheet-start-end-character + +This code specifies the name of the sheet within the workbook. + +455. sheet-start-end-character = %x0001-%xFFFF + +This code specifies a character which is a first or last character of sheet name. Such character MUST NOT include any character that matches invalid-sheet-start-end-character. + +456. invalid-sheet-start-end-character = %x0003 / "\*" / "?" / "’" / "\[" / "\]" / "\\ / ":" / "/" + + sheet-character = %x0001-%xFFFF + +This code specifies a sheet character. A sheet character MUST NOT include any character that matches invalid-sheet-character. + +458. invalid-sheet-character = %x0003 / "\*" / "?" / / "\[" / "\]" / "\\ / ":" / "/" + + relative-path = directory \*(%x0003 directory) + +This code specifies a sequence of subdirectories that comprise the path from the volume or directory. + +460. directory = path-string + +This code specifies a directory. + +461. computer-name = path-string + +This code specifies a computer name. + +462. shared-folder = path-string + +This code specifies a shared folder. + +463. path-string = 1\*path-character + + path-character = %x0020-%x0021 / %x0023-%x0029 / %x002B-%x002E / %x0030-%x0039 / %x003B / %x003D / %x0040-%x005B / %x005D-%x007B / %x007D-%xFFFF + +This code specifies a path character. + +count = %x00-%xFF + +### WebPubString + +The **WebPubString** structure specifies a string for Web publishing. + +[TABLE] + +**cch (2 bytes):** An unsigned integer that specifies the character count in the **str** field. MUST be greater than or equal to zero and less than or equal to 255. + +**str (variable):** An [XLUnicodeStringNoCch](#xlunicodestringnocch). The character count in the string MUST be equal to the value of the **cch** field. + +**pad (1 byte):** Unused and MUST be ignored. This field exists if and only if the total number of bytes in the **str** field is an odd number. + +### XColorType + +*The **XColorType** enumeration specifies the color reference types. It MUST be one of the following values:* + +| Name | Value | Meaning | +|-----------------|------------|-----------------| +| **XCLRAUTO** | 0x00000000 | Automatic color | +| **XCLRINDEXED** | 0x00000001 | Indexed color | +| **XCLRRGB** | 0x00000002 | RGB color | +| **XCLRTHEMED** | 0x00000003 | Theme color | +| **XCLRNINCHED** | 0x00000004 | Color not set | + +### XFExtGradient + +The **XFExtGradient** structure specifies a gradient fill for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) interior. + +[TABLE] + +**gradient (44 bytes):** An [XFPropGradient](#xfpropgradient) that specifies the gradient fill. + +**cGradStops (4 bytes):** An unsigned integer that specifies the number of items in **rgGradStops**. MUST be greater than or equal to 0 and less than or equal to 256. + +**rgGradStops (variable):** An array of [GradStop](#gradstop). Each array element specifies a gradient stop for this gradient fill. + +### XFExtNoFRT + +The **XFExtNoFRT** structure specifies a set of extensions to formatting properties. + +[TABLE] + +**reserved1 (2 bytes):** MUST be zero and MUST be ignored. + +**reserved2 (2 bytes):** MUST be equal to 0xFFFF and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero and MUST be ignored. + +**cexts (2 bytes):** An unsigned integer that specifies the number of elements in **rgExt.** + +**rgExt (variable):** An array of [ExtProp](#extprop). Each array element specifies an extension to a formatting property. The element count of this field MUST be equal to **cexts**. + +### XFIndex + +The **XFIndex** structure specifies the index of a [XF](#xf) record. + +[TABLE] + +**ixfe (2 bytes):** An unsigned integer that specifies a zero-based index of a XF record in the collection of XF records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +The XF records in the file refer to both and [Cell Style XFs](#Section_3d5348ded9df4c31b1fd9f9377273152) and [Cell XFs](#Section_518a740d71c640c8bb97e7df6915861a). For more information, see [Styles](#Section_df39e66a8f994f41beeb4f5c8a1d2593). + +The XF records in the file can be divided into three sections. The first section contains the 16 built-in XF records that MUST exist and MUST be ordered as follows: + +| Index | XF specifies | fStyle value | +|-------|------------------------|--------------| +| 0 | Normal style | 1 | +| 1 | Row outline level 1 | 1 | +| 2 | Row outline level 2 | 1 | +| 3 | Row outline level 3 | 1 | +| 4 | Row outline level 4 | 1 | +| 5 | Row outline level 5 | 1 | +| 6 | Row outline level 6 | 1 | +| 7 | Row outline level 7 | 1 | +| 8 | Column outline level 1 | 1 | +| 9 | Column outline level 2 | 1 | +| 10 | Column outline level 3 | 1 | +| 11 | Column outline level 4 | 1 | +| 12 | Column outline level 5 | 1 | +| 13 | Column outline level 6 | 1 | +| 14 | Column outline level 7 | 1 | +| 15 | Default cell format | 0 | + +The second section contains XF records for both built-in and user-defined Cell Style XFs. These Cell Style XFs MUST be ordered alphabetically in the file based on their name. The name of the Cell Style XF is specified by the **user** field of the corresponding [Style](#style) record. The corresponding Style record is the one with an **ixfe** field that specifies the XF record of the Cell Style XF. Note that the ordering depends on the localized name of the style and the language of the application that last saved the file. + +For example, in a workbook created by a specific version of the application[\<189\>](#Appendix_A_189) with no user-defined [cell styles](#Section_f9425d3f127545be8389bf80f65b56b7) the remainder of the table is: + +| Index | Name of Style | fStyle value | +|-------|------------------|--------------| +| 16 | 20% - Accent1 | 1 | +| 17 | 20% - Accent2 | 1 | +| 18 | 20% - Accent3 | 1 | +| 19 | 20% - Accent4 | 1 | +| 20 | 20% - Accent5 | 1 | +| 21 | 20% - Accent6 | 1 | +| 22 | 40% - Accent1 | 1 | +| 23 | 40% - Accent2 | 1 | +| 24 | 40% - Accent3 | 1 | +| 25 | 40% - Accent4 | 1 | +| 26 | 40% - Accent5 | 1 | +| 27 | 40% - Accent6 | 1 | +| 28 | 60% - Accent1 | 1 | +| 29 | 60% - Accent2 | 1 | +| 30 | 60% - Accent3 | 1 | +| 31 | 60% - Accent4 | 1 | +| 32 | 60% - Accent5 | 1 | +| 33 | 60% - Accent6 | 1 | +| 34 | Accent1 | 1 | +| 35 | Accent2 | 1 | +| 36 | Accent3 | 1 | +| 37 | Accent4 | 1 | +| 38 | Accent5 | 1 | +| 39 | Accent6 | 1 | +| 40 | Bad | 1 | +| 41 | Calculation | 1 | +| 42 | Check Cell | 1 | +| 43 | Comma | 1 | +| 44 | Comma\[0\] | 1 | +| 45 | Currency | 1 | +| 46 | Currency\[0\] | 1 | +| 47 | Explanatory Text | 1 | +| 48 | Good | 1 | +| 49 | Heading 1 | 1 | +| 50 | Heading 2 | 1 | +| 51 | Heading 3 | 1 | +| 52 | Heading 4 | 1 | +| 53 | Input | 1 | +| 54 | Linked Cell | 1 | +| 55 | Neutral | 1 | +| 56 | Note | 1 | +| 57 | Output | 1 | +| 58 | Percent | 1 | +| 59 | Title | 1 | +| 60 | Total | 1 | +| 61 | Warning Text | 1 | + +The last section contains unordered XFs for any Cell XFs in the file. + +### XFProp + +The **XFProp** structure specifies a formatting property. Instances of this structure appear as elements in the **xfPropArray** field of an [XFProps](#xfprops) structure. + +[TABLE] + +**xfPropType (2 bytes):** An unsigned integer that specifies the type of the formatting property. MUST be greater than or equal to 0x0000 and less than or equal to 0x002C, and MUST NOT equal 0x0027 or 0x0028. See the table in **xfPropDataBlob** for more information about the meaning of this field. + +**cb (2 bytes):** An unsigned integer that specifies the size of this XFProp structure. + +**xfPropDataBlob (variable):** A field that specifies the formatting property data. The size and data type of this field varies based on the property type as specified in **xfPropType** as follows: + +| xfPropType value | xfPropDataBlob field Data and Meaning | +|----|----| +| 0x0000 | A [**FillPattern**](#fillpattern) that specifies the [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e). | +| 0x0001 | An [XFPropColor](#xfpropcolor) that specifies the foreground color. | +| 0x0002 | An XFPropColor that specifies the background color. | +| 0x0003 | An [XFPropGradient](#xfpropgradient) that specifies the [**gradient fill**](#gt_35280309-5b22-4c17-be48-f06c37ffc685). This is often followed in the same **xfPropArray** field of the XFProps structure by one or more XFProp structures with **xfPropType** equal to 0x0004, which provides additional specifications for the gradient fill. | +| 0x0004 | An [XFPropGradientStop](#xfpropgradientstop) that specifies a [**gradient stop**](#gt_35b983af-d590-4f93-87cb-94786924511f) for a preceding XFProp with **xfPropType** equal to 0x0003 in the same **xfPropArray** field in the XFProps structure. | +| 0x0005 | An XFPropColor that specifies the text color. | +| 0x0006 | An [XFPropBorder](#xfpropborder) that specifies the top border formatting. | +| 0x0007 | An XFPropBorder that specifies the bottom border formatting. | +| 0x0008 | An XFPropBorder that specifies the left border formatting. | +| 0x0009 | An XFPropBorder that specifies the right border formatting. | +| 0x000A | An XFPropBorder that specifies the diagonal border formatting. | +| 0x000B | An XFPropBorder that specifies the vertical border formatting. | +| 0x000C | An XFPropBorder that specifies the horizontal border formatting. | +| 0x000D | A 1-byte unsigned integer that specifies whether a [**diagonal-up**](#gt_d4878a4d-c65e-471d-b9fb-da7a5a5aa929) border is used. MUST be 0 or 1. The value of 1 means that a diagonal-up border is used. | +| 0x000E | A 1-byte unsigned integer that specifies whether a [**diagonal-down**](#gt_494c0660-9ece-4dcc-b8d3-1a5616a57782) border is used. MUST be 0 or 1. The value of 1 means that a diagonal-down border is used. | +| 0x000F | A [**HorizAlign**](#horizalign) that specifies the [**horizontal alignment**](#gt_f0e60ca8-51d5-4553-9126-3d89a4d08f90). | +| 0x0010 | A [**VertAlign**](#vertalign) that specifies the [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878). | +| 0x0011 | An [XFPropTextRotation](#xfproptextrotation) that specifies the text rotation. | +| 0x0012 | A 2-byte unsigned integer that specifies the absolute text [**indentation level**](#gt_2779d3df-3c50-44dc-9d2d-6996c4573aa9). MUST be less than or equal to 15. The absolute indentation level replaces any previous indentation. | +| 0x0013 | A [**ReadingOrder**](#readingorder) that specifies the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361). | +| 0x0014 | A 1-byte unsigned integer that specifies whether [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) text is wrapped. MUST be 0 or 1. The value of 1 means that the text is wrapped. | +| 0x0015 | A 1-byte unsigned integer that specifies whether cell text is [**justify distributed**](#gt_11eced66-af2c-4391-8b45-87a60ad41483). MUST be 0 or 1. The value of 1 means that the text is justify distributed. If this value is 1 then an XFProp with **xfPropType** equal to 0x000F MUST exist in this **xfPropArray** field of the XFProps structure and MUST equal 0x07. | +| 0x0016 | A 1-byte unsigned integer that specifies whether a cell is [**shrink to fit**](#gt_4740d2ef-00d3-4a29-983c-b7b3a6aa01e0). MUST be 0 or 1. The value of 1 means that the cell is shrink to fit. | +| 0x0017 | A 1-byte unsigned integer that specifies whether a cell is merged. MUST be 0 or 1. The value of 1 means that the cell is merged. | +| 0x0018 | An [LPWideString](#lpwidestring) that specifies the font name used by the cell data. MUST be less than or equal to 32 characters in length. | +| 0x0019 | A [**Bold**](#bold) that specifies the [**font face weight**](#gt_8fd5e2d4-bd9a-48f2-ba16-42d23697508c). | +| 0x001A | An [**Underline**](#underline) that specifies the underline style. | +| 0x001B | A [**Script**](#script) that specifies the superscript or subscript style. | +| 0x001C | A 1-byte unsigned integer that specifies whether text is italicized. MUST be 0 or 1. The value of 1 means that the text is italic. | +| 0x001D | A 1-byte unsigned integer that specifies whether text has [**strikethrough formatting**](#gt_b16d9600-aebb-4a4f-bf14-c38e13c11c14) applied. MUST be 0 or 1. The value of 1 means that the text has strikethrough formatting applied. | +| 0x001E | A 1-byte unsigned integer that specifies whether text has an outline style. MUST be 0 or 1. The value of 1 means that the text is outline style. | +| 0x001F | A 1-byte unsigned integer that specifies whether text has a shadow style. MUST be 0 or 1. The value of 1 means that the text is shadow style. | +| 0x0020 | A 1-byte unsigned integer that specifies whether text is condensed. MUST be 0 or 1. The value of 1 means that the text is condensed. | +| 0x0021 | A 1-byte unsigned integer that specifies whether text is extended. MUST be 0 or 1. The value of 1 means that the text is extended. | +| 0x0022 | A 1-byte unsigned integer that specifies a [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204). For more information about character sets, see the Windows API LOGFONT structure in [\[MSDN-FONTS\]](https://go.microsoft.com/fwlink/?LinkId=90008). | +| 0x0023 | A 1-byte unsigned integer that specifies a [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2). For more information about font families, see the Windows API LOGFONT structure in \[MSDN-FONTS\]. MUST be greater than or equal to 0 and less than or equal to 5. | +| 0x0024 | A 4-byte unsigned integer that specifies text size in [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382). MUST be greater than or equal to 20 and less than or equal to 8191. | +| 0x0025 | A [**FontScheme**](#fontscheme) that specifies the [**font scheme**](#gt_d2cfdc52-4222-46a7-8c1e-fffdcadcb973) of a [**theme**](#gt_8b5eb4c0-949b-47d9-8b63-b9bda81d61b8) [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). | +| 0x0026 | A [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) as specified by the **stFormat** field of [Format](#format) that specifies the number [**format string**](#gt_07085e26-506a-4b35-81ad-972464e277ff). | +| 0x0029 | An [IFmt](#ifmt) that specifies a number format identifier. | +| 0x002A | A 2-byte signed integer that specifies the relative text indentation level. The relative indentation level is added to any previous indentation. The value MUST either be greater than or equal to -15 and less than or equal to 15, or it MUST be 255. Values -15 through 15 specify a relative indentation level, and the value 255 specifies the absence of a relative indentation level. | +| 0x002B | A 1-byte unsigned integer that specifies whether the [**locked protection**](#gt_10f1ec97-0464-49da-bf78-5339b9d3520c) property is set to true. MUST be 0 or 1. The value of 1 means that the property is set to true. | +| 0x002C | A 1-byte unsigned integer that specifies whether the [**hidden protection**](#gt_1b14d877-9a96-485f-8eb8-b2c26f3355cf) property is set to true. MUST be 0 or 1. The value of 1 means that the property is set to true. | + +### XFPropBorder + +The **XFPropBorder** structure specifies [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad). + +[TABLE] + +**color (8 bytes):** An [XFPropColor](#xfpropcolor) that specifies the border color. + +**dgBorder (2 bytes):** A [BorderStyle](#borderstyle) that specifies the border [**line style**](#gt_a6d51057-258d-42cc-9920-6e08c10d2447). + +### XFPropColor + +The **XFPropColor** structure specifies a color. + +[TABLE] + +**A - fValidRGBA (1 bit):** A bit that specifies whether the **xclrType, icv** and **nTintShade** fields were used to set the **dwRgba** field. MUST equal 1. + +**xclrType (7 bits):** An [**XColorType**](#xcolortype) that specifies how the color information is stored. + +**icv (1 byte):** An unsigned integer that specifies color information. If **xclrType** equals 0x01, this field MUST be one of the values specified in [IcvXF](#icvxf), or equal 0. If **xclrType** equals 0x03, this field MUST be one of the values specified in [ColorTheme](#colortheme). Otherwise this field is undefined and MUST be ignored. + +**nTintShade (2 bytes):** A signed integer that specifies the tint of the color. This value is mapped to the range -1.0 to 1.0. Positive values lighten the color, and negative values darken the color. MUST NOT equal -32768. + +**dwRgba (4 bytes):** A [LongRGBA](#longrgba) that specifies the color. + +### XFPropGradient + +The **XFPropGradient** structure specifies a [**gradient fill**](#gt_35280309-5b22-4c17-be48-f06c37ffc685). + +[TABLE] + +**type (4 bytes):** A Boolean (section [2.5.14](#boolean)) that specifies the gradient type. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x00000000 | [**Linear gradient**](#gt_66edee6e-7500-4703-853d-44f9cd16540a) | +| 0x00000001 | [**Rectangular gradient**](#gt_bc10f1e2-8a79-4d73-92ff-f4648d3f0ada) | + +**numDegree (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the gradient angle in degrees for a linear gradient. The gradient angle specifies the angle at which gradient strokes are drawn. + +**numFillToLeft (8 bytes):** An Xnum that specifies the left coordinate of the [**inner rectangle**](#gt_7f6fb91e-9a0b-42e8-93ff-751448f7f80f) for a rectangular gradient, where (0.0,0.0) is the upper-left hand corner of the inner rectangle. MUST be greater than or equal to 0.0 and less than or equal to 1.0. + +**numFillToRight (8 bytes):** An Xnum that specifies the right coordinate of the inner rectangle for a rectangular gradient, where (0.0,0.0) is the upper-left hand corner of the inner rectangle. MUST be greater than or equal to 0.0 and less than or equal to 1.0. + +**numFillToTop (8 bytes):** An Xnum that specifies the top coordinate of the inner rectangle for a rectangular gradient, where (0.0,0.0) is the upper-left hand corner of the inner rectangle. MUST be greater than or equal to 0.0 and less than or equal to 1.0. + +**numFillToBottom (8 bytes):** An Xnum that specifies the bottom coordinate of the inner rectangle for a rectangular gradient, where (0.0,0.0) is the upper-left hand corner of the inner rectangle. MUST be greater than or equal to 0.0 and less than or equal to 1.0. + +### XFPropGradientStop + +The **XFPropGradientStop** structure specifies a [**gradient stop**](#gt_35b983af-d590-4f93-87cb-94786924511f) for a [**gradient fill**](#gt_35280309-5b22-4c17-be48-f06c37ffc685). + +[TABLE] + +**unused (2 bytes):** Undefined and MUST be ignored. + +**numPosition (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the gradient stop position. The gradient stop position is the position within the gradient range where this gradient stop’s color begins. MUST be greater than or equal to 0.0 and less than or equal to 1.0. + +**color (8 bytes):** An [XFPropColor](#xfpropcolor) that specifies the gradient stop color. + +### XFProps + +This structure specifies an array of formatting properties. + +[TABLE] + +**reserved (2 bytes):** MUST be zero and MUST be ignored. + +**cprops (2 bytes):** An unsigned integer that specifies the number of [XFProp](#xfprop) structures in **xfPropArray.** + +**xfPropArray (variable):** An array of XFProp. Each array element specifies a formatting property. The array of properties specifies the full set of formatting properties. If the array contains an XFProp with an **xfPropType** field equaling 0, the array MUST NOT contain any XFProp elements with **xfPropType** fields equaling 3 or 4. If the array contains an XFProp with an **xfPropType** field equaling 3 or 4, the array MUST NOT contain any XFProp elements with an **xfPropType** field equaling 0. + +### XFPropTextRotation + +The **XFPropTextRotation** structure specifies the text rotation. + +[TABLE] + +**trot (1 byte):** An unsigned integer that specifies the text rotation. MUST be a value from the following table: + +| Value | Meaning | +|--------------------------|-----------------------------------------------| +| 0x00 to 0x5A (0 to 90) | Text rotated counterclockwise 0 to 90 degrees | +| 0x5B to 0xB4 (91 to 180) | Text rotated clockwise 1 to 90 degrees | +| 0xFF (255) | Vertical text | + +### XLNameUnicodeString + +The **XLNameUnicodeString** structure specifies a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + +[TABLE] + +**name (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the name. The number of characters in the string, **name.cch,** MUST be greater than or equal to 1 and less than or equal to 255. + +This field MUST adhere to the following grammar: + +465. name = name-start-character, \*name-characters + + name-start-character = "\_" / "\\ / Unicode-character + + name-character = name-start-character / "." / "?" / 0x061F / Unicode-digit + +where: + +Unicode-character is any code point which is a character as defined by the Unicode character properties in chapter four of the [\[RFC2781\]](https://go.microsoft.com/fwlink/?LinkId=90380) + +Unicode-digit is any code point which is a digit as defined by the Unicode character properties in chapter four of the \[RFC2781\]. + +This field MUST NOT be equal to "TRUE" or "FALSE" using case-insensitive string comparison. This field MUST NOT be an [**R1C1**](#gt_c7769777-74d5-4020-b9e5-4cd863f70132) or [**A1**](#gt_950691d0-4b64-4e03-84ae-10d6c872bbdb) [**cell reference**](#gt_4d15aeb2-3a7d-44d7-b8d1-8a441f1cc24f). + +An R1C1 [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) reference is defined to be: + +470. R1C1-cell-reference= R1C1-row R1C1-column / R1C1-column R1C1-row + + R1C1-row = letter-r row-number + + letter-r = "R" / "r" + + R1C1-column = letter-c column-number + + letter-c = "C" / "c" + + column-number = 1-256 + + row-number = 1-65536 + +An A1 cell reference is defined as follows: + +482. A1-reference = A1-column A1-Row + + A1-row = row-number + + ; See definition of row-number in R1C1 cell reference grammar specified previously. + + A1-column = letter / letter-limited-one letter / letter-i letter-limited-two + + letter-limited-one = "A" / "B" / "C" / "D" / "E" / "F" / "G" / "H" / "a" / "b" / "c" / "d" / "e" / "f" / "g" / "h" + + letter-limited-two = letter-limited-one / "I" / "J" / "K" / "L" / "M" / "N" / "O" / "P" / "Q" / "R" / "S" / "T" / "U" / "V" / "i" / "j" / "k" / "l" / "m" / "n" / "o" / "p" / "q" / "r" / "s" / "t" / "u" / "v" + + letter-i = "I" / "i" + + letter = letter-limited-two / "W" / "X" / "Y" / "Z" / "w" / "x" / "y" / "z" + +### XlsFilter_Criteria + +The **XlsFilter_Criteria** structure specifies [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) criteria. + +[TABLE] + +**ezdoper1 (10 bytes):** An [SXEZDoper](#sxezdoper) structure that specifies the first filter operation. If the **ccriteria** field of the [SXAddl_SXCSXFilter12_SXDXlsFilter](#sxaddl_sxcsxfilter12_sxdxlsfilter) that contains this structure is zero, then **ezdoper1.vts** MUST be zero and **ezdoper1** MUST be ignored. If **ezdoper1.vts** equals 0x6, the following record MUST be [SXAddl_SXCSXFilter12_SXDXlsFilterValue1](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1). + +**ezdoper2 (10 bytes):** An SXEZDoper structure that specifies the second filter operation. If the **ccriteria** field of the SXAddl_SXCSXFilter12_SXDXlsFilter that contains this structure is not equal to 2, then **ezdoper2.vts** MUST be zero and **ezdoper2** MUST be ignored. If **ezdoper1.vts** is not 0x6 and **ezdoper2.vts** is 0x6, then the following record is [SXAddl_SXCSXFilter12_SXDXlsFilterValue2](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2). If both **ezdoper1.vts** and **ezdoper2.vts** are 0x6, then the following record is SXAddl_SXCSXFilter12_SXDXlsFilterValue1, and the next non- [Continue_SxaddlSxString](#continue_sxaddlsxstring) record after that is SXAddl_SXCSXFilter12_SXDXlsFilterValue2. + +**djoin1 (4 bytes):** A [**DJoin**](#djoin) that specifies the join operation between **ezdoper1** and **ezdoper2**. + +MUST be DJOINNULL if the **ccriteria** field of the SXAddl_SXCSXFilter12_SXDXlsFilter record is less than 2. + +**reserved (4 bytes):** MUST be zero, and MUST be ignored. + +### XlsFilter_Top10 + +The **XlsFilter_Top10** structure specifies filter information for a [**top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9). + +[TABLE] + +**top10ft (4 bytes):** A [Top10FT](#top10ft) that specifies the top N filter type. + +**A - fTop (1 bit):** A bit that specifies whether the filter displays the top or bottom records. + +| Value | Meaning | +|-------|-----------------------------| +| 0 | Display the bottom records. | +| 1 | Display the top records. | + +**reserved1 (15 bits):** MUST be zero, and MUST be ignored. + +**numTopN (8 bytes):** An Xnum (section [2.5.342](#xnum)) that specifies the number or percentage of records to include. + +If **top10Ft** is TOP10FTPERCENT, **numTopN** specifies the percentage of records to include; otherwise **numTopN** specifies the number of records to include. + +If **top10ft** is TOP10FTPERCENT, **numTopN** MUST be greater than or equal to 0 and less than or equal to 100. + +If **top10ft** is TOP10FTSUM, **numTopN** MUST be greater than or equal to 0 and less than or equal to 2147483647. + +If **top10ft** is TOP10FTCOUNT, **numTopN** MUST be an integer greater than or equal to 0 and less than or equal to 2147483647. + +**reserved2 (14 bytes):** MUST be zero, and MUST be ignored. + +### XLUnicodeRichExtendedString + +The **XLUnicodeRichExtendedString** structure specifies a Unicode string, which can contain formatting information and [**phonetic string**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77) data. + +This structure’s non-variable fields MUST be specified in the same record. + +This structure’s variable fields can be extended with [Continue](#continue) records. A value from the table for **fHighByte** MUST be specified in the first byte of the **continue** field of the Continue record followed by the remaining portions of this structure’s variable fields. + +[TABLE] + +**cch (2 bytes):** An unsigned integer that specifies the count of characters in the string. + +**A -** **fHighByte (1 bit):** A bit that specifies whether the characters in **rgb** are double-byte characters. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | All the characters in the string have a high byte of 0x00 and only the low bytes are in **rgb**. | +| 0x1 | All the characters in the string are saved as double-byte characters in **rgb**. | + +**B - reserved1 (1 bit):** MUST be zero, and MUST be ignored. + +**C - fExtSt (1 bit):** A bit that specifies whether the string contains phonetic string data. + +**D - fRichSt (1 bit):** A bit that specifies whether the string is a rich string and the string has at least two character formats applied. + +**reserved2 (4 bits):** MUST be zero, and MUST be ignored. + +**cRun (2 bytes):** An optional unsigned integer that specifies the number of elements in **rgRun**. MUST exist if and only if **fRichSt** is 0x1. + +**cbExtRst (4 bytes):** An optional signed integer that specifies the byte count of **ExtRst**. MUST exist if and only if **fExtSt** is 0x1. MUST be zero or greater. + +**rgb (variable):** An array of bytes that specifies the characters in the string. If **fHighByte** is 0x0, the size of the array is **cch**. If **fHighByte** is 0x1, the size of the array is **cch**\*2. If **fHighByte** is 0x1 and **rgb** is extended with a Continue record the break MUST occur at the double-byte character boundary. + +**rgRun (variable):** An optional array of [FormatRun](#formatrun) structures that specifies the formatting for each [**text run**](#gt_393612a7-9552-48b0-abf6-0371dbd6d553). The number of elements in the array is **cRun**. MUST exist if and only if **fRichSt** is 0x1. + +**ExtRst (variable):** An optional [ExtRst](#extrst) that specifies the phonetic string data. The size of this field is **cbExtRst**. MUST exist if and only if **fExtSt** is 0x1. + +### XLUnicodeString + +The **XLUnicodeString** structure specifies a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string. + +[TABLE] + +**cch (2 bytes):** An unsigned integer that specifies the count of characters in the string. + +**A -** **fHighByte (1 bit):** A bit that specifies whether the characters in **rgb** are double-byte characters. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | All the characters in the string have a high byte of 0x00 and only the low bytes are in **rgb**. | +| 0x1 | All the characters in the string are saved as double-byte characters in **rgb**. | + +**reserved (7 bits):** MUST be zero, and MUST be ignored. + +**rgb (variable):** An array of bytes that specifies the characters. If **fHighByte** is 0x0, the size of the array MUST be equal to **cch**. If **fHighByte** is 0x1, the size of the array MUST be equal to **cch\***2. + +### XLUnicodeStringMin2 + +The **XLUnicodeStringMin2** structure specifies a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string. + +[TABLE] + +**cch (2 bytes):** An unsigned integer that specifies the count of characters in the string. MUST be equal to the number of characters in **st**. + +**st (variable):** An optional [XLUnicodeStringNoCch](#xlunicodestringnocch) that specifies the string. MUST exist if and only if **cch** is greater than zero. + +### XLUnicodeStringNoCch + +The **XLUnicodeStringNoCch** structure specifies a Unicode string. When an XLUnicodeStringNoCch is used, the count of characters in the string MUST be specified in the structure that uses the XLUnicodeStringNoCch. + +[TABLE] + +**A - fHighByte (1 bit):** A bit that specifies whether the characters in **rgb** are double-byte characters. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | All the characters in the string have a high byte of 0x00 and only the low bytes are in **rgb**. | +| 0x1 | All the characters in the string are saved as double-byte characters in **rgb**. | + +**reserved (7 bits):** MUST be zero, and MUST be ignored. + +**rgb (variable):** An array of bytes that specifies the characters. If **fHighByte** is 0x0, the size of the array MUST be equal to the count of characters in the string. If **fHighByte** is 0x1, the size of the array MUST be equal to 2 times the count of characters in the string. + +### XLUnicodeStringSegmented + +The **XLUnicodeStringSegmented** structure specifies a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string that is split into multiple string segments. If the count of characters in the string is greater than 512, the string is split into multiple string segments, each of which has a character count of 512 or less. + +[TABLE] + +**cchTotal (4 bytes):** An unsigned integer that specifies the total count of characters in the string. MUST be less than 2147483644. + +**strings (variable):** An array of [XLUnicodeString](#xlunicodestring). Each element specifies a string segment. The **cch** field of each XLUnicodeString element MUST be less than or equal to 512 and greater than 0, and the sum of the **cch** fields of all XLUnicodeString elements MUST be equal to **cchTotal**. MUST exist if and only if **cchTotal** is greater than zero. + +### XLUnicodeStringSegmentedRTD + +The **XLUnicodeStringSegmentedRTD** structure specifies a Unicode string that contains a set of sub-strings. + +[TABLE] + +**cch (4 bytes):** An unsigned integer that specifies the size of **rgb**. + +**A - fHighByte (1 bit):** A bit that specifies whether the characters in **rgb** are double-byte characters. MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0 | All the characters in the string have a high byte of 0x00 and only the low bytes are in **rgb**. | +| 0x1 | All the characters in the string are saved as double-byte characters in **rgb**. | + +**reserved (7 bits):** MUST be zero, and MUST be ignored. + +**rgb (variable):** An array of bytes that specifies a set of sub-strings. If **fHighByte** is 0x0, the size of the array is **cch**. If **fHighByte** is 0x1, the size of the array is **cch\***2. Each sub-string begins with one or two bytes specifying the count of characters in the sub-string. The count is one byte in length if **fHighByte** is zero and two bytes in length if **fHighByte** is 1. The number of the sub-strings MUST be greater than 2 and less than 40. + +### XLUnicodeStringSegmentedSXAddl + +The **XLUnicodeStringSegmentedSXAddl** structure specifies a Unicode string segment. [SXAddl](#sxaddl) records use this structure to represent Unicode strings. If the count of characters in the string is greater than 255, the string is split into multiple segments. Each string segment has a character count of 255 or less, and each segment is stored in an SXAddl record. + +[TABLE] + +**cchTotal (4 bytes):** An unsigned integer that specifies the total count of characters in the string. If this is the first segment of a string, **cchTotal** MUST be greater than 0. If this is not the first segment of a string, **cchTotal** MUST be zero. + +**reserved (2 bytes):** MUST be zero, and MUST be ignored. + +**string (variable):** An [XLUnicodeString](#xlunicodestring) that specifies the string segment. The **cch** field of **string** MUST be less than or equal to 255 and greater than 0. + +### XmlTkBackWallThicknessFrt + +The **XmlTkBackWallThicknessFrt** structure specifies the thickness of the back wall of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) as a percentage of the depth of the 3-D [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). The back wall is the [**wall**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c) that is parallel to the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the back wall thickness is greater than 0. MUST only be specified if the chart contains a [Chart3d](#chart3d) record. + +[TABLE] + +**wallThickness (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies the thickness of the back wall of the chart as a percentage of the depth of the 3-D plot area. The **wallThickness.dValue** MUST be greater than 0, and less than or equal to 100. The **wallThickness.xtHeader.xmlTkTag** field MUST be equal to 0x0035. + +### XmlTkBaseTimeUnitFrt + +The **XmlTkBaseTimeUnitFrt** structure specifies the value of the smallest unit of time used by the date [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fAutoBase** field of the corresponding [AxcExt](#axcext) record is set to 1 and the **fDateAxis** of the corresponding AxcExt record is equal to 1. + +[TABLE] + +**baseUnit (6 bytes):** An [XmlTkToken](#xmltktoken) that specifies a value that can override the **duBase** field of the corresponding AxcExt record. The **baseUnit**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x005F. This field overrides the **duBase** field of the corresponding AxcExt record when the **fAutoBase** field of the AxcExt record is set to 1. The **baseUnit.dValue** MUST be a value from the following table: + +| Value | Meaning | +|--------|-----------------------------------| +| 0x0060 | Time value is measured in days. | +| 0x0061 | Time value is measured in months. | +| 0x0062 | Time value is measured in years. | + +### XmlTkBlob + +The **XmlTkBlob** structure specifies an array of bytes for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + +[TABLE] + +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x07. + +**cbBlob (4 bytes):** An unsigned integer that specifies the count of bytes of the **rgbBlob** field. + +**rgbBlob (variable):** An array of bytes for the **xmltkChain** field of the CrtMlFrt record. The size of this field, in bytes, is specified by the **cbBlob** field. + +### XmlTkBool + +The **XmlTkBool** structure specifies a Boolean (section [2.5.14](#boolean)) value for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + +[TABLE] + +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x02. + +**dValue (1 byte):** A Boolean that specifies the value of this structure. + +**unused (1 byte):** Undefined, and MUST be ignored. + +### XmlTkChain + +The **XmlTkChain** structure specifies a chain of structures that specifies a group of additional properties or property overrides for a given [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) element, specified by the **xmltkParent** field. See meanings of the additional properties or property overrides in each token structure. + +[TABLE] + +**recordVersion (1 byte):** An unsigned integer that specifies the chain version. MUST be 0. + +**unused (1 byte):** Undefined, and MUST be ignored. + +**xmltkParent (2 bytes):** An unsigned integer that specifies the chart element targeted by the token structures in the chain. MUST be a value from the following table: + +[TABLE] + +**chainRecords (variable):** A chain of structures that specifies the additional properties or property overrides for a given chart element, specified by the **xmltkParent** field. The token sequence [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) for each **xmltkParent** is specified according to the following table: + +[TABLE] + +### XmlTkColorMappingOverride + +The **XmlTkColorMappingOverride** structure specifies the color mapping override for a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), stored as an **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)) as specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, section 19.3.1.7. + +[TABLE] + +**rgThemeOverride (variable):** An [XmlTkBlob](#xmltkblob) that specifies the color mapping override. The **rgThemeOverride.xtHeader.xmlTkTag** MUST be equal to 0x0034. The **XML stream** (section 2.1.7.22) is specified in \[ECMA-376\] Part 1, section 19.3.1.7, and compressed by the compression algorithm specified in [\[RFC1951\]](https://go.microsoft.com/fwlink/?LinkId=90302). + +### XmlTkDispBlanksAsFrt + +The **XmlTkDispBlanksAsFrt** structure specifies how blank data entries are represented. This structure MUST only be present if the current [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) does not support displaying blank entries. The following [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) types do not support blank entries: area chart group, pie chart group, line chart group with **fStacked** field of the [Line](#line) record equal to 1, bar of pie chart group, pie of pie chart group and doughnut chart group. + +[TABLE] + +**blanksAs (6 bytes):** An [XmlTkToken](#xmltktoken) that specifies how blank data entries are represented on the current chart. The **blanksAs.xtHeader.xmlTkTag** field MUST be equal to 0x0066. This field overrides the **mdBlank** field of the [ShtProps](#shtprops) record that specifies the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). The **blanksAs.dValue** field MUST be a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0067 | Specifies that blank values are shown as a gap. | +| 0x0069 | Specifies that blank values are spanned with a line. The current chart group type MUST be area chart group or line chart group with **fStacked** field of the Line record equal to 1. | + +### XmlTkDouble + +The **XmlTkDouble** structure specifies an Xnum (section [2.5.342](#xnum)) value for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + +[TABLE] + +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x03. + +**unused (4 bytes):** Undefined, and MUST be ignored. + +**dValue (8 bytes):** An Xnum that specifies the value of this structure. + +### XmlTkDWord + +The **XmlTkDWord** structure specifies an integer value for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + +[TABLE] + +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x04. + +**dValue (4 bytes):** A signed integer that specifies the value of this structure. + +### XmlTkEnd + +The **XmlTkEnd** structure specifies the end of a group of structures for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + +[TABLE] + +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x01. + +### XmlTkEndSurface + +The **XmlTkEndSurface** structure specifies the end of a back wall definition. The back wall is the [**wall**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c) that is parallel to the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure defines additional properties for the back wall of the current [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). This structure MUST have a corresponding [XmlTkStartSurface](#xmltkstartsurface) structure. + +[TABLE] + +**endSurface (4 bytes):** An [XmlTkEnd](#xmltkend) that specifies the end of a back wall definition. The **endSurface.xtHeader.xmlTkTag** field MUST be equal to the **startSurface.xtHeader.xmlTkTag** of the corresponding XmlTkStartSurface structure. + +### XmlTkFloorThicknessFrt + +The **XmlTkFloorThicknessFrt** structure specifies the thickness of the [**floor**](#gt_dc38c098-e0d3-4701-9656-5f2cf4d80f29) of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) as a percentage of the height of the 3-D [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). This structure MUST only be present if the floor thickness is greater than 0. MUST only be specified if the chart contains a [Chart3d](#chart3d) record. + +[TABLE] + +**floorThickness (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies the thickness of the floor of the chart as a percentage of the height of the 3-D plot area. The **floorThickness.dValue** MUST be greater than 0, and less than or equal to 100. The **floorThickness.xtHeader.xmlTkTag** field MUST be equal to 0x0036. + +### XmlTkFormatCodeFrt + +The **XmlTkFormatCodeFrt** structure specifies the number formatting to use for the [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) labels on the date axis. This structure MUST only be present if the **fUnlinkedIfmt** field of the [BRAI](#brai) record that corresponds to the axis labels of the date axis is set to 0. This structure MUST only be present if the **fDateAxis** of the corresponding [AxcExt](#axcext) record is equal to 1. + +[TABLE] + +**stFormat (variable):** An [XmlTkString](#xmltkstring) that specifies the number formatting to use for the axis labels of the date axis. Details about the structure of [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) string are specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1: Fundamentals And Markup Language Reference, section 18.8.31. This field overrides the **ifmt** field of the corresponding BRAI record when the **fUnlinkedIfmt** field of the BRAI record is set to 0. The **stFormat.xtHeader.xmlTkTag** field MUST be equal to 0x0064. + +### XmlTkHeader + +The **XmlTkHeader** structure specifies the header of the [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) token data types. + +[TABLE] + +**drType (1 byte):** An unsigned integer that specifies the data type. MUST be specified by the containing structure. + +**unused (1 byte):** Undefined, and MUST be ignored. + +**xmlTkTag (2 bytes):** An unsigned integer that specifies the token identifier. MUST be specified by the containing structure. + +### XmlTkHeightPercent + +The **XmlTkHeightPercent** structure specifies the height of the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) as a percentage of its width. This record MUST NOT exist for a pie [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), and MUST only exist when a [Chart3d](#chart3d) record is present and the **f3DScaling** field of the Chart3d record is equal to 1. + +[TABLE] + +**heightPercent (16 bytes):** An [XmlTkDouble](#xmltkdouble) that specifies the height of the plot area as a percentage of its width. **heightPercent.dValue** MUST be greater than or equal to 5, MUST be less than the maximum value of Xnum , and SHOULD[\<190\>](#Appendix_A_190) be less than or equal to 500. This field overrides the **pcHeight** field of the Chart3d record in the [chart sheet](#chart-sheet-substream) substream. The **heightPercent.xtHeader.xmlTkTag** MUST be equal to 0x0065. + +### XmlTkLogBaseFrt + +The **XmlTkLogBaseFrt** structure specifies the logarithmic base of a logarithmic value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fLog** field of the corresponding [ValueRange](#valuerange) record is set to 1, and the logarithmic base is not 10. + +[TABLE] + +**logScale (16 bytes):** An [XmlTkDouble](#xmltkdouble) that specifies the logarithmic base of a logarithmic value axis. **logScale.dValue** MUST be greater than or equal to 2, and less than or equal to 1000. The **logScale**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x0000. This field overrides the base, 10, of the logarithmic value axis when the **fLog** field of the corresponding ValueRange record is set to 1. + +### XmlTkMajorUnitFrt + +The **XmlTkMajorUnitFrt** structure specifies the value of the interval at which the [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) are displayed on the date [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fAutoBase** field of the corresponding [AxcExt](#axcext) record is set to 1 and the **fDateAxis** field of the corresponding AxcExt record is equal to 1. + +[TABLE] + +**majorUnit (16 bytes):** An [XmlTkDouble](#xmltkdouble) that specifies a value that can override the **catMajor** field of the corresponding AxcExt record. The **majorUnit**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x0053. This field overrides the **catMajor** field of the corresponding AxcExt record when the **fAutoMajor** field of the AxcExt record is set to 1. + +### XmlTkMajorUnitTypeFrt + +The **XmlTkMajorUnitTypeFrt** structure specifies the value of the unit of time used by the interval at which the [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) are displayed on the date [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fAutoBase** field of the corresponding [AxcExt](#axcext) record is set to 1 and the **fDateAxis** of the corresponding AxcExt record is equal to 1. + +[TABLE] + +**majorUnit (6 bytes):** An [XmlTkToken](#xmltktoken) that specifies a value that can override the **duMajor** field of the corresponding AxcExt record. The **majorUnit**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x006A. This field overrides the **duMajor** field of the corresponding AxcExt record when the **fAutoMajor** field of the AxcExt record is set to 1. The **majorUnit.dValue** MUST be a value from the following table: + +| Value | Meaning | +|--------|-----------------------------------| +| 0x0060 | Time value is measured in days. | +| 0x0061 | Time value is measured in months. | +| 0x0062 | Time value is measured in years. | + +### XmlTkMaxFrt + +The **XmlTkMaxFrt** structure specifies the maximum value on a logarithmic value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fAutoMax** field of the corresponding [ValueRange](#valuerange) record is set to 0, the **fLog** field of the corresponding ValueRange record is set to 1, and the logarithmic base is not 10. + +[TABLE] + +**maxScale (16 bytes):** An [XmlTkDouble](#xmltkdouble) that specifies the maximum value on a logarithmic value axis. The **maxScale.dValue** MUST be greater than the value specified in the **minScale.dValue** field of the [XmlTkMinFrt](#xmltkminfrt) structure. The **maxScale**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x0055. This field overrides the **numMax** field of the associated ValueRange record when the **fLog** field of the ValueRange record is set to 1. + +### XmlTkMinFrt + +The **XmlTkMinFrt** structure specifies the minimum value on a logarithmic value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fAutoMin** field of the corresponding [ValueRange](#valuerange) record is set to 0, the **fLog** field of the corresponding ValueRange record is set to 1, and the logarithmic base is not 10. + +[TABLE] + +**minScale (16 bytes):** An [XmlTkDouble](#xmltkdouble) that specifies the minimum value on a logarithmic value axis. The **minScale.dValue** MUST be less than the value specified in the **maxScale.dValue** field of the [XmlTkMaxFrt](#xmltkmaxfrt) structure. The **minScale**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x0056. This field overrides the **numMin** field of the associated ValueRange record when the **fLog** field of the ValueRange record is set to 1. + +### XmlTkMinorUnitFrt + +The **XmlTkMinorUnitFrt** structure specifies the value of the interval at which the [**minor tick marks**](#gt_c2eb605a-6c5a-427e-8608-f16940de82a6) are displayed on the date [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fAutoBase** field of the corresponding [AxcExt](#axcext) record is set to 1 and the **fDateAxis** of the corresponding AxcExt record is equal to 1. + +[TABLE] + +**minorUnit (16 bytes):** An [XmlTkDouble](#xmltkdouble) that specifies a value that can override the **catMinor** field of the corresponding AxcExt record. The **minorUnit**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x0054. This field overrides the **catMinor** field of the corresponding AxcExt record when the **fAutoMinor** field of the AxcExt record is set to 1. + +### XmlTkMinorUnitTypeFrt + +The **XmlTkMinorUnitTypeFrt** structure specifies the value of the unit of time used by the interval at which the [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) are displayed on the date [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST only be present if the **fAutoBase** field of the corresponding [AxcExt](#axcext) record is set to 1 and the **fDateAxis** of the corresponding AxcExt record is equal to 1. + +[TABLE] + +**minorUnit (6 bytes):** An [XmlTkToken](#xmltktoken) that specifies a value that can override the **duMinor** field of the corresponding AxcExt record. The **minorUnit**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x006B. This field overrides the **duMinor** field of the corresponding AxcExt record when the **fAutoMinor** field of the AxcExt record is set to 1. The **minorUnit.dValue** MUST be a value from the following table: + +| Value | Meaning | +|--------|-----------------------------------| +| 0x0060 | Time value is measured in days. | +| 0x0061 | Time value is measured in months. | +| 0x0062 | Time value is measured in years. | + +### XmlTkNoMultiLvlLbl + +The **XmlTkNoMultiLvlLbl** structure specifies whether multi-level labeling is enabled for a [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). + +[TABLE] + +**fNoMultiLvlLbl (6 bytes):** An [XmlTkBool](#xmltkbool) that specifies whether single-level labeling is enabled for a category axis. The **fNoMultiLvlLbl**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x002E. MUST be a value from the following table: + +| Value | Meaning | +|-------|-------------------------------------------------------| +| 0 | Multi-level labeling is enabled for a category axis. | +| 1 | Single-level labeling is enabled for a category axis. | + +### XmlTkOverlay + +The **XmlTkOverlay** structure specifies whether the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) [legend](#Section_1832229b7d1945f488d455e9c07466f0) and title can overlap or can overlap other chart elements. + +[TABLE] + +**fOverlay (6 bytes):** An [XmlTkBool](#xmltkbool) that specifies whether the chart legend or title can overlap or can overlap other chart elements. **fOverlay.dValue** MUST be 1. The **fOverlay**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x002F. + +### XmlTkPerspectiveFrt + +The **XmlTkPerspectiveFrt** structure specifies the angle of the field of view for the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). This structure MUST exist only for bar [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5) and pie chart groups, and MUST exist only when the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) contains a [Chart3d](#chart3d) record and the **fPerspective** field of the Chart3d record equal to 1. When the angle of the field of view is the default angle, 20, this structure MUST NOT be present. + +[TABLE] + +**perspectiveAngle (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies the angle of the field of view. The **perspectiveAngle.xtHeader.xmlTkTag** field MUST be 0x004D. The value of **perspectiveAngle.dValue** field MUST equal to two times the view angle and MUST be greater than or equal to 0 and less than or equal to 200. This field overrides the **pcDist** field of the Chart3d record in the [chart sheet](#chart-sheet-substream) substream. + +### XmlTkPieComboFrom12Frt + +The **XmlTkPieComboFrom12Frt** structure specifies whether the current [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) contains multiple [chart groups](#Section_c91fdf3195e2495fa48a5546ce20c0c5) and one of them is a pie chart group. + +[TABLE] + +**fPieCombo (6 bytes):** An [XmlTkBool](#xmltkbool) that specifies whether the current chart contains multiple chart groups and one of them is a pie chart group. **fPieCombo.dValue** MUST be 1. The **fPieCombo**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x005E. + +### XmlTkRAngAxOffFrt + +The **XmlTkRAngAxOffFrt** structure specifies whether the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) is rendered with a vanishing point, rather than rendered at right angles. This structure MUST only exist for a bar [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), and only when the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) contains a [Chart3d](#chart3d) record is present and the **fPerspective** field of the Chart3d record equal to 1. + +[TABLE] + +**fRightAngAxOff (6 bytes):** An [XmlTkBool](#xmltkbool) that specifies whether the plot area is rendered with a vanishing point. This field corresponds to the **fPerspective** field of Chart3d record, and it MUST only be present when the **fPerspective** field of the Chart3d record in the [chart sheet](#chart-sheet-substream) substream is equal to 1. The **fRightAngAxOff.dValue** field MUST be equal to 0x01. The **fRightAngAxOff.xtHeader.xmlTkTag** field MUST be equal to 0x0050. + +### XmlTkRotXFrt + +The **XmlTkRotXFrt** structure specifies the clockwise rotation, in degrees, of the 3-D [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) around a horizontal line through the center of the 3-D plot area. It MUST only be present when the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) contains a [Chart3d](#chart3d), and as specified by the **fPerspective** field of the Chart3d record. This structure MUST only exist for a bar [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), and only when the rotation angle is less than 0 or greater than 44. + +[TABLE] + +**rotationX (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies the rotation angle. The **rotationX.xtHeader.xmlTkTag** field MUST be 0x004E. The **rotationX.dValue** field MUST be either greater than or equal to -90 and less than 0, or greater than or equal to 45 and less than or equal to 90. It overrides the **anElev** field of the Chart3d record in the [chart sheet](#chart-sheet-substream) substream. + +### XmlTkRotYFrt + +The **XmlTkRotYFrt** structure specifies the clockwise rotation, in degrees, of the 3-D [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) around a vertical line through the center of the 3-D plot area. MUST exist only when the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) contains a [Chart3d](#chart3d) record, and as specified by the **fPerspective** field of the Chart3d record. This record MUST only exist for a bar [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), and only when the rotation angle is greater than 44. + +[TABLE] + +**rotationY (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies the rotation angle. The **rotationY.xtHeader.xmlTkTag** field MUST be 0x004F. The **rotationY.dValue** field MUST be greater than or equal to 45, and less than or equal to 359. It overrides the **anRot** field of the Chart3d record [chart sheet](#chart-sheet-substream) substream. + +### XmlTkShowDLblsOverMax + +The **XmlTkShowDLblsOverMax** structure specifies whether [data labels](#Section_cac7f43a3af142f58ff2814c2870427f) with values over the maximum value of the value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) are displayed. + +[TABLE] + +**fVDLOverMax (6 bytes):** An [XmlTkBool](#xmltkbool) that specifies whether data labels with values over the maximum value of the value axis of the chart are displayed. The **fVDLOverMax**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x005B. + +### XmlTkSpb + +The **XmlTkSpb** structure specifies the shape formatting information of a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) object, stored as an **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)) as defined in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, section 21.2.2.197. + +[TABLE] + +**shapePropsStream (variable):** An [XmlTkBlob](#xmltkblob) that specifies the shape formatting information. The **shapePropsStream.xtHeader.xmlTkTag** MUST be equal to 0x001E. The **XML stream** (section 2.1.7.22) is defined in \[ECMA-376\] Part 1, section 21.2.2.197, and compressed by the compression algorithm specified in [\[RFC1951\]](https://go.microsoft.com/fwlink/?LinkId=90302). + +### XmlTkStart + +The **XmlTkStart** structure specifies the start of a group of structures for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + +[TABLE] + +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x00. + +### XmlTkStartSurface + +The **XmlTkStartSurface** structure specifies the beginning of a back wall. The back wall definition applies to the current [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) back wall. The back wall is the [**wall**](#gt_c9b1bc1a-a2cf-429d-bf06-27019e9bb73c) that is parallel to the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). This structure MUST have a corresponding [XmlTkEndSurface](#xmltkendsurface) structure. + +[TABLE] + +**startSurface (4 bytes):** An [XmlTkStart](#xmltkstart) that specifies which surface is defined. The **startSurface.xtHeader.xmlTkTag** field MUST be equal to a value from the following table: + +| Value | Meaning | +|--------|---------------------------------| +| 0x0059 | The side wall is being defined. | + +### XmlTkString + +The **XmlTkString** structure specifies a [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string value for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + +[TABLE] + +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x05. + +**cchValue (4 bytes):** An unsigned integer that specifies the count of characters of the **rgbValue** field. + +**rgbValue (variable):** An array of Unicode characters. The size of the array, in characters, is specified by the **cchValue** field. The size of the field, in bytes, MUST equal the result of the following formula: + +498. cchValue \* 2. + +### XmlTkStyle + +The **XmlTkStyle** structure specifies which built-in [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) is applied to the chart. This structure MUST only exist when a non-default chart style is used. + +[TABLE] + +**chartStyle (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies a one-based index into the [Style](#style) record of the [Global substream](#Section_ca4c174887294a93abb94602b3a01fb1). MUST be greater than or equal to 1 and less than or equal to 48. MUST NOT be 2. The **chartStyle.xtHeader.xmlTkTag** MUST be equal to 0x0003. + +### XmlTkSymbolFrt + +The **XmlTkSymbolFrt** structure specifies which built-in marker [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) is applied to the [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) of the current line, scatter or radar [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). + +[TABLE] + +**markerStyle (6 bytes):** An [XmlTkToken](#xmltktoken) that specifies the built-in marker style applied to the data markers of the current line, scatter or radar chart group. The **markerStyle.xtHeader.xmlTkTag** MUST be equal to 0x0022. It overrides the **imk** field of the [MarkerFormat](#markerformat) record when the **fAuto** field of the MarkerFormat record is set to 1. The **markerStyle.dValue** field MUST be equal to a value from the following table: + +| Value | Meaning | +|----|----| +| 0x0023 | Specifies nothing shall be drawn at each [data point](#Section_9c986ad250d44fa1a157063ac5c971a0). | +| 0x0024 | Specifies a diamond shall be drawn at each data point. | +| 0x0025 | Specifies a square shall be drawn at each data point. | +| 0x0026 | Specifies a triangle shall be drawn at each data point. | +| 0x0027 | Specifies an X shall be drawn at each data point. | +| 0x0028 | Specifies a star shall be drawn at each data point. | +| 0x0029 | Specifies a dot shall be drawn at each data point. | +| 0x002A | Specifies a dash shall be drawn at each data point. | +| 0x002B | Specifies a circle shall be drawn at each data point. | +| 0x002C | Specifies a plus shall be drawn at each data point. | + +### XmlTkThemeOverride + +The **XmlTkThemeOverride** structure specifies theme definition override for a [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), stored as an **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)) as defined in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, section 20.1.6.12. + +[TABLE] + +**rgThemeOverride (variable):** An [XmlTkBlob](#xmltkblob) that specifies the theme override. The **rgThemeOverride.xtHeader.xmlTkTag** MUST be equal to 0x0033. The **XML stream** (section 2.1.7.22) is defined in \[ECMA-376\] Part 1, section 20.1.6.12, and compressed by the compression algorithm specified in [\[RFC1951\]](https://go.microsoft.com/fwlink/?LinkId=90302). + +### XmlTkTickLabelPositionFrt + +The **XmlTkTickLabelPositionFrt** structure specifies that [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) labels on a series axis are center-aligned. + +[TABLE] + +**xmltkHigh (6 bytes):** An [XmlTkToken](#xmltktoken) that specifies that axis labels on a series axis are center-aligned. This is equivalent to the **vat** field of the corresponding [Text](#text) record being set to 0x02. The **xmltkHigh**.**dValue** MUST be set to 0x005D. The **xmltkHigh**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x005C. This value overrides the **vat** field of the corresponding Text record when the **vat** field of the Text record is not set to 0x02. + +### XmlTkTickLabelSkipFrt + +The **XmlTkTickLabelSkipFrt** structure specifies the interval of labels on the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) or series axis. This structure MUST only be present if the **catLabel** field of the corresponding [CatSerRange](#catserrange) record is not set to 1. + +[TABLE] + +**nInterval (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies the number of categories between axis labels on a category axis or series axis. The **nInterval**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x0051. It overrides the **catLabel** field of the corresponding CatSerRange record when the **catLabel** field of the CatSerRange record is not set to 1. + +### XmlTkTickMarkSkipFrt + +The **XmlTkTickMarkSkipFrt** structure specifies the number of [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) to skip on a [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) or a [series](#Section_527ce4dfc9f84e50a314d4b07519593c) axis. This structure MUST only be present if the **catMark** field of the corresponding [CatSerRange](#catserrange) record is not set to 1. + +[TABLE] + +**nInterval (8 bytes):** An [XmlTkDWord](#xmltkdword) that specifies the number of major tick marks to skip on a category axis or a series axis. The **nInterval**.**xtHeader**.**xmlTkTag** field MUST be equal to 0x0052. It overrides the **catMark** field of the corresponding CatSerRange record when the **catMark** field of the CatSerRange record is not set to 1. + +### XmlTkToken + +The **XmlTkToken** structure specifies a constant value for the **xmltkChain** field of the [CrtMlFrt](#crtmlfrt) record. + +[TABLE] + +**xtHeader (4 bytes):** An [XmlTkHeader](#xmltkheader). The **xtHeader**.**drType** field MUST be equal to 0x06. + +**dValue (2 bytes):** An unsigned integer that specifies the value of this structure. + +### XmlTkTpb + +The **XmlTkTpb** structure specifies text formatting information for the current chart [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) element, stored as an **XML stream** (section [2.1.7.22](#Section_e25e01370b9c4429bd260eed92e01c35)), as specified in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) Part 1, section 21.2.2.216. + +[TABLE] + +**textPropsStream (variable):** An [XmlTkBlob](#xmltkblob) that specifies the text formatting information. The **textPropsStream.xtHeader.xmlTkTag** MUST be equal to 0x0020. The **XML stream** (section 2.1.7.22) is specified in \[ECMA-376\] Part 1, section 21.2.2.216, and compressed by the compression algorithm specified in [\[RFC1951\]](https://go.microsoft.com/fwlink/?LinkId=90302). + +### Xnum + +**Xnum** is a 64-bit binary [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d) as specified in [\[IEEE754\]](https://go.microsoft.com/fwlink/?LinkId=89903). This value MUST NOT[\<191\>](#Appendix_A_191) be infinity, denormalized, not-a-number (NaN), nor negative zero. + +### XORObfuscation + +The **XORObfuscation** structure specifies the [**XOR obfuscation**](#gt_cbfd1a35-e8c9-4c5a-bc26-e618633d2f50). + +[TABLE] + +**key (2 bytes):** An unsigned integer that specifies the [**obfuscation key**](#gt_ae0e1916-4ac2-4c7e-9781-4fc8d8e63362). See [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083), 2.3.6.2 section, the first step of initializing XOR array where it describes the generation of 16-bit XorKey value. + +**verificationBytes (2 bytes):** An unsigned integer that specifies the password verification identifier. See [Password Verifier Algorithm](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4). + +### XTI + +The **XTI** structure specifies a [supporting link](#Section_cc5920ba01074d92bbdfc12ca986f31f) and scope information about that supporting link. + +[TABLE] + +**iSupBook (2 bytes):** An unsigned integer that specifies the zero-based index of a [SupBook](#supbook) record in the collection of SupBook records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). The referenced SupBook specifies the supporting link referenced by this structure. This value MUST be less than the number of SupBook records in this file. + +**itabFirst (2 bytes):** A signed integer that specifies the scope of the supporting link, and if a scope is specified, the first [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the scope of that supporting link. If the type of supporting link specified by the **cch** and **virtPath** fields of the SupBook record is same-sheet referencing, add-in referencing, DDE [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) referencing, or [**OLE**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) data source referencing, then no scope is specified and this value MUST be -2. Otherwise, this field MUST contain a value from the following table: + +[TABLE] + +**itabLast (2 bytes):** A signed integer that specifies the scope of the supporting link, and if a scope is specified, the last sheet in the scope of that supporting link. If the type of supporting link specified by the **cch** and **virtPath** fields of the SupBook record is same-sheet referencing, add-in referencing, [**DDE**](#gt_c24a2630-38ed-45a5-b15a-b29992007ccc) data source referencing, or OLE data source referencing, then no scope is specified and this value MUST be -2. Otherwise, this field MUST contain a value from the following table: + +[TABLE] + +## XCB Structures + +### CTBWRAPPER + +The **CTBWRAPPER** structure specifies a custom toolbar wrapper. This is the root record of the XCB binary stream where custom toolbars are stored. + +[TABLE] + +**ctbSet (14 bytes):** This is a structure of type [CTBS](#ctbs). + +**rCTB (variable):** Zero-based index array of [CTB](#ctb) structures. The number of elements in the array MUST be equal to **ctbSet.ctb**. + +### CTBS + +The **CTBS** record specifies the number of custom toolbars stored in the file and the number of available [**toolbar views**](#gt_c919b821-fb4f-4e0b-abd9-dc8b077f6e39). + +[TABLE] + +**bSignature (1 byte):** An unsigned integer that specifies the toolbar set signature number. MUST be 0x01. + +**bVersion (1 byte):** An unsigned integer that specifies the toolbar set version number. MUST be 0x01. + +**reserved1 (2 bytes):** MUST be zero and MUST be ignored. + +**reserved2 (2 bytes):** MUST be zero and MUST be ignored. + +**reserved3 (2 bytes):** MUST be zero and MUST be ignored. + +**ctb (2 bytes):** An unsigned integer that specifies the number of elements in the **rCTB** array of the [CTBWRAPPER](#ctbwrapper) structure that contains this structure. The value MUST be greater than 0x0000. + +**ctbViews (2 bytes):** An unsigned integer that specifies the number of available toolbar views. MUST be 0x0003. There are three view modes and therefore each toolbar has three available views. The view modes are shown in the following table: + +| View mode number | Meaning | +|:--:|----| +| 0 | [**Normal view**](#gt_b3c343ae-05ca-4b91-9cc1-383ee3563990) | +| 1 | [**Full screen view**](#gt_20327411-614f-448f-aa96-4c96726830eb) | +| 2 | [**Web-only view**](#gt_5016b55e-b39a-46e5-9701-472086ebed25)[\<193\>](#Appendix_A_193) | + +**ictbView (2 bytes):** An unsigned integer that specifies the view mode number that the application was in at the time the file was saved. MUST be equal to 0x0000 or 0x0001. + +### CTB + +The **CTB** record specifies a custom toolbar. + +[TABLE] + +**tb (variable):** Structure of type TB, as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.1.6, that contains toolbar information. + +**rVisualData (60 bytes):** A zero-based index array of TBVisualData structures, specified in \[MS-OSHARED\] section 2.3.1.9. The number of elements in this array MUST be equal to the value of the **ctbViews** field of the [CTBS](#ctbs) structure contained by the [CTBWRAPPER](#ctbwrapper) structure that contains this structure. The index of each structure in the array corresponds to a view mode number. Refer to the following table for the meaning of each TBVisualData, specified in \[MS-OSHARED\] section 2.3.1.9, structure according to its position in this array: + +| Index of structure in array | Meaning of TBVisualData, specified in \[MS-OSHARED\] section 2.3.1.9, structure | +|:--:|----| +| 0 | Contains the visual information for this toolbar to be used when the application is in [**Normal view**](#gt_b3c343ae-05ca-4b91-9cc1-383ee3563990). | +| 1 | Contains the visual information for this toolbar to be used when the application is in [**Full screen view**](#gt_20327411-614f-448f-aa96-4c96726830eb). | +| 2 | Contains the visual information for this toolbar to be used when the application is in [**Web-only view**](#gt_5016b55e-b39a-46e5-9701-472086ebed25). | + +**ectbid (4 bytes):** A signed integer that specifies the application’s specific custom toolbar identifier. Value MUST be 0x00000FFF. + +**rTBC (variable):** Number of elements in the array MUST be equal to **tb.cCL**. + +### TBC + +The **TBC** record specifies a [**toolbar control**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d). + +[TABLE] + +**tbch (variable):** Structure of type TBCHeader, as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.1.10, that specifies toolbar control header information. + +**tbcCmd (4 bytes):** Structure of type [TBCCmd](#tbccmd). This field MUST only exist when **tbch.tcid** is not equal to 0x0001, 0x06CC (1740), 0x03D8 (984), 0x03EC (1004), or 0x1051 (4177), and the value of **tbch.tct** equals one of the values in the following table: + +| Value of tbch.tct | Meaning | +|----|----| +| 0x01 | Button control | +| 0x02 | Edit control | +| 0x03 | Dropdown control | +| 0x04 | ComboBox control | +| 0x06 | [**SplitDropDown control**](#gt_809470f7-7486-4a44-a50d-2489b32389af) | +| 0x07 | [**OCXDropDown control**](#gt_e139011b-a966-4495-9264-d923ecdfeb66) | +| 0x08 | [**GraphicDropDown control**](#gt_007e8308-eee4-4435-a1f8-e2b27e58f1ac) | +| 0x0A | [**Popup control**](#gt_a259e677-3d9d-47e4-87ba-590fd09734c8) | +| 0x0C | [**ButtonPopup control**](#gt_d638405a-d78b-4c5f-aed2-8616d98d3519) | +| 0x0D | [**SplitButtonPopup control**](#gt_1c046ab6-2530-4a41-8d19-03f92914beaf) | +| 0x0E | [**SplitButtonMRUPopup control**](#gt_01b548cd-095a-4517-a468-1771a038c392) | +| 0x0F | Label control | +| 0x15 | [**Pane control**](#gt_0b77cb34-c2be-4fbe-8f82-df82f7b02b07) | + +**tbcd (variable):** Structure of type TBCData, as specified in \[MS-OSHARED\] section 2.3.1.13, that specifies toolbar control data. MUST exist if **tbch.tct** is not equal to 0x16. MUST NOT exist if **tbch.tct** equals 0x16. + +### TBCCmd + +The **TBCCmd** record specifies a command identifier for a [**toolbar control**](#gt_8077f5ab-e200-481c-9980-3ea64760ce9d). + +[TABLE] + +**cmdID (2 bytes):** A signed integer that specifies the command identifier for this toolbar control. Value MUST be in one of the tables specified in sections 2.3, 2.4, 2.5, 2.6, 2.7, and 2.8 of [\[MS-CTXLS\]](%5bMS-CTXLS%5d.pdf#Section_b461dcd9933e471081bcdc1c74801b6b). + +**A - fHideDrawing (1 bit):** A bit that specifies whether the toolbar control is visible if it is disabled. A value of 1 specifies that the toolbar control is not visible if it is disabled. MUST only be used if **cmdType** equals 0x10 or 0x14. MUST be 0 if **cmdType** is not equal to 0x10 and is not equal to 0x14. + +**B - reserved1 (1 bit):** MUST be zero and MUST be ignored. + +**cmdType (5 bits):** An unsigned integer that specifies the command type for this toolbar control. Value MUST be in the following table: + +| **Value** | **Meaning** | +|----|:---| +| 0x00 | Toolbar control uses a toolbar control grid command identifier. Value of **cmdType** MUST be one of the values listed in \[MS-CTXLS\] section 2.8. | +| 0x01 | Toolbar control uses a toolbar control command identifier. Value of **cmdType** MUST be one of the values listed in \[MS-CTXLS\] section 2.4. | +| 0x02 | Toolbar control uses a general command identifier. Value of **cmdType** MUST be one of the values listed in \[MS-CTXLS\] section 2.3. | +| 0x03 | Toolbar control uses a menu toolbar control command identifier. Value of **cmdType** MUST be one of the values listed in \[MS-CTXLS\] section 2.5. | +| 0x05 | Toolbar control uses a toolbar command identifier. Value of **cmdType** MUST be one of the values listed in \[MS-CTXLS\] section 2.7. The value of the **tbch.tct** field of the [TBC](#tbc) structure that contains this structure MUST be equal to one of the following values: 0x0A, 0x0C, 0x0D, or 0x0E. | +| 0x07 | Toolbar control uses a menu toolbar command identifier. Value of **cmdType** MUST be one of the values listed in \[MS-CTXLS\] section 2.6. The value of the **tbch.tct** field of the TBC structure that contains this structure MUST be equal to one of the following values: 0x0A, 0x0C, 0x0D, or 0x0E. | +| 0x08 | Toolbar control command is determined by using the value of the **tbch.tcid** field of the TBC structure that contains this structure. | +| 0x10 | Toolbar control uses an MSODGCID specifying a drawing command, as specified in [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872). | +| 0x14 | Toolbar control uses an MSODGCID specifying a drawing command, as specified in \[MS-ODRAW\]. | + +**C - reserved2 (1 bit):** MUST be zero and MUST be ignored. + +**reserved3 (8 bits):** MUST be zero and MUST be ignored. + +## Algorithms + +### Application Data For VtHyperlink + +The following algorithm specifies how hyperlink properties ([\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.3.3.1.18) that are associated with a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells or shapes in a document construct their **dwApp** structure [**member (1)**](#gt_5d78ca78-a9b1-4791-8126-bf9494304b11) value. + +1. If the hyperlink is associated with a shape [\[MS-ODRAW\]](%5bMS-ODRAW%5d.pdf#Section_8560795e77594745838ff7f2ef2f1872) section 2.3.2, the **dwApp** value MUST be 0xFFFFFFFF. + +2. Otherwise the hyperlink MUST be associated with a range of cells on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d), and the **dwApp** value is computed as follows: + +3. Set an unsigned 2-byte integer (wHLIndex) equal to the zero-based index of the [HLink](#hlink) structure or [HLinkTooltip](#hlinktooltip) structure in the sheet that the hyperlink is associated with. + +4. Set an unsigned 2-byte integer (wWSIndex) equal to the zero-based index of the sheet in the document on which this range of cells that the hyperlink is associated with is defined. + +5. The value of **dwApp** MUST be equal to the bitwise OR of wWSIndex shifted 16 bits to the high order and wHLIndex. + +> Example: dwApp = (wWSIndex \<\< 16) \| wHLIndex; + +# Structure Examples + +This section contains examples of some of the most commonly used data structures in MS-XLS files. The examples are meant to be a starting point for an implementer learning the file format. They are not meant to cover all records in the file format. + +The following conventions are followed for all of the examples, unless noted otherwise: + +- The order of the records, structures, and fields within the example match their corresponding order in the file format. + +- The examples begin with the first record relevant to the example and end with the last record relevant to the example. An example cannot be used as a complete and standalone MS-XLS file. + +- The examples are self-contained and contiguous; no records or structures are omitted in the middle of an example. + +- Undefined and ignored fields are not included in the field explanations. + +- Offsets for records and structures are omitted because these values can vary depending on how the files are created and what optional records applications choose to include in files. + +- In the structure diagrams for the examples, the types of arrays are meant for illustration only and can be disregarded. + +## Conditional Formatting + +This example shows conditional formatting applied to [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) A2 with a "between" condition to make the text red when the value is greater than or equal to 1.5, and less than or equal to 2.5. + +The first record in this example is a [CondFmt](#condfmt) record, which specifies beginning of a collection of [CF](#cf) records and defines the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells to which the conditional formatting rule applies. The CF record follows next in this example, defining that conditional formatting rule. + +![Conditional formatting in this example within a sheet](media/image83.bin "Conditional formatting in this example within a sheet") + +Figure 19: Conditional formatting in this example within a sheet + +### Conditional Formatting: CondFmt + +The first record in this example, [CondFmt](#condfmt), specifies beginning of a collection of [CF](#cf) records and defines the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) to which the conditional formatting rule applies. + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|-----------| +| 0016 | CondFmt **- CondFmt** | | +| 0002 | USHORT **- ccf** | 0x0001 | +| 1 bit | USHORT **- fToughRecalc** | 0x0 | +| 15 bits | USHORT **- nID** | 0x0000 | +| 0008 | [Ref8U](#ref8u) **- refBound** | | +| 0002 | [RwU](#rwu) **- rwFirst** | | +| 0002 | USHORT **- rw** | 0x0001 | +| 0002 | RwU **- rwLast** | | +| 0002 | USHORT **- rw** | 0x0001 | +| 0002 | [ColU](#colu) **- colFirst** | | +| 0002 | USHORT **- col** | 0x0000 | +| 0002 | ColU **- colLast** | | +| 0002 | USHORT **- col** | 0x0000 | +| 000A | [SqRefU](#sqrefu) **- sqref** | | +| 0002 | USHORT **- cref** | 0x0001 | +| 0008 | RgRef8U **- rgrefs** | | +| 0008 | Ref8U **- ref\[0\]** | | +| 0002 | RwU **- rwFirst** | | +| 0002 | USHORT **- rw** | 0x0001 | +| 0002 | RwU **- rwLast** | | +| 0002 | USHORT **- rw** | 0x0001 | +| 0002 | ColU **- colFirst** | | +| 0002 | USHORT **- col** | 0x0000 | +| 0002 | ColU **- colLast** | | +| 0002 | USHORT **- col** | 0x0000 | + +Figure 20: Structure of CondFmt + +**ccf:** 0x0001 specifies that there is one CF record in the collection that follows this record. + +**fToughRecalc:** 0x0 specifies that the appearance of the cell does not require significant processing. + +**nID:** 0x0000 specifies the identifier for this record. + +**refBound:** A Ref8U structure specifies the bounds of the set of cells to which the rules are applied. + +**refBound.rwFirst:** An RwU structure that specifies the index of the first row in the range. + +**refBound.rwFirst.rw:** 0x0001 specifies that the range starts in row two of the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +**refBound.rwLast:** A RwU structure that specifies index of the last row in the range. + +**refBound.rwLast.rw:** 0x0001 specifies that the range ends in row two of the worksheet. + +**refBound.colFirst:** A ColU structure that specifies the index of the first column in the range. + +**refBound.colFirst.col:** 0x0000 specifies that the range starts in column A of the worksheet. + +**refBound.colLast:** A ColU structure that specifies the index of the last column in the range. + +**refBound.colLast.col:** 0x0000 specifies that the range ends in column A of the worksheet. + +**sqref:** An SqRefU structure that specifies the cells to which the conditional formatting rules apply. + +**sqref.cref:** 0x0001 specifies that there is one Ref8U structure in **rgrefs**. + +**sqref.rgrefs.ref\[0\]:** This is the first Ref8U structure that specifies the range of cells on the sheet where the [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rules apply. + +**sqref.rgrefs.ref\[0\].rwFirst.rw:** 0x0001 specifies the range starts in row two of the worksheet. + +**sqref.rgrefs.ref\[0\].rwLast.rw:** 0x0001 specifies the range ends in row two of the worksheet. + +**sqref.rgrefs.ref\[0\].colFirst.col:** 0x0000 specifies the range starts in column A of the worksheet. + +**sqref.rgrefs.ref\[0\].colLast.col:** 0x0000 specifies the range ends in column A of the worksheet. + +### Conditional Formatting: CF + +The next record in this example, [CF](#cf), specifies a conditional formatting rule. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0094 | CF **- Cf** | | +| 0001 | BYTE **- ct** | 0x01 | +| 0001 | BYTE **- cp** | 0x01 | +| 0002 | USHORT **- cce1** | 0x0009 | +| 0002 | USHORT **- cce2** | 0x0009 | +| 007C | [DXFN](#dxfn) **- rgbdxf** | | +| 1 bit | DWORD **- alchNinch** | 0x1 | +| 1 bit | DWORD **- alcvNinch** | 0x1 | +| 1 bit | DWORD **- wrapNinch** | 0x1 | +| 1 bit | DWORD **- trotNinch** | 0x1 | +| 1 bit | DWORD **- kintoNinch** | 0x1 | +| 1 bit | DWORD **- cIndentNinch** | 0x1 | +| 1 bit | DWORD **- fShrinkNinch** | 0x1 | +| 1 bit | DWORD **- fMergeCellNinch** | 0x1 | +| 1 bit | DWORD **- lockedNinch** | 0x1 | +| 1 bit | DWORD **- hiddenNinch** | 0x1 | +| 1 bit | DWORD **- glLeftNinch** | 0x1 | +| 1 bit | DWORD **- glRightNinch** | 0x1 | +| 1 bit | DWORD **- glTopNinch** | 0x1 | +| 1 bit | DWORD **- glBottomNinch** | 0x1 | +| 1 bit | DWORD **- glDiagDownNinch** | 0x1 | +| 1 bit | DWORD **- glDiagUpNinch** | 0x1 | +| 1 bit | DWORD **- flsNinch** | 0x1 | +| 1 bit | DWORD **- icvFNinch** | 0x1 | +| 1 bit | DWORD **- icvBNinch** | 0x1 | +| 1 bit | DWORD **- ifmtNinch** | 0x1 | +| 1 bit | DWORD **- fIfntNinch** | 0x1 | +| 1 bit | DWORD **- unused1** | 0x1 | +| 3 bits | DWORD **- reserved1** | 0x0 | +| 1 bit | DWORD **- ibitAtrNum** | 0x0 | +| 1 bit | DWORD **- ibitAtrFnt** | 0x1 | +| 1 bit | DWORD **- ibitAtrAlc** | 0x0 | +| 1 bit | DWORD **- ibitAtrBdr** | 0x0 | +| 1 bit | DWORD **- ibitAtrPat** | 0x0 | +| 1 bit | DWORD **- ibitAtrProt** | 0x0 | +| 1 bit | DWORD **- iReadingOrderNinch** | 0x0 | +| 1 bit | WORD **- fIfmtUser** | 0x0 | +| 1 bit | WORD **- unused2** | 0x1 | +| 1 bit | WORD **- fNewBorder** | 0x0 | +| 12 bits | WORD **- reserved2** | 0x000 | +| 1 bit | WORD **- fZeroInited** | 0x0 | +| 0076 | [DXFFntD](#dxffntd) **- dxffntd** | | +| 0001 | BYTE **- cchFont** | 0x00 | +| 003F | unused **- unused** | 0x000100010000000000E03F000000000000E03F0100630075006D0065006E007400200057007200690074006500720000000000000001040006DC00580303FF | +| 0010 | [Stxp](#stxp) **- stxp** | | +| 0004 | LONG **- twpHeight** | 0xFFFFFFFF | +| 0004 | [Ts](#ts) **- ts** | | +| 1 bit | DWORD **- unused1** | 0x0 | +| 1 bit | DWORD **- ftsItalic** | 0x0 | +| 5 bits | DWORD **- unused2** | 0x00 | +| 1 bit | DWORD **- ftsStrikeout** | 0x0 | +| 24 bits | DWORD **- unused3** | 0x000000 | +| 0002 | SHORT **- bls** | 0x0000 | +| 0002 | SHORT **- sss** | 0x0000 | +| 0001 | BYTE **- uls** | 0x00 | +| 0001 | BYTE **- bFamily** | 0x00 | +| 0001 | BYTE **- bCharSet** | 0x00 | +| 0001 | BYTE **- unused** | 0x00 | +| 0004 | LONG **- icvFore** | 0x0000000A | +| 0004 | LONG **- reserved** | 0x00000000 | +| 0004 | Ts **- tsNinch** | | +| 1 bit | DWORD **- unused1** | 0x0 | +| 1 bit | DWORD **- ftsItalic** | 0x1 | +| 5 bits | DWORD **- unused2** | 0x06 | +| 1 bit | DWORD **- ftsStrikeout** | 0x1 | +| 24 bits | DWORD **- unused3** | 0x000000 | +| 0004 | DWORD **- fSssNinch** | 0x00000001 | +| 0004 | DWORD **- fUlsNinch** | 0x00000001 | +| 0004 | DWORD **- fBlsNinch** | 0x00000001 | +| 0004 | DWORD **- unused2** | 0x00000001 | +| 0004 | LONG **- ich** | 0x00000000 | +| 0004 | LONG **- cch** | 0x7FFFFFFF | +| 0002 | [FontIndex](#fontindex) **- iFnt** | | +| 0002 | USHORT **- ifnt** | 0x0001 | +| 0009 | [CFParsedFormulaNoCCE](#cfparsedformulanocce) **- rgce1** | | +| 0009 | [Rgce](#rgce) **- rgce** | | +| 0009 | Ptg **- Ptg\[0\]** | | +| 0009 | [PtgNum](#ptgnum) **- PtgNum** | | +| 7 bits | BYTE **- ptg** | 0x1F | +| 1 bit | BYTE **- reserved0** | 0x0 | +| 0008 | Double **- value** | 0x3FF8000000000000 | +| 0009 | CFParsedFormulaNoCCE **- rgce2** | | +| 0009 | Rgce **- rgce** | | +| 0009 | Ptg **- Ptg\[0\]** | | +| 0009 | PtgNum **- PtgNum** | | +| 7 bits | BYTE **- ptg** | 0x1F | +| 1 bit | BYTE **- reserved0** | 0x0 | +| 0008 | Double **- value** | 0x4004000000000000 | + +Figure 21: Structure of Cf + +**ct:** 0x01 specifies that the [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule requires two inputs. The inputs, **rgce1** and **rgce2**, are evaluated with the comparison function specified in the **cp** field. If the result of the evaluation is TRUE, the conditional formatting rule is applied. + +**cp:** 0x01 specifies that the comparison function evaluates to TRUE if the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) value is greater than or equal to the value of the **rgce1** field and less than or equal to the value of the **rgce2** field. + +**cce1:** 0x0009 specifies that the size of the **rgce1** field is 9 bytes. + +**cce2:** 0x0009 specifies that the size of the **rgce2** field is 9 bytes. + +**rgbdxf:** A DXFN structure that specifies the formatting that is applied if the defined condition evaluates to TRUE. + +**rgbdxf.alchNinch:** 0x1 specifies that **rgbdxf.dxfalc.alc** is ignored. + +**rgbdxf.alcvNinch:** 0x1 specifies that **rgbdxf.dxfalc.alcv** is ignored. + +**rgbdxf.wrapNinch:** 0x1 specifies that **rgbdxf.dxfalc.fWrap** is ignored. + +**rgbdxf.trotNinch:** 0x1 specifies that **rgbdxf.dxfalc.trot** is ignored. + +**rgbdxf.kintoNinch:** 0x1 specifies that **rgbdxf.dxfalc.fJustLast** is ignored. + +**rgbdxf.cIndentNinch:** 0x1 specifies that **rgbdxf.dxfalc.cIndent** and **rgbdxf.dxfalc.iIndent** are ignored. + +**rgbdxf.fShrinkNinch:** 0x1 specifies that **rgbdxf.dxfalc.fShrinkToFit** is ignored. + +**rgbdxf.fMergeCellNinch:** 0x1 specifies that **rgbdxf.dxfalc.fMergeCell** is ignored. + +**rgbdxf.lockedNinch:** 0x1 specifies that **rgbdxf.dxfprot.fLocked** is ignored. + +**rgbdxf.hiddenNinch:** 0x1 specifies that **rgbdxf.dxfprot.fHidden** is ignored. + +**rgbdxf.glLeftNinch:** 0x1 specifies that **rgbdxf.dxfbdr.dgLeft** and **rgbdxf.dxfbdr.icvLeft** are ignored. + +**rgbdxf.glRightNinch:** 0x1 specifies that **rgbdxf.dxfbdr.dgRight** and **rgbdxf.dxfbdr.icvRight** are ignored. + +**rgbdxf.glTopNinch:** 0x1 specifies that the properties for the top [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c) of the cell can be updated and that **rgbdxf.dxfbdr.dgTop** and **rgbdxf.dxfbdr.icvTop** are ignored. + +**rgbdxf.glBottomNinch:** 0x1 specifies that **rgbdxf.dxfbdr.dgBottom** and **rgbdxf.dxfbdr.icvBottom** are ignored. + +**rgbdxf.glDiagDownNinch:** 0x1 specifies that **rgbdxf.dxfbdr.bitDiagDown** is ignored. + +**rgbdxf.glDiagUpNinch:** 0x1 specifies that **rgbdxf.dxfbdr.bitDiagUp** is ignored. Because **rgbdxf.glDiagDownNinch** is also set to 0x1, **rgbdxf.dxfbdr.dgDiag** and **rgbdxf.dxfbdr.icvDiag** are ignored. + +**rgbdxf.flsNinch:** 0x1 specifies that **rgbdxf.dxfpat.fls** is ignored. + +**rgbdxf.icvFNinch:** 0x1 specifies that **rgbdxf.dxfpat.icvForeground** is ignored. + +**rgbdxf.icvBNinch:** 0x1 specifies that **rgbdxf.dxfpat.icvBackground** is ignored. + +**rgbdxf.ifmtNinch:** 0x1 specifies that **rgbdxf.dxfnum.ifmt** is ignored. + +**rgbdxf.fIfntNinch:** 0x1 specifies that **rgbdxf.dxffntd.ifnt** is ignored. + +**rgbdxf.ibitAtrNum:** 0x0 specifies that the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) is not part of this structure. + +**rgbdxf.ibitAtrFnt:** 0x1 specifies that [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) information is a part of this structure. + +**rgbdxf.ibitAtrAlc:** 0x0 specifies that alignment information is not a part of this structure. + +**rgbdxf.ibitAtrBdr:** 0x0 specifies that [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad) information is not a part of this structure. + +**rgbdxf.ibitAtrPat:** 0x0 specifies that pattern information is not a part of this structure. + +**rgbdxf.ibitAtrProt:** 0x0 specifies that rotation information is not a part of this structure. + +**rgbdxf.iReadingOrderNinch:** 0x1 specifies that **rgbdxf.dxfalc.iReadingOrder** is ignored. + +**rgbdxf.fIfmtUser:** 0x0 specifies that the number format is not a user-defined [**format string**](#gt_07085e26-506a-4b35-81ad-972464e277ff). + +**rgbdxf.fNewBorder:** 0x0 specifies that the border formats apply to all cells in the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +**rgbdxf.fZeroInited:** 0x0 specifies that **rgbdxf.dxfalc.iReadingOrder** is undefined and not taken into account. + +**rgbdxf.dxffntd:** A DXFFntD structure that specifies the font information used for formatting. + +**rgbdxf.dxffntd.cchFont:** 0x00 specifies the number of characters in the font name string. + +**rgbdxf.dxffntd.stxp:** This specifies the formatting attributes of the font. + +**rgbdxf.dxffntd.stxp.twpHeight:** 0xFFFFFFFF specifies that this value is ignored. + +**rgbdxf.dxffntd.stxp.ts:** A Ts structure that specifies additional formatting attributes. + +**rgbdxf.dxffntd.stxp.ts.ftsItalic:** 0x1 is ignored because **rgbdxf.dxffntd.tsNinch.ftsItalic** is 0x1. + +**rgbdxf.dxffntd.stxp.ts.ftsStrikeout:** 0x0 is ignored because **rgbdxf.dxffntd.tsNinch.ftsStrikeout** is 0x1. + +**rgbdxf.dxffntd.stxp.bls:** 0x0000 specifies that the font is normal weight. + +**rgbdxf.dxffntd.stxp.sss:** 0x0000 specifies that the font is normal script. + +**rgbdxf.dxffntd.stxp.uls:** 0x00 specifies that the font is not underlined. + +**rgbdxf.dxffntd.stxp.bFamily:** 0x00 specifies the [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2). + +**rgbdxf.dxffntd.stxp.bCharSet:** 0x00 specifies the font [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204). + +**rgbdxf.dxffntd.icvFore:** 0x0000000A specifies that the font color is red. + +**rgbdxf.dxffntd.tsNinch:** A Ts structure that specifies how the value of **rgbdxf.dxffntd.stxp.ts** is interpreted. + +**rgbdxf.dxffntd.tsNinch.ftsItalic:** 0x1 specifies that the value of **rgbdxf.dxffntd.stxp.ts.ftsItalic** is ignored. + +**rgbdxf.dxffntd.tsNinch.ftsStrikeout:** 0x1 specifies that the value of **rgbdxf.dxffntd.stxp.ts. ftsStrikeout** is ignored. + +**rgbdxf.dxffntd.fSssNinch:** 0x00000001 specifies that **rgbdxf.dxffntd.stxp.sss** is ignored. + +**rgbdxf.dxffntd.fUlsNinch:** 0x00000001 specifies that **rgbdxf.dxffntd.stxp.uls** is ignored. + +**rgbdxf.dxffntd.fBlsNinch:** 0x00000001 specifies that **rgbdxf.dxffntd.stxp.bls** is ignored. + +**rgbdxf.dxffntd.ich:** 0x00000000 specifies that the font formatting is applied starting from the first character. + +**rgbdxf.dxffntd.cch:** 0x7FFFFFFF specifies that the font formatting applies to 2147483647 characters. + +**rgbdxf.dxffntd.iFnt:** 0x0001 is ignored because **rgbdxf.fIfntNinch** is 0x1. + +**rgce1:** A CFParsedFormulaNoCCE structure that specifies the first operand of the comparison. + +**rgce1.rgce:** An Rgce that specifies an array of [Ptgs](#ptg). + +**rgce1.rgce.Ptg\[0\]:** A Ptg that specifies a formula element. + +**rgce1.rgce.Ptg\[0\].PtgNum.ptg:** 0x1F specifies that this Ptg is a floating point value. + +**rgce1.rgce.Ptg\[0\].PtgNum.value:** 0x3FF8000000000000 specifies a numeric value of 1.5. + +**rgce2:** A CFParsedFormulaNoCCE structure that specifies the second operand of the comparison. + +**rgce2.rgce:** A Rgce structure that specifies an array of Ptgs. + +**rgce2.rgce.Ptg\[0\]:** A Ptg that specifies a formula element. + +**rgce2.rgce.Ptg\[0\].PtgNum.ptg:** 0x1F specifies that this Ptg is a floating point value. + +**rgce2.rgce.Ptg\[0\].PtgNum.value:** 0x4004000000000000 specifies a numeric value of 2.5. + +## Defined Name + +This example shows a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe)-level [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933), *MyName*, that points to the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) E4 on the second [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). A defined name is specified by a [Lbl](#lbl) record, which is a part of the [Globals Substream](#globals-substream) (not included in this example for brevity). This example includes the [ExternSheet](#externsheet) record referenced by the Lbl record, and the [SupBook](#supbook) record referenced by the ExternSheet record. + +![Defined name in this example within a sheet](media/image84.bin "Defined name in this example within a sheet") + +Figure 22: Defined name in this example within a sheet + +### Defined Name: Lbl + +The first record in this example, [Lbl](#lbl), stores the [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001C | Lbl **- Lbl** | | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fFunc** | 0x0 | +| 1 bit | USHORT **- fOB** | 0x0 | +| 1 bit | USHORT **- fProc** | 0x0 | +| 1 bit | USHORT **- fCalcExp** | 0x0 | +| 1 bit | USHORT **- fBuiltin** | 0x0 | +| 6 bits | USHORT **- fGrp** | 0x00 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fPublished** | 0x0 | +| 1 bit | USHORT **- fWorkbookParam** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0001 | BYTE **- chKey** | 0x00 | +| 0001 | BYTE **- cch** | 0x06 | +| 0002 | SHORT **- cce** | 0x0007 | +| 0002 | SHORT **- reserved3** | 0x0000 | +| 0002 | USHORT **- itab** | 0x0000 | +| 0001 | BYTE **- reserved4** | 0x00 | +| 0001 | BYTE **- reserved5** | 0x00 | +| 0001 | BYTE **- reserved6** | 0x00 | +| 0001 | BYTE **- reserved7** | 0x00 | +| 0007 | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- Name** | MyName | +| 0007 | [NameParsedFormula](#nameparsedformula) **- rgce** | | +| 0007 | [Ptg](#ptg) **- Ptg\[0\]** | | +| 0007 | [PtgRef3d](#ptgref3d) **- PtgRef3d** | | +| 5 bits | BYTE **- ptg** | 0x1A | +| 2 bits | [PtgDataType](#ptgdatatype) **- type** | 0x1 | +| 1 bit | BYTE **- reserved** | 0x0 | +| 0002 | USHORT **- ixti** | 0x0000 | +| 0004 | [RgceLoc](#rgceloc) **- loc** | | +| 0002 | [RwU](#rwu) **- row** | | +| 0002 | USHORT **- rw** | 0x0003 | +| 0002 | [ColRelU](#colrelu) **- column** | | +| 0002 | USHORT **- col** | 0x0004 | + +Figure 23: Structure of Lbl + +**fHidden:** 0x0 specifies that the defined name is visible in the list of defined names. + +**fFunc:** 0x0 specifies that the defined name does not represent an [**XLM**](#gt_11e8ff9f-bce2-4d8b-9ba2-11ac468f7c7b). + +**fOB:** 0x0 specifies that the defined name does not represent a [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) [**macro**](#gt_cd2933d3-08d1-4931-bd5c-7ae0a668fe7c). + +**fProc:** 0x0 specifies that the defined name does not represent a macro. + +**fCalcExp:** 0x0 specifies that the defined name does not represent a function that could return an array. + +**fBuiltin:** 0x0 specifies that the defined name does not represent a [**built-in name**](#gt_d40a51df-e96f-45ec-885d-6f936d172b39). + +**fGrp:** 0x00 specifies the [**function category**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) for the defined name is "All". + +**fPublished:** 0x0 specifies that this defined name is not [**published**](#gt_8ffc383a-d4f1-4515-a8b5-874d84ab2d2b). + +**fWorkbookParam:** 0x0 specifies that this defined name is not a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) parameter. + +**chKey:** 0x00 specifies there is no shortcut key for the macro represented by the defined name. + +**cch:** 0x06 specifies that there are six characters in the **Name** field. + +**cce:** 0x0007 specifies that the length of the **rgce** field is 7 bytes. + +**itab:** 0x0000 specifies that the defined name is not local to a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**Name:** *MyName* specifies the name of the defined name. + +**rgce:** A NameParsedFormula that specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that represents the defined name. + +**rgce.Ptg\[0\].PtgRef3d.ptg:** 0x1A specifies that this Ptg is of type PtgRef3d. + +**rgce.Ptg\[0\].PtgRef3d.type:** 0x1 specifies that this Ptg is a reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +**rgce.Ptg\[0\].PtgRef3d.ixti:** 0x0000 specifies that this range refers to the sheet specified by the first [XTI](#xti) element in the [ExternSheet](#externsheet) record. + +**rgce.Ptg\[0\].PtgRef3d.loc.row.rw:** 0x0003 specifies that the referenced [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) is in row four of the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +**rgce.Ptg\[0\].PtgRef3d.loc.column.col:** 0x0004 specifies that the referenced cell is in column E of the worksheet. + +### Defined Name: ExternSheet + +The next record in this example is an [ExternSheet](#externsheet) record. This record defines the set of [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that are referenced by this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). It is included in this example because the **ixti** field in the [Lbl](#lbl) record points to the [XTI](#xti) structure within this record. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------|-----------| +| 0008 | ExternSheet **- ExternSheet** | | +| 0002 | USHORT **- cXTI** | 0x0001 | +| 0006 | RgXTI **- rgXTI** | | +| 0006 | XTI **- xti\[0\]** | | +| 0002 | USHORT **- iSupBook** | 0x0000 | +| 0002 | SHORT **- itabFirst** | 0x0001 | +| 0002 | SHORT **- itabLast** | 0x0001 | + +Figure 24: Structure of ExternSheet + +**cXTI:** 0x0001 specifies that there is one XTI record in the **rgXTI** array. + +**rgXTI.xti\[0\].iSupBook:** 0x0000 specifies the reference to the first [SupBook](#supbook) record in the [global substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +**rgXTI.xti\[0\].itabFirst:** 0x0001 specifies that the first sheet referenced by the [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) is the second sheet in the workbook (Sheet2). The related [BoundSheet8](#boundsheet8) record is omitted for brevity. + +**rgXTI.xti\[0\].itabLast:** 0x0001 specifies that the last sheet referenced by the defined name is the second sheet in the workbook (Sheet2). + +### Defined Name: SupBook + +The next record in this example, [SupBook](#supbook), stores information about a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) that is referenced by this workbook. + +| **Size** | **Structure** | **Value** | +|----------|-----------------------|-----------| +| 0004 | SupBook **- SupBook** | | +| 0002 | USHORT **- ctab** | 0x0003 | +| 0002 | USHORT **- cch** | 0x0401 | + +Figure 25: Structure of SupBook + +**ctab:** 0x0003 specifies that there are three [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the referenced workbook. + +**cch:** 0x0401 specifies that this record defines a self-referencing [supporting link](#Section_cc5920ba01074d92bbdfc12ca986f31f). + +## Table + +This example shows the records that make up a [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). The following figure shows a possible implementation of the table discussed in this example: + +![Table in this example within a sheet](media/image85.bin "Table in this example within a sheet") + +Figure 26: Table in this example within a sheet + +### Table: Feathdr11 + +The first record in this example is a [FeatHdr11](#feathdr11) record that appears in the [worksheet substream](#Section_f41c06f2905749a18c3fa4a4d211fc56) (the worksheet substream is not included in this example for brevity). This record stores common information about all the tables on this [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001D | FeatHdr11 **- Feathdr11** | | +| 000C | [FrtHeader](#frtheader) **- frt** | | +| 0002 | USHORT **- rt** | 0x0871 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0008 | RESERVED **- reserved** | 0x0000000000000000 | +| 0002 | [SharedFeatureType](#sharedfeaturetype) **- isf** | 0x0005 | +| 0001 | BYTE **- reserved1** | 0x01 | +| 0004 | DWORD **- reserved2** | 0xFFFFFFFF | +| 0004 | DWORD **- reserved3** | 0xFFFFFFFF | +| 0004 | DWORD **- idListNext** | 0x00000002 | +| 0002 | USHORT **- reserved4** | 0x0000 | + +Figure 27: Structure of Feathdr11 + +**frt:** This structure specifies a future version record type FrtHeader. + +**frt.rt:** 0x0871 specifies that this record belongs to a record of type FeatHdr11. + +**frt.grbitFrt:** Stores attributes for this record. + +**frt.grbitFrt.fFrtRef:** 0x0000 specifies that this record does not specify a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +**frt.grbitFrt.fFrtAlert:** 0x0000 specifies not to alert the user of possible problems when saving the file as an earlier version of the file format. + +**isf:** 0x0005 specifies type Table. + +**idListNext:** 0x00000002 specifies the next identifier to try when assigning a unique identifier to a new [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +### Table: Feature11 + +The next record in this example, [Feature11](#feature11), specifies information about this [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) on this [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0116 | Feature11 **- Feature11** | | +| 000C | [FrtRefHeaderU](#frtrefheaderu) **- frtRefHeaderU** | | +| 0002 | USHORT **- rt** | 0x0872 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x1 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0008 | [Ref8U](#ref8u) **- ref8** | | +| 0002 | [RwU](#rwu) **- rwFirst** | | +| 0002 | USHORT **- rw** | 0x0003 | +| 0002 | RwU **- rwLast** | | +| 0002 | USHORT **- rw** | 0x0006 | +| 0002 | [ColU](#colu) **- colFirst** | | +| 0002 | USHORT **- col** | 0x0002 | +| 0002 | ColU **- colLast** | | +| 0002 | USHORT **- col** | 0x0004 | +| 0002 | USHORT **- isf** | 0x0005 | +| 0001 | BYTE **- reserved1** | 0x00 | +| 0004 | DWORD **- reserved2** | 0x00000000 | +| 0002 | USHORT **- cref2** | 0x0001 | +| 0004 | DWORD **- cbFeatData** | 0x00000000 | +| 0002 | USHORT **- reserved3** | 0x0000 | +| 0008 | REFS2 **- refs2** | | +| 0008 | Ref8U **- ref\[0\]** | | +| 0002 | RwU **- rwFirst** | | +| 0002 | USHORT **- rw** | 0x0003 | +| 0002 | RwU **- rwLast** | | +| 0002 | USHORT **- rw** | 0x0006 | +| 0002 | ColU **- colFirst** | | +| 0002 | USHORT **- col** | 0x0002 | +| 0002 | ColU **- colLast** | | +| 0002 | USHORT **- col** | 0x0004 | +| 00F3 | FeatUnion5 **- rgbFeat** | | +| 00F3 | [TableFeatureType](#tablefeaturetype) **- TableFeature** | | +| 0004 | [SourceType](#sourcetype) **- lt** | 0x00000000 | +| 0004 | DWORD **- idList** | 0x00000001 | +| 0004 | DWORD **- crwHeader** | 0x00000001 | +| 0004 | DWORD **- crwTotals** | 0x00000000 | +| 0004 | DWORD **- idFieldNext** | 0x00000004 | +| 0004 | ULONG **- cbFSData** | 0x00000040 | +| 0002 | USHORT **- rupBuild** | 0x0000 | +| 0002 | USHORT **- unused1** | 0x0000 | +| 1 bit | DWORD **- unused2** | 0x0 | +| 1 bit | DWORD **- fAutoFilter** | 0x1 | +| 1 bit | DWORD **- fPersistAutoFilter** | 0x1 | +| 1 bit | DWORD **- fShowInsertRow** | 0x0 | +| 1 bit | DWORD **- fInsertRowInsCells** | 0x0 | +| 1 bit | DWORD **- fLoadPldwIdDeleted** | 0x0 | +| 1 bit | DWORD **- fShownTotalRow** | 0x0 | +| 1 bit | DWORD **- reserved1** | 0x0 | +| 1 bit | DWORD **- fNeedsCommit** | 0x0 | +| 1 bit | DWORD **- fSingleCell** | 0x0 | +| 1 bit | DWORD **- reserved2** | 0x0 | +| 1 bit | DWORD **- fApplyAutoFilter** | 0x1 | +| 1 bit | DWORD **- fForceInsertToBeVis** | 0x0 | +| 1 bit | DWORD **- fCompressedXml** | 0x0 | +| 1 bit | DWORD **- fLoadCSPName** | 0x0 | +| 1 bit | DWORD **- fLoadPldwIdChanged** | 0x0 | +| 4 bits | DWORD **- verXL** | 0xB | +| 1 bit | DWORD **- fLoadEntryId** | 0x1 | +| 1 bit | DWORD **- fLoadPllstclInvalid** | 0x0 | +| 1 bit | DWORD **- fGoodRupBld** | 0x0 | +| 1 bit | DWORD **- unused3** | 0x0 | +| 1 bit | DWORD **- fPublished** | 0x0 | +| 7 bits | DWORD **- unused2** | 0x00 | +| 0004 | ULONG **- lPosStmCache** | 0x00000000 | +| 0004 | ULONG **- cbStmCache** | 0x00000000 | +| 0004 | ULONG **- cchStmCache** | 0x00000000 | +| 0004 | [LEMMode](#lemmode) **- lem** | 0x00000000 | +| 0010 | rgb **- rgbHashParam** | 0x00000000000000000000000000000000 | +| 0008 | [XLUnicodeString](#xlunicodestring) **- rgbName** | List1 | +| 0002 | USHORT **- cFieldData** | 0x0003 | +| 0004 | XLUnicodeString **- entryId** | 1 | +| 00A5 | Feat11FieldDataArray **- fieldData** | | +| 0035 | [Feat11FieldDataItem](#feat11fielddataitem) **- Feat11FieldDataItem\[0\]** | | +| 0004 | DWORD **- idField** | 0x00000001 | +| 0004 | DWORD **- lfdt** | 0x00000000 | +| 0004 | DWORD **- lfxidt** | 0x00000000 | +| 0004 | DWORD **- ilta** | 0x00000000 | +| 0004 | DWORD **- cbFmtAgg** | 0x00000000 | +| 0004 | DWORD **- istnAgg** | 0xFFFFFFFF | +| 1 bit | DWORD **- fAutoFilter** | 0x1 | +| 1 bit | DWORD **- fAutoFilterHidden** | 0x0 | +| 1 bit | DWORD **- fLoadXmapi** | 0x0 | +| 1 bit | DWORD **- fLoadFmla** | 0x0 | +| 2 bits | DWORD **- unused1** | 0x0 | +| 1 bit | DWORD **- reserved2** | 0x0 | +| 1 bit | DWORD **- fLoadTotalFmla** | 0x0 | +| 1 bit | DWORD **- fLoadTotalArray** | 0x0 | +| 1 bit | DWORD **- fSaveStyleName** | 0x0 | +| 1 bit | DWORD **- fLoadTotalStr** | 0x0 | +| 1 bit | DWORD **- fAutoCreateCalcCol** | 0x0 | +| 20 bits | DWORD **- unused2** | 0x00000 | +| 0004 | DWORD **- cbFmtInsertRow** | 0x00000000 | +| 0004 | DWORD **- istnInsertRow** | 0xFFFFFFFF | +| 0004 | XLUnicodeString **- strFieldName** | 1 | +| 0007 | XLUnicodeString **- strCaption** | Item | +| 0006 | [Feat11FdaAutoFilter](#feat11fdaautofilter) **- AutoFilter** | | +| 0004 | DWORD **- cbAutoFilter** | 0x00000000 | +| 0002 | USHORT **- unused** | 0x0001 | +| 0036 | Feat11FieldDataItem **- Feat11FieldDataItem\[1\]** | | +| 0004 | DWORD **- idField** | 0x00000002 | +| 0004 | DWORD **- lfdt** | 0x00000000 | +| 0004 | DWORD **- lfxidt** | 0x00000000 | +| 0004 | DWORD **- ilta** | 0x00000000 | +| 0004 | DWORD **- cbFmtAgg** | 0x00000000 | +| 0004 | DWORD **- istnAgg** | 0xFFFFFFFF | +| 1 bit | DWORD **- fAutoFilter** | 0x1 | +| 1 bit | DWORD **- fAutoFilterHidden** | 0x0 | +| 1 bit | DWORD **- fLoadXmapi** | 0x0 | +| 1 bit | DWORD **- fLoadFmla** | 0x0 | +| 2 bits | DWORD **- unused1** | 0x0 | +| 1 bit | DWORD **- fLoadCalcColArray** | 0x0 | +| 1 bit | DWORD **- fLoadTotalFmla** | 0x0 | +| 1 bit | DWORD **- fLoadTotalArray** | 0x0 | +| 1 bit | DWORD **- fSaveStyleName** | 0x0 | +| 1 bit | DWORD **- fLoadTotalStr** | 0x0 | +| 1 bit | DWORD **- fAutoCreateCalcCol** | 0x0 | +| 20 bits | DWORD **- unused2** | 0x00000 | +| 0004 | DWORD **- cbFmtInsertRow** | 0x00000000 | +| 0004 | DWORD **- istnInsertRow** | 0xFFFFFFFF | +| 0004 | XLUnicodeString **- strFieldName** | 2 | +| 0008 | XLUnicodeString **- strCaption** | Price | +| 0006 | Feat11FdaAutoFilter **- AutoFilter** | | +| 0004 | DWORD **- cbAutoFilter** | 0x00000000 | +| 0002 | USHORT **- unused** | 0x0002 | +| 003A | Feat11FieldDataItem **- Feat11FieldDataItem\[2\]** | | +| 0004 | DWORD **- idField** | 0x00000003 | +| 0004 | DWORD **- lfdt** | 0x00000000 | +| 0004 | DWORD **- lfxidt** | 0x00000000 | +| 0004 | DWORD **- ilta** | 0x00000000 | +| 0004 | DWORD **- cbFmtAgg** | 0x00000000 | +| 0004 | DWORD **- istnAgg** | 0xFFFFFFFF | +| 1 bit | DWORD **- fAutoFilter** | 0x1 | +| 1 bit | DWORD **- fAutoFilterHidden** | 0x0 | +| 1 bit | DWORD **- fLoadXmapi** | 0x0 | +| 1 bit | DWORD **- fLoadFmla** | 0x0 | +| 2 bits | DWORD **- unused1** | 0x0 | +| 1 bit | DWORD **- fLoadCalcColArray** | 0x0 | +| 1 bit | DWORD **- fLoadTotalFmla** | 0x0 | +| 1 bit | DWORD **- fLoadTotalArray** | 0x0 | +| 1 bit | DWORD **- fSaveStyleName** | 0x0 | +| 1 bit | DWORD **- fLoadTotalStr** | 0x0 | +| 1 bit | DWORD **- fAutoCreateCalcCol** | 0x0 | +| 20 bits | DWORD **- unused2** | 0x00000 | +| 0004 | DWORD **- cbFmtInsertRow** | 0x00000000 | +| 0004 | DWORD **- istnInsertRow** | 0xFFFFFFFF | +| 0004 | XLUnicodeString **- strFieldName** | 3 | +| 000C | XLUnicodeString **- strCaption** | Sales Tax | +| 0006 | Feat11FdaAutoFilter **- AutoFilter** | | +| 0004 | DWORD **- cbAutoFilter** | 0x00000000 | +| 0002 | USHORT **- unused** | 0x0003 | + +Figure 28: Structure of Feature11 + +**frtRefHeaderU:** This structure specifies a future version record type header. + +**frtRefHeaderU.rt:** 0x0872 specifies that this record belongs to a record of type Feature11. + +**frtRefHeaderU.grbitFrt:** Specifies attributes for this record. + +**frtRefHeaderU.grbitFrt.fFrtRef:** 0x1 specifies that the containing record specifies a range of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +**frtRefHeaderU.grbitFrt.fFrtAlert:** 0x0 specifies not to alert the user of possible problems when saving as an earlier version of the file format. + +**frtRefHeaderU.ref8:** Specifies a range of cells on the sheet. This refers to the range C4:E7. Because frt.rt is equal to 0x0872, this field is ignored. + +**frtRefHeaderU.ref8.rwFirst:** Specifies the first row in the Table range. + +**frtRefHeaderU.ref8.rwFirst.rw:** 0x0003 specifies the first row in the table on the sheet. This refers to row four of the sheet. + +**frtRefHeaderU.ref8.rwLast:** Specifies the last row in the table range. + +**frtRefHeaderU.ref8.rwLast.rw:** 0x0006 specifies the last row in the table on the sheet. This refers to row seven of the sheet. + +**frtRefHeaderU.ref8.colFirst:** Specifies the first column in the table range. + +**frtRefHeaderU.ref8.colFirst.col:** 0x0002 specifies the first column in the table on the sheet. This refers to column C of the sheet. + +**frtRefHeaderU.ref8.colLast:** Specifies the last column in the table range. + +**frtRefHeaderU.ref8.colLast.col:** 0x0004 specifies the last column in the table on the sheet. This refers to column E of the sheet. + +**isf:** 0x0005 specifies that the shared feature type is a table feature. + +**cref2:** 0x0001 specifies the count of Ref8U records within the **refs2** field. **refs2** contains one Ref8U record. + +**cbFeatData:** 0x00000000 specifies that the size of the **rgbFeat** field is calculated using the following formula: + +- Size of **rgbFeat** = record total size in bytes – size of **refs2** in bytes – 27 bytes + +- Size of **rgbFeat** = 278 bytes - 8 bytes - 27 bytes + +- Size of **rgbFeat** = 243 bytes + +**refs2:** Specifies the references to the ranges of cells within the sheet that are affected by the feature. + +**refs2.ref\[0\]:** The first Ref8U record in the array. It specifies the range C4:E7. This specifies the range of cells for the table. + +**refs2.ref\[0\].rwFirst.rw:** 0x0003 specifies that the first row of the range is row four. + +**refs2.ref\[0\].rwLast.rw:** 0x0006 specifies that the last row of the range is row seven. + +**refs2.ref\[0\].colFirst.col:** 0x0002 specifies that the first column of the range is column C. + +**refs2.ref\[0\].colLast.col:** 0x0004 specifies that the last column of the range is column E. + +**rgbFeat:** Specifies any of the possible features for this record. Contains a TableFeatureType record, as indicated by isf. + +**rgbFeat.TableFeature:** Specifies the definition of this table. + +**rgbFeat.TableFeature.lt:** 0x00000000 specifies the type of [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for the table is a range. + +**rgbFeat.TableFeature.idList:** 0x00000001 specifies the identifier for the table. + +**rgbFeat.TableFeature.crwHeader:** 0x00000001 specifies there is a row at the top of the table that is used as a [**header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38). + +**rgbFeat.TableFeature.crwTotals:** 0x00000000 specifies there is not a row at the bottom of the table that is used as a [**total row**](#gt_95e9bcf4-d644-4e96-9070-dbc80b4d1b28). + +**rgbFeat.TableFeature.idFieldNext:** 0x00000004 specifies the next unique identifier to try when assigning unique identifiers to columns of the table. + +**rgbFeat.TableFeature.cbFSData:** 0x00000040 specifies the size, in bytes, of the fixed portion of this TableFeatureType structure. + +**rgbFeat.TableFeature.rupBuild:** This value is not valid, as specified by **rgbFeat.TableFeature.fGoodRupBld**. + +**rgbFeat.TableFeature.fAutoFilter:** 0x1 specifies the table has [**AutoFilters**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). + +**rgbFeat.TableFeature.fPersistAutoFilter:** 0x1 specifies that the AutoFilter information is preserved for this table across data refresh operations. + +**rgbFeat.TableFeature.fShowInsertRow:** 0x0 specifies the [**insert row**](#gt_3b3c223b-83e0-4697-85eb-815af907b8a9) is not visible. + +**rgbFeat.TableFeature.fInsertRowInsCells:** 0x0 specifies rows are not shifted down because the insert row is not visible. + +**rgbFeat.TableFeature.fLoadPldwIdDeleted:** 0x0 specifies the **idDeleted** field is not present. + +**rgbFeat.TableFeature.fShownTotalRow:** 0x0 specifies the total row is not displayed at the bottom of the table. + +**rgbFeat.TableFeature.fNeedsCommit:** 0x0 specifies that only table modifications that are synchronized with the data source exist. + +**rgbFeat.TableFeature.fSingleCell:** 0x0 specifies the table is not limited to a single cell. + +**rgbFeat.TableFeature.fApplyAutoFilter:** 0x1 specifies that the AutoFilter is currently applied. + +**rgbFeat.TableFeature.fForceInsertToBeVis:** 0x0 specifies the insert row is not forced to be visible. + +**rgbFeat.TableFeature.fCompressedXml:** 0x0 specifies the XML data linked to the table is to be compressed. No XML data link is present. + +**rgbFeat.TableFeature.fLoadCSPName:** 0x0 specifies that the **CSPName** field is not present. + +**rgbFeat.TableFeature.fLoadPldwIdChanged:** 0x0 specifies that the **IdChanged** field is not present. + +**rgbFeat.TableFeature.verXL:** 0xB specifies the table was created using Microsoft Office Excel 2003. + +**rgbFeat.TableFeature.fLoadEntryId:** 0x1 specifies the **EntryId** field is present + +**rgbFeat.TableFeature.fLoadPllstclInvalid:** 0x0 specifies the **CellInvalid** field is not present + +**rgbFeat.TableFeature.fGoodRupBld:** 0x0 specifies the **rupBuild** field is not valid. + +**rgbFeat.TableFeature.fPublished:** 0x0 specifies the table was not published. + +**rgbFeat.TableFeature.lPosStmCache:** 0x00000000 specifies the cached data begins at position 0 in the [List Data stream](#Section_914f09bd8c944c099e8631dfe058f037). + +**rgbFeat.TableFeature.cbStmCache:** 0x00000000 specifies the size, in bytes, of the cached data within the List Data stream is 0. + +**rgbFeat.TableFeature.cchStmCache:** 0x00000000 specifies the count of characters of the cached data within the List Data stream when uncompressed is 0. + +**rgbFeat.TableFeature.lem:** 0x00000000 specifies the table can be directly edited inline. + +**rgbFeat.TableFeature.rgbHashParam:** The value of this field is required to be zeros because the **lt** field is not equal to 0x00000001. + +**rgbFeat.TableFeature.rgbName:** *List1* specifies the unique name of the table. + +**rgbFeat.TableFeature.cFieldData:** 0x0003 specifies the number of columns in the table. + +**rgbFeat.TableFeature.entryId:** 1 specifies the unique identifier for the table. This is ignored because the **lt** field is not equal to 0x00000002. + +**rgbFeat.TableFeature.fieldData:** An array of Feat11FieldDataItem that contains the definition of the columns of the table. The array contains three items as specified by the **cFieldData** field. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\]:** Specifies the definition of the first column of the table. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].idField:** 0x00000001 specifies the identifier of the column. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].lfdt:** 0x00000000 specifies that the table column is of the Web-based data provider data type. This value specifies that the field is unused. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].lfxidt:** 0x00000000 specifies the table column XML data type. This value specifies the field is unused. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].ilta:** 0x00000000 specifies the aggregation function to use for the column. This value specifies that no formula is used. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].cbFmtAgg:** 0x00000000 specifies that the **dxfFmtAgg** field does not exist. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].istnAgg:** 0xFFFFFFFF specifies the total row of the column uses the default style of the table. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fAutoFilter:** 0x1 specifies that this column has AutoFilters. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fAutoFilterHidden:** 0x0 specifies that this column has AutoFilters displayed. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fLoadXmapi:** 0x0 specifies the **rgXmap** field is not present. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fLoadFmla:** 0x0 specifies that the **fmla** field is not present. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fLoadTotalFmla:** 0x0 specifies that the **totalFmla** field is not present. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fLoadTotalArray:** 0x0 specifies that the formula specified by **totalFmla** is not an array formula. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fSaveStyleName:** 0x0 specifies that the **dskHdrCache.strStyleName** field is not present. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fLoadTotalStr:** 0x0 specifies the **strTotal** field is not present. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].fAutoCreateCalcCol:** 0x0 specifies the column does not have a calculated column formula. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].cbFmtInsertRow:** 0x00000000 specifies that the **dxfFmtInsertRow** field does not exist. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].istnInsertRow:** 0xFFFFFFFF specifies the insert row of the column uses the default style of the table. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].strFieldName:** Specifies the name of the column, as provided by the data source. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].strCaption:** *Item* specifies the caption of the column. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].AutoFilter:** Specifies the characteristics of the AutoFilter for the column + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\].AutoFilter.cbAutoFilter:** 0x00000000 specifies that the **recAutoFilter** field does not exist. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[1\]:** Specifies the definition of the second column of the table. The details of most of the fields within this structure are omitted here because they are the same as the fields in the first column **rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\]**. + +**rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[2\]:** Specifies the definition of the third column of the table. The details of most of the fields within this structure are omitted here because they are the same as the fields in the first column **rgbFeat.TableFeature.fieldData.Feat11FieldDataItem\[0\]**. + +## Filters + +This example shows how filters are applied to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) (C4:C8) on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) when the [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) is set to display items that are greater than 70. + +The first record in this example is the [FilterMode](#filtermode) record that appears in a [worksheet substream](#worksheet-substream) (the worksheet substream is not included in this example for brevity). This record specifies that the data in the containing sheet is filtered. + +Other records mentioned in this example are the [AutoFilterInfo](#autofilterinfo) record and [AutoFilter](#autofilter) record. They specify the properties of the AutoFilter and define the conditions that are used to filter the data. + +![AutoFilter in this example within a sheet](media/image86.bin "AutoFilter in this example within a sheet") + +Figure 29: AutoFilter in this example within a sheet + +### Filters: FilterMode + +The first record in this example, [FilterMode](#filtermode), specifies that the data in the containing [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) is filtered. + +| **Size** | **Structure** | +|----------|-----------------------------| +| 0000 | FilterMode **- FilterMode** | + +Figure 30: Structure of FilterMode + +### Filters: AutoFilterInfo + +The [AutoFilterInfo](#autofilterinfo) record specifies the number of columns that have [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) enabled and indicates the beginning of the collection of [AutoFilter](#autofilter) records. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------|-----------| +| 0002 | AutoFilterInfo **- AutoFilterInfo** | | +| 0002 | USHORT **- cEntries** | 0x0001 | + +Figure 31: Structure of AutoFilterInfo + +**cEntries:** 0x0001 specifies the number of filtered columns. + +### Filters: AutoFilter + +Next, the [AutoFilter](#autofilter) record specifies the criteria that are used to filter the data. + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------|--------------------| +| 0018 | AutoFilter **- AutoFilter** | | +| 0002 | USHORT **- iEntry** | 0x0000 | +| 2 bits | USHORT **- wJoin** | 0x0 | +| 1 bit | USHORT **- fSimple1** | 0x0 | +| 1 bit | USHORT **- fSimple2** | 0x0 | +| 1 bit | USHORT **- fTopN** | 0x0 | +| 1 bit | USHORT **- fTop** | 0x0 | +| 1 bit | USHORT **- fPercent** | 0x0 | +| 9 bits | USHORT **- wTopN** | 0x000 | +| 000A | [AFDOper](#afdoper) **- doper1** | | +| 0001 | BYTE **- vt** | 0x02 | +| 0001 | BYTE **- grbitSign** | 0x04 | +| 0008 | [AFDOperRk](#afdoperrk) **- vtValue** | | +| 0004 | [RkNumber](#rknumber) **- rk** | | +| 1 bit | ULONG **- fX100** | 0x0 | +| 1 bit | ULONG **- fInt** | 0x0 | +| 30 bits | ULONG **- num** | 0x10146000 | +| 0004 | DWORD **- unused1** | 0x00000000 | +| 000A | AFDOper **- doper2** | | +| 0001 | BYTE **- vt** | 0x00 | +| 0001 | BYTE **- grbitSign** | 0x00 | +| 0008 | BLOB **- vtValue** | 0x0000000000000000 | + +Figure 32: Structure of AutoFilter + +**iEntry:** 0x0000 specifies that this [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) applies to the first column in this [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**wJoin:** 0x0 specifies that filtering conditions specified in **doper1** and **doper2** conditions are joined by a logical AND operation when applying the AutoFilter. + +**fSimple1:** 0x0 specifies that an application-specific performance optimization cannot be used. + +**fSimple2:** 0x0 specifies that an application-specific performance optimization cannot be used. + +**fTopN:** 0x0 specifies that this AutoFilter is not a [**Top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9). + +**fTop:** 0x0 is ignored because **fTopN** is 0. + +**fPercent:** 0x0 is ignored because **fTopN** is 0. + +**wTopN:** 0x000 is ignored because **fTopN** is 0. + +**doper1:** An AFDOper that specifies the first AutoFilter condition. + +**doper1.vt:** 0x02 specifies that the type of comparison is numeric. + +**doper1.grbitSign:** 0x04 specifies that the comparison operation is GREATER THAN. + +**doper1.vtValue:** An AFDOperRk that specifies a numeric value. + +**doper1.vtValue.rk:** An RkNumber specifies a numeric value. + +**doper1.vtValue.rk.fX100:** 0x0 specifies that the value in the **doper1.vtValue.rk.num** field was not multiplied by 100 when it was saved. + +**doper1.vtValue.rk.fInt:** 0x0 specifies that the value in the **doper1.vtValue.rk.num** field is 30 most significant bits of a 64-bit binary floating-point number. + +**doper1.vtValue.rk.num:** 0x10146000 specifies the 30 most significant bits of a 64-bit binary floating-point number whose remaining bits are 0. That number is 70. + +**doper2:** An AFDOper that specifies the second AutoFilter condition. + +**doper2.vt:** 0x00 specifies that there is no second AutoFilter defined. + +**doper2.grbitSign:** 0x00 specifies that there is no second filter. + +**doper2.vtValue:** 0x0000000000000000 is ignored because **doper2.vt** is 0. + +## External References + +This example shows a workbook where the cell F5 contains an external reference to \[Book1.xls\]Sheet1!B3. The example workbook and Book1.xls are in the same folder, and the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) contents of Sheet1!B3 in the external workbook contains the string "External Cell". The following figure shows a possible implementation of the external reference discussed in this example: + +![External reference in this example a sheet](media/image87.bin "External reference in this example a sheet") + +Figure 33: External reference in this example a sheet + +### External References: Formula + +The first record in this example is the [Formula](#formula) record that appears in the [global substream](#Section_ca4c174887294a93abb94602b3a01fb1) (the global substream is not included in this example for brevity). This record specifies the formula for the cell F5. The formula is a reference to a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in an external [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +Other records mentioned in this example are [String](#string), [SupBook](#supbook), [XCT](#xct), [CRN](#crn) and [ExternSheet](#externsheet) records. These records specify the external referenced cell as well as the [external cell cache](#Section_b985d1a223f3483ebebdbd0e882d4c89) that stores the cached value of the cell. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------------------------|------------| +| 001D | Formula **- Formula** | | +| 0006 | [Cell](#cell) **- cell** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0004 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0005 | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x000F | +| 0008 | [FormulaValue](#formulavalue) **- val** | | +| 0001 | BYTE **- byte1** | 0x00 | +| 0001 | BYTE **- byte2** | 0x00 | +| 0001 | BYTE **- byte3** | 0xA0 | +| 0001 | BYTE **- byte4** | 0x00 | +| 0001 | BYTE **- byte5** | 0x9C | +| 0001 | BYTE **- byte6** | 0x01 | +| 0002 | USHORT **- fExprO** | 0xFFFF | +| 1 bit | USHORT **- fAlwaysCalc** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFill** | 0x0 | +| 1 bit | USHORT **- fShrFmla** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 1 bit | USHORT **- fClearErrors** | 0x0 | +| 10 bits | USHORT **- reserved3** | 0x000 | +| 0004 | ULONG **- unused** | 0xFCC412C8 | +| 0009 | [CellParsedFormula](#cellparsedformula) **- formula** | | +| 0002 | WORD **- cce** | 0x0007 | +| 0007 | [Rgce](#rgce) **- rgce** | | +| 0007 | [Ptg](#ptg) **- Ptg\[0\]** | | +| 0007 | [PtgRef3d](#ptgref3d) **- PtgRef3d** | | +| 5 bits | BYTE **- ptg** | 0x1A | +| 2 bits | [PtgDataType](#ptgdatatype) **- type** | 0x2 | +| 1 bit | BYTE **- reserved** | 0x0 | +| 0002 | USHORT **- ixti** | 0x0000 | +| 0004 | [RgceLoc](#rgceloc) **- loc** | | +| 0002 | [RwU](#rwu) **- row** | | +| 0002 | USHORT **- rw** | 0x0002 | +| 0002 | [ColRelU](#colrelu) **- column** | | +| 14 bits | USHORT **- col** | 0x0001 | +| 1 bit | USHORT **- colRelative** | 0x1 | +| 1 bit | USHORT **- rowRelative** | 0x1 | + +Figure 34: Structure of Formula + +**cell:** Specifies a cell in this [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that contains the external reference. The specified cell is F5. + +**cell.rw:** Specifies the row of this cell in this sheet. + +**cell.rw.rw:** 0x0004 specifies that the row of this cell is row 5. + +**cell.col:** Specifies the column of this cell in this sheet. + +**cell.col.col:** 0x0005 specifies that the column of this cell is column F. + +**cell.ixfe:** Specifies the formatting properties for this cell. + +**cell.ixfe.ixfe:** 0x000F specifies that the cell has the default cell format. + +**val:** Specifies the value to which the formula evaluated. This specifies the value stored in cell F5. + +**val.byte1:** 0x00 specifies that the value to which this formula is evaluated is a string value. The string value is stored in the String record following this record. + +**val.fExprO:** 0xFFFF specifies that the value to which this formula evaluated is a Boolean value, an error value, a string value, or a blank string value and that **val.byte2**, **val.byte3**, **val.byte4**, **val.byte5**, and **val.byte6** are ignored. **val.byte2**, **val.byte3**, **val.byte4**, **val.byte5**, and **val.byte6** are omitted from this example for brevity. + +**fAlwaysCalc:** 0x0 specifies that this cell value is not to be calculated during the next recalculation. + +**fFill:** 0x0 specifies that this cell has either a [**fill alignment**](#gt_cfc4e171-6104-470e-9ebb-812afea17078) or a [**center-across-selection alignment**](#gt_ef7324bd-dac8-46e2-8df5-db44d8b925a8). + +**fShrFmla:** 0x0 specifies that the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) is not part of a shared formula. + +**fClearErrors:** 0x0 specifies that the formula is not excluded from [**formula error checking**](#gt_c28d38d6-c6d1-4d06-89c2-29816f9c5b23). + +**formula:** Specifies the formula contained in the cell F5 in this sheet. + +**formula.cce:** 0x0007 specifies that the following **formula.rgce** field is 7 bytes. + +**formula.rgce:** Specifies the sequence of Ptgs structures. The sequence of Ptgs specify the formula. + +**formula.rgce.Ptg\[0\]:** The first and only Ptg structure in the sequence. Specifies that there is only one element in the formula. + +**formula.rgce.Ptg\[0\].PtgRef3d:** Specifies the PtgRef3d structure. Specifies that the formula is a reference to a single cell in a sheet. + +**formula.rgce.Ptg\[0\].PtgRef3d.ptg:** 0x1A specifies that this Ptg is a PtgRef3d structure. + +**formula.rgce.Ptg\[0\].PtgRef3d.type:** 0x2 specifies that the PtgRef3d data type is a single value. + +**formula.rgce.Ptg\[0\].PtgRef3d.ixti:** 0x0000 specifies the first [XTI](#xti) structure of the **rgXTI** array in the ExternSheet record. The first XTI of the **rgXTI** array specifies the Supbook record that specifies the target sheet that contains the referenced cell. This Supbook record is the third record in this example. The ExternSheet record is the seventh record in this example. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc:** Specifies the coordinates of the referenced cell. This field is a RgceLoc value because PtgRef3d is not part of a [NameParsedFormula](#nameparsedformula) structure. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.row:** Specifies the row of the referenced cell. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.row.rw:** 0x0002 specifies that the row of the referenced cell is row 3. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.column:** Specifies the column of the referenced cell. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.column.col:** 0x0001 specifies that the column of the referenced cell is column B. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.column.colRelative:** 0x1 specifies that the column is a [**relative reference**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac). + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.column.rowRelative:** 0x1 specifies that the row is a relative reference. + +### External References: String + +The next record in this example, [String](#string), specifies the Unicode string value to which the formula evaluated. + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------------------------|---------------| +| 0010 | String **- String** | | +| 0010 | [XLUnicodeString](#xlunicodestring) **- string** | External Cell | + +Figure 35: Structure of String + +**string:** *External Cell* is the Unicode string value. + +### External References: SupBook 1 + +The next record in this example, [Supbook](#supbook), specifies an external workbook referencing [supporting link](#Section_cc5920ba01074d92bbdfc12ca986f31f) and specifies the beginning of a collection of records that specifies the referenced cell (B3) in the [External Workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc) (*Book1.xls*). This record is the first SupBook record in the [global substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +The [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) of the referenced cell (*Book1.xls*) is specified in the Supbook record. The [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) of the referenced cell (*Sheet1*) is specified in the [XCT](#xct) record following this record. The referenced cell (B3) is specified in the [CRN](#crn) record following the XCT record. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 002A | SupBook **- SupBook** | | +| 0002 | USHORT **- ctab** | 0x0003 | +| 0002 | USHORT **- cch** | 0x000A | +| 000B | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- virtPath** | Book1.xls | +| 001B | [XLUnicodeString](#xlunicodestring) **- rgst** | | +| 0009 | XLUnicodeString **- rgst\[0\]** | Sheet1 | +| 0009 | XLUnicodeString **- rgst\[1\]** | Sheet2 | +| 0009 | XLUnicodeString **- rgst\[2\]** | Sheet3 | + +Figure 36: Structure of SupBook + +**ctab:** 0x0003 specifies that there are three sheets in the referenced workbook. + +**cch:** 0x000A specifies that there are 10 characters in **virtPath**. + +**virtPath:** *Book1.xls* specifies the encoded path of the referenced workbook. The length of the string is 10 characters, but the first character is an unprintable Unicode character with a value of 0x01. + +**rgst:** Specifies an array of three sheets contained within the referenced workbook. + +**rgst.rgst\[0\]:** *Sheet1* specifies the name of the first sheet in the referenced workbook. + +**rgst.rgst\[1\]:** *Sheet2* specifies the name of the second sheet in the referenced workbook. + +**rgst.rgst\[2\]:** *Sheet3* specifies the name of the third sheet in the referenced workbook. + +### External References: XCT + +The next record in this example, [XCT](#xct), specifies the beginning of an [external cell cache](#Section_b985d1a223f3483ebebdbd0e882d4c89) and specifies the beginning of a collection of [CRN](#crn) records. The collection of CRN records specifies the value of the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) (B3) in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) (*Sheet1*) in the external cell cache. + +| **Size** | **Structure** | **Value** | +|----------|-------------------|-----------| +| 0004 | XCT **- Xct** | | +| 0002 | SHORT **- ccrn** | 0x0001 | +| 0002 | USHORT **- itab** | 0x0000 | + +Figure 37: Structure of Xct + +**ccrn:** 0x0001 specifies that there is one CRN record immediately following this record. + +**itab:** 0x0000 specifies the first element in the **rgst** field of the [SupBook](#supbook) that specifies that the referenced cell is in the *Sheet1* sheet. + +### External References: CRN + +The next record in this example, [CRN](#crn), specifies the value of the referenced [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the [external cell cache](#Section_b985d1a223f3483ebebdbd0e882d4c89). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------|---------------| +| 0015 | CRN **- Crn** | | +| 0001 | [ColByteU](#colbyteu) **- colLast** | | +| 0001 | BYTE **- col** | 0x01 | +| 0001 | ColByteU **- colFirst** | | +| 0001 | BYTE **- col** | 0x01 | +| 0002 | [RwU](#rwu) **- row** | | +| 0002 | USHORT **- rw** | 0x0002 | +| 0011 | CRNOper **- crnOper** | | +| 0011 | [SerAr](#serar) **- crnOper\[0\]** | | +| 0001 | BYTE **- reserved** | 0x02 | +| 0010 | [SerStr](#serstr) **- string** | External Cell | + +Figure 38: Structure of Crn + +**colLast:** Specifies the column of the last cell that has a value in the external cell cache. + +**colLast.col:** 0x01 specifies that the column of the last cell is column B. + +**colFirst:** Specifies the column of the first cell that has a value in the external cell cache. + +**colFirst.col:** 0x01 specifies that the column of the first cell is column B. + +**row:** Specifies the row index of the cell that has a value in the external cell cache. + +**row.rw:** 0x0002 specifies that the row of the cell is row 3. + +**crnOper:** Specifies an array of cell values in the range specified by **colLast**, **colFirst** and **row**, which is B3. + +**crnOper.crnOper\[0\].string:** *External Cell* specifies the text referenced in cell B3. + +### External References: SupBook 2 + +The next record in this example, [SupBook](#supbook), specifies a self-referencing [supporting link](#Section_cc5920ba01074d92bbdfc12ca986f31f). The self-referencing supporting link is used when a cell in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) refers to a cell in a different [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the same workbook. In this example this record is not used. This is the second SupBook record in the [global substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------|-----------| +| 0004 | SupBook **- SupBook** | | +| 0002 | USHORT **- ctab** | 0x0003 | +| 0002 | USHORT **- cch** | 0x0401 | + +Figure 39: Structure of SupBook + +The **VirtPath** field and **rgst** field of this record are similar to the corresponding fields of the third record (SupBook) in this example and are omitted for brevity. + +**ctab:** 0x0003 specifies that there are three sheets in the referenced workbook. + +**cch:** 0x0401 specifies that this is self-referencing supporting link. + +### External References: ExternSheet + +The next record in this example, [ExternSheet](#externsheet), specifies a collection of [XTI](#xti) records that specify the [supporting link](#Section_cc5920ba01074d92bbdfc12ca986f31f) information. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------|-----------| +| 000E | ExternSheet **- ExtSheet** | | +| 0002 | USHORT **- cXTI** | 0x0002 | +| 000C | XTI **- rgXTI** | | +| 0006 | XTI **- xti\[0\]** | | +| 0002 | USHORT **- iSupBook** | 0x0000 | +| 0002 | SHORT **- itabFirst** | 0x0000 | +| 0002 | SHORT **- itabLast** | 0x0000 | +| 0006 | XTI **- xti\[1\]** | | +| 0002 | USHORT **- iSupBook** | 0x0001 | +| 0002 | SHORT **- itabFirst** | 0x0000 | +| 0002 | SHORT **- itabLast** | 0x0000 | + +Figure 40: Structure of ExtSheet + +**cXTI:** 0x0002 specifies that there are two elements in the **rgXTI** array. + +**rgXTI:** An array of XTI elements. The number of elements in the array is specified by the **cXTI** field. + +**rgXTI.xti\[0\]:** This is the first XTI element in the array. + +**rgXTI.xti\[0\].iSupBook:** 0x0000 specifies the reference to the first [SupBook](#supbook) record in the [global substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +**rgXTI.xti\[0\].itabFirst:** 0x0000 specifies that the supporting link has a sheet-level scope and specifies the first sheet, within the referenced [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), that is in scope. The first sheet in scope is *Sheet1*. + +**rgXTI.xti\[0\].itabLast:** 0x0000 specifies that the supporting link has a sheet-level scope and specifies the last sheet, within the referenced workbook, that is in scope. The last sheet in scope is *Sheet1*. + +**rgXTI.xti\[1\]:** This is the second XTI element in the array. (The details of the referenced XTI record are omitted for brevity.) + +**rgXTI.xti\[1\].iSupBook:** 0x0001 specifies the reference to the second SupBook record in the global substream. + +## Column Chart Object + +This example shows a column chart object on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). The set of records that specify the column chart exist in the [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11) of the file (the chart sheet substream is not included in this example for brevity). The column chart specified in this example has a single series with three control points. The following figure shows a possible implementation of the column chart discussed in this example: + +![Column chart in this example within a sheet](media/image88.bin "Column chart in this example within a sheet") + +Figure 41: Column chart in this example within a sheet + +### Column Chart Object: Chart + +The first record in this example is the [Chart](#chart-2) record. This record specifies the position and [**dimensions (2)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)). The position of the chart area is automatically calculated by the application and the dimension (2) of the chart is specified by the **dx** and **dy** fields. + +| **Size** | **Structure** | **Value** | +|----------|---------------------|------------| +| 0010 | Chart **- Chart** | | +| 0004 | FixedPoint **- x** | 0x00000000 | +| 0004 | FixedPoint **- y** | 0x00000000 | +| 0004 | FixedPoint **- dx** | 0x01493FD0 | +| 0004 | FixedPoint **- dy** | 0x00F0C000 | + +Figure 42: Structure of Chart + +**x:** The value of this field is ignored because the **fAutoPosition** field of the **Frame** record that follows this record equals 1. + +**y:** The value of this field is ignored because the **fAutoPosition** field of the **Frame** record that follows this record equals 1. + +**dx:** 0x01493FD0 specifies the width of the chart in [**points**](#gt_d072e4da-7898-4227-8f25-9fe77db43571). This field is a fixed point and the width is calculated using the following formula: + +> width of chart = 0149 + (3FD0 / 65536.0) = 329 + (16336 / 65536) + +**dy:** 0x00F0C000 specifies the height of the chart in points. This field is a fixed point and the height is calculated using the following formula: + +> height of chart = 00F0 + (C000 / 65536.0) = 240 + (49152 / 65536) + +The next record in this example, [Begin](#begin), specifies the beginning of a collection of records that specifies the chart area (section 2.2.3.17) of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +The next record in this example, [Scl](#scl), specifies the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) of the current view in the window used to display the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). The zoom level of the current view is equal to 1. + +The next record in this example, [PlotGrowth](#plotgrowth), specifies the scale factors for [**font scaling**](#gt_47254269-4165-4a8c-92a0-c920f732d0bd) in the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). + +(The details of the Begin record, the Scl record, and the PlotGrowth record are omitted from the example for brevity.) + +### Column Chart Object: Frame + +The next record in this example, [Frame](#frame), specifies the type, size, and position of the frame around the column chart. The size of the frame is stored in the [Chart](#chart-2) record and the position of the frame is automatically calculated by the application. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------|-----------| +| 0004 | Frame **- Frame** | | +| 0002 | USHORT **- frt** | 0x0000 | +| 1 bit | USHORT **- fAutoSize** | 0x0 | +| 1 bit | USHORT **- fAutoPosition** | 0x1 | +| 14 bits | USHORT **- reserved** | 0x0000 | + +Figure 43: Structure of Frame + +**frt:** 0x0000 specifies that the frame surrounding the chart element does not have a shadow. + +**fAutoSize:** 0x0000 specifies that the size of the frame is not automatically calculated. The width (**dx** field) and height (**dy** field) of the Chart record are used as the size of the frame. + +**fAutoPosition:** 0x0001 specifies that the position of the frame is automatically calculated by the application and the **x** and **y** fields of the Chart record are ignored. + +### Column Chart Object: LineFormat + +The next record in this example, [LineFormat](#lineformat), specifies the appearance of the lines of the frame. + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------|-----------| +| 000C | LineFormat **- LineFormat** | | +| 0004 | [LongRGB](#longrgb) **- rgb** | | +| 0001 | BYTE **- red** | 0x00 | +| 0001 | BYTE **- green** | 0x00 | +| 0001 | BYTE **- blue** | 0x00 | +| 0001 | BYTE **- reserved** | 0x00 | +| 0002 | USHORT **- lns** | 0x0000 | +| 0002 | SHORT **- we** | 0x0000 | +| 1 bit | USHORT **- fAuto** | 0x1 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fAxisOn** | 0x0 | +| 1 bit | USHORT **- fAutoCo** | 0x1 | +| 12 bits | USHORT **- reserved2** | 0x000 | +| 0002 | [IcvChart](#icvchart) **- icv** | | +| 0002 | USHORT **- icv** | 0x004D | + +Figure 44: Structure of LineFormat + +(Fields in this record that are ignored because **fAuto** is 0x1 are omitted for brevity.) + +**fAuto:** 0x1 specifies that the contents of the **lns**, **we**, **icv,** and **rgb** field are ignored and the defaults specified in the following table are used instead: + +| Attribute | Default Value | +|------------------------|-------------------| +| Line pattern (**lns**) | 0xFFFF (Hairline) | +| Line weight (**we**) | 0x0000 (Narrow) | +| Line color (**icv**) | 0x004D | +| Line color (**rgb**) | 0x004D | + +**fAxisOn:** 0x0000 specifies this field is ignored because the previous record is not an [AxisLine](#axisline) record with an **id** field equal to 0X0000, specifying the frame does not have any [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) lines. + +### Column Chart Object: AreaFormat + +The next record in this example, [AreaFormat](#areaformat), specifies the patterns and colors used in the filled area of the column chart. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------|-----------| +| 0010 | AreaFormat **- AreaFormat** | | +| 0004 | [LongRGB](#longrgb) **- rgbFore** | | +| 0001 | BYTE **- red** | 0xFF | +| 0001 | BYTE **- green** | 0xFF | +| 0001 | BYTE **- blue** | 0xFF | +| 0001 | BYTE **- reserved** | 0x00 | +| 0004 | LongRGB **- rgbBack** | | +| 0001 | BYTE **- red** | 0x00 | +| 0001 | BYTE **- green** | 0x00 | +| 0001 | BYTE **- blue** | 0x00 | +| 0001 | BYTE **- reserved** | 0x00 | +| 0002 | SHORT **- fls** | 0x0001 | +| 1 bit | WORD **- fAuto** | 0x1 | +| 1 bit | WORD **- fInvertNeg** | 0x0 | +| 14 bits | WORD **- reserved** | 0x0000 | +| 0002 | [IcvChart](#icvchart) **- icvFore** | | +| 0002 | USHORT **- icv** | 0x004E | +| 0002 | IcvChart **- icvBack** | | +| 0002 | USHORT **- icv** | 0x004D | + +Figure 45: Structure of AreaFormat + +(Fields in this record that are ignored because **fAuto** is 0x1 are omitted for brevity.) + +**fls:** 0x0001 specifies that the fill pattern is solid. + +**fAuto:** 0x1 specifies that the fill colors are automatically set by the application. + +The next record in this example, [End](#end), specifies the end of a collection of records that specifies the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)) of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). The details of End record are omitted from the example for brevity. + +### Column Chart Object: Series + +The next record in this example, [Series](#series-1), specifies a Series of this chart, the type of data it contains and the number of data fields that make up this series**.** The series of this column chart contains three textual [**categories**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) and three numerical values. In this example the series of this column chart is specified by the first Series record in the collection of Series records in the current [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11). + +| **Size** | **Structure** | **Value** | +|----------|------------------------|-----------| +| 000C | Series **- Series** | | +| 0002 | USHORT **- sdtX** | 0x0003 | +| 0002 | USHORT **- sdtY** | 0x0001 | +| 0002 | USHORT **- cValx** | 0x0003 | +| 0002 | USHORT **- cValy** | 0x0003 | +| 0002 | USHORT **- sdtBSize** | 0x0001 | +| 0002 | USHORT **- cValBSize** | 0x0000 | + +Figure 46: Structure of Series + +Fields in this record that are ignored because this [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) is not of the type bubble chart group, are omitted for brevity. + +**sdtX:** 0x0003 specifies that the categories contain text information. + +**sdtY:** 0x0001 specifies that the values contain numeric information. + +**cValx:** 0x0003 specifies that the count of categories is 3. + +**cValy:** 0x0003 specifies that the count of values is 3. + +Records following this record, and before the next [BRAI](#brai) record, are omitted for brevity. + +### Column Chart Object: BRAI 1 + +The next record in this example, [BRAI](#brai), specifies a reference to [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that have values that specify the name of the series. + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------------------------|-----------| +| 000F | BRAI **- BRAI** | | +| 0001 | BYTE **- id** | 0x00 | +| 0001 | BYTE **- rt** | 0x02 | +| 1 bit | USHORT **- fUnlinkedIfmt** | 0x0 | +| 15 bits | USHORT **- reserved** | 0x0000 | +| 0002 | IFmt **- ifmt** | 0x0000 | +| 0009 | [ChartParsedFormula](#chartparsedformula) **- formula** | | +| 0002 | WORD **- cce** | 0x0007 | +| 0007 | [Rgce](#rgce) **- rgce** | | +| 0007 | [Ptg](#ptg) **- Ptg\[0\]** | | +| 0007 | [PtgRef3d](#ptgref3d) **- PtgRef3d** | | +| 5 bits | BYTE **- ptg** | 0x1A | +| 2 bits | [PtgDataType](#ptgdatatype) **- type** | 0x1 | +| 1 bit | BYTE **- reserved** | 0x0 | +| 0002 | USHORT **- ixti** | 0x0000 | +| 0004 | [RgceLoc](#rgceloc) **- loc** | | +| 0002 | [RwU](#rwu) **- row** | | +| 0002 | USHORT **- rw** | 0x0001 | +| 0002 | [ColRelU](#colrelu) **- column** | | +| 14 bits | USHORT **- col** | 0x0000 | +| 1 bit | USHORT **- colRelative** | 0x0 | +| 1 bit | USHORT **- rowRelative** | 0x0 | + +Figure 47: Structure of BRAI + +**id:** 0x00 specifies that the values of the referenced cells specify the name of the series. + +**rt:** 0x02 specifies that the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is values from a range of cells in a sheet specified by the **rgce** field. + +**fUnlinkedIfmt:** 0x0 specifies that the series name maintains the number formatting of the referenced data. + +**ifmt:** 0x0000 specifies that the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) for the name of the series is automatically determined by the application. + +**formula.cce:** 0x0007 specifies that the length of **rgce** is 7 bytes. + +**formula.rgce.Ptg\[0\].PtgRef3d:** This operand specifies a reference to a specific cell on one or more sheets. + +**formula.rgce.Ptg\[0\].PtgRef3d.ptg:** 0x1A specifies that this Ptg is of type PtgRef3d. + +**formula.rgce.Ptg\[0\].PtgRef3d.type:** 0x1 specifies that the value of the **ptg** field is a reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +**formula.rgce.Ptg\[0\].PtgRef3d.ixti:** 0x0000 specifies that the name of the series is found on the sheets referenced by the first [XTI](#xti) in the [ExternSheet](#externsheet) record. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc:** Specifies that the coordinates of the referenced cell for the name of the series refers to cell A2. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.row.rw:** 0x0001 specifies that the referenced cell is in row two. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.column.col:** 0x0000 specifies that the referenced cell is in column A. + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.column.colRelative:** 0x0 specifies that the **col** field is an [**absolute reference**](#gt_cb0d7340-bfcf-4740-b77b-6616c2e4a542). + +**formula.rgce.Ptg\[0\].PtgRef3d.loc.column.rowRelative:** 0x0 specifies that the **rw** field is an absolute reference. + +### Column Chart Object: SeriesText + +The next record in this example, [SeriesText](#seriestext), specifies the name of this [Series](#series-1). The name of this Series is *Customers*. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0016 | SeriesText **- SeriesText** | | +| 0002 | USHORT **- reserved** | 0x0000 | +| 0014 | [ShortXLUnicodeString](#shortxlunicodestring) **- stText** | Customers | + +Figure 48: Structure of SeriesText + +**stText:** *Customers* specifies name of the series. + +### Column Chart Object: BRAI 2 + +The next record in this example, [BRAI](#brai), specifies a reference to data in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that specifies the values of this series. The values for this series are stored in the range B2:D2. + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------------------------|-----------| +| 0013 | BRAI **- BRAI** | | +| 0001 | BYTE **- id** | 0x01 | +| 0001 | BYTE **- rt** | 0x02 | +| 1 bit | USHORT **- fUnlinkedIfmt** | 0x0 | +| 15 bits | USHORT **- reserved** | 0x0000 | +| 0002 | IFmt **- ifmt** | 0x0000 | +| 000D | [ChartParsedFormula](#chartparsedformula) **- formula** | | +| 0002 | WORD **- cce** | 0x000B | +| 000B | [Rgce](#rgce) **- rgce** | | +| 000B | [Ptg](#ptg) **- Ptg\[0\]** | | +| 000B | [PtgArea3d](#ptgarea3d) **- PtgArea3d** | | +| 5 bits | BYTE **- ptg** | 0x1B | +| 2 bits | [PtgDataType](#ptgdatatype) **- type** | 0x1 | +| 1 bit | BYTE **- reserved** | 0x0 | +| 0002 | USHORT **- ixti** | 0x0000 | +| 0008 | [RgceArea](#rgcearea) **- area** | | +| 0002 | [RwU](#rwu) **- rowFirst** | | +| 0002 | USHORT **- rw** | 0x0001 | +| 0002 | RwU **- rowLast** | | +| 0002 | USHORT **- rw** | 0x0001 | +| 0002 | [ColRelU](#colrelu) **- columnFirst** | | +| 14 bits | USHORT **- col** | 0x0001 | +| 1 bit | USHORT **- colRelative** | 0x0 | +| 1 bit | USHORT **- rowRelative** | 0x0 | +| 0002 | ColRelU **- columnLast** | | +| 14 bits | USHORT **- col** | 0x0003 | +| 1 bit | USHORT **- colRelative** | 0x0 | +| 1 bit | USHORT **- rowRelative** | 0x0 | + +Figure 49: Structure of BRAI + +**id:** 0x01 specifies that the referenced data specifies the values of the series. + +**rt:** 0x02 specifies that the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is values from a range of cells in a sheet specified by the **rgce** field. + +**fUnlinkedIfmt:** 0x0 specifies that the series maintains the number formatting of the referenced data. + +**ifmt:** 0x0000 specifies that the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) for the values of the series is automatically determined by the application. + +**formula.cce:** 0x000B specifies that the length of the **rgce** field is 11 bytes. + +**formula.rgce.Ptg\[0\].PtgArea3d:** This operand specifies a reference to the rectangular range of cells on the sheet. + +**formula.rgce.Ptg\[0\].PtgArea3d.ptg:** 0x1B specifies that this Ptg structure is of type PtgArea3d. + +**formula.rgce.Ptg\[0\].PtgArea3d.type:** 0x01 specifies that the value of the **ptg** field is a reference to a range. + +**formula.rgce.Ptg\[0\].PtgArea3d.ixti:** 0x0000 specifies the values of the series are found on the sheet referenced by the first [XTI](#xti) structure in the [ExternSheet](#externsheet) record. + +**formula.rgce.Ptg\[0\].PtgArea3d.area:** Specifies that the coordinates of the referenced rectangular range of cells for values of the series are in the range B2:D2. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.rowFirst.rw:** 0x0001 specifies that row two of the sheet is the first row of the rectangular range of cells. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.rowLast.rw:** 0x0001 specifies that row two of the sheet is the last row of the rectangular range of cells. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.columnFirst.col:** 0x0001 specifies that column B of the sheet is the first column of the rectangular range of cells. The details of this ColRelU are not included in this example for brevity. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.columnLast.col:** 0x0003 specifies that column D of the sheet is the last column of the rectangular range of cells. The details of this ColRelU are not included in this example for brevity. + +### Column Chart Object: BRAI 3 + +The next record in this example, [BRAI](#brai), specifies a reference to data in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that specifies the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) names of this series. The category names are stored in the range B1:D1. + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------------------------|-----------| +| 0013 | BRAI **- BRAI** | | +| 0001 | BYTE **- id** | 0x02 | +| 0001 | BYTE **- rt** | 0x02 | +| 0002 | USHORT **- fUnlinkedIfmt** | 0x0000 | +| 0002 | USHORT **- reserved** | 0x0000 | +| 0002 | IFmt **- ifmt** | 0x0000 | +| 000D | [ChartParsedFormula](#chartparsedformula) **- formula** | | +| 0002 | WORD **- cce** | 0x000B | +| 000B | [Rgce](#rgce) **- rgce** | | +| 000B | [Ptg](#ptg) **- Ptg\[0\]** | | +| 000B | [PtgArea3d](#ptgarea3d) **- PtgArea3d** | | +| 0001 | BYTE **- ptg** | 0x1B | +| 0001 | [PtgDataType](#ptgdatatype) **- type** | 0x01 | +| 0001 | BYTE **- reserved** | 0x00 | +| 0002 | USHORT **- ixti** | 0x0000 | +| 0008 | [RgceArea](#rgcearea) **- area** | | +| 0002 | [RwU](#rwu) **- rowFirst** | | +| 0002 | USHORT **- rw** | 0x0000 | +| 0002 | RwU **- rowLast** | | +| 0002 | USHORT **- rw** | 0x0000 | +| 0002 | [ColRelU](#colrelu) **- columnFirst** | | +| 14 bits | USHORT **- col** | 0x0001 | +| 1 bit | USHORT **- colRelative** | 0x0 | +| 1 bit | USHORT **- rowRelative** | 0x0 | +| 0002 | ColRelU **- columnLast** | | +| 14 bits | USHORT **- col** | 0x0003 | +| 1 bit | USHORT **- colRelative** | 0x0 | +| 1 bit | USHORT **- rowRelative** | 0x0 | + +Figure 50: Structure of BRAI + +**id:** 0x02 specifies that the referenced data specifies the category name of the series. + +**rt:** 0x02 specifies that the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is values from a range of cells in a sheet specified by the **rgce** field. + +**fUnlinkedIfmt:** 0x0000 specifies that the series maintains the number formatting of the referenced data. + +**ifmt:** 0x0000 specifies that the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) for the category names of the series is automatically determined by the application. + +**formula.cce:** 0x000B specifies that the length of the **rgce** field is 11 bytes. + +**formula.rgce.Ptg\[0\].PtgArea3d:** This operand specifies a reference to the rectangular range of cells on the sheet. + +**formula.rgce.Ptg\[0\].PtgArea3d.ptg:** 0x1B specifies that this Ptg structure is of type PtgArea3d. + +**formula.rgce.Ptg\[0\].PtgArea3d.type:** 0x01 specifies that the data type for the value of the **ptg** field is a reference to a range. + +**formula.rgce.Ptg\[0\].PtgArea3d.ixti:** 0x0000 specifies that the name of the category is found on the sheet referenced by the first [XTI](#xti) structure in the [ExternSheet](#externsheet) record. + +**formula.rgce.Ptg\[0\].PtgArea3d.area:** Specifies that the coordinates of the referenced rectangular range of cells for the names of categories are in the range B1:D1. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.rowFirst.rw:** 0x0000 specifies that the first row of the sheet is the first row of the rectangular range of cells. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.rowLast.rw:** 0x0000 specifies that the first row of the sheet is the last row of the rectangular range of cells. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.columnFirst.col:** 0x0001 specifies that the second column of the sheet is the first column of the rectangular range of cells. The details of this ColRelU structure are not included in this example for brevity. + +**formula.rgce.Ptg\[0\].PtgArea3d.area.columnLast.col:** 0x0003 specifies that the fourth column of the sheet is the last column of the rectangular range of cells. The details of this ColRelU are not included in this example for brevity. + +(Records following this record, and before the next [DataFormat](#dataformat) record, are omitted for brevity.) + +### Column Chart Object: DataFormat + +The next record in this example, [DataFormat](#dataformat), specifies the series of this chart to which the formatting information applies. The formatting information is specified by the [Lineformat](#lineformat) record and [AreaFormat](#areaformat) record following this record. (The Lineformat and AreaFormat records are not included in this example for brevity.) + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------|-----------| +| 0008 | DataFormat **- DataFormat** | | +| 0002 | USHORT **- xi** | 0xFFFF | +| 0002 | USHORT **- yi** | 0x0000 | +| 0002 | SHORT **- iss** | 0x0000 | +| 15 bits | SHORT **- reserved** | 0x0000 | + +Figure 51: Structure of DataFormat + +**xi:** 0xFFFF specifies that the LineFormat record and AreaFormat record following this record specify the format of the series. + +**yi:** 0x0000 specifies that the series of this chart is specified by the first [Series](#series-1) record in the collection of Series records in the current [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11). + +**iss:** 0x0000 specifies the number of the series based on the ordering in the legend, which is zero. + +The next two records in this example, LineFormat and AreaFormat, specify the formatting information for the series. (The LineFormat record and AreaFormat record are similar to the LineFormat record and AreaFormat record defined earlier in the example and are omitted for brevity.) + +### Column Chart Object: SerToCrt + +The next record in this example, [SerToCrt](#sertocrt), specifies the chart that contains the series specified in this example. The [ChartFormat](#chartformat) record that specifies this chart is the first ChartFormat record in the [chart sheet subsream](#Section_732ff614d939416bb7c76d983471ff11). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|-----------| +| 0002 | SerToCrt **- SerToCrt** | | +| 0002 | USHORT **- id** | 0x0000 | + +Figure 52: Structure of SerToCrt + +**id:** 0x0000 specifies that the chart that contains the series in this example is specified by the first ChartFormat record in the collection of ChartFormat records in the current chart sheet substream. + +(Records following this record, and before the next [ShtProps](#shtprops) record, are omitted for brevity.) + +### Column Chart Object: ShtProps + +The next record in this example, [ShtProps](#shtprops), specifies the properties of this chart. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------------|-----------| +| 0004 | ShtProps **- ShtProps** | | +| 1 bit | USHORT **- fManSerAlloc** | 0x0 | +| 1 bit | USHORT **- fPlotVisOnly** | 0x1 | +| 1 bit | USHORT **- fNotSizeWith** | 0x0 | +| 1 bit | USHORT **- fManPlotArea** | 0x1 | +| 1 bit | USHORT **- fAlwaysAutoPlotArea** | 0x0 | +| 11 bits | USHORT **- reserved1** | 0x000 | +| 0001 | BYTE **- mdBlank** | 0x00 | +| 0001 | BYTE **- reserved2** | 0x00 | + +Figure 53: Structure of ShtProps + +**fManSerAlloc:** 0x0 specifies that the series is not automatically allocated for this chart. + +**fPlotVisOnly:** 0x1 specifies to plot only [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) cells on this chart. + +**fNotSizeWith:** 0x0 specifies not to size this chart with the window. + +**fAlwaysAutoPlotArea:** 0x0 specifies that the default [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) [**dimension (2)**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) is used for this chart. + +**mdBlank:** 0x00 specifies that empty cells are not plotted on this chart. + +### Column Chart Object: DefaultText + +The next record in this example, [DefaultText](#defaulttext), specifies the text elements that are formatted using the information specified in the [Text](#text) record that follows this record. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------|-----------| +| 0002 | DefaultText **- DefaultText** | | +| 0002 | USHORT **- id** | 0x0002 | + +Figure 54: Structure of DefaultText + +**id:** 0x0002 specifies that the default formatting of all text in the chart that does not use scalable fonts is to be set by the Text record following this record. + +### Column Chart Object: Text + +The next record in this example, [Text](#text), specifies the position and appearance of text fields specified in the preceding [DefaultText](#defaulttext) record. + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------|------------| +| 0020 | Text **- Text** | | +| 0001 | BYTE **- at** | 0x02 | +| 0001 | BYTE **- vat** | 0x02 | +| 0002 | WORD **- wBkgMode** | 0x0001 | +| 0004 | [LongRGB](#longrgb) **- rgbText** | | +| 0001 | BYTE **- red** | 0x00 | +| 0001 | BYTE **- green** | 0x00 | +| 0001 | BYTE **- blue** | 0x00 | +| 0001 | BYTE **- reserved** | 0x00 | +| 0004 | LONG **- x** | 0xFFFFFFD1 | +| 0004 | LONG **- y** | 0xFFFFFFC0 | +| 0004 | LONG **- dx** | 0x00000000 | +| 0004 | LONG **- dy** | 0x00000000 | +| 1 bit | USHORT **- fAutoColor** | 0x1 | +| 1 bit | USHORT **- fShowKey** | 0x0 | +| 1 bit | USHORT **- fShowValue** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fAutoText** | 0x1 | +| 1 bit | USHORT **- fGenerated** | 0x1 | +| 1 bit | USHORT **- fDeleted** | 0x0 | +| 1 bit | USHORT **- fAutoMode** | 0x1 | +| 3 bits | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fShowLabelAndPerc** | 0x0 | +| 1 bit | USHORT **- fShowPercent** | 0x0 | +| 1 bit | USHORT **- fShowBubbleSizes** | 0x0 | +| 1 bit | USHORT **- fShowLabel** | 0x0 | +| 1 bit | USHORT **- reserved** | 0x0 | +| 0002 | [Icv](#icv) **- icvText** | | +| 0002 | USHORT **- icv** | 0x004D | +| 4 bits | USHORT **- dlp** | 0x0 | +| 10 bits | USHORT **- unused3** | 0x317 | +| 2 bits | USHORT **- iReadingOrder** | 0x0 | +| 0002 | USHORT **- trot** | 0x0000 | + +Figure 55: Structure of Text + +The position and size specified by the **x** field, **y** field, **dx** field, and **dy** field is ignored because this record is followed by a [Pos](#pos) record. The **fShowLabelAndPerc** field**, fShowPercent** field**, fShowBubbleSizes** field**, fShowLabel** field, and **dlp** field are ignored because this is a column chart. + +**at:** 0x02 specifies that the horizontal alignment of the text is center-alignment. + +**vat:** 0x02 specifies that the vertical alignment of the text is center-alignment. + +**wBkgMode:** 0x0001 specifies that the background of the text is transparent. + +**rgbText:** Specifies the color of the text. + +**fAutoColor:** 0x0001 specifies that the foreground color is determined automatically. + +**fAutoText:** 0x0001 specifies that the text value of the text field is automatically generated and has not been changed. + +**fGenerated:** 0x0001 specifies that the properties of the text field are automatically generated and was not changed. + +**fAutoMode:** 0x0001 specifies that the background color is determined automatically. + +**icvText:** Specifies a color in the color table. + +**icvText.icv:** 0x004D specifies that the default chart foreground color is used. + +**iReadingOrder:** 0x0000 specifies that the reading order is based on the context. + +**trot:** 0x0000 specifies that the text is not rotated. + +(Records following this record, and before the next [FontX](#fontx) record, are omitted for brevity.) + +### Column Chart Object: FontX + +The next record in this example, [FontX](#fontx), specifies the font used for text of this chart. + +| **Size** | **Structure** | **Value** | +|----------|--------------------|-----------| +| 0002 | FontX **- FontX** | | +| 0002 | USHORT **- iFont** | 0x0005 | + +Figure 56: Structure of FontX + +**iFont:** 0x0005 specifies that the referenced font is the fifth [Font](#font) record in the [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11). + +(Records following this record, and before the next [AxesUsed](#axesused) record, are omitted for brevity.) + +### Column Chart Object: AxesUsed + +The next record in this example, [AxesUsed](#axesused), specifies the number of [axis groups](#Section_578b739742624944b5a67ee6d4d3bb55) on the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|-----------| +| 0002 | AxesUsed **- AxesUsed** | | +| 0002 | USHORT **- cAxes** | 0x0001 | + +Figure 57: Structure of AxesUsed + +**cAxes:** 0x0001 specifies that this chart contains a single primary axis group. + +### Column Chart Object: AxisParent + +The next record in this example, [AxisParent](#axisparent), specifies the properties of an [axis group](#Section_578b739742624944b5a67ee6d4d3bb55) and specifies the beginning of a collection of records as defined by the [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11) that specifies an Axis Group. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0012 | AxisParent **- AxisParent** | | +| 0002 | SHORT **- iax** | 0x0000 | +| 0010 | Unused **- unused** | 5D 00 00 00 81 00 00 00 E6 0E 00 00 10 0D 00 00 | + +Figure 58: Structure of AxisParent + +**iax:** 0x0000 specifies that the Axis Group specified by the records following this record is primary. + +Records following this record, and before the next [Axis](#axis-1) record, are omitted for brevity. + +### Column Chart Object: Axis + +The next record in this example, [Axis](#axis-1), specifies properties of an [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) and specifies the beginning of a collection of records as defined by the [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11) that specifies the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) axis. + +| **Size** | **Structure** | **Value** | +|----------|-----------------------|------------| +| 0012 | Axis **- Axis** | | +| 0002 | WORD **- wType** | 0x0000 | +| 0004 | ULONG **- reserved1** | 0x00000000 | +| 0004 | ULONG **- reserved2** | 0x00000000 | +| 0004 | ULONG **- reserved3** | 0x00000000 | +| 0004 | ULONG **- reserved4** | 0x00000000 | + +Figure 59: Structure of Axis + +**wType:** 0x0000 specifies that the axis type is category axis. + +(Records following this record, and before the next [CatSerRange](#catserrange) record, are omitted for brevity.) + +### Column Chart Object: CatSerRange + +The next record in this example, [CatSerRange](#catserrange), specifies the properties of the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------|-----------| +| 0008 | CatSerRange **- CatSerRange** | | +| 0002 | SHORT **- catCross** | 0x0001 | +| 0002 | SHORT **- catLabel** | 0x0001 | +| 0002 | SHORT **- catMark** | 0x0001 | +| 1 bit | USHORT **- fBetween** | 0x1 | +| 1 bit | USHORT **- fMaxCross** | 0x0 | +| 1 bit | USHORT **- fReverse** | 0x0 | +| 13 bits | USHORT **- reserved** | 0x0000 | + +Figure 60: Structure of CatSerRange + +**catCross:** 0x0001 specifies the category axis is crossed by the value axis at the first category. + +**catLabel:** 0x0001 specifies that the number of categories between [**major tick mark**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) labels is 1. + +**catMark:** 0x0001 specifies that the number of categories between major tick marks is 1. + +**fBetween:** 0x0001 specifies that the value axis crosses the category axis between two major tick marks. + +**fMaxCross:** 0x0000 specifies that the value axis crosses the category axis at the category specified by the **catCross** field. + +**fReverse:** 0x0000 specifies that categories are displayed in order. + +### Column Chart Object: Tick + +The next record in this example, [Tick](#tick), specifies the properties of the [**major tick marks**](#gt_a0f545a5-4d18-4580-903b-8d563f4b65fb) and [**minor tick marks**](#gt_c2eb605a-6c5a-427e-8608-f16940de82a6) associated with the [**category**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) [axis](#Section_4117f73aa0f348d89c0f65864918ffb3). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------|------------| +| 001E | Tick **- Tick** | | +| 0001 | BYTE **- tktMajor** | 0x02 | +| 0001 | BYTE **- tktMinor** | 0x00 | +| 0001 | BYTE **- tlt** | 0x03 | +| 0001 | BYTE **- wBkgMode** | 0x01 | +| 0004 | [LongRGB](#longrgb) **- rgb** | | +| 0001 | BYTE **- red** | 0x00 | +| 0001 | BYTE **- green** | 0x00 | +| 0001 | BYTE **- blue** | 0x00 | +| 0001 | BYTE **- reserved** | 0x00 | +| 0004 | LONG **- reserved1** | 0x00000000 | +| 0004 | LONG **- reserved2** | 0x00000000 | +| 0004 | LONG **- reserved3** | 0x00000000 | +| 0004 | LONG **- reserved4** | 0x00000000 | +| 1 bit | USHORT **- fAutoCo** | 0x1 | +| 1 bit | USHORT **- fAutoMode** | 0x1 | +| 3 bits | USHORT **- rot** | 0x0 | +| 1 bit | USHORT **- fAutoRot** | 0x1 | +| 8 bits | USHORT **- unused** | 0x00 | +| 2 bits | USHORT **- iReadingOrder** | 0x0 | +| 0002 | [IcvChart](#icvchart) **- icv** | | +| 0002 | USHORT **- icv** | 0x004D | +| 0002 | SHORT **- trot** | 0x0000 | + +Figure 61: Structure of Tick + +The **rgb** field is ignored because the **fAUtoCo** field is equal to 0x0001. The **wBkgMode** field is ignored because the **fAutoMode** field is equal to 0x0001. The **rot** field is ignored because the **fAutoRot** field is equal to 0x0001. + +**tktMajor:** 0x02 specifies that the location of the major tick marks is outside, which indicates that the major tick marks are drawn away from the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). + +**tktMinor:** 0x00 specifies that no minor tick marks are present on the axis. + +**tlt:** 0x03 specifies to place axis labels next to the axis. + +**fAutoCo:** 0x0001 specifies that the text uses an automatically selected foreground color, based on the display settings of the computer. + +**fAutoMode:** 0x0001 specifies that the background mode is set according to the [DefaultText](#defaulttext) settings of the chart + +**fAutoRot:** 0x0001 specifies that the text rotation of axis labels is determined automatically. + +**iReadingOrder:** 0x0000 specifies that the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361) of the axis label is determined by the application. + +**icv.icv:** 0x004D specifies that the foreground color is the default chart foreground color. This is the window text color in the chart display. + +**trot:** 0x0000 specifies that the axis label is not rotated. + +(Records following this record, and before the next [ChartFormat](#chartformat) record, are omitted for brevity.) The collection of records includes a collection of record beginning with the [Axis](#axis-1) record that specifies the value axis for this chart. + +### Column Chart Object: ChartFormat + +The next record in this example, [ChartFormat](#chartformat), specifies properties of this [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) and specifies the beginning of a collection of records as defined by the [chart sheet substream](#Section_732ff614d939416bb7c76d983471ff11). The collection of records specifies this chart group. In this example this record is the first ChartFormat record in the collection of ChartFormat records in the current chart sheet substream. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------|------------| +| 0014 | ChartFormat **- ChartFormat** | | +| 0004 | LONG **- Reserved1** | 0x00000000 | +| 0004 | LONG **- Reserved2** | 0x00000000 | +| 0004 | LONG **- Reserved3** | 0x00000000 | +| 0004 | LONG **- Reserved4** | 0x00000000 | +| 1 bit | WORD **- fVaried** | 0x0 | +| 15 bits | WORD **- Reserved5** | 0x0000 | +| 0002 | SHORT **- icrt** | 0x0000 | + +Figure 62: Structure of ChartFormat + +**fVaried:** 0x0000 specifies that the color of each data point does not vary. + +**icrt:** 0x0000 specifies that this chart group is at the bottom of the [**z-order**](#gt_5d059b23-337a-4ab8-82f5-e3789b2e7ae9). + +### Column Chart Object: Bar + +The next record in this example, [Bar](#bar), specifies the attributes of this [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|-----------| +| 0006 | Bar **- Bar** | | +| 0002 | SHORT **- pcOverlap** | 0x0000 | +| 0002 | USHORT **- pcGap** | 0x0096 | +| 1 bit | USHORT **- fTranspose** | 0x0 | +| 1 bit | USHORT **- fStacked** | 0x0 | +| 1 bit | USHORT **- f100** | 0x0 | +| 1 bit | USHORT **- fHasShadow** | 0x0 | +| 12 bits | USHORT **- reserved** | 0x000 | + +Figure 63: Structure of Bar + +**pcOverlap:** 0x0000 specifies that there is no overlap between data points. + +**pcGap:** 0x0096 specifies that the width of the gap between adjacent [**categories**](#gt_7d6acf13-ba4d-4a0a-930e-3eaee465c7f1) is 150% of the data point width. It also specifies that the width of the gap between the categories and the left and right edges of the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) is 75% of the data point width. + +**fTranspose:** 0x0000 specifies that the data points and the value [axis](#Section_4117f73aa0f348d89c0f65864918ffb3) are vertical. + +**fStacked:** 0x0000 specifies that [data points](#Section_9c986ad250d44fa1a157063ac5c971a0) in the same chart group are not stacked. + +**f100:** 0x0000 specifies that data points in the chart group are not displayed as a percentage of the sum of all data points in the chart group that share the same category. + +**fHasShadow:** 0x0000 specifies that none of the data points in the chart group has shadows. + +The remaining records following this record, are omitted for brevity. + +## Pie Chart Sheet + +This is an example of a 2D Pie [Chart Sheet](#Section_2c90d75bc92645aa8ff29d4483f51831). This example omits records previously covered in the [column chart object](#Section_f9e4245bb7b145a98f80c78edac371d4) example. + +![Pie Chart Sheet in this example within a sheet.](media/image89.bin "Pie Chart Sheet in this example within a sheet.") + +Figure 64: Pie Chart Sheet in this example within a sheet. + +### Pie Chart Sheet: PrintSize + +The first record in this example, [PrintSize](#printsize), specifies the printed size of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------|-----------| +| 0002 | PrintSize **- PrintSize** | | +| 0002 | WORD **- printSize** | 0x0003 | + +Figure 65: Structure of PrintSize + +**printSize:** 0x0003 specifies that the printed size of the chart is defined in the [Chart](#chart-2) record that follows this record. + +### Pie Chart Sheet: Chart + +The next record in this example, [Chart](#chart-2), specifies the beginning of the collection of records for the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c), and specifies the position and size of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)). + +| **Size** | **Structure** | **Value** | +|----------|---------------------|------------| +| 0010 | Chart **- Chart** | | +| 0004 | FixedPoint **- x** | 0x00000000 | +| 0004 | FixedPoint **- y** | 0x00000000 | +| 0004 | FixedPoint **- dx** | 0x02AB0A30 | +| 0004 | FixedPoint **- dy** | 0x01D30A30 | + +Figure 66: Structure of Chart + +**x:** 0x00000000 specifies that the horizontal position of the upper-left corner of the chart is 0 [**points**](#gt_d072e4da-7898-4227-8f25-9fe77db43571). + +**y:** 0x00000000 specifies that the vertical position of the upper-left corner of the chart is 0 points. + +**dx:** 0x02AB0A30 specifies that the chart is 44763696 points wide. + +**dy:** 0x01D30A30 specifies that the chart is 30607920 points high. + +### Pie Chart Sheet: ShtProps + +The next record in this example, [ShtProps](#shtprops), specifies the [chart sheet](#Section_2c90d75bc92645aa8ff29d4483f51831) properties. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------------|-----------| +| 0004 | ShtProps **- ShtProps** | | +| 1 bit | USHORT **- fManSerAlloc** | 0x0 | +| 1 bit | USHORT **- fPlotVisOnly** | 0x1 | +| 1 bit | USHORT **- fNotSizeWith** | 0x1 | +| 1 bit | USHORT **- fManPlotArea** | 0x1 | +| 1 bit | USHORT **- fAlwaysAutoPlotArea** | 0x0 | +| 11 bits | USHORT **- reserved1** | 0x000 | +| 0001 | BYTE **- mdBlank** | 0x00 | +| 0001 | BYTE **- reserved2** | 0x00 | + +Figure 67: Structure of ShtProps + +**fManSerAlloc:** 0x0 specifies that the data [series](#Section_527ce4dfc9f84e50a314d4b07519593c) are not automatically allocated to the series of the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +**fPlotVisOnly:** 0x1 specifies to plot [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) only. + +**fNotSizeWith:** 0x1 specifies not to size the chart with the window. + +**fManPlotArea:** This field is ignored because the **fAlwaysAutoPlotArea** value is 0x0. + +**fAlwaysAutoPlotArea:** 0x0 specifies that the default [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c) size is used regardless of the [Pos](#pos) record information. + +**mdBlank:** 0x00 specifies that empty cells are not plotted. + +### Pie Chart Sheet: AxesUsed + +The next record in this example, [AxesUsed](#axesused), specifies the value [axes](#Section_4117f73aa0f348d89c0f65864918ffb3) used on the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|-----------| +| 0002 | AxesUsed **- AxesUsed** | | +| 0002 | USHORT **- cAxes** | 0x0001 | + +Figure 68: Structure of AxesUsed + +**cAxes:** 0x0001 specifies that a single primary value axis is present and used on the chart. + +### Pie Chart Sheet: AxisParent + +The next record in this example, [AxisParent](#axisparent), specifies properties of the one [axis group](#Section_578b739742624944b5a67ee6d4d3bb55) on the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c) and specifies the beginning of the collection of records that specifies an axis group. + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------|-----------| +| 0012 | AxisParent **- AxisParent** | | +| 0002 | SHORT **- iax** | 0x0000 | +| 0010 | unused **- unused** | | + +Figure 69: Structure of AxisParent + +**iax:** 0x0000 specifies that this axis group is a primary axis group. + +### Pie Chart Sheet: ChartFormat + +The next record, [ChartFormat](#chartformat), specifies properties of a [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5) and specifies the beginning of the collection of records that specifies further properties of that chart group. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------|------------| +| 0014 | ChartFormat **- ChartFormat** | | +| 0004 | LONG **- reserved1** | 0x00000000 | +| 0004 | LONG **- reserved2** | 0x00000000 | +| 0004 | LONG **- reserved3** | 0x00000000 | +| 0004 | LONG **- reserved4** | 0x00000000 | +| 1 bit | WORD **- fVaried** | 0x1 | +| 15 bits | WORD **- reserved5** | 0x0000 | +| 0002 | SHORT **- icrt** | 0x0000 | + +Figure 70: Structure of ChartFormat + +**fVaried:** 0x0001 specifies that the color for each [data point](#Section_9c986ad250d44fa1a157063ac5c971a0), or the color or type for each [**data marker**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) varies. + +**icrt:** 0x0000 specifies that the drawing order of the chart group relative to the other chart groups is the bottom of the [**z-order**](#gt_5d059b23-337a-4ab8-82f5-e3789b2e7ae9). + +### Pie Chart Sheet: Pie + +The next record in this example, [Pie](#pie), specifies that this is a pie [chart group](#Section_c91fdf3195e2495fa48a5546ce20c0c5), and specifies attributes of the chart group. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------|-----------| +| 0006 | Pie **- Pie** | | +| 0002 | USHORT **- anStart** | 0x0000 | +| 0002 | USHORT **- pcDonut** | 0x0000 | +| 1 bit | USHORT **- fHasShadow** | 0x0 | +| 1 bit | USHORT **- fShowLdrLines** | 0x1 | +| 14 bits | USHORT **- reserved** | 0x0000 | + +Figure 71: Structure of Pie + +**anStart:** 0x0000 specifies that the starting angle, calculated clockwise from the top of the circle, of the first [data point](#Section_9c986ad250d44fa1a157063ac5c971a0) is 0 degrees. + +**pcDonut:** 0x0000 specifies that the chart group is a pie chart group. + +**fHasShadow:** 0x0 specifies that zero data points in the chart group have shadows. + +**fShowLdrLines:** 0x1 specifies that the [**leader lines**](#gt_8b7c448e-82e3-4d22-a8ba-52e0a10b14fa) to the [data labels](#Section_cac7f43a3af142f58ff2814c2870427f) are shown. This value is ignored because zero data labels are present in this example. + +### Pie Chart Sheet: Legend + +The next record in this example, [Legend](#legend-1), specifies the location of the [legend](#Section_1832229b7d1945f488d455e9c07466f0) on the display and its overall size. The displayed legend contains all the [series](#Section_527ce4dfc9f84e50a314d4b07519593c) on the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). The position and size information specified in this record is ignored, and the position and size information specified in the following [Pos](#pos) record is used. + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|------------| +| 0014 | Legend **- Legend** | | +| 0004 | ULONG **- x** | 0x00000E47 | +| 0004 | ULONG **- y** | 0x00000703 | +| 0004 | ULONG **- dx** | 0x00000147 | +| 0004 | ULONG **- dy** | 0x00000199 | +| 0001 | BYTE **- unused** | 0x03 | +| 0001 | BYTE **- wSpace** | 0x01 | +| 1 bit | WORD **- fAutoPosition** | 0x1 | +| 1 bit | WORD **- reserved1** | 0x1 | +| 1 bit | WORD **- fAutoPosX** | 0x1 | +| 1 bit | WORD **- fAutoPosY** | 0x1 | +| 1 bit | WORD **- fVert** | 0x1 | +| 1 bit | WORD **- fWasDataTable** | 0x0 | +| 10 bits | WORD **- reserved2** | 0x000 | + +Figure 72: Structure of Legend + +**wSpace:** 0x01 specifies that there are 40 [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382) between [**legend entries**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e). + +**fAutoPosition:** 0x1 specifies that the legend is automatically positioned. + +**fAutoPosX:** 0x1 specifies that the x-positioning of the legend is automatic. + +**fAutoPosY:** 0x1 specifies that the y-positioning of the legend is automatic. + +**fVert:** 0x1 specifies that the layout of the legend entries contain a single column of entries. + +**fWasDataTable:** 0x0 specifies that the chart is not displaying the chart [data table](#Section_69938f61d2e94da3af87e154edcb0d98). + +The next record in this example, [Begin](#begin), specifies the beginning of the collection of records that specifies the properties of the legend. + +The details of the Begin record have been omitted from the example for brevity. + +### Pie Chart Sheet: Pos + +The next record in this example, [Pos](#pos), specifies the size and position for the [Legend](#legend-1) of the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------------|-----------| +| 0014 | Pos **- Pos** | | +| 0002 | [PositionMode](#positionmode) **- mdTopLt** | 0x0005 | +| 0002 | PositionMode **- mdBotRt** | 0x0002 | +| 0002 | SHORT **- x1** | 0x0E47 | +| 0002 | SHORT **- unused1** | 0x0000 | +| 0002 | SHORT **- y1** | 0x0703 | +| 0002 | SHORT **- unused2** | 0x0000 | +| 0002 | SHORT **- x2** | 0x0000 | +| 0002 | SHORT **- unused3** | 0x0000 | +| 0002 | SHORT **- y2** | 0x0000 | +| 0002 | SHORT **- unused4** | 0x0000 | + +Figure 73: Structure of Pos + +Fields in this record that are ignored because **mdTopLt** is 0x0005 and **mdBotRt** is 0x0002 are omitted for brevity. + +**mdTopLt:** 0x0005 specifies that the horizontal offset of the upper-left corner for this Legend is relative to the upper-left corner of the [**chart area**](#gt_5524dd6c-3d8d-4784-bfca-a3323acceb39) (section [2.2.3.17](#Section_73c3fa9c39be46f6bbf32ee5977a2d7d)), measured in [SPRC](#Section_d5fc728e68de4972905a975bcef8c82d). + +**mdBotRt:** 0x0002, when combined with the **mdTopLt** value of 0x0005, specifies that the values of **x1** and **y1** specify the horizontal and vertical offsets of the upper-left corner of the Legend, relative to the upper-left corner of the chart area (section 2.2.3.17). + +**x1:** 0x0E47 specifies that the upper-left corner of the Legend is horizontally offset by 3655 SPRC from the upper-left corner of the chart area (section 2.2.3.17). + +**y1:** 0x0703 specifies that the upper-left corner of the Legend is vertically offset by 1795 SPRC from the upper-left corner of the chart area (section 2.2.3.17). + +### Pie Chart Sheet: Text + +The next record in this example, [Text](#text), specifies the position and appearance of text fields that appear on the [chart](#Section_f9430fdccd0f40dd93243bdf4ce7cc4c). The position and size information specified in this record are ignored because this record is followed by a [Pos](#pos) record. + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------|------------| +| 0020 | Text **- Text** | | +| 0001 | BYTE **- at** | 0x02 | +| 0001 | BYTE **- vat** | 0x02 | +| 0002 | WORD **- wBkgMode** | 0x0001 | +| 0004 | [LongRGB](#longrgb) **- rgbText** | | +| 0001 | BYTE **- red** | 0x00 | +| 0001 | BYTE **- green** | 0x00 | +| 0001 | BYTE **- blue** | 0x00 | +| 0001 | BYTE **- reserved** | 0x00 | +| 0004 | LONG **- x** | 0xFFFFFFEA | +| 0004 | LONG **- y** | 0xFFFFFF75 | +| 0004 | LONG **- dx** | 0x00000000 | +| 0004 | LONG **- dy** | 0x00000000 | +| 1 bit | USHORT **- fAutoColor** | 0x1 | +| 1 bit | USHORT **- fShowKey** | 0x0 | +| 1 bit | USHORT **- fShowValue** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fAutoText** | 0x1 | +| 1 bit | USHORT **- fGenerated** | 0x1 | +| 1 bit | USHORT **- fDeleted** | 0x0 | +| 1 bit | USHORT **- fAutoMode** | 0x1 | +| 3 bits | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fShowLabelAndPerc** | 0x0 | +| 1 bit | USHORT **- fShowPercent** | 0x0 | +| 1 bit | USHORT **- fShowBubbleSizes** | 0x0 | +| 1 bit | USHORT **- fShowLabel** | 0x0 | +| 1 bit | USHORT **- reserved** | 0x0 | +| 0002 | [Icv](#icv) **- icvText** | | +| 0002 | USHORT **- icv** | 0x004D | +| 4 bits | USHORT **- dlp** | 0x0 | +| 10 bits | USHORT **- unused3** | 0x069 | +| 2 bits | USHORT **- iReadingOrder** | 0x0 | +| 0002 | USHORT **- trot** | 0x0000 | + +Figure 74: Structure of Text + +**at:** 0x02 specifies that the horizontal alignment of the text fields that appear in the [Legend](#legend-1) record is center-aligned. + +**vat:** 0x02 specifies that the vertical alignment of the text fields that appear in the Legend record is center-aligned. + +**wBkgMode:** 0x0001 specifies that the background of the text is transparent. + +**rgbText:** A LongRGB structure that specifies the color of the text. + +**rgbText.red:** 0x00 specifies that the relative intensity of red is 0. + +**rgbText.green:** 0x00 specifies that the relative intensity of green is 0. + +**rgbText.blue:** 0x00 specifies that the relative intensity of blue is 0. + +**fAutoColor:** 0x0001 specifies that the foreground text color is determined automatically. + +**fShowKey:** This field is ignored because this [AttachedLabel](#Section_9ac44e58af9940f4a99ace470eff0f5a) is not a [data label](#Section_cac7f43a3af142f58ff2814c2870427f). + +**fShowValue:** This field is ignored because this AttachedLabel is not a data label. + +**fAutoText:** 0x0001 specifies that the text value of the text field is automatically generated and has not been changed. + +**fGenerated:** 0x0001 specifies that the properties of the text field are automatically generated and have not been changed. + +**fDeleted:** 0x0000 specifies that this text field, which is displayed by default, has been deleted by the user. + +**fAutoMode:** 0x0001 specifies that the background color is determined automatically. + +**fShowLabelAndPerc:** This field is ignored because this AttachedLabel is not a data label. + +**fShowPercent:** This field is ignored because this AttachedLabel is not a data label. + +**fShowBubbleSizes:** This field is ignored because this AttachedLabel is not a data label. + +**fShowLabel:** This field is ignored because this AttachedLabel is not a data label. + +**icvText:** An Icv structure that specifies the color of the text. + +**icvText.icv:** 0x004D specifies that the default chart foreground color is used. + +**dlp:** This field is ignored because this AttachedLabel is not a data label. + +**iReadingOrder:** 0x0000 specifies that the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361) of the text is determined by the application. + +**trot:** This field is ignored because this AttachedLabel is not a data label. + +The next record in this example, [Begin](#begin), specifies the beginning of the collection of records that specifies data labels on a [**graph object**](#gt_f4c97882-38e3-4b03-9f11-09ee6566da21). + +The details of the Begin record have been omitted from the example for brevity. + +### Pie Chart Sheet: BRAI + +The next record in this example, [BRAI](#brai), specifies a reference to data in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that is used by a [**legend entry**](#gt_6c27eb24-fb59-4bc8-8962-9cdac46a748e). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------------------------|-----------| +| 0008 | BRAI **- BRAI** | | +| 0001 | BYTE **- id** | 0x00 | +| 0001 | BYTE **- rt** | 0x01 | +| 1 bit | USHORT **- fUnlinkedIfmt** | 0x0 | +| 15 bits | USHORT **- reserved** | 0x0000 | +| 0002 | IFmt **- ifmt** | 0x0000 | +| 0002 | [ChartParsedFormula](#chartparsedformula) **- formula** | | +| 0002 | WORD **- cce** | 0x0000 | + +Figure 75: Structure of BRAI + +**id:** 0x00 specifies that the referenced data is used for the text of a legend entry. + +**rt:** 0x01 specifies that the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is text or the value contained by the **rgce** field. + +**fUnlinkedIfmt:** 0x0 specifies that the data uses the same number formatting as the referenced data. + +**ifmt:** 0x0000 specifies that the identifier for [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) information is general (automatic). + +**formula:** A ChartParsedFormula that specifies the formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) that specifies the referenced data. + +**formula.cce:** 0x0000 specifies that the length of **rgce** is 0 bytes. + +The next two records in this example are both [End](#end) records. The first End record specifies the end of the collection of records that specifies [data labels](#Section_cac7f43a3af142f58ff2814c2870427f) on a [**graph object**](#gt_f4c97882-38e3-4b03-9f11-09ee6566da21). The second End record specifies the end of the collection of records that specifies the [legend](#Section_1832229b7d1945f488d455e9c07466f0). + +The details of the End records have been omitted from the example for brevity. + +### Pie Chart Sheet: Window2 + +The next record in this example, [Window2](#window2), specifies attributes of the window used to display a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------|-----------| +| 000A | WINDOW2 **- Window2** | | +| 1 bit | USHORT **- fDspFmlaRt** | 0x0 | +| 1 bit | USHORT **- fDspGridRt** | 0x1 | +| 1 bit | USHORT **- fDspRwColRt** | 0x0 | +| 1 bit | USHORT **- fFrozenRt** | 0x0 | +| 1 bit | USHORT **- fDspZerosRt** | 0x0 | +| 1 bit | USHORT **- fDefaultHdr** | 0x0 | +| 1 bit | USHORT **- fRightToLeft** | 0x0 | +| 1 bit | USHORT **- fDspGuts** | 0x0 | +| 1 bit | USHORT **- fFrozenNoSplit** | 0x0 | +| 1 bit | USHORT **- fSelected** | 0x1 | +| 1 bit | USHORT **- fPaged** | 0x1 | +| 1 bit | USHORT **- fSLV** | 0x0 | +| 4 bits | USHORT **- reserved1** | 0x0 | +| 0002 | [RwU](#rwu) **- rwTop** | 0x0000 | +| 0002 | [ColU](#colu) **- colLeft** | 0x0000 | +| 0002 | [Icv](#icv) **- icvHdr** | 0x0000 | +| 0002 | USHORT **- reserved2** | 0x0000 | + +Figure 76: Structure of Window2 + +Fields in this record that are ignored because this Window2 record is contained in a [chart sheet](#Section_2c90d75bc92645aa8ff29d4483f51831) substream are omitted for brevity. + +**fSelected:** 0x1 specifies that the sheet tab of the chart sheet is selected. + +## Formatting + +In this example, [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) formatting and [**number formats**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) are applied to three cells in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d): + +Cell B3, containing 1.2345, is formatted with the built-in "0.00" number format. + +Cell B4, containing 1.2345, is formatted with the custom number format "0.00000". + +Cell B5, containing "1.2345", is formatted with a blue [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a), yellow [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c), and is bold. + +The following screenshot shows a possible implementation of the cells discussed in this example: + +![The formatting in this example within a sheet](media/image90.bin "The formatting in this example within a sheet") + +Figure 77: The formatting in this example within a sheet + +This example starts at the first [Font](#font) record in the [Workbook stream](#Section_f682f4b08c6b444e83f852d156f1e8ba) related to these cells and ends at the [Number](#number) record containing the value for the last cell. Other records in the Workbook stream or related substreams which are not related to this example are omitted for brevity. The substream of the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) related to this example contains five Font records, nine [Format](#format) records, 24 [XF](#xf) records, and three Number records. Of these, the example highlights the first and fifth Font record, the last Format record, the first, sixteenth, seventeenth, and eighteenth XF records, and all three Number records. Any other records in the substream are skipped in this example. + +Each Number record that specifies a cell with a [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d) corresponds to one of the three cells in this example. The Number record contains a [Cell](#cell) structure, which in turn contains an [IXFCell](#ixfcell) structure with an **ixfe** field containing the index to an XF record in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). The XF record that specifies formatting properties for a cell contains a [FontIndex](#fontindex) structure and an [IFmt](#ifmt) structure. Those records contain indexes for a Font record and a Format record, respectively. The Font record specifies [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) and font formatting information, and the Format record specifies a number format. + +### Formatting: Font 1 + +The first record in the example, [Font](#font), specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) and font formatting information which is used by [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) B3 and B4. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001A | Font **- Font** | | +| 0002 | USHORT **- dyHeight** | 0x00C8 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fItalic** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fStrikeOut** | 0x0 | +| 1 bit | USHORT **- fOutline** | 0x0 | +| 1 bit | USHORT **- fShadow** | 0x0 | +| 1 bit | USHORT **- fCondense** | 0x0 | +| 1 bit | USHORT **- fExtend** | 0x0 | +| 8 bits | USHORT **- reserved** | 0x00 | +| 0002 | USHORT **- icv** | 0x7FFF | +| 0002 | USHORT **- bls** | 0x0190 | +| 0002 | USHORT **- sss** | 0x0000 | +| 0001 | BYTE **- uls** | 0x00 | +| 0001 | BYTE **- bFamily** | 0x00 | +| 0001 | BYTE **- bCharSet** | 0x00 | +| 0001 | BYTE **- unused3** | 0xDF | +| 000C | [ShortXLUnicodeString](#shortxlunicodestring) **- fontName** | Arial | + +Figure 78: Structure of Font + +**dyHeight:** 0x00C8 specifies the height of the font is 200 [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382). + +**fItalic:** 0x0 specifies that the font is not italicized. + +**fStrikeOut:** 0x0 specifies that the font does not have [**strikethrough formatting**](#gt_b16d9600-aebb-4a4f-bf14-c38e13c11c14) applied. + +**fOutline:** 0x0 specifies that the font is not an outline. + +**fShadow:** 0x0 specifies that the font does not have a shadow applied. + +**fCondense:** 0x0 specifies that the font is not condensed by compressing spacing between characters. + +**fExtend:** 0x0 specifies that the font is not extended by stretching spacing between characters. + +**icv:** 0x7FFF is an [Icv](#icv) value that specifies that the color of the font is the default [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a). + +**bls:** 0x0190 specifies that the font is normal weight. + +**sss:** 0x0000 specifies that the font is normal script. + +**uls:** 0x00 specifies that the font has no underline. + +**bFamily:** 0x00 specifies that the [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2) of the font is not applicable as detailed in the Windows API LOGFONT structure in [\[MSDN-FONTS\]](https://go.microsoft.com/fwlink/?LinkId=90008). + +**bCharSet:** 0x00 specifies that that this font belongs to the [**ANSI character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583). + +**fontName:** Arial specifies the name of the font. + +Records following this record, and before the fifth Font record, are omitted for brevity. + +### Formatting: Font 2 + +The next record in this example, [Font](#font), specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) and font formatting information which is used by [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) B5. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001A | Font **- Font** | | +| 0002 | USHORT **- dyHeight** | 0x00C8 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fItalic** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fStrikeOut** | 0x0 | +| 1 bit | USHORT **- fOutline** | 0x0 | +| 1 bit | USHORT **- fShadow** | 0x0 | +| 1 bit | USHORT **- fCondense** | 0x0 | +| 1 bit | USHORT **- fExtend** | 0x0 | +| 8 bits | USHORT **- reserved** | 0x00 | +| 0002 | USHORT **- icv** | 0x000C | +| 0002 | USHORT **- bls** | 0x02BC | +| 0002 | USHORT **- sss** | 0x0000 | +| 0001 | BYTE **- uls** | 0x00 | +| 0001 | BYTE **- bFamily** | 0x00 | +| 0001 | BYTE **- bCharSet** | 0x00 | +| 0001 | BYTE **- unused3** | 0xDF | +| 000C | [ShortXLUnicodeString](#shortxlunicodestring) **- fontName** | Arial | + +Figure 79: Structure of Font + +Fields in this record that are explained in previous records in this example have been omitted for brevity. + +**icv:** 0x000C is an [Icv](#icv) value that specifies that the color of the font is composed of an RGB value with a red value of 0, a green value of 0, and a blue value of 255, representing the color blue. + +**bls:** 0x02BC specifies that the font is bold. + +Records following this record, and before the ninth [Format](#format) record, are omitted for brevity. + +### Formatting: Format + +The next record in this example, [Format](#format), specifies the number format which is used by [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) B4. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------------------------------|-----------| +| 000C | Format **- Format** | | +| 0002 | [IFmt](#ifmt) **- ifmt** | 0x00A4 | +| 000A | [XLUnicodeString](#xlunicodestring) **- stFormat** | 0.00000 | + +Figure 80: Structure of Format + +**ifmt:** 0x00A4 specifies the identifier of the format string. + +**stFormat:** "0.00000" specifies the custom [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) string to be applied. + +### Formatting: XF 1 + +The next record in this example, [XF](#xf), specifies default formatting properties for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and is written out. It is not referenced in this example. + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------------------------|-----------| +| 0014 | XF **- XF** | | +| 0002 | FontIndex **- ifnt** | | +| 0002 | USHORT **- ifnt** | 0x0000 | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x0000 | +| 1 bit | USHORT **- fLocked** | 0x1 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fStyle** | 0x1 | +| 1 bit | USHORT **- f123Prefix** | 0x0 | +| 12 bits | USHORT **- ixfParent** | 0xFFF | +| 000E | [StyleXF](#stylexf) **- Data** | | +| 3 bits | BYTE **- alc** | 0x0 | +| 1 bit | BYTE **- fWrap** | 0x0 | +| 3 bits | BYTE **- alcV** | 0x2 | +| 1 bit | BYTE **- fJustLast** | 0x0 | +| 0001 | [XFPropTextRotation](#xfproptextrotation) **- trot** | | +| 0001 | BYTE **- trot** | 0x00 | +| 4 bits | BYTE **- cIndent** | 0x0 | +| 1 bit | BYTE **- fShrinkToFit** | 0x0 | +| 1 bit | BYTE **- reserved1** | 0x0 | +| 2 bits | BYTE **- iReadOrder** | 0x0 | +| 0001 | BYTE **- unused** | 0x00 | +| 4 bits | USHORT **- dgLeft** | 0x0 | +| 4 bits | USHORT **- dgRight** | 0x0 | +| 4 bits | USHORT **- dgTop** | 0x0 | +| 4 bits | USHORT **- dgBottom** | 0x0 | +| 7 bits | USHORT **- icvLeft** | 0x00 | +| 7 bits | USHORT **- icvRight** | 0x00 | +| 2 bits | USHORT **- grbitDiag** | 0x0 | +| 7 bits | ULONG **- icvTop** | 0x00 | +| 7 bits | ULONG **- icvBottom** | 0x00 | +| 7 bits | ULONG **- icvDiag** | 0x00 | +| 4 bits | ULONG **- dgDiag** | 0x0 | +| 1 bit | ULONG **- reserved2** | 0x0 | +| 6 bits | ULONG **- fls** | 0x00 | +| 7 bits | USHORT **- icvFore** | 0x40 | +| 7 bits | USHORT **- icvBack** | 0x41 | +| 2 bits | USHORT **- reserved3** | 0x0 | + +Figure 81: Structure of XF + +**ifnt:** Specifies formatting properties for the cell. + +**ifnt.ifnt:** 0x0000 specifies the [FontIndex](#fontindex) that specifies the cell uses the default [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). + +**ifmt:** Specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) and text formatting for the cell. + +**ifmt.ifmt:** 0x0000 specifies an IFmt that specifies general (automatic) formatting for the cell. + +**fLocked:** 0x1 specifies that the cell is set to be [**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81) for user editing when the worksheet is [**protected**](#gt_edd09e04-ab93-4769-ae34-2cad606fa829). + +**fHidden:** 0x0 specifies that the cell formula is not [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) when the worksheet is protected. + +**fStyle:** 0x1 specifies that this record specifies a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7). + +**f123Prefix:** 0x0 specifies that the text in the cell is not prefixed by a single quote mark. + +**ixfParent:** 0xFFF is the required value as **fStyle** is 0x1. + +**Data:** Specifies additional properties of this cell style. + +**Data.alc:** 0x0 specifies that the horizontal alignment of the cell is [**general alignment**](#gt_3ee6d1d4-830b-4dc2-b8be-751665f8045f). + +**Data.fWrap:** 0x0 specifies that the cell text is not line-wrapped within the cell. + +**Data.alcV:** 0x2 specifies that the cell has a bottom [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878). + +**Data.fJustLast:** 0x0 specifies that the cell text is not [**justify distributed**](#gt_11eced66-af2c-4391-8b45-87a60ad41483). + +**Data.trot:** Specifies the text rotation. + +**Data.trot.trot:** 0x00 specifies that the cell text is rotated counterclockwise 0 degrees. + +**Data.cIndent:** 0x0 specifies that the cell text is not indented. + +**Data.fShrinkToFit:** 0x0 specifies that the cell is not [**shrink to fit**](#gt_4740d2ef-00d3-4a29-983c-b7b3a6aa01e0). + +**Data.iReadOrder:** 0x0 specifies that the [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361) of the cell is context reading order. + +**Data.dgLeft:** 0x0 specifies that the [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) [**border formatting**](#gt_96ac39c1-e3ee-4485-b481-0553e5606cad) of the cell is no [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c). + +**Data.dgRight:** 0x0 specifies that the [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) border formatting of the cell is no border. + +**Data.dgTop:** 0x0 specifies that the top border formatting of the cell is no border. + +**Data.dgBottom:** 0x0 specifies that the bottom border formatting of the cell is no border. + +**Data.icvLeft:** 0x00 specifies that the color of the logical left border is not specified. + +**Data.icvRight:** 0x00 specifies that the color of the logical right border is not specified. + +**Data.grbitDiag:** 0x0 specifies that the cell does not have a diagonal border. + +**Data.icvTop:** 0x00 specifies that the color of the top border is not specified. + +**Data.icvBottom:** 0x00 specifies that the color of the bottom border is not specified. + +**Data.icvDiag:** 0x00 specifies that the color of the diagonal border is not specified. + +**Data.dgDiag:** 0x0 specifies that the diagonal border formatting of the cell is no border. + +**Data.fls:** 0x00 specifies that there is no [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e) for the cell. + +**Data.icvFore:** 0x40 specifies that the [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) of the fill pattern is the default foreground color. + +**Data.icvBack:** 0x41 specifies that the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) of the fill pattern is the default background color. + +Records following this record, and before the sixteenth XF record, are omitted for brevity. + +### Formatting: XF 2 + +The next record in this example, [XF](#xf), specifies formatting properties for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and is referenced by the [Number](#number) record for cell B3. + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------------------------|-----------| +| 0014 | XF **- XF** | | +| 0002 | FontIndex **- ifnt** | | +| 0002 | USHORT **- ifnt** | 0x0000 | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x0002 | +| 1 bit | USHORT **- fLocked** | 0x1 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fStyle** | 0x0 | +| 1 bit | USHORT **- f123Prefix** | 0x0 | +| 12 bits | USHORT **- ixfParent** | 0x000 | +| 000E | [CellXF](#cellxf) **- Data** | | +| 3 bits | BYTE **- alc** | 0x0 | +| 1 bit | BYTE **- fWrap** | 0x0 | +| 3 bits | BYTE **- alcV** | 0x2 | +| 1 bit | BYTE **- fJustLast** | 0x0 | +| 0001 | [XFPropTextRotation](#xfproptextrotation) **- trot** | | +| 0001 | BYTE **- trot** | 0x00 | +| 4 bits | BYTE **- cIndent** | 0x0 | +| 1 bit | BYTE **- fShrinkToFit** | 0x0 | +| 1 bit | BYTE **- reserved1** | 0x0 | +| 2 bits | BYTE **- iReadOrder** | 0x0 | +| 2 bits | BYTE **- reserved2** | 0x0 | +| 1 bit | BYTE **- fAtrNum** | 0x1 | +| 1 bit | BYTE **- fAtrFnt** | 0x0 | +| 1 bit | BYTE **- fAtrAlc** | 0x0 | +| 1 bit | BYTE **- fAtrBdr** | 0x0 | +| 1 bit | BYTE **- fAtrPat** | 0x0 | +| 1 bit | BYTE **- fAtrProt** | 0x0 | +| 4 bits | USHORT **- dgLeft** | 0x0 | +| 4 bits | USHORT **- dgRight** | 0x0 | +| 4 bits | USHORT **- dgTop** | 0x0 | +| 4 bits | USHORT **- dgBottom** | 0x0 | +| 7 bits | USHORT **- icvLeft** | 0x00 | +| 7 bits | USHORT **- ivcRight** | 0x00 | +| 2 bits | USHORT **- grbitDiag** | 0x0 | +| 7 bits | ULONG **- icvTop** | 0x00 | +| 7 bits | ULONG **- icvBottom** | 0x00 | +| 7 bits | ULONG **- icvDiag** | 0x00 | +| 4 bits | ULONG **- dgDiag** | 0x0 | +| 1 bit | ULONG **- fHasXFExt** | 0x0 | +| 6 bits | ULONG **- fls** | 0x00 | +| 7 bits | USHORT **- icvFore** | 0x40 | +| 7 bits | USHORT **- icvBack** | 0x41 | +| 1 bit | USHORT **- fsxButton** | 0x0 | +| 1 bit | USHORT **- reserved3** | 0x0 | + +Figure 82: Structure of XF + +Fields in this record that are explained in previous records in this example have been omitted for brevity. + +**ifmt:** Specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) and text formatting for the cell. + +**ifmt.ifmt:** 0x0002 specifies an IFmt value that specifies a number format with two decimals and no 1000s comma. + +**fStyle:** 0x0 specifies that the cell uses a cell format. + +**ixfParent:** 0x000 specifies that the cell inherits formatting properties from the first [cell style XF](#Section_3d5348ded9df4c31b1fd9f9377273152) record in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +**Data:** Specifies additional properties of the cell format. + +**Data.fAtrNum:** 0x1 specifies that the **ifmt** field of this XF record is not updated when the corresponding field of the XF record specified by the **ixfParent** field of this XF record is changed. + +**Data.fAtrFnt:** 0x0 specifies that the **ifnt** field of this XF record is updated when the corresponding field of the XF record specified by the **ixfParent** field of this XF record is changed. + +**Data.fAtrAlc:** 0x0 specifies that the **alc**, **fWrap**, **alcV**, **fJustLast**, **trot**, **cIndent**, **fShrinkToFit**, and **iReadOrder** fields are updated when the corresponding fields of the XF record specified by the **ixfParent** field of this XF record are changed. + +**Data.fAtrBdr:** 0x0 specifies that the **dgLeft**, **dgRight**, **dgTop**, **dgBottom**, **dgDiag**, **icvLeft**, **icvRight**, **grbitDiag**, **icvTop**, **icvBottom**, and **icvDiag** fields are updated when the corresponding fields of the XF record specified by the **ixfParent** field of this XF record are changed. + +**Data.fAtrPat:** 0x0 specifies that the **fls**, **icvFore**, and **icvBack** fields are updated when the corresponding fields of the XF record specified by the **ixfParent** field of this XF record are changed. + +**Data.fAtrProt:** 0x0 specifies that the **fLocked** and **fHidden** fields are updated when the corresponding fields of the XF record specified by the **ixfParent** field of this XF record are changed. + +**Data.fHasXFExt:** 0x0 specifies that the information in this XF will not be extended by an [XFExt](#xfext) record. + +**Data.fsxButton:** 0x0 specifies that the XF record is not attached to a pivot field drop-down button. + +### Formatting: XF 3 + +The next record in this example, [XF](#xf), specifies formatting properties for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) or a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7) and is referenced by the [Number](#number) record for cell B4. + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------------------------|-----------| +| 0014 | XF **- XF** | | +| 0002 | FontIndex **- ifnt** | | +| 0002 | USHORT **- ifnt** | 0x0000 | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x00A4 | +| 1 bit | USHORT **- fLocked** | 0x1 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fStyle** | 0x0 | +| 1 bit | USHORT **- f123Prefix** | 0x0 | +| 12 bits | USHORT **- ixfParent** | 0x000 | +| 000E | [CellXF](#cellxf) **- Data** | | +| 3 bits | BYTE **- alc** | 0x0 | +| 1 bit | BYTE **- fWrap** | 0x0 | +| 3 bits | BYTE **- alcV** | 0x2 | +| 1 bit | BYTE **- fJustLast** | 0x0 | +| 0001 | [XFPropTextRotation](#xfproptextrotation) **- trot** | | +| 0001 | BYTE **- trot** | 0x00 | +| 4 bits | BYTE **- cIndent** | 0x0 | +| 1 bit | BYTE **- fShrinkToFit** | 0x0 | +| 1 bit | BYTE **- reserved1** | 0x0 | +| 2 bits | BYTE **- iReadOrder** | 0x0 | +| 2 bits | BYTE **- reserved2** | 0x0 | +| 1 bit | BYTE **- fAtrNum** | 0x1 | +| 1 bit | BYTE **- fAtrFnt** | 0x0 | +| 1 bit | BYTE **- fAtrAlc** | 0x0 | +| 1 bit | BYTE **- fAtrBdr** | 0x0 | +| 1 bit | BYTE **- fAtrPat** | 0x0 | +| 1 bit | BYTE **- fAtrProt** | 0x0 | +| 4 bits | USHORT **- dgLeft** | 0x0 | +| 4 bits | USHORT **- dgRight** | 0x0 | +| 4 bits | USHORT **- dgTop** | 0x0 | +| 4 bits | USHORT **- dgBottom** | 0x0 | +| 7 bits | USHORT **- icvLeft** | 0x00 | +| 7 bits | USHORT **- ivcRight** | 0x00 | +| 2 bits | USHORT **- grbitDiag** | 0x0 | +| 7 bits | ULONG **- icvTop** | 0x00 | +| 7 bits | ULONG **- icvBottom** | 0x00 | +| 7 bits | ULONG **- icvDiag** | 0x00 | +| 4 bits | ULONG **- dgDiag** | 0x0 | +| 1 bit | ULONG **- fHasXFExt** | 0x0 | +| 6 bits | ULONG **- fls** | 0x00 | +| 7 bits | USHORT **- icvFore** | 0x40 | +| 7 bits | USHORT **- icvBack** | 0x41 | +| 1 bit | USHORT **- fsxButton** | 0x0 | +| 1 bit | USHORT **- reserved3** | 0x0 | + +Figure 83: Structure of XF + +Fields in this record that are explained in previous records in this example have been omitted for brevity. + +**ifmt:** Specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) and text formatting for the cell. + +**ifmt.ifmt:** 0x00A4 specifies the first user-defined [Format](#format) record illustrated previously. The formatting string specified by the referenced Format record is "0.00000". + +### Formatting: XF 4 + +The next record in this example, [XF](#xf), specifies formatting properties for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) or a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7) and is referenced by the [Number](#number) record for cell B5. + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------------------------|-----------| +| 0014 | XF **- XF** | | +| 0002 | FontIndex **- ifnt** | | +| 0002 | USHORT **- ifnt** | 0x0005 | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x0000 | +| 1 bit | USHORT **- fLocked** | 0x1 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fStyle** | 0x0 | +| 1 bit | USHORT **- f123Prefix** | 0x0 | +| 12 bits | USHORT **- ixfParent** | 0x000 | +| 000E | [CellXF](#cellxf) **- Data** | | +| 3 bits | BYTE **- alc** | 0x0 | +| 1 bit | BYTE **- fWrap** | 0x0 | +| 3 bits | BYTE **- alcV** | 0x2 | +| 1 bit | BYTE **- fJustLast** | 0x0 | +| 0001 | [XFPropTextRotation](#xfproptextrotation) **- trot** | | +| 0001 | BYTE **- trot** | 0x00 | +| 4 bits | BYTE **- cIndent** | 0x0 | +| 1 bit | BYTE **- fShrinkToFit** | 0x0 | +| 1 bit | BYTE **- reserved1** | 0x0 | +| 2 bits | BYTE **- iReadOrder** | 0x0 | +| 2 bits | BYTE **- reserved2** | 0x0 | +| 1 bit | BYTE **- fAtrNum** | 0x0 | +| 1 bit | BYTE **- fAtrFnt** | 0x1 | +| 1 bit | BYTE **- fAtrAlc** | 0x0 | +| 1 bit | BYTE **- fAtrBdr** | 0x0 | +| 1 bit | BYTE **- fAtrPat** | 0x1 | +| 1 bit | BYTE **- fAtrProt** | 0x0 | +| 4 bits | USHORT **- dgLeft** | 0x0 | +| 4 bits | USHORT **- dgRight** | 0x0 | +| 4 bits | USHORT **- dgTop** | 0x0 | +| 4 bits | USHORT **- dgBottom** | 0x0 | +| 7 bits | USHORT **- icvLeft** | 0x00 | +| 7 bits | USHORT **- ivcRight** | 0x00 | +| 2 bits | USHORT **- grbitDiag** | 0x0 | +| 7 bits | ULONG **- icvTop** | 0x00 | +| 7 bits | ULONG **- icvBottom** | 0x00 | +| 7 bits | ULONG **- icvDiag** | 0x00 | +| 4 bits | ULONG **- dgDiag** | 0x0 | +| 1 bit | ULONG **- fHasXFExt** | 0x0 | +| 6 bits | ULONG **- fls** | 0x01 | +| 7 bits | USHORT **- icvFore** | 0x0D | +| 7 bits | USHORT **- icvBack** | 0x40 | +| 1 bit | USHORT **- fsxButton** | 0x0 | +| 1 bit | USHORT **- reserved3** | 0x0 | + +Figure 84: Structure of XF + +Fields in this record that are explained in previous records in this example have been omitted for brevity. + +**ifnt:** Specifies formatting properties for the cell. + +**ifnt.ifnt:** 0x0005 specifies a [FontIndex](#fontindex) which specifies the first [Font](#font) record in the collection of Font records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). This Font record is illustrated previously. + +**Data:** Specifies additional properties of the cell format. + +**Data.fAtrNum:** 0x0 specifies that the **ifmt** field of this XF record is updated when the corresponding field of the XF record specified by the **ixfParent** field of this XF record is changed. + +**Data.fAtrFnt:** 0x1 specifies that the **ifnt** field of this XF record is not updated when the corresponding field of the XF record specified by the **ixfParent** field of the containing XF record is changed. + +**Data.fAtrPat:** 0x1 specifies that the **fls**, **icvFore**, and **icvBack** fields are not updated when the corresponding fields of the XF record specified by the **ixfParent** field of this XF record are changed. + +**Data.fls:** 0x01 specifies a solid [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e). Only **icvFore** is rendered. + +**Data.icvFore:** 0x0D specifies that the [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) of the fill pattern is field **rgColor**\[5\] of the [Palette](#palette) record in the file. If no Palette record exists, the default value is an RGB value with a red value of 255, a green value of 255, and a blue value of 0, representing the color yellow. + +**Data.icvBack:** 0x40 specifies that the [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) of the fill pattern is the default foreground color. + +Records following this record, and before the next Number record, are omitted for brevity. + +### Formatting: Number 1 + +The next record in this example, [Number](#number), specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) B3, which contains a [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d). This record is the first in the set of Number records in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|------------------| +| 000E | Number **- Number** | | +| 0006 | [Cell](#cell) **- cell** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0002 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x0015 | +| 0008 | Double **- num** | 3FF3C083126E978D | + +Figure 85: Structure of Number + +**cell:** Specifies a cell in the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing a floating-point number. + +**cell.rw:** Specifies the row index of the cell. + +**cell.rw.rw:** 0x0002 specifies that the cell is in row 3. + +**cell.col:** Specifies the column index of the cell. + +**cell.col.col:** 0x0001 specifies that the cell is in column B. + +**cell.ixfe:** Specifies the [cell XF](#Section_518a740d71c640c8bb97e7df6915861a) record in the collection of [XF](#xf) records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +**cell.ixfe.ixfe:** 0x0015 specifies that the cell is formatted according to the first user-defined XF record in the Globals Substream. This XF is the second XF record in this example. + +**num:** 0x3FF3C083126E978D specifies a 64-bit IEEE-754 floating-point value of 1.2345 as the value of the cell. + +### Formatting: Number 2 + +The next record in this example, [Number](#number), specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) B4, which contains a [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|------------------| +| 000E | Number **- Number** | | +| 0006 | [Cell](#cell) **- cell** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0003 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x0016 | +| 0008 | Double **- num** | 3FF3C083126E978D | + +Figure 86: Structure of Number + +Fields in this record that are explained in previous records in this example have been omitted for brevity. + +**cell:** Specifies a cell in the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing a floating-point number. + +**cell.rw:** Specifies the row index of the cell. + +**cell.rw.rw:** 0x0003 specifies that the cell is in row 4. + +**cell.col:** Specifies the column index of the cell. + +**cell.col.col:** 0x0001 specifies that the cell is in column B. + +**cell.ixfe:** Specifies the [cell XF](#Section_518a740d71c640c8bb97e7df6915861a) record in the collection of [XF](#xf) records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +**cell.ixfe.ixfe:** 0x0016 specifies that the cell is formatted according to the second user-defined XF record in the Globals Substream. This XF is the third XF record in this example. + +### Formatting: Number 3 + +The next record in this example, [Number](#number), specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) B5, which contains a [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|------------------| +| 000E | Number **- Number** | | +| 0006 | [Cell](#cell) **- cell** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0004 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x0017 | +| 0008 | Double **- num** | 3FF3C083126E978D | + +Figure 87: Structure of Number + +Fields in this record that are explained in previous records in this example have been omitted for brevity. + +**cell:** Specifies a cell in the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing a floating-point number. + +**cell.rw:** Specifies the row index of the cell. + +**cell.rw.rw:** 0x0004 specifies that the cell is in row 5. + +**cell.col:** Specifies the column index of the cell. + +**cell.col.col:** 0x0001 specifies that the cell is in column B. + +**cell.ixfe:** Specifies the [cell XF](#Section_518a740d71c640c8bb97e7df6915861a) record in the collection of [XF](#xf) records in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1). + +**cell.ixfe.ixfe:** 0x0017 specifies that the cell is formatted according to the third user-defined XF record in the Globals Substream. This XF is the fourth XF record in this example. + +## Workbook + +This example shows a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) containing three [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d), named "Sheet1", "Sheet2" and "Sheet3". "Sheet1" contains the following cell content: + +- Cell B4 contains the string "Number". + +- Cell B5 contains the number 1. + +- Cell B6 contains the string "Formula". + +- Cell B7 contains the formula "=SQRT(B5\*2)". + +The workbook example can be broken into two parts. The first part of the example includes records found in the [Globals](#Section_ca4c174887294a93abb94602b3a01fb1) Substream. These records contain details about the entire workbook through examples of the following parent records: [BOF](#bof), [RRTabId](#rrtabid)**,** [BuiltInFnGroupCount](#builtinfngroupcount), [Window1](#window1), [HideObj](#hideobj), [Date1904](#date1904), [CalcPrecision](#calcprecision), [BookBool](#bookbool), [Font](#font), [Format](#format), [XF](#xf), [Style](#style), [BoundSheet8](#boundsheet8)**,** [Country](#country), [RecalcId](#recalcid), [SST](#sst)**,** [ExtSST](#extsst), [BookExt](#bookext), and [EOF](#eof). + +The second part of this example contains the [Worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream. These records contain details about the first sheet through examples of the following parent records: BOF**,** [Index](#index), [DefaultRowHeight](#defaultrowheight), [WsBool](#wsbool), [Setup](#setup), [DefColWidth](#defcolwidth), [Dimensions](#dimensions), [Row](#row), [LabelSst](#labelsst), [RK](#rk), [Formula](#formula), [DBCell](#dbcell), [Window2](#window2), [Selection](#selection), [PhoneticInfo](#phoneticinfo), and EOF. + +"Sheet2" and "Sheet3" are empty sheets and their record details are not documented in this example. + +![A sheet within a workbook](media/image91.bin "A sheet within a workbook") + +Figure 88: A sheet within a workbook + +### Workbook: BOF 1 + +This first [BOF](#bof) record begins the [Globals](#Section_ca4c174887294a93abb94602b3a01fb1) Substream and [Workbook](#Section_f682f4b08c6b444e83f852d156f1e8ba) stream and specifies global properties and data for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe), as well as the [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in this example workbook. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------|-----------| +| 0014 | BOF **- BOF** | | +| 0002 | USHORT **- vers** | 0x0600 | +| 0002 | USHORT **- dt** | 0x0005 | +| 0002 | USHORT **- rupBuild** | 0x2013 | +| 0002 | USHORT **- rupYear** | 0x07CD | +| 1 bit | DWORD **- fWin** | 0x1 | +| 1 bit | DWORD **- fRisc** | 0x0 | +| 1 bit | DWORD **- fBeta** | 0x0 | +| 1 bit | DWORD **- fWinAny** | 0x0 | +| 1 bit | DWORD **- fMacAny** | 0x0 | +| 1 bit | DWORD **- fBetaAny** | 0x0 | +| 2 bits | DWORD **- unused1** | 0x3 | +| 1 bit | DWORD **- fRiscAny** | 0x0 | +| 1 bit | DWORD **- fOOM** | 0x0 | +| 1 bit | DWORD **- fGlJmp** | 0x0 | +| 2 bits | DWORD **- unused2** | 0x0 | +| 1 bit | DWORD **- fFontLimit** | 0x0 | +| 4 bits | DWORD **- verXLHigh** | 0x3 | +| 1 bit | DWORD **- unused3** | 0x0 | +| 13 bits | DWORD **- reserved1** | 0x0000 | +| 8 bits | DWORD **- verLowestBiff** | 0x06 | +| 4 bits | DWORD **- verLastXLSaved** | 0x3 | +| 20 bits | DWORD **- reserved2** | 0x00000 | + +Figure 89: Structure of BOF + +**vers:** 0x0600 specifies that the [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) version of the file is 1536. + +**dt:** 0x0005 specifies that the substream of records following this BOF record are part of the workbook stream. + +**rupBuild:** 0x2013 specifies that the version of the build is 8211. + +**rupYear:** 0x07CD specifies 1997 as the year when the file format version was first created. + +**fWin:** 0x1 specifies that the file was last edited on a Windows platform. + +**fRisc:** 0x0 specifies that the file was not last edited on a RISC platform. + +**fBeta:** 0x0 specifies that the file was not last edited by a [**beta**](#gt_b7cc0e52-196c-41e1-afa2-14da4352ac5d) version of the application. + +**fWinAny:** 0x0 specifies that the file has not been subsequently saved. + +**fMacAny:** 0x0 specifies that the file has never been edited on a Macintosh platform. + +**fBetaAny:** 0x0 specifies that the file has never been edited on a beta version of the application. + +**fRiscAny:** 0x0 specifies that the file has never been edited on a RISC platform. + +**fOOM:** 0x0 specifies that the file has never had an [**out-of-memory**](#gt_1607fcec-cc19-40a2-9a61-678f90f5943e) failure. + +**fGlJmp:** 0x0 specifies that the file has never had an out-of-memory failure during rendering. + +**fFontLimit:** 0x0 specifies that the file has never reached the 255 [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) limit. + +**verXLHigh:** 0x3 specifies that the file was not edited in any applications after Office Excel 2003. + +**verLowestBiff:** 0x06 specifies that the files are saved in BIFF version 6. + +**verLastXLSaved:** 0x3 specifies that the file was last saved by Office Excel 2003. + +Records following this record, and before the next [RRTabId](#rrtabid) record, are omitted for brevity. + +### Workbook: RRTabId + +This [RRTabId](#rrtabid) record specifies unique [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) identifiers, each of which is associated with a sheet in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------|-----------| +| 0006 | RRTabId **- RRTabId** | | +| 0006 | RgTabId **- rgtabid** | | +| 0002 | USHORT **- rgtabid\[0\]** | 0x0001 | +| 0002 | USHORT **- rgtabid\[1\]** | 0x0002 | +| 0002 | USHORT **- rgtabid\[2\]** | 0x0003 | + +Figure 90: Structure of RRTabId + +**rgtabid:** An array of elements of unique sheet identifiers. + +**rgtabid.rgtabid\[0\]:** 0x0001 specifies the first sheet identifier. + +**rgtabid.rgtabid\[1\]:** 0x0002 specifies the second sheet identifier. + +**rgtabid.rgtabid\[2\]:** 0x0003 specifies the third sheet identifier. + +### Workbook: BuiltInFnGroupCount + +This [BuiltInFnGroupCount](#builtinfngroupcount) record specifies information about the built-in [**function categories**](#gt_026a49a8-c3e8-49eb-a97f-58bd2c79c540) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------------------|-----------| +| 0002 | BuiltInFnGroupCount **- BuiltinFnGroupCount** | | +| 0002 | USHORT **- count** | 0x000E | + +Figure 91: Structure of BuiltinFnGroupCount + +**count:** 0x000E specifies there are 14 built-in function categories in the workbook. + +Records following this record, and before the next [Window1](#window1) record, are omitted for brevity. + +### Workbook: Window1 + +This [Window1](#window1) record specifies attributes of the window used to display the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------|-----------| +| 0012 | Window1 **- Window1** | | +| 0002 | SHORT **- xWn** | 0x01E0 | +| 0002 | SHORT **- yWn** | 0x0069 | +| 0002 | SHORT **- dxWn** | 0x4E1B | +| 0002 | SHORT **- dyWn** | 0x3CE1 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fIconic** | 0x0 | +| 1 bit | USHORT **- fVeryHidden** | 0x0 | +| 1 bit | USHORT **- fDspHScroll** | 0x1 | +| 1 bit | USHORT **- fDspVScroll** | 0x1 | +| 1 bit | USHORT **- fBotAdornment** | 0x1 | +| 1 bit | USHORT **- fNoAFDateGroup** | 0x0 | +| 9 bits | USHORT **- reserved** | 0x000 | +| 0002 | [TabIndex](#tabindex) **- itabCur** | | +| 0002 | USHORT **- itab** | 0x0000 | +| 0002 | TabIndex **- itabFirst** | | +| 0002 | USHORT **- itab** | 0x0000 | +| 0002 | USHORT **- ctabSel** | 0x0001 | +| 0002 | USHORT **- wTabRatio** | 0x0258 | + +Figure 92: Structure of Window1 + +**xWn:** 0x01E0 specifies that the horizontal position of the window is 480 [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382) from the logical left edge of the [**client area**](#gt_623ea69b-ffdb-4751-8751-2cbf4cc11f08) of the window. + +**yWn:** 0x0069 specifies that the vertical position of the window is 105 twips from the top edge of the client area of the window. + +**dxWn:** 0x4E1B specifies that the width of the window is 19995 twips. + +**dyWn:** 0x3CE1 specifies that the height of the window 15585 twips. + +**fHidden:** 0x0000 specifies that the window is not [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**fIconic:** 0x0000 specifies that the window is not minimized. + +**fVeryHidden:** 0x0000 specifies that the window is not hidden. + +**fDspHScroll:** 0x0001 specifies that the horizontal scroll bar is displayed + +**fDspVScroll:** 0x0001 specifies that the vertical scroll bar is displayed. + +**fBotAdornment:** 0x0001 specifies that the [**sheet tabs**](#gt_3b131045-238c-4ce8-9c22-b6aac874c7c5) are displayed. + +**fNoAFDateGroup:** 0x0000 specifies that dates are grouped by year, month, and day in the [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) menu. + +**itabCur:** Specifies which sheet tab is [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595). + +**itabCur.itab:** 0x0000 specifies that the first sheet tab is selected. + +**itabFirst:** Specifies which is the first displayed sheet tab. + +**itabFirst.itab:** 0x0000 specifies that the first tab is the displayed sheet tab. + +**ctabSel:** 0x0001 specifies that one sheet tab is selected in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +**wTabRatio:** 0x0258 specifies that the ratio of the width of the sheet tabs to the width of the horizontal scroll bar is 0.6. + +Records following this record, and before the next [HideObj](#hideobj) record, are omitted for brevity. + +### Workbook: HideObj + +This [HideObj](#hideobj) record specifies how [**drawing objects**](#gt_51dfe494-9c84-4a0e-9d53-06068c5ce3ac) appear in a window that contains the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------------|-----------| +| 0002 | HideObj **- HideObj** | | +| 0002 | [HideObjEnum](#hideobjenum) **- hideObj** | 0x0000 | + +Figure 93: Structure of HideObj + +**hideObj:** 0x0000 specifies that all drawing objects in the window are shown. + +### Workbook: Date1904 + +This [Date1904](#date1904) record specifies whether the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) uses the 1904-based or the 1900-based [**date system**](#gt_cfc29c5e-eb23-4077-b6eb-492f20f5c87f). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------|-----------| +| 0002 | Date1904 **- Date1904** | | +| 0002 | SHORT **- f1904DateSystem** | 0x0000 | + +Figure 94: Structure of Date1904 + +**f1904DateSystem:** 0x0000 specifies that the workbook uses the 1900 date system. + +### Workbook: CalcPrecision + +This [CalcPrecision](#calcprecision) record specifies the calculation precision mode for the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|------------------------------|-----------| +| 0002 | CalcPrecision **- CalcPrec** | | +| 0002 | SHORT **- fFullPrec** | 0x0001 | + +Figure 95: Structure of CalcPrec + +**fFullPrec:** 0x0001 specifies that [**precision as displayed**](#gt_e2ff81a6-eb9a-4e49-a1d0-cd4483e2e9a6) mode is not [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595). + +Records following this record, and before the next [BookBool](#bookbool) record, are omitted for brevity. + +### Workbook: BookBool + +This [BookBool](#bookbool) record specifies some properties associated with the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------|-----------| +| 0002 | BookBool **- BookBool** | | +| 1 bit | USHORT **- fNoSaveSup** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fHasEnvelope** | 0x0 | +| 1 bit | USHORT **- fEnvelopeVisible** | 0x0 | +| 1 bit | USHORT **- fEnvelopeInitDone** | 0x0 | +| 2 bits | USHORT **- grUpdateLinks** | 0x0 | +| 1 bit | USHORT **- unused** | 0x0 | +| 1 bit | USHORT **- fHideBorderUnselLists** | 0x0 | +| 7 bits | USHORT **- reserved2** | 0x00 | + +Figure 96: Structure of BookBool + +**fNoSaveSup:** 0x0000 specifies that [**external link**](#gt_496fd743-2045-4c53-81b9-83fb90a7fab1) values are saved in the workbook. + +**fHasEnvelope:** 0x0000 specifies the workbook does not have an envelope. + +**fEnvelopeVisible:** 0x0000 specifies the envelope is not visible. + +**fEnvelopeInitDone:** 0x0000 specifies the envelope has not been initialized. + +**grUpdateLinks:** 0x0000 specifies the application prompts users to update external links in the workbook. + +**fHideBorderUnselLists:** 0x0000 specifies that borders of [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) that do not contain the active [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) are not [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +### Workbook: Font + +This [Font](#font) record specifies [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) formatting information and is the first of four in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001A | Font **- Font** | | +| 0002 | USHORT **- dyHeight** | 0x00C8 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fItalic** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fStrikeOut** | 0x0 | +| 1 bit | USHORT **- fOutline** | 0x0 | +| 1 bit | USHORT **- fShadow** | 0x0 | +| 1 bit | USHORT **- fCondense** | 0x0 | +| 1 bit | USHORT **- fExtend** | 0x0 | +| 8 bits | USHORT **- reserved** | 0x00 | +| 0002 | USHORT **- icv** | 0x7FFF | +| 0002 | USHORT **- bls** | 0x0190 | +| 0002 | USHORT **- sss** | 0x0000 | +| 0001 | BYTE **- uls** | 0x00 | +| 0001 | BYTE **- bFamily** | 0x00 | +| 0001 | BYTE **- bCharSet** | 0x00 | +| 0001 | BYTE **- unused3** | 0x57 | +| 000C | [ShortXLUnicodeString](#shortxlunicodestring) **- fontName** | Arial | + +Figure 97: Structure of Font + +**dyHeight:** 0x00C8 specifies that the height of the font is 200 [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382). + +**fItalic:** 0x0 specifies that the font is not italic. + +**fStrikeOut:** 0x0 specifies that the font does not have [**strikethrough formatting**](#gt_b16d9600-aebb-4a4f-bf14-c38e13c11c14) applied. + +**fOutline:** 0x0 specifies that the font does not have an [**outline effect**](#gt_4e818802-fdc1-4227-b32f-1a3cb0943de7). + +**fShadow:** 0x0 specifies that the font does not have a [**shadow effect**](#gt_83056968-00f2-463b-abc6-607dbb242cbf). + +**fCondense:** 0x0 specifies that the font is not condensed + +**fExtend:** 0x0 specifies that the font is not extended. + +**icv:** 0x7FFF specifies that the color of the font is automatic and matches the window text color. + +**bls:** 0x0190 specifies that the font weight is normal. + +**sss:** 0x0000 specifies that no superscript or subscript is used. + +**uls:** 0x00 specifies that the font does not have underlining. + +**bFamily:** 0x00 specifies that the [**font family**](#gt_bca5490d-d27e-4097-b05d-9efb09083dd2) of the font is not applicable as detailed in the Windows API LOGFONT structure in [\[MSDN-FONTS\]](https://go.microsoft.com/fwlink/?LinkId=90008). + +**bCharSet:** 0x00 specifies that this font belongs to the [**ANSI character set**](#gt_100cd8a6-5cb1-4895-9de6-e4a3c224a583). + +**fontName:** "Arial" specifies the name of the font. + +The three Font records following this record, and before the next [Format](#format) record, are omitted for brevity. + +### Workbook: Format + +This [Format](#format) record specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) applied to a number and is the first of eight in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|----------------------------------------------------|-----------| +| 001C | Format **- Format** | | +| 0002 | [IFmt](#ifmt) **- ifmt** | 0x0005 | +| 001A | [XLUnicodeString](#xlunicodestring) **- stFormat** | 0.00000 | + +Figure 98: Structure of Format + +**ifmt:** 0x0005 specifies the identifier for the formatting string. + +**stFormat:** "0.00000" specifies the custom number format string to be applied. + +The seven Format records following this record, and before the next [XF](#xf) record, are omitted for brevity. + +### Workbook: XF + +This [XF](#xf) record specifies formatting properties for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) and is the first of 21 XF records in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------------------------|-----------| +| 0014 | XF **- Xf** | | +| 0002 | [FontIndex](#fontindex) **- ifnt** | | +| 0002 | USHORT **- ifnt** | 0x0000 | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x0000 | +| 1 bit | USHORT **- fLocked** | 0x1 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fStyle** | 0x1 | +| 1 bit | USHORT **- f123Prefix** | 0x0 | +| 12 bits | USHORT **- ixfParent** | 0xFFF | +| 0003 | [StyleXF](#stylexf) **- Data** | | +| 3 bits | BYTE **- alc** | 0x0 | +| 1 bit | BYTE **- fWrap** | 0x0 | +| 3 bits | BYTE **- alcV** | 0x2 | +| 1 bit | BYTE **- fJustLast** | 0x0 | +| 0001 | [XFPropTextRotation](#xfproptextrotation) **- trot** | | +| 0001 | BYTE **- trot** | 0x00 | +| 4 bits | BYTE **- cIndent** | 0x0 | +| 1 bit | BYTE **- fShrinkToFit** | 0x0 | +| 1 bit | BYTE **- reserved1** | 0x0 | +| 2 bits | BYTE **- iReadOrder** | 0x0 | +| 0001 | BYTE **- unused** | 0x00 | +| 4 bits | USHORT **- dgLeft** | 0x0 | +| 4 bits | USHORT **- dgRight** | 0x0 | +| 4 bits | USHORT **- dgTop** | 0x0 | +| 4 bits | USHORT **- dgBottom** | 0x0 | +| 7 bits | USHORT **- icvLeft** | 0x00 | +| 7 bits | USHORT **- ivcRight** | 0x00 | +| 2 bits | USHORT **- grbitDiag** | 0x0 | +| 7 bits | ULONG **- icvTop** | 0x00 | +| 7 bits | ULONG **- icvBottom** | 0x00 | +| 7 bits | ULONG **- icvDiag** | 0x00 | +| 4 bits | ULONG **- dgDiag** | 0x0 | +| 1 bit | ULONG **- reserved2** | 0x0 | +| 6 bits | ULONG **- fls** | 0x00 | +| 7 bits | USHORT **- icvFore** | 0x40 | +| 7 bits | USHORT **- icvBack** | 0x41 | +| 2 bits | USHORT **- reserved3** | 0x0 | + +Figure 99: Structure of Xf + +**ifnt:** A FontIndex that specifies a [Font](#font) record. + +**ifnt.ifnt:** 0x0000 specifies that the default [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) is used. + +**ifmt:** Specifies the identifier of a [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b). + +**ifmt.ifmt:** 0x0000 specifies that general (automatic) formatting is applied for the cell. + +**fLocked:** 0x1 specifies that this cell has [**locked protection**](#gt_10f1ec97-0464-49da-bf78-5339b9d3520c). Because this workbook example has no [Protect](#protect) record, this setting does not apply. + +**fHidden:** 0x0 specifies that this cell is not [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**fStyle:** 0x1 specifies that this record specifies a [cell style XF](#Section_3d5348ded9df4c31b1fd9f9377273152). + +**f123Prefix:** 0x0 specifies that prefix characters are not present in the cell. + +**ixfParent:** 0xFFF specifies that there is no inheritance from a cell style XF. + +**Data:** This structure specifies formatting properties for a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7). + +**Data.alc:** 0x0 specifies that [**horizontal alignment**](#gt_f0e60ca8-51d5-4553-9126-3d89a4d08f90) for the cell is [**general alignment**](#gt_3ee6d1d4-830b-4dc2-b8be-751665f8045f). + +**Data.fWrap:** 0x0 specifies that cell text is not wrapped. + +**Data.alcV:** 0x2 specifies that [**vertical alignment**](#gt_5a59a612-2d00-4cb5-9565-952243641878) for the cell is bottom alignment. + +**Data.fJustLast:** 0x0 specifies that the cell text is not justified. + +**Data.trot:** This structure specifies rotation for the cell text. + +**Data.trot.trot:** 0x00 specifies zero degrees of rotation. + +**Data.cIndent:** 0x0 specifies that the text indent level is zero. + +**Data.fShrinkToFit:** 0x0 specifies that text is not [**shrink to fit**](#gt_4740d2ef-00d3-4a29-983c-b7b3a6aa01e0). + +**Data.iReadOrder:** 0x0 specifies that context [**reading order**](#gt_defb8e89-c809-4682-81f3-19c547363361) is set. + +**Data.dgLeft:** 0x0 specifies that there is no [**logical left**](#gt_ccc2ab6c-db9b-4c67-9b95-21ce79e7358d) border. + +**Data.dgRight:** 0x0 specifies that there is no [**logical right**](#gt_ef86cf61-a2e3-4130-abc4-9e92dae5a2a7) border. + +**Data.dgTop:** 0x0 specifies that there is no top border. + +**Data.dgBottom:** 0x0 specifies that there is no bottom border. + +**Data.icvLeft:** 0x00 specifies that the logical left border color has not been set. + +**Data.ivcRight:** 0x00 specifies that the logical right border color has not been set. + +**Data.grbitDiag:** 0x0 specifies that there is no diagonal border. + +**Data.icvTop:** 0x00 specifies that the top border color has not been set. + +**Data.icvBottom:** 0x00 specifies that the bottom border color has not been set. + +**Data.icvDiag:** 0x00 specifies that the diagonal border color has not been set. + +**Data.dgDiag:** 0x0 specifies the line style for the diagonal border is set to no border. + +**Data.fls:** 0x00 specifies that there is no [**fill pattern**](#gt_87f0d54c-75c5-4242-a462-f55a2a95be9e). + +**Data.icvFore:** 0x40 specifies that the fill pattern uses the default [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) which is the window text color. + +**Data.icvBack:** 0x41 specifies that fill pattern uses the default [**background color**](#gt_8e2b1aa9-87f0-4a42-aa3d-9e3a5d5a826c) which is the default background color for a cell. + +The 20 XF records following this record, and before the next [Style](#style) record, are omitted for brevity. + +### Workbook: Style + +This [Style](#style) record specifies a [cell style](#Section_f9425d3f127545be8389bf80f65b56b7) and is the first of six Style records in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) example . + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------------------|-----------| +| 0004 | Style **- Style** | | +| 12 bits | USHORT **- ixfe** | 0x010 | +| 3 bits | USHORT **- unused** | 0x0 | +| 1 bit | USHORT **- fBuiltIn** | 0x1 | +| 0002 | [BuiltInStyle](#builtinstyle) **- builtInData** | | +| 0001 | BYTE **- istyBuiltIn** | 0x03 | +| 0001 | BYTE **- iLevel** | 0xFF | + +Figure 100: Structure of Style + +Fields in this record that are ignored are omitted for brevity. + +**ixfe:** 0x010 specifies the index to the 16th [XF](#xf) record for which these properties apply; this XF record is omitted from this workbook example for brevity. + +**fBuiltIn:** 0x0001 specifies that this cell uses the built-in cell style. + +**builtInData:** Specifies an optional built-in cell style. + +**builtInData.istyBuiltIn:** 0x03 specifies that the comma cell style is applied. + +The records following this record, and before the next [BoundSheet8](#boundsheet8) record, are omitted for brevity. + +### Workbook: BoundSheet8 1 + +This [BoundSheet8](#boundsheet8) record specifies basic information about the first [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) example, including the sheet name, [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) state, and type of sheet. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 000E | BoundSheet8 **- BoundSheet8** | | +| 0004 | FilePointer **- lbPlyPos** | 0x000005CA | +| 2 bits | USHORT **- hsState** | 0x0 | +| 6 bits | USHORT **- unused** | 0x00 | +| 8 bits | USHORT **- dt** | 0x00 | +| 0008 | [ShortXLUnicodeString](#shortxlunicodestring) **- stName** | Sheet1 | + +Figure 101: Structure of BoundSheet8 + +**lbPlyPos:** 0x000005CA specifies the stream position of the start of the [BOF](#bof) record for the sheet associated with this BoundSheet8 record. This stream position is the start of the binary record, which begins with the two-byte record type and two-byte record size information. See the [record](#Section_170e90ce87d747589331dcf14cd72388) overview for more details. The [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream for this sheet is shown later in this workbook example. + +**hsState:** 0x0 specifies that the sheet is [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72). + +**dt:** 0x00 specifies that the sheet type is a [**Worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +**stName:** "Sheet1" specifies the case-insensitive name of the sheet. + +### Workbook: BoundSheet8 2 + +This record is the same as the previous [BoundSheet8](#boundsheet8) record example and specifies basic information about the second [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) example. The fields that contain the same values as the previous record are omitted for brevity. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 000E | BoundSheet8 **- BoundSheet8** | | +| 0004 | FilePointer **- lbPlyPos** | 0x00000785 | +| 2 bits | USHORT **- hsState** | 0x0 | +| 6 bits | USHORT **- unused** | 0x00 | +| 8 bits | USHORT **- dt** | 0x00 | +| 0008 | [ShortXLUnicodeString](#shortxlunicodestring) **- stName** | Sheet2 | + +Figure 102: Structure of BoundSheet8 + +**lbPlyPos:** 0x00000785 specifies the stream position of the start of the [BOF](#bof) record for the sheet associated with this BoundSheet8 record. The [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream for this sheet is omitted for brevity from the workbook example. + +**stName:** "Sheet2" specifies the unique name of the sheet, which is not case sensitive. + +### Workbook: BoundSheet8 3 + +This record is the same as the first [BoundSheet8](#boundsheet8) record example and specifies basic information about the third [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) example. The fields that contain the same values as the first BoundSheet8 record are omitted for brevity. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 000E | BoundSheet8 **- BoundSheet8** | | +| 0004 | FilePointer **- lbPlyPos** | 0x0000088C | +| 2 bits | USHORT **- hsState** | 0x0 | +| 6 bits | USHORT **- unused** | 0x00 | +| 8 bits | USHORT **- dt** | 0x00 | +| 0008 | [ShortXLUnicodeString](#shortxlunicodestring) **- stName** | Sheet3 | + +Figure 103: Structure of BoundSheet8 + +**lbPlyPos:** 0x0000088C specifies the stream position of the start of the [BOF](#bof) record for the sheet associated with this BoundSheet8 record. The [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream for this sheet is omitted for brevity from the workbook example. + +**stName:** "Sheet3" specifies the name of the sheet, which is not case sensitive. + +### Workbook: Country + +This [Country](#country) record specifies the [**locale**](#gt_7b78ebef-e35d-45ab-abfd-4121b60995de) information for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------|-----------| +| 0004 | Country **- Country** | | +| 0002 | USHORT **- iCountryDef** | 0x0001 | +| 0002 | USHORT **- iCountryWinIni** | 0x0001 | + +Figure 104: Structure of Country + +**iCountryDef:** 0x0001 specifies that the locale for the workbook is the United States. + +**iCountryWinIni:** 0x0001 specifies that the system [**regional setting**](#gt_ede60f7f-1131-4845-800b-b6848215e015) is United States. + +### Workbook: RecalcId + +This [RecalcId](#recalcid) record specifies the recalculation engine identifier of the recalculation engine that last performed a recalculation. + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|------------| +| 0008 | RecalcId **- RecalcID** | | +| 0002 | USHORT **- rt** | 0x01C1 | +| 0002 | USHORT **- reserved** | 0x0000 | +| 0004 | DWORD **- dwBuild** | 0x0001BE22 | + +Figure 105: Structure of RecalcID + +**rt:** 0x01C1 specifies that the record identifier for this record is 449. + +**dwBuild:** 0x0001BE22 specifies the recalculation engine identifier of the recalculation engine that performed the last recalculation, which is 114210. + +### Workbook: SST + +This [SST](#sst) record specifies string constants. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001B | SST **- Sst** | | +| 0004 | LONG **- cstTotal** | 0x00000002 | +| 0004 | LONG **- cstUnique** | 0x00000002 | +| 0013 | XLUnicodeRichExtendedString\[\] **- rgb** | | +| 0009 | [XLUnicodeRichExtendedString](#xlunicoderichextendedstring) **- rgb\[0\]** | Number | +| 000A | XLUnicodeRichExtendedString **- rgb\[1\]** | Formula | + +Figure 106: Structure of Sst + +Fields in this record that are ignored because they are optional are omitted for brevity. + +**cstTotal:** 0x00000002 specifies that there are two references in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) to the strings in the shared string table. + +**cstUnique:** 0x00000002 specifies that there are two unique strings in the shared string table. + +**rgb:** Specifies an array of [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) strings. + +**rgb.rgb\[0\]:** "Number" is the first string in the shared string table. + +**rgb.rgb\[1\]:** "Formula" is the second string in the shared string table. + +### Workbook: ExtSST + +This [ExtSST](#extsst) record specifies the location of strings within the shared string table, specified in the previous [SST](#sst) record. + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------------|------------| +| 000A | ExtSST **- ExtSst** | | +| 0002 | USHORT **- dsst** | 0x0008 | +| 0008 | ISSTInf\[\] **- rgISSTInf** | | +| 0008 | [ISSTInf](#isstinf) **- rgISSTInf\[0\]** | | +| 0004 | FilePointer **- ib** | 0x0000058C | +| 0002 | UINT **- cbOffset** | 0x000C | +| 0002 | reserved **- reserved** | 0x0000 | + +Figure 107: Structure of ExtSst + +**dsst:** 0x0008 specifies the default value for this field as specified by the formula in the ExtSST record. + +**rgISSTInf:** Specifies the location of a set of strings within the SST record. + +**rgISSTInf.rgISSTInf\[0\].ib:** 0x0000058C specifies that the FilePointer as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.5 that specifies the zero-based offset into the [Workbook](#Section_f682f4b08c6b444e83f852d156f1e8ba) stream is 1420. + +**rgISSTInf.rgISSTInf\[0\].cbOffset:** 0x000C specifies that the zero-based offset into the SST record is 12. + +### Workbook: BookExt + +This [BookExt](#bookext) record specifies properties of the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0015 | BookExt **- BookExt** | | +| 000C | [FrtHeader](#frtheader) **- FrtHeader** | | +| 0002 | USHORT **- rt** | 0x0863 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0008 | reserved **- reserved** | 0x0000000000000000 | +| 0004 | DWORD **- cb** | 0x00000015 | +| 1 bit | DWORD **- fDontAutoRecover** | 0x0 | +| 1 bit | DWORD **- fHidePivotList** | 0x0 | +| 1 bit | DWORD **- fFilterPrivacy** | 0x0 | +| 1 bit | DWORD **- fEmbedFactoids** | 0x0 | +| 2 bits | DWORD **- mdFactoidDisplay** | 0x0 | +| 1 bit | DWORD **- fSavedDuringRecovery** | 0x0 | +| 1 bit | DWORD **- fCreatedViaMinimalSave** | 0x0 | +| 1 bit | DWORD **- fOpenedViaDataRecovery** | 0x0 | +| 1 bit | DWORD **- fOpenedViaSafeLoad** | 0x0 | +| 22 bits | DWORD **- reserved** | 0x000000 | +| 0001 | [BookExt_Conditional11](#bookext_conditional11) **- grbit1** | | +| 1 bit | BYTE **- fBuggedUserAboutSolution** | 0x0 | +| 1 bit | BYTE **- fShowInkAnnotation** | 0x1 | +| 6 bits | BYTE **- unused** | 0x00 | + +Figure 108: Structure of BookExt + +Fields in this record that are ignored because they have zero values are omitted for brevity. + +**FrtHeader:** This structure specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) header. + +**FrtHeader.rt:** 0x0863 is the required value for this field and specifies that this record is contained in a BookExt record. + +**FrtHeader.grbitFrt:** This structure specifies flags used in the future record header. + +**FrtHeader.grbitFrt.fFrtRef:** 0x0000 specifies that this **FrtHeader** does not specify a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +**FrtHeader.grbitFrt.fFrtAlert:** 0x0000 specifies that the user is not alerted of possible problems when saving this file without having recognized this record. + +**cb:** 0x00000015 specifies that the size of the record is 21 bytes. + +**fDontAutoRecover:** 0x0 specifies that [**AutoRecover**](#gt_082e4fd1-0461-4797-baa0-d2797f0ba555) is enabled for the workbook. + +**fHidePivotList:** 0x0 specifies that the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) field list is not [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) for this workbook. + +**fFilterPrivacy:** 0x0 specifies that personal information is not removed from the workbook on save. + +**fEmbedFactoids:** 0x0 specifies that [**smart tags**](#gt_2f57a49a-d503-4605-8798-0e53bd637609) are not embedded in this workbook on save. + +**mdFactoidDisplay:** 0x0 specifies that the workbook displays smart tags as [**smart tag actions buttons**](#gt_7c1f7dd0-048a-433e-a5ac-98b32121bcb9) and [**smart tag indicators**](#gt_62e83b67-c6c5-4a3e-8a09-2a5f0f39f65f). + +**fSavedDuringRecovery:** 0x0 specifies that the workbook was not saved during AutoRecover. + +**fCreatedViaMinimalSave:** 0x0 specifies the workbook was not created by a [**minimal save**](#gt_37ba5c27-ec42-4ccf-8122-86166df37c61) during [**data recovery**](#gt_667a7046-739a-4c24-9674-837d88e0031b). + +**fOpenedViaDataRecovery:** 0x0 specifies that the workbook was not opened as a result of data recovery. + +**fOpenedViaSafeLoad:** 0x0 specifies that the workbook was not opened in [**safe load**](#gt_78d75560-7171-4a5d-be0e-3b8c14bc62c4) mode. + +**grbit1:** Specifies additional workbook information. + +**grbit1.fBuggedUserAboutSolution:** 0x0 specifies that no warning is requested before loading a [**manifest**](#gt_d1a20cdc-cced-44de-a041-857fb9054856) that is a [**smart document**](#gt_cc9fe152-6a63-4555-91f1-1543ff84035d). + +**grbit1.fShowInkAnnotation:** 0x1 specifies that [**ink**](#gt_9fcdd1d5-3563-49b9-8a2e-bf696fb08fd0) [**comments**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) for the workbook are not displayed. + +### Workbook: EOF 1 + +This [EOF](#eof) record specifies the end of a collection of records as defined by [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf). + +| **Size** | **Structure** | +|----------|---------------| +| 0000 | EOF **- EOF** | + +Figure 109: Structure of EOF + +### Workbook: BOF 2 + +This [BOF](#bof) record specifies the beginning of the [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream and specifies information about "Sheet1". + +| **Size** | **Structure** | **Value** | +|----------|----------------------------|-----------| +| 0014 | BOF **- BOF** | | +| 0002 | USHORT **- vers** | 0x0600 | +| 0002 | USHORT **- dt** | 0x0010 | +| 0002 | USHORT **- rupBuild** | 0x2013 | +| 0002 | USHORT **- rupYear** | 0x07CD | +| 1 bit | DWORD **- fWin** | 0x1 | +| 1 bit | DWORD **- fRisc** | 0x0 | +| 1 bit | DWORD **- fBeta** | 0x0 | +| 1 bit | DWORD **- fWinAny** | 0x0 | +| 1 bit | DWORD **- fMacAny** | 0x0 | +| 1 bit | DWORD **- fBetaAny** | 0x0 | +| 2 bits | DWORD **- unused1** | 0x3 | +| 1 bit | DWORD **- fRiscAny** | 0x0 | +| 1 bit | DWORD **- fOOM** | 0x0 | +| 1 bit | DWORD **- fGlJmp** | 0x0 | +| 2 bits | DWORD **- unused2** | 0x0 | +| 1 bit | DWORD **- fFontLimit** | 0x0 | +| 4 bits | DWORD **- verXLHigh** | 0x3 | +| 1 bit | DWORD **- unused3** | 0x0 | +| 13 bits | DWORD **- reserved1** | 0x0000 | +| 8 bits | DWORD **- verLowestBiff** | 0x06 | +| 4 bits | DWORD **- verLastXLSaved** | 0x3 | +| 20 bits | DWORD **- reserved2** | 0x00000 | + +Figure 110: Structure of BOF + +**vers:** 0x0600 specifies that the file uses [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) version 6. + +**dt:** 0x0010 specifies that the records following this BOF record are part of the worksheet substream. + +**rupBuild:** 0x2013 specifies that the version of the build is 8211. + +**rupYear:** 0x07CD specifies that 1997 was the year when the file format version was first created. + +**fWin:** 0x1 specifies that the file was last edited on a Windows platform. + +**fRisc:** 0x0 specifies that the file was not lasted edited on a RISC platform. + +**fBeta:** 0x0 specifies that the file was not last edited by a [**beta**](#gt_b7cc0e52-196c-41e1-afa2-14da4352ac5d) version of the application. + +**fWinAny:** 0x0 specifies that the file has not been subsequently saved. + +**fMacAny:** 0x0 specifies that the file has never been edited on a Macintosh platform. + +**fBetaAny:** 0x0 specifies that the file has never edited on a beta version of the application. + +**fRiscAny:** 0x0 specifies that the file has never been edited on a RISC platform. + +**fOOM:** 0x0 specifies that the file never had an [**out-of-memory**](#gt_1607fcec-cc19-40a2-9a61-678f90f5943e) failure. + +**fGlJmp:** 0x0 specifies that this file has never had an out-of-memory failure during rendering. + +**fFontLimit:** 0x0 specifies that the file has never reached the 255 [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) limit. + +**verXLHigh:** 0x3 specifies that the file was not edited in any applications after Office Excel 2003. + +**verLowestBiff:** 0x06 specifies that the file is saved in BIFF version 6. + +**verLastXLSaved:** 0x3 specifies that the file was last saved on Office Excel 2003. + +### Workbook: Index + +The next record is an [Index](#index) record that specifies row information and the file locations for all [DBCell](#dbcell) records corresponding to each row block in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). This record, combined with the DBCell records, is used to optimize the [lookup of cells](#Section_24bbaffdab88489e983f3c400c8a8559) in a [cell table](#Section_d690007dd25c4822a650b24c13288bb7). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------|------------| +| 0014 | Index **- Index** | | +| 0004 | ULONG **- reserved** | 0x00000000 | +| 0004 | [RwLongU](#rwlongu) **- rwMic** | | +| 0004 | ULONG **- rw** | 0x00000003 | +| 0004 | ULONG **- rwMac** | 0x00000007 | +| 0004 | FilePointer **- ibXF** | 0x00000686 | +| 0004 | RgibRw **- rgibRw** | | +| 0004 | FilePointer **- rgibRw\[0\]** | 0x0000073E | + +Figure 111: Structure of Index + +**rwMic:** Specifies the first row that has a cell with data. + +**rwMic.rw:** 0x00000003 specifies that row 4 is the first row with data or formatting. + +**rwMac:** 0x00000007 specifies that row 7 is the last row with data or formatting. This field value specifies the row after the last row that has data or formatting. + +**ibXF:** 0x00000686 specifies a FilePointer as specified in [\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.2.1.5 that specifies the file position of the [DefColWidth](#defcolwidth) record in this sheet. + +**rgibRw.rgibRw\[0\]:** 0x0000073E specifies the file position of the DBCell record. This stream position is the start of the binary record, which begins with the two-byte record type and two-byte record size information. See the [record](#Section_170e90ce87d747589331dcf14cd72388) overview for more details. + +The records following this record, and before the next [DefaultRowHeight](#defaultrowheight) record, are omitted for brevity. + +### Workbook: DefaultRowHeight + +The next record is a [DefaultRowHeight](#defaultrowheight) record that specifies the height of all empty rows in the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------------|-----------| +| 0004 | DefaultRowHeight **- DefaultRowHeight** | | +| 1 bit | USHORT **- fUnsynced** | 0x0 | +| 1 bit | USHORT **- fDyZero** | 0x0 | +| 1 bit | USHORT **- fExAsc** | 0x0 | +| 1 bit | USHORT **- fExDsc** | 0x0 | +| 12 bits | USHORT **- reserved** | 0x000 | +| 0002 | SHORT **- miyRw** | 0x00FF | + +Figure 112: Structure of DefaultRowHeight + +**fUnsynced:** 0x0 specifies that default settings for the row height have not changed. + +**fDyZero:** 0x0 specifies that empty rows do not have a height of zero. + +**fExAsc:** 0x0 specifies that empty rows do not have a thick [**border style**](#gt_2baf659e-8e18-4f60-b3d0-ce0b8e1f2eab) applied to the top [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c). + +**fExDsc:** 0x0 specifies that empty rows do not have a thick border style applied to the bottom border. + +**miyRw:** 0x00FF specifies 255 [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382) as the default row height for empty rows. + +### Workbook: WsBool + +The next record is a [WsBool](#wsbool) record that specifies information about a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------|-----------| +| 0002 | WsBool **- WsBool** | | +| 1 bit | USHORT **- fShowAutoBreaks** | 0x1 | +| 3 bits | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fDialog** | 0x0 | +| 1 bit | USHORT **- fApplyStyles** | 0x0 | +| 1 bit | USHORT **- fRowSumsBelow** | 0x1 | +| 1 bit | USHORT **- fColSumsRight** | 0x1 | +| 1 bit | USHORT **- fFitToPage** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 2 bits | USHORT **- unused** | 0x1 | +| 1 bit | USHORT **- fSyncHoriz** | 0x0 | +| 1 bit | USHORT **- fSyncVert** | 0x0 | +| 1 bit | USHORT **- fAltExprEval** | 0x0 | +| 1 bit | USHORT **- fAltFormulaEntry** | 0x0 | + +Figure 113: Structure of WsBool + +**fShowAutoBreaks:** 0x0001 specifies that [**page breaks**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871) inserted automatically on the sheet are [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72). + +**fDialog:** 0x0000 specifies that the sheet is not a [**dialog sheet**](#gt_293d2e0c-de3d-4808-99fc-99fa824158a8). + +**fApplyStyles:** 0x0000 specifies not to apply styles in an [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) when an outline is applied. + +**fRowSumsBelow:** 0x0001 specifies that summary rows appear below an outline’s detail rows. + +**fColSumsRight:** 0x0001 specifies that summary columns appear on the left if the sheet is displayed [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067) or appear on the right if the sheet is displayed [**right-to-left**](#gt_91359688-7863-4e88-b507-f57b3dada5ec). + +**fFitToPage:** 0x0000 specifies that printable contents do not have to fit to a single page when the sheet is printed. + +**fSyncHoriz:** 0x0000 specifies that horizontal scrolling is not synchronized across multiple windows displaying this sheet. + +**fSyncVert:** 0x0000 specifies that vertical scrolling is not synchronized across multiple windows displaying this sheet. + +**fAltExprEval:** 0x0000 specifies that the sheet does not use [**transition formula evaluation**](#gt_47a54c6a-a541-44ae-a0a9-acf78ab8a331). + +**fAltFormulaEntry:** 0x0000 specifies that the sheet does not use [**transition formula entry**](#gt_fd2c615c-ad67-4b97-bde4-7827b37196eb). + +The records following this record, and before the next [Setup](#setup) record, are omitted for brevity. + +### Workbook: Setup + +The next record is a [Setup](#setup) record that specifies the page-format settings used to print the current [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|--------------------| +| 0022 | Setup **- Setup** | | +| 0002 | USHORT **- iPaperSize** | 0x0000 | +| 0002 | USHORT **- iScale** | 0x00FF | +| 0002 | SHORT **- iPageStart** | 0x0001 | +| 0002 | USHORT **- iFitWidth** | 0x0001 | +| 0002 | USHORT **- iFitHeight** | 0x0001 | +| 1 bit | BYTE **- fLeftToRight** | 0x0 | +| 1 bit | BYTE **- fPortrait** | 0x0 | +| 1 bit | BYTE **- fNoPls** | 0x1 | +| 1 bit | BYTE **- fNoColor** | 0x0 | +| 1 bit | BYTE **- fDraft** | 0x0 | +| 1 bit | BYTE **- fNotes** | 0x0 | +| 1 bit | BYTE **- fNoOrient** | 0x0 | +| 1 bit | BYTE **- fUsePage** | 0x0 | +| 1 bit | BYTE **- unused1** | 0x0 | +| 1 bit | BYTE **- fEndNotes** | 0x0 | +| 2 bits | BYTE **- iErrors** | 0x0 | +| 4 bits | BYTE **- unused2** | 0x0 | +| 0002 | USHORT **- iRes** | 0x0015 | +| 0002 | USHORT **- iVRes** | 0x0000 | +| 0008 | Double **- numHdr** | 0x3FE0000000000000 | +| 0008 | Double **- numFtr** | 0x3FE0000000000000 | +| 0002 | USHORT **- iCopies** | 0x3030 | + +Figure 114: Structure of Setup + +Fields in this record that are ignored because **fNoPls** is 1 are omitted for brevity. + +**iFitWidth:** 0x0001 specifies that the sheet width is fit to one page. + +**iFitHeight:** 0x0001 specifies that the sheet height is fit to one page. + +**fLeftToRight:** 0x00 specifies that the pages are printed in columns. + +**fNoPls:** 0x01 specifies that fields **iPaperSize**, **iScale**, **iRes**, **iVRes**, **iCopies, fNoOrient**, and **fPortrait** data are undefined and ignored. + +**fNoColor:** 0x00 specifies that the workbook is not printed in black and white. + +**fDraft:** 0x00 specifies that the workbook is not printed using draft quality. + +**fNotes:** 0x00 specifies that cell notes are not printed. The **fEndNotes** field is not included in this example for brevity. + +**fUsePage:** 0x00 specifies that no custom starting page number is being used to print. The **iPageStart** field is not included in this example for brevity. + +**iErrors:** 0x00 specifies that errors in the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) data are printed as displayed on the sheet. + +**numHdr:** 0x3FE0000000000000 specifies that the header margin is .5 inches. + +**numFtr:** 0x3FE0000000000000 specifies that the footer margin is .5 inches. + +### Workbook: DefColWidth + +The next record is a [DefColWidth](#defcolwidth) record that specifies the default column width of a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------|-----------| +| 0002 | DefColWidth **- DefColWidth** | | +| 0002 | USHORT **- cchdefColWidth** | 0x0008 | + +Figure 115: Structure of DefColWidth + +**cchdefColWidth:** 0x0008 specifies that the default width of the columns in the sheet is 8 characters. + +### Workbook: Dimensions + +The next record is a [Dimensions](#dimensions) record that specifies the minimum and maximum bounds of all [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on the sheet that contain data or formatting. + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------|------------| +| 000E | Dimensions **- Dimensions** | | +| 0004 | [RwLongU](#rwlongu) **- rwMic** | | +| 0004 | ULONG **- rw** | 0x00000003 | +| 0004 | ULONG **- rwMac** | 0x00000007 | +| 0002 | [ColU](#colu) **- colMic** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | USHORT **- colMac** | 0x0002 | +| 0002 | USHORT **- reserved** | 0x0000 | + +Figure 116: Structure of Dimensions + +**rwMic:** Specifies the first row in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that contains a cell with data or formatting. + +**rwMic.rw:** 0x00000003 specifies that the first row with data or formatting is row 4. + +**rwMac:** 0x00000007 specifies that that row 7 is the last row with data or formatting. This field value specifies the row after the last row that has data or formatting. + +**colMic:** Specifies the first column in the sheet that contains a cell with data or formatting. + +**colMic.col:** 0x0001 specifies that column B is the first column with data or formatting. + +**colMac:** 0x0002 specifies that column B is the last column with data or formatting. This field value specifies the column after the last column that has data or formatting. + +### Workbook: Row 1 + +This record is a [Row](#row) record that specifies a single row on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|------------------------|-----------| +| 0010 | Row **- Row** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0003 | +| 0002 | USHORT **- colMic** | 0x0001 | +| 0002 | USHORT **- colMac** | 0x0002 | +| 0002 | USHORT **- miyRw** | 0x00FF | +| 0002 | SHORT **- reserved1** | 0x0000 | +| 0002 | SHORT **- unused1** | 0x0000 | +| 3 bits | BYTE **- iOutLevel** | 0x0 | +| 1 bit | BYTE **- reserved2** | 0x0 | +| 1 bit | BYTE **- fCollapsed** | 0x0 | +| 1 bit | BYTE **- fDyZero** | 0x0 | +| 1 bit | BYTE **- fUnsynced** | 0x0 | +| 1 bit | BYTE **- fGhostDirty** | 0x0 | +| 0001 | BYTE **- reserved3** | 0x01 | +| 12 bits | SHORT **- ixfe_val** | 0x00F | +| 1 bit | SHORT **- fExAsc** | 0x0 | +| 1 bit | SHORT **- fExDes** | 0x0 | +| 1 bit | SHORT **- fPhonetic** | 0x0 | +| 1 bit | SHORT **- unused2** | 0x0 | + +Figure 117: Structure of Row + +**rw:** Specifies the row index. + +**rw.rw:** 0x0003 specifies that this record is for row 4. + +**colMic:** 0x0001 specifies that column B is the first column that contains a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) populated with data or formatting. + +**colMac:** 0x0002 specifies that column B is the last column that contains a cell populated with data or formatting. + +**miyRw:** 0x00FF specifies the row height as 255 [**twips**](#gt_4b82472c-103d-4eff-a07e-6a0f784e3382). + +**iOutLevel:** 0x00 specifies the row has no [**outline level**](#gt_a5cd5eff-ddeb-490b-bc71-f6256774e3c3). + +**fDyZero:** 0x00 specifies that the row is not [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd). + +**fUnsynced:** 0x00 specifies that the row height has not been manually set. + +**fGhostDirty:** 0x00 specifies that the row has not been formatted. + +**ixfe_val:** 0x000F specifies that this row uses the default formatting. + +**fExAsc:** 0x0000 specifies that no cell in the row has a thick top [**border**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c). + +**fExDes:** 0x0000 specifies that no cell in the row has a thick bottom border. + +**fPhonetic:** 0x0000 specifies that [**phonetic guide**](#gt_f5ae2680-242d-4731-8f12-da90d5d7f09f) is not enabled for any cell in this row. + +### Workbook: Row 2 + +This record is another [Row](#row) record that specifies a single row on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|------------------------|-----------| +| 0010 | Row **- Row** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0004 | +| 0002 | USHORT **- colMic** | 0x0001 | +| 0002 | USHORT **- colMac** | 0x0002 | +| 0002 | USHORT **- miyRw** | 0x00FF | +| 0002 | SHORT **- reserved1** | 0x0000 | +| 0002 | SHORT **- unused1** | 0x0000 | +| 3 bits | BYTE **- iOutLevel** | 0x0 | +| 1 bit | BYTE **- reserved2** | 0x0 | +| 1 bit | BYTE **- fCollapsed** | 0x0 | +| 1 bit | BYTE **- fDyZero** | 0x0 | +| 1 bit | BYTE **- fUnsynced** | 0x0 | +| 1 bit | BYTE **- fGhostDirty** | 0x0 | +| 0001 | BYTE **- reserved3** | 0x01 | +| 12 bits | SHORT **- ixfe_val** | 0x00F | +| 1 bit | SHORT **- fExAsc** | 0x0 | +| 1 bit | SHORT **- fExDes** | 0x0 | +| 1 bit | SHORT **- fPhonetic** | 0x0 | +| 1 bit | SHORT **- unused2** | 0x0 | + +Figure 118: Structure of Row + +Fields in this record that are explained in previous records in this example are omitted for brevity. + +**rw.rw:** 0x0004 specifies that this record is for row 5. + +### Workbook: Row 3 + +This record is another [Row](#row) record that specifies a single row on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|------------------------|-----------| +| 0010 | Row **- Row** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0005 | +| 0002 | USHORT **- colMic** | 0x0001 | +| 0002 | USHORT **- colMac** | 0x0002 | +| 0002 | USHORT **- miyRw** | 0x00FF | +| 0002 | SHORT **- reserved1** | 0x0000 | +| 0002 | SHORT **- unused1** | 0x0000 | +| 3 bits | BYTE **- iOutLevel** | 0x0 | +| 1 bit | BYTE **- reserved2** | 0x0 | +| 1 bit | BYTE **- fCollapsed** | 0x0 | +| 1 bit | BYTE **- fDyZero** | 0x0 | +| 1 bit | BYTE **- fUnsynced** | 0x0 | +| 1 bit | BYTE **- fGhostDirty** | 0x0 | +| 0001 | BYTE **- reserved3** | 0x01 | +| 12 bits | SHORT **- ixfe_val** | 0x00F | +| 1 bit | SHORT **- fExAsc** | 0x0 | +| 1 bit | SHORT **- fExDes** | 0x0 | +| 1 bit | SHORT **- fPhonetic** | 0x0 | +| 1 bit | SHORT **- unused2** | 0x0 | + +Figure 119: Structure of Row + +Fields in this record that are explained in previous records in this example are omitted for brevity. + +**rw.rw:** 0x0005 specifies that this record is for row 6. + +### Workbook: Row 4 + +This record is another [Row](#row) record that specifies a single row on a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|------------------------|-----------| +| 0010 | Row **- Row** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0006 | +| 0002 | USHORT **- colMic** | 0x0001 | +| 0002 | USHORT **- colMac** | 0x0002 | +| 0002 | USHORT **- miyRw** | 0x00FF | +| 0002 | SHORT **- reserved1** | 0x0000 | +| 0002 | SHORT **- unused1** | 0x0000 | +| 3 bits | BYTE **- iOutLevel** | 0x0 | +| 1 bit | BYTE **- reserved2** | 0x0 | +| 1 bit | BYTE **- fCollapsed** | 0x0 | +| 1 bit | BYTE **- fDyZero** | 0x0 | +| 1 bit | BYTE **- fUnsynced** | 0x0 | +| 1 bit | BYTE **- fGhostDirty** | 0x0 | +| 0001 | BYTE **- reserved3** | 0x01 | +| 12 bits | SHORT **- ixfe_val** | 0x00F | +| 1 bit | SHORT **- fExAsc** | 0x0 | +| 1 bit | SHORT **- fExDes** | 0x0 | +| 1 bit | SHORT **- fPhonetic** | 0x0 | +| 1 bit | SHORT **- unused2** | 0x0 | + +Figure 120: Structure of Row + +Fields in this record that are explained in previous records in this example are omitted for brevity. + +**rw.rw:** 0x0006 specifies that this record is for row 7. + +### Workbook: LabelSst 1 + +This record is a [LabelSst](#labelsst) record that specifies a string that is stored in a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) as a reference to the shared string table. + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|------------| +| 000A | LabelSst **- LabelSst** | | +| 0006 | [Cell](#cell) **- cell** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0003 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x000F | +| 0004 | ULONG **- isst** | 0x00000000 | + +Figure 121: Structure of LabelSst + +**cell:** Specifies a cell in a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**cell.rw:** Specifies a row in the sheet. + +**cell.rw.rw:** 0x0003 specifies row 4. + +**cell.col:** Specifies a column in the sheet. + +**cell.col.col:** 0x0001 specifies column B. + +**cell.ixfe:** Specifies the index of a [cell XF](#Section_518a740d71c640c8bb97e7df6915861a) record that describes the formatting properties for the cell. + +**cell.ixfe.ixfe:** 0x000F specifies that this cell uses the default cell format. + +**isst:** 0x00000000 specifies that 0 is the zero-based index into the **rgb** field of [SST](#sst), which specifies that the text for this cell is "Number". + +### Workbook: RK + +This record is an [RK](#rk) record that specifies the numeric data contained in a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|------------| +| 000A | RK **- Rk** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0004 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0006 | [RkRec](#rkrec) **- rkrec** | | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x000F | +| 0004 | [RkNumber](#rknumber) **- RK** | | +| 1 bit | ULONG **- FX100** | 0x0 | +| 1 bit | ULONG **- FInt** | 0x0 | +| 30 bits | ULONG **- num** | 0x0FFC0000 | + +Figure 122: Structure of Rk + +**rw:** Specifies a row in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**rw.rw:** 0x0004 specifies row 5. + +**col:** Specifies a column in the sheet. + +**col.col:** 0x0001 specifies column B. + +**rkrec:** Specifies the numeric data for this cell. + +**rkrec.ixfe:** Specifies the index of a [cell XF](#Section_518a740d71c640c8bb97e7df6915861a) record that describes the formatting properties for the cell. + +**rkrec.ixfe.ixfe:** 0x000F specifies that this cell uses the default cell format. + +**rkrec.RK:** An RkNumber that specifies a numeric value. + +**rkrec.RK.FX100:** 0x0 specifies that the value in the **rkrec.RK.num** field was not multiplied by 100 when it was saved. + +**rkrec.RK.FInt:** 0x0 specifies that the value in the **rkrec.RK.num** field is the 30 most significant bits of a 64-bit binary floating-point number as defined in [\[IEEE754\]](https://go.microsoft.com/fwlink/?LinkId=89903). + +**rkrec.RK.num:** 0x0FFC0000 specifies the 30 most significant bits of a 64-bit binary floating-point number as defined in \[IEEE754\]. The remaining 34 bits are 0, which evaluates to a numeric value of 1. + +### Workbook: LabelSst 2 + +This record is a [LabelSst](#labelsst) record that specifies a string that is stored in a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) as a reference to the shared string table. + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|------------| +| 000A | LabelSst **- LabelSst** | | +| 0006 | [Cell](#cell) **- cell** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0005 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x000F | +| 0004 | ULONG **- isst** | 0x00000001 | + +Figure 123: Structure of LabelSst + +Fields in this record that are explained in previous records in this example are omitted for brevity. + +**cell.rw.rw:** 0x0005 specifies row 6. + +**isst:** 0x00000001 specifies that 1 is the zero-based index into the **rgb** field of [SST](#sst), which specifies that the text for this cell is "Formula". + +### Workbook: Formula + +This record is a [Formula](#formula) record that specifies a formula (section [2.2.2](#Section_e7625cc83da94154b44949cf1bbd9703)) for a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0022 | Formula **- Formula** | | +| 0006 | [Cell](#cell) **- cell** | | +| 0002 | [Rw](#rw) **- rw** | | +| 0002 | USHORT **- rw** | 0x0006 | +| 0002 | [Col](#col) **- col** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | [IXFCell](#ixfcell) **- ixfe** | | +| 0002 | USHORT **- ixfe** | 0x000F | +| 0008 | [FormulaValue](#formulavalue) **- val** | 0x3FF6A09E667F3BCD | +| 1 bit | USHORT **- fAlwaysCalc** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFill** | 0x0 | +| 1 bit | USHORT **- fShrFmla** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 1 bit | USHORT **- fClearErrors** | 0x0 | +| 10 bits | USHORT **- reserved3** | 0x000 | +| 0004 | DWORD **- chn** | 0xFCFC000C | +| 000E | [CellParsedFormula](#cellparsedformula) **- formula** | | +| 0002 | WORD **- cce** | 0x000C | +| 000C | [Rgce](#rgce) **- rgce** | | +| 0005 | [Ptg](#ptg) **- Ptg\[0\]** | | +| 0005 | [PtgRef](#ptgref) **- PtgRef** | | +| 5 bits | BYTE **- ptg** | 0x04 | +| 2 bits | BYTE **- type** | 0x2 | +| 1 bit | BYTE **- reserved** | 0x0 | +| 0004 | [RgceLoc](#rgceloc) **- loc** | | +| 0002 | [RwU](#rwu) **- row** | | +| 0002 | USHORT **- rw** | 0x0004 | +| 0002 | [ColRelU](#colrelu) **- column** | | +| 14 bits | USHORT **- col** | 0x0001 | +| 1 bit | USHORT **- colRelative** | 0x1 | +| 1 bit | USHORT **- rowRelative** | 0x1 | +| 0003 | Ptg **- Ptg\[1\]** | | +| 0003 | [PtgInt](#ptgint) **- PtgInt** | | +| 7 bits | BYTE **- ptg** | 0x1E | +| 1 bit | BYTE **- reserved0** | 0x0 | +| 0002 | WORD **- integer** | 0x0002 | +| 0001 | Ptg **- Ptg\[2\]** | | +| 0001 | [PtgMul](#ptgmul) **- PtgMul** | | +| 7 bits | BYTE **- ptg** | 0x05 | +| 1 bit | BYTE **- reserved0** | 0x0 | +| 0003 | Ptg **- Ptg\[3\]** | | +| 0003 | [PtgFunc](#ptgfunc) **- PtgFunc** | | +| 5 bits | BYTE **- ptg** | 0x01 | +| 2 bits | BYTE **- type** | 0x2 | +| 1 bit | BYTE **- reserved** | 0x0 | +| 0002 | [Ftab](#ftab) **- iftab** | | +| 0002 | WORD **- iftab** | 0x0014 | + +Figure 124: Structure of Formula + +**cell:** Specifies a cell on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**cell.rw:** Specifies the row of the cell. + +**cell.rw.rw:** 0x0006 specifies row 7. + +**cell.col:** Specifies the column of the cell. + +**cell.col.col:** 0x0001 specifies column B. + +**cell.ixfe:** Specifies the index of a [cell XF](#Section_518a740d71c640c8bb97e7df6915861a) record that describes the formatting properties for the cell. + +**cell.ixfe.ixfe:** 0x000F specifies that this cell uses the default cell format. + +**val:** 0x3FF6A09E667F3BCD specifies the floating-point value of 1.4142135623731, which is the value in the cell as a result of the last calculation. + +**fAlwaysCalc:** 0x0 specifies that the formula does not need to be recalculated. + +**fFill:** 0x0 specifies this cell does not have a [**fill alignment**](#gt_cfc4e171-6104-470e-9ebb-812afea17078) or a [**center-across-selection alignment**](#gt_ef7324bd-dac8-46e2-8df5-db44d8b925a8). + +**fShrFmla:** 0x0 specifies that the formula is not part of a shared formula. + +**fClearErrors:** 0x0 specifies that the formula is not excluded from [**formula error checking**](#gt_c28d38d6-c6d1-4d06-89c2-29816f9c5b23). + +**chn:** Specifies an application-specific cache. This is optionally used and can be ignored. + +**formula:** Specifies a formula. + +**formula.cce:** 0x000C specifies the length of **rgce** in bytes. + +**formula.rgce:** Specifies the sequence of Ptgs for the formula SQRT(B5\*2). + +**formula.rgce.Ptg\[0\]:** Specifies a single element of a formula. + +**formula.rgce.Ptg\[0\].PtgRef:** Specifies a reference to a single cell on the current sheet. + +**formula.rgce.Ptg\[0\].PtgRef.ptg:** 0x04 specifies that this Ptg is a PtgRef. + +**formula.rgce.Ptg\[0\].PtgRef.type:** 0x2 specifies that this PtgRef uses a value data type. + +**formula.rgce.Ptg\[0\].PtgRef.loc:** Specifies the cell referenced by this Ptg. + +**formula.rgce.Ptg\[0\].PtgRef.loc.row:** Specifies the row of the referenced cell. + +**formula.rgce.Ptg\[0\].PtgRef.loc.row.rw:** 0x0004 specifies that the referenced cell is in row 5. + +**formula.rgce.Ptg\[0\].PtgRef.loc.column:** Specifies the column of the referenced cell. + +**formula.rgce.Ptg\[0\].PtgRef.loc.column.col:** 0x0001 specifies that the referenced cell is in column B. + +**formula.rgce.Ptg\[0\].PtgRef.loc.column.colRelative:** 0x1 specifies that the column reference is a [**relative reference**](#gt_238687e6-aab3-40c3-ac9f-6107236df2ac). + +**formula.rgce.Ptg\[0\].PtgRef.loc.column.rowRelative:** 0x1 specifies that the row reference is a relative reference. + +**formula.rgce.Ptg\[1\]:** Specifies a single element of a formula. + +**formula.rgce.Ptg\[1\].PtgInt:** Specifies an integer value. + +**formula.rgce.Ptg\[1\].PtgInt.ptg:** 0x1E specifies that this is a PtgInt. + +**formula.rgce.Ptg\[1\].PtgInt.integer:** 0x0002 specifies that the value is 2. + +**formula.rgce.Ptg\[2\]:** Specifies a single element of a formula. + +**formula.rgce.Ptg\[2\].PtgMul:** Specifies a binary-value-operator that multiplies the first and second expressions in a binary-value-expression. + +**formula.rgce.Ptg\[2\].PtgMul.ptg:** 0x05 specifies that this Ptg is a PtgMul. + +**formula.rgce.Ptg\[3\]:** Specifies a single element of a formula. + +**formula.rgce.Ptg\[3\].PtgFunc:** Specifies a mathematical function. + +**formula.rgce.Ptg\[3\].PtgFunc.ptg:** 0x01 specifies that this is a PtgFunc. + +**formula.rgce.Ptg\[3\].PtgFunc.type:** 0x2 specifies that this Ptg uses a value data type. + +**formula.rgce.Ptg\[3\].PtgFunc.iftab:** Specifies the function to be called for this Ptg. + +**formula.rgce.Ptg\[3\].PtgFunc.iftab.iftab:** 0x0014 specifies that SQRT is the function to be called. + +### Workbook: DBCell + +This record is a [DBCell](#dbcell) record that specifies the location of the first row and the first cell record in each row of the current row block in the [workbook stream](#Section_f682f4b08c6b444e83f852d156f1e8ba). + +| **Size** | **Structure** | **Value** | +|----------|------------------------|------------| +| 000C | DBCell **- DbCell** | | +| 0004 | ULONG **- dbRtrw** | 0x000000A0 | +| 0008 | Rgdb **- rgdb** | | +| 0002 | USHORT **- rgdb\[0\]** | 0x003C | +| 0002 | USHORT **- rgdb\[1\]** | 0x000E | +| 0002 | USHORT **- rgdb\[2\]** | 0x000E | +| 0002 | USHORT **- rgdb\[3\]** | 0x000E | + +Figure 125: Structure of DbCell + +**dbRtrw:** 0x000000A0 specifies the offset from the file position of this record to the file position of the first row record. + +**rgdb:** Specifies the file offset to the first cell record in each row. + +**rgdb.rgdb\[0\]:** 0x003C specifies the file offset in bytes to the first record that specifies a [CELL](#common-productions) in each row that is a part of this row block. The starting position of this offset is specified relative to the file position of the end of the first [Row](#row) record in the row block + +**rgdb.rgdb\[1\]:** 0x000E specifies the file offset in bytes to the first record that specifies a CELL in each row that is a part of this row block. The offset is specified relative to the file position of the CELL record specified by the previous element in this array. + +**rgdb.rgdb\[2\]:** 0x000E specifies the file offset in bytes to the first record that specifies a CELL in each row that is a part of this row block. The offset is specified relative to the file position of the CELL record specified by the previous element in this array. + +**rgdb.rgdb\[3\]:** 0x000E specifies the file offset in bytes to the first record that specifies a CELL in each row that is a part of this row block. The offset is specified relative to the file position of the CELL record specified by the previous element in this array. + +### Workbook: Window2 + +This record is a [Window2](#window2) record that specifies attributes of the window used to display the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------|-----------| +| 0012 | Window2 **- Window2** | | +| 1 bit | USHORT **- fDspFmlaRt** | 0x0 | +| 1 bit | USHORT **- fDspGridRt** | 0x1 | +| 1 bit | USHORT **- fDspRwColRt** | 0x1 | +| 1 bit | USHORT **- fFrozenRt** | 0x0 | +| 1 bit | USHORT **- fDspZerosRt** | 0x1 | +| 1 bit | USHORT **- fDefaultHdr** | 0x1 | +| 1 bit | USHORT **- fRightToLeft** | 0x0 | +| 1 bit | USHORT **- fDspGuts** | 0x1 | +| 1 bit | USHORT **- fFrozenNoSplit** | 0x0 | +| 1 bit | USHORT **- fSelected** | 0x1 | +| 1 bit | USHORT **- fPaged** | 0x1 | +| 1 bit | USHORT **- fSLV** | 0x0 | +| 4 bits | USHORT **- reserved1** | 0x0 | +| 0002 | [RwU](#rwu) **- rwTop** | | +| 0002 | USHORT **- rw** | 0x0000 | +| 0002 | [ColU](#colu) **- colLeft** | | +| 0002 | USHORT **- col** | 0x0000 | +| 0002 | [Icv](#icv) **- icvHdr** | | +| 0002 | USHORT **- icv** | 0x0040 | +| 0002 | USHORT **- reserved2** | 0x0000 | +| 0002 | USHORT **- wScaleSLV** | 0x0000 | +| 0002 | USHORT **- wScaleNormal** | 0x0000 | +| 0002 | USHORT **- unused** | 0x0000 | +| 0002 | USHORT **- reserved3** | 0x0000 | + +Figure 126: Structure of Window2 + +**fDspFmlaRt:** 0x0 specifies that this window displays values. + +**fDspGridRt:** 0x1 specifies that this window displays [**gridlines**](#gt_82f8a326-64b0-4506-a18e-930f7c2c95b9). + +**fDspRwColRt:** 0x1 specifies that this window displays row headings and column headings. + +**fFrozenRt:** 0x0 specifies that the panes in the window are not [**frozen**](#gt_1e984b7c-9760-4832-88c8-798e30f845db). The **fFrozenNoSplit** field is not included in this example for brevity. + +**fDspZerosRt:** 0x1 specifies that this window displays each [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that has a value of zero as a zero. + +**fDefaultHdr:** 0x1 specifies that the gridlines of this window are drawn in the default [**foreground color**](#gt_6710b91a-10b4-4df0-885f-99e53e7f816a) of the window. + +**fRightToLeft:** 0x0 specifies that the text is displayed [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067). + +**fDspGuts:** 0x1 specifies that this window displays the [**outline state**](#gt_595fa0de-0130-489d-ba83-fbba78917310). + +**fSelected:** 0x1 specifies that the [**sheet tab**](#gt_3b131045-238c-4ce8-9c22-b6aac874c7c5) is [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595). + +**fPaged:** 0x1 specifies that the sheet is currently being displayed in the window. + +**fSLV:** 0x0 specifies that the sheet is not in [**Page Break Preview view**](#gt_a7342c25-b4fd-4c84-9922-ae9c4a92d180). + +**rwTop.rw:** 0x0000 specifies row 1 as the first visible row on the sheet. + +**colLeft.col:** 0x0000 specifies column 1 as the first visible column on the sheet. + +**icvHdr.icv:** 0x0040 specifies that the gridlines of this window are drawn in the default foreground color of the window. + +**wScaleSLV:** 0x0000 specifies that the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) in the Page Break Preview view is the default zoom level. + +**wScaleNormal:** 0x0000 specifies that the zoom level in the [**Normal view**](#gt_b3c343ae-05ca-4b91-9cc1-383ee3563990) is the default zoom level. + +### Workbook: Selection + +This record is a [Selection](#selection) record that specifies the [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------------|-----------| +| 000F | Selection **- Selection** | | +| 0001 | [PaneType](#panetype) **- pnn** | 0x03 | +| 0002 | [RwU](#rwu) **- rwAct** | | +| 0002 | USHORT **- rw** | 0x0007 | +| 0002 | [ColU](#colu) **- colAct** | | +| 0002 | USHORT **- col** | 0x0001 | +| 0002 | USHORT **- irefAct** | 0x0000 | +| 0002 | USHORT **- cref** | 0x0001 | +| 0006 | [SqRefU](#sqrefu) **- rgref** | | +| 0006 | [RefU](#refu) **- rgref\[0\]** | | +| 0002 | RwU **- rwFirst** | | +| 0002 | USHORT **- rw** | 0x0007 | +| 0002 | RwU **- rwLast** | | +| 0002 | USHORT **- rw** | 0x0007 | +| 0001 | [ColByteU](#colbyteu) **- colFirst** | | +| 0001 | BYTE **- col** | 0x01 | +| 0001 | ColByteU **- colLast** | | +| 0001 | BYTE **- col** | 0x01 | + +Figure 127: Structure of Selection + +**pnn:** 0x03 specifies that a top left pane is the [**active pane**](#gt_33f49274-001d-40a3-bcca-f54a93906c29). + +**rwAct:** An RwU that specifies the row number of the [**active cell**](#gt_2c0759a5-6721-422b-8cb9-f4bb09e07c84). + +**rwAct.rw:** 0x0007 specifies that row 8 contains the active cell. + +**colAct:** A ColU that specifies the column number of the active cell. + +**colAct.col:** 0x0001 specifies that column B contains the active cell. + +**irefAct:** 0x0000 specifies an index into the **rgref** array that specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells that contain the active cell. + +**cref:** 0x0001 specifies that there is 1 range of cells in the **rgref** array of this record. + +**rgref:** An array of RefU that specifies ranges of selected cells in the sheet. + +**rgref.rgref\[0\]:** Specifies a range of cells on the sheet. + +**rgref.rgref\[0\].rwFirst:** An RwU that specifies the first row in the range. + +**rgref.rgref\[0\].rwFirst.rw:** 0x0007 specifies that row 8 is the first row in the range. + +**rgref.rgref\[0\].rwLast:** Specifies the last row in the range. + +**rgref.rgref\[0\].rwLast.rw:** 0x0007 specifies that row 8 is the last row in the range. + +**rgref.rgref\[0\].colFirst:** A ColByteU that specifies the first column in the range. + +**rgref.rgref\[0\].colFirst.col:** 0x01 specifies that column B is the first column in the range. + +**rgref.rgref\[0\].colLast:** A ColByteU that specifies the last column in the range. + +**rgref.rgref\[0\].colLast.col:** 0x01 specifies that column B is the last column in the range. + +### Workbook: PhoneticInfo + +This record is a [PhoneticInfo](#phoneticinfo) record that specifies the default format for [**phonetic strings**](#gt_7947dcd6-cb7d-4957-ada6-6e832b075e77) and the [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that have [**visible**](#gt_81648495-ee6b-4cfd-955a-89fc643d3b72) phonetic strings. + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------|-----------| +| 0006 | PhoneticInfo **- PhoneticInfo** | | +| 0004 | [Phs](#phs) **- phs** | | +| 0002 | [FontIndex](#fontindex) **- ifnt** | | +| 0002 | USHORT **- ifnt** | 0x0000 | +| 2 bits | USHORT **- phType** | 0x3 | +| 2 bits | USHORT **- alcH** | 0x1 | +| 12 bits | USHORT **- unused** | 0x003 | +| 0002 | [SqRef](#sqref) **- sqref** | | +| 0002 | USHORT **- cref** | 0x0000 | + +Figure 128: Structure of PhoneticInfo + +**phs:** A Phs structure that specifies the default format for phonetic string on the sheet. + +**phs.ifnt:** A FontIndex structure that specifies the [**font**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2) for the string. + +**phs.ifnt.ifnt:** 0x0000 specifies that the default font is used. + +**phs.phType:** 0x0003 specifies that phonetic string can use any type of characters. + +**phs.alcH:** 0x0001 specifies that left alignment is used in the phonetic string. + +**sqref:** A SqRef structure that specifies the ranges of cells on the sheet that have visible phonetic strings. + +**sqref.cref:** 0x0000 specifies the number of elements in **rgrefs**. The **rgrefs** field is not included in this example for brevity. + +### Workbook: EOF 2 + +This record is an [EOF](#eof) record which specifies the end of a collection of records for this [worksheet](#Section_f41c06f2905749a18c3fa4a4d211fc56) substream. + +| **Size** | **Structure** | +|----------|---------------| +| 0000 | EOF **- EOF** | + +Figure 129: Structure of EOF + +The remaining records in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) example, two Worksheet substreams, are omitted for brevity. + +## PivotTable + +This example shows a [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) and associated [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) within a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The PivotTable uses a range of cells (A1:E45) in the "Source Data" [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) as its [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). A CustomerName field and ProductName field are added to the [row area](#Section_5594c95e6819461e80706f4b4fdfa091), a Quantity field to the [data area](#Section_237a24905c614931923f7ee856f23c72), and an OrderDate field to the [page area](#Section_f10ef7d86c044d35a5830d6f2ce92063) of this PivotTable. Two dates are selected in the [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) for the OrderDate field; the other dates are filtered out from page area. This example addresses important PivotTable records, and those records that are relevant to different parts of the PivotTable from the [Workbook stream](#Section_f682f4b08c6b444e83f852d156f1e8ba) and [Pivot Cache Storage stream](#Section_c5fb3f663ef64308ae3de59244159687). + +The following figure shows a possible implementation of the PivotTable discussed in this example. + +![Example PivotTable within a sheet](media/image92.bin "Example PivotTable within a sheet") + +Figure 130: Example PivotTable within a sheet + +### PivotTable: SXStreamID + +The first record, an [SXStreamID](#sxstreamid), specifies the stream in the [PivotCache storage](#Section_c5fb3f663ef64308ae3de59244159687) that contains the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) for this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------|-----------| +| 0002 | SXStreamID **- SxStreamID** | | +| 0002 | USHORT **- idstm** | 0x0001 | + +Figure 131: Structure of SxStreamID + +**idstm:** 0x0001 specifies the identifier of the stream in the PivotCache storage that contains the PivotCache for this PivotTable. The stream identifier is a four-character string representation of the hexadecimal value. In this case the stream identifier is "0001". + +### PivotTable: SXVS + +The next record, an [SXVS](#sxvs), specifies that the type of [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) used for this [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) is a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +| **Size** | **Structure** | **Value** | +|----------|-------------------|-----------| +| 0002 | SXVS **- SXVS** | | +| 0002 | USHORT **- sxvs** | 0x0001 | + +Figure 132: Structure of SXVS + +**sxvs:** 0x0001 specifies that the source data for this PivotTable is a range. The [DConRef](#dconref) record that follows this record specifies the range. + +### PivotTable: DConRef + +The next record, a [DConRef](#dconref), specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) that is the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) for this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0016 | DConRef **- DConRef** | | +| 0006 | [RefU](#refu) **- ref** | | +| 0002 | [RwU](#rwu) **- rwFirst** | | +| 0002 | USHORT **- rw** | 0x0000 | +| 0002 | RwU **- rwLast** | | +| 0002 | USHORT **- rw** | 0x002C | +| 0001 | [ColByteU](#colbyteu) **- colFirst** | | +| 0001 | BYTE **- col** | 0x00 | +| 0001 | ColByteU **- colLast** | | +| 0001 | BYTE **- col** | 0x04 | +| 0002 | USHORT **- cchFile** | 0x000C | +| 000D | [DConFile](#dconfile) **- stFile** | | +| 000D | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- stFile** | Source Data | +| 0001 | unused **- unused** | 0x00 | + +Figure 133: Structure of DConRef + +**ref:** A RefU structure that specifies the range of the source data for this PivotTable in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) specified by **stFile**. + +**ref.rwFirst:** An RwU structure that specifies the first row in the range of the source data for this PivotTable. + +**ref.rwFirst.rw:** 0x0000 specifies that the range of the source data for this PivotTable begins in row 1 of the sheet specified by **stFile**. + +**ref.rwLast:** An RwU structure that specifies the last row in the range of the source data for this PivotTable. + +**ref.rwLast.rw:** 0x002C specifies that the range of the source data for this PivotTable ends in row 45 of the sheet specified by **stFile.** + +**ref.colFirst:** A ColByteU structure that specifies the first column in the range of the source data for this PivotTable. + +**ref.colFirst.col:** 0x00 specifies that the range of the source data for this PivotTable begins in the column A of the sheet specified by **stFile.** + +**ref.colLast:** A ColByteU structure that specifies the last column in the range of the source data for this PivotTable. + +**ref.colLast.col:** 0x04 specifies that the range of the source data for this PivotTable ends in column E of the sheet specified by **stFile**. + +**cchFile:** 0x000C specifies that **stFile** is 12 characters in length. + +**stFile:** A DConFile structure that specifies the name of the worksheet that contains the range of the source data for this PivotTable. + +**stFile.stFile:** A string, "Source Data", that specifies the name of the worksheet that contains the range of the source data for this PivotTable. + +### PivotTable: SXAddl 1 + +The next record, [SXAddl](#sxaddl), specifies additional information for this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 000C | [SXAddl_SXCCache_SXDId](#sxaddl_sxccache_sxdid) **- SXAddl** | | +| 0006 | [SXAddlHdr](#sxaddlhdr) **- hdr** | | +| 0004 | [FrtHeaderOld](#frtheaderold) **- frtHeaderOld** | | +| 0002 | USHORT **- rt** | 0x0864 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0001 | BYTE **- sxc** | 0x03 | +| 0001 | BYTE **- sxd** | 0x00 | +| 0004 | ULONG **- idCache** | 0x00000001 | +| 0002 | USHORT **- reserved** | 0x0000 | + +Figure 134: Structure of SXAddl + +**hdr:** An SXAddlHdr structure that specifies header information for this SXAddl record. + +**hdr.frtHeaderOld:** A structure that specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) type header. + +**hdr.frtHeaderOld.rt:** 0x0864 specifies the record type identifier for this record. + +**hdr.frtHeaderOld.grbitFrt:** A structure that specifies flags for **hdr.FrtHeaderOld**. + +**hdr.frtHeaderOld.grbitFrt.fFrtRef:** 0x0 specifies that this record does not specify a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +**hdr.frtHeaderOld.grbitFrt.fFrtAlert:** 0x0 specifies that the application does not alert the user about possible problems if the file is saved without the record being recognized. + +**hdr.sxc:** 0x03 specifies the current [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) as an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + +**hdr.sxd:** 0x00 specifies the type of record contained in the **data** field of the containing SXAddl record. This value specifies that the type of this SXAddl record is SXAddl_SXCCache_SXDId. + +**idCache:** 0x00000001 specifies the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) stream that is associated with this SxcCache class. + +### PivotTable: SXAddl 2 + +The next record, [SXAddl](#sxaddl), specifies additional information for this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001C | [SXAddl_SXCCache_SXDVer10Info](#sxaddl_sxccache_sxdver10info) **- SXAddl** | | +| 0006 | [SXAddlHdr](#sxaddlhdr) **- hdr** | | +| 0004 | [FrtHeaderOld](#frtheaderold) **- frtHeaderOld** | | +| 0002 | USHORT **- rt** | 0x0864 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0001 | BYTE **- sxc** | 0x03 | +| 0001 | BYTE **- sxd** | 0x02 | +| 0006 | reserved **- reserved1** | 0x000000000000 | +| 0004 | LONG **- citmGhostMax** | 0xFFFFFFFF | +| 0001 | BYTE **- bVerCacheLastRefresh** | 0x02 | +| 0001 | BYTE **- bVerCacheRefreshableMin** | 0x00 | +| 0008 | [DateAsNum](#dateasnum) **- numDateCopy** | | +| 0008 | Double **- dateNum** | 0x40E355907CBEB8CE | +| 0002 | USHORT **- reserved2** | 0x0000 | + +Figure 135: Structure of SXAddl + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**hdr:** An SXAddlHdr structure that specifies header information for this SXAddl record. + +**hdr.sxc:** 0x03 specifies the current [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) as an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + +**hdr.sxd:** 0x02 specifies the type of record contained in the **data** field of the containing SXAddl record. See class for more information. This value specifies that the type of this SXAddl record is SXAddl_SXCCache_SXDVer10Info. + +**citmGhostMax:** 0xFFFFFFFF specifies that the number of unused [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) to allow before discarding those that are unused is not determined by the file; instead, the application optimizes the number of unused cache items at run time. + +**bVerCacheLastRefresh:** 0x02 specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) with which the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) was last refreshed. + +**bVerCacheRefreshableMin:** 0x00 specifies the lowest data functionality level with which the application is allowed to [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) the PivotCache. + +**numDateCopy:** Specifies the date and time when the PivotCache was last refreshed. + +**numDateCopy.dateNum:** 0x40E355907CBEB8CE specifies a DateAsNum structure which indicates that this PivotCache was last refreshed on May 28th, 2008 at 12:21PM. + +### PivotTable: SXAddl 3 + +The next record in this example, [SXAddl](#sxaddl), specifies additional information for this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 000C | [SXAddl_SXCCache_SXDEnd](#sxaddl_sxccache_sxdend) **- SXAddl** | | +| 0006 | [SXAddlHdr](#sxaddlhdr) **- hdr** | | +| 0004 | [FrtHeaderOld](#frtheaderold) **- frtHeaderOld** | | +| 0002 | USHORT **- rt** | 0x0864 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0001 | BYTE **- sxc** | 0x03 | +| 0001 | BYTE **- sxd** | 0xFF | +| 0006 | reserved **- reserved** | 0x000000000000 | + +Figure 136: Structure of SXAddl + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**hdr:** An SXAddlHdr structure that specifies header information for this SXAddl record. + +**hdr.sxc:** 0x03 specifies the current [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) as an [SxcCache class](#Section_1681856cae2d4f64b8cc40d2702754e7). + +**hdr.sxd:** 0xFF specifies the type of record contained in the **data** field of the containing SXAddl record. See class for more information. This value specifies that the type of this SXAddl record is SXAddl_SXCCache_SXDEnd. + +### PivotTable: SxView + +The next record in this example, [SxView](#sxview), specifies the top-level [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) information for this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0042 | SxView **- SxView** | | +| 0008 | [Ref8U](#ref8u) **- ref** | | +| 0002 | [RwU](#rwu) **- rwFirst** | | +| 0002 | USHORT **- rw** | 0x0002 | +| 0002 | RwU **- rwLast** | | +| 0002 | USHORT **- rw** | 0x000A | +| 0002 | [ColU](#colu) **- colFirst** | | +| 0002 | USHORT **- col** | 0x0000 | +| 0002 | ColU **- colLast** | | +| 0002 | USHORT **- col** | 0x0002 | +| 0002 | RwU **- rwFirstHead** | | +| 0002 | USHORT **- rw** | 0x0004 | +| 0002 | RwU **- rwFirstData** | | +| 0002 | USHORT **- rw** | 0x0004 | +| 0002 | ColU **- colFirstData** | | +| 0002 | USHORT **- col** | 0x0002 | +| 0002 | SHORT **- iCache** | 0x0000 | +| 0002 | SHORT **- reserved** | 0x0000 | +| 0002 | [SXAxis](#sxaxis) **- sxaxis4Data** | | +| 1 bit | USHORT **- sxaxisRw** | 0x1 | +| 1 bit | USHORT **- sxaxisCol** | 0x0 | +| 1 bit | USHORT **- sxaxisPage** | 0x0 | +| 1 bit | USHORT **- sxaxisData** | 0x0 | +| 12 bits | USHORT **- reserved** | 0x000 | +| 0002 | SHORT **- ipos4Data** | 0xFFFF | +| 0002 | SHORT **- cDim** | 0x0005 | +| 0002 | SHORT **- cDimRw** | 0x0002 | +| 0002 | SHORT **- cDimCol** | 0x0000 | +| 0002 | SHORT **- cDimPg** | 0x0001 | +| 0002 | SHORT **- cDimData** | 0x0001 | +| 0002 | USHORT **- cRw** | 0x0007 | +| 0002 | USHORT **- cCol** | 0x0001 | +| 1 bit | USHORT **- fRwGrand** | 0x1 | +| 1 bit | USHORT **- fColGrand** | 0x1 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fAutoFormat** | 0x1 | +| 1 bit | USHORT **- fAtrNum** | 0x0 | +| 1 bit | USHORT **- fAtrFnt** | 0x0 | +| 1 bit | USHORT **- fAtrAlc** | 0x0 | +| 1 bit | USHORT **- fAtrBdr** | 0x0 | +| 1 bit | USHORT **- fAtrPat** | 0x0 | +| 1 bit | USHORT **- fAtrProc** | 0x1 | +| 6 bits | USHORT **- unused2** | 0x00 | +| 0002 | [AutoFmt8](#autofmt8) **- itblAutoFmt** | 0x0001 | +| 0002 | USHORT **- cchTableName** | 0x0010 | +| 0002 | USHORT **- cchDataName** | 0x0004 | +| 0011 | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- stTable** | OrdersPivotTable | +| 0005 | XLUnicodeStringNoCch **- stData** | Data | + +Figure 137: Structure of SxView + +**ref:** A structure that specifies the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) (A2:C11) that specifies the location of the PivotTable view. + +**ref.rwFirst:** A structure that specifies the first row in the range. + +**ref.rwFirst.rw:** 0x0002 specifies the third row (row 3) in the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +**ref.rwLast:** A structure that specifies the last row in the range. + +**ref.rwLast.rw:** 0x000A specifies the eleventh row (row 11) in the sheet. + +**ref.colFirst:** A structure that specifies the first column in the range. + +**ref.colFirst.col:** 0x0000 specifies the first column (column A) in the sheet. + +**ref.colLast:** A structure that specifies the last column in the range. + +**ref.colLast.col:** 0x0002 specifies the third column (column C) in the sheet. + +**rwFirstHead:** A structure that specifies the first PivotTable [**header row**](#gt_42711baf-2679-445d-a994-0eadd91b1a38). + +**rwFirstHead.rw:** 0x0004 specifies the fifth row (row 5) in the sheet. + +**rwFirstData:** A structure that specifies the first row that contains PivotTable data. + +**rwFirstData.rw:** 0x0004 specifies the fifth row (row 5) in the sheet. + +**colFirstData:** A structure that specifies the first column that contains PivotTable data. + +**colFirstData.col:** 0x0002 specifies the third column (column C) in the sheet. + +**iCache:** 0x0000 specifies the index of the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) for this PivotTable, which is the first stream in the \_SX_DB_CUR storage. + +**sxaxis4Data:** A structure that specifies the default axis for data fields. Only the **sxaxisRow** and **sxaxisCol** bits of the structure are shown, as the rest of the bits are 0. + +**sxaxis4Data.sxaxisRw:** 0x1 specifies that the [row axis](#Section_3f46e7207706400cba9473cb829f869a) is the default axis for data fields. + +**sxaxis4Data.sxaxisCol:** 0x0 is required in this field because **sxaxisRw** is 0x1. + +**sxaxis4Data.sxaxisPage:** 0x0 is required in this field because **sxaxisRw** is 0x1. + +**sxaxis4Data.sxaxisData:** 0x0 is required in this field because **sxaxisRw** is 0x1. + +**ipos4Data:** 0xFFFF (-1) specifies that the data field is in the default position. + +**cDim:** 0x0005 specifies that there are five fields in the database. + +**cDimRw:** 0x0002 specifies that there are two fields on the row axis. + +**cDimCol:** 0x0000 specifies that there are no fields on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). + +**cDimPg:** 0x0001 specifies that there is one field on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**cDimData:** 0x0001 specifies that there is one field on the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**cRw:** 0x0007 specifies that there are seven [pivot lines](#Section_76610990666f492791b6d2280f607464) in the [row area](#Section_5594c95e6819461e80706f4b4fdfa091) of this PivotTable view. + +**cCol:** 0x0001 specifies that there is one pivot line in the [column area](#Section_03aced8c25864e83982a1e3551a563d6) of this PivotTable view. + +**fRwGrand:** 0x1 specifies that this PivotTable view contains [**grand totals**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7) for rows. + +**fColGrand:** 0x1 specifies that this PivotTable view contains grand totals for columns. + +**fAutoFormat:** 0x1 specifies that this PivotTable has [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f) applied. + +**fAtrNum:** 0x0 specifies that this PivotTable does not have AutoFormat applied for numbers. + +**fAtrFnt:** 0x0 specifies that this PivotTable does not have AutoFormat applied for fonts. + +**fAtrAlc:** 0x0 specifies that this PivotTable does not have AutoFormat applied for alignment. + +**fAtrBdr:** 0x0 specifies that this PivotTable does not have AutoFormat applied for [**borders**](#gt_85bbea8d-a9f4-40a2-b4f8-68b587d21a4c). + +**fAtrPat:** 0x0 specifies that this PivotTable does not have AutoFormat applied for patterns. + +**fAtrProc:** 0x1 specifies that this PivotTable has AutoFormat applied for width and height. + +**itblAutoFmt:** XL8_ITBLCLASSIC1 specifies that this PivotTable is using the "Classic" style of AutoFormat. + +**cchTableName:** 0x0010 specifies that the string in **stTable** has 16 characters. + +**cchDataName:** 0x0004 specifies that the string in **stData** has four characters. + +**stTable:** Specifies that the name of this PivotTable view is "OrdersPivotTable". + +**stData:** Specifies that the name of the data [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) is "Data". + +### PivotTable: Sxvd 1 + +The next record in this example, [Sxvd](#sxvd), specifies the first [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) ("CustomerName") in the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|-----------| +| 000A | Sxvd **- Sxvd** | | +| 0002 | [SXAxis](#sxaxis) **- sxaxis** | | +| 1 bit | USHORT **- sxaxisRw** | 0x1 | +| 1 bit | USHORT **- sxaxisCol** | 0x0 | +| 1 bit | USHORT **- sxaxisPage** | 0x0 | +| 1 bit | USHORT **- sxaxisData** | 0x0 | +| 12 bits | USHORT **- reserved** | 0x000 | +| 0002 | USHORT **- cSub** | 0x0001 | +| 1 bit | USHORT **- fDefault** | 0x1 | +| 1 bit | USHORT **- fSum** | 0x0 | +| 1 bit | USHORT **- fCounta** | 0x0 | +| 1 bit | USHORT **- fAverage** | 0x0 | +| 1 bit | USHORT **- fMax** | 0x0 | +| 1 bit | USHORT **- fMin** | 0x0 | +| 1 bit | USHORT **- fProduct** | 0x0 | +| 1 bit | USHORT **- fCount** | 0x0 | +| 1 bit | USHORT **- fStdev** | 0x0 | +| 1 bit | USHORT **- fStdevp** | 0x0 | +| 1 bit | USHORT **- fVariance** | 0x0 | +| 1 bit | USHORT **- fVariancep** | 0x0 | +| 4 bits | USHORT **- reserved** | 0x0 | +| 0002 | SHORT **- cItm** | 0x0006 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 138: Structure of Sxvd + +**sxaxis:** Specifies the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) to which this pivot field belongs. + +**sxaxis.sxaxisRw:** 0x1 specifies that this pivot field refers to the row axis. + +**sxaxis.sxaxisCol:** 0x0 specifies that this pivot field does not refer to the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). + +**sxaxis.sxaxisPage:** 0x0 specifies that this pivot field does not refer to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**sxaxis.sxaxisData:** 0x0 specifies that this pivot field does not refer to the [value axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**cSub:** 0x0001 specifies that one subtotal [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) is used for this pivot field. + +**fDefault:** 0x1 specifies that the default subtotal function is applied. + +**fSum:** 0x0 specifies that the **sum** subtotal function is not displayed. + +**fCounta:** 0x0 specifies that the **count** subtotal function is not displayed. + +**fAverage:** 0x0 specifies that the **average** subtotal function is not displayed. + +**fMax:** 0x0 specifies that the **max** subtotal function is not displayed. + +**fMin:** 0x0 specifies that the **min** subtotal function is not displayed. + +**fProduct:** 0x0 specifies that the **sum** subtotal function is not displayed. + +**fCount:** 0x0 specifies that the **count numbers** subtotal function is not displayed. + +**fStdev:** 0x0 specifies that the **standard deviation** subtotal function is not displayed. + +**fStdevp:** 0x0 specifies that the **standard deviation population** subtotal function is not displayed. + +**fVariance:** 0x0 specifies that the **variance** subtotal function is not displayed. + +**fVariancep:** 0x0 specifies that the **variance population** subtotal function is not displayed. + +**cItm:** 0x0006 specifies that there are six [pivot items](#Section_58891cc5dd9b4293a97831070779524f) for this pivot field. + +**cchName:** 0xFFFF specifies that the caption of this pivot field is NULL, which means that the name is inherited from the associated [cache field](#Section_6497eb794042445780e75959c9f0583c) instead. + +### PivotTable: SXVI 1 + +The next record in this example, [SXVI](#sxvi), specifies the first [pivot item](#Section_58891cc5dd9b4293a97831070779524f) ("Antonio Moreno Taquería") of this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) ("CustomerName"). This item is filtered out and not visible in the PivotTable report. + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|-----------| +| 0008 | SXVI **- SXVI** | | +| 0002 | SHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fHideDetail** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFormula** | 0x0 | +| 1 bit | USHORT **- fMissing** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 0002 | SHORT **- iCache** | 0x0001 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 139: Structure of SXVI + +**itmType:** 0x0000 specifies that the pivot item is a regular data value. + +**fHidden:** 0x0 specifies that the pivot item is not hidden. + +**fHideDetail:** 0x0 specifies that the pivot item is not collapsed (see [Collapsing](#Section_1c9375b4cc664783821f6b2b49bac169)). + +**fFormula:** 0x0 specifies that the pivot item is not a [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b). + +**fMissing:** 0x0 specifies that the pivot item exists in the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + +**iCache:** This field specifies a [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in the [cache field](#Section_6497eb794042445780e75959c9f0583c) that is associated with this pivot field ("CustomerName"). The index 0x01 specifies the second [SXString](#sxstring) ("Antonio Moreno Taquería") in the collection following the [SXFDB](#sxfdb) with **stFieldName**="CustomerName". + +**cchName:** 0xFFFF specifies that this pivot item does not have a caption. + +### PivotTable: SXVI 2 + +The next record in this example, [SXVI](#sxvi), specifies the [pivot item](#Section_58891cc5dd9b4293a97831070779524f) "Island Trading" in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|-----------| +| 0008 | SXVI **- SXVI** | | +| 0002 | SHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fHideDetail** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFormula** | 0x0 | +| 1 bit | USHORT **- fMissing** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 0002 | SHORT **- iCache** | 0x0003 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 140: Structure of SXVI + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**itmType:** 0x0000 specifies that this pivot item is a regular data value. + +**fHidden:** 0x0 specifies that this pivot item is not hidden. + +**fHideDetail:** 0x0 specifies that this pivot item is not collapsed (see [Collapsing](#Section_1c9375b4cc664783821f6b2b49bac169)). + +**fFormula:** 0x0 specifies that this pivot item is not a [calculated item](#Section_6c6b3e3d22354a609f5b1c902ee0a50b). + +**fMissing:** 0x0 specifies that this pivot item exists in the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + +**iCache:** The index 0x03 specifies the fourth [SXString](#sxstring) ("Island Trading") in the collection following the [SXFDB](#sxfdb) with **stFieldName**="CustomerName". + +### PivotTable: SXVI 3 + +The next record in this example, [SXVI](#sxvi), specifies the [pivot item](#Section_58891cc5dd9b4293a97831070779524f) "Richter Supermarkt" in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|-----------| +| 0008 | SXVI **- SXVI** | | +| 0002 | SHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fHideDetail** | 0x1 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFormula** | 0x0 | +| 1 bit | USHORT **- fMissing** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 0002 | SHORT **- iCache** | 0x0002 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 141: Structure of SXVI + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fHideDetail:** 0x1 specifies that the pivot item is collapsed (see [Collapsing](#Section_1c9375b4cc664783821f6b2b49bac169)). + +### PivotTable: SXVI 4 + +The next record in this example, [SXVI](#sxvi), specifies the Total row in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|-----------| +| 0008 | SXVI **- SXVI** | | +| 0002 | SHORT **- itmType** | 0x0001 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fHideDetail** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFormula** | 0x0 | +| 1 bit | USHORT **- fMissing** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 0002 | SHORT **- iCache** | 0xFFFF | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 142: Structure of SXVI + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**itmType:** 0x0001 specifies that the [pivot item](#Section_58891cc5dd9b4293a97831070779524f) is a subtotal. + +**iCache:** 0xFFFF specifies that the pivot item does not refer to any [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0). + +### PivotTable: SXVDEx 1 + +The next record in this example, [SXVDEx](#sxvdex), specifies the extended information about this ("CustomerName") [pivot field](#Section_1edf7f2294084945b2de56526c14fca5). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------------|------------| +| 0014 | SXVDEx **- SXVDEx** | | +| 1 bit | USHORT **- fShowAllItems** | 0x0 | +| 1 bit | USHORT **- fDragToRow** | 0x1 | +| 1 bit | USHORT **- fDragToColumn** | 0x1 | +| 1 bit | USHORT **- fDragToPage** | 0x1 | +| 1 bit | USHORT **- fDragToHide** | 0x1 | +| 1 bit | USHORT **- fNotDragToData** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 1 bit | USHORT **- fAutoSort** | 0x0 | +| 1 bit | USHORT **- fAscendSort** | 0x1 | +| 1 bit | USHORT **- fAutoShow** | 0x0 | +| 1 bit | USHORT **- fTopAutoShow** | 0x1 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 1 bit | USHORT **- fPageBreaksBetweenItems** | 0x0 | +| 1 bit | USHORT **- fHideNewItems** | 0x0 | +| 5 bits | USHORT **- reserved3** | 0x00 | +| 1 bit | USHORT **- fOutline** | 0x0 | +| 1 bit | USHORT **- fInsertBlankRow** | 0x0 | +| 1 bit | USHORT **- fSubtotalAtTop** | 0x0 | +| 8 bits | USHORT **- citmAutoShow** | 0x0A | +| 0002 | SHORT **- isxdiAutoSort** | 0xFFFF | +| 0002 | SHORT **- isxdiAutoShow** | 0xFFFF | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x0000 | +| 000A | [SXVDEx_Opt](#sxvdex_opt) **- subName** | | +| 0002 | USHORT **- cchSubName** | 0xFFFF | +| 0004 | ULONG **- reserved1** | 0x00000000 | +| 0004 | ULONG **- reserved2** | 0x00000000 | + +Figure 143: Structure of SXVDEx + +**fShowAllItems:** 0x0 specifies that all [pivot items](#Section_58891cc5dd9b4293a97831070779524f) in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) are not displayed. + +**fDragToRow:** 0x1 specifies that the pivot field can be dragged to the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +**fDragToColumn:** 0x1 specifies that the pivot field can be placed on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). + +**fDragToPage:** 0x1 specifies that the pivot field can be dragged to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**fDragToHide:** 0x1 specifies that the pivot field can be removed from the PivotTable view. + +**fNotDragToData:** 0x0 specifies that the pivot field can be dragged to the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**fServerBased:** 0x0 is required because the corresponding [cache field](#Section_6497eb794042445780e75959c9f0583c) is not server-based. + +**fAutoSort:** 0x0 specifies that AutoSort is not enabled for this pivot field. + +**fAscendSort:** 0x1 specifies that AutoSort order is set to ascending, and if AutoSort is enabled, this pivot field is sorted in ascending order. + +**fAutoShow:** 0x0 specifies that [**AutoShow**](#gt_42126923-0aed-4547-8761-95a0ce2badde) is not enabled on this pivot field. + +**fTopAutoShow:** 0x1 specifies that AutoShow is set to show top 10 values rather than bottom 10 values. If AutoShow is enabled, this PivotTable view uses top 10 values for AutoShow (filter). + +**fCalculatedField:** 0x0 specifies that this pivot field is not a [calculated field](#Section_4594f2ac815740b381142e77ba8efb7d). + +**fPageBreaksBetweenItems:** 0x0 specifies that a [**page break**](#gt_55584218-fec7-4f6a-8295-e4dbf3b7d871) is not set between different pivot items in the PivotTable view during printing. + +**fHideNewItems:** 0x0 specifies that new pivot items that are added to the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) are displayed automatically in the PivotTable view when the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) is refreshed. + +**fOutline:** 0x0 specifies that this pivot field is not displayed in [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) format. + +**fInsertBlankRow:** 0x0 specifies that a blank line is not inserted between different pivot items in the PivotTable view. + +**fSubtotalAtTop:** 0x0 specifies that subtotals are displayed at the bottom of the list of pivot items for this pivot field. + +**citmAutoShow:** 0x0A specifies that 10 pivot items are set to display for the top *n* AutoShow (filter). + +**isxdiAutoSort:** 0xFFFF specifies that AutoSort uses current [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679). + +**isxdiAutoShow:** 0xFFFF specifies that AutoShow is not enabled for this pivot field. + +**subName:** Specifies the name of the aggregate [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d) used to calculate this pivot field's subtotals. + +**subName.cchSubName:** 0xFFFF specifies that there is no aggregate function to use. + +### PivotTable: Sxvd 2 + +The next record in this example, [Sxvd](#sxvd), specifies the pageField ("OrderDate") of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|-----------| +| 000A | Sxvd **- Sxvd** | | +| 0002 | [SXAxis](#sxaxis) **- sxaxis** | | +| 1 bit | USHORT **- sxaxisRw** | 0x0 | +| 1 bit | USHORT **- sxaxisCol** | 0x0 | +| 1 bit | USHORT **- sxaxisPage** | 0x1 | +| 1 bit | USHORT **- sxaxisData** | 0x0 | +| 12 bits | USHORT **- reserved** | 0x000 | +| 0002 | USHORT **- cSub** | 0x0001 | +| 1 bit | USHORT **- fDefault** | 0x1 | +| 1 bit | USHORT **- fSum** | 0x0 | +| 1 bit | USHORT **- fCounta** | 0x0 | +| 1 bit | USHORT **- fAverage** | 0x0 | +| 1 bit | USHORT **- fMax** | 0x0 | +| 1 bit | USHORT **- fMin** | 0x0 | +| 1 bit | USHORT **- fProduct** | 0x0 | +| 1 bit | USHORT **- fCount** | 0x0 | +| 1 bit | USHORT **- fStdev** | 0x0 | +| 1 bit | USHORT **- fStdevp** | 0x0 | +| 1 bit | USHORT **- fVariance** | 0x0 | +| 1 bit | USHORT **- fVariancep** | 0x0 | +| 4 bits | USHORT **- reserved** | 0x0 | +| 0002 | SHORT **- cItm** | 0x0015 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 144: Structure of Sxvd + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**sxaxis:** This field specifies the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) upon which this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) exists. + +**sxaxis.sxaxisRw:** 0x0 specifies that this pivot field does not refer to the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +**sxaxis.sxaxisCol:** 0x0 specifies that this pivot field does not refer to the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). + +**sxaxis.sxaxisPage:** 0x1 specifies that this pivot field refers to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**sxaxis.sxaxisData:** 0x0 specifies that this pivot field does not refer to the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**cItm:** 0x0015 specifies that this pivot field contains 21 [pivot items](#Section_58891cc5dd9b4293a97831070779524f). + +### PivotTable: SXVI 5 + +The next record in this example, [SXVI](#sxvi), specifies the first [pivot item](#Section_58891cc5dd9b4293a97831070779524f) (5/6/1997) of this page field ("OrderDate"). This pivot item is filtered out and not displayed in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|-----------| +| 0008 | SXVI **- SXVI** | | +| 0002 | SHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- fHidden** | 0x1 | +| 1 bit | USHORT **- fHideDetail** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFormula** | 0x0 | +| 1 bit | USHORT **- fMissing** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 0002 | SHORT **- iCache** | 0x0000 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 145: Structure of SXVI + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fHidden:** 0x1 specifies that this pivot item is hidden (filtered out). + +### PivotTable: SXVI 6 + +The next record in this example, [SXVI](#sxvi), specifies the second [pivot item](#Section_58891cc5dd9b4293a97831070779524f) (11/28/1997) of this page field ("OrderDate"). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|-----------| +| 0008 | SXVI **- SXVI** | | +| 0002 | SHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- fHidden** | 0x1 | +| 1 bit | USHORT **- fHideDetail** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFormula** | 0x0 | +| 1 bit | USHORT **- fMissing** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 0002 | SHORT **- iCache** | 0x000F | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 146: Structure of SXVI + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fHidden:** 0x1 specifies that the pivot item is hidden. Because this pivot item is one of the items showing in the filter in the [page area](#Section_f10ef7d86c044d35a5830d6f2ce92063) but is not actually displayed in the report, it is marked as hidden. + +### PivotTable: SXVI 7 + +The next record in this example, [SXVI](#sxvi), specifies the third [pivot item](#Section_58891cc5dd9b4293a97831070779524f) (12/23/1997) of this page field ("OrderDate"). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------|-----------| +| 0008 | SXVI **- SXVI** | | +| 0002 | SHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- fHidden** | 0x0 | +| 1 bit | USHORT **- fHideDetail** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFormula** | 0x0 | +| 1 bit | USHORT **- fMissing** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 0002 | SHORT **- iCache** | 0x0010 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 147: Structure of SXVI + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fHidden:** 0x0 specifies that the pivot item is not hidden. + +### PivotTable: SXVDEx 2 + +The next record in this example, [SXVDEx](#sxvdex), specifies extended information about this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) ("OrderDate"). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------------|------------| +| 0014 | SXVDEx **- SXVDEx** | | +| 1 bit | USHORT **- fShowAllItems** | 0x0 | +| 1 bit | USHORT **- fDragToRow** | 0x1 | +| 1 bit | USHORT **- fDragToColumn** | 0x1 | +| 1 bit | USHORT **- fDragToPage** | 0x1 | +| 1 bit | USHORT **- fDragToHide** | 0x1 | +| 1 bit | USHORT **- fNotDragToData** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 1 bit | USHORT **- fAutoSort** | 0x0 | +| 1 bit | USHORT **- fAscendSort** | 0x1 | +| 1 bit | USHORT **- fAutoShow** | 0x0 | +| 1 bit | USHORT **- fTopAutoShow** | 0x1 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 1 bit | USHORT **- fPageBreaksBetweenItems** | 0x0 | +| 1 bit | USHORT **- fHideNewItems** | 0x0 | +| 5 bits | USHORT **- reserved3** | 0x00 | +| 1 bit | USHORT **- fOutline** | 0x0 | +| 1 bit | USHORT **- fInsertBlankRow** | 0x0 | +| 1 bit | USHORT **- fSubtotalAtTop** | 0x0 | +| 8 bits | USHORT **- citmAutoShow** | 0x0A | +| 0002 | SHORT **- isxdiAutoSort** | 0xFFFF | +| 0002 | SHORT **- isxdiAutoShow** | 0xFFFF | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x000E | +| 000A | [SXVDEx_Opt](#sxvdex_opt) **- subName** | | +| 0002 | USHORT **- cchSubName** | 0xFFFF | +| 0004 | ULONG **- reserved1** | 0x00000000 | +| 0004 | ULONG **- reserved2** | 0x00000000 | + +Figure 148: Structure of SXVDEx + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**ifmt:** Specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) of this pivot field. + +**ifmt.ifmt:** 0x000E specifies that the format of this [pivot item](#Section_58891cc5dd9b4293a97831070779524f) is the built-in format **mm-dd-yy**. + +### PivotTable: Sxvd 3 + +The next record in this example, [Sxvd](#sxvd), specifies the second field in the [row axis](#Section_3f46e7207706400cba9473cb829f869a), "ProductName". + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|-----------| +| 000A | Sxvd **- Sxvd** | | +| 0002 | [SXAxis](#sxaxis) **- sxaxis** | | +| 1 bit | USHORT **- sxaxisRw** | 0x1 | +| 1 bit | USHORT **- sxaxisCol** | 0x0 | +| 1 bit | USHORT **- sxaxisPage** | 0x0 | +| 1 bit | USHORT **- sxaxisData** | 0x0 | +| 12 bits | USHORT **- reserved** | 0x000 | +| 0002 | USHORT **- cSub** | 0x0001 | +| 1 bit | USHORT **- fDefault** | 0x1 | +| 1 bit | USHORT **- fSum** | 0x0 | +| 1 bit | USHORT **- fCounta** | 0x0 | +| 1 bit | USHORT **- fAverage** | 0x0 | +| 1 bit | USHORT **- fMax** | 0x0 | +| 1 bit | USHORT **- fMin** | 0x0 | +| 1 bit | USHORT **- fProduct** | 0x0 | +| 1 bit | USHORT **- fCount** | 0x0 | +| 1 bit | USHORT **- fStdev** | 0x0 | +| 1 bit | USHORT **- fStdevp** | 0x0 | +| 1 bit | USHORT **- fVariance** | 0x0 | +| 1 bit | USHORT **- fVariancep** | 0x0 | +| 4 bits | USHORT **- reserved** | 0x0 | +| 0002 | SHORT **- cItm** | 0x0007 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 149: Structure of Sxvd + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**cItm:** 0x0007 specifies that this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) has seven [pivot items](#Section_58891cc5dd9b4293a97831070779524f). + +### PivotTable: Sxvd 4 + +The next record in this example, [Sxvd](#sxvd), specifies the [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) "UnitPrice", which is not in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|-----------| +| 000A | Sxvd **- Sxvd** | | +| 0002 | [SXAxis](#sxaxis) **- sxaxis** | | +| 1 bit | USHORT **- sxaxisRw** | 0x0 | +| 1 bit | USHORT **- sxaxisCol** | 0x0 | +| 1 bit | USHORT **- sxaxisPage** | 0x0 | +| 1 bit | USHORT **- sxaxisData** | 0x0 | +| 12 bits | USHORT **- reserved** | 0x000 | +| 0002 | USHORT **- cSub** | 0x0001 | +| 1 bit | USHORT **- fDefault** | 0x1 | +| 1 bit | USHORT **- fSum** | 0x0 | +| 1 bit | USHORT **- fCounta** | 0x0 | +| 1 bit | USHORT **- fAverage** | 0x0 | +| 1 bit | USHORT **- fMax** | 0x0 | +| 1 bit | USHORT **- fMin** | 0x0 | +| 1 bit | USHORT **- fProduct** | 0x0 | +| 1 bit | USHORT **- fCount** | 0x0 | +| 1 bit | USHORT **- fStdev** | 0x0 | +| 1 bit | USHORT **- fStdevp** | 0x0 | +| 1 bit | USHORT **- fVariance** | 0x0 | +| 1 bit | USHORT **- fVariancep** | 0x0 | +| 4 bits | USHORT **- reserved** | 0x0 | +| 0002 | SHORT **- cItm** | 0x0000 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 150: Structure of Sxvd + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**sxaxis:** Specifies the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) axis that this pivot field belongs to. + +**sxaxis.sxaxisRw:** 0x0 specifies that this pivot field does not refer to the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +**sxaxis.sxaxisCol:** 0x0 specifies that this pivot field does not refer to the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). + +**sxaxis.sxaxisPage:** 0x0 specifies that this pivot field does not refer to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**sxaxis.sxaxisData:** 0x0 specifies that this pivot field does not refer to the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**fDefault:** 0x1 specifies that the default subtotal is applied. + +**cItm: cItm:** 0x0000 specifies that there are no [pivot items](#Section_58891cc5dd9b4293a97831070779524f) for this pivot field. This is because this pivot field is a numeric field, and cache items do not need to be stored for numeric fields. + +Records following this record, and before the next [SXVDEx](#sxvdex) record, are omitted for brevity. + +### PivotTable: SXVDEx 3 + +The next record in this example, [SXVDEx](#sxvdex), specifies extended information about this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) ("UnitPrice"). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------------|------------| +| 0014 | SXVDEx **- SXVDEx** | | +| 1 bit | USHORT **- fShowAllItems** | 0x0 | +| 1 bit | USHORT **- fDragToRow** | 0x1 | +| 1 bit | USHORT **- fDragToColumn** | 0x1 | +| 1 bit | USHORT **- fDragToPage** | 0x1 | +| 1 bit | USHORT **- fDragToHide** | 0x1 | +| 1 bit | USHORT **- fNotDragToData** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 1 bit | USHORT **- fAutoSort** | 0x0 | +| 1 bit | USHORT **- fAscendSort** | 0x1 | +| 1 bit | USHORT **- fAutoShow** | 0x0 | +| 1 bit | USHORT **- fTopAutoShow** | 0x1 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 1 bit | USHORT **- fPageBreaksBetweenItems** | 0x0 | +| 1 bit | USHORT **- fHideNewItems** | 0x0 | +| 5 bits | USHORT **- reserved3** | 0x00 | +| 1 bit | USHORT **- fOutline** | 0x0 | +| 1 bit | USHORT **- fInsertBlankRow** | 0x0 | +| 1 bit | USHORT **- fSubtotalAtTop** | 0x0 | +| 8 bits | USHORT **- citmAutoShow** | 0x0A | +| 0002 | SHORT **- isxdiAutoSort** | 0xFFFF | +| 0002 | SHORT **- isxdiAutoShow** | 0xFFFF | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x002C | +| 000A | [SXVDEx_Opt](#sxvdex_opt) **- subName** | | +| 0002 | USHORT **- cchSubName** | 0xFFFF | +| 0004 | ULONG **- reserved1** | 0x00000000 | +| 0004 | ULONG **- reserved2** | 0x00000000 | + +Figure 151: Structure of SXVDEx + +**fShowAllItems:** 0x0 specifies that [pivot items](#Section_58891cc5dd9b4293a97831070779524f) that do not currently exist in the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) are not displayed. + +**fDragToRow:** 0x1 specifies that this pivot field can be placed on the [row axis](#Section_3f46e7207706400cba9473cb829f869a) of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +**fDragToColumn:** 0x1 specifies that this pivot field can be placed on the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) of this PivotTable view. + +**fDragToPage:** 0x1 specifies that this pivot field can be dragged to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of this PivotTable view. + +**fDragToHide:** 0x1 specifies that this pivot field can be removed from the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) view. + +**fNotDragToData:** 0x0 specifies that this pivot field can be placed on the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060) of this PivotTable view. + +**fCalculatedField:** 0x0 specifies that this pivot field is not a calculated field. + +**fOutline:** 0x0 specifies that this pivot field is not displayed in [**outline**](#gt_d20b50ce-6124-4bda-ba32-5d132016d639) format. + +**ifmt:** Specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) of this pivot field. + +**ifmt.ifmt:** 0x002C specifies that this field has the **\_(\$\* \#,##0.00\_);\_(\$\* (#,##0.00);\_(\$\* "-"??\_);\_(@\_)** number format applied. + +### PivotTable: Sxvd 5 + +The next record in this example, [Sxvd](#sxvd), specifies the data field ("Quantity") in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|-----------| +| 000A | Sxvd **- Sxvd** | | +| 0002 | [SXAxis](#sxaxis) **- sxaxis** | | +| 1 bit | USHORT **- sxaxisRw** | 0x0 | +| 1 bit | USHORT **- sxaxisCol** | 0x0 | +| 1 bit | USHORT **- sxaxisPage** | 0x0 | +| 1 bit | USHORT **- sxaxisData** | 0x1 | +| 12 bits | USHORT **- reserved** | 0x000 | +| 0002 | USHORT **- cSub** | 0x0001 | +| 1 bit | USHORT **- fDefault** | 0x1 | +| 1 bit | USHORT **- fSum** | 0x0 | +| 1 bit | USHORT **- fCounta** | 0x0 | +| 1 bit | USHORT **- fAverage** | 0x0 | +| 1 bit | USHORT **- fMax** | 0x0 | +| 1 bit | USHORT **- fMin** | 0x0 | +| 1 bit | USHORT **- fProduct** | 0x0 | +| 1 bit | USHORT **- fCount** | 0x0 | +| 1 bit | USHORT **- fStdev** | 0x0 | +| 1 bit | USHORT **- fStdevp** | 0x0 | +| 1 bit | USHORT **- fVariance** | 0x0 | +| 1 bit | USHORT **- fVariancep** | 0x0 | +| 4 bits | USHORT **- reserved** | 0x0 | +| 0002 | SHORT **- cItm** | 0x0000 | +| 0002 | USHORT **- cchName** | 0xFFFF | + +Figure 152: Structure of Sxvd + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**sxaxis:** This field specifies the [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) that this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) is on. + +**sxaxis.sxaxisRw:** 0x0 specifies that this pivot field does not refer to the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +**sxaxis.sxaxisCol:** 0x0 specifies that this pivot field does not refer to the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). + +**sxaxis.sxaxisPage:** 0x0 specifies that this pivot field does not refer to the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**sxaxis.sxaxisData:** 0x1 specifies that this pivot field refers to the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**cItm:** 0x0000 specifies that there are no [pivot items](#Section_58891cc5dd9b4293a97831070779524f) for this pivot field. This is because this pivot field is a numeric field, and cache items do not need to be stored for numeric fields. + +Records following this record, and before the next [SXVDEx](#sxvdex) record, are omitted for brevity. + +### PivotTable: SXVDEx 4 + +The next record in this example, [SXVDEx](#sxvdex), specifies the extended information about this [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) ("Quantity"). + +| **Size** | **Structure** | **Value** | +|----------|-----------------------------------------|------------| +| 0014 | SXVDEx **- SXVDEx** | | +| 1 bit | USHORT **- fShowAllItems** | 0x0 | +| 1 bit | USHORT **- fDragToRow** | 0x1 | +| 1 bit | USHORT **- fDragToColumn** | 0x1 | +| 1 bit | USHORT **- fDragToPage** | 0x1 | +| 1 bit | USHORT **- fDragToHide** | 0x1 | +| 1 bit | USHORT **- fNotDragToData** | 0x0 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 1 bit | USHORT **- fAutoSort** | 0x0 | +| 1 bit | USHORT **- fAscendSort** | 0x1 | +| 1 bit | USHORT **- fAutoShow** | 0x0 | +| 1 bit | USHORT **- fTopAutoShow** | 0x1 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 1 bit | USHORT **- fPageBreaksBetweenItems** | 0x0 | +| 1 bit | USHORT **- fHideNewItems** | 0x0 | +| 5 bits | USHORT **- reserved3** | 0x00 | +| 1 bit | USHORT **- fOutline** | 0x0 | +| 1 bit | USHORT **- fInsertBlankRow** | 0x0 | +| 1 bit | USHORT **- fSubtotalAtTop** | 0x0 | +| 8 bits | USHORT **- citmAutoShow** | 0x0A | +| 0002 | SHORT **- isxdiAutoSort** | 0xFFFF | +| 0002 | SHORT **- isxdiAutoShow** | 0xFFFF | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x0000 | +| 000A | [SXVDEx_Opt](#sxvdex_opt) **- subName** | | +| 0002 | USHORT **- cchSubName** | 0xFFFF | +| 0004 | ULONG **- reserved1** | 0x00000000 | +| 0004 | ULONG **- reserved2** | 0x00000000 | + +Figure 153: Structure of SXVDEx + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**ifmt:** A field that specifies the [**number format**](#gt_16fc3e8f-047a-42fe-b28c-4856c09cd74b) of this pivot field. + +**ifmt.ifmt:** 0x0000 specifies that the General number format is applied. + +### PivotTable: SxIvd + +The next record in this example, [SxIvd](#sxivd), specifies an array of references to [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5) on the [row axis](#Section_3f46e7207706400cba9473cb829f869a). Because **cDimRw** is 2 and **cDimCol** is 0 for the parent [SxView](#sxview), this contains an array of rows. + +| **Size** | **Structure** | **Value** | +|----------|----------------------------------------|-----------| +| 0004 | SxIvd **- Sxivd** | | +| 0004 | rgSxivd **- rgSxivd** | | +| 0002 | [SxIvdRw](#sxivdrw) **- SxIvdRw\[0\]** | | +| 0002 | SHORT **- rw** | 0x0000 | +| 0002 | SxIvdRw **- SxIvdRw\[1\]** | | +| 0002 | SHORT **- rw** | 0x0002 | + +Figure 154: Structure of Sxivd + +**rgSxivd:** A field that specifies an array of references to pivot fields. + +**rgSxivd.SxIvdRw\[0\]:** A field that specifies a reference to a pivot field on the row axis. + +**rgSxivd.SxIvdRw\[0\].rw:** 0x0000 specifies the first pivot field. + +**rgSxivd.SxIvdRw\[1\]:** A field that specifies a reference to a pivot field on the row axis. + +**rgSxivd.SxIvdRw\[1\].rw:** 0x0002 specifies the third pivot field. + +### PivotTable: SXPI + +The next record in this example, [SXPI](#sxpi), specifies an array of [SXPI_Item](#sxpi_item) (information about the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) page item) structures that specify the [pivot items](#Section_58891cc5dd9b4293a97831070779524f) on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of this PivotTable. There is one item in the array because the **cDimPg** field of the [SxView](#sxview) record for the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) is 1. + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------|-----------| +| 0006 | SXPI **- SXPI** | | +| 0006 | SXPI_Item **- rgsxpi** | | +| 0006 | SXPI_Item **- SXPI_Item\[0\]** | | +| 0002 | SHORT **- isxvd** | 0x0001 | +| 0002 | SHORT **- isxvi** | 0x7FFD | +| 0002 | SHORT **- idObj** | 0x0001 | + +Figure 155: Structure of SXPI + +**rgsxpi:** Specifies an array of page item information or SXPI_Item Structures. + +**rgsxpi.SXPI_Item\[0\]:** Specifies the first item in the [page area](#Section_f10ef7d86c044d35a5830d6f2ce92063). + +**rgsxpi.SXPI_Item\[0\].isxvd:** 0x0001 specifies the second [pivot field](#Section_1edf7f2294084945b2de56526c14fca5), "OrderDate". + +**rgsxpi.SXPI_Item\[0\].isxvi:** 0x7FFD specifies that all pivot items are used by the "OrderDate" pivot field. + +**rgsxpi.SXPI_Item\[0\].idObj:** 0x001 which specifies the object identifier of the [Obj](#obj) record with the page item drop-down arrow. + +### PivotTable: SXDI + +The next record in this example, [SXDI](#sxdi), specifies the [data item](#Section_b51aa7b309b34aa78cb4964ad24d1679) "Quantity" for this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001E | SXDI **- SXDI** | | +| 0002 | SHORT **- isxvdData** | 0x0004 | +| 0002 | SHORT **- iiftab** | 0x0000 | +| 0002 | SHORT **- df** | 0x0000 | +| 0002 | SHORT **- isxvd** | 0x0000 | +| 0002 | SHORT **- isxvi** | 0x0000 | +| 0002 | [IFmt](#ifmt) **- ifmt** | | +| 0002 | USHORT **- ifmt** | 0x0000 | +| 0002 | USHORT **- cchName** | 0x000F | +| 0010 | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- stName** | Sum Of Quantity | + +Figure 156: Structure of SXDI + +**isxvdData:** A field that specifies a [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) in the form of an index in the collection of pivot fields specified by [SXFDB](#sxfdb). The value 0x04 specifies the fifth pivot field, "Quantity". + +**iiftab:** 0x0000 specifies the "Sum of values" **aggregation** [**function**](#gt_bf7cf9ec-4b24-4d58-985a-55d73c69297d). + +**df:** 0x0000 specifies that this data item is to be displayed as its raw value with no calculation applied. + +**isxvd:** 0x0000 is required because **df** is 0x0000. + +**isxvi:** 0x0000 is required because **df** is 0x0000. + +**cchName:** 0x000F specifies that the length of this data item is 15 characters. + +**stName:** "Sum Of Quantity" specifies the name of this data item. + +### PivotTable: SXLI 1 + +Because the **cRw** and **cCol** fields of the [SxView](#sxview) record are greater than zero, this example contains two [SXLI](#sxli) records. This first SXLI specifies the [pivot lines](#Section_76610990666f492791b6d2280f607464) for the [row area](#Section_5594c95e6819461e80706f4b4fdfa091). + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------|-----------| +| 0054 | SXLI **- SXLI** | | +| 0054 | [SXLIItem](#sxliitem) **- rgsxli** | | +| 000C | SXLIItem **- SXLIItem\[0\]** | | +| 0002 | SHORT **- cSic** | 0x0000 | +| 15 bits | USHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0002 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x0 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x0 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0004 | SHORT **- rgisxvi** | | +| 0002 | SHORT **- isxvi\[0\]** | 0x0002 | +| 0002 | SHORT **- isxvi\[1\]** | 0x0002 | +| 000C | SXLIItem **- SXLIItem\[1\]** | | +| 0002 | SHORT **- cSic** | 0x0000 | +| 15 bits | USHORT **- itmType** | 0x0001 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0001 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x1 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x0 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0004 | SHORT **- rgisxvi** | | +| 0002 | SHORT **- isxvi\[0\]** | 0x0002 | +| 0002 | SHORT **- isxvi\[1\]** | 0x0002 | +| 000C | SXLIItem **- SXLIItem\[2\]** | | +| 0002 | SHORT **- cSic** | 0x0000 | +| 15 bits | USHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0002 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x0 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x0 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0004 | SHORT **- rgisxvi** | | +| 0002 | SHORT **- isxvi\[0\]** | 0x0003 | +| 0002 | SHORT **- isxvi\[1\]** | 0x0000 | +| 000C | SXLIItem **- SXLIItem\[3\]** | | +| 0002 | SHORT **- cSic** | 0x0001 | +| 15 bits | USHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0002 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x0 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x0 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0004 | SHORT **- rgisxvi** | | +| 0002 | SHORT **- isxvi\[0\]** | 0x0003 | +| 0002 | SHORT **- isxvi\[1\]** | 0x0003 | +| 000C | SXLIItem **- SXLIItem\[4\]** | | +| 0002 | SHORT **- cSic** | 0x0000 | +| 15 bits | USHORT **- itmType** | 0x0001 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0001 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x1 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x0 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0004 | SHORT **- rgisxvi** | | +| 0002 | SHORT **- isxvi\[0\]** | 0x0003 | +| 0002 | SHORT **- isxvi\[1\]** | 0x0003 | +| 000C | SXLIItem **- SXLIItem\[5\]** | | +| 0002 | SHORT **- cSic** | 0x0000 | +| 15 bits | USHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0001 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x0 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x0 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x1 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0004 | SHORT **- rgisxvi** | | +| 0002 | SHORT **- isxvi\[0\]** | 0x0004 | +| 0002 | SHORT **- isxvi\[1\]** | 0x7FFF | +| 000C | SXLIItem **- SXLIItem\[6\]** | | +| 0002 | SHORT **- cSic** | 0x0000 | +| 15 bits | USHORT **- itmType** | 0x000D | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0001 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x1 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x1 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | +| 0004 | SHORT **- rgisxvi** | | +| 0002 | SHORT **- isxvi\[0\]** | 0x0000 | +| 0002 | SHORT **- isxvi\[1\]** | 0x0000 | + +Figure 157: Structure of SXLI + +Fields that appear in several SXLIItem structures with the same values are omitted for brevity. + +**rgsxli:** A field that contains an array of SXLIItem structures, which specify the pivot lines present in this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +**rgsxli.SXLIItem\[0\]:** Specifies the first pivot line and its [pivot items](#Section_58891cc5dd9b4293a97831070779524f) in the [row axis](#Section_3f46e7207706400cba9473cb829f869a). + +**rgsxli.SXLIItem\[0\].cSic:** 0x0000 specifies that no pivot items in the **rgisxvi** array are identical to the first pivot items in the previous pivot line item in this record. + +**rgsxli.SXLIItem\[0\].itmType:** 0x0000 specifies that the pivot item is a regular data value. + +**rgsxli.SXLIItem\[0\].isxviMac:** 0x0002 specifies that this pivot line contains two pivot items. + +**rgsxli.SXLIItem\[0\].fMultiDataName:** 0x0 specifies that the [data field](#Section_b4187a6caa2d4a9789bd26f394d67592) name is used for the total. + +**rgsxli.SXLIItem\[0\].iData:** 0x00 specifies that the data item for this line item is "Quantity" (the only data item in this PivotTable). + +**rgsxli.SXLIItem\[0\].fSbt:** 0x0 specifies that this pivot item does not represent a subtotal. + +**rgsxli.SXLIItem\[0\].fBlock:** 0x0 specifies that this pivot item is not a block total. + +**rgsxli.SXLIItem\[0\].fGrand:** 0x0 specifies that this pivot item is not a [**grand total**](#gt_417eeaf5-caef-4fc3-afe1-048db5482eb7). + +**rgsxli.SXLIItem\[0\].fMultiDataOnAxis:** 0x0 specifies that this pivot line does not contain multiple data fields. + +**rgsxli.SXLIItem\[0\].rgisxvi:** Specifies [pivot line entries](#Section_ecba812f4a31495ebeb46749e5897f2d) for this pivot line. + +**rgsxli.SXLIItem\[0\].rgisxvi.isxvi\[0\]:** A field that specifies a pivot item index, because the [SxIvd](#sxivd) record with the same index, **rgSxivd.SxIvdRw\[0\]**, specifies a pivot item index. 0x0002 specifies the third pivot item ([SXVI](#sxvi)) within this [Sxvd](#sxvd) ("CustomerName") record. The referenced pivot item contains an index which refers to the fourth cache item ([SXString](#sxstring)) of the corresponding [cache field](#Section_6497eb794042445780e75959c9f0583c) ("CustomerName"). The fourth [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) within this cache field is "Island Trading". + +**rgsxli.SXLIItem\[0\].rgisxvi.isxvi\[1\]:** A field that specifies a pivot item index, because the SxIvd record with the same index, **rgSxivd.SxIvdRw\[1\]**, specifies a pivot item index. 0x0002 specifies the third pivot item (SXVI) within this Sxvd ("ProductName"). The referenced pivot item contains an index which refers to the fourth cache item (SXString) of the corresponding cache field ("ProductName "). The fourth cache item within this cache field is "Ipoh Coffee". + +**rgsxli.SXLIItem\[1\]:** Specifies the second pivot line and its pivot items in the row axis. + +**rgsxli.SXLIItem\[1\].itmType:** 0x0001 specifies that the pivot item is a subtotal. + +**rgsxli.SXLIItem\[1\].isxviMac:** 0x0001 specifies that this pivot line contains one item. + +**rgsxli.SXLIItem\[1\].fSbt:** 0x1 specifies that this item is a subtotal. + +**rgsxli.SXLIItem\[2\]:** Specifies the third pivot line and its pivot items in the row axis. + +**rgsxli.SXLIItem\[2\].rgisxvi:** Specifies pivot line entries for this pivot line. + +**rgsxli.SXLIItem\[2\].rgisxvi.isxvi\[0\]:** A field that specifies a pivot item index, because the SxIvd record with the same index, **rgSxivd.SxIvdRw\[0\]**, specifies a pivot item index. 0x0003 specifies the fourth pivot item (SXVI) within this Sxvd ("CustomerName"). The referenced pivot item contains an index which refers to the fifth cache item (SXString) of the corresponding cache field ("CustomerName"). The first cache item within this cache field is "Königlich Essen". + +**rgsxli.SXLIItem\[2\].rgisxvi.isxvi\[1\]:** A field that specifies a pivot item index, because the SxIvd record with the same index, **rgSxivd.SxIvdRw\[1\]**, specifies a pivot item index. 0x0000 specifies the first pivot item (SXVI) within this Sxvd ("ProductName") record. The referenced pivot item contains an index which refers to the first cache item (SXString) of the corresponding cache field ("ProductName"). The first cache item within this cache field is "Geitost". + +**rgsxli.SXLIItem\[3\]:** Specifies the fourth pivot line and its pivot items in the row axis. + +**rgsxli.SXLIItem\[3\].cSic:** 0x0001 specifies that one pivot item in the **rgisxvi** array is identical to the first pivot item in the previous pivot line item in this record. + +**rgsxli.SXLIItem\[3\].rgisxvi:** Specifies pivot line entries for this pivot line. + +**rgsxli.SXLIItem\[3\].rgisxvi.isxvi\[0\]:** A field that specifies a pivot item index, because the SxIvd record with the same index, **rgSxivd.SxIvdRw\[0\]**, specifies a pivot item index. 0x0003 specifies the fourth pivot item (SXVI) within this Sxvd ("CustomerName") record. The referenced pivot item contains an index which refers to the fifth cache item (SXString) of the corresponding cache field ("CustomerName"). The fifth cache item within this cache field is "Königlich Essen". + +**rgsxli.SXLIItem\[3\].rgisxvi.isxvi\[1\]:** A field that specifies a pivot item index, because the SxIvd record with the same index, **rgSxivd.SxIvdRw\[1\]**, specifies a pivot item index. 0x0003 specifies the fourth pivot item (SXVI) within this Sxvd ("ProductName") record. The referenced pivot item contains an index which refers to the third cache item (SXString) of the corresponding cache field ("ProductName"). The third cache item within this cache field is "Perth Pasties". + +The next pivot line is similar to the earlier subtotal pivot line and is not described here. + +**rgsxli.SXLIItem\[5\]:** Specifies the sixth pivot line and its pivot items in the row axis. + +**rgsxli.SXLIItem\[5\].rgisxvi:** Specifies pivot line entries for this pivot line. + +**rgsxli.SXLIItem\[5\].rgisxvi.isxvi\[0\]:** A field that specifies a pivot item index, because the SxIvd record with the same index, **rgSxivd.SxIvdRw\[0\]**, specifies a pivot item index. 0x0004 specifies the fourth pivot item (SXVI) within this Sxvd ("CustomerName") record. The referenced pivot item contains an index which refers to the third cache item (SXString) of the corresponding cache field ("ProductName"). The third cache item within this cache field is "Richter Supermarkt". + +**rgsxli.SXLIItem\[5\].rgisxvi.isxvi\[1\]:** 0x7FFF specifies that there is no pivot item in this position and the cell is blank. + +**rgsxli.SXLIItem\[6\]:** Specifies the seventh pivot line and its pivot items in the row axis. + +**rgsxli.SXLIItem\[6\].itmType:** 0x000D specifies that the pivot item is a grand total. + +**rgsxli.SXLIItem\[6\].fGrand:** 0x1 specifies that this pivot item is a grand total. + +**rgsxli.SXLIItem\[6\].rgisxvi:** Specifies pivot line entries for this pivot line. + +**rgsxli.SXLIItem\[6\].rgisxvi.isxvi\[0\]:** This field has the value 0x0000 because this pivot item is a grand total (**fGrand**=1). + +**rgsxli.SXLIItem\[6\].rgisxvi.isxvi\[1\]:** This field has the value 0x0000 because this pivot item is a grand total (**fGrand**=1). + +### PivotTable: SXLI 2 + +This second [SXLI](#sxli) record specifies the [pivot line](#Section_76610990666f492791b6d2280f607464) item structures for the [column axis](#Section_00d9d88b8fa74bf08446584bf651677f). The size of this array (one item) is determined by the **cCol** field of the [SxView](#sxview) record. + +| **Size** | **Structure** | **Value** | +|----------|------------------------------------|-----------| +| 0008 | SXLI **- SXLI** | | +| 0008 | [SXLIItem](#sxliitem) **- rgsxli** | | +| 0008 | SXLIItem **- SXLI_Item\[0\]** | | +| 0002 | SHORT **- cSic** | 0x0000 | +| 15 bits | USHORT **- itmType** | 0x0000 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 0002 | SHORT **- isxviMac** | 0x0000 | +| 1 bit | USHORT **- fMultiDataName** | 0x0 | +| 8 bits | USHORT **- iData** | 0x00 | +| 1 bit | USHORT **- fSbt** | 0x0 | +| 1 bit | USHORT **- fBlock** | 0x0 | +| 1 bit | USHORT **- fGrand** | 0x0 | +| 1 bit | USHORT **- fMultiDataOnAxis** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- reserved2** | 0x0 | + +Figure 158: Structure of SXLI + +All values of this record are 0 because there is no field or any item in column axis. Because of this, none of the fields are described in this section. + +### PivotTable: SXEx + +The next record in this example, [SXEx](#sxex), specifies additional properties of this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------|-----------| +| 0018 | SXEx **- Sxex** | | +| 0002 | USHORT **- csxformat** | 0x0000 | +| 0002 | USHORT **- cchErrorString** | 0xFFFF | +| 0002 | USHORT **- cchNullString** | 0xFFFF | +| 0002 | USHORT **- cchTag** | 0xFFFF | +| 0002 | USHORT **- csxselect** | 0x0000 | +| 0002 | [DRw](#drw) **- crwPage** | | +| 0002 | USHORT **- drw** | 0x0001 | +| 0002 | [DCol](#dcol) **- ccolPage** | | +| 0002 | USHORT **- dcol** | 0x0001 | +| 1 bit | USHORT **- fAcrossPageLay** | 0x0 | +| 8 bits | USHORT **- cWrapPage** | 0x00 | +| 1 bit | USHORT **- unused** | 0x1 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 5 bits | USHORT **- reserved2** | 0x00 | +| 1 bit | USHORT **- fEnableWizard** | 0x1 | +| 1 bit | USHORT **- fEnableDrilldown** | 0x1 | +| 1 bit | USHORT **- fEnableFieldDialog** | 0x1 | +| 1 bit | USHORT **- fPreserveFormatting** | 0x1 | +| 1 bit | USHORT **- fMergeLabels** | 0x0 | +| 1 bit | USHORT **- fDisplayErrorString** | 0x0 | +| 1 bit | USHORT **- fDisplayNullString** | 0x1 | +| 1 bit | USHORT **- fSubtotalHiddenPageItems** | 0x0 | +| 8 bits | USHORT **- reserved3** | 0x00 | +| 0002 | USHORT **- cchPageFieldStyle** | 0xFFFF | +| 0002 | USHORT **- cchTableStyle** | 0xFFFF | +| 0002 | USHORT **- cchVacateStyle** | 0xFFFF | + +Figure 159: Structure of Sxex + +**csxformat:** 0x0000 specifies that no [SxFormat](#sxformat) records follow this record. + +**cchErrorString:** 0xFFFF specifies that a custom string displayed in [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that contain errors does not exist. + +**cchNullString:** 0xFFFF specifies that a custom string displayed in cells that contain NULL values does not exist. + +**cchTag:** 0xFFFF specifies that a custom string saved with this PivotTable view does not exist. + +**csxselect:** 0x0000 specifies that no [SxSelect](#sxselect) records follow this record. + +**crwPage:** Specifies the number of rows in the [page area](#Section_f10ef7d86c044d35a5830d6f2ce92063) of the PivotTable view. + +**crwPage.drw:** 0x0001 specifies that this PivotTable view contains one row on the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7). + +**ccolPage:** Specifies the number of columns in the page area in the PivotTable view. + +**ccolPage.dcol:** 0x0001 specifies that this PivotTable view contains one column on the page axis. + +**fAcrossPageLay:** 0x0 specifies that multiple [pivot fields](#Section_1edf7f2294084945b2de56526c14fca5) on the page axis will be displayed in the page area from the top to the bottom first, as fields are added, before moving to another column. + +**cWrapPage:** 0x00 specifies that pivot fields in the page area do not wrap, as specified by **fAcrossPageLay**. + +**fEnableWizard:** 0x1 specifies that the application displays a user interface to interact with the PivotTable view. + +**fEnableDrilldown:** 0x1 specifies that details can be shown for cells in the [data area](#Section_237a24905c614931923f7ee856f23c72). + +**fEnableFieldDialog:** 0x1 specifies that a user interface for setting properties of a pivot field can be displayed. + +**fPreserveFormatting:** 0x1 specifies that formatting is preserved when the PivotTable view is recalculated. + +**fMergeLabels:** 0x0 specifies that empty cells adjacent to the cells displaying [pivot item](#Section_58891cc5dd9b4293a97831070779524f) captions of pivot fields on the [row axis](#Section_3f46e7207706400cba9473cb829f869a) and [column axis](#Section_00d9d88b8fa74bf08446584bf651677f) of this PivotTable view are not merged into a single cell. + +**fDisplayErrorString:** 0x0 specifies that the PivotTable view does not display a custom error string in cells that contain errors. + +**fDisplayNullString:** 0x1 specifies that the PivotTable view displays a custom string in cells that contain NULL values. + +**fSubtotalHiddenPageItems:** 0x0 specifies that hidden pivot items, as specified by [SXVI](#sxvi) records with the **fHidden** field equal to 1, of a pivot field on the page axis with the **isxvi** field of the corresponding [SXPI_Item](#sxpi_item) structure equal to 0x7FFD, are filtered out when calculating the PivotTable view. + +**cchPageFieldStyle:** 0xFFFF specifies that no [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) is applied in the page area of the PivotTable view. + +**cchTableStyle:** 0xFFFF specifies that no style is applied in the [body](#Section_7f7d9d76a55041d9ae9f0d8539cc09f8) of the PivotTable view. + +**cchVacateStyle:** 0xFFFF specifies that no style is applied to cells that become empty when the PivotTable view is recalculated. + +### PivotTable: QsiSXTag + +The next record in this example, [QsiSXTag](#qsisxtag), specifies the name and [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) information for this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----------|--------------------------------------------------|------------------| +| 0025 | QsiSXTag **- QsiSxTag** | | +| 0004 | [FrtHeaderOld](#frtheaderold) **- frtHeader** | | +| 0002 | USHORT **- rt** | 0x0802 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0002 | SHORT **- fSx** | 0x0001 | +| 1 bit | USHORT **- fEnableRefresh** | 0x1 | +| 1 bit | USHORT **- fInvalid** | 0x0 | +| 1 bit | USHORT **- fTensorEx** | 0x0 | +| 13 bits | USHORT **- reserved1** | 0x0000 | +| 0004 | [SXView9Save](#sxview9save) **- dwQsiFuture** | | +| 1 bit | USHORT **- fNoStencil** | 0x0 | +| 1 bit | USHORT **- fHideTotAnnotation** | 0x1 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fIncludeEmptyRw** | 0x0 | +| 1 bit | USHORT **- fIncludeEmptyCol** | 0x0 | +| 11 bits | USHORT **- reserved2** | 0x000 | +| 16 bits | USHORT **- reserved3** | 0x0000 | +| 0001 | BYTE **- verSxLastUpdated** | 0x02 | +| 0001 | BYTE **- verSxUpdatableMin** | 0x00 | +| 0001 | BYTE **- obCchName** | 0x10 | +| 0001 | BYTE **- reserved2** | 0x00 | +| 0013 | [XLUnicodeString](#xlunicodestring) **- stName** | OrdersPivotTable | +| 0002 | USHORT **- unused** | 0x0100 | + +Figure 160: Structure of QsiSxTag + +**frtHeader:** A structure that specifies a [future record](#Section_b660b67822684414839ed1ae9a4e4e85) type header. + +**frtHeader.rt:** 0x0802 specifies the record type identifier and is required. + +**frtHeader.grbitFrt:** 0x00 specifies a constant value of 0x00. + +**fSx:** 0x0001 specifies that this record relates to a PivotTable. + +**fEnableRefresh:** 0x1 specifies that the PivotTable is to be refreshed with data from an external [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + +**fInvalid:** 0x0 specifies that the PivotTable needs to be refreshed. + +**fTensorEx:** 0x0 specifies that the PivotTable is not an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) report. + +**dwQsiFuture:** Specifies additional option flags for a PivotTable. + +**dwQsiFuture.fNoStencil:** 0x0 specifies that the drawing of large drop zones is enabled for this [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37)that has no data fields. + +**dwQsiFuture.fHideTotAnnotation:** 0x1 specifies that annotation for the total in this [OLAP PivotTable view](#Section_bbdb91f53cc644e4a812d5e06c977f6f) is hidden. + +**dwQsiFuture.fIncludeEmptyRw:** 0x0 specifies that empty rows from an OLAP data source are not shown in this PivotTable view. + +**dwQsiFuture.fIncludeEmptyCol:** 0x0 specifies that empty columns from an OLAP data source are not shown in this PivotTable view. + +**verSxLastUpdated:** 0x02 specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) that this PivotTable was last refreshed with. + +**verSxUpdatableMin:** 0x00 specifies the minimum version of the application that can refresh this PivotTable. + +**stName:** "OrdersPivotTable" specifies the name of this PivotTable. + +### PivotTable: SXViewEx9 + +QsiSXTag The next record in this example, [SXViewEx9](#sxviewex9), specifies extensions to the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------------------|--------------| +| 0011 | SXViewEx9 **- Sxviewex9** | | +| 0002 | USHORT **- rt** | 0x0810 | +| 1 bit | USHORT **- reserved1** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved2** | 0x0000 | +| 0004 | ULONG **- reserved3** | 0x00000000 | +| 1 bit | ULONG **- reserved4** | 0x0 | +| 1 bit | ULONG **- fPrintTitles** | 0x0 | +| 1 bit | ULONG **- fLineMode** | 0x0 | +| 2 bits | ULONG **- reserved5** | 0x0 | +| 1 bit | ULONG **- fRepeatItemsOnEachPrintedPage** | 0x1 | +| 26 bits | ULONG **- reserved6** | 0x0000000 | +| 0002 | [AutoFmt8](#autofmt8) **- itblAutoFmt** | 0x0001 | +| 0003 | [XLUnicodeString](#xlunicodestring) **- chGrand** | empty string | + +Figure 161: Structure of Sxviewex9 + +**rt:** 0x0810 specifies a constant record type identifier. + +**fFrtAlert:** 0x0000 specifies that features of this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) are supported in earlier versions of the [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517). + +**fPrintTitles:** 0x00000000 specifies that print titles for the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) are not set based on the PivotTable report. + +**fLineMode:** 0x00000000 specifies that no [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) is in outline mode. See [subtotaling](#Section_427438d9b8e34a5c8b678f158fbf680f) for more information. + +**fRepeatItemsOnEachPrintedPage:** 0x00000001 specifies that [pivot item](#Section_58891cc5dd9b4293a97831070779524f) captions on the [row axis](#Section_3f46e7207706400cba9473cb829f869a) will be repeated at the top of each printed page for pivot fields in tabular form. + +**itblAutoFmt:** 0x0001 specifies the PivotTable [**AutoFormat**](#gt_f7e1ea19-1129-4519-a857-008db95c462f). A value of 0x001 specifies XL8_ITBLCLASSIC1 or the **Classic 1** AutoFormat style. + +### PivotTable: SxAddl 4 + +The next record in this example, [SxAddl](#sxaddl), specifies additional information for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) and [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001F | [SXAddl_SXCView_SXDId](#sxaddl_sxcview_sxdid) **- SXAddl** | | +| 0006 | [SXAddlHdr](#sxaddlhdr) **- hdr** | | +| 0004 | [FrtHeaderOld](#frtheaderold) **- frtHeaderOld** | | +| 0002 | USHORT **- rt** | 0x0864 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0001 | BYTE **- sxc** | 0x00 | +| 0001 | BYTE **- sxd** | 0x00 | +| 0019 | SXAddl_SXString **- stName** | | +| 0019 | [XLUnicodeStringSegmentedSXAddl](#xlunicodestringsegmentedsxaddl) **- stName** | OrdersPivotTable | + +Figure 162: Structure of SXAddl + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**hdr:** An SXAddlHdr structure that specifies header information for this SXAddl record. + +**hdr.sxc:** 0x00 specifies the current [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) as an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +**hdr.sxd:** 0x00 specifies the type of record contained in the **data** field of the containing SXAddl record. This value specifies that the type of this SXAddl record is [SXAddl_SXCCache_SXDId](#sxaddl_sxccache_sxdid). + +**stName.stName:** "OrdersPivotTable" specifies the name of the PivotTable View. + +### PivotTable: SxAddl 5 + +The next record in this example, [SxAddl](#sxaddl), specifies additional information for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) and [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 000C | [SXAddl_SXCView_SXDVer10Info](#sxaddl_sxcview_sxdver10info) **- SXAddl** | | +| 0006 | [SXAddlHdr](#sxaddlhdr) **- hdr** | | +| 0004 | [FrtHeaderOld](#frtheaderold) **- frtHeaderOld** | | +| 0002 | USHORT **- rt** | 0x0864 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0001 | BYTE **- sxc** | 0x00 | +| 0001 | BYTE **- sxd** | 0x02 | +| 8 bits | ULONG **- bVerSxMacro** | 0x01 | +| 1 bit | ULONG **- fDisplayImmediateItems** | 0x1 | +| 1 bit | ULONG **- fEnableDataEd** | 0x0 | +| 1 bit | ULONG **- fDisableFList** | 0x0 | +| 1 bit | ULONG **- fReenterOnLoadOnce** | 0x0 | +| 1 bit | ULONG **- fNotViewCalculatedMembers** | 0x0 | +| 1 bit | ULONG **- fNotVisualTotals** | 0x0 | +| 1 bit | ULONG **- fPageMultipleItemLabel** | 0x1 | +| 1 bit | ULONG **- fTensorFillCv** | 0x0 | +| 1 bit | ULONG **- fHideDDData** | 0x0 | +| 3 bits | ULONG **- reserved1** | 0x0 | +| 12 bits | ULONG **- unused** | 0x000 | +| 0002 | USHORT **- reserved2** | 0x0000 | + +Figure 163: Structure of SXAddl + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**hdr:** An SXAddlHdr structure that specifies header information for this SXAddl record. + +**hdr.sxc:** 0x00 specifies the current [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) as an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +**hdr.sxd:** 0x02 specifies the type of record contained in the **data** field of the containing SXAddl record. See class for more information. This value specifies that the type of this SXAddl record is SXAddl_SXCView_SXDVer10Info. + +**bVerSxMacro:** 0x01 specifies the [data functionality level](#Section_2bcedd76ef064e6084c718ea55042ed6) with which this [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) was created. + +**fDisplayImmediateItems:** 0x1 specifies that [pivot items](#Section_58891cc5dd9b4293a97831070779524f) are displayed in the PivotTable view even when there is no [pivot field](#Section_1edf7f2294084945b2de56526c14fca5) on the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060). + +**fEnableDataEd:** 0x0 specifies the user is not allowed to change values in the data axis of the PivotTable view. + +**fDisableFList:** 0x0 specifies the [**PivotTable field list**](#gt_1760fb56-0c97-4c0d-a077-38338baa7577) is enabled. + +**fReenterOnLoadOnce:** 0x0 specifies that this PivotTable view will not [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) the next time the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) is opened. + +**fPageMultipleItemLabel:** 0x1 specifies that [OLAP calculated members](#Section_e67071408ab5499ca7bab1d8eca85058) are [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) in the PivotTable view. + +### PivotTable: SxAddl 6 + +The next record in this example, [SxAddl](#sxaddl), specifies additional information for a [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) and [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). In this record, the **data.hdr.sxd** field specifies that this is the last record of an **SxAddl** record collection. + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 000C | [SXAddl_SXCView_SXDEnd](#sxaddl_sxcview_sxdend) **- SXAddl** | | +| 0006 | [SXAddlHdr](#sxaddlhdr) **- hdr** | | +| 0004 | [FrtHeaderOld](#frtheaderold) **- frtHeaderOld** | | +| 0002 | USHORT **- rt** | 0x0864 | +| 0002 | [FrtFlags](#frtflags) **- grbitFrt** | | +| 1 bit | USHORT **- fFrtRef** | 0x0 | +| 1 bit | USHORT **- fFrtAlert** | 0x0 | +| 14 bits | USHORT **- reserved** | 0x0000 | +| 0001 | BYTE **- sxc** | 0x00 | +| 0001 | BYTE **- sxd** | 0xFF | +| 0006 | reserved **- reserved** | 0x000000000000 | + +Figure 164: Structure of SXAddl + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**hdr:** An SXAddlHdr structure that specifies header information for this SXAddl record. + +**hdr.sxc:** 0x00 specifies the current [class](#Section_3450b26af2b247dd982c6b9eb2d448b0) as an [SxcView class](#Section_a17d6dc32db74ec4b3cbeded2b7126c3). + +**hdr.sxd:** 0xFF specifies the type of record contained in the **data** field of the containing SXAddl record. See class for more information. This value specifies that the type of this SXAddl record is SXAddl_SXCView_SXDEnd. + +### PivotTable: SXDB + +The next record in this example, [SXDB](#sxdb), specifies some of the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) properties for the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3) in this example. This SXDB record marks the beginning of the set of records in the stream associated with this PivotTable that appear in the [Pivot Cache storage](#Section_c5fb3f663ef64308ae3de59244159687) (\_SX_DB_CUR). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001F | SXDB **- SXDB** | | +| 0004 | LONG **- crdbdb** | 0x0000002C | +| 0002 | USHORT **- idstm** | 0x0001 | +| 1 bit | USHORT **- fSaveData** | 0x1 | +| 1 bit | USHORT **- fInvalid** | 0x0 | +| 1 bit | USHORT **- fRefreshOnLoad** | 0x0 | +| 1 bit | USHORT **- fOptimizeCache** | 0x0 | +| 1 bit | USHORT **- fBackgroundQuery** | 0x0 | +| 1 bit | USHORT **- fEnableRefresh** | 0x1 | +| 10 bits | USHORT **- unused1** | 0x000 | +| 0002 | SHORT **- unused2** | 0x0666 | +| 0002 | SHORT **- cfdbdb** | 0x0005 | +| 0002 | SHORT **- cfdbTot** | 0x0005 | +| 0002 | SHORT **- crdbUsed** | 0x0006 | +| 0002 | USHORT **- vsType** | 0x0001 | +| 0002 | USHORT **- cchWho** | 0x000A | +| 000B | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- rgb** | John Smith | + +Figure 165: Structure of SXDB + +**crdbdb:** 0x0000002C specifies that there are a total of 44 records in the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) of this PivotCache. + +**idstm:** 0x0001 specifies the identifier of the stream in the PivotCache storage that contains the PivotCache for this PivotTable. The stream identifier is a four-character string representation of the hexadecimal value. In this case the stream identifier is "0001". This field is equal to the **idstm** field of [SXStreamID](#sxstreamid). + +**fSaveData:** 0x1 specifies that [cache records](#Section_fe6e4ca0a9b646a4898124e4b61a770a) exist for this PivotCache. + +**fInvalid:** 0x0 specifies that the cache does not need to be refreshed before the next recalculation. + +**fRefreshOnLoad:** 0x0 specifies that the PivotCache is not refreshed on load. + +**fOptimizeCache:** 0x0 specifies that the cache is not optimized for reduced memory usage. + +**fBackgroundQuery:** 0x0 specifies that a [**refresh**](#gt_d947dfed-8e3a-4451-b978-d69a89ae6060) of the PivotCache is performed synchronously. + +**fEnableRefresh:** 0x1 specifies that the PivotCache refresh is enabled. + +**cfdbdb:** 0x0005 specifies that there are five base [cache fields](#Section_6497eb794042445780e75959c9f0583c) in the source data. + +**cfdbTot:** 0x0005 specifies that there are a sum total of five base, grouped, and calculated fields in the cache. The value of this field is the same as the **cfdbdb** field because there are no grouped or calculated fields. + +**crdbUsed:** 0x0006 specifies that there are six records in use from the source data in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37) as a result of the filtering in the [page area](#Section_f10ef7d86c044d35a5830d6f2ce92063). + +**vsType:** 0x0001 specifies that the [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) is a [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) range. + +**cchWho:** 0x000A specifies the length (10) of the following **rgb** string. + +**rgb:** "John Smith" specifies the name of the user who last refreshed the PivotTable. + +### PivotTable: SXDBEx + +The next record in this example, [SXDBEx](#sxdbex), specifies additional [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e) properties. + +| **Size** | **Structure** | **Value** | +|----------|---------------------------------------|--------------------| +| 000C | SXDBEx **- SXDBEx** | | +| 0008 | [DateAsNum](#dateasnum) **- numDate** | | +| 0008 | [Xnum](#xnum) **- dateNum** | 0x40E355907CBEB8CE | +| 0004 | DWORD **- cSxFormula** | 0x00000000 | + +Figure 166: Structure of SXDBEx + +**numDate:** A DateAsNum structure that specifies the PivotCache was last refreshed on 5/28/2008. + +**numDate.dateNum:** 0x40E355907CBEB8CE specifies the numeric value 39596.515227662035, which represents the date (5/28/2008 12:21:56 PM) that the PivotCache was last refreshed. + +**cSxFormula:** 0x00000000 specifies that there are no [SXFormula](#sxformula) records for this PivotCache. + +### PivotTable: SXFDB 1 + +The next records in this example are a series of [SXFDB](#sxfdb) and related records that specify the [cache fields](#Section_6497eb794042445780e75959c9f0583c) and their contents. This first SXFDB record specifies details of the CustomerName cache field in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). In this example, this cache field is displayed in the [row axis](#Section_3f46e7207706400cba9473cb829f869a) of the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001D | SXFDB **- SXFDB** | | +| 1 bit | USHORT **- fAllAtoms** | 0x1 | +| 1 bit | USHORT **- fSomeUnhashed** | 0x0 | +| 1 bit | USHORT **- fUsed** | 0x0 | +| 1 bit | USHORT **- fHasParent** | 0x0 | +| 1 bit | USHORT **- fRangeGroup** | 0x0 | +| 1 bit | USHORT **- fNumField** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fTextEtcField** | 0x1 | +| 1 bit | USHORT **- fnumMinMaxValid** | 0x0 | +| 1 bit | USHORT **- fShortIitms** | 0x0 | +| 1 bit | USHORT **- fNonDates** | 0x1 | +| 1 bit | USHORT **- fDateInField** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- fCantGetUniqueItems** | 0x0 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 0002 | SHORT **- ifdbParent** | 0x0000 | +| 0002 | SHORT **- ifdbBase** | 0x0000 | +| 0002 | SHORT **- citmUnq** | 0x0005 | +| 0002 | SHORT **- csxoper** | 0x0000 | +| 0002 | SHORT **- cisxoper** | 0x0000 | +| 0002 | SHORT **- catm** | 0x0005 | +| 000F | [XLUnicodeString](#xlunicodestring) **- stFieldName** | CustomerName | + +Figure 167: Structure of SXFDB + +Fields in this record that are ignored because **fHasParent** is 0 are omitted for brevity. + +**fAllAtoms:** 0x1 specifies that the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) for this cache field is cached. It is cached because the CustomerName cache field is displayed in the PivotTable as the first row field. + +**fSomeUnhashed:** 0x0 specifies that all source data is cached in the PivotCache. + +**fUsed:** 0x0 specifies that no calculated cache fields are used in the PivotTable. + +**fHasParent:** 0x0 specifies that this cache field does not have a parent cache field. + +**fRangeGroup:** 0x0 specifies that this cache field is not grouped by range grouping, as specified in [Grouping](#Section_63e07ed20a764cb08cf446aaf25464c2). + +**fNumField:** 0x0 specifies that the [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in this cache field do not contain numeric data. + +**fTextEtcField:** 0x1 specifies that the cache items in this cache field contain text values. + +**fnumMinMaxValid:** 0x0 specifies that a valid minimum or maximum value is not computed for this cache field. + +**fShortIitms:** 0x0 specifies that this cache field does not contain more than 255 cache items. + +**fNonDates:** 0x1 specifies that the cache items in this cache field contain values that are neither time nor date values. + +**fDateInField:** 0x0 specifies that none of the cache items in this cache field contain a time or date value. + +**fServerBased:** 0x0 specifies that this cache field is not a server-based field, as specified in Source Data. + +**fCantGetUniqueItems:** 0x0 specifies that it is possible to retrieve a list of unique items for this cache field. + +**fCalculatedField:** 0x0 specifies that this record is not a [calculated field](#Section_4594f2ac815740b381142e77ba8efb7d). + +**csxoper:** 0x0000 specifies that there are zero cache item values in this cache field that are based on [**child**](#gt_bc38f35b-d253-4f8f-8dcc-095e3a211ae0) cache fields. + +**cisxoper:** 0x0000 specifies that there are zero values in the child cache fields of this cache field. + +**catm:** 0x0005 specifies that there are five items in the cache item collection for this cache field. + +**stFieldName:** "CustomerName" specifies the name of this cache field. + +The following record, [SXFDBType](#sxfdbtype), is not included in this example because the **sxvs** field of the [SXVS](#sxvs) record in this example is 1. + +### PivotTable: SXString 1 + +After the [cache field](#Section_6497eb794042445780e75959c9f0583c) is specified, a series of records follow it that specify the [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in the CustomerName cache field. In this example, the next record is an [SXString](#sxstring) record, which specifies a string cache item. This cache item is not displayed in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001A | SXString **- SXString** | | +| 0002 | USHORT **- cch** | 0x0017 | +| 0018 | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- segment** | Great Lakes Food Market | + +Figure 168: Structure of SXString + +**cch:** 0x0017 specifies the length (23) of the cache item string. + +**segment:** "Great Lakes Food Market" specifies the value of the cache item. + +### PivotTable: SXString 2 + +The next record in this example, [SXString](#sxstring), specifies a string [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in the CustomerName [cache field](#Section_6497eb794042445780e75959c9f0583c). This cache item does not appear in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 001A | SXString **- SxString** | | +| 0002 | USHORT **- cch** | 0x0017 | +| 0018 | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- segment** | Antonio Moreno Taquería | + +Figure 169: Structure of SxString + +**cch:** 0x0017 specifies the length (23) of the cache item string. + +**segment:** "Antonio Moreno Taquería" specifies the value of the cache item. + +This record is followed by 1 additional SXString record that is omitted for brevity. + +### PivotTable: SXString 3 + +The next record in this example, [SXString](#sxstring), specifies a string [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in the CustomerName [cache field](#Section_6497eb794042445780e75959c9f0583c). This record is included in this example because it is displayed in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----|----|----| +| 0011 | SXString **- SXString** | | +| 0002 | USHORT **- cch** | 0x000E | +| 000F | [XLUnicodeStringNoCch](#xlunicodestringnocch) **- segment** | Island Trading | + +Figure 170: Structure of SXString + +**cch:** 0x000E specifies the length (14) of the cache item string. + +**segment:** "Island Trading" specifies the value of the cache item. + +Records following this record, and before the next [SXFDB](#sxfdb) record, are omitted for brevity. + +### PivotTable: SXFDB 2 + +The next record in this example, [SXFDB](#sxfdb), specifies the OrderDate [cache field](#Section_6497eb794042445780e75959c9f0583c) in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). This cache field is displayed in the [page axis](#Section_ff63f3d9274542878e6e11120ecf30b7) of the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------------------------|-----------| +| 001A | SXFDB **- SXFDB** | | +| 1 bit | USHORT **- fAllAtoms** | 0x1 | +| 1 bit | USHORT **- fSomeUnhashed** | 0x0 | +| 1 bit | USHORT **- fUsed** | 0x0 | +| 1 bit | USHORT **- fHasParent** | 0x0 | +| 1 bit | USHORT **- fRangeGroup** | 0x0 | +| 1 bit | USHORT **- fNumField** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fTextEtcField** | 0x0 | +| 1 bit | USHORT **- fnumMinMaxValid** | 0x1 | +| 1 bit | USHORT **- fShortIitms** | 0x0 | +| 1 bit | USHORT **- fNonDates** | 0x0 | +| 1 bit | USHORT **- fDateInField** | 0x1 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- fCantGetUniqueItems** | 0x0 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 0002 | SHORT **- ifdbParent** | 0x0000 | +| 0002 | SHORT **- ifdbBase** | 0x0000 | +| 0002 | SHORT **- citmUnq** | 0x0014 | +| 0002 | SHORT **- csxoper** | 0x0000 | +| 0002 | SHORT **- cisxoper** | 0x0000 | +| 0002 | SHORT **- catm** | 0x0014 | +| 000C | [XLUnicodeString](#xlunicodestring) **- stFieldName** | OrderDate | + +Figure 171: Structure of SXFDB + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fAllAtoms:** 0x1 specifies that the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) for this cache field is cached. It is cached because the OrderDate cache field is displayed in the PivotTable as the first page field. + +**fNonDates:** 0x0 specifies that the [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in this cache field are date or time values. + +**fDateInField:** 0x1 specifies that at least one cache item in this cache field is a date or time value. + +**catm:** 0x0014 specifies that there are 20 items in the cache item collection for this cache field. + +**stFieldName:** "OrderDate" specifies the name of the cache field. + +Records following this record, and before the next [SXDtr](#sxdtr) record, are omitted for brevity. + +### PivotTable: SXDtr 1 + +The next record in this example, [SXDtr](#sxdtr), specifies a date [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in the OrderDate [cache field](#Section_6497eb794042445780e75959c9f0583c). This cache item is filtered out in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|-------------------|-----------| +| 0008 | SXDtr **- SXDtr** | | +| 0002 | USHORT **- yr** | 0x07CD | +| 0002 | USHORT **- mon** | 0x0005 | +| 0001 | BYTE **- dom** | 0x06 | +| 0001 | BYTE **- hr** | 0x00 | +| 0001 | BYTE **- min** | 0x00 | +| 0001 | BYTE **- sec** | 0x00 | + +Figure 172: Structure of SXDtr + +**yr:** 0x07CD specifies the year value (1997) of the cache item. + +**mon:** 0x0005 specifies the month value (5) of the cache item. + +**dom:** 0x06 specifies the day of the month value (6) of the cache item. + +**hr:** 0x00 specifies the hour value (0) of the cache item. + +**min:** 0x00 specifies the minute value (0) of the cache item. + +**sec:** 0x00 specifies the second value (0) of the cache item. + +This record is followed by 15 additional SXDtr records that are omitted for brevity. + +### PivotTable: SXDtr 2 + +The next record in this example, [SXDtr](#sxdtr), specifies a date [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in the OrderDate page field that is not filtered in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|-------------------|-----------| +| 0008 | SXDtr **- SXDtr** | | +| 0002 | USHORT **- yr** | 0x07CD | +| 0002 | USHORT **- mon** | 0x000C | +| 0001 | BYTE **- dom** | 0x17 | +| 0001 | BYTE **- hr** | 0x00 | +| 0001 | BYTE **- min** | 0x00 | +| 0001 | BYTE **- sec** | 0x00 | + +Figure 173: Structure of SXDtr + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**yr:** 0x07CD specifies the year value (1997) of the cache item. + +**mon:** 0x000C specifies the month value (12) of the cache item. + +**dom:** 0x17 specifies the day of the month value (23) of the cache item. + +Records following this record, and before the next [SXFDB](#sxfdb) record, are omitted for brevity. + +### PivotTable: SXFDB 3 + +The next record in this example, [SXFDB](#sxfdb), specifies the ProductName [cache field](#Section_6497eb794042445780e75959c9f0583c) in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). This cache field is displayed in the [row axis](#Section_3f46e7207706400cba9473cb829f869a) of the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------------------------|-------------| +| 001C | SXFDB **- SXFDB** | | +| 1 bit | USHORT **- fAllAtoms** | 0x1 | +| 1 bit | USHORT **- fSomeUnhashed** | 0x0 | +| 1 bit | USHORT **- fUsed** | 0x0 | +| 1 bit | USHORT **- fHasParent** | 0x0 | +| 1 bit | USHORT **- fRangeGroup** | 0x0 | +| 1 bit | USHORT **- fNumField** | 0x0 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fTextEtcField** | 0x1 | +| 1 bit | USHORT **- fnumMinMaxValid** | 0x0 | +| 1 bit | USHORT **- fShortIitms** | 0x0 | +| 1 bit | USHORT **- fNonDates** | 0x1 | +| 1 bit | USHORT **- fDateInField** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- fCantGetUniqueItems** | 0x0 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 0002 | SHORT **- ifdbParent** | 0x0000 | +| 0002 | SHORT **- ifdbBase** | 0x0000 | +| 0002 | SHORT **- citmUnq** | 0x0006 | +| 0002 | SHORT **- csxoper** | 0x0000 | +| 0002 | SHORT **- cisxoper** | 0x0000 | +| 0002 | SHORT **- catm** | 0x0006 | +| 000E | [XLUnicodeString](#xlunicodestring) **- stFieldName** | ProductName | + +Figure 174: Structure of SXFDB + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fAllAtoms:** 0x1 specifies that the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) for this cache field is cached. It is cached because the ProductName cache field is displayed in the PivotTable as the first row field. + +**fNumField:** 0x0 specifies that the [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in this cache field do not contain numeric data. + +**fTextEtcField:** 0x1 specifies that the cache items in this cache field contain text values. + +**catm:** 0x0006 specifies that there are six items in the cache item collection for this cache field. The number of items in the cache field was affected in this case by the filtering on the page field. + +**stFieldName:** "ProductName" specifies the name of the cache field. + +Records following this record, and before the next SXFDB record, are omitted for brevity. + +### PivotTable: SXFDB 4 + +The next record in this example, [SXFDB](#sxfdb), specifies the UnitPrice [cache field](#Section_6497eb794042445780e75959c9f0583c) in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). This cache field does not appear on any [PivotTable axis](#Section_89db73685e8e4324b592af85e4559e6c) in the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------------------------|-----------| +| 001A | SXFDB **- SXFDB** | | +| 1 bit | USHORT **- fAllAtoms** | 0x1 | +| 1 bit | USHORT **- fSomeUnhashed** | 0x0 | +| 1 bit | USHORT **- fUsed** | 0x0 | +| 1 bit | USHORT **- fHasParent** | 0x0 | +| 1 bit | USHORT **- fRangeGroup** | 0x0 | +| 1 bit | USHORT **- fNumField** | 0x1 | +| 1 bit | USHORT **- unused1** | 0x0 | +| 1 bit | USHORT **- fTextEtcField** | 0x0 | +| 1 bit | USHORT **- fnumMinMaxValid** | 0x1 | +| 1 bit | USHORT **- fShortIitms** | 0x0 | +| 1 bit | USHORT **- fNonDates** | 0x1 | +| 1 bit | USHORT **- fDateInField** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- fCantGetUniqueItems** | 0x0 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 0002 | SHORT **- ifdbParent** | 0x0000 | +| 0002 | SHORT **- ifdbBase** | 0x0000 | +| 0002 | SHORT **- citmUnq** | 0x0007 | +| 0002 | SHORT **- csxoper** | 0x0000 | +| 0002 | SHORT **- cisxoper** | 0x0000 | +| 0002 | SHORT **- catm** | 0x0007 | +| 000C | [XLUnicodeString](#xlunicodestring) **- stFieldName** | UnitPrice | + +Figure 175: Structure of SXFDB + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fAllAtoms:** 0x1 specifies that the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) for this cache field is cached. Though this cache field is not displayed on any areas of the PivotTable, its source data is cached because it was displayed in the PivotTable at some point. + +**fNumField:** 0x1 specifies that the [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in this cache field contain numeric data. + +**catm:** 0x0007 specifies that there are seven items in the cache item collection for this cache field. + +**stFieldName:** "UnitPrice" specifies the name of the cache field. + +Records following this record, and before the next [SXNum](#sxnum) record, are omitted for brevity. + +### PivotTable: SXNum 1 + +The next record in this example, [SXNum](#sxnum), specifies a [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d) [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in the UnitPrice [cache field](#Section_6497eb794042445780e75959c9f0583c) that is not in the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|--------------------| +| 0008 | SXNum **- SXNum** | | +| 0008 | [Xnum](#xnum) **- num** | 0x4004000000000000 | + +Figure 176: Structure of SXNum + +**num:** 0x4004000000000000 specifies the cache item's numeric value is 2.5. + +Records following this record, and before the next [SXFDB](#sxfdb) record, are omitted for brevity. + +### PivotTable: SXFDB 5 + +The next record in this example, [SXFDB](#sxfdb), specifies the Quantity [cache field](#Section_6497eb794042445780e75959c9f0583c) in the [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). This cache field appears in the [data axis](#Section_4c5c2daa289746e1854b0ce04209f060) of the [PivotTable](#Section_a5f57198f2af40b2ba07e4b1836d73f3). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------------------------------------|-----------| +| 0019 | SXFDB **- SXFDB** | | +| 1 bit | USHORT **- fAllAtoms** | 0x0 | +| 1 bit | USHORT **- fSomeUnhashed** | 0x1 | +| 1 bit | USHORT **- fUsed** | 0x0 | +| 1 bit | USHORT **- fHasParent** | 0x0 | +| 1 bit | USHORT **- fRangeGroup** | 0x0 | +| 1 bit | USHORT **- fNumField** | 0x1 | +| 1 bit | USHORT **- unused1** | 0x1 | +| 1 bit | USHORT **- fTextEtcField** | 0x0 | +| 1 bit | USHORT **- fnumMinMaxValid** | 0x1 | +| 1 bit | USHORT **- fShortIitms** | 0x0 | +| 1 bit | USHORT **- fNonDates** | 0x1 | +| 1 bit | USHORT **- fDateInField** | 0x0 | +| 1 bit | USHORT **- unused2** | 0x0 | +| 1 bit | USHORT **- fServerBased** | 0x0 | +| 1 bit | USHORT **- fCantGetUniqueItems** | 0x0 | +| 1 bit | USHORT **- fCalculatedField** | 0x0 | +| 0002 | SHORT **- ifdbParent** | 0x0000 | +| 0002 | SHORT **- ifdbBase** | 0x0000 | +| 0002 | SHORT **- citmUnq** | 0x001E | +| 0002 | SHORT **- csxoper** | 0x0000 | +| 0002 | SHORT **- cisxoper** | 0x0000 | +| 0002 | SHORT **- catm** | 0x0000 | +| 000B | [XLUnicodeString](#xlunicodestring) **- stFieldName** | Quantity | + +Figure 177: Structure of SXFDB + +Fields in this record that are explained in previous record descriptions in this example are omitted for brevity. + +**fAllAtoms:** 0x0 specifies that the [source data](#Section_e65bff19ea464f3b9798d8d2db9202b4) for this cache field is not cached. Though this cache field is displayed in the PivotTable, its source data is not cached because the cache field is displayed in the [data area](#Section_237a24905c614931923f7ee856f23c72). + +**fNumField:** 0x1 specifies that the [cache items](#Section_bdf43e0d59a04111aec09b0a6d3882a0) in this cache field contain numeric data. + +**catm:** 0x0000 is 0 because **fAllAtoms** is 0. + +**stFieldName:** "Quantity" specifies the name of this cache field. + +Records following this record, and before the next [SXDBB](#sxdbb) record, are omitted for brevity. + +### PivotTable: SXDBB 1 + +The next records in this example are a series of [SXDBB](#sxdbb) and [SXNum](#sxnum) records that specify the [cache records](#Section_fe6e4ca0a9b646a4898124e4b61a770a) for this [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). This first SXDBB specifies the first cache record. + +| **Size** | **Structure** | **Value** | +|----------|----------------------|-----------| +| 0004 | SXDBB **- SXDBB** | | +| 0004 | rgb **- blob** | | +| 0001 | BYTE **- blob\[0\]** | 0x00 | +| 0001 | BYTE **- blob\[1\]** | 0x00 | +| 0001 | BYTE **- blob\[2\]** | 0x00 | +| 0001 | BYTE **- blob\[3\]** | 0x00 | + +Figure 178: Structure of SXDBB + +**blob.blob\[0\]:** 0x00 specifies the index of the first [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) (Great Lakes Food Market) within the collection of cache items of the first [cache field](#Section_6497eb794042445780e75959c9f0583c) (CustomerName). + +**blob.blob\[1\]:** 0x00 specifies the index of the first cache item (5/6/1997) within the collection of cache items of the second cache field (OrderDate). + +**blob.blob\[2\]:** 0x00 specifies the index of the first cache item (Geitost) within the collection of cache items of the third cache field (ProductName). + +**blob.blob\[3\]:** 0x00 specifies the index of the first cache item (2.5) within the collection of cache items of the fourth cache field (UnitPrice). + +### PivotTable: SXNum 2 + +The next record in this example, [SXNum](#sxnum), specifies the [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d) value for the Quantity [cache field](#Section_6497eb794042445780e75959c9f0583c) in the [cache record](#Section_fe6e4ca0a9b646a4898124e4b61a770a) specified by the previous [SXDBB](#sxdbb). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|--------------------| +| 0008 | SXNum **- SXNum** | | +| 0008 | [Xnum](#xnum) **- num** | 0x4020000000000000 | + +Figure 179: Structure of SXNum + +**num:** 0x4020000000000000 specifies that the floating-point number value of this [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) is 8. + +This record is followed by 35 additional pairs of SXDBB and SXNum records that are omitted for brevity. + +### PivotTable: SXDBB 2 + +The next record in this example, [SXDBB](#sxdbb), specifies a [cache record](#Section_fe6e4ca0a9b646a4898124e4b61a770a) that is displayed within the [PivotTable view](#Section_09410dfbaac84a719ecf177ffba12c37). + +| **Size** | **Structure** | **Value** | +|----------|----------------------|-----------| +| 0004 | SXDBB **- SXDBB** | | +| 0004 | rgb **- blob** | | +| 0001 | BYTE **- blob\[0\]** | 0x04 | +| 0001 | BYTE **- blob\[1\]** | 0x11 | +| 0001 | BYTE **- blob\[2\]** | 0x00 | +| 0001 | BYTE **- blob\[3\]** | 0x00 | + +Figure 180: Structure of SXDBB + +**blob.blob\[0\]:** 0x04 specifies the index of the fifth [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) (Königlich Essen) within the collection of cache items of the first [cache field](#Section_6497eb794042445780e75959c9f0583c) (CustomerName). + +**blob.blob\[1\]:** 0x11 specifies the index of the eighteenth cache item (12/26/1997) within the collection of cache items of the second cache field (OrderDate). + +**blob.blob\[2\]:** 0x00 specifies the index of the first cache item (Geitost) within the collection of cache items of the third cache field (ProductName). + +**blob.blob\[3\]:** 0x00 specifies the index of the seventh cache item (2.5) within the collection of cache items of the fourth cache field (UnitPrice). + +### PivotTable: SXNum 3 + +The next record in this example, [SXNum](#sxnum), specifies the [**floating-point number**](#gt_237156df-b9cf-4b8a-9753-98001801a90d) value for the Quantity [cache field](#Section_6497eb794042445780e75959c9f0583c) in the [cache record](#Section_fe6e4ca0a9b646a4898124e4b61a770a) specified by the previous [SXDBB](#sxdbb). + +| **Size** | **Structure** | **Value** | +|----------|-------------------------|--------------------| +| 0008 | SXNum **- SXNum** | | +| 0008 | [Xnum](#xnum) **- num** | 0x4037000000000000 | + +Figure 181: Structure of SXNum + +**num:** 0x4037000000000000 specifies that the floating-point number value of this [cache item](#Section_bdf43e0d59a04111aec09b0a6d3882a0) is 23. + +Records following this record, and before the next [EOF](#eof) record, are omitted for brevity. + +### PivotTable: EOF + +The next record in this example, [EOF](#eof), specifies the end of the collection of records for this [PivotCache](#Section_a8496208d8334015938a56a0e97f9f0e). + +| **Size** | **Structure** | +|----------|---------------| +| 0000 | EOF **- EOF** | + +Figure 182: Structure of EOF + +# Security Considerations + +The password verifier features available in the file format (see [Password Verifier Algorithm](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4)) are used to prevent accidental modification, rather than being used as security features. It is possible to remove the passwords by removing the records containing the verifier values. + +The translation of passwords from a double-byte [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string to a new character string in the ANSI code page of the current system converts any Unicode character that cannot be mapped to the ANSI code page of the current system to the 0x3F character in that code page (as described in [\[ECMA-376\]](https://go.microsoft.com/fwlink/?LinkId=200054) part 4, 15.3.3). Replacing these characters with 0x3F when the [**hash**](#gt_b7e2b611-0af5-4fec-8af2-3f9ce7bad205) is verified will generate positive hash value matches. In certain locales this can be a significant portion of the everyday [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204). + +When a file in this format is saved with obfuscation or encryption (see [Encryption](#Section_0f2ea0a19fc8468d97aa9d333b72d106)), there are two primary security considerations. First, only certain storages and [**streams**](#gt_f3529cd8-50da-4f36-aa0b-66af455edbb6) are encoded during encryption (see Encryption). Second, for the records that are encrypted, the record type and size are not encrypted in the [**BIFF**](#gt_f9965de8-cd18-4e26-a9c6-adfee3d67517) streams. Therefore, the list of records present in the file can be read from the file without actually decrypting it. Further security considerations regarding the file encryption algorithms are described in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 4.1.3. + +# Appendix A: Product Behavior + +The information in this specification is applicable to the following Microsoft products or supplemental software. References to product versions include updates to those products. + +- Microsoft Excel 97 + +- Microsoft Excel 2000 + +- Microsoft Excel 2002 + +- Microsoft Office Excel 2003 + +- Microsoft Office Excel 2007 + +- Microsoft Excel 2010 + +- Microsoft Excel 2013 + +- Microsoft Excel 2016 + +- Microsoft Excel 2019 + +- Microsoft Excel 2021 + +- Microsoft Excel LTSC 2024 + +Exceptions, if any, are noted in this section. If an update version, service pack or Knowledge Base (KB) number appears with a product name, the behavior changed in that update. The new behavior also applies to subsequent updates unless otherwise specified. If a product edition appears with the product version, behavior is different in that product edition. + +Unless otherwise specified, any statement of optional behavior in this specification that is prescribed using the terms "SHOULD" or "SHOULD NOT" implies product behavior in accordance with the SHOULD or SHOULD NOT prescription. Unless otherwise specified, the term "MAY" implies that the product does not follow the prescription. + +[\<1\> Section 2.1.7.15](#Appendix_A_Target_1): Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 can write, load, and process the Signatures Stream in a file. Excel 97, Excel 2000 can load a file with a Signatures Stream but ignores it. + +[\<2\> Section 2.1.7.20.1](#Appendix_A_Target_2): When saving unsupported **future records** (section [2.1.6](#Section_b660b67822684414839ed1ae9a4e4e85)), Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 will write those records at the end of the **substream** (section [2.1.3](#Section_5e380e95a9f54dfdb6d9c6998a9772f8)) in which they were encountered during load, in the order in which they were encountered. + +[\<3\> Section 2.1.7.20.2](#Appendix_A_Target_3): When saving unsupported **future records** (section 2.1.6), Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 will write those records at the end of the **substream** (section 2.1.3) in which they were encountered during load, in the order in which they were encountered. + +[\<4\> Section 2.1.7.20.2](#Appendix_A_Target_4): If a **Continue** record (section [2.4.58](#continue)) is needed in the **MSODRAWING** rule (section [2.1.7.20.2](#Section_da37feb48b9a462d87772a5fddd4866e)), Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 can write out an **MsoDrawing** record (section [2.4.170](#msodrawing)) instead of the first **Continue** record (section 2.4.58). + +[\<5\> Section 2.1.7.20.3](#Appendix_A_Target_5): When saving unsupported **future records** (section 2.1.6), Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 will write those records at the end of the **substream** (section 2.1.3) in which they were encountered during load, in the order in which they were encountered. + +[\<6\> Section 2.1.7.20.3](#Appendix_A_Target_6): If a **Continue** record (section 2.4.58) is needed in the **MSODRAWINGGROUP** rule, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 can write out an **MsoDrawingGroup** record (section [2.4.171](#msodrawinggroup)) instead of the first **Continue** record (section 2.4.58). + +[\<7\> Section 2.1.7.20.4](#Appendix_A_Target_7): When saving unsupported **future records** (section 2.1.6), Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 will write those records at the end of the **substream** (section 2.1.3) in which they were encountered during load, in the order in which they were encountered. + +[\<8\> Section 2.1.7.20.5](#Appendix_A_Target_8): When saving unsupported **future records** (section 2.1.6), Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 will write those records at the end of the **substream** (section 2.1.3) in which they were encountered during load, in the order in which they were encountered. + +[\<9\> Section 2.1.7.20.6](#Appendix_A_Target_9): When saving unsupported **future records** (section 2.1.6), Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 will write those records at the end of the **substream** (section 2.1.3) in which they were encountered during load, in the order in which they were encountered. + +[\<10\> Section 2.1.7.20.6](#Appendix_A_Target_10): Office Excel 2007, Excel 2010, and Excel 2013 can save out a CELLTABLE without a **Row** record (section [2.4.221](#row)). + +[\<11\> Section 2.1.7.20.6](#Appendix_A_Target_11): If a **Continue** record (section 2.4.58) is needed in the **MSODRAWING** rule (section 2.1.7.20.2), Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 can write out an **MsoDrawing** record (section 2.4.170) instead of the first **Continue** record. + +[\<12\> Section 2.1.7.21](#Appendix_A_Target_12): Only Office Excel 2007 and Excel 2010 can write the **XML Signatures storage**. Only Office Excel 2007 and Excel 2010 can load and process a file with a **XML Signatures storage**; Excel 97, Excel 2000, Excel 2002, Office Excel 2003 can load a file with a **XML Signatures storage** but ignore it. + +[\<13\> Section 2.2.3.11](#Appendix_A_Target_13): Graph Component for Excel 97, Graph Component for Excel 2000, Graph Component for Excel 2002, Graph Component for Office Excel 2003, Graph Component for Office Excel 2007, and Graph Component for Excel 2010 can create files that do not conform to these rules. + +[\<14\> Section 2.2.3.11](#Appendix_A_Target_14): Graph Component for Excel 97, Graph Component for Excel 2000, Graph Component for Excel 2002, Graph Component for Office Excel 2003, Graph Component for Office Excel 2007, and Graph Component for Excel 2010 can create files that do not conform to these rules. + +[\<15\> Section 2.2.3.11](#Appendix_A_Target_15): Graph Component for Excel 97, Graph Component for Excel 2000, Graph Component for Excel 2002, Graph Component for Office Excel 2003, Graph Component for Office Excel 2007, and Graph Component for Excel 2010 can create files that do not conform to these rules. + +[\<16\> Section 2.2.3.11](#Appendix_A_Target_16): Graph Component for Excel 97, Graph Component for Excel 2000, Graph Component for Excel 2002, Graph Component for Office Excel 2003, Graph Component for Office Excel 2007, and Graph Component for Excel 2010 can create files that do not conform to these rules. + +[\<17\> Section 2.2.3.11](#Appendix_A_Target_17): Graph Component for Excel 97, Graph Component for Excel 2000, Graph Component for Excel 2002, Graph Component for Office Excel 2003, Graph Component for Office Excel 2007, and Graph Component for Excel 2010 can create files that do not conform to these rules. + +[\<18\> Section 2.2.4.3](#Appendix_A_Target_18): Office Excel 2007 and Excel 2010 save metadata records when cells contain formulas referencing [**cube functions**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3). However, this metadata does not remain associated with the cells and is only recorded for the purpose of load and calculation optimization. + +[\<19\> Section 2.2.9](#Appendix_A_Target_19): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 warn the user when they enter passwords that contain characters other than alphanumeric characters or punctuation symbols. + +[\<20\> Section 2.2.10](#Appendix_A_Target_20): In Excel 97, Excel 2000, Excel 2002, and Office Excel 2003 the maximum password length is 15 characters. In Office Excel 2007 and Excel 2010 the maximum password length is 255 characters. + +[\<21\> Section 2.2.10](#Appendix_A_Target_21): Only Excel 2002 and Office Excel 2003 will save files with XOR obfuscation. + +[\<22\> Section 2.2.10](#Appendix_A_Target_22): Only Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 will load and save files with RC4 CryptoAPI encryption. + +[\<23\> Section 2.4.3](#Appendix_A_Target_23): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 write a value for this field but ignore it on load. + +[\<24\> Section 2.4.3](#Appendix_A_Target_24): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 write a value for this field but ignore it on load. + +[\<25\> Section 2.4.9](#Appendix_A_Target_25): When the base unit is not days, and the data is near the base value of the [**date system**](#gt_cfc29c5e-eb23-4077-b6eb-492f20f5c87f) specified by the **Date1904 record** (section [2.4.77](#date1904)), **catMin** value can underflow and get saved as a large number. + +[\<26\> Section 2.4.9](#Appendix_A_Target_26): When the base unit is not days, and the data is near the maximum value of the date system specified by the **Date1904 record** (section 2.4.77), **catMax** value can overflow and get saved as a small number. + +[\<27\> Section 2.4.21](#Appendix_A_Target_27): Excel 97 writes 0x07CC for **rupYear**. + +[\<28\> Section 2.4.21](#Appendix_A_Target_28): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, and Excel 2013 set the value to 0 on creation, and change it to 1 in subsequent loading and saving. + +[\<29\> Section 2.4.21](#Appendix_A_Target_29): This happens only for Excel 97. + +[\<30\> Section 2.4.21](#Appendix_A_Target_30): Excel 97. + +[\<31\> Section 2.4.21](#Appendix_A_Target_31): Excel 2000. + +[\<32\> Section 2.4.21](#Appendix_A_Target_32): Excel 2002. + +[\<33\> Section 2.4.21](#Appendix_A_Target_33): Office Excel 2003. + +[\<34\> Section 2.4.21](#Appendix_A_Target_34): Office Excel 2007. + +[\<35\> Section 2.4.21](#Appendix_A_Target_35): Excel 2010 + +[\<36\> Section 2.4.21](#Appendix_A_Target_36): Excel 2013 + +[\<37\> Section 2.4.21](#Appendix_A_Target_37): Excel 97. + +[\<38\> Section 2.4.21](#Appendix_A_Target_38): Excel 2000. + +[\<39\> Section 2.4.21](#Appendix_A_Target_39): Excel 2002. + +[\<40\> Section 2.4.21](#Appendix_A_Target_40): Office Excel 2003. + +[\<41\> Section 2.4.21](#Appendix_A_Target_41): Office Excel 2007. + +[\<42\> Section 2.4.21](#Appendix_A_Target_42): Excel 2010. + +[\<43\> Section 2.4.21](#Appendix_A_Target_43): Excel 2013 + +[\<44\> Section 2.4.22](#Appendix_A_Target_44): Office Excel 2003, Office Excel 2007, and Excel 2010 will prompt the user in this case. + +[\<45\> Section 2.4.22](#Appendix_A_Target_45): This behavior does not apply to Office Excel 2007 and Excel 2010. + +[\<46\> Section 2.4.30](#Appendix_A_Target_46): Specifies either Excel 97, Excel 2000, Excel 2002, or Office Excel 2003. + +[\<47\> Section 2.4.30](#Appendix_A_Target_47): Specifies either Office Excel 2007 or Excel 2010. + +[\<48\> Section 2.4.45](#Appendix_A_Target_48): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 save negative values, but at load time the negative values are corrected to 0. + +[\<49\> Section 2.4.45](#Appendix_A_Target_49): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 save negative values, but at load time the negative values are corrected to 0. + +[\<50\> Section 2.4.45](#Appendix_A_Target_50): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 save negative values, but at load time the negative values are corrected to 0. + +[\<51\> Section 2.4.45](#Appendix_A_Target_51): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 save negative values, but at load time the negative values are corrected to 0. + +[\<52\> Section 2.4.46](#Appendix_A_Target_52): Office Excel 2007 and Excel 2010 can save values greater than or equal to 0 and less than or equal to 200. In Office Excel 2007 and Excel 2010 the view angle is determined by dividing this value by a factor of 2. + +[\<53\> Section 2.4.46](#Appendix_A_Target_53): Office Excel 2007 and Excel 2010 can save values less than 5. + +[\<54\> Section 2.4.46](#Appendix_A_Target_54): Office Excel 2007 and Excel 2010 can save values greater than 500. + +[\<55\> Section 2.4.46](#Appendix_A_Target_55): Office Excel 2007 and Excel 2010 ignores this bit and will set it back to zero if the file is resaved. + +[\<56\> Section 2.4.49](#Appendix_A_Target_56): Excel 2000 + +[\<57\> Section 2.4.49](#Appendix_A_Target_57): Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, Excel 2010, or Excel 2013 + +[\<58\> Section 2.4.49](#Appendix_A_Target_58): Office Excel 2007 + +[\<59\> Section 2.4.49](#Appendix_A_Target_59): Excel 97 + +[\<60\> Section 2.4.49](#Appendix_A_Target_60): Excel 97 + +[\<61\> Section 2.4.49](#Appendix_A_Target_61): Excel 2000 + +[\<62\> Section 2.4.49](#Appendix_A_Target_62): Excel 2002, Office Excel 2003 + +[\<63\> Section 2.4.49](#Appendix_A_Target_63): Office Excel 2007 + +[\<64\> Section 2.4.49](#Appendix_A_Target_64): Excel 2010 + +[\<65\> Section 2.4.49](#Appendix_A_Target_65): Excel 2013 + +[\<66\> Section 2.4.49](#Appendix_A_Target_66): Excel 2000 + +[\<67\> Section 2.4.49](#Appendix_A_Target_67): Excel 2002, Office Excel 2003 + +[\<68\> Section 2.4.49](#Appendix_A_Target_68): Office Excel 2007 + +[\<69\> Section 2.4.49](#Appendix_A_Target_69): Excel 2010 + +[\<70\> Section 2.4.49](#Appendix_A_Target_70): Excel 2013 + +[\<71\> Section 2.4.54](#Appendix_A_Target_71): Specifies Office Excel 2007, or Excel 2010. + +[\<72\> Section 2.4.54](#Appendix_A_Target_72): Specifies Office Excel 2003, Excel 2002, Excel 2000, or Excel 97. + +[\<73\> Section 2.4.54](#Appendix_A_Target_73): Specifies Office Excel 2003, Excel 2002, Excel 2000, or Excel 97. + +[\<74\> Section 2.4.54](#Appendix_A_Target_74): Specifies Office Excel 2003, Excel 2002, Excel 2000, or Excel 97. + +[\<75\> Section 2.4.74](#Appendix_A_Target_75): Office Excel 2007 and Excel 2010 can save values greater than 254. + +[\<76\> Section 2.4.74](#Appendix_A_Target_76): Though the maximum zero-based series number is 254, Office Excel 2007 and Excel 2010 can save values greater than 254. + +[\<77\> Section 2.4.91](#Appendix_A_Target_77): This structure is not loaded or saved by Office Excel 2007 and Excel 2010. + +[\<78\> Section 2.4.97](#Appendix_A_Target_78): Office Excel 2003 , Excel 2002, Excel 2000, and Excel 97 can save out 0 for this field. In these cases, if the **xfprops** field specifies a solid fill pattern as part of the formatting properties, the pattern's color is stored in the background color instead of the foreground color. + +[\<79\> Section 2.4.102](#Appendix_A_Target_79): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 write out this record on save. + +[\<80\> Section 2.4.102](#Appendix_A_Target_80): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 do not ignore this record. + +[\<81\> Section 2.4.104](#Appendix_A_Target_81): Specifies Excel 97. + +[\<82\> Section 2.4.105](#Appendix_A_Target_82): Specifies Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, or Excel 2010. + +[\<83\> Section 2.4.107](#Appendix_A_Target_83): Excel 97 can saves out a different number of elements. + +[\<84\> Section 2.4.109](#Appendix_A_Target_84): This record is ignored in Office Excel 2007, and Excel 2010. + +[\<85\> Section 2.4.110](#Appendix_A_Target_85): This record is ignored in Office Excel 2007 and Excel 2010. + +[\<86\> Section 2.4.117](#Appendix_A_Target_86): This value is 0x0001 for files created using Office Excel 2007 and Excel 2010. + +[\<87\> Section 2.4.122](#Appendix_A_Target_87): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save out 0 for certain [**fonts**](#gt_f8aa3f46-99d1-49bb-858f-b4bfa546c1c2). + +[\<88\> Section 2.4.122](#Appendix_A_Target_88): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can also write out the value 0 to specify a black font, or the value 72 to specify the automatic color for a control. + +[\<89\> Section 2.4.122](#Appendix_A_Target_89): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can also write out values 0 and 100 through 1000 (inclusive). + +[\<90\> Section 2.4.122](#Appendix_A_Target_90): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save values greater than 5. + +[\<91\> Section 2.4.126](#Appendix_A_Target_91): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 save values of 383 to 392. + +[\<92\> Section 2.4.129](#Appendix_A_Target_92): Specifies Excel 2000. + +[\<93\> Section 2.4.129](#Appendix_A_Target_93): Specifies Excel 2002. + +[\<94\> Section 2.4.131](#Appendix_A_Target_94): If two consecutive GelFrame records appear, the second GelFrame is a continuation of the first. + +[\<95\> Section 2.4.131](#Appendix_A_Target_95): Excel 97 does not save OPT2. + +[\<96\> Section 2.4.133](#Appendix_A_Target_96): Office Excel 2007 and Excel 2010 uses this [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) to determine if the [**VBA**](#gt_bc3968c6-4bd2-40a2-8619-5cd7695b3e4f) project needs to be recompiled on load by comparing the GUID in the file to the GUID built into the application. If the value is 0x0, the VBA project needs to be recompiled on load. + +[\<97\> Section 2.4.150](#Appendix_A_Target_97): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save any value from 0 to 0xFF. + +[\<98\> Section 2.4.154](#Appendix_A_Target_98): This structure is not loaded or saved by Office Excel 2007 and Excel 2010 + +[\<99\> Section 2.4.159](#Appendix_A_Target_99): This structure is not loaded or saved by Office Excel 2007 and Excel 2010. + +[\<100\> Section 2.4.191](#Appendix_A_Target_100): If the value of the **wPassword** field of the [Password](#password) record in the [Globals Substream](#Section_ca4c174887294a93abb94602b3a01fb1) is not 0x0000, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 encrypt the document as specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083), section 2.3. If an encryption password is not specified or the workbook or sheet is only protected, the document is encrypted with the default password of "\x56\x65\x6C\x76\x65\x74\x53\x77\x65\x61\x74\x73\x68\x6F\x70". + +[\<101\> Section 2.4.196](#Appendix_A_Target_101): Excel 97 and Excel 2000 do not save this field as part of the record. + +[\<102\> Section 2.4.196](#Appendix_A_Target_102): Excel 97 and Excel 2000 do not save this field as part of the record. + +[\<103\> Section 2.4.196](#Appendix_A_Target_103): Excel 97 and Excel 2000 do not save this field as part of the record. + +[\<104\> Section 2.4.206](#Appendix_A_Target_104): If the value of the **protPwdRev** field of the [Prot4RevPass](#prot4revpass) record is not 0x0000, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 encrypt the document as specified in \[MS-OFFCRYPTO\], section 2.3. If an encryption password is not specified or the workbook or sheet is only protected, the document is encrypted with the default password of "\x56\x65\x6C\x76\x65\x74\x53\x77\x65\x61\x74\x73\x68\x6F\x70". + +[\<105\> Section 2.4.208](#Appendix_A_Target_105): In the case of Excel 97 this bit specifies whether the [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) adjusts column width after refresh. If this bit is set to 1 and the **fPreserveFmt** field in the corresponding **dwQsiFuture** field of the [QsiSXTag](#qsisxtag) is set to 1 then the column width is not adjusted after refresh. + +[\<106\> Section 2.4.210](#Appendix_A_Target_106): Excel 97 + +[\<107\> Section 2.4.210](#Appendix_A_Target_107): Excel 2000 + +[\<108\> Section 2.4.210](#Appendix_A_Target_108): Excel 2002 + +[\<109\> Section 2.4.210](#Appendix_A_Target_109): Office Excel 2003 + +[\<110\> Section 2.4.210](#Appendix_A_Target_110): Office Excel 2007 + +[\<111\> Section 2.4.210](#Appendix_A_Target_111): Excel 2010 + +[\<112\> Section 2.4.210](#Appendix_A_Target_112): Excel 2013 + +[\<113\> Section 2.4.216](#Appendix_A_Target_113): This structure is not loaded or saved by Office Excel 2007 or Excel 2010. + +[\<114\> Section 2.4.218](#Appendix_A_Target_114): This record was introduced in Office Excel 2007 as a future record type. Consequently, it is preserved in [**BIFF8**](#gt_e60b71bb-c66c-4a44-ab07-0f9f20ee3dd5) format, but ignored by Office Excel 2003, Excel 2002, Excel 2000, and Excel 97. + +[\<115\> Section 2.4.241](#Appendix_A_Target_115): If the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) contains more than 4112 [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d), then Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save a file in which any record that references a sheet identifier can reference the wrong sheet. + +[\<116\> Section 2.4.248](#Appendix_A_Target_116): Office Excel 2007 and Excel 2010 will save at most 512 RefU in the rgref array of a Selection record. Office Excel 2003, Excel 2002, Excel 2000, and Excel 97 will save at most 1025 RefU in the rgref array of a Selection record. + +[\<117\> Section 2.4.258](#Appendix_A_Target_117): This record was introduced in Office Excel 2007 as a Future Record Type. Consequently, it is preserved in BIFF8 format, but ignored by Office Excel 2003, Excel 2002, Excel 2000, and Excel 97. + +[\<118\> Section 2.4.258](#Appendix_A_Target_118): This [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) stream is ignored by Office Excel 2003, Excel 2002, Excel 2000, and Excel 97. + +[\<119\> Section 2.4.259](#Appendix_A_Target_119): Saved only by Office Excel 2007 and Excel 2010. + +[\<120\> Section 2.4.267](#Appendix_A_Target_120): Excel 97 + +[\<121\> Section 2.4.267](#Appendix_A_Target_121): Excel 2000 + +[\<122\> Section 2.4.267](#Appendix_A_Target_122): Excel 2002 + +[\<123\> Section 2.4.267](#Appendix_A_Target_123): Office Excel 2003 + +[\<124\> Section 2.4.267](#Appendix_A_Target_124): Office Excel 2007 + +[\<125\> Section 2.4.267](#Appendix_A_Target_125): Excel 2010 + +[\<126\> Section 2.4.267](#Appendix_A_Target_126): Excel 2013 + +[\<127\> Section 2.4.269](#Appendix_A_Target_127): Excel 2010, Office Excel 2007, Office Excel 2003, Excel 2002, Excel 2000, and Excel 97 save out an [XLUnicodeString](#xlunicodestring) structure with 0 characters. + +[\<128\> Section 2.4.273.9](#Appendix_A_Target_128): Excel 2000 has a maximum value of 8000. Excel 2002 and Office Excel 2003 have a maximum value of 32500. Values greater than these are treated as these maximums by these applications. + +[\<129\> Section 2.4.273.108](#Appendix_A_Target_129): In certain circumstances Office Excel 2003, Excel 2002, and Excel 2000 can save out a higher value. + +[\<130\> Section 2.4.281](#Appendix_A_Target_130): Office Excel 2007 and Excel 2010 can save out **wbe** with a value of 0x2B + +[\<131\> Section 2.4.310](#Appendix_A_Target_131): Excel 97 does not create this field and ignores it if present. + +[\<132\> Section 2.4.324](#Appendix_A_Target_132): Excel can write numbers larger than 4000 due to rounding while editing small charts. + +[\<133\> Section 2.4.324](#Appendix_A_Target_133): Excel can write numbers larger than 4000 due to rounding while editing small charts. + +[\<134\> Section 2.4.324](#Appendix_A_Target_134): Excel can write numbers larger than 4000 due to rounding while editing small charts. + +[\<135\> Section 2.4.324](#Appendix_A_Target_135): Excel can write numbers larger than 4000 due to rounding while editing small charts. + +[\<136\> Section 2.4.325](#Appendix_A_Target_136): This record was introduced in Office Excel 2007 as a Future Record Type. Consequently, it is preserved in BIFF8 format, but ignored by Office Excel 2003, Excel 2002, Excel 2000, and Excel 97. + +[\<137\> Section 2.4.326](#Appendix_A_Target_137): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save value 123820, which also indicates default [**theme**](#gt_8b5eb4c0-949b-47d9-8b63-b9bda81d61b8). + +[\<138\> Section 2.4.329](#Appendix_A_Target_138): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 also use the value "2" to specify justify low alignment. Justify low occurs when Arabic kashida justification is applied to the text. Justify low lengthens kashidas slightly. + +[\<139\> Section 2.4.329](#Appendix_A_Target_139): Justified alignment is not supported in Office Excel 2007 and Excel 2010 and is treated as middle alignment. + +[\<140\> Section 2.4.329](#Appendix_A_Target_140): Excel 97 – East Asian version, Excel 2000 – East Asian version, Excel 2002 – East Asian version, Office Excel 2003 – East Asian version, or Office Excel 2007 – East Asian version, or Excel 2010 – East Asian version. + +[\<141\> Section 2.4.335](#Appendix_A_Target_141): Excel 97, Excel 2000, Excel 2002, and Office Excel 2003 do not set this bit to 1. + +[\<142\> Section 2.4.337](#Appendix_A_Target_142): Excel 97, Excel 2000, Excel 2002, and Office Excel 2003 can save out a value of 0x0001, indicating that natural language formulas are enabled. This feature is deprecated in Office Excel 2007 and Excel 2010. + +[\<143\> Section 2.4.344](#Appendix_A_Target_143): Stream does not exist in Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, or Excel 2010. + +[\<144\> Section 2.4.346](#Appendix_A_Target_144): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 truncate **wScaleSLV** into a byte when saving. + +[\<145\> Section 2.4.346](#Appendix_A_Target_145): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 truncate **wScaleNormal** into a byte when saving. + +[\<146\> Section 2.4.353](#Appendix_A_Target_146): If the Transition Navigation Keys option is turned on, the set of prefix characters is single quote, double quote, caret, and backslash, which indicate left-alignment, right-alignment, center-alignment, and fill alignment, respectively. If the Transition Navigation Keys option is turned off, the only possible prefix character is single quote, which has no alignment significance but indicates (like all prefix characters) that the cell contents are to be treated as a string literal. + +[\<147\> Section 2.4.353](#Appendix_A_Target_147): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save 0 in this field when **fStyle** equals 1. + +[\<148\> Section 2.5.4](#Appendix_A_Target_148): Can be 0 if **year** is equal to 1900 and **month** is equal to 1 and the calendar is Gregorian. + +[\<149\> Section 2.5.9](#Appendix_A_Target_149): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save XL8_ITBLJAPAN2, XL8_ITBLJAPAN3, XL8_ITBLJAPAN4, and XL8_ITBLNONE_JPN as 0x0000, 0x0001, 0x0002, and 0x0003. In this case, values 0x0000 through 0x0010 are saved as 0x0004 through 0x0014. + +[\<150\> Section 2.5.10](#Appendix_A_Target_150): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save bBoolErr with an error value instead of a Boolean value when fError is 0x00. + +[\<151\> Section 2.5.16](#Appendix_A_Target_151): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 save out 0xFF. + +[\<152\> Section 2.5.20](#Appendix_A_Target_152): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 also save out 0 to specify a black background. + +[\<153\> Section 2.5.21](#Appendix_A_Target_153): The Alpha channel value in the [LongRGBA](#longrgba) structure is ignored and set to 0xFF (opaque). + +[\<154\> Section 2.5.27](#Appendix_A_Target_154): If Office Excel 2007 or Excel 2010 save different values for **cp** in the [CFEx](#cfex) and [CF](#cf) records, then the value in CFEx takes precedence over the value in CF. + +[\<155\> Section 2.5.32](#Appendix_A_Target_155): Office Excel 2007 and Excel 2010 will not apply any coloring to a cell when its CFVO value falls outside of the range of the interpolation curve and **fClamp** is not set. + +[\<156\> Section 2.5.60](#Appendix_A_Target_156): Specifies Excel 97. + +[\<157\> Section 2.5.60](#Appendix_A_Target_157): Specifies Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, or Excel 2010. + +[\<158\> Section 2.5.60](#Appendix_A_Target_158): Specifies Excel 97. + +[\<159\> Section 2.5.60](#Appendix_A_Target_159): Specifies Excel 2000. + +[\<160\> Section 2.5.63](#Appendix_A_Target_160): The following table shows the maximum [data functionality levels](#Section_2bcedd76ef064e6084c718ea55042ed6) that different application versions support: + +| Value | Maximum data functionality level for | +|-------|--------------------------------------| +| 0 | Excel 97 and Excel 2000 | +| 1 | Excel 2002 and Office Excel 2003 | +| 3 | Office Excel 2007 | +| 4 | Excel 2010 | + +[\<161\> Section 2.5.63](#Appendix_A_Target_161): In Excel 97, Excel 2000, Excel 2002, and Office Excel 2003, the values of some data functionality level fields might not reflect the correct data functionality level. + +[\<162\> Section 2.5.65](#Appendix_A_Target_162): In the 1900 date system, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 treat the year 1900 as though it was a leap year. That is, the value 59 corresponds to February 28, and the value 61 corresponds to March 1, allowing the (non-existent) date February 29 to have the value 60. + +[\<163\> Section 2.5.91](#Appendix_A_Target_163): Office Excel 2007 and Excel 2010 can saves a value greater than 15 and less than 255. + +[\<164\> Section 2.5.113](#Appendix_A_Target_164): This value is only possible in the context of a [Feature12](#feature12) record, and cannot be written by Office Excel 2003. + +[\<165\> Section 2.5.113](#Appendix_A_Target_165): Office Excel 2003 does not save the **totalFmla** field; **fLoadTotalFmla** is 0. + +[\<166\> Section 2.5.118](#Appendix_A_Target_166): This structure only exists in the context of a Feature12 record, and cannot be written by Office Excel 2003. + +[\<167\> Section 2.5.127](#Appendix_A_Target_167): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can write out values 0x13 through 0x24. + +[\<168\> Section 2.5.129](#Appendix_A_Target_168): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save out values 511 through 1022. + +[\<169\> Section 2.5.129](#Appendix_A_Target_169): These 4 default structures are saved out as identical [Font](#font) structures. They are placeholders for their respective font formatting properties. + +[\<170\> Section 2.5.130](#Appendix_A_Target_170): This value is ignored in Office Excel 2007 and Excel 2010. + +[\<171\> Section 2.5.134](#Appendix_A_Target_171): The [Feature11](#feature11) and Feature12 records set the **ref8.rwFirst**, **ref8.rwLast**, **ref8.colFirst**, and **ref8.colLast** fields even if **fFrtRef** is 0. + +[\<172\> Section 2.5.143](#Appendix_A_Target_172): Excel 97, Excel 2000, Excel 2002, and Office Excel 2003 all write out a value of 0 for this field and ignore it on load. + +[\<173\> Section 2.5.162](#Appendix_A_Target_173): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can write out [Icv](#icv) values 0x0000 and 0x0001. Office Excel 2007 and Excel 2010 can also writes out Icv values that are greater than or equal to 0x0002 and less than or equal to 0x0007. + +[\<174\> Section 2.5.164](#Appendix_A_Target_174): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can writes out Icv values greater than or equal to 0x01 and less than or equal to 0x07, or the value 0x48, which specifies the system color for text in windows. + +[\<175\> Section 2.5.165](#Appendix_A_Target_175): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can write values greater than or equal to 0x017F and less than or equal to 0x0188, but they will not be loaded. + +[\<176\> Section 2.5.198.18](#Appendix_A_Target_176): In Office Excel 2007 and Excel 2010, [**natural language formulas**](#gt_d0a0a676-1ee8-4783-8862-15d57fb9456b) are transformed into [**A1**](#gt_950691d0-4b64-4e03-84ae-10d6c872bbdb) references. + +[\<177\> Section 2.5.198.23](#Appendix_A_Target_177): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can write out an **rgce** which contain [PtgArray](#ptgarray). + +[\<178\> Section 2.5.198.104](#Appendix_A_Target_178): Excel 97, Excel 2000, Excel 2002 and Office Excel 2003 write out these [Ptg](#ptg)s. Office Excel 2007 and Excel 2010 convert these Ptgs to equivalent [PtgArea](#ptgarea)s or [PtgAreaErr](#ptgareaerr)s on load and never introduces these Ptgs. + +[\<179\> Section 2.5.203](#Appendix_A_Target_179): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 expect the **cbKey** field in the **PictFmlaKey** structure to be an even value. + +[\<180\> Section 2.5.244](#Appendix_A_Target_180): ltExternalData is only read and saved by Office Excel 2007 and Excel 2010. + +[\<181\> Section 2.5.248](#Appendix_A_Target_181): Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 can save out 0 for certain fonts. + +[\<182\> Section 2.5.248](#Appendix_A_Target_182): Office Excel 2003, Office Excel 2007, and Excel 2010 can also write out 0. + +[\<183\> Section 2.5.266](#Appendix_A_Target_183): Office Excel 2003 has unique table identifiers per sheet rather than per workbook. On load, Office Excel 2007 and Excel 2010 reassigns new identifiers if identical ones exist within a same workbook. + +[\<184\> Section 2.5.266](#Appendix_A_Target_184): Set to 0x1 in case of Web-based [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) list [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for [**worksheets**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) created using Office Excel 2003. + +[\<185\> Section 2.5.266](#Appendix_A_Target_185): Office Excel 2007 and Excel 2010 will only write out the value of 1 for this field. + +[\<186\> Section 2.5.266](#Appendix_A_Target_186): Office Excel 2003 saves 0xB, Office Excel 2007 saves 0xC, Excel 2010 saves 0xE. + +[\<187\> Section 2.5.266](#Appendix_A_Target_187): Office Excel 2003, Office Excel 2007, and Excel 2010 do not ignore this field. + +[\<188\> Section 2.5.272](#Appendix_A_Target_188): For files last saved in East Asian versions of the application, **lastRun** can be a [Run](#run) instead of a [TxoLastRun](#txolastrun). + +[\<189\> Section 2.5.282](#Appendix_A_Target_189): Specifies Office Excel 2007. + +[\<190\> Section 2.5.314](#Appendix_A_Target_190): Office Excel 2007 and Excel 2010 can save values larger than 500. + +[\<191\> Section 2.5.342](#Appendix_A_Target_191): Under certain circumstances, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 persist these values. + +[\<192\> Section 2.5.344](#Appendix_A_Target_192): Office Excel 2003, Office Excel 2007, and Excel 2010 can save a value of -1 on the **itabLast** field for either a workbook-level or a sheet-level reference to an [external workbook](#Section_c8bd9cdbb0784622a3bffb87f35a36cc) if an [**Information Rights Management (IRM)**](#gt_ff35237a-a497-42aa-b0d5-7a0116328759) authorization failure occurred during a refresh of that workbook's data. + +[\<193\> Section 2.6.2](#Appendix_A_Target_193): Web-only view is only used by Excel 97, Excel 2000, Excel 2002, and Office Excel 2003. + +# Change Tracking + +This section identifies changes that were made to this document since the last release. Changes are classified as Major, Minor, or None. + +The revision class **Major** means that the technical content in the document was significantly revised. Major changes affect protocol interoperability or implementation. Examples of major changes are: + +- A document revision that incorporates changes to interoperability requirements. + +- A document revision that captures changes to protocol functionality. + +The revision class **Minor** means that the meaning of the technical content was clarified. Minor changes do not affect protocol interoperability or implementation. Examples of minor changes are updates to clarify ambiguity at the sentence, paragraph, or table level. + +The revision class **None** means that no new technical changes were introduced. Minor editorial and formatting changes may have been made, but the relevant technical content is identical to the last released version. + +The changes made to this document are listed in the following table. For more information, please contact . + +| Section | Description | Revision class | +|----|----|----| +| [2.2.5.4.7.2](#Section_bd4665ebb56a44e690b9ceaf7ec55389) OLAP Manual Filters | Formatted the member glossary. | Minor | +| [2.2.6.3](#Section_4ac7212b4aa74ece962526c58224ae80) Table Styles | Updated '\[ECMA-376\] part 4, 3.8.40' to '\[ECMA-376\] part 1, 18.8.40'. | Minor | +| [2.2.9](#Section_e8a5fbec6cdc40d89fef9ad80e4172f4) Password Verifier Algorithm | Updated '\[ECMA-376\] part 4, 3.2.29' to '\[ECMA-376\] Part 4, 15.3.3'. | Minor | +| [2.2.10](#Section_0f2ea0a19fc8468d97aa9d333b72d106) Encryption (Password to Open) | Updated '\[ECMA-376\] part 4, 3.2.29' to '\[ECMA-376\] Part 4, 15.3.3'. | Minor | +| [2.4.117](#filepass) FilePass | Updated 'For more information' to 'For more details'. | Minor | +| [2.4.126](#format) Format | Updated '\[ECMA-376\] Part 4: Markup Language Reference, section 3.8.31' to 'ECMA-376\] Part 1: Fundamentals And Markup Language Reference, section 18.8.31'. | Minor | +| [2.4.182](#objectlink) ObjectLink | Formatted the category glossary. | Minor | +| [2.4.193](#picf) PicF | Formatted the dimension glossary. | Minor | +| [2.4.218](#richtextstream) RichTextStream | Updated '\[ECMA-376\] Part 4, section 5.7.2.217' to '\[ECMA-376\] Part 1, section 21.2.2.216'. | Minor | +| [2.4.223](#rrdchgcell) RRDChgCell | Updated '\[ECMA-376\] Part 4: Markup Language Reference, section 3.8.31' to 'ECMA-376\] Part 1: Fundamentals And Markup Language Reference, section 18.8.31'. | Minor | +| [2.4.258](#shapepropsstream) ShapePropsStream | Updated '\[ECMA-376\] Part 4, section 5.7.2.198' to '\[ECMA-376\] Part 1, section 21.2.2.197'. | Minor | +| [2.4.266](#startblock) StartBlock | Formatted the category glossary. | Minor | +| [2.4.325](#textpropsstream) TextPropsStream | Updated '\[ECMA-376\] Part 4, section 5.7.2.217' to '\[ECMA-376\] Part 1, section 21.2.2.216'. | Minor | +| [2.5.16](#builtinstyle) BuiltInStyle | Updated '\[ECMA-376\] Part 4: Markup Language Reference, section 3.8.7' to '\[ECMA-376\] Part 1: Fundamentals And Markup Language Reference, section 8.8.7'. | Minor | +| [2.5.113](#feat11fielddataitem) Feat11FieldDataItem | Updated 'For more information' to 'For more details'. | Minor | +| [2.5.165](#ifmt) IFmt | Updated '\[ECMA-376\] Part 4: Markup Language Reference, section 3.8.30' to '\[ECMA-376\] Part 1: Fundamentals And Markup Language Reference, section 18.8.30'. | Minor | +| [2.5.192](#officeartclientanchorhf) OfficeArtClientAnchorHF | Formatted the dimension glossary. | Minor | +| [2.5.305](#xmltkcolormappingoverride) XmlTkColorMappingOverride | Updated '\[ECMA-376\] Part 4, section 4.4.1.7' to '\[ECMA-376\] Part 1, section 19.3.1.7'. | Minor | +| [2.5.312](#xmltkformatcodefrt) XmlTkFormatCodeFrt | Updated '\[ECMA-376\] Part 4: Markup Language Reference, section 3.8.31' to 'ECMA-376\] Part 1: Fundamentals And Markup Language Reference, section 18.8.31'. | Minor | +| [2.5.330](#xmltkspb) XmlTkSpb | Updated '\[ECMA-376\] Part 4, section 5.7.2.198' to '\[ECMA-376\] Part 1, section 21.2.2.197'. | Minor | +| [2.5.336](#xmltkthemeoverride) XmlTkThemeOverride | Updated '\[ECMA-376\] Part 4, section 5.1.8.12' to '\[ECMA-376\] Part 1, section 20.1.6.12'. | Minor | +| [2.5.341](#xmltktpb) XmlTkTpb | Updated '\[ECMA-376\] Part 4, section 5.7.2.217' to '\[ECMA-376\] Part 1, section 21.2.2.216'. | Minor | +| [2.7.1](#Section_9b5f0e3c743b4680b0aa2ac80730c325) Application Data For VtHyperlink | Updated 'shape \[MS-ODRAW\] section 2.2.31' to 'shape \[MS-ODRAW\] section 2.3.2'. | Minor | +| [3.6.1](#Section_4be49154bbba4fc58611c4c0e2d4df43) Column Chart Object: Chart | Formatted the dimension glossary. | Minor | +| [3.6.12](#Section_7dbf98b4b476424b8ac4e4ce4b97e955) Column Chart Object: ShtProps | Formatted the dimension glossary. | Minor | +| [3.6.19](#Section_af132675460a4d5890ba0c37bdbed3fe) Column Chart Object: CatSerRange | Formatted the category glossary. | Minor | +| [4](#Section_6df63a1fecd54d13801ea5321aa39caa) Security Considerations | Updated '\[ECMA-376\] part 4, 3.2.29' to '\[ECMA-376\] Part 4, 15.3.3'. | Minor | + +# Index + +A + +[AddinUdf](#addinudf) 588 + +[ADO recordset connections](#ado-recordset-connections) 164 + +[AF12CellIcon](#af12cellicon) 588 + +[AF12Criteria](#af12criteria) 589 + +[AF12DateInfo](#af12dateinfo) 589 + +[AFDOper](#afdoper) 590 + +[AFDOperBoolErr](#afdoperboolerr) 591 + +[AFDOperRk](#afdoperrk) 592 + +[AFDOperStr](#afdoperstr) 592 + +Algorithms + +[Application data for VtHyperlink](#application-data-for-vthyperlink) 924 + +[AlRuns](#alruns) 192 + +[Applicability](#applicability-statement) 55 + +[Application data for VtHyperlink](#application-data-for-vthyperlink) 924 + +[Area](#area) 192 + +[AreaFormat](#areaformat) 193 + +[Array](#array) 198 + +[ArrayParsedFormula](#arrayparsedformula) 725 + +[Attached label](#attached-label) 103 + +[AttachedLabel](#attachedlabel) 199 + +[AutoFilter](#autofilter) 200 + +[AutoFilter12](#autofilter12) 202 + +[AutoFilterInfo](#autofilterinfo) 205 + +[AutoFmt8](#autofmt8) 593 + +[AxcExt](#axcext) 205 + +[AxesUsed](#axesused) 208 + +Axis ([section 2.2.3.6](#axis) 89, [section 2.4.11](#axis-1) 208) + +[axis group](#axis-group) 87 + +[AxisLine](#axisline) 209 + +[AxisParent](#axisparent) 210 + +B + +[Backup](#backup) 210 + +[Bar](#bar) 210 + +[BCUsrs](#bcusrs) 211 + +[Begin](#begin) 211 + +[BErr](#berr) 725 + +[Bes](#bes) 594 + +[BigName](#bigname) 212 + +[BkHim](#bkhim) 212 + +[Blank](#blank) 213 + +[BOF](#bof) 213 + +[Bold](#bold) 595 + +[BookBool](#bookbool) 215 + +[BookExt](#bookext) 216 + +[BookExt_Conditional11](#bookext_conditional11) 595 + +[BookExt_Conditional12](#bookext_conditional12) 595 + +[Boolean](#boolean) 596 + +[BoolErr](#boolerr) 217 + +[BopPop](#boppop) 217 + +[BopPopCustom](#boppopcustom) 219 + +[BorderStyle](#borderstyle) 596 + +[BottomMargin](#bottommargin) 220 + +[BoundSheet8](#boundsheet8) 221 + +[BRAI](#brai) 222 + +[BuiltInFnGroupCount](#builtinfngroupcount) 223 + +[BuiltInStyle](#builtinstyle) 597 + +[Byte ordering](#stream-byte-ordering) 54 + +C + +[CachedDiskHeader](#cacheddiskheader) 597 + +[CalcCount](#calccount) 224 + +[CalcDelta](#calcdelta) 224 + +[CalcIter](#calciter) 224 + +[CalcMode](#calcmode) 224 + +[CalcPrecision](#calcprecision) 225 + +[CalcRefMode](#calcrefmode) 225 + +[CalcSaveRecalc](#calcsaverecalc) 225 + +[CatLab](#catlab) 226 + +[CatSerRange](#catserrange) 226 + +[CbUsr](#cbusr) 228 + +[Cch255](#cch255) 598 + +[Cell](#cell) 598 + +[Cell metadata](#cell-metadata) 105 + +[Cell table](#cell-table) 80 + +[retrieval of last-calculated cell values without loading cell table](#retrieval-of-last-calculated-cell-values-without-loading-cell-table) 81 + +[CellParsedFormula](#cellparsedformula) 726 + +[CellWatch](#cellwatch) 228 + +[CellXF](#cellxf) 598 + +[Cetab](#cetab) 726 + +[CF](#cf) 229 + +[CF12](#cf12) 230 + +[CFColor](#cfcolor) 602 + +[CFDatabar](#cfdatabar) 602 + +[CFEx](#cfex) 233 + +[CFExAveragesTemplateParams](#cfexaveragestemplateparams) 604 + +[CFExDateTemplateParams](#cfexdatetemplateparams) 604 + +[CFExDefaultTemplateParams](#cfexdefaulttemplateparams) 605 + +[CFExFilterParams](#cfexfilterparams) 605 + +[CFExNonCF12](#cfexnoncf12) 606 + +[CFExTemplateParams](#cfextemplateparams) 608 + +[CFExTextTemplateParams](#cfextexttemplateparams) 609 + +[CFFilter](#cffilter) 609 + +[CFFlag](#cfflag) 610 + +[CFGradient](#cfgradient) 611 + +[CFGradientInterpItem](#cfgradientinterpitem) 611 + +[CFGradientItem](#cfgradientitem) 612 + +[CFMStateItem](#cfmstateitem) 613 + +[CFMultistate](#cfmultistate) 613 + +[CFParsedFormula](#cfparsedformula) 755 + +[CFParsedFormulaNoCCE](#cfparsedformulanocce) 755 + +[CFrtId](#cfrtid) 614 + +[CFT](#cft) 615 + +[CFVO](#cfvo) 616 + +[CFVOParsedFormula](#cfvoparsedformula) 755 + +[Change cells revision](#change-cells-revision) 169 + +[Change tracking](#change-tracking) 1096 + +Chart ([section 2.1.6.1](#chart) 59, [section 2.2.3.3](#chart-1) 86, [section 2.4.45](#chart-2) 234) + +[Chart data cache](#chart-data-cache) 85 + +[Chart group](#chart-group) 91 + +[Chart sheet](#chart-sheet) 84 + +[Chart3d](#chart3d) 235 + +[Chart3DBarShape](#chart3dbarshape) 237 + +[ChartFormat](#chartformat) 237 + +[ChartFrtInfo](#chartfrtinfo) 238 + +[ChartNumNillable](#chartnumnillable) 617 + +[ChartParsedFormula](#chartparsedformula) 756 + +[Charts](#charts) 83 + +[attached label](#attached-label) 103 + +[axis](#axis) 89 + +[axis group](#axis-group) 87 + +[chart](#chart-1) 86 + +[chart data cache](#chart-data-cache) 85 + +[chart group](#chart-group) 91 + +[chart sheet](#chart-sheet) 84 + +[data label](#data-label) 95 + +[data point](#data-point) 95 + +[data table](#data-table) 102 + +[error bar](#error-bar) 101 + +[legend](#legend) 92 + +[pivot chart](#pivot-chart) 87 + +[series](#series) 94 + +[SPRC](#sprc) 104 + +[trendline](#trendline) 101 + +[ClrtClient](#clrtclient) 239 + +[CodeName](#codename) 240 + +[CodePage](#codepage) 240 + +[Col](#col) 617 + +[Col_NegativeOne](#col_negativeone) 617 + +[Col12](#col12) 618 + +[Col256U](#col256u) 618 + +[ColByte](#colbyte) 618 + +[ColByteU](#colbyteu) 619 + +[ColElfU](#colelfu) 619 + +[ColInfo](#colinfo) 241 + +[Collection of records](#collection-of-records) 58 + +[ColorICV](#coloricv) 619 + +[ColorTheme](#colortheme) 620 + +[ColRelNegU](#colrelnegu) 620 + +[ColRelU](#colrelu) 621 + +[ColSlco8U](#colslco8u) 621 + +[ColU](#colu) 621 + +[Column Chart Object example](#column-chart-object) 956 + +[Column chart object: AreaFormat example](#column-chart-object-areaformat) 959 + +[Column chart object: AxesUsed example](#column-chart-object-axesused) 969 + +[Column chart object: Axis example](#column-chart-object-axis) 970 + +[Column chart object: AxisParent example](#column-chart-object-axisparent) 970 + +[Column chart object: Bar example](#column-chart-object-bar) 973 + +[Column chart object: BRAI 1 example](#column-chart-object-brai-1) 960 + +[Column chart object: BRAI 2 example](#column-chart-object-brai-2) 962 + +[Column chart object: BRAI 3 example](#column-chart-object-brai-3) 964 + +[Column chart object: CatSerRange example](#column-chart-object-catserrange) 970 + +[Column chart object: Chart example](#column-chart-object-chart) 957 + +[Column chart object: ChartFormat example](#column-chart-object-chartformat) 972 + +[Column chart object: DataFormat example](#column-chart-object-dataformat) 966 + +[Column chart object: DefaultText example](#column-chart-object-defaulttext) 967 + +[Column chart object: FontX example](#column-chart-object-fontx) 969 + +[Column chart object: Frame example](#column-chart-object-frame) 957 + +[Column chart object: LineFormat example](#column-chart-object-lineformat) 958 + +[Column chart object: Series example](#column-chart-object-series) 960 + +[Column chart object: SeriesText example](#column-chart-object-seriestext) 962 + +[Column chart object: SerToCrt example](#column-chart-object-sertocrt) 966 + +[Column chart object: ShtProps example](#column-chart-object-shtprops) 966 + +[Column chart object: Text example](#column-chart-object-text) 967 + +[Column chart object: Tick example](#column-chart-object-tick) 971 + +[Colx](#colx) 622 + +[Compat12](#compat12) 242 + +[Component object stream](#component-object-stream-001compobj) 59 + +[Compound file](#compound-file) 57 + +[CompressPictures](#compresspictures) 242 + +[Conceptual overview](#conceptual-overview) 80 + +[cell table](#cell-table) 80 + +[charts](#charts) 83 + +[encryption (password to open)](#encryption-password-to-open) 165 + +[external connections](#external-connections) 163 + +[external references](#external-references) 161 + +[formulas](#formulas) 81 + +[metadata](#metadata) 104 + +[password verifier algorithm](#password-verifier-algorithm) 164 + +[PivotTables](#pivottables) 107 + +[shared feature](#shared-feature) 169 + +[shared workbooks](#shared-workbooks) 166 + +[styles](#styles) 158 + +[CondDataValue](#conddatavalue) 622 + +[CondFmt](#condfmt) 243 + +[CondFmt12](#condfmt12) 243 + +[CondFmtStructure](#condfmtstructure) 622 + +[Conditional Formatting example](#conditional-formatting-1) 925 + +[Conditional formatting: CF example](#conditional-formatting-cf) 927 + +[Conditional formatting: CondFmt example](#conditional-formatting-condfmt) 925 + +[Connection files](#external-connection-files) 163 + +[Connection name](#connection-name) 163 + +[ConnGrbitDbt](#conngrbitdbt) 623 + +[ConnGrbitDbtAdo](#conngrbitdbtado) 623 + +[ConnGrbitDbtOledb](#conngrbitdbtoledb) 624 + +[ConnGrbitDbtWeb](#conngrbitdbtweb) 625 + +[Continue](#continue) 244 + +[Continue_SxaddlSxString](#continue_sxaddlsxstring) 432 + +[ContinueBigName](#continuebigname) 244 + +[ContinueFrt](#continuefrt) 245 + +[ContinueFrt11](#continuefrt11) 245 + +[ContinueFrt12](#continuefrt12) 246 + +[Control stream](#control-stream-ctls) 60 + +[Control tokens](#control-tokens) 83 + +[ControlInfo](#controlinfo) 626 + +[Country](#country) 246 + +[CrErr](#crerr) 248 + +[CRN](#crn) 248 + +[CrtLayout12](#crtlayout12) 249 + +[CrtLayout12A](#crtlayout12a) 251 + +[CrtLayout12Mode](#crtlayout12mode) 626 + +[CrtLine](#crtline) 253 + +[CrtLink](#crtlink) 254 + +[CrtMlFrt](#crtmlfrt) 254 + +[CrtMlFrtContinue](#crtmlfrtcontinue) 255 + +[CTB](#ctb) 921 + +[CTBS](#ctbs) 920 + +[CTBWRAPPER](#ctbwrapper) 920 + +[CUsr](#cusr) 255 + +D + +[DAO recordset connections](#dao-recordset-connections) 164 + +[Dat](#dat) 255 + +[data functionality level](#data-functionality-level) 118 + +[Data label](#data-label) 95 + +[Data point](#data-point) 95 + +[Data spaces storage](#data-spaces-storage-006dataspaces) 60 + +[Data table](#data-table) 102 + +[DataFormat](#dataformat) 256 + +[DataFunctionalityLevel](#datafunctionalitylevel) 627 + +DataLabExt ([section 2.4.75](#datalabext) 256, [section 2.4.76](#datalabextcontents) 257) + +[DataSourceType](#datasourcetype) 627 + +[Date1904](#date1904) 258 + +[DateAsNum](#dateasnum) 627 + +[DateUnit](#dateunit) 627 + +[DBCell](#dbcell) 258 + +[DbOrParamQry](#dborparamqry) 259 + +[DbQuery](#dbquery) 259 + +[DbQueryExt](#dbqueryext) 261 + +[DCol](#dcol) 628 + +[DColByteU](#dcolbyteu) 628 + +[DCon](#dcon) 263 + +[DConBin](#dconbin) 265 + +[DConFile](#dconfile) 628 + +[DConn](#dconn) 266 + +[DConName](#dconname) 271 + +[DConnConnectionOleDb](#dconnconnectionoledb) 629 + +[DConnConnectionWeb](#dconnconnectionweb) 630 + +[DConnId](#dconnid) 630 + +[DConnParamBinding](#dconnparambinding) 631 + +[DConnParamBindingValByte](#dconnparambindingvalbyte) 631 + +[DConnParamBindingValInt](#dconnparambindingvalint) 631 + +[DConnParamBindingValString](#dconnparambindingvalstring) 631 + +[DConnParamBindingValType](#dconnparambindingvaltype) 632 + +[DConnParameter](#dconnparameter) 632 + +[DConnStringSequence](#dconnstringsequence) 633 + +[DConnUnicodeStringSegmented](#dconnunicodestringsegmented) 633 + +[DConRef](#dconref) 272 + +[DDE data item](#dde-data-item) 162 + +[DDE data source](#dde-data-source) 162 + +[DefaultRowHeight](#defaultrowheight) 273 + +[DefaultText](#defaulttext) 273 + +[DefColWidth](#defcolwidth) 274 + +[Defined Name example](#defined-name) 934 + +[Defined name: ExternSheet example](#defined-name-externsheet) 936 + +[Defined name: Lbl example](#defined-name-lbl) 934 + +[Defined name: SupBook example](#defined-name-supbook) 937 + +Details + +[AddinUdf structure](#addinudf) 588 + +[AF12CellIcon structure](#af12cellicon) 588 + +[AF12Criteria structure](#af12criteria) 589 + +[AF12DateInfo structure](#af12dateinfo) 589 + +[AFDOper structure](#afdoper) 590 + +[AFDOperBoolErr structure](#afdoperboolerr) 591 + +[AFDOperRk structure](#afdoperrk) 592 + +[AFDOperStr structure](#afdoperstr) 592 + +[AlRuns record](#alruns) 192 + +[Application data for VtHyperlink algorithm](#application-data-for-vthyperlink) 924 + +[Area record](#area) 192 + +[AreaFormat record](#areaformat) 193 + +[Array record](#array) 198 + +[ArrayParsedFormula structure](#arrayparsedformula) 725 + +[AttachedLabel record](#attachedlabel) 199 + +[AutoFilter record](#autofilter) 200 + +[AutoFilter12 record](#autofilter12) 202 + +[AutoFilterInfo record](#autofilterinfo) 205 + +[AutoFmt8 structure](#autofmt8) 593 + +[AxcExt record](#axcext) 205 + +[AxesUsed record](#axesused) 208 + +[Axis record](#axis-1) 208 + +[AxisLine record](#axisline) 209 + +[AxisParent record](#axisparent) 210 + +[Backup record](#backup) 210 + +[Bar record](#bar) 210 + +[BCUsrs record](#bcusrs) 211 + +[Begin record](#begin) 211 + +[BErr structure](#berr) 725 + +[Bes structure](#bes) 594 + +[BigName record](#bigname) 212 + +[BkHim record](#bkhim) 212 + +[Blank record](#blank) 213 + +[BOF record](#bof) 213 + +[Bold structure](#bold) 595 + +[BookBool record](#bookbool) 215 + +[BookExt record](#bookext) 216 + +[BookExt_Conditional11 structure](#bookext_conditional11) 595 + +[BookExt_Conditional12 structure](#bookext_conditional12) 595 + +[Boolean structure](#boolean) 596 + +[BoolErr record](#boolerr) 217 + +[BopPop record](#boppop) 217 + +[BopPopCustom record](#boppopcustom) 219 + +[BorderStyle structure](#borderstyle) 596 + +[BottomMargin record](#bottommargin) 220 + +[BoundSheet8 record](#boundsheet8) 221 + +[BRAI record](#brai) 222 + +[BuiltInFnGroupCount record](#builtinfngroupcount) 223 + +[BuiltInStyle structure](#builtinstyle) 597 + +[CachedDiskHeader structure](#cacheddiskheader) 597 + +[CalcCount record](#calccount) 224 + +[CalcDelta record](#calcdelta) 224 + +[CalcIter record](#calciter) 224 + +[CalcMode record](#calcmode) 224 + +[CalcPrecision record](#calcprecision) 225 + +[CalcRefMode record](#calcrefmode) 225 + +[CalcSaveRecalc record](#calcsaverecalc) 225 + +[CatLab record](#catlab) 226 + +[CatSerRange record](#catserrange) 226 + +[CbUsr record](#cbusr) 228 + +[Cch255 structure](#cch255) 598 + +[Cell structure](#cell) 598 + +[CellParsedFormula structure](#cellparsedformula) 726 + +[CellWatch record](#cellwatch) 228 + +[CellXF structure](#cellxf) 598 + +[Cetab structure](#cetab) 726 + +[CF record](#cf) 229 + +[CF12 record](#cf12) 230 + +[CFColor structure](#cfcolor) 602 + +[CFDatabar structure](#cfdatabar) 602 + +[CFEx record](#cfex) 233 + +[CFExAveragesTemplateParams structure](#cfexaveragestemplateparams) 604 + +[CFExDateTemplateParams structure](#cfexdatetemplateparams) 604 + +[CFExDefaultTemplateParams structure](#cfexdefaulttemplateparams) 605 + +[CFExFilterParams structure](#cfexfilterparams) 605 + +[CFExNonCF12 structure](#cfexnoncf12) 606 + +[CFExTemplateParams structure](#cfextemplateparams) 608 + +[CFExTextTemplateParams structure](#cfextexttemplateparams) 609 + +[CFFilter structure](#cffilter) 609 + +[CFFlag structure](#cfflag) 610 + +[CFGradient structure](#cfgradient) 611 + +[CFGradientInterpItem structure](#cfgradientinterpitem) 611 + +[CFGradientItem structure](#cfgradientitem) 612 + +[CFMStateItem structure](#cfmstateitem) 613 + +[CFMultistate structure](#cfmultistate) 613 + +[CFParsedFormula structure](#cfparsedformula) 755 + +[CFParsedFormulaNoCCE structure](#cfparsedformulanocce) 755 + +[CFrtId structure](#cfrtid) 614 + +[CFT structure](#cft) 615 + +[CFVO structure](#cfvo) 616 + +[CFVOParsedFormula structure](#cfvoparsedformula) 755 + +[Chart record](#chart-2) 234 + +[Chart3d record](#chart3d) 235 + +[Chart3DBarShape record](#chart3dbarshape) 237 + +[ChartFormat record](#chartformat) 237 + +[ChartFrtInfo record](#chartfrtinfo) 238 + +[ChartNumNillable structure](#chartnumnillable) 617 + +[ChartParsedFormula structure](#chartparsedformula) 756 + +[ClrtClient record](#clrtclient) 239 + +[CodeName record](#codename) 240 + +[CodePage record](#codepage) 240 + +[Col structure](#col) 617 + +[Col_NegativeOne structure](#col_negativeone) 617 + +[Col12 structure](#col12) 618 + +[Col256U structure](#col256u) 618 + +[ColByte structure](#colbyte) 618 + +[ColByteU structure](#colbyteu) 619 + +[ColElfU structure](#colelfu) 619 + +[ColInfo record](#colinfo) 241 + +[ColorICV structure](#coloricv) 619 + +[ColorTheme structure](#colortheme) 620 + +[ColRelNegU structure](#colrelnegu) 620 + +[ColRelU structure](#colrelu) 621 + +[ColSlco8U structure](#colslco8u) 621 + +[ColU structure](#colu) 621 + +[Colx structure](#colx) 622 + +[Compat12 record](#compat12) 242 + +[component object stream](#component-object-stream-001compobj) 59 + +[CompressPictures record](#compresspictures) 242 + +[CondDataValue structure](#conddatavalue) 622 + +[CondFmt record](#condfmt) 243 + +[CondFmt12 record](#condfmt12) 243 + +[CondFmtStructure structure](#condfmtstructure) 622 + +[ConnGrbitDbt structure](#conngrbitdbt) 623 + +[ConnGrbitDbtAdo structure](#conngrbitdbtado) 623 + +[ConnGrbitDbtOledb structure](#conngrbitdbtoledb) 624 + +[ConnGrbitDbtWeb structure](#conngrbitdbtweb) 625 + +[Continue record](#continue) 244 + +[Continue_SxaddlSxString record](#continue_sxaddlsxstring) 432 + +[ContinueBigName record](#continuebigname) 244 + +[ContinueFrt record](#continuefrt) 245 + +[ContinueFrt11 record](#continuefrt11) 245 + +[ContinueFrt12 record](#continuefrt12) 246 + +[control stream](#control-stream-ctls) 60 + +[ControlInfo structure](#controlinfo) 626 + +[Country record](#country) 246 + +[CrErr record](#crerr) 248 + +[CRN record](#crn) 248 + +[CrtLayout12 record](#crtlayout12) 249 + +[CrtLayout12A record](#crtlayout12a) 251 + +[CrtLayout12Mode structure](#crtlayout12mode) 626 + +[CrtLine record](#crtline) 253 + +[CrtLink record](#crtlink) 254 + +[CrtMlFrt record](#crtmlfrt) 254 + +[CrtMlFrtContinue record](#crtmlfrtcontinue) 255 + +[CTB XCB structure](#ctb) 921 + +[CTBS XCB structure](#ctbs) 920 + +[CTBWRAPPER XCB structure](#ctbwrapper) 920 + +[CUsr record](#cusr) 255 + +[Dat record](#dat) 255 + +[data spaces storage](#data-spaces-storage-006dataspaces) 60 + +[DataFormat record](#dataformat) 256 + +[DataFunctionalityLevel structure](#datafunctionalitylevel) 627 + +DataLabExt record ([section 2.4.75](#datalabext) 256, [section 2.4.76](#datalabextcontents) 257) + +[DataSourceType structure](#datasourcetype) 627 + +[Date1904 record](#date1904) 258 + +[DateAsNum structure](#dateasnum) 627 + +[DateUnit structure](#dateunit) 627 + +[DBCell record](#dbcell) 258 + +[DbOrParamQry record](#dborparamqry) 259 + +[DbQuery record](#dbquery) 259 + +[DbQueryExt record](#dbqueryext) 261 + +[DCol structure](#dcol) 628 + +[DColByteU structure](#dcolbyteu) 628 + +[DCon record](#dcon) 263 + +[DConBin record](#dconbin) 265 + +[DConFile structure](#dconfile) 628 + +[DConn record](#dconn) 266 + +[DConName record](#dconname) 271 + +[DConnConnectionOleDb structure](#dconnconnectionoledb) 629 + +[DConnConnectionWeb structure](#dconnconnectionweb) 630 + +[DConnId structure](#dconnid) 630 + +[DConnParamBinding structure](#dconnparambinding) 631 + +[DConnParamBindingValByte structure](#dconnparambindingvalbyte) 631 + +[DConnParamBindingValInt structure](#dconnparambindingvalint) 631 + +[DConnParamBindingValString structure](#dconnparambindingvalstring) 631 + +[DConnParamBindingValType structure](#dconnparambindingvaltype) 632 + +[DConnParameter structure](#dconnparameter) 632 + +[DConnStringSequence structure](#dconnstringsequence) 633 + +[DConnUnicodeStringSegmented structure](#dconnunicodestringsegmented) 633 + +[DConRef record](#dconref) 272 + +[DefaultRowHeight record](#defaultrowheight) 273 + +[DefaultText record](#defaulttext) 273 + +[DefColWidth record](#defcolwidth) 274 + +[Dimensions record](#dimensions) 274 + +[DJoin structure](#djoin) 634 + +[DocRoute record](#docroute) 275 + +[document summary information stream](#document-summary-information-stream-005documentsummaryinformation) 60 + +[DropBar record](#dropbar) 277 + +[DropDownObjIds record](#dropdownobjids) 278 + +[DRw structure](#drw) 634 + +[DRwByteU structure](#drwbyteu) 634 + +[DSF record](#dsf) 278 + +[Duce structure](#duce) 634 + +[DuceRadical structure](#duceradical) 635 + +[DuceStacked structure](#ducestacked) 636 + +[Ducr structure](#ducr) 636 + +[DucrConditionalLbl structure](#ducrconditionallbl) 637 + +[DucrConditionalNoLbl structure](#ducrconditionalnolbl) 638 + +[Dv record](#dv) 278 + +[DVal record](#dval) 281 + +[DVParsedFormula structure](#dvparsedformula) 756 + +[DwQsiFuture structure](#dwqsifuture) 638 + +[DXF record](#dxf) 282 + +[DXFALC structure](#dxfalc) 639 + +[DXFBdr structure](#dxfbdr) 640 + +[DXFFntD structure](#dxffntd) 641 + +[DXFId structure](#dxfid) 642 + +[DXFN structure](#dxfn) 642 + +[DXFN12 structure](#dxfn12) 645 + +[DXFN12List structure](#dxfn12list) 646 + +[DXFN12NoCB structure](#dxfn12nocb) 646 + +[DXFNum structure](#dxfnum) 646 + +[DXFNumIFmt structure](#dxfnumifmt) 647 + +[DXFNumUsr structure](#dxfnumusr) 647 + +[DXFPat structure](#dxfpat) 647 + +[DXFProt structure](#dxfprot) 648 + +[DxGCol record](#dxgcol) 283 + +[embedding storage](#embedding-storage-mbd...) 60 + +[encryption stream](#encryption-stream-encryption) 60 + +[End record](#end) 283 + +[EndBlock record](#endblock) 283 + +[EndObject record](#endobject) 285 + +[EnhancedProtection structure](#enhancedprotection) 648 + +[EntExU2 record](#entexu2) 286 + +[EOF record](#eof) 286 + +[Excel9File record](#excel9file) 286 + +[ExternDdeLinkNoOper structure](#externddelinknooper) 649 + +[ExternDocName structure](#externdocname) 649 + +[ExternName record](#externname) 286 + +[ExternOleDdeLink structure](#externoleddelink) 650 + +[ExternSheet record](#externsheet) 288 + +[ExtNameParsedFormula structure](#extnameparsedformula) 757 + +[ExtProp structure](#extprop) 650 + +[ExtPtgArea3D structure](#extptgarea3d) 758 + +[ExtPtgAreaErr3D structure](#extptgareaerr3d) 758 + +[ExtPtgErr structure](#extptgerr) 758 + +[ExtPtgRef3D structure](#extptgref3d) 759 + +[ExtPtgRefErr3D structure](#extptgreferr3d) 759 + +[ExtRst structure](#extrst) 651 + +[ExtSheetPair structure](#extsheetpair) 759 + +[ExtSST record](#extsst) 289 + +[ExtString record](#extstring) 289 + +[FactoidData structure](#factoiddata) 652 + +[Fbi record](#fbi) 290 + +[Fbi2 record](#fbi2) 291 + +[Feat record](#feat) 292 + +[Feat11CellStruct structure](#feat11cellstruct) 652 + +[Feat11FdaAutoFilter structure](#feat11fdaautofilter) 652 + +[Feat11FieldDataItem structure](#feat11fielddataitem) 653 + +[Feat11Fmla structure](#feat11fmla) 660 + +[Feat11RgInvalidCells structure](#feat11rginvalidcells) 660 + +[Feat11RgSharepointIdChange structure](#feat11rgsharepointidchange) 660 + +[Feat11RgSharepointIdDel structure](#feat11rgsharepointiddel) 661 + +[Feat11TotalFmla structure](#feat11totalfmla) 661 + +[Feat11WSSListInfo structure](#feat11wsslistinfo) 661 + +[Feat11XMap structure](#feat11xmap) 664 + +[Feat11XMapEntry structure](#feat11xmapentry) 664 + +[Feat11XMapEntry2 structure](#feat11xmapentry2) 665 + +[FeatFormulaErr2 structure](#featformulaerr2) 665 + +[FeatHdr record](#feathdr) 293 + +[FeatHdr11 record](#feathdr11) 294 + +[FeatProtection structure](#featprotection) 665 + +[FeatSmartTag structure](#featsmarttag) 666 + +[Feature11 record](#feature11) 294 + +[Feature12 record](#feature12) 296 + +[FFErrorCheck structure](#fferrorcheck) 667 + +[FileLock record](#filelock) 296 + +[FilePass record](#filepass) 297 + +[FileSharing record](#filesharing) 298 + +[FillPattern structure](#fillpattern) 667 + +[FillStylePropertiesForShapePropsStreamChecksum structure](#fillstylepropertiesforshapepropsstreamchecksum) 668 + +[FilterMode record](#filtermode) 298 + +[FnGroupName record](#fngroupname) 298 + +[FnGrp12 record](#fngrp12) 298 + +[Font record](#font) 299 + +[FontIndex structure](#fontindex) 678 + +[FontInfo structure](#fontinfo) 678 + +[FontScheme structure](#fontscheme) 679 + +[FontX record](#fontx) 301 + +[Footer record](#footer) 302 + +[ForceFullCalculation record](#forcefullcalculation) 302 + +[Format record](#format) 303 + +[FormatRun structure](#formatrun) 679 + +[Formula record](#formula) 310 + +[FormulaValue structure](#formulavalue) 679 + +[Frame record](#frame) 311 + +[FrtFlags structure](#frtflags) 680 + +[FrtFontList record](#frtfontlist) 312 + +[FrtHeader structure](#frtheader) 681 + +[FrtHeaderOld structure](#frtheaderold) 681 + +[FrtRefHeader structure](#frtrefheader) 681 + +[FrtRefHeaderNoGrbit structure](#frtrefheadernogrbit) 682 + +[FrtRefHeaderU structure](#frtrefheaderu) 682 + +[FrtWrapper record](#frtwrapper) 312 + +[Ftab structure](#ftab) 760 + +[FtCbls structure](#ftcbls) 683 + +[FtCblsData structure](#ftcblsdata) 683 + +[FtCf structure](#ftcf) 684 + +[FtCmo structure](#ftcmo) 684 + +[FtEdoData structure](#ftedodata) 687 + +[FtGboData structure](#ftgbodata) 688 + +[FtGmo structure](#ftgmo) 688 + +[FtLbsData structure](#ftlbsdata) 689 + +[FtMacro structure](#ftmacro) 691 + +[FtNts structure](#ftnts) 692 + +[FtPictFmla structure](#ftpictfmla) 692 + +[FtPioGrbit structure](#ftpiogrbit) 693 + +[FtRbo structure](#ftrbo) 695 + +[FtSbs structure](#ftsbs) 696 + +[FullColorExt structure](#fullcolorext) 697 + +[GelFrame record](#gelframe) 313 + +[GradStop structure](#gradstop) 697 + +[GridSet record](#gridset) 315 + +[GUIDTypeLib record](#guidtypelib) 315 + +[Guts record](#guts) 315 + +[HCenter record](#hcenter) 316 + +[Header record](#header) 316 + +[HeaderFooter record](#headerfooter) 320 + +[HFPicture record](#hfpicture) 321 + +[HiddenMemberSet structure](#hiddenmemberset) 698 + +[HideObj record](#hideobj) 323 + +[HideObjEnum structure](#hideobjenum) 698 + +[HLink record](#hlink) 323 + +[HLinkTooltip record](#hlinktooltip) 323 + +[HorizAlign structure](#horizalign) 699 + +[HorizontalPageBreaks record](#horizontalpagebreaks) 324 + +[HorzBrk structure](#horzbrk) 699 + +[Icv structure](#icv) 699 + +[IcvChart structure](#icvchart) 703 + +[IcvFont structure](#icvfont) 703 + +[IcvXF structure](#icvxf) 703 + +[IFmt structure](#ifmt) 703 + +[IFmtRecord record](#ifmtrecord) 324 + +[Ilel structure](#ilel) 787 + +[Index record](#index) 324 + +[InterfaceEnd record](#interfaceend) 325 + +[InterfaceHdr record](#interfacehdr) 325 + +[InteriorColorPropertiesForShapePropsStreamChecksum structure](#interiorcolorpropertiesforshapepropsstreamchecksum) 704 + +[Intl record](#intl) 325 + +[ISSTInf structure](#isstinf) 705 + +[IXFCell structure](#ixfcell) 705 + +[KPIProp structure](#kpiprop) 705 + +[KPISets structure](#kpisets) 706 + +[Label record](#label) 326 + +[LabelSst record](#labelsst) 326 + +[Lbl record](#lbl) 326 + +[LbsDropData structure](#lbsdropdata) 706 + +[LeftMargin record](#leftmargin) 329 + +[Legend record](#legend-1) 329 + +[LegendException record](#legendexception) 330 + +[Lel record](#lel) 331 + +[LEMMode structure](#lemmode) 707 + +[Line record](#line) 331 + +[LineFormat record](#lineformat) 332 + +[LinePropertiesForShapePropsStreamChecksum structure](#linepropertiesforshapepropsstreamchecksum) 708 + +[link storage](#link-storage-lnk...) 60 + +[list data stream](#list-data-stream-list-data) 61 + +[List12 record](#list12) 333 + +[List12BlockLevel structure](#list12blocklevel) 709 + +[List12DisplayName structure](#list12displayname) 711 + +[List12TableStyleClientInfo structure](#list12tablestyleclientinfo) 712 + +[ListParsedArrayFormula structure](#listparsedarrayformula) 788 + +[ListParsedFormula structure](#listparsedformula) 788 + +[LongRGB structure](#longrgb) 712 + +[LongRGBA structure](#longrgba) 713 + +[LPr record](#lpr) 334 + +[LPWideString structure](#lpwidestring) 713 + +[LRng record](#lrng) 335 + +[MarkerFormat record](#markerformat) 335 + +[MDB record](#mdb) 337 + +[MDir structure](#mdir) 713 + +[MDTInfo record](#mdtinfo) 337 + +[MDTInfoIndex structure](#mdtinfoindex) 714 + +[MDXKPI record](#mdxkpi) 339 + +[MDXProp record](#mdxprop) 340 + +[MDXSet record](#mdxset) 340 + +[MDXStr record](#mdxstr) 341 + +[MDXStrIndex structure](#mdxstrindex) 714 + +[MDXTuple record](#mdxtuple) 342 + +[MergeCells record](#mergecells) 342 + +[Mms record](#mms) 343 + +[MOper structure](#moper) 714 + +[MsoDrawing record](#msodrawing) 343 + +[MsoDrawingGroup record](#msodrawinggroup) 343 + +[MsoDrawingSelection record](#msodrawingselection) 344 + +[MTRSettings record](#mtrsettings) 344 + +[MulBlank record](#mulblank) 345 + +[MulRk record](#mulrk) 345 + +[NameCmt record](#namecmt) 346 + +[NameFnGrp12 record](#namefngrp12) 347 + +[NameParsedFormula structure](#nameparsedformula) 788 + +[NamePublish record](#namepublish) 348 + +[NilChartNum structure](#nilchartnum) 715 + +[Note record](#note) 348 + +[NoteRR structure](#noterr) 715 + +[NoteSh structure](#notesh) 716 + +[Number record](#number) 349 + +[Obj record](#obj) 349 + +[ObjectLink record](#objectlink) 352 + +[ObjectParsedFormula structure](#objectparsedformula) 789 + +ObjFmla structure ([section 2.5.187](#objfmla) 717, [section 2.5.188](#objid) 718) + +[ObjLinkFmla structure](#objlinkfmla) 718 + +[ObjProtect record](#objprotect) 352 + +[ObNoMacros record](#obnomacros) 353 + +[ObProj record](#obproj) 353 + +[ODBCType structure](#odbctype) 719 + +[Office data store storage](#office-data-store-storage-msodatastore) 65 + +[Office toolbars stream](#office-toolbars-stream-xcb) 65 + +[OfficeArtClientAnchorChart structure](#officeartclientanchorchart) 719 + +[OfficeArtClientAnchorHF structure](#officeartclientanchorhf) 720 + +[OfficeArtClientAnchorSheet structure](#officeartclientanchorsheet) 721 + +[OfficeArtClientData structure](#officeartclientdata) 722 + +[OfficeArtClientTextbox structure](#officeartclienttextbox) 723 + +[OLE stream](#ole-stream-001ole) 66 + +[OleDbConn record](#oledbconn) 353 + +[OleObjectSize record](#oleobjectsize) 354 + +[Palette record](#palette) 354 + +[Pane record](#pane) 354 + +[PaneType structure](#panetype) 723 + +[ParameterParsedFormula structure](#parameterparsedformula) 789 + +[ParamQry record](#paramqry) 355 + +[PARAMQRY_Fixed structure](#paramqry_fixed) 724 + +[Password record](#password) 355 + +[PBT structure](#pbt) 833 + +[PhoneticInfo record](#phoneticinfo) 356 + +[PhRuns structure](#phruns) 834 + +[Phs structure](#phs) 834 + +[PicF record](#picf) 356 + +[PictFmlaEmbedInfo structure](#pictfmlaembedinfo) 835 + +[PictFmlaKey structure](#pictfmlakey) 835 + +[Pie record](#pie) 357 + +[PieFormat record](#pieformat) 358 + +[pivot cache storage](#pivot-cache-storage-_sx_db_cur) 66 + +[PivotChartBits record](#pivotchartbits) 358 + +[PivotCompProp structure](#pivotcompprop) 836 + +[PivotParsedFormula structure](#pivotparsedformula) 790 + +[PlotArea record](#plotarea) 359 + +[PlotGrowth record](#plotgrowth) 359 + +[Pls record](#pls) 359 + +[PLV record](#plv) 360 + +[Pos record](#pos) 360 + +[PositionMode structure](#positionmode) 836 + +[PrintGrid record](#printgrid) 362 + +[PrintRowCol record](#printrowcol) 362 + +[PrintSize record](#printsize) 363 + +[Prot4Rev record](#prot4rev) 363 + +[Prot4RevPass record](#prot4revpass) 364 + +[Protect record](#protect) 364 + +[protected content stream](#protected-content-stream-009drmcontent) 66 + +[Ptg structure](#ptg) 790 + +[PtgAdd structure](#ptgadd) 793 + +[PtgArea structure](#ptgarea) 793 + +[PtgArea3d structure](#ptgarea3d) 794 + +[PtgAreaErr structure](#ptgareaerr) 794 + +PtgAreaErr3d structure ([section 2.5.198.30](#ptgareaerr3d) 795, [section 2.5.198.31](#ptgarean) 795) + +[PtgArray structure](#ptgarray) 796 + +[PtgAttrBaxcel structure](#ptgattrbaxcel) 796 + +[PtgAttrChoose structure](#ptgattrchoose) 797 + +[PtgAttrGoto structure](#ptgattrgoto) 797 + +[PtgAttrIf structure](#ptgattrif) 798 + +[PtgAttrSemi structure](#ptgattrsemi) 798 + +[PtgAttrSpace structure](#ptgattrspace) 798 + +[PtgAttrSpaceSemi structure](#ptgattrspacesemi) 799 + +[PtgAttrSpaceType structure](#ptgattrspacetype) 799 + +[PtgAttrSum structure](#ptgattrsum) 800 + +[PtgBool structure](#ptgbool) 800 + +[PtgConcat structure](#ptgconcat) 800 + +[PtgDataType structure](#ptgdatatype) 800 + +[PtgDiv structure](#ptgdiv) 801 + +[PtgElfCol structure](#ptgelfcol) 801 + +[PtgElfColS structure](#ptgelfcols) 801 + +[PtgElfColSV structure](#ptgelfcolsv) 802 + +[PtgElfColV structure](#ptgelfcolv) 802 + +[PtgElfLel structure](#ptgelflel) 802 + +[PtgElfRadical structure](#ptgelfradical) 803 + +[PtgElfRadicalLel structure](#ptgelfradicallel) 803 + +[PtgElfRadicalS structure](#ptgelfradicals) 804 + +[PtgElfRw structure](#ptgelfrw) 804 + +[PtgElfRwV structure](#ptgelfrwv) 805 + +[PtgEq structure](#ptgeq) 805 + +[PtgErr structure](#ptgerr) 805 + +[PtgExp structure](#ptgexp) 805 + +[PtgExtraArray structure](#ptgextraarray) 806 + +[PtgExtraElf structure](#ptgextraelf) 806 + +[PtgExtraMem structure](#ptgextramem) 807 + +[PtgFunc structure](#ptgfunc) 807 + +[PtgFuncVar structure](#ptgfuncvar) 807 + +[PtgGe structure](#ptgge) 808 + +[PtgGt structure](#ptggt) 808 + +[PtgInt structure](#ptgint) 808 + +[PtgIsect structure](#ptgisect) 809 + +[PtgLe structure](#ptgle) 809 + +[PtgLt structure](#ptglt) 809 + +[PtgMemArea structure](#ptgmemarea) 809 + +[PtgMemErr structure](#ptgmemerr) 810 + +[PtgMemFunc structure](#ptgmemfunc) 810 + +[PtgMemNoMem structure](#ptgmemnomem) 811 + +[PtgMissArg structure](#ptgmissarg) 811 + +[PtgMul structure](#ptgmul) 811 + +[PtgName structure](#ptgname) 812 + +[PtgNameX structure](#ptgnamex) 812 + +[PtgNe structure](#ptgne) 813 + +[PtgNum structure](#ptgnum) 813 + +[PtgParen structure](#ptgparen) 813 + +[PtgPercent structure](#ptgpercent) 814 + +[PtgPower structure](#ptgpower) 814 + +[PtgRange structure](#ptgrange) 814 + +[PtgRef structure](#ptgref) 814 + +[PtgRef3d structure](#ptgref3d) 815 + +[PtgRefErr structure](#ptgreferr) 815 + +[PtgRefErr3d structure](#ptgreferr3d) 816 + +[PtgRefN structure](#ptgrefn) 816 + +[PtgStr structure](#ptgstr) 816 + +[PtgSub structure](#ptgsub) 817 + +[PtgSxName structure](#ptgsxname) 817 + +[PtgTbl structure](#ptgtbl) 817 + +[PtgUminus structure](#ptguminus) 818 + +[PtgUnion structure](#ptgunion) 818 + +[PtgUplus structure](#ptguplus) 818 + +[Qsi record](#qsi) 364 + +[Qsif record](#qsif) 367 + +[Qsir record](#qsir) 368 + +[QsiSXTag record](#qsisxtag) 370 + +[Radar record](#radar) 372 + +[RadarArea record](#radararea) 372 + +[ReadingOrder structure](#readingorder) 836 + +[RealTimeData record](#realtimedata) 373 + +[RecalcId record](#recalcid) 374 + +[RecipName record](#recipname) 374 + +[Ref structure](#ref) 837 + +[Ref8 structure](#ref8) 837 + +[Ref8U structure](#ref8u) 838 + +[Ref8U2007 structure](#ref8u2007) 838 + +[RefreshAll record](#refreshall) 375 + +[RefU structure](#refu) 839 + +[RevExtern structure](#revextern) 819 + +[revision stream](#revision-stream-revision-log) 66 + +[RevisionType structure](#revisiontype) 839 + +[RevItab structure](#revitab) 819 + +[RevLblName structure](#revlblname) 820 + +[RevName structure](#revname) 821 + +[RevNamePly structure](#revnameply) 822 + +[RevNameTabid structure](#revnametabid) 822 + +[RevSheetName structure](#revsheetname) 822 + +[RFX structure](#rfx) 840 + +[RgbExtra structure](#rgbextra) 823 + +[Rgce structure](#rgce) 824 + +[RgceArea structure](#rgcearea) 827 + +[RgceAreaRel structure](#rgcearearel) 828 + +[RgceElfLoc structure](#rgceelfloc) 828 + +[RgceElfLocExtra structure](#rgceelflocextra) 829 + +[RgceLoc structure](#rgceloc) 829 + +[RgceLoc8 structure](#rgceloc8) 829 + +[RgceLocRel structure](#rgcelocrel) 829 + +[RichTextStream record](#richtextstream) 375 + +[RichTextStreamChecksumData structure](#richtextstreamchecksumdata) 840 + +[RichTextStreamChecksumFontInformation structure](#richtextstreamchecksumfontinformation) 842 + +[RichTextStreamChecksumFontInformationArrayItem structure](#richtextstreamchecksumfontinformationarrayitem) 844 + +[RightMargin record](#rightmargin) 377 + +[RK record](#rk) 377 + +[RkNumber structure](#rknumber) 844 + +[RkRec structure](#rkrec) 845 + +[Row record](#row) 378 + +[RPHSSub structure](#rphssub) 845 + +[RRAutoFmt record](#rrautofmt) 379 + +[RRD structure](#rrd) 846 + +[RRDChgCell record](#rrdchgcell) 380 + +[RRDConflict record](#rrdconflict) 384 + +[RRDDefName record](#rrddefname) 385 + +[RRDDefNameFlags structure](#rrddefnameflags) 846 + +[RRDHead record](#rrdhead) 387 + +[RRDInfo record](#rrdinfo) 389 + +[RRDInsDel record](#rrdinsdel) 390 + +[RRDInsDelBegin record](#rrdinsdelbegin) 391 + +[RRDInsDelEnd record](#rrdinsdelend) 391 + +[RRDMove record](#rrdmove) 391 + +[RRDMoveBegin record](#rrdmovebegin) 392 + +[RRDMoveEnd record](#rrdmoveend) 392 + +[RRDRenSheet record](#rrdrensheet) 392 + +[RRDRstEtxp record](#rrdrstetxp) 393 + +[RRDTQSIF record](#rrdtqsif) 394 + +[RRDUserView record](#rrduserview) 395 + +[RRFormat record](#rrformat) 396 + +[RRInsertSh record](#rrinsertsh) 396 + +[RRLoc structure](#rrloc) 848 + +[RRSort record](#rrsort) 397 + +[RRTabId record](#rrtabid) 398 + +[RTDEItem structure](#rtdeitem) 848 + +[RTDOper structure](#rtdoper) 848 + +[RTDOperStr structure](#rtdoperstr) 849 + +[Run structure](#run) 849 + +[Rw structure](#rw) 849 + +[Rw12 structure](#rw12) 850 + +[RwLongU structure](#rwlongu) 850 + +[RwU structure](#rwu) 850 + +[Rwx structure](#rwx) 850 + +[SBaseRef record](#sbaseref) 398 + +[Scatter record](#scatter) 399 + +[SCENARIO record](#scenario) 400 + +[ScenarioProtect record](#scenarioprotect) 401 + +[ScenMan record](#scenman) 401 + +[Scl record](#scl) 402 + +[Script structure](#script) 851 + +[SD_SetSortOrder structure](#sd_setsortorder) 851 + +[SDContainer structure](#sdcontainer) 851 + +[SecurityDescriptor structure](#securitydescriptor) 852 + +[Selection record](#selection) 402 + +[SerAr structure](#serar) 830 + +[SerAuxErrBar record](#serauxerrbar) 403 + +[SerAuxTrend record](#serauxtrend) 404 + +[SerBool structure](#serbool) 830 + +[SerErr structure](#sererr) 831 + +[SerFmt record](#serfmt) 405 + +[Series record](#series-1) 406 + +[SeriesList record](#serieslist) 407 + +[SeriesText record](#seriestext) 407 + +[SerNil structure](#sernil) 831 + +[SerNum structure](#sernum) 831 + +[SerParent record](#serparent) 407 + +[SerStr structure](#serstr) 832 + +[SerToCrt record](#sertocrt) 408 + +[Setup record](#setup) 408 + +[ShapePropsStream record](#shapepropsstream) 413 + +[ShapePropsStreamChecksumData structure](#shapepropsstreamchecksumdata) 852 + +[SharedFeatureType structure](#sharedfeaturetype) 853 + +[SharedParsedFormula structure](#sharedparsedformula) 832 + +[SheetExt record](#sheetext) 414 + +[SheetExtOptional structure](#sheetextoptional) 854 + +[ShortDTR structure](#shortdtr) 855 + +[ShortXLUnicodeString structure](#shortxlunicodestring) 855 + +[ShrFmla record](#shrfmla) 415 + +[ShtProps record](#shtprops) 415 + +[signatures stream](#signatures-stream-_signatures) 67 + +[SIIndex record](#siindex) 416 + +[SLCO8 structure](#slco8) 856 + +[Sort record](#sort) 417 + +[SortCond12 structure](#sortcond12) 856 + +[SortData record](#sortdata) 418 + +[SortItem structure](#sortitem) 857 + +[SourceType structure](#sourcetype) 858 + +[SQElfFlags structure](#sqelfflags) 858 + +[SqRef structure](#sqref) 858 + +[SqRefU structure](#sqrefu) 859 + +[SST record](#sst) 420 + +[StartBlock record](#startblock) 421 + +[StartObject record](#startobject) 426 + +[String record](#string) 427 + +[structure](#ftrbodata) 695 + +[Stxp structure](#stxp) 859 + +[Style record](#style) 427 + +[StyleExt record](#styleext) 428 + +[StyleXF structure](#stylexf) 860 + +[summary information stream](#summary-information-stream-005summaryinformation) 67 + +[SupBook record](#supbook) 429 + +[Surf record](#surf) 431 + +[SXAddl record](#sxaddl) 432 + +[SXAddl_SXCAutoSort_SXDEnd record](#sxaddl_sxcautosort_sxdend) 433 + +[SXAddl_SXCAutoSort_SXDId record](#sxaddl_sxcautosort_sxdid) 433 + +[SXAddl_SXCCache_SXDEnd record](#sxaddl_sxccache_sxdend) 434 + +[SXAddl_SXCCache_SXDId record](#sxaddl_sxccache_sxdid) 434 + +[SXAddl_SXCCache_SXDInfo12 record](#sxaddl_sxccache_sxdinfo12) 434 + +[SXAddl_SXCCache_SXDInvRefreshReal record](#sxaddl_sxccache_sxdinvrefreshreal) 435 + +[SXAddl_SXCCache_SXDVer10Info record](#sxaddl_sxccache_sxdver10info) 435 + +[SXAddl_SXCCache_SXDVerSXMacro record](#sxaddl_sxccache_sxdversxmacro) 436 + +[SXAddl_SXCCache_SXDVerUpdInv record](#sxaddl_sxccache_sxdverupdinv) 437 + +[SXAddl_SXCCacheField_SXDCaption record](#sxaddl_sxccachefield_sxdcaption) 437 + +[SXAddl_SXCCacheField_SXDEnd record](#sxaddl_sxccachefield_sxdend) 437 + +[SXAddl_SXCCacheField_SXDId record](#sxaddl_sxccachefield_sxdid) 438 + +[SXAddl_SXCCacheField_SXDIfdbMempropMap record](#sxaddl_sxccachefield_sxdifdbmempropmap) 438 + +[SXAddl_SXCCacheField_SXDIfdbMpMapCount record](#sxaddl_sxccachefield_sxdifdbmpmapcount) 439 + +[SXAddl_SXCCacheField_SXDProperty record](#sxaddl_sxccachefield_sxdproperty) 439 + +[SXAddl_SXCCacheField_SXDPropName record](#sxaddl_sxccachefield_sxdpropname) 440 + +[SXAddl_SXCCacheField_SXDSxrmitmCount record](#sxaddl_sxccachefield_sxdsxrmitmcount) 440 + +[SXAddl_SXCCacheItem_SXDEnd record](#sxaddl_sxccacheitem_sxdend) 441 + +[SXAddl_SXCCacheItem_SXDId record](#sxaddl_sxccacheitem_sxdid) 441 + +[SXAddl_SXCCacheItem_SXDItmMpMapCount record](#sxaddl_sxccacheitem_sxditmmpmapcount) 441 + +[SXAddl_SXCCacheItem_SXDItmMpropMap record](#sxaddl_sxccacheitem_sxditmmpropmap) 442 + +[SXAddl_SXCCacheItem_SXDSxrmitmDisp record](#sxaddl_sxccacheitem_sxdsxrmitmdisp) 442 + +[SXAddl_SXCField_SXDEnd record](#sxaddl_sxcfield_sxdend) 443 + +[SXAddl_SXCField_SXDId record](#sxaddl_sxcfield_sxdid) 443 + +[SXAddl_SXCField_SXDVer10Info record](#sxaddl_sxcfield_sxdver10info) 443 + +[SXAddl_SXCField12_SXDAutoshow record](#sxaddl_sxcfield12_sxdautoshow) 444 + +[SXAddl_SXCField12_SXDEnd record](#sxaddl_sxcfield12_sxdend) 444 + +[SXAddl_SXCField12_SXDId record](#sxaddl_sxcfield12_sxdid) 445 + +[SXAddl_SXCField12_SXDISXTH record](#sxaddl_sxcfield12_sxdisxth) 445 + +[SXAddl_SXCField12_SXDMemberCaption record](#sxaddl_sxcfield12_sxdmembercaption) 446 + +[SXAddl_SXCField12_SXDVer12Info record](#sxaddl_sxcfield12_sxdver12info) 446 + +[SXAddl_SXCField12_SXDVerUpdInv record](#sxaddl_sxcfield12_sxdverupdinv) 447 + +[SXAddl_SXCGroup_SXDEnd record](#sxaddl_sxcgroup_sxdend) 447 + +[SXAddl_SXCGroup_SXDGrpInfo record](#sxaddl_sxcgroup_sxdgrpinfo) 448 + +[SXAddl_SXCGroup_SXDId record](#sxaddl_sxcgroup_sxdid) 449 + +[SXAddl_SXCGroup_SXDMember record](#sxaddl_sxcgroup_sxdmember) 449 + +[SXAddl_SXCGrpLevel_SXDEnd record](#sxaddl_sxcgrplevel_sxdend) 450 + +[SXAddl_SXCGrpLevel_SXDGrpLevelInfo record](#sxaddl_sxcgrplevel_sxdgrplevelinfo) 450 + +[SXAddl_SXCGrpLevel_SXDId record](#sxaddl_sxcgrplevel_sxdid) 451 + +[SXAddl_SXCHierarchy_SXDDisplayFolder record](#sxaddl_sxchierarchy_sxddisplayfolder) 451 + +[SXAddl_SXCHierarchy_SXDEnd record](#sxaddl_sxchierarchy_sxdend) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember record](#sxaddl_sxchierarchy_sxdfiltermember) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember12 record](#sxaddl_sxchierarchy_sxdfiltermember12) 453 + +[SXAddl_SXCHierarchy_SXDIconSet record](#sxaddl_sxchierarchy_sxdiconset) 454 + +[SXAddl_SXCHierarchy_SXDId record](#sxaddl_sxchierarchy_sxdid) 454 + +[SXAddl_SXCHierarchy_SXDInfo12 record](#sxaddl_sxchierarchy_sxdinfo12) 455 + +[SXAddl_SXCHierarchy_SXDKPIGoal record](#sxaddl_sxchierarchy_sxdkpigoal) 456 + +[SXAddl_SXCHierarchy_SXDKPIStatus record](#sxaddl_sxchierarchy_sxdkpistatus) 456 + +[SXAddl_SXCHierarchy_SXDKPITime record](#sxaddl_sxchierarchy_sxdkpitime) 456 + +[SXAddl_SXCHierarchy_SXDKPITrend record](#sxaddl_sxchierarchy_sxdkpitrend) 457 + +[SXAddl_SXCHierarchy_SXDKPIValue record](#sxaddl_sxchierarchy_sxdkpivalue) 457 + +[SXAddl_SXCHierarchy_SXDKPIWeight record](#sxaddl_sxchierarchy_sxdkpiweight) 458 + +[SXAddl_SXCHierarchy_SXDMeasureGrp record](#sxaddl_sxchierarchy_sxdmeasuregrp) 458 + +[SXAddl_SXCHierarchy_SXDParentKPI record](#sxaddl_sxchierarchy_sxdparentkpi) 459 + +[SXAddl_SXCHierarchy_SXDProperty record](#sxaddl_sxchierarchy_sxdproperty) 459 + +[SXAddl_SXCHierarchy_SXDSXSetParentUnique record](#sxaddl_sxchierarchy_sxdsxsetparentunique) 461 + +[SXAddl_SXCHierarchy_SXDUserCaption record](#sxaddl_sxchierarchy_sxdusercaption) 461 + +[SXAddl_SXCHierarchy_SXDVerUpdInv record](#sxaddl_sxchierarchy_sxdverupdinv) 461 + +[SXAddl_SXCQsi_SXDEnd record](#sxaddl_sxcqsi_sxdend) 462 + +[SXAddl_SXCQsi_SXDId record](#sxaddl_sxcqsi_sxdid) 462 + +[SXAddl_SXCQuery_SXDEnd record](#sxaddl_sxcquery_sxdend) 462 + +[SXAddl_SXCQuery_SXDReconnCond record](#sxaddl_sxcquery_sxdreconncond) 463 + +[SXAddl_SXCQuery_SXDSrcConnFile record](#sxaddl_sxcquery_sxdsrcconnfile) 464 + +[SXAddl_SXCQuery_SXDSrcDataFile record](#sxaddl_sxcquery_sxdsrcdatafile) 464 + +[SXAddl_SXCQuery_SXDXMLSource record](#sxaddl_sxcquery_sxdxmlsource) 464 + +[SXAddl_SXCSXCondFmt_SXDEnd record](#sxaddl_sxcsxcondfmt_sxdend) 465 + +[SXAddl_SXCSXCondFmt_SXDSXCondFmt record](#sxaddl_sxcsxcondfmt_sxdsxcondfmt) 465 + +[SXAddl_SXCSXCondFmts_SXDEnd record](#sxaddl_sxcsxcondfmts_sxdend) 466 + +[SXAddl_SXCSXCondFmts_SXDId record](#sxaddl_sxcsxcondfmts_sxdid) 467 + +[SXAddl_SXCSXDH_SXDEnd record](#sxaddl_sxcsxdh_sxdend) 467 + +[SXAddl_SXCSXDH_SXDId record](#sxaddl_sxcsxdh_sxdid) 468 + +[SXAddl_SXCSXDH_SXDSxdh record](#sxaddl_sxcsxdh_sxdsxdh) 468 + +[SXAddl_SXCSXfilt_SXDEnd record](#sxaddl_sxcsxfilt_sxdend) 469 + +[SXAddl_SXCSXfilt_SXDId record](#sxaddl_sxcsxfilt_sxdid) 470 + +[SXAddl_SXCSXfilt_SXDSXfilt record](#sxaddl_sxcsxfilt_sxdsxfilt) 470 + +[SXAddl_SXCSXfilt_SXDSXItm record](#sxaddl_sxcsxfilt_sxdsxitm) 471 + +[SXAddl_SXCSXFilter12_SXDCaption record](#sxaddl_sxcsxfilter12_sxdcaption) 472 + +[SXAddl_SXCSXFilter12_SXDEnd record](#sxaddl_sxcsxfilter12_sxdend) 473 + +[SXAddl_SXCSXFilter12_SXDId record](#sxaddl_sxcsxfilter12_sxdid) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilter record](#sxaddl_sxcsxfilter12_sxdsxfilter) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilterDesc record](#sxaddl_sxcsxfilter12_sxdsxfilterdesc) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue1 record](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue2 record](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2) 475 + +[SXAddl_SXCSXFilter12_SXDXlsFilter record](#sxaddl_sxcsxfilter12_sxdxlsfilter) 476 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue1 record](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1) 476 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue2 record](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2) 477 + +[SXAddl_SXCSXFilters12_SXDEnd record](#sxaddl_sxcsxfilters12_sxdend) 477 + +[SXAddl_SXCSXFilters12_SXDId record](#sxaddl_sxcsxfilters12_sxdid) 478 + +[SXAddl_SXCSXMg_SXDEnd record](#sxaddl_sxcsxmg_sxdend) 478 + +[SXAddl_SXCSXMg_SXDId record](#sxaddl_sxcsxmg_sxdid) 478 + +[SXAddl_SXCSXMg_SXDUserCaption record](#sxaddl_sxcsxmg_sxdusercaption) 479 + +[SXAddl_SXCSXMgs_SXDEnd record](#sxaddl_sxcsxmgs_sxdend) 479 + +[SXAddl_SXCSXMgs_SXDId record](#sxaddl_sxcsxmgs_sxdid) 479 + +[SXAddl_SXCSXMgs_SXDMGrpSXDHMap record](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap) 480 + +[SXAddl_SXCSXrule_SXDEnd record](#sxaddl_sxcsxrule_sxdend) 481 + +[SXAddl_SXCSXrule_SXDId record](#sxaddl_sxcsxrule_sxdid) 481 + +[SXAddl_SXCSXrule_SXDSXrule record](#sxaddl_sxcsxrule_sxdsxrule) 481 + +[SXAddl_SXCView_SXDCalcMember record](#sxaddl_sxcview_sxdcalcmember) 484 + +[SXAddl_SXCView_SXDCalcMemString record](#sxaddl_sxcview_sxdcalcmemstring) 486 + +[SXAddl_SXCView_SXDCompactColHdr record](#sxaddl_sxcview_sxdcompactcolhdr) 486 + +[SXAddl_SXCView_SXDCompactRwHdr record](#sxaddl_sxcview_sxdcompactrwhdr) 487 + +[SXAddl_SXCView_SXDEnd record](#sxaddl_sxcview_sxdend) 487 + +[SXAddl_SXCView_SXDId record](#sxaddl_sxcview_sxdid) 488 + +[SXAddl_SXCView_SXDSXPIIvmb record](#sxaddl_sxcview_sxdsxpiivmb) 488 + +[SXAddl_SXCView_SXDTableStyleClient record](#sxaddl_sxcview_sxdtablestyleclient) 489 + +[SXAddl_SXCView_SXDVer10Info record](#sxaddl_sxcview_sxdver10info) 489 + +[SXAddl_SXCView_SXDVer12Info record](#sxaddl_sxcview_sxdver12info) 491 + +[SXAddl_SXCView_SXDVerUpdInv record](#sxaddl_sxcview_sxdverupdinv) 493 + +[SxAddl_SXDEnd structure](#sxaddl_sxdend) 862 + +[SxAddl_SXDVerUpdInv structure](#sxaddl_sxdverupdinv) 862 + +[SxAddl_SXString structure](#sxaddl_sxstring) 862 + +[SXAddlHdr structure](#sxaddlhdr) 863 + +[SXAxis structure](#sxaxis) 863 + +[SxBool record](#sxbool) 494 + +[SXDB record](#sxdb) 494 + +[SXDBB record](#sxdbb) 495 + +[SXDBEx record](#sxdbex) 495 + +[SXDI record](#sxdi) 496 + +[SXDtr record](#sxdtr) 498 + +[SxDXF record](#sxdxf) 498 + +[SxErr record](#sxerr) 499 + +[SXEx record](#sxex) 499 + +[SXEZDoper structure](#sxezdoper) 863 + +[SXFDB record](#sxfdb) 502 + +[SXFDBType record](#sxfdbtype) 505 + +[SxFilt record](#sxfilt) 505 + +[SxFmla record](#sxfmla) 506 + +[SxFormat record](#sxformat) 507 + +[SxFormula record](#sxformula) 507 + +[SxFT structure](#sxft) 864 + +[SxInt record](#sxint) 507 + +[SxIsxoper record](#sxisxoper) 508 + +[SxItm record](#sxitm) 508 + +[SxIvd record](#sxivd) 509 + +[SxIvdCol structure](#sxivdcol) 868 + +[SxIvdRw structure](#sxivdrw) 868 + +[SXLI record](#sxli) 510 + +[SXLIItem structure](#sxliitem) 868 + +[SxName record](#sxname) 510 + +[SxNil record](#sxnil) 511 + +[SXNum record](#sxnum) 511 + +[SXPair record](#sxpair) 511 + +[SXPI record](#sxpi) 512 + +[SXPI_Item structure](#sxpi_item) 871 + +[SXPIEx record](#sxpiex) 513 + +[SXRng record](#sxrng) 513 + +[SxRule record](#sxrule) 515 + +[SxSelect record](#sxselect) 517 + +[SXStreamID record](#sxstreamid) 519 + +[SXString record](#sxstring) 519 + +[SXTbl record](#sxtbl) 519 + +[SxTbpg record](#sxtbpg) 520 + +[SXTBRGIITM record](#sxtbrgiitm) 521 + +[SXTH record](#sxth) 521 + +[Sxvd record](#sxvd) 524 + +[SXVDEx record](#sxvdex) 528 + +[SXVDEx_Opt structure](#sxvdex_opt) 871 + +[SXVDTEx record](#sxvdtex) 531 + +[SXVI record](#sxvi) 532 + +[SxView record](#sxview) 534 + +[SxView9Save structure](#sxview9save) 872 + +[SxViewEx record](#sxviewex) 536 + +[SxViewEx9 record](#sxviewex9) 537 + +[SxViewLink record](#sxviewlink) 538 + +[SXVIFlags structure](#sxviflags) 872 + +[SXVS record](#sxvs) 539 + +[Sync record](#sync) 539 + +[TabId structure](#tabid) 873 + +[TabIndex structure](#tabindex) 873 + +[Table record](#table) 539 + +[TableFeatureType structure](#tablefeaturetype) 873 + +[TableStyle record](#tablestyle) 541 + +[TableStyleElement record](#tablestyleelement) 542 + +[TableStyles record](#tablestyles) 545 + +[Tag_Fn_MDX structure](#tag_fn_mdx) 877 + +[TBC XCB structure](#tbc) 922 + +[TBCCmd XCB structure](#tbccmd) 923 + +[Template record](#template) 546 + +[Text record](#text) 546 + +[TextPropsStream record](#textpropsstream) 551 + +[TextPropsStreamChecksumData structure](#textpropsstreamchecksumdata) 878 + +[Theme record](#theme) 553 + +[Tick record](#tick) 553 + +[Top10FT structure](#top10ft) 880 + +[TopMargin record](#topmargin) 556 + +[Ts structure](#ts) 880 + +[TxO record](#txo) 557 + +[TxOLastRun structure](#txolastrun) 880 + +[TxORuns structure](#txoruns) 881 + +[TxtQry record](#txtqry) 559 + +[TxtWf structure](#txtwf) 881 + +[Uncalced record](#uncalced) 561 + +[Underline structure](#underline) 882 + +[Units record](#units) 561 + +[user names stream](#user-names-stream-user-names) 68 + +[UserBView record](#userbview) 561 + +[UserSViewBegin record](#usersviewbegin) 565 + +[UserSViewBegin_Chart record](#usersviewbegin_chart) 568 + +[UserSViewEnd record](#usersviewend) 570 + +[UsesELFs record](#useselfs) 570 + +[UsrChk record](#usrchk) 570 + +[UsrExcl record](#usrexcl) 571 + +[UsrInfo record](#usrinfo) 572 + +[ValueRange record](#valuerange) 572 + +[VBA storage](#vba-storage-_vba_project_cur) 68 + +[VCenter record](#vcenter) 575 + +[VertAlign structure](#vertalign) 882 + +[VertBrk structure](#vertbrk) 882 + +[VerticalPageBreaks record](#verticalpagebreaks) 575 + +[viewer content stream](#viewer-content-stream-009drmviewercontent) 68 + +[VirtualPath structure](#virtualpath) 882 + +[WebPub record](#webpub) 575 + +[WebPubString structure](#webpubstring) 884 + +[Window1 record](#window1) 578 + +[Window2 record](#window2) 579 + +[WinProtect record](#winprotect) 581 + +[WOpt record](#wopt) 582 + +[workbook stream](#workbook-stream-workbook) 68 + +[WriteAccess record](#writeaccess) 583 + +[WriteProtect record](#writeprotect) 584 + +[WsBool record](#wsbool) 584 + +[XColorType structure](#xcolortype) 885 + +[XCT record](#xct) 585 + +[XF record](#xf) 585 + +[XFCRC record](#xfcrc) 586 + +[XFExt record](#xfext) 586 + +[XFExtGradient structure](#xfextgradient) 885 + +[XFExtNoFRT structure](#xfextnofrt) 886 + +[XFIndex structure](#xfindex) 886 + +[XFProp structure](#xfprop) 888 + +[XFPropBorder structure](#xfpropborder) 890 + +[XFPropColor structure](#xfpropcolor) 890 + +[XFPropGradient structure](#xfpropgradient) 891 + +[XFPropGradientStop structure](#xfpropgradientstop) 892 + +[XFProps structure](#xfprops) 892 + +[XFPropTextRotation structure](#xfproptextrotation) 893 + +[XLNameUnicodeString structure](#xlnameunicodestring) 893 + +[XlsFilter_Criteria structure](#xlsfilter_criteria) 894 + +[XlsFilter_Top10 structure](#xlsfilter_top10) 895 + +[XLUnicodeRichExtendedString structure](#xlunicoderichextendedstring) 896 + +[XLUnicodeString structure](#xlunicodestring) 897 + +[XLUnicodeStringMin2 structure](#xlunicodestringmin2) 898 + +[XLUnicodeStringNoCch structure](#xlunicodestringnocch) 898 + +[XLUnicodeStringSegmented structure](#xlunicodestringsegmented) 898 + +[XLUnicodeStringSegmentedRTD structure](#xlunicodestringsegmentedrtd) 899 + +[XLUnicodeStringSegmentedSXAddl structure](#xlunicodestringsegmentedsxaddl) 899 + +[XML signatures storage](#xml-signatures-storage-_xmlsignatures) 76 + +[XML stream](#xml-stream-xml) 76 + +[XmlTkBackWallThicknessFrt structure](#xmltkbackwallthicknessfrt) 900 + +[XmlTkBaseTimeUnitFrt structure](#xmltkbasetimeunitfrt) 900 + +[XmlTkBlob structure](#xmltkblob) 901 + +[XmlTkBool structure](#xmltkbool) 901 + +[XmlTkChain structure](#xmltkchain) 902 + +[XmlTkColorMappingOverride structure](#xmltkcolormappingoverride) 904 + +[XmlTkDispBlanksAsFrt structure](#xmltkdispblanksasfrt) 904 + +[XmlTkDouble structure](#xmltkdouble) 905 + +[XmlTkDWord structure](#xmltkdword) 905 + +[XmlTkEnd structure](#xmltkend) 906 + +[XmlTkEndSurface structure](#xmltkendsurface) 906 + +[XmlTkFloorThicknessFrt structure](#xmltkfloorthicknessfrt) 906 + +[XmlTkFormatCodeFrt structure](#xmltkformatcodefrt) 907 + +[XmlTkHeader structure](#xmltkheader) 907 + +[XmlTkHeightPercent structure](#xmltkheightpercent) 907 + +[XmlTkLogBaseFrt structure](#xmltklogbasefrt) 908 + +[XmlTkMajorUnitFrt structure](#xmltkmajorunitfrt) 908 + +[XmlTkMajorUnitTypeFrt structure](#xmltkmajorunittypefrt) 908 + +[XmlTkMaxFrt structure](#xmltkmaxfrt) 909 + +[XmlTkMinFrt structure](#xmltkminfrt) 909 + +[XmlTkMinorUnitFrt structure](#xmltkminorunitfrt) 910 + +[XmlTkMinorUnitTypeFrt structure](#xmltkminorunittypefrt) 910 + +[XmlTkNoMultiLvlLbl structure](#xmltknomultilvllbl) 911 + +[XmlTkOverlay structure](#xmltkoverlay) 911 + +[XmlTkPerspectiveFrt structure](#xmltkperspectivefrt) 912 + +[XmlTkPieComboFrom12Frt structure](#xmltkpiecombofrom12frt) 912 + +[XmlTkRAngAxOffFrt structure](#xmltkrangaxofffrt) 912 + +[XmlTkRotXFrt structure](#xmltkrotxfrt) 913 + +[XmlTkRotYFrt structure](#xmltkrotyfrt) 913 + +[XmlTkShowDLblsOverMax structure](#xmltkshowdlblsovermax) 913 + +[XmlTkSpb structure](#xmltkspb) 914 + +[XmlTkStart structure](#xmltkstart) 914 + +[XmlTkStartSurface structure](#xmltkstartsurface) 914 + +[XmlTkString structure](#xmltkstring) 915 + +[XmlTkStyle structure](#xmltkstyle) 915 + +[XmlTkSymbolFrt structure](#xmltksymbolfrt) 915 + +[XmlTkThemeOverride structure](#xmltkthemeoverride) 916 + +[XmlTkTickLabelPositionFrt structure](#xmltkticklabelpositionfrt) 916 + +[XmlTkTickLabelSkipFrt structure](#xmltkticklabelskipfrt) 917 + +[XmlTkTickMarkSkipFrt structure](#xmltktickmarkskipfrt) 917 + +[XmlTkToken structure](#xmltktoken) 917 + +[XmlTkTpb structure](#xmltktpb) 918 + +[Xnum structure](#xnum) 918 + +[XORObfuscation structure](#xorobfuscation) 918 + +[XTI structure](#xti) 918 + +[XtiIndexstructure](#xtiindex) 833 + +[YMult record](#ymult) 587 + +[Differential formatting (DXFs)](#differential-formatting-dxfs) 159 + +[Dimensions](#dimensions) 274 + +[Display tokens](#display-tokens) 83 + +[DJoin](#djoin) 634 + +[DocRoute](#docroute) 275 + +[Document summary information stream](#document-summary-information-stream-005documentsummaryinformation) 60 + +[DropBar](#dropbar) 277 + +[DropDownObjIds](#dropdownobjids) 278 + +[DRw](#drw) 634 + +[DRwByteU](#drwbyteu) 634 + +[DSF](#dsf) 278 + +[Duce](#duce) 634 + +[DuceRadical](#duceradical) 635 + +[DuceStacked](#ducestacked) 636 + +[Ducr](#ducr) 636 + +[DucrConditionalLbl](#ducrconditionallbl) 637 + +[DucrConditionalNoLbl](#ducrconditionalnolbl) 638 + +[Dv](#dv) 278 + +[DVal](#dval) 281 + +[DVParsedFormula](#dvparsedformula) 756 + +[DwQsiFuture](#dwqsifuture) 638 + +[DXF](#dxf) 282 + +[DXFALC](#dxfalc) 639 + +[DXFBdr](#dxfbdr) 640 + +[DXFFntD](#dxffntd) 641 + +[DXFId](#dxfid) 642 + +[DXFN](#dxfn) 642 + +[DXFN12](#dxfn12) 645 + +[DXFN12List](#dxfn12list) 646 + +[DXFN12NoCB](#dxfn12nocb) 646 + +[DXFNum](#dxfnum) 646 + +[DXFNumIFmt](#dxfnumifmt) 647 + +[DXFNumUsr](#dxfnumusr) 647 + +[DXFPat](#dxfpat) 647 + +[DXFProt](#dxfprot) 648 + +[DXFs (differential formatting)](#differential-formatting-dxfs) 159 + +[DxGCol](#dxgcol) 283 + +E + +[Embedding storage](#embedding-storage-mbd...) 60 + +[Encryption (password to open)](#encryption-password-to-open) 165 + +[Encryption stream](#encryption-stream-encryption) 60 + +[End](#end) 283 + +[EndBlock](#endblock) 283 + +[EndObject](#endobject) 285 + +[EnhancedProtection](#enhancedprotection) 648 + +[EntExU2](#entexu2) 286 + +[EOF](#eof) 286 + +[Error bar](#error-bar) 101 + +[Examples](#structure-examples) 925 + +[Column Chart Object](#column-chart-object) 956 + +[column chart object: AreaFormat](#column-chart-object-areaformat) 959 + +[column chart object: AxesUsed](#column-chart-object-axesused) 969 + +[column chart object: Axis](#column-chart-object-axis) 970 + +[column chart object: AxisParent](#column-chart-object-axisparent) 970 + +[column chart object: Bar](#column-chart-object-bar) 973 + +[column chart object: BRAI 1](#column-chart-object-brai-1) 960 + +[column chart object: BRAI 2](#column-chart-object-brai-2) 962 + +[column chart object: BRAI 3](#column-chart-object-brai-3) 964 + +[column chart object: CatSerRange](#column-chart-object-catserrange) 970 + +[column chart object: Chart](#column-chart-object-chart) 957 + +[column chart object: ChartFormat](#column-chart-object-chartformat) 972 + +[column chart object: DataFormat](#column-chart-object-dataformat) 966 + +[column chart object: DefaultText](#column-chart-object-defaulttext) 967 + +[column chart object: FontX](#column-chart-object-fontx) 969 + +[column chart object: Frame](#column-chart-object-frame) 957 + +[column chart object: LineFormat](#column-chart-object-lineformat) 958 + +[column chart object: Series](#column-chart-object-series) 960 + +[column chart object: SeriesText](#column-chart-object-seriestext) 962 + +[column chart object: SerToCrt](#column-chart-object-sertocrt) 966 + +[column chart object: ShtProps](#column-chart-object-shtprops) 966 + +[column chart object: Text](#column-chart-object-text) 967 + +[column chart object: Tick](#column-chart-object-tick) 971 + +[Conditional Formatting](#conditional-formatting-1) 925 + +[conditional formatting: CF](#conditional-formatting-cf) 927 + +[conditional formatting: CondFmt](#conditional-formatting-condfmt) 925 + +[Defined Name](#defined-name) 934 + +[defined name: ExternSheet](#defined-name-externsheet) 936 + +[defined name: Lbl](#defined-name-lbl) 934 + +[defined name: SupBook](#defined-name-supbook) 937 + +[External References](#external-references-1) 949 + +[external references: CRN](#external-references-crn) 954 + +[external references: ExternSheet](#external-references-externsheet) 955 + +[external references: Formula](#external-references-formula) 950 + +[external references: String](#external-references-string) 952 + +[external references: SupBook 1](#external-references-supbook-1) 953 + +[external references: SupBook 2](#external-references-supbook-2) 955 + +[external references: XCT](#external-references-xct) 953 + +[Filters](#filters) 947 + +[filters: AutoFilter](#filters-autofilter) 948 + +[filters: AutoFilterInfo](#filters-autofilterinfo) 948 + +[filters: FilterMode](#filters-filtermode) 947 + +[Formatting](#formatting) 982 + +[formatting: Font 1](#formatting-font-1) 983 + +[formatting: Font 2](#formatting-font-2) 984 + +[formatting: Format](#formatting-format) 985 + +[formatting: Number 1](#formatting-number-1) 994 + +[formatting: Number 2](#formatting-number-2) 995 + +[formatting: Number 3](#formatting-number-3) 996 + +[formatting: XF 1](#formatting-xf-1) 986 + +[formatting: XF 2](#formatting-xf-2) 988 + +[formatting: XF 3](#formatting-xf-3) 990 + +[formatting: XF 4](#formatting-xf-4) 992 + +[Pie Chart Sheet](#pie-chart-sheet) 974 + +[pie chart sheet: AxesUsed](#pie-chart-sheet-axesused) 975 + +[pie chart sheet: AxisParent](#pie-chart-sheet-axisparent) 976 + +[pie chart sheet: BRAI](#pie-chart-sheet-brai) 981 + +[pie chart sheet: Chart](#pie-chart-sheet-chart) 974 + +[pie chart sheet: ChartFormat](#pie-chart-sheet-chartformat) 976 + +[pie chart sheet: Legend](#pie-chart-sheet-legend) 977 + +[pie chart sheet: Pie](#pie-chart-sheet-pie) 976 + +[pie chart sheet: Pos](#pie-chart-sheet-pos) 978 + +[pie chart sheet: PrintSize](#pie-chart-sheet-printsize) 974 + +[pie chart sheet: ShtProps](#pie-chart-sheet-shtprops) 975 + +[pie chart sheet: Text](#pie-chart-sheet-text) 979 + +[pie chart sheet: Window2](#pie-chart-sheet-window2) 981 + +[PivotTable](#pivottable-1) 1031 + +[PivotTable: DConRef](#pivottable-dconref) 1033 + +[PivotTable: EOF](#pivottable-eof) 1084 + +[PivotTable: QsiSXTag](#pivottable-qsisxtag) 1066 + +[PivotTable: SXAddl 1](#pivottable-sxaddl-1) 1034 + +[PivotTable: SXAddl 2](#pivottable-sxaddl-2) 1035 + +[PivotTable: SXAddl 3](#pivottable-sxaddl-3) 1036 + +[PivotTable: SxAddl 4](#pivottable-sxaddl-4) 1068 + +[PivotTable: SxAddl 5](#pivottable-sxaddl-5) 1069 + +[PivotTable: SxAddl 6](#pivottable-sxaddl-6) 1071 + +[PivotTable: SXDB](#pivottable-sxdb) 1071 + +[PivotTable: SXDBB 1](#pivottable-sxdbb-1) 1082 + +[PivotTable: SXDBB 2](#pivottable-sxdbb-2) 1083 + +[PivotTable: SXDBEx](#pivottable-sxdbex) 1073 + +[PivotTable: SXDI](#pivottable-sxdi) 1057 + +[PivotTable: SXDtr 1](#pivottable-sxdtr-1) 1077 + +[PivotTable: SXDtr 2](#pivottable-sxdtr-2) 1077 + +[PivotTable: SXEx](#pivottable-sxex) 1064 + +[PivotTable: SXFDB 1](#pivottable-sxfdb-1) 1073 + +[PivotTable: SXFDB 2](#pivottable-sxfdb-2) 1076 + +[PivotTable: SXFDB 3](#pivottable-sxfdb-3) 1078 + +[PivotTable: SXFDB 4](#pivottable-sxfdb-4) 1079 + +[PivotTable: SXFDB 5](#pivottable-sxfdb-5) 1081 + +[PivotTable: SxIvd](#pivottable-sxivd) 1056 + +[PivotTable: SXLI 1](#pivottable-sxli-1) 1057 + +[PivotTable: SXLI 2](#pivottable-sxli-2) 1063 + +[PivotTable: SXNum 1](#pivottable-sxnum-1) 1080 + +[PivotTable: SXNum 2](#pivottable-sxnum-2) 1082 + +[PivotTable: SXNum 3](#pivottable-sxnum-3) 1083 + +[PivotTable: SXPI](#pivottable-sxpi) 1056 + +[PivotTable: SXStreamID](#pivottable-sxstreamid) 1032 + +[PivotTable: SXString 1](#pivottable-sxstring-1) 1075 + +[PivotTable: SXString 2](#pivottable-sxstring-2) 1075 + +[PivotTable: SXString 3](#pivottable-sxstring-3) 1075 + +[PivotTable: Sxvd 1](#pivottable-sxvd-1) 1040 + +[PivotTable: Sxvd 2](#pivottable-sxvd-2) 1045 + +[PivotTable: Sxvd 3](#pivottable-sxvd-3) 1049 + +[PivotTable: Sxvd 4](#pivottable-sxvd-4) 1050 + +[PivotTable: Sxvd 5](#pivottable-sxvd-5) 1053 + +[PivotTable: SXVDEx 1](#pivottable-sxvdex-1) 1044 + +[PivotTable: SXVDEx 2](#pivottable-sxvdex-2) 1048 + +[PivotTable: SXVDEx 3](#pivottable-sxvdex-3) 1052 + +[PivotTable: SXVDEx 4](#pivottable-sxvdex-4) 1054 + +[PivotTable: SXVI 1](#pivottable-sxvi-1) 1041 + +[PivotTable: SXVI 2](#pivottable-sxvi-2) 1042 + +[PivotTable: SXVI 3](#pivottable-sxvi-3) 1042 + +[PivotTable: SXVI 4](#pivottable-sxvi-4) 1043 + +[PivotTable: SXVI 5](#pivottable-sxvi-5) 1047 + +[PivotTable: SXVI 6](#pivottable-sxvi-6) 1047 + +[PivotTable: SXVI 7](#pivottable-sxvi-7) 1048 + +[PivotTable: SxView](#pivottable-sxview) 1036 + +[PivotTable: SXViewEx9](#pivottable-sxviewex9) 1068 + +[PivotTable: SXVS](#pivottable-sxvs) 1032 + +[Table](#table-1) 937 + +[table: Feathdr11](#table-feathdr11) 937 + +[table: Feature11](#table-feature11) 938 + +[Workbook](#workbook) 996 + +[workbook: BOF 1](#workbook-bof-1) 997 + +[workbook: BookBool](#workbook-bookbool) 1001 + +[workbook: BookExt](#workbook-bookext) 1010 + +[workbook: BoundSheet8 1](#workbook-boundsheet8-1) 1007 + +[workbook: BoundSheet8 2](#workbook-boundsheet8-2) 1007 + +[workbook: BoundSheet8 3](#workbook-boundsheet8-3) 1008 + +[workbook: BuiltInFnGroupCount](#workbook-builtinfngroupcount) 999 + +[workbook: CalcPrecision](#workbook-calcprecision) 1001 + +[workbook: Country](#workbook-country) 1008 + +[workbook: Date1904](#workbook-date1904) 1001 + +[workbook: DBCell](#workbook-dbcell) 1027 + +[workbook: DefaultRowHeight](#workbook-defaultrowheight) 1014 + +[workbook: DefColWidth](#workbook-defcolwidth) 1017 + +[workbook: Dimensions](#workbook-dimensions) 1017 + +[workbook: EOF 1](#workbook-eof-1) 1012 + +workbook: EOF 2 ([section 3.9.22](#workbook-bof-2) 1012, [section 3.9.41](#workbook-eof-2) 1031) + +[workbook: ExtSST](#workbook-extsst) 1009 + +[workbook: Font](#workbook-font) 1002 + +[workbook: Format](#workbook-format) 1003 + +[workbook: Formula](#workbook-formula) 1024 + +[workbook: HideObj](#workbook-hideobj) 1001 + +[workbook: Index](#workbook-index) 1013 + +[workbook: LabelSst 1](#workbook-labelsst-1) 1021 + +[workbook: LabelSst 2](#workbook-labelsst-2) 1023 + +[workbook: PhoneticInfo](#workbook-phoneticinfo) 1030 + +[workbook: RecalcId](#workbook-recalcid) 1009 + +[workbook: RK](#workbook-rk) 1022 + +[workbook: Row 1](#workbook-row-1) 1018 + +[workbook: Row 2](#workbook-row-2) 1019 + +[workbook: Row 3](#workbook-row-3) 1020 + +[workbook: Row 4](#workbook-row-4) 1020 + +[workbook: RRTabId](#workbook-rrtabid) 998 + +[workbook: Selection](#workbook-selection) 1029 + +[workbook: Setup](#workbook-setup) 1015 + +[workbook: SST](#workbook-sst) 1009 + +[workbook: Style](#workbook-style) 1006 + +[workbook: Window1](#workbook-window1) 999 + +[workbook: Window2](#workbook-window2) 1027 + +[workbook: WsBool](#workbook-wsbool) 1014 + +[workbook: XF](#workbook-xf) 1004 + +[Excel9File](#excel9file) 286 + +[External cell cache](#external-cell-cache) 162 + +[External connections](#external-connections) 163 + +[ADO recordset connections](#ado-recordset-connections) 164 + +[connection files](#external-connection-files) 163 + +[connection name](#connection-name) 163 + +[DAO recordset connections](#dao-recordset-connections) 164 + +[ODBC connections](#odbc-connections) 164 + +[OLE DB connections](#ole-db-connections) 163 + +[text import connections](#text-import-connections) 164 + +[web connections](#web-connections) 164 + +[External defined name](#external-defined-name) 162 + +[External reference consumers](#external-reference-consumers) 161 + +[External references](#external-references) 161 + +[DDE data item](#dde-data-item) 162 + +[DDE data source](#dde-data-source) 162 + +[external cell cache](#external-cell-cache) 162 + +[external defined name](#external-defined-name) 162 + +[external reference consumers](#external-reference-consumers) 161 + +[external workbook](#external-workbook) 162 + +[OLE data item](#ole-data-item) 162 + +[OLE data source](#ole-data-source) 162 + +[supporting link](#supporting-link) 161 + +[External References example](#external-references-1) 949 + +[External references: CRN example](#external-references-crn) 954 + +[External references: ExternSheet example](#external-references-externsheet) 955 + +[External references: Formula example](#external-references-formula) 950 + +[External references: String example](#external-references-string) 952 + +[External references: SupBook 1 example](#external-references-supbook-1) 953 + +[External references: SupBook 2 example](#external-references-supbook-2) 955 + +[External references: XCT example](#external-references-xct) 953 + +[External workbook](#external-workbook) 162 + +[ExternDdeLinkNoOper](#externddelinknooper) 649 + +[ExternDocName](#externdocname) 649 + +[ExternName](#externname) 286 + +[ExternOleDdeLink](#externoleddelink) 650 + +[ExternSheet](#externsheet) 288 + +[ExtNameParsedFormula](#extnameparsedformula) 757 + +[ExtProp](#extprop) 650 + +[ExtPtgArea3D](#extptgarea3d) 758 + +[ExtPtgAreaErr3D](#extptgareaerr3d) 758 + +[ExtPtgErr](#extptgerr) 758 + +[ExtPtgRef3D](#extptgref3d) 759 + +[ExtPtgRefErr3D](#extptgreferr3d) 759 + +[ExtRst](#extrst) 651 + +[ExtSheetPair](#extsheetpair) 759 + +[ExtSST](#extsst) 289 + +[ExtString](#extstring) 289 + +F + +[FactoidData](#factoiddata) 652 + +[Fbi](#fbi) 290 + +[Fbi2](#fbi2) 291 + +[Feat](#feat) 292 + +[Feat11CellStruct](#feat11cellstruct) 652 + +[Feat11FdaAutoFilter](#feat11fdaautofilter) 652 + +[Feat11FieldDataItem](#feat11fielddataitem) 653 + +[Feat11Fmla](#feat11fmla) 660 + +[Feat11RgInvalidCells](#feat11rginvalidcells) 660 + +[Feat11RgSharepointIdChange](#feat11rgsharepointidchange) 660 + +[Feat11RgSharepointIdDel](#feat11rgsharepointiddel) 661 + +[Feat11TotalFmla](#feat11totalfmla) 661 + +[Feat11WSSListInfo](#feat11wsslistinfo) 661 + +[Feat11XMap](#feat11xmap) 664 + +[Feat11XMapEntry](#feat11xmapentry) 664 + +[Feat11XMapEntry2](#feat11xmapentry2) 665 + +[FeatFormulaErr2](#featformulaerr2) 665 + +[FeatHdr](#feathdr) 293 + +[FeatHdr11](#feathdr11) 294 + +[FeatProtection](#featprotection) 665 + +[FeatSmartTag](#featsmarttag) 666 + +[Feature11](#feature11) 294 + +[Feature12](#feature12) 296 + +[FFErrorCheck](#fferrorcheck) 667 + +[Fields - vendor-extensible](#vendor-extensible-fields) 56 + +File storage + +[data spaces](#data-spaces-storage-006dataspaces) 60 + +[embedding](#embedding-storage-mbd...) 60 + +[link](#link-storage-lnk...) 60 + +[Office data store](#office-data-store-storage-msodatastore) 65 + +[pivot cache](#pivot-cache-storage-_sx_db_cur) 66 + +[VBA](#vba-storage-_vba_project_cur) 68 + +[XML signatures](#xml-signatures-storage-_xmlsignatures) 76 + +File streams + +[component object](#component-object-stream-001compobj) 59 + +[control](#control-stream-ctls) 60 + +[document summary information](#document-summary-information-stream-005documentsummaryinformation) 60 + +[encryption](#encryption-stream-encryption) 60 + +[list data](#list-data-stream-list-data) 61 + +[Office toolbars](#office-toolbars-stream-xcb) 65 + +[OLE](#ole-stream-001ole) 66 + +[protected content](#protected-content-stream-009drmcontent) 66 + +[revision](#revision-stream-revision-log) 66 + +[signatures](#signatures-stream-_signatures) 67 + +[summary information](#summary-information-stream-005summaryinformation) 67 + +[user names](#user-names-stream-user-names) 68 + +[viewer content](#viewer-content-stream-009drmviewercontent) 68 + +[workbook](#workbook-stream-workbook) 68 + +[XML](#xml-stream-xml) 76 + +[File structure](#file-structure) 57 + +[collection of records](#collection-of-records) 58 + +[compound file](#compound-file) 57 + +[future record](#future-record) 58 + +[record](#record) 57 + +[storages](#storages-and-streams) 59 + +[stream](#stream) 57 + +[streams](#storages-and-streams) 59 + +[substream](#substream) 57 + +[FileLock](#filelock) 296 + +[FilePass](#filepass) 297 + +[FileSharing](#filesharing) 298 + +[FillPattern](#fillpattern) 667 + +[FillStylePropertiesForShapePropsStreamChecksum](#fillstylepropertiesforshapepropsstreamchecksum) 668 + +[FilterMode](#filtermode) 298 + +[Filters example](#filters) 947 + +[Filters: AutoFilter example](#filters-autofilter) 948 + +[Filters: AutoFilterInfo example](#filters-autofilterinfo) 948 + +[Filters: FilterMode example](#filters-filtermode) 947 + +[FnGroupName](#fngroupname) 298 + +[FnGrp12](#fngrp12) 298 + +[Font](#font) 299 + +[FontIndex](#fontindex) 678 + +[FontInfo](#fontinfo) 678 + +[FontScheme](#fontscheme) 679 + +[FontX](#fontx) 301 + +[Footer](#footer) 302 + +[ForceFullCalculation](#forcefullcalculation) 302 + +[Format](#format) 303 + +[Format conflicts](#format-conflicts) 160 + +[FormatRun](#formatrun) 679 + +[Formatting example](#formatting) 982 + +[Formatting: Font 1 example](#formatting-font-1) 983 + +[Formatting: Font 2 example](#formatting-font-2) 984 + +[Formatting: Format example](#formatting-format) 985 + +[Formatting: Number 1 example](#formatting-number-1) 994 + +[Formatting: Number 2 example](#formatting-number-2) 995 + +[Formatting: Number 3 example](#formatting-number-3) 996 + +[Formatting: XF 1 example](#formatting-xf-1) 986 + +[Formatting: XF 2 example](#formatting-xf-2) 988 + +[Formatting: XF 3 example](#formatting-xf-3) 990 + +[Formatting: XF 4 example](#formatting-xf-4) 992 + +[Formula](#formula) 310 + +[Formula elements](#formula-elements) 83 + +[Formulas](#formulas) 81 + +[control tokens](#control-tokens) 83 + +[display tokens](#display-tokens) 83 + +[Formula elements](#formula-elements) 83 + +[Mem tokens](#mem-tokens) 83 + +[operand tokens](#operand-tokens) 82 + +[operator tokens](#operator-tokens) 82 + +[FormulaValue](#formulavalue) 679 + +[Frame](#frame) 311 + +[FrtFlags](#frtflags) 680 + +[FrtFontList](#frtfontlist) 312 + +[FrtHeader](#frtheader) 681 + +[FrtHeaderOld](#frtheaderold) 681 + +[FrtRefHeader](#frtrefheader) 681 + +[FrtRefHeaderNoGrbit](#frtrefheadernogrbit) 682 + +[FrtRefHeaderU](#frtrefheaderu) 682 + +[FrtWrapper](#frtwrapper) 312 + +[Ftab](#ftab) 760 + +[FtCbls](#ftcbls) 683 + +[FtCblsData](#ftcblsdata) 683 + +[FtCf](#ftcf) 684 + +[FtCmo](#ftcmo) 684 + +[FtEdoData](#ftedodata) 687 + +[FtGboData](#ftgbodata) 688 + +[FtGmo](#ftgmo) 688 + +[FtLbsData](#ftlbsdata) 689 + +[FtMacro](#ftmacro) 691 + +[FtNts](#ftnts) 692 + +[FtPictFmla](#ftpictfmla) 692 + +[FtPioGrbit](#ftpiogrbit) 693 + +[FtRbo](#ftrbo) 695 + +[FtSbs](#ftsbs) 696 + +[FullColorExt](#fullcolorext) 697 + +[Future record](#future-record) 58 + +[chart](#chart) 59 + +[PivotTable](#pivottable) 59 + +G + +[GelFrame](#gelframe) 313 + +[Glossary](#glossary) 29 + +[GradStop](#gradstop) 697 + +[GridSet](#gridset) 315 + +[GUIDTypeLib](#guidtypelib) 315 + +[Guts](#guts) 315 + +H + +[HCenter](#hcenter) 316 + +[Header](#header) 316 + +[HeaderFooter](#headerfooter) 320 + +[HFPicture](#hfpicture) 321 + +[HiddenMemberSet](#hiddenmemberset) 698 + +[HideObj](#hideobj) 323 + +[HideObjEnum](#hideobjenum) 698 + +[HLink](#hlink) 323 + +[HLinkTooltip](#hlinktooltip) 323 + +[HorizAlign](#horizalign) 699 + +[HorizontalPageBreaks](#horizontalpagebreaks) 324 + +[HorzBrk](#horzbrk) 699 + +I + +[Icv](#icv) 699 + +[IcvChart](#icvchart) 703 + +[IcvFont](#icvfont) 703 + +[IcvXF](#icvxf) 703 + +[IFmt](#ifmt) 703 + +[IFmtRecord](#ifmtrecord) 324 + +[Ilel](#ilel) 787 + +[Implementer - security considerations](#security-considerations) 1085 + +[Implementer – security considerations](#security-considerations) 1085 + +[Index](#index) 324 + +[Informative references](#informative-references) 53 + +[Insertion/deletion of rows/columns revision](#insertion-deletion-of-rows-columns-revision) 168 + +[InterfaceEnd](#interfaceend) 325 + +[InterfaceHdr](#interfacehdr) 325 + +[InteriorColorPropertiesForShapePropsStreamChecksum](#interiorcolorpropertiesforshapepropsstreamchecksum) 704 + +[Intl](#intl) 325 + +[Introduction](#introduction) 29 + +[ISSTInf](#isstinf) 705 + +[IXFCell](#ixfcell) 705 + +K + +[KPIProp](#kpiprop) 705 + +[KPISets](#kpisets) 706 + +L + +[Label](#label) 326 + +[LabelSst](#labelsst) 326 + +[Lbl](#lbl) 326 + +[LbsDropData](#lbsdropdata) 706 + +[LeftMargin](#leftmargin) 329 + +Legend ([section 2.2.3.8](#legend) 92, [section 2.4.152](#legend-1) 329) + +[LegendException](#legendexception) 330 + +[Lel](#lel) 331 + +[LEMMode](#lemmode) 707 + +[Line](#line) 331 + +[LineFormat](#lineformat) 332 + +[LinePropertiesForShapePropsStreamChecksum](#linepropertiesforshapepropsstreamchecksum) 708 + +[Link storage](#link-storage-lnk...) 60 + +[List data stream](#list-data-stream-list-data) 61 + +[List12](#list12) 333 + +[List12BlockLevel](#list12blocklevel) 709 + +[List12DisplayName](#list12displayname) 711 + +[List12TableStyleClientInfo](#list12tablestyleclientinfo) 712 + +[ListParsedArrayFormula](#listparsedarrayformula) 788 + +[ListParsedFormula](#listparsedformula) 788 + +[Localization](#versioning-and-localization) 55 + +[LongRGB](#longrgb) 712 + +[LongRGBA](#longrgba) 713 + +[LPr](#lpr) 334 + +[LPWideString](#lpwidestring) 713 + +[LRng](#lrng) 335 + +M + +[MarkerFormat](#markerformat) 335 + +[MDB](#mdb) 337 + +[MDir](#mdir) 713 + +[MDTInfo](#mdtinfo) 337 + +[MDTInfoIndex](#mdtinfoindex) 714 + +[MDX metadata](#mdx-metadata) 106 + +[MDXKPI](#mdxkpi) 339 + +[MDXProp](#mdxprop) 340 + +[MDXSet](#mdxset) 340 + +[MDXStr](#mdxstr) 341 + +[MDXStrIndex](#mdxstrindex) 714 + +[MDXTuple](#mdxtuple) 342 + +[Mem tokens](#mem-tokens) 83 + +[MergeCells](#mergecells) 342 + +[Metadata](#metadata) 104 + +[cell metadata](#cell-metadata) 105 + +[MDX metadata](#mdx-metadata) 106 + +[Metadata block](#metadata-block) 106 + +[metadata types](#metadata-types) 105 + +[value metadata](#value-metadata) 105 + +[Metadata block](#metadata-block) 106 + +[Metadata types](#metadata-types) 105 + +[Mms](#mms) 343 + +[MOper](#moper) 714 + +[Move cells revision](#move-cells-revision) 169 + +[MsoDrawing](#msodrawing) 343 + +[MsoDrawingGroup](#msodrawinggroup) 343 + +[MsoDrawingSelection](#msodrawingselection) 344 + +[MTRSettings](#mtrsettings) 344 + +[MulBlank](#mulblank) 345 + +[MulRk](#mulrk) 345 + +N + +[NameCmt](#namecmt) 346 + +[NameFnGrp12](#namefngrp12) 347 + +[NameParsedFormula](#nameparsedformula) 788 + +[NamePublish](#namepublish) 348 + +[NilChartNum](#nilchartnum) 715 + +[Normative references](#normative-references) 52 + +[Note](#note) 348 + +[NoteRR](#noterr) 715 + +[NoteSh](#notesh) 716 + +[Number](#number) 349 + +O + +[Obj](#obj) 349 + +[ObjectLink](#objectlink) 352 + +[ObjectParsedFormula](#objectparsedformula) 789 + +ObjFmla ([section 2.5.187](#objfmla) 717, [section 2.5.188](#objid) 718) + +[ObjLinkFmla](#objlinkfmla) 718 + +[ObjProtect](#objprotect) 352 + +[ObNoMacros](#obnomacros) 353 + +[ObProj](#obproj) 353 + +[ODBC connections](#odbc-connections) 164 + +[ODBCType](#odbctype) 719 + +[Office data store storage](#office-data-store-storage-msodatastore) 65 + +[Office toolbars stream](#office-toolbars-stream-xcb) 65 + +[OfficeArtClientAnchorChart](#officeartclientanchorchart) 719 + +[OfficeArtClientAnchorHF](#officeartclientanchorhf) 720 + +[OfficeArtClientAnchorSheet](#officeartclientanchorsheet) 721 + +[OfficeArtClientData](#officeartclientdata) 722 + +[OfficeArtClientTextbox](#officeartclienttextbox) 723 + +[OLE data item](#ole-data-item) 162 + +[OLE data source](#ole-data-source) 162 + +[OLE DB connections](#ole-db-connections) 163 + +[OLE stream](#ole-stream-001ole) 66 + +[OleDbConn](#oledbconn) 353 + +[OleObjectSize](#oleobjectsize) 354 + +[Operand tokens](#operand-tokens) 82 + +[Operator tokens](#operator-tokens) 82 + +[Organization of this documentation](#organization-of-this-documentation) 54 + +Overview + +[byte ordering](#stream-byte-ordering) 54 + +[organization of this documentation](#organization-of-this-documentation) 54 + +[Overview (synopsis)](#overview) 53 + +P + +[Palette](#palette) 354 + +[Pane](#pane) 354 + +[PaneType](#panetype) 723 + +[ParameterParsedFormula](#parameterparsedformula) 789 + +[ParamQry](#paramqry) 355 + +[PARAMQRY_Fixed](#paramqry_fixed) 724 + +Parsed expressions + +[ArrayParsedFormula](#arrayparsedformula) 725 + +[BErr](#berr) 725 + +[CellParsedFormula](#cellparsedformula) 726 + +[Cetab](#cetab) 726 + +[CFParsedFormula](#cfparsedformula) 755 + +[CFParsedFormulaNoCCE](#cfparsedformulanocce) 755 + +[CFVOParsedFormula](#cfvoparsedformula) 755 + +[ChartParsedFormula](#chartparsedformula) 756 + +[DVParsedFormula](#dvparsedformula) 756 + +[ExtNameParsedFormula](#extnameparsedformula) 757 + +[ExtPtgArea3D](#extptgarea3d) 758 + +[ExtPtgAreaErr3D](#extptgareaerr3d) 758 + +[ExtPtgErr](#extptgerr) 758 + +[ExtPtgRef3D](#extptgref3d) 759 + +[ExtPtgRefErr3D](#extptgreferr3d) 759 + +[ExtSheetPair structure](#extsheetpair) 759 + +[Ftab](#ftab) 760 + +[Ilel](#ilel) 787 + +[ListParsedArrayFormula](#listparsedarrayformula) 788 + +[ListParsedFormula](#listparsedformula) 788 + +[NameParsedFormula](#nameparsedformula) 788 + +[ObjectParsedFormula](#objectparsedformula) 789 + +[ParameterParsedFormula](#parameterparsedformula) 789 + +[PivotParsedFormula](#pivotparsedformula) 790 + +[Ptg](#ptg) 790 + +[PtgAdd](#ptgadd) 793 + +[PtgArea](#ptgarea) 793 + +[PtgArea3d](#ptgarea3d) 794 + +[PtgAreaErr](#ptgareaerr) 794 + +PtgAreaErr3d ([section 2.5.198.30](#ptgareaerr3d) 795, [section 2.5.198.31](#ptgarean) 795) + +[PtgArray](#ptgarray) 796 + +[PtgAttrBaxcel](#ptgattrbaxcel) 796 + +[PtgAttrChoose](#ptgattrchoose) 797 + +[PtgAttrGoto](#ptgattrgoto) 797 + +[PtgAttrIf structure](#ptgattrif) 798 + +[PtgAttrSemi](#ptgattrsemi) 798 + +[PtgAttrSpace](#ptgattrspace) 798 + +[PtgAttrSpaceSemi](#ptgattrspacesemi) 799 + +[PtgAttrSpaceType](#ptgattrspacetype) 799 + +[PtgAttrSum](#ptgattrsum) 800 + +[PtgBool](#ptgbool) 800 + +[PtgConcat](#ptgconcat) 800 + +[PtgDataType](#ptgdatatype) 800 + +[PtgDiv](#ptgdiv) 801 + +[PtgElfCol](#ptgelfcol) 801 + +[PtgElfColS](#ptgelfcols) 801 + +[PtgElfColSV](#ptgelfcolsv) 802 + +[PtgElfColV](#ptgelfcolv) 802 + +[PtgElfLel](#ptgelflel) 802 + +[PtgElfRadical](#ptgelfradical) 803 + +[PtgElfRadicalLel](#ptgelfradicallel) 803 + +[PtgElfRadicalS](#ptgelfradicals) 804 + +[PtgElfRw](#ptgelfrw) 804 + +[PtgElfRwV](#ptgelfrwv) 805 + +[PtgEq](#ptgeq) 805 + +[PtgErr](#ptgerr) 805 + +[PtgExp](#ptgexp) 805 + +[PtgExtraArray](#ptgextraarray) 806 + +[PtgExtraElf](#ptgextraelf) 806 + +[PtgExtraMem](#ptgextramem) 807 + +[PtgFunc](#ptgfunc) 807 + +[PtgFuncVar](#ptgfuncvar) 807 + +[PtgGe](#ptgge) 808 + +[PtgGt](#ptggt) 808 + +[PtgInt](#ptgint) 808 + +[PtgIsect](#ptgisect) 809 + +[PtgLe](#ptgle) 809 + +[PtgLt](#ptglt) 809 + +[PtgMemArea](#ptgmemarea) 809 + +[PtgMemErr](#ptgmemerr) 810 + +[PtgMemFunc](#ptgmemfunc) 810 + +[PtgMemNoMem](#ptgmemnomem) 811 + +[PtgMissArg](#ptgmissarg) 811 + +[PtgMul](#ptgmul) 811 + +[PtgName](#ptgname) 812 + +[PtgNameX](#ptgnamex) 812 + +[PtgNe](#ptgne) 813 + +[PtgNum](#ptgnum) 813 + +[PtgParen](#ptgparen) 813 + +[PtgPercent](#ptgpercent) 814 + +[PtgPower](#ptgpower) 814 + +[PtgRange](#ptgrange) 814 + +[PtgRef](#ptgref) 814 + +[PtgRef3d](#ptgref3d) 815 + +[PtgRefErr](#ptgreferr) 815 + +[PtgRefErr3d](#ptgreferr3d) 816 + +[PtgRefN](#ptgrefn) 816 + +[PtgStr](#ptgstr) 816 + +[PtgSub](#ptgsub) 817 + +[PtgSxName](#ptgsxname) 817 + +[PtgTbl](#ptgtbl) 817 + +[PtgUminus](#ptguminus) 818 + +[PtgUnion](#ptgunion) 818 + +[PtgUplus](#ptguplus) 818 + +[RevExtern](#revextern) 819 + +[RevItab](#revitab) 819 + +[RevLblName](#revlblname) 820 + +[RevName](#revname) 821 + +[RevNamePly](#revnameply) 822 + +[RevNameTabid](#revnametabid) 822 + +[RevSheetName](#revsheetname) 822 + +[RgbExtra](#rgbextra) 823 + +[Rgce](#rgce) 824 + +[RgceArea](#rgcearea) 827 + +[RgceAreaRel](#rgcearearel) 828 + +[RgceElfLoc](#rgceelfloc) 828 + +[RgceElfLocExtra](#rgceelflocextra) 829 + +[RgceLoc](#rgceloc) 829 + +[RgceLoc8](#rgceloc8) 829 + +[RgceLocRel](#rgcelocrel) 829 + +[SerAr](#serar) 830 + +[SerBool](#serbool) 830 + +[SerErr](#sererr) 831 + +[SerNil](#sernil) 831 + +[SerNum](#sernum) 831 + +[SerStr](#serstr) 832 + +[SharedParsedFormula](#sharedparsedformula) 832 + +[XtiIndex](#xtiindex) 833 + +[Password](#password) 355 + +[password verifier algorithm](#password-verifier-algorithm) 164 + +[PBT](#pbt) 833 + +[PhoneticInfo](#phoneticinfo) 356 + +[PhRuns](#phruns) 834 + +[Phs](#phs) 834 + +[PicF](#picf) 356 + +[PictFmlaEmbedInfo](#pictfmlaembedinfo) 835 + +[PictFmlaKey](#pictfmlakey) 835 + +[Pie](#pie) 357 + +[Pie Chart Sheet example](#pie-chart-sheet) 974 + +[Pie chart sheet: AxesUsed example](#pie-chart-sheet-axesused) 975 + +[Pie chart sheet: AxisParent example](#pie-chart-sheet-axisparent) 976 + +[Pie chart sheet: BRAI example](#pie-chart-sheet-brai) 981 + +[Pie chart sheet: Chart example](#pie-chart-sheet-chart) 974 + +[Pie chart sheet: ChartFormat example](#pie-chart-sheet-chartformat) 976 + +[Pie chart sheet: Legend example](#pie-chart-sheet-legend) 977 + +[Pie chart sheet: Pie example](#pie-chart-sheet-pie) 976 + +[Pie chart sheet: Pos example](#pie-chart-sheet-pos) 978 + +[Pie chart sheet: PrintSize example](#pie-chart-sheet-printsize) 974 + +[Pie chart sheet: ShtProps example](#pie-chart-sheet-shtprops) 975 + +[Pie chart sheet: Text example](#pie-chart-sheet-text) 979 + +[Pie chart sheet: Window2 example](#pie-chart-sheet-window2) 981 + +[PieFormat](#pieformat) 358 + +[Pivot cache storage](#pivot-cache-storage-_sx_db_cur) 66 + +[Pivot chart](#pivot-chart) 87 + +[PivotCache](#pivotcache) 118 + +[PivotChartBits](#pivotchartbits) 358 + +[PivotCompProp](#pivotcompprop) 836 + +[PivotParsedFormula](#pivotparsedformula) 790 + +[PivotTable](#pivottable) 59 + +[PivotTable example](#pivottable-1) 1031 + +[PivotTable records](#pivottable-records) 108 + +[PivotTable view](#pivottable-view) 135 + +[PivotTable: DConRef example](#pivottable-dconref) 1033 + +[PivotTable: EOF example](#pivottable-eof) 1084 + +[PivotTable: QsiSXTag example](#pivottable-qsisxtag) 1066 + +[PivotTable: SXAddl 1 example](#pivottable-sxaddl-1) 1034 + +[PivotTable: SXAddl 2 example](#pivottable-sxaddl-2) 1035 + +[PivotTable: SXAddl 3 example](#pivottable-sxaddl-3) 1036 + +[PivotTable: SxAddl 4 example](#pivottable-sxaddl-4) 1068 + +[PivotTable: SxAddl 5 example](#pivottable-sxaddl-5) 1069 + +[PivotTable: SxAddl 6 example](#pivottable-sxaddl-6) 1071 + +[PivotTable: SXDB example](#pivottable-sxdb) 1071 + +[PivotTable: SXDBB 1 example](#pivottable-sxdbb-1) 1082 + +[PivotTable: SXDBB 2 example](#pivottable-sxdbb-2) 1083 + +[PivotTable: SXDBEx example](#pivottable-sxdbex) 1073 + +[PivotTable: SXDI example](#pivottable-sxdi) 1057 + +[PivotTable: SXDtr 1 example](#pivottable-sxdtr-1) 1077 + +[PivotTable: SXDtr 2 example](#pivottable-sxdtr-2) 1077 + +[PivotTable: SXEx example](#pivottable-sxex) 1064 + +[PivotTable: SXFDB 1 example](#pivottable-sxfdb-1) 1073 + +[PivotTable: SXFDB 2 example](#pivottable-sxfdb-2) 1076 + +[PivotTable: SXFDB 3 example](#pivottable-sxfdb-3) 1078 + +[PivotTable: SXFDB 4 example](#pivottable-sxfdb-4) 1079 + +[PivotTable: SXFDB 5 example](#pivottable-sxfdb-5) 1081 + +[PivotTable: SxIvd example](#pivottable-sxivd) 1056 + +[PivotTable: SXLI 1 example](#pivottable-sxli-1) 1057 + +[PivotTable: SXLI 2 example](#pivottable-sxli-2) 1063 + +[PivotTable: SXNum 1 example](#pivottable-sxnum-1) 1080 + +[PivotTable: SXNum 2 example](#pivottable-sxnum-2) 1082 + +[PivotTable: SXNum 3 example](#pivottable-sxnum-3) 1083 + +[PivotTable: SXPI example](#pivottable-sxpi) 1056 + +[PivotTable: SXStreamID example](#pivottable-sxstreamid) 1032 + +[PivotTable: SXString 1 example](#pivottable-sxstring-1) 1075 + +[PivotTable: SXString 3 example](#pivottable-sxstring-3) 1075 + +[PivotTable: SXString21 example](#pivottable-sxstring-2) 1075 + +[PivotTable: Sxvd 1 example](#pivottable-sxvd-1) 1040 + +[PivotTable: Sxvd 2 example](#pivottable-sxvd-2) 1045 + +[PivotTable: Sxvd 3 example](#pivottable-sxvd-3) 1049 + +[PivotTable: Sxvd 4 example](#pivottable-sxvd-4) 1050 + +[PivotTable: Sxvd 5 example](#pivottable-sxvd-5) 1053 + +[PivotTable: SXVDEx 1 example](#pivottable-sxvdex-1) 1044 + +[PivotTable: SXVDEx 2 example](#pivottable-sxvdex-2) 1048 + +[PivotTable: SXVDEx 3 example](#pivottable-sxvdex-3) 1052 + +[PivotTable: SXVDEx 4 example](#pivottable-sxvdex-4) 1054 + +[PivotTable: SXVI 1 example](#pivottable-sxvi-1) 1041 + +[PivotTable: SXVI 2 example](#pivottable-sxvi-2) 1042 + +[PivotTable: SXVI 3 example](#pivottable-sxvi-3) 1042 + +[PivotTable: SXVI 4 example](#pivottable-sxvi-4) 1043 + +[PivotTable: SXVI 5 example](#pivottable-sxvi-5) 1047 + +[PivotTable: SXVI 6 example](#pivottable-sxvi-6) 1047 + +[PivotTable: SXVI 7 example](#pivottable-sxvi-7) 1048 + +[PivotTable: SxView example](#pivottable-sxview) 1036 + +[PivotTable: SXViewEx9 example](#pivottable-sxviewex9) 1068 + +[PivotTable: SXVS example](#pivottable-sxvs) 1032 + +[PivotTables](#pivottables) 107 + +[data functionality level](#data-functionality-level) 118 + +[PivotCache](#pivotcache) 118 + +[PivotTable records](#pivottable-records) 108 + +[PivotTable view](#pivottable-view) 135 + +[PlotArea](#plotarea) 359 + +[PlotGrowth](#plotgrowth) 359 + +[Pls](#pls) 359 + +[PLV](#plv) 360 + +[Pos](#pos) 360 + +[PositionMode](#positionmode) 836 + +[PrintGrid](#printgrid) 362 + +[PrintRowCol](#printrowcol) 362 + +[PrintSize](#printsize) 363 + +[Product behavior](#appendix-a-product-behavior) 1086 + +[Prot4Rev](#prot4rev) 363 + +[Prot4RevPass](#prot4revpass) 364 + +[Protect](#protect) 364 + +[Protected content stream](#protected-content-stream-009drmcontent) 66 + +[Ptg](#ptg) 790 + +[PtgAdd](#ptgadd) 793 + +[PtgArea](#ptgarea) 793 + +[PtgArea3d](#ptgarea3d) 794 + +[PtgAreaErr](#ptgareaerr) 794 + +PtgAreaErr3d ([section 2.5.198.30](#ptgareaerr3d) 795, [section 2.5.198.31](#ptgarean) 795) + +[PtgArray](#ptgarray) 796 + +[PtgAttrBaxcel](#ptgattrbaxcel) 796 + +[PtgAttrChoose](#ptgattrchoose) 797 + +[PtgAttrGoto](#ptgattrgoto) 797 + +[PtgAttrIf](#ptgattrif) 798 + +[PtgAttrSemi](#ptgattrsemi) 798 + +[PtgAttrSpace](#ptgattrspace) 798 + +[PtgAttrSpaceSemi](#ptgattrspacesemi) 799 + +[PtgAttrSpaceType](#ptgattrspacetype) 799 + +[PtgAttrSum](#ptgattrsum) 800 + +[PtgBool](#ptgbool) 800 + +[PtgConcat](#ptgconcat) 800 + +[PtgDataType](#ptgdatatype) 800 + +[PtgDiv](#ptgdiv) 801 + +[PtgElfCol](#ptgelfcol) 801 + +[PtgElfColS](#ptgelfcols) 801 + +[PtgElfColSV](#ptgelfcolsv) 802 + +[PtgElfColV](#ptgelfcolv) 802 + +[PtgElfLel](#ptgelflel) 802 + +[PtgElfRadical](#ptgelfradical) 803 + +[PtgElfRadicalLel](#ptgelfradicallel) 803 + +[PtgElfRadicalS](#ptgelfradicals) 804 + +[PtgElfRw](#ptgelfrw) 804 + +[PtgElfRwV](#ptgelfrwv) 805 + +[PtgEq](#ptgeq) 805 + +[PtgErr](#ptgerr) 805 + +[PtgExp](#ptgexp) 805 + +[PtgExtraArray](#ptgextraarray) 806 + +[PtgExtraElf](#ptgextraelf) 806 + +[PtgExtraMem](#ptgextramem) 807 + +[PtgFunc](#ptgfunc) 807 + +[PtgFuncVar](#ptgfuncvar) 807 + +[PtgGe](#ptgge) 808 + +[PtgGt](#ptggt) 808 + +[PtgInt](#ptgint) 808 + +[PtgIsect](#ptgisect) 809 + +[PtgLe](#ptgle) 809 + +[PtgLt](#ptglt) 809 + +[PtgMemArea](#ptgmemarea) 809 + +[PtgMemErr](#ptgmemerr) 810 + +[PtgMemFunc](#ptgmemfunc) 810 + +[PtgMemNoMem](#ptgmemnomem) 811 + +[PtgMissArg](#ptgmissarg) 811 + +[PtgMul](#ptgmul) 811 + +[PtgName](#ptgname) 812 + +[PtgNameX](#ptgnamex) 812 + +[PtgNe](#ptgne) 813 + +[PtgNum](#ptgnum) 813 + +[PtgParen](#ptgparen) 813 + +[PtgPercent](#ptgpercent) 814 + +[PtgPower](#ptgpower) 814 + +[PtgRange](#ptgrange) 814 + +[PtgRef](#ptgref) 814 + +[PtgRef3d](#ptgref3d) 815 + +[PtgRefErr](#ptgreferr) 815 + +[PtgRefErr3d](#ptgreferr3d) 816 + +[PtgRefN](#ptgrefn) 816 + +[PtgStr](#ptgstr) 816 + +[PtgSub](#ptgsub) 817 + +[PtgSxName](#ptgsxname) 817 + +[PtgTbl](#ptgtbl) 817 + +[PtgUminus](#ptguminus) 818 + +[PtgUnion](#ptgunion) 818 + +[PtgUplus](#ptguplus) 818 + +Q + +[Qsi](#qsi) 364 + +[Qsif](#qsif) 367 + +[Qsir](#qsir) 368 + +[QsiSXTag](#qsisxtag) 370 + +R + +[Radar](#radar) 372 + +[RadarArea](#radararea) 372 + +[ReadingOrder](#readingorder) 836 + +[RealTimeData](#realtimedata) 373 + +[RecalcId](#recalcid) 374 + +[RecipName](#recipname) 374 + +[Record](#record) 57 + +[Record enumeration](#record-enumeration) 169 + +[by name](#by-name) 170 + +[by number](#by-number) 181 + +Records + +[AlRuns](#alruns) 192 + +[Area](#area) 192 + +[AreaFormat](#areaformat) 193 + +[Array](#array) 198 + +[AttachedLabel](#attachedlabel) 199 + +[AutoFilter](#autofilter) 200 + +[AutoFilter12](#autofilter12) 202 + +[AutoFilterInfo](#autofilterinfo) 205 + +[AxcExt](#axcext) 205 + +[AxesUsed](#axesused) 208 + +[Axis](#axis-1) 208 + +[AxisLine](#axisline) 209 + +[AxisParent](#axisparent) 210 + +[Backup](#backup) 210 + +[Bar](#bar) 210 + +[BCUsrs](#bcusrs) 211 + +[Begin](#begin) 211 + +[BigName](#bigname) 212 + +[BkHim](#bkhim) 212 + +[Blank](#blank) 213 + +[BOF](#bof) 213 + +[BookBool](#bookbool) 215 + +[BookExt](#bookext) 216 + +[BoolErr](#boolerr) 217 + +[BopPop](#boppop) 217 + +[BopPopCustom](#boppopcustom) 219 + +[BottomMargin](#bottommargin) 220 + +[BoundSheet8](#boundsheet8) 221 + +[BRAI](#brai) 222 + +[BuiltInFnGroupCount](#builtinfngroupcount) 223 + +[CalcCount](#calccount) 224 + +[CalcDelta](#calcdelta) 224 + +[CalcIter](#calciter) 224 + +[CalcMode](#calcmode) 224 + +[CalcPrecision](#calcprecision) 225 + +[CalcRefMode](#calcrefmode) 225 + +[CalcSaveRecalc](#calcsaverecalc) 225 + +[CatLab](#catlab) 226 + +[CatSerRange](#catserrange) 226 + +[CbUsr](#cbusr) 228 + +[CellWatch](#cellwatch) 228 + +[CF](#cf) 229 + +[CF12](#cf12) 230 + +[CFEx](#cfex) 233 + +[Chart](#chart-2) 234 + +[Chart3d](#chart3d) 235 + +[Chart3DBarShape](#chart3dbarshape) 237 + +[ChartFormat](#chartformat) 237 + +[ChartFrtInfo](#chartfrtinfo) 238 + +[ClrtClient](#clrtclient) 239 + +[CodeName](#codename) 240 + +[CodePage](#codepage) 240 + +[ColInfo](#colinfo) 241 + +[Compat12](#compat12) 242 + +[CompressPictures](#compresspictures) 242 + +[CondFmt](#condfmt) 243 + +[CondFmt12](#condfmt12) 243 + +[Continue](#continue) 244 + +[Continue_SxaddlSxString](#continue_sxaddlsxstring) 432 + +[ContinueBigName](#continuebigname) 244 + +[ContinueFrt](#continuefrt) 245 + +[ContinueFrt11](#continuefrt11) 245 + +[ContinueFrt12](#continuefrt12) 246 + +[Country](#country) 246 + +[CrErr](#crerr) 248 + +[CRN](#crn) 248 + +[CrtLayout12](#crtlayout12) 249 + +[CrtLayout12A](#crtlayout12a) 251 + +[CrtLine](#crtline) 253 + +[CrtLink](#crtlink) 254 + +[CrtMlFrt](#crtmlfrt) 254 + +[CrtMlFrtContinue](#crtmlfrtcontinue) 255 + +[CUsr](#cusr) 255 + +[Dat](#dat) 255 + +[DataFormat](#dataformat) 256 + +[DataLabExt](#datalabext) 256 + +[DataLabExtContents](#datalabextcontents) 257 + +[Date1904](#date1904) 258 + +[DBCell](#dbcell) 258 + +[DbOrParamQry](#dborparamqry) 259 + +[DbQuery](#dbquery) 259 + +[DbQueryExt](#dbqueryext) 261 + +[DCon](#dcon) 263 + +[DConBin](#dconbin) 265 + +[DConn](#dconn) 266 + +[DConName](#dconname) 271 + +[DConRef](#dconref) 272 + +[DefaultRowHeight](#defaultrowheight) 273 + +[DefaultText](#defaulttext) 273 + +[DefColWidth](#defcolwidth) 274 + +[Dimensions](#dimensions) 274 + +[DocRoute](#docroute) 275 + +[DropBar](#dropbar) 277 + +[DropDownObjIds](#dropdownobjids) 278 + +[DSF](#dsf) 278 + +[Dv](#dv) 278 + +[DVal](#dval) 281 + +[DXF](#dxf) 282 + +[DxGCol](#dxgcol) 283 + +[End](#end) 283 + +[EndBlock](#endblock) 283 + +[EndObject](#endobject) 285 + +[EntExU2](#entexu2) 286 + +[EOF](#eof) 286 + +[Excel9File](#excel9file) 286 + +[ExternName](#externname) 286 + +[ExternSheet](#externsheet) 288 + +[ExtSST](#extsst) 289 + +[ExtString](#extstring) 289 + +[Fbi](#fbi) 290 + +[Fbi2](#fbi2) 291 + +[Feat](#feat) 292 + +[FeatHdr](#feathdr) 293 + +[FeatHdr11](#feathdr11) 294 + +[Feature11](#feature11) 294 + +[Feature12](#feature12) 296 + +[FileLock](#filelock) 296 + +[FilePass](#filepass) 297 + +[FileSharing](#filesharing) 298 + +[FilterMode](#filtermode) 298 + +[FnGroupName](#fngroupname) 298 + +[FnGrp12](#fngrp12) 298 + +[Font](#font) 299 + +[FontX](#fontx) 301 + +[Footer](#footer) 302 + +[ForceFullCalculation](#forcefullcalculation) 302 + +[Format](#format) 303 + +[Formula](#formula) 310 + +[Frame](#frame) 311 + +[FrtFontList](#frtfontlist) 312 + +[FrtWrapper](#frtwrapper) 312 + +[GelFrame](#gelframe) 313 + +[GridSet](#gridset) 315 + +[GUIDTypeLib](#guidtypelib) 315 + +[Guts](#guts) 315 + +[HCenter](#hcenter) 316 + +[Header](#header) 316 + +[HeaderFooter](#headerfooter) 320 + +[HFPicture](#hfpicture) 321 + +[HideObj](#hideobj) 323 + +[HLink](#hlink) 323 + +[HLinkTooltip](#hlinktooltip) 323 + +[HorizontalPageBreaks](#horizontalpagebreaks) 324 + +[IFmtRecord](#ifmtrecord) 324 + +[Index](#index) 324 + +[InterfaceEnd](#interfaceend) 325 + +[InterfaceHdr](#interfacehdr) 325 + +[Intl](#intl) 325 + +[Label](#label) 326 + +[LabelSst](#labelsst) 326 + +[Lbl](#lbl) 326 + +[LeftMargin](#leftmargin) 329 + +[Legend](#legend-1) 329 + +[LegendException](#legendexception) 330 + +[Lel](#lel) 331 + +[Line](#line) 331 + +[LineFormat](#lineformat) 332 + +[List12](#list12) 333 + +[LPr](#lpr) 334 + +[LRng](#lrng) 335 + +[MarkerFormat](#markerformat) 335 + +[MDB](#mdb) 337 + +[MDTInfo](#mdtinfo) 337 + +[MDXKPI](#mdxkpi) 339 + +[MDXProp](#mdxprop) 340 + +[MDXSet](#mdxset) 340 + +[MDXStr](#mdxstr) 341 + +[MDXTuple](#mdxtuple) 342 + +[MergeCells](#mergecells) 342 + +[Mms](#mms) 343 + +[MsoDrawing](#msodrawing) 343 + +[MsoDrawingGroup](#msodrawinggroup) 343 + +[MsoDrawingSelection](#msodrawingselection) 344 + +[MTRSettings](#mtrsettings) 344 + +[MulBlank](#mulblank) 345 + +[MulRk](#mulrk) 345 + +[NameCmt](#namecmt) 346 + +[NameFnGrp12](#namefngrp12) 347 + +[NamePublish](#namepublish) 348 + +[Note](#note) 348 + +[Number](#number) 349 + +[Obj](#obj) 349 + +[ObjectLink](#objectlink) 352 + +[ObjProtect](#objprotect) 352 + +[ObNoMacros](#obnomacros) 353 + +[ObProj](#obproj) 353 + +[OleDbConn](#oledbconn) 353 + +[OleObjectSize](#oleobjectsize) 354 + +[Palette](#palette) 354 + +[Pane](#pane) 354 + +[ParamQry](#paramqry) 355 + +[Password](#password) 355 + +[PhoneticInfo](#phoneticinfo) 356 + +[PicF](#picf) 356 + +[Pie](#pie) 357 + +[PieFormat](#pieformat) 358 + +[PivotChartBits](#pivotchartbits) 358 + +[PlotArea](#plotarea) 359 + +[PlotGrowth](#plotgrowth) 359 + +[Pls](#pls) 359 + +[PLV](#plv) 360 + +[Pos](#pos) 360 + +[PrintGrid](#printgrid) 362 + +[PrintRowCol](#printrowcol) 362 + +[PrintSize](#printsize) 363 + +[Prot4Rev](#prot4rev) 363 + +[Prot4RevPass](#prot4revpass) 364 + +[Protect](#protect) 364 + +[Qsi](#qsi) 364 + +[Qsif](#qsif) 367 + +[Qsir](#qsir) 368 + +[QsiSXTag](#qsisxtag) 370 + +[Radar](#radar) 372 + +[RadarArea](#radararea) 372 + +[RealTimeData](#realtimedata) 373 + +[RecalcId](#recalcid) 374 + +[RecipName](#recipname) 374 + +[RefreshAll](#refreshall) 375 + +[RichTextStream](#richtextstream) 375 + +[RightMargin](#rightmargin) 377 + +[RK](#rk) 377 + +[Row](#row) 378 + +[RRAutoFmt](#rrautofmt) 379 + +[RRDChgCell](#rrdchgcell) 380 + +[RRDConflict](#rrdconflict) 384 + +[RRDDefName](#rrddefname) 385 + +[RRDHead](#rrdhead) 387 + +[RRDInfo](#rrdinfo) 389 + +[RRDInsDel](#rrdinsdel) 390 + +[RRDInsDelBegin](#rrdinsdelbegin) 391 + +[RRDInsDelEnd](#rrdinsdelend) 391 + +[RRDMove](#rrdmove) 391 + +[RRDMoveBegin](#rrdmovebegin) 392 + +[RRDMoveEnd](#rrdmoveend) 392 + +[RRDRenSheet](#rrdrensheet) 392 + +[RRDRstEtxp](#rrdrstetxp) 393 + +[RRDTQSIF](#rrdtqsif) 394 + +[RRDUserView](#rrduserview) 395 + +[RRFormat](#rrformat) 396 + +[RRInsertSh](#rrinsertsh) 396 + +[RRSort](#rrsort) 397 + +[RRTabId](#rrtabid) 398 + +[SBaseRef](#sbaseref) 398 + +[Scatter](#scatter) 399 + +[SCENARIO](#scenario) 400 + +[ScenarioProtect](#scenarioprotect) 401 + +[ScenMan](#scenman) 401 + +[Scl](#scl) 402 + +[Selection](#selection) 402 + +[SerAuxErrBar](#serauxerrbar) 403 + +[SerAuxTrend](#serauxtrend) 404 + +[SerFmt](#serfmt) 405 + +[Series](#series-1) 406 + +[SeriesList](#serieslist) 407 + +[SeriesText](#seriestext) 407 + +[SerParent](#serparent) 407 + +[SerToCrt](#sertocrt) 408 + +[Setup](#setup) 408 + +[ShapePropsStream](#shapepropsstream) 413 + +[SheetExt](#sheetext) 414 + +[ShrFmla](#shrfmla) 415 + +[ShtProps](#shtprops) 415 + +[SIIndex](#siindex) 416 + +[Sort](#sort) 417 + +[SortData](#sortdata) 418 + +[SST](#sst) 420 + +[StartBlock](#startblock) 421 + +[StartObject](#startobject) 426 + +[String](#string) 427 + +[Style](#style) 427 + +[StyleExt](#styleext) 428 + +[SupBook](#supbook) 429 + +[Surf](#surf) 431 + +[SXAddl](#sxaddl) 432 + +[SXAddl_SXCAutoSort_SXDEnd](#sxaddl_sxcautosort_sxdend) 433 + +[SXAddl_SXCAutoSort_SXDId](#sxaddl_sxcautosort_sxdid) 433 + +[SXAddl_SXCCache_SXDEnd](#sxaddl_sxccache_sxdend) 434 + +[SXAddl_SXCCache_SXDId](#sxaddl_sxccache_sxdid) 434 + +[SXAddl_SXCCache_SXDInfo12](#sxaddl_sxccache_sxdinfo12) 434 + +[SXAddl_SXCCache_SXDInvRefreshReal](#sxaddl_sxccache_sxdinvrefreshreal) 435 + +[SXAddl_SXCCache_SXDVer10Info](#sxaddl_sxccache_sxdver10info) 435 + +[SXAddl_SXCCache_SXDVerSXMacro](#sxaddl_sxccache_sxdversxmacro) 436 + +[SXAddl_SXCCache_SXDVerUpdInv](#sxaddl_sxccache_sxdverupdinv) 437 + +[SXAddl_SXCCacheField_SXDCaption](#sxaddl_sxccachefield_sxdcaption) 437 + +[SXAddl_SXCCacheField_SXDEnd](#sxaddl_sxccachefield_sxdend) 437 + +[SXAddl_SXCCacheField_SXDId](#sxaddl_sxccachefield_sxdid) 438 + +[SXAddl_SXCCacheField_SXDIfdbMempropMap](#sxaddl_sxccachefield_sxdifdbmempropmap) 438 + +[SXAddl_SXCCacheField_SXDIfdbMpMapCount](#sxaddl_sxccachefield_sxdifdbmpmapcount) 439 + +[SXAddl_SXCCacheField_SXDProperty](#sxaddl_sxccachefield_sxdproperty) 439 + +[SXAddl_SXCCacheField_SXDPropName](#sxaddl_sxccachefield_sxdpropname) 440 + +[SXAddl_SXCCacheField_SXDSxrmitmCount](#sxaddl_sxccachefield_sxdsxrmitmcount) 440 + +[SXAddl_SXCCacheItem_SXDEnd](#sxaddl_sxccacheitem_sxdend) 441 + +[SXAddl_SXCCacheItem_SXDId](#sxaddl_sxccacheitem_sxdid) 441 + +[SXAddl_SXCCacheItem_SXDItmMpMapCount](#sxaddl_sxccacheitem_sxditmmpmapcount) 441 + +[SXAddl_SXCCacheItem_SXDItmMpropMap](#sxaddl_sxccacheitem_sxditmmpropmap) 442 + +[SXAddl_SXCCacheItem_SXDSxrmitmDisp](#sxaddl_sxccacheitem_sxdsxrmitmdisp) 442 + +[SXAddl_SXCField_SXDEnd](#sxaddl_sxcfield_sxdend) 443 + +[SXAddl_SXCField_SXDId](#sxaddl_sxcfield_sxdid) 443 + +[SXAddl_SXCField_SXDVer10Info](#sxaddl_sxcfield_sxdver10info) 443 + +[SXAddl_SXCField12_SXDAutoshow](#sxaddl_sxcfield12_sxdautoshow) 444 + +[SXAddl_SXCField12_SXDEnd](#sxaddl_sxcfield12_sxdend) 444 + +[SXAddl_SXCField12_SXDId](#sxaddl_sxcfield12_sxdid) 445 + +[SXAddl_SXCField12_SXDISXTH](#sxaddl_sxcfield12_sxdisxth) 445 + +[SXAddl_SXCField12_SXDMemberCaption](#sxaddl_sxcfield12_sxdmembercaption) 446 + +[SXAddl_SXCField12_SXDVer12Info](#sxaddl_sxcfield12_sxdver12info) 446 + +[SXAddl_SXCField12_SXDVerUpdInv](#sxaddl_sxcfield12_sxdverupdinv) 447 + +[SXAddl_SXCGroup_SXDEnd](#sxaddl_sxcgroup_sxdend) 447 + +[SXAddl_SXCGroup_SXDGrpInfo](#sxaddl_sxcgroup_sxdgrpinfo) 448 + +[SXAddl_SXCGroup_SXDId](#sxaddl_sxcgroup_sxdid) 449 + +[SXAddl_SXCGroup_SXDMember](#sxaddl_sxcgroup_sxdmember) 449 + +[SXAddl_SXCGrpLevel_SXDEnd](#sxaddl_sxcgrplevel_sxdend) 450 + +[SXAddl_SXCGrpLevel_SXDGrpLevelInfo](#sxaddl_sxcgrplevel_sxdgrplevelinfo) 450 + +[SXAddl_SXCGrpLevel_SXDId](#sxaddl_sxcgrplevel_sxdid) 451 + +[SXAddl_SXCHierarchy_SXDDisplayFolder](#sxaddl_sxchierarchy_sxddisplayfolder) 451 + +[SXAddl_SXCHierarchy_SXDEnd](#sxaddl_sxchierarchy_sxdend) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember](#sxaddl_sxchierarchy_sxdfiltermember) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember12](#sxaddl_sxchierarchy_sxdfiltermember12) 453 + +[SXAddl_SXCHierarchy_SXDIconSet](#sxaddl_sxchierarchy_sxdiconset) 454 + +[SXAddl_SXCHierarchy_SXDId](#sxaddl_sxchierarchy_sxdid) 454 + +[SXAddl_SXCHierarchy_SXDInfo12](#sxaddl_sxchierarchy_sxdinfo12) 455 + +[SXAddl_SXCHierarchy_SXDKPIGoal](#sxaddl_sxchierarchy_sxdkpigoal) 456 + +[SXAddl_SXCHierarchy_SXDKPIStatus](#sxaddl_sxchierarchy_sxdkpistatus) 456 + +[SXAddl_SXCHierarchy_SXDKPITime](#sxaddl_sxchierarchy_sxdkpitime) 456 + +[SXAddl_SXCHierarchy_SXDKPITrend](#sxaddl_sxchierarchy_sxdkpitrend) 457 + +[SXAddl_SXCHierarchy_SXDKPIValue](#sxaddl_sxchierarchy_sxdkpivalue) 457 + +[SXAddl_SXCHierarchy_SXDKPIWeight](#sxaddl_sxchierarchy_sxdkpiweight) 458 + +[SXAddl_SXCHierarchy_SXDMeasureGrp](#sxaddl_sxchierarchy_sxdmeasuregrp) 458 + +[SXAddl_SXCHierarchy_SXDParentKPI](#sxaddl_sxchierarchy_sxdparentkpi) 459 + +[SXAddl_SXCHierarchy_SXDProperty](#sxaddl_sxchierarchy_sxdproperty) 459 + +[SXAddl_SXCHierarchy_SXDSXSetParentUnique](#sxaddl_sxchierarchy_sxdsxsetparentunique) 461 + +[SXAddl_SXCHierarchy_SXDUserCaption](#sxaddl_sxchierarchy_sxdusercaption) 461 + +[SXAddl_SXCHierarchy_SXDVerUpdInv](#sxaddl_sxchierarchy_sxdverupdinv) 461 + +[SXAddl_SXCQsi_SXDEnd](#sxaddl_sxcqsi_sxdend) 462 + +[SXAddl_SXCQsi_SXDId](#sxaddl_sxcqsi_sxdid) 462 + +[SXAddl_SXCQuery_SXDEnd](#sxaddl_sxcquery_sxdend) 462 + +[SXAddl_SXCQuery_SXDReconnCond](#sxaddl_sxcquery_sxdreconncond) 463 + +[SXAddl_SXCQuery_SXDSrcConnFile](#sxaddl_sxcquery_sxdsrcconnfile) 464 + +[SXAddl_SXCQuery_SXDSrcDataFile](#sxaddl_sxcquery_sxdsrcdatafile) 464 + +[SXAddl_SXCQuery_SXDXMLSource](#sxaddl_sxcquery_sxdxmlsource) 464 + +[SXAddl_SXCSXCondFmt_SXDEnd](#sxaddl_sxcsxcondfmt_sxdend) 465 + +[SXAddl_SXCSXCondFmt_SXDSXCondFmt](#sxaddl_sxcsxcondfmt_sxdsxcondfmt) 465 + +[SXAddl_SXCSXCondFmts_SXDEnd](#sxaddl_sxcsxcondfmts_sxdend) 466 + +[SXAddl_SXCSXCondFmts_SXDId](#sxaddl_sxcsxcondfmts_sxdid) 467 + +[SXAddl_SXCSXDH_SXDEnd](#sxaddl_sxcsxdh_sxdend) 467 + +[SXAddl_SXCSXDH_SXDId](#sxaddl_sxcsxdh_sxdid) 468 + +[SXAddl_SXCSXDH_SXDSxdh](#sxaddl_sxcsxdh_sxdsxdh) 468 + +[SXAddl_SXCSXfilt_SXDEnd](#sxaddl_sxcsxfilt_sxdend) 469 + +[SXAddl_SXCSXfilt_SXDId](#sxaddl_sxcsxfilt_sxdid) 470 + +[SXAddl_SXCSXfilt_SXDSXfilt](#sxaddl_sxcsxfilt_sxdsxfilt) 470 + +[SXAddl_SXCSXfilt_SXDSXItm](#sxaddl_sxcsxfilt_sxdsxitm) 471 + +[SXAddl_SXCSXFilter12_SXDCaption](#sxaddl_sxcsxfilter12_sxdcaption) 472 + +[SXAddl_SXCSXFilter12_SXDEnd](#sxaddl_sxcsxfilter12_sxdend) 473 + +[SXAddl_SXCSXFilter12_SXDId](#sxaddl_sxcsxfilter12_sxdid) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilter](#sxaddl_sxcsxfilter12_sxdsxfilter) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilterDesc](#sxaddl_sxcsxfilter12_sxdsxfilterdesc) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue1](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue2](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2) 475 + +[SXAddl_SXCSXFilter12_SXDXlsFilter](#sxaddl_sxcsxfilter12_sxdxlsfilter) 476 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue1](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1) 476 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue2](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2) 477 + +[SXAddl_SXCSXFilters12_SXDEnd](#sxaddl_sxcsxfilters12_sxdend) 477 + +[SXAddl_SXCSXFilters12_SXDId](#sxaddl_sxcsxfilters12_sxdid) 478 + +[SXAddl_SXCSXMg_SXDEnd](#sxaddl_sxcsxmg_sxdend) 478 + +[SXAddl_SXCSXMg_SXDId](#sxaddl_sxcsxmg_sxdid) 478 + +[SXAddl_SXCSXMg_SXDUserCaption](#sxaddl_sxcsxmg_sxdusercaption) 479 + +[SXAddl_SXCSXMgs_SXDEnd](#sxaddl_sxcsxmgs_sxdend) 479 + +[SXAddl_SXCSXMgs_SXDId](#sxaddl_sxcsxmgs_sxdid) 479 + +[SXAddl_SXCSXMgs_SXDMGrpSXDHMap](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap) 480 + +[SXAddl_SXCSXrule_SXDEnd](#sxaddl_sxcsxrule_sxdend) 481 + +[SXAddl_SXCSXrule_SXDId](#sxaddl_sxcsxrule_sxdid) 481 + +[SXAddl_SXCSXrule_SXDSXrule](#sxaddl_sxcsxrule_sxdsxrule) 481 + +[SXAddl_SXCView_SXDCalcMember](#sxaddl_sxcview_sxdcalcmember) 484 + +[SXAddl_SXCView_SXDCalcMemString](#sxaddl_sxcview_sxdcalcmemstring) 486 + +[SXAddl_SXCView_SXDCompactColHdr](#sxaddl_sxcview_sxdcompactcolhdr) 486 + +[SXAddl_SXCView_SXDCompactRwHdr](#sxaddl_sxcview_sxdcompactrwhdr) 487 + +[SXAddl_SXCView_SXDEnd](#sxaddl_sxcview_sxdend) 487 + +[SXAddl_SXCView_SXDId](#sxaddl_sxcview_sxdid) 488 + +[SXAddl_SXCView_SXDSXPIIvmb](#sxaddl_sxcview_sxdsxpiivmb) 488 + +[SXAddl_SXCView_SXDTableStyleClient](#sxaddl_sxcview_sxdtablestyleclient) 489 + +[SXAddl_SXCView_SXDVer10Info](#sxaddl_sxcview_sxdver10info) 489 + +[SXAddl_SXCView_SXDVer12Info](#sxaddl_sxcview_sxdver12info) 491 + +[SXAddl_SXCView_SXDVerUpdInv](#sxaddl_sxcview_sxdverupdinv) 493 + +[SxBool](#sxbool) 494 + +[SXDB](#sxdb) 494 + +[SXDBB](#sxdbb) 495 + +[SXDBEx](#sxdbex) 495 + +[SXDI](#sxdi) 496 + +[SXDtr](#sxdtr) 498 + +[SxDXF](#sxdxf) 498 + +[SxErr](#sxerr) 499 + +[SXEx](#sxex) 499 + +[SXFDB](#sxfdb) 502 + +[SXFDBType](#sxfdbtype) 505 + +[SxFilt](#sxfilt) 505 + +[SxFmla](#sxfmla) 506 + +[SxFormat](#sxformat) 507 + +[SxFormula](#sxformula) 507 + +[SxInt](#sxint) 507 + +[SxIsxoper](#sxisxoper) 508 + +[SxItm](#sxitm) 508 + +[SxIvd](#sxivd) 509 + +[SXLI](#sxli) 510 + +[SxName](#sxname) 510 + +[SxNil](#sxnil) 511 + +[SXNum](#sxnum) 511 + +[SXPair](#sxpair) 511 + +[SXPI](#sxpi) 512 + +[SXPIEx](#sxpiex) 513 + +[SXRng](#sxrng) 513 + +[SxRule](#sxrule) 515 + +[SxSelect](#sxselect) 517 + +[SXStreamID](#sxstreamid) 519 + +[SXString](#sxstring) 519 + +[SXTbl](#sxtbl) 519 + +[SxTbpg](#sxtbpg) 520 + +[SXTBRGIITM](#sxtbrgiitm) 521 + +[SXTH](#sxth) 521 + +[Sxvd](#sxvd) 524 + +[SXVDEx](#sxvdex) 528 + +[SXVDTEx](#sxvdtex) 531 + +[SXVI](#sxvi) 532 + +[SxView](#sxview) 534 + +[SxViewEx](#sxviewex) 536 + +[SxViewEx9](#sxviewex9) 537 + +[SxViewLink](#sxviewlink) 538 + +[SXVS](#sxvs) 539 + +[Sync](#sync) 539 + +[Table](#table) 539 + +[TableStyle](#tablestyle) 541 + +[TableStyleElement](#tablestyleelement) 542 + +[TableStyles](#tablestyles) 545 + +[Template](#template) 546 + +[Text](#text) 546 + +[TextPropsStream](#textpropsstream) 551 + +[Theme](#theme) 553 + +[Tick](#tick) 553 + +[TopMargin](#topmargin) 556 + +[TxO](#txo) 557 + +[TxtQry](#txtqry) 559 + +[Uncalced](#uncalced) 561 + +[Units](#units) 561 + +[UserBView](#userbview) 561 + +[UserSViewBegin](#usersviewbegin) 565 + +[UserSViewBegin_Chart](#usersviewbegin_chart) 568 + +[UserSViewEnd](#usersviewend) 570 + +[UsesELFs](#useselfs) 570 + +[UsrChk](#usrchk) 570 + +[UsrExcl](#usrexcl) 571 + +[UsrInfo](#usrinfo) 572 + +[ValueRange](#valuerange) 572 + +[VCenter](#vcenter) 575 + +[VerticalPageBreaks](#verticalpagebreaks) 575 + +[WebPub](#webpub) 575 + +[Window1](#window1) 578 + +[Window2](#window2) 579 + +[WinProtect](#winprotect) 581 + +[WOpt](#wopt) 582 + +[WriteAccess](#writeaccess) 583 + +[WriteProtect](#writeprotect) 584 + +[WsBool](#wsbool) 584 + +[XCT](#xct) 585 + +[XF](#xf) 585 + +[XFCRC](#xfcrc) 586 + +[XFExt](#xfext) 586 + +[YMult](#ymult) 587 + +[Ref](#ref) 837 + +[Ref8](#ref8) 837 + +[Ref8U](#ref8u) 838 + +[Ref8U2007](#ref8u2007) 838 + +[References](#references) 52 + +[informative](#informative-references) 53 + +[normative](#normative-references) 52 + +[RefreshAll](#refreshall) 375 + +[RefU](#refu) 839 + +[Relationship to protocols and other structures](#relationship-to-protocols-and-other-structures) 55 + +[RevExtern](#revextern) 819 + +[Revision logs](#revision-logs) 168 + +[Revision records](#revision-records) 168 + +[Revision stream](#revision-stream-revision-log) 66 + +[RevisionType](#revisiontype) 839 + +[RevItab](#revitab) 819 + +[RevLblName](#revlblname) 820 + +[RevName](#revname) 821 + +[RevNamePly](#revnameply) 822 + +[RevNameTabid](#revnametabid) 822 + +[RevSheetName](#revsheetname) 822 + +[RFX](#rfx) 840 + +[RgbExtra](#rgbextra) 823 + +[Rgce](#rgce) 824 + +[RgceArea](#rgcearea) 827 + +[RgceAreaRel](#rgcearearel) 828 + +[RgceElfLoc](#rgceelfloc) 828 + +[RgceElfLocExtra](#rgceelflocextra) 829 + +[RgceLoc](#rgceloc) 829 + +[RgceLoc8](#rgceloc8) 829 + +[RgceLocRel](#rgcelocrel) 829 + +[RichTextStream](#richtextstream) 375 + +[RichTextStreamChecksumData](#richtextstreamchecksumdata) 840 + +[RichTextStreamChecksumFontInformation](#richtextstreamchecksumfontinformation) 842 + +[RichTextStreamChecksumFontInformationArrayItem](#richtextstreamchecksumfontinformationarrayitem) 844 + +[RightMargin](#rightmargin) 377 + +[RK](#rk) 377 + +[RkNumber](#rknumber) 844 + +[RkRec](#rkrec) 845 + +[Row](#row) 378 + +[RPHSSub](#rphssub) 845 + +[RRAutoFmt](#rrautofmt) 379 + +[RRD](#rrd) 846 + +[RRDChgCell](#rrdchgcell) 380 + +[RRDConflict](#rrdconflict) 384 + +[RRDDefName](#rrddefname) 385 + +[RRDDefNameFlags](#rrddefnameflags) 846 + +[RRDHead](#rrdhead) 387 + +[RRDInfo](#rrdinfo) 389 + +[RRDInsDel](#rrdinsdel) 390 + +[RRDInsDelBegin](#rrdinsdelbegin) 391 + +[RRDInsDelEnd](#rrdinsdelend) 391 + +[RRDMove](#rrdmove) 391 + +[RRDMoveBegin](#rrdmovebegin) 392 + +[RRDMoveEnd](#rrdmoveend) 392 + +[RRDRenSheet](#rrdrensheet) 392 + +[RRDRstEtxp](#rrdrstetxp) 393 + +[RRDTQSIF](#rrdtqsif) 394 + +[RRDUserView](#rrduserview) 395 + +[RRFormat](#rrformat) 396 + +[RRInsertSh](#rrinsertsh) 396 + +[RRLoc](#rrloc) 848 + +[RRSort](#rrsort) 397 + +[RRTabId](#rrtabid) 398 + +[RTDEItem](#rtdeitem) 848 + +[RTDOper](#rtdoper) 848 + +[RTDOperStr](#rtdoperstr) 849 + +[Run](#run) 849 + +[Rw](#rw) 849 + +[Rw12](#rw12) 850 + +[RwLongU](#rwlongu) 850 + +[RwU](#rwu) 850 + +[Rwx](#rwx) 850 + +S + +[SBaseRef](#sbaseref) 398 + +[Scatter](#scatter) 399 + +[SCENARIO](#scenario) 400 + +[ScenarioProtect](#scenarioprotect) 401 + +[ScenMan](#scenman) 401 + +[Scl](#scl) 402 + +[Script](#script) 851 + +[SD_SetSortOrder](#sd_setsortorder) 851 + +[SDContainer](#sdcontainer) 851 + +[Security - implementer considerations](#security-considerations) 1085 + +[Security – implementer considerations](#security-considerations) 1085 + +Security considerations + +[encryption (password to open)](#encryption-password-to-open) 165 + +[password verifier algorithm](#password-verifier-algorithm) 164 + +[SecurityDescriptor](#securitydescriptor) 852 + +[Selection](#selection) 402 + +[SerAr](#serar) 830 + +[SerAuxErrBar](#serauxerrbar) 403 + +[SerAuxTrend](#serauxtrend) 404 + +[SerBool](#serbool) 830 + +[SerErr](#sererr) 831 + +[SerFmt](#serfmt) 405 + +Series ([section 2.2.3.9](#series) 94, [section 2.4.252](#series-1) 406) + +[SeriesList](#serieslist) 407 + +[SeriesText](#seriestext) 407 + +[SerNil](#sernil) 831 + +[SerNum](#sernum) 831 + +[SerParent](#serparent) 407 + +[SerStr](#serstr) 832 + +[SerToCrt](#sertocrt) 408 + +[Setup](#setup) 408 + +[ShapePropsStream](#shapepropsstream) 413 + +[ShapePropsStreamChecksumData](#shapepropsstreamchecksumdata) 852 + +[Shared feature](#shared-feature) 169 + +[Shared workbooks](#shared-workbooks) 166 + +[change cells revision](#change-cells-revision) 169 + +[insertion/deletion of rows/columns revision](#insertion-deletion-of-rows-columns-revision) 168 + +[move cells revision](#move-cells-revision) 169 + +[revision logs](#revision-logs) 168 + +[revision records](#revision-records) 168 + +[sort map](#sort-map) 169 + +[user log](#user-log) 168 + +[SharedFeatureType](#sharedfeaturetype) 853 + +[SharedParsedFormula](#sharedparsedformula) 832 + +[SheetExt](#sheetext) 414 + +[SheetExtOptional](#sheetextoptional) 854 + +[ShortDTR](#shortdtr) 855 + +[ShortXLUnicodeString](#shortxlunicodestring) 855 + +[ShrFmla](#shrfmla) 415 + +[ShtProps](#shtprops) 415 + +[Signatures stream](#signatures-stream-_signatures) 67 + +[SIIndex](#siindex) 416 + +[SLCO8](#slco8) 856 + +[Sort](#sort) 417 + +[sort map](#sort-map) 169 + +[SortCond12](#sortcond12) 856 + +[SortData](#sortdata) 418 + +[SortItem](#sortitem) 857 + +[SourceType](#sourcetype) 858 + +[SPRC](#sprc) 104 + +[SQElfFlags](#sqelfflags) 858 + +[SqRef](#sqref) 858 + +[SqRefU](#sqrefu) 859 + +[SST](#sst) 420 + +[StartBlock](#startblock) 421 + +[StartObject](#startobject) 426 + +[Storages](#storages-and-streams) 59 + +[Stream](#stream) 57 + +[Streams](#storages-and-streams) 59 + +[document summary information](#document-summary-information-stream-005documentsummaryinformation) 60 + +[String](#string) 427 + +Structures + +[AddinUdf](#addinudf) 588 + +[AF12CellIcon](#af12cellicon) 588 + +[AF12Criteria](#af12criteria) 589 + +[AF12DateInfo](#af12dateinfo) 589 + +[AFDOper](#afdoper) 590 + +[AFDOperBoolErr](#afdoperboolerr) 591 + +[AFDOperRk](#afdoperrk) 592 + +[AFDOperStr](#afdoperstr) 592 + +[ArrayParsedFormula](#arrayparsedformula) 725 + +[AutoFmt8](#autofmt8) 593 + +[BErr](#berr) 725 + +[Bes](#bes) 594 + +[Bold](#bold) 595 + +[BookExt_Conditional11](#bookext_conditional11) 595 + +[BookExt_Conditional12](#bookext_conditional12) 595 + +[Boolean](#boolean) 596 + +[BorderStyle](#borderstyle) 596 + +[BuiltInStyle](#builtinstyle) 597 + +[CachedDiskHeader](#cacheddiskheader) 597 + +[Cch255](#cch255) 598 + +[Cell](#cell) 598 + +[CellParsedFormula](#cellparsedformula) 726 + +[CellXF](#cellxf) 598 + +[Cetab](#cetab) 726 + +[CFColor](#cfcolor) 602 + +[CFDatabar](#cfdatabar) 602 + +[CFExAveragesTemplateParams](#cfexaveragestemplateparams) 604 + +[CFExDateTemplateParams](#cfexdatetemplateparams) 604 + +[CFExDefaultTemplateParams](#cfexdefaulttemplateparams) 605 + +[CFExFilterParams](#cfexfilterparams) 605 + +[CFExNonCF12](#cfexnoncf12) 606 + +[CFExTemplateParams](#cfextemplateparams) 608 + +[CFExTextTemplateParams](#cfextexttemplateparams) 609 + +[CFFilter](#cffilter) 609 + +[CFFlag](#cfflag) 610 + +[CFGradient](#cfgradient) 611 + +[CFGradientInterpItem](#cfgradientinterpitem) 611 + +[CFGradientItem](#cfgradientitem) 612 + +[CFMStateItem](#cfmstateitem) 613 + +[CFMultistate](#cfmultistate) 613 + +[CFParsedFormula](#cfparsedformula) 755 + +[CFParsedFormulaNoCCE](#cfparsedformulanocce) 755 + +[CFrtId](#cfrtid) 614 + +[CFT](#cft) 615 + +[CFVO](#cfvo) 616 + +[CFVOParsedFormula](#cfvoparsedformula) 755 + +[ChartNumNillable](#chartnumnillable) 617 + +[ChartParsedFormula](#chartparsedformula) 756 + +[Col](#col) 617 + +[Col_NegativeOne](#col_negativeone) 617 + +[Col12](#col12) 618 + +[Col256U](#col256u) 618 + +[ColByte](#colbyte) 618 + +[ColByteU](#colbyteu) 619 + +[ColElfU](#colelfu) 619 + +[ColorICV](#coloricv) 619 + +[ColorTheme](#colortheme) 620 + +[ColRelNegU](#colrelnegu) 620 + +[ColRelU](#colrelu) 621 + +[ColSlco8U](#colslco8u) 621 + +[ColU](#colu) 621 + +[Colx](#colx) 622 + +[conceptual overview](#conceptual-overview) 80 + +[CondDataValue](#conddatavalue) 622 + +[CondFmtStructure](#condfmtstructure) 622 + +[ConnGrbitDbt](#conngrbitdbt) 623 + +[ConnGrbitDbtAdo](#conngrbitdbtado) 623 + +[ConnGrbitDbtOledb](#conngrbitdbtoledb) 624 + +[ConnGrbitDbtWeb](#conngrbitdbtweb) 625 + +[ControlInfo](#controlinfo) 626 + +[CrtLayout12Mode](#crtlayout12mode) 626 + +[DataFunctionalityLevel](#datafunctionalitylevel) 627 + +[DataSourceType](#datasourcetype) 627 + +[DateAsNum](#dateasnum) 627 + +[DateUnit](#dateunit) 627 + +[DCol](#dcol) 628 + +[DColByteU](#dcolbyteu) 628 + +[DConFile](#dconfile) 628 + +[DConnConnectionOleDb](#dconnconnectionoledb) 629 + +[DConnConnectionWeb](#dconnconnectionweb) 630 + +[DConnId](#dconnid) 630 + +[DConnParamBinding](#dconnparambinding) 631 + +[DConnParamBindingValByte](#dconnparambindingvalbyte) 631 + +[DConnParamBindingValInt](#dconnparambindingvalint) 631 + +[DConnParamBindingValString](#dconnparambindingvalstring) 631 + +[DConnParamBindingValType](#dconnparambindingvaltype) 632 + +[DConnParameter](#dconnparameter) 632 + +[DConnStringSequence](#dconnstringsequence) 633 + +[DConnUnicodeStringSegmented](#dconnunicodestringsegmented) 633 + +[DJoin](#djoin) 634 + +[DRw](#drw) 634 + +[DRwByteU](#drwbyteu) 634 + +[Duce](#duce) 634 + +[DuceRadical](#duceradical) 635 + +[DuceStacked](#ducestacked) 636 + +[Ducr](#ducr) 636 + +[DucrConditionalLbl](#ducrconditionallbl) 637 + +[DucrConditionalNoLbl](#ducrconditionalnolbl) 638 + +[DVParsedFormula](#dvparsedformula) 756 + +[DwQsiFuture](#dwqsifuture) 638 + +[DXFALC](#dxfalc) 639 + +[DXFBdr](#dxfbdr) 640 + +[DXFFntD](#dxffntd) 641 + +[DXFId](#dxfid) 642 + +[DXFN](#dxfn) 642 + +[DXFN12](#dxfn12) 645 + +[DXFN12List](#dxfn12list) 646 + +[DXFN12NoCB](#dxfn12nocb) 646 + +[DXFNum](#dxfnum) 646 + +[DXFNumIFmt](#dxfnumifmt) 647 + +[DXFNumUsr](#dxfnumusr) 647 + +[DXFPat](#dxfpat) 647 + +[DXFProt](#dxfprot) 648 + +[EnhancedProtection](#enhancedprotection) 648 + +[ExternDdeLinkNoOper](#externddelinknooper) 649 + +[ExternDocName](#externdocname) 649 + +[ExternOleDdeLink](#externoleddelink) 650 + +[ExtNameParsedFormula](#extnameparsedformula) 757 + +[ExtProp](#extprop) 650 + +[ExtPtgArea3D](#extptgarea3d) 758 + +[ExtPtgAreaErr3D](#extptgareaerr3d) 758 + +[ExtPtgErr](#extptgerr) 758 + +[ExtPtgRef3D](#extptgref3d) 759 + +[ExtPtgRefErr3D](#extptgreferr3d) 759 + +[ExtRst](#extrst) 651 + +[ExtSheetPair](#extsheetpair) 759 + +[FactoidData](#factoiddata) 652 + +[Feat11CellStruct](#feat11cellstruct) 652 + +[Feat11FdaAutoFilter](#feat11fdaautofilter) 652 + +[Feat11FieldDataItem](#feat11fielddataitem) 653 + +[Feat11Fmla](#feat11fmla) 660 + +[Feat11RgInvalidCells](#feat11rginvalidcells) 660 + +[Feat11RgSharepointIdChange](#feat11rgsharepointidchange) 660 + +[Feat11RgSharepointIdDel](#feat11rgsharepointiddel) 661 + +[Feat11TotalFmla](#feat11totalfmla) 661 + +[Feat11WSSListInfo](#feat11wsslistinfo) 661 + +[Feat11XMap](#feat11xmap) 664 + +[Feat11XMapEntry](#feat11xmapentry) 664 + +[Feat11XMapEntry2](#feat11xmapentry2) 665 + +[FeatFormulaErr2](#featformulaerr2) 665 + +[FeatProtection](#featprotection) 665 + +[FeatSmartTag](#featsmarttag) 666 + +[FFErrorCheck](#fferrorcheck) 667 + +[file structure](#file-structure) 57 + +[FillPattern](#fillpattern) 667 + +[FillStylePropertiesForShapePropsStreamChecksum](#fillstylepropertiesforshapepropsstreamchecksum) 668 + +[FontIndex](#fontindex) 678 + +[FontInfo](#fontinfo) 678 + +[FontScheme](#fontscheme) 679 + +[FormatRun](#formatrun) 679 + +[FormulaValue](#formulavalue) 679 + +[FrtFlags](#frtflags) 680 + +[FrtHeader](#frtheader) 681 + +[FrtHeaderOld](#frtheaderold) 681 + +[FrtRefHeader](#frtrefheader) 681 + +[FrtRefHeaderNoGrbit](#frtrefheadernogrbit) 682 + +[FrtRefHeaderU](#frtrefheaderu) 682 + +[Ftab](#ftab) 760 + +[FtCbls](#ftcbls) 683 + +[FtCblsData](#ftcblsdata) 683 + +[FtCf](#ftcf) 684 + +[FtCmo](#ftcmo) 684 + +[FtEdoData](#ftedodata) 687 + +[FtGboData](#ftgbodata) 688 + +[FtGmo](#ftgmo) 688 + +[FtLbsData](#ftlbsdata) 689 + +[FtMacro](#ftmacro) 691 + +[FtNts](#ftnts) 692 + +[FtPictFmla](#ftpictfmla) 692 + +[FtPioGrbit](#ftpiogrbit) 693 + +[FtRbo](#ftrbo) 695 + +[FtRboData](#ftrbodata) 695 + +[FtSbs](#ftsbs) 696 + +[FullColorExt](#fullcolorext) 697 + +[GradStop](#gradstop) 697 + +[HiddenMemberSet](#hiddenmemberset) 698 + +[HideObjEnum](#hideobjenum) 698 + +[HorizAlign](#horizalign) 699 + +[HorzBrk](#horzbrk) 699 + +[Icv](#icv) 699 + +[IcvChart](#icvchart) 703 + +[IcvFont](#icvfont) 703 + +[IcvXF](#icvxf) 703 + +[IFmt](#ifmt) 703 + +[Ilel](#ilel) 787 + +[InteriorColorPropertiesForShapePropsStreamChecksum](#interiorcolorpropertiesforshapepropsstreamchecksum) 704 + +[ISSTInf](#isstinf) 705 + +[IXFCell](#ixfcell) 705 + +[KPIProp](#kpiprop) 705 + +[KPISets](#kpisets) 706 + +[LbsDropData](#lbsdropdata) 706 + +[LEMMode](#lemmode) 707 + +[LinePropertiesForShapePropsStreamChecksum](#linepropertiesforshapepropsstreamchecksum) 708 + +[List12BlockLevel](#list12blocklevel) 709 + +[List12DisplayName](#list12displayname) 711 + +[List12TableStyleClientInfo](#list12tablestyleclientinfo) 712 + +[ListParsedArrayFormula](#listparsedarrayformula) 788 + +[ListParsedFormula](#listparsedformula) 788 + +[LongRGB](#longrgb) 712 + +[LongRGBA](#longrgba) 713 + +[LPWideString](#lpwidestring) 713 + +[MDir](#mdir) 713 + +[MDTInfoIndex](#mdtinfoindex) 714 + +[MDXStrIndex](#mdxstrindex) 714 + +[MOper](#moper) 714 + +[NameParsedFormula](#nameparsedformula) 788 + +[NilChartNum](#nilchartnum) 715 + +[NoteRR](#noterr) 715 + +[NoteSh](#notesh) 716 + +[ObjectParsedFormula](#objectparsedformula) 789 + +ObjFmla ([section 2.5.187](#objfmla) 717, [section 2.5.188](#objid) 718) + +[ObjLinkFmla](#objlinkfmla) 718 + +[ODBCType](#odbctype) 719 + +[OfficeArtClientAnchorChart](#officeartclientanchorchart) 719 + +[OfficeArtClientAnchorHF](#officeartclientanchorhf) 720 + +[OfficeArtClientAnchorSheet](#officeartclientanchorsheet) 721 + +[OfficeArtClientData](#officeartclientdata) 722 + +[OfficeArtClientTextbox](#officeartclienttextbox) 723 + +[PaneType](#panetype) 723 + +[ParameterParsedFormula](#parameterparsedformula) 789 + +[PARAMQRY_Fixed](#paramqry_fixed) 724 + +[PBT](#pbt) 833 + +[PhRuns](#phruns) 834 + +[Phs](#phs) 834 + +[PictFmlaEmbedInfo](#pictfmlaembedinfo) 835 + +[PictFmlaKey](#pictfmlakey) 835 + +[PivotCompProp](#pivotcompprop) 836 + +[PivotParsedFormula](#pivotparsedformula) 790 + +[PositionMode](#positionmode) 836 + +[Ptg](#ptg) 790 + +[PtgAdd](#ptgadd) 793 + +[PtgArea](#ptgarea) 793 + +[PtgArea3d](#ptgarea3d) 794 + +[PtgAreaErr](#ptgareaerr) 794 + +[PtgAreaErr3d](#ptgareaerr3d) 795 + +[PtgAreaN](#ptgarean) 795 + +[PtgArray](#ptgarray) 796 + +[PtgAttrBaxcel](#ptgattrbaxcel) 796 + +[PtgAttrChoose](#ptgattrchoose) 797 + +[PtgAttrGoto](#ptgattrgoto) 797 + +[PtgAttrIf](#ptgattrif) 798 + +[PtgAttrSemi](#ptgattrsemi) 798 + +[PtgAttrSpace](#ptgattrspace) 798 + +[PtgAttrSpaceSemi](#ptgattrspacesemi) 799 + +[PtgAttrSpaceType](#ptgattrspacetype) 799 + +[PtgAttrSum](#ptgattrsum) 800 + +[PtgBool](#ptgbool) 800 + +[PtgConcat](#ptgconcat) 800 + +[PtgDataType](#ptgdatatype) 800 + +[PtgDiv](#ptgdiv) 801 + +[PtgElfCol](#ptgelfcol) 801 + +[PtgElfColS](#ptgelfcols) 801 + +[PtgElfColSV](#ptgelfcolsv) 802 + +[PtgElfColV](#ptgelfcolv) 802 + +[PtgElfLel](#ptgelflel) 802 + +[PtgElfRadical](#ptgelfradical) 803 + +[PtgElfRadicalLel](#ptgelfradicallel) 803 + +[PtgElfRadicalS](#ptgelfradicals) 804 + +[PtgElfRw](#ptgelfrw) 804 + +[PtgElfRwV](#ptgelfrwv) 805 + +[PtgEq](#ptgeq) 805 + +[PtgErr](#ptgerr) 805 + +[PtgExp](#ptgexp) 805 + +[PtgExtraArray](#ptgextraarray) 806 + +[PtgExtraElf](#ptgextraelf) 806 + +[PtgExtraMem](#ptgextramem) 807 + +[PtgFunc](#ptgfunc) 807 + +[PtgFuncVar](#ptgfuncvar) 807 + +[PtgGe](#ptgge) 808 + +[PtgGt](#ptggt) 808 + +[PtgInt](#ptgint) 808 + +[PtgIsect](#ptgisect) 809 + +[PtgLe](#ptgle) 809 + +[PtgLt](#ptglt) 809 + +[PtgMemArea](#ptgmemarea) 809 + +[PtgMemErr](#ptgmemerr) 810 + +[PtgMemFunc](#ptgmemfunc) 810 + +[PtgMemNoMem](#ptgmemnomem) 811 + +[PtgMissArg](#ptgmissarg) 811 + +[PtgMul](#ptgmul) 811 + +[PtgName](#ptgname) 812 + +[PtgNameX](#ptgnamex) 812 + +[PtgNe](#ptgne) 813 + +[PtgNum](#ptgnum) 813 + +[PtgParen](#ptgparen) 813 + +[PtgPercent](#ptgpercent) 814 + +[PtgPower](#ptgpower) 814 + +[PtgRange](#ptgrange) 814 + +[PtgRef](#ptgref) 814 + +[PtgRef3d](#ptgref3d) 815 + +[PtgRefErr](#ptgreferr) 815 + +[PtgRefErr3d](#ptgreferr3d) 816 + +[PtgRefN](#ptgrefn) 816 + +[PtgStr](#ptgstr) 816 + +[PtgSub](#ptgsub) 817 + +[PtgSxName](#ptgsxname) 817 + +[PtgTbl](#ptgtbl) 817 + +[PtgUminus](#ptguminus) 818 + +[PtgUnion](#ptgunion) 818 + +[PtgUplus](#ptguplus) 818 + +[ReadingOrder](#readingorder) 836 + +[record enumeration](#record-enumeration) 169 + +[Ref](#ref) 837 + +[Ref8](#ref8) 837 + +[Ref8U](#ref8u) 838 + +[Ref8U2007](#ref8u2007) 838 + +[RefU](#refu) 839 + +[RevExtern](#revextern) 819 + +[RevisionType](#revisiontype) 839 + +[RevItab](#revitab) 819 + +[RevLblName](#revlblname) 820 + +[RevName](#revname) 821 + +[RevNamePly](#revnameply) 822 + +[RevNameTabid](#revnametabid) 822 + +[RevSheetName](#revsheetname) 822 + +[RFX](#rfx) 840 + +[RgbExtra](#rgbextra) 823 + +[Rgce](#rgce) 824 + +[RgceArea](#rgcearea) 827 + +[RgceAreaRel](#rgcearearel) 828 + +[RgceElfLoc](#rgceelfloc) 828 + +[RgceElfLocExtra](#rgceelflocextra) 829 + +[RgceLoc](#rgceloc) 829 + +[RgceLoc8](#rgceloc8) 829 + +[RgceLocRel](#rgcelocrel) 829 + +[RichTextStreamChecksumData](#richtextstreamchecksumdata) 840 + +[RichTextStreamChecksumFontInformation](#richtextstreamchecksumfontinformation) 842 + +[RichTextStreamChecksumFontInformationArrayItem](#richtextstreamchecksumfontinformationarrayitem) 844 + +[RkNumber](#rknumber) 844 + +[RkRec](#rkrec) 845 + +[RPHSSub](#rphssub) 845 + +[RRD](#rrd) 846 + +[RRDDefNameFlags](#rrddefnameflags) 846 + +[RRLoc](#rrloc) 848 + +[RTDEItem](#rtdeitem) 848 + +[RTDOper](#rtdoper) 848 + +[RTDOperStr](#rtdoperstr) 849 + +[Run](#run) 849 + +[Rw](#rw) 849 + +[Rw12](#rw12) 850 + +[RwLongU](#rwlongu) 850 + +[RwU](#rwu) 850 + +[Rwx](#rwx) 850 + +[Script](#script) 851 + +[SD_SetSortOrder](#sd_setsortorder) 851 + +[SDContainer](#sdcontainer) 851 + +[SecurityDescriptor](#securitydescriptor) 852 + +[SerAr](#serar) 830 + +[SerBool](#serbool) 830 + +[SerErr](#sererr) 831 + +[SerNil](#sernil) 831 + +[SerNum](#sernum) 831 + +[SerStr](#serstr) 832 + +[ShapePropsStreamChecksumData](#shapepropsstreamchecksumdata) 852 + +[SharedFeatureType](#sharedfeaturetype) 853 + +[SharedParsedFormula](#sharedparsedformula) 832 + +[SheetExtOptional](#sheetextoptional) 854 + +[ShortDTR](#shortdtr) 855 + +[ShortXLUnicodeString](#shortxlunicodestring) 855 + +[SLCO8](#slco8) 856 + +[SortCond12](#sortcond12) 856 + +[SortItem](#sortitem) 857 + +[SourceType](#sourcetype) 858 + +[SQElfFlags](#sqelfflags) 858 + +[SqRef](#sqref) 858 + +[SqRefU](#sqrefu) 859 + +[Stxp](#stxp) 859 + +[StyleXF](#stylexf) 860 + +[SxAddl_SXDEnd](#sxaddl_sxdend) 862 + +[SxAddl_SXDVerUpdInv](#sxaddl_sxdverupdinv) 862 + +[SxAddl_SXString](#sxaddl_sxstring) 862 + +[SXAddlHdr](#sxaddlhdr) 863 + +[SXAxis](#sxaxis) 863 + +[SXEZDoper](#sxezdoper) 863 + +[SxFT](#sxft) 864 + +[SxIvdCol](#sxivdcol) 868 + +[SxIvdRw](#sxivdrw) 868 + +[SXLIItem](#sxliitem) 868 + +[SXPI_Item](#sxpi_item) 871 + +[SXVDEx_Opt](#sxvdex_opt) 871 + +[SxView9Save](#sxview9save) 872 + +[SXVIFlags](#sxviflags) 872 + +[TabId](#tabid) 873 + +[TabIndex](#tabindex) 873 + +[TableFeatureType](#tablefeaturetype) 873 + +[Tag_Fn_MDX](#tag_fn_mdx) 877 + +[TextPropsStreamChecksumData](#textpropsstreamchecksumdata) 878 + +[Top10FT](#top10ft) 880 + +[Ts](#ts) 880 + +[TxOLastRun](#txolastrun) 880 + +[TxORuns](#txoruns) 881 + +[TxtWf](#txtwf) 881 + +[Underline](#underline) 882 + +[VertAlign](#vertalign) 882 + +[VertBrk](#vertbrk) 882 + +[VirtualPath](#virtualpath) 882 + +[WebPubString](#webpubstring) 884 + +[XColorType](#xcolortype) 885 + +[XFExtGradient](#xfextgradient) 885 + +[XFExtNoFRT](#xfextnofrt) 886 + +[XFIndex](#xfindex) 886 + +[XFProp](#xfprop) 888 + +[XFPropBorder](#xfpropborder) 890 + +[XFPropColor](#xfpropcolor) 890 + +[XFPropGradient](#xfpropgradient) 891 + +[XFPropGradientStop](#xfpropgradientstop) 892 + +[XFProps](#xfprops) 892 + +[XFPropTextRotation](#xfproptextrotation) 893 + +[XLNameUnicodeString](#xlnameunicodestring) 893 + +[XlsFilter_Criteria](#xlsfilter_criteria) 894 + +[XlsFilter_Top10](#xlsfilter_top10) 895 + +[XLUnicodeRichExtendedString](#xlunicoderichextendedstring) 896 + +[XLUnicodeString](#xlunicodestring) 897 + +[XLUnicodeStringMin2](#xlunicodestringmin2) 898 + +[XLUnicodeStringNoCch](#xlunicodestringnocch) 898 + +[XLUnicodeStringSegmented](#xlunicodestringsegmented) 898 + +[XLUnicodeStringSegmentedRTD](#xlunicodestringsegmentedrtd) 899 + +[XLUnicodeStringSegmentedSXAddl](#xlunicodestringsegmentedsxaddl) 899 + +[XmlTkBackWallThicknessFrt](#xmltkbackwallthicknessfrt) 900 + +[XmlTkBaseTimeUnitFrt](#xmltkbasetimeunitfrt) 900 + +[XmlTkBlob](#xmltkblob) 901 + +[XmlTkBool](#xmltkbool) 901 + +[XmlTkChain](#xmltkchain) 902 + +[XmlTkColorMappingOverride](#xmltkcolormappingoverride) 904 + +[XmlTkDispBlanksAsFrt](#xmltkdispblanksasfrt) 904 + +[XmlTkDouble](#xmltkdouble) 905 + +[XmlTkDWord](#xmltkdword) 905 + +[XmlTkEnd](#xmltkend) 906 + +[XmlTkEndSurface](#xmltkendsurface) 906 + +[XmlTkFloorThicknessFrt](#xmltkfloorthicknessfrt) 906 + +[XmlTkFormatCodeFrt](#xmltkformatcodefrt) 907 + +[XmlTkHeader](#xmltkheader) 907 + +[XmlTkHeightPercent](#xmltkheightpercent) 907 + +[XmlTkLogBaseFrt](#xmltklogbasefrt) 908 + +[XmlTkMajorUnitFrt](#xmltkmajorunitfrt) 908 + +[XmlTkMajorUnitTypeFrt](#xmltkmajorunittypefrt) 908 + +[XmlTkMaxFrt](#xmltkmaxfrt) 909 + +[XmlTkMinFrt](#xmltkminfrt) 909 + +[XmlTkMinorUnitFrt](#xmltkminorunitfrt) 910 + +[XmlTkMinorUnitTypeFrt](#xmltkminorunittypefrt) 910 + +[XmlTkNoMultiLvlLbl](#xmltknomultilvllbl) 911 + +[XmlTkOverlay](#xmltkoverlay) 911 + +[XmlTkPerspectiveFrt](#xmltkperspectivefrt) 912 + +[XmlTkPieComboFrom12Frt](#xmltkpiecombofrom12frt) 912 + +[XmlTkRAngAxOffFrt](#xmltkrangaxofffrt) 912 + +[XmlTkRotXFrt](#xmltkrotxfrt) 913 + +[XmlTkRotYFrt](#xmltkrotyfrt) 913 + +[XmlTkShowDLblsOverMax](#xmltkshowdlblsovermax) 913 + +[XmlTkSpb](#xmltkspb) 914 + +[XmlTkStart](#xmltkstart) 914 + +[XmlTkStartSurface](#xmltkstartsurface) 914 + +[XmlTkString](#xmltkstring) 915 + +[XmlTkStyle](#xmltkstyle) 915 + +[XmlTkSymbolFrt](#xmltksymbolfrt) 915 + +[XmlTkThemeOverride](#xmltkthemeoverride) 916 + +[XmlTkTickLabelPositionFrt](#xmltkticklabelpositionfrt) 916 + +[XmlTkTickLabelSkipFrt](#xmltkticklabelskipfrt) 917 + +[XmlTkTickMarkSkipFrt](#xmltktickmarkskipfrt) 917 + +[XmlTkToken](#xmltktoken) 917 + +[XmlTkTpb](#xmltktpb) 918 + +[Xnum](#xnum) 918 + +[XORObfuscation](#xorobfuscation) 918 + +[XTI](#xti) 918 + +[XtiIndex](#xtiindex) 833 + +[Stxp](#stxp) 859 + +[Style](#style) 427 + +[StyleExt](#styleext) 428 + +[Styles](#styles) 158 + +[differential formatting (DXFs)](#differential-formatting-dxfs) 159 + +[format conflicts](#format-conflicts) 160 + +[table styles](#table-styles) 160 + +[XFs](#xfs) 158 + +[StyleXF](#stylexf) 860 + +[Substream](#substream) 57 + +[Summary information stream](#summary-information-stream-005summaryinformation) 67 + +[SupBook](#supbook) 429 + +[Supporting link](#supporting-link) 161 + +[Surf](#surf) 431 + +[SXAddl](#sxaddl) 432 + +SxAddl records ([section 2.4.273.29](#sxaddl_sxcfield12_sxdend) 444, [section 2.4.273.86](#sxaddl_sxcsxfilter12_sxdxlsfilter) 476) + +[Continue_SxaddlSxString](#continue_sxaddlsxstring) 432 + +[SXAddl](#sxaddl) 432 + +[SXAddl_SXCAutoSort_SXDEnd](#sxaddl_sxcautosort_sxdend) 433 + +[SXAddl_SXCAutoSort_SXDId](#sxaddl_sxcautosort_sxdid) 433 + +[SXAddl_SXCCache_SXDEnd](#sxaddl_sxccache_sxdend) 434 + +[SXAddl_SXCCache_SXDId](#sxaddl_sxccache_sxdid) 434 + +[SXAddl_SXCCache_SXDInfo12](#sxaddl_sxccache_sxdinfo12) 434 + +[SXAddl_SXCCache_SXDInvRefreshReal](#sxaddl_sxccache_sxdinvrefreshreal) 435 + +[SXAddl_SXCCache_SXDVer10Info](#sxaddl_sxccache_sxdver10info) 435 + +[SXAddl_SXCCache_SXDVerSXMacro](#sxaddl_sxccache_sxdversxmacro) 436 + +[SXAddl_SXCCache_SXDVerUpdInv](#sxaddl_sxccache_sxdverupdinv) 437 + +[SXAddl_SXCCacheField_SXDCaption](#sxaddl_sxccachefield_sxdcaption) 437 + +[SXAddl_SXCCacheField_SXDEnd](#sxaddl_sxccachefield_sxdend) 437 + +[SXAddl_SXCCacheField_SXDId](#sxaddl_sxccachefield_sxdid) 438 + +[SXAddl_SXCCacheField_SXDIfdbMempropMap](#sxaddl_sxccachefield_sxdifdbmempropmap) 438 + +[SXAddl_SXCCacheField_SXDIfdbMpMapCount](#sxaddl_sxccachefield_sxdifdbmpmapcount) 439 + +[SXAddl_SXCCacheField_SXDProperty](#sxaddl_sxccachefield_sxdproperty) 439 + +[SXAddl_SXCCacheField_SXDPropName](#sxaddl_sxccachefield_sxdpropname) 440 + +[SXAddl_SXCCacheField_SXDSxrmitmCount](#sxaddl_sxccachefield_sxdsxrmitmcount) 440 + +[SXAddl_SXCCacheItem_SXDEnd](#sxaddl_sxccacheitem_sxdend) 441 + +[SXAddl_SXCCacheItem_SXDId](#sxaddl_sxccacheitem_sxdid) 441 + +[SXAddl_SXCCacheItem_SXDItmMpMapCount](#sxaddl_sxccacheitem_sxditmmpmapcount) 441 + +[SXAddl_SXCCacheItem_SXDItmMpropMap](#sxaddl_sxccacheitem_sxditmmpropmap) 442 + +[SXAddl_SXCCacheItem_SXDSxrmitmDisp](#sxaddl_sxccacheitem_sxdsxrmitmdisp) 442 + +[SXAddl_SXCField_SXDEnd](#sxaddl_sxcfield_sxdend) 443 + +[SXAddl_SXCField_SXDId](#sxaddl_sxcfield_sxdid) 443 + +[SXAddl_SXCField_SXDVer10Info](#sxaddl_sxcfield_sxdver10info) 443 + +[SXAddl_SXCField12_SXDAutoshow](#sxaddl_sxcfield12_sxdautoshow) 444 + +[SXAddl_SXCField12_SXDId](#sxaddl_sxcfield12_sxdid) 445 + +[SXAddl_SXCField12_SXDISXTH](#sxaddl_sxcfield12_sxdisxth) 445 + +[SXAddl_SXCField12_SXDMemberCaption](#sxaddl_sxcfield12_sxdmembercaption) 446 + +[SXAddl_SXCField12_SXDVer12Info](#sxaddl_sxcfield12_sxdver12info) 446 + +[SXAddl_SXCField12_SXDVerUpdInv](#sxaddl_sxcfield12_sxdverupdinv) 447 + +[SXAddl_SXCGroup_SXDEnd](#sxaddl_sxcgroup_sxdend) 447 + +[SXAddl_SXCGroup_SXDGrpInfo](#sxaddl_sxcgroup_sxdgrpinfo) 448 + +[SXAddl_SXCGroup_SXDId](#sxaddl_sxcgroup_sxdid) 449 + +[SXAddl_SXCGroup_SXDMember](#sxaddl_sxcgroup_sxdmember) 449 + +[SXAddl_SXCGrpLevel_SXDEnd](#sxaddl_sxcgrplevel_sxdend) 450 + +[SXAddl_SXCGrpLevel_SXDGrpLevelInfo](#sxaddl_sxcgrplevel_sxdgrplevelinfo) 450 + +[SXAddl_SXCGrpLevel_SXDId](#sxaddl_sxcgrplevel_sxdid) 451 + +[SXAddl_SXCHierarchy_SXDDisplayFolder](#sxaddl_sxchierarchy_sxddisplayfolder) 451 + +[SXAddl_SXCHierarchy_SXDEnd](#sxaddl_sxchierarchy_sxdend) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember](#sxaddl_sxchierarchy_sxdfiltermember) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember12](#sxaddl_sxchierarchy_sxdfiltermember12) 453 + +[SXAddl_SXCHierarchy_SXDIconSet](#sxaddl_sxchierarchy_sxdiconset) 454 + +[SXAddl_SXCHierarchy_SXDId](#sxaddl_sxchierarchy_sxdid) 454 + +[SXAddl_SXCHierarchy_SXDInfo12](#sxaddl_sxchierarchy_sxdinfo12) 455 + +[SXAddl_SXCHierarchy_SXDKPIGoal](#sxaddl_sxchierarchy_sxdkpigoal) 456 + +[SXAddl_SXCHierarchy_SXDKPIStatus](#sxaddl_sxchierarchy_sxdkpistatus) 456 + +[SXAddl_SXCHierarchy_SXDKPITime](#sxaddl_sxchierarchy_sxdkpitime) 456 + +[SXAddl_SXCHierarchy_SXDKPITrend](#sxaddl_sxchierarchy_sxdkpitrend) 457 + +[SXAddl_SXCHierarchy_SXDKPIValue](#sxaddl_sxchierarchy_sxdkpivalue) 457 + +[SXAddl_SXCHierarchy_SXDKPIWeight](#sxaddl_sxchierarchy_sxdkpiweight) 458 + +[SXAddl_SXCHierarchy_SXDMeasureGrp](#sxaddl_sxchierarchy_sxdmeasuregrp) 458 + +[SXAddl_SXCHierarchy_SXDParentKPI](#sxaddl_sxchierarchy_sxdparentkpi) 459 + +[SXAddl_SXCHierarchy_SXDProperty](#sxaddl_sxchierarchy_sxdproperty) 459 + +[SXAddl_SXCHierarchy_SXDSXSetParentUnique](#sxaddl_sxchierarchy_sxdsxsetparentunique) 461 + +[SXAddl_SXCHierarchy_SXDUserCaption](#sxaddl_sxchierarchy_sxdusercaption) 461 + +[SXAddl_SXCHierarchy_SXDVerUpdInv](#sxaddl_sxchierarchy_sxdverupdinv) 461 + +[SXAddl_SXCQsi_SXDEnd](#sxaddl_sxcqsi_sxdend) 462 + +[SXAddl_SXCQsi_SXDId](#sxaddl_sxcqsi_sxdid) 462 + +[SXAddl_SXCQuery_SXDEnd](#sxaddl_sxcquery_sxdend) 462 + +[SXAddl_SXCQuery_SXDReconnCond](#sxaddl_sxcquery_sxdreconncond) 463 + +[SXAddl_SXCQuery_SXDSrcConnFile](#sxaddl_sxcquery_sxdsrcconnfile) 464 + +[SXAddl_SXCQuery_SXDSrcDataFile](#sxaddl_sxcquery_sxdsrcdatafile) 464 + +[SXAddl_SXCQuery_SXDXMLSource](#sxaddl_sxcquery_sxdxmlsource) 464 + +[SXAddl_SXCSXCondFmt_SXDEnd](#sxaddl_sxcsxcondfmt_sxdend) 465 + +[SXAddl_SXCSXCondFmt_SXDSXCondFmt](#sxaddl_sxcsxcondfmt_sxdsxcondfmt) 465 + +[SXAddl_SXCSXCondFmts_SXDEnd](#sxaddl_sxcsxcondfmts_sxdend) 466 + +[SXAddl_SXCSXCondFmts_SXDId](#sxaddl_sxcsxcondfmts_sxdid) 467 + +[SXAddl_SXCSXDH_SXDEnd](#sxaddl_sxcsxdh_sxdend) 467 + +[SXAddl_SXCSXDH_SXDId](#sxaddl_sxcsxdh_sxdid) 468 + +[SXAddl_SXCSXDH_SXDSxdh](#sxaddl_sxcsxdh_sxdsxdh) 468 + +[SXAddl_SXCSXfilt_SXDEnd](#sxaddl_sxcsxfilt_sxdend) 469 + +[SXAddl_SXCSXfilt_SXDId](#sxaddl_sxcsxfilt_sxdid) 470 + +[SXAddl_SXCSXfilt_SXDSXfilt](#sxaddl_sxcsxfilt_sxdsxfilt) 470 + +[SXAddl_SXCSXfilt_SXDSXItm](#sxaddl_sxcsxfilt_sxdsxitm) 471 + +[SXAddl_SXCSXFilter12_SXDCaption](#sxaddl_sxcsxfilter12_sxdcaption) 472 + +[SXAddl_SXCSXFilter12_SXDEnd](#sxaddl_sxcsxfilter12_sxdend) 473 + +[SXAddl_SXCSXFilter12_SXDId](#sxaddl_sxcsxfilter12_sxdid) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilter](#sxaddl_sxcsxfilter12_sxdsxfilter) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilterDesc](#sxaddl_sxcsxfilter12_sxdsxfilterdesc) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue1](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue2](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2) 475 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue1](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1) 476 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue2](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2) 477 + +[SXAddl_SXCSXFilters12_SXDEnd](#sxaddl_sxcsxfilters12_sxdend) 477 + +[SXAddl_SXCSXFilters12_SXDId](#sxaddl_sxcsxfilters12_sxdid) 478 + +[SXAddl_SXCSXMg_SXDEnd](#sxaddl_sxcsxmg_sxdend) 478 + +[SXAddl_SXCSXMg_SXDId](#sxaddl_sxcsxmg_sxdid) 478 + +[SXAddl_SXCSXMg_SXDUserCaption](#sxaddl_sxcsxmg_sxdusercaption) 479 + +[SXAddl_SXCSXMgs_SXDEnd](#sxaddl_sxcsxmgs_sxdend) 479 + +[SXAddl_SXCSXMgs_SXDId](#sxaddl_sxcsxmgs_sxdid) 479 + +[SXAddl_SXCSXMgs_SXDMGrpSXDHMap](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap) 480 + +[SXAddl_SXCSXrule_SXDEnd](#sxaddl_sxcsxrule_sxdend) 481 + +[SXAddl_SXCSXrule_SXDId](#sxaddl_sxcsxrule_sxdid) 481 + +[SXAddl_SXCSXrule_SXDSXrule](#sxaddl_sxcsxrule_sxdsxrule) 481 + +[SXAddl_SXCView_SXDCalcMember](#sxaddl_sxcview_sxdcalcmember) 484 + +[SXAddl_SXCView_SXDCalcMemString](#sxaddl_sxcview_sxdcalcmemstring) 486 + +[SXAddl_SXCView_SXDCompactColHdr](#sxaddl_sxcview_sxdcompactcolhdr) 486 + +[SXAddl_SXCView_SXDCompactRwHdr](#sxaddl_sxcview_sxdcompactrwhdr) 487 + +[SXAddl_SXCView_SXDEnd](#sxaddl_sxcview_sxdend) 487 + +[SXAddl_SXCView_SXDId](#sxaddl_sxcview_sxdid) 488 + +[SXAddl_SXCView_SXDSXPIIvmb](#sxaddl_sxcview_sxdsxpiivmb) 488 + +[SXAddl_SXCView_SXDTableStyleClient](#sxaddl_sxcview_sxdtablestyleclient) 489 + +[SXAddl_SXCView_SXDVer10Info](#sxaddl_sxcview_sxdver10info) 489 + +[SXAddl_SXCView_SXDVer12Info](#sxaddl_sxcview_sxdver12info) 491 + +[SXAddl_SXCView_SXDVerUpdInv](#sxaddl_sxcview_sxdverupdinv) 493 + +[SXAddl_SXCAutoSort_SXDEnd](#sxaddl_sxcautosort_sxdend) 433 + +[SXAddl_SXCAutoSort_SXDId](#sxaddl_sxcautosort_sxdid) 433 + +[SXAddl_SXCCache_SXDEnd](#sxaddl_sxccache_sxdend) 434 + +[SXAddl_SXCCache_SXDId](#sxaddl_sxccache_sxdid) 434 + +[SXAddl_SXCCache_SXDInfo12](#sxaddl_sxccache_sxdinfo12) 434 + +[SXAddl_SXCCache_SXDInvRefreshReal](#sxaddl_sxccache_sxdinvrefreshreal) 435 + +[SXAddl_SXCCache_SXDVer10Info](#sxaddl_sxccache_sxdver10info) 435 + +[SXAddl_SXCCache_SXDVerSXMacro](#sxaddl_sxccache_sxdversxmacro) 436 + +[SXAddl_SXCCache_SXDVerUpdInv](#sxaddl_sxccache_sxdverupdinv) 437 + +[SXAddl_SXCCacheField_SXDCaption](#sxaddl_sxccachefield_sxdcaption) 437 + +[SXAddl_SXCCacheField_SXDEnd](#sxaddl_sxccachefield_sxdend) 437 + +[SXAddl_SXCCacheField_SXDId](#sxaddl_sxccachefield_sxdid) 438 + +[SXAddl_SXCCacheField_SXDIfdbMempropMap](#sxaddl_sxccachefield_sxdifdbmempropmap) 438 + +[SXAddl_SXCCacheField_SXDIfdbMpMapCount](#sxaddl_sxccachefield_sxdifdbmpmapcount) 439 + +[SXAddl_SXCCacheField_SXDProperty](#sxaddl_sxccachefield_sxdproperty) 439 + +[SXAddl_SXCCacheField_SXDPropName](#sxaddl_sxccachefield_sxdpropname) 440 + +[SXAddl_SXCCacheField_SXDSxrmitmCount](#sxaddl_sxccachefield_sxdsxrmitmcount) 440 + +[SXAddl_SXCCacheItem_SXDEnd](#sxaddl_sxccacheitem_sxdend) 441 + +[SXAddl_SXCCacheItem_SXDId](#sxaddl_sxccacheitem_sxdid) 441 + +[SXAddl_SXCCacheItem_SXDItmMpMapCount](#sxaddl_sxccacheitem_sxditmmpmapcount) 441 + +[SXAddl_SXCCacheItem_SXDItmMpropMap](#sxaddl_sxccacheitem_sxditmmpropmap) 442 + +[SXAddl_SXCCacheItem_SXDSxrmitmDisp](#sxaddl_sxccacheitem_sxdsxrmitmdisp) 442 + +[SXAddl_SXCField_SXDEnd](#sxaddl_sxcfield_sxdend) 443 + +[SXAddl_SXCField_SXDId](#sxaddl_sxcfield_sxdid) 443 + +[SXAddl_SXCField_SXDVer10Info](#sxaddl_sxcfield_sxdver10info) 443 + +[SXAddl_SXCField12_SXDAutoshow](#sxaddl_sxcfield12_sxdautoshow) 444 + +[SXAddl_SXCField12_SXDEnd](#sxaddl_sxcfield12_sxdend) 444 + +[SXAddl_SXCField12_SXDId](#sxaddl_sxcfield12_sxdid) 445 + +[SXAddl_SXCField12_SXDISXTH](#sxaddl_sxcfield12_sxdisxth) 445 + +[SXAddl_SXCField12_SXDMemberCaption](#sxaddl_sxcfield12_sxdmembercaption) 446 + +[SXAddl_SXCField12_SXDVer12Info](#sxaddl_sxcfield12_sxdver12info) 446 + +[SXAddl_SXCField12_SXDVerUpdInv](#sxaddl_sxcfield12_sxdverupdinv) 447 + +[SXAddl_SXCGroup_SXDEnd](#sxaddl_sxcgroup_sxdend) 447 + +[SXAddl_SXCGroup_SXDGrpInfo](#sxaddl_sxcgroup_sxdgrpinfo) 448 + +[SXAddl_SXCGroup_SXDId](#sxaddl_sxcgroup_sxdid) 449 + +[SXAddl_SXCGroup_SXDMember](#sxaddl_sxcgroup_sxdmember) 449 + +[SXAddl_SXCGrpLevel_SXDEnd](#sxaddl_sxcgrplevel_sxdend) 450 + +[SXAddl_SXCGrpLevel_SXDGrpLevelInfo](#sxaddl_sxcgrplevel_sxdgrplevelinfo) 450 + +[SXAddl_SXCGrpLevel_SXDId](#sxaddl_sxcgrplevel_sxdid) 451 + +[SXAddl_SXCHierarchy_SXDDisplayFolder](#sxaddl_sxchierarchy_sxddisplayfolder) 451 + +[SXAddl_SXCHierarchy_SXDEnd](#sxaddl_sxchierarchy_sxdend) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember](#sxaddl_sxchierarchy_sxdfiltermember) 452 + +[SXAddl_SXCHierarchy_SXDFilterMember12](#sxaddl_sxchierarchy_sxdfiltermember12) 453 + +[SXAddl_SXCHierarchy_SXDIconSet](#sxaddl_sxchierarchy_sxdiconset) 454 + +[SXAddl_SXCHierarchy_SXDId](#sxaddl_sxchierarchy_sxdid) 454 + +[SXAddl_SXCHierarchy_SXDInfo12](#sxaddl_sxchierarchy_sxdinfo12) 455 + +[SXAddl_SXCHierarchy_SXDKPIGoal](#sxaddl_sxchierarchy_sxdkpigoal) 456 + +[SXAddl_SXCHierarchy_SXDKPIStatus](#sxaddl_sxchierarchy_sxdkpistatus) 456 + +[SXAddl_SXCHierarchy_SXDKPITime](#sxaddl_sxchierarchy_sxdkpitime) 456 + +[SXAddl_SXCHierarchy_SXDKPITrend](#sxaddl_sxchierarchy_sxdkpitrend) 457 + +[SXAddl_SXCHierarchy_SXDKPIValue](#sxaddl_sxchierarchy_sxdkpivalue) 457 + +[SXAddl_SXCHierarchy_SXDKPIWeight](#sxaddl_sxchierarchy_sxdkpiweight) 458 + +[SXAddl_SXCHierarchy_SXDMeasureGrp](#sxaddl_sxchierarchy_sxdmeasuregrp) 458 + +[SXAddl_SXCHierarchy_SXDParentKPI](#sxaddl_sxchierarchy_sxdparentkpi) 459 + +[SXAddl_SXCHierarchy_SXDProperty](#sxaddl_sxchierarchy_sxdproperty) 459 + +[SXAddl_SXCHierarchy_SXDSXSetParentUnique](#sxaddl_sxchierarchy_sxdsxsetparentunique) 461 + +[SXAddl_SXCHierarchy_SXDUserCaption](#sxaddl_sxchierarchy_sxdusercaption) 461 + +[SXAddl_SXCHierarchy_SXDVerUpdInv](#sxaddl_sxchierarchy_sxdverupdinv) 461 + +[SXAddl_SXCQsi_SXDEnd](#sxaddl_sxcqsi_sxdend) 462 + +[SXAddl_SXCQsi_SXDId](#sxaddl_sxcqsi_sxdid) 462 + +[SXAddl_SXCQuery_SXDEnd](#sxaddl_sxcquery_sxdend) 462 + +[SXAddl_SXCQuery_SXDReconnCond](#sxaddl_sxcquery_sxdreconncond) 463 + +[SXAddl_SXCQuery_SXDSrcConnFile](#sxaddl_sxcquery_sxdsrcconnfile) 464 + +[SXAddl_SXCQuery_SXDSrcDataFile](#sxaddl_sxcquery_sxdsrcdatafile) 464 + +[SXAddl_SXCQuery_SXDXMLSource](#sxaddl_sxcquery_sxdxmlsource) 464 + +[SXAddl_SXCSXCondFmt_SXDEnd](#sxaddl_sxcsxcondfmt_sxdend) 465 + +[SXAddl_SXCSXCondFmt_SXDSXCondFmt](#sxaddl_sxcsxcondfmt_sxdsxcondfmt) 465 + +[SXAddl_SXCSXCondFmts_SXDEnd](#sxaddl_sxcsxcondfmts_sxdend) 466 + +[SXAddl_SXCSXCondFmts_SXDId](#sxaddl_sxcsxcondfmts_sxdid) 467 + +[SXAddl_SXCSXDH_SXDEnd](#sxaddl_sxcsxdh_sxdend) 467 + +[SXAddl_SXCSXDH_SXDId](#sxaddl_sxcsxdh_sxdid) 468 + +[SXAddl_SXCSXDH_SXDSxdh](#sxaddl_sxcsxdh_sxdsxdh) 468 + +[SXAddl_SXCSXfilt_SXDEnd](#sxaddl_sxcsxfilt_sxdend) 469 + +[SXAddl_SXCSXfilt_SXDId](#sxaddl_sxcsxfilt_sxdid) 470 + +[SXAddl_SXCSXfilt_SXDSXfilt](#sxaddl_sxcsxfilt_sxdsxfilt) 470 + +[SXAddl_SXCSXfilt_SXDSXItm](#sxaddl_sxcsxfilt_sxdsxitm) 471 + +[SXAddl_SXCSXFilter12_SXDCaption](#sxaddl_sxcsxfilter12_sxdcaption) 472 + +[SXAddl_SXCSXFilter12_SXDEnd](#sxaddl_sxcsxfilter12_sxdend) 473 + +[SXAddl_SXCSXFilter12_SXDId](#sxaddl_sxcsxfilter12_sxdid) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilter](#sxaddl_sxcsxfilter12_sxdsxfilter) 473 + +[SXAddl_SXCSXFilter12_SXDSXFilterDesc](#sxaddl_sxcsxfilter12_sxdsxfilterdesc) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue1](#sxaddl_sxcsxfilter12_sxdsxfiltervalue1) 475 + +[SXAddl_SXCSXFilter12_SXDSXFilterValue2](#sxaddl_sxcsxfilter12_sxdsxfiltervalue2) 475 + +[SXAddl_SXCSXFilter12_SXDXlsFilter](#sxaddl_sxcsxfilter12_sxdxlsfilter) 476 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue1](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue1) 476 + +[SXAddl_SXCSXFilter12_SXDXlsFilterValue2](#sxaddl_sxcsxfilter12_sxdxlsfiltervalue2) 477 + +[SXAddl_SXCSXFilters12_SXDEnd](#sxaddl_sxcsxfilters12_sxdend) 477 + +[SXAddl_SXCSXFilters12_SXDId](#sxaddl_sxcsxfilters12_sxdid) 478 + +[SXAddl_SXCSXMg_SXDEnd](#sxaddl_sxcsxmg_sxdend) 478 + +[SXAddl_SXCSXMg_SXDId](#sxaddl_sxcsxmg_sxdid) 478 + +[SXAddl_SXCSXMg_SXDUserCaption](#sxaddl_sxcsxmg_sxdusercaption) 479 + +[SXAddl_SXCSXMgs_SXDEnd](#sxaddl_sxcsxmgs_sxdend) 479 + +[SXAddl_SXCSXMgs_SXDId](#sxaddl_sxcsxmgs_sxdid) 479 + +[SXAddl_SXCSXMgs_SXDMGrpSXDHMap](#sxaddl_sxcsxmgs_sxdmgrpsxdhmap) 480 + +[SXAddl_SXCSXrule_SXDEnd](#sxaddl_sxcsxrule_sxdend) 481 + +[SXAddl_SXCSXrule_SXDId](#sxaddl_sxcsxrule_sxdid) 481 + +[SXAddl_SXCSXrule_SXDSXrule](#sxaddl_sxcsxrule_sxdsxrule) 481 + +[SXAddl_SXCView_SXDCalcMember](#sxaddl_sxcview_sxdcalcmember) 484 + +[SXAddl_SXCView_SXDCalcMemString](#sxaddl_sxcview_sxdcalcmemstring) 486 + +[SXAddl_SXCView_SXDCompactColHdr](#sxaddl_sxcview_sxdcompactcolhdr) 486 + +[SXAddl_SXCView_SXDCompactRwHdr](#sxaddl_sxcview_sxdcompactrwhdr) 487 + +[SXAddl_SXCView_SXDEnd](#sxaddl_sxcview_sxdend) 487 + +[SXAddl_SXCView_SXDId](#sxaddl_sxcview_sxdid) 488 + +[SXAddl_SXCView_SXDSXPIIvmb](#sxaddl_sxcview_sxdsxpiivmb) 488 + +[SXAddl_SXCView_SXDTableStyleClient](#sxaddl_sxcview_sxdtablestyleclient) 489 + +[SXAddl_SXCView_SXDVer10Info](#sxaddl_sxcview_sxdver10info) 489 + +[SXAddl_SXCView_SXDVer12Info](#sxaddl_sxcview_sxdver12info) 491 + +[SXAddl_SXCView_SXDVerUpdInv](#sxaddl_sxcview_sxdverupdinv) 493 + +[SxAddl_SXDEnd](#sxaddl_sxdend) 862 + +[SxAddl_SXDVerUpdInv](#sxaddl_sxdverupdinv) 862 + +[SxAddl_SXString](#sxaddl_sxstring) 862 + +[SXAddlHdr](#sxaddlhdr) 863 + +[SXAxis](#sxaxis) 863 + +[SxBool](#sxbool) 494 + +[SXDB](#sxdb) 494 + +[SXDBB](#sxdbb) 495 + +[SXDBEx](#sxdbex) 495 + +[SXDI](#sxdi) 496 + +[SXDtr](#sxdtr) 498 + +[SxDXF](#sxdxf) 498 + +[SxErr](#sxerr) 499 + +[SXEx](#sxex) 499 + +[SXEZDoper](#sxezdoper) 863 + +[SXFDB](#sxfdb) 502 + +[SXFDBType](#sxfdbtype) 505 + +[SxFilt](#sxfilt) 505 + +[SxFmla](#sxfmla) 506 + +[SxFormat](#sxformat) 507 + +[SxFormula](#sxformula) 507 + +[SxFT](#sxft) 864 + +[SxInt](#sxint) 507 + +[SxIsxoper](#sxisxoper) 508 + +[SxItm](#sxitm) 508 + +[SxIvd](#sxivd) 509 + +[SxIvdCol](#sxivdcol) 868 + +[SxIvdRw](#sxivdrw) 868 + +[SXLI](#sxli) 510 + +[SXLIItem](#sxliitem) 868 + +[SxName](#sxname) 510 + +[SxNil](#sxnil) 511 + +[SXNum](#sxnum) 511 + +[SXPair](#sxpair) 511 + +[SXPI](#sxpi) 512 + +[SXPI_Item](#sxpi_item) 871 + +[SXPIEx](#sxpiex) 513 + +[SXRng](#sxrng) 513 + +[SxRule](#sxrule) 515 + +[SxSelect](#sxselect) 517 + +[SXStreamID](#sxstreamid) 519 + +[SXString](#sxstring) 519 + +[SXTbl](#sxtbl) 519 + +[SxTbpg](#sxtbpg) 520 + +[SXTBRGIITM](#sxtbrgiitm) 521 + +[SXTH](#sxth) 521 + +[Sxvd](#sxvd) 524 + +[SXVDEx](#sxvdex) 528 + +[SXVDEx_Opt](#sxvdex_opt) 871 + +[SXVDTEx](#sxvdtex) 531 + +[SXVI](#sxvi) 532 + +[SxView](#sxview) 534 + +[SxView9Save](#sxview9save) 872 + +[SxViewEx](#sxviewex) 536 + +[SxViewEx9](#sxviewex9) 537 + +[SxViewLink](#sxviewlink) 538 + +[SXVIFlags](#sxviflags) 872 + +[SXVS](#sxvs) 539 + +[Sync](#sync) 539 + +T + +[TabId](#tabid) 873 + +[TabIndex](#tabindex) 873 + +[Table](#table) 539 + +[Table example](#table-1) 937 + +[Table styles](#table-styles) 160 + +[Table: Feathdr11 example](#table-feathdr11) 937 + +[Table: Feature11 example](#table-feature11) 938 + +[TableFeatureType](#tablefeaturetype) 873 + +[TableStyle](#tablestyle) 541 + +[TableStyleElement](#tablestyleelement) 542 + +[TableStyles](#tablestyles) 545 + +[Tag_Fn_MDX](#tag_fn_mdx) 877 + +[TBC](#tbc) 922 + +[TBCCmd](#tbccmd) 923 + +[Template](#template) 546 + +[Text](#text) 546 + +[Text import connections](#text-import-connections) 164 + +[TextPropsStream](#textpropsstream) 551 + +[TextPropsStreamChecksumData](#textpropsstreamchecksumdata) 878 + +[Theme](#theme) 553 + +[Tick](#tick) 553 + +Tokens + +[control](#control-tokens) 83 + +[display](#display-tokens) 83 + +[mem](#mem-tokens) 83 + +[operand](#operand-tokens) 82 + +[operator](#operator-tokens) 82 + +[Top10FT](#top10ft) 880 + +[TopMargin](#topmargin) 556 + +[Tracking changes](#change-tracking) 1096 + +[Trendline](#trendline) 101 + +[Ts](#ts) 880 + +[TxO](#txo) 557 + +[TxOLastRun](#txolastrun) 880 + +[TxORuns](#txoruns) 881 + +[TxtQry](#txtqry) 559 + +[TxtWf](#txtwf) 881 + +U + +[Uncalced](#uncalced) 561 + +[Underline](#underline) 882 + +[Units](#units) 561 + +[User log](#user-log) 168 + +[User names stream](#user-names-stream-user-names) 68 + +[UserBView](#userbview) 561 + +[UserSViewBegin](#usersviewbegin) 565 + +[UserSViewBegin_Chart](#usersviewbegin_chart) 568 + +[UserSViewEnd](#usersviewend) 570 + +[UsesELFs](#useselfs) 570 + +[UsrChk](#usrchk) 570 + +[UsrExcl](#usrexcl) 571 + +[UsrInfo](#usrinfo) 572 + +V + +[Value metadata](#value-metadata) 105 + +[ValueRange](#valuerange) 572 + +[VBA storage](#vba-storage-_vba_project_cur) 68 + +[VCenter](#vcenter) 575 + +[Vendor-extensible fields](#vendor-extensible-fields) 56 + +[Versioning](#versioning-and-localization) 55 + +[VertAlign](#vertalign) 882 + +[VertBrk](#vertbrk) 882 + +[VerticalPageBreaks](#verticalpagebreaks) 575 + +[Viewer content stream](#viewer-content-stream-009drmviewercontent) 68 + +[VirtualPath](#virtualpath) 882 + +W + +[Web connections](#web-connections) 164 + +[WebPub](#webpub) 575 + +[WebPubString](#webpubstring) 884 + +[Window1](#window1) 578 + +[Window2](#window2) 579 + +[WinProtect](#winprotect) 581 + +[WOpt](#wopt) 582 + +[Workbook example](#workbook) 996 + +[Workbook stream](#workbook-stream-workbook) 68 + +[Workbook: BOF 1 example](#workbook-bof-1) 997 + +[Workbook: BookBool example](#workbook-bookbool) 1001 + +[Workbook: BookExt example](#workbook-bookext) 1010 + +[Workbook: BoundSheet8 1 example](#workbook-boundsheet8-1) 1007 + +[Workbook: BoundSheet8 2 example](#workbook-boundsheet8-2) 1007 + +[Workbook: BoundSheet8 3 example](#workbook-boundsheet8-3) 1008 + +[Workbook: BuiltInFnGroupCount example](#workbook-builtinfngroupcount) 999 + +[Workbook: CalcPrecision example](#workbook-calcprecision) 1001 + +[Workbook: Country example](#workbook-country) 1008 + +[Workbook: Date1904 example](#workbook-date1904) 1001 + +[Workbook: DBCell example](#workbook-dbcell) 1027 + +[Workbook: DefaultRowHeight example](#workbook-defaultrowheight) 1014 + +[Workbook: DefColWidth example](#workbook-defcolwidth) 1017 + +[Workbook: Dimensions example](#workbook-dimensions) 1017 + +[Workbook: EOF 1 example](#workbook-eof-1) 1012 + +Workbook: EOF 2 example ([section 3.9.22](#workbook-bof-2) 1012, [section 3.9.41](#workbook-eof-2) 1031) + +[Workbook: ExtSST example](#workbook-extsst) 1009 + +[Workbook: Font example](#workbook-font) 1002 + +[Workbook: Format example](#workbook-format) 1003 + +[Workbook: Formula example](#workbook-formula) 1024 + +[Workbook: HideObj example](#workbook-hideobj) 1001 + +[Workbook: Index example](#workbook-index) 1013 + +[Workbook: LabelSst 1 example](#workbook-labelsst-1) 1021 + +[Workbook: LabelSst 2 example](#workbook-labelsst-2) 1023 + +[Workbook: PhoneticInfo example](#workbook-phoneticinfo) 1030 + +[Workbook: RecalcId example](#workbook-recalcid) 1009 + +[Workbook: RK example](#workbook-rk) 1022 + +[Workbook: Row 1 example](#workbook-row-1) 1018 + +[Workbook: Row 2 example](#workbook-row-2) 1019 + +[Workbook: Row 3 example](#workbook-row-3) 1020 + +[Workbook: Row 4 example](#workbook-row-4) 1020 + +[Workbook: RRTabId example](#workbook-rrtabid) 998 + +[Workbook: Selection example](#workbook-selection) 1029 + +[Workbook: Setup example](#workbook-setup) 1015 + +[Workbook: SST example](#workbook-sst) 1009 + +[Workbook: Style example](#workbook-style) 1006 + +[Workbook: Window1 example](#workbook-window1) 999 + +[Workbook: Window2 example](#workbook-window2) 1027 + +[Workbook: WsBool example](#workbook-wsbool) 1014 + +[Workbook: XF example](#workbook-xf) 1004 + +[WriteAccess](#writeaccess) 583 + +[WriteProtect](#writeprotect) 584 + +[WsBool](#wsbool) 584 + +X + +XCB structures + +[CTB](#ctb) 921 + +[CTBS](#ctbs) 920 + +[CTBWRAPPER](#ctbwrapper) 920 + +[TBC](#tbc) 922 + +[TBCCmd](#tbccmd) 923 + +[XColorType](#xcolortype) 885 + +[XCT](#xct) 585 + +[XF](#xf) 585 + +[XFCRC](#xfcrc) 586 + +[XFExt](#xfext) 586 + +[XFExtGradient](#xfextgradient) 885 + +[XFExtNoFRT](#xfextnofrt) 886 + +[XFIndex](#xfindex) 886 + +[XFProp](#xfprop) 888 + +[XFPropBorder](#xfpropborder) 890 + +[XFPropColor](#xfpropcolor) 890 + +[XFPropGradient](#xfpropgradient) 891 + +[XFPropGradientStop](#xfpropgradientstop) 892 + +[XFProps](#xfprops) 892 + +[XFPropTextRotation](#xfproptextrotation) 893 + +[XFs](#xfs) 158 + +[XLNameUnicodeString](#xlnameunicodestring) 893 + +[XlsFilter_Criteria](#xlsfilter_criteria) 894 + +[XlsFilter_Top10](#xlsfilter_top10) 895 + +[XLUnicodeRichExtendedString](#xlunicoderichextendedstring) 896 + +[XLUnicodeString](#xlunicodestring) 897 + +[XLUnicodeStringMin2](#xlunicodestringmin2) 898 + +[XLUnicodeStringNoCch](#xlunicodestringnocch) 898 + +[XLUnicodeStringSegmented](#xlunicodestringsegmented) 898 + +[XLUnicodeStringSegmentedRTD](#xlunicodestringsegmentedrtd) 899 + +[XLUnicodeStringSegmentedSXAddl](#xlunicodestringsegmentedsxaddl) 899 + +[XML signatures storage](#xml-signatures-storage-_xmlsignatures) 76 + +[XML stream](#xml-stream-xml) 76 + +[XmlTkBackWallThicknessFrt](#xmltkbackwallthicknessfrt) 900 + +[XmlTkBaseTimeUnitFrt](#xmltkbasetimeunitfrt) 900 + +[XmlTkBlob](#xmltkblob) 901 + +[XmlTkBool](#xmltkbool) 901 + +[XmlTkChain](#xmltkchain) 902 + +[XmlTkColorMappingOverride](#xmltkcolormappingoverride) 904 + +[XmlTkDispBlanksAsFrt](#xmltkdispblanksasfrt) 904 + +[XmlTkDouble](#xmltkdouble) 905 + +[XmlTkDWord](#xmltkdword) 905 + +[XmlTkEnd](#xmltkend) 906 + +[XmlTkEndSurface](#xmltkendsurface) 906 + +[XmlTkFloorThicknessFrt](#xmltkfloorthicknessfrt) 906 + +[XmlTkFormatCodeFrt](#xmltkformatcodefrt) 907 + +[XmlTkHeader](#xmltkheader) 907 + +[XmlTkHeightPercent](#xmltkheightpercent) 907 + +[XmlTkLogBaseFrt](#xmltklogbasefrt) 908 + +[XmlTkMajorUnitFrt](#xmltkmajorunitfrt) 908 + +[XmlTkMajorUnitTypeFrt](#xmltkmajorunittypefrt) 908 + +[XmlTkMaxFrt](#xmltkmaxfrt) 909 + +[XmlTkMinFrt](#xmltkminfrt) 909 + +[XmlTkMinorUnitFrt](#xmltkminorunitfrt) 910 + +[XmlTkMinorUnitTypeFrt](#xmltkminorunittypefrt) 910 + +[XmlTkNoMultiLvlLbl](#xmltknomultilvllbl) 911 + +[XmlTkOverlay](#xmltkoverlay) 911 + +[XmlTkPerspectiveFrt](#xmltkperspectivefrt) 912 + +[XmlTkPieComboFrom12Frt](#xmltkpiecombofrom12frt) 912 + +[XmlTkRAngAxOffFrt](#xmltkrangaxofffrt) 912 + +[XmlTkRotXFrt](#xmltkrotxfrt) 913 + +[XmlTkRotYFrt](#xmltkrotyfrt) 913 + +[XmlTkShowDLblsOverMax](#xmltkshowdlblsovermax) 913 + +[XmlTkSpb](#xmltkspb) 914 + +[XmlTkStart](#xmltkstart) 914 + +[XmlTkStartSurface](#xmltkstartsurface) 914 + +[XmlTkString](#xmltkstring) 915 + +[XmlTkStyle](#xmltkstyle) 915 + +[XmlTkSymbolFrt](#xmltksymbolfrt) 915 + +[XmlTkThemeOverride](#xmltkthemeoverride) 916 + +[XmlTkTickLabelPositionFrt](#xmltkticklabelpositionfrt) 916 + +[XmlTkTickLabelSkipFrt](#xmltkticklabelskipfrt) 917 + +[XmlTkTickMarkSkipFrt](#xmltktickmarkskipfrt) 917 + +[XmlTkToken](#xmltktoken) 917 + +[XmlTkTpb](#xmltktpb) 918 + +[Xnum](#xnum) 918 + +[XORObfuscation](#xorobfuscation) 918 + +[XTI](#xti) 918 + +[XtiIndex](#xtiindex) 833 + +Y + +[YMult](#ymult) 587 diff --git a/docs/standards/xlsx/README.md b/docs/standards/xlsx/README.md new file mode 100644 index 0000000..bba0709 --- /dev/null +++ b/docs/standards/xlsx/README.md @@ -0,0 +1,32 @@ +# Нормативная документация формата .xlsx (Excel OOXML) + +Справочный комплект формата .xlsx: база — ECMA-376 Part 1 §18 SpreadsheetML (лежит в `../ooxml/`), расширения Excel — [MS-XLSX] (здесь). В конвертере поддержки .xlsx нет — комплект справочный (вход конвертера: `.docx`/`.doc`). Документация OOXML и XSD — `../ooxml/README.md`, бинарный .xls — `../xls/README.md`, общее OLE2-окружение — `../binary/README.md`. + +SHA-256 `.md`-файлов — справочные: они производные от инструментов извлечения (pandoc), при регенерации другим инструментом могут измениться; первичен docx в таблице «Источники». + +### Источники + +|Файл|Документ|Редакция/дата|URL|SHA-256| +|---|---|---|---|---| +|`ms-xlsx.md`|[MS-XLSX] «Excel (.xlsx) Extensions to the Office Open XML SpreadsheetML File Format» — расширения Excel к SpreadsheetML (Excel-namespace `…/office/excel/2006/main`, slicers/timelines/data model, metadata)|30.0 (261016, октябрь 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-XLSX/%5bMS-XLSX%5d-261016.docx|`98542cb9a3037734cede02dcc1f333061297eaf85e7fa8f6f01f51b21f50d226`| +|`ms-xlsx.docx`|Оригинальный dated-.docx [MS-XLSX] 30.0 (первичный источник `.md`-конверта)|30.0 (261016)|тот же URL, что `ms-xlsx.md`|`239652cea96fbae721fbbdedf2758b0a13b797136b41731241d023e848b7867c`| + +Конверт сделан `-t gfm` (raw_html включён): packet diagram'ов в документе нет (XML-расширения), все таблицы сохранены без `[TABLE]`-плейсхолдеров — отдельный «full»-файл не нужен. + +### Что где искать + +- **Разметка .xlsx (база)** — ECMA-376 §18 в `../ooxml/ecma376-part1-5th.md`: §18.2 Workbook (`workbook.xml`), §18.3 Worksheet (`xl/worksheets/sheet*.xml`, ран-ячейки `is` §18.3.1.53), §18.4 Styles, §18.5 Shared String Table, §18.6 Drawings; схемы — `../ooxml/schema/transitional/sml.xsd`, `dml-spreadsheetDrawing.xsd`. Поиск: `grep -n "^18\.3\.1" ../ooxml/ecma376-part1-5th.md`. +- **Расширения Excel ([MS-XLSX])** — `ms-xlsx.md`: §2.1 Part Enumerations (какие части бывают: slicers, timelines, customXml, metadata…), §2.2 Extensions (элементы/атрибуты Excel-namespace по частям), §2.3 Conceptual Overview (slicer/data model/timeline-семантика), §2.4 Global Elements / §2.5 Global Attributes / §2.6 Complex Types / §2.7 Simple Types (полные определения), §3 Structure Examples (например Slicer); полные XSD расширений — Appendix A («Full XML Schema» — по namespace: `…/excel/2006/main`, `…/drawing/2010/slicer`, `…/spreadsheetml/2010/11/main`…). +- **Поведение Excel (что он реально пишет)** — `../ooxml/ms-oi29500.md` (комментарии и к SpreadsheetML в т.ч.); расширения чартов/рисунков — `../ooxml/ms-odrawxml.md`. +- **Поиск по номерам секций** — по строкам оглавления вида `[2.2 Extensions …]`: `grep -n "^\[2\.2 " ms-xlsx.md`. + +### Регенерация + +```bash +# ms-xlsx.md — свежий dated-.docx [MS-XLSX] с лендинга +# https://learn.microsoft.com/en-us/openspecs/office_standards/ms-xlsx/2c5dee00-eff2-4b22-92b6-0738acd4475e +curl -sSL -o /tmp/msxlsx.docx "https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-XLSX/%5bMS-XLSX%5d-261016.docx" +pandoc /tmp/msxlsx.docx -t gfm --wrap=none -o docs/standards/xlsx/ms-xlsx.md + +# Обновлённый dated-.docx при этом перекладывается в ms-xlsx.docx (первичный источник). +``` diff --git a/docs/standards/xlsx/ms-xlsx.docx b/docs/standards/xlsx/ms-xlsx.docx new file mode 100644 index 0000000..275067f Binary files /dev/null and b/docs/standards/xlsx/ms-xlsx.docx differ diff --git a/docs/standards/xlsx/ms-xlsx.md b/docs/standards/xlsx/ms-xlsx.md new file mode 100644 index 0000000..f167ada --- /dev/null +++ b/docs/standards/xlsx/ms-xlsx.md @@ -0,0 +1,27460 @@ +**\[MS-XLSX\]:** + +**Excel (.xlsx) Extensions to the Office Open XML SpreadsheetML File Format** + +Intellectual Property Rights Notice for Open Specifications Documentation + +- **Technical Documentation.** Microsoft publishes Open Specifications documentation (“this documentation”) for protocols, file formats, data portability, computer languages, and standards support. Additionally, overview documents cover inter-protocol relationships and interactions. + +- **Copyrights**. This documentation is covered by Microsoft copyrights. Regardless of any other terms that are contained in the terms of use for the Microsoft website that hosts this documentation, you can make copies of it in order to develop implementations of the technologies that are described in this documentation and can distribute portions of it in your implementations that use these technologies or in your documentation as necessary to properly document the implementation. You can also distribute in your implementation, with or without modification, any schemas, IDLs, or code samples that are included in the documentation. This permission also applies to any documents that are referenced in the Open Specifications documentation. + +- **No Trade Secrets**. Microsoft does not claim any trade secret rights in this documentation. + +- **Patents**. Microsoft has patents that might cover your implementations of the technologies described in the Open Specifications documentation. Neither this notice nor Microsoft's delivery of this documentation grants any licenses under those patents or any other Microsoft patents. However, a given Open Specifications document might be covered by the Microsoft [Open Specifications Promise](https://go.microsoft.com/fwlink/?LinkId=214445) or the [Microsoft Community Promise](https://go.microsoft.com/fwlink/?LinkId=214448). If you would prefer a written license, or if the technologies described in this documentation are not covered by the Open Specifications Promise or Community Promise, as applicable, patent licenses are available by contacting . + +- **License Programs**. To see all of the protocols in scope under a specific license program and the associated patents, visit the [Patent Map](https://aka.ms/AA9ufj8). + +- **Trademarks**. The names of companies and products contained in this documentation might be covered by trademarks or similar intellectual property rights. This notice does not grant any licenses under those rights. For a list of Microsoft trademarks, visit [www.microsoft.com/trademarks](https://www.microsoft.com/trademarks). + +- **Fictitious Names**. The example companies, organizations, products, domain names, email addresses, logos, people, places, and events that are depicted in this documentation are fictitious. No association with any real company, organization, product, domain name, email address, logo, person, place, or event is intended or should be inferred. + +**Reservation of Rights**. All other rights are reserved, and this notice does not grant any rights other than as specifically described above, whether by implication, estoppel, or otherwise. + +**Tools**. The Open Specifications documentation does not require the use of Microsoft programming tools or programming environments in order for you to develop an implementation. If you have access to Microsoft programming tools and environments, you are free to take advantage of them. Certain Open Specifications documents are intended for use in conjunction with publicly available standards specifications and network programming art and, as such, assume that the reader either is familiar with the aforementioned material or has immediate access to it. + +**Support.** For questions and support, please contact . + +**Revision Summary** + +| Date | Revision History | Revision Class | Comments | +|----|----|----|----| +| 7/13/2009 | 0.1 | Major | Initial Availability | +| 8/28/2009 | 0.2 | Editorial | Revised and edited the technical content | +| 11/6/2009 | 0.3 | Editorial | Revised and edited the technical content | +| 2/19/2010 | 1.0 | Major | Updated and revised the technical content | +| 3/31/2010 | 1.01 | Editorial | Revised and edited the technical content | +| 4/30/2010 | 1.02 | Editorial | Revised and edited the technical content | +| 6/7/2010 | 1.03 | Editorial | Revised and edited the technical content | +| 6/29/2010 | 1.04 | Editorial | Changed language and formatting in the technical content. | +| 7/23/2010 | 1.04 | None | No changes to the meaning, language, or formatting of the technical content. | +| 9/27/2010 | 1.04 | None | No changes to the meaning, language, or formatting of the technical content. | +| 11/15/2010 | 1.04 | None | No changes to the meaning, language, or formatting of the technical content. | +| 12/17/2010 | 1.04 | None | No changes to the meaning, language, or formatting of the technical content. | +| 3/18/2011 | 1.5 | Minor | Clarified the meaning of the technical content. | +| 6/10/2011 | 1.5 | None | No changes to the meaning, language, or formatting of the technical content. | +| 1/20/2012 | 2.0 | Major | Significantly changed the technical content. | +| 4/11/2012 | 2.0 | None | No changes to the meaning, language, or formatting of the technical content. | +| 7/16/2012 | 3.0 | Major | Significantly changed the technical content. | +| 10/8/2012 | 4.0 | Major | Significantly changed the technical content. | +| 2/11/2013 | 4.1 | Minor | Clarified the meaning of the technical content. | +| 7/30/2013 | 4.1 | None | No changes to the meaning, language, or formatting of the technical content. | +| 11/18/2013 | 4.2 | Minor | Clarified the meaning of the technical content. | +| 2/10/2014 | 4.2 | None | No changes to the meaning, language, or formatting of the technical content. | +| 4/30/2014 | 4.3 | Minor | Clarified the meaning of the technical content. | +| 7/31/2014 | 5.0 | Major | Significantly changed the technical content. | +| 10/30/2014 | 5.1 | Minor | Clarified the meaning of the technical content. | +| 3/16/2015 | 6.0 | Major | Significantly changed the technical content. | +| 9/4/2015 | 7.0 | Major | Significantly changed the technical content. | +| 9/29/2016 | 7.1 | Minor | Clarified the meaning of the technical content. | +| 11/14/2016 | 7.1 | None | No changes to the meaning, language, or formatting of the technical content. | +| 1/18/2017 | 8.0 | Major | Significantly changed the technical content. | +| 6/20/2017 | 8.0 | None | No changes to the meaning, language, or formatting of the technical content. | +| 12/12/2017 | 9.0 | Major | Significantly changed the technical content. | +| 4/27/2018 | 10.0 | Major | Significantly changed the technical content. | +| 5/9/2018 | 11.0 | Major | Significantly changed the technical content. | +| 6/8/2018 | 12.0 | Major | Significantly changed the technical content. | +| 8/1/2018 | 13.0 | Major | Significantly changed the technical content. | +| 8/28/2018 | 14.0 | Major | Significantly changed the technical content. | +| 10/10/2018 | 15.0 | Major | Significantly changed the technical content. | +| 12/11/2018 | 16.0 | Major | Significantly changed the technical content. | +| 1/11/2019 | 17.0 | Major | Significantly changed the technical content. | +| 3/19/2019 | 17.1 | Minor | Clarified the meaning of the technical content. | +| 11/19/2019 | 18.0 | Major | Significantly changed the technical content. | +| 2/19/2020 | 19.0 | Major | Significantly changed the technical content. | +| 10/15/2020 | 20.0 | Major | Significantly changed the technical content. | +| 4/22/2021 | 21.0 | Major | Significantly changed the technical content. | +| 8/17/2021 | 22.0 | Major | Significantly changed the technical content. | +| 11/16/2021 | 23.0 | Major | Significantly changed the technical content. | +| 2/15/2022 | 23.0 | None | No changes to the meaning, language, or formatting of the technical content. | +| 5/17/2022 | 23.1 | Minor | Clarified the meaning of the technical content. | +| 8/16/2022 | 23.2 | Minor | Clarified the meaning of the technical content. | +| 11/15/2022 | 23.3 | Minor | Clarified the meaning of the technical content. | +| 6/16/2023 | 23.4 | Minor | Clarified the meaning of the technical content. | +| 2/20/2024 | 24.0 | Major | Significantly changed the technical content. | +| 4/16/2024 | 25.0 | Major | Significantly changed the technical content. | +| 8/20/2024 | 26.0 | Major | Significantly changed the technical content. | +| 11/12/2024 | 26.1 | Minor | Clarified the meaning of the technical content. | +| 2/18/2025 | 27.0 | Major | Significantly changed the technical content. | +| 4/4/2025 | 28.0 | Major | Significantly changed the technical content. | +| 5/20/2025 | 28.1 | Minor | Clarified the meaning of the technical content. | +| 8/19/2025 | 28.2 | Minor | Clarified the meaning of the technical content. | +| 9/16/2025 | 29.0 | Major | Significantly changed the technical content. | +| 5/19/2026 | 29.1 | Minor | Clarified the meaning of the technical content. | +| 10/16/2026 | 30.0 | Major | Significantly changed the technical content. | + +Table of Contents + +[1 Introduction [17](#introduction)](#introduction) + +[1.1 Glossary [17](#glossary)](#glossary) + +[1.2 References [24](#references)](#references) + +[1.2.1 Normative References [24](#normative-references)](#normative-references) + +[1.2.2 Informative References [25](#informative-references)](#informative-references) + +[1.3 Structure Overview (Synopsis) [25](#structure-overview-synopsis)](#structure-overview-synopsis) + +[1.4 Relationship to Protocols and Other Structures [26](#relationship-to-protocols-and-other-structures)](#relationship-to-protocols-and-other-structures) + +[1.5 Applicability Statement [26](#applicability-statement)](#applicability-statement) + +[1.6 Versioning and Localization [26](#versioning-and-localization)](#versioning-and-localization) + +[1.7 Vendor-Extensible Fields [26](#vendor-extensible-fields)](#vendor-extensible-fields) + +[2 Structures [28](#structures)](#structures) + +[2.1 Part Enumerations [28](#part-enumerations)](#part-enumerations) + +[2.1.1 Control Properties [28](#control-properties)](#control-properties) + +[2.1.2 Custom Data [28](#custom-data)](#custom-data) + +[2.1.3 Custom Data Properties [29](#custom-data-properties)](#custom-data-properties) + +[2.1.4 Slicer Cache [29](#slicer-cache)](#slicer-cache) + +[2.1.5 Slicers [29](#slicers)](#slicers) + +[2.1.6 Data Model [30](#data-model)](#data-model) + +[2.1.6.1 Command Annotations [30](#command-annotations)](#command-annotations) + +[2.1.6.2 DimensionAttribute Annotations [31](#dimensionattribute-annotations)](#dimensionattribute-annotations) + +[2.1.7 Timeline Cache [31](#timeline-cache)](#timeline-cache) + +[2.1.8 Timelines [32](#timelines)](#timelines) + +[2.1.9 Survey [32](#survey)](#survey) + +[2.1.10 Rich Value Data [32](#rich-value-data)](#rich-value-data) + +[2.1.11 Rich Value Structure [33](#rich-value-structure)](#rich-value-structure) + +[2.1.12 Rich Value Array [33](#rich-value-array)](#rich-value-array) + +[2.1.13 Rich Styles [33](#rich-styles)](#rich-styles) + +[2.1.14 Supporting Property Bag Data [34](#supporting-property-bag-data)](#supporting-property-bag-data) + +[2.1.15 Supporting Property Bag Structure [34](#supporting-property-bag-structure)](#supporting-property-bag-structure) + +[2.1.16 Rich Value Types [35](#rich-value-types)](#rich-value-types) + +[2.1.17 Threaded Comments [35](#threaded-comments)](#threaded-comments) + +[2.1.18 Persons [35](#persons)](#persons) + +[2.1.19 Named Sheet Views [36](#named-sheet-views)](#named-sheet-views) + +[2.1.20 Web Image Supporting Rich Data [36](#web-image-supporting-rich-data)](#web-image-supporting-rich-data) + +[2.1.21 Rich Value Rels [37](#rich-value-rels)](#rich-value-rels) + +[2.1.22 Feature Property Bag [37](#feature-property-bag)](#feature-property-bag) + +[2.1.23 Python [37](#python)](#python) + +[2.2 Extensions [38](#extensions)](#extensions) + +[2.2.1 SpreadsheetML Extensibility Elements [38](#spreadsheetml-extensibility-elements)](#spreadsheetml-extensibility-elements) + +[2.2.2 Formulas [38](#formulas)](#formulas) + +[2.2.2.1 Cell Formulas [64](#cell-formulas)](#cell-formulas) + +[2.2.2.2 Conditional Formatting Formulas [64](#conditional-formatting-formulas)](#conditional-formatting-formulas) + +[2.2.2.3 Data Validation Formulas [65](#data-validation-formulas)](#data-validation-formulas) + +[2.2.2.4 External Name Formulas [65](#external-name-formulas)](#external-name-formulas) + +[2.2.2.5 Name Formulas [65](#name-formulas)](#name-formulas) + +[2.2.2.6 Pivot Field Formulas [65](#pivot-field-formulas)](#pivot-field-formulas) + +[2.2.2.7 Pivot Item Formulas [66](#pivot-item-formulas)](#pivot-item-formulas) + +[2.2.3 Functions [66](#functions)](#functions) + +[2.2.4 Extensions by Part [72](#extensions-by-part)](#extensions-by-part) + +[2.2.4.1 Connections [72](#connections)](#connections) + +[2.2.4.2 Drawing [72](#drawing)](#drawing) + +[2.2.4.3 External Workbook References [73](#external-workbook-references)](#external-workbook-references) + +[2.2.4.4 Metadata [73](#metadata)](#metadata) + +[2.2.4.5 Pivot Table [74](#pivot-table)](#pivot-table) + +[2.2.4.6 Pivot Table Cache Definition [76](#pivot-table-cache-definition)](#pivot-table-cache-definition) + +[2.2.4.7 Query Table [77](#query-table)](#query-table) + +[2.2.4.8 SlicerCache [77](#slicercache)](#slicercache) + +[2.2.4.9 Styles [77](#styles)](#styles) + +[2.2.4.10 Table Definition [78](#table-definition)](#table-definition) + +[2.2.4.11 Workbook [79](#workbook)](#workbook) + +[2.2.4.12 Worksheet [80](#worksheet)](#worksheet) + +[2.3 Conceptual Overview [82](#conceptual-overview)](#conceptual-overview) + +[2.3.1 PivotTable What-if Analysis [82](#pivottable-what-if-analysis)](#pivottable-what-if-analysis) + +[2.3.2 Slicers [82](#slicers-1)](#slicers-1) + +[2.3.2.1 Slicer Cache [83](#slicer-cache-1)](#slicer-cache-1) + +[2.3.2.1.1 Slicer Source Data [83](#slicer-source-data)](#slicer-source-data) + +[2.3.2.1.2 Slicer Cache Relationship to PivotCache [83](#slicer-cache-relationship-to-pivotcache)](#slicer-cache-relationship-to-pivotcache) + +[2.3.2.1.3 Slicer Cache Relationship to Table [84](#slicer-cache-relationship-to-table)](#slicer-cache-relationship-to-table) + +[2.3.2.1.4 Slicer Cache Relationship to PivotTable View [84](#slicer-cache-relationship-to-pivottable-view)](#slicer-cache-relationship-to-pivottable-view) + +[2.3.2.1.5 Slicer Cache Relationship to Table column [85](#slicer-cache-relationship-to-table-column)](#slicer-cache-relationship-to-table-column) + +[2.3.2.1.6 Slicer Items [85](#slicer-items)](#slicer-items) + +[2.3.2.1.6.1 Non-OLAP Slicer Items [85](#non-olap-slicer-items)](#non-olap-slicer-items) + +[2.3.2.1.6.2 OLAP Slicer Items [85](#olap-slicer-items)](#olap-slicer-items) + +[2.3.2.1.7 Slicer Cross Filtering [86](#slicer-cross-filtering)](#slicer-cross-filtering) + +[2.3.2.2 Slicer View [86](#slicer-view)](#slicer-view) + +[2.3.2.2.1 Slicer View Relationship to Slicer Cache [86](#slicer-view-relationship-to-slicer-cache)](#slicer-view-relationship-to-slicer-cache) + +[2.3.2.3 Slicers and Cube Functions [87](#slicers-and-cube-functions)](#slicers-and-cube-functions) + +[2.3.2.4 Slicer Styles [87](#slicer-styles)](#slicer-styles) + +[2.3.3 Non-Worksheet PivotTable [87](#non-worksheet-pivottable)](#non-worksheet-pivottable) + +[2.3.4 PivotValues [88](#pivotvalues)](#pivotvalues) + +[2.3.4.1 PivotValueCell [88](#pivotvaluecell)](#pivotvaluecell) + +[2.3.4.1.1 Value [88](#value)](#value) + +[2.3.4.1.2 Server Formatting [88](#server-formatting)](#server-formatting) + +[2.3.5 Timelines [88](#timelines-1)](#timelines-1) + +[2.3.5.1 Timeline Cache [88](#timeline-cache-1)](#timeline-cache-1) + +[2.3.5.1.1 Timeline Source Data [89](#timeline-source-data)](#timeline-source-data) + +[2.3.5.1.2 Timeline Cache Relationship to PivotCache [89](#timeline-cache-relationship-to-pivotcache)](#timeline-cache-relationship-to-pivotcache) + +[2.3.5.1.3 Timeline Cache Relationship to PivotTable View [89](#timeline-cache-relationship-to-pivottable-view)](#timeline-cache-relationship-to-pivottable-view) + +[2.3.5.1.4 Timeline State [89](#timeline-state)](#timeline-state) + +[2.3.5.2 Timeline View [89](#timeline-view)](#timeline-view) + +[2.3.5.2.1 Timeline View Relationship to Timeline Cache [90](#timeline-view-relationship-to-timeline-cache)](#timeline-view-relationship-to-timeline-cache) + +[2.3.5.3 Timelines and Cube Functions [90](#timelines-and-cube-functions)](#timelines-and-cube-functions) + +[2.3.5.4 Timeline Styles [90](#timeline-styles)](#timeline-styles) + +[2.3.6 Rich Data [90](#rich-data)](#rich-data) + +[2.3.6.1 Rich Values [90](#rich-values)](#rich-values) + +[2.3.6.1.1 Array Type [91](#array-type)](#array-type) + +[2.3.6.1.2 Entity Type [91](#entity-type)](#entity-type) + +[2.3.6.1.3 Error Types [91](#error-types)](#error-types) + +[2.3.6.1.3.1 Blocked Error Type [92](#blocked-error-type)](#blocked-error-type) + +[2.3.6.1.3.2 Busy Error Types [92](#busy-error-types)](#busy-error-types) + +[2.3.6.1.3.3 Calc Error Type [92](#calc-error-type)](#calc-error-type) + +[2.3.6.1.3.4 Connect Error Type [92](#connect-error-type)](#connect-error-type) + +[2.3.6.1.3.5 Name Error Type [93](#name-error-type)](#name-error-type) + +[2.3.6.1.3.6 Field Error Type [93](#field-error-type)](#field-error-type) + +[2.3.6.1.3.7 Spill Error Type [93](#spill-error-type)](#spill-error-type) + +[2.3.6.1.3.8 Unknown Error Type [93](#unknown-error-type)](#unknown-error-type) + +[2.3.6.1.3.9 TimeOut Error Type [94](#timeout-error-type)](#timeout-error-type) + +[2.3.6.1.3.10 External Error Type [94](#external-error-type)](#external-error-type) + +[2.3.6.1.4 Formatted Number Type [94](#formatted-number-type)](#formatted-number-type) + +[2.3.6.1.5 Hyperlink Type [94](#hyperlink-type)](#hyperlink-type) + +[2.3.6.1.6 ImageUrl Type [95](#imageurl-type)](#imageurl-type) + +[2.3.6.1.7 Linked Entity Types [96](#linked-entity-types)](#linked-entity-types) + +[2.3.6.1.7.1 Linked Entity and Linked Entity Core Types [96](#linked-entity-and-linked-entity-core-types)](#linked-entity-and-linked-entity-core-types) + +[2.3.6.1.7.2 Linked Entity 2 and Linked Entity 2 Core Types [96](#linked-entity-2-and-linked-entity-2-core-types)](#linked-entity-2-and-linked-entity-2-core-types) + +[2.3.6.1.8 Local Image Type [98](#local-image-type)](#local-image-type) + +[2.3.6.1.9 SourceAttribution Type [99](#sourceattribution-type)](#sourceattribution-type) + +[2.3.6.1.10 Stock History Cache Type [99](#stock-history-cache-type)](#stock-history-cache-type) + +[2.3.6.1.11 Web Image Type [99](#web-image-type)](#web-image-type) + +[2.3.6.1.12 ExternalCodeServiceObject Type [101](#externalcodeserviceobject-type)](#externalcodeserviceobject-type) + +[2.3.6.1.13 Primitive with Metadata Type [102](#primitive-with-metadata-type)](#primitive-with-metadata-type) + +[2.3.6.1.14 JavaScript Custom Function Reference Type [102](#javascript-custom-function-reference-type)](#javascript-custom-function-reference-type) + +[2.3.6.2 Supporting Property Bags [103](#supporting-property-bags)](#supporting-property-bags) + +[2.3.6.3 Special Keys and Key Flags [103](#special-keys-and-key-flags)](#special-keys-and-key-flags) + +[2.3.6.4 Rich Styles and Properties [105](#rich-styles-and-properties)](#rich-styles-and-properties) + +[2.3.7 Threaded Comments [105](#threaded-comments-1)](#threaded-comments-1) + +[2.3.7.1 Persons [105](#persons-1)](#persons-1) + +[2.3.7.2 Mentions [106](#mentions)](#mentions) + +[2.3.7.3 Legacy Comment Placeholders [106](#legacy-comment-placeholders)](#legacy-comment-placeholders) + +[2.3.7.3.1 Reconciliation [106](#reconciliation)](#reconciliation) + +[2.3.8 Named Sheet Views [107](#named-sheet-views-1)](#named-sheet-views-1) + +[2.3.8.1 Table Filters and Worksheet Filters [107](#table-filters-and-worksheet-filters)](#table-filters-and-worksheet-filters) + +[2.3.8.2 Reconciliation [107](#reconciliation-1)](#reconciliation-1) + +[2.3.9 Feature Property Bag [108](#feature-property-bag-1)](#feature-property-bag-1) + +[2.3.9.1 XFComplements [108](#xfcomplements)](#xfcomplements) + +[2.3.9.2 XFComplement [108](#xfcomplement)](#xfcomplement) + +[2.3.9.3 XFControls [109](#xfcontrols)](#xfcontrols) + +[2.3.9.4 Checkbox [109](#checkbox)](#checkbox) + +[2.3.9.5 DXFComplements [109](#dxfcomplements)](#dxfcomplements) + +[2.3.10 Python in Excel [110](#python-in-excel)](#python-in-excel) + +[2.3.10.1 Python environment [110](#python-environment)](#python-environment) + +[2.3.10.2 Python Function [110](#python-function)](#python-function) + +[2.3.10.3 Python Script [110](#python-script)](#python-script) + +[2.3.10.4 Parameter reference encoding [110](#parameter-reference-encoding)](#parameter-reference-encoding) + +[2.4 Global Elements [111](#global-elements)](#global-elements) + +[2.4.1 pivotTableReference [111](#pivottablereference)](#pivottablereference) + +[2.4.2 pivotTableServerFormats [111](#pivottableserverformats)](#pivottableserverformats) + +[2.4.3 f [111](#f)](#f) + +[2.4.4 ref [111](#ref)](#ref) + +[2.4.5 sqref [112](#sqref)](#sqref) + +[2.4.6 conditionalFormattings [112](#conditionalformattings)](#conditionalformattings) + +[2.4.7 dataValidations [112](#datavalidations)](#datavalidations) + +[2.4.8 sparklineGroups [113](#sparklinegroups)](#sparklinegroups) + +[2.4.9 slicerList [113](#slicerlist)](#slicerlist) + +[2.4.10 protectedRanges [113](#protectedranges)](#protectedranges) + +[2.4.11 ignoredErrors [113](#ignorederrors)](#ignorederrors) + +[2.4.12 pivotCaches [114](#pivotcaches)](#pivotcaches) + +[2.4.13 slicerCaches [114](#slicercaches)](#slicercaches) + +[2.4.14 workbookPr [114](#workbookpr)](#workbookpr) + +[2.4.15 calculatedMember [115](#calculatedmember)](#calculatedmember) + +[2.4.16 cacheHierarchy [115](#cachehierarchy)](#cachehierarchy) + +[2.4.17 dataField [115](#datafield)](#datafield) + +[2.4.18 pivotField [116](#pivotfield)](#pivotfield) + +[2.4.19 pivotTableDefinition [116](#pivottabledefinition)](#pivottabledefinition) + +[2.4.20 pivotCacheDefinition [116](#pivotcachedefinition)](#pivotcachedefinition) + +[2.4.21 connection [116](#connection)](#connection) + +[2.4.22 table [117](#table)](#table) + +[2.4.23 slicerStyles [117](#slicerstyles)](#slicerstyles) + +[2.4.24 dxfs [117](#dxfs)](#dxfs) + +[2.4.25 oleItem [118](#oleitem)](#oleitem) + +[2.4.26 pivotHierarchy [118](#pivothierarchy)](#pivothierarchy) + +[2.4.27 cacheField [118](#cachefield)](#cachefield) + +[2.4.28 id [119](#id)](#id) + +[2.4.29 iconFilter [119](#iconfilter)](#iconfilter) + +[2.4.30 filter [119](#filter)](#filter) + +[2.4.31 customFilters [119](#customfilters)](#customfilters) + +[2.4.32 sortCondition [120](#sortcondition)](#sortcondition) + +[2.4.33 sourceConnection [120](#sourceconnection)](#sourceconnection) + +[2.4.34 formControlPr [120](#formcontrolpr)](#formcontrolpr) + +[2.4.35 datastoreItem [121](#datastoreitem)](#datastoreitem) + +[2.4.36 slicers [121](#slicers-2)](#slicers-2) + +[2.4.37 slicer [121](#slicer)](#slicer) + +[2.4.38 slicerCacheDefinition [121](#slicercachedefinition)](#slicercachedefinition) + +[2.4.39 pivotCaches [122](#pivotcaches-1)](#pivotcaches-1) + +[2.4.40 pivotTableReferences [122](#pivottablereferences)](#pivottablereferences) + +[2.4.41 queryTable [123](#querytable)](#querytable) + +[2.4.42 webExtensions [123](#webextensions)](#webextensions) + +[2.4.43 connection [123](#connection-1)](#connection-1) + +[2.4.44 calculatedMember [123](#calculatedmember-1)](#calculatedmember-1) + +[2.4.45 pivotTableUISettings [124](#pivottableuisettings)](#pivottableuisettings) + +[2.4.46 pivotFilter [124](#pivotfilter)](#pivotfilter) + +[2.4.47 slicerCaches [124](#slicercaches-1)](#slicercaches-1) + +[2.4.48 tableSlicerCache [124](#tableslicercache)](#tableslicercache) + +[2.4.49 timelineCacheRefs [125](#timelinecacherefs)](#timelinecacherefs) + +[2.4.50 timelineRefs [125](#timelinerefs)](#timelinerefs) + +[2.4.51 timelineCachePivotCaches [125](#timelinecachepivotcaches)](#timelinecachepivotcaches) + +[2.4.52 cacheHierarchy [126](#cachehierarchy-1)](#cachehierarchy-1) + +[2.4.53 slicerCacheHideItemsWithNoData [126](#slicercachehideitemswithnodata)](#slicercachehideitemswithnodata) + +[2.4.54 timelineStyles [126](#timelinestyles)](#timelinestyles) + +[2.4.55 dxfs [126](#dxfs-1)](#dxfs-1) + +[2.4.56 timelinePivotCacheDefinition [127](#timelinepivotcachedefinition)](#timelinepivotcachedefinition) + +[2.4.57 timelines [127](#timelines-2)](#timelines-2) + +[2.4.58 timelineCacheDefinition [127](#timelinecachedefinition)](#timelinecachedefinition) + +[2.4.59 workbookPr [128](#workbookpr-1)](#workbookpr-1) + +[2.4.60 slicerCachePivotTables [128](#slicercachepivottables)](#slicercachepivottables) + +[2.4.61 cachedUniqueNames [128](#cacheduniquenames)](#cacheduniquenames) + +[2.4.62 dataModel [128](#datamodel)](#datamodel) + +[2.4.63 pivotTableData [129](#pivottabledata)](#pivottabledata) + +[2.4.64 pivotCacheIdVersion [129](#pivotcacheidversion)](#pivotcacheidversion) + +[2.4.65 timeslicer [129](#timeslicer)](#timeslicer) + +[2.4.66 list [130](#list)](#list) + +[2.4.67 absPath [130](#abspath)](#abspath) + +[2.4.68 dataField [130](#datafield-1)](#datafield-1) + +[2.4.69 survey [130](#survey-1)](#survey-1) + +[2.4.70 contentPart [131](#contentpart)](#contentpart) + +[2.4.71 modelTimeGroupings [131](#modeltimegroupings)](#modeltimegroupings) + +[2.4.72 revisionPtr [131](#revisionptr)](#revisionptr) + +[2.4.73 pivotTableDefinition16 [132](#pivottabledefinition16)](#pivottabledefinition16) + +[2.4.74 arrayData [132](#arraydata)](#arraydata) + +[2.4.75 richStyleSheet [132](#richstylesheet)](#richstylesheet) + +[2.4.76 rvb [132](#rvb)](#rvb) + +[2.4.77 rvData [133](#rvdata)](#rvdata) + +[2.4.78 rvStructures [133](#rvstructures)](#rvstructures) + +[2.4.79 rvTypesInfo [133](#rvtypesinfo)](#rvtypesinfo) + +[2.4.80 spbStructures [133](#spbstructures)](#spbstructures) + +[2.4.81 supportingPropertyBags [134](#supportingpropertybags)](#supportingpropertybags) + +[2.4.82 calcFeatures [134](#calcfeatures)](#calcfeatures) + +[2.4.83 filterColumn [134](#filtercolumn)](#filtercolumn) + +[2.4.84 richSortCondition [135](#richsortcondition)](#richsortcondition) + +[2.4.85 personList [135](#personlist)](#personlist) + +[2.4.86 ThreadedComments [135](#threadedcomments)](#threadedcomments) + +[2.4.87 dynamicArrayProperties [135](#dynamicarrayproperties)](#dynamicarrayproperties) + +[2.4.88 namedSheetViews [136](#namedsheetviews)](#namedsheetviews) + +[2.4.89 externalLinksPr [136](#externallinkspr)](#externallinkspr) + +[2.4.90 webImagesSrd [136](#webimagessrd)](#webimagessrd) + +[2.4.91 implicitMeasureSupport [136](#implicitmeasuresupport)](#implicitmeasuresupport) + +[2.4.92 refreshIntervals [137](#refreshintervals)](#refreshintervals) + +[2.4.93 dataFieldFutureData [137](#datafieldfuturedata)](#datafieldfuturedata) + +[2.4.94 ignorableAfterVersion [137](#ignorableafterversion)](#ignorableafterversion) + +[2.4.95 cacheVersionInfo [138](#cacheversioninfo)](#cacheversioninfo) + +[2.4.96 pivotVersionInfo [138](#pivotversioninfo)](#pivotversioninfo) + +[2.4.97 alternateUrls [138](#alternateurls)](#alternateurls) + +[2.4.98 FeaturePropertyBags [138](#featurepropertybags)](#featurepropertybags) + +[2.4.99 xfComplement [139](#xfcomplement-1)](#xfcomplement-1) + +[2.4.100 richValueRels [139](#richvaluerels)](#richvaluerels) + +[2.4.101 externalCodeService [139](#externalcodeservice)](#externalcodeservice) + +[2.4.102 python [139](#python-1)](#python-1) + +[2.4.103 DXFComplement [140](#dxfcomplement)](#dxfcomplement) + +[2.4.104 aggregationInfo [140](#aggregationinfo)](#aggregationinfo) + +[2.4.105 featureSupportInfo [140](#featuresupportinfo)](#featuresupportinfo) + +[2.4.106 autoRefresh [141](#autorefresh)](#autorefresh) + +[2.4.107 version [141](#version)](#version) + +[2.4.108 showDataTypeIcons [141](#showdatatypeicons)](#showdatatypeicons) + +[2.4.109 showDataTypeIconsCustomSheetView [141](#showdatatypeiconscustomsheetview)](#showdatatypeiconscustomsheetview) + +[2.4.110 externalCodeServiceImageAsInput [142](#externalcodeserviceimageasinput)](#externalcodeserviceimageasinput) + +[2.4.111 pivotAreaReferenceSubtotals [142](#pivotareareferencesubtotals)](#pivotareareferencesubtotals) + +[2.4.112 pivotCacheDataSource [142](#pivotcachedatasource)](#pivotcachedatasource) + +[2.4.113 pivotFieldSubtotalLineItems [143](#pivotfieldsubtotallineitems)](#pivotfieldsubtotallineitems) + +[2.4.114 pivotFieldSubtotals [143](#pivotfieldsubtotals)](#pivotfieldsubtotals) + +[2.4.115 richInfo [143](#richinfo)](#richinfo) + +[2.4.116 dataSourceClean [143](#datasourceclean)](#datasourceclean) + +[2.5 Global Attributes [144](#global-attributes)](#global-attributes) + +[2.5.1 coauthVersionLast [144](#coauthversionlast)](#coauthversionlast) + +[2.5.2 coauthVersionMax [144](#coauthversionmax)](#coauthversionmax) + +[2.5.3 dyDescent [144](#dydescent)](#dydescent) + +[2.5.4 formatCode16 [145](#formatcode16)](#formatcode16) + +[2.5.5 knownFonts [146](#knownfonts)](#knownfonts) + +[2.5.6 misleadingFormat [146](#misleadingformat)](#misleadingformat) + +[2.5.7 uid [146](#uid)](#uid) + +[2.5.8 uid [147](#uid-1)](#uid-1) + +[2.5.9 uid [147](#uid-2)](#uid-2) + +[2.5.10 uid [147](#uid-3)](#uid-3) + +[2.5.11 uid [147](#uid-4)](#uid-4) + +[2.5.12 uid [148](#uid-5)](#uid-5) + +[2.5.13 uidLastSave [148](#uidlastsave)](#uidlastsave) + +[2.6 Complex Types [148](#complex-types)](#complex-types) + +[2.6.1 CT_ConditionalFormattings [148](#ct_conditionalformattings)](#ct_conditionalformattings) + +[2.6.2 CT_ConditionalFormatting [149](#ct_conditionalformatting)](#ct_conditionalformatting) + +[2.6.3 CT_DataValidations [150](#ct_datavalidations)](#ct_datavalidations) + +[2.6.4 CT_DataValidationFormula [150](#ct_datavalidationformula)](#ct_datavalidationformula) + +[2.6.5 CT_DataValidation [151](#ct_datavalidation)](#ct_datavalidation) + +[2.6.6 CT_SparklineGroups [153](#ct_sparklinegroups)](#ct_sparklinegroups) + +[2.6.7 CT_SparklineGroup [154](#ct_sparklinegroup)](#ct_sparklinegroup) + +[2.6.8 CT_Sparklines [158](#ct_sparklines)](#ct_sparklines) + +[2.6.9 CT_Sparkline [158](#ct_sparkline)](#ct_sparkline) + +[2.6.10 CT_WorkbookPr [159](#ct_workbookpr)](#ct_workbookpr) + +[2.6.11 CT_SlicerRefs [159](#ct_slicerrefs)](#ct_slicerrefs) + +[2.6.12 CT_SlicerRef [160](#ct_slicerref)](#ct_slicerref) + +[2.6.13 CT_SlicerCaches [160](#ct_slicercaches)](#ct_slicercaches) + +[2.6.14 CT_SlicerCache [161](#ct_slicercache)](#ct_slicercache) + +[2.6.15 CT_CalculatedMember [161](#ct_calculatedmember)](#ct_calculatedmember) + +[2.6.16 CT_TupleSet [163](#ct_tupleset)](#ct_tupleset) + +[2.6.17 CT_TupleSetHeaders [163](#ct_tuplesetheaders)](#ct_tuplesetheaders) + +[2.6.18 CT_TupleSetHeader [164](#ct_tuplesetheader)](#ct_tuplesetheader) + +[2.6.19 CT_TupleSetRows [164](#ct_tuplesetrows)](#ct_tuplesetrows) + +[2.6.20 CT_TupleSetRow [165](#ct_tuplesetrow)](#ct_tuplesetrow) + +[2.6.21 CT_TupleSetRowItem [165](#ct_tuplesetrowitem)](#ct_tuplesetrowitem) + +[2.6.22 CT_SetLevels [166](#ct_setlevels)](#ct_setlevels) + +[2.6.23 CT_SetLevel [166](#ct_setlevel)](#ct_setlevel) + +[2.6.24 CT_CacheHierarchy [167](#ct_cachehierarchy)](#ct_cachehierarchy) + +[2.6.25 CT_DataField [170](#ct_datafield)](#ct_datafield) + +[2.6.26 CT_Cfvo [171](#ct_cfvo)](#ct_cfvo) + +[2.6.27 CT_CfRule [173](#ct_cfrule)](#ct_cfrule) + +[2.6.28 CT_IconSet [176](#ct_iconset)](#ct_iconset) + +[2.6.29 CT_ColorScale [177](#ct_colorscale)](#ct_colorscale) + +[2.6.30 CT_DataBar [178](#ct_databar)](#ct_databar) + +[2.6.31 CT_PivotField [181](#ct_pivotfield)](#ct_pivotfield) + +[2.6.32 CT_PivotTableDefinition [182](#ct_pivottabledefinition)](#ct_pivottabledefinition) + +[2.6.33 CT_PivotCacheDefinition [184](#ct_pivotcachedefinition)](#ct_pivotcachedefinition) + +[2.6.34 CT_Connection [185](#ct_connection)](#ct_connection) + +[2.6.35 CT_Table [186](#ct_table)](#ct_table) + +[2.6.36 CT_CfIcon [187](#ct_cficon)](#ct_cficon) + +[2.6.37 CT_PivotEdits [187](#ct_pivotedits)](#ct_pivotedits) + +[2.6.38 CT_PivotEdit [188](#ct_pivotedit)](#ct_pivotedit) + +[2.6.39 CT_PivotChanges [188](#ct_pivotchanges)](#ct_pivotchanges) + +[2.6.40 CT_PivotChange [189](#ct_pivotchange)](#ct_pivotchange) + +[2.6.41 CT_PivotUserEdit [190](#ct_pivotuseredit)](#ct_pivotuseredit) + +[2.6.42 CT_PivotEditValue [190](#ct_pivoteditvalue)](#ct_pivoteditvalue) + +[2.6.43 CT_TupleItems [191](#ct_tupleitems)](#ct_tupleitems) + +[2.6.44 CT_SlicerStyle [191](#ct_slicerstyle)](#ct_slicerstyle) + +[2.6.45 CT_SlicerStyleElement [192](#ct_slicerstyleelement)](#ct_slicerstyleelement) + +[2.6.46 CT_OleItem [192](#ct_oleitem)](#ct_oleitem) + +[2.6.47 CT_PivotHierarchy [194](#ct_pivothierarchy)](#ct_pivothierarchy) + +[2.6.48 CT_CacheField [195](#ct_cachefield)](#ct_cachefield) + +[2.6.49 CT_ConditionalFormats [196](#ct_conditionalformats)](#ct_conditionalformats) + +[2.6.50 CT_ConditionalFormat [196](#ct_conditionalformat)](#ct_conditionalformat) + +[2.6.51 CT_SlicerStyles [197](#ct_slicerstyles)](#ct_slicerstyles) + +[2.6.52 CT_SlicerStyleElements [198](#ct_slicerstyleelements)](#ct_slicerstyleelements) + +[2.6.53 CT_IgnoredErrors [198](#ct_ignorederrors)](#ct_ignorederrors) + +[2.6.54 CT_IgnoredError [199](#ct_ignorederror)](#ct_ignorederror) + +[2.6.55 CT_ProtectedRanges [201](#ct_protectedranges)](#ct_protectedranges) + +[2.6.56 CT_ProtectedRange [202](#ct_protectedrange)](#ct_protectedrange) + +[2.6.57 CT_IconFilter [203](#ct_iconfilter)](#ct_iconfilter) + +[2.6.58 CT_Filter [204](#ct_filter)](#ct_filter) + +[2.6.59 CT_CustomFilters [204](#ct_customfilters)](#ct_customfilters) + +[2.6.60 CT_CustomFilter [205](#ct_customfilter)](#ct_customfilter) + +[2.6.61 CT_SortCondition [205](#ct_sortcondition)](#ct_sortcondition) + +[2.6.62 CT_SourceConnection [207](#ct_sourceconnection)](#ct_sourceconnection) + +[2.6.63 CT_ListItem [207](#ct_listitem)](#ct_listitem) + +[2.6.64 CT_ListItems [208](#ct_listitems)](#ct_listitems) + +[2.6.65 CT_FormControlPr [208](#ct_formcontrolpr)](#ct_formcontrolpr) + +[2.6.66 CT_DatastoreItem [212](#ct_datastoreitem)](#ct_datastoreitem) + +[2.6.67 CT_Slicers [213](#ct_slicers)](#ct_slicers) + +[2.6.68 CT_Slicer [213](#ct_slicer)](#ct_slicer) + +[2.6.69 CT_Slicer [215](#ct_slicer-1)](#ct_slicer-1) + +[2.6.70 CT_SlicerCacheDefinition [216](#ct_slicercachedefinition)](#ct_slicercachedefinition) + +[2.6.71 CT_SlicerCacheData [217](#ct_slicercachedata)](#ct_slicercachedata) + +[2.6.72 CT_SlicerCachePivotTables [218](#ct_slicercachepivottables)](#ct_slicercachepivottables) + +[2.6.73 CT_SlicerCachePivotTable [218](#ct_slicercachepivottable)](#ct_slicercachepivottable) + +[2.6.74 CT_OlapSlicerCacheItem [219](#ct_olapslicercacheitem)](#ct_olapslicercacheitem) + +[2.6.75 CT_OlapSlicerCacheItemParent [220](#ct_olapslicercacheitemparent)](#ct_olapslicercacheitemparent) + +[2.6.76 CT_OlapSlicerCacheRange [220](#ct_olapslicercacherange)](#ct_olapslicercacherange) + +[2.6.77 CT_OlapSlicerCacheRanges [221](#ct_olapslicercacheranges)](#ct_olapslicercacheranges) + +[2.6.78 CT_OlapSlicerCacheLevelData [221](#ct_olapslicercacheleveldata)](#ct_olapslicercacheleveldata) + +[2.6.79 CT_OlapSlicerCacheLevelsData [222](#ct_olapslicercachelevelsdata)](#ct_olapslicercachelevelsdata) + +[2.6.80 CT_OlapSlicerCache [222](#ct_olapslicercache)](#ct_olapslicercache) + +[2.6.81 CT_OlapSlicerCacheSelections [223](#ct_olapslicercacheselections)](#ct_olapslicercacheselections) + +[2.6.82 CT_OlapSlicerCacheSelection [224](#ct_olapslicercacheselection)](#ct_olapslicercacheselection) + +[2.6.83 CT_TabularSlicerCache [224](#ct_tabularslicercache)](#ct_tabularslicercache) + +[2.6.84 CT_TabularSlicerCacheItems [226](#ct_tabularslicercacheitems)](#ct_tabularslicercacheitems) + +[2.6.85 CT_TabularSlicerCacheItem [226](#ct_tabularslicercacheitem)](#ct_tabularslicercacheitem) + +[2.6.86 CT_PivotTableReferences [227](#ct_pivottablereferences)](#ct_pivottablereferences) + +[2.6.87 CT_PivotTableReference [227](#ct_pivottablereference)](#ct_pivottablereference) + +[2.6.88 CT_QueryTable [228](#ct_querytable)](#ct_querytable) + +[2.6.89 CT_WebExtensions [229](#ct_webextensions)](#ct_webextensions) + +[2.6.90 CT_WebExtension [229](#ct_webextension)](#ct_webextension) + +[2.6.91 CT_Connection [230](#ct_connection-1)](#ct_connection-1) + +[2.6.92 CT_CalculatedMemberExt [232](#ct_calculatedmemberext)](#ct_calculatedmemberext) + +[2.6.93 CT_CalculatedMember [232](#ct_calculatedmember-1)](#ct_calculatedmember-1) + +[2.6.94 CT_FieldListActiveTabTopLevelEntity [233](#ct_fieldlistactivetabtoplevelentity)](#ct_fieldlistactivetabtoplevelentity) + +[2.6.95 CT_PivotFilter [234](#ct_pivotfilter)](#ct_pivotfilter) + +[2.6.96 CT_PivotTableUISettings [235](#ct_pivottableuisettings)](#ct_pivottableuisettings) + +[2.6.97 CT_TableSlicerCache [236](#ct_tableslicercache)](#ct_tableslicercache) + +[2.6.98 CT_TimelineCacheRefs [237](#ct_timelinecacherefs)](#ct_timelinecacherefs) + +[2.6.99 CT_TimelineCacheRef [237](#ct_timelinecacheref)](#ct_timelinecacheref) + +[2.6.100 CT_TimelineRefs [238](#ct_timelinerefs)](#ct_timelinerefs) + +[2.6.101 CT_TimelineRef [238](#ct_timelineref)](#ct_timelineref) + +[2.6.102 CT_CacheHierarchy [239](#ct_cachehierarchy-1)](#ct_cachehierarchy-1) + +[2.6.103 CT_SlicerCacheHideNoData [239](#ct_slicercachehidenodata)](#ct_slicercachehidenodata) + +[2.6.104 CT_SlicerCacheOlapLevelName [240](#ct_slicercacheolaplevelname)](#ct_slicercacheolaplevelname) + +[2.6.105 CT_TimelineStyles [240](#ct_timelinestyles)](#ct_timelinestyles) + +[2.6.106 CT_TimelineStyleElements [241](#ct_timelinestyleelements)](#ct_timelinestyleelements) + +[2.6.107 CT_TimelineStyle [241](#ct_timelinestyle)](#ct_timelinestyle) + +[2.6.108 CT_TimelineStyleElement [242](#ct_timelinestyleelement)](#ct_timelinestyleelement) + +[2.6.109 CT_TimelinePivotCacheDefinition [242](#ct_timelinepivotcachedefinition)](#ct_timelinepivotcachedefinition) + +[2.6.110 CT_Timelines [243](#ct_timelines)](#ct_timelines) + +[2.6.111 CT_Timeline [243](#ct_timeline)](#ct_timeline) + +[2.6.112 CT_TimelineCacheDefinition [246](#ct_timelinecachedefinition)](#ct_timelinecachedefinition) + +[2.6.113 CT_TimelineCachePivotTables [247](#ct_timelinecachepivottables)](#ct_timelinecachepivottables) + +[2.6.114 CT_TimelineCachePivotTable [248](#ct_timelinecachepivottable)](#ct_timelinecachepivottable) + +[2.6.115 CT_TimelineRange [248](#ct_timelinerange)](#ct_timelinerange) + +[2.6.116 CT_TimelineState [249](#ct_timelinestate)](#ct_timelinestate) + +[2.6.117 CT_WorkbookPr [250](#ct_workbookpr-1)](#ct_workbookpr-1) + +[2.6.118 CT_TimelinePivotFilter [250](#ct_timelinepivotfilter)](#ct_timelinepivotfilter) + +[2.6.119 CT_ModelTextPr [251](#ct_modeltextpr)](#ct_modeltextpr) + +[2.6.120 CT_RangePr [252](#ct_rangepr)](#ct_rangepr) + +[2.6.121 CT_DbTable [252](#ct_dbtable)](#ct_dbtable) + +[2.6.122 CT_DbTables [253](#ct_dbtables)](#ct_dbtables) + +[2.6.123 CT_DbCommand [253](#ct_dbcommand)](#ct_dbcommand) + +[2.6.124 CT_OledbPr [254](#ct_oledbpr)](#ct_oledbpr) + +[2.6.125 CT_DataFeedPr [254](#ct_datafeedpr)](#ct_datafeedpr) + +[2.6.126 CT_CachedUniqueNames [255](#ct_cacheduniquenames)](#ct_cacheduniquenames) + +[2.6.127 CT_CachedUniqueName [255](#ct_cacheduniquename)](#ct_cacheduniquename) + +[2.6.128 CT_ModelTable [256](#ct_modeltable)](#ct_modeltable) + +[2.6.129 CT_ModelTables [256](#ct_modeltables)](#ct_modeltables) + +[2.6.130 CT_ModelRelationship [257](#ct_modelrelationship)](#ct_modelrelationship) + +[2.6.131 CT_ModelRelationships [257](#ct_modelrelationships)](#ct_modelrelationships) + +[2.6.132 CT_DataModel [258](#ct_datamodel)](#ct_datamodel) + +[2.6.133 CT_PivotTableData [258](#ct_pivottabledata)](#ct_pivottabledata) + +[2.6.134 CT_PivotRow [259](#ct_pivotrow)](#ct_pivotrow) + +[2.6.135 CT_PivotValueCell [260](#ct_pivotvaluecell)](#ct_pivotvaluecell) + +[2.6.136 CT_PivotValueCellExtra [261](#ct_pivotvaluecellextra)](#ct_pivotvaluecellextra) + +[2.6.137 CT_PivotTableServerFormats [262](#ct_pivottableserverformats)](#ct_pivottableserverformats) + +[2.6.138 CT_PivotCacheIdVersion [262](#ct_pivotcacheidversion)](#ct_pivotcacheidversion) + +[2.6.139 CT_Timeline [263](#ct_timeline-1)](#ct_timeline-1) + +[2.6.140 CT_AbsolutePath [263](#ct_absolutepath)](#ct_absolutepath) + +[2.6.141 CT_DataField [264](#ct_datafield-1)](#ct_datafield-1) + +[2.6.142 CT_Survey [264](#ct_survey)](#ct_survey) + +[2.6.143 CT_SurveyQuestions [265](#ct_surveyquestions)](#ct_surveyquestions) + +[2.6.144 CT_SurveyQuestion [265](#ct_surveyquestion)](#ct_surveyquestion) + +[2.6.145 CT_SurveyElementPr [267](#ct_surveyelementpr)](#ct_surveyelementpr) + +[2.6.146 CT_Ref [268](#ct_ref)](#ct_ref) + +[2.6.147 CT_Sqref [268](#ct_sqref)](#ct_sqref) + +[2.6.148 CT_ApplicationNonVisualDrawingProps [269](#ct_applicationnonvisualdrawingprops)](#ct_applicationnonvisualdrawingprops) + +[2.6.149 CT_CacheSourceExt [270](#ct_cachesourceext)](#ct_cachesourceext) + +[2.6.150 CT_ContentPart [270](#ct_contentpart)](#ct_contentpart) + +[2.6.151 CT_ContentPartNonVisual [271](#ct_contentpartnonvisual)](#ct_contentpartnonvisual) + +[2.6.152 CT_CalculatedTimeColumn [271](#ct_calculatedtimecolumn)](#ct_calculatedtimecolumn) + +[2.6.153 CT_ModelTimeGrouping [272](#ct_modeltimegrouping)](#ct_modeltimegrouping) + +[2.6.154 CT_ModelTimeGroupings [273](#ct_modeltimegroupings)](#ct_modeltimegroupings) + +[2.6.155 CT_RevisionPtr [273](#ct_revisionptr)](#ct_revisionptr) + +[2.6.156 CT_PivotTableDefinition16 [274](#ct_pivottabledefinition16)](#ct_pivottabledefinition16) + +[2.6.157 CT_Array [274](#ct_array)](#ct_array) + +[2.6.158 CT_ArrayData [275](#ct_arraydata)](#ct_arraydata) + +[2.6.159 CT_ArrayValue [276](#ct_arrayvalue)](#ct_arrayvalue) + +[2.6.160 CT_CustomRichFilter [276](#ct_customrichfilter)](#ct_customrichfilter) + +[2.6.161 CT_CustomRichFilters [277](#ct_customrichfilters)](#ct_customrichfilters) + +[2.6.162 CT_DynamicRichFilter [277](#ct_dynamicrichfilter)](#ct_dynamicrichfilter) + +[2.6.163 CT_Key [279](#ct_key)](#ct_key) + +[2.6.164 CT_RichDateGroupItem [279](#ct_richdategroupitem)](#ct_richdategroupitem) + +[2.6.165 CT_RichFilter [280](#ct_richfilter)](#ct_richfilter) + +[2.6.166 CT_RichFilters [280](#ct_richfilters)](#ct_richfilters) + +[2.6.167 CT_RichFormatProperties [281](#ct_richformatproperties)](#ct_richformatproperties) + +[2.6.168 CT_RichFormatProperty [281](#ct_richformatproperty)](#ct_richformatproperty) + +[2.6.169 CT_RichSortCondition [282](#ct_richsortcondition)](#ct_richsortcondition) + +[2.6.170 CT_RichStyle [283](#ct_richstyle)](#ct_richstyle) + +[2.6.171 CT_RichStylePropertyValue [284](#ct_richstylepropertyvalue)](#ct_richstylepropertyvalue) + +[2.6.172 CT_RichStyles [284](#ct_richstyles)](#ct_richstyles) + +[2.6.173 CT_RichStylesheet [285](#ct_richstylesheet)](#ct_richstylesheet) + +[2.6.174 CT_RichTop10 [285](#ct_richtop10)](#ct_richtop10) + +[2.6.175 CT_RichValue [286](#ct_richvalue)](#ct_richvalue) + +[2.6.176 CT_RichValueBlock [287](#ct_richvalueblock)](#ct_richvalueblock) + +[2.6.177 CT_RichValueData [287](#ct_richvaluedata)](#ct_richvaluedata) + +[2.6.178 CT_RichValueFallback [288](#ct_richvaluefallback)](#ct_richvaluefallback) + +[2.6.179 CT_RichValueGlobalType [288](#ct_richvalueglobaltype)](#ct_richvalueglobaltype) + +[2.6.180 CT_RichValueStructure [289](#ct_richvaluestructure)](#ct_richvaluestructure) + +[2.6.181 CT_RichValueStructures [289](#ct_richvaluestructures)](#ct_richvaluestructures) + +[2.6.182 CT_RichValueType [290](#ct_richvaluetype)](#ct_richvaluetype) + +[2.6.183 CT_RichValueTypeKeyFlags [290](#ct_richvaluetypekeyflags)](#ct_richvaluetypekeyflags) + +[2.6.184 CT_RichValueTypeReservedKey [291](#ct_richvaluetypereservedkey)](#ct_richvaluetypereservedkey) + +[2.6.185 CT_RichValueTypeReservedKeyFlag [291](#ct_richvaluetypereservedkeyflag)](#ct_richvaluetypereservedkeyflag) + +[2.6.186 CT_RichValueTypes [292](#ct_richvaluetypes)](#ct_richvaluetypes) + +[2.6.187 CT_RichValueTypesInfo [292](#ct_richvaluetypesinfo)](#ct_richvaluetypesinfo) + +[2.6.188 CT_SupportingPropertyBag [293](#ct_supportingpropertybag)](#ct_supportingpropertybag) + +[2.6.189 CT_SupportingPropertyBagArray [293](#ct_supportingpropertybagarray)](#ct_supportingpropertybagarray) + +[2.6.190 CT_SupportingPropertyBagArrayData [294](#ct_supportingpropertybagarraydata)](#ct_supportingpropertybagarraydata) + +[2.6.191 CT_SupportingPropertyBagArrayValue [295](#ct_supportingpropertybagarrayvalue)](#ct_supportingpropertybagarrayvalue) + +[2.6.192 CT_SupportingPropertyBagData [295](#ct_supportingpropertybagdata)](#ct_supportingpropertybagdata) + +[2.6.193 CT_SupportingPropertyBagKey [296](#ct_supportingpropertybagkey)](#ct_supportingpropertybagkey) + +[2.6.194 CT_SupportingPropertyBags [296](#ct_supportingpropertybags)](#ct_supportingpropertybags) + +[2.6.195 CT_SupportingPropertyBagStructure [297](#ct_supportingpropertybagstructure)](#ct_supportingpropertybagstructure) + +[2.6.196 CT_SupportingPropertyBagStructures [297](#ct_supportingpropertybagstructures)](#ct_supportingpropertybagstructures) + +[2.6.197 CT_SupportingPropertyBagValue [298](#ct_supportingpropertybagvalue)](#ct_supportingpropertybagvalue) + +[2.6.198 CT_Value [298](#ct_value)](#ct_value) + +[2.6.199 CT_CalcFeature [298](#ct_calcfeature)](#ct_calcfeature) + +[2.6.200 CT_CalcFeatures [299](#ct_calcfeatures)](#ct_calcfeatures) + +[2.6.201 CT_RichFilterColumn [299](#ct_richfiltercolumn)](#ct_richfiltercolumn) + +[2.6.202 CT_Mention [300](#ct_mention)](#ct_mention) + +[2.6.203 CT_Person [301](#ct_person)](#ct_person) + +[2.6.204 CT_PersonList [302](#ct_personlist)](#ct_personlist) + +[2.6.205 CT_ThreadedComment [302](#ct_threadedcomment)](#ct_threadedcomment) + +[2.6.206 CT_ThreadedCommentMentions [303](#ct_threadedcommentmentions)](#ct_threadedcommentmentions) + +[2.6.207 CT_ThreadedComments [304](#ct_threadedcomments)](#ct_threadedcomments) + +[2.6.208 CT_DynamicArrayProperties [304](#ct_dynamicarrayproperties)](#ct_dynamicarrayproperties) + +[2.6.209 CT_ColumnFilter [305](#ct_columnfilter)](#ct_columnfilter) + +[2.6.210 CT_NamedSheetView [305](#ct_namedsheetview)](#ct_namedsheetview) + +[2.6.211 CT_NamedSheetViews [306](#ct_namedsheetviews)](#ct_namedsheetviews) + +[2.6.212 CT_NsvFilter [307](#ct_nsvfilter)](#ct_nsvfilter) + +[2.6.213 CT_SortRule [308](#ct_sortrule)](#ct_sortrule) + +[2.6.214 CT_SortRules [309](#ct_sortrules)](#ct_sortrules) + +[2.6.215 CT_ExternalLinksPr [309](#ct_externallinkspr)](#ct_externallinkspr) + +[2.6.216 CT_WebImagesSupportingRichData [310](#ct_webimagessupportingrichdata)](#ct_webimagessupportingrichdata) + +[2.6.217 CT_WebImageSupportingRichData [310](#ct_webimagesupportingrichdata)](#ct_webimagesupportingrichdata) + +[2.6.218 CT_WebImageSupportingRichDataRelationship [311](#ct_webimagesupportingrichdatarelationship)](#ct_webimagesupportingrichdatarelationship) + +[2.6.219 CT_CommentHyperlink [311](#ct_commenthyperlink)](#ct_commenthyperlink) + +[2.6.220 CT_ThreadedComments2Ext [312](#ct_threadedcomments2ext)](#ct_threadedcomments2ext) + +[2.6.221 CT_RichValueRefreshInterval [312](#ct_richvaluerefreshinterval)](#ct_richvaluerefreshinterval) + +[2.6.222 CT_RichValueRefreshIntervals [313](#ct_richvaluerefreshintervals)](#ct_richvaluerefreshintervals) + +[2.6.223 CT_DataFieldFutureData [313](#ct_datafieldfuturedata)](#ct_datafieldfuturedata) + +[2.6.224 CT_Ignorable [314](#ct_ignorable)](#ct_ignorable) + +[2.6.225 CT_CacheVersionInfo [314](#ct_cacheversioninfo)](#ct_cacheversioninfo) + +[2.6.226 CT_PivotVersionInfo [315](#ct_pivotversioninfo)](#ct_pivotversioninfo) + +[2.6.227 CT_AlternateUrl [315](#ct_alternateurl)](#ct_alternateurl) + +[2.6.228 CT_ExternalBookAlternateUrls [316](#ct_externalbookalternateurls)](#ct_externalbookalternateurls) + +[2.6.229 CT_ArrayFeatureProperty [316](#ct_arrayfeatureproperty)](#ct_arrayfeatureproperty) + +[2.6.230 CT_BagFeatureProperty [317](#ct_bagfeatureproperty)](#ct_bagfeatureproperty) + +[2.6.231 CT_BoolFeatureProperty [318](#ct_boolfeatureproperty)](#ct_boolfeatureproperty) + +[2.6.232 CT_DecimalFeatureProperty [318](#ct_decimalfeatureproperty)](#ct_decimalfeatureproperty) + +[2.6.233 CT_FeaturePropertyBag [319](#ct_featurepropertybag)](#ct_featurepropertybag) + +[2.6.234 CT_FeaturePropertyBags [320](#ct_featurepropertybags)](#ct_featurepropertybags) + +[2.6.235 CT_IntFeatureProperty [320](#ct_intfeatureproperty)](#ct_intfeatureproperty) + +[2.6.236 CT_RelFeatureProperty [321](#ct_relfeatureproperty)](#ct_relfeatureproperty) + +[2.6.237 CT_StringFeatureProperty [321](#ct_stringfeatureproperty)](#ct_stringfeatureproperty) + +[2.6.238 CT_XfComplement [322](#ct_xfcomplement)](#ct_xfcomplement) + +[2.6.239 CT_XfComplementExt [322](#ct_xfcomplementext)](#ct_xfcomplementext) + +[2.6.240 CT_BagExtensions [322](#ct_bagextensions)](#ct_bagextensions) + +[2.6.241 CT_RichValueRelRelationship [323](#ct_richvaluerelrelationship)](#ct_richvaluerelrelationship) + +[2.6.242 CT_RichValueRels [323](#ct_richvaluerels)](#ct_richvaluerels) + +[2.6.243 CT_MsForm [324](#ct_msform)](#ct_msform) + +[2.6.244 CT_MsFormsExt [324](#ct_msformsext)](#ct_msformsext) + +[2.6.245 CT_QuestionExt [325](#ct_questionext)](#ct_questionext) + +[2.6.246 CT_Question [325](#ct_question)](#ct_question) + +[2.6.247 CT_ExternalCodeService [326](#ct_externalcodeservice)](#ct_externalcodeservice) + +[2.6.248 CT_ExternalCodeServiceExt [326](#ct_externalcodeserviceext)](#ct_externalcodeserviceext) + +[2.6.249 CT_Python [327](#ct_python)](#ct_python) + +[2.6.250 CT_PythonEnvironmentDefinition [327](#ct_pythonenvironmentdefinition)](#ct_pythonenvironmentdefinition) + +[2.6.251 CT_PythonInitialization [328](#ct_pythoninitialization)](#ct_pythoninitialization) + +[2.6.252 CT_PythonScript [328](#ct_pythonscript)](#ct_pythonscript) + +[2.6.253 CT_PythonScripts [329](#ct_pythonscripts)](#ct_pythonscripts) + +[2.6.254 CT_DXFComplementExt [329](#ct_dxfcomplementext)](#ct_dxfcomplementext) + +[2.6.255 CT_DXFComplement [330](#ct_dxfcomplement)](#ct_dxfcomplement) + +[2.6.256 CT_AggregationInfo [330](#ct_aggregationinfo)](#ct_aggregationinfo) + +[2.6.257 CT_FeatureSupport [330](#ct_featuresupport)](#ct_featuresupport) + +[2.6.258 CT_PivotCacheRichInfo [331](#ct_pivotcacherichinfo)](#ct_pivotcacherichinfo) + +[2.6.259 CT_Version [331](#ct_version)](#ct_version) + +[2.6.260 CT_WorkbookCompatibilityVersionExt [332](#ct_workbookcompatibilityversionext)](#ct_workbookcompatibilityversionext) + +[2.6.261 CT_ShowDataTypeIcons [332](#ct_showdatatypeicons)](#ct_showdatatypeicons) + +[2.6.262 CT_ShowDataTypeIconsCustomSheetViewExt [333](#ct_showdatatypeiconscustomsheetviewext)](#ct_showdatatypeiconscustomsheetviewext) + +[2.6.263 CT_ShowDataTypeIconsExt [333](#ct_showdatatypeiconsext)](#ct_showdatatypeiconsext) + +[2.6.264 CT_ExternalCodeServiceImageAsInputExt [333](#ct_externalcodeserviceimageasinputext)](#ct_externalcodeserviceimageasinputext) + +[2.6.265 CT_ExternalCodeServiceImageAsInput [334](#ct_externalcodeserviceimageasinput)](#ct_externalcodeserviceimageasinput) + +[2.6.266 CT_PivotAreaReferenceSubtotals [334](#ct_pivotareareferencesubtotals)](#ct_pivotareareferencesubtotals) + +[2.6.267 CT_PivotCacheDataSource [335](#ct_pivotcachedatasource)](#ct_pivotcachedatasource) + +[2.6.268 CT_PivotFieldSubtotals [335](#ct_pivotfieldsubtotals)](#ct_pivotfieldsubtotals) + +[2.6.269 CT_PivotItemSubtotal [336](#ct_pivotitemsubtotal)](#ct_pivotitemsubtotal) + +[2.6.270 CT_PivotSubtotalType [336](#ct_pivotsubtotaltype)](#ct_pivotsubtotaltype) + +[2.6.271 CT_PivotTableSubtotalLineItems [337](#ct_pivottablesubtotallineitems)](#ct_pivottablesubtotallineitems) + +[2.7 Simple Types [337](#simple-types)](#simple-types) + +[2.7.1 ST_Ref [337](#st_ref)](#st_ref) + +[2.7.2 ST_Sqref [337](#st_sqref)](#st_sqref) + +[2.7.3 ST_DispBlanksAs [338](#st_dispblanksas)](#st_dispblanksas) + +[2.7.4 ST_SparklineAxisMinMax [338](#st_sparklineaxisminmax)](#st_sparklineaxisminmax) + +[2.7.5 ST_SparklineType [339](#st_sparklinetype)](#st_sparklinetype) + +[2.7.6 ST_PivotShowAs [340](#st_pivotshowas)](#st_pivotshowas) + +[2.7.7 ST_DataBarDirection [340](#st_databardirection)](#st_databardirection) + +[2.7.8 ST_DataBarAxisPosition [341](#st_databaraxisposition)](#st_databaraxisposition) + +[2.7.9 ST_CfvoType [341](#st_cfvotype)](#st_cfvotype) + +[2.7.10 ST_IconSetType [342](#st_iconsettype)](#st_iconsettype) + +[2.7.11 ST_PivotEditValueType [344](#st_pivoteditvaluetype)](#st_pivoteditvaluetype) + +[2.7.12 ST_AllocationMethod [345](#st_allocationmethod)](#st_allocationmethod) + +[2.7.13 ST_SlicerStyleType [345](#st_slicerstyletype)](#st_slicerstyletype) + +[2.7.14 ST_ObjectType [346](#st_objecttype)](#st_objecttype) + +[2.7.15 ST_Checked [347](#st_checked)](#st_checked) + +[2.7.16 ST_DropStyle [348](#st_dropstyle)](#st_dropstyle) + +[2.7.17 ST_SelType [348](#st_seltype)](#st_seltype) + +[2.7.18 ST_EditValidation [349](#st_editvalidation)](#st_editvalidation) + +[2.7.19 ST_OlapSlicerCacheSortOrder [349](#st_olapslicercachesortorder)](#st_olapslicercachesortorder) + +[2.7.20 ST_TabularSlicerCacheSortOrder [350](#st_tabularslicercachesortorder)](#st_tabularslicercachesortorder) + +[2.7.21 ST_SlicerCacheCrossFilter [350](#st_slicercachecrossfilter)](#st_slicercachecrossfilter) + +[2.7.22 ST_TextHAlign [351](#st_texthalign)](#st_texthalign) + +[2.7.23 ST_TextVAlign [352](#st_textvalign)](#st_textvalign) + +[2.7.24 ST_TimelineStyleType [352](#st_timelinestyletype)](#st_timelinestyletype) + +[2.7.25 ST_CalcMemNumberFormat [353](#st_calcmemnumberformat)](#st_calcmemnumberformat) + +[2.7.26 ST_SXVCellType [354](#st_sxvcelltype)](#st_sxvcelltype) + +[2.7.27 ST_QuestionType [355](#st_questiontype)](#st_questiontype) + +[2.7.28 ST_QuestionFormat [355](#st_questionformat)](#st_questionformat) + +[2.7.29 ST_SurveyPosition [356](#st_surveyposition)](#st_surveyposition) + +[2.7.30 ST_ModelTimeGroupingContentType [357](#st_modeltimegroupingcontenttype)](#st_modeltimegroupingcontenttype) + +[2.7.31 ST_Xrevid [358](#st_xrevid)](#st_xrevid) + +[2.7.32 ST_ArrayValueType [358](#st_arrayvaluetype)](#st_arrayvaluetype) + +[2.7.33 ST_RichFormatPropertyType [359](#st_richformatpropertytype)](#st_richformatpropertytype) + +[2.7.34 ST_RichValueFallbackType [359](#st_richvaluefallbacktype)](#st_richvaluefallbacktype) + +[2.7.35 ST_RichValueValueType [360](#st_richvaluevaluetype)](#st_richvaluevaluetype) + +[2.7.36 ST_SupportingPropertyBagArrayValueType [361](#st_supportingpropertybagarrayvaluetype)](#st_supportingpropertybagarrayvaluetype) + +[2.7.37 ST_SupportingPropertyBagValueType [361](#st_supportingpropertybagvaluetype)](#st_supportingpropertybagvaluetype) + +[2.7.38 ST_RichFilterKey [362](#st_richfilterkey)](#st_richfilterkey) + +[2.7.39 ST_AggregationType [363](#st_aggregationtype)](#st_aggregationtype) + +[3 Structure Examples [364](#structure-examples)](#structure-examples) + +[3.1 Slicer [364](#slicer-1)](#slicer-1) + +[3.1.1 Slicer Cache Part [365](#slicer-cache-part)](#slicer-cache-part) + +[3.1.2 Slicer Part [366](#slicer-part)](#slicer-part) + +[4 Security Considerations [368](#security-considerations)](#security-considerations) + +[4.1 Security Considerations for Implementers [368](#security-considerations-for-implementers)](#security-considerations-for-implementers) + +[4.2 Index of Security Fields [368](#index-of-security-fields)](#index-of-security-fields) + +[5 Appendix A: Full XML Schema [369](#appendix-a-full-xml-schema)](#appendix-a-full-xml-schema) + +[5.1 http://schemas.microsoft.com/office/excel/2006/main Schema [371](#httpschemas.microsoft.comofficeexcel2006main-schema)](#httpschemas.microsoft.comofficeexcel2006main-schema) + +[5.2 http://schemas.microsoft.com/office/drawing/2010/slicer Schema [371](#httpschemas.microsoft.comofficedrawing2010slicer-schema)](#httpschemas.microsoft.comofficedrawing2010slicer-schema) + +[5.3 http://schemas.microsoft.com/office/spreadsheetml/2010/11/main Schema [372](#httpschemas.microsoft.comofficespreadsheetml201011main-schema)](#httpschemas.microsoft.comofficespreadsheetml201011main-schema) + +[5.4 http://schemas.microsoft.com/office/spreadsheetml/2009/9/main Schema [379](#httpschemas.microsoft.comofficespreadsheetml20099main-schema)](#httpschemas.microsoft.comofficespreadsheetml20099main-schema) + +[5.5 http://schemas.microsoft.com/office/spreadsheetml/2009/9/ac Schema [393](#httpschemas.microsoft.comofficespreadsheetml20099ac-schema)](#httpschemas.microsoft.comofficespreadsheetml20099ac-schema) + +[5.6 http://schemas.microsoft.com/office/spreadsheetml/2011/1/ac Schema [393](#httpschemas.microsoft.comofficespreadsheetml20111ac-schema)](#httpschemas.microsoft.comofficespreadsheetml20111ac-schema) + +[5.7 http://schemas.microsoft.com/office/drawing/2012/timeslicer Schema [394](#httpschemas.microsoft.comofficedrawing2012timeslicer-schema)](#httpschemas.microsoft.comofficedrawing2012timeslicer-schema) + +[5.8 http://schemas.microsoft.com/office/excel/2010/spreadsheetDrawing Schema [394](#httpschemas.microsoft.comofficeexcel2010spreadsheetdrawing-schema)](#httpschemas.microsoft.comofficeexcel2010spreadsheetdrawing-schema) + +[5.9 http://schemas.microsoft.com/office/spreadsheetml/2010/11/ac Schema [395](#httpschemas.microsoft.comofficespreadsheetml201011ac-schema)](#httpschemas.microsoft.comofficespreadsheetml201011ac-schema) + +[5.10 http://schemas.microsoft.com/office/spreadsheetml/2014/11/main Schema [395](#httpschemas.microsoft.comofficespreadsheetml201411main-schema)](#httpschemas.microsoft.comofficespreadsheetml201411main-schema) + +[5.11 http://schemas.microsoft.com/office/spreadsheetml/2015/02/main Schema [396](#httpschemas.microsoft.comofficespreadsheetml201502main-schema)](#httpschemas.microsoft.comofficespreadsheetml201502main-schema) + +[5.12 http://schemas.microsoft.com/office/spreadsheetml/2016/revision10 Schema [396](#httpschemas.microsoft.comofficespreadsheetml2016revision10-schema)](#httpschemas.microsoft.comofficespreadsheetml2016revision10-schema) + +[5.13 http://schemas.microsoft.com/office/spreadsheetml/2016/revision9 Schema [396](#httpschemas.microsoft.comofficespreadsheetml2016revision9-schema)](#httpschemas.microsoft.comofficespreadsheetml2016revision9-schema) + +[5.14 http://schemas.microsoft.com/office/spreadsheetml/2016/revision6 Schema [396](#httpschemas.microsoft.comofficespreadsheetml2016revision6-schema)](#httpschemas.microsoft.comofficespreadsheetml2016revision6-schema) + +[5.15 http://schemas.microsoft.com/office/spreadsheetml/2014/revision Schema [397](#httpschemas.microsoft.comofficespreadsheetml2014revision-schema)](#httpschemas.microsoft.comofficespreadsheetml2014revision-schema) + +[5.16 http://schemas.microsoft.com/office/spreadsheetml/2015/revision2 Schema [397](#httpschemas.microsoft.comofficespreadsheetml2015revision2-schema)](#httpschemas.microsoft.comofficespreadsheetml2015revision2-schema) + +[5.17 http://schemas.microsoft.com/office/spreadsheetml/2016/revision3 Schema [397](#httpschemas.microsoft.comofficespreadsheetml2016revision3-schema)](#httpschemas.microsoft.comofficespreadsheetml2016revision3-schema) + +[5.18 http://schemas.microsoft.com/office/spreadsheetml/2016/revision5 Schema [398](#httpschemas.microsoft.comofficespreadsheetml2016revision5-schema)](#httpschemas.microsoft.comofficespreadsheetml2016revision5-schema) + +[5.19 http://schemas.microsoft.com/office/spreadsheetml/2016/pivotdefaultlayout Schema [398](#httpschemas.microsoft.comofficespreadsheetml2016pivotdefaultlayout-schema)](#httpschemas.microsoft.comofficespreadsheetml2016pivotdefaultlayout-schema) + +[5.20 http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 Schema [398](#httpschemas.microsoft.comofficespreadsheetml2017richdata2-schema)](#httpschemas.microsoft.comofficespreadsheetml2017richdata2-schema) + +[5.21 http://schemas.microsoft.com/office/spreadsheetml/2017/richdata Schema [403](#httpschemas.microsoft.comofficespreadsheetml2017richdata-schema)](#httpschemas.microsoft.comofficespreadsheetml2017richdata-schema) + +[5.22 http://schemas.microsoft.com/office/spreadsheetml/2018/calcfeatures Schema [404](#httpschemas.microsoft.comofficespreadsheetml2018calcfeatures-schema)](#httpschemas.microsoft.comofficespreadsheetml2018calcfeatures-schema) + +[5.23 http://schemas.microsoft.com/office/spreadsheetml/2018/threadedcomments Schema [404](#httpschemas.microsoft.comofficespreadsheetml2018threadedcomments-schema)](#httpschemas.microsoft.comofficespreadsheetml2018threadedcomments-schema) + +[5.24 http://schemas.microsoft.com/office/spreadsheetml/2018/08/main Schema [405](#httpschemas.microsoft.comofficespreadsheetml201808main-schema)](#httpschemas.microsoft.comofficespreadsheetml201808main-schema) + +[5.25 http://schemas.microsoft.com/office/spreadsheetml/2017/dynamicarray Schema [406](#httpschemas.microsoft.comofficespreadsheetml2017dynamicarray-schema)](#httpschemas.microsoft.comofficespreadsheetml2017dynamicarray-schema) + +[5.26 http://schemas.microsoft.com/office/spreadsheetml/2019/namedsheetviews Schema [406](#httpschemas.microsoft.comofficespreadsheetml2019namedsheetviews-schema)](#httpschemas.microsoft.comofficespreadsheetml2019namedsheetviews-schema) + +[5.27 http://schemas.microsoft.com/office/spreadsheetml/2019/extlinksprops Schema [407](#httpschemas.microsoft.comofficespreadsheetml2019extlinksprops-schema)](#httpschemas.microsoft.comofficespreadsheetml2019extlinksprops-schema) + +[5.28 http://schemas.microsoft.com/office/spreadsheetml/2020/richdatawebimage Schema [407](#httpschemas.microsoft.comofficespreadsheetml2020richdatawebimage-schema)](#httpschemas.microsoft.comofficespreadsheetml2020richdatawebimage-schema) + +[5.29 http://schemas.microsoft.com/office/spreadsheetml/2020/pivotNov2020 Schema [408](#httpschemas.microsoft.comofficespreadsheetml2020pivotnov2020-schema)](#httpschemas.microsoft.comofficespreadsheetml2020pivotnov2020-schema) + +[5.30 http://schemas.microsoft.com/office/spreadsheetml/2020/threadedcomments2 Schema [408](#httpschemas.microsoft.comofficespreadsheetml2020threadedcomments2-schema)](#httpschemas.microsoft.comofficespreadsheetml2020threadedcomments2-schema) + +[5.31 http://schemas.microsoft.com/office/spreadsheetml/2020/richvaluerefresh Schema [409](#httpschemas.microsoft.comofficespreadsheetml2020richvaluerefresh-schema)](#httpschemas.microsoft.comofficespreadsheetml2020richvaluerefresh-schema) + +[5.32 http://schemas.microsoft.com/office/spreadsheetml/2022/pivotVersionInfo Schema [409](#httpschemas.microsoft.comofficespreadsheetml2022pivotversioninfo-schema)](#httpschemas.microsoft.comofficespreadsheetml2022pivotversioninfo-schema) + +[5.33 http://schemas.microsoft.com/office/spreadsheetml/2022/pivotRichData Schema [410](#httpschemas.microsoft.comofficespreadsheetml2022pivotrichdata-schema)](#httpschemas.microsoft.comofficespreadsheetml2022pivotrichdata-schema) + +[5.34 http://schemas.microsoft.com/office/spreadsheetml/2021/extlinks2021 Schema [410](#httpschemas.microsoft.comofficespreadsheetml2021extlinks2021-schema)](#httpschemas.microsoft.comofficespreadsheetml2021extlinks2021-schema) + +[5.35 http://schemas.microsoft.com/office/spreadsheetml/2022/richvaluerel Schema [410](#httpschemas.microsoft.comofficespreadsheetml2022richvaluerel-schema)](#httpschemas.microsoft.comofficespreadsheetml2022richvaluerel-schema) + +[5.36 http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag Schema [411](#httpschemas.microsoft.comofficespreadsheetml2022featurepropertybag-schema)](#httpschemas.microsoft.comofficespreadsheetml2022featurepropertybag-schema) + +[5.37 http://schemas.microsoft.com/office/spreadsheetml/2023/msForms Schema [412](#httpschemas.microsoft.comofficespreadsheetml2023msforms-schema)](#httpschemas.microsoft.comofficespreadsheetml2023msforms-schema) + +[5.38 http://schemas.microsoft.com/office/spreadsheetml/2023/externalCodeService Schema [413](#httpschemas.microsoft.comofficespreadsheetml2023externalcodeservice-schema)](#httpschemas.microsoft.comofficespreadsheetml2023externalcodeservice-schema) + +[5.39 http://schemas.microsoft.com/office/spreadsheetml/2023/python Schema [413](#httpschemas.microsoft.comofficespreadsheetml2023python-schema)](#httpschemas.microsoft.comofficespreadsheetml2023python-schema) + +[5.40 http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation Schema [414](#httpschemas.microsoft.comofficespreadsheetml2023pivot2023calculation-schema)](#httpschemas.microsoft.comofficespreadsheetml2023pivot2023calculation-schema) + +[5.41 http://schemas.microsoft.com/office/spreadsheetml/2024/pivotAutoRefresh Schema [415](#httpschemas.microsoft.comofficespreadsheetml2024pivotautorefresh-schema)](#httpschemas.microsoft.comofficespreadsheetml2024pivotautorefresh-schema) + +[5.42 http://schemas.microsoft.com/office/spreadsheetml/2024/workbookCompatibilityVersion Schema [415](#httpschemas.microsoft.comofficespreadsheetml2024workbookcompatibilityversion-schema)](#httpschemas.microsoft.comofficespreadsheetml2024workbookcompatibilityversion-schema) + +[5.43 http://schemas.microsoft.com/office/spreadsheetml/2023/showDataTypeIcons Schema [416](#httpschemas.microsoft.comofficespreadsheetml2023showdatatypeicons-schema)](#httpschemas.microsoft.comofficespreadsheetml2023showdatatypeicons-schema) + +[5.44 http://schemas.microsoft.com/office/spreadsheetml/2025/externalCodeService2 Schema [416](#httpschemas.microsoft.comofficespreadsheetml2025externalcodeservice2-schema)](#httpschemas.microsoft.comofficespreadsheetml2025externalcodeservice2-schema) + +[5.45 http://schemas.microsoft.com/office/spreadsheetml/2025/pivotDataSource Schema [416](#httpschemas.microsoft.comofficespreadsheetml2025pivotdatasource-schema)](#httpschemas.microsoft.comofficespreadsheetml2025pivotdatasource-schema) + +[5.46 http://schemas.microsoft.com/office/spreadsheetml/2026/pivotDataSourceClean Schema [417](#httpschemas.microsoft.comofficespreadsheetml2026pivotdatasourceclean-schema)](#httpschemas.microsoft.comofficespreadsheetml2026pivotdatasourceclean-schema) + +[6 Appendix B: Product Behavior [418](#appendix-b-product-behavior)](#appendix-b-product-behavior) + +[7 Change Tracking [428](#change-tracking)](#change-tracking) + +[8 Index [429](#index)](#index) + +# Introduction + +The Excel (.xlsx) Extensions to the Office Open XML SpreadsheetML File Format specifies extensions to the Office Open XML file formats described in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). The extensions are specified using conventions provided by the Office Open XML file formats described in [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154). The extensions are a collection of structures and parts in a container that specify appropriate content, which can include unstructured or semi-structured tables of numbers, text, or both numbers and text, equations or functions, external [**data connections**](#gt_024a24fb-c1c0-4393-ab0c-f0e3e3f41629), charts, and images. Content in such a container is typically organized in a grid-based layout, and often includes numeric data, structured data, and formulas. + +Sections 1.7 and 2 of this specification are normative. All other sections and examples in this specification are informative. + +## Glossary + +This document uses the following terms: + +> **add-in**: Supplemental functionality that is provided by an external application or macro to extend the capabilities of an application. +> +> **adjacent cell**: A cell that is in the same row as and adjoins the current cell in a worksheet. +> +> **aggregation function**: A function, such as sum or average, that appears in the total row of a table and is used to summarize data. +> +> **attribute**: A characteristic of some object or entity, typically encoded as a name/value pair. +> +> **Augmented Backus-Naur Form (ABNF)**: A modified version of Backus-Naur Form (BNF), commonly used by Internet specifications. ABNF notation balances compactness and simplicity with reasonable representational power. ABNF differs from standard BNF in its definitions and uses of naming rules, repetition, alternatives, order-independence, and value ranges. For more information, see [\[RFC5234\]](https://go.microsoft.com/fwlink/?LinkId=123096). +> +> **AutoComplete**: A feature that suggests text automatically based on the first few characters that a user types. +> +> **AutoFilter**: A mechanism that can be used to filter tabular data based on user-defined criteria such as values, strings, and formatting. +> +> **binary large image or picture (BLIP)**: A binary data structure that stores information about a metafile image or bitmap picture. +> +> **Boolean**: An operation or expression that can be evaluated only as either true or false. +> +> **bottom N filter**: A filter that matches the smallest numerical values or oldest time and date values in a specified range. +> +> **calculate**: The process by which computations in a workbook are performed. +> +> **calculated column**: A [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) in a table that contains a formula that is copied automatically to each record in the column. +> +> **cell**: A box that is formed by the intersection of a [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) and a [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) in a worksheet or a table. A cell can contain numbers, strings, and formulas, and various formats can be applied to that data. +> +> **Cell Control**: A user interactable graphic representation of the data inside the specified cell. +> +> **cell error value**: Any of a number of special values that are returned as a result of an unsuccessful formula calculation. +> +> **cell reference**: A set of coordinates that a cell occupies on a worksheet. For example, "B3" is the reference of a cell that appears at the intersection of column "B" and row "3". +> +> **cell value**: The text or numeric content of a cell, or the results of a formula. A cell value does not include a formula expression, cell formatting, or other metadata. +> +> **character set**: A mapping between the characters of a written language and the values that are used to represent those characters to a computer. +> +> **color scale**: A specific range of colors that is used to give additional meaning to data by assigning certain values to colors in the spectrum. +> +> **column**: A single set of data that is displayed vertically in a worksheet or a table. +> +> **comment**: An annotation that is associated with a cell, text, or other object to provide context-specific information or reviewer feedback. +> +> **comment thread**: A collection of annotations that is associated with a cell to provide context-specific information, viewer feedback and collaborative discussion, which is made of a main comment and its replies, if there are any. +> +> **condition**: A logical expression comparing one or more properties in all incoming Message objects against a set of clauses. This logical expression can evaluate to TRUE or FALSE. +> +> **conditional formatting**: A mechanism that changes the appearance of a user interface element based on the evaluation of a rule or expression. +> +> **control**: A graphical user interface object that users interact with when working with applications, forms, documents, webpages, and other types of files. +> +> **credential**: Previously established, authentication data that is used by a security principal to establish its own identity. When used in reference to the Netlogon Protocol, it is the data that is stored in the NETLOGON_CREDENTIAL structure. +> +> **cube function**: A function that is used to extract and display Online Analytical Processing (OLAP) data sets and values. +> +> **custom filter**: A filter that contains preconfigured expressions in which users can optionally enter a string to filter data. +> +> **custom list**: A user-defined list or enumeration that can be used to sort data in a worksheet. +> +> **data bar**: A graphical representation of cell content as a bar graph. +> +> **data connection**: A collection of information, such as the type and location, that defines how to connect to an external data source, such as a database, web service, SharePoint list, or [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) file. +> +> **data marker**: A customizable symbol or shape that identifies a data point on a line, scatter, or radar chart. A data marker can be formatted with various sizes and colors. +> +> **data point**: A representation of a PivotTable item in a PivotTable data field contained in a PivotChart report. +> +> **data provider**: A known data source that is specific to a target type and that provides data to a collector type. +> +> **data source**: A database, web service, disk, file, or other collection of information from which data is queried or submitted. Supported data sources vary based on application and data provider. +> +> **data table**: A range of cells that is designated to perform what-if analysis for formulas, based on various input values. +> +> **data type**: A property of a field that defines the kind of data that is stored in the field, or defines the kind of data returned by an expression when the expression is evaluated. +> +> **data validation**: The process of testing the accuracy of data; a set of rules that specify the type and range of data that users can enter. +> +> **defined name**: A word or string of characters in a formula that represents a cell, range of cells, formula, or constant value. +> +> **descendant**: A member that is below the current member in a hierarchy. +> +> **dimension**: A structural attribute of a cube, which is an organized hierarchy of categories (levels) that describe data in a fact table. These categories typically describe a similar set of members upon which the user bases an analysis. +> +> **display folder**: A folder into which attributes, measures, calculated members, and key performance indicators can be organized to facilitate browsing. +> +> **drillthrough**: A query that is used to retrieve individual records that were used to calculate an aggregate value. +> +> **dynamic array**: An array resulting from a formula whose dimensions can change when the formula is evaluated. +> +> **email address**: A string that identifies a user and enables the user to receive Internet messages. +> +> **English Metric Unit (EMU)**: A measurement in computer typography. There are 635 EMUs per twip, 6,350 EMUs per half-point, 12,700 EMUs per point, and 914,400 EMUs per inch. These units are used to translate on-screen layouts to printed layouts for specified printer hardware. +> +> **external code service**: An external service responsible for executing code and returning result or error. +> +> **feature property bag**: A set of GLOSSARY: \[key value pairs (KVP)\]. A feature property bag can reference other feature property bags. +> +> **field**: An element or [**attribute**](#gt_108a1419-49a9-4d19-b6ca-7206aa726b3f) in a data source that can contain data. +> +> **filter**: A mechanism by which a set of data is scoped to display only those entries that meet specified logical criteria. +> +> **formula**: A logical equation or function that produces a result in a spreadsheet application. +> +> **future function**: A function that can be written to but is not implemented in a file. +> +> **globally unique identifier (GUID)**: A term used interchangeably with universally unique identifier (UUID) in Microsoft protocol technical documents (TDs). Interchanging the usage of these terms does not imply or require a specific algorithm or mechanism to generate the value. Specifically, the use of this term does not imply or require that the algorithms described in [\[RFC4122\]](https://go.microsoft.com/fwlink/?LinkId=90460) or [\[C706\]](https://go.microsoft.com/fwlink/?LinkId=89824) have to be used for generating the GUID. See also universally unique identifier (UUID). +> +> **hash**: A fixed-size result that is obtained by applying a one-way mathematical function, which is sometimes referred to as a hash algorithm, to an arbitrary amount of data. If the input data changes, the hash also changes. The hash can be used in many operations, including authentication and digital signing. +> +> **Help topic identifier**: A unique identifier for an article that contains Help content. +> +> **hidden**: A condition of an object that prevents it from being displayed in rendered output. +> +> **hierarchy**: A logical tree structure that organizes the members of a dimension such that each member has one parent member and zero or more child members. +> +> **icon**: A graphical image used to supplement alphanumeric text in the visual identification of an object on a computer monitor. [**Icons**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) are typically small, relative to the size of the area on which they are displayed. +> +> **icon set**: A collection of icons that can be used to comment and classify data into categories. +> +> **ink**: A process of entering text in handwritten form. Instead of converting handwritten text to typed text, ink is converted to an object and displayed exactly as it was written. +> +> **Input Method Editor (IME)**: An application that is used to enter characters in written Asian languages by using a standard 101-key keyboard. An IME consists of both an engine that converts keystrokes into phonetic and ideographic characters and a dictionary of commonly used ideographic words. +> +> **key value pair (KVP)**: A set of two linked data items: a key that is an identifier for some data item, and a value that is a value associated with the data item for the identifier represented by the key. +> +> **left-to-right**: A reading order in which characters in words are read from left to right, and words are read from left to right in sentences. +> +> **locale**: A collection of rules and data that are specific to a language and a geographical area. A locale can include information about sorting rules, date and time formatting, numeric and monetary conventions, and character classification. +> +> **localize**: The process of adapting an application or documentation, including text and non-text elements, to meet the language, cultural, and political expectations and requirements of a specific geographic country or region. +> +> **locked**: The condition of a cell, worksheet, or other object that restricts edits or modifications to it by users. +> +> **MDX unique name**: A unique identifier for a multidimensional expression (MDX) member or value in a given Online Analytical Processing (OLAP) cube, for example "\[Customer\].\[Customer Geography\].\[Country\].&\[Australia\]". +> +> **measure**: In a cube, a set of values that are typically numeric and are based on a column in the fact table of the cube. Measures are the central values that are aggregated and analyzed. +> +> **mention**: A part of a threaded comment that provides a reference to a person's information. +> +> **Multidimensional Expressions (MDX)**: A syntax that is used for defining multidimensional objects, and for querying and manipulating multidimensional data. +> +> **named sheet view**: A named set of sort and/or filter conditions that can be easily restored onto a given sheet. +> +> **nsvfilter**: A set of sort and/or filter conditions associated with a single autofilter. Part of a named sheet view. +> +> **Object Linking and Embedding (OLE)**: A technology for transferring and sharing information between applications by inserting a file or part of a file into a compound document. The inserted file can be either embedded or linked. See also embedded object and linked object. +> +> **object model**: A collection of object-oriented APIs that represent data structures and are designed to promote software interoperability. +> +> **OLAP All level**: An optional level at the top of a hierarchy. It typically contains an [**OLAP All member**](#gt_5cc9c818-a2ec-4ab8-94ad-86d759ff030b) that represents an aggregation of all of the lower-level members of that hierarchy. +> +> **OLAP All member**: A multidimensional expression (MDX) that evaluates a hierarchy and returns a set that contains all of the members of the specified hierarchy. +> +> **OLAP allocation**: An operation in which the values for members at lower levels in an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) are changed based on changes to values for members at higher levels in that hierarchy. +> +> **OLAP hierarchy**: An attribute hierarchy or a user-defined hierarchy in a data structure. By default, each dimension [**attribute**](#gt_108a1419-49a9-4d19-b6ca-7206aa726b3f) has an attribute hierarchy. A user-defined hierarchy is a set of related attribute hierarchies that is used to facilitate browsing an OLAP cube. +> +> **OLAP level**: Within an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c), a set of data that is organized into a lower or higher level of detail, such as Year, Quarter, Month, and Day levels in a Time hierarchy. +> +> **OLAP measure**: A set of numeric values in an OLAP cube that is used in aggregation and analysis. +> +> **OLAP member**: An item that is in an [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168). For example, a Canada member in a Country level of a Geography hierarchy. +> +> **OLAP named set**: A collection of [**OLAP tuples**](#gt_3a1a687f-d28b-485b-96a0-ba0b7eb4119e) that have the same dimensionality. Also referred to as OLAP set. +> +> **OLAP subselect**: The ability to execute multiple SELECT commands in a FROM clause that is inside a multidimensional expression (MDX) statement. +> +> **OLAP tuple**: An ordered collection of members that are from different dimensions of an OLAP cube. A single member is a special case of a tuple. +> +> **OLAP weight expression**: A multidimensional expression (MDX) that is used to apply and allocate modified values to an [**Online Analytical Processing (OLAP)**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) provider. It typically returns a decimal value between "0" and "1". +> +> **OLE DB**: A set of interfaces that are based on the Component Object Model (COM) programming model and expose data from a variety of sources. These interfaces support the amount of Database Management System (DBMS) functionality that is appropriate for a data store and they enable a data store to share data. +> +> **Online Analytical Processing (OLAP)**: A technology that uses multidimensional structures to provide access to data for analysis. The source data for OLAP is stored in data warehouses in a relational database. See also cube. +> +> **PivotTable**: An interactive table that summarizes large amounts of data from various sources by using format and calculation methods. Row and column headings can be rotated to view different summaries of the source data, filter the data, or display detail data for specific areas. +> +> **PivotTable area**: A logical zone that is used to organize data in a PivotTable report. +> +> **PivotTable data field**: A PivotTable field that is contained in the PivotTable area where data values are shown. +> +> **PivotTable field**: An element in a PivotTable report that represents a logical collection of data. A PivotTable field can represent a dimension hierarchy or actual data values. +> +> **PivotTable field list**: A user interface element that displays a list of all of the fields in a PivotTable report. It can be used to populate a PivotTable report and to manipulate the fields. +> +> **pixel**: A discrete unit of display on a computer display device. +> +> **plot area**: A portion of a chart area that contains the plotted data and axes. +> +> **point**: A unit of measurement for fonts and spacing. A point is equal to 1/72 of an inch. +> +> **protection**: A mechanism that helps restrict users from making unwanted changes to the data or structure of a workbook. +> +> **Python environment**: A computational environment used to execute a Python script. +> +> **Python script**: executable code written in the Python programming language. +> +> **query table**: A two-dimensional table that presents data from an external data source. +> +> **range**: An addressable region that is in a workbook. A range typically consists of zero or more cells and represents a single, contiguous rectangle of cells on a single sheet. +> +> **rich array**: A type of rich value data that is a two-dimensional array of values. +> +> **rich value**: A complex representation of data that contains a [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100), a [**rich value fallback**](#gt_a90d0ec0-088b-4f60-a153-198666294d07), and a collection of [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f). A rich value can exist as the value of a cell or nested as the value in a key value pair. +> +> **rich value data**: The value part of the [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f). +> +> **rich value fallback**: A value that will be used for any feature that does not know how to interpret a given [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100). +> +> **rich value key**: The name of the key in the [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f). +> +> **rich value key flag**: A rich value flag assigned to a particular [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3). Each flag is assigned a Boolean value that indicates particular behaviors for the key. +> +> **rich value type**: A collection of required [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f) and key flag definitions. +> +> **right-to-left**: A reading and display order that is optimized for right-to-left languages. +> +> **root element**: The top-level element in an XML document. It contains all other elements and is not contained by any other element, as described in [\[XML\]](https://go.microsoft.com/fwlink/?LinkId=90598). +> +> **row**: A single set of data that is displayed horizontally in a worksheet or a table. +> +> **salt**: An additional random quantity, specified as input to an encryption function that is used to increase the strength of the encryption. +> +> **security descriptor**: A data structure containing the security information associated with a securable object. A [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) identifies an object's owner by its security identifier (SID). If access control is configured for the object, its [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) contains a discretionary access control list (DACL) with SIDs for the security principals who are allowed or denied access. Applications use this structure to set and query an object's security status. The [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) is used to guard access to an object as well as to control which type of auditing takes place when the object is accessed. The [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) format is specified in [\[MS-DTYP\]](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2) section 2.4.6; a string representation of [**security descriptors**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350), called SDDL, is specified in \[MS-DTYP\] section 2.5.1. +> +> **selected**: The condition of a set of items that has focus in a workbook. +> +> **service**: A process or agent that is available on the network, offering resources or services for clients. Examples of services include file servers, web servers, and so on. +> +> **shape**: A collection of qualifiers, such as names, and quantifiers, such as coordinates, that is used to represent a geometric object. A shape can be contained in a document, file structure, run-time structure, or other medium. +> +> **sheet**: A part of an Excel workbook. There are four types of sheets: [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615), macro sheet, dialog sheet, and chart sheet. Multiple sheets are stored together within a workbook. +> +> **sort**: A process that arranges cells in ascending or descending order, based on cell content. +> +> **sort condition**: A condition that determines how to sort cells in a range. +> +> **sort order**: A specific arrangement of cells that is based on cell content. The order can be ascending or descending. +> +> **source data**: The data that is used as the basis for charts, PivotTable reports, and other data visualization features. +> +> **sparkline**: A miniature chart that can be inserted into text or embedded in a cell on a worksheet to illustrate highs, lows, and trends in data. +> +> **spreadsheet data model**: A local [**Online Analytical Processing (OLAP)**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) storage of data used by a spreadsheet application. +> +> **style**: A set of formatting options that is applied to text, tables, charts, and other objects in a document. +> +> **supporting property bag**: A set of GLOSSARY: \[key value pairs (KVP)\]. A supporting property bag can exist as the value of a [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) or nested as the value in another supporting property bag. +> +> **supporting property bag array**: A type of [**supporting property bag data**](#gt_c7e57fec-f265-403b-accb-9fa4628addf8) that is a one-dimensional array of values. +> +> **supporting property bag data**: The value part of the [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f). +> +> **supporting property bag key**: The name of the key in a [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f). +> +> **table**: A list that is defined in a workbook. +> +> **threaded comment**: A comment in a comment thread. It can be a main comment or a reply. +> +> **top N filter**: A filter that matches the top or bottom N items or N% of items in a specified [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972). +> +> **Unicode**: A character encoding standard developed by the Unicode Consortium that represents almost all of the written languages of the world. The [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) standard [\[UNICODE5.0.0/2007\]](https://go.microsoft.com/fwlink/?LinkId=154659) provides three forms (UTF-8, UTF-16, and UTF-32) and seven schemes (UTF-8, UTF-16, UTF-16 BE, UTF-16 LE, UTF-32, UTF-32 LE, and UTF-32 BE). +> +> **Uniform Resource Locator (URL)**: A string of characters in a standardized format that identifies a document or resource on the World Wide Web. The format is as specified in [\[RFC1738\]](https://go.microsoft.com/fwlink/?LinkId=90287). +> +> **unique identifier (UID)**: A pair consisting of a [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) and a version sequence number to identify each resource uniquely. The UID is used to track the object for its entire lifetime through any number of times that the object is modified or renamed. +> +> **workbook**: A container for a collection of [**sheets**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). +> +> **worksheet**: A single logical container for a set of tabular data and other objects in a workbook. +> +> **XML**: The Extensible Markup Language, as described in [\[XML1.0\]](https://go.microsoft.com/fwlink/?LinkId=90599). +> +> **XML namespace**: A collection of names that is used to identify elements, types, and attributes in XML documents identified in a URI reference [\[RFC3986\]](https://go.microsoft.com/fwlink/?LinkId=90453). A combination of XML namespace and local name allows XML documents to use elements, types, and attributes that have the same names but come from different sources. For more information, see [\[XMLNS-2ED\]](https://go.microsoft.com/fwlink/?LinkId=90602). +> +> **XML schema definition (XSD)**: The World Wide Web Consortium (W3C) standard language that is used in defining XML schemas. Schemas are useful for enforcing structure and constraining the types of data that can be used validly within other XML documents. XML schema definition refers to the fully specified and currently recommended standard for use in authoring XML schemas. +> +> **XOR obfuscation**: A type of file encryption that helps protect private data by using an exclusive or bitwise operation. This is done by adding a mathematical expression that prevents a simple reverse-engineering process. +> +> **zoom level**: The degree to which a portion of an image, document, or other screen object is made to appear closer or farther away relative to its default appearance. This value is usually expressed as a percentage of the default appearance. +> +> **MAY, SHOULD, MUST, SHOULD NOT, MUST NOT:** These terms (in all caps) are used as defined in [\[RFC2119\]](https://go.microsoft.com/fwlink/?LinkId=90317). All statements of optional behavior use either MAY, SHOULD, or SHOULD NOT. + +## References + +Links to a document in the Microsoft Open Specifications library point to the correct section in the most recently published version of the referenced document. However, because individual documents in the library are not updated at the same time, the section numbers in the documents may not match. You can confirm the correct section numbering by checking the [Errata](https://go.microsoft.com/fwlink/?linkid=850906). + +### Normative References + +We conduct frequent surveys of the normative references to assure their continued availability. If you have any issue with finding a normative reference, please contact . We will assist you in finding the relevant information. + +\[CSS-Level2-2009\] World Wide Web Consortium, "Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification", W3C Candidate Recommendation 08 September 2009, [http://www.w3.org/TR/2009/CR-CSS2-20090908/](https://go.microsoft.com/fwlink/?LinkId=182880) + +\[ISO/IEC29500-1:2016\] ISO/IEC, "Information technology -- Document description and processing languages -- Office Open XML File Formats -- Part 1: Fundamentals and Markup Language Reference", ISO/IEC 29500-1:2016, [https://www.iso.org/standard/71691.html](https://go.microsoft.com/fwlink/?linkid=861065) + +\[ISO/IEC29500-3:2015\] ISO/IEC, "Information technology -- Document description and processing languages -- Office Open XML File Formats -- Part 3: Markup Compatibility and Extensibility", [https://www.iso.org/standard/65533.html](https://go.microsoft.com/fwlink/?linkid=861154) + +\[ISO/IEC29500-4:2016\] ISO/IEC, "Information technology -- Document description and processing languages -- Office Open XML File Formats -- Part 4: Transitional Migration Features", [https://www.iso.org/standard/71692.html](https://go.microsoft.com/fwlink/?linkid=861068) + +\[MS-DTYP\] Microsoft Corporation, "[Windows Data Types](%5bMS-DTYP%5d.pdf#Section_cca2742956894a16b2b49325d93e4ba2)". + +\[MS-ODRAWXML\] Microsoft Corporation, "[Office Drawing Extensions to Office Open XML Structure](%5bMS-ODRAWXML%5d.pdf#Section_06cff208c6e14db7bb68665135e5f0de)". + +\[MS-OFFCRYPTO\] Microsoft Corporation, "[Office Document Cryptography Structure](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083)". + +\[MS-OSHARED\] Microsoft Corporation, "[Office Common Data Types and Objects Structures](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d)". + +\[MS-OWEXML\] Microsoft Corporation, "[Office Web Extensibility Extensions to Office Open XML Structure Specification](%5bMS-OWEXML%5d.pdf#Section_a2cd741a4cca4b1aade4b2c443972afa)". + +\[MS-XLDM\] Microsoft Corporation, "[Spreadsheet Data Model File Format](%5bMS-XLDM%5d.pdf#Section_8c62e8cef605488d81e94ecdb7686a52)". + +\[MS-XLSB\] Microsoft Corporation, "[Excel (.xlsb) Binary File Format](%5bMS-XLSB%5d.pdf#Section_acc8aa921f02416799f584f9f676b95a)". + +\[RFC2119\] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997, [https://www.rfc-editor.org/info/rfc2119](https://go.microsoft.com/fwlink/?LinkId=90317) + +\[RFC3066\] Alvestrand, H., "Tags for the Identification of Languages", BCP 47, RFC 3066, January 2001, [https://www.rfc-editor.org/info/rfc3066](https://go.microsoft.com/fwlink/?LinkId=90404) + +\[RFC5234\] Crocker, D., Ed., and Overell, P., "Augmented BNF for Syntax Specifications: ABNF", STD 68, RFC 5234, January 2008, [https://www.rfc-editor.org/info/rfc5234](https://go.microsoft.com/fwlink/?LinkId=123096) + +\[RFC5646\] Phillips, A, and Davis, M., "Tags for Identifying Languages", BCP 47, RFC 4646, September 2006, [https://www.rfc-editor.org/info/rfc5646](https://go.microsoft.com/fwlink/?LinkId=528682) + +\[UNICODE5.1\] The Unicode Consortium, "The Unicode Standard, Version 5.1.0, defined by: The Unicode Standard, Version 5.0 (Boston, MA, Addison-Wesley, 2007. ISBN 0-321-48091-0), as amended by Unicode 5.1.0", [http://www.unicode.org/versions/Unicode5.1.0/](https://go.microsoft.com/fwlink/?LinkId=152822) + +\[W3C-XML\] Bray, T., Paoli, J., Sperberg-McQueen, C.M., Maler, E., Yergeau, F., Eds., "Extensible Markup Language (XML) 1.1 (Second Edition)", W3C Recommendation, August 2006, [http://www.w3.org/TR/2006/REC-xml11-20060816/](https://go.microsoft.com/fwlink/?LinkId=113935) + +\[XMLNS\] Bray, T., Hollander, D., Layman, A., et al., Eds., "Namespaces in XML 1.0 (Third Edition)", W3C Recommendation, December 2009, [https://www.w3.org/TR/2009/REC-xml-names-20091208/](https://go.microsoft.com/fwlink/?LinkId=191840) + +\[XMLSCHEMA1/2\] Thompson, H., Beech, D., Maloney, M., and Mendelsohn, N., Eds., "XML Schema Part 1: Structures Second Edition", W3C Recommendation, October 2004, [https://www.w3.org/TR/2004/REC-xmlschema-1-20041028/](https://go.microsoft.com/fwlink/?LinkId=90607) + +\[XMLSCHEMA2/2\] Biron, P., and Malhotra, A., Eds., "XML Schema Part 2: Datatypes Second Edition", W3C Recommendation, October 2004, [https://www.w3.org/TR/2004/REC-xmlschema-2-20041028/](https://go.microsoft.com/fwlink/?LinkId=90609) + +### Informative References + +\[ISO/IEC29500-2:2012\] ISO/IEC, "Information technology -- Document description and processing languages -- Office Open XML File Formats -- Part 2: Open Packaging Conventions", ISO/IEC 29500-2:2012, [http://www.iso.org/iso/home/store/catalogue_ics/catalogue_detail_ics.htm?csnumber=61796](https://go.microsoft.com/fwlink/?LinkID=330448) + +\[MS-AZOD\] Microsoft Corporation, "[Authorization Protocols Overview](%5bMS-AZOD%5d.pdf#Section_5a0a0a3ec7a742e1b5f2cc8d8bd9739e)". + +## Structure Overview (Synopsis) + +This document specifies spreadsheet-related extensions to Office Open XML file formats as described in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). [**Workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) data is contained in a ZIP package conforming to the Open Packaging Conventions as described in [\[ISO/IEC29500-2:2012\]](https://go.microsoft.com/fwlink/?LinkID=330448). Individual files stored in the ZIP package, called parts \[ISO/IEC29500-1:2016\], contain information about the content and structure of a workbook, including workbook data, such as [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) definitions. Some parts \[ISO/IEC29500-1:2016\]) store information by using [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) and other parts \[ISO/IEC29500-1:2016\] store information by using binary data. The extensions specified in this document use the conventions specified by [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154), and they are both structures within parts specified by \[ISO/IEC29500-1:2016\] and extension parts within the package described by \[ISO/IEC29500-2:2012\]. + +## Relationship to Protocols and Other Structures + +This file format is a specified set of extensions to Office Open XML SpreadsheetML, specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). This specification is dependent on the structures and concepts defined in the following references: + +- \[ISO/IEC29500-1:2016\] for baseline SpreadsheetML persistence format. + +- [\[ISO/IEC29500-2:2012\]](https://go.microsoft.com/fwlink/?LinkID=330448) for open packaging conventions. + +- [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) for markup compatibility and extensibility. + +- [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) for backward compatibility considerations. + +- [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) for the persistence format for document signing, information rights management, document encryption, and obfuscation. + +- [\[MS-ODRAWXML\]](%5bMS-ODRAWXML%5d.pdf#Section_06cff208c6e14db7bb68665135e5f0de) for the persistence format for [**shapes**](#gt_d0e38aa4-2c71-4a6f-b5e6-75766fa9409e). + +## Applicability Statement + +This document specifies a persistence format for extensions to Office Open XML file formats as described in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) SpreadsheetML documents. The extensions specified in this document allow for expressing additional content and properties, and are not applicable as a stand-alone file format. Each structure specified in this document is integrated with SpreadsheetML documents as described in \[ISO/IEC29500-1:2016\] in a particular way, as specified in the section for that structure. All structures are integrated into SpreadsheetML documents in such a way that maintains compatibility with implementations of the Office Open XML file formats as described in \[ISO/IEC29500-1:2016\]. + +The extensions specified in this document do not require any other extensions to be used, and do not prohibit any other extensions from being used in the same document. + +This persistence format provides interoperability with applications that create or read documents conforming to this structure. + +## Versioning and Localization + +This document covers versioning issues in the following areas: + +- **Structure Versions:** There is only one version of Excel Extensions to the Office Open XML SpreadsheetML File Format. + +- **Localization:** The [CT_ProtectedRange](#Section_85f5567f259941adae268cfab23ce754) structure contains [**fields**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) that specify locale-dependent meaning. + +The [Security Considerations](#Section_3bcf2f2b819f43989a3a4edfac42a5d2) section also specifies processes and data that are locale-dependent. See each structure and section description for more information. + +## Vendor-Extensible Fields + +Specified in this document are extensions, using conventions described in [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154), both as structures within parts described in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) and as extension parts within the package described in [\[ISO/IEC29500-2:2012\]](https://go.microsoft.com/fwlink/?LinkID=330448). Implementations are not required to preserve or remove additional parts when modifying an existing document. See \[ISO/IEC29500-3:2015\] for more information. + +# Structures + +In the following sections, the schema definition might be less restrictive than the processing rules imposed by the application. The XSD in this specification provides a base description of the file format. The text that introduces the XSD specifies additional restrictions that reflect actual Microsoft product behavior. For example, the schema definition might allow for an element to be empty, null, or not present but the behavior of the application as specified restricts the same elements to being non-empty, not null, and present. + +## Part Enumerations + +This section specifies parts in this file format that extend Office Open XML file formats as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +### Control Properties + +Content type: application /vnd.ms-excel.controlproperties+xml + +Source relationship: http://schemas.openxmlformats.org/officeDocument/2006/relationships/ctrlProp + +An instance of this part type specifies the properties of a form [**control**](#gt_3c89d16f-a826-4166-96ab-bf13e65b1a40) embedded object in the package. A package can contain one or more control properties parts, and each part MUST be the target of an explicit relationship from a SpreadsheetML control, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.3.1.19. + +If this relationship is present, the control MUST NOT have a relationship with an embedded control persistence part, as specified in \[ISO/IEC29500-1:2016\] section 15.2.9. + +The syntax of the structures contained in this part uses [**XML schema definition (XSD)**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **formControlPr** element, as specified in section [2.4.34](#Section_24baf70c49ec4d3c81fa133e8681490d). + +### Custom Data + +Content type: application /binary + +Source relationship: http://schemas.openxmlformats.org/officeDocument/2006/relationships/customData + +An instance of this part type specifies user-defined binary data. + +A package MUST contain at most one custom data part per custom data properties part, as specified in section [2.1.3](#Section_1f4aa666c9664ecf839928390399c891), and that part MUST be the target of an implicit relationship from a custom data properties part. + +A custom data part MUST NOT have any implicit or explicit relationships to any other part specified by this protocol. + +The content of this part consists of user-defined binary data that is stored on behalf of [**add-ins**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6). The content is not specified in this protocol. + +### Custom Data Properties + +Content type: application /vnd.openxmlformats-officedocument.customDataProperties+xml + +Source relationship: http://schemas.openxmlformats.org/officeDocument/2006/relationships/customDataProps + +An instance of this part type specifies a single custom data properties part. This part specifies properties for the associated custom data part, as specified in section [2.1.2](#Section_7c53f6f4fea843f7a4b0ba6e14d0eb78), specifically a [**unique identifier (UID)**](#gt_3d9dd73b-8923-43cc-ac95-8103f17683d7) for the data storage. + +A custom data properties part MUST be the target of an implicit relationship from the workbook part, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 12.3.23. + +A custom data properties part is permitted to contain implicit relationships to the custom data part specified in section 2.1.2. + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **datastoreItem** element, as specified in section [2.4.35](#Section_f9d99df8f3734f38b47b1b9b147c4537). + +### Slicer Cache + +Content type: application /vnd.ms-excel.slicerCache+xml + +Source relationship: http://schemas.microsoft.com/office/2007/relationships/slicerCache + +An instance of this part type specifies a single slicer cache part, as specified in section [3.1.1](#Section_e7eda20cc65e45ed9540de59c4a07b7d), in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +A package MUST contain one slicer cache part per **CT_SlicerCache** element, as specified in section [2.6.14](#Section_42f75f7ac5214e4b86d30d1e1f89aa0b), in the workbook part, a specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 12.3.23, and that part MUST be the target of an explicit relationship from the workbook part. + +A slicer cache part MUST NOT have implicit or explicit relationships to any part specified by this protocol. + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) . + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **slicerCacheDefinition** element, as specified in section [2.4.38](#Section_13e66a54691846989e584905a7b02ab5). + +### Slicers + +Content type: application/vnd.ms-excel.slicer+xml + +Source relationship: http://schemas.microsoft.com/office/2007/relationships/slicer + +An instance of this part type specifies the slicer views, as specified in section [2.3.2.2](#Section_69c0e0f9d0144bd59f2d2f554c715083), for a single [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +The presence of a slicers part indicates that there is at least one slicer view on the associated worksheet, and that this part MUST be the target of an explicit relationship from the worksheet part, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 12.3.24. + +A slicers part MUST NOT have implicit or explicit relationships to any part specified by this protocol. + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **slicers** element, as specified in section [2.4.36](#Section_97d22959035a43f69a8392a36e3f07a8). + +### Data Model + +Content type: application/vnd.openxmlformats-officedocument.model+data + +The presence of a model part indicates that there is a [**spreadsheet data model**](#gt_95ac50ee-8fc4-4dce-85e0-984684a68319) present in the workbook. + +The content of this part is specified in [\[MS-XLDM\]](%5bMS-XLDM%5d.pdf#Section_8c62e8cef605488d81e94ecdb7686a52). In addition, this specification is extended by the **Annotations** property on different objects. Unless otherwise specified, all extensions in an **Annotations** object are written as [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85). + +#### Command Annotations + +The **Annotations** property of a command object describing a [**measure**](#gt_70548cb6-ef0e-4f2a-8e34-7293a9df8998) ([\[MS-XLDM\]](%5bMS-XLDM%5d.pdf#Section_8c62e8cef605488d81e94ecdb7686a52) section 2.6.9) can be extended with the following optional properties: + +**Type**: MUST be either "Implicit" or "Explicit". "Implicit" specifies that the measure was created in the [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) list. "Explicit" specifies that the measure was created by the user specifying the definition of the measure. + +**Name:** Specifies the name of the measure. MUST exist if **Type** is equal to "Implicit". + +**Table**: Specifies the name of the source table for this measure. MUST exist if **Type** is equal to "Implicit". + +**Column**: Specifies the name of the source field for this measure. MUST exist if **Type** is equal to "Implicit". + +**Aggregation:** Specifies the aggregation type of an implicit measure. If this attribute is present, **Type** MUST be equal to "Implicit". This value MUST have the following form: + +AGGREGATION(TABLENAME.COLUMNNAME) + +Where TABLENAME MUST be equal to **Table**, COLUMNNAME MUST be equal to **Column**, and the aggregation MUST be equal to one of the following: + +| **Value** | **Meaning** | +|----|----| +| SUM | The measure is the sum of the values in the source field specified by **Column**. | +| MAX | This measure is the maximum value in the source field specified by **Column**. | +| COUNTA | This measure is the count of values in the source field specified by **Column**. | +| AVERAGE | This measure is the average of the values in the source field specified by **Column**. | +| STDEV.S | This measure is the standard deviation of the values in the source field specified by **Column**. | +| STDEV.P | This measure is the standard deviation of the values in the source field specified by **Column**. | +| VAR.S | This measure is the variance in the values of the source field specified by **Column**. | +| DISTINCTCOUNT | This measure is the count of unique values in the source field specified by **Column**. | + +**Application**: Specifies the name of the application that created this measure. MUST exist if **Type** is equal to "Implicit" + +#### DimensionAttribute Annotations + +The **Annotations** property of a **DimensionAttribute** object describing a [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) in a **DimensionTabularModel** ([\[MS-XLDM\]](%5bMS-XLDM%5d.pdf#Section_8c62e8cef605488d81e94ecdb7686a52) section 2.6.6) can be extended with the following optional properties: + +**ShortColumnId**: Specifies the identifier used to represent this column in the command text when data is pushed to the model. + +### Timeline Cache + +*Content type:* application /vnd.ms-excel.TimelineCache+xml + +*Source relationship:* http://schemas.microsoft.com/office/2010/relationships/TimelineCache + +An instance of this part type specifies a single **Timeline Cache** (section [2.3.5.1](#Section_8a428bc98be342fab39e8d2bb83657a2)) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +A package MUST contain one Timeline cache part per **CT_TimelineCacheRef** element, as specified in section [2.6.99](#Section_3c9df509399f47da87fd8d60ebb50871), in the workbook part, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 12.3.23, and that part MUST be the target of an explicit relationship from the workbook part. + +A **Timeline cache** part MUST NOT have implicit or explicit relationships to any part specified by this protocol. + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **timelineCacheDefinition** element, as specified in section [2.4.58](#Section_352e7e0819b7411e8e5958e8281df654). + +### Timelines + +*Content type:* application/vnd.ms-excel.Timeline+xml + +*Source relationship:* http://schemas.microsoft.com/office/2010/relationships/Timeline + +An instance of this part type specifies the [Timeline views](#Section_ca0c8a5be42e4aeab6850a236dff375e) for a single [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +The presence of a Timelines part indicates that there is at least one Timeline view on the associated worksheet, and that this part MUST be the target of an explicit relationship from the worksheet part, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 12.3.24. + +A Timelines part MUST NOT have implicit or explicit relationships to any part specified by this protocol. + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **timelines** element, as specified in section [2.4.57](#Section_af36921b03b74f22acd601582075ef73). + +### Survey + +*Content type:* application/vnd.ms-excel.Survey+xml + +*Source relationship:* http://schemas.microsoft.com/office/2010/relationships/Survey + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **survey** element, as specified in section [2.4.69](#Section_f0d2d8ba4f7749ddbf512c7a53734ae7). + +### Rich Value Data + +*Content type:* application/vnd.ms-excel.rdRichValue+xml + +*Source relationship:* http://schemas.microsoft.com/office/2017/06/relationships/rdRichValue + +The presence of this part type indicates that there are [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and a **Rich Value Structure** (section [2.1.11](#Section_d90f6d91d8684b949d26ec3b1492cec6)) part MUST be part of the package. + +A **Rich Value Data** part MUST be the target of an implicit relationship from the **Metadata** part, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.9.2. + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **rvData** element, as specified in section [2.4.77](#Section_42c032f4086248f99b9bd20b6e946fa6). + +### Rich Value Structure + +*Content type:* application/vnd.ms-excel.rdRichValueStructure+xml + +*Source relationship:* http://schemas.microsoft.com/office/2017/06/relationships/rdRichValueStructure + +The presence of this part type indicates that there are [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and a **Rich Value Data** (section [2.1.10](#Section_896934fd8df743f4b1542d39371c270d)) part MUST be part of the package. + +A **Rich Value Structure** part MUST be the target of an implicit relationship from the **Rich Value Data** part, as specified in section [2.6.175](#Section_b8d7927a79b44f2cb76b3a6e9cd7ad40). + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **rvStructures** element, as specified in section [2.4.78](#Section_5a37902a0bc243ea8039d68aa4344f76). + +### Rich Value Array + +*Content type:* application/vnd.ms-excel.rdArray+xml + +*Source relationship:* http://schemas.microsoft.com/office/2017/06/relationships/rdArray + +The presence of this part type indicates that there are [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and a **Rich Value Data** (section [2.1.10](#Section_896934fd8df743f4b1542d39371c270d)) part and a **Rich Value Structure** (section [2.1.11](#Section_d90f6d91d8684b949d26ec3b1492cec6)) part MUST be part of the package. + +A **Rich Value Array** part MUST be the target of an implicit relationship from the **Rich Value Data** part, as specified in section [2.6.175](#Section_b8d7927a79b44f2cb76b3a6e9cd7ad40). + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **arrayData** element, as specified in section [2.4.74](#Section_380bf95b864c405fa2b76cb05d343404). + +### Rich Styles + +*Content type:* application/vnd.ms-excel.richStyles+xml + +*Source relationship:* http://schemas.microsoft.com/office/2017/06/relationships/richStyles + +The presence of this part type indicates that there are [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) with [**styles**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and a **Rich Value Data** (section [2.1.10](#Section_896934fd8df743f4b1542d39371c270d)) part, a **Rich Value Structure** (section [2.1.11](#Section_d90f6d91d8684b949d26ec3b1492cec6)) part, a **Supporting Property Bag Data** (section [2.1.14](#Section_f224284552524a9582dea71a0110bdb9)) part, and a **Supporting Property Bag Structure** (section [2.1.15](#Section_f8960ea75c9d412690bf3a115f380de5)) part MUST be part of the package. + +A **Rich Styles** part MUST be the target of an implicit relationship from the **Supporting Property Bag Data** part (section [2.6.192](#Section_c2ae1a7e0d22471289861f402c8419ed)), as specified in Special Keys and Key Flags in section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257). + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **richStyleSheet** element, as specified in section [2.4.75](#Section_357034a59f4649c99ad1d5b38738110d). + +### Supporting Property Bag Data + +*Content type:* application/vnd.ms-excel.rdSupportingPropertyBag+xml + +*Source relationship:* http://schemas.microsoft.com/office/2017/06/relationships/rdSupportingPropertyBag + +The presence of this part type indicates that there are [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) with [**supporting property bags**](#gt_048a0082-4ff4-4807-8300-69ccc781c098) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and a **Rich Value Data** (section [2.1.10](#Section_896934fd8df743f4b1542d39371c270d)) part, a **Rich Value Structure** (section [2.1.11](#Section_d90f6d91d8684b949d26ec3b1492cec6)) part, and a **Supporting Property Bag Structure** (section [2.1.15](#Section_f8960ea75c9d412690bf3a115f380de5)) part MUST be part of the package. + +A **Supporting Property Bag** part MUST be the target of an implicit relationship from the **Rich Value Data** part, as specified in section [2.6.175](#Section_b8d7927a79b44f2cb76b3a6e9cd7ad40). + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **supportingPropertyBags** element, as specified in section [2.4.81](#Section_efb6bef6ea834b12825d9a25d347e448). + +### Supporting Property Bag Structure + +*Content type:* application/vnd.ms-excel.rdSupportingPropertyBagStructure+xml + +*Source relationship:* http://schemas.microsoft.com/office/2017/06/relationships/rdSupportingPropertyBagStructure + +The presence of this part type indicates that there are [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) with [**supporting property bags**](#gt_048a0082-4ff4-4807-8300-69ccc781c098) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and a **Rich Value Data** (section [2.1.10](#Section_896934fd8df743f4b1542d39371c270d)) part, a **Rich Value Structure** (section [2.1.11](#Section_d90f6d91d8684b949d26ec3b1492cec6)) part, and a **Supporting Property Bag Data** (section [2.1.14](#Section_f224284552524a9582dea71a0110bdb9)) part MUST be part of the package. + +A **Supporting Property Bag Structure** part MUST be the target of an implicit relationship from the **Supporting Property Bag** part, as specified in section [2.6.188](#Section_1e24d4a8d93f48e79370e7f79af427df). + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **spbStructures** element, as specified in section [2.4.80](#Section_2a76e201630640b9a4dc6b72f834d6fc). + +### Rich Value Types + +*Content type:* application/vnd.ms-excel.rdRichValuetypes+xml + +*Source relationship:* http://schemas.microsoft.com/office/2017/06/relationships/rdRichValueTypes + +The presence of this part type indicates that there is information about [**rich value types**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and a **Rich Value Data** (section [2.1.10](#Section_896934fd8df743f4b1542d39371c270d)) part, and a **Rich Value Structure** (section [2.1.11](#Section_d90f6d91d8684b949d26ec3b1492cec6)) part MAY be part of the package. + +A **Rich Value Types** part MAY be the target of an implicit relationship from the **RichValue Structure** part, as specified in section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257). + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **rvTypesInfo** element, as specified in section [2.4.79](#Section_0aab0bd06925469aabefdb4614ffb420). + +### Threaded Comments + +*Content type:* application/vnd.ms-excel.threadedcomments+xml + +*Source relationship:* http://schemas.microsoft.com/office/2017/10/relationships/threadedComment + +An instance of this part type specifies the **Threaded Comments** (section [2.3.7](#Section_e0fb917a1107409a852f13b47aea70dc)) for a single [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +The presence of a Threaded Comments part indicates that there is at least one Threaded Comment on the associated worksheet, and that this part MUST be the target of an implicit relationship from the worksheet part, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 12.3.24. + +A Threaded Comments part MUST NOT have implicit or explicit relationships to any part specified by this protocol. + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **ThreadedComments** element, as specified in section [2.4.86](#Section_b1b3567212a0409cb00ecc2192094f41) + +### Persons + +*Content type:* application/vnd.ms-excel.person+xml + +*Source relationship:* http://schemas.microsoft.com/office/2017/10/relationships/person + +The presence of this part type indicates that there is information about **Persons** (section [2.3.7.1](#Section_bdadd4b1153241c189f151ac5c717fb7)) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +A **Persons** part MUST be the target of an implicit relationship from the workbook part, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 12.3.23. + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **personList** element, as specified in section [2.4.85](#Section_9f1b6e0e79cd4ae2b3a76dea649c57f6) + +### Named Sheet Views + +*Content type:* application/vnd.ms-excel.namedsheetviews+xml + +*Source relationship:* http://schemas.microsoft.com/office/2019/04/relationships/namedSheetView + +An instance of this part type specifies the **Named Sheet Views** (section [2.3.8](#Section_78cf20a1255145c686bff1e92bd5fc39)) for a single [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +The presence of a Named Sheet Views part indicates that there is at least one Named Sheet View on the associated worksheet, and that this part MUST be the target of an implicit relationship from the worksheet part, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 12.3.24. + +A Named Sheet Views part MUST NOT have implicit or explicit relationships to any part specified by this protocol. + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **namedSheetViews** element, as specified in section [2.4.88](#Section_adecc84b11aa42f9bdc5b448cb2a538e) + +### Web Image Supporting Rich Data + +*Content type:* application/vnd.ms-excel.rdrichvaluewebimage+xml + +*Source relationship:* http://schemas.microsoft.com/office/2020/07/relationships/rdRichValueWebImage + +The presence of this part type indicates that there is supporting information for web image [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and a **Rich Value Data** (section [2.1.10](#Section_896934fd8df743f4b1542d39371c270d)) part, and a **Rich Value Structure** (section [2.1.11](#Section_d90f6d91d8684b949d26ec3b1492cec6)) part MUST be part of the package. + +A **Web Image Supporting Rich Data** part MUST be the target of an implicit relationship from the **Rich Value Data** part, as specified in section [2.3.6.1.11](#Section_9940168fccfc43a8bf8134c7d4bff974). + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **webImagesSrd** element, as specified in section [2.4.90](#Section_8e493a5650084a89a47761a1fd83abbb). + +### Rich Value Rels + +*Content type:* application/vnd.ms-excel.richvaluerel+xml + +*Source relationship:* http://schemas.microsoft.com/office/2022/10/relationships/richValueRel + +The presence of this part type indicates that there are [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) and a **Rich Value Data** (section [2.1.10](#Section_896934fd8df743f4b1542d39371c270d)) part and a **Rich Value Structure** (section [2.1.11](#Section_d90f6d91d8684b949d26ec3b1492cec6)) part MUST be part of the package. + +A **Rich Value Rels** part MUST be the target of an implicit relationship from the **Rich Value Data** part, as specified in section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257). + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **richValueRels** element, as specified in section [2.4.100](#Section_e8426f8a62ba4f449eddd0052728d40e). + +### Feature Property Bag + +*Content type:* application/vnd.ms-excel.featurepropertybag+xml + +*Source relationship:* http://schemas.microsoft.com/office/2022/11/relationships/FeaturePropertyBag + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) for the part is the **FeaturePropertyBags** element, as specified in section [2.4.98](#Section_f30c4f9a632a4fdaadca08fd156dd9f0). + +### Python + +*Content type:* application/vnd.ms-excel.python+xml + +*Source relationship:* http://schemas.microsoft.com/office/2023/09/relationships/Python + +The presence of this part type indicates that PY function has been used at least once in the workbook. Each Python script (section [2.3.10.3](#Section_de4efdb9f0544272a2f2c14db21b164a)) in the Python part MUST be the target of an implicit relationship from the PY function in worksheet part, as specified in section [2.3.10.2](#Section_28f8f9b3e370440c9afc2a1bba74cde6). + +The syntax of the structures contained in this part uses [**XSD**](#gt_c7e91c99-e45a-44c2-a08a-c34f137a2cae), as specified in [\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) and [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609). + +This specification defines and references various [**XML namespaces**](#gt_485f05b3-df3b-45ac-b8bf-d05f5d185a24) by using the mechanisms specified in [\[XMLNS\]](https://go.microsoft.com/fwlink/?LinkId=191840). + +The content of this part is [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85), and the root element for the part is the **python** element, as specified in section [2.4.102](#Section_43e4bfa85a964b0d95914e68a8ef1180). + +## Extensions + +Extensions are specified by using the conventions provided by Office Open XML file formats as specified in [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154).The following namespaces are utilized by the extensions specified in this document: + +- "http://schemas.microsoft.com/office/drawingml/2010/slicer"[\<1\>](#Appendix_A_1) + +- "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main"[\<2\>](#Appendix_A_2) + +- "http://schemas.microsoft.com/office/spreadsheetml/2009/9/ac"[\<3\>](#Appendix_A_3) + +- "http://schemas.microsoft.com/office/excel/2006/main" + +- "http://schemas.microsoft.com/office/spreadsheetml/2010/11/main"[\<4\>](#Appendix_A_4) + +- "http://schemas.microsoft.com/office/drawing/2012/timeslicer"[\<5\>](#Appendix_A_5) + +### SpreadsheetML Extensibility Elements + +When the global elements [**f**](#Section_8e937c5e8b744f10bdf81d75faf211b9), [**ref**](#Section_fd5bc8e23ec949028a8bc6179c3bb7b2), or [**sqref**](#Section_4d7cc4156c514c718dbda2e28bdd9193) are contained within an **ext** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.7) element and contain [**cell references**](#gt_4d15aeb2-3a7d-44d7-b8d1-8a441f1cc24f), an application can adjust these cell references when the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) layout changes, even when the containing **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) is not recognized by the application. See [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.3 for more details about how extension lists are used. + +### Formulas + +The following ABNF grammar is used by formulas in other parts of this document.[\<6\>](#Appendix_A_6) + +1. formula = expression / solo-function + + solo-function = "\_xlfn.\_xlws." "PY" py-params + + expression= ref-expression / \*whitespace nospace-expression \*whitespace + + ref-expression= \*whitespace ref-nospace-expression \*whitespace + + nospace-expression = "(" expression ")" / constant / prefix-operator expression / expression infix-operator expression / expression postfix-operator / function-call + + ref-nospace-expression = "(" ref-expression ")" / ref-constant / ref-expression ref-infix-operator ref-expression / cell-reference / ref-function-call / name-reference / structure-reference + + constant = error-constant / logical-constant / numerical-constant / string-constant / array-constant + + ref-constant = "#REF!" + + error-constant = ref-constant / "#DIV/0!" / "#N/A" / "#NAME?" / "#NULL!" / "#NUM!" / "#VALUE!" / "#GETTING_DATA" + + logical-constant = "FALSE" / "TRUE" + + numerical-constant = \[neg-sign\] significand-part \[exponent-part\] + + significand-part = whole-number-part \[fractional-part\] / fractional-part + + whole-number-part = digit-sequence + + fractional-part = full-stop digit-sequence + + exponent-part = exponent-character \[ sign \] digit-sequence + + full-stop = "." + + sign = "+" / neg-sign + + neg-sign = "-" + + exponent-character = "E" + + digit-sequence = 1\*decimal-digit + + decimal-digit = %x30-39 + + hex-digit = decimal-digit / %x41-46 / %x61-66 + + guid = 8hex-digit "-" 3(4hex-digit "-") 12hex-digit + + nonzero-decimal-digit = %x31-39 + + string-constant = double-quote \[string-chars\] double-quote + + string-chars = string-char \*string-char + + string-char = escaped-double-quote / character ; MUST NOT be a double-quote + + escaped-double-quote = 2double-quote + + double-quote = %x22 + + ;character = as defined by the production Char in the [\[W3C-XML\]](https://go.microsoft.com/fwlink/?LinkId=113935) section 2.2 + + array-constant = "{" constant-list-rows "}" + + constant-list-rows = constant-list-row \*(semicolon constant-list-row) + + semicolon = ";" + + constant-list-row = constant \*(comma constant) + + ;An array-constant MUST NOT contain an array-constant or columns of unequal length or rows of unequal length. + + operator = ":" / comma / space / "^" / "\*" / "/" / "+" / "-" / "&" / "=" / "\<\>" / "\<" / "\<=" / "\>" / "\>=" / "%" + + infix-operator = ref-infix-operator / value-infix-operator + + value-infix-operator = "^" / "\*" / "/" / "+" / "-" / "&"/ "=" / "\<\>" / "\<" / "\<=" / "\>" / "\>=" + + ref-infix-operator = range-operator / union-operator / intersection-operator + + union-operator = comma + + intersection-operator = space + + range-operator = ":" + + postfix-operator = "%" + + prefix-operator = "+" / "-" + + cell-reference = external-cell-reference / local-cell-reference + + local-cell-reference = A1-reference + + external-cell-reference = bang-reference / sheet-range-reference / single-sheet-reference + + book-prefix = workbook-index "!" + + bang-reference = "!" (A1-reference / "#REF!") + + sheet-range-reference = sheet-range "!" A1-reference + + single-sheet-prefix = single-sheet "!" + + single-sheet-reference = single-sheet-prefix (A1-reference / "#REF!") + + single-sheet-area = single-sheet-prefix A1-area + + single-sheet = \[workbook-index\] sheet-name / apostrophe \[workbook-index\] sheet-name-special apostrophe + + sheet-range = \[workbook-index\] sheet-name ":" sheet-name / apostrophe \[workbook-index\] sheet-name-special ":" sheet-name-special apostrophe + + workbook-index = "\[" whole-number-part "\]" + + sheet-name = sheet-name-characters + + sheet-name-characters = 1\*sheet-name-character + + sheet-name-character = character ; MUST NOT be an operator, ', \[, \], \\ or ? + + apostrophe= "'" + + space = " " + + whitespace = space / %x0D %x0A + + sheet-name-special = sheet-name-base-character \[\*sheet-name-character-special sheet-name-base-character\] + + sheet-name-character-special = 2apostrophe / sheet-name-base-character + + sheet-name-base-character = character ; MUST NOT be ', \*, \[, \], \\ :, /, ?, or Unicode character 'END OF TEXT' + + parameter-name = "xlpm." Name + + lambda-parameter-name = parameter-name / "xlop." Name + + A1-reference = (A1-column ":" A1-column) / (A1-row ":" A1-row) / A1-cell / A1-area + + A1-cell = A1-column A1-row + + A1-area = A1-cell ":" A1-cell + + A1-column = A1-relative-column / A1-absolute-column + + A1-relative-column = 1\*2letter / A-to-W 2letter / "X" A-to-E letter / "XF" A-to-D + + A-to-D = %x41-44 / %x61-64 + + A-to-E = A-to-D / "E" + + A-to-W = %x41-57 / %x61-77 + + letter = %x41-5A / %x61-7A + + A1-absolute-column = "\$" A1-relative-column + + A1-row = A1-relative-row / A1-absolute-row + + A1-relative-row = row-digit-sequence + + row-digit-sequence = nonzero-decimal-digit \*5decimal-digit / "10" %x30-33 4decimal-digit / "104" %x30-37 3decimal-digit / "1048" %x30-34 2decimal-digit / "10485" %x30-36 decimal-digit / "104857" %x30-36 + + A1-absolute-row = "\$" A1-relative-row + + cell-function-call = A1-cell "(" argument-list ")" + + user-defined-function-call = user-defined-function-name "(" argument-list ")" + + user-defined-function-name = name-reference + + argument-list = argument \*253(comma argument) + + comma= "," + + argument = \*whitespace \[argument-expression\] + + argument-expression= ref-argument-expression / \*whitespace nospace-argument-expression \*whitespace + + ref-argument-expression= \*whitespace ref-argument-nospace-expression \*whitespace + + nospace-argument-expression = "(" expression ")" / constant / prefix-operator argument-expression / argument-expression argument-infix-operator argument-expression / argument-expression postfix-operator / function-call + + ref-argument-nospace-expression = "(" ref-expression ")" / ref-constant / ref-argument-expression ref-argument-infix-operator ref-argument-expression / cell-reference / ref-function-call / name-reference / structure-reference + + argument-infix-operator = ref-argument-infix-operator / value-infix-operator + + ref-argument-infix-operator = range-operator / intersection-operator + + unicode-digit = (any code points which are digits as defined by the Unicode character properties, \[UNICODE5.1\] chapter 4) + + R1C1-cell-reference = R1C1-row / R1C1-column / R1C1-row R1C1-column / R1C1-column R1C1-row + + R1C1-row = "R" row-number + + R1C1-column = "C" column-number + + column-number = 1-16384 + + ; A string composed of unicode-digits that represents an unsigned integer that is greater than or equal to 1 and less than or equal to 16384 + + row-number = 1-1048576 + + ; A string composed of unicode-digits that represents an unsigned integer that is greater than or equal to 1 and less than or equal to 1048576. + + name-reference = name / external-name + + external-name = bang-name / (single-sheet-prefix / book-prefix ) name + + bang-name = "!" name + + name = name-start-character \[ name-characters \] + + name-start-character = underscore / backslash / letter / name-base-character + + underscore = "\_" + + backslash = "\\ + + name-base-character = (any code points which are characters as defined by the Unicode character properties, \[UNICODE5.1\] chapter 4 ; MUST NOT be 0x0-0x7F) + + name-characters= 1\*name-character + + name-character = name-start-character / decimal-digit / full-stop / questionmark + + questionmark = "?" + + ;A name MUST NOT have any of the following forms: + + ;TRUE or FALSE + + ;cell-reference + + ;function-list + + ;command-list + + ;future-function-list + + ;R1C1-cell-reference + + ;worksheet-only-function-list + + structure-reference = \[table-identifier\] intra-table-reference + + table-identifier = \[book-prefix\] table-name + + table-name = name + + ;table-name is the name of the table the structure reference refers to. If it is missing, the formula containing the structure reference MUST be entered into a cell which belongs to a table and that table's name is used as the table-name. table-name MUST be the value of the displayName attribute of some table element (\[ISO/IEC29500-1:2016\] section 18.5.1.2). It MUST NOT be any other user-defined name. + + intra-table-reference = (spaced-lbracket inner-reference spaced-rbracket) / keyword / column / "\[\]" + + inner-reference = keyword-list / ((keyword-list / keyword) spaced-comma column) / (\[(keyword-list / keyword) spaced-comma\] column-range) / + + keyword = "\[#All\]" / "\[#Data\]" / "\[#Headers\]" / "\[#Totals\]" / "\[#This Row\]" + + keyword-list = ("\[#Headers\]" spaced-comma "\[#Data\]") / ("\[#Data\]" spaced-comma "\[#Totals\]") + + column-range = column ":" column + + column = ("\[" simple-column-name "\]") + + simple-column-name = \[any-nospace-column-character \*any-column-character\] any-nospace-columncharacter + + escape-column-character = tick / "\[" / "\]" / "#" + + tick = %x27 + + unescaped-column-character = character ; MUST NOT match escape-column-character or space + + any-column-character = any-nospace-column-character / space + + any-nospace-column-character = unescaped-column-character / (tick escape-column-character) + + spaced-comma = \[space\] comma \[space\] + + spaced-lbracket = "\[" \[space\] + + spaced-rbracket = \[space\] "\]" + + function-list = "ABS" / "ABSREF" / "ACCRINT" / "ACCRINTM" / "ACOS" / "ACOSH" / "ACTIVE.CELL" / "ADD.BAR" / "ADD.COMMAND" / "ADD.MENU" / "ADD.TOOLBAR" / "ADDRESS" / "AMORDEGRC" / "AMORLINC" / "AND" / "APP.TITLE" / "AREAS" / "ARGUMENT" / "ASC" / "ASIN" / "ASINH" / "ATAN" / "ATAN2" / "ATANH" / "AVEDEV" / "AVERAGE" / "AVERAGEA" / "AVERAGEIF" / "AVERAGEIFS" / "BAHTTEXT" / "BESSELI" / "BESSELJ" / "BESSELK" / "BESSELY" / "BETADIST" / "BETAINV" / "BIN2DEC" / "BIN2HEX" / "BIN2OCT" / "BINOMDIST" / "BREAK" / "CALL" / "CALLER" / "CANCEL.KEY" / "CEILING" / "CELL" / "CHAR" / "CHECK.COMMAND" / "CHIDIST" / "CHIINV" / "CHITEST" / "CHOOSE" / "CLEAN" / "CODE" / "COLUMN" / "COLUMNS" / "COMBIN" / "COMPLEX" / "CONCAT" / "CONCATENATE" / "CONFIDENCE" / "CONVERT" / "CORREL" / "COS" / "COSH" / "COUNT" / "COUNTA" / "COUNTBLANK" / "COUNTIF" / "COUNTIFS" / "COUPDAYBS" / "COUPDAYS" / "COUPDAYSNC" / "COUPNCD" / "COUPNUM" / "COUPPCD" / "COVAR" / "CREATE.OBJECT" / "CRITBINOM" / "CUBEKPIMEMBER" / "CUBEMEMBER" / "CUBEMEMBERPROPERTY" / "CUBERANKEDMEMBER" / "CUBESET" / "CUBESETCOUNT" / "CUBEVALUE" / "CUMIPMT" / "CUMPRINC" / "CUSTOM.REPEAT" / "CUSTOM.UNDO" / "DATE" / "DATEDIF" / "DATESTRING" / "DATEVALUE" / "DAVERAGE" / "DAY" / "DAYS360" / "DB" / "DBCS" / "DCOUNT" / "DCOUNTA" / "DDB" / "DEC2BIN" / "DEC2HEX" / "DEC2OCT" / "DEGREES" / "DELETE.BAR" / "DELETE.COMMAND" / "DELETE.MENU" / "DELETE.TOOLBAR" / "DELTA" / "DEREF" / "DEVSQ" / "DGET" / "DIALOG.BOX" / "DIRECTORY" / "DISC" / "DMAX" / "DMIN" / "DOCUMENTS" / "DOLLAR" / "DOLLARDE" / "DOLLARFR" / "DPRODUCT" / "DSTDEV" / "DSTDEVP" / "DSUM" / "DURATION" / "DVAR" / "DVARP" / "ECHO" / "EDATE" / "EFFECT" / "ELSE" / "ELSE.IF" / "ENABLE.COMMAND" / "ENABLE.TOOL" / "END.IF" / "EOMONTH" / "ERF" / "ERFC" / "ERROR" / "ERROR.TYPE" / "EVALUATE" / "EVEN" / "EXACT" / "EXEC" / "EXECUTE" / "EXP" / "EXPONDIST" / "FACT" / "FACTDOUBLE" / "FALSE" / "FCLOSE" / "FDIST" / "FILES" / "FIND" / "FINDB" / "FINV" / "FISHER" / "FISHERINV" / "FIXED" / "FLOOR" / "FOPEN" / "FOR" / "FOR.CELL" / "FORECAST" / "FORMULA.CONVERT" / "FPOS" / "FREAD" / "FREADLN" / "FREQUENCY" / "FSIZE" / "FTEST" / "FV" / "FVSCHEDULE" / "FWRITE" / "FWRITELN" / "GAMMADIST" / "GAMMAINV" / "GAMMALN" / "GCD" / "GEOMEAN" / "GESTEP" / "GET.BAR" / "GET.CELL" / "GET.CHART.ITEM" / "GET.DEF" / "GET.DOCUMENT" / "GET.FIELD" / "GET.FORMULA" / "GET.ITEM" / "GET.LINK.INFO" / "GET.MOVIE" / "GET.NAME" / "GET.NOTE" / "GET.OBJECT" / "GET.TOOL" / "GET.TOOLBAR" / "GET.VIEW" / "GET.WINDOW" / "GET.WORKBOOK" / "GET.WORKSPACE" / "GETPIVOTDATA" / "GOTO" / "GROUP" / "GROWTH" / "HALT" / "HARMEAN" / "HELP" / "HEX2BIN" / "HEX2DEC" / "HEX2OCT" / "HLOOKUP" / "HOUR" / "HYPERLINK" / "HYPGEOMDIST" / "IF" / "IFS" / "IFERROR" / "IMABS" / "IMAGINARY" / "IMARGUMENT" / "IMCONJUGATE" / "IMCOS" / "IMDIV" / "IMEXP" / "IMLN" / "IMLOG10" / "IMLOG2" / "IMPOWER" / "IMPRODUCT" / "IMREAL" / "IMSIN" / "IMSQRT" / "IMSUB" / "IMSUM" / "INDEX" / "INDIRECT" / "INFO" / "INITIATE" / "INPUT" / "INT" / "INTERCEPT" / "INTRATE" / "IPMT" / "IRR" / "ISBLANK" / "ISERR" / "ISERROR" / "ISEVEN" / "ISLOGICAL" / "ISNA" / "ISNONTEXT" / "ISNUMBER" / "ISODD" / "ISPMT" / "ISREF" / "ISTEXT" / "ISTHAIDIGIT" / "KURT" / "LARGE" / "LAST.ERROR" / "LCM" / "LEFT" / "LEFTB" / "LEN" / "LENB" / "LINEST" / "LINKS" / "LN" / "LOG" / "LOG10" / "LOGEST" / "LOGINV" / "LOGNORMDIST" / "LOOKUP" / "LOWER" / "MATCH" / "MAX" / "MAXA" / "MAXIFS" / "MDETERM" / "MDURATION" / "MEDIAN" / "MID" / "MIDB" / "MIN" / "MINA" / "MINIFS" / "MINUTE" / "MINVERSE" / "MIRR" / "MMULT" / "MOD" / "MODE" / "MONTH" / "MOVIE.COMMAND" / "MROUND" / "MULTINOMIAL" / "N" / "NA" / "NAMES" / "NEGBINOMDIST" / "NETWORKDAYS" / "NEXT" / "NOMINAL" / "NORMDIST" / "NORMINV" / "NORMSDIST" / "NORMSINV" / "NOT" / "NOTE" / "NOW" / "NPER" / "NPV" / "NUMBERSTRING" / "OCT2BIN" / "OCT2DEC" / "OCT2HEX" / "ODD" / "ODDFPRICE" / "ODDFYIELD" / "ODDLPRICE" / "ODDLYIELD" / "OFFSET" / "OPEN.DIALOG" / "OPTIONS.LISTS.GET" / "OR" / "PAUSE" / "PEARSON" / "PERCENTILE" / "PERCENTRANK" / "PERMUT" / "PHONETIC" / "PI" / "PMT" / "POISSON" / "POKE" / "POWER" / "PPMT" / "PRESS.TOOL" / "PRICE" / "PRICEDISC" / "PRICEMAT" / "PROB" / "PRODUCT" / "PROPER" / "PV" / "QUARTILE" / "QUOTIENT" / "RADIANS" / "RAND" / "RANDBETWEEN" / "RANK" / "RATE" / "RECEIVED" / "REFTEXT" / "REGISTER" / "REGISTER.ID" / "RELREF" / "RENAME.COMMAND" / "REPLACE" / "REPLACEB" / "REPT" / "REQUEST" / "RESET.TOOLBAR" / "RESTART" / "RESULT" / "RESUME" / "RETURN" / "RIGHT" / "RIGHTB" / "ROMAN" / "ROUND" / "ROUNDBAHTDOWN" / "ROUNDBAHTUP" / "ROUNDDOWN" / "ROUNDUP" / "ROW" / "ROWS" / "RSQ" / "RTD" / "SAVE.DIALOG" / "SAVE.TOOLBAR" / "SCENARIO.GET" / "SEARCH" / "SEARCHB" / "SECOND" / "SELECTION" / "SERIES" / "SERIESSUM" / "SET.NAME" / "SET.VALUE" / "SHOW.BAR" / "SIGN" / "SIN" / "SINH" / "SKEW" / "SLN" / "SLOPE" / "SMALL" / "SPELLING.CHECK" / "SPREADBASE.DATA.FIELD" / "SQRT" / "SQRTPI" / "STANDARDIZE" / "STDEV" / "STDEVA" / "STDEVP" / "STDEVPA" / "STEP" / "STEYX" / "SUBSTITUTE" / "SUBTOTAL" / "SUM" / "SUMIF" / "SUMIFS" / "SUMPRODUCT" / "SUMSQ" / "SUMX2MY2" / "SUMX2PY2" / "SUMXMY2" / "SWITCH" / "SYD" / "T" / "TAN" / "TANH" / "TBILLEQ" / "TBILLPRICE" / "TBILLYIELD" / "TDIST" / "TERMINATE" / "TEXT" / "TEXT.BOX" / "TEXTJOIN" / "TEXTREF" / "THAIDAYOFWEEK" / "THAIDIGIT" / "THAIMONTHOFYEAR" / "THAINUMSOUND" / "THAINUMSTRING" / "THAISTRINGLENGTH" / "THAIYEAR" / "TIME" / "TIMEVALUE" / "TINV" / "TODAY" / "TRANSPOSE" / "TREND" / "TRIM" / "TRIMMEAN" / "TRUE" / "TRUNC" / "TTEST" / "TYPE" / "UNREGISTER" / "UPPER" / "USDOLLAR" / "VALUE" / "VAR" / "VARA" / "VARP" / "VARPA" / "VDB" / "VIEW.GET" / "VLOOKUP" / "VOLATILE" / "WEEKDAY" / "WEEKNUM" / "WEIBULL" / "WHILE" / "WINDOW.TITLE" / "WINDOWS" / "WORKDAY" / "XIRR" / "XNPV" / "YEAR" / "YEARFRAC" / "YIELD" / "YIELDDISC" / "YIELDMAT" / "ZTEST" + + command-list = ("A1.R1C1" / "ACTIVATE" / "ACTIVATE.NEXT" / "ACTIVATE.NOTES" / "ACTIVATE.PREV" / "ACTIVE.CELL.FONT" / "ADD.ARROW" / "ADD.CHART.AUTOFORMAT" / "ADD.LIST.ITEM" / "ADD.OVERLAY" / "ADD.PRINT.AREA" / "ADD.TOOL" / "ADDIN.MANAGER" / "ALERT" / "ALIGNMENT" / "APP.ACTIVATE" / "APP.ACTIVATE.MICROSOFT" / "APP.MAXIMIZE" / "APP.MINIMIZE" / "APP.MOVE" / "APP.RESTORE" / "APP.SIZE" / "APPLY.NAMES" / "APPLY.STYLE" / "ARRANGE.ALL" / "ASSIGN.TO.OBJECT" / "ASSIGN.TO.TOOL" / "ATTACH.TEXT" / "ATTACH.TOOLBARS" / "ATTRIBUTES" / "AUTO.OUTLINE" / "AUTOCORRECT" / "AXES" / "BEEP" / "BORDER" / "BRING.TO.FRONT" / "CALCULATE.DOCUMENT" / "CALCULATE.NOW" / "CALCULATION" / "CANCEL.COPY" / "CELL.PROTECTION" / "CHANGE.LINK" / "CHART.ADD.DATA" / "CHART.TREND" / "CHART.WIZARD" / "CHECKBOX.PROPERTIES" / "CLEAR" / "CLEAR.OUTLINE" / "CLEAR.PRINT.AREA" / "CLEAR.ROUTING.SLIP" / "CLOSE" / "CLOSE.ALL" / "COLOR.PALETTE" / "COLUMN.WIDTH" / "COMBINATION" / "CONSOLIDATE" / "CONSTRAIN.NUMERIC" / "COPY" / "COPY.CHART" / "COPY.PICTURE" / "COPY.TOOL" / "CREATE.NAMES" / "CREATE.PUBLISHER" / "CUSTOMIZE.TOOLBAR" / "CUT" / "DATA.DELETE" / "DATA.FIND" / "DATA.FIND.NEXT" / "DATA.FIND.PREV" / "DATA.FORM" / "DATA.LABEL" / "DATA.SERIES" / "DEFINE.NAME" / "DEFINE.STYLE" / "DELETE.ARROW" / "DELETE.CHART.AUTOFORMAT" / "DELETE.FORMAT" / "DELETE.NAME" / "DELETE.NOTE" / "DELETE.OVERLAY" / "DELETE.STYLE" / "DELETE.TOOL" / "DEMOTE" / "DISABLE.INPUT" / "DISPLAY" / "DUPLICATE" / "EDIT.COLOR" / "EDIT.DELETE" / "EDIT.OBJECT" / "EDIT.REPEAT" / "EDIT.SERIES" / "EDIT.TOOL" / "EDITBOX.PROPERTIES" / "EDITION.OPTIONS" / "ENABLE.OBJECT" / "ENABLE.TIPWIZARD" / "ENTER.DATA" / "ERRORBAR.X" / "ERRORBAR.Y" / "EXTEND.POLYGON" / "EXTRACT" / "FILE.CLOSE" / "FILE.DELETE" / "FILL.AUTO" / "FILL.DOWN" / "FILL.GROUP" / "FILL.LEFT" / "FILL.RIGHT" / "FILL.UP" / "FILTER" / "FILTER.ADVANCED" / "FILTER.SHOW.ALL" / "FIND.FILE" / "FONT" / "FONT.PROPERTIES" / "FORMAT.AUTO" / "FORMAT.CHART" / "FORMAT.CHARTTYPE" / "FORMAT.FONT" / "FORMAT.LEGEND" / "FORMAT.MAIN" / "FORMAT.MOVE" / "FORMAT.NUMBER" / "FORMAT.OVERLAY" / "FORMAT.SHAPE" / "FORMAT.SIZE" / "FORMAT.TEXT" / "FORMULA" / "FORMULA.ARRAY" / "FORMULA.FILL" / "FORMULA.FIND" / "FORMULA.FIND.NEXT" / "FORMULA.FIND.PREV" / "FORMULA.GOTO" / "FORMULA.REPLACE" / "FREEZE.PANES" / "FULL" / "FULL.SCREEN" / "FUNCTION.WIZARD" / "GALLERY.3D.AREA" / "GALLERY.3D.BAR" / "GALLERY.3D.COLUMN" / "GALLERY.3D.LINE" / "GALLERY.3D.PIE" / "GALLERY.3D.SURFACE" / "GALLERY.AREA" / "GALLERY.BAR" / "GALLERY.COLUMN" / "GALLERY.CUSTOM" / "GALLERY.DOUGHNUT" / "GALLERY.LINE" / "GALLERY.PIE" / "GALLERY.RADAR" / "GALLERY.SCATTER" / "GOAL.SEEK" / "GRIDLINES" / "HIDE" / "HIDE.DIALOG" / "HIDE.OBJECT" / "HIDEALL.INKANNOTS" / "HIDEALL.NOTES" / "HIDECURR.NOTE" / "HLINE" / "HPAGE" / "HSCROLL" / "INSERT" / "INSERT.MAP.OBJECT" / "INSERT.OBJECT" / "INSERT.PICTURE" / "INSERT.TITLE" / "INSERTDATATABLE" / "JUSTIFY" / "LABEL.PROPERTIES" / "LAYOUT" / "LEGEND" / "LINE.PRINT" / "LINK.COMBO" / "LINK.FORMAT" / "LIST.NAMES" / "LISTBOX.PROPERTIES" / "MACRO.OPTIONS" / "MAIL.ADD.MAILER" / "MAIL.DELETE.MAILER" / "MAIL.EDIT.MAILER" / "MAIL.FORWARD" / "MAIL.LOGOFF" / "MAIL.LOGON" / "MAIL.NEXT.LETTER" / "MAIL.REPLY" / "MAIL.REPLY.ALL" / "MAIL.SEND.MAILER" / "MAIN.CHART" / "MAIN.CHART.TYPE" / "MENU.EDITOR" / "MERGE.STYLES" / "MESSAGE" / "MOVE.BRK" / "MOVE.TOOL" / "MSOCHECKS" / "NEW" / "NEW.WINDOW" / "NEWWEBQUERY" / "NORMAL" / "OBJECT.PROPERTIES" / "OBJECT.PROTECTION" / "ON.DATA" / "ON.DOUBLECLICK" / "ON.ENTRY" / "ON.KEY" / "ON.RECALC" / "ON.SHEET" / "ON.TIME" / "ON.WINDOW" / "OPEN" / "OPEN.LINKS" / "OPEN.MAIL" / "OPEN.TEXT" / "OPTIONS.CALCULATION" / "OPTIONS.CHART" / "OPTIONS.EDIT" / "OPTIONS.GENERAL" / "OPTIONS.LISTS.ADD" / "OPTIONS.LISTS.DELETE" / "OPTIONS.ME" / "OPTIONS.MENONO" / "OPTIONS.SAVE" / "OPTIONS.SPELL" / "OPTIONS.TRANSITION" / "OPTIONS.VIEW" / "OUTLINE" / "OVERLAY" / "OVERLAY.CHART.TYPE" / "PAGE.SETUP" / "PARSE" / "PASTE" / "PASTE.LINK" / "PASTE.PICTURE" / "PASTE.PICTURE.LINK" / "PASTE.SPECIAL" / "PASTE.TOOL" / "PATTERNS" / "PICKLIST" / "PIVOT.ADD.FIELDS" / "PIVOT.FIELD" / "PIVOT.FIELD.GROUP" / "PIVOT.FIELD.PROPERTIES" / "PIVOT.FIELD.UNGROUP" / "PIVOT.ITEM" / "PIVOT.ITEM.PROPERTIES" / "PIVOT.REFRESH" / "PIVOT.SHOW.PAGES" / "PIVOT.TABLE.CHART" / "PIVOT.TABLE.WIZARD" / "POST.DOCUMENT" / "PRECISION" / "PREFERRED" / "PRINT" / "PRINT.PREVIEW" / "PRINTER.SETUP" / "PROMOTE" / "PROTECT.DOCUMENT" / "PROTECT.REVISIONS" / "PUSHBUTTON.PROPERTIES" / "QUIT" / "REMOVE.LIST.ITEM" / "REMOVE.PAGE.BREAK" / "RENAME.OBJECT" / "REPLACE.FONT" / "RESET.TOOL" / "RM.PRINT.AREA" / "ROUTE.DOCUMENT" / "ROUTING.SLIP" / "ROW.HEIGHT" / "RUN" / "SAVE" / "SAVE.AS" / "SAVE.COPY.AS" / "SAVE.NEW.OBJECT" / "SAVE.WORKBOOK" / "SAVE.WORKSPACE" / "SCALE" / "SCENARIO.ADD" / "SCENARIO.CELLS" / "SCENARIO.DELETE" / "SCENARIO.EDIT" / "SCENARIO.MERGE" / "SCENARIO.SHOW" / "SCENARIO.SHOW.NEXT" / "SCENARIO.SUMMARY" / "SCROLLBAR.PROPERTIES" / "SELECT" / "SELECT.ALL" / "SELECT.CHART" / "SELECT.END" / "SELECT.LAST.CELL" / "SELECT.LIST.ITEM" / "SELECT.PLOT.AREA" / "SELECT.SPECIAL" / "SEND.KEYS" / "SEND.MAIL" / "SEND.TO.BACK" / "SERIES.AXES" / "SERIES.ORDER" / "SERIES.X" / "SERIES.Y" / "SET.CONTROL.VALUE" / "SET.CRITERIA" / "SET.DATABASE" / "SET.DIALOG.DEFAULT" / "SET.DIALOG.FOCUS" / "SET.EXTRACT" / "SET.LIST.ITEM" / "SET.PAGE.BREAK" / "SET.PREFERRED" / "SET.PRINT.AREA" / "SET.PRINT.TITLES" / "SET.UPDATE.STATUS" / "SHARE" / "SHARE.NAME" / "SHEET.BACKGROUND" / "SHORT.MENUS" / "SHOW.ACTIVE.CELL" / "SHOW.CLIPBOARD" / "SHOW.DETAIL" / "SHOW.DIALOG" / "SHOW.INFO" / "SHOW.LEVELS" / "SHOW.TOOLBAR" / "SORT" / "SORT.SPECIAL" / "SOUND.NOTE" / "SOUND.PLAY" / "SPELLING" / "SPLIT" / "STANDARD.FONT" / "STANDARD.WIDTH" / "STYLE" / "SUBSCRIBE.TO" / "SUBTOTAL.CREATE" / "SUBTOTAL.REMOVE" / "SUMMARY.INFO" / "TAB.ORDER" / "TABLE" / "TEXT.TO.COLUMNS" / "TRACER.CLEAR" / "TRACER.DISPLAY" / "TRACER.ERROR" / "TRACER.NAVIGATE" / "TRAVERSE.NOTES" / "UNDO" / "UNGROUP" / "UNGROUP.SHEETS" / "UNHIDE" / "UNLOCKED.NEXT" / "UNLOCKED.PREV" / "UNPROTECT.REVISIONS" / "UPDATE.LINK" / "VBA.INSERT.FILE" / "VBA.MAKE.ADDIN" / "VBA.PROCEDURE.DEFINITION" / "VBAActivate" / "VIEW.3D" / "VIEW.DEFINE" / "VIEW.DELETE" / "VIEW.SHOW" / "VLINE" / "VPAGE" / "VSCROLL" / "WAIT" / "WEB.PUBLISH" / "WINDOW.MAXIMIZE" / "WINDOW.MINIMIZE" / "WINDOW.MOVE" / "WINDOW.RESTORE" / "WINDOW.SIZE" / "WORKBOOK.ACTIVATE" / "WORKBOOK.ADD" / "WORKBOOK.COPY" / "WORKBOOK.DELETE" / "WORKBOOK.HIDE" / "WORKBOOK.INSERT" / "WORKBOOK.MOVE" / "WORKBOOK.NAME" / "WORKBOOK.NEW" / "WORKBOOK.NEXT" / "WORKBOOK.OPTIONS" / "WORKBOOK.PREV" / "WORKBOOK.PROTECT" / "WORKBOOK.SCROLL" / "WORKBOOK.SELECT" / "WORKBOOK.TAB.SPLIT" / "WORKBOOK.UNHIDE" / "WORKGROUP" / "WORKGROUP.OPTIONS" / "WORKSPACE" / "ZOOM") \["?"\] + + future-function-list = ("\_xlfn." ("AGGREGATE" / "ACOT" / ref"ACOTH" / "ARABIC" / "BASE" / "BETA.DIST" / "BETA.INV" / "BINOM.DIST" / "BINOM.DIST.RANGE" / "BINOM.INV" / "BITAND" / "BITLSHIFT" / "BITOR" / "BITRSHIFT" / "BITXOR" / "BYCOL" / "BYROW" / "CEILING.MATH" / "CEILING.PRECISE" / "CHISQ.DIST" / "CHISQ.DIST.RT" / "CHISQ.INV" / "CHISQ.INV.RT" / "CHISQ.TEST" / "CHOOSECOLS" / "CHOOSEROWS" / "COMBINA" / "CONFIDENCE.NORM" / "CONFIDENCE.T" / "COPILOT" / "COT" / "COTH" / "COVARIANCE.P" / "COVARIANCE.S" / "CSC" / "CSCH" / "DAYS" / "DECIMAL" / "DROP" /"ERF.PRECISE" / "ERFC.PRECISE" / "EXPAND" / "EXPON.DIST" / "F.DIST" / "F.DIST.RT" / "F.INV" / "F.INV.RT" / "F.TEST" / "FIELDVALUE" / "FILTERXML" / "FLOOR.MATH" / "FLOOR.PRECISE" / "FORMULATEXT" / "GAMMA" / "GAMMA.DIST" / "GAMMA.INV" / "GAMMALN.PRECISE" / "GAUSS" / "HSTACK" /"HYPGEOM.DIST" / "IFNA" / "IMCOSH" / "IMCOT" / "IMCSC" / "IMCSCH" / "IMSEC" / "IMSECH" / "IMSINH" / "IMTAN" / "ISFORMULA" / "ISOMITTED" / "ISOWEEKNUM" / "LAMBDA" / "LET" / "LOGNORM.DIST" / "LOGNORM.INV" / "LONGTEXT" / "MAKEARRAY" / "MAP" / "MODE.MULT" / "MODE.SNGL" / "MUNIT" / "NEGBINOM.DIST" / "NORM.DIST" / "NORM.INV" / "NORM.S.DIST" / "NORM.S.INV" / "NUMBERVALUE" / "PDURATION" / "PERCENTILE.EXC" / "PERCENTILE.INC" / "PERCENTRANK.EXC" / "PERCENTRANK.INC" / "PERMUTATIONA" / "PHI" / "POISSON.DIST" / "PQSOURCE" / "PYTHON_STR" / "PYTHON_TYPE" / "PYTHON_TYPENAME"/ "QUARTILE.EXC" / "QUARTILE.INC" / "QUERYSTRING" / "RANDARRAY" / "RANK.AVG" / "RANK.EQ" / "REDUCE" / "RRI" / "SCAN" / "SEC" / "SECH" / "SEQUENCE" / "SHEET" / "SHEETS" / "SKEW.P" / "SORTBY" / "STDEV.P" / "STDEV.S" / "T.DIST" / "T.DIST.2T" / "T.DIST.RT" / "T.INV" / "T.INV.2T" / "T.TEST" / "TAKE" / "TEXTAFTER" / "TEXTBEFORE" / "TEXTSPLIT" / "TOCOL" / "TOROW" / "UNICHAR" / "UNICODE" / "UNIQUE" / "VAR.P" / "VAR.S" / "VSTACK" / "WEBSERVICE" / "WEIBULL.DIST" / "WRAPCOLS" / "WRAPROWS" / "XLOOKUP" /"XOR" / "Z.TEST")) / "ECMA.CEILING" / "ISO.CEILING" / "NETWORKDAYS.INTL" / "WORKDAY.INTL" / "FORECAST.ETS" / "FORECAST.ETS.CONFINT" / "FORECAST.ETS.SEASONALITY" / "FORECAST.LINEAR" / "FORECAST.ETS.STAT" + + ref-function-call = "CHOOSE" choose-params / "IF" if-params / "IF" if-worksheet-params / "INDEX" index-params / "INDIRECT" indirect-params / "OFFSET" offset-params + + future-function-call = ("\_xlfn." ( ("ACOT" acot-params) / ("ACOTH" acoth-params) / ("AGGREGATE" aggregate-params) / ("ARABIC" arabic-params) / ("BASE" base-params) / ("BETA.DIST" beta-dist-params) / ("BETA.INV" beta-inv-params) / ("BINOM.DIST" binom-dist-params) / ("BINOM.DIST.RANGE" binom-dist-range-params) / ("BINOM.INV" binom-inv-params) / ("BITAND" bitand-params) / ("BITLSHIFT" bitlshift-params) / ("BITOR" bitor-params) / ("BITRSHIFT" bitrshift-params) / ("BITXOR" bitxor-params) / ("BYCOL" bycol-params) / ("BYROW" byrow-params) / ("CEILING.MATH" ceiling-math-params) / ("CEILING.PRECISE" ceiling-precise-params) / ("CHISQ.DIST" chisq-dist-params) / ("CHISQ.DIST.RT" chisq-dist-rt-params) / ("CHISQ.INV" chisq-inv-params) / ("CHISQ.INV.RT" chisq-inv-rt-params) / ("CHISQ.TEST" chisq-test-params) / ("CHOOSECOLS" choosecols-params) / ("CHOOSEROWS" chooserows-params) / ("COMBINA" combina-params) / ("CONFIDENCE.NORM" confidence-norm-params) / ("CONFIDENCE.T" confidence-t-params) / ("COPILOT" copilot-params) / ("COT" cot-params) / ("COTH" coth-params) / ("COVARIANCE.P" covariance-p-params) / ("COVARIANCE.S" covariance-s-params) / ("CSC" csc-params) / ("CSCH" csch-params) / ("DAYS" days-params) / ("DECIMAL" decimal-params) /("DROP" drop-params) / ("ERF.PRECISE" erf-precise-params) / ("ERFC.PRECISE" erfc-precise-params) /("EXPAND" expand-params) / ("EXPON.DIST" expon-dist-params) / ("F.DIST" f-dist-params) / ("F.DIST.RT" f-dist-rt-params) / ("F.INV" f-inv-params) / ("F.INV.RT" f-inv-rt-params) / ("F.TEST" f-test-params) / ("FIELDVALUE" fieldvalue-params) / ("FILTERXML" filterxml-params) / ("FLOOR.MATH" floor-math-params) / ("FLOOR.PRECISE" floor-precise-params) / ("FORMULATEXT" formulatext-params) / ("GAMMA" gamma-params) / ("GAMMA.DIST" gamma-dist-params) / ("GAMMA.INV" gamma-inv-params) / ("GAMMALN.PRECISE" gammaln-precise-params) / ("GAUSS" gauss-params) / ("HSTACK" hstack-params) / ("HYPGEOM.DIST" hypgeom-dist-params) / ("IFNA" ifna-params) / ("IMCOSH" imcosh-params) / ("IMCOT" imcot-params) / ("IMCSC" imcsc-params) / ("IMCSCH" imcsch-params) / ("IMSEC" imsec-params) / ("IMSECH" imsech-params) / ("IMSINH" imsinh-params) / ("IMTAN" imtan-params) / ("ISFORMULA" isformula-params) / ("ISOMITTED" isomitted-params) / ("ISOWEEKNUM" isoweeknum-params) / ("LAMBDA" lambda-params) / ("LET" let-params) / ("LOGNORM.DIST" lognorm-dist-params) / ("LOGNORM.INV" lognorm-inv-params) / ("LONGTEXT" longtext-params)/ ("MAKEARRAY" makearray-params) / ("MAP" map-params) / ("MODE.MULT" mode-mult-params) / ("MODE.SNGL" mode-sngl-params) / ("MUNIT" munit-params) / ("NEGBINOM.DIST" negbinom-dist-params) / ("NORM.DIST" norm-dist-params) / ("NORM.INV" norm-inv-params) / ("NORM.S.DIST" norm-s-dist-params) / ("NORM.S.INV" norm-s-inv-params) / ("NUMBERVALUE" numbervalue-params) / ("PDURATION" pduration-params) / ("PERCENTILE.EXC" percentile-exc-params) / ("PERCENTILE.INC" percentile-inc-params) / ("PERCENTRANK.EXC" percentrank-exc-params) / ("PERCENTRANK.INC" percentrank-inc-params) / ("PERMUTATIONA" permutationa-params) / ("PHI" phi-params) / ("POISSON.DIST" poisson-dist-params) / ("P QSOURCE" pqsource-params) / ("PYTHON_STR" python-str-params) / ("PYTHON_TYPE" python-type-params) / ("PYTHON_TYPENAME" python-typename-params) / ("QUARTILE.EXC" quartile-exc-params) / ("QUARTILE.INC" quartile-inc-params) / ("QUERYSTRING" querystring-params) / ("RANDARRAY" randarray-params) / ("RANK.AVG" rank-avg-params) / ("RANK.EQ" rank-eq-params) / ("REDUCE" reduce-params) / ("RRI" rri-params) / ("SCAN" scan-params) / ("SEC" sec-params) / ("SECH" sech-params) / ("SEQUENCE" sequence-params) / ("SHEET" sheet-params) / ("SHEETS" sheets-params) / ("SKEW.P" skew-p-params) / ("SORTBY" sortby-params) / ("STDEV.P" stdev-p-params) / ("STDEV.S" stdev-s-params) / ("T.DIST" t-dist-params) / ("T.DIST.2T" t-dist-2t-params) / ("T.DIST.RT" t-dist-rt-params) / ("T.INV" t-inv-params) / ("T.INV.2T" t-inv-2t-params) / ("T.TEST" t-test-params) / ("TAKE" take-params) / ("TEXTAFTER" textafter-params) / ("TEXTBEFORE" textbefore-params) / ("TEXTSPLIT" textsplit-params) / ("TOCOL" tocol-params) / ("TOROW" torow-params) / ("UNICHAR" unichar-params) / ("UNICODE" unicode-params) / ("UNIQUE" unique-params) / ("VAR.P" var-p-params) / ("VAR.S" var-s-params) / ("VSTACK" vstack-params) / ("WEBSERVICE" webservice-params) / ("WEIBULL.DIST" weibull-dist-params) / ("WRAPCOLS" wrapcols-params) / ("WRAPROWS" wraprows-params) / ("XLOOKUP" xlookup-params) / ("XOR" xor-params) / ("Z.TEST" z-test-params))) / ("ECMA.CEILING" ecma-ceiling-params) / ("ISO.CEILING" iso-ceiling-params) / ("NETWORKDAYS.INTL" networkdays-intl-params) / ("WORKDAY.INTL" workday-intl-params) / ("FORECAST.ETS" forecast-ets-params) / ("FORECAST.ETS.CONFINT" forecast-ets-confint-params) / ("FORECAST.ETS.SEASONALITY" forecast-ets—seasonality-params) / ("FORECAST.LINEAR" forecast-linear-params) / ("FORECAST.ETS.STAT" forecast-ets-stat-params) + + function-call = ref-function-call / future-function-call / worksheet-only-function-call / cell-function-call / user-defined-function-call / "ABS" abs-params / "ACCRINT" accrint-params / "ACCRINTM" accrintm-params / "ACOS" acos-params / "ACOSH" acosh-params / "ADDRESS" address-params / "AMORDEGRC" amordegrc-params / "AMORLINC" amorlinc-params / "AND" and-params / "AREAS" areas-params / "ASC" asc-params / "ASIN" asin-params / "ASINH" asinh-params / "ATAN" atan-params / "ATAN2" atan2-params / "ATANH" atanh-params / "AVEDEV" avedev-params / "AVERAGE" average-params / "AVERAGEA" averagea-params / "AVERAGEIF" averageif-params / "AVERAGEIFS" averageifs-params / "BAHTTEXT" bahttext-params / "BESSELI" besseli-params / "BESSELJ" besselj-params / "BESSELK" besselk-params / "BESSELY" bessely-params / "BETADIST" betadist-params / "BETAINV" betainv-params / "BIN2DEC" bin2dec-params / "BIN2HEX" bin2hex-params / "BIN2OCT" bin2oct-params / "BINOMDIST" binomdist-params / "CEILING" ceiling-params / "CELL" cell-params / "CHAR" char-params / "CHIDIST" chidist-params / "CHIINV" chiinv-params / "CHITEST" chitest-params / "CLEAN" clean-params / "CODE" code-params / "COLUMN" column-params / "COLUMNS" columns-params / "COMBIN" combin-params / "COMPLEX" complex-params / "CONCAT" concat-params / "CONCATENATE" concatenate-params / "CONFIDENCE" confidence-params / "CONVERT" convert-params / "CORREL" correl-params / "COS" cos-params / "COSH" cosh-params / "COUNT" count-params / "COUNTA" counta-params / "COUNTBLANK" countblank-params / "COUNTIF" countif-params / "COUNTIFS" countifs-params / "COUPDAYBS" coupdaybs-params / "COUPDAYS" coupdays-params / "COUPDAYSNC" coupdaysnc-params / "COUPNCD" coupncd-params / "COUPNUM" coupnum-params / "COUPPCD" couppcd-params / "COVAR" covar-params / "CRITBINOM" critbinom-params / "CUBEKPIMEMBER" cubekpimember-params / "CUBEMEMBER" cubemember-params / "CUBEMEMBERPROPERTY" cubememberproperty-params / "CUBERANKEDMEMBER" cuberankedmember-params / "CUBESET" cubeset-params / "CUBESETCOUNT" cubesetcount-params / "CUBEVALUE" cubevalue-params / "CUMIPMT" cumipmt-params / "CUMPRINC" cumprinc-params / "DATE" date-params / "DATEDIF" datedif-params / "DATESTRING" datestring-params / "DATEVALUE" datevalue-params / "DAVERAGE" daverage-params / "DAY" day-params / "DAYS360" days360-params / "DB" db-params / "DBCS" dbcs-params / "DCOUNT" dcount-params / "DCOUNTA" dcounta-params / "DDB" ddb-params / "DEC2BIN" dec2bin-params / "DEC2HEX" dec2hex-params / "DEC2OCT" dec2oct-params / "DEGREES" degrees-params / "DELTA" delta-params / "DEVSQ" devsq-params / "DGET" dget-params / "DISC" disc-params / "DMAX" dmax-params / "DMIN" dmin-params / "DOLLAR" dollar-params / "DOLLARDE" dollarde-params / "DOLLARFR" dollarfr-params / "DPRODUCT" dproduct-params / "DSTDEV" dstdev-params / "DSTDEVP" dstdevp-params / "DSUM" dsum-params / "DURATION" duration-params / "DVAR" dvar-params / "DVARP" dvarp-params / "EDATE" edate-params / "EFFECT" effect-params / "EOMONTH" eomonth-params / "ERF" erf-params / "ERFC" erfc-params / "ERROR.TYPE" error-type-params / "EVEN" even-params / "EXACT" exact-params / "EXP" exp-params / "EXPONDIST" expondist-params / "FACT" fact-params / "FACTDOUBLE" factdouble-params / "FALSE" false-params / "FDIST" fdist-params / "FIND" find-params / "FINDB" findb-params / "FINV" finv-params / "FISHER" fisher-params / "FISHERINV" fisherinv-params / "FIXED" fixed-params / "FLOOR" floor-params / "FORECAST" forecast-params / "FREQUENCY" frequency-params / "FTEST" ftest-params / "FV" fv-params / "FVSCHEDULE" fvschedule-params / "GAMMADIST" gammadist-params / "GAMMAINV" gammainv-params / "GAMMALN" gammaln-params / "GCD" gcd-params / "GEOMEAN" geomean-params / "GESTEP" gestep-params / "GETPIVOTDATA" getpivotdata-params / "GROWTH" growth-params / "HARMEAN" harmean-params / "HEX2BIN" hex2bin-params / "HEX2DEC" hex2dec-params / "HEX2OCT" hex2oct-params / "HLOOKUP" hlookup-params / "HOUR" hour-params / "HYPERLINK" hyperlink-params / "HYPGEOMDIST" hypgeomdist-params / "IFS" ifs-params / "IFERROR" iferror-params / "IMABS" imabs-params / "IMAGINARY" imaginary-params / "IMARGUMENT" imargument-params / "IMCONJUGATE" imconjugate-params / "IMCOS" imcos-params / "IMDIV" imdiv-params / "IMEXP" imexp-params / "IMLN" imln-params / "IMLOG10" imlog10-params / "IMLOG2" imlog2-params / "IMPOWER" impower-params / "IMPRODUCT" improduct-params / "IMREAL" imreal-params / "IMSIN" imsin-params / "IMSQRT" imsqrt-params / "IMSUB" imsub-params / "IMSUM" imsum-params / "INFO" info-params / "INT" int-params / "INTERCEPT" intercept-params / "INTRATE" intrate-params / "IPMT" ipmt-params / "IRR" irr-params / "ISBLANK" isblank-params / "ISERR" iserr-params / "ISERROR" iserror-params / "ISEVEN" iseven-params / "ISLOGICAL" islogical-params / "ISNA" isna-params / "ISNONTEXT" isnontext-params / "ISNUMBER" isnumber-params / "ISODD" isodd-params / "ISPMT" ispmt-params / "ISREF" isref-params / "ISTEXT" istext-params / "ISTHAIDIGIT" isthaidigit-params / "KURT" kurt-params / "LARGE" large-params / "LCM" lcm-params / "LEFT" left-params / "LEFTB" leftb-params / "LEN" len-params / "LENB" lenb-params / "LINEST" linest-params / "LN" ln-params / "LOG" log-params / "LOG10" log10-params / "LOGEST" logest-params / "LOGINV" loginv-params / "LOGNORMDIST" lognormdist-params / "LOOKUP" lookup-params / "LOWER" lower-params / "MATCH" match-params / "MAX" max-params / "MAXA" maxa-params / "MAXIFS" maxifs-params / "MDETERM" mdeterm-params / "MDURATION" mduration-params / "MEDIAN" median-params / "MID" mid-params / "MIDB" midb-params / "MIN" min-params / "MINA" mina-params / "MINIFS" minifs-params / "MINUTE" minute-params / "MINVERSE" minverse-params / "MIRR" mirr-params / "MMULT" mmult-params / "MOD" mod-params / "MODE" mode-params / "MONTH" month-params / "MROUND" mround-params / "MULTINOMIAL" multinomial-params / "N" n-params / "NA" na-params / "NEGBINOMDIST" negbinomdist-params / "NETWORKDAYS" networkdays-params / "NOMINAL" nominal-params / "NORMDIST" normdist-params / "NORMINV" norminv-params / "NORMSDIST" normsdist-params / "NORMSINV" normsinv-params / "NOT" not-params / "NOW" now-params / "NPER" nper-params / "NPV" npv-params / "NUMBERSTRING" numberstring-params / "OCT2BIN" oct2bin-params / "OCT2DEC" oct2dec-params / "OCT2HEX" oct2hex-params / "ODD" odd-params / "ODDFPRICE" oddfprice-params / "ODDFYIELD" oddfyield-params / "ODDLPRICE" oddlprice-params / "ODDLYIELD" oddlyield-params / "OR" or-params / "PEARSON" pearson-params / "PERCENTILE" percentile-params / "PERCENTRANK" percentrank-params / "PERMUT" permut-params / "PHONETIC" phonetic-params / "PI" pi-params / "PMT" pmt-params / "POISSON" poisson-params / "POWER" power-params / "PPMT" ppmt-params / "PRICE" price-params / "PRICEDISC" pricedisc-params / "PRICEMAT" pricemat-params / "PROB" prob-params / "PRODUCT" product-params / "PROPER" proper-params / "PV" pv-params / "QUARTILE" quartile-params / "QUOTIENT" quotient-params / "RADIANS" radians-params / "RAND" rand-params / "RANDBETWEEN" randbetween-params / "RANK" rank-params / "RATE" rate-params / "RECEIVED" received-params / "REPLACE" replace-params / "REPLACEB" replaceb-params / "REPT" rept-params / "RIGHT" right-params / "RIGHTB" rightb-params / "ROMAN" roman-params / "ROUND" round-params / "ROUNDBAHTDOWN" roundbahtdown-params / "ROUNDBAHTUP" roundbahtup-params / "ROUNDDOWN" rounddown-params / "ROUNDUP" roundup-params / "ROW" row-params / "ROWS" rows-params / "RSQ" rsq-params / "RTD" rtd-params / "SEARCH" search-params / "SEARCHB" searchb-params / "SECOND" second-params / "SERIES" series-params / "SERIESSUM" seriessum-params / "SIGN" sign-params / "SIN" sin-params / "SINH" sinh-params / "SKEW" skew-params / "SLN" sln-params / "SLOPE" slope-params / "SMALL" small-params / "SQRT" sqrt-params / "SQRTPI" sqrtpi-params / "STANDARDIZE" standardize-params / "STDEV" stdev-params / "STDEVA" stdeva-params / "STDEVP" stdevp-params / "STDEVPA" stdevpa-params / "STEYX" steyx-params / "SUBSTITUTE" substitute-params / "SUBTOTAL" subtotal-params / "SUM" sum-params / "SUMIF" sumif-params / "SUMIFS" sumifs-params / "SUMPRODUCT" sumproduct-params / "SUMSQ" sumsq-params / "SUMX2MY2" sumx2my2-params / "SUMX2PY2" sumx2py2-params / "SUMXMY2" sumxmy2-params / "SWITCH" switch-params / "SYD" syd-params / "T" t-params / "TAN" tan-params / "TANH" tanh-params / "TBILLEQ" tbilleq-params / "TBILLPRICE" tbillprice-params / "TBILLYIELD" tbillyield-params / "TDIST" tdist-params / "TEXT" text-params / "TEXTJOIN" textjoin-params / "THAIDAYOFWEEK" thaidayofweek-params / "THAIDIGIT" thaidigit-params / "THAIMONTHOFYEAR" thaimonthofyear-params / "THAINUMSOUND" thainumsound-params / "THAINUMSTRING" thainumstring-params / "THAISTRINGLENGTH" thaistringlength-params / "THAIYEAR" thaiyear-params / "TIME" time-params / "TIMEVALUE" timevalue-params / "TINV" tinv-params / "TODAY" today-params / "TRANSPOSE" transpose-params / "TREND" trend-params / "TRIM" trim-params / "TRIMMEAN" trimmean-params / "TRUE" true-params / "TRUNC" trunc-params / "TTEST" ttest-params / "TYPE" type-params / "UPPER" upper-params / "USDOLLAR" usdollar-params / "VALUE" value-params / "VAR" var-params / "VARA" vara-params / "VARP" varp-params / "VARPA" varpa-params / "VDB" vdb-params / "VLOOKUP" vlookup-params / "WEEKDAY" weekday-params / "WEEKNUM" weeknum-params / "WEIBULL" weibull-params / "WORKDAY" workday-params / "XIRR" xirr-params / "XNPV" xnpv-params / "YEAR" year-params / "YEARFRAC" yearfrac-params / "YIELD" yield-params / "YIELDDISC" yielddisc-params / "YIELDMAT" yieldmat-params / "ZTEST" ztest-params + + worksheet-only-function-list = ("\_xlfn.\_xlws." ("FILTER" / "PY" / "SORT") + + worksheet-only-function-call = ("\_xlfn.\_xlws." (("FILTER" filter-worksheet-params) / ("SORT" sort-worksheet-params))) + + emptyparams = "(" \*whitespace ")" + + abs-params = "(" argument-expression ")" + + accrintm-params = "(" argument "," argument "," argument "," argument \["," argument\] ")" + + accrint-params = "(" argument "," argument "," argument "," argument "," argument "," argument \["," argument \["," argument\]\] ")" + + acosh-params = "(" argument-expression ")" + + acos-params = "(" argument-expression ")" + + acoth-params = "(" argument-expression ")" + + acot-params = "(" argument-expression ")" + + address-params = "(" argument "," argument \["," argument \["," argument \["," argument\]\]\] ")" + + aggregate-params = "(" argument "," argument "," argument \["," argument \["," ref-argument-expression \*249("," ref-argument-expression )\]\] ")" + + amordegrc-params = "(" argument "," argument "," argument "," argument "," argument "," argument \["," argument\] ")" + + amorlinc-params = "(" argument "," argument "," argument "," argument "," argument "," argument \["," argument\] ")" + + and-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + arabic-params = "(" argument-expression ")" + + areas-params = "(" ref-argument-expression ")" + + asc-params = "(" argument-expression ")" + + asinh-params = "(" argument-expression ")" + + asin-params = "(" argument-expression ")" + + atan2-params = "(" argument "," argument ")" + + atanh-params = "(" argument-expression ")" + + atan-params = "(" argument-expression ")" + + avedev-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + averagea-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + averageif-params = "(" ref-argument-expression "," argument \["," ref-argument-expression \] ")" + + averageifs-params = "(" ref-argument-expression "," ref-argument-expression "," argument \*126("," ref-argument-expression "," argument) ")" + + average-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + bahttext-params = "(" argument-expression ")" + + base-params = "(" argument "," argument \["," argument\] ")" + + besseli-params = "(" argument "," argument ")" + + besselj-params = "(" argument "," argument ")" + + besselk-params = "(" argument "," argument ")" + + bessely-params = "(" argument "," argument ")" + + beta-dist-params = "(" argument "," argument "," argument "," argument \["," argument \["," argument\]\] ")" + + betadist-params = "(" argument "," argument "," argument \["," argument \["," argument\]\] ")" + + betainv-params = "(" argument "," argument "," argument \["," argument \["," argument\]\] ")" + + beta-inv-params = "(" argument "," argument "," argument \["," argument \["," argument\]\] ")" + + bin2dec-params = "(" argument-expression ")" + + bin2hex-params = "(" (argument-expression / (argument "," argument)) ")" + + bin2oct-params = "(" (argument-expression / (argument "," argument)) ")" + + binom-dist-range-params = "(" argument "," argument "," argument \["," argument\] ")" + + binomdist-params = "(" argument "," argument "," argument "," argument ")" + + binom-dist-params = "(" argument "," argument "," argument "," argument ")" + + binom-inv-params = "(" argument "," argument "," argument ")" + + bitand-params = "(" argument "," argument ")" + + bitlshift-params = "(" argument "," argument ")" + + bitor-params = "(" argument "," argument ")" + + bitrshift-params = "(" argument "," argument ")" + + bitxor-params = "(" argument "," argument ")" + + bycol-params = "(" argument \["," argument\] ")" + + byrow-params = "(" argument \["," argument\] ")" + + ceiling-math-params = "(" (argument-expression / (argument "," argument \["," argument\])) ")" + + ceiling-params = "(" argument "," argument ")" + + ceiling-precise-params = "(" argument "," argument ")" + + cell-params = "(" (argument-expression / (argument "," ref-argument-expression )) ")" + + char-params = "(" argument-expression ")" + + chidist-params = "(" argument "," argument ")" + + chiinv-params = "(" argument "," argument ")" + + chisq-dist-params = "(" argument "," argument "," argument ")" + + chisq-dist-rt-params = "(" argument "," argument ")" + + chisq-inv-params = "(" argument "," argument ")" + + chisq-inv-rt-params = "(" argument "," argument ")" + + chisq-test-params = "(" argument "," argument ")" + + chitest-params = "(" argument "," argument ")" + + choose-params = "(" argument "," argument \*253("," argument) ")" + + choosecols-params = "(" argument 1\*253("," argument) ")" + + chooserows-params = "(" argument 1\*253("," argument) ")" + + clean-params = "(" argument-expression ")" + + code-params = "(" argument-expression ")" + + column-params = "(" \[ref-argument-expression \] ")" + + columns-params = "(" argument-expression ")" + + combina-params = "(" argument "," argument ")" + + combin-params = "(" argument "," argument ")" + + complex-params = "(" argument "," argument \["," argument\] ")" + + concat-params = "(" (argument-expression / (argument 1\*253("," argument))) ")" + + concatenate-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + confidence-norm-params = "(" argument "," argument "," argument ")" + + confidence-params = "(" argument "," argument "," argument ")" + + confidence-t-params = "(" argument "," argument "," argument ")" + + convert-params = "(" argument "," argument "," argument ")" + + correl-params = "(" argument "," argument ")" + + cosh-params = "(" argument-expression ")" + + cos-params = "(" argument-expression ")" + + coth-params = "(" argument-expression ")" + + copilot-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + cot-params = "(" argument-expression ")" + + counta-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + countblank-params = "(" ref-argument-expression ")" + + countif-params = "(" ref-argument-expression "," argument ")" + + countifs-params = "(" ref-argument-expression "," argument \*126("," ref-argument-expression "," argument) ")" + + count-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + coupdaybs-params = "(" argument "," argument "," argument \["," argument\] ")" + + coupdaysnc-params = "(" argument "," argument "," argument \["," argument\] ")" + + coupdays-params = "(" argument "," argument "," argument \["," argument\] ")" + + coupncd-params = "(" argument "," argument "," argument \["," argument\] ")" + + coupnum-params = "(" argument "," argument "," argument \["," argument\] ")" + + couppcd-params = "(" argument "," argument "," argument \["," argument\] ")" + + covariance-p-params = "(" argument "," argument ")" + + covariance-s-params = "(" argument "," argument ")" + + covar-params = "(" argument "," argument ")" + + critbinom-params = "(" argument "," argument "," argument ")" + + csch-params = "(" argument-expression ")" + + csc-params = "(" argument-expression ")" + + cubekpimember-params = "(" argument "," argument "," argument \["," argument\] ")" + + cubemember-params = "(" argument "," argument \["," argument\] ")" + + cubememberproperty-params = "(" argument "," argument "," argument ")" + + cuberankedmember-params = "(" argument "," argument "," argument \["," argument\] ")" + + cubesetcount-params = "(" argument-expression ")" + + cubeset-params = "(" argument "," argument \["," argument \["," argument \["," argument\]\]\] ")" + + cubevalue-params = "(" (argument-expression / (argument "," argument \*253("," argument))) ")" + + cumipmt-params = "(" argument "," argument "," argument "," argument "," argument "," argument ")" + + cumprinc-params = "(" argument "," argument "," argument "," argument "," argument "," argument ")" + + datedif-params = "(" argument "," argument "," argument ")" + + date-params = "(" argument "," argument "," argument ")" + + datestring-params = "(" argument-expression ")" + + datevalue-params = "(" argument-expression ")" + + daverage-params = "(" ref-argument-expression "," argument "," argument ")" + + day-params = "(" argument-expression ")" + + days360-params = "(" argument "," argument \["," argument\] ")" + + days-params = "(" argument "," argument ")" + + dbcs-params = "(" argument-expression ")" + + db-params = "(" argument "," argument "," argument "," argument \["," argument\] ")" + + dcounta-params = "(" ref-argument-expression "," argument "," argument ")" + + dcount-params = "(" ref-argument-expression "," argument "," argument ")" + + ddb-params = "(" argument "," argument "," argument "," argument \["," argument\] ")" + + dec2bin-params = "(" (argument-expression / (argument "," argument)) ")" + + dec2hex-params = "(" (argument-expression / (argument "," argument)) ")" + + dec2oct-params = "(" (argument-expression / (argument "," argument)) ")" + + decimal-params = "(" argument "," argument ")" + + degrees-params = "(" argument-expression ")" + + delta-params = "(" (argument-expression / (argument "," argument)) ")" + + devsq-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + dget-params = "(" ref-argument-expression "," argument "," argument ")" + + disc-params = "(" argument "," argument "," argument "," argument \["," argument\] ")" + + dmax-params = "(" ref-argument-expression "," argument "," argument ")" + + dmin-params = "(" ref-argument-expression "," argument "," argument ")" + + dollarde-params = "(" argument "," argument ")" + + dollarfr-params = "(" argument "," argument ")" + + dollar-params = "(" (argument-expression / (argument "," argument)) ")" + + dproduct-params = "(" ref-argument-expression "," argument "," argument ")" + + drop-params = "(" argument 1\*2("," argument) ")" + + dstdev-params = "(" ref-argument-expression "," argument "," argument ")" + + dstdevp-params = "(" ref-argument-expression "," argument "," argument ")" + + dsum-params = "(" ref-argument-expression "," argument "," argument ")" + + duration-params = "(" argument "," argument "," argument "," argument "," argument \["," argument\] ")" + + dvar-params = "(" ref-argument-expression "," argument "," argument ")" + + dvarp-params = "(" ref-argument-expression "," argument "," argument ")" + + ecma-ceiling-params = "(" argument "," argument ")" + + edate-params = "(" argument "," argument ")" + + effect-params = "(" argument "," argument ")" + + eomonth-params = "(" argument "," argument ")" + + erfc-params = "(" argument-expression ")" + + erfc-precise-params = "(" argument-expression ")" + + erf-params = "(" (argument-expression / (argument "," argument)) ")" + + erf-precise-params = "(" argument-expression ")" + + error-type-params = "(" argument-expression ")" + + even-params = "(" argument-expression ")" + + exact-params = "(" argument "," argument ")" + + expondist-params = "(" argument "," argument "," argument ")" + + expon-dist-params = "(" argument "," argument "," argument ")" + + exp-params = "(" argument-expression ")" + + expand-params = "(" argument 1\*3("," argument) ")" + + factdouble-params = "(" argument-expression ")" + + fact-params = "(" argument-expression ")" + + false-params = emptyparams + + fdist-params = "(" argument "," argument "," argument ")" + + f-dist-params = "(" argument "," argument "," argument "," argument ")" + + f-dist-rt-params = "(" argument "," argument "," argument ")" + + fieldvalue-params = "(" argument "," argument ")" + + filter-worksheet-params = "(" argument "," argument 1\*2("," argument) ")" + + filterxml-params = "(" argument "," argument ")" + + findb-params = "(" argument "," argument \["," argument\] ")" + + find-params = "(" argument "," argument \["," argument\] ")" + + finv-params = "(" argument "," argument "," argument ")" + + f-inv-params = "(" argument "," argument "," argument ")" + + f-inv-rt-params = "(" argument "," argument "," argument ")" + + fisherinv-params = "(" argument-expression ")" + + fisher-params = "(" argument-expression ")" + + fixed-params = "(" (argument-expression / (argument "," argument \["," argument\])) ")" + + floor-math-params = "(" (argument-expression / (argument "," argument \["," argument\])) ")" + + floor-params = "(" argument "," argument ")" + + floor-precise-params = "(" argument "," argument ")" + + forecast-params = "(" argument "," argument "," argument ")" + + forecast-linear-params = "(" argument "," argument "," argument ")" + + forecast-ets-params = "(" argument "," argument "," argument \["," argument\] \["," argument\] \["," argument\] ")" + + forecast-ets-confint-params = "(" argument "," argument "," argument \["," argument\] \["," argument\] \["," argument\] \["," argument\] ")" + + forecast-ets-seasonality-params = "(" argument "," argument \["," argument\] \["," argument\] ")" + + forecast-ets-stat-params = "(" argument "," argument "," argument \["," argument\] \["," argument\] \["," argument\] ")" + + formulatext-params = "(" ref-argument-expression ")" + + frequency-params = "(" argument "," argument ")" + + ftest-params = "(" argument "," argument ")" + + f-test-params = "(" argument "," argument ")" + + fv-params = "(" argument "," argument "," argument \["," argument \["," argument\]\] ")" + + fvschedule-params = "(" argument "," argument ")" + + gammadist-params = "(" argument "," argument "," argument "," argument ")" + + gamma-dist-params = "(" argument "," argument "," argument "," argument ")" + + gammainv-params = "(" argument "," argument "," argument ")" + + gamma-inv-params = "(" argument "," argument "," argument ")" + + gammaln-params = "(" argument-expression ")" + + gammaln-precise-params = "(" argument-expression ")" + + gamma-params = "(" argument-expression ")" + + gauss-params = "(" argument-expression ")" + + gcd-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + geomean-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + gestep-params = "(" (argument-expression / (argument "," argument)) ")" + + getpivotdata-params = "(" argument "," argument \["," argument \["," argument \*125("," argument "," argument)\]\] ")" + + growth-params = "(" (argument-expression / (argument "," argument \["," argument \["," argument\]\])) ")" + + harmean-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + hex2bin-params = "(" (argument-expression / (argument "," argument)) ")" + + hex2dec-params = "(" argument-expression ")" + + hex2oct-params = "(" (argument-expression / (argument "," argument)) ")" + + hlookup-params = "(" argument "," argument "," argument \["," argument\] ")" + + hour-params = "(" argument-expression ")" + + hstack-params = "(" (argument-expression / (argument 1\*253("," argument))) ")" + + hyperlink-params = "(" (argument-expression / (argument "," argument)) ")" + + hypgeomdist-params = "(" argument "," argument "," argument "," argument ")" + + hypgeom-dist-params = "(" argument "," argument "," argument "," argument "," argument ")" + + iferror-params = "(" argument "," argument ")" + + ifna-params = "(" argument "," argument ")" + + if-params = "(" (argument-expression / (argument "," argument \["," argument\])) ")" + + ifs-params = "(" argument "," argument \*126(","argument "," argument) ")" + + if-worksheet-params = "(" argument "," argument 1\*2("," argument) ")" + + imabs-params = "(" argument-expression ")" + + imaginary-params = "(" argument-expression ")" + + imargument-params = "(" argument-expression ")" + + imconjugate-params = "(" argument-expression ")" + + imcosh-params = "(" argument-expression ")" + + imcos-params = "(" argument-expression ")" + + imcot-params = "(" argument-expression ")" + + imcsch-params = "(" argument-expression ")" + + imcsc-params = "(" argument-expression ")" + + imdiv-params = "(" argument "," argument ")" + + imexp-params = "(" argument-expression ")" + + imln-params = "(" argument-expression ")" + + imlog10-params = "(" argument-expression ")" + + imlog2-params = "(" argument-expression ")" + + impower-params = "(" argument "," argument ")" + + improduct-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + imreal-params = "(" argument-expression ")" + + imsech-params = "(" argument-expression ")" + + imsec-params = "(" argument-expression ")" + + imsinh-params = "(" argument-expression ")" + + imsin-params = "(" argument-expression ")" + + imsqrt-params = "(" argument-expression ")" + + imsub-params = "(" argument "," argument ")" + + imsum-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + imtan-params = "(" argument-expression ")" + + index-params = "(" argument "," argument \["," argument \["," argument\]\] ")" + + indirect-params = "(" (argument-expression / (argument "," argument)) ")" + + info-params = "(" argument-expression ")" + + intercept-params = "(" argument "," argument ")" + + int-params = "(" argument-expression ")" + + intrate-params = "(" argument "," argument "," argument "," argument \["," argument\] ")" + + ipmt-params = "(" argument "," argument "," argument "," argument \["," argument \["," argument\]\] ")" + + irr-params = "(" (argument-expression / (argument "," argument)) ")" + + isblank-params = "(" argument-expression ")" + + iserror-params = "(" argument-expression ")" + + iserr-params = "(" argument-expression ")" + + iseven-params = "(" argument-expression ")" + + isformula-params = "(" ref-argument-expression ")" + + islogical-params = "(" argument-expression ")" + + isna-params = "(" argument-expression ")" + + isnontext-params = "(" argument-expression ")" + + isnumber-params = "(" argument-expression ")" + + iso-ceiling-params = "(" (argument-expression / (argument "," argument)) ")" + + isodd-params = "(" argument-expression ")" + + isomitted-params = "(" argument-expression ")" + + isoweeknum-params = "(" argument-expression ")" + + ispmt-params = "(" argument "," argument "," argument "," argument ")" + + isref-params = "(" argument-expression ")" + + istext-params = "(" argument-expression ")" + + isthaidigit-params = "(" argument-expression ")" + + kurt-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + lambda-params = "(" \*252(lambda-parameter-name ",") argument ")" + + large-params = "(" argument "," argument ")" + + lcm-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + leftb-params = "(" (argument-expression / (argument "," argument)) ")" + + left-params = "(" (argument-expression / (argument "," argument)) ")" + + lenb-params = "(" argument-expression ")" + + len-params = "(" argument-expression ")" + + let-params = "(" 1\*126(parameter-name "," argument) "," argument ")" + + linest-params = "(" (argument-expression / (argument "," argument \["," argument \["," argument\]\])) ")" + + ln-params = "(" argument-expression ")" + + log10-params = "(" argument-expression ")" + + logest-params = "(" (argument-expression / (argument "," argument \["," argument \["," argument\]\])) ")" + + loginv-params = "(" argument "," argument "," argument ")" + + lognormdist-params = "(" argument "," argument "," argument ")" + + lognorm-dist-params = "(" argument "," argument "," argument "," argument ")" + + lognorm-inv-params = "(" argument "," argument "," argument ")" + + log-params = "(" (argument-expression / (argument "," argument)) ")" + + longtext-params = "( " (string-constant 1\*16("," string-constant)) ")" + + lookup-params = "(" argument "," argument \["," argument\] ")" + + lower-params = "(" argument-expression ")" + + makearray-params = "(" argument "," argument "," argument ")" + + map-params = "(" 2\*252(argument ",") argument ")" + + match-params = "(" argument "," argument \["," argument\] ")" + + maxa-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + max-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + maxifs-params = "(" ref-argument-expression "," ref-argument-expression "," argument \*125("," ref-argument-expression "," argument) ")" + + mdeterm-params = "(" argument-expression ")" + + mduration-params = "(" argument "," argument "," argument "," argument "," argument \["," argument\] ")" + + median-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + midb-params = "(" argument "," argument "," argument ")" + + mid-params = "(" argument "," argument "," argument ")" + + mina-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + min-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + minifs-params = "(" ref-argument-expression "," ref-argument-expression "," argument \*125("," ref-argument-expression "," argument) ")" + + minute-params = "(" argument-expression ")" + + minverse-params = "(" argument-expression ")" + + mirr-params = "(" argument "," argument "," argument ")" + + mmult-params = "(" argument "," argument ")" + + mode-mult-params = "(" (argument-expression / (argument 1\*253("," argument))) ")" + + mode-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + mode-sngl-params = "(" (argument-expression / (argument 1\*253("," argument))) ")" + + mod-params = "(" argument "," argument ")" + + month-params = "(" argument-expression ")" + + mround-params = "(" argument "," argument ")" + + multinomial-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + munit-params = "(" argument-expression ")" + + na-params = emptyparams + + negbinomdist-params = "(" argument "," argument "," argument ")" + + negbinom-dist-params = "(" argument "," argument "," argument "," argument ")" + + networkdays-intl-params = "(" argument "," argument \["," argument \["," argument\]\] ")" + + networkdays-params = "(" argument "," argument \["," argument\] ")" + + nominal-params = "(" argument "," argument ")" + + normdist-params = "(" argument "," argument "," argument "," argument ")" + + norm-dist-params = "(" argument "," argument "," argument "," argument ")" + + norminv-params = "(" argument "," argument "," argument ")" + + norm-inv-params = "(" argument "," argument "," argument ")" + + norm-s-dist-params = "(" argument "," argument ")" + + normsdist-params = "(" argument-expression ")" + + normsinv-params = "(" argument-expression ")" + + norm-s-inv-params = "(" argument-expression ")" + + not-params = "(" argument-expression ")" + + now-params = emptyparams + + n-params = "(" argument-expression ")" + + nper-params = "(" argument "," argument "," argument \["," argument \["," argument\]\] ")" + + npv-params = "(" argument "," argument \*253("," argument) ")" + + numberstring-params = "(" argument "," argument ")" + + numbervalue-params = "(" (argument-expression / (argument "," argument \["," argument\])) ")" + + oct2bin-params = "(" (argument-expression / (argument "," argument)) ")" + + oct2dec-params = "(" argument-expression ")" + + oct2hex-params = "(" (argument-expression / (argument "," argument)) ")" + + oddfprice-params = "(" argument "," argument "," argument "," argument "," argument "," argument "," argument "," argument \["," argument\] ")" + + oddfyield-params = "(" argument "," argument "," argument "," argument "," argument "," argument "," argument "," argument \["," argument\] ")" + + oddlprice-params = "(" argument "," argument "," argument "," argument "," argument "," argument "," argument \["," argument\] ")" + + oddlyield-params = "(" argument "," argument "," argument "," argument "," argument "," argument "," argument \["," argument\] ")" + + odd-params = "(" argument-expression ")" + + offset-params = "(" ref-argument-expression "," argument "," argument \["," argument \["," argument\]\] ")" + + or-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + pduration-params = "(" argument "," argument "," argument ")" + + pearson-params = "(" argument "," argument ")" + + percentile-exc-params = "(" argument "," argument ")" + + percentile-inc-params = "(" argument "," argument ")" + + percentile-params = "(" argument "," argument ")" + + percentrank-exc-params = "(" argument "," argument \["," argument\] ")" + + percentrank-inc-params = "(" argument "," argument \["," argument\] ")" + + percentrank-params = "(" argument "," argument \["," argument\] ")" + + permutationa-params = "(" argument "," argument ")" + + permut-params = "(" argument "," argument ")" + + phi-params = "(" argument-expression ")" + + phonetic-params = "(" ref-argument-expression ")" + + pi-params = emptyparams + + pmt-params = "(" argument "," argument "," argument \["," argument \["," argument\]\] ")" + + poisson-dist-params = "(" argument "," argument "," argument ")" + + poisson-params = "(" argument "," argument "," argument ")" + + power-params = "(" argument "," argument ")" + + ppmt-params = "(" argument "," argument "," argument "," argument \["," argument \["," argument\]\] ")" + + pqsource-params = "(" guid ")" + + pricedisc-params = "(" argument "," argument "," argument "," argument \["," argument\] ")" + + pricemat-params = "(" argument "," argument "," argument "," argument "," argument \["," argument\] ")" + + price-params = "(" argument "," argument "," argument "," argument "," argument "," argument \["," argument\] ")" + + prob-params = "(" argument "," argument "," argument \["," argument\] ")" + + product-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + proper-params = "(" argument-expression ")" + + pv-params = "(" argument "," argument "," argument \["," argument \["," argument\]\] ")" + + py-params = "(" whole-number-part "," ("0" / "1") \*252("," argument) ")" + + ;whole-number-part MUST be 0-based index referencing CT_PythonScript element + + that indicates [**Python script**](#gt_ccedff9e-7c79-440f-9090-63915f6677ad) corresponding to the function as specified in section [2.3.10.2](#Section_28f8f9b3e370440c9afc2a1bba74cde6). + + python-str-params = "(" argument-expression ")" + + python-type-params = "(" argument-expression ")" + + python-typename-params = "(" argument-expression ")" + + quartile-exc-params = "(" argument "," argument ")" + + quartile-inc-params = "(" argument "," argument ")" + + quartile-params = "(" argument "," argument ")" + + querystring-params = "(" argument "," argument \*126( "," argument "," argument) ")" + + quotient-params = "(" argument "," argument ")" + + radians-params = "(" argument-expression ")" + + randarray-params = "(" \[argument \*4("," argument)\] ")" + + randbetween-params = "(" argument "," argument ")" + + rand-params = emptyparams + + rank-avg-params = "(" argument "," ref-argument-expression \["," argument\] ")" + + rank-eq-params = "(" argument "," ref-argument-expression \["," argument\] ")" + + rank-params = "(" argument "," ref-argument-expression \["," argument\] ")" + + rate-params = "(" argument "," argument "," argument \["," argument \["," argument \["," argument\]\]\] ")" + + received-params = "(" argument "," argument "," argument "," argument \["," argument\] ")" + + reduce-params = "(" argument "," argument "," argument ")" + + replaceb-params = "(" argument "," argument "," argument "," argument ")" + + replace-params = "(" argument "," argument "," argument "," argument ")" + + rept-params = "(" argument "," argument ")" + + rightb-params = "(" (argument-expression / (argument "," argument)) ")" + + right-params = "(" (argument-expression / (argument "," argument)) ")" + + roman-params = "(" (argument-expression / (argument "," argument)) ")" + + roundbahtdown-params = "(" argument-expression ")" + + roundbahtup-params = "(" argument-expression ")" + + rounddown-params = "(" argument "," argument ")" + + round-params = "(" argument "," argument ")" + + roundup-params = "(" argument "," argument ")" + + row-params = "(" \[ref-argument-expression \] ")" + + rows-params = "(" argument-expression ")" + + rri-params = "(" argument "," argument "," argument ")" + + rsq-params = "(" argument "," argument ")" + + rtd-params = "(" argument "," argument "," argument \*252("," argument) ")" + + scan-params = "(" argument "," argument "," argument ")" + + searchb-params = "(" argument "," argument \["," argument\] ")" + + search-params = "(" argument "," argument \["," argument\] ")" + + sech-params = "(" argument-expression ")" + + second-params = "(" argument-expression ")" + + sec-params = "(" argument-expression ")" + + sequence-params = "("argument \*3("," argument) ")" + + series-params = "(" argument "," argument "," argument "," argument \["," argument\] ")" + + seriessum-params = "(" argument "," argument "," argument "," argument ")" + + sheet-params = "(" argument ")" + + sheets-params = "(" argument ")" + + sign-params = "(" argument-expression ")" + + sinh-params = "(" argument-expression ")" + + sin-params = "(" argument-expression ")" + + skew-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + skew-p-params = "(" (argument-expression / (argument 1\*253("," argument))) ")" + + sln-params = "(" argument "," argument "," argument ")" + + slope-params = "(" argument "," argument ")" + + small-params = "(" argument "," argument ")" + + sortby-params = "(" argument "," argument \["," argument \*125("," argument "," argument)\] ")" + + sort-worksheet-params = "(" (argument-expression / (argument 1\*3("," argument))) ")" + + sqrt-params = "(" argument-expression ")" + + sqrtpi-params = "(" argument-expression ")" + + standardize-params = "(" argument "," argument "," argument ")" + + stdeva-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + stdevpa-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + stdev-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + stdev-p-params = "(" (argument-expression / (argument 1\*253("," argument))) ")" + + stdevp-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + stdev-s-params = "(" (argument-expression / (argument 1\*253("," argument))) ")" + + steyx-params = "(" argument "," argument ")" + + substitute-params = "(" argument "," argument "," argument \["," argument\] ")" + + subtotal-params = "(" argument "," ref-argument-expression \*253("," ref-argument-expression ) ")" + + sumif-params = "(" ref-argument-expression "," argument \["," ref-argument-expression \] ")" + + sumifs-params = "(" ref-argument-expression "," ref-argument-expression "," argument \*126("," ref-argument-expression "," argument) ")" + + sum-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + sumproduct-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + sumsq-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + sumx2my2-params = "(" argument "," argument ")" + + sumx2py2-params = "(" argument "," argument ")" + + sumxmy2-params = "(" argument "," argument ")" + + switch-params = "(" argument "," argument "," argument 1\*251("," argument) ")" + + syd-params = "(" argument "," argument "," argument "," argument ")" + + take-params = "(" argument 1\*2("," argument) ")" + + tanh-params = "(" argument-expression ")" + + tan-params = "(" argument-expression ")" + + tbilleq-params = "(" argument "," argument "," argument ")" + + tbillprice-params = "(" argument "," argument "," argument ")" + + tbillyield-params = "(" argument "," argument "," argument ")" + + t-dist-2t-params = "(" argument "," argument ")" + + tdist-params = "(" argument "," argument "," argument ")" + + t-dist-params = "(" argument "," argument "," argument ")" + + t-dist-rt-params = "(" argument "," argument ")" + + text-params = "(" argument "," argument ")" + + textafter-params = "(" argument 1\*5("," argument) ")" + + textbefore-params = "(" argument 1\*5("," argument) ")" + + textjoin-params = "(" argument "," argument "," argument \*251("," argument) ")" + + textsplit-params = "(" argument 1\*5("," argument) ")" + + thaidayofweek-params = "(" argument-expression ")" + + thaidigit-params = "(" argument-expression ")" + + thaimonthofyear-params = "(" argument-expression ")" + + thainumsound-params = "(" argument-expression ")" + + thainumstring-params = "(" argument-expression ")" + + thaistringlength-params = "(" argument-expression ")" + + thaiyear-params = "(" argument-expression ")" + + time-params = "(" argument "," argument "," argument ")" + + timevalue-params = "(" argument-expression ")" + + t-inv-2t-params = "(" argument "," argument ")" + + tinv-params = "(" argument "," argument ")" + + t-inv-params = "(" argument "," argument ")" + + tocol-params = "(" (argument-expression / (argument 1\*2("," argument))) ")" + + today-params = emptyparams + + torow-params = "(" (argument-expression / (argument 1\*2("," argument))) ")" + + t-params = "(" argument-expression ")" + + transpose-params = "(" argument-expression ")" + + trend-params = "(" (argument-expression / (argument "," argument \["," argument \["," argument\]\])) ")" + + trimmean-params = "(" argument "," argument ")" + + trim-params = "(" argument-expression ")" + + true-params = emptyparams + + trunc-params = "(" (argument-expression / (argument "," argument)) ")" + + ttest-params = "(" argument "," argument "," argument "," argument ")" + + t-test-params = "(" argument "," argument "," argument "," argument ")" + + type-params = "(" argument-expression ")" + + unichar-params = "(" argument-expression ")" + + unicode-params = "(" argument-expression ")" + + unique-params = "(" argument \*2("," argument) ")" + + upper-params = "(" argument-expression ")" + + usdollar-params = "(" (argument-expression / (argument "," argument)) ")" + + value-params = "(" argument-expression ")" + + vara-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + varpa-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + var-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + var-p-params = "(" (argument-expression / (argument 1\*253("," argument))) ")" + + varp-params = "(" (argument-expression / (argument 1\*254("," argument))) ")" + + var-s-params = "(" (argument-expression / (argument 1\*253("," argument))) ")" + + vdb-params = "(" argument "," argument "," argument "," argument "," argument \["," argument \["," argument\]\] ")" + + vlookup-params = "(" argument "," argument "," argument \["," argument\] ")" + + vstack-params = "(" (argument-expression / (argument 1\*253("," argument))) ")" + + webservice-params = "(" (argument-expression / (argument "," argument)) ")" + + weekday-params = "(" (argument-expression / (argument "," argument)) ")" + + weeknum-params = "(" (argument-expression / (argument "," argument)) ")" + + weibull-dist-params = "(" argument "," argument "," argument "," argument ")" + + weibull-params = "(" argument "," argument "," argument "," argument ")" + + workday-intl-params = "(" argument "," argument \["," argument \["," argument\]\] ")" + + workday-params = "(" argument "," argument \["," argument\] ")" + + wrapcols-params = "(" argument 1\*2("," argument) ")" + + wraprows-params = "(" argument 1\*2("," argument) ")" + + xirr-params = "(" argument "," argument \["," argument\] ")" + + xnpv-params = "(" argument "," argument "," argument ")" + + xlookup-params = "(" argument "," argument "," argument \*3("," argument) ")" + + xor-params = "(" (argument-expression / (argument 1\*253("," argument))) ")" + + yearfrac-params = "(" argument "," argument \["," argument\] ")" + + year-params = "(" argument-expression ")" + + yielddisc-params = "(" argument "," argument "," argument "," argument \["," argument\] ")" + + yieldmat-params = "(" argument "," argument "," argument "," argument "," argument \["," argument\] ")" + + yield-params = "(" argument "," argument "," argument "," argument "," argument "," argument \["," argument\] ")" + + ztest-params = "(" argument "," argument \["," argument\] ")" + + z-test-params = "(" argument "," argument \["," argument\] ")" + + ref-macro-function-call = "ABSREF" absref-params / "ACTIVE.CELL" active-cell-params / "CALL" call-params / "CALLER" caller-params / "EVALUATE" evaluate-params / "GET.DOCUMENT" get-document-params / "IF" if-params / "INPUT" input-params / "LAST.ERROR" last-error-params / "SCENARIO.GET" scenario-get-params / "SELECTION" selection-params / "TEXTREF" textref-params / "VIEW.GET" view-get-params + + macro-function-call = ref-macro-function-call / "ADD.BAR" add-bar-params / "ADD.COMMAND" add-command-params / "ADD.MENU" add-menu-params / "ADD.TOOLBAR" add-toolbar-params / "APP.TITLE" app-title-params / "ARGUMENT" argument-params / "BREAK" break-params / "CANCEL.KEY" cancel-key-params / "CHECK.COMMAND" check-command-params / "CREATE.OBJECT" create-object-params / "CUSTOM.REPEAT" custom-repeat-params / "CUSTOM.UNDO" custom-undo-params / "DELETE.BAR" delete-bar-params / "DELETE.COMMAND" delete-command-params / "DELETE.MENU" delete-menu-params / "DELETE.TOOLBAR" delete-toolbar-params / "DEREF" deref-params / "DIALOG.BOX" dialog-box-params / "DIRECTORY" directory-params / "DOCUMENTS" documents-params / "ECHO" echo-params / "ELSE" else-params / "ELSE.IF" else-if-params / "ENABLE.COMMAND" enable-command-params / "ENABLE.TOOL" enable-tool-params / "END.IF" end-if-params / "ERROR" error-params / "EXEC" exec-params / "EXECUTE" execute-params / "FCLOSE" fclose-params / "FILES" files-params / "FOPEN" fopen-params / "FOR" for-params / "FOR.CELL" for-cell-params / "FORMULA.CONVERT" formula-convert-params / "FPOS" fpos-params / "FREAD" fread-params / "FREADLN" freadln-params / "FSIZE" fsize-params / "FWRITE" fwrite-params / "FWRITELN" fwriteln-params / "GET.BAR" get-bar-params / "GET.CELL" get-cell-params / "GET.CHART.ITEM" get-chart-item-params / "GET.DEF" get-def-params / "GET.FORMULA" get-formula-params / "GET.LINK.INFO" get-link-info-params / "GET.MOVIE" get-movie-params / "GET.NAME" get-name-params / "GET.NOTE" get-note-params / "GET.OBJECT" get-object-params / "GET.TOOL" get-tool-params / "GET.TOOLBAR" get-toolbar-params / "GET.WINDOW" get-window-params / "GET.WORKBOOK" get-workbook-params / "GET.WORKSPACE" get-workspace-params / "GOTO" goto-params / "GROUP" group-params / "HALT" halt-params / "HELP" help-params / "INITIATE" initiate-params / "LINKS" links-params / "MOVIE.COMMAND" movie-command-params / "NAMES" names-params / "NEXT" next-params / "NOTE" note-params / "OPEN.DIALOG" open-dialog-params / "OPTIONS.LISTS.GET" options-lists-get-params / "PAUSE" pause-params / "POKE" poke-params / "PRESS.TOOL" press-tool-params / "REFTEXT" reftext-params / "REGISTER" register-params / "REGISTER.ID" register-id-params / "RELREF" relref-params / "RENAME.COMMAND" rename-command-params / "REQUEST" request-params / "RESET.TOOLBAR" reset-toolbar-params / "RESTART" restart-params / "RESULT" result-params / "RESUME" resume-params / "RETURN" return-params / "SAVE.DIALOG" save-dialog-params / "SAVE.TOOLBAR" save-toolbar-params / "SET.NAME" set-name-params / "SET.VALUE" set-value-params / "SHOW.BAR" show-bar-params / "SPELLING.CHECK" spelling-check-params / "STEP" step-params / "TERMINATE" terminate-params / "TEXT.BOX" text-box-params / "UNREGISTER" unregister-params / "VOLATILE" volatile-params / "WHILE" while-params / "WINDOW.TITLE" window-title-params / "WINDOWS" windows-params + + absref-params = "(" argument "," ref-argument-expression ")" + + active-cell-params = "(" \*space ")" + + add-bar-params = "(" argument ")" + + add-command-params = "(" argument "," argument "," argument \["," argument \["," argument\]\] ")" + + add-menu-params = "(" argument "," argument \["," argument \["," argument\]\] ")" + + add-toolbar-params = "(" argument \["," argument\] ")" + + app-title-params = "(" argument ")" + + argument-params = "(" argument \["," argument \["," ref-argument-expression\]\] ")" + + break-params = "(" \*space ")" + + call-params = "(" (argument-expression / (argument "," argument \*253("," argument))) ")" + + caller-params = "(" \*space ")" + + cancel-key-params = "(" argument \["," ref-argument-expression\] ")" + + check-command-params = "(" argument "," argument "," argument "," argument \["," argument\] ")" + + create-object-params = "(" argument "," argument \["," argument \["," argument \["," argument \["," argument \["," argument \["," argument \["," argument \["," argument \["," argument\]\]\]\]\]\]\]\]\] ")" + + custom-repeat-params = "(" argument \["," argument \["," argument\]\] ")" + + custom-undo-params = "(" argument \["," argument\] ")" + + delete-bar-params = "(" argument-expression ")" + + delete-command-params = "(" argument "," argument "," argument \["," argument\] ")" + + delete-menu-params = "(" argument "," argument \["," argument\] ")" + + delete-toolbar-params = "(" argument-expression ")" + + deref-params = "(" ref-argument-expression ")" + + dialog-box-params = "(" argument-expression ")" + + directory-params = "(" argument ")" + + documents-params = "(" argument \["," argument\] ")" + + echo-params = "(" argument ")" + + else-params = "(" \*space ")" + + else-if-params = "(" argument-expression ")" + + enable-command-params = "(" argument "," argument "," argument "," argument \["," argument\] ")" + + enable-tool-params = "(" argument "," argument "," argument ")" + + end-if-params = "(" \*space ")" + + error-params = "(" argument \["," argument\] ")" + + evaluate-params = "(" argument-expression ")" + + exec-params = "(" (argument-expression / (argument "," argument \["," argument \["," argument\]\])) ")" + + execute-params = "(" argument "," argument ")" + + fclose-params = "(" argument-expression ")" + + files-params = "(" argument \["," argument\] ")" + + fopen-params = "(" (argument-expression / (argument "," argument)) ")" + + for-params = "(" argument "," argument "," argument \["," argument\] ")" + + for-cell-params = "(" (argument-expression / (argument "," argument \["," argument\])) ")" + + formula-convert-params = "(" argument "," argument \["," argument \["," argument \["," argument\]\]\] ")" + + fpos-params = "(" (argument-expression / (argument "," argument)) ")" + + fread-params = "(" argument "," argument ")" + + freadln-params = "(" argument-expression ")" + + fsize-params = "(" argument-expression ")" + + fwrite-params = "(" argument "," argument ")" + + fwriteln-params = "(" argument "," argument ")" + + get-bar-params = "(" argument \["," argument \["," argument \["," argument\]\]\] ")" + + get-cell-params = "(" (argument-expression / (argument "," ref-argument-expression)) ")" + + get-chart-item-params = "(" (argument-expression / (argument "," argument \["," argument\])) ")" + + get-def-params = "(" (argument-expression / (argument "," argument \["," argument\])) ")" + + get-document-params = "(" (argument-expression / (argument "," argument)) ")" + + get-formula-params = "(" argument-expression ")" + + get-link-info-params = "(" argument "," argument \["," argument \["," argument\]\] ")" + + get-movie-params = "(" argument "," argument \["," argument\] ")" + + get-name-params = "(" (argument-expression / (argument "," argument)) ")" + + get-note-params = "(" argument \["," argument \["," argument\]\] ")" + + get-object-params = "(" (argument-expression / (argument "," argument \["," argument \["," argument \["," argument\]\]\])) ")" + + get-tool-params = "(" (argument-expression / (argument "," argument \["," argument\])) ")" + + get-toolbar-params = "(" (argument-expression / (argument "," argument)) ")" + + get-window-params = "(" (argument-expression / (argument "," argument)) ")" + + get-workbook-params = "(" (argument-expression / (argument "," argument)) ")" + + get-workspace-params = "(" argument-expression ")" + + goto-params = "(" ref-argument-expression ")" + + group-params = "(" \*space ")" + + halt-params = "(" argument ")" + + help-params = "(" argument ")" + + initiate-params = "(" argument "," argument ")" + + input-params = "(" (argument-expression / (argument "," argument \["," argument \["," argument \["," argument \["," argument \["," argument\]\]\]\]\])) ")" + + last-error-params = "(" \*space ")" + + links-params = "(" argument \["," argument\] ")" + + movie-command-params = "(" argument "," argument "," argument \["," argument\] ")" + + names-params = "(" argument \["," argument \["," argument\]\] ")" + + next-params = "(" \*space ")" + + note-params = "(" argument \["," argument \["," argument \["," argument\]\]\] ")" + + open-dialog-params = "(" argument \["," argument \["," argument \["," argument\]\]\] ")" + + options-lists-get-params = "(" argument-expression ")" + + pause-params = "(" argument ")" + + poke-params = "(" argument "," argument "," argument ")" + + press-tool-params = "(" argument "," argument "," argument ")" + + reftext-params = "(" ref-argument-expression "," argument ")" + + register-params = "(" (argument-expression / (argument "," argument \["," argument \["," argument \["," argument \["," argument \["," argument \["," argument \["," argument \["," argument \*245("," argument)\]\]\]\]\]\]\]\])) ")" + + register-id-params = "(" argument "," argument \["," argument\] ")" + + relref-params = "(" ref-argument-expression "," ref-argument-expression ")" + + rename-command-params = "(" argument "," argument "," argument "," argument \["," argument\] ")" + + request-params = "(" argument "," argument ")" + + reset-toolbar-params = "(" argument-expression ")" + + restart-params = "(" argument ")" + + result-params = "(" argument ")" + + resume-params = "(" argument ")" + + return-params = "(" argument ")" + + save-dialog-params = "(" argument \["," argument \["," argument \["," argument \["," argument\]\]\]\] ")" + + save-toolbar-params = "(" argument \["," argument\] ")" + + scenario-get-params = "(" (argument-expression / (argument "," argument)) ")" + + selection-params = "(" \*space ")" + + set-name-params = "(" (argument-expression / (argument "," argument)) ")" + + set-value-params = "(" ref-argument-expression "," argument ")" + + show-bar-params = "(" argument ")" + + spelling-check-params = "(" (argument-expression / (argument "," argument \["," argument\])) ")" + + step-params = "(" \*space ")" + + terminate-params = "(" argument-expression ")" + + text-box-params = "(" (argument-expression / (argument "," argument \["," argument \["," argument\]\])) ")" + + textref-params = "(" (argument-expression / (argument "," argument)) ")" + + unregister-params = "(" argument-expression ")" + + view-get-params = "(" (argument-expression / (argument "," argument)) ")" + + volatile-params = "(" argument ")" + + while-params = "(" argument-expression ")" + + window-title-params = "(" argument ")" + + windows-params = "(" argument \["," argument\] ")" + + command-function-call = "A1.R1C1" a1-r1c1-params / "ACTIVATE" \["?"\] activate-params / "ACTIVATE.NEXT" activate-next-params / "ACTIVATE.NOTES" activate-notes-params / "ACTIVATE.PREV" activate-prev-params / "ACTIVE.CELL.FONT" \["?"\] active-cell-font-params / "ADD.ARROW" add-arrow-params / "ADD.CHART.AUTOFORMAT" \["?"\] add-chart-autoformat-params / "ADD.LIST.ITEM" add-list-item-params / "ADD.OVERLAY" add-overlay-params / "ADD.PRINT.AREA" add-print-area-params / "ADD.TOOL" add-tool-params / "ADDIN.MANAGER" \["?"\] addin-manager-params / "ALERT" alert-params / "ALIGNMENT" \["?"\] alignment-params / "APP.ACTIVATE" app-activate-params / "APP.ACTIVATE.MICROSOFT" app-activate-microsoft-params / "APP.MAXIMIZE" app-maximize-params / "APP.MINIMIZE" app-minimize-params / "APP.MOVE" \["?"\] app-move-params / "APP.RESTORE" app-restore-params / "APP.SIZE" \["?"\] app-size-params / "APPLY.NAMES" \["?"\] apply-names-params / "APPLY.STYLE" \["?"\] apply-style-params / "ARRANGE.ALL" \["?"\] arrange-all-params / "ASSIGN.TO.OBJECT" \["?"\] assign-to-object-params / "ASSIGN.TO.TOOL" \["?"\] assign-to-tool-params / "ATTACH.TEXT" \["?"\] attach-text-params / "ATTACH.TOOLBARS" \["?"\] attach-toolbars-params / "ATTRIBUTES" \["?"\] attributes-params / "AUTO.OUTLINE" auto-outline-params / "AUTOCORRECT" \["?"\] autocorrect-params / "AXES" \["?"\] axes-params / "BEEP" beep-params / "BORDER" \["?"\] border-params / "BRING.TO.FRONT" bring-to-front-params / "CALCULATE.DOCUMENT" calculate-document-params / "CALCULATE.NOW" calculate-now-params / "CALCULATION" \["?"\] calculation-params / "CANCEL.COPY" cancel-copy-params / "CELL.PROTECTION" \["?"\] cell-protection-params / "CHANGE.LINK" \["?"\] change-link-params / "CHART.ADD.DATA" \["?"\] chart-add-data-params / "CHART.TREND" \["?"\] chart-trend-params / "CHART.WIZARD" \["?"\] chart-wizard-params / "CHECKBOX.PROPERTIES" \["?"\] checkbox-properties-params / "CLEAR" \["?"\] clear-params / "CLEAR.OUTLINE" clear-outline-params / "CLEAR.PRINT.AREA" clear-print-area-params / "CLEAR.ROUTING.SLIP" clear-routing-slip-params / "CLOSE" close-params / "CLOSE.ALL" close-all-params / "COLOR.PALETTE" \["?"\] color-palette-params / "COLUMN.WIDTH" \["?"\] column-width-params / "COMBINATION" \["?"\] combination-params / "CONSOLIDATE" \["?"\] consolidate-params / "CONSTRAIN.NUMERIC" constrain-numeric-params / "COPY" copy-params / "COPY.CHART" \["?"\] copy-chart-params / "COPY.PICTURE" \["?"\] copy-picture-params / "COPY.TOOL" copy-tool-params / "CREATE.NAMES" \["?"\] create-names-params / "CREATE.PUBLISHER" \["?"\] create-publisher-params / "CUSTOMIZE.TOOLBAR" \["?"\] customize-toolbar-params / "CUT" cut-params / "DATA.DELETE" \["?"\] data-delete-params / "DATA.FIND" data-find-params / "DATA.FIND.NEXT" data-find-next-params / "DATA.FIND.PREV" data-find-prev-params / "DATA.FORM" data-form-params / "DATA.LABEL" \["?"\] data-label-params / "DATA.SERIES" \["?"\] data-series-params / "DEFINE.NAME" \["?"\] define-name-params / "DEFINE.STYLE" \["?"\] define-style-params / "DELETE.ARROW" delete-arrow-params / "DELETE.CHART.AUTOFORMAT" delete-chart-autoformat-params / "DELETE.FORMAT" \["?"\] delete-format-params / "DELETE.NAME" \["?"\] delete-name-params / "DELETE.NOTE" delete-note-params / "DELETE.OVERLAY" delete-overlay-params / "DELETE.STYLE" delete-style-params / "DELETE.TOOL" delete-tool-params / "DEMOTE" \["?"\] demote-params / "DISABLE.INPUT" disable-input-params / "DISPLAY" \["?"\] display-params / "DUPLICATE" duplicate-params / "EDIT.COLOR" \["?"\] edit-color-params / "EDIT.DELETE" \["?"\] edit-delete-params / "EDIT.OBJECT" edit-object-params / "EDIT.REPEAT" edit-repeat-params / "EDIT.SERIES" \["?"\] edit-series-params / "EDIT.TOOL" edit-tool-params / "EDITBOX.PROPERTIES" \["?"\] editbox-properties-params / "EDITION.OPTIONS" \["?"\] edition-options-params / "ENABLE.OBJECT" enable-object-params / "ENABLE.TIPWIZARD" enable-tipwizard-params / "ENTER.DATA" enter-data-params / "ERRORBAR.X" \["?"\] errorbar-x-params / "ERRORBAR.Y" \["?"\] errorbar-y-params / "EXTEND.POLYGON" extend-polygon-params / "EXTRACT" \["?"\] extract-params / "FILE.CLOSE" file-close-params / "FILE.DELETE" \["?"\] file-delete-params / "FILL.AUTO" fill-auto-params / "FILL.DOWN" fill-down-params / "FILL.GROUP" \["?"\] fill-group-params / "FILL.LEFT" fill-left-params / "FILL.RIGHT" fill-right-params / "FILL.UP" fill-up-params / "FILTER" \["?"\] filter-params / "FILTER.ADVANCED" \["?"\] filter-advanced-params / "FILTER.SHOW.ALL" filter-show-all-params / "FIND.FILE" \["?"\] find-file-params / "FONT" \["?"\] font-params / "FONT.PROPERTIES" \["?"\] font-properties-params / "FORMAT.AUTO" \["?"\] format-auto-params / "FORMAT.CHART" \["?"\] format-chart-params / "FORMAT.CHARTTYPE" \["?"\] format-charttype-params / "FORMAT.FONT" \["?"\] format-font-params / "FORMAT.LEGEND" \["?"\] format-legend-params / "FORMAT.MAIN" \["?"\] format-main-params / "FORMAT.MOVE" format-move-params / "FORMAT.NUMBER" \["?"\] format-number-params / "FORMAT.OVERLAY" \["?"\] format-overlay-params / "FORMAT.SHAPE" format-shape-params / "FORMAT.SIZE" format-size-params / "FORMAT.TEXT" \["?"\] format-text-params / "FORMULA" formula-params / "FORMULA.ARRAY" formula-array-params / "FORMULA.FILL" formula-fill-params / "FORMULA.FIND" \["?"\] formula-find-params / "FORMULA.FIND.NEXT" formula-find-next-params / "FORMULA.FIND.PREV" formula-find-prev-params / "FORMULA.GOTO" \["?"\] formula-goto-params / "FORMULA.REPLACE" \["?"\] formula-replace-params / "FREEZE.PANES" freeze-panes-params / "FULL" full-params / "FULL.SCREEN" full-screen-params / "FUNCTION.WIZARD" \["?"\] function-wizard-params / "GALLERY.3D.AREA" \["?"\] gallery-3d-area-params / "GALLERY.3D.BAR" \["?"\] gallery-3d-bar-params / "GALLERY.3D.COLUMN" \["?"\] gallery-3d-column-params / "GALLERY.3D.LINE" \["?"\] gallery-3d-line-params / "GALLERY.3D.PIE" \["?"\] gallery-3d-pie-params / "GALLERY.3D.SURFACE" \["?"\] gallery-3d-surface-params / "GALLERY.AREA" \["?"\] gallery-area-params / "GALLERY.BAR" \["?"\] gallery-bar-params / "GALLERY.COLUMN" \["?"\] gallery-column-params / "GALLERY.CUSTOM" \["?"\] gallery-custom-params / "GALLERY.DOUGHNUT" \["?"\] gallery-doughnut-params / "GALLERY.LINE" \["?"\] gallery-line-params / "GALLERY.PIE" \["?"\] gallery-pie-params / "GALLERY.RADAR" \["?"\] gallery-radar-params / "GALLERY.SCATTER" \["?"\] gallery-scatter-params / "GOAL.SEEK" \["?"\] goal-seek-params / "GRIDLINES" \["?"\] gridlines-params / "HIDE" hide-params / "HIDE.DIALOG" hide-dialog-params / "HIDE.OBJECT" hide-object-params / "HIDEALL.INKANNOTS" hideall-inkannots-params / "HIDEALL.NOTES" hideall-notes-params / "HIDECURR.NOTE" hidecurr-note-params / "HLINE" hline-params / "HPAGE" hpage-params / "HSCROLL" hscroll-params / "INSERT" \["?"\] insert-params / "INSERT.MAP.OBJECT" \["?"\] insert-map-object-params / "INSERT.OBJECT" \["?"\] insert-object-params / "INSERT.PICTURE" \["?"\] insert-picture-params / "INSERT.TITLE" \["?"\] insert-title-params / "INSERTDATATABLE" \["?"\] insertdatatable-params / "JUSTIFY" justify-params / "LABEL.PROPERTIES" \["?"\] label-properties-params / "LAYOUT" layout-params / "LEGEND" legend-params / "LINE.PRINT" line-print-params / "LINK.COMBO" link-combo-params / "LINK.FORMAT" link-format-params / "LIST.NAMES" list-names-params / "LISTBOX.PROPERTIES" \["?"\] listbox-properties-params / "MACRO.OPTIONS" \["?"\] macro-options-params / "MAIL.ADD.MAILER" mail-add-mailer-params / "MAIL.DELETE.MAILER" mail-delete-mailer-params / "MAIL.EDIT.MAILER" \["?"\] mail-edit-mailer-params / "MAIL.FORWARD" mail-forward-params / "MAIL.LOGOFF" mail-logoff-params / "MAIL.LOGON" \["?"\] mail-logon-params / "MAIL.NEXT.LETTER" mail-next-letter-params / "MAIL.REPLY" mail-reply-params / "MAIL.REPLY.ALL" mail-reply-all-params / "MAIL.SEND.MAILER" \["?"\] mail-send-mailer-params / "MAIN.CHART" \["?"\] main-chart-params / "MAIN.CHART.TYPE" \["?"\] main-chart-type-params / "MENU.EDITOR" \["?"\] menu-editor-params / "MERGE.STYLES" merge-styles-params / "MESSAGE" message-params / "MOVE.BRK" move-brk-params / "MOVE.TOOL" move-tool-params / "NEW" \["?"\] new-params / "NEW.WINDOW" new-window-params / "NEWWEBQUERY" newwebquery-params / "NORMAL" normal-params / "OBJECT.PROPERTIES" \["?"\] object-properties-params/ "OBJECT.PROTECTION" \["?"\] object-protection-params / "ON.DATA" on-data-params/ "ON.DOUBLECLICK" on-doubleclick-params / "ON.ENTRY" on-entry-params / "ON.KEY" on-key-params / "ON.RECALC" on-recalc-params / "ON.SHEET" on-sheet-params / "ON.TIME" on-time-params / "ON.WINDOW" on-window-params / "OPEN" \["?"\] open-params/ "OPEN.LINKS" \["?"\] open-links-params / "OPEN.MAIL" \["?"\] open-mail-params / "OPEN.TEXT" open-text-params / "OPTIONS.CALCULATION" \["?"\] options-calculation-params / "OPTIONS.CHART" \["?"\] options-chart-params / "OPTIONS.EDIT" \["?"\] options-edit-params / "OPTIONS.GENERAL" \["?"\] options-general-params / "OPTIONS.LISTS.ADD" \["?"\] options-lists-add-params / "OPTIONS.LISTS.DELETE" options-lists-delete-params / "OPTIONS.ME" \["?"\] options-me-params / "OPTIONS.MENONO" \["?"\] options-menono-params / "OPTIONS.SAVE" \["?"\] options-save-params / "OPTIONS.SPELL" \["?"\] options-spell-params / "OPTIONS.TRANSITION" \["?"\] options-transition-params / "OPTIONS.VIEW" \["?"\] options-view-params / "OUTLINE" \["?"\] outline-params / "OVERLAY" \["?"\] overlay-params / "OVERLAY.CHART.TYPE" \["?"\] overlay-chart-type-params / "PAGE.SETUP" \["?"\] page-setup-params / "PARSE" \["?"\] parse-params / "PASTE" paste-params / "PASTE.LINK" paste-link-params / "PASTE.PICTURE" paste-picture-params / "PASTE.PICTURE.LINK" paste-picture-link-params / "PASTE.SPECIAL" \["?"\] paste-special-params / "PASTE.TOOL" paste-tool-params / "PATTERNS" \["?"\] patterns-params / "PICKLIST" \["?"\] picklist-params / "PIVOT.ADD.FIELDS" pivot-add-fields-params / "PIVOT.FIELD" pivot-field-params / "PIVOT.FIELD.GROUP" \["?"\] pivot-field-group-params / "PIVOT.FIELD.PROPERTIES" \["?"\] pivot-field-properties-params / "PIVOT.FIELD.UNGROUP" \["?"\] pivot-field-ungroup-params / "PIVOT.ITEM" pivot-item-params / "PIVOT.ITEM.PROPERTIES" pivot-item-properties-params / "PIVOT.REFRESH" pivot-refresh-params / "PIVOT.SHOW.PAGES" \["?"\] pivot-show-pages-params / "PIVOT.TABLE.CHART" \["?"\] pivot-table-chart-params / "PIVOT.TABLE.WIZARD" \["?"\] pivot-table-wizard-params / "POST.DOCUMENT" \["?"\] post-document-params / "PRECISION" precision-params / "PREFERRED" preferred-params / "PRINT" \["?"\] print-params / "PRINT.PREVIEW" \["?"\] print-preview-params / "PRINTER.SETUP" \["?"\] printer-setup-params / "PROMOTE" \["?"\] promote-params / "PROTECT.DOCUMENT" \["?"\] protect-document-params / "PROTECT.REVISIONS" \["?"\] protect-revisions-params / "PUSHBUTTON.PROPERTIES" \["?"\] pushbutton-properties-params / "QUIT" quit-params / "REMOVE.LIST.ITEM" remove-list-item-params / "REMOVE.PAGE.BREAK" remove-page-break-params / "RENAME.OBJECT" rename-object-params / "REPLACE.FONT" \["?"\] replace-font-params /"RESET.TOOL" reset-tool-params / "RM.PRINT.AREA" rm-print-area-params / "ROUTE.DOCUMENT" route-document-params / "ROUTING.SLIP" \["?"\] routing-slip-params / "ROW.HEIGHT" \["?"\] row-height-params / "RUN" \["?"\] run-params / "SAVE" save-params / "SAVE.AS" \["?"\] save-as-params / "SAVE.COPY.AS" save-copy-as-params / "SAVE.NEW.OBJECT" \["?"\] save-new-object-params / "SAVE.WORKBOOK" \["?"\] save-workbook-params / "SAVE.WORKSPACE" \["?"\] save-workspace-params / "SCALE" \["?"\] scale-params / "SCENARIO.ADD" \["?"\] scenario-add-params / "SCENARIO.CELLS" \["?"\] scenario-cells-params / "SCENARIO.DELETE" scenario-delete-params / "SCENARIO.EDIT" \["?"\] scenario-edit-params / "SCENARIO.MERGE" \["?"\] scenario-merge-params / "SCENARIO.SHOW" scenario-show-params / "SCENARIO.SHOW.NEXT" scenario-show-next-params / "SCENARIO.SUMMARY" \["?"\] scenario-summary-params / "SCROLLBAR.PROPERTIES" \["?"\] scrollbar-properties-params / "SELECT" select-params / "SELECT.ALL" select-all-params / "SELECT.CHART" select-chart-params / "SELECT.END" select-end-params / "SELECT.LAST.CELL" select-last-cell-params / "SELECT.LIST.ITEM" select-list-item-params / "SELECT.PLOT.AREA" select-plot-area-params / "SELECT.SPECIAL" \["?"\] select-special-params / "SEND.KEYS" send-keys-params / "SEND.MAIL" \["?"\] send-mail-params / "SEND.TO.BACK" send-to-back-params / "SERIES.AXES" \["?"\] series-axes-params / "SERIES.ORDER" \["?"\] series-order-params / "SERIES.X" \["?"\] series-x-params / "SERIES.Y" \["?"\] series-y-params / "SET.CONTROL.VALUE" set-control-value-params / "SET.CRITERIA" set-criteria-params / "SET.DATABASE" set-database-params / "SET.DIALOG.DEFAULT" set-dialog-default-params / "SET.DIALOG.FOCUS" set-dialog-focus-params / "SET.EXTRACT" set-extract-params / "SET.LIST.ITEM" set-list-item-params / "SET.PAGE.BREAK" set-page-break-params / "SET.PREFERRED" set-preferred-params / "SET.PRINT.AREA" set-print-area-params / "SET.PRINT.TITLES" \["?"\] set-print-titles-params / "SET.UPDATE.STATUS" \["?"\] set-update-status-params / "SHARE" share-params / "SHARE.NAME" \["?"\] share-name-params / "SHEET.BACKGROUND" \["?"\] sheet-background-params / "SHORT.MENUS" short-menus-params / "SHOW.ACTIVE.CELL" show-active-cell-params / "SHOW.CLIPBOARD" show-clipboard-params / "SHOW.DETAIL" \["?"\] show-detail-params / "SHOW.DIALOG" show-dialog-params / "SHOW.INFO" show-info-params / "SHOW.LEVELS" show-levels-params / "SHOW.TOOLBAR" \["?"\] show-toolbar-params / "SORT" \["?"\] sort-params / "SORT.SPECIAL" \["?"\] sort-special-params / "SOUND.NOTE" sound-note-params / "SOUND.PLAY" sound-play-params / "SPELLING" spelling-params / "SPLIT" \["?"\] split-params / "STANDARD.FONT" \["?"\] standard-font-params / "STANDARD.WIDTH" \["?"\] standard-width-params / "STYLE" \["?"\] style-params / "SUBSCRIBE.TO" \["?"\] subscribe-to-params / "SUBTOTAL.CREATE" \["?"\] subtotal-create-params / "SUBTOTAL.REMOVE" subtotal-remove-params / "SUMMARY.INFO" \["?"\] summary-info-params / "TAB.ORDER" \["?"\] tab-order-params / "TABLE" \["?"\] table-params / "TEXT.TO.COLUMNS" \["?"\] text-to-columns-params / "TRACER.CLEAR" tracer-clear-params / "TRACER.DISPLAY" tracer-display-params / "TRACER.ERROR" tracer-error-params / "TRACER.NAVIGATE" tracer-navigate-params / "TRAVERSE.NOTES" traverse-notes-params / "UNDO" undo-params / "UNGROUP" ungroup-params / "UNGROUP.SHEETS" ungroup-sheets-params / "UNHIDE" \["?"\] unhide-params / "UNLOCKED.NEXT" unlocked-next-params / "UNLOCKED.PREV" unlocked-prev-params / "UNPROTECT.REVISIONS" unprotect-revisions-params / "UPDATE.LINK" \["?"\] update-link-params / "VBA.INSERT.FILE" \["?"\] vba-insert-file-params / "VBA.MAKE.ADDIN" \["?"\] vba-make-addin-params / "VBA.PROCEDURE.DEFINITION" \["?"\] vba-procedure-definition-params / "VBAACTIVATE"vbaactivate-params / "VIEW.3D" \["?"\] view-3d-params / "VIEW.DEFINE" \["?"\] view-define-params / "VIEW.DELETE" view-delete-params / "VIEW.SHOW" \["?"\] view-show-params / "VLINE" vline-params / "VPAGE" vpage-params / "VSCROLL" vscroll-params / "WAIT" wait-params / "WEB.PUBLISH" web-publish-params / "WINDOW.MAXIMIZE" window-maximize-params / "WINDOW.MINIMIZE" window-minimize-params / "WINDOW.MOVE" \["?"\] window-move-params / "WINDOW.RESTORE" window-restore-params / "WINDOW.SIZE" \["?"\] window-size-params / "WORKBOOK.ACTIVATE" workbook-activate-params / "WORKBOOK.ADD" \["?"\] workbook-add-params / "WORKBOOK.COPY" \["?"\] workbook-copy-params / "WORKBOOK.DELETE" workbook-delete-params / "WORKBOOK.HIDE" workbook-hide-params / "WORKBOOK.INSERT" \["?"\] workbook-insert-params / "WORKBOOK.MOVE" \["?"\] workbook-move-params / "WORKBOOK.NAME" \["?"\] workbook-name-params / "WORKBOOK.NEW" \["?"\] workbook-new-params / "WORKBOOK.NEXT" workbook-next-params / "WORKBOOK.OPTIONS" \["?"\] workbook-options-params / "WORKBOOK.PREV" workbook-prev-params / "WORKBOOK.PROTECT" \["?"\] workbook-protect-params / "WORKBOOK.SCROLL" workbook-scroll-params / "WORKBOOK.SELECT" workbook-select-params / "WORKBOOK.TAB.SPLIT" \["?"\] workbook-tab-split-params / "WORKBOOK.UNHIDE" \["?"\] workbook-unhide-params / "WORKGROUP" \["?"\] workgroup-params / "WORKGROUP.OPTIONS" \["?"\] workgroup-options-params / "WORKSPACE" \["?"\] workspace-params / "ZOOM" \["?"\] zoom-params + + a1-r1c1-params = "(" argument ")" + + activate-params = "(" argument \["," argument\] ")" + + activate-next-params = "(" argument ")" + + activate-notes-params = "(" argument \["," argument\] ")" + + activate-prev-params = "(" argument ")" + + active-cell-font-params = "(" argument \*13("," argument) ")" + + add-arrow-params = "(" \*space ")" + + add-chart-autoformat-params = "(" argument \["," argument\] ")" + + add-list-item-params = "(" argument \["," argument\] ")" + + add-overlay-params = "(" \*space ")" + + add-print-area-params = "(" \*space ")" + + add-tool-params = "(" argument \*2("," argument) ")" + + addin-manager-params = "(" argument \*2("," argument) ")" + + alert-params = "(" argument \*2("," argument) ")" + + alignment-params = "(" argument \*9("," argument) ")" + + app-activate-params = "(" argument \["," argument\] ")" + + app-activate-microsoft-params = "(" argument ")" + + app-maximize-params = "(" \*space ")" + + app-minimize-params = "(" \*space ")" + + app-move-params = "(" argument \["," argument\] ")" + + app-restore-params = "(" \*space ")" + + app-size-params = "(" argument \["," argument\] ")" + + apply-names-params = "(" argument \*6("," argument) ")" + + apply-style-params = "(" argument ")" + + arrange-all-params = "(" argument \*3("," argument) ")" + + assign-to-object-params = "(" argument ")" + + assign-to-tool-params = "(" argument \*2("," argument) ")" + + attach-text-params = "(" argument \*2("," argument) ")" + + attach-toolbars-params = "(" \*space ")" + + attributes-params = "(" argument \["," argument\] ")" + + auto-outline-params = "(" \*space ")" + + autocorrect-params = "(" argument \["," argument\] ")" + + axes-params = "(" argument \*5("," argument) ")" + + beep-params = "(" argument ")" + + border-params = "(" argument \*26("," argument) ")" + + bring-to-front-params = "(" \*space ")" + + calculate-document-params = "(" \*space ")" + + calculate-now-params = "(" \*space ")" + + calculation-params = "(" argument \*10("," argument) ")" + + cancel-copy-params = "(" argument ")" + + cell-protection-params = "(" argument \["," argument\] ")" + + change-link-params = "(" argument \*2("," argument) ")" + + chart-add-data-params = "(" argument \*5("," argument) ")" + + chart-trend-params = "(" argument \*7("," argument) ")" + + chart-wizard-params = "(" argument \*13("," argument) ")" + + checkbox-properties-params = "(" argument \*4("," argument) ")" + + clear-params = "(" argument ")" + + clear-outline-params = "(" \*space ")" + + clear-print-area-params = "(" \*space ")" + + clear-routing-slip-params = "(" argument ")" + + close-params = "(" argument \["," argument\] ")" + + close-all-params = "(" \*space ")" + + color-palette-params = "(" argument ")" + + column-width-params = "(" argument \*4("," argument) ")" + + combination-params = "(" argument ")" + + consolidate-params = "(" argument \*4("," argument) ")" + + constrain-numeric-params = "(" argument ")" + + copy-params = "(" argument \["," argument\] ")" + + copy-chart-params = "(" argument ")" + + copy-picture-params = "(" argument \*2("," argument) ")" + + copy-tool-params = "(" argument \["," argument\] ")" + + create-names-params = "(" argument \*3("," argument) ")" + + create-publisher-params = "(" argument \*3("," argument) ")" + + customize-toolbar-params = "(" argument ")" + + cut-params = "(" argument \["," argument\] ")" + + data-delete-params = "(" \*space ")" + + data-find-params = "(" argument ")" + + data-find-next-params = "(" \*space ")" + + data-find-prev-params = "(" \*space ")" + + data-form-params = "(" \*space ")" + + data-label-params = "(" argument \*9("," argument) ")" + + data-series-params = "(" argument \*5("," argument) ")" + + define-name-params = "(" argument \*6("," argument) ")" + + define-style-params = "(" argument \*13("," argument) ")" + + delete-arrow-params = "(" \*space ")" + + delete-chart-autoformat-params = "(" argument ")" + + delete-format-params = "(" argument ")" + + delete-name-params = "(" argument ")" + + delete-note-params = "(" argument ")" + + delete-overlay-params = "(" \*space ")" + + delete-style-params = "(" argument ")" + + delete-tool-params = "(" argument \["," argument\] ")" + + demote-params = "(" argument ")" + + disable-input-params = "(" argument ")" + + display-params = "(" argument \*8("," argument) ")" + + duplicate-params = "(" \*space ")" + + edit-color-params = "(" argument \*3("," argument) ")" + + edit-delete-params = "(" argument ")" + + edit-object-params = "(" argument ")" + + edit-repeat-params = "(" \*space ")" + + edit-series-params = "(" argument \*6("," argument) ")" + + edit-tool-params = "(" argument \["," argument\] ")" + + editbox-properties-params = "(" argument \*3("," argument) ")" + + edition-options-params = "(" argument \*6("," argument) ")" + + enable-object-params = "(" argument \["," argument\] ")" + + enable-tipwizard-params = "(" argument ")" + + enter-data-params = "(" argument ")" + + errorbar-x-params = "(" argument \*3("," argument) ")" + + errorbar-y-params = "(" argument \*3("," argument) ")" + + extend-polygon-params = "(" argument ")" + + extract-params = "(" argument ")" + + file-close-params = "(" argument \["," argument\] ")" + + file-delete-params = "(" argument ")" + + fill-auto-params = "(" argument \["," argument\] ")" + + fill-down-params = "(" \*space ")" + + fill-group-params = "(" argument ")" + + fill-left-params = "(" \*space ")" + + fill-right-params = "(" \*space ")" + + fill-up-params = "(" \*space ")" + + filter-params = "(" argument \*5("," argument) ")" + + filter-advanced-params = "(" argument \*4("," argument) ")" + + filter-show-all-params = "(" \*space ")" + + find-file-params = "(" \*space ")" + + font-params = "(" argument \["," argument\] ")" + + font-properties-params = "(" argument \*13("," argument) ")" + + format-auto-params = "(" argument \*6("," argument) ")" + + format-chart-params = "(" argument \*17("," argument) ")" + + format-charttype-params = "(" argument \*3("," argument) ")" + + format-font-params = "(" argument \*14("," argument) ")" + + format-legend-params = "(" argument ")" + + format-main-params = "(" argument \*13("," argument) ")" + + format-move-params = "(" argument \*2("," argument) ")" + + format-number-params = "(" argument ")" + + format-overlay-params = "(" argument \*13("," argument) ")" + + format-shape-params = "(" argument \*4("," argument) ")" + + format-size-params = "(" argument \*2("," argument) ")" + + format-text-params = "(" argument \*10("," argument) ")" + + formula-params = "(" argument \["," argument\] ")" + + formula-array-params = "(" argument \["," argument\] ")" + + formula-fill-params = "(" argument \["," argument\] ")" + + formula-find-params = "(" argument \*11("," argument) ")" + + formula-find-next-params = "(" \*space ")" + + formula-find-prev-params = "(" \*space ")" + + formula-goto-params = "(" argument \["," argument\] ")" + + formula-replace-params = "(" argument \*10("," argument) ")" + + freeze-panes-params = "(" argument \*2("," argument) ")" + + full-params = "(" argument ")" + + full-screen-params = "(" argument ")" + + function-wizard-params = "(" argument ")" + + gallery-3d-area-params = "(" argument ")" + + gallery-3d-bar-params = "(" argument ")" + + gallery-3d-column-params = "(" argument ")" + + gallery-3d-line-params = "(" argument ")" + + gallery-3d-pie-params = "(" argument ")" + + gallery-3d-surface-params = "(" argument ")" + + gallery-area-params = "(" argument \["," argument\] ")" + + gallery-bar-params = "(" argument \["," argument\] ")" + + gallery-column-params = "(" argument \["," argument\] ")" + + gallery-custom-params = "(" argument ")" + + gallery-doughnut-params = "(" argument \["," argument\] ")" + + gallery-line-params = "(" argument \["," argument\] ")" + + gallery-pie-params = "(" argument \["," argument\] ")" + + gallery-radar-params = "(" argument \["," argument\] ")" + + gallery-scatter-params = "(" argument \["," argument\] ")" + + goal-seek-params = "(" argument \*2("," argument) ")" + + gridlines-params = "(" argument \*6("," argument) ")" + + hide-params = "(" \*space ")" + + hide-dialog-params = "(" argument ")" + + hide-object-params = "(" argument \["," argument\] ")" + + hideall-inkannots-params = "(" argument ")" + + hideall-notes-params = "(" argument ")" + + hidecurr-note-params = "(" argument \["," argument\] ")" + + hline-params = "(" argument ")" + + hpage-params = "(" argument ")" + + hscroll-params = "(" argument \["," argument\] ")" + + insert-params = "(" argument \["," argument\] ")" + + insert-map-object-params = "(" \*space ")" + + insert-object-params = "(" argument \*12("," argument) ")" + + insert-picture-params = "(" argument \["," argument\] ")" + + insert-title-params = "(" argument \*4("," argument) ")" + + insertdatatable-params = "(" argument ")" + + justify-params = "(" \*space ")" + + label-properties-params = "(" argument \*2("," argument) ")" + + layout-params = "(" \*space ")" + + legend-params = "(" argument ")" + + line-print-params = "(" argument \*10("," argument) ")" + + link-combo-params = "(" argument ")" + + link-format-params = "(" \*space ")" + + list-names-params = "(" \*space ")" + + listbox-properties-params = "(" argument \*4("," argument) ")" + + macro-options-params = "(" argument \*9("," argument) ")" + + mail-add-mailer-params = "(" \*space ")" + + mail-delete-mailer-params = "(" \*space ")" + + mail-edit-mailer-params = "(" argument \*5("," argument) ")" + + mail-forward-params = "(" \*space ")" + + mail-logoff-params = "(" \*space ")" + + mail-logon-params = "(" argument \*2("," argument) ")" + + mail-next-letter-params = "(" \*space ")" + + mail-reply-params = "(" \*space ")" + + mail-reply-all-params = "(" \*space ")" + + mail-send-mailer-params = "(" argument \["," argument\] ")" + + main-chart-params = "(" argument \*9("," argument) ")" + + main-chart-type-params = "(" argument ")" + + menu-editor-params = "(" \*space ")" + + merge-styles-params = "(" argument ")" + + message-params = "(" argument \["," argument\] ")" + + move-brk-params = "(" argument \*3("," argument) ")" + + move-tool-params = "(" argument \*5("," argument) ")" + + new-params = "(" argument \*2("," argument) ")" + + new-window-params = "(" \*space ")" + + newwebquery-params = "(" argument ")" + + normal-params = "(" \*space ")" + + object-properties-params = "(" argument \["," argument\] ")" + + object-protection-params = "(" argument \["," argument\] ")" + + on-data-params = "(" argument \["," argument\] ")" + + on-doubleclick-params = "(" argument \["," argument\] ")" + + on-entry-params = "(" argument \["," argument\] ")" + + on-key-params = "(" argument \["," argument\] ")" + + on-recalc-params = "(" argument \["," argument\] ")" + + on-sheet-params = "(" argument \*2("," argument) ")" + + on-time-params = "(" argument \*3("," argument) ")" + + on-window-params = "(" argument \["," argument\] ")" + + open-params = "(" argument \*16("," argument) ")" + + open-links-params = "(" argument \*14("," argument) ")" + + open-mail-params = "(" argument \["," argument\] ")" + + open-text-params = "(" argument \*16("," argument) ")" + + options-calculation-params = "(" argument \*9("," argument) ")" + + options-chart-params = "(" argument \*2("," argument) ")" + + options-edit-params = "(" argument \*10("," argument) ")" + + options-general-params = "(" argument \*13("," argument) ")" + + options-lists-add-params = "(" argument \["," argument\] ")" + + options-lists-delete-params = "(" argument ")" + + options-me-params = "(" argument \*8("," argument) ")" + + options-menono-params = "(" argument \*4("," argument) ")" + + options-save-params = "(" argument \*3("," argument) ")" + + options-spell-params = "(" argument \*11("," argument) ")" + + options-transition-params = "(" argument \*4("," argument) ")" + + options-view-params = "(" argument \*17("," argument) ")" + + outline-params = "(" argument \*3("," argument) ")" + + overlay-params = "(" argument \*11("," argument) ")" + + overlay-chart-type-params = "(" argument ")" + + page-setup-params = "(" argument \*29("," argument) ")" + + parse-params = "(" argument \["," argument\] ")" + + paste-params = "(" argument ")" + + paste-link-params = "(" \*space ")" + + paste-picture-params = "(" \*space ")" + + paste-picture-link-params = "(" \*space ")" + + paste-special-params = "(" argument \*6("," argument) ")" + + paste-tool-params = "(" argument \["," argument\] ")" + + patterns-params = "(" argument \*12("," argument) ")" + + picklist-params = "(" \*space ")" + + pivot-add-fields-params = "(" argument \*4("," argument) ")" + + pivot-field-params = "(" argument \*3("," argument) ")" + + pivot-field-group-params = "(" argument \*3("," argument) ")" + + pivot-field-properties-params = "(" argument \*6("," argument) ")" + + pivot-field-ungroup-params = "(" \*space ")" + + pivot-item-params = "(" argument \*3("," argument) ")" + + pivot-item-properties-params = "(" argument \*6("," argument) ")" + + pivot-refresh-params = "(" argument ")" + + pivot-show-pages-params = "(" argument \["," argument\] ")" + + pivot-table-chart-params = "(" argument \*15("," argument) ")" + + pivot-table-wizard-params = "(" argument \*15("," argument) ")" + + post-document-params = "(" argument ")" + + precision-params = "(" argument ")" + + preferred-params = "(" \*space ")" + + print-params = "(" argument \*16("," argument) ")" + + print-preview-params = "(" argument ")" + + printer-setup-params = "(" argument ")" + + promote-params = "(" argument ")" + + protect-document-params = "(" argument \*6("," argument) ")" + + protect-revisions-params = "(" \*space ")" + + pushbutton-properties-params = "(" argument \*5("," argument) ")" + + quit-params = "(" \*space ")" + + remove-list-item-params = "(" argument \["," argument\] ")" + + remove-page-break-params = "(" argument \["," argument\] ")" + + rename-object-params = "(" argument ")" + + replace-font-params = "(" argument \*9("," argument) ")" + + reset-tool-params = "(" argument \["," argument\] ")" + + rm-print-area-params = "(" argument ")" + + route-document-params = "(" \*space ")" + + routing-slip-params = "(" argument \*5("," argument) ")" + + row-height-params = "(" argument \*3("," argument) ")" + + run-params = "(" argument \["," argument\] ")" + + save-params = "(" \*space ")" + + save-as-params = "(" argument \*6("," argument) ")" + + save-copy-as-params = "(" argument ")" + + save-new-object-params = "(" argument ")" + + save-workbook-params = "(" argument \*5("," argument) ")" + + save-workspace-params = "(" argument ")" + + scale-params = "(" argument \*9("," argument) ")" + + scenario-add-params = "(" argument \*5("," argument) ")" + + scenario-cells-params = "(" argument ")" + + scenario-delete-params = "(" argument ")" + + scenario-edit-params = "(" argument \*6("," argument) ")" + + scenario-merge-params = "(" argument ")" + + scenario-show-params = "(" argument ")" + + scenario-show-next-params = "(" \*space ")" + + scenario-summary-params = "(" argument \["," argument\] ")" + + scrollbar-properties-params = "(" argument \*6("," argument) ")" + + select-params = "(" argument \["," argument\] ")" + + select-all-params = "(" \*space ")" + + select-chart-params = "(" \*space ")" + + select-end-params = "(" argument ")" + + select-last-cell-params = "(" \*space ")" + + select-list-item-params = "(" argument \["," argument\] ")" + + select-plot-area-params = "(" \*space ")" + + select-special-params = "(" argument \*2("," argument) ")" + + send-keys-params = "(" argument \["," argument\] ")" + + send-mail-params = "(" argument \*2("," argument) ")" + + send-to-back-params = "(" \*space ")" + + series-axes-params = "(" argument ")" + + series-order-params = "(" argument \*2("," argument) ")" + + series-x-params = "(" argument ")" + + series-y-params = "(" argument \["," argument\] ")" + + set-control-value-params = "(" argument ")" + + set-criteria-params = "(" \*space ")" + + set-database-params = "(" \*space ")" + + set-dialog-default-params = "(" argument ")" + + set-dialog-focus-params = "(" argument ")" + + set-extract-params = "(" \*space ")" + + set-list-item-params = "(" argument \["," argument\] ")" + + set-page-break-params = "(" \*space ")" + + set-preferred-params = "(" argument ")" + + set-print-area-params = "(" argument ")" + + set-print-titles-params = "(" argument \["," argument\] ")" + + set-update-status-params = "(" argument \*2("," argument) ")" + + share-params = "(" \*space ")" + + share-name-params = "(" argument ")" + + sheet-background-params = "(" argument \["," argument\] ")" + + short-menus-params = "(" argument ")" + + show-active-cell-params = "(" \*space ")" + + show-clipboard-params = "(" \*space ")" + + show-detail-params = "(" argument \*3("," argument) ")" + + show-dialog-params = "(" argument ")" + + show-info-params = "(" argument ")" + + show-levels-params = "(" argument \["," argument\] ")" + + show-toolbar-params = "(" argument \*9("," argument) ")" + + sort-params = "(" argument \*16("," argument) ")" + + sort-special-params = "(" argument \*13("," argument) ")" + + sound-note-params = "(" argument \*2("," argument) ")" + + sound-play-params = "(" argument \*2("," argument) ")" + + spelling-params = "(" argument \*5("," argument) ")" + + split-params = "(" argument \["," argument\] ")" + + standard-font-params = "(" argument \*8("," argument) ")" + + standard-width-params = "(" argument ")" + + style-params = "(" argument \["," argument\] ")" + + subscribe-to-params = "(" argument \["," argument\] ")" + + subtotal-create-params = "(" argument \*5("," argument) ")" + + subtotal-remove-params = "(" \*space ")" + + summary-info-params = "(" argument \*4("," argument) ")" + + tab-order-params = "(" \*space ")" + + table-params = "(" argument \["," argument\] ")" + + text-to-columns-params = "(" argument \*13("," argument) ")" + + tracer-clear-params = "(" \*space ")" + + tracer-display-params = "(" argument \["," argument\] ")" + + tracer-error-params = "(" \*space ")" + + tracer-navigate-params = "(" argument \*2("," argument) ")" + + traverse-notes-params = "(" argument \["," argument\] ")" + + undo-params = "(" \*space ")" + + ungroup-params = "(" \*space ")" + + ungroup-sheets-params = "(" \*space ")" + + unhide-params = "(" argument ")" + + unlocked-next-params = "(" \*space ")" + + unlocked-prev-params = "(" \*space ")" + + unprotect-revisions-params = "(" \*space ")" + + update-link-params = "(" argument \["," argument\] ")" + + vba-insert-file-params = "(" argument ")" + + vba-make-addin-params = "(" argument ")" + + vba-procedure-definition-params = "(" \*space ")" + + vbaactivate-params = "(" argument \["," argument\] ")" + + view-3d-params = "(" argument \*5("," argument) ")" + + view-define-params = "(" argument \*2("," argument) ")" + + view-delete-params = "(" argument ")" + + view-show-params = "(" argument ")" + + vline-params = "(" argument ")" + + vpage-params = "(" argument ")" + + vscroll-params = "(" argument \["," argument\] ")" + + wait-params = "(" argument ")" + + web-publish-params = "(" argument \*8("," argument) ")" + + window-maximize-params = "(" argument ")" + + window-minimize-params = "(" argument ")" + + window-move-params = "(" argument \*2("," argument) ")" + + window-restore-params = "(" argument ")" + + window-size-params = "(" argument \*2("," argument) ")" + + workbook-activate-params = "(" argument \["," argument\] ")" + + workbook-add-params = "(" argument \*2("," argument) ")" + + workbook-copy-params = "(" argument \*2("," argument) ")" + + workbook-delete-params = "(" argument ")" + + workbook-hide-params = "(" argument \["," argument\] ")" + + workbook-insert-params = "(" argument ")" + + workbook-move-params = "(" argument \*2("," argument) ")" + + workbook-name-params = "(" argument \["," argument\] ")" + + workbook-new-params = "(" argument \*2("," argument) ")" + + workbook-next-params = "(" \*space ")" + + workbook-options-params = "(" argument \*2("," argument) ")" + + workbook-prev-params = "(" \*space ")" + + workbook-protect-params = "(" argument \*2("," argument) ")" + + workbook-scroll-params = "(" argument \["," argument\] ")" + + workbook-select-params = "(" argument \*2("," argument) ")" + + workbook-tab-split-params = "(" argument ")" + + workbook-unhide-params = "(" argument ")" + + workgroup-params = "(" argument ")" + + workgroup-options-params = "(" \*space ")" + + workspace-params = "(" argument \*15("," argument) ")" + + zoom-params = "(" argument ")" + +#### Cell Formulas + +A [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) formula is a [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) that adheres to the grammar specified in section [2.2.2](#Section_3d025add118d44139856ab65712ec1b0), with the following restrictions: + +- The formula MUST NOT use the bang-reference or bang-name production rules. + +All **f** elements of **CT_Cell** elements, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, and all **calculatedColumnFormula** and **totalsRowFormula** elements of **CT_TableColumn** elements, as specified in \[ISO/IEC29500-4:2016\] section A.2, are cell formulas. + +#### Conditional Formatting Formulas + +A [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) formula is a [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) that adheres to the grammar specified in section [2.2.2](#Section_3d025add118d44139856ab65712ec1b0), with the following restrictions: + +- The formula MUST NOT use the union-operator, intersection-operator, range-operator, bang-reference, bang-name, array-constant, external-cell-reference, py-params, lambda-params, or structure-reference production rules. + +All **val** [**attributes**](#gt_108a1419-49a9-4d19-b6ca-7206aa726b3f) of **CT_Cfvo** elements, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, and all **formula** elements of **CT_CfRule** elements, as specified in \[ISO/IEC29500-4:2016\] section A.2, are conditional formatting formulas. + +#### Data Validation Formulas + +A [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) formula is a [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) that adheres to the grammar specified in section [2.2.2](#Section_3d025add118d44139856ab65712ec1b0), with the following restrictions: + +- The formula MUST NOT use the union-operator, intersection-operator, range-operator, bang-reference, bang-name, array-constant, sheet-range-reference, py-params, lambda-params, or structure-reference production rules. + +All **formula1** and **formula2** elements of **CT_DataValidation** elements, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, are data validation formulas. + +#### External Name Formulas + +An external name formula is a [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) that adheres to the following grammar: + +1189. external-name-formula = ref-constant / sheet-range-reference / single-sheet-reference + +When matching the single-sheet or sheet-range rules for an external name formula, the optional workbook-index in those rules MUST NOT be omitted. + +All **refersTo** attributes of **CT_ExternalDefinedName** elements, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, are external name formulas. + +#### Name Formulas + +A name formula is a [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) that adheres to the grammar specified in section [2.2.2](#Section_3d025add118d44139856ab65712ec1b0), with the following differences. + +For name formulas, the function-call rule is expanded as follows: + +1190. function-call =/ (macro-function-call / command-function-call) + +The formula MUST NOT use the py-params or local-cell-reference production rule. + +All **formula** and **oldFormula** elements of **CT_RevisionDefinedName** elements, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, and all **definedName** elements of **CT_DefinedNames** elements, as specified in \[ISO/IEC29500-4:2016\] section A.2, are name formulas. + +#### Pivot Field Formulas + +A pivot [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) is a formula that adheres to the grammar specified in section [2.2.2](#Section_3d025add118d44139856ab65712ec1b0), with the following differences. + +For pivot field formulas, the nospace-expression rule is expanded as follows: + +1191. nospace-expression =/ pivot-field-name + + pivot-field-name = name / apostrophe 1\*pivot-field-string-character apostrophe + + pivot-field-string-character = apostrophe apostrophe / pivot-field-character + + pivot-field-character = character ; MUST NOT be apostrophe + +The formula MUST NOT use the ref-infix-operator, array-constant, getpivotdata-params, dcount-params, dcounta-params, dsum-params, daverage-params, dmin-params, dmax-params, dproduct-params, dstdev-params, dstdevp-params, dvar-params, dvarp-params, index-params, rand-params, now-params, areas-params, rows-params, columns-params, offset-params, cell-params, index-params, today-params, info-params, py-params, lambda-params, or randbetween-params production rules. + +A name used in a pivot field formula MUST NOT have any of the following forms: + +- All + +- Blank + +All **formula** attributes of **CT_CacheField** elements, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, are pivot field formulas. + +#### Pivot Item Formulas + +A pivot item formula is a [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) that adheres to the grammar specified in section [2.2.2](#Section_3d025add118d44139856ab65712ec1b0), with the following differences. + +For pivot item formulas, the nospace-expression rule is expanded as follows: + +1195. nospace-expression =/ pivot-items + + pivot-items = pivot-item space \*(\*whitespace pivot-item) + + pivot-item = pivot-field-name / pivot-field-name "\[" pivot-item-value "\]" + + pivot-item-value = pivot-field-name / \[sign\] whole-number-part + +The formula MUST NOT use the ref-infix-operator, array-constant, getpivotdata-params, dcount-params, dcounta-params, dsum-params, daverage-params, dmin-params, dmax-params, dproduct-params, dstdev-params, dstdevp-params, dvar-params, dvarp-params, index-params, rand-params, now-params, areas-params, rows-params, columns-params, offset-params, cell-params, index-params, today-params, info-params, py-params, lambda-params, or randbetween-params production rules. + +A name used in a pivot item formula MUST NOT have any of the following forms: + +- All + +- Blank + +All **formula** attributes of **CT_CalculatedItem** elements, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, are pivot item formulas. + +### Functions + +The predefined functions ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.17.7) are extended by the following [**future functions**](#gt_50d13373-3f59-4d18-a9ab-a86565ee1b48). + +| Future function | +|---------------------------------| +| \_xlfn.\_xlws.FILTER | +| \_xlfn.\_xlws.PY | +| \_xlfn.\_xlws.SORT | +| \_xlfn.ACOT | +| \_xlfn.ACOTH | +| \_xlfn.AGGREGATE | +| \_xlfn.ARABIC | +| \_xlfn.BASE | +| \_xlfn.BETA.DIST | +| \_xlfn.BETA.INV | +| \_xlfn.BINOM.DIST | +| \_xlfn.BINOM.DIST.RANGE | +| \_xlfn.BINOM.INV | +| \_xlfn.BITAND | +| \_xlfn.BITLSHIFT | +| \_xlfn.BITOR | +| \_xlfn.BITRSHIFT | +| \_xlfn.BITXOR | +| \_xlfn.BYCOL | +| \_xlfn.BYROW | +| \_xlfn.CEILING.MATH | +| \_xlfn.CEILING.PRECISE | +| \_xlfn.CHISQ.DIST | +| \_xlfn.CHISQ.DIST.RT | +| \_xlfn.CHISQ.INV | +| \_xlfn.CHISQ.INV.RT | +| \_xlfn.CHISQ.TEST | +| \_xlfn.CHOOSECOLS | +| \_xlfn.CHOOSEROWS | +| \_xlfn.COMBINA | +| \_xlfn.CONCAT | +| \_xlfn.CONFIDENCE.NORM | +| \_xlfn.CONFIDENCE.T | +| \_xlfn.COT | +| \_xlfn.COTH | +| \_xlfn.COVARIANCE.P | +| \_xlfn.COVARIANCE.S | +| \_xlfn.CSC | +| \_xlfn.CSCH | +| \_xlfn.DAYS | +| \_xlfn.DECIMAL | +| \_xlfn.DROP | +| ECMA.CEILING | +| \_xlfn.ERF.PRECISE | +| \_xlfn.ERFC.PRECISE | +| \_xlfn.EXPAND | +| \_xlfn.EXPON.DIST | +| \_xlfn.F.DIST | +| \_xlfn.F.DIST.RT | +| \_xlfn.F.INV | +| \_xlfn.F.INV.RT | +| \_xlfn.F.TEST | +| \_xlfn.FIELDVALUE | +| \_xlfn.FILTERXML | +| \_xlfn.FLOOR.MATH | +| \_xlfn.FLOOR.PRECISE | +| \_xlfn.FORECAST.ETS | +| \_xlfn.FORECAST.ETS.CONFINT | +| \_xlfn.FORECAST.ETS.SEASONALITY | +| \_xlfn.FORECAST.ETS.STAT | +| \_xlfn.FORECAST.LINEAR | +| \_xlfn.FORMULATEXT | +| \_xlfn.GAMMA | +| \_xlfn.GAMMA.DIST | +| \_xlfn.GAMMA.INV | +| \_xlfn.GAMMALN.PRECISE | +| \_xlfn.GAUSS | +| \_xlfn.HSTACK | +| \_xlfn.HYPGEOM.DIST | +| \_xlfn.IFNA | +| \_xlfn.IFS | +| \_xlfn.IMCOSH | +| \_xlfn.IMCOT | +| \_xlfn.IMCSC | +| \_xlfn.IMCSCH | +| \_xlfn.IMSEC | +| \_xlfn.IMSECH | +| \_xlfn.IMSINH | +| \_xlfn.IMTAN | +| \_xlfn.ISFORMULA | +| ISO.CEILING | +| \_xlfn.ISOMITTED | +| \_xlfn.ISOWEEKNUM | +| \_xlfn.LAMBDA | +| \_xlfn.LET | +| \_xlfn.LOGNORM.DIST | +| \_xlfn.LOGNORM.INV | +| \_xlfn.MAKEARRAY | +| \_xlfn.MAP | +| \_xlfn.MAXIFS | +| \_xlfn.MINIFS | +| \_xlfn.MODE.MULT | +| \_xlfn.MODE.SNGL | +| \_xlfn.MUNIT | +| \_xlfn.NEGBINOM.DIST | +| NETWORKDAYS.INTL | +| \_xlfn.NORM.DIST | +| \_xlfn.NORM.INV | +| \_xlfn.NORM.S.DIST | +| \_xlfn.NORM.S.INV | +| \_xlfn.NUMBERVALUE | +| \_xlfn.PDURATION | +| \_xlfn.PERCENTILE.EXC | +| \_xlfn.PERCENTILE.INC | +| \_xlfn.PERCENTRANK.EXC | +| \_xlfn.PERCENTRANK.INC | +| \_xlfn.PERMUTATIONA | +| \_xlfn.PHI | +| \_xlfn.POISSON.DIST | +| \_xlfn.PQSOURCE | +| \_xlfn.PYTHON_STR | +| \_xlfn.PYTHON_TYPE | +| \_xlfn.PYTHON_TYPENAME | +| \_xlfn.QUARTILE.EXC | +| \_xlfn.QUARTILE.INC | +| \_xlfn.QUERYSTRING | +| \_xlfn.RANDARRAY | +| \_xlfn.RANK.AVG | +| \_xlfn.RANK.EQ | +| \_xlfn.REDUCE | +| \_xlfn.RRI | +| \_xlfn.SCAN | +| \_xlfn.SEC | +| \_xlfn.SECH | +| \_xlfn.SEQUENCE | +| \_xlfn.SHEET | +| \_xlfn.SHEETS | +| \_xlfn.SKEW.P | +| \_xlfn.SORTBY | +| \_xlfn.STDEV.P | +| \_xlfn.STDEV.S | +| \_xlfn.SWITCH | +| \_xlfn.T.DIST | +| \_xlfn.T.DIST.2T | +| \_xlfn.T.DIST.RT | +| \_xlfn.T.INV | +| \_xlfn.T.INV.2T | +| \_xlfn.T.TEST | +| \_xlfn.TAKE | +| \_xlfn.TEXTAFTER | +| \_xlfn.TEXTBEFORE | +| \_xlfn.TEXTJOIN | +| \_xlfn.TEXTSPLIT | +| \_xlfn.TOCOL | +| \_xlfn.TOROW | +| \_xlfn.UNICHAR | +| \_xlfn.UNICODE | +| \_xlfn.UNIQUE | +| \_xlfn.VAR.P | +| \_xlfn.VAR.S | +| \_xlfn.VSTACK | +| \_xlfn.WEBSERVICE | +| \_xlfn.WEIBULL.DIST | +| WORKDAY.INTL | +| \_xlfn.WRAPCOLS | +| \_xlfn.WRAPROWS | +| \_xlfn.XLOOKUP | +| \_xlfn.XOR | +| \_xlfn.Z.TEST | + +The function syntax (\[ISO/IEC29500-1:2016\] section 18.17.2.4) is extended by changing the function-name rule to: + +1199. function-name = + + prefixed-function-name \| + + predefined-function-name \| + + user-defined-function-name \| + + future-function-list \| + + worksheet-only-function-list; + +The [future-function-list](#Section_3d025add118d44139856ab65712ec1b0) and worksheet-only-function-list rules are found in the Formulas grammar. + +### Extensions by Part + +This section specifies the elements from Office Open XML file formats as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) that are extended by this format. Either the **Ignorable** attribute ([\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.2), **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5), or the **extLst** element (\[ISO/IEC29500-1:2016\] section 18.2.10) MUST be used to maintain compatibility with Office Open XML file formats implementations as specified in \[ISO/IEC29500-1:2016\]. + +#### Connections + +The **extLst** child element ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.10) of the **connection** element (\[ISO/IEC29500-1:2016\] section 18.13.1) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {D79990A0-CA42-45E3-83F4-45C500A0EAA5} | [**connection**](#Section_76651adb815a4c0a93b305f1361a4f86) | +| {DE250136-89BD-433C-8126-D09CA5730AF9} | [**connection**](#Section_4c89a76488884a5b8dedd626cf268546) | + +  + +See [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.3 for more details about how extension lists are used. + +#### Drawing + +The **oneCellAnchor** element ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 20.5.2.24) is extended by the addition of a child **AlternateContent** element ([\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/drawingml/2010/slicerslicer
Fallback

sp

+

([ISO/IEC29500-1:2016] section 20.5.2.29)

+ +The **twoCellAnchor** element (\[ISO/IEC29500-1:2016\] section 20.5.2.33) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/drawingml/2010/slicerslicer
Fallback

sp

+

([ISO/IEC29500-1:2016] section 20.5.2.29)

+ +The **grpSp** element (\[ISO/IEC29500-1:2016\] section 20.5.2.17) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/drawingml/2010/slicerslicer
Fallback

sp

+

([ISO/IEC29500-1:2016] section 20.5.2.29)

+ +The **absoluteAnchor** element (\[ISO/IEC29500-1:2016\] section 20.5.2.1) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/drawingml/2010/slicerslicer
Fallback

sp

+

([ISO/IEC29500-1:2016] section 20.5.2.29)

+ +#### External Workbook References + +The **oleItems** element ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.14.10) is extended by the addition of a child **AlternateContent** element ([\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/mainoleItem
Fallback

oleItem

+

([ISO/IEC29500-1:2016] section 18.14.9)

+ +#### Metadata + +The **extLst** child element ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.2) of the **futureMetadata** element (\[ISO/IEC29500-1:2016\] section 18.9.4) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section A.2) whose structure is specified in the following table. All **futureMetadata** elements are also linked to a **metadataType** (\[ISO/IEC29500-1:2016\] section 18.9.10) by the **name** attribute. + +| Ext URI | name attribute | Child element | +|----|----|----| +| {3E2802C4-A4D2-4D8B-9148-E3BE6C30E623} | "XLRICHVALUE" | [**rvb**](#Section_d54dccb62ecc475d97fe4a9ae5d3f94e) | +| {BDBB8CDC-FA1E-496E-A857-3C3F30C029C3} | "XLDAPR" | **[dynamicArrayProperties](#Section_0f72449211ea437fac2bcc097b255da1)** | + +#### Pivot Table + +The **extLst** child element ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.10) of the **pivotTableDefinition** element (\[ISO/IEC29500-1:2016\] section 18.10.1.73) is extended by the addition of new child **ext** elements (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {962EF5D1-5CA2-4C93-8EF4-DBF5C05439D2} | [**pivotTableDefinition**](#Section_027c658596e24b7c9a8a02470415ac4a) | +| {44433962-1CF7-4059-B4EE-95C3D5FFCF73} | [**pivotTableData**](#Section_31ad0c9368d24bc49969dc4662acfa11) | +| {C510F80B-63DE-4267-81D5-13C33094786E} | [**pivotTableServerFormats**](#Section_781517a425dc4ce9be2b08a9d9c3f17d) | +| {E67621CE-5B39-4880-91FE-76760E9C1902} | [**pivotTableUISettings**](#Section_bb1ec32a95c34c909b0dff5a4f7dbb02) | +| {747A6164-185A-40DC-8AA5-F01512510D54} | [**pivotTableDefinition16**](#Section_00fc52cc16cb4e80997bf95a9d46750e) | + +  + +See [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.3 for more information about how extension lists are used. + +The **extLst** child element (\[ISO/IEC29500-1:2016\] section 18.2.10) of the **pivotField** element (\[ISO/IEC29500-1:2016\] section 18.10.1.69) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {2946ED86-A175-432A-8AC1-64E0C546D7DE} | [**pivotField**](#Section_86b2cf566d544920931e360387c3e7a6) | + +  + +See \[ISO/IEC29500-3:2015\] section 7.3 for more information about how extension lists are used. + +The **extLst** child element (\[ISO/IEC29500-1:2016\] section 18.2.10) of the **dataField** element (\[ISO/IEC29500-1:2016\] section 18.10.1.22) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {E15A36E0-9728-4E99-A89B-3F7291B0FE68} | [**dataField**](#Section_c6db847cbbfd44ac9ad68165dbbb3471) | + +  + +See \[ISO/IEC29500-3:2015\] section 7.3 for more information about how extension lists are used. + +The **extLst** child element (\[ISO/IEC29500-1:2016\] section 18.2.10) of the **pivotHierarchy** element (\[ISO/IEC29500-1:2016\] section 18.10.1.72) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {F1805F06-0CD304483-9156-8803C3D141DF} | [**pivotHierarchy**](#Section_b49c750881934e7da299f481d8c125a8) | + +  + +See \[ISO/IEC29500-3:2015\] section 7.3 for more information about how extension lists are used. + +The **filterColumn** element (\[ISO/IEC29500-1:2016\] section 18.3.2.7) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/mainiconFilter
Fallback

customFilters

+

([ISO/IEC29500-1:2016] section 18.3.2.3)

+ +The **filterColumn** element (\[ISO/IEC29500-1:2016\] section 18.3.2.7) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/maincustomFilters
Fallback

Either customFilters

+

([ISO/IEC29500-1:2016] section 18.3.2.3)

+

or none

+ +The **extLst** child element (\[ISO/IEC29500-1:2016\] section 18.2.10) of the **filterColumn** element (\[ISO/IEC29500-1:2016\] section 18.3.2.7) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/mainfilter
Fallback

customFilters

+

([ISO/IEC29500-1:2016] section 18.3.2.3)

+ +The **filters** element (\[ISO/IEC29500-1:2016\] section 18.3.2.8) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/mainfilter
Fallback

Either filter

+

([ISO/IEC29500-1:2016] section 18.3.2.6) or none

+ +The **sortState** element (\[ISO/IEC29500-1:2016\] section 18.3.1.92) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/mainsortCondition
Fallback

sortCondition

+

([ISO/IEC29500-1:2016] section 18.3.1.91)

+ +The **extLst** child element (\[ISO/IEC29500-1:2016\] section 18.2.10) of the **filter** element (\[ISO/IEC29500-1:2016\] section 18.10.1.33) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {0605FD5F-26C8-4aeb-8148-2DB25E43C511} | [**pivotFilter**](#Section_432756fe5b79480d8459eb24c0a60e4a) | + +#### Pivot Table Cache Definition + +The **extLst** child element ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.10) of the **pivotCacheDefinition** element (\[ISO/IEC29500-1:2016\] section 18.10.1.67) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {725AE2AE-9491-48BE-B2B4-4EB974FC3084} | [**pivotCacheDefinition**](#Section_f320536cead5481ca93c9bdbfe6e6825) | +| {5DA0FC9A-693D-419c-AD59-312A39285967} | [**timelinePivotCacheDefinition**](#Section_077eebbb46e5424ca04bb2c5787ad306) | +| {ABF5C744-AB39-4b91-8756-CFA1BBC848D5} | [**pivotCacheIdVersion**](#Section_1cbabb48679e437f8e9d2272eaf00023) | + +  + +See [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.3 for more information about how extension lists are used. + +The **extLst** child element (\[ISO/IEC29500-1:2016\] section 18.2.10) of the **cacheField** element (\[ISO/IEC29500-1:2016\] section 18.10.1.3) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {63CAB8AC-B538-458D-9797-405883B0398D} | [**cacheField**](#Section_a7483bc6b6f5424e9a4c805d42af8713) | +| {4F2E5C28-24EA-4EB8-9CBF-B6C8F9C3D259} | [**cachedUniqueNames**](#Section_f8b77928122640299cce1ea2dc2fdd47) | + +  + +See \[ISO/IEC29500-3:2015\] section 7.3 for more information about how extension lists are used. + +The **extLst** child element (\[ISO/IEC29500-1:2016\] section 18.2.10) of the **cacheHierarchy** element (\[ISO/IEC29500-1:2016\] section 18.10.1.6) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {8CF416AD-EC4C-4ABA-99F5-12A058AE0983} | [**cacheHierarchy**](#Section_1750517725cc4bd9a82dacba4ce35bac) | +| {B97F6D7D-B522-45F9-BDA1-12C45D357490} | [**cacheHierarchy**](#Section_bbcca1a32cb6484d905a590a9d24051b) | + +  + +See \[ISO/IEC29500-3:2015\] section 7.3 for more information about how extension lists are used. + +The **extLst** child element (\[ISO/IEC29500-1:2016\] section 18.2.10) of the **calculatedMember** element (\[ISO/IEC29500-1:2016\] section 18.10.1.10) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {0C70D0D5-359C-4A49-802D-23BBF952B5CE} | [**calculatedMember**](#Section_bc43a89b8aac4a07a9fe8aeabd85d547) | +| {57DEB092-E4DC-418E-9C9A-C0C97F8552CB} | [**calculatedMember**](#Section_9370df00d6e34242911fce734680bc90) | + +  + +See \[ISO/IEC29500-3:2015\] section 7.3 for more information about how extension lists are used. + +The **extLst** child element (\[ISO/IEC29500-1:2016\] section 18.2.10) of the **cacheSource** element (\[ISO/IEC29500-1:2016\] section 18.10.1.7) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {F057638F-6D5F-4E77-A914-E7F072B9BCA8} | **[sourceConnection](#Section_11af8735701f4c889582c0ab633213df)** | + +  + +See \[ISO/IEC29500-3:2015\] section 7.3 for more information about how extension lists are used. + +#### Query Table + +The **sortState** element ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.3.1.92) is extended by the addition of a child **AlternateContent** element ([\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/mainsortCondition
Fallback

sortCondition

+

([ISO/IEC29500-1:2016] section 18.3.1.91)

+ +The **extLst** child element (\[ISO/IEC29500-1:2016\] section 18.2.10) of the **queryTable** element (\[ISO/IEC29500-1:2016\] section 18.12.2) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {883FBD77-0823-4A55-B5E3-86C4891E6966} | [**queryTable**](#Section_de6cd320f9184d3aae7c24fbb5a16ca9) | + +  + +See \[ISO/IEC29500-3:2015\] section 7.3 for more information about how extension lists are used. + +#### SlicerCache + +The **extLst** child element ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.10) of the **slicerCacheDefinition** element (section [2.4.38](#Section_13e66a54691846989e584905a7b02ab5)) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {03082B11-2C62-411c-B77F-237D8FCFBE4C} | [**slicerCachePivotTables**](#Section_e6c858b35d444f4699317e0d93d59755) | +| {2F2917AC-EB37-4324-AD4E-5DD8C200BD13} | [**tableSlicerCache**](#Section_ccb38b987f6e44189dcb004b9ccd4c82) | +| {470722E0-AACD-4C17-9CDC-17EF765DBC7E} | [**slicerCacheHideItemsWithNoData**](#Section_c2b82e4b8d6641a298a5a66e60d719a4) | + +#### Styles + +The **extLst** child element ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.10) of the **styleSheet** element (\[ISO/IEC29500-1:2016\] section 18.8.39) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {EB79DEF2-80B8-43E5-95BD-54CBDDF9020C} | [**slicerStyles**](#Section_00880b6a96b74718bf4a1212828217e4) | +| {46F421CA-312F-682F-3DD2-61675219B42D} | [**dxfs**](#Section_fc75d7f642f34297b55e05f518059cf6) | +| {9260A510-F301-46a8-8635-F512D64BE5F5} | [**timelineStyles**](#Section_d7f2de781622492bac46032d0bb211d7) | +| {A0A4C193-F2C1-4fcb-8827-314CF55A85BB} | [**dxfs**](#Section_c7d758644136460499cb52937e143a68) | + +  + +See [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.3 for more information about how extension lists are used. + +The **font** element (\[ISO/IEC29500-1:2016\] section 18.8.22) is extended by the addition of a [**knownFonts**](#Section_72e7aca29e8c4435a0526e5b83cdd72c) attribute. To maintain compatibility with implementations of Office Open XML file formats as specified in \[ISO/IEC29500-1:2016\], the namespace prefix of the attribute MUST be specified as an **Ignorable** attribute (\[ISO/IEC29500-3:2015\] section 7.2). + +The **extLst** child element (\[ISO/IEC29500-1:2016\] section 18.2.10) of the **xf** element (\[ISO/IEC29500-1:2016\] section 18.8.45) of the **cellXfs** element (\[ISO/IEC29500-1:2016\] section 18.8.10) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {C7286773-470A-42A8-94C5-96B5CB345126} | [**xfComplementExt**](#Section_7b9ee8f05f77416b9cdc747a986b064b) | + +The **extLst** child element (\[ISO/IEC29500-1:2016\] section 18.2.10) of the **dxf** element (\[ISO/IEC29500-1:2016\] section 18.8.14) of the **dxfs** element (\[ISO/IEC29500-1:2016\] section 18.8.15) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {0417FA29-78FA-4A13-93AC-8FF0FAFDF519} | [**DXFComplementExt**](#Section_74fddcc6558a4300bd3632f63df51463) | + +#### Table Definition + +The **extLst** child element ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.10) of the **table** element (\[ISO/IEC29500-1:2016\] section 18.5.1.2) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {504A1906-F514-4F6F-8877-14C23A59335A} | [**table**](#Section_53d30645b319490bb980afb5ac17f31b) | + +  + +See [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.3 for more information about how extension lists are used. + +The **filterColumn** element (\[ISO/IEC29500-1:2016\] section 18.3.2.7) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/mainiconFilter
Fallback

customFilters

+

([ISO/IEC29500-1:2016] section 18.3.2.3)

+ +The **filterColumn** element (\[ISO/IEC29500-1:2016\] section 18.3.2.7) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/maincustomFilters
Fallback

Either customFilters

+

([ISO/IEC29500-1:2016] section 18.3.2.3)

+

or none

+ +The **filterColumn** element (\[ISO/IEC29500-1:2016\] section 18.3.2.7) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/main

filters

+

([ISO/IEC29500-1:2016] section 18.3.2.8) such that instead of any child filter ([ISO/IEC29500-1:2016] section 18.3.2.6) elements, there are filter elements

Fallback

customFilters

+

([ISO/IEC29500-1:2016] section 18.3.2.3)

+ +The **filters** element (\[ISO/IEC29500-1:2016\] section 18.3.2.8) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/mainfilter
Fallback

Either filter

+

([ISO/IEC29500-1:2016] section 18.3.2.6) or none

+ +The **sortState** element (\[ISO/IEC29500-1:2016\] section 18.3.1.92) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/mainsortCondition
Fallback

sortCondition

+

([ISO/IEC29500-1:2016] section 18.3.1.91)

+ +#### Workbook + +The **extLst** child element ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.10) of the **workbook** element (\[ISO/IEC29500-1:2016\] section 18.2.27) is extended by the addition of new child **ext** elements (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {876F7934-8845-4945-9796-88D515C7AA90} | [**pivotCaches**](#Section_7d1243a86bc64f0e833efedc1ffc7946) | +| {BBE1A952-AA13-448E-AADC-164F8A28A991} | [**slicerCaches**](#Section_ab381c193d574d6fa732d1d0602555ce) | +| {79F54976-1DA5-4618-B147-ACDE4B953A38} | [**workbookPr**](#Section_f8eeeaada8b349f9903e9c4bfaff1fea) | +| {841E416B-1EF1-43b6-AB56-02D37102CBD5} | [**pivotCaches**](#Section_57538b20951e4b74912c68fc20177e96) | +| {983426D0-5260-488c-9760-48F4B6AC55F4} | [**pivotTableReferences**](#Section_d9ac8a3960a6493989cc8d9de42e4b48) | +| {A2CB5862-8E78-49c6-8D9D-AF26E26ADB89} | [**timelineCachePivotCaches**](#Section_253b845980984a6192bf4fe7bc64de0d) | +| {D0CA8CA8-9F24-4464-BF8E-62219DCF47F9} | [**timelineCacheRefs**](#Section_e4fb0fc619c041feb21e5b1ba3110a94) | +| {140A7094-0E35-4892-8432-C4D2E57EDEB5} | [**workbookPr**](#Section_a74afac6ef62436fbd530dc503423f35) | +| {FCE2AD5D-F65C-4FA6-A056-5C36A1767C68} | [**dataModel**](#Section_523913d2fc1e473e8d145d2d4d7f9702) | +| {B58B0392-4F1F-4190-BB64-5DF3571DCE5F} | [**calcFeatures**](#Section_c1a60ba08af14b09a6668118f1c39d69) | +| {FCE6A71B-6B00-49CD-AB44-F6B1AE7CDE65} | [externalLinkPr](#Section_eaea6a6338034e8cb1ef161c5fdbae3b) | + +  + +The **extLst** child element (\[ISO/IEC29500-1:2016\] section 18.2.10) of the **dataModel** element (section 2.4.62) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {9835A34E-60A6-4A7C-AAB8-D5F71C897F49} | [**ModelTimeGroupings**](#Section_540bec4f4eae4357bd8a6a3d7963e315) | + +  + +See [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.3 for more information about how extension lists are used. + +#### Worksheet + +The **extLst** child element ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.10) of the **worksheet** element (\[ISO/IEC29500-1:2016\] section 18.3.1.99) is extended by the addition of new child **ext** elements (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {78C0D931-6437-407D-A8EE-F0AAD7539E65} | [**conditionalFormattings**](#Section_e5876d4c5362497fbd1ab6de4604d11c) | +| {CCE6A557-97BC-4B89-ADB6-D9C93CAAB3DF} | [**dataValidations**](#Section_2010725aec4746d89f7b16882cc575f6) | +| {05C60535-1F16-4FD2-B633-F4F36F0B64E0} | [**sparklineGroups**](#Section_712ac8a5cad4404a9b679033bff2774a) | +| {A8765BA9-456A-4DAB-B4F3-ACF838C121DE} | [**slicerList**](#Section_a307ee69f90b4368855f38530bfa9b81) | +| {FC87AEE6-9EDD-4A0A-B7FB-166176984837} | [**protectedRanges**](#Section_ce68aca7ca694e0a884533ae55d2e8f0) | +| {01252117-D84E-4E92-8308-4BE1C098FCBB} | [**ignoredErrors**](#Section_0d164d8523bf4d4387c59fcde148aabe) | +| {F7C9EE02-42E1-4005-9D12-6889AFFD525C} | [**webExtensions**](#Section_c69e2a9b98044d1294629e8bf9b06713) | +| {7E03D99C-DC04-49d9-9315-930204A7B6E9} | [**timelineRefs**](#Section_e2dbbfe8b38f4c8285c9ccf543a22635) | + +  + +See [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.3 for more information about how extension lists are used. + +The **extLst** child element (\[ISO/IEC29500-1:2016\] section 18.2.10) of the **cfRule** element (\[ISO/IEC29500-1:2016\] section 18.3.1.10) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {B025F937-C7B1-47D3-B67F-A62EFF666E3E} | [**id**](#Section_d98dad7eb8cb498abc537fdbeed46f99) | + +See \[ISO/IEC29500-3:2015\] section 7.3 for more information about how extension lists are used. + +The **sheetFormatPr** element (\[ISO/IEC29500-1:2016\] section 18.3.1.81) is extended by the addition of a [**dyDescent**](#Section_f11dfda446de40358418d76b0d3898f1) attribute. To maintain compatibility with Office Open XML file formats implementations as specified in \[ISO/IEC29500-1:2016\], the namespace prefix of the attribute MUST be specified as an **Ignorable** attribute (\[ISO/IEC29500-3:2015\] section 7.2). + +The **row** element (\[ISO/IEC29500-1:2016\] section 18.3.1.73) is extended by the addition of a **dyDescent** attribute. To maintain compatibility with Office Open XML file formats implementations as specified in \[ISO/IEC29500-1:2016\], the namespace prefix of the attribute MUST be specified as an **Ignorable** attribute (\[ISO/IEC29500-3:2015\] section 7.2). + +The **sortState** element (\[ISO/IEC29500-1:2016\] section 18.3.1.92) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/mainsortCondition
Fallback

sortCondition

+

([ISO/IEC29500-1:2016] section 18.3.1.91)

+ +The **sortState** element (\[ISO/IEC29500-1:2016\] section 18.3.1.92) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {0FC57C36-975A-43D2-8416-536B9B585D1B} | [**richSortCondition**](#Section_d22f5ce6c38b4a75b3c0e364d694aa2a) | + +The **filterColumn** element (\[ISO/IEC29500-1:2016\] section 18.3.2.7) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/mainiconFilter
Fallback

customFilters

+

([ISO/IEC29500-1:2016] section 18.3.2.3)

+ +The **filterColumn** element (\[ISO/IEC29500-1:2016\] section 18.3.2.7) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/maincustomFilters
Fallback

Either customFilters

+

([ISO/IEC29500-1:2016] section 18.3.2.3)

+

or none

+ +The **filterColumn** element (\[ISO/IEC29500-1:2016\] section 18.3.2.7) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/main

filters

+

([ISO/IEC29500-1:2016] section 18.3.2.8) such that instead of child filter ([ISO/IEC29500-1:2016] section 18.3.2.6) elements, there are filter elements

Fallback

customFilters

+

([ISO/IEC29500-1:2016] section 18.3.2.3)

+ +The **filterColumn** element (\[ISO/IEC29500-1:2016\] section 18.3.2.7) is extended by the addition of a new child **ext** element (\[ISO/IEC29500-1:2016\] section 18.2.7) whose structure is specified in the following table. + +| Ext URI | Child element | +|----|----| +| {68452572-C921-441B-96FD-77FB3E787301} | [**filterColumn**](#Section_b1354c156c7143d3847741d113def51a) | + +The **filters** element (\[ISO/IEC29500-1:2016\] section 18.3.2.8) is extended by the addition of a child **AlternateContent** element (\[ISO/IEC29500-3:2015\] section 7.5) whose structure is specified in the following table. + + ++++ + + + + + + + + + + + + + + + + +
AlternateContent componentsChild element
Choice: http://schemas.microsoft.com/office/spreadsheetml/2009/9/mainfilter
Fallback

Either filter

+

([ISO/IEC29500-1:2016] section 18.3.2.6) or none

+ +## Conceptual Overview + +This section specifies how higher-level features of the file format are represented by combinations of low-level structures. + +### PivotTable What-if Analysis + +[**PivotTable**](#gt_38963165-73bc-400a-a809-aff03693a316) what-if analysis enables the editing of summarized values in an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) view, for example, editing summarized values in the PivotTable data area of the PivotTable view. + +A **CT_PivotEdits** element, as specified in section [2.6.37](#Section_52f5f3e69d9e44ee86abacbed02f4759), and its child **CT_PivotEdit** elements, as specified in section [2.6.38](#Section_0e2c9edbfb384b33950fcabfdbd9b189), specify the values in the OLAP PivotTable view that have been modified and the corresponding values in the OLAP PivotTable [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0). The **CT_PivotUserEdit** child element, as specified in section [2.6.41](#Section_c05d26ce4237405ab8a4429b62ad7642), of the **CT_PivotEdit** element specifies a value or a [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169). The location of the modified value in the OLAP PivotTable view is specified by a PivotTable rule specified by the **CT_PivotArea** element ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) in this **CT_PivotEdit** element. The [**OLAP tuple**](#gt_3a1a687f-d28b-485b-96a0-ba0b7eb4119e) that identifies the corresponding value in the OLAP PivotTable source data is specified by the **CT_TupleItems** element, as specified in section [2.6.43](#Section_e25f1558b7a94f0ca3d1819b6df8978c), in this **CT_PivotEdit** element. + +A **CT_PivotChanges** element, as specified in section [2.6.39](#Section_5232ab016308401f9900b8dd759a3aee), and its child **CT_PivotChange** elements, as specified in section [2.6.40](#Section_dcf52159107344fcbbc41f2510b60283), specify the values in the OLAP PivotTable view that have been designated for [**OLAP allocation**](#gt_05133de2-8700-4030-8aca-1a3f0b91b9a8) and the corresponding values in the OLAP PivotTable source data. The order of the **CT_PivotChange** elements determines the order in which they are designated for OLAP allocation. The **CT_PivotChange** element specifies a single edited value designated for OLAP allocation. An OLAP allocation value is specified by the **CT_PivotEditValue** child element, as specified in section [2.6.42](#Section_fc28f146d73a46f6bf4c282fc9a960ef), of the **CT_PivotChange** element. The **allocationMethod** attribute of the **CT_PivotChange** element specifies the OLAP allocation method. The OLAP tuple that identifies the location of the edited value in the OLAP PivotTable view and the corresponding value in the OLAP PivotTable source data is specified by the **CT_TupleItems** child element of the **CT_PivotChange** element. + +For example, when an OLAP PivotTable is refreshed, the values designated for OLAP allocation, specified by the **CT_PivotChanges** element and its child **CT_PivotChange** elements, are sent to the OLAP [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e) along with the OLAP allocation method indicating how to allocate the updated values. The OLAP data provider updates the values, and those new values are then refreshed and summarized in the data area of the PivotTable view, instead of summarizing the original values from the OLAP PivotTable source data. + +If the **enableEdit** attribute of the **CT_PivotTableDefinition** element, as specified in section [2.6.32](#Section_4fa0ac531c40475fad76d06c604df3e3), is "false", **CT_PivotEdits** and **CT_PivotChanges** elements MUST NOT exist in this part. PivotTable what-if analysis is enabled if, and only if, the **enableEdit** attribute of the **CT_PivotTableDefinition** element is "true" and the PivotTable source data is OLAP. + +### Slicers + +A slicer is a mechanism for filtering data in PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) views, [**cube functions**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3), [**tables**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) (\[ISO/IEC29500-1:2016\] section 18.5.1.2) and Charts (\[ISO/IEC29500-1:2016\] section 21.2) based on [Non-Worksheet PivotTables](#Section_6ad0de69bcbd4c239b0f5018b86289e2). A slicer is based on a [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) in the [slicer source data](#Section_953b6fbd8a1241029d6a7da6de12598a), and the slicer filters on distinct values in that [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972). In the case of using [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) slicer source data, a slicer is based on an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c). + +A slicer has two major parts, a [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf) and a [slicer view](#Section_69c0e0f9d0144bd59f2d2f554c715083). There can be more than one slicer view based on a single slicer cache. When filtering multi-level OLAP hierarchies using slicers, separate slicer views are used for each [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168). + +#### Slicer Cache + +A slicer cache specifies the subset of [slicer source data](#Section_953b6fbd8a1241029d6a7da6de12598a) that is cached for display in [slicer views](#Section_69c0e0f9d0144bd59f2d2f554c715083), as well as properties related to [slicer](#Section_6c8a1b950c1842adbe5094771b2732f4) filtering. A slicer cache is specified by the [**CT_SlicerCacheDefinition**](#Section_808f571ceac440919b4fc8882d43de49) element. + +A slicer cache has an associated PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) PivotCache as specified in section [2.3.2.1.2](#Section_2a393f8521f94a27a2b74867223f4b9a), or **Table** (\[ISO/IEC29500-1:2016\] section 18.5.1.2). + +If the slicer source data is an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075), the **sourceName** attribute of the **CT_SlicerCacheDefinition** element specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the associated [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c). + +If the slicer source data is a non-OLAP data source, the **sourceName** attribute of the **CT_SlicerCacheDefinition** element specifies the associated PivotTable cache [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) of the associated PivotTable **PivotCache**. + +If the slicer source data is a table data source, the **sourceName** attribute of the **CT_SlicerCacheDefinition** element specifies the associated [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) field. + +If the slicer is used to [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) PivotTable views, the slicer cache specifies the PivotTable views being filtered as specified in section [2.3.2.1.4](#Section_08ea5e044cef4f759ea4d2d99050f2d1). + +##### Slicer Source Data + +The [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0) for a [slicer](#Section_6c8a1b950c1842adbe5094771b2732f4) is specified by the associated PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) PivotCache as specified in [Slicer Cache Relationship to PivotCache](#Section_2a393f8521f94a27a2b74867223f4b9a), or **Table** (\[ISO/IEC29500-1:2016\] section 18.5.1.2) as specified in [Slicer Cache Relationship to Table](#Section_0edc71d529844a868fb0a43806a7913a). + +##### Slicer Cache Relationship to PivotCache + +A [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf) can be associated with a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) PivotCache. The association is specified by the following rules: + +- If the [**CT_SlicerCacheDefinition**](#Section_808f571ceac440919b4fc8882d43de49) element has a child [**CT_SlicerCacheData**](#Section_da6c38a25de94ea8bb9a242925b5d468) element with a child [**CT_OlapSlicerCache**](#Section_9b19292cbaf8419f83b51a04ae068174) element, then the type of [slicer source data](#Section_953b6fbd8a1241029d6a7da6de12598a) is [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) and the associated PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache of the slicer cache is specified by the **pivotCacheId** attribute of the CT_OlapSlicerCache element. The associated PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache MUST be based on an OLAP connection (\[ISO/IEC29500-1:2016\] section 18.13.5). The **slicerData** attribute of the [**CT_PivotCacheDefinition**](#Section_2924f3f8a9cb4b098557fda87770d5bd) element MUST be "true". + +- If the **CT_SlicerCacheDefinition** element has a child **CT_SlicerCacheData** element with a child [**CT_TabularSlicerCache**](#Section_3ffb16d6f376403c8282bff4dc78eef8) element, the type of slicer source data is non-OLAP and the associated PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache of the slicer cache is specified by the **pivotCacheId** attribute of the **CT_TabularSlicerCache** element. The associated PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache MUST be based on a non-OLAP connection (\[ISO/IEC29500-1:2016\] section 18.13). The **slicerData** attribute of the **CT_PivotCacheDefinition** element MUST be "false". + +Multiple slicer caches can be associated with one PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache. + +If a slicer cache is associated, as specified by [Slicer Cache Relationship to PivotTable View](#Section_08ea5e044cef4f759ea4d2d99050f2d1), with one or more PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) views, and the slicer source data type is non-OLAP, the slicer cache and each associated PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view MUST be associated with the same PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache and the **slicerData** attribute of the CT_PivotCacheDefinition element MUST be "false". + +If a slicer cache is associated, as specified by Slicer Cache Relationship to PivotTable View, with one or more PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) views, and the slicer source data type is OLAP, the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache that is associated with the slicer cache and all PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCaches that are associated with the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) views MUST be based on the same OLAP connection (\[ISO/IEC29500-1:2016\] section 18.13.5) and the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCaches associated with the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) views MUST NOT be associated with any slicer cache. The **slicerData** attribute of the **CT_PivotCacheDefinition** element for each PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache associated with the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) views MUST be "false". + +##### Slicer Cache Relationship to Table + +A [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf) can be associated with a **Table** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.5.1.2). The association is specified by the following rule: + +- If the [**CT_SlicerCacheDefinition**](#Section_808f571ceac440919b4fc8882d43de49) element has a child **extLst** element with a child [**CT_TableSlicerCache**](#Section_c3629be299fe44b7970c3ea6df625cf5) element, the type of [slicer source data](#Section_953b6fbd8a1241029d6a7da6de12598a) is table and the associated **Table** (\[ISO/IEC29500-1:2016\] section 18.5.1.2) of the slicer cache is specified by the **tableId** attribute of the **CT_TableSlicerCache** element. + +Multiple slicer caches can be associated with one **Table** (\[ISO/IEC29500-1:2016\] section 18.5.1.2). + +##### Slicer Cache Relationship to PivotTable View + +A slicer cache, as specified in section [2.3.2.1](#Section_b0f3c3117ab64314af398bd3bed3bccf), can be associated with PivotTable, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, views and Charts (\[ISO/IEC29500-1:2016\] section 21.2) based on [Non-Worksheet PivotTables](#Section_6ad0de69bcbd4c239b0f5018b86289e2), by the **pivotTables** group element of the **CT_SlicerCacheDefinition** element, as specified in section [2.6.70](#Section_808f571ceac440919b4fc8882d43de49). + +If the associated PivotTable **PivotCache** of a slicer cache, as specified by the [Slicer Cache Relationship to PivotCache](#Section_2a393f8521f94a27a2b74867223f4b9a), is an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) PivotTable **PivotCache**, the slicer items, as specified in section [2.3.2.1.6](#Section_7790509116ec477581008ed67a1e7e3f), in the slicer cache are used to apply PivotTable OLAP manual filters to the PivotTable [**hierarchy**](#gt_a07fc05d-cdb0-442c-984a-dd3589b9f682) specified by the **sourceName** attribute of the **CT_SlicerCacheDefinition** element in all associated PivotTable views and Charts based on Non-Worksheet PivotTables, of the slicer cache. The [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) slicer items in the slicer cache are converted into selected PivotTable items in the PivotTable OLAP manual filters by the application to apply the filter state of the slicer cache to the associated PivotTable views. + +If the associated PivotTable **PivotCache** of a slicer cache, as specified by Slicer Cache Relationship to PivotCache, is a non-OLAP PivotTable **PivotCache**, the PivotTable **PivotCache** of the PivotTable views and the PivotTable **PivotCache** of the slicer cache MUST be the same. + +When an OLAP PivotTable view is associated with an OLAP slicer cache, there MUST NOT be more than one slicer cache for each [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c). If the slicer cache is associated with at least one Chart based on Non-Worksheet PivotTable then the slicer cache MUST be OLAP sourced. + +If the associated PivotTable **PivotCache** of a slicer cache, as specified by Slicer Cache Relationship to PivotCache, is a non-OLAP PivotTable **PivotCache**, the slicer items in the slicer cache are used to apply PivotTable non-OLAP manual filters to the **PivotTable** [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) specified by the **sourceName** attribute of the **CT_SlicerCacheDefinition** element in all associated PivotTable views of the slicer cache. The selected slicer items in the slicer cache are converted into selected PivotTable items in the PivotTable non-OLAP manual filters by the application to apply the filter state of the slicer cache to the associated PivotTable views. See the PivotTable items in \[ISO/IEC29500-1:2016\] section 18.10 for more details. + +##### Slicer Cache Relationship to Table column + +A slicer cache, as specified in section [2.3.2.1](#Section_b0f3c3117ab64314af398bd3bed3bccf), can be associated with [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) in a **Table**, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.5.1.2. Associated column is specified by the **column** attribute of the [**CT_TableSlicerCache**](#Section_c3629be299fe44b7970c3ea6df625cf5) element. + +##### Slicer Items + +Slicer items in a [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf) represent distinct values in a [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) of the [slicer source data](#Section_953b6fbd8a1241029d6a7da6de12598a). In the case of [slicers](#Section_6c8a1b950c1842adbe5094771b2732f4) based on [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) slicer source data, the slicer cache is based on an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) and slicer items represent [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) within levels of that OLAP hierarchy. + +For slicers associated with PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) views, each slicer item specifies whether slicer source data exists for that slicer item. For more information, see [Slicer Cross Filtering](#Section_ae98d186e6a9495981f5fd9359cdc6b3). + +Each slicer item also specifies the item selection state, used for filtering, and can specify additional properties. For more information see [Non-OLAP Slicer Items](#Section_a7ffe1389cc14e5ea0dba1ca7674a304) and [OLAP Slicer Items](#Section_ac62b47c91274f09b816e14a6909a1dc). + +###### Non-OLAP Slicer Items + +The slicer items of a non–[**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) slicer are specified by an ordered sequence of [CT_TabularSlicerCacheItem](#Section_369b3e9cafa74792ac78c6f0ed44fd6f) elements. Each slicer item is associated with a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) cache item of the associated PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) cache [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) in the associated PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache. For more information, see [Slicer Cache Relationship to PivotCache](#Section_2a393f8521f94a27a2b74867223f4b9a). + +The associated cache field is specified by the **sourceName** attribute of the [**CT_SlicerCacheDefinition**](#Section_808f571ceac440919b4fc8882d43de49) element and MUST be equal to the **name** attribute of a **CT_CacheField** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element in the collection of PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) cache fields ( \[ISO/IEC29500-4:2016\] section A.2) of the associated PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache. The associated PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) cache item is specified by the **x** attribute of the **CT_TabularSlicerCacheItem** element, which contains a PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) cache item index of the associated PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) cache item in the associated PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) cache field. Two non–OLAP slicer items MUST NOT be associated with the same PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) cache item. + +The order of non–OLAP slicer items in the [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf) is specified by the **sortOrder**, **crossFilter**, and **customListSort** attributes of the [**CT_TabularSlicerCache**](#Section_3ffb16d6f376403c8282bff4dc78eef8) element. + +The **CT_TabularSlicerCacheItem** element also specifies whether the non–OLAP slicer item is selected for filtering and whether data exists in the [slicer source data](#Section_953b6fbd8a1241029d6a7da6de12598a) for it. For more information, see [Slicer Cross Filtering](#Section_ae98d186e6a9495981f5fd9359cdc6b3). + +###### OLAP Slicer Items + +A [**CT_OlapSlicerCache**](#Section_9b19292cbaf8419f83b51a04ae068174) element specifies properties of an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf), and its [**descendant**](#gt_7de6b4ca-5a0e-46fe-a50c-ab17c29487c8) elements specify OLAP slicer items. + +A [**CT_OlapSlicerCacheRanges**](#Section_c8858f0b6590487699293908061a915b) element specifies the cache for an [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) in an OLAP slicer cache. + +The cache is organized into [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cached OLAP slicer items for each OLAP level in the slicer cache. Each range is specified in a [**CT_OlapSlicerCacheRange**](#Section_e6d2f81b73e149ddb40568891772578e) element. The **startItem** attribute of the **CT_OlapSlicerCacheRange** element specifies the zero-based index of the first OLAP slicer item in this cached range in the ordered collection of all [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) that exist in the [slicer source data](#Section_953b6fbd8a1241029d6a7da6de12598a) for the associated OLAP level. The collection in the slicer source data is ordered as specified by the **sortOrder** and **crossFilter** attributes of the earlier [**CT_OlapSlicerCacheLevelData**](#Section_e3ebe2f523c445cb9e3010b78347fee1) element. + +Each cached OLAP slicer item in a range is specified by a [**CT_OlapSlicerCacheItem**](#Section_4fc8bc09769e47fdb4d9936f23b7f24d) element. + +The OLAP slicer items that are selected for filtering are specified by the [**CT_OlapSlicerCacheSelections**](#Section_79b764ff71fc415f92436e99d1957a8e) element. + +Each individual OLAP slicer item selected for filtering is specified by a [**CT_OlapSlicerCacheSelection**](#Section_853111953a7747ae9a0210e7495e817a) element. + +##### Slicer Cross Filtering + +Cross filtering is an application behavior that allows one slicer to reflect the results of filtering by another. This behavior exposes whether data exists in the [slicer source data](#Section_953b6fbd8a1241029d6a7da6de12598a) for each [slicer item](#Section_7790509116ec477581008ed67a1e7e3f) when the slicer source data is filtered by the selected slicer items of all associated [slicer caches](#Section_b0f3c3117ab64314af398bd3bed3bccf) of a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) view, as specified by [Slicer Cache Relationship to PivotTable View](#Section_08ea5e044cef4f759ea4d2d99050f2d1), and all PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) manual filters in the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view. + +If the type of slicer source data is [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f), the existence of data, after filtering, for a slicer item is specified by the **nd** attribute of the [**CT_OlapSlicerCacheItem**](#Section_4fc8bc09769e47fdb4d9936f23b7f24d) element. If the type of slicer source data is non-OLAP, the existence of data for a slicer item is specified by the **nd** attribute of the [**CT_TabularSlicerCacheItem**](#Section_369b3e9cafa74792ac78c6f0ed44fd6f) element. + +If the type of slicer source data is non-OLAP, the **crossFilter** attribute of the [**CT_TabularSlicerCache**](#Section_3ffb16d6f376403c8282bff4dc78eef8) element specifies how the [non-OLAP slicer items](#Section_a7ffe1389cc14e5ea0dba1ca7674a304) that have no data appear. + +If the type of slicer source data is OLAP, the **crossFilter** attribute of the [**CT_OlapSlicerCacheLevelData**](#Section_e3ebe2f523c445cb9e3010b78347fee1) element specifies how the [OLAP slicer items](#Section_ac62b47c91274f09b816e14a6909a1dc) that have no data are displayed for the [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) specified by the **uniqueName** attribute of the **CT_OlapSlicerCacheLevelData** element. + +#### Slicer View + +A slicer view specifies the display of a [slicer](#Section_6c8a1b950c1842adbe5094771b2732f4) on a [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). A slicer view is displayed as a list of [slicer items](#Section_7790509116ec477581008ed67a1e7e3f). The slicer view is specified by a [**CT_Slicer**](#Section_03ec9cc4ffa94646b4a88343bbe076d0) element. + +Each slicer view is associated with a [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf) as specified in [Slicer View Relationship to Slicer Cache](#Section_0522784c183d43ba9a1a5627e12ffc90). The filtering state of slicer items displayed in the slicer view is specified by the associated slicer cache. + +Each slicer view is associated with a drawing ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 20.5), contained in the Drawings part (\[ISO/IEC29500-1:2016\] section 12.3.8). The associated drawing (\[ISO/IEC29500-1:2016\] section 20.5) contains a [**CT_Slicer**](#Section_6f674009241d4a269f10ff99047aef96) element that has a **name** attribute that matches the **name** attribute of the **CT_Slicer** element that specifies the slicer view. + +##### Slicer View Relationship to Slicer Cache + +Each [slicer view](#Section_69c0e0f9d0144bd59f2d2f554c715083) is associated with a [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). The slicer view is associated with a slicer cache through the **name** attribute of the [**CT_SlicerCacheDefinition**](#Section_808f571ceac440919b4fc8882d43de49) element in the slicer cache that matches the **cache** attribute of the [**CT_Slicer**](#Section_03ec9cc4ffa94646b4a88343bbe076d0) element that specifies this slicer view. + +If a slicer view is associated with an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) slicer cache, the slicer view also has an associated [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168), specified by the **level** attribute of the **CT_Slicer** element. In this case, the slicer view displays [OLAP Slicer Items](#Section_ac62b47c91274f09b816e14a6909a1dc) of that OLAP level. + +There can be multiple slicer views associated with a single slicer cache. There are two main reasons for this: + +- For a user-defined [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) with several OLAP levels—for example, a Geography OLAP hierarchy with Country, State, and City OLAP levels —each slicer view is associated with a single OLAP level, providing a mechanism for filtering different OLAP levels of the OLAP hierarchy. + +- Multiple slicer views associated with either the same slicer cache (for a non-OLAP slicer cache) or the same OLAP level (for an OLAP slicer cache) provide a mechanism for displaying the filter state in more than one location in the workbook. + +#### Slicers and Cube Functions + +Each [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf) has a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) associated with it as specified by the **name** attribute of the [**CT_SlicerCacheDefinition**](#Section_808f571ceac440919b4fc8882d43de49) element. + +The value of the **CT_DefinedName** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.5) element specifying a defined name associated with a slicer cache MUST be \#N/A. + +If the [slicer source data](#Section_953b6fbd8a1241029d6a7da6de12598a) type of a slicer cache is [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f), [**cube functions**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3) can use the defined name of the slicer cache as a parameter to refer to the selection state of the slicer cache. + +#### Slicer Styles + +Slicer styles specify the formatting to apply to visual components of [slicer views](#Section_69c0e0f9d0144bd59f2d2f554c715083). The **style** attribute of the [**CT_Slicer**](#Section_03ec9cc4ffa94646b4a88343bbe076d0) element specifies the slicer style to be applied. A slicer style can be either built-in or user-defined. Built-in slicer styles are specified in the **CT_Slicer** element. User-defined slicer styles are specified in the [**CT_SlicerStyles**](#Section_96cced63cce742b3af304168cc322c29) element. + +A slicer style is an extension of a table style ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8) with additional table style (\[ISO/IEC29500-1:2016\] section 18.8) elements specific to the formatting of slicer views. A user-defined slicer style is specified by a [**CT_SlicerStyle**](#Section_f58e45aaf570456cb08710b48fce4878) element and the table style (\[ISO/IEC29500-1:2016\] section 18.8) it references. + +A user-defined slicer style consists of the table style (\[ISO/IEC29500-1:2016\] section 18.8) elements from the referenced table style (\[ISO/IEC29500-1:2016\] section 18.8) and table style (\[ISO/IEC29500-1:2016\] section 18.8) elements specified by a group of [**CT_SlicerStyleElement**](#Section_b005a2aa3157442fbec6bfe0186e1359) elements. + +The **slicerStyleElements** element of a **CT_SlicerStyle** element specifies the slicer-style-specific table style (\[ISO/IEC29500-1:2016\] section 18.8) elements of the slicer style. The **name** attribute of the **CT_SlicerStyle** element references the user-defined table style (\[ISO/IEC29500-1:2016\] section 18.8) that specifies the non-slicer-style-specific table style (\[ISO/IEC29500-1:2016\] section 18.8) elements of the slicer style. + +### Non-Worksheet PivotTable + +Non-Worksheet PivotTables provide a way for Charts ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 21.2) to be based on PivotTable data without having to show the data in a [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). For more information see [\[MS-ODRAWXML\]](%5bMS-ODRAWXML%5d.pdf#Section_06cff208c6e14db7bb68665135e5f0de). + +A Non-Worksheet PivotTable MUST only be referenced from [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +### PivotValues + +PivotValues specifies the collection of values that are in the PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) data area. The PivotValues contain a collection of PivotValueCells organized as a two dimensional array corresponding to the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) data area. + +For a [Non-Worksheet PivotTable](#Section_6ad0de69bcbd4c239b0f5018b86289e2) the PivotValues are specified by the **pivotTableData** element (section [2.4.63](#Section_31ad0c9368d24bc49969dc4662acfa11)). + +For PivotTables on a [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) the PivotValues are specified by the cells of the worksheet (\[ISO/IEC29500-1:2016\] section 18.3) cell table in the locations specified by the location element (\[ISO/IEC29500-1:2016\] section 18.10.1.49) of the PivotTable. + +#### PivotValueCell + +A PivotValueCell is a point in individual data unit in the data area of a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) data area. PivotValueCells contain summarized values for associated PivotTable data items. Every PivotValueCell can have two kinds of information associated with it, the [value](#Section_a66488500de04d5da55005463ea0af8e) and the [server formatting](#Section_b12204156b084aac8999ba6620eac7fe) information. + +##### Value + +The value of a [PivotValueCell](#Section_b513aa61a36146368a3f4850a3f2a588) is specified to be the number, string, error, date associated with the PivotValueCell. + +##### Server Formatting + +The server formatting of a [PivotValueCell](#Section_b513aa61a36146368a3f4850a3f2a588) specifies formatting to be applied to the PivotValueCell. + +### Timelines + +A Timeline is a mechanism for filtering data in PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) views, [**cube functions**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3) and Charts (\[ISO/IEC29500-1:2016\] section 21.2) based on [Non-Worksheet PivotTables](#Section_6ad0de69bcbd4c239b0f5018b86289e2). In the case of using OLAP [Timeline source data](#Section_bb12c489e4514e2ab62163da1e6aee6b), a Timeline is based on a key [**attribute**](#gt_108a1419-49a9-4d19-b6ca-7206aa726b3f) of an [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c). In the case of using native Timeline source data, a Timeline is based on a [**data table**](#gt_9e13d7ee-50d6-40ae-8789-29ecafe24bd4) [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972). + +A Timeline has two major parts: a [Timeline cache](#Section_8a428bc98be342fab39e8d2bb83657a2), and a [Timeline view](#Section_ca0c8a5be42e4aeab6850a236dff375e). There can be more than one Timeline view based on a single Timeline cache. + +#### Timeline Cache + +A **Timeline cache** specifies the subset of **Timeline source data** (section [2.3.5.1.1](#Section_bb12c489e4514e2ab62163da1e6aee6b)) that is cached for display in **Timeline views** (section [2.3.5.2](#Section_ca0c8a5be42e4aeab6850a236dff375e)), as well as properties related to **Timeline** filtering (section [2.3.5](#Section_92ac3f95d5bb4584882e95e4e9c443c8)). A **Timeline cache** is specified by the **CT_TimelineCacheDefinition** element (section [2.6.112](#Section_f45ff6effb624e198e8c822e3be9ef75)). + +A **Timeline cache** has an associated **PivotTable** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) **PivotCache** as specified in section [2.3.5.1.2](#Section_d49705e64e2545739b146b666a6e0bb1). + +If the **Timeline source data** is an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075), the **sourceName** [**attribute**](#gt_108a1419-49a9-4d19-b6ca-7206aa726b3f) of the **CT_TimelineCacheDefinition** element specifies the key attribute name of the associated [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c). If the **Timeline source data** is a native data source, the **sourceName** attribute of the **CT_TimelineCacheDefinition** element specifies the name of the associated [**data table**](#gt_9e13d7ee-50d6-40ae-8789-29ecafe24bd4) [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972). + +If the timeline is used to [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) **PivotTable** views, the **Timeline cache** specifies the **PivotTable** views being filtered as specified in **Timeline Cache Relationship to PivotTable View** (section [2.3.5.1.3](#Section_576e7fb823524f8aa54108c2d4ba8887)). + +##### Timeline Source Data + +The [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0) for a [Timeline](#Section_92ac3f95d5bb4584882e95e4e9c443c8) is specified by the associated PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) PivotCache as specified in [Timeline Cache Relationship to PivotCache](#Section_d49705e64e2545739b146b666a6e0bb1). + +##### Timeline Cache Relationship to PivotCache + +A [Timeline cache](#Section_8a428bc98be342fab39e8d2bb83657a2) is associated with a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) PivotCache through the **pivotCacheId** attribute of the [CT_TimelineState](#Section_aa9bf1321afa4ce9b3d2e6dc00e48fde) element. If the Timeline cache has an associated PivotTable PivotCache, the **timelineData** attribute of the [CT_TimelinePivotCacheDefinition](#Section_0d70df45e6c041f0a1c949e99d6555fa) element MUST be "true". + +Multiple Timeline caches can be associated with one PivotTable PivotCache. + +If a Timeline cache is associated, as specified by [Timeline Cache Relationship to PivotTable View](#Section_576e7fb823524f8aa54108c2d4ba8887), with one or more PivotTable views, the PivotTable PivotCache that is associated with the Timeline cache and all PivotTable PivotCaches that are associated with the PivotTable views MUST be based on the same source – an OLAP connection (\[ISO/IEC29500-1:2016\] section 18.13.5) if the [Timeline source data](#Section_bb12c489e4514e2ab62163da1e6aee6b) is [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) and a [**data table**](#gt_9e13d7ee-50d6-40ae-8789-29ecafe24bd4) if the Timeline source data is native, and the PivotTable PivotCaches associated with the PivotTable views MUST NOT be associated with any Timeline cache. The **timelineData** attribute of the CT_TimelinePivotCacheDefinition element for each PivotTable PivotCache associated with the PivotTable views MUST be "false". + +##### Timeline Cache Relationship to PivotTable View + +A [Timeline cache](#Section_8a428bc98be342fab39e8d2bb83657a2) can be associated with PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) views and Charts **(**\[ISO/IEC29500-1:2016\] section 21.2) based on [Non-Worksheet PivotTables](#Section_6ad0de69bcbd4c239b0f5018b86289e2), as specified by the **pivotTables** group element of the [CT_TimelineCacheDefinition](#Section_f45ff6effb624e198e8c822e3be9ef75) element. + +The [Timeline State](#Section_5ffb2144d8674acfac8e142cebc4d238) of the Timeline cache is used to apply the PivotTable date filter to the PivotTable [**hierarchy**](#gt_a07fc05d-cdb0-442c-984a-dd3589b9f682) which belongs to the same [**dimension**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c) as the hierarchy associated with the **sourceName** attribute of the [CT_TimelineState](#Section_aa9bf1321afa4ce9b3d2e6dc00e48fde) element, in all associated PivotTable views and Charts based on Non-Worksheet PivotTables of the Timeline cache. The [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595) date range in the Timeline cache is converted into selected PivotTable items in the PivotTable date filters by the application to apply the filter state of the Timeline cache to the associated PivotTable views and Charts based on Non-Worksheet PivotTables. + +When an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) PivotTable view is associated with an OLAP Timeline cache, there MUST NOT be more than one Timeline cache for each [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c). If the Timeline cache has at least one Chart based on Non-Worksheet PivotTable, then the Timeline cache MUST be OLAP sourced. When a native PivotTable view is associated with a native Timeline cache, there MUST NOT be more than one Timeline cache for each [**data table**](#gt_9e13d7ee-50d6-40ae-8789-29ecafe24bd4) [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972). + +##### Timeline State + +**Timeline state** specifies the information used for display in [Timeline view](#Section_ca0c8a5be42e4aeab6850a236dff375e). The **Timeline state** contains two elements, selection and bounds, of type [CT_TimelineRange](#Section_2d33e56b5e624cf18b6b63221b99c64c). The selection element specifies the start and end dates of the selection in the Timeline and is used for filtering data in PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) views and [**cube functions**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3). The bounds element specifies the minimum and maximum dates that can be displayed by the Timeline view. + +#### Timeline View + +A Timeline view specifies the display of a [Timeline](#Section_6c8a1b950c1842adbe5094771b2732f4) (section [2.1.8](#Section_bde74e4196034a13989bd778c33b941d)) on a [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). The Timeline view is specified by a [CT_Timeline](#Section_0d578770103b4d7489206636997b6424) element. + +Each Timeline view is associated with a [Timeline cache](#Section_8a428bc98be342fab39e8d2bb83657a2) as specified in [Timeline View Relationship to Timeline Cache](#Section_1eba8e17801c4b93ace688b07be59e04). The filtering state of Timeline displayed in the Timeline view is specified by the associated Timeline cache. + +Each Timeline view is associated with a drawing ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 20.5), contained in the Drawings part (\[ISO/IEC29500-1:2016\] section 12.3.8). + +##### Timeline View Relationship to Timeline Cache + +Each [Timeline view](#Section_ca0c8a5be42e4aeab6850a236dff375e) is associated with a [Timeline cache](#Section_8a428bc98be342fab39e8d2bb83657a2). The Timeline view is associated with Timeline cache through the **name** attribute of the [CT_TimelineCacheDefinition](#Section_f45ff6effb624e198e8c822e3be9ef75) element in the Timeline cache that matches the **cache** attribute of the [CT_Timeline](#Section_0d578770103b4d7489206636997b6424) element that specifies this Timeline view. + +There can be multiple Timeline views associated with a single Timeline cache. The main reason for this is that multiple Timeline views associated with the same Timeline cache provide a mechanism for displaying the filter state in more than one location in the workbook. + +#### Timelines and Cube Functions + +Each [Timeline cache](#Section_8a428bc98be342fab39e8d2bb83657a2) has a [**defined name**](#gt_5bb97b28-4adc-48ec-b544-02542753a933) associated with it as specified by the **name** attribute of the [CT_TimelineCacheDefinition](#Section_f45ff6effb624e198e8c822e3be9ef75) element. + +The value of the **CT_DefinedName** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.5) element specifying a defined name associated with a Timeline Cache MUST be \#N/A. + +If the [Timeline source data](#Section_bb12c489e4514e2ab62163da1e6aee6b) type of a Timeline cache is [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f), [**cube functions**](#gt_02658bae-45d5-4aad-be23-d35b9d440af3) can use the defined name of the Timeline cache as a parameter to refer to the selection state of the Timeline cache. + +#### Timeline Styles + +Timeline styles specify the formatting to apply to visual components of [Timeline views](#Section_ca0c8a5be42e4aeab6850a236dff375e). The **style** attribute of the [CT_Timeline](#Section_0d578770103b4d7489206636997b6424) element specifies the Timeline style to be applied. A Timeline style can be either built-in or user-defined. Built-in Timeline styles are specified in the CT_Timeline element. User-defined Timeline styles are specified in the [CT_TimelineStyles](#Section_ca8bb0ae143a4747b78751044f8f67cf) element. + +A Timeline style is an extension of a table style ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8) with additional table style elements specific to the formatting of Timeline views. A user-defined Timeline style is specified by a [CT_TimelineStyle](#Section_8c0bb52ea9234213abcb98e028d21ea6) element and the table style it references. + +A user-defined Timeline style consists of the table style elements from the referenced table style and table style elements specified by a group of [CT_TimelineStyleElement](#Section_79d1e43b5b1a49e1957c50b49ff9a2e8) elements. + +The **TimelineStyleElements** element of a CT_TimelineStyle element specifies the Timeline-style-specific table style elements of the Timeline style. The **name** attribute of the CT_TimelineStyle element references the user-defined table style that specifies the Timeline-style-specific table style elements of the Timeline style. + +### Rich Data + +Rich Data is an extensible mechanism to store compound data objects and their properties in a workbook. + +#### Rich Values + +Each rich value consists of three components, [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100), [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f), and an optional [**rich value fallback**](#gt_a90d0ec0-088b-4f60-a153-198666294d07). + +The rich value type is indicated by a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)). All type names, specified by the **t** attribute, that begin with an underscore symbol MAY have restrictions on required key value pairs (KVP) and other defined behavior. + +The set of key value pairs (KVP) is defined in **CT_RichValue** (section [2.6.175](#Section_b8d7927a79b44f2cb76b3a6e9cd7ad40)) and **CT_RichValueStructure** (section 2.6.180). + +The rich value fallback is optionally defined in **CT_RichValueFallback** (section [2.6.178](#Section_56b98662f6e04e7886497ec216b10680)) and stands in place of the rich value for some features. + +While there are restrictions on required key value pairs (KVP) for some rich value types (see the sub-sections of this section for more details), additional key value pairs (KVP) are allowed. + +##### Array Type + +The [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for a [**rich array**](#gt_4b9137fd-391c-4d11-9488-c5d535d68feb). + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_array" and MUST have the following [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "array" | a | An index to a **CT_ArrayValue** (section [2.6.159](#Section_1e7ed3935fe346219fb8328461535262)). This is a zero-based index. | + +This rich value type has the following [**rich value key flag**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2) definitions for any other key value pairs (KVP). These rich value key flag definitions do not apply to the [**rich value keys**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) listed above. See section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257) for more details. + +| Flag | Default Value  | +|--------------------|----------------| +| ShowInCardView | True | +| ShowInDotNotation | True | +| ShowInAutoComplete | True | + +##### Entity Type + +The [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for an entity represents a set of [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f). + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_entity". + +##### Error Types + +The [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for errors is an extension of [**cell error values**](#gt_693c43e3-0b84-4343-b837-2689ce439ddd). This type represents a modern error in the file, which enables the storage of additional descriptive properties about the error. + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_error" and MUST have the following [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "errorType" | i | Integer, see following sub-sections for more information on specific errors. | + +This rich value type has the additional optional key value pair (KVP): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "subType" | i | Integer, used internally to differentiate [**help topic identifiers**](#gt_bb52365c-d923-4f0a-ae73-707c31d99704). | + +###### Blocked Error Type + +A Blocked error is a subset of the [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for errors (section [2.3.6.1.3](#Section_1d44a793c90a47da894308802dfad1fd)). + +A Blocked error will show as \#BLOCKED!. These errors indicate that the connection to the [**service**](#gt_2dc07ca2-2b40-437e-a5ec-ed28ebfb116a) was blocked. + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_error" and MUST have the following [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----------------------|----------------------|----------| +| "errorType"  | i | 10 | + +###### Busy Error Types + +A Busy error is a subset of the [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for errors (section [2.3.6.1.3](#Section_1d44a793c90a47da894308802dfad1fd)). + +A Busy error will show as \#BUSY!. These errors indicate that we are waiting on data from the service. + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_error" and MUST have one of the following sets of [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----------------------|----------------------|----------| +| "errorType"  | i | 14 | + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "errorType"  | i | 17 | +| "targetValue" | r | An index to a **rich value type** that is waiting on data. | + +###### Calc Error Type + +A Calc error is a subset of the [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for errors (section [2.3.6.1.3](#Section_1d44a793c90a47da894308802dfad1fd)). + +A Calc error will show as \#CALC!. These errors indicate a scenario currently unsupported by the calculation engine. + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_error" and MUST have the following [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----------------------|----------------------|----------| +| "errorType"  | i | 13 | + +###### Connect Error Type + +A Connect error is a subset of the [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for errors (section [2.3.6.1.3](#Section_1d44a793c90a47da894308802dfad1fd)). + +A Connect error will show as \#CONNECT!. These errors indicate that an attempt to connect to the [**service**](#gt_2dc07ca2-2b40-437e-a5ec-ed28ebfb116a) has failed. + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_error" and MUST have the following [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----------------------|----------------------|----------| +| "errorType"  | i | 9 | + +###### Name Error Type + +A Name error is a subset of the [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for errors (section [2.3.6.1.3](#Section_1d44a793c90a47da894308802dfad1fd)). + +A Name error will show as \#NAME?. These errors indicate that that a [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) contained unrecognized text. + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_error" and MUST have the following [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----------------------|----------------------|----------| +| "errorType"  | i | 4 | + +###### Field Error Type + +A Field error is a subset of the [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for errors (section [2.3.6.1.3](#Section_1d44a793c90a47da894308802dfad1fd)). + +A Field error will show as \#FIELD!. These errors indicate that a [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) was not found. + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_error" and MUST have the following [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "errorType"  | i | 12 | +| "field" | s | A string representing the name of the rich value key that could not be found. | + +###### Spill Error Type + +A Spill error is a subset of the [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for errors (section [2.3.6.1.3](#Section_1d44a793c90a47da894308802dfad1fd)). + +A Spill error will show as \#SPILL!. These errors indicate that a [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) result cannot be shown due to non-empty [**adjacent cells**](#gt_5250c3de-f4ee-4098-9b90-9dbc1c5087e8). + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_error" and MUST have the following [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "errorType"  | i | 8 | +| “colOffset” | i | An integer representing the count of additional columns in the result. | +| “rwOffset” | i | An integer representing the count of additional of rows in the result. | + +###### Unknown Error Type + +An Unknown error is a subset of the [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for errors (section [2.3.6.1.3](#Section_1d44a793c90a47da894308802dfad1fd)). + +An Unknown error will show as \#UNKNOWN!. These errors indicate a [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) with an unknown rich value type. + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_error" and MUST have the following [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----------------------|----------------------|----------| +| "errorType" | i | 11 | + +###### TimeOut Error Type + +A TimeOut error is a subset of the [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for errors (section [2.3.6.1.3](#Section_1d44a793c90a47da894308802dfad1fd)). + +A TimeOut error will show as \#TIMEOUT!. These errors indicate that this formula exceeded the maximum allotted execution time. + +This rich value type is identified by having a CT_RichValueStructure (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of “\_error” and MUST have the following [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----------------------|----------------------|----------| +| "errorType" | i | 19 | + +###### External Error Type + +An External error is a subset of the [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for errors (section [2.3.6.1.3](#Section_1d44a793c90a47da894308802dfad1fd)). + +An External error indicates that the [**external code service**](#gt_9a3bc1c7-ad12-4371-85b6-78656d97437a), this formula depended on, returned an error. The error shows differently depending on the programming language of the service (for example, \#PYTHON! for the Python external code service). + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_error" and MUST have the following [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----------------------|----------------------|----------| +| "errorType" | i | 18 | + +##### Formatted Number Type + +The [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for formatted numbers. The number is stored as the fallback in **CT_RichValueFallback** (section [2.6.178](#Section_56b98662f6e04e7886497ec216b10680)). + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_formattednumber" and MUST have the following [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "\_Format" | spb | An index to a [**supporting property bag**](#gt_048a0082-4ff4-4807-8300-69ccc781c098). For more information about \_Format see section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257). | + +##### Hyperlink Type + +The [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for a hyperlink contains a hyperlink and optional display text. + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_hyperlink" and MUST have the following [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "Address" | s | String representation of the hyperlink | + +This rich value type has the additional optional key value pair (KVP): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "Text" | s | String representation of the display text associated with the hyperlink | + +This rich value type has the following [**rich value key flag**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2) definitions for any other key value pairs (KVP). These rich value key flag definitions do not apply to the [**rich value keys**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) listed above. See section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257) for more details. + +| Flag | Default Value  | +|--------------------|----------------| +| ShowInCardView | False | +| ShowInDotNotation | False | +| ShowInAutoComplete | False | + +##### ImageUrl Type + +The [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for an ImageUrl represents information for a URL to an image and associated optional properties. + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_imageurl" and MUST have the following [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----------------------|----------------------|----------------------------------| +| "Address" | s | String representation of the Url | + +This rich value type has the additional optional key value pairs (KVP): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "Attribution Size" | i | Integer value of the minimum size in pixels that requires the attribution to be rendered | +| "Attribution" | r | Index to a nested SourceAttribution rich value type (section [2.3.6.1.9](#Section_ae79563bb509413aaafd98e5b0dd8e67)) | +| "Text" | s | String representation of the alt text associated with the image | +| "More Images Address" | s | String representation of the Url for more images | +| "ComputedImage" | b | Boolean value that when true indicates the image can be generated on demand. | + +This rich value type has the following [**rich value key flag**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2) definitions for any other key value pairs (KVP). These rich value key flag definitions do not apply to the [**rich value keys**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) listed above. See section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257) for more information. + +| Flag | Default Value | +|--------------------|---------------| +| ShowInCardView | True | +| ShowInDotNotation | True | +| ShowInAutoComplete | True | + +##### Linked Entity Types + +These types represent [**service**](#gt_2dc07ca2-2b40-437e-a5ec-ed28ebfb116a) connected [**rich value types**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100). + +###### Linked Entity and Linked Entity Core Types + +All Linked Entities MUST contain a Linked Entity Core Value, which represents the information received from the [**service**](#gt_2dc07ca2-2b40-437e-a5ec-ed28ebfb116a). + +The Linked Entity [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_linkedentity" and MUST have the following [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "%cvi" | r | Integer that identifies the index to the nested Linked Entity Core Value | + +Linked Entity Core rich value type is identified by having a **CT_RichValueStructure** (section 2.6.180) **t** attribute of "\_linkedentitycore" and MUST have the following key value pairs (KVP): + +| CT_Key "n" attribute  | CT_Key "t" attribute  | CT_Value  | +|----|----|----| +| "%EntityCulture" | s | String value for the service culture | +| "%EntityId" | s | String value that when combined with the "%EntityServiceId" and "%EntityCulture" creates a unique identifier | +| "%EntityServiceId" | i | Integer value that is an index to the service domain | + +Linked Entity Core rich value type has the additional optional key value pairs (KVP): + +| CT_Key "n" attribute  | CT_Key "t" attribute  | CT_Value  | +|----|----|----| +| "%DataProviderExternalLink" | s | String value that is provided by and targets the service. | +| "%DataProviderExternalLinkLogo" | s | String value that is a [**URL**](#gt_433a4fb7-ef84-46b0-ab65-905f5e3a80b1) that points to a logo that identifies the service. | +| "%EntitySubDomainId" | i | Integer value that is an index to the service sub-domain. | +| "%IsRefreshable" | b | Boolean value that when true indicates the rich value is connected and can be refreshed to obtain the latest data. | +| "%ProviderInfo" | s | String value indicating the service provider. | +| "VDPID/VSID" | s | String value used by the service. | + +This rich value type has the following [**rich value key flag**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2) definitions for any other key value pairs (KVP). These rich value key flag definitions do not apply to the [**rich value keys**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) listed above. See section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257) for more information. + +| Flag | Default Value | +|--------------------|---------------| +| ShowInCardView | True | +| ShowInDotNotation | True | +| ShowInAutoComplete | True | + +###### Linked Entity 2 and Linked Entity 2 Core Types + +Linked Entity 2s MAY reference a Linked Entity 2 Core Value, which represents the information received from the [**service**](#gt_2dc07ca2-2b40-437e-a5ec-ed28ebfb116a). + +The Linked Entity 2 [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_linkedentity2" and MUST have the following [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "%EntityCulture" | s | String value for the service culture. | +| "%EntityId" | s | String value that when combined with the %EntityServiceId and %EntityCulture values will create a unique identifier for the service. | +| "%EntityServiceId" | i | Integer value that is an index to the service domain. | + +Linked Entity 2 rich value type has the additional optional key value pair (KVP): + +| CT_Key "n" attribute  | CT_Key "t" attribute  | CT_Value  | +|----|----|----| +| "%cvi" | r | Integer that identifies the index to the nested Linked Entity 2 Core Value. | + +Linked Entity 2 Core rich value type is identified by having a **CT_RichValueStructure** (section 2.6.180) **t** attribute of "\_linkedentity2core" and MUST have the following key value pairs (KVP): + +| CT_Key "n" attribute  | CT_Key "t" attribute  | CT_Value  | +|----|----|----| +| "%EntityCulture" | s | String value for the service culture | +| "%EntityId" | s | String value that when combined with the "%EntityServiceId" and "%EntityCulture" creates a unique identifier | +| "%EntityServiceId" | i | Integer value that is an index to the service domain | + +Linked Entity 2 Core rich value type has the additional optional key value pair (KVP): + +| CT_Key "n" attribute  | CT_Key "t" attribute  | CT_Value  | +|----|----|----| +| "%IsRefreshable"  | b  | Boolean value that when true indicates the rich value is connected and can be refreshed to obtain the latest data.  | +| "VDPID/VSID" | s  | String value used by the service.  | +| “%EntityDomainIdString" | s  | Optional string value used to supplement the %EntityServiceId integer value.  | +| “%DataRetrievedTime" | n  | Optional number value that is the date/time when the linked entity data was retrieved from the [**data provider**](#gt_33fa4cdc-ae58-4a6c-8111-31377e1d292e). | +| “%InfoToolTipLabelNames" | a  | Optional array of string values that are expected to have optional corresponding values in the %InfoToolTiplabelValues. | +| “%InfoToolTipLabelValues" | a  | Optional array of string values that are expected to correspond to names in %InfoToolTipLabelnames. | +| “%InfoToolTipLabelValuesType" | a  | Optional array of values for time zone localization. | +| “%ClassificationId" | s  | Optional string value that is used to apply a Windows Information Protection (WIP) policy.  | +| “%DataProviderString" | s  | Optional string value that identifies the data provider.  | +| "%OutdatedReason" | i | Optional integer that indicates why the rich value is outdated. | + +These rich value types has the following [**rich value key flag**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2) definitions for any other key value pairs (KVP). These rich value key flag definitions do not apply to the [**rich value keys**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) listed above. See section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257) for more information. + +| Flag | Default Value | +|--------------------|---------------| +| ShowInCardView | True | +| ShowInDotNotation | True | +| ShowInAutoComplete | True | + +##### Local Image Type + +The [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for a local image represents information for a stored image and associated optional properties. + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_localImage" and MUST have the following [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "\_rvRel:LocalImageIdentifier" | i | An integer for a zero-based index. This index MUST reference a **CT_RichValueRelRelationship** (section [2.6.241](#Section_e8999a72164a40c7becb3f8cbf2c9090)). | + +This rich value type has the additional optional key value pairs (KVP): + + +++++ + + + + + + + + + + + + + + + + + + + +
CT_Key "n" attributeCT_Key "t" attributeCT_Value
"CalcOrigin"i

Integer value that indicates how the rich value was created.

+

CalcOrigin represents how a RichValue object was created for AccessibilityChecker.

+

Below is the complete list of CalcOrigin values along with explanations for the most common values.

+

enum class CalcOrigin: int

+

{

+

  None = 0,

+

  Formula, // RichValue created directly by formula (ex, =IMAGE)

+

  ComplexFormula,

+

  DotNotation,

+

  Reference,

+

  Standalone, // Standalone RichValue directly stored in a cell without formula dependency (copy/paste as value or LocalImageValue)

+

  StandaloneDecorative, // Standalone RichValue created from the alt text pane after selecting "decorative"

+

  Nested,

+

  JSApi,

+

  PythonResult,

+

  Max = PythonResult

+

};

+

Implementors should not be modifying this property directly, except for initial creation. The values will be adjusted as the in cell images are modified.

"Text"sString representation of the alt text associated with the image.
+ +##### SourceAttribution Type + +The [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for SourceAttribution represents information about data source and license. + +This rich value type is identified by having a a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_sourceattribution" and MUST have the following [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "Source" | s or r | String or a nested Hyperlink rich value type (section [2.3.6.1.5](#Section_9fa5a49bfeab48999d13fbf33e02848b)) | + +This rich value type has the additional optional key value pairs (KVP): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "License" | s or r | String or a nested Hyperlink rich value type (section 2.3.6.1.5) | + +This rich value type has the following [**rich value key flag**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2) definitions for any other key value pairs (KVP). These rich value key flag definitions do not apply to the [**rich value keys**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) listed above. See section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257) for more information. + +| Flag | Default Value | +|--------------------|---------------| +| ShowInCardView | True | +| ShowInDotNotation | True | +| ShowInAutoComplete | True | + +##### Stock History Cache Type + +The [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for a stock history cache represents an optional cache of the historical stock data from the [**service**](#gt_2dc07ca2-2b40-437e-a5ec-ed28ebfb116a). This rich value might not be persisted when saved. This cache exists for performance reasons only. + +This rich value type is identified by having a a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_stockhistorycache". + +##### Web Image Type + +The [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for a web image represents information for an image from a URL and associated optional properties. + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_webimage" and MUST have the following [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key "n" attribute | CT_Key "t" attribute | CT_Value | +|----|----|----| +| "WebImageIdentifier" | i | An integer for a zero-based index. This index MUST reference a **CT_WebImageSupportingRichData** (section [2.6.217](#Section_0bbd3612e1b241ef9ce7241d4a969b57)). | + +This rich value type has the additional optional key value pairs (KVP): + + +++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CT_Key "n" attributeCT_Key "t" attributeCT_Value
"Attribution"spbAn index to a supporting property bag containing information about data source and license.
"Text"sString representation of the alt text associated with the image.
"ComputedImage"bBoolean value that when true indicates the image can be generated on demand.
"ImageSizing"i

Integer value that indicates the dimension modes of the image. There are 4 supported values: 0, 1, 2, 3.

+

At 0, image fits to the cell and maintains its aspect ratio.

+

At 1, image fits to the cell and ignore its aspect ratio.

+

At 2, image maintains its original size and MAY exceed the cell boundary.

+

At 3, image size is customized by "ImageHeight" and "ImageWidth".

"ImageHeight"dReal number representation of the image height in pixels. This property SHOULD only be present when "ImageSizing" is set to 3.
"ImageWidth"dReal number representation of the image width in pixels. This property SHOULD only be present when "ImageSizing" is set to 3
"CalcOrigin"i

Integer value that indicates how the rich value was created.

+

CalcOrigin represents how a RichValue object was created for AccessibilityChecker.

+

Below is the complete list of CalcOrigin values along with explanations for the most common values.

+

enum class CalcOrigin: int

+

{

+

  None = 0,

+

  Formula, // RichValue created directly by formula (ex, =IMAGE)

+

  ComplexFormula,

+

  DotNotation,

+

  Reference,

+

  Standalone, // Standalone RichValue directly stored in a cell without formula dependency (copy/paste as value or LocalImageValue)

+

  StandaloneDecorative, // Standalone RichValue created from the alt text pane after selecting "decorative"

+

  Nested,

+

  JSApi,

+

  PythonResult,

+

  Max = PythonResult

+

};

+

Implementors should not be modifying this property directly, except for initial creation. The values will be adjusted as the in cell images are modified.

+ +This rich value type has the following [**rich value key flag**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2) definitions for any other key value pairs (KVP). These rich value key flag definitions do not apply to the [**rich value keys**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) listed above. See section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257) for more information. + +| Flag | Default Value | +|--------------------|---------------| +| ShowInCardView | True | +| ShowInDotNotation | True | +| ShowInAutoComplete | True | + +##### ExternalCodeServiceObject Type + +The [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for an ExternalCodeServiceObject represents information about a Python object. + +The rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_python" and MUST have the following [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key “n” attribute | CT_Key “t” attribute | CT_Value | +|----|----|----| +| "Python_str" | s | String representation of the Python object | +| "Python_type" | s | Type of the Python object | +| "Python_typeName" | s | Class name of the Python object | + +The rich value type has the additional optional key value pairs (KVP): + +| CT_Key “n” attribute | CT_Key “t” attribute | CT_Value | +|----|----|----| +| "preview" | r | Index to the [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) used for preview of Python object | +| "basicValue" | s or n or b or i | Value of fallback for rich value | + +This rich value type has the following [**rich value key flag**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2) definitions for any other key value pairs (KVP). These rich value key flag definitions do not apply to the [**rich value keys**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) listed above. See section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257) for more information. + +| Flag | Default Value | +|--------------------|---------------| +| ShowInCardView | True | +| ShowInDotNotation | True | +| ShowInAutoComplete | True | + +##### Primitive with Metadata Type + +The [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for a Primitive with Metadata represents a set of key value pairs (KVP) associated with a primitive value. The primitive value is stored as the fallback in **CT_RichValueFallback** (section [2.6.178](#Section_56b98662f6e04e7886497ec216b10680)). + +This rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_primitivewithmetadata". + +This rich value type has the following [**rich value key flag**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2) definitions for any other [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f). These rich value key flag definitions do not apply to the [**rich value keys**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) listed above. See section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257) for more details. + +| Flag | Default Value  | +|--------------------|----------------| +| ShowInCardView | True | +| ShowInDotNotation | True | +| ShowInAutoComplete | True | + +##### JavaScript Custom Function Reference Type + +The [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) for a JavaScript Custom Function Reference represents a reference to a JavaScript custom function of the [**add-in**](#gt_a3be101e-9d37-484a-a5e6-b70d559146c6). + +The rich value type is identified by having a **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute of "\_javascriptcustomfunctionreference" and MUST have the following [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f): + +| CT_Key “n” attribute | CT_Key “t” attribute | CT_Value | +|----|----|----| +| "Id" | s | String value of the JavaScript custom function id | + +The rich value type has the additional optional key value pairs (KVP): + +| CT_Key “n” attribute | CT_Key “t” attribute | CT_Value | +|----|----|----| +| "Namespace" | s | String value of the JavaScript custom function namespace | + +This rich value type has the following [**rich value key flag**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2) definitions for any other key value pairs (KVP). These rich value key flag definitions do not apply to the [**rich value keys**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) listed above. See section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257) for more information. + +| Flag | Default Value | +|--------------------|---------------| +| ShowInDotNotation | True | +| ShowInAutoComplete | True | + +#### Supporting Property Bags + +Each [**supporting property bag**](#gt_048a0082-4ff4-4807-8300-69ccc781c098) is comprised of a set of [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f). + +The set of key value pairs (KVP) is defined in **CT_SupportingPropertyBag** (section [2.6.188](#Section_1e24d4a8d93f48e79370e7f79af427df)) for the values and **CT_SupportingPropertyBagStructure** (section [2.6.195](#Section_089a3ccc622a4d51ad54ced0c88f0baf)) for the keys. + +Supporting property bags can be the data portion of a key value pair (KVP) in a [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) to give extra information. + +#### Special Keys and Key Flags + +All [**rich value keys**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) that begin with a non-alphanumeric ASCII character MAY be used internally to define behavior. + +The following rich value keys define special behavior. + +| Key name | Key definitions | +|----|----| +| "\_Attribution" | This key MUST reference a [**supporting property bag**](#gt_048a0082-4ff4-4807-8300-69ccc781c098) that contains information about the source and license attribution. | +| "\_CanonicalPropertyNames" | This key MUST reference a supporting property bag that contains [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f) of strings. The [**supporting property bag key**](#gt_9b058a5b-a83d-4208-9d7d-49665db1ff97) in each pair contains a key that is [**localized**](#gt_90c6d38f-21e3-4dc5-8ead-2cbc2bad909d). The corresponding value contains a string representation of the key that is not locale-specific. | +| "\_ClassificationId" | This key references a string value used to apply a Windows Information Protection (WIP) policy. | +| "\_CRID" | Some [**rich value types**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) MAY put limitations on what type this key MUST reference. See individual rich value type descriptions (under section [2.3.6.1](#Section_8c1f2a3e2f7b4eacbaf0ef2173648b42)) for any limitations. If this key is a part of a [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) with an unknown rich value type (for more information see section [2.3.6.1.3.8](#Section_98d06bc5fa314bcc84252665aa251288)), this rich value MUST be preserved. | +| "\_Display" | This key MUST reference a supporting property bag that contains information that can be used to determine how the rich value is displayed. | +| "\_DisplayString" | This key MUST reference a string that can be shown in the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). | +| "\_Flags" | This key MUST reference a supporting property bag that contains key value pairs (KVP) containing rich value keys and supporting property bags containing associated [**rich value key flags**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2), which define behavior for the associated rich value key value pair (KVP). | +| "\_Format" | This key MUST reference a supporting property bag that is a list of indices to a **CT_RichStyle** (section [2.6.170](#Section_c803b251e3154140845ccd679b6e98ba)). The supporting property bag key of the key value pair (KVP) in the supporting property bag determines which rich value key the **CT_RichStyle** is associated with. | +| "\_Icon" | This key contains a value that describes the icon that can be used in render. | +| "\_Provider" | This key MUST reference a supporting property bag that contains information about the service provider. | +| "\_Self" | This key SHOULD NOT exist in the file and will be removed when the file is saved. When a supporting property bag references this rich value key, it indicates the supporting property bag references the rich value itself, and not a key value pair (KVP) of the rich value. | +| "\_SubLabel" | This key MUST reference a supporting property bag that contains key value pairs (KVP) containing rich value keys and supporting property bags containing strings, which define the label that can be used to describe the associated rich value key value pair (KVP). | +| "\_ViewInfo" | This key MUST reference a supporting property bag that contains information that MAY be used to customize rich value visualizations. | + +The following rich value key prefix defines special behavior. + +| Prefix name | Key definitions | +|----|----| +| "\_rvRel" | A rich value key with this prefix MUST reference a **CT_RichValueRelRelationship** (section [2.6.241](#Section_e8999a72164a40c7becb3f8cbf2c9090)). | + +The following supporting property bag key defines special behavior. + +| Key name | Key definitions | +|----|----| +| "^Order" | This supporting property bag key is associated with a [**supporting property bag array**](#gt_7b3f3c16-241f-4a7f-8677-ac555c9a45bb) of strings that SHOULD be comprised of rich value keys in the associated rich value and can be used to display the rich value key value pairs (KVP) in a different order. | + +Rich value keys with defined behavior for all rich value types are listed in **CT_RichValueGlobalType** (section [2.6.179](#Section_4b181b9033d64c35a62bceacf6681027)). + +Rich value keys with defined behavior for a particular rich value type are listed in **CT_RichValueTypes** (section [2.6.186](#Section_879bfbfb9ea742728edea144b5074696)). The rich value type can be identified by matching the **CT_RichValueType** (section [2.6.182](#Section_0a1cee9c0c744d92ad2674c3585f6e5e)) **name** attribute to the **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) **t** attribute. + +Both **CT_RichValueGlobalType** and **CT_RichValueTypes** contain **CT_RichValueType** (section 2.6.182), which defines the rich value key flags and their values for each of the reserved rich value keys. + +Rich value key flags are associated with key value pairs (KVP) and control particular behavior. Any flags that are absent are treated as having a value of false unless the rich value type has a different default for that rich value key flag. See sections under section 2.3.6.1 for specific type definitions. + +Rich value key flags are listed here: + +| Flag name | Flag definitions | +|----|----| +| ShowInCardView | False indicates that we hide this key value pair (KVP) in the default Card View | +| ShowInDotNotation | False indicates that we hide this key value pair (KVP) from [**formulas**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) and the [**object model**](#gt_91bed4f8-fc06-4d55-b040-7a84c42e4973) | +| ShowInAutoComplete | False indicates that we hide this key value pair (KVP) from [**AutoComplete**](#gt_28a56cd0-e544-405c-8d41-b95ed015c0cc), [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880), [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda), and Find | +| ExcludeFromFile | True indicates that we do not write this key value pair (KVP) into the file, it only exists in memory | +| ExcludeFromCalcComparison | True indicates that we exclude this key value pair (KVP) when comparing rich values. | + +**CT_RichValueType** information that is not recognized at runtime will be persisted unless the associated rich value type is removed. **CT_RichValueType** information that contradicts runtime expectations will be ignored and will not be persisted. + +#### Rich Styles and Properties + +[**Rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) MAY contain particular properties that are used to define the [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) for a given [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f). See **CT_RichFormatProperties** (section [2.6.167](#Section_479db4e3edd24d198984023d3a081558)) and the "\_Format" [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) (section [2.3.6.3](#Section_cb2e0fbf091f435784c51adacd405257)) for more information. + +| Property Name | Definition  | +|----|----| +| IsHeroFlag | True indicates that the related key value pair (KVP) is the hero image for the rich value. This MAY be emphasized. | +| IsTitleFlag | True indicates that the related key value pair (KVP) is the title for the rich value. This MAY be used for visualizing the rich value. | +| IsPrimaryFlag | True indicates that the related key value pair (KVP) is the primary for the rich value. This MAY be emphasized. | +| IsSecondaryFlag | True indicates that the related key value pair (KVP) is the secondary for the rich value. This MAY be emphasized. | +| IsFooterFlag | True indicates that the related key value pair (KVP) is the footer for the rich value. This MAY be used for visualizing the rich value. | +| IsCellDisplayFlag | True indicates that the related [**rich value data**](#gt_26aa395d-2e6a-4071-b25c-95e20adf8ac3) MAY be shown in the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). | + +### Threaded Comments + +Threaded comments represent a collaborative annotation system that replaces and/or works in addition to legacy comments ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.7). The [**comment threads**](#gt_502f1c43-e7e6-4c33-9120-ebafa77215e8) attached to and associated with [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in a [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) are stored separately from other cell content. A comment thread attached to a cell is comprised of a top-level [**threaded comment**](#gt_7275a968-842f-4c12-b5e6-faf2a7f249c4) and its replies, if there are any, to provide annotations, assumptions, instructions, reminders, feedback, collaborative discussion among coauthors, and so forth. A threaded comment specified by complex type **CT_ThreadedComment** (section [2.6.205](#Section_42f9b03d966242049783dbeb324a691c)) contains information about the author, [**mentions**](#gt_afcc37b0-9cff-4c5c-87cd-9db73437848b) in the comment, and its parent if it is not a top-level comment. + +#### Persons + +Information about people who have authored and/or have been mentioned in [**threaded comments**](#gt_7275a968-842f-4c12-b5e6-faf2a7f249c4) is specified by complex type **CT_Person** (section [2.6.203](#Section_6274371e7c5c46e3b661cbeb4abfe968)), and is stored separately from the comments. + +When a user creates a threaded comment, a person element of **CT_Person** (section 2.6.203) is generated for the author if it is their first threaded comment in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). To associate the author to the comment, the **id** of the person element MUST correspond to the **personId** of the **threadedComment** element specified by complex type **CT_ThreadedComment** (section [2.6.205](#Section_42f9b03d966242049783dbeb324a691c)). + +When a user creates a [**mention**](#gt_afcc37b0-9cff-4c5c-87cd-9db73437848b) within a comment, a person element of **CT_Person** is generated for the person mentioned if it's the first time the person is mentioned. The **providerId** of the person element MUST be set to "PeoplePicker". To associate the person to the mention, the **id** of the person element MUST correspond to the **mentionpersonId** of the **mention** element specified by complex type **CT_Mention** (section [2.6.202](#Section_b03ed619e3074d3e9c67b68612274128)). + +#### Mentions + +A [**mention**](#gt_afcc37b0-9cff-4c5c-87cd-9db73437848b) is a portion of the text in a [**threaded comment**](#gt_7275a968-842f-4c12-b5e6-faf2a7f249c4) associated with a person’s information. The **startIndex** and the **length** attributes of **CT_Mention** (section [2.6.202](#Section_b03ed619e3074d3e9c67b68612274128)) specify a range in the **text** element of **CT_ThreadedComment** (section [2.6.205](#Section_42f9b03d966242049783dbeb324a691c)) as the mention text. + +#### Legacy Comment Placeholders + +To integrate with legacy [**comments**](#gt_c8a897b9-522f-4b7a-8df6-40b65ac09f4d) ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.7) and aid backward compatibility, a legacy comment placeholder is created along with each top-level [**threaded comment**](#gt_7275a968-842f-4c12-b5e6-faf2a7f249c4). This legacy comment MAY contain information about threaded comment compatibilities. This comment SHOULD NOT be displayed unless the file is opened in a version that does not support threaded comments. The **uid** (\[ISO/IEC29500-1:2016\] section 18.7.3) of the comment SHOULD correspond to the **id** attribute of the associated threaded comment specified by **CT_ThreadedComment** (section [2.6.205](#Section_42f9b03d966242049783dbeb324a691c)). Additionally, the **author** of the comment MUST contain “tc={uid}”, where {uid} is the corresponding threaded comment **id.** The **ref** attribute specified in **comment**(\[ISO/IEC29500-1:2016\] section 18.7.3) SHOULD correspond to the **ref** attribute specified in **CT_ThreadedComment**. If the **ref** attributes don't match, the **ref** specified in legacy comment placeholder will be used while displaying the threaded comment. + +##### Reconciliation + +After all parts are loaded, reconciliation will be done in two steps. + +1. Enumerate all top-level [**threaded comments**](#gt_7275a968-842f-4c12-b5e6-faf2a7f249c4) in [**comment threads**](#gt_502f1c43-e7e6-4c33-9120-ebafa77215e8) in the entire [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) to adjust their location or delete them. + +- If the corresponding placeholder is at a different location, adjust the comment thread to the location of the first placeholder that corresponds to the comment. + +- If the corresponding placeholder is not found, delete the comment thread. + + 1. Enumerate all placeholders. + +- If any comment thread has more than one placeholder, copy it for each additional placeholder. Each copied threaded comment, including top-level comment and reply, is assigned a new unique identifier. + +- If a placeholder has no corresponding comment thread, remove the placeholder. + +The following table shows how comment loading is handled if changes were made in a previous version of Excel. + +| Situation | Description | Reconciliation | +|----|----|----| +| Move | Corresponding placeholder is at a different location | Change the **ref** of all the **threaded comments** in the **comment thread** to the location of the placeholder. | +| Delete | Corresponding placeholder is not found | Delete the entire **comment thread**. | +| Copy | Multiple corresponding placeholders are found | Copy the entire **comment thread** for each additional placeholder and assign a new unique id. | +| Orphan | Placeholder with no corresponding **comment thread** are found | Delete the placeholder. | + +### Named Sheet Views + +Named sheet views represent a stored collection of sort and/or filter settings for the [**AutoFilters**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) found on a specific sheet. + +A [**named sheet view**](#gt_536ae444-2479-4867-8bfa-9a5be4e9995e) is associated with [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615), and is made up of a set of [**nsvfilters**](#gt_1e495570-5c98-4781-96db-1e4ad401713a), with each nsvfilter being associated with a single AutoFilter on the worksheet. A named sheet view only stores sort and/or filter settings that are associated with an AutoFilter and does not include other content. + +#### Table Filters and Worksheet Filters + +Each [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) is described by a **CT_AutoFilter** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.2), and those can be contained within a **CT_Table** (\[ISO/IEC29500-1:2016\] section A.2) element or within a **CT_Worksheet** (\[ISO/IEC29500-1:2016\] section A.2) element. + +When **CT_AutoFilter** (\[ISO/IEC29500-1:2016\] section A.2) that describes the AutoFilter is contained within a **CT_Table** (\[ISO/IEC29500-1:2016\] section A.2) element then the AutoFilter is considered to be owned by that [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7). + +When the **CT_AutoFilter** (\[ISO/IEC29500-1:2016\] section A.2) that describes the AutoFilter is contained within a **CT_Worksheet** (\[ISO/IEC29500-1:2016\] section A.2) element then the AutoFilter is considered to be owned by that [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +#### Reconciliation + +When loading a file, each **CT_NsvFilter** (section [2.6.212](#Section_e132d9ccc7114fb3aa28e7356a791b1c)) needs to be matched with a specific [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). And beyond that each **columnFilter** and **sortRule** within the [**nsvfilter**](#gt_1e495570-5c98-4781-96db-1e4ad401713a) needs to be matched with specific columns within that AutoFilter. + +After all parts are loaded this reconciliation is done as sequence of checks in priority order. The match with the highest priority SHOULD be taken. If all checks are exhausted with no match being found the nsvfilter SHOULD be dropped. Similarly, if a specific **columnFilter** or **sortRule** element cannot match to a specific column then those elements SHOULD be dropped. + +To connect a **CT_NsvFilter** (section 2.6.212) with to a specific AutoFilter the priority sequence of checks is as follows + +1. A match exists between the **filterId** attribute on the **CT_NsvFilter** (section 2.6.212) and a **uid** (section [2.5.10](#Section_05198417f8f74ee4967859599f962c90)) attribute stored on a **CT_AutoFilter** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.2). + +2. The **tableId** attribute on the **CT_NsvFilter** (section 2.6.212) is not equal to 0 AND there is a table owned AutoFilter (as explained in section [2.3.8.1](#Section_a3349ee14144443c9cede014a9474cc1)) such that the **tableId** attribute matches the **id** attribute on that **CT_Table** (\[ISO/IEC29500-1:2016\] section A.2) + +3. The **tableId** attribute on the **CT_NsvFilter** (section 2.6.212) is 0 AND there is a worksheet owned AutoFilter (as explained in section 2.3.8.1) + +To map each **columnFilter** element within **CT_NsvFilter** (section 2.6.212) to a specific column the sequence of checks is as follows + +1. The matched AutoFilter is table owned (as explained in section section 2.3.8.1) and the **CT_Table** (\[ISO/IEC29500-1:2016\] section A.2) describing that [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) contains a **tableColumn** element which specifies **uid** (section [2.5.8](#Section_c4210a205ca94c1091e81fa359b1ce79)) attribute that matches **id** attribute on **CT_ColumnFilter** (section [2.6.209](#Section_156596a92bb54351bcd039889d4fa26f)). In this case **id** attribute on the matching **CT_TableColumn** (\[ISO/IEC29500-1:2016\] section A.2) identifies the column this **columnFilter** element applies to. + +2. The **ref** attribute on the **CT_AutoFilter** (\[ISO/IEC29500-1:2016\] section A.2) that describes the matched AutoFilter specifies a range large enough for the **colId** attribute on **CT_ColumnFilter** (section 2.6.209) to be a column within that range. In this case the **colId** identifies the column this **columnFilter** element applies to. + +To map each **sortRule** element within **CT_SortRules** (section [2.6.214](#Section_058dbac60b8b45f4af04555c14470870)) to a specific column the sequence of checks is as follows + +1. The matched AutoFilter is table owned (as explained in section section 2.3.8.1) and the **CT_Table** (\[ISO/IEC29500-1:2016\] section A.2) describing that table contains a **tableColumn** element which specifies **uid** (section 2.5.8) attribute that matches **id** attribute on **CT_SortRule** (section [2.6.213](#Section_cd611e3d7b67404d8934bd2b6e738c75)). In this case **id** attribute on the matching **CT_TableColumn** (\[ISO/IEC29500-1:2016\] section A.2) identifies the column this **sortRule** element applies to. + +2. The **ref** attribute on the **CT_AutoFilter** (\[ISO/IEC29500-1:2016\] section A.2) that describes the matched AutoFilter specifies a range large enough for the **colId** attribute on **CT\_ SortRule** (section 2.6.213) to be a column within that range. In this case the **colId** identifies the column this **sortRule** element applies to. + +### Feature Property Bag + +A [**feature property bag**](#gt_3f541c32-862c-47d2-8c55-e07e44e68bfb) described by [CT_FeaturePropertyBag](#Section_8383a4177cb14324af6399dd77ffebd5) (section 2.6.233) is comprised of a type, optional attributes, and an unbounded number of [**key value pairs (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f). + +The types of feature property bags and their required key value pairs (KVP) are specified in the sub-sections of this section. + +#### XFComplements + +This type is identified by having a **CT_FeaturePropertyBag** (section [2.6.233](#Section_8383a4177cb14324af6399dd77ffebd5)) **type** attribute of “XFComplements” and MUST contain the following **[key value pair (KVP)](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f):** + +| Value Type | Key Name “k” | Child Elements | +|----|----|----| +| **CT_FeaturePropertyBag** (section 2.6.233) **a** element of type **CT_ArrayFeatureProperty** (section [2.6.229](#Section_26b90ad3836549769c1c1c7cd62d661f)) | “MappedFeaturePropertyBags” | Value contains one or more CT_ArrayFeatureProperty (section 2.6.229) **bagId** elements that reference to [**feature property bags**](#gt_3f541c32-862c-47d2-8c55-e07e44e68bfb) of type **XFComplement** (section [2.3.9.2](#Section_a076e46cc8324ea5bc678f69a98eba7e)). | + +Each **CT_XFComplement** (section [2.6.238](#Section_09ecc2fe7df748dda30641c576c1a91f)) **i** value MUST reference the zero-based index into the value of key “MappedFeaturePropertyBags”. + +#### XFComplement + +This type is identified by having a **CT_FeaturePropertyBag** (section [2.6.233](#Section_8383a4177cb14324af6399dd77ffebd5)) **type** attribute of “XFComplement” and contains additional styles information for an **xf** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8.45). + +The XFComplement type MUST contain the following **[key value pair (KVP)](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f):** + +| Value Type | Key Name “k” | Value | +|----|----|----| +| **CT_FeaturePropertyBag** (section 2.6.233) **bagId** element of type **CT_BagFeatureProperty** (section [2.6.230](#Section_24b32f3ec1784728b4f782ab08c57e0b)) | “XFControls” | Value contains a reference to a [**feature property bag**](#gt_3f541c32-862c-47d2-8c55-e07e44e68bfb) of type **XFControls** (section [2.3.9.3](#Section_3fc90597a4e949d8bd0a896b674ed9b4)) | + +Each **XFComplement** is referenced by the values of the key “MappedFeaturePropertyBags” (section [2.3.9.1](#Section_cb97d7fc1434498c9bd3aa5fae4e677c)) by zero-based index. + +#### XFControls + +This type is identified by having a **CT_FeaturePropertyBag** (section [2.6.233](#Section_8383a4177cb14324af6399dd77ffebd5)) **type** attribute of “XFControls” and contains [**Cell Control**](#gt_cd6f4588-f225-47c1-a7a0-6ea87e4e4874) style information for an **xf** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8.45). + +A type **XFControls [feature property bag](#gt_3f541c32-862c-47d2-8c55-e07e44e68bfb)** MUST contain the following **[key value pair (KVP)](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f):** + +| Value Type | Key Name “k” | Value | +|----|----|----| +| **CT_FeaturePropertyBag** (section 2.6.233) **bagId** element of type **CT_BagFeatureProperty** (section [2.6.230](#Section_24b32f3ec1784728b4f782ab08c57e0b)) | “CellControl” | Value contains a reference to another feature property bag of type **Checkbox** (section [2.3.9.4](#Section_00b826215aa14ea8b2517b7a51242610)) | + +Each **XFControls** is referenced by the value of the key “XFControls” in an **XFComplement** (section [2.3.9.2](#Section_a076e46cc8324ea5bc678f69a98eba7e)) feature property bag. + +#### Checkbox + +This type is identified by having a **CT_FeaturePropertyBag** (section [2.6.233](#Section_8383a4177cb14324af6399dd77ffebd5)) **type** attribute of “Checkbox” and specifies a checkbox [**Cell Control**](#gt_cd6f4588-f225-47c1-a7a0-6ea87e4e4874). + +A type **Checkbox [feature property bag](#gt_3f541c32-862c-47d2-8c55-e07e44e68bfb)** MAY contain the following **[key value pair (KVP)](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f):** + + +++++ + + + + + + + + + + + + + + +
Value TypeKey Name “k”Value
CT_FeaturePropertyBag (section 2.6.233) i element of type CT_IntFeatureProperty (section 2.6.235).“default”

Value represents the default value state of the checkbox. There are 3 supported values: 0, 1, 2.

+

At 0, The value represents false. When the checkbox is inserted in a cell, a value of FALSE will be written to the cell.

+

At 1, the value represents true. When the checkbox is inserted in a cell, a value of TRUE will be written to the cell.

+

At 2, the value represents empty. When the checkbox is inserted in a cell, the cell value will be cleared.

+ +If the key “default” is absent, then it is treated as having a value of 0, representing false. + +Each **Checkbox** is referenced from the value of the key “CellControl” in an **XFControls** (section [2.3.9.3](#Section_3fc90597a4e949d8bd0a896b674ed9b4)) feature property bag. + +#### DXFComplements + +This type is identified by having a **CT_FeaturePropertyBag** (section [2.6.233](#Section_8383a4177cb14324af6399dd77ffebd5)) **type** attribute of “DXFComplements” and MUST contain the following **[key value pair (KVP)](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f):** + +| Value Type | Key Name “k” | Child Elements | +|----|----|----| +| **CT_FeaturePropertyBag** (section 2.6.233) **a** element of type **CT_ArrayFeatureProperty** (section [2.6.229](#Section_26b90ad3836549769c1c1c7cd62d661f)) | “MappedFeaturePropertyBags” | Value contains one or more CT_ArrayFeatureProperty (section 2.6.229) **bagId** elements that reference to [**feature property bags**](#gt_3f541c32-862c-47d2-8c55-e07e44e68bfb) of type **XFComplement** (section [2.3.9.2](#Section_a076e46cc8324ea5bc678f69a98eba7e)). | + +Each **CT_DXFComplement** (section [2.6.255](#Section_688bbebaaf3142a9bdbb2bddb7657a2a)) **i** value MUST reference the zero-based index into the value of key “MappedFeaturePropertyBags”. + +### Python in Excel + +Python in Excel enables the execution of code written in the Python programming language within Excel. The **Python environment** as specified in section [2.3.10.1](#Section_1c0b3d125f9746c2a8e25a2e4171df63) is the computational environment that provides necessary initial resources and setup to execute this code. A Python entry in a cell consists of two components, a **PY function** (section [2.3.10.2](#Section_28f8f9b3e370440c9afc2a1bba74cde6)) and a **Python script** (section [2.3.10.3](#Section_de4efdb9f0544272a2f2c14db21b164a)) referenced by the PY function. The Python script encodes optional parameters passed into the PY function as specified in **Parameter reference encoding** (section [2.3.10.4](#Section_8c3635ff73b341f78c3b889176c52877)). + +#### Python environment + +The [**Python environment**](#gt_17210a25-c8f9-4e33-ab88-02a7555e6854) is a set of resources that we require for execution of code written in the Python programming language within Excel. The environment definition MUST include a [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1) that identifies a unique programming environment as specified in **CT_PythonEnvironmentDefinition** (section [2.6.250](#Section_6285909a009b4fbab73bf2a24ad05176)). It MUST also include code in the Python programming language as specified in **CT_PythonInitialization** (section [2.6.251](#Section_58a34c08a5b44eb7a50cf0c8c1f7a6e8)) that is executed to initialize the Python environment. It MAY include a Boolean value as specified in **CT_PythonInitialization** (section 2.6.251), that if present and set to true specifies that the code to initialize the Python environment has been modified by the user. + +#### Python Function + +A PY function as specified in section [2.2.3](#Section_5d1b6d446fc14ecd8fef0b27406cc2bf) enables the Python programming code to be added to Excel. + +The first parameter of the function MUST be a 0-based index referencing a **CT_PythonScript** element that indicates the [**Python script**](#gt_ccedff9e-7c79-440f-9090-63915f6677ad) for this function as specified in section [2.6.252](#Section_5d4699a442fa447f84b021e7410e5069). + +The second parameter of the function MUST take value either 0 or 1. + +The function MUST pass the first two parameters. The function can have other optional parameters that if passed, can be referenced by the corresponding **Python script** (section [2.3.10.3](#Section_de4efdb9f0544272a2f2c14db21b164a)). + +#### Python Script + +Each of the **CT_PythonScript** elements, as specified in section [2.6.252](#Section_5d4699a442fa447f84b021e7410e5069) indicates the [**Python script**](#gt_ccedff9e-7c79-440f-9090-63915f6677ad) corresponding to a PY function. Any references to the optional parameter passed in a Python function are encoded as specified in section [2.3.10.4](#Section_8c3635ff73b341f78c3b889176c52877). A **CT_PythonScripts** element as specified in section [2.6.253](#Section_030a30ad829c40aa82d78ea4d56cb6c2) holds the Python scripts corresponding to all PY functions in the workbook. + +#### Parameter reference encoding + +Any references to an optional parameter of the Python function are encoded as %Px% where x specifies the 0-based index of a parameter in the Python function. For example, if the third parameter is to be referenced it would be encoded as %P2%. + +## Global Elements + +### pivotTableReference + +A **pivotTableReference** element is a [CT_PivotTableReference](#Section_b367a159fe7e42139382b57fc7566a49) type element, as specified in section 2.6.87, that specifies a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) part identifier for the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The PivotTable specified by this element MUST be a [Non-Worksheet PivotTable](#Section_6ad0de69bcbd4c239b0f5018b86289e2). See section [2.2.4.11](#Section_e29966e25baa4fcf84c9082025e1be13) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +### pivotTableServerFormats + +A **pivotTableServerFormats** is a [CT_PivotTableServerFormats](#Section_3a699774cab2482a85d151c78e000ce1) element that specifies collection of numeric formats specified by elements of complex type **CT_ServerFormat** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10.1.86), for a PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) that is specified by a [pivotTableReference](#Section_ba9ab888b9894fe3afaeb5b64ccf7922) element in the extension of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). See section [2.2.4.11](#Section_e29966e25baa4fcf84c9082025e1be13) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. If the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) is not a [Non-Worksheet PivotTable](#Section_6ad0de69bcbd4c239b0f5018b86289e2), MUST NOT be specified. + +### f + +*Target namespace:* http://schemas.microsoft.com/office/excel/2006/main + +*Referenced by:* [CT_WebExtension](#Section_386851b6b7b642b88cf1d94bab7b0731), [CT_PivotCacheDataSource](#Section_edb9f9d82f7f4f3698b6d9a3a08a349b), [CT_CfRule](#Section_025ea6e4ad4243eaa01616f4e4688ac8), [CT_Cfvo](#Section_15094f93f5874f4ebe741fbdc93da768), [CT_DataValidationFormula](#Section_20ed0abd113f4b8a8de3c68e733a300a), [CT_SparklineGroup](#Section_331c1ecbe49d4cd0843d3ae189dc8a88), [CT_Sparkline](#Section_6b28a993e0fd451d860e35097c6baa77), [CT_PivotUserEdit](#Section_c05d26ce4237405ab8a4429b62ad7642) + +The **f** element is an **ST_Formula** element, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.18.35, that specifies a generic [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) that adheres to section [2.2.2](#Section_3d025add118d44139856ab65712ec1b0). + +An application can adjust the [**cell references**](#gt_4d15aeb2-3a7d-44d7-b8d1-8a441f1cc24f) within this formula when the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) layout changes, even when the containing **ext** element, as specified in \[ISO/IEC29500-1:2016\] section 18.2.7, is not recognized by the application. See [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.3 for more information about how extension lists are used. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1205. \ + +See section [5.1](#Section_b0ddba06ac734d3da9138fbe4a56cf28) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ref + +*Target namespace:* http://schemas.microsoft.com/office/excel/2006/main + +The **ref** element is a **CT_Ref** type element, as specified in section [2.6.146](#Section_f875216dd800445d921374e4da53886f), that specifies a [**cell reference**](#gt_4d15aeb2-3a7d-44d7-b8d1-8a441f1cc24f). + +An application can adjust this cell reference when the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) layout changes, even when the containing **ext** element, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.7, is not recognized by the application. See [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.3 for more information about how extension lists are used. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1206. \ + +See section [5.1](#Section_b0ddba06ac734d3da9138fbe4a56cf28) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### sqref + +*Target namespace:* http://schemas.microsoft.com/office/excel/2006/main + +*Referenced by:* [CT_ConditionalFormatting](#Section_98f4ba7ab8f8496992a0d671d5d8ca8a), [CT_DataValidation](#Section_89029dfc1ca84ff9afe046f9454d09c6), [CT_Sparkline](#Section_6b28a993e0fd451d860e35097c6baa77), [CT_IgnoredError](#Section_20e3a54065ec47c4aa4c44677306292c), [CT_ProtectedRange](#Section_85f5567f259941adae268cfab23ce754) + +A **sqref** element is a **CT_Sqref** type element, as specified in section [2.6.147](#Section_cb63a59070ec45739e144197ffd2f991), that specifies a list of [**cell references**](#gt_4d15aeb2-3a7d-44d7-b8d1-8a441f1cc24f). + +An application can adjust these cell references when the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) layout changes, even when the containing **ext** element, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.7, is not recognized by the application. See [\[ISO/IEC29500-3:2015\]](https://go.microsoft.com/fwlink/?linkid=861154) section 7.3 for more information about how extension lists are used. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1207. \ + +See section [5.1](#Section_b0ddba06ac734d3da9138fbe4a56cf28) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### conditionalFormattings + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **conditionalFormattings** element is a **CT_ConditionalFormattings** type element, as specified in section [2.6.1](#Section_ecd8b65748f7410bb856c4ad9c2fe127), that specifies [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) information for the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). See section [2.2.4.12](#Section_07d607af56184ca2b6836a78dc0d9627) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1208. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### dataValidations + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +The **dataValidations** element is a **CT_DataValidations** type element, as specified in section [2.6.3](#Section_4ec60c5ede694d16944d7fab3e45fdff), that specifies a group of [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) items on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). This element also specifies data validation properties of a sheet that are used by the application user interface. See section [2.2.4.12](#Section_07d607af56184ca2b6836a78dc0d9627) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1209. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### sparklineGroups + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **sparklineGroups** element is a **CT_SparklineGroups** type element, as specified in section [2.6.6](#Section_4901b440dd3b4798b0cafbf9ecaace52), that specifies the groups of [**sparklines**](#gt_69116abb-ab9d-485a-b8b2-8042ec25033f) on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). See section [2.2.4.12](#Section_07d607af56184ca2b6836a78dc0d9627) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1210. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### slicerList + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **slicerList** element is a **CT_SlicerRefs** type element, as specified in section [2.6.11](#Section_02e8869ab443472181724e086c8707df), that specifies a list of slicer, as specified in section [2.3.2](#Section_6c8a1b950c1842adbe5094771b2732f4), part identifiers for the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). See section [2.2.4.12](#Section_07d607af56184ca2b6836a78dc0d9627) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1211. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### protectedRanges + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **protectedRanges** element is a **CT_ProtectedRanges** type element, as specified in section [2.6.55](#Section_e084c498967646d6ba77e3ea8a482df9), that specifies a group of protected [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). See section [2.2.4.12](#Section_07d607af56184ca2b6836a78dc0d9627) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1212. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ignoredErrors + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +An **ignoredErrors** element is a **CT_IgnoredErrors** type element, as specified in section [2.6.53](#Section_a7b2a906d0ec4b5b80ce5fb0f838f544), that specifies a list of **[cell](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) [ranges](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99)** and the types of cell errors that are to be ignored for each of those specific cell ranges. See section [2.2.4.12](#Section_07d607af56184ca2b6836a78dc0d9627) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1213. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotCaches + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **pivotCaches** element is a **CT_PivotCaches** element, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, that specifies a list of **PivotTable**, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, **PivotCache** identifier elements. The list of elements specifies the PivotTable **PivotCaches** used by slicer caches, as specified in section [2.1.4](#Section_7dbb4481b02145cc8bd46094b566a5ff), with [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) slicer source data, as specified in section [2.3.2.1.1](#Section_953b6fbd8a1241029d6a7da6de12598a). See section [2.2.4.11](#Section_e29966e25baa4fcf84c9082025e1be13) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1214. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### slicerCaches + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **slicerCaches** element is a **CT_SlicerCaches** type element, as specified in section [2.6.13](#Section_38bbf8e13e8740e180e37b85a57d3e2a), that specifies a group of slicer cache, as specified in section [2.1.4](#Section_7dbb4481b02145cc8bd46094b566a5ff), identifiers for the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). See section [2.2.4.11](#Section_e29966e25baa4fcf84c9082025e1be13) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1215. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### workbookPr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **workbookPr** element is a **CT_WorkbookPr** element, as specified in section [2.6.10](#Section_00f1eb631e0c423f96d6f139202df390), that specifies additional properties for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). See section [2.2.4.11](#Section_e29966e25baa4fcf84c9082025e1be13) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1216. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### calculatedMember + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **calculatedMember** element is a **CT_CalculatedMember** type element, as specified in section [2.6.15](#Section_2548a3c37ea94129a460dbe2ce72d045), that specifies extended properties of a PivotTable, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**calculated**](#gt_439238d4-21e0-4733-a20a-61115096aaca) member. See section [2.2.4.6](#Section_e5333e5890f14f3e8a80399ea0a07f78) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1217. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### cacheHierarchy + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **cacheHierarchy** element is a **CT_CacheHierarchy** type element, as specified in section [2.6.24](#Section_7132a6be500343d5aa6bb1f4c9ccab32), that specifies the extended properties of a PivotTable, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, named set. See section [2.2.4.6](#Section_e5333e5890f14f3e8a80399ea0a07f78) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1218. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### dataField + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **dataField** element is a **CT_DataField** type element, as specified in section [2.6.25](#Section_9fa014b6505d4aecbaf59473e2b3dd63), that specifies extended information about a PivotTable, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, data [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) item. See section [2.2.4.5](#Section_aafe627aed814c5098ef78084230b952) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1219. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotField + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **pivotField** element is a **CT_PivotField** element, as specified in section [2.6.31](#Section_4af2951d0cec463db5ccc58fbfab90d8), that specifies properties of a PivotTable, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc). See section [2.2.4.5](#Section_aafe627aed814c5098ef78084230b952) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1220. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotTableDefinition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **pivotTableDefinition** element is a **CT_PivotTableDefinition** type element, as specified in section [2.6.32](#Section_4fa0ac531c40475fad76d06c604df3e3), that specifies additional properties of the PivotTable, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, view. See section [2.2.4.5](#Section_aafe627aed814c5098ef78084230b952) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1221. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotCacheDefinition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **pivotCacheDefinition** element is a **CT_PivotCacheDefinition** type element, as specified in section [2.6.33](#Section_2924f3f8a9cb4b098557fda87770d5bd), that specifies the extended properties of a PivotTable, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, **PivotCache** definition. See section [2.2.4.6](#Section_e5333e5890f14f3e8a80399ea0a07f78) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1222. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### connection + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **connection** element is a **CT_Connection** type element, as specified in section [2.6.34](#Section_d430c21d40f5476a9d46138a2c8d970f), that specifies the extended properties of an external connection, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.13. If this element exists, the **type** attribute of the ancestor **CT_Connection** element, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, MUST be equal to "5". See section [2.2.4.1](#Section_32a514539b7645ef8841e7abe46cf926) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1223. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### table + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **table** element is a **CT_Table** type element, as specified in section [2.6.35](#Section_695d9ec4e5764170aea3906aaa455311), that specifies alternate text properties for the table. See section [2.2.4.10](#Section_6596b7e55fb84814b5d94298f6ece6d1) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1224. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### slicerStyles + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **slicerStyles** element is a **CT_SlicerStyles** type element, as specified in section [2.6.51](#Section_96cced63cce742b3af304168cc322c29), that specifies a group of slicer styles, as specified in section [2.3.2.4](#Section_c27949e2eac54d889655187392cab0aa). See section [2.2.4.9](#Section_d8afb021974d403a84de21af334d3d1d) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1225. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### dxfs + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **dxfs** element is a **CT_Dxfs** element, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, that specifies the list of style differential formats (DXFs), as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8. See section [2.2.4.9](#Section_d8afb021974d403a84de21af334d3d1d) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1226. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### oleItem + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +An **oleItem** element is a **CT_OleItem** type element, as specified in section [2.6.46](#Section_2ade7d22ce3748b88704a2d1c27a34c0), that specifies an [**Object Linking and Embedding (OLE)**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) data item, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.14, with associated cached values. See section [2.2.4.3](#Section_50082d197d744b948124d7225f8a522d) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1227. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotHierarchy + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **pivotHierarchy** element is a **CT_PivotHierarchy** type element, as specified in section [2.6.47](#Section_1e1a1806b12d41218e19a56224ea286f), that specifies multiple data items based on the same [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118) that exists in a PivotTable, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, view. See section [2.2.4.5](#Section_aafe627aed814c5098ef78084230b952) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1228. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### cacheField + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +The **cacheField** element is a **CT_CacheField** type element, as specified in section [2.6.48](#Section_8af5cdf7777449b8a5c0194bcc05a1db), that specifies that duplicate [**OLAP measures**](#gt_7431c051-4564-4476-ad00-39c66f169118) exist in a PivotTable, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, **PivotCache** definition. See section [2.2.4.6](#Section_e5333e5890f14f3e8a80399ea0a07f78) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1229. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### id + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +An **id** element is an **ST_Guid** element, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.4, that specifies an identifier for a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule. See section [2.2.4.12](#Section_07d607af56184ca2b6836a78dc0d9627) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1230. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### iconFilter + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +An **iconFilter** element is a **CT_IconFilter** type element, as specified in section [2.6.57](#Section_4c3c501ababc4bdba099f607977b8653), that specifies the properties of an **[icon](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) [filter](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda)**. See section [2.2.4.5](#Section_aafe627aed814c5098ef78084230b952), section [2.2.4.10](#Section_6596b7e55fb84814b5d94298f6ece6d1), and section [2.2.4.12](#Section_07d607af56184ca2b6836a78dc0d9627) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1231. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### filter + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **filter** element is a **CT_Filter** type element, as specified in section [2.6.58](#Section_61e6eefae2804faea606eb8e95942f6e), that specifies the properties of a [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda). See section [2.2.4.5](#Section_aafe627aed814c5098ef78084230b952), section [2.2.4.10](#Section_6596b7e55fb84814b5d94298f6ece6d1), and section [2.2.4.12](#Section_07d607af56184ca2b6836a78dc0d9627) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1232. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### customFilters + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **customFilters** element is a **CT_CustomFilters** type element, as specified in section [2.6.59](#Section_545a0d5521d145eb8d81d730aa5ea2af), that specifies the properties of [**custom filters**](#gt_8593ee2f-c2dd-4793-a684-45fe40c840d2). See section [2.2.4.5](#Section_aafe627aed814c5098ef78084230b952), section [2.2.4.10](#Section_6596b7e55fb84814b5d94298f6ece6d1), and section [2.2.4.12](#Section_07d607af56184ca2b6836a78dc0d9627) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1233. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### sortCondition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **sortCondition** element is a **CT_SortCondition** type element, as specified in section [2.6.61](#Section_af08b8709b064812a4d67bc80d819e62), that specifies a [**sort condition**](#gt_198a56e7-6045-43cf-8acd-793eab3647c1) to apply to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). See section [2.2.4.5](#Section_aafe627aed814c5098ef78084230b952), section [2.2.4.7](#Section_2babd9c70dd94753994c50c53fc72b6b), section [2.2.4.10](#Section_6596b7e55fb84814b5d94298f6ece6d1), and section [2.2.4.12](#Section_07d607af56184ca2b6836a78dc0d9627) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1234. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### sourceConnection + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_CacheSourceExt](#Section_c81cf482908d43499a2ed18d9ea3a6dc) + +A **sourceConnection** element is a **CT_SourceConnection** type element, as specified in section [2.6.62](#Section_7e7a428df5b447cca70a17e0126fa39e), that specifies the name of a connection of the cache source element on a pivot cache. See section [2.2.4.6](#Section_e5333e5890f14f3e8a80399ea0a07f78) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1235. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### formControlPr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **formControlPr** element is a **CT_FormControlPr** type element, as specified in section [2.6.65](#Section_8577637a66c3485bab6ef8c85689a7c4), that specifies properties of form control objects. This element is the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) of the control properties part, as specified in section [2.1.1](#Section_3d054a6d4f944082837af939fd8d4a45). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1236. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### datastoreItem + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **datastoreItem** element is a **CT_DatastoreItem** type element, as specified in section [2.6.66](#Section_e570efaded61465ba1d2aab8529953ca), that specifies properties for an embedded custom data part, as specified in section [2.1.2](#Section_7c53f6f4fea843f7a4b0ba6e14d0eb78). This element is the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) of the custom data properties part, as specified in section [2.1.3](#Section_1f4aa666c9664ecf839928390399c891). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1237. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### slicers + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **slicers** element is a **CT_Slicers** type element, as specified in section [2.6.67](#Section_2d763f4b26c6451f81d2e7e5b21203d1), that specifies all the slicer views, as specified in section [2.3.2.2](#Section_69c0e0f9d0144bd59f2d2f554c715083), on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). This element is the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) of the slicers part, as specified in section [2.3.2](#Section_6c8a1b950c1842adbe5094771b2732f4). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1238. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### slicer + +*Target namespace:* http://schemas.microsoft.com/office/drawing/2010/slicer + +A **slicer** element is a **CT_Slicer** type element, as specified in section [2.6.69](#Section_6f674009241d4a269f10ff99047aef96), that specifies which slicer view, as specified in section [2.3.2.2](#Section_69c0e0f9d0144bd59f2d2f554c715083), is associated with this drawing element. See section [2.2.4.2](#Section_666e28a756ee487396094a46b53bb471) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1239. \ + +See section [5.2](#Section_8ccfc6adcdae4ac6964317d999d1a7e6) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### slicerCacheDefinition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +A **slicerCacheDefinition** element is a **CT_SlicerCacheDefinition** type element, as specified in section [2.6.70](#Section_808f571ceac440919b4fc8882d43de49), that specifies a slicer cache, as specified in section [2.3.2.1](#Section_b0f3c3117ab64314af398bd3bed3bccf). This element is the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) of the slicer cache part. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1240. \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotCaches + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **pivotCaches** element is a **CT_PivotCaches** element, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2 that specifies a list of **PivotTable**, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, **PivotCache** identifier elements. The list of elements specifies the PivotTable **PivotCaches.** See section [2.2.4.11](#Section_e29966e25baa4fcf84c9082025e1be13) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. The **pivotCacheDefinition** (\[ISO/IEC29500-1:2016\] section 18.10.1.67) element identified by the [relationship](#Section_683fd4c8c16a4f74a9b4b9e6950a2139) identifier in the **CT_PivotCache** (\[ISO/IEC29500-4:2016\] section A.2) child element of this element, MUST satisfy the following criteria. + +- There MUST be a [CT_PivotCacheIdVersion](#Section_9cc2fc49e4d24dbea98b061c5ef85033) element in the extension of the element **pivotCacheDefinition**. + +- The **type** attribute of the **CT_CacheSource** (\[ISO/IEC29500-4:2016\] section A.2) child element of the element **pivotCacheDefinition**, MUST have the value **external** specified by **ST_SourceType** (\[ISO/IEC29500-1:2016\] 18.18.75). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1241. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotTableReferences + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **pivotTableReferences** element is a [CT_PivotTableReferences](#Section_03139118595a45828d16b8a292cb5528) element, as specified in section 2.6.86, that specifies a list of PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) part identifiers for the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). See section [2.2.4.11](#Section_e29966e25baa4fcf84c9082025e1be13) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1242. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### queryTable + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **CT_QueryTable** element (section [2.6.88](#Section_ed0a76dd6f8a49839f33d73fa5ab144c)) that specifies extended properties of a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.12). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1243. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### webExtensions + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A [CT_WebExtensions](#Section_5d1976397d9f4d8cafb443e03a2c7e43) element that specifies a group of [CT_WebExtension](#Section_386851b6b7b642b88cf1d94bab7b0731) elements that specify Bindings on the Web Extensions, as specified by [\[MS-OWEXML\]](%5bMS-OWEXML%5d.pdf#Section_a2cd741a4cca4b1aade4b2c443972afa) section 1.3, on the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1244. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### connection + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A [CT_Connection](#Section_e2c29e600c7f4f55b4fd0cad215e6bb9) element that specifies the extended properties of an external connection. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1245. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### calculatedMember + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_CalculatedMemberExt](#Section_349130bbc08a472ea29692ead08d768b) + +A CT_CalculatedMember (section [2.6.93](#Section_fe7c684762044120b6d95efe6deb8bde)) element that specifies a definition for a custom member or measure that is applied to a pivot table. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1246. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotTableUISettings + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A [CT_PivotTableUISettings](#Section_488b5da9c4dd4101ac8491ce3597d7bd) element that specifies state of the [**PivotTable field list**](#gt_1760fb56-0c97-4c0d-a077-38338baa7577) for this PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1247. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotFilter + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +**A** [CT_PivotFilter](#Section_f81551bb12f747e4b10d7162bfa177ec) element that specifies the extended properties of a **filter (PivotTable Advanced Filter)**, as specified in ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10.1.33). See section [2.2.4.5](#Section_aafe627aed814c5098ef78084230b952) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1248. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### slicerCaches + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A [CT_SlicerCaches](#Section_38bbf8e13e8740e180e37b85a57d3e2a) element that specifies a group of slicer cache, as specified in section [2.1.4](#Section_7dbb4481b02145cc8bd46094b566a5ff), identifiers for the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1249. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### tableSlicerCache + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A [CT_TableSlicerCache](#Section_c3629be299fe44b7970c3ea6df625cf5) element that specifies a table [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for the [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1250. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### timelineCacheRefs + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **timelineCacheRefs** element is a **CT_TimelineCacheRefs** type element, as specified in section [2.6.98](#Section_2f821c30252d4507b39296ab558788c8), that specifies a group of **Timeline Cache** (section [2.3.5.1](#Section_8a428bc98be342fab39e8d2bb83657a2)) identifiers for the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). See section [2.2.4.11](#Section_e29966e25baa4fcf84c9082025e1be13) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1251. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### timelineRefs + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **timelineRefs** element is a **CT_TimelineRefs** type element, as specified in section [2.6.100](#Section_a86d3fc351884ddd9a30c4906a6f84d3), that specifies a list of Timeline (section [2.3.5](#Section_92ac3f95d5bb4584882e95e4e9c443c8)) part identifiers for the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). See section [2.2.4.12](#Section_07d607af56184ca2b6836a78dc0d9627) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1252. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### timelineCachePivotCaches + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **timelineCachePivotCaches** element is a **CT_PivotCaches** element, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2 that specifies a list of **PivotTable**, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, **PivotCache** identifier elements. The list of elements specifies the PivotTable **PivotCaches.** This element MUST be associated with a Timeline (section [2.3.5](#Section_92ac3f95d5bb4584882e95e4e9c443c8)). See section [2.2.4.11](#Section_e29966e25baa4fcf84c9082025e1be13) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1253. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### cacheHierarchy + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A [CT_CacheHierarchy](#Section_d1478987e5a6467fb2f1bd7b7b48e4ed) element that specifies the extended properties of an [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1254. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### slicerCacheHideItemsWithNoData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A [CT_SlicerCacheHideNoData](#Section_4c8e1834995440209dd4066d9ea42d0d) element that specifies the extended properties of a [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf), as specified in section 2.3.2.1. If this element exists, the [non-OLAP slicer items](#Section_a7ffe1389cc14e5ea0dba1ca7674a304) that have no data in its ancestor slicer cache are not displayed and the [OLAP slicer items](#Section_ac62b47c91274f09b816e14a6909a1dc) that have no data are not displayed for the [**OLAP levels**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) specified by the **uniqueName** attribute of the [CT_SlicerCacheOlapLevelName](#Section_1aec1629336f4ac1963bc76669784925) element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1255. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### timelineStyles + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **timelineStyles** element is a **CT_TimelineStyles** type element, as specified in section [2.6.105](#Section_ca8bb0ae143a4747b78751044f8f67cf), that specifies a group of timeline styles, as specified in section [2.3.5.4](#Section_e438dc0a0c334172b8fb61ea2a1a06bb). See section [2.2.4.9](#Section_d8afb021974d403a84de21af334d3d1d) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1256. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### dxfs + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **dxfs** element is a **CT_Dxfs** element, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, that specifies the list of style differential formats (DXFs), as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8. See section [Styles](#Section_d8afb021974d403a84de21af334d3d1d) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1257. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### timelinePivotCacheDefinition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **timelinePivotCacheDefinition** element is a [CT_TimelinePivotCacheDefinition](#Section_0d70df45e6c041f0a1c949e99d6555fa) element that specifies the extended properties of a PivotTable, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, **PivotCache** definition. See section [2.2.4.6](#Section_e5333e5890f14f3e8a80399ea0a07f78) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1258. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### timelines + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **timelines** element is a **CT_Timelines** type element, as specified in section [2.6.110](#Section_696e862ce15d4c9ebf9e45e60b5c030c), that specifies all the Timeline views (section [2.3.5.2](#Section_ca0c8a5be42e4aeab6850a236dff375e)), on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). This element is the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) of the Timelines part (section [2.3.5](#Section_92ac3f95d5bb4584882e95e4e9c443c8)). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1259. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### timelineCacheDefinition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **timelineCacheDefinition** element is a **CT_TimelineCacheDefinition** type element, as specified in section [2.6.112](#Section_f45ff6effb624e198e8c822e3be9ef75), that specifies a Timeline cache (section [2.3.5.1](#Section_8a428bc98be342fab39e8d2bb83657a2)). This element is the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) of the Timeline cache part. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1260. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### workbookPr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **workbookPr** element is a CT_WorkbookPr (section [2.6.117](#Section_3a493a307710496ca3959d9e9ea71b8a)) element that specifies additional properties for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). See section [2.2.4.11](#Section_e29966e25baa4fcf84c9082025e1be13) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1261. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### slicerCachePivotTables + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **CT_SlicerCachePivotTables** element (section [2.6.72](#Section_02a103ce599e4bd39660540143e686c5)) that specifies a group of **CT_SlicerCachePivotTable** elements (section [2.6.73](#Section_24e77636213342cc9e7460497618a5d5)) that specify the PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) views that are filtered by the slicer cache (section [2.1.4](#Section_7dbb4481b02145cc8bd46094b566a5ff)). The PivotTables specified by the **CT_SlicerCachePivotTable** (section 2.6.73) child elements of this element MUST be Non-Worksheet PivotTables (section [2.3.3](#Section_6ad0de69bcbd4c239b0f5018b86289e2)). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1262. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### cachedUniqueNames + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A [CT_CachedUniqueNames](#Section_a63887bd9d524920b4f2b2be9ce48b1d) element that specifies the [**MDX unique names**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) for PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) cache items in this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) cache [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1263. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### dataModel + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A [CT_DataModel](#Section_eaea0fe63e3c401da3a02d2cbb9fce00) element that specifies properties of [**spreadsheet data model**](#gt_95ac50ee-8fc4-4dce-85e0-984684a68319). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1264. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotTableData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **pivotTableData** element is a [CT_PivotTableData](#Section_cab1573991c54a2bb479749197afcfa2) element that specifies the [PivotValues](#Section_dea9fdef82e54111b51e48a61a596992) of a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10), specified by the [pivotTableReference](#Section_ba9ab888b9894fe3afaeb5b64ccf7922) element in the extension of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). See section [2.2.4.5](#Section_aafe627aed814c5098ef78084230b952) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. If the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) is not a [Non-Worksheet PivotTable](#Section_6ad0de69bcbd4c239b0f5018b86289e2), MUST NOT be specified. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1265. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotCacheIdVersion + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A [CT_PivotCacheIdVersion](#Section_9cc2fc49e4d24dbea98b061c5ef85033) element that specifies the extended properties of a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) **PivotCache** **Definition**. If this element exists, there MUST be a preceding [**CT_PivotCacheDefinition**](#Section_2924f3f8a9cb4b098557fda87770d5bd) element and the **pivotCacheId** attribute of the preceding **CT_PivotCacheDefinition** element MUST be equal to one of the following:- + +- The **cacheId** attribute of the [CT_PivotTableData](#Section_cab1573991c54a2bb479749197afcfa2) element in the PivotTable part that specifies a [Non-Worksheet PivotTable](#Section_6ad0de69bcbd4c239b0f5018b86289e2). + +- The **pivotCacheId** attribute of the **CT_TimelineState** (section [2.6.116](#Section_aa9bf1321afa4ce9b3d2e6dc00e48fde)) child element of a **CT_TimelineCacheDefinition** (section [2.6.112](#Section_f45ff6effb624e198e8c822e3be9ef75)) element that specifies a [Timeline cache](#Section_8a428bc98be342fab39e8d2bb83657a2). + +See section [2.2.4.6](#Section_e5333e5890f14f3e8a80399ea0a07f78) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1266. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### timeslicer + +*Target namespace:* http://schemas.microsoft.com/office/drawing/2012/timeslicer + +A [CT_Timeline](#Section_c6a9c49f16f9431199263708685cafd8) element that specifies which [timeline view](#Section_ca0c8a5be42e4aeab6850a236dff375e) is associated with this drawing element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1267. \ + +See section [5.7](#Section_c4febed78f37443bb83d668ffd09d082) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### list + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2011/1/ac + +An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) element that specifies the first formula in the DataValidation dropdown used for custom or list type data validation. Only used when items need to be quoted. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1268. \ + +See section [5.6](#Section_aa12452a467d41928ebf0a90d86dd64b) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### absPath + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/ac + +A [CT_AbsolutePath](#Section_9387c5cc13784b52a6c44ef7c7d3bff2) element that specifies the absolute path to the workbook. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1269. \ + +See section [5.9](#Section_ce659475d5804104895fb72947105f24) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### dataField + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **dataField** element is a **CT_DataField** type element, as specified in section [2.6.141](#Section_da282626d7a04234b914ffa3cdb29921), that specifies extended information about a PivotTable, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, data [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) item. See section [2.2.4.5](#Section_aafe627aed814c5098ef78084230b952) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1270. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### survey + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A **survey** element is a **CT_Survey** type element, as specified in section [2.6.142](#Section_1d394e382b18495186f0e283b03b0cfd), that specifies the properties of a survey associated with a Table ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.5). This element is the [**root element**](#gt_95422012-9f75-49c9-b80c-e190eee929d3) of the Survey part (section [2.1.9](#Section_7dfc2db2457047c8bc782e797befff09)) + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1271. \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### contentPart + +*Target namespace:* http://schemas.microsoft.com/office/excel/2010/spreadsheetDrawing + +A [CT_ContentPart](#Section_72e2f347451445ef887341988eda2835) element that specifies a reference to [**XML**](#gt_982b7f8e-d516-4fd5-8d5e-1a836081ed85) content. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1272. \ + +See section [5.8](#Section_b54c3971c1684f9c8791c07f8d8d8002) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### modelTimeGroupings + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2014/11/main + +A **CT_ModelTimeGroupings** (section [2.6.154](#Section_8e96dc6297234ffb9cb788fdd8e0ad39)) element that specifies the data model time groupings in this workbook. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1273. \ + +See section [5.10](#Section_4fe24a216f694680882ff86b16a69119) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### revisionPtr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2014/revision + +A [CT_RevisionPtr](#Section_7fc8862a63f242638334b9e72b480c8e) element that specifies metadata supporting runtime scenarios for Microsoft Excel. It MUST be ignored and MUST NOT be saved by all others. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1274. \ + +See section [5.15](#Section_5ba37a83255b4e2dae7bb4d14d44ad3a) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotTableDefinition16 + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2016/pivotdefaultlayout + +A [CT_PivotTableDefinition16](#Section_b94bb26d3aed4f9397796375f4c2e837) element that specifies additional properties of the PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) view. See section [2.2.4.5](#Section_aafe627aed814c5098ef78084230b952) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1275. \ + +See section [5.19](#Section_9b107b7d1fe8476f9ba5f237ceaf6a0e) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### arrayData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +A [CT_ArrayData](#Section_588d1e0ed3ae40ca9fd12f172f050b09) element that specifies arrays in [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) called [**rich arrays**](#gt_4b9137fd-391c-4d11-9488-c5d535d68feb). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1276. \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### richStyleSheet + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +A [CT_RichStylesheet](#Section_43e346e0d85448c39fd6b0f70300b408) element that specifies the collection of **dxfs**, as specified in section [2.4.55](#Section_c7d758644136460499cb52937e143a68), **CT_RichFormatProperties**, as specified in section [2.6.167](#Section_479db4e3edd24d198984023d3a081558), and **CT_RichStyles**, as specified in section [2.6.172](#Section_529508cf873e43bdb68e4df453246713). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1277. \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### rvb + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata + +A [CT_RichValueBlock](#Section_571495615faf466095fb140ba011990a) element that specifies the index to the [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a), as specified in section 2.6.176. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1278. \ + +See section [5.21](#Section_9058338fcf3b4a7b8f84622e180eacc5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### rvData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata + +A [CT_RichValueData](#Section_4b53ebeff1fc4521b78847a5e347d66c) element that specifies [**rich value data**](#gt_26aa395d-2e6a-4071-b25c-95e20adf8ac3). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1279. \ + +See section [5.21](#Section_9058338fcf3b4a7b8f84622e180eacc5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### rvStructures + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata + +A [CT_RichValueStructures](#Section_b12b8314fe2a4a5e81177b83b6bcb5d2) element that specifies [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) structures, which contain lists of [**rich value keys**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) and the [**data types**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) for the corresponding [**rich value data**](#gt_26aa395d-2e6a-4071-b25c-95e20adf8ac3). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1280. \ + +See section [5.21](#Section_9058338fcf3b4a7b8f84622e180eacc5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### rvTypesInfo + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +A [CT_RichValueTypesInfo](#Section_6b2ed0e075bc4118ad12327520402707) element that specifies information related to [**rich value types**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1281. \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### spbStructures + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +A [CT_SupportingPropertyBagStructures](#Section_2a4f5d8f8dca4458a5cf2455510e5d2f) element that specifies [**supporting property bag**](#gt_048a0082-4ff4-4807-8300-69ccc781c098) structures, which contain lists of [**supporting property bag keys**](#gt_9b058a5b-a83d-4208-9d7d-49665db1ff97) and the [**data types**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) for the corresponding [**supporting property bag data**](#gt_c7e57fec-f265-403b-accb-9fa4628addf8). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1282. \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### supportingPropertyBags + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +A [CT_SupportingPropertyBags](#Section_8080ca5bbabd4fde96f303ba7006de22) element that specifies [**supporting property bag data**](#gt_c7e57fec-f265-403b-accb-9fa4628addf8). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1283. \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### calcFeatures + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2018/calcfeatures + +A [CT_CalcFeatures](#Section_588fb9e0e8244e4f95ffb84de746e212) element that specifies a list of **CT_CalcFeature** elements (section [2.6.199](#Section_d158be0b3e694226a78ca96d3fcee017)). These elements add granularity to the version of the calc engine along with the **calcId** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.2). + +Each **CT_CalcFeature** element contains the name of a calculation engine feature that was present when the workbook was [**calculated**](#gt_439238d4-21e0-4733-a20a-61115096aaca). This is used with the **calcId** to determine the version of the calculation engine. When a workbook is opened, the application will recalculate if the **calcId** value is at least 179016 and any of the features present in the current version of the calculation engine are not represented in this element. See **CalcPr** (\[ISO/IEC29500-1:2016\] section 18.2.2) for more information about the calculation engine. See **CT_CalcFeature** for a list of calculation engine features. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1284. \ + +See section [5.22](#Section_6c4054c805a949dcbaa913e5a6282989) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### filterColumn + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +A [CT_RichFilterColumn](#Section_407edac1996743cd9b675816e6eadca6) element that specifies [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) information associated with [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1285. \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### richSortCondition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +A [CT_RichSortCondition](#Section_984b10b877a0427388afdf98616ee8e1) element that specifies [**sort conditions**](#gt_198a56e7-6045-43cf-8acd-793eab3647c1) associated with [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1286. \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### personList + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2018/threadedcomments + +A [CT_PersonList](#Section_d969311e5d7443909da280a7824c9071) element that specifies a list of person information associated with a collection of [**threaded comments**](#gt_7275a968-842f-4c12-b5e6-faf2a7f249c4) and [**mentions**](#gt_afcc37b0-9cff-4c5c-87cd-9db73437848b). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1287. \ + +See section [5.23](#Section_adb847329fc848b6bddc6b0bcdaad940) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ThreadedComments + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2018/threadedcomments + +A [CT_ThreadedComments](#Section_0cfb2f0587a24b5fa9adfb11ca39e2f8) element that specifies a collection of [**threaded comments**](#gt_7275a968-842f-4c12-b5e6-faf2a7f249c4) on the associated sheet. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1288. \ + +See section [5.23](#Section_adb847329fc848b6bddc6b0bcdaad940) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### dynamicArrayProperties + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/dynamicarray + +A [CT_DynamicArrayProperties](#Section_d1ef676dd9704dddb64262f5e0c291e0) element that specifies properties of a [**dynamic array**](#gt_bb976581-5eac-4091-9255-6daae19ed259). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1289. \ + +See section [5.25](#Section_878c8ac485484bfb9ad4b1378e0efed1) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### namedSheetViews + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2019/namedsheetviews + +A [CT_NamedSheetViews](#Section_16f8352671174942869dad31f86b937d) element that specifies a collection of [**named sheet views**](#gt_536ae444-2479-4867-8bfa-9a5be4e9995e) + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1290. \ + +See section [5.26](#Section_55396aef0c074ffb9ffbe48b6d339abe) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### externalLinksPr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2019/extlinksprops + +A [CT_ExternalLinksPr](#Section_5532aacfa0d549fa8d2178144700ae39) element that specifies extended properties applicable to all external links of this workbook. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1291. \ + +See section [5.27](#Section_b2939e1139c1475699097a2dc79e8c2e) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### webImagesSrd + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2020/richdatawebimage + +A [CT_WebImagesSupportingRichData](#Section_d13e2c61fae142a7aa6fd6d8c226858d) element that specifies properties for web image rich values. For more information see section [2.3.6.1.11](#Section_9940168fccfc43a8bf8134c7d4bff974). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1292. \ + +See section [5.28](#Section_1dc262ba8b454611b6fbce1b04a561e0) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### implicitMeasureSupport + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2020/pivotNov2020 + +A boolean ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) element that specifies whether the [**data connection**](#gt_024a24fb-c1c0-4393-ab0c-f0e3e3f41629) associated with this pivot cache supports the use of measures defined by the client. + +| Value | Meaning | +|----|----| +| "true" | The data connection associated with this pivot cache supports client defined measures. | +| "false" | The data connection associated with this pivot cache does not support client defined measures. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1293. \ + +See section [5.29](#Section_a9f2fa9d070f449180e8832783f0ada2) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### refreshIntervals + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2020/richvaluerefresh + +A [CT_RichValueRefreshIntervals](#Section_d7838cb2b6084667b52b93a751687a60) element that specifies a collection of refresh intervals for the [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100) specified in the **CT_RichValueType** (section [2.6.182](#Section_0a1cee9c0c744d92ad2674c3585f6e5e)). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1294. \ + +See section [5.31](#Section_7c97123fa8954094afe6b661d7f3e634) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### dataFieldFutureData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2020/pivotNov2020 + +A [CT_DataFieldFutureData](#Section_91a0ebf3236f4cfbb2432b7a8d628b29) element that specifies extended information about a [**PivotTable data field**](#gt_422ecf6b-649e-4e99-9431-5297e4e297b8), as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10. See section [2.2.4.5](#Section_aafe627aed814c5098ef78084230b952) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1295. \ + +See section [5.29](#Section_a9f2fa9d070f449180e8832783f0ada2) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ignorableAfterVersion + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2020/pivotNov2020 + +A [CT_Ignorable](#Section_8391117a30a24890863609b7f8d31e60) element that specifies that the parent element SHOULD be ignored if the [CT_PivotCacheIdVersion](#Section_9cc2fc49e4d24dbea98b061c5ef85033) of the associated PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) **PivotCache** definition is greater than or equal to the value specified. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1296. \ + +See section [5.29](#Section_a9f2fa9d070f449180e8832783f0ada2) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### cacheVersionInfo + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/pivotVersionInfo + +A [CT_CacheVersionInfo](#Section_83b3bf0e416e41d094f7bf6abd20bf9f) element that specifies versioning information about the associated PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) **PivotCache.** + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1297. \ + +See section [5.32](#Section_ce4604c1dd30452c9fc1630dc4012961) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotVersionInfo + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/pivotVersionInfo + +A [CT_PivotVersionInfo](#Section_9388128ba0d2464c9b743c461128ae50) element that specifies versioning information about the associated PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1298. \ + +See section [5.32](#Section_ce4604c1dd30452c9fc1630dc4012961) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### alternateUrls + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2021/extlinks2021 + +A [CT_ExternalBookAlternateUrls](#Section_cd7a81dc36734acbaefbc7f02ffd9a88) element that represent additional Urls and Ids to the external book which is supplying data to the current workbook + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1299. \ + +See section [5.34](#Section_ffd38adacfa54242976b198f6fd508d9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### FeaturePropertyBags + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +A [CT_FeaturePropertyBags](#Section_c36ae2cb267b4ee99d229928e65a1e8c) element that specifies a list of [CT_FeaturePropertyBag](#Section_8383a4177cb14324af6399dd77ffebd5) elements and [CT_BagExtensions](#Section_18ea8907491d459ebf54bac5980b51ae) elements. + +See section [2.3.9](#Section_35e6c0342e1f471baa1fd82def1a32e8) for more information about [**feature property bag**](#gt_3f541c32-862c-47d2-8c55-e07e44e68bfb). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1300. \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### xfComplement + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +*Referenced by:* [CT_XfComplementExt](#Section_7b9ee8f05f77416b9cdc747a986b064b) + +A [CT_XfComplement](#Section_09ecc2fe7df748dda30641c576c1a91f) element that specifies an **xf** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8.10) has an implicit relationship to a [**feature property bag**](#gt_3f541c32-862c-47d2-8c55-e07e44e68bfb) of type **XfComplements** (section [2.3.9.1](#Section_cb97d7fc1434498c9bd3aa5fae4e677c)). This element indicates that a **Feature Property Bag** part (section [2.1.22](#Section_19ef002a0b3345b3aa01fcae807602ff)) MUST be present in the package. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1301. \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### richValueRels + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/richvaluerel + +A [CT_RichValueRels](#Section_5bbff086f47d4137936b8fe49ada3832) element that specifies a list of [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) relationships. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1302. \ + +See section [5.35](#Section_56bafcc41ae84894a86c1e92f165a3c5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### externalCodeService + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/externalCodeService + +*Referenced by:* [CT_ExternalCodeServiceExt](#Section_0f7fb780d187487cbb5f7e9ffd01ac71) + +A [CT_ExternalCodeService](#Section_11dad9754fe54d81b9b6fc56c8a0ea95) element that specifies properties related to an [**external code service**](#gt_9a3bc1c7-ad12-4371-85b6-78656d97437a). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1303. \ + +See section [5.38](#Section_b3c832bd13c74c2f869eac31bf13ea7c) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### python + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/python + +A [CT_Python](#Section_dd6cd24c9dac4244ac00ebe58dd4ef4f) element that specifies the [**Python scripts**](#gt_ccedff9e-7c79-440f-9090-63915f6677ad) added to the workbook and information about the [**Python environment**](#gt_17210a25-c8f9-4e33-ab88-02a7555e6854) used to execute these Python scripts. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1304. \ + +See section [5.39](#Section_ef230d238d80473c925e3e5b98abdbba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### DXFComplement + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +*Referenced by:* [CT_DXFComplementExt](#Section_74fddcc6558a4300bd3632f63df51463) + +A [CT_DXFComplement](#Section_688bbebaaf3142a9bdbb2bddb7657a2a) element that specifies a **dxf** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8.14) has an implicit relationship to a [**feature property bag**](#gt_3f541c32-862c-47d2-8c55-e07e44e68bfb) of type **DXfComplements** (section [2.3.9.5](#Section_6f826926a32c47c4a279187e0959c74e)). This element indicates that a **Feature Property Bag** part (section [2.1.22](#Section_19ef002a0b3345b3aa01fcae807602ff)) MUST be present in the package. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1305. \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### aggregationInfo + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation + +A [CT_AggregationInfo](#Section_4ad69738dc4442ecb084ce92071cb359) element that specifies the [**aggregation function**](#gt_f9b44a9d-68c4-4a28-b347-cce9eb5f8845) for the [**PivotTable data field**](#gt_422ecf6b-649e-4e99-9431-5297e4e297b8). If this element is present, the **subtotal** attribute of the associated **PivotTable** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) data [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) item (\[ISO/IEC29500-1:2016\] section 18.10.1.22) SHOULDf[\<7\>](#Appendix_A_7) be ignored. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1306. \ + +See section [5.40](#Section_bc0e64e719ba49a8852622960eacc4ba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### featureSupportInfo + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation + +A [CT_FeatureSupport](#Section_7824e854bf6d4a93b2a910e26023d938) element that specifies versioning information for the [**PivotTable field**](#gt_52c9d088-c3c8-408b-b50a-c389b3267e44) that if supported allows the associated PivotTable field to be ignored. If this element is present, the associated **PivotTable** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) SHOULD[\<8\>](#Appendix_A_8) be ignored. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1307. \ + +See section [5.40](#Section_bc0e64e719ba49a8852622960eacc4ba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### autoRefresh + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2024/pivotAutoRefresh + +A boolean ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) element that specifies whether the pivot cache refreshes automatically when source data changes. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1308. \ + +See section [5.41](#Section_6a5315967c64455b93fa7a8d7e3fca15) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### version + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2024/workbookCompatibilityVersion + +*Referenced by:* [CT_WorkbookCompatibilityVersionExt](#Section_d78afeb779da43a49282f3749c27250b) + +A [CT_Version](#Section_294f537a8085415a82ad979e2912c316) element that specifies properties for Compatibility Version. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1309. \ + +See section [5.42](#Section_a595485815b34cde98b3670ea2710489) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### showDataTypeIcons + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/showDataTypeIcons + +*Referenced by:* [CT_ShowDataTypeIconsExt](#Section_3495b90b8d66425a887109395bd36b73) + +A [CT_ShowDataTypeIcons](#Section_eb5968b15dd445fcba682f0a61807480) element that specifies whether to show Data Type Icons on a sheet view. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1310. \ + +See section [5.43](#Section_8d375463bcab494680c767c59b9b40c0) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### showDataTypeIconsCustomSheetView + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/showDataTypeIcons + +*Referenced by:* [CT_ShowDataTypeIconsCustomSheetViewExt](#Section_eaf3f2b9fc024b44b15e00a59d197eb7) + +A [CT_ShowDataTypeIcons](#Section_eb5968b15dd445fcba682f0a61807480) element that specifies whether to show Data Type Icons on a custom sheet view. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1311. \ + +See section [5.43](#Section_8d375463bcab494680c767c59b9b40c0) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### externalCodeServiceImageAsInput + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2025/externalCodeService2 + +*Referenced by:* [CT_ExternalCodeServiceImageAsInputExt](#Section_abaebc66ffe7489880935ae7c3f9ef79) + +A [CT_ExternalCodeServiceImageAsInput](#Section_7d86e1c0496f48e895a3f2d5906ae261) element that specifies attributes of the images sent to an [**external code service**](#gt_9a3bc1c7-ad12-4371-85b6-78656d97437a). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1312. \ + +See section [5.44](#Section_4747e200ff5c428fba090d2586d791ed) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotAreaReferenceSubtotals + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation + +A [CT_PivotAreaReferenceSubtotals](#Section_6e909fda16f549c5a7aca9285f55fed2) element that specifies subtotal types in a PivotTable area reference. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1313. \ + +See section [5.40](#Section_bc0e64e719ba49a8852622960eacc4ba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotCacheDataSource + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2025/pivotDataSource + +A [CT_PivotCacheDataSource](#Section_edb9f9d82f7f4f3698b6d9a3a08a349b) element that specifies a [**PivotTable**](#gt_38963165-73bc-400a-a809-aff03693a316) data source for dynamic array reference and formulas. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1314. \ + +See section [5.45](#Section_04ae0b0121e249a18f7746d3b9180217) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotFieldSubtotalLineItems + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation + +A [CT_PivotTableSubtotalLineItems](#Section_2dd8e57bf8db48ac980282b2a8a0f17b) element that specifies a subtotal type in a [**PivotTable**](#gt_38963165-73bc-400a-a809-aff03693a316) Line. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1315. \ + +See section [5.40](#Section_bc0e64e719ba49a8852622960eacc4ba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### pivotFieldSubtotals + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation + +A [CT_PivotFieldSubtotals](#Section_78c8996c76c847f4afc97f0ca4078fa2) element that specifies custom subtotals in a [**PivotTable field**](#gt_52c9d088-c3c8-408b-b50a-c389b3267e44). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1316. \ + +See section [5.40](#Section_bc0e64e719ba49a8852622960eacc4ba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### richInfo + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/pivotRichData + +A section [CT_PivotCacheRichInfo](#Section_e599144ad4d94d2686cc2eadb5ce83f8) element that specifies the unique ID of this PivotCache's rich data information. This MAY be the same as the cache's id element ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 2.4.28) + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1317. \ + +See section [5.33](#Section_0f1d2cd1bba14ad3b607ffa7aa1e296f) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### dataSourceClean + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2026/pivotDataSourceClean + +A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) element that specifies whether the associated **pivotCacheDefinition** element ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10.1.67) was known to be in sync with the source data at the time the file was saved. MUST be true if this element is present. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this element. + +1318. \ + +See section [5.46](#Section_6b811658ed2043d5b6f77f3f21a43fb4) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +## Global Attributes + +### coauthVersionLast + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2016/revision6 + +*Referenced by:* [CT_RevisionPtr](#Section_7fc8862a63f242638334b9e72b480c8e) + +An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that SHOULD be ignored. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this attribute. + +1319. \ + +See section [5.14](#Section_e47e052c40d043cdadd473a220966b69) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### coauthVersionMax + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2016/revision6 + +*Referenced by:* [CT_RevisionPtr](#Section_7fc8862a63f242638334b9e72b480c8e) + +An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that SHOULD be ignored. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this attribute. + +1320. \ + +See section [5.14](#Section_e47e052c40d043cdadd473a220966b69) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### dyDescent + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/ac + +The **dyDescent** attribute is a **double** attribute, as specified in [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.5, that specifies the vertical distance in [**pixels**](#gt_fe932605-d3bc-442f-9239-594676bce6ba) from the bottom of the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the current [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) to the typographical baseline of the cell content if, hypothetically, the [**zoom level**](#gt_bfb33471-a018-422b-bc63-177c8bc1831f) for the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) containing this row is 100 percent and the cell has bottom-alignment formatting. See section [2.2.4.12](#Section_07d607af56184ca2b6836a78dc0d9627) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). The **dyDescent** attribute has a side effect; it sets the **customHeight** attribute to true even if the **customHeight** attribute is explicitly set to false. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this attribute. + +1321. \ + +See section [5.5](#Section_7148c81d4d6e4204be07a7c09f4277c7) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### formatCode16 + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2015/02/main + +The **formatCode16** attribute[\<9\>](#Appendix_A_9) is an ST_Xstring ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the number format codes for this number format. If present, the **formatCode16** attribute takes precedence over the **formatCode** attribute (\[ISO/IEC29500-1:2016\] section 18.8.31). + +The contents of the **formatCode16** attribute are identical to that of the **formatCode** attribute (\[ISO/IEC29500-1:2016\] section 18.8.31), with the following modifications to the "International Considerations" therein. The syntax for the **formatCode16** attribute’s currency and locale/date system/number system information is \[\$\-\\[,\\]\]. + +The currency string is the string to use as a currency symbol. + +The culture info is a culture tag, which can be either an IETF language tag ([\[RFC5646\]](https://go.microsoft.com/fwlink/?LinkId=528682)) or one of the following private use namespace tags. + +| Value | Meaning | +|----|----| +| x-sysdate | System long date format. Cannot be combined with other culture tags. | +| x-systime | System time format. Cannot be combined with other culture tags. | +| x-euro1 | Trailing generic Euro currency. Cannot be combined with other culture tags. | +| x-euro2 | Leading generic Euro currency. Cannot be combined with other culture tags. | +| x-genlower | Use genitive lowercase form for any full month names in the format (Russian language only). Append to IETF language tag, for example, "ru-RU-x-genlower". | +| x-genupper | Use genitive uppercase form for any full month names in the format (Russian language only). Append to IETF language tag, for example, "ru-RU-x-genupper". | +| x-nomlower | Use nominative lowercase form for any full month names in the format (Russian language only). Append to IETF language tag, for example, "ru-RU-x-nomlower". | +| x-xbt1 | Trailing Bitcoin currency. Cannot be combined with other culture tags. | +| x-xbt2 | Leading Bitcoin currency. Cannot be combined with other culture tags. | + +The optional calendar type and numeral system data is a 16-bit number in hexadecimal form that is placed after a culture tag, separated by a comma. The contents are defined by the **formatCode** attribute (\[ISO/IEC29500-1:2016\] section 18.8.31), with the following modification: The calendar type is stored in byte 0 (the least significant byte) and the numeral system is stored in byte 1 (the most significant byte). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this attribute. + +1322. \ + +See section [5.11](#Section_e29f5a54ff7147e99183440b65eb27ad) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### knownFonts + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/ac + +The **knownFonts** attribute is a **Boolean** attribute, as specified in ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2, that specifies the typographical descent information that is stored in the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). See section [2.2.4.9](#Section_d8afb021974d403a84de21af334d3d1d) for how this element integrates with the Office Open XML file formats specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this attribute. + +1323. \ + +See section [5.5](#Section_7148c81d4d6e4204be07a7c09f4277c7) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### misleadingFormat + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2018/08/main + +A boolean ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether to ignore errors arising from the possibly misleading number formatting of numeric formula results. + +| Value | Meaning | +|----|----| +| "true" | Ignore errors arising from the possibly misleading number formatting of numeric formula results. | +| "false" | Do not ignore errors arising from the possibly misleading number formatting of numeric formula results. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this attribute. + +1324. \ + +See section [5.24](#Section_b38f8644d3e64d20889d56a9df09cad8) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### uid + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2015/revision2 + +*Referenced by:* [CT_SparklineGroup](#Section_331c1ecbe49d4cd0843d3ae189dc8a88) + +An ST_Guid ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.4) attribute that specifies a unique identifier associated with the referencing type. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this attribute. + +1325. \ + +See section [5.16](#Section_7b729443d0cd434e8d8cb228f701a55b) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### uid + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2016/revision3 + +An ST_Guid ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.4) attribute that specifies a unique identifier associated with the referencing type. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this attribute. + +1326. \ + +See section [5.17](#Section_1c6fdaed8a404086be070135b10b8f90) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### uid + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2016/revision9 + +An ST_Guid ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.4) attribute that specifies a unique identifier associated with the referencing type. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this attribute. + +1327. \ + +See section [5.13](#Section_1df7cd78d8bc4ec489521b61beeaee76) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### uid + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2014/revision + +*Referenced by:* [CT_DataValidation](#Section_89029dfc1ca84ff9afe046f9454d09c6) + +An ST_Guid ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.4) attribute that specifies a unique identifier associated with the referencing type. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this attribute. + +1328. \ + +See section [5.15](#Section_5ba37a83255b4e2dae7bb4d14d44ad3a) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### uid + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2016/revision10 + +*Referenced by:* [CT_SlicerCacheDefinition](#Section_808f571ceac440919b4fc8882d43de49), [CT_Slicer](#Section_03ec9cc4ffa94646b4a88343bbe076d0), [CT_Timeline](#Section_0d578770103b4d7489206636997b6424), [CT_TimelineCacheDefinition](#Section_f45ff6effb624e198e8c822e3be9ef75) + +An ST_Guid ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.4) attribute that specifies a unique identifier associated with the referencing type. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this attribute. + +1329. \ + +See section [5.12](#Section_8a818a7f92d0439098551a484d8f9347) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### uid + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2016/revision6 + +An ST_Guid ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.4) attribute that specifies a unique identifier associated with the referencing type. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this attribute. + +1330. \ + +See section [5.14](#Section_e47e052c40d043cdadd473a220966b69) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### uidLastSave + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2016/revision10 + +*Referenced by:* [CT_RevisionPtr](#Section_7fc8862a63f242638334b9e72b480c8e) + +An ST_Guid ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.4) attribute that SHOULD be ignored. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this attribute. + +1331. \ + +See section [5.12](#Section_8a818a7f92d0439098551a484d8f9347) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +## Complex Types + +### CT_ConditionalFormattings + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [conditionalFormattings](#Section_e5876d4c5362497fbd1ab6de4604d11c) + +The **CT_ConditionalFormattings** complex type specifies [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) information for the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +*Child Elements:* + +**conditionalFormatting:** A **CT_ConditionalFormatting** element (section [2.6.2](#Section_98f4ba7ab8f8496992a0d671d5d8ca8a)) that specifies the conditional formatting properties for a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1332. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ConditionalFormatting + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_ConditionalFormattings](#Section_ecd8b65748f7410bb856c4ad9c2fe127) + +The **CT_ConditionalFormatting** complex type specifies [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) properties for a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +*Child Elements:* + +**cfRule:** A **CT_CfRule** element (section [2.6.27](#Section_025ea6e4ad4243eaa01616f4e4688ac8)) that specifies a conditional formatting rule for this range. + +**xm:sqref:** A **sqref** element (section [2.4.5](#Section_4d7cc4156c514c718dbda2e28bdd9193)) that specifies the range this conditional formatting applies to. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**pivot:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether this conditional formatting is applied only to a [**PivotTable**](#gt_38963165-73bc-400a-a809-aff03693a316). MUST be a value from the following table. + +| Value | Meaning | +|----|----| +| "true" | The area specified by **sqref** only includes cells that are part of a PivotTable data area. | +| "false" | The area specified by **sqref** includes cells that are not part of a PivotTable data area. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1337. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DataValidations + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [dataValidations](#Section_2010725aec4746d89f7b16882cc575f6) + +**CT_DataValidations** is a complex type that specifies a group of [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) items on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). MUST contain less than or equal to 65,534 elements. This complex type also specifies data validation properties of a sheet that are used by the application UI. + +*Child Elements:* + +**dataValidation:** A **CT_DataValidation** element (section [2.6.5](#Section_89029dfc1ca84ff9afe046f9454d09c6)) that specifies the properties for a single data validation item defined on a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of the sheet. + +*Attributes:* + +**disablePrompts:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether all data validation input prompts are disabled for this sheet. + +| Value | Meaning | +|---------|----------------------------------------------------------------| +| "true" | All data validation input prompts are disabled for this sheet. | +| "false" | The data validation input prompts are enabled for this sheet. | + +**xWindow:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the x-coordinate, relative to the application window, of the upper-left corner of the data validation input prompt, measured in pixels. This value SHOULD be less than or equal to 65,535. [\<10\>](#Appendix_A_10) + +**yWindow:** An **unsignedInt** attribute that specifies the y-coordinate, relative to the application window, of the upper-left corner of the data validation input prompt, measured in pixels. This value SHOULD be less than or equal to 65,535. [\<11\>](#Appendix_A_11) + +**count:** An **unsignedInt** attribute that specifies the number of **dataValidation** child elements of this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1345. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DataValidationFormula + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_DataValidation](#Section_89029dfc1ca84ff9afe046f9454d09c6) + +**CT_DataValidationFormula** is a complex type that specifies a [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) used in [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237). + +*Child Elements:* + +**xm:f:** An **f** element (section [2.4.3](#Section_8e937c5e8b744f10bdf81d75faf211b9)) that specifies a formula for the data validation. The formula MUST adhere to the grammar provided in section [2.2.2](#Section_3d025add118d44139856ab65712ec1b0), with the following restrictions: + +- MUST NOT use the ref-infix-operator, local-cell-reference, bang-reference, bang-name, array-constant, sheet-range-reference, py-params, lambda-params , or structure-reference production rules. + +- MUST be an external-cell-reference if used by the **formula1** element of the ancestor **CT_DataValidation** element (section 2.6.5), and the **formula1** element of the ancestor **CT_DataValidation** element uses the external-cell-reference production rule, and the **type** attribute of the ancestor **CT_DataValidation** element is "list". + +- MUST NOT be an external-cell-reference that references more than one cell if used by the **formula1** element of the ancestor **CT_DataValidation** element and the **type** attribute of the ancestor **CT_DataValidation** element is not "list". + +- MUST NOT be an external-cell-reference that references more than one cell if used by the **formula2** element of the ancestor **CT_DataValidation** element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1354. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DataValidation + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_DataValidations](#Section_4ec60c5ede694d16944d7fab3e45fdff) + +**CT_DataValidation** is a complex type that specifies [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237) for a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) on this [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). + +*Child Elements:* + +**formula1:** A **CT_DataValidationFormula** element (section [2.6.4](#Section_20ed0abd113f4b8a8de3c68e733a300a)) that specifies the first [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) for the data validation. + +- If **operator** is "between" or "notBetween" and **type** is not "custom", "list", or "none", this formula is used as the lesser of two bounding values and MUST exist. + +- If **operator** is not "between" or "notBetween", or **type** is "custom", this formula is the only formula and MUST exist. + +- If **operator** is not "between" or "notBetween", or **type** is "custom" or "list", either formula is the only formula and MUST exist or **CT_DataValidation** MUST have a **list** (section [2.4.66](#Section_de43f3b85c1b4e5c96a77f18e7bcdb6c)) child element. + +- If the **type** is "none", this formula MUST NOT exist. + +**formula2:** A **CT_DataValidationFormula** element that specifies the second formula for the data validation. + +- If **operator** is "between" or "notBetween" and **type** is not "custom", "list", or "none", this formula is used as the greater of two bounding values and MUST exist. + +- If **operator** is not "between" or "notBetween", or **type** is "custom", "list", or "none", this formula MUST NOT exist. + +**xm:sqref:** A **sqref** element (section [2.4.5](#Section_4d7cc4156c514c718dbda2e28bdd9193)) that specifies ranges to which data validation is applied. + +*Attributes:* + +**type:** An **ST_DataValidationType** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.18.21) attribute that specifies the type of data validation. + +**errorStyle:** An **ST_DataValidationErrorStyle** (\[ISO/IEC29500-1:2016\] section 18.18.18) attribute that specifies the style of error alert used for this data validation. + +**imeMode:** An **ST_DataValidationImeMode** (\[ISO/IEC29500-1:2016\] section 18.18.19) attribute that specifies the [**Input Method Editor (IME)**](#gt_19d3dd70-8d6a-4847-9827-ebbde6b1a9b7) mode enforced by this data validation. + +**operator:** An **ST_DataValidationOperator** (\[ISO/IEC29500-1:2016\] section 18.18.20) attribute that specifies the relational operator used with this data validation. If **type** is "custom", "list", or "none", the value of the **operator** attribute is undefined and MUST be ignored. + +**allowBlank:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether the data validation treats empty or blank entries as valid. + +| Value | Meaning | +|---------|---------------------------------------------------------------| +| "true" | The data validation treats empty or blank entries as valid. | +| "false" | The data validation treats empty or blank entries as invalid. | + +**showDropDown:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether to display the drop-down combo box for a list type data validation. + +| Value of showDropDown | Value of type | Meaning | +|-----------------------|---------------|-------------------------------------| +| "true" | list | Displays the drop-down combo box. | +| "false" | list | Suppresses the drop-down combo box. | + +**showInputMessage:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether to display the input prompt message. + +| Value | Meaning | +|---------|------------------------------------| +| "true" | Display the input prompt message. | +| "false" | Suppress the input prompt message. | + +**showErrorMessage:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether to display the error alert message. + +| Value | Meaning | +|---------|-----------------------------------| +| "true" | Display the error alert message. | +| "false" | Suppress the error alert message. | + +**errorTitle:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the text of the title bar of the error alert. The length of this string MUST be less than or equal to 32 characters. + +**error:** An **ST_Xstring** attribute that specifies the message text of the error alert. The length of this string MUST be less than or equal to 225 characters. + +**promptTitle:** An **ST_Xstring** attribute that specifies the text of the title bar of the input prompt. The length of this string MUST be less than or equal to 32 characters. + +**prompt:** An **ST_Xstring** attribute that specifies the message text of the input prompt. This string MUST be less than or equal to 255 characters. + +**xr:uid:** An ST_Guid (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies a unique identifier associated with this data validation rule + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1359. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SparklineGroups + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [sparklineGroups](#Section_712ac8a5cad4404a9b679033bff2774a) + +**CT_SparklineGroups** is a complex type that specifies the groups of [**sparklines**](#gt_69116abb-ab9d-485a-b8b2-8042ec25033f) on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). MUST contain fewer than 231 elements. + +*Child Elements:* + +**sparklineGroup:** A **CT_SparklineGroup** element (section [2.6.7](#Section_331c1ecbe49d4cd0843d3ae189dc8a88)) that specifies properties for a single sparkline group. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1379. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SparklineGroup + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SparklineGroups](#Section_4901b440dd3b4798b0cafbf9ecaace52) + +**CT_SparklineGroup** is a complex type that specifies properties for a [**sparkline**](#gt_69116abb-ab9d-485a-b8b2-8042ec25033f) group. + +*Child Elements:* + +**colorSeries:** A **CT_Color** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies the color for each sparkline in this sparkline group. The **auto** attribute of the **CT_Color** element MUST NOT exist. + +**colorNegative:** A **CT_Color** element that specifies the color of the negative [**data points**](#gt_cf31915d-9d25-4dbb-abc7-e78f60626dc4) for each sparkline in this sparkline group. The **auto** attribute of the **CT_Color** element MUST NOT exist. + +**colorAxis:** A **CT_Color** element that specifies the color of the horizontal axis for each sparkline in this sparkline group. The **auto** attribute of the **CT_Color** element MUST NOT exist. + +**colorMarkers:** A **CT_Color** element that specifies the color of the [**data markers**](#gt_4a742a31-af1c-4e9d-a104-7c9be0f37c2b) for each sparkline in this sparkline group. The **auto** attribute of the **CT_Color** element MUST NOT exist. + +**colorFirst:** A **CT_Color** element that specifies the color of the first data point for each sparkline in this sparkline group. The **auto** attribute of the **CT_Color** element MUST NOT exist. + +**colorLast:** A **CT_Color** element that specifies the color of the last data point for each sparkline in this sparkline group. The **auto** attribute of the **CT_Color** element MUST NOT exist. + +**colorHigh:** A **CT_Color** element that specifies the color of the highest data point for each sparkline in this sparkline group. The **auto** attribute of the **CT_Color** element MUST NOT exist. + +**colorLow:** A **CT_Color** element that specifies the color of the lowest data point for each sparkline in this sparkline group. The **auto** attribute of the **CT_Color** element MUST NOT exist. + +**xm:f:** An **f** element (section [2.4.3](#Section_8e937c5e8b744f10bdf81d75faf211b9)) that specifies the date [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) for the sparkline group. The syntax, as specified in section [2.2.2](#Section_3d025add118d44139856ab65712ec1b0), for this **f** element is the following: + +1384. sparklinegroup-formula = single-sheet-area / \[single-sheet-prefix / book-prefix\] name + +Additionally, if a single-sheet-area is specified, that single-sheet-area MUST contain [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) from either a single [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) or a single [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972). + +**sparklines:** A **CT_Sparklines** element (section [2.6.8](#Section_b52ae477f11f45c183272089fb9da4c4)) that specifies properties for individual sparklines. + +*Attributes:* + +**manualMax:** A **double** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.5) attribute that specifies the maximum for the vertical axis that is shared across all sparklines in this sparkline group. This attribute MUST NOT exist if **maxAxisType** does not equal "custom". + +**manualMin:** A **double** attribute that specifies the minimum for the vertical axis that is shared across all sparklines in this sparkline group. This attribute MUST NOT exist if **minAxisType** does not equal "custom". + +**lineWeight:** A **double** attribute that specifies the line weight for each sparkline in the sparkline group, where the line weight is measured in [**points**](#gt_d072e4da-7898-4227-8f25-9fe77db43571). MUST be greater than or equal to zero, and MUST be less than or equal to 1584. + +**type:** An **ST_SparklineType** attribute (section [2.7.5](#Section_9453fe6bb0814f99b5bfce00a1b8dbf3)) that specifies the type of the sparkline group. + +**dateAxis:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether this sparkline group uses a date axis. + +| Value of dateAxis | Meaning | +|-------------------|-----------------------------------------------------| +| "false" | No date axis is specified for this sparkline group. | +| "true" | A date axis is specified for this sparkline group. | + +**displayEmptyCellsAs:** An **ST_DispBlanksAs** attribute (section [2.7.3](#Section_178769d7f69f499897702fe5ab0b65c7)) that specifies how empty cells are plotted. + +**markers:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether data markers are displayed for each sparkline in this sparkline group. + +| Value | Meaning | +|----|----| +| "true" | Data markers are displayed for each sparkline in this sparkline group. | +| "false" | No data marker is displayed for sparkline in this sparkline group. | + +**high:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the data points with the highest value are formatted differently for each sparkline in this sparkline group. + +| Value | Meaning | +|----|----| +| "true" | Data points with the highest value are formatted differently for each sparkline in this sparkline group. | +| "false" | No data point with the highest value is formatted for sparkline in this sparkline group. | + +**low:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the data points with the lowest value are formatted differently for each sparkline in this sparkline group. + +| Value | Meaning | +|----|----| +| "true" | Data points with the lowest value are formatted differently for each sparkline in this sparkline group. | +| "false" | No data point with the lowest value is formatted for sparkline in this sparkline group. | + +**first:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the first data point is formatted differently for each sparkline in this sparkline group. + +| Value | Meaning | +|----|----| +| "true" | The first data point is formatted differently for each sparkline in this sparkline group. | +| "false" | The first data point is not formatted for sparkline in this sparkline group. | + +**last:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the last data point is formatted differently for each sparkline in this sparkline group. + +| Value | Meaning | +|----|----| +| "true" | The last data point is formatted differently for each sparkline in this sparkline group. | +| "false" | The last data point is not formatted for sparkline in this sparkline group. | + +**negative:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the negative data points are formatted differently for each sparkline in this sparkline group. + +| Value | Meaning | +|----|----| +| "true" | The negative data point is formatted differently for each sparkline in this sparkline group. | +| "false" | The negative data point is not formatted for sparkline in this sparkline group. | + +**displayXAxis:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the horizontal axis is displayed for each sparkline in this sparkline group. + +| Value | Meaning | +|----|----| +| "true" | The horizontal axis is displayed for each sparkline in this sparkline group. | +| "false" | No horizontal axis is displayed for sparkline in this sparkline group. | + +**displayHidden:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether data in [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) cells are plotted for the sparklines in this sparkline group. + +| Value | Meaning | +|----|----| +| "true" | Data in hidden cells are plotted for the sparklines in this sparkline group. | +| "false" | Data in hidden cells are not plotted for the sparklines in this sparkline group. | + +**minAxisType:** An **ST_SparklineAxisMinMax** attribute (section [2.7.4](#Section_4e5a5da1d7b342048cd6ae51f1ec4e8d)) that specifies how the vertical axis minimums for the sparklines in this sparkline group are calculated. + +**maxAxisType:** An **ST_SparklineAxisMinMax** attribute that specifies how the vertical axis maximums for the sparklines in this sparkline group are calculated. + +**rightToLeft:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether each sparkline in the sparkline group is displayed in a [**right-to-left**](#gt_91359688-7863-4e88-b507-f57b3dada5ec) manner. + +| Value | Meaning | +|----|----| +| "true" | Each sparkline in the sparkline group is displayed in a right-to-left manner. | +| "false" | Not all sparklines in the sparkline group is displayed in a right-to-left manner. | + +**xr2:uid:** An ST_Guid ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.4) attribute that specifies the unique id of the sparkline group. If any instance of this type specifies this attribute, then all instances MUST specify it, and the values MUST be distinct. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1385. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Sparklines + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SparklineGroup](#Section_331c1ecbe49d4cd0843d3ae189dc8a88) + +**CT_Sparklines** is a complex type that specifies a list of individual [**sparklines**](#gt_69116abb-ab9d-485a-b8b2-8042ec25033f) in a sparkline group. MUST contain fewer than 231 elements. + +*Child Elements:* + +**sparkline:** A **CT_Sparkline** element (section [2.6.9](#Section_6b28a993e0fd451d860e35097c6baa77)) that specifies properties for an individual sparkline. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1417. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Sparkline + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_Sparklines](#Section_b52ae477f11f45c183272089fb9da4c4) + +**CT_Sparkline** is a complex type that specifies information for a single [**sparkline**](#gt_69116abb-ab9d-485a-b8b2-8042ec25033f). + +*Child Elements:* + +**xm:f:** An **f** element (section [2.4.3](#Section_8e937c5e8b744f10bdf81d75faf211b9)) that specifies the data [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) for this sparkline. The syntax, specified in section [2.2.2](#Section_3d025add118d44139856ab65712ec1b0), for this element is the following: + +1422. sparkline-formula = single-sheet-area / \[single-sheet-prefix / book-prefix\] name + +Additionally, if a single-sheet-area is specified, that single-sheet-area MUST contain [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) from either a single [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) or a single [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972). + +**xm:sqref:** A **sqref** element (section [2.4.5](#Section_4d7cc4156c514c718dbda2e28bdd9193)) that specifies the cell in which the sparkline is located. This **sqref** element MUST contain exactly one **ref** element (section [2.4.4](#Section_fd5bc8e23ec949028a8bc6179c3bb7b2)) that MUST specify exactly one cell. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1423. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_WorkbookPr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [workbookPr](#Section_f8eeeaada8b349f9903e9c4bfaff1fea) + +**CT_WorkbookPr** is a complex type that specifies additional properties for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +*Attributes:* + +**defaultImageDpi:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the resolution in which images in the workbook is saved, in DPI ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.24), when the **autoCompressPictures** attribute of the **WorkbookPr** (\[ISO/IEC29500-1:2016\] section 18.2.28) element is "true" and the **CT_UseLocalDpi** ([\[MS-ODRAWXML\]](%5bMS-ODRAWXML%5d.pdf#Section_06cff208c6e14db7bb68665135e5f0de) section 2.3.1.13) element of the drawings part (\[ISO/IEC29500-1:2016\] section 12.3.8) corresponding to the image being saved is "false". MUST be equal to "96", "150", or "220". + +**discardImageEditData:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether all **CT_Photo** (\[MS-ODRAWXML\] section 2.3.1.9) elements and cropped out areas of images in the workbook are not saved. + +| Value | Meaning | +|----|----| +| "true" | All **CT_Photo** elements and cropped out areas of images in the workbook are not saved. | +| "false" | All **CT_Photo** elements and cropped out areas of images in the workbook are saved. | + +**accuracyVersion:** An **unsignedInt** attribute that specifies how functions are calculated in the workbook. SHOULD be equal to zero ("0").[\<12\>](#Appendix_A_12) + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1429. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SlicerRefs + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [slicerList](#Section_a307ee69f90b4368855f38530bfa9b81) + +**CT_SlicerRefs** is a complex type that specifies a list of slicer (section [2.3.2](#Section_6c8a1b950c1842adbe5094771b2732f4)) part identifiers for the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). MUST contain exactly one slicer part identifier. + +*Child Elements:* + +**slicer:** A **CT_SlicerRef** element (section [2.6.12](#Section_cd47de51339f40f6b782ba2b80c44497)) that specifies the slicer part identifier for the worksheet. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1434. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SlicerRef + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SlicerRefs](#Section_02e8869ab443472181724e086c8707df) + +A complex type that specifies a [relationship](#Section_683fd4c8c16a4f74a9b4b9e6950a2139) identifier of the part that contains the [slicers](#Section_6c8a1b950c1842adbe5094771b2732f4) in this [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +*Attributes:* + +**r:id:** An **ST_RelationshipId** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.8.2.1) attribute that specifies a relationship identifier of the part that contains the slicers in this worksheet. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1439. \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SlicerCaches + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [slicerCaches](#Section_e57c958b03b44cb0b36d110ccb309516), [slicerCaches](#Section_ab381c193d574d6fa732d1d0602555ce) + +A complex type that specifies a list of [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf) part identifiers for the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). MUST contain fewer than 231 elements. + +*Child Elements:* + +**slicerCache:** A [**CT_SlicerCache**](#Section_42f75f7ac5214e4b86d30d1e1f89aa0b) element that specifies a slicer cache part identifier in this workbook. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1442. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SlicerCache + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SlicerCaches](#Section_38bbf8e13e8740e180e37b85a57d3e2a) + +A complex type that specifies a [relationship](#Section_683fd4c8c16a4f74a9b4b9e6950a2139) identifier to a [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf) part in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +*Attributes:* + +**r:id:** An **ST_RelationshipId** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.8.2.1) attribute that specifies a relationship identifier to a slicer cache part in this workbook. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1447. \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CalculatedMember + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [calculatedMember](#Section_bc43a89b8aac4a07a9fe8aeabd85d547) + +A complex type that specifies extended properties of a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) OLAP calculated member. + +*Child Elements:* + +**tupleSet:** A **CT_TupleSet** element (section [2.6.16](#Section_98e4e00bf1ab4481af5a03e5d7e73b18)) that specifies [**OLAP tuples**](#gt_3a1a687f-d28b-485b-96a0-ba0b7eb4119e) within this [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28). + +*Attributes:* + +**displayFolder:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the display folder of this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set. The length of this value MUST be less than 65,536 characters. This attribute MUST NOT exist if the **set** attribute in the ancestor **CT_CalculatedMember** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element is zero ("0"). + +**flattenHierarchies:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether to display members from different [**OLAP levels**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of the same PivotTable cache hierarchy of this **PivotTable** named set in the same **PivotTable** [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc). This attribute MUST NOT exist if the **set** attribute in the ancestor **CT_CalculatedMember** element is zero ("0"). + +| Value | Meaning | +|----|----| +| "0" | Each member from a different level of the same PivotTable cache hierarchy of this **PivotTable** named set is displayed in a separate **PivotTable** field. | +| "1" | All members from different levels of the same PivotTable cache hierarchy of this **PivotTable** named set are displayed in the same **PivotTable** field. | + +**dynamicSet:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether this **PivotTable** named set is a dynamic OLAP named set. This attribute MUST NOT exist if the **set** attribute in the ancestor **CT_CalculatedMember** element is zero ("0"). + +| Value | Meaning | +|-------|------------------------------------------------------------| +| "0" | This **PivotTable** named set is a static OLAP named set. | +| "1" | This **PivotTable** named set is a dynamic OLAP named set. | + +**hierarchizeDistinct:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether to automatically order and remove duplicates from this **PivotTable** named set. This attribute MUST NOT exist if the **set** attribute in the ancestor **CT_CalculatedMember** element is zero ("0"). + +| Value | Meaning | +|----|----| +| "0" | Do not automatically order and remove duplicates from this **PivotTable** named set. | +| "1" | Automatically order and remove duplicates from this **PivotTable** named set. | + +**mdxLong:** An **ST_Xstring** attribute that specifies [**Multidimensional Expressions (MDX)**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) of the PivotTable OLAP calculated member. The length of this attribute MUST be 0 or it MUST be greater than 32,767 characters and less than 1,073,741,823 characters. If this value is greater than 32,767 characters, the length of the **mdx** attribute in the ancestor **CT_CalculatedMember** element MUST be "1" and the first character of the **mdx** attribute MUST be equal to " ", the space character (0x0020). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1450. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TupleSet + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_CalculatedMember](#Section_2548a3c37ea94129a460dbe2ce72d045) + +A complex type that specifies an [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28). + +*Child Elements:* + +**headers:** A [**CT_TupleSetHeaders**](#Section_91bcb39c59a34bc199b4d42718a8410d) element that specifies the [**MDX unique names**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**hierarchies**](#gt_a07fc05d-cdb0-442c-984a-dd3589b9f682) and the MDX unique names of the [**OLAP levels**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) specified by this OLAP named set. + +**rows:** A [**CT_TupleSetRows**](#Section_047cacd0f30147ed845ccae7b1bdcf7d) element that specifies the [**OLAP tuples**](#gt_3a1a687f-d28b-485b-96a0-ba0b7eb4119e) specified by this OLAP named set. + +*Attributes:* + +**rowCount:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the number of OLAP tuples specified by this OLAP named set. MUST equal the number of [**CT_TupleSetRow**](#Section_b92a2103a96a413bb3e93b05efcc3c0b) elements within the **rows** element. **rowCount** \* **columnCount** MUST be less than or equal to 3,000. + +**columnCount:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the number of MDX unique names of the [**OLAP hierarchies**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) and the MDX unique names of the OLAP levels specified by this OLAP named set. MUST equal the number of [**CT_TupleSetHeader**](#Section_90af456f27004b779ed6c5605a9d918b) elements within the **headers** element. **rowCount** \* **columnCount** MUST be less than or equal to 3,000. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1460. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TupleSetHeaders + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_TupleSet](#Section_98e4e00bf1ab4481af5a03e5d7e73b18) + +A complex type that specifies the [**MDX unique names**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP hierarchies**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) and the MDX unique names of the [**OLAP levels**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of the [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28). + +*Child Elements:* + +**header: [CT_TupleSetHeader](#Section_90af456f27004b779ed6c5605a9d918b)** elements that specify the MDX unique names of the OLAP hierarchies and the MDX unique names of the OLAP levels of the OLAP named set. The number of these elements MUST be equal to the value of the **columnCount** attribute in the **CT_TupleSet** element that is the ancestor of this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1468. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TupleSetHeader + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_TupleSetHeaders](#Section_91bcb39c59a34bc199b4d42718a8410d) + +A complex type that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) and the MDX unique name of the [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of the OLAP named set that is specified by the [**CT_TupleSet**](#Section_98e4e00bf1ab4481af5a03e5d7e73b18) element that is an ancestor of this element. + +*Attributes:* + +**uniqueName:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the MDX unique name of the OLAP level. MUST be less than or equal to 65,535 characters in length. + +**hierarchyName:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the MDX unique name of the OLAP hierarchy. MUST be less than or equal to 65,535 characters in length. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1473. \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TupleSetRows + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_TupleSet](#Section_98e4e00bf1ab4481af5a03e5d7e73b18) + +A complex type that specifies the [**OLAP tuples**](#gt_3a1a687f-d28b-485b-96a0-ba0b7eb4119e) for this [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28). + +*Child Elements:* + +**row: [CT_TupleSetRow](#Section_b92a2103a96a413bb3e93b05efcc3c0b)** elements that specify the OLAP tuples for this OLAP named set. The number of these elements MUST be equal to the value of the **rowCount** attribute in the parent **CT_TupleSet** element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1477. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TupleSetRow + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_TupleSetRows](#Section_047cacd0f30147ed845ccae7b1bdcf7d) + +A complex type that specifies an [**OLAP tuple**](#gt_3a1a687f-d28b-485b-96a0-ba0b7eb4119e) for this [**OLAP named set**](#gt_8997311d-6027-4c9f-b739-9a2a00594f28). + +*Child Elements:* + +**rowItem: [CT_TupleSetRowItem](#Section_c480441b7ce2446699accdef4ec8c517)** elements that specify the [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) that are part of the OLAP tuple that is specified by this **CT_TupleSetRow** element. The number of these elements MUST be equal to value of the **columnCount** attribute in the [**CT_TupleSet**](#Section_98e4e00bf1ab4481af5a03e5d7e73b18) element that is an ancestor of this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1482. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TupleSetRowItem + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_TupleSetRow](#Section_b92a2103a96a413bb3e93b05efcc3c0b) + +A complex type that specifies an [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) that is part of an [**OLAP tuple**](#gt_3a1a687f-d28b-485b-96a0-ba0b7eb4119e). + +*Attributes:* + +**u:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of this OLAP member. MUST be less than or equal to 65,535 characters in length. + +**d:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies a display name for this OLAP member. MUST be less than or equal to 65,535 characters in length. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1487. \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SetLevels + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_CacheHierarchy](#Section_7132a6be500343d5aa6bb1f4c9ccab32) + +A complex type that specifies a list of [**CT_SetLevel**](#Section_099c64abd32d4cb687b22d2ae72a6b24) elements that specify the [**OLAP levels**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of the **PivotTable** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) named set. + +*Child Elements:* + +**setLevel:** A **CT_SetLevel** element that specifies an OLAP level of the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) cache hierarchy of the **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set. + +*Attributes:* + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the number of child **setLevel** elements of this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1491. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SetLevel + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SetLevels](#Section_eed7ca065e3f4a4489365e15200b29bb) + +A complex type that specifies an [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of the **PivotTable** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) cache hierarchy of a **PivotTable** named set. + +*Attributes:* + +**hierarchy:** An **int** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.17) attribute that specifies a reference to the PivotTable cache hierarchy. MUST be a value from the following table. + +| Value | Meaning | +|----|----| +| "-2" | The PivotTable measure cache hierarchy is used. | +| "-1" | No PivotTable cache hierarchy is used. | +| Greater than or equal to zero | A zero-based PivotTable cache hierarchy index. The referenced **CT_CacheHierarchy** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element specifies the PivotTable cache hierarchy that is used. MUST be less than the number of **CT_CacheHierarchy** elements within the **CT_CacheHierarchies** (\[ISO/IEC29500-1:2016\] section 18.10) element. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1497. \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CacheHierarchy + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [cacheHierarchy](#Section_1750517725cc4bd9a82dacba4ce35bac) + +This complex type specifies the extended properties of a **PivotTable** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) named set. When an element of this type is present, the **set** attribute of the ancestor **cacheHierarchy** element of type **CT_CacheHierarchy** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) MUST be "true". + +*Child Elements:* + +**setLevels:** A [**CT_SetLevels**](#Section_eed7ca065e3f4a4489365e15200b29bb) element that specifies the [**OLAP levels**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of the hierarchy that is used by this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set. + +*Attributes:* + +**flattenHierarchies:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether to display members from different levels of the same PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) cache hierarchy of this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set in the same **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc). MUST be "false" if **ignore** is "true". If a [**CT_CalculatedMember**](#Section_2548a3c37ea94129a460dbe2ce72d045) element that corresponds to the **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set exists, this attribute MUST be equal to the **flattenHierarchies** attribute of the **CT_CalculatedMember** element. + +| ignore | flattenHierarchies | Meaning | +|----|----|----| +| "true" | "false" | The ancestor **cacheHierarchy** element of type **CT_CacheHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) of this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set is discarded. | +| "false" | "false" | Each member from a different level of the same PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) cache hierarchy of this PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) named set is displayed in a separate PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) field. | +| "false" | "true" | All members from different levels of the same PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) cache hierarchy of this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set are displayed in the same **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) field. | + +**measuresSet:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set contains one or more PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) measure cache hierarchies. MUST be "false" if **ignore** is "true". + +| ignore | measureSet | Meaning | +|----|----|----| +| "true" | "false" | The ancestor **cacheHierarchy** element of type **CT_CacheHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) of this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set is discarded. | +| "false" | "false" | The **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set does not contain PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) measure cache hierarchies. | +| "false" | "true" | The **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set contains PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) measure cache hierarchies. | + +**hierarchizeDistinct:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether to automatically order and remove duplicates from this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set. MUST be "false" if **ignore** is "true". If a **CT_CalculatedMember** element that corresponds to the **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set exists, this attribute MUST be equal to **hierarchizeDistinct** attribute of the **CT_CalculatedMember** element. + +| ignore | hierarchizeDistinct | Meaning | +|----|----|----| +| "true" | "false" | The ancestor **cacheHierarchy** element of type **CT_CacheHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) of this PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) named set is discarded. | +| "false" | "false" | Do not automatically order and remove duplicates from this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set. | +| "false" | "true" | Automatically order and remove duplicates from this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named set. | + +**ignore:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the ancestor **cacheHierarchy** element of type **CT_CacheHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) SHOULD[\<13\>](#Appendix_A_13) be discarded. If **ignore** is "true", the ancestor **cacheHierarchy** element of type **CT_CacheHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) MUST have the following attribute values: + +| Field | Value | +|----|----| +| **measure** | "true" | +| **set** | "false" | +| **attribute** | "false" | +| **measures** | "false" | +| **oneField** | "false" | +| **time** | "false" | +| **keyAttribute** | "false" | +| **memberValueDatatype** | MUST NOT be specified. | +| **unbalanced** | MUST NOT be specified. | +| **unbalancedGroup** | MUST NOT be specified. | +| **hidden** | "false" | +| **count** | "0" | +| **parentSet** | MUST NOT be specified. | +| **dimensionUniqueName** | MUST NOT be specified. | +| **defaultMemberUniqueName** | MUST NOT be specified. | +| **allUniqueName** | MUST NOT be specified. | +| **allCaption** | MUST NOT be specified. | +| **displayFolder** | MUST NOT be specified. | +| **measureGroup** | MUST NOT be specified. | +| **uniqueName** | "Dummy*N*", where *N* is the text string representing in decimal form the zero-based index of the ancestor **CT_CacheHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) element within the group of **CT_CacheHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) elements that have a descendent **CT_CacheHierarchy** element with the **ignore** attribute equal to "true". | + +Within the **CT_CacheHierarchies** (\[ISO/IEC29500-4:2016\] section A.2) element, all **CT_CacheHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) elements that have a [**descendant**](#gt_7de6b4ca-5a0e-46fe-a50c-ab17c29487c8) **CT_CacheHierarchy** element with the **ignore** attribute equal to "true" MUST follow all other **CT_CacheHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) elements without a descendent **CT_CacheHierarchy** element or with a descendent **CT_CacheHierarchy** element with the **ignore** attribute equal to "false". + +If this attribute is "true", there MUST exist a **CT_DataField** (\[ISO/IEC29500-4:2016\] section A.2) element with an **fld** attribute equal to the zero-based index of a **CT_CacheField** (\[ISO/IEC29500-4:2016\] section A.2) element in the list of **CT_CacheField** (\[ISO/IEC29500-4:2016\] section A.2) elements specified by **CT_CacheFields** (\[ISO/IEC29500-4:2016\] section A.2) with a **hierarchy** attribute that specifies the ancestor **CT_CacheHierarchy** (\[ISO/IEC29500-4:2016\] section A.2). Additionally, that **CT_DataField** (\[ISO/IEC29500-4:2016\] section A.2) element MUST have a descendant [**CT_DataField**](#Section_9fa014b6505d4aecbaf59473e2b3dd63) element with a **sourceField** attribute specified. + +For more details, see CT_DataField. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1500. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DataField + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [dataField](#Section_c6db847cbbfd44ac9ad68165dbbb3471) + +This complex type specifies extended information about a **PivotTable** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) data [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) item (\[ISO/IEC29500-1:2016\] section 18.10.1.22). + +*Attributes:* + +**pivotShowAs:** An [**ST_PivotShowAs**](#Section_f5b294f2a16846c3b9a98e4f0132b78d) attribute that specifies the data display format for this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) data field item. If this attribute is specified, the **showDataAs** attribute of the ancestor **CT_DataField** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element MUST NOT be specified. If this attribute is equal to "percentOfParent", "percentOfRunningTotal", "rankAscending", or "rankDescending", the **baseField** attribute of the ancestor **CT_DataField** (\[ISO/IEC29500-4:2016\] section A.2) element MUST be greater than or equal to 0. + +**sourceField:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the zero-based index of the **CT_PivotField** (\[ISO/IEC29500-4:2016\] section A.2) element in the list of **CT_PivotField** (\[ISO/IEC29500-4:2016\] section A.2) elements specified by the **CT_PivotFields** (\[ISO/IEC29500-4:2016\] section A.2) element that this data item summarizes. + +If an [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118) is summarized in a PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) as a data field item (\[ISO/IEC29500-1:2016\] section 18.10.1.22) more than one time, data field items (\[ISO/IEC29500-1:2016\] section 18.10.1.22) that specify that OLAP measure after the first data field item (\[ISO/IEC29500-1:2016\] section 18.10.1.22) that specifies that OLAP measure MUST have a [**descendant**](#gt_7de6b4ca-5a0e-46fe-a50c-ab17c29487c8) **CT_DataField** element with a **sourceField** specified. + +If this attribute is specified, the **CT_PivotField** (\[ISO/IEC29500-4:2016\] section A.2) element specified by the **fld** attribute of the ancestor **CT_DataField** (\[ISO/IEC29500-4:2016\] section A.2) element MUST have a descendant [**CT_PivotField**](#Section_4af2951d0cec463db5ccc58fbfab90d8) element with an **ignore** attribute equal to "true". + +If this attribute is specified, the **CT_CacheField** (\[ISO/IEC29500-4:2016\] section A.2) element with a zero-based index in the list of **CT_CacheField** (\[ISO/IEC29500-4:2016\] section A.2) elements specified by the **CT_CacheFields** (\[ISO/IEC29500-4:2016\] section A.2) element equal to the **fld** attribute of the ancestor **CT_DataField** (\[ISO/IEC29500-4:2016\] section A.2) element that exists in the Pivot Table Cache Definition part (\[ISO/IEC29500-1:2016\] section 12.3.12) specified by the **cacheId** attribute of the **CT_PivotTableDefinition** (\[ISO/IEC29500-4:2016\] section A.2) element that is the ancestor of this element MUST have a descendant [**CT_CacheField**](#Section_8af5cdf7777449b8a5c0194bcc05a1db) element. The **CT_CacheHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) element specified by the **hierarchy** attribute of that **CT_CacheField** (\[ISO/IEC29500-4:2016\] section A.2) element MUST have a descendent [**CT_CacheHierarchy**](#Section_7132a6be500343d5aa6bb1f4c9ccab32) element with an **ignore** attribute equal to "true". The **CT_PivotHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) element with a zero-based index in the list of **CT_PivotHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) elements specified by the **CT_PivotHierarchies** (\[ISO/IEC29500-4:2016\] section A.2) element in this part that is equal to the zero-based index of that **CT_CacheHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) element in the list of **CT_CacheHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) elements specified by the **CT_CacheHierarchies** (\[ISO/IEC29500-4:2016\] section A.2) element MUST have a descendant [**CT_PivotHierarchy**](#Section_1e1a1806b12d41218e19a56224ea286f) element. + +If this attribute is specified, the **fld** attribute of the ancestor **CT_DataField** (\[ISO/IEC29500-4:2016\] section A.2) element SHOULD[\<14\>](#Appendix_A_14) be ignored. + +This attribute MUST NOT be specified for non-[**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) PivotTables (\[ISO/IEC29500-1:2016\] section 18.10). + +**uniqueName:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the unique name for duplicated OLAP measures. MUST be unique within this part. MUST be less than or equal to 65,535 characters in length. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1509. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Cfvo + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_ColorScale](#Section_f0a5263654944ff29e93224788e352ed), [CT_DataBar](#Section_88c5ca0a3a344fad8c91fdb4550d3fe1), [CT_IconSet](#Section_bbfd40cc3cc9415991f7ff1f37d93375) + +This complex type specifies a Conditional Formatting Value Object (CFVO) that specifies how to calculate a value from the [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of cells to which a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule applies. + +*Child Elements:* + +**xm:f:** An [**f**](#Section_8e937c5e8b744f10bdf81d75faf211b9) element that specifies the formula that is evaluated and compared to the [**cell value**](#gt_4d48a886-7f1d-4d41-a668-54f7f2f1a966) by the comparison method specified by **gte**. The formula MUST adhere to the grammar provided in [Formulas](#Section_3d025add118d44139856ab65712ec1b0), with the following restrictions: + +- MUST NOT use the ref-infix-operator, book-prefix, local-cell-reference, bang-reference, bang-name, array-constant, sheet-range-reference or structure-reference production rules. + +- MUST NOT use the A1-relative-column production rule except from the A1-absolute-column production rule, and it MUST NOT use the A1-relative-row production rule except from the A1-absolute-row production rule. + +- MUST NOT match the single-sheet-area production rule. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**type:** An [**ST_CfvoType**](#Section_df3812c6077a4ecd853f95e9c593ed38) attribute that specifies how the CFVO value is determined: + +- If this **CT_Cfvo** element is a child of a **CT_ColorScale** and specifies the beginning of the [**color scale**](#gt_11144129-6c0d-4ad5-ba59-59439c4747db), this attribute MUST NOT be max. + +- If this **CT_Cfvo** element is a child of a **CT_ColorScale** and specifies the end of the color scale, this attribute MUST NOT be min. + +- If this **CT_Cfvo** element is a child of a **CT_ColorScale** and specifies the midpoint of the color scale, this attribute MUST NOT be max and MUST NOT be min. + +- If this **CT_Cfvo** element is a child of a **CT_DataBar** and specifies the cell value for the min length of the [**data bar**](#gt_d8d5ab5a-ebee-45a3-bd11-2a5779bb54ed), this attribute MUST NOT be max or autoMax. + +- If this **CT_Cfvo** element is a child of a **CT_DataBar** and specifies the cell value for the max length of the data bar, this attribute MUST NOT be min or autoMin. + +- If this **CT_Cfvo** element is not a child of a **CT_DataBar**, this attribute MUST NOT be autoMin and MUST NOT be autoMax. + +- If this **CT_Cfvo** element is a child of a **CT_IconSet** record, this value MUST NOT be max or min. + +- If the value is max, min, autoMax, or autoMin, **f** MUST NOT be present. + +**gte:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether the **CT_Cfvo** will use greater-than or greater-than-or-equal-to when applying conditional formatting rules. If this **CT_Cfvo** element is a child of something other than a **CT_IconSet** element, this attribute MUST NOT be present. The value of this attribute is interpreted as follows: + +| Value | Meaning | +|----|----| +| "false" | Greater-than is used when applying conditional formatting rules. | +| "true" | Greater-than-or-equal-to is used when applying conditional formatting rules. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1514. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CfRule + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_ConditionalFormatting](#Section_98f4ba7ab8f8496992a0d671d5d8ca8a) + +This complex type specifies a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule for a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +*Child Elements:* + +**xm:f: [f](#Section_8e937c5e8b744f10bdf81d75faf211b9)** elements that specify the [**formulas**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) in the conditional formatting rule. The formulas MUST adhere to the grammar specified in [Formulas](#Section_3d025add118d44139856ab65712ec1b0), with the following restrictions: + +- The formula MUST NOT conform to the ref-infix-operator, book-prefix, local-cell-reference, array-constant, bang-reference, bang-name, sheet-range-reference, or structure-reference production rules. + +- The formula MUST NOT match the single-sheet-area production rule. + +The following table explains how to interpret the formulas. + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + +
Value of typeInterpretation of the formulas in f
cellIsf elements that specify the formulas, numeric values, or cell references that specify the operands for the ST_ConditionalFormattingOperator ([ISO/IEC29500-1:2016] section 18.18.15) specified by operator. If operator is "between" or "notBetween", f MUST contain two formulas; otherwise, f MUST contain one formula.
expressionAn f element that specifies a formula. When the formula returns zero, conditional formatting is not displayed. When the formula returns a nonzero value, conditional formatting is displayed.
colorScale, dataBar, iconSetAn f element that specifies a formula. When the formula returns zero, conditional formatting is not displayed. When the formula returns a nonzero value, or is not present, conditional formatting is displayed.

containsText, notContainsText, beginsWith,

+

endsWith,

+

containsBlanks, notContainsBlanks,

+

containsErrors,

+

notContainsErrors

An f element that specifies a formula that implements the operation specified by type. When the formula returns zero, conditional formatting is not displayed. When the formula returns a nonzero value, conditional formatting is displayed.
+ +**colorScale:** A [**CT_ColorScale**](#Section_f0a5263654944ff29e93224788e352ed) element that specifies a [**color scale**](#gt_11144129-6c0d-4ad5-ba59-59439c4747db). + +**dataBar:** A [**CT_DataBar**](#Section_88c5ca0a3a344fad8c91fdb4550d3fe1) element that specifies a [**data bar**](#gt_d8d5ab5a-ebee-45a3-bd11-2a5779bb54ed). + +**iconSet:** A [**CT_IconSet**](#Section_bbfd40cc3cc9415991f7ff1f37d93375) element that specifies an [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9). + +**dxf:** A **CT_Dxf** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies the differential formatting (\[ISO/IEC29500-1:2016\] section M.2.7.3.8) applied to the range. If **type** is "colorScale", "dataBar", or "iconSet", or the **priority** attribute does not exist, this element MUST NOT exist. + +**extLst:** A **CT_ExtensionList** (\[ISO/IEC29500-4:2016\] section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**type:** An **ST_CfType** (\[ISO/IEC29500-1:2016\] section 18.18.12) attribute that specifies the way conditional formatting is displayed in the range. + +If and only if **type** is "colorScale", a **colorScale** child element MUST exist in this element. + +If and only if **type** is "dataBar", a **dataBar** child element MUST exist in this element. + +If and only if **type** is "iconSet", an **iconSet** child element MUST exist in this element. + +**priority:** An **int** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.17) attribute that specifies the relative priority of this rule compared to the other rules in this [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d), or whether this **CT_CfRule** specifies extension information for a conditional formatting data bar rule as specified by the associated **CT_CfRule** (\[ISO/IEC29500-4:2016\] section A.2) element. MUST be greater than 0. + +If **priority** exists, rules are applied in order from the smallest **priority** to the largest **priority** and it MUST NOT duplicate a **priority** value in any other **CT_CfRule** or **CT_CfRule** (\[ISO/IEC29500-4:2016\] section A.2) element that exists in the same [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) part. + +If **priority** does not exist, this **CT_CfRule** specifies extension information for a conditional formatting data bar rule, and the dataBar child element MUST exist and describe this additional information. The **id** attribute is used to identify the associated **CT_CfRule** (\[ISO/IEC29500-4:2016\] section A.2), and the **priority** attribute of this **CT_CfRule** (\[ISO/IEC29500-4:2016\] section A.2) specifies the relative priority of this rule. If neither the **priority** attribute nor the **id** attribute exists in this element, or if **id** exists but there exists no **CT_CfRule** (\[ISO/IEC29500-4:2016\] section A.2) element containing a matching [**GUID**](#gt_f49694cc-c350-462d-ab8e-816f0103c6c1), this record and the succeeding dataBar child element MUST be ignored. If the **priority** attribute exists in this element, **id** MUST be ignored. + +**stopIfTrue:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether evaluation of additional conditional formatting rules is skipped for a cell if this rule evaluates to "true" for that cell. + +| Value | Meaning | +|----|----| +| "true" | Evaluation of additional conditional formatting rules is skipped for a cell if this rule evaluates to "true" for that cell. | +| "false" | Evaluation of additional conditional formatting rules is not skipped for a cell if this rule evaluates to "true" for that cell. | + +**aboveAverage:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the conditional formatting rule is applied to cells with values above or below the average value of other cells in the range as specified by the following table. This attribute MUST NOT exist if **type** is not equal to "aboveAverage". + +| Value | Meaning | +|----|----| +| "true" | The conditional formatting rule is applied to cells with values above the average value of all cells in the range. | +| "false" | The conditional formatting rule is applied to cells with values below the average value of all cells in the range. | + +**percent:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the conditional formatting rule is applied to a percentage of cells as specified by the following table. This attribute MUST NOT exist if **type** is not equal to "top10". + +| Value | Meaning | +|----|----| +| "true" | **rank** specifies the percentage of cells in the range to which conditional formatting is applied. | +| "false" | The conditional formatting rule is applied to the number of cells specified by **rank**. | + +**bottom:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies how the conditional formatting rule is applied as specified by the following table. This attribute MUST NOT exist if **type** is not equal to "top10". + +| Value | Meaning | +|----|----| +| "true" | Conditional formatting is applied to cells whose value is in the bottom end of the range specified by **percent** and **rank**. | +| "false" | Conditional formatting is applied to cells whose value is in the top end of the range specified by **percent** and **rank**. | + +**operator:** An **ST_ConditionalFormattingOperator** (\[ISO/IEC29500-1:2016\] section 18.18.15) attribute that specifies the type of value comparison used for this conditional formatting rule. This attribute MUST NOT exist if **type** is not equal to "cellIs". + +**text:** A **string** (\[XMLSCHEMA2/2\]section 3.2.1) attribute that specifies a text value used for this conditional formatting rule. This attribute MUST NOT exist if type is not equal to "beginsWith", "containsText", "endsWith", or "notContainsText". + +**timePeriod:** An **ST_TimePeriod** (\[ISO/IEC29500-1:2016\] section 18.18.82) attribute that specifies the time period used for this conditional formatting rule. This attribute MUST NOT exist if **type** is not equal to "timePeriod". + +**rank:** An **unsignedInt** (\[XMLSCHEMA2/2\]section 3.3.22) attribute that specifies how many cells are formatted by this conditional formatting rule. The value of **percent** specifies whether **rank** is a percentage or a quantity of cells. When **percent** is "true", **rank** MUST be greater than or equal to zero and less than or equal to 100. Otherwise, **rank** MUST be greater than or equal to 1 and less than or equal to 1,000. This attribute MUST NOT exist if **type** is not equal to "top10". + +**stdDev:** An **int** (\[XMLSCHEMA2/2\]section 3.3.17) attribute that specifies the number of standard deviations above or below the average to format in the conditional formatting rule. This attribute MUST NOT exist if **type** is not equal to "aboveAverage" or if **equalAverage** is "true". + +**equalAverage:** A **Boolean** (\[XMLSCHEMA2/2\]section 3.2.2) attribute that specifies, together with **aboveAverage**, how the conditional formatting rule is applied as specified by the following table. This attribute MUST NOT exist if **type** is not equal to "aboveAverage". + +| Value of equalAverage | Value of aboveAverage | Meaning | +|----|----|----| +| "true" | "true" | Conditional formatting is applied to cells whose value is equal to or above the average value of cells in the range. | +| "true" | "false" | Conditional formatting is applied to cells whose value is equal to or below the average value of cells in the range. | +| "false" | "true" | Conditional formatting is applied to cells whose value is above the average value of all cells in the range plus **stdDev** and multiplied by the standard deviation of all cells in the range. | +| "false" | "false" | Conditional formatting is applied to cells whose value is below the average value of all cells in the range minus **stdDev** and multiplied by the standard deviation of all cells in the range. | + +**activePresent:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that MUST be "true" if, and only if, a formula is present in **f** and **type** is "colorScale", "dataBar", or "iconSet". + +**id:** An **ST_Guid** (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that identifies this conditional formatting rule. If the priority attribute does not exist, and this attribute exists, this attribute is used to match this **CT_CfRule** element to the corresponding **CT_CfRule** (\[ISO/IEC29500-4:2016\] section A.2) element. If neither the priority attribute nor this attribute exists, this **CT_CfRule** and its child **CT_DataBar** element MUST be ignored. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1522. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_IconSet + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_CfRule](#Section_025ea6e4ad4243eaa01616f4e4688ac8) + +A complex type that specifies the properties of a [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) rule that uses an [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9). The first **cfvo** element following this element MUST be ignored. There MUST be greater than or equal to three **cfvo** elements and MUST be less than or equal to five **cfvo** elements following this complex type. + +*Child Elements:* + +**cfvo:** A [**CT_Cfvo**](#Section_15094f93f5874f4ebe741fbdc93da768) element that specifies a threshold value between each [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) in the icon set. + +**cfIcon:** A [**CT_CfIcon**](#Section_b675bf5031df4cfb918220c27126e703) element that specifies a particular icon to use within an icon set. This element MUST be present if and only if **custom** equals "true". + +*Attributes:* + +**iconSet:** An [**ST_IconSetType**](#Section_bfdf00a54e494b00880332250e1683c2) attribute that specifies the icon set used. + +**showValue:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) in the applied [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) display the icon and [**cell value**](#gt_4d48a886-7f1d-4d41-a668-54f7f2f1a966), or the icon only. + +| Value | Meaning | +|---------|------------------------------------------------| +| "true" | The icon and cell value are shown in the cell. | +| "false" | Only the icon is shown in the cell. | + +**percent:** Undefined and MUST be ignored. + +**reverse:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the icons in the icon set specified in **iconSet** are shown in reverse order. If **custom** equals "true" this value MUST be ignored. + +| Value | Meaning | +|----|----| +| "true" | The icons specified in **iconSet** are shown in reverse order. | +| "false" | The icons specified in **iconSet** are shown in the order defined by the icon set. | + +**custom:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether a custom set of icons is used. If this value is "true", there MUST be the same number of **cfIcon** elements as **cfvo** elements and the icons specified by the **cfIcon** elements are used rather than those specified by **iconSet**. If this value is "false", there MUST be 0 **cfIcon** elements. + +| Value | Meaning | +|---------|---------------------------------| +| "false" | No custom set of icons is used. | +| "true" | A custom set of icons is used. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1546. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ColorScale + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_CfRule](#Section_025ea6e4ad4243eaa01616f4e4688ac8) + +A complex type that specifies a [**color scale**](#gt_11144129-6c0d-4ad5-ba59-59439c4747db) used in [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516). + +*Child Elements:* + +**cfvo:** A [**CT_Cfvo**](#Section_15094f93f5874f4ebe741fbdc93da768) element that specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) values corresponding to the interpolation colors of the color scale. The **CT_ColorScale** MUST have either two or three child **CT_Cfvo** elements. + +If there are two child **CT_Cfvo** elements present, the first child **CT_Cfvo** element specifies the cell value corresponding to the beginning color of the color scale. The second child **CT_Cfvo** element specifies the cell value corresponding to the end color of the color scale. + +If there are three child **CT_Cfvo** elements present, the first child **CT_Cfvo** element specifies the cell value corresponding to the beginning color of the color scale. The second child **CT_Cfvo** element specifies the cell value corresponding to the midpoint color of the color scale. The third child **CT_Cfvo** element specifies the cell value corresponding to the end color of the color scale. + +**color:** A **CT_Color** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies the interpolation colors of the color scale for the **cfvo** element at the same corresponding position. The **CT_ColorScale** MUST have either two or three child **CT_Color** (\[ISO/IEC29500-4:2016\] section A.2) elements, and the number of child elements MUST equal the number of **CT_Cfvo** child elements. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1557. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DataBar + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_CfRule](#Section_025ea6e4ad4243eaa01616f4e4688ac8) + +A complex type that specifies a [**data bar**](#gt_d8d5ab5a-ebee-45a3-bd11-2a5779bb54ed) used in [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516). + +*Child Elements:* + +**cfvo:** A **CT_Cfvo** element (section [2.6.26](#Section_15094f93f5874f4ebe741fbdc93da768)) that specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) values corresponding to the min/max length of the data bar. If there exist **CT_Cfvo** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) elements in this [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) that are child elements of a **CT_DataBar** (\[ISO/IEC29500-4:2016\] section A.2) element that is a child of a **CT_CfRule** (\[ISO/IEC29500-4:2016\] section A.2) element that is a parent of a **CT_ExtensionList** (\[ISO/IEC29500-4:2016\] section A.2) element with a child **CT_Extension** (\[ISO/IEC29500-4:2016\] section A.2) element that has a child **ST_Guid** (\[ISO/IEC29500-4:2016\] section A.2) element equal to the **id** attribute of this complex type's parent **CT_CfRule** element (section 2.6.27), those **CT_Cfvo** elements SHOULD[\<15\>](#Appendix_A_15) be ignored. The first child **CT_Cfvo** element specifies the [**condition**](#gt_9a1c3bd3-d971-482a-adfe-6f41e427b95f) corresponding to the min length of the data bar. The second child **CT_Cfvo** element specifies the condition corresponding to the max length of the data bar. + +**fillColor:** A **CT_Color** (\[ISO/IEC29500-4:2016\] section A.2) element that specifies the fill color of the data bar. This element MUST exist if and only if the **priority** attribute of the **CT_CfRule** that is a parent of this complex type exists. + +**borderColor:** A **CT_Color** element that specifies the border color of the data bar. This element MUST exist if and only if **border** equals "true". + +**negativeFillColor:** A **CT_Color** element that specifies the negative fill color of the data bar. This element MUST exist if and only if **negativeBarColorSameAsPositive** equals "false". + +**negativeBorderColor:** A **CT_Color** element that specifies the negative border color of the data bar. This element MUST exist if and only if **negativeBarBorderColorSameAsPositive** equals "false" and **border** equals "true". + +**axisColor:** A **CT_Color** element that specifies the axis color of the data bar. This element MUST exist if and only if **axisPosition** does not equal "none". + +*Attributes:* + +**minLength:** An **unsignedIn**t ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the length of the shortest data bar in this conditional formatting [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99), expressed as a percentage of the width of the cell containing the data bar. MUST be greater than or equal to zero and less than or equal to **maxLength**. If, in this same [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) part, there exists a **CT_ExtensionList** element that is a descendent of a **CT_CfRule** with a child **CT_Extension** element with the child **ST_Guid** element equal to the **id** attribute of the **CT_CfRule** element that is a parent of this element, and the **minLength** attribute of this element is zero ("0") and the **maxLength** attribute of this element is "100", the **minLength** attribute of the **CT_DataBar** element that is a descendent of the **CT_CfRule** element that is a parent of the **CT_ExtensionList** element that is a parent of the **CT_Extension** element with the child **ST_Guid** element equal to the **id** attribute of the **CT_CfRule** element that is a parent of this element MUST be "10". If in this same worksheet part there exists an **CT_ExtensionList** element that is a descendent of a **CT_CfRule** with a child **CT_Extension** element with the child **ST_Guid** element equal to the **id** attribute of the **CT_CfRule** element that is a parent of this element, and the **minLength** attribute of this element is not zero ("0") or the **maxLength** attribute of this element is not "100", the **minLength** attribute of the **CT_DataBar** element that is a descendent of the **CT_CfRule** element that is a parent of the **CT_ExtensionList** element that is a parent of the **CT_Extension** element with the child **ST_Guid** element that is equal to the **id** attribute of the **CT_CfRule** element that is a parent of this element MUST be equal to this complex type’s **minLength**. + +**maxLength:** An **unsignedInt** attribute that specifies the length of the longest data bar in this conditional formatting range, expressed as a percentage of the width of the cell being formatted. MUST be greater than or equal to **minLength** and less than or equal to 100. If in this same worksheet part there exists a **CT_ExtensionList** element that is a descendent of a **CT_CfRule** with a child **CT_Extension** element with the child **ST_Guid** element equal to the **id** attribute of the **CT_CfRule** element that is a parent of this element, and the **minLength** attribute of this element is zero ("0") and the **maxLength** attribute of this element is "100", the **maxLength** attribute of the **CT_DataBar** element that is a descendent of the **CT_CfRule** element that is a parent of the **CT_ExtensionList** element that is a parent of the **CT_Extension** element with the child **ST_Guid** element that is equal to the **id** attribute of the **CT_CfRule** element that is a parent of this element MUST be "90". If, in this same worksheet part, there exists a **CT_ExtensionList** element that is a descendent of a **CT_CfRule** with a child **CT_Extension** element with the child **ST_Guid** element equal to the **id** attribute of the **CT_CfRule** element that is a parent of this element, and the **minLength** attribute of this element is not zero ("0") or the **maxLength** attribute of this element is not "100", the **maxLength** attribute of the **CT_DataBar** element that is a descendent of the **CT_CfRule** element that is a parent of the **CT_ExtensionList** element that is a parent of the **CT_Extension** element with the child **ST_Guid** element that is equal to the **id** attribute of the **CT_CfRule** element that is a parent of this element MUST be equal to this record’s **maxLength**. + +**showValue:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the cells in the conditional formatting range display both the data bar and the numeric value or only the data bar. The following table describes its possible values. + +| Value | Meaning | +|----|----| +| "false" | Only the data bar is displayed in the cell. | +| "true" | Both the data bar and the numeric value are displayed in the cell. | + +**border:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the data bar has a border. + +| Value | Meaning | +|---------|-----------------------------| +| "true" | The data bar has a border. | +| "false" | The data bar has no border. | + +**gradient:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the data bar has a gradient fill. The following table describes its possible values. + +| Value | Meaning | +|---------|-------------------------------------| +| "false" | The data bar fill is a solid color. | +| "true" | The data bar fill is a gradient. | + +**direction:** An **ST_DataBarDirection** attribute section [2.7.7](#Section_5285654b5cc54ba4a760bb242a6ccd82)) that specifies the direction of the data bar. + +**negativeBarColorSameAsPositive:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the data bar has a negative bar color that is different from the positive bar color. + +**negativeBarBorderColorSameAsPositive:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the data bar has a negative border color that is different from the positive border color. + +**axisPosition:** An **ST_DataBarAxisPosition** attribute (section [2.7.8](#Section_d24197f818984de98acfc2bedbd31736)) that specifies the axis position for the data bar. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1563. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotField + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [pivotField](#Section_86b2cf566d544920931e360387c3e7a6) + +This complex type specifies additional properties of a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc). + +*Attributes:* + +**fillDownLabels:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) item labels are repeated for this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) field. This attribute is ignored when the **compact** attribute and the **outline** attribute of the **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) field are "true". This attribute is ignored if the **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) field is not on the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) axis or the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) axis. This value MUST be one of the following: + +| Value | Meaning | +|---------|----------------------------------------------------| +| "false" | The item labels are not repeated. | +| "true" | The item labels are repeated for each nested item. | + +**ignore:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) field SHOULD[\<16\>](#Appendix_A_16) be ignored. + +If this attribute is "true", the ancestor **CT_PivotField** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) MUST have only the following attributes specified, and these attributes MUST have the following values. + +| Name | Value | +|-----------------------------|---------| +| **compact** | "false" | +| **dataField** | "true" | +| **defaultSubtotal** | "false" | +| **dragOff** | "false" | +| **dragToCol** | "false" | +| **dragToData** | "false" | +| **dragToPage** | "false" | +| **dragToRow** | "false" | +| **includeNewItemsInFilter** | "true" | +| **itemPageCount** | "false" | +| **outline** | "false" | +| **showAll** | "false" | +| **subtotalTop** | "false" | +| **topAutoShow** | "false" | + +If this attribute is equal to "true", there MUST exist a **CT_DataField** (\[ISO/IEC29500-4:2016\] section A.2) element with an **fld** attribute that specifies this PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) field. Additionally, that **CT_DataField** (\[ISO/IEC29500-4:2016\] section A.2) element MUST have a [**descendant**](#gt_7de6b4ca-5a0e-46fe-a50c-ab17c29487c8) [**CT_DataField**](#Section_9fa014b6505d4aecbaf59473e2b3dd63) element with a **sourceField** attribute specified. + +For more details, see CT_DataField. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1582. \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotTableDefinition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [pivotTableDefinition](#Section_027c658596e24b7c9a8a02470415ac4a) + +This element specifies additional properties of a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) view. + +*Child Elements:* + +**pivotEdits:** A [**CT_PivotEdits**](#Section_52f5f3e69d9e44ee86abacbed02f4759) element that specifies a collection of [PivotTable What-if Analysis](#Section_9d7f085695a646b59af10e75dba0beb9) edits. + +**pivotChanges:** A [**CT_PivotChanges**](#Section_5232ab016308401f9900b8dd759a3aee) element that specifies a collection of PivotTable What-if Analysis changes. + +**conditionalFormats:** A [**CT_ConditionalFormats**](#Section_e64b925747154282b17e158dd5363cf8) element that specifies a collection of conditional formats applied to the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view. + +*Attributes:* + +**fillDownLabelsDefault:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies the behavior of **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) [**fields**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) that are not a part of the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view if they are later added to a PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view. MUST be a value from the following table. + +| Value | Meaning | +|----|----| +| "false" | Specifies that **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) fields added to the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view behave as if the **fillDownLabels** attribute of the [**CT_PivotField**](#Section_4af2951d0cec463db5ccc58fbfab90d8) elements associated with those **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) fields are set to "false". | +| "true" | Specifies that **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) fields added to the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view behave as if the **fillDownLabels** attribute of the **CT_PivotField** elements associated with those **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) fields are set to "true". | + +**visualTotalsForSets:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) items will be included when calculating totals for **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) named sets. MUST be a value from the following table. + +| Value | Meaning | +|----|----| +| "false" | Include hidden PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) items in the set totals. | +| "true" | Do not include hidden PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) items in the set totals. | + +**calculatedMembersInFilters:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) OLAP-calculated members participate in PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) manual filters and PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) advanced filters. + +| Value | Meaning | +|----|----| +| "false" | PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) OLAP-calculated members do not participate in PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) manual filters and PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) advanced filters. | +| "true" | PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) OLAP-calculated members participate in PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) manual filters and PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) advanced filters as do other PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) items. | + +**altText:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the alternate text for the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view. The string MUST be less than or equal to 2,000 characters in length. + +**altTextSummary:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the alternate text summary for the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view. This string MUST be less than or equal to 2,000 characters in length. + +**enableEdit:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether PivotTable what-if analysis is enabled for the current PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view. + +**autoApply:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether PivotTable what-if analysis values are automatically allocated. + +**allocationMethod:** An [**ST_AllocationMethod**](#Section_5fe752fbf15047be9a989cb94e4d2543) attribute that specifies the allocation method to use for PivotTable what-if analysis. + +**weightExpression:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the [**Multidimensional Expressions (MDX)**](#gt_9b631ff5-dc89-45f0-a1c2-db6981e4804f) of the weight expression for weighted allocations of PivotTable what-if analysis values. This string MUST be less than or equal to 65,535 characters in length. + +**hideValuesRow:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the values [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) in the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) report is visible. + +| Value | Meaning | +|----|----| +| "false" | The values row in the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) report is visible. | +| "true" | The values row in the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) report is not visible. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1586. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotCacheDefinition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [pivotCacheDefinition](#Section_f320536cead5481ca93c9bdbfe6e6825) + +A complex type that specifies the extended properties of a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) **PivotCache** definition. + +*Attributes:* + +**slicerData:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether the [Slicer Cache Relationship to PivotCache](#Section_2a393f8521f94a27a2b74867223f4b9a). MUST be "true" if the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) **PivotCache** definition is being referenced by a [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). + +**pivotCacheId:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute which uniquely identifies this PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache. The value MUST be greater than or equal to 0. The value MUST NOT be 0 if there is a slicer cache that uses this PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache as a [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075), or if there is a [CT_PivotCacheIdVersion](#Section_9cc2fc49e4d24dbea98b061c5ef85033) element that is preceded by this element. + +**supportSubqueryNonVisual:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the OLAP [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0) of this PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) supports [**hidden**](#gt_6928fba3-3deb-453c-82ed-ecac33026ffd) PivotTable items. + +**supportSubqueryCalcMem:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the OLAP source data of this PivotTable supports PivotTable calculated members in an [**OLAP subselect**](#gt_e175812d-2cda-49e5-8352-ec071d8dc47a) for filtering. + +| Value | Meaning | +|----|----| +| "true" | The OLAP source data of this PivotTable supports PivotTable calculated members in an OLAP subselect for filtering. | +| "false" | The OLAP source data of this PivotTable does not support PivotTable calculated members in an OLAP subselect for filtering. | + +**supportAddCalcMems:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) calculated members are shown for filtering. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1603. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Connection + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [connection](#Section_76651adb815a4c0a93b305f1361a4f86) + +A complex type that specifies the extended properties of an external connection ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.13). + +*Child Elements:* + +**calculatedMembers:** A **CT_CalculatedMembers** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies a list of PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) OLAP-calculated members associated with this external connection (\[ISO/IEC29500-1:2016\] section 18.13). If this external connection (\[ISO/IEC29500-1:2016\] section 18.13) is associated with a PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache, the list MUST NOT exist. If this element exists, the ancestor **CT_connection** (\[ISO/IEC29500-4:2016\] section A.2) element of this element MUST have a child **CT_OlapPr** (\[ISO/IEC29500-1:2016\] section 18.13.5) element. + +*Attributes:* + +**culture:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the language associated with this external connection (\[ISO/IEC29500-1:2016\] section 18.13). The length of this string MUST be less than 85 characters. If the length of this string is greater than 0, the contents of this string SHOULD[\<17\>](#Appendix_A_17) be a language tag as specified by [\[RFC3066\]](https://go.microsoft.com/fwlink/?LinkId=90404). If this attribute is not present, the [**data connection**](#gt_024a24fb-c1c0-4393-ab0c-f0e3e3f41629) is using the server language. + +**embeddedDataId:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies an embedded [Custom Data](#Section_7c53f6f4fea843f7a4b0ba6e14d0eb78) part. The length of this value MUST be less than 65,536 characters. If the length of this string is greater than 0, the contents of this string MUST be equal to the **id** attribute of a [**CT_DatastoreItem**](#Section_e570efaded61465ba1d2aab8529953ca) element, in a [Custom Data Properties](#Section_1f4aa666c9664ecf839928390399c891) part in this package (\[ISO/IEC29500-1:2016\] section 9). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1610. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Table + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [table](#Section_53d30645b319490bb980afb5ac17f31b) + +A complex type that specifies alternate text properties for the table. + +*Attributes:* + +**altText:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the alternate text for the table. The string MUST be less than or equal to 25,000 characters in length. + +**altTextSummary:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the alternate text summary for the table. The string MUST be less than or equal to 50,000 characters in length. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1617. \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CfIcon + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_IconSet](#Section_bbfd40cc3cc9415991f7ff1f37d93375) + +A complex type that specifies a single [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) of an [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9). + +*Attributes:* + +**iconSet:** An [**ST_IconSetType**](#Section_bfdf00a54e494b00880332250e1683c2) attribute that specifies the icon set. + +**iconId:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the icon to be used. If the icon set specified by **iconSet** has three icons, this value MUST be less than or equal to 2. If the icon set specified by **iconSet** has four icons, this value MUST be less than or equal to 3. If the icon set specified by **iconSet** has five icons, this value MUST be less than or equal to 4. If **iconSet** equals "NoIcons", this value MUST be 0. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1621. \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotEdits + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_PivotTableDefinition](#Section_4fa0ac531c40475fad76d06c604df3e3) + +A complex type that specifies user inputs related to [PivotTable what-if analysis](#Section_9d7f085695a646b59af10e75dba0beb9) in single [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) of the PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) data area. It also specifies the collections of [**MDX unique names**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) that identify the values in the **[OLAP](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [data source](#gt_e091613c-6901-4874-b9b2-27273ead1075)**, and specifies the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) rules that can be used to identify the cells in the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) data area. + +*Child Elements:* + +**pivotEdit:** A [**CT_PivotEdit**](#Section_0e2c9edbfb384b33950fcabfdbd9b189) element that specifies user input, related to PivotTable what-if analysis, in a single cell of the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) data area, and specifies the collection of MDX unique names that identifies the value in the OLAP data source, and specifies a PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) rule that can be used to identify the cell in the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) data area. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1625. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotEdit + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_PivotEdits](#Section_52f5f3e69d9e44ee86abacbed02f4759) + +A complex type that specifies user input, related to [PivotTable what-if analysis](#Section_9d7f085695a646b59af10e75dba0beb9), in a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) of the PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) data area. + +*Child Elements:* + +**userEdit:** A [**CT_PivotUserEdit**](#Section_c05d26ce4237405ab8a4429b62ad7642) element that specifies the user input value or [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169) that replaces the original cell value, in a single cell of the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) data area. + +**tupleItems:** A [**CT_TupleItems**](#Section_e25f1558b7a94f0ca3d1819b6df8978c) element that specifies the [**MDX unique names**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) that identify the value in the **[OLAP](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [data source](#gt_e091613c-6901-4874-b9b2-27273ead1075)** that was changed using PivotTable what-if analysis. + +**pivotArea:** A **CT_PivotArea** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies a PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) rule that can be used to identify the cell in the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) data area. + +**extLst:** A **CT_ExtensionList** (\[ISO/IEC29500-4:2016\] section A.2) that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1630. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotChanges + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_PivotTableDefinition](#Section_4fa0ac531c40475fad76d06c604df3e3) + +A complex type that specifies the values used for [PivotTable what-if analysis](#Section_9d7f085695a646b59af10e75dba0beb9) calculations and specifies the allocation methods for how to apply the values. It also specifies the collections of [**MDX unique names**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) that identify the original values in the **[OLAP](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [data source](#gt_e091613c-6901-4874-b9b2-27273ead1075)** that were changed. + +*Child Elements:* + +**pivotChange:** A [**CT_PivotChange**](#Section_dcf52159107344fcbbc41f2510b60283) element that specifies the value used for PivotTable what-if analysis calculation and specifies the allocation method for how to apply the value. It also specifies a collection of MDX unique names that identifies the original value in the OLAP data source that was changed. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1638. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotChange + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_PivotChanges](#Section_5232ab016308401f9900b8dd759a3aee) + +A complex type that specifies the value used for [PivotTable what-if analysis](#Section_9d7f085695a646b59af10e75dba0beb9) calculation and specifies the allocation method for how to apply the value. It also specifies a collection of [**MDX unique names**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) that identifies the original value in the **[OLAP](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [data source](#gt_e091613c-6901-4874-b9b2-27273ead1075)** that was changed. + +*Child Elements:* + +**editValue:** A [**CT_PivotEditValue**](#Section_fc28f146d73a46f6bf4c282fc9a960ef) element that specifies the value that replaces the original value in the OLAP data source for the PivotTable what-if analysis. + +**tupleItems:** A [**CT_TupleItems**](#Section_e25f1558b7a94f0ca3d1819b6df8978c) element that specifies the MDX unique names that identify the value in the OLAP data source that was changed using PivotTable what-if analysis. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) that specifies future extensibility for this element. + +*Attributes:* + +**allocationMethod:** An [**ST_AllocationMethod**](#Section_5fe752fbf15047be9a989cb94e4d2543) attribute that specifies the allocation method, used by PivotTable what-if analysis, to change the value in the OLAP data source. + +**weightExpression:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the [**OLAP weight expression**](#gt_d7c8e1f1-6b98-48ea-92a2-b9c795ce8272) for PivotTable what-if analysis. The **weightExpression** MUST NOT exist if **allocationMethod** equals equalAllocation or equals equalIncrement. The **weightExpression** MUST be greater than or equal to 0 and less than or equal to 65,535 characters in length. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1643. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotUserEdit + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_PivotEdit](#Section_0e2c9edbfb384b33950fcabfdbd9b189) + +A complex type that specifies user input, related to [PivotTable what-if analysis](#Section_9d7f085695a646b59af10e75dba0beb9), in a single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) of the PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) data area. + +*Child Elements:* + +**xm:f:** An [**f**](#Section_8e937c5e8b744f10bdf81d75faf211b9) element that specifies a [**formula**](#gt_f9d85460-6133-492b-9b3d-730bf40e5169). The formula MUST adhere to the grammar provided in [Formulas](#Section_3d025add118d44139856ab65712ec1b0), with the following restriction: The **formula** MUST NOT use the bang-reference or bang-name production rules. + +**editValue:** A [**CT_PivotEditValue**](#Section_fc28f146d73a46f6bf4c282fc9a960ef) element that specifies the user input value that replaces the original cell value, in a single cell of the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) data area. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1652. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotEditValue + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_PivotUserEdit](#Section_c05d26ce4237405ab8a4429b62ad7642), [CT_PivotChange](#Section_dcf52159107344fcbbc41f2510b60283) + +A complex type that specifies the value type of the user input in the single [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) of the PivotTable, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, data area, or value type of the value that replaces the original value in the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for PivotTable what-if analysis, as specified in section [2.3.1](#Section_9d7f085695a646b59af10e75dba0beb9). + +*Attributes:* + +**valueType:** An **ST_PivotEditValueType** attribute, as specified in section [2.7.11](#Section_38d6aca0c6094ab6a0341490ef67118a), that specifies the type of the value of the user input or the type of the value that replaces the original value in the OLAP data source. + +The length of the string MUST be greater than zero and MUST be less than 32,768 characters. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1658. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TupleItems + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_PivotEdit](#Section_0e2c9edbfb384b33950fcabfdbd9b189), [CT_PivotChange](#Section_dcf52159107344fcbbc41f2510b60283) + +A complex type that specifies the [**MDX unique names**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) that identify the value in the **[OLAP](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [data source](#gt_e091613c-6901-4874-b9b2-27273ead1075)** using PivotTable what-if analysis, as specified in section [2.3.1](#Section_9d7f085695a646b59af10e75dba0beb9). + +*Child Elements:* + +**tupleItem:** An **ST_Xstring** element, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19, that specifies an MDX unique name. The number of these elements MUST be greater than zero and MUST be less than 2^31. The length of each **ST_Xstring** MUST be greater than zero and MUST be less than or equal to 65,535 characters. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1665. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SlicerStyle + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SlicerStyles](#Section_96cced63cce742b3af304168cc322c29) + +**CT_SlicerStyle** specifies table style elements, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8, of the slicer style, as specified in section [2.3.2.4](#Section_c27949e2eac54d889655187392cab0aa), that are specific to slicers, as specified in section [2.3.2](#Section_6c8a1b950c1842adbe5094771b2732f4). + +*Child Elements:* + +**slicerStyleElements:** A **CT_SlicerStyleElements**, as specified in section [2.6.52](#Section_7356c6de5c8742e783d690772f2ed5e1), that specifies table style elements of the slicer style that are specific to slicers. There MUST NOT be more than one **CT_SlicerStyleElements** in this element. + +*Attributes:* + +**name:** A **string** attribute, as specified in [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1, that specifies the name of the user-defined table style that this slicer style is based upon. The length of the **string** MUST be greater than or equal to 1 character and less than or equal to 255 characters. This **string** MUST be unique within the **CT SlicerStyle** elements in the **Styles** part, as specified in \[ISO/IEC29500-1:2016\] section 12.3.20. This **string** MUST match the **name** attribute of a **CT_TableStyle** element, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, in the **Styles** part. In the **CT_TableStyle** element with a **name** attribute that matches this **string**, the **pivot** attribute MUST equal "false" and the **table** attribute MUST equal "false". + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1670. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SlicerStyleElement + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SlicerStyleElements](#Section_7356c6de5c8742e783d690772f2ed5e1) + +A complex type that specifies a table style element, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8, of a slicer style, as specified in section [2.3.2.4](#Section_c27949e2eac54d889655187392cab0aa). + +*Attributes:* + +**type:** An **ST_SlicerStyleType** attribute, as specified in section [2.7.13](#Section_e4cb15be9205493e93645290a65f3d79), that specifies the type of the table style element. This attribute MUST be unique within the parent **CT_SlicerStyleElements** complex type. + +**dxfId:** An **ST_DxfId** attribute, as specified in \[ISO/IEC29500-1:2016\] section 18.18.25, that specifies a zero-based index for the list of elements specified by the **dxfs** global element, as specified in section [2.4.24](#Section_fc75d7f642f34297b55e05f518059cf6). The specified **CT_Dxf** complex type, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, specifies the formatting to use with this table style element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1676. \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_OleItem + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [oleItem](#Section_ad3b01a6c1684c52af17d42325df6b3f) + +**OleItem** is a complex type that specifies an OLE data item, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.14, with associated cached values. + +*Child Elements:* + +**values:** A **CT_DdeValues** element, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, that specifies the cached values. + +*Attributes:* + +**name:** An **ST_Xstring** attribute, as specified in \[ISO/IEC29500-1:2016\] section 22.9.2.19, that specifies the name of the OLE data item. + +**icon:** A **Boolean** attribute, as specified in [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2, that specifies whether the OLE data item is represented as an icon. + +| Value | Meaning | +|---------|--------------------------------------------------| +| "false" | The OLE data item is not represented as an icon. | +| "true" | The OLE data item is represented as an icon. | + +**advise:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the application requests that the [**OLE**](#gt_171744b8-3f44-4198-b7b9-1c0147282d2c) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075), as specified in \[ISO/IEC29500-1:2016\] section 18.14, provides notifications when the [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0) changes. + +| Value | Meaning | +|----|----| +| "false" | The application does not request to be notified when the source data changes. | +| "true" | The application requests to be notified when the source data changes. | + +**preferPic:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the OLE data item is an image. + +| Value | Meaning | +|---------|------------------------------------| +| "false" | The OLE data item is not an image. | +| "true" | The OLE data item is an image. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1680. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotHierarchy + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [pivotHierarchy](#Section_b49c750881934e7da299f481d8c125a8) + +A complex type that specifies whether the ancestor **CT_PivotHierarchy** element, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, SHOULD[\<18\>](#Appendix_A_18) be ignored. + +The ancestor **CT_PivotHierarchy** element has the following restrictions on attributes. + +| Name | Value | +|----------------------------------|------------------------| +| **caption** | MUST NOT be specified. | +| **dragOff** | MUST equal "false". | +| **dragToCol** | MUST equal "false". | +| **dragToData** | MUST equal "true". | +| **dragToPage** | MUST equal "false". | +| **dragToRow** | MUST equal "false". | +| **includeNewItemsInFilter** | MUST equal "true". | +| **multipleItemSelectionAllowed** | MUST NOT be specified. | +| **outline** | MUST NOT be specified. | +| **showInFieldList** | MUST NOT be specified. | +| **subtotalTop** | MUST NOT be specified. | + +The ancestor **CT_PivotHierarchy** element has the following restrictions on child elements. + +| Child element | Restriction | +|----|----| +| **CT_PivotHierarchy** (this element) | Exactly 1 MUST exist. | +| **CT_Members** (\[ISO/IEC29500-4:2016\] section A.2) | MUST NOT exist. | +| **CT_MemberProperties** (\[ISO/IEC29500-4:2016\] section A.2) | MUST NOT exist. | + +If this element exists, there MUST exist a **CT_DataField** element, as specified in \[ISO/IEC29500-4:2016\] section A.2, with an **fld** attribute equal to the zero-based index of a **CT_CacheField** element, as specified in \[ISO/IEC29500-4:2016\] section A.2, in the list of **CT_CacheField** elements specified by **CT_CacheFields**, as specified in \[ISO/IEC29500-4:2016\] section A.2, with a **hierarchy** attribute that specifies a **CT_CacheHierarchy**, as specified in \[ISO/IEC29500-4:2016\] section A.2, with a zero-based index in the list of **CT_CacheHierarchy** elements specified by the **CT_CacheHierarchies** element, as specified in(\[ISO/IEC29500-4:2016\] section A.2, equal to the zero-based index of the ancestor **CT_PivotHierarchy** element in the list of **CT_PivotHierarchy** elements specified by **CT_PivotHierarchies**, as specified in \[ISO/IEC29500-4:2016\] section A.2. Additionally, that **CT_DataField** element MUST have a [**descendant**](#gt_7de6b4ca-5a0e-46fe-a50c-ab17c29487c8) **CT_DataField** element, as specified in section [2.6.25](#Section_9fa014b6505d4aecbaf59473e2b3dd63), with a **sourceField** attribute specified. + +For more details, see section 2.6.25. + +*Attributes:* + +**ignore:** A **Boolean** attribute, as specified in [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2, that MUST be "true" and MUST be ignored. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1689. \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CacheField + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [cacheField](#Section_a7483bc6b6f5424e9a4c805d42af8713) + +This complex type specifies the ancestor **CT_CacheField** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that SHOULD[\<19\>](#Appendix_A_19) be ignored. + +The following table lists the restrictions on attributes of the ancestor **CT_CacheField** element. + +| Name | Value | +|-------------------------|------------------------| +| **caption** | MUST NOT be specified. | +| **databaseField** | MUST NOT be specified. | +| **formula** | MUST NOT be specified. | +| **level** | MUST equal "32767". | +| **mappingCount** | MUST NOT be specified. | +| **memberPropertyField** | MUST NOT be specified. | +| **numFmtId** | MUST equal zero ("0"). | +| **propertyName** | MUST NOT be specified. | +| **serverField** | MUST NOT be specified. | +| **sqlType** | MUST NOT be specified. | +| **uniqueList** | MUST NOT be specified. | + +The following table lists the restrictions on child elements of the ancestor **CT_CacheField** element. + +| Child element | Restriction | +|----|----| +| **CT_CacheField** (this element) | Exactly 1 MUST exist. | +| **CT_FieldGroup** (\[ISO/IEC29500-4:2016\] section A.2) | MUST NOT exist. | +| **CT_X** (\[ISO/IEC29500-4:2016\] section A.2) | MUST NOT exist. | +| **CT_SharedItems** (\[ISO/IEC29500-4:2016\] section A.2) | MUST NOT exist. | + +If this element exists, there MUST exist a **CT_DataField** (\[ISO/IEC29500-4:2016\] section A.2) element with an **fld** attribute equal to the zero-based index of the ancestor **CT_CacheField** element in the list of **CT_CacheField** elements specified by **CT_CacheFields** (\[ISO/IEC29500-4:2016\] section A.2). Additionally, that **CT_DataField** element MUST have a [**descendant**](#gt_7de6b4ca-5a0e-46fe-a50c-ab17c29487c8) **CT_DataField** element (section [2.6.25](#Section_9fa014b6505d4aecbaf59473e2b3dd63)) with a **sourceField** attribute specified. + +For more details, see CT_DataField + +*Attributes:* + +**ignore:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that MUST be "true" and MUST be ignored. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1692. \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ConditionalFormats + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_PivotTableDefinition](#Section_4fa0ac531c40475fad76d06c604df3e3) + +This complex type specifies a collection of conditional formats applied to the PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) view. + +*Child Elements:* + +**conditionalFormat:** A [**CT_ConditionalFormat**](#Section_abfd5696a65146eead852810c984cc3c) element that specifies the [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) applied to the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view. + +*Attributes:* + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the number of **conditionalFormat** child elements of this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1695. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ConditionalFormat + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_ConditionalFormats](#Section_e64b925747154282b17e158dd5363cf8) + +This complex type specifies the scope, type, and priority of [**conditional formatting**](#gt_5a8a1e18-9f8c-48c6-9ad0-7975ade8d516) applied to this [**PivotTable**](#gt_38963165-73bc-400a-a809-aff03693a316) ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) view. + +*Child Elements:* + +**pivotAreas:** A **CT_PivotAreas** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies a set of PivotTable areas this conditional formatting applies to. + +**extLst:** A **CT_ExtensionList** (\[ISO/IEC29500-4:2016\] section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**scope:** An **ST_Scope** (\[ISO/IEC29500-1:2016\] section 18.18.67) attribute that specifies the scope of this conditional formatting. + +**type:** An **ST_Type** (\[ISO/IEC29500-1:2016\] section 18.18.84) attribute that MUST NOT be present or MUST be equal to "none". + +**priority:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the priority of the PivotTable conditional formatting. This value MUST be greater than or equal to 1. If this attribute is present, there MUST exist a [**CT_CfRule**](#Section_025ea6e4ad4243eaa01616f4e4688ac8) with a **priority** attribute equal to the value of this [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) and it MUST be the same **CT_CfRule** element that is specified by **id**. The **CT_CfRule** specified by this value MUST have an ancestor [**CT_ConditionalFormatting**](#Section_98f4ba7ab8f8496992a0d671d5d8ca8a) element with a **pivot** attribute equal to "true". + +**id:** An **ST_Guid** (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies a particular **CT_CfRule**. There MUST exist a **CT_CfRule** with an **id** attribute equal to this value and it MUST be the same **CT_CfRule** element that is specified by **priority**. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1701. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SlicerStyles + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [slicerStyles](#Section_00880b6a96b74718bf4a1212828217e4) + +A complex type that specifies a group of [slicer styles](#Section_c27949e2eac54d889655187392cab0aa) and the default slicer style to apply to [slicers](#Section_6c8a1b950c1842adbe5094771b2732f4). + +*Child Elements:* + +**slicerStyle:** A [CT_SlicerStyle](#Section_f58e45aaf570456cb08710b48fce4878) element that specifies a slicer style. + +*Attributes:* + +**defaultSlicerStyle:** A **string** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that specifies the name of the default slicer style to apply to slicers. The length of the string MUST be greater than or equal to 1 character and less than or equal to 255 characters. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1711. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SlicerStyleElements + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SlicerStyle](#Section_f58e45aaf570456cb08710b48fce4878) + +A complex type that specifies the list of table style ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8) elements of a [slicer style](#Section_c27949e2eac54d889655187392cab0aa) that are specific to [slicers](#Section_6c8a1b950c1842adbe5094771b2732f4). + +*Child Elements:* + +**slicerStyleElement:** A [**CT_SlicerStyleElement**](#Section_b005a2aa3157442fbec6bfe0186e1359) element that specifies a table style (\[ISO/IEC29500-1:2016\] section 18.8) element of a slicer style that is specific to slicers. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1717. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_IgnoredErrors + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [ignoredErrors](#Section_0d164d8523bf4d4387c59fcde148aabe) + +A complex type that specifies a list of **[cell](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) [ranges](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99)** and the types of cell errors that are to be ignored for each of those specific cell ranges. + +*Child Elements:* + +**ignoredError:** A [**CT_IgnoredError**](#Section_20e3a54065ec47c4aa4c44677306292c) element that specifies the types of cell errors that are to be ignored for a specific cell range. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1722. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_IgnoredError + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_IgnoredErrors](#Section_a7b2a906d0ec4b5b80ce5fb0f838f544) + +A complex type that specifies the types of [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) errors that are to be ignored for a specific cell [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). This complex type is equivalent to **CT_IgnoredError** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.3.1.50), but allows the **sqref** child element to have greater than or equal to 8,192 [ref](#Section_fd5bc8e23ec949028a8bc6179c3bb7b2) child elements. + +*Child Elements:* + +**xm:sqref:** A [**sqref**](#Section_4d7cc4156c514c718dbda2e28bdd9193) element that specifies the range where cell errors have been ignored. This **sqref** MUST have greater than or equal to 8,192 **ref** child elements. + +*Attributes:* + +**evalError:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether to ignore calculation errors. + +| Value | Meaning | +|---------|-----------------------------------| +| "true" | Ignore calculation errors. | +| "false" | Do not ignore calculation errors. | + +**twoDigitTextYear:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether to ignore errors arising from the formatting of date/time values. + +| Value | Meaning | +|----|----| +| "true" | Ignore errors arising from the formatting of data/time values. | +| "false" | Do not ignore errors arising from the formatting of date/time values. | + +**numberStoredAsText:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether to ignore errors arising from the formatting of numeric values. + +| Value | Meaning | +|----|----| +| "true" | Ignore errors arising from the formatting of numeric values. | +| "false" | Do not ignore errors arising from the formatting of numeric values. | + +**formula:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether to ignore errors arising from formulas that are inconsistent with formulas (\[ISO/IEC29500-1:2016\] section 18.17) in neighboring cells. + +| Value | Meaning | +|----|----| +| "true" | Ignore errors arising from formulas that are inconsistent with formulas (\[ISO/IEC29500-1:2016\] section 18.17) in neighboring cells. | +| "false" | Do not ignore errors arising from formulas that are inconsistent with formulas (\[ISO/IEC29500-1:2016\] section 18.17) in neighboring cells. | + +**formulaRange:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether to ignore errors arising from formulas (\[ISO/IEC29500-1:2016\] section 18.17) that contain references to less than the entirety of a range containing contiguous data. + +| Value | Meaning | +|----|----| +| "true" | Ignore errors arising from formulas (\[ISO/IEC29500-1:2016\] section 18.17) that contain references to less than the entirety of a range containing contiguous data. | +| "false" | Do not ignore errors arising from formulas (\[ISO/IEC29500-1:2016\] section 18.17) that contain references to less than the entirety of a range containing contiguous data. | + +**unlockedFormula:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether to ignore errors arising from unprotected formulas (\[ISO/IEC29500-1:2016\] section 18.17). + +| Value | Meaning | +|----|----| +| "true" | Ignore errors arising from unprotected formulas (\[ISO/IEC29500-1:2016\] section 18.17). | +| "false" | Do not ignore errors arising from unprotected formulas (\[ISO/IEC29500-1:2016\] section 18.17). | + +**emptyCellReference:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether to ignore errors arising from references to empty cells. + +| Value | Meaning | +|---------|--------------------------------------------------------------| +| "true" | Ignore errors arising from references to empty cells. | +| "false" | Do not ignore errors arising from references to empty cells. | + +**listDataValidation:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether to ignore errors arising from [**data validation**](#gt_1db94de4-1b5d-40aa-a7d9-617078ebb237). + +| Value | Meaning | +|---------|----------------------------------------------------| +| "true" | Ignore errors arising from data validation. | +| "false" | Do not ignore errors arising from data validation. | + +**calculatedColumn:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether to ignore errors arising from [**calculated column**](#gt_ec25719c-0814-4978-a7e7-f18111a9598d) formulas (\[ISO/IEC29500-1:2016\] section 18.17). + +| Value | Meaning | +|----|----| +| "true" | Ignore errors arising from calculated column formulas (\[ISO/IEC29500-1:2016\] section 18.17). | +| "false" | Do not ignore errors arising from calculated column formulas (\[ISO/IEC29500-1:2016\] section 18.17). | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1728. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ProtectedRanges + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [protectedRanges](#Section_ce68aca7ca694e0a884533ae55d2e8f0) + +A complex type that specifies a group of protected [**ranges**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) on the [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). MUST contain fewer than 231 elements. + +*Child Elements:* + +**protectedRange:** A [CT_ProtectedRange](#Section_85f5567f259941adae268cfab23ce754) element that specifies the properties for a single protected range. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1742. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ProtectedRange + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_ProtectedRanges](#Section_e084c498967646d6ba77e3ea8a482df9) + +A complex type that specifies a **[cell](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) [range](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99)** to be unprotected. The cell range is editable with a password or proper [**credentials**](#gt_b505ab37-868d-426c-bb19-af21e675e0b8) when **[sheet](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) [protection](#gt_dbeb9653-2ab1-4ec4-b64e-e77a8951c499)** is on and the cell is [**locked**](#gt_7795ac77-550e-4531-9ce5-327bbde6fa81). + +*Child Elements:* + +**xm:sqref:** A [**sqref**](#Section_4d7cc4156c514c718dbda2e28bdd9193) element that specifies the cell range to be unprotected. + +*Attributes:* + +**password:** An **ST_UnsignedShortHex** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section 15.8.2) attribute that specifies the verifier value of the password required for editing the cell range. If the value is 0x0000, then there is no password. + +The verifier value is calculated in two stages. First, the provided [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) password string is converted to a new character string in the ANSI code page of the current system by using the algorithm specified in the **revisionsPassword** attribute in \[ISO/IEC29500-4:2016\] section 15.3.3. Second, this string is input into the [**XOR obfuscation**](#gt_cbfd1a35-e8c9-4c5a-bc26-e618633d2f50) algorithm specified in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 2.3.7.1 to produce a 16-bit password verifier value. + +This attribute MUST NOT be present if **algorithmName** is present. + +**algorithmName:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the name of the [**hash**](#gt_b7e2b611-0af5-4fec-8af2-3f9ce7bad205) algorithm used to calculate **hashValue**. If this attribute is present, **hashValue**, **saltValue**, and **spinCount** MUST also be present. This attribute MUST NOT be present if **password** is present. + +**hashValue:** A **base64Binary** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.16) attribute that specifies the hash value for the password required to edit this range. This value will be compared with the resulting hash value after hashing the user-supplied password by using the algorithm specified by **algorithmName**, and if the two values match, the protection will no longer be enforced. + +Password hashes are computed by the algorithm specified in \[MS-OFFCRYPTO\] section 2.4.2.4. Under circumstances as specified in \[MS-OFFCRYPTO\] section 1.3.4, the password is first converted to a 16-bit verifier value and reinterpreted as a single Unicode character, which is then passed to the algorithm specified in \[MS-OFFCRYPTO\] section 2.4.2.4. There is no way to determine which method was used to generate a hash without knowledge of the password; it is necessary to compute both hashes to verify the password. + +This attribute MUST be present if and only if **algorithmName** is present. + +**saltValue:** A **base64Binary** (\[XMLSCHEMA2/2\] section 3.2.16) attribute that specifies the [**salt**](#gt_1672c769-f184-404a-9575-e637fd3a43ed) used to calculate **hashValue**. This attribute MUST be present if and only if **algorithmName** is present. + +**spinCount:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the number of times that the hash function was iterated over the password to generate the **hashValue**. It MUST NOT be greater than 10,000,000. This attribute MUST be present if and only if **algorithmName** is present. + +**name:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the title of the cell range. The value MUST be unique for the sheet. The number of characters in the string MUST be greater than or equal to 1, and less than or equal to 255. The string MUST conform to the following [**Augmented Backus-Naur Form (ABNF)**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) ([\[RFC5234\]](https://go.microsoft.com/fwlink/?LinkId=123096)) grammar: + +1747. string = name-start-character \*name-character + + name-start-character = "\_" / "\\ / Unicode-character + + name-character = name-start-character / Unicode-space / Unicode-digit / "?" / "." + +The following points summarize this grammar: + +- Unicode-character is any code point that is a character as defined by the Unicode character properties, [\[UNICODE5.1\]](https://go.microsoft.com/fwlink/?LinkId=152822) chapter 4. + +- Unicode-digit is any code point that is a digit as defined by the Unicode character properties, \[UNICODE5.1\] chapter 4. + +- Unicode-space is any code point that is a space as defined by the Unicode character properties, \[UNICODE5.1\] chapter 4. + +**securityDescriptor:** A **string** (\[XMLSCHEMA2/2\] section 3.2.1) attribute that describes a [**security descriptor**](#gt_e5213722-75a9-44e7-b026-8e4833f0d350) ([\[MS-AZOD\]](%5bMS-AZOD%5d.pdf#Section_5a0a0a3ec7a742e1b5f2cc8d8bd9739e) section [1.1.1.3](http://msdn.microsoft.com/en-us/library/ec52bde3-9c86-4484-9080-e72148a2d53b/)) that lists users who can edit the cell range without providing the password. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1752. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_IconFilter + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [iconFilter](#Section_1938fcf8d1c54e18972d54c3a7511a77) + +This complex type specifies the [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9) and particular [**icon**](#gt_ec8c21aa-5773-4c2e-99bb-d50e680e1870) within that set to [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) by. [**Rows**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) with a cell icon that do not match these criteria will be hidden when the filter is applied. + +*Attributes:* + +**iconSet:** An [**ST_IconSetType**](#Section_bfdf00a54e494b00880332250e1683c2) attribute that specifies the icon set used as the filter criteria. + +**iconId:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the index of the icon to be used as filter criteria. If **iconSet** is "NoIcons", this value MUST be 0 and this record does not specify a filter and MUST be ignored. If **iconSet** is not "NoIcons", this value MUST be greater than or equal to 0. If the icon set specified by **iconSet** has three icons, this value MUST be less than or equal to 2. If the icon set specified by **iconSet** has four icons, this value MUST be less than or equal to 3. If the icon set specified by **iconSet** has five icons, this value MUST be less than or equal to 4. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1764. \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Filter + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [filter](#Section_3e769b72edc144b68ce20b0611a74d44) + +This complex type specifies a [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) criterion. [**Rows**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) that contain a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the filter [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that have value **val** will not be hidden by this **filter** criterion. Rows that do not contain such a cell inside a **filters** element ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.3.2.8) will be hidden. + +*Attributes:* + +**val:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the value to be used as a filter criterion. The length of this value MUST be less than 65536 characters. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1768. \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CustomFilters + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [customFilters](#Section_0ae7cc3a78d544dc90387b0415305479) + +This complex type specifies custom [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) criteria. [**Rows**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) that contain a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the filter [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) such that the value does not meet the custom filter criteria will be hidden. + +*Child Elements:* + +**customFilter:** A **CT_CustomFilter** element that specifies a custom filter criterion. + +*Attributes:* + +**and:** A Boolean ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies the relationship between custom filter criterion. This attribute only applies when there are two criteria. + +| Value | Meaning | +|----|----| +| "false" | The two criteria are related by an OR relationship. That is, for a cell value to meet the custom filter criteria, at least one criterion specified by the **customFilter** child elements MUST be met. | +| "true" | The two criteria are related by an AND relationship. That is, for a cell value to meet the custom filter criteria, both criteria specified by the **customFilter** child elements MUST be met. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1771. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CustomFilter + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_CustomFilters](#Section_545a0d5521d145eb8d81d730aa5ea2af) + +This complex type specifies a custom [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) criterion. + +*Attributes:* + +**operator:** An **ST_FilterOperator** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.18.31) attribute that specifies the operator of the custom filter criterion. + +**val:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the value to be used as a custom filter criterion. The length of this value MUST be less than 65536 characters. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1777. \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SortCondition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_RichSortCondition](#Section_984b10b877a0427388afdf98616ee8e1), [sortCondition](#Section_e8085187f5f64f18aeb5e21514123bb6), [CT_SortRule](#Section_cd611e3d7b67404d8934bd2b6e738c75) + +A complex type that specifies a [**sort condition**](#gt_198a56e7-6045-43cf-8acd-793eab3647c1) to apply to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +*Attributes:* + +**descending:** A boolean ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies the direction of the [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880). + +| Value | Meaning | +|----|----| +| "false" | If **sortBy** is "value", sort in ascending order. If **sortBy** is "cellColor" or "fontColor", cells in which the cell color or cell font color specified by **dxfId** occurs are ordered at the top of the range. If **sortBy** is "icon", cells in which the icon specified by **iconSet** and **iconId** occurs are ordered at the top of the range. | +| "true" | If **sortBy** is "value", sort in descending order. If **sortBy** is "cellColor" or "fontColor", cells in which the cell color or cell font color specified by **dxfId** occurs are ordered at the bottom of the range. If **sortBy** is "icon", cells in which the icon specified by **iconSet** and **iconId** occurs are ordered at the bottom of the range. | + +**sortBy:** An **ST_SortBy** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.18.72) attribute that specifies how the cells in a range are sorted. + +**ref:** An **ST_Ref** (\[ISO/IEC29500-1:2016\] section 18.18.62) attribute that specifies the [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) or [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) to which this sort condition applies. This value MUST be contained within the **ref** in the **sortState** (\[ISO/IEC29500-1:2016\] section 18.3.1.92) element that precedes this element. If the **sortState.columnSort** attribute that precedes this element is "false", this value specifies the column to which this sort condition applies and there MUST be only a single column specified by **ref**. If the **sortState.columnSort** attribute that precedes this element is "true", this value specifies the row to which this sort condition applies and there MUST be only a single row specified by **ref**. + +**customList:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies a comma-delimited list of strings that specifies a custom [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7). The order of strings in the list specifies the sort order. When a cell value matches a string in the list, it is sorted ahead of the cell values that match a later string in the list, and so on for each cell in the range. MUST be ignored if **sortBy** is not equal to "value". + +**dxfId:** An **ST_DxfId** (\[ISO/IEC29500-1:2016\] section 18.18.25) attribute that specifies the format identifier when **sortBy** equals "cellColor" or **sortBy** equals "fontColor". MUST NOT be present if **sortBy** equals "icon" or "value". + +**iconSet:** An [ST_IconSetType](#Section_bfdf00a54e494b00880332250e1683c2) attribute that specifies the icon set when **sortBy** equals "icon". The absence of this attribute means no icon. MUST NOT be present if **sortBy** is not equal to "icon". + +**iconId:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the zero-based index of an icon in an [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9). If the icon set specified by **iconSet** has three icons, this value MUST be less than or equal to 2. If the icon set specified by **iconSet** has four icons, this value MUST be less than or equal to 3. If the icon set specified by **iconSet** has five icons, this value MUST be less than or equal to 4. The absence of this attribute means no icon. MUST NOT be present if **sortBy** is not equal to "icon". + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1781. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SourceConnection + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_CacheSourceExt](#Section_c81cf482908d43499a2ed18d9ea3a6dc), [sourceConnection](#Section_11af8735701f4c889582c0ab633213df) + +A complex type that stores the connection, which is specified by the **CT_Connection** element as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, that is associated with this pivot cache. The pivot cache MUST be associated with either an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf) or a [Non-Worksheet PivotTable](#Section_6ad0de69bcbd4c239b0f5018b86289e2). + +*Attributes:* + +**name:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the name of the connection, which is specified by the **name** attribute of **CT_Connection** (\[ISO/IEC29500-4:2016\] section A.2) for the connection that is associated with this pivot cache. The length, in characters, of this value MUST be less than 65,536. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1790. \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ListItem + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_ListItems](#Section_414c74eb8c474e16b22f0f9beb3ec425) + +A complex type that stores a single item for a list box or a drop-down form [**control**](#gt_3c89d16f-a826-4166-96ab-bf13e65b1a40)[\<20\>](#Appendix_A_20). + +*Attributes:* + +**val:** A **string** attribute, as specified in [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1, that specifies the data for a single item. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1793. \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ListItems + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_FormControlPr](#Section_8577637a66c3485bab6ef8c85689a7c4) + +A complex type that contains a list of items of type **CT_ListItem**, as specified in section [2.6.63](#Section_de80878b2bb445b0b8305c435058f2a4), to populate a list box or a drop-down form [**control**](#gt_3c89d16f-a826-4166-96ab-bf13e65b1a40). When present, the **FmlaRange** attribute of **CT_FormControlPr**, as specified in section 2.6.65, takes precedence over this element. This element is valid only for list box and drop-down form control. + +*Child Elements:* + +**item:** A **CT_ListItem** element that contains a single data item for a list box or drop-down form control. + +**extLst:** A **CT_ExtensionList** element, as specified in ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1796. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_FormControlPr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [formControlPr](#Section_24baf70c49ec4d3c81fa133e8681490d) + +A complex type that stores a form control’s properties. + +*Child Elements:* + +**itemLst:** A **CT_ListItems** element, as specified in section [2.6.64](#Section_414c74eb8c474e16b22f0f9beb3ec425), that specifies a list of items to populate a list box or drop-down form control. + +**extLst:** A **CT_ExtensionList** element, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, that specifies future extensibility for this element. + +*Attributes:* + +**objectType:** An [**ST_ObjectType**](#Section_26c4db3224ca489f8e4490e8b8b19383) attribute that specifies the form control object type. + +**checked:** An [**ST_Checked**](#Section_39005a6ea42f43dca6e719183b41fa3d) attribute that specifies whether a check box is selected or a radio button is selected. This attribute only applies to check box and radio button form controls. + +**colored:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether a drop-down object has a color applied to it. This attribute only applies to drop-down form controls. + +| Value | Meaning | +|---------|------------------------------------------------| +| "true" | A drop-down object has a color applied to it. | +| "false" | A drop-down object has no color applied to it. | + +**dropLines:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the number of lines in the drop-down before scroll bars are added. This attribute only applies to drop-down form controls. This value MUST be at least 0 and at most 30000. + +**dropStyle:** An [**ST_DropStyle**](#Section_ebaa0583ab1b49d2b1e34c56f6476db5) attribute that specifies the style of the drop-down. This attribute only applies to drop-down form controls. + +**dx:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the width of the scroll bar in pixels. This attribute only applies to list boxes, scroll bars, spin boxes and drop-downs[\<21\>](#Appendix_A_21). + +**firstButton:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the object is the first button in a set of radio buttons. This attribute only applies to radio button form controls. + +| Value | Meaning | +|---------|---------------------------------------------------------------| +| "true" | The object is the first button in a set of radio buttons. | +| "false" | The object is not the first button in a set of radio buttons. | + +**fmlaGroup:** An **ST_Formula** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.18.35) attribute that specifies the cell an object in a group box is linked to. This attribute overrides the attribute **fmlaLink** for any radio buttons within a group box. This attribute only applies to group box form controls. The application can choose to remove and not save this element and use the attribute **fmlaLink** of the first radio button in the group. This attribute MUST be a [**cell reference**](#gt_4d15aeb2-3a7d-44d7-b8d1-8a441f1cc24f) (see \[ISO/IEC29500-1:2016\] section 18.17.2.3). + +**fmlaLink:** An **ST_Formula** (\[ISO/IEC29500-1:2016\] section 18.18.35) attribute that specifies the [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) the object is linked to. This attribute only applies to check boxes, radio buttons, scroll bars, spin boxes, drop-downs and list boxes. The value in the linked cell and the index of the selected item in the object are linked together. This link is ignored if the form control allows multiple selections. This attribute MUST be a cell reference (see \[ISO/IEC29500-1:2016\] section 18.17.2.3). + +**fmlaRange:** An **ST_Formula** (\[ISO/IEC29500-1:2016\] section 18.18.35) attribute that specifies the range of [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0) cells. This is used to populate a list box or a drop-down form control[\<22\>](#Appendix_A_22). This attribute only applies to list box and drop-down form controls. This attribute MUST be a cell reference (see \[ISO/IEC29500-1:2016\] section 18.17.2.3). + +**fmlaTxbx:** An **ST_Formula** (\[ISO/IEC29500-1:2016\] section 18.18.35) attribute that specifies the source data cell that the form [**control**](#gt_3c89d16f-a826-4166-96ab-bf13e65b1a40) object's data is linked to. Any cell [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) can be specified but only the first cell in the range is considered. This attribute applies only to label and edit box form controls. This attribute MUST be a cell reference (see \[ISO/IEC29500-1:2016\] section 18.17.2.3). + +**horiz:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the scroll bar is horizontal. This attribute only applies to scroll bar form controls. + +**inc:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the change in the current value of a scroll bar or a spin box form control as a result of on an increment click. If present, it MUST be at least 0 and at most 30000. This attribute applies only to scroll bar or spin box form controls. + +**justLastX:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the last line in text is justified when in an East Asian alignment[\<23\>](#Appendix_A_23). + +| Value | Meaning | +|----|----| +| "true" | The last line in text is justified when in an East Asian alignment. | +| "false" | the last line in text is not justified when in an East Asian alignment. | + +**lockText:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the object’s text is locked. This attribute applies only to button, radio button, check box and label form controls. + +| Value | Meaning | +|---------|----------------------------------| +| "true" | The object’s text is locked. | +| "false" | The object’s text is not locked. | + +**max:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the maximum value generated by the scroll bar (when scrolled all the way down) or by the spin box. It MUST be at least 0 and at most 30000. This attribute only applies to scroll bars and spin boxes. + +**min:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the minimum value generated by the scroll bar (when scrolled all the way up) or by the spin box. It MUST be at least 0 and at most 30000. This attribute only applies to scroll bars and spin box. + +**multiSel:** A **string** (\[XMLSCHEMA2/2\] section 3.2.1) attribute that specifies the indices of selected items as a comma-delimited list. The list indices are one-based. This attribute is valid only if the attribute **selType** has the value "multi". This attribute applies only to list box form controls. + +**noThreeD:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether 3-D effects are disabled. This attribute only applies to check box, radio button, group box, scroll bar, drop-down, list box, and spin box form controls. + +| Value | Meaning | +|---------|-------------------------------| +| "true" | The 3-D effects are disabled. | +| "false" | The 3-D effects are enabled. | + +**noThreeD2:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether 3-D effects are disabled. This element is used for drop-downs and list boxes[\<24\>](#Appendix_A_24). + +| Value | Meaning | +|---------|-------------------------------| +| "true" | The 3-D effects are disabled. | +| "false" | The 3-D effects are enabled. | + +**page:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the number of items to move the scroll bar or spin box on a page click. It MUST be at least 0 and at most 30000[\<25\>](#Appendix_A_25). + +**sel:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the index of the selected item. The list indices are one-based. If set to a value of 0, no items are selected. This attribute applies only to list box and drop-down form controls. + +**seltype:** An [**ST_SelType**](#Section_9a7dc803b078474a83287c7c636cf6b7) attribute that specifies the selection type for the list box. This attribute applies only to list box form controls. + +**textHAlign:** An [**ST_TextHAlign**](#Section_dab72ca571a848399aafc6606d14fd75) attribute that specifies the horizontal text alignment for the object[\<26\>](#Appendix_A_26). + +**textVAlign:** An [**ST_TextVAlign**](#Section_e2860382a25c4fe39492f20afee01215) attribute that specifies the vertical text alignment for the object[\<27\>](#Appendix_A_27). + +**val:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the number of top [**rows**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) currently hidden in the scroll bar. If omitted, the value is assumed to be 0. Those rows are hidden but still accessible by clicking the scroll bar buttons. The number of top hidden rows can change as the user interacts with the scroll bar. This attribute only applies to scroll bar, spin box, list box, and drop-down form controls. + +**widthMin:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the smallest width allowed for the drop-down box window in screen [**pixels**](#gt_fe932605-d3bc-442f-9239-594676bce6ba). This attribute only applies for drop-down form controls. + +**editVal:** An [**ST_EditValidation**](#Section_13a544f0fbfa44c9888ab7e12f9a3662) attribute that specifies how the edit box content is validated if the application chooses to validate it. This attribute only applies to edit box form controls. + +**multiLine:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the form control is multiline. This attribute only applies to edit box form controls. This attribute only works when the form control is run in a dialog box. + +| Value | Meaning | +|---------|---------------------------------| +| "true" | The form control is multiline. | +| "false" | The form control is singleline. | + +**verticalBar:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the control has a vertical scroll bar. This attribute only applies to edit box form controls. This attribute only works when the form control is run in a dialog box. + +| Value | Meaning | +|---------|-----------------------------------------| +| "true" | The control has a vertical scroll bar. | +| "false" | The control has no vertical scroll bar. | + +**passwordEdit:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the edit box control stores a password. In this case the control will display \* for every character on it. This attribute only applies to edit box form controls. This attribute only works when the control is run in a dialog box. + +| Value | Meaning | +|---------|-----------------------------------------------| +| "true" | The edit box control stores a password. | +| "false" | The edit box control does not store password. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1802. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DatastoreItem + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [datastoreItem](#Section_f9d99df8f3734f38b47b1b9b147c4537) + +A complex type that specifies properties for an embedded custom data part. + +*Child Elements:* + +**extLst:** A **CT_ExtensionList** element, as specified in ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, that specifies future extensibility for this element. + +*Attributes:* + +**id:** An **ST_Xstring** attribute, as specified in ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19, that specifies the identifier for the associated [Custom Data](#Section_7c53f6f4fea843f7a4b0ba6e14d0eb78) storage. The value of the string is used to identify the associated Custom Data storage, and the value of the string MUST be unique for each Custom Data storage in the workbook. The length of this value MUST be less than 65536 characters. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1839. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Slicers + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [slicers](#Section_97d22959035a43f69a8392a36e3f07a8) + +A complex type that specifies a list of **CT_Slicer** elements, as specified in section [2.6.69](#Section_6f674009241d4a269f10ff99047aef96). The list of **CT_Slicer** elements specifies all [slicer views](#Section_69c0e0f9d0144bd59f2d2f554c715083) on the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +*Child Elements:* + +**slicer:** A **CT_Slicer** element that specifies a slicer view on the worksheet. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1845. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Slicer + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_Slicers](#Section_2d763f4b26c6451f81d2e7e5b21203d1) + +A complex type that specifies a slicer view, as specified in section [2.3.2.2](#Section_69c0e0f9d0144bd59f2d2f554c715083), in this [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +*Child Elements:* + +**extLst:** A **CT_ExtensionList** element, a specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, that specifies future extensibility for this element. + +*Attributes:* + +**name:** An **ST_Xstring** attribute, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19, that specifies the name of the slicer view. MUST be a unique case-insensitive name within the scope of this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The length of this attribute MUST be greater than or equal to 1 character and MUST be less than or equal to 32767 characters. + +**xr10:uid:** An ST_Guid (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies the unique id of the slicer view. If any instance of this type specifies this attribute, then all instances MUST specify it, and the values MUST be distinct. + +**cache:** An **ST_Xstring** attribute that specifies the name of the slicer cache, as specified in section [2.3.2.1](#Section_b0f3c3117ab64314af398bd3bed3bccf), that this slicer view is associated with. There MUST be a **CT_SlicerCacheDefinition** element, as specified in section [2.6.70](#Section_808f571ceac440919b4fc8882d43de49), within this workbook with the **name** attribute equal to the value of this attribute. + +**caption:** An **ST_Xstring** attribute that specifies the caption of the slicer view. If this string exists, the length MUST be greater than or equal to 1 character. + +**startItem:** An **unsignedInt** attribute, as specified in [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22, that specifies the zero-based index of the first slicer item, as specified in section [2.3.2.1.6](#Section_7790509116ec477581008ed67a1e7e3f), displayed by the slicer view. + +**columnCount:** An **unsignedInt** attribute that specifies the number of [**columns**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) in the slicer view. MUST be greater than or equal to 1 and MUST be less than or equal to 20000. + +**showCaption:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the caption is displayed. + +| Value | Meaning | +|---------|----------------------------| +| "true" | The caption is displayed. | +| "false" | The caption is suppressed. | + +**level:** An **unsignedInt** attribute that specifies the **[OLAP level](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168)** of the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) of the [slicer source data](#Section_953b6fbd8a1241029d6a7da6de12598a) used by this slicer view. + +If the slicer source data is [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f), the value MUST be greater than or equal to 0 and MUST be less than **count** of the [**CT_OlapSlicerCacheLevelsData**](#Section_92a134a99d454596b5167ff321c5bd08) element specified by the **CT_SlicerCacheDefinition** element specified by **cache**. If the OLAP hierarchy has an [**OLAP All level**](#gt_89210293-306b-4692-82ce-71f5487b0179), the value MUST NOT be 0. + +If the slicer source data is non-OLAP, this attribute MUST NOT exist. + +**style:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the [slicer style](#Section_c27949e2eac54d889655187392cab0aa) of the slicer view. If this [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) exists, this string MUST match the **name** attribute of a [**CT_SlicerStyle**](#Section_f58e45aaf570456cb08710b48fce4878) element within this workbook or MUST be equal to one of the built-in slicer style names: + +| Built-in slicer style names | +|-----------------------------| +| SlicerStyleLight1 | +| SlicerStyleLight2 | +| SlicerStyleLight3 | +| SlicerStyleLight4 | +| SlicerStyleLight5 | +| SlicerStyleLight6 | +| SlicerStyleOther1 | +| SlicerStyleOther2 | +| SlicerStyleDark1 | +| SlicerStyleDark2 | +| SlicerStyleDark3 | +| SlicerStyleDark4 | +| SlicerStyleDark5 | +| SlicerStyleDark6 | + +**lockedPosition:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the slicer view is locked. + +| Value | Meaning | +|---------|--------------------------------| +| "true" | The slicer view is locked. | +| "false" | The slicer view is not locked. | + +**rowHeight:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) height of the slicer view in [**English Metric Units (EMUs)**](#gt_264db3a3-b788-42b9-8a78-38ddc62ccd39). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1850. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Slicer + +*Target namespace:* http://schemas.microsoft.com/office/drawing/2010/slicer + +*Referenced by:* [slicer](#Section_4c82fc95928145aba65bfdd8f5e4e85e) + +This complex type specifies which [slicer view](#Section_69c0e0f9d0144bd59f2d2f554c715083) is associated with this drawing element. + +*Child Elements:* + +**extLst:** A **CT_OfficeArtExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.5.1) element that specifies future extensibility for this element. + +*Attributes:* + +**name:** A **string** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that specifies the name of the slicer view that is associated with this drawing element. The value of this attribute MUST match the value of the **name** attribute of a **slicer** element within the [**CT_Slicers**](#Section_2d763f4b26c6451f81d2e7e5b21203d1) element for the current [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1866. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.2](#Section_8ccfc6adcdae4ac6964317d999d1a7e6) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SlicerCacheDefinition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [slicerCacheDefinition](#Section_13e66a54691846989e584905a7b02ab5) + +A complex type that specifies a [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). + +*Child Elements:* + +**pivotTables:** A **CT_SlicerCachePivotTables** element (section [2.6.72](#Section_02a103ce599e4bd39660540143e686c5)) that specifies a group of **CT_SlicerCachePivotTable** elements (section [2.6.73](#Section_24e77636213342cc9e7460497618a5d5)) that specify the PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) views that are filtered by the slicer cache (section [2.1.4](#Section_7dbb4481b02145cc8bd46094b566a5ff)). + +**data:** A **CT_SlicerCacheData** element (section [2.6.71](#Section_da6c38a25de94ea8bb9a242925b5d468)) that specifies a [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for the slicer cache. + +**extLst:** A **CT_ExtensionList** element, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, that specifies future extensibility for this element. + +*Attributes:* + +**name:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the name of the slicer cache. MUST adhere to the name production rule provided in section [2.2.2](#Section_3d025add118d44139856ab65712ec1b0). MUST be a unique case-insensitive name within the scope of [**defined names**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + +**xr10:uid:** An ST_Guid (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies the unique id of the slicer cache. If any instance of this type specifies this attribute, then all instances MUST specify it, and the values MUST be distinct. + +**sourceName:** An **ST_Xstring** attribute that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) or **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) cache [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) of the associated PivotTable **PivotCache** used by the slicer cache. + +- If the slicer source data (section [2.3.2.1.1](#Section_953b6fbd8a1241029d6a7da6de12598a))is a non-**[OLAP](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f)** data source, the value of this attribute MUST be equal to the **name** attribute of a **CT_CacheField** (\[ISO/IEC29500-4:2016\] section A.2) element in the list of cache fields, as specified in section [2.3.2.1.2](#Section_2a393f8521f94a27a2b74867223f4b9a), and specify a **PivotTable** cache field. The specified **CT_CacheField** MUST have a **serverField** attribute equal to "false". The **includeNewItemsInFilter** attributes of the **CT_PivotField** (\[ISO/IEC29500-4:2016\] section A.2) elements of all included **CT_CacheField** elements MUST be equal. + +- If the slicer source data is an OLAP data source, the value MUST be equal to the value of the **uniqueName** attribute in one of the **CT_CacheHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) elements within the associated OLAP pivot cache, as specified in section [2.3.2.1.4](#Section_08ea5e044cef4f759ea4d2d99050f2d1), and specify a MDX unique name. The following attributes of the **CT_CacheHierarchy** element MUST be "false": **measure**, **set**, and **measures**. The **CT_PivotHierarchy** (\[ISO/IEC29500-4:2016\] section A.2) element with a zero-based index in the list of **CT_PivotHierarchy** elements specified by the **CT_PivotHierarchies** (\[ISO/IEC29500-4:2016\] section A.2) equal to the zero-based index of the **CT_CacheHierarchy** element in the list of **CT_CacheHierarchy** elements specified by **CT_CacheHierarchies** (\[ISO/IEC29500-4:2016\] section A.2) MUST have an **includeNewItemsInFilter** attribute equal to "false". + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1872. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SlicerCacheData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SlicerCacheDefinition](#Section_808f571ceac440919b4fc8882d43de49) + +A complex type that specifies a [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) for the [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). + +*Child Elements:* + +**olap:** A **[CT_OlapSlicerCache](#Section_9b19292cbaf8419f83b51a04ae068174)** element that specifies an OLAP data source. + +**tabular:** A [**CT_TabularSlicerCache**](#Section_3ffb16d6f376403c8282bff4dc78eef8) element that specifies a non-OLAP data source. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1882. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SlicerCachePivotTables + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [slicerCachePivotTables](#Section_e6c858b35d444f4699317e0d93d59755), [CT_SlicerCacheDefinition](#Section_808f571ceac440919b4fc8882d43de49) + +A complex type that specifies a group of [**CT_SlicerCachePivotTable**](#Section_24e77636213342cc9e7460497618a5d5) elements that specify the PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) views that are filtered by the [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). + +*Child Elements:* + +**pivotTable:** A **CT_SlicerCachePivotTable** element that specifies the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view that is filtered. The list of **pivotTable** child elements MUST NOT contain duplicates. The **showCalcMbrs** attribute of all **CT_PivotTableDefinition** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) elements associated with PivotTables (\[ISO/IEC29500-1:2016\] section 18.10) that are specified by **pivotTable** child elements MUST have the same value. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1888. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SlicerCachePivotTable + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SlicerCachePivotTables](#Section_02a103ce599e4bd39660540143e686c5) + +A complex type that specifies a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) view filtered by a [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). + +*Attributes:* + +**tabId:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the [**unique identifier (UID)**](#gt_3d9dd73b-8923-43cc-ac95-8103f17683d7) of the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) that contains the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view specified by the **name** attribute. MUST match the **sheetId** of an existing [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element within the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). MUST be ignored if the PivotTable specified by the name attribute is a [Non-Worksheet PivotTable](#Section_6ad0de69bcbd4c239b0f5018b86289e2). + +**name:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the name of the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view on the worksheet specified by **tabId** or a Non-Worksheet PivotTable. MUST match the **name** attribute of an existing [**pivotTableDefinition**](#Section_027c658596e24b7c9a8a02470415ac4a) element in the worksheet. The **createdVersion** attribute of the **CT_PivotTableDefinition** (\[ISO/IEC29500-4:2016\] section A.2) element that defines the specified PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) MUST be greater than or equal to 3. [**Field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) **showCalcMbrs** of all PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) MUST have the same value. Field **calculatedMembersInFilters** of [CT_PivotTableDefinition](#Section_4fa0ac531c40475fad76d06c604df3e3) of all PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) MUST have the same value. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1893. \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_OlapSlicerCacheItem + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_OlapSlicerCacheRange](#Section_e6d2f81b73e149ddb40568891772578e) + +This element specifies an [OLAP slicer item](#Section_ac62b47c91274f09b816e14a6909a1dc) of the [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) in the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) specified by the ancestor [**CT_OlapSlicerCacheLevelData**](#Section_e3ebe2f523c445cb9e3010b78347fee1) element. This element contains a list of all ancestor [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) of this OLAP slicer item in the OLAP hierarchy. + +*Child Elements:* + +**p:** A [**CT_OlapSlicerCacheItemParent**](#Section_28532f12970e41da83f6cb2461a80b85) element that specifies the OLAP members that are ascendants of the OLAP slicer item specified by this element. The first element in this list specifies the OLAP member that is the parent of the OLAP slicer item specified by this element. Each subsequent element in this list specifies an ascendant OLAP member in the next level up the OLAP hierarchy. + +*Attributes:* + +**n:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the OLAP member associated with the OLAP slicer item specified by this element. + +**c:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the caption of the OLAP slicer item specified by this element. + +**nd:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether the OLAP slicer item specified by this element has no data associated with it. This attribute MUST NOT exist if the **crossFilter** attribute of the ancestor element **CT_OlapSlicerCacheLevelData** is "none". For more information, see [Slicer Cross Filtering](#Section_ae98d186e6a9495981f5fd9359cdc6b3). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1897. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_OlapSlicerCacheItemParent + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_OlapSlicerCacheItem](#Section_4fc8bc09769e47fdb4d9936f23b7f24d), [CT_OlapSlicerCacheSelection](#Section_853111953a7747ae9a0210e7495e817a) + +This element specifies an ancestor [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) of the OLAP member specified by **CT_OlapSlicerCacheItem** or **CT_OlapSlicerCacheSelection** element that contains this element. + +*Attributes:* + +**n:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the OLAP member specified by this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1905. \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_OlapSlicerCacheRange + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_OlapSlicerCacheRanges](#Section_c8858f0b6590487699293908061a915b) + +A complex type that specifies a collection of cached [OLAP slicer items](#Section_ac62b47c91274f09b816e14a6909a1dc) in the [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) specified by the ancestor [**CT_OlapSlicerCacheLevelData**](#Section_e3ebe2f523c445cb9e3010b78347fee1) element. + +*Child Elements:* + +**i:** A [**CT_OlapSlicerCacheItem**](#Section_4fc8bc09769e47fdb4d9936f23b7f24d) element that specifies an OLAP slicer item in the OLAP level specified by the **CT_OlapSlicerCacheLevelData** element that is part of this range. The number of **CT_OlapSlicerCacheItem** child elements MUST be greater than 0 and equal to or less than 1,000. + +*Attributes:* + +**startItem:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the zero-based index of the [**OLAP member**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) on this OLAP level for the first item in this range. The order of the OLAP slicer item is determined by the current [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7) and current [slicer cross filtering](#Section_ae98d186e6a9495981f5fd9359cdc6b3) setting applied to all OLAP slicer items on this OLAP level. The value of the starting position MUST be 0 or MUST be a multiple of 1,000. See [Slicer Items](#Section_7790509116ec477581008ed67a1e7e3f) for more information. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1908. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_OlapSlicerCacheRanges + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_OlapSlicerCacheLevelData](#Section_e3ebe2f523c445cb9e3010b78347fee1) + +A complex type that specifies the cached [OLAP slicer items](#Section_ac62b47c91274f09b816e14a6909a1dc) for the [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) specified by the **CT_OlapSlicerCacheLevelData** element. + +*Child Elements:* + +**range:** A [**CT_OlapSlicerCacheRange**](#Section_e6d2f81b73e149ddb40568891772578e) element that specifies a range of OLAP slicer items for this OLAP level within the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) specified by this [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1914. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_OlapSlicerCacheLevelData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_OlapSlicerCacheLevelsData](#Section_92a134a99d454596b5167ff321c5bd08) + +A complex type that specifies the properties of an [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) in the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) specified by this [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf) and specifies the [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) that are cached for this OLAP level within the OLAP hierarchy specified by this slicer cache. + +*Child Elements:* + +**ranges:** A [**CT_OlapSlicerCacheRanges**](#Section_c8858f0b6590487699293908061a915b) element that specifies cached [OLAP slicer items](#Section_ac62b47c91274f09b816e14a6909a1dc) for the OLAP level specified by this element. + +*Attributes:* + +**uniqueName:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the OLAP level specified by this element within the OLAP hierarchy specifies with this slicer cache. The length of this string MUST be at least 1 character and MUST NOT exceed 32,767 characters. + +**sourceCaption:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the caption of the OLAP level specified by this element within the OLAP hierarchy specified with this cache. The length of this string MUST NOT exceed 65,535 characters. + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the total number of OLAP members in the OLAP [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075) in this OLAP level within the OLAP hierarchy specified by this slicer cache. The default value is zero. + +**sortOrder:** An [**ST_OlapSlicerCacheSortOrder**](#Section_c51d0e2d4edd4fcc9858f18823e92cfd) attribute that specifies how the OLAP slicer items for the OLAP level specified by this element are sorted in the [slicer view](#Section_69c0e0f9d0144bd59f2d2f554c715083). + +**crossFilter:** An [**ST_SlicerCacheCrossFilter**](#Section_d8f640b3a6ec453aacfcf93a6656d0fd) attribute that specifies how the OLAP slicer items that are used in [slicer cross filtering](#Section_ae98d186e6a9495981f5fd9359cdc6b3) are displayed. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1919. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_OlapSlicerCacheLevelsData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_OlapSlicerCache](#Section_9b19292cbaf8419f83b51a04ae068174) + +A complex type that specifies a list of [**OLAP levels**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) specified by this [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). + +*Child Elements:* + +**level:** A [**CT_OlapSlicerCacheLevelData**](#Section_e3ebe2f523c445cb9e3010b78347fee1) element that specifies properties of an OLAP level in the OLAP hierarchy specified by this slicer cache. + +*Attributes:* + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the number of **level** child elements of this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1929. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_OlapSlicerCache + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SlicerCacheData](#Section_da6c38a25de94ea8bb9a242925b5d468) + +A complex type that specifies the associated [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) PivotCache, and specifies [OLAP Slicer Items](#Section_ac62b47c91274f09b816e14a6909a1dc). See [Slicer Cache Relationship to PivotCache](#Section_2a393f8521f94a27a2b74867223f4b9a) for more details. + +*Child Elements:* + +**levels:** A [**CT_OlapSlicerCacheLevelsData**](#Section_92a134a99d454596b5167ff321c5bd08) element that specifies a list of [**OLAP levels**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) of the OLAP [**hierarchy**](#gt_a07fc05d-cdb0-442c-984a-dd3589b9f682) specified by this [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). + +**selections:** A [**CT_OlapSlicerCacheSelections**](#Section_79b764ff71fc415f92436e99d1957a8e) element that specifies a list of OLAP Slicer Items that are selected. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**pivotCacheId:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the associated OLAP PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache. MUST be equal to the **pivotCacheId** attribute of an existing [**CT_PivotCacheDefinition**](#Section_2924f3f8a9cb4b098557fda87770d5bd) element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1935. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_OlapSlicerCacheSelections + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_OlapSlicerCache](#Section_9b19292cbaf8419f83b51a04ae068174) + +A complex type that specifies the [OLAP slicer items](#Section_ac62b47c91274f09b816e14a6909a1dc) that are selected in the [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). + +*Child Elements:* + +**selection:** A [**CT_OlapSlicerCacheSelection**](#Section_853111953a7747ae9a0210e7495e817a) element that specifies an OLAP slicer item that is selected in the slicer cache. + +*Attributes:* + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the number of **selection** child elements of this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1943. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_OlapSlicerCacheSelection + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_OlapSlicerCacheSelections](#Section_79b764ff71fc415f92436e99d1957a8e) + +A complex type that specifies an individual [OLAP slicer item](#Section_ac62b47c91274f09b816e14a6909a1dc) that is selected for filtering. This complex type also specifies the ancestor [**OLAP members**](#gt_c0dd6cb4-ad4b-45ef-bd4f-75c650f84f32) of the OLAP member associated with the OLAP slicer item in the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c). + +*Child Elements:* + +**p:** A [**CT_OlapSlicerCacheItemParent**](#Section_28532f12970e41da83f6cb2461a80b85) element that specifies OLAP members that are the ancestors of the OLAP member associated with the OLAP slicer item specified by this element. The first element in this list specifies the OLAP member that is the parent of the OLAP member associated with the OLAP slicer item specified by this element. Each subsequent element in this list specifies an ancestor OLAP member in the next level up the OLAP hierarchy, excluding the [**OLAP All member**](#gt_5cc9c818-a2ec-4ab8-94ad-86d759ff030b). + +*Attributes:* + +**n:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the OLAP member associated with the OLAP slicer item specified by this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1949. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TabularSlicerCache + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SlicerCacheData](#Section_da6c38a25de94ea8bb9a242925b5d468) + +A complex type that specifies [non-OLAP slicer items](#Section_a7ffe1389cc14e5ea0dba1ca7674a304) that are cached within this [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf) and properties of the slicer cache specific to non-OLAP slicer items. + +*Child Elements:* + +**items:** A [**CT_TabularSlicerCacheItems**](#Section_6cc8f502036e43bdb24ecacc36725b0e) element that specifies non-OLAP slicer items that are cached within this slicer cache. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**pivotCacheId:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the associated non-[**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) PivotCache. MUST match the **pivotCacheId** attribute of an existing [**CT_PivotCacheDefinition**](#Section_2924f3f8a9cb4b098557fda87770d5bd) element. + +**sortOrder:** An [**ST_TabularSlicerCacheSortOrder**](#Section_b2871d13c06d4c2388abe6325bee2209) attribute that specifies how the non-OLAP slicer items are sorted in the [slicer view](#Section_69c0e0f9d0144bd59f2d2f554c715083). + +**customListSort:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether [**custom lists**](#gt_92d2bb3a-2615-4bf8-b87f-887302d4c40c) are used when sorting the non-OLAP slicer items. + +| Value | Meaning | +|---------|-------------------------------------------------------------------| +| "false" | Custom lists are not used when sorting the non-OLAP slicer items. | +| "true" | Custom lists are used when sorting the non-OLAP slicer items. | + +**showMissing:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether non-OLAP slicer items that correspond to unused PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) cache items that existed previously, but are no longer present in the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0), are displayed. + +| Value | Meaning | +|---------|-----------------------------------------------------| +| "false" | The unused non-OLAP slicer items are not displayed. | +| "true" | The unused non-OLAP slicer items are displayed. | + +**crossFilter:** An [**ST_SlicerCacheCrossFilter**](#Section_d8f640b3a6ec453aacfcf93a6656d0fd) attribute that specifies how the non-OLAP slicer items that are used in [slicer cross filtering](#Section_ae98d186e6a9495981f5fd9359cdc6b3) are displayed. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1955. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TabularSlicerCacheItems + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_TabularSlicerCache](#Section_3ffb16d6f376403c8282bff4dc78eef8) + +A complex type that specifies [non-OLAP slicer items](#Section_a7ffe1389cc14e5ea0dba1ca7674a304) that are cached within this [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). + +*Child Elements:* + +**i:** A [**CT_TabularSlicerCacheItem**](#Section_369b3e9cafa74792ac78c6f0ed44fd6f) element that specifies a non-OLAP slicer item that is cached within this slicer cache. All **CT_TabularSlicerCacheItem** elements within this slicer cache MUST have unique **x** attributes. At least one **CT_TabularSlicerCacheItem** element MUST have **s** attribute be "true". + +*Attributes:* + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the number of **i** child elements of this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1966. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TabularSlicerCacheItem + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_TabularSlicerCacheItems](#Section_6cc8f502036e43bdb24ecacc36725b0e) + +A complex type that specifies a [non-OLAP slicer item](#Section_a7ffe1389cc14e5ea0dba1ca7674a304) that is cached within this [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). + +*Attributes:* + +**x:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies an index of the associated PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) cache item in the associated **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) cache [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc). MUST be within the range of items as specified by the **count** attribute of the **CT_PivotCacheRecords** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element of the associated non-[**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache specified by the **pivotCacheId** attribute of the [**CT_TabularSlicerCache**](#Section_3ffb16d6f376403c8282bff4dc78eef8) element that is an ancestor of this element. + +**s:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether a non-OLAP slicer item is [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595). + +| Value | Meaning | +|---------|-----------------------------------------| +| "true" | A non-OLAP slicer item is selected. | +| "false" | A non-OLAP slicer item is not selected. | + +**nd:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether a non-OLAP slicer item does not have data associated with it. This attribute MUST NOT exist if the **crossFilter** attribute of the **CT_TabularSlicerCache** element is equal to "none". For more information, see [Slicer Cross Filtering](#Section_ae98d186e6a9495981f5fd9359cdc6b3). + +| Value | Meaning | +|---------|---------------------------------------------------------------| +| "true" | A non-OLAP slicer item does not have data associated with it. | +| "false" | A non-OLAP slicer item has data associated with it. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1972. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotTableReferences + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [pivotTableReferences](#Section_d9ac8a3960a6493989cc8d9de42e4b48) + +A complex type that specifies a list of PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) part identifiers for [Non-Worksheet PivotTables](#Section_6ad0de69bcbd4c239b0f5018b86289e2). MUST contain fewer than 231 elements. + +*Child Elements:* + +**pivotTableReference:** A [CT_PivotTableReference](#Section_b367a159fe7e42139382b57fc7566a49) element that specifies a PivotTable part identifier of a Non-Worksheet PivotTable. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1977. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotTableReference + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_PivotTableReferences](#Section_03139118595a45828d16b8a292cb5528) + +A complex type that specifies a [relationship](#Section_683fd4c8c16a4f74a9b4b9e6950a2139) identifier to a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) part in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The PivotTable specified by the element **pivotTableDefinition** (\[ISO/IEC29500-1:2016\] section 18.10.1.73) identified by this type MUST be a [Non-Worksheet PivotTable](#Section_6ad0de69bcbd4c239b0f5018b86289e2) and MUST satisfy the following criteria. + +- The **ref** attribute of the child element **location** (\[ISO/IEC29500-1:2016\] section 18.10.1.49) MUST begin with "A1". + +- The **enableEdit** attribute of the **CT_PivotTableDefinition** element, as specified in section [2.6.32](#Section_4fa0ac531c40475fad76d06c604df3e3), MUST NOT exist or MUST be "false" if exists; **CT_PivotEdits** and **CT_PivotChanges** elements MUST NOT exist in this part. + +- The PivotTable name specified by the **name** attribute of the element **pivotTableDefinition** (\[ISO/IEC29500-1:2016\] section 18.10.1.73), MUST be unique among all the PivotTables in the workbook. + +- There MUST be a child **CT_PivotCache** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element within the **pivotCaches** element, specified by section [2.4.39](#Section_57538b20951e4b74912c68fc20177e96), with the attribute **cacheID** having the same value as the **cacheId** attribute of the element **pivotTableDefinition** (\[ISO/IEC29500-1:2016\] section 18.10.1.73). + +- The PivotTable MUST NOT have **CT_ConditionalFormats** element as specified by section [2.6.49](#Section_e64b925747154282b17e158dd5363cf8). + +*Attributes:* + +**r:id:** An **ST_RelationshipId** (\[ISO/IEC29500-1:2016\] section 22.8.2.1) attribute that specifies a relationship identifier to a PivotTable part in this workbook. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1982. \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_QueryTable + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [queryTable](#Section_de6cd320f9184d3aae7c24fbb5a16ca9) + +A complex type that specifies extended properties of a [**query table**](#gt_ceb1ea2c-7b55-4a25-a7f0-79b1c1011289) ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.12). + +*Attributes:* + +**clipped:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether a query table (\[ISO/IEC29500-1:2016\] section 18.12) did not fit to worksheet and was clipped. + +| Value | Meaning | +|----|----| +| "true" | A query table (\[ISO/IEC29500-1:2016\] section 18.12) did not fit to the worksheet and was clipped. | +| "false" | A query table (\[ISO/IEC29500-1:2016\] section 18.12) did not fit to the worksheet and was not clipped. | + +**sourceDataName:** A **string** (\[XMLSCHEMA2/2\] section 3.2.1) attribute that specifies the name of the primary [**data connection**](#gt_024a24fb-c1c0-4393-ab0c-f0e3e3f41629) for the query table. For more details, see **connection** (\[ISO/IEC29500-1:2016\] section 18.13.1) + +**drillThrough:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether a query table (\[ISO/IEC29500-1:2016\] is a result of [**drillthrough**](#gt_e5a4d8db-0d30-4977-9cab-fb66457f0ff7) operation on [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1985. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_WebExtensions + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [webExtensions](#Section_c69e2a9b98044d1294629e8bf9b06713) + +A complex type that specifies a list of [CT_WebExtension](#Section_386851b6b7b642b88cf1d94bab7b0731) elements. The list of CT_WebExtension elements specifies all the bindings for web extensions, as specified by [\[MS-OWEXML\]](%5bMS-OWEXML%5d.pdf#Section_a2cd741a4cca4b1aade4b2c443972afa) section 1.3, on the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +*Child Elements:* + +**webExtension:** A CT_WebExtension element that specifies a binding for a web extension, as specified by \[MS-OWEXML\] section 1.3, on the worksheet. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1990. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_WebExtension + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_WebExtensions](#Section_5d1976397d9f4d8cafb443e03a2c7e43) + +A complex type that specifies a binding for a web extension, as specified by [\[MS-OWEXML\]](%5bMS-OWEXML%5d.pdf#Section_a2cd741a4cca4b1aade4b2c443972afa) section 1.3, on the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +*Child Elements:* + +**xm:f:** An [**f**](#Section_8e937c5e8b744f10bdf81d75faf211b9) element that specifies the data range for the Binding. The formula MUST adhere to the grammar specified in Section [Formulas](#Section_3d025add118d44139856ab65712ec1b0), with the following restrictions: + +- MUST follow the ref-nospace-expression rule. + +- MUST NOT use the bang-reference, bang-name, sheet-range-reference, or local-cell-reference production rules. + +*Attributes:* + +**appRef:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies a unique identifier for a binding for a web extension. This value MUST be equal to the **appref** [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) of a **CT_OsfWebExtensionBinding** element as specified by \[MS-OWEXML\] section 2.2.3. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +1995. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Connection + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [connection](#Section_4c89a76488884a5b8dedd626cf268546) + +A complex type that specifies the extended properties of an external connection ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.13). See section [2.2.4.1](#Section_32a514539b7645ef8841e7abe46cf926) for how this element integrates with the Office Open XML file formats specified in \[ISO/IEC29500-1:2016\]. + +*Child Elements:* + +**textPr:** A CT_TextPr ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section 18.13.12) element that specifies properties for data model data source text importation. + +If this element is present, then the **type** attribute of the ancestor **CT_Connection** element, as specified in \[ISO/IEC29500-4:2016\] section A.2, MUST be equal to "103". + +**modelTextPr:** A [CT_ModelTextPr](#Section_21ac66763a664b5ab57c4e4f4a83039c) element that specifies a data model data source text importation ([\[MS-XLSB\]](%5bMS-XLSB%5d.pdf#Section_acc8aa921f02416799f584f9f676b95a) section 2.2.8.9.4) properties in addition to those specified in **textPr** element. + +If this element is present, then: + +- the **type** attribute of the ancestor **CT_Connection** element, as specified in \[ISO/IEC29500-4:2016\] section A.2, MUST be equal to "103". + +- Ancestor **CT_Connection** element MUST contain **textPr** element. + +**rangePr:** A [CT_RangePr](#Section_e84b9158350649a9bfd6bd677e92e42a) element that specifies data model data source Worksheet Data connection (\[MS-XLSB\] section 2.2.8.9.3) properties. + +If this element is present, then the **type** attribute of the ancestor **CT_Connection** element, as specified in \[ISO/IEC29500-4:2016\] section A.2, MUST be equal to "102". + +**oledbPr:** A [CT_OledbPr](#Section_1fe459965be542a69e5602f9457560c4) element that specifies data model data source OLE DB connection (\[MS-XLSB\] section 2.2.8.9.1) properties. + +If this element is present, then the **type** attribute of the ancestor **CT_Connection** element, as specified in \[ISO/IEC29500-4:2016\] section A.2, MUST be equal to "100". + +**dataFeedPr:** A [CT_DataFeedPr](#Section_ece183c064ff4b5c896d1db80ce6cf7f) element that specifies data model data source Data Feed connection (\[MS-XLSB\] section 2.2.8.9.2) properties. + +If this element is present, then the **type** attribute of the ancestor **CT_Connection** element, as specified in \[ISO/IEC29500-4:2016\] section A.2, MUST be equal to "101". + +*Attributes:* + +**id:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the identifier of the Data Model data source. The string MUST be less than or equal to 65535 characters in length. The string length MUST be equal to zero characters if the **model** attribute equals "true". + +**model:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether this connection is a connection to the **[spreadsheet data model](#gt_95ac50ee-8fc4-4dce-85e0-984684a68319).** If this element equals "true", the **type** attribute of the ancestor **CT_Connection** element, as specified in \[ISO/IEC29500-4:2016\] section A.2, MUST be equal to "5". + +**excludeFromRefreshAll:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether this connection is not to be refreshed on Refresh All. + +| Value | Meaning | +|---------|--------------------------------------------------------| +| "true" | This connection is not to be refreshed on Refresh All. | +| "false" | This connection is to be refreshed on Refresh All. | + +**autoDelete:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether this connection will be automatically deleted when all data features which use it are deleted. + +| Value | Meaning | +|----|----| +| "true" | This connection will be automatically deleted when all data features that use it are deleted. | +| "false" | This connection will not be automatically deleted when all data features that use it are deleted. | + +**usedByAddin:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether this connection is used by an addin component and will not be deleted with any data feature that uses it. + +| Value | Meaning | +|---------|----------------------------------------------------| +| "true" | This connection is used by an addin component. | +| "false" | This connection is not used by an addin component. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2001. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CalculatedMemberExt + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +This element adds an element for supporting new properties for calculated members. + +*Child Elements:* + +**calculatedMember:** A **CT_CalculatedMember** (section [2.6.93](#Section_fe7c684762044120b6d95efe6deb8bde)) element that specifies a definition for a custom member or measure that is applied to a pivot table. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2015. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CalculatedMember + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_CalculatedMemberExt](#Section_349130bbc08a472ea29692ead08d768b), [calculatedMember](#Section_9370df00d6e34242911fce734680bc90) + +This element adds new properties for supporting calculated members. + +*Attributes:* + +**measureGroup:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the name of the measure group that this calculated member is associated with if **measure** is TRUE. + +**numberFormat:** An **ST_CalcMemNumberFormat** (see section [2.7.25](#Section_34112e903dc94f8e80aa79a77fbec709)) attribute that specifies the formatting type of the calculated member. + +**measure:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether this calculated member is also a calculated measure. + +| Value | Meaning | +|---------|------------------------------------------------------| +| "true" | This calculated member is also a calculated measure. | +| "false" | This calculated member is not a calculated measure. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2020. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_FieldListActiveTabTopLevelEntity + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_PivotTableUISettings](#Section_488b5da9c4dd4101ac8491ce3597d7bd) + +A complex type which specifies a top level object in the hierarchy of objects displayed in the [**PivotTable field list**](#gt_1760fb56-0c97-4c0d-a077-38338baa7577). + +*Attributes:* + +**name:** A **string** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that specifies name of the object in the PivotTable field list. + +**type:** An **unsignedInt** attribute that specifies the type of this top level object. MUST be specified. MUST be one of the values in the following table: + +| Value | Object Type | +|----|----| +| 0 | OLAP Dimension. The **name** attribute of this element MUST be the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the [**dimension**](#gt_70d18eb1-eb3c-48f8-b0cd-7140f206406c). | +| 1 | Workbook Table. The **name** attribute of this element MUST be the name of the workbook table. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2025. \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotFilter + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [pivotFilter](#Section_432756fe5b79480d8459eb24c0a60e4a) + +A complex type that specifies the extended properties of a **CT_PivotFilter** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element. + +*Attributes:* + +**useWholeDay:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether the **filter** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10.1.33) element extended by this type uses whole days in its filtering criteria. MUST be false for **filters** for which the value of the attribute **type** (\[ISO/IEC29500-1:2016\] section 18.10.1.33) is not one of the values mentioned in the table below. MUST be true if the value of the **name** attribute of the containing **CT_PivotTableDefinition** (\[ISO/IEC29500-4:2016\] section A.2) element is equal to the value of the **name** (section [2.6.114](#Section_c4d5b4aa8ca54ff9886ed85d4ac83954)) attribute of at least one **CT\_ TimelineCachePivotTable** (section 2.6.114) element in the **Timeline cache** (section [2.1.7](#Section_29a0f58cd94246418ed04f02010326f2)) and the value of the attribute **type** of the containing **filter** element is one of the following. + +| Enumeration Value | +|----------------------------------------------------| +| dateBetween (Date Between) | +| dateEqual (Date Equals) | +| dateNewerThan (Date Newer Than) | +| dateNewerThanOrEqual (Date Newer Than or Equal To) | +| dateNotBetween (Date Not Between) | +| dateNotEqual (Date Does Not Equal) | +| dateOlderThan (Date Older Than) | +| dateOlderThanOrEqual (Date Older Than Or Equal) | +| lastMonth (Last Month) | +| lastQuarter (Last Quarter) | +| lastWeek (Last Week) | +| lastYear (Last Year) | +| M1 (Dates in January) | +| M10 (Dates in October) | +| M11 (Dates in November) | +| M12 (Dates in December) | +| M2 (Dates in February) | +| M3 (Dates in March) | +| M4 (Dates in April) | +| M5 (Dates in May) | +| M6 (Dates in June) | +| M7 (Dates in July) | +| M8 (Dates in August) | +| M9 (Dates in September) | +| nextMonth (Next Month) | +| nextQuarter (Next Quarter) | +| nextWeek (Next Week) | +| nextYear (Next Year) | +| percent (Percent) | +| Q1 (First Quarter) | +| Q2 (Second Quarter) | +| Q3 (Third Quarter) | +| Q4 (Fourth Quarter) | +| sum (Sum) | +| thisMonth (This Month) | +| thisQuarter (This Quarter) | +| thisWeek (This Week) | +| thisYear (This Year) | +| today (Today) | +| tomorrow (Tomorrow) | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2029. \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotTableUISettings + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [pivotTableUISettings](#Section_bb1ec32a95c34c909b0dff5a4f7dbb02) + +Specifies state for user interface used to construct and manipulate a PivotTable. + +*Child Elements:* + +**activeTabTopLevelEntity:** A [CT_FieldListActiveTabTopLevelEntity](#Section_4a8d18952b3942d2871e957957e7cbab) element that specifies a [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) that appears in the user’s working set of fields in the [**PivotTable field list**](#gt_1760fb56-0c97-4c0d-a077-38338baa7577). + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**sourceDataName:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the name of the primary [**data connection**](#gt_024a24fb-c1c0-4393-ab0c-f0e3e3f41629) for the [**PivotTable**](#gt_38963165-73bc-400a-a809-aff03693a316). See **connection** (\[ISO/IEC29500-1:2016\] section 18.13.1) + +**relNeededHidden:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether the user closed the relationship warning for this PivotTable. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2032. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TableSlicerCache + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [tableSlicerCache](#Section_ccb38b987f6e44189dcb004b9ccd4c82) + +A complex type that specifies properties of the [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf) specific to table slicer items. + +*Child Elements:* + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**tableId:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the associated **Table** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.5.1.2). MUST match **id** attribute of an existing **Table** (\[ISO/IEC29500-1:2016\] section 18.5.1.2) element. + +**column:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies associated **Table** **Column** (\[ISO/IEC29500-1:2016\] section 18.5.1.3). MUST match **id** attribute of an existing **tableColumn** element representing a [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) in **Table** specified by the **tableId** attribute. + +**sortOrder:** An [ST_TabularSlicerCacheSortOrder](#Section_b2871d13c06d4c2388abe6325bee2209) attribute that specifies how the table slicer items are sorted in the [slicer view](#Section_69c0e0f9d0144bd59f2d2f554c715083). + +**customListSort:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether [**custom lists**](#gt_92d2bb3a-2615-4bf8-b87f-887302d4c40c) are used when sorting the table slicer items. + +| Value | Meaning | +|---------|----------------------------------------------------------------| +| "false" | Custom lists are not used when sorting the table slicer items. | +| "true" | Custom lists are used when sorting the table slicer items. | + +**crossFilter:** An [ST_SlicerCacheCrossFilter](#Section_d8f640b3a6ec453aacfcf93a6656d0fd) attribute that specifies how the table slicer items that are used in [slicer cross filtering](#Section_ae98d186e6a9495981f5fd9359cdc6b3) are displayed. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2040. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelineCacheRefs + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [timelineCacheRefs](#Section_e4fb0fc619c041feb21e5b1ba3110a94) + +A complex type that specifies a list of [Timeline cache](#Section_8a428bc98be342fab39e8d2bb83657a2) part identifiers for the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). MUST contain fewer than 231 elements. + +*Child Elements:* + +**timelineCacheRef:** A [CT_TimelineCacheRef](#Section_3c9df509399f47da87fd8d60ebb50871) element that specifies a Timeline cache part identifier in this workbook. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2050. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelineCacheRef + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_TimelineCacheRefs](#Section_2f821c30252d4507b39296ab558788c8) + +A complex type that specifies a **Relationship** (section [1.4](#Section_683fd4c8c16a4f74a9b4b9e6950a2139)) identifier to a **Timeline Cache** (section [2.3.5.1](#Section_8a428bc98be342fab39e8d2bb83657a2)) part in this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +*Attributes:* + +**r:id:** An **ST_RelationshipId** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.8.2.1) attribute that specifies a **Relationship** (section 1.4) identifier to a **Timeline Cache** (section 2.3.5.1) part in this workbook. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2055. \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelineRefs + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [timelineRefs](#Section_e2dbbfe8b38f4c8285c9ccf543a22635) + +**CT_TimelineRefs** is a complex type that specifies a list of Timeline (section [2.3.5](#Section_92ac3f95d5bb4584882e95e4e9c443c8)) part identifiers for the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). MUST contain exactly one Timeline part identifier. + +*Child Elements:* + +**timelineRef:** A **CT_TimelineRef** element (section [2.6.101](#Section_ab8556be99df4a24b74c4499a4046821)) that specifies the Timeline (section 2.3.5) part identifier for the worksheet. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2058. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelineRef + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_TimelineRefs](#Section_a86d3fc351884ddd9a30c4906a6f84d3) + +A complex type that specifies a [relationship](#Section_683fd4c8c16a4f74a9b4b9e6950a2139) identifier of the part that contains the [Timelines](#Section_92ac3f95d5bb4584882e95e4e9c443c8) in this [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +*Attributes:* + +**r:id:** An **ST_RelationshipId** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.8.2.1) attribute that specifies a relationship identifier of the part that contains the Timelines in this worksheet. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2063. \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CacheHierarchy + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [cacheHierarchy](#Section_bbcca1a32cb6484d905a590a9d24051b) + +**CT_CacheHierarchy** is a complex type which specifies additional properties for an [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118). + +*Attributes:* + +**aggregatedColumn:** An **int** attribute that specifies the zero-based index of PivotTable cache hierarchy which corresponds to this OLAP measure. The referenced **CT_CacheHierarchy** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element specifies the PivotTable cache hierarchy that this OLAP measure aggregates. MUST only be specified if the **measure** attribute of this cache hierarchy is "true". The value MUST match the index of an existing cache hierarchy in **CT_CacheHierarchies** (\[ISO/IEC29500-4:2016\]) collection or be equal -1 if this OLAP measure is not an implicit measure which aggregates a cache hierarchy. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2066. \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SlicerCacheHideNoData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [slicerCacheHideItemsWithNoData](#Section_c2b82e4b8d6641a298a5a66e60d719a4) + +A complex type that specifies the extended properties of a [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf), as specified in section 2.3.2.1. + +*Child Elements:* + +**slicerCacheOlapLevelName:** A [CT_SlicerCacheOlapLevelName](#Section_1aec1629336f4ac1963bc76669784925) element that specifies the properties of an [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) in the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) specified by the ancestor slicer cache. [slicer items](#Section_ac62b47c91274f09b816e14a6909a1dc) with no data in this **OLAP level** are not displayed. + +*Attributes:* + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the number of **slicerCacheOlapLevelName** child elements of this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2069. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SlicerCacheOlapLevelName + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_SlicerCacheHideNoData](#Section_4c8e1834995440209dd4066d9ea42d0d) + +A complex type that specifies the properties of an [**OLAP level**](#gt_00e48261-dfd3-4f32-b53f-91e2344d6168) in the [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) specified by the ancestor [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). [slicer items](#Section_ac62b47c91274f09b816e14a6909a1dc) with no data in this **OLAP level** are not displayed. + +*Attributes:* + +**uniqueName:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the OLAP level specified by this element within the OLAP hierarchy specified with this slicer cache. The length of this string MUST be at least 1 character and MUST NOT exceed 32,767 characters. + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the total number of hidden slicer items in this OLAP level within the OLAP hierarchy specified by this slicer cache. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2075. \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelineStyles + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [timelineStyles](#Section_d7f2de781622492bac46032d0bb211d7) + +A complex type that specifies a group of [Timeline Styles](#Section_e438dc0a0c334172b8fb61ea2a1a06bb) and the default Timeline Style to apply to [Timelines](#Section_92ac3f95d5bb4584882e95e4e9c443c8). + +*Child Elements:* + +**timelineStyle:** A [CT_TimelineStyle](#Section_8c0bb52ea9234213abcb98e028d21ea6) element that specifies a Timeline Style. + +*Attributes:* + +**defaultTimelineStyle:** A **string** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that specifies the name of the default Timeline Style to apply to Timelines. The length of the string MUST be greater than or equal to 1 character and less than or equal to 255 characters. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2079. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelineStyleElements + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_TimelineStyle](#Section_8c0bb52ea9234213abcb98e028d21ea6) + +A complex type that specifies the list of table style ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8) elements of a [Timeline Style](#Section_e438dc0a0c334172b8fb61ea2a1a06bb) that are specific to [Timelines](#Section_92ac3f95d5bb4584882e95e4e9c443c8). + +*Child Elements:* + +**timelineStyleElement:** A [CT_TimelineStyleElement](#Section_79d1e43b5b1a49e1957c50b49ff9a2e8) element that specifies a table style (\[ISO/IEC29500-1:2016\] section 18.8) element of a timeline style that is specific to timelines. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2085. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelineStyle + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_TimelineStyles](#Section_ca8bb0ae143a4747b78751044f8f67cf) + +**CT_TimelineStyle** specifies table style elements, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8, of the timeline style, as specified in section [Timeline Styles](#Section_e438dc0a0c334172b8fb61ea2a1a06bb), that are specific to timelines, as specified in section [Timelines](#Section_92ac3f95d5bb4584882e95e4e9c443c8). + +*Child Elements:* + +**timelineStyleElements:** A [CT_TimelineStyleElements](#Section_7604575ae99842d186bb7486d94943a5), as specified in section Timeline Style Elements, that specifies table style elements of the timeline style that are specific to timelines. There MUST NOT be more than one **CT_TimelineStyleElements** in this element. + +*Attributes:* + +**name:** A **string** attribute, as specified in [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1, that specifies the name of the user-defined table style that this timeline style is based upon. The length of the **string** MUST be greater than or equal to 1 character and less than or equal to 255 characters. This **string** MUST be unique within the **CT_TimelineStyle** elements in the **Styles** part, as specified in \[ISO/IEC29500-1:2016\] section 12.3.20. This **string** MUST match the **name** attribute of a **CT_TableStyle** element, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, in the **Styles** part. In the **CT_TableStyle** element with a **name** attribute that matches this **string**, the **pivot** attribute MUST equal "false" and the **table** attribute MUST equal "false". + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2090. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelineStyleElement + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_TimelineStyleElements](#Section_7604575ae99842d186bb7486d94943a5) + +A complex type that specifies a table style element, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8, of a timeline style, as specified in section [Timeline Styles](#Section_e438dc0a0c334172b8fb61ea2a1a06bb). + +*Attributes:* + +**type:** An [ST_TimelineStyleType](#Section_3528c9e5f21b4c25ace1feb190ef8286) attribute that specifies the type of the table style element. This attribute MUST be unique within the parent **CT_TimelineStyleElements** complex type. + +**dxfId:** An **ST_DxfId** attribute, as specified in \[ISO/IEC29500-1:2016\] section 18.18.25, that specifies a zero-based index for the list of elements specified by the **dxfs** global element, as specified in section [2.4.55](#Section_c7d758644136460499cb52937e143a68). The specified **CT_Dxf** complex type, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, specifies the formatting to use with this table style element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2096. \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelinePivotCacheDefinition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [timelinePivotCacheDefinition](#Section_077eebbb46e5424ca04bb2c5787ad306) + +A complex type that specifies the extended properties of a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) **PivotCache** definition. + +*Attributes:* + +**timelineData:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether the [Timeline Cache Relationship to PivotCache](#Section_d49705e64e2545739b146b666a6e0bb1). MUST be "true" if the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) **PivotCache** definition is being referenced by a [timeline cache](#Section_8a428bc98be342fab39e8d2bb83657a2). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2100. \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Timelines + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [timelines](#Section_af36921b03b74f22acd601582075ef73) + +A complex type that specifies a list of **CT_Timeline** elements, as specified in section [2.6.111](#Section_0d578770103b4d7489206636997b6424). The list of **CT_Timeline** elements specifies all [Timeline views](#Section_ca0c8a5be42e4aeab6850a236dff375e) on the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +*Child Elements:* + +**timeline:** A **CT_Timeline** element that specifies a Timeline view on the worksheet. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2103. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Timeline + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_Timelines](#Section_696e862ce15d4c9ebf9e45e60b5c030c) + +The **CT_Timeline** complex type specifies a **Timeline view** (section [2.3.5.2](#Section_ca0c8a5be42e4aeab6850a236dff375e)) in this [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +*Child Elements:* + +**extLst:** A **CT_ExtensionList** element, as specified in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2, that specifies future extensibility for this element. + +*Attributes:* + +**name:** An **ST_Xstring** attribute, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19, that specifies the name of the **Timeline view**. This element MUST be a unique case-insensitive name within the scope of this [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). The length of this attribute MUST be greater than or equal to one character and MUST be less than or equal to 32767 characters. + +**xr10:uid:** An ST_Guid (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies the unique id of the **Timeline view**. If any instance of this type specifies this attribute, then all instances MUST specify it, and the values MUST be distinct. + +**cache:** An **ST_Xstring** attribute that specifies the name of the **Timeline cache** (section [2.3.5.1](#Section_8a428bc98be342fab39e8d2bb83657a2)) that this **Timeline view** is associated with. There MUST be a **CT_TimelineCacheDefinition** element (section [2.6.112](#Section_f45ff6effb624e198e8c822e3be9ef75)) within this workbook with the **name** attribute equal to the value of this attribute. + +**caption:** An **ST_Xstring** attribute that specifies the caption of the **Timeline view**. If this string exists, the length MUST be greater than or equal to one character. + +**showHeader:** A **Boolean** attribute, as specified in [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2, that specifies whether the header is displayed. + +| Value | Meaning | +|---------|---------------------------| +| "true" | The header is displayed. | +| "false" | The header is suppressed. | + +**showSelectionLabel:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the selection label is displayed. + +| Value | Meaning | +|---------|------------------------------------| +| "true" | The selection label is displayed. | +| "false" | The selection label is suppressed. | + +**showTimeLevel:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the time level is displayed. + +| Value | Meaning | +|---------|-------------------------------| +| "true" | The time level is displayed. | +| "false" | The time level is suppressed. | + +**showHorizontalScrollbar:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the horizontal scrollbar is displayed. + +| Value | Meaning | +|---------|-----------------------------------------| +| "true" | The horizontal scrollbar is displayed. | +| "false" | The horizontal scrollbar is suppressed. | + +**level:** An **unsignedInt** attribute, as specified in \[XMLSCHEMA2/2\] section 3.3.22, that specifies the current time level of the **Timeline** (section [2.3.5](#Section_92ac3f95d5bb4584882e95e4e9c443c8)). This element MUST be a value from the following table: + +| Value | Meaning | +|-------|---------| +| 0 | Year | +| 1 | Quarter | +| 2 | Month | +| 3 | Day | + +**selectionLevel:** An **unsignedInt** attribute that specifies the time level at which the current selection was made for the **Timeline**. This element MUST be a value from the following table: + +| Value | Meaning | +|-------|---------| +| 0 | Year | +| 1 | Quarter | +| 2 | Month | +| 3 | Day | + +**scrollPosition:** A **dateTime** attribute (\[XMLSCHEMA2/2\] section 3.2.7) that specifies the start date of the timespan scrolling position of the **Timeline**. + +**style:** An **ST_Xstring** attribute (\[ISO/IEC29500-1:2016\] section 22.9.2.19) that specifies the **Timeline style** (section [2.3.5.4](#Section_e438dc0a0c334172b8fb61ea2a1a06bb)) of the **Timeline view**. If this [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) exists, this string MUST match the **name** attribute of a **CT_TimelineStyle** element (section [2.6.107](#Section_8c0bb52ea9234213abcb98e028d21ea6)) within this workbook or MUST be equal to one of the built-in **Timeline style** names: + +| Built-in Timeline style names | +|-------------------------------| +| TimelineStyleLight1 | +| TimelineStyleLight2 | +| TimelineStyleLight3 | +| TimelineStyleLight4 | +| TimelineStyleLight5 | +| TimelineStyleLight6 | +| TimelineStyleDark1 | +| TimelineStyleDark2 | +| TimelineStyleDark3 | +| TimelineStyleDark4 | +| TimelineStyleDark5 | +| TimelineStyleDark6 | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2108. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelineCacheDefinition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [timelineCacheDefinition](#Section_352e7e0819b7411e8e5958e8281df654) + +A complex type that specifies a [Timeline cache](#Section_8a428bc98be342fab39e8d2bb83657a2). + +*Child Elements:* + +**pivotTables:** A **CT_TimelineCachePivotTables** element (section [2.6.113](#Section_e12b9031b9c14ddb85c3f9ca303447de)) that specifies a group of **CT\_ TimelineCachePivotTable** elements (section [2.6.114](#Section_c4d5b4aa8ca54ff9886ed85d4ac83954)) that specify the PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) views and [Non-Worksheet PivotTables](#Section_6ad0de69bcbd4c239b0f5018b86289e2) that are filtered by the **Timeline cache** (section [2.1.7](#Section_29a0f58cd94246418ed04f02010326f2)). + +**state:** A **CT_TimelineState** element (section [2.6.116](#Section_aa9bf1321afa4ce9b3d2e6dc00e48fde)) that specifies the information used for display in the **Timeline view** (section [2.3.5.2](#Section_ca0c8a5be42e4aeab6850a236dff375e)). + +**timelinePivotFilter:** A [CT_TimelinePivotFilter](#Section_b133959ecc5d405d8da13a26a9f761e6) element (section 2.6.118) that specifies the filter used by the Timeline Cache (section 2.1.7) to filter PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) views and Non-Worksheet PivotTables. This element MUST exist only if the **filterType** attribute of the CT_TimelineState (section 2.6.116) element of the Timeline Cache has a value that is not one of the following: + +| **Enumeration Value** | **Description** | +|:---|:---| +| dateBetween (Date Between) | Indicates the "between" filter for date values. | +| dateEqual (Date Equals) | Indicates the "equals" filter for date values. | +| unknown | Indicates the absence of a filter for date values. | + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**name:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the name of the **Timeline cache** (section 2.3.5.1). MUST adhere to the name production rule provided in section [2.2.2](#Section_3d025add118d44139856ab65712ec1b0). MUST be a unique case-insensitive name within the scope of [**defined names**](#gt_5bb97b28-4adc-48ec-b544-02542753a933). + +**xr10:uid:** An ST_Guid (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies the unique id of the **Timeline cache** (section 2.3.5.1). If any instance of this type specifies this attribute, then all instances MUST specify it, and the values MUST be distinct + +**sourceName:** An **ST_Xstring** attribute that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) of the key [**attribute**](#gt_108a1419-49a9-4d19-b6ca-7206aa726b3f) of the associated [**OLAP hierarchy**](#gt_1e0ca171-3095-4e3c-9c69-65148df00a9c) if the **Timeline source data** (section [2.3.5.1.1](#Section_bb12c489e4514e2ab62163da1e6aee6b)) is an [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [**data source**](#gt_e091613c-6901-4874-b9b2-27273ead1075). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2125. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelineCachePivotTables + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_TimelineCacheDefinition](#Section_f45ff6effb624e198e8c822e3be9ef75) + +A complex type that specifies a group of [CT_TimelineCachePivotTable](#Section_c4d5b4aa8ca54ff9886ed85d4ac83954) elements that specify the PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) views and Charts (\[ISO/IEC29500-1:2016\] section 21.2) based on [Non-Worksheet PivotTables](#Section_6ad0de69bcbd4c239b0f5018b86289e2) that are filtered by the [Timeline cache](#Section_8a428bc98be342fab39e8d2bb83657a2). + +*Child Elements:* + +**pivotTable:** A CT_TimelineCachePivotTable element that specifies the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view or a Non-Worksheet PivotTable that is filtered. The list of **pivotTable** child elements MUST NOT contain duplicates. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2136. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelineCachePivotTable + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_TimelineCachePivotTables](#Section_e12b9031b9c14ddb85c3f9ca303447de) + +A complex type that specifies a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) view filtered by a [Timeline cache](#Section_8a428bc98be342fab39e8d2bb83657a2). + +*Attributes:* + +**tabId:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the [**unique identifier (UID)**](#gt_3d9dd73b-8923-43cc-ac95-8103f17683d7) of the [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615) that contains the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view specified by the **name** attribute. MUST match the **sheetId** of an existing [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d) ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element within the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). MUST be equal to the decimal equivalent of 0xFFFFFFFF if the PivotTable specified by the name attribute is a [Non-Worksheet PivotTable](#Section_6ad0de69bcbd4c239b0f5018b86289e2). + +**name:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the name of the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) view on the worksheet specified by **tabId**. MUST match the **name** attribute of an existing [**pivotTableDefinition**](#Section_027c658596e24b7c9a8a02470415ac4a) element in the worksheet. The **createdVersion** attribute of the **CT_PivotTableDefinition** (\[ISO/IEC29500-4:2016\] section A.2) element that defines the specified PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) MUST be greater than or equal to 3. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2141. \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelineRange + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_TimelineState](#Section_aa9bf1321afa4ce9b3d2e6dc00e48fde) + +A complex type that specifies the date [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) for a CT_TimelineState element that is the parent of this element. + +*Attributes:* + +**startDate:** A **dateTime** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.7) attribute that specifies the start value of the date range. + +**endDate:** A **dateTime** attribute that specifies the end value of the date range. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2145. \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelineState + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_TimelineCacheDefinition](#Section_f45ff6effb624e198e8c822e3be9ef75) + +The **CT_TimelineState** complex type specifies the **Timeline state** (section [2.3.5.1.4](#Section_5ffb2144d8674acfac8e142cebc4d238)) of the **Timeline cache** (section [2.3.5.1](#Section_8a428bc98be342fab39e8d2bb83657a2)). + +*Child Elements:* + +**selection:** A **CT_TimelineRange** element (section [2.6.115](#Section_2d33e56b5e624cf18b6b63221b99c64c)) that specifies the start and end dates that are selected in the **Timeline view** (section [2.3.5.2](#Section_ca0c8a5be42e4aeab6850a236dff375e)). The start and end dates in the selection element MUST be interpreted as **dateTime** values ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.7). + +**bounds:** A **CT_TimelineRange** element that specifies the minimum and maximum dates available for display in the **Timeline view**. The minimum and maximum dates in the bounds element MUST be interpreted as **dateTime** values (\[XMLSCHEMA2/2\] section 3.2.7). + +**extLst:** A **CT_ExtensionList** element ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) that specifies future extensibility for this element. + +*Attributes:* + +**singleRangeFilterState:** A **Boolean** attribute (\[XMLSCHEMA2/2\] section 3.2.2) that specifies whether the filtering state of the **Timeline** (section [2.3.5](#Section_92ac3f95d5bb4584882e95e4e9c443c8)) is a contiguous date range. + +| Value | Meaning | +|----|----| +| "true" | The filtering state of the Timeline is a contiguous date range. | +| "false" | The filtering state of the Timeline is not a contiguous date range. | + +**minimalRefreshVersion:** An **unsignedInt** attribute (\[XMLSCHEMA2/2\] section 3.3.22) that specifies the minimum application version required to refresh the **Timeline cache.** + +**lastRefreshVersion:** An **unsignedInt** attribute that specifies the application version that last refreshed the **Timeline cache.** + +**pivotCacheId:** An **unsignedInt** attribute that specifies the associated [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) PivotCache. This element MUST be equal to the **pivotCacheId** attribute of an existing **CT_PivotCacheDefinition** element (section [2.6.33](#Section_2924f3f8a9cb4b098557fda87770d5bd)). + +**filterType:** An **ST_PivotFilterType** attribute (\[ISO/IEC29500-1:2016\] section 18.18.59) that specifies type of the **filter** (\[ISO/IEC29500-1:2016\] section 18.10.1.33) used in the **Timeline.** + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2149. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_WorkbookPr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [workbookPr](#Section_a74afac6ef62436fbd530dc503423f35) + +**CT_WorkbookPr** is a complex type that specifies additional properties for a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +*Attributes:* + +**chartTrackingRefBase:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies how [**data point**](#gt_cf31915d-9d25-4dbb-abc7-e78f60626dc4) properties and datalabels in all charts ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 21.2) in this workbook behave. + +| **Value** | **Meaning** | +|----|:---| +| True | Datapoint properties and datalabels ([\[MS-ODRAWXML\]](%5bMS-ODRAWXML%5d.pdf#Section_06cff208c6e14db7bb68665135e5f0de) section 2.2.1.2) in all charts (\[ISO/IEC29500-1:2016\] section 21.2) in this workbook follow their reference. | +| False | Datapoint properties and datalabels (\[MS-ODRAWXML\] section 2.2.1.2) in all charts (\[ISO/IEC29500-1:2016\] section 21.2) in this workbook follow their position in the chart. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2161. \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_TimelinePivotFilter + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_TimelineCacheDefinition](#Section_f45ff6effb624e198e8c822e3be9ef75) + +A complex type that specifies the filter used by the Timeline Cache (section [2.1.7](#Section_29a0f58cd94246418ed04f02010326f2)) to filter PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) views and [Non-Worksheet PivotTables](#Section_6ad0de69bcbd4c239b0f5018b86289e2). + +*Child Elements:* + +**autoFilter:** A **CT_AutoFilter** (\[ISO/IEC29500-1:2016\] section 18.3.1.2) element that specifies the embedded auto filter of the filter**.** + +*Attributes:* + +**useWholeDay:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether the **pivot filter** (\[ISO/IEC29500-1:2016\] section 18.10.1.33) associated with either the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) or Non-Worksheet PivotTable (section 2.3.3) filtered by the Timeline Cache (section 2.1.7) uses whole days in its filtering criteria. + +| Value | Meaning | +|----|----| +| "true" | The pivot filter (\[ISO/IEC29500-1:2016\] section 18.10.1.33) associated with either the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) or Non-Worksheet PivotTable (section 2.3.3) filtered by the Timeline Cache (section 2.1.7) uses whole days in its filtering criteria. | +| "false" | The pivot filter (\[ISO/IEC29500-1:2016\] section 18.10.1.33) associated with either the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) or Non-Worksheet PivotTable (section 2.3.3) filtered by the Timeline Cache (section 2.1.7) does not use whole days in its filtering criteria. | + +**fld:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the index of the [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) to which the **pivot filter** associated with this filter belongs to. + +**id:** An **unsignedInt** attribute that specifies the unique identifier of the **pivot filter** associated with this filter as assigned by the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) or Non-Worksheet PivotTable (section 2.3.3) filtered by the Timeline Cache (section 2.1.7). + +**name:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the name of the filter. This string MUST be less than or equal to 65,535 characters in length. + +**description:** An **ST_Xstring** attribute that specifies the description of the filter. This string MUST be less than or equal to 65,535 characters in length**.** + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2164. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ModelTextPr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_Connection](#Section_e2c29e600c7f4f55b4fd0cad215e6bb9) + +Specifies Model Data Source text importation ([\[MS-XLSB\]](%5bMS-XLSB%5d.pdf#Section_acc8aa921f02416799f584f9f676b95a) section 2.2.8.9.4) properties in addition to those specified in **CT_TextPr** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.2) element. + +*Attributes:* + +**headers:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether data imported by this connection has [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) headers. + +| Value | Meaning | +|---------|----------------------------------------------------------------| +| "true" | Data imported by this connection has column headers. | +| "false" | Data imported by this connection does not have column headers. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2174. \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RangePr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_Connection](#Section_e2c29e600c7f4f55b4fd0cad215e6bb9) + +The **CT_RangePr** complex type specifies properties of a Model Data Source Worksheet Data connection ([\[MS-XLSB\]](%5bMS-XLSB%5d.pdf#Section_acc8aa921f02416799f584f9f676b95a) section 2.2.8.9.3). + +*Attributes:* + +**sourceName:** An attribute of type **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) that specifies the string identifier of the source cell range for this connection. The string length MUST be less than or equal to 65,535 characters. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2177. \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DbTable + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_DbTables](#Section_797d3d5e1305477fba3b7d794412f3ec) + +The **CT_DbTable** complex type specifies a single database table that is used by a Model Data Source [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) connection ([\[MS-XLSB\]](%5bMS-XLSB%5d.pdf#Section_acc8aa921f02416799f584f9f676b95a) section 2.2.8.9.1) or Model Data Source Data Feed connection (\[MS-XLSB\] section 2.2.8.9.2). + +*Attributes:* + +**name:** An attribute of type **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) that specifies the database table name. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2180. \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DbTables + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_OledbPr](#Section_1fe459965be542a69e5602f9457560c4), [CT_DataFeedPr](#Section_ece183c064ff4b5c896d1db80ce6cf7f) + +The **CT_DbTables** complex type specifies the list of database tables that are used by a Model Data Source OLE DB connection ([\[MS-XLSB\]](%5bMS-XLSB%5d.pdf#Section_acc8aa921f02416799f584f9f676b95a) section 2.2.8.9.1) or Model Data Source Data Feed connection (\[MS-XLSB\] section 2.2.8.9.2). + +*Child Elements:* + +**dbTable:** An element of type **CT_DbTable** (section [2.6.121](#Section_a92a0ff212ca49cba050c5ef7072a821)) specifying a single database table that is used by this connection. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2183. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DbCommand + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_OledbPr](#Section_1fe459965be542a69e5602f9457560c4) + +The **CT_DbCommand** complex type specifies [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) command text that is used by a Model Data Source OLE DB connection ([\[MS-XLSB\]](%5bMS-XLSB%5d.pdf#Section_acc8aa921f02416799f584f9f676b95a) section 2.2.8.9.1). + +*Attributes:* + +**text:** An attribute of type **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) that specifies OLE DB command text. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2188. \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_OledbPr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_Connection](#Section_e2c29e600c7f4f55b4fd0cad215e6bb9) + +The **CT_OledbPr** complex type specifies properties of a Model Data Source OLE DB connection ([\[MS-XLSB\]](%5bMS-XLSB%5d.pdf#Section_acc8aa921f02416799f584f9f676b95a) section 2.2.8.9.1). + +*Child Elements:* + +**dbTables:** An element of type **CT_DbTables** (section [2.6.122](#Section_797d3d5e1305477fba3b7d794412f3ec)) specifying the list of database tables that are used by this connection. + +**dbCommand:** An element of type **CT_DbCommand** (section [2.6.123](#Section_3fa64a9a205d4754abeeefd2f48f1062)) specifying [**OLE DB**](#gt_333f4fb1-4882-48df-bce6-f9961b408f31) command text that is used by this connection. + +*Attributes:* + +**connection:** An attribute of type **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) that specifies the OLE DB connection string. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2191. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DataFeedPr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_Connection](#Section_e2c29e600c7f4f55b4fd0cad215e6bb9) + +Specifies properties of a Model Data Source Data Feed connection ([\[MS-XLSB\]](%5bMS-XLSB%5d.pdf#Section_acc8aa921f02416799f584f9f676b95a) section 2.2.8.9.2). + +*Child Elements:* + +**dbTables:** A [CT_DbTables](#Section_797d3d5e1305477fba3b7d794412f3ec) element that specifies the list of database tables used by this connection. + +*Attributes:* + +**connection:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies connection string. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2198. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CachedUniqueNames + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [cachedUniqueNames](#Section_f8b77928122640299cce1ea2dc2fdd47) + +A complex type that specifies the [**MDX unique names**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) for PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) cache items in this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) cache [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc). MUST NOT exist if the **model** attribute of [**CT_Connection**](#Section_e2c29e600c7f4f55b4fd0cad215e6bb9) element of connection (\[ISO/IEC29500-1:2016\] section 18.13.1) associated with this PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) pivot cache is not equal to "true". + +*Child Elements:* + +**cachedUniqueName:** A [CT_CachedUniqueName](#Section_d3f652a27b9d4165bdadabc6683b83e8) element that specifies the MDX unique name for a PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) cache item. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2204. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CachedUniqueName + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_CachedUniqueNames](#Section_a63887bd9d524920b4f2b2be9ce48b1d) + +A complex type that specifies the [**MDX unique name**](#gt_d5d555be-1be8-4d7b-b16e-0b04bc337b3b) for a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) cache item. + +*Attributes:* + +**index:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies an index of the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) cache item in this **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) cache [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc). MUST be less than **count** attributes of the **CT_Items** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element specified by the ancestor **CT_CacheField** (\[ISO/IEC29500-4:2016\] section A.2) element. MUST be unique within parent CT_CachedUniqueNames (section 2.6.126) collection. + +**name:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the MDX unique name. MUST be less than or equal to 65,535 characters in length. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2209. \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ModelTable + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_ModelTables](#Section_a8539c6c80e04db8b9f1860b9347fc65) + +Specifies properties of a single table in [**spreadsheet data model**](#gt_95ac50ee-8fc4-4dce-85e0-984684a68319). + +*Attributes:* + +**id:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies unique id of the spreadsheet data model table. + +**name:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies name of the spreadsheet data model table. + +**connection:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies name of the workbook connection associated with this spreadsheet data model table. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2213. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ModelTables + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_DataModel](#Section_eaea0fe63e3c401da3a02d2cbb9fce00) + +Specifies tables in the [**spreadsheet data model**](#gt_95ac50ee-8fc4-4dce-85e0-984684a68319). + +*Child Elements:* + +**modelTable:** A [CT_ModelTable](#Section_c64f88fcac844798b07cdca7ba5f232f) element that specifies properties of a single table in spreadsheet data model. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2218. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ModelRelationship + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_ModelRelationships](#Section_9136b3c1575546e4bc925a8edfe66519) + +Specifies a single relationship in the [**spreadsheet data model**](#gt_95ac50ee-8fc4-4dce-85e0-984684a68319). + +*Attributes:* + +**fromTable:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the name of the foreign key table for this relationship**.** + +**fromColumn:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the name of the foreign key table [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) for this relationship. + +**toTable:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the name of the primary key table for this relationship. + +**toColumn:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the name of the primary key table column for this relationship. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2223. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ModelRelationships + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_DataModel](#Section_eaea0fe63e3c401da3a02d2cbb9fce00) + +Specifies active relationships in the [**spreadsheet data model**](#gt_95ac50ee-8fc4-4dce-85e0-984684a68319). + +*Child Elements:* + +**modelRelationship:** A [CT_ModelRelationship](#Section_02c4fd22dfcb4cbbabc005fc16dd9db0) element that specifies a single relationship in the spreadsheet data model. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2229. \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DataModel + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [dataModel](#Section_523913d2fc1e473e8d145d2d4d7f9702) + +Specifies properties of a [**spreadsheet data model**](#gt_95ac50ee-8fc4-4dce-85e0-984684a68319). + +*Child Elements:* + +**modelTables:** A **CT_ModelTables** (section [2.6.129](#Section_a8539c6c80e04db8b9f1860b9347fc65)) element that specifies tables in the spreadsheet data model. + +**modelRelationships:** A **CT_ModelRelationships** (section [2.6.131](#Section_9136b3c1575546e4bc925a8edfe66519)) element that specifies active relationships in the spreadsheet data model. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**minVersionLoad:** An **unsignedByte** attribute that specifies the minimum application version required to load the spreadsheet data model in this workbook. This MUST be greater than or equal to 5. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2234. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotTableData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [pivotTableData](#Section_31ad0c9368d24bc49969dc4662acfa11) + +The **CT_PivotTableData** complex type specifies the **PivotValues** (section [2.3.4](#Section_dea9fdef82e54111b51e48a61a596992)) of the **PivotTable** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) that is specified by the **pivotTableReference** (section [2.4.1](#Section_ba9ab888b9894fe3afaeb5b64ccf7922)) element in the extension of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) (section [2.2.4.11](#Section_e29966e25baa4fcf84c9082025e1be13)). + +*Child Elements:* + +**pivotRow:** A **CT_PivotRow** (section [2.6.134](#Section_c61f34d0116e452ea2613a8e545579db)) element that specifies a single [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) of **PivotValueCells** (section [2.3.4.1](#Section_b513aa61a36146368a3f4850a3f2a588)) in an element of this type in the **PivotTable** (\[ISO/IEC29500-1:2016\] section 18.10) that is specified by the **pivotTableReference** (section 2.4.1) element in the extension of a workbook (section 2.2.4.11). + +*Attributes:* + +**rowCount:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the number of **pivotRow** child elements in an element of this type. This value MUST be equal to the value of the **count** attribute of the **rowItems** element, as specified in \[ISO/IEC29500-1:2016\] section 18.10.1.84. + +**columnCount:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute specifying the number of **PivotValueCells** (section 2.3.4.1) that are specified by the **CT_PivotValueCell** (section [2.6.135](#Section_680ed56527f24b4f8fbaaa2f5196ad81)) complex type in each of the **pivotRow** child elements of this type. This value MUST be equal to the value of the **count** attribute in the **pivotRow** element, as specified by the **CT_PivotRow** (section 2.6.134) complex type. This value MUST be equal to the value of the **count** attribute of the **colItems**, (\[ISO/IEC29500-1:2016\] section 18.10.1.17) element. + +**cacheId:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the associated [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache. + +The OLAP PivotTable PivotCache that is specified by this attribute MUST be extended by an **ext** (\[ISO/IEC29500-1:2016\] section 18.2.7) element that has a structure specified by a **CT_PivotCacheDefinition** (section [2.6.33](#Section_2924f3f8a9cb4b098557fda87770d5bd)) element. The **pivotCacheId** attribute of such a **CT_PivotCacheDefinition** element MUST be equal to this attribute. + +The OLAP PivotTable PivotCache that is specified by this attribute MUST also be extended by an **ext** element that has structure specified by a **CT_PivotCacheIdVersion** (section [2.6.138](#Section_9cc2fc49e4d24dbea98b061c5ef85033)) element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2242. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotRow + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_PivotTableData](#Section_cab1573991c54a2bb479749197afcfa2) + +A complex type that specifies a single [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) of [PivotValueCells](#Section_b513aa61a36146368a3f4850a3f2a588) in the pivotTableData element of a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) specified by the [pivotTableReference](#Section_ba9ab888b9894fe3afaeb5b64ccf7922) element in the extension of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) as specified by section [2.2.4.11](#Section_e29966e25baa4fcf84c9082025e1be13). + +*Child Elements:* + +**c:** A [CT_PivotValueCell](#Section_680ed56527f24b4f8fbaaa2f5196ad81) element that specifies a PivotValueCell. + +*Attributes:* + +**r:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the row index of this element. MUST be within the range of items as specified by the **rowCount** attribute of the complex type CT_PivotTableData. + +**count:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the number of child elements of type CT_PivotValueCell in the current **pivotRow** element. MUST be less than or equal to the value specified by the **columnCount** attribute of complex type CT_PivotTableData. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2250. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotValueCell + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_PivotRow](#Section_c61f34d0116e452ea2613a8e545579db) + +A complex type that specifies a [PivotValueCell](#Section_b513aa61a36146368a3f4850a3f2a588). + +*Child Elements:* + +**v:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) element that specifies the string representation of the [Value](#Section_a66488500de04d5da55005463ea0af8e) of a PivotValueCell. The attribute **t** of the parent **CT_PivotValueCell** element specifies how application interprets this element. + +**x:** A [CT_PivotValueCellExtra](#Section_0feafe1227974156a8f0ae132671ca1b) element that specifies the [server formatting](#Section_b12204156b084aac8999ba6620eac7fe) on the current **CT_PivotValueCell** element. + +*Attributes:* + +**i:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) index of the current **CT_PivotValueCell** element. MUST be within the range of items as specified by the **columnCount** attribute of complex type [CT_PivotTableData](#Section_cab1573991c54a2bb479749197afcfa2). + +**t:** An [ST_SXVCellType](#Section_1a7697e9328d4eb6b7cae501c5281662) attribute that specifies the type of the PivotValueCell represented by the parent element of this attribute. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2257. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotValueCellExtra + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_PivotValueCell](#Section_680ed56527f24b4f8fbaaa2f5196ad81) + +A complex type that specifies the **server formatting** (section [2.3.4.1.2](#Section_b12204156b084aac8999ba6620eac7fe)) for a **CT_PivotValueCell** element (section 2.6.135) that is the parent of this element. + +*Attributes:* + +**in:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies an index to the list of the numeric formats, specified by the **pivotTableServerFormats** element (section [2.4.2](#Section_781517a425dc4ce9be2b08a9d9c3f17d)) specified in the extension of a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) specified by the **pivotTableReference** element (section [2.4.1](#Section_ba9ab888b9894fe3afaeb5b64ccf7922)) in the extension of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe) as specified in section [2.2.4.11](#Section_e29966e25baa4fcf84c9082025e1be13). The value MUST be between zero and the **count** attribute of the **CT_PivotTableServerFormats** element (section [2.6.137](#Section_3a699774cab2482a85d151c78e000ce1)). + +**bc:** An **ST_UnsignedIntHex** (\[ISO/IEC29500-1:2016\] section 18.18.86) attribute that specifies the background color for the **CT_PivotValueCell** element (section 2.6.135) that is a parent of this element. The color is specified as a hexadecimal value in RGB space. + +**fc:** An **ST_UnsignedIntHex** (\[ISO/IEC29500-1:2016\] section 18.18.86) attribute that specifies the foreground color for the **CT_PivotValueCell** element that is a parent of this element. The color is specified as a hexadecimal value in RGB space. + +**i:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the **PivotValueCell** (section [2.3.4.1](#Section_b513aa61a36146368a3f4850a3f2a588)) specified by **CT_PivotValueCell**, that is a parent of this element, contains italic formatting**.** A value of one or true indicates this value contains italic formatting on the server. + +**un:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the **PivotValueCell** specified by **CT_PivotValueCell** that is a parent of this element contains underline formatting. A value of 1 or true indicates this value contains underline formatting on the server. + +**st:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the **PivotValueCell** specified by **CT_PivotValueCell** that is a parent of this element contains strikethrough formatting. A value of 1 or true indicates this value contains strikethrough formatting on the server. + +**b:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the **PivotValueCell** specified by **CT_PivotValueCell** that is a parent of this element contains bold formatting. A value of 1 or true indicates this value contains bold formatting on the server. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2265. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotTableServerFormats + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +A complex type that specifies a list of **CT_ServerFormat** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10.1.86) elements in a PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) that is specified by a [pivotTableReference](#Section_ba9ab888b9894fe3afaeb5b64ccf7922) element in the extension of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). MUST contain fewer than 231 elements. + +*Child Elements:* + +**serverFormat:** A **CT_ServerFormat** (\[ISO/IEC29500-1:2016\] section 18.10.1.86) element that specifies the numeric format for one or more [PivotValueCell](#Section_b513aa61a36146368a3f4850a3f2a588)s. + +*Attributes:* + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the number of **serverFormat** child elements in the collection. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2274. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotCacheIdVersion + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [pivotCacheIdVersion](#Section_1cbabb48679e437f8e9d2272eaf00023) + +A complex type that specifies the extended properties of a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) **PivotCache** definition. + +*Attributes:* + +**cacheIdSupportedVersion:** An **unsignedByte** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.24) attribute that specifies minimum version of the application where this **pivotCacheId** attribute of an existing [**CT_PivotCacheDefinition**](#Section_2924f3f8a9cb4b098557fda87770d5bd) element is guaranteed to be unique. + +**cacheIdCreatedVersion:** An **unsignedByte** (\[XMLSCHEMA2/2\] section 3.3.24) attribute that specifies the minimum version of the application where this **pivotCacheId** attribute of an existing **CT_PivotCacheDefinition** element can be changed upon saving the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2280. \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Timeline + +*Target namespace:* http://schemas.microsoft.com/office/drawing/2012/timeslicer + +*Referenced by:* [timeslicer](#Section_87d98951a5f04214a48b632eb60cc482) + +This complex type specifies which [timeline view](#Section_ca0c8a5be42e4aeab6850a236dff375e) is associated with this drawing element. + +*Child Elements:* + +**extLst:** A **CT_OfficeArtExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.5.1) element that specifies future extensibility for this element. + +*Attributes:* + +**name:** A **string** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that specifies the name of the timeline view (section 2.3.5.2) that is associated with this drawing element. The value of this attribute MUST match the value of the **name** attribute of a **timeline** element within the CT_Timelines element (section [2.6.110](#Section_696e862ce15d4c9ebf9e45e60b5c030c)) for the current [**worksheet**](#gt_2fdc6291-fa6a-48a6-afbb-04f910d68615). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2284. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.7](#Section_c4febed78f37443bb83d668ffd09d082) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_AbsolutePath + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/ac + +*Referenced by:* [absPath](#Section_2ed6e65f43d041c5a38bb89fa5b01580) + +**CT_AbsolutePath** is a complex type that specifies the absolute path to a workbook. + +*Attributes:* + +**url:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the URL string of the absolute path to the workbook**.** + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2290. \ + + \ + + \ + +See section [5.9](#Section_ce659475d5804104895fb72947105f24) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DataField + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [dataField](#Section_4d64087714574b1980d945dcac57aa46) + +This complex type specifies extended information about a **PivotTable** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) data [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) item (\[ISO/IEC29500-1:2016\] section 18.10.1.22). + +*Attributes:* + +**isCountDistinct:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies that the aggregation function which applies to this data field item (\[ISO/IEC29500-1:2016\] section 18.10.1.22) is the count of unique values. If this value is true, the subtotal attribute is ignored. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2293. \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Survey + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [survey](#Section_f0d2d8ba4f7749ddbf512c7a53734ae7) + +**CT_Survey** is a complex type that specifies the properties for a survey. + +*Child Elements:* + +**surveyPr:** A [CT_SurveyElementPr](#Section_6f620903d79540548df23f1ff56f37bf) element that specifies additional properties of the survey. + +**titlePr:** A CT_SurveyElementPr element that specifies additional properties associated with the title of the survey. + +**descriptionPr:** A CT_SurveyElementPr element that specifies additional properties associated with the description of the survey. + +**questions:** A [CT_SurveyQuestions](#Section_630db86ac092443a871d53fb2656c857) element that specifies the set of survey question elements associated with this survey. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**id:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the [**unique identifier (UID)**](#gt_3d9dd73b-8923-43cc-ac95-8103f17683d7) of the survey. This id MUST be unique within the [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + +**guid:** An **ST_Guid** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.4) attribute that identifies this survey. + +**title:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the title of the survey. + +**description:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the description of the survey. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2296. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SurveyQuestions + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_Survey](#Section_1d394e382b18495186f0e283b03b0cfd) + +**CT_SurveyQuestions** is a complex type that specifies a list of survey question elements present in a survey. + +*Child Elements:* + +**questionsPr:** A [CT_SurveyElementPr](#Section_6f620903d79540548df23f1ff56f37bf) element that specifies additional properties associated with the list of survey question elements. + +**question:** A [CT_SurveyQuestion](#Section_9a439a2aff0f45ddad06ebe35a8fad89) element that specifies one survey question in the list. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2309. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SurveyQuestion + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_SurveyQuestions](#Section_630db86ac092443a871d53fb2656c857) + +**CT_SurveyQuestion** is a complex type that specifies the properties of a survey question. + +*Child Elements:* + +**questionPr:** A [CT_SurveyElementPr](#Section_6f620903d79540548df23f1ff56f37bf) element that specifies additional properties associated with the survey question. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**binding:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the [**unique identifier (UID)**](#gt_3d9dd73b-8923-43cc-ac95-8103f17683d7) of the Table Column ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.5.1.3) to which the survey question is bound. MUST match the **id** of an existing Table Column (\[ISO/IEC29500-1:2016\] section 18.5.1.3) element within the Table (\[ISO/IEC29500-1:2016\] section 18.5) with which the survey is associated. + +**text:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the main text of the survey question. + +**type:** An [ST_QuestionType](#Section_71882fae8b3b44e697955bf186529e8a) attribute that specifies the type of the survey question. + +**format:** An [ST_QuestionFormat](#Section_7a2a01d1c2a34fa68f8566b458fa6dc5) attribute that specifies the format of answers to the survey question. + +**helpText:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies additional descriptive text associated with the survey question. + +**required:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether an answer for the survey question is required when filling in the corresponding survey. + +| Value | Meaning | +|----|----| +| "false" | The answer to the survey question is not required when filling in the survey. | +| "true" | The answer to the survey question is required when filling in the survey. | + +**defaultValue:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the default answer for the survey question. + +**decimalPlaces:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the number of digits after the decimal to use in a numerical answer to a survey question. MUST be less than or equal to 15. + +**rowSource:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the set of available answers for the survey question. The set of available answers is a semicolon delimited list of values. The string MUST conform to the following [**Augmented Backus-Naur Form (ABNF)**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) ([\[RFC5234\]](https://go.microsoft.com/fwlink/?LinkId=123096)) grammar: + +2315. rowsource = \[value\] / \*terminated-value value + + terminated-value = value ";" + + value = \*value-char-with-quote / quoted-value + + quoted-value = %x22 value-char-with-semicolon %x22 + + value-char-with-semicolon = value-char / ";" + + value-char-with-quote = value-char / %x22 + + ;value-char = as defined by the production Char in the [\[W3C-XML\]](https://go.microsoft.com/fwlink/?LinkId=113935) section 2.2, but MUST NOT be ";" or %x22 + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2321. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SurveyElementPr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_Survey](#Section_1d394e382b18495186f0e283b03b0cfd), [CT_SurveyQuestions](#Section_630db86ac092443a871d53fb2656c857), [CT_SurveyQuestion](#Section_9a439a2aff0f45ddad06ebe35a8fad89) + +**CT_SurveyElementPr** is a complex type that specifies additional properties of a survey element. + +*Child Elements:* + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**cssClass:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies a Cascading Style Sheet (CSS, [\[CSS-Level2-2009\]](https://go.microsoft.com/fwlink/?LinkId=182880)) class name to apply to the survey element. + +**bottom:** An **int** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.17) attribute that specifies the bottom boundary of this survey element in pixels. + +**top:** An **int** (\[XMLSCHEMA2/2\] section 3.3.17) attribute that specifies the top boundary of the survey element in pixels. + +**left:** An **int** (\[XMLSCHEMA2/2\] section 3.3.17) attribute that specifies the left boundary of the survey element in pixels. + +**right:** An **int** (\[XMLSCHEMA2/2\] section 3.3.17) attribute that specifies the right boundary of the survey element in pixels. + +**width:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the width of the survey element in pixels. + +**height:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the height of the survey element in pixels. + +**position:** An [ST_SurveyPosition](#Section_24948ebfadbf48048e62cf3a535eeb0d) attribute that specifies the type of positioning to be used on the survey element**.** + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2336. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Ref + +*Target namespace:* http://schemas.microsoft.com/office/excel/2006/main + +*Referenced by:* [ref](#Section_fd5bc8e23ec949028a8bc6179c3bb7b2) + +**CT_Ref** is a complex type that extends **ST_Ref** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.18.62) specifies a rectangular [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99). + +*Attributes:* + +**edited:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies that at least one cell in this range has been edited by an application version that is unable to read one or more ancestor records. + +**adjusted:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether this range has been adjusted by an application version that is unable to read one or more ancestor records. + +**adjust:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether application versions that are unable to read one or more ancestor records will adjust this range if the contents of the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that this range refers to are changed. MUST be TRUE if **adjusted** is TRUE. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2349. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.1](#Section_b0ddba06ac734d3da9138fbe4a56cf28) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Sqref + +*Target namespace:* http://schemas.microsoft.com/office/excel/2006/main + +*Referenced by:* [sqref](#Section_4d7cc4156c514c718dbda2e28bdd9193), [CT_ConditionalFormatting](#Section_98f4ba7ab8f8496992a0d671d5d8ca8a), [CT_DataValidation](#Section_89029dfc1ca84ff9afe046f9454d09c6), [CT_Sparkline](#Section_6b28a993e0fd451d860e35097c6baa77), [CT_IgnoredError](#Section_20e3a54065ec47c4aa4c44677306292c), [CT_ProtectedRange](#Section_85f5567f259941adae268cfab23ce754) + +**CT_Sqref** is a complex type that extends **ST_Sqref** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.18.76) specifies a sequence of cell references. + +*Attributes:* + +**edited:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies that at least one cell in this [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) has been edited by an application version that is unable to read one or more ancestor records. + +**split:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies that this range has been split. + +**adjusted:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether this range has been adjusted by an application version that is unable to read one or more ancestor records. + +**adjust:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether application versions that are unable to read one or more ancestor records will adjust this range if the contents of the [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) that this range refers to are changed. MUST be TRUE if **adjusted** is TRUE. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2358. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.1](#Section_b0ddba06ac734d3da9138fbe4a56cf28) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ApplicationNonVisualDrawingProps + +*Target namespace:* http://schemas.microsoft.com/office/excel/2010/spreadsheetDrawing + +*Referenced by:* [CT_ContentPart](#Section_72e2f347451445ef887341988eda2835) + +Non-visual ContentPart properties. + +*Attributes:* + +**macro:** A **string** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that contains an XL macro string. + +**fPublished:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that serves as a Flag to determine whether the shape will be published on XL server. + +| Value | Meaning | +|---------|-----------------------------------------------| +| "true" | The shape will be published on XL server. | +| "false" | The shape will not be published on XL server. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2368. \ + + \ + + \ + + \ + +See section [5.8](#Section_b54c3971c1684f9c8791c07f8d8d8002) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CacheSourceExt + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +Extended description of the data source whose data is stored in the pivot cache. + +*Child Elements:* + +**sourceConnection:** A [CT_SourceConnection](#Section_7e7a428df5b447cca70a17e0126fa39e) element that specifies the source connection of the pivot cache. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2372. \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ContentPart + +*Target namespace:* http://schemas.microsoft.com/office/excel/2010/spreadsheetDrawing + +*Referenced by:* [contentPart](#Section_c9195b18e4a04751bc593a3685369b64) + +Specifies a reference to XML content in a format not specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065). + +*Child Elements:* + +**nvContentPartPr:** A [CT_ContentPartNonVisual](#Section_f47d0a5fda12485f9c9003b482a0dca5) element that specifies the non-visual properties of the content part. + +**nvPr:** A [CT_ApplicationNonVisualDrawingProps](#Section_c7749230db394748916854710261d8f1) element that specifies non-visual drawing-specific properties. + +**xfrm:** A CT_Transform2D (\[ISO/IEC29500-1:2016\] section A.4.1) element that specifies the 2-D transform for the content part. + +**extLst:** A CT_OfficeArtExtensionList (\[ISO/IEC29500-1:2016\] section A.4.1) element that specifies future extensibility for this element. + +*Attributes:* + +**r:id:** An ST_RelationshipId (\[ISO/IEC29500-1:2016\] section 22.8.2.1) attribute that specifies the relationship identifier to a content part. + +**bwMode:** An ST_BlackWhiteMode (\[ISO/IEC29500-1:2016\] section 20.1.10.10) attribute that specifies how to interpret color information contained within a content part to achieve a color, black and white, or grayscale rendering of the content part. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2377. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.8](#Section_b54c3971c1684f9c8791c07f8d8d8002) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ContentPartNonVisual + +*Target namespace:* http://schemas.microsoft.com/office/excel/2010/spreadsheetDrawing + +*Referenced by:* [CT_ContentPart](#Section_72e2f347451445ef887341988eda2835) + +Non-visual ContentPart properties. + +*Child Elements:* + +**cNvPr:** A CT_NonVisualDrawingProps ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.4.1) element that specifies non-visual drawing properties of the content part. This enables additional information that does not affect the appearance of the content part to be stored. + +**cNvContentPartPr:** A CT_NonVisualInkContentPartProperties ([\[MS-ODRAWXML\]](%5bMS-ODRAWXML%5d.pdf#Section_06cff208c6e14db7bb68665135e5f0de) section 2.3.3.7) element that specifies non-visual [**ink**](#gt_9fcdd1d5-3563-49b9-8a2e-bf696fb08fd0) properties of the content part. This enables additional information that does not affect the appearance of ink in the content part to be stored. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2387. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.8](#Section_b54c3971c1684f9c8791c07f8d8d8002) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CalculatedTimeColumn + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2014/11/main + +*Referenced by:* [CT_ModelTimeGrouping](#Section_d522a13fbe804fc982a8b439642e64d0) + +Specifies information about a single calculated time column**.** + +*Attributes:* + +**columnName:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the model column name for a specific time grouping granularity. + +**columnId:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the model column immutable identifier for a specific time grouping. + +**contentType:** An [ST_ModelTimeGroupingContentType](#Section_1a590486bc2e42418e6e671b580fb89c) attribute that specifies the type of content stored in this [**calculated column**](#gt_ec25719c-0814-4978-a7e7-f18111a9598d). + +**isSelected:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether this grouping granularity was applied in the last time grouping selection. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2393. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.10](#Section_4fe24a216f694680882ff86b16a69119) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ModelTimeGrouping + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2014/11/main + +*Referenced by:* [CT_ModelTimeGroupings](#Section_8e96dc6297234ffb9cb788fdd8e0ad39) + +Specifies information about a single data model time grouping. + +*Child Elements:* + +**calculatedTimeColumn:** A **CT_CalculatedTimeColumn** (section [2.6.152](#Section_65dfaa1784dc40d2bc199e49c81c4ff9)) element that specifies information about a data model time grouping [**calculated column**](#gt_ec25719c-0814-4978-a7e7-f18111a9598d). + +*Attributes:* + +**tableName:** An ST_Xstring ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the model table name for this time grouping. + +**columnName:** An ST_Xstring (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the model column name for this time grouping. + +**columnId:** An ST_Xstring (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the model column immutable identifier for this time grouping. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2399. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.10](#Section_4fe24a216f694680882ff86b16a69119) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ModelTimeGroupings + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2014/11/main + +*Referenced by:* [modelTimeGroupings](#Section_540bec4f4eae4357bd8a6a3d7963e315) + +Specifies information about data model time groupings. + +*Child Elements:* + +**modelTimeGrouping:** A **CT_ModelTimeGrouping** (section [2.6.153](#Section_d522a13fbe804fc982a8b439642e64d0)) element that specifies information about data model single time grouping. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2407. \ + + \ + + \ + + \ + + \ + +See section [5.10](#Section_4fe24a216f694680882ff86b16a69119) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RevisionPtr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2014/revision + +*Referenced by:* [revisionPtr](#Section_5082e3cfb0204599b6563b4207f0470d) + +This element specifies metadata supporting runtime scenarios for Microsoft Excel. + +*Attributes:* + +**revIDLastSave:** An [ST_Xrevid](#Section_80dd294a87b644019f5129bef2a4e6ee) attribute that SHOULD be ignored. + +**documentId:** An ST_Xstring ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that SHOULD be ignored. + +**xr6:coauthVersionLast:** An unsignedInt ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that SHOULD be ignored. + +**xr6:coauthVersionMax:** An unsignedInt (\[XMLSCHEMA2/2\] section 3.3.22) attribute that SHOULD be ignored. + +**xr10:uidLastSave:** An ST_Guid (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that SHOULD be ignored. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2412. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.15](#Section_5ba37a83255b4e2dae7bb4d14d44ad3a) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotTableDefinition16 + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2016/pivotdefaultlayout + +*Referenced by:* [pivotTableDefinition16](#Section_00fc52cc16cb4e80997bf95a9d46750e) + +This element specifies additional properties of a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) view. + +*Attributes:* + +**EnabledSubtotalsDefault:** A boolean ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether subtotals are enabled by default for the PivotTable. + +**SubtotalsOnTopDefault:** A boolean (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether enabled subtotals are on the top of the PivotTable by default. + +**InsertBlankRowDefault:** A boolean (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether blank rows are inserted into the PivotTable by default. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2419. \ + + \ + + \ + + \ + + \ + +See section [5.19](#Section_9b107b7d1fe8476f9ba5f237ceaf6a0e) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Array + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_ArrayData](#Section_588d1e0ed3ae40ca9fd12f172f050b09) + +This element specifies the properties of a single [**rich array**](#gt_4b9137fd-391c-4d11-9488-c5d535d68feb). + +*Child Elements:* + +**v:** A [CT_ArrayValue](#Section_1e7ed3935fe346219fb8328461535262) element that specifies a [**data type**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) and value in the rich array. If the **c** attribute is not present, then the total number of **CT_ArrayValue** elements MUST be equal to the **r** attribute. If the **c** attribute is present, then the total number of **CT_ArrayValue** elements MUST be equal to the **r** attribute multiplied by the **c** attribute. + +Certain data types indicate that the value represents an index as described in the table below. + +| Value | Meaning | +|----|----| +| "a" | The **CT_ArrayValue** identifies a rich array. This is a zero-based index. This index MUST reference a **CT_Array** that comes before the current **CT_Array** in the list specified in **CT_ArrayData** (section 2.6.158). | +| "r" | The **CT_ArrayValue** identifies a **CT_RichValue** specified in section [2.6.175](#Section_b8d7927a79b44f2cb76b3a6e9cd7ad40). This is a zero-based index. This index MUST reference a **CT_RichValue** that comes before the **CT_RichValue** that contains the current **CT_Array** in the list specified in **CT_RichValueData** (section [2.6.177](#Section_4b53ebeff1fc4521b78847a5e347d66c)). | + +*Attributes:* + +**r:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the number of rows for the rich array. This number MUST be less than or equal to 1048576. + +**c:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the number of columns for the array. This number MUST be less than or equal to 16384. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2424. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ArrayData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [arrayData](#Section_380bf95b864c405fa2b76cb05d343404) + +A complex type that specifies the values for [**rich arrays**](#gt_4b9137fd-391c-4d11-9488-c5d535d68feb). + +*Child Elements:* + +**a:** A [CT_Array](#Section_17c61c05de454485b0b99337b6b2fe6b) element that specifies a single rich array. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the count of rich arrays. The number of **CT_Array** elements MUST match this count. This count MUST be less than or equal to 2147483647. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2431. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ArrayValue + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_Array](#Section_17c61c05de454485b0b99337b6b2fe6b) + +A complex type that specifies the value and type of an element in a [**rich array**](#gt_4b9137fd-391c-4d11-9488-c5d535d68feb). + +*Attributes:* + +**t:** An [ST_ArrayValueType](#Section_1b1424250abb422086ccaa5cde3f87a5) attribute that specifies the [**data type**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) of the rich array value. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2438. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CustomRichFilter + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_CustomRichFilters](#Section_8793aa6c536b4de189b549d2bef4517c) + +A complex type that specifies a custom [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) criterion that is associated with a [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). + +*Attributes:* + +**key:** An **ST_RichFilterKey** (section [2.7.38](#Section_507c630c2a9748c9af7a478d3181eda5)) attribute that specifies the [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) for which the filters is defined. + +**operator:** An **ST_FilterOperator** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.18.31) attribute that specifies the operator of the custom filter criterion. + +**val:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the value to be used as a custom filter criterion. The length of this value MUST be less than 65536 characters. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2445. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CustomRichFilters + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichFilterColumn](#Section_407edac1996743cd9b675816e6eadca6) + +This complex type specifies custom [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) criteria associated with [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). [**Rows**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) that contain a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the filter [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) such that the value does not meet the custom filter criteria will be hidden. + +*Child Elements:* + +**customFilter:** A [CT_CustomRichFilter](#Section_c9ffab2d6f0445a9bbf10511538e8909) element that specifies custom filter criterion that is associated with a rich value. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**and:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies the relationship between custom filter criterion. This attribute only applies when there are two criteria: + +| Value | Meaning | +|----|----| +| "false" | The two criteria are related by an OR relationship. That is, for a cell value to meet the custom filter criteria, at least one criterion specified by the **customFilter** child elements MUST be met. | +| "true" | The two criteria are related by an AND relationship. That is, for a cell value to meet the custom filter criteria, both criteria specified by the **customFilter** child elements MUST be met. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2452. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DynamicRichFilter + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichFilterColumn](#Section_407edac1996743cd9b675816e6eadca6) + +This complex type specifies the dynamic [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) criteria associated with [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). These criteria are considered dynamic because they can change, either with the data itself (e.g., "above average") or with the current system date (e.g., show values for "today"). For any [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the filter [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) whose values do not meet the specified criteria, the corresponding [**rows**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) will be hidden from view when the filter is applied. This complex type extends the base type **CT_DynamicFilter** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.3.2.5) + +*Attributes:* + +**key:** An **ST_RichFilterKey** (section [2.7.38](#Section_507c630c2a9748c9af7a478d3181eda5)) attribute that specifies the [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) for which the filters is defined. + +**type:** An **ST_DynamicFilterType** (\[ISO/IEC29500-1:2016\] section 18.18.26) attribute that specifies the type of dynamic filter. + +**val:** A **double** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.5) [**attribute**](#gt_108a1419-49a9-4d19-b6ca-7206aa726b3f) that specifies a minimum value for dynamic filter. It is inclusive for today, yesterday, tomorrow, nextWeek, thisWeek, lastWeek, nextMonth, thisMonth, lastMonth, nextQuarter, thisQuarter, lastQuarter, nextYear, thisYear, lastYear, and yearToDate. The **val** attribute is not required for Q1, Q2, Q3, Q4, M1, M2, M3, M4, M5, M6, M7, M8, M9, M10, M11 and M12. It is exclusive for aboveAverage and belowAverage. + +**maxVal:** A **double** (\[XMLSCHEMA2/2\] section 3.2.5) attribute that specifies a maximum value for dynamic filter. It is exclusive and required for today, yesterday, tomorrow, nextWeek, thisWeek, lastWeek, nextMonth, thisMonth, lastMonth, nextQuarter, thisQuarter, lastQuarter, nextYear, thisYear, lastYear, and yearToDate. + +**valIso:** A **dateTime** (\[XMLSCHEMA2/2\] section 3.2.7) attribute that specifies a minimum value for dynamic filter. (See description of the **maxValIso** attribute to understand when the **valIso** attribute is required.) + +**maxValIso:** A **dateTime** (\[XMLSCHEMA2/2\] section 3.2.7) attribute that specifies a maximum value for dynamic filter. The **maxValIso** attribute is required for today, yesterday, tomorrow, nextWeek, thisWeek, lastWeek, nextMonth, thisMonth, lastMonth, nextQuarter, thisQuarter, lastQuarter, nextYear, thisYear, lastYear, and yearToDate. + +The above criteria are based on a value range; that is, if today's date is September 22nd, then the range for thisWeek is the values greater than or equal to September 17 and less than September 24. In the thisWeek range, the lower value is expressed valIso. The higher value is expressed using the **maxValIso** attribute. + +These dynamic filters do not require the **valIso** or **maxValIso** attributes: + +Q1, Q2, Q3, Q4, M1, M2, M3, M4, M5, M6, M7, M8, M9, M10, M11 and M12. + +The above criteria shall not specify the range using **valIso** and **maxValIso** because Q1 starts from M1 to M3, and M1 is January. + +These types of dynamic filters use **valIso** and do not use **maxValIso**: + +aboveAverage and belowAverage + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2461. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Key + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata + +*Referenced by:* [CT_RichValueStructure](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc) + +This complex type specifies the [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3). + +*Attributes:* + +**n:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) [**attribute**](#gt_108a1419-49a9-4d19-b6ca-7206aa726b3f) that specifies the name of the rich value key. This name is case insensitive and MUST be unique in the **CT_RichValueStructure**. This string MUST be less than or equal to 255 characters in length. + +**t:** An [ST_RichValueValueType](#Section_84e6b00943e543dd80b0556d593bc698) attribute that specifies the [**data type**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) of the value associated with this key. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2468. \ + + \ + + \ + + \ + +See section [5.21](#Section_9058338fcf3b4a7b8f84622e180eacc5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichDateGroupItem + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichFilters](#Section_e0526e572ec448bdb28ff1b14eb8501f) + +This complex type specifies a group of dates or times which are used in a [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) criteria associated with [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). This complex type extends the base type **CT_DateGroupItem** (\[[\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.3.2.4). + +*Attributes:* + +**key:** An **ST_RichFilterKey** (section [2.7.38](#Section_507c630c2a9748c9af7a478d3181eda5)) attribute that specifies the [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) for which the filters is defined. + +**year:** An **unsignedShort** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.23) attribute that specifies the year (4 digits). + +**month:** An **unsignedShort** (\[XMLSCHEMA2/2\] section 3.3.23) attribute that specifies the month (1-12). + +**day:** An **unsignedShort** (\[XMLSCHEMA2/2\] section 3.3.23) attribute that specifies the day (1-31). + +**hour:** An **unsignedShort** (\[XMLSCHEMA2/2\] section 3.3.23) attribute that specifies the hour (0-23). + +**minute:** An **unsignedShort** (\[XMLSCHEMA2/2\] section 3.3.23) attribute that specifies the minute (0-59). + +**second:** An **unsignedShort** (\[XMLSCHEMA2/2\] section 3.3.23) attribute that specifies the second (0-59). + +**dateTimeGrouping:** An **ST_DateTimeGrouping** (\[ISO/IEC29500-1:2016\] section 18.18.22) attribute that specifies the grouping level. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2472. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichFilter + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichFilters](#Section_e0526e572ec448bdb28ff1b14eb8501f) + +This complex type specifies a [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) criterion associated with [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). [**Rows**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) that contain a rich value within the filter [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that have [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f) with value **val** and key **key** will not be hidden by this filter criterion. Rows that do not contain such a rich value will be hidden. + +*Attributes:* + +**key:** An **ST_RichFilterKey** (section [2.7.38](#Section_507c630c2a9748c9af7a478d3181eda5)) attribute that specifies the [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) for which the filters is defined. + +**val:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the value to be used as a filter criterion. The length of this value MUST be less than 65536 characters. + +**blank:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether the filter criterion includes blank values. + +**nodata:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the filter includes values that do not have the specified rich value key. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2479. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichFilters + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichFilterColumn](#Section_407edac1996743cd9b675816e6eadca6) + +This complex type specifies a [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) with multiple criteria associated with [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). + +*Child Elements:* + +**filter:** A [CT_RichFilter](#Section_602d53f6e36b419c8961a3f4daee98d1) element that specifies a filter criterion associated with rich values. [**Rows**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) that contain a rich value within the filter [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) that have a [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f) with value **val** and key **key** will not be hidden by this filter criterion. Rows that do not contain such a rich value will be hidden. + +**dateGroupItem:** A [CT_RichDateGroupItem](#Section_800e0c6cdb9d49c5abebdee0b3690f08) element that specifies a group of dates or times which are used in a filter criteria associated with rich values. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2485. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichFormatProperties + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichStylesheet](#Section_43e346e0d85448c39fd6b0f70300b408) + +This complex type specifies a list of properties for [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) formats. + +*Child Elements:* + +**rPr:** A [CT_RichFormatProperty](#Section_c2a904f51e464f588f9feb245df5ce79) element that specifies a property for rich value formats. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2492. \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichFormatProperty + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichFormatProperties](#Section_479db4e3edd24d198984023d3a081558) + +This complex type specifies a property for [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) formats. + +*Attributes:* + +**n:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the name of the property. + +**t:** An [ST_RichFormatPropertyType](#Section_88a6da0ab15842ca863d4f4979104977) attribute that specifies the [**data type**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) of the property. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2497. \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichSortCondition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [richSortCondition](#Section_d22f5ce6c38b4a75b3c0e364d694aa2a), [CT_SortRule](#Section_cd611e3d7b67404d8934bd2b6e738c75) + +This complex type specifies [**sort conditions**](#gt_198a56e7-6045-43cf-8acd-793eab3647c1) associated with [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). + +*Attributes:* + +**richSortKey:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) for which the sort condition is defined. This string MUST be less than or equal to of 255 characters in length. + +**descending:** A boolean ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies the direction of the [**sort**](#gt_95f9d655-2668-4f39-889e-9d4040d05880). + +| Value | Meaning | +|----|----| +| "false" | If **sortBy** is "value", sort in ascending order. If **sortBy** is "cellColor" or "fontColor", cells in which the cell color or cell font color specified by **dxfId** occurs are ordered at the top of the range. If **sortBy** is "icon", cells in which the icon specified by **iconSet** and **iconId** occurs are ordered at the top of the range. | +| "true" | If **sortBy** is "value", sort in descending order. If **sortBy** is "cellColor" or "fontColor", cells in which the cell color or cell font color specified by **dxfId** occurs are ordered at the bottom of the range. If **sortBy** is "icon", cells in which the icon specified by **iconSet** and **iconId** occurs are ordered at the bottom of the range. | + +**sortBy:** An **ST_SortBy** (\[ISO/IEC29500-1:2016\] section 18.18.72) attribute that specifies how the cells in a range are sorted. + +**ref:** An **ST_Ref** (\[ISO/IEC29500-1:2016\] section 18.18.62) attribute that specifies the [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) or [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) to which this sort condition applies. This value MUST be contained within the **ref** in the **sortState** (\[ISO/IEC29500-1:2016\] section 18.3.1.92) element that precedes this element. If the **sortState.columnSort** attribute that precedes this element is "false", this value specifies the column to which this sort condition applies and there MUST be only a single column specified by **ref**. If the **sortState.columnSort** attribute that precedes this element is "true", this value specifies the row to which this sort condition applies and there MUST be only a single row specified by **ref**. + +**customList:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies a comma-delimited list of strings that specifies a custom [**sort order**](#gt_58099001-70b9-4664-91fa-6035629bccb7). The order of strings in the list specifies the sort order. When a cell value matches a string in the list, it is sorted ahead of the cell values that match a later string in the list, and so on for each cell in the range. MUST be ignored if **sortBy** is not equal to "value". + +**dxfId:** An **ST_DxfId** (\[ISO/IEC29500-1:2016\] section 18.18.25) attribute that specifies the format identifier when **sortBy** equals "cellColor" or **sortBy** equals "fontColor". MUST NOT be present if **sortBy** equals "icon" or "value". + +**iconSet:** An [ST_IconSetType](#Section_bfdf00a54e494b00880332250e1683c2) attribute that specifies the icon set when **sortBy** equals "icon". The absence of this attribute means no icon. MUST NOT be present if **sortBy** is not equal to "icon". + +**iconId:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the zero-based index of an icon in an [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9). If the icon set specified by **iconSet** has three icons, this value MUST be less than or equal to 2. If the icon set specified by **iconSet** has four icons, this value MUST be less than or equal to 3. If the icon set specified by **iconSet** has five icons, this value MUST be less than or equal to 4. The absence of this attribute means no icon. MUST NOT be present if **sortBy** is not equal to "icon". + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2501. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichStyle + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichStyles](#Section_529508cf873e43bdb68e4df453246713) + +This complex type specifies a list of properties and optional style differential formats (DXFs) ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8) associated with [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). + +*Child Elements:* + +**rpv:** A [CT_RichStylePropertyValue](#Section_dc01de23338b4f3ca3586c754b95cf84) element that specifies the value of and identifier to the **CT_RichFormatProperty** (section [2.6.168](#Section_c2a904f51e464f588f9feb245df5ce79)). + +*Attributes:* + +**dxfid:** An **ST_DxfId** (\[ISO/IEC29500-1:2016\] section 18.18.25) attribute that specifies the identifier to **CT_Dxfs** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) in the styles part. This is a zero-based index. See \[ISO/IEC29500-1:2016\] section 18.8.30 in Style for more information on formats. This simple type’s contents are a restricted by the **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) data type. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2508. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichStylePropertyValue + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichStyle](#Section_c803b251e3154140845ccd679b6e98ba) + +This complex type specifies the value of and identifier to a **CT_RichFormatProperty** (section [2.6.168](#Section_c2a904f51e464f588f9feb245df5ce79)). + +*Attributes:* + +**i:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) 3.3.22) attribute that specifies the identifier to a **CT_RichFormatProperty**. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2514. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichStyles + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichStylesheet](#Section_43e346e0d85448c39fd6b0f70300b408) + +This complex type specifies a list of [**styles**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) associated with [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). + +*Child Elements:* + +**rSty:** A [CT_RichStyle](#Section_c803b251e3154140845ccd679b6e98ba) element that specifies a list of properties and optional style differential formats (DXFs) ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8) associated with rich values. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2521. \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichStylesheet + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [richStyleSheet](#Section_357034a59f4649c99ad1d5b38738110d) + +This complex type contains [**style**](#gt_b1e1f096-9da0-411f-909a-f69b92c17633) information associated with [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). + +*Child Elements:* + +**dxfs:** A **CT_Dxfs** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies the list of style differential formats (DXFs), as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8. + +**richProperties:** A [CT_RichFormatProperties](#Section_479db4e3edd24d198984023d3a081558) element that specifies a list of properties for rich value formats. + +**richStyles:** A [CT_RichStyles](#Section_529508cf873e43bdb68e4df453246713) element that specifies a list of styles associated with rich values. + +**extLst:** A **CT_ExtensionList** (\[ISO/IEC29500-4:2016\] section A.2) element that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2526. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichTop10 + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichFilterColumn](#Section_407edac1996743cd9b675816e6eadca6) + +This complex type specifies a [**top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9) or [**bottom N filter**](#gt_11ba3d33-d05f-4eda-9631-aa6d4942e277). This complex type extends the base type **CT_Top10** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.3.2.10). + +*Attributes:* + +**key:** An **ST_RichFilterKey** (section [2.7.38](#Section_507c630c2a9748c9af7a478d3181eda5)) attribute that specifies the [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) for which the [**filters**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) is defined. + +**top:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether a top N filter or a bottom N filter is applied. True indicates a top N filter is applied. False indicates a bottom N filter is applied. + +**percent:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies whether the top N filter or bottom N filter is based on a percentage of the total sum of values in the [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) or not. True indicates value filters by a percent value of the column. False indicates value filters by number of items. + +**val:** A **double** (\[XMLSCHEMA2/2\] section 3.2.5) attribute that specifies the top or bottom value to use as the filter criteria. + +**filterVal:** A **double** (\[XMLSCHEMA2/2\] section 3.2.5) attribute that specifies the actual cell value or [**rich value data**](#gt_26aa395d-2e6a-4071-b25c-95e20adf8ac3) in the range which is used to perform the comparison for this filter. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2534. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValue + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata + +*Referenced by:* [CT_RichValueData](#Section_4b53ebeff1fc4521b78847a5e347d66c) + +This complex type specifies [**rich value data**](#gt_26aa395d-2e6a-4071-b25c-95e20adf8ac3) information for a single [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). + +*Child Elements:* + +**fb:** A [CT_RichValueFallback](#Section_56b98662f6e04e7886497ec216b10680) element that specifies the [**rich value fallback**](#gt_a90d0ec0-088b-4f60-a153-198666294d07). + +**v:** A [CT_Value](#Section_80ad02f001ed41459b3a9732db22eba8) element that specifies a value contained in the rich value as part of a [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f). The [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) and [**data type**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) is determined by matching the index of the **CT_Value** with the index of the **CT_Key** (section [2.6.163](#Section_a6955ad1aef84ea2b754909220e4439e)) in the **CT_RichValueStructure** (section [2.6.180](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc)) identified by the **s** attribute. + +Certain data types indicate that the value represents an index as described in the table below. + +| Value | Meaning | +|----|----| +| "a" | The **CT_Value** identifies a **CT_Array** specified in section [2.6.157](#Section_17c61c05de454485b0b99337b6b2fe6b). This is a zero-based index. | +| "r" | The **CT_Value** identifies a **CT_RichValue** specified in this section. This is a zero-based index. This index MUST reference a **CT_RichValue** that comes before the current **CT_RichValue** in the list specified in **CT_RichValueData** (section 2.6.177). | +| "spb" | The **CT_Value** identifies a **CT_SupportingPropertyBag** specified in section [2.6.188](#Section_1e24d4a8d93f48e79370e7f79af427df). This is a zero-based index. | + +*Attributes:* + +**s:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the identifier to the **CT_RichValueStructure** (section 2.6.180). This is a zero-based index. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2541. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.21](#Section_9058338fcf3b4a7b8f84622e180eacc5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueBlock + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata + +*Referenced by:* [rvb](#Section_d54dccb62ecc475d97fe4a9ae5d3f94e) + +This complex type specifies the identifier for the **CT_RichValue** (section [2.6.175](#Section_b8d7927a79b44f2cb76b3a6e9cd7ad40)). + +*Attributes:* + +**i:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the identifier for the **CT_RichValue** (section 2.6.175). This is a zero-based index. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2548. \ + + \ + + \ + +See section [5.21](#Section_9058338fcf3b4a7b8f84622e180eacc5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata + +*Referenced by:* [rvData](#Section_42c032f4086248f99b9bd20b6e946fa6) + +This complex type specifies a list of [**rich value data**](#gt_26aa395d-2e6a-4071-b25c-95e20adf8ac3) elements. + +*Child Elements:* + +**rv:** A [CT_RichValue](#Section_b8d7927a79b44f2cb76b3a6e9cd7ad40) element that specifies rich value data information for a single [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the count of **CT_RichValue** elements. The number of **CT_RichValue** elements MUST match this count. This count MUST be less than or equal to 2147483647. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2551. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.21](#Section_9058338fcf3b4a7b8f84622e180eacc5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueFallback + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata + +*Referenced by:* [CT_RichValue](#Section_b8d7927a79b44f2cb76b3a6e9cd7ad40) + +This complex type specifies the [**rich value fallback**](#gt_a90d0ec0-088b-4f60-a153-198666294d07). + +*Attributes:* + +**t:** An [ST_RichValueFallbackType](#Section_4609620387f248f584ffbf80d6ba8511) attribute that specifies the [**data type**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) of the rich value fallback. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2558. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.21](#Section_9058338fcf3b4a7b8f84622e180eacc5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueGlobalType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichValueTypesInfo](#Section_6b2ed0e075bc4118ad12327520402707) + +This complex type specifies information that applies to all [**rich value types**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100). + +*Child Elements:* + +**keyFlags:** A [CT_RichValueTypeKeyFlags](#Section_97203575155141158abab4c9602a9cb9) element that specifies the values of [**rich value key flags**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2) that differ from the defaults for all rich value types. See sections under section [2.3.6.1](#Section_8c1f2a3e2f7b4eacbaf0ef2173648b42) for specific type definitions. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2565. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueStructure + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata + +*Referenced by:* [CT_RichValueStructures](#Section_b12b8314fe2a4a5e81177b83b6bcb5d2) + +This complex type specifies the structure for one or more [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). + +*Child Elements:* + +**k:** A [CT_Key](#Section_a6955ad1aef84ea2b754909220e4439e) element that specifies the [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3). + +*Attributes:* + +**t:** A **string** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that specifies the name of the [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2571. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.21](#Section_9058338fcf3b4a7b8f84622e180eacc5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueStructures + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata + +*Referenced by:* [rvStructures](#Section_5a37902a0bc243ea8039d68aa4344f76) + +This complex type specifies the list of [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) structures. + +*Child Elements:* + +**s:** A [CT_RichValueStructure](#Section_7dfa3a06e4c84aa8acd5359a16cb3dbc) element that specifies the structure for one or more rich values**.** + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the count of [**supporting property bag**](#gt_048a0082-4ff4-4807-8300-69ccc781c098) child elements. The number of **CT_RichValueStructure** elements MUST match this count. This count MUST be less than or equal to 2147483647. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2577. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.21](#Section_9058338fcf3b4a7b8f84622e180eacc5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichValueTypes](#Section_879bfbfb9ea742728edea144b5074696) + +This complex type specifies information about a single [**rich value type**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100). + +*Child Elements:* + +**keyFlags:** A [CT_RichValueTypeKeyFlags](#Section_97203575155141158abab4c9602a9cb9) element that specifies the set of [**rich value key flags**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2) that differ from defaults for the rich value type identified by the **name** attribute. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**name:** A **string** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that specifies the name of the rich value type. This string MUST be less than or equal to of 255 characters in length. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2584. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueTypeKeyFlags + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichValueGlobalType](#Section_4b181b9033d64c35a62bceacf6681027), [CT_RichValueType](#Section_0a1cee9c0c744d92ad2674c3585f6e5e) + +This complex type specifies a collection of **CT_RichValueTypeReservedKey** elements. + +*Child Elements:* + +**key:** A [CT_RichValueTypeReservedKey](#Section_b7e8ddd691dc4891a3f2d63902bc60fa) element that specifies a [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) with [**rich value key flags**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2) that apply to it. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2591. \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueTypeReservedKey + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichValueTypeKeyFlags](#Section_97203575155141158abab4c9602a9cb9) + +This complex type specifies a [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) with [**rich value key flags**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2) that apply to it. + +*Child Elements:* + +**flag:** A [CT_RichValueTypeReservedKeyFlag](#Section_d965952fcd294165aafc1ca992cbe095) element that specifies information for the rich value key flag. + +*Attributes:* + +**name:** A **string** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that specifies the name of the rich value key. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2596. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueTypeReservedKeyFlag + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichValueTypeReservedKey](#Section_b7e8ddd691dc4891a3f2d63902bc60fa) + +This complex type specifies information for the [**rich value key flag**](#gt_b8457705-f738-4ea7-9175-1e9703aae2d2). + +*Attributes:* + +**name:** A **string** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that specifies the name of the rich value key flag. + +**value:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies the value for the rich value key flag. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2602. \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueTypes + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichValueTypesInfo](#Section_6b2ed0e075bc4118ad12327520402707) + +This complex type specifies a collection of elements that specify information about [**rich value types**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100). + +*Child Elements:* + +**type:** A [CT_RichValueType](#Section_0a1cee9c0c744d92ad2674c3585f6e5e) element that specifies information about a single rich value type. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2606. \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueTypesInfo + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [rvTypesInfo](#Section_0aab0bd06925469aabefdb4614ffb420) + +This complex type specifies two groupings of information. One applies to all [**rich value types**](#gt_48e3a54f-c5d8-4f87-8c13-5aa4dbbcb100), and the other only applies to the identified rich value types. + +*Child Elements:* + +**global:** A [CT_RichValueGlobalType](#Section_4b181b9033d64c35a62bceacf6681027) element that specifies information that applies to all rich value types. + +**types:** A [CT_RichValueTypes](#Section_879bfbfb9ea742728edea144b5074696) element that specifies information about identified rich value types. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2611. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SupportingPropertyBag + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_SupportingPropertyBagData](#Section_c2ae1a7e0d22471289861f402c8419ed) + +This complex type specifies [**supporting property bag data**](#gt_c7e57fec-f265-403b-accb-9fa4628addf8) information for a single [**supporting property bag**](#gt_048a0082-4ff4-4807-8300-69ccc781c098). + +*Child Elements:* + +**v:** A [CT_SupportingPropertyBagValue](#Section_2dc6548d507f4c1d88deab4709d0a035) element that specifies a value contained in the supporting property bag as part of a [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f). The [**supporting property bag key**](#gt_9b058a5b-a83d-4208-9d7d-49665db1ff97) and [**data type**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) is determined by matching the index of the **CT_SupportingPropertyBagValue** with the index of the **CT_SupportingPropertyBagKey** (section [2.6.193](#Section_0937b5a8413440998a784ab1459974f8)) in the **CT_SupportingPropertyBagStructure** (section [2.6.195](#Section_089a3ccc622a4d51ad54ced0c88f0baf)) identified by the **s** attribute. + +Certain data types indicate that the value represents an index as described in the table below. + +| Value | Meaning | +|----|----| +| "spb" | The **CT_SupportingPropertyBagValue** identifies a **CT_SupportingPropertyBag** specified in section 2.6.188. This is a zero-based index. This index MUST reference a **CT_SupportingPropertyBag** that comes before the current **CT_SupportingPropertyBag** in the list specified in **CT_SupportingPropertyBagData** (section 2.6.192). | +| "spba" | The **CT_SupportingPropertyBagValue** identifies a **CT_SupportingPropertyBagArray** specified in section [2.6.189](#Section_b3b9264e75664655a5a5c825c53dae11). This is a zero-based index. | + +*Attributes:* + +**s:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the identifier to the **CT_SupportingPropertyBagStructure** (section 2.6.195). This is a zero-based index. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2618. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SupportingPropertyBagArray + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_SupportingPropertyBagArrayData](#Section_1ad8d1b516d44071b93e35c25abe36a2) + +This complex type specifies a collection of values and [**data types**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) of elements in a [**supporting property bag array**](#gt_7b3f3c16-241f-4a7f-8677-ac555c9a45bb). + +*Child Elements:* + +**v:** A [CT_SupportingPropertyBagArrayValue](#Section_78790c4757f649b9b410494ac5c96004) element that specifies the value and data type of a single element in a supporting property bag array. + +*Attributes:* + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the count of elements in the supporting property bag array. The number of **CT_SupportingPropertyBagArrayValue** elements MUST match this count. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2624. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SupportingPropertyBagArrayData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_SupportingPropertyBags](#Section_8080ca5bbabd4fde96f303ba7006de22) + +This complex type specifies a list of [**supporting property bag arrays**](#gt_7b3f3c16-241f-4a7f-8677-ac555c9a45bb). + +*Child Elements:* + +**a:** A [CT_SupportingPropertyBagArray](#Section_b3b9264e75664655a5a5c825c53dae11) element that specifies a collection of values and [**data types**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) of elements in a supporting property bag array. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the count of supporting property bag arrays. The number of **CT_SupportingPropertyBagArray** elements MUST match this count. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2630. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SupportingPropertyBagArrayValue + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_SupportingPropertyBagArray](#Section_b3b9264e75664655a5a5c825c53dae11) + +This complex type specifies the value and [**data type**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) of an element in a [**supporting property bag array**](#gt_7b3f3c16-241f-4a7f-8677-ac555c9a45bb). + +*Attributes:* + +**t:** An [ST_SupportingPropertyBagArrayValueType](#Section_bcdba6bd1f5e4ce19854155d168e7964) attribute that specifies the data type of the supporting property bag array value. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2637. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SupportingPropertyBagData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_SupportingPropertyBags](#Section_8080ca5bbabd4fde96f303ba7006de22) + +This complex type specifies a list of [**supporting property bag data**](#gt_c7e57fec-f265-403b-accb-9fa4628addf8). + +*Child Elements:* + +**spb:** A [CT_SupportingPropertyBag](#Section_1e24d4a8d93f48e79370e7f79af427df) element that specifies the supporting property bag data information for a single [**supporting property bag**](#gt_048a0082-4ff4-4807-8300-69ccc781c098). + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the count of supporting property bags. The number of **CT_SupportingPropertyBag** elements MUST match this count. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2644. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SupportingPropertyBagKey + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_SupportingPropertyBagStructure](#Section_089a3ccc622a4d51ad54ced0c88f0baf) + +This complex type specifies the [**supporting property bag key**](#gt_9b058a5b-a83d-4208-9d7d-49665db1ff97). + +*Attributes:* + +**n:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the name of the key. This name is case sensitive and MUST be unique in the **CT_SupportingPropertyBagStructure**. + +**t:** An [ST_SupportingPropertyBagValueType](#Section_b1304d86bb2f4c22a62287c5491a0b96) attribute that specifies the data type of the value associated with this key. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2651. \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SupportingPropertyBags + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [supportingPropertyBags](#Section_efb6bef6ea834b12825d9a25d347e448) + +This complex type specifies a list of [**supporting property bag data**](#gt_c7e57fec-f265-403b-accb-9fa4628addf8). + +*Child Elements:* + +**spbArrays:** A [CT_SupportingPropertyBagArrayData](#Section_1ad8d1b516d44071b93e35c25abe36a2) element that specifies a list of [**supporting property bag arrays**](#gt_7b3f3c16-241f-4a7f-8677-ac555c9a45bb). + +**spbData:** A [CT_SupportingPropertyBagData](#Section_c2ae1a7e0d22471289861f402c8419ed) element that specifies a list of supporting property bag data. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2655. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SupportingPropertyBagStructure + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_SupportingPropertyBagStructures](#Section_2a4f5d8f8dca4458a5cf2455510e5d2f) + +This complex type specifies the [**supporting property bag**](#gt_048a0082-4ff4-4807-8300-69ccc781c098) structure for one or more supporting property bags. + +*Child Elements:* + +**k:** A [CT_SupportingPropertyBagKey](#Section_0937b5a8413440998a784ab1459974f8) element that specifies the [**supporting property bag key**](#gt_9b058a5b-a83d-4208-9d7d-49665db1ff97). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2661. \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SupportingPropertyBagStructures + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [spbStructures](#Section_2a76e201630640b9a4dc6b72f834d6fc) + +This complex type specifies a list of [**supporting property bag**](#gt_048a0082-4ff4-4807-8300-69ccc781c098) structures. + +*Child Elements:* + +**s:** A [CT_SupportingPropertyBagStructure](#Section_089a3ccc622a4d51ad54ced0c88f0baf) element that specifies the supporting property bag structure for one or more supporting property bags. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**count:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the count of supporting property bag structures. The number of **CT_SupportingPropertyBagStructure** elements MUST match this count. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2666. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SupportingPropertyBagValue + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_SupportingPropertyBag](#Section_1e24d4a8d93f48e79370e7f79af427df) + +This complex type specifies the [**supporting property bag data**](#gt_c7e57fec-f265-403b-accb-9fa4628addf8). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2673. \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Value + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata + +*Referenced by:* [CT_RichValue](#Section_b8d7927a79b44f2cb76b3a6e9cd7ad40) + +This complex type specifies the [**rich value data**](#gt_26aa395d-2e6a-4071-b25c-95e20adf8ac3). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2678. \ + + \ + + \ + + \ + + \ + +See section [5.21](#Section_9058338fcf3b4a7b8f84622e180eacc5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CalcFeature + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2018/calcfeatures + +*Referenced by:* [CT_CalcFeatures](#Section_588fb9e0e8244e4f95ffb84de746e212) + +This complex type specifies the name of a calculation engine feature that was present when the workbook was [**calculated**](#gt_439238d4-21e0-4733-a20a-61115096aaca). + +*Attributes:* + +**name:** A **string** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that specifies the name of the calculation engine feature. + +| Name | Calculation Engine Feature | +|----|----| +| "microsoft.com:RD" | Rich data (section [2.3.6](#Section_4f1ecdeda9884361a6ca62a789f3e095)) was present in the calculation engine | +| "microsoft.com:FV" | \_FV or FIELDVALUE functions were present in the calculation engine | +| "microsoft.com:Single" | The SINGLE function was present in the calculation engine | +| "Microsoft.com:LET_WF" | The LET function was present in the calculation engine | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2683. \ + + \ + + \ + +See section [5.22](#Section_6c4054c805a949dcbaa913e5a6282989) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CalcFeatures + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2018/calcfeatures + +*Referenced by:* [calcFeatures](#Section_c1a60ba08af14b09a6668118f1c39d69) + +This element specifies a list of **CT_CalcFeature** elements (section [2.6.199](#Section_d158be0b3e694226a78ca96d3fcee017)). + +*Child Elements:* + +**feature:** A CT_CalcFeature element that specifies a calculation engine feature. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2686. \ + + \ + + \ + + \ + + \ + +See section [5.22](#Section_6c4054c805a949dcbaa913e5a6282989) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichFilterColumn + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [filterColumn](#Section_b1354c156c7143d3847741d113def51a) + +This complex type specifies [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) information associated with [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). + +*Child Elements:* + +**filters:** A [CT_RichFilters](#Section_e0526e572ec448bdb28ff1b14eb8501f) element that specifies a filter with multiple criteria associated with rich values. + +**top10:** A [CT_RichTop10](#Section_6a109ad8a40e4d6f871cd0e3c985056c) element that specifies a [**top N filter**](#gt_0f30d3fd-cc8f-4c20-ab45-4ccbb3f834d9) or [**bottom N filter**](#gt_11ba3d33-d05f-4eda-9631-aa6d4942e277). + +**customFilters:** A [CT_CustomRichFilters](#Section_8793aa6c536b4de189b549d2bef4517c) element that specifies custom filter criteria associated with rich values. [**Rows**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) that contain a [**cell**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) within the filter [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) such that the value does not meet the custom filter criteria will be hidden. + +**dynamicFilter:** A [CT_DynamicRichFilter](#Section_6eaa79bef3c14949894351b2ffadb9ca) element that specifies the dynamic filter criteria associated with rich values. These criteria are considered dynamic because they can change, either with the data itself (e.g., "above average") or with the current system date (e.g., show values for "today"). For any cells within the filter range whose values do not meet the specified criteria, the corresponding rows will be hidden from view when the filter is applied. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2691. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Mention + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2018/threadedcomments + +*Referenced by:* [CT_ThreadedCommentMentions](#Section_ad5b8b34af9d4d8bb2006b0fa7363521) + +This complex type specifies the properties of a [**mention**](#gt_afcc37b0-9cff-4c5c-87cd-9db73437848b) in a [**threaded comment**](#gt_7275a968-842f-4c12-b5e6-faf2a7f249c4). + +*Attributes:* + +**mentionpersonId:** An **ST_Guid** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.4) attribute that specifies a unique identifier for the person mentioned. This attribute MUST correspond to the **id** specified in **CT_Person** (section [2.6.203](#Section_6274371e7c5c46e3b661cbeb4abfe968)). + +**mentionId:** An **ST_Guid** (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies a unique identifier for this mention. + +**startIndex:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the index in comment text where the mention starts. + +**length:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the number of characters in the mention from **startIndex**. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2700. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.23](#Section_adb847329fc848b6bddc6b0bcdaad940) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Person + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2018/threadedcomments + +*Referenced by:* [CT_PersonList](#Section_d969311e5d7443909da280a7824c9071) + +This complex type specifies the information about an author of a comment or a person mentioned in a comment. + +*Child Elements:* + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**displayName:** An **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) attribute that specifies the display name of the person. + +**id:** An **ST_Guid** (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies a unique identifier for the person. + +**userId:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies a provider issued user identifier for the person. + +**providerId:** An **ST_Xstring** (\[ISO/IEC29500-1:2016\] section 22.9.2.19) attribute that specifies the provider type of the person’s information. + +This table lists example values of the **providerId** attribute and the corresponding meanings of the **userId** attribute. + + ++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Identity Provider

providerId

+

value

userId

+

value

Description of userId value
No Provider"None""Name"Author’s name
Active Directory"AD"SIDActive Directory Security Identifier (as specified in [MS-DTYP] section 2.4.2)
Windows Live ID"Windows Live"CIDA 64-bit signed decimal that uniquely identifies a user on Windows Live.
Office 365"AD"O365IDA string that uniquely identifies a user. It SHOULD be comprised of three individual values separated by a "::" character delimiter.
People Picker"PeoplePicker""Email address"An email address provided by People Picker
+ +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2706. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.23](#Section_adb847329fc848b6bddc6b0bcdaad940) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PersonList + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2018/threadedcomments + +*Referenced by:* [personList](#Section_9f1b6e0e79cd4ae2b3a76dea649c57f6) + +This complex type specifies a collection of persons. + +*Child Elements:* + +**person:** A [CT_Person](#Section_6274371e7c5c46e3b661cbeb4abfe968) element that specifies each person’s information in the collection. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2715. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.23](#Section_adb847329fc848b6bddc6b0bcdaad940) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ThreadedComment + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2018/threadedcomments + +*Referenced by:* [CT_ThreadedComments](#Section_0cfb2f0587a24b5fa9adfb11ca39e2f8) + +This complex type specifies the properties of a [**threaded comment**](#gt_7275a968-842f-4c12-b5e6-faf2a7f249c4). + +*Child Elements:* + +**text:** An ST_Xstring ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) element that specifies the unformatted text of this comment. + +**mentions:** A [CT_ThreadedCommentMentions](#Section_ad5b8b34af9d4d8bb2006b0fa7363521) element that specifies a list of [**mentions**](#gt_afcc37b0-9cff-4c5c-87cd-9db73437848b) in this comment. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element**.** + +*Attributes:* + +**ref:** An **ST_Ref** (section [2.7.1](#Section_c326af1b1d0642219584aaadc9c94308)) attribute that specifies the reference to the cell that this threaded comment is anchored to. + +**dT:** A **dateTime** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.7) attribute that specifies the UTC time that the comment was authored for the first time. + +**personId:** An **ST_Guid** (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies a unique identifier for the comment author. This attribute MUST correspond to the **id** specified in **CT_Person** (section [2.6.203](#Section_6274371e7c5c46e3b661cbeb4abfe968)). + +**id:** An **ST_Guid** (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies a unique identifier for this threaded comment. + +**parentId:** An **ST_Guid** (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies the **id** of the parent comment of this comment in the [**comment thread**](#gt_502f1c43-e7e6-4c33-9120-ebafa77215e8). + +**done:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute that specifies a flag to track resolving status of the comment. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2721. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.23](#Section_adb847329fc848b6bddc6b0bcdaad940) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ThreadedCommentMentions + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2018/threadedcomments + +*Referenced by:* [CT_ThreadedComment](#Section_42f9b03d966242049783dbeb324a691c) + +This complex type specifies a collection of [**mentions**](#gt_afcc37b0-9cff-4c5c-87cd-9db73437848b) in a [**threaded comment**](#gt_7275a968-842f-4c12-b5e6-faf2a7f249c4). + +*Child Elements:* + +**mention:** A [CT_Mention](#Section_b03ed619e3074d3e9c67b68612274128) element that specifies each mention in the collection and its properties. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2734. \ + + \ + + \ + + \ + + \ + +See section [5.23](#Section_adb847329fc848b6bddc6b0bcdaad940) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ThreadedComments + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2018/threadedcomments + +*Referenced by:* [ThreadedComments](#Section_b1b3567212a0409cb00ecc2192094f41) + +This complex type specifies a collection of [**threaded comment**](#gt_7275a968-842f-4c12-b5e6-faf2a7f249c4) in a [**comment thread**](#gt_502f1c43-e7e6-4c33-9120-ebafa77215e8). + +*Child Elements:* + +**threadedComment:** A [CT_ThreadedComment](#Section_42f9b03d966242049783dbeb324a691c) element that specifies each threaded comment in the comment thread and its properties. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2739. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.23](#Section_adb847329fc848b6bddc6b0bcdaad940) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DynamicArrayProperties + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/dynamicarray + +*Referenced by:* [dynamicArrayProperties](#Section_0f72449211ea437fac2bcc097b255da1) + +This complex type defines properties related to a [**dynamic array**](#gt_bb976581-5eac-4091-9255-6daae19ed259). + +*Child Elements:* + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**fDynamic:** A **Boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies a flag indicating the presence of a dynamic array. + +**fCollapsed:** A **Boolean** (\[XMLSCHEMA2/2\] section 3.2.2) attribute which MUST be ignored and MUST be 0. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2745. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.25](#Section_878c8ac485484bfb9ad4b1378e0efed1) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ColumnFilter + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2019/namedsheetviews + +*Referenced by:* [CT_NsvFilter](#Section_e132d9ccc7114fb3aa28e7356a791b1c) + +This complex type defines filter criteria that is used on a specific column as part of a [**named sheet view**](#gt_536ae444-2479-4867-8bfa-9a5be4e9995e) + +*Child Elements:* + +**dxf:** A **CT_Dxf** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.2). If the **filter** element within this type includes a **colorFilter** (\[ISO/IEC29500-1:2016\] section 18.3.2.1) then this element MUST be present and MUST be used in place of the one referenced by the **dxfId** attribute on the **colorFilter**. If the **filter** element within this type does NOT include a **colorFilter** (\[ISO/IEC29500-1:2016\] section 18.3.2.1) then this element MUST be omitted. + +**filter:** A **CT_FilterColumn** (\[ISO/IEC29500-1:2016\] section A.2). Defines the filter conditions to apply**.** + +**extLst:** A **CT_ExtensionList** (\[ISO/IEC29500-1:2016\] section A.2) that specifies future extensibility for this element. + +*Attributes:* + +**colId:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the zero-based index of the column that this filter is applied to. When loading this element **colId** and **id** SHOULD be considered as described in section [2.3.8.2](#Section_dd6b2cb8b5b343b1a5bddccdd9c0864a). + +**id:** An **ST_Guid** (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies the unique id of the column this filter is applied to. When loading this element **colId** and **id** SHOULD be considered as described in section 2.3.8.2. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2752. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.26](#Section_55396aef0c074ffb9ffbe48b6d339abe) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_NamedSheetView + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2019/namedsheetviews + +*Referenced by:* [CT_NamedSheetViews](#Section_16f8352671174942869dad31f86b937d) + +This complex type specifies the properties of a [**named sheet view**](#gt_536ae444-2479-4867-8bfa-9a5be4e9995e) + +*Child Elements:* + +**nsvFilter:** A [CT_NsvFilter](#Section_e132d9ccc7114fb3aa28e7356a791b1c) element that specifies the sort and/or filter criteria to be applied to a specified [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35) + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.2) that specifies future extensibility for this element + +*Attributes:* + +**name:** A **string** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that specifies the name of the named sheet view. The value of this attribute MUST be unique among elements within a **CT_NamedSheetViews** (section 2.6.211) + +The number of characters in the string MUST be greater than or equal to 1 and less than or equal to 127. The string MUST conform to the following [**Augmented Backus-Naur Form (ABNF)**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) ([\[RFC5234\]](https://go.microsoft.com/fwlink/?LinkId=123096)) grammar: + +string = name-character-special \[\*name-character name-character-special\] + +whitespace = %x09-%x0D / “ “ + +name-character-special = character ; MUST NOT be “;” or whitespace + +; character = as defined by the production of Char in the [\[W3C-XML\]](https://go.microsoft.com/fwlink/?LinkId=113935) section 2.2 + +name-character = name-character-special / “ “ + +Values beginning with “\_xlnsv.” are reserved for future use. + +**id:** An **ST_Guid** (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies the unique id of this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2760. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.26](#Section_55396aef0c074ffb9ffbe48b6d339abe) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_NamedSheetViews + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2019/namedsheetviews + +*Referenced by:* [namedSheetViews](#Section_adecc84b11aa42f9bdc5b448cb2a538e) + +This complex type specifies a collection of [**named sheet views**](#gt_536ae444-2479-4867-8bfa-9a5be4e9995e). + +*Child Elements:* + +**namedSheetView:** A [CT_NamedSheetView](#Section_55eac87a38a042d4bbc92e339312d2d2) element that specifies a single named sheet view. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.2) that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2768. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.26](#Section_55396aef0c074ffb9ffbe48b6d339abe) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_NsvFilter + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2019/namedsheetviews + +*Referenced by:* [CT_NamedSheetView](#Section_55eac87a38a042d4bbc92e339312d2d2) + +This complex type specifies the sort and/or filter criteria to be applied to a single [**AutoFilter**](#gt_aa1cb4ce-f545-4fe2-b44c-5d393d833c35). + +*Child Elements:* + +**columnFilter:** A [CT_ColumnFilter](#Section_156596a92bb54351bcd039889d4fa26f) element that specifies filter criteria to apply to a specific column in the AutoFilter. + +**sortRules:** A [CT_SortRules](#Section_058dbac60b8b45f4af04555c14470870) element that specifies the sort criteria to apply to the AutoFilter. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.2) that specifies future extensibility for this element. + +*Attributes:* + +**filterId:** An **ST_Guid** (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies the unique id of the AutoFilter object this element applies to. The value of this attribute SHOULD match a **uid** (section [2.5.10](#Section_05198417f8f74ee4967859599f962c90)) attribute stored on the **CT_AutoFilter** (\[ISO/IEC29500-1:2016\] section A.2) that describes the AutoFilter associated with this element. + +Use of this attribute during load is described in section [2.3.8.2](#Section_dd6b2cb8b5b343b1a5bddccdd9c0864a). + +**ref:** An **ST_Ref** (\[ISO/IEC29500-1:2016\] section 18.18.62) attribute that specifies the location of the AutoFilter object that this element applies to. The value of this attribute SHOULD match the **ref** attribute on the **CT_AutoFilter** (\[ISO/IEC29500-1:2016\] section A.2) that describes the AutoFilter associated with this element. + +This attribute is currently unused. + +**tableId:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the **id** of the [**table**](#gt_d3a7da8d-a597-4838-9756-25e30b640ba7) that contains the AutoFilter associated with this element. + +If the AutoFilter is table owned (as explained in section [2.3.8.1](#Section_a3349ee14144443c9cede014a9474cc1)) then this value SHOULD match the **id** attribute on the **CT_Table** (\[ISO/IEC29500-1:2016\] section A.2) element that describes the owning table. + +If the AutoFilter is worksheet owned (as explained in section 2.3.8.1) then this value SHOULD be 0. + +Use of this attribute during load is described in section 2.3.8.2 + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2774. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.26](#Section_55396aef0c074ffb9ffbe48b6d339abe) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SortRule + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2019/namedsheetviews + +*Referenced by:* [CT_SortRules](#Section_058dbac60b8b45f4af04555c14470870) + +This complex type specifies the sort criteria to be applied to a single column as part of a [**named sheet view**](#gt_536ae444-2479-4867-8bfa-9a5be4e9995e). + +*Child Elements:* + +**dxf:** A **CT_Dxf** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.2). If the **sortCondition** element within this type specifies a **dxfId** attribute then this element MUST be present and MUST be used in place of the one referenced by that **dxfId** attribute. If the **sortCondition** element within this type does NOT specify a **dxfId** attribute then this element MUST be omitted. + +**sortCondition:** A [CT_SortCondition](#Section_af08b8709b064812a4d67bc80d819e62) element that specifies the [**sort condition**](#gt_198a56e7-6045-43cf-8acd-793eab3647c1) to apply to the column. + +**richSortCondition:** A [CT_RichSortCondition](#Section_984b10b877a0427388afdf98616ee8e1) element that specifies the sort condition associated with [**rich values**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). To apply to the column. + +*Attributes:* + +**colId:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the zero-based index of the column that this filter is applied to. When loading this element **colId** and **id** SHOULD be considered as described in section [2.3.8.2](#Section_dd6b2cb8b5b343b1a5bddccdd9c0864a). + +**id:** An **ST_Guid** (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies the unique id of the column this filter is applied to. When loading this element **colId** and **id** SHOULD be considered as described in section 2.3.8.2. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2784. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.26](#Section_55396aef0c074ffb9ffbe48b6d339abe) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_SortRules + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2019/namedsheetviews + +*Referenced by:* [CT_NsvFilter](#Section_e132d9ccc7114fb3aa28e7356a791b1c) + +This complex type specifies an ordered collection of sort criteria to apply as part of a [**named sheet view**](#gt_536ae444-2479-4867-8bfa-9a5be4e9995e). + +*Child Elements:* + +**sortRule:** A [CT_SortRule](#Section_cd611e3d7b67404d8934bd2b6e738c75) element that specifies the sort criteria to apply on a single column. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.2) that specifies future extensibility for this element. + +*Attributes:* + +**sortMethod:** An **ST_SortMethod** (\[ISO/IEC29500-1:2016\] section A.2) attribute that specifies the sort ordering to use. Behavior of this attribute is equivalent to the **sortMethod** attribute contained on the **sortState** element as specified by \[ISO/IEC29500-1:2016\] section 18.3.1.92. + +**caseSensitive:** A **boolean** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether sort is case sensitive or not. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2794. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.26](#Section_55396aef0c074ffb9ffbe48b6d339abe) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ExternalLinksPr + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2019/extlinksprops + +*Referenced by:* [externalLinksPr](#Section_eaea6a6338034e8cb1ef161c5fdbae3b) + +Extended properties applicable to all external links of this workbook. + +*Attributes:* + +**autoRefresh:** A boolean ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether to refresh external links periodically. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2802. \ + + \ + + \ + +See section [5.27](#Section_b2939e1139c1475699097a2dc79e8c2e) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_WebImagesSupportingRichData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2020/richdatawebimage + +*Referenced by:* [webImagesSrd](#Section_8e493a5650084a89a47761a1fd83abbb) + +This complex type specifies a list of sets of properties associated with web image rich values. For more information see section [2.3.6.1.11](#Section_9940168fccfc43a8bf8134c7d4bff974). + +*Child Elements:* + +**webImageSrd:** A [CT_WebImageSupportingRichData](#Section_0bbd3612e1b241ef9ce7241d4a969b57) element that specifies a set of properties for a web image [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). + +**extLst:** A CT_ExtensionList ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.2) that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2805. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.28](#Section_1dc262ba8b454611b6fbce1b04a561e0) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_WebImageSupportingRichData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2020/richdatawebimage + +*Referenced by:* [CT_WebImagesSupportingRichData](#Section_d13e2c61fae142a7aa6fd6d8c226858d) + +This complex type specifies a set of properties for a web image [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). + +*Child Elements:* + +**address:** A [CT_WebImageSupportingRichDataRelationship](#Section_857bb42ce0814e0aaaab1f351b6b5f63) element that specifies the relationship ID for the hyperlink address. + +**moreImagesAddress:** A CT_WebImageSupportingRichDataRelationship element that specifies the relationship ID for the hyperlink to more images. + +**blip:** A CT_WebImageSupportingRichDataRelationship element that specifies the relationship ID for the [**BLIP**](#gt_f9c3c085-93c6-49a8-9043-591902711956). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2811. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.28](#Section_1dc262ba8b454611b6fbce1b04a561e0) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_WebImageSupportingRichDataRelationship + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2020/richdatawebimage + +*Referenced by:* [CT_WebImageSupportingRichData](#Section_0bbd3612e1b241ef9ce7241d4a969b57) + +This complex type specifies a relationship to a web image [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) property. + +*Attributes:* + +**r:id:** An **ST_RelationshipId** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.8.2.1) attribute that specifies the ID of the relationship. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2818. \ + + \ + + \ + +See section [5.28](#Section_1dc262ba8b454611b6fbce1b04a561e0) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CommentHyperlink + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2020/threadedcomments2 + +*Referenced by:* [CT_ThreadedComments2Ext](#Section_2a6395824675416eba5b47301cadcb35) + +**This complex type specifies the properties of hyperlinked text in this threaded comment** + +*Child Elements:* + +**extLst:** A CT_ExtensionList ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.2) element that specifies future extensibility for this element + +*Attributes:* + +**startIndex:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the index in comment text where this hyperlink starts. + +**length:** An **unsignedInt** (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the number of characters in this hyperlink from **startIndex**. + +**url:** An ST_Xstring (\[ISO/IEC29500-1:2016\] section 22.9.2.19) element that specifies the URL of this hyperlink. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2821. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.30](#Section_716e392dd858443ba393141a983260b0) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ThreadedComments2Ext + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2020/threadedcomments2 + +This complex type specifies the information for hyperlinks for this threaded comment. + +*Child Elements:* + +**checksum:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the CRC32 ([\[MS-OSHARED\]](%5bMS-OSHARED%5d.pdf#Section_d93502fa5b8f4f47a3fe5574046f4b8d) section 2.4.3.2) checksum of the full plain text of this threaded comment. [\<28\>](#Appendix_A_28) + +**hyperlink:** A [CT_CommentHyperlink](#Section_6b0fef4e008b44deb8aeb16b3ffcd0fe) element that specifies the hyperlink. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2829. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.30](#Section_716e392dd858443ba393141a983260b0) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueRefreshInterval + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2020/richvaluerefresh + +*Referenced by:* [CT_RichValueRefreshIntervals](#Section_d7838cb2b6084667b52b93a751687a60) + +This complex type specifies the refresh interval for the given **resourceID** attribute. + +*Attributes:* + +**resourceIdInt:** An **int** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.17) attribute that specifies the numeric ID for specifying the rich values that this interval applies to. Either resourceIdInt or resourceIdStr MUST be included. Both MAY be included. + +**resourceIdStr:** A **string** (\[XMLSCHEMA2/2\]section 3.2.1) attribute that specifies the string ID for specifying the rich values that this interval applies to. Either resourceIdInt or resourceIdStr MUST be included. Both MAY be included. + +**interval:** An **int** (\[XMLSCHEMA2/2\] section 3.3.17) attribute that specifies the refresh interval in seconds for the **resourceID**. + +| Value | Description | +|----|----| +| -1 | Refresh on load only. | +| 0 | No automatic refresh. | +| Any other value | Time in seconds, MAY be overridden by the [**service**](#gt_2dc07ca2-2b40-437e-a5ec-ed28ebfb116a). | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2837. \ + + \ + + \ + + \ + + \ + +See section [5.31](#Section_7c97123fa8954094afe6b661d7f3e634) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueRefreshIntervals + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2020/richvaluerefresh + +*Referenced by:* [refreshIntervals](#Section_3ab1993283894711847a01295f9a816f) + +Specifies a collection of refresh intervals. + +*Child Elements:* + +**refreshInterval:** A [CT_RichValueRefreshInterval](#Section_a655eb881eb447d8919d52e4c586211c) element that specifies the refresh interval. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2842. \ + + \ + + \ + + \ + + \ + +See section [5.31](#Section_7c97123fa8954094afe6b661d7f3e634) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DataFieldFutureData + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2020/pivotNov2020 + +*Referenced by:* [dataFieldFutureData](#Section_68b4242e425946fe9865fa9c35305a6d) + +Specifies a source field for the parent [**PivotTable data field**](#gt_422ecf6b-649e-4e99-9431-5297e4e297b8) that SHOULD only be used for the specified version of the PivotTable or later. + +*Attributes:* + +**version:** An unsignedByte attribute that specifies a minimum version of the PivotTable for which this record SHOULD be honored. + +**sourceField:** An unsignedInt attribute that specifies the index of the source PivotField for this data field. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2847. \ + + \ + + \ + + \ + +See section [5.29](#Section_a9f2fa9d070f449180e8832783f0ada2) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Ignorable + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2020/pivotNov2020 + +*Referenced by:* [ignorableAfterVersion](#Section_b3472c80412b488190d14fc07ace0ac7) + +Specifies that the parent object can be ignored if the PivotTable is greater than or equal to a certain version. + +*Attributes:* + +**version:** An unsignedByte attribute that specifies a minimum version of the PivotTable for which this object SHOULD be ignored. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2851. \ + + \ + + \ + +See section [5.29](#Section_a9f2fa9d070f449180e8832783f0ada2) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_CacheVersionInfo + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/pivotVersionInfo + +*Referenced by:* [cacheVersionInfo](#Section_6bef1cb8243b4debad3503867b503094) + +Specifies versioning information about the features related to this PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) PivotCache. + +*Child Elements:* + +**requiredFeature:** A string ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609)section 3.2.1) element that specifies the name of a feature which is required to be supported in order to refresh the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache. If the specified feature is not supported or understood, refresh SHOULD be disabled. + +**lastRefreshFeature:** A string (\[XMLSCHEMA2/2\]section 3.2.1) element that specifies the name of a feature was used during the most recent refresh of the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10) PivotCache. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2854. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.32](#Section_ce4604c1dd30452c9fc1630dc4012961) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotVersionInfo + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/pivotVersionInfo + +*Referenced by:* [pivotVersionInfo](#Section_f539f112f8a64324897705a32e95cf3b) + +Specifies versioning information about the features related to this PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10). + +*Child Elements:* + +**requiredFeature:** A string ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609)section 3.2.1) element that specifies the name of a feature that is required to be supported to allow updating the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10). + +**lastUpdateFeature:** A string (\[XMLSCHEMA2/2\]section 3.2.1) element that specifies the name of a feature which was used during the most recent update of the PivotTable (\[ISO/IEC29500-1:2016\] section 18.10). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2860. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.32](#Section_ce4604c1dd30452c9fc1630dc4012961) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_AlternateUrl + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2021/extlinks2021 + +*Referenced by:* [CT_ExternalBookAlternateUrls](#Section_cd7a81dc36734acbaefbc7f02ffd9a88) + +This element represents an additional Url to the external workbook which is supplying data to the current workbook. + +*Attributes:* + +**r:id:** An ST_RelationshipId ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.8.2.1) relationship to the external workbook file path + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2866. \ + + \ + + \ + +See section [5.34](#Section_ffd38adacfa54242976b198f6fd508d9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ExternalBookAlternateUrls + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2021/extlinks2021 + +*Referenced by:* [alternateUrls](#Section_452524b4b22f45a9aac181fdd1f1db6c) + +This element represents additional Urls and Ids to the external workbook which is supplying data to the current workbook. + +*Child Elements:* + +**absoluteUrl:** A [CT_AlternateUrl](#Section_09feae0c01cb49da8cd60b2511af331f) element that represent an absolute form Url to the external workbook + +**relativeUrl:** A CT_AlternateUrl element that represent a relative form Url to the external workbook + +*Attributes:* + +**driveId:** A string ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that is provided by and targets the service. + +**itemId:** A string (\[XMLSCHEMA2/2\] section 3.2.1) attribute that is provided by and targets the service. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2869. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.34](#Section_ffd38adacfa54242976b198f6fd508d9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ArrayFeatureProperty + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +*Referenced by:* [CT_FeaturePropertyBag](#Section_8383a4177cb14324af6399dd77ffebd5) + +A **CT_ArrayFeatureProperty** is a **[key value pair (KVP)](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f)** where the value is a list of any number of child elements in any order. The order of elements in **CT_ArrayFeatureProperty** is preserved. + +*Child Elements:* + +**bagId:** An unsignedInt ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) element that specifies a zero-based index to another CT_FeaturePropertyBag element of the ancestor [CT_FeaturePropertyBags](#Section_c36ae2cb267b4ee99d229928e65a1e8c) element. + +**i:** An integer (\[XMLSCHEMA2/2\] section 3.3.13) element that specifies an integer value. + +**s:** A string (\[XMLSCHEMA2/2\] section 3.2.1) element that specifies string value. + +**b:** A boolean (\[XMLSCHEMA2/2\] section 3.2.2) element that specifies boolean value. + +**d:** A double (\[XMLSCHEMA2/2\] section 3.2.5) element that specifies a double value. + +**rel:** An ST_RelationshipId ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.8.2.1) element that specifies the ID of the **Relationship** (section [1.4](#Section_683fd4c8c16a4f74a9b4b9e6950a2139)). + +*Attributes:* + +**k:** A string (\[XMLSCHEMA2/2\] section 3.2.1) attribute that specifies the name of the key for the **CT_ArrayFeatureProperty** key value pair (KVP). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2877. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_BagFeatureProperty + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +*Referenced by:* [CT_FeaturePropertyBag](#Section_8383a4177cb14324af6399dd77ffebd5) + +This complex type specifies a **[key value pair (KVP)](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f)** that references another CT_FeaturePropertyBag element. The value is an unsigned int ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) that specifies a zero-based index to another CT_FeaturePropertyBag element of the ancestor [CT_FeaturePropertyBags](#Section_c36ae2cb267b4ee99d229928e65a1e8c) element. This index MUST be less than the parent CT_FeaturePropertyBag element position in the list specified in CT_FeaturePropertyBags. + +*Attributes:* + +**k:** A string (\[XMLSCHEMA2/2\] section 3.2.1) attribute that specifies the name of the key for the key value pair (KVP)**.** + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2888. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_BoolFeatureProperty + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +*Referenced by:* [CT_FeaturePropertyBag](#Section_8383a4177cb14324af6399dd77ffebd5) + +This complex type specifies a **[key value pair (KVP)](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f)** with a value of type Boolean ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2). + +*Attributes:* + +**k:** A string (\[XMLSCHEMA2/2\] section 3.2.1) attribute that specifies the name of the key for the key value pair (KVP)**.** + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2895. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DecimalFeatureProperty + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +*Referenced by:* [CT_FeaturePropertyBag](#Section_8383a4177cb14324af6399dd77ffebd5) + +This complex type specifies a **[key value pair (KVP)](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f)** with a value of type double [\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.5). + +*Attributes:* + +**k:** A string (\[XMLSCHEMA2/2\] section 3.2.1) attribute that specifies the name of the key for the key value pair (KVP). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2902. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_FeaturePropertyBag + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +*Referenced by:* [CT_FeaturePropertyBags](#Section_c36ae2cb267b4ee99d229928e65a1e8c) + +This complex type specifies a [**feature property bag**](#gt_3f541c32-862c-47d2-8c55-e07e44e68bfb) and contains any number and combination of **[key value pairs (KVP)](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f).** + +*Child Elements:* + +**a:** A [CT_ArrayFeatureProperty](#Section_26b90ad3836549769c1c1c7cd62d661f) element that specifies a key value pair (KVP) whose value is an array. + +**bagId:** A [CT_BagFeatureProperty](#Section_24b32f3ec1784728b4f782ab08c57e0b) element that specifies a key value pair (KVP) whose value is an unsigned int ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) that specifies a zero-based index to another CT_FeaturePropertyBag element of the parent CT_FeaturePropertyBags element. + +**i:** A [CT_IntFeatureProperty](#Section_138e96d331b3402db6929603825ce4ed) element that specifies a key value pair (KVP) whose value is an integer (\[XMLSCHEMA2/2\] section 3.3.13). + +**s:** A [CT_StringFeatureProperty](#Section_51dad71ea7b348ee815b3aa0cf299cc5) element that specifies a key value pair (KVP) whose value is a string (\[XMLSCHEMA2/2\] section 3.2.1). + +**b:** A [CT_BoolFeatureProperty](#Section_134e9cb16d4846db9c4dd3a24cb17764) element that specifies a key value pair (KVP) whose value is a boolean (\[XMLSCHEMA2/2\] section 3.2.2). + +**d:** A [CT_DecimalFeatureProperty](#Section_52f745c9d41d4f3c99fafc5ff8ab91b6) element that specifies a key value pair (KVP) whose value is a double (\[XMLSCHEMA2/2\] section 3.2.5). + +**rel:** A [CT_RelFeatureProperty](#Section_d39dd92be69140f5a3a4d69af30a674f) element that specifies a key value pair (KVP) whose value is a ST_RelationshipId ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.8.2.1). + +*Attributes:* + +**type:** A string (\[XMLSCHEMA2/2\] section 3.2.1) attribute that specifies the type of the feature property bag. A list of feature property bag types can be found in section [2.3.9](#Section_35e6c0342e1f471baa1fd82def1a32e8). + +**extRef:** A string (\[XMLSCHEMA2/2\] section 3.2.1) attribute that is unused. + +**bagExtId:** An unsigned int (\[XMLSCHEMA2/2\] section 3.3.22) that specifies a zero-based index to a [CT_BagExtensions](#Section_18ea8907491d459ebf54bac5980b51ae) element position in the parent CT_FeaturePropertyBags element. + +**att:** A string (\[XMLSCHEMA2/2\] section 3.2.1) attribute that is unused. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2909. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_FeaturePropertyBags + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +*Referenced by:* [FeaturePropertyBags](#Section_f30c4f9a632a4fdaadca08fd156dd9f0) + +A complex type that specifies a list of [**feature property bags**](#gt_3f541c32-862c-47d2-8c55-e07e44e68bfb) and future extensibility. + +*Child Elements:* + +**bagExt:** A [CT_BagExtensions](#Section_18ea8907491d459ebf54bac5980b51ae) element referenced by a [CT_FeaturePropertyBag](#Section_8383a4177cb14324af6399dd77ffebd5) **bagExtId** attribute of a sibling **bag** element. + +**bag:** A CT_FeaturePropertyBag element that specifies a feature property bag. + +**extLst:** A **CT_ExtensionList** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.10) element that specifies future extensibility. + +*Attributes:* + +**count:** An unsigned int ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies a count of CT_FeaturePropertyBag elements. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2924. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_IntFeatureProperty + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +*Referenced by:* [CT_FeaturePropertyBag](#Section_8383a4177cb14324af6399dd77ffebd5) + +This complex type specifies a **[key value pair (KVP)](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f)** with a value of type integer ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.13). + +*Attributes:* + +**k:** A string (\[XMLSCHEMA2/2\] section 3.2.1) attribute that specifies the name of the key for the key value pair (KVP). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2932. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RelFeatureProperty + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +*Referenced by:* [CT_FeaturePropertyBag](#Section_8383a4177cb14324af6399dd77ffebd5) + +This complex type specifies a **[key value pair (KVP)](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f)** with a value of type ST_RelationshipId ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.8.2.1). The value is the ID of the **Relationship** (section [1.4](#Section_683fd4c8c16a4f74a9b4b9e6950a2139)). + +*Attributes:* + +**k:** A string ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that specifies the name of the key for the key value pair (KVP). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2939. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_StringFeatureProperty + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +*Referenced by:* [CT_FeaturePropertyBag](#Section_8383a4177cb14324af6399dd77ffebd5) + +This complex type specifies a **[key value pair (KVP)](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f)** with a value of type string ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1). + +*Attributes:* + +**k:** A string (\[XMLSCHEMA2/2\] section 3.2.1) attribute that specifies the name of the key for the key value pair (KVP). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2946. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_XfComplement + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +*Referenced by:* [CT_XfComplementExt](#Section_7b9ee8f05f77416b9cdc747a986b064b), [xfComplement](#Section_d6ffbc21ef1145469a0795885e2fd497) + +A complex type that specifies a relationship to a [CT_FeaturePropertyBag](#Section_8383a4177cb14324af6399dd77ffebd5) element of type **XFComplements** (section [2.3.9.1](#Section_cb97d7fc1434498c9bd3aa5fae4e677c)). + +*Attributes:* + +**i:** An unsigned int ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies a zero-based index into a [CT_ArrayFeatureProperty](#Section_26b90ad3836549769c1c1c7cd62d661f) element of a CT_FeaturePropertyBag element, with key "MappedFeaturePropertyBags” in a [**feature property bag**](#gt_3f541c32-862c-47d2-8c55-e07e44e68bfb) of type “XFComplements” (section 2.3.9.1). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2953. \ + + \ + + \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_XfComplementExt + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +A complex type that contains a [CT_XfComplement](#Section_09ecc2fe7df748dda30641c576c1a91f) element. + +*Child Elements:* + +**xfComplement:** A CT_XfComplement element that references a feature property bag. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2956. \ + + \ + + \ + + \ + + \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_BagExtensions + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +*Referenced by:* [CT_FeaturePropertyBags](#Section_c36ae2cb267b4ee99d229928e65a1e8c) + +This complex type specifies a CT_ExtensionList ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.10) element. Elements of this type are referenced by [CT_FeaturePropertyBag](#Section_8383a4177cb14324af6399dd77ffebd5) **bagExtId** attributes. + +*Child Elements:* + +**extLst:** A CT_ExtensionList (\[ISO/IEC29500-1:2016\] section 18.2.10) element that specifies future extensibility. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2961. \ + + \ + + \ + + \ + + \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueRelRelationship + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/richvaluerel + +*Referenced by:* [CT_RichValueRels](#Section_5bbff086f47d4137936b8fe49ada3832) + +This complex type specifies a relationship ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 9.2) for a [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) property. + +*Attributes:* + +**r:id:** An **ST_RelationshipId** (\[ISO/IEC29500-1:2016\] section 22.8.2.1) attribute that specifies the ID of the relationship (\[ISO/IEC29500-1:2016\] section 9.2). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2966. \ + + \ + + \ + +See section [5.35](#Section_56bafcc41ae84894a86c1e92f165a3c5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_RichValueRels + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/richvaluerel + +*Referenced by:* [richValueRels](#Section_e8426f8a62ba4f449eddd0052728d40e) + +This complex type specifies a list of [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) relationships. + +*Child Elements:* + +**rel:** A [CT_RichValueRelRelationship](#Section_e8999a72164a40c7becb3f8cbf2c9090) element that specifies a relationship ID ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 9.2) for a rich value property. + +**extLst:** A CT_ExtensionList (\[ISO/IEC29500-1:2016\] section A.2) that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2969. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.35](#Section_56bafcc41ae84894a86c1e92f165a3c5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_MsForm + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/msForms + +*Referenced by:* [CT_MsFormsExt](#Section_ae8398b3f3f64ec9af2d814c7c65a126) + +A complex type that specifies information about a Microsoft form. + +*Child Elements:* + +**syncedQuestionId:** An ST_Xstring element that specifies a Microsoft form question ID that has been synced to the table. + +**extLst:** A CT_ExtensionList element that specifies future extensibility. + +*Attributes:* + +**id:** An ST_Xstring attribute that specifies the ID of the connected Microsoft form. + +**isFormConnected:** A boolean attribute that specifies whether the Microsoft form is still connected to the table. + +**maxResponseId:** An int attribute that specifies the ID of the most recently synced Microsoft form response. + +**latestEventMarker:** An ST_Xstring attribute that specifies a marker of the most recently synced Microsoft form event. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2975. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.37](#Section_e38e8867d5f0492ab64bb57779e18216) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_MsFormsExt + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/msForms + +A complex type that specifies information about a Microsoft form. + +*Child Elements:* + +**msForm:** A [CT_MsForm](#Section_74740e0071e8485cae799afa0b4316cb) element that specifies information about a Microsoft form. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2985. \ + + \ + + \ + + \ + + \ + +See section [5.37](#Section_e38e8867d5f0492ab64bb57779e18216) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_QuestionExt + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/msForms + +A complex type that specifies information about a question in a Microsoft form. + +*Child Elements:* + +**question:** A [CT_Question](#Section_b076a169357f45beab931745ae224baa) element that specifies information about a Microsoft form question. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2990. \ + + \ + + \ + + \ + + \ + +See section [5.37](#Section_e38e8867d5f0492ab64bb57779e18216) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Question + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/msForms + +*Referenced by:* [CT_QuestionExt](#Section_a3c4ba3fafaf4ce6a083091ef768dd42) + +A complex type that specifies information about a question in a Microsoft form. + +*Child Elements:* + +**extLst:** A CT_ExtensionList element that specifies future extensibility. + +*Attributes:* + +**id:** An ST_Xstring attribute that specifies the ID of the Microsoft form question. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +2995. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.37](#Section_e38e8867d5f0492ab64bb57779e18216) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ExternalCodeService + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/externalCodeService + +*Referenced by:* [CT_ExternalCodeServiceExt](#Section_0f7fb780d187487cbb5f7e9ffd01ac71), [externalCodeService](#Section_b5dfc997dec64b47a9ce84492565a54e) + +A complex type that specifies properties related to an [**external code service**](#gt_9a3bc1c7-ad12-4371-85b6-78656d97437a). + +*Attributes:* + +**autoShow:** An unsignedInt ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the auto show setting for the user interface. + +**timeout:** An unsignedInt (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the maximum length of time, in seconds, allotted for a formula that depends on an external code service to complete. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3001. \ + + \ + + \ + + \ + +See section [5.38](#Section_b3c832bd13c74c2f869eac31bf13ea7c) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ExternalCodeServiceExt + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/externalCodeService + +A complex type that contains a [CT_ExternalCodeService](#Section_11dad9754fe54d81b9b6fc56c8a0ea95) element. + +*Child Elements:* + +**externalCodeService:** A CT_ExternalCodeService element that specifies properties related to an [**external code service**](#gt_9a3bc1c7-ad12-4371-85b6-78656d97437a). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3005. \ + + \ + + \ + + \ + + \ + +See section [5.38](#Section_b3c832bd13c74c2f869eac31bf13ea7c) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Python + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/python + +*Referenced by:* [python](#Section_43e4bfa85a964b0d95914e68a8ef1180) + +This complex type specifies a collection of the [**Python scripts**](#gt_ccedff9e-7c79-440f-9090-63915f6677ad) added to the workbook and information about the [**Python environment**](#gt_17210a25-c8f9-4e33-ab88-02a7555e6854) used to execute these Python scripts. + +*Child Elements:* + +**environmentDefinition:** A [CT_PythonEnvironmentDefinition](#Section_6285909a009b4fbab73bf2a24ad05176) element that specifies the details for the Python environment used to execute the Python scripts. + +**pythonScripts:** A [CT_PythonScripts](#Section_030a30ad829c40aa82d78ea4d56cb6c2) element that specifies a collection of Python scripts in the workbook. + +**extLst:** A CT_ExtensionList ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.2) element that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3010. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.39](#Section_ef230d238d80473c925e3e5b98abdbba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PythonEnvironmentDefinition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/python + +*Referenced by:* [CT_Python](#Section_dd6cd24c9dac4244ac00ebe58dd4ef4f) + +The complex type that specifies information about the [**Python environment**](#gt_17210a25-c8f9-4e33-ab88-02a7555e6854). + +*Child Elements:* + +**initialization:** A [CT_PythonInitialization](#Section_58a34c08a5b44eb7a50cf0c8c1f7a6e8) element that specifies the [**Python script**](#gt_ccedff9e-7c79-440f-9090-63915f6677ad) used to initialize the Python environment specified by the **id** attribute. + +**extLst:** A CT_ExtensionList ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section A.2) element that specifies future extensibility for this element. + +*Attributes:* + +**id:** An ST_Guid (\[ISO/IEC29500-1:2016\] section 22.9.2.4) attribute that specifies a unique identifier for the Python environment. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3017. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.39](#Section_ef230d238d80473c925e3e5b98abdbba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PythonInitialization + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/python + +*Referenced by:* [CT_PythonEnvironmentDefinition](#Section_6285909a009b4fbab73bf2a24ad05176) + +The complex type that specifies information about the [**Python script**](#gt_ccedff9e-7c79-440f-9090-63915f6677ad) used to initialize the [**Python environment**](#gt_17210a25-c8f9-4e33-ab88-02a7555e6854). + +*Child Elements:* + +**code:** An ST_Xstring ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) element that specifies the Python script to initialize the Python environment. + +*Attributes:* + +**userModified:** A Boolean ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether the Python script to initialize the Python environment specified by the **code** element has been modified by the user. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3024. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.39](#Section_ef230d238d80473c925e3e5b98abdbba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PythonScript + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/python + +*Referenced by:* [CT_PythonScripts](#Section_030a30ad829c40aa82d78ea4d56cb6c2) + +The complex type specifies a [**Python script**](#gt_ccedff9e-7c79-440f-9090-63915f6677ad). + +*Child Elements:* + +**code:** An ST_Xstring ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) element that specifies the Python script passed into a PY function (section [2.3.10.2](#Section_28f8f9b3e370440c9afc2a1bba74cde6)). If the code references any optional parameters passed in the PY function the encoding is as specified in **Parameter reference encoding** (section [2.3.10.4](#Section_8c3635ff73b341f78c3b889176c52877)). + +**extLst:** A CT_ExtensionList (\[ISO/IEC29500-1:2016\] section A.2) element that specifies future extensibility for this element. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3030. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.39](#Section_ef230d238d80473c925e3e5b98abdbba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PythonScripts + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/python + +*Referenced by:* [CT_Python](#Section_dd6cd24c9dac4244ac00ebe58dd4ef4f) + +The complex type specifies a collection of [**Python scripts**](#gt_ccedff9e-7c79-440f-9090-63915f6677ad). + +*Child Elements:* + +**pythonScript:** A [CT_PythonScript](#Section_5d4699a442fa447f84b021e7410e5069) element that specifies a Python script. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3036. \ + + \ + + \ + + \ + + \ + +See section [5.39](#Section_ef230d238d80473c925e3e5b98abdbba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DXFComplementExt + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +A complex type that contains a [CT_DXFComplement](#Section_688bbebaaf3142a9bdbb2bddb7657a2a) element. + +*Child Elements:* + +**DXFComplement:** A CT_DXFComplement element that references a [**feature property bag**](#gt_3f541c32-862c-47d2-8c55-e07e44e68bfb). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3041. \ + + \ + + \ + + \ + + \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_DXFComplement + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag + +*Referenced by:* [CT_DXFComplementExt](#Section_74fddcc6558a4300bd3632f63df51463), [DXFComplement](#Section_64a2efa67c9744479d6595b11f7de015) + +A complex type that specifies a relationship to a [CT_FeaturePropertyBag](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-xlsx/8383a417-7cb1-4324-af63-99dd77ffebd5) element of type **DXFComplements** (section [2.3.9.5](#Section_6f826926a32c47c4a279187e0959c74e)). + +*Attributes:* + +**i:** An unsigned int ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies a zero-based index into a [CT_ArrayFeatureProperty](#Section_26b90ad3836549769c1c1c7cd62d661f) element of a [CT_FeaturePropertyBag](#Section_8383a4177cb14324af6399dd77ffebd5) element, with key "MappedFeaturePropertyBags” in a [**feature property bag**](#gt_3f541c32-862c-47d2-8c55-e07e44e68bfb) of type “DXFComplements” (section 2.3.9.5). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3046. \ + + \ + + \ + +See section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_AggregationInfo + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation + +*Referenced by:* [aggregationInfo](#Section_001858c0862a4e809ebdd3321bc9e685) + +This complex type specifies extended information about a [**PivotTable data field**](#gt_422ecf6b-649e-4e99-9431-5297e4e297b8) item ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10.1.22). + +*Attributes:* + +**aggregationType:** An [ST_AggregationType](#Section_b0f1cde4f9ce47f697965124208c73da) attribute that specifies the **aggregation type** applied to the PivotTable data field if the type is not covered in the subtotal attribution in PivotTable data field. + +**sourceField:** An **unsignedInt** ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the zero-based index of the **CT_PivotField** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2) element in the list of **CT_PivotField** (\[ISO/IEC29500-4:2016\] section A.2) elements specified by the **CT_PivotFields** (\[ISO/IEC29500-4:2016\] section A.2) element that this data item summarizes. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3049. \ + + \ + + \ + + \ + +See section [5.40](#Section_bc0e64e719ba49a8852622960eacc4ba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_FeatureSupport + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation + +*Referenced by:* [featureSupportInfo](#Section_001e4ef376984269b607beab6f7d12e3) + +Specifies a feature name for use in versioning in a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10). + +*Attributes:* + +**featureName:** A string ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.1) attribute that specifies a feature name. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3053. \ + + \ + + \ + +See section [5.40](#Section_bc0e64e719ba49a8852622960eacc4ba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotCacheRichInfo + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2022/pivotRichData + +*Referenced by:* [richInfo](#Section_3eec63538e23478bb455bb3100157666) + +This complex type specifies extended information about a PivotTable cache that contains Rich Data (section [2.3.6](#Section_4f1ecdeda9884361a6ca62a789f3e095)). + +*Attributes:* + +**pivotCacheGuid:** An ST_Guid ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section 22.9.2.4) attribute that specifies the id for this PivotCache. MUST be equal to the **pivotCacheId** attribute of the preceding CT_PivotCacheDefinition (section [2.6.33](#Section_2924f3f8a9cb4b098557fda87770d5bd)). + +**pivotIgnoreInvalidCache:** A boolean ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies that the ignore attribute on the associated **CT_PivotCacheDefinition** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10.1.67) record SHOULD be ignored if the **richPivotRecords** part is used. + +**r:id:** An ST_RelationshipId (\[ISO/IEC29500-1:2016\] section 22.8.2.1) attribute that specifies the unique identifier that corresponds to the related **richPivotRecords** part. See **pivotCacheRecords** (\[ISO/IEC29500-1:2016\] section 18.10.1.67) for more information. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3056. \ + + \ + + \ + + \ + + \ + +See section [5.33](#Section_0f1d2cd1bba14ad3b607ffa7aa1e296f) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_Version + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2024/workbookCompatibilityVersion + +*Referenced by:* [CT_WorkbookCompatibilityVersionExt](#Section_d78afeb779da43a49282f3749c27250b), [version](#Section_bd4c22492b5f4bb0b05f8ebd6e770282) + +A complex type that specifies information about the Compatibility Version + +*Attributes:* + +**warnBelowVersion:** An unsignedInt ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.3.22) attribute that specifies the minimum Compatibility Version to support workbook contents at the current Compatibility Version for the workbook. The value MUST NOT be 0. + +**setVersion:** An unsignedInt (\[XMLSCHEMA2/2\] section 3.3.22) attribute that specifies the Compatibility Version for the workbook. This value MUST NOT be less than **warnBelowVersion** value. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3061. \ + + \ + + \ + + \ + +See section [5.42](#Section_a595485815b34cde98b3670ea2710489) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_WorkbookCompatibilityVersionExt + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2024/workbookCompatibilityVersion + +A complex type that contains a [CT_Version](#Section_294f537a8085415a82ad979e2912c316) element. + +*Child Elements:* + +**version:** A CT_Version element that specifies properties related to Compatibility Version. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3065. \ + + \ + + \ + + \ + + \ + +See section [5.42](#Section_a595485815b34cde98b3670ea2710489) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ShowDataTypeIcons + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/showDataTypeIcons + +*Referenced by:* [CT_ShowDataTypeIconsExt](#Section_3495b90b8d66425a887109395bd36b73), [CT_ShowDataTypeIconsCustomSheetViewExt](#Section_eaf3f2b9fc024b44b15e00a59d197eb7), [showDataTypeIcons](#Section_7962424de5e84eab97d6f16d844b7224), [showDataTypeIconsCustomSheetView](#Section_6295238f9d55448d8c1570733cd3ea13) + +A complex type that specifies whether Data Type Icons should be visible. + +*Attributes:* + +**visible:** A boolean ([\[XMLSCHEMA2/2\]](https://go.microsoft.com/fwlink/?LinkId=90609) section 3.2.2) attribute that specifies whether Data Type Icons should be visible. + +A boolean value indicating whether Data Type Icons should be visible. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3070. \ + + \ + + \ + +See section [5.43](#Section_8d375463bcab494680c767c59b9b40c0) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ShowDataTypeIconsCustomSheetViewExt + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/showDataTypeIcons + +A complex type that contains a [CT_ShowDataTypeIcons](#Section_eb5968b15dd445fcba682f0a61807480) element. + +*Child Elements:* + +**showDataTypeIconsCustomSheetView:** A CT_ShowDataTypeIcons element that specifies whether to show Data Type Icons on a custom sheet view. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3073. \ + + \ + + \ + + \ + + \ + +See section [5.43](#Section_8d375463bcab494680c767c59b9b40c0) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ShowDataTypeIconsExt + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/showDataTypeIcons + +A complex type that contains a [CT_ShowDataTypeIcons](#Section_eb5968b15dd445fcba682f0a61807480) element. + +*Child Elements:* + +**showDataTypeIcons:** A CT_ShowDataTypeIcons element that specifies whether to show Data Type Icons on a sheet view. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3078. \ + + \ + + \ + + \ + + \ + +See section [5.43](#Section_8d375463bcab494680c767c59b9b40c0) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ExternalCodeServiceImageAsInputExt + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2025/externalCodeService2 + +A complex type that contains a CT_ExternalCodeServiceImageAsInput element. + +*Child Elements:* + +**externalCodeServiceImageAsInput:** A [CT_ExternalCodeServiceImageAsInput](#Section_7d86e1c0496f48e895a3f2d5906ae261) element that specifies attributes of images used as input to an [**external code service**](#gt_9a3bc1c7-ad12-4371-85b6-78656d97437a). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3083. \ + + \ + + \ + + \ + + \ + +See section [5.44](#Section_4747e200ff5c428fba090d2586d791ed) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_ExternalCodeServiceImageAsInput + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2025/externalCodeService2 + +*Referenced by:* [CT_ExternalCodeServiceImageAsInputExt](#Section_abaebc66ffe7489880935ae7c3f9ef79), [externalCodeServiceImageAsInput](#Section_2794a1782d3a4e09a94a3615925d65d8) + +A complex type which contains properties of images sent to an [**external code service**](#gt_9a3bc1c7-ad12-4371-85b6-78656d97437a). + +*Attributes:* + +**maxWidth:** An unsignedInt attribute that specifies the maximum width in pixels. + +**maxHeight:** An unsignedInt attribute that specifies the maximum height in pixels. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3088. \ + + \ + + \ + + \ + +See section [5.44](#Section_4747e200ff5c428fba090d2586d791ed) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotAreaReferenceSubtotals + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation + +*Referenced by:* [pivotAreaReferenceSubtotals](#Section_1e3d157e554443b5925f837d6b794116) + +A complex type that specifies the subtotal types for [**PivotTable area**](#gt_e235cc70-2d45-4abd-95b1-1e06444e386a) reference. + +*Child Elements:* + +**subtotal:** A [CT_PivotSubtotalType](#Section_abd2d68a769c4e39bf1c5c45195c07ea) element that specifies subtotal for PivotTable area reference. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3092. \ + + \ + + \ + + \ + + \ + +See section [5.40](#Section_bc0e64e719ba49a8852622960eacc4ba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotCacheDataSource + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2025/pivotDataSource + +*Referenced by:* [pivotCacheDataSource](#Section_ef16f06deede42f0a88e8c906d0017ba) + +A complex type that specifies the data source for a [**PivotTable**](#gt_38963165-73bc-400a-a809-aff03693a316) when that data source is a dynamic array or a formula. + +*Child Elements:* + +**xm:f:** An ST_Formula [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.18.35 element that specifies the data source for a PivotTable. If this element is specified, the **ref** attribute MUST NOT be specified. + +*Attributes:* + +**ref:** An [ST_Ref](#Section_c326af1b1d0642219584aaadc9c94308) attribute that specifies ref data source for a PivotTable. The ref MUST specify a single cell, and that cell MUST contain a dynamic array. If this element is specified, the **f** element MUST NOT be specified. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3097. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.45](#Section_04ae0b0121e249a18f7746d3b9180217) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotFieldSubtotals + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation + +*Referenced by:* [pivotFieldSubtotals](#Section_3d8a1b460b184fa49e8e192d81fbe4f5) + +A complex type that specifies custom subtotal types for the [**PivotTable field**](#gt_52c9d088-c3c8-408b-b50a-c389b3267e44). + +*Child Elements:* + +**subtotal:** A [CT_PivotItemSubtotal](#Section_671592c9e62c472cbeba33e64eb38fc1) element that specifies a subtotal type to be added to the associated PivotTable field. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3103. \ + + \ + + \ + + \ + + \ + +See section [5.40](#Section_bc0e64e719ba49a8852622960eacc4ba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotItemSubtotal + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation + +*Referenced by:* [CT_PivotFieldSubtotals](#Section_78c8996c76c847f4afc97f0ca4078fa2), [CT_PivotTableSubtotalLineItems](#Section_2dd8e57bf8db48ac980282b2a8a0f17b) + +A complex type that specifies a subtotal for a [**PivotTable**](#gt_38963165-73bc-400a-a809-aff03693a316). + +*Attributes:* + +**subtotalType:** An [ST_AggregationType](#Section_b0f1cde4f9ce47f697965124208c73da) attribute that specifies the type of aggregation used to calculate the subtotal. + +**itemLocation:** An unsignedInt attribute that specifies location in the collection where the subtotal is located. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3108. \ + + \ + + \ + + \ + +See section [5.40](#Section_bc0e64e719ba49a8852622960eacc4ba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotSubtotalType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation + +*Referenced by:* [CT_PivotAreaReferenceSubtotals](#Section_6e909fda16f549c5a7aca9285f55fed2) + +A complex type that specifies a type of subtotal for a [**PivotTable**](#gt_38963165-73bc-400a-a809-aff03693a316). + +*Attributes:* + +**subtotalType:** An [ST_AggregationType](#Section_b0f1cde4f9ce47f697965124208c73da) attribute that specifies the type of aggregation used to calculate the subtotal. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3112. \ + + \ + + \ + +See section [5.40](#Section_bc0e64e719ba49a8852622960eacc4ba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### CT_PivotTableSubtotalLineItems + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation + +*Referenced by:* [pivotFieldSubtotalLineItems](#Section_6531aa8bec9a417eb68b46b6d7b4cae9) + +A complex type that specifies one or more [**PivotTable**](#gt_38963165-73bc-400a-a809-aff03693a316) line item entries. + +*Child Elements:* + +**subtotalLineItem:** A [CT_PivotItemSubtotal](#Section_671592c9e62c472cbeba33e64eb38fc1) element that specifies a subtotal entry on the PivotTable line. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this complex type. + +3115. \ + + \ + + \ + + \ + + \ + +See section [5.40](#Section_bc0e64e719ba49a8852622960eacc4ba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +## Simple Types + +### ST_Ref + +*Target namespace:* http://schemas.microsoft.com/office/excel/2006/main + +*Referenced by:* [CT_Ref](#Section_f875216dd800445d921374e4da53886f), [ST_Sqref](#Section_ea3aabce53f340d49682e4dda73cba75) + +This simple type specifies a reference to a [**range**](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99) of [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461). + +This simple type is identical to the **ST_Ref** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.18.62) simple type with the following exception: This simple type MUST have the following grammar. + +(A1-cell \[":" A1-cell\]) / ref-constant + +The [**ABNF**](#gt_24ddbbb4-b79e-4419-96ec-0fdd229c9ebf) ([\[RFC5234\]](https://go.microsoft.com/fwlink/?LinkId=123096)) definitions for A1-cell and ref-constant are specified in [Formulas](#Section_3d025add118d44139856ab65712ec1b0). + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3120. \ + + \ + + \ + +See section [5.1](#Section_b0ddba06ac734d3da9138fbe4a56cf28) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_Sqref + +*Target namespace:* http://schemas.microsoft.com/office/excel/2006/main + +*Referenced by:* [CT_Sqref](#Section_cb63a59070ec45739e144197ffd2f991) + +This simple type specifies a list of **[cell](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) [ranges](#gt_c2c93fec-8d3e-45de-8010-c738cc1cea99)**. + +This simple type is identical to the **ST_Sqref** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.18.76) simple type with the following exceptions: + +- MUST contain zero or more values of type [**ST_Ref**](#Section_c326af1b1d0642219584aaadc9c94308). + +- If the value contains an **ST_Ref** of value "#REF!", then it MUST be the only value in the list. + +- The number of cell references in this simple type MUST be less than 2,147,483,647. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3123. \ + + \ + + \ + +See section [5.1](#Section_b0ddba06ac734d3da9138fbe4a56cf28) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_DispBlanksAs + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SparklineGroup](#Section_331c1ecbe49d4cd0843d3ae189dc8a88) + +This simple type specifies how empty [**cells**](#gt_43d1e51e-4f26-493b-b7c9-e84e920d7461) are plotted for all [**sparklines**](#gt_69116abb-ab9d-485a-b8b2-8042ec25033f) in the sparkline group. + +| Value | Meaning | +|-------|------------------------------------------| +| span | Empty cells are plotted as interpolated. | +| gap | Empty cells are not plotted. | +| zero | Empty cells are plotted as zero. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3126. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_SparklineAxisMinMax + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SparklineGroup](#Section_331c1ecbe49d4cd0843d3ae189dc8a88) + +This simple type specifies information about how the vertical axis minimum or maximum is computed for this [**sparkline**](#gt_69116abb-ab9d-485a-b8b2-8042ec25033f) group. + +| Value | Meaning | +|----|----| +| individual | Specifies that the vertical axis minimum or maximum for each sparkline in this sparkline group is calculated automatically such that the [**data point**](#gt_cf31915d-9d25-4dbb-abc7-e78f60626dc4) with the **minimum** or maximum value can be displayed in the [**plot area**](#gt_5bf6768b-586e-4869-8247-e0f9e899183c). | +| group | Specifies that the vertical axis minimum or maximum is shared across all sparklines in this sparkline group and is calculated automatically such that the data point with the minimum or maximum value can be displayed in the plot area. | +| custom | Specifies that the vertical axis minimum or maximum for each sparkline in this sparkline group is specified by the **manualMin** attribute or the **manualMax** attribute of CT_SparklineGroup. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3133. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_SparklineType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SparklineGroup](#Section_331c1ecbe49d4cd0843d3ae189dc8a88) + +This simple type specifies the type of the [**sparkline**](#gt_69116abb-ab9d-485a-b8b2-8042ec25033f) group. + +| Value | Meaning | +|----|----| +| line | Line sparklines. | +| column | [**Column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) sparklines. | +| stacked | 100% stacked column sparklines. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3140. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_PivotShowAs + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_DataField](#Section_9fa014b6505d4aecbaf59473e2b3dd63) + +This simple type specifies the display format values for a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc). + +| Value | Meaning | +|----|----| +| percentOfParent | Percentage of parent total. | +| percentOfParentRow | Percentage of parent [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) total. | +| percentOfParentCol | Percentage of parent [**column**](#gt_9fc0c6e3-3fd3-4cfd-bf45-7b5d3461f972) total. | +| percentOfRunningTotal | Percentage of running total. | +| rankAscending | Rank ascending. | +| rankDescending | Rank descending. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3147. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_DataBarDirection + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_DataBar](#Section_88c5ca0a3a344fad8c91fdb4550d3fe1) + +A simple type that specifies the direction of the [**data bar**](#gt_d8d5ab5a-ebee-45a3-bd11-2a5779bb54ed). + +| Value | Meaning | +|----|----| +| context | The direction of the data bar is determined by context. | +| leftToRight | The data bar is displayed in a [**left-to-right**](#gt_b8c262f8-6c09-457a-9b68-4bf3a08ab067) manner. | +| rightToLeft | The data bar is displayed in a [**right-to-left**](#gt_91359688-7863-4e88-b507-f57b3dada5ec) manner. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3157. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_DataBarAxisPosition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_DataBar](#Section_88c5ca0a3a344fad8c91fdb4550d3fe1) + +A simple type that specifies the axis position for the [**data bar**](#gt_d8d5ab5a-ebee-45a3-bd11-2a5779bb54ed). + +| Value | Meaning | +|-----------|-----------------------------------------------------------------| +| automatic | The axis position for the data bar is calculated automatically. | +| middle | The axis position for the data bar is the midpoint of the cell. | +| none | There is no axis for the data bar. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3164. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_CfvoType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_Cfvo](#Section_15094f93f5874f4ebe741fbdc93da768) + +This simple type specifies how the Conditional Formatting Value Object (CFVO) value is determined. In the following table, X represents a parameter value. The value of X is determined by the value of the **f** element in the parent **CT_Cfvo** element. If the **f** element in the parent **CT_Cfvo** element is absent, then the value of X is 0. MUST be a value from the following table. + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ValueMeaning
numX
percent

The minimum value in the range of cells that the conditional formatting rule applies to plus X percent of the difference between the maximum and minimum values in the range of cells that the conditional formatting rule applies to.

+

For example, if the min and max values in the range are 1 and 10 respectively, and X is 10, then the CFVO value is 1.9.

maxThe maximum value from the range of cells that the conditional formatting rule applies to.
minThe minimum value from the range of cells that the conditional formatting rule applies to.
formulaX, or if the f element is formed by the numerical-constant rule alone in the grammar provided in Formulas, the formula is ignored and X is 0.
percentileThe minimum value of the cell that is in the X percentile of the range of cells that the conditional formatting rule applies to.
autoMinThe smaller of zero or the minimum value from the range of cells that the conditional formatting rule applies to.
autoMaxThe larger of zero or the maximum value from the range of cells that the conditional formatting rule applies to.
+ +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3171. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_IconSetType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_RichSortCondition](#Section_984b10b877a0427388afdf98616ee8e1), [CT_SortCondition](#Section_af08b8709b064812a4d67bc80d819e62), [CT_IconFilter](#Section_4c3c501ababc4bdba099f607977b8653), [CT_IconSet](#Section_bbfd40cc3cc9415991f7ff1f37d93375), [CT_CfIcon](#Section_b675bf5031df4cfb918220c27126e703) + +A simple type that specifies an [**icon set**](#gt_15e781d5-cddc-4852-b031-1ebc6b601ca9). + +| Value | Meaning | +|----|----| +| 3Arrows | | +| 3ArrowsGray | | +| 3Flags | | +| 3TrafficLights1 | | +| 3TrafficLights2 | | +| 3Signs | | +| 3Symbols | | +| 3Symbols2 | | +| 4Arrows | | +| 4ArrowsGray | | +| 4RedToBlack | | +| 4Rating | | +| 4TrafficLights | | +| 5Arrows | | +| 5ArrowsGray | | +| 5Rating | | +| 5Quarters | | +| 3Stars | | +| 3Triangles | | +| 5Boxes | | +| NoIcons | No icon set | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3183. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_PivotEditValueType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_PivotEditValue](#Section_fc28f146d73a46f6bf4c282fc9a960ef) + +A simple type that specifies the type of the modified value in the PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) data area using [PivotTable what-if analysis](#Section_9d7f085695a646b59af10e75dba0beb9). + +| Value | Meaning | +|----------|---------------------| +| number | Numerical value | +| dateTime | Date and time value | +| string | String value | +| boolean | Boolean value | +| error | Error value | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3208. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_AllocationMethod + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_PivotTableDefinition](#Section_4fa0ac531c40475fad76d06c604df3e3), [CT_PivotChange](#Section_dcf52159107344fcbbc41f2510b60283) + +A simple type that specifies the method of allocation for [PivotTable what-if analysis](#Section_9d7f085695a646b59af10e75dba0beb9). + +| Value | Meaning | +|--------------------|---------------------| +| equalAllocation | Equal allocation | +| equalIncrement | Equal increment | +| weightedAllocation | Weighted allocation | +| weightedIncrement | Weighted increment | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3217. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_SlicerStyleType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_SlicerStyleElement](#Section_b005a2aa3157442fbec6bfe0186e1359) + +A simple type that specifies the types of table style ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8) elements that are specific to [slicers](#Section_6c8a1b950c1842adbe5094771b2732f4). The possible values are listed in the following table. + +| Value | Meaning | +|----|----| +| unselectedItemWithData | A [slicer item](#Section_7790509116ec477581008ed67a1e7e3f) with data that is not [**selected**](#gt_f27adb49-1bec-4bfa-a1a8-0eb4db1ba595). Used for slicers only. | +| selectedItemWithData | A selected slicer item with data. Used for slicers only. | +| unselectedItemWithNoData | A slicer item with no data that is not selected. Used for slicers only. | +| selectedItemWithNoData | A selected slicer item with no data. Used for slicers only. | +| hoveredUnselectedItemWithData | A slicer item with data that is not selected and over which the mouse is paused on. Used for slicers only. | +| hoveredSelectedItemWithData | A selected slicer item with data and over which the mouse is paused on. Used for slicers only. | +| hoveredUnselectedItemWithNoData | A slicer item with no data that is not selected and over which the mouse is paused on. Used for slicers only. | +| hoveredSelectedItemWithNoData | A selected slicer item with no data and over which the mouse is paused on. Used for slicers only. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3225. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_ObjectType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_FormControlPr](#Section_8577637a66c3485bab6ef8c85689a7c4) + +A simple type that specifies the types of form control objects. The possible values are included in the following table. + +| Value | Meaning | +|----|----| +| Button | Button control | +| CheckBox | Check-box control | +| Drop | Drop-down (combo box) control | +| GBox | Group box control; this control is used for grouping radio button form controls | +| Label | Label control | +| List | List box control | +| Radio | Radio button control | +| Scroll | Scroll bar control | +| Spin | Spin box control | +| EditBox | Edit box control | +| Dialog | Dialog control | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3237. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_Checked + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_FormControlPr](#Section_8577637a66c3485bab6ef8c85689a7c4) + +A simple type that specifies if a check box is selected or if the radio button is selected. + +| Value | Meaning | +|----|----| +| Unchecked | Object is unchecked or unselected. | +| Checked | Object is checked or selected. | +| Mixed | Mixed selection. Applies only to check boxes. The application can determine whether to consider this option as a check box that is not initialized and it is neither selected nor cleared. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3252. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_DropStyle + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_FormControlPr](#Section_8577637a66c3485bab6ef8c85689a7c4) + +This simple type specifies the style of a drop-down form control. The allowed values are included in the following table. + +| Value | Meaning | +|----|----| +| combo | Standard combo box. | +| comboedit | Editable combo box[\<29\>](#Appendix_A_29). | +| simple | Standard combo box with only the drop-down button visible when the box is not expanded. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3259. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_SelType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_FormControlPr](#Section_8577637a66c3485bab6ef8c85689a7c4) + +A simple type that specifies the selection type for the list box form control object. The allowed values are included in the following table. + +| Value | Meaning | +|----|----| +| single | Only single selection is allowed. | +| multi | Multiple selection is allowed. Clicking any item on the list will add it to the selection or, if already selected, will remove it from the selection. | +| extended | Multiple selection is allowed while the CTRL key is pressed. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3266. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_EditValidation + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_FormControlPr](#Section_8577637a66c3485bab6ef8c85689a7c4) + +This simple type specifies the type of validation used for data input to the control. If omitted, the value is assumed to be text. If present, the application can proceed to validate the data accordingly. The valid values are included in the following table. + +| Value | Meaning | +|----|----| +| text | Edit box contains text. | +| integer | Edit box contains an integer. | +| number | Edit box contains a number. | +| reference | Edit box contains a cell reference ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.17.2.3). | +| formula | Edit box contains a spreadsheet formula (\[ISO/IEC29500-1:2016\] section 18.17). | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3273. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_OlapSlicerCacheSortOrder + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_OlapSlicerCacheLevelData](#Section_e3ebe2f523c445cb9e3010b78347fee1) + +A simple type that specifies how the [OLAP slicer items](#Section_ac62b47c91274f09b816e14a6909a1dc) are sorted in the [slicer view](#Section_69c0e0f9d0144bd59f2d2f554c715083). + +| Value | Meaning | +|----|----| +| natural | The OLAP slicer items are sorted in original order as determined by the [**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) [slicer source data](#Section_953b6fbd8a1241029d6a7da6de12598a). | +| ascending | The OLAP slicer items are sorted in ascending alphabetical order. | +| descending | The OLAP slicer items are sorted in descending alphabetical order. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3282. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_TabularSlicerCacheSortOrder + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_TableSlicerCache](#Section_c3629be299fe44b7970c3ea6df625cf5), [CT_TabularSlicerCache](#Section_3ffb16d6f376403c8282bff4dc78eef8) + +A simple type that specifies how the [non-OLAP slicer items](#Section_a7ffe1389cc14e5ea0dba1ca7674a304) are sorted in the [slicer view](#Section_69c0e0f9d0144bd59f2d2f554c715083). + +| Value | Meaning | +|----|----| +| ascending | The non-OLAP slicer items are sorted in ascending alphabetical order. | +| descending | The non-OLAP slicer items are sorted in descending alphabetical order. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3289. \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_SlicerCacheCrossFilter + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_TableSlicerCache](#Section_c3629be299fe44b7970c3ea6df625cf5), [CT_OlapSlicerCacheLevelData](#Section_e3ebe2f523c445cb9e3010b78347fee1), [CT_TabularSlicerCache](#Section_3ffb16d6f376403c8282bff4dc78eef8) + +A simple type that specifies how the [slicer items](#Section_7790509116ec477581008ed67a1e7e3f) that are used in [slicer cross filtering](#Section_ae98d186e6a9495981f5fd9359cdc6b3) are displayed. + +| Value | Meaning | +|----|----| +| none | The table style ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8) element of the [slicer style](#Section_c27949e2eac54d889655187392cab0aa) for slicer items with no data is not applied to slicer items with no data, and slicer items with no data are not sorted separately in the list of slicer items in the [slicer view](#Section_69c0e0f9d0144bd59f2d2f554c715083). | +| showItemsWithDataAtTop | The table style (\[ISO/IEC29500-1:2016\] section 18.8) element of the slicer style for slicer items with no data is applied to slicer items with no data, and slicer items with no data are sorted at the bottom in the list of slicer items in the slicer view. | +| showItemsWithNoData | The table style (\[ISO/IEC29500-1:2016\] section 18.8) element of the slicer style for slicer items with no data is applied to slicer items with no data, and slicer items with no data are not sorted separately in the list of slicer items in the slicer view. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3295. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_TextHAlign + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_FormControlPr](#Section_8577637a66c3485bab6ef8c85689a7c4) + +A simple type that specifies the vertical text alignment for the object. The valid values are included in the following table. + +| Value | Meaning | +|-------------|-----------------------| +| left | Left alignment | +| center | Center alignment | +| right | Right alignment | +| justify | Justify alignment | +| distributed | Distributed alignment | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3302. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_TextVAlign + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2009/9/main + +*Referenced by:* [CT_FormControlPr](#Section_8577637a66c3485bab6ef8c85689a7c4) + +A simple type that specifies the vertical text alignment for the object. The valid values are included in the following table. + +| Value | Meaning | +|-------------|-----------------------| +| top | Top alignment | +| center | Center alignment | +| bottom | Bottom alignment | +| justify | Justify alignment | +| distributed | Distributed alignment | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3311. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.4](#Section_0a377581c7434acebfcd22f359e70165) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_TimelineStyleType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_TimelineStyleElement](#Section_79d1e43b5b1a49e1957c50b49ff9a2e8) + +A simple type that specifies the types of table style ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.8) elements that are specific to [Timelines](#Section_92ac3f95d5bb4584882e95e4e9c443c8). The possible values are listed in the following table. + +| Value | Meaning | +|----|----| +| selectionLabel | Timeline style element that applies to the selection label which is the label that indicates the period that has been selected on the Timeline. Used for Timelines only. | +| timeLevel | Timeline style element that applies to the time level which is the label that indicates the time granularity of the Timeline. Used for Timelines only. | +| periodLabel1 | Timeline style element that applies to the upper [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) of the time block labels. Used for Timelines only. | +| periodLabel2 | Timeline style element that applies to the lower row of the time block labels. Used for Timelines only. | +| selectedTimeBlock | Timeline style element that applies to the selected time blocks which are the segments on the Timeline that have been selected by the user. Used for Timelines only. | +| unselectedTimeBlock | Timeline style element that applies to the unselected time blocks which are the segments on the Timeline that have not been selected by the user. Used for Timelines only. | +| selectedTimeBlockSpace | Timeline style element that applies to the area between any two selected time blocks. Used for Timelines only. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3320. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_CalcMemNumberFormat + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_CalculatedMember](#Section_fe7c684762044120b6d95efe6deb8bde) + +An enumeration that specifies the display format for a CT_CalculatedMember. + +| Value | Meaning | +|----|----| +| default | Specifies that the number will be displayed using its current format. | +| number | Specifies that the number will be displayed using a comma as a thousands separator. | +| percent | Specifies that the number will be displayed as a percentage with two decimal places. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3331. \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_SXVCellType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_PivotValueCell](#Section_680ed56527f24b4f8fbaaa2f5196ad81) + +A simple type that specifies the type of a [PivotValueCell](#Section_b513aa61a36146368a3f4850a3f2a588) element of a PivotTable ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10) that is specified by a [pivotTableReference](#Section_ba9ab888b9894fe3afaeb5b64ccf7922) element in the extension of a [**workbook**](#gt_343c4660-90e1-4d86-b9cc-5007075d9dfe). + + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ValueMeaning
bThe child element v of the CT_PivotValueCell. MUST be interpreted as a Boolean value. MUST be true or false.
nThe child element v of the CT_PivotValueCell. MUST be interpreted as a numeric value.
e

The child element v of the CT_PivotValueCell. MUST be interpreted as an error value. MUST be one of the following:

+
    +
  • #DIV/0!

  • +
  • #VALUE!

  • +
  • #NUM!

  • +
  • #N/A

  • +
  • #GETTING_DATA

  • +
strThe child element v of the CT_PivotValueCell. MUST be interpreted as a string value. The string MUST be less than or equal to 65,535 characters in length.
dThe child element v of the CT_PivotValueCell. MUST be interpreted as a dateTime ([XMLSCHEMA2/2] section 3.2.7) value.
blA blank cell. The child element v of the CT_PivotValueCell. MUST NOT have any value.
+ +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3338. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_QuestionType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_SurveyQuestion](#Section_9a439a2aff0f45ddad06ebe35a8fad89) + +The **ST_QuestionType** simple type specifies the type of input for the answer to a survey question as specified by the **type** attribute of a **CT_SurveyQuestion** (section 2.6.144). + +| Value | Meaning | +|---------------------|-----------------------------------------------| +| checkBox | Answer is indicated via checkbox. | +| choice | Answer is selected from a list of choices. | +| date | Answer in the form of a date. | +| time | Answer in the form of a time. | +| multipleLinesOfText | Answer in the form of multiple lines of text. | +| number | Answer is numerical. | +| singleLineOfText | Answer in the form of a single line of text. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3348. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_QuestionFormat + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_SurveyQuestion](#Section_9a439a2aff0f45ddad06ebe35a8fad89) + +The **ST_QuestionFormat** simple type specifies the text formatting of the input for the answer to a survey question as specified by the **format** attribute of a **CT_SurveyQuestion** (section 2.6.144). + +| Value | Meaning | +|----|----| +| generalDate | Format answer as a date. | +| longDate | Format answer as a long form date. | +| shortDate | Format answer as a short form date. | +| longTime | Format answer as a long form time. | +| shortTime | Format answer as a short form time. | +| generalNumber | Format answer as a number. | +| standard | Format answer as a number with thousands separators. | +| fixed | Format answer as a number with a fixed number of digits after the decimal. | +| percent | Format answer as a percentage. | +| currency | Format answer as a currency. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3359. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_SurveyPosition + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2010/11/main + +*Referenced by:* [CT_SurveyElementPr](#Section_6f620903d79540548df23f1ff56f37bf) + +The **ST_SurveyPosition** simple type specifies the type of positioning of an element in a survey, as specified by the **position** attribute of a **CT_SurveyElementPr** (section 2.6.145). The types correspond to the allowed values for the position property of Cascading Style Sheets 2.1, as defined in [\[CSS-Level2-2009\]](https://go.microsoft.com/fwlink/?LinkId=182880). + +| Value | Meaning | +|----------|---------------------------| +| absolute | Use absolute positioning. | +| fixed | Use fixed positioning. | +| relative | Use relative positioning. | +| static | Use static positioning. | +| inherit | Use inherit positioning. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3373. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_ModelTimeGroupingContentType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2014/11/main + +*Referenced by:* [CT_CalculatedTimeColumn](#Section_65dfaa1784dc40d2bc199e49c81c4ff9) + +Specifies the grouping content type inside a **[calculated column](#gt_ec25719c-0814-4978-a7e7-f18111a9598d).** + +| Value | Meaning | +|-------------|--------------| +| years | Years | +| quarters | Quarters | +| monthsindex | Months Index | +| months | Months | +| daysindex | Days Index | +| days | Days | +| hours | Hours | +| minutes | Minutes | +| seconds | Seconds | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3382. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.10](#Section_4fe24a216f694680882ff86b16a69119) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_Xrevid + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2014/revision + +*Referenced by:* [CT_RevisionPtr](#Section_7fc8862a63f242638334b9e72b480c8e) + +This simple type is used in runtime scenarios for Microsoft Excel, and SHOULD be ignored by all others. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3395. \ + + \ + + \ + +See section [5.15](#Section_5ba37a83255b4e2dae7bb4d14d44ad3a) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_ArrayValueType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_ArrayValue](#Section_1e7ed3935fe346219fb8328461535262) + +This simple type specifies the [**data type**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) of the [**rich array**](#gt_4b9137fd-391c-4d11-9488-c5d535d68feb) value. The possible values are listed in the following table. + +| Value | Meaning | +|----|----| +| d | Indicates rich array value is a real number. | +| i | Indicates rich array value is an integer. | +| b | Indicates rich array value is a [**Boolean**](#gt_1d79d7a7-ba2c-4b34-931c-7ba8057c87b2). | +| e | Indicates rich array value is an error. | +| s | Indicates rich array value is text. | +| r | Indicates rich array value is a [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). | +| a | Indicates rich array value is a rich array. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3398. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_RichFormatPropertyType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichFormatProperty](#Section_c2a904f51e464f588f9feb245df5ce79) + +This simple type specifies the [**data type**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) of the value of the property for the [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a) format. + +| Value | Meaning | +|----|----| +| b | Indicates value of the property for the rich value format is a [**Boolean**](#gt_1d79d7a7-ba2c-4b34-931c-7ba8057c87b2). | +| n | Indicates value of the property for the rich value format is a real number. | +| i | Indicates value of the property for the rich value format is an integer. | +| s | Indicates value of the property for the rich value format is text. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3409. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_RichValueFallbackType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata + +*Referenced by:* [CT_RichValueFallback](#Section_56b98662f6e04e7886497ec216b10680) + +This simple type specifies the [**data type**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) of the value of the fallback for the [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). + +| Value | Meaning | +|----|----| +| b | Indicates fallback value is a [**Boolean**](#gt_1d79d7a7-ba2c-4b34-931c-7ba8057c87b2). | +| n | Indicates fallback value is a real number. | +| e | Indicates fallback value is an error. | +| s | Indicates fallback value is text. | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3417. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.21](#Section_9058338fcf3b4a7b8f84622e180eacc5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_RichValueValueType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata + +*Referenced by:* [CT_Key](#Section_a6955ad1aef84ea2b754909220e4439e) + +This simple type specifies the [**data type**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) of the value of the [**key value pair (KVP)**](#gt_b334e51c-02fa-407f-93d2-402ce53f3c0f). + +| Value | Meaning | +|----|----| +| d | Indicates value is a real number. | +| i | Indicates value is an integer. | +| b | Indicates value is a [**Boolean**](#gt_1d79d7a7-ba2c-4b34-931c-7ba8057c87b2). | +| e | Indicates value is an error. | +| s | Indicates value is text. | +| r | Indicates value is a [**rich value**](#gt_6b4745f1-42f9-4382-9ffe-aaf34d550d6a). | +| a | Indicates value is a [**rich array**](#gt_4b9137fd-391c-4d11-9488-c5d535d68feb). | +| spb | Indicates value is a [**supporting property bag**](#gt_048a0082-4ff4-4807-8300-69ccc781c098). | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3425. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.21](#Section_9058338fcf3b4a7b8f84622e180eacc5) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_SupportingPropertyBagArrayValueType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_SupportingPropertyBagArrayValue](#Section_78790c4757f649b9b410494ac5c96004) + +This simple type specifies the [**data type**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) of a single value in the [**supporting property bag array**](#gt_7b3f3c16-241f-4a7f-8677-ac555c9a45bb) + +| Value | Meaning | +|----|----| +| d | Indicates value is a real number. | +| i | Indicates value is an integer. | +| b | Indicates value is a [**Boolean**](#gt_1d79d7a7-ba2c-4b34-931c-7ba8057c87b2). | +| s | Indicates value is text. | +| spb | Indicates value is a [**supporting property bag**](#gt_048a0082-4ff4-4807-8300-69ccc781c098). | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3437. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_SupportingPropertyBagValueType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_SupportingPropertyBagKey](#Section_0937b5a8413440998a784ab1459974f8) + +This simple type specifies the [**data type**](#gt_0d327bc0-a461-4723-8beb-d935fdab4895) of a value in the [**supporting property bag**](#gt_048a0082-4ff4-4807-8300-69ccc781c098). + +| Value | Meaning | +|----|----| +| d | Indicates value is a real number. | +| i | Indicates value is an integer. | +| b | Indicates value is a [**Boolean**](#gt_1d79d7a7-ba2c-4b34-931c-7ba8057c87b2). | +| s | Indicates value is text. | +| spb | Indicates value is a supporting property bag. | +| spba | Indicates value is a [**supporting property bag array**](#gt_7b3f3c16-241f-4a7f-8677-ac555c9a45bb). | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3446. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_RichFilterKey + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 + +*Referenced by:* [CT_RichFilter](#Section_602d53f6e36b419c8961a3f4daee98d1), [CT_RichDateGroupItem](#Section_800e0c6cdb9d49c5abebdee0b3690f08), [CT_RichTop10](#Section_6a109ad8a40e4d6f871cd0e3c985056c), [CT_CustomRichFilter](#Section_c9ffab2d6f0445a9bbf10511538e8909), [CT_DynamicRichFilter](#Section_6eaa79bef3c14949894351b2ffadb9ca) + +This simple type extends **ST_Xstring** ([\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 22.9.2.19) and specifies the [**rich value key**](#gt_9bd647fb-b615-497b-bd37-76e19d7835d3) for which the [**filter**](#gt_ffbe7b55-8e84-4f41-a18d-fc29191a4cda) is defined. The length of this string MUST be less than or equal to 65,535 characters in length. This simple type MUST conform to one of the following grammars. + +| Grammar | Example | +|----|----| +| { rich-value-key } | "RichFilterKey" | +| { \["#" length-of-rich-value-key "#" rich-value-key\] } | "#13#RichFilterKey" | + +- The length-of-rich-value-key MUST be specified with integers and MUST match the count of the characters in the associated rich-value-key. + +- The rich-value-key MUST be less than or equal to 255 characters in length. + +- If rich-value-key begins with "#" then it MUST use the second grammar. + +- The second grammar can be repeated to specify nested rich value keys. + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3456. \ + + \ + + \ + +See section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +### ST_AggregationType + +*Target namespace:* http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation + +*Referenced by:* [CT_AggregationInfo](#Section_4ad69738dc4442ecb084ce92071cb359), [CT_PivotItemSubtotal](#Section_671592c9e62c472cbeba33e64eb38fc1), [CT_PivotSubtotalType](#Section_abd2d68a769c4e39bf1c5c45195c07ea) + +This simple type specifies an [**aggregation function**](#gt_f9b44a9d-68c4-4a28-b347-cce9eb5f8845) applied to a [**PivotTable data field**](#gt_422ecf6b-649e-4e99-9431-5297e4e297b8). + +| Value | Meaning | +|----|----| +| distinctCount | The count of unique values in the source [**PivotTable field**](#gt_52c9d088-c3c8-408b-b50a-c389b3267e44) | +| median | The middle value in the source PivotTable field | +| distinctDuplicates | The count of distinct duplicate values in the source PivotTable field | +| countValuesDuplicated | The count of duplicate values, excluding the first in the source PivotTable field | +| countRepeatValues | The count of duplicate values, including the first in the source PivotTable field | + +The following W3C XML Schema ([\[XMLSCHEMA1/2\]](https://go.microsoft.com/fwlink/?LinkId=90607) section 2.1) fragment specifies the contents of this simple type. + +3459. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +See section [5.40](#Section_bc0e64e719ba49a8852622960eacc4ba) for the full W3C XML Schema (\[XMLSCHEMA1/2\] section 2.1). + +# Structure Examples + +This section contains examples of some of the most commonly used data structures in Excel Binary File Format files. The examples are meant to be a starting point for an implementer learning the file format. They are not meant to cover all records in the file format. + +In the following sections, the schema definition might differ from the processing rules imposed by the application. The XSD in this specification provides a base description of the file format. The text that introduces the XSD specifies additional restrictions that reflect actual Microsoft product behavior. For example, the schema definition might allow for an element to be empty, null, or not present but the behavior of the application as specified restricts the same elements to being non-empty, not null, and present. + +## Slicer + +This example shows a [slicer](#Section_6c8a1b950c1842adbe5094771b2732f4) attached to a native PivotTable and its associated [slicer cache](#Section_b0f3c3117ab64314af398bd3bed3bccf). The PivotTable has the "State" and "City" [**fields**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) added to the [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) area and the "Population" field added to the data area. The slicer is based on the "State" field, and is currently filtering on "Washington". + +The following figure shows a possible implementation of the slicer discussed in this example. + +
+ +

Figure 1: PivotTable and slicer

+
+ +The following figure shows that the [**source data**](#gt_ac56a86c-7f2f-4d8b-a4c0-d6c7df3e72e0) for the PivotTable that the slicer discussed in this example is filtering, as depicted on a possible implementation of a worksheet. + +
+ +

Figure 2: Source data for the PivotTable

+
+ +This example includes the entire slicer cache and [slicer](#Section_7e51dda34c5b4c54bd12c45529550456) parts that are used in the specification of a non-[**OLAP**](#gt_055c223a-52f1-4d41-b95b-d7c60eaa388f) slicer. + +The \ elements inside the \ element specify the cached [non-OLAP slicer items](#Section_a7ffe1389cc14e5ea0dba1ca7674a304). "Washington" and "Oregon" are the cached non-OLAP slicer items in this example. + +### Slicer Cache Part + +The following is an example slicer cache part, as specified in section [2.1.4](#Section_7dbb4481b02145cc8bd46094b566a5ff). + +3468. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +The following table describes the **slicerCacheDefinition** element used in this example. + +| Attribute name | Value | Notes | +|----|----|----| +| **name** | Slicer_State | This is the name of the slicer cache. | +| **sourceName** | State | This is the name of the associated slicer, as specified in section [2.1.5](#Section_bfeb551bf5904f68aa8d9edd824acefc). | + +The following table describes the **pivotTable** element used in this example. + +| Attribute name | Value | Notes | +|----|----|----| +| **tabId** | 1 | This indicates that the associated PivotTable, as specified in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.10, is located on the first [**sheet**](#gt_0b356926-f9cb-4dc2-a859-71441d62503d). | +| **name** | PivotTable1 | This is the name of the associated PivotTable. | + +The following table describes the **tabular** element used in this example. + +| Attribute name | Value | Notes | +|----|----|----| +| **pivotCacheId** | 5 | This indicates that the identifier of the associated PivotTable **PivotCache** is "5". | + +The following table describes the **items** element used in this example. + +| Attribute name | Value | Notes | +|----|----|----| +| **count** | 2 | This indicates that there are two items in the slicer cache. | + +The following table describes the first i (item) element used in this example. + +| Attribute name | Value | Notes | +|----|----|----| +| **x** | 1 | This indicates that the first item in the slicer cache is the second item in the PivotTable **PivotCache**. | + +The following table describes the second i (item) element used in this example. + +| Attribute name | Value | Notes | +|----|----|----| +| **x** | 0 | This indicates that the second item in the slicer cache is the first item in the PivotTable **PivotCache**. | +| **s** | 1 | This indicates that this item is selected in the slicer. | + +### Slicer Part + +The following is an example slicer part, as specified in section [2.1.5](#Section_bfeb551bf5904f68aa8d9edd824acefc). + +3482. \ + + \ + + \ + + \ + +The following table describes the slicer element used in this example. + +| Attribute name | Value | Notes | +|----|----|----| +| **name** | State | This is the name of the slicer. | +| **cache** | Slicer_State | This is the name of the slicer cache, as specified in section [2.1.4](#Section_7dbb4481b02145cc8bd46094b566a5ff). | +| **caption** | State | This is the caption displayed at the top of the slicer. | +| **rowHeight** | 228600 | This is the height of a [**row**](#gt_a87817fc-9b18-49a1-925e-9be9e1d92665) in [**EMUs**](#gt_264db3a3-b788-42b9-8a78-38ddc62ccd39), equal to one-fourth of an inch. | + +# Security Considerations + +## Security Considerations for Implementers + +The password verifier features available in the file format are used to prevent accidental modification, rather than being used as security features. It is possible to remove the passwords by removing the records containing the verifier values. + +The translation of passwords from a double-byte [**Unicode**](#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8) string to a new character string in the ANSI code page of the current system converts any Unicode character that cannot be mapped to the ANSI code page of the current system to the 0x3F character in that code page, as described in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) section 18.2.29. Replacing these characters with "0x3F" when the [**hash**](#gt_b7e2b611-0af5-4fec-8af2-3f9ce7bad205) is verified will generate positive hash value matches. In certain [**locales**](#gt_7b78ebef-e35d-45ab-abfd-4121b60995de), this can be a significant portion of the everyday [**character set**](#gt_5004b992-4a9c-41c9-b65c-b2e7a2b04204). + +Further security considerations regarding the file encryption algorithms are described in [\[MS-OFFCRYPTO\]](%5bMS-OFFCRYPTO%5d.pdf#Section_3c34d72a1a614b52a893196f9157f083) section 4.1.3. + +## Index of Security Fields + +None. + +# Appendix A: Full XML Schema + +For ease of implementation, this section provides the full W3C XML schemas for the new elements, attributes, complex types, and simple types specified in the earlier sections. Any schema references to namespaces included in Office Open XML file formats as described in [\[ISO/IEC29500-1:2016\]](https://go.microsoft.com/fwlink/?linkid=861065) refer specifically to the transitional schemas as described in [\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068). + +For ease of implementation, the following sections provide the full XML schema for this protocol. + +| Schema name | Prefix | Section | +|----|----|----| +| http://schemas.microsoft.com/office/excel/2006/main | | section [5.1](#Section_b0ddba06ac734d3da9138fbe4a56cf28) | +| http://schemas.microsoft.com/office/drawing/2010/slicer | | section [5.2](#Section_8ccfc6adcdae4ac6964317d999d1a7e6) | +| http://schemas.microsoft.com/office/spreadsheetml/2010/11/main | | section [5.3](#Section_e42bbfd72a3d4308a4f330313fc506b9) | +| http://schemas.microsoft.com/office/spreadsheetml/2009/9/main | | section [5.4](#Section_0a377581c7434acebfcd22f359e70165) | +| http://schemas.microsoft.com/office/spreadsheetml/2009/9/ac | | section [5.5](#Section_7148c81d4d6e4204be07a7c09f4277c7) | +| http://schemas.microsoft.com/office/spreadsheetml/2011/1/ac | | section [5.6](#Section_aa12452a467d41928ebf0a90d86dd64b) | +| http://schemas.microsoft.com/office/drawing/2012/timeslicer | | section [5.7](#Section_c4febed78f37443bb83d668ffd09d082) | +| http://schemas.microsoft.com/office/excel/2010/spreadsheetDrawing | | section [5.8](#Section_b54c3971c1684f9c8791c07f8d8d8002) | +| http://schemas.microsoft.com/office/spreadsheetml/2010/11/ac | | section [5.9](#Section_ce659475d5804104895fb72947105f24) | +| http://schemas.microsoft.com/office/spreadsheetml/2014/11/main | | section [5.10](#Section_4fe24a216f694680882ff86b16a69119) | +| http://schemas.microsoft.com/office/spreadsheetml/2015/02/main | | section [5.11](#Section_e29f5a54ff7147e99183440b65eb27ad) | +| http://schemas.microsoft.com/office/spreadsheetml/2016/revision10 | | section [5.12](#Section_8a818a7f92d0439098551a484d8f9347) | +| http://schemas.microsoft.com/office/spreadsheetml/2016/revision9 | | section [5.13](#Section_1df7cd78d8bc4ec489521b61beeaee76) | +| http://schemas.microsoft.com/office/spreadsheetml/2016/revision6 | | section [5.14](#Section_e47e052c40d043cdadd473a220966b69) | +| http://schemas.microsoft.com/office/spreadsheetml/2014/revision | | section [5.15](#Section_5ba37a83255b4e2dae7bb4d14d44ad3a) | +| http://schemas.microsoft.com/office/spreadsheetml/2015/revision2 | | section [5.16](#Section_7b729443d0cd434e8d8cb228f701a55b) | +| http://schemas.microsoft.com/office/spreadsheetml/2016/revision3 | | section [5.17](#Section_1c6fdaed8a404086be070135b10b8f90) | +| http://schemas.microsoft.com/office/spreadsheetml/2016/revision5 | | section [5.18](#Section_83ec1155c05a4c5e84b5844b18358690) | +| http://schemas.microsoft.com/office/spreadsheetml/2016/pivotdefaultlayout | | section [5.19](#Section_9b107b7d1fe8476f9ba5f237ceaf6a0e) | +| http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 | | section [5.20](#Section_7149166445c9427ab1d869dc70a1dd07) | +| http://schemas.microsoft.com/office/spreadsheetml/2017/richdata | | section [5.21](#Section_9058338fcf3b4a7b8f84622e180eacc5) | +| http://schemas.microsoft.com/office/spreadsheetml/2018/calcfeatures | | section [5.22](#Section_6c4054c805a949dcbaa913e5a6282989) | +| http://schemas.microsoft.com/office/spreadsheetml/2018/threadedcomments | | section [5.23](#Section_adb847329fc848b6bddc6b0bcdaad940) | +| http://schemas.microsoft.com/office/spreadsheetml/2018/08/main | | section [5.24](#Section_b38f8644d3e64d20889d56a9df09cad8) | +| http://schemas.microsoft.com/office/spreadsheetml/2017/dynamicarray | | section [5.25](#Section_878c8ac485484bfb9ad4b1378e0efed1) | +| http://schemas.microsoft.com/office/spreadsheetml/2019/namedsheetviews | | section [5.26](#Section_55396aef0c074ffb9ffbe48b6d339abe) | +| http://schemas.microsoft.com/office/spreadsheetml/2019/extlinksprops | | section [5.27](#Section_b2939e1139c1475699097a2dc79e8c2e) | +| http://schemas.microsoft.com/office/spreadsheetml/2020/richdatawebimage | | section [5.28](#Section_1dc262ba8b454611b6fbce1b04a561e0) | +| http://schemas.microsoft.com/office/spreadsheetml/2020/pivotNov2020 | | section [5.29](#Section_a9f2fa9d070f449180e8832783f0ada2) | +| http://schemas.microsoft.com/office/spreadsheetml/2020/threadedcomments2 | | section [5.30](#Section_716e392dd858443ba393141a983260b0) | +| http://schemas.microsoft.com/office/spreadsheetml/2020/richvaluerefresh | | section [5.31](#Section_7c97123fa8954094afe6b661d7f3e634) | +| http://schemas.microsoft.com/office/spreadsheetml/2022/pivotVersionInfo | | section [5.32](#Section_ce4604c1dd30452c9fc1630dc4012961) | +| http://schemas.microsoft.com/office/spreadsheetml/2022/pivotRichData | | section [5.33](#Section_0f1d2cd1bba14ad3b607ffa7aa1e296f) | +| http://schemas.microsoft.com/office/spreadsheetml/2021/extlinks2021 | | section [5.34](#Section_ffd38adacfa54242976b198f6fd508d9) | +| http://schemas.microsoft.com/office/spreadsheetml/2022/richvaluerel | | section [5.35](#Section_56bafcc41ae84894a86c1e92f165a3c5) | +| http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag | | section [5.36](#Section_9e45d09d206b4134a90eb5be9c08b2fa) | +| http://schemas.microsoft.com/office/spreadsheetml/2023/msForms | | section [5.37](#Section_e38e8867d5f0492ab64bb57779e18216) | +| http://schemas.microsoft.com/office/spreadsheetml/2023/externalCodeService | | section [5.38](#Section_b3c832bd13c74c2f869eac31bf13ea7c) | +| http://schemas.microsoft.com/office/spreadsheetml/2023/python | | section [5.39](#Section_ef230d238d80473c925e3e5b98abdbba) | +| http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation | | section [5.40](#Section_bc0e64e719ba49a8852622960eacc4ba) | +| http://schemas.microsoft.com/office/spreadsheetml/2024/pivotAutoRefresh | | section [5.41](#Section_6a5315967c64455b93fa7a8d7e3fca15) | +| http://schemas.microsoft.com/office/spreadsheetml/2024/workbookCompatibilityVersion | | section [5.42](#Section_a595485815b34cde98b3670ea2710489) | +| http://schemas.microsoft.com/office/spreadsheetml/2023/showDataTypeIcons | | section [5.43](#Section_8d375463bcab494680c767c59b9b40c0) | +| http://schemas.microsoft.com/office/spreadsheetml/2025/externalCodeService2 Schema | | section [5.44](#Section_4747e200ff5c428fba090d2586d791ed) | +| http://schemas.microsoft.com/office/spreadsheetml/2025/pivotDataSource Schema | | section [5.45](#Section_04ae0b0121e249a18f7746d3b9180217) | + +## http://schemas.microsoft.com/office/excel/2006/main Schema + +3486. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/drawing/2010/slicer Schema + +3517. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2010/11/main Schema + +3529. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2009/9/main Schema + +3988. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2009/9/ac Schema + +4866. \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2011/1/ac Schema + +4872. \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/drawing/2012/timeslicer Schema + +4877. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/excel/2010/spreadsheetDrawing Schema + +4888. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2010/11/ac Schema + +4914. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2014/11/main Schema + +4922. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2015/02/main Schema + +4963. \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2016/revision10 Schema + +4967. \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2016/revision9 Schema + +4972. \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2016/revision6 Schema + +4976. \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2014/revision Schema + +4982. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2015/revision2 Schema + +5000. \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2016/revision3 Schema + +5004. \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2016/revision5 Schema + +5008. \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2016/pivotdefaultlayout Schema + +5011. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2017/richdata2 Schema + +5025. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2017/richdata Schema + +5301. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2018/calcfeatures Schema + +5373. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2018/threadedcomments Schema + +5385. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2018/08/main Schema + +5437. \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2017/dynamicarray Schema + +5440. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2019/namedsheetviews Schema + +5451. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2019/extlinksprops Schema + +5511. \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2020/richdatawebimage Schema + +5517. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2020/pivotNov2020 Schema + +5538. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2020/threadedcomments2 Schema + +5551. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2020/richvaluerefresh Schema + +5570. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2022/pivotVersionInfo Schema + +5583. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2022/pivotRichData Schema + +5600. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2021/extlinks2021 Schema + +5610. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2022/richvaluerel Schema + +5625. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2022/featurepropertybag Schema + +5639. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2023/msForms Schema + +5743. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2023/externalCodeService Schema + +5772. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2023/python Schema + +5784. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2023/pivot2023Calculation Schema + +5819. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2024/pivotAutoRefresh Schema + +5865. \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2024/workbookCompatibilityVersion Schema + +5869. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2023/showDataTypeIcons Schema + +5881. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2025/externalCodeService2 Schema + +5899. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2025/pivotDataSource Schema + +5911. \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + + \ + +## http://schemas.microsoft.com/office/spreadsheetml/2026/pivotDataSourceClean Schema + +5922. \ + + \ + + \ + + \ + +# Appendix B: Product Behavior + +The information in this specification is applicable to the following Microsoft products or supplemental software. References to product versions include updates to those products. + +- Microsoft Office Excel 2007 + +- Microsoft Excel 2010 + +- Microsoft Excel 2013 + +- Microsoft Excel 2016 + +- Microsoft Excel 2019 + +- Microsoft Excel 2021 + +- Microsoft Excel LTSC 2024 + +Exceptions, if any, are noted in this section. If an update version, service pack or Knowledge Base (KB) number appears with a product name, the behavior changed in that update. The new behavior also applies to subsequent updates unless otherwise specified. If a product edition appears with the product version, behavior is different in that product edition. + +Unless otherwise specified, any statement of optional behavior in this specification that is prescribed using the terms "SHOULD" or "SHOULD NOT" implies product behavior in accordance with the SHOULD or SHOULD NOT prescription. Unless otherwise specified, the term "MAY" implies that the product does not follow the prescription. + +[\<1\> Section 2.2](#Appendix_A_Target_1): This namespace was introduced in Excel 2013. + +[\<2\> Section 2.2](#Appendix_A_Target_2): This namespace was introduced in Excel 2010. + +[\<3\> Section 2.2](#Appendix_A_Target_3): This namespace was introduced in Excel 2010. + +[\<4\> Section 2.2](#Appendix_A_Target_4): This namespace was introduced in Excel 2013. + +[\<5\> Section 2.2](#Appendix_A_Target_5): This namespace was introduced in Excel 2013. + +[\<6\> Section 2.2.2](#Appendix_A_Target_6): In Excel version 2509 and later, the total string length for longtext-params SHOULD NOT exceed 4095 characters. + +[\<7\> Section 2.4.104](#Appendix_A_Target_7): Excel versions prior to Excel LTSC 2024 will not ignore this. + +[\<8\> Section 2.4.105](#Appendix_A_Target_8): Excel versions prior to Excel LTSC 2024 will not ignore this. + +[\<9\> Section 2.5.4](#Appendix_A_Target_9): This attribute is available only in Excel 2016. + +[\<10\> Section 2.6.3](#Appendix_A_Target_10): Office Excel 2007, Excel 2010, and Excel 2013 do not write the correct value into this [**field**](#gt_f819dd42-7f44-4613-8231-d5ad47f2bbcc) sometimes. Although the value of this field is validated on load, it is not used at run time. + +[\<11\> Section 2.6.3](#Appendix_A_Target_11): Office Excel 2007, Excel 2010, and Excel 2013 do not write the correct value into this field sometimes. Although the value of this field is validated on load, it is not used at run time. + +[\<12\> Section 2.6.10](#Appendix_A_Target_12): The following table shows the different versions of function accuracy that Excel 2010 and Excel 2013 supports. + +| Value | Meaning | +|----|----| +| 0 | Functions are calculated using the current application’s algorithms. | +| 1 | Functions are calculated using algorithms implemented in Office Excel 2007. | +| 2 | Functions are calculated using algorithms implemented in Excel 2010. | + +[\<13\> Section 2.6.24](#Appendix_A_Target_13): Office Excel 2007 does not support multiple uses of the same [**OLAP measure**](#gt_7431c051-4564-4476-ad00-39c66f169118) in one cache hierarchy, and does not discard the associated cache hierarchy when **ignore** is TRUE. + +[\<14\> Section 2.6.25](#Appendix_A_Target_14): Office Excel 2007 will not ignore the **fld** attribute of the ancestor **CT_DataField** ([\[ISO/IEC29500-4:2016\]](https://go.microsoft.com/fwlink/?linkid=861068) section A.2). + +[\<15\> Section 2.6.30](#Appendix_A_Target_15): Office Excel 2007 does not ignore these complex types. + +[\<16\> Section 2.6.31](#Appendix_A_Target_16): Office Excel 2007 does not support multiple uses of the same OLAP measure in one PivotTable view, and does not ignore this pivot field when **ignore** is TRUE. + +[\<17\> Section 2.6.34](#Appendix_A_Target_17): The 2007 Microsoft Office system does not load a file in which this field contains a value that it does not recognize, or is not recognized by the underlying operating system. The 2007 Office system recognizes the following language tags. + +| Language | Locale | Language tag | +|----|----|----| +| Afrikaans | South Africa | af-ZA | +| Albanian | Albania | sq-AL | +| Alsatian | France | gsw-FR | +| Amharic | Ethiopia | am-ET | +| Arabic | Algeria | ar-DZ | +| Arabic | Kingdom of Bahrain | ar-BH | +| Arabic | Egypt | ar-EG | +| Arabic | Iraq | ar-IQ | +| Arabic | Jordan | ar-JO | +| Arabic | Kuwait | ar-KW | +| Arabic | Lebanon | ar-LB | +| Arabic | Libya | ar-LY | +| Arabic | Morocco | ar-MA | +| Arabic | Oman | ar-OM | +| Arabic | Qatar | ar-QA | +| Arabic | Saudi Arabia | ar-SA | +| Arabic | Syria | ar-SY | +| Arabic | Tunisia | ar-TN | +| Arabic | U.A.E. | ar-AE | +| Arabic | Yemen | ar-YE | +| Armenian | Armenia | hy-AM | +| Assamese | India | as-IN | +| Azerbaijani (Cyrillic) | Azerbaijan | az-AZ-Cyrl | +| Azerbaijani (Latin) | Azerbaijan | az-AZ-Latn | +| Bangla | Bangladesh | bn-BD | +| Bangla (Bangla Script) | India | bn-IN | +| Bashkir | Russia | ba-RU | +| Basque | Basque (Basque) | eu-ES | +| Belarusian | Belarus | be-BY | +| Bhutanese | Bhutan | bo-BT | +| Bosnian (Cyrillic) | Bosnia and Herzegovina | bs-BA-Cyrl | +| Bosnian (Latin) | Bosnia and Herzegovina | bs-BA-Latn | +| Breton | France | br-FR | +| Bulgarian | Bulgaria | bg-BG | +| Catalan | Catalan | ca-ES | +| Chinese | Hong Kong SAR | zh-HK | +| Chinese | Macao SAR | zh-MO | +| Chinese | PRC | zh-CN | +| Chinese | Singapore | zh-SG | +| Chinese | Taiwan | zh-TW | +| Corsican | France | co-FR | +| Croatian | Croatia | hr-HR | +| Croatian (Latin) | Bosnia and Herzegovina | hr-BA-Latn | +| Czech | Czech Republic | cs-CZ | +| Danish | Denmark | da-DK | +| Dari | Afghanistan | prs-AF | +| Divehi | Maldives | div-MV | +| Dutch | Belgium | nl-BE | +| Dutch | Netherlands | nl-NL | +| English | Australia | en-AU | +| English | Belize | en-BZ | +| English | Canada | en-CA | +| English | Caribbean | en-CB | +| English | India | en-IN | +| English | Ireland | en-IE | +| English | Jamaica | en-JM | +| English | Malaysia | en-MY | +| English | New Zealand | en-NZ | +| English | Philippines | en-PH | +| English | South Africa | en-ZA | +| English | Trinidad | en-TT | +| English | United Kingdom | en-GB | +| English | United States | en-US | +| English | Zimbabwe | en-ZW | +| Estonian | Estonia | et-EE | +| Faroese | Faroe Islands | fo-FO | +| Filipino | Philippines | fil-PH | +| Finnish | Finland | fi-FI | +| French | Belgium | fr-BE | +| French | Canada | fr-CA | +| French | France | fr-FR | +| French | Luxembourg | fr-LU | +| French | Monaco | fr-MC | +| French | Switzerland | fr-CH | +| Frisian | Netherlands | fy-NL | +| Galician | Galicia | gl-ES | +| Georgian | Georgia | ka-GE | +| German | Austria | de-AT | +| German | Germany | de-DE | +| German | Liechtenstein | de-LI | +| German | Luxembourg | de-LU | +| German | Switzerland | de-CH | +| Greek | Greece | el-GR | +| Greenlandic | Greenland | kl-GL | +| Gujarati (Gujarati Script) | India | gu-IN | +| Hausa (Latin) | Nigeria | ha-NG-Latn | +| Hebrew | Israel | he-IL | +| Hindi | India | hi-IN | +| Hungarian | Hungary | hu-HU | +| Icelandic | Iceland | is-IS | +| Igbo | Nigeria | ig-NG | +| Inari Sami | Finland | smn-FI | +| Indonesian | Indonesia | id-ID | +| Inuktitut (Latin) | Canada | iu-CA-Latn | +| Inuktitut (Syllabics) | Canada | iu-CA-Cans | +| Irish | Ireland | ga-IE | +| isiXhosa / Xhosa | South Africa | xh-ZA | +| isiZulu / Zulu | South Africa | zu-ZA | +| Italian | Italy | it-IT | +| Italian | Switzerland | it-CH | +| Japanese | Japan | ja-JP | +| Kannada (Kannada Script) | India | kn-IN | +| Kazakh | Kazakhstan | kk-KZ | +| Khmer | Cambodia | kh-KH | +| K'iche | Guatemala | qut-GT | +| Kinyarwanda | Rwanda | rw-RW | +| Konkani | India | kok-IN | +| Korean | Korea | ko-KR | +| Kyrgyz | Kyrgyzstan | ky-KG | +| Lao | Lao PDR | lo-LA | +| Latvian | Latvia | lv-LV | +| Lithuanian | Lithuania | lt-LT | +| Lower Sorbian | Germany | wee-DE | +| Lule Sami | Norway | smj-NO | +| Lule Sami | Sweden | smj-SE | +| Luxembourgish | Luxembourg | lb-LU | +| Macedonian (North Macedonia) | North Macedonia, Republic of | mk-MK | +| Malay | Brunei | ms-BN | +| Malay | Malaysia | ms-MY | +| Malayalam (Malayalam Script) | India | ml-IN | +| Maltese | Malta | mt-MT | +| Maori | New Zealand | mi-NZ | +| Mapudungun | Chile | arn-CL | +| Marathi | India | mr-IN | +| Mohawk | Mohawk | moh-CA | +| Mongolian (Cyrillic) | Mongolia | mn-MN | +| Mongolian (Mongolian) | PRC | mn-CN-Mong | +| Nepali | Federal Democratic Republic of Nepal | ne-NP | +| Northern Sami | Finland | se-FI | +| Northern Sami | Norway | se-NO | +| Northern Sami | Sweden | se-SE | +| Norwegian (Bokmål) | Norway | nb-NO | +| Norwegian (Nynorsk) | Norway | nn-NO | +| Occitan | France | oc-FR | +| Odia (Odia Script) | India | or-IN | +| Pashto | Afghanistan | ps-AF | +| Persian | Iran | fa-IR | +| Polish | Poland | pl-PL | +| Portuguese | Brazil | pt-BR | +| Portuguese | Portugal | pt-PT | +| Punjabi (Gurmukhi Script) | India | pa-IN | +| Quechua | Bolivia | quz-BO | +| Quechua | Ecuador | quz-EC | +| Quechua | Peru | quz-PE | +| Romanian | Romania | ro-RO | +| Romansh | Switzerland | rm-CH | +| Russian | Russia | ru-RU | +| Sakha | Russia | sah-RU | +| Sanskrit | India | sa-IN | +| Serbian (Cyrillic) | Bosnia and Herzegovina | sr-BA-Cyrl | +| Serbian (Cyrillic) | Serbia | sr-SP-Cyrl | +| Serbian (Latin) | Bosnia and Herzegovina | sr-BA-Latn | +| Serbian (Latin) | Serbia | sr-SP-Latn | +| Sesotho sa Leboa / Northern Sotho | South Africa | ns-ZA | +| Setswana / Tswana | South Africa | tn-ZA | +| Sinhala | Sri Lanka | si-LK | +| Skolt Sami | Finland | sms-FI | +| Slovak | Slovakia | sk-SK | +| Slovenian | Slovenia | sl-SI | +| Southern Sami | Norway | sma-NO | +| Southern Sami | Sweden | sma-SE | +| Spanish | Argentina | es-AR | +| Spanish | Bolivia | es-BO | +| Spanish | Chile | es-CL | +| Spanish | Columbia | es-CO | +| Spanish | Costa Rica | es-CR | +| Spanish | Dominican Republic | es-DO | +| Spanish | Ecuador | es-EC | +| Spanish | El Salvador | es-SV | +| Spanish | Guatemala | es-GT | +| Spanish | Honduras | es-HN | +| Spanish | Mexico | es-MX | +| Spanish | Nicaragua | es-NI | +| Spanish | Panama | es-PA | +| Spanish | Paraguay | es-PY | +| Spanish | Peru | es-PE | +| Spanish | Commonwealth of Puerto Rico | es-PR | +| Spanish | Spain | es-ES | +| Spanish | United States | es-US | +| Spanish | Uruguay | es-UY | +| Spanish | Venezuela | es-VE | +| Swahili | Kenya | sw-KE | +| Swedish | Finland | sv-FI | +| Swedish | Sweden | sv-SE | +| Syriac | Syria | syr-SY | +| Tajik (Cyrillic) | Tajikistan | tg-TJ-Cyrl | +| Tamazight (Latin) | Algeria | tmz-DZ-Latn | +| Tamil | India | ta-IN | +| Tatar | Russia | tt-RU | +| Telugu (Telugu Script) | India | te-IN | +| Thai | Thailand | th-TH | +| Tibetan | PRC | bo-CN | +| Turkish | Turkey | tr-TR | +| Turkmen | Turkmenistan | tk-TM | +| Uighur | PRC | ug-CN | +| Ukrainian | Ukraine | uk-UA | +| Upper Sorbian | Germany | wen-DE | +| Urdu | Pakistan | ur-PK | +| Uzbek (Cyrillic) | Uzbekistan | uz-UZ-Cyrl | +| Uzbek (Latin) | Uzbekistan | uz-UZ-Latn | +| Vietnamese | Viet Nam | vi-VN | +| Welsh | United Kingdom | cy-GB | +| Wolof | Senegal | wo-SN | +| Yi | PRC | ii-CN | +| Yoruba | Nigeria | yo-NG | + +[\<18\> Section 2.6.47](#Appendix_A_Target_18): Office Excel 2007 does not ignore the ancestor **CT_PivotHierarchy** element. + +[\<19\> Section 2.6.48](#Appendix_A_Target_19): Office Excel 2007 does not ignore the ancestor **CT_CacheField** element. + +[\<20\> Section 2.6.63](#Appendix_A_Target_20): Excel 2010 and Excel 2013 requires that the corresponding **ListItem** (\[ISO/IEC29500-4:2016\] section 19.4.2.36) be present. + +[\<21\> Section 2.6.65](#Appendix_A_Target_21): Excel 2010 loads and roundtrips this value for scroll bars and spin boxes, but it does not support its functionality. + +[\<22\> Section 2.6.65](#Appendix_A_Target_22): Excel 2010 requires that the corresponding **FmlaRange** (\[ISO/IEC29500-4:2016\] section 19.4.2.29) be present. + +[\<23\> Section 2.6.65](#Appendix_A_Target_23): Excel 2010 and Excel 2013 ignore this attribute. This attribute is being deprecated. + +[\<24\> Section 2.6.65](#Appendix_A_Target_24): This attribute is being deprecated in Excel 2010. Its functionality will be replaced with attribute **noThreeD**. + +[\<25\> Section 2.6.65](#Appendix_A_Target_25): Excel 2010 loads and roundtrips this value, but it only supports its functionality for scroll bar form controls when run in a dialog box . + +[\<26\> Section 2.6.65](#Appendix_A_Target_26): Excel 2010 does not support this attribute. + +[\<27\> Section 2.6.65](#Appendix_A_Target_27): Excel 2010 does not support this attribute. + +[\<28\> Section 2.6.220](#Appendix_A_Target_28): Excel uses the UTF-16LE encoding for the comment string when computing the CRC32 checksum. + +[\<29\> Section 2.7.16](#Appendix_A_Target_29): Excel 2010 uses this value only when the drop-down control is run in a dialog box, in all other cases the drop-down control behaves as a standard combo box. + +# Change Tracking + +This section identifies changes that were made to this document since the last release. Changes are classified as Major, Minor, or None. + +The revision class **Major** means that the technical content in the document was significantly revised. Major changes affect protocol interoperability or implementation. Examples of major changes are: + +- A document revision that incorporates changes to interoperability requirements. + +- A document revision that captures changes to protocol functionality. + +The revision class **Minor** means that the meaning of the technical content was clarified. Minor changes do not affect protocol interoperability or implementation. Examples of minor changes are updates to clarify ambiguity at the sentence, paragraph, or table level. + +The revision class **None** means that no new technical changes were introduced. Minor editorial and formatting changes may have been made, but the relevant technical content is identical to the last released version. + +The changes made to this document are listed in the following table. For more information, please contact . + +| Section | Description | Revision class | +|----|----|----| +| [2.4.116](#Section_dfceda99a2764c858fedc800c587c500) dataSourceClean | Added new dataSourceClean element. | Major | +| [5.46](#Section_6b811658ed2043d5b6f77f3f21a43fb4) http://schemas.microsoft.com/office/spreadsheetml/2026/pivotDataSourceClean Schema | Added new schema for pivotDataSourceClean. | Major | + +# Index + +" + +"External workbook references + +[extensions by part](#external-workbook-references) 73 + +A + +[Applicability](#applicability-statement) 26 + +B + +[BrtBeginECTxtWiz](#ct_connection-1) 230 + +C + +[cachedUniqueNames element](#cacheduniquenames) 128 + +[cacheField element](#cachefield) 118 + +cacheHierarchy element ([section 2.4.16](#cachehierarchy) 115, [section 2.4.52](#cachehierarchy-1) 126) + +calculatedMember element ([section 2.4.15](#calculatedmember) 115, [section 2.4.44](#calculatedmember-1) 123) + +[Change tracking](#change-tracking) 428 + +[Common data types and fields](#structures) 28 + +Complex types + +[CT_CachedUniqueName](#ct_cacheduniquename) 255 + +[CT_CachedUniqueNames](#ct_cacheduniquenames) 255 + +[CT_CacheField](#ct_cachefield) 195 + +CT_CacheHierarchy ([section 2.6.24](#ct_cachehierarchy) 167, [section 2.6.102](#ct_cachehierarchy-1) 239) + +CT_CalculatedMember ([section 2.6.15](#ct_calculatedmember) 161, [section 2.6.93](#ct_calculatedmember-1) 232) + +[CT_CalculatedMemberExt](#ct_calculatedmemberext) 232 + +[CT_CfIcon](#ct_cficon) 187 + +[CT_CfRule](#ct_cfrule) 173 + +[CT_Cfvo](#ct_cfvo) 171 + +[CT_ColorScale](#ct_colorscale) 177 + +[CT_ConditionalFormat](#ct_conditionalformat) 196 + +[CT_ConditionalFormats](#ct_conditionalformats) 196 + +[CT_ConditionalFormatting](#ct_conditionalformatting) 149 + +[CT_ConditionalFormattings](#ct_conditionalformattings) 148 + +CT_Connection ([section 2.6.34](#ct_connection) 185, [section 2.6.91](#ct_connection-1) 230) + +[CT_CustomFilter](#ct_customfilter) 205 + +[CT_CustomFilters](#ct_customfilters) 204 + +[CT_DataBar](#ct_databar) 178 + +[CT_DataFeedPr](#ct_datafeedpr) 254 + +CT_DataField ([section 2.6.25](#ct_datafield) 170, [section 2.6.141](#ct_datafield-1) 264, [section 2.6.256](#ct_aggregationinfo) 330) + +[CT_DataModel](#ct_datamodel) 258 + +[CT_DatastoreItem](#ct_datastoreitem) 212 + +[CT_DataValidation](#ct_datavalidation) 151 + +[CT_DataValidationFormula](#ct_datavalidationformula) 150 + +[CT_DataValidations](#ct_datavalidations) 150 + +[CT_DbCommand](#ct_dbcommand) 253 + +[CT_DbTable](#ct_dbtable) 252 + +[CT_DbTables](#ct_dbtables) 253 + +[CT_FieldListActiveTabTopLevelEntity](#ct_fieldlistactivetabtoplevelentity) 233 + +[CT_Filter](#ct_filter) 204 + +[CT_FormControlPr](#ct_formcontrolpr) 208 + +[CT_IconFilter](#ct_iconfilter) 203 + +[CT_IconSet](#ct_iconset) 176 + +[CT_IgnoredError](#ct_ignorederror) 199 + +[CT_IgnoredErrors](#ct_ignorederrors) 198 + +[CT_ListItem](#ct_listitem) 207 + +[CT_ListItems](#ct_listitems) 208 + +[CT_ModelRelationship](#ct_modelrelationship) 257 + +[CT_ModelRelationships](#ct_modelrelationships) 257 + +[CT_ModelTable](#ct_modeltable) 256 + +[CT_ModelTables](#ct_modeltables) 256 + +[CT_ModelTextPr](#ct_modeltextpr) 251 + +[CT_OlapSlicerCache](#ct_olapslicercache) 222 + +[CT_OlapSlicerCacheItem](#ct_olapslicercacheitem) 219 + +[CT_OlapSlicerCacheItemParent](#ct_olapslicercacheitemparent) 220 + +[CT_OlapSlicerCacheLevelData](#ct_olapslicercacheleveldata) 221 + +[CT_OlapSlicerCacheLevelsData](#ct_olapslicercachelevelsdata) 222 + +[CT_OlapSlicerCacheRange](#ct_olapslicercacherange) 220 + +[CT_OlapSlicerCacheRanges](#ct_olapslicercacheranges) 221 + +[CT_OlapSlicerCacheSelection](#ct_olapslicercacheselection) 224 + +[CT_OlapSlicerCacheSelections](#ct_olapslicercacheselections) 223 + +[CT_OledbPr](#ct_oledbpr) 254 + +[CT_OleItem](#ct_oleitem) 192 + +[CT_PivotCacheDefinition](#ct_pivotcachedefinition) 184 + +[CT_PivotCacheIdVersion](#ct_pivotcacheidversion) 262 + +[CT_PivotChange](#ct_pivotchange) 189 + +[CT_PivotChanges](#ct_pivotchanges) 188 + +[CT_PivotEdit](#ct_pivotedit) 188 + +[CT_PivotEdits](#ct_pivotedits) 187 + +[CT_PivotEditValue](#ct_pivoteditvalue) 190 + +[CT_PivotField](#ct_pivotfield) 181 + +[CT_PivotFilter](#ct_pivotfilter) 234 + +[CT_PivotHierarchy](#ct_pivothierarchy) 194 + +[CT_PivotRow](#ct_pivotrow) 259 + +[CT_PivotTableData](#ct_pivottabledata) 258 + +CT_PivotTableDefinition ([section 2.6.32](#ct_pivottabledefinition) 182, [section 2.6.156](#ct_pivottabledefinition16) 274) + +[CT_PivotTableReference](#ct_pivottablereference) 227 + +[CT_PivotTableReferences](#ct_pivottablereferences) 227 + +[CT_PivotTableServerFormats](#ct_pivottableserverformats) 262 + +[CT_PivotTableUISettings](#ct_pivottableuisettings) 235 + +[CT_PivotUserEdit](#ct_pivotuseredit) 190 + +[CT_PivotValueCell](#ct_pivotvaluecell) 260 + +[CT_PivotValueCellExtra](#ct_pivotvaluecellextra) 261 + +[CT_ProtectedRange](#ct_protectedrange) 202 + +[CT_ProtectedRanges](#ct_protectedranges) 201 + +[CT_QueryTable](#ct_querytable) 228 + +[CT_RangePr](#ct_rangepr) 252 + +[CT_SetLevel](#ct_setlevel) 166 + +[CT_SetLevels](#ct_setlevels) 166 + +CT_Slicer ([section 2.6.68](#ct_slicer) 213, [section 2.6.69](#ct_slicer-1) 215) + +[CT_SlicerCache](#ct_slicercache) 161 + +[CT_SlicerCacheData](#ct_slicercachedata) 217 + +[CT_SlicerCacheDefinition](#ct_slicercachedefinition) 216 + +[CT_SlicerCacheHideNoData](#ct_slicercachehidenodata) 239 + +[CT_SlicerCacheOlapLevelName](#ct_slicercacheolaplevelname) 240 + +[CT_SlicerCachePivotTable](#ct_slicercachepivottable) 218 + +[CT_SlicerCachePivotTables](#ct_slicercachepivottables) 218 + +[CT_SlicerCaches](#ct_slicercaches) 160 + +[CT_SlicerRef](#ct_slicerref) 160 + +[CT_SlicerRefs](#ct_slicerrefs) 159 + +[CT_Slicers](#ct_slicers) 213 + +[CT_SlicerStyle](#ct_slicerstyle) 191 + +[CT_SlicerStyleElement](#ct_slicerstyleelement) 192 + +[CT_SlicerStyleElements](#ct_slicerstyleelements) 198 + +[CT_SlicerStyles](#ct_slicerstyles) 197 + +[CT_SortCondition](#ct_sortcondition) 205 + +[CT_SourceConnection](#ct_sourceconnection) 207 + +[CT_Sparkline](#ct_sparkline) 158 + +[CT_SparklineGroup](#ct_sparklinegroup) 154 + +[CT_SparklineGroups](#ct_sparklinegroups) 153 + +[CT_Sparklines](#ct_sparklines) 158 + +[CT_Table](#ct_table) 186 + +[CT_TableSlicerCache](#ct_tableslicercache) 236 + +[CT_TabularSlicerCache](#ct_tabularslicercache) 224 + +[CT_TabularSlicerCacheItem](#ct_tabularslicercacheitem) 226 + +[CT_TabularSlicerCacheItems](#ct_tabularslicercacheitems) 226 + +[CT_Timeline](#ct_timeline) 243 + +[CT_TimelineCacheDefinition](#ct_timelinecachedefinition) 246 + +[CT_TimelineCachePivotTable](#ct_timelinecachepivottable) 248 + +[CT_TimelineCachePivotTables](#ct_timelinecachepivottables) 247 + +[CT_TimelineCacheRef](#ct_timelinecacheref) 237 + +[CT_TimelineCacheRefs](#ct_timelinecacherefs) 237 + +[CT_TimelinePivotCacheDefinition](#ct_timelinepivotcachedefinition) 242 + +[CT_TimelinePivotFilter](#ct_timelinepivotfilter) 250 + +[CT_TimelineRange](#ct_timelinerange) 248 + +[CT_TimelineRef](#ct_timelineref) 238 + +[CT_TimelineRefs](#ct_timelinerefs) 238 + +[CT_Timelines](#ct_timelines) 243 + +[CT_TimelineState](#ct_timelinestate) 249 + +[CT_TimelineStyle](#ct_timelinestyle) 241 + +[CT_TimelineStyleElement](#ct_timelinestyleelement) 242 + +[CT_TimelineStyleElements](#ct_timelinestyleelements) 241 + +[CT_TimelineStyles](#ct_timelinestyles) 240 + +[CT_TupleSet](#ct_tupleset) 163 + +[CT_TupleSetHeader](#ct_tuplesetheader) 164 + +[CT_TupleSetHeaders](#ct_tuplesetheaders) 163 + +[CT_TupleSetRow](#ct_tuplesetrow) 165 + +[CT_TupleSetRowItem](#ct_tuplesetrowitem) 165 + +[CT_TupleSetRows](#ct_tuplesetrows) 164 + +[CT_TypeItems](#ct_tupleitems) 191 + +[CT_WebExtension](#ct_webextension) 229 + +[CT_WebExtensions](#ct_webextensions) 229 + +CT_WorkbookPr ([section 2.6.10](#ct_workbookpr) 159, [section 2.6.117](#ct_workbookpr-1) 250) + +Conceptual overview + +[structures](#conceptual-overview) 82 + +[conditionalFormattings element](#conditionalformattings) 112 + +connection element ([section 2.4.21](#connection) 116, [section 2.4.43](#connection-1) 123) + +Connections + +[extensions by part](#connections) 72 + +Control properties + +[part enumerations](#control-properties) 28 + +[CT_CachedUniqueName complex type](#ct_cacheduniquename) 255 + +[CT_CachedUniqueNames complex type](#ct_cacheduniquenames) 255 + +[CT_CacheField complex type](#ct_cachefield) 195 + +CT_CacheHierarchy complex type ([section 2.6.24](#ct_cachehierarchy) 167, [section 2.6.102](#ct_cachehierarchy-1) 239) + +CT_CalculatedMember complex type ([section 2.6.15](#ct_calculatedmember) 161, [section 2.6.93](#ct_calculatedmember-1) 232) + +[CT_CalculatedMemberExt complex type](#ct_calculatedmemberext) 232 + +[CT_CfIcon complex type](#ct_cficon) 187 + +[CT_CfRule complex type](#ct_cfrule) 173 + +[CT_Cfvo complex type](#ct_cfvo) 171 + +[CT_ColorScale complex type](#ct_colorscale) 177 + +[CT_ConditionalFormat complex type](#ct_conditionalformat) 196 + +[CT_ConditionalFormats complex type](#ct_conditionalformats) 196 + +[CT_ConditionalFormatting complex type](#ct_conditionalformatting) 149 + +[CT_ConditionalFormattings complex type](#ct_conditionalformattings) 148 + +CT_Connection complex type ([section 2.6.34](#ct_connection) 185, [section 2.6.91](#ct_connection-1) 230) + +[CT_CustomFilter complex type](#ct_customfilter) 205 + +[CT_CustomFilters complex type](#ct_customfilters) 204 + +[CT_DataBar complex type](#ct_databar) 178 + +[CT_DataFeedPr complex type](#ct_datafeedpr) 254 + +CT_DataField complex type ([section 2.6.25](#ct_datafield) 170, [section 2.6.141](#ct_datafield-1) 264, [section 2.6.256](#ct_aggregationinfo) 330) + +[CT_DataModel complex type](#ct_datamodel) 258 + +[CT_DatastoreItem complex type](#ct_datastoreitem) 212 + +[CT_DataValidation complex type](#ct_datavalidation) 151 + +[CT_DataValidationFormula complex type](#ct_datavalidationformula) 150 + +[CT_DataValidations complex type](#ct_datavalidations) 150 + +[CT_DbCommand complex type](#ct_dbcommand) 253 + +[CT_DbTable complex type](#ct_dbtable) 252 + +[CT_DbTables complex type](#ct_dbtables) 253 + +[CT_FieldListActiveTabTopLevelEntity complex type](#ct_fieldlistactivetabtoplevelentity) 233 + +[CT_Filter complex type](#ct_filter) 204 + +[CT_FormControlPr complex type](#ct_formcontrolpr) 208 + +[CT_IconFilter complex type](#ct_iconfilter) 203 + +[CT_IconSet complex type](#ct_iconset) 176 + +[CT_IgnoredError complex type](#ct_ignorederror) 199 + +[CT_IgnoredErrors complex type](#ct_ignorederrors) 198 + +[CT_ListItem complex type](#ct_listitem) 207 + +[CT_ListItems complex type](#ct_listitems) 208 + +[CT_ModelRelationship complex type](#ct_modelrelationship) 257 + +[CT_ModelRelationships complex type](#ct_modelrelationships) 257 + +[CT_ModelTable complex type](#ct_modeltable) 256 + +[CT_ModelTables complex type](#ct_modeltables) 256 + +[CT_ModelTextPr complex type](#ct_modeltextpr) 251 + +[CT_OlapSlicerCache complex type](#ct_olapslicercache) 222 + +[CT_OlapSlicerCacheItem complex type](#ct_olapslicercacheitem) 219 + +[CT_OlapSlicerCacheItemParent complex type](#ct_olapslicercacheitemparent) 220 + +[CT_OlapSlicerCacheLevelData complex type](#ct_olapslicercacheleveldata) 221 + +[CT_OlapSlicerCacheLevelsData complex type](#ct_olapslicercachelevelsdata) 222 + +[CT_OlapSlicerCacheRange complex type](#ct_olapslicercacherange) 220 + +[CT_OlapSlicerCacheRanges complex type](#ct_olapslicercacheranges) 221 + +[CT_OlapSlicerCacheSelection complex type](#ct_olapslicercacheselection) 224 + +[CT_OlapSlicerCacheSelections complex type](#ct_olapslicercacheselections) 223 + +[CT_OledbPr complex type](#ct_oledbpr) 254 + +[CT_OleItem complex type](#ct_oleitem) 192 + +[CT_PivotCacheDefinition complex type](#ct_pivotcachedefinition) 184 + +[CT_PivotCacheIdVersion complex type](#ct_pivotcacheidversion) 262 + +[CT_PivotChange complex type](#ct_pivotchange) 189 + +[CT_PivotChanges complex type](#ct_pivotchanges) 188 + +[CT_PivotEdit complex type](#ct_pivotedit) 188 + +[CT_PivotEdits complex type](#ct_pivotedits) 187 + +[CT_PivotEditValue complex type](#ct_pivoteditvalue) 190 + +[CT_PivotField complex type](#ct_pivotfield) 181 + +[CT_PivotFilter complex type](#ct_pivotfilter) 234 + +[CT_PivotHierarchy complex type](#ct_pivothierarchy) 194 + +[CT_PivotRow complex type](#ct_pivotrow) 259 + +[CT_PivotTableData complex type](#ct_pivottabledata) 258 + +CT_PivotTableDefinition complex type ([section 2.6.32](#ct_pivottabledefinition) 182, [section 2.6.156](#ct_pivottabledefinition16) 274) + +[CT_PivotTableReference complex type](#ct_pivottablereference) 227 + +[CT_PivotTableReferences complex type](#ct_pivottablereferences) 227 + +[CT_PivotTableServerFormats complex type](#ct_pivottableserverformats) 262 + +[CT_PivotTableUISettings complex type](#ct_pivottableuisettings) 235 + +[CT_PivotUserEdit complex type](#ct_pivotuseredit) 190 + +[CT_PivotValueCell complex type](#ct_pivotvaluecell) 260 + +[CT_PivotValueCellExtra complex type](#ct_pivotvaluecellextra) 261 + +[CT_ProtectedRange complex type](#ct_protectedrange) 202 + +[CT_ProtectedRanges complex type](#ct_protectedranges) 201 + +[CT_QueryTable complex type](#ct_querytable) 228 + +[CT_RangePr complex type](#ct_rangepr) 252 + +[CT_SetLevel complex type](#ct_setlevel) 166 + +[CT_SetLevels complex type](#ct_setlevels) 166 + +CT_Slicer complex type ([section 2.6.68](#ct_slicer) 213, [section 2.6.69](#ct_slicer-1) 215) + +[CT_SlicerCache complex type](#ct_slicercache) 161 + +[CT_SlicerCacheData complex type](#ct_slicercachedata) 217 + +[CT_SlicerCacheDefinition complex type](#ct_slicercachedefinition) 216 + +[CT_SlicerCacheHideNoData complex type](#ct_slicercachehidenodata) 239 + +[CT_SlicerCacheOlapLevelName complex type](#ct_slicercacheolaplevelname) 240 + +[CT_SlicerCachePivotTable complex type](#ct_slicercachepivottable) 218 + +[CT_SlicerCachePivotTables complex type](#ct_slicercachepivottables) 218 + +[CT_SlicerCaches complex type](#ct_slicercaches) 160 + +[CT_SlicerRef complex type](#ct_slicerref) 160 + +[CT_SlicerRefs complex type](#ct_slicerrefs) 159 + +[CT_Slicers complex type](#ct_slicers) 213 + +[CT_SlicerStyle complex type](#ct_slicerstyle) 191 + +[CT_SlicerStyleElement complex type](#ct_slicerstyleelement) 192 + +[CT_SlicerStyleElements complex type](#ct_slicerstyleelements) 198 + +[CT_SlicerStyles complex type](#ct_slicerstyles) 197 + +[CT_SortCondition complex type](#ct_sortcondition) 205 + +[CT_SourceConnection complex type](#ct_sourceconnection) 207 + +[CT_Sparkline complex type](#ct_sparkline) 158 + +[CT_SparklineGroup complex type](#ct_sparklinegroup) 154 + +[CT_SparklineGroups complex type](#ct_sparklinegroups) 153 + +[CT_Sparklines complex type](#ct_sparklines) 158 + +[CT_Table complex type](#ct_table) 186 + +[CT_TableSlicerCache complex type](#ct_tableslicercache) 236 + +[CT_TabularSlicerCache complex type](#ct_tabularslicercache) 224 + +[CT_TabularSlicerCacheItem complex type](#ct_tabularslicercacheitem) 226 + +[CT_TabularSlicerCacheItems complex type](#ct_tabularslicercacheitems) 226 + +[CT_Timeline complex type](#ct_timeline) 243 + +[CT_TimelineCacheDefinition complex type](#ct_timelinecachedefinition) 246 + +[CT_TimelineCachePivotTable complex type](#ct_timelinecachepivottable) 248 + +[CT_TimelineCachePivotTables complex type](#ct_timelinecachepivottables) 247 + +[CT_TimelineCacheRef complex type](#ct_timelinecacheref) 237 + +[CT_TimelineCacheRefs complex type](#ct_timelinecacherefs) 237 + +[CT_TimelinePivotCacheDefinition complex type](#ct_timelinepivotcachedefinition) 242 + +[CT_TimelinePivotFilter complex type](#ct_timelinepivotfilter) 250 + +[CT_TimelineRange complex type](#ct_timelinerange) 248 + +[CT_TimelineRef complex type](#ct_timelineref) 238 + +[CT_TimelineRefs complex type](#ct_timelinerefs) 238 + +[CT_Timelines complex type](#ct_timelines) 243 + +[CT_TimelineState complex type](#ct_timelinestate) 249 + +[CT_TimelineStyle complex type](#ct_timelinestyle) 241 + +[CT_TimelineStyleElement complex type](#ct_timelinestyleelement) 242 + +[CT_TimelineStyleElements complex type](#ct_timelinestyleelements) 241 + +[CT_TimelineStyles complex type](#ct_timelinestyles) 240 + +[CT_TupleItems complex type](#ct_tupleitems) 191 + +[CT_TupleSet complex type](#ct_tupleset) 163 + +[CT_TupleSetHeader complex type](#ct_tuplesetheader) 164 + +[CT_TupleSetHeaders complex type](#ct_tuplesetheaders) 163 + +[CT_TupleSetRow complex type](#ct_tuplesetrow) 165 + +[CT_TupleSetRowItem complex type](#ct_tuplesetrowitem) 165 + +[CT_TupleSetRows complex type](#ct_tuplesetrows) 164 + +[CT_WebExtension complex type](#ct_webextension) 229 + +[CT_WebExtensions complex type](#ct_webextensions) 229 + +CT_WorkbookPr complex type ([section 2.6.10](#ct_workbookpr) 159, [section 2.6.117](#ct_workbookpr-1) 250) + +Custom data + +[part enumerations](#custom-data) 28 + +Custom data properties + +[part enumerations](#custom-data-properties) 29 + +[customFilters element](#customfilters) 119 + +D + +Data model + +[part enumerations](#data-model) 30 + +[Data types and fields - common](#structures) 28 + +dataField element ([section 2.4.17](#datafield) 115, [section 2.4.68](#datafield-1) 130) + +[dataModel element](#datamodel) 128 + +[datastoreItem element](#datastoreitem) 121 + +[dataValidations element](#datavalidations) 112 + +Details + +[BrtBeginECTxtWiz record](#ct_connection-1) 230 + +[common data types and fields](#structures) 28 + +Drawing + +[extensions by part](#drawing) 72 + +dxfs element ([section 2.4.24](#dxfs) 117, [section 2.4.55](#dxfs-1) 126) + +[dyDescent attribute](#dydescent) 144 + +E + +[Examples](#structure-examples) 364 + +[Slicer](#slicer-1) 364 + +[slicer cache part](#slicer-cache-part) 365 + +[slicer part](#slicer-part) 366 + +Extensions + +[formulas](#formulas) 38 + +[cell formulas](#cell-formulas) 64 + +[conditional formatting formulas](#conditional-formatting-formulas) 64 + +[data validation formulas](#data-validation-formulas) 65 + +[external name formulas](#external-name-formulas) 65 + +[name formulas](#name-formulas) 65 + +[pivot field formulas](#pivot-field-formulas) 65 + +[pivot item formulas](#pivot-item-formulas) 66 + +[functions](#functions) 66 + +[SpreadsheetML extensibility elements](#spreadsheetml-extensibility-elements) 38 + +[structures](#extensions) 38 + +Extensions by part + +[connections](#connections) 72 + +[drawing](#drawing) 72 + +[external workbook references](#external-workbook-references) 73 + +[part enumerations](#extensions-by-part) 72 + +[pivot table](#pivot-table) 74 + +pivot table cache definition ([section 2.2.4.6](#pivot-table-cache-definition) 76, [section 2.2.4.7](#query-table) 77) + +[query table](#query-table) 77 + +[slicer cache](#slicercache) 77 + +[styles](#styles) 77 + +[table definition](#table-definition) 78 + +[workbook](#workbook) 79 + +[worksheet](#worksheet) 80 + +F + +[f element](#f) 111 + +[Fields - vendor-extensible](#vendor-extensible-fields) 26 + +[filter element](#filter) 119 + +[formatCode16 attribute](#formatcode16) 145 + +[formControlPr element](#formcontrolpr) 120 + +Formulas + +[extensions](#formulas) 38 + +[cell formulas](#cell-formulas) 64 + +[conditional formatting formulas](#conditional-formatting-formulas) 64 + +[data validation formulas](#data-validation-formulas) 65 + +[external name formulas](#external-name-formulas) 65 + +[name formulas](#name-formulas) 65 + +[pivot field formulas](#pivot-field-formulas) 65 + +[pivot item formulas](#pivot-item-formulas) 66 + +[Full XML schema](#appendix-a-full-xml-schema) 369 + +Functions + +[extensions](#functions) 66 + +G + +Global attributes + +[dyDescent](#dydescent) 144 + +[formatCode16](#formatcode16) 145 + +[knownFonts](#knownfonts) 146 + +Global elements + +[cachedUniqueNames](#cacheduniquenames) 128 + +[cacheField](#cachefield) 118 + +cacheHierarchy ([section 2.4.16](#cachehierarchy) 115, [section 2.4.52](#cachehierarchy-1) 126) + +calculatedMember ([section 2.4.15](#calculatedmember) 115, [section 2.4.44](#calculatedmember-1) 123) + +[conditionalFormattings](#conditionalformattings) 112 + +connection ([section 2.4.21](#connection) 116, [section 2.4.43](#connection-1) 123) + +[customFilters](#customfilters) 119 + +dataField ([section 2.4.17](#datafield) 115, [section 2.4.68](#datafield-1) 130) + +[dataModel](#datamodel) 128 + +[datastoreItem](#datastoreitem) 121 + +[dataValidations](#datavalidations) 112 + +dxfs ([section 2.4.24](#dxfs) 117, [section 2.4.55](#dxfs-1) 126) + +[f](#f) 111 + +[filter](#filter) 119 + +[formControlPr](#formcontrolpr) 120 + +[iconFilter](#iconfilter) 119 + +[id](#id) 119 + +[ignoredErrors](#ignorederrors) 113 + +[oleItem](#oleitem) 118 + +[pivotCacheDefinition](#pivotcachedefinition) 116 + +[pivotCacheIdVersion](#pivotcacheidversion) 129 + +pivotCaches ([section 2.4.12](#pivotcaches) 114, [section 2.4.39](#pivotcaches-1) 122) + +[pivotField](#pivotfield) 116 + +[pivotFilter](#pivotfilter) 124 + +[pivotHierarchy](#pivothierarchy) 118 + +[pivotTableData](#pivottabledata) 129 + +pivotTableDefinition ([section 2.4.19](#pivottabledefinition) 116, [section 2.4.73](#pivottabledefinition16) 132) + +pivotTableReferences ([section 2.4.1](#pivottablereference) 111, [section 2.4.40](#pivottablereferences) 122) + +[pivotTableServerFormats](#pivottableserverformats) 111 + +[pivotTableUISettings](#pivottableuisettings) 124 + +[protectedRanges](#protectedranges) 113 + +[queryTable](#querytable) 123 + +[ref](#ref) 111 + +slicer ([section 2.4.37](#slicer) 121, [section 2.4.65](#timeslicer) 129) + +[slicerCacheDefinition](#slicercachedefinition) 121 + +[slicerCacheHideItemsWithNoData](#slicercachehideitemswithnodata) 126 + +[slicerCachePivotTables](#slicercachepivottables) 128 + +slicerCaches ([section 2.4.13](#slicercaches) 114, [section 2.4.47](#slicercaches-1) 124) + +[slicerList](#slicerlist) 113 + +[slicers](#slicers-2) 121 + +[slicerStyles](#slicerstyles) 117 + +[sortCondition](#sortcondition) 120 + +[sortConnection](#sourceconnection) 120 + +[sparklineGroups](#sparklinegroups) 113 + +[sqref](#sqref) 112 + +[table](#table) 117 + +[tableSlicerCache](#tableslicercache) 124 + +[timelineCacheDefinition](#timelinecachedefinition) 127 + +[timelineCachePivotCaches](#timelinecachepivotcaches) 125 + +[timelineCacheRefs](#timelinecacherefs) 125 + +[timelinePivotCacheDefinition](#timelinepivotcachedefinition) 127 + +[timelineRefs](#timelinerefs) 125 + +[timelines](#timelines-2) 127 + +[timelineStyles](#timelinestyles) 126 + +[webExtensions](#webextensions) 123 + +workbookPr ([section 2.4.14](#workbookpr) 114, [section 2.4.59](#workbookpr-1) 128) + +[Glossary](#glossary) 17 + +I + +[iconFilter element](#iconfilter) 119 + +[id element](#id) 119 + +[ignoredErrors element](#ignorederrors) 113 + +[Implementer - security considerations](#security-considerations-for-implementers) 368 + +[Informative references](#informative-references) 25 + +[Introduction](#introduction) 17 + +K + +[knownFonts attribute](#knownfonts) 146 + +L + +[Localization](#versioning-and-localization) 26 + +N + +Non-worksheet pivot table + +[overview](#non-worksheet-pivottable) 87 + +[Normative references](#normative-references) 24 + +O + +[oleItem element](#oleitem) 118 + +[Overview (synopsis)](#structure-overview-synopsis) 25 + +P + +Part enumerations + +[control properties](#control-properties) 28 + +[custom data](#custom-data) 28 + +[custom data properties](#custom-data-properties) 29 + +[data model](#data-model) 30 + +[extensions by part](#extensions-by-part) 72 + +[slicer cache](#slicer-cache) 29 + +[slicers](#slicers) 29 + +[structures](#part-enumerations) 28 + +[timeline cache](#timeline-cache) 31 + +timelines ([section 2.1.8](#timelines) 32, [section 2.1.9](#survey) 32, [section 2.1.22](#feature-property-bag) 37) + +Pivot table + +[extensions by part](#pivot-table) 74 + +Pivot table cache definition + +extensions by part ([section 2.2.4.6](#pivot-table-cache-definition) 76, [section 2.2.4.7](#query-table) 77) + +[pivotCacheDefinition element](#pivotcachedefinition) 116 + +[pivotCacheIdVersion element](#pivotcacheidversion) 129 + +pivotCaches element ([section 2.4.12](#pivotcaches) 114, [section 2.4.39](#pivotcaches-1) 122) + +[pivotField element](#pivotfield) 116 + +[pivotFilter element](#pivotfilter) 124 + +[pivotHierarchy element](#pivothierarchy) 118 + +PivotTable what-if analysis + +[overview](#pivottable-what-if-analysis) 82 + +[pivotTableData element](#pivottabledata) 129 + +pivotTableDefinition element ([section 2.4.19](#pivottabledefinition) 116, [section 2.4.73](#pivottabledefinition16) 132) + +pivotTableReferences element ([section 2.4.1](#pivottablereference) 111, [section 2.4.40](#pivottablereferences) 122) + +[pivotTableServerFormats element](#pivottableserverformats) 111 + +[pivotTableUISettings element](#pivottableuisettings) 124 + +PivotValues + +[overview](#pivotvalues) 88 + +[Product behavior](#appendix-b-product-behavior) 418 + +[protectedRanges element](#protectedranges) 113 + +Q + +Query table + +[extensions by part](#query-table) 77 + +[queryTable element](#querytable) 123 + +R + +Records + +[BrtBeginECTxtWiz](#ct_connection-1) 230 + +[ref element](#ref) 111 + +[References](#references) 24 + +[informative](#informative-references) 25 + +[normative](#normative-references) 24 + +[Relationship to protocols and other structures](#relationship-to-protocols-and-other-structures) 26 + +S + +Security + +[implementer considerations](#security-considerations-for-implementers) 368 + +[index of security fields](#index-of-security-fields) 368 + +Simple types + +[ST_AllocationMethod](#st_allocationmethod) 345 + +[ST_CalcMemNumberFormat](#st_calcmemnumberformat) 353 + +[ST_CfvoType](#st_cfvotype) 341 + +[ST_Checked](#st_checked) 347 + +[ST_DataBarAxisPosition](#st_databaraxisposition) 341 + +[ST_DataBarDirection](#st_databardirection) 340 + +[ST_DispBlanksAs](#st_dispblanksas) 338 + +[ST_DropStyle](#st_dropstyle) 348 + +[ST_EditValidation](#st_editvalidation) 349 + +[ST_IconSetType](#st_iconsettype) 342 + +[ST_ObjectType](#st_objecttype) 346 + +[ST_OlapSlicerCacheSortOrder](#st_olapslicercachesortorder) 349 + +[ST_PivotEditValueType](#st_pivoteditvaluetype) 344 + +[ST_PivotShowAs](#st_pivotshowas) 340 + +[ST_Ref](#st_ref) 337 + +[ST_SelType](#st_seltype) 348 + +[ST_SlicerCacheCrossFilter](#st_slicercachecrossfilter) 350 + +[ST_SlicerStyleType](#st_slicerstyletype) 345 + +[ST_SparklineAxisMinMax](#st_sparklineaxisminmax) 338 + +[ST_SparklineType](#st_sparklinetype) 339 + +[ST_Sqref](#st_sqref) 337 + +[ST_SXVCellType](#st_sxvcelltype) 354 + +[ST_TabularSlicerCacheSortOrder](#st_tabularslicercachesortorder) 350 + +[ST_TextHAlign](#st_texthalign) 351 + +[ST_TextVAlign](#st_textvalign) 352 + +[ST_TimelineStyleType](#st_timelinestyletype) 352 + +Slicer cache + +[extensions by part](#slicercache) 77 + +[overview](#slicer-cache-1) 83 + +[part enumerations](#slicer-cache) 29 + +[Slicer cache part example](#slicer-cache-part) 365 + +slicer element ([section 2.4.37](#slicer) 121, [section 2.4.65](#timeslicer) 129) + +[Slicer example](#slicer-1) 364 + +[slicer cache part](#slicer-cache-part) 365 + +[slicer part](#slicer-part) 366 + +[Slicer part example](#slicer-part) 366 + +Slicer styles + +[overview](#slicer-styles) 87 + +Slicer view + +[overview](#slicer-view) 86 + +[slicerCacheDefinition element](#slicercachedefinition) 121 + +[slicerCacheHideItemsWithNoData element](#slicercachehideitemswithnodata) 126 + +[slicerCachePivotTables element](#slicercachepivottables) 128 + +slicerCaches element ([section 2.4.13](#slicercaches) 114, [section 2.4.47](#slicercaches-1) 124) + +[slicerList element](#slicerlist) 113 + +Slicers + +[overview](#slicers-1) 82 + +[part enumerations](#slicers) 29 + +[slicer cache](#slicer-cache-1) 83 + +[slicer styles](#slicer-styles) 87 + +[slicer view](#slicer-view) 86 + +[slicers and cube functions](#slicers-and-cube-functions) 87 + +Slicers and cube functions + +[overview](#slicers-and-cube-functions) 87 + +[slicers element](#slicers-2) 121 + +[slicerStyles element](#slicerstyles) 117 + +[sortCondition element](#sortcondition) 120 + +[sortConnection element](#sourceconnection) 120 + +[sparklineGroups element](#sparklinegroups) 113 + +SpreadsheetML extensibility elements + +[extensions](#spreadsheetml-extensibility-elements) 38 + +[sqref element](#sqref) 112 + +[ST_AllocationMethod simple type](#st_allocationmethod) 345 + +[ST_CalcMemNumberFormat simple type](#st_calcmemnumberformat) 353 + +[ST_CfvoType simple type](#st_cfvotype) 341 + +[ST_Checked simple type](#st_checked) 347 + +[ST_DataBarAxisPosition simple type](#st_databaraxisposition) 341 + +[ST_DataBarDirection simple type](#st_databardirection) 340 + +[ST_DispBlanksAs simple type](#st_dispblanksas) 338 + +[ST_DropStyle simple type](#st_dropstyle) 348 + +[ST_EditValidation simple type](#st_editvalidation) 349 + +[ST_IconSetType simple type](#st_iconsettype) 342 + +[ST_ObjectType simple type](#st_objecttype) 346 + +[ST_OlapSlicerCacheSortOrder simple type](#st_olapslicercachesortorder) 349 + +[ST_PivotEditValueType simple type](#st_pivoteditvaluetype) 344 + +[ST_PivotShowAs simple type](#st_pivotshowas) 340 + +[ST_Ref simple type](#st_ref) 337 + +[ST_SelType simple type](#st_seltype) 348 + +[ST_SlicerCacheCrossFilter simple type](#st_slicercachecrossfilter) 350 + +[ST_SlicerStyleType simple type](#st_slicerstyletype) 345 + +[ST_SparklineAxisMinMax simple type](#st_sparklineaxisminmax) 338 + +[ST_SparklineType simple type](#st_sparklinetype) 339 + +[ST_Sqref simple type](#st_sqref) 337 + +[ST_SXVCellType simple type](#st_sxvcelltype) 354 + +[ST_TabularSlicerCacheSortOrder simple type](#st_tabularslicercachesortorder) 350 + +[ST_TextHAlign simple type](#st_texthalign) 351 + +[ST_TextVAlign simple type](#st_textvalign) 352 + +[ST_TimelineStyleType simple type](#st_timelinestyletype) 352 + +Structures + +complex types + +[CT_CachedUniqueName](#ct_cacheduniquename) 255 + +[CT_CachedUniqueNames](#ct_cacheduniquenames) 255 + +[CT_CacheField](#ct_cachefield) 195 + +CT_CacheHierarchy ([section 2.6.24](#ct_cachehierarchy) 167, [section 2.6.102](#ct_cachehierarchy-1) 239) + +CT_CalculatedMember ([section 2.6.15](#ct_calculatedmember) 161, [section 2.6.93](#ct_calculatedmember-1) 232) + +[CT_CalculatedMemberExt](#ct_calculatedmemberext) 232 + +[CT_CfIcon](#ct_cficon) 187 + +[CT_CfRule](#ct_cfrule) 173 + +[CT_Cfvo](#ct_cfvo) 171 + +[CT_ColorScale](#ct_colorscale) 177 + +[CT_ConditionalFormat](#ct_conditionalformat) 196 + +[CT_ConditionalFormats](#ct_conditionalformats) 196 + +[CT_ConditionalFormatting](#ct_conditionalformatting) 149 + +[CT_ConditionalFormattings](#ct_conditionalformattings) 148 + +CT_Connection ([section 2.6.34](#ct_connection) 185, [section 2.6.91](#ct_connection-1) 230) + +[CT_CustomFilter](#ct_customfilter) 205 + +[CT_CustomFilters](#ct_customfilters) 204 + +[CT_DataBar](#ct_databar) 178 + +[CT_DataFeedPr](#ct_datafeedpr) 254 + +CT_DataField ([section 2.6.25](#ct_datafield) 170, [section 2.6.141](#ct_datafield-1) 264, [section 2.6.256](#ct_aggregationinfo) 330) + +[CT_DataModel](#ct_datamodel) 258 + +[CT_DatastoreItem](#ct_datastoreitem) 212 + +[CT_DataValidation](#ct_datavalidation) 151 + +[CT_DataValidationFormula](#ct_datavalidationformula) 150 + +[CT_DataValidations](#ct_datavalidations) 150 + +[CT_DbCommand](#ct_dbcommand) 253 + +[CT_DbTable](#ct_dbtable) 252 + +[CT_DbTables](#ct_dbtables) 253 + +[CT_FieldListActiveTabTopLevelEntity](#ct_fieldlistactivetabtoplevelentity) 233 + +[CT_Filter](#ct_filter) 204 + +[CT_FormControlPr](#ct_formcontrolpr) 208 + +[CT_IconFilter](#ct_iconfilter) 203 + +[CT_IconSet](#ct_iconset) 176 + +[CT_IgnoredError](#ct_ignorederror) 199 + +[CT_IgnoredErrors](#ct_ignorederrors) 198 + +[CT_ListItem](#ct_listitem) 207 + +[CT_ListItems](#ct_listitems) 208 + +[CT_ModelRelationship](#ct_modelrelationship) 257 + +[CT_ModelRelationships](#ct_modelrelationships) 257 + +[CT_ModelTable](#ct_modeltable) 256 + +[CT_ModelTables](#ct_modeltables) 256 + +[CT_ModelTextPr](#ct_modeltextpr) 251 + +[CT_OlapSlicerCache](#ct_olapslicercache) 222 + +[CT_OlapSlicerCacheItem](#ct_olapslicercacheitem) 219 + +[CT_OlapSlicercacheItemParent](#ct_olapslicercacheitemparent) 220 + +[CT_OlapslicerCacheLevelData](#ct_olapslicercacheleveldata) 221 + +[CT_OlapSlicerCacheLevelsData](#ct_olapslicercachelevelsdata) 222 + +[CT_OlapSlicerCacheRange](#ct_olapslicercacherange) 220 + +[CT_OlapSlicerCacheRanges](#ct_olapslicercacheranges) 221 + +[CT_OlapSlicerCacheSelection](#ct_olapslicercacheselection) 224 + +[CT_OlapSlicerCacheSelections](#ct_olapslicercacheselections) 223 + +[CT_OledbPr](#ct_oledbpr) 254 + +[CT_OleItem](#ct_oleitem) 192 + +[CT_PivotCacheDefinition](#ct_pivotcachedefinition) 184 + +[CT_PivotCacheIdVersion](#ct_pivotcacheidversion) 262 + +[CT_PivotChange](#ct_pivotchange) 189 + +[CT_PivotChanges](#ct_pivotchanges) 188 + +[CT_PivotEdit](#ct_pivotedit) 188 + +[CT_PivotEdits](#ct_pivotedits) 187 + +[CT_PivotEditValue](#ct_pivoteditvalue) 190 + +[CT_PivotField](#ct_pivotfield) 181 + +[CT_PivotFilter](#ct_pivotfilter) 234 + +[CT_PivotHierarchy](#ct_pivothierarchy) 194 + +[CT_PivotRow](#ct_pivotrow) 259 + +[CT_PivotTableData](#ct_pivottabledata) 258 + +CT_PivotTableDefinition ([section 2.6.32](#ct_pivottabledefinition) 182, [section 2.6.156](#ct_pivottabledefinition16) 274) + +[CT_PivotTableReference](#ct_pivottablereference) 227 + +[CT_PivotTableReferences](#ct_pivottablereferences) 227 + +[CT_PivotTableServerFormats](#ct_pivottableserverformats) 262 + +[CT_PivotTableUISettings](#ct_pivottableuisettings) 235 + +[CT_PivotUserEdit](#ct_pivotuseredit) 190 + +[CT_PivotValueCell](#ct_pivotvaluecell) 260 + +[CT_PivotValueCellExtra](#ct_pivotvaluecellextra) 261 + +[CT_ProtectedRange](#ct_protectedrange) 202 + +[CT_ProtectedRanges](#ct_protectedranges) 201 + +[CT_QueryTable](#ct_querytable) 228 + +[CT_RangePr](#ct_rangepr) 252 + +[CT_SetLevel](#ct_setlevel) 166 + +[CT_SetLevels](#ct_setlevels) 166 + +CT_Slicer ([section 2.6.68](#ct_slicer) 213, [section 2.6.69](#ct_slicer-1) 215) + +[CT_SlicerCache](#ct_slicercache) 161 + +[CT_SlicerCacheData](#ct_slicercachedata) 217 + +[CT_SlicerCacheDefinition](#ct_slicercachedefinition) 216 + +[CT_SlicerCacheHideNoData](#ct_slicercachehidenodata) 239 + +[CT_SlicerCacheOlapLevelName](#ct_slicercacheolaplevelname) 240 + +[CT_SlicerCachePivotTable](#ct_slicercachepivottable) 218 + +[CT_SlicerCachePivotTables](#ct_slicercachepivottables) 218 + +[CT_SlicerCaches](#ct_slicercaches) 160 + +[CT_SlicerRef](#ct_slicerref) 160 + +[CT_SlicerRefs](#ct_slicerrefs) 159 + +[CT_Slicers](#ct_slicers) 213 + +[CT_SlicerStyle](#ct_slicerstyle) 191 + +[CT_SlicerStyleElement](#ct_slicerstyleelement) 192 + +[CT_SlicerStyleElements](#ct_slicerstyleelements) 198 + +[CT_SlicerStyles](#ct_slicerstyles) 197 + +[CT_SortCondition](#ct_sortcondition) 205 + +[CT_SourceConnection](#ct_sourceconnection) 207 + +[CT_Sparkline](#ct_sparkline) 158 + +[CT_SparklineGroup](#ct_sparklinegroup) 154 + +[CT_SparklineGroups](#ct_sparklinegroups) 153 + +[CT_Sparklines](#ct_sparklines) 158 + +[CT_Table](#ct_table) 186 + +[CT_TableSlicerCache](#ct_tableslicercache) 236 + +[CT_TabularSlicerCache](#ct_tabularslicercache) 224 + +[CT_TabularSlicerCacheItem](#ct_tabularslicercacheitem) 226 + +[CT_TabularSlicerCacheItems](#ct_tabularslicercacheitems) 226 + +[CT_Timeline](#ct_timeline) 243 + +[CT_TimelineCacheDefinition](#ct_timelinecachedefinition) 246 + +[CT_TimelineCachePivotTable](#ct_timelinecachepivottable) 248 + +[CT_TimelineCachePivotTables](#ct_timelinecachepivottables) 247 + +[CT_TimelineCacheRef](#ct_timelinecacheref) 237 + +[CT_TimelineCacheRefs](#ct_timelinecacherefs) 237 + +[CT_TimelinePivotCacheDefinition](#ct_timelinepivotcachedefinition) 242 + +[CT_TimelinePivotFilter](#ct_timelinepivotfilter) 250 + +[CT_TimelineRange](#ct_timelinerange) 248 + +[CT_TimelineRef](#ct_timelineref) 238 + +[CT_TimelineRefs](#ct_timelinerefs) 238 + +[CT_Timelines](#ct_timelines) 243 + +[CT_TimelineState](#ct_timelinestate) 249 + +[CT_TimelineStyle](#ct_timelinestyle) 241 + +[CT_TimelineStyleElement](#ct_timelinestyleelement) 242 + +[CT_TimelineStyleElements](#ct_timelinestyleelements) 241 + +[CT_TimelineStyles](#ct_timelinestyles) 240 + +[CT_TupleItems](#ct_tupleitems) 191 + +[CT_TupleSet](#ct_tupleset) 163 + +[CT_TupleSetHeader](#ct_tuplesetheader) 164 + +[CT_TupleSetHeaders](#ct_tuplesetheaders) 163 + +[CT_TupleSetRow](#ct_tuplesetrow) 165 + +[CT_TupleSetRowItem](#ct_tuplesetrowitem) 165 + +[CT_TupleSetRows](#ct_tuplesetrows) 164 + +[CT_WebExtension](#ct_webextension) 229 + +[CT_WebExtensions](#ct_webextensions) 229 + +CT_WorkbookPr ([section 2.6.10](#ct_workbookpr) 159, [section 2.6.117](#ct_workbookpr-1) 250) + +[conceptual overview](#conceptual-overview) 82 + +[non-worksheet pivot table](#non-worksheet-pivottable) 87 + +[PivotTable what-if analysis](#pivottable-what-if-analysis) 82 + +[PivotValues](#pivotvalues) 88 + +[slicers](#slicers-1) 82 + +[slicer cache](#slicer-cache-1) 83 + +[slicer styles](#slicer-styles) 87 + +[slicer view](#slicer-view) 86 + +[slicers and cube functions](#slicers-and-cube-functions) 87 + +[timeline cache](#timeline-cache-1) 88 + +timeline + +[timeline styles](#timeline-styles) 90 + +[timeline view](#timeline-view) 89 + +[timelines](#timelines-1) 88 + +[timelines and cube functions](#timelines-and-cube-functions) 90 + +[extensions](#extensions) 38 + +global attributes + +[dyDescent](#dydescent) 144 + +[formatCode16](#formatcode16) 145 + +[knownFonts](#knownfonts) 146 + +global elements + +[cachedUniqueNames](#cacheduniquenames) 128 + +[cacheField](#cachefield) 118 + +cacheHierarchy ([section 2.4.16](#cachehierarchy) 115, [section 2.4.52](#cachehierarchy-1) 126) + +calculatedMember ([section 2.4.15](#calculatedmember) 115, [section 2.4.44](#calculatedmember-1) 123) + +[conditionalFormattings](#conditionalformattings) 112 + +connection ([section 2.4.21](#connection) 116, [section 2.4.43](#connection-1) 123) + +[customFilters](#customfilters) 119 + +dataField ([section 2.4.17](#datafield) 115, [section 2.4.68](#datafield-1) 130) + +[dataModel](#datamodel) 128 + +[datastoreItem](#datastoreitem) 121 + +[dataValidations](#datavalidations) 112 + +dxfs ([section 2.4.24](#dxfs) 117, [section 2.4.55](#dxfs-1) 126) + +[f](#f) 111 + +[filter](#filter) 119 + +[formControlPr](#formcontrolpr) 120 + +[iconFilter](#iconfilter) 119 + +[id](#id) 119 + +[ignorederrors](#ignorederrors) 113 + +[oleItem](#oleitem) 118 + +[pivotCacheDefinition](#pivotcachedefinition) 116 + +[pivotCacheIdVersion](#pivotcacheidversion) 129 + +pivotCaches ([section 2.4.12](#pivotcaches) 114, [section 2.4.39](#pivotcaches-1) 122) + +[pivotField](#pivotfield) 116 + +[pivotFilter](#pivotfilter) 124 + +[pivotHierarchy](#pivothierarchy) 118 + +[pivotTableData](#pivottabledata) 129 + +pivotTableDefinition ([section 2.4.19](#pivottabledefinition) 116, [section 2.4.73](#pivottabledefinition16) 132) + +[pivotTableReference](#pivottablereference) 111 + +[pivotTableReferences](#pivottablereferences) 122 + +[pivotTableServerFormats](#pivottableserverformats) 111 + +[pivotTableUISettings](#pivottableuisettings) 124 + +[protectedRanges](#protectedranges) 113 + +[queryTable](#querytable) 123 + +[ref](#ref) 111 + +slicer ([section 2.4.37](#slicer) 121, [section 2.4.65](#timeslicer) 129) + +[slicerCacheDefinition](#slicercachedefinition) 121 + +[slicerCacheHideItemsWithNoData](#slicercachehideitemswithnodata) 126 + +[slicerCachePivotTables](#slicercachepivottables) 128 + +slicerCaches ([section 2.4.13](#slicercaches) 114, [section 2.4.47](#slicercaches-1) 124) + +[slicerList](#slicerlist) 113 + +[slicers](#slicers-2) 121 + +[slicerStyles](#slicerstyles) 117 + +[sortCondition](#sortcondition) 120 + +[sortConnection](#sourceconnection) 120 + +[sparklineGroups](#sparklinegroups) 113 + +[sqref](#sqref) 112 + +[table](#table) 117 + +[tableSlicerCache](#tableslicercache) 124 + +[timelineCacheDefinition](#timelinecachedefinition) 127 + +[timelineCachePivotCaches](#timelinecachepivotcaches) 125 + +[timelineCacheRefs](#timelinecacherefs) 125 + +[timelinePivotCacheDefinition](#timelinepivotcachedefinition) 127 + +[timelineRefs](#timelinerefs) 125 + +[timelines](#timelines-2) 127 + +[timelineStyles](#timelinestyles) 126 + +[webExtensions](#webextensions) 123 + +workbookPr ([section 2.4.14](#workbookpr) 114, [section 2.4.59](#workbookpr-1) 128) + +[overview](#structures) 28 + +[part enumerations](#part-enumerations) 28 + +simple types + +[ST_AllocationMethod](#st_allocationmethod) 345 + +[ST_CfvoType](#st_cfvotype) 341 + +[ST_Checked](#st_checked) 347 + +[ST_DataBarAxisPosition](#st_databaraxisposition) 341 + +[ST_DataBarDirection](#st_databardirection) 340 + +[ST_DispBlanksAs](#st_dispblanksas) 338 + +[ST_DropStyle](#st_dropstyle) 348 + +[ST_EditValidation](#st_editvalidation) 349 + +[ST_IconSetType](#st_iconsettype) 342 + +[ST_ObjectType](#st_objecttype) 346 + +[ST_OlapSlicerCacheSortOrder](#st_olapslicercachesortorder) 349 + +[ST_PivotEditValueType](#st_pivoteditvaluetype) 344 + +[ST_PivotShowAs](#st_pivotshowas) 340 + +[ST_Ref](#st_ref) 337 + +[ST_SelType](#st_seltype) 348 + +[ST_SlicerCacheCrossFilter](#st_slicercachecrossfilter) 350 + +[ST_SlicerStyleType](#st_slicerstyletype) 345 + +[ST_SparklineAxisMinMax](#st_sparklineaxisminmax) 338 + +[ST_SparklineType](#st_sparklinetype) 339 + +[ST_Sqref](#st_sqref) 337 + +[ST_SXVCellType](#st_sxvcelltype) 354 + +[ST_TabularSlicerCacheSortOrder](#st_tabularslicercachesortorder) 350 + +Structures – simple types + +[ST_CalcMemNumberFormat](#st_calcmemnumberformat) 353 + +[ST_TextHAlign](#st_texthalign) 351 + +[ST_TextVAlign](#st_textvalign) 352 + +[ST_TimelineStyleType](#st_timelinestyletype) 352 + +Structures/ + +/complex types / + +/CT_AbsolutePath + +Complex types/ + +[/CT_AbsolutePath](#ct_absolutepath) 263 + +/complex types/ + +/CT\_ CacheSourceExt + +Complex types/ + +[/CT\_ CacheSourceExt](#ct_cachesourceext) 270 + +/CT_ApplicationNonVisualDrawingProps + +Complex types/ + +[/CT_ApplicationNonVisualDrawingProps](#ct_applicationnonvisualdrawingprops) 269 + +/CT_CalculatedTimeColumn + +Complex types/ + +[/CT_CalculatedTimeColumn](#ct_calculatedtimecolumn) 271 + +/CT_ContentPart + +Complex types/ + +[/CT_ContentPart](#ct_contentpart) 270 + +/CT_ContentPartNonVisual + +Complex types/ + +[/CT_ContentPartNonVisual](#ct_contentpartnonvisual) 271 + +/CT_ModelTimeGrouping + +Complex types/ + +[/CT_ModelTimeGrouping](#ct_modeltimegrouping) 272 + +/CT_ModelTimeGroupings + +Complex types/ + +[/CT_ModelTimeGroupings](#ct_modeltimegroupings) 273 + +/CT_Ref + +Complex types/ + +[/CT_Ref](#ct_ref) 268 + +/CT_Sqref + +Complex types/ + +[/CT_Sqref](#ct_sqref) 268 + +/CT_Survey + +Complex types/ + +[/CT_Survey](#ct_survey) 264 + +/CT_SurveyElementPr + +Complex types/ + +[/CT_SurveyElementPr](#ct_surveyelementpr) 267 + +/CT_SurveyQuestion + +Complex types/ + +[/CT_SurveyQuestion](#ct_surveyquestion) 265 + +/CT_SurveyQuestions + +Complex types/ + +[/CT_SurveyQuestions](#ct_surveyquestions) 265 + +/CT_Timeline + +Complex types/ + +[/CT_Timeline](#ct_timeline-1) 263 + +/global elements/ + +/absPath + +Global elements/ + +[/absPath](#abspath) 130 + +/contentPart + +Global elements/ + +[/contentPart](#contentpart) 131 + +/list + +Global elements/ + +[/list](#list) 130 + +/modelTimeGroupings + +Global elements/ + +[/modelTimeGroupings](#modeltimegroupings) 131 + +/survey + +Global elements/ + +[/survey](#survey-1) 130 + +/simple types/ + +/ST_ModelTimeGroupingContentType + +Simple types/ + +[/ST_ModelTimeGroupingContentType](#st_modeltimegroupingcontenttype) 357 + +/ST_QuestionFormat + +Simple types/ + +[/ST_QuestionFormat](#st_questionformat) 355 + +/ST_QuestionType + +Simple types/ + +[/ST_QuestionType" \t "](#st_questiontype) 355 + +/ST_SurveyPosition + +Simple types/ + +[/ST_SurveyPosition](#st_surveyposition) 356 + +Styles + +[extensions by part](#styles) 77 + +T + +Table definition + +[extensions by part](#table-definition) 78 + +[table element](#table) 117 + +[tableSlicerCache element](#tableslicercache) 124 + +Timeline cache + +[overview](#timeline-cache-1) 88 + +[part enumerations](#timeline-cache) 31 + +Timeline styles + +[overview](#timeline-styles) 90 + +Timeline view + +[overview](#timeline-view) 89 + +[timelineCacheDefinition element](#timelinecachedefinition) 127 + +[timelineCachePivotCaches element](#timelinecachepivotcaches) 125 + +[timelineCacheRefs element](#timelinecacherefs) 125 + +[timelinePivotCacheDefinition element](#timelinepivotcachedefinition) 127 + +[timelineRefs element](#timelinerefs) 125 + +Timelines + +[overview](#timelines-1) 88 + +part enumerations ([section 2.1.8](#timelines) 32, [section 2.1.9](#survey) 32, [section 2.1.22](#feature-property-bag) 37) + +[timeline cache](#timeline-cache-1) 88 + +[timeline styles](#timeline-styles) 90 + +[timeline view](#timeline-view) 89 + +[timelines and cube functions](#timelines-and-cube-functions) 90 + +Timelines and cube functions + +[overview](#timelines-and-cube-functions) 90 + +[timelines element](#timelines-2) 127 + +[timelineStyles element](#timelinestyles) 126 + +[Tracking changes](#change-tracking) 428 + +V + +[Vendor-extensible fields](#vendor-extensible-fields) 26 + +[Versioning](#versioning-and-localization) 26 + +W + +[webExtensions element](#webextensions) 123 + +Workbook + +[extensions by part](#workbook) 79 + +workbookPr element ([section 2.4.14](#workbookpr) 114, [section 2.4.59](#workbookpr-1) 128) + +Worksheet + +[extensions by part](#worksheet) 80 + +X + +[XML schema](#appendix-a-full-xml-schema) 369