|
|
|
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 - A flag used only by WebKitRestricted, Blink or Chromium engines indicating if the content height can be recalculated to better fit the page. This can introduce certain errors in some cases. The default is True. Set it to False if content is split to more pages than expected.
Authentication - Handles authentication options if the web page being converted requires authentication. This was covered in more details in Web Page Authentication section.
AutoFitHeight - Specifies the html content vertical auto fit mode. This was covered in more details in Resizing Content During Conversion section.
AutoFitWidth - Specifies the html content horizontal auto fit mode. This was covered in more details in Resizing Content During Conversion section.
BlinkEngineLaunchMaxTries - Blink engine process launch tries. Note: This is used only by the Blink rendering engine.
BlinkEngineLaunchTimeout - Blink engine process launch timeout. Note: This is used only by the Blink rendering engine.
BlinkEnginePath - Gets or sets the full path (excluding the chrome.exe file name) of the Blink html rendering engine binaries.
BlinkEngineTemporaryFilesPath - Gets or sets the full path of a folder where Blink html rendering engine will write temporary files. Note: Write permissions need to be enabled for this folder.
BlinkMaxThreadPoolWorkers - Upper bound for the ThreadPool worker-thread floor that the Blink engine raises to keep concurrent browser launches from starving (sized to the in-flight conversion count plus headroom). Set to 0 to disable this auto-tuning. Note: This is used only by the Blink rendering engine.
CefEnginePath - Gets or sets the full path of the directory containing the SelectPdf.Cef.exe binary. Note: This is used only by the Chromium rendering engine.
CefEngineTemporaryFilesPath - Gets or sets the full path of a folder where the CEF rendering engine will write temporary files. Note: Write permissions need to be enabled for this folder. This is used only by the Chromium rendering engine.
ClickElementsDelayAfter - Delay in miliseconds, after element click. Note: This is used only by the Blink or Chromium rendering engine.
ClickElementsDelayBefore - Delay in miliseconds, before element click. Note: This is used only by the Blink or Chromium rendering engine.
ClickElementsSelectors - Specifies elements from the web page that will be clicked before converting the page. Note: This is used only by the Blink or Chromium rendering engine.
ColorSpace - Gets or sets the color space of the generated pdf document. This is an instance of PdfColorSpace type.
CssMediaType - Indicates what css styles are used when the web page is rendered. This was covered in more details in Media Types section.
CustomCSS - Use this property to specify some CSS styles that will be injected into the page that is converted. Note: This is used only by the Blink or Chromium rendering engine.
DenyLocalFileAccess - A flag indicating if local files can be loaded during the conversion. The default value is False and local files can be loaded.
DisplayCutText - Gets or sets a flag indicating if the text that is out of the calculated rendering rectangle is displayed or not. The default value for this property is False.
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.
DrawBackground - Gets or sets a flag indicating if the web page background is rendered in pdf. The default value for this property is true and the page background is rendered into the generated pdf.
EmbedFonts - Instructs the converter to embed all the needed fonts into the pdf document or not.
EnableOfflineMode - Put the browser into offline mode before navigation, so all network requests fail. Useful for testing offline fallbacks or blocking all external fetches from cached content. Note: Honored by the Blink and Chromium rendering engines.
ExternalBrowserEndpoint - External browser service. Note: This is used only by the Blink rendering engine.
ExternalLinksEnabled - Controls the rendering of external hyperlinks in pdf. This was covered in more details in Internal and External Links section.
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.
KeepImagesTogether - This property instructs the converter whether to try to avoid cutting off the images between pdf pages or not. This was covered in more details in Page Breaks section.
KeepTextsTogether - This property instructs the converter whether to try to avoid cutting off the text lines between pdf pages or not. This was covered in more details in Page Breaks section.
LazyImagesLoadingDelay - Delay per page, in miliseconds, for lazy images loading. The default value is 50 ms. Note: Honored by the Blink and Chromium rendering engines.
LazyImagesLoadingEnabled - Enables a delay mechanism to allow images to fully load. Note: Honored by the Blink and Chromium rendering engines.
LoginOptions - Handle custom page login. Note: This is used only by the Blink or Chromium rendering engine.
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. Note: This is used only by the Chromium rendering engine.
ManagedContentTrimmingMode - Gets or sets how the rendering engine reports where the rendered 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 rendered, so what the page paints outside its layout, such as a shadow or a positioned decoration, is kept, together with the space the last element leaves below itself. With Marker, the content ends where the page's layout ends, the way earlier versions cut; something painted outside the layout can be cut. Only the last page is affected: the pages before it are the same in both modes. An engine that does not support the Ink mode uses the Marker mode. Note: This is used only by the Chromium rendering engine.
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 - Timeout in seconds for the print / capture phase (producing the PDF after the page has loaded). Applies to the Chromium rendering engine only. Default value is 60 seconds.
MaxPageLoadTime - The web page navigation timeout in seconds. This was covered in more details in Conversion Delay and Timeout section.
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 4. If the maximum number is reached and more conversion requests arrive, they will wait in a queue for an available spot.
MinPageLoadTime - An additional time in seconds to wait for asynchronous items to be loaded before the web page is rendered. This was covered in more details in Conversion Delay and Timeout section.
PageBreaksEnhancedAlgorithm - Gets or sets a flag indicating if an enhanced custom page breaks algorithm is used. The enhanced algorithm is a little bit slower but it will prevent the appearance of hidden text in the PDF when custom page breaks are used. The default value for this property is False.
PageRanges - Restrict the generated PDF to a subset of pages, e.g. "1", "2-4", "1-3,5,7-". Note: Honored by the Blink and Chromium rendering engines.
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.
PluginsEnabled - A flag indicating if plugins (like Flash players) are enabled in the converter.
PostLoadingScript - Use this property to specify some JavaScript code that will be injected into the page that is converted and executed after the page was fully loaded. Note: This is used only by the Blink or Chromium rendering engine.
PostLoadingScriptDelayAfter - Delay in miliseconds, after post page loading javascript injection. Note: This is used only by the Blink or Chromium rendering engine.
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 - A flag indicating if the page is rendered even if a navigation timeout occurs. The default value is False and a navigation timeout exception is raised.
RenderingEngine - Selects the HTML rendering engine used by the converter (WebKit, WebKitRestricted, Blink, or Chromium). This was covered in more details in Rendering Engines and Chromium Engine sections.
ScaleImages - A flag indicating if the images from the page are scaled during the conversion process. The default value is False and images are not scaled.
SecureProtocol - Protocol used for secure (HTTPS) connections.
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 - Controls WebGL support in the rendering engine. The default value is False: the engine skips the software graphics initialization it would otherwise perform for every conversion, which makes the conversion noticeably faster. Set it to True for pages whose content is drawn with WebGL, which otherwise does not render. Available with the Chromium and Blink rendering engines, starting with v26.4. This was covered in more details in Chromium Engine section.
WebPageFixedSize - Controls whether the content below the web page height 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 - If set, the converter waits for window.status to match this string before capturing the page. Useful for pages that signal readiness via the classic window.status = "ready" handshake. Note: Honored by the Blink and Chromium rendering engines.