A shape's style reads resolved: what the shape states itself, over what its theme style gives
it (the references into the theme's format scheme that a file's style element names), over
SheetXL's defaults for a shape that states neither. A member of a group that takes its group's
fill reads the nearest enclosing group's.
Writes state values on the shape: setFill('red') makes the fill the shape's own, and
setFill(null) hands it back to the theme style. toJSON answers only what the shape
states, never the resolved values; isThemed says whether it states anything at all.
A partial fill update merges into the resolved fill, so a color on a themed shape gives a solid
fill of that color; setFillNone() states that the shape has no fill, which is not the same as
leaving it to the theme style.
Every write is one undoable step, transactional like the rest of the shape.
What a shape draws with: its fill and its line.
Remarks
A shape's style reads resolved: what the shape states itself, over what its theme style gives it (the references into the theme's format scheme that a file's
styleelement names), over SheetXL's defaults for a shape that states neither. A member of a group that takes its group's fill reads the nearest enclosing group's.Writes state values on the shape:
setFill('red')makes the fill the shape's own, andsetFill(null)hands it back to the theme style. toJSON answers only what the shape states, never the resolved values; isThemed says whether it states anything at all. A partial fill update merges into the resolved fill, so a color on a themed shape gives a solid fill of that color;setFillNone()states that the shape has no fill, which is not the same as leaving it to the theme style.Every write is one undoable step, transactional like the rest of the shape.
See
Interface
IShapeStyle