Extent Class

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

Inheritance Hierarchy

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)

Syntax

'Declaration
Public Class Extent _
    Inherits OpenXmlLeafElement
'Usage
Dim instance As Extent
public class Extent : OpenXmlLeafElement

Remarks

[ISO/IEC 29500-1 1st Edition]

20.4.2.7 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.

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

Extent Members

DocumentFormat.OpenXml.Drawing.Wordprocessing Namespace