Share via


DrawingGridVerticalOrigin Class

Drawing Grid Vertical Origin Point.When the object is serialized out as xml, its qualified name is w:drawingGridVerticalOrigin.

Inheritance Hierarchy

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

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

Syntax

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

Remarks

[ISO/IEC 29500-1 1st Edition]

17.15.1.46 drawingGridVerticalOrigin (Drawing Grid Vertical Origin Point)

This element specifies the distance from of the top edge of the page which shall be used as the origin for the vertical gridlines used by the drawing grid. The drawing grid is a virtual grid which can be used by applications to specify where drawing objects shall be positioned on a page when inserted (i.e. to ensure objects are aligned, etc.). Since the grid always covers the entire page when the doNotUseMarginsForDrawingGridOrigin element (§17.15.1.42) is specified, this element shall only affect the starting edge of the first vertical gridline displayed (i.e. it only adjusts the grid by the modulus of the value against the width of one grid unit).

If this element is omitted, then the gridlines shall start at the topmost edge of the page. If the doNotUseMarginsForDrawingGridOrigin element is not specified, then this element is ignored.

[Example: Consider a WordprocessingML document whose drawing grid must begin one inch (1440 twentieths of a point) before the top edge of the page. This requirement would be specified using the following WordprocessingML markup in the document settings:

<w:settings>
…
<w:dontuseMarginsForDrawingGridOrigin w:val="true" />
<w:drawingGridVerticallOrigin w:val="1440" />
…
</w:settings>

The drawingGridVerticalOrigin element's val attribute is equal to 1440 specifying that the vertical edge of the document's drawing grid must begin one inch (1440 twentieths of a point) from the top edge of the page, since the dontUseMarginsForDrawingGridOrigin element's val attribute is equal to true. 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

DrawingGridVerticalOrigin Members

DocumentFormat.OpenXml.Wordprocessing Namespace