BodyProperties.ColumnCount BodyProperties.ColumnCount BodyProperties.ColumnCount Property

Definition

Number of Columns.Represents the following attribute in the schema: numCol

[DocumentFormat.OpenXml.SchemaAttr(0, "numCol")]
public DocumentFormat.OpenXml.Int32Value ColumnCount { get; set; }
member this.ColumnCount : DocumentFormat.OpenXml.Int32Value with get, set
Public Property ColumnCount As Int32Value

Property Value

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.

Applies to