IupOpen

IUP - Portable User Interface

IupOpen

Initializes the IUP toolkit. Must be called before any other IUP function.

Parameters/Return

int IupOpen(int *argc, char ***argv); [in C]
[There is no equivalent in Lua]

argc and argv: are the same as the application "main" function function. Some parameters processed by the driver can be removed so the address is necessary. They can be NULL. (Since 3.0)

This function returns IUP_OPENED (already opened), IUP_ERROR or IUP_NOERROR.

Only in UNIX can fail to open, because X-Windows may be not initialized.

Notes

In Windows, CoInitializeEx(COINIT_APARTMENTTHREADED) and InitCommonControlsEx(ICC_WIN95_CLASSES) functions are called.

In Motif, XtOpenApplication function is called.

For a more detailed explanation on the system control, please refer to Guide / System Control.

Environment Variables

The toolkit's initialization depends also on platform-dependent environment variables, see each driver documentation.

QUIET

When this variable is set to NO, IUP will generate a message in console indicating the driver’s version when initializing. Default: YES.

VERSION

When this variable is set to YES, IUP generates a message dialog indicating the driver's version when initializing.  Default: NO.

Lua Binding 

This function should be called by the host program and before the IupLua initialization function iuplua_open. If not the IupLua initialization function will call it.

See Also

iuplua_open, IupClose, Guide / System Control