Click or drag to resize

HtmlToPdfArea Class

A HTML string or URL to be added to the header or footer of the rendered PDF document. The PdfConverter.PdfHeaderOptions.HtmlToPdfArea property should be set with an object of this type.
Inheritance Hierarchy
SystemObject
  ExpertPdf.HtmlToPdfPdfElement
    ExpertPdf.HtmlToPdfHtmlToPdfArea

Namespace:  ExpertPdf.HtmlToPdf
Assembly:  ephtmltopdf (in ephtmltopdf.dll) Version: 17.0.0
Syntax
public class HtmlToPdfArea : PdfElement

The HtmlToPdfArea type exposes the following members.

Constructors
  NameDescription
Public methodHtmlToPdfArea(String)
Create a URL to PDF converter element at the specified x and y coordinates with the specified width and height. The URL to converter is given by the urlToConvert parameter. The virtual browser width and height in pixels are specified by the htmlViewerWidth and htmlViewerHeight parameters.
Public methodHtmlToPdfArea(String, String)
Create a HTML string to PDF converter element at the specified x and y coordinates with the specified width. The HTML string to convert is given by the htmlStringToConvert parameter. The virtual browser width and height in pixels are specified by the htmlViewerWidth and htmlViewerHeight parameters.
Public methodHtmlToPdfArea(Single, Single, String)
Create a URL to PDF converter element at the specified x and y coordinates with the specified width and height. The URL to converter is given by the urlToConvert parameter. The virtual browser width and height in pixels are specified by the htmlViewerWidth and htmlViewerHeight paramenters.
Public methodHtmlToPdfArea(Single, Single, Single, String)
Create a URL to PDF converter element at the specified x and y coordinates with the specified width and height. The URL to converter is given by the urlToConvert parameter. The virtual browser width and height in pixels are specified by the htmlViewerWidth and htmlViewerHeight paramenters.
Public methodHtmlToPdfArea(Single, Single, String, String)
Create a HTML string to PDF converter element at the specified x and y coordinates with the specified width. The HTML string to convert is given by the htmlStringToConvert parameter. The virtual browser width and height in pixels are specified by the htmlViewerWidth and htmlViewerHeight paramenters.
Public methodHtmlToPdfArea(Single, Single, Single, String, Int32)
Create a URL to PDF converter element at the specified x and y coordinates with the specified width and height. The URL to converter is given by the urlToConvert parameter. The virtual browser width and height in pixels are specified by the htmlViewerWidth and htmlViewerHeight paramenters.
Public methodHtmlToPdfArea(Single, Single, Single, String, String)
Create a HTML string to PDF converter element at the specified x and y coordinates with the specified width. The HTML string to convert is given by the htmlStringToConvert parameter. The virtual browser width and height in pixels are specified by the htmlViewerWidth and htmlViewerHeight paramenters.
Public methodHtmlToPdfArea(Single, Single, Single, String, Int32, Int32)
Create a URL to PDF converter element at the specified x and y coordinates with the specified width and height. The URL to converter is given by the urlToConvert parameter. The virtual browser width and height in pixels are specified by the htmlViewerWidth and htmlViewerHeight paramenters.
Public methodHtmlToPdfArea(Single, Single, Single, String, String, Int32)
Create a HTML string to PDF converter element at the specified x and y coordinates with the specified width. The HTML string to convert is given by the htmlStringToConvert parameter. The virtual browser width and height in pixels are specified by the htmlViewerWidth and htmlViewerHeight paramenters.
Public methodHtmlToPdfArea(Single, Single, Single, Single, String, Int32, Int32)
Create a URL to PDF converter element at the specified x and y coordinates with the specified width and height. The URL to converter is given by the urlToConvert parameter. The virtual browser width and height in pixels are specified by the htmlViewerWidth and htmlViewerHeight paramenters.
Public methodHtmlToPdfArea(Single, Single, Single, String, String, Int32, Int32)
Create a HTML string to PDF converter element at the specified x and y coordinates with the specified width. The HTML string to convert is given by the htmlStringToConvert parameter. The virtual browser width and height in pixels are specified by the htmlViewerWidth and htmlViewerHeight paramenters.
Public methodHtmlToPdfArea(Single, Single, Single, Single, String, String, Int32, Int32)
Create a HTML string to PDF converter element at the specified x and y coordinates with the specified width. The HTML string to convert is given by the htmlStringToConvert parameter. The virtual browser width and height in pixels are specified by the htmlViewerWidth and htmlViewerHeight paramenters.
Top
Properties
  NameDescription
