Partager via


TableCellMarginDefault Class

Defines the TableCellMarginDefault Class.When the object is serialized out as xml, its qualified name is w:tblCellMar.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Wordprocessing.TableCellMarginDefault

Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(TopMargin))> _
<ChildElementInfoAttribute(GetType(StartMargin), FileFormatVersions.Office2010)> _
<ChildElementInfoAttribute(GetType(EndMargin), FileFormatVersions.Office2010)> _
<ChildElementInfoAttribute(GetType(TableCellLeftMargin))> _
<ChildElementInfoAttribute(GetType(BottomMargin))> _
<ChildElementInfoAttribute(GetType(TableCellRightMargin))> _
Public Class TableCellMarginDefault _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As TableCellMarginDefault
[ChildElementInfoAttribute(typeof(TopMargin))]
[ChildElementInfoAttribute(typeof(StartMargin), FileFormatVersions.Office2010)]
[ChildElementInfoAttribute(typeof(EndMargin), FileFormatVersions.Office2010)]
[ChildElementInfoAttribute(typeof(TableCellLeftMargin))]
[ChildElementInfoAttribute(typeof(BottomMargin))]
[ChildElementInfoAttribute(typeof(TableCellRightMargin))]
public class TableCellMarginDefault : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • TopMargin <w:top>

  • TableCellLeftMargin <w:left>

  • StartMargin <w:start>

  • BottomMargin <w:bottom>

  • TableCellRightMargin <w:right>

  • EndMargin <w:end>

[ISO/IEC 29500-1 1st Edition]

17.4.42 tblCellMar (Table Cell Margin Exceptions)

This element specifies a set of cell margins for all cells in the parent table row via a set of table-level property exceptions. These settings can be overridden by the table cell margin definition specified by the tcMar element contained within the table cell's properties (§17.4.42).

If this element is omitted, then it shall inherit the table cell margins from the table-level cell margins (§17.4.43).

[Example: Consider a table whose final two rows are defined to have default cell margins of 0.1 inches for all sides via a table-level property exception, as follows:

This set of table cell margin exceptions is specified using the following WordprocessingML:

<w:tblPrEx>
<w:tblCellMar>
<w:top w:w="144" w:type="dxa"/>
<w:left w:w="144" w:type="dxa"/>
<w:bottom w:w="144" w:type="dxa"/>
<w:right w:w="144" w:type="dxa"/>
</w:tblCellMar>
…
</w:tblPrEx>

The tblCellMar element as a child of tblPrEx specifies the set of default cell margins for all cells in final two rows in current table, in this case, 144 twentieths of a point on all sides. end example]

Parent Elements

tblPrEx (§17.4.61); tblPrEx (§17.4.62)

Child Elements

Subclause

bottom (Table Cell Bottom Margin Default)

§17.4.5

end (Table Cell Trailing Margin Default)

§17.4.11

start (Table Cell Leading Margin Default)

§17.4.35

top (Table Cell Top Margin Default)

§17.4.76

[Note: The W3C XML Schema definition of this element’s content model (CT_TblCellMar) is located in §A.1. end note]

[ISO/IEC 29500-1 1st Edition]

17.4.43 tblCellMar (Table Cell Margin Defaults)

This element specifies the default cell margin settings for all cells in the current table. These setting can be overridden by the table cell margin definition specified by the tcMar element contained within the table cell's properties (§17.4.69) or by a set of table-level property exceptions (§17.4.42).

If this element is omitted, then it shall inherit the table cell margins from the associated table style. If table margins are never specified in the style hierarchy, then each margin shall use its default margin size (see child element definitions).

[Example: Consider a table defined to have default cells margins of 0.1 inches for all sides, as follows:

R1C1

R1C2

R2C1

R2C2

This set of default table cell margins would be specified using the following WordprocessingML:

<w:tblPr>
<w:tblCellMar>
<w:top w:w="144" w:type="dxa"/>
<w:left w:w="144" w:type="dxa"/>
<w:bottom w:w="144" w:type="dxa"/>
<w:right w:w="144" w:type="dxa"/>
</w:tblCellMar>
…
</w:tblPr>

The tblCellMar element as a child of tblPr specifies the set of default cell margins for all cells in the current table, in this case, 144 twentieths of a point. end example]

Parent Elements

tblPr (§17.4.60); tblPr (§17.4.59); tblPr (§17.7.6.4); tblPr (§17.7.6.3)

Child Elements

Subclause

bottom (Table Cell Bottom Margin Default)

§17.4.5

end (Table Cell Trailing Margin Default)

§17.4.11

start (Table Cell Leading Margin Default)

§17.4.35

top (Table Cell Top Margin Default)

§17.4.76

[Note: The W3C XML Schema definition of this element’s content model (CT_TblCellMar) is located in §A.1. end note]

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

TableCellMarginDefault Members

DocumentFormat.OpenXml.Wordprocessing Namespace