Clarion Community Help

Navigation: Application Generator > Procedure Properties >====== Procedure Properties–External ======

The External Procedure Template declares a procedure which is contained in an external library (*.LIB only) or object file. The Application Generator writes no source code. The project system links in the external file as a module.

After selecting the External template type from the Select Procedure Type dialog, choose OBJ or LIB from the Select Module Type dialog.

Type the file name of the external library or object file in the Module Name field. Optionally type parameter declarations in the Prototype field.

Description	A short text description for the procedure, which appears next to the procedure name in the Application Tree dialog.
	Press the ellipsis ( … ) button to edit a longer (up to 1000 characters) description.
Category	Use this field to group your procedures in the Category Tab of the Application Tree. The Procedure templates add a default value corresponding to their types to group procedures made with the same template together. You can create your own categories as you like.
Prototype	Lets you optionally type a custom procedure prototype which the Application Generator places in the MAP section. See Prototyping and Parameter Passing with the Application Generator
Parameters	Allows you to optionally enter any parameter names (a list of variables separated by a comma)
Module Name	The source code file to hold the code for the procedure. Select from the drop down list. By default, the Application Generator names modules by taking the first five characters of the .APP file name, then adding a three digit number for each module. See Also: See Also: Using DLLs not created in Clarion
	The MODULE name for an External procedure should not be modified.
Declare Globally	Check this box to generate the procedure's prototype into the PROGRAM's MAP, rather than the MODULE's MAP. This makes the procedure callable from any other procedure, but it also forces a recompile of all program modules whenever you change the prototype.
Export Procedure	Declares the procedure in the export file, enabling it to be called by another application. Note:This checkbox is only available when the target file specified in Application Properties is a Dynamic Link Library (.DLL).
Tables	This button is not valid for this procedure type.
Window	The Window button is disabled for this procedure type.
Report	The Report button is disabled for this procedure type.
Data	This button is not valid for this procedure type.
Procedures	Opens the Called Procedures dialog to add (or remove) a procedure to the Application Tree. To add a procedure, press the Insert button, then type the procedure name in the next dialog.

The purpose of the Procedure button is to add procedures called in embedded source code. In all other cases the Application Generator automatically adds procedures to the tree.

Embeds	This button is not valid for this procedure type.
Formulas	This button is not valid for this procedure type.
Extensions	This button is not valid for this procedure type.