HiQPdf Next Library for .NET Documentation
Pdf
Properties
| AutoResizePdfPageHeight | When true, the PDF page is as tall as the HTML content, so the whole content is on one page; the page width comes from the page size or, when AutoResizePdfPageWidth is true, from the browser window. The browser window height is not used: the page is as tall as the content. The default value is false |
| AutoResizePdfPageWidth | When true, the PDF page width follows the browser window width, BrowserWidth times 0.75 points, and the HTML is drawn at BrowserZoom, 100 percent unless set. The window width and the zoom are then not computed by the layout methods: the values set are used, 1024 pixels and 100 percent by default. Setting the property back to false restores the layout of the last layout method called. When false, the page has the size given by PageSize and the HTML is laid out for that page. PageWidthFromBrowserWindow sets this property to true; the other layout methods set it to false. To make the page follow the browser window, prefer calling PageWidthFromBrowserWindow, which also sets the window width and the zoom. The default value is false |
| Bookmarks | The bookmarks added to the outline of the generated document, after the bookmarks created from the headings of the HTML document. The page numbers refer to the pages of the generated document, including the pages of the table of contents and of the PDF documents added before the HTML content, and the location in a page is given from the top left corner of the page |
| DigitalSignature | The digital signature to apply to generated PDF document |
| DisplayHeaderFooter | Indicates whether internal browser capabilities will be used to generate the header and footer based on the HeaderTemplate and FooterTemplate properties. This provides basic support for adding HTML with page numbering in the header and footer. For more advanced options, use the PdfHtmlHeader and PdfHtmlFooter properties instead. The default value is false |
| FirstPageTopMargin | The top margin of the first page in points, when the content of the first page starts lower than on the other pages, for a letterhead or a cover. A negative value, the default, gives the first page the same top margin as the other pages. A header shown on the first page keeps its space |
| FooterTemplate | The HTML template used for the PDF document footer. It should be valid HTML markup and may include the following CSS classes to inject dynamic values: date (formatted print date), title (document title), url (document location), pageNumber (current page number) and totalPages (total number of pages). For example, <span class="title"></span> will render a span containing the document title. This template is used only if the DisplayHeaderFooter property is true. For advanced scenarios, use the PdfHtmlFooter property. If null or empty, a default template will be applied |
| GenerateDocumentOutline | Controls if the generated PDF document will have an outline with bookmarks created from HTML heading tags (H1 to H6) or from any element marked with the data-heading attribute. Any element can become a bookmark with data-heading set to a level from 1 to 6 (for example data-heading="2"), the bookmark title is taken from the data-heading-text attribute when present otherwise from the element text. A real heading can be excluded with data-heading="false". The custom data-heading attribute is honored only in custom mode when UseBrowserOutlineMode is false. The default is false |
| GeneratePdfFormFields | Gets or sets a value indicating whether HTML form controls are converted into interactive PDF form fields |
| GenerateTableOfContents | Controls if a table of contents is automatically created in the PDF document from HTML heading tags (H1 to H6) or from any element marked with the data-heading attribute. The table of contents appearance and behavior are controlled by the options exposed through the TableOfContents property. The default is false |
| HeaderTemplate | The HTML template used for the PDF document header. It should be valid HTML markup and may include the following CSS classes to inject dynamic values: date (formatted print date), title (document title), url (document location), pageNumber (current page number) and totalPages (total number of pages). For example, <span class="title"></span> will render a span containing the document title. This template is used only if the DisplayHeaderFooter property is true. For advanced scenarios, use the PdfHtmlHeader property. If null or empty, a default template will be applied |
| Margins | The PDF document margins. By default all the margins are 0 |
| MaxPageCount | The maximum number of PDF pages to create. The default value is 0 to convert the entire HTML document to PDF |
| OpenAction | The action executed by the viewer when the generated document is opened: go to a page at a given location and zoom, go to a named destination, run JavaScript, a viewer action or open a web address. When null, the document has no open action. The default is null |
| OutlineHeadingSelectors | The CSS selectors of the elements that become bookmarks of the document outline, one selector for each level: the first selector gives the level 1 bookmarks, the second one the level 2 bookmarks and so on, up to level 6. When this property is set the H1 to H6 headings and the data-heading attribute no longer select the bookmarks, an element still being excluded with data-heading="false" and its title still being taken from data-heading-text when present. The selectors are honored in custom mode when UseBrowserOutlineMode is false. The default is null, the bookmarks being created from the headings of the document |
| PageOrientation | The PDF document pages orientation. The default orientation is Portrait |
| PageSize | This property controls the page size of the PDF document generated by the HTML to PDF converter. When AutoResizePdfPageWidth is true (the default value is false), the converter automatically resizes the PDF page width to match the BrowserWidth value at the default 96 DPI resolution. When AutoResizePdfPageHeight is true (the default value is false), the converter automatically resizes the PDF page height to match the HTML content height at the default 96 DPI resolution. The page has this exact size when both properties are false. The default size of the PDF document page is A4 |
| PdfFormOptions | Gets the options used to convert HTML form controls into interactive PDF form fields |
| PdfHtmlFooter | The generated PDF document footer based on a HTML template given by Html and HtmlBaseUrl properties or by the HtmlSourceUrl property |
| PdfHtmlHeader | The generated PDF document header based on a HTML template given by Html and HtmlBaseUrl properties or by the HtmlSourceUrl property |
| PdfStandard | Gets or sets the PDF standards compliance level for the generated document. The default is None which means plain PDF without tagging |
| PreferCssPageSize | When true, a @page size rule in the HTML sets the PDF page size instead of PageSize. The default value is false |
| PrintBackgrounds | Controls if background graphics are printted by HTML to PDF converter. The default is true |
| Properties | Controls the title, subject, keywords, author and the creation date of the PDF document |
| RepeatTableHeaderFooter | Enables automatic repetition of HTML table header (thead) and footer (tfoot) sections on each page when converting the HTML to PDF. It is useful for long tables that span multiple pages, ensuring headers and footers remain visible throughout. Styling rules intended for print layout will be applied when rendering the repeated sections. The default value is false |
| Security | The object exposed by this property can be used to password protect the PDF document, disable printing, copying or editing of the PDF document |
| TableOfContents | The table of contents options controlling the title, style, page numbers, inline placement and creation mode. To enable the creation of the table of contents from HTML heading tags or data-heading elements, set the GenerateTableOfContents property to true |
| UseBrowserOutlineMode | Controls if the document outline is created in browser mode. The custom data-heading, data-heading-text and data-heading="false" attributes and the OutlineHeadingSelectors are honored only in custom mode. In browser mode only the standard H1 to H6 heading tags are used. The default is false |
| Viewer | Controls the PDF viewer preferences |