Share via


Columns.EqualWidth Property

Definition

Equal Column Widths

Represents the following attribute in the schema: w:equalWidth

[DocumentFormat.OpenXml.SchemaAttr(23, "equalWidth")]
public DocumentFormat.OpenXml.OnOffValue EqualWidth { get; set; }
public DocumentFormat.OpenXml.OnOffValue EqualWidth { get; set; }
[DocumentFormat.OpenXml.SchemaAttr(23, "equalWidth")]
public DocumentFormat.OpenXml.OnOffValue? EqualWidth { get; set; }
[DocumentFormat.OpenXml.SchemaAttr("w:equalWidth")]
public DocumentFormat.OpenXml.OnOffValue? EqualWidth { get; set; }
public DocumentFormat.OpenXml.OnOffValue? EqualWidth { get; set; }
member this.EqualWidth : DocumentFormat.OpenXml.OnOffValue with get, set
[<DocumentFormat.OpenXml.SchemaAttr(23, "equalWidth")>]
member this.EqualWidth : DocumentFormat.OpenXml.OnOffValue with get, set
[<DocumentFormat.OpenXml.SchemaAttr("w:equalWidth")>]
member this.EqualWidth : DocumentFormat.OpenXml.OnOffValue with get, set
Public Property EqualWidth As OnOffValue

Property Value

Returns EnumValue<T>.

Attributes

Remarks

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

Specifies whether all the text columns in the current section are of equal width.

If this attribute is present and its value is set to true, on, or 1, then all the columns for this text section are of an equal width and are calculated as follows:

  1. Take the width of the page (from margin to margin).

  2. Divide by the number of columns specified in the num attribute.

  3. For each column, leave space after as defined in the space attribute.

  4. The remaining width of each column is the text column width.

If this attribute is present and its value is set to false, off, or 0, then all the columns for this text section are of different widths and are defined by each col element as follows:

  • Each col element defines a single column.

  • Each w attribute defines the text column width.

  • Each space attribute defines the space after the text column.

Consider a section with column information defined as follows:

<w:cols w:num="3" w:space="1440"  
  w:equalWidth="1">  
  <w:col w:w="2880" w:space="2880" />  
  <w:col w:w="2880" w:space="1440" />  
  <w:col w:w="2880" />  
</w:cols>  

This set of columns has an equalWidth value set to 1. Therefore, the col elements are ignored, and there are three equally sized columns (num value of 3), each with 1 inch of space after (space value of 1440 twentieths of a point).

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

Applies to