Sets the string that appears in the About dialog box of a QuickWin program.
#include <io.h>
int _wabout( char *string );
| string | Pointer to a null-terminated string |
The _wabout function sets the string that appears in the About dialog box of a QuickWin program. This routine is used only in QuickWin programs; it is not part of the Windows API. For full details about QuickWin, see Chapter 8 of Programming Techniques (in the Microsoft C/C++ version 7.0 documentation set).
When the user chooses the About command from the Help menu, a dialog box appears containing the string set with _wabout. If a QuickWin program does not include a call to _wabout, information about QuickWin itself is displayed by default.
The maximum string length is 256 bytes.
If successful, _wabout returns 0. A nonzero return value indicates an error.
Standards:None
16-Bit:QWIN
32-Bit:None
_fwopen, _wclose, _wgetexit, _wgetfocus, _wgetscreenbuf, _wgetsize, _wmenuclick, _wopen, _wsetexit, _wsetfocus, _wsetscreenbuf, _wsetsize, _wyield
/* WABOUT.C - Demonstrate setting the About dialog box
* string with _wabout
*/
#include <stdio.h>
#include <io.h>
char string[512];
void main( void )
{
int nRes;
for ( ; ; )
{
printf( "\nEnter the About string: " );
scanf("%s", string);
printf( "\nAbout string = %s\n", string );
printf( "Setting about string..." );
nRes = _wabout( string );
printf( "\n_wabout result = %i\n", nRes );
printf( "\nTry 'About' in the Help menu\n" );
}
}