Compartilhar via


StartMargin Class

Defines the StartMargin Class.This class is only available in Office2010.When the object is serialized out as xml, its qualified name is w:start.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.TableWidthType
        DocumentFormat.OpenXml.Wordprocessing.StartMargin

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

Syntax

'Declaration
<OfficeAvailabilityAttribute(FileFormatVersions.Office2010)> _
Public Class StartMargin _
    Inherits TableWidthType
'Usage
Dim instance As StartMargin
[OfficeAvailabilityAttribute(FileFormatVersions.Office2010)]
public class StartMargin : TableWidthType

Remarks

[ISO/IEC 29500-1 1st Edition]

17.4.35 start (Table Cell Leading Margin Default)

This element specifies the amount of space which shall be left between the leading edge of the cell contents and the leading edge of all table cells within the parent table (or table row). This setting can be overridden by the table cell leading margin definition specified by the start element contained within the table cell's properties (§17.4.36).

This value is specified in the units applied via its type attribute. Any width value of type pct or auto for this element shall be ignored.

If this element is omitted, then it shall inherit the table cell margin from the associated table style. If a leading margin is never specified in the style hierarchy, this table shall have 115 twentieths of a point (0.08 inches) left cell padding by default (excepting individual cell overrides).

[Example: Consider a two by two LTR table in which the default table cell leading margin is specified to be exactly 0.25 inches, as follows (marked with an arrow in the first table cell below):

R1C1

R2C1

R2C1

R2C2

This table property is specified using the following WordprocessingML markup:

<w:tbl>
<w:tblPr>
<w:tblCellMar>
<w:start w:w="360" w:type="dxa"/>
</w:tblCellMar>
</w:tblPr>
…
</w:tbl>

Every cell in the table has a default leading cell margin setting it to 360 twentieths of a point. end example]

Parent Elements

tblCellMar (§17.4.42); tblCellMar (§17.4.43)

This element’s content model is defined by the common table measurement definition in §17.4.88.

[ISO/IEC 29500-1 1st Edition]

17.4.36 start (Table Cell Leading Margin Exception)

This element specifies the amount of space which shall be left between the leading extent of the current cell contents and the leading edge border of a specific individual table cell within a table. This setting shall override the table cell leading margin definition specified by the start element contained within the table properties (§17.4.35).

This value is specified in the units applied via its type attribute. Any width value of type pct or auto for this element shall be ignored.

If omitted, then this table cell shall use the leading cell margins defined in the start element contained within the table properties (§17.4.35).

[Example: Consider a two row, two column LTR table in which the first table cell in the second row has a leading margin which is specified via an exception to be 0.5 inches, causing the text to be position 0.5" inside the cell, as follows:

R1C1

R1C2

R2C1

R2C2

The exception on this cell would be specified using the following WordprocessingML:

<w:tc>
<w:tcPr>
<w:tcMar>
<w:start w:w="720" w:type="dxa" />
</w:tcMar>
</w:tcPr>
</w:tc>

The R2C1 cell in this table has an exception applied to the table cell leading margin setting it to 720 twentieths of a point (0.5 inches). end example]

Parent Elements

tcMar (§17.4.69)

This element’s content model is defined by the common table measurement definition in §17.4.88.

© 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

StartMargin Members

DocumentFormat.OpenXml.Wordprocessing Namespace