Partager via


HorizontalPosition Class

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

Inheritance Hierarchy

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

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

Syntax

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

Remarks

The following table lists the possible child types:

  • HorizontalAlignment <wp:align>

  • PositionOffset <wp:posOffset>

  • DocumentFormat.OpenXml.Office2010.Word.Drawing.PercentagePositionHeightOffset <wp14:pctPosHOffset>

[ISO/IEC 29500-1 1st Edition]

20.4.2.10 positionH (Horizontal Positioning)

This element specifies the horizontal 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 positionH element specifies that the object is horizontally 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 Horizontal Alignment)

§20.4.2.1

posOffset (Absolute Position Offset)

§20.4.2.12

Attributes

Description

relativeFrom (Horizontal Position Relative Base)

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

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

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

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

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

[Note: The W3C XML Schema definition of this element’s content model (CT_PosH) 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

HorizontalPosition Members

DocumentFormat.OpenXml.Drawing.Wordprocessing Namespace