[Table of Contents] [docx version]

Error! No text of specified style in document.

tcPr (Table Cell Properties)

This element defines the formatting properties associated with a cell. The formatting options which are available to be adjusted range from the line types used for the borders to the cell fill to the margins associated with the layout of the text in the cell.

[Example: Consider the following example of a tcPr within DrawingML:

<a:tcPr marL="45720" marR="45720">
<a:lnL w="38100" cap="flat" cmpd="sng" algn="ctr">
<a:solidFill>
<a:schemeClr val="accent2"/>
</a:solidFill>
<a:prstDash val="solid"/>
<a:round/>
<a:headEnd type="none" w="med" len="med"/>
<a:tailEnd type="none" w="med" len="med"/>
</a:lnL>
</a:tcPr>

In this example, we have a solid line defined as the left border of the cell along with left and right margin adjustments being made from the default margins. end example]

Parent Elements

tc5.1.6.14)

 

Child Elements

Subclause

blipFill (Picture Fill)

§5.1.10.14

cell3D (Cell 3-D)

§5.1.6.1

extLst (Extension List)

§5.1.2.1.15

gradFill (Gradient Fill)

§5.1.10.33

grpFill (Group Fill)

§5.1.10.35

lnB (Bottom Border Line Properties)

§5.1.6.3

lnBlToTr (Bottom-Left to Top-Right Border Line Properties)

§5.1.6.4

lnL (Left Border Line Properties)

§5.1.6.5

lnR (Right Border Line Properties)

§5.1.6.6

lnT (Top Border Line Properties)

§5.1.6.7

lnTlToBr (Top-Left to Bottom-Right Border Line Properties)

§5.1.6.8

noFill (No Fill)

§5.1.10.44

pattFill (Pattern Fill)

§5.1.10.47

solidFill (Solid Fill)

§5.1.10.54

 

Attributes

Description

anchor (Anchor)

Defines the alignment of the text vertically within the cell.

 

[Example: Consider the following example:

 

<a:tcPr marL="45720" anchor="ctr"/>

 

In this example, the text in the cell will be anchored to the center of the cell vertically. end example]

 

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

anchorCtr (Anchor Center)

When this attribute is on, 1 or true, it modifies the anchor attribute. This attribute will center align the text box itself which will allow for text to be left aligned along the center of the cell for example.

 

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

horzOverflow (Horizontal Overflow)

Specifies the clipping behavior of the cell. The two options here allow for the text to be clipped and out of view when outside of the bounds of the cell, or for the text to remain visible and overflow outside of the cell.

 

[Example: Consider the following example:

 

<a:tcPr horzOverflow="overflow">

</a:tcPr>

 

In this example, the text in the cell will freely overflow outside of the cell boundaries and will always remain visible. end example]

 

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

marB (Bottom Margin)

Specifies the bottom margin of the cell. The value specified in this attribute is the distance to offset from the bottom of the cell.

 

[Example: Consider the following example:

 

<a:tcPr marB="45720" anchor="ctr">

</a:tcPr>

 

In this example, we have specified a value for the margin on the bottom of the cell. end example]

 

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

marL (Left Margin)

This attribute specifies the left margin of the cell. The value specified in this attribute is the distance to offset from the left of the cell in EMU's.

 

[Example: Consider the following example:

 

<a:tcPr marL="45720" anchor="ctr">

</a:tcPr>

 

In this example, we have specified a value for the margin on the left of the cell. end example]

 

 

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

marR (Right Margin)

This attribute specifies the right margin of the cell. The value specified in this attribute is the distance to offset from the right of the cell in EMU's.

 

[Example: Consider the following example:

 

<a:tcPr marR="45720" anchor="ctr">

</a:tcPr>

 

In this example, we have specified a value for the margin on the right of the cell. end example]

 

 

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

marT (Top Margin)

This attribute specifies the top margin of the cell. The value specified in this attribute is the distance to offset from the top of the cell in EMU's.

 

[Example: Consider the following example:

 

<a:tcPr marT="45720" anchor="ctr">

</a:tcPr>

 

In this example, we have specified a value for the margin on the top of the cell. end example]

 

 

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

vert (Text Direction)

Defines the text direction within the cell.

 

[Example: Consider the following example:

<a:tcPr vert="vert270">

</a:tcPr>

 

In this example, we have rotated the layout of the text 270 degrees so that it starts at the bottom of the cell and goes upward toward the top of the cell. end example]

 

 

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

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

<complexType name="CT_TableCellProperties">

   <sequence>

   <element name="lnL" type="CT_LineProperties" minOccurs="0" maxOccurs="1"/>

   <element name="lnR" type="CT_LineProperties" minOccurs="0" maxOccurs="1"/>

   <element name="lnT" type="CT_LineProperties" minOccurs="0" maxOccurs="1"/>

   <element name="lnB" type="CT_LineProperties" minOccurs="0" maxOccurs="1"/>

   <element name="lnTlToBr" type="CT_LineProperties" minOccurs="0" maxOccurs="1"/>

   <element name="lnBlToTr" type="CT_LineProperties" minOccurs="0" maxOccurs="1"/>

   <element name="cell3D" type="CT_Cell3D" minOccurs="0" maxOccurs="1"/>

   <group ref="EG_FillProperties" minOccurs="0" maxOccurs="1"/>

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

   </sequence>

   <attribute name="marL" type="ST_Coordinate32" use="optional" default="91440"/>

   <attribute name="marR" type="ST_Coordinate32" use="optional" default="91440"/>

   <attribute name="marT" type="ST_Coordinate32" use="optional" default="45720"/>

   <attribute name="marB" type="ST_Coordinate32" use="optional" default="45720"/>

   <attribute name="vert" type="ST_TextVerticalType" use="optional" default="horz"/>

   <attribute name="anchor" type="ST_TextAnchoringType" use="optional" default="t"/>

   <attribute name="anchorCtr" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="horzOverflow" type="ST_TextHorzOverflowType" use="optional" default="clip"/>

</complexType>