Public propertyAddPadding
Add padding at the end of the conversion result. Default is false.
Public propertyAdjustBorderSize
There are situations when a fraction of the right and bottom borders of an image or table cell are overwritten by the image content or table cell background when the PDF document is viewed with Adobe Reader. The AdjustBorderSize value is subtracted from the background width and height. The default value is 0 points.
Public propertyAllowLocalAccess
A flag indicating if local files can be loaded during the conversion. The default value is True and local files can be loaded.
Public propertyAlphaBlendEnabled
Enables or disables alpha blending for transparent images. Default is true.
Public propertyAuthenticationOptions
Server authentication options (e.g IIS authentication)
Public propertyAvoidImageBreak
When true this property instructs the converter to try to avoid cutting off the images between PDF pages
Public propertyAvoidTextBreak
When true this property instructs the converter to try to avoid cutting off the text between PDF pages
Public propertyBatchConversion
Set this true when using the converter for batch conversion in a loop
Public propertyBehaviorsEnabled
Enable behaviors when rendering HTML to image. Default is false.
Public propertyBinaryBehaviorsEnabled
Internal use. Default is false.
Public propertyBkgTransparency
Modify background transparency. 0 means transparent, 100 means opaque.
Public propertyBlinkEnginePath
Gets or sets the full path (excluding the chrome.exe file name) of the Blink html rendering engine binaries.
Public propertyBlinkEngineTemporaryFilesPath
Gets or sets the full path of a folder where Blink html rendering engine will write temporary files.
Public propertyCacheFolder
Use this property to enable caching of web requests. Sets the full path of the local cache folder. Note: This is used only by the WebKit rendering engine.
Public propertyClickElementsDelayAfter
Delay in miliseconds, after element click.
Public propertyClickElementsDelayBefore
Delay in miliseconds, before element click.
Public propertyClickElementsSelectors
Specifies elements from the web page that will be clicked before converting the page.
Public propertyClipHtmlView
If the HTML content is not entirely visible in the HTML viewer at the specified width, the ClipHtmlView property will control whether the HTML content is clipped or the HTML viewer width is automatically extended to make visible the whole HTML content. The HTML viewer width is given by the PageWidth property. The default value of this property is false. Note: This is used only by the WebKit rendering engine.
Public propertyConsoleLog
Returns the console log of the browser used to render the web page.
Public propertyConversionDelay
An additional time in seconds to wait for asynchronous items to be loaded
Public propertyCustomCSS
Use this property to specify some CSS styles that will be injected into the page that is converted.
Public propertyDrawBackground
Gets or sets a flag indicating if the HTML page background is rendered in PDF. Default value is true. Setting this property to false can make visible the existing PDF content behind this element.
Public propertyDrawTextInsideRectangle
Internal use only.
Public propertyDrawTransparenciesThreshold
Internal use.
Public propertyEmbedFonts
When true this options instructs the converter to embed all the true type fonts into the PDF document. The default value is false.
Public propertyExternalBrowserEndpoint
External browser service.
Public propertyFitHeight
When this property is true the HTML content will be resized if necessary to fit the available height in PDF page. By default this property is false.
Public propertyFitWidth
When this property is true the HTML content will be resized if necessary to fit the available width in PDF page. When false the HTML content will be rendered at the real size. By default this property is true and the content will be resized if necessary to fit the available width in PDF page
Public propertyFontTempFolder
Use this property to specify the path where temporary font files are saved. If this is not specified, the system temporary folder is used. Note: This is used only by the WebKit rendering engine.
Public propertyHtmlViewerHeight
Gets or sets the HTML viewer height in pixels. If the viewer width was not set, this property has no effect
Public propertyHtmlViewerWidth
Gets or sets the HTML viewer width in pixels
Public propertyHttpCookies
Gets a collection of custom HTTP cookies to be sent by the converter to the web server when the web page to convert and the resources (image, css, etc) referenced by the web page are requested. A cookie is defined by a name and a value pair that can be added to the collection using the Add(string, string) method of the HttpCookies property. Note: This is used only by the WebKit rendering engine.
Public propertyHttpHeaders
Gets a collection of custom HTTP headers to be sent by the converter to the web server when the web page is requested from a URL. A custom HTTP header is defined by a name and a value pair that can be added to the collection using the Add(string, string) method of the HttpHeaders property. The custom HTTP headers can be used to define cookies, authentication options, URL referer or any other HTTP header to be sent to the web browser. The preferred method to send cookies is to use the HttpCookies property. Note: This is used only by the WebKit rendering engine.
Public propertyImgTransparency
Modify images transparency. 0 means transparent, 100 means opaque.
Public propertyInternalFileName
Sets the full path of the helper file. Note: This is used only by the WebKit rendering engine.
Public propertyInternalLinksEnabled
When true this options instructs the converter to convert the internal HTML links to internal PDF links when the HtmlToPdfArea is added to a PDF page. The default value is true.
Public propertyInternetSecurityZone
Specifies the internet security zone settings used by the HTML converter to convert web sites.
Public propertyLazyImagesLoadingDelay
Delay per page, in miliseconds, for lazy images loading.
Public propertyLazyImagesLoadingEnabled
Enables a delay mechanism to allow images to fully load.
Public propertyLicenseKey
Gets or sets the license key
Public propertyLiveUrlsEnabled
When true this options instructs the converter to convert the html links in PDF links. The default value is true.
Public propertyLoginOptions
Handle custom page login.
Public propertyMaskBltEnabled
Enables or disables masking for transparent images. Default is true.
Public propertyNavigationTimeout
The navigation timeout in seconds. Default value is 60.
Public propertyOptimizeMemoryUsage
When this property is true the library will try to release the unused memory as soon as possible. The default value is false.
Public propertyOptimizePdfPageBreaks
A flag indicating if the converter uses an optimized page breaks algorithm to improve document scrolling inside a PDF Viewer. The optimized algorithm can introduce a small additional processing time when the PDF document is generated.
Public propertyPluginsEnabled
A flag indicating if plugins are enabled in converter. The default is true. Note: This is used only by the WebKit rendering engine.
Public propertyPostLoadingScript
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.
Public propertyPostLoadingScriptDelayAfter
Delay in miliseconds, after post page loading javascript injection.
Public propertyProxyOptions
Gets a reference to an object encapsulating the proxy options used to access the HTML document to convert. Note: This is used only by the WebKit rendering engine.
Public propertyRenderElementId
Use this property to convert only a certain section of the page, specified by the html element ID. Note: This is used only by the WebKit rendering engine.
Public propertyRenderingEngine
Gets or sets the rendering engine used by the converter to load and render the html. The possible values are WebKit and IE. The Webkit rendering engine is internal and renders similar to Chrome and Safari. For IE, the component uses the IE engine from the machine.
Public propertyRenderOnTimeout
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. Note: This is used only by the WebKit rendering engine.
Public propertyResizeImages
A flag indicating if the images from the web page can be resized to optimize memory usage. Note: This is used only by the WebKit rendering engine.
Public propertyRightToLeftEnabled
This property is obsolete. Setting this property is not necessary anymore when converting pages in right-to-left languages like Hebrew or Arabic.
Public propertyScriptsEnabled
Enable scripts when rendering HTML to selectable PDF. Default is true.
Public propertyScriptsEnabledInImage
Enable scripts when rendering HTML to image. Default is true.
Public propertySerializeLoadHtml
A flag indicating if the download and execution of the HTML code is serialized when the converter is called simultaneously from multiple threads of an application. Default value is false.
Public propertySplitThreshold
Internal use.
Public propertyStartupMode
Use this property to specify the converter startup mode. By default this is set to Automatic and the conversion is started as soon as the page loads (and ConversionDelay elapses). If set to Manual, the conversion is started only by a javascript call to ExpertPdfJSObj.startConversion() Note: This is used only by the WebKit rendering engine.
Public propertyStartupScript
Use this property to specify some JavaScript code that will be injected into the page that is converted. The JavaScript code specified here will run before any other script on the page. Note: This is used only by the WebKit rendering engine.
Public propertyStretchToFit
This property has effect only when FitWidth property is true. When FitWidth is true and this property is true the HTML content will be stretched if necessary to fit the available width in PDF page. By default this property is false and the content will not be stretched to fit the available width in PDF page.
Public propertyTruncateOutOfBoundsText
Internal use only.
Public propertyUseFontTempFolder
Use this property to specify if the web fonts are kept in memory or on the disk in a temporary file. Note: This is used only by the WebKit rendering engine.
Public propertyUseGlyphs
A flag indicating if texts are rendered using glyphs or regular characters. The default is false and regular characters are used if possible. Glyphs are forced for special languages (such as right to left or Asian). Note: This is used only by the WebKit rendering engine.
Public propertyUsePrintCSSMediaType
A flag indicating if @media print css styles are used or not. The default is false and @media screen css styles are used. Note: This is used only by the WebKit rendering engine.
Top
Fields
  NameDescription
Public fieldStatic memberDEFAULT_HTML_VIEWER_WIDTH_PX
The default virtual browser width in pixels
Top
See Also