Class

# DesktopHTMLViewerPrintSettings

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

## Description

Settings that customize how `DesktopHTMLViewer.PrintToPDF<desktophtmlviewer.printtopdf>` renders a PDF, including the paper size, page orientation and margins.

Page widths, heights and margins are expressed in inches.

<div class="important">

<div class="title">

Important

</div>

This class is supported on macOS, Linux and Windows when using WebView2. It is not supported on Windows when using CEF.

</div>

## Properties

<div class="rst-class">

table-centered_columns_3_and_4

</div>

| Name                                                                            | Type                                                    | Read-Only | Shared |
|---------------------------------------------------------------------------------|---------------------------------------------------------|-----------|--------|
| `Landscape<desktophtmlviewerprintsettings.landscape>`                           | `Boolean</api/data_types/boolean>`                      |           |        |
| `MarginBottom<desktophtmlviewerprintsettings.marginbottom>`                     | `Double</api/data_types/double>`                        |           |        |
| `MarginLeft<desktophtmlviewerprintsettings.marginleft>`                         | `Double</api/data_types/double>`                        |           |        |
| `MarginRight<desktophtmlviewerprintsettings.marginright>`                       | `Double</api/data_types/double>`                        |           |        |
| `MarginTop<desktophtmlviewerprintsettings.margintop>`                           | `Double</api/data_types/double>`                        |           |        |
| `PageHeight<desktophtmlviewerprintsettings.pageheight>`                         | `Double</api/data_types/double>`                        |           |        |
| `PageWidth<desktophtmlviewerprintsettings.pagewidth>`                           | `Double</api/data_types/double>`                        |           |        |
| `PaperSize<desktophtmlviewerprintsettings.papersize>`                           | `PaperSizes<desktophtmlviewerprintsettings.papersizes>` |           |        |
| `PrintHeadersAndFooters<desktophtmlviewerprintsettings.printheadersandfooters>` | `Boolean</api/data_types/boolean>`                      |           |        |

## Enumerations

<div id="desktophtmlviewerprintsettings.papersizes">

<div class="rst-class">

forsearch

</div>

</div>

DesktopHTMLViewerPrintSettings.PaperSizes

### PaperSizes

> | Enum   | Description                                                                                             |
> |--------|---------------------------------------------------------------------------------------------------------|
> | Letter | US Letter paper size.                                                                                   |
> | Legal  | US Legal paper size.                                                                                    |
> | A3     | A3 paper size.                                                                                          |
> | A4     | A4 paper size.                                                                                          |
> | A5     | A5 paper size.                                                                                          |
> | Custom | Custom paper size. The page size and margins come from the PageWidth, PageHeight and margin properties. |

<div id="desktophtmlviewerprintsettings.landscape">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopHTMLViewerPrintSettings.Landscape

**Landscape** As `Boolean</api/data_types/boolean>`

> If `True</api/language/true>`, the PDF is printed in landscape orientation. The default is `False</api/language/false>` (portrait).

<div id="desktophtmlviewerprintsettings.marginbottom">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopHTMLViewerPrintSettings.MarginBottom

**MarginBottom** As `Double</api/data_types/double>`

> The bottom margin in inches. The default is 0.5. Only used when `PaperSize<desktophtmlviewerprintsettings.papersize>` is set to `Custom<desktophtmlviewerprintsettings.papersizes>`.

<div id="desktophtmlviewerprintsettings.marginleft">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopHTMLViewerPrintSettings.MarginLeft

**MarginLeft** As `Double</api/data_types/double>`

> The left margin in inches. The default is 0.5. Only used when `PaperSize<desktophtmlviewerprintsettings.papersize>` is set to `Custom<desktophtmlviewerprintsettings.papersizes>`.

<div id="desktophtmlviewerprintsettings.marginright">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopHTMLViewerPrintSettings.MarginRight

**MarginRight** As `Double</api/data_types/double>`

> The right margin in inches. The default is 0.5. Only used when `PaperSize<desktophtmlviewerprintsettings.papersize>` is set to `Custom<desktophtmlviewerprintsettings.papersizes>`.

<div id="desktophtmlviewerprintsettings.margintop">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopHTMLViewerPrintSettings.MarginTop

**MarginTop** As `Double</api/data_types/double>`

> The top margin in inches. The default is 0.5. Only used when `PaperSize<desktophtmlviewerprintsettings.papersize>` is set to `Custom<desktophtmlviewerprintsettings.papersizes>`.

<div id="desktophtmlviewerprintsettings.pageheight">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopHTMLViewerPrintSettings.PageHeight

**PageHeight** As `Double</api/data_types/double>`

> The page height in inches. The default is 11.0. Only used when `PaperSize<desktophtmlviewerprintsettings.papersize>` is set to `Custom<desktophtmlviewerprintsettings.papersizes>`.

<div id="desktophtmlviewerprintsettings.pagewidth">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopHTMLViewerPrintSettings.PageWidth

**PageWidth** As `Double</api/data_types/double>`

> The page width in inches. The default is 8.5. Only used when `PaperSize<desktophtmlviewerprintsettings.papersize>` is set to `Custom<desktophtmlviewerprintsettings.papersizes>`.

<div id="desktophtmlviewerprintsettings.papersize">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopHTMLViewerPrintSettings.PaperSize

**PaperSize** As `PaperSizes<desktophtmlviewerprintsettings.papersizes>`

> The paper size. The default is `Letter<desktophtmlviewerprintsettings.papersizes>`. When set to anything other than `Custom<desktophtmlviewerprintsettings.papersizes>`, the OS/WebView chooses the page size and margins, and the PageWidth, PageHeight and margin properties are ignored.

<div id="desktophtmlviewerprintsettings.printheadersandfooters">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DesktopHTMLViewerPrintSettings.PrintHeadersAndFooters

**PrintHeadersAndFooters** As `Boolean</api/data_types/boolean>`

> If `True</api/language/true>`, headers and footers are printed on each page. The default is `False</api/language/false>`.
>
> <div class="important">
>
> <div class="title">
>
> Important
>
> </div>
>
> This property is only supported on Windows.
>
> </div>