Share via


BodyProperties.ColumnCount Property

Number of Columns.Represents the attribte in schema: numCol

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

Syntax

'Declaration
<SchemaAttrAttribute(, "numCol")> _
Public Property ColumnCount As Int32Value
    Get
    Set
'Usage
Dim instance As BodyProperties
Dim value As Int32Value

value = instance.ColumnCount

instance.ColumnCount = value
[SchemaAttrAttribute(, "numCol")]
public Int32Value ColumnCount { get; set; }

Property Value

Type: DocumentFormat.OpenXml.Int32Value
Returns Int32Value.

Remarks

The following information from the ECMA International Standard ECMA-376 can be useful when working with this class.

Specifies the number of columns of text in the bounding rectangle. When applied to a text run this property takes the width of the bounding box for the text and divides it by the number of columns specified. These columns are then treated as overflow containers in that when the previous column has been filled with text the next column will act as the repository for additional text. When all columns have been filled and text still remains then the overflow properties set for this text body will be used and the text will be reflowed to make room for additional text. If this attribute is omitted, then a value of 1 is implied.

Consider the case where a text area would need to be split up into four separate columns. Then simply specifying one paragraph with one run of text is enough to describe four columns of text here.

<p:txBody>
  <a:bodyPr numCol="4" … />
  <a:p>
    <a:r>
      …
      (Some text)
      …
    </a:r>
  </a:p>
</p:txBody>

The possible values for this attribute are defined by the ST_TextColumnCount simple type.

See Also

Reference

BodyProperties Class

BodyProperties Members

DocumentFormat.OpenXml.Drawing Namespace