[Table of Contents] [docx version]

Error! No text of specified style in document.

tableStyle (Table Style)

This element specifies a particular table style. Fourteen elements make up the styling information of a given table style. These fourteen elements work together to provide visual formatting options for on/off states of the following toggles:

First row on/off - Associated element: firstRow

Last row on/off - Associated element: lastRow

First column on/off - Associated element: firstCol

Last column on/off - Associated element: lastCol

Row banding on/off - Associated elements: band1H, band2H

Column banding on/off - Associated elements: band1V, band2V

The formatting associated with the wholeTbl element defines the table formatting when all options are off. When an option is turned on, the formatting for that particular option is applied to the table. The four cell specific formatting options are enabled when overlapping options are toggled on. For example, when the first row, and first column formatting options are enabled, any formatting within the northwest cell will also be applied since that is the overlapping table cell when both first column and first row formatting options are on.

[Example: Consider the following partial example of a tblStyle within DrawingML:

<a:tblStyle styleId="{5940675A-B579-460E-94D1-54222C63F5DA}"
styleName="No Style, Table Grid">
<a:wholeTbl>
<a:tcTxStyle>
<a:fontRef idx="minor">
<a:scrgbClr r="0" g="0" b="0"/>
</a:fontRef>

<a:schemeClr val="tx1"/>
</a:tcTxStyle>
<a:tcStyle>
<a:tcBdr>
<a:left>
<a:ln w="12700" cmpd="sng">
<a:solidFill>
<a:schemeClr val="tx1"/>
</a:solidFill>
</a:ln>
</a:left>

…right, top, bottom, insideH, insideV border information is defined just as the 'left' tag…

</a:tcBdr>
<a:fill>
<a:noFill/>
</a:fill>
</a:tcStyle>
</a:wholeTbl>

<a:band1H>
<a:tcStyle>
<a:tcBdr/>
</a:tcStyle>
</a:band1H>

…band2H, band1V, band2V, firstCol, firstRow, lastCol, lastRow, neCell, nwCell, seCell, swCell tags are all defined just as the 'band1H' tag

</a:tblStyle>

In this example, one can get an idea for the definition of a table style in its entirety. The above defined table style will create a style with only 1pt line formatting applied to all of the cells in a table. Notice that the on/off toggle formatting (band1H, band2H, firstCol, etc) do not define any formatting and therefore have no effect to the table when toggled. end example]

Parent Elements

tblPr5.1.6.13)

 

Child Elements

Subclause

band1H (Band 1 Horizontal)

§5.1.4.2.1

band1V (Band 1 Vertical)

§5.1.4.2.2

band2H (Band 2 Horizontal)

§5.1.4.2.3

band2V (Band 2 Vertical)

§5.1.4.2.4

extLst (Extension List)

§5.1.2.1.15

firstCol (First Column)

§5.1.4.2.11

firstRow (First Row)

§5.1.4.2.12

lastCol (Last Column)

§5.1.4.2.16

lastRow (Last Row)

§5.1.4.2.17

neCell (Northeast Cell)

§5.1.4.2.20

nwCell (Northwest Cell)

§5.1.4.2.21

seCell (Southeast Cell)

§5.1.4.2.23

swCell (Southwest Cell)

§5.1.4.2.24

tblBg (Table Background)

§5.1.4.2.25

wholeTbl (Whole Table)

§5.1.4.2.34

 

Attributes

Description

styleId (Style ID)

Specifies a GUID identifying the table style in a unique manner.

 

The possible values for this attribute are defined by the ST_Guid simple type (§5.1.12.27).

styleName (Name)

Specifies the name of the table style which can show up in the user interface identifying the style to a user.

 

The possible values for this attribute are defined by the XML Schema string datatype.

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_TableStyle">

   <sequence>

   <element name="tblBg" type="CT_TableBackgroundStyle" minOccurs="0" maxOccurs="1"/>

   <element name="wholeTbl" type="CT_TablePartStyle" minOccurs="0" maxOccurs="1"/>

   <element name="band1H" type="CT_TablePartStyle" minOccurs="0" maxOccurs="1"/>

   <element name="band2H" type="CT_TablePartStyle" minOccurs="0" maxOccurs="1"/>

   <element name="band1V" type="CT_TablePartStyle" minOccurs="0" maxOccurs="1"/>

   <element name="band2V" type="CT_TablePartStyle" minOccurs="0" maxOccurs="1"/>

   <element name="lastCol" type="CT_TablePartStyle" minOccurs="0" maxOccurs="1"/>

   <element name="firstCol" type="CT_TablePartStyle" minOccurs="0" maxOccurs="1"/>

   <element name="lastRow" type="CT_TablePartStyle" minOccurs="0" maxOccurs="1"/>

   <element name="seCell" type="CT_TablePartStyle" minOccurs="0" maxOccurs="1"/>

   <element name="swCell" type="CT_TablePartStyle" minOccurs="0" maxOccurs="1"/>

   <element name="firstRow" type="CT_TablePartStyle" minOccurs="0" maxOccurs="1"/>

   <element name="neCell" type="CT_TablePartStyle" minOccurs="0" maxOccurs="1"/>

   <element name="nwCell" type="CT_TablePartStyle" minOccurs="0" maxOccurs="1"/>

   <element name="extLst" type="CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>

   </sequence>

   <attribute name="styleId" type="ST_Guid" use="required"/>

   <attribute name="styleName" type="xsd:string" use="required"/>

</complexType>