BodyProperties.ColumnCount Property

Definition

Namespace:

DocumentFormat.OpenXml.Drawing

Assembly:

DocumentFormat.OpenXml.dll

Package:

DocumentFormat.OpenXml v3.0.1

Number of Columns

Represents the following attribute in the schema: numCol

public DocumentFormat.OpenXml.Int32Value? ColumnCount { get; set; }

member this.ColumnCount : DocumentFormat.OpenXml.Int32Value with get, set

Public Property ColumnCount As Int32Value

Property Value

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.