Extent class

Office 2013 and later

Inline Drawing Object Extents. When the object is serialized out as xml, its qualified name is wp:extent.

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Drawing.Wordprocessing.Extent

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

public class Extent : OpenXmlLeafElement

[ISO/IEC 29500-1 1st Edition]

extent (Drawing Object Size)

This element specifies the extents of the parent DrawingML object within the document (i.e. its final height and width).

[Example: Consider a DrawingML picture which is present in a WordprocessingML document and has an equal height and width. This object would be specified as follows:

<wp:anchor relativeHeight="10" allowOverlap="true">
  …  <wp:extent cx="1828800" cy="1828800"/>
  …</wp:anchor>

The extent element specifies via its attributes that this object has a height and width of 1828800 EMUs (English Metric Units). end example]

Parent Elements

anchor (§20.4.2.3); inline (§20.4.2.8)

Attributes

Description

cx (Extent Length)

Namespace: .../drawingml/2006/main

Specifies the length of the extents rectangle in EMUs. This rectangle shall dictate the size of the object as displayed (the result of any scaling to the original object).

[Example: Consider a DrawingML object specified as follows:

<… cx="1828800" cy="200000"/>

The cx attributes specifies that this object has a height of 1828800 EMUs (English Metric Units). end example]

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

cy (Extent Width)

Namespace: .../drawingml/2006/main

Specifies the width of the extents rectangle in EMUs. This rectangle shall dictate the size of the object as displayed (the result of any scaling to the original object).

[Example: Consider a DrawingML object specified as follows:

< … cx="1828800" cy="200000"/>

The cy attribute specifies that this object has a width of 200000 EMUs (English Metric Units). end example]

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

[Note: The W3C XML Schema definition of this element’s content model (CT_PositiveSize2D) is located in §A.4.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: