IlsInit
Category
Utility global function
Description
This global function can be used on Windows® to control how messages are posted.
On non-Windows machines, this function does nothing.
Libraries
Signature
void IlsInit(const char* title = 0,
const char* notused = 0,
IlsWindowType windowType = default);
This global function should always be the first function to be called in the main procedure.
The string
title is the name that will appear in the title bar of the window or console, depending on how the application is compiled.
The second parameter is not used.
The third parameter takes a value which depends on the compilation options. The parameter defaults to the value
ILS_WINDOWTYPE_CONSOLE if compiling in console mode (that is, if the flag
_CONSOLE is defined). Otherwise, it will take the value
ILS_WINDOWTYPE_WINDOW. The value can be forced if necessary. A value of
ILS_WINDOWTYPE_DEFAULT means that this value will be controlled via the environment variable
ILS_FORCE_CONSOLE. If this environment variable is set, then the
windowType used at runtime will be
ILS_WINDOWTYPE_CONSOLE. Otherwise, the
windowType used will be
ILS_WINDOWTYPE_WINDOW.
ILS_WINDOWTYPE_POP is the same
windowType as
ILS_WINDOWTYPE_WINDOW,except that when the window is iconized, this argument will make the window disappear and automatically pop up again as soon as there is some new output in the window. Forcing
windowType to
ILS_WINDOWTYPE_CONSOLE when compiling in the subsystem windows, or to
ILS_WINDOWTYPE_WINDOW when compiling in the subsystem console, will cause all messages to be lost.
Example
An example of how IlsInit is normally used is shown below:
main()
{
IlsInit("server");
...
}
See Also
Version 5.8
Copyright © 2014, Rogue Wave Software, Inc. All Rights Reserved.