EVO HTML to PDF Converter

HtmlToPdfVariableElement Class

EVO PDF Client for .NET Documentation
This class encapsulates a HTML to PDF converter functionality. Objects of this class can be added at any location in a Template to render HTML. A conversion is performed for each PDF page where the Template is rendered.
Inheritance Hierarchy

SystemObject
  EvoPdf.HtmlToPdfClientPageElement
    EvoPdf.HtmlToPdfClientPageGraphicElement
      EvoPdf.HtmlToPdfClientHtmlToPdfElement
        EvoPdf.HtmlToPdfClientHtmlToPdfVariableElement

Namespace:  EvoPdf.HtmlToPdfClient
Assembly:  EvoHtmlToPdfClient (in EvoHtmlToPdfClient.dll) Version: 9.0.0.0 (9.0.0.0)
Syntax

public class HtmlToPdfVariableElement : HtmlToPdfElement

The HtmlToPdfVariableElement type exposes the following members.

Constructors

  NameDescription
Public methodHtmlToPdfVariableElement(String, String)
Creates a HTML string to PDF converter element that will be rendered at the (0,0) location in PDF page using a base URL to resolve the external resources and a document URL to resolve the internal links. The width of element in PDF page is the available width in PDF page and the height is auto determined.
Public methodHtmlToPdfVariableElement(Single, Single, String, String)
Creates a HTML string to PDF converter element at the specified x and y coordinates in PDF page using a base URL to resolve the external resources and a document URL to resolve the internal links. The width of element in PDF page is the available width in PDF page and the height is auto determined.
Public methodHtmlToPdfVariableElement(Single, Single, Single, String, String)
Creates a HTML string to PDF converter element at the specified x and y coordinates with the specified width using a base URL to resolve the external resources and a document URL to resolve the internal links. The height in PDF is auto determined.
Public methodHtmlToPdfVariableElement(Single, Single, Single, Single, String, String)
Creates a HTML string to PDF converter element at the specified x and y coordinates with the specified width and height using a base URL to resolve the external resources and a document URL to resolve the internal links.
Public methodHtmlToPdfVariableElement(Single, Single, Single, String, String, Int32)
Creates a HTML string to PDF converter element at the specified x and y coordinates with the specified width using a base URL to resolve the external resources and a document URL to resolve the internal links. The height in PDF is auto determined. The virtual browser width in pixels is specified by the htmlViewerWidth parameter.
Public methodHtmlToPdfVariableElement(Single, Single, Single, Single, String, String, Int32, Int32)
Creates a HTML string to PDF converter element at the specified x and y coordinates with the specified width and height using a base URL to resolve the external resources and a document URL to resolve the internal links. The virtual browser width and height in pixels is specified by the htmlViewerWidth and htmlViewerHeight parameters.
Top
Properties

  NameDescription
