Class WebOptions (Excel VBA)

Contains workbook-level attributes used by Microsoft Excel when you save a document as a webpage or open a webpage.


AllowPNG true if Portable Network Graphics (PNG) is allowed as an image format when you save documents as a webpage. False if PNG is not allowed as an output format. The default value is False.

Application.Workbooks(1).WebOptions.AllowPNG = True

DownloadComponents true if the necessary Microsoft Office Web components are downloaded when you view the saved document in a web browser, but only if the components are not already installed. False if the components are not downloaded. The default value is False.

Application.DefaultWebOptions.DownloadComponents = True 
Application.DefaultWebOptions.LocationOfComponents = _ 
 Application.Path & Application.PathSeparator & "foo"

Encoding returns or sets the document encoding (code page or character set) to be used by the web browser when you view the saved document. The default is the system code page.

FolderSuffix returns the folder suffix that Microsoft Excel uses when you save a document as a webpage, use long file names, and choose to save supporting files in a separate folder (that is, if the UseLongFileNames and OrganizeInFolder properties are set to True).

strFolderSuffix = Workbooks(1).WebOptions.FolderSuffix

LocationOfComponents returns or sets the central URL (on the intranet or web) or path (local or network) to the location from which authorized users can download Microsoft Office Web components when viewing your saved document. The default value is the local or network installation path for Microsoft Office.

OrganizeInFolder true if all supporting files, such as background textures and graphics, are organized in a separate folder when you save the specified document as a webpage. False if supporting files are saved in the same folder as the webpage. The default value is True.

Application.DefaultWebOptions.OrganizeInFolder = False

Parent returns the parent object for the specified object. Read-only.

PixelsPerInch returns or sets the density (pixels per inch) of graphics images and table cells on a webpage. The range of settings is usually from 19 to 480, and common settings for popular screen sizes are 72, 96, and 120. The default setting is 96.

With ThisWorkbook.WebOptions 
 Select Case .ScreenSize 
 Case msoScreenSize800x600 
 .PixelsPerInch = 72 
 Case msoScreenSize1024x768 
 .PixelsPerInch = 96 
 Case Else 
 .PixelsPerInch = 120 
 End Select 
End With

RelyOnCSS true if cascading style sheets (CSS) are used for font formatting when you view a saved document in a web browser. Microsoft Excel creates a cascading style sheet file and saves it either to the specified folder or to the same folder as your webpage, depending on the value of the OrganizeInFolder property. False if HTML tags and cascading style sheets are used. The default value is True.

ThisWorkbook.WebOptions.RelyOnCSS = True

RelyOnVML true if image files are not generated from drawing objects when you save a document as a webpage. False if images are generated. The default value is False.

Workbooks(1).WebOptions.RelyOnVML = False

ScreenSize returns or sets the ideal minimum screen size (width by height, in pixels) that you should use when viewing the saved document in a web browser. Can be one of the MsoScreenSize constants. The default constant is msoScreenSize800x600.

TargetBrowser returns or sets an MsoTargetBrowser constant indicating the browser version.

Sub CheckWebOptions() 
    Dim wkbOne As Workbook 
    Set wkbOne = Application.Workbooks(1) 
    ' Determine if IE5 is the target browser. 
    If wkbOne.WebOptions.TargetBrowser = msoTargetBrowserIE5 Then 
        MsgBox "The target browser is IE5 or later." 
        MsgBox "The target browser is not IE5 or later." 
    End If 
End Sub

UseLongFileNames true if long file names are used when you save the document as a webpage. False if long file names are not used and the DOS file name format (8.3) is used. The default value is True.

Application.DefaultWebOptions.UseLongFileNames = False