
<<Application Generator General Information>>

The Clarion Application Generator is a "core" area of Clarion
for DOS. It is the tool you use to create your applications.The
Application Generator writes the Clarion language source code which
is then compiled into your application's .EXE file. It calls all
the design tools needed to create your application: Screen,
Pulldown Menu, and Report Formatters; the Text Editor, allowing you
to embed custom Clarion source code; the Formula Formatter,
enabling you to generate Computed and Conditional fields with no
possibility of syntax errors (it's menu-driven); and more...

Before using the Application Generator to create an application,
you must first create its Database Dictionary in the Dictionary
Editor.  The Database Dictionary defines all the files the
application may access, their fields, keys, and relationships.
The Database Dictionary is required to create an application
which accesses any data files.

The Application Generator is "driven" by Template (.TPL) files.
These contain the procedure Templates which the Application
Generator uses to generate your application's Clarion source
code.  These procedure Templates are flexible enough to generate
code which is specific and optimized for your application's
needs, based on the information you provide at the time you
design your application.  See the Template Language Reference
for an in-depth discussion of the Template files.


<<File Menu>>

The File menu contains selections for the normal file operations
of the Application Generator.

<New...>
New...                                    ( F2 or ALT+F N )
     Creates a new file.  You specify the type of file you are
     creating (Application, Dictionary, Database, Text, or Help) and
     its name.  The new file is created and you are automatically
     placed in that file type's functional area.

<Open...>
Open...                                   ( F3 or ALT+F O )
     Opens an existing file. You specify the type of file you
     are opening (Application, Dictionary, Database, Text, or Help)
     and the name of the file.  You are automatically placed in that
     file type's major functional area.

<Close>
Close                                     ( ALT+F C )
     Closes the open Application file, exits the Application
     Generator, and returns you to the Clarion opening screen.

<Change Directory...>
Change Directory...                       ( ALT+F D )
     Allows you to change the DOS current directory.  It is
     always a good idea to create applications in their own
     separate sub- directories.  Doing this makes it easy to
     identify the files that are part of an application and to
     delete those that are no longer needed when the application
     is complete (.OBJ files are one good example).

<Save>
Save                                      ( CTRL+S or ALT+F S )
     Saves the open Application file without closing the file or
     exiting the Application Generator.

<Save As...>
Save As...                                ( CTRL+A or ALT+F A )
     Saves the open Application file to the new name you
     specify, leaving you in the new Application.  This allows
     you to copy an entire Application to a new name, then
     immediately modify the new file to create a new
     Application.

<Print>
Print                                     ( CTRL+P or ALT+F P )
     Prints a listing of the procedures in the Application.

<Printer Setup...>
Printer Setup...                          ( ALT+F T )
     Allows you to setup your printer for the printing tasks
     you do through the Clarion environment.  It allows you to
     specify the destination (a file or the port to which your
     printer is connected), lines and columns per page, and
     pre-print and post-print printer control code strings.

<Application Properties...>
Application Properties...                 ( CTRL+O or ALT+F R )
     Displays the Application's Properties window, allowing you
     to update the information entered there.

<Global Settings>
Global Settings                           ( CTRL+G or ALT+F G )
      Displays the Global Settings Window, allowing you to modify
      your application's Global Settings.



<Repopulate Source Modules...>
Repopulate Source Modules...              ( CTRL+U or ALT+F U )
     Displays the Repopulate Source Modules... window, allowing
     you to change the source code module assignments for all
     generated procedures.

<Delete Empty Modules...>
Delete Empty Modules...                   ( ALT+F E )
      Deletes all modules in the application which no longer
      have procedures assigned to them.  This only deletes the
      module references within the application file (.APP) -- it
      does not delete any files from disk.

<Exit>
Exit                                      ( CTRL+X or ALT+F X )
     Closes the open Application file, exits the Application
     Generator, and returns you to the Clarion opening screen.


<<Edit Menu>>

The Edit menu contains selections which allow you to maintain
the individual procedures and modules contained in the
Application.  The action taken by each depends upon which View
of the Application you are currently working in.

<Insert>
Insert                                    ( ALT+E I )
     Add a Procedure or Module to the Application.

<Change>
Change                                    ( ENTER or ALT+E H )
     Modify an existing Procedure or Module in the Application.

<Delete>
Delete                                    ( ALT+E D )
     Remove a Procedure or Module from the Application.

<Change Template>
Change Template...                        ( CTRL+T or ALT+E T )
     Displays the Change Procedure's Template window, allowing
     you to change the procedure Template used to generate the
     procedure's source code.  This automatically converts the
     existing procedure to a new procedure type. If the
     procedure Templates are dissimilar it is possible that
     some portion of the procedure required by the old Template
     may not be used by the new Template.  This (now-unused)
     work is automatically saved.

<Copy>
Copy                                      ( CTRL+C or ALT+E C )
     Copy an existing Procedure or Module within the
     Application.

<Move>
Move                                      ( CTRL+M or ALT+E M )
     Change the relative position of a Procedure or Module
     within the Application.

<Find>
Find                                      ( CTRL+F or ALT+E F )
     Calls the Find Procedure or Find Module window to search
     for a procedure in the "Procedure Call Tree" (in the
     Procedures View) or Modules List (in the Module View).

<Find Next>
Find Next                                 ( CTRL+N or ALT+E N )
     Finds the next occurrence of the procedure or module for
     which you are searching.

<Import>
Import                                    ( CTRL+I or ALT+E P )
     Displays a sub-menu allowing you to import a Procedure
     from another Application.

<Clarion 3.x APP...>
Clarion 3.x APP...                        ( ALT+E 3 )
     Import one or multiple Procedures (or Global Data) from a
     Clarion 3.x Application.

<Clarion 2.1 APP...>
Clarion 2.1 APP...                        ( ALT+E 2 )
     Import one or multiple Procedures (or Global Data) from a
     Clarion 2.1 Application.

<Modify Dictionary>
Modify Dictionary
     Accesses the Database Dictionary, allowing you to add or edit
     files, fields, keys, or relations. This must be enabled through
     Application Options (choose Options from the Project Menu).

     If you modify a Dictionary from this point, changes are NOT
     saved unless you save the Application file. See Chapter 5 of
     the User's Guide for complete information on modifying a
     dictionary through the Application Generator.

<<View Menu>>

The View menu contains selections which allow you to change
between the two methods of displaying the Application Generator
worksheet.  The Application Generator always displays all
procedures and functions in the Application.  However, there
are two ways of looking at them:

<Procedures>
Procedures                                ( CTRL+P or ALT+V P )
     Displays your Application as a "Procedure Call Tree."  The
     Procedure Call Tree shows how an application's procedures
     are connected--which procedure calls which.  This is very
     useful for visualizing the application's logic flow from
     one procedure to the next.  Procedure names are connected
     and/or placed on the Procedures Worksheet whenever the
     Application Generator detects that one procedure makes a
     call to another.


<Modules>
Modules                                   ( CTRL+L or ALT+V M )
     Displays your Application as a listing of its source code
     files (MEMBER Modules).  This shows the application's
     procedures based upon which source module (.CLA file) will
     contain the procedure's source code when the Application
     Generator generates it.  In this view, each procedure in
     the application appears only once--under the module in
     which its code will reside.


<<Project Menu>>

The Project menu in the Application Generator contains
selections which allow you to generate your application's
source code, compile, link, and debug your applications.  The
term "Make," as used from the Application Generator, takes on
added meaning from its use elsewhere in the Clarion environment.
In the Application Generator (only) it means to first generate
the application's Clarion language source code, then to compile
and link that generated source.

Compiling and linking are both controlled by Project (.PR) files
(see the Project and Redirection Files section in the User's Guide).
Each application you create has one Project file. A Project file
always has the same filename as the application, with a .PR
extension.  Each application's Project file is automatically created
for you by the Application Generator.

<Make and Run>
Make and Run                              ( ALT+A or ALT+P A )
     Generates Clarion source code, compiles, and links your
     application to an .EXE file.  When the .EXE file is
     complete, your application is automatically executed.

<Make and Debug>
Make and Debug                            ( ALT+K or ALT+P K )
     Compiles and links your application to an .EXE file.  When
     the .EXE file is complete, your application is executed
     under the Visual Interactive Debugger (VID).  You must have
     already specified Debug Settings in the application's
     Project file, otherwise VID will not execute the
     application (see the VID documentation in the User's
     Guide).

<Make>
Make                                      ( ALT+M or ALT+P M )
     Generates Clarion source code, compiles, and links your
     application to an .EXE file.

<Run>
Run                                       ( ALT+R or ALT+P R )
     Runs your application.  This assumes that you have already
     generated source, compiled, and linked.

<Debug>
Debug                                     ( ALT+D or ALT+P D )
     Runs your application under VID.  This assumes that you
     have already generated source, compiled, and linked with
     Debug Settings in the Project file.

<Compile and Link>
Compile and Link                          ( ALT+P P )
     Compiles and links your application's previously generated
     source code to an .EXE file.

<Change Project File...>
Change Project File...                    ( ALT+N or ALT+P N )
     Maintains the settings in the currently loaded Project
     file. The Project file settings determine exactly how your
     application is compiled and linked.

<Generate Source>
Generate Source                           ( ALT+G or ALT+P G )
     Generates the Clarion language source code for your
     application without compiling or linking.

<Options...>
Options...                                ( ALT+O or ALT+P O )
     Calls the Application Options window to allow you to
     specify various code generation options.


<<Tools Menu>>

The Tools menu contains a number of utilities which are useful
throughout the environment.

<DOS Shell>
DOS Shell                                 ( F10 or ALT+T D )
     Calls Clarion's disk maintenance program (CSHELL).

<DOS Prompt>
DOS Prompt                                ( ALT+T R )
     Temporarily exits to DOS to execute some DOS command(s).
     It saves the current state of the Clarion environment to a
     temporary file, frees most of the memory used by the
     Clarion environment, and loads a second copy of
     COMMAND.COM. To return to Clarion from this DOS prompt,
     type "Exit" and press ENTER.

<Calculator...>
Calculator...                             ( ALT+T C )
     Calls Clarion's built-in programmer's calculator.

<ASCII Chart...>
ASCII Chart...                            ( ALT+T A )
     Brings up a list of all the ASCII codes.  The chart
     contains each ASCII display character, and the Decimal,
     Hexadecimal, and Octal numbers which represent that
     character.

<Color Chart...>
Color Chart...                            ( ALT+T L )
     Displays a list of all the Color Style Codes.  Each
     possible color combination is in the list along with the
     decimal number which represents it.

<Keycode Chart...>
Keycode Chart...                          ( ALT+T K )
     Displays a list of all the Clarion Keycodes.  Each possible
     key combination is in the list along with the decimal
     number which represents it.


<<Clarion Menu>>

The top section of items in the Clarion menu bring up "task
lists" of the last four projects you worked with in each of the
major functional areas.  This allows you to return directly to
a task you've already worked on, without the necessity of going
through the Open... screen from the File menu.  Selecting a
previous task from one of these lists does not automatically
change to the directory which contains the file.

In addition to re-selecting a previous task, you may also access
the New... and Open... screens through the task list screen by
selecting the New... or Open... Pushbutton.  This allows you to
check for a previous task, then immediately create or open the
file you want without returning to the File menu if the desired
task is not in the list.

<Load Application...>
Load Application...                       ( F4 or ALT+C A )
     Allows you to select one of the last four Application files
     in which you worked, or to create or open an Application
     not on the task list.  This selection takes you directly
     into the Application Generator with the selected file
     loaded.  SHIFT+ F4 immediately loads the last Application
     on which you worked.

<Load Dictionary...>
Load Dictionary...                        ( F5 or ALT+C D )
     Allows you to select one of the last four Dictionary files
     in which you worked, or to create or open a Dictionary not
     on the task list.  This selection takes you directly into
     the Dictionary Editor with the selected file loaded.
     SHIFT+F5 immediately loads the last Dictionary on which you
     worked.

<Load Database...>
Load Database...                          ( F6 or ALT+C B )
     Allows you to select one of the last four Database files in
     which you worked, or to create or open a Database not on
     the task list.  This selection takes you directly into the
     Database Manager with the selected file loaded.  SHIFT+F6
     immediately loads the last Database on which you worked.

<Load Text...>
Load Text...                              ( F8 or ALT+C T )
     Allows you to select one of the last four Text files in
     which you worked, or to create or open a Text file not on
     the task list.  This selection takes you directly into the
     Text Editor with the selected file loaded.  SHIFT+F8
     immediately loads the last Text file on which you worked.

<Load Help...>
Load Help...                              ( F9 or ALT+C H )
     Allows you to select one of the last four Help files in
     which you worked, or to create or open an Help file not on
     the task list.  This selection takes you directly into the
     Help Editor with the selected file loaded.  SHIFT+F9
     immediately loads the last Help file on which you worked.

<43/50 Line Mode >
43/50 Line Mode                           ( ALT+C 4 )
     Places the video in 43 or 50 line mode (depending upon
     whether your hardware is EGA or VGA).  This menu selection
     is a toggle switch with a check mark () displayed when
     toggled ON.  The setting is saved in the Clarion
     configuration file.

<System Setup >
System Setup                              ( ALT+C S )
     Displays a sub-menu containing items which allow you to set
     system-wide options.  These are options that affect the
     entire Clarion Environment.

<Options...>
Options...                                ( ALT+C S O )
     Allows you to select a Color Styles file for the Clarion
     environment's use, and/or specify the use of your own text
     editor and DOS shell program (other than the Text Editor
     and DOS Shell which are part of Clarion environment).

<Database Drivers...>
Database Drivers...                       ( ALT+C S D )
     Registers new database file drivers.  There are many more
     database file system drivers available than were provided
     in the shipping disks.  These extra file drivers are
     available directly from TopSpeed Software (call Customer
     Service at 800 354-5444 or (305) 785-4555 for more
     information). Once you receive a new file system driver,
     you must register its presence before the Clarion
     environment will be able to use it.

<Search Paths... >
Search Paths...                           ( ALT+C S S )
     Maintains Redirection files.  Redirection files are used by
     the Project system.  They provide individual search paths
     for specific files the compiler and linker need to find to
     accomplish their tasks (see the Project and Redirection Files
     section in the User's Guide).

<Edit Styles...>
Edit Styles...                            ( ALT+C S E )
     Maintains any Color Style Code file.  Color Style Code
     files are ASCII files containing a list of color codes used
     in your application's SCREEN structures and the actual
     colors to be used for those codes (see the Screen Color
     Schemes chapter in the User's Guide).

<Printer Controls...>
Printer Controls...                       ( ALT+C S P )
     Allows you to maintain Printer Control files for the
     Clarion environment and your applications (logical printer
     support through the PRINTER report attribute).  It allows
     you to specify the port to which each printer is connected
     and printer control code strings for the print effects of
     which each printer is capable.


<<Help Menu>>

Context-sensitive Help screens are available throughout the
Clarion for DOS environment through the F1 key.  The
Help menu contains selections which provide separate access to
the Help system.

<Using Help >
Using Help                                ( ALT+H U )
     Provides information on how to use the Help system.

<Help Index >
Help Index                                ( ALT+H H )
     Displays an Index of all Help screens available in the
     major functional area, allowing you to view a Help screen
     for a particular context when not actively in that context.

<About...>
About...                                  ( ALT+H A )
     Displays a screen with the program and copyright
     information for this specific release of Clarion Database
     Developer.

<<Generation Status Display Window>>
<Source Generation Messages>
The "Source Generation Messages" contains a list of code
generation errors and warnings. Pay attention to the messages
displayed; some code generation errors will cause Compiler
errors.  Source Generation Messages can also point to code that
will compile and run, but will affect the behavior of the
generated procedure.

Cancel Button
     Pressing this button cancels the Generation/Compile/Run
     operation and returns you to the Application Generator.

Continue Button
     Press this button to continue, ignoring the source
     generation warnings displayed.

Print Button
     Press this button to print the errors and warnings found
     during source code generation.  After printing the messages
     you can either "Cancel" or "Continue".

<<Template Errors Window>>

The Template Errors window displays a list of the template
errors and warnings found during pre-processing of the active
template file chain.

<Edit Button>
Edit Button
     Press this button to go directly to the Text Editor to
     edit the errors and warnings found in the active template
     file chain.

<Cancel Button>
Cancel Button
     Press this button to cancel editing the errors and warnings
     found during pre-processing of the active template file
     chain.

     Another template (.TPL) file must then be specified on the
     Application Properties window before continuing with the
     application.

<Continue Button>
Continue Button
     Press this button to continue, ignoring the template
     warnings displayed.

<Print Button>
Print Button
     Press this button to print the errors and warnings found
     during pre-processing of the active template file chain.

<<Save Application As Window>>

The Save Application As window allows you to copy an entire
application to a new .APP file.

<Application Name:>
Application Name:
     Enter the filename to which you want to save the
     application (without extension).


<<Repopulate Source Modules Window>>

The Repopulate Source Modules window allows you to change the
source code module assignments for all generated procedures.

<Procedures Per Module:>
Procedures Per Module:
     Enter the number of procedures to automatically place in
     each generated source code module.  The default value is the
     value contained in the Application Generator Options window.
     The value entered here overrides the default value and
     becomes the new default.

<Static Call Tree Optimization>
() Static Call Tree Optimization
     This repopulation method performs an analysis of the static
     call tree to group related called procedures into common
     source modules. The analysis first groups procedures which
     occur in "the longest call paths" before considering the
     same procedures which also occur in a shorter call path.

     Procedures Per Module is still used during the repopulate
     to limit the "maximum" number of procedures in any module
     independent of the analysis.

<Alphabetical by Procedure>
() Alphabetical by Procedure
     This repopulation method groups procedures in alphabetical
     order using Procedures Per Module to limit the number of
     procedures in any module.

<Delete Empty Source Modules>
[] Delete Empty Source Modules
     Check this box to automatically delete the source modules
     which will no longer have generated procedures assigned to
     them.  This only deletes the empty source module references
     within the application file (.APP) -- it does not delete
     any files from disk.

<Put Procedures in Main Module>
[] Put Procedures in Main Module
     Check this box to place generated source modules in the
     main program module.  Generated procedures are not placed
     into the main module unless this box is checked.  To
     generate a program completely within the main module, check
     this box and enter a Procedures Per Module number greater
     than the total number of procedures in the application.

<Move Procedures from User-Defined Modules>
[] Move Procedures from User-Defined Modules
     Check this box to move generated source procedures from any
     modules which you have created (not automatically generated
     by the Application Generator).


<<Change Procedure's Template Window>>

The Change Procedure's Template window allows you to change the
procedure Template used to generate the procedure's source code.
This automatically converts the procedure to the new procedure
type.

WARNING: if the procedure Templates are dissimilar it is
possible that some portion of the procedure required by the old
Template may not be used by the new Template.  This (now-unused)
work is saved for you.  For example, if the current Template
contains a SCREEN structure and the new Template does not, a
warning is issued as the Template is being changed.  The SCREEN
is still left in the .APP file and you may update it through the
Screen Formatter, but no source code will generate for it.  The
same is true for any embedded source points that do not exist in
the new Template -- the source is saved and may be accessed
through the Source... button as an "UNREFERENCED" embed.

<Procedure Name:>
Procedure Name:
     Displays the name of the procedure being changed.

<Current Template:>
Current Template:
     Displays the procedure Template currently used to generate
     source code for the procedure.

<New Template:>
New Template:
     Enter the name of the new procedure Template to use to
     generate source code for the procedure.


<<Find Procedure Window>>

The Find Procedure window allows you to search for a specific
procedure in a large application.

<Find Name:>
Find Name:
     Enter the name of the procedure to locate. The asterisk
     (*) wildcard may be used (after at least one beginning
     letter) to search for a procedure beginning with the
     specified letter(s).

<Search from Top of View>
[] Search from Top of View
     Specifies the search starts at the top of the Procedure
     View. Otherwise, the search begins at the currently
     highlighted procedure.


<<Find Module Window>>

The Find Module window allows you to search for a specific
source code module in a large application.

<Find Name:>
Find Name:
     Enter the name of the module to locate.  The asterisk (*)
     wildcard may be used (after at least one beginning letter)
     to search for a module beginning with the specified
     letter(s).

<Search from Top of View>
[] Search from Top of View
     Specifies the search starts at the top of the Modules View.
     Otherwise, the search begins at the currently highlighted
     module.


<<Import From Clarion 3.x Window>>

The Import From Clarion 3.x window allows you to copy one or
multiple procedures from another Clarion 3.x .APP file.

<From:>
From:
     Specifies where the procedure is being copied from.

<Application:>
Application:
     Enter the name of the .APP from which the procedure(s) will
     be copied.

<Module:>
Module:
     Enter the name of the module to copy.

<Procedure:>
Procedure:
     Enter the name of the procedure to copy.

<To:>
To:
     Specifies where the procedure is being copied to.

<Module:>
Module:
     Enter the name of the module to copy the procedure into.

<Procedure:>
Procedure:
     Enter the new name of the copied procedure.

<Import Global Data>
[] Import Global Data
     Check this box to copy Global Data declarations from
     another Clarion 3.x .APP file.


<<Import From Clarion 2.1 Window>>

The Import From Clarion 2.1 window allows you to copy one or
multiple procedures (or Global Data) from a Clarion 2.1 .APP
file.

<From:>
From:
     Specifies where the procedure is being copied from.

<Application:>
Application:
     Enter the name of the 2.1 .APP from which the procedure(s)
     will be copied.

<Module:>
Module:
     Enter the name of the module to copy.

<Procedure:>
Procedure:
     Enter the name of the procedure to copy.

<To:>
To:
     Specifies where the procedure is being copied to.

<Module:>
Module:
     Enter the name of the module to copy the procedure into.

<Procedure:>
Procedure:
     Enter the new name of the copied procedure.

<Import Global Data>
[] Import Global Data
     Check this box to copy Global Data declarations from a
     Clarion 2.1 .APP file.


<<Copy Procedure Window>>

The Copy Procedure window allows you to copy one procedure
within the current .APP file.

<From:>
From:
     Specifies where the procedure is being copied from.

<Application:>
Application:
     Displays the name of the .APP from which the procedure is
     copied.

<Module:>
Module:
     The name of the module to copy.

<Procedure:>
Procedure:
     Enter the name of the procedure to copy.

<To:>
To:
     Specifies where the procedure is being copied to.

<Module:>
Module:
     Enter the name of the module to copy the procedure into.

<Procedure:>
Procedure:
     Enter the new name of the copied procedure.


<<Application Procedures Window>>

The Application Procedures window displays a list of the
procedures in the application (or files in a 2.1 .APP),
allowing you to tag multiple procedures (or files) to import.
In addition to pressing the buttons, pressing the space bar
tags/untags the currently highlighted procedure.

The import operation does not occur until you press the Ok
button.

<Select Button>
Select Button
     Press this button to tag the currently highlighted
     procedure (or file).

<Deselect Button>
Deselect Button
     Press this button to untag the currently highlighted
     procedure (or file).

<Select All Button>
Select All Button
     Press this button to tag all procedures (or files).

<Deselect All Button>
Deselect All Button
     Press this button to untag all procedures (or files).

<Ok Button>
Ok Button
     Press this button to import all tagged procedures (or
     files). If none are tagged, the currently highlighted
     procedure (or file) is imported.

<<Select Files to Import Window>>

The Select Files to Import Window displays a list of the
files in a dictionary, allowing you to tag multiple files) to
import.

In addition to pressing the buttons, pressing the space bar
tags/untags the currently highlighted file.

The import operation does not occur until you press the Ok
button.

<Select Button>
Select Button
     Press this button to tag the currently highlighted
     file.

<Deselect Button>
Deselect Button
     Press this button to untag the currently highlighted
     file.

<Select All Button>
Select All Button
     Press this button to tag all files.

<Deselect All Button>
Deselect All Button
     Press this button to untag all files.

<Ok Button>
Ok Button
     Press this button to import all tagged files.
     If none are tagged, the currently highlighted file
     is imported.


<<Application Options Window>>

The Application Options window allows you to specify code
generation options.

<Default Template File:>
Default Template File:
     Name the Template file to automatically appear on the
     Application Properties window when you first create a new
     application. This selection may be overridden at
     application creation time.

<Procedures Per Module:>
Procedures Per Module:
     Enter the maximum number of procedures which the
     Application Generator will automatically place in a source
     code module before creating a new module.  This only governs
     Application Generator's automatic module placement -- not
     your ability to move procedures between modules after they
     are created.

     If you enter zero (0), Application Generator's automatic
     module creation is disabled.  This allows you to create an
     application which is completely contained in one module, or
     to control all module creation and placement yourself.

<Conditional Generation>
[] Conditional Generation
     Toggles the conditional generation of your application's
     source code during a Make or Generate Source. When ON,
     only the modules containing source code which has been
     changed are generated.  When OFF, all source code is
     generated for the application.

<Template Warnings>
[] Template Warnings
     Toggles the display of warning messages during Template
     file pre-processing.  When ON, warnings are displayed.  When
     OFF, warnings are not displayed.

<Dictionary Changes>
[]Dictionary Changes
     Toggles the ability to modify the database dictionary.

     Note: This cannot be enabled if the Dictionary and Application
           files have the same name and path.

<Option Strings>
[] Option Strings
     Toggles the use of Option Strings. If this is disabled Radio
     Buttons are used.

<<Procedures and Modules Worksheets>>

The Application Generator always displays all procedures and
functions in the Application.  However, there are two ways of
looking at them:  the Procedures Worksheet and the Modules
Worksheet.

<Procedures Worksheet>
Procedures Worksheet
     The Procedures Worksheet displays your Application as a
     "Procedure Call Tree." The Procedure Call Tree shows how
     the application's procedures are connected--which procedure
     calls which.  This is very useful for visualizing the
     application's logic flow from one procedure to the next.
     Procedure names are connected and/or placed on the Logical
     Worksheet whenever the Application Generator detects that
     one procedure makes a call to another.

     When a procedure calls another procedure, and that second
     procedure has not yet been defined, it is listed as (ToDo).
     This indicates that the Application Generator has determined
     that you intend to have a procedure with this name, but you
     have not yet told it which Template procedure it will use
     to generate source code.  Once you have defined a procedure,
     it appears with the name of the Template procedure in place
     of the (ToDo).

     If one procedure is called by several other procedures,
     that one procedure (and any procedure which it calls)
     appears in the Procedures Worksheet multiple times--once
     under each procedure from which it is called.  However,
     there is actually only one copy of that procedure.
     Modifying the procedure from one instance on the Procedures
     Worksheet modifies it for every procedure which calls it.

<Modules Worksheet>
Modules Worksheet
     The Modules Worksheet displays your Application as a
     listing of its source code files (MEMBER Modules).  This
     shows the application's procedures based upon which source
     module (.CLA file) will contain the procedure's source code
     when the Application Generator generates it.  In this view,
     each procedure in the application appears only once -- under
     the module in which its code will reside.

     The Modules Worksheet is most useful for managing the
     logical grouping of procedures in source modules.  This
     allows you to optimize the organization of your
     application's source modules for the use of Overlays and
     DLLs (see the chapter on Overlays and DLLs in the
     User's Guide).


<<Application Properties Window>>

When you first create an application, the Application Properties
window appears.  The information you provide here is used by the
Application Generator (processed through the Template files) to
generate the Global (PROGRAM) area of the application's source
code, both data and executable code.

<Application Name:>
Application Name:
     Displays the name you gave the application (.APP file).
     This is also the name used for: the main source code module
     (.CLA file) the Application Generator creates, the Project
     (.PR file) which controls the compile and link steps for
     the application, and the application's resulting .EXE file.

<Template File:>
Template File:
     Enter the name of the Template (.TPL file) the Application
     Generator will use to generate your source code.  Multiple
     Template files may be chained together, making one logical
     Template from many physical files.  The Template File you
     name here is assumed to be (and must be) the first in the
     chain of Template files.  If there are subsequent Template
     files chained to the selected file, they are automatically
     detected when the Template is pre-processed.

<Dictionary File:>
Dictionary File:
     Enter the name of the Database Dictionary (.DCT file) the
     application will use.  This defines the data files the
     application will access.  An application may have only one
     Database Dictionary, therefore all files needed by the
     application must be declared in the same Dictionary (the
     application need not use all the files defined in the
     Database Dictionary). Whenever you are prompted you for
     any FILE related information (the name of a FILE, KEY, etc.)
     the list of valid choices automatically appears from the
     Database Dictionary.

<Styles File:>
Styles File:
     Specify the name of the Color Styles file which defines the
     colors the application may use.  If you name a file on this
     line, the color selections available for your screen
     designs are obtained only from this file (see GETSTYLES and
     Color Style Codes in the Language Reference, and the Screen
     Color Schemes chapter in the User's Guide).

<Help File:>
Help File:
     Specify the application's Help (.HLP) File.

     NOTE: If you specify a complete Drive and Path specification
     for the Help File, that drive and path will be used when
     generating the source code.  Thus, your final executable
     will be looking for the help file in the drive and path
     that was specified.

<First Procedure:>
First Procedure:
     Enter the name of the first procedure the application will
     call (usually the application's main menu).

<Global Settings... Button>
Global Settings... Button
     Calls the Global Settings window which contains the Global
     section prompts for programmer input from the Template.
     The Global Settings window is not available until you have
     chosen a Template File and it has been pre-processed (if
     necessary). Once you have chosen a Template File, it
     automatically appears to allow you to enter the requested
     data.


<<Global Settings Window>>

The Global Settings window sets the pattern for all the
Procedure Properties windows in your application.  It asks you
to provide specific information in entry fields on the left side
of the screen and allows you to call other functional areas of
the Clarion environment from the buttons on the right. Any button
that contains existing data has a check () beside it.

Some of the entry fields on the left may pop up a list (of
FILEs, KEYs, etc.) from which you may select.  Others simply ask
that you type in the requested information.  The Pushbuttons on
the right perform the same functions on each Properties screen.
Only the choices that are appropriate for a particular screen
are available, the others are dimmed.

<Files...Button>
Files...Button
     Calls the Application File Settings window, allowing you to
     specify the application's default file settings and any
     individual file overrides.

<Data... Button>
Data... Button
     Calls the Field Worksheet of the Dictionary Editor to
     declare memory variables.  The scope of the variable may be
     declared global or local: from the Global Settings screen
     these are global memory variables, from a Member Module
     Properties screen these are local to the MEMBER Module, from
     a Procedure Properties screen these are local to the
     procedure.

<Source... Button>
Source... Button
     Displays a list of the positions in the Template procedure
     where you may place your own embedded Clarion source code.
     When you select a code window, the Text Editor is called to
     allow you to write the code. Once you are in the Text
     Editor editing any code window, you may write any valid
     Clarion source code to accomplish any task possible in the
     Clarion language.

     Embedded source code windows allow you to customize your
     application.  The Application Generator allows explicit
     embedded source code windows wherever they are declared in
     the Template by the #EMBED Template Language statement (see
     the Template Language Reference).  In addition to these
     explicit code windows, there are also implicit code windows
     for every data entry field placed on your application's
     screens (both pre-edit and post-edit), and the body detail
     section and all group headers and footers in a report (pre-
     print and post-print).

<<Application File Settings Window>>
Application File Settings Window
     The Application File Settings window allows you to
     specify the application's default file settings and any
     individual file overrides.

<Default File Settings>
Default File Settings
     Press this button to specify the application's default
     file settings.

     A file can be opened in several different modes which control
     the operations a user and all other users can perform on the
     data. The Application Generator allows you to specify the
     default file settings. If desired, you can override these
     settings for individual files.

<Add>
Add
    Press this button to add file overrides for a specific file.

<Change>
Change
    Press this button to modify file overrides for a specific file.

<Delete>
Delete
    Press this button to delete file overrides for a specific file.

<<Default File Settings>>
Default File Settings

The two default file access modes in the Application Generator are
Default Open Mode and Default Share Mode. For more information,
see OPEN and SHARE in the Language Reference.

You can choose one of these settings as the default or choose the
Custom option.

<Default Open Mode>
Default Open Mode
       This access mode is Read/Write Deny Write (22h), which only
       allows exclusive (single-user) disk write access to the
       user opening the file.

<Default Share Mode>
Default Share Mode
       This access mode is Read/Write Deny None (42h), allowing
       non-exclusive (multi-user) access to anybody who opens the
       file.

<Custom Mode>
Custom  Mode
       This allows you to specify a custom access mode. Marking
       this radio button enables the File Access Mode groups of
       radio buttons. You can choose one mode from the User Access
       group and one mode from the Other's Access group. These
       settings allow you to utilize several driver-specific
       options.


<User Access>
User Access

Read/Write
      Open the file for both read and write access

Read Only
      Open the file for read access only
Write Only
      Open the file for write access only

<Other's Access>
Other's Access

Deny None
     Grant other users total access to the file. This is the default Share Mode. In this mode, any program can open the file any number of times.

Deny Write
     Grant other users access to the file only in Read Only mode.

Deny Read
     Grant other users access to the file only in Write Only mode.

Deny All
     Deny any access to the file.

FCB Mode
     Grant other users total access to the file in File Control Block     Mode, but limit other's to FCB Mode to open the file. This is functionally equivalent to Deny None, but is provided for downward compatibility. FCB Mode is used for versions


     Tip: Clarion presets the default file access mode to SHARE
          (Multi-user mode). If you are developing most of your
          applications for a Single user environment, you can
          modify the Default File Settings in the default
          application -- CD31.APP.

<File Create Action>
File Create Action
     Specify the desired action to take if a file is not found.

     () Use Dictionary Setting
             Specifies that the application should use each
             file's setting in the Database Dictionary.

     () Create File ON
             Specifies that the application should create the file
             regardless of the file's setting in the Database
             Dictionary.

     () Create File OFF
             Specifies that the application should not create the
             file regardless of the file's setting in the Database
             Dictionary.

<External File>
External File
    Specifies that files should have the EXTERNAL attribute.

<<File Settings Window>>
File Settings Window
    This window allows you to define file settings for a specific
    file.

    The two default file access modes in the Application Generator
    are Default Open Mode and Default Share Mode. For more
    information, see OPEN and SHARE in the Language Reference.

    You can choose one of these settings as the default or choose
    the Custom option.

<File>
File
   Enter the file label or press the  to select it from a list.

<Default Open Mode>
Default Open Mode
       This access mode is Read/Write Deny Write (22h), which only
       allows exclusive (single-user) disk write access to the
       user opening the file.

<Default Share Mode>
Default Share Mode
       This access mode is Read/Write Deny None (42h), allowing
       non-exclusive (multi-user) access to anybody who opens the
       file.

<Custom Mode>
Custom  Mode
       This allows you to specify a custom access mode. Marking
       this radio button enables the File Access Mode groups of
       radio buttons. You can choose one mode from the User Access
       group and one mode from the Other's Access group. These
       settings allow you to utilize several driver-specific
       options.


<User Access>
User Access

Read/Write
      Open the file for both read and write access

Read Only
      Open the file for read access only

Write Only
      Open the file for write access only

<Other's Access>
Other's Access

Deny None
     Grant other users total access to the file. This is the default Share Mode. In this mode, any program can open the file any number of times.

Deny Write
     Grant other users access to the file only in Read Only mode.

Deny Read
     Grant other users access to the file only in Write Only mode.

Deny All
     Deny any access to the file.

FCB Mode
     Grant other users total access to the file in File Control Block     Mode, but limit other's to FCB Mode to open the file. This is functionally equivalent to Deny None, but is provided for downward compatibility. FCB Mode is used for versions


     Tip: Clarion presets the default file access mode to SHARE
          (Multi-user mode). If you are developing most of your
          applications for a Single user environment, you can
          modify the Default File Settings in the default
          application -- CD31.APP.

<Create File>
Create File
     Specify the desired action to take if a file is not found.

     [] Create File
             Specifies that the application should create the file
             regardless of the file's setting in the Database
             Dictionary.

<External File>
External File
    Specifies that the file should have the EXTERNAL attribute.

<<Select File>>
Select File
    Displays a list of your application's database dictionary
    files. If desired, you may limit this list to only those files
    used in the application. To select a file, press the Select
    button.

<<Module Properties Window>>

The Module Properties window allows you to define the type of
file the Module is.  Information you provide through this window
is used by the Application Generator to generate the
application's MAP structure.  It also generates the MEMBER
module's local data section (between the keyword MEMBER and the
first procedure or function in the module).  Data declared
through this window may only be accessed by the procedures and/or
functions whose source code resides in the module (of course, it
may also be passed as parameters to other procedures).

<Module Name:>
Module Name:
     Enter the name of the file. When defining an External
     Object Module, you may substitute the first three letters of
     the module name with the %clapfx% compiler macro.  The
     %clapfx% macro expands to three letters that indicate the
     memory model being compiled:

         DXV   Static
         DOV   Overlay
         DDV   Overlay with .DLL
         DEV   Protected mode
         DES   Protected mode with .DLL

     For example, if you enter "%clapfx%ABC.LIB" in this field
     then compile in the Static memory model, the linker will
     look for the DXVABC.LIB file to link into the application.

<Description:>
Description:
     Enter an optional description to clarify the contents of
     the file.  If the Module Name is somewhat cryptic, it is a
     good idea to enter a meaningful description.

<Internal Source Module>
() Internal Source Module
     Indicates that the file contains Clarion language source
     code generated by the Application Generator for this
     application.

<External Source Module>
() External Source Module
     Indicates that the file contains Clarion language source
     code which has already been written -- it is not generated
     by the Application Generator for this application.  This
     module type requires a Module Structures Include File.

<External Object Module>
() External Object Module2
     Indicates that the file is a pre-compiled .OBJ or .LIB
     file. This module type requires a Module Structures Include
     File.

<Module Structures Include File:>
Module Structures Include File:
     Enter the name of the file which contains the MODULE
     structure which must be included in the application's MAP
     structure.  This is required for any External Source or
     Object Module.  The MODULE structure must contain the
     prototypes of all procedures in the module which are
     referenced in the application (see MAP and MODULE in the
     Language Reference).

<Data... Button>
Data... Button
     Calls the Field Worksheet of the Dictionary Editor to allow
     you to declare memory variables. Variables declared here
     are available for use only in the procedures whose source
     code will exist in this MEMBER module.

<Source... Button>
Source... Button
     Displays a list of the positions in the MEMBER Module data
     section where you may place your own embedded Clarion source
     code.  When you select a code window, the Text Editor is
     called to allow you to write the code.


<<Procedure Properties Window>>

The Procedure Properties window is the key to defining each
procedure in your application.  This window serves as the center
around which the other functional areas of the Clarion
environment "revolve" when you are designing a procedure for
your application.

The Procedure Properties window appears differently for each
procedure Template, due to the fact that each requires
information specific to that procedure Template.

For help on a specific Template, press the Template Help button.

The procedure Template asks you for its specific information in
the entry fields on the left side of the screen.  Some of these
fields may pop up a list (of FILEs, KEYs, etc.) from which you
may select, others simply ask that you type in the requested
information.  The buttons on the right side of the screen
allow you to call other functional areas of the Clarion
environment for their use in your procedure design (SCREEN,
REPORT, etc.).  Only the choices that are appropriate for the
particular procedure Template you selected are available, the
others are dimmed.  Any button that contains existing data has
a check () beside it.

Complete the Ok Pushbutton and the information -- along with any
designs (SCREEN, REPORT, etc.) -- is stored in your .APP file
for use when the Application Generator creates source code.  If
you complete the Cancel Pushbutton, NONE of the information is
saved -- which includes any changes made to any existing designs
(SCREEN, REPORT, etc.).

<Template:>
Template:
     Displays the procedure Template which will be used to
     generate source code for the procedure.

<Description:>
Description:
     Enter an optional description of the procedure.

<Prototype:>
Prototype:
     If the procedure must receive parameters, or is a FUNCTION,
     you may enter the procedure's prototype in this field --
     everything EXCEPT the procedure's name.  For example, if the
     procedure will receive a STRING data field as a parameter,
     this field would contain:

         (STRING)

     This field automatically receives its default prototype
     from the #PROTOTYPE Template language statement if the
     procedure template requires parameters or is a FUNCTION.
     See "FUNCTION and PROCEDURE Prototypes" in the Language
     Reference and #PROTOTYPE in the Template Language
     Reference.

<Module Name:>
Module Name:
     Enter the name of the source code module in which this
     procedure's source code will be generated.

<Files... Button>
Files... Button
     Calls the File Schematic Definition window to define the
     data files used by the procedure.  The File Schematic
     Definition window displays a graphical representation of the
     procedure's files and their relationships.

     If you press the DELETE key while this button is highlighted,
     you can delete all files you placed in the File Schematic.

<Screen... Button>
Screen... Button
     Accesses the functional area of the environment which
     formats a SCREEN structure.  A SCREEN is a data structure
     designed to provide video user interface.  SCREEN structures
     most commonly handle all the video interface needs in an
     application except pulldown menus.

     If you press the DELETE key while this button is highlighted,
     you can delete the entire SCREEN structure.  This includes
     any procedure calls or embedded source associated with the
     screen fields.

<Report... Button>
Report... Button
     Accesses the functional area of the environment which
     formats a REPORT structure.  A REPORT is a data structure
     designed to provide formatted data output to any valid DOS
     device (printer, file, or video).

     If you press the DELETE key while this button is highlighted,
     you can delete the entire REPORT structure.  This includes
     any procedure calls or embedded source associated with the
     report's detail structures.

<PullDown... Button>
PullDown... Button
     Accesses the functional area of the environment which
     formats a PULLDOWN structure.  A PULLDOWN is a data
     structure designed to provide SAA/CUA compliant pulldown
     menus.

     If you press the DELETE key while this button is highlighted,
     you can delete the entire PULLDOWN structure.  This includes
     any procedure calls or embedded source associated with the
     menu selections.

<Data... Button>
Data... Button
     Calls the Field Worksheet of the Dictionary Editor to
     declare memory variables.  The scope of the variable may be
     declared global or local: from the Global Settings window
     these are global memory variables, from a Module Properties
     window these are local to the MEMBER Module, from a
     Procedure Properties window these are local to the
     procedure.

     If you press the DELETE key while this button is highlighted,
     you can delete all the Local Data variables.

<Formula... Button>
Formula... Button
     Accesses the functional area of the environment which
     formats expressions for Computed and Conditional fields.
     The expression updates the field with the value of the
     expression (Computed field) or conditionally updates it
     (Conditional field).

     If you press the DELETE key while this button is highlighted,
     you can delete all Formulas.

<Procedures... Button>
Procedures... Button
     Informs the Application Generator of any procedure calls
     your embedded source code may make.  This allows the
     Application Generator to know about procedures that it would
     not normally be able to detect.  You may also declare "hot"
     key procedures.

     If you press the DELETE key while this button is highlighted,
     you can delete all the Procedure Calls you added through
     the Procedures Button.

<Source... Button>
Source... Button
     Displays a list of the positions in the Template procedure
     where you may place your own embedded Clarion source code.
     When you select a code window, the Text Editor is called to
     allow you to write the code.  Once you are in the Text
     Editor editing any code window, you may write any valid
     Clarion source code to accomplish any task possible in the
     Clarion language.

     Embedded source code windows allow you to customize your
     application.  The Application Generator allows explicit
     embedded source code windows wherever they are declared in
     the Template by the #EMBED Template Language statement (see
     the Template Language Reference).  In addition to these
     explicit code windows, there are also implicit code windows
     for every data entry field placed on your application's
     screens (both pre-edit and post-edit), and the body detail
     section and all group headers and footers in a report (pre-
     print and post-print).

     If you press the DELETE key while this button is highlighted,
     you can delete all embedded source in all embedded source
     code windows.

<Template Help... Button>
Template Help... Button
     Displays the Help window associated with the procedure
     Template being used to generate the source code for the
     procedure.


<<Internal Source Modules Window>>

The Internal Source Modules window allows you to choose the
source Module in which the procedure's source code will be
generated.  This list displays only the source modules which are
generated by the Application Generator.

<Select Button>
Select Button
     Press this button to choose the currently highlighted source
     module.


<<Insert Procedure Window>>

The Insert Procedure window allows you to give a name to the
procedure you are adding.

<Procedure Name:>
Procedure Name:
     Enter the name of the procedure to add to the application.


<<Procedure Templates Window>>

The Procedure Templates window displays a list of all the
procedure Templates available from the Template file.  You must
choose a procedure Template from this list to create a new
procedure in your application.

<Template Help... Button>
Template Help... Button
     Displays the Help window associated with the currently
     highlighted procedure Template.


<<File Schematic Definition Window>>

The File Schematic Definition window is central to the manner in
which the procedure Templates generate source code for the
procedure.  This window allows you to build the File Schematic
which determines the data files which will automatically be
accessed for you during the procedure.

The File Schematic determines the procedure's Primary file
(first file listed in the File Schematic) and Secondary files
(all other files listed in the File Schematic).  It also
graphically displays the relationships between the files in the
schematic:

     Any Secondary file with a double arrow pointing at it is a
     Child of the file from which the arrow is coming.  Any
     Secondary file with a single arrow pointing at it is a
     Parent (Lookup) of the file from which the arrow is coming.

        Primary
         >Secondary1       (Lookup from Primary)
         >Secondary2       (Lookup from Primary)
         >>Secondary3       (Child of Primary)
            >Secondary4    (Lookup from Secondary3)
            >Secondary5    (Lookup from Secondary3)
            >>Secondary6    (Child of Secondary3)
               >Secondary7 (Lookup from Secondary6)

<Other Data>
The Other Data section of the Files List contains Global and
Local data.  It also may contain any other data files you want
to add to the list of available data elements which are not part
of the File Schematic (the template will not automatically
access these files for you -- you must write embedded source
code for this).

<Files:>
Files:
     This List box displays the File Schematic you build, and
     any Other Data you may want to access during the procedure.

<Access Key:>
Access Key:
     Select the Key you want to use to access the Primary file
     in the File Schematic.

<Insert Button>
Insert Button
     Calls the Select File window to add a file to the Files
     List. If the highlight bar is in the File Schematic section
     of the Files List, only those files which are related to
     the currently highlighted file may be selected.  If the
     highlight bar is in the Other Data section of the Files
     List, any file in the Database Dictionary may be selected.

<Delete Button>
Delete Button
     Deletes the currently highlighted file from the Files List.
     All files related to the highlighted file (connected below
     it) are also deleted.

<Select Button>
Select Button
     Selects the currently highlighted file from the Files List
     and returns it to the tool which called this window.

<Modify Fields>
Modify Fields
      Accesses the Database Dictionary, allowing you to add or edit
      files, fields, keys, or relations. This must be enabled
      through Application Options (choose Options from the Project
      Menu).

     If you modify a Dictionary from this point, changes are NOT
     saved unless you save the Procedure and Application file. See
     Chapter 5 of the User's Guide for complete information on
     modifying a dictionary through the Application Generator.

<Close Button>
Close Button
     Returns to the Procedure Properties window.


<<Select Primary/Related File Window>>

The Select Primary/Related File window displays a list of valid
files to add to the File Schematic or Other Data list of files.
If called from the File Schematic, the list only displays files
related to the currently highlighted file in the Database
Dictionary.  If called from Other Data, or the File Schematic is
empty, the list displays all files in the Database Dictionary.


<<Screen Formatter>>

The Screen Formatter maintains your application's SCREEN
structures.  A SCREEN is a data structure which defines the
video data entry and display fields for the procedure.

All the possible tools that you may use in the Screen Formatter
are accessible through the pulldown menu.  The ESC key activates
the pulldown menu.  Many of the tools have shortcut "hot" keys
which are displayed at the right of each tool's menu selection.

<Screen Formatter Hot Keys>
Screen Formatter Hot Keys

        CTRL+O     Screen Properties
        CTRL+W     Set Window Area
        CTRL+G     Get Captured Screen
        CTRL+U     Undo
        CTRL+C     Copy
        CTRL+M     Move
        CTRL+D     Delete
        CTRL+6     Center on Line
        CTRL+\     Change Case
        CTRL+P     Paint
        CTRL+K     Keyin Color
        CTRL+A     Change Attribute
        CTRL+T     Draw Track
        CTRL+B     Draw Border
        CTRL+R     Use Rulers
        CTRL+F     Process Fields
        CTRL+L     Process List Box Fields
        CTRL+E     Reorder Fields
        CTRL+S     Resize Field

        CTRL+X     Exit


<Default Screens>
Default Screens

When you first enter the Screen Formatter from the Application
Generator, the default SCREEN design for the procedure Template
appears.  This default design comes from the Template's
template.APP file (which you may modify--see the Template
Language Reference).

Default Template SCREENs provide an easy method of maintaining
consistent screen design standards throughout your
application(s).  These default SCREENs also pre-define any
screen fields which the procedure Template requires to correctly
generate source code for your procedure.

Typically, the pre-defined fields in a default SCREEN design are
used for fields like the Ok and Cancel Pushbuttons, which are
standard on most screens and necessary to the correct
functioning of the application.  Since the pre-defined screen
fields may be (probably are) explicitly referenced in the
Template code, they should not be deleted.


<<Screen Formatter's Screen Menu>>

The Screen menu contains selections which affect the entire
screen design:

<Properties>
Properties                                ( CTRL+O or ALT+S O )
     Displays the Screen Properties screen.  This screen allows
     you to specify attributes of the SCREEN statement such as
     the screen opening method (ZOOM, FADE, WIPE, FALL) and
     basic color of the screen (COLOR).

<Hotkey Procedures>
Hotkey Procedures                         ( ALT+S H )
     Calls the Hotkey Procedures window which allows you to
     declare procedures which are called by the user by pressing
     a "Hot" key (usually some function key combination).  These
     "Hot" keys are alerted by the SCREEN statement's ALRT
     attribute and are active for any field on the screen.

<Set Window Area>
Set Window Area                           ( CTRL+W or ALT+S W )
     Allows you to declare the SCREEN's size.  This puts the
     number of rows and columns (SCREEN(rows,cols)) on the
     SCREEN statement.  When these are specified, any video
     overwritten when this SCREEN is opened is saved and restored
     when it is closed.  Access by the keyboard marks a side of
     the window which can be dragged in or out to resize the
     screen.  The mouse can be used by holding down the ALT+ key
     and clicking an edge of the window with mouse button1.  That
     edge may then be dragged in and out as long as mouse button1
     is pressed.

<Get Captured Screen>
Get Captured Screen                       ( ALT+S G )
     Imports a screen design previously captured by Clarion's
     SCRCAP.COM text-mode screen capture TSR (see SCRCAP.COM in
     the User's Guide).  This imports the design only -- any
     screen fields the procedure requires must still be declared.

<Enable Blink>
Enable Blink                              ( ALT+S B )
     Enables foreground blinking (which disables the enhanced
     background colors).  This selection is a toggle switch with
     a check mark () displayed when toggled ON.

<Exit>
Exit                                      ( CTRL+X or ALT+S X )
     Closes the Screen Formatter, offering you the opportunity
     to save the screen design, and returns to the Procedure
     Properties window.


<<Screen Formatter's Edit Menu>>

The Edit menu contains selections which affect individual items
placed on the screen.

<Undo>
Undo                                      ( CTRL+U or ALT+S U )
     Restore the last item deleted by the Delete menu selection.

<Copy>
Copy                                      ( CTRL+C or ALT+E C )
     Copy a portion of the screen design to another part of the
     screen.

<Move>
Move                                      ( CTRL+M or ALT+E M )
     Move a portion of the screen design to another part of the
     screen.

<Delete>
Delete                                    ( CTRL+D or ALT+E D )
     Remove a portion of the screen design from the screen.

<...Data>
...Data                                   ( ALT+E A )
     Enables the Copy, Move, and Delete menu selections to act
     on the data placed on the screen.  This selection is a
     toggle switch with a check mark () displayed when toggled
     ON.

<...Paint>
...Paint                                  ( ALT+E I )
     Enables the Copy, Move, and Delete menu selections to act
     on the colors placed on the screen.  This selection is a
     toggle switch with a check mark () displayed when toggled
     ON.

<Paint>
Paint                                     ( CTRL+P or ALT+E P )
     Paint a portion of the screen design a color different from
     the basic color of the screen.

<Keyin Color>
Keyin Color                               ( CTRL+K or ALT+E K )
     Select the color the next literals placed on screen will
     have.

<Change Attribute>
Change Attribute                          ( CTRL+A or ALT+E A )
     Changes the video display attribute at the cursor's current
     screen position to the color specified by the Keyin Color
     and moves the cursor one position to the right.  If no
     Keyin Color has been specified, no change occurs.

<Draw Track>
Draw Track                                ( CTRL+T or ALT+E T )
     Place tracking characters (most commonly, single or double
     lines) in your screen design.

<Draw Border>
Draw Border                               ( CTRL+B or ALT+E B )
     Allows you to place tracking characters in a rectangle
     around your screen design.

<Ruler Line>
Ruler Line                                ( CTRL+R or ALT+E R )
     Displays numbered vertical and horizontal lines on screen.
     This is an aid to determine exact placement (row and column
     position) of your fields on screen.


<<Screen Formatter's Fields Menu>>

Although the aesthetics of screen design are important (color
selection, tracking characters, etc.), the most important task
in screen design is the placement of fields on the screen for
user entry.  These are the fields from which the end-user
selects pre-loaded data, or enters new data into the database.

When you place a field in your screen design, you should first
position the cursor to the spot where you want the field to be
placed.  If you do not position the cursor first, you could
define two fields to occupy the same place.

<Process Fields>
Process Fields                            ( CTRL+F or ALT+F F )
     Calls the Field List window to display all fields already
     placed on the SCREEN.  This window allows you to add, change,
     or delete fields, and you may change the order in which the
     fields appear in the Field List (which changes the normal
     selection order of the fields at run-time).

<Process List Box Fields>
Process List Box Fields                   ( CTRL+L or ALT+F L )
     Calls the List Box editor allow you to add, change, or
     delete fields from the LIST field's display.  If there is
     more than one LIST field on the screen, this menu selection
     processes the first LIST, unless the cursor is directly on
     another LIST field (the List Box editor is also available
     through the Fields Pushbutton on the List Box Field
     Properties window.)

<Reorder Fields>
Reorder Fields                            ( CTRL+E or ALT+F E )
     Invokes a process which allows you to change the normal
     selection order of the fields already placed on the screen.
     This process re-orders the fields within the SCREEN data
     structure and the Field List window.

<Resize Field>
Resize Field                              ( CTRL+S or ALT+F S )
     Allows a List Box, Text field, or Image field to be
     dynamically resized on the formatter worksheet using the
     mouse or keyboard.  The resizing will automatically adjust
     the Rows and Columns entries for the field.  When selected
     by the keyboard, an edge of the field is highlighted and can
     be dragged in or out using the cursor keys.  Resize is
     completed when Enter is pressed. To select with a mouse,
     position the mouse cursor on an edge of the field, hold down
     the ALT+ key, and click and hold mouse button1.  The edge
     can then be dragged in or out as long as mouse button1 is
     pressed.

<Set Default Colors...>
Set Default Colors...                     ( ALT+F T )
     Select the default display colors for each type of screen
     field.  These default color selections are stored in the
     application's Style file, if the application uses one, or
     the Clarion configuration file (CLARION3.INI), if it
     doesn't.

<Reapply Default Colors...>
Reapply Default Colors...                 ( ALT+F R )
     Automatically re-selects the default display colors for
     each screen field.  This allows you to change the default
     colors and change all fields to use those colors without
     re-creating the colors for each field individually.  If the
     application uses a Styles file, these come from the Styles
     file, otherwise they come from the default colors in the
     CLARION3.INI file.

<Left Align Prompts>
Left Align Prompts                        ( ALT+F L )
     Toggles the automatic PROMPT field positioning mode when
     you add fields to the screen using the Populate process.

<Option Strings>
[] Option Strings
     Toggles the use of Option Strings. If this is disabled Radio
     Buttons are used.

<<Screen Formatter's Tools Menu>>

The Tools menu contains a number of utilities which are useful
throughout the environment.

<DOS Shell>
DOS Shell                                 ( F10 or ALT+T D )
     Calls Clarion's built-in disk maintenance program (CSHELL).

<DOS Prompt>
DOS Prompt                                ( ALT+T R )
     Temporarily exits to DOS to execute some DOS command(s).
     It saves the current state of the Clarion environment to a
     temporary file, frees most of the memory used by the Clarion
     environment, and loads a second copy of COMMAND.COM.  To
     return to Clarion from this DOS prompt, type "Exit" and
     press ENTER.

<Calculator>
Calculator                                ( ALT+T C )
     Calls Clarion's built-in programmer's calculator.

<ASCII Chart...>
ASCII Chart...                            ( ALT+T A )
     Displays up a list of all the ASCII codes.  The chart
     contains each ASCII display character, and the Decimal,
     Hexadecimal, and Octal numbers which represent that
     character.

<Color Chart...>
Color Chart...                            ( ALT+T L )
     Displays a list of all the Color Style Codes.  Each possible
     color combination is in the list along with the decimal
     number which represents it.

<Keycode Chart...>
Keycode Chart...                          ( ALT+T K )
     Displays a list of all the Clarion Keycodes.  Each possible
     key combination is in the list along with the decimal number
     which represents it.


<<Screen Formatter's Help Menu>>

Context-sensitive Help screens are available throughout the
Clarion for DOS environment through the F1 key.  The
Help menu contains selections which provide separate access to
the Help system.

<Using Help >
Using Help                                ( ALT+H U )
     Provides information on how to use the Help system.

<Help Index >
Help Index                                ( ALT+H H )
     Displays an Index of all Help screens available in the
     major functional area, allowing you to view a Help screen
     for a particular context when not actively in that context.

<About...>
About...                                  ( ALT+H A )
     Displays a screen with the program and copyright
     information for this specific release of Clarion Database
     Developer.


<<Screen Properties Window>>

The Screen Properties window allows you to define the attributes
which are placed on the SCREEN statement of the screen
structure.  It also allows you to define the size of the work
area the Screen Formatter will use to design the SCREEN
structure.

<Screen Name:>
Screen Name:
     Displays the label of the SCREEN statement.  This is the
     label by which the SCREEN is referenced in source code
     statements.  By default, the label used for all Application
     Generator screens is "Screen" and you may not change it.

<Prefix:>
Prefix:
     Displays the contents of the SCREEN statement's PRE
     attribute.  This is the prefix used to reference a screen
     STRING field (in conjunction with its label) in source code
     statements.  By default, the prefix used for all Application
     Generator screens is "SCR" and you may not change it.

<Styles File:>
Styles File:
     Displays the name of the Styles file you selected on the
     Application Properties window.  This is the Styles file the
     Screen Formatter will use when you make color selections for
     your screen design.  You may not change the Styles file on
     this window -- only on the Application Properties window.

<Physical:>
Physical:
     Enter the number of rows and columns on the physical screen
     you wish to use to design your screen.  The default is 25x80.
     If you enter 50x80 the video is reset to 50x80 text mode.
     You may enter any values here which are supported by your
     video hardware (including soft text modes by Ultravision).

<Virtual:>
Virtual:
     Enter the number of virtual rows and columns you wish to use
     to design your screen.  This defines the size of the screen
     which the user will use, and is independent of the Physical
     screen size -- scrolling to portions not currently displayed
     on the physical screen is automatic.  The default is 25x80.
     You may enter up to 255 rows or 255 columns, but the product
     of rows * columns must not be greater than 32,767.  This
     makes 180x180 the largest square virtual screen possible, and
     128x255 or 255x128 the largest rectangular screen possible.

<Help ID:>
Help ID:
     Enter the identifier for the Help screen which the user will
     see when F1 is pressed on any field which does not have its
     own Help ID.  The value you enter here is placed in the
     SCREEN statement's HLP attribute.  You may enter either a
     string constant (in single quotes) or variable name.

<Alert Keys:>
Alert Keys:
     Enter the Keycode Equate label (see Appendix A of the
     Language Reference) of a keystroke which will automatically
     be active as field completion key for any field on the
     screen.  You may specify one keycode, or a range of keycodes.
     The values you enter here are placed in the SCREEN
     statement's ALRT attribute.

<Expand Row:>
Expand Row:
     Enter the number of the screen row (valid range: 1-25) which
     you want to be duplicated when a screen designed in 25-line
     mode is "stretched" to display in 43 or 50-line mode.  The
     number you enter here is placed in the SCREEN statement's
     EXPAND attribute.

<Position:>
Position:
     The Radio button you select here determines the screen's
     position and video saving behavior when opened:

()  Full
     The SCREEN has no rows and columns defined, so it occupies
     the entire screen, and, more importantly, does not save the
     video it overwrites when opened.

()  Fixed
     The SCREEN does have the number of rows and columns it
     occupies defined, so it does save the video it overwrites
     when opened.  It opens at the specific row and column
     position specified in the Fixed At fields (its AT attribute).

()  Float
     The SCREEN does have the number of rows and columns it
     occupies defined, so it does save the video it overwrites
     when opened.  It opens at a position relative to the last
     screen position written to, so it does not cover that
     position (it has no AT attribute).

()  Center
     The SCREEN does have the number of rows and columns it
     occupies defined, so it does save the video it overwrites
     when opened.  It opens in the middle of the screen, no matter
     what text mode the screen is in (it has the CENTER attribute
     instead of an AT attribute).

<Fix At:>
Fix At:
     Enter the row and column position at which you want the
     screen's top-left corner to be placed when the screen is
     opened at run-time.  These are the values placed in the
     SCREEN statement's AT attribute.  These fields are only
     active if the "Fixed" Screen Position Radio button is
     selected.

<Effects:>
Effects:
     Select the Radio button for the screen effect you want when
     the screen is opened at run-time:

     ()  None -- no opening effect
     ()  Zoom -- appears to "zoom in" from a distance
     ()  Wipe -- appears to be "wiped on" the display
     ()  Fall -- appears to "fall into" the display
     ()  Fade -- appears to "fade into" the display

     NOTE: Effects are only enabled for TEXT BASED Screens.
     Screen effects will not occur when in Graphics Mode.

<CUA>
[] CUA
     Check this box to place the CUA attribute on the SCREEN
     statement.  This attribute indicates the screen has an
     SAA/CUA compliant user interface, using the TAB and BACKTAB
     keys to navigate between screen fields.  Without the CUA
     attribute, the ENTER and ESC keys are used to navigate
     between screen fields.

<Shadow>
[] Shadow
     Check this box to automatically have a "ten o'clock shadow"
     placed to the right and below the screen at run-time.

<Graphic>
[] Graphic
     Check this box to indicate that the screen will be displayed
     in graphics mode, allowing it to contain an IMAGE field.
     This places the GRAPHIC attribute on the SCREEN statement.

<Colors Button>
Colors Button
     Calls the Color Selection window, which allows you to select
     the display color for the screen.


<<Hotkey Procedures Window>>

The Hotkey Procedures window displays a list of the "Hot Key
procedures" for the screen.  A "Hot Key" procedure may actually
be a call to some procedure, or any embedded source you want to
write.  Once you have listed a procedure call (not embedded
source), the Application Generator adds it to the Procedure call
tree as a "ToDo" procedure (if it does not already exist in your
application).  You may then create the procedure as you choose.

<Insert Button>
Insert Button
     Calls the Add Procedure Call window to allow you to add a
     procedure to the list.

<Change Button>
Change Button
     Calls the Change Procedure Call window to allow you to
     change the currently highlighted procedure in the list.

<Delete Button>
Delete Button
     Calls the Delete Procedure Call window to allow you to
     delete the currently highlighted procedure from the list.


<<Add/Change Hotkey Procedure Window>>

The Add/Change Hotkey Procedure Calls window allows you to
maintain a "Hot Key" procedure.

<Hot Key:>
Hot Key:
     Enter the Keycode Equate label (see Appendix A of the
     Language Reference) of a keystroke which will automatically
     execute the "Hot Key" procedure.

<Procedure:>
Procedure:
     Enter the label of a procedure to execute when the user
     presses the "Hot Key."

<Source... Button>
Source... Button
     Calls the Text Editor to allow you to write your own
     embedded Clarion language source code to execute when the
     user presses the "Hot Key."

<<Reapply Default Colors Window>>

The Reapply Default Colors window allows you to confirm
automatic re-selection of the default display colors for each
screen field.  This allows you to change the default colors and
change all fields to use those colors without re-creating the
colors for each field individually.


<<Field List Window>>

The Field List window displays the SCREEN structure source code
for all the fields placed on the SCREEN.  It allows you to Add,
Change, Move, or Delete screen fields from the SCREEN structure.
The order in which the fields appear in the Field List is the
order in which the fields will be selected for the user, if the
user elects to complete each field with the TAB key (on CUA
screens, ENTER for non-CUA).

<Insert Button>
Insert Button
     Calls the Add Field window to allow you to select the type
     of field to add to the screen.

<Change Button>
Change Button
     Calls the screen field edit window for the type of screen
     field currently highlighted in the Field List.

<Delete Button>
Delete Button
     Deletes the screen field from the Field List and the
     screen.

<Move Up Button>
Move Up Button
     Moves the screen field currently highlighted in the Field
     List up one position within the Field List (thereby changing
     the "normal selection order" of the fields on the SCREEN).

<Move Down Button>
Move Down Button
     Moves the screen field currently highlighted in the Field
     List down one position within the Field List (thereby
     changing the "normal selection order" of the fields on the
     SCREEN).

<Populate Button>
Populate Button
     Places you in "recursive add mode" to automatically add
     fields to the screen design.  To exit populate mode, press
     ESC when asked to select the next field to place on screen.

<Auto Re-order Button>
Auto Re-order Button
     Re-arranges all the screen fields in the Field List.  This
     automatically changes the "normal selection order" of the
     fields on the SCREEN to Left-to-Right, Top-to-Bottom order.


<<Add Field Window>>

The Add Field window allows you to select the type of field you
want to add to the SCREEN.

<Data>
Data
     Calls the Field Selection window to allow you to select the
     data field you want for user entry. This window displays
     the File Schematic, defined through the Files... Button,
     and Other Data (Global and Local memory variables and any
     files you want which are not part of the File Schematic.
     The Data Field may be placed on screen for user entry or
     display-only purposes.

     A Data field is normally placed on screen as an ENTRY or
     TEXT field (see the Language Reference).  It could also be a
     CHECK box (if the field was declared with the Must Be True
     Or False Validity Check) or an OPTION structure containing
     RADIO buttons (if the field was declared with the 'Must Be
     In This List' Validity Check).

<Button>
Button
     Places a BUTTON field on screen.  This is the same type of
     field as the "Ok" and "Cancel" Pushbuttons displayed on
     many of the Clarion environment screens.  A BUTTON field
     usually executes another procedure or some executable
     embedded source code statements.

<Prompt>
Prompt
     Places a PROMPT field in the SCREEN.  A PROMPT field is
     always associated with the immediately following ENTRY,
     TEXT, LIST, or OPTION field.  This is why they are displayed
     in the Field List with joining brackets to the following
     field.  A PROMPT field allows the user to navigate to a
     specific entry field by pressing ALT and the highlighted
     letter of the PROMPT field's display string (which is
     required for SAA/CUA compliance).

<Formula>
Formula
     Calls the Formulas window which allows you to select a
     field for display which receives the result of an
     expression.  This field may receive the result of a single
     expression (a Computed field) or one of several conditional
     expressions (a Conditional field).

<List Box>
List Box
     Places a LIST field on screen.  A LIST box displays records
     from a memory QUEUE (which usually contains multiple records
     from a data file).  It allows the user to select a single
     record.

<Graphic Image>
Graphic Image
     Places an IMAGE field on screen to display a .PCX, .BMP,
     or .GIF file.

<Scroll Area>
Scroll Area
     Places a REPEAT structure with a POINT field in the SCREEN
     to display multiple instances of some field(s).


<<Field Selection Window>>

The Field Selection window is central to the manner in which the
procedure Templates generate source code for the procedure.  In
addition to selecting individual fields to place on the screen
or report design, this window allows you to build the File
Schematic which determines the data files which will
automatically be accessed for you during the procedure.

The File Schematic determines the procedure's Primary file
(first file listed in the File Schematic) and Secondary files
(all other files listed in the File Schematic).  It also
graphically displays the relationships between the files in the
schematic:

     Any Secondary file with a double arrow pointing at it is a
     Child of the file from which the arrow is coming.

     Any Secondary file with a single arrow pointing at it is a
     Parent (Lookup) of the file from which the arrow is coming.

The Other Data section of the Files List allows you access to
Global and Local data, and to add other data files which are not
part of the File Schematic (the template will not automatically
access these files for you -- you must write embedded source
code for this).

Once you have built the File Schematic and Other Data, you may
select any field from any of the files to place in the screen or
report design.

<Files:>
Files:
     This List box displays the File Schematic you build, and
     any Other Data you may want to access during the procedure.

<Fields:>
Fields:
     This List box displays all the fields of the file selected
     from the Files List.  To select a file, highlight it and
     press ENTER, or DOUBLE-CLICK. Once you have selected a
     File, highlight the Field you want and press ENTER, or
     DOUBLE-CLICK on the field in the Fields List.

<Access Key:>
Access Key:
     Select the Key you want to use to access the Primary file
     in the File Schematic.

<Insert Button>
Insert Button
     Calls the Select File window to add a file to the Files List.
     If the Files List highlight bar is in the File Schematic,
     only those files which are related to the currently
     highlighted file may be selected.

<Delete Button>
Delete Button
     Deletes the currently highlighted file from the Files List.
     If the Files List highlight bar is in the File Schematic,
     all files related to the highlighted file are deleted.

<Select Button>
Select Button
     Selects the currently highlighted field from the Fields
     List and returns to the Screen or Report Formatter from
     which it was called.  If the highlight bar is in the Files
     List, all fields in the highlighted file are displayed in
     the Fields List and the highlight bar moves to the Fields
     List.

<Modify Fields>
Modify Fields
      Accesses the Database Dictionary, allowing you to add or edit
      files, fields, keys, or relations. This must be enabled
      through Application Options (choose Options from the Project
      Menu).

     If you modify a Dictionary from this point, changes are NOT
     saved unless you save the Procedure and Application file. See
     Chapter 5 of the User's Guide for complete information on
     modifying a dictionary through the Application Generator.

<Close Button>
Close Button
     Returns to the Screen or Report Formatter from which it was
     called without selecting a Field.


<<Select Primary/Related File Window>>

The Select Primary/Related File window displays a list of files
from which to choose.  If called from the Field Selection window
to add a file to the Files List and the Files List highlight bar
is in the File Schematic, only those files which are related to
the currently highlighted file are available.

<Select Button>
Select Button
     Selects the currently highlighted file and returns to the
     window from which it was called.

<Cancel Button>
Cancel Button
     Returns to the window from which it was called without
     selecting a File.


<<Select Access Key Window>>

The Select Access Key window displays a list of keys on the
Primary file in the File Schematic.

<Select Button>
Select Button
     Selects the currently highlighted key and returns to the
     window from which it was called.

<Cancel Button>
Cancel Button
     Returns to the window from which it was called without
     selecting a Key.


<<Select Dimension Window>>

The Select Dimension window allows you to specify exactly which
array element to place in the screen or report design.

<Max. Dims:>
Max. Dims:
     Displays the maximum array element number for each dimension
     of the array.

<Dimension:>
Dimension:
     Enter the number of the array element you want to place on
     the screen or report.  The value you enter here must not be
     larger than the Max. Dims value displayed above.


<<Entry Field Properties Window>>

The Entry Field Properties window allows you to define the
screen display and user data entry attributes of an ENTRY or
TEXT field.

<Picture:>
Picture:
     Enter the display formatting picture token in this field.
     The default display picture from the Database Dictionary is
     automatically placed here for you.  You may override this
     with another picture, if you choose.

<When Field is Completed Procedure:>
When Field is Completed
  Procedure:
     Enter a the name of a Procedure. The Procedure is executed
     immediately after the field is completed.   If you enter
     a Procedure label, the "Source...." button is dimmed.
     Conversely, if you use the "Source..." button to enter some
     embedded source code the "Procedure:" entry field is
     dimmed.

<Lookup Key>
Lookup Key
     The KEY used to get a record from a lookup file to validate
     user entry.

<Lookup Field>
Lookup Field
      The Key Component Field (the linking field) used to get a
      record from a lookup file to validate user entry.

<Return Field>
Return Field
      The field used to make an assignment from the Return Field
      to the Screen Entry Field. This is usually the same as the
      Lookup Field.

<Hot Key:>
Hot Key:
     Allows entry or selection of a "hotkey" keycode or keycode
     equate which is used to call the procedure named in the
     "When Field is Completed Procedure:" entry field.  This
     entry field is only active when a procedure has been named
     in the "When Field is Completed Procedure" entry.  An ALRT
     attribute is generated with this parameter on this ENTRY
     field in the screen structure.  Any value may be entered in
     this field, or a list of keycode equates may be accessed to
     select from the pop-up list.

     NOTE: When a Hot Key is specified, the named procedure will
           ONLY be called when the hot key is pressed.

<When Field is Selected Procedure:>
When Field is Selected Procedure:
     Enter a the name of a Procedure. The Procedure is executed
     immediately before the field is selected.   If you enter
     a Procedure label, the "Source...." button is dimmed.
     Conversely, if you use the "Source..." button to enter some
     embedded source code the "Procedure:" entry field is
     dimmed.

<Lookup Key>
Lookup Key
     The KEY used to get a record from a lookup file to validate
     user entry.

<Lookup Field>
Lookup Field
      The Key Component Field (the linking field) used to get a
      record from a lookup file to validate user entry.

<Return Field>
Return Field
      The field used to make an assignment from the Return Field
      to the Screen Entry Field. This is usually the same as the
      Lookup Field.

<Source... Button>
Source... Button
     Calls the Text Editor to allow you to write your own
     embedded source code.  The source code for the "When Field
     is Selected" field executes immediately before the user is
     allowed to enter data into the field.  The source code for
     "When Field is Completed" field executes after the field is
     completed.


<Display Only>
[] Display Only
     Check this box if you do not want the user to be able to
     change the data displayed in the field.  This creates a
     "display only" field on the screen.

<Colors Button>
Colors Button
     Calls the Color Selection window, which allows you to
     select the display colors for the field.  If you do not
     specifically select colors for the field, the default colors
     (defined by you) for the type of field you are creating are
     used.

<Attributes Button>
Attributes Button
     Calls the Field Attributes window, which allows you to
     select the data entry attributes the field will use.

<Make A Text Field Button>
Make A Text Field Button
     Allows you to create a TEXT field instead of an ENTRY field
     (see the Language Reference).  This is only appropriate for
     long STRING, CSTRING, or PSTRING fields.

<<Confirm Field Change Window>>

The Confirm Field Change window asks you to confirm that you
really want to create a TEXT field on screen rather than an
ENTRY field.  This action is appropriate for long STRING,
CSTRING, or PSTRING data fields.  It is not appropriate for any
other type of field.


<<Text Field Properties Window>>

The Text Field Properties window allows you to define the screen
display and user data entry attributes of a TEXT field.  A TEXT
field displays MEMO fields, or long STRING, CSTRING, PSTRING
fields in multiple screen rows.  The contents of the data field
displayed in the TEXT field are automatically scrolled on-screen
as the user presses the DOWN ARROW key.  Automatic Word-wrap is
supported during data entry into a TEXT field.

<Rows:>
Rows:
     Enter the number of screen rows the TEXT field will occupy.

<Columns:>
Columns:
     Enter the number of screen columns the TEXT field will
     occupy.

<When Text Field is Completed Procedure:>
When Text Field is Completed Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately after the user has entered data into
     the field.  If you do enter a procedure call, you may not
     write embedded source code through the Source... Button to
     the right.

<When Text Field is Selected Procedure:>
When Text Field is Selected Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately before the user is allowed to enter
     data into the field.  If you do enter a procedure call, you
     may not write embedded source code through the Source...
     Button to the right.

<Source... Button>
Source... Button
     Calls the Text Editor to allow you to write your own
     embedded Clarion language source code. The Source Button to
     the right of the When Text Field is Selected Procedure:
     field executes the code you have written immediately before
     the user is allowed to enter data into the field.  The
     Source Button to the right of the When Text Field is
     Completed Procedure: field executes the code you have
     written immediately after the user has entered data into the
     field.

<Return Field:>
Return Field:
     Optionally enter the field name which will contain the
     value to be assigned into this text field by the template.
     This field is only active when a procedure has been named in
     the preceding Procedure entry.

<Hot Key:>
Hot Key:
     Allows entry or selection of a "hotkey" keycode or keycode
     equate which, when pressed, will call the procedure named
     in the When Field is Completed Procedure entry.  This field
     is only active when a procedure has been named in the When
     Field is Completed Procedure entry.  An ALRT attribute is
     generated with this parameter on this TEXT field in the
     screen structure.  Any value may be entered in this field,
     or a list of keycode equates may be accessed to select from
     the pop-up list.

<Word Wrap>
[] Word Wrap
     Check this box if you want to automatically ensure that a
     single word does not span two lines of text.

<Colors Button>
Colors Button
     Calls the Color Selection window, which allows you to
     select the display colors for the field.  If you do not
     specifically select colors for the field, the default colors
     (defined by you) for the type of field you are creating are
     used.

<Attributes Button>
Attributes Button
     Calls the Field Attributes window, which allows you to
     select the data entry attributes the field will use.


<<Option Field Properties Window>>

The Option Field Properties window allows you to define the
screen display and user data entry attributes of an OPTION
structure which contains multiple RADIO fields.

<When Option is Completed Procedure:>
When Option is Completed Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately after the user has selected a RADIO
     button.  If you do enter a procedure call, you may not write
     embedded source code through the Source... Button to the
     right.

<When Option is Selected Procedure:>
When Option is Selected Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately before the user is allowed to select a
     RADIO button.  If you do enter a procedure call, you may not
     write embedded source code through the Source... Button to
     the right.

<Source... Button>
Source... Button
     Calls the Text Editor to allow you to write your own
     embedded Clarion language source code.  The Source Button to
     the right of the When Option is Selected Procedure: field
     executes the code you have written immediately before the
     user is allowed to select a RADIO button.  The Source Button
     to the right of the When Option is Completed Procedure:
     field executes the code you have written immediately after
     the user has selected a RADIO button.

<Colors Button>
Colors Button
     Calls the Color Selection window, which allows you to
     select the display colors for the field. If you do not
     specifically select colors for the field, the default colors
     (defined by you) for the type of field you are creating are
     used.

<Attributes Button>
Attributes Button
     Calls the Field Attributes window, which allows you to
     select the data entry attributes the field will use.


<<Radio Button Window>>

The Radio Button window allows you to define a RADIO field
within an OPTION structure.

<Radio Text:>
Radio Text:
     Enter a string constant (or variable name which contains
     the text) to display.  This is the value that is placed into
     the OPTION structure's USE variable (the field you selected
     for which you defined the "Must Be In List" Validity Check
     in the Dictionary Editor).  You may override the default
     value.

<Colors Button>
Colors Button
     Calls the Color Selection window, which allows you to
     select the display colors for the field. If you do not
     specifically select colors for the field, the default colors
     (defined by you) for the type of field you are creating are
     used.

<Attributes Button>
Attributes Button
     Calls the Field Attributes window, which allows you to
     select the data entry attributes the field will use.


<<Checkbox Field Properties Window>>

The Checkbox Field Properties window allows you to define a
CHECK field on the screen, which is created by the "Must Be True
Or False" Validity Check in the Dictionary Editor.

<Checkbox Text:>
Checkbox Text:
     Enter a string constant (or variable name which contains the
     text) to display.  You may override the default value.

<When Checkbox is Completed Procedure:>
When Checkbox is Completed Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately after the user has selected toggled the
     CHECK box.  If you do enter a procedure call, you may not
     write embedded source code through the Source... Button to
     the right.

<When Checkbox is Selected Procedure:>
When Checkbox is Selected Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately before the user is allowed to toggle
     the CHECK box.  If you do enter a procedure call, you may
     not write embedded source code through the Source... Button
     to the right.

<Source... Button>
Source... Button
     Calls the Text Editor to allow you to write your own
     embedded Clarion language source code.  The Source Button to
     the right of the When Checkbox is Selected Procedure: field
     executes the code you have written immediately before the
     user is allowed to toggle the CHECK box.  The Source Button
     to the right of the When Checkbox is Selected Procedure:
     field executes the code you have written immediately after
     the user has toggled the CHECK box.

<Colors Button>
Colors Button
     Calls the Color Selection window, which allows you to
     select the display colors for the field.  If you do not
     specifically select colors for the field, the default colors
     (defined by you) for the type of field you are creating are
     used.

<Attributes Button>
Attributes Button
     Calls the Field Attributes window, which allows you to
     select the data entry attributes the field will use.


<<Button Field Properties Window>>

The Button Field Properties window allows you to define a BUTTON
field on the screen.  A Pushbutton normally calls another
procedure to execute.

<Button Text:>
Button Text:
     Enter a string constant (or variable name which contains the
     text) to display in the button.  An ampersand in the text
     indicates the following character is the "hot" key which,
     when pressed in conjunction with the ALT key, immediately
     completes the BUTTON field and executes its When Button is
     Pressed Procedure: code.

     If you want a multiple-line button, use the vertical bar
     character (|) to delimit each line break. The total width
     of a multiple-line Pushbutton is determined by the number
     of characters placed on the first line (spaces included).
     '.....|.D&ef.|.|' creates a 3-line button 5 characters wide
     with ALT+E as the "hot" key.

<Equate Label:>
Equate Label:
     Enter the Field Equate Label (see the Language Reference)
     by which you want to reference this BUTTON in source code
     statements.  This Field Equate Label is placed in the BUTTON
     field's USE attribute.

<Hot Key:>
Hot Key:
     Enter an integer or Keycode Equate (contained in the
     KEYCODES.EQU file -- see Appendix A in the Language
     Reference for a complete list) which indicates a keystroke
     which automatically completes the BUTTON field.  This value
     is placed in the BUTTON field's KEY attribute and creates a
     second "hot" key for the BUTTON, in addition to any ALT+
     letter "hot" key specified in the Name: text.  Typically,
     this KEY refers to a function key or a CTRL+key combination.

<When Button is Pressed Procedure:>
When Button is Pressed Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately after the user has completed the
     Pushbutton.  If you do enter a procedure call, you may not
     write embedded source code through the Source... Button to
     the right.

<When Button is Selected Procedure:>
When Button is Selected Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately before the user is allowed to complete
     the Pushbutton.  If you do enter a procedure call, you may
     not write embedded source code through the Source... Button
     to the right.

<Source... Button>
Source... Button
     Calls the Text Editor to allow you to write your own
     embedded Clarion language source code.  The Source Button to
     the right of the When Button is Selected Procedure: field
     executes the code you have written immediately before the
     user is allowed to complete the button.  The Source Button
     to the right of the When Button is Pressed Procedure: field
     executes the code you have written immediately after the
     user has completed the button.

<With Shadow>
[] With Shadow
     Check this box to create an automatic "10 O'Clock" shadow
     below and to the right of the button.

<Colors Button>
Colors Button
     Calls the Color Selection window, which allows you to
     select the display colors for the field.  If you do not
     specifically select colors for the field, the default colors
     (defined by you) for the type of field you are creating are
     used.

<Attributes Button>
Attributes Button
     Calls the Field Attributes window, which allows you to
     select the data entry attributes the field will use.


<<List Box Properties Window>>

The List Box Properties window allows you to define a LIST field
on the screen to display entries from a memory QUEUE (see the
Language Reference).  Through this window you may define the
size of the LIST, the QUEUE which it displays, and the fields
which are formatted into the QUEUE.

<Rows:>
Rows:
     Enter the number of screen rows the LIST field will use to
     display the data.

<Columns:>
Columns:
     Enter the number of screen columns the LIST field will use
     to display the data.

<Fixed Rows:>
Fixed Rows:
     Enter the number of rows at the top of the LIST field which
     will contain fixed header information.  These rows will
     always be displayed at the top of the LIST, unaffected by up-
     and-down scrolling.  During left-to-right scrolling, the
     fixed rows move with the data.  This feature allows you to
     input column headings in the LIST.

     The values to display on these fixed rows are entered as
     string literals when you design the layout of the data
     display in the LIST (complete the Fields Button to design
     LIST data display format).

<Lines/Row:>
Lines/Row:
      The number of lines per row.

<Queue Label:>
Queue Label:
     Enter the label of the QUEUE to display in the LIST.

<From Field:>
From Field:
     Enter the label of the specific field within the QUEUE to
     display in the LIST. If omitted, all fields in the QUEUE
     are displayed.

<Equate Label:>
Equate Label:
     Enter the Field Equate Label (see the Language Reference)
     by which you want to reference this LIST in source code
     statements.  This Field Equate Label is placed in the LIST
     field's USE attribute.

<Fill Label:>
Fill Label:
     Enter the Field Equate Label of the screen field which is
     to receive the LIST entry selected by the user.

<When List Box is Completed Procedure:>
When List Box is Completed Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately after the user has selected an item
     from the LIST.  If you do enter a procedure call, you may
     not write embedded source code through the Source... Button
     to the right.

<When List Box is Selected Procedure:>
When List Box is Selected Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately before the user is allowed to select
     an item from the LIST.  If you do enter a procedure call,
     you may not write embedded source code through the
     Source... Button to the right.

<Source... Button>
Source... Button
     Calls the Text Editor to allow you to write your own
     embedded Clarion language source code.  The Source Button to
     the right of the When List Box is Selected Procedure: field
     executes the code you have written immediately before the
     user is allowed to select an item from the LIST.  The Source
     Button to the right of the When List Box is Completed
     Procedure: field executes the code you have written
     immediately after the user has selected an item from the
     LIST.

<Colorize:>
[]  Colorize:
     Check this box to enable colorization of fields in a list box.

<Colorize Delimiters>
     Enter two characters to be used to identify the
     colorize attributes in the QUEUE. You may accept the
     default square brackets ([]) or specify your own.

<Horizontal Scroll>
[] Horizontal Scroll
     Check this box to create an automatic right-to-left scroll
     bar at the bottom of the LIST. The scroll bar will appear
     at run-time, but not during screen design.

<Vertical Scroll>
[] Vertical Scroll
     Check this box to create an automatic top-to-bottom scroll
     bar at the right of the LIST.  The scroll bar will appear at
     run-time, but not during screen design.

<Colors Button>
Colors Button
     Calls the Color Selection window, which allows you to
     select the display colors for the field.  If you do not
     specifically select colors for the field, the default colors
     (defined by you) for the type of field you are creating are
     used.

<Attributes Button>
Attributes Button
     Calls the Field Attributes window, which allows you to
     select the data entry attributes the field will use.

<Fields Button>
Fields Button
     Calls the List Box editor, which allows you to design the
     LIST display format.  This includes both the constant text
     and data fields to display.


<<List Box Editor>>

The List Box Editor allows you to design the LIST display
format, which includes the constant text and data fields.  At
the bottom of the screen a "status bar" is displayed which
indicates the current cursor column position and typing mode
(insert or overwrite).

If you specified a number of Fixed Rows, you may directly type
in the headers to display at the top of the LIST.  Any literals
you type into the LIST are repeated on every row of the LIST,
unless placed in the Fixed Rows at the top.

Functions available in the List Box Editor are accessible through
the editor's pulldown menu, which can be activated by pressing
Esc.


<<List Box Editor's List Box Menu>>

<Exit>
Exit                                      ( CTRL+X or ALT+L X )
     Closes the List Box Editor, offering you the opportunity to
     save the List Box design, and returns to the Screen
     Formatter worksheet.


<<List Box Editor's Edit Menu>>

<List Box Fields>
List Box Fields                           ( CTRL+F or ALT+E F )
     Activates the Fields dialog, allowing data fields to be
     added, changed, or deleted from the list box.  Not available
     in Fixed list box lines.

<Swap Fields Left or Right>
Swap Fields Left or Right      ( Gray- or Gray+, ALT+E L or R )
     Swaps the position of two fields on the worksheet.  The
     cursor must be positioned on a field to be swapped.  Any
     data characters between the swapped fields will remain
     between them, but may have shifted to fit properly.

<Draw Track>
Draw Track                                ( CTRL+T or ALT+E T )
     Activates tracking mode for the List Box. "Tracking"
     appears on the status line, and remains while tracking is
     in effect.


<<List Box Editor's Tools Menu>>

The Tools menu contains a number of utilities which are useful
throughout the environment.

<DOS Shell>
DOS Shell                                 ( F10 or ALT+T D )
     Calls Clarion's built-in disk maintenance program (CSHELL).

<DOS Prompt>
DOS Prompt                                ( ALT+T R )
     Temporarily exits to DOS to execute some DOS command(s).
     It saves the current state of the Clarion environment to a
     temporary file, frees most of the memory used by the Clarion
     environment, and loads a second copy of COMMAND.COM.  To
     return to Clarion from this DOS prompt, type "Exit" and
     press ENTER.

<Calculator>
Calculator                                ( ALT+T C )
     Calls Clarion's built-in programmer's calculator.

<ASCII Chart...>
ASCII Chart...                            ( ALT+T A )
     Displays up a list of all the ASCII codes.  The chart
     contains each ASCII display character, and the Decimal,
     Hexadecimal, and Octal numbers which represent that
     character.

<Color Chart...>
Color Chart...                            ( ALT+T L )
     Displays a list of all the Color Style Codes.  Each possible
     color combination is in the list along with the decimal
     number which represents it.

<Keycode Chart...>
Keycode Chart...                          ( ALT+T K )
     Displays a list of all the Clarion Keycodes.  Each possible
     key combination is in the list along with the decimal number
     which represents it.


<<List Box Editor's Help Menu>>

Context-sensitive Help screens are available throughout the
Clarion for DOS environment through the F1 key.  The
Help menu contains selections which provide separate access to
the Help system.

<Using Help >
Using Help                                ( ALT+H U )
     Provides information on how to use the Help system.

<Help Index >
Help Index                                ( ALT+H H )
     Displays an Index of all Help screens available in the
     major functional area, allowing you to view a Help screen
     for a particular context when not actively in that context.

<About...>
About...                                  ( ALT+H A )
     Displays a screen with the program and copyright
     information for this specific release of Clarion Database
     Developer.


<<Listbox Fields Window>>

The Listbox Fields window shows a list of data fields the LIST
will display, their column position within the LIST, and display
format picture.  Through this window you may add, change, or
delete fields from the LIST.

<Insert and Change Buttons>
Insert and Change Buttons
     The Insert and Change Pushbuttons call the Field Update
     window to add or change a field in the LIST.

     When a field is inserted into the List Box, all fields and
     data to the right of the insertion point, which is the
     cursor position, are shifted to the right to make room for
     the new field.  Additionally, all data in fixed rows is
     correspond- ingly shifted to the right.

<Delete Button>
Delete Button
     The Delete Pushbutton removes a field from the LIST.


<<List Box Field Properties Window>>

The List Box Field Properties Window allows you to modify a
display field placed in a LIST.

<Field:>
Field:
     The label of the data field.

<Offset:>
Offset:
     The display column position of the data field within the
     LIST.

<Picture:>
Picture:
     Enter the display format picture token for the data field.

<Colorize>
[]Colorize
     Check this box to enable colorization. If colorization has
     not been enabled for the List Box, this field is dimmed.

<Default Colors>
Default Colors
     Press this button to specify the default colors for the field.

<<Colorize Conditions Window>>
Colorize Conditions Window
     This window maintains a list of conditions which control field
     colors.

     At runtime, Colorize Conditions are evaluated in the order in
     which they appear in this list. A field will display in the
     color of the first true condition. If no condition is true, it
     will display in its default color.

<Add Button>
Add Button
     Press this button to Add a condition

<Change Button>
Change Button
     Press this button to modify a condition

<Delete Button>
Delete Button
     Press this button to Delete a condition

<<Colorize Condition Properties Window>>
Colorize Condition Properties Window
     This window allows you to define a condition to colorize
     a list box field.

<List Box Field>
List Box Field
     The List Box Field which will be colorized according to the
     specified condition.

<Descriptiion>
Descriptiion
     A description of the condition for Field Colorization.

<Colorize Expression Button>
Colorize Expression Button
    Press this button to create the expression to be evaluated
    for this Conditional Color.

<Conditional Colors Button>
Conditional Colors Button
    Press this button to specify the field's colors if the
    expression is true.

<<Update Scroll (Repeat/Point) Area Window>>

The Update Scroll (Repeat/Point) Area window allows you to
define a REPEAT structure and POINT field on the screen.

<Rows:>
Rows:
     Enter the total number of screen rows the REPEAT structure
     will use to display the data.

<Columns:>
Columns:
     Enter the number of screen columns the REPEAT structure and
     POINT field will use to display the data.

<Rows/Item:>
Rows/Item:
     Enter the number of rows the POINT field in the REPEAT
     structure will occupy.

<Index Label:>
Index Label:
     Enter the name of the variable to place in the REPEAT
     structure's INDEX attribute.  This variable receives the
     REPEAT element number highlighted when the POINT field is
     completed by the user.

<Max Label:>
Max Label:
     Enter the name of the variable to place in the REPEAT
     structure's MAX attribute.  This variable receives the
     total number of screen rows used by the REPEAT structure at
     run time.  This allows you to use the EXPAND attribute on
     the SCREEN to fill the screen when displaying the screen in
     greater than 25 row text mode.

<Equate Label:>
Equate Label:
     Enter the Field Equate Label (see the Language Reference)
     by which you want to reference the POINT field in source
     code statements.  This Field Equate Label is placed in the
     POINT field's USE attribute.

<When Point Bar is Pressed Procedure:>
When Point Bar is Pressed Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately after the user has completed the POINT
     field.  If you do enter a procedure call, you may not write
     embedded source code through the Source... Button to the
     right.

<When Point Bar is Selected Procedure:>
When Point Bar is Selected Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately before the user is allowed to complete
     the POINT field.  If you do enter a procedure call, you may
     not write embedded source code through the Source... Button
     to the right.

<Source... Button>
Source... Button
     Calls the Text Editor to allow you to write your own
     embedded Clarion language source code.  The Source Button to
     the right of the When Point Bar is Selected Procedure: field
     executes the code you have written immediately before the
     user is allowed to complete the POINT field.  The Source
     Button to the right of the When Point Bar is Pressed
     Procedure: field executes the code you have written
     immediately after the user has completed the POINT field.

<Colors Button>
Colors Button
     Calls the Color Selection window, which allows you to select
     the display colors for the POINT field.  If you do not
     specifically select colors for the field, the default colors
     (defined by you) for the type of field you are creating are
     used.

<Attributes Button>
Attributes Button
     Calls the Field Attributes window, which allows you to
     select the data entry attributes the field will use.


<<Image Field Properties Window>>

The Image Field Properties window allows you to define an IMAGE
field on the screen to display a .PCX, .BMP, or .GIF graphic image
file.

<Rows:>
Rows:
     Enter the total number of screen rows the IMAGE will use to
     display the graphic.

<Columns:>
Columns:
     Enter the number of screen columns the IMAGE field will use
     to display the graphic.

<Display From File>
() Display From File
     Indicates that the graphic image to display is contained in
     a .PCX, .BMP, or .GIF file on disk.

<Image File:>
Image File:
     Enter the name of the .PCX, .BMP, or .GIF file to display, or
     the name of a variable which will contain the name at run-time.

<Equate Label:>
Equate Label:
     Enter the Field Equate Label by which you want to reference
     this IMAGE field in source code statements.  The value
     entered is placed in the IMAGE field's USE attribute.

<Display From Field>
() Display From Field
     Indicates that the graphic image to display (the contents of
     a .PCX, .BMP, or .GIF file) is contained in a MEMO field.

<Field Label:>
Field Label:
     Enter the name of the MEMO field which contains the .PCX, .BMP, or
     .GIF graphic data.  The value entered is placed in the IMAGE
     field's USE attribute.

<Use Current Color Palette>
[] Use Current Color Palette
     Check this box to use the display hardware's default color
     palette if the IMAGE is the first graphic image displayed on
     screen.  If another IMAGE field is already on screen, check
     this box to use that graphic image's color palette.

<Use Image As A Pushbutton>
[] Use Image As A Pushbutton
     Check this box to make the IMAGE field act as a BUTTON field
     (see the Language Reference).

<Hot Key:>
Hot Key:
     Enter an integer or Keycode Equate (contained in the
     KEYCODES.EQU file -- see Appendix A in the Language
     Reference for a complete list) which indicates a keystroke
     which automatically completes the IMAGE (acting as a BUTTON)
     field. This value is placed in the IMAGE field's KEY
     attribute and creates a "hot" key for the IMAGE.  Typically,
     this KEY refers to a function key or a CTRL+key
     combination.

<When Image is Pressed Procedure:>
When Image is Pressed Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately after the user has completed the IMAGE
     field.  If you do enter a procedure call, you may not write
     embedded source code through the Source... Button to the
     right.

<When Image is Selected Procedure:>
When Image is Selected Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately before the user is allowed to complete
     the IMAGE field.  If you do enter a procedure call, you may
     not write embedded source code through the Source... Button
     to the right.

<Source... Button>
Source... Button
     Calls the Text Editor to allow you to write your own
     embedded Clarion language source code.  The Source Button to
     the right of the When Image is Selected Procedure: field
     executes the code you have written immediately before the
     user is allowed to complete the IMAGE field.  The Source
     Button to the right of the When Image is Pressed Procedure:
     field executes the code you have written immediately after
     the user has completed the IMAGE field.

<Attributes Button>
Attributes Button
     Calls the Field Attributes window,  which allows you to
     select the data entry attributes the field will use.


<<Prompt Field Properties Window>>

The Prompt Field Properties window allows you to define a PROMPT
field on the screen.  PROMPT fields are used for SAA/CUA
compliance to allow the user to navigate directly to the ENTRY,
TEXT, LIST, or OPTION field with which it is associated, using
the ALT key and the highlighted letter displayed in the PROMPT.

<Prompt Name:>
Prompt Name:
     Enter a string constant or variable containing the text to
     display as a prompt for the ENTRY, TEXT, LIST, or OPTION
     field following the PROMPT in the Field List.  An ampersand
     (&) indicates the next letter is the letter to be
     highlighted (the "hot" key used with the ALT key).

<Colors Button>
Colors Button
     Calls the Color Selection window, which allows you to
     select the display colors for the field.  If you do not
     specifically select colors for the field, the default colors
     (defined by you) for the type of field you are creating are
     used.

<Attributes Button>
Attributes Button
     Calls the Field Attributes window, which allows you to
     select the data entry attributes the field will use.


<<Field Attributes Window>>

The Field Attributes window allows you to specify the attributes
associated with the specific screen field from which the window
was called.  Any attributes which are inappropriate for the
field are dimmed and unavailable.

<Row:>
Row:
     Enter the row position at which you want the field's
     top-left corner to be placed.

<Column:>
Column:
     Enter the column position at which you want the field's
     top- left corner to be placed.

<Help ID:>
Help ID:
     Enter the identifier for the Help screen which the user
     will see when F1 is pressed on this field.  The value you
     enter here is placed in the screen field's HLP attribute.
     You may enter either a string constant (in single quotes) or
     variable name.

<Alt Prior Field:>
Alt Prior Field:
     Enter the Field Equate Label (see the Language Reference)
     for the screen field on which you want the user to be placed
     when the BACKTAB (CUA) or ESC (non-CUA) key is pressed.
     This Field Equate Label is placed in the screen field's ESC
     attribute.

<Alert Key(s):>
Alert Key(s):
     Enter the Keycode Equate label (see Appendix A of the
     Language Reference) of a keystroke which will automatically
     be active as a field completion key for this field only.
     You may specify one keycode, or a range of keycodes.  The
     values you enter here are placed in the screen field's ALRT
     attribute.

<Message:>
Message:
     Enter the message you want to be displayed when the user is
     on this field for data entry.  The value you enter here is
     placed in the screen field's MSG attribute.  By default, the
     message is displayed on the bottom line of the screen
     (unless changed by the SETMSG statement).

<Required>
[] Required
     Check this box to indicate that the field must not be left
     blank or zero.  This places the REQ attribute on the screen
     field.

<Immediate>
[] Immediate
     Check this box to indicate that the ENTRY field is
     immediately completed when all possible characters are
     entered.  On a LIST box, it indicates that ACCEPT returns
     control to your Clarion code after every keystroke.  On a
     BUTTON field it indicates the BUTTON is continuously
     completed until the use releases the mouse button.  This
     places the IMM attribute on the screen field.

<Left Justify>
[] Left Justify
     Check this box to indicate that any leading blank spaces in
     an ENTRY field are eliminated before the data is placed in
     the field's USE variable.  On a TEXT field, it indicates
     that automatic word wrap is active for the field.  This
     places the LFT attribute on the screen field.

<Skip>
[] Skip
     Check this box to indicate that the field is only for
     display -- the user is not allowed to enter or change the
     data.  This places the SKIP attribute on the screen field.

<Hide>
[] Hide
     Check this box to indicate that the field's data is not for
     display -- asterisks are displayed on screen as the user
     enters or changes the data.  This places the HIDE attribute
     on the screen field.

<Typing Mode:>
Typing Mode:
     Select the Radio button for the appropriate typing mode for
     the screen field:

     ()  As Is -- whatever mode was set by the previous field
           Places no attribute on the screen field.
     ()  Insert -- "push left" - numbers, "push right" - strings
           Places the INS attribute on the screen field.
     ()  Overwrite -- type over existing characters
           Places the OVR attribute on the screen field.

<Capitalization:>
Capitalization:
     Select the Radio button for the appropriate capitalization
     style for the screen field:

     ()  As Is -- no automatic capitalization
           Places no attribute on the screen field.
     ()  Uppercase -- automatic conversion to all uppercase
           Places the UPR attribute on the screen field.
     ()  Caps -- first letter (only) of each word capitalized
           Places the CAP attribute on the screen field.


<<Report Formatter>>

The Report Formatter maintains your application's REPORTs.  A
REPORT is a data structure which defines the printed output of
the procedure.

All the tools that you may use in the Report Formatter are
accessible through the pulldown menu.  The ESC key activates the
pulldown menu.  Many of the tools have shortcut "hot" keys which
are displayed at the right of each tool's menu selection.

<Report Formatter Hot Keys>
Report Formatter Hot Keys

        CTRL+O     Report Properties
        CTRL+B     Band Properties
        CTRL+U     Undo
        CTRL+C     Copy
        CTRL+M     Move
        CTRL+D     Delete
        CTRL+L     Toggle Full Line Mode
        CTRL+6     Center on Line
        CTRL+2     Duplicate Line
        CTRL+\     Change Case
        CTRL+T     Draw Track
        CTRL+R     Use Rulers
        CTRL+F     Process Fields
        CTRL+P     Printer Controls
        CTRL+G     Group Breaks
        CTRL+N     Create New Detail Band
        CTRL+S     Suppress Line

        CTRL+X     Exit

<Default Reports>
Default Reports

When you first enter the Report Formatter from the Application
Generator, the default Report design for the Template procedure
appears.  This default design comes from the Template's
template.APP file (which you may modify--see the Template
Language Reference).

Default Template Reports provide an easy method of maintaining
consistent report design standards throughout your
application(s).  These default Reports also pre-define any
report fields which the Template procedure requires to correctly
generate source code for your procedure.

Typically, the pre-defined fields in a default Report design are
used for fields which are standard on most reports and necessary
to the correct functioning of the application.  Since the pre-
defined report fields may be (probably are) explicitly
referenced in the Template code, they should not be deleted
(unless you have thoroughly investigated the code and are
certain they are not absolutely required).


<<Report Formatter's Report Menu>>

The Report menu contains selections which affect the entire
report design:

<Clear>
Clear                                     ( ALT+R C )
     Deletes everything from the report design: data fields,
     literals, and controls fields.

<Report Properties...>
Report Properties...                      ( CTRL+O or ALT+R R )
     Calls the Report Properties window to specify attributes of
     the Report.

<Band Properties...>
Band Properties...                        ( CTRL+B or ALT+R B )
     Calls the Band Properties window to specify the attributes
     of the report band the cursor is currently in.

<Exit>
Exit                                      ( CTRL+X or ALT+R X )
     Closes the Report Formatter, giving you the opportunity to
     save the report design, then returns to the Application
     Generator.


<<Report Formatter's Fields Menu>>

Although the aesthetics of report design are important, the most
important task in report design is the placement of fields on
the report.  These are the fields which print the data.

When you place a field on your report design, you should first
position the cursor to the spot where you want the field to be
placed.  If you do not position the cursor first, you could
define two fields to occupy the same place.

<Data...>
Data...                                   ( ALT+F D )
     Displays a list of all the data fields of which the
     Application Generator is aware.  This includes all the
     fields from the files in the Database Dictionary, and
     variables declared within the Application Generator from a
     Data... Pushbutton.  The Data Field is placed on the
     report.

<Image...>
Image...

     Places a graphic image on a report. This enables you to print a
     graphic image to printers which use Printer Control Language
     (PCL). To print images make sure your printer supports PCL
     codes and is set to the correct emulation mode.

<Control...>
Control...                                ( ALT+F L )
     Places a CONTROL field on the report.  This allows you to
     send control strings to the printer at any point in the
     report.

<Total...>
Total...                                  ( ALT+F T )
     Places a field on the report which prints the sum, count,
     average, maximum value, or minimum value contained in a data
     field.

<Formula...>
Formula...                                ( ALT+F F )
     Places a Computed or Conditional field on the report.  A
     Computed field prints the result of a calculation.  A
     Conditional field prints the result of a conditionally
     executed calculation.

<Default Columns>
Default Columns                           ( ALT+F C )
     Indicates that the default column headings specified in the
     Database Dictionary should be added to the report when
     placing fields.

<Populate Report>
Populate Report                           ( ALT+F P )
     Places you in "automatic" field placement mode to rapidly
     place a number of fields on the report.


<<Report Formatter's Edit Menu>>

The Edit menu contains selections which affect individual items
placed on the report.

<Undo>
Undo                                      ( CTRL+U or ALT+E U )
     Restore the last item deleted by the Delete menu selection.

<Copy>
Copy                                      ( CTRL+C or ALT+E C )
     Copy a portion of the report design to another part of the
     report.

<Move>
Move                                      ( CTRL+M or ALT+E M )
     Move a portion of the report design to another part of the
     report.

<Delete>
Delete                                    ( CTRL+D or ALT+E D )
     Remove a portion of the report design from the report.

<Full Line Mode>
Full Line Mode                            ( CTRL+L or ALT+E L )
     Toggles between Line and Character modes for Copy, Move, or
     Delete.  This selection is a toggle switch with a check mark
     () displayed when toggled ON (Line mode).

<Draw Track>
Draw Track                                ( CTRL+T or ALT+E T )
     Allows you to place tracking characters (most commonly,
     single or double lines) in your report design.

<Duplicate>
Duplicate                                 ( ALT+E U )
     Displays a sub-menu which allows you to duplicate text.
     You may duplicate the entire line, or individual characters
     (while the cursor moves left or right).

<Line>
Line                                    ( CTRL+2 or ALT+E U L )
     Duplicates the line the cursor is on.

<Character Left >
Character Left                ( SHIFT+GRAY-MINUS or ALT+E U C )
     Duplicates the character on the line immediately above the
     cursor.  The cursor then moves one position to the left.

<Character Right>
Character Right                ( SHIFT+GRAY-PLUS or ALT+E U R )
     Duplicates the character on the line immediately above the
     cursor.  The cursor then moves one position to the right.


<<Report Formatter's Options Menu>>

The Options menu contains items which affect the design of the
report format.

<Printer Controls...>
Printer Controls...                       ( CTRL+P or ALT+O P )
     Calls the Printer Controls window to select a printer
     control code to place in the report.  This creates a CONTROL
     field. This selection is only available if you have selected
     a printer on the Report Properties window.

<Group Breaks...>
Group Breaks...                           ( CTRL+G or ALT+O G )
     Specify Key component fields which invoke a group break when
     the value of the field changes during report processing.

<Create New Detail...>
Create New Detail...                      ( CTRL+N or ALT+O N )
     Add a custom report DETAIL structure.  This creates an
     "orphan" DETAIL structure of which the procedure Template
     knows nothing.  An "orphan" DETAIL is only printed by an
     explicit PRINT statement in an embedded source code window.

<Suppress Line>
Suppress Line                             ( CTRL+S or ALT+O S )
     Indicates the report line the cursor is on should not be
     printed if all fields on that line are blank.  This places a
     SUPPRESS statement in the report and is usually used in
     conjunction with the FIXED attribute (on the Band Properties
     window) to create labels.

<Overprint Next>
Overprint Next                            ( ALT+O O )
     Indicates the report line the cursor is on should execute a
     Carriage Return without a Line Feed.  This allows the next
     line to be printed on top of this line.


<<Report Formatter's Tools Menu>>

The Tools menu contains a number of utilities which are useful
throughout the environment.

<DOS Shell>
DOS Shell                                 ( F10 or ALT+T D )
     Calls Clarion's built-in disk maintenance program (CSHELL).

<DOS Prompt>
DOS Prompt                                ( ALT+T R )
     Temporarily exits to DOS to execute some DOS command(s).  It
     saves the current state of the Clarion environment to a
     temporary file, frees most of the memory used by the Clarion
     environment, and loads a second copy of COMMAND.COM.  To
     return to Clarion from this DOS prompt, type "Exit" and
     press ENTER.

<Calculator>
Calculator                                ( ALT+T C )
     Calls Clarion's built-in programmer's calculator.

<ASCII Chart...>
ASCII Chart...                            ( ALT+T A )
     Displays up a list of all the ASCII codes.  The chart
     contains each ASCII display character, and the Decimal,
     Hexadecimal, and Octal numbers which represent that
     character.

<Color Chart...>
Color Chart...                            ( ALT+T L )
     Displays a list of all the Color Style Codes.  Each possible
     color combination is in the list along with the decimal
     number which represents it.

<Keycode Chart...>
Keycode Chart...                          ( ALT+T K )
     Displays a list of all the Clarion Keycodes.  Each possible
     key combination is in the list along with the decimal number
     which represents it.


<<Report Formatter's Help Menu>>

Context-sensitive Help screens are available throughout the
Clarion for DOS environment through the F1 key.  The
Help menu contains selections which provide separate access to
the Help system.

<Using Help >
Using Help                                ( ALT+H U )
     Provides information on how to use the Help system.

<Help Index >
Help Index                                ( ALT+H H )
     Displays an Index of all Help screens available in the major
     functional area, allowing you to view a Help screen for a
     particular context when not actively in that context.

<About...>
About...                                  ( ALT+H A )
     Displays a screen with the program and copyright
     information for this specific release of Clarion Database
     Developer.


<<Report Properties Window>>

The Report Properties window allows you to specify the
attributes which are placed directly on the REPORT statement
when the REPORT structure's source code is generated.  Also,
this window allows you to specify the number and size of labels
when printing multi-up labels.

<Printer:>
Printer:
     Calls the Printer Name window, from which you select the
     name of the printer which is placed in the PRINTER
     attribute, or the variable which will contain that name at
     run-time.  The list of available printers comes from your
     PRINTER.CTL file or the control file specified by the
     environment variable CLAPRINTER.

     Printer control files are maintained from the Clarion
     Pulldown by selecting System Setup, Printer Controls.

<Device:>
Device:
     Calls the Report Device window, from which you select the
     printer port, DOS device name, or the variable which will
     contain the device at run-time.  The value is placed in the
     DEVICE attribute.

<Line Count:>
Line Count:
     Calls the Field Selection window, from which you select the
     variable which is placed in the LINE attribute.  This
     variable is automatically updated by the PRINT statement at
     run-time.  This allows you to place the variable in the
     report to display its value, or use it in source code
     statements to determine how many lines have been printed on
     the page.

<Page Count:>
Page Count:
     Calls the Field Selection window, from which you select the
     variable which is placed in the PAGE attribute.  This
     variable is automatically updated by the PRINT statement at
     run-time.  This allows you to place the variable in the
     report to display its value, or use it in source code
     statements to determine how many pages have been printed.

<Prefix:>
Prefix:
     Enter the REPORT's prefix.  The value you enter is placed in
     the PRE attribute.

<Printed Lines Per Page:>
Printed Lines Per Page:
     Enter the maximum number of lines to be printed on each page
     before automatic page overflow occurs (see Page Overflow in
     the Language Reference. Enter zero to disable automatic page
     overflow. The value you enter is placed in the LENGTH
     attribute.

<Report Width:>
Report Width:
     Enter the maximum number of columns to be printed.  The
     value you enter is placed in the WIDTH attribute.

<Number Of Labels Across:>
Number Of Labels Across:
     Enter the number of multi-up labels the report will print.
     The number entered here defines the number of times each
     field placed in the Body DETAIL band is duplicated across
     the page.

<Columns Per Label:>
Columns Per Label:
     Enter the number of columns each multi-up label will occupy.
     The number entered here defines the width of the area in the
     Body DETAIL band in which you may place fields for the
     labels.

<Append Report>
[] Append Report
     Check this box if you want the output to be added to the
     end of an existing file, when the report's destination is a
     disk file.  This adds the APPEND attribute to the REPORT
     statement.


<<Band Properties Window>>

The Band Properties window allows you to specify the attributes
which are placed directly on the DETAIL, HEADER, or FOOTER
statement of the currently highlighted report band when the
REPORT structure's source code is generated.

<Fixed>
[] Fixed
     Check this box if you want the band to always print the
     same number of lines, despite suppressing any blank lines.
     This places the FIXED attribute on the band.  This attribute
     is usually used when printing fixed-length labels.

<Alone>
[] Alone
     Check this box if you want the band to print on a page by
     itself, without the Page Header or Page Footer.  This places
     the ALONE attribute on the band.

<Separate>
[] Separate
     Check this box to call the Separate Attribute window, which
     allows you to define the number of blank lines which will be
     printed following this band.  This places the SEPARATE
     attribute on the band.

<Allow>
[] Allow
     Check this box to call the Allow Attribute window, which
     allows you to define the minimum number of lines which must
     still be available on the page for printing other bands
     following this one (see ALLOW in the Language Reference).
     This places the ALLOW attribute on the band.

<Last>
[] Last
     Check this box to place the LAST attribute on the DETAIL
     structure.  This invokes automatic page overflow after the
     DETAIL is printed (which prints the page FOOTER then the
     page HEADER).

<Label:>
Label:
     Enter the name by which this band will be referenced in
     source code.  This is the name used by the PRINT statement,
     and must be a valid Clarion label (only letters, numbers,
     colon, and underscore allowed -- it must begin with a letter
     or underscore).

<Pre Print Proc:>
Pre Print Proc:
     Enter a single procedure call statement.  The procedure is
     executed immediately before the band is printed.  If you do
     enter a procedure call, you may not write embedded source
     code through the Source Button to the right of the Pre Print
     Proc field.

<Post Print Proc:>
Post Print Proc:
     Enter a single procedure call statement.  The procedure is
     executed immediately after the band is printed.  If you do
     enter a procedure call, you may not write embedded source
     code through the Source Button to the right of the Post
     Print Proc field.

<Source... Button>
Source... Button
     Calls the Text Editor to allow you to write your own
     embedded Clarion language source code.  The Source Button to
     the right of the Pre Print Proc field executes the code you
     have written immediately before the band is printed.  The
     Source Button to the right of the Post Print Proc field
     executes the code you have written immediately after the
     band is printed.


<<Data Field Window>>

The Data Field window allows you to specify the characteristics
of a field placed in the report.

<Picture:>
Picture:
     Enter the picture token to use to format the field's data
     for printing.

<Make A Text Field>
[] Make A Text Field
     Check this box to create a TEXT report field instead of a
     STRING report field.  A TEXT field is used to automatically
     print long string fields (or MEMO fields) on multiple print
     lines.

<Rows:>
Rows:
     Enter the maximum number of rows the TEXT field will print.

<Columns:>
Columns:
     Enter the number of columns to print on each row of the
     TEXT field.

<Word Wrap>
[] Word Wrap
     Check this box to ensure that no word printed in the TEXT
     can span two rows (the line it would begin on is padded
     with blanks to force the word to the next row).

<Suppress Row/Col>
[] Suppress Row/Col
     Check this box to allow this field to "float" in relation
     to the field to its immediate left on the same row.  If the
     field to the left has the CLIP attribute, this check box
     ensures that this field maintains its relative position to
     the end of the data actually printed in the field.

<Attributes Button>
Attributes Button
     Press this button to call the Field Properties window.

<<Image Field Window>>
Image Field Window
     This window allows you to specify the properties of a
     REPORT's Image field.

<Rows>
Rows
   Specify the number of Rows for the Image.

<Column>
Column
   Specify the number of Columns for the Image.

   The image is resized to print in the specified space.

<Image Source>

Mark the Radio button to indicate the Image's source, then specify
the Image's source file or field in the appropriate entry
field (or press the  next to the field to select it from a File
Open Window or the File Schematic).

()Display from File
      Specifies that the image is stored in a file.
Image File:
      The file containing the image.
() Display from Field
      Specifies that the image is stored in a field.
Use:
      The field containing the image.

<Dither>
[] Dither
     This sets the DITHER attribute, which specifies the image is
     dithered into variable-density dots (like halftoned newspaper
     photos) to print photo-quality color images in greyscale
     representation.

<Brightness>
Brightness
     Valid values for Brightness are between -15 and +15,
     where -15 is the darkest, 0 is normal, and +15 is
     the brightest.

<Contrast>
Contrast
     Valid values for Contrast are between -64 and +64. Negative
     contrast values reverse the image, with -64 making the image
     look like a photo negative.

     Normally used ranges are between -20 and +20.
<DPI>
DPI
    Valid values for DPI (Dots per Inch) are between 75,150,or 300.
    Lower values print faster with less quality than higher
    resolutions.

<<Printer Name Window>>

The Printer Name window displays a list of all printers defined
in the printer control file (PRINTER.CTL) to allow you to select
one for the report.  The printer selected in placed in the
PRINTER attribute.

<Use Printer Variable>
[] Use Printer Variable
     Check this box if you want to name a variable which will
     contain the name of the printer (as it appears in
     PRINTER.CTL) at run-time, instead of selecting one form the
     displayed list.

<Printer Variable:>
Printer Variable:
     Enter the name of the variable which will contain the name
     of the printer at run-time.


<<Report Device Window>>

The Report Device window allows you to choose the report's
destination.  The selection you make here is placed in the
report's DEVICE attribute.

<Device Name:>
Device Name:
     Select the output device to which to send the report.

() LPT1 through LPT4
     Sends the report to parallel port 1 through 4 (whichever
     you select).

() COM1 through COM4
     Sends the report to serial port 1 through 4 (whichever you
     select).

() CON
     Sends the report to the video monitor.

() Use Device Variable
     Allows you to name a variable which will contain the
     report's destination at run-time.

<Device Variable:>
Device Variable:
     Enter the name of the variable which will contain the name
     of the report's destination at run-time.


<<Separate/Allow Attribute Window>>

The Separate/Allow Attribute window allows you to define the
numbers placed in the band's SEPARATE and ALLOW attributes. The
SEPARATE attribute indicates the number of blank lines which
will immediately follow this band when printed.  The ALLOW
attribute indicates the number of lines on the page which must
still be available to print on after this band is printed (or
automatic page overflow occurs -- see the Language Reference).

<Variable>
() Variable
     Select this Radio button to name a variable which will
     contain the number of lines at run-time.

<Number>
() Number
     Select this Radio button to specify a constant number of
     lines.

<<Control Fields Window>>

The Control Fields window allows you to declare a character
string that controls printer action.  This is a report CONTROL
field.

<Use:>
Use:
     Enter the name of the variable which contains the control
     code.

<Parameter:>
Parameter:
     You may specify one of the following:

     A string constant to send to the printer. ASCII codes may
     be expressed in decimal form as in this example: '<27,15>'
     This sends two characters to the printer: ASCII 27 and ASCII
     15.

     A numeric constant which defines the length of the control
     code contained in the USE variable.  It must be the same
     length as the USE variable.

     A picture token used to format the values assigned to the
     CONTROL  field, or the values in the USE variable.  The
     initial value is set to spaces.

<<Total Fields Window>>

The Total Fields window allows you to define the report fields
which will calculate and print the totals of any field in any of
the files the report will access.  This creates a report STRING
field which prints the calculated value.

<Sum>
() Sum
     Indicates the total field will print the sum total of the
     field you select to total.

<Average>
() Average
     Indicates the total field will print the average (mean)
     value of the field you select to total.

<Count>
() Count
     Indicates the total field will print the number of records
     selected for the report.

<Max>
() Max
     Indicates the total field will print the largest value
     contained in the field you select to total.

<Min>
() Min
     Indicates the total field will print the smallest value
     contained in the field you select to total.

<Field Label:>
Field Label:
     Enter the label by which you want to reference this field
     in source code statements.  The value entered is the label
     of the report STRING field created to receive the total
     calculation.  This must be a valid Clarion label (only
     letters, numbers, colon, and underscore allowed -- it must
     begin with a letter or underscore).

<Use:>
Use:
     Calls the Field Selection window to allow you to select the
     field on which to base the total calculation.

<Tally On:>
Tally On:
     Calls the Tally On window to select the point at which the
     total calculation will occur.  The choices are: each time a
     page is printed, every time the Body detail is printed, or
     each time the group break you select occurs.

<Reset On:>
Reset On:
     Calls the Reset On window to select the point at which the
     total field will be reset to zero.  The choices are: each
     time a page is printed, each time the group break you select
     occurs, or never (at the end of the report).

<Picture:>
Picture:
     Enter the display picture to use when the total is formatted
     to print.


<<Tally/Reset On Window>>

The Tally/Reset On window allows you to select the time when a
report Total field is computed or reset to zero.

Tally Options:
     PAGE -- The Total field is computed every time automatic
     page overflow occurs.

     ALL -- The Total field is computed every time the Body
     DETAIL structure is printed.

     The name of a Group Break field -- The Total field is
     computed every time the value in the Group Break field
     changes.

Reset Options:
     PAGE -- The Total field is reset every time automatic page
     overflow occurs.

     NONE -- The Total field is reset only when the report is
     closed.

     The name of a Group Break field -- The Total field is reset
     every time the value in the Group Break field changes.


<<Select Control Window>>

The Select Control window displays a list of the printer control
codes available in PRINTER.CTL for the printer you selected on
the Report Properties window.  Only those selections which
actually contain control codes are displayed in the list.

If you selected a variable on the Report Properties window to
allow you to name the report's printer at run-time, the list
contains all possible control code selections for all the
printers listed in PRINTER.CTL.  At run-time, if you select a
printer which does not support some control code you have placed
in the report, the printer control will be ignored.


<<Group Break Window>>

The Group Break window allows you to define the fields which
will cause a group break to occur when the value contained in
the field changes.  Group breaks may be placed on the key
component fields of any file with a One-to-Many (Parent-Child)
relationship in the File Schematic (as displayed on the Field
Selection window).

<Key Components List>
Key Components List
     The List box displays all the fields available for creating
     group breaks.  The word "Yes" is displayed at the right of
     any field selected for a group break.

<Break/No Break Button>
Break/No Break Button
     This Pushbutton toggles group break selection of the
     currently highlighted field in the list, causing the word
     "Yes" to appear and disappear. The fields in the list
     create group breaks only when the word "Yes" is displayed
     next to the field name.


<<Orphan Band Window>>

The Orphan Band window appears to allow you to specify the label
of a new Body DETAIL report band.  "Orphan" Body DETAIL bands
are not automatically printed -- you must explicitly issue a
PRINT statement in embedded source code for the band to print.

<Band Label:>
Band Label:
     Enter the label by which you want to reference this DETAIL
     band in the PRINT source code statement.  The value entered
     is the label of the DETAIL structure created.  This must be
     a valid Clarion label (only letters, numbers, colon, and
     underscore allowed -- it must begin with a letter or
     underscore).


<<Pulldown Menu Formatter>>

The Pulldown Menu Formatter maintains PULLDOWN structures.  A
PULLDOWN is a data structure which defines the pulldown menu
design.

The PULLDOWN data structure allows you to place MENU and ITEM
fields within it.  A MENU is a structure containing other MENUs
and ITEMs in a menu.  An ITEM is a menu selection which, when
selected by the user, executes some procedure.

<Default Pulldown Menus>
Default Pulldown Menus

When you first enter the Pulldown Menu Formatter from the
Application Generator, the default Pulldown Menu design for the
procedure Template appears.  This default design comes from the
Template's template.APP file (which you may modify--see the
Template Language Reference).

Default Template Pulldown Menus provide an easy method of
maintaining consistent design standards throughout your
application(s).  These default Pulldown Menus also pre-define
any menu items which the procedure Template requires to
correctly generate source code for your procedure.  Since the
pre-defined menu items may be (probably are) explicitly
referenced in the Template code, they should not be deleted.

<Designing a Pulldown Menu>
Designing a Pulldown Menu

Since you are designing a pulldown menu, there is no executable
pulldown menu to allow selection of the formatter's functions.
Therefore, the available commands are described in the box
displayed in the middle of the screen.  Your menu design appears
as the pulldown menu displayed at the top of the screen.

The first selection on your pulldown menu is automatically
created for you as a MENU with an associated menu box.  The
ENTER key allows you to change this.  The INSERT key allows you
to add another top-level menu selection.  DELETE allows you to
remove the currently highlighted selection.

The DOWN ARROW takes you into the menu associated with a top-
level MENU.  The first item in the menu is automatically created
for you as an ITEM (without an associated menu).  The INSERT key
allows you to add another menu selection.  When you add another
MENU (with an associated menu) within a menu box, the RIGHT
ARROW takes you into its menu, allowing you to specify its
items.

The ESC key returns you to the previous level throughout the
menu.  When you are on the top level, ESC returns you to the
Application Generator.


<<Pulldown Menu Properties Window>>

The Pulldown Menu Properties window allows you to specify
attributes which are placed directly on the PULLDOWN statement
of the PULLDOWN menu data structure.

<Name:>
Name:
     Enter the label by which the PULLDOWN structure is
     referenced in source code statements.  This must be a valid
     Clarion label (only letters, numbers, colon, and underscore
     allowed - - it must begin with a letter or underscore).

<Help ID:>
Help ID:
     Enter the identifier for the Help screen which the user
     will see when F1 is pressed on any item which does not have
     its own Help ID.  The value you enter here is placed in the
     PULLDOWN statement's HLP attribute.  You may enter either a
     string constant (in single quotes) or variable name.

<Hot Key:>
Hot Key:
     Enter the Keycode Equate label (see Appendix A of the
     Language Reference) of a keystroke which will automatically
     activate the Pulldown menu when it is open but not currently
     displayed on screen.  The value you enter here is placed in
     the PULLDOWN statement's KEY attribute.

<Styles:>
Styles:
     Displays the name of the Styles file you selected on the
     Application Properties window.  This is the Styles file the
     Pulldown Menu Formatter will use when you make color
     selections for your menu design.  You may not change the
     Styles file on this window -- only on the Application
     Properties window.

<At Row:>
At Row:
     Enter the row number on which the Pulldown menu's Action
     bar will be displayed.  This value is placed in the
     PULLDOWN statement's AT attribute.  The default value is one
     (1).

<Local>
[] Local
     Check this box to indicate the Pulldown menu is displayed on
     line one of the physical screen without re-positioning the
     virtual screen (if its top line has scrolled off the
     display).  This places the LOCAL attribute on the PULLDOWN
     statement.

<Shadow>
[] Shadow
     Check this box to indicate that menu boxes display with a
     "ten o'clock" shadow.

<Border>
Border
     Select the Radio button for the type of border you want on
     the menu boxes which drop from the action bar:

     ()  Single -- single line tracks
          Places the SINGLE attribute on the PULLDOWN statement.
     ()  Double -- double line tracks
          Places the DOUBLE attribute on the PULLDOWN statement.
     ()  Half -- half-size block characters
          Places the HALF attribute on the PULLDOWN statement.
     ()  Full -- full-size block characters
          Places the FULL attribute on the PULLDOWN statement.

<Action Bar Colors Button>
Action Bar Colors Button
     Calls the Color Selection window to allow you to select the
     colors for the pulldown menu's main action bar.  These colors
     can also be set from the Menu Colors button of the Menu
     Properties dialog for action bar menu items.

<Border Color Button>
Border Color Button
     Calls the Color Selection window to allow you to select the
     color style code parameter placed in the SINGLE, DOUBLE,
     HALF, or FULL attribute.

<Reapply Default Colors Button>
Reapply Default Colors Button
     Automatically re-selects the default display colors for
     each menu item.  This allows you to change the default
     colors and change the Pulldown Menu to use those colors
     without re- creating the colors for each item individually.
     If the application uses a Styles file, these come from the
     Styles file, otherwise they come from the default colors in
     the CLARION3.INI file.

<Set Default Colors Button>
Set Default Colors Button
     Calls the Default Color Selection window to allow you to
     select the default color style codes for all types of
     screen and pulldown menu fields.  If the application uses a
     Styles file, these come from the Styles file, otherwise they
     come from the default colors in the CLARION3.INI file.


<<Menu Properties Window>>

The Menu Properties window allows you to specify attributes
which are placed directly on a MENU statement in a PULLDOWN menu
data structure.

<Type:>
Type:
     Select the Radio button which is appropriate for the menu
     item on the pulldown menu's action bar:

() Pulldown Menu
     Creates a menu item which drops a menu box from the action
     bar.  This adds a MENU structure within the PULLDOWN
     structure.

() Execute Procedure
     Creates a menu item on the action bar which executes a
     procedure.  This adds a MENU structure (without any
     associated ITEMs in it) within the PULLDOWN structure.

<Menu Name:>
Menu Name:
     Enter the text you want to be displayed on the action bar.
     Any trailing blank spaces must be delimited by the vertical
     bar (|) character.

<Procedure:>
Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately after the user has selected this menu
     item to execute.  If you do enter a procedure call, you may
     not write embedded source code through the Source Button to
     the right.

<Source Button>
Source Button
     Calls the Text Editor to allow you to write your own
     embedded Clarion language source code. The code you have
     written executes immediately after the user has selected
     this menu item.

<Equate Label:>
Equate Label:
     Enter the Field Equate Label (see the Language Reference)
     by which you want to reference this MENU in source code
     statements.  This Field Equate Label is placed in the MENU
     statement's USE attribute.

<Help ID:>
Help ID:
     Enter the identifier for the Help screen which the user
     will see when F1 is pressed on any item which does not have
     its own Help ID.  The value you enter here is placed in the
     PULLDOWN statement's HLP attribute.  You may enter either a
     string constant (in single quotes) or variable name.

<Hot Key:>
Hot Key:
     Enter the Keycode Equate label (see Appendix A of the
     Language Reference) of a keystroke which will automatically
     execute the menu item, when the PULLDOWN menu is open but
     independent of whether it is currently displayed on screen.
     The value you enter here is placed in the MENU statement's
     KEY attribute.

<Message:>
Message:
     Enter the message you want to be displayed when the user is
     on this pulldown menu item.  The value you enter here is
     placed in the menu field's MSG attribute.  By default, the
     message is displayed on the bottom line of the screen
     (unless changed by the SETMSG statement).

<Action Bar Colors Button>
Action Bar Colors Button
     Calls the Color Selection window, which allows you to
     select the display colors for the menu items on the PULLDOWN
     menu's action bar.


<<Item Properties Window>>

The Item Properties window allows you to specify attributes
which are placed directly on an ITEM statement in a PULLDOWN
menu data structure.

<Type:>
Type:
     Select the Radio button which is appropriate for the menu
     item:

() Execute Procedure
     Creates a menu item which executes a procedure. This adds
     an ITEM statement to the MENU structure which contains this
     menu selection.

() Separator
     Creates a menu item which only displays a separation line
     in the menu box -- it does not execute a procedure.  This
     adds an ITEM statement to the MENU structure which contains
     this menu selection.

() Toggle
     Creates a menu item which displays a check () to the left
     of the menu selection when it is toggled ON.  Selecting
     this menu item changes the value of the field associated
     with it from zero (OFF) to one (ON) and back -- it does not
     directly execute a procedure.  This adds an ITEM statement
     with the TOGGLE attribute to the MENU structure which
     contains this menu selection.

() Menu Box
     Creates a menu item which displays another menu box from
     the currently displayed menu.  This adds a MENU structure
     within the MENU structure which contains this menu
     selection.

<Menu Name:>
Menu Name:
     Enter the text you want to be displayed in the menu.  Any
     trailing blank spaces must be delimited by the vertical bar
     (|) character.

<Procedure:>
Procedure:
     Enter a single procedure call statement.  The procedure is
     executed immediately after the user has selected this menu
     item to execute.  If you do enter a procedure call, you may
     not write embedded source code through the Source Button to
     the right.

<Source Button>
Source Button
     Calls the Text Editor to allow you to write your own
     embedded Clarion language source code.  The code you have
     written executes immediately after the user has selected
     this menu item.

<Field:>
Field:
     Select the field which is the Toggle menu item changes from
     zero (OFF) to one (ON) and back. This places the name of
     the field in the USE attribute of an ITEM with the TOGGLE
     attribute.

<Equate Label:>
Equate Label:
     Enter the Field Equate Label (see the Language Reference)
     by which you want to reference this ITEM in source code
     statements.  This Field Equate Label is placed in the ITEM
     statement's USE attribute.

<Help ID:>
Help ID:
     Enter the identifier for the Help screen which the user
     will see when F1 is pressed on any item which does not have
     its own Help ID.  The value you enter here is placed in the
     PULLDOWN statement's HLP attribute.  You may enter either a
     string constant (in single quotes) or variable name.

<Hot Key:>
Hot Key:
     Enter the Keycode Equate label (see Appendix A of the
     Language Reference) of a keystroke which will automatically
     execute the menu item, when the PULLDOWN menu is open but
     independent of whether it is currently displayed on screen.
     The value you enter here is placed in the ITEM statement's
     KEY attribute.

<Message:>
Message:
     Enter the message you want to be displayed when the user is
     on this pulldown menu item.  The value you enter here is
     placed in the menu field's MSG attribute.  By default, the
     message is displayed on the bottom line of the screen
     (unless changed by the SETMSG statement).

<Menu Colors Button>
Menu Colors Button
     Calls the Color Selection window, which allows you to
     select the display colors for all the items in the MENU
     structure which contains this ITEM.


<<Formulas Window>>

The Formulas window is the key to maintaining a procedure's
Computed and Conditional fields.  The List box displays a list
of all the Formulas you have already created.

A Computed Field assigns the value of the expression you format
to the field you specify as the "target" of the computation.  A
Conditional Field evaluates a logical expression (which you
format) and conditionally assigns one of two expressions you
format to the field you specify as its "target."

<Add Computation Button>
Add Computation Button
     Calls the Computed Field window to allow you to add a
     Computed Field to the list of formulas.

<Add Condition Button>
Add Condition Button
     Calls the Conditional Field window to allow you to add a
     Conditional Field to the list of formulas.

<Change Button>
Change Button
     Calls either the Computed Field window or the Conditional
     Field window to allow you to change an existing formula.

<Natural Ordering>
[] Natural Ordering
    Check this box to automatically order your foumulas based on
    their natural order. This means if one expression is based on
    another, the latter expression is moved up so that it is
    computed first.

<Move Up  Button>
Move Up  Button
    Pressing this button moves the highlighted formula up in the
    list. If Natural Ordering is enabled, this button is dimmed.

<Move Down  Button>
Move Down  Button
    Pressing this button moves the highlighted formula down in the
    list. If Natural Ordering is enabled, this button is dimmed.

<Delete Button>
Delete Button
     Calls the Delete Formula window to allow you to delete an
     existing formula.

<Select Button>
Select Button
     When the Formulas window is called from within the Report
     Formatter, this button selects the currently highlighted
     formula to place the "target" field in the report design.

<Close Button>
Close Button
     Exits the Formulas window. Any changes made to the
     Formulas are saved to the .APP file only when the OK Button
     on the Procedure Properties window is completed.


<<Computed Field Window>>

The Computed Field window defines a Formula which creates an
assignment statement placing the result of an expression in the
field you specify, as in this example:

     Field Name = Formula

<Field Name:>
Field Name:
     Calls the Field Selection window to allow you to select the
     field which will receive the result of the expression.

<Use Expression Generator>
[] Use Expression Generator
     Check this box if you wish to use the Expression Generator
     to edit your formula. If the box is not checked then
     free-format entry is enabled in the formulas text field
     (adjacent to the Formula Button). Validation of the formula
     is performed upon completing the formula field.

<Syntax Checking>
Syntax Checking
     Check this box to enable automatic syntax checking upon
     completion of your expression. If not checked, syntax
     is not validated.


<Formula Class:>
Formula Class:
     Optionally, you may enter up to twenty characters to
     identify to the procedure Template the position in the
     generated source code that this Computed Field is to be
     calculated. The value you enter here must exactly match a
     value supported by the procedure Template you are using to
     create this procedure's source code.

     The Formula Class values (source code positions) supported
     by each procedure Template are contained in that procedure
     Template's Help text (available from the Template Help
     Pushbutton on the Procedure Properties window). This
     feature may not be supported by all procedure Templates.

<Description:>
Description:
     Enter a description of the formula's purpose.

<Formula Button>
Formula Button
     Calls either the Select Component window (when creating a
     new expression) or the Generate Expression window (when
     modifying an existing expression).  These windows allow you
     to build the expression which will calculate the value the
     "target" field will receive.

     If 'Use Expression Generator' is not checked then a text
     field is enabled, next to the dimmed Formula Button, which
     allows you to edit the formula.

<<Conditional Field Window>>

The Conditional Field window defines a Formula which creates an
IF statement, conditionally placing the result of one of two
expressions in the field you specify, as in this example:

     IF Condition
       Field Name = True Formula
     ELSE
       Field Name = False Formula
     END

<Field Name:>
Field Name:
     Calls the Field Selection window to allow you to select the
     field which will receive the result of the expression.

<Use Expression Generator>
[] Use Expression Generator
     Check this box if you wish to use the Expression Generator
     to edit your formulas. If the box is not checked then
     free-format entry is enabled in a formulas text field
     (adjacent to the appropriate formulas button). Validation of
     a formula is performed upon completing a formula field.

<Syntax Checking>
Syntax Checking
     Check this box to enable automatic syntax checking upon
     completion of your expression. If not checked, syntax
     is not validated.

<Formula Class:>
Formula Class:
     Optionally, you may enter up to twenty characters to
     identify to the procedure Template the position in the
     generated source code that this Conditional Field is to be
     calculated. The value you enter here must exactly match a
     value supported by the procedure Template you are using to
     create this procedure's source code.

     The Formula Class values (source code positions) supported
     by each procedure Template are contained in that procedure
     Template's Help text (available from the Template Help
     Pushbutton on the Procedure Properties window). This
     feature may not be supported by all procedure Templates.

<Description:>
Description:
     Enter a description of the formula's purpose.

<If Condition Button>
If Condition Button
     Calls either the Select Component window (when creating a
     new expression) or the Generate Expression window (when
     modifying an existing expression).  These windows allow you
     to build the expression which will be evaluated to determine
     which expression's value the "target" field will receive.

     If 'Use Expression Generator' is not checked then a text
     field is enabled, next to the dimmed If Condition Button,
     which allows you to edit the formula.

<True Formula Button>
True Formula Button
     Calls either the Select Component window (when creating a
     new expression) or the Generate Expression window (when
     modifying an existing expression).  These windows allow you
     to build the expression which will calculate the value the
     "target" field will receive if the "If Condition" evaluates
     as true.

     If 'Use Expression Generator' is not checked then a text
     field is enabled, next to the dimmed True Formula Button,
     which allows you to edit the formula.

<False Formula Button>
False Formula Button
     Calls either the Select Component window (when creating a
     new expression) or the Generate Expression window (when
     modifying an existing expression).  These windows allow you
     to build the expression which will calculate the value the
     "target" field will receive if the "If Condition" evaluates
     as false.

     If 'Use Expression Generator' is not checked then a text
     field is enabled, next to the dimmed False Formula Button,
     which allows you to edit the formula.

<<Select Component Window>>

The Select Component window displays a list of only those
choices which are valid for the point at which the expression is
being created.  The list may at times contain selections for:
variables, constants, Clarion functions, logical operators,
arithmetic operators, and the word "Done" to indicate you are
finished building the expression.

To select an item from the list, DOUBLE-CLICK the mouse on it,
or highlight the selection and press ENTER.

<Done Button>
Done Button
     Select this button to indicate the expression is complete.
     This button is only active when the expression has no more
     required components.


<<Constant Text Window>>

The Constant Text window allows you to enter a string constant
into the expression you are creating.  Whatever you type into
the entry field is placed into the expression within single
quotes.

To enter a string constant which contains trailing spaces, the
trailing spaces must be delimited with the vertical bar
character (|).  For example, to put a comma and a single space
as a constant value into the expression, enter ", |" into the
field (without the double quotes) -- ', ' appears in the
expression.


<<Constant Number Window>>

The Constant Number window allows you to enter a numeric
constant into the expression you are creating.  Whatever number
you type into the entry field is placed in the expression.


<<Specific Date Window>>

The Specific Date window allows you to enter a constant date
value (in mm/dd/yyyy format) into the expression you are
creating.  Whatever date you type into the entry field is placed
in the expression.


<<Picture Token Window>>

The Picture Token window allows you to enter a picture display
format into the expression you are creating.  This window only
appears when you are required to enter a display picture as a
parameter of a Clarion function.  Whatever picture you type into
the entry field is placed in the expression.


<<Generate Expression Window>>

The Generate Expression window displays the entire expression,
allowing you to interactively makes changes to the expression.
The arrow cursor keys operate in this window on the Computation
Display field -- they do not navigate between the buttons.

To change the expression, highlight the portion of the
expression you want to edit (in the Computation display field)
and press the Edit Button.

<Computation:>
Computation:
     Displays the entire expression.  This contains a cursor bar
     to highlight the portion of the expression you want to edit.

<Edit Mode:>
Edit Mode:
     Select the Radio button which indicates the mode in which
     you want to edit the expression:

() Insert
     Allows you to begin adding expression components at the
     position currently highlighted in the Computation display.

() Replace
     Allows you to change the expression components at the
     position currently highlighted in the Computation display.

() Delete
     Allows you to delete the expression components currently
     highlighted in the Computation display.

<Clear Button>
Clear Button
     Select this button to erase the expression.

<Edit Button>
Edit Button
     Select this button to begin adding, replacing, or deleting
     expression components after you have selected the proper
     Edit Mode.


<<Clear Expression Window>>

The Clear Expression window allows you to delete the entire
expression.

<<Expression Window>>

The Expression window allows you to define an expression.

<Use Expression Generator>
[] Use Expression Generator
     Check this box if you wish to use the Expression Generator
     to edit your formula. If the box is not checked then
     free-format entry is enabled in the formulas text field
     (adjacent to the Formula Button). Validation of the formula
     is performed upon completing the formula field.

<Formula Button>
Formula Button
     Calls either the Select Component window (when creating a
     new expression) or the Generate Expression window (when
     modifying an existing expression).  These windows allow you
     to build the expression.

     If 'Use Expression Generator' is not checked then a text
     field is enabled, next to the dimmed Formula Button, which
     allows you to enter a free form expression.


<<Local Data Worksheet>>

The Local Data Worksheet displays all the variables which have
been declared within the procedure.  Local variables (except
those declared within a QUEUE) are all allocated dynamic memory.
This means the memory is allocated on the stack only when you
enter the procedure and is de-allocated when you RETURN from the
procedure.  Therefore, these variables do not retain their value
between calls to the procedure.  See "Global, Local, Static, and
Dynamic Data" in the Language Reference.


<<Local Data's Data Menu>>

The Data menu contains only the selection to return to the
Procedure Properties window.

<Exit>
Exit                                      ( CTRL+X or ALT+D X )
     Returns you to the Procedure Properties window.


<<Local Data's Edit Menu>>

The Edit menu contains selections which allow you to maintain
the individual data items.

<Insert>
Insert                                    ( INSERT or ALT+E I )
     Allows you to add a Field to the local data.

<Change>
Change                                    ( ENTER or ALT+E H )
     Allows you to modify an existing Field.

<Delete>
Delete                                    ( DELETE or ALT+E D )
     Allows you to remove a Field.

<Copy>
Copy                                      ( CTRL+C or ALT+E C )
     Allows you to copy an existing Field.

<Move>
Move                                      ( CTRL+M or ALT+E M )
     Allows you to change the relative position of a Field.


<<Local Data's Tools Menu>>

The Tools menu contains a number of utilities which are useful
throughout the environment.

<DOS Shell>
DOS Shell                                 ( F10 or ALT+T D )
     Calls Clarion's built-in disk maintenance program (CSHELL).
     CSHELL is covered in its own section later.

<Calculator>
Calculator                                ( ALT+T C )
     Calls Clarion's built-in programmer's calculator.  The
     Calculator... selection is covered in its own section later.

<ASCII Chart...>
ASCII Chart...                            ( ALT+T A )
     Brings up a list of all the ASCII codes. The chart
     contains each ASCII display character, and the Decimal,
     Hexadecimal, and Octal numbers which represent that
     character.

<Keycode Chart...>
Keycode Chart...                          ( ALT+T K )
     Displays a list of all the Clarion Keycodes.  Each possible
     key combination is in the list along with the decimal number
     which represents it.


<<Local Data's Help Menu>>

Context-sensitive Help screens are available throughout the
Clarion for DOS environment through the F1 key.  The
Help menu contains selections which provide separate access to
the Help system.

<Using Help >
Using Help                                ( ALT+H U )
     Provides information on how to use the Help system.

<Help Index >
Help Index                                ( ALT+H H )
     Displays an Index of all Help screens available in the
     major functional area, allowing you to view a Help screen
     for a particular context when not actively in that context.

<About...>
About...                                  ( ALT+H A )
     Displays a screen with the program and copyright
     information for this specific release of Clarion Database
     Developer.


<<Procedure Calls Window>>

The Procedure Calls window displays a list of the procedure
calls which you make in your embedded source code.  Once you
have listed a procedure call, the Application Generator adds it
to the Procedure call tree as a "ToDo" procedure (if it does not
already exist in your application).  You may then create the
procedure as you choose.

<Insert Button>
Insert Button
     Calls the Add Procedure Call window to allow you to add a
     procedure to the list.

<Change Button>
Change Button
     Calls the Change Procedure Call window to allow you to
     change the currently highlighted procedure in the list.

<Delete Button>
Delete Button
     Calls the Delete Procedure Call window to allow you to
     delete the currently highlighted procedure from the list.


<<Add/Change Procedure Calls Window>>

The Add/Change Procedure Calls window allows you to maintain a
procedure call which you make in your embedded source code.

<Procedure:>
Procedure:
     Enter the label of the procedure called in your embedded
     source.


<<Embedded Source Window>>

The Embedded Source window displays a list of the embedded
source code windows available in the procedure.  This includes
all the explicit embedded source code windows created by the
#EMBED Template Language statement, and all the implicit
embedded source code windows associated with Pulldown menu
items, screen field Setups and Edits, and report structure pre-
print and post-print embedded source code windows.

Any embedded source window which contains source code is
indicated by a check () at its left -- code windows without a
check mark are empty.

<Select Button>
Select Button
     Calls the Text Editor to edit the currently highlighted
     embedded source code window.

<Close Button>
Close Button
     Exits the Embedded Source window.  Any changes made to the
     source code are saved to the .APP file only when the OK
     Button on the Procedure Properties window is completed.

<Delete Source Button>
Delete Source Button
     Deletes all the source code in the currently highlighted
     embedded source code window.


<<Confirm Window>>

This window allows you to confirm or abort the current
operation.  The window's title should make the confirmation
request obvious.

<<Dynamic Screens>>

Certain screens are dynamically created by the templates.

Press the Template Help button on these screens for help.
