VerticalPosition Class

Vertical Positioning.When the object is serialized out as xml, its qualified name is wp:positionV.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Drawing.Wordprocessing.VerticalPosition

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

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(PercentagePositionVerticalOffset), FileFormatVersions.Office2010)> _
<ChildElementInfoAttribute(GetType(VerticalAlignment))> _
<ChildElementInfoAttribute(GetType(PositionOffset))> _
Public Class VerticalPosition _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As VerticalPosition
[ChildElementInfoAttribute(typeof(PercentagePositionVerticalOffset), FileFormatVersions.Office2010)]
[ChildElementInfoAttribute(typeof(VerticalAlignment))]
[ChildElementInfoAttribute(typeof(PositionOffset))]
public class VerticalPosition : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • VerticalAlignment <wp:align>

  • PositionOffset <wp:posOffset>

  • DocumentFormat.OpenXml.Office2010.Word.Drawing.PercentagePositionVerticalOffset <wp14:pctPosVOffset>

[ISO/IEC 29500-1 1st Edition]

20.4.2.11 positionV (Vertical Positioning)

This element specifies the vertical positioning of a floating DrawingML object within a WordprocessingML document. This positioning is specified in two parts:

  • Positioning Base - The relativeFrom attribute on this element specifies the part of the document from which the positioning shall be calculated.

  • Positioning - The child element of this element (align or posOffset) specifies how the object is positioned relative to that base.

[Example: Consider a DrawingML picture which must be displayed in the center of the printed page on which it appears, modifying the flow of text as necessary. This object would be specified as follows:

<wp:anchor … >
<wp:positionH relativeFrom="margin">
<wp:align>center</wp:align>
</wp:positionH>
<wp:positionV relativeFrom="margin">
<wp:align>center</wp:align>
</wp:positionV>
</wp:anchor>

The positionV element specifies that the object is vertically positioned relative to the margin via the relativeFrom attribute; and that the alignment relative to the margin is centered via the align element. end example]

Parent Elements

anchor (§20.4.2.3)

Child Elements

Subclause

align (Relative Vertical Alignment)

§20.4.2.2

posOffset (Absolute Position Offset)

§20.4.2.12

Attributes

Description

relativeFrom (Vertical Position Relative Base)

Specifies the base to which the relative vertical positioning of this object shall be calculated.

[Example: Consider a DrawingML picture which must be displayed at the bottom center of the page margins. This object would be specified as follows:

<wp:anchor … >
…
<wp:positionV relativeFrom="margin">
<wp:align>bottom</wp:align>
</wp:positionV>
</wp:anchor>

The relativeFrom attribute specifies that the object is horizontally positioned relative to the margin. end example]

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

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

© ISO/IEC29500: 2008.

Thread Safety

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

See Also

Reference

VerticalPosition Members

DocumentFormat.OpenXml.Drawing.Wordprocessing Namespace