# C1.C1Preview.CompatibilityOptions

## Content

<div class="doc-site-dotnet-api-container">



  <h1 id="C1_C1Preview_CompatibilityOptions" data-uid="C1.C1Preview.CompatibilityOptions" class="text-break">CompatibilityOptions Class
</h1>
  <div class="markdown level0 summary"><p>Defines the compatibility options for C1PrintDocument.
Contains properties specifying compatibility with
previous versions of C1PrintDocument.</p>
</div>
  <div class="markdown level0 conceptual"></div>
  <div class="inheritance">
    <h5>Inheritance</h5>
    <div class="level0"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.object">object</a></div>
    <div class="level1"><span class="xref">CompatibilityOptions</span></div>
  </div>
  <h6><strong>Namespace</strong>: <a class="xref" href="C1.C1Preview.html">C1.C1Preview</a></h6>
  <h6><strong>Assembly</strong>: C1.PrintDocument.10.dll</h6>
  <h5 id="C1_C1Preview_CompatibilityOptions_syntax">Syntax</h5>
  <div class="codewrapper">
    <pre><code class="lang-csharp hljs">public class CompatibilityOptions</code></pre>
  </div>
  <div class="codewrapper">
    <pre><code class="lang-vbnet hljs">Public Class CompatibilityOptions</code></pre>
  </div>
  <h3 id="constructors">Constructors
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_C1Preview_CompatibilityOptions__ctor" data-uid="C1.C1Preview.CompatibilityOptions.#ctor">
          <a class="xref" href="C1.C1Preview.CompatibilityOptions.-ctor.html#C1_C1Preview_CompatibilityOptions__ctor">CompatibilityOptions()</a>
        </td>
        <td class="markdown level1 summary"></td>
      </tr>
    </tbody>
  </table>
  <h3 id="properties">Properties
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_C1Preview_CompatibilityOptions_BordersMode" data-uid="C1.C1Preview.CompatibilityOptions.BordersMode">
          <a class="xref" href="C1.C1Preview.CompatibilityOptions.BordersMode.html#C1_C1Preview_CompatibilityOptions_BordersMode">BordersMode</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a valud specifying how borders affect the layout of objects in a document.</p>
<p>See <a class="xref" href="C1.C1Preview.BordersModeEnum.html">BordersModeEnum</a> for details.</p>
<p>
The default value is <a class="xref" href="C1.C1Preview.BordersModeEnum.html#C1_C1Preview_BordersModeEnum_Default">Default</a>.
</p>
</td>
      </tr>
      <tr>
        <td id="C1_C1Preview_CompatibilityOptions_HeaderFooterWidthAsTotalColumnWidth" data-uid="C1.C1Preview.CompatibilityOptions.HeaderFooterWidthAsTotalColumnWidth">
          <a class="xref" href="C1.C1Preview.CompatibilityOptions.HeaderFooterWidthAsTotalColumnWidth.html#C1_C1Preview_CompatibilityOptions_HeaderFooterWidthAsTotalColumnWidth">HeaderFooterWidthAsTotalColumnWidth</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating whether the widths of page headers and footers
should be equal to the sum of the widths of all page columns. The default is false.
Set this property to true to improve compatibility with C1Report.</p>
</td>
      </tr>
      <tr>
        <td id="C1_C1Preview_CompatibilityOptions_KeepImages" data-uid="C1.C1Preview.CompatibilityOptions.KeepImages">
          <a class="xref" href="C1.C1Preview.CompatibilityOptions.KeepImages.html#C1_C1Preview_CompatibilityOptions_KeepImages">KeepImages</a>
        </td>
        <td class="markdown level1 summary"><p>Specifies whether images in a document dictionary are kept as <b>Image</b> objects.
