main-module

Arguments: project

Returns the main module of a project, which is the module whose form is run by the default on-initialization function, which is default-init-function. (The on-initialization function of a project is run when the Run | Run Project command is invoked or when a standalone application starts up.)

The main module may be specified in the IDE either interactively in the Main Form widget of the Options tab of the Project Manager dialog, or programmatically by calling (setf main-form). (main-module is not setf'able but if the main-form is changed, the main-module will be changed as well.)

main-module will always return either (1) a form-module or (2) nil if the project has no main form (in which case a custom on-initialization function needs to be created for the project).

Note that no actual forms will exist in a running standalone application. But maker-function may still be called on the main-module or any other form-module to find the function for creating the module's running window. This may be useful in a custom on-initialization function.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.