FileSaveAs Doc Err: Incorrect .Format Argument Explanation

Last reviewed: August 4, 1997
Article ID: Q117751
6.00 6.00a WINDOWS kbusage kbmacro

The information in this article applies to:

  • Microsoft Word for Windows, versions 6.0, 6.0a
  • Microsoft Windows operating system version 3.1

SYMPTOMS

There is a documentation error in the Word for Windows online WordBasic Help in the FileSaveAs topic. The same error occurs on page 445 of the "Microsoft Word Developer's Kit."

These resources contain the following incorrect information:

   You can specify other file formats, which must be listed in the
   [MSWord Text Converters] section of the WIN.INI file. To determine
   the appropriate value, count down, starting at 0 (zero), to the file
   format you want, and then add 100.

Instead, online Help and the "Microsoft Word Developer's Kit" should state the following correct information:

   You can specify other file formats if they are listed in the [MSWord
   Text Converters] section of your WINWORD6.INI file or the [MS Text
   Converters] section of your WIN.INI file. To determine the appropriate
   value for the .Format argument, count down, starting at 0 (zero) in the
   [MSWord Text Converters] section of your WINWORD6.INI file. Continue
   counting, starting with the next number, in the [MS Text Converters]
   section of your WIN.INI file, until you get to the file format you
   want. Then add 100 and use that number as the value of the .Format
   argument. For example, if you count down to 12, the value for the
   .Format argument is 112.

Below is a table that lists the .Format argument values for a sample WINWORD6.INI and WIN.INI file:

                                            Counted   .Format
File, Section, and Setting                  Number    Argument
--------------------------                  -------   --------

WINWORD6.INI

[MSWord Text Converters]

MS-DOS Text with Layout                     0          100
Text with Layout                            1          101
Lotus123                                    2          102
DisplayWrite                                3          103
MSMultiPlan                                 4          104
MultiMate 4.0                               5          105
MultiMate Adv II                            6          106
MultiMate Advantage                         7          107
MultiMate 3.3                               8          108
WordPerfect 4.2                             9          109

WIN.INI

[MS Text Converters]

WrdPrfctDOS50                               10         110
WrdPrfctDOS                                 11         111
WrdPrfctDOS52                               12         112
MSWordWin2                                  13         113
MSWordDos                                   14         114
MSWordDos6                                  15         115
MSWordMac4                                  16         116
RFTDCA                                      17         117
MSBiff                                      18         118

STATUS

Microsoft has confirmed this to be a problem in Word versions 6.0 and 6.0a for Windows. We are researching this problem and will post new information here in the Microsoft Knowledge Base as it becomes available.

WORKAROUND

To avoid counting the WINWORD6.INI and WIN.INI entries manually, create a macro that uses the ConverterLookup() function to return the correct value for the .Format argument. See the sample macros on page 303 of the "Microsoft Word Developer's Kit" or the "ConverterLookup()" topic in online WordBasic Help for more information.

MORE INFORMATION

The following six formats are internal to Word for Windows, so they always use the same number for the .Format argument:

.Format     File
Argument    Format
--------    ------

   0        Normal (Word format)
   1        Document Template
   2        Text Only (extended characters saved in ANSI character set)
   3        Text+Breaks (plain text with line breaks; extended
            characters saved in ANSI character set)
   4        Text Only (PC-8) (extended characters saved in IBM PC
            character set)
   5        Text+Breaks (PC-8) (text with line breaks; extended
            characters saved in IBM PC character set)
   6        Rich-text format (RTF)

REFERENCES

"Microsoft Word Developer's Kit," version 6.0, Microsoft Press, 1994, pages 303, 445

Kbcategory: kbusage kbmacro KBSubcategory:


Additional reference words: 6.00 6.00a docerr doc err documentation error
word6 wordbasic winword
Version : 6.00 6.00a
Platform : WINDOWS


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: August 4, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.