Column Class

Single Column Definition.When the object is serialized out as xml, its qualified name is w:col.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.Column

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

Syntax

'Declaration
Public Class Column _
    Inherits OpenXmlLeafElement
'Usage
Dim instance As Column
public class Column : OpenXmlLeafElement

Remarks

[ISO/IEC 29500-1 1st Edition]

17.6.3 col (Single Column Definition)

This element specifies the properties for a single column of text within this section.

[Example: Consider a single column with a width of two inches, which also has a one-inch space after the column, resulting in the following WordprocessingML:

<w:cols … >
<w:col w:w="2880" w:space="1440"/>
  …
</w:cols>

The resulting column specifies its width of 2,880 twentieths of a point and space following of 1,440 twentieths of a point. end example]

The contents of the col element are only used to calculate the number and size of columns if the fixedWidth attribute is set to false or omitted.

Parent Elements

cols (§17.6.4)

Attributes

Description

space (Space Before Following Column)

Specifies the spacing (in twentieths of a point) between the current column and the next column.

[Example: Consider a text column that is to have a one-inch space after it. This text column spacing would therefore be 1x72=144 points wide, which translates to 1,440 twentieths of a point. The resulting WordprocessingML specifies that spacing width in twentieths of a point:

<w:col … w:space="1440"/>

end example]

For the last text column in the section, no spacing is allowed after the column, and, if present, any space value is ignored.

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

w (Column Width)

Specifies the width (in twentieths of a point) of this text column.

[Example: Consider a text column, which is to be two inches wide. This text column would therefore be 2x72=144 points wide, which translates to 2,880 twentieths of a point. The resulting WordprocessingML specifies that column width in twentieths of a point:

<w:col … w:w="2880"/>

end example]

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

[Note: The W3C XML Schema definition of this element’s content model (CT_Column) 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

Column Members

DocumentFormat.OpenXml.Wordprocessing Namespace