w:cols (Column Layout)
Defines multi-column layout for the section, specifying column count, spacing, and widths.
Description
w:cols controls the multi-column layout for a section. It is defined in ECMA-376 Part 1 §17.6.4.
When w:equalWidth is true (default), all columns share the same width, derived from w:num and w:space. When equal width is disabled, individual w:col elements define widths. A vertical line between columns is drawn when w:sep is set.
Attributes
| Attribute | Type | Possible Values | Description |
|---|---|---|---|
w:num |
xsd:integer |
Positive integer (default: 1). |
Number of text columns in the section. |
w:space |
ST_TwipsMeasure |
Positive integer (twips). | Gap between equal-width columns (default: 720, i.e. 0.5 in). |
w:equalWidth |
ST_OnOff |
true / false (default: true). |
Whether all columns are equal width. |
w:sep |
ST_OnOff |
true / false |
Draw a vertical line between columns. |
Examples
<!-- Two equal-width columns with separator line -->
<w:cols w:num="2" w:space="720" w:sep="true"/>new Columns { ColumnCount = 2, Space = "720", Separator = true };