XL97: Contents of Readme.txt for the Updated Html.xla Add-inLast reviewed: August 12, 1997Article ID: Q168345 |
The information in this article applies to:
SUMMARYThis article contains the contents of the Readme.txt file that contained in the self-extracting file for the updated Internet Assistant Wizard for Microsoft Excel. To obtain the updated Internet Assistant Wizard for Microsoft Excel, use your Web browser to go to the following address:
http://www.microsoft.com/OfficeFreeStuff/download/Html.exeNOTE: Because the Microsoft Web site is constantly updated, the site address may change without notice. If this occurs, link to the Microsoft home page at the following address:
http://www.microsoft.com/ MORE INFORMATION
------------------------------------------------------------------------ MICROSOFT INTERNET ASSISTANT WIZARD ADD-IN FOR MICROSOFT EXCEL 97 March 1997 ------------------------------------------------------------------------ (c) 1997 Microsoft Corporation. All rights reserved. [To view this readme most effectively in Notepad, turn on Word Wrap (Edit menu).]MICROSOFT EXPRESSLY DISCLAIMS ANY WARRANTY FOR THE INFORMATION IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY ACCOMPANY THIS DOCUMENT (collectively referred to as an Application Note). THE APPLICATION NOTE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE. The entire risk arising out of use or performance of the APPLICATION NOTE remains with you. This Application Note may be copied and distributed subject to the following conditions: 1) All text must be copied without modification and all pages must be included; 2) If software is included, all files on the disk(s) must be copied without modification; 3) All components of this Application Note must be distributed together; and 4) This Application Note may not be distributed for profit. NO LIABILITY FOR DAMAGES. In no event shall Microsoft or its suppliers be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or any other pecuniary loss) arising out of the use of or inability to use the Application Notes, even if Microsoft has been advised of the possibility of such damages. The information contained in this document represents the current view of Microsoft Corporation on the issues discussed as of the date of publication. Because Microsoft must respond to changing marketing conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information presented after the date of publication.
_______________________________________________ CONTENTS Introduction Requirements Installing the Internet Assistant Wizard Add-In Using the Internet Assistant Wizard Add-In HTMLconvert Function Documentation _______________________________________________ INTRODUCTIONThe Internet Assistant Wizard Add-In program provides enhanced capabilities for the Microsoft Excel 97 Internet Assistant Wizard, including programmatic conversion of data and charts to HTML. The upgraded features of this add-in are as follows:
REQUIREMENTSThe Internet Assistant Wizard Add-In requires Microsoft Excel 97. The add-in will not work with earlier versions of Microsoft Excel.
INSTALLING THE INTERNET ASSISTANT WIZARD ADD-INThe add-in program includes one add-in file, Html.xla, and this readme file. To install the Internet Assistant Wizard Add-In:
USING THE INTERNET ASSISTANT WIZARD ADD-INOnce installed, you can convert worksheet data and charts to HTML in either of two ways:
HTMLCONVERT FUNCTION DOCUMENTATIONThis custom function converts worksheet data and charts to HTML and then returns an integer constant that indicates either a successful conversion or the reason for its failure. To use this function, the Html.xla file must be loaded into memory, either programmatically or by invoking and then canceling the Internet Assistant Wizard. The Html.xla file also must be referenced (Tools menu, References command).
Syntax
HTMLconvert(RangeAndChartToConvert, UseExistingFile, UseFrontPageForExistingFile, AddToFrontPageWeb, CodePage, HTMLFilePath, [ExistingFilePath], [TitleFullPage], [HeaderFullPage],[DescriptionFullPage], [LineBeforeTableFullPage], [LineAfterTableFullPage], [LastUpdate], [NameFullPage], [EmailFullPage])The HTMLconvert syntax has these named arguments:
RangeAndChartToConvert Required. A Range or Chart object, or an array of Ranges and Chart objects to convert. See the sample code below for examples. UseExistingFile Required Boolean. True to insert the converted data into the file specified by ExistingFilePath. False to create a new file. UseFrontPageForExistingFile Required Boolean. True if the file specified by ExistingFilePath is present on the currently open FrontPage web. False if the file is on the local system or a shared network folder. If False, ExistingFilePath must be specified. AddToFrontPageWeb Required Boolean. True to add the file to the currently open FrontPage web. If True, HTMLFilePath must specify a URL. False to create the file on the local system or a shared network folder. CodePage Required Long. The code page to use for the HTML. The following code pages are commonly used for display on Windows and Macintosh systems. Windows 1250 Eastern Europe 1251 Cyrillic 1252 U.S./Western Europe 1253 Greek 1254 Turkish Macintosh 10000 Roman (U.S.) 10001 Japanese 10006 Greek 10007 Cyrillic 10029 Latin 2 10079 Icelandic 10081 Turkish For more codes and more information about code pages, see "Developing International Software for Windows 95 and Windows NT" by Nadine Kano, available from Microsoft Press at http://www.microsoft.com/mspress/. HTMLFilePath Required String. Either the path and file name or the URL (if AddToFrontPageWeb is True) for the converted output file. ExistingFilePath Optional String. Either the path and file name or the URL (if UseFrontPageForExistingFile is True) for the existing file into which to insert the converted data. TitleFullPage Optional String. The HTML window title. HeaderFullPage Optional String. The page header in the HTML file. DescriptionFullPage Optional String. Description to precede the converted data. LineBeforeTableFullPage Optional Boolean. True to include a horizontal rule after the header and description. False to omit a rule in this location. LineAfterTableFullPage Optional Boolean. True to include a horizontal rule after the converted data and before the footer information. False to omit a rule in this location. LastUpdate Optional Variant(Date). The date the web page was last updated. This date is included at the bottom of the HTML page. NameFullPage Optional String. The author's name. This name is included at the bottom of the HTML page. EmailFullPage Optional String. The author's e-mail address. This address is included at the bottom of the HTML page. Return Values
Constant Value Description -------- ----- ----------- HTMLCONVERT_SUCCESS 0 The conversion was successful. HTMLCONVERT_ENTIRECOLUMNSELECTED 1 An entire column was specified for RangeAndChartToConvert. HTMLCONVERT_ENTIREROWSELECTED 2 An entire row was specified for RangeAndChartToConvert. HTMLCONVERT_PATHEXISTINGFILEMISSING 3 UseExistingFile was True, and ExistingFilePath was omitted. HTMLCONVERT_CANNOTSTARTFRONTPAGE 4 AddToFrontPageWeb was True, and FrontPage could not be started. HTMLCONVERT_FILENOTFOUND 5 UseExistingFile was True, and the file specified by ExistingFilePath could not be found. HTMLCONVERT_CANNOTUSEEXISTINGFILE 6 UseExistingFile was True, and the file specified by ExistingFilePath could not be used for the conversion. HTMLCONVERT_XLHTMLNOTINSTALLED 7 The XLHTML.DLL file was not installed (normally installed by Setup for Office or Microsoft Excel). HTMLCONVERT_CODEPAGEDOESNOTEXIST 8 The code page specified by CodePage does not exist. HTMLCONVERT_CANNOTOPENFILE 9 The file specified by HTMLFilePath could not be opened. HTMLCONVERT_OBJECTNOTDEFINED 10 The object specified in RangeAndChartToConvert contained worksheet elements other than Ranges and Chart objects, or does not exist. HTMLCONVERT_WEBSERVERNOTOPEN 11 UseFrontPageForExistingFile was True, or AddToFrontPageWeb was True, but the FrontPage Web server was not running. HTMLCONVERT_CANNOTFINDXLHTML 13 The XLHTML.DLL file could not be found (the default location is C:\Program Files\Microsoft Office\Office). ExampleThe following example passes an array, Objects, describing two ranges of data and a chart to be converted. It creates a new HTML file named MyPage.htm. The file is intended for display on a U.S. Windows system. The page will have the header "My Worksheet Data" followed by a horizontal rule and the converted data. The bottom the page will have the current date as the time of last update, "MyName" as the author, and "MyMail@microsoft.com" as the e-mail address.
Sub CreateMyWebPage()Dim Objects(2) As Variant
Set Objects(0) = ActiveSheet.Range("A1:C20") Set Objects(1) = ActiveSheet.ChartObjects("Chart 1") Set Objects(2) = ActiveSheet.Range("E4:H20") CreateOK = htmlconvert(Objects, False, False, False, 1252, _ "c:\MyFolder\MyPage.htm", , , , "My Worksheet Data", _ True, , Now, "MyName", "MyMail@microsoft.com") If CreateOK = 0 Then Workbooks.Open "c:\MyFolder\MyPage.htm" Else MsgBox "Attempt to create page failed." End If End Sub
|
Additional query words: XL97
© 1998 Microsoft Corporation. All rights reserved. Terms of Use. |