Q51415: PDS 7.00 Alert FUNCTION Return Value Description Incorrect

Article: Q51415
Product(s): See article
Version(s): 7.00 7.10
Operating System(s): MS-DOS
Keyword(s): ENDUSER | SR# S891101-66 docerr | mspl13_basic
Last Modified: 8-JAN-1991

The Alert FUNCTION in the WINDOW.BAS file of the User Interface (UI)
Toolbox is incorrectly described in the documentation. On Page 553 of
the "Microsoft BASIC 7.0: Language Reference" manual (for 7.00 and
7.10), the "Syntax" section incorrectly shows that the Alert FUNCTION
will return a string. The "Remarks" section and the source code in
WINDOW.BAS correctly show that the Alert FUNCTION actually returns an
INTEGER from 1 to 3.

This information applies to Microsoft BASIC Professional Development
System (PDS) versions 7.00 and 7.10 for MS-DOS.

The "Syntax" section of the Alert FUNCTION description reads as
follows:

   Syntax   variablename$ = Alert(style%,text$,row1%,...etc.

It should read as follows:

   Syntax   variablename% = Alert(style%,text$,row1%,...etc.

The dollar sign ($) appended to "variablename" should be a percent
sign (%) because the Alert FUNCTION returns an integer.

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.

Copyright Microsoft Corporation 1986-2002.