Expand description
Sheet features beyond cells: tables, conditional formatting, data validation, comments, hyperlinks, charts, images, autofilter, print settings.
Structs§
- Anchor
- Position of a floating object: top-left cell plus offset, size in points.
- Auto
Filter - Chart
- Chart
Data Table - A chart’s data table (
c:dTable), independent of the chart legend. - Comment
- A note (classic comment) or a threaded comment.
- Cond
Format - Edit
Range - Review › Allow Edit Ranges: cells that stay editable on a protected sheet, with or without a
password (XLSX
<protectedRange>). - Equation
Cache - The laid-out form of an equation’s LaTeX source. It is derived data: rebuilt by
EquationCache::refreshwhenever the source changes, never saved, and ignored when shapes are compared. Painters read it and never lay equations out themselves, so nothing in a paint path can reach the layout engine. - Form
Control - A form control (button, slider, spin button) floating over the sheet.
- Hyperlink
- Image
- Line
Info - Outline grouping info for a row or column.
- NoteBox
- A note box’s place and size, from the note’s VML shape: Excel’s
<x:Anchor>with its corners stored relative to the note’s cell, so the box moves with the note when rows or columns are inserted or deleted, and the shape’s width and height. - Note
Corner - One corner of a
NoteBox. - ObjRef
- One floating object on a sheet: its kind and its workbook-unique id.
- Pivot
Calc Field - A calculated field: a formula over other fields (
=Sales*0.1,='Unit Price'*Units). As in Excel, it is evaluated on the sums of the fields it names for each report cell, not per record. - Pivot
Field - A field placed in the Rows or Columns area.
- Pivot
Filter - A report filter (or, for a field also in Rows/Columns, its hidden-items filter).
- Pivot
Table - A PivotTable: its definition plus where its output was last written. The output itself is static cell values and styles on the sheet, rewritten on every refresh.
- Pivot
Value - A field in the Values area.
- Print
Settings - Series
- Shape
- Shape
Format - How a shape’s outline and text look. The text properties apply to the whole text (the first paragraph’s and first run’s properties when a file has several).
- Sheet
Protection - Slicer
- A slicer: an on-sheet filter widget bound to one column of a table. Clicking its value tiles
sets that column’s
FilterCriterion::Valuesin the sheet’sAutoFilterand re-applies it, so a slicer is just a visual front-end over the existing filter machinery. - Sparkline
- Table
- Table
Column - Trendline
- A chart trendline (Add Chart Element ▸ Trendline, Format Trendline pane).
- Validation
- XmlColumn
Pr - A table column’s binding to an XML map (
<xmlColumnPr>).
Enums§
- Anchor
Mode - How a floating object is pinned to the grid when its cells move or resize. Mirrors Excel’s
Format ▸ Size and Properties ▸ Properties, stored in the file as the anchor’s
editAs:twoCell(absenteditAs),oneCellandabsolute. - CfOperator
- CfRule
- CfValue
Kind - Chart
Kind - Control
Action - What a button runs when it is pressed.
- Control
Kind - What a form control on the sheet is.
- Error
Style - Filter
Criterion - HfPage
- Which header/footer pair a printed page uses.
- Legend
Pos - Line
Dash - DrawingML preset line dash (
a:prstDash). - Macro
Input - The range a button’s macro runs on.
- ObjKind
- The kinds of floating object a sheet holds. Commands name an object by kind and
workbook-unique id (
{kind: "chart", id});ObjKind::nameis that parameter’s spelling. Equations are stored as shapes (ShapeKind::Equation) but select, open and delete as their own kind. - Orientation
- Page
Order - The sequence of a sheet’s pages (XLSX
pageSetup pageOrder, ECMA-376ST_PageOrder). - Pivot
Date Group - Grouping of a date field (values are date serials).
- Pivot
Func - Summarize-values-by function.
- Pivot
Layout - How a PivotTable lays out its row fields.
- Pivot
Show As - Show-values-as transform.
- Pivot
Sort - Quartile
Method - Quartile calculation for a box & whisker series.
- Shape
Kind - Shape
Text Align - Horizontal alignment of a shape’s text (
a:pPr algn). - Shape
Text Anchor - Vertical anchor of a shape’s text in its box (
a:bodyPr anchor). - Sparkline
Kind - Totals
Fn - Trendline
Kind - Regression a trendline fits (
c:trendlineType). - Validation
Kind
Constants§
- CONTROL_
MAX - The largest value a slider or spin button takes (Excel’s scroll bar limit). Values are whole numbers from 0 to this.
Functions§
- default_
icon_ thresholds - Excel’s default icon-set thresholds: one per icon, the first being the lower bound,
then even percent steps (
0, 33, 67for three icons). - icon_
count - Number of icons in an icon set (
3Arrows→ 3,5Quarters→ 5), always 3 to 5. - password_
hash - The non-cryptographic password hash older GridCraft versions stored for sheet protection
(only verified now, see
SheetProtection::legacy_password_hash).