Share via


EffectExtent Class

Object Extents Including Effects.When the object is serialized out as xml, its qualified name is wp:effectExtent.

Inheritance Hierarchy

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

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

Syntax

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

Remarks

[ISO/IEC 29500-1 1st Edition]

20.4.2.6 effectExtent (Object Extents Including Effects)

This element specifies the additional extent which shall be added to each edge of the image (top, bottom, left, right) in order to compensate for any drawing effects applied to the DrawingML object.

The extent element (§20.4.2.7) specifies the size of the actual DrawingML object; however, an object can have effects applied which change its overall size [Example: A reflection and/or shadow effect. end example]. The additional size for each edge of the shape shall be stored on this element, and used to calculate the appropriate wrapping for wrap types without a wrapping polygon and the appropriate line height for inline objects.

[Example: Consider the following DrawingML image:

DocumentFormat.OpenXml.Drawing.Wordprocessing.Effe

This object has no effects, and hence would have the following effect extents:

<wp:effectExtents b="0" t="0" l="0" r="0" />

However, if a shadow effect was applied which added effects to the right of the image:

DocumentFormat.OpenXml.Drawing.Wordprocessing.Effe

Then the additional extent the right side would be specified in the r attribute on this element:

<wp:effectExtents b="0" t="0" l="0" r="695325" />

The r attribute has a value of 695325, specifying that that 695325 EMUs must be added to the right side of the image. end example]

Parent Elements

anchor (§20.4.2.3); inline (§20.4.2.8); wrapSquare (§20.4.2.17); wrapTopAndBottom (§20.4.2.20)

Attributes

Description

b (Additional Extent on Bottom Edge)

Specifies the additional length, in EMUs, which shall be added to the bottom edge of the DrawingML object to determine its actual bottom edge including effects.

[Example: Consider the following DrawingML image:

DocumentFormat.OpenXml.Drawing.Wordprocessing.Effe

This image has an effect on all four sides, resulting in the following markup:

<wp:effectExtent l="504825" t="447675" r="771525" b="809625" />

The b attribute value of 809625 specifies that 809625 additional EMUs must be added to the bottom of the image to compensate for the effects on the image. end example]

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

l (Additional Extent on Left Edge)

Specifies the additional length, in EMUs, which shall be added to the bottom edge of the DrawingML object to determine its actual bottom edge including effects.

[Example: Consider the following DrawingML image:

DocumentFormat.OpenXml.Drawing.Wordprocessing.Effe

This image has an effect on all four sides, resulting in the following markup:

<wp:effectExtent l="504825" t="447675" r="771525" b="809625" />

The l attribute value of 504825 specifies that 504825 additional EMUs must be added to the bottom of the image to compensate for the effects on the image. end example]

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

r (Additional Extent on Right Edge)

Specifies the additional length, in EMUs, which shall be added to the bottom edge of the DrawingML object to determine its actual bottom edge including effects.

[Example: Consider the following DrawingML image:

DocumentFormat.OpenXml.Drawing.Wordprocessing.Effe

This image has an effect on all four sides, resulting in the following markup:

<wp:effectExtent l="504825" t="447675" r="771525" b="809625" />

The r attribute value of 771525 specifies that 771525 additional EMUs must be added to the bottom of the image to compensate for the effects on the image. end example]

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

t (Additional Extent on Top Edge)

Specifies the additional length, in EMUs, which shall be added to the bottom edge of the DrawingML object to determine its actual bottom edge including effects.

[Example: Consider the following DrawingML image:

DocumentFormat.OpenXml.Drawing.Wordprocessing.Effe

This image has an effect on all four sides, resulting in the following markup:

<wp:effectExtent l="504825" t="447675" r="771525" b="809625" />

The t attribute value of 447675 specifies that 447675 additional EMUs must be added to the bottom of the image to compensate for the effects on the image. end example]

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

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

EffectExtent Members

DocumentFormat.OpenXml.Drawing.Wordprocessing Namespace