DisplayHorizontalDrawingGrid Class

Distance between Horizontal Gridlines.When the object is serialized out as xml, its qualified name is w:displayHorizontalDrawingGridEvery.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.UnsignedInt7Type
        DocumentFormat.OpenXml.Wordprocessing.DisplayHorizontalDrawingGrid

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

Syntax

'Declaration
Public Class DisplayHorizontalDrawingGrid _
    Inherits UnsignedInt7Type
'Usage
Dim instance As DisplayHorizontalDrawingGrid
public class DisplayHorizontalDrawingGrid : UnsignedInt7Type

Remarks

[ISO/IEC 29500-1 1st Edition]

17.15.1.27 displayHorizontalDrawingGridEvery (Distance between Horizontal Gridlines)

This element specifies the number of horizontal grid units defined using the drawingGridHorizontalSpacing element (§17.15.1.45) which shall be allowed between subsequent visible horizontal drawing grid lines in this document, if gridlines are being shown. [Note: The display of gridlines is an application-level setting not specified in ISO/IEC 29500. end note] 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 gridlines shall be displayed for each horizontal grid unit.

[Example: Consider the image below illustrating a WordprocessingML document in which all horizontal grid units are visible (the default setting):

DocumentFormat.OpenXml.Wordprocessing.DisplayHoriz

If the gridlines in this document shall only be displayed for every 4th horizontal drawing gridline, that requirement would be specified using the following WordprocessingML in the document settings:

<w:displayHorizontalDrawingGridEvery w:val="4" />

The resulting grid would look like the following:

DocumentFormat.OpenXml.Wordprocessing.DisplayHoriz

The displayHorizontalDrawingGridEvery element has its val attribute equal to 4, therefore every fourth gridline is displayed in the document when the drawing grid is turned on. end example]

Parent Elements

settings (§17.15.1.78)

Attributes

Description

val (Decimal Number Value)

Specifies that the contents of this attribute contains a decimal number.

The contents of this decimal number are interpreted based on the context of the parent XML element.

[Example: Consider the following numeric WordprocessingML property of simple type ST_DecimalNumber:

<… w:val="1512645511" />

The value of the val attribute is a decimal number whose value must be interpreted in the context of the parent element. end example]

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

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

DisplayHorizontalDrawingGrid Members

DocumentFormat.OpenXml.Wordprocessing Namespace