Export (0) Print
Expand All

GutterOnRight class

Defines the GutterOnRight Class. When the object is serialized out as xml, its qualified name is w:rtlGutter.

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

public class GutterOnRight : OnOffType

[ISO/IEC 29500-1 1st Edition]

rtlGutter (Gutter on Right Side of Page)

This element specifies that the page gutter shall be placed on the right side of the page for this section only. The page gutter defines the amount of extra space added to the specified margin, above any existing margin values. [Note: This setting is typically used when a document is being created for binding, in order to ensure that the resulting margins are present after the binding gutter is consumed by the printed matter binding. end note]

If the gutter is set to the side of the page by the omission of the gutterAtTop element (§17.15.1.50), then each section's gutter is placed at the left by default, unless that default is overridden by the rtlGutter element.

[Example: Consider a document with three sections, with gutter properties defined as follows:

<w:p>
  <w:pPr>
    <w:sectPr>
      <w:pgMar w:gutter="1440" …/>
      …    </w:sectPr>
  </w:pPr>
</w:p>
…
<w:p>
  <w:pPr>
    <w:sectPr>
      <w:pgMar w:gutter="1440" …/>
      <w:rtlGutter w:val="0" />
      …    </w:sectPr>
  </w:pPr>
</w:p>
…
<w:p>
  <w:pPr>
    <w:sectPr>
      <w:pgMar w:gutter="1440" …/>
      <w:rtlGutter />
      …    </w:sectPr>
  </w:pPr>
</w:p>

The first and second sections both place the gutter on the left side, the first by omission of the rtlGutter attribute, and the second by explicitly turning it off. The third section, however, moves the gutter to the right side via the use of the rtlGutter attribute. end example]

If the gutterAtTop element (§17.15.1.50) is specified and true, then each section's gutter is at the top and this setting is ignored.

Parent Elements

sectPr (§17.6.17); sectPr (§17.6.18); sectPr (§17.6.19)

This element’s content model is defined by the common boolean property definition in §17.17.4.

© ISO/IEC29500: 2008.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions

Show:
© 2014 Microsoft