DrawingGridHorizontalSpacing Class

Drawing Grid Horizontal Grid Unit Size.When the object is serialized out as xml, its qualified name is w:drawingGridHorizontalSpacing.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.TwipsMeasureType
        DocumentFormat.OpenXml.Wordprocessing.DrawingGridHorizontalSpacing

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

Syntax

'Declaration
Public Class DrawingGridHorizontalSpacing _
    Inherits TwipsMeasureType
'Usage
Dim instance As DrawingGridHorizontalSpacing
public class DrawingGridHorizontalSpacing : TwipsMeasureType

Remarks

[ISO/IEC 29500-1 1st Edition]

17.15.1.45 drawingGridHorizontalSpacing (Drawing Grid Horizontal Grid Unit Size)

This element specifies the width of horizontal grid units in this document. The drawing grid is a grid which can be used by applications to help position floating objects in the document.

If this element is omitted, then each horizontal grid unit shall be 180 twentieths of a point (0.125") in width.

[Example: Consider the image below illustrating a WordprocessingML document in which all horizontal grid units are each 144 twentieths of a point wide (and all are showing):

DocumentFormat.OpenXml.Wordprocessing.DrawingGridH

If the gridlines in this document must only be displayed for every half an inch, that requirement would be specified using the following WordprocessingML in the document settings:

<w:drawingGridHorizontalSpacing w:val="720" />

The resulting grid would look like the following:

DocumentFormat.OpenXml.Wordprocessing.DrawingGridH

The drawingGridHorizontalSpacing element has its val attribute equal to 720, therefore every horizontal gridline has a width of one half of an inch (720 twentieths of a point). end example]

Parent Elements

settings (§17.15.1.78)

Attributes

Description

val (Measurement in Twentieths of a Point)

Specifies a positive measurement value, specified in twentieths of a point. This value is interpreted based on the context of the parent XML element.

[Example: Consider the following WordprocessingML element with a val attribute containing a positive measurement in twentieths of a point:

<… w:val="720" />

The val attribute has a value of 720, specifying that this measurement value is 720 twentieths of a point (0.5"). This value is interpreted by the parent element as needed. end example]

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

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

DrawingGridHorizontalSpacing Members

DocumentFormat.OpenXml.Wordprocessing Namespace