# GrapeCity.Documents.Word.Layout.PdfOutputSettings

## Content

<div class="doc-site-dotnet-api-container">



  <h1 id="GrapeCity_Documents_Word_Layout_PdfOutputSettings" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings" class="text-break">PdfOutputSettings Class
</h1>
  <div class="markdown level0 summary"><p>Options used for saving a <a class="xref" href="GrapeCity.Documents.Word.Layout.GcWordLayout.html">GcWordLayout</a> in PDF format.</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">PdfOutputSettings</span></div>
  </div>
  <h6><strong>Namespace</strong>: <a class="xref" href="GrapeCity.Documents.Word.Layout.html">GrapeCity.Documents.Word.Layout</a></h6>
  <h6><strong>Assembly</strong>: DS.Documents.Word.dll</h6>
  <h5 id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_syntax">Syntax</h5>
  <div class="codewrapper">
    <pre><code class="lang-csharp hljs">public class PdfOutputSettings</code></pre>
  </div>
  <div class="codewrapper">
    <pre><code class="lang-vbnet hljs">Public Class PdfOutputSettings</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="GrapeCity_Documents_Word_Layout_PdfOutputSettings__ctor" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.#ctor">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.-ctor.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings__ctor">PdfOutputSettings()</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="GrapeCity_Documents_Word_Layout_PdfOutputSettings_BackColor" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.BackColor">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.BackColor.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_BackColor">BackColor</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the background color. The default is white.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_CompressionLevel" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.CompressionLevel">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.CompressionLevel.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_CompressionLevel">CompressionLevel</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the compression level.</p>
