Html To Pdf Converter Options Review | |
Select.Pdf Html to Pdf Converter for .NET offers a lot of customization options. Most of them were described in our developer's guide.
Here is a full list with all html to pdf converter options:
Header - controls the properties of the custom header of the generated pdf document. This was covered in more details in Headers and Footers section.
Footer - controls the properties of the custom footer of the generated pdf document. This was covered in more details in Headers and Footers section.
AllowContentHeightResize - Controls whether the page the content ends on is shortened to where the content ends. The default value is True. Set it to False to keep every page of the rendered document at its full height.
Authentication - Handles authentication options if the web page being converted requires authentication. This was covered in more details in Web Page Authentication section.
ChromiumEnginePath - The full path of the folder containing the Chromium engine binaries. Set it only when the engine is not deployed next to the application. This was covered in more details in the Chromium Engine section.
ChromiumEngineTemporaryFilesPath - A folder where the Chromium engine writes its temporary files. When not set, the system temporary folder is used. The application needs write permissions on this folder.
ClickElementsSelectors - CSS selectors of web page elements that are clicked before the page is converted, for example the close button of a cookie banner that covers the content.
ClickElementsDelayBefore - The delay in milliseconds before each element click. The default value is 20 ms.
ClickElementsDelayAfter - The delay in milliseconds after each element click. The default value is 200 ms.
ColorSpace - Gets or sets the color space of the generated pdf document. This is an instance of PdfColorSpace type.
ConversionDelay - An additional time in seconds the converter waits after the web page has loaded, before it is rendered. This was covered in more details in Conversion Delay and Timeout section.
CssMediaType - Indicates what css styles are used when the web page is rendered. This was covered in more details in Media Types section.
CustomCSS - CSS styles injected into the converted page, for example to hide an element or to change fonts for print.
DenyLocalFileAccess - Prevents the converted page from loading local files. The default value is False. Set it to True when converting HTML that is not trusted; see Security Recommendations.
DisplayFooter - Controls if a custom footer is displayed in the generated pdf document. This was covered in more details in Headers and Footers section.
DisplayHeader - Controls if a custom header is displayed in the generated pdf document. This was covered in more details in Headers and Footers section.
The converter always embeds the fonts needed to render the document, so the text displays correctly on any machine even when those fonts are not installed.
DrawBackground - Controls whether the web page background is rendered in the pdf document. The default value is True.
EnableOfflineMode - Puts the internal browser in offline mode, so every network request made by the page fails. Useful to convert an HTML string that must not reach the network. The default value is False.
ExternalLinksEnabled - Controls the rendering of external hyperlinks in pdf. This was covered in more details in Internal and External Links section.
ForceOutOfProcess - Runs this conversion in a separate engine process, whatever ChromiumEngineHostMode selects for the application. Use it to isolate a page that is not trusted, or likely to crash or hang the browser, or to give one conversion settings the in-process host fixes for the whole process at its first conversion (WebGL, the proxy). It costs the start of an engine process. The default value is False.
HttpCookies - Gets the collection of custom HTTP cookies used for the conversion. This was covered in more details in HTTP Cookies section.
HttpHeaders - Get the collection of custom HTTP headers used for the conversion. This was covered in more details in HTTP Headers section.
HttpPostParameters - Gets the collection of custom HTTP POST parameters used for the conversion.. This was covered in more details in HTTP POST Request section.
InternalLinksEnabled - Controls the conversion of internal html links to internal pdf links. This was covered in more details in Internal and External Links section.
JavaScriptEnabled - Enable scripts when rendering the url or html string.
JpegCompressionEnabled - Gets or sets a flag indicating if the JPEG compression is enabled or not for the images in the generated pdf document.
JpegCompressionLevel - Gets or sets the compression level of images in the generated pdf document.
LazyImagesLoadingEnabled - Scrolls through the page before it is converted, so images and content that load when they are scrolled into view are present in the pdf document. The default value is True.
LazyImagesLoadingDelay - The delay in milliseconds after each scroll step when LazyImagesLoadingEnabled is True. The default value is 40 ms. Increase it for pages whose lazy content loads slowly.
LFN - The path of a diagnostic log file written during the conversion. When not set, no log is written.
LoginOptions - Fills in and submits a login form before the page is converted. This was covered in more details in Web Page Authentication section.
ManagedContentTrimming - Gets or sets whether the library decides where the rendered content ends on each page. The default value is True. With True, the page the content ends on is drawn only down to where the content ends, on a document of any length. With False, the page is shortened to the content only when the whole content fits on one page. Set it to False if pages are cut in the wrong place.
ManagedContentTrimmingMode - Gets or sets how the rendering engine finds where the content ends when ManagedContentTrimming is True. The default value is Ink. With Ink, the engine measures where the last painted content is after the page is printed, so everything the page paints is kept. With Marker, the content ends where the page's layout ends, the way earlier versions cut; something painted outside the layout, such as a shadow or a positioned decoration, can be cut.
MarginBottom - The bottom margin of the pdf document. The margin is specified in points. 1 point is 1/72 inch.
MarginLeft - The left margin of the pdf document. The margin is specified in points. 1 point is 1/72 inch.
MarginRight - The right margin of the pdf document. The margin is specified in points. 1 point is 1/72 inch.
MarginTop - The top margin of the pdf document. The margin is specified in points. 1 point is 1/72 inch.
MaxConversionTime - The time in seconds allowed for rendering the pdf document after the page has loaded. The default value is 60 seconds. NavigationTimeout limits the page load before it.
MaximumConcurrentConversions - This parameter must be set before the first conversion performed by the application. When this property is set with a negative value or zero, the concurrency level is maximum. The default value is 8. If the maximum number is reached and more conversion requests arrive, they wait in a queue for an available spot and are served in the order they arrived. The limit applies whichever way the engine is hosted (see ChromiumEngineHostMode).
NavigationTimeout - The time in seconds the converter waits for the web page to load. This was covered in more details in Conversion Delay and Timeout section.
PageRanges - Restricts the generated pdf document to some of the rendered pages, for example "1", "2-4" or "1-3,5,7-". An empty string (the default) keeps all pages.
PdfBookmarkOptions - Gets a reference to the object that controls the bookmarks creation for the generated pdf document. This was covered in more details in Automatic Bookmarks section.
PdfCompressionLevel - This property controls the compression level of the generated pdf document.
PdfDocumentInformation - Gets a reference to the object that specifies the generated pdf document properties. This was covered in more details in Pdf Document Properties section.
PdfPageCustomSize - This property can be used to specify a custom pdf document page size. This was covered in more details in Setting Pdf Page Properties section.
PdfPageOrientation - This property controls the page orientation of the generated pdf document pages. This was covered in more details in Setting Pdf Page Properties section.
PdfPageSize - This property controls the size of the generated document pages. This was covered in more details in Setting Pdf Page Properties section.
PdfStandard - Defines the pdf standard used by the generated pdf document. This is an instance of PdfStandard type. Use it to generate archival documents (PDF/A-1b, PDF/A-2b, PDF/A-3b, PDF/A-3u, PDF/A-4, PDF/A-4e or PDF/A-4f) or PDF/X-1a print documents.
PostLoadingScript - JavaScript code injected into the converted page and run after the page has loaded and after its own scripts.
PostLoadingScriptDelayAfter - The delay in milliseconds after the post-loading script runs. The default value is 20 ms.
ProxyOptions - Gets a reference to an object containing the proxy settings used to access the web page that is being converted. This was covered in more details in Proxy Options section.
RenderPageOnTimeout - Renders the page as far as it has loaded when NavigationTimeout expires, instead of failing the conversion. The default value is False. This was covered in more details in Conversion Delay and Timeout section.
RenderingEngine - Selects the HTML rendering engine used by the converter. The only value is RenderingEngine.Chromium, which is also the default, so this normally does not need to be set. This was covered in more details in the Chromium Engine section.
SecurityOptions - Gets a reference to the object that specifies the generated pdf document security settings. This was covered in more details in Pdf Security Settings section.
ViewerPreferences - Controls how the pdf document will appear in a pdf viewer (like Adobe Reader). This was covered in more details in Pdf Viewer Preferences section.
WebGlEnabled - Gets or sets a flag indicating if WebGL is enabled in the internal browser. The default value is False; set it to True for pages that draw with WebGL. Turning it off makes conversions noticeably faster, at the cost of not being able to render WebGL content. This was covered in more details in Chromium Engine section.
HttpCache - Selects what the engine's HTTP cache keeps from this conversion for the next one: All (the default) keeps everything, ThirdParty keeps only resources from other sites than the converted page's own (fonts, style sheets and scripts served from content delivery networks, for example), and Clear starts every conversion with an empty cache. Keeping the cache makes later conversions of pages that share resources faster. It applies when the engine runs inside the application; a conversion in its own engine process always starts with an empty cache. Cookies and site storage are cleared after every conversion whatever the mode.
WebPageFixedSize - Controls whether the content below WebPageHeight is left out of the generated pdf document. This was covered in more details in Resizing Content During Conversion section.
WebPageHeight - Gets or sets the height of the converted web page as it would appear in the internal browser used to render the html. This was covered in more details in Resizing Content During Conversion section.
WebPageWidth - Gets or sets the width of the converted web page as it would appear in the internal browser used to render the html. This was covered in more details in Resizing Content During Conversion section.
WindowStatus - When set, the converter waits until the page sets window.status to this value before converting it. If that does not happen before NavigationTimeout expires, the conversion fails with a navigation timeout.