VerticalTextAlignmentOnPage class

Office 2013 and later

Defines the VerticalTextAlignmentOnPage Class. When the object is serialized out as xml, its qualified name is w:vAlign.

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.VerticalTextAlignmentOnPage

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

public class VerticalTextAlignmentOnPage : OpenXmlLeafElement

[ISO/IEC 29500-1 1st Edition]

vAlign (Table Cell Vertical Alignment)

This element specifies the vertical alignment for text within the current table cell. The vertical alignment of this text is determined by the value of the val attribute.

[Example: Consider a table with a single cell with text vertically aligned to the bottom of the cell:

R1C1

This requirement would be specified using the following WordprocessingML:

<w:tc>
  <w:tcPr>
    <w:vAlign w:val="bottom" />
  </w:tcPr>
  <w:p>
    <w:r>
      <w:t>R1C1</w:t>
    </w:r>
  </w:p>
</w:tc>

The vAlign element specifies the vertical alignment of the cell contents, in the case, the bottom of the table cell. end example]

Parent Elements

tcPr (§17.7.6.8); tcPr (§17.7.6.9); tcPr (§17.4.70); tcPr (§17.4.71)

Attributes

Description

val (Vertical Alignment Setting)

Specifies the vertical alignment for text between the top and bottom margins of the parent container (page or table cell).

[Example: Consider a region where the text must be vertically centered in the parent element. This would require a val value of center, in order to specify that all justification vertically must be centered relative to the parent. For a section, this setting would be specified as follows:

<w:vAlign w:val="center" />

The val attribute of center specifies that the content is centered relative to its container (in this case, the page). end example]

The possible values for this attribute are defined by the ST_VerticalJc simple type (§17.18.101).

[Note: The W3C XML Schema definition of this element’s content model (CT_VerticalJc) is located in §A.1. end note]

[ISO/IEC 29500-1 1st Edition]

vAlign (Vertical Text Alignment on Page)

This element specifies the vertical alignment for text on pages in the current section, relative to the top and bottom margins in the main document story on each page.

[Example: Consider a section used as a title page on which text must be vertically centered. In order to center the text vertically on the page, the following WordprocessingML is used:

<w:sectPr>
  …  <w:vAlign w:="center" />
</w:sectPr>

The vAlign value of center specifies that text must be laid out in the center of the top and bottom text margins for all pages in this section. end example]

Parent Elements

sectPr (§17.6.17); sectPr (§17.6.18); sectPr (§17.6.19)

Attributes

Description

val (Vertical Alignment Setting)

Specifies the vertical alignment for text between the top and bottom margins of the parent container (page or table cell).

[Example: Consider a region where the text must be vertically centered in the parent element. This would require a val value of center, in order to specify that all justification vertically must be centered relative to the parent. For a section, this setting would be specified as follows:

<w:vAlign w:val="center" />

The val attribute of center specifies that the content is centered relative to its container (in this case, the page). end example]

The possible values for this attribute are defined by the ST_VerticalJc simple type (§17.18.101).

[Note: The W3C XML Schema definition of this element’s content model (CT_VerticalJc) is located in §A.1. end note]

© ISO/IEC29500: 2008.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show: