[Table of Contents] [docx version]
Error! No text of specified style in document.
This element defines the properties of a table on the whole. Within this element are many visual modifications that can be applied to the table.
[Example: Consider the following example of a tblPr within DrawingML:
<a:tblPr firstRow="1" bandRow="1">
<a:tableStyleId>{5940675A-B579-460E-94D1-54222C63F5DA}</a:tableStyleId>
</a:tblPr>
In this example, we see that there is a link to a table style id (§5.1.6.10) which is defined elsewhere and that the first column formatting and banded row formatting has been enabled. The table style defines the formatting applied with the two formatting options enabled. end example]
Parent Elements |
tbl (§5.1.6.11) |
Child Elements |
Subclause |
blipFill (Picture Fill) |
§5.1.10.14 |
effectDag (Effect Container) |
§5.1.10.25 |
effectLst (Effect Container) |
§5.1.10.26 |
extLst (Extension List) |
§5.1.2.1.15 |
gradFill (Gradient Fill) |
§5.1.10.33 |
grpFill (Group Fill) |
§5.1.10.35 |
noFill (No Fill) |
§5.1.10.44 |
pattFill (Pattern Fill) |
§5.1.10.47 |
solidFill (Solid Fill) |
§5.1.10.54 |
tableStyle (Table Style) |
§5.1.6.9 |
tableStyleId (Table Style ID) |
§5.1.6.10 |
Attributes |
Description |
bandCol (Banded Columns) |
Enables or disables the banded column formatting for a table style. A value of on, 1 or true will enable the banded column formatting defined in the table style. The attribute will default to off if it is not specified.
[Example: Consider the following run:
<a:tblPr bandCol="1">
In this example, we can see the banded column formatting is enabled for the table. When applied, the linked table style defines the formatting for banded columns. end example]
The possible values for this attribute are defined by the XML Schema boolean datatype. |
bandRow (Banded Rows) |
Enables or disables the banded row formatting for a table style. A value of on, 1 or true will enable the banded row formatting defined in the table style. The attribute will default to off if it is not specified.
[Example: Consider the following run:
<a:tblPr bandRow="1">
In this example, we can see the banded row formatting is enabled for the table. When applied, the linked table style defines the formatting for banded rows. end example]
The possible values for this attribute are defined by the XML Schema boolean datatype. |
firstCol (First Column) |
Enables or disables the first column formatting for a table style. A value of on, 1 or true will enable the first column formatting defined in the table style. The attribute will default to off if it is not specified.
[Example: Consider the following run:
<a:tblPr firstCol="1">
In this example, we can see the first column formatting is enabled for the table. When applied, the linked table style defines the formatting for the first column. end example]
The possible values for this attribute are defined by the XML Schema boolean datatype. |
firstRow (First Row) |
Enables or disables the first row formatting for a table style. A value of on, 1 or true will enable the first row formatting defined in the table style. The attribute will default to off if it is not specified.
[Example: Consider the following run:
<a:tblPr firstRow="1">
In this example, we can see the first row formatting is enabled for the table. When applied, the linked table style defines the formatting for the first row. end example]
The possible values for this attribute are defined by the XML Schema boolean datatype. |
lastCol (Last Column) |
Enables or disables the last column formatting for a table style. A value of on, 1 or true will enable the last column formatting defined in the table style. The attribute will default to off if it is not specified.
[Example: Consider the following run:
<a:tblPr lastCol="1">
In this example, we can see the last column formatting is enabled for the table. When applied, the linked table style defines the formatting for the last column. end example]
The possible values for this attribute are defined by the XML Schema boolean datatype. |
lastRow (Last Row) |
Enables or disables the last row formatting for a table style. A value of on, 1 or true will enable the last row formatting defined in the table style. The attribute will default to off if it is not specified.
[Example: Consider the following run:
<a:tblPr lastRow="1">
In this example, we can see the last row formatting is enabled for the table. When applied, the linked table style defines the formatting for the last row. end example]
The possible values for this attribute are defined by the XML Schema boolean datatype. |
rtl (Right-to-Left) |
Defines enables the right-to-left settings of a table. If the value of rtl is on, 1 or true, then the table will be laid out from the right-to-left rather than the default left-to-right.
[Example: Consider the following run:
<a:tblPr rtl="1">
In this example, we can see that the table is to be created in a right-to-left direction. end example]
The possible values for this attribute are defined by the XML Schema boolean datatype. |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TableProperties">
<sequence>
<group ref="EG_FillProperties" minOccurs="0" maxOccurs="1"/>
<group ref="EG_EffectProperties" minOccurs="0" maxOccurs="1"/>
<choice minOccurs="0" maxOccurs="1">
<element name="tableStyle" type="CT_TableStyle"/>
<element name="tableStyleId" type="ST_Guid"/>
</choice>
<element name="extLst" type="CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
</sequence>
<attribute name="rtl" type="xsd:boolean" use="optional" default="false"/>
<attribute name="firstRow" type="xsd:boolean" use="optional" default="false"/>
<attribute name="firstCol" type="xsd:boolean" use="optional" default="false"/>
<attribute name="lastRow" type="xsd:boolean" use="optional" default="false"/>
<attribute name="lastCol" type="xsd:boolean" use="optional" default="false"/>
<attribute name="bandRow" type="xsd:boolean" use="optional" default="false"/>
<attribute name="bandCol" type="xsd:boolean" use="optional" default="false"/>
</complexType>