For ABCChrome and MSHtml engines

This property determines or reflects the virtual browser width when rendering HTML.

HTML documents do not have a predefined width and height. The width of an HTML document varies as the client resizes the browser. How far the content flows down the page is dependent on the width of the browser.

The Width parameter is used to control this aspect of HTML rendering. It is exactly as if you were displaying your HTML in a browser window the same width as the supplied value. Typical values might be 800 or 1024.

If the Width is zero then the web page view will default to a size which shows all the available content without needing to scroll from left to right. You can use this default to ensure that all your HTML content is visible.

When the Width is zero the InitialWidth property is used as a minimum sensible width. The page may get wider to ensure that content is not clipped, however it will not get smaller than this value.

For Gecko engine

This value determines the paper width, in pixels, to use while doing layout in Gecko.

Since the Gecko engine always renders in a paginated context and never needs to scroll, contents that horizontally exceed this value will often be reflown vertically.

For example, a sidebar using the CSS float property may appear below the "main content area" if the paper is not wide enough to accommodate both items.

If the value is zero then the paper width will be determined using the dimensions of the current Doc.Rect.

The following example shows the effect that this parameter has on PDF rendering.

[C#]
Doc theDoc = new Doc();
string theURL = "http://www.nasa.gov/multimedia/imagegallery/image_feature_313.html";
// Render html page with default browser width
theDoc.AddImageUrl(theURL);
// Save the document
theDoc.Save(Server.MapPath("HtmlOptionsBrowserWidth0.pdf"));
theDoc.Clear();
// Render html page with browser width = 300
theDoc.HtmlOptions.BrowserWidth = 300;
theDoc.AddImageUrl(theURL);
// Save the document
theDoc.Save(Server.MapPath("HtmlOptionsBrowserWidth300.pdf"));
theDoc.Clear();
[Visual Basic]
Dim theDoc As Doc = New Doc()
Dim theURL As String = "http://www.nasa.gov/multimedia/imagegallery/image_feature_313.html"
' Render html page with default browser width
theDoc.AddImageUrl(theURL)
' Save the document
theDoc.Save(Server.MapPath("HtmlOptionsBrowserWidth0.pdf"))
theDoc.Clear()
' Render html page with browser width = 300
theDoc.HtmlOptions.BrowserWidth = 300
theDoc.AddImageUrl(theURL)
' Save the document
theDoc.Save(Server.MapPath("HtmlOptionsBrowserWidth300.pdf"))
theDoc.Clear()


HtmlOptionsBrowserWidth0.pdf

HtmlOptionsBrowserWidth300.pdf