| ImgConverter Class |
This class offers the necessary API to create images in various formats from
a specified web page
Inheritance HierarchySystemObject
ExpertPdf.HtmlToPdfImgConverter
ExpertPdf.HtmlToPdfImgConverter
Namespace: ExpertPdf.HtmlToPdf
Assembly: ExpertPdf.HtmlToPdf (in ExpertPdf.HtmlToPdf.dll) Version: 11.0.0
SyntaxThe ImgConverter type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | ImgConverter |
Creates an image converter that auto detects the width and height
of the web page
|
| ImgConverter(Int32) |
Creates an image converter for a web page with the specified width and
an autodected height
|
| ImgConverter(Int32, Int32) |
Creates an image converter for a web page with the specified width and height
|
Methods| Name | Description | |
|---|---|---|
| GetImageBytesFromHtmlFile |
Gets binary format of an image generated from the specified HTML file in the
the specified System.Drawing.Imaging.ImageFormat format. The bytes can be further written in
any stream like a disk file or a web response.
|
| GetImageBytesFromHtmlStream(Stream, Encoding, ImageFormat) |
Gets binary format of an image generated from the specified HTML stream in the
the specified System.Drawing.Imaging.ImageFormat format. The bytes can be further written in
any stream like a disk file or a web response.
|
| GetImageBytesFromHtmlStream(Stream, Encoding, ImageFormat, String) |
Gets binary format of an image generated from the specified HTML stream in the
the specified System.Drawing.Imaging.ImageFormat format. The urlBase parameter allows the converter to
determine the full URLs from relative URLs for images and CSS files appearing
in the HTML code from htmlString parameter.
The bytes can be further written in any stream like a disk file or a web response.
|
| GetImageBytesFromHtmlStreamWithTempFile(Stream, Encoding, ImageFormat) |
Gets binary format of an image generated from the specified HTML stream in the
the specified System.Drawing.Imaging.ImageFormat format. The htmlStream is first saved in a temporary file.
The bytes can be further written in any stream like a disk file or a web response.
|
| GetImageBytesFromHtmlStreamWithTempFile(Stream, Encoding, ImageFormat, String) |
Gets binary format of an image generated from the specified HTML stream in the
the specified System.Drawing.Imaging.ImageFormat format. The htmlStream is first saved in a temporary file.
The urlBase parameter allows the converter to
determine the full URLs from relative URLs for images and CSS files appearing
in the HTML code from htmlStream parameter.
The bytes can be further written in any stream like a disk file or a web response.
|
| GetImageBytesFromHtmlString(String, ImageFormat) |
Gets binary format of an image generated from the specified HTML string in the
the specified System.Drawing.Imaging.ImageFormat format. The bytes can be further written in
any stream like a disk file or a web response.
|
| GetImageBytesFromHtmlString(String, ImageFormat, String) |
Gets binary format of an image generated from the specified HTML string in the
the specified System.Drawing.Imaging.ImageFormat format. The bytes can be further written in
any stream like a disk file or a web response. The urlBase parameter allows the converter to
determine the full URLs from relative URLs for images and CSS files appearing
in the HTML code from htmlString parameter.
|
| GetImageBytesFromHtmlStringWithTempFile(String, ImageFormat) |
Gets binary format of an image generated from the specified HTML string in the
the specified System.Drawing.Imaging.ImageFormat format. The htmlString is first saved into
a temporary file before performing the conversion
The bytes can be further written in
any stream like a disk file or a web response.
|
| GetImageBytesFromHtmlStringWithTempFile(String, ImageFormat, String) |
Gets binary format of an image generated from the specified HTML string in the
the specified System.Drawing.Imaging.ImageFormat format. The htmlString is first saved into
a temporary file before performing the conversion. The urlBase parameter allows the converter to
determine the full URLs from relative URLs for images and CSS files appearing
in the HTML code from htmlString parameter.
The bytes can be further written in any stream like a disk file or a web response.
|
| GetImageBytesFromUrl |
Gets binary format of an image generated from the specified URL in the
the specified System.Drawing.Imaging.ImageFormat format. The bytes can be further written in
any stream like a disk file or a web response.
|
| GetImageFromHtmlFile |
Gets an System.Drawing.Image object from the specified HTML file in the
the specified System.Drawing.Imaging.ImageFormat format
|
| GetImageFromHtmlStream(Stream, Encoding, ImageFormat) |
Gets an System.Drawing.Image object from the specified HTML stream in the
the specified System.Drawing.Imaging.ImageFormat format
|
| GetImageFromHtmlStream(Stream, Encoding, ImageFormat, String) |
Gets an System.Drawing.Image object from the specified HTML stream in the
the specified System.Drawing.Imaging.ImageFormat format. The urlBase parameter allows the converter to
determine the full URLs from relative URLs for images and CSS files appearing
in the HTML code from htmlStream parameter.
|
| GetImageFromHtmlStreamWithTempFile(Stream, Encoding, ImageFormat) |
Gets an System.Drawing.Image object from the specified HTML stream in the
the specified System.Drawing.Imaging.ImageFormat format by writing first the
stream in a temporary file
|
| GetImageFromHtmlStreamWithTempFile(Stream, Encoding, ImageFormat, String) |
Gets an System.Drawing.Image object from the specified HTML stream in the
the specified System.Drawing.Imaging.ImageFormat format by writing first the
stream in a temporary file. The urlBase parameter allows the converter to
determine the full URLs from relative URLs for images and CSS files appearing
in the HTML code from htmlString parameter.
|
| GetImageFromHtmlString(String, ImageFormat) |
Gets an System.Drawing.Image object from the specified HTML string in the
the specified System.Drawing.Imaging.ImageFormat format
|
| GetImageFromHtmlString(String, ImageFormat, String) |
Gets an System.Drawing.Image object from the specified HTML string in the
the specified System.Drawing.Imaging.ImageFormat format. The urlBase parameter allows the converter to
determine the full URLs from relative URLs for images and CSS files appearing
in the HTML code from htmlString parameter.
|
| GetImageFromHtmlStringWithTempFile(String, ImageFormat) |
Gets an System.Drawing.Image object from the specified HTML string in the
the specified System.Drawing.Imaging.ImageFormat format by writing first the HTML
string in a temporary file
|
| GetImageFromHtmlStringWithTempFile(String, ImageFormat, String) |
Gets an System.Drawing.Image object from the specified HTML string in the
the specified System.Drawing.Imaging.ImageFormat format by writing first the HTML
string in a temporary file. The urlBase parameter allows the converter to
determine the full URLs from relative URLs for images and CSS files appearing
in the HTML code from htmlString parameter.
|
| GetImageFromUrl |
Gets an System.Drawing.Image object from the specified URL in the
the specified System.Drawing.Imaging.ImageFormat format
|
| GetImageFromUrlBytes | Obsolete.
Gets binary format of an image generated from the specified URL in the
the specified System.Drawing.Imaging.ImageFormat format. The bytes can be further written in
any stream like a disk file or a web response.
|
| SaveImageFromHtmlFileToFile |
This method produces a image from the specified HTML file in the specified format
and saves the image in the specified disk file. The existing file will be
overwritten
|
| SaveImageFromHtmlStreamToFile(Stream, Encoding, ImageFormat, String) |
This method produces a image from the specified HTML stream in the specified format
and saves the image in the specified disk file. The existing file will be
overwritten
|
| SaveImageFromHtmlStreamToFile(Stream, Encoding, ImageFormat, String, String) |
This method produces a image from the specified HTML stream in the specified format
and saves the image in the specified disk file. The existing file will be
overwritten
|
| SaveImageFromHtmlStreamToFileWithTempFile(Stream, Encoding, ImageFormat, String) |
This method produces a image from the specified HTML stream in the specified format
and saves the image in the specified disk file by writing first the HTML stream into a temporary file.
The existing file will be overwritten.
|
| SaveImageFromHtmlStreamToFileWithTempFile(Stream, Encoding, ImageFormat, String, String) |
This method produces a image from the specified HTML stream in the specified format
and saves the image in the specified disk file by writing first the HTML stream into a temporary file.
The existing file will be overwritten.
|
| SaveImageFromHtmlStringToFile(String, ImageFormat, String) |
This method produces a image from the specified HTML string in the specified format
and saves the image in the specified disk file. The existing file will be
overwritten
|
| SaveImageFromHtmlStringToFile(String, ImageFormat, String, String) |
This method produces a image from the specified HTML string in the specified format
and saves the image in the specified disk file. The existing file will be
overwritten
|
| SaveImageFromHtmlStringToFileWithTempFile(String, ImageFormat, String) |
This method produces a image from the specified HTML string in the specified format
and saves the image in the specified disk file by writing first the HTML string into a temporary file.
The existing file will be overwritten.
|
| SaveImageFromHtmlStringToFileWithTempFile(String, ImageFormat, String, String) |
This method produces a image from the specified HTML string in the specified format
and saves the image in the specified disk file by writing first the HTML string into a temporary file.
The existing file will be overwritten.
|
| SaveImageFromUrlToFile |
This method produces a image from the specified URL in the specified format
and saves the image in the specified disk file. The existing file will be
overwritten
|
Properties| Name | Description | |
|---|---|---|
 | ActiveXEnabled |