Public propertyAuthenticationOptions
The AuthenticationOptions can be set with an username and a password in order to authenticate to the web server before accessing the URL to be converted in HTML to PDF element converter. They can be used for example to resolve the IIS Integrated Windows Authentication or other types of IIS authentication. They cannot be used to resolve ASP.NET Forms Authentication or a custom authentication method defined at application level.
(Inherited from HtmlToPdfElement.)
Public propertyAvoidHtmlElementsBreakSelectors
Gets or sets the CSS selectors of the HTML elements to not be broken between PDF pages if possible when the HTML to PDF element is rendered
(Inherited from HtmlToPdfElement.)
Public propertyAvoidImageBreak
When true this property instructs the HTML to PDF element converter to try to avoid cutting off the images between PDF pages
(Inherited from HtmlToPdfElement.)
Public propertyAvoidTextBreak
When true this property instructs the HTML to PDF element converter to try to avoid cutting off the text between PDF pages. This property is true by default
(Inherited from HtmlToPdfElement.)
Public propertyBackColor
Gets or sets element background color.
(Inherited from PageGraphicElement.)
Public propertyBaseUrl
Gets or sets the base URL of the HTML string to be converted to PDF
(Inherited from HtmlToPdfElement.)
Public propertyBlending
Gets or sets blending mode for transparent rendering mode of the element.
(Inherited from PageGraphicElement.)
Public propertyBottomSpacing
A space in points to introduce at the bottom of PDF pages where the HTML element is rendered. 1 point is 1/72 inch. By default the bottom spacing is 0.
(Inherited from HtmlToPdfElement.)
Public propertyClipHtmlView
If the HTML content is not entirely visible in the HTML viewer of the HTML to PDF element 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 HtmlViewerWidth property. The default value of this property is false.
(Inherited from HtmlToPdfElement.)
Public propertyClipRectangle
The clip rectangle applied when the element is rendered in PDF
(Inherited from PageGraphicElement.)
Public propertyConversionDelay
An additional time in seconds to wait for asynchronous items to be completely loaded or for a web page redirect to finish before starting the rendering in HTML to PDF element converter. Default value is 0.
(Inherited from HtmlToPdfElement.)
Public propertyDefaultHtmlEncoding
The default HTML document text encoding to be used if there is no charset meta tag defined in the HTML document. By default this property is not set and an auto determined text encoding will be used by converter
(Inherited from HtmlToPdfElement.)
Public propertyDownloadAllResources
Gets or sets a flag indicating if the HTML to PDF element should try to download all the resources even if this could cause a slower conversion. The default value is false.
(Inherited from HtmlToPdfElement.)
Public propertyEmbedFonts
When true this option instructs the HTML to PDF element converter to embed all the true type fonts into the PDF document. The default value is true
(Inherited from HtmlToPdfElement.)
Public propertyEnable3DTransformations
Gets or sets a flag indicating if the accelerated CSS 3D transformations are enabled in the HTML to PDF element converter. The default value is false
(Inherited from HtmlToPdfElement.)
Public propertyEnableAccelerated2DCanvas
Gets or sets a flag indicating if the accelerated 2D canvas is enabled in the HTML to PDF element converter. The default value is false
(Inherited from HtmlToPdfElement.)
Public propertyEnableHttp2
Gets or sets a flag indicating if the HTTP2 protocol is enabled in HTML to PDF element converter. The property has effect only in NE version of the library. The default value is false
(Inherited from HtmlToPdfElement.)
Public propertyEnablePersistentStorage
Gets or sets a flag indicating if the persistent local storage is enabled in the HTML to PDF element converter. The default value is false
(Inherited from HtmlToPdfElement.)
Public propertyEnableWebGL
Gets or sets a flag indicating if the WebGL is enabled in the HTML to PDF element converter. The default value is false
(Inherited from HtmlToPdfElement.)
Public propertyEnhancedGraphicsQuality
A flag indicating the PDF graphics are rendered at the best quality by HTML to PDF element. The default property value is true
(Inherited from HtmlToPdfElement.)
Public propertyExtensionsEnabled
Gets or sets a flag indicating if the HTML viewer extensions are executed in HTML to PDF element converter. The default value is false and no extension is executed. The Flash player for Mozilla Firefox must be installed in order to execute the flash content from HTML
(Inherited from HtmlToPdfElement.)
Public propertyFitHeight
When this property is true the content produced by the HTML to PDF element will be resized if necessary to fit the available height in PDF page. By default this property is false.
(Inherited from HtmlToPdfElement.)
Public propertyFitWidth
When this property is true the content produced by the HTML to PDF element 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.
(Inherited from HtmlToPdfElement.)
Public propertyForeColor
Gets or sets the element foreground color.
(Inherited from PageGraphicElement.)
Public propertyGradient
The gradient used to fill a shape.
(Inherited from PageGraphicElement.)
Public propertyHeight
Gets or sets the destination height in points of the rendered content. If the specified height is less or equal to 0, the destination height will be auto determined so all the content can be rendered.
(Inherited from HtmlToPdfElement.)
Public propertyHiddenHtmlElementsSelectors
Gets or sets the CSS selectors of the HTML elements to be excluded from rendering in HTML to PDF element
(Inherited from HtmlToPdfElement.)
Public propertyHtml
Gets or sets the variable HTML string to be converted to PDF
(Overrides HtmlToPdfElementHtml.)
Public propertyHtmlDocumentInfo
Gets an object populated after conversion with the title, keywords, and description of the HTML document rendered by the HTML to PDF element.
(Inherited from HtmlToPdfElement.)
Public propertyHtmlElementsMappingOptions
Gets a reference to the object that can be used to obtain the position in PDF of the HTML elements rendered by the HTML to PDF element. In order to retrieve the position in PDF for a list of HTML elements, the HtmlElementSelectors property of HtmlElementsMappingOptions class must be set with an array of strings containing the CSS selectors of the HTML elements you want to map. The positions of the HTML elements in the generated PDF document will be returned in the HtmlElementsMappingResult object after the element was added to the page.
(Inherited from HtmlToPdfElement.)
Public propertyHtmlViewerHeight
Gets or sets the HTML viewer height in pixels of the HTML to PDF element. If the specified HTML viewer height is 0 the HTML viewer height will be automatically determined based on the HTML content and the HTML viewer width in order to make visible the whole HTML content. The HTML viewer width is given by the HtmlViewerWidth property of the HtmlToPdfElement class. 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 height can also be specified in the HtmlToPdfElement class contructor. The default value is 0 to automatically determine the HTML viewer height based on the HTML content and the HTML viewer width.
(Inherited from HtmlToPdfElement.)
Public propertyHtmlViewerWidth
Gets or sets the preferred HTML viewer width in pixels of the HTML to PDF element. 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. By default the ClipHtmlView property is false and the HTML viewer is automatically extended in width to make visible the whole HTML content. The HTML viewer width can also be specified in the HtmlToPdfElement class constructor. The default value is 1024 pixels.
(Inherited from HtmlToPdfElement.)
Public propertyHtmlViewerZoom
Gets or sets the HTML viewer zoom percentage in HTML to PDF element similar to zoom level in a browser. The default value of this property is 100
(Inherited from HtmlToPdfElement.)
Public propertyHttpPostFields
Returns the collection of HTTP POST fields to be used when accessing a web page in HTML to PDF element. If there are elements in collection then the converter will make a POST request to the web page URL with the fields from this collection, otherwise it will make a GET request
(Inherited from HtmlToPdfElement.)
Public propertyHttpRequestCookies
Gets a collection of custom HTTP cookies to be sent by the HTML to PDF element 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 HttpRequestCookies collection.
(Inherited from HtmlToPdfElement.)
Public propertyHttpRequestHeaders
Gets a collection of custom HTTP headers to be sent by the HTML to PDF element 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 HttpRequestHeaders cllection. The PersistentHttpRequestHeaders property can be set on true to instruct the converter to send the custom headers each time an external resource (image, css, etc) referenced by the web page is requested. By default the PersistentHttpRequestHeaders property is false and the custom headers are not automatically sent to the web server when the web page resources are requested. The custom HTTP headers can be used to define cookies, authentication options, URL referrer or any other HTTP header to be sent to the web browser. The preferred method to send cookies is to use the HttpRequestCookies property.
(Inherited from HtmlToPdfElement.)
Public propertyImagePartSize
Gets or sets the maximum height in pixels of an image part in HTML to PDF element converter
(Inherited from HtmlToPdfElement.)
Public propertyImagesScalingEnabled
A flag indicating if the images scaling is allowed in HTML to PDF element. The default property value is false
(Inherited from HtmlToPdfElement.)
Public propertyImpersonationOptions
The impersonation options applied during navigation by HTML to PDF element converter
(Inherited from HtmlToPdfElement.)
Public propertyInitialHtmlViewerHeight
Gets or sets the initial height in pixels of the HTML viewer in HTML to PDF element converter. This value of this property is ignored if the HtmlViewerHeight property is set
(Inherited from HtmlToPdfElement.)
Public propertyInsertNewPagesEnabled
A flag indicating if the HTML to PDF element will always insert a new page in the PDF document when rendering next page instead of trying to use an already existing PDF page. This property is false by default
(Inherited from HtmlToPdfElement.)
Public propertyInteractiveHiddenElements
A flag indicating if the interactive features are enabled for hidden HTML elements. This property is false by default
(Inherited from HtmlToPdfElement.)
Public propertyInternalLinksEnabled
When true this option instructs the HTML to PDF element to convert the internal HTML links to internal PDF links. The default value is true.
(Inherited from HtmlToPdfElement.)
Public propertyInterruptSlowJavaScript
Gets or sets a flag indicating if the slow JavaScript script should be interrupted in the HTML to PDF element converter. The default value is false and the scripts are not interrupted
(Inherited from HtmlToPdfElement.)
Public propertyJavaScriptEnabled
A flag indicating if JavaScript execution is enabled in HTML to PDF element converter. The default is true.
(Inherited from HtmlToPdfElement.)
Public propertyLineStyle
Gets or sets the line style for elements rendering lines.
(Inherited from PageGraphicElement.)
Public propertyLiveUrlsEnabled
When true this option instructs the HTML to PDF element to convert the HTML links to PDF links. The default value is true.
(Inherited from HtmlToPdfElement.)
Public propertyLocalFilesAccessEnabled
Gets or sets a flag indicating if the access to local files is enabled in the HTML to PDF element converter. The default value is true
(Inherited from HtmlToPdfElement.)
Public propertyManualTriggeringConversionDelay
An additional time in seconds to wait after manual triggering before starting the rendering in HTML to PDF element. Default value is 0.
(Inherited from HtmlToPdfElement.)
Public propertyMaxHtmlViewerHeight
Gets or sets the maximum height in pixels to be rendered from the HTML document by the HTML to PDF element converter. The default value is 0 and the entire HTML document is rendered
(Inherited from HtmlToPdfElement.)
Public propertyMediaType
Gets or sets the media type of the HTML document used by the HTML to PDF element. The default media type is 'screen'. If you set this property with 'print' then the CSS properties defined in '@media print' rule will be used to render the document
(Inherited from HtmlToPdfElement.)
Public propertyMinHtmlViewerHeight
Gets or sets the minimum height in pixels to be rendered from HTML document by the HTML to PDF element converter. This value of this property is ignored if the HtmlViewerHeight property is set
(Inherited from HtmlToPdfElement.)
Public propertyNavigationTimeout
The HTML to PDF element converter navigation timeout in seconds. Default value is 60.
(Inherited from HtmlToPdfElement.)
Public propertyNavigatorUserAgent
The custom user agent to be used when accessing the HTML page. When this property is null or empty the default user agent is used
(Inherited from HtmlToPdfElement.)
Public propertyNoSizeElementsEnabled
A flag indicating if the hidden elements are rendered by the HTML to PDF element. The default property value is false
(Inherited from HtmlToPdfElement.)
Public propertyOpacity
Gets or sets element opacity. The opacity is expressed as a value between 0 and 100. 0 means completely transparent and 100 completely opaque. The default value of this property is 100.
(Inherited from PageGraphicElement.)
Public propertyPageBreakAfterHtmlElementsSelectors
Gets or sets the CSS selectors of the HTML elements after which to force a page break in PDF document when the HTML to PDF element is rendered
(Inherited from HtmlToPdfElement.)
Public propertyPageBreakBeforeHtmlElementsSelectors
Gets or sets the CSS selectors of the HTML elements before which to force a page break in PDF document when the HTML to PDF element is rendered
(Inherited from HtmlToPdfElement.)
Public propertyPaginate
When this property is true the HTML to PDF element can be paginated to render many PDF pages if necessary.
(Inherited from HtmlToPdfElement.)
Public propertyPdfBookmarkOptions
Gets a reference to the object controlling the bookmarks creation in PDF for the HTML to PDF element. In order to enable creation of bookmarks you have to set the HtmlElementSelectors property of PdfBookmarkOptions class with the CSS selectors of the HTML elements you want to bookmark.
(Inherited from HtmlToPdfElement.)
Public propertyPdfFormOptions
Gets a reference to the object controlling the automatic conversion of a HTML form to a PDF form in the generated PDF document
(Inherited from HtmlToPdfElement.)
Public propertyPersistentHttpRequestHeaders
This property can be set on true to instruct the HTML to PDF element converter to send the custom headers defined by the HttpRequestHeaders property each time an external resource (image, css, etc) referenced by the web page is requested. The default value of this property is true and the custom headers are automatically sent to the web server when the web page resources are requested.
(Inherited from HtmlToPdfElement.)
Public propertyPostScriptFontsEnabled
Gets or sets a flag indicating if the fonts with PostScript outlines are enabled in the HTML to PDF element converter. The default value is true
(Inherited from HtmlToPdfElement.)
Public propertyPrerenderEnabled
Gets or sets a flag indicating if the HTML to PDF element should perform a pre-rendering. The default value is false
(Inherited from HtmlToPdfElement.)
Public propertyProxyOptions
Gets a reference to an object encapsulating the proxy options used by HTML to PDF element to access the HTML document to convert.
(Inherited from HtmlToPdfElement.)
Public propertyRenderedHtmlElementSelector
Get or set the CSS selector of the HTML element to be rendered by the HTML to PDF element converter. If the selector selects multiple HTML elements, only the the first one will be converted. The CSS selector is case sensitive. If this property is not set then the entire HTML document is rendered
(Inherited from HtmlToPdfElement.)
Public propertyRenderedPagesRectangles
The bounds of the rectangle rendered in each PDF page by the HTML to PDF element. This property is assigned after the element has been added to a PDF page.
(Inherited from HtmlToPdfElement.)
Public propertyShowFooterInEvenPages
Gets or sets a flag indicating if the footer is displayed in the even pages of the PDF document where this element is rendered
(Inherited from HtmlToPdfElement.)
Public propertyShowFooterInOddPages
Gets or sets a flag indicating if the footer is displayed in the odd pages of the PDF document where this element is rendered
(Inherited from HtmlToPdfElement.)
Public propertyShowHeaderInEvenPages
Gets or sets a flag indicating if the header is displayed in the even pages of the PDF document where this element is rendered
(Inherited from HtmlToPdfElement.)
Public propertyShowHeaderInOddPages
Gets or sets a flag indicating if the header is displayed in the odd pages of the PDF document where this element is rendered
(Inherited from HtmlToPdfElement.)
Public propertyStackRepeatedTableFooters
Get or sets a flag indicating if the repeated HTML table footers are stacked at the bottom of the PDF page when multiple HTML tables have repeated footers on that PDF page. Default value is true
(Inherited from HtmlToPdfElement.)
Public propertyStackRepeatedTableHeaders
Get or sets a flag indicating if the repeated HTML table headers are stacked at the top of the PDF page when multiple HTML tables have repeated headers on that PDF page. Default value is true
(Inherited from HtmlToPdfElement.)
Public propertyStretchToFit
This property has effect in HTML to PDF element 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.
(Inherited from HtmlToPdfElement.)
Public propertySvgFontsEnabled
Gets or sets a flag indicating if the SVG fonts are enabled in the HTML to PDF element converter. The default value is false
(Inherited from HtmlToPdfElement.)
Public propertyTableFooterRepeatEnabled
Get or sets a flag indicating if the repeating of the HTML table footer in PDF pages generated by the HTML to PDF element is enabled. Default value is true
(Inherited from HtmlToPdfElement.)
Public propertyTableHeaderRepeatEnabled
Get or sets a flag indicating if the repeating of the HTML table header in PDF pages generated by the HTML to PDF element is enabled. Default value is true
(Inherited from HtmlToPdfElement.)
Public propertyTableOfContentsEnabled
Get or sets a flag indicating if this HTML to PDF element can contribute to the PDF document table of contents. The PDF document table of contents is controlled by TableOfContents property. Default value is true
(Inherited from HtmlToPdfElement.)
Public propertyTiledRenderingEnabled
A flag indicating if rendering of HTML document is tiled in HTML to PDF element. This property is true by default
(Inherited from HtmlToPdfElement.)
Public propertyTopSpacing
A space in points to introduce at the top of PDF pages where the HTML element is rendered. 1 point is 1/72 inch. By default the top spacing is 0.
(Inherited from HtmlToPdfElement.)
Public propertyTransparentImagesEnabled
A flag indicating if the HTML to PDF element converter uses transparency information of the images. The default property value is true
(Inherited from HtmlToPdfElement.)
Public propertyTriggeringMode
The conversion triggering mode used by HTML to PDF element converter. The default value is Auto.
(Inherited from HtmlToPdfElement.)
Public propertyUrl
Gets or sets the URL of the HTML document to be converted to PDF
(Inherited from HtmlToPdfElement.)
Public propertyWebFontsEnabled
Gets or sets a flag indicating if the Web Fonts are enabled in the HTML to PDF element converter. The default value is true
(Inherited from HtmlToPdfElement.)
Public propertyWidth
Gets or sets the destination width in points of the rendered content. If the specified width is less or equal to 0, the destination width will be given by the available width in page
(Inherited from HtmlToPdfElement.)
Public propertyX
Gets or sets the x position in points where the rendered content will be placed in PDF page
(Inherited from HtmlToPdfElement.)
Public propertyXPSupplementalLanguages
A flag in HTML to PDF element indicating if the supplemental languages (complex script, right-to-left, East Asian) support was enabled in Windows XP Regional and Language Options. The default value is false.
(Inherited from HtmlToPdfElement.)
Public propertyY
Gets or sets the y position in points where the rendered content will be placed in PDF page
(Inherited from HtmlToPdfElement.)
Top
Methods

  NameDescription
Public methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGetHashCode
Serves as a hash function for a particular type.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodRotate
Rotates the coordinate system axes clockwise by the specified angle before rendering the element. The coordinates of the element are relative to the rotated coordinates system.
(Inherited from PageGraphicElement.)
Public methodScale
Scales the coordinates so that 1 unit in the horizontal and vertical dimensions of the new coordinate system is the same size as sx and sy units, respectively, in the previous coordinate system.
(Inherited from PageGraphicElement.)
Public methodSkew
Skews the x axis by an skewXAngle and the y axis by an skewYAngle before rendering the element.
(Inherited from PageGraphicElement.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Public methodTranslate
Translates the coordinate system before rendering the element. The coordinates of the element are relative to the translated coordinate system.
(Inherited from PageGraphicElement.)
Top
See Also

Reference