Clarion Community Help

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

The Splash Template generates code to display a window with an image and some text on a 3-D bevelled panel. The window closes automatically after a specified amount of time. In addition, you can optionally allow the user to close the window at any time by CLICKING on it.

Frame procedures are designed to optionally call Splash procedures. Alternatively, you can call Splash procedures with embedded source code.

By convention, a splash procedure provides a visual or audio (or both) fanfare for your program. A splash screen can provide a recognizable logo or icon whose familiarity may raise the user's comfort level and may serve as an advertisement for your program. Additionally it diverts the user's attention from the sometimes boring task of loading and initializing the program.

Procedure Name	The Procedure Name is displayed here. Press the ellipsis button to change the name if desired. You will be prompted for a New Procedure Name, and the ability to Accept or Discard your changes.
Template	The base template type used by this procedure is displayed here. You can change the template type by pressing the ellipsis button to the right. The Select Procedure Type dialog is displayed for a new selection if needed.
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	A category is used to help you group procedures together when the Category Tree Mode is active.
Module Name	The source code file to hold the code for the procedure. Select from the dropdown 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.
Prototype	Allows you to optionally type a custom procedure prototype which the Application Generator places in the MAP section.
Parameters	Allows you to optionally enter any parameter names (a list of variables separated by a comma)
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).
Actions	If any control templates were pre-defined in the current procedure template, or were in a window or report by you, this button accesses the Actions dialog for the control templates.Control templates provide “off the rack” controls, such as list boxes, and the code to maintain them. This allows you to start with a “bare” procedure template, such as the generic window, and add controls to create your own browse or form windows.
Window	Calls the Window Designer, to visually design the window. Press the ellipsis button to access the Window Editor.
Report	Calls the Report Designer, to visually design the window. Press the ellipsis button to access the Report Editor.
	In the Actions dialog:
Parameters	Lets you specify parameter names (an optional list of variables separated by commas, with the entire list surrounded by parentheses) for your procedure, which you can pass to it from a calling procedure. You must specify the functionality for the parameters in embedded source code. See Also: PROCEDURE Calls .
Return Value	For functions, lets you specify the variable receiving the return value.
Window Behavior	Press this button to control the behavior of the Window. See Window Behavior
ListBox Styles	Press this button to maintain any List Box Styles used by this procedure. See List Box Styles.
BIND Fields and Procedures	Press this button to maintain all BINDed variables and procedures used in this procedure. See BIND Fields and Procedures.
Display Time (in seconds)	Specifies the maximum amount of time the splash window remains displayed.
Close when the user clicks on the splash window	Checking this box lets the user close the window at any time by CLICKING on it.
INI File Settings	Checking the Save and Restore Window Location specifies that a window's location is stored in the application's .INI file, and will open in that position the next time the procedure is called. This is available only if you enable INI File settings in the Global Properties dialog.

Propcedure Property Tabs