For MSHtml engine

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 640 or 800.

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.

For Gecko engine

This value determines the paper width, in pixels, to use while doing layout in Gecko. Since the Gecko engine always render in a paginated context and never needs to scroll, contents that horizontally exceed this value will often be reflown vertically. For example, a sidebar done using the CSS float property may appear below the "main content area" because the paper is not wide enough to accommodate both items. If the value is 0 the paper width will be determined from the current Rect's dimensions.

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