Enable ActiveX controls when rendering HTML to image.
Default is true.
Note: This is used only by the IE rendering engine.
|
| AddPadding |
Add padding at the end of the conversion result.
Default is false.
|
| AuthenticationPassword |
Optionally set the Password property to authenticate to web server
before accessing the URL to be converted (e.g handles any IIS authentication method)
|
| AuthenticationUsername |
Optionally set the Username property to authenticate to web server
before accessing the URL to be converted (e.g handles any IIS authentication method)
|
| BatchConversion |
Set this true when using the converter for batch conversion.
Note: This is used only by the IE rendering engine.
|
| BehaviorsEnabled |
Enable behaviors when rendering HTML to image.
Default is false.
Note: This is used only by the IE rendering engine.
|
| BinaryBehaviorsEnabled |
Internal use.
Default is false.
|
| CacheFolder |
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.
|
| ClipHtmlView |
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.
|
| ConversionDelay |
An additional time in seconds to wait for asynchronous items to be loaded
|
| HttpCookies |
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.
|
| HttpHeaders |
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.
|
| HttpRequestHeaders |
Gets or sets a string containing the HTTP headers sent by the convertor to the web server
when the web page is requested from a URL.
The HTTP headers string can be used to define cookies, authentication options, URL referer or any other
HTTP header to be sent to the web browser.
Note: This is used only by the IE rendering engine.
|
| InternalFileName |
Sets the full path of the helper file.
Note: This is used only by the WebKit rendering engine.
|
| InternetSecurityZone |
Specifies the internet security zone settings used by the HTML converter to convert web sites.
Note: This is used only by the IE rendering engine.
|
| LicenseKey |
Gets or sets the license key
|
| NavigationTimeout |
The navigation timeout in seconds. Default value is 60.
|
| PageHeight |
Gets or sets the web page height. If the width was not set aswell,
this property has no effect
|
| PageWidth |
Gets or sets the web page width
|
| PluginsEnabled |
A flag indicating if plugins are enabled in converter.
The default is true.
Note: This is used only by the WebKit rendering engine.
|
| ProxyOptions |
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.
|
| RenderElementId |
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.
|
| RenderingEngine |
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.
|
| SamplingEnabled |
Internal use only
|
| ScriptsEnabled |
Enable scripts when rendering HTML to image.
Default is true.
|
| SerializeLoadHtml |
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.
Note: This is used only by the IE rendering engine.
|
| StartupMode |
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.
|
| StartupScript |
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.
|
| xDf |
Internal use only
|
See Also