<p>The default value is <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.io.compression.compressionlevel#system-io-compression-compressionlevel-optimal">Optimal</a>.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_ConformanceLevel" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.ConformanceLevel">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.ConformanceLevel.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_ConformanceLevel">ConformanceLevel</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the PDF/A conformance level for the exported document.</p>
<p>
The default value is <span class="xref">GrapeCity.Documents.Pdf.PdfAConformanceLevel.None</span>.
</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_DocumentInfo" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.DocumentInfo">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.DocumentInfo.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_DocumentInfo">DocumentInfo</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a <span class="xref">GrapeCity.Documents.Pdf.DocumentInfo</span> object containing
information about the document (author, title, etc).
See <span class="xref">GrapeCity.Documents.Pdf.GcPdfDocument.DocumentInfo</span> for details.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_ExportStructureTags" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.ExportStructureTags">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.ExportStructureTags.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_ExportStructureTags">ExportStructureTags</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets whether logical structure information is included when exporting the document to PDF.
When enabled, the exported document contains structure tags (a structure tree),
producing a tagged PDF that improves accessibility and navigation for screen readers
and other assistive technologies.</p>
<p>
The default value is <a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">false</a>.
</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_ImageOptions" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.ImageOptions">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.ImageOptions.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_ImageOptions">ImageOptions</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets an <span class="xref">GrapeCity.Documents.Pdf.ImageOptions</span>
object that contains options controlling how images are processed
in the generated PDF.
See <span class="xref">GrapeCity.Documents.Pdf.GcPdfDocument.ImageOptions</span> for details.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_Linearized" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.Linearized">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.Linearized.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_Linearized">Linearized</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating whether the generated PDF should be saved as linearized.
See <span class="xref">GrapeCity.Documents.Pdf.GcPdfDocument.Linearized</span> for details.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_MarkAsPdfUa" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.MarkAsPdfUa">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.MarkAsPdfUa.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_MarkAsPdfUa">MarkAsPdfUa</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets whether the exported PDF document should be marked as PDF/UA compliant.</p>
<p>
The default value is <a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">false</a>.
</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_MarkupTemplateTags" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.MarkupTemplateTags">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.MarkupTemplateTags.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_MarkupTemplateTags">MarkupTemplateTags</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a method to be executed for each PDF page during export,
allowing custom markup to be added to template tags on the page.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_Metadata" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.Metadata">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.Metadata.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_Metadata">Metadata</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a metadata object associated with the generated PDF.
See <span class="xref">GrapeCity.Documents.Pdf.GcPdfDocument.Metadata</span> for details.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_MissingDocumentTitle" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.MissingDocumentTitle">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.MissingDocumentTitle.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_MissingDocumentTitle">MissingDocumentTitle</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the placeholder used as the document title for accessible PDF export
if <a class="xref" href="GrapeCity.Documents.Word.Layout.GcWordLayout.Title.html#GrapeCity_Documents_Word_Layout_GcWordLayout_Title">Title</a> has not been set when exporting the document to PDF.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_MissingHyperlinkScreenTip" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.MissingHyperlinkScreenTip">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.MissingHyperlinkScreenTip.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_MissingHyperlinkScreenTip">MissingHyperlinkScreenTip</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the placeholder used as annotation content for accessible PDF export
if <a class="xref" href="GrapeCity.Documents.Word.Hyperlink.ScreenTip.html#GrapeCity_Documents_Word_Hyperlink_ScreenTip">ScreenTip</a> has not been set when exporting the document to PDF.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_MissingShapeAlternativeText" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.MissingShapeAlternativeText">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.MissingShapeAlternativeText.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_MissingShapeAlternativeText">MissingShapeAlternativeText</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the placeholder used as alternative text for accessible PDF export
if <a class="xref" href="GrapeCity.Documents.Word.ShapeBase.AlternativeText.html#GrapeCity_Documents_Word_ShapeBase_AlternativeText">AlternativeText</a> has not been set when exporting the document to PDF.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_PdfVersion" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.PdfVersion">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.PdfVersion.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_PdfVersion">PdfVersion</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the PDF Version of the generated document.
See <span class="xref">GrapeCity.Documents.Pdf.GcPdfDocument.PdfVersion</span> for details.</p>
<p>
By default the version is determined automatically based on which features are used in this document.
Setting this property to a non-null string in the format "1.X"
(where X is a digit from 0 to 9) overrides the automatic value with the specified one.
</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Layout_PdfOutputSettings_SecurityHandler" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.SecurityHandler">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.SecurityHandler.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_SecurityHandler">SecurityHandler</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets an instance of a class derived from <span class="xref">GrapeCity.Documents.Pdf.Security.SecurityHandlerBase</span> used to encrypt the PDF.</p>
<p>
Use the <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.CreateSecurityHandler.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_CreateSecurityHandler_System_String_">CreateSecurityHandler(string)</a> method to initialize this property or create and assign the handler directly.
</p>
<p>
For example, the following code may be used to password protect the PDF:
<pre><code class="lang-csharp">wordLayout.SaveAsPdf("output.pdf", null, new PdfOutputSettings
{
    SecurityHandler = new StandardSecurityHandlerRev6
    {
        UserPassword = "231",
        OwnerPassword = "#%f8JK",
        PrintingPermissions = PrintingPermissions.Disabled,
        EditingPermissions = EditingPermissions.Disabled,
        CopyContent = false
    }
});</code></pre>

</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="GrapeCity_Documents_Word_Layout_PdfOutputSettings_CreateSecurityHandler_System_String_" data-uid="GrapeCity.Documents.Word.Layout.PdfOutputSettings.CreateSecurityHandler(System.String)">
          <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.CreateSecurityHandler.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_CreateSecurityHandler_System_String_">CreateSecurityHandler(string)</a>
        </td>
        <td class="markdown level1 summary"><p>Creates an instance of <span class="xref">GrapeCity.Documents.Pdf.Security.StandardSecurityHandlerRev6</span> and assigns it to <a class="xref" href="GrapeCity.Documents.Word.Layout.PdfOutputSettings.SecurityHandler.html#GrapeCity_Documents_Word_Layout_PdfOutputSettings_SecurityHandler">SecurityHandler</a>.</p>
</td>
      </tr>
    </tbody>
  </table>

</div>