Set this property to <b>false</b> to save images as raw data to optimize memory usage.</p>
</td>
      </tr>
      <tr>
        <td id="C1_C1Preview_CompatibilityOptions_StretchBarCodesAsImages" data-uid="C1.C1Preview.CompatibilityOptions.StretchBarCodesAsImages">
          <a class="xref" href="C1.C1Preview.CompatibilityOptions.StretchBarCodesAsImages.html#C1_C1Preview_CompatibilityOptions_StretchBarCodesAsImages">StretchBarCodesAsImages</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating whether to stretch barcodes as images.</p>
<p>The default value is false, which is compatible with previous versions.</p>
</td>
      </tr>
      <tr>
        <td id="C1_C1Preview_CompatibilityOptions_TopLevelPositionRelativeToPageMargins" data-uid="C1.C1Preview.CompatibilityOptions.TopLevelPositionRelativeToPageMargins">
          <a class="xref" href="C1.C1Preview.CompatibilityOptions.TopLevelPositionRelativeToPageMargins.html#C1_C1Preview_CompatibilityOptions_TopLevelPositionRelativeToPageMargins">TopLevelPositionRelativeToPageMargins</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating whether absolute coordinates of top-level
objects in the document are relative to page margins or to physical page
bounds.</p>
<p>
The default value of this property is <b>false</b>, which indicates the
traditional behavior with coordinates relative to page edges.
If set to <b>true</b>, coordinates are considered relative to page margins.
</p>
<p>
For instance, if this property is <b>false</b> (default), all page margins are 1 in,
and a top-level object's X coordinate is specified as ".5in", the object
would be located 0.5in from the left edge of the page - i.e. in the middle
of the left page margin.
</p>
<p>
If this property is set to <b>true</b>, the same object would be located 0.5in
to the right of the left page margin - 1.5in from the left edge of the page.
</p>
</td>
      </tr>
      <tr>
        <td id="C1_C1Preview_CompatibilityOptions_UseGdiLinesInPdfExport" data-uid="C1.C1Preview.CompatibilityOptions.UseGdiLinesInPdfExport">
          <a class="xref" href="C1.C1Preview.CompatibilityOptions.UseGdiLinesInPdfExport.html#C1_C1Preview_CompatibilityOptions_UseGdiLinesInPdfExport">UseGdiLinesInPdfExport</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating whether GDI functions should be used to draw lines when rendering for output to PDF.
The default value is false. Setting this property to true may result in much smaller file sizes in documents
containing many dashed/dotted lines.</p>
</td>
      </tr>
      <tr>
        <td id="C1_C1Preview_CompatibilityOptions_WhiteRtfBackground" data-uid="C1.C1Preview.CompatibilityOptions.WhiteRtfBackground">
          <a class="xref" href="C1.C1Preview.CompatibilityOptions.WhiteRtfBackground.html#C1_C1Preview_CompatibilityOptions_WhiteRtfBackground">WhiteRtfBackground</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the value indicating whether RTF objects fill the background with
white, or use the specified background color. The default is false.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="methods">Methods
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_C1Preview_CompatibilityOptions_AssignFrom_C1_C1Preview_CompatibilityOptions_" data-uid="C1.C1Preview.CompatibilityOptions.AssignFrom(C1.C1Preview.CompatibilityOptions)">
          <a class="xref" href="C1.C1Preview.CompatibilityOptions.AssignFrom.html#C1_C1Preview_CompatibilityOptions_AssignFrom_C1_C1Preview_CompatibilityOptions_">AssignFrom(CompatibilityOptions)</a>
        </td>
        <td class="markdown level1 summary"><p>Copies properties from another object into this object.</p>
</td>
      </tr>
      <tr>
        <td id="C1_C1Preview_CompatibilityOptions_Reset" data-uid="C1.C1Preview.CompatibilityOptions.Reset">
          <a class="xref" href="C1.C1Preview.CompatibilityOptions.Reset.html#C1_C1Preview_CompatibilityOptions_Reset">Reset()</a>
        </td>
        <td class="markdown level1 summary"><p>Resets properties of this object to default values.</p>
</td>
      </tr>
    </tbody>
  </table>

</div>