An object of this class can be laid out in any position in a PdfRepeatCanvas to render in place HTML content which
may contain the page numbering place holders {CrtPage} and {PageCount}. The rendering of this type of object can be less efficient
than the rendering of a regular PdfHtml object because there will be a HTML to PDF conversion for each PDF page where
the canvas is repeated
Inheritance Hierarchy
HiQPdfPdfObject
HiQPdfPdfDrawableObject
HiQPdfHtmlObjectBase
HiQPdfPdfHtml
HiQPdfPdfHtmlWithPlaceHolders
Namespace: HiQPdf
Assembly: HiQPdf (in HiQPdf.dll) Version: 15.0.0.0
Syntax
The PdfHtmlWithPlaceHolders type exposes the following members.
Constructors
Name | Description | |
---|---|---|
PdfHtmlWithPlaceHolders |
Creates an empty HTML to PDF object. The HtmlToConvert property must be set after object creation
| |
PdfHtmlWithPlaceHolders(String, String) |
Creates a HTML to PDF object to render the given HTML code in the top left corner of the PDF page to which this object is added
| |
PdfHtmlWithPlaceHolders(Single, Single, String, String) |
Creates a HTML to PDF object to render the given HTML code at the given coordinate in the PDF page to which this object is added
| |
PdfHtmlWithPlaceHolders(Single, Single, Single, String, String) |
Creates a HTML to PDF object to render the given HTML code at the given coordinate and having a given width in the PDF page
to which this object is added
| |
PdfHtmlWithPlaceHolders(Single, Single, Single, Single, String, String) |
Creates a HTML to PDF object to render the given HTML code within a given destination box in the PDF page
to which this object is added
|
Properties
Name | Description | |
---|---|---|
AcceleratedCanvasEnabled |
Controls if the accelerated canvas is enabled. This property is false by default
(Inherited from HtmlObjectBase.) | |
Authentication |
The object exposed by this propery encapsulates a username and a password that can be used
to access web pages requiring HTTP authentication in this HTML object
(Inherited from HtmlObjectBase.) | |
AutoPdfForm |
The object exposed by this property can be used to control the automatically created PDF form
(Inherited from PdfHtml.) | |
BackColor |
The PDF object back color
(Inherited from PdfDrawableObject.) | |
BaseUrl |
The base URL that can be used to resolve the relative URLs found in the HTML code to convert
(Inherited from PdfHtml.) | |
BlendingMode |
The blending mode when this object is drawn in PDF.
This property is Normal by default
(Inherited from PdfDrawableObject.) | |
BottomPadding |
A padding to insert under the content rendered by this object in a PDF page
(Inherited from PdfHtml.) | |
BreakAfterHtmlElements |
An array of HTML CSS selectors to select the HTML elements that will receive a page break after them in PDF document
(Inherited from HtmlObjectBase.) | |
BreakBeforeHtmlElements |
An array of HTML CSS selectors to select the HTML elements that will receive a page break before them in PDF document
(Inherited from HtmlObjectBase.) | |
BreakInsideAvoidHtmlElements |
An array of HTML CSS selectors to select the HTML elements not accepting page breaks inside them
(Inherited from HtmlObjectBase.) | |
BrowserHeight |
The browser window height in pixels in this HTML object. The default height is set to render the entire HTML document
(Inherited from HtmlObjectBase.) | |
BrowserUserAgent |
The browser custom user agent
(Inherited from HtmlObjectBase.) | |
BrowserWidth |
The browser window width in pixels in this HTML object. The default width is 1200 pixels
(Inherited from HtmlObjectBase.) | |
BrowserZoom |
The browser window zoom percentage. The default zoom is 100
(Inherited from HtmlObjectBase.) | |
ClipRectangle |
The clip rectangle applied when drawing the object in PDF
(Inherited from PdfDrawableObject.) | |
ConversionInfo |
This property is initialized after conversion with an object containing information about the converted HTML document,
about the HTML elements in the HTML document and about the regions rendered in the PDF document
(Inherited from HtmlObjectBase.) | |
ConvertedHtmlElementSelector |
This property can be set with a value representing the CSS selector of the HTML element to be converted in this HTML object.
If many elements in the HTML document are selected, only the the first one will be converted. The values
of the attributes in the CSS selectors are case sensitive. If this property is not set then the whole
HTML document is converted
(Inherited from HtmlObjectBase.) | |
ConvertHttpLinks |
Controls if the HTTP links in the HTML document are converted to HTTP links in PDF in this HTML object.
This property is true by default
(Inherited from HtmlObjectBase.) | |
ConvertInternalLinks |
Controls if the internal links in HTML are converted to internal links in PDF in this HTML object.
This property is true by default
(Inherited from HtmlObjectBase.) | |
Cropping |
Controls is the HTML is cropped at the end of PDF page where it is rendered. This property is false by default and
the HTML rendering can continue on the next page if necessary
(Inherited from PdfHtml.) | |
DefaultCharset |
The default character set to be used when the character set meta tag is not set in HTML document header
(Inherited from HtmlObjectBase.) | |
DestHeight |
The height in points of the destination PDF rectangle where the HTML content will be rendered
(Inherited from PdfHtml.) | |
DestWidth |
The width in points of the destination PDF rectangle where the HTML content will be rendered
(Inherited from PdfHtml.) | |
DestX |
The destination rectangle top left corner X coordinate in points
(Inherited from PdfHtml.) | |
DestY |
The destination rectangle top left corner Y coordinate in points
(Inherited from PdfHtml.) | |
DisplayMaskedImages |
Indicates if the masked images are displayed.
This property is false by default
(Inherited from PdfHtml.) | |
EnableTableOfContents |
Controls if the PDF document table of contents is created for the HTML document being converted. The default value is true
(Inherited from PdfHtml.) | |
FitDestHeight |
Controls if the content is scaled down to fit the PDF destination height iof this HTML object. This property is false by default
(Inherited from HtmlObjectBase.) | |
FitDestWidth |
Controls if the content is scaled down to fit the PDF destination width of this HTML object. This property is true by default.
When this property is true the images and the text font can be smaller than in HTML
(Inherited from HtmlObjectBase.) | |
FontEmbedding |
Controls if the fonts used in HTML are embedded in the PDF document.
This property is true by default
(Inherited from PdfHtml.) | |
ForceFitDestWidth |
Controls if the content can be enlarged to fit the PDF destination width of this HTML object when FitDestWidth is true. This property is false by default
(Inherited from HtmlObjectBase.) | |
ForceNewPdfPages |
Controls if a new PDF page is always created when the HTML object is laid out on the next PDF page. By default this property is false and if there is a next
page already created in PDF document it will be used to layout this object
(Inherited from HtmlObjectBase.) | |
ForceResourcesDownload |
Controls if the HTML converter object should force all possible resources to be downloaded in this HTML object. The default value is false
(Inherited from HtmlObjectBase.) | |
ForeColor |
The PDF object fore color
(Inherited from PdfDrawableObject.) | |
Gradient |
The PDF object gradient color
(Inherited from PdfDrawableObject.) | |
HiddenHtmlElements |
An array of HTML CSS selectors to select the HTML elements which will not be rendered to PDF
(Inherited from PdfHtml.) | |
HighResolutionGraphics |
Indicates if the PDF graphics are using high resolution coordinates.
This property is true by default
(Inherited from PdfHtml.) | |
HtmlLoadedTimeout |
The maximum time in seconds to wait for HTML document to be loaded in this HTML object. The default value is 120 seconds.
An exception is thrown if the HTML document cannot be loaded in HtmlLoadedTimeout seconds
(Inherited from HtmlObjectBase.) | |
HtmlToConvert |
The HTML code with page numbering place holders to convert
(Overrides PdfHtmlHtmlToConvert.) | |
Http2Enabled |
Controls if the HTTP2 protocol is enabled in NG version for this HTML object. The default value is false
(Inherited from HtmlObjectBase.) | |
HttpCookies |
A collection of HTTP cookies to be used when accessing a web page in this HTML object
(Inherited from HtmlObjectBase.) | |
HttpHeaders |
A collection of the HTTP headers to be used when accessing a web page in this HTML object
(Inherited from HtmlObjectBase.) | |
HttpPostFields |
A collection of HTTP POST fields to be used when accessing a web page in this HTML object.
If the collection is not empty, the converter will make a POST request to the web page URL
with the fields from this collection.
(Inherited from HtmlObjectBase.) | |
ImagesCutAllowed |
Controls if cutting images between PDF pages is permitted. This property is true by default
(Inherited from HtmlObjectBase.) | |
Impersonation |
The object exposed by this propery encapsulates the properties controlling the internal browser impersonation in this HTML object
(Inherited from HtmlObjectBase.) | |
LayoutWithHinting |
Controls if the hinting is used to layout HTML in this HTML object. Layout hinting is disabled by default.
Enabling this property can improve the layout but it can make the conversion slower
(Inherited from HtmlObjectBase.) | |
LineStyle |
The style of the lines rendered by this object
(Inherited from PdfDrawableObject.) | |
LiveExcludedElements |
Controls if the HTML elements excluded from rendering are live in PDF.
This property is false by default
(Inherited from HtmlObjectBase.) | |
LocalFilesLoadEnabled |
Controls if the local files can be loaded by converter. This property is true by default
(Inherited from HtmlObjectBase.) | |
LocalStorageEnabled |
Controls if the local web storage is enabled. This property is false by default
(Inherited from HtmlObjectBase.) | |
ManualTriggerWaitBeforeConvert |
An additional time in seconds to wait before starting the conversion when the triggering mode is set to manual
(Inherited from HtmlObjectBase.) | |
MaxBrowserHeight |
This property can be used to set a maximum limit in pixels for the rendered top part of a HTML document in this HTML object.
The default value is 0 and the height is not limited
(Inherited from HtmlObjectBase.) | |
MaxImageTileHeight |
The maximum height in pixels of the image tiles captured by converter in this HTML object
(Inherited from HtmlObjectBase.) | |
MediaType |
Controls the media type for which to render the HTML document in this HTML object. If this property is null or empty the default media type is 'screen'.
It can be set to a value like 'print' and in this case the CSS properties defined by the '@media print' rule will be used when the HTML is rendered
(Inherited from HtmlObjectBase.) | |
MinBrowserHeight |
This property can be used to set a minimum height in pixels to be rendered in this HTML object. The default value is 0 pixels.
This property is ignored when the BrowserHeight property is set
(Inherited from HtmlObjectBase.) | |
Opacity |
The element opacity as a value between 0 which means completely transparent to 100 which means completely opaque.
The object is completely opaque by default
(Inherited from PdfDrawableObject.) | |
Outlines |
Controls the outlines automatically generated by this HTML object
(Inherited from HtmlObjectBase.) | |
ProbeLayout |
Controls if the HTML converter object should do a probe layout first in this HTML object. The default value is false
(Inherited from HtmlObjectBase.) | |
Proxy |
The object exposed by this property encapsulates the parameters (address, username, password) that can be used
to access web pages through a proxy server in this HTML object
(Inherited from HtmlObjectBase.) | |
RenderImagesWithTransparency |
Indicates if the images are rendered with transparency in PDF.
This property is true by default
(Inherited from PdfHtml.) | |
RenderPostScriptFonts |
Controls if the PostScript fonts are rendered. The default value is true
(Inherited from PdfHtml.) | |
RenderSvgFonts |
Controls if the SVG fonts are rendered in this HTML object. The default value is false when converting HTML to PDF or SVG and true when converting HTML to a raster image
(Inherited from HtmlObjectBase.) | |
RenderWebFonts |
Controls if the Web Fonts are rendered in this HTML object. The default value is true
(Inherited from HtmlObjectBase.) | |
RepeatHttpHeaders |
This property controls if the headers defined by the HttpHeaders property are also used when accessing the resources referenced by the
web page, not only when accessing the web page in this HTML object. The default value is true and the headers are repeated when accessing the referenced resources
(Inherited from HtmlObjectBase.) | |
RepeatTfootAllowed |
Indicates if the repeating of thead content of a HTML table in PDF is allowed. This property is true by default
(Inherited from PdfHtml.) | |
RepeatTfootStacked |
Indicates if the tfoot content of the HTML tables rendered on a PDF page are stacked or displayed at the same level.
This property is true by default
(Inherited from PdfHtml.) | |
RepeatTheadAllowed |
Indicates if the repeating of thead content of a HTML table in PDF is allowed. This property is true by default
(Inherited from PdfHtml.) | |
RepeatTheadStacked |
Indicates if the thead content of the HTML tables rendered on a PDF page are stacked or displayed at the same level.
This property is true by default
(Inherited from PdfHtml.) | |
RetrieveExcludedElements |
Controls if the HTML elements excluded from rendering can be selected for detailed information retrieval.
This property is true by default
(Inherited from HtmlObjectBase.) | |
RunExtensions |
Controls if the browser extensions like Flash players are executed in this HTML object. The default value is false and no extension is executed
(Inherited from HtmlObjectBase.) | |
RunJavaScript |
Controls if the JavaScript in the HTML document is executed in this HTML object. The default value of this property is true and the JavaScript is executed
(Inherited from HtmlObjectBase.) | |
ScaleImages |
Indicates if the images can be scaled in PDF.
This property is false by default
(Inherited from PdfHtml.) | |
SelectedHtmlElements |
An array of HTML CSS selectors to select the HTML elements for which to retrieve detailed information in
SelectedHtmlElementsInfo collection exposed by ConversionInfo
property in this HTML object
(Inherited from HtmlObjectBase.) | |
StartBrowserHeight |
This property can be used to set the starting height in pixels of the browser.
This property is ignored when the BrowserHeight property is set
(Inherited from HtmlObjectBase.) | |
StopSlowScripts |
Controls if the browser should interrupt slow scripts in the web page in this HTML object. The default value is false and the scripts are not stopped
(Inherited from HtmlObjectBase.) | |
StrictIsoRendering |
Indicates if the generated PDF document respects strictly the ISO standard.
This property is true by default
(Inherited from PdfHtml.) | |
TopPadding |
A padding to insert above the content rendered by this object in a PDF page
(Inherited from PdfHtml.) | |
Transform3DEnabled |
Controls if the 3D transformations are enabled. This property is false by default
(Inherited from HtmlObjectBase.) | |
TriggerMode |
The method of triggering the conversion in HTML object. The default value is Auto
(Inherited from HtmlObjectBase.) | |
TrimToBrowserWidth |
If the HTML document cannot be entirely displayed in BrowserWidth pixels and the TrimToBrowserWidth is false
then the browser window width will be automatically set to display the entire HTML document in this HTML object.
If the HTML document cannot be entirely displayed in BrowserWidth pixels and the TrimToBrowserWidth is true
then the browser window width will not be automatically set to display the entire HTML document and the HTML document
will be trimmed
(Inherited from HtmlObjectBase.) | |
UrlToConvert |
The URL to convert
(Inherited from PdfHtml.) | |
WaitBeforeConvert |
An additional time in seconds to wait before starting the conversion to allow more time to JavaScript to update the web page in this HTML object.
When the property is set with a positive value the TriggerMode property is automatically set to WaitTime.
This property has effect only if the TriggerMode property is WaitTime (Inherited from HtmlObjectBase.) | |
WebGLEnabled |
Controls if the WebGL is enabled. This property is false by default
(Inherited from HtmlObjectBase.) |
Methods
Name | Description | |
---|---|---|
Equals | (Inherited from Object.) | |
Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) | |
GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) | |
GetType | Gets the Type of the current instance. (Inherited from Object.) | |
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) | |
SetDepFilePath |
Call this method of a HTML object with the fully qualified name of HiQPdf.dep when this file is installed
in a different folder from the HiQPdf.dll folder
(Inherited from HtmlObjectBase.) | |
SetRotationAngle |
Sets the clockwise rotation angle of the coordinates system before drawing this object in PDF
(Inherited from PdfDrawableObject.) | |
SetScaling |
Sets the horizontal and vertical scaling of the coordinates system before drawing this object in PDF
(Inherited from PdfDrawableObject.) | |
SetSkewAngles |
Sets the clockwise skew angles of the coordinates system before drawing this object in PDF
(Inherited from PdfDrawableObject.) | |
SetTranslation |
Sets the horizontal and vertical translation of the coordinates system before drawing this object in PDF
(Inherited from PdfDrawableObject.) | |
ToString | Returns a string that represents the current object. (Inherited from Object.) |
Events
Name | Description | |
---|---|---|
HtmlLoadedEvent |
The event is raised right after the converter finished the HTML document loading and before starting
the rendering to PDF
(Inherited from PdfHtml.) | |
LayoutingInPdfPageEvent |
The event is raised when the converter prepares to layout the HTML with placeholders in a PDF page
| |
PageCreatingEvent |
This event can be used to configure the PDF page before starting layouting.
For example, it is possible to set a custom header and footer for page or to
hide the header and footer from page. The event handler must be
set before adding this object to a page
(Inherited from PdfHtml.) | |
PageLayoutingEndedEvent |
The event is raised after the converter finished to layout the objects in a PDF page.
This event can be used to layout PDF objects in the foreground of the PDF page
after the main HTML content was laid out in page. The event handler must be
set before adding this object to a page
(Inherited from PdfHtml.) | |
PageLayoutingEvent |
The event is raised when the HTML to PDF object prepares to layout the objects in a PDF page.
This event can be used to layout PDF objects in the background of the PDF page
before the main HTML content is laid out in page. The event handler must be
set before adding this object to a page
(Inherited from PdfHtml.) |
